@usefragments/core 1.4.0 → 1.5.0

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { F as Finding, A as AgentFormat, E as EvidenceGrade, a as FindingFix } from './index-0lmh0Lbo.js';
-export { b as AGENT_FORMAT_SCHEMA_VERSION, c as AgentErrorEnvelope, d as AgentOutput, G as CanonicalGovernanceVerdict, e as EVIDENCE_ORDER, f as FindingReplaceClassTokenFix, g as FindingReplaceComponentFix, h as FindingReplaceImportFix, i as FindingReplacePropValueFix, j as FindingReplaceStyleValueFix, k as Fix, l as GovernanceVerdictMetadata, I as InspectClaim, m as InspectClaimTier, S as SuppressionDirective, V as ValidatorResult, n as Violation, o as agentErrorEnvelopeSchema, p as agentFormatSchema, q as agentIntegritySchema, r as agentOutputSchema, s as canBlock, t as factEvidenceSchema, u as factLocationSchema, v as findingFixSchema, w as findingReplaceClassTokenFixSchema, x as findingReplaceComponentFixSchema, y as findingReplaceImportFixSchema, z as findingReplacePropValueFixSchema, B as findingReplaceStyleValueFixSchema, C as findingSchema, D as fixSchema, H as governanceVerdictMetadataSchema, J as governanceVerdictSchema, K as normalizeFinding, L as normalizeSeverity, M as normalizeViolation, N as suppressionDirectiveSchema, O as validatorResultSchema, P as violationSchema } from './index-0lmh0Lbo.js';
+import { F as Finding, A as AgentFormat, E as EvidenceGrade, a as FindingFix } from './index-h_yWj15D.js';
+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';
 import { Severity } from './severity.js';
 export { SEVERITIES, SEVERITY_RANK, SEVERITY_WEIGHTS, SeverityLevel, compareSeverity, maxSeverity, severityLevel, severitySchema, sortBySeverity } from './severity.js';
 export { BridgeViolationInput, CODES, CodeCategory, CodeLifecycle, EXPLAIN_URL_BASE, FuiCode, bridgeSourceViolation, bridgeSourceViolations, byCode, byRuleId, explainUrlForCode } from './codes/index.js';
-import { c as ContractDomain, d as ContractCatalogInput, G as GovernanceSeverity, b as CompiledFragment, e as GovernedFragmentDefinition, R as ResolvedGovernedFragmentDefinition, f as GovernanceConfig, g as FragmentsConfig, T as TokenConfig, h as FragmentComponent, B as BlockDefinition, C as CompiledBlock, F as FragmentDefinition, a as FragmentDefinitionV2, S as StorybookFilterConfig, i as FigmaStringMapping, j as FigmaBooleanMapping, k as FigmaEnumMapping, l as FigmaInstanceMapping, m as FigmaChildrenMapping, n as FigmaTextContentMapping, o as RelationshipType, V as VariantRenderOptions, p as VariantLoader, q as CanonicalSource } from './governance-DxdJV6lx.js';
-export { A as AIMetadata, r as AccessibilityGovernanceBuilder, s as AppConfig, t as BaselineInfo, u as BoundingBox, v as CONTRACT_DOMAINS, w as CONTRACT_PREIMAGE_CAPABILITY_HEADER, x as CONTRACT_PREIMAGE_SCHEMA, y as CanonicalMappingStatus, z as CompiledFragmentsFile, D as CompiledRecipe, E as CompiledTokenData, H as CompiledTokenEntry, I as ComponentGovernanceBuilder, J as ComponentGovernanceRecord, K as ComponentRef, L as ComponentRelation, M as CompositionMetadata, N as ContractCanonicalMappingInput, O as ContractComponentInput, P as ContractIdentityPin, Q as ContractPolicyInput, U as ContractPreimage, W as ContractPropMappingInput, X as ContractTokenInput, Y as ContractWaiverInput, Z as ControlType, _ as DesignSystemConfig, $ as DiffResult, a0 as FigmaPropMapping, a1 as FragmentContract, a2 as FragmentExample, a3 as FragmentGenerated, a4 as FragmentGuidance, a5 as FragmentMeta, a6 as FragmentProvenance, a7 as FragmentUsage, a8 as FragmentVariant, a9 as GlobalGovernanceRecord, aa as GlobalJsxGovernanceRecord, ab as GlobalStyleGovernanceRecord, ac as GovernancePropValue, ad as InspectConfig, ae as LocalCanonicalDeclaration, af as LocalCanonicalResolveRule, ag as Manifest, ah as ObservedComponentUsage, ai as ObservedUsageProp, aj as PlayFunction, ak as PlayFunctionContext, al as PropDefinition, am as PropGovernanceBuilder, an as PropGovernanceOptions, ao as PropKey, ap as PropType, aq as RecipeDefinition, ar as RegistryOptions, as as RepoRelativePath, at as ScaleGovernanceRecord, au as Screenshot, av as ScreenshotConfig, aw as ScreenshotMetadata, ax as ServiceConfig, ay as SnapshotConfig, az as SnippetPolicyConfig, aA as Theme, aB as ThemeSeeds, aC as TokenSourceConfig, aD as TokenSourceFormat, aE as VerifyRequest, aF as VerifyResult, aG as Viewport, aH as componentGovernanceRecordSchema, aI as componentGovernanceRecordsSchema, aJ as contractComponentsFromFragments, aK as contractPolicyFromGovernanceConfig, aL as diffContractDomains, aM as g, aN as globalGovernanceRecordSchema, aO as globalJsxGovernanceRecordSchema, aP as globalStyleGovernanceRecordSchema, aQ as governanceConfigSchema, aR as governanceConfigWithLocalCanonical, aS as governanceSeveritySchema, aT as localCanonicalContractMappings, aU as normalizeGovernanceConfig, aV as projectContractPreimage, aW as scaleGovernanceRecordSchema, aX as verifiedContractPreimageFromPin } from './governance-DxdJV6lx.js';
+import { c as ContractDomain, d as ContractCatalogInput, G as GovernanceSeverity, b as CompiledFragment, e as GovernedFragmentDefinition, R as ResolvedGovernedFragmentDefinition, f as GovernanceConfig, g as FragmentsConfig, T as TokenConfig, h as FragmentComponent, B as BlockDefinition, C as CompiledBlock, F as FragmentDefinition, a as FragmentDefinitionV2, S as StorybookFilterConfig, i as FigmaStringMapping, j as FigmaBooleanMapping, k as FigmaEnumMapping, l as FigmaInstanceMapping, m as FigmaChildrenMapping, n as FigmaTextContentMapping, o as RelationshipType, V as VariantRenderOptions, p as VariantLoader, q as CanonicalSource } from './governance-BLsyk56o.js';
+export { A as AIMetadata, r as AccessibilityGovernanceBuilder, s as AppConfig, t as BaselineInfo, u as BoundingBox, v as CONTRACT_DOMAINS, w as CONTRACT_PREIMAGE_CAPABILITY_HEADER, x as CONTRACT_PREIMAGE_SCHEMA, y as CanonicalMappingStatus, z as CompiledFragmentsFile, D as CompiledRecipe, E as CompiledTokenData, H as CompiledTokenEntry, I as ComponentGovernanceBuilder, J as ComponentGovernanceRecord, K as ComponentRef, L as ComponentRelation, M as CompositionMetadata, N as ContractCanonicalMappingInput, O as ContractComponentInput, P as ContractIdentityPin, Q as ContractPolicyInput, U as ContractPreimage, W as ContractPropMappingInput, X as ContractTokenInput, Y as ContractWaiverInput, Z as ControlType, _ as DesignSystemConfig, $ as DiffResult, a0 as FigmaPropMapping, a1 as FragmentContract, a2 as FragmentExample, a3 as FragmentGenerated, a4 as FragmentGuidance, a5 as FragmentMeta, a6 as FragmentProvenance, a7 as FragmentUsage, a8 as FragmentVariant, a9 as GlobalGovernanceRecord, aa as GlobalJsxGovernanceRecord, ab as GlobalStyleGovernanceRecord, ac as GovernancePropValue, ad as InspectConfig, ae as LocalCanonicalDeclaration, af as LocalCanonicalResolveRule, ag as Manifest, ah as ObservedComponentUsage, ai as ObservedUsageProp, aj as PlayFunction, ak as PlayFunctionContext, al as PropDefinition, am as PropGovernanceBuilder, an as PropGovernanceOptions, ao as PropKey, ap as PropType, aq as RecipeDefinition, ar as RegistryOptions, as as RepoRelativePath, at as ScaleGovernanceRecord, au as Screenshot, av as ScreenshotConfig, aw as ScreenshotMetadata, ax as ServiceConfig, ay as SnapshotConfig, az as SnippetPolicyConfig, aA as Theme, aB as ThemeSeeds, aC as TokenSourceConfig, aD as TokenSourceFormat, aE as VerifyRequest, aF as VerifyResult, aG as Viewport, aH as componentGovernanceRecordSchema, aI as componentGovernanceRecordsSchema, aJ as contractComponentsFromFragments, aK as contractPolicyFromGovernanceConfig, aL as diffContractDomains, aM as g, aN as globalGovernanceRecordSchema, aO as globalJsxGovernanceRecordSchema, aP as globalStyleGovernanceRecordSchema, aQ as governanceConfigSchema, aR as governanceConfigWithLocalCanonical, aS as governanceSeveritySchema, aT as localCanonicalContractMappings, aU as normalizeGovernanceConfig, aV as projectContractPreimage, aW as scaleGovernanceRecordSchema, aX as verifiedContractPreimageFromPin } from './governance-BLsyk56o.js';
 import { z } from 'zod';
 import { RegistryArtifact, RegistryDependency, RegistryInstallReceipt } from './registry.js';
 export { REGISTRY_ARTIFACT_SCHEMA_VERSION, REGISTRY_INSTALL_RECEIPT_SCHEMA_VERSION, REGISTRY_MANIFEST_SCHEMA_VERSION, RegistryArtifactInput, RegistryComponent, RegistryComponentExport, RegistryDependencyType, RegistryEntrypoint, RegistryFile, RegistryFileContent, RegistryFileInput, RegistryFileRole, RegistryInstallProfile, RegistryInstallReceiptComponent, RegistryInstallReceiptFile, RegistryManifest, RegistryManifestDraft, RegistrySource, assertValidRegistryArtifact, buildRegistryArtifact, buildRegistryFile, computeRegistryHash, finalizeRegistryManifest, hashRegistryFileContent, registryArtifactDigest, registryArtifactSchema, registryComponentExportSchema, registryComponentSchema, registryDependencySchema, registryDependencyTypeSchema, registryEntrypointSchema, registryFileContentSchema, registryFileRoleSchema, registryFileSchema, registryFileSize, registryInstallProfileSchema, registryInstallReceiptComponentSchema, registryInstallReceiptFileSchema, registryInstallReceiptSchema, registryManifestCanonicalPreimage, registryManifestDraftSchema, registryManifestSchema, registrySourceSchema } from './registry.js';
