@usefragments/core 1.5.2 → 1.7.0

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 (64) hide show
  1. package/dist/chunk-RANPUC6C.js +72 -0
  2. package/dist/chunk-RANPUC6C.js.map +1 -0
  3. package/dist/{chunk-BAHCOAVG.js → chunk-WNMWKUYG.js} +447 -201
  4. package/dist/chunk-WNMWKUYG.js.map +1 -0
  5. package/dist/codes/index.d.ts +2 -2
  6. package/dist/codes/index.js +1 -1
  7. package/dist/compiled-types/index.d.ts +1 -1
  8. package/dist/compiled-types/index.js +8 -0
  9. package/dist/generate/index.d.ts +1 -1
  10. package/dist/{governance-pKrfh517.d.ts → governance-D9KtH-vg.d.ts} +617 -22
  11. package/dist/index.d.ts +800 -179
  12. package/dist/index.js +1003 -237
  13. package/dist/index.js.map +1 -1
  14. package/dist/react-types.d.ts +1 -1
  15. package/dist/registry.d.ts +36 -36
  16. package/dist/schemas/index.d.ts +1 -1
  17. package/dist/test-utils.d.ts +1 -1
  18. package/package.json +2 -1
  19. package/src/__tests__/policy-exclude.test.ts +180 -0
  20. package/src/agent-format.test.ts +13 -0
  21. package/src/agent-format.ts +9 -3
  22. package/src/canonical-bridge.ts +69 -1
  23. package/src/canonical-direction.test.ts +118 -0
  24. package/src/canonical-direction.ts +43 -2
  25. package/src/codes/__tests__/codes.test.ts +14 -2
  26. package/src/codes/codes.ts +41 -2
  27. package/src/compiled-types/index.ts +81 -0
  28. package/src/compiled-types/parse.test.ts +47 -0
  29. package/src/facts/builders.ts +48 -0
  30. package/src/facts/compile.ts +148 -34
  31. package/src/facts/fact-index.ts +15 -2
  32. package/src/facts/facts.test.ts +44 -3
  33. package/src/facts/index.ts +11 -6
  34. package/src/facts/types.ts +60 -9
  35. package/src/governance-integrity.test.ts +272 -4
  36. package/src/governance-integrity.ts +345 -25
  37. package/src/governance.ts +87 -1
  38. package/src/index.ts +46 -1
  39. package/src/policy-exclude.ts +113 -0
  40. package/src/rules/a11y-required-accessible-name.ts +175 -28
  41. package/src/rules/a11y-standard.ts +102 -0
  42. package/src/rules/a11y-utils.ts +7 -0
  43. package/src/rules/components-prefer-library.test.ts +75 -28
  44. package/src/rules/components-prefer-library.ts +35 -15
  45. package/src/rules/components-shadow-component.test.ts +21 -9
  46. package/src/rules/emit-gate.test.ts +74 -4
  47. package/src/rules/emit-gate.ts +24 -9
  48. package/src/rules/families.test.ts +69 -0
  49. package/src/rules/families.ts +52 -0
  50. package/src/rules/fix-availability.ts +1 -0
  51. package/src/rules/index.ts +18 -2
  52. package/src/rules/jsx-preferred-import-path.ts +29 -11
  53. package/src/rules/rules.test.ts +188 -8
  54. package/src/rules/styles-no-raw-color.ts +13 -4
  55. package/src/rules/styles-no-raw-dimensions.ts +13 -4
  56. package/src/rules/styles-no-raw-spacing.ts +12 -4
  57. package/src/rules/styles-no-raw-typography.ts +13 -4
  58. package/src/rules/tiers.ts +1 -0
  59. package/src/rules/utils.ts +39 -0
  60. package/src/tokens/design-token-parser.test.ts +131 -0
  61. package/src/tokens/design-token-parser.ts +362 -49
  62. package/src/types.ts +2 -2
  63. package/dist/chunk-BAHCOAVG.js.map +0 -1
  64. package/dist/{index-DbkPE46t.d.ts → index-hZAlYCli.d.ts} +8 -8
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-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';
1
+ import { F as Finding, A as AgentFormat, E as EvidenceGrade, a as FindingFix } from './index-hZAlYCli.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-hZAlYCli.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, r as CanonicalBridgeV1, s as ContractCanonicalMappingInput } from './governance-pKrfh517.js';
7
- export { A as AIMetadata, t as AccessibilityGovernanceBuilder, u as AppConfig, v as BaselineInfo, w as BoundingBox, x as CONTRACT_DOMAINS, y as CONTRACT_PREIMAGE_CAPABILITY_HEADER, z as CONTRACT_PREIMAGE_SCHEMA, D as CanonicalMappingStatus, E as CompiledFragmentsFile, H as CompiledRecipe, I as CompiledTokenData, J as CompiledTokenEntry, K as ComponentGovernanceBuilder, L as ComponentGovernanceRecord, M as ComponentRef, N as ComponentRelation, O as CompositionMetadata, P as ContractComponentInput, Q as ContractIdentityPin, U as ContractPolicyInput, W as ContractPreimage, X as ContractPropMappingInput, Y as ContractTokenInput, Z as ContractWaiverInput, _ as ControlType, $ as DesignSystemConfig, a0 as DiffResult, a1 as FigmaPropMapping, a2 as FragmentContract, a3 as FragmentExample, a4 as FragmentGenerated, a5 as FragmentGuidance, a6 as FragmentMeta, a7 as FragmentProvenance, a8 as FragmentUsage, a9 as FragmentVariant, aa as GlobalGovernanceRecord, ab as GlobalJsxGovernanceRecord, ac as GlobalStyleGovernanceRecord, ad as GovernancePropValue, ae as InspectConfig, af as LocalCanonicalDeclaration, ag as LocalCanonicalResolveRule, ah as Manifest, ai as ObservedComponentUsage, aj as ObservedUsageProp, ak as PlayFunction, al as PlayFunctionContext, am as PropDefinition, an as PropGovernanceBuilder, ao as PropGovernanceOptions, ap as PropKey, aq as PropType, ar as RecipeDefinition, as as RegistryOptions, at as RepoRelativePath, au as ScaleGovernanceRecord, av as Screenshot, aw as ScreenshotConfig, ax as ScreenshotMetadata, ay as ServiceConfig, az as SnapshotConfig, aA as SnippetPolicyConfig, aB as Theme, aC as ThemeSeeds, aD as TokenSourceConfig, aE as TokenSourceFormat, aF as VerifyRequest, aG as VerifyResult, aH as Viewport, aI as canonicalBridgeV1Schema, aJ as componentGovernanceRecordSchema, aK as componentGovernanceRecordsSchema, aL as contractComponentsFromFragments, aM as contractPolicyFromGovernanceConfig, aN as diffContractDomains, aO as g, aP as globalGovernanceRecordSchema, aQ as globalJsxGovernanceRecordSchema, aR as globalStyleGovernanceRecordSchema, aS as governanceConfigSchema, aT as governanceConfigWithLocalCanonical, aU as governanceSeveritySchema, aV as localCanonicalContractMappings, aW as normalizeGovernanceConfig, aX as projectContractPreimage, aY as scaleGovernanceRecordSchema, aZ as verifiedContractPreimageFromPin } from './governance-pKrfh517.js';
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-D9KtH-vg.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 CompiledFragmentsFileValidationError, I as CompiledRecipe, J as CompiledTokenData, K as CompiledTokenEntry, L as ComponentGovernanceBuilder, M as ComponentGovernanceRecord, N as ComponentRef, O as ComponentRelation, P as CompositionMetadata, Q as ContractComponentInput, U as ContractIdentityPin, W as ContractPolicyInput, X as ContractPreimage, Y as ContractPropMappingInput, Z as ContractTokenInput, _ as ContractWaiverInput, $ as ControlType, a0 as DesignSystemConfig, a1 as DiffResult, a2 as FigmaPropMapping, a3 as FragmentContract, a4 as FragmentExample, a5 as FragmentGenerated, a6 as FragmentGuidance, a7 as FragmentMeta, a8 as FragmentProvenance, a9 as FragmentUsage, aa as FragmentVariant, ab as GlobalGovernanceRecord, ac as GlobalJsxGovernanceRecord, ad as GlobalStyleGovernanceRecord, ae as GovernancePropValue, af as InspectConfig, ag as LocalCanonicalDeclaration, ah as LocalCanonicalResolveRule, ai as Manifest, aj as ObservedComponentUsage, ak as ObservedUsageProp, al as PlayFunction, am as PlayFunctionContext, an as PropDefinition, ao as PropGovernanceBuilder, ap as PropGovernanceOptions, aq as PropKey, ar as PropType, as as RecipeDefinition, at as RegistryOptions, au as RepoRelativePath, av as ScaleGovernanceRecord, aw as Screenshot, ax as ScreenshotConfig, ay as ScreenshotMetadata, az as ServiceConfig, aA as SnapshotConfig, aB as SnippetPolicyConfig, aC as Theme, aD as ThemeSeeds, aE as TokenSourceConfig, aF as TokenSourceFormat, aG as VerifyRequest, aH as VerifyResult, aI as Viewport, aJ as canonicalBridgeV1Schema, aK as componentGovernanceRecordSchema, aL as componentGovernanceRecordsSchema, aM as contractComponentsFromFragments, aN as contractPolicyFromGovernanceConfig, aO as diffContractDomains, aP as g, aQ as globalGovernanceRecordSchema, aR as globalJsxGovernanceRecordSchema, aS as globalStyleGovernanceRecordSchema, aT as governanceConfigSchema, aU as governanceConfigWithLocalCanonical, aV as governanceSeveritySchema, aW as isPresetSourcedRule, aX as localCanonicalContractMappings, aY as markPresetSourcedRules, aZ as normalizeGovernanceConfig, a_ as parseCompiledFragmentsFile, a$ as projectContractPreimage, b0 as scaleGovernanceRecordSchema, b1 as verifiedContractPreimageFromPin } from './governance-D9KtH-vg.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';
@@ -712,6 +712,68 @@ interface IdentityClassification {
712
712
  */
713
713
  declare function classifyIdentity(input: ClassifyIdentityInput): IdentityClassification;
714
714
 
715
+ /**
716
+ * Policy path excludes — the one vocabulary every scoped-exemption surface shares.
717
+ *
718
+ * A global governance record (`govern.styles[]` / `govern.jsx[]`) or a rule-id-keyed
719
+ * override (`govern.rules["styles/no-raw-color"]`) may carry `exclude` globs that scope
720
+ * that policy off a path *without* hiding the path from every other rule — the
721
+ * difference between an exemption and a baseline. Two authoring forms are accepted:
722
+ *
723
+ * ```ts
724
+ * exclude: ["src/legacy/vendor/**"]
725
+ * exclude: [{ glob: "src/legacy/vendor/**", reason: "vendor drop, tracked in DS-611" }]
726
+ * ```
727
+ *
728
+ * Both normalize to `PolicyExclude`. The reason is free text and carries no expiry: an
729
+ * exclude is a standing scope decision, not a dated debt receipt (that is what
730
+ * suppressions and baselines are for). It travels into the scan's ignored-finding
731
+ * accounting so an exemption is never invisible policy.
732
+ *
733
+ * Browser-safe: pure string work, no filesystem.
734
+ */
735
+
736
+ interface PolicyExclude {
737
+ /** Repo-relative glob; `*` stops at a path segment, `**` crosses segments. */
738
+ glob: string;
739
+ /** Why this path is out of scope for this policy. Surfaced in reports. */
740
+ reason?: string;
741
+ }
742
+ declare const policyExcludeSchema: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
743
+ glob: z.ZodString;
744
+ reason: z.ZodOptional<z.ZodString>;
745
+ }, "strip", z.ZodTypeAny, {
746
+ glob: string;
747
+ reason?: string | undefined;
748
+ }, {
749
+ glob: string;
750
+ reason?: string | undefined;
751
+ }>]>, "many">;
752
+ /** The authored (pre-normalization) shape of an `exclude` list. */
753
+ type PolicyExcludeInput = z.infer<typeof policyExcludeSchema>;
754
+ /**
755
+ * Normalize an authored `exclude` list into `PolicyExclude[]`. Returns `undefined` when
756
+ * nothing usable was authored, so callers can omit the field entirely and keep fact
757
+ * shapes byte-identical for configs that declare no excludes.
758
+ */
759
+ declare function normalizePolicyExcludes(value: unknown): PolicyExclude[] | undefined;
760
+ /** Normalize a repo path for glob comparison (POSIX separators, no `./` prefix). */
761
+ declare function normalizeExcludePath(path: string): string;
762
+ /**
763
+ * Same glob dialect as the rest of the governance surface (`FactIndex.matchesGlob`,
764
+ * the scan's token-source matcher): `**` crosses path segments, `*` does not.
765
+ */
766
+ declare function excludeGlobToRegExp(glob: string): RegExp;
767
+ /** Whether `filePath` is inside `exclude`'s glob. */
768
+ declare function policyExcludeMatchesPath(exclude: PolicyExclude, filePath: string): boolean;
769
+ /** The first exclude covering `filePath`, or `undefined`. */
770
+ declare function matchPolicyExclude(excludes: readonly PolicyExclude[] | undefined, filePath: string): PolicyExclude | undefined;
771
+ /**
772
+ * The human half of the ignored-finding receipt: which policy stepped aside, on which
773
+ * glob, and why. `scope` is the policy's own identity (a record `kind` or a rule id).
774
+ */
775
+ declare function describePolicyExclude(scope: string, exclude: PolicyExclude): string;
776
+
715
777
  /**
716
778
  * Fact IR — discriminated union of governance facts.
717
779
  *
@@ -804,30 +866,39 @@ interface ScaleValueFact extends BaseFact {
804
866
  scale: string;
805
867
  value: number;
806
868
  }
807
- interface StyleRawColorForbiddenFact extends BaseFact {
869
+ /**
870
+ * Path excludes carried by a compiled policy fact. Present only when the authoring
871
+ * record declared them, so fact shapes are byte-identical for configs without
872
+ * excludes. Never part of the fact's `factId` inputs: scoping a policy off a path
873
+ * must not move fact ids or the finding fingerprints Cloud and baselines dedupe on.
874
+ */
875
+ type PolicyFactExcludes = {
876
+ exclude?: PolicyExclude[];
877
+ };
878
+ interface StyleRawColorForbiddenFact extends BaseFact, PolicyFactExcludes {
808
879
  kind: "style_raw_color_forbidden";
809
880
  except: string[];
810
881
  prefer: "token" | "css-variable";
811
882
  severity: GovernanceSeverity;
812
883
  }
