@hjmds/design-contracts 0.9.1 → 0.9.2

package/dist/design-system-provider.d.ts

@@ -1,5 +1,5 @@
 import type { ColorReferencePalette } from "./color-references.js";
-import { type ResolvedTheme, type ThemePreference } from "./colors.js";
+import { type ResolvedTheme, type ThemeColors, type ThemePreference } from "./colors.js";
 /**
  * Canonical logical direction. Existing public component-specific names stay
  * source-compatible as aliases of this type instead of redeclaring the union.
@@ -42,6 +42,14 @@ export type ResolveDesignSystemEnvironmentOptions = Readonly<{
     systemDirection?: DesignSystemDirection;
     systemTextScale?: DesignSystemTextScale;
     systemReducedMotion?: boolean;
+    /**
+     * Product brand colors layered over the HJM semantic keys. The key set is
+     * unchanged, so recipes and contrast rules keep applying. Without this entry
+     * point a consumer has to build its own token layer and override the CSS
+     * variables, which is a copy of the canonical palette. Only the supplied
+     * keys are replaced; the rest keep the HJM defaults.
+     */
+    brandPalette?: Readonly<Partial<Record<ResolvedTheme, Readonly<Partial<ThemeColors>>>>>;
     /** A nested renderer inherits the already-resolved parent before consulting OS defaults. */
     parent?: ResolvedDesignSystemEnvironment;
 }>;

