@usefragments/core 1.5.0 → 1.5.1

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 (61) hide show
  1. package/dist/{chunk-HXGE3O2F.js → chunk-AOG4FTV6.js} +108 -6
  2. package/dist/chunk-AOG4FTV6.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-B88uR3Zq.d.ts} +218 -1
  10. package/dist/{index-h_yWj15D.d.ts → index-DbkPE46t.d.ts} +40 -0
  11. package/dist/index.d.ts +429 -28
  12. package/dist/index.js +326 -33
  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/codes.ts +9 -0
  23. package/src/contract/preimage.test.ts +40 -0
  24. package/src/contract/preimage.ts +20 -0
  25. package/src/effective-governance-inputs.test.ts +52 -0
  26. package/src/effective-governance-inputs.ts +106 -0
  27. package/src/facts/builders.ts +25 -1
  28. package/src/facts/compile.ts +20 -2
  29. package/src/facts/fact-index.ts +4 -0
  30. package/src/facts/types.ts +25 -6
  31. package/src/governance-integrity.test.ts +22 -0
  32. package/src/governance-integrity.ts +10 -4
  33. package/src/governance.test.ts +67 -0
  34. package/src/governance.ts +76 -0
  35. package/src/index.ts +27 -4
  36. package/src/rules/__tests__/fix-emission-invariant.test.ts +35 -4
  37. package/src/rules/components-prefer-library.test.ts +103 -0
  38. package/src/rules/components-prefer-library.ts +30 -4
  39. package/src/rules/fix-availability.ts +1 -0
  40. package/src/rules/index.ts +7 -0
  41. package/src/rules/jsx-preferred-import-path.ts +45 -9
  42. package/src/rules/rules.test.ts +202 -6
  43. package/src/rules/spacing-resolution.ts +2 -2
  44. package/src/rules/styles-no-raw-color.test.ts +6 -1
  45. package/src/rules/styles-no-raw-color.ts +3 -2
  46. package/src/rules/styles-no-raw-dimensions.ts +5 -7
  47. package/src/rules/styles-no-raw-spacing.ts +5 -2
  48. package/src/rules/styles-no-raw-typography.ts +7 -4
  49. package/src/rules/taxonomy.test.ts +3 -0
  50. package/src/rules/tiers.ts +2 -0
  51. package/src/rules/token-candidates.ts +36 -0
  52. package/src/rules/tokens-require-dual-fallback.ts +2 -1
  53. package/src/rules/tokens-upstream-drift.test.ts +111 -0
  54. package/src/rules/tokens-upstream-drift.ts +57 -0
  55. package/src/rules/utils.ts +22 -14
  56. package/src/schema.ts +13 -0
  57. package/src/schemas/index.ts +5 -8
  58. package/src/token-types.ts +71 -1
  59. package/src/types.ts +6 -0
  60. package/dist/chunk-57QDBEHQ.js.map +0 -1
  61. 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-B88uR3Zq.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-B88uR3Zq.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[];
@@ -1730,6 +1755,52 @@ declare function budgetBar(percent: number, width?: number): string;
1730
1755
  * Token categories for grouping and filtering
1731
1756
  */
1732
1757
  type TokenCategory = "color" | "spacing" | "typography" | "radius" | "shadow" | "sizing" | "border" | "animation" | "z-index" | "other";
