@usefragments/core 1.10.2 → 2.0.0

package/dist/{governance-CLk_wkP9.d.ts → governance-hOPXGbbs.d.ts}

@@ -1,7 +1,6 @@
 import { z } from 'zod';
 import { ComponentType, ReactNode, JSX } from 'react';
 import { Topology } from './topology/index.js';
-import { S as SerializedComponentGraph } from './types-xJ2xyp_G.js';
 
 /**
  * Frontend Contract preimage — the projection that defines what the contract IS.
@@ -30,6 +29,16 @@ import { S as SerializedComponentGraph } from './types-xJ2xyp_G.js';
  * Runtime-portable by construction: no Node APIs, no Convex imports, no React.
  */
 
+/**
+ * Positive pick-list of per-component `contract` fields that enter the FCID.
+ * Display/guidance fields (`propsSummary`, `canonicalUsage`, `scenarioTags`,
+ * story `states`/`variants`, descriptions) are intentionally absent — adapters
+ * may still pass them, but {@link projectEnforcementContract} never copies them.
+ */
+declare const CONTRACT_ENFORCEMENT_FIELDS: readonly ["a11yRules", "bans", "performanceBudget", "compoundChildren", "composition"];
+type ContractEnforcementField = (typeof CONTRACT_ENFORCEMENT_FIELDS)[number];
+/** Display-only contract keys that must never enter the FCID positive pick-list. */
+declare const CONTRACT_DISPLAY_ONLY_FIELDS: readonly ["propsSummary", "canonicalUsage", "scenarioTags", "states", "variants"];
 /**
  * The fixed domain enum. Adding a domain is a spine change (update
  * `01-architecture.md` first); never rename — deprecate and alias.
@@ -48,11 +57,15 @@ interface ContractComponentInput {
     /** Prop names the component accepts. */
     props?: readonly string[];
     /**
-     * The per-component enforcement contract as authored (bans, a11y rules,
-     * required compound children). Passed through whole — it is enforcement data
-     * by definition.
+     * The per-component contract as authored. Only {@link CONTRACT_ENFORCEMENT_FIELDS}
+     * are projected into the FCID — display/guidance keys are stripped structurally.
      */
     contract?: unknown;
+    /**
+     * Resolved component governance records (`govern:` / `governance`). Editing
+     * these changes what CI allows, so they are FCID identity.
+     */
+    governance?: readonly ComponentGovernanceRecord[];
     /** Required compound-children names, when the structure is declared. */
     compoundChildren?: readonly string[];
 }
@@ -127,6 +140,11 @@ interface ContractCatalogInput {
     canonicalMappings?: readonly ContractCanonicalMappingInput[];
     policy?: ContractPolicyInput | null;
 }
+/** Deterministic runtime refusal for malformed or ambiguous FCID inputs. */
+declare class ContractCatalogValidationError extends TypeError {
+    readonly issues: readonly string[];
+    constructor(issues: readonly string[]);
+}
 declare const CONTRACT_PREIMAGE_SCHEMA: "fcid-preimage:v1";
 /** Request header used by clients that can verify and consume this preimage. */
 declare const CONTRACT_PREIMAGE_CAPABILITY_HEADER: "X-Fragments-Contract-Preimage";
