@usefragments/core 1.5.0 → 1.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/dist/{chunk-HXGE3O2F.js → chunk-BAHCOAVG.js} +133 -7
  2. package/dist/chunk-BAHCOAVG.js.map +1 -0
  3. package/dist/{chunk-57QDBEHQ.js → chunk-ZHS52OT4.js} +3 -9
  4. package/dist/chunk-ZHS52OT4.js.map +1 -0
  5. package/dist/codes/index.d.ts +2 -2
  6. package/dist/codes/index.js +2 -2
  7. package/dist/compiled-types/index.d.ts +1 -1
  8. package/dist/generate/index.d.ts +1 -1
  9. package/dist/{governance-BLsyk56o.d.ts → governance-pKrfh517.d.ts} +264 -4
  10. package/dist/{index-h_yWj15D.d.ts → index-DbkPE46t.d.ts} +40 -0
  11. package/dist/index.d.ts +472 -28
  12. package/dist/index.js +561 -39
  13. package/dist/index.js.map +1 -1
  14. package/dist/react-types.d.ts +1 -1
  15. package/dist/schemas/index.d.ts +1 -1
  16. package/dist/schemas/index.js +1 -1
  17. package/dist/test-utils.d.ts +1 -1
  18. package/package.json +1 -1
  19. package/src/agent-format.test.ts +1 -0
  20. package/src/canonical-bridge.ts +46 -0
  21. package/src/canonical-direction.ts +118 -0
  22. package/src/codes/__tests__/codes.test.ts +1 -1
  23. package/src/codes/codes.ts +29 -0
  24. package/src/config.ts +20 -0
  25. package/src/contract/preimage.test.ts +40 -0
  26. package/src/contract/preimage.ts +20 -0
  27. package/src/effective-governance-inputs.test.ts +52 -0
  28. package/src/effective-governance-inputs.ts +106 -0
  29. package/src/facts/builders.ts +25 -1
  30. package/src/facts/compile.ts +20 -2
  31. package/src/facts/fact-index.ts +12 -1
  32. package/src/facts/facts.test.ts +14 -18
  33. package/src/facts/types.ts +25 -6
  34. package/src/governance-integrity.test.ts +127 -0
  35. package/src/governance-integrity.ts +326 -4
  36. package/src/governance.test.ts +87 -1
  37. package/src/governance.ts +121 -0
  38. package/src/index.ts +34 -5
  39. package/src/rules/__tests__/fix-emission-invariant.test.ts +35 -4
  40. package/src/rules/components-prefer-library.test.ts +103 -0
  41. package/src/rules/components-prefer-library.ts +30 -4
  42. package/src/rules/fix-availability.ts +1 -0
  43. package/src/rules/index.ts +7 -0
  44. package/src/rules/jsx-preferred-import-path.ts +45 -9
  45. package/src/rules/rules.test.ts +202 -6
  46. package/src/rules/spacing-resolution.ts +2 -2
  47. package/src/rules/styles-no-raw-color.test.ts +6 -1
  48. package/src/rules/styles-no-raw-color.ts +3 -2
  49. package/src/rules/styles-no-raw-dimensions.ts +5 -7
  50. package/src/rules/styles-no-raw-spacing.test.ts +48 -0
  51. package/src/rules/styles-no-raw-spacing.ts +10 -7
  52. package/src/rules/styles-no-raw-typography.ts +7 -4
  53. package/src/rules/taxonomy.test.ts +3 -0
  54. package/src/rules/tiers.ts +2 -0
  55. package/src/rules/token-candidates.ts +36 -0
  56. package/src/rules/tokens-require-dual-fallback.ts +2 -1
  57. package/src/rules/tokens-upstream-drift.test.ts +111 -0
  58. package/src/rules/tokens-upstream-drift.ts +57 -0
  59. package/src/rules/utils.ts +22 -14
  60. package/src/schema.ts +13 -0
  61. package/src/schemas/index.ts +5 -8
  62. package/src/token-types.ts +71 -1
  63. package/src/types.ts +27 -3
  64. package/dist/chunk-57QDBEHQ.js.map +0 -1
  65. package/dist/chunk-HXGE3O2F.js.map +0 -1
package/dist/index.d.ts CHANGED
@@ -1,10 +1,10 @@
1
- import { F as Finding, A as AgentFormat, E as EvidenceGrade, a as FindingFix } from './index-h_yWj15D.js';
2
- export { b as AGENT_FORMAT_SCHEMA_VERSION, c as AgentErrorEnvelope, d as AgentOutput, G as CanonicalGovernanceVerdict, e as EVIDENCE_ORDER, f as FindingReplaceClassTokenFix, g as FindingReplaceComponentFix, h as FindingReplaceImportFix, i as FindingReplacePropValueFix, j as FindingReplaceStyleValueFix, k as Fix, l as GovernanceVerdictMetadata, I as InspectClaim, m as InspectClaimTier, S as SuppressionDirective, V as ValidatorResult, n as Violation, o as agentErrorEnvelopeSchema, p as agentFormatSchema, q as agentIntegritySchema, r as agentOutputSchema, s as canBlock, t as factEvidenceSchema, u as factLocationSchema, v as findingFixSchema, w as findingReplaceClassTokenFixSchema, x as findingReplaceComponentFixSchema, y as findingReplaceImportFixSchema, z as findingReplacePropValueFixSchema, B as findingReplaceStyleValueFixSchema, C as findingSchema, D as fixSchema, H as governanceVerdictMetadataSchema, J as governanceVerdictSchema, K as normalizeFinding, L as normalizeSeverity, M as normalizeViolation, N as suppressionDirectiveSchema, O as validatorResultSchema, P as violationSchema } from './index-h_yWj15D.js';
1
+ import { F as Finding, A as AgentFormat, E as EvidenceGrade, a as FindingFix } from './index-DbkPE46t.js';
2
+ export { b as AGENT_FORMAT_SCHEMA_VERSION, c as AgentErrorEnvelope, d as AgentOutput, G as CanonicalGovernanceVerdict, e as EVIDENCE_ORDER, f as FindingReplaceClassTokenFix, g as FindingReplaceComponentFix, h as FindingReplaceImportFix, i as FindingReplacePropValueFix, j as FindingReplaceStyleValueFix, k as Fix, l as GovernanceVerdictMetadata, I as InspectClaim, m as InspectClaimTier, S as SuppressionDirective, V as ValidatorResult, n as Violation, o as agentErrorEnvelopeSchema, p as agentFormatSchema, q as agentIntegritySchema, r as agentOutputSchema, s as canBlock, t as factEvidenceSchema, u as factLocationSchema, v as findingFixSchema, w as findingReplaceClassTokenFixSchema, x as findingReplaceComponentFixSchema, y as findingReplaceImportFixSchema, z as findingReplacePropValueFixSchema, B as findingReplaceStyleValueFixSchema, C as findingSchema, D as fixSchema, H as governanceVerdictMetadataSchema, J as governanceVerdictSchema, K as normalizeFinding, L as normalizeSeverity, M as normalizeViolation, N as suppressionDirectiveSchema, O as validatorResultSchema, P as violationSchema } from './index-DbkPE46t.js';
3
3
  import { Severity } from './severity.js';
4
4
  export { SEVERITIES, SEVERITY_RANK, SEVERITY_WEIGHTS, SeverityLevel, compareSeverity, maxSeverity, severityLevel, severitySchema, sortBySeverity } from './severity.js';
5
5
  export { BridgeViolationInput, CODES, CodeCategory, CodeLifecycle, EXPLAIN_URL_BASE, FuiCode, bridgeSourceViolation, bridgeSourceViolations, byCode, byRuleId, explainUrlForCode } from './codes/index.js';