@@ -120,6 +120,11 @@ interface ConformInput {
     filename?: string;
     /** deterministic (default) applies safe edits; none returns findings only. */
     apply?: "deterministic" | "none";
+    /** Explicit request to consolidate a known shadow into its canonical root. */
+    shadowConsolidation?: {
+        shadow: string;
+        canonicalTarget?: string;
+    };
 }
 interface ConformLocation {
     line?: number;
@@ -568,6 +573,145 @@ declare const catalogFixtureATokensDtcg: {
     };
 };
 
+type RawHtmlPrecisionTier = "exact-html" | "html-advisory" | "input-type" | "role-reimpl" | "interactive-nonsemantic" | "icon-only";
+interface RawHtmlCanonicalMatch {
+    canonical: string;
+    tier: RawHtmlPrecisionTier;
+}
+declare const RAW_HTML_CANONICAL_TAGS: readonly {
+    tagName: string;
+    canonical: string;
+    tier: "exact-html";
+}[];
+declare const RAW_HTML_ADVISORY_TAGS: readonly {
+    tagName: string;
+    canonical: string;
+    tier: "html-advisory";
+}[];
+declare const RAW_HTML_INPUT_TYPE_CANONICALS: readonly {
+    type: string;
+    canonical: string;
+    tier: "input-type";
+}[];
+declare const RAW_HTML_ROLE_CANONICALS: readonly {
+    role: string;
+    canonical: string;
+    tier: "role-reimpl";
+}[];
+declare function resolveCanonicalForRawHtml(tagName: string, inputType?: string): RawHtmlCanonicalMatch | null;
+declare function resolveCanonicalForAriaRole(role: string): RawHtmlCanonicalMatch | null;
+declare function isRawHtmlAdvisoryTier(tier: RawHtmlPrecisionTier): boolean;
+/**
+ * Decide whether a per-component `htmlEquivalent` mapping (raw `tag` → a
+ * `canonical` component) may drive a bare-tag canonical-usage finding.
+ *
+ * The contract:
+ * - Low-frequency SEMANTIC tags (dialog, select, textarea, input, …) are always
+ *   enforceable, so a custom-named component (`<dialog>` → Modal) still maps.
+ * - Common/ambiguous tags (button, a, …) enforce ONLY when the mapping AGREES
+ *   with the framework's curated canonical for that tag — so `<button>` → Button
+ *   fires, but `<button>` → Chip does not.
+ * - Generic structural containers (div, span) have no curated answer and are not
+ *   semantic → never enforce.
+ *
+ * This is the guard that stops the canonical-usage flood: a library component
+ * being built on a `<div>` must not make every `<div>` a bespoke re-implementation
+ * of it (every `<div>` → Accordion, every `<span>` → Badge, every `<button>` → Chip).
+ */
+declare function isEnforceableHtmlEquivalent(args: {
+    tag: string;
+    canonical: string;
+    inputType?: string;
+    /**
+     * The mapping is an EXPLICIT project declaration of this tag → component
+     * (provenance: `localCanonical.resolves`), not a low-confidence inferred
+     * `htmlEquivalent`. Explicit declarations enforce a specific interactive tag
+     * (`button`/`a`) against any canonical NAME — the agnosticism path — while
+     * inferred mappings stay name-gated to the curated canonical (the flood
+     * guard). Generic containers (`div`/`span`) are never enforceable even when
+     * explicit.
+     */
+    explicit?: boolean;
+}): boolean;
+
+type IdentityState = "canonical" | "variant" | "shadow" | "composite" | "external" | "unresolved";
+type IdentityConfidence = "confirmed" | "likely" | "review";
+interface CanonicalIdentityReference {
+    componentKey: string;
+    role: string;
+}
+interface LocalIdentityReference {
+    componentKey: string;
+    exportName: string;
+}
+interface ExternalIdentityReference {
+    localName: string;
+    source: string;
+}
+interface ResolvedIntrinsicIdentityRoot {
+    kind: "intrinsic";
+    tag: string;
+    hasRole: boolean;
+    interactive: boolean;
+    role?: string;
+    inputType?: string;
+    precisionTier?: RawHtmlPrecisionTier;
+    canonicalTargets: readonly CanonicalIdentityReference[];
+}
+type ResolvedIdentityRenderRoot = {
+    kind: "canonical";
+    localName: string;
+    target: CanonicalIdentityReference;
+} | ResolvedIntrinsicIdentityRoot | {
+    kind: "external";
+    localName: string;
+    source: string;
+} | {
+    kind: "mixed";
+    canonicalTargets: readonly CanonicalIdentityReference[];
+    localTargets: readonly LocalIdentityReference[];
+    externalTargets: readonly ExternalIdentityReference[];
+    intrinsics: readonly ResolvedIntrinsicIdentityRoot[];
+    unresolvedNames: readonly string[];
+} | {
+    kind: "unresolved";
+    reason: string;
+};
+interface IdentityDecision {
+    componentKey: string;
+    decision: "sanctioned-wrapper" | "rejected-wrapper";
+    canonicalTarget?: string;
+    decisionId?: string;
+}
+interface ClassifyIdentityInput {
+    definition: {
+        componentKey: string;
+        exportName: string;
+        canonical: boolean;
+    };
+    renderRoot: ResolvedIdentityRenderRoot;
+    propSurfaceOverlap?: number;
+    stylingOwnership?: "visual-role" | "layout-only" | "none" | "unknown";
+    usageCounts?: {
+        importers?: number;
+        callSites?: number;
+        nestedElements?: number;
+        staticTextChildren?: number;
+    };
+    decisions?: readonly IdentityDecision[];
+    nameSimilarityTargets?: readonly string[];
+}
+interface IdentityClassification {
+    state: IdentityState;
+    confidence: IdentityConfidence;
+    canonicalTarget?: string;
+}
+/**
+ * Classify already-resolved identity evidence. AST and filesystem concerns stay
+ * in the extractor; this function is deterministic and browser-safe.
+ */
+declare function classifyIdentity(input: ClassifyIdentityInput): IdentityClassification;
+
 /**
  * Fact IR — discriminated union of governance facts.
  *
@@ -1023,10 +1167,56 @@ interface CanonicalReplacementFact extends BaseFact {
     confidence: number;
     location?: FactLocation;
 }
+type ComponentDefinitionRenderRoot = {
+    resolution: "canonical";
+    canonical: string;
+    importSource: string;
+} | {
+    resolution: "intrinsic";
+    tag: string;
+    role?: string;
+    interactive?: boolean;
+} | {
+    resolution: "mixed";
+    canonicals: string[];
+    intrinsics: string[];
+} | {
+    resolution: "external";
+    importSource: string;
+} | {
+    resolution: "unresolved";
+    reason: string;
+};
+interface ComponentDefinitionFact extends BaseFact {
+    kind: "component_definition";
+    /** Index-compatible projection of `componentKey`. */
+    componentId: ComponentId;
+    file: string;
+    exportName: string;
+    componentKey: string;
+    renderRoot: ComponentDefinitionRenderRoot;
+    propSurface: string[];
+    stylingChannel?: {
+        module: string;
+        ownsVisualRole: boolean;
+    };
+}
+interface ComponentIdentityFact extends BaseFact {
+    kind: "component_identity";
+    /** Index-compatible projection of `componentKey`. */
+    componentId: ComponentId;
+    componentKey: string;
+    state: IdentityState;
+    confidence: IdentityConfidence;
+    canonicalTarget?: string;
+    decisionId?: string;
+    evidence: FactId[];
+}
 type ComponentLevelFact = ComponentMetadataFact | ComponentCapabilityFact | PropMetadataFact;
 type PolicyFact = PropValueAvoidedFact | PropValueForbiddenFact | A11yNameRequiredFact | ScaleFact | ScaleValueFact | StyleRawColorForbiddenFact | StyleRawDimensionForbiddenFact | StylePropertyScaleFact | StyleFontSizeScaleFact | StyleCssVarsMustBeDefinedFact | ContractTokenFact | JsxUnknownPropsForbiddenFact | JsxInlineStyleForbiddenRawFact | JsxImportPathPreferredFact | JsxComponentPreferredFact | TokenDefinitionFact | TailwindPaletteAllowFact | TailwindPaletteDenyFact | TailwindUnknownClassEnabledFact | GovernanceRuleConfigFact;
 type UsageFact = UsageNodeFact | UsageComponentFact | UsageImportFact | UsagePropResolvedFact | UsageInlineStyleFact | UsageTextChildFact | StyleDeclarationFact | StyleUnsupportedFact | ClassNameLiteralFact | ClassNameDynamicFact | TailwindClassFact | ThemeDeclarationFact | SuppressionDirectiveFact | TailwindTokenResolvedFact | CanonicalCandidateFact | CanonicalMappingFact | StructuralConfidenceFact | CanonicalReplacementFact;