@@ -158,6 +176,11 @@ interface ContractIdentityPin {
  * internally inconsistent pin returns `null` and therefore fails closed.
  */
 declare function verifiedContractPreimageFromPin(pin: ContractIdentityPin): ContractPreimage | null;
+/**
+ * Project only enforcement fields from a per-component `contract` blob.
+ * Unknown / display keys are dropped; an all-display contract becomes `undefined`.
+ */
+declare function projectEnforcementContract(contract: unknown): unknown;
 /**
  * Project a catalog onto the contract preimage: four enforced-only domain
  * bodies, each hashed independently. `contractHash(projectContractPreimage(x))`
@@ -190,6 +213,18 @@ declare function diffContractDomains(a: ContractPreimage, b: ContractPreimage):
  */
 declare function contractPolicyFromGovernanceConfig(config: GovernanceConfig | null | undefined): ContractPolicyInput | null;
 declare function contractComponentsFromFragments(fragments: readonly unknown[]): ContractComponentInput[];
+/**
+ * Derive a preview `artifactId` from modules, states, guidance/render content,
+ * and runtime config. Never an FCID — callers must not assign
+ * `derivedFromContractHash` into `artifactId` (or the reverse).
+ */
+declare function deriveArtifactId(content: {
+    modules?: unknown;
+    states?: unknown;
+    guidance?: unknown;
+    render?: unknown;
+    runtime?: unknown;
+}): string;
 
 interface LocalCanonicalResolveRule {
     tag: string;
@@ -206,286 +241,6 @@ interface InspectConfig {
 declare function localCanonicalContractMappings(inspect: InspectConfig | null | undefined): ContractCanonicalMappingInput[];
 declare function governanceConfigWithLocalCanonical(config: GovernanceConfig | undefined, inspect: InspectConfig | null | undefined): GovernanceConfig | undefined;
 
-/**
- * Component metadata
- */
-interface FragmentMeta$1 {
-    name: string;
-    description: string;
-    category: string;
-    tags?: string[];
-    status?: "stable" | "beta" | "deprecated" | "experimental";
-    since?: string;
-    dependencies?: Array<{
-        name: string;
-        version: string;
-        reason?: string;
-    }>;
-    figma?: string;
-    figmaProps?: Record<string, unknown>;
-}
-/**
- * Usage guidelines for AI agents and developers
- */
-interface FragmentUsage$1 {
-    when: string[];
-    whenNot: string[];
-    guidelines?: string[];
-    accessibility?: string[];
-}
-/**
- * Definition for a single prop
- */
-interface PropDefinition$1 {
-    type: string;
-    values?: readonly string[];
-    default?: unknown;
-    description: string;
-    required?: boolean;
-    constraints?: string[];
-    typeDetails?: Record<string, unknown>;
-    controlType?: string;
-    controlOptions?: {
-        min?: number;
-        max?: number;
-        step?: number;
-        presetColors?: string[];
-    };
-}
-/**
- * Relationship to another component
- */
-interface ComponentRelation$1 {
-    component: string;
-    relationship: string;
-    note: string;
-}
-/**
- * Agent-optimized contract metadata
- */
-interface FragmentContract$1 {
-    propsSummary?: string[];
-    a11yRules?: string[];
-    bans?: Array<{
-        pattern: string;
-        message: string;
-    }>;
-    scenarioTags?: string[];
-    /** Per-component performance budget override in bytes (gzipped) */
-    performanceBudget?: number;
-    /** Sub-component slot metadata for compound components */
-    compoundChildren?: Record<string, {
-        required?: boolean;
-        accepts?: string[];
-        description?: string;
-    }>;
-    /** Canonical JSX usage examples showing how to assemble the component */
-    canonicalUsage?: string[];
-}
-/**
- * Provenance tracking for generated fragments
- */
-interface FragmentGenerated$1 {
-    source: "storybook" | "manual" | "ai" | "extracted" | "merged" | "migrated";
-    sourceFile?: string;
-    /** @deprecated Use provenance.verified instead */
-    confidence?: number;
-    verified?: boolean;
-    timestamp?: string;
-}
-/**
- * AI-specific metadata
- */
-interface AIMetadata$1 {
-    compositionPattern?: "compound" | "simple" | "controlled" | "wrapper";
-    subComponents?: string[];
-    requiredChildren?: string[];
-    commonPatterns?: string[];
-}
-/**
- * Performance data for a component (from bundle size measurement)
- */
-/**
- * A single import contributing to bundle size
- */
-interface ImportEntry {
-    /** Resolved file path (relative to project root) */
-    path: string;
-    /** Bytes contributed to the bundle */
-    bytes: number;
-    /** Percentage of total bundle size */
-    percent: number;
-}
-interface PerformanceData {
-    /** Gzipped bundle size in bytes */
-    bundleSize: number;
-    /** Raw (minified, not gzipped) bundle size in bytes */
-    rawSize: number;
-    /** Complexity classification */
-    complexity: 'lightweight' | 'moderate' | 'heavy';
-    /** Percentage of budget used (0-100+) */
-    budgetPercent: number;
-    /** Whether the component exceeds its budget */
-    overBudget: boolean;
-    /** ISO timestamp when measured */
-    measuredAt: string;
-    /** Top imports by size (largest first) */
-    imports?: ImportEntry[];
-}
-interface ObservedUsageProp {
-    name: string;
-    kind: 'static' | 'dynamic' | 'spread' | 'jsx' | 'boolean' | 'null';
-    value?: string | number | boolean | null;
-}
-interface ObservedComponentUsage {
-    /** Source file path relative to the fragments config root */
-    file: string;
-    /** 1-indexed source line */
-    line: number;
-    /** 0-indexed source column */
-    column: number;
-    props: ObservedUsageProp[];
-    parentElement?: string;
-    conditional?: boolean;
-}
-/**
- * Compiled fragment data (JSON-serializable for AI consumption)
- */
-interface CompiledFragment {
-    filePath: string;
-    meta: FragmentMeta$1;
-    /** Canonical v2 guidance. `usage` is retained for compatibility. */
-    guidance?: FragmentUsage$1;
-    usage: FragmentUsage$1;
-    props: Record<string, PropDefinition$1>;
-    /** Normalized component governance records emitted from *.fragment.ts. */
-    governance?: ComponentGovernanceRecord[];
-    relations?: ComponentRelation$1[];
-    variants: Array<{
-        name: string;
-        description: string;
-        code?: string;
-        figma?: string;
-        args?: Record<string, unknown>;
-    }>;
-    contract?: FragmentContract$1;
-    ai?: AIMetadata$1;
-    /** Framework hint from contract, used by preview adapters and Cloud */
-    framework?: string;
-    /** Top-level compact prop summaries for agent first-pass */
-    propsSummary?: string[];
-    /** Source file path relative to config root (for contract-sourced fragments) */
-    sourcePath?: string;
-    /** Named export for preview adapter resolution */
-    exportName?: string;
-    /** Clean provenance tracking (V2) */
-    provenance?: {
-        source: string;
-        verified: boolean;
-        frameworkSupport?: string;
-        sourceHash?: string;
-        extractedAt?: string;
-    };
-    /** Component performance data from bundle size measurement */
-    performance?: PerformanceData;
-    /** Observed JSX call sites captured during `fragments scan` */
-    usages?: ObservedComponentUsage[];
-    _generated?: FragmentGenerated$1;
-}
-/**
- * Compiled block data (JSON-serializable for AI consumption)
- */
-interface CompiledBlock {
-    filePath: string;
-    name: string;
-    description: string;
-    category: string;
-    components: string[];
-    code: string;
-    tags?: string[];
-}
-/**
- * A single token entry in the compiled output
- */
-interface CompiledTokenEntry {
-    name: string;
-    value?: string;
-    description?: string;
-}
-/**
- * Compiled token data stored in fragments.json
- */
-interface CompiledTokenData {
-    prefix: string;
-    total: number;
-    categories: Record<string, CompiledTokenEntry[]>;
-}
-/**
- * Performance summary across all components
- */
-interface PerformanceSummary {
-    /** Preset name used */
-    preset: string;
-    /** Budget applied in bytes */
-    budget: number;
-    /** Total components measured */
-    total: number;
-    /** Number of components over budget */
-    overBudget: number;
-    /** Distribution by tier */
-    tiers: Record<string, number>;
-}
-/**
- * The compiled fragments.json structure
- */
-interface CompiledFragmentsFile {
-    version: string;
-    generatedAt: string;
-    /** CLI version that produced this file, used for freshness checks */
-    generatorVersion?: string;
-    /** Relative source/config inputs used to build this file, used for freshness checks */
-    buildInputs?: string[];
-    packageName?: string;
-    fragments: Record<string, CompiledFragment>;
-    blocks?: Record<string, CompiledBlock>;
-    tokens?: CompiledTokenData;
-    /** Component relationship graph for AI structural queries */
-    graph?: SerializedComponentGraph;
-    /** Performance measurement summary */
-    performanceSummary?: PerformanceSummary;
-    /** @deprecated Use blocks instead */
-    recipes?: Record<string, CompiledBlock>;
-}
-declare class CompiledFragmentsFileValidationError extends Error {
-    readonly source: string;
-    readonly issues: string[];
-    constructor(source: string, issues: string[]);
-}
-declare function parseCompiledFragmentsFile(input: string | unknown, source?: string): CompiledFragmentsFile;
-/**
- * Theme identifier
- */
-type Theme$1 = "light" | "dark";
-/**
- * Verification result
- */
-interface VerifyResult$1 {
-    verdict: "pass" | "fail" | "error";
-    matches: boolean;
-    diffPercentage: number;
-    screenshot: string;
-    baseline: string;
-    diffImage?: string;
-    notes: string[];
-    error?: string;
-    timing: {
-        renderMs: number;
-        captureMs: number;
-        diffMs: number;
-        totalMs: number;
-    };
-}
-
 /**
  * A React component that can be used in a fragment definition.
  * This type is intentionally broad to support various React component patterns
@@ -572,6 +327,17 @@ interface FragmentUsage {
     when: string[];
     /** When NOT to use this component (with alternatives) */
     whenNot: string[];
+    /** Optional v3 choose-among-alternates guidance carried into the wire document */
+    choose?: Record<string, string>;
+    /**
+     * Serialized v3 anti-pattern guidance. The source API keeps `good` as JSX;
+     * the compiled catalog stores its exact checked source span as a string.
+     */
+    dont?: Array<{
+        reason: string;
+        bad: string;
+        good: string;
+    }>;
     /** Additional usage guidelines and best practices */
     guidelines?: string[];
     /** Accessibility considerations */
@@ -713,6 +479,12 @@ interface FragmentVariant {
     tags?: string[];
     /** Async loaders to execute before rendering (from Storybook loaders) */
     loaders?: VariantLoader[];
+    /**
+     * The adapted Storybook story declared one or more loaders. Their original
+     * Storybook context is not available to a Fragment variant, so adapters
+     * report presence without attempting to execute them.
+     */
+    hasUnsupportedStorybookLoaders?: boolean;
     /** The args/props used to render this variant (for code generation) */
     args?: Record<string, unknown>;
 }
@@ -751,7 +523,7 @@ interface FragmentContract {
  */
 interface FragmentGenerated {
     /** Source of this fragment definition */
-    source: "storybook" | "manual" | "ai" | "extracted" | "merged" | "migrated";
+    source: "storybook" | "manual" | "ai" | "scan" | "extracted" | "merged" | "migrated";
     /** Original source file (e.g., "Button.stories.tsx") */
     sourceFile?: string;
     /** @deprecated Use provenance.verified instead — kept for backwards compatibility */
@@ -838,7 +610,7 @@ interface FragmentProvenance {
     /** @deprecated Use verified instead */
     confidence?: number;
     /** Whether the fragment has been verified against source */
-    verified: boolean;
+    verified?: boolean;
     /** Framework support level */
     frameworkSupport?: "native" | "manual-only";
     /** SHA hash of the source file at extraction time */
@@ -882,6 +654,162 @@ interface FragmentDefinitionV2<TProps = unknown> {
     /** Provenance tracking (v2 name for '_generated', extended) */
     _provenance?: FragmentProvenance;
 }
+/**
+ * v3 component metadata. `purpose` is the required plain-English line for
+ * exec/agent surfaces; intent-search vocabulary lives in `aliases`.
+ *
+ * @since 3.0
+ */
+interface FragmentMetaV3 {
+    name: string;
+    purpose: string;
+    category: string;
+    status?: "stable" | "beta" | "deprecated" | "experimental";
+    aliases?: string[];
+    tags?: string[];
+    since?: string;
+    dependencies?: Array<{
+        name: string;
+        version: string;
+        reason?: string;
+    }>;
+    figma?: string;
+    figmaProps?: Record<string, FigmaPropMapping>;
+}
+/**
+ * A single authored state. Display `code` is extracted from the checked JSX
+ * AST by the compiler — authored `code` strings are forbidden in v3.
+ *
+ * @since 3.0
+ */
+interface FragmentStateV3 {
+    /** Type-checked JSX (element or render thunk). Never an authored code string. */
+    render: Exclude<ReactNode, string | undefined> | ((options?: VariantRenderOptions) => ReactNode);
+    note?: string;
+    canonical?: boolean;
+    /** Forbidden in v3 — display code is extracted from `render`. */
+    code?: never;
+}
+/**
+ * Negative example with a type-checked `good` replacement.
+ *
+ * @since 3.0
+ */
+interface FragmentDontExampleV3 {
+    reason: string;
+    /** Anti-pattern shown as a string (intentionally not type-checked). */
+    bad: string;
+    /** Correct replacement — real JSX bound to the component. */
+    good: Exclude<ReactNode, string | undefined> | ((options?: VariantRenderOptions) => ReactNode);
+}
+/**
+ * v3 guidance: v2 when/whenNot plus choose/dont.
+ *
+ * @since 3.0
+ */
+interface FragmentGuidanceV3 {
+    when: string[];
+    whenNot: string[];
+    choose?: Record<string, string>;
+    dont?: FragmentDontExampleV3[];
+    guidelines?: string[];
+    accessibility?: string[];
+}
+/**
+ * Workshop matrix axes. `"auto"` means extraction fills proven prop enums.
+ *
+ * @since 3.0
+ */
+interface FragmentMatrixV3 {
+    axes?: Record<string, "auto" | readonly string[]>;
+    forced?: string[];
+    worstCase?: Record<string, unknown>;
+}
+/**
+ * Preview runtime hints (providers + visual-diff masks).
+ *
+ * @since 3.0
+ */
+interface FragmentPreviewV3 {
+    providers?: unknown[];
+    dynamicRegions?: string[];
+}
+/**
+ * Optional design-tool comparison input.
+ *
+ * @since 3.0
+ */
+interface FragmentDesignV3 {
+    figmaNode?: string;
+}
+/**
+ * Prop annotations annotate extracted truth — they never redefine `type`,
+ * `default`, `values`, or `required`.
+ *
+ * @since 3.0
+ */
+interface PropAnnotation {
+    description?: string;
+    controlType?: ControlType;
+    controlOptions?: Record<string, unknown>;
+    visibility?: "public" | "internal" | "hidden";
+    constraints?: string[];
+    /** Forbidden — derived from component types. */
+    type?: never;
+    /** Forbidden — derived from component defaults. */
+    default?: never;
+    values?: never;
+    required?: never;
+}
+/**
+ * Freeform authoring annotations (docs notes, review markers). Separate from
+ * prop annotations, which live under `props`.
+ *
+ * @since 3.0
+ */
+interface FragmentAnnotationsV3 {
+    notes?: string[];
+    review?: string[];
+    [key: string]: unknown;
+}
+type FragmentPropAnnotations<TProps> = [keyof TProps] extends [never] ? Record<string, PropAnnotation> : {
+    [K in Extract<keyof TProps, string>]?: PropAnnotation;
+};
+/**
+ * v3 definition body — the second argument to
+ * `defineFragment(Component, definition)`. The component is bound by arity,
+ * not authored inside the body.
+ *
+ * @since 3.0
+ */
+interface FragmentDefinitionV3Body<TProps = unknown> {
+    meta: FragmentMetaV3;
+    states: Record<string, FragmentStateV3>;
+    guidance: FragmentGuidanceV3;
+    matrix?: FragmentMatrixV3;
+    preview?: FragmentPreviewV3;
+    design?: FragmentDesignV3;
+    annotations?: FragmentAnnotationsV3;
+    /** Annotate-only prop docs keyed by prop name. */
+    props?: FragmentPropAnnotations<TProps>;
+    relations?: ComponentRelation[];
+    composition?: CompositionMetadata;
+    contract?: FragmentContract;
+    _provenance?: FragmentProvenance;
+    /** Optional governance authoring (resolved when present). */
+    govern?: (g: ComponentGovernanceBuilder<TProps>) => ComponentGovernanceRecord[];
+    governance?: ComponentGovernanceRecord[];
+}
+/**
+ * Resolved v3 fragment after `defineFragment(Component, body)` binds the
+ * component. Governance is always resolved (empty array when none authored).
+ *
+ * @since 3.0
+ */
+interface FragmentDefinitionV3<TProps = unknown> extends FragmentDefinitionV3Body<TProps> {
+    component: FragmentComponent<TProps>;
+    governance: ComponentGovernanceRecord[];
+}
 /**
  * Registry generation options
  */
@@ -894,8 +822,48 @@ interface RegistryOptions {
     categoryDepth?: number;
     /** Include props in registry (default: false - AI can read TypeScript directly) */
     includeProps?: boolean;
-    /** Include full fragment data in registry (default: false - reference fragmentPath instead) */
-    embedFragments?: boolean;
+}
+/** Prop entry in the lightweight source registry. */
+interface RegistryPropEntry {
+    type?: string;
+    typeKind?: "string" | "number" | "boolean" | "enum" | "object" | "array" | "function" | "node" | "element" | "union" | "unknown";
+    options?: string[];
+    default?: unknown;
+    required?: boolean;
+    description?: string;
+}
+/** Component entry in the lightweight source registry. */
+interface RegistryComponentEntry {
+    path: string;
+    storyPath?: string;
+    category?: string;
+    props?: Record<string, RegistryPropEntry>;
+    exports?: string[];
+    dependencies?: string[];
+}
+/** Minimal component index for quick source navigation. */
+interface FragmentIndex {
+    version: string;
+    generatedAt: string;
+    components: Record<string, string>;
+    categories?: Record<string, string[]>;
+}
+/** Source registry with resolved component paths and optional extracted props. */
+interface FragmentRegistry {
+    $schema?: string;
+    version: string;
+    generatedAt: string;
+    componentCount: number;
+    components: Record<string, RegistryComponentEntry>;
+    categories?: Record<string, string[]>;
+}
+/** Context file options for source-registry generation. */
+interface FragmentContextOptions {
+    format?: "markdown" | "json";
+    compact?: boolean;
+    include?: {
+        props?: boolean;
+    };
 }
 /**
  * Design token configuration
@@ -1001,24 +969,6 @@ interface SnippetPolicyConfig {
     /** Allow these external modules for JSX components in snippets/renders. */
     allowedExternalModules?: string[];
 }
-/**
- * Storybook adapter filtering configuration.
- * Controls which Storybook stories are included when generating fragments.
- */
-interface StorybookFilterConfig {
-    /** Glob-style patterns for component names to explicitly exclude */
-    exclude?: string[];
-    /** Glob-style patterns for component names to force-include (bypasses all heuristic filters) */
-    include?: string[];
-    /** Exclude stories with "Deprecated" in the title (default: true) */
-    excludeDeprecated?: boolean;
-    /** Exclude test stories (title ending /test(s) or *.test.stories.* files) (default: true) */
-    excludeTests?: boolean;
-    /** Exclude SVG icon components (names matching Svg[A-Z]*) (default: true) */
-    excludeSvgIcons?: boolean;
-    /** Exclude sub-components detected by directory structure (default: true) */
-    excludeSubComponents?: boolean;
-}
 /**
  * Theme seed configuration.
  * The 5 root values that derive 120+ CSS custom properties.
@@ -1028,8 +978,6 @@ interface ThemeSeeds {
     brand?: string;
     /** Neutral palette name */
     neutral?: "stone" | "ice" | "earth" | "sand" | "fire" | "fragments";
-    /** Spacing density scale */
-    density?: "compact" | "default" | "relaxed";
     /** Border radius style */
     radiusStyle?: "sharp" | "subtle" | "default" | "rounded" | "pill";
     /** Danger/error color as hex (e.g., "#ef4444") */
@@ -1093,8 +1041,6 @@ interface FragmentsConfig {
             bundleSize?: number;
         };
     };
-    /** Storybook adapter filtering configuration */
-    storybook?: StorybookFilterConfig;
     /** Theme seed values for the 5-seed theming system */
     theme?: ThemeSeeds;
     /**
@@ -1332,14 +1278,6 @@ interface BlockDefinition {
     code: string;
     tags?: string[];
 }
-/**
- * @deprecated Use BlockDefinition instead
- */
-type RecipeDefinition = BlockDefinition;
-/**
- * @deprecated Use CompiledBlock instead
- */
-type CompiledRecipe = CompiledBlock;
 
 declare const governanceSeveritySchema: z.ZodEnum<["error", "warn", "info"]>;
 type GovernanceSeverity = z.infer<typeof governanceSeveritySchema>;
@@ -1598,26 +1536,26 @@ declare const globalJsxGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
     }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "jsx.importPath.prefer";
+    severity: "error" | "info" | "warn";
     from: string;
     to: string;
-    severity: "error" | "info" | "warn";
+    because?: string | undefined;
     exclude?: (string | {
         glob: string;
         reason?: string | undefined;
     })[] | undefined;
     imported?: string | undefined;
-    because?: string | undefined;
 }, {
     kind: "jsx.importPath.prefer";
+    severity: "error" | "info" | "warn";
     from: string;
     to: string;
-    severity: "error" | "info" | "warn";
+    because?: string | undefined;
     exclude?: (string | {
         glob: string;
         reason?: string | undefined;
     })[] | undefined;
     imported?: string | undefined;
-    because?: string | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"jsx.component.prefer">;
     from: z.ZodString;
@@ -1636,24 +1574,24 @@ declare const globalJsxGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
     }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "jsx.component.prefer";
+    severity: "error" | "info" | "warn";
     from: string;
     to: string;
-    severity: "error" | "info" | "warn";
+    because?: string | undefined;
     exclude?: (string | {
         glob: string;
         reason?: string | undefined;
     })[] | undefined;
-    because?: string | undefined;
 }, {
     kind: "jsx.component.prefer";
+    severity: "error" | "info" | "warn";
     from: string;
     to: string;
-    severity: "error" | "info" | "warn";
+    because?: string | undefined;
     exclude?: (string | {
         glob: string;
         reason?: string | undefined;
     })[] | undefined;
-    because?: string | undefined;
 }>]>;
 declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodDefault<z.ZodLiteral<"scale">>;