package/dist/design-system-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"design-system-provider.d.ts","sourceRoot":"","sources":["../src/design-system-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,KAAK,CAAC;AAElD;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE3C,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC;IAClD,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;CAU1C,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,QAAQ,CAAC;IACrD,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,qBAAqB,CAAC;IACjC,SAAS,EAAE,qBAAqB,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,qCAAqC,GAAG,QAAQ,CAAC;IAC3D;;;;;OAKG;IACH,WAAW,EAAE,aAAa,CAAC;IAC3B,2FAA2F;IAC3F,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,4FAA4F;IAC5F,MAAM,CAAC,EAAE,+BAA+B,CAAC;CAC1C,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,WAAW,EAAE,+BAA+B,CAAC;IAC7C,4DAA4D;IAC5D,OAAO,EAAE,qBAAqB,CAAC;CAChC,CAAC,CAAC;AAyBH;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,yBAAyB,GAC/B,IAAI,CAuBN;AAsBD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,4BAA4B,GAClC,IAAI,CAmBN;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,WAAW,EAAE,+BAA+B,GAC3C,IAAI,CASN;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,qCAAqC,GAC7C,+BAA+B,CAsCjC;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,qCAAqC,GAC7C,yBAAyB,CAY3B"}
+{"version":3,"file":"design-system-provider.d.ts","sourceRoot":"","sources":["../src/design-system-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,KAAK,CAAC;AAElD;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE3C,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC;IAClD,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;CAU1C,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,QAAQ,CAAC;IACrD,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,qBAAqB,CAAC;IACjC,SAAS,EAAE,qBAAqB,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,qCAAqC,GAAG,QAAQ,CAAC;IAC3D;;;;;OAKG;IACH,WAAW,EAAE,aAAa,CAAC;IAC3B,2FAA2F;IAC3F,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,4FAA4F;IAC5F,MAAM,CAAC,EAAE,+BAA+B,CAAC;CAC1C,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,WAAW,EAAE,+BAA+B,CAAC;IAC7C,4DAA4D;IAC5D,OAAO,EAAE,qBAAqB,CAAC;CAChC,CAAC,CAAC;AAyBH;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,yBAAyB,GAC/B,IAAI,CAuBN;AAsBD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,4BAA4B,GAClC,IAAI,CAmBN;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,WAAW,EAAE,+BAA+B,GAC3C,IAAI,CASN;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,qCAAqC,GAC7C,+BAA+B,CAsCjC;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,qCAAqC,GAC7C,yBAAyB,CAe3B"}

package/dist/design-system-provider.js

@@ -133,10 +133,13 @@ export function resolveDesignSystemEnvironment(input, options) {
  */
 export function resolveDesignSystemProviderValue(input, options) {
     const environment = resolveDesignSystemEnvironment(input, options);
+    const brandOverride = options.brandPalette?.[environment.theme];
     const value = {
         environment,
         palette: {
-            theme: THEMES[environment.theme],
+            theme: brandOverride === undefined
+                ? THEMES[environment.theme]
+                : { ...THEMES[environment.theme], ...brandOverride },
             statusAccents: ACCENTS[environment.theme],
             statusAccentFills: accentFill,
         },

package/dist/design-system-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"design-system-provider.js","sourceRoot":"","sources":["../src/design-system-provider.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ColorReferencePalette } from \"./color-references.js\";\nimport {\n  ACCENTS,\n  THEMES,\n  accentFill,\n  isThemePreference,\n  type ResolvedTheme,\n  type ThemePreference,\n} from \"./colors.js\";\n\n/**\n * Canonical logical direction. Existing public component-specific names stay\n * source-compatible as aliases of this type instead of redeclaring the union.\n */\nexport type DesignSystemDirection = \"ltr\" | \"rtl\";\n\n/**\n * A continuous OS/user font-scale multiplier (iOS Dynamic Type, Android font\n * size, browser zoom) — not `ShowcaseTextScale`'s closed `1 | 1.5 | 2`, which\n * only names Showcase's five fixture stories, or `description-list.ts`'s\n * local layout clamp. This is the single upstream signal both now consume.\n */\nexport type DesignSystemTextScale = number;\n\nexport type DesignSystemEnvironmentInput = Readonly<{\n  theme?: ThemePreference;\n  direction?: DesignSystemDirection;\n  textScale?: DesignSystemTextScale;\n  reducedMotion?: boolean;\n}>;\n\nexport const designSystemEnvironmentDefaults = {\n  theme: \"system\",\n  direction: \"ltr\",\n  textScale: 1,\n  reducedMotion: false,\n} as const satisfies Readonly<{\n  theme: ThemePreference;\n  direction: DesignSystemDirection;\n  textScale: DesignSystemTextScale;\n  reducedMotion: boolean;\n}>;\n\nexport type ResolvedDesignSystemEnvironment = Readonly<{\n  theme: ResolvedTheme;\n  direction: DesignSystemDirection;\n  textScale: DesignSystemTextScale;\n  reducedMotion: boolean;\n}>;\n\nexport type ResolveDesignSystemEnvironmentOptions = Readonly<{\n  /**\n   * The platform's current OS-level scheme, consulted only when `theme`\n   * resolves to `\"system\"`. Renderers detect this themselves\n   * (`Appearance.getColorScheme()`, `matchMedia('(prefers-color-scheme)')`)\n   * — this package never queries the OS.\n   */\n  systemTheme: ResolvedTheme;\n  /** Optional OS/renderer signals used when neither input nor a parent supplies the axis. */\n  systemDirection?: DesignSystemDirection;\n  systemTextScale?: DesignSystemTextScale;\n  systemReducedMotion?: boolean;\n  /** A nested renderer inherits the already-resolved parent before consulting OS defaults. */\n  parent?: ResolvedDesignSystemEnvironment;\n}>;\n\nexport type DesignSystemProviderValue = Readonly<{\n  environment: ResolvedDesignSystemEnvironment;\n  /** Palette consumed directly by `resolveColorReference`. */\n  palette: ColorReferencePalette;\n}>;\n\nconst themeColorKeys = Object.keys(THEMES.light) as readonly (keyof typeof THEMES.light)[];\nconst accentColorKeys = Object.keys(ACCENTS.light) as readonly (keyof typeof ACCENTS.light)[];\nconst sixDigitHexColor = /^#[0-9a-f]{6}$/i;\n\nfunction assertColorRecord(\n  value: unknown,\n  keys: readonly string[],\n  field: string,\n): asserts value is Readonly<Record<string, string>> {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    throw new TypeError(`DesignSystemProviderValue ${field} must be a color record`);\n  }\n  const record = value as Readonly<Record<string, unknown>>;\n  for (const key of keys) {\n    const color = record[key];\n    if (typeof color !== \"string\" || !sixDigitHexColor.test(color)) {\n      throw new TypeError(\n        `DesignSystemProviderValue ${field}.${key} must be a six-digit hex color`,\n      );\n    }\n  }\n}\n\n/**\n * Runtime boundary for reviewed full product palettes supplied to a renderer.\n * Partial token overrides remain unsupported: every semantic role required by\n * a recipe must be present, and alpha composition requires six-digit hex.\n */\nexport function validateDesignSystemProviderValue(\n  value: DesignSystemProviderValue,\n): void {\n  if (value === null || typeof value !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue must be an object\");\n  }\n  if (value.environment === null || typeof value.environment !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue environment must be an object\");\n  }\n  validateResolvedDesignSystemEnvironment(value.environment);\n  const palette = value.palette;\n  if (palette === null || typeof palette !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue palette must be an object\");\n  }\n  assertColorRecord(palette.theme, themeColorKeys, \"palette.theme\");\n  assertColorRecord(\n    palette.statusAccents,\n    accentColorKeys,\n    \"palette.statusAccents\",\n  );\n  assertColorRecord(\n    palette.statusAccentFills,\n    accentColorKeys,\n    \"palette.statusAccentFills\",\n  );\n}\n\nfunction assertBoolean(value: boolean, field: string): void {\n  if (typeof value !== \"boolean\") {\n    throw new TypeError(`DesignSystemEnvironment ${field} must be a boolean`);\n  }\n}\n\nfunction assertDirection(value: DesignSystemDirection, field: string): void {\n  if (value !== \"ltr\" && value !== \"rtl\") {\n    throw new TypeError(`Unsupported DesignSystemEnvironment ${field}: ${String(value)}`);\n  }\n}\n\nfunction assertTextScale(value: DesignSystemTextScale, field: string): void {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0) {\n    throw new RangeError(\n      `DesignSystemEnvironment ${field} must be a finite number greater than 0`,\n    );\n  }\n}\n\nexport function validateDesignSystemEnvironmentInput(\n  input: DesignSystemEnvironmentInput,\n): void {\n  if (input.theme !== undefined && !isThemePreference(input.theme)) {\n    throw new TypeError(`Unsupported DesignSystemEnvironment theme: ${String(input.theme)}`);\n  }\n  if (\n    input.direction !== undefined &&\n    input.direction !== \"ltr\" &&\n    input.direction !== \"rtl\"\n  ) {\n    throw new TypeError(\n      `Unsupported DesignSystemEnvironment direction: ${String(input.direction)}`,\n    );\n  }\n  if (input.textScale !== undefined) {\n    assertTextScale(input.textScale, \"textScale\");\n  }\n  if (input.reducedMotion !== undefined) {\n    assertBoolean(input.reducedMotion, \"reducedMotion\");\n  }\n}\n\n/**\n * A parent has already crossed the system-preference boundary. Unlike the\n * partial input validator, this rejects `\"system\"`, missing axes, and every\n * malformed resolved value instead of silently resolving them again.\n */\nexport function validateResolvedDesignSystemEnvironment(\n  environment: ResolvedDesignSystemEnvironment,\n): void {\n  if (environment.theme !== \"light\" && environment.theme !== \"dark\") {\n    throw new TypeError(\n      `Unsupported ResolvedDesignSystemEnvironment theme: ${String(environment.theme)}`,\n    );\n  }\n  assertDirection(environment.direction, \"parent direction\");\n  assertTextScale(environment.textScale, \"parent textScale\");\n  assertBoolean(environment.reducedMotion, \"parent reducedMotion\");\n}\n\n/**\n * Merges partial signals with safe defaults and resolves `\"system\"` against\n * the renderer-supplied `systemTheme`. This — not a React/RN context, which\n * this package cannot own — is the entire portable contract behind antd\n * `ConfigProvider`: see docs/design-system-provider.md for what was\n * deliberately left to the renderer.\n */\nexport function resolveDesignSystemEnvironment(\n  input: DesignSystemEnvironmentInput,\n  options: ResolveDesignSystemEnvironmentOptions,\n): ResolvedDesignSystemEnvironment {\n  validateDesignSystemEnvironmentInput(input);\n  if (options.systemTheme !== \"light\" && options.systemTheme !== \"dark\") {\n    throw new TypeError(`Unsupported DesignSystemEnvironment systemTheme: ${String(options.systemTheme)}`);\n  }\n  if (options.systemDirection !== undefined) {\n    assertDirection(options.systemDirection, \"systemDirection\");\n  }\n  if (options.systemTextScale !== undefined) {\n    assertTextScale(options.systemTextScale, \"systemTextScale\");\n  }\n  if (options.systemReducedMotion !== undefined) {\n    assertBoolean(options.systemReducedMotion, \"systemReducedMotion\");\n  }\n  if (options.parent !== undefined) {\n    validateResolvedDesignSystemEnvironment(options.parent);\n  }\n\n  const theme =\n    input.theme ?? options.parent?.theme ?? designSystemEnvironmentDefaults.theme;\n  return {\n    theme: theme === \"system\" ? options.systemTheme : theme,\n    direction:\n      input.direction ??\n      options.parent?.direction ??\n      options.systemDirection ??\n      designSystemEnvironmentDefaults.direction,\n    textScale:\n      input.textScale ??\n      options.parent?.textScale ??\n      options.systemTextScale ??\n      designSystemEnvironmentDefaults.textScale,\n    reducedMotion:\n      input.reducedMotion ??\n      options.parent?.reducedMotion ??\n      options.systemReducedMotion ??\n      designSystemEnvironmentDefaults.reducedMotion,\n  };\n}\n\n/**\n * Resolves the portable Provider value without owning React/RN Context. A\n * renderer stores this object in its own context and feeds `palette` directly\n * to recipe color resolution.\n */\nexport function resolveDesignSystemProviderValue(\n  input: DesignSystemEnvironmentInput,\n  options: ResolveDesignSystemEnvironmentOptions,\n): DesignSystemProviderValue {\n  const environment = resolveDesignSystemEnvironment(input, options);\n  const value = {\n    environment,\n    palette: {\n      theme: THEMES[environment.theme],\n      statusAccents: ACCENTS[environment.theme],\n      statusAccentFills: accentFill,\n    },\n  };\n  validateDesignSystemProviderValue(value);\n  return value;\n}\n"]}
+{"version":3,"file":"design-system-provider.js","sourceRoot":"","sources":["../src/design-system-provider.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ColorReferencePalette } from \"./color-references.js\";\nimport {\n  ACCENTS,\n  THEMES,\n  accentFill,\n  isThemePreference,\n  type ResolvedTheme,\n  type ThemeColors,\n  type ThemePreference,\n} from \"./colors.js\";\n\n/**\n * Canonical logical direction. Existing public component-specific names stay\n * source-compatible as aliases of this type instead of redeclaring the union.\n */\nexport type DesignSystemDirection = \"ltr\" | \"rtl\";\n\n/**\n * A continuous OS/user font-scale multiplier (iOS Dynamic Type, Android font\n * size, browser zoom) — not `ShowcaseTextScale`'s closed `1 | 1.5 | 2`, which\n * only names Showcase's five fixture stories, or `description-list.ts`'s\n * local layout clamp. This is the single upstream signal both now consume.\n */\nexport type DesignSystemTextScale = number;\n\nexport type DesignSystemEnvironmentInput = Readonly<{\n  theme?: ThemePreference;\n  direction?: DesignSystemDirection;\n  textScale?: DesignSystemTextScale;\n  reducedMotion?: boolean;\n}>;\n\nexport const designSystemEnvironmentDefaults = {\n  theme: \"system\",\n  direction: \"ltr\",\n  textScale: 1,\n  reducedMotion: false,\n} as const satisfies Readonly<{\n  theme: ThemePreference;\n  direction: DesignSystemDirection;\n  textScale: DesignSystemTextScale;\n  reducedMotion: boolean;\n}>;\n\nexport type ResolvedDesignSystemEnvironment = Readonly<{\n  theme: ResolvedTheme;\n  direction: DesignSystemDirection;\n  textScale: DesignSystemTextScale;\n  reducedMotion: boolean;\n}>;\n\nexport type ResolveDesignSystemEnvironmentOptions = Readonly<{\n  /**\n   * The platform's current OS-level scheme, consulted only when `theme`\n   * resolves to `\"system\"`. Renderers detect this themselves\n   * (`Appearance.getColorScheme()`, `matchMedia('(prefers-color-scheme)')`)\n   * — this package never queries the OS.\n   */\n  systemTheme: ResolvedTheme;\n  /** Optional OS/renderer signals used when neither input nor a parent supplies the axis. */\n  systemDirection?: DesignSystemDirection;\n  systemTextScale?: DesignSystemTextScale;\n  systemReducedMotion?: boolean;\n  /**\n   * Product brand colors layered over the HJM semantic keys. The key set is\n   * unchanged, so recipes and contrast rules keep applying. Without this entry\n   * point a consumer has to build its own token layer and override the CSS\n   * variables, which is a copy of the canonical palette. Only the supplied\n   * keys are replaced; the rest keep the HJM defaults.\n   */\n  brandPalette?: Readonly<Partial<Record<ResolvedTheme, Readonly<Partial<ThemeColors>>>>>;\n  /** A nested renderer inherits the already-resolved parent before consulting OS defaults. */\n  parent?: ResolvedDesignSystemEnvironment;\n}>;\n\nexport type DesignSystemProviderValue = Readonly<{\n  environment: ResolvedDesignSystemEnvironment;\n  /** Palette consumed directly by `resolveColorReference`. */\n  palette: ColorReferencePalette;\n}>;\n\nconst themeColorKeys = Object.keys(THEMES.light) as readonly (keyof typeof THEMES.light)[];\nconst accentColorKeys = Object.keys(ACCENTS.light) as readonly (keyof typeof ACCENTS.light)[];\nconst sixDigitHexColor = /^#[0-9a-f]{6}$/i;\n\nfunction assertColorRecord(\n  value: unknown,\n  keys: readonly string[],\n  field: string,\n): asserts value is Readonly<Record<string, string>> {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    throw new TypeError(`DesignSystemProviderValue ${field} must be a color record`);\n  }\n  const record = value as Readonly<Record<string, unknown>>;\n  for (const key of keys) {\n    const color = record[key];\n    if (typeof color !== \"string\" || !sixDigitHexColor.test(color)) {\n      throw new TypeError(\n        `DesignSystemProviderValue ${field}.${key} must be a six-digit hex color`,\n      );\n    }\n  }\n}\n\n/**\n * Runtime boundary for reviewed full product palettes supplied to a renderer.\n * Partial token overrides remain unsupported: every semantic role required by\n * a recipe must be present, and alpha composition requires six-digit hex.\n */\nexport function validateDesignSystemProviderValue(\n  value: DesignSystemProviderValue,\n): void {\n  if (value === null || typeof value !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue must be an object\");\n  }\n  if (value.environment === null || typeof value.environment !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue environment must be an object\");\n  }\n  validateResolvedDesignSystemEnvironment(value.environment);\n  const palette = value.palette;\n  if (palette === null || typeof palette !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue palette must be an object\");\n  }\n  assertColorRecord(palette.theme, themeColorKeys, \"palette.theme\");\n  assertColorRecord(\n    palette.statusAccents,\n    accentColorKeys,\n    \"palette.statusAccents\",\n  );\n  assertColorRecord(\n    palette.statusAccentFills,\n    accentColorKeys,\n    \"palette.statusAccentFills\",\n  );\n}\n\nfunction assertBoolean(value: boolean, field: string): void {\n  if (typeof value !== \"boolean\") {\n    throw new TypeError(`DesignSystemEnvironment ${field} must be a boolean`);\n  }\n}\n\nfunction assertDirection(value: DesignSystemDirection, field: string): void {\n  if (value !== \"ltr\" && value !== \"rtl\") {\n    throw new TypeError(`Unsupported DesignSystemEnvironment ${field}: ${String(value)}`);\n  }\n}\n\nfunction assertTextScale(value: DesignSystemTextScale, field: string): void {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0) {\n    throw new RangeError(\n      `DesignSystemEnvironment ${field} must be a finite number greater than 0`,\n    );\n  }\n}\n\nexport function validateDesignSystemEnvironmentInput(\n  input: DesignSystemEnvironmentInput,\n): void {\n  if (input.theme !== undefined && !isThemePreference(input.theme)) {\n    throw new TypeError(`Unsupported DesignSystemEnvironment theme: ${String(input.theme)}`);\n  }\n  if (\n    input.direction !== undefined &&\n    input.direction !== \"ltr\" &&\n    input.direction !== \"rtl\"\n  ) {\n    throw new TypeError(\n      `Unsupported DesignSystemEnvironment direction: ${String(input.direction)}`,\n    );\n  }\n  if (input.textScale !== undefined) {\n    assertTextScale(input.textScale, \"textScale\");\n  }\n  if (input.reducedMotion !== undefined) {\n    assertBoolean(input.reducedMotion, \"reducedMotion\");\n  }\n}\n\n/**\n * A parent has already crossed the system-preference boundary. Unlike the\n * partial input validator, this rejects `\"system\"`, missing axes, and every\n * malformed resolved value instead of silently resolving them again.\n */\nexport function validateResolvedDesignSystemEnvironment(\n  environment: ResolvedDesignSystemEnvironment,\n): void {\n  if (environment.theme !== \"light\" && environment.theme !== \"dark\") {\n    throw new TypeError(\n      `Unsupported ResolvedDesignSystemEnvironment theme: ${String(environment.theme)}`,\n    );\n  }\n  assertDirection(environment.direction, \"parent direction\");\n  assertTextScale(environment.textScale, \"parent textScale\");\n  assertBoolean(environment.reducedMotion, \"parent reducedMotion\");\n}\n\n/**\n * Merges partial signals with safe defaults and resolves `\"system\"` against\n * the renderer-supplied `systemTheme`. This — not a React/RN context, which\n * this package cannot own — is the entire portable contract behind antd\n * `ConfigProvider`: see docs/design-system-provider.md for what was\n * deliberately left to the renderer.\n */\nexport function resolveDesignSystemEnvironment(\n  input: DesignSystemEnvironmentInput,\n  options: ResolveDesignSystemEnvironmentOptions,\n): ResolvedDesignSystemEnvironment {\n  validateDesignSystemEnvironmentInput(input);\n  if (options.systemTheme !== \"light\" && options.systemTheme !== \"dark\") {\n    throw new TypeError(`Unsupported DesignSystemEnvironment systemTheme: ${String(options.systemTheme)}`);\n  }\n  if (options.systemDirection !== undefined) {\n    assertDirection(options.systemDirection, \"systemDirection\");\n  }\n  if (options.systemTextScale !== undefined) {\n    assertTextScale(options.systemTextScale, \"systemTextScale\");\n  }\n  if (options.systemReducedMotion !== undefined) {\n    assertBoolean(options.systemReducedMotion, \"systemReducedMotion\");\n  }\n  if (options.parent !== undefined) {\n    validateResolvedDesignSystemEnvironment(options.parent);\n  }\n\n  const theme =\n    input.theme ?? options.parent?.theme ?? designSystemEnvironmentDefaults.theme;\n  return {\n    theme: theme === \"system\" ? options.systemTheme : theme,\n    direction:\n      input.direction ??\n      options.parent?.direction ??\n      options.systemDirection ??\n      designSystemEnvironmentDefaults.direction,\n    textScale:\n      input.textScale ??\n      options.parent?.textScale ??\n      options.systemTextScale ??\n      designSystemEnvironmentDefaults.textScale,\n    reducedMotion:\n      input.reducedMotion ??\n      options.parent?.reducedMotion ??\n      options.systemReducedMotion ??\n      designSystemEnvironmentDefaults.reducedMotion,\n  };\n}\n\n/**\n * Resolves the portable Provider value without owning React/RN Context. A\n * renderer stores this object in its own context and feeds `palette` directly\n * to recipe color resolution.\n */\nexport function resolveDesignSystemProviderValue(\n  input: DesignSystemEnvironmentInput,\n  options: ResolveDesignSystemEnvironmentOptions,\n): DesignSystemProviderValue {\n  const environment = resolveDesignSystemEnvironment(input, options);\n  const brandOverride = options.brandPalette?.[environment.theme];\n  const value = {\n    environment,\n    palette: {\n      theme: brandOverride === undefined\n        ? THEMES[environment.theme]\n        : { ...THEMES[environment.theme], ...brandOverride },\n      statusAccents: ACCENTS[environment.theme],\n      statusAccentFills: accentFill,\n    },\n  };\n  validateDesignSystemProviderValue(value);\n  return value;\n}\n"]}

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Package release shown by documentation surfaces. Kept in sync by a test. */
-export declare const designSystemVersion: "0.9.1";
+export declare const designSystemVersion: "0.9.2";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 /** Package release shown by documentation surfaces. Kept in sync by a test. */
-export const designSystemVersion = "0.9.1";
+export const designSystemVersion = "0.9.2";
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAgB,CAAC","sourcesContent":["/** Package release shown by documentation surfaces. Kept in sync by a test. */\nexport const designSystemVersion = \"0.9.1\" as const;\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAgB,CAAC","sourcesContent":["/** Package release shown by documentation surfaces. Kept in sync by a test. */\nexport const designSystemVersion = \"0.9.2\" as const;\n"]}

package/docs/generated/component-maturity.md

@@ -1,6 +1,6 @@
 # Component maturity and evidence manifest
 
-> Generated from `@hjmds/design-contracts` 0.9.1. Do not edit this file directly; run `pnpm contracts:sync`.
+> Generated from `@hjmds/design-contracts` 0.9.2. Do not edit this file directly; run `pnpm contracts:sync`.
 
 This document is the human-readable projection of the same catalog and Showcase manifest consumed by product CI.
 

package/docs/generated/renderer-evidence.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": 1,
-  "designSystemVersion": "0.9.1",
+  "designSystemVersion": "0.9.2",
   "source": "packages/design-contracts/docs/generated/showcase-manifest.json",
   "surfaces": {
     "web": {
       "packageName": "@hjmds/react",
-      "packageVersion": "0.9.1",
+      "packageVersion": "0.9.2",
       "activeComponents": 63,
       "claimedComponents": 63,
       "completeScenarioComponents": 33,
@@ -2918,7 +2918,7 @@
     },
     "native": {
       "packageName": "@hjmds/react-native",
-      "packageVersion": "0.9.1",
+      "packageVersion": "0.9.2",
       "activeComponents": 63,
       "claimedComponents": 63,
       "completeScenarioComponents": 34,

package/docs/generated/renderer-evidence.md

@@ -1,6 +1,6 @@
 # Renderer evidence coverage
 
-> Generated for HJM 0.9.1. Do not edit directly; run `pnpm evidence:sync`.
+> Generated for HJM 0.9.2. Do not edit directly; run `pnpm evidence:sync`.
 
 This projection joins the canonical surface maturity manifest with first-party renderer claims. Missing scenarios are explicit beta promotion debt; stable surfaces are blocked by CI until none remain.
 

package/docs/generated/showcase-manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 2,
-  "designSystemVersion": "0.9.1",
+  "designSystemVersion": "0.9.2",
   "packageName": "@hjmds/design-contracts",
   "components": [
     {

package/docs/showcase.md

@@ -72,21 +72,22 @@ CI에서 별도로 빌드·번들 검증하며, HJM 카탈로그의 story identi
 - `pnpm evidence:sync`: first-party renderer claim과 required scenario를 결합한
   `renderer-evidence.json`/`.md` 및 명시적 beta debt 갱신
 - `pnpm evidence:check`: renderer projection이 source와 다르면 CI 실패
-- first-party renderer의 `default` claim은 `proofs[]`에서 canonical render table의 stable
-  case id와 연결되고, 그 table은 evidence ID와 exact equality를 검증한 뒤 모든 case를
-  실행한다. 현재 gate는 구조화된 test-result registry가 없는 non-default scenario claim을
-  전부 거부한다. keyboard·accessibility·device 같은 축은 test case ID와 실행 결과 artifact를
-  exact join하는 registry를 먼저 추가한 뒤에만 열 수 있으며, 파일 안의 주석·문자열이나
-  export 존재만으로 scenario를 claim할 수 없다.
+- renderer의 `test/executed-scenarios.json`은 proof file, `all-cases`와 실행할 scenario/environment를
+  선언한다. 실제 test가 이 registry를 import해 case를 실행하며 package test 실패가 CI로 전파된다.
+- `workspace:check`는 claim의 component/case/proof와 registry의 scenario를 결합한다.
+  non-default scenario도 이 registry와 실행되는 proof에 연결되어야 한다. registry 자체는
+  독립적인 실행 성공 영수증이 아니며 해당 source의 테스트 결과와 함께 읽는다.
 - HJM Storybook: `surfaceStatus.web`으로 renderer/contract-only/unsupported 분류
-- 제품 Storybook verifier: 일반 앱 CI에서는 설치된 `@hjmds/design-contracts/showcase`, release
-  candidate gate에서는 payload full SHA의 generated manifest를 읽어 해당 surface의 active ID와
-  exported CSF registration을 비교하고 missing/unknown/duplicate를 실패 처리
-- 제품 evidence artifact: 검증된 story ID와 실제 실행된 scenario만 schema v1 JSON으로 출력
-- canonical tag gate: 최소 권한 token으로 릴리스 시작 시 두 private 제품의 default-branch
-  HEAD를 full SHA로 캡처해 `repository_dispatch`하고, 같은 canonical release SHA·consumer
-  SHA·correlation ID가 run과 artifact JSON 내부까지 exact-join된 두 검증이 모두 성공하기
-  전에는 tag를 생성하지 않음
+- 제품 Storybook verifier: 설치한 `@hjmds/design-contracts/showcase`를 기준으로 실제 채택한
+  story와 scenario를 검증한다. 전체 inventory gate는 full-coverage 구현에만 적용한다.
+- 제품 evidence artifact: 검증한 story ID·실제로 실행한 scenario·소비 버전/source를 기록한다.
+- `pnpm governance:check`: canonical `ci:check`/`release:check` 연결, renderer test/생성 drift 검사,
+  registry 연결과 release verification step의 실패 전파·publish/tag 이전 순서를 검증한다.
+
+현재 canonical tag는 **내부 package·Showcase 검사**를 기준으로 생성한다. 외부 소비 제품을
+`repository_dispatch`하고 release SHA·consumer SHA·run/artifact를 결합해 기다리는 gate는
+구현되어 있지 않다. 제품 CI/기기 QA는 별도 범위다. 현재 실행 계약과 향후 외부 gate 설계는
+[릴리스 검증 계약](../../../docs/RELEASE_GOVERNANCE.md)을 따른다.
 
 `compareShowcaseStoryIds`와 `assertShowcaseStoryIds`는 모든 Stable/Beta 컴포넌트를 제공하는
 first-party/full-coverage Storybook의 inventory gate입니다. 부분 채택 소비 앱이나 개별 화면은

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hjmds/design-contracts",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "Renderer-neutral design contracts, tokens, recipes, and behaviors shared by HJM products.",
   "license": "MIT",
   "repository": {