@usefragments/core 1.0.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 (59) hide show
  1. package/dist/{chunk-R3X7UBHU.js → chunk-57QDBEHQ.js} +101 -6
  2. package/dist/chunk-57QDBEHQ.js.map +1 -0
  3. package/dist/{chunk-243QYRUF.js → chunk-MLRDNSSA.js} +88 -47
  4. package/dist/chunk-MLRDNSSA.js.map +1 -0
  5. package/dist/codes/index.d.ts +2 -2
  6. package/dist/codes/index.js +2 -2
  7. package/dist/compiled-types/index.d.ts +1 -1
  8. package/dist/generate/index.d.ts +1 -1
  9. package/dist/{governance-BOa3KyiJ.d.ts → governance-DYSirwJu.d.ts} +22 -1
  10. package/dist/index-h_yWj15D.d.ts +6981 -0
  11. package/dist/index.d.ts +113 -97
  12. package/dist/index.js +387 -113
  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 +3 -2584
  17. package/dist/schemas/index.js +9 -1
  18. package/dist/test-utils.d.ts +1 -1
  19. package/package.json +1 -1
  20. package/src/agent-format.test.ts +144 -2
  21. package/src/agent-format.ts +34 -7
  22. package/src/codes/__tests__/codes.test.ts +57 -7
  23. package/src/codes/codes.ts +44 -42
  24. package/src/conform-prove.ts +4 -8
  25. package/src/contract/index.ts +3 -0
  26. package/src/contract/preimage.test.ts +50 -0
  27. package/src/contract/preimage.ts +56 -0
  28. package/src/evidence.ts +27 -0
  29. package/src/facts/builders.ts +4 -0
  30. package/src/facts/fact-index.ts +25 -1
  31. package/src/facts/facts.test.ts +49 -0
  32. package/src/facts/types.ts +3 -0
  33. package/src/governance-integrity.test.ts +2 -0
  34. package/src/governance-integrity.ts +7 -1
  35. package/src/index.ts +13 -0
  36. package/src/rules/__tests__/fix-emission-invariant.test.ts +174 -0
  37. package/src/rules/__tests__/tokens-require-dual-fallback.test.ts +90 -0
  38. package/src/rules/components-prefer-library.ts +165 -7
  39. package/src/rules/emit-gate.test.ts +40 -2
  40. package/src/rules/emit-gate.ts +21 -10
  41. package/src/rules/finding.ts +3 -0
  42. package/src/rules/fix-availability.ts +33 -0
  43. package/src/rules/rules.test.ts +180 -24
  44. package/src/rules/spacing-resolution.ts +5 -8
  45. package/src/rules/styles-no-raw-color.ts +32 -23
  46. package/src/rules/styles-no-raw-dimensions.ts +31 -12
  47. package/src/rules/styles-no-raw-spacing.ts +33 -11
  48. package/src/rules/styles-no-raw-typography.ts +37 -15
  49. package/src/rules/taxonomy.test.ts +19 -3
  50. package/src/rules/tiers.ts +1 -1
  51. package/src/rules/tokens-require-dual-fallback.ts +54 -17
  52. package/src/rules/utils.ts +51 -0
  53. package/src/schemas/index.ts +106 -4
  54. package/src/token-types.ts +6 -0
  55. package/src/tokens/__tests__/source-names.test.ts +42 -0
  56. package/src/tokens/design-token-parser.test.ts +24 -5
  57. package/src/tokens/design-token-parser.ts +40 -8
  58. package/dist/chunk-243QYRUF.js.map +0 -1
  59. package/dist/chunk-R3X7UBHU.js.map +0 -1