1758
+ /** Stable, renderer-independent token catalog contract. */
1759
+ interface TokenCatalog {
1760
+ schemaVersion: "token-catalog:v1";
1761
+ configuredSources: string[];
1762
+ parsedSources: string[];
1763
+ definitions: TokenCatalogDefinition[];
1764
+ diagnostics: TokenCatalogDiagnostic[];
1765
+ references: TokenCatalogReference[];
1766
+ sourceStates?: TokenCatalogSourceState[];
1767
+ }
1768
+ interface TokenCatalogSourceState {
1769
+ source: string;
1770
+ role: "local" | "upstream";
1771
+ state: "verified" | "version_mismatch" | "digest_mismatch" | "source_unavailable" | "cache_unverified";
1772
+ installedVersion?: string;
1773
+ contentDigest?: string;
1774
+ expectedVersion?: string;
1775
+ expectedDigest?: string;
1776
+ }
1777
+ interface TokenCatalogLocation {
1778
+ file: string;
1779
+ line: number;
1780
+ column: number;
1781
+ }
1782
+ interface TokenCatalogDefinition {
1783
+ /** Authored member path, for example `spacing.smaller` or `theme.palette.primary.main`. */
1784
+ name: string;
1785
+ value: string;
1786
+ category: TokenCategory;
1787
+ location: TokenCatalogLocation;
1788
+ exportName?: string;
1789
+ referenceSyntax: "css-var" | "scss-var" | "scss-map" | "dtcg" | "js-member";
1790
+ authority: "authored" | "declared-package";
1791
+ role: "local" | "upstream";
1792
+ }
1793
+ interface TokenCatalogDiagnostic {
1794
+ code: "tokens/unsupported-static-value" | "tokens/source-unavailable";
1795
+ severity: "warning";
1796
+ message: string;
1797
+ location: TokenCatalogLocation;
1798
+ }
1799
+ interface TokenCatalogReference {
1800
+ name: string;
1801
+ location: TokenCatalogLocation;
1802
+ syntax: "css-var" | "scss-var" | "scss-map" | "dtcg" | "js-member";
1803
+ }
1733
1804
  /**
1734
1805
  * A single design token (CSS custom property)
1735
1806
  */
