@usefragments/core 1.2.0 → 1.3.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 (43) hide show
  1. package/dist/{chunk-BQQTMGLA.js → chunk-57QDBEHQ.js} +79 -6
  2. package/dist/chunk-57QDBEHQ.js.map +1 -0
  3. package/dist/{chunk-DBVTSUMT.js → chunk-MLRDNSSA.js} +20 -6
  4. package/dist/chunk-MLRDNSSA.js.map +1 -0
  5. package/dist/codes/index.d.ts +1 -1
  6. package/dist/codes/index.js +2 -2
  7. package/dist/index-h_yWj15D.d.ts +6981 -0
  8. package/dist/index.d.ts +106 -92
  9. package/dist/index.js +235 -98
  10. package/dist/index.js.map +1 -1
  11. package/dist/registry.d.ts +36 -36
  12. package/dist/schemas/index.d.ts +3 -3377
  13. package/dist/schemas/index.js +1 -1
  14. package/package.json +1 -1
  15. package/src/agent-format.test.ts +75 -3
  16. package/src/agent-format.ts +28 -6
  17. package/src/evidence.ts +27 -0
  18. package/src/facts/builders.ts +2 -0
  19. package/src/facts/fact-index.ts +22 -2
  20. package/src/facts/facts.test.ts +1 -1
  21. package/src/facts/types.ts +2 -0
  22. package/src/index.ts +4 -0
  23. package/src/rules/__tests__/fix-emission-invariant.test.ts +174 -0
  24. package/src/rules/__tests__/tokens-require-dual-fallback.test.ts +90 -0
  25. package/src/rules/emit-gate.test.ts +16 -0
  26. package/src/rules/emit-gate.ts +6 -3
  27. package/src/rules/finding.ts +3 -0
  28. package/src/rules/rules.test.ts +2 -1
  29. package/src/rules/spacing-resolution.ts +5 -8
  30. package/src/rules/styles-no-raw-color.ts +32 -23
  31. package/src/rules/styles-no-raw-dimensions.ts +31 -12
  32. package/src/rules/styles-no-raw-spacing.ts +33 -11
  33. package/src/rules/styles-no-raw-typography.ts +37 -15
  34. package/src/rules/taxonomy.test.ts +13 -0
  35. package/src/rules/tokens-require-dual-fallback.ts +54 -17
  36. package/src/rules/utils.ts +51 -0
  37. package/src/schemas/index.ts +81 -3
  38. package/src/token-types.ts +6 -0
  39. package/src/tokens/__tests__/source-names.test.ts +42 -0
  40. package/src/tokens/design-token-parser.test.ts +24 -5
  41. package/src/tokens/design-token-parser.ts +40 -8
  42. package/dist/chunk-BQQTMGLA.js.map +0 -1
  43. package/dist/chunk-DBVTSUMT.js.map +0 -1
package/dist/index.d.ts CHANGED
@@ -1,7 +1,7 @@
1
+ import { F as Finding, A as AgentFormat, E as EvidenceGrade, a as FindingFix } from './index-h_yWj15D.js';
2
+ export { b as AGENT_FORMAT_SCHEMA_VERSION, c as AgentErrorEnvelope, d as AgentOutput, G as CanonicalGovernanceVerdict, e as EVIDENCE_ORDER, f as FindingReplaceClassTokenFix, g as FindingReplaceComponentFix, h as FindingReplaceImportFix, i as FindingReplacePropValueFix, j as FindingReplaceStyleValueFix, k as Fix, l as GovernanceVerdictMetadata, I as InspectClaim, m as InspectClaimTier, S as SuppressionDirective, V as ValidatorResult, n as Violation, o as agentErrorEnvelopeSchema, p as agentFormatSchema, q as agentIntegritySchema, r as agentOutputSchema, s as canBlock, t as factEvidenceSchema, u as factLocationSchema, v as findingFixSchema, w as findingReplaceClassTokenFixSchema, x as findingReplaceComponentFixSchema, y as findingReplaceImportFixSchema, z as findingReplacePropValueFixSchema, B as findingReplaceStyleValueFixSchema, C as findingSchema, D as fixSchema, H as governanceVerdictMetadataSchema, J as governanceVerdictSchema, K as normalizeFinding, L as normalizeSeverity, M as normalizeViolation, N as suppressionDirectiveSchema, O as validatorResultSchema, P as violationSchema } from './index-h_yWj15D.js';
1
3
  import { Severity } from './severity.js';
2
4
  export { SEVERITIES, SEVERITY_RANK, SEVERITY_WEIGHTS, SeverityLevel, compareSeverity, maxSeverity, severityLevel, severitySchema, sortBySeverity } from './severity.js';
3
- import { Finding, AgentFormat, FindingFix } from './schemas/index.js';
4
- export { AGENT_FORMAT_SCHEMA_VERSION, AgentErrorEnvelope, AgentOutput, GovernanceVerdict as CanonicalGovernanceVerdict, FindingReplaceClassTokenFix, FindingReplaceComponentFix, FindingReplaceImportFix, FindingReplacePropValueFix, FindingReplaceStyleValueFix, Fix, GovernanceVerdictMetadata, SuppressionDirective, ValidatorResult, Violation, agentErrorEnvelopeSchema, agentFormatSchema, agentIntegritySchema, agentOutputSchema, factEvidenceSchema, factLocationSchema, findingFixSchema, findingReplaceClassTokenFixSchema, findingReplaceComponentFixSchema, findingReplaceImportFixSchema, findingReplacePropValueFixSchema, findingReplaceStyleValueFixSchema, findingSchema, fixSchema, governanceVerdictMetadataSchema, governanceVerdictSchema, normalizeFinding, normalizeSeverity, normalizeViolation, suppressionDirectiveSchema, validatorResultSchema, violationSchema } from './schemas/index.js';
5
5
  export { BridgeViolationInput, CODES, CodeCategory, CodeLifecycle, EXPLAIN_URL_BASE, FuiCode, bridgeSourceViolation, bridgeSourceViolations, byCode, byRuleId, explainUrlForCode } from './codes/index.js';
6
6
  import { c as ContractDomain, d as ContractCatalogInput, G as GovernanceSeverity, b as CompiledFragment, e as GovernedFragmentDefinition, R as ResolvedGovernedFragmentDefinition, f as GovernanceConfig, g as FragmentsConfig, T as TokenConfig, h as FragmentComponent, B as BlockDefinition, C as CompiledBlock, F as FragmentDefinition, a as FragmentDefinitionV2, S as StorybookFilterConfig, i as FigmaStringMapping, j as FigmaBooleanMapping, k as FigmaEnumMapping, l as FigmaInstanceMapping, m as FigmaChildrenMapping, n as FigmaTextContentMapping, o as RelationshipType, V as VariantRenderOptions, p as VariantLoader, q as CanonicalSource } from './governance-DYSirwJu.js';