6
- import { c as ContractDomain, d as ContractCatalogInput, G as GovernanceSeverity, b as CompiledFragment, e as GovernedFragmentDefinition, R as ResolvedGovernedFragmentDefinition, f as GovernanceConfig, g as FragmentsConfig, T as TokenConfig, h as FragmentComponent, B as BlockDefinition, C as CompiledBlock, F as FragmentDefinition, a as FragmentDefinitionV2, S as StorybookFilterConfig, i as FigmaStringMapping, j as FigmaBooleanMapping, k as FigmaEnumMapping, l as FigmaInstanceMapping, m as FigmaChildrenMapping, n as FigmaTextContentMapping, o as RelationshipType, V as VariantRenderOptions, p as VariantLoader, q as CanonicalSource } from './governance-BLsyk56o.js';
7
- export { A as AIMetadata, r as AccessibilityGovernanceBuilder, s as AppConfig, t as BaselineInfo, u as BoundingBox, v as CONTRACT_DOMAINS, w as CONTRACT_PREIMAGE_CAPABILITY_HEADER, x as CONTRACT_PREIMAGE_SCHEMA, y as CanonicalMappingStatus, z as CompiledFragmentsFile, D as CompiledRecipe, E as CompiledTokenData, H as CompiledTokenEntry, I as ComponentGovernanceBuilder, J as ComponentGovernanceRecord, K as ComponentRef, L as ComponentRelation, M as CompositionMetadata, N as ContractCanonicalMappingInput, O as ContractComponentInput, P as ContractIdentityPin, Q as ContractPolicyInput, U as ContractPreimage, W as ContractPropMappingInput, X as ContractTokenInput, Y as ContractWaiverInput, Z as ControlType, _ as DesignSystemConfig, $ as DiffResult, a0 as FigmaPropMapping, a1 as FragmentContract, a2 as FragmentExample, a3 as FragmentGenerated, a4 as FragmentGuidance, a5 as FragmentMeta, a6 as FragmentProvenance, a7 as FragmentUsage, a8 as FragmentVariant, a9 as GlobalGovernanceRecord, aa as GlobalJsxGovernanceRecord, ab as GlobalStyleGovernanceRecord, ac as GovernancePropValue, ad as InspectConfig, ae as LocalCanonicalDeclaration, af as LocalCanonicalResolveRule, ag as Manifest, ah as ObservedComponentUsage, ai as ObservedUsageProp, aj as PlayFunction, ak as PlayFunctionContext, al as PropDefinition, am as PropGovernanceBuilder, an as PropGovernanceOptions, ao as PropKey, ap as PropType, aq as RecipeDefinition, ar as RegistryOptions, as as RepoRelativePath, at as ScaleGovernanceRecord, au as Screenshot, av as ScreenshotConfig, aw as ScreenshotMetadata, ax as ServiceConfig, ay as SnapshotConfig, az as SnippetPolicyConfig, aA as Theme, aB as ThemeSeeds, aC as TokenSourceConfig, aD as TokenSourceFormat, aE as VerifyRequest, aF as VerifyResult, aG as Viewport, aH as componentGovernanceRecordSchema, aI as componentGovernanceRecordsSchema, aJ as contractComponentsFromFragments, aK as contractPolicyFromGovernanceConfig, aL as diffContractDomains, aM as g, aN as globalGovernanceRecordSchema, aO as globalJsxGovernanceRecordSchema, aP as globalStyleGovernanceRecordSchema, aQ as governanceConfigSchema, aR as governanceConfigWithLocalCanonical, aS as governanceSeveritySchema, aT as localCanonicalContractMappings, aU as normalizeGovernanceConfig, aV as projectContractPreimage, aW as scaleGovernanceRecordSchema, aX as verifiedContractPreimageFromPin } from './governance-BLsyk56o.js';
6
+ import { c as ContractDomain, d as ContractCatalogInput, G as GovernanceSeverity, b as CompiledFragment, e as GovernedFragmentDefinition, R as ResolvedGovernedFragmentDefinition, f as GovernanceConfig, g as FragmentsConfig, T as TokenConfig, h as FragmentComponent, B as BlockDefinition, C as CompiledBlock, F as FragmentDefinition, a as FragmentDefinitionV2, S as StorybookFilterConfig, i as FigmaStringMapping, j as FigmaBooleanMapping, k as FigmaEnumMapping, l as FigmaInstanceMapping, m as FigmaChildrenMapping, n as FigmaTextContentMapping, o as RelationshipType, V as VariantRenderOptions, p as VariantLoader, q as CanonicalSource, r as CanonicalBridgeV1, s as ContractCanonicalMappingInput } from './governance-pKrfh517.js';
7
+ export { A as AIMetadata, t as AccessibilityGovernanceBuilder, u as AppConfig, v as BaselineInfo, w as BoundingBox, x as CONTRACT_DOMAINS, y as CONTRACT_PREIMAGE_CAPABILITY_HEADER, z as CONTRACT_PREIMAGE_SCHEMA, D as CanonicalMappingStatus, E as CompiledFragmentsFile, H as CompiledRecipe, I as CompiledTokenData, J as CompiledTokenEntry, K as ComponentGovernanceBuilder, L as ComponentGovernanceRecord, M as ComponentRef, N as ComponentRelation, O as CompositionMetadata, P as ContractComponentInput, Q as ContractIdentityPin, U as ContractPolicyInput, W as ContractPreimage, X as ContractPropMappingInput, Y as ContractTokenInput, Z as ContractWaiverInput, _ as ControlType, $ as DesignSystemConfig, a0 as DiffResult, a1 as FigmaPropMapping, a2 as FragmentContract, a3 as FragmentExample, a4 as FragmentGenerated, a5 as FragmentGuidance, a6 as FragmentMeta, a7 as FragmentProvenance, a8 as FragmentUsage, a9 as FragmentVariant, aa as GlobalGovernanceRecord, ab as GlobalJsxGovernanceRecord, ac as GlobalStyleGovernanceRecord, ad as GovernancePropValue, ae as InspectConfig, af as LocalCanonicalDeclaration, ag as LocalCanonicalResolveRule, ah as Manifest, ai as ObservedComponentUsage, aj as ObservedUsageProp, ak as PlayFunction, al as PlayFunctionContext, am as PropDefinition, an as PropGovernanceBuilder, ao as PropGovernanceOptions, ap as PropKey, aq as PropType, ar as RecipeDefinition, as as RegistryOptions, at as RepoRelativePath, au as ScaleGovernanceRecord, av as Screenshot, aw as ScreenshotConfig, ax as ScreenshotMetadata, ay as ServiceConfig, az as SnapshotConfig, aA as SnippetPolicyConfig, aB as Theme, aC as ThemeSeeds, aD as TokenSourceConfig, aE as TokenSourceFormat, aF as VerifyRequest, aG as VerifyResult, aH as Viewport, aI as canonicalBridgeV1Schema, aJ as componentGovernanceRecordSchema, aK as componentGovernanceRecordsSchema, aL as contractComponentsFromFragments, aM as contractPolicyFromGovernanceConfig, aN as diffContractDomains, aO as g, aP as globalGovernanceRecordSchema, aQ as globalJsxGovernanceRecordSchema, aR as globalStyleGovernanceRecordSchema, aS as governanceConfigSchema, aT as governanceConfigWithLocalCanonical, aU as governanceSeveritySchema, aV as localCanonicalContractMappings, aW as normalizeGovernanceConfig, aX as projectContractPreimage, aY as scaleGovernanceRecordSchema, aZ as verifiedContractPreimageFromPin } from './governance-pKrfh517.js';
8
8
  import { z } from 'zod';
9
9
  import { RegistryArtifact, RegistryDependency, RegistryInstallReceipt } from './registry.js';
10
10
  export { REGISTRY_ARTIFACT_SCHEMA_VERSION, REGISTRY_INSTALL_RECEIPT_SCHEMA_VERSION, REGISTRY_MANIFEST_SCHEMA_VERSION, RegistryArtifactInput, RegistryComponent, RegistryComponentExport, RegistryDependencyType, RegistryEntrypoint, RegistryFile, RegistryFileContent, RegistryFileInput, RegistryFileRole, RegistryInstallProfile, RegistryInstallReceiptComponent, RegistryInstallReceiptFile, RegistryManifest, RegistryManifestDraft, RegistrySource, assertValidRegistryArtifact, buildRegistryArtifact, buildRegistryFile, computeRegistryHash, finalizeRegistryManifest, hashRegistryFileContent, registryArtifactDigest, registryArtifactSchema, registryComponentExportSchema, registryComponentSchema, registryDependencySchema, registryDependencyTypeSchema, registryEntrypointSchema, registryFileContentSchema, registryFileRoleSchema, registryFileSchema, registryFileSize, registryInstallProfileSchema, registryInstallReceiptComponentSchema, registryInstallReceiptFileSchema, registryInstallReceiptSchema, registryManifestCanonicalPreimage, registryManifestDraftSchema, registryManifestSchema, registrySourceSchema } from './registry.js';
@@ -859,6 +859,14 @@ interface JsxImportPathPreferredFact extends BaseFact {
859
859
  imported?: string;
860
860
  because?: string;
861
861
  severity: GovernanceSeverity;
862
+ /** Present when the policy was compiled from a confirmed local-canonical bridge. */
863
+ bridge?: {
864
+ componentKey: string;
865
+ localExportName: string;
866
+ underlyingExportName: string;
867
+ implementationFiles: string[];
868
+ decisionSource: "authored" | "migration";
869
+ };
862
870
  }
