@usefragments/core 1.5.0 → 1.5.2

package/dist/{chunk-57QDBEHQ.js → chunk-ZHS52OT4.js}

@@ -188,18 +188,12 @@ var agentRunProvenanceSchema = z.object({
   fcid: z.string().min(1),
   baselineId: z.string().min(1).optional(),
   scope: z.object({
-    method: z.enum([
-      "three-dot",
-      "tree-diff",
-      "status",
-      "fallback-full",
-      "explicit",
-      "full"
-    ]),
+    method: z.enum(["three-dot", "tree-diff", "status", "fallback-full", "explicit", "full"]),
     gitOk: z.boolean()
   }),
   engineVersion: z.string().min(1),
   scopeHash: z.string().regex(/^[a-f0-9]{64}$/),
+  inputsHash: z.string().regex(/^[a-f0-9]{64}$/).optional(),
   inputFilesHash: z.string().regex(/^[a-f0-9]{64}$/)
 });
 var agentRunVerdictSchema = z.object({
@@ -320,4 +314,4 @@ export {
   normalizeFinding,
   normalizeViolation
 };
-//# sourceMappingURL=chunk-57QDBEHQ.js.map
+//# sourceMappingURL=chunk-ZHS52OT4.js.map

package/dist/chunk-ZHS52OT4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/index.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport {\n  legacySeverityLevelSchema,\n  severityFromLevel,\n  severityLevel,\n  severityLevelSchema,\n  severitySchema,\n} from \"../severity.js\";\nimport type { LegacySeverityLevel, Severity } from \"../severity.js\";\nimport type { EvidenceGrade } from \"../evidence.js\";\n\nconst evidenceGradeSchema: z.ZodType<EvidenceGrade> = z.enum([\n  \"none\",\n  \"runtime_advisory\",\n  \"provenance_bound\",\n  \"source_backed\",\n  \"receipt_backed\",\n]);\n\nexport { legacySeverityLevelSchema, severityLevelSchema, severitySchema };\nexport type { LegacySeverityLevel, Severity, SeverityLevel } from \"../severity.js\";\n\nexport const factLocationSchema = z.object({\n  file: z.string(),\n  line: z.number().int().nonnegative(),\n  column: z.number().int().nonnegative(),\n  endLine: z.number().int().nonnegative().optional(),\n  endColumn: z.number().int().nonnegative().optional(),\n});\nexport type FactLocation = z.infer<typeof factLocationSchema>;\n\nexport const findingReplacePropValueFixSchema = z.object({\n  kind: z.literal(\"replacePropValue\"),\n  title: z.string(),\n  prop: z.string(),\n  value: z.unknown(),\n  deterministic: z.boolean().optional(),\n});\n\nexport const findingReplaceStyleValueFixSchema = z.object({\n  kind: z.literal(\"replaceStyleValue\"),\n  title: z.string(),\n  property: z.string(),\n  value: z.string(),\n  deterministic: z.boolean().optional(),\n});\n\nexport const findingReplaceImportFixSchema = z.object({\n  kind: z.literal(\"replaceImport\"),\n  title: z.string(),\n  from: z.string(),\n  to: z.string(),\n  deterministic: z.boolean().optional(),\n});\n\nexport const findingReplaceComponentFixSchema = z.object({\n  kind: z.literal(\"replaceComponent\"),\n  title: z.string(),\n  from: z.string(),\n  to: z.string(),\n  deterministic: z.boolean().optional(),\n});\n\nexport const findingReplaceClassTokenFixSchema = z.object({\n  kind: z.literal(\"replaceClassToken\"),\n  title: z.string(),\n  from: z.string(),\n  to: z.string().nullable(),\n  utility: z.string(),\n  deterministic: z.boolean().optional(),\n});\n\nexport const findingFixSchema = z.discriminatedUnion(\"kind\", [\n  findingReplacePropValueFixSchema,\n  findingReplaceStyleValueFixSchema,\n  findingReplaceImportFixSchema,\n  findingReplaceComponentFixSchema,\n  findingReplaceClassTokenFixSchema,\n]);\nexport type FindingFix = z.infer<typeof findingFixSchema>;\nexport type FindingReplacePropValueFix = z.infer<typeof findingReplacePropValueFixSchema>;\nexport type FindingReplaceStyleValueFix = z.infer<typeof findingReplaceStyleValueFixSchema>;\nexport type FindingReplaceImportFix = z.infer<typeof findingReplaceImportFixSchema>;\nexport type FindingReplaceComponentFix = z.infer<typeof findingReplaceComponentFixSchema>;\nexport type FindingReplaceClassTokenFix = z.infer<typeof findingReplaceClassTokenFixSchema>;\n\nexport interface FactEvidence {\n  factId: string;\n  fact: {\n    kind: string;\n    location?: FactLocation;\n  };\n}\n\nexport const factEvidenceSchema: z.ZodType<FactEvidence> = z.object({\n  factId: z.string(),\n  fact: z\n    .object({\n      kind: z.string(),\n      location: factLocationSchema.optional(),\n    })\n    .passthrough(),\n});\n\nexport const findingSchema = z.object({\n  ruleId: z.string(),\n  ruleVersion: z.string(),\n  severity: severitySchema,\n  level: severityLevelSchema,\n  code: z\n    .string()\n    .regex(/^FUI\\d{4}$/)\n    .optional(),\n  helpUrl: z.string().url().optional(),\n  message: z.string(),\n  fingerprint: z.string(),\n  location: factLocationSchema,\n  evidence: z.array(factEvidenceSchema).min(1),\n  evidenceGrade: evidenceGradeSchema.optional(),\n  fix: findingFixSchema.optional(),\n  attributes: z.record(z.unknown()).optional(),\n  /**\n   * Product area this finding's file resolved to (topology layer). Optional —\n   * absent when the repo has no `topology` config. See `topology/resolve-area`.\n   */\n  area: z\n    .object({\n      areaId: z.string(),\n      areaName: z.string(),\n      criticality: z.enum([\"low\", \"medium\", \"high\", \"revenue\", \"regulated\"]),\n      owners: z.array(z.string()),\n      matchedGlob: z.string(),\n    })\n    .optional(),\n});\nexport type Finding = z.infer<typeof findingSchema>;\n\nexport const violationSchema = z.object({\n  nodeId: z.string(),\n  nodeType: z.string(),\n  rule: z.string(),\n  severity: severitySchema,\n  level: severityLevelSchema.optional(),\n  code: z\n    .string()\n    .regex(/^FUI\\d{4}$/)\n    .optional(),\n  helpUrl: z.string().url().optional(),\n  message: z.string(),\n  path: z.string().optional(),\n  suggestion: z.string().optional(),\n  prop: z.string().optional(),\n  filePath: z.string().optional(),\n  line: z.number().int().nonnegative().optional(),\n  column: z.number().int().nonnegative().optional(),\n  rawValue: z.string().optional(),\n  extra: z.record(z.unknown()).optional(),\n});\nexport type Violation = z.infer<typeof violationSchema>;\n\nexport const fixSchema = z.object({\n  nodeId: z.string(),\n  prop: z.string().optional(),\n  action: z.enum([\"remove\", \"replace\", \"add\"]),\n  value: z.unknown().optional(),\n  description: z.string(),\n});\nexport type Fix = z.infer<typeof fixSchema>;\n\nexport const validatorResultSchema = z.object({\n  validator: z.string(),\n  severity: severitySchema,\n  passed: z.boolean(),\n  violations: z.array(violationSchema),\n  findings: z.array(findingSchema).optional(),\n  suggestions: z.array(fixSchema).optional(),\n});\nexport type ValidatorResult = z.infer<typeof validatorResultSchema>;\n\nexport const governanceVerdictMetadataSchema = z.object({\n  runner: z.string(),\n  policyVersion: z.string().optional(),\n  duration: z.number().nonnegative(),\n  nodeCount: z.number().int().nonnegative(),\n  componentTypes: z.array(z.string()),\n});\nexport type GovernanceVerdictMetadata = z.infer<typeof governanceVerdictMetadataSchema>;\n\nexport const governanceVerdictSchema = z.object({\n  verdict: z.enum([\"pass\", \"warn\", \"fail\"]).optional(),\n  passed: z.boolean(),\n  score: z.number(),\n  results: z.array(validatorResultSchema),\n  metadata: governanceVerdictMetadataSchema,\n});\nexport type GovernanceVerdict = z.infer<typeof governanceVerdictSchema>;\n\nexport const suppressionDirectiveSchema = z.object({\n  ruleId: z.string().optional(),\n  reason: z.string().min(1),\n  expiresAt: z.string().datetime().optional(),\n  expiresOn: z\n    .string()\n    .regex(/^\\d{4}-\\d{2}-\\d{2}$/)\n    .optional(),\n  scope: z.enum([\"line\", \"block\", \"file\"]).default(\"line\"),\n  code: z\n    .string()\n    .regex(/^FUI\\d{4}$/)\n    .optional(),\n});\nexport type SuppressionDirective = z.infer<typeof suppressionDirectiveSchema>;\n\nexport const agentPlanSchema = z.object({\n  tool: z.enum([\n    \"design_system/list_primitives\",\n    \"design_system/conform\",\n    \"design_system/prove_compliant\",\n  ]),\n  args: z.record(z.unknown()),\n  confidence: z.number().min(0).max(1),\n});\n\nexport const agentFindingSchema = z.object({\n  code: z\n    .string()\n    .regex(/^FUI\\d{4}$/)\n    .optional(),\n  ruleId: z.string(),\n  filePath: z.string(),\n  line: z.number().int().nonnegative(),\n  col: z.number().int().nonnegative(),\n  severity: severitySchema,\n  level: severityLevelSchema,\n  message: z.string(),\n  evidenceGrade: evidenceGradeSchema.optional(),\n  evidence: z.array(factEvidenceSchema),\n  plan: agentPlanSchema,\n});\n\nexport const AGENT_FORMAT_SCHEMA_VERSION = \"typestyle.agent.v2\" as const;\n\nexport const agentIntegritySchema = z.object({\n  rulesLoaded: z.number().int().nonnegative(),\n  status: z.enum([\"healthy\", \"degraded\", \"inert\"]),\n  healthy: z.boolean(),\n  inert: z.boolean(),\n  reasons: z.array(z.string()),\n});\n\nconst agentRunProvenanceSchema = z.object({\n  runId: z.string().regex(/^run_[a-f0-9]{12}$/),\n  fcid: z.string().min(1),\n  baselineId: z.string().min(1).optional(),\n  scope: z.object({\n    method: z.enum([\"three-dot\", \"tree-diff\", \"status\", \"fallback-full\", \"explicit\", \"full\"]),\n    gitOk: z.boolean(),\n  }),\n  engineVersion: z.string().min(1),\n  scopeHash: z.string().regex(/^[a-f0-9]{64}$/),\n  inputsHash: z\n    .string()\n    .regex(/^[a-f0-9]{64}$/)\n    .optional(),\n  inputFilesHash: z.string().regex(/^[a-f0-9]{64}$/),\n});\n\nconst agentRunVerdictSchema = z.object({\n  exitCode: z.union([z.literal(0), z.literal(1)]),\n  reasons: z.array(z.string()),\n  gatingFindingCount: z.number().int().nonnegative(),\n});\n\nconst agentFormatBaseSchema = z.object({\n  schemaVersion: z.literal(AGENT_FORMAT_SCHEMA_VERSION),\n  summary: z.string(),\n  integrity: agentIntegritySchema,\n  fix_first: z.array(agentFindingSchema),\n  remaining: z.array(agentFindingSchema),\n  suppression_template: z.object({\n    directive: z.string(),\n    requiredFields: z.array(z.string()),\n    example: z.string(),\n  }),\n  budget: z.object({\n    iteration: z.number().int().nonnegative(),\n    maxIterations: z.number().int().positive(),\n    scoreDelta: z.number(),\n  }),\n  findings: z.array(findingSchema).optional(),\n  suppressions: z.array(suppressionDirectiveSchema).optional(),\n  provenance: agentRunProvenanceSchema.optional(),\n  verdict: agentRunVerdictSchema.optional(),\n});\n\nexport const agentFormatSchema = z.union([\n  agentFormatBaseSchema.extend({\n    passed: z.boolean(),\n    score: z.number(),\n    status: z.never().optional(),\n    reasons: z.never().optional(),\n    integrity: agentIntegritySchema.extend({\n      rulesLoaded: z.number().int().positive(),\n    }),\n  }),\n  agentFormatBaseSchema.extend({\n    passed: z.literal(false),\n    score: z.never().optional(),\n    status: z.literal(\"indeterminate\"),\n    reasons: z.tuple([z.literal(\"zero_rules_loaded\")]),\n    integrity: agentIntegritySchema.extend({\n      rulesLoaded: z.literal(0),\n    }),\n  }),\n  // A finalized Run can explicitly allow inert governance. Preserve the\n  // indeterminate integrity truth while making `passed` match that Run's sole\n  // verdict; requiring Run pins prevents generic zero-rule envelopes from\n  // accidentally becoming green.\n  agentFormatBaseSchema.extend({\n    passed: z.literal(true),\n    score: z.never().optional(),\n    status: z.literal(\"indeterminate\"),\n    reasons: z.tuple([z.literal(\"zero_rules_loaded\")]),\n    integrity: agentIntegritySchema.extend({\n      rulesLoaded: z.literal(0),\n    }),\n    provenance: agentRunProvenanceSchema,\n    verdict: agentRunVerdictSchema.extend({ exitCode: z.literal(0) }),\n  }),\n]);\nexport type AgentFormat = z.infer<typeof agentFormatSchema>;\n\nexport const agentErrorEnvelopeSchema = z.object({\n  schemaVersion: z.literal(AGENT_FORMAT_SCHEMA_VERSION),\n  passed: z.literal(false),\n  error: z.object({\n    code: z.string().min(1),\n    message: z.string().min(1),\n  }),\n  provenance: agentRunProvenanceSchema.optional(),\n  verdict: agentRunVerdictSchema.optional(),\n  cloudReport: z.enum([\"reported\", \"failed\", \"skipped\"]).optional(),\n  notices: z.array(z.string()).optional(),\n});\nexport type AgentErrorEnvelope = z.infer<typeof agentErrorEnvelopeSchema>;\n\nexport const agentOutputSchema = z.union([agentFormatSchema, agentErrorEnvelopeSchema]);\nexport type AgentOutput = z.infer<typeof agentOutputSchema>;\n\nexport function normalizeSeverity(severity: Severity | LegacySeverityLevel): Severity {\n  return severitySchema.safeParse(severity).success\n    ? (severity as Severity)\n    : severityFromLevel(legacySeverityLevelSchema.parse(severity));\n}\n\nexport function normalizeFinding(\n  input: Omit<Finding, \"level\"> & { level?: Finding[\"level\"] }\n): Finding {\n  return {\n    ...input,\n    evidenceGrade: input.evidenceGrade ?? \"source_backed\",\n    level: input.level ?? severityLevel(input.severity),\n  };\n}\n\nexport function normalizeViolation(\n  input: Omit<Violation, \"level\"> & { level?: Violation[\"level\"] }\n): Violation {\n  return {\n    ...input,\n    level: input.level ?? severityLevel(input.severity),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/codes/index.d.ts

@@ -1,5 +1,5 @@
 import { Severity } from '../severity.js';
-import { n as Violation, F as Finding } from '../index-h_yWj15D.js';
+import { n as Violation, F as Finding } from '../index-DbkPE46t.js';
 import 'zod';
 
 declare const EXPLAIN_URL_BASE = "https://usefragments.com/errors/";
@@ -17,7 +17,7 @@ interface FuiCode {
     fixAvailable: boolean;
     evidenceRequired: boolean;
 }
-declare const CODES: readonly [FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode];
+declare const CODES: readonly [FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode, FuiCode];
 declare const byCode: ReadonlyMap<string, FuiCode>;
 declare const byRuleId: ReadonlyMap<string, FuiCode>;
 declare function explainUrlForCode(code: string): string;

package/dist/codes/index.js

@@ -6,8 +6,8 @@ import {
   byCode,
   byRuleId,
   explainUrlForCode
-} from "../chunk-HXGE3O2F.js";
-import "../chunk-57QDBEHQ.js";
+} from "../chunk-BAHCOAVG.js";
+import "../chunk-ZHS52OT4.js";
 import "../chunk-JNBFJ34I.js";
 import "../chunk-EIYNNS77.js";
 import "../chunk-V4VQB57N.js";

package/dist/compiled-types/index.d.ts

@@ -1,5 +1,5 @@
 import '../types-xJ2xyp_G.js';
-export { aY as AIMetadata, C as CompiledBlock, b as CompiledFragment, z as CompiledFragmentsFile, E as CompiledTokenData, H as CompiledTokenEntry, aZ as ComponentRelation, a_ as FragmentContract, a$ as FragmentGenerated, b0 as FragmentMeta, b1 as FragmentUsage, b2 as ImportEntry, ah as ObservedComponentUsage, ai as ObservedUsageProp, b3 as PerformanceData, b4 as PerformanceSummary, b5 as PropDefinition, b6 as Theme, b7 as VerifyResult } from '../governance-BLsyk56o.js';
+export { a_ as AIMetadata, C as CompiledBlock, b as CompiledFragment, E as CompiledFragmentsFile, I as CompiledTokenData, J as CompiledTokenEntry, a$ as ComponentRelation, b0 as FragmentContract, b1 as FragmentGenerated, b2 as FragmentMeta, b3 as FragmentUsage, b4 as ImportEntry, ai as ObservedComponentUsage, aj as ObservedUsageProp, b5 as PerformanceData, b6 as PerformanceSummary, b7 as PropDefinition, b8 as Theme, b9 as VerifyResult } from '../governance-pKrfh517.js';
 import 'zod';
 import 'react';
 import '../topology/index.js';

package/dist/generate/index.d.ts

@@ -1,4 +1,4 @@
-import { b as CompiledFragment, C as CompiledBlock } from '../governance-BLsyk56o.js';
+import { b as CompiledFragment, C as CompiledBlock } from '../governance-pKrfh517.js';
 import 'zod';
 import 'react';
 import '../topology/index.js';

package/dist/{governance-BLsyk56o.d.ts → governance-pKrfh517.d.ts}

@@ -75,6 +75,15 @@ interface ContractCanonicalMappingInput {
     status: CanonicalMappingStatus;
     /** Local/offline canonical import target, when the mapping is config-authored. */
     importPath?: string;
+    /** Confirmed package-to-local relation metadata. Absent for legacy mappings. */
+    bridge?: {
+        underlyingPackageName: string;
+        underlyingExportName: string;
+        localComponentKey: string;
+        localExportName: string;
+        implementationFiles: readonly string[];
+        decisionSource: "authored" | "migration";
+    };
     /** Explicit raw element or semantic resolutions covered by a local declaration. */
     resolves?: readonly {
         tag: string;
@@ -906,7 +915,10 @@ type TokenSourceFormat = "auto" | "css" | "scss" | "dtcg" | "tailwind";
 interface TokenSourceConfig {
     /** Repo-root-relative token file or glob. */
     path: RepoRelativePath;
-    /** Explicit token format, or "auto" to infer from extension/content. */
+    /**
+     * Explicit token format, or "auto" to infer from extension/content. Use
+     * "auto" for statically analyzable TypeScript and JavaScript token modules.
+     */
     format?: TokenSourceFormat;
 }
 interface TokenConfig {
@@ -915,7 +927,10 @@ interface TokenConfig {
      * e.g., ["src/styles/theme.scss", "src/styles/variables.css"]
      */
     include?: string[];
-    /** Repo-root-relative token source files/globs for monorepos and Cloud setup. */
+    /**
+     * Repo-root-relative token source files/globs for monorepos and Cloud setup.
+     * Set each source to format "auto" for TypeScript or JavaScript token modules.
+     */
     sources?: TokenSourceConfig[];
     /**
      * npm package names whose shipped `fragments.json` token vocabulary seeds the
@@ -927,6 +942,14 @@ interface TokenConfig {
      * no-inference mandate intact.
      */
     packages?: string[];
+    /** Explicit local-name -> upstream-name mappings for cross-authority drift checks. */
+    aliases?: Record<string, string>;
+    /** Deterministic pins for upstream token manifests; local scans never fetch them. */
+    upstream?: Array<{
+        packageName: string;
+        version?: string;
+        digest?: string;
+    }>;
     /**
      * Glob patterns to exclude
      * @example ["node_modules"]
@@ -939,7 +962,10 @@ interface TokenConfig {
     themeSelectors?: Record<string, string>;
     /** Enable token comparison in style diffs (default: true) */
     enabled?: boolean;
-    /** Token source format detection ('auto' detects from file extension) */
+    /**
+     * Token source format detection. "auto" infers supported formats from the
+     * file extension, including statically analyzable TypeScript/JavaScript modules.
+     */
     format?: TokenSourceFormat;
     /** Vendor namespace for Fragments extensions in DTCG files (default: 'com.usefragments') */
     namespace?: string;
@@ -1099,12 +1125,17 @@ interface FragmentsConfig {
     recognizedClassHelpers?: string[];
     /** Local component-identity decisions used when Cloud does not own the key. */
     identity?: {
+        /** Authored sanctions, rejections, and dismissals keyed by portable component identity. */
         decisions?: Array<{
             /** Portable component key (`file#exportName`). */
             component: string;
+            /** The identity disposition recorded for this component. */
             kind: "sanction" | "reject" | "dismiss";
+            /** Optional canonical target (`moduleSpecifier#exportName`) for sanctions. */
             canonicalTarget?: string;
+            /** Human-readable rationale stored with the decision. */
             reason?: string;
+            /** Stable external identifier used to reconcile an existing decision. */
             decisionId?: string;
         }>;
     };
@@ -2132,6 +2163,74 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
     };
     status?: "active" | "draft" | "disabled" | undefined;
 }>;
+declare const canonicalBridgeV1Schema: z.ZodObject<{
+    underlying: z.ZodObject<{
+        packageName: z.ZodString;
+        exportName: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        exportName: string;
+        packageName: string;
+    }, {
+        exportName: string;
+        packageName: string;
+    }>;
+    local: z.ZodObject<{
+        componentKey: z.ZodString;
+        moduleSpecifier: z.ZodEffects<z.ZodString, string, string>;
+        exportName: z.ZodString;
+        implementationFiles: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        componentKey: string;
+        exportName: string;
+        moduleSpecifier: string;
+        implementationFiles: string[];
+    }, {
+        componentKey: string;
+        exportName: string;
+        moduleSpecifier: string;
+        implementationFiles: string[];
+    }>;
+    decision: z.ZodObject<{
+        state: z.ZodLiteral<"confirmed">;
+        source: z.ZodEnum<["authored", "migration"]>;
+    }, "strict", z.ZodTypeAny, {
+        state: "confirmed";
+        source: "authored" | "migration";
+    }, {
+        state: "confirmed";
+        source: "authored" | "migration";
+    }>;
+}, "strict", z.ZodTypeAny, {
+    underlying: {
+        exportName: string;
+        packageName: string;
+    };
+    local: {
+        componentKey: string;
+        exportName: string;
+        moduleSpecifier: string;
+        implementationFiles: string[];
+    };
+    decision: {
+        state: "confirmed";
+        source: "authored" | "migration";
+    };
+}, {
+    underlying: {
+        exportName: string;
+        packageName: string;
+    };
+    local: {
+        componentKey: string;
+        exportName: string;
+        moduleSpecifier: string;
+        implementationFiles: string[];
+    };
+    decision: {
+        state: "confirmed";
+        source: "authored" | "migration";
+    };
+}>;
 declare const canonicalSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"npm">;
     specifier: z.ZodString;
@@ -2273,6 +2372,104 @@ declare const governanceConfigSchema: z.ZodObject<{
         registryHash?: string | undefined;
         receiptPath?: string | undefined;
     }>]>, "many">>;
+    canonicalBridges: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        underlying: z.ZodObject<{
+            packageName: z.ZodString;
+            exportName: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            exportName: string;
+            packageName: string;
+        }, {
+            exportName: string;
+            packageName: string;
+        }>;
+        local: z.ZodObject<{
+            componentKey: z.ZodString;
+            moduleSpecifier: z.ZodEffects<z.ZodString, string, string>;
+            exportName: z.ZodString;
+            implementationFiles: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            componentKey: string;
+            exportName: string;
+            moduleSpecifier: string;
+            implementationFiles: string[];
+        }, {
+            componentKey: string;
+            exportName: string;
+            moduleSpecifier: string;
+            implementationFiles: string[];
+        }>;
+        decision: z.ZodObject<{
+            state: z.ZodLiteral<"confirmed">;
+            source: z.ZodEnum<["authored", "migration"]>;
+        }, "strict", z.ZodTypeAny, {
+            state: "confirmed";
+            source: "authored" | "migration";
+        }, {
+            state: "confirmed";
+            source: "authored" | "migration";
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        underlying: {
+            exportName: string;
+            packageName: string;
+        };
+        local: {
+            componentKey: string;
+            exportName: string;
+            moduleSpecifier: string;
+            implementationFiles: string[];
+        };
+        decision: {
+            state: "confirmed";
+            source: "authored" | "migration";
+        };
+    }, {
+        underlying: {
+            exportName: string;
+            packageName: string;
+        };
+        local: {
+            componentKey: string;
+            exportName: string;
+            moduleSpecifier: string;
+            implementationFiles: string[];
+        };
+        decision: {
+            state: "confirmed";
+            source: "authored" | "migration";
+        };
+    }>, "many">, {
+        underlying: {
+            exportName: string;
+            packageName: string;
+        };
+        local: {
+            componentKey: string;
+            exportName: string;
+            moduleSpecifier: string;
+            implementationFiles: string[];
+        };
+        decision: {
+            state: "confirmed";
+            source: "authored" | "migration";
+        };
+    }[], {
+        underlying: {
+            exportName: string;
+            packageName: string;
+        };
+        local: {
+            componentKey: string;
+            exportName: string;
+            moduleSpecifier: string;
+            implementationFiles: string[];
+        };
+        decision: {
+            state: "confirmed";
+            source: "authored" | "migration";
+        };
+    }[]>>;
     presets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     scales: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         kind: z.ZodDefault<z.ZodLiteral<"scale">>;
@@ -2993,6 +3190,22 @@ declare const governanceConfigSchema: z.ZodObject<{
         exclude?: string[] | undefined;
         registryHash?: string | undefined;
     })[] | undefined;
+    canonicalBridges?: {
+        underlying: {
+            exportName: string;
+            packageName: string;
+        };
+        local: {
+            componentKey: string;
+            exportName: string;
+            moduleSpecifier: string;
+            implementationFiles: string[];
+        };
+        decision: {
+            state: "confirmed";
+            source: "authored" | "migration";
+        };
+    }[] | undefined;
     presets?: string[] | undefined;
     agent?: z.objectOutputType<{
         repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3167,6 +3380,22 @@ declare const governanceConfigSchema: z.ZodObject<{
         registryHash?: string | undefined;
         receiptPath?: string | undefined;
     })[] | undefined;
+    canonicalBridges?: {
+        underlying: {
+            exportName: string;
+            packageName: string;
+        };
+        local: {
+            componentKey: string;
+            exportName: string;
+            moduleSpecifier: string;
+            implementationFiles: string[];
+        };
+        decision: {
+            state: "confirmed";
+            source: "authored" | "migration";
+        };
+    }[] | undefined;
     presets?: string[] | undefined;
     agent?: z.objectInputType<{
         repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3183,20 +3412,47 @@ type ComponentGovernanceRecord = z.infer<typeof componentGovernanceRecordSchema>
 type ComponentPolicyRecord = z.infer<typeof componentPolicyRecordSchema>;
 type ComponentPolicyOverride = z.infer<typeof componentPolicyOverrideSchema>;
 type CanonicalSource = z.infer<typeof canonicalSourceSchema>;
+type CanonicalBridgeV1 = z.infer<typeof canonicalBridgeV1Schema>;
 interface GovernanceConfig {
+    /** Shared governance config modules to extend before applying this file's declarations. */
     extends?: string[];
+    /** Default severity for governance rules that do not declare their own severity. */
     severity?: GovernanceSeverity;
+    /**
+     * Rule-id keyed enablement and severity overrides. Only fields consumed by the named
+     * rule are valid; unsupported fields are reported as inert config.
+     */
     rules?: Record<string, unknown>;
+    /** Agent-id keyed rule overrides for supported agent-specific governance policies. */
     agents?: Record<string, {
         rules?: Record<string, unknown>;
     }>;
+    /** Reserved audit compatibility object; undeclared child keys are reported as inert. */
     audit?: Record<string, unknown>;
+    /** Reserved runner compatibility map; undeclared child keys are reported as inert. */
     runners?: Record<string, Record<string, unknown>>;
+    /**
+     * Canonical component authorities: npm packages, repository directories, or registry
+     * receipts whose included exports arm canonical-component rules.
+     */
     canonicalSources?: CanonicalSource[];
+    /**
+     * Confirmed mappings from an underlying library export to the approved local wrapper.
+     * The wrapper's implementationFiles scope permits its direct underlying import.
+     */
+    canonicalBridges?: CanonicalBridgeV1[];
+    /** Versioned governance presets to resolve before applying local rule overrides. */
     presets?: string[];
+    /**
+     * Named numeric scales. Spacing rules bind through
+     * style.rawSpacing.mustMatchScale; the built-in spacing policy references `space`.
+     */
     scales?: Record<string, ScaleGovernanceRecord>;
+    /** Legacy typed style-policy records, normalized into the active rule policy. */
     styles?: GlobalStyleGovernanceRecord[];
+    /** Legacy typed JSX-policy records, normalized into the active rule policy. */
     jsx?: GlobalJsxGovernanceRecord[];
+    /** Tailwind palette allow/deny policy used by Tailwind governance rules. */
     tailwind?: {
         palette?: {
             allow?: string[];
@@ -3204,12 +3460,16 @@ interface GovernanceConfig {
         };
         [key: string]: unknown;
     };
+    /** Agent repair-order guidance consumed when presenting deterministic fixes. */
     agent?: {
         repairOrder?: string[];
         [key: string]: unknown;
     };
+    /** Component-keyed governance records for canonical component metadata and prop policy. */
     components?: Record<string, ComponentPolicyRecord>;
+    /** Ordered component-policy overrides selected by component identity fields. */
     overrides?: ComponentPolicyOverride[];
+    /** Governance CI rendering options, including whether warnings fail the CI verdict. */
     ci?: {
         failOnWarnings?: boolean;
         [key: string]: unknown;
@@ -3318,4 +3578,4 @@ declare const g: {
     component: ComponentGovernanceBuilder<Record<string, unknown>>;
 };
 
-export { type DiffResult as $, type AIMetadata as A, type BlockDefinition as B, type CompiledBlock as C, type CompiledRecipe as D, type CompiledTokenData as E, type FragmentDefinition as F, type GovernanceSeverity as G, type CompiledTokenEntry as H, type ComponentGovernanceBuilder as I, type ComponentGovernanceRecord as J, type ComponentRef as K, type ComponentRelation as L, type CompositionMetadata as M, type ContractCanonicalMappingInput as N, type ContractComponentInput as O, type ContractIdentityPin as P, type ContractPolicyInput as Q, type ResolvedGovernedFragmentDefinition as R, type StorybookFilterConfig as S, type TokenConfig as T, type ContractPreimage as U, type VariantRenderOptions as V, type ContractPropMappingInput as W, type ContractTokenInput as X, type ContractWaiverInput as Y, type ControlType as Z, type DesignSystemConfig as _, type FragmentDefinitionV2 as a, type FragmentGenerated$1 as a$, type FigmaPropMapping as a0, type FragmentContract as a1, type FragmentExample as a2, type FragmentGenerated as a3, type FragmentGuidance as a4, type FragmentMeta as a5, type FragmentProvenance as a6, type FragmentUsage as a7, type FragmentVariant as a8, type GlobalGovernanceRecord as a9, type Theme as aA, type ThemeSeeds as aB, type TokenSourceConfig as aC, type TokenSourceFormat as aD, type VerifyRequest as aE, type VerifyResult as aF, type Viewport as aG, componentGovernanceRecordSchema as aH, componentGovernanceRecordsSchema as aI, contractComponentsFromFragments as aJ, contractPolicyFromGovernanceConfig as aK, diffContractDomains as aL, g as aM, globalGovernanceRecordSchema as aN, globalJsxGovernanceRecordSchema as aO, globalStyleGovernanceRecordSchema as aP, governanceConfigSchema as aQ, governanceConfigWithLocalCanonical as aR, governanceSeveritySchema as aS, localCanonicalContractMappings as aT, normalizeGovernanceConfig as aU, projectContractPreimage as aV, scaleGovernanceRecordSchema as aW, verifiedContractPreimageFromPin as aX, type AIMetadata$1 as aY, type ComponentRelation$1 as aZ, type FragmentContract$1 as a_, type GlobalJsxGovernanceRecord as aa, type GlobalStyleGovernanceRecord as ab, type GovernancePropValue as ac, type InspectConfig as ad, type LocalCanonicalDeclaration as ae, type LocalCanonicalResolveRule as af, type Manifest as ag, type ObservedComponentUsage as ah, type ObservedUsageProp as ai, type PlayFunction as aj, type PlayFunctionContext as ak, type PropDefinition as al, type PropGovernanceBuilder as am, type PropGovernanceOptions as an, type PropKey as ao, type PropType as ap, type RecipeDefinition as aq, type RegistryOptions as ar, type RepoRelativePath as as, type ScaleGovernanceRecord as at, type Screenshot as au, type ScreenshotConfig as av, type ScreenshotMetadata as aw, type ServiceConfig as ax, type SnapshotConfig as ay, type SnippetPolicyConfig as az, type CompiledFragment as b, type FragmentMeta$1 as b0, type FragmentUsage$1 as b1, type ImportEntry as b2, type PerformanceData as b3, type PerformanceSummary as b4, type PropDefinition$1 as b5, type Theme$1 as b6, type VerifyResult$1 as b7, type ContractDomain as c, type ContractCatalogInput as d, type GovernedFragmentDefinition as e, type GovernanceConfig as f, type FragmentsConfig as g, type FragmentComponent as h, type FigmaStringMapping as i, type FigmaBooleanMapping as j, type FigmaEnumMapping as k, type FigmaInstanceMapping as l, type FigmaChildrenMapping as m, type FigmaTextContentMapping as n, type RelationshipType as o, type VariantLoader as p, type CanonicalSource as q, type AccessibilityGovernanceBuilder as r, type AppConfig as s, type BaselineInfo as t, type BoundingBox as u, CONTRACT_DOMAINS as v, CONTRACT_PREIMAGE_CAPABILITY_HEADER as w, CONTRACT_PREIMAGE_SCHEMA as x, type CanonicalMappingStatus as y, type CompiledFragmentsFile as z };
+export { type DesignSystemConfig 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, type CompiledRecipe as H, type CompiledTokenData as I, type CompiledTokenEntry as J, type ComponentGovernanceBuilder as K, type ComponentGovernanceRecord as L, type ComponentRef as M, type ComponentRelation as N, type CompositionMetadata as O, type ContractComponentInput as P, type ContractIdentityPin as Q, type ResolvedGovernedFragmentDefinition as R, type StorybookFilterConfig as S, type TokenConfig as T, type ContractPolicyInput as U, type VariantRenderOptions as V, type ContractPreimage as W, type ContractPropMappingInput as X, type ContractTokenInput as Y, type ContractWaiverInput as Z, type ControlType as _, type FragmentDefinitionV2 as a, type ComponentRelation$1 as a$, type DiffResult as a0, type FigmaPropMapping as a1, type FragmentContract as a2, type FragmentExample as a3, type FragmentGenerated as a4, type FragmentGuidance as a5, type FragmentMeta as a6, type FragmentProvenance as a7, type FragmentUsage as a8, type FragmentVariant as a9, type SnippetPolicyConfig as aA, type Theme as aB, type ThemeSeeds as aC, type TokenSourceConfig as aD, type TokenSourceFormat as aE, type VerifyRequest as aF, type VerifyResult as aG, type Viewport as aH, canonicalBridgeV1Schema as aI, componentGovernanceRecordSchema as aJ, componentGovernanceRecordsSchema as aK, contractComponentsFromFragments as aL, contractPolicyFromGovernanceConfig as aM, diffContractDomains as aN, g as aO, globalGovernanceRecordSchema as aP, globalJsxGovernanceRecordSchema as aQ, globalStyleGovernanceRecordSchema as aR, governanceConfigSchema as aS, governanceConfigWithLocalCanonical as aT, governanceSeveritySchema as aU, localCanonicalContractMappings as aV, normalizeGovernanceConfig as aW, projectContractPreimage as aX, scaleGovernanceRecordSchema as aY, verifiedContractPreimageFromPin as aZ, type AIMetadata$1 as a_, type GlobalGovernanceRecord as aa, type GlobalJsxGovernanceRecord as ab, type GlobalStyleGovernanceRecord as ac, type GovernancePropValue as ad, type InspectConfig as ae, type LocalCanonicalDeclaration as af, type LocalCanonicalResolveRule as ag, type Manifest as ah, type ObservedComponentUsage as ai, type ObservedUsageProp as aj, type PlayFunction as ak, type PlayFunctionContext as al, type PropDefinition as am, type PropGovernanceBuilder as an, type PropGovernanceOptions as ao, type PropKey as ap, type PropType as aq, type RecipeDefinition as ar, type RegistryOptions as as, type RepoRelativePath as at, type ScaleGovernanceRecord as au, type Screenshot as av, type ScreenshotConfig as aw, type ScreenshotMetadata as ax, type ServiceConfig as ay, type SnapshotConfig as az, type CompiledFragment as b, type FragmentContract$1 as b0, type FragmentGenerated$1 as b1, type FragmentMeta$1 as b2, type FragmentUsage$1 as b3, type ImportEntry as b4, type PerformanceData as b5, type PerformanceSummary as b6, type PropDefinition$1 as b7, type Theme$1 as b8, type VerifyResult$1 as b9, type ContractDomain as c, type ContractCatalogInput as d, type GovernedFragmentDefinition as e, type GovernanceConfig as f, type FragmentsConfig as g, type FragmentComponent as h, type FigmaStringMapping as i, type FigmaBooleanMapping as j, type FigmaEnumMapping as k, type FigmaInstanceMapping as l, type FigmaChildrenMapping as m, type FigmaTextContentMapping as n, type RelationshipType as o, type VariantLoader 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 };