package/dist/index.d.ts CHANGED
@@ -1,10 +1,10 @@
1
+ import { F as Finding, A as AgentFormat, E as EvidenceGrade, a as FindingFix } from './index-h_yWj15D.js';
2
+ export { b as AGENT_FORMAT_SCHEMA_VERSION, c as AgentErrorEnvelope, d as AgentOutput, G as CanonicalGovernanceVerdict, e as EVIDENCE_ORDER, f as FindingReplaceClassTokenFix, g as FindingReplaceComponentFix, h as FindingReplaceImportFix, i as FindingReplacePropValueFix, j as FindingReplaceStyleValueFix, k as Fix, l as GovernanceVerdictMetadata, I as InspectClaim, m as InspectClaimTier, S as SuppressionDirective, V as ValidatorResult, n as Violation, o as agentErrorEnvelopeSchema, p as agentFormatSchema, q as agentIntegritySchema, r as agentOutputSchema, s as canBlock, t as factEvidenceSchema, u as factLocationSchema, v as findingFixSchema, w as findingReplaceClassTokenFixSchema, x as findingReplaceComponentFixSchema, y as findingReplaceImportFixSchema, z as findingReplacePropValueFixSchema, B as findingReplaceStyleValueFixSchema, C as findingSchema, D as fixSchema, H as governanceVerdictMetadataSchema, J as governanceVerdictSchema, K as normalizeFinding, L as normalizeSeverity, M as normalizeViolation, N as suppressionDirectiveSchema, O as validatorResultSchema, P as violationSchema } from './index-h_yWj15D.js';
1
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 { GovernanceVerdict as CanonicalGovernanceVerdict, FindingReplaceClassTokenFix, FindingReplaceComponentFix, FindingReplaceImportFix, FindingReplacePropValueFix, FindingReplaceStyleValueFix, Fix, GovernanceVerdictMetadata, SuppressionDirective, ValidatorResult, Violation, agentFormatSchema, 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
- 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-BOa3KyiJ.js';
7
- export { A as AIMetadata, r as AccessibilityGovernanceBuilder, s as AppConfig, t as BaselineInfo, u as BoundingBox, v as CONTRACT_DOMAINS, w as CONTRACT_PREIMAGE_SCHEMA, x as CanonicalMappingStatus, y as CompiledFragmentsFile, z as CompiledRecipe, D as CompiledTokenData, E as CompiledTokenEntry, H as ComponentGovernanceBuilder, I as ComponentGovernanceRecord, J as ComponentRef, K as ComponentRelation, L as CompositionMetadata, M as ContractCanonicalMappingInput, N as ContractComponentInput, O as ContractPolicyInput, P as ContractPreimage, Q as ContractPropMappingInput, U as ContractTokenInput, W as ContractWaiverInput, X as ControlType, Y as DesignSystemConfig, Z as DiffResult, _ as FigmaPropMapping, $ as FragmentContract, a0 as FragmentExample, a1 as FragmentGenerated, a2 as FragmentGuidance, a3 as FragmentMeta, a4 as FragmentProvenance, a5 as FragmentUsage, a6 as FragmentVariant, a7 as GlobalGovernanceRecord, a8 as GlobalJsxGovernanceRecord, a9 as GlobalStyleGovernanceRecord, aa as GovernancePropValue, ab as InspectConfig, ac as LocalCanonicalDeclaration, ad as LocalCanonicalResolveRule, ae as Manifest, af as ObservedComponentUsage, ag as ObservedUsageProp, ah as PlayFunction, ai as PlayFunctionContext, aj as PropDefinition, ak as PropGovernanceBuilder, al as PropGovernanceOptions, am as PropKey, an as PropType, ao as RecipeDefinition, ap as RegistryOptions, aq as RepoRelativePath, ar as ScaleGovernanceRecord, as as Screenshot, at as ScreenshotConfig, au as ScreenshotMetadata, av as ServiceConfig, aw as SnapshotConfig, ax as SnippetPolicyConfig, ay as Theme, az as ThemeSeeds, aA as TokenSourceConfig, aB as TokenSourceFormat, aC as VerifyRequest, aD as VerifyResult, aE as Viewport, aF as componentGovernanceRecordSchema, aG as componentGovernanceRecordsSchema, aH as contractComponentsFromFragments, aI as contractPolicyFromGovernanceConfig, aJ as diffContractDomains, aK as g, aL as globalGovernanceRecordSchema, aM as globalJsxGovernanceRecordSchema, aN as globalStyleGovernanceRecordSchema, aO as governanceConfigSchema, aP as governanceConfigWithLocalCanonical, aQ as governanceSeveritySchema, aR as localCanonicalContractMappings, aS as normalizeGovernanceConfig, aT as projectContractPreimage, aU as scaleGovernanceRecordSchema } from './governance-BOa3KyiJ.js';
6
+ import { c as ContractDomain, d as ContractCatalogInput, G as GovernanceSeverity, b as CompiledFragment, e as GovernedFragmentDefinition, R as ResolvedGovernedFragmentDefinition, f as GovernanceConfig, g as FragmentsConfig, T as TokenConfig, h as FragmentComponent, B as BlockDefinition, C as CompiledBlock, F as FragmentDefinition, a as FragmentDefinitionV2, S as StorybookFilterConfig, i as FigmaStringMapping, j as FigmaBooleanMapping, k as FigmaEnumMapping, l as FigmaInstanceMapping, m as FigmaChildrenMapping, n as FigmaTextContentMapping, o as RelationshipType, V as VariantRenderOptions, p as VariantLoader, q as CanonicalSource } from './governance-DYSirwJu.js';
7
+ export { A as AIMetadata, r as AccessibilityGovernanceBuilder, s as AppConfig, t as BaselineInfo, u as BoundingBox, v as CONTRACT_DOMAINS, w as CONTRACT_PREIMAGE_CAPABILITY_HEADER, x as CONTRACT_PREIMAGE_SCHEMA, y as CanonicalMappingStatus, z as CompiledFragmentsFile, D as CompiledRecipe, E as CompiledTokenData, H as CompiledTokenEntry, I as ComponentGovernanceBuilder, J as ComponentGovernanceRecord, K as ComponentRef, L as ComponentRelation, M as CompositionMetadata, N as ContractCanonicalMappingInput, O as ContractComponentInput, P as ContractIdentityPin, Q as ContractPolicyInput, U as ContractPreimage, W as ContractPropMappingInput, X as ContractTokenInput, Y as ContractWaiverInput, Z as ControlType, _ as DesignSystemConfig, $ as DiffResult, a0 as FigmaPropMapping, a1 as FragmentContract, a2 as FragmentExample, a3 as FragmentGenerated, a4 as FragmentGuidance, a5 as FragmentMeta, a6 as FragmentProvenance, a7 as FragmentUsage, a8 as FragmentVariant, a9 as GlobalGovernanceRecord, aa as GlobalJsxGovernanceRecord, ab as GlobalStyleGovernanceRecord, ac as GovernancePropValue, ad as InspectConfig, ae as LocalCanonicalDeclaration, af as LocalCanonicalResolveRule, ag as Manifest, ah as ObservedComponentUsage, ai as ObservedUsageProp, aj as PlayFunction, ak as PlayFunctionContext, al as PropDefinition, am as PropGovernanceBuilder, an as PropGovernanceOptions, ao as PropKey, ap as PropType, aq as RecipeDefinition, ar as RegistryOptions, as as RepoRelativePath, at as ScaleGovernanceRecord, au as Screenshot, av as ScreenshotConfig, aw as ScreenshotMetadata, ax as ServiceConfig, ay as SnapshotConfig, az as SnippetPolicyConfig, aA as Theme, aB as ThemeSeeds, aC as TokenSourceConfig, aD as TokenSourceFormat, aE as VerifyRequest, aF as VerifyResult, aG as Viewport, aH as componentGovernanceRecordSchema, aI as componentGovernanceRecordsSchema, aJ as contractComponentsFromFragments, aK as contractPolicyFromGovernanceConfig, aL as diffContractDomains, aM as g, aN as globalGovernanceRecordSchema, aO as globalJsxGovernanceRecordSchema, aP as globalStyleGovernanceRecordSchema, aQ as governanceConfigSchema, aR as governanceConfigWithLocalCanonical, aS as governanceSeveritySchema, aT as localCanonicalContractMappings, aU as normalizeGovernanceConfig, aV as projectContractPreimage, aW as scaleGovernanceRecordSchema, aX as verifiedContractPreimageFromPin } from './governance-DYSirwJu.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';
@@ -260,8 +260,7 @@ interface DesignSystemContext {
260
260
  *
261
261
  * Determinism (architecture §6.3): the sampler receives `(seq, codeHashAtRequest)`
262
262
  * so a durable-replay layer can key recorded sampler output on the exact code it
263
- * was asked to repair, and hard-invalidate on a hash mismatch — instead of the
264
- * pass-index-only key the standalone MCP tool uses.
263
+ * was asked to repair and hard-invalidate on a hash mismatch.
265
264
  *
266
265
  * Browser-safe: depends only on the conform contract types + the pure SHA-256
267
266
  * in this package. No Node APIs.
@@ -729,6 +728,7 @@ interface JsxComponentPreferredFact extends BaseFact {
729
728
  */
730
729
  interface TokenDefinitionFact extends BaseFact {
731
730
  kind: "token_definition";
731
+ location?: FactLocation;
732
732
  /** Token identifier, e.g., "fui-color-accent" or "--fui-color-accent". */
733
733
  name: string;
734
734
  /** Resolved value, e.g., "#2563eb". */
@@ -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";
@@ -1176,8 +1178,10 @@ declare function makeJsxComponentPreferredFact(input: {
1176
1178
  declare function makeTokenDefinitionFact(input: {
1177
1179
  name: string;
1178
1180
  value: string;
1181
+ location?: TokenDefinitionFact["location"];
1179
1182
  category?: TokenDefinitionFact["category"];
1180
1183
  referenceFormat?: TokenDefinitionFact["referenceFormat"];
1184
+ sourceNames?: TokenDefinitionFact["sourceNames"];
1181
1185
  }): TokenDefinitionFact;
1182
1186
  declare function makeTailwindPaletteAllowFact(input: {
1183
1187
  patterns: string[];
@@ -1316,6 +1320,7 @@ declare class FactIndex {
1316
1320
  private readonly facts;
1317
1321
  private readonly idsByKind;
1318
1322
  private readonly idsByComponent;
1323
+ private readonly tokenBySymbol;
1319
1324
  add(fact: Fact): void;
1320
1325
  addMany(facts: Iterable<Fact>): void;
1321
1326
  get(id: FactId): Fact | undefined;
@@ -1373,7 +1378,10 @@ declare class FactIndex {
1373
1378
  tokens: {
1374
1379
  list: () => TokenDefinitionFact[];
1375
1380
  byCategory: (category: TokenDefinitionFact["category"]) => TokenDefinitionFact[];
1381
+ symbolExists: (name: string) => boolean;
1382
+ definitionForSymbol: (name: string) => TokenDefinitionFact | undefined;
1376
1383
  };
1384
+ private indexTokenSymbols;
1377
1385
  private byComponentOfKind;
1378
1386
  }
1379
1387
 
@@ -1398,6 +1406,7 @@ declare function compileComponentFacts(componentId: ComponentId, input: Componen
1398
1406
  interface BuildAgentFormatInput {
1399
1407
  findings: readonly Finding[];
1400
1408
  filesScanned: number;
1409
+ integrity: AgentFormat["integrity"];
1401
1410
  passed?: boolean;
1402
1411
  suppressions?: readonly SuppressionDirectiveFact[];
1403
1412
  iteration?: number;
@@ -1406,6 +1415,8 @@ interface BuildAgentFormatInput {
1406
1415
  maxFindings?: number;
1407
1416
  includeEvidence?: boolean;
1408
1417
  includeFindings?: boolean;
1418
+ provenance?: NonNullable<AgentFormat["provenance"]>;
1419
+ verdict?: NonNullable<AgentFormat["verdict"]>;
1409
1420
  }
1410
1421
  declare function buildAgentFormat(input: BuildAgentFormatInput): AgentFormat;
1411
1422
 
@@ -1525,6 +1536,10 @@ interface DesignToken {
1525
1536
  referenceChain: string[];
1526
1537
  /** Source file where this token was defined */
1527
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[];
1528
1543
  /** Line number in source file */
1529
1544
  lineNumber?: number;
1530
1545
  /** Theme this token belongs to (e.g., "default", "dark", "light") */
@@ -1759,7 +1774,7 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
1759
1774
  name: string;
1760
1775
  }[];
1761
1776
  publicSlug: string | null;
1762
- tier: "composition" | "core";
1777
+ tier: "core" | "composition";
1763
1778
  propCount: number;
1764
1779
  hasExamples: boolean;
1765
1780
  hasCompoundChildren: boolean;
@@ -1780,7 +1795,7 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
1780
1795
  name: string;
1781
1796
  }[];
1782
1797
  publicSlug: string | null;
1783
- tier: "composition" | "core";
1798
+ tier: "core" | "composition";
1784
1799
  propCount: number;
1785
1800
  hasExamples: boolean;
1786
1801
  hasCompoundChildren: boolean;
@@ -1827,13 +1842,13 @@ declare const bundleManifestSchema: z.ZodObject<{
1827
1842
  repoFullName: z.ZodString;
1828
1843
  resolution: z.ZodEnum<["explicit", "auto"]>;
1829
1844
  }, "strip", z.ZodTypeAny, {
1830
- resolution: "auto" | "explicit";
1845
+ resolution: "explicit" | "auto";
1831
1846
  bindingId: string;
1832
1847
  projectId: string;
1833
1848
  projectName: string;
1834
1849
  repoFullName: string;
1835
1850
  }, {
1836
- resolution: "auto" | "explicit";
1851
+ resolution: "explicit" | "auto";
1837
1852
  bindingId: string;
1838
1853
  projectId: string;
1839
1854
  projectName: string;
@@ -1889,7 +1904,7 @@ declare const bundleManifestSchema: z.ZodObject<{
1889
1904
  name: string;
1890
1905
  }[];
1891
1906
  publicSlug: string | null;
1892
- tier: "composition" | "core";
1907
+ tier: "core" | "composition";
1893
1908
  propCount: number;
1894
1909
  hasExamples: boolean;
1895
1910
  hasCompoundChildren: boolean;
@@ -1910,7 +1925,7 @@ declare const bundleManifestSchema: z.ZodObject<{
1910
1925
  name: string;
1911
1926
  }[];
1912
1927
  publicSlug: string | null;
1913
- tier: "composition" | "core";
1928
+ tier: "core" | "composition";
1914
1929
  propCount: number;
1915
1930
  hasExamples: boolean;
1916
1931
  hasCompoundChildren: boolean;
@@ -1933,7 +1948,7 @@ declare const bundleManifestSchema: z.ZodObject<{
1933
1948
  name: string;
1934
1949
  }[];
1935
1950
  publicSlug: string | null;
1936
- tier: "composition" | "core";
1951
+ tier: "core" | "composition";
1937
1952
  propCount: number;
1938
1953
  hasExamples: boolean;
1939
1954
  hasCompoundChildren: boolean;
@@ -1957,7 +1972,7 @@ declare const bundleManifestSchema: z.ZodObject<{
1957
1972
  slug: string;
1958
1973
  };
1959
1974
  sourceBinding: {
1960
- resolution: "auto" | "explicit";
1975
+ resolution: "explicit" | "auto";
1961
1976
  bindingId: string;
1962
1977
  projectId: string;
1963
1978
  projectName: string;
@@ -1979,7 +1994,7 @@ declare const bundleManifestSchema: z.ZodObject<{
1979
1994
  name: string;
1980
1995
  }[];
1981
1996
  publicSlug: string | null;
1982
- tier: "composition" | "core";
1997
+ tier: "core" | "composition";
1983
1998
  propCount: number;
1984
1999
  hasExamples: boolean;
1985
2000
  hasCompoundChildren: boolean;
@@ -2003,7 +2018,7 @@ declare const bundleManifestSchema: z.ZodObject<{
2003
2018
  slug: string;
2004
2019
  };
2005
2020
  sourceBinding: {
2006
- resolution: "auto" | "explicit";
2021
+ resolution: "explicit" | "auto";
2007
2022
  bindingId: string;
2008
2023
  projectId: string;
2009
2024
  projectName: string;
@@ -2183,7 +2198,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2183
2198
  }[];
2184
2199
  source: "design-system";
2185
2200
  publicSlug: string | null;
2186
- tier: "composition" | "core";
2201
+ tier: "core" | "composition";
2187
2202
  relations: Record<string, unknown>[];
2188
2203
  publicId: string | null;
2189
2204
  usageGuidance: string;
@@ -2209,7 +2224,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2209
2224
  }[];
2210
2225
  source: "design-system";
2211
2226
  publicSlug: string | null;
2212
- tier: "composition" | "core";
2227
+ tier: "core" | "composition";
2213
2228
  relations: Record<string, unknown>[];
2214
2229
  publicId: string | null;
2215
2230
  usageGuidance: string;
@@ -2240,7 +2255,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2240
2255
  }[];
2241
2256
  source: "design-system";
2242
2257
  publicSlug: string | null;
2243
- tier: "composition" | "core";
2258
+ tier: "core" | "composition";
2244
2259
  relations: Record<string, unknown>[];
2245
2260
  publicId: string | null;
2246
2261
  usageGuidance: string;
@@ -2273,7 +2288,7 @@ declare const bundleComponentShardSchema: z.ZodObject<{
2273
2288
  }[];
2274
2289
  source: "design-system";
2275
2290
  publicSlug: string | null;
2276
- tier: "composition" | "core";
2291
+ tier: "core" | "composition";
2277
2292
  relations: Record<string, unknown>[];
2278
2293
  publicId: string | null;
2279
2294
  usageGuidance: string;
@@ -6711,32 +6726,6 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6711
6726
  }>>;
6712
6727
  recognizedClassHelpers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
6713
6728
  }, "strip", z.ZodTypeAny, {
6714
- components?: string[] | undefined;
6715
- screenshots?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
6716
- tokens?: z.objectOutputType<{
6717
- include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
6718
- sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
6719
- path: z.ZodEffects<z.ZodString, string, string>;
6720
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
6721
- }, "strip", z.ZodTypeAny, {
6722
- path: string;
6723
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
6724
- }, {
6725
- path: string;
6726
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
6727
- }>, "many">>;
6728
- exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
6729
- themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6730
- enabled: z.ZodOptional<z.ZodBoolean>;
6731
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
6732
- namespace: z.ZodOptional<z.ZodString>;
6733
- }, z.ZodTypeAny, "passthrough"> | undefined;
6734
- performance?: "strict" | "relaxed" | "standard" | {
6735
- preset?: "strict" | "relaxed" | "standard" | undefined;
6736
- budgets?: {
6737
- bundleSize?: number | undefined;
6738
- } | undefined;
6739
- } | undefined;
6740
6729
  govern?: {
6741
6730
  components?: Record<string, {
6742
6731
  rules: ({
@@ -6912,6 +6901,32 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6912
6901
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
6913
6902
  }, z.ZodTypeAny, "passthrough"> | undefined;
6914
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;
6915
6930
  include?: string[] | undefined;
6916
6931
  exclude?: string[] | undefined;
6917
6932
  registry?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
@@ -6969,32 +6984,6 @@ declare const fragmentsConfigSchema: z.ZodObject<{
6969
6984
  } | undefined;
6970
6985
  recognizedClassHelpers?: string[] | undefined;
6971
6986
  }, {
6972
- components?: string[] | undefined;
6973
- screenshots?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
6974
- tokens?: z.objectInputType<{
6975
- include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
6976
- sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
6977
- path: z.ZodEffects<z.ZodString, string, string>;
6978
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
6979
- }, "strip", z.ZodTypeAny, {
6980
- path: string;
6981
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
6982
- }, {
6983
- path: string;
6984
- format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
6985
- }>, "many">>;
6986
- exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
6987
- themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6988
- enabled: z.ZodOptional<z.ZodBoolean>;
6989
- format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
6990
- namespace: z.ZodOptional<z.ZodString>;
6991
- }, z.ZodTypeAny, "passthrough"> | undefined;
6992
- performance?: "strict" | "relaxed" | "standard" | {
6993
- preset?: "strict" | "relaxed" | "standard" | undefined;
6994
- budgets?: {
6995
- bundleSize?: number | undefined;
6996
- } | undefined;
6997
- } | undefined;
6998
6987
  govern?: {
6999
6988
  components?: Record<string, {
7000
6989
  rules: ({
@@ -7170,6 +7159,32 @@ declare const fragmentsConfigSchema: z.ZodObject<{
7170
7159
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
7171
7160
  }, z.ZodTypeAny, "passthrough"> | undefined;
7172
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;
7173
7188
  include?: string[] | undefined;
7174
7189
  exclude?: string[] | undefined;
7175
7190
  registry?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
@@ -8654,6 +8669,7 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
8654
8669
  guidelines?: string[] | undefined;
8655
8670
  accessibility?: string[] | undefined;
8656
8671
  };
8672
+ govern?: ((...args: unknown[]) => unknown) | undefined;
8657
8673
  composition?: {
8658
8674
  pattern?: "compound" | "simple" | "controlled" | "wrapper" | undefined;
8659
8675
  subComponents?: string[] | undefined;
@@ -8669,7 +8685,6 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
8669
8685
  constraints?: string[] | undefined;
8670
8686
  typeDetails?: Record<string, unknown> | undefined;
8671
8687
  }> | undefined;
8672
- govern?: ((...args: unknown[]) => unknown) | undefined;
8673
8688
  contract?: {
8674
8689
  composition?: {
8675
8690
  rule: {
@@ -8800,6 +8815,7 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
8800
8815
  guidelines?: string[] | undefined;
8801
8816
  accessibility?: string[] | undefined;
8802
8817
  };
8818
+ govern?: ((...args: unknown[]) => unknown) | undefined;
8803
8819
  composition?: {
8804
8820
  pattern?: "compound" | "simple" | "controlled" | "wrapper" | undefined;
8805
8821
  subComponents?: string[] | undefined;
@@ -8815,7 +8831,6 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
8815
8831
  constraints?: string[] | undefined;
8816
8832
  typeDetails?: Record<string, unknown> | undefined;
8817
8833
  }> | undefined;
8818
- govern?: ((...args: unknown[]) => unknown) | undefined;
8819
8834
  contract?: {
8820
8835
  composition?: {
8821
8836
  rule: {
@@ -10199,6 +10214,13 @@ declare const componentContractSchema: z.ZodObject<{
10199
10214
  }>>;
10200
10215
  }, "strip", z.ZodTypeAny, {
10201
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
+ };
10202
10224
  props: Record<string, {
10203
10225
  type: string;
10204
10226
  description: string;
@@ -10211,13 +10233,6 @@ declare const componentContractSchema: z.ZodObject<{
10211
10233
  name: string;
10212
10234
  sourcePath: string;
10213
10235
  exportName: string;
10214
- provenance: {
10215
- source: "manual" | "extracted" | "merged" | "migrated";
10216
- verified: boolean;
10217
- frameworkSupport?: "native" | "manual-only" | undefined;
10218
- sourceHash?: string | undefined;
10219
- extractedAt?: string | undefined;
10220
- };
10221
10236
  propsSummary: string[];
10222
10237
  usage: {
10223
10238
  when: string[];
@@ -10226,8 +10241,6 @@ declare const componentContractSchema: z.ZodObject<{
10226
10241
  accessibility?: string[] | undefined;
10227
10242
  };
10228
10243
  $schema: string;
10229
- status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10230
- tokens?: string[] | undefined;
10231
10244
  preview?: {
10232
10245
  css?: string[] | undefined;
10233
10246
  theme?: "light" | "dark" | undefined;
@@ -10235,6 +10248,8 @@ declare const componentContractSchema: z.ZodObject<{
10235
10248
  wrapperModule?: string | undefined;
10236
10249
  wrapperExport?: string | undefined;
10237
10250
  } | undefined;
10251
+ status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10252
+ tokens?: string[] | undefined;
10238
10253
  contract?: {
10239
10254
  compoundChildren?: Record<string, {
10240
10255
  description?: string | undefined;
@@ -10280,6 +10295,13 @@ declare const componentContractSchema: z.ZodObject<{
10280
10295
  } | undefined;
10281
10296
  }, {
10282
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
+ };
10283
10305
  props: Record<string, {
10284
10306
  type: string;
10285
10307
  description: string;
@@ -10292,13 +10314,6 @@ declare const componentContractSchema: z.ZodObject<{
10292
10314
  name: string;
10293
10315
  sourcePath: string;
10294
10316
  exportName: string;
10295
- provenance: {
10296
- source: "manual" | "extracted" | "merged" | "migrated";
10297
- verified: boolean;
10298
- frameworkSupport?: "native" | "manual-only" | undefined;
10299
- sourceHash?: string | undefined;
10300
- extractedAt?: string | undefined;
10301
- };
10302
10317
  propsSummary: string[];
10303
10318
  usage: {
10304
10319
  when: string[];
@@ -10307,8 +10322,6 @@ declare const componentContractSchema: z.ZodObject<{
10307
10322
  accessibility?: string[] | undefined;
10308
10323
  };
10309
10324
  $schema: string;
10310
- status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10311
- tokens?: string[] | undefined;
10312
10325
  preview?: {
10313
10326
  css?: string[] | undefined;
10314
10327
  theme?: "light" | "dark" | undefined;
@@ -10316,6 +10329,8 @@ declare const componentContractSchema: z.ZodObject<{
10316
10329
  wrapperModule?: string | undefined;
10317
10330
  wrapperExport?: string | undefined;
10318
10331
  } | undefined;
10332
+ status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
10333
+ tokens?: string[] | undefined;
10319
10334
  contract?: {
10320
10335
  compoundChildren?: Record<string, {
10321
10336
  description?: string | undefined;
@@ -10536,6 +10551,7 @@ interface MakeFindingInput {
10536
10551
  message: string;
10537
10552
  location: FactLocation;
10538
10553
  evidence: FactEvidence[];
10554
+ evidenceGrade?: EvidenceGrade;
10539
10555
  fingerprintIdentity: Record<string, unknown>;
10540
10556
  fix?: FindingFix;
10541
10557
  attributes?: Record<string, unknown>;
@@ -10552,12 +10568,12 @@ declare function makeFinding(input: MakeFindingInput): Finding;
10552
10568
  */
10553
10569
  declare const BLOCKING_RULE_ALLOWLIST: ReadonlySet<string>;
10554
10570
  /**
10555
- * Mirrors `scanWithFacts`'s own CI exit logic: a finding gates CI when it is
10556
- * error-severity, or warn-severity under `ci.failOnWarnings`. Gating on exactly
10557
- * 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.
10558
10574
  */
10559
10575
  declare function gatesCi(finding: Finding, failOnWarnings: boolean): boolean;
10560
- /** A finding may deny iff it is allowlisted, gates CI, and is not a flagged-heuristic fix. */
10576
+ /** A finding may deny iff it is allowlisted, gates CI, and is not heuristic. */
10561
10577
  declare function isDenyEligible(finding: Finding, failOnWarnings: boolean): boolean;
10562
10578
 
10563
10579
  /**
@@ -11385,4 +11401,4 @@ declare function isEnforceableHtmlEquivalent(args: {
11385
11401
  explicit?: boolean;
11386
11402
  }): boolean;
11387
11403
 
11388
- 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 };