7
7
  export { A as AIMetadata, r as AccessibilityGovernanceBuilder, s as AppConfig, t as BaselineInfo, u as BoundingBox, v as CONTRACT_DOMAINS, w as CONTRACT_PREIMAGE_CAPABILITY_HEADER, x as CONTRACT_PREIMAGE_SCHEMA, y as CanonicalMappingStatus, z as CompiledFragmentsFile, D as CompiledRecipe, E as CompiledTokenData, H as CompiledTokenEntry, I as ComponentGovernanceBuilder, J as ComponentGovernanceRecord, K as ComponentRef, L as ComponentRelation, M as CompositionMetadata, N as ContractCanonicalMappingInput, O as ContractComponentInput, P as ContractIdentityPin, Q as ContractPolicyInput, U as ContractPreimage, W as ContractPropMappingInput, X as ContractTokenInput, Y as ContractWaiverInput, Z as ControlType, _ as DesignSystemConfig, $ as DiffResult, a0 as FigmaPropMapping, a1 as FragmentContract, a2 as FragmentExample, a3 as FragmentGenerated, a4 as FragmentGuidance, a5 as FragmentMeta, a6 as FragmentProvenance, a7 as FragmentUsage, a8 as FragmentVariant, a9 as GlobalGovernanceRecord, aa as GlobalJsxGovernanceRecord, ab as GlobalStyleGovernanceRecord, ac as GovernancePropValue, ad as InspectConfig, ae as LocalCanonicalDeclaration, af as LocalCanonicalResolveRule, ag as Manifest, ah as ObservedComponentUsage, ai as ObservedUsageProp, aj as PlayFunction, ak as PlayFunctionContext, al as PropDefinition, am as PropGovernanceBuilder, an as PropGovernanceOptions, ao as PropKey, ap as PropType, aq as RecipeDefinition, ar as RegistryOptions, as as RepoRelativePath, at as ScaleGovernanceRecord, au as Screenshot, av as ScreenshotConfig, aw as ScreenshotMetadata, ax as ServiceConfig, ay as SnapshotConfig, az as SnippetPolicyConfig, aA as Theme, aB as ThemeSeeds, aC as TokenSourceConfig, aD as TokenSourceFormat, aE as VerifyRequest, aF as VerifyResult, aG as Viewport, aH as componentGovernanceRecordSchema, aI as componentGovernanceRecordsSchema, aJ as contractComponentsFromFragments, aK as contractPolicyFromGovernanceConfig, aL as diffContractDomains, aM as g, aN as globalGovernanceRecordSchema, aO as globalJsxGovernanceRecordSchema, aP as globalStyleGovernanceRecordSchema, aQ as governanceConfigSchema, aR as governanceConfigWithLocalCanonical, aS as governanceSeveritySchema, aT as localCanonicalContractMappings, aU as normalizeGovernanceConfig, aV as projectContractPreimage, aW as scaleGovernanceRecordSchema, aX as verifiedContractPreimageFromPin } from './governance-DYSirwJu.js';
@@ -745,6 +745,8 @@ interface TokenDefinitionFact extends BaseFact {
745
745
  * Absent on legacy/hand-built facts, which are treated as safe.
746
746
  */
747
747
  referenceFormat?: "css-var" | "scss-var" | "scss-map" | "dtcg";
748
+ /** Original authored spellings retained before parser normalization. */
749
+ sourceNames?: string[];
748
750
  }