@@ -1908,26 +1846,26 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "jsx.importPath.prefer";
+    severity: "error" | "info" | "warn";
     from: string;
     to: string;
-    severity: "error" | "info" | "warn";
+    because?: string | undefined;
     exclude?: (string | {
         glob: string;
         reason?: string | undefined;
     })[] | undefined;
     imported?: string | undefined;
-    because?: string | undefined;
 }, {
     kind: "jsx.importPath.prefer";
+    severity: "error" | "info" | "warn";
     from: string;
     to: string;
-    severity: "error" | "info" | "warn";
+    because?: string | undefined;
     exclude?: (string | {
         glob: string;
         reason?: string | undefined;
     })[] | undefined;
     imported?: string | undefined;
-    because?: string | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"jsx.component.prefer">;
     from: z.ZodString;
@@ -1946,24 +1884,24 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     kind: "jsx.component.prefer";
+    severity: "error" | "info" | "warn";
     from: string;
     to: string;
-    severity: "error" | "info" | "warn";
+    because?: string | undefined;
     exclude?: (string | {
         glob: string;
         reason?: string | undefined;
     })[] | undefined;
-    because?: string | undefined;
 }, {
     kind: "jsx.component.prefer";
+    severity: "error" | "info" | "warn";
     from: string;
     to: string;
-    severity: "error" | "info" | "warn";
+    because?: string | undefined;
     exclude?: (string | {
         glob: string;
         reason?: string | undefined;
     })[] | undefined;
-    because?: string | undefined;
 }>]>;
 declare const componentGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"capability">;
