@usefragments/core 1.4.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 (72) hide show
  1. package/dist/{chunk-CBSNXFOD.js → chunk-AOG4FTV6.js} +146 -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-DxdJV6lx.d.ts → governance-B88uR3Zq.d.ts} +229 -1
  10. package/dist/{index-0lmh0Lbo.d.ts → index-DbkPE46t.d.ts} +48 -8
  11. package/dist/index.d.ts +779 -158
  12. package/dist/index.js +674 -127
  13. package/dist/index.js.map +1 -1
  14. package/dist/react-types.d.ts +1 -1
  15. package/dist/registry.d.ts +18 -18
  16. package/dist/schemas/index.d.ts +1 -1
  17. package/dist/schemas/index.js +1 -1
  18. package/dist/test-utils.d.ts +1 -1
  19. package/package.json +1 -1
  20. package/src/agent-format.test.ts +1 -0
  21. package/src/canonical-bridge.ts +46 -0
  22. package/src/canonical-direction.ts +118 -0
  23. package/src/codes/codes.ts +18 -0
  24. package/src/conform.ts +5 -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 +70 -2
  30. package/src/facts/compile.ts +20 -2
  31. package/src/facts/fact-index.ts +4 -0
  32. package/src/facts/facts.test.ts +30 -0
  33. package/src/facts/index.ts +6 -0
  34. package/src/facts/types.ts +86 -7
  35. package/src/governance-integrity.test.ts +22 -0
  36. package/src/governance-integrity.ts +10 -4
  37. package/src/governance.test.ts +93 -0
  38. package/src/governance.ts +76 -0
  39. package/src/identity/classify.test.ts +185 -0
  40. package/src/identity/classify.ts +257 -0
  41. package/src/identity/component-key.test.ts +32 -0
  42. package/src/identity/component-key.ts +35 -0
  43. package/src/identity/usage.ts +39 -0
  44. package/src/index.ts +48 -0
  45. package/src/rules/__tests__/fix-emission-invariant.test.ts +35 -4
  46. package/src/rules/components-prefer-library.test.ts +151 -0
  47. package/src/rules/components-prefer-library.ts +46 -4
  48. package/src/rules/components-shadow-component.test.ts +145 -0
  49. package/src/rules/components-shadow-component.ts +81 -0
  50. package/src/rules/fix-availability.ts +2 -0
  51. package/src/rules/index.ts +14 -0
  52. package/src/rules/jsx-preferred-import-path.ts +45 -9
  53. package/src/rules/rules.test.ts +202 -6
  54. package/src/rules/spacing-resolution.ts +2 -2
  55. package/src/rules/styles-no-raw-color.test.ts +6 -1
  56. package/src/rules/styles-no-raw-color.ts +3 -2
  57. package/src/rules/styles-no-raw-dimensions.ts +5 -7
  58. package/src/rules/styles-no-raw-spacing.ts +5 -2
  59. package/src/rules/styles-no-raw-typography.ts +7 -4
  60. package/src/rules/taxonomy.test.ts +19 -1
  61. package/src/rules/tiers.ts +9 -5
  62. package/src/rules/token-candidates.ts +36 -0
  63. package/src/rules/tokens-require-dual-fallback.ts +2 -1
  64. package/src/rules/tokens-upstream-drift.test.ts +111 -0
  65. package/src/rules/tokens-upstream-drift.ts +57 -0
  66. package/src/rules/utils.ts +22 -14
  67. package/src/schema.ts +28 -0
  68. package/src/schemas/index.ts +5 -8
  69. package/src/token-types.ts +71 -1
  70. package/src/types.ts +18 -0
  71. package/dist/chunk-57QDBEHQ.js.map +0 -1
  72. package/dist/chunk-CBSNXFOD.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-0lmh0Lbo.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-0lmh0Lbo.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-DxdJV6lx.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-DxdJV6lx.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';
@@ -120,6 +120,11 @@ interface ConformInput {
120
120
  filename?: string;
121
121
  /** deterministic (default) applies safe edits; none returns findings only. */
122
122
  apply?: "deterministic" | "none";
123
+ /** Explicit request to consolidate a known shadow into its canonical root. */
124
+ shadowConsolidation?: {
125
+ shadow: string;
126
+ canonicalTarget?: string;
127
+ };
123
128
  }
124
129
  interface ConformLocation {
125
130
  line?: number;
@@ -568,6 +573,145 @@ declare const catalogFixtureATokensDtcg: {
568
573
  };
569
574
  };
570
575
 