749
751
  interface TailwindPaletteAllowFact extends BaseFact {
750
752
  kind: "tailwind_palette_allow";
@@ -1179,6 +1181,7 @@ declare function makeTokenDefinitionFact(input: {
1179
1181
  location?: TokenDefinitionFact["location"];
1180
1182
  category?: TokenDefinitionFact["category"];
1181
1183
  referenceFormat?: TokenDefinitionFact["referenceFormat"];
1184
+ sourceNames?: TokenDefinitionFact["sourceNames"];
1182
1185
  }): TokenDefinitionFact;
1183
1186
  declare function makeTailwindPaletteAllowFact(input: {
1184
1187
  patterns: string[];
@@ -1317,6 +1320,7 @@ declare class FactIndex {
1317
1320
  private readonly facts;
1318
1321
  private readonly idsByKind;
1319
1322
  private readonly idsByComponent;
1323
+ private readonly tokenBySymbol;
1320
1324
  add(fact: Fact): void;
1321
1325
  addMany(facts: Iterable<Fact>): void;
1322
1326
  get(id: FactId): Fact | undefined;
@@ -1374,7 +1378,10 @@ declare class FactIndex {
1374
1378
  tokens: {
1375
1379
  list: () => TokenDefinitionFact[];
1376
1380
  byCategory: (category: TokenDefinitionFact["category"]) => TokenDefinitionFact[];
1381
+ symbolExists: (name: string) => boolean;
1382
+ definitionForSymbol: (name: string) => TokenDefinitionFact | undefined;
1377
1383
  };
1384
+ private indexTokenSymbols;
1378
1385
  private byComponentOfKind;
1379
1386
  }
1380
1387
 
@@ -1408,6 +1415,8 @@ interface BuildAgentFormatInput {
1408
1415
  maxFindings?: number;
1409
1416
  includeEvidence?: boolean;
1410
1417
  includeFindings?: boolean;
1418
+ provenance?: NonNullable<AgentFormat["provenance"]>;
1419
+ verdict?: NonNullable<AgentFormat["verdict"]>;
1411
1420
  }
1412
1421
  declare function buildAgentFormat(input: BuildAgentFormatInput): AgentFormat;
1413
1422
 
@@ -1527,6 +1536,10 @@ interface DesignToken {
1527
1536
  referenceChain: string[];
1528
1537
  /** Source file where this token was defined */
1529
1538
  sourceFile: string;
1539
+ /** Authored reference form, when the parser can prove it from the source. */
1540
+ referenceFormat?: "css-var" | "scss-var" | "scss-map" | "dtcg";
1541
+ /** Authored spellings preserved before normalization (for example `$x` and `--x`). */
1542
+ sourceNames?: string[];
1530
1543
  /** Line number in source file */
1531
1544
  lineNumber?: number;
1532
1545
  /** Theme this token belongs to (e.g., "default", "dark", "light") */
@@ -1761,7 +1774,7 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
1761
1774
  name: string;
1762
1775
  }[];
1763
1776
  publicSlug: string | null;
1764
- tier: "composition" | "core";
1777
+ tier: "core" | "composition";
1765
1778
  propCount: number;
1766
1779
  hasExamples: boolean;
1767
1780
  hasCompoundChildren: boolean;
@@ -1782,7 +1795,7 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
1782
1795
  name: string;
1783
1796
  }[];
1784
1797
  publicSlug: string | null;
1785
- tier: "composition" | "core";
1798
+ tier: "core" | "composition";
1786
1799
  propCount: number;
1787
1800
  hasExamples: boolean;
1788
1801
  hasCompoundChildren: boolean;
@@ -1829,13 +1842,13 @@ declare const bundleManifestSchema: z.ZodObject<{
1829
1842
  repoFullName: z.ZodString;
1830
1843
  resolution: z.ZodEnum<["explicit", "auto"]>;
1831
1844
  }, "strip", z.ZodTypeAny, {
1832
- resolution: "auto" | "explicit";
1845
+ resolution: "explicit" | "auto";
1833
1846
  bindingId: string;
1834
1847
  projectId: string;
1835
1848
  projectName: string;
1836
1849
  repoFullName: string;
1837
1850
  }, {
1838
- resolution: "auto" | "explicit";
1851
+ resolution: "explicit" | "auto";
1839
1852
  bindingId: string;
1840
1853
  projectId: string;
1841
1854
  projectName: string;
@@ -1891,7 +1904,7 @@ declare const bundleManifestSchema: z.ZodObject<{
1891
1904
  name: string;
1892
1905
  }[];
1893
1906
  publicSlug: string | null;
1894
- tier: "composition" | "core";
1907
+ tier: "core" | "composition";
1895
1908
  propCount: number;
1896
1909
  hasExamples: boolean;
1897
1910
  hasCompoundChildren: boolean;
@@ -1912,7 +1925,7 @@ declare const bundleManifestSchema: z.ZodObject<{
1912
1925
  name: string;
1913
1926
  }[];
1914
1927
  publicSlug: string | null;
1915
- tier: "composition" | "core";
1928
+ tier: "core" | "composition";
1916
1929
  propCount: number;
1917
1930
  hasExamples: boolean;
1918
1931
  hasCompoundChildren: boolean;
@@ -1935,7 +1948,7 @@ declare const bundleManifestSchema: z.ZodObject<{
1935
1948
  name: string;
1936
1949
  }[];
1937
1950
  publicSlug: string | null;
1938
- tier: "composition" | "core";
1951
+ tier: "core" | "composition";
1939
1952
  propCount: number;
1940
1953
  hasExamples: boolean;
1941
1954
  hasCompoundChildren: boolean;
@@ -1959,7 +1972,7 @@ declare const bundleManifestSchema: z.ZodObject<{
1959
1972
  slug: string;
1960
1973
  };
1961
1974
  sourceBinding: {
1962
- resolution: "auto" | "explicit";
1975
+ resolution: "explicit" | "auto";
1963
1976
  bindingId: string;
1964
1977
  projectId: string;
1965
1978
  projectName: string;
@@ -1981,7 +1994,7 @@ declare const bundleManifestSchema: z.ZodObject<{
1981
1994
  name: string;
1982
1995
  }[];
1983
1996
  publicSlug: string | null;
1984
- tier: "composition" | "core";
1997
+ tier: "core" | "composition";
1985
1998
  propCount: number;
1986
1999
  hasExamples: boolean;
1987
2000
  hasCompoundChildren: boolean;
@@ -2005,7 +2018,7 @@ declare const bundleManifestSchema: z.ZodObject<{
2005
2018
  slug: string;
2006
2019
  };
2007
2020
  sourceBinding: {
2008
- resolution: "auto" | "explicit";
2021
+ resolution: "explicit" | "auto";
2009
2022
  bindingId: string;
2010
2023
  projectId: string;
2011
2024
  projectName: string;
@@ -2185,7 +2198,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2185
2198
  }[];
2186
2199
  source: "design-system";
2187
2200
  publicSlug: string | null;
2188
- tier: "composition" | "core";
2201
+ tier: "core" | "composition";
2189
2202
  relations: Record<string, unknown>[];
2190
2203
  publicId: string | null;
2191
2204
  usageGuidance: string;
@@ -2211,7 +2224,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2211
2224
  }[];
2212
2225
  source: "design-system";
2213
2226
  publicSlug: string | null;
2214
- tier: "composition" | "core";
2227
+ tier: "core" | "composition";
2215
2228
  relations: Record<string, unknown>[];
2216
2229
  publicId: string | null;
2217
2230
  usageGuidance: string;
@@ -2242,7 +2255,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2242
2255
  }[];
2243
2256
  source: "design-system";
2244
2257
  publicSlug: string | null;
2245
- tier: "composition" | "core";
2258
+ tier: "core" | "composition";
2246
2259
  relations: Record<string, unknown>[];
2247
2260
  publicId: string | null;
2248
2261
  usageGuidance: string;
@@ -2275,7 +2288,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2275
2288
  }[];
2276
2289
  source: "design-system";
2277
2290
  publicSlug: string | null;
2278
- tier: "composition" | "core";
2291
+ tier: "core" | "composition";
2279
2292
  relations: Record<string, unknown>[];
2280
2293
  publicId: string | null;
2281
2294
  usageGuidance: string;
@@ -6713,32 +6726,6 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6713
6726
  }>>;
6714
6727
  recognizedClassHelpers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6715
6728
  }, "strip", z.ZodTypeAny, {
6716
- components?: string[] | undefined;
6717
- screenshots?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
6718
- tokens?: z.objectOutputType<{
6719
- include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
6720
- sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
6721
- path: z.ZodEffects<z.ZodString, string, string>;
6722
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
6723
- }, "strip", z.ZodTypeAny, {
6724
- path: string;
6725
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
6726
- }, {
6727
- path: string;
6728
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
6729
- }>, "many">>;
6730
- exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
6731
- themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6732
- enabled: z.ZodOptional<z.ZodBoolean>;
6733
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
6734
- namespace: z.ZodOptional<z.ZodString>;
6735
- }, z.ZodTypeAny, "passthrough"> | undefined;
6736
- performance?: "strict" | "relaxed" | "standard" | {
6737
- preset?: "strict" | "relaxed" | "standard" | undefined;
6738
- budgets?: {
6739
- bundleSize?: number | undefined;
6740
- } | undefined;
6741
- } | undefined;
6742
6729
  govern?: {
6743
6730
  components?: Record<string, {
6744
6731
  rules: ({
@@ -6914,6 +6901,32 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6914
6901
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
6915
6902
  }, z.ZodTypeAny, "passthrough"> | undefined;
6916
6903
  } | undefined;
6904
+ components?: string[] | undefined;
6905
+ screenshots?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
6906
+ tokens?: z.objectOutputType<{
6907
+ include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
6908
+ sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
6909
+ path: z.ZodEffects<z.ZodString, string, string>;
6910
+ format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
6911
+ }, "strip", z.ZodTypeAny, {
6912
+ path: string;
6913
+ format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
6914
+ }, {
6915
+ path: string;
6916
+ format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
6917
+ }>, "many">>;
6918
+ exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
6919
+ themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6920
+ enabled: z.ZodOptional<z.ZodBoolean>;
6921
+ format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
6922
+ namespace: z.ZodOptional<z.ZodString>;
6923
+ }, z.ZodTypeAny, "passthrough"> | undefined;
6924
+ performance?: "strict" | "relaxed" | "standard" | {
6925
+ preset?: "strict" | "relaxed" | "standard" | undefined;
6926
+ budgets?: {
6927
+ bundleSize?: number | undefined;
6928
+ } | undefined;
6929
+ } | undefined;
6917
6930
  include?: string[] | undefined;
6918
6931
  exclude?: string[] | undefined;
6919
6932
  registry?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
@@ -6971,32 +6984,6 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6971
6984
  } | undefined;
6972
6985
  recognizedClassHelpers?: string[] | undefined;