@@ -1977,28 +1915,28 @@ declare const componentGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"prop.value.avoid">;
     prop: z.ZodString;
-    value: z.ZodUnknown;
+    value: z.ZodType<unknown, z.ZodTypeDef, unknown>;
     because: z.ZodString;
     suggest: z.ZodOptional<z.ZodString>;
     severity: z.ZodEnum<["error", "warn", "info"]>;
 }, "strip", z.ZodTypeAny, {
     kind: "prop.value.avoid";
-    severity: "error" | "info" | "warn";
-    because: string;
     prop: string;
+    because: string;
+    severity: "error" | "info" | "warn";
     value?: unknown;
     suggest?: string | undefined;
 }, {
     kind: "prop.value.avoid";
-    severity: "error" | "info" | "warn";
-    because: string;
     prop: string;
+    because: string;
+    severity: "error" | "info" | "warn";
     value?: unknown;
     suggest?: string | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"prop.value.forbid">;
     prop: z.ZodString;
-    value: z.ZodUnknown;
+    value: z.ZodType<unknown, z.ZodTypeDef, unknown>;
     when: z.ZodOptional<z.ZodObject<{
         path: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
@@ -2008,7 +1946,7 @@ declare const componentGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
     }>>;
     because: z.ZodString;
     fix: z.ZodOptional<z.ZodObject<{
-        replaceWith: z.ZodUnknown;
+        replaceWith: z.ZodType<unknown, z.ZodTypeDef, unknown>;
     }, "strip", z.ZodTypeAny, {
         replaceWith?: unknown;
     }, {
@@ -2017,9 +1955,9 @@ declare const componentGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
     severity: z.ZodEnum<["error", "warn", "info"]>;
 }, "strip", z.ZodTypeAny, {
     kind: "prop.value.forbid";
-    severity: "error" | "info" | "warn";
-    because: string;
     prop: string;
+    because: string;
+    severity: "error" | "info" | "warn";
     value?: unknown;
     when?: {
         path?: string | undefined;
@@ -2029,9 +1967,9 @@ declare const componentGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
     } | undefined;
 }, {
     kind: "prop.value.forbid";
-    severity: "error" | "info" | "warn";
-    because: string;
     prop: string;
+    because: string;
+    severity: "error" | "info" | "warn";
     value?: unknown;
     when?: {
         path?: string | undefined;
@@ -2045,12 +1983,12 @@ declare const componentGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
     severity: z.ZodEnum<["error", "warn", "info"]>;
 }, "strip", z.ZodTypeAny, {
     kind: "a11y.requireName";
-    severity: "error" | "info" | "warn";
     because: string;
+    severity: "error" | "info" | "warn";
 }, {
     kind: "a11y.requireName";
-    severity: "error" | "info" | "warn";
     because: string;
+    severity: "error" | "info" | "warn";
 }>]>;
 declare const componentGovernanceRecordsSchema: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"capability">;
@@ -2064,28 +2002,28 @@ declare const componentGovernanceRecordsSchema: z.ZodArray<z.ZodDiscriminatedUni
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"prop.value.avoid">;
     prop: z.ZodString;
-    value: z.ZodUnknown;
+    value: z.ZodType<unknown, z.ZodTypeDef, unknown>;
     because: z.ZodString;
     suggest: z.ZodOptional<z.ZodString>;
     severity: z.ZodEnum<["error", "warn", "info"]>;
 }, "strip", z.ZodTypeAny, {
     kind: "prop.value.avoid";
-    severity: "error" | "info" | "warn";
-    because: string;
     prop: string;
+    because: string;
+    severity: "error" | "info" | "warn";
     value?: unknown;
     suggest?: string | undefined;
 }, {
     kind: "prop.value.avoid";
-    severity: "error" | "info" | "warn";
-    because: string;
     prop: string;
+    because: string;
+    severity: "error" | "info" | "warn";
     value?: unknown;
     suggest?: string | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"prop.value.forbid">;
     prop: z.ZodString;
-    value: z.ZodUnknown;
+    value: z.ZodType<unknown, z.ZodTypeDef, unknown>;
     when: z.ZodOptional<z.ZodObject<{
         path: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
@@ -2095,7 +2033,7 @@ declare const componentGovernanceRecordsSchema: z.ZodArray<z.ZodDiscriminatedUni
     }>>;
     because: z.ZodString;
     fix: z.ZodOptional<z.ZodObject<{
-        replaceWith: z.ZodUnknown;
+        replaceWith: z.ZodType<unknown, z.ZodTypeDef, unknown>;
     }, "strip", z.ZodTypeAny, {
         replaceWith?: unknown;
     }, {
@@ -2104,9 +2042,9 @@ declare const componentGovernanceRecordsSchema: z.ZodArray<z.ZodDiscriminatedUni
     severity: z.ZodEnum<["error", "warn", "info"]>;
 }, "strip", z.ZodTypeAny, {
     kind: "prop.value.forbid";
-    severity: "error" | "info" | "warn";
-    because: string;
     prop: string;
+    because: string;
+    severity: "error" | "info" | "warn";
     value?: unknown;
     when?: {
         path?: string | undefined;
@@ -2116,9 +2054,9 @@ declare const componentGovernanceRecordsSchema: z.ZodArray<z.ZodDiscriminatedUni
     } | undefined;
 }, {
     kind: "prop.value.forbid";
-    severity: "error" | "info" | "warn";
-    because: string;
     prop: string;
+    because: string;
+    severity: "error" | "info" | "warn";
     value?: unknown;
     when?: {
         path?: string | undefined;
@@ -2132,13 +2070,15 @@ declare const componentGovernanceRecordsSchema: z.ZodArray<z.ZodDiscriminatedUni
     severity: z.ZodEnum<["error", "warn", "info"]>;
 }, "strip", z.ZodTypeAny, {
     kind: "a11y.requireName";
-    severity: "error" | "info" | "warn";
     because: string;
+    severity: "error" | "info" | "warn";
 }, {
     kind: "a11y.requireName";
-    severity: "error" | "info" | "warn";
     because: string;
+    severity: "error" | "info" | "warn";
 }>]>, "many">;
+/** Parse portable component policy records; malformed authority is unavailable, never empty. */
+declare function parseComponentGovernancePolicyJson(policyJson: string): ComponentGovernanceRecord[] | null;
 declare const componentPolicyRecordSchema: z.ZodObject<{
     rules: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"capability">;
@@ -2152,28 +2092,28 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"prop.value.avoid">;
         prop: z.ZodString;
-        value: z.ZodUnknown;
+        value: z.ZodType<unknown, z.ZodTypeDef, unknown>;
         because: z.ZodString;
         suggest: z.ZodOptional<z.ZodString>;
         severity: z.ZodEnum<["error", "warn", "info"]>;
     }, "strip", z.ZodTypeAny, {
         kind: "prop.value.avoid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         suggest?: string | undefined;
     }, {
         kind: "prop.value.avoid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         suggest?: string | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"prop.value.forbid">;
         prop: z.ZodString;
-        value: z.ZodUnknown;
+        value: z.ZodType<unknown, z.ZodTypeDef, unknown>;
         when: z.ZodOptional<z.ZodObject<{
             path: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
@@ -2183,7 +2123,7 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
         }>>;
         because: z.ZodString;
         fix: z.ZodOptional<z.ZodObject<{
-            replaceWith: z.ZodUnknown;
+            replaceWith: z.ZodType<unknown, z.ZodTypeDef, unknown>;
         }, "strip", z.ZodTypeAny, {
             replaceWith?: unknown;
         }, {
@@ -2192,9 +2132,9 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
         severity: z.ZodEnum<["error", "warn", "info"]>;
     }, "strip", z.ZodTypeAny, {
         kind: "prop.value.forbid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         when?: {
             path?: string | undefined;
@@ -2204,9 +2144,9 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
         } | undefined;
     }, {
         kind: "prop.value.forbid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         when?: {
             path?: string | undefined;
@@ -2220,12 +2160,12 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
         severity: z.ZodEnum<["error", "warn", "info"]>;
     }, "strip", z.ZodTypeAny, {
         kind: "a11y.requireName";
-        severity: "error" | "info" | "warn";
         because: string;
+        severity: "error" | "info" | "warn";
     }, {
         kind: "a11y.requireName";
-        severity: "error" | "info" | "warn";
         because: string;
+        severity: "error" | "info" | "warn";
     }>]>, "many">;
     status: z.ZodOptional<z.ZodEnum<["active", "draft", "disabled"]>>;
 }, "strict", z.ZodTypeAny, {
@@ -2234,16 +2174,16 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
         capability: string;
     } | {
         kind: "prop.value.avoid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         suggest?: string | undefined;
     } | {
         kind: "prop.value.forbid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         when?: {
             path?: string | undefined;
@@ -2253,8 +2193,8 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
         } | undefined;
     } | {
         kind: "a11y.requireName";
-        severity: "error" | "info" | "warn";
         because: string;
+        severity: "error" | "info" | "warn";
     })[];
     status?: "active" | "draft" | "disabled" | undefined;
 }, {
@@ -2262,17 +2202,17 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
         kind: "capability";
         capability: string;
     } | {
-        kind: "prop.value.avoid";
-        severity: "error" | "info" | "warn";
-        because: string;
+        kind: "prop.value.avoid";
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         suggest?: string | undefined;
     } | {
         kind: "prop.value.forbid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         when?: {
             path?: string | undefined;
@@ -2282,8 +2222,8 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
         } | undefined;
     } | {
         kind: "a11y.requireName";
-        severity: "error" | "info" | "warn";
         because: string;
+        severity: "error" | "info" | "warn";
     })[];
     status?: "active" | "draft" | "disabled" | undefined;
 }>;