576
+ type RawHtmlPrecisionTier = "exact-html" | "html-advisory" | "input-type" | "role-reimpl" | "interactive-nonsemantic" | "icon-only";
577
+ interface RawHtmlCanonicalMatch {
578
+ canonical: string;
579
+ tier: RawHtmlPrecisionTier;
580
+ }
581
+ declare const RAW_HTML_CANONICAL_TAGS: readonly {
582
+ tagName: string;
583
+ canonical: string;
584
+ tier: "exact-html";
585
+ }[];
586
+ declare const RAW_HTML_ADVISORY_TAGS: readonly {
587
+ tagName: string;
588
+ canonical: string;
589
+ tier: "html-advisory";
590
+ }[];
591
+ declare const RAW_HTML_INPUT_TYPE_CANONICALS: readonly {
592
+ type: string;
593
+ canonical: string;
594
+ tier: "input-type";
595
+ }[];
596
+ declare const RAW_HTML_ROLE_CANONICALS: readonly {
597
+ role: string;
598
+ canonical: string;
599
+ tier: "role-reimpl";
600
+ }[];
601
+ declare function resolveCanonicalForRawHtml(tagName: string, inputType?: string): RawHtmlCanonicalMatch | null;
602
+ declare function resolveCanonicalForAriaRole(role: string): RawHtmlCanonicalMatch | null;
603
+ declare function isRawHtmlAdvisoryTier(tier: RawHtmlPrecisionTier): boolean;
604
+ /**
605
+ * Decide whether a per-component `htmlEquivalent` mapping (raw `tag` → a
606
+ * `canonical` component) may drive a bare-tag canonical-usage finding.
607
+ *
608
+ * The contract:
609
+ * - Low-frequency SEMANTIC tags (dialog, select, textarea, input, …) are always
610
+ * enforceable, so a custom-named component (`<dialog>` → Modal) still maps.
611
+ * - Common/ambiguous tags (button, a, …) enforce ONLY when the mapping AGREES
612
+ * with the framework's curated canonical for that tag — so `<button>` → Button
613
+ * fires, but `<button>` → Chip does not.
614
+ * - Generic structural containers (div, span) have no curated answer and are not
615
+ * semantic → never enforce.
616
+ *
617
+ * This is the guard that stops the canonical-usage flood: a library component
618
+ * being built on a `<div>` must not make every `<div>` a bespoke re-implementation
619
+ * of it (every `<div>` → Accordion, every `<span>` → Badge, every `<button>` → Chip).
620
+ */
621
+ declare function isEnforceableHtmlEquivalent(args: {
622
+ tag: string;
623
+ canonical: string;
624
+ inputType?: string;
625
+ /**
626
+ * The mapping is an EXPLICIT project declaration of this tag → component
627
+ * (provenance: `localCanonical.resolves`), not a low-confidence inferred
628
+ * `htmlEquivalent`. Explicit declarations enforce a specific interactive tag
629
+ * (`button`/`a`) against any canonical NAME — the agnosticism path — while
630
+ * inferred mappings stay name-gated to the curated canonical (the flood
631
+ * guard). Generic containers (`div`/`span`) are never enforceable even when
632
+ * explicit.
633
+ */
634
+ explicit?: boolean;
635
+ }): boolean;
636
+
637
+ type IdentityState = "canonical" | "variant" | "shadow" | "composite" | "external" | "unresolved";
638
+ type IdentityConfidence = "confirmed" | "likely" | "review";
639
+ interface CanonicalIdentityReference {
640
+ componentKey: string;
641
+ role: string;
642
+ }
643
+ interface LocalIdentityReference {
644
+ componentKey: string;
645
+ exportName: string;
646
+ }
647
+ interface ExternalIdentityReference {
648
+ localName: string;
649
+ source: string;
650
+ }
651
+ interface ResolvedIntrinsicIdentityRoot {
652
+ kind: "intrinsic";
653
+ tag: string;
654
+ hasRole: boolean;
655
+ interactive: boolean;
656
+ role?: string;
657
+ inputType?: string;
658
+ precisionTier?: RawHtmlPrecisionTier;
659
+ canonicalTargets: readonly CanonicalIdentityReference[];
660
+ }
661
+ type ResolvedIdentityRenderRoot = {
662
+ kind: "canonical";
663
+ localName: string;
664
+ target: CanonicalIdentityReference;
665
+ } | ResolvedIntrinsicIdentityRoot | {
666
+ kind: "external";
667
+ localName: string;
668
+ source: string;
669
+ } | {
670
+ kind: "mixed";
671
+ canonicalTargets: readonly CanonicalIdentityReference[];
672
+ localTargets: readonly LocalIdentityReference[];
673
+ externalTargets: readonly ExternalIdentityReference[];
674
+ intrinsics: readonly ResolvedIntrinsicIdentityRoot[];
675
+ unresolvedNames: readonly string[];
676
+ } | {
677
+ kind: "unresolved";
678
+ reason: string;
679
+ };
680
+ interface IdentityDecision {
681
+ componentKey: string;
682
+ decision: "sanctioned-wrapper" | "rejected-wrapper";
683
+ canonicalTarget?: string;
684
+ decisionId?: string;
685
+ }
686
+ interface ClassifyIdentityInput {
687
+ definition: {
688
+ componentKey: string;
689
+ exportName: string;
690
+ canonical: boolean;
691
+ };
692
+ renderRoot: ResolvedIdentityRenderRoot;
693
+ propSurfaceOverlap?: number;
694
+ stylingOwnership?: "visual-role" | "layout-only" | "none" | "unknown";
695
+ usageCounts?: {
696
+ importers?: number;
697
+ callSites?: number;
698
+ nestedElements?: number;
699
+ staticTextChildren?: number;
700
+ };
701
+ decisions?: readonly IdentityDecision[];
702
+ nameSimilarityTargets?: readonly string[];
703
+ }
704
+ interface IdentityClassification {
705
+ state: IdentityState;
706
+ confidence: IdentityConfidence;
707
+ canonicalTarget?: string;
708
+ }
709
+ /**
710
+ * Classify already-resolved identity evidence. AST and filesystem concerns stay
711
+ * in the extractor; this function is deterministic and browser-safe.
712
+ */
713
+ declare function classifyIdentity(input: ClassifyIdentityInput): IdentityClassification;
714
+
571
715
  /**
572
716
  * Fact IR — discriminated union of governance facts.
573
717
  *
@@ -715,6 +859,14 @@ interface JsxImportPathPreferredFact extends BaseFact {
715
859
  imported?: string;
716
860
  because?: string;
717
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
+ };
718
870
  }
719
871
  interface JsxComponentPreferredFact extends BaseFact {
720
872
  kind: "jsx_component_preferred";
@@ -726,7 +878,9 @@ interface JsxComponentPreferredFact extends BaseFact {
726
878
  /**
727
879
  * A design token from the system. Used by fixes (e.g., raw color → token
728
880
  * substitution) and rules that need to know the token vocabulary. Identity is
729
- * 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.
730
884
  */
