@usefragments/core 1.3.0 → 1.5.0

package/dist/index.d.ts

@@ -3,8 +3,8 @@ export { b as AGENT_FORMAT_SCHEMA_VERSION, c as AgentErrorEnvelope, d as AgentOu
 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-DYSirwJu.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-DYSirwJu.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';
@@ -39,6 +39,8 @@ declare const BRAND: {
     readonly legacyConfigFile: "segments.config.ts";
     /** CLI command name (e.g., "fragments") */
     readonly cliCommand: "fragments";
+    /** Full user-facing CLI invocation for copy printed to end users (e.g., "npx @usefragments/cli") */
+    readonly cliInvocation: "npx @usefragments/cli";
     /** Directory for storing fragments, registry, and cache */
     readonly dataDir: ".fragments";
     /** Components subdirectory within .fragments/ */
@@ -118,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;
@@ -566,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.
  *
@@ -824,7 +970,20 @@ interface UsageInlineStyleFact extends BaseFact {
     kind: "usage_inline_style";
     nodeId: FactId;
     property: string;
-    valueKind: "static" | "number" | "css-variable";
+    /**
+     * How the extractor resolved the value:
+     * - `static`       — a string literal (`"#f00"`, `"12px"`).
+     * - `number`       — a numeric literal (React treats it as `px`).
+     * - `css-variable` — a `var(--token)` reference; rules treat it as a token.
+     * - `dynamic-raw`  — a value constructed at runtime whose *static* fragments
+     *   unambiguously begin a raw color literal (`` `#${red}` ``,
+     *   `` `rgb(${r},${g},${b})` ``, `"#" + hex`). `value` carries a reconstructed
+     *   skeleton with each interpolation rendered as `‹expr›`. Detect-only: a rule
+     *   may flag it as a raw color but must NEVER attach a deterministic fix
+     *   (the value is partly runtime). Only color-shaped dynamic values ever
+     *   surface as facts — a non-color dynamic value stays opaque.
+     */
+    valueKind: "static" | "number" | "css-variable" | "dynamic-raw";
     value: string;
 }
 interface UsageTextChildFact extends BaseFact {
@@ -1008,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, {
@@ -1061,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;
@@ -1224,7 +1445,7 @@ declare function makeUsagePropResolvedFact(input: {
 declare function makeUsageInlineStyleFact(input: {
     nodeId: FactId;
     property: string;
-    valueKind: "static" | "number" | "css-variable";
+    valueKind: "static" | "number" | "css-variable" | "dynamic-raw";
     value: string;
 }): UsageInlineStyleFact;
 declare function makeUsageTextChildFact(input: {
@@ -1773,8 +1994,8 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
         componentId: string;
         name: string;
     }[];
-    publicSlug: string | null;
     tier: "core" | "composition";
+    publicSlug: string | null;
     propCount: number;
     hasExamples: boolean;
     hasCompoundChildren: boolean;
@@ -1794,8 +2015,8 @@ declare const bundleManifestComponentEntrySchema: z.ZodObject<{
         componentId: string;
         name: string;
     }[];
-    publicSlug: string | null;
     tier: "core" | "composition";
+    publicSlug: string | null;
     propCount: number;
     hasExamples: boolean;
     hasCompoundChildren: boolean;
@@ -1903,8 +2124,8 @@ declare const bundleManifestSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
-        publicSlug: string | null;
         tier: "core" | "composition";
+        publicSlug: string | null;
         propCount: number;
         hasExamples: boolean;
         hasCompoundChildren: boolean;
@@ -1924,8 +2145,8 @@ declare const bundleManifestSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
-        publicSlug: string | null;
         tier: "core" | "composition";
+        publicSlug: string | null;
         propCount: number;
         hasExamples: boolean;
         hasCompoundChildren: boolean;
@@ -1947,8 +2168,8 @@ declare const bundleManifestSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
-        publicSlug: string | null;
         tier: "core" | "composition";
+        publicSlug: string | null;
         propCount: number;
         hasExamples: boolean;
         hasCompoundChildren: boolean;
@@ -1993,8 +2214,8 @@ declare const bundleManifestSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
-        publicSlug: string | null;
         tier: "core" | "composition";
+        publicSlug: string | null;
         propCount: number;
         hasExamples: boolean;
         hasCompoundChildren: boolean;
@@ -2196,9 +2417,9 @@ declare const bundleComponentShardSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
+        tier: "core" | "composition";
         source: "design-system";
         publicSlug: string | null;
-        tier: "core" | "composition";
         relations: Record<string, unknown>[];
         publicId: string | null;
         usageGuidance: string;
@@ -2222,9 +2443,9 @@ declare const bundleComponentShardSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
+        tier: "core" | "composition";
         source: "design-system";
         publicSlug: string | null;
-        tier: "core" | "composition";
         relations: Record<string, unknown>[];
         publicId: string | null;
         usageGuidance: string;
@@ -2253,9 +2474,9 @@ declare const bundleComponentShardSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
+        tier: "core" | "composition";
         source: "design-system";
         publicSlug: string | null;
-        tier: "core" | "composition";
         relations: Record<string, unknown>[];
         publicId: string | null;
         usageGuidance: string;
@@ -2286,9 +2507,9 @@ declare const bundleComponentShardSchema: z.ZodObject<{
             componentId: string;
             name: string;
         }[];
+        tier: "core" | "composition";
         source: "design-system";
         publicSlug: string | null;
-        tier: "core" | "composition";
         relations: Record<string, unknown>[];
         publicId: string | null;
         usageGuidance: string;
@@ -2835,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;
@@ -2885,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;
@@ -3364,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;
@@ -3414,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;
@@ -3655,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;
@@ -3757,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;
@@ -5510,6 +5731,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             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>;
@@ -5527,6 +5749,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             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>;
@@ -5544,6 +5767,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             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>;
@@ -5561,6 +5785,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             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>;
@@ -5578,6 +5803,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             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>;
@@ -6725,6 +6951,43 @@ declare const fragmentsConfigSchema: z.ZodObject<{
         }> | undefined;
     }>>;
     recognizedClassHelpers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    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, {
+            kind: "sanction" | "reject" | "dismiss";
+            component: string;
+            reason?: string | undefined;
+            canonicalTarget?: string | undefined;
+            decisionId?: string | undefined;
+        }, {
+            kind: "sanction" | "reject" | "dismiss";
+            component: string;
+            reason?: string | undefined;
+            canonicalTarget?: string | undefined;
+            decisionId?: string | undefined;
+        }>, "many">>;
+    }, "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, {
@@ -6915,6 +7178,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             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>;
@@ -6983,6 +7247,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;
 }, {
     govern?: {
         components?: Record<string, {
@@ -7173,6 +7446,7 @@ declare const fragmentsConfigSchema: z.ZodObject<{
             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>;
@@ -7241,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)
@@ -9699,7 +9982,7 @@ interface ThemeParserResult {
 
 declare function inferTokenCategory(name: string, value?: string): TokenCategory;
 declare function inferTokenGroup(name: string): string;
-declare function normalizeTokenGroupComment(comment: string): string;
+declare function normalizeTokenGroupComment(comment: string): string | null;
 
 declare function parseScssVariables(content: string): Map<string, string>;
 declare function resolveTokenValue(rawValue: string, scssVars: Map<string, string>, cssVarValues: Map<string, string>, depth?: number): string;
@@ -10604,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.
@@ -10795,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";
 /**
@@ -11226,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.
  *
@@ -11340,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 };