@@ -2301,9 +2241,9 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
         scope: z.ZodOptional<z.ZodEnum<["one", "all"]>>;
     }, "strict", z.ZodTypeAny, {
         path?: string | undefined;
+        name?: string | undefined;
         importPath?: string | undefined;
         componentId?: string | undefined;
-        name?: string | undefined;
         componentKey?: string | undefined;
         publicRef?: string | undefined;
         sourcePath?: string | undefined;
@@ -2312,9 +2252,9 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
         scope?: "one" | "all" | undefined;
     }, {
         path?: string | undefined;
+        name?: string | undefined;
         importPath?: string | undefined;
         componentId?: string | undefined;
-        name?: string | undefined;
         componentKey?: string | undefined;
         publicRef?: string | undefined;
         sourcePath?: string | undefined;
@@ -2334,28 +2274,28 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"prop.value.avoid">;
         prop: z.ZodString;
-        value: z.ZodUnknown;
+        value: z.ZodType<unknown, z.ZodTypeDef, unknown>;
         because: z.ZodString;
         suggest: z.ZodOptional<z.ZodString>;
         severity: z.ZodEnum<["error", "warn", "info"]>;
     }, "strip", z.ZodTypeAny, {
         kind: "prop.value.avoid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         suggest?: string | undefined;
     }, {
         kind: "prop.value.avoid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         suggest?: string | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"prop.value.forbid">;
         prop: z.ZodString;
-        value: z.ZodUnknown;
+        value: z.ZodType<unknown, z.ZodTypeDef, unknown>;
         when: z.ZodOptional<z.ZodObject<{
             path: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
@@ -2365,7 +2305,7 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
         }>>;
         because: z.ZodString;
         fix: z.ZodOptional<z.ZodObject<{
-            replaceWith: z.ZodUnknown;
+            replaceWith: z.ZodType<unknown, z.ZodTypeDef, unknown>;
         }, "strip", z.ZodTypeAny, {
             replaceWith?: unknown;
         }, {
@@ -2374,9 +2314,9 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
         severity: z.ZodEnum<["error", "warn", "info"]>;
     }, "strip", z.ZodTypeAny, {
         kind: "prop.value.forbid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         when?: {
             path?: string | undefined;
@@ -2386,9 +2326,9 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
         } | undefined;
     }, {
         kind: "prop.value.forbid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         when?: {
             path?: string | undefined;
@@ -2402,12 +2342,12 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
         severity: z.ZodEnum<["error", "warn", "info"]>;
     }, "strip", z.ZodTypeAny, {
         kind: "a11y.requireName";
-        severity: "error" | "info" | "warn";
         because: string;
+        severity: "error" | "info" | "warn";
     }, {
         kind: "a11y.requireName";
-        severity: "error" | "info" | "warn";
         because: string;
+        severity: "error" | "info" | "warn";
     }>]>, "many">;
     status: z.ZodOptional<z.ZodEnum<["active", "draft", "disabled"]>>;
 }, "strict", z.ZodTypeAny, {
@@ -2416,16 +2356,16 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
         capability: string;
     } | {
         kind: "prop.value.avoid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         suggest?: string | undefined;
     } | {
         kind: "prop.value.forbid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         when?: {
             path?: string | undefined;
@@ -2435,14 +2375,14 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
         } | undefined;
     } | {
         kind: "a11y.requireName";
-        severity: "error" | "info" | "warn";
         because: string;
+        severity: "error" | "info" | "warn";
     })[];
     match: {
         path?: string | undefined;
+        name?: string | undefined;
         importPath?: string | undefined;
         componentId?: string | undefined;
-        name?: string | undefined;
         componentKey?: string | undefined;
         publicRef?: string | undefined;
         sourcePath?: string | undefined;
@@ -2457,16 +2397,16 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
         capability: string;
     } | {
         kind: "prop.value.avoid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         suggest?: string | undefined;
     } | {
         kind: "prop.value.forbid";
-        severity: "error" | "info" | "warn";
-        because: string;
         prop: string;
+        because: string;
+        severity: "error" | "info" | "warn";
         value?: unknown;
         when?: {
             path?: string | undefined;
@@ -2476,14 +2416,14 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
         } | undefined;
     } | {
         kind: "a11y.requireName";
-        severity: "error" | "info" | "warn";
         because: string;
+        severity: "error" | "info" | "warn";
     })[];
     match: {
         path?: string | undefined;
+        name?: string | undefined;
         importPath?: string | undefined;
         componentId?: string | undefined;
-        name?: string | undefined;
         componentKey?: string | undefined;
         publicRef?: string | undefined;
         sourcePath?: string | undefined;
@@ -2568,14 +2508,14 @@ declare const canonicalSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObjec
     include: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    specifier: string;
     kind: "npm";
+    specifier: string;
     exclude?: string[] | undefined;
     implementationPath?: string | undefined;
     include?: string[] | undefined;
 }, {
-    specifier: string;
     kind: "npm";
+    specifier: string;
     exclude?: string[] | undefined;
     implementationPath?: string | undefined;
     include?: string[] | undefined;
@@ -2609,8 +2549,8 @@ declare const canonicalSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObjec
     registryId: string;
     receiptPath: string;
     installPath: string;
-    importPath?: string | undefined;
     severity?: "error" | "info" | "warn" | undefined;
+    importPath?: string | undefined;
     exclude?: string[] | undefined;
     include?: string[] | undefined;
     registryHash?: string | undefined;
@@ -2618,8 +2558,8 @@ declare const canonicalSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObjec
     kind: "registry";
     registryId: string;
     installPath: string;
-    importPath?: string | undefined;
     severity?: "error" | "info" | "warn" | undefined;
+    importPath?: string | undefined;
     exclude?: string[] | undefined;
     include?: string[] | undefined;
     registryHash?: string | undefined;
@@ -2645,14 +2585,14 @@ declare const governanceConfigSchema: z.ZodObject<{
         include: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
-        specifier: string;
         kind: "npm";
+        specifier: string;
         exclude?: string[] | undefined;
         implementationPath?: string | undefined;
         include?: string[] | undefined;
     }, {
-        specifier: string;
         kind: "npm";
+        specifier: string;
         exclude?: string[] | undefined;
         implementationPath?: string | undefined;
         include?: string[] | undefined;
@@ -2686,8 +2626,8 @@ declare const governanceConfigSchema: z.ZodObject<{
         registryId: string;
         receiptPath: string;
         installPath: string;
-        importPath?: string | undefined;
         severity?: "error" | "info" | "warn" | undefined;
+        importPath?: string | undefined;
         exclude?: string[] | undefined;
         include?: string[] | undefined;
         registryHash?: string | undefined;
@@ -2695,8 +2635,8 @@ declare const governanceConfigSchema: z.ZodObject<{
         kind: "registry";
         registryId: string;
         installPath: string;
-        importPath?: string | undefined;
         severity?: "error" | "info" | "warn" | undefined;
+        importPath?: string | undefined;
         exclude?: string[] | undefined;
         include?: string[] | undefined;
         registryHash?: string | undefined;
@@ -3056,26 +2996,26 @@ declare const governanceConfigSchema: z.ZodObject<{
         }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         kind: "jsx.importPath.prefer";
+        severity: "error" | "info" | "warn";
         from: string;
         to: string;
-        severity: "error" | "info" | "warn";
+        because?: string | undefined;
         exclude?: (string | {
             glob: string;
             reason?: string | undefined;
         })[] | undefined;
         imported?: string | undefined;
-        because?: string | undefined;
     }, {
         kind: "jsx.importPath.prefer";
+        severity: "error" | "info" | "warn";
         from: string;
         to: string;
-        severity: "error" | "info" | "warn";
+        because?: string | undefined;
         exclude?: (string | {
             glob: string;
             reason?: string | undefined;
         })[] | undefined;
         imported?: string | undefined;
-        because?: string | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"jsx.component.prefer">;
         from: z.ZodString;
@@ -3094,24 +3034,24 @@ declare const governanceConfigSchema: z.ZodObject<{
         }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         kind: "jsx.component.prefer";
+        severity: "error" | "info" | "warn";
         from: string;
         to: string;
-        severity: "error" | "info" | "warn";
+        because?: string | undefined;
         exclude?: (string | {
             glob: string;
             reason?: string | undefined;
         })[] | undefined;
-        because?: string | undefined;
     }, {
         kind: "jsx.component.prefer";
+        severity: "error" | "info" | "warn";
         from: string;
         to: string;
-        severity: "error" | "info" | "warn";
+        because?: string | undefined;
         exclude?: (string | {
             glob: string;
             reason?: string | undefined;
         })[] | undefined;
-        because?: string | undefined;
     }>]>, "many">>;
     tailwind: z.ZodOptional<z.ZodObject<{
         palette: z.ZodOptional<z.ZodObject<{
@@ -3167,28 +3107,28 @@ declare const governanceConfigSchema: z.ZodObject<{
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"prop.value.avoid">;
             prop: z.ZodString;
-            value: z.ZodUnknown;
+            value: z.ZodType<unknown, z.ZodTypeDef, unknown>;
             because: z.ZodString;
             suggest: z.ZodOptional<z.ZodString>;
             severity: z.ZodEnum<["error", "warn", "info"]>;
         }, "strip", z.ZodTypeAny, {
             kind: "prop.value.avoid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             suggest?: string | undefined;
         }, {
             kind: "prop.value.avoid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             suggest?: string | undefined;
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"prop.value.forbid">;
             prop: z.ZodString;
-            value: z.ZodUnknown;
+            value: z.ZodType<unknown, z.ZodTypeDef, unknown>;
             when: z.ZodOptional<z.ZodObject<{
                 path: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
@@ -3198,7 +3138,7 @@ declare const governanceConfigSchema: z.ZodObject<{
             }>>;
             because: z.ZodString;
             fix: z.ZodOptional<z.ZodObject<{
-                replaceWith: z.ZodUnknown;
+                replaceWith: z.ZodType<unknown, z.ZodTypeDef, unknown>;
             }, "strip", z.ZodTypeAny, {
                 replaceWith?: unknown;
             }, {
@@ -3207,9 +3147,9 @@ declare const governanceConfigSchema: z.ZodObject<{
             severity: z.ZodEnum<["error", "warn", "info"]>;
         }, "strip", z.ZodTypeAny, {
             kind: "prop.value.forbid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             when?: {
                 path?: string | undefined;
@@ -3219,9 +3159,9 @@ declare const governanceConfigSchema: z.ZodObject<{
             } | undefined;
         }, {
             kind: "prop.value.forbid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             when?: {
                 path?: string | undefined;
@@ -3235,12 +3175,12 @@ declare const governanceConfigSchema: z.ZodObject<{
             severity: z.ZodEnum<["error", "warn", "info"]>;
         }, "strip", z.ZodTypeAny, {
             kind: "a11y.requireName";
-            severity: "error" | "info" | "warn";
             because: string;
+            severity: "error" | "info" | "warn";
         }, {
             kind: "a11y.requireName";
-            severity: "error" | "info" | "warn";
             because: string;
+            severity: "error" | "info" | "warn";
         }>]>, "many">;
         status: z.ZodOptional<z.ZodEnum<["active", "draft", "disabled"]>>;
     }, "strict", z.ZodTypeAny, {
@@ -3249,16 +3189,16 @@ declare const governanceConfigSchema: z.ZodObject<{
             capability: string;
         } | {
             kind: "prop.value.avoid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             suggest?: string | undefined;
         } | {
             kind: "prop.value.forbid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             when?: {
                 path?: string | undefined;
@@ -3268,8 +3208,8 @@ declare const governanceConfigSchema: z.ZodObject<{
             } | undefined;
         } | {
             kind: "a11y.requireName";
-            severity: "error" | "info" | "warn";
             because: string;
+            severity: "error" | "info" | "warn";
         })[];
         status?: "active" | "draft" | "disabled" | undefined;
     }, {
@@ -3278,16 +3218,16 @@ declare const governanceConfigSchema: z.ZodObject<{
             capability: string;
         } | {
             kind: "prop.value.avoid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             suggest?: string | undefined;
         } | {
             kind: "prop.value.forbid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             when?: {
                 path?: string | undefined;
@@ -3297,8 +3237,8 @@ declare const governanceConfigSchema: z.ZodObject<{
             } | undefined;
         } | {
             kind: "a11y.requireName";
-            severity: "error" | "info" | "warn";
             because: string;
+            severity: "error" | "info" | "warn";
         })[];
         status?: "active" | "draft" | "disabled" | undefined;
     }>>>;
@@ -3316,9 +3256,9 @@ declare const governanceConfigSchema: z.ZodObject<{
             scope: z.ZodOptional<z.ZodEnum<["one", "all"]>>;
         }, "strict", z.ZodTypeAny, {
             path?: string | undefined;
+            name?: string | undefined;
             importPath?: string | undefined;
             componentId?: string | undefined;
-            name?: string | undefined;
             componentKey?: string | undefined;
             publicRef?: string | undefined;
             sourcePath?: string | undefined;
@@ -3327,9 +3267,9 @@ declare const governanceConfigSchema: z.ZodObject<{
             scope?: "one" | "all" | undefined;
         }, {
             path?: string | undefined;
+            name?: string | undefined;
             importPath?: string | undefined;
             componentId?: string | undefined;
-            name?: string | undefined;
             componentKey?: string | undefined;
             publicRef?: string | undefined;
             sourcePath?: string | undefined;
@@ -3349,28 +3289,28 @@ declare const governanceConfigSchema: z.ZodObject<{
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"prop.value.avoid">;
             prop: z.ZodString;
-            value: z.ZodUnknown;
+            value: z.ZodType<unknown, z.ZodTypeDef, unknown>;
             because: z.ZodString;
             suggest: z.ZodOptional<z.ZodString>;
             severity: z.ZodEnum<["error", "warn", "info"]>;
         }, "strip", z.ZodTypeAny, {
             kind: "prop.value.avoid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             suggest?: string | undefined;
         }, {
             kind: "prop.value.avoid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             suggest?: string | undefined;
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"prop.value.forbid">;
             prop: z.ZodString;
-            value: z.ZodUnknown;
+            value: z.ZodType<unknown, z.ZodTypeDef, unknown>;
             when: z.ZodOptional<z.ZodObject<{
                 path: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
@@ -3380,7 +3320,7 @@ declare const governanceConfigSchema: z.ZodObject<{
             }>>;
             because: z.ZodString;
             fix: z.ZodOptional<z.ZodObject<{
-                replaceWith: z.ZodUnknown;
+                replaceWith: z.ZodType<unknown, z.ZodTypeDef, unknown>;
             }, "strip", z.ZodTypeAny, {
                 replaceWith?: unknown;
             }, {
@@ -3389,9 +3329,9 @@ declare const governanceConfigSchema: z.ZodObject<{
             severity: z.ZodEnum<["error", "warn", "info"]>;
         }, "strip", z.ZodTypeAny, {
             kind: "prop.value.forbid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             when?: {
                 path?: string | undefined;
@@ -3401,9 +3341,9 @@ declare const governanceConfigSchema: z.ZodObject<{
             } | undefined;
         }, {
             kind: "prop.value.forbid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             when?: {
                 path?: string | undefined;
@@ -3417,12 +3357,12 @@ declare const governanceConfigSchema: z.ZodObject<{
             severity: z.ZodEnum<["error", "warn", "info"]>;
         }, "strip", z.ZodTypeAny, {
             kind: "a11y.requireName";
-            severity: "error" | "info" | "warn";
             because: string;
+            severity: "error" | "info" | "warn";
         }, {
             kind: "a11y.requireName";
-            severity: "error" | "info" | "warn";
             because: string;
+            severity: "error" | "info" | "warn";
         }>]>, "many">;
         status: z.ZodOptional<z.ZodEnum<["active", "draft", "disabled"]>>;
     }, "strict", z.ZodTypeAny, {
@@ -3431,16 +3371,16 @@ declare const governanceConfigSchema: z.ZodObject<{
             capability: string;
         } | {
             kind: "prop.value.avoid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             suggest?: string | undefined;
         } | {
             kind: "prop.value.forbid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             when?: {
                 path?: string | undefined;
@@ -3450,14 +3390,14 @@ declare const governanceConfigSchema: z.ZodObject<{
             } | undefined;
         } | {
             kind: "a11y.requireName";
-            severity: "error" | "info" | "warn";
             because: string;
+            severity: "error" | "info" | "warn";
         })[];
         match: {
             path?: string | undefined;
+            name?: string | undefined;
             importPath?: string | undefined;
             componentId?: string | undefined;
-            name?: string | undefined;
             componentKey?: string | undefined;
             publicRef?: string | undefined;
             sourcePath?: string | undefined;
@@ -3472,16 +3412,16 @@ declare const governanceConfigSchema: z.ZodObject<{
             capability: string;
         } | {
             kind: "prop.value.avoid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             suggest?: string | undefined;
         } | {
             kind: "prop.value.forbid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             when?: {
                 path?: string | undefined;
@@ -3491,14 +3431,14 @@ declare const governanceConfigSchema: z.ZodObject<{
             } | undefined;
         } | {
             kind: "a11y.requireName";
-            severity: "error" | "info" | "warn";
             because: string;
+            severity: "error" | "info" | "warn";
         })[];
         match: {
             path?: string | undefined;
+            name?: string | undefined;
             importPath?: string | undefined;
             componentId?: string | undefined;
-            name?: string | undefined;
             componentKey?: string | undefined;
             publicRef?: string | undefined;
             sourcePath?: string | undefined;
@@ -3528,16 +3468,16 @@ declare const governanceConfigSchema: z.ZodObject<{
             capability: string;
         } | {
             kind: "prop.value.avoid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             suggest?: string | undefined;
         } | {
             kind: "prop.value.forbid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             when?: {
                 path?: string | undefined;
@@ -3547,8 +3487,8 @@ declare const governanceConfigSchema: z.ZodObject<{
             } | undefined;
         } | {
             kind: "a11y.requireName";
-            severity: "error" | "info" | "warn";
             because: string;
+            severity: "error" | "info" | "warn";
         })[];
         status?: "active" | "draft" | "disabled" | undefined;
     }> | undefined;
@@ -3622,25 +3562,25 @@ declare const governanceConfigSchema: z.ZodObject<{
         })[] | undefined;
     } | {
         kind: "jsx.importPath.prefer";
+        severity: "error" | "info" | "warn";
         from: string;
         to: string;
-        severity: "error" | "info" | "warn";
+        because?: string | undefined;
         exclude?: (string | {
             glob: string;
             reason?: string | undefined;
         })[] | undefined;
         imported?: string | undefined;
-        because?: string | undefined;
     } | {
         kind: "jsx.component.prefer";
+        severity: "error" | "info" | "warn";
         from: string;
         to: string;
-        severity: "error" | "info" | "warn";
+        because?: string | undefined;
         exclude?: (string | {
             glob: string;
             reason?: string | undefined;
         })[] | undefined;
-        because?: string | undefined;
     })[] | undefined;
     tailwind?: z.objectOutputType<{
         palette: z.ZodOptional<z.ZodObject<{
@@ -3660,16 +3600,16 @@ declare const governanceConfigSchema: z.ZodObject<{
             capability: string;
         } | {
             kind: "prop.value.avoid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             suggest?: string | undefined;
         } | {
             kind: "prop.value.forbid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             when?: {
                 path?: string | undefined;
@@ -3679,14 +3619,14 @@ declare const governanceConfigSchema: z.ZodObject<{
             } | undefined;
         } | {
             kind: "a11y.requireName";
-            severity: "error" | "info" | "warn";
             because: string;
+            severity: "error" | "info" | "warn";
         })[];
         match: {
             path?: string | undefined;
+            name?: string | undefined;
             importPath?: string | undefined;
             componentId?: string | undefined;
-            name?: string | undefined;
             componentKey?: string | undefined;
             publicRef?: string | undefined;
             sourcePath?: string | undefined;
@@ -3703,8 +3643,8 @@ declare const governanceConfigSchema: z.ZodObject<{
     audit?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
     runners?: Record<string, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">> | undefined;
     canonicalSources?: ({
-        specifier: string;
         kind: "npm";
+        specifier: string;
         exclude?: string[] | undefined;
         implementationPath?: string | undefined;
         include?: string[] | undefined;
@@ -3718,8 +3658,8 @@ declare const governanceConfigSchema: z.ZodObject<{
         registryId: string;
         receiptPath: string;
         installPath: string;
-        importPath?: string | undefined;
         severity?: "error" | "info" | "warn" | undefined;
+        importPath?: string | undefined;
         exclude?: string[] | undefined;
         include?: string[] | undefined;
         registryHash?: string | undefined;
@@ -3756,16 +3696,16 @@ declare const governanceConfigSchema: z.ZodObject<{
             capability: string;
         } | {
             kind: "prop.value.avoid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             suggest?: string | undefined;
         } | {
             kind: "prop.value.forbid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             when?: {
                 path?: string | undefined;
@@ -3775,8 +3715,8 @@ declare const governanceConfigSchema: z.ZodObject<{
             } | undefined;
         } | {
             kind: "a11y.requireName";
-            severity: "error" | "info" | "warn";
             because: string;
+            severity: "error" | "info" | "warn";
         })[];
         status?: "active" | "draft" | "disabled" | undefined;
     }> | undefined;
@@ -3850,25 +3790,25 @@ declare const governanceConfigSchema: z.ZodObject<{
         })[] | undefined;
     } | {
         kind: "jsx.importPath.prefer";
+        severity: "error" | "info" | "warn";
         from: string;
         to: string;
-        severity: "error" | "info" | "warn";
+        because?: string | undefined;
         exclude?: (string | {
             glob: string;
             reason?: string | undefined;
         })[] | undefined;
         imported?: string | undefined;
-        because?: string | undefined;
     } | {
         kind: "jsx.component.prefer";
+        severity: "error" | "info" | "warn";
         from: string;
         to: string;
-        severity: "error" | "info" | "warn";
+        because?: string | undefined;
         exclude?: (string | {
             glob: string;
             reason?: string | undefined;
         })[] | undefined;
-        because?: string | undefined;
     })[] | undefined;
     tailwind?: z.objectInputType<{
         palette: z.ZodOptional<z.ZodObject<{
@@ -3888,16 +3828,16 @@ declare const governanceConfigSchema: z.ZodObject<{
             capability: string;
         } | {
             kind: "prop.value.avoid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             suggest?: string | undefined;
         } | {
             kind: "prop.value.forbid";
-            severity: "error" | "info" | "warn";
-            because: string;
             prop: string;
+            because: string;
+            severity: "error" | "info" | "warn";
             value?: unknown;
             when?: {
                 path?: string | undefined;
@@ -3907,14 +3847,14 @@ declare const governanceConfigSchema: z.ZodObject<{
             } | undefined;
         } | {
             kind: "a11y.requireName";
-            severity: "error" | "info" | "warn";
             because: string;
+            severity: "error" | "info" | "warn";
         })[];
         match: {
             path?: string | undefined;
+            name?: string | undefined;
             importPath?: string | undefined;
             componentId?: string | undefined;
-            name?: string | undefined;
             componentKey?: string | undefined;
             publicRef?: string | undefined;
             sourcePath?: string | undefined;
@@ -3931,8 +3871,8 @@ declare const governanceConfigSchema: z.ZodObject<{
     audit?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
     runners?: Record<string, z.objectInputType<{}, z.ZodTypeAny, "passthrough">> | undefined;
     canonicalSources?: ({
-        specifier: string;
         kind: "npm";
+        specifier: string;
         exclude?: string[] | undefined;
         implementationPath?: string | undefined;
         include?: string[] | undefined;
@@ -3945,8 +3885,8 @@ declare const governanceConfigSchema: z.ZodObject<{
         kind: "registry";
         registryId: string;
         installPath: string;
-        importPath?: string | undefined;
         severity?: "error" | "info" | "warn" | undefined;
+        importPath?: string | undefined;
         exclude?: string[] | undefined;
         include?: string[] | undefined;
         registryHash?: string | undefined;
@@ -4118,7 +4058,12 @@ interface ComponentGovernanceBuilder<TProps> {
     prop<TKey extends PropKey<TProps>>(prop: TKey): PropGovernanceBuilder<TProps[TKey]>;
     accessibility(): AccessibilityGovernanceBuilder;
 }
-interface GovernedFragmentDefinition<TProps = unknown, TComponent extends FragmentComponent<TProps> = FragmentComponent<TProps>> {
+/**
+ * One-argument governed definition. Requires an explicit `govern` function
+ * and/or `governance` records — both optional keys previously let plain v2
+ * definitions satisfy this type (the optional-key type lie).
+ */
+type GovernedFragmentDefinitionBase<TProps = unknown, TComponent extends FragmentComponent<TProps> = FragmentComponent<TProps>> = {
     component: TComponent;
     meta: FragmentMeta;
     guidance: FragmentGuidance;
@@ -4133,12 +4078,26 @@ interface GovernedFragmentDefinition<TProps = unknown, TComponent extends Fragme
     };
     contract?: FragmentContract;
     _provenance?: FragmentProvenance;
-    govern?: (g: ComponentGovernanceBuilder<TProps>) => ComponentGovernanceRecord[];
+};
+type GovernedFragmentDefinition<TProps = unknown, TComponent extends FragmentComponent<TProps> = FragmentComponent<TProps>> = GovernedFragmentDefinitionBase<TProps, TComponent> & ({
+    govern: (g: ComponentGovernanceBuilder<TProps>) => ComponentGovernanceRecord[];
     governance?: ComponentGovernanceRecord[];
-}
+} | {
+    governance: ComponentGovernanceRecord[];
+    govern?: (g: ComponentGovernanceBuilder<TProps>) => ComponentGovernanceRecord[];
+});
 type ResolvedGovernedFragmentDefinition<TProps = unknown, TComponent extends FragmentComponent<TProps> = FragmentComponent<TProps>> = GovernedFragmentDefinition<TProps, TComponent> & {
     governance: ComponentGovernanceRecord[];
 };
+declare function resolveComponentGovernance<TProps>(definition: GovernedFragmentDefinition<TProps>): ComponentGovernanceRecord[];
+/**
+ * Resolve the component governance records that belong in the FCID preimage.
+ *
+ * Prefer an already-resolved `governance` array (Cloud mint / compiled payloads).
+ * Fall back to evaluating `govern` when present. Returns `undefined` when the
+ * fragment carries no governance surface — callers omit the field from identity.
+ */
+declare function resolveGovernanceRecordsForIdentity(definition: Pick<GovernedFragmentDefinition, "govern" | "governance"> | null | undefined): ComponentGovernanceRecord[] | undefined;
 declare function normalizeGovernanceConfig<TConfig extends {
     govern?: GovernanceConfig;
 }>(config: TConfig): TConfig;
@@ -4189,4 +4148,4 @@ declare const g: {
     component: ComponentGovernanceBuilder<Record<string, unknown>>;
 };
 
-export { type ControlType as $, type AIMetadata as A, type BlockDefinition as B, type CompiledBlock as C, type CanonicalMappingStatus as D, type CompiledFragmentsFile as E, type FragmentDefinition as F, type GovernanceSeverity as G, CompiledFragmentsFileValidationError as H, type CompiledRecipe as I, type CompiledTokenData as J, type CompiledTokenEntry as K, type ComponentGovernanceBuilder as L, type ComponentGovernanceRecord as M, type ComponentRef as N, type ComponentRelation as O, type CompositionMetadata as P, type ContractComponentInput as Q, type ResolvedGovernedFragmentDefinition as R, type StorybookFilterConfig as S, type TokenConfig as T, type ContractIdentityPin as U, type VariantRenderOptions as V, type ContractPolicyInput as W, type ContractPreimage as X, type ContractPropMappingInput as Y, type ContractTokenInput as Z, type ContractWaiverInput as _, type VariantLoader as a, projectContractPreimage as a$, type DesignSystemConfig as a0, type DiffResult as a1, type FigmaPropMapping as a2, type FragmentContract as a3, type FragmentExample as a4, type FragmentGenerated as a5, type FragmentGuidance as a6, type FragmentMeta as a7, type FragmentProvenance as a8, type FragmentUsage as a9, type SnapshotConfig as aA, type SnippetPolicyConfig as aB, type Theme as aC, type ThemeSeeds as aD, type TokenSourceConfig as aE, type TokenSourceFormat as aF, type VerifyRequest as aG, type VerifyResult as aH, type Viewport as aI, canonicalBridgeV1Schema as aJ, componentGovernanceRecordSchema as aK, componentGovernanceRecordsSchema as aL, contractComponentsFromFragments as aM, contractPolicyFromGovernanceConfig as aN, diffContractDomains as aO, g as aP, globalGovernanceRecordSchema as aQ, globalJsxGovernanceRecordSchema as aR, globalStyleGovernanceRecordSchema as aS, governanceConfigSchema as aT, governanceConfigWithLocalCanonical as aU, governanceSeveritySchema as aV, isPresetSourcedRule as aW, localCanonicalContractMappings as aX, markPresetSourcedRules as aY, normalizeGovernanceConfig as aZ, parseCompiledFragmentsFile as a_, type FragmentVariant as aa, type GlobalGovernanceRecord as ab, type GlobalJsxGovernanceRecord as ac, type GlobalStyleGovernanceRecord as ad, type GovernancePropValue as ae, type InspectConfig as af, type LocalCanonicalDeclaration as ag, type LocalCanonicalResolveRule as ah, type Manifest as ai, type ObservedComponentUsage as aj, type ObservedUsageProp as ak, type PlayFunction as al, type PlayFunctionContext as am, type PropDefinition as an, type PropGovernanceBuilder as ao, type PropGovernanceOptions as ap, type PropKey as aq, type PropType as ar, type RecipeDefinition as as, type RegistryOptions as at, type RepoRelativePath as au, type ScaleGovernanceRecord as av, type Screenshot as aw, type ScreenshotConfig as ax, type ScreenshotMetadata as ay, type ServiceConfig as az, type FragmentDefinitionV2 as b, scaleGovernanceRecordSchema as b0, verifiedContractPreimageFromPin as b1, type AIMetadata$1 as b2, type ComponentRelation$1 as b3, type FragmentContract$1 as b4, type FragmentGenerated$1 as b5, type FragmentMeta$1 as b6, type FragmentUsage$1 as b7, type ImportEntry as b8, type PerformanceData as b9, type PerformanceSummary as ba, type PropDefinition$1 as bb, type Theme$1 as bc, type VerifyResult$1 as bd, type CompiledFragment as c, type ContractDomain as d, type ContractCatalogInput as e, type GovernedFragmentDefinition as f, type GovernanceConfig as g, type FragmentsConfig as h, type FragmentComponent as i, type FigmaStringMapping as j, type FigmaBooleanMapping as k, type FigmaEnumMapping as l, type FigmaInstanceMapping as m, type FigmaChildrenMapping as n, type FigmaTextContentMapping as o, type RelationshipType as p, type CanonicalSource as q, type CanonicalBridgeV1 as r, type ContractCanonicalMappingInput as s, type AccessibilityGovernanceBuilder as t, type AppConfig as u, type BaselineInfo as v, type BoundingBox as w, CONTRACT_DOMAINS as x, CONTRACT_PREIMAGE_CAPABILITY_HEADER as y, CONTRACT_PREIMAGE_SCHEMA as z };
+export { type ContractComponentInput as $, type CanonicalBridgeV1 as A, type BlockDefinition as B, type ComponentGovernanceRecord as C, type ContractCanonicalMappingInput as D, type ContractPreimage as E, type FragmentDefinition as F, type GovernanceSeverity as G, type AIMetadata as H, type AccessibilityGovernanceBuilder as I, type AppConfig as J, type BaselineInfo as K, type BoundingBox as L, CONTRACT_DISPLAY_ONLY_FIELDS as M, CONTRACT_DOMAINS as N, CONTRACT_ENFORCEMENT_FIELDS as O, type PropAnnotation as P, CONTRACT_PREIMAGE_CAPABILITY_HEADER as Q, type ResolvedGovernedFragmentDefinition as R, CONTRACT_PREIMAGE_SCHEMA as S, type TokenConfig as T, type CanonicalMappingStatus as U, type VariantRenderOptions as V, type ComponentGovernanceBuilder as W, type ComponentRef as X, type ComponentRelation as Y, type CompositionMetadata as Z, ContractCatalogValidationError as _, type FragmentDefinitionV2 as a, globalJsxGovernanceRecordSchema as a$, type ContractEnforcementField as a0, type ContractIdentityPin as a1, type ContractPolicyInput as a2, type ContractPropMappingInput as a3, type ContractTokenInput as a4, type ContractWaiverInput as a5, type ControlType as a6, type DesignSystemConfig as a7, type DiffResult as a8, type FigmaPropMapping as a9, type RegistryComponentEntry as aA, type RegistryOptions as aB, type RegistryPropEntry as aC, type RepoRelativePath as aD, type ScaleGovernanceRecord as aE, type Screenshot as aF, type ScreenshotConfig as aG, type ScreenshotMetadata as aH, type ServiceConfig as aI, type SnapshotConfig as aJ, type SnippetPolicyConfig as aK, type Theme as aL, type ThemeSeeds as aM, type TokenSourceConfig as aN, type TokenSourceFormat as aO, type VerifyRequest as aP, type VerifyResult as aQ, type Viewport as aR, canonicalBridgeV1Schema as aS, componentGovernanceRecordSchema as aT, componentGovernanceRecordsSchema as aU, contractComponentsFromFragments as aV, contractPolicyFromGovernanceConfig as aW, deriveArtifactId as aX, diffContractDomains as aY, g as aZ, globalGovernanceRecordSchema as a_, type FragmentContextOptions as aa, type FragmentContract as ab, type FragmentExample as ac, type FragmentGenerated as ad, type FragmentGuidance as ae, type FragmentIndex as af, type FragmentMeta as ag, type FragmentProvenance as ah, type FragmentRegistry as ai, type FragmentUsage as aj, type FragmentVariant as ak, type GlobalGovernanceRecord as al, type GlobalJsxGovernanceRecord as am, type GlobalStyleGovernanceRecord as an, type GovernancePropValue as ao, type InspectConfig as ap, type LocalCanonicalDeclaration as aq, type LocalCanonicalResolveRule as ar, type Manifest as as, type PlayFunction as at, type PlayFunctionContext as au, type PropDefinition as av, type PropGovernanceBuilder as aw, type PropGovernanceOptions as ax, type PropKey as ay, type PropType as az, type VariantLoader as b, globalStyleGovernanceRecordSchema as b0, governanceConfigSchema as b1, governanceConfigWithLocalCanonical as b2, governanceSeveritySchema as b3, isPresetSourcedRule as b4, localCanonicalContractMappings as b5, markPresetSourcedRules as b6, normalizeGovernanceConfig as b7, parseComponentGovernancePolicyJson as b8, projectContractPreimage as b9, projectEnforcementContract as ba, resolveComponentGovernance as bb, resolveGovernanceRecordsForIdentity as bc, scaleGovernanceRecordSchema as bd, verifiedContractPreimageFromPin as be, type ContractDomain as c, type ContractCatalogInput as d, type GovernedFragmentDefinition as e, type GovernanceConfig as f, type FragmentsConfig as g, type FragmentAnnotationsV3 as h, type FragmentDefinitionV3Body as i, type FragmentDefinitionV3 as j, type FragmentDesignV3 as k, type FragmentDontExampleV3 as l, type FragmentGuidanceV3 as m, type FragmentMatrixV3 as n, type FragmentMetaV3 as o, type FragmentPreviewV3 as p, type FragmentStateV3 as q, type FragmentComponent as r, type FigmaStringMapping as s, type FigmaBooleanMapping as t, type FigmaEnumMapping as u, type FigmaInstanceMapping as v, type FigmaChildrenMapping as w, type FigmaTextContentMapping as x, type RelationshipType as y, type CanonicalSource as z };