731
885
  interface TokenDefinitionFact extends BaseFact {
732
886
  kind: "token_definition";
@@ -741,14 +895,21 @@ interface TokenDefinitionFact extends BaseFact {
741
895
  * How the token is referenced from authored styles, inferred from its source.
742
896
  * Governs whether a "use the token" fix can be *applied* automatically: a
743
897
  * `css-var`/`scss-var` reference resolves verbatim, but a `scss-map` member
744
- * (`$colors-primary` minted from a Sass map) or a `dtcg` JSON token (no CSS
745
- * custom property emitted) does not those are surfaced as suggestions, not
746
- * deterministic rewrites, so the fixer never writes non-compiling output.
747
- * 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.
748
904
  */
749
- referenceFormat?: "css-var" | "scss-var" | "scss-map" | "dtcg";
905
+ referenceFormat?: "css-var" | "scss-var" | "scss-map" | "dtcg" | "js-member";
750
906
  /** Original authored spellings retained before parser normalization. */
751
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;
752
913
  }
753
914
  interface TailwindPaletteAllowFact extends BaseFact {
754
915
  kind: "tailwind_palette_allow";
@@ -1023,10 +1184,58 @@ interface CanonicalReplacementFact extends BaseFact {
1023
1184
  confidence: number;
1024
1185
  location?: FactLocation;
1025
1186
  }
1187
+ type ComponentDefinitionRenderRoot = {
1188
+ resolution: "canonical";
1189
+ canonical: string;
1190
+ importSource: string;
1191
+ } | {
1192
+ resolution: "intrinsic";
1193
+ tag: string;
1194
+ role?: string;
1195
+ interactive?: boolean;
1196
+ } | {
1197
+ resolution: "mixed";
1198
+ canonicals: string[];
1199
+ intrinsics: string[];
1200
+ } | {
1201
+ resolution: "external";
1202
+ importSource: string;
1203
+ } | {
1204
+ resolution: "unresolved";
1205
+ reason: string;
1206
+ };
1207
+ interface ComponentDefinitionFact extends BaseFact {
1208
+ kind: "component_definition";
1209
+ /** Index-compatible projection of `componentKey`. */
1210
+ componentId: ComponentId;
1211
+ file: string;
1212
+ exportName: string;
1213
+ /** Whether this definition is reachable through an authored ESM export. */
1214
+ exported: boolean;
1215
+ componentKey: string;
1216
+ renderRoot: ComponentDefinitionRenderRoot;
1217
+ propSurface: string[];
1218
+ stylingChannel?: {
1219
+ module: string;
1220
+ ownsVisualRole: boolean;
1221
+ };
1222
+ }
1223
+ interface ComponentIdentityFact extends BaseFact {
1224
+ kind: "component_identity";
1225
+ /** Index-compatible projection of `componentKey`. */
1226
+ componentId: ComponentId;
1227
+ componentKey: string;
1228
+ state: IdentityState;
1229
+ confidence: IdentityConfidence;
1230
+ canonicalTarget?: string;
1231
+ decisionId?: string;
1232
+ evidence: FactId[];
1233
+ }
1026
1234
  type ComponentLevelFact = ComponentMetadataFact | ComponentCapabilityFact | PropMetadataFact;
1027
1235
  type PolicyFact = PropValueAvoidedFact | PropValueForbiddenFact | A11yNameRequiredFact | ScaleFact | ScaleValueFact | StyleRawColorForbiddenFact | StyleRawDimensionForbiddenFact | StylePropertyScaleFact | StyleFontSizeScaleFact | StyleCssVarsMustBeDefinedFact | ContractTokenFact | JsxUnknownPropsForbiddenFact | JsxInlineStyleForbiddenRawFact | JsxImportPathPreferredFact | JsxComponentPreferredFact | TokenDefinitionFact | TailwindPaletteAllowFact | TailwindPaletteDenyFact | TailwindUnknownClassEnabledFact | GovernanceRuleConfigFact;
1028
1236
  type UsageFact = UsageNodeFact | UsageComponentFact | UsageImportFact | UsagePropResolvedFact | UsageInlineStyleFact | UsageTextChildFact | StyleDeclarationFact | StyleUnsupportedFact | ClassNameLiteralFact | ClassNameDynamicFact | TailwindClassFact | ThemeDeclarationFact | SuppressionDirectiveFact | TailwindTokenResolvedFact | CanonicalCandidateFact | CanonicalMappingFact | StructuralConfidenceFact | CanonicalReplacementFact;
1029
- type Fact = ComponentLevelFact | PolicyFact | UsageFact;
1237
+ type IdentityFact = ComponentDefinitionFact | ComponentIdentityFact;
1238
+ type Fact = ComponentLevelFact | PolicyFact | UsageFact | IdentityFact;
1030
1239
  type FactKind = Fact["kind"];
1031
1240
  /** Narrows a Fact union by kind. */
1032
1241
  type FactOfKind<K extends FactKind> = Extract<Fact, {
@@ -1076,6 +1285,23 @@ declare function makeComponentCapabilityFact(input: {
1076
1285
  componentId: ComponentId;
1077
1286
  capability: string;
1078
1287
  }): ComponentCapabilityFact;
1288
+ declare function makeComponentDefinitionFact(input: {
1289
+ file: string;
1290
+ exportName: string;
1291
+ exported?: boolean;
1292
+ componentKey: string;
1293
+ renderRoot: ComponentDefinitionFact["renderRoot"];
1294
+ propSurface: string[];
1295
+ stylingChannel?: ComponentDefinitionFact["stylingChannel"];
1296
+ }): ComponentDefinitionFact;
1297
+ declare function makeComponentIdentityFact(input: {
1298
+ componentKey: string;
1299
+ state: ComponentIdentityFact["state"];
1300
+ confidence: ComponentIdentityFact["confidence"];
1301
+ canonicalTarget?: string;
1302
+ decisionId?: string;
1303
+ evidence: FactId[];
1304
+ }): ComponentIdentityFact;
1079
1305
  declare function makeCanonicalCandidateFact(input: {
1080
1306
  componentId: ComponentId;
1081
1307
  canonical: string;
@@ -1183,6 +1409,7 @@ declare function makeJsxImportPathPreferredFact(input: {
1183
1409
  imported?: string;
1184
1410
  because?: string;
1185
1411
  severity: GovernanceSeverity;
1412
+ bridge?: JsxImportPathPreferredFact["bridge"];
1186
1413
  }): JsxImportPathPreferredFact;
1187
1414
  declare function makeJsxComponentPreferredFact(input: {
1188
1415
  from: ComponentId;
@@ -1197,6 +1424,10 @@ declare function makeTokenDefinitionFact(input: {
1197
1424
  category?: TokenDefinitionFact["category"];
1198
1425
  referenceFormat?: TokenDefinitionFact["referenceFormat"];
1199
1426
  sourceNames?: TokenDefinitionFact["sourceNames"];
1427
+ role?: TokenDefinitionFact["role"];
1428
+ authority?: TokenDefinitionFact["authority"];
1429
+ sourceIdentity?: TokenDefinitionFact["sourceIdentity"];
1430
+ upstreamName?: TokenDefinitionFact["upstreamName"];
1200
1431
  }): TokenDefinitionFact;
1201
1432
  declare function makeTailwindPaletteAllowFact(input: {
1202
1433
  patterns: string[];
@@ -1524,6 +1755,52 @@ declare function budgetBar(percent: number, width?: number): string;
1524
1755
  * Token categories for grouping and filtering
1525
1756
  */
1526
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
+ }
1527
1804
  /**
1528
1805
  * A single design token (CSS custom property)
1529
1806
  */
@@ -1552,7 +1829,7 @@ interface DesignToken {
1552
1829
  /** Source file where this token was defined */
1553
1830
  sourceFile: string;
1554
1831
  /** Authored reference form, when the parser can prove it from the source. */
1555
- referenceFormat?: "css-var" | "scss-var" | "scss-map" | "dtcg";
1832
+ referenceFormat?: "css-var" | "scss-var" | "scss-map" | "dtcg" | "js-member";
1556
1833
  /** Authored spellings preserved before normalization (for example `$x` and `--x`). */
1557
1834
  sourceNames?: string[];
1558
1835
  /** Line number in source file */
@@ -1651,6 +1928,8 @@ interface TokenParseResult {
1651
1928
  warnings: string[];
1652
1929
  /** Parse time in ms */
1653
1930
  parseTimeMs: number;
1931
+ /** The shared catalog used to produce `tokens`. Additive for compatibility. */
1932
+ catalog?: TokenCatalog;
1654
1933
  }
1655
1934
  /**
1656
1935
  * Error during token parsing
@@ -1788,8 +2067,8 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
1788
2067
  componentId: string;
1789
2068
  name: string;
1790
2069
  }[];
2070
+ tier: "core" | "composition";
1791
2071
  publicSlug: string | null;
1792
- tier: "composition" | "core";
1793
2072
  propCount: number;
1794
2073
  hasExamples: boolean;
1795
2074
  hasCompoundChildren: boolean;
@@ -1809,8 +2088,8 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
1809
2088
  componentId: string;
1810
2089
  name: string;
1811
2090
  }[];
2091
+ tier: "core" | "composition";
1812
2092
  publicSlug: string | null;
1813
- tier: "composition" | "core";
1814
2093
  propCount: number;
1815
2094
  hasExamples: boolean;
1816
2095
  hasCompoundChildren: boolean;
@@ -1918,8 +2197,8 @@ declare const bundleManifestSchema: z.ZodObject<{
1918
2197
  componentId: string;
1919
2198
  name: string;
1920
2199
  }[];
2200
+ tier: "core" | "composition";
1921
2201
  publicSlug: string | null;
1922
- tier: "composition" | "core";
1923
2202
  propCount: number;
1924
2203
  hasExamples: boolean;
1925
2204
  hasCompoundChildren: boolean;
@@ -1939,8 +2218,8 @@ declare const bundleManifestSchema: z.ZodObject<{
1939
2218
  componentId: string;
1940
2219
  name: string;
1941
2220
  }[];
2221
+ tier: "core" | "composition";
1942
2222
  publicSlug: string | null;
1943
- tier: "composition" | "core";
1944
2223
  propCount: number;
1945
2224
  hasExamples: boolean;
1946
2225
  hasCompoundChildren: boolean;
@@ -1962,8 +2241,8 @@ declare const bundleManifestSchema: z.ZodObject<{
1962
2241
  componentId: string;
1963
2242
  name: string;
1964
2243
  }[];
2244
+ tier: "core" | "composition";
1965
2245
  publicSlug: string | null;
1966
- tier: "composition" | "core";
1967
2246
  propCount: number;
1968
2247
  hasExamples: boolean;
1969
2248
  hasCompoundChildren: boolean;
@@ -2008,8 +2287,8 @@ declare const bundleManifestSchema: z.ZodObject<{
2008
2287
  componentId: string;
2009
2288
  name: string;
2010
2289
  }[];
2290
+ tier: "core" | "composition";
2011
2291
  publicSlug: string | null;
2012
- tier: "composition" | "core";
2013
2292
  propCount: number;
2014
2293
  hasExamples: boolean;
2015
2294
  hasCompoundChildren: boolean;
@@ -2212,8 +2491,8 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2212
2491
  name: string;
2213
2492
  }[];
2214
2493
  source: "design-system";
2494
+ tier: "core" | "composition";
2215
2495
  publicSlug: string | null;
2216
- tier: "composition" | "core";
2217
2496
  relations: Record<string, unknown>[];
2218
2497
  publicId: string | null;
2219
2498
  usageGuidance: string;
@@ -2238,8 +2517,8 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2238
2517
  name: string;
2239
2518
  }[];
2240
2519
  source: "design-system";
2520
+ tier: "core" | "composition";
2241
2521
  publicSlug: string | null;
2242
- tier: "composition" | "core";
2243
2522
  relations: Record<string, unknown>[];
2244
2523
  publicId: string | null;
2245
2524
  usageGuidance: string;
@@ -2269,8 +2548,8 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2269
2548
  name: string;
2270
2549
  }[];
2271
2550
  source: "design-system";
2551
+ tier: "core" | "composition";
2272
2552
  publicSlug: string | null;
2273
- tier: "composition" | "core";
2274
2553
  relations: Record<string, unknown>[];
2275
2554
  publicId: string | null;
2276
2555
  usageGuidance: string;
@@ -2302,8 +2581,8 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2302
2581
  name: string;
2303
2582
  }[];
2304
2583
  source: "design-system";
2584
+ tier: "core" | "composition";
2305
2585
  publicSlug: string | null;
2306
- tier: "composition" | "core";
2307
2586
  relations: Record<string, unknown>[];
2308
2587
  publicId: string | null;
2309
2588
  usageGuidance: string;
@@ -2850,9 +3129,9 @@ declare const mcpComponentSchema: z.ZodObject<{
2850
3129
  importPath?: string | undefined;
2851
3130
  publicRef?: string | undefined;
2852
3131
  sourcePath?: string | undefined;
2853
- publicSlug?: string | null | undefined;
2854
- tier?: string | undefined;
2855
3132
  packageName?: string | undefined;
3133
+ tier?: string | undefined;
3134
+ publicSlug?: string | null | undefined;
2856
3135
  isCanonical?: boolean | undefined;
2857
3136
  sourceRepoFullName?: string | undefined;
2858
3137
  parentComponentName?: string | undefined;
@@ -2900,8 +3179,9 @@ declare const mcpComponentSchema: z.ZodObject<{
2900
3179
  accepts?: string[] | undefined;
2901
3180
  visibility?: "public" | "internal" | undefined;
2902
3181
  }[] | undefined;
2903
- publicSlug?: string | null | undefined;
3182
+ packageName?: string | undefined;
2904
3183
  tier?: string | undefined;
3184
+ publicSlug?: string | null | undefined;
2905
3185
  relations?: {
2906
3186
  componentName: string;
2907
3187
  relationship: string;
@@ -2909,7 +3189,6 @@ declare const mcpComponentSchema: z.ZodObject<{
2909
3189
  componentId?: string | undefined;
2910
3190
  note?: string | undefined;
2911
3191
  }[] | undefined;
2912
- packageName?: string | undefined;
2913
3192
  isCanonical?: boolean | undefined;
2914
3193
  examples?: {
2915
3194
  name: string;
@@ -3077,14 +3356,14 @@ declare const mcpSnapshotMetadataSchema: z.ZodObject<{
3077
3356
  updatedAt: z.ZodOptional<z.ZodString>;
3078
3357
  }, "strip", z.ZodTypeAny, {
3079
3358
  importPath?: string | undefined;
3080
- updatedAt?: string | undefined;
3081
3359
  packageName?: string | undefined;
3360
+ updatedAt?: string | undefined;
3082
3361
  designSystemName?: string | undefined;
3083
3362
  revision?: string | undefined;
3084
3363
  }, {
3085
3364
  importPath?: string | undefined;
3086
- updatedAt?: string | undefined;
3087
3365
  packageName?: string | undefined;
3366
+ updatedAt?: string | undefined;
3088
3367
  designSystemName?: string | undefined;
3089
3368
  revision?: string | undefined;
3090
3369
  }>;
@@ -3101,14 +3380,14 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3101
3380
  updatedAt: z.ZodOptional<z.ZodString>;
3102
3381
  }, "strip", z.ZodTypeAny, {
3103
3382
  importPath?: string | undefined;
3104
- updatedAt?: string | undefined;
3105
3383
  packageName?: string | undefined;
3384
+ updatedAt?: string | undefined;
3106
3385
  designSystemName?: string | undefined;
3107
3386
  revision?: string | undefined;
3108
3387
  }, {
3109
3388
  importPath?: string | undefined;
3110
- updatedAt?: string | undefined;
3111
3389
  packageName?: string | undefined;
3390
+ updatedAt?: string | undefined;
3112
3391
  designSystemName?: string | undefined;
3113
3392
  revision?: string | undefined;
3114
3393
  }>>;
@@ -3379,9 +3658,9 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3379
3658
  importPath?: string | undefined;
3380
3659
  publicRef?: string | undefined;
3381
3660
  sourcePath?: string | undefined;
3382
- publicSlug?: string | null | undefined;
3383
- tier?: string | undefined;
3384
3661
  packageName?: string | undefined;
3662
+ tier?: string | undefined;
3663
+ publicSlug?: string | null | undefined;
3385
3664
  isCanonical?: boolean | undefined;
3386
3665
  sourceRepoFullName?: string | undefined;
3387
3666
  parentComponentName?: string | undefined;
@@ -3429,8 +3708,9 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3429
3708
  accepts?: string[] | undefined;
3430
3709
  visibility?: "public" | "internal" | undefined;
3431
3710
  }[] | undefined;
3432
- publicSlug?: string | null | undefined;
3711
+ packageName?: string | undefined;
3433
3712
  tier?: string | undefined;
3713
+ publicSlug?: string | null | undefined;
3434
3714
  relations?: {
3435
3715
  componentName: string;
3436
3716
  relationship: string;
@@ -3438,7 +3718,6 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3438
3718
  componentId?: string | undefined;
3439
3719
  note?: string | undefined;
3440
3720
  }[] | undefined;
3441
- packageName?: string | undefined;
3442
3721
  isCanonical?: boolean | undefined;
3443
3722
  examples?: {
3444
3723
  name: string;
@@ -3670,9 +3949,9 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3670
3949
  importPath?: string | undefined;
3671
3950
  publicRef?: string | undefined;
3672
3951
  sourcePath?: string | undefined;
3673
- publicSlug?: string | null | undefined;
3674
- tier?: string | undefined;
3675
3952
  packageName?: string | undefined;
3953
+ tier?: string | undefined;
3954
+ publicSlug?: string | null | undefined;
3676
3955
  isCanonical?: boolean | undefined;
3677
3956
  sourceRepoFullName?: string | undefined;
3678
3957
  parentComponentName?: string | undefined;
@@ -3680,8 +3959,8 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3680
3959
  }>;
3681
3960
  metadata: {
3682
3961
  importPath?: string | undefined;
3683
- updatedAt?: string | undefined;
3684
3962
  packageName?: string | undefined;
3963
+ updatedAt?: string | undefined;
3685
3964
  designSystemName?: string | undefined;
3686
3965
  revision?: string | undefined;
3687
3966
  };
@@ -3772,8 +4051,9 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3772
4051
  accepts?: string[] | undefined;
3773
4052
  visibility?: "public" | "internal" | undefined;
3774
4053
  }[] | undefined;
3775
- publicSlug?: string | null | undefined;
4054
+ packageName?: string | undefined;
3776
4055
  tier?: string | undefined;
4056
+ publicSlug?: string | null | undefined;
3777
4057
  relations?: {
3778
4058
  componentName: string;
3779
4059
  relationship: string;
@@ -3781,7 +4061,6 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3781
4061
  componentId?: string | undefined;
3782
4062
  note?: string | undefined;
3783
4063
  }[] | undefined;
3784
- packageName?: string | undefined;
3785
4064
  isCanonical?: boolean | undefined;
3786
4065
  examples?: {
3787
4066
  name: string;
@@ -3814,8 +4093,8 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3814
4093
  capabilities: ("components" | "tokens" | "performance" | "blocks" | "graph")[];
3815
4094
  metadata?: {
3816
4095
  importPath?: string | undefined;
3817
- updatedAt?: string | undefined;
3818
4096
  packageName?: string | undefined;
4097
+ updatedAt?: string | undefined;
3819
4098
  designSystemName?: string | undefined;
3820
4099
  revision?: string | undefined;
3821
4100
  } | undefined;
@@ -5526,6 +5805,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5526
5805
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5527
5806
  }>, "many">>;
5528
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">>;
5529
5822
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5530
5823
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5531
5824
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5544,6 +5837,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5544
5837
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5545
5838
  }>, "many">>;
5546
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">>;
5547
5854
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5548
5855
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5549
5856
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5562,6 +5869,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5562
5869
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5563
5870
  }>, "many">>;
5564
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">>;
5565
5886
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5566
5887
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5567
5888
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5580,6 +5901,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5580
5901
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5581
5902
  }>, "many">>;
5582
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">>;
5583
5918
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5584
5919
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5585
5920
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5598,6 +5933,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5598
5933
  format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
5599
5934
  }>, "many">>;
5600
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">>;
5601
5950
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5602
5951
  themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
5603
5952
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -5792,6 +6141,104 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5792
6141
  registryHash?: string | undefined;
5793
6142
  receiptPath?: string | undefined;
5794
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
+ }[]>>;
5795
6242
  presets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
5796
6243
  scales: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
5797
6244
  kind: z.ZodDefault<z.ZodLiteral<"scale">>;
@@ -6512,6 +6959,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6512
6959
  exclude?: string[] | undefined;
6513
6960
  registryHash?: string | undefined;
6514
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;
6515
6978
  presets?: string[] | undefined;
6516
6979
  agent?: z.objectOutputType<{
6517
6980
  repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -6686,6 +7149,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6686
7149
  registryHash?: string | undefined;
6687
7150
  receiptPath?: string | undefined;
6688
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;
6689
7168
  presets?: string[] | undefined;
6690
7169
  agent?: z.objectInputType<{
6691
7170
  repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -6745,34 +7224,44 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6745
7224
  }> | undefined;
6746
7225
  }>>;
6747
7226
  recognizedClassHelpers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6748
- }, "strip", z.ZodTypeAny, {
6749
- components?: string[] | undefined;
6750
- screenshots?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
6751
- tokens?: z.objectOutputType<{
6752
- include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
6753
- sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
6754
- path: z.ZodEffects<z.ZodString, string, string>;
6755
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7227
+ identity: z.ZodOptional<z.ZodObject<{
7228
+ decisions: z.ZodOptional<z.ZodArray<z.ZodObject<{
7229
+ component: z.ZodString;
7230
+ kind: z.ZodEnum<["sanction", "reject", "dismiss"]>;
7231
+ canonicalTarget: z.ZodOptional<z.ZodString>;
7232
+ reason: z.ZodOptional<z.ZodString>;
7233
+ decisionId: z.ZodOptional<z.ZodString>;
6756
7234
  }, "strip", z.ZodTypeAny, {
6757
- path: string;
6758
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7235
+ kind: "sanction" | "reject" | "dismiss";
7236
+ component: string;
7237
+ reason?: string | undefined;
7238
+ canonicalTarget?: string | undefined;
7239
+ decisionId?: string | undefined;
6759
7240
  }, {
6760
- path: string;
6761
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7241
+ kind: "sanction" | "reject" | "dismiss";
7242
+ component: string;
7243
+ reason?: string | undefined;
7244
+ canonicalTarget?: string | undefined;
7245
+ decisionId?: string | undefined;
6762
7246
  }>, "many">>;
6763
- packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6764
- exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
6765
- themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6766
- enabled: z.ZodOptional<z.ZodBoolean>;
6767
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
6768
- namespace: z.ZodOptional<z.ZodString>;
6769
- }, z.ZodTypeAny, "passthrough"> | undefined;
6770
- performance?: "strict" | "relaxed" | "standard" | {
6771
- preset?: "strict" | "relaxed" | "standard" | undefined;
6772
- budgets?: {
6773
- bundleSize?: number | undefined;
6774
- } | undefined;
6775
- } | undefined;
7247
+ }, "strip", z.ZodTypeAny, {
7248
+ decisions?: {
7249
+ kind: "sanction" | "reject" | "dismiss";
7250
+ component: string;
7251
+ reason?: string | undefined;
7252
+ canonicalTarget?: string | undefined;
7253
+ decisionId?: string | undefined;
7254
+ }[] | undefined;
7255
+ }, {
7256
+ decisions?: {
7257
+ kind: "sanction" | "reject" | "dismiss";
7258
+ component: string;
7259
+ reason?: string | undefined;
7260
+ canonicalTarget?: string | undefined;
7261
+ decisionId?: string | undefined;
7262
+ }[] | undefined;
7263
+ }>>;
7264
+ }, "strip", z.ZodTypeAny, {
6776
7265
  govern?: {
6777
7266
  components?: Record<string, {
6778
7267
  rules: ({
@@ -6940,6 +7429,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6940
7429
  exclude?: string[] | undefined;
6941
7430
  registryHash?: string | undefined;
6942
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;
6943
7448
  presets?: string[] | undefined;
6944
7449
  agent?: z.objectOutputType<{
6945
7450
  repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -6948,6 +7453,47 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6948
7453
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
6949
7454
  }, z.ZodTypeAny, "passthrough"> | undefined;
6950
7455
  } | undefined;
7456
+ components?: string[] | undefined;
7457
+ screenshots?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
7458
+ tokens?: z.objectOutputType<{
7459
+ include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7460
+ sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
7461
+ path: z.ZodEffects<z.ZodString, string, string>;
7462
+ format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7463
+ }, "strip", z.ZodTypeAny, {
7464
+ path: string;
7465
+ format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7466
+ }, {
7467
+ path: string;
7468
+ format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7469
+ }>, "many">>;
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">>;
7485
+ exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7486
+ themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7487
+ enabled: z.ZodOptional<z.ZodBoolean>;
7488
+ format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7489
+ namespace: z.ZodOptional<z.ZodString>;
7490
+ }, z.ZodTypeAny, "passthrough"> | undefined;
7491
+ performance?: "strict" | "relaxed" | "standard" | {
7492
+ preset?: "strict" | "relaxed" | "standard" | undefined;
7493
+ budgets?: {
7494
+ bundleSize?: number | undefined;
7495
+ } | undefined;
7496
+ } | undefined;
6951
7497
  include?: string[] | undefined;
6952
7498
  exclude?: string[] | undefined;
6953
7499
  registry?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
@@ -7004,34 +7550,16 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7004
7550
  }> | undefined;
7005
7551
  } | undefined;
7006
7552
  recognizedClassHelpers?: string[] | undefined;
7007
- }, {
7008
- components?: string[] | undefined;
7009
- screenshots?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
7010
- tokens?: z.objectInputType<{
7011
- include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7012
- sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
7013
- path: z.ZodEffects<z.ZodString, string, string>;
7014
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7015
- }, "strip", z.ZodTypeAny, {
7016
- path: string;
7017
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7018
- }, {
7019
- path: string;
7020
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7021
- }>, "many">>;
7022
- packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7023
- exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7024
- themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7025
- enabled: z.ZodOptional<z.ZodBoolean>;
7026
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7027
- namespace: z.ZodOptional<z.ZodString>;
7028
- }, z.ZodTypeAny, "passthrough"> | undefined;
7029
- performance?: "strict" | "relaxed" | "standard" | {
7030
- preset?: "strict" | "relaxed" | "standard" | undefined;
7031
- budgets?: {
7032
- bundleSize?: number | undefined;
7033
- } | undefined;
7553
+ identity?: {
7554
+ decisions?: {
7555
+ kind: "sanction" | "reject" | "dismiss";
7556
+ component: string;
7557
+ reason?: string | undefined;
7558
+ canonicalTarget?: string | undefined;
7559
+ decisionId?: string | undefined;
7560
+ }[] | undefined;
7034
7561
  } | undefined;
7562
+ }, {
7035
7563
  govern?: {
7036
7564
  components?: Record<string, {
7037
7565
  rules: ({
@@ -7199,6 +7727,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7199
7727
  registryHash?: string | undefined;
7200
7728
  receiptPath?: string | undefined;
7201
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;
7202
7746
  presets?: string[] | undefined;
7203
7747
  agent?: z.objectInputType<{
7204
7748
  repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -7207,6 +7751,47 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7207
7751
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
7208
7752
  }, z.ZodTypeAny, "passthrough"> | undefined;
7209
7753
  } | undefined;
7754
+ components?: string[] | undefined;
7755
+ screenshots?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
7756
+ tokens?: z.objectInputType<{
7757
+ include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7758
+ sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
7759
+ path: z.ZodEffects<z.ZodString, string, string>;
7760
+ format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7761
+ }, "strip", z.ZodTypeAny, {
7762
+ path: string;
7763
+ format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7764
+ }, {
7765
+ path: string;
7766
+ format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7767
+ }>, "many">>;
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">>;
7783
+ exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7784
+ themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7785
+ enabled: z.ZodOptional<z.ZodBoolean>;
7786
+ format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7787
+ namespace: z.ZodOptional<z.ZodString>;
7788
+ }, z.ZodTypeAny, "passthrough"> | undefined;
7789
+ performance?: "strict" | "relaxed" | "standard" | {
7790
+ preset?: "strict" | "relaxed" | "standard" | undefined;
7791
+ budgets?: {
7792
+ bundleSize?: number | undefined;
7793
+ } | undefined;
7794
+ } | undefined;
7210
7795
  include?: string[] | undefined;
7211
7796
  exclude?: string[] | undefined;
7212
7797
  registry?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
@@ -7263,6 +7848,15 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7263
7848
  }> | undefined;
7264
7849
  } | undefined;
7265
7850
  recognizedClassHelpers?: string[] | undefined;
7851
+ identity?: {
7852
+ decisions?: {
7853
+ kind: "sanction" | "reject" | "dismiss";
7854
+ component: string;
7855
+ reason?: string | undefined;
7856
+ canonicalTarget?: string | undefined;
7857
+ decisionId?: string | undefined;
7858
+ }[] | undefined;
7859
+ } | undefined;
7266
7860
  }>;
7267
7861
  /**
7268
7862
  * Schema for v2 composition metadata (promoted from ai)
@@ -8691,6 +9285,7 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
8691
9285
  guidelines?: string[] | undefined;
8692
9286
  accessibility?: string[] | undefined;
8693
9287
  };
9288
+ govern?: ((...args: unknown[]) => unknown) | undefined;
8694
9289
  composition?: {
8695
9290
  pattern?: "compound" | "simple" | "controlled" | "wrapper" | undefined;
8696
9291
  subComponents?: string[] | undefined;
@@ -8706,7 +9301,6 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
8706
9301
  constraints?: string[] | undefined;
8707
9302
  typeDetails?: Record<string, unknown> | undefined;
8708
9303
  }> | undefined;
8709
- govern?: ((...args: unknown[]) => unknown) | undefined;
8710
9304
  contract?: {
8711
9305
  composition?: {
8712
9306
  rule: {
@@ -8837,6 +9431,7 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
8837
9431
  guidelines?: string[] | undefined;
8838
9432
  accessibility?: string[] | undefined;
8839
9433
  };
9434
+ govern?: ((...args: unknown[]) => unknown) | undefined;
8840
9435
  composition?: {
8841
9436
  pattern?: "compound" | "simple" | "controlled" | "wrapper" | undefined;
8842
9437
  subComponents?: string[] | undefined;
@@ -8852,7 +9447,6 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
8852
9447
  constraints?: string[] | undefined;
8853
9448
  typeDetails?: Record<string, unknown> | undefined;
8854
9449
  }> | undefined;
8855
- govern?: ((...args: unknown[]) => unknown) | undefined;
8856
9450
  contract?: {
8857
9451
  composition?: {
8858
9452
  rule: {
@@ -10263,8 +10857,6 @@ declare const componentContractSchema: z.ZodObject<{
10263
10857
  accessibility?: string[] | undefined;
10264
10858
  };
10265
10859
  $schema: string;
10266
- status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10267
- tokens?: string[] | undefined;
10268
10860
  preview?: {
10269
10861
  css?: string[] | undefined;
10270
10862
  theme?: "light" | "dark" | undefined;
@@ -10272,6 +10864,8 @@ declare const componentContractSchema: z.ZodObject<{
10272
10864
  wrapperModule?: string | undefined;
10273
10865
  wrapperExport?: string | undefined;
10274
10866
  } | undefined;
10867
+ status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10868
+ tokens?: string[] | undefined;
10275
10869
  contract?: {
10276
10870
  compoundChildren?: Record<string, {
10277
10871
  description?: string | undefined;
@@ -10344,8 +10938,6 @@ declare const componentContractSchema: z.ZodObject<{
10344
10938
  accessibility?: string[] | undefined;
10345
10939
  };
10346
10940
  $schema: string;
10347
- status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10348
- tokens?: string[] | undefined;
10349
10941
  preview?: {
10350
10942
  css?: string[] | undefined;
10351
10943
  theme?: "light" | "dark" | undefined;
@@ -10353,6 +10945,8 @@ declare const componentContractSchema: z.ZodObject<{
10353
10945
  wrapperModule?: string | undefined;
10354
10946
  wrapperExport?: string | undefined;
10355
10947
  } | undefined;
10948
+ status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10949
+ tokens?: string[] | undefined;
10356
10950
  contract?: {
10357
10951
  compoundChildren?: Record<string, {
10358
10952
  description?: string | undefined;
@@ -10626,6 +11220,8 @@ declare function ruleComponentsForbiddenPropValue(ix: FactIndex): Finding[];
10626
11220
 
10627
11221
  declare function ruleComponentsPreferLibrary(ix: FactIndex): Finding[];
10628
11222
 
11223
+ declare function ruleComponentsShadowComponent(ix: FactIndex): Finding[];
11224
+
10629
11225
  /**
10630
11226
  * `props/invalid-value` — fires when a JSX prop is statically assigned a
10631
11227
  * value outside the component's declared enum values.
@@ -10817,8 +11413,8 @@ declare function ruleA11yRequiredAccessibleName(ix: FactIndex): Finding[];
10817
11413
  * cloud policy composer, and the UI rules editor. There is exactly one copy —
10818
11414
  * importers derive their defaults from it rather than re-listing rules (DRY).
10819
11415
  *
10820
- * Identifiers are stable: this introduces no new rule ids, it only attaches a
10821
- * tier label to existing ones.
11416
+ * Identifiers are stable: every newly registered rule must be classified here
11417
+ * in the same change.
10822
11418
  */
10823
11419
  type RuleTier = "contract" | "hygiene";
10824
11420
  /**
@@ -11248,6 +11844,15 @@ declare const RULES: readonly Rule[];
11248
11844
  */
11249
11845
  declare function runRules(ix: FactIndex): Finding[];
11250
11846
 
11847
+ interface ComponentIdentityUsage {
11848
+ usageCount: number;
11849
+ /** Number of distinct source files containing a usage. */
11850
+ blastRadius: number;
11851
+ nodes: UsageNodeFact[];
11852
+ }
11853
+ /** Join resolved component usages to their usage nodes once for rules and DX surfaces. */
11854
+ declare function indexComponentIdentityUsage(ix: FactIndex): ReadonlyMap<string, ComponentIdentityUsage>;
11855
+
11251
11856
  /**
11252
11857
  * Rule helpers — small internal queries shared by Phase 5 rules.
11253
11858
  *
@@ -11362,65 +11967,81 @@ declare function isEffectiveCanonicalSource(source: CanonicalSource): boolean;
11362
11967
  declare function hasEffectiveComponentVocabulary(options: Record<string, unknown> | undefined): boolean;
11363
11968
  declare function evaluateGovernanceIntegrity(input: GovernanceIntegrityInput): GovernanceIntegrityVerdict;
11364
11969
 
11365
- type RawHtmlPrecisionTier = "exact-html" | "html-advisory" | "input-type" | "role-reimpl" | "interactive-nonsemantic" | "icon-only";
11366
- interface RawHtmlCanonicalMatch {
11367
- canonical: string;
11368
- tier: RawHtmlPrecisionTier;
11970
+ interface CanonicalDirectionConflict {
11971
+ packageName: string;
11972
+ exportName: string;
11973
+ wrapperComponentKey: string;
11974
+ wrapperFile: string;
11975
+ wrapperExportName: string;
11976
+ state: "unresolved" | "sanctioned";
11369
11977
  }
11370
- declare const RAW_HTML_CANONICAL_TAGS: readonly {
11371
- tagName: string;
11372
- canonical: string;
11373
- tier: "exact-html";
11374
- }[];
11375
- declare const RAW_HTML_ADVISORY_TAGS: readonly {
11376
- tagName: string;
11377
- canonical: string;
11378
- tier: "html-advisory";
11379
- }[];
11380
- declare const RAW_HTML_INPUT_TYPE_CANONICALS: readonly {
11381
- type: string;
11382
- canonical: string;
11383
- tier: "input-type";
11384
- }[];
11385
- declare const RAW_HTML_ROLE_CANONICALS: readonly {
11386
- role: string;
11387
- canonical: string;
11388
- tier: "role-reimpl";
11389
- }[];
11390
- declare function resolveCanonicalForRawHtml(tagName: string, inputType?: string): RawHtmlCanonicalMatch | null;
11391
- declare function resolveCanonicalForAriaRole(role: string): RawHtmlCanonicalMatch | null;
11392
- declare function isRawHtmlAdvisoryTier(tier: RawHtmlPrecisionTier): boolean;
11393
11978
  /**
11394
- * Decide whether a per-component `htmlEquivalent` mapping (raw `tag` a
11395
- * `canonical` component) may drive a bare-tag canonical-usage finding.
11396
- *
11397
- * The contract:
11398
- * - Low-frequency SEMANTIC tags (dialog, select, textarea, input, …) are always
11399
- * enforceable, so a custom-named component (`<dialog>` → Modal) still maps.
11400
- * - Common/ambiguous tags (button, a, …) enforce ONLY when the mapping AGREES
11401
- * with the framework's curated canonical for that tag — so `<button>` → Button
11402
- * fires, but `<button>` → Chip does not.
11403
- * - Generic structural containers (div, span) have no curated answer and are not
11404
- * semantic → never enforce.
11405
- *
11406
- * This is the guard that stops the canonical-usage flood: a library component
11407
- * being built on a `<div>` must not make every `<div>` a bespoke re-implementation
11408
- * of it (every `<div>` → Accordion, every `<span>` → Badge, every `<button>` → Chip).
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.
11409
11982
  */
11410
- declare function isEnforceableHtmlEquivalent(args: {
11411
- tag: string;
11412
- canonical: string;
11413
- inputType?: string;
11414
- /**
11415
- * The mapping is an EXPLICIT project declaration of this tag → component
11416
- * (provenance: `localCanonical.resolves`), not a low-confidence inferred
11417
- * `htmlEquivalent`. Explicit declarations enforce a specific interactive tag
11418
- * (`button`/`a`) against any canonical NAME — the agnosticism path — while
11419
- * inferred mappings stay name-gated to the curated canonical (the flood
11420
- * guard). Generic containers (`div`/`span`) are never enforceable even when
11421
- * explicit.
11422
- */
11423
- explicit?: boolean;
11424
- }): boolean;
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
+
12038
+ interface ComponentKeyInput {
12039
+ repoRelativeFile: string;
12040
+ exportName: string;
12041
+ }
12042
+ /**
12043
+ * Mint a clone- and platform-portable identity for one component definition.
12044
+ */
12045
+ declare function buildComponentKey({ repoRelativeFile, exportName }: ComponentKeyInput): string;
11425
12046
 
11426
- 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 CanonicalMappingFact, type CanonicalReplacementFact, CanonicalSource, type CheckStoryExclusionOpts, type CheckedSpacingValue, type ClassNameDynamicFact, type ClassNameDynamicReason, type ClassNameFact, type ClassNameLiteralFact, type ClassNameOrigin, CompiledBlock, type CompiledContractOutput, CompiledFragment, type ComplexityTier, type ComponentCapabilityFact, type ComponentContract, type ComponentFactInput, type ComponentId, 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, 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 InferProps, type JsxComponentPreferredFact, type JsxImportPathPreferredFact, type JsxInlineStyleForbiddenRawFact, type JsxUnknownPropsForbiddenFact, type Loader, 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 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, buildRegistryInstallPlan, buildRegistryInstallReceipt, buildSpacingTokenLookup, bundleArtifactMetadataSchema, bundleComponentShardSchema, bundleManifestComponentEntrySchema, bundleManifestSchema, bundleSchemaVersionSchema, bundleTargetSchema, bundleTokenFileSchema, calculateDeltaE, canonicalJson, canonicalPreimage, catalogFixtureA, catalogFixtureAContractPayload, catalogFixtureATokensDtcg, checkStoryExclusion, clampMaxPasses, classifyComplexity, 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, 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, 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, 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 };