@aloudata/aloudata-design 3.1.0 → 3.1.2

package/dist/theme/contract/baselineResolvedTokenValueManifest.d.ts

@@ -16,7 +16,7 @@ export interface BaselineResolvedTokenValueManifestValidationResult {
     errors: string[];
     fingerprint: string;
 }
-export declare const baselineResolvedTokenValueManifestVersion: "baseline-resolved-token-values-v1";
+export declare const baselineResolvedTokenValueManifestVersion: "baseline-resolved-token-values-v2";
 export declare const baselineResolvedTokenValueManifest: readonly BaselineResolvedTokenValueManifestRecord[];
 export declare const baselineResolvedTokenValueManifestFingerprint: string;
 export declare function validateBaselineResolvedTokenValueManifest(): BaselineResolvedTokenValueManifestValidationResult;

package/dist/theme/contract/darkResolvedTokenValueManifest.d.ts

@@ -1,5 +1,5 @@
 import { BaselineResolvedTokenValueManifestRecord, BaselineResolvedTokenValueManifestValidationResult } from './baselineResolvedTokenValueManifest.js';
-export declare const darkResolvedTokenValueManifestVersion: "dark-resolved-token-values-v1";
+export declare const darkResolvedTokenValueManifestVersion: "dark-resolved-token-values-v2";
 export declare const darkResolvedTokenValueManifest: readonly BaselineResolvedTokenValueManifestRecord[];
 export declare const darkResolvedTokenValueManifestFingerprint: string;
 export declare function validateDarkResolvedTokenValueManifest(): BaselineResolvedTokenValueManifestValidationResult;

package/dist/theme/contract/tokenOutputContract.js