-type Fact = ComponentLevelFact | PolicyFact | UsageFact;
+type IdentityFact = ComponentDefinitionFact | ComponentIdentityFact;
+type Fact = ComponentLevelFact | PolicyFact | UsageFact | IdentityFact;
 type FactKind = Fact["kind"];
 /** Narrows a Fact union by kind. */
 type FactOfKind<K extends FactKind> = Extract<Fact, {
@@ -1076,6 +1266,22 @@ declare function makeComponentCapabilityFact(input: {
     componentId: ComponentId;
     capability: string;
 }): ComponentCapabilityFact;
+declare function makeComponentDefinitionFact(input: {
+    file: string;
+    exportName: string;
+    componentKey: string;
+    renderRoot: ComponentDefinitionFact["renderRoot"];
+    propSurface: string[];
+    stylingChannel?: ComponentDefinitionFact["stylingChannel"];
+}): ComponentDefinitionFact;
+declare function makeComponentIdentityFact(input: {
+    componentKey: string;
+    state: ComponentIdentityFact["state"];
+    confidence: ComponentIdentityFact["confidence"];
+    canonicalTarget?: string;
+    decisionId?: string;
+    evidence: FactId[];
+}): ComponentIdentityFact;
 declare function makeCanonicalCandidateFact(input: {
     componentId: ComponentId;
     canonical: string;
@@ -1788,8 +1994,8 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
         componentId: string;
         name: string;
     }[];
+    tier: "core" | "composition";
     publicSlug: string | null;
-    tier: "composition" | "core";
     propCount: number;
     hasExamples: boolean;
     hasCompoundChildren: boolean;
@@ -1809,8 +2015,8 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
         componentId: string;
         name: string;
     }[];
+    tier: "core" | "composition";
     publicSlug: string | null;
-    tier: "composition" | "core";
     propCount: number;
     hasExamples: boolean;
     hasCompoundChildren: boolean;
@@ -1918,8 +2124,8 @@ declare const bundleManifestSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
+        tier: "core" | "composition";
         publicSlug: string | null;
-        tier: "composition" | "core";
         propCount: number;
         hasExamples: boolean;
         hasCompoundChildren: boolean;
@@ -1939,8 +2145,8 @@ declare const bundleManifestSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
+        tier: "core" | "composition";
         publicSlug: string | null;
-        tier: "composition" | "core";
         propCount: number;
         hasExamples: boolean;
         hasCompoundChildren: boolean;
@@ -1962,8 +2168,8 @@ declare const bundleManifestSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
+        tier: "core" | "composition";
         publicSlug: string | null;
-        tier: "composition" | "core";
         propCount: number;
         hasExamples: boolean;
         hasCompoundChildren: boolean;
@@ -2008,8 +2214,8 @@ declare const bundleManifestSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
+        tier: "core" | "composition";
         publicSlug: string | null;
-        tier: "composition" | "core";
         propCount: number;
         hasExamples: boolean;
         hasCompoundChildren: boolean;
@@ -2211,9 +2417,9 @@ declare const bundleComponentShardSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
+        tier: "core" | "composition";
         source: "design-system";
         publicSlug: string | null;
-        tier: "composition" | "core";
         relations: Record<string, unknown>[];
         publicId: string | null;
         usageGuidance: string;
@@ -2237,9 +2443,9 @@ declare const bundleComponentShardSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
+        tier: "core" | "composition";
         source: "design-system";
         publicSlug: string | null;
-        tier: "composition" | "core";
         relations: Record<string, unknown>[];
         publicId: string | null;
         usageGuidance: string;
@@ -2268,9 +2474,9 @@ declare const bundleComponentShardSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
+        tier: "core" | "composition";
         source: "design-system";
         publicSlug: string | null;
-        tier: "composition" | "core";
         relations: Record<string, unknown>[];
         publicId: string | null;
         usageGuidance: string;
@@ -2301,9 +2507,9 @@ declare const bundleComponentShardSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
+        tier: "core" | "composition";
         source: "design-system";
         publicSlug: string | null;
-        tier: "composition" | "core";
         relations: Record<string, unknown>[];
         publicId: string | null;
         usageGuidance: string;
@@ -2850,8 +3056,8 @@ declare const mcpComponentSchema: z.ZodObject<{
     importPath?: string | undefined;
     publicRef?: string | undefined;
     sourcePath?: string | undefined;
-    publicSlug?: string | null | undefined;
     tier?: string | undefined;
+    publicSlug?: string | null | undefined;
     packageName?: string | undefined;
     isCanonical?: boolean | undefined;
     sourceRepoFullName?: string | undefined;
@@ -2900,8 +3106,8 @@ declare const mcpComponentSchema: z.ZodObject<{
         accepts?: string[] | undefined;
         visibility?: "public" | "internal" | undefined;
     }[] | undefined;
-    publicSlug?: string | null | undefined;
     tier?: string | undefined;
+    publicSlug?: string | null | undefined;
     relations?: {
         componentName: string;
         relationship: string;
@@ -3379,8 +3585,8 @@ declare const mcpSnapshotSchema: z.ZodObject<{
         importPath?: string | undefined;
         publicRef?: string | undefined;
         sourcePath?: string | undefined;
-        publicSlug?: string | null | undefined;
         tier?: string | undefined;
+        publicSlug?: string | null | undefined;
         packageName?: string | undefined;
         isCanonical?: boolean | undefined;
         sourceRepoFullName?: string | undefined;
@@ -3429,8 +3635,8 @@ declare const mcpSnapshotSchema: z.ZodObject<{
             accepts?: string[] | undefined;
             visibility?: "public" | "internal" | undefined;
         }[] | undefined;
-        publicSlug?: string | null | undefined;
         tier?: string | undefined;
+        publicSlug?: string | null | undefined;
         relations?: {
             componentName: string;
             relationship: string;
@@ -3670,8 +3876,8 @@ declare const mcpSnapshotSchema: z.ZodObject<{
         importPath?: string | undefined;
         publicRef?: string | undefined;
         sourcePath?: string | undefined;
-        publicSlug?: string | null | undefined;
         tier?: string | undefined;
+        publicSlug?: string | null | undefined;
         packageName?: string | undefined;
         isCanonical?: boolean | undefined;
         sourceRepoFullName?: string | undefined;
@@ -3772,8 +3978,8 @@ declare const mcpSnapshotSchema: z.ZodObject<{
             accepts?: string[] | undefined;
             visibility?: "public" | "internal" | undefined;
         }[] | undefined;
-        publicSlug?: string | null | undefined;
         tier?: string | undefined;
+        publicSlug?: string | null | undefined;
         relations?: {
             componentName: string;
             relationship: string;
@@ -6745,34 +6951,44 @@ declare const fragmentsConfigSchema: z.ZodObject<{
         }> | undefined;
     }>>;
     recognizedClassHelpers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    components?: string[] | undefined;
-    screenshots?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
-    tokens?: z.objectOutputType<{
-        include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
-        sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            path: z.ZodEffects<z.ZodString, string, string>;
-            format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
+    identity: z.ZodOptional<z.ZodObject<{
+        decisions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            component: z.ZodString;
+            kind: z.ZodEnum<["sanction", "reject", "dismiss"]>;
+            canonicalTarget: z.ZodOptional<z.ZodString>;
+            reason: z.ZodOptional<z.ZodString>;
+            decisionId: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            path: string;
-            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
+            kind: "sanction" | "reject" | "dismiss";
+            component: string;
+            reason?: string | undefined;
+            canonicalTarget?: string | undefined;
+            decisionId?: string | undefined;
         }, {
-            path: string;
-            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
+            kind: "sanction" | "reject" | "dismiss";
+            component: string;
+            reason?: string | undefined;
+            canonicalTarget?: string | undefined;
+            decisionId?: string | undefined;
         }>, "many">>;
-        packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
-        themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        enabled: z.ZodOptional<z.ZodBoolean>;
-        format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
-        namespace: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough"> | undefined;
-    performance?: "strict" | "relaxed" | "standard" | {
-        preset?: "strict" | "relaxed" | "standard" | undefined;
-        budgets?: {
-            bundleSize?: number | undefined;
-        } | undefined;
-    } | undefined;
+    }, "strip", z.ZodTypeAny, {
+        decisions?: {
+            kind: "sanction" | "reject" | "dismiss";
+            component: string;
+            reason?: string | undefined;
+            canonicalTarget?: string | undefined;
+            decisionId?: string | undefined;
+        }[] | undefined;
+    }, {
+        decisions?: {
+            kind: "sanction" | "reject" | "dismiss";
+            component: string;
+            reason?: string | undefined;
+            canonicalTarget?: string | undefined;
+            decisionId?: string | undefined;
+        }[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
     govern?: {
         components?: Record<string, {
             rules: ({
@@ -6948,6 +7164,33 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             failOnWarnings: z.ZodOptional<z.ZodBoolean>;
         }, z.ZodTypeAny, "passthrough"> | undefined;
     } | undefined;
+    components?: string[] | undefined;
+    screenshots?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    tokens?: z.objectOutputType<{
+        include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodEffects<z.ZodString, string, string>;
+            format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
+        }, {
+            path: string;
+            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
+        }>, "many">>;
+        packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
+        namespace: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+    performance?: "strict" | "relaxed" | "standard" | {
+        preset?: "strict" | "relaxed" | "standard" | undefined;
+        budgets?: {
+            bundleSize?: number | undefined;
+        } | undefined;
+    } | undefined;
     include?: string[] | undefined;
     exclude?: string[] | undefined;
     registry?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
@@ -7004,34 +7247,16 @@ declare const fragmentsConfigSchema: z.ZodObject<{
         }> | undefined;
     } | undefined;
     recognizedClassHelpers?: string[] | undefined;
-}, {
-    components?: string[] | undefined;
-    screenshots?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
-    tokens?: z.objectInputType<{
-        include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
-        sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            path: z.ZodEffects<z.ZodString, string, string>;
-            format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
-        }, "strip", z.ZodTypeAny, {
-            path: string;
-            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
-        }, {
-            path: string;
-            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
-        }>, "many">>;
-        packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
-        themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        enabled: z.ZodOptional<z.ZodBoolean>;
-        format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
-        namespace: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough"> | undefined;
-    performance?: "strict" | "relaxed" | "standard" | {
-        preset?: "strict" | "relaxed" | "standard" | undefined;
-        budgets?: {
-            bundleSize?: number | undefined;
-        } | undefined;
+    identity?: {
+        decisions?: {
+            kind: "sanction" | "reject" | "dismiss";
+            component: string;
+            reason?: string | undefined;
+            canonicalTarget?: string | undefined;
+            decisionId?: string | undefined;
+        }[] | undefined;
     } | undefined;
+}, {
     govern?: {
         components?: Record<string, {
             rules: ({
@@ -7207,6 +7432,33 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             failOnWarnings: z.ZodOptional<z.ZodBoolean>;
         }, z.ZodTypeAny, "passthrough"> | undefined;
     } | undefined;
+    components?: string[] | undefined;
+    screenshots?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
+    tokens?: z.objectInputType<{
+        include: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodEffects<z.ZodString, string, string>;
+            format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
+        }, {
+            path: string;
+            format?: "tailwind" | "auto" | "css" | "scss" | "dtcg" | undefined;
+        }>, "many">>;
+        packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+        themeSelectors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        format: z.ZodOptional<z.ZodEnum<["auto", "css", "scss", "dtcg", "tailwind"]>>;
+        namespace: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+    performance?: "strict" | "relaxed" | "standard" | {
+        preset?: "strict" | "relaxed" | "standard" | undefined;
+        budgets?: {
+            bundleSize?: number | undefined;
+        } | undefined;
+    } | undefined;
     include?: string[] | undefined;
     exclude?: string[] | undefined;
     registry?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
@@ -7263,6 +7515,15 @@ declare const fragmentsConfigSchema: z.ZodObject<{
         }> | undefined;
     } | undefined;
     recognizedClassHelpers?: string[] | undefined;
+    identity?: {
+        decisions?: {
+            kind: "sanction" | "reject" | "dismiss";
+            component: string;
+            reason?: string | undefined;
+            canonicalTarget?: string | undefined;
+            decisionId?: string | undefined;
+        }[] | undefined;
+    } | undefined;
 }>;
 /**
  * Schema for v2 composition metadata (promoted from ai)
@@ -8691,6 +8952,7 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
         guidelines?: string[] | undefined;
         accessibility?: string[] | undefined;
     };
+    govern?: ((...args: unknown[]) => unknown) | undefined;
     composition?: {
         pattern?: "compound" | "simple" | "controlled" | "wrapper" | undefined;
         subComponents?: string[] | undefined;
@@ -8706,7 +8968,6 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
         constraints?: string[] | undefined;
         typeDetails?: Record<string, unknown> | undefined;
     }> | undefined;
-    govern?: ((...args: unknown[]) => unknown) | undefined;
     contract?: {
         composition?: {
             rule: {
@@ -8837,6 +9098,7 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
         guidelines?: string[] | undefined;
         accessibility?: string[] | undefined;
     };
+    govern?: ((...args: unknown[]) => unknown) | undefined;
     composition?: {
         pattern?: "compound" | "simple" | "controlled" | "wrapper" | undefined;
         subComponents?: string[] | undefined;
@@ -8852,7 +9114,6 @@ declare const governedFragmentDefinitionSchema: z.ZodObject<{
         constraints?: string[] | undefined;
         typeDetails?: Record<string, unknown> | undefined;
     }> | undefined;
-    govern?: ((...args: unknown[]) => unknown) | undefined;
     contract?: {
         composition?: {
             rule: {
@@ -10263,8 +10524,6 @@ declare const componentContractSchema: z.ZodObject<{
         accessibility?: string[] | undefined;
     };
     $schema: string;
-    status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
-    tokens?: string[] | undefined;
     preview?: {
         css?: string[] | undefined;
         theme?: "light" | "dark" | undefined;
@@ -10272,6 +10531,8 @@ declare const componentContractSchema: z.ZodObject<{
         wrapperModule?: string | undefined;
         wrapperExport?: string | undefined;
     } | undefined;
+    status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
+    tokens?: string[] | undefined;
     contract?: {
         compoundChildren?: Record<string, {
             description?: string | undefined;
@@ -10344,8 +10605,6 @@ declare const componentContractSchema: z.ZodObject<{
         accessibility?: string[] | undefined;
     };
     $schema: string;
-    status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
-    tokens?: string[] | undefined;
     preview?: {
         css?: string[] | undefined;
         theme?: "light" | "dark" | undefined;
@@ -10353,6 +10612,8 @@ declare const componentContractSchema: z.ZodObject<{
         wrapperModule?: string | undefined;
         wrapperExport?: string | undefined;
     } | undefined;
+    status?: "experimental" | "stable" | "deprecated" | "beta" | undefined;
+    tokens?: string[] | undefined;
     contract?: {
         compoundChildren?: Record<string, {
             description?: string | undefined;
@@ -10626,6 +10887,8 @@ declare function ruleComponentsForbiddenPropValue(ix: FactIndex): Finding[];
 
 declare function ruleComponentsPreferLibrary(ix: FactIndex): Finding[];
 
+declare function ruleComponentsShadowComponent(ix: FactIndex): Finding[];
+
 /**
  * `props/invalid-value` — fires when a JSX prop is statically assigned a
  * value outside the component's declared enum values.
@@ -10817,8 +11080,8 @@ declare function ruleA11yRequiredAccessibleName(ix: FactIndex): Finding[];
  * cloud policy composer, and the UI rules editor. There is exactly one copy —
  * importers derive their defaults from it rather than re-listing rules (DRY).
  *
- * Identifiers are stable: this introduces no new rule ids, it only attaches a
- * tier label to existing ones.
+ * Identifiers are stable: every newly registered rule must be classified here
+ * in the same change.
  */
 type RuleTier = "contract" | "hygiene";
 /**
@@ -11248,6 +11511,15 @@ declare const RULES: readonly Rule[];
  */
 declare function runRules(ix: FactIndex): Finding[];
 
+interface ComponentIdentityUsage {
+    usageCount: number;
+    /** Number of distinct source files containing a usage. */
+    blastRadius: number;
+    nodes: UsageNodeFact[];
+}
+/** Join resolved component usages to their usage nodes once for rules and DX surfaces. */
+declare function indexComponentIdentityUsage(ix: FactIndex): ReadonlyMap<string, ComponentIdentityUsage>;
+
 /**
  * Rule helpers — small internal queries shared by Phase 5 rules.
  *
@@ -11362,65 +11634,13 @@ declare function isEffectiveCanonicalSource(source: CanonicalSource): boolean;
 declare function hasEffectiveComponentVocabulary(options: Record<string, unknown> | undefined): boolean;
 declare function evaluateGovernanceIntegrity(input: GovernanceIntegrityInput): GovernanceIntegrityVerdict;
 
-type RawHtmlPrecisionTier = "exact-html" | "html-advisory" | "input-type" | "role-reimpl" | "interactive-nonsemantic" | "icon-only";
-interface RawHtmlCanonicalMatch {
-    canonical: string;
-    tier: RawHtmlPrecisionTier;
+interface ComponentKeyInput {
+    repoRelativeFile: string;
+    exportName: string;
 }
-declare const RAW_HTML_CANONICAL_TAGS: readonly {
-    tagName: string;
-    canonical: string;
-    tier: "exact-html";
-}[];
-declare const RAW_HTML_ADVISORY_TAGS: readonly {
-    tagName: string;
-    canonical: string;
-    tier: "html-advisory";
-}[];
-declare const RAW_HTML_INPUT_TYPE_CANONICALS: readonly {
-    type: string;
-    canonical: string;
-    tier: "input-type";
-}[];
-declare const RAW_HTML_ROLE_CANONICALS: readonly {
-    role: string;
-    canonical: string;
-    tier: "role-reimpl";
-}[];
-declare function resolveCanonicalForRawHtml(tagName: string, inputType?: string): RawHtmlCanonicalMatch | null;
-declare function resolveCanonicalForAriaRole(role: string): RawHtmlCanonicalMatch | null;
-declare function isRawHtmlAdvisoryTier(tier: RawHtmlPrecisionTier): boolean;
 /**
- * Decide whether a per-component `htmlEquivalent` mapping (raw `tag` → a
- * `canonical` component) may drive a bare-tag canonical-usage finding.
- *
- * The contract:
- * - Low-frequency SEMANTIC tags (dialog, select, textarea, input, …) are always
- *   enforceable, so a custom-named component (`<dialog>` → Modal) still maps.
- * - Common/ambiguous tags (button, a, …) enforce ONLY when the mapping AGREES
- *   with the framework's curated canonical for that tag — so `<button>` → Button
- *   fires, but `<button>` → Chip does not.
- * - Generic structural containers (div, span) have no curated answer and are not
- *   semantic → never enforce.
- *
- * This is the guard that stops the canonical-usage flood: a library component
- * being built on a `<div>` must not make every `<div>` a bespoke re-implementation
- * of it (every `<div>` → Accordion, every `<span>` → Badge, every `<button>` → Chip).
+ * Mint a clone- and platform-portable identity for one component definition.
  */
-declare function isEnforceableHtmlEquivalent(args: {
-    tag: string;
-    canonical: string;
-    inputType?: string;
-    /**
-     * The mapping is an EXPLICIT project declaration of this tag → component
-     * (provenance: `localCanonical.resolves`), not a low-confidence inferred
-     * `htmlEquivalent`. Explicit declarations enforce a specific interactive tag
-     * (`button`/`a`) against any canonical NAME — the agnosticism path — while
-     * inferred mappings stay name-gated to the curated canonical (the flood
-     * guard). Generic containers (`div`/`span`) are never enforceable even when
-     * explicit.
-     */
-    explicit?: boolean;
-}): boolean;
+declare function buildComponentKey({ repoRelativeFile, exportName }: ComponentKeyInput): string;
 
-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 };
+export { type A11yNameRequiredFact, AGENT_CONTEXT_RELATIVE_PATH, AgentFormat, BLOCKING_RULE_ALLOWLIST, BRAND, BlockDefinition, type Brand, type BuildAgentFormatInput, type BuildRegistryInstallPlanInput, type BundleArtifactMetadata, type BundleComponentShard, type BundleManifest, type BundleManifestComponentEntry, type BundleSchemaVersion, type BundleTarget, type BundleTokenFile, CATALOG_FIXTURE_A_FCID, type CSF2Story, type CSSGeneratorOptions, type CanonicalCandidateFact, Finding as CanonicalFinding, type CanonicalIdentityReference, type CanonicalMappingFact, type CanonicalReplacementFact, CanonicalSource, type CheckStoryExclusionOpts, type CheckedSpacingValue, type ClassNameDynamicFact, type ClassNameDynamicReason, type ClassNameFact, type ClassNameLiteralFact, type ClassNameOrigin, type ClassifyIdentityInput, CompiledBlock, type CompiledContractOutput, CompiledFragment, type ComplexityTier, type ComponentCapabilityFact, type ComponentContract, type ComponentDefinitionFact, type ComponentDefinitionRenderRoot, type ComponentFactInput, type ComponentId, type ComponentIdentityFact, type ComponentIdentityUsage, type ComponentKeyInput, type ComponentLevelFact, type ComponentMetadataFact, type CompositionAnalysis, type CompositionAuthoringEntry, type CompositionChildSelector, type CompositionConstraint, type CompositionGuideline, type CompositionPattern, type CompositionRegionSelector, type CompositionSuggestion, type CompositionWarning, type ConformChange, type ConformComponentMapping, type ConformConfidence, type ConformCoverage, type ConformInput, type ConformLocation, type ConformPropMapping, type ConformResult, type ConformSuggestion, type ConformToken, type ConformUnresolved, ContractCatalogInput, ContractDomain, type ContractStampPin, type ContractStampRecord, DEFAULTS, DEFAULT_ENHANCED_STYLE_PROPERTIES, DEFAULT_STYLE_PROPERTIES, type DTCGColorValue, type DTCGDimensionValue, type DTCGGroup, type DTCGToken, type DTCGTokenFile, type DTCGTokenType, type Decorator, type Defaults, type DeltaEMatch, type DesignSystemContext, type DesignToken, type DesignTokenParseOptions, type DiscoverComponentsOptions, type EnhancedStyleComparisonResult, type EnhancedStyleDiffItem, EvidenceGrade, type ExclusionReason, type ExclusionResult, type ExternalIdentityReference, FRAGMENTS_INTERNAL_RULE_IDS, type Fact, type FactEvidence, type FactId, FactIndex, type FactKind, type FactLocation, type FactOfKind, FigmaBooleanMapping, FigmaChildrenMapping, FigmaEnumMapping, FigmaInstanceMapping, FigmaStringMapping, FigmaTextContentMapping, type FigmaVariable, type FigmaVariableCollection, Finding, FindingFix, type Fragment, type FragmentAccessibility, FragmentComponent, type FragmentContextOptions, FragmentDefinition, FragmentDefinitionV2, type FragmentDoNotItem, type FragmentFigma, type FragmentIndex, type FragmentMeta as FragmentJsonMeta, type FragmentUsage as FragmentJsonUsage, type FragmentPattern, type FragmentRegistry, type FragmentRelated, FragmentsConfig, Severity as FuiSeverity, GovernanceConfig, type GovernanceIntegrityFamily, type GovernanceIntegrityFamilyId, type GovernanceIntegrityInput, type GovernanceIntegrityStatus, type GovernanceIntegrityVerdict, GovernanceSeverity, GovernedFragmentDefinition, type IdentityClassification, type IdentityConfidence, type IdentityDecision, type IdentityFact, type IdentityState, type InferProps, type JsxComponentPreferredFact, type JsxImportPathPreferredFact, type JsxInlineStyleForbiddenRawFact, type JsxUnknownPropsForbiddenFact, type Loader, type LocalIdentityReference, type McpBlock, type McpCapability, type McpComponent, type McpComponentExample, type McpComponentGuidance, type McpComponentMetadata, type McpComponentProp, type McpComponentRelation, type McpCompoundChild, type McpGuidancePattern, type McpPerformanceData, type McpPerformanceImport, type McpPerformanceSummary, type McpSnapshot, type McpSnapshotMetadata, type McpSnapshotSchemaVersion, type McpSourceType, type McpToken, type McpTokenData, type NearestByDeltaEOptions, type NormalizedStyleMap, type NormalizedToken, PRESET_NAMES, PROVE_DEFAULT_MAX_PASSES, PROVE_MAX_PASSES, type ParseTokensOptions, type ParsedToken, type PerformanceData as PerfData, type PerformanceSummary as PerfSummary, type PerformanceBudgets, type PerformanceConfig, type PolicyFact, type PresetRuleState, type PreviewConfig, type PreviewRuntimeOptions, type PreviewRuntimeState, type PreviewVariantLike, PreviewVariantRuntime, type PropMetadataFact, type PropValueAvoidedFact, type PropValueForbiddenFact, type ProveCallbacks, type ProveLoopResult, type ProveOptions, type ProvePass, type ProvePassSampling, type ProveResidual, type ProveSample, type ProveSamplerArgs, type ProveVerdict, RAW_HTML_ADVISORY_TAGS, RAW_HTML_CANONICAL_TAGS, RAW_HTML_INPUT_TYPE_CANONICALS, RAW_HTML_ROLE_CANONICALS, type RGB, type RGBA, RULES, RULE_TIER, type RawHtmlCanonicalMatch, type RawHtmlPrecisionTier, RegistryArtifact, type RegistryComponentEntry, RegistryDependency, type RegistryInstallPlan, RegistryInstallReceipt, type RegistryPropEntry, type RegistryWritePlan, RelationshipType, type ResolvedDTCGToken, ResolvedGovernedFragmentDefinition, type ResolvedIdentityRenderRoot, type ResolvedIntrinsicIdentityRoot, type Rule, type RuleFn, type RuleTier, type SCSSGeneratorOptions, type ScaleFact, type ScaleValueFact, Severity, type SpacingResolutionScale, type SpacingTokenLookup, type Story, type StoryArgType, type StoryContext, type StoryMeta, type StoryModule, StorybookFilterConfig, type StructuralConfidenceFact, type StyleComparisonOptions, type StyleComparisonResult, type StyleCssVarsMustBeDefinedFact, type StyleDeclarationFact, type StyleDiffItem, type StyleFontSizeScaleFact, type StylePropertyScaleFact, type StyleRawColorForbiddenFact, type StyleUnsupportedFact, type SuppressionDirectiveFact, type TailwindClassFact, type TailwindModifier, type TailwindModifierKind, type TailwindPaletteAllowFact, type TailwindPaletteDenyFact, type TailwindResolutionSource, type TailwindResolvedKind, type TailwindResolvedValue, type TailwindTokenResolvedFact, type TailwindUnknownClassEnabledFact, type TailwindValue, type ThemeDeclarationFact, type ThemeParserResult, type TokenCategory, TokenConfig, type TokenDefinitionFact, type TokenFix, type TokenFormat, type TokenLookup, type TokenMatchRequest, type TokenMatchResult, type TokenParseError, type TokenParseOutput, type TokenParseResult, type TokenRegistry, type TokenRegistryMeta, type TokenUsageSummary, type UnsupportedStyleReason, type UsageComponentFact, type UsageFact, type UsageImportFact, type UsageInlineStyleFact, type UsageNodeFact, type UsagePropResolvedFact, type UsageTextChildFact, VariantLoader, aiMetadataSchema, analyzeComposition, asComponentId, assertPortableRegistryPath, blockDefinitionSchema, budgetBar, buildAgentFormat, buildComponentKey, buildRegistryInstallPlan, buildRegistryInstallReceipt, buildSpacingTokenLookup, bundleArtifactMetadataSchema, bundleComponentShardSchema, bundleManifestComponentEntrySchema, bundleManifestSchema, bundleSchemaVersionSchema, bundleTargetSchema, bundleTokenFileSchema, calculateDeltaE, canonicalJson, canonicalPreimage, catalogFixtureA, catalogFixtureAContractPayload, catalogFixtureATokensDtcg, checkStoryExclusion, clampMaxPasses, classifyComplexity, classifyIdentity, collectRegistryInstallDependencies, colorSimilarity, compareByVocabularyRank, compareColors, compareNumericValues, compareStyleValue, compareStyles, compareStylesWithTokens, compileBlock, compileComponentFacts, compileFragment, compileGlobalGovernanceFacts, compileRecipe, componentContractSchema, componentId, componentRelationSchema, compositionAuthoringEntrySchema, compositionMetadataSchema, compositionPatternSchema, containsTailwindV4Theme, contractHash, contractTierRuleIds, customerDefaultRuleStates, defineBlock, defineConfig, defineFragment, defineRecipe, detectSubComponentPaths, discoverComponents, dtcgTokenFileSchema, emptyConformResult, evaluateGovernanceIntegrity, executeVariantLoaders, factId, familyDistance, figma, figmaPropMappingSchema, formatBytes, formatStampHeader, formatStampPin, formatStampVersionHash, formatTokenSummary, fragmentBanSchema, fragmentContractSchema, fragmentDefinitionSchema, fragmentDefinitionV2Schema, fragmentGeneratedSchema, fragmentMetaSchema, fragmentProvenanceSchema, fragmentUsageSchema, fragmentVariantSchema, fragmentsConfigSchema, fragmentsPresetRuleStates, gatesCi, generateCSSCustomProperties, generateFigmaVariables, generateSCSSVariables, generateTailwindConfig, getComplianceBadge, getPreviewConfig, governedFragmentDefinitionSchema, hasEffectiveComponentVocabulary, hash64Hex, hexToRgb, hygieneTierRuleIds, indexComponentIdentityUsage, inferTokenCategory, inferTokenGroup, isColorLike, isCompositionPattern, isConfigExcluded, isContractFile, isContractTierRule, isDTCGFile, isDenyEligible, isEffectiveCanonicalSource, isEnforceableHtmlEquivalent, isExportStory, isFigmaPropMapping, isForceIncluded, isPortableRepoPath, isRawHtmlAdvisoryTier, isReactComponent, lowerCompositionContract, makeA11yNameRequiredFact, makeCanonicalCandidateFact, makeCanonicalMappingFact, makeCanonicalReplacementFact, makeClassNameDynamicFact, makeClassNameLiteralFact, makeComponentCapabilityFact, makeComponentDefinitionFact, makeComponentIdentityFact, makeComponentMetadataFact, makeContractTokenFact, makeFinding, makeJsxComponentPreferredFact, makeJsxImportPathPreferredFact, makeJsxInlineStyleForbiddenRawFact, makeJsxUnknownPropsForbiddenFact, makePropMetadataFact, makePropValueAvoidedFact, makePropValueForbiddenFact, makeScaleFact, makeScaleValueFact, makeStructuralConfidenceFact, makeStyleCssVarsMustBeDefinedFact, makeStyleDeclarationFact, makeStyleFontSizeScaleFact, makeStylePropertyScaleFact, makeStyleRawColorForbiddenFact, makeStyleUnsupportedFact, makeTailwindClassFact, makeTailwindPaletteAllowFact, makeTailwindPaletteDenyFact, makeTailwindTokenResolvedFact, makeTailwindUnknownClassEnabledFact, makeThemeDeclarationFact, makeTokenDefinitionFact, makeUsageComponentFact, makeUsageImportFact, makeUsageInlineStyleFact, makeUsageNodeFact, makeUsagePropResolvedFact, makeUsageTextChildFact, matchesGlob, mcpBlockSchema, mcpCapabilitySchema, mcpComponentExampleSchema, mcpComponentGuidanceSchema, mcpComponentMetadataSchema, mcpComponentPropSchema, mcpComponentRelationSchema, mcpComponentSchema, mcpCompoundChildSchema, mcpGuidancePatternSchema, mcpPerformanceDataSchema, mcpPerformanceImportSchema, mcpPerformanceSummarySchema, mcpSnapshotMetadataSchema, mcpSnapshotSchema, mcpSnapshotSchemaVersionSchema, mcpSourceTypeSchema, mcpTokenDataSchema, mcpTokenSchema, nearestByDeltaE, nearestSignedScaleValue, normalizeColor, normalizeConfigPath, normalizeRegistryRepoPath, normalizeStyleValue, normalizeToV1, normalizeTokenGroupComment, normalizeTokenValue, parseColor, parseColorToRgb, parseComponentContract, parseContractStamp, parseCssTokens, parseDtcgTokens as parseDTCGFile, parseDesignTokenContent, parseDtcgTokens, parseRgb, parseScssTokens, parseScssVariables, parseTailwindV4Theme, parseTokenFile, parseTokens, portableRepoPathError, propDefinitionSchema, proveCompliant, proveIssueCount, recipeDefinitionSchema, resolveCanonicalForAriaRole, resolveCanonicalForRawHtml, resolveConfiguredAppPath, resolveDesignTokenValue, resolveFigmaMapping, resolvePerformanceConfig, resolvePreviewRuntimeState, resolveProveVerdict, resolveSpacingValue, resolveTokenValue, rgbToHex, ruleA11yRequiredAccessibleName, ruleComponentsForbiddenPropValue, ruleComponentsPreferLibrary, ruleComponentsShadowComponent, ruleComponentsUnknownProp, ruleJsxPreferredComponent, ruleJsxPreferredImportPath, rulePropsInvalidValue, ruleStylesNoRawColor, ruleStylesNoRawDimensions, ruleStylesNoRawSpacing, ruleStylesNoRawTypography, ruleTailwindArbitraryColor, ruleTailwindArbitrarySpacing, ruleTailwindForbiddenPalette, ruleTailwindOffScaleSpacingToken, ruleTailwindRawColorViaToken, ruleTailwindUnknownClass, ruleThemeNoThemeCoupledLiteral, ruleTokensRequireDualFallback, runRules, selectedRegistryComponentNames, serializeContractStamp, setPreviewConfig, sha256Hex, sourceToRegistryTargetPath, storyModuleToFragment, storyNameFromExport, tierFor, toId, tokenIncludesFromConfig, topologyBase, usePreviewVariantRuntime, vocabularyRank };