6973
6986
  }, {
6974
- components?: string[] | undefined;
6975
- screenshots?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
6976
- tokens?: z.objectInputType<{
6977
- include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
6978
- sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
6979
- path: z.ZodEffects<z.ZodString, string, string>;
6980
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
6981
- }, "strip", z.ZodTypeAny, {
6982
- path: string;
6983
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
6984
- }, {
6985
- path: string;
6986
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
6987
- }>, "many">>;
6988
- exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
6989
- themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6990
- enabled: z.ZodOptional<z.ZodBoolean>;
6991
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
6992
- namespace: z.ZodOptional<z.ZodString>;
6993
- }, z.ZodTypeAny, "passthrough"> | undefined;
6994
- performance?: "strict" | "relaxed" | "standard" | {
6995
- preset?: "strict" | "relaxed" | "standard" | undefined;
6996
- budgets?: {
6997
- bundleSize?: number | undefined;
6998
- } | undefined;
6999
- } | undefined;
7000
6987
  govern?: {
7001
6988
  components?: Record<string, {
7002
6989
  rules: ({
@@ -7172,6 +7159,32 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7172
7159
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
7173
7160
  }, z.ZodTypeAny, "passthrough"> | undefined;
7174
7161
  } | undefined;
7162
+ components?: string[] | undefined;
7163
+ screenshots?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
7164
+ tokens?: z.objectInputType<{
7165
+ include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7166
+ sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
7167
+ path: z.ZodEffects<z.ZodString, string, string>;
7168
+ format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7169
+ }, "strip", z.ZodTypeAny, {
7170
+ path: string;
7171
+ format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7172
+ }, {
7173
+ path: string;
7174
+ format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
7175
+ }>, "many">>;
7176
+ exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
7177
+ themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7178
+ enabled: z.ZodOptional<z.ZodBoolean>;
7179
+ format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
7180
+ namespace: z.ZodOptional<z.ZodString>;
7181
+ }, z.ZodTypeAny, "passthrough"> | undefined;
7182
+ performance?: "strict" | "relaxed" | "standard" | {
7183
+ preset?: "strict" | "relaxed" | "standard" | undefined;
7184
+ budgets?: {
7185
+ bundleSize?: number | undefined;
7186
+ } | undefined;
7187
+ } | undefined;
7175
7188
  include?: string[] | undefined;
7176
7189
  exclude?: string[] | undefined;
7177
7190
  registry?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
@@ -8656,6 +8669,7 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
8656
8669
  guidelines?: string[] | undefined;
8657
8670
  accessibility?: string[] | undefined;
8658
8671
  };
8672
+ govern?: ((...args: unknown[]) => unknown) | undefined;
8659
8673
  composition?: {
8660
8674
  pattern?: "compound" | "simple" | "controlled" | "wrapper" | undefined;
8661
8675
  subComponents?: string[] | undefined;
@@ -8671,7 +8685,6 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
8671
8685
  constraints?: string[] | undefined;
8672
8686
  typeDetails?: Record<string, unknown> | undefined;
8673
8687
  }> | undefined;