@@ -39,6 +39,7 @@ var actionOutputNames = [
 var backgroundOutputNames = [
 	"--background-default",
 	"--background-inverted",
+	"--background-mask",
 	"--background-brand-muted",
 	"--background-brand-on-subtle",
 	"--background-brand-strong",

package/dist/theme/contract/tokenOutputContract.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokenOutputContract.js","names":[],"sources":["../../../src/theme/contract/tokenOutputContract.ts"],"sourcesContent":["import {\n  migrationMappingRegistry,\n  type LegacyCssVariableName,\n  type TokenOutputVariableName,\n} from '../governance/migrationMappingRegistry';\n\nexport type TokenOutputContractGroup =\n  | 'action'\n  | 'background'\n  | 'border'\n  | 'control-state'\n  | 'focus'\n  | 'content'\n  | 'dimension'\n  | 'compatibility';\n\nexport type TokenOutputContractDeliveryKind = 'css-variable';\n\nexport type TokenOutputContractLifecycle =\n  | 'active'\n  | 'deprecated'\n  | 'compatibility';\n\nexport interface TokenOutputContractCompatibility {\n  source?: LegacyCssVariableName;\n  reason: string;\n}\n\nexport interface TokenOutputContractEntry {\n  name: TokenOutputVariableName;\n  group: TokenOutputContractGroup;\n  delivery: TokenOutputContractDeliveryKind;\n  lifecycle: TokenOutputContractLifecycle;\n  compatibility?: TokenOutputContractCompatibility;\n  description?: string;\n}\n\nexport type TokenOutputContractValidationIssueCode =\n  | 'duplicate-name'\n  | 'invalid-name'\n  | 'invalid-legacy-canonical-name'\n  | 'invalid-compatibility-name'\n  | 'missing-published-migration-target'\n  | 'legacy-source-promoted-to-canonical-output';\n\nexport interface TokenOutputContractValidationIssue {\n  code: TokenOutputContractValidationIssueCode;\n  name: string;\n  message: string;\n}\n\nexport interface TokenOutputContractValidationReport {\n  valid: boolean;\n  entriesChecked: number;\n  errors: TokenOutputContractValidationIssue[];\n}\n\nconst legacySourcePrefixes = [\n  '--alias-',\n  '--interaction-',\n  '--non-semantic-',\n] as const;\n\nfunction createEntries(\n  group: TokenOutputContractGroup,\n  names: readonly TokenOutputVariableName[],\n): TokenOutputContractEntry[] {\n  return names.map((name) => ({\n    name,\n    group,\n    delivery: 'css-variable',\n    lifecycle: 'active',\n    compatibility: undefined,\n  }));\n}\n\nfunction actionStates(\n  family: string,\n  states: readonly string[] = ['normal', 'hover', 'active', 'selected'],\n): TokenOutputVariableName[] {\n  return states.map((state) => `--action-${family}-${state}` as const);\n}\n\nconst actionOutputNames: TokenOutputVariableName[] = [\n  ...actionStates('primary'),\n  ...actionStates('primary-subtle'),\n  ...actionStates('neutral'),\n  ...actionStates('neutral-subtle'),\n  ...actionStates('destructive'),\n  ...actionStates('destructive-subtle'),\n  ...actionStates('ghost'),\n  ...actionStates('ghost-inverted', ['hover', 'active', 'selected']),\n  ...actionStates('ghost-destructive', ['hover', 'active', 'selected']),\n  ...actionStates('inverted'),\n];\n\nconst backgroundOutputNames: TokenOutputVariableName[] = [\n  '--background-default',\n  '--background-inverted',\n  '--background-brand-muted',\n  '--background-brand-on-subtle',\n  '--background-brand-strong',\n  '--background-neutral-hard',\n  '--background-neutral-muted',\n  '--background-neutral-on-subtle',\n  '--background-neutral-strong',\n  '--background-neutral-subtle',\n  '--background-neutral-surface',\n  '--background-informative-muted',\n  '--background-informative-on-subtle',\n  '--background-informative-strong',\n  '--background-informative-subtle',\n  '--background-informative-surface',\n  '--background-positive-muted',\n  '--background-positive-on-subtle',\n  '--background-positive-strong',\n  '--background-positive-subtle',\n  '--background-positive-surface',\n  '--background-warning-muted',\n  '--background-warning-on-subtle',\n  '--background-warning-strong',\n  '--background-warning-subtle',\n  '--background-warning-surface',\n  '--background-negative-muted',\n  '--background-negative-on-subtle',\n  '--background-negative-strong',\n  '--background-negative-subtle',\n  '--background-negative-surface',\n];\n\nconst borderOutputNames: TokenOutputVariableName[] = [\n  '--border-default',\n  '--border-default-alpha',\n  '--border-inverted',\n  '--border-brand-strong',\n  '--border-brand-subtle',\n  '--border-neutral-strong',\n  '--border-neutral-subtle',\n  '--border-informative-strong',\n  '--border-informative-subtle',\n  '--border-positive-strong',\n  '--border-positive-subtle',\n  '--border-warning-strong',\n  '--border-warning-subtle',\n  '--border-negative-strong',\n  '--border-negative-subtle',\n];\n\nconst contentOutputNames: TokenOutputVariableName[] = [\n  '--content-primary',\n  '--content-secondary',\n  '--content-tertiary',\n  '--content-disabled',\n  '--content-brand-primary',\n  '--content-brand-secondary',\n  '--content-inverted-primary',\n  '--content-inverted-secondary',\n  '--content-inverted-tertiary',\n  '--content-inverted-disabled',\n  '--content-informative-primary',\n  '--content-informative-secondary',\n  '--content-positive-primary',\n  '--content-positive-secondary',\n  '--content-warning-primary',\n  '--content-warning-secondary',\n  '--content-negative-primary',\n  '--content-negative-secondary',\n];\n\nconst controlStateOutputNames: TokenOutputVariableName[] = [\n  '--control-state-selected',\n  '--control-state-unselected',\n];\n\nconst focusOutputNames: TokenOutputVariableName[] = ['--focus-ring'];\n\nconst dimensionOutputNames: TokenOutputVariableName[] = [\n  '--dimension-0',\n  '--dimension-0-5',\n  '--dimension-1',\n  '--dimension-1-5',\n  '--dimension-2',\n  '--dimension-3',\n  '--dimension-4',\n  '--dimension-5',\n  '--dimension-6',\n  '--dimension-8',\n  '--dimension-10',\n  '--dimension-12',\n  '--dimension-14',\n  '--dimension-16',\n  '--dimension-18',\n  '--dimension-20',\n];\n\nexport const tokenOutputContractEntries = [\n  ...createEntries('action', actionOutputNames),\n  ...createEntries('background', backgroundOutputNames),\n  ...createEntries('border', borderOutputNames),\n  ...createEntries('control-state', controlStateOutputNames),\n  ...createEntries('focus', focusOutputNames),\n  ...createEntries('content', contentOutputNames),\n  ...createEntries('dimension', dimensionOutputNames),\n] as const satisfies readonly TokenOutputContractEntry[];\n\nfunction isLegacySourceName(name: string) {\n  return legacySourcePrefixes.some((prefix) => name.startsWith(prefix));\n}\n\nfunction createEntryMap(entries = tokenOutputContractEntries) {\n  return new Map(entries.map((entry) => [entry.name, entry]));\n}\n\nexport function getTokenOutputContractEntries(): TokenOutputContractEntry[] {\n  return [...tokenOutputContractEntries];\n}\n\nexport function getTokenOutputContractEntry(\n  name: string,\n): TokenOutputContractEntry | undefined {\n  return createEntryMap().get(name as TokenOutputVariableName);\n}\n\nexport function isTokenOutputContractName(\n  name: string,\n): name is TokenOutputVariableName {\n  return createEntryMap().has(name as TokenOutputVariableName);\n}\n\nexport function getTokenOutputContractEntriesByGroup(\n  group: TokenOutputContractGroup,\n): TokenOutputContractEntry[] {\n  return tokenOutputContractEntries.filter((entry) => entry.group === group);\n}\n\nexport function getCanonicalTokenOutputContractEntries(): TokenOutputContractEntry[] {\n  return tokenOutputContractEntries.filter(\n    (entry) => entry.lifecycle === 'active' && !entry.compatibility,\n  );\n}\n\nexport function getCompatibilityTokenOutputContractEntries(): TokenOutputContractEntry[] {\n  return tokenOutputContractEntries.filter(\n    (entry) =>\n      entry.lifecycle === 'compatibility' || Boolean(entry.compatibility),\n  );\n}\n\nfunction createError(\n  code: TokenOutputContractValidationIssueCode,\n  name: string,\n  message: string,\n): TokenOutputContractValidationIssue {\n  return { code, name, message };\n}\n\nexport function validateTokenOutputContract(\n  entries: readonly TokenOutputContractEntry[] = tokenOutputContractEntries,\n): TokenOutputContractValidationReport {\n  const errors: TokenOutputContractValidationIssue[] = [];\n  const seen = new Set<string>();\n  const entryMap = createEntryMap(entries);\n\n  for (const entry of entries) {\n    if (seen.has(entry.name)) {\n      errors.push(\n        createError(\n          'duplicate-name',\n          entry.name,\n          `${entry.name} is duplicated in Token Output Contract.`,\n        ),\n      );\n    }\n    seen.add(entry.name);\n\n    if (!entry.name.startsWith('--')) {\n      errors.push(\n        createError(\n          'invalid-name',\n          entry.name,\n          `${entry.name} must be a CSS custom property name.`,\n        ),\n      );\n    }\n\n    if (\n      entry.lifecycle === 'active' &&\n      !entry.compatibility &&\n      isLegacySourceName(entry.name)\n    ) {\n      errors.push(\n        createError(\n          'invalid-legacy-canonical-name',\n          entry.name,\n          `${entry.name} must not be promoted to active canonical output.`,\n        ),\n      );\n    }\n\n    if (\n      isLegacySourceName(entry.name) &&\n      (entry.lifecycle !== 'compatibility' || !entry.compatibility)\n    ) {\n      errors.push(\n        createError(\n          'invalid-compatibility-name',\n          entry.name,\n          `${entry.name} uses legacy naming and must be explicit compatibility output.`,\n        ),\n      );\n    }\n  }\n\n  for (const mapping of migrationMappingRegistry) {\n    if (mapping.lifecycle === 'published' && mapping.target) {\n      if (!entryMap.has(mapping.target)) {\n        errors.push(\n          createError(\n            'missing-published-migration-target',\n            mapping.target,\n            `${mapping.target} is targeted by ${mapping.source} but is not in Token Output Contract.`,\n          ),\n        );\n      }\n    }\n\n    const sourceEntry = entryMap.get(mapping.source);\n    if (\n      sourceEntry &&\n      sourceEntry.lifecycle === 'active' &&\n      !sourceEntry.compatibility\n    ) {\n      errors.push(\n        createError(\n          'legacy-source-promoted-to-canonical-output',\n          mapping.source,\n          `${mapping.source} is a legacy source and must not be active canonical output.`,\n        ),\n      );\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    entriesChecked: entries.length,\n    errors,\n  };\n}\n"],"mappings":";AA+DA,SAAS,cACP,OACA,OAC4B;AAC5B,QAAO,MAAM,KAAK,UAAU;EAC1B;EACA;EACA,UAAU;EACV,WAAW;EACX,eAAe;EAChB,EAAE;;AAGL,SAAS,aACP,QACA,SAA4B;CAAC;CAAU;CAAS;CAAU;CAAW,EAC1C;AAC3B,QAAO,OAAO,KAAK,UAAU,YAAY,OAAO,GAAG,QAAiB;;AAGtE,IAAM,oBAA+C;CACnD,GAAG,aAAa,UAAU;CAC1B,GAAG,aAAa,iBAAiB;CACjC,GAAG,aAAa,UAAU;CAC1B,GAAG,aAAa,iBAAiB;CACjC,GAAG,aAAa,cAAc;CAC9B,GAAG,aAAa,qBAAqB;CACrC,GAAG,aAAa,QAAQ;CACxB,GAAG,aAAa,kBAAkB;EAAC;EAAS;EAAU;EAAW,CAAC;CAClE,GAAG,aAAa,qBAAqB;EAAC;EAAS;EAAU;EAAW,CAAC;CACrE,GAAG,aAAa,WAAW;CAC5B;AAED,IAAM,wBAAmD;CACvD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,IAAM,oBAA+C;CACnD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,IAAM,qBAAgD;CACpD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,IAAM,0BAAqD,CACzD,4BACA,6BACD;AAED,IAAM,mBAA8C,CAAC,eAAe;AAEpE,IAAM,uBAAkD;CACtD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,IAAa,6BAA6B;CACxC,GAAG,cAAc,UAAU,kBAAkB;CAC7C,GAAG,cAAc,cAAc,sBAAsB;CACrD,GAAG,cAAc,UAAU,kBAAkB;CAC7C,GAAG,cAAc,iBAAiB,wBAAwB;CAC1D,GAAG,cAAc,SAAS,iBAAiB;CAC3C,GAAG,cAAc,WAAW,mBAAmB;CAC/C,GAAG,cAAc,aAAa,qBAAqB;CACpD;AAMD,SAAS,eAAe,UAAU,4BAA4B;AAC5D,QAAO,IAAI,IAAI,QAAQ,KAAK,UAAU,CAAC,MAAM,MAAM,MAAM,CAAC,CAAC;;AAG7D,SAAgB,gCAA4D;AAC1E,QAAO,CAAC,GAAG,2BAA2B;;AAGxC,SAAgB,4BACd,MACsC;AACtC,QAAO,gBAAgB,CAAC,IAAI,KAAgC;;AAS9D,SAAgB,qCACd,OAC4B;AAC5B,QAAO,2BAA2B,QAAQ,UAAU,MAAM,UAAU,MAAM;;AAG5E,SAAgB,yCAAqE;AACnF,QAAO,2BAA2B,QAC/B,UAAU,MAAM,cAAc,YAAY,CAAC,MAAM,cACnD;;AAGH,SAAgB,6CAAyE;AACvF,QAAO,2BAA2B,QAC/B,UACC,MAAM,cAAc,mBAAmB,QAAQ,MAAM,cAAc,CACtE"}
+{"version":3,"file":"tokenOutputContract.js","names":[],"sources":["../../../src/theme/contract/tokenOutputContract.ts"],"sourcesContent":["import {\n  migrationMappingRegistry,\n  type LegacyCssVariableName,\n  type TokenOutputVariableName,\n} from '../governance/migrationMappingRegistry';\n\nexport type TokenOutputContractGroup =\n  | 'action'\n  | 'background'\n  | 'border'\n  | 'control-state'\n  | 'focus'\n  | 'content'\n  | 'dimension'\n  | 'compatibility';\n\nexport type TokenOutputContractDeliveryKind = 'css-variable';\n\nexport type TokenOutputContractLifecycle =\n  | 'active'\n  | 'deprecated'\n  | 'compatibility';\n\nexport interface TokenOutputContractCompatibility {\n  source?: LegacyCssVariableName;\n  reason: string;\n}\n\nexport interface TokenOutputContractEntry {\n  name: TokenOutputVariableName;\n  group: TokenOutputContractGroup;\n  delivery: TokenOutputContractDeliveryKind;\n  lifecycle: TokenOutputContractLifecycle;\n  compatibility?: TokenOutputContractCompatibility;\n  description?: string;\n}\n\nexport type TokenOutputContractValidationIssueCode =\n  | 'duplicate-name'\n  | 'invalid-name'\n  | 'invalid-legacy-canonical-name'\n  | 'invalid-compatibility-name'\n  | 'missing-published-migration-target'\n  | 'legacy-source-promoted-to-canonical-output';\n\nexport interface TokenOutputContractValidationIssue {\n  code: TokenOutputContractValidationIssueCode;\n  name: string;\n  message: string;\n}\n\nexport interface TokenOutputContractValidationReport {\n  valid: boolean;\n  entriesChecked: number;\n  errors: TokenOutputContractValidationIssue[];\n}\n\nconst legacySourcePrefixes = [\n  '--alias-',\n  '--interaction-',\n  '--non-semantic-',\n] as const;\n\nfunction createEntries(\n  group: TokenOutputContractGroup,\n  names: readonly TokenOutputVariableName[],\n): TokenOutputContractEntry[] {\n  return names.map((name) => ({\n    name,\n    group,\n    delivery: 'css-variable',\n    lifecycle: 'active',\n    compatibility: undefined,\n  }));\n}\n\nfunction actionStates(\n  family: string,\n  states: readonly string[] = ['normal', 'hover', 'active', 'selected'],\n): TokenOutputVariableName[] {\n  return states.map((state) => `--action-${family}-${state}` as const);\n}\n\nconst actionOutputNames: TokenOutputVariableName[] = [\n  ...actionStates('primary'),\n  ...actionStates('primary-subtle'),\n  ...actionStates('neutral'),\n  ...actionStates('neutral-subtle'),\n  ...actionStates('destructive'),\n  ...actionStates('destructive-subtle'),\n  ...actionStates('ghost'),\n  ...actionStates('ghost-inverted', ['hover', 'active', 'selected']),\n  ...actionStates('ghost-destructive', ['hover', 'active', 'selected']),\n  ...actionStates('inverted'),\n];\n\nconst backgroundOutputNames: TokenOutputVariableName[] = [\n  '--background-default',\n  '--background-inverted',\n  '--background-mask',\n  '--background-brand-muted',\n  '--background-brand-on-subtle',\n  '--background-brand-strong',\n  '--background-neutral-hard',\n  '--background-neutral-muted',\n  '--background-neutral-on-subtle',\n  '--background-neutral-strong',\n  '--background-neutral-subtle',\n  '--background-neutral-surface',\n  '--background-informative-muted',\n  '--background-informative-on-subtle',\n  '--background-informative-strong',\n  '--background-informative-subtle',\n  '--background-informative-surface',\n  '--background-positive-muted',\n  '--background-positive-on-subtle',\n  '--background-positive-strong',\n  '--background-positive-subtle',\n  '--background-positive-surface',\n  '--background-warning-muted',\n  '--background-warning-on-subtle',\n  '--background-warning-strong',\n  '--background-warning-subtle',\n  '--background-warning-surface',\n  '--background-negative-muted',\n  '--background-negative-on-subtle',\n  '--background-negative-strong',\n  '--background-negative-subtle',\n  '--background-negative-surface',\n];\n\nconst borderOutputNames: TokenOutputVariableName[] = [\n  '--border-default',\n  '--border-default-alpha',\n  '--border-inverted',\n  '--border-brand-strong',\n  '--border-brand-subtle',\n  '--border-neutral-strong',\n  '--border-neutral-subtle',\n  '--border-informative-strong',\n  '--border-informative-subtle',\n  '--border-positive-strong',\n  '--border-positive-subtle',\n  '--border-warning-strong',\n  '--border-warning-subtle',\n  '--border-negative-strong',\n  '--border-negative-subtle',\n];\n\nconst contentOutputNames: TokenOutputVariableName[] = [\n  '--content-primary',\n  '--content-secondary',\n  '--content-tertiary',\n  '--content-disabled',\n  '--content-brand-primary',\n  '--content-brand-secondary',\n  '--content-inverted-primary',\n  '--content-inverted-secondary',\n  '--content-inverted-tertiary',\n  '--content-inverted-disabled',\n  '--content-informative-primary',\n  '--content-informative-secondary',\n  '--content-positive-primary',\n  '--content-positive-secondary',\n  '--content-warning-primary',\n  '--content-warning-secondary',\n  '--content-negative-primary',\n  '--content-negative-secondary',\n];\n\nconst controlStateOutputNames: TokenOutputVariableName[] = [\n  '--control-state-selected',\n  '--control-state-unselected',\n];\n\nconst focusOutputNames: TokenOutputVariableName[] = ['--focus-ring'];\n\nconst dimensionOutputNames: TokenOutputVariableName[] = [\n  '--dimension-0',\n  '--dimension-0-5',\n  '--dimension-1',\n  '--dimension-1-5',\n  '--dimension-2',\n  '--dimension-3',\n  '--dimension-4',\n  '--dimension-5',\n  '--dimension-6',\n  '--dimension-8',\n  '--dimension-10',\n  '--dimension-12',\n  '--dimension-14',\n  '--dimension-16',\n  '--dimension-18',\n  '--dimension-20',\n];\n\nexport const tokenOutputContractEntries = [\n  ...createEntries('action', actionOutputNames),\n  ...createEntries('background', backgroundOutputNames),\n  ...createEntries('border', borderOutputNames),\n  ...createEntries('control-state', controlStateOutputNames),\n  ...createEntries('focus', focusOutputNames),\n  ...createEntries('content', contentOutputNames),\n  ...createEntries('dimension', dimensionOutputNames),\n] as const satisfies readonly TokenOutputContractEntry[];\n\nfunction isLegacySourceName(name: string) {\n  return legacySourcePrefixes.some((prefix) => name.startsWith(prefix));\n}\n\nfunction createEntryMap(entries = tokenOutputContractEntries) {\n  return new Map(entries.map((entry) => [entry.name, entry]));\n}\n\nexport function getTokenOutputContractEntries(): TokenOutputContractEntry[] {\n  return [...tokenOutputContractEntries];\n}\n\nexport function getTokenOutputContractEntry(\n  name: string,\n): TokenOutputContractEntry | undefined {\n  return createEntryMap().get(name as TokenOutputVariableName);\n}\n\nexport function isTokenOutputContractName(\n  name: string,\n): name is TokenOutputVariableName {\n  return createEntryMap().has(name as TokenOutputVariableName);\n}\n\nexport function getTokenOutputContractEntriesByGroup(\n  group: TokenOutputContractGroup,\n): TokenOutputContractEntry[] {\n  return tokenOutputContractEntries.filter((entry) => entry.group === group);\n}\n\nexport function getCanonicalTokenOutputContractEntries(): TokenOutputContractEntry[] {\n  return tokenOutputContractEntries.filter(\n    (entry) => entry.lifecycle === 'active' && !entry.compatibility,\n  );\n}\n\nexport function getCompatibilityTokenOutputContractEntries(): TokenOutputContractEntry[] {\n  return tokenOutputContractEntries.filter(\n    (entry) =>\n      entry.lifecycle === 'compatibility' || Boolean(entry.compatibility),\n  );\n}\n\nfunction createError(\n  code: TokenOutputContractValidationIssueCode,\n  name: string,\n  message: string,\n): TokenOutputContractValidationIssue {\n  return { code, name, message };\n}\n\nexport function validateTokenOutputContract(\n  entries: readonly TokenOutputContractEntry[] = tokenOutputContractEntries,\n): TokenOutputContractValidationReport {\n  const errors: TokenOutputContractValidationIssue[] = [];\n  const seen = new Set<string>();\n  const entryMap = createEntryMap(entries);\n\n  for (const entry of entries) {\n    if (seen.has(entry.name)) {\n      errors.push(\n        createError(\n          'duplicate-name',\n          entry.name,\n          `${entry.name} is duplicated in Token Output Contract.`,\n        ),\n      );\n    }\n    seen.add(entry.name);\n\n    if (!entry.name.startsWith('--')) {\n      errors.push(\n        createError(\n          'invalid-name',\n          entry.name,\n          `${entry.name} must be a CSS custom property name.`,\n        ),\n      );\n    }\n\n    if (\n      entry.lifecycle === 'active' &&\n      !entry.compatibility &&\n      isLegacySourceName(entry.name)\n    ) {\n      errors.push(\n        createError(\n          'invalid-legacy-canonical-name',\n          entry.name,\n          `${entry.name} must not be promoted to active canonical output.`,\n        ),\n      );\n    }\n\n    if (\n      isLegacySourceName(entry.name) &&\n      (entry.lifecycle !== 'compatibility' || !entry.compatibility)\n    ) {\n      errors.push(\n        createError(\n          'invalid-compatibility-name',\n          entry.name,\n          `${entry.name} uses legacy naming and must be explicit compatibility output.`,\n        ),\n      );\n    }\n  }\n\n  for (const mapping of migrationMappingRegistry) {\n    if (mapping.lifecycle === 'published' && mapping.target) {\n      if (!entryMap.has(mapping.target)) {\n        errors.push(\n          createError(\n            'missing-published-migration-target',\n            mapping.target,\n            `${mapping.target} is targeted by ${mapping.source} but is not in Token Output Contract.`,\n          ),\n        );\n      }\n    }\n\n    const sourceEntry = entryMap.get(mapping.source);\n    if (\n      sourceEntry &&\n      sourceEntry.lifecycle === 'active' &&\n      !sourceEntry.compatibility\n    ) {\n      errors.push(\n        createError(\n          'legacy-source-promoted-to-canonical-output',\n          mapping.source,\n          `${mapping.source} is a legacy source and must not be active canonical output.`,\n        ),\n      );\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    entriesChecked: entries.length,\n    errors,\n  };\n}\n"],"mappings":";AA+DA,SAAS,cACP,OACA,OAC4B;AAC5B,QAAO,MAAM,KAAK,UAAU;EAC1B;EACA;EACA,UAAU;EACV,WAAW;EACX,eAAe;EAChB,EAAE;;AAGL,SAAS,aACP,QACA,SAA4B;CAAC;CAAU;CAAS;CAAU;CAAW,EAC1C;AAC3B,QAAO,OAAO,KAAK,UAAU,YAAY,OAAO,GAAG,QAAiB;;AAGtE,IAAM,oBAA+C;CACnD,GAAG,aAAa,UAAU;CAC1B,GAAG,aAAa,iBAAiB;CACjC,GAAG,aAAa,UAAU;CAC1B,GAAG,aAAa,iBAAiB;CACjC,GAAG,aAAa,cAAc;CAC9B,GAAG,aAAa,qBAAqB;CACrC,GAAG,aAAa,QAAQ;CACxB,GAAG,aAAa,kBAAkB;EAAC;EAAS;EAAU;EAAW,CAAC;CAClE,GAAG,aAAa,qBAAqB;EAAC;EAAS;EAAU;EAAW,CAAC;CACrE,GAAG,aAAa,WAAW;CAC5B;AAED,IAAM,wBAAmD;CACvD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,IAAM,oBAA+C;CACnD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,IAAM,qBAAgD;CACpD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,IAAM,0BAAqD,CACzD,4BACA,6BACD;AAED,IAAM,mBAA8C,CAAC,eAAe;AAEpE,IAAM,uBAAkD;CACtD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,IAAa,6BAA6B;CACxC,GAAG,cAAc,UAAU,kBAAkB;CAC7C,GAAG,cAAc,cAAc,sBAAsB;CACrD,GAAG,cAAc,UAAU,kBAAkB;CAC7C,GAAG,cAAc,iBAAiB,wBAAwB;CAC1D,GAAG,cAAc,SAAS,iBAAiB;CAC3C,GAAG,cAAc,WAAW,mBAAmB;CAC/C,GAAG,cAAc,aAAa,qBAAqB;CACpD;AAMD,SAAS,eAAe,UAAU,4BAA4B;AAC5D,QAAO,IAAI,IAAI,QAAQ,KAAK,UAAU,CAAC,MAAM,MAAM,MAAM,CAAC,CAAC;;AAG7D,SAAgB,gCAA4D;AAC1E,QAAO,CAAC,GAAG,2BAA2B;;AAGxC,SAAgB,4BACd,MACsC;AACtC,QAAO,gBAAgB,CAAC,IAAI,KAAgC;;AAS9D,SAAgB,qCACd,OAC4B;AAC5B,QAAO,2BAA2B,QAAQ,UAAU,MAAM,UAAU,MAAM;;AAG5E,SAAgB,yCAAqE;AACnF,QAAO,2BAA2B,QAC/B,UAAU,MAAM,cAAc,YAAY,CAAC,MAAM,cACnD;;AAGH,SAAgB,6CAAyE;AACvF,QAAO,2BAA2B,QAC/B,UACC,MAAM,cAAc,mBAAmB,QAAQ,MAAM,cAAc,CACtE"}

package/dist/theme/generator/acceptedColorValues.d.ts

@@ -46,6 +46,7 @@ export interface AcceptedPaletteValueRecord extends AcceptedColorValueBaseRecord
     format: AcceptedColorValueFormat;
     scale: string;
     role?: string;
+    source?: 'neutral' | 'slate' | 'stone';
 }
 export interface AcceptedSemanticRoleRecord extends AcceptedColorValueBaseRecord {
     type: 'semantic-role';
@@ -70,7 +71,7 @@ export interface AcceptedBrandSeedRecord extends AcceptedColorValueBaseRecord {
     overridePolicy: AcceptedBrandSeedOverridePolicy;
 }
 export type AcceptedColorValueRecord = AcceptedPaletteValueRecord | AcceptedSemanticRoleRecord | AcceptedThemeMappingRecord | AcceptedBrandSeedRecord;
-export type AcceptedColorValueSourceValidationIssueCode = 'invalid-record' | 'duplicate-id' | 'duplicate-name-in-family' | 'missing-required-field' | 'invalid-family' | 'invalid-record-type' | 'invalid-lifecycle' | 'invalid-color-format' | 'invalid-theme' | 'invalid-semantic-domain' | 'invalid-provenance-decision-status' | 'invalid-provenance-derivation' | 'invalid-resolution-mode' | 'invalid-override-policy' | 'invalid-record-family' | 'forbidden-authority' | 'missing-theme-mapping-source' | 'missing-scale-stop';
+export type AcceptedColorValueSourceValidationIssueCode = 'invalid-record' | 'duplicate-id' | 'duplicate-name-in-family' | 'missing-required-field' | 'invalid-family' | 'invalid-record-type' | 'invalid-lifecycle' | 'invalid-color-format' | 'invalid-theme' | 'invalid-semantic-domain' | 'invalid-provenance-decision-status' | 'invalid-provenance-derivation' | 'invalid-resolution-mode' | 'invalid-override-policy' | 'invalid-record-family' | 'forbidden-authority' | 'missing-theme-mapping-source' | 'missing-scale-stop' | 'invalid-neutral-source' | 'duplicate-neutral-source-stop';
 export interface AcceptedColorValueSourceValidationIssue {
     code: AcceptedColorValueSourceValidationIssueCode;
     message: string;

package/dist/theme/generator/baselineTokenValueDelivery.d.ts

@@ -1,5 +1,7 @@
 import { BaselineResolvedTokenValueManifestRecord, BaselineResolvedTokenValueManifestValidationResult } from '../contract/baselineResolvedTokenValueManifest';
+import { NeutralSourceId } from './neutralSourceValues.js';
 export interface TokenValueDeliveryDefinition {
+    source: NeutralSourceId;
     mode: 'light' | 'dark';
     manifestName: string;
     fingerprint: string;
@@ -8,10 +10,16 @@ export interface TokenValueDeliveryDefinition {
     validate: () => BaselineResolvedTokenValueManifestValidationResult;
     runtimeExportName: string;
     runtimeFingerprintExportName: string;
+    cssFileName: string;
+    runtimeFileName: string;
 }
 export declare const baselineTokenValueDeliveryDefinition: TokenValueDeliveryDefinition;
 export declare const darkTokenValueDeliveryDefinition: TokenValueDeliveryDefinition;
-export declare const tokenValueDeliveryDefinitions: readonly [TokenValueDeliveryDefinition, TokenValueDeliveryDefinition];
+export declare const slateLightTokenValueDeliveryDefinition: TokenValueDeliveryDefinition;
+export declare const slateDarkTokenValueDeliveryDefinition: TokenValueDeliveryDefinition;
+export declare const stoneLightTokenValueDeliveryDefinition: TokenValueDeliveryDefinition;
+export declare const stoneDarkTokenValueDeliveryDefinition: TokenValueDeliveryDefinition;
+export declare const tokenValueDeliveryDefinitions: readonly [TokenValueDeliveryDefinition, TokenValueDeliveryDefinition, TokenValueDeliveryDefinition, TokenValueDeliveryDefinition, TokenValueDeliveryDefinition, TokenValueDeliveryDefinition];
 export declare function renderTokenValuesCss(definition: TokenValueDeliveryDefinition): string;
 export declare function renderTokenValueDeclarationsModule(definition: TokenValueDeliveryDefinition): string;
 export declare function renderBaselineTokenValuesCss(): string;

package/dist/theme/generator/minimalAcceptedColorValues.d.ts

@@ -1,5 +1,5 @@
 import { AcceptedPaletteValueRecord, ValueSourceProvenance } from './acceptedColorValues.js';
-export declare const minimalAcceptedPaletteValues: readonly [AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord];
+export declare const minimalAcceptedPaletteValues: readonly [...AcceptedPaletteValueRecord[], AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord];
 export declare const minimalAcceptedBrandSeedValues: readonly [{
     readonly id: "brand-seed:default-brand";
     readonly type: "brand-seed";
@@ -12,7 +12,7 @@ export declare const minimalAcceptedBrandSeedValues: readonly [{
     readonly generatedScaleFamily: "brand";
     readonly overridePolicy: "default-only";
 }];
-export declare const minimalAcceptedColorValues: readonly [AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, {
+export declare const minimalAcceptedColorValues: readonly [...AcceptedPaletteValueRecord[], AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, AcceptedPaletteValueRecord, {
     readonly id: "brand-seed:default-brand";
     readonly type: "brand-seed";
     readonly family: "brand";

package/dist/theme/generator/neutralSourceResolver.d.ts

@@ -0,0 +1,28 @@
+import { BaselineResolvedTokenValueManifestRecord, BaselineResolvedTokenValueManifestValidationResult } from '../contract/baselineResolvedTokenValueManifest';
+import { TokenOutputVariableName } from '../governance/migrationMappingRegistry';
+import { absoluteColorValues, blackAlphaValues, whiteAlphaValues, NeutralSourceId, NeutralStop } from './neutralSourceValues.js';
+export type NeutralSourceMode = 'light' | 'dark';
+export interface ResolveNeutralSourceManifestInput {
+    source: NeutralSourceId;
+    mode: NeutralSourceMode;
+}
+type NeutralReference = {
+    type: 'source';
+    stop: NeutralStop;
+} | {
+    type: 'black-alpha';
+    stop: keyof typeof blackAlphaValues;
+} | {
+    type: 'white-alpha';
+    stop: keyof typeof whiteAlphaValues;
+} | {
+    type: 'absolute';
+    value: keyof typeof absoluteColorValues;
+};
+type NeutralSemanticMapping = Partial<Record<TokenOutputVariableName, NeutralReference>>;
+export declare const lightNeutralSemanticMapping: NeutralSemanticMapping;
+export declare const darkNeutralSemanticMapping: NeutralSemanticMapping;
+export declare function resolveNeutralSourceManifest({ source: sourceId, mode, }: ResolveNeutralSourceManifestInput): readonly BaselineResolvedTokenValueManifestRecord[];
+export declare function createNeutralSourceManifestFingerprint(records: readonly BaselineResolvedTokenValueManifestRecord[]): string;
+export declare function validateNeutralSourceManifest({ source, mode, }: ResolveNeutralSourceManifestInput): BaselineResolvedTokenValueManifestValidationResult;
+export {};

package/dist/theme/generator/neutralSourceResolver.js

@@ -0,0 +1,2 @@
+// type-only module stub
+export {};

package/dist/theme/generator/neutralSourceValues.d.ts

@@ -0,0 +1,28 @@
+import { NeutralSourceId } from '../neutralSourceContract';
+export { DEFAULT_NEUTRAL_SOURCE, neutralSourceIds, } from '../neutralSourceContract';
+export type { NeutralSourceId } from '../neutralSourceContract';
+export declare const neutralStops: readonly ["50", "100", "200", "300", "400", "500", "600", "700", "800", "900", "950"];
+export type NeutralStop = (typeof neutralStops)[number];
+export declare const neutralSourceValues: Readonly<Record<NeutralSourceId, Readonly<Record<NeutralStop, string>>>>;
+export declare const blackAlphaValues: {
+    readonly '5': "rgba(0 0 0 / 0.05)";
+    readonly '10': "rgba(0 0 0 / 0.10)";
+    readonly '15': "rgba(0 0 0 / 0.15)";
+    readonly '20': "rgba(0 0 0 / 0.20)";
+    readonly '45': "rgba(0 0 0 / 0.45)";
+};
+export declare const whiteAlphaValues: {
+    readonly '5': "rgba(255 255 255 / 0.05)";
+    readonly '10': "rgba(255 255 255 / 0.10)";
+    readonly '15': "rgba(255 255 255 / 0.15)";
+    readonly '20': "rgba(255 255 255 / 0.20)";
+    readonly '40': "rgba(255 255 255 / 0.40)";
+    readonly '60': "rgba(255 255 255 / 0.60)";
+    readonly '70': "rgba(255 255 255 / 0.70)";
+    readonly '80': "rgba(255 255 255 / 0.80)";
+};
+export declare const absoluteColorValues: {
+    readonly white: "#FFFFFF";
+    readonly black: "#000000";
+    readonly transparent: "transparent";
+};

package/dist/theme/generator/neutralSourceValues.js

@@ -0,0 +1,2 @@
+// type-only module stub
+export {};

package/dist/theme/governance/semanticGovernanceContract.d.ts

@@ -0,0 +1,91 @@
+import { TokenOutputContractLifecycle } from '../contract/tokenOutputContract';
+import { TokenOutputVariableName } from './migrationMappingRegistry.js';
+export type SemanticGovernanceRole = 'background' | 'content' | 'action' | 'border' | 'control-state' | 'focus';
+export type SemanticGovernanceFamily = 'neutral-structural' | 'inverted' | 'brand' | 'informative' | 'positive' | 'warning' | 'negative' | `action-${string}`;
+export type ActionState = 'normal' | 'hover' | 'active' | 'selected';
+export interface SemanticGovernanceProvenance {
+    id: string;
+    authorityDocument: string;
+    authorityLocator: string;
+    authorityStatus: 'Accepted';
+    governanceVersion: string;
+}
+export interface SemanticGovernanceTokenFact {
+    token: TokenOutputVariableName;
+    role: SemanticGovernanceRole;
+    family?: SemanticGovernanceFamily;
+    state?: ActionState;
+    lifecycle: TokenOutputContractLifecycle;
+    provenance: readonly string[];
+}
+interface SemanticHierarchy {
+    id: string;
+    kind: 'semantic-emphasis' | 'semantic-structural';
+    tokens: readonly TokenOutputVariableName[];
+    provenance: readonly string[];
+}
+interface SemanticPair {
+    id: string;
+    kind: 'feedback-family' | 'inverted-content' | 'action-state-family';
+    families?: readonly SemanticGovernanceFamily[];
+    roles: readonly SemanticGovernanceRole[];
+    tokenReferences: readonly TokenOutputVariableName[];
+    provenance: readonly string[];
+}
+interface SemanticRoleRequirement {
+    role: SemanticGovernanceRole;
+    tokenReferences: readonly TokenOutputVariableName[];
+}
+interface UiConcept {
+    id: string;
+    purpose: string;
+    requiredRoles: readonly SemanticRoleRequirement[];
+    optionalRoles: readonly SemanticRoleRequirement[];
+    scope: string;
+    nonGoals: readonly string[];
+    provenance: readonly string[];
+}
+interface CompositionPattern {
+    id: string;
+    scope: string;
+    requiredRoles: readonly SemanticRoleRequirement[];
+    optionalRoles: readonly SemanticRoleRequirement[];
+    allowedStates: readonly ActionState[];
+    relatedUiConcepts: readonly string[];
+    owningGovernanceSource: readonly string[];
+    nonGoals: readonly string[];
+    provenance: readonly string[];
+}
+interface DeterministicAntiPattern {
+    id: string;
+    meaning: string;
+    scope: string;
+    provenance: readonly string[];
+}
+export interface SemanticGovernanceContract {
+    schemaVersion: '1.0.0';
+    semanticGovernanceArtifactVersion: '1.0.0';
+    packageCompatibility: {
+        minimumPackageVersion: '3.1.0';
+        maximumExclusivePackageVersion: '4.0.0';
+    };
+    tokenOutputContract: {
+        entryCount: number;
+        identitySetFingerprint: string;
+        referencedTokenCount: number;
+    };
+    provenance: readonly SemanticGovernanceProvenance[];
+    tokenFacts: readonly SemanticGovernanceTokenFact[];
+    hierarchies: readonly SemanticHierarchy[];
+    pairs: readonly SemanticPair[];
+    uiConcepts: readonly UiConcept[];
+    compositionPatterns: readonly CompositionPattern[];
+    antiPatterns: readonly DeterministicAntiPattern[];
+}
+export interface SemanticGovernanceContractValidationReport {
+    valid: boolean;
+    errors: readonly string[];
+}
+export declare const semanticGovernanceContract: SemanticGovernanceContract;
+export declare function validateSemanticGovernanceContract(contract?: SemanticGovernanceContract): SemanticGovernanceContractValidationReport;
+export {};

package/dist/theme/governance/semanticGovernanceContract.js

@@ -0,0 +1,342 @@
+import { getTokenOutputContractEntries } from "../contract/tokenOutputContract.js";
+//#region src/theme/governance/semanticGovernanceContract.ts
+var provenance = [
+	{
+		id: "token-output-contract",
+		authorityDocument: "src/theme/contract/tokenOutputContract.ts",
+		authorityLocator: "tokenOutputContractEntries",
+		authorityStatus: "Accepted",
+		governanceVersion: "current-token-output-contract"
+	},
+	{
+		id: "neutral-architecture-23a",
+		authorityDocument: "docs/color-system/23A-neutral-color-architecture-decision.md",
+		authorityLocator: "Sections 8-9",
+		authorityStatus: "Accepted",
+		governanceVersion: "23A"
+	},
+	{
+		id: "semantic-knowledge-decision-26",
+		authorityDocument: "docs/color-system/26-semantic-governance-knowledge-delivery-decision.md",
+		authorityLocator: "Sections 5-14",
+		authorityStatus: "Accepted",
+		governanceVersion: "26"
+	},
+	{
+		id: "semantic-knowledge-specification-27",
+		authorityDocument: "docs/color-system/27-semantic-governance-knowledge-delivery-specification.md",
+		authorityLocator: "Sections 6-14",
+		authorityStatus: "Accepted",
+		governanceVersion: "27"
+	}
+];
+var feedbackFamilies = [
+	"informative",
+	"positive",
+	"warning",
+	"negative"
+];
+var actionStates = [
+	"normal",
+	"hover",
+	"active",
+	"selected"
+];
+function asToken(value) {
+	return value;
+}
+function roleFor(entry) {
+	return entry.group === "dimension" || entry.group === "compatibility" ? null : entry.group;
+}
+function familyFor(name, role) {
+	if (role === "action") return `action-${name.replace(/^--action-/, "").replace(/-(normal|hover|active|selected)$/, "")}`;
+	if (name.includes("-neutral-")) return "neutral-structural";
+	if (name.includes("-inverted")) return "inverted";
+	if (name.includes("-brand-")) return "brand";
+	for (const family of feedbackFamilies) if (name.includes(`-${family}-`)) return family;
+}
+function stateFor(name, role) {
+	if (role !== "action") return void 0;
+	return actionStates.find((state) => name.endsWith(`-${state}`));
+}
+function fnv1a32(value) {
+	let hash = 2166136261;
+	for (const character of value) {
+		hash ^= character.charCodeAt(0);
+		hash = Math.imul(hash, 16777619) >>> 0;
+	}
+	return `fnv1a32:${hash.toString(16).padStart(8, "0")}`;
+}
+function requirement(role, tokenReferences) {
+	return {
+		role,
+		tokenReferences: tokenReferences.map(asToken)
+	};
+}
+var allOutputEntries = getTokenOutputContractEntries();
+var referencedEntries = allOutputEntries.filter((entry) => roleFor(entry) !== null);
+var tokenFacts = referencedEntries.map((entry) => {
+	const role = roleFor(entry);
+	return {
+		token: entry.name,
+		role,
+		family: familyFor(entry.name, role),
+		state: stateFor(entry.name, role),
+		lifecycle: entry.lifecycle,
+		provenance: ["token-output-contract", "semantic-knowledge-decision-26"]
+	};
+});
+var hierarchies = [{
+	id: "content-emphasis",
+	kind: "semantic-emphasis",
+	tokens: [
+		"--content-primary",
+		"--content-secondary",
+		"--content-tertiary",
+		"--content-disabled"
+	].map(asToken),
+	provenance: ["token-output-contract", "semantic-knowledge-decision-26"]
+}, {
+	id: "neutral-structural-relation",
+	kind: "semantic-structural",
+	tokens: [
+		"--background-default",
+		"--background-neutral-surface",
+		"--background-neutral-subtle",
+		"--background-neutral-on-subtle",
+		"--background-neutral-muted",
+		"--background-neutral-strong",
+		"--background-neutral-hard"
+	].map(asToken),
+	provenance: ["token-output-contract", "neutral-architecture-23a"]
+}];
+var pairs = [
+	{
+		id: "feedback-family-alignment",
+		kind: "feedback-family",
+		families: feedbackFamilies,
+		roles: [
+			"background",
+			"border",
+			"content"
+		],
+		tokenReferences: feedbackFamilies.flatMap((family) => [
+			`--background-${family}-subtle`,
+			`--border-${family}-subtle`,
+			`--content-${family}-primary`
+		]).map(asToken),
+		provenance: ["semantic-knowledge-decision-26"]
+	},
+	{
+		id: "inverted-surface-content",
+		kind: "inverted-content",
+		roles: [
+			"background",
+			"action",
+			"content"
+		],
+		tokenReferences: [
+			"--background-inverted",
+			"--action-inverted-normal",
+			"--content-inverted-primary"
+		].map(asToken),
+		provenance: ["semantic-knowledge-decision-26"]
+	},
+	{
+		id: "action-state-family-membership",
+		kind: "action-state-family",
+		families: ["action-primary"],
+		roles: ["action"],
+		tokenReferences: actionStates.map((state) => asToken(`--action-primary-${state}`)),
+		provenance: ["semantic-knowledge-decision-26"]
+	}
+];
+var uiConcepts = [
+	{
+		id: "structural-surface",
+		purpose: "A readable structural surface.",
+		requiredRoles: [requirement("background", ["--background-default"]), requirement("content", ["--content-primary"])],
+		optionalRoles: [requirement("border", ["--border-default"])],
+		scope: "Structural UI surfaces.",
+		nonGoals: ["Does not define page hierarchy."],
+		provenance: ["semantic-knowledge-decision-26"]
+	},
+	{
+		id: "neutral-structural-tier",
+		purpose: "A neutral secondary structural grouping.",
+		requiredRoles: [requirement("background", ["--background-neutral-surface", "--background-neutral-subtle"]), requirement("content", ["--content-primary"])],
+		optionalRoles: [requirement("border", ["--border-neutral-subtle"])],
+		scope: "Neutral structural grouping.",
+		nonGoals: ["Does not prescribe page-to-card hierarchy."],
+		provenance: ["neutral-architecture-23a", "semantic-knowledge-decision-26"]
+	},
+	{
+		id: "interactive-action-surface",
+		purpose: "An interactive action control surface.",
+		requiredRoles: [
+			requirement("action", ["--action-primary-normal"]),
+			requirement("content", ["--content-inverted-primary"]),
+			requirement("focus", ["--focus-ring"])
+		],
+		optionalRoles: [requirement("border", ["--border-default"])],
+		scope: "Interactive actions.",
+		nonGoals: ["Does not define Menu or Dialog behavior."],
+		provenance: ["semantic-knowledge-decision-26"]
+	},
+	{
+		id: "field-control-surface",
+		purpose: "An editable field control surface.",
+		requiredRoles: [
+			requirement("background", ["--background-default"]),
+			requirement("border", ["--border-neutral-subtle"]),
+			requirement("content", ["--content-primary"]),
+			requirement("focus", ["--focus-ring"])
+		],
+		optionalRoles: [requirement("action", ["--action-ghost-hover"])],
+		scope: "Field controls.",
+		nonGoals: ["Does not define Select interaction."],
+		provenance: ["semantic-knowledge-decision-26"]
+	},
+	{
+		id: "floating-command-surface",
+		purpose: "A temporary floating command surface.",
+		requiredRoles: [
+			requirement("background", ["--background-default"]),
+			requirement("border", ["--border-default-alpha"]),
+			requirement("content", ["--content-primary"]),
+			requirement("action", ["--action-ghost-hover"]),
+			requirement("focus", ["--focus-ring"])
+		],
+		optionalRoles: [],
+		scope: "Floating command surfaces.",
+		nonGoals: ["Does not define Menu keyboard behavior."],
+		provenance: ["semantic-knowledge-decision-26"]
+	},
+	{
+		id: "feedback-surface",
+		purpose: "A same-family feedback surface.",
+		requiredRoles: [
+			requirement("background", ["--background-informative-subtle"]),
+			requirement("border", ["--border-informative-subtle"]),
+			requirement("content", ["--content-informative-primary"])
+		],
+		optionalRoles: [],
+		scope: "Feedback callouts.",
+		nonGoals: ["Does not select feedback purpose from context."],
+		provenance: ["semantic-knowledge-decision-26"]
+	},
+	{
+		id: "inverted-surface",
+		purpose: "A local inverted semantic context.",
+		requiredRoles: [requirement("background", ["--background-inverted"]), requirement("content", ["--content-inverted-primary"])],
+		optionalRoles: [requirement("action", ["--action-inverted-normal"])],
+		scope: "Inverted local surfaces.",
+		nonGoals: ["Does not imply dark theme."],
+		provenance: ["semantic-knowledge-decision-26"]
+	}
+];
+var compositionPatterns = [
+	{
+		id: "action-control",
+		scope: "A stable action control composition.",
+		requiredRoles: uiConcepts[2].requiredRoles,
+		optionalRoles: uiConcepts[2].optionalRoles,
+		allowedStates: actionStates,
+		relatedUiConcepts: ["interactive-action-surface"],
+		owningGovernanceSource: ["semantic-knowledge-decision-26"],
+		nonGoals: ["Does not define component interaction."],
+		provenance: ["semantic-knowledge-decision-26"]
+	},
+	{
+		id: "field-control",
+		scope: "A stable field control composition.",
+		requiredRoles: uiConcepts[3].requiredRoles,
+		optionalRoles: uiConcepts[3].optionalRoles,
+		allowedStates: [],
+		relatedUiConcepts: ["field-control-surface"],
+		owningGovernanceSource: ["semantic-knowledge-decision-26"],
+		nonGoals: ["Does not define complex Select behavior."],
+		provenance: ["semantic-knowledge-decision-26"]
+	},
+	{
+		id: "floating-command-collection",
+		scope: "A floating command collection composition.",
+		requiredRoles: uiConcepts[4].requiredRoles,
+		optionalRoles: uiConcepts[4].optionalRoles,
+		allowedStates: [
+			"hover",
+			"active",
+			"selected"
+		],
+		relatedUiConcepts: ["floating-command-surface"],
+		owningGovernanceSource: ["semantic-knowledge-decision-26"],
+		nonGoals: ["Does not define Menu behavior."],
+		provenance: ["semantic-knowledge-decision-26"]
+	},
+	{
+		id: "feedback-callout",
+		scope: "A same-family feedback callout composition.",
+		requiredRoles: uiConcepts[5].requiredRoles,
+		optionalRoles: uiConcepts[5].optionalRoles,
+		allowedStates: [],
+		relatedUiConcepts: ["feedback-surface"],
+		owningGovernanceSource: ["semantic-knowledge-decision-26"],
+		nonGoals: ["Does not select feedback intent."],
+		provenance: ["semantic-knowledge-decision-26"]
+	}
+];
+var semanticGovernanceContract = {
+	schemaVersion: "1.0.0",
+	semanticGovernanceArtifactVersion: "1.0.0",
+	packageCompatibility: {
+		minimumPackageVersion: "3.1.0",
+		maximumExclusivePackageVersion: "4.0.0"
+	},
+	tokenOutputContract: {
+		entryCount: allOutputEntries.length,
+		identitySetFingerprint: fnv1a32(referencedEntries.map((entry) => `${entry.name}:${entry.lifecycle}`).sort().join("\n")),
+		referencedTokenCount: referencedEntries.length
+	},
+	provenance,
+	tokenFacts,
+	hierarchies,
+	pairs,
+	uiConcepts,
+	compositionPatterns,
+	antiPatterns: [
+		{
+			id: "primitive-bypass",
+			meaning: "Consumer UI bypasses semantic ownership.",
+			scope: "Consumer color use.",
+			provenance: ["semantic-knowledge-decision-26"]
+		},
+		{
+			id: "wrong-domain",
+			meaning: "A semantic role is used outside its domain.",
+			scope: "Consumer color use.",
+			provenance: ["semantic-knowledge-decision-26"]
+		},
+		{
+			id: "wrong-feedback-family",
+			meaning: "Feedback roles mix published families.",
+			scope: "Feedback composition.",
+			provenance: ["semantic-knowledge-decision-26"]
+		},
+		{
+			id: "source-aware-consumer",
+			meaning: "Consumer branches on source identity.",
+			scope: "Consumer runtime boundary.",
+			provenance: ["neutral-architecture-23a", "semantic-knowledge-decision-26"]
+		},
+		{
+			id: "invalid-lifecycle",
+			meaning: "Consumer uses an unavailable output lifecycle.",
+			scope: "Consumer token use.",
+			provenance: ["token-output-contract", "semantic-knowledge-decision-26"]
+		}
+	]
+};
+//#endregion
+export { semanticGovernanceContract };
+
+//# sourceMappingURL=semanticGovernanceContract.js.map