@@ -1758,7 +1829,7 @@ interface DesignToken {
1758
1829
  /** Source file where this token was defined */
1759
1830
  sourceFile: string;
1760
1831
  /** Authored reference form, when the parser can prove it from the source. */
1761
- referenceFormat?: "css-var" | "scss-var" | "scss-map" | "dtcg";
1832
+ referenceFormat?: "css-var" | "scss-var" | "scss-map" | "dtcg" | "js-member";
1762
1833
  /** Authored spellings preserved before normalization (for example `$x` and `--x`). */
1763
1834
  sourceNames?: string[];
1764
1835
  /** Line number in source file */
@@ -1857,6 +1928,8 @@ interface TokenParseResult {
1857
1928
  warnings: string[];
1858
1929
  /** Parse time in ms */
1859
1930
  parseTimeMs: number;
1931
+ /** The shared catalog used to produce `tokens`. Additive for compatibility. */
1932
+ catalog?: TokenCatalog;
1860
1933
  }
1861
1934
  /**
1862
1935
  * Error during token parsing
@@ -2417,8 +2490,8 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2417
2490
  componentId: string;
2418
2491
  name: string;
2419
2492
  }[];
2420
- tier: "core" | "composition";
2421
2493
  source: "design-system";
2494
+ tier: "core" | "composition";
2422
2495
  publicSlug: string | null;
2423
2496
  relations: Record<string, unknown>[];
2424
2497
  publicId: string | null;
@@ -2443,8 +2516,8 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2443
2516
  componentId: string;
2444
2517
  name: string;
2445
2518
  }[];
2446
- tier: "core" | "composition";
2447
2519
  source: "design-system";
2520
+ tier: "core" | "composition";
2448
2521
  publicSlug: string | null;
2449
2522
  relations: Record<string, unknown>[];
2450
2523
  publicId: string | null;
@@ -2474,8 +2547,8 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2474
2547
  componentId: string;
2475
2548
  name: string;
2476
2549
  }[];
2477
- tier: "core" | "composition";
2478
2550
  source: "design-system";
2551
+ tier: "core" | "composition";
2479
2552
  publicSlug: string | null;
2480
2553
  relations: Record<string, unknown>[];
2481
2554
  publicId: string | null;
@@ -2507,8 +2580,8 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2507
2580
  componentId: string;
2508
2581
  name: string;
2509
2582
  }[];
2510
- tier: "core" | "composition";
2511
2583
  source: "design-system";
2584
+ tier: "core" | "composition";
2512
2585
  publicSlug: string | null;
2513
2586
  relations: Record<string, unknown>[];
2514
2587
  publicId: string | null;
@@ -3056,9 +3129,9 @@ declare const mcpComponentSchema: z.ZodObject<{
3056
3129
  importPath?: string | undefined;
3057
3130
  publicRef?: string | undefined;
3058
3131
  sourcePath?: string | undefined;
3132
+ packageName?: string | undefined;
3059
3133
  tier?: string | undefined;
3060
3134
  publicSlug?: string | null | undefined;
3061
- packageName?: string | undefined;
3062
3135
  isCanonical?: boolean | undefined;
3063
3136
  sourceRepoFullName?: string | undefined;
3064
3137
  parentComponentName?: string | undefined;
@@ -3106,6 +3179,7 @@ declare const mcpComponentSchema: z.ZodObject<{
3106
3179
  accepts?: string[] | undefined;
3107
3180
  visibility?: "public" | "internal" | undefined;
3108
3181
  }[] | undefined;
3182
+ packageName?: string | undefined;
3109
3183
  tier?: string | undefined;
3110
3184
  publicSlug?: string | null | undefined;
3111
3185
  relations?: {
@@ -3115,7 +3189,6 @@ declare const mcpComponentSchema: z.ZodObject<{
3115
3189
  componentId?: string | undefined;
3116
3190
  note?: string | undefined;
3117
3191
  }[] | undefined;
3118
- packageName?: string | undefined;
3119
3192
  isCanonical?: boolean | undefined;
3120
3193
  examples?: {
3121
3194
  name: string;
@@ -3283,14 +3356,14 @@ declare const mcpSnapshotMetadataSchema: z.ZodObject<{
3283
3356
  updatedAt: z.ZodOptional<z.ZodString>;
3284
3357
  }, "strip", z.ZodTypeAny, {
3285
3358
  importPath?: string | undefined;
3286
- updatedAt?: string | undefined;
3287
3359
  packageName?: string | undefined;
3360
+ updatedAt?: string | undefined;
3288
3361
  designSystemName?: string | undefined;
3289
3362
  revision?: string | undefined;
3290
3363
  }, {
3291
3364
  importPath?: string | undefined;
3292
- updatedAt?: string | undefined;
3293
3365
  packageName?: string | undefined;
3366
+ updatedAt?: string | undefined;
3294
3367
  designSystemName?: string | undefined;
3295
3368
  revision?: string | undefined;
3296
3369
  }>;
@@ -3307,14 +3380,14 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3307
3380
  updatedAt: z.ZodOptional<z.ZodString>;
3308
3381
  }, "strip", z.ZodTypeAny, {
3309
3382
  importPath?: string | undefined;
3310
- updatedAt?: string | undefined;
3311
3383
  packageName?: string | undefined;
3384
+ updatedAt?: string | undefined;
3312
3385
  designSystemName?: string | undefined;
3313
3386
  revision?: string | undefined;
3314
3387
  }, {
3315
3388
  importPath?: string | undefined;
3316
- updatedAt?: string | undefined;
3317
3389
  packageName?: string | undefined;
3390
+ updatedAt?: string | undefined;
3318
3391
  designSystemName?: string | undefined;
3319
3392
  revision?: string | undefined;
3320
3393
  }>>;
@@ -3585,9 +3658,9 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3585
3658
  importPath?: string | undefined;
3586
3659
  publicRef?: string | undefined;
3587
3660
  sourcePath?: string | undefined;
3661
+ packageName?: string | undefined;
3588
3662
  tier?: string | undefined;
3589
3663
  publicSlug?: string | null | undefined;
3590
- packageName?: string | undefined;
3591
3664
  isCanonical?: boolean | undefined;
3592
3665
  sourceRepoFullName?: string | undefined;
3593
3666
  parentComponentName?: string | undefined;
@@ -3635,6 +3708,7 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3635
3708
  accepts?: string[] | undefined;
3636
3709
  visibility?: "public" | "internal" | undefined;
3637
3710
  }[] | undefined;
3711
+ packageName?: string | undefined;
3638
3712
  tier?: string | undefined;
3639
3713
  publicSlug?: string | null | undefined;
3640
3714
  relations?: {
@@ -3644,7 +3718,6 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3644
3718
  componentId?: string | undefined;
3645
3719
  note?: string | undefined;
3646
3720
  }[] | undefined;
3647
- packageName?: string | undefined;
3648
3721
  isCanonical?: boolean | undefined;
3649
3722
  examples?: {
3650
3723
  name: string;
@@ -3876,9 +3949,9 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3876
3949
  importPath?: string | undefined;
3877
3950
  publicRef?: string | undefined;
3878
3951
  sourcePath?: string | undefined;
3952
+ packageName?: string | undefined;
3879
3953
  tier?: string | undefined;
3880
3954
  publicSlug?: string | null | undefined;
3881
- packageName?: string | undefined;
3882
3955
  isCanonical?: boolean | undefined;
3883
3956
  sourceRepoFullName?: string | undefined;
3884
3957
  parentComponentName?: string | undefined;
@@ -3886,8 +3959,8 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3886
3959
  }>;
3887
3960
  metadata: {
3888
3961
  importPath?: string | undefined;
3889
- updatedAt?: string | undefined;
3890
3962
  packageName?: string | undefined;
3963
+ updatedAt?: string | undefined;
3891
3964
  designSystemName?: string | undefined;
3892
3965
  revision?: string | undefined;
3893
3966
  };
@@ -3978,6 +4051,7 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3978
4051
  accepts?: string[] | undefined;
3979
4052
  visibility?: "public" | "internal" | undefined;
3980
4053
  }[] | undefined;
4054
+ packageName?: string | undefined;
3981
4055
  tier?: string | undefined;
3982
4056
  publicSlug?: string | null | undefined;
3983
4057
  relations?: {
@@ -3987,7 +4061,6 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3987
4061
  componentId?: string | undefined;
3988
4062
  note?: string | undefined;
3989
4063
  }[] | undefined;
3990
- packageName?: string | undefined;
3991
4064
  isCanonical?: boolean | undefined;
3992
4065
  examples?: {
3993
4066
  name: string;
@@ -4020,8 +4093,8 @@ declare const mcpSnapshotSchema: z.ZodObject<{
4020
4093
  capabilities: ("components" | "tokens" | "performance" | "blocks" | "graph")[];
4021
4094
  metadata?: {
4022
4095
  importPath?: string | undefined;
4023
- updatedAt?: string | undefined;
4024
4096
  packageName?: string | undefined;
4097
+ updatedAt?: string | undefined;
4025
4098
  designSystemName?: string | undefined;
4026
4099
  revision?: string | undefined;
4027
4100
  } | undefined;
@@ -5732,6 +5805,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5732
5805
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5733
5806
  }>, "many">>;
5734
5807
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5808
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5809
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
5810
+ packageName: z.ZodString;
5811
+ version: z.ZodOptional<z.ZodString>;
5812
+ digest: z.ZodOptional<z.ZodString>;
5813
+ }, "strip", z.ZodTypeAny, {
5814
+ packageName: string;
5815
+ version?: string | undefined;
5816
+ digest?: string | undefined;
5817
+ }, {
5818
+ packageName: string;
5819
+ version?: string | undefined;
5820
+ digest?: string | undefined;
5821
+ }>, "many">>;
5735
5822
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5736
5823
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5737
5824
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5750,6 +5837,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5750
5837
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5751
5838
  }>, "many">>;
5752
5839
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5840
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5841
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
5842
+ packageName: z.ZodString;
5843
+ version: z.ZodOptional<z.ZodString>;
5844
+ digest: z.ZodOptional<z.ZodString>;
5845
+ }, "strip", z.ZodTypeAny, {
5846
+ packageName: string;
5847
+ version?: string | undefined;
5848
+ digest?: string | undefined;
5849
+ }, {
5850
+ packageName: string;
5851
+ version?: string | undefined;
5852
+ digest?: string | undefined;
5853
+ }>, "many">>;
5753
5854
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5754
5855
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5755
5856
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5768,6 +5869,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5768
5869
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5769
5870
  }>, "many">>;
5770
5871
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5872
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5873
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
5874
+ packageName: z.ZodString;
5875
+ version: z.ZodOptional<z.ZodString>;
5876
+ digest: z.ZodOptional<z.ZodString>;
5877
+ }, "strip", z.ZodTypeAny, {
5878
+ packageName: string;
5879
+ version?: string | undefined;
5880
+ digest?: string | undefined;
5881
+ }, {
5882
+ packageName: string;
5883
+ version?: string | undefined;
5884
+ digest?: string | undefined;
5885
+ }>, "many">>;
5771
5886
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5772
5887
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5773
5888
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5786,6 +5901,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5786
5901
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5787
5902
  }>, "many">>;
5788
5903
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5904
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5905
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
5906
+ packageName: z.ZodString;
5907
+ version: z.ZodOptional<z.ZodString>;
5908
+ digest: z.ZodOptional<z.ZodString>;
5909
+ }, "strip", z.ZodTypeAny, {
5910
+ packageName: string;
5911
+ version?: string | undefined;
5912
+ digest?: string | undefined;
5913
+ }, {
5914
+ packageName: string;
5915
+ version?: string | undefined;
5916
+ digest?: string | undefined;
5917
+ }>, "many">>;
5789
5918
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5790
5919
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5791
5920
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5804,6 +5933,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5804
5933
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5805
5934
  }>, "many">>;
5806
5935
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5936
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5937
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
5938
+ packageName: z.ZodString;
5939
+ version: z.ZodOptional<z.ZodString>;
5940
+ digest: z.ZodOptional<z.ZodString>;
5941
+ }, "strip", z.ZodTypeAny, {
5942
+ packageName: string;
5943
+ version?: string | undefined;
5944
+ digest?: string | undefined;
5945
+ }, {
5946
+ packageName: string;
5947
+ version?: string | undefined;
5948
+ digest?: string | undefined;
5949
+ }>, "many">>;
5807
5950
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5808
5951
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5809
5952
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5998,6 +6141,104 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5998
6141
  registryHash?: string | undefined;
5999
6142
  receiptPath?: string | undefined;
6000
6143
  }>]>, "many">>;
6144
+ canonicalBridges: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
6145
+ underlying: z.ZodObject<{
6146
+ packageName: z.ZodString;
6147
+ exportName: z.ZodString;
6148
+ }, "strict", z.ZodTypeAny, {
6149
+ exportName: string;
6150
+ packageName: string;
6151
+ }, {
6152
+ exportName: string;
6153
+ packageName: string;
6154
+ }>;
6155
+ local: z.ZodObject<{
6156
+ componentKey: z.ZodString;
6157
+ moduleSpecifier: z.ZodEffects<z.ZodString, string, string>;
6158
+ exportName: z.ZodString;
6159
+ implementationFiles: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
6160
+ }, "strict", z.ZodTypeAny, {
6161
+ componentKey: string;
6162
+ exportName: string;
6163
+ moduleSpecifier: string;
6164
+ implementationFiles: string[];
6165
+ }, {
6166
+ componentKey: string;
6167
+ exportName: string;
6168
+ moduleSpecifier: string;
6169
+ implementationFiles: string[];
6170
+ }>;
6171
+ decision: z.ZodObject<{
6172
+ state: z.ZodLiteral<"confirmed">;
6173
+ source: z.ZodEnum<["authored", "migration"]>;
6174
+ }, "strict", z.ZodTypeAny, {
6175
+ state: "confirmed";
6176
+ source: "authored" | "migration";
6177
+ }, {
6178
+ state: "confirmed";
6179
+ source: "authored" | "migration";
6180
+ }>;
6181
+ }, "strict", z.ZodTypeAny, {
6182
+ underlying: {
6183
+ exportName: string;
6184
+ packageName: string;
6185
+ };
6186
+ local: {
6187
+ componentKey: string;
6188
+ exportName: string;
6189
+ moduleSpecifier: string;
6190
+ implementationFiles: string[];
6191
+ };
6192
+ decision: {
6193
+ state: "confirmed";
6194
+ source: "authored" | "migration";
6195
+ };
6196
+ }, {
6197
+ underlying: {
6198
+ exportName: string;
6199
+ packageName: string;
6200
+ };
6201
+ local: {
6202
+ componentKey: string;
6203
+ exportName: string;
6204
+ moduleSpecifier: string;
6205
+ implementationFiles: string[];
6206
+ };
6207
+ decision: {
6208
+ state: "confirmed";
6209
+ source: "authored" | "migration";
6210
+ };
6211
+ }>, "many">, {
6212
+ underlying: {
6213
+ exportName: string;
6214
+ packageName: string;
6215
+ };
6216
+ local: {
6217
+ componentKey: string;
6218
+ exportName: string;
6219
+ moduleSpecifier: string;
6220
+ implementationFiles: string[];
6221
+ };
6222
+ decision: {
6223
+ state: "confirmed";
6224
+ source: "authored" | "migration";
6225
+ };
6226
+ }[], {
6227
+ underlying: {
6228
+ exportName: string;
6229
+ packageName: string;
6230
+ };
6231
+ local: {
6232
+ componentKey: string;
6233
+ exportName: string;
6234
+ moduleSpecifier: string;
6235
+ implementationFiles: string[];
6236
+ };
6237
+ decision: {
6238
+ state: "confirmed";
6239
+ source: "authored" | "migration";
6240
+ };
6241
+ }[]>>;
6001
6242
  presets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6002
6243
  scales: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
6003
6244
  kind: z.ZodDefault<z.ZodLiteral<"scale">>;
@@ -6718,6 +6959,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6718
6959
  exclude?: string[] | undefined;
6719
6960
  registryHash?: string | undefined;
6720
6961
  })[] | undefined;
6962
+ canonicalBridges?: {
6963
+ underlying: {
6964
+ exportName: string;
6965
+ packageName: string;
6966
+ };
6967
+ local: {
6968
+ componentKey: string;
6969
+ exportName: string;
6970
+ moduleSpecifier: string;
6971
+ implementationFiles: string[];
6972
+ };
6973
+ decision: {
6974
+ state: "confirmed";
6975
+ source: "authored" | "migration";
6976
+ };
6977
+ }[] | undefined;
6721
6978
  presets?: string[] | undefined;
6722
6979
  agent?: z.objectOutputType<{
6723
6980
  repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -6892,6 +7149,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6892
7149
  registryHash?: string | undefined;
6893
7150
  receiptPath?: string | undefined;
6894
7151
  })[] | undefined;
7152
+ canonicalBridges?: {
7153
+ underlying: {
7154
+ exportName: string;
7155
+ packageName: string;
7156
+ };
7157
+ local: {
7158
+ componentKey: string;
7159
+ exportName: string;
7160
+ moduleSpecifier: string;
7161
+ implementationFiles: string[];
7162
+ };
7163
+ decision: {
7164
+ state: "confirmed";
7165
+ source: "authored" | "migration";
7166
+ };
7167
+ }[] | undefined;
6895
7168
  presets?: string[] | undefined;
6896
7169
  agent?: z.objectInputType<{
6897
7170
  repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -7156,6 +7429,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7156
7429
  exclude?: string[] | undefined;
7157
7430
  registryHash?: string | undefined;
7158
7431
  })[] | undefined;
7432
+ canonicalBridges?: {
7433
+ underlying: {
7434
+ exportName: string;
7435
+ packageName: string;
7436
+ };
7437
+ local: {
7438
+ componentKey: string;
7439
+ exportName: string;
7440
+ moduleSpecifier: string;
7441
+ implementationFiles: string[];
7442
+ };
7443
+ decision: {
7444
+ state: "confirmed";
7445
+ source: "authored" | "migration";
7446
+ };
7447
+ }[] | undefined;
7159
7448
  presets?: string[] | undefined;
7160
7449
  agent?: z.objectOutputType<{
7161
7450
  repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -7179,6 +7468,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7179
7468
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7180
7469
  }>, "many">>;
7181
7470
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7471
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7472
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
7473
+ packageName: z.ZodString;
7474
+ version: z.ZodOptional<z.ZodString>;
7475
+ digest: z.ZodOptional<z.ZodString>;
7476
+ }, "strip", z.ZodTypeAny, {
7477
+ packageName: string;
7478
+ version?: string | undefined;
7479
+ digest?: string | undefined;
7480
+ }, {
7481
+ packageName: string;
7482
+ version?: string | undefined;
7483
+ digest?: string | undefined;
7484
+ }>, "many">>;
7182
7485
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7183
7486
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7184
7487
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -7424,6 +7727,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7424
7727
  registryHash?: string | undefined;
7425
7728
  receiptPath?: string | undefined;
7426
7729
  })[] | undefined;
7730
+ canonicalBridges?: {
7731
+ underlying: {
7732
+ exportName: string;
7733
+ packageName: string;
7734
+ };
7735
+ local: {
7736
+ componentKey: string;
7737
+ exportName: string;
7738
+ moduleSpecifier: string;
7739
+ implementationFiles: string[];
7740
+ };
7741
+ decision: {
7742
+ state: "confirmed";
7743
+ source: "authored" | "migration";
7744
+ };
7745
+ }[] | undefined;
7427
7746
  presets?: string[] | undefined;
7428
7747
  agent?: z.objectInputType<{
7429
7748
  repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -7447,6 +7766,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7447
7766
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7448
7767
  }>, "many">>;
7449
7768
  packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7769
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7770
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
7771
+ packageName: z.ZodString;
7772
+ version: z.ZodOptional<z.ZodString>;
7773
+ digest: z.ZodOptional<z.ZodString>;
7774
+ }, "strip", z.ZodTypeAny, {
7775
+ packageName: string;
7776
+ version?: string | undefined;
7777
+ digest?: string | undefined;
7778
+ }, {
7779
+ packageName: string;
7780
+ version?: string | undefined;
7781
+ digest?: string | undefined;
7782
+ }>, "many">>;
7450
7783
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7451
7784
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7452
7785
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -11634,6 +11967,74 @@ declare function isEffectiveCanonicalSource(source: CanonicalSource): boolean;
11634
11967
  declare function hasEffectiveComponentVocabulary(options: Record<string, unknown> | undefined): boolean;
11635
11968
  declare function evaluateGovernanceIntegrity(input: GovernanceIntegrityInput): GovernanceIntegrityVerdict;
11636
11969
 
11970
+ interface CanonicalDirectionConflict {
11971
+ packageName: string;
11972
+ exportName: string;
11973
+ wrapperComponentKey: string;
11974
+ wrapperFile: string;
11975
+ wrapperExportName: string;
11976
+ state: "unresolved" | "sanctioned";
11977
+ }
11978
+ /**
11979
+ * Project exact, source-backed conflicts between an exported local wrapper and
11980
+ * an npm canonical export. Name similarity, prop overlap, and mixed render
11981
+ * trees are deliberately insufficient: this projection can deactivate policy.
11982
+ */
11983
+ declare function projectCanonicalDirectionConflicts(ix: FactIndex, canonicalSources: readonly CanonicalSource[]): CanonicalDirectionConflict[];
11984
+ declare function canonicalDirectionConflictsTarget(conflicts: readonly CanonicalDirectionConflict[], importPath: string | undefined, exportName: string): boolean;
11985
+
11986
+ declare function canonicalBridgeContractMappings(bridges: readonly CanonicalBridgeV1[] | undefined): ContractCanonicalMappingInput[];
11987
+
11988
+ declare const EFFECTIVE_GOVERNANCE_INPUTS_SCHEMA: "effective-governance-inputs:v1";
11989
+ interface EffectiveGovernanceInputsSourceState {
11990
+ declared: readonly string[];
11991
+ loadedDefinitions: number;
11992
+ diagnostics: readonly string[];
11993
+ catalog?: TokenCatalog;
11994
+ }
11995
+ interface CompileEffectiveGovernanceInputsOptions {
11996
+ policySource: "config" | "preset" | "fallback" | "none";
11997
+ configPath: string | null;
11998
+ configDigest: string | null;
11999
+ policy: GovernanceConfig | undefined;
12000
+ componentDefinitionFiles: readonly string[];
12001
+ tokens: EffectiveGovernanceInputsSourceState;
12002
+ eligibility: {
12003
+ include: readonly string[];
12004
+ exclude: readonly string[];
12005
+ };
12006
+ }
12007
+ interface EffectiveGovernanceInputs {
12008
+ schema: typeof EFFECTIVE_GOVERNANCE_INPUTS_SCHEMA;
12009
+ policySource: CompileEffectiveGovernanceInputsOptions["policySource"];
12010
+ config: {
12011
+ path: string | null;
12012
+ digest: string | null;
12013
+ };
12014
+ components: {
12015
+ canonicalSources: NonNullable<GovernanceConfig["canonicalSources"]>;
12016
+ canonicalBridges: NonNullable<GovernanceConfig["canonicalBridges"]>;
12017
+ definitionFiles: string[];
12018
+ };
12019
+ tokens: {
12020
+ declared: string[];
12021
+ loadedDefinitions: number;
12022
+ diagnostics: string[];
12023
+ catalog?: TokenCatalog;
12024
+ };
12025
+ eligibility: {
12026
+ include: string[];
12027
+ exclude: string[];
12028
+ };
12029
+ inputsHash: string;
12030
+ }
12031
+ /**
12032
+ * Compile one deterministic, post-authority account of the operational inputs
12033
+ * available to governance consumers. This is deliberately distinct from FCID
12034
+ * (enforced contract identity) and scopeHash (the files selected for one Run).
12035
+ */
12036
+ declare function compileEffectiveGovernanceInputs(options: CompileEffectiveGovernanceInputsOptions): EffectiveGovernanceInputs;
12037
+
11637
12038
  interface ComponentKeyInput {
11638
12039
  repoRelativeFile: string;
11639
12040
  exportName: string;
@@ -11643,4 +12044,4 @@ interface ComponentKeyInput {
11643
12044
  */
11644
12045
  declare function buildComponentKey({ repoRelativeFile, exportName }: ComponentKeyInput): string;
11645
12046
 
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 };
12047
+ 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 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 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, 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, 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 };