813
- interface StyleRawDimensionForbiddenFact extends BaseFact {
884
+ interface StyleRawDimensionForbiddenFact extends BaseFact, PolicyFactExcludes {
814
885
  kind: "style_raw_dimension_forbidden";
815
886
  appliesTo: string[];
816
887
  prefer: "token" | "css-variable";
817
888
  severity: GovernanceSeverity;
818
889
  }
819
- interface StylePropertyScaleFact extends BaseFact {
890
+ interface StylePropertyScaleFact extends BaseFact, PolicyFactExcludes {
820
891
  kind: "style_property_scale";
821
892
  property: string;
822
893
  scale: string;
823
894
  severity: GovernanceSeverity;
824
895
  }
825
- interface StyleFontSizeScaleFact extends BaseFact {
896
+ interface StyleFontSizeScaleFact extends BaseFact, PolicyFactExcludes {
826
897
  kind: "style_font_size_scale";
827
898
  scale: string;
828
899
  severity: GovernanceSeverity;
829
900
  }
830
- interface StyleCssVarsMustBeDefinedFact extends BaseFact {
901
+ interface StyleCssVarsMustBeDefinedFact extends BaseFact, PolicyFactExcludes {
831
902
  kind: "style_css_vars_must_be_defined";
832
903
  severity: GovernanceSeverity;
833
904
  }
@@ -843,16 +914,16 @@ interface ContractTokenFact extends BaseFact {
843
914
  /** Custom-property name, normalized to `--`-prefixed form. */
844
915
  name: string;
845
916
  }
846
- interface JsxUnknownPropsForbiddenFact extends BaseFact {
917
+ interface JsxUnknownPropsForbiddenFact extends BaseFact, PolicyFactExcludes {
847
918
  kind: "jsx_unknown_props_forbidden";
848
919
  severity: GovernanceSeverity;
849
920
  }
850
- interface JsxInlineStyleForbiddenRawFact extends BaseFact {
921
+ interface JsxInlineStyleForbiddenRawFact extends BaseFact, PolicyFactExcludes {
851
922
  kind: "jsx_inline_style_forbidden_raw";
852
923
  property: string;
853
924
  severity: GovernanceSeverity;
854
925
  }
855
- interface JsxImportPathPreferredFact extends BaseFact {
926
+ interface JsxImportPathPreferredFact extends BaseFact, PolicyFactExcludes {
856
927
  kind: "jsx_import_path_preferred";
857
928
  from: string;
858
929
  to: string;
@@ -868,7 +939,7 @@ interface JsxImportPathPreferredFact extends BaseFact {
868
939
  decisionSource: "authored" | "migration";
869
940
  };
870
941
  }
871
- interface JsxComponentPreferredFact extends BaseFact {
942
+ interface JsxComponentPreferredFact extends BaseFact, PolicyFactExcludes {
872
943
  kind: "jsx_component_preferred";
873
944
  from: ComponentId;
874
945
  to: ComponentId;
@@ -1002,6 +1073,9 @@ interface UsageInlineStyleFact extends BaseFact {
1002
1073
  */
1003
1074
  valueKind: "static" | "number" | "css-variable" | "dynamic-raw";
1004
1075
  value: string;
1076
+ /** Set when `value` was resolved through a hop rather than authored inline.
1077
+ * Additive — the fact's identity key is unchanged. */
1078
+ valueFrom?: StyleValueProvenance;
1005
1079
  }
1006
1080
  interface UsageTextChildFact extends BaseFact {
1007
1081
  kind: "usage_text_child";
@@ -1009,6 +1083,19 @@ interface UsageTextChildFact extends BaseFact {
1009
1083
  text: string;
1010
1084
  index: number;
1011
1085
  }
1086
+ /**
1087
+ * Framework-neutral summary of the rendered child content for one usage node.
1088
+ *
1089
+ * An adapter that supports semantic child analysis preserves its existing prop
1090
+ * facts and additionally emits exactly one summary per usage node, so rules do
1091
+ * not have to interpret React's `children`, Vue slots, or Svelte snippets
1092
+ * themselves. Adapters may add support independently.
1093
+ */
1094
+ interface UsageChildContentFact extends BaseFact {
1095
+ kind: "usage_child_content";
1096
+ nodeId: FactId;
1097
+ content: "static-text" | "runtime" | "structural" | "empty";
1098
+ }
1012
1099
  type ClassNameOrigin = "attribute" | "clsx" | "cn" | "classnames" | "twMerge" | "tw" | "cva-arg" | "template";
1013
1100
  interface ClassNameLiteralFact extends BaseFact {
1014
1101
  kind: "classname_literal";
@@ -1118,6 +1205,26 @@ interface TailwindTokenResolvedFact extends BaseFact {
1118
1205
  * selector chain. Identity is `{ file, selector, declarationPath, property }`
1119
1206
  * so the ID stays stable when other lines move.
1120
1207
  */
1208
+ /**
1209
+ * How a style value reached the fact when the authored text at the use site was
1210
+ * not the value itself. Present only for `const-binding` today: the extractor
1211
+ * followed exactly one hop to a same-file, immutable, statically-initialized
1212
+ * `const` (`const c = '#FFC107'; sx={{ color: c }}`).
1213
+ *
1214
+ * Two consequences for rules, both load-bearing:
1215
+ * - The declaration line is the evidence a reader needs — the use site only
1216
+ * shows an identifier.
1217
+ * - **No deterministic fix may be attached.** The authored text at the finding's
1218
+ * location is the identifier, so any value replacement would be an edit the
1219
+ * user never wrote.
1220
+ */
1221
+ interface StyleValueProvenance {
1222
+ kind: "const-binding";
1223
+ /** Identifier the use site referenced. */
1224
+ name: string;
1225
+ /** Where the binding was declared. */
1226
+ location: FactLocation;
1227
+ }
1121
1228
  interface StyleDeclarationFact extends BaseFact {
1122
1229
  kind: "style_declaration";
1123
1230
  file: string;
@@ -1134,6 +1241,9 @@ interface StyleDeclarationFact extends BaseFact {
1134
1241
  * flagging ad hoc custom properties in product code.
1135
1242
  */
1136
1243
  declaredTokenSource?: boolean;
1244
+ /** Set when `value` was resolved through a hop rather than authored inline.
1245
+ * Additive — the fact's identity key is unchanged. */
1246
+ valueFrom?: StyleValueProvenance;
1137
1247
  }
1138
1248
  type UnsupportedStyleReason = "dynamic-template-expression" | "dynamic-object-value" | "object-spread" | "unsupported-array-element";
1139
1249
  interface StyleUnsupportedFact extends BaseFact {
@@ -1233,7 +1343,7 @@ interface ComponentIdentityFact extends BaseFact {
1233
1343
  }
1234
1344
  type ComponentLevelFact = ComponentMetadataFact | ComponentCapabilityFact | PropMetadataFact;
1235
1345
  type PolicyFact = PropValueAvoidedFact | PropValueForbiddenFact | A11yNameRequiredFact | ScaleFact | ScaleValueFact | StyleRawColorForbiddenFact | StyleRawDimensionForbiddenFact | StylePropertyScaleFact | StyleFontSizeScaleFact | StyleCssVarsMustBeDefinedFact | ContractTokenFact | JsxUnknownPropsForbiddenFact | JsxInlineStyleForbiddenRawFact | JsxImportPathPreferredFact | JsxComponentPreferredFact | TokenDefinitionFact | TailwindPaletteAllowFact | TailwindPaletteDenyFact | TailwindUnknownClassEnabledFact | GovernanceRuleConfigFact;
1236
- type UsageFact = UsageNodeFact | UsageComponentFact | UsageImportFact | UsagePropResolvedFact | UsageInlineStyleFact | UsageTextChildFact | StyleDeclarationFact | StyleUnsupportedFact | ClassNameLiteralFact | ClassNameDynamicFact | TailwindClassFact | ThemeDeclarationFact | SuppressionDirectiveFact | TailwindTokenResolvedFact | CanonicalCandidateFact | CanonicalMappingFact | StructuralConfidenceFact | CanonicalReplacementFact;
1346
+ type UsageFact = UsageNodeFact | UsageComponentFact | UsageImportFact | UsagePropResolvedFact | UsageInlineStyleFact | UsageTextChildFact | UsageChildContentFact | StyleDeclarationFact | StyleUnsupportedFact | ClassNameLiteralFact | ClassNameDynamicFact | TailwindClassFact | ThemeDeclarationFact | SuppressionDirectiveFact | TailwindTokenResolvedFact | CanonicalCandidateFact | CanonicalMappingFact | StructuralConfidenceFact | CanonicalReplacementFact;
1237
1347
  type IdentityFact = ComponentDefinitionFact | ComponentIdentityFact;
1238
1348
  type Fact = ComponentLevelFact | PolicyFact | UsageFact | IdentityFact;
1239
1349
  type FactKind = Fact["kind"];
@@ -1380,28 +1490,34 @@ declare function makeStyleRawColorForbiddenFact(input: {
1380
1490
  except: string[];
1381
1491
  prefer: "token" | "css-variable";
1382
1492
  severity: GovernanceSeverity;
1493
+ exclude?: readonly PolicyExclude[];
1383
1494
  }): StyleRawColorForbiddenFact;
1384
1495
  declare function makeStylePropertyScaleFact(input: {
1385
1496
  property: string;
1386
1497
  scale: string;
1387
1498
  severity: GovernanceSeverity;
1499
+ exclude?: readonly PolicyExclude[];
1388
1500
  }): StylePropertyScaleFact;
1389
1501
  declare function makeStyleFontSizeScaleFact(input: {
1390
1502
  scale: string;
1391
1503
  severity: GovernanceSeverity;
1504
+ exclude?: readonly PolicyExclude[];
1392
1505
  }): StyleFontSizeScaleFact;
1393
1506
  declare function makeStyleCssVarsMustBeDefinedFact(input: {
1394
1507
  severity: GovernanceSeverity;
1508
+ exclude?: readonly PolicyExclude[];
1395
1509
  }): StyleCssVarsMustBeDefinedFact;
1396
1510
  declare function makeContractTokenFact(input: {
1397
1511
  name: string;
1398
1512
  }): ContractTokenFact;
1399
1513
  declare function makeJsxUnknownPropsForbiddenFact(input: {
1400
1514
  severity: GovernanceSeverity;
1515
+ exclude?: readonly PolicyExclude[];
1401
1516
  }): JsxUnknownPropsForbiddenFact;
1402
1517
  declare function makeJsxInlineStyleForbiddenRawFact(input: {
1403
1518
  property: string;
1404
1519
  severity: GovernanceSeverity;
1520
+ exclude?: readonly PolicyExclude[];
1405
1521
  }): JsxInlineStyleForbiddenRawFact;
1406
1522
  declare function makeJsxImportPathPreferredFact(input: {
1407
1523
  from: string;
@@ -1410,12 +1526,14 @@ declare function makeJsxImportPathPreferredFact(input: {
1410
1526
  because?: string;
1411
1527
  severity: GovernanceSeverity;
1412
1528
  bridge?: JsxImportPathPreferredFact["bridge"];
1529
+ exclude?: readonly PolicyExclude[];
1413
1530
  }): JsxImportPathPreferredFact;
1414
1531
  declare function makeJsxComponentPreferredFact(input: {
1415
1532
  from: ComponentId;
1416
1533
  to: ComponentId;
1417
1534
  because?: string;
1418
1535
  severity: GovernanceSeverity;
1536
+ exclude?: readonly PolicyExclude[];
1419
1537
  }): JsxComponentPreferredFact;
1420
1538
  declare function makeTokenDefinitionFact(input: {
1421
1539
  name: string;
@@ -1472,12 +1590,17 @@ declare function makeUsageInlineStyleFact(input: {
1472
1590
  property: string;
1473
1591
  valueKind: "static" | "number" | "css-variable" | "dynamic-raw";
1474
1592
  value: string;
1593
+ valueFrom?: StyleValueProvenance;
1475
1594
  }): UsageInlineStyleFact;
1476
1595
  declare function makeUsageTextChildFact(input: {
1477
1596
  nodeId: FactId;
1478
1597
  text: string;
1479
1598
  index: number;
1480
1599
  }): UsageTextChildFact;
1600
+ declare function makeUsageChildContentFact(input: {
1601
+ nodeId: FactId;
1602
+ content: UsageChildContentFact["content"];
1603
+ }): UsageChildContentFact;
1481
1604
  declare function makeClassNameLiteralFact(input: {
1482
1605
  file: string;
1483
1606
  nodeId: FactId;
@@ -1531,6 +1654,7 @@ declare function makeStyleDeclarationFact(input: {
1531
1654
  value: string;
1532
1655
  location: FactLocation;
1533
1656
  declaredTokenSource?: boolean;
1657
+ valueFrom?: StyleValueProvenance;
1534
1658
  }): StyleDeclarationFact;
1535
1659
  declare function makeStyleUnsupportedFact(input: {
1536
1660
  file: string;
@@ -1556,9 +1680,20 @@ interface FactEvidence {
1556
1680
  factId: FactId;
1557
1681
  fact: Fact;
1558
1682
  }
1683
+ /**
1684
+ * The two facts involved in a first-wins drop: `kept` is already indexed, `skipped`
1685
+ * carries different logical content and is discarded. Handed to `onConflict` alongside
1686
+ * the rendered message so callers can classify the drop (a colliding *config record* is
1687
+ * a named user-facing diagnostic; anything else stays an internal debug line) instead of
1688
+ * re-parsing prose.
1689
+ */
1690
+ interface FactConflict {
1691
+ kept: Fact;
1692
+ skipped: Fact;
1693
+ }
1559
1694
  interface FactIndexOptions {
1560
1695
  /** Optional internal diagnostic route. Product output is quiet by default. */
1561
- onConflict?: (message: string) => void;
1696
+ onConflict?: (message: string, conflict: FactConflict) => void;
1562
1697
  }
1563
1698
  /**
1564
1699
  * Match a literal path against a simple glob pattern. `*` matches any run of
@@ -1652,6 +1787,22 @@ declare class FactIndex {
1652
1787
  */
1653
1788
 
1654
1789
  declare function compileGlobalGovernanceFacts(govern: GovernanceConfig | undefined): PolicyFact[];
1790
+ interface SupersededImportPathPreference {
1791
+ from: string;
1792
+ imported?: string;
1793
+ to: string;
1794
+ packageName: string;
1795
+ underlyingExportName: string;
1796
+ localExportName: string;
1797
+ }
1798
+ /**
1799
+ * Name each non-bridge `jsx.importPath.prefer` record whose domain a confirmed
1800
+ * bridge covers. The rule suppresses the duplicate finding at match time
1801
+ * (report #2 B6); this projection is the compile-side voice of that
1802
+ * supersession, so the record is never silenced without a word — the exact
1803
+ * silence class the config-truth layer exists to kill.
1804
+ */
1805
+ declare function projectSupersededImportPathPreferences(govern: GovernanceConfig | undefined): SupersededImportPathPreference[];
1655
1806
  type ComponentFactInput = CompiledFragment | GovernedFragmentDefinition | ResolvedGovernedFragmentDefinition;
1656
1807
  declare function compileComponentFacts(componentId: ComponentId, input: ComponentFactInput): Fact[];
1657
1808
 
@@ -2073,7 +2224,7 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
2073
2224
  componentId: string;
2074
2225
  name: string;
2075
2226
  }[];
2076
- tier: "core" | "composition";
2227
+ tier: "composition" | "core";
2077
2228
  publicSlug: string | null;
2078
2229
  propCount: number;
2079
2230
  hasExamples: boolean;
@@ -2094,7 +2245,7 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
2094
2245
  componentId: string;
2095
2246
  name: string;
2096
2247
  }[];
2097
- tier: "core" | "composition";
2248
+ tier: "composition" | "core";
2098
2249
  publicSlug: string | null;
2099
2250
  propCount: number;
2100
2251
  hasExamples: boolean;
@@ -2203,7 +2354,7 @@ declare const bundleManifestSchema: z.ZodObject<{
2203
2354
  componentId: string;
2204
2355
  name: string;
2205
2356
  }[];
2206
- tier: "core" | "composition";
2357
+ tier: "composition" | "core";
2207
2358
  publicSlug: string | null;
2208
2359
  propCount: number;
2209
2360
  hasExamples: boolean;
@@ -2224,7 +2375,7 @@ declare const bundleManifestSchema: z.ZodObject<{
2224
2375
  componentId: string;
2225
2376
  name: string;
2226
2377
  }[];
2227
- tier: "core" | "composition";
2378
+ tier: "composition" | "core";
2228
2379
  publicSlug: string | null;
2229
2380
  propCount: number;
2230
2381
  hasExamples: boolean;
@@ -2247,7 +2398,7 @@ declare const bundleManifestSchema: z.ZodObject<{
2247
2398
  componentId: string;
2248
2399
  name: string;
2249
2400
  }[];
2250
- tier: "core" | "composition";
2401
+ tier: "composition" | "core";
2251
2402
  publicSlug: string | null;
2252
2403
  propCount: number;
2253
2404
  hasExamples: boolean;
@@ -2293,7 +2444,7 @@ declare const bundleManifestSchema: z.ZodObject<{
2293
2444
  componentId: string;
2294
2445
  name: string;
2295
2446
  }[];
2296
- tier: "core" | "composition";
2447
+ tier: "composition" | "core";
2297
2448
  publicSlug: string | null;
2298
2449
  propCount: number;
2299
2450
  hasExamples: boolean;
@@ -2497,7 +2648,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2497
2648
  name: string;
2498
2649
  }[];
2499
2650
  source: "design-system";
2500
- tier: "core" | "composition";
2651
+ tier: "composition" | "core";
2501
2652
  publicSlug: string | null;
2502
2653
  relations: Record<string, unknown>[];
2503
2654
  publicId: string | null;
@@ -2523,7 +2674,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2523
2674
  name: string;
2524
2675
  }[];
2525
2676
  source: "design-system";
2526
- tier: "core" | "composition";
2677
+ tier: "composition" | "core";
2527
2678
  publicSlug: string | null;
2528
2679
  relations: Record<string, unknown>[];
2529
2680
  publicId: string | null;
@@ -2554,7 +2705,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2554
2705
  name: string;
2555
2706
  }[];
2556
2707
  source: "design-system";
2557
- tier: "core" | "composition";
2708
+ tier: "composition" | "core";
2558
2709
  publicSlug: string | null;
2559
2710
  relations: Record<string, unknown>[];
2560
2711
  publicId: string | null;
@@ -2587,7 +2738,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2587
2738
  name: string;
2588
2739
  }[];
2589
2740
  source: "design-system";
2590
- tier: "core" | "composition";
2741
+ tier: "composition" | "core";
2591
2742
  publicSlug: string | null;
2592
2743
  relations: Record<string, unknown>[];
2593
2744
  publicId: string | null;
@@ -2835,18 +2986,19 @@ declare const mcpComponentGuidanceSchema: z.ZodObject<{
2835
2986
  }>, "many">>;
2836
2987
  }, "strip", z.ZodTypeAny, {
2837
2988
  when: string[];
2989
+ whenNot: string[];
2838
2990
  patterns: {
2839
2991
  name: string;
2840
2992
  description?: string | undefined;
2841
2993
  }[];
2842
2994
  dos: string[];
2843
2995
  donts: string[];
2844
- whenNot: string[];
2845
2996
  guidelines: string[];
2846
2997
  accessibility: string[];
2847
2998
  usageGuidance?: string | undefined;
2848
2999
  }, {
2849
3000
  when?: string[] | undefined;
3001
+ whenNot?: string[] | undefined;
2850
3002
  patterns?: {
2851
3003
  name: string;
2852
3004
  description?: string | undefined;
@@ -2854,7 +3006,6 @@ declare const mcpComponentGuidanceSchema: z.ZodObject<{
2854
3006
  usageGuidance?: string | undefined;
2855
3007
  dos?: string[] | undefined;
2856
3008
  donts?: string[] | undefined;
2857
- whenNot?: string[] | undefined;
2858
3009
  guidelines?: string[] | undefined;
2859
3010
  accessibility?: string[] | undefined;
2860
3011
  }>;
@@ -2975,18 +3126,19 @@ declare const mcpComponentSchema: z.ZodObject<{
2975
3126
  }>, "many">>;
2976
3127
  }, "strip", z.ZodTypeAny, {
2977
3128
  when: string[];
3129
+ whenNot: string[];
2978
3130
  patterns: {
2979
3131
  name: string;
2980
3132
  description?: string | undefined;
2981
3133
  }[];
2982
3134
  dos: string[];
2983
3135
  donts: string[];
2984
- whenNot: string[];
2985
3136
  guidelines: string[];
2986
3137
  accessibility: string[];
2987
3138
  usageGuidance?: string | undefined;
2988
3139
  }, {
2989
3140
  when?: string[] | undefined;
3141
+ whenNot?: string[] | undefined;
2990
3142
  patterns?: {
2991
3143
  name: string;
2992
3144
  description?: string | undefined;
@@ -2994,7 +3146,6 @@ declare const mcpComponentSchema: z.ZodObject<{
2994
3146
  usageGuidance?: string | undefined;
2995
3147
  dos?: string[] | undefined;
2996
3148
  donts?: string[] | undefined;
2997
- whenNot?: string[] | undefined;
2998
3149
  guidelines?: string[] | undefined;
2999
3150
  accessibility?: string[] | undefined;
3000
3151
  }>>;
@@ -3107,13 +3258,13 @@ declare const mcpComponentSchema: z.ZodObject<{
3107
3258
  propsSummary: string[];
3108
3259
  guidance: {
3109
3260
  when: string[];
3261
+ whenNot: string[];
3110
3262
  patterns: {
3111
3263
  name: string;
3112
3264
  description?: string | undefined;
3113
3265
  }[];
3114
3266
  dos: string[];
3115
3267
  donts: string[];
3116
- whenNot: string[];
3117
3268
  guidelines: string[];
3118
3269
  accessibility: string[];
3119
3270
  usageGuidance?: string | undefined;
@@ -3208,6 +3359,7 @@ declare const mcpComponentSchema: z.ZodObject<{
3208
3359
  propsSummary?: string[] | undefined;
3209
3360
  guidance?: {
3210
3361
  when?: string[] | undefined;
3362
+ whenNot?: string[] | undefined;
3211
3363
  patterns?: {
3212
3364
  name: string;
3213
3365
  description?: string | undefined;
@@ -3215,7 +3367,6 @@ declare const mcpComponentSchema: z.ZodObject<{
3215
3367
  usageGuidance?: string | undefined;
3216
3368
  dos?: string[] | undefined;
3217
3369
  donts?: string[] | undefined;
3218
- whenNot?: string[] | undefined;
3219
3370
  guidelines?: string[] | undefined;
3220
3371
  accessibility?: string[] | undefined;
3221
3372
  } | undefined;
@@ -3504,18 +3655,19 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3504
3655
  }>, "many">>;
3505
3656
  }, "strip", z.ZodTypeAny, {
3506
3657
  when: string[];
3658
+ whenNot: string[];
3507
3659
  patterns: {
3508
3660
  name: string;
3509
3661
  description?: string | undefined;
3510
3662
  }[];
3511
3663
  dos: string[];
3512
3664
  donts: string[];
3513
- whenNot: string[];
3514
3665
  guidelines: string[];
3515
3666
  accessibility: string[];
3516
3667
  usageGuidance?: string | undefined;
3517
3668
  }, {
3518
3669
  when?: string[] | undefined;
3670
+ whenNot?: string[] | undefined;
3519
3671
  patterns?: {
3520
3672
  name: string;
3521
3673
  description?: string | undefined;
@@ -3523,7 +3675,6 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3523
3675
  usageGuidance?: string | undefined;
3524
3676
  dos?: string[] | undefined;
3525
3677
  donts?: string[] | undefined;
3526
- whenNot?: string[] | undefined;
3527
3678
  guidelines?: string[] | undefined;
3528
3679
  accessibility?: string[] | undefined;
3529
3680
  }>>;
@@ -3636,13 +3787,13 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3636
3787
  propsSummary: string[];
3637
3788
  guidance: {
3638
3789
  when: string[];
3790
+ whenNot: string[];
3639
3791
  patterns: {
3640
3792
  name: string;
3641
3793
  description?: string | undefined;
3642
3794
  }[];
3643
3795
  dos: string[];
3644
3796
  donts: string[];
3645
- whenNot: string[];
3646
3797
  guidelines: string[];
3647
3798
  accessibility: string[];
3648
3799
  usageGuidance?: string | undefined;
@@ -3737,6 +3888,7 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3737
3888
  propsSummary?: string[] | undefined;
3738
3889
  guidance?: {
3739
3890
  when?: string[] | undefined;
3891
+ whenNot?: string[] | undefined;
3740
3892
  patterns?: {
3741
3893
  name: string;
3742
3894
  description?: string | undefined;
@@ -3744,7 +3896,6 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3744
3896
  usageGuidance?: string | undefined;
3745
3897
  dos?: string[] | undefined;
3746
3898
  donts?: string[] | undefined;
3747
- whenNot?: string[] | undefined;
3748
3899
  guidelines?: string[] | undefined;
3749
3900
  accessibility?: string[] | undefined;
3750
3901
  } | undefined;
@@ -3927,13 +4078,13 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3927
4078
  propsSummary: string[];
3928
4079
  guidance: {
3929
4080
  when: string[];
4081
+ whenNot: string[];
3930
4082
  patterns: {
3931
4083
  name: string;
3932
4084
  description?: string | undefined;
3933
4085
  }[];
3934
4086
  dos: string[];
3935
4087
  donts: string[];
3936
- whenNot: string[];
3937
4088
  guidelines: string[];
3938
4089
  accessibility: string[];
3939
4090
  usageGuidance?: string | undefined;
@@ -3973,7 +4124,7 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3973
4124
  schemaVersion: 1;
3974
4125
  sourceType: "fragments-json" | "cloud" | "auto-extract" | "custom-json" | "bundle";
3975
4126
  sourceLabel: string;
3976
- capabilities: ("components" | "tokens" | "performance" | "blocks" | "graph")[];
4127
+ capabilities: ("components" | "tokens" | "performance" | "graph" | "blocks")[];
3977
4128
  packageMap: Record<string, string>;
3978
4129
  tokens?: {
3979
4130
  flat: {
@@ -3995,6 +4146,7 @@ declare const mcpSnapshotSchema: z.ZodObject<{
3995
4146
  }[]>;
3996
4147
  total: number;
3997
4148
  } | undefined;
4149
+ graph?: unknown;
3998
4150
  blocks?: Record<string, {
3999
4151
  components: string[];
4000
4152
  code: string;
@@ -4004,7 +4156,6 @@ declare const mcpSnapshotSchema: z.ZodObject<{
4004
4156
  id: string;
4005
4157
  tags: string[];
4006
4158
  }> | undefined;
4007
- graph?: unknown;
4008
4159
  performanceSummary?: {
4009
4160
  budget: number;
4010
4161
  overBudget: number;
@@ -4080,6 +4231,7 @@ declare const mcpSnapshotSchema: z.ZodObject<{
4080
4231
  propsSummary?: string[] | undefined;
4081
4232
  guidance?: {
4082
4233
  when?: string[] | undefined;
4234
+ whenNot?: string[] | undefined;
4083
4235
  patterns?: {
4084
4236
  name: string;
4085
4237
  description?: string | undefined;
@@ -4087,7 +4239,6 @@ declare const mcpSnapshotSchema: z.ZodObject<{
4087
4239
  usageGuidance?: string | undefined;
4088
4240
  dos?: string[] | undefined;
4089
4241
  donts?: string[] | undefined;
4090
- whenNot?: string[] | undefined;
4091
4242
  guidelines?: string[] | undefined;
4092
4243
  accessibility?: string[] | undefined;
4093
4244
  } | undefined;
@@ -4096,7 +4247,7 @@ declare const mcpSnapshotSchema: z.ZodObject<{
4096
4247
  schemaVersion: 1;
4097
4248
  sourceType: "fragments-json" | "cloud" | "auto-extract" | "custom-json" | "bundle";
4098
4249
  sourceLabel: string;
4099
- capabilities: ("components" | "tokens" | "performance" | "blocks" | "graph")[];
4250
+ capabilities: ("components" | "tokens" | "performance" | "graph" | "blocks")[];
4100
4251
  metadata?: {
4101
4252
  importPath?: string | undefined;
4102
4253
  packageName?: string | undefined;
@@ -4124,6 +4275,7 @@ declare const mcpSnapshotSchema: z.ZodObject<{
4124
4275
  description?: string | undefined;
4125
4276
  }[] | undefined;
4126
4277
  } | undefined;
4278
+ graph?: unknown;
4127
4279
  blocks?: Record<string, {
4128
4280
  name: string;
4129
4281
  id: string;
@@ -4133,7 +4285,6 @@ declare const mcpSnapshotSchema: z.ZodObject<{
4133
4285
  category?: string | undefined;
4134
4286
  tags?: string[] | undefined;
4135
4287
  }> | undefined;
4136
- graph?: unknown;
4137
4288
  performanceSummary?: {
4138
4289
  budget: number;
4139
4290
  overBudget: number;
@@ -5548,12 +5699,6 @@ declare const fragmentDefinitionSchema: z.ZodObject<{
5548
5699
  layer: string;
5549
5700
  }> | undefined;
5550
5701
  };
5551
- usage: {
5552
- when: string[];
5553
- whenNot: string[];
5554
- guidelines?: string[] | undefined;
5555
- accessibility?: string[] | undefined;
5556
- };
5557
5702
  variants: {
5558
5703
  description: string;
5559
5704
  name: string;
@@ -5561,6 +5706,12 @@ declare const fragmentDefinitionSchema: z.ZodObject<{
5561
5706
  code?: string | undefined;
5562
5707
  figma?: string | undefined;
5563
5708
  }[];
5709
+ usage: {
5710
+ when: string[];
5711
+ whenNot: string[];
5712
+ guidelines?: string[] | undefined;
5713
+ accessibility?: string[] | undefined;
5714
+ };
5564
5715
  contract?: {
5565
5716
  composition?: {
5566
5717
  rule: {
@@ -5676,12 +5827,6 @@ declare const fragmentDefinitionSchema: z.ZodObject<{
5676
5827
  layer: string;
5677
5828
  }> | undefined;
5678
5829
  };
5679
- usage: {
5680
- when: string[];
5681
- whenNot: string[];
5682
- guidelines?: string[] | undefined;
5683
- accessibility?: string[] | undefined;
5684
- };
5685
5830
  variants: {
5686
5831
  description: string;
5687
5832
  name: string;
@@ -5689,6 +5834,12 @@ declare const fragmentDefinitionSchema: z.ZodObject<{
5689
5834
  code?: string | undefined;
5690
5835
  figma?: string | undefined;
5691
5836
  }[];
5837
+ usage: {
5838
+ when: string[];
5839
+ whenNot: string[];
5840
+ guidelines?: string[] | undefined;
5841
+ accessibility?: string[] | undefined;
5842
+ };
5692
5843
  contract?: {
5693
5844
  composition?: {
5694
5845
  rule: {
@@ -5768,12 +5919,12 @@ declare const fragmentsConfigSchema: z.ZodObject<{
5768
5919
  exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
5769
5920
  }, "strip", z.ZodTypeAny, {
5770
5921
  path?: string | undefined;
5771
- include?: string[] | undefined;
5772
5922
  exclude?: string[] | undefined;
5923
+ include?: string[] | undefined;
5773
5924
  }, {
5774
5925
  path?: string | undefined;
5775
- include?: string[] | undefined;
5776
5926
  exclude?: string[] | undefined;
5927
+ include?: string[] | undefined;
5777
5928
  }>>;
5778
5929
  designSystem: z.ZodOptional<z.ZodObject<{
5779
5930
  path: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -6003,15 +6154,15 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6003
6154
  excludeSvgIcons: z.ZodOptional<z.ZodBoolean>;
6004
6155
  excludeSubComponents: z.ZodOptional<z.ZodBoolean>;
6005
6156
  }, "strip", z.ZodTypeAny, {
6006
- include?: string[] | undefined;
6007
6157
  exclude?: string[] | undefined;
6158
+ include?: string[] | undefined;
6008
6159
  excludeDeprecated?: boolean | undefined;
6009
6160
  excludeTests?: boolean | undefined;
6010
6161
  excludeSvgIcons?: boolean | undefined;
6011
6162
  excludeSubComponents?: boolean | undefined;
6012
6163
  }, {
6013
- include?: string[] | undefined;
6014
6164
  exclude?: string[] | undefined;
6165
+ include?: string[] | undefined;
6015
6166
  excludeDeprecated?: boolean | undefined;
6016
6167
  excludeTests?: boolean | undefined;
6017
6168
  excludeSvgIcons?: boolean | undefined;
@@ -6092,15 +6243,15 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6092
6243
  }, "strip", z.ZodTypeAny, {
6093
6244
  kind: "npm";
6094
6245
  specifier: string;
6246
+ exclude?: string[] | undefined;
6095
6247
  implementationPath?: string | undefined;
6096
6248
  include?: string[] | undefined;
6097
- exclude?: string[] | undefined;
6098
6249
  }, {
6099
6250
  kind: "npm";
6100
6251
  specifier: string;
6252
+ exclude?: string[] | undefined;
6101
6253
  implementationPath?: string | undefined;
6102
6254
  include?: string[] | undefined;
6103
- exclude?: string[] | undefined;
6104
6255
  }>, z.ZodObject<{
6105
6256
  kind: z.ZodLiteral<"directory">;
6106
6257
  path: z.ZodString;
@@ -6109,13 +6260,13 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6109
6260
  }, "strip", z.ZodTypeAny, {
6110
6261
  path: string;
6111
6262
  kind: "directory";
6112
- include?: string[] | undefined;
6113
6263
  exclude?: string[] | undefined;
6264
+ include?: string[] | undefined;
6114
6265
  }, {
6115
6266
  path: string;
6116
6267
  kind: "directory";
6117
- include?: string[] | undefined;
6118
6268
  exclude?: string[] | undefined;
6269
+ include?: string[] | undefined;
6119
6270
  }>, z.ZodObject<{
6120
6271
  kind: z.ZodLiteral<"registry">;
6121
6272
  registryId: z.ZodString;
@@ -6133,8 +6284,8 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6133
6284
  installPath: string;
6134
6285
  severity?: "error" | "info" | "warn" | undefined;
6135
6286
  importPath?: string | undefined;
6136
- include?: string[] | undefined;
6137
6287
  exclude?: string[] | undefined;
6288
+ include?: string[] | undefined;
6138
6289
  registryHash?: string | undefined;
6139
6290
  }, {
6140
6291
  kind: "registry";
@@ -6142,8 +6293,8 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6142
6293
  installPath: string;
6143
6294
  severity?: "error" | "info" | "warn" | undefined;
6144
6295
  importPath?: string | undefined;
6145
- include?: string[] | undefined;
6146
6296
  exclude?: string[] | undefined;
6297
+ include?: string[] | undefined;
6147
6298
  registryHash?: string | undefined;
6148
6299
  receiptPath?: string | undefined;
6149
6300
  }>]>, "many">>;
@@ -6273,89 +6424,215 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6273
6424
  except: z.ZodArray<z.ZodString, "many">;
6274
6425
  prefer: z.ZodEnum<["token", "css-variable"]>;
6275
6426
  severity: z.ZodEnum<["error", "warn", "info"]>;
6427
+ exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
6428
+ glob: z.ZodString;
6429
+ reason: z.ZodOptional<z.ZodString>;
6430
+ }, "strip", z.ZodTypeAny, {
6431
+ glob: string;
6432
+ reason?: string | undefined;
6433
+ }, {
6434
+ glob: string;
6435
+ reason?: string | undefined;
6436
+ }>]>, "many">>;
6276
6437
  }, "strip", z.ZodTypeAny, {
6277
6438
  kind: "style.rawColors.forbid";
6278
6439
  severity: "error" | "info" | "warn";
6279
6440
  except: string[];
6280
6441
  prefer: "token" | "css-variable";
6442
+ exclude?: (string | {
6443
+ glob: string;
6444
+ reason?: string | undefined;
6445
+ })[] | undefined;
6281
6446
  }, {
6282
6447
  kind: "style.rawColors.forbid";
6283
6448
  severity: "error" | "info" | "warn";
6284
6449
  except: string[];
6285
6450
  prefer: "token" | "css-variable";
6451
+ exclude?: (string | {
6452
+ glob: string;
6453
+ reason?: string | undefined;
6454
+ })[] | undefined;
6286
6455
  }>, z.ZodObject<{
6287
6456
  kind: z.ZodLiteral<"style.rawDimensions.forbid">;
6288
6457
  appliesTo: z.ZodArray<z.ZodString, "many">;
6289
6458
  prefer: z.ZodEnum<["token", "css-variable"]>;
6290
6459
  severity: z.ZodEnum<["error", "warn", "info"]>;
6460
+ exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
6461
+ glob: z.ZodString;
6462
+ reason: z.ZodOptional<z.ZodString>;
6463
+ }, "strip", z.ZodTypeAny, {
6464
+ glob: string;
6465
+ reason?: string | undefined;
6466
+ }, {
6467
+ glob: string;
6468
+ reason?: string | undefined;
6469
+ }>]>, "many">>;
6291
6470
  }, "strip", z.ZodTypeAny, {
6292
6471
  kind: "style.rawDimensions.forbid";
6293
6472
  severity: "error" | "info" | "warn";
6294
6473
  prefer: "token" | "css-variable";
6295
6474
  appliesTo: string[];
6475
+ exclude?: (string | {
6476
+ glob: string;
6477
+ reason?: string | undefined;
6478
+ })[] | undefined;
6296
6479
  }, {
6297
6480
  kind: "style.rawDimensions.forbid";
6298
6481
  severity: "error" | "info" | "warn";
6299
6482
  prefer: "token" | "css-variable";
6300
6483
  appliesTo: string[];
6484
+ exclude?: (string | {
6485
+ glob: string;
6486
+ reason?: string | undefined;
6487
+ })[] | undefined;
6301
6488
  }>, z.ZodObject<{
6302
6489
  kind: z.ZodLiteral<"style.rawSpacing.mustMatchScale">;
6303
6490
  scale: z.ZodString;
6304
6491
  appliesTo: z.ZodArray<z.ZodString, "many">;
6305
6492
  severity: z.ZodEnum<["error", "warn", "info"]>;
6493
+ exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
6494
+ glob: z.ZodString;
6495
+ reason: z.ZodOptional<z.ZodString>;
6496
+ }, "strip", z.ZodTypeAny, {
6497
+ glob: string;
6498
+ reason?: string | undefined;
6499
+ }, {
6500
+ glob: string;
6501
+ reason?: string | undefined;
6502
+ }>]>, "many">>;
6306
6503
  }, "strip", z.ZodTypeAny, {
6307
6504
  kind: "style.rawSpacing.mustMatchScale";
6308
6505
  severity: "error" | "info" | "warn";
6309
6506
  scale: string;
6310
6507
  appliesTo: string[];
6508
+ exclude?: (string | {
6509
+ glob: string;
6510
+ reason?: string | undefined;
6511
+ })[] | undefined;
6311
6512
  }, {
6312
6513
  kind: "style.rawSpacing.mustMatchScale";
6313
6514
  severity: "error" | "info" | "warn";
6314
6515
  scale: string;
6315
6516
  appliesTo: string[];
6517
+ exclude?: (string | {
6518
+ glob: string;
6519
+ reason?: string | undefined;
6520
+ })[] | undefined;
6316
6521
  }>, z.ZodObject<{
6317
6522
  kind: z.ZodLiteral<"style.fontSize.mustMatchScale">;
6318
6523
  scale: z.ZodString;
6319
6524
  severity: z.ZodEnum<["error", "warn", "info"]>;
6525
+ exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
6526
+ glob: z.ZodString;
6527
+ reason: z.ZodOptional<z.ZodString>;
6528
+ }, "strip", z.ZodTypeAny, {
6529
+ glob: string;
6530
+ reason?: string | undefined;
6531
+ }, {
6532
+ glob: string;
6533
+ reason?: string | undefined;
6534
+ }>]>, "many">>;
6320
6535
  }, "strip", z.ZodTypeAny, {
6321
6536
  kind: "style.fontSize.mustMatchScale";
6322
6537
  severity: "error" | "info" | "warn";
6323
6538
  scale: string;
6539
+ exclude?: (string | {
6540
+ glob: string;
6541
+ reason?: string | undefined;
6542
+ })[] | undefined;
6324
6543
  }, {
6325
6544
  kind: "style.fontSize.mustMatchScale";
6326
6545
  severity: "error" | "info" | "warn";
6327
6546
  scale: string;
6547
+ exclude?: (string | {
6548
+ glob: string;
6549
+ reason?: string | undefined;
6550
+ })[] | undefined;
6328
6551
  }>, z.ZodObject<{
6329
6552
  kind: z.ZodLiteral<"style.cssVars.mustBeDefined">;
6330
6553
  severity: z.ZodEnum<["error", "warn", "info"]>;
6554
+ exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
6555
+ glob: z.ZodString;
6556
+ reason: z.ZodOptional<z.ZodString>;
6557
+ }, "strip", z.ZodTypeAny, {
6558
+ glob: string;
6559
+ reason?: string | undefined;
6560
+ }, {
6561
+ glob: string;
6562
+ reason?: string | undefined;
6563
+ }>]>, "many">>;
6331
6564
  }, "strip", z.ZodTypeAny, {
6332
6565
  kind: "style.cssVars.mustBeDefined";
6333
6566
  severity: "error" | "info" | "warn";
6567
+ exclude?: (string | {
6568
+ glob: string;
6569
+ reason?: string | undefined;
6570
+ })[] | undefined;
6334
6571
  }, {
6335
6572
  kind: "style.cssVars.mustBeDefined";
6336
6573
  severity: "error" | "info" | "warn";
6574
+ exclude?: (string | {
6575
+ glob: string;
6576
+ reason?: string | undefined;
6577
+ })[] | undefined;
6337
6578
  }>]>, "many">>;
6338
6579
  jsx: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
6339
6580
  kind: z.ZodLiteral<"jsx.unknownProps.forbid">;
6340
6581
  severity: z.ZodEnum<["error", "warn", "info"]>;
6582
+ exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
6583
+ glob: z.ZodString;
6584
+ reason: z.ZodOptional<z.ZodString>;
6585
+ }, "strip", z.ZodTypeAny, {
6586
+ glob: string;
6587
+ reason?: string | undefined;
6588
+ }, {
6589
+ glob: string;
6590
+ reason?: string | undefined;
6591
+ }>]>, "many">>;
6341
6592
  }, "strip", z.ZodTypeAny, {
6342
6593
  kind: "jsx.unknownProps.forbid";
6343
6594
  severity: "error" | "info" | "warn";
6595
+ exclude?: (string | {
6596
+ glob: string;
6597
+ reason?: string | undefined;
6598
+ })[] | undefined;
6344
6599
  }, {
6345
6600
  kind: "jsx.unknownProps.forbid";
6346
6601
  severity: "error" | "info" | "warn";
6602
+ exclude?: (string | {
6603
+ glob: string;
6604
+ reason?: string | undefined;
6605
+ })[] | undefined;
6347
6606
  }>, z.ZodObject<{
6348
6607
  kind: z.ZodLiteral<"jsx.inlineStyle.forbidRaw">;
6349
6608
  properties: z.ZodArray<z.ZodString, "many">;
6350
6609
  severity: z.ZodEnum<["error", "warn", "info"]>;
6610
+ exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
6611
+ glob: z.ZodString;
6612
+ reason: z.ZodOptional<z.ZodString>;
6613
+ }, "strip", z.ZodTypeAny, {
6614
+ glob: string;
6615
+ reason?: string | undefined;
6616
+ }, {
6617
+ glob: string;
6618
+ reason?: string | undefined;
6619
+ }>]>, "many">>;
6351
6620
  }, "strip", z.ZodTypeAny, {
6352
6621
  kind: "jsx.inlineStyle.forbidRaw";
6353
6622
  severity: "error" | "info" | "warn";
6354
6623
  properties: string[];
6624
+ exclude?: (string | {
6625
+ glob: string;
6626
+ reason?: string | undefined;
6627
+ })[] | undefined;
6355
6628
  }, {
6356
6629
  kind: "jsx.inlineStyle.forbidRaw";
6357
6630
  severity: "error" | "info" | "warn";
6358
6631
  properties: string[];
6632
+ exclude?: (string | {
6633
+ glob: string;
6634
+ reason?: string | undefined;
6635
+ })[] | undefined;
6359
6636
  }>, z.ZodObject<{
6360
6637
  kind: z.ZodLiteral<"jsx.importPath.prefer">;
6361
6638
  from: z.ZodString;
@@ -6363,11 +6640,25 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6363
6640
  imported: z.ZodOptional<z.ZodString>;
6364
6641
  because: z.ZodOptional<z.ZodString>;
6365
6642
  severity: z.ZodEnum<["error", "warn", "info"]>;
6643
+ exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
6644
+ glob: z.ZodString;
6645
+ reason: z.ZodOptional<z.ZodString>;
6646
+ }, "strip", z.ZodTypeAny, {
6647
+ glob: string;
6648
+ reason?: string | undefined;
6649
+ }, {
6650
+ glob: string;
6651
+ reason?: string | undefined;
6652
+ }>]>, "many">>;
6366
6653
  }, "strip", z.ZodTypeAny, {
6367
6654
  kind: "jsx.importPath.prefer";
6368
6655
  from: string;
6369
6656
  to: string;
6370
6657
  severity: "error" | "info" | "warn";
6658
+ exclude?: (string | {
6659
+ glob: string;
6660
+ reason?: string | undefined;
6661
+ })[] | undefined;
6371
6662
  imported?: string | undefined;
6372
6663
  because?: string | undefined;
6373
6664
  }, {
@@ -6375,6 +6666,10 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6375
6666
  from: string;
6376
6667
  to: string;
6377
6668
  severity: "error" | "info" | "warn";
6669
+ exclude?: (string | {
6670
+ glob: string;
6671
+ reason?: string | undefined;
6672
+ })[] | undefined;
6378
6673
  imported?: string | undefined;
6379
6674
  because?: string | undefined;
6380
6675
  }>, z.ZodObject<{
@@ -6383,17 +6678,35 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6383
6678
  to: z.ZodString;
6384
6679
  because: z.ZodOptional<z.ZodString>;
6385
6680
  severity: z.ZodEnum<["error", "warn", "info"]>;
6681
+ exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
6682
+ glob: z.ZodString;
6683
+ reason: z.ZodOptional<z.ZodString>;
6684
+ }, "strip", z.ZodTypeAny, {
6685
+ glob: string;
6686
+ reason?: string | undefined;
6687
+ }, {
6688
+ glob: string;
6689
+ reason?: string | undefined;
6690
+ }>]>, "many">>;
6386
6691
  }, "strip", z.ZodTypeAny, {
6387
6692
  kind: "jsx.component.prefer";
6388
6693
  from: string;
6389
6694
  to: string;
6390
6695
  severity: "error" | "info" | "warn";
6696
+ exclude?: (string | {
6697
+ glob: string;
6698
+ reason?: string | undefined;
6699
+ })[] | undefined;
6391
6700
  because?: string | undefined;
6392
6701
  }, {
6393
6702
  kind: "jsx.component.prefer";
6394
6703
  from: string;
6395
6704
  to: string;
6396
6705
  severity: "error" | "info" | "warn";
6706
+ exclude?: (string | {
6707
+ glob: string;
6708
+ reason?: string | undefined;
6709
+ })[] | undefined;
6397
6710
  because?: string | undefined;
6398
6711
  }>]>, "many">>;
6399
6712
  tailwind: z.ZodOptional<z.ZodObject<{
@@ -6793,10 +7106,13 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6793
7106
  }>, "many">>;
6794
7107
  ci: z.ZodOptional<z.ZodObject<{
6795
7108
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
7109
+ failOnInert: z.ZodOptional<z.ZodBoolean>;
6796
7110
  }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
6797
7111
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
7112
+ failOnInert: z.ZodOptional<z.ZodBoolean>;
6798
7113
  }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
6799
7114
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
7115
+ failOnInert: z.ZodOptional<z.ZodBoolean>;
6800
7116
  }, z.ZodTypeAny, "passthrough">>>;
6801
7117
  }, "strict", z.ZodTypeAny, {
6802
7118
  components?: Record<string, {
@@ -6844,36 +7160,68 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6844
7160
  severity: "error" | "info" | "warn";
6845
7161
  except: string[];
6846
7162
  prefer: "token" | "css-variable";
7163
+ exclude?: (string | {
7164
+ glob: string;
7165
+ reason?: string | undefined;
7166
+ })[] | undefined;
6847
7167
  } | {
6848
7168
  kind: "style.rawDimensions.forbid";
6849
7169
  severity: "error" | "info" | "warn";
6850
7170
  prefer: "token" | "css-variable";
6851
7171
  appliesTo: string[];
7172
+ exclude?: (string | {
7173
+ glob: string;
7174
+ reason?: string | undefined;
7175
+ })[] | undefined;
6852
7176
  } | {
6853
7177
  kind: "style.rawSpacing.mustMatchScale";
6854
7178
  severity: "error" | "info" | "warn";
6855
7179
  scale: string;
6856
7180
  appliesTo: string[];
7181
+ exclude?: (string | {
7182
+ glob: string;
7183
+ reason?: string | undefined;
7184
+ })[] | undefined;
6857
7185
  } | {
6858
7186
  kind: "style.fontSize.mustMatchScale";
6859
7187
  severity: "error" | "info" | "warn";
6860
7188
  scale: string;
7189
+ exclude?: (string | {
7190
+ glob: string;
7191
+ reason?: string | undefined;
7192
+ })[] | undefined;
6861
7193
  } | {
6862
7194
  kind: "style.cssVars.mustBeDefined";
6863
7195
  severity: "error" | "info" | "warn";
7196
+ exclude?: (string | {
7197
+ glob: string;
7198
+ reason?: string | undefined;
7199
+ })[] | undefined;
6864
7200
  })[] | undefined;
6865
7201
  jsx?: ({
6866
7202
  kind: "jsx.unknownProps.forbid";
6867
7203
  severity: "error" | "info" | "warn";
7204
+ exclude?: (string | {
7205
+ glob: string;
7206
+ reason?: string | undefined;
7207
+ })[] | undefined;
6868
7208
  } | {
6869
7209
  kind: "jsx.inlineStyle.forbidRaw";
6870
7210
  severity: "error" | "info" | "warn";
6871
7211
  properties: string[];
7212
+ exclude?: (string | {
7213
+ glob: string;
7214
+ reason?: string | undefined;
7215
+ })[] | undefined;
6872
7216
  } | {
6873
7217
  kind: "jsx.importPath.prefer";
6874
7218
  from: string;
6875
7219
  to: string;
6876
7220
  severity: "error" | "info" | "warn";
7221
+ exclude?: (string | {
7222
+ glob: string;
7223
+ reason?: string | undefined;
7224
+ })[] | undefined;
6877
7225
  imported?: string | undefined;
6878
7226
  because?: string | undefined;
6879
7227
  } | {
@@ -6881,6 +7229,10 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6881
7229
  from: string;
6882
7230
  to: string;
6883
7231
  severity: "error" | "info" | "warn";
7232
+ exclude?: (string | {
7233
+ glob: string;
7234
+ reason?: string | undefined;
7235
+ })[] | undefined;
6884
7236
  because?: string | undefined;
6885
7237
  })[] | undefined;
6886
7238
  tailwind?: z.objectOutputType<{
@@ -6946,14 +7298,14 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6946
7298
  canonicalSources?: ({
6947
7299
  kind: "npm";
6948
7300
  specifier: string;
7301
+ exclude?: string[] | undefined;
6949
7302
  implementationPath?: string | undefined;
6950
7303
  include?: string[] | undefined;
6951
- exclude?: string[] | undefined;
6952
7304
  } | {
6953
7305
  path: string;
6954
7306
  kind: "directory";
6955
- include?: string[] | undefined;
6956
7307
  exclude?: string[] | undefined;
7308
+ include?: string[] | undefined;
6957
7309
  } | {
6958
7310
  kind: "registry";
6959
7311
  registryId: string;
@@ -6961,8 +7313,8 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6961
7313
  installPath: string;
6962
7314
  severity?: "error" | "info" | "warn" | undefined;
6963
7315
  importPath?: string | undefined;
6964
- include?: string[] | undefined;
6965
7316
  exclude?: string[] | undefined;
7317
+ include?: string[] | undefined;
6966
7318
  registryHash?: string | undefined;
6967
7319
  })[] | undefined;
6968
7320
  canonicalBridges?: {
@@ -6987,6 +7339,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6987
7339
  }, z.ZodTypeAny, "passthrough"> | undefined;
6988
7340
  ci?: z.objectOutputType<{
6989
7341
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
7342
+ failOnInert: z.ZodOptional<z.ZodBoolean>;
6990
7343
  }, z.ZodTypeAny, "passthrough"> | undefined;
6991
7344
  }, {
6992
7345
  components?: Record<string, {
@@ -7034,36 +7387,68 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7034
7387
  severity: "error" | "info" | "warn";
7035
7388
  except: string[];
7036
7389
  prefer: "token" | "css-variable";
7390
+ exclude?: (string | {
7391
+ glob: string;
7392
+ reason?: string | undefined;
7393
+ })[] | undefined;
7037
7394
  } | {
7038
7395
  kind: "style.rawDimensions.forbid";
7039
7396
  severity: "error" | "info" | "warn";
7040
7397
  prefer: "token" | "css-variable";
7041
7398
  appliesTo: string[];
7399
+ exclude?: (string | {
7400
+ glob: string;
7401
+ reason?: string | undefined;
7402
+ })[] | undefined;
7042
7403
  } | {
7043
7404
  kind: "style.rawSpacing.mustMatchScale";
7044
7405
  severity: "error" | "info" | "warn";
7045
7406
  scale: string;
7046
7407
  appliesTo: string[];
7408
+ exclude?: (string | {
7409
+ glob: string;
7410
+ reason?: string | undefined;
7411
+ })[] | undefined;
7047
7412
  } | {
7048
7413
  kind: "style.fontSize.mustMatchScale";
7049
7414
  severity: "error" | "info" | "warn";
7050
7415
  scale: string;
7416
+ exclude?: (string | {
7417
+ glob: string;
7418
+ reason?: string | undefined;
7419
+ })[] | undefined;
7051
7420
  } | {
7052
7421
  kind: "style.cssVars.mustBeDefined";
7053
7422
  severity: "error" | "info" | "warn";
7423
+ exclude?: (string | {
7424
+ glob: string;
7425
+ reason?: string | undefined;
7426
+ })[] | undefined;
7054
7427
  })[] | undefined;
7055
7428
  jsx?: ({
7056
7429
  kind: "jsx.unknownProps.forbid";
7057
7430
  severity: "error" | "info" | "warn";
7431
+ exclude?: (string | {
7432
+ glob: string;
7433
+ reason?: string | undefined;
7434
+ })[] | undefined;
7058
7435
  } | {
7059
7436
  kind: "jsx.inlineStyle.forbidRaw";
7060
7437
  severity: "error" | "info" | "warn";
7061
7438
  properties: string[];
7439
+ exclude?: (string | {
7440
+ glob: string;
7441
+ reason?: string | undefined;
7442
+ })[] | undefined;
7062
7443
  } | {
7063
7444
  kind: "jsx.importPath.prefer";
7064
7445
  from: string;
7065
7446
  to: string;
7066
7447
  severity: "error" | "info" | "warn";
7448
+ exclude?: (string | {
7449
+ glob: string;
7450
+ reason?: string | undefined;
7451
+ })[] | undefined;
7067
7452
  imported?: string | undefined;
7068
7453
  because?: string | undefined;
7069
7454
  } | {
@@ -7071,6 +7456,10 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7071
7456
  from: string;
7072
7457
  to: string;
7073
7458
  severity: "error" | "info" | "warn";
7459
+ exclude?: (string | {
7460
+ glob: string;
7461
+ reason?: string | undefined;
7462
+ })[] | undefined;
7074
7463
  because?: string | undefined;
7075
7464
  })[] | undefined;
7076
7465
  tailwind?: z.objectInputType<{
@@ -7136,22 +7525,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7136
7525
  canonicalSources?: ({
7137
7526
  kind: "npm";
7138
7527
  specifier: string;
7528
+ exclude?: string[] | undefined;
7139
7529
  implementationPath?: string | undefined;
7140
7530
  include?: string[] | undefined;
7141
- exclude?: string[] | undefined;
7142
7531
  } | {
7143
7532
  path: string;
7144
7533
  kind: "directory";
7145
- include?: string[] | undefined;
7146
7534
  exclude?: string[] | undefined;
7535
+ include?: string[] | undefined;
7147
7536
  } | {
7148
7537
  kind: "registry";
7149
7538
  registryId: string;
7150
7539
  installPath: string;
7151
7540
  severity?: "error" | "info" | "warn" | undefined;
7152
7541
  importPath?: string | undefined;
7153
- include?: string[] | undefined;
7154
7542
  exclude?: string[] | undefined;
7543
+ include?: string[] | undefined;
7155
7544
  registryHash?: string | undefined;
7156
7545
  receiptPath?: string | undefined;
7157
7546
  })[] | undefined;
@@ -7177,6 +7566,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7177
7566
  }, z.ZodTypeAny, "passthrough"> | undefined;
7178
7567
  ci?: z.objectInputType<{
7179
7568
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
7569
+ failOnInert: z.ZodOptional<z.ZodBoolean>;
7180
7570
  }, z.ZodTypeAny, "passthrough"> | undefined;
7181
7571
  }>>;
7182
7572
  inspect: z.ZodOptional<z.ZodObject<{
@@ -7268,6 +7658,47 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7268
7658
  }[] | undefined;
7269
7659
  }>>;
7270
7660
  }, "strip", z.ZodTypeAny, {
7661
+ components?: string[] | undefined;
7662
+ screenshots?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
7663
+ tokens?: z.objectOutputType<{
7664
+ include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7665
+ sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
7666
+ path: z.ZodEffects<z.ZodString, string, string>;
7667
+ format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7668
+ }, "strip", z.ZodTypeAny, {
7669
+ path: string;
7670
+ format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7671
+ }, {
7672
+ path: string;
7673
+ format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7674
+ }>, "many">>;
7675
+ packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7676
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7677
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
7678
+ packageName: z.ZodString;
7679
+ version: z.ZodOptional<z.ZodString>;
7680
+ digest: z.ZodOptional<z.ZodString>;
7681
+ }, "strip", z.ZodTypeAny, {
7682
+ packageName: string;
7683
+ version?: string | undefined;
7684
+ digest?: string | undefined;
7685
+ }, {
7686
+ packageName: string;
7687
+ version?: string | undefined;
7688
+ digest?: string | undefined;
7689
+ }>, "many">>;
7690
+ exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7691
+ themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7692
+ enabled: z.ZodOptional<z.ZodBoolean>;
7693
+ format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7694
+ namespace: z.ZodOptional<z.ZodString>;
7695
+ }, z.ZodTypeAny, "passthrough"> | undefined;
7696
+ performance?: "strict" | "relaxed" | "standard" | {
7697
+ preset?: "strict" | "relaxed" | "standard" | undefined;
7698
+ budgets?: {
7699
+ bundleSize?: number | undefined;
7700
+ } | undefined;
7701
+ } | undefined;
7271
7702
  govern?: {
7272
7703
  components?: Record<string, {
7273
7704
  rules: ({
@@ -7314,36 +7745,68 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7314
7745
  severity: "error" | "info" | "warn";
7315
7746
  except: string[];
7316
7747
  prefer: "token" | "css-variable";
7748
+ exclude?: (string | {
7749
+ glob: string;
7750
+ reason?: string | undefined;
7751
+ })[] | undefined;
7317
7752
  } | {
7318
7753
  kind: "style.rawDimensions.forbid";
7319
7754
  severity: "error" | "info" | "warn";
7320
7755
  prefer: "token" | "css-variable";
7321
7756
  appliesTo: string[];
7757
+ exclude?: (string | {
7758
+ glob: string;
7759
+ reason?: string | undefined;
7760
+ })[] | undefined;
7322
7761
  } | {
7323
7762
  kind: "style.rawSpacing.mustMatchScale";
7324
7763
  severity: "error" | "info" | "warn";
7325
7764
  scale: string;
7326
7765
  appliesTo: string[];
7766
+ exclude?: (string | {
7767
+ glob: string;
7768
+ reason?: string | undefined;
7769
+ })[] | undefined;
7327
7770
  } | {
7328
7771
  kind: "style.fontSize.mustMatchScale";
7329
7772
  severity: "error" | "info" | "warn";
7330
7773
  scale: string;
7774
+ exclude?: (string | {
7775
+ glob: string;
7776
+ reason?: string | undefined;
7777
+ })[] | undefined;
7331
7778
  } | {
7332
7779
  kind: "style.cssVars.mustBeDefined";
7333
7780
  severity: "error" | "info" | "warn";
7781
+ exclude?: (string | {
7782
+ glob: string;
7783
+ reason?: string | undefined;
7784
+ })[] | undefined;
7334
7785
  })[] | undefined;
7335
7786
  jsx?: ({
7336
7787
  kind: "jsx.unknownProps.forbid";
7337
7788
  severity: "error" | "info" | "warn";
7789
+ exclude?: (string | {
7790
+ glob: string;
7791
+ reason?: string | undefined;
7792
+ })[] | undefined;
7338
7793
  } | {
7339
7794
  kind: "jsx.inlineStyle.forbidRaw";
7340
7795
  severity: "error" | "info" | "warn";
7341
7796
  properties: string[];
7797
+ exclude?: (string | {
7798
+ glob: string;
7799
+ reason?: string | undefined;
7800
+ })[] | undefined;
7342
7801
  } | {
7343
7802
  kind: "jsx.importPath.prefer";
7344
7803
  from: string;
7345
7804
  to: string;
7346
7805
  severity: "error" | "info" | "warn";
7806
+ exclude?: (string | {
7807
+ glob: string;
7808
+ reason?: string | undefined;
7809
+ })[] | undefined;
7347
7810
  imported?: string | undefined;
7348
7811
  because?: string | undefined;
7349
7812
  } | {
@@ -7351,6 +7814,10 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7351
7814
  from: string;
7352
7815
  to: string;
7353
7816
  severity: "error" | "info" | "warn";
7817
+ exclude?: (string | {
7818
+ glob: string;
7819
+ reason?: string | undefined;
7820
+ })[] | undefined;
7354
7821
  because?: string | undefined;
7355
7822
  })[] | undefined;
7356
7823
  tailwind?: z.objectOutputType<{
@@ -7416,14 +7883,14 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7416
7883
  canonicalSources?: ({
7417
7884
  kind: "npm";
7418
7885
  specifier: string;
7886
+ exclude?: string[] | undefined;
7419
7887
  implementationPath?: string | undefined;
7420
7888
  include?: string[] | undefined;
7421
- exclude?: string[] | undefined;
7422
7889
  } | {
7423
7890
  path: string;
7424
7891
  kind: "directory";
7425
- include?: string[] | undefined;
7426
7892
  exclude?: string[] | undefined;
7893
+ include?: string[] | undefined;
7427
7894
  } | {
7428
7895
  kind: "registry";
7429
7896
  registryId: string;
@@ -7431,8 +7898,8 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7431
7898
  installPath: string;
7432
7899
  severity?: "error" | "info" | "warn" | undefined;
7433
7900
  importPath?: string | undefined;
7434
- include?: string[] | undefined;
7435
7901
  exclude?: string[] | undefined;
7902
+ include?: string[] | undefined;
7436
7903
  registryHash?: string | undefined;
7437
7904
  })[] | undefined;
7438
7905
  canonicalBridges?: {
@@ -7457,60 +7924,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7457
7924
  }, z.ZodTypeAny, "passthrough"> | undefined;
7458
7925
  ci?: z.objectOutputType<{
7459
7926
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
7927
+ failOnInert: z.ZodOptional<z.ZodBoolean>;
7460
7928
  }, z.ZodTypeAny, "passthrough"> | undefined;
7461
7929
  } | undefined;
7462
- components?: string[] | undefined;
7463
- screenshots?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
7464
- tokens?: z.objectOutputType<{
7465
- include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7466
- sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
7467
- path: z.ZodEffects<z.ZodString, string, string>;
7468
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7469
- }, "strip", z.ZodTypeAny, {
7470
- path: string;
7471
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7472
- }, {
7473
- path: string;
7474
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7475
- }>, "many">>;
7476
- packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7477
- aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7478
- upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
7479
- packageName: z.ZodString;
7480
- version: z.ZodOptional<z.ZodString>;
7481
- digest: z.ZodOptional<z.ZodString>;
7482
- }, "strip", z.ZodTypeAny, {
7483
- packageName: string;
7484
- version?: string | undefined;
7485
- digest?: string | undefined;
7486
- }, {
7487
- packageName: string;
7488
- version?: string | undefined;
7489
- digest?: string | undefined;
7490
- }>, "many">>;
7491
- exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7492
- themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7493
- enabled: z.ZodOptional<z.ZodBoolean>;
7494
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7495
- namespace: z.ZodOptional<z.ZodString>;
7496
- }, z.ZodTypeAny, "passthrough"> | undefined;
7497
- performance?: "strict" | "relaxed" | "standard" | {
7498
- preset?: "strict" | "relaxed" | "standard" | undefined;
7499
- budgets?: {
7500
- bundleSize?: number | undefined;
7501
- } | undefined;
7502
- } | undefined;
7503
- include?: string[] | undefined;
7504
7930
  exclude?: string[] | undefined;
7931
+ include?: string[] | undefined;
7505
7932
  registry?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
7506
7933
  app?: {
7507
7934
  path?: string | undefined;
7508
- include?: string[] | undefined;
7509
7935
  exclude?: string[] | undefined;
7936
+ include?: string[] | undefined;
7510
7937
  } | undefined;
7511
7938
  storybook?: {
7512
- include?: string[] | undefined;
7513
7939
  exclude?: string[] | undefined;
7940
+ include?: string[] | undefined;
7514
7941
  excludeDeprecated?: boolean | undefined;
7515
7942
  excludeTests?: boolean | undefined;
7516
7943
  excludeSvgIcons?: boolean | undefined;
@@ -7566,6 +7993,47 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7566
7993
  }[] | undefined;
7567
7994
  } | undefined;
7568
7995
  }, {
7996
+ components?: string[] | undefined;
7997
+ screenshots?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
7998
+ tokens?: z.objectInputType<{
7999
+ include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
8000
+ sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
8001
+ path: z.ZodEffects<z.ZodString, string, string>;
8002
+ format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
8003
+ }, "strip", z.ZodTypeAny, {
8004
+ path: string;
8005
+ format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
8006
+ }, {
8007
+ path: string;
8008
+ format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
8009
+ }>, "many">>;
8010
+ packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
8011
+ aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8012
+ upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
8013
+ packageName: z.ZodString;
8014
+ version: z.ZodOptional<z.ZodString>;
8015
+ digest: z.ZodOptional<z.ZodString>;
8016
+ }, "strip", z.ZodTypeAny, {
8017
+ packageName: string;
8018
+ version?: string | undefined;
8019
+ digest?: string | undefined;
8020
+ }, {
8021
+ packageName: string;
8022
+ version?: string | undefined;
8023
+ digest?: string | undefined;
8024
+ }>, "many">>;
8025
+ exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
8026
+ themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8027
+ enabled: z.ZodOptional<z.ZodBoolean>;
8028
+ format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
8029
+ namespace: z.ZodOptional<z.ZodString>;
8030
+ }, z.ZodTypeAny, "passthrough"> | undefined;
8031
+ performance?: "strict" | "relaxed" | "standard" | {
8032
+ preset?: "strict" | "relaxed" | "standard" | undefined;
8033
+ budgets?: {
8034
+ bundleSize?: number | undefined;
8035
+ } | undefined;
8036
+ } | undefined;
7569
8037
  govern?: {
7570
8038
  components?: Record<string, {
7571
8039
  rules: ({
@@ -7612,36 +8080,68 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7612
8080
  severity: "error" | "info" | "warn";
7613
8081
  except: string[];
7614
8082
  prefer: "token" | "css-variable";
8083
+ exclude?: (string | {
8084
+ glob: string;
8085
+ reason?: string | undefined;
8086
+ })[] | undefined;
7615
8087
  } | {
7616
8088
  kind: "style.rawDimensions.forbid";
7617
8089
  severity: "error" | "info" | "warn";
7618
8090
  prefer: "token" | "css-variable";
7619
8091
  appliesTo: string[];
8092
+ exclude?: (string | {
8093
+ glob: string;
8094
+ reason?: string | undefined;
8095
+ })[] | undefined;
7620
8096
  } | {
7621
8097
  kind: "style.rawSpacing.mustMatchScale";
7622
8098
  severity: "error" | "info" | "warn";
7623
8099
  scale: string;
7624
8100
  appliesTo: string[];
8101
+ exclude?: (string | {
8102
+ glob: string;
8103
+ reason?: string | undefined;
8104
+ })[] | undefined;
7625
8105
  } | {
7626
8106
  kind: "style.fontSize.mustMatchScale";
7627
8107
  severity: "error" | "info" | "warn";
7628
8108
  scale: string;
8109
+ exclude?: (string | {
8110
+ glob: string;
8111
+ reason?: string | undefined;
8112
+ })[] | undefined;
7629
8113
  } | {
7630
8114
  kind: "style.cssVars.mustBeDefined";
7631
8115
  severity: "error" | "info" | "warn";
8116
+ exclude?: (string | {
8117
+ glob: string;
8118
+ reason?: string | undefined;
8119
+ })[] | undefined;
7632
8120
  })[] | undefined;
7633
8121
  jsx?: ({
7634
8122
  kind: "jsx.unknownProps.forbid";
7635
8123
  severity: "error" | "info" | "warn";
8124
+ exclude?: (string | {
8125
+ glob: string;
8126
+ reason?: string | undefined;
8127
+ })[] | undefined;
7636
8128
  } | {
7637
8129
  kind: "jsx.inlineStyle.forbidRaw";
7638
8130
  severity: "error" | "info" | "warn";
7639
8131
  properties: string[];
8132
+ exclude?: (string | {
8133
+ glob: string;
8134
+ reason?: string | undefined;
8135
+ })[] | undefined;
7640
8136
  } | {
7641
8137
  kind: "jsx.importPath.prefer";
7642
8138
  from: string;
7643
8139
  to: string;
7644
8140
  severity: "error" | "info" | "warn";
8141
+ exclude?: (string | {
8142
+ glob: string;
8143
+ reason?: string | undefined;
8144
+ })[] | undefined;
7645
8145
  imported?: string | undefined;
7646
8146
  because?: string | undefined;
7647
8147
  } | {
@@ -7649,6 +8149,10 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7649
8149
  from: string;
7650
8150
  to: string;
7651
8151
  severity: "error" | "info" | "warn";
8152
+ exclude?: (string | {
8153
+ glob: string;
8154
+ reason?: string | undefined;
8155
+ })[] | undefined;
7652
8156
  because?: string | undefined;
7653
8157
  })[] | undefined;
7654
8158
  tailwind?: z.objectInputType<{
@@ -7714,22 +8218,22 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7714
8218
  canonicalSources?: ({
7715
8219
  kind: "npm";
7716
8220
  specifier: string;
8221
+ exclude?: string[] | undefined;
7717
8222
  implementationPath?: string | undefined;
7718
8223
  include?: string[] | undefined;
7719
- exclude?: string[] | undefined;
7720
8224
  } | {
7721
8225
  path: string;
7722
8226
  kind: "directory";
7723
- include?: string[] | undefined;
7724
8227
  exclude?: string[] | undefined;
8228
+ include?: string[] | undefined;
7725
8229
  } | {
7726
8230
  kind: "registry";
7727
8231
  registryId: string;
7728
8232
  installPath: string;
7729
8233
  severity?: "error" | "info" | "warn" | undefined;
7730
8234
  importPath?: string | undefined;
7731
- include?: string[] | undefined;
7732
8235
  exclude?: string[] | undefined;
8236
+ include?: string[] | undefined;
7733
8237
  registryHash?: string | undefined;
7734
8238
  receiptPath?: string | undefined;
7735
8239
  })[] | undefined;
@@ -7755,60 +8259,20 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7755
8259
  }, z.ZodTypeAny, "passthrough"> | undefined;
7756
8260
  ci?: z.objectInputType<{
7757
8261
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
8262
+ failOnInert: z.ZodOptional<z.ZodBoolean>;
7758
8263
  }, z.ZodTypeAny, "passthrough"> | undefined;
7759
8264
  } | undefined;
7760
- components?: string[] | undefined;
7761
- screenshots?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
7762
- tokens?: z.objectInputType<{
7763
- include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7764
- sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
7765
- path: z.ZodEffects<z.ZodString, string, string>;
7766
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7767
- }, "strip", z.ZodTypeAny, {
7768
- path: string;
7769
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7770
- }, {
7771
- path: string;
7772
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7773
- }>, "many">>;
7774
- packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7775
- aliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7776
- upstream: z.ZodOptional<z.ZodArray<z.ZodObject<{
7777
- packageName: z.ZodString;
7778
- version: z.ZodOptional<z.ZodString>;
7779
- digest: z.ZodOptional<z.ZodString>;
7780
- }, "strip", z.ZodTypeAny, {
7781
- packageName: string;
7782
- version?: string | undefined;
7783
- digest?: string | undefined;
7784
- }, {
7785
- packageName: string;
7786
- version?: string | undefined;
7787
- digest?: string | undefined;
7788
- }>, "many">>;
7789
- exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7790
- themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7791
- enabled: z.ZodOptional<z.ZodBoolean>;
7792
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7793
- namespace: z.ZodOptional<z.ZodString>;
7794
- }, z.ZodTypeAny, "passthrough"> | undefined;
7795
- performance?: "strict" | "relaxed" | "standard" | {
7796
- preset?: "strict" | "relaxed" | "standard" | undefined;
7797
- budgets?: {
7798
- bundleSize?: number | undefined;
7799
- } | undefined;
7800
- } | undefined;
7801
- include?: string[] | undefined;
7802
8265
  exclude?: string[] | undefined;
8266
+ include?: string[] | undefined;
7803
8267
  registry?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
7804
8268
  app?: {
7805
8269
  path?: string | undefined;
7806
- include?: string[] | undefined;
7807
8270
  exclude?: string[] | undefined;
8271
+ include?: string[] | undefined;
7808
8272
  } | undefined;
7809
8273
  storybook?: {
7810
- include?: string[] | undefined;
7811
8274
  exclude?: string[] | undefined;
8275
+ include?: string[] | undefined;
7812
8276
  excludeDeprecated?: boolean | undefined;
7813
8277
  excludeTests?: boolean | undefined;
7814
8278
  excludeSvgIcons?: boolean | undefined;
@@ -9291,7 +9755,6 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
9291
9755
  guidelines?: string[] | undefined;
9292
9756
  accessibility?: string[] | undefined;
9293
9757
  };
9294
- govern?: ((...args: unknown[]) => unknown) | undefined;
9295
9758
  composition?: {
9296
9759
  pattern?: "compound" | "simple" | "controlled" | "wrapper" | undefined;
9297
9760
  subComponents?: string[] | undefined;
@@ -9307,6 +9770,7 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
9307
9770
  constraints?: string[] | undefined;
9308
9771
  typeDetails?: Record<string, unknown> | undefined;
9309
9772
  }> | undefined;
9773
+ govern?: ((...args: unknown[]) => unknown) | undefined;
9310
9774
  contract?: {
9311
9775
  composition?: {
9312
9776
  rule: {
@@ -9437,7 +9901,6 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
9437
9901
  guidelines?: string[] | undefined;
9438
9902
  accessibility?: string[] | undefined;
9439
9903
  };
9440
- govern?: ((...args: unknown[]) => unknown) | undefined;
9441
9904
  composition?: {
9442
9905
  pattern?: "compound" | "simple" | "controlled" | "wrapper" | undefined;
9443
9906
  subComponents?: string[] | undefined;
@@ -9453,6 +9916,7 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
9453
9916
  constraints?: string[] | undefined;
9454
9917
  typeDetails?: Record<string, unknown> | undefined;
9455
9918
  }> | undefined;
9919
+ govern?: ((...args: unknown[]) => unknown) | undefined;
9456
9920
  contract?: {
9457
9921
  composition?: {
9458
9922
  rule: {
@@ -10863,14 +11327,16 @@ declare const componentContractSchema: z.ZodObject<{
10863
11327
  name: string;
10864
11328
  sourcePath: string;
10865
11329
  exportName: string;
10866
- propsSummary: string[];
10867
11330
  usage: {
10868
11331
  when: string[];
10869
11332
  whenNot: string[];
10870
11333
  guidelines?: string[] | undefined;
10871
11334
  accessibility?: string[] | undefined;
10872
11335
  };
11336
+ propsSummary: string[];
10873
11337
  $schema: string;
11338
+ status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
11339
+ tokens?: string[] | undefined;
10874
11340
  preview?: {
10875
11341
  css?: string[] | undefined;
10876
11342
  theme?: "light" | "dark" | undefined;
@@ -10878,8 +11344,6 @@ declare const componentContractSchema: z.ZodObject<{
10878
11344
  wrapperModule?: string | undefined;
10879
11345
  wrapperExport?: string | undefined;
10880
11346
  } | undefined;
10881
- status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10882
- tokens?: string[] | undefined;
10883
11347
  contract?: {
10884
11348
  compoundChildren?: Record<string, {
10885
11349
  description?: string | undefined;
@@ -10944,14 +11408,16 @@ declare const componentContractSchema: z.ZodObject<{
10944
11408
  name: string;
10945
11409
  sourcePath: string;
10946
11410
  exportName: string;
10947
- propsSummary: string[];
10948
11411
  usage: {
10949
11412
  when: string[];
10950
11413
  whenNot: string[];
10951
11414
  guidelines?: string[] | undefined;
10952
11415
  accessibility?: string[] | undefined;
10953
11416
  };
11417
+ propsSummary: string[];
10954
11418
  $schema: string;
11419
+ status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
11420
+ tokens?: string[] | undefined;
10955
11421
  preview?: {
10956
11422
  css?: string[] | undefined;
10957
11423
  theme?: "light" | "dark" | undefined;
@@ -10959,8 +11425,6 @@ declare const componentContractSchema: z.ZodObject<{
10959
11425
  wrapperModule?: string | undefined;
10960
11426
  wrapperExport?: string | undefined;
10961
11427
  } | undefined;
10962
- status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10963
- tokens?: string[] | undefined;
10964
11428
  contract?: {
10965
11429
  compoundChildren?: Record<string, {
10966
11430
  description?: string | undefined;
@@ -11394,9 +11858,9 @@ declare function ruleTokensRequireDualFallback(ix: FactIndex): Finding[];
11394
11858
  declare function ruleThemeNoThemeCoupledLiteral(ix: FactIndex): Finding[];
11395
11859
 
11396
11860
  /**
11397
- * `a11y/required-accessible-name` — fires for components with an
11398
- * `a11y.requireName` policy whose JSX usage has no discoverable accessible
11399
- * name.
11861
+ * `a11y/required-accessible-name` — fires for a component with an authored
11862
+ * `a11y.requireName` policy, or for a statically proven control when the global
11863
+ * rule is enabled, whose JSX usage has no discoverable accessible name.
11400
11864
  *
11401
11865
  * Accepted name sources (any one is enough):
11402
11866
  * - non-empty `usage_text_child` content
@@ -11404,6 +11868,8 @@ declare function ruleThemeNoThemeCoupledLiteral(ix: FactIndex): Finding[];
11404
11868
  * dynamic value is empty at scan time)
11405
11869
  * - `aria-labelledby={...}`
11406
11870
  * - `title="..."`
11871
+ * - statically non-empty or conservatively classified runtime child content
11872
+ * on controls whose accessible-name model permits naming from contents
11407
11873
  *
11408
11874
  * Components that explicitly opt out via `aria-hidden="true"` are skipped —
11409
11875
  * they are not part of the accessibility tree.
@@ -11411,6 +11877,13 @@ declare function ruleThemeNoThemeCoupledLiteral(ix: FactIndex): Finding[];
11411
11877
 
11412
11878
  declare function ruleA11yRequiredAccessibleName(ix: FactIndex): Finding[];
11413
11879
 
11880
+ /**
11881
+ * Narrow static standard check: a non-native `role="button"` needs both a
11882
+ * keyboard-focus path and a keyboard activation handler. This intentionally
11883
+ * does not claim to be a complete WCAG or axe implementation.
11884
+ */
11885
+ declare function ruleA11yStandard(ix: FactIndex): Finding[];
11886
+
11414
11887
  /**
11415
11888
  * Rule taxonomy — the single source of truth for tier classification.
11416
11889
  *
@@ -11460,6 +11933,36 @@ declare function vocabularyRank(ruleId: string): number;
11460
11933
  /** Comparator ordering rule ids vocabulary-first (Tier A before hygiene). */
11461
11934
  declare function compareByVocabularyRank(a: string, b: string): number;
11462
11935
 
11936
+ /**
11937
+ * Rule families — the single source of truth for the broad ids a config may name
11938
+ * instead of a concrete rule.
11939
+ *
11940
+ * `govern.rules` accepts two vocabularies: a concrete rule id (`styles/no-raw-color`)
11941
+ * and a **family** id (`tokens/hardcoded-values`) that stands for several rules at once.
11942
+ * Presets and Cloud-served policies author the family form, so this expansion decides
11943
+ * what a preset or a served policy actually turns on.
11944
+ *
11945
+ * It used to be written out three times — the engine's finding-override pass, the fact
11946
+ * compiler, and the governance-integrity roster — and the three disagreed:
11947
+ * `styles/no-raw-typography` was a member of `tokens/hardcoded-values` in the engine and
11948
+ * absent from the compiler, so one config produced two different answers about the same
11949
+ * rule and nothing asserted they matched. One definition, one expansion, one coverage
11950
+ * test (`families.test.ts` checks every member is a registered rule id).
11951
+ *
11952
+ * Family ids are NOT rule ids: nothing runs under `tokens/hardcoded-values`, it only
11953
+ * expands. Adding a rule to a family is a behavior change for every config that names
11954
+ * the family — classify new rules here in the same change that registers them.
11955
+ */
11956
+ declare const RULE_FAMILY_MEMBERS: Readonly<Record<string, readonly string[]>>;
11957
+ /** The family ids themselves — recognized in `govern.rules`, never executed. */
11958
+ declare const RULE_FAMILY_IDS: ReadonlySet<string>;
11959
+ declare function isRuleFamilyId(ruleId: string): boolean;
11960
+ /**
11961
+ * The concrete rule ids a `govern.rules` key applies to: a family expands, anything
11962
+ * else is itself. Every consumer of the family vocabulary goes through this.
11963
+ */
11964
+ declare function ruleFamilyMembers(ruleId: string): readonly string[];
11965
+
11463
11966
  /**
11464
11967
  * Rule presets — the customer default vs the full `fragments` dogfood preset.
11465
11968
  *
@@ -11916,7 +12419,7 @@ declare function resolveSpacingValue(input: {
11916
12419
  *
11917
12420
  * The load-bearing distinction is **enabled ≠ armed**. A rule can be `enabled`
11918
12421
  * in the policy yet inert because it has no vocabulary to measure against:
11919
- * `components/prefer-library` with no effective canonical source enforces
12422
+ * canonical-component rules with no effective canonical source enforce
11920
12423
  * nothing; `tokens/css-vars-must-be-defined` with an empty token vocabulary
11921
12424
  * enforces nothing. This module derives, per rule *family*, whether the family
11922
12425
  * is armed (has both an enabled rule AND the vocabulary/signal it needs), then
@@ -11930,8 +12433,8 @@ declare function resolveSpacingValue(input: {
11930
12433
  */
11931
12434
 
11932
12435
  type GovernanceIntegrityStatus = "healthy" | "degraded" | "inert";
11933
- type InertConfigDiagnosticKind = "orphan-scale" | "unconsumed-key";
11934
- type InertConfigDiagnosticCode = "FUI9004" | "FUI9005";
12436
+ type InertConfigDiagnosticKind = "orphan-scale" | "unconsumed-key" | "unmatched-exclude" | "colliding-record" | "overridden-record-severity";
12437
+ type InertConfigDiagnosticCode = "FUI9004" | "FUI9005" | "FUI9006" | "FUI9007" | "FUI9008";
11935
12438
  interface InertConfigDiagnostic {
11936
12439
  code: InertConfigDiagnosticCode;
11937
12440
  kind: InertConfigDiagnosticKind;
@@ -11992,17 +12495,81 @@ interface GovernanceIntegrityVerdict {
11992
12495
  */
11993
12496
  declare function isEffectiveCanonicalSource(source: CanonicalSource): boolean;
11994
12497
  /**
11995
- * Whether `components/prefer-library`'s effective options carry a real component
12498
+ * Whether a canonical-component rule's effective options carry a real component
11996
12499
  * vocabulary: at least one canonical mapping, or at least one effective
11997
12500
  * canonical source. Accepts the raw fact `options` bag (values are `unknown`).
11998
12501
  */
11999
12502
  declare function hasEffectiveComponentVocabulary(options: Record<string, unknown> | undefined): boolean;
12503
+ /**
12504
+ * Name a config record that the fact index dropped as a first-wins duplicate.
12505
+ *
12506
+ * This is the Layer-6 backstop, not the primary mechanism: merge-time displacement
12507
+ * (`mergeGovernanceConfigs`) already makes the later record win for every shape it can
12508
+ * key. What reaches here is a collision displacement could NOT resolve — two records
12509
+ * that compile to one fact id from different channels (config vs bridge vs Cloud
12510
+ * policy). The invariant it defends: a dropped policy fact is never silent.
12511
+ *
12512
+ * Returns `null` for non-config facts, so usage/token collisions stay on the internal
12513
+ * debug channel.
12514
+ */
12515
+ declare function collidingRecordDiagnostic(conflict: FactConflict): InertConfigDiagnostic | null;
12516
+ /**
12517
+ * Aggregate every observed collision into one diagnostic per colliding fact id.
12518
+ *
12519
+ * Three same-kind records on one fact id produce TWO conflicts (first-wins keeps the
12520
+ * first and skips both others), and both render the same path. Emitting them separately
12521
+ * meant the `(code, path)` dedupe every consumer runs kept only the last pair, so the
12522
+ * intermediate record was dropped in silence — the same failure the per-kind path fixed
12523
+ * one layer down. Aggregating names the count and lists every dropped setting, and one
12524
+ * user edit still resolves the whole group.
12525
+ */
12526
+ declare function collidingRecordDiagnostics(conflicts: readonly FactConflict[]): InertConfigDiagnostic[];
12527
+ /**
12528
+ * The authored config record a policy fact was compiled from, or `null` when the fact
12529
+ * did not come from a `govern.*` record (token facts, usage facts). One table, read by
12530
+ * both the collision diagnostic and the override backstop below.
12531
+ */
12532
+ declare function configRecordShape(kind: string): {
12533
+ section: string;
12534
+ record: string;
12535
+ } | null;
12536
+ /**
12537
+ * Name a `govern.rules` override that outranks the severity a policy record authored.
12538
+ *
12539
+ * The backstop for the path provenance cannot reach. Locally, presets are merged here,
12540
+ * so a preset's broad rule entry is tagged and treated as a default — a user record's
12541
+ * `severity: "error"` wins (report #2 B4). A Cloud-served policy arrives whole: no merge
12542
+ * ran, nothing is tagged, and a broad `tokens/hardcoded-values` entry in it still
12543
+ * displaces the severity a record next to it authored. That cannot be fixed at this
12544
+ * boundary, so it is named instead. Silence is the defect; an unfixable case must at
12545
+ * least speak.
12546
+ */
12547
+ declare function overriddenRecordSeverityDiagnostic(input: {
12548
+ ruleId: string;
12549
+ /** Config path of the override that won — `govern.rules[...]` or `govern.severity`. */
12550
+ source: string;
12551
+ section: string;
12552
+ record: string;
12553
+ authored: string;
12554
+ enforced: string;
12555
+ }): InertConfigDiagnostic;
12000
12556
  /**
12001
12557
  * Diagnose config keys that the permissive validation boundary accepts but the
12002
12558
  * runtime cannot consume. The parsed config is the source of truth for stripped
12003
12559
  * keys; explicit allow-sets cover intentional `.passthrough()`/record seams.
12004
12560
  */
12005
12561
  declare function detectUnconsumedConfigKeys(authoredConfig: unknown, parsedConfig: unknown): InertConfigDiagnostic[];
12562
+ /**
12563
+ * Diagnose excludes that scope nothing: the key is consumed and the glob is valid, but
12564
+ * it matched no scanned file, so it silently exempts nothing while reading as active
12565
+ * policy. That is the same "declared ≠ armed" failure this module exists to name — a
12566
+ * stale path after a refactor is the common cause.
12567
+ *
12568
+ * `scannedFiles` are repo-relative paths supplied by the caller; core never reads the
12569
+ * filesystem. An empty scan (nothing to compare against) yields no diagnostics rather
12570
+ * than flagging every exclude.
12571
+ */
12572
+ declare function detectUnmatchedPolicyExcludes(policy: GovernanceConfig | undefined, scannedFiles: readonly string[]): InertConfigDiagnostic[];
12006
12573
  /**
12007
12574
  * Compare locally declared scales with the effective property-policy graph.
12008
12575
  * Preset-only scales are not diagnosed because the user did not declare them.
@@ -12027,6 +12594,60 @@ declare function projectCanonicalDirectionConflicts(ix: FactIndex, canonicalSour
12027
12594
  declare function canonicalDirectionConflictsTarget(conflicts: readonly CanonicalDirectionConflict[], importPath: string | undefined, exportName: string): boolean;
12028
12595
 
12029
12596
  declare function canonicalBridgeContractMappings(bridges: readonly CanonicalBridgeV1[] | undefined): ContractCanonicalMappingInput[];
12597
+ /**
12598
+ * One authored bridge, projected into the two facts a consumer needs to honor
12599
+ * it WITHOUT widening it: the npm canonical source its underlying export
12600
+ * implies, and the local component the user actually sanctioned.
12601
+ *
12602
+ * The pairing is the point. A bridge says "`src/components/Button.tsx#Button`
12603
+ * wraps `@mui/material#Button`" — a fact about ONE component. Reading only the
12604
+ * source half turns it into "`@mui/material#Button` is canonical in this repo",
12605
+ * which is a strictly wider claim: every component in the tree that happens to
12606
+ * render that export inherits the sanction it was never given.
12607
+ */
12608
+ interface CanonicalBridgeIdentityBinding {
12609
+ /** The npm canonical source this bridge's underlying export implies. */
12610
+ source: Extract<CanonicalSource, {
12611
+ kind: "npm";
12612
+ }>;
12613
+ /** The sanctioned local component — `<repo-relative-file>#<exportName>`. */
12614
+ localComponentKey: string;
12615
+ }
12616
+ /**
12617
+ * The per-component bindings an authored bridge set implies — one definition,
12618
+ * because every consumer of "which components did the user sanction, against
12619
+ * which package export" must see the same set.
12620
+ *
12621
+ * Consumed by `classify`'s RENDER_ROOT_CANONICAL context, which gates the
12622
+ * signal on `localComponentKey`: only the component the bridge names may claim
12623
+ * the bridge's canonical, so a sanction stays as narrow as the user authored it.
12624
+ */
12625
+ declare function canonicalBridgeIdentityBindings(bridges: readonly CanonicalBridgeV1[] | undefined): CanonicalBridgeIdentityBinding[];
12626
+ /**
12627
+ * The npm canonical sources an authored bridge set implies — the source half of
12628
+ * `canonicalBridgeIdentityBindings`, for consumers that resolve the whole tree
12629
+ * at once and scope the result themselves.
12630
+ *
12631
+ * A bridge states that `underlying.packageName#exportName` IS the canonical
12632
+ * thing a local component wraps, so identity resolution treats that export as
12633
+ * declared, exactly as an explicit `govern.canonicalSources` npm entry would.
12634
+ * Before this projection was shared, a repo whose decision lived only in
12635
+ * `canonicalBridges` (hand-authored, or written by `identity sanction`)
12636
+ * resolved render roots at `canonical` grade in the pipeline while the
12637
+ * classifier saw no declaration at all — the authored fact reached one consumer
12638
+ * and silently missed the other.
12639
+ *
12640
+ * Consumer: the scan pipeline's identity input
12641
+ * (`buildCanonicalDirectionIdentityInput`), which resolves render roots for the
12642
+ * whole definition set and reports the grade rather than acting on it.
12643
+ * Anything that turns the grade into an AUTHORED decision must use
12644
+ * `canonicalBridgeIdentityBindings` instead — this projection deliberately
12645
+ * drops `local.componentKey`, so on its own it cannot tell a sanctioned wrapper
12646
+ * from any other component that renders the same export.
12647
+ */
12648
+ declare function canonicalBridgeIdentitySources(bridges: readonly CanonicalBridgeV1[] | undefined): Array<Extract<CanonicalSource, {
12649
+ kind: "npm";
12650
+ }>>;
12030
12651
 
12031
12652
  declare const EFFECTIVE_GOVERNANCE_INPUTS_SCHEMA: "effective-governance-inputs:v1";
12032
12653
  interface EffectiveGovernanceInputsSourceState {
@@ -12087,4 +12708,4 @@ interface ComponentKeyInput {
12087
12708
  */
12088
12709
  declare function buildComponentKey({ repoRelativeFile, exportName }: ComponentKeyInput): string;
12089
12710
 
12090
- export { type A11yNameRequiredFact, AGENT_CONTEXT_RELATIVE_PATH, AgentFormat, BLOCKING_RULE_ALLOWLIST, BRAND, BlockDefinition, type Brand, type BuildAgentFormatInput, type BuildRegistryInstallPlanInput, type BundleArtifactMetadata, type BundleComponentShard, type BundleManifest, type BundleManifestComponentEntry, type BundleSchemaVersion, type BundleTarget, type BundleTokenFile, CATALOG_FIXTURE_A_FCID, type CSF2Story, type CSSGeneratorOptions, CanonicalBridgeV1, type CanonicalCandidateFact, type CanonicalDirectionConflict, Finding as CanonicalFinding, type CanonicalIdentityReference, type CanonicalMappingFact, type CanonicalReplacementFact, CanonicalSource, type CheckStoryExclusionOpts, type CheckedSpacingValue, type ClassNameDynamicFact, type ClassNameDynamicReason, type ClassNameFact, type ClassNameLiteralFact, type ClassNameOrigin, type ClassifyIdentityInput, type CompileEffectiveGovernanceInputsOptions, CompiledBlock, type CompiledContractOutput, CompiledFragment, type ComplexityTier, type ComponentCapabilityFact, type ComponentContract, type ComponentDefinitionFact, type ComponentDefinitionRenderRoot, type ComponentFactInput, type ComponentId, type ComponentIdentityFact, type ComponentIdentityUsage, type ComponentKeyInput, type ComponentLevelFact, type ComponentMetadataFact, type CompositionAnalysis, type CompositionAuthoringEntry, type CompositionChildSelector, type CompositionConstraint, type CompositionGuideline, type CompositionPattern, type CompositionRegionSelector, type CompositionSuggestion, type CompositionWarning, type ConformChange, type ConformComponentMapping, type ConformConfidence, type ConformCoverage, type ConformInput, type ConformLocation, type ConformPropMapping, type ConformResult, type ConformSuggestion, type ConformToken, type ConformUnresolved, ContractCanonicalMappingInput, ContractCatalogInput, ContractDomain, type ContractStampPin, type ContractStampRecord, DEFAULTS, DEFAULT_ENHANCED_STYLE_PROPERTIES, DEFAULT_STYLE_PROPERTIES, type DTCGColorValue, type DTCGDimensionValue, type DTCGGroup, type DTCGToken, type DTCGTokenFile, type DTCGTokenType, type Decorator, type Defaults, type DeltaEMatch, type DesignSystemContext, type DesignToken, type DesignTokenParseOptions, type DiscoverComponentsOptions, EFFECTIVE_GOVERNANCE_INPUTS_SCHEMA, type EffectiveGovernanceInputs, type EffectiveGovernanceInputsSourceState, type EnhancedStyleComparisonResult, type EnhancedStyleDiffItem, EvidenceGrade, type ExclusionReason, type ExclusionResult, type ExternalIdentityReference, FRAGMENTS_INTERNAL_RULE_IDS, type Fact, type FactEvidence, type FactId, FactIndex, type FactKind, type FactLocation, type FactOfKind, FigmaBooleanMapping, FigmaChildrenMapping, FigmaEnumMapping, FigmaInstanceMapping, FigmaStringMapping, FigmaTextContentMapping, type FigmaVariable, type FigmaVariableCollection, Finding, FindingFix, type Fragment, type FragmentAccessibility, FragmentComponent, type FragmentContextOptions, FragmentDefinition, FragmentDefinitionV2, type FragmentDoNotItem, type FragmentFigma, type FragmentIndex, type FragmentMeta as FragmentJsonMeta, type FragmentUsage as FragmentJsonUsage, type FragmentPattern, type FragmentRegistry, type FragmentRelated, FragmentsConfig, Severity as FuiSeverity, GovernanceConfig, type GovernanceIntegrityFamily, type GovernanceIntegrityFamilyId, type GovernanceIntegrityInput, type GovernanceIntegrityRoster, type GovernanceIntegrityStatus, type GovernanceIntegrityVerdict, GovernanceSeverity, GovernedFragmentDefinition, type IdentityClassification, type IdentityConfidence, type IdentityDecision, type IdentityFact, type IdentityState, type InertConfigDiagnostic, type InertConfigDiagnosticCode, type InertConfigDiagnosticKind, type InferProps, type JsxComponentPreferredFact, type JsxImportPathPreferredFact, type JsxInlineStyleForbiddenRawFact, type JsxUnknownPropsForbiddenFact, type Loader, type LocalIdentityReference, type McpBlock, type McpCapability, type McpComponent, type McpComponentExample, type McpComponentGuidance, type McpComponentMetadata, type McpComponentProp, type McpComponentRelation, type McpCompoundChild, type McpGuidancePattern, type McpPerformanceData, type McpPerformanceImport, type McpPerformanceSummary, type McpSnapshot, type McpSnapshotMetadata, type McpSnapshotSchemaVersion, type McpSourceType, type McpToken, type McpTokenData, type NearestByDeltaEOptions, type NormalizedStyleMap, type NormalizedToken, PRESET_NAMES, PROVE_DEFAULT_MAX_PASSES, PROVE_MAX_PASSES, type ParseTokensOptions, type ParsedToken, type PerformanceData as PerfData, type PerformanceSummary as PerfSummary, type PerformanceBudgets, type PerformanceConfig, type PolicyFact, type PresetRuleState, type PreviewConfig, type PreviewRuntimeOptions, type PreviewRuntimeState, type PreviewVariantLike, PreviewVariantRuntime, type PropMetadataFact, type PropValueAvoidedFact, type PropValueForbiddenFact, type ProveCallbacks, type ProveLoopResult, type ProveOptions, type ProvePass, type ProvePassSampling, type ProveResidual, type ProveSample, type ProveSamplerArgs, type ProveVerdict, RAW_HTML_ADVISORY_TAGS, RAW_HTML_CANONICAL_TAGS, RAW_HTML_INPUT_TYPE_CANONICALS, RAW_HTML_ROLE_CANONICALS, type RGB, type RGBA, RULES, RULE_TIER, type RawHtmlCanonicalMatch, type RawHtmlPrecisionTier, RegistryArtifact, type RegistryComponentEntry, RegistryDependency, type RegistryInstallPlan, RegistryInstallReceipt, type RegistryPropEntry, type RegistryWritePlan, RelationshipType, type ResolvedDTCGToken, ResolvedGovernedFragmentDefinition, type ResolvedIdentityRenderRoot, type ResolvedIntrinsicIdentityRoot, type Rule, type RuleFn, type RuleTier, type SCSSGeneratorOptions, type ScaleFact, type ScaleValueFact, Severity, type SpacingResolutionScale, type SpacingTokenLookup, type Story, type StoryArgType, type StoryContext, type StoryMeta, type StoryModule, StorybookFilterConfig, type StructuralConfidenceFact, type StyleComparisonOptions, type StyleComparisonResult, type StyleCssVarsMustBeDefinedFact, type StyleDeclarationFact, type StyleDiffItem, type StyleFontSizeScaleFact, type StylePropertyScaleFact, type StyleRawColorForbiddenFact, type StyleUnsupportedFact, type SuppressionDirectiveFact, type TailwindClassFact, type TailwindModifier, type TailwindModifierKind, type TailwindPaletteAllowFact, type TailwindPaletteDenyFact, type TailwindResolutionSource, type TailwindResolvedKind, type TailwindResolvedValue, type TailwindTokenResolvedFact, type TailwindUnknownClassEnabledFact, type TailwindValue, type ThemeDeclarationFact, type ThemeParserResult, type TokenCatalog, type TokenCatalogDefinition, type TokenCatalogDiagnostic, type TokenCatalogLocation, type TokenCatalogReference, type TokenCatalogSourceState, type TokenCategory, TokenConfig, type TokenDefinitionFact, type TokenFix, type TokenFormat, type TokenLookup, type TokenMatchRequest, type TokenMatchResult, type TokenParseError, type TokenParseOutput, type TokenParseResult, type TokenRegistry, type TokenRegistryMeta, type TokenUsageSummary, type UnsupportedStyleReason, type UsageComponentFact, type UsageFact, type UsageImportFact, type UsageInlineStyleFact, type UsageNodeFact, type UsagePropResolvedFact, type UsageTextChildFact, VariantLoader, aiMetadataSchema, analyzeComposition, asComponentId, assertPortableRegistryPath, blockDefinitionSchema, budgetBar, buildAgentFormat, buildComponentKey, buildRegistryInstallPlan, buildRegistryInstallReceipt, buildSpacingTokenLookup, bundleArtifactMetadataSchema, bundleComponentShardSchema, bundleManifestComponentEntrySchema, bundleManifestSchema, bundleSchemaVersionSchema, bundleTargetSchema, bundleTokenFileSchema, calculateDeltaE, canonicalBridgeContractMappings, canonicalDirectionConflictsTarget, canonicalJson, canonicalPreimage, catalogFixtureA, catalogFixtureAContractPayload, catalogFixtureATokensDtcg, checkStoryExclusion, clampMaxPasses, classifyComplexity, classifyIdentity, collectRegistryInstallDependencies, colorSimilarity, compareByVocabularyRank, compareColors, compareNumericValues, compareStyleValue, compareStyles, compareStylesWithTokens, compileBlock, compileComponentFacts, compileEffectiveGovernanceInputs, compileFragment, compileGlobalGovernanceFacts, compileRecipe, componentContractSchema, componentId, componentRelationSchema, compositionAuthoringEntrySchema, compositionMetadataSchema, compositionPatternSchema, configDeclarationForDiagnostics, containsTailwindV4Theme, contractHash, contractTierRuleIds, customerDefaultRuleStates, defineBlock, defineConfig, defineFragment, defineRecipe, detectOrphanGovernanceScales, detectSubComponentPaths, detectUnconsumedConfigKeys, discoverComponents, dtcgTokenFileSchema, emptyConformResult, evaluateGovernanceIntegrity, executeVariantLoaders, factId, familyDistance, figma, figmaPropMappingSchema, formatBytes, formatStampHeader, formatStampPin, formatStampVersionHash, formatTokenSummary, fragmentBanSchema, fragmentContractSchema, fragmentDefinitionSchema, fragmentDefinitionV2Schema, fragmentGeneratedSchema, fragmentMetaSchema, fragmentProvenanceSchema, fragmentUsageSchema, fragmentVariantSchema, fragmentsConfigSchema, fragmentsPresetRuleStates, gatesCi, generateCSSCustomProperties, generateFigmaVariables, generateSCSSVariables, generateTailwindConfig, getComplianceBadge, getPreviewConfig, governedFragmentDefinitionSchema, hasEffectiveComponentVocabulary, hash64Hex, hexToRgb, hygieneTierRuleIds, indexComponentIdentityUsage, inferTokenCategory, inferTokenGroup, isColorLike, isCompositionPattern, isConfigExcluded, isContractFile, isContractTierRule, isDTCGFile, isDenyEligible, isEffectiveCanonicalSource, isEnforceableHtmlEquivalent, isExportStory, isFigmaPropMapping, isForceIncluded, isPortableRepoPath, isRawHtmlAdvisoryTier, isReactComponent, lowerCompositionContract, makeA11yNameRequiredFact, makeCanonicalCandidateFact, makeCanonicalMappingFact, makeCanonicalReplacementFact, makeClassNameDynamicFact, makeClassNameLiteralFact, makeComponentCapabilityFact, makeComponentDefinitionFact, makeComponentIdentityFact, makeComponentMetadataFact, makeContractTokenFact, makeFinding, makeJsxComponentPreferredFact, makeJsxImportPathPreferredFact, makeJsxInlineStyleForbiddenRawFact, makeJsxUnknownPropsForbiddenFact, makePropMetadataFact, makePropValueAvoidedFact, makePropValueForbiddenFact, makeScaleFact, makeScaleValueFact, makeStructuralConfidenceFact, makeStyleCssVarsMustBeDefinedFact, makeStyleDeclarationFact, makeStyleFontSizeScaleFact, makeStylePropertyScaleFact, makeStyleRawColorForbiddenFact, makeStyleUnsupportedFact, makeTailwindClassFact, makeTailwindPaletteAllowFact, makeTailwindPaletteDenyFact, makeTailwindTokenResolvedFact, makeTailwindUnknownClassEnabledFact, makeThemeDeclarationFact, makeTokenDefinitionFact, makeUsageComponentFact, makeUsageImportFact, makeUsageInlineStyleFact, makeUsageNodeFact, makeUsagePropResolvedFact, makeUsageTextChildFact, matchesGlob, mcpBlockSchema, mcpCapabilitySchema, mcpComponentExampleSchema, mcpComponentGuidanceSchema, mcpComponentMetadataSchema, mcpComponentPropSchema, mcpComponentRelationSchema, mcpComponentSchema, mcpCompoundChildSchema, mcpGuidancePatternSchema, mcpPerformanceDataSchema, mcpPerformanceImportSchema, mcpPerformanceSummarySchema, mcpSnapshotMetadataSchema, mcpSnapshotSchema, mcpSnapshotSchemaVersionSchema, mcpSourceTypeSchema, mcpTokenDataSchema, mcpTokenSchema, nearestByDeltaE, nearestSignedScaleValue, normalizeColor, normalizeConfigPath, normalizeRegistryRepoPath, normalizeStyleValue, normalizeToV1, normalizeTokenGroupComment, normalizeTokenValue, parseColor, parseColorToRgb, parseComponentContract, parseContractStamp, parseCssTokens, parseDtcgTokens as parseDTCGFile, parseDesignTokenContent, parseDtcgTokens, parseRgb, parseScssTokens, parseScssVariables, parseTailwindV4Theme, parseTokenFile, parseTokens, portableRepoPathError, projectCanonicalDirectionConflicts, propDefinitionSchema, proveCompliant, proveIssueCount, recipeDefinitionSchema, resolveCanonicalForAriaRole, resolveCanonicalForRawHtml, resolveConfiguredAppPath, resolveDesignTokenValue, resolveFigmaMapping, resolvePerformanceConfig, resolvePreviewRuntimeState, resolveProveVerdict, resolveSpacingValue, resolveTokenValue, rgbToHex, ruleA11yRequiredAccessibleName, ruleComponentsForbiddenPropValue, ruleComponentsPreferLibrary, ruleComponentsShadowComponent, ruleComponentsUnknownProp, ruleJsxPreferredComponent, ruleJsxPreferredImportPath, rulePropsInvalidValue, ruleStylesNoRawColor, ruleStylesNoRawDimensions, ruleStylesNoRawSpacing, ruleStylesNoRawTypography, ruleTailwindArbitraryColor, ruleTailwindArbitrarySpacing, ruleTailwindForbiddenPalette, ruleTailwindOffScaleSpacingToken, ruleTailwindRawColorViaToken, ruleTailwindUnknownClass, ruleThemeNoThemeCoupledLiteral, ruleTokensRequireDualFallback, runRules, selectedRegistryComponentNames, serializeContractStamp, setPreviewConfig, sha256Hex, sourceToRegistryTargetPath, storyModuleToFragment, storyNameFromExport, tierFor, toId, tokenIncludesFromConfig, topologyBase, usePreviewVariantRuntime, vocabularyRank };
12711
+ 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 CanonicalBridgeIdentityBinding, 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 FactConflict, type FactEvidence, type FactId, FactIndex, type FactKind, type FactLocation, type FactOfKind, FigmaBooleanMapping, FigmaChildrenMapping, FigmaEnumMapping, FigmaInstanceMapping, FigmaStringMapping, FigmaTextContentMapping, type FigmaVariable, type FigmaVariableCollection, Finding, FindingFix, type Fragment, type FragmentAccessibility, FragmentComponent, type FragmentContextOptions, FragmentDefinition, FragmentDefinitionV2, type FragmentDoNotItem, type FragmentFigma, type FragmentIndex, type FragmentMeta as FragmentJsonMeta, type FragmentUsage as FragmentJsonUsage, type FragmentPattern, type FragmentRegistry, type FragmentRelated, FragmentsConfig, Severity as FuiSeverity, GovernanceConfig, type GovernanceIntegrityFamily, type GovernanceIntegrityFamilyId, type GovernanceIntegrityInput, type GovernanceIntegrityRoster, type GovernanceIntegrityStatus, type GovernanceIntegrityVerdict, GovernanceSeverity, GovernedFragmentDefinition, type IdentityClassification, type IdentityConfidence, type IdentityDecision, type IdentityFact, type IdentityState, type InertConfigDiagnostic, type InertConfigDiagnosticCode, type InertConfigDiagnosticKind, type InferProps, type JsxComponentPreferredFact, type JsxImportPathPreferredFact, type JsxInlineStyleForbiddenRawFact, type JsxUnknownPropsForbiddenFact, type Loader, type LocalIdentityReference, type McpBlock, type McpCapability, type McpComponent, type McpComponentExample, type McpComponentGuidance, type McpComponentMetadata, type McpComponentProp, type McpComponentRelation, type McpCompoundChild, type McpGuidancePattern, type McpPerformanceData, type McpPerformanceImport, type McpPerformanceSummary, type McpSnapshot, type McpSnapshotMetadata, type McpSnapshotSchemaVersion, type McpSourceType, type McpToken, type McpTokenData, type NearestByDeltaEOptions, type NormalizedStyleMap, type NormalizedToken, PRESET_NAMES, PROVE_DEFAULT_MAX_PASSES, PROVE_MAX_PASSES, type ParseTokensOptions, type ParsedToken, type PerformanceData as PerfData, type PerformanceSummary as PerfSummary, type PerformanceBudgets, type PerformanceConfig, type PolicyExclude, type PolicyExcludeInput, 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_FAMILY_IDS, RULE_FAMILY_MEMBERS, 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 StyleValueProvenance, type SupersededImportPathPreference, 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 UsageChildContentFact, 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, canonicalBridgeIdentityBindings, canonicalBridgeIdentitySources, canonicalDirectionConflictsTarget, canonicalJson, canonicalPreimage, catalogFixtureA, catalogFixtureAContractPayload, catalogFixtureATokensDtcg, checkStoryExclusion, clampMaxPasses, classifyComplexity, classifyIdentity, collectRegistryInstallDependencies, collidingRecordDiagnostic, collidingRecordDiagnostics, colorSimilarity, compareByVocabularyRank, compareColors, compareNumericValues, compareStyleValue, compareStyles, compareStylesWithTokens, compileBlock, compileComponentFacts, compileEffectiveGovernanceInputs, compileFragment, compileGlobalGovernanceFacts, compileRecipe, componentContractSchema, componentId, componentRelationSchema, compositionAuthoringEntrySchema, compositionMetadataSchema, compositionPatternSchema, configDeclarationForDiagnostics, configRecordShape, containsTailwindV4Theme, contractHash, contractTierRuleIds, customerDefaultRuleStates, defineBlock, defineConfig, defineFragment, defineRecipe, describePolicyExclude, detectOrphanGovernanceScales, detectSubComponentPaths, detectUnconsumedConfigKeys, detectUnmatchedPolicyExcludes, discoverComponents, dtcgTokenFileSchema, emptyConformResult, evaluateGovernanceIntegrity, excludeGlobToRegExp, 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, isRuleFamilyId, 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, makeUsageChildContentFact, makeUsageComponentFact, makeUsageImportFact, makeUsageInlineStyleFact, makeUsageNodeFact, makeUsagePropResolvedFact, makeUsageTextChildFact, matchPolicyExclude, matchesGlob, mcpBlockSchema, mcpCapabilitySchema, mcpComponentExampleSchema, mcpComponentGuidanceSchema, mcpComponentMetadataSchema, mcpComponentPropSchema, mcpComponentRelationSchema, mcpComponentSchema, mcpCompoundChildSchema, mcpGuidancePatternSchema, mcpPerformanceDataSchema, mcpPerformanceImportSchema, mcpPerformanceSummarySchema, mcpSnapshotMetadataSchema, mcpSnapshotSchema, mcpSnapshotSchemaVersionSchema, mcpSourceTypeSchema, mcpTokenDataSchema, mcpTokenSchema, nearestByDeltaE, nearestSignedScaleValue, normalizeColor, normalizeConfigPath, normalizeExcludePath, normalizePolicyExcludes, normalizeRegistryRepoPath, normalizeStyleValue, normalizeToV1, normalizeTokenGroupComment, normalizeTokenValue, overriddenRecordSeverityDiagnostic, parseColor, parseColorToRgb, parseComponentContract, parseContractStamp, parseCssTokens, parseDtcgTokens as parseDTCGFile, parseDesignTokenContent, parseDtcgTokens, parseRgb, parseScssTokens, parseScssVariables, parseTailwindV4Theme, parseTokenFile, parseTokens, policyExcludeMatchesPath, policyExcludeSchema, portableRepoPathError, projectCanonicalDirectionConflicts, projectSupersededImportPathPreferences, propDefinitionSchema, proveCompliant, proveIssueCount, recipeDefinitionSchema, resolveCanonicalForAriaRole, resolveCanonicalForRawHtml, resolveConfiguredAppPath, resolveDesignTokenValue, resolveFigmaMapping, resolvePerformanceConfig, resolvePreviewRuntimeState, resolveProveVerdict, resolveSpacingValue, resolveTokenValue, rgbToHex, ruleA11yRequiredAccessibleName, ruleA11yStandard, ruleComponentsForbiddenPropValue, ruleComponentsPreferLibrary, ruleComponentsShadowComponent, ruleComponentsUnknownProp, ruleFamilyMembers, 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 };