8674
- govern?: ((...args: unknown[]) => unknown) | undefined;
8675
8688
  contract?: {
8676
8689
  composition?: {
8677
8690
  rule: {
@@ -8802,6 +8815,7 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
8802
8815
  guidelines?: string[] | undefined;
8803
8816
  accessibility?: string[] | undefined;
8804
8817
  };
8818
+ govern?: ((...args: unknown[]) => unknown) | undefined;
8805
8819
  composition?: {
8806
8820
  pattern?: "compound" | "simple" | "controlled" | "wrapper" | undefined;
8807
8821
  subComponents?: string[] | undefined;
@@ -8817,7 +8831,6 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
8817
8831
  constraints?: string[] | undefined;
8818
8832
  typeDetails?: Record<string, unknown> | undefined;
8819
8833
  }> | undefined;
8820
- govern?: ((...args: unknown[]) => unknown) | undefined;
8821
8834
  contract?: {
8822
8835
  composition?: {
8823
8836
  rule: {
@@ -10201,6 +10214,13 @@ declare const componentContractSchema: z.ZodObject<{
10201
10214
  }>>;
10202
10215
  }, "strip", z.ZodTypeAny, {
10203
10216
  description: string;
10217
+ provenance: {
10218
+ source: "manual" | "extracted" | "merged" | "migrated";
10219
+ verified: boolean;
10220
+ frameworkSupport?: "native" | "manual-only" | undefined;
10221
+ sourceHash?: string | undefined;
10222
+ extractedAt?: string | undefined;
10223
+ };
10204
10224
  props: Record<string, {
10205
10225
  type: string;
10206
10226
  description: string;
@@ -10213,13 +10233,6 @@ declare const componentContractSchema: z.ZodObject<{
10213
10233
  name: string;
10214
10234
  sourcePath: string;
10215
10235
  exportName: string;
10216
- provenance: {
10217
- source: "manual" | "extracted" | "merged" | "migrated";
10218
- verified: boolean;
10219
- frameworkSupport?: "native" | "manual-only" | undefined;
10220
- sourceHash?: string | undefined;
10221
- extractedAt?: string | undefined;
10222
- };
10223
10236
  propsSummary: string[];
10224
10237
  usage: {
10225
10238
  when: string[];
@@ -10228,8 +10241,6 @@ declare const componentContractSchema: z.ZodObject<{
10228
10241
  accessibility?: string[] | undefined;
10229
10242
  };
10230
10243
  $schema: string;
10231
- status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10232
- tokens?: string[] | undefined;
10233
10244
  preview?: {
10234
10245
  css?: string[] | undefined;
10235
10246
  theme?: "light" | "dark" | undefined;
@@ -10237,6 +10248,8 @@ declare const componentContractSchema: z.ZodObject<{
10237
10248
  wrapperModule?: string | undefined;
10238
10249
  wrapperExport?: string | undefined;
10239
10250
  } | undefined;
10251
+ status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10252
+ tokens?: string[] | undefined;
10240
10253
  contract?: {
10241
10254
  compoundChildren?: Record<string, {
10242
10255
  description?: string | undefined;
@@ -10282,6 +10295,13 @@ declare const componentContractSchema: z.ZodObject<{
10282
10295
  } | undefined;
10283
10296
  }, {
10284
10297
  description: string;
10298
+ provenance: {
10299
+ source: "manual" | "extracted" | "merged" | "migrated";
10300
+ verified: boolean;
10301
+ frameworkSupport?: "native" | "manual-only" | undefined;
10302
+ sourceHash?: string | undefined;
10303
+ extractedAt?: string | undefined;
10304
+ };
10285
10305
  props: Record<string, {
10286
10306
  type: string;
10287
10307
  description: string;
@@ -10294,13 +10314,6 @@ declare const componentContractSchema: z.ZodObject<{
10294
10314
  name: string;
10295
10315
  sourcePath: string;
10296
10316
  exportName: string;
10297
- provenance: {
10298
- source: "manual" | "extracted" | "merged" | "migrated";
10299
- verified: boolean;
10300
- frameworkSupport?: "native" | "manual-only" | undefined;
10301
- sourceHash?: string | undefined;
10302
- extractedAt?: string | undefined;
10303
- };
10304
10317
  propsSummary: string[];
10305
10318
  usage: {
10306
10319
  when: string[];
@@ -10309,8 +10322,6 @@ declare const componentContractSchema: z.ZodObject<{
10309
10322
  accessibility?: string[] | undefined;
10310
10323
  };
10311
10324
  $schema: string;
10312
- status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10313
- tokens?: string[] | undefined;
10314
10325
  preview?: {
10315
10326
  css?: string[] | undefined;
10316
10327
  theme?: "light" | "dark" | undefined;
@@ -10318,6 +10329,8 @@ declare const componentContractSchema: z.ZodObject<{
10318
10329
  wrapperModule?: string | undefined;
10319
10330
  wrapperExport?: string | undefined;
10320
10331
  } | undefined;
10332
+ status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10333
+ tokens?: string[] | undefined;
10321
10334
  contract?: {
10322
10335
  compoundChildren?: Record<string, {
10323
10336
  description?: string | undefined;
@@ -10538,6 +10551,7 @@ interface MakeFindingInput {
10538
10551
  message: string;
10539
10552
  location: FactLocation;
10540
10553
  evidence: FactEvidence[];
10554
+ evidenceGrade?: EvidenceGrade;
10541
10555
  fingerprintIdentity: Record<string, unknown>;
10542
10556
  fix?: FindingFix;
10543
10557
  attributes?: Record<string, unknown>;
@@ -10554,9 +10568,9 @@ declare function makeFinding(input: MakeFindingInput): Finding;
10554
10568
  */
10555
10569
  declare const BLOCKING_RULE_ALLOWLIST: ReadonlySet<string>;
10556
10570
  /**
10557
- * Mirrors `scanWithFacts`'s own CI exit logic: a finding gates CI when it is
10558
- * error-severity, or warn-severity under `ci.failOnWarnings`. Gating on exactly
10559
- * this set is what makes a local/emit deny imply a CI failure.
10571
+ * A finding gates CI only when its evidence is source-backed or stronger, it is
10572
+ * not explicitly advisory, and its severity is configured to gate. Missing
10573
+ * grades are treated as source-backed for compatibility with older reports.
10560
10574
  */
10561
10575
  declare function gatesCi(finding: Finding, failOnWarnings: boolean): boolean;
10562
10576
  /** A finding may deny iff it is allowlisted, gates CI, and is not heuristic. */
@@ -11387,4 +11401,4 @@ declare function isEnforceableHtmlEquivalent(args: {
11387
11401
  explicit?: boolean;
11388
11402
  }): boolean;
11389
11403
 
11390
- export { type A11yNameRequiredFact, AGENT_CONTEXT_RELATIVE_PATH, AgentFormat, BLOCKING_RULE_ALLOWLIST, BRAND, BlockDefinition, type Brand, type BuildAgentFormatInput, type BuildRegistryInstallPlanInput, type BundleArtifactMetadata, type BundleComponentShard, type BundleManifest, type BundleManifestComponentEntry, type BundleSchemaVersion, type BundleTarget, type BundleTokenFile, CATALOG_FIXTURE_A_FCID, type CSF2Story, type CSSGeneratorOptions, type CanonicalCandidateFact, Finding as CanonicalFinding, type CanonicalMappingFact, type CanonicalReplacementFact, CanonicalSource, type CheckStoryExclusionOpts, type CheckedSpacingValue, type ClassNameDynamicFact, type ClassNameDynamicReason, type ClassNameFact, type ClassNameLiteralFact, type ClassNameOrigin, CompiledBlock, type CompiledContractOutput, CompiledFragment, type ComplexityTier, type ComponentCapabilityFact, type ComponentContract, type ComponentFactInput, type ComponentId, type ComponentLevelFact, type ComponentMetadataFact, type CompositionAnalysis, type CompositionAuthoringEntry, type CompositionChildSelector, type CompositionConstraint, type CompositionGuideline, type CompositionPattern, type CompositionRegionSelector, type CompositionSuggestion, type CompositionWarning, type ConformChange, type ConformComponentMapping, type ConformConfidence, type ConformCoverage, type ConformInput, type ConformLocation, type ConformPropMapping, type ConformResult, type ConformSuggestion, type ConformToken, type ConformUnresolved, ContractCatalogInput, ContractDomain, type ContractStampPin, type ContractStampRecord, DEFAULTS, DEFAULT_ENHANCED_STYLE_PROPERTIES, DEFAULT_STYLE_PROPERTIES, type DTCGColorValue, type DTCGDimensionValue, type DTCGGroup, type DTCGToken, type DTCGTokenFile, type DTCGTokenType, type Decorator, type Defaults, type DeltaEMatch, type DesignSystemContext, type DesignToken, type DesignTokenParseOptions, type DiscoverComponentsOptions, type EnhancedStyleComparisonResult, type EnhancedStyleDiffItem, type ExclusionReason, type ExclusionResult, FRAGMENTS_INTERNAL_RULE_IDS, type Fact, type FactEvidence, type FactId, FactIndex, type FactKind, type FactLocation, type FactOfKind, FigmaBooleanMapping, FigmaChildrenMapping, FigmaEnumMapping, FigmaInstanceMapping, FigmaStringMapping, FigmaTextContentMapping, type FigmaVariable, type FigmaVariableCollection, Finding, FindingFix, type Fragment, type FragmentAccessibility, FragmentComponent, type FragmentContextOptions, FragmentDefinition, FragmentDefinitionV2, type FragmentDoNotItem, type FragmentFigma, type FragmentIndex, type FragmentMeta as FragmentJsonMeta, type FragmentUsage as FragmentJsonUsage, type FragmentPattern, type FragmentRegistry, type FragmentRelated, FragmentsConfig, Severity as FuiSeverity, GovernanceConfig, type GovernanceIntegrityFamily, type GovernanceIntegrityFamilyId, type GovernanceIntegrityInput, type GovernanceIntegrityStatus, type GovernanceIntegrityVerdict, GovernanceSeverity, GovernedFragmentDefinition, type InferProps, type JsxComponentPreferredFact, type JsxImportPathPreferredFact, type JsxInlineStyleForbiddenRawFact, type JsxUnknownPropsForbiddenFact, type Loader, type McpBlock, type McpCapability, type McpComponent, type McpComponentExample, type McpComponentGuidance, type McpComponentMetadata, type McpComponentProp, type McpComponentRelation, type McpCompoundChild, type McpGuidancePattern, type McpPerformanceData, type McpPerformanceImport, type McpPerformanceSummary, type McpSnapshot, type McpSnapshotMetadata, type McpSnapshotSchemaVersion, type McpSourceType, type McpToken, type McpTokenData, type NearestByDeltaEOptions, type NormalizedStyleMap, type NormalizedToken, PRESET_NAMES, PROVE_DEFAULT_MAX_PASSES, PROVE_MAX_PASSES, type ParseTokensOptions, type ParsedToken, type PerformanceData as PerfData, type PerformanceSummary as PerfSummary, type PerformanceBudgets, type PerformanceConfig, type PolicyFact, type PresetRuleState, type PreviewConfig, type PreviewRuntimeOptions, type PreviewRuntimeState, type PreviewVariantLike, PreviewVariantRuntime, type PropMetadataFact, type PropValueAvoidedFact, type PropValueForbiddenFact, type ProveCallbacks, type ProveLoopResult, type ProveOptions, type ProvePass, type ProvePassSampling, type ProveResidual, type ProveSample, type ProveSamplerArgs, type ProveVerdict, RAW_HTML_ADVISORY_TAGS, RAW_HTML_CANONICAL_TAGS, RAW_HTML_INPUT_TYPE_CANONICALS, RAW_HTML_ROLE_CANONICALS, type RGB, type RGBA, RULES, RULE_TIER, type RawHtmlCanonicalMatch, type RawHtmlPrecisionTier, RegistryArtifact, type RegistryComponentEntry, RegistryDependency, type RegistryInstallPlan, RegistryInstallReceipt, type RegistryPropEntry, type RegistryWritePlan, RelationshipType, type ResolvedDTCGToken, ResolvedGovernedFragmentDefinition, type Rule, type RuleFn, type RuleTier, type SCSSGeneratorOptions, type ScaleFact, type ScaleValueFact, Severity, type SpacingResolutionScale, type SpacingTokenLookup, type Story, type StoryArgType, type StoryContext, type StoryMeta, type StoryModule, StorybookFilterConfig, type StructuralConfidenceFact, type StyleComparisonOptions, type StyleComparisonResult, type StyleCssVarsMustBeDefinedFact, type StyleDeclarationFact, type StyleDiffItem, type StyleFontSizeScaleFact, type StylePropertyScaleFact, type StyleRawColorForbiddenFact, type StyleUnsupportedFact, type SuppressionDirectiveFact, type TailwindClassFact, type TailwindModifier, type TailwindModifierKind, type TailwindPaletteAllowFact, type TailwindPaletteDenyFact, type TailwindResolutionSource, type TailwindResolvedKind, type TailwindResolvedValue, type TailwindTokenResolvedFact, type TailwindUnknownClassEnabledFact, type TailwindValue, type ThemeDeclarationFact, type ThemeParserResult, type TokenCategory, TokenConfig, type TokenDefinitionFact, type TokenFix, type TokenFormat, type TokenLookup, type TokenMatchRequest, type TokenMatchResult, type TokenParseError, type TokenParseOutput, type TokenParseResult, type TokenRegistry, type TokenRegistryMeta, type TokenUsageSummary, type UnsupportedStyleReason, type UsageComponentFact, type UsageFact, type UsageImportFact, type UsageInlineStyleFact, type UsageNodeFact, type UsagePropResolvedFact, type UsageTextChildFact, VariantLoader, aiMetadataSchema, analyzeComposition, asComponentId, assertPortableRegistryPath, blockDefinitionSchema, budgetBar, buildAgentFormat, buildRegistryInstallPlan, buildRegistryInstallReceipt, buildSpacingTokenLookup, bundleArtifactMetadataSchema, bundleComponentShardSchema, bundleManifestComponentEntrySchema, bundleManifestSchema, bundleSchemaVersionSchema, bundleTargetSchema, bundleTokenFileSchema, calculateDeltaE, canonicalJson, canonicalPreimage, catalogFixtureA, catalogFixtureAContractPayload, catalogFixtureATokensDtcg, checkStoryExclusion, clampMaxPasses, classifyComplexity, collectRegistryInstallDependencies, colorSimilarity, compareByVocabularyRank, compareColors, compareNumericValues, compareStyleValue, compareStyles, compareStylesWithTokens, compileBlock, compileComponentFacts, compileFragment, compileGlobalGovernanceFacts, compileRecipe, componentContractSchema, componentId, componentRelationSchema, compositionAuthoringEntrySchema, compositionMetadataSchema, compositionPatternSchema, containsTailwindV4Theme, contractHash, contractTierRuleIds, customerDefaultRuleStates, defineBlock, defineConfig, defineFragment, defineRecipe, detectSubComponentPaths, discoverComponents, dtcgTokenFileSchema, emptyConformResult, evaluateGovernanceIntegrity, executeVariantLoaders, factId, familyDistance, figma, figmaPropMappingSchema, formatBytes, formatStampHeader, formatStampPin, formatStampVersionHash, formatTokenSummary, fragmentBanSchema, fragmentContractSchema, fragmentDefinitionSchema, fragmentDefinitionV2Schema, fragmentGeneratedSchema, fragmentMetaSchema, fragmentProvenanceSchema, fragmentUsageSchema, fragmentVariantSchema, fragmentsConfigSchema, fragmentsPresetRuleStates, gatesCi, generateCSSCustomProperties, generateFigmaVariables, generateSCSSVariables, generateTailwindConfig, getComplianceBadge, getPreviewConfig, governedFragmentDefinitionSchema, hasEffectiveComponentVocabulary, hash64Hex, hexToRgb, hygieneTierRuleIds, inferTokenCategory, inferTokenGroup, isColorLike, isCompositionPattern, isConfigExcluded, isContractFile, isContractTierRule, isDTCGFile, isDenyEligible, isEffectiveCanonicalSource, isEnforceableHtmlEquivalent, isExportStory, isFigmaPropMapping, isForceIncluded, isPortableRepoPath, isRawHtmlAdvisoryTier, isReactComponent, lowerCompositionContract, makeA11yNameRequiredFact, makeCanonicalCandidateFact, makeCanonicalMappingFact, makeCanonicalReplacementFact, makeClassNameDynamicFact, makeClassNameLiteralFact, makeComponentCapabilityFact, makeComponentMetadataFact, makeContractTokenFact, makeFinding, makeJsxComponentPreferredFact, makeJsxImportPathPreferredFact, makeJsxInlineStyleForbiddenRawFact, makeJsxUnknownPropsForbiddenFact, makePropMetadataFact, makePropValueAvoidedFact, makePropValueForbiddenFact, makeScaleFact, makeScaleValueFact, makeStructuralConfidenceFact, makeStyleCssVarsMustBeDefinedFact, makeStyleDeclarationFact, makeStyleFontSizeScaleFact, makeStylePropertyScaleFact, makeStyleRawColorForbiddenFact, makeStyleUnsupportedFact, makeTailwindClassFact, makeTailwindPaletteAllowFact, makeTailwindPaletteDenyFact, makeTailwindTokenResolvedFact, makeTailwindUnknownClassEnabledFact, makeThemeDeclarationFact, makeTokenDefinitionFact, makeUsageComponentFact, makeUsageImportFact, makeUsageInlineStyleFact, makeUsageNodeFact, makeUsagePropResolvedFact, makeUsageTextChildFact, matchesGlob, mcpBlockSchema, mcpCapabilitySchema, mcpComponentExampleSchema, mcpComponentGuidanceSchema, mcpComponentMetadataSchema, mcpComponentPropSchema, mcpComponentRelationSchema, mcpComponentSchema, mcpCompoundChildSchema, mcpGuidancePatternSchema, mcpPerformanceDataSchema, mcpPerformanceImportSchema, mcpPerformanceSummarySchema, mcpSnapshotMetadataSchema, mcpSnapshotSchema, mcpSnapshotSchemaVersionSchema, mcpSourceTypeSchema, mcpTokenDataSchema, mcpTokenSchema, nearestByDeltaE, nearestSignedScaleValue, normalizeColor, normalizeConfigPath, normalizeRegistryRepoPath, normalizeStyleValue, normalizeToV1, normalizeTokenGroupComment, normalizeTokenValue, parseColor, parseColorToRgb, parseComponentContract, parseContractStamp, parseCssTokens, parseDtcgTokens as parseDTCGFile, parseDesignTokenContent, parseDtcgTokens, parseRgb, parseScssTokens, parseScssVariables, parseTailwindV4Theme, parseTokenFile, parseTokens, portableRepoPathError, propDefinitionSchema, proveCompliant, proveIssueCount, recipeDefinitionSchema, resolveCanonicalForAriaRole, resolveCanonicalForRawHtml, resolveConfiguredAppPath, resolveDesignTokenValue, resolveFigmaMapping, resolvePerformanceConfig, resolvePreviewRuntimeState, resolveProveVerdict, resolveSpacingValue, resolveTokenValue, rgbToHex, ruleA11yRequiredAccessibleName, ruleComponentsForbiddenPropValue, ruleComponentsPreferLibrary, ruleComponentsUnknownProp, ruleJsxPreferredComponent, ruleJsxPreferredImportPath, rulePropsInvalidValue, ruleStylesNoRawColor, ruleStylesNoRawDimensions, ruleStylesNoRawSpacing, ruleStylesNoRawTypography, ruleTailwindArbitraryColor, ruleTailwindArbitrarySpacing, ruleTailwindForbiddenPalette, ruleTailwindOffScaleSpacingToken, ruleTailwindRawColorViaToken, ruleTailwindUnknownClass, ruleThemeNoThemeCoupledLiteral, ruleTokensRequireDualFallback, runRules, selectedRegistryComponentNames, serializeContractStamp, setPreviewConfig, sha256Hex, sourceToRegistryTargetPath, storyModuleToFragment, storyNameFromExport, tierFor, toId, tokenIncludesFromConfig, topologyBase, usePreviewVariantRuntime, vocabularyRank };
11404
+ export { type A11yNameRequiredFact, AGENT_CONTEXT_RELATIVE_PATH, AgentFormat, BLOCKING_RULE_ALLOWLIST, BRAND, BlockDefinition, type Brand, type BuildAgentFormatInput, type BuildRegistryInstallPlanInput, type BundleArtifactMetadata, type BundleComponentShard, type BundleManifest, type BundleManifestComponentEntry, type BundleSchemaVersion, type BundleTarget, type BundleTokenFile, CATALOG_FIXTURE_A_FCID, type CSF2Story, type CSSGeneratorOptions, type CanonicalCandidateFact, Finding as CanonicalFinding, type CanonicalMappingFact, type CanonicalReplacementFact, CanonicalSource, type CheckStoryExclusionOpts, type CheckedSpacingValue, type ClassNameDynamicFact, type ClassNameDynamicReason, type ClassNameFact, type ClassNameLiteralFact, type ClassNameOrigin, CompiledBlock, type CompiledContractOutput, CompiledFragment, type ComplexityTier, type ComponentCapabilityFact, type ComponentContract, type ComponentFactInput, type ComponentId, type ComponentLevelFact, type ComponentMetadataFact, type CompositionAnalysis, type CompositionAuthoringEntry, type CompositionChildSelector, type CompositionConstraint, type CompositionGuideline, type CompositionPattern, type CompositionRegionSelector, type CompositionSuggestion, type CompositionWarning, type ConformChange, type ConformComponentMapping, type ConformConfidence, type ConformCoverage, type ConformInput, type ConformLocation, type ConformPropMapping, type ConformResult, type ConformSuggestion, type ConformToken, type ConformUnresolved, ContractCatalogInput, ContractDomain, type ContractStampPin, type ContractStampRecord, DEFAULTS, DEFAULT_ENHANCED_STYLE_PROPERTIES, DEFAULT_STYLE_PROPERTIES, type DTCGColorValue, type DTCGDimensionValue, type DTCGGroup, type DTCGToken, type DTCGTokenFile, type DTCGTokenType, type Decorator, type Defaults, type DeltaEMatch, type DesignSystemContext, type DesignToken, type DesignTokenParseOptions, type DiscoverComponentsOptions, type EnhancedStyleComparisonResult, type EnhancedStyleDiffItem, EvidenceGrade, type ExclusionReason, type ExclusionResult, FRAGMENTS_INTERNAL_RULE_IDS, type Fact, type FactEvidence, type FactId, FactIndex, type FactKind, type FactLocation, type FactOfKind, FigmaBooleanMapping, FigmaChildrenMapping, FigmaEnumMapping, FigmaInstanceMapping, FigmaStringMapping, FigmaTextContentMapping, type FigmaVariable, type FigmaVariableCollection, Finding, FindingFix, type Fragment, type FragmentAccessibility, FragmentComponent, type FragmentContextOptions, FragmentDefinition, FragmentDefinitionV2, type FragmentDoNotItem, type FragmentFigma, type FragmentIndex, type FragmentMeta as FragmentJsonMeta, type FragmentUsage as FragmentJsonUsage, type FragmentPattern, type FragmentRegistry, type FragmentRelated, FragmentsConfig, Severity as FuiSeverity, GovernanceConfig, type GovernanceIntegrityFamily, type GovernanceIntegrityFamilyId, type GovernanceIntegrityInput, type GovernanceIntegrityStatus, type GovernanceIntegrityVerdict, GovernanceSeverity, GovernedFragmentDefinition, type InferProps, type JsxComponentPreferredFact, type JsxImportPathPreferredFact, type JsxInlineStyleForbiddenRawFact, type JsxUnknownPropsForbiddenFact, type Loader, type McpBlock, type McpCapability, type McpComponent, type McpComponentExample, type McpComponentGuidance, type McpComponentMetadata, type McpComponentProp, type McpComponentRelation, type McpCompoundChild, type McpGuidancePattern, type McpPerformanceData, type McpPerformanceImport, type McpPerformanceSummary, type McpSnapshot, type McpSnapshotMetadata, type McpSnapshotSchemaVersion, type McpSourceType, type McpToken, type McpTokenData, type NearestByDeltaEOptions, type NormalizedStyleMap, type NormalizedToken, PRESET_NAMES, PROVE_DEFAULT_MAX_PASSES, PROVE_MAX_PASSES, type ParseTokensOptions, type ParsedToken, type PerformanceData as PerfData, type PerformanceSummary as PerfSummary, type PerformanceBudgets, type PerformanceConfig, type PolicyFact, type PresetRuleState, type PreviewConfig, type PreviewRuntimeOptions, type PreviewRuntimeState, type PreviewVariantLike, PreviewVariantRuntime, type PropMetadataFact, type PropValueAvoidedFact, type PropValueForbiddenFact, type ProveCallbacks, type ProveLoopResult, type ProveOptions, type ProvePass, type ProvePassSampling, type ProveResidual, type ProveSample, type ProveSamplerArgs, type ProveVerdict, RAW_HTML_ADVISORY_TAGS, RAW_HTML_CANONICAL_TAGS, RAW_HTML_INPUT_TYPE_CANONICALS, RAW_HTML_ROLE_CANONICALS, type RGB, type RGBA, RULES, RULE_TIER, type RawHtmlCanonicalMatch, type RawHtmlPrecisionTier, RegistryArtifact, type RegistryComponentEntry, RegistryDependency, type RegistryInstallPlan, RegistryInstallReceipt, type RegistryPropEntry, type RegistryWritePlan, RelationshipType, type ResolvedDTCGToken, ResolvedGovernedFragmentDefinition, type Rule, type RuleFn, type RuleTier, type SCSSGeneratorOptions, type ScaleFact, type ScaleValueFact, Severity, type SpacingResolutionScale, type SpacingTokenLookup, type Story, type StoryArgType, type StoryContext, type StoryMeta, type StoryModule, StorybookFilterConfig, type StructuralConfidenceFact, type StyleComparisonOptions, type StyleComparisonResult, type StyleCssVarsMustBeDefinedFact, type StyleDeclarationFact, type StyleDiffItem, type StyleFontSizeScaleFact, type StylePropertyScaleFact, type StyleRawColorForbiddenFact, type StyleUnsupportedFact, type SuppressionDirectiveFact, type TailwindClassFact, type TailwindModifier, type TailwindModifierKind, type TailwindPaletteAllowFact, type TailwindPaletteDenyFact, type TailwindResolutionSource, type TailwindResolvedKind, type TailwindResolvedValue, type TailwindTokenResolvedFact, type TailwindUnknownClassEnabledFact, type TailwindValue, type ThemeDeclarationFact, type ThemeParserResult, type TokenCategory, TokenConfig, type TokenDefinitionFact, type TokenFix, type TokenFormat, type TokenLookup, type TokenMatchRequest, type TokenMatchResult, type TokenParseError, type TokenParseOutput, type TokenParseResult, type TokenRegistry, type TokenRegistryMeta, type TokenUsageSummary, type UnsupportedStyleReason, type UsageComponentFact, type UsageFact, type UsageImportFact, type UsageInlineStyleFact, type UsageNodeFact, type UsagePropResolvedFact, type UsageTextChildFact, VariantLoader, aiMetadataSchema, analyzeComposition, asComponentId, assertPortableRegistryPath, blockDefinitionSchema, budgetBar, buildAgentFormat, buildRegistryInstallPlan, buildRegistryInstallReceipt, buildSpacingTokenLookup, bundleArtifactMetadataSchema, bundleComponentShardSchema, bundleManifestComponentEntrySchema, bundleManifestSchema, bundleSchemaVersionSchema, bundleTargetSchema, bundleTokenFileSchema, calculateDeltaE, canonicalJson, canonicalPreimage, catalogFixtureA, catalogFixtureAContractPayload, catalogFixtureATokensDtcg, checkStoryExclusion, clampMaxPasses, classifyComplexity, collectRegistryInstallDependencies, colorSimilarity, compareByVocabularyRank, compareColors, compareNumericValues, compareStyleValue, compareStyles, compareStylesWithTokens, compileBlock, compileComponentFacts, compileFragment, compileGlobalGovernanceFacts, compileRecipe, componentContractSchema, componentId, componentRelationSchema, compositionAuthoringEntrySchema, compositionMetadataSchema, compositionPatternSchema, containsTailwindV4Theme, contractHash, contractTierRuleIds, customerDefaultRuleStates, defineBlock, defineConfig, defineFragment, defineRecipe, detectSubComponentPaths, discoverComponents, dtcgTokenFileSchema, emptyConformResult, evaluateGovernanceIntegrity, executeVariantLoaders, factId, familyDistance, figma, figmaPropMappingSchema, formatBytes, formatStampHeader, formatStampPin, formatStampVersionHash, formatTokenSummary, fragmentBanSchema, fragmentContractSchema, fragmentDefinitionSchema, fragmentDefinitionV2Schema, fragmentGeneratedSchema, fragmentMetaSchema, fragmentProvenanceSchema, fragmentUsageSchema, fragmentVariantSchema, fragmentsConfigSchema, fragmentsPresetRuleStates, gatesCi, generateCSSCustomProperties, generateFigmaVariables, generateSCSSVariables, generateTailwindConfig, getComplianceBadge, getPreviewConfig, governedFragmentDefinitionSchema, hasEffectiveComponentVocabulary, hash64Hex, hexToRgb, hygieneTierRuleIds, inferTokenCategory, inferTokenGroup, isColorLike, isCompositionPattern, isConfigExcluded, isContractFile, isContractTierRule, isDTCGFile, isDenyEligible, isEffectiveCanonicalSource, isEnforceableHtmlEquivalent, isExportStory, isFigmaPropMapping, isForceIncluded, isPortableRepoPath, isRawHtmlAdvisoryTier, isReactComponent, lowerCompositionContract, makeA11yNameRequiredFact, makeCanonicalCandidateFact, makeCanonicalMappingFact, makeCanonicalReplacementFact, makeClassNameDynamicFact, makeClassNameLiteralFact, makeComponentCapabilityFact, makeComponentMetadataFact, makeContractTokenFact, makeFinding, makeJsxComponentPreferredFact, makeJsxImportPathPreferredFact, makeJsxInlineStyleForbiddenRawFact, makeJsxUnknownPropsForbiddenFact, makePropMetadataFact, makePropValueAvoidedFact, makePropValueForbiddenFact, makeScaleFact, makeScaleValueFact, makeStructuralConfidenceFact, makeStyleCssVarsMustBeDefinedFact, makeStyleDeclarationFact, makeStyleFontSizeScaleFact, makeStylePropertyScaleFact, makeStyleRawColorForbiddenFact, makeStyleUnsupportedFact, makeTailwindClassFact, makeTailwindPaletteAllowFact, makeTailwindPaletteDenyFact, makeTailwindTokenResolvedFact, makeTailwindUnknownClassEnabledFact, makeThemeDeclarationFact, makeTokenDefinitionFact, makeUsageComponentFact, makeUsageImportFact, makeUsageInlineStyleFact, makeUsageNodeFact, makeUsagePropResolvedFact, makeUsageTextChildFact, matchesGlob, mcpBlockSchema, mcpCapabilitySchema, mcpComponentExampleSchema, mcpComponentGuidanceSchema, mcpComponentMetadataSchema, mcpComponentPropSchema, mcpComponentRelationSchema, mcpComponentSchema, mcpCompoundChildSchema, mcpGuidancePatternSchema, mcpPerformanceDataSchema, mcpPerformanceImportSchema, mcpPerformanceSummarySchema, mcpSnapshotMetadataSchema, mcpSnapshotSchema, mcpSnapshotSchemaVersionSchema, mcpSourceTypeSchema, mcpTokenDataSchema, mcpTokenSchema, nearestByDeltaE, nearestSignedScaleValue, normalizeColor, normalizeConfigPath, normalizeRegistryRepoPath, normalizeStyleValue, normalizeToV1, normalizeTokenGroupComment, normalizeTokenValue, parseColor, parseColorToRgb, parseComponentContract, parseContractStamp, parseCssTokens, parseDtcgTokens as parseDTCGFile, parseDesignTokenContent, parseDtcgTokens, parseRgb, parseScssTokens, parseScssVariables, parseTailwindV4Theme, parseTokenFile, parseTokens, portableRepoPathError, propDefinitionSchema, proveCompliant, proveIssueCount, recipeDefinitionSchema, resolveCanonicalForAriaRole, resolveCanonicalForRawHtml, resolveConfiguredAppPath, resolveDesignTokenValue, resolveFigmaMapping, resolvePerformanceConfig, resolvePreviewRuntimeState, resolveProveVerdict, resolveSpacingValue, resolveTokenValue, rgbToHex, ruleA11yRequiredAccessibleName, ruleComponentsForbiddenPropValue, ruleComponentsPreferLibrary, ruleComponentsUnknownProp, ruleJsxPreferredComponent, ruleJsxPreferredImportPath, rulePropsInvalidValue, ruleStylesNoRawColor, ruleStylesNoRawDimensions, ruleStylesNoRawSpacing, ruleStylesNoRawTypography, ruleTailwindArbitraryColor, ruleTailwindArbitrarySpacing, ruleTailwindForbiddenPalette, ruleTailwindOffScaleSpacingToken, ruleTailwindRawColorViaToken, ruleTailwindUnknownClass, ruleThemeNoThemeCoupledLiteral, ruleTokensRequireDualFallback, runRules, selectedRegistryComponentNames, serializeContractStamp, setPreviewConfig, sha256Hex, sourceToRegistryTargetPath, storyModuleToFragment, storyNameFromExport, tierFor, toId, tokenIncludesFromConfig, topologyBase, usePreviewVariantRuntime, vocabularyRank };