863
871
  interface JsxComponentPreferredFact extends BaseFact {
864
872
  kind: "jsx_component_preferred";
@@ -870,7 +878,9 @@ interface JsxComponentPreferredFact extends BaseFact {
870
878
  /**
871
879
  * A design token from the system. Used by fixes (e.g., raw color → token
872
880
  * substitution) and rules that need to know the token vocabulary. Identity is
873
- * the token `name`; two scans of the same token registry produce the same ID.
881
+ * the token `name` for legacy/local facts. Authority-aware facts also include
882
+ * role and source identity so same-name local/upstream definitions cannot
883
+ * silently collapse in the fact index.
874
884
  */
875
885
  interface TokenDefinitionFact extends BaseFact {
876
886
  kind: "token_definition";
@@ -885,14 +895,21 @@ interface TokenDefinitionFact extends BaseFact {
885
895
  * How the token is referenced from authored styles, inferred from its source.
886
896
  * Governs whether a "use the token" fix can be *applied* automatically: a
887
897
  * `css-var`/`scss-var` reference resolves verbatim, but a `scss-map` member
888
- * (`$colors-primary` minted from a Sass map) or a `dtcg` JSON token (no CSS
889
- * custom property emitted) does not those are surfaced as suggestions, not
890
- * deterministic rewrites, so the fixer never writes non-compiling output.
891
- * Absent on legacy/hand-built facts, which are treated as safe.
898
+ * (`$colors-primary` minted from a Sass map), a `dtcg` JSON token (no CSS
899
+ * custom property emitted), or a `js-member` path (`colors.primary`) does not
900
+ * — those are surfaced as suggestions, not deterministic rewrites, so the
901
+ * fixer never writes invented syntax. Absent on legacy/hand-built facts,
902
+ * which fail closed because an unknown authored form is not applicability
903
+ * proof.
892
904
  */
893
- referenceFormat?: "css-var" | "scss-var" | "scss-map" | "dtcg";
905
+ referenceFormat?: "css-var" | "scss-var" | "scss-map" | "dtcg" | "js-member";
894
906
  /** Original authored spellings retained before parser normalization. */
895
907
  sourceNames?: string[];
908
+ role?: "local" | "upstream";
909
+ authority?: "authored" | "declared-package";
910
+ sourceIdentity?: string;
911
+ /** Authored upstream identity when the local and upstream names differ. */
912
+ upstreamName?: string;
896
913
  }
897
914
  interface TailwindPaletteAllowFact extends BaseFact {
898
915
  kind: "tailwind_palette_allow";
@@ -1193,6 +1210,8 @@ interface ComponentDefinitionFact extends BaseFact {
1193
1210
  componentId: ComponentId;
1194
1211
  file: string;
1195
1212
  exportName: string;
1213
+ /** Whether this definition is reachable through an authored ESM export. */
1214
+ exported: boolean;
1196
1215
  componentKey: string;
1197
1216
  renderRoot: ComponentDefinitionRenderRoot;
1198
1217
  propSurface: string[];
@@ -1269,6 +1288,7 @@ declare function makeComponentCapabilityFact(input: {
1269
1288
  declare function makeComponentDefinitionFact(input: {
1270
1289
  file: string;
1271
1290
  exportName: string;
1291
+ exported?: boolean;
1272
1292
  componentKey: string;
1273
1293
  renderRoot: ComponentDefinitionFact["renderRoot"];
1274
1294
  propSurface: string[];
@@ -1389,6 +1409,7 @@ declare function makeJsxImportPathPreferredFact(input: {
1389
1409
  imported?: string;
1390
1410
  because?: string;
1391
1411
  severity: GovernanceSeverity;
1412
+ bridge?: JsxImportPathPreferredFact["bridge"];
1392
1413
  }): JsxImportPathPreferredFact;
1393
1414
  declare function makeJsxComponentPreferredFact(input: {
1394
1415
  from: ComponentId;
@@ -1403,6 +1424,10 @@ declare function makeTokenDefinitionFact(input: {
1403
1424
  category?: TokenDefinitionFact["category"];
1404
1425
  referenceFormat?: TokenDefinitionFact["referenceFormat"];
1405
1426
  sourceNames?: TokenDefinitionFact["sourceNames"];
1427
+ role?: TokenDefinitionFact["role"];
1428
+ authority?: TokenDefinitionFact["authority"];
1429
+ sourceIdentity?: TokenDefinitionFact["sourceIdentity"];
1430
+ upstreamName?: TokenDefinitionFact["upstreamName"];
1406
1431
  }): TokenDefinitionFact;
1407
1432
  declare function makeTailwindPaletteAllowFact(input: {
1408
1433
  patterns: string[];
@@ -1531,6 +1556,10 @@ interface FactEvidence {
1531
1556
  factId: FactId;
1532
1557
  fact: Fact;
1533
1558
  }
1559
+ interface FactIndexOptions {
1560
+ /** Optional internal diagnostic route. Product output is quiet by default. */
1561
+ onConflict?: (message: string) => void;
1562
+ }
1534
1563
  /**
1535
1564
  * Match a literal path against a simple glob pattern. `*` matches any run of
1536
1565
  * non-separator characters; `**` matches any run of characters including
@@ -1538,10 +1567,12 @@ interface FactEvidence {
1538
1567
  */
1539
1568
  declare function matchesGlob(path: string, pattern: string): boolean;
1540
1569
  declare class FactIndex {
1570
+ private readonly options;
1541
1571
  private readonly facts;
1542
1572
  private readonly idsByKind;
1543
1573
  private readonly idsByComponent;
1544
1574
  private readonly tokenBySymbol;
1575
+ constructor(options?: FactIndexOptions);
1545
1576
  add(fact: Fact): void;
1546
1577
  addMany(facts: Iterable<Fact>): void;
1547
1578
  get(id: FactId): Fact | undefined;
@@ -1730,6 +1761,52 @@ declare function budgetBar(percent: number, width?: number): string;
1730
1761
  * Token categories for grouping and filtering
1731
1762
  */
1732
1763
  type TokenCategory = "color" | "spacing" | "typography" | "radius" | "shadow" | "sizing" | "border" | "animation" | "z-index" | "other";
1764
+ /** Stable, renderer-independent token catalog contract. */
1765
+ interface TokenCatalog {
1766
+ schemaVersion: "token-catalog:v1";
1767
+ configuredSources: string[];
1768
+ parsedSources: string[];
1769
+ definitions: TokenCatalogDefinition[];
1770
+ diagnostics: TokenCatalogDiagnostic[];
1771
+ references: TokenCatalogReference[];
1772
+ sourceStates?: TokenCatalogSourceState[];
1773
+ }
1774
+ interface TokenCatalogSourceState {
1775
+ source: string;
1776
+ role: "local" | "upstream";
1777
+ state: "verified" | "version_mismatch" | "digest_mismatch" | "source_unavailable" | "cache_unverified";
1778
+ installedVersion?: string;
1779
+ contentDigest?: string;
1780
+ expectedVersion?: string;
1781
+ expectedDigest?: string;
1782
+ }
1783
+ interface TokenCatalogLocation {
1784
+ file: string;
1785
+ line: number;
1786
+ column: number;
1787
+ }
1788
+ interface TokenCatalogDefinition {
1789
+ /** Authored member path, for example `spacing.smaller` or `theme.palette.primary.main`. */
1790
+ name: string;
1791
+ value: string;
1792
+ category: TokenCategory;
1793
+ location: TokenCatalogLocation;
1794
+ exportName?: string;
1795
+ referenceSyntax: "css-var" | "scss-var" | "scss-map" | "dtcg" | "js-member";
1796
+ authority: "authored" | "declared-package";
1797
+ role: "local" | "upstream";
1798
+ }
1799
+ interface TokenCatalogDiagnostic {
1800
+ code: "tokens/unsupported-static-value" | "tokens/source-unavailable";
1801
+ severity: "warning";
1802
+ message: string;
1803
+ location: TokenCatalogLocation;
1804
+ }
1805
+ interface TokenCatalogReference {
1806
+ name: string;
1807
+ location: TokenCatalogLocation;
1808
+ syntax: "css-var" | "scss-var" | "scss-map" | "dtcg" | "js-member";
1809
+ }
1733
1810
  /**
1734
1811
  * A single design token (CSS custom property)
1735
1812
  */
@@ -1758,7 +1835,7 @@ interface DesignToken {
1758
1835
  /** Source file where this token was defined */
1759
1836
  sourceFile: string;
1760
1837
  /** Authored reference form, when the parser can prove it from the source. */
1761
- referenceFormat?: "css-var" | "scss-var" | "scss-map" | "dtcg";
1838
+ referenceFormat?: "css-var" | "scss-var" | "scss-map" | "dtcg" | "js-member";
1762
1839
  /** Authored spellings preserved before normalization (for example `$x` and `--x`). */
1763
1840
  sourceNames?: string[];
1764
1841
  /** Line number in source file */
@@ -1857,6 +1934,8 @@ interface TokenParseResult {
1857
1934
  warnings: string[];
1858
1935
  /** Parse time in ms */
1859
1936
  parseTimeMs: number;
1937
+ /** The shared catalog used to produce `tokens`. Additive for compatibility. */
1938
+ catalog?: TokenCatalog;
1860
1939
  }
1861
1940
  /**
1862
1941
  * Error during token parsing
@@ -2417,8 +2496,8 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2417
2496
  componentId: string;
2418
2497
  name: string;
2419
2498
  }[];
2420
- tier: "core" | "composition";
2421
2499
  source: "design-system";
2500
+ tier: "core" | "composition";
2422
2501
  publicSlug: string | null;
2423
2502
  relations: Record<string, unknown>[];
2424
2503
  publicId: string | null;
@@ -2443,8 +2522,8 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2443
2522
  componentId: string;
2444
2523
  name: string;
2445
2524
  }[];
2446
- tier: "core" | "composition";
2447
2525
  source: "design-system";
2526
+ tier: "core" | "composition";
2448
2527
  publicSlug: string | null;
2449
2528
  relations: Record<string, unknown>[];
2450
2529
  publicId: string | null;
@@ -2474,8 +2553,8 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2474
2553
  componentId: string;
2475
2554
  name: string;
2476
2555
  }[];
2477
- tier: "core" | "composition";
2478
2556
  source: "design-system";
2557
+ tier: "core" | "composition";
2479
2558
  publicSlug: string | null;
2480
2559
  relations: Record<string, unknown>[];
2481
2560
  publicId: string | null;
@@ -2507,8 +2586,8 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2507
2586
  componentId: string;
2508
2587
  name: string;
2509
2588
  }[];
2510
- tier: "core" | "composition";
2511
2589
  source: "design-system";
2590
+ tier: "core" | "composition";
2512
2591
  publicSlug: string | null;
2513
2592
  relations: Record<string, unknown>[];
2514
2593
  publicId: string | null;
@@ -3056,9 +3135,9 @@ declare const mcpComponentSchema: z.ZodObject<{
3056
3135
  importPath?: string | undefined;
3057
3136
  publicRef?: string | undefined;
3058
3137
  sourcePath?: string | undefined;
3138
+ packageName?: string | undefined;
3059
3139
  tier?: string | undefined;
3060
3140
  publicSlug?: string | null | undefined;
3061
- packageName?: string | undefined;
3062
3141
  isCanonical?: boolean | undefined;
3063
3142
  sourceRepoFullName?: string | undefined;
3064
3143
  parentComponentName?: string | undefined;
@@ -3106,6 +3185,7 @@ declare const mcpComponentSchema: z.ZodObject<{
3106
3185
  accepts?: string[] | undefined;
3107
3186
  visibility?: "public" | "internal" | undefined;
3108
3187
  }[] | undefined;
3188
+ packageName?: string | undefined;
3109
3189
  tier?: string | undefined;
3110
3190
  publicSlug?: string | null | undefined;
3111
3191
  relations?: {
@@ -3115,7 +3195,6 @@ declare const mcpComponentSchema: z.ZodObject<{
3115
3195
  componentId?: string | undefined;
3116
3196
  note?: string | undefined;
3117
3197
  }[] | undefined;
3118
- packageName?: string | undefined;
3119
3198
  isCanonical?: boolean | undefined;
3120
3199
  examples?: {
3121
3200
  name: string;
@@ -3283,14 +3362,14 @@ declare const mcpSnapshotMetadataSchema: z.ZodObject<{
3283
3362
  updatedAt: z.ZodOptional<z.ZodString>;
3284
3363
  }, "strip", z.ZodTypeAny, {
3285
3364
  importPath?: string | undefined;
3286
- updatedAt?: string | undefined;
3287
3365
  packageName?: string | undefined;
3366
+ updatedAt?: string | undefined;
3288
3367
  designSystemName?: string | undefined;
3289
3368
  revision?: string | undefined;
3290
3369
  }, {
3291
3370
  importPath?: string | undefined;
3292
- updatedAt?: string | undefined;
3293
3371
  packageName?: string | undefined;
3372
+ updatedAt?: string | undefined;
3294
3373
  designSystemName?: string | undefined;
3295
3374
  revision?: string | undefined;
3296
3375
  }>;
@@ -3307,14 +3386,14 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3307
3386
  updatedAt: z.ZodOptional<z.ZodString>;
3308
3387
  }, "strip", z.ZodTypeAny, {
3309
3388
  importPath?: string | undefined;
3310
- updatedAt?: string | undefined;
3311
3389
  packageName?: string | undefined;
3390
+ updatedAt?: string | undefined;
3312
3391
  designSystemName?: string | undefined;
3313
3392
  revision?: string | undefined;
3314
3393
  }, {
3315
3394
  importPath?: string | undefined;
3316
- updatedAt?: string | undefined;
3317
3395
  packageName?: string | undefined;
3396
+ updatedAt?: string | undefined;
3318
3397
  designSystemName?: string | undefined;
3319
3398
  revision?: string | undefined;
3320
3399
  }>>;
@@ -3585,9 +3664,9 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3585
3664
  importPath?: string | undefined;
3586
3665
  publicRef?: string | undefined;
3587
3666
  sourcePath?: string | undefined;
3667
+ packageName?: string | undefined;
3588
3668
  tier?: string | undefined;
3589
3669
  publicSlug?: string | null | undefined;
3590
- packageName?: string | undefined;
3591
3670
  isCanonical?: boolean | undefined;
3592
3671
  sourceRepoFullName?: string | undefined;
3593
3672
  parentComponentName?: string | undefined;
@@ -3635,6 +3714,7 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3635
3714
  accepts?: string[] | undefined;
3636
3715
  visibility?: "public" | "internal" | undefined;
3637
3716
  }[] | undefined;
3717
+ packageName?: string | undefined;
3638
3718
  tier?: string | undefined;
3639
3719
  publicSlug?: string | null | undefined;
3640
3720
  relations?: {
@@ -3644,7 +3724,6 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3644
3724
  componentId?: string | undefined;
3645
3725
  note?: string | undefined;
3646
3726
  }[] | undefined;
3647
- packageName?: string | undefined;
3648
3727
  isCanonical?: boolean | undefined;
3649
3728
  examples?: {
3650
3729
  name: string;
@@ -3876,9 +3955,9 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3876
3955
  importPath?: string | undefined;
3877
3956
  publicRef?: string | undefined;
3878
3957
  sourcePath?: string | undefined;
3958
+ packageName?: string | undefined;
3879
3959
  tier?: string | undefined;
3880
3960
  publicSlug?: string | null | undefined;
3881
- packageName?: string | undefined;
3882
3961
  isCanonical?: boolean | undefined;
3883
3962
  sourceRepoFullName?: string | undefined;
3884
3963
  parentComponentName?: string | undefined;
@@ -3886,8 +3965,8 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3886
3965
  }>;
3887
3966
  metadata: {
3888
3967
  importPath?: string | undefined;
3889
- updatedAt?: string | undefined;
3890
3968
  packageName?: string | undefined;
3969
+ updatedAt?: string | undefined;
3891
3970
  designSystemName?: string | undefined;
3892
3971
  revision?: string | undefined;
3893
3972
  };
@@ -3978,6 +4057,7 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3978
4057
  accepts?: string[] | undefined;
3979
4058
  visibility?: "public" | "internal" | undefined;
3980
4059
  }[] | undefined;
4060
+ packageName?: string | undefined;
3981
4061
  tier?: string | undefined;
3982
4062
  publicSlug?: string | null | undefined;
3983
4063
  relations?: {
@@ -3987,7 +4067,6 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3987
4067
  componentId?: string | undefined;
3988
4068
  note?: string | undefined;
3989
4069
  }[] | undefined;
3990
- packageName?: string | undefined;
3991
4070
  isCanonical?: boolean | undefined;
3992
4071
  examples?: {
3993
4072
  name: string;
@@ -4020,8 +4099,8 @@ declare const mcpSnapshotSchema: z.ZodObject<{
4020
4099
  capabilities: ("components" | "tokens" | "performance" | "blocks" | "graph")[];
4021
4100
  metadata?: {
4022
4101
  importPath?: string | undefined;
4023
- updatedAt?: string | undefined;
4024
4102
  packageName?: string | undefined;
4103
+ updatedAt?: string | undefined;
4025
4104
  designSystemName?: string | undefined;
4026
4105
  revision?: string | undefined;
4027
4106
  } | undefined;
@@ -5732,6 +5811,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5732
5811
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5733
5812
  }>, "many">>;
5734
5813
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5814
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5815
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
5816
+ packageName: z.ZodString;
5817
+ version: z.ZodOptional<z.ZodString>;
5818
+ digest: z.ZodOptional<z.ZodString>;
5819
+ }, "strip", z.ZodTypeAny, {
5820
+ packageName: string;
5821
+ version?: string | undefined;
5822
+ digest?: string | undefined;
5823
+ }, {
5824
+ packageName: string;
5825
+ version?: string | undefined;
5826
+ digest?: string | undefined;
5827
+ }>, "many">>;
5735
5828
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5736
5829
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5737
5830
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5750,6 +5843,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5750
5843
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5751
5844
  }>, "many">>;
5752
5845
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5846
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5847
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
5848
+ packageName: z.ZodString;
5849
+ version: z.ZodOptional<z.ZodString>;
5850
+ digest: z.ZodOptional<z.ZodString>;
5851
+ }, "strip", z.ZodTypeAny, {
5852
+ packageName: string;
5853
+ version?: string | undefined;
5854
+ digest?: string | undefined;
5855
+ }, {
5856
+ packageName: string;
5857
+ version?: string | undefined;
5858
+ digest?: string | undefined;
5859
+ }>, "many">>;
5753
5860
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5754
5861
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5755
5862
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5768,6 +5875,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5768
5875
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5769
5876
  }>, "many">>;
5770
5877
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5878
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5879
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
5880
+ packageName: z.ZodString;
5881
+ version: z.ZodOptional<z.ZodString>;
5882
+ digest: z.ZodOptional<z.ZodString>;
5883
+ }, "strip", z.ZodTypeAny, {
5884
+ packageName: string;
5885
+ version?: string | undefined;
5886
+ digest?: string | undefined;
5887
+ }, {
5888
+ packageName: string;
5889
+ version?: string | undefined;
5890
+ digest?: string | undefined;
5891
+ }>, "many">>;
5771
5892
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5772
5893
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5773
5894
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5786,6 +5907,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5786
5907
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5787
5908
  }>, "many">>;
5788
5909
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5910
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5911
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
5912
+ packageName: z.ZodString;
5913
+ version: z.ZodOptional<z.ZodString>;
5914
+ digest: z.ZodOptional<z.ZodString>;
5915
+ }, "strip", z.ZodTypeAny, {
5916
+ packageName: string;
5917
+ version?: string | undefined;
5918
+ digest?: string | undefined;
5919
+ }, {
5920
+ packageName: string;
5921
+ version?: string | undefined;
5922
+ digest?: string | undefined;
5923
+ }>, "many">>;
5789
5924
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5790
5925
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5791
5926
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5804,6 +5939,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5804
5939
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5805
5940
  }>, "many">>;
5806
5941
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5942
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5943
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
5944
+ packageName: z.ZodString;
5945
+ version: z.ZodOptional<z.ZodString>;
5946
+ digest: z.ZodOptional<z.ZodString>;
5947
+ }, "strip", z.ZodTypeAny, {
5948
+ packageName: string;
5949
+ version?: string | undefined;
5950
+ digest?: string | undefined;
5951
+ }, {
5952
+ packageName: string;
5953
+ version?: string | undefined;
5954
+ digest?: string | undefined;
5955
+ }>, "many">>;
5807
5956
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5808
5957
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5809
5958
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5998,6 +6147,104 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5998
6147
  registryHash?: string | undefined;
5999
6148
  receiptPath?: string | undefined;
6000
6149
  }>]>, "many">>;
6150
+ canonicalBridges: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
6151
+ underlying: z.ZodObject<{
6152
+ packageName: z.ZodString;
6153
+ exportName: z.ZodString;
6154
+ }, "strict", z.ZodTypeAny, {
6155
+ exportName: string;
6156
+ packageName: string;
6157
+ }, {
6158
+ exportName: string;
6159
+ packageName: string;
6160
+ }>;
6161
+ local: z.ZodObject<{
6162
+ componentKey: z.ZodString;
6163
+ moduleSpecifier: z.ZodEffects<z.ZodString, string, string>;
6164
+ exportName: z.ZodString;
6165
+ implementationFiles: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
6166
+ }, "strict", z.ZodTypeAny, {
6167
+ componentKey: string;
6168
+ exportName: string;
6169
+ moduleSpecifier: string;
6170
+ implementationFiles: string[];
6171
+ }, {
6172
+ componentKey: string;
6173
+ exportName: string;
6174
+ moduleSpecifier: string;
6175
+ implementationFiles: string[];
6176
+ }>;
6177
+ decision: z.ZodObject<{
6178
+ state: z.ZodLiteral<"confirmed">;
6179
+ source: z.ZodEnum<["authored", "migration"]>;
6180
+ }, "strict", z.ZodTypeAny, {
6181
+ state: "confirmed";
6182
+ source: "authored" | "migration";
6183
+ }, {
6184
+ state: "confirmed";
6185
+ source: "authored" | "migration";
6186
+ }>;
6187
+ }, "strict", z.ZodTypeAny, {
6188
+ underlying: {
6189
+ exportName: string;
6190
+ packageName: string;
6191
+ };
6192
+ local: {
6193
+ componentKey: string;
6194
+ exportName: string;
6195
+ moduleSpecifier: string;
6196
+ implementationFiles: string[];
6197
+ };
6198
+ decision: {
6199
+ state: "confirmed";
6200
+ source: "authored" | "migration";
6201
+ };
6202
+ }, {
6203
+ underlying: {
6204
+ exportName: string;
6205
+ packageName: string;
6206
+ };
6207
+ local: {
6208
+ componentKey: string;
6209
+ exportName: string;
6210
+ moduleSpecifier: string;
6211
+ implementationFiles: string[];
6212
+ };
6213
+ decision: {
6214
+ state: "confirmed";
6215
+ source: "authored" | "migration";
6216
+ };
6217
+ }>, "many">, {
6218
+ underlying: {
6219
+ exportName: string;
6220
+ packageName: string;
6221
+ };
6222
+ local: {
6223
+ componentKey: string;
6224
+ exportName: string;
6225
+ moduleSpecifier: string;
6226
+ implementationFiles: string[];
6227
+ };
6228
+ decision: {
6229
+ state: "confirmed";
6230
+ source: "authored" | "migration";
6231
+ };
6232
+ }[], {
6233
+ underlying: {
6234
+ exportName: string;
6235
+ packageName: string;
6236
+ };
6237
+ local: {
6238
+ componentKey: string;
6239
+ exportName: string;
6240
+ moduleSpecifier: string;
6241
+ implementationFiles: string[];
6242
+ };
6243
+ decision: {
6244
+ state: "confirmed";
6245
+ source: "authored" | "migration";
6246
+ };
6247
+ }[]>>;
6001
6248
  presets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6002
6249
  scales: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
6003
6250
  kind: z.ZodDefault<z.ZodLiteral<"scale">>;
@@ -6718,6 +6965,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6718
6965
  exclude?: string[] | undefined;
6719
6966
  registryHash?: string | undefined;
6720
6967
  })[] | undefined;
6968
+ canonicalBridges?: {
6969
+ underlying: {
6970
+ exportName: string;
6971
+ packageName: string;
6972
+ };
6973
+ local: {
6974
+ componentKey: string;
6975
+ exportName: string;
6976
+ moduleSpecifier: string;
6977
+ implementationFiles: string[];
6978
+ };
6979
+ decision: {
6980
+ state: "confirmed";
6981
+ source: "authored" | "migration";
6982
+ };
6983
+ }[] | undefined;
6721
6984
  presets?: string[] | undefined;
6722
6985
  agent?: z.objectOutputType<{
6723
6986
  repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -6892,6 +7155,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6892
7155
  registryHash?: string | undefined;
6893
7156
  receiptPath?: string | undefined;
6894
7157
  })[] | undefined;
7158
+ canonicalBridges?: {
7159
+ underlying: {
7160
+ exportName: string;
7161
+ packageName: string;
7162
+ };
7163
+ local: {
7164
+ componentKey: string;
7165
+ exportName: string;
7166
+ moduleSpecifier: string;
7167
+ implementationFiles: string[];
7168
+ };
7169
+ decision: {
7170
+ state: "confirmed";
7171
+ source: "authored" | "migration";
7172
+ };
7173
+ }[] | undefined;
6895
7174
  presets?: string[] | undefined;
6896
7175
  agent?: z.objectInputType<{
6897
7176
  repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -7156,6 +7435,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7156
7435
  exclude?: string[] | undefined;
7157
7436
  registryHash?: string | undefined;
7158
7437
  })[] | undefined;
7438
+ canonicalBridges?: {
7439
+ underlying: {
7440
+ exportName: string;
7441
+ packageName: string;
7442
+ };
7443
+ local: {
7444
+ componentKey: string;
7445
+ exportName: string;
7446
+ moduleSpecifier: string;
7447
+ implementationFiles: string[];
7448
+ };
7449
+ decision: {
7450
+ state: "confirmed";
7451
+ source: "authored" | "migration";
7452
+ };
7453
+ }[] | undefined;
7159
7454
  presets?: string[] | undefined;
7160
7455
  agent?: z.objectOutputType<{
7161
7456
  repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -7179,6 +7474,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7179
7474
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7180
7475
  }>, "many">>;
7181
7476
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7477
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7478
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
7479
+ packageName: z.ZodString;
7480
+ version: z.ZodOptional<z.ZodString>;
7481
+ digest: z.ZodOptional<z.ZodString>;
7482
+ }, "strip", z.ZodTypeAny, {
7483
+ packageName: string;
7484
+ version?: string | undefined;
7485
+ digest?: string | undefined;
7486
+ }, {
7487
+ packageName: string;
7488
+ version?: string | undefined;
7489
+ digest?: string | undefined;
7490
+ }>, "many">>;
7182
7491
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7183
7492
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7184
7493
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -7424,6 +7733,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7424
7733
  registryHash?: string | undefined;
7425
7734
  receiptPath?: string | undefined;
7426
7735
  })[] | undefined;
7736
+ canonicalBridges?: {
7737
+ underlying: {
7738
+ exportName: string;
7739
+ packageName: string;
7740
+ };
7741
+ local: {
7742
+ componentKey: string;
7743
+ exportName: string;
7744
+ moduleSpecifier: string;
7745
+ implementationFiles: string[];
7746
+ };
7747
+ decision: {
7748
+ state: "confirmed";
7749
+ source: "authored" | "migration";
7750
+ };
7751
+ }[] | undefined;
7427
7752
  presets?: string[] | undefined;
7428
7753
  agent?: z.objectInputType<{
7429
7754
  repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -7447,6 +7772,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7447
7772
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7448
7773
  }>, "many">>;
7449
7774
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7775
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7776
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
7777
+ packageName: z.ZodString;
7778
+ version: z.ZodOptional<z.ZodString>;
7779
+ digest: z.ZodOptional<z.ZodString>;
7780
+ }, "strip", z.ZodTypeAny, {
7781
+ packageName: string;
7782
+ version?: string | undefined;
7783
+ digest?: string | undefined;
7784
+ }, {
7785
+ packageName: string;
7786
+ version?: string | undefined;
7787
+ digest?: string | undefined;
7788
+ }>, "many">>;
7450
7789
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7451
7790
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7452
7791
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -9226,6 +9565,14 @@ declare const recipeDefinitionSchema: z.ZodObject<{
9226
9565
  tags?: string[] | undefined;
9227
9566
  }>;
9228
9567
 
9568
+ /**
9569
+ * Recover the authored declaration before Zod stripped unknown keys.
9570
+ *
9571
+ * `defineConfig` still returns the schema-parsed config so its runtime semantics
9572
+ * do not change. The non-enumerable source declaration exists only long enough
9573
+ * for config loaders to diagnose keys that validated but would otherwise vanish.
9574
+ */
9575
+ declare function configDeclarationForDiagnostics(config: unknown): unknown;
9229
9576
  declare function defineConfig<TConfig extends FragmentsConfig>(config: TConfig): TConfig;
9230
9577
 
9231
9578
  /**
@@ -11583,6 +11930,20 @@ declare function resolveSpacingValue(input: {
11583
11930
  */
11584
11931
 
11585
11932
  type GovernanceIntegrityStatus = "healthy" | "degraded" | "inert";
11933
+ type InertConfigDiagnosticKind = "orphan-scale" | "unconsumed-key";
11934
+ type InertConfigDiagnosticCode = "FUI9004" | "FUI9005";
11935
+ interface InertConfigDiagnostic {
11936
+ code: InertConfigDiagnosticCode;
11937
+ kind: InertConfigDiagnosticKind;
11938
+ severity: "warn";
11939
+ path: string;
11940
+ message: string;
11941
+ }
11942
+ interface GovernanceIntegrityRoster {
11943
+ configured: number;
11944
+ active: number;
11945
+ inert: number;
11946
+ }
11586
11947
  type GovernanceIntegrityFamilyId = "policy" | "components" | "tokens" | "hygiene" | "blocking-deny";
11587
11948
  interface GovernanceIntegrityFamily {
11588
11949
  id: GovernanceIntegrityFamilyId;
@@ -11605,6 +11966,8 @@ interface GovernanceIntegrityInput {
11605
11966
  /** Whether `tokens/css-vars-must-be-defined` is activated (caller supplies). */
11606
11967
  cssVarsActive?: boolean;
11607
11968
  mode?: "scan" | "ci" | "hook" | "doctor" | "setup";
11969
+ /** Named, verdict-neutral diagnostics derived from the authored config. */
11970
+ configDiagnostics?: readonly InertConfigDiagnostic[];
11608
11971
  }
11609
11972
  interface GovernanceIntegrityVerdict {
11610
11973
  status: GovernanceIntegrityStatus;
@@ -11615,6 +11978,8 @@ interface GovernanceIntegrityVerdict {
11615
11978
  armed: GovernanceIntegrityFamilyId[];
11616
11979
  summary: string;
11617
11980
  remediations: string[];
11981
+ configDiagnostics?: InertConfigDiagnostic[];
11982
+ roster?: GovernanceIntegrityRoster;
11618
11983
  }
11619
11984
  /**
11620
11985
  * Whether a canonical source contributes an effective component vocabulary.
@@ -11632,8 +11997,87 @@ declare function isEffectiveCanonicalSource(source: CanonicalSource): boolean;
11632
11997
  * canonical source. Accepts the raw fact `options` bag (values are `unknown`).
11633
11998
  */
11634
11999
  declare function hasEffectiveComponentVocabulary(options: Record<string, unknown> | undefined): boolean;
12000
+ /**
12001
+ * Diagnose config keys that the permissive validation boundary accepts but the
12002
+ * runtime cannot consume. The parsed config is the source of truth for stripped
12003
+ * keys; explicit allow-sets cover intentional `.passthrough()`/record seams.
12004
+ */
12005
+ declare function detectUnconsumedConfigKeys(authoredConfig: unknown, parsedConfig: unknown): InertConfigDiagnostic[];
12006
+ /**
12007
+ * Compare locally declared scales with the effective property-policy graph.
12008
+ * Preset-only scales are not diagnosed because the user did not declare them.
12009
+ */
12010
+ declare function detectOrphanGovernanceScales(declaredPolicy: GovernanceConfig | undefined, effectivePolicy: GovernanceConfig | undefined): InertConfigDiagnostic[];
11635
12011
  declare function evaluateGovernanceIntegrity(input: GovernanceIntegrityInput): GovernanceIntegrityVerdict;
11636
12012
 
12013
+ interface CanonicalDirectionConflict {
12014
+ packageName: string;
12015
+ exportName: string;
12016
+ wrapperComponentKey: string;
12017
+ wrapperFile: string;
12018
+ wrapperExportName: string;
12019
+ state: "unresolved" | "sanctioned";
12020
+ }
12021
+ /**
12022
+ * Project exact, source-backed conflicts between an exported local wrapper and
12023
+ * an npm canonical export. Name similarity, prop overlap, and mixed render
12024
+ * trees are deliberately insufficient: this projection can deactivate policy.
12025
+ */
12026
+ declare function projectCanonicalDirectionConflicts(ix: FactIndex, canonicalSources: readonly CanonicalSource[]): CanonicalDirectionConflict[];
12027
+ declare function canonicalDirectionConflictsTarget(conflicts: readonly CanonicalDirectionConflict[], importPath: string | undefined, exportName: string): boolean;
12028
+
12029
+ declare function canonicalBridgeContractMappings(bridges: readonly CanonicalBridgeV1[] | undefined): ContractCanonicalMappingInput[];
12030
+
12031
+ declare const EFFECTIVE_GOVERNANCE_INPUTS_SCHEMA: "effective-governance-inputs:v1";
12032
+ interface EffectiveGovernanceInputsSourceState {
12033
+ declared: readonly string[];
12034
+ loadedDefinitions: number;
12035
+ diagnostics: readonly string[];
12036
+ catalog?: TokenCatalog;
12037
+ }
12038
+ interface CompileEffectiveGovernanceInputsOptions {
12039
+ policySource: "config" | "preset" | "fallback" | "none";
12040
+ configPath: string | null;
12041
+ configDigest: string | null;
12042
+ policy: GovernanceConfig | undefined;
12043
+ componentDefinitionFiles: readonly string[];
12044
+ tokens: EffectiveGovernanceInputsSourceState;
12045
+ eligibility: {
12046
+ include: readonly string[];
12047
+ exclude: readonly string[];
12048
+ };
12049
+ }
12050
+ interface EffectiveGovernanceInputs {
12051
+ schema: typeof EFFECTIVE_GOVERNANCE_INPUTS_SCHEMA;
12052
+ policySource: CompileEffectiveGovernanceInputsOptions["policySource"];
12053
+ config: {
12054
+ path: string | null;
12055
+ digest: string | null;
12056
+ };
12057
+ components: {
12058
+ canonicalSources: NonNullable<GovernanceConfig["canonicalSources"]>;
12059
+ canonicalBridges: NonNullable<GovernanceConfig["canonicalBridges"]>;
12060
+ definitionFiles: string[];
12061
+ };
12062
+ tokens: {
12063
+ declared: string[];
12064
+ loadedDefinitions: number;
12065
+ diagnostics: string[];
12066
+ catalog?: TokenCatalog;
12067
+ };
12068
+ eligibility: {
12069
+ include: string[];
12070
+ exclude: string[];
12071
+ };
12072
+ inputsHash: string;
12073
+ }
12074
+ /**
12075
+ * Compile one deterministic, post-authority account of the operational inputs
12076
+ * available to governance consumers. This is deliberately distinct from FCID
12077
+ * (enforced contract identity) and scopeHash (the files selected for one Run).
12078
+ */
12079
+ declare function compileEffectiveGovernanceInputs(options: CompileEffectiveGovernanceInputsOptions): EffectiveGovernanceInputs;
12080
+
11637
12081
  interface ComponentKeyInput {
11638
12082
  repoRelativeFile: string;
11639
12083
  exportName: string;
@@ -11643,4 +12087,4 @@ interface ComponentKeyInput {
11643
12087
  */
11644
12088
  declare function buildComponentKey({ repoRelativeFile, exportName }: ComponentKeyInput): string;
11645
12089
 
11646
- export { type A11yNameRequiredFact, AGENT_CONTEXT_RELATIVE_PATH, AgentFormat, BLOCKING_RULE_ALLOWLIST, BRAND, BlockDefinition, type Brand, type BuildAgentFormatInput, type BuildRegistryInstallPlanInput, type BundleArtifactMetadata, type BundleComponentShard, type BundleManifest, type BundleManifestComponentEntry, type BundleSchemaVersion, type BundleTarget, type BundleTokenFile, CATALOG_FIXTURE_A_FCID, type CSF2Story, type CSSGeneratorOptions, type CanonicalCandidateFact, Finding as CanonicalFinding, type CanonicalIdentityReference, type CanonicalMappingFact, type CanonicalReplacementFact, CanonicalSource, type CheckStoryExclusionOpts, type CheckedSpacingValue, type ClassNameDynamicFact, type ClassNameDynamicReason, type ClassNameFact, type ClassNameLiteralFact, type ClassNameOrigin, type ClassifyIdentityInput, CompiledBlock, type CompiledContractOutput, CompiledFragment, type ComplexityTier, type ComponentCapabilityFact, type ComponentContract, type ComponentDefinitionFact, type ComponentDefinitionRenderRoot, type ComponentFactInput, type ComponentId, type ComponentIdentityFact, type ComponentIdentityUsage, type ComponentKeyInput, type ComponentLevelFact, type ComponentMetadataFact, type CompositionAnalysis, type CompositionAuthoringEntry, type CompositionChildSelector, type CompositionConstraint, type CompositionGuideline, type CompositionPattern, type CompositionRegionSelector, type CompositionSuggestion, type CompositionWarning, type ConformChange, type ConformComponentMapping, type ConformConfidence, type ConformCoverage, type ConformInput, type ConformLocation, type ConformPropMapping, type ConformResult, type ConformSuggestion, type ConformToken, type ConformUnresolved, ContractCatalogInput, ContractDomain, type ContractStampPin, type ContractStampRecord, DEFAULTS, DEFAULT_ENHANCED_STYLE_PROPERTIES, DEFAULT_STYLE_PROPERTIES, type DTCGColorValue, type DTCGDimensionValue, type DTCGGroup, type DTCGToken, type DTCGTokenFile, type DTCGTokenType, type Decorator, type Defaults, type DeltaEMatch, type DesignSystemContext, type DesignToken, type DesignTokenParseOptions, type DiscoverComponentsOptions, type EnhancedStyleComparisonResult, type EnhancedStyleDiffItem, EvidenceGrade, type ExclusionReason, type ExclusionResult, type ExternalIdentityReference, FRAGMENTS_INTERNAL_RULE_IDS, type Fact, type FactEvidence, type FactId, FactIndex, type FactKind, type FactLocation, type FactOfKind, FigmaBooleanMapping, FigmaChildrenMapping, FigmaEnumMapping, FigmaInstanceMapping, FigmaStringMapping, FigmaTextContentMapping, type FigmaVariable, type FigmaVariableCollection, Finding, FindingFix, type Fragment, type FragmentAccessibility, FragmentComponent, type FragmentContextOptions, FragmentDefinition, FragmentDefinitionV2, type FragmentDoNotItem, type FragmentFigma, type FragmentIndex, type FragmentMeta as FragmentJsonMeta, type FragmentUsage as FragmentJsonUsage, type FragmentPattern, type FragmentRegistry, type FragmentRelated, FragmentsConfig, Severity as FuiSeverity, GovernanceConfig, type GovernanceIntegrityFamily, type GovernanceIntegrityFamilyId, type GovernanceIntegrityInput, type GovernanceIntegrityStatus, type GovernanceIntegrityVerdict, GovernanceSeverity, GovernedFragmentDefinition, type IdentityClassification, type IdentityConfidence, type IdentityDecision, type IdentityFact, type IdentityState, type InferProps, type JsxComponentPreferredFact, type JsxImportPathPreferredFact, type JsxInlineStyleForbiddenRawFact, type JsxUnknownPropsForbiddenFact, type Loader, type LocalIdentityReference, type McpBlock, type McpCapability, type McpComponent, type McpComponentExample, type McpComponentGuidance, type McpComponentMetadata, type McpComponentProp, type McpComponentRelation, type McpCompoundChild, type McpGuidancePattern, type McpPerformanceData, type McpPerformanceImport, type McpPerformanceSummary, type McpSnapshot, type McpSnapshotMetadata, type McpSnapshotSchemaVersion, type McpSourceType, type McpToken, type McpTokenData, type NearestByDeltaEOptions, type NormalizedStyleMap, type NormalizedToken, PRESET_NAMES, PROVE_DEFAULT_MAX_PASSES, PROVE_MAX_PASSES, type ParseTokensOptions, type ParsedToken, type PerformanceData as PerfData, type PerformanceSummary as PerfSummary, type PerformanceBudgets, type PerformanceConfig, type PolicyFact, type PresetRuleState, type PreviewConfig, type PreviewRuntimeOptions, type PreviewRuntimeState, type PreviewVariantLike, PreviewVariantRuntime, type PropMetadataFact, type PropValueAvoidedFact, type PropValueForbiddenFact, type ProveCallbacks, type ProveLoopResult, type ProveOptions, type ProvePass, type ProvePassSampling, type ProveResidual, type ProveSample, type ProveSamplerArgs, type ProveVerdict, RAW_HTML_ADVISORY_TAGS, RAW_HTML_CANONICAL_TAGS, RAW_HTML_INPUT_TYPE_CANONICALS, RAW_HTML_ROLE_CANONICALS, type RGB, type RGBA, RULES, RULE_TIER, type RawHtmlCanonicalMatch, type RawHtmlPrecisionTier, RegistryArtifact, type RegistryComponentEntry, RegistryDependency, type RegistryInstallPlan, RegistryInstallReceipt, type RegistryPropEntry, type RegistryWritePlan, RelationshipType, type ResolvedDTCGToken, ResolvedGovernedFragmentDefinition, type ResolvedIdentityRenderRoot, type ResolvedIntrinsicIdentityRoot, type Rule, type RuleFn, type RuleTier, type SCSSGeneratorOptions, type ScaleFact, type ScaleValueFact, Severity, type SpacingResolutionScale, type SpacingTokenLookup, type Story, type StoryArgType, type StoryContext, type StoryMeta, type StoryModule, StorybookFilterConfig, type StructuralConfidenceFact, type StyleComparisonOptions, type StyleComparisonResult, type StyleCssVarsMustBeDefinedFact, type StyleDeclarationFact, type StyleDiffItem, type StyleFontSizeScaleFact, type StylePropertyScaleFact, type StyleRawColorForbiddenFact, type StyleUnsupportedFact, type SuppressionDirectiveFact, type TailwindClassFact, type TailwindModifier, type TailwindModifierKind, type TailwindPaletteAllowFact, type TailwindPaletteDenyFact, type TailwindResolutionSource, type TailwindResolvedKind, type TailwindResolvedValue, type TailwindTokenResolvedFact, type TailwindUnknownClassEnabledFact, type TailwindValue, type ThemeDeclarationFact, type ThemeParserResult, type TokenCategory, TokenConfig, type TokenDefinitionFact, type TokenFix, type TokenFormat, type TokenLookup, type TokenMatchRequest, type TokenMatchResult, type TokenParseError, type TokenParseOutput, type TokenParseResult, type TokenRegistry, type TokenRegistryMeta, type TokenUsageSummary, type UnsupportedStyleReason, type UsageComponentFact, type UsageFact, type UsageImportFact, type UsageInlineStyleFact, type UsageNodeFact, type UsagePropResolvedFact, type UsageTextChildFact, VariantLoader, aiMetadataSchema, analyzeComposition, asComponentId, assertPortableRegistryPath, blockDefinitionSchema, budgetBar, buildAgentFormat, buildComponentKey, buildRegistryInstallPlan, buildRegistryInstallReceipt, buildSpacingTokenLookup, bundleArtifactMetadataSchema, bundleComponentShardSchema, bundleManifestComponentEntrySchema, bundleManifestSchema, bundleSchemaVersionSchema, bundleTargetSchema, bundleTokenFileSchema, calculateDeltaE, canonicalJson, canonicalPreimage, catalogFixtureA, catalogFixtureAContractPayload, catalogFixtureATokensDtcg, checkStoryExclusion, clampMaxPasses, classifyComplexity, classifyIdentity, collectRegistryInstallDependencies, colorSimilarity, compareByVocabularyRank, compareColors, compareNumericValues, compareStyleValue, compareStyles, compareStylesWithTokens, compileBlock, compileComponentFacts, compileFragment, compileGlobalGovernanceFacts, compileRecipe, componentContractSchema, componentId, componentRelationSchema, compositionAuthoringEntrySchema, compositionMetadataSchema, compositionPatternSchema, containsTailwindV4Theme, contractHash, contractTierRuleIds, customerDefaultRuleStates, defineBlock, defineConfig, defineFragment, defineRecipe, detectSubComponentPaths, discoverComponents, dtcgTokenFileSchema, emptyConformResult, evaluateGovernanceIntegrity, executeVariantLoaders, factId, familyDistance, figma, figmaPropMappingSchema, formatBytes, formatStampHeader, formatStampPin, formatStampVersionHash, formatTokenSummary, fragmentBanSchema, fragmentContractSchema, fragmentDefinitionSchema, fragmentDefinitionV2Schema, fragmentGeneratedSchema, fragmentMetaSchema, fragmentProvenanceSchema, fragmentUsageSchema, fragmentVariantSchema, fragmentsConfigSchema, fragmentsPresetRuleStates, gatesCi, generateCSSCustomProperties, generateFigmaVariables, generateSCSSVariables, generateTailwindConfig, getComplianceBadge, getPreviewConfig, governedFragmentDefinitionSchema, hasEffectiveComponentVocabulary, hash64Hex, hexToRgb, hygieneTierRuleIds, indexComponentIdentityUsage, inferTokenCategory, inferTokenGroup, isColorLike, isCompositionPattern, isConfigExcluded, isContractFile, isContractTierRule, isDTCGFile, isDenyEligible, isEffectiveCanonicalSource, isEnforceableHtmlEquivalent, isExportStory, isFigmaPropMapping, isForceIncluded, isPortableRepoPath, isRawHtmlAdvisoryTier, isReactComponent, lowerCompositionContract, makeA11yNameRequiredFact, makeCanonicalCandidateFact, makeCanonicalMappingFact, makeCanonicalReplacementFact, makeClassNameDynamicFact, makeClassNameLiteralFact, makeComponentCapabilityFact, makeComponentDefinitionFact, makeComponentIdentityFact, makeComponentMetadataFact, makeContractTokenFact, makeFinding, makeJsxComponentPreferredFact, makeJsxImportPathPreferredFact, makeJsxInlineStyleForbiddenRawFact, makeJsxUnknownPropsForbiddenFact, makePropMetadataFact, makePropValueAvoidedFact, makePropValueForbiddenFact, makeScaleFact, makeScaleValueFact, makeStructuralConfidenceFact, makeStyleCssVarsMustBeDefinedFact, makeStyleDeclarationFact, makeStyleFontSizeScaleFact, makeStylePropertyScaleFact, makeStyleRawColorForbiddenFact, makeStyleUnsupportedFact, makeTailwindClassFact, makeTailwindPaletteAllowFact, makeTailwindPaletteDenyFact, makeTailwindTokenResolvedFact, makeTailwindUnknownClassEnabledFact, makeThemeDeclarationFact, makeTokenDefinitionFact, makeUsageComponentFact, makeUsageImportFact, makeUsageInlineStyleFact, makeUsageNodeFact, makeUsagePropResolvedFact, makeUsageTextChildFact, matchesGlob, mcpBlockSchema, mcpCapabilitySchema, mcpComponentExampleSchema, mcpComponentGuidanceSchema, mcpComponentMetadataSchema, mcpComponentPropSchema, mcpComponentRelationSchema, mcpComponentSchema, mcpCompoundChildSchema, mcpGuidancePatternSchema, mcpPerformanceDataSchema, mcpPerformanceImportSchema, mcpPerformanceSummarySchema, mcpSnapshotMetadataSchema, mcpSnapshotSchema, mcpSnapshotSchemaVersionSchema, mcpSourceTypeSchema, mcpTokenDataSchema, mcpTokenSchema, nearestByDeltaE, nearestSignedScaleValue, normalizeColor, normalizeConfigPath, normalizeRegistryRepoPath, normalizeStyleValue, normalizeToV1, normalizeTokenGroupComment, normalizeTokenValue, parseColor, parseColorToRgb, parseComponentContract, parseContractStamp, parseCssTokens, parseDtcgTokens as parseDTCGFile, parseDesignTokenContent, parseDtcgTokens, parseRgb, parseScssTokens, parseScssVariables, parseTailwindV4Theme, parseTokenFile, parseTokens, portableRepoPathError, propDefinitionSchema, proveCompliant, proveIssueCount, recipeDefinitionSchema, resolveCanonicalForAriaRole, resolveCanonicalForRawHtml, resolveConfiguredAppPath, resolveDesignTokenValue, resolveFigmaMapping, resolvePerformanceConfig, resolvePreviewRuntimeState, resolveProveVerdict, resolveSpacingValue, resolveTokenValue, rgbToHex, ruleA11yRequiredAccessibleName, ruleComponentsForbiddenPropValue, ruleComponentsPreferLibrary, ruleComponentsShadowComponent, ruleComponentsUnknownProp, ruleJsxPreferredComponent, ruleJsxPreferredImportPath, rulePropsInvalidValue, ruleStylesNoRawColor, ruleStylesNoRawDimensions, ruleStylesNoRawSpacing, ruleStylesNoRawTypography, ruleTailwindArbitraryColor, ruleTailwindArbitrarySpacing, ruleTailwindForbiddenPalette, ruleTailwindOffScaleSpacingToken, ruleTailwindRawColorViaToken, ruleTailwindUnknownClass, ruleThemeNoThemeCoupledLiteral, ruleTokensRequireDualFallback, runRules, selectedRegistryComponentNames, serializeContractStamp, setPreviewConfig, sha256Hex, sourceToRegistryTargetPath, storyModuleToFragment, storyNameFromExport, tierFor, toId, tokenIncludesFromConfig, topologyBase, usePreviewVariantRuntime, vocabularyRank };
12090
+ export { type A11yNameRequiredFact, AGENT_CONTEXT_RELATIVE_PATH, AgentFormat, BLOCKING_RULE_ALLOWLIST, BRAND, BlockDefinition, type Brand, type BuildAgentFormatInput, type BuildRegistryInstallPlanInput, type BundleArtifactMetadata, type BundleComponentShard, type BundleManifest, type BundleManifestComponentEntry, type BundleSchemaVersion, type BundleTarget, type BundleTokenFile, CATALOG_FIXTURE_A_FCID, type CSF2Story, type CSSGeneratorOptions, CanonicalBridgeV1, type CanonicalCandidateFact, type CanonicalDirectionConflict, Finding as CanonicalFinding, type CanonicalIdentityReference, type CanonicalMappingFact, type CanonicalReplacementFact, CanonicalSource, type CheckStoryExclusionOpts, type CheckedSpacingValue, type ClassNameDynamicFact, type ClassNameDynamicReason, type ClassNameFact, type ClassNameLiteralFact, type ClassNameOrigin, type ClassifyIdentityInput, type CompileEffectiveGovernanceInputsOptions, CompiledBlock, type CompiledContractOutput, CompiledFragment, type ComplexityTier, type ComponentCapabilityFact, type ComponentContract, type ComponentDefinitionFact, type ComponentDefinitionRenderRoot, type ComponentFactInput, type ComponentId, type ComponentIdentityFact, type ComponentIdentityUsage, type ComponentKeyInput, type ComponentLevelFact, type ComponentMetadataFact, type CompositionAnalysis, type CompositionAuthoringEntry, type CompositionChildSelector, type CompositionConstraint, type CompositionGuideline, type CompositionPattern, type CompositionRegionSelector, type CompositionSuggestion, type CompositionWarning, type ConformChange, type ConformComponentMapping, type ConformConfidence, type ConformCoverage, type ConformInput, type ConformLocation, type ConformPropMapping, type ConformResult, type ConformSuggestion, type ConformToken, type ConformUnresolved, ContractCanonicalMappingInput, ContractCatalogInput, ContractDomain, type ContractStampPin, type ContractStampRecord, DEFAULTS, DEFAULT_ENHANCED_STYLE_PROPERTIES, DEFAULT_STYLE_PROPERTIES, type DTCGColorValue, type DTCGDimensionValue, type DTCGGroup, type DTCGToken, type DTCGTokenFile, type DTCGTokenType, type Decorator, type Defaults, type DeltaEMatch, type DesignSystemContext, type DesignToken, type DesignTokenParseOptions, type DiscoverComponentsOptions, EFFECTIVE_GOVERNANCE_INPUTS_SCHEMA, type EffectiveGovernanceInputs, type EffectiveGovernanceInputsSourceState, type EnhancedStyleComparisonResult, type EnhancedStyleDiffItem, EvidenceGrade, type ExclusionReason, type ExclusionResult, type ExternalIdentityReference, FRAGMENTS_INTERNAL_RULE_IDS, type Fact, type FactEvidence, type FactId, FactIndex, type FactKind, type FactLocation, type FactOfKind, FigmaBooleanMapping, FigmaChildrenMapping, FigmaEnumMapping, FigmaInstanceMapping, FigmaStringMapping, FigmaTextContentMapping, type FigmaVariable, type FigmaVariableCollection, Finding, FindingFix, type Fragment, type FragmentAccessibility, FragmentComponent, type FragmentContextOptions, FragmentDefinition, FragmentDefinitionV2, type FragmentDoNotItem, type FragmentFigma, type FragmentIndex, type FragmentMeta as FragmentJsonMeta, type FragmentUsage as FragmentJsonUsage, type FragmentPattern, type FragmentRegistry, type FragmentRelated, FragmentsConfig, Severity as FuiSeverity, GovernanceConfig, type GovernanceIntegrityFamily, type GovernanceIntegrityFamilyId, type GovernanceIntegrityInput, type GovernanceIntegrityRoster, type GovernanceIntegrityStatus, type GovernanceIntegrityVerdict, GovernanceSeverity, GovernedFragmentDefinition, type IdentityClassification, type IdentityConfidence, type IdentityDecision, type IdentityFact, type IdentityState, type InertConfigDiagnostic, type InertConfigDiagnosticCode, type InertConfigDiagnosticKind, type InferProps, type JsxComponentPreferredFact, type JsxImportPathPreferredFact, type JsxInlineStyleForbiddenRawFact, type JsxUnknownPropsForbiddenFact, type Loader, type LocalIdentityReference, type McpBlock, type McpCapability, type McpComponent, type McpComponentExample, type McpComponentGuidance, type McpComponentMetadata, type McpComponentProp, type McpComponentRelation, type McpCompoundChild, type McpGuidancePattern, type McpPerformanceData, type McpPerformanceImport, type McpPerformanceSummary, type McpSnapshot, type McpSnapshotMetadata, type McpSnapshotSchemaVersion, type McpSourceType, type McpToken, type McpTokenData, type NearestByDeltaEOptions, type NormalizedStyleMap, type NormalizedToken, PRESET_NAMES, PROVE_DEFAULT_MAX_PASSES, PROVE_MAX_PASSES, type ParseTokensOptions, type ParsedToken, type PerformanceData as PerfData, type PerformanceSummary as PerfSummary, type PerformanceBudgets, type PerformanceConfig, type PolicyFact, type PresetRuleState, type PreviewConfig, type PreviewRuntimeOptions, type PreviewRuntimeState, type PreviewVariantLike, PreviewVariantRuntime, type PropMetadataFact, type PropValueAvoidedFact, type PropValueForbiddenFact, type ProveCallbacks, type ProveLoopResult, type ProveOptions, type ProvePass, type ProvePassSampling, type ProveResidual, type ProveSample, type ProveSamplerArgs, type ProveVerdict, RAW_HTML_ADVISORY_TAGS, RAW_HTML_CANONICAL_TAGS, RAW_HTML_INPUT_TYPE_CANONICALS, RAW_HTML_ROLE_CANONICALS, type RGB, type RGBA, RULES, RULE_TIER, type RawHtmlCanonicalMatch, type RawHtmlPrecisionTier, RegistryArtifact, type RegistryComponentEntry, RegistryDependency, type RegistryInstallPlan, RegistryInstallReceipt, type RegistryPropEntry, type RegistryWritePlan, RelationshipType, type ResolvedDTCGToken, ResolvedGovernedFragmentDefinition, type ResolvedIdentityRenderRoot, type ResolvedIntrinsicIdentityRoot, type Rule, type RuleFn, type RuleTier, type SCSSGeneratorOptions, type ScaleFact, type ScaleValueFact, Severity, type SpacingResolutionScale, type SpacingTokenLookup, type Story, type StoryArgType, type StoryContext, type StoryMeta, type StoryModule, StorybookFilterConfig, type StructuralConfidenceFact, type StyleComparisonOptions, type StyleComparisonResult, type StyleCssVarsMustBeDefinedFact, type StyleDeclarationFact, type StyleDiffItem, type StyleFontSizeScaleFact, type StylePropertyScaleFact, type StyleRawColorForbiddenFact, type StyleUnsupportedFact, type SuppressionDirectiveFact, type TailwindClassFact, type TailwindModifier, type TailwindModifierKind, type TailwindPaletteAllowFact, type TailwindPaletteDenyFact, type TailwindResolutionSource, type TailwindResolvedKind, type TailwindResolvedValue, type TailwindTokenResolvedFact, type TailwindUnknownClassEnabledFact, type TailwindValue, type ThemeDeclarationFact, type ThemeParserResult, type TokenCatalog, type TokenCatalogDefinition, type TokenCatalogDiagnostic, type TokenCatalogLocation, type TokenCatalogReference, type TokenCatalogSourceState, type TokenCategory, TokenConfig, type TokenDefinitionFact, type TokenFix, type TokenFormat, type TokenLookup, type TokenMatchRequest, type TokenMatchResult, type TokenParseError, type TokenParseOutput, type TokenParseResult, type TokenRegistry, type TokenRegistryMeta, type TokenUsageSummary, type UnsupportedStyleReason, type UsageComponentFact, type UsageFact, type UsageImportFact, type UsageInlineStyleFact, type UsageNodeFact, type UsagePropResolvedFact, type UsageTextChildFact, VariantLoader, aiMetadataSchema, analyzeComposition, asComponentId, assertPortableRegistryPath, blockDefinitionSchema, budgetBar, buildAgentFormat, buildComponentKey, buildRegistryInstallPlan, buildRegistryInstallReceipt, buildSpacingTokenLookup, bundleArtifactMetadataSchema, bundleComponentShardSchema, bundleManifestComponentEntrySchema, bundleManifestSchema, bundleSchemaVersionSchema, bundleTargetSchema, bundleTokenFileSchema, calculateDeltaE, canonicalBridgeContractMappings, canonicalDirectionConflictsTarget, canonicalJson, canonicalPreimage, catalogFixtureA, catalogFixtureAContractPayload, catalogFixtureATokensDtcg, checkStoryExclusion, clampMaxPasses, classifyComplexity, classifyIdentity, collectRegistryInstallDependencies, colorSimilarity, compareByVocabularyRank, compareColors, compareNumericValues, compareStyleValue, compareStyles, compareStylesWithTokens, compileBlock, compileComponentFacts, compileEffectiveGovernanceInputs, compileFragment, compileGlobalGovernanceFacts, compileRecipe, componentContractSchema, componentId, componentRelationSchema, compositionAuthoringEntrySchema, compositionMetadataSchema, compositionPatternSchema, configDeclarationForDiagnostics, containsTailwindV4Theme, contractHash, contractTierRuleIds, customerDefaultRuleStates, defineBlock, defineConfig, defineFragment, defineRecipe, detectOrphanGovernanceScales, detectSubComponentPaths, detectUnconsumedConfigKeys, discoverComponents, dtcgTokenFileSchema, emptyConformResult, evaluateGovernanceIntegrity, executeVariantLoaders, factId, familyDistance, figma, figmaPropMappingSchema, formatBytes, formatStampHeader, formatStampPin, formatStampVersionHash, formatTokenSummary, fragmentBanSchema, fragmentContractSchema, fragmentDefinitionSchema, fragmentDefinitionV2Schema, fragmentGeneratedSchema, fragmentMetaSchema, fragmentProvenanceSchema, fragmentUsageSchema, fragmentVariantSchema, fragmentsConfigSchema, fragmentsPresetRuleStates, gatesCi, generateCSSCustomProperties, generateFigmaVariables, generateSCSSVariables, generateTailwindConfig, getComplianceBadge, getPreviewConfig, governedFragmentDefinitionSchema, hasEffectiveComponentVocabulary, hash64Hex, hexToRgb, hygieneTierRuleIds, indexComponentIdentityUsage, inferTokenCategory, inferTokenGroup, isColorLike, isCompositionPattern, isConfigExcluded, isContractFile, isContractTierRule, isDTCGFile, isDenyEligible, isEffectiveCanonicalSource, isEnforceableHtmlEquivalent, isExportStory, isFigmaPropMapping, isForceIncluded, isPortableRepoPath, isRawHtmlAdvisoryTier, isReactComponent, lowerCompositionContract, makeA11yNameRequiredFact, makeCanonicalCandidateFact, makeCanonicalMappingFact, makeCanonicalReplacementFact, makeClassNameDynamicFact, makeClassNameLiteralFact, makeComponentCapabilityFact, makeComponentDefinitionFact, makeComponentIdentityFact, makeComponentMetadataFact, makeContractTokenFact, makeFinding, makeJsxComponentPreferredFact, makeJsxImportPathPreferredFact, makeJsxInlineStyleForbiddenRawFact, makeJsxUnknownPropsForbiddenFact, makePropMetadataFact, makePropValueAvoidedFact, makePropValueForbiddenFact, makeScaleFact, makeScaleValueFact, makeStructuralConfidenceFact, makeStyleCssVarsMustBeDefinedFact, makeStyleDeclarationFact, makeStyleFontSizeScaleFact, makeStylePropertyScaleFact, makeStyleRawColorForbiddenFact, makeStyleUnsupportedFact, makeTailwindClassFact, makeTailwindPaletteAllowFact, makeTailwindPaletteDenyFact, makeTailwindTokenResolvedFact, makeTailwindUnknownClassEnabledFact, makeThemeDeclarationFact, makeTokenDefinitionFact, makeUsageComponentFact, makeUsageImportFact, makeUsageInlineStyleFact, makeUsageNodeFact, makeUsagePropResolvedFact, makeUsageTextChildFact, matchesGlob, mcpBlockSchema, mcpCapabilitySchema, mcpComponentExampleSchema, mcpComponentGuidanceSchema, mcpComponentMetadataSchema, mcpComponentPropSchema, mcpComponentRelationSchema, mcpComponentSchema, mcpCompoundChildSchema, mcpGuidancePatternSchema, mcpPerformanceDataSchema, mcpPerformanceImportSchema, mcpPerformanceSummarySchema, mcpSnapshotMetadataSchema, mcpSnapshotSchema, mcpSnapshotSchemaVersionSchema, mcpSourceTypeSchema, mcpTokenDataSchema, mcpTokenSchema, nearestByDeltaE, nearestSignedScaleValue, normalizeColor, normalizeConfigPath, normalizeRegistryRepoPath, normalizeStyleValue, normalizeToV1, normalizeTokenGroupComment, normalizeTokenValue, parseColor, parseColorToRgb, parseComponentContract, parseContractStamp, parseCssTokens, parseDtcgTokens as parseDTCGFile, parseDesignTokenContent, parseDtcgTokens, parseRgb, parseScssTokens, parseScssVariables, parseTailwindV4Theme, parseTokenFile, parseTokens, portableRepoPathError, projectCanonicalDirectionConflicts, propDefinitionSchema, proveCompliant, proveIssueCount, recipeDefinitionSchema, resolveCanonicalForAriaRole, resolveCanonicalForRawHtml, resolveConfiguredAppPath, resolveDesignTokenValue, resolveFigmaMapping, resolvePerformanceConfig, resolvePreviewRuntimeState, resolveProveVerdict, resolveSpacingValue, resolveTokenValue, rgbToHex, ruleA11yRequiredAccessibleName, ruleComponentsForbiddenPropValue, ruleComponentsPreferLibrary, ruleComponentsShadowComponent, ruleComponentsUnknownProp, ruleJsxPreferredComponent, ruleJsxPreferredImportPath, rulePropsInvalidValue, ruleStylesNoRawColor, ruleStylesNoRawDimensions, ruleStylesNoRawSpacing, ruleStylesNoRawTypography, ruleTailwindArbitraryColor, ruleTailwindArbitrarySpacing, ruleTailwindForbiddenPalette, ruleTailwindOffScaleSpacingToken, ruleTailwindRawColorViaToken, ruleTailwindUnknownClass, ruleThemeNoThemeCoupledLiteral, ruleTokensRequireDualFallback, runRules, selectedRegistryComponentNames, serializeContractStamp, setPreviewConfig, sha256Hex, sourceToRegistryTargetPath, storyModuleToFragment, storyNameFromExport, tierFor, toId, tokenIncludesFromConfig, topologyBase, usePreviewVariantRuntime, vocabularyRank };