@colorfast-design/contract
v0.1.3
Published
Shared brand and API lifecycle contracts.
Readme
@colorfast-design/contract
Shared runtime schemas and TypeScript types for the Colorfast brand lifecycle.
Compatibility
The package root remains supported:
import {
BrandResponseSchema,
TokenContractSchema,
} from "@colorfast-design/contract";The root and the declared subpaths are stable public APIs governed by the package version. Existing root exports remain available when a more focused subpath is added.
Subpaths
Use the narrowest declared subpath for new imports:
@colorfast-design/contract/agent-guidance@colorfast-design/contract/brand@colorfast-design/contract/canonical@colorfast-design/contract/design-source-map@colorfast-design/contract/publication@colorfast-design/contract/release@colorfast-design/contract/runtime@colorfast-design/contract/source-assets@colorfast-design/contract/token-contract
import { canonicalizeDomain } from "@colorfast-design/contract/brand";
import { sha256Digest } from "@colorfast-design/contract/canonical";
import type { DesignSourceMap } from "@colorfast-design/contract/design-source-map";
import type { PublicationEnvelope } from "@colorfast-design/contract/publication";Paths below @colorfast-design/contract/src and any subpath not listed above are
private implementation details and are not supported.
Design source maps
DesignSourceMap accepts historical v1 maps and current v2 maps. V1 binds
published claims to one exact browser screenshot. V2 binds each region and
claim to one declared screenshot frame, rejects cross-frame references, and
retains exact v1 decoding without a backfill. Region and frame IDs are opaque,
scoped to one publication, and must not be reused as cross-publication element
identities.
The artifact permits only coarse tag and role categories, integer geometry, text-presence flags, browser authority, and deterministic claim relationships. It must not contain raw text, selectors, DOM IDs or classes, attributes, markup, query-bearing URLs, CSS source, or hashes of those values.
