@usefragments/core 2.0.2 → 2.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (31) hide show
  1. package/dist/codes/index.d.ts +1 -1
  2. package/dist/compiled-types/index.d.ts +1 -1
  3. package/dist/generate/index.d.ts +1 -1
  4. package/dist/{index-C8bcXVav.d.ts → index-xn5CNdf4.d.ts} +451 -451
  5. package/dist/index.d.ts +1433 -1423
  6. package/dist/index.js +5028 -4564
  7. package/dist/index.js.map +1 -1
  8. package/dist/manifest.d.ts +24 -24
  9. package/dist/preview-runtime.d.ts +1 -1
  10. package/dist/react-types.d.ts +1 -1
  11. package/dist/registry.d.ts +380 -380
  12. package/dist/schemas/index.d.ts +1 -1
  13. package/dist/{governance-hOPXGbbs.d.ts → source-identity-DvOBz2yJ.d.ts} +675 -610
  14. package/dist/storyAdapter.d.ts +1 -1
  15. package/dist/test-utils.d.ts +1 -1
  16. package/package.json +1 -1
  17. package/src/conform.ts +10 -0
  18. package/src/contract/index.ts +24 -0
  19. package/src/contract/preimage.ts +17 -3
  20. package/src/contract/source-identity.test.ts +167 -0
  21. package/src/contract/source-identity.ts +303 -0
  22. package/src/evaluation/canonical-facts-trust.test.ts +67 -6
  23. package/src/evaluation/evaluate.ts +19 -3
  24. package/src/evaluation/evaluation-v2-receipt-v1.test.ts +27 -1
  25. package/src/evaluation/index.ts +7 -1
  26. package/src/evaluation/receipt.ts +17 -2
  27. package/src/evaluation/types.ts +14 -1
  28. package/src/index.ts +28 -0
  29. package/src/rules/components-prefer-library-classnames.test.ts +354 -0
  30. package/src/rules/components-prefer-library.test.ts +246 -0
  31. package/src/rules/components-prefer-library.ts +340 -61
package/dist/{governance-hOPXGbbs.d.ts → source-identity-DvOBz2yJ.d.ts} RENAMED
@@ -2,230 +2,6 @@ import { z } from 'zod';
2
2
  import { ComponentType, ReactNode, JSX } from 'react';
3
3
  import { Topology } from './topology/index.js';
4
4
 
5
- /**
6
- * Frontend Contract preimage — the projection that defines what the contract IS.
7
- *
8
- * The FCID used to be a hash of the raw `code-contracts` artifact payload. That
9
- * conflated identity with display: a copy-edit to a component description moved
10
- * the hash, and tokens / canonical mappings / policy — the things gates actually
11
- * enforce — were not part of identity at all. This module widens the preimage to
12
- * the full enforcement surface as ONE shared projection, imported by both Cloud
13
- * (mint) and the CLI (reportedHash). Neither side may reimplement it: parity is
14
- * a property of the shared import, not a test you can fail.
15
- *
16
- * Enforced-only is implemented structurally: {@link projectContractPreimage}
17
- * copies an explicit pick-list of fields per domain. Anything an adapter passes
18
- * beyond that list (descriptions, docs URLs, timestamps, heuristic signals)
19
- * never reaches the hash. Proposed canonical mappings are excluded for the same
20
- * reason — they cannot block, so they are not identity; confirmation is the
21
- * moment a mapping enters the contract.
22
- *
23
- * The preimage itself is the record of four domain sub-hashes, so
24
- * `contractHash(preimage)` is the fcid and a domain diff is a four-string
25
- * compare — no deep structural diffing. Determinism (key sorting, undefined
26
- * dropping, number normalization) is inherited from `canonicalPreimage`; this
27
- * module adds element-level sorting for the arrays it owns and nothing else.
28
- *
29
- * Runtime-portable by construction: no Node APIs, no Convex imports, no React.
30
- */
31
-
32
- /**
33
- * Positive pick-list of per-component `contract` fields that enter the FCID.
34
- * Display/guidance fields (`propsSummary`, `canonicalUsage`, `scenarioTags`,
35
- * story `states`/`variants`, descriptions) are intentionally absent — adapters
36
- * may still pass them, but {@link projectEnforcementContract} never copies them.
37
- */
38
- declare const CONTRACT_ENFORCEMENT_FIELDS: readonly ["a11yRules", "bans", "performanceBudget", "compoundChildren", "composition"];
39
- type ContractEnforcementField = (typeof CONTRACT_ENFORCEMENT_FIELDS)[number];
40
- /** Display-only contract keys that must never enter the FCID positive pick-list. */
41
- declare const CONTRACT_DISPLAY_ONLY_FIELDS: readonly ["propsSummary", "canonicalUsage", "scenarioTags", "states", "variants"];
42
- /**
43
- * The fixed domain enum. Adding a domain is a spine change (update
44
- * `01-architecture.md` first); never rename — deprecate and alias.
45
- */
46
- declare const CONTRACT_DOMAINS: readonly ["components", "tokens", "canonicalMap", "policy"];
47
- type ContractDomain = (typeof CONTRACT_DOMAINS)[number];
48
- /**
49
- * One component's enforcement identity. Props are the *name* membership surface
50
- * (what unknown-prop checks today); prop types/defaults are not enforced by the
51
- * rules engine, so they are not identity — enforced-only cuts both ways.
52
- */
53
- interface ContractComponentInput {
54
- name: string;
55
- /** Parent component name when this is a subcomponent (compound identity). */
56
- parentName?: string;
57
- /** Prop names the component accepts. */
58
- props?: readonly string[];
59
- /**
60
- * The per-component contract as authored. Only {@link CONTRACT_ENFORCEMENT_FIELDS}
61
- * are projected into the FCID — display/guidance keys are stripped structurally.
62
- */
63
- contract?: unknown;
64
- /**
65
- * Resolved component governance records (`govern:` / `governance`). Editing
66
- * these changes what CI allows, so they are FCID identity.
67
- */
68
- governance?: readonly ComponentGovernanceRecord[];
69
- /** Required compound-children names, when the structure is declared. */
70
- compoundChildren?: readonly string[];
71
- }
72
- interface ContractTokenInput {
73
- name: string;
74
- value: string | number;
75
- type?: string;
76
- }
77
- type CanonicalMappingStatus = "confirmed" | "proposed" | "unknown";
78
- interface ContractPropMappingInput {
79
- rawProp: string;
80
- canonicalProp: string;
81
- valueMap?: Readonly<Record<string, string>>;
82
- }
83
- interface ContractCanonicalMappingInput {
84
- /** The raw/source component the mapping covers. */
85
- component: string;
86
- /** The canonical component it maps to. */
87
- canonical: string;
88
- status: CanonicalMappingStatus;
89
- /** Local/offline canonical import target, when the mapping is config-authored. */
90
- importPath?: string;
91
- /** Confirmed package-to-local relation metadata. Absent for legacy mappings. */
92
- bridge?: {
93
- underlyingPackageName: string;
94
- underlyingExportName: string;
95
- localComponentKey: string;
96
- localExportName: string;
97
- implementationFiles: readonly string[];
98
- decisionSource: "authored" | "migration";
99
- };
100
- /** Explicit raw element or semantic resolutions covered by a local declaration. */
101
- resolves?: readonly {
102
- tag: string;
103
- role?: string;
104
- inputType?: string;
105
- }[];
106
- propMapping?: readonly ContractPropMappingInput[];
107
- }
108
- /**
109
- * An authored waiver record. Hashed as data — including `expiresOn` as a plain
110
- * date string. Expiry *evaluation* happens at enforcement time and must never
111
- * change the fcid (no time-dependent hashing).
112
- */
113
- interface ContractWaiverInput {
114
- id: string;
115
- /** The diagnostic code or rule the waiver suppresses. */
116
- target: string;
117
- reason: string;
118
- /** YYYY-MM-DD, treated as opaque data. */
119
- expiresOn?: string;
120
- }
121
- /**
122
- * Active policy: everything that changes what a gate would allow or deny.
123
- * Waivers live here (spine open question 1, resolved): a waiver changes what
124
- * blocks, so it is enforcement-relevant.
125
- */
126
- interface ContractPolicyInput {
127
- rules?: Readonly<Record<string, unknown>>;
128
- codes?: Readonly<Record<string, unknown>>;
129
- compositionPatterns?: readonly unknown[];
130
- waivers?: readonly ContractWaiverInput[];
131
- }
132
- /**
133
- * The neutral catalog shape both adapters (Cloud mint, CLI scan) assemble.
134
- * Adapters gather data; the projection owns all normalization — element order,
135
- * optional fields, and display-data stripping never reach the hash.
136
- */
137
- interface ContractCatalogInput {
138
- components?: readonly ContractComponentInput[];
139
- tokens?: readonly ContractTokenInput[];
140
- canonicalMappings?: readonly ContractCanonicalMappingInput[];
141
- policy?: ContractPolicyInput | null;
142
- }
143
- /** Deterministic runtime refusal for malformed or ambiguous FCID inputs. */
144
- declare class ContractCatalogValidationError extends TypeError {
145
- readonly issues: readonly string[];
146
- constructor(issues: readonly string[]);
147
- }
148
- declare const CONTRACT_PREIMAGE_SCHEMA: "fcid-preimage:v1";
149
- /** Request header used by clients that can verify and consume this preimage. */
150
- declare const CONTRACT_PREIMAGE_CAPABILITY_HEADER: "X-Fragments-Contract-Preimage";
151
- /**
152
- * The hashed identity record: four domain sub-hashes plus the projection schema
153
- * version (so an intentional projection change mints a new fcid). The fcid is
154
- * `contractHash(preimage)` — hash of the domain hashes, per the spine pipeline.
155
- */
156
- interface ContractPreimage {
157
- schema: typeof CONTRACT_PREIMAGE_SCHEMA;
158
- domains: Record<ContractDomain, string>;
159
- }
160
- /**
161
- * Wire-compatible identity pin carried by Cloud policy responses. Older
162
- * contract rows may omit the schema/domains, so every field except the FCID is
163
- * intentionally nullable at this boundary.
164
- */
165
- interface ContractIdentityPin {
166
- contractHash: string;
167
- preimageSchema?: string | null;
168
- domainHashes?: Readonly<Record<string, string>> | null;
169
- }
170
- /**
171
- * Reconstruct and verify the canonical preimage behind a published FCID.
172
- *
173
- * This is the only supported bridge from the additive ledger/wire shape
174
- * (`preimageSchema` + `domainHashes`) back to the hash input. Consumers must
175
- * not trust `enforcedIdentityComparable` on its own: a malformed, partial, or
176
- * internally inconsistent pin returns `null` and therefore fails closed.
177
- */
178
- declare function verifiedContractPreimageFromPin(pin: ContractIdentityPin): ContractPreimage | null;
179
- /**
180
- * Project only enforcement fields from a per-component `contract` blob.
181
- * Unknown / display keys are dropped; an all-display contract becomes `undefined`.
182
- */
183
- declare function projectEnforcementContract(contract: unknown): unknown;
184
- /**
185
- * Project a catalog onto the contract preimage: four enforced-only domain
186
- * bodies, each hashed independently. `contractHash(projectContractPreimage(x))`
187
- * is the fcid.
188
- */
189
- declare function projectContractPreimage(catalog: ContractCatalogInput): ContractPreimage;
190
- /**
191
- * Name the domains whose identity differs between two preimages — a four-string
192
- * compare, no structural diffing. Returned in fixed {@link CONTRACT_DOMAINS}
193
- * order. Staleness checks compare these, never whole fcids.
194
- */
195
- declare function diffContractDomains(a: ContractPreimage, b: ContractPreimage): ContractDomain[];
196
- /**
197
- * Map defineFragment-shaped records — the `code-contracts` payload's
198
- * `fragments` array (Cloud mint) or the CLI's loaded fragment definitions —
199
- * onto their enforcement identity. The one shared mapping is what keeps the
200
- * two adapters from drifting into a second "catalog → preimage"
201
- * implementation: both sides gather fragments however they like, then this
202
- * picks the identity fields. Records without a string `meta.name` are skipped
203
- * (no identity to hash).
204
- */
205
- /**
206
- * The enforced-only slice of a resolved CLI governance config — the fields
207
- * that change what a scan allows or denies. CI gate options, agent repair
208
- * order, and runner config change how/when gates run, not what they enforce,
209
- * so they are not identity. This pick-list lives here, beside the projection,
210
- * so adapters cannot drift into private enforced-only boundaries: a new
211
- * enforcement field on {@link GovernanceConfig} is added to the contract in
212
- * exactly one place.
213
- */
214
- declare function contractPolicyFromGovernanceConfig(config: GovernanceConfig | null | undefined): ContractPolicyInput | null;
215
- declare function contractComponentsFromFragments(fragments: readonly unknown[]): ContractComponentInput[];
216
- /**
217
- * Derive a preview `artifactId` from modules, states, guidance/render content,
218
- * and runtime config. Never an FCID — callers must not assign
219
- * `derivedFromContractHash` into `artifactId` (or the reverse).
220
- */
221
- declare function deriveArtifactId(content: {
222
- modules?: unknown;
223
- states?: unknown;
224
- guidance?: unknown;
225
- render?: unknown;
226
- runtime?: unknown;
227
- }): string;
228
-
229
5
  interface LocalCanonicalResolveRule {
230
6
  tag: string;
231
7
  role?: string;
@@ -1320,7 +1096,7 @@ declare const globalStyleGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind",
1320
1096
  }>]>, "many">>;
1321
1097
  }, "strip", z.ZodTypeAny, {
1322
1098
  kind: "style.rawColors.forbid";
1323
- severity: "error" | "info" | "warn";
1099
+ severity: "error" | "warn" | "info";
1324
1100
  except: string[];
1325
1101
  prefer: "token" | "css-variable";
1326
1102
  exclude?: (string | {
@@ -1329,7 +1105,7 @@ declare const globalStyleGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind",
1329
1105
  })[] | undefined;
1330
1106
  }, {
1331
1107
  kind: "style.rawColors.forbid";
1332
- severity: "error" | "info" | "warn";
1108
+ severity: "error" | "warn" | "info";
1333
1109
  except: string[];
1334
1110
  prefer: "token" | "css-variable";
1335
1111
  exclude?: (string | {
@@ -1353,7 +1129,7 @@ declare const globalStyleGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind",
1353
1129
  }>]>, "many">>;
1354
1130
  }, "strip", z.ZodTypeAny, {
1355
1131
  kind: "style.rawDimensions.forbid";
1356
- severity: "error" | "info" | "warn";
1132
+ severity: "error" | "warn" | "info";
1357
1133
  prefer: "token" | "css-variable";
1358
1134
  appliesTo: string[];
1359
1135
  exclude?: (string | {
@@ -1362,7 +1138,7 @@ declare const globalStyleGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind",
1362
1138
  })[] | undefined;
1363
1139
  }, {
1364
1140
  kind: "style.rawDimensions.forbid";
1365
- severity: "error" | "info" | "warn";
1141
+ severity: "error" | "warn" | "info";
1366
1142
  prefer: "token" | "css-variable";
1367
1143
  appliesTo: string[];
1368
1144
  exclude?: (string | {
@@ -1386,7 +1162,7 @@ declare const globalStyleGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind",
1386
1162
  }>]>, "many">>;
1387
1163
  }, "strip", z.ZodTypeAny, {
1388
1164
  kind: "style.rawSpacing.mustMatchScale";
1389
- severity: "error" | "info" | "warn";
1165
+ severity: "error" | "warn" | "info";
1390
1166
  scale: string;
1391
1167
  appliesTo: string[];
1392
1168
  exclude?: (string | {
@@ -1395,7 +1171,7 @@ declare const globalStyleGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind",
1395
1171
  })[] | undefined;
1396
1172
  }, {
1397
1173
  kind: "style.rawSpacing.mustMatchScale";
1398
- severity: "error" | "info" | "warn";
1174
+ severity: "error" | "warn" | "info";
1399
1175
  scale: string;
1400
1176
  appliesTo: string[];
1401
1177
  exclude?: (string | {
@@ -1418,7 +1194,7 @@ declare const globalStyleGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind",
1418
1194
  }>]>, "many">>;
1419
1195
  }, "strip", z.ZodTypeAny, {
1420
1196
  kind: "style.fontSize.mustMatchScale";
1421
- severity: "error" | "info" | "warn";
1197
+ severity: "error" | "warn" | "info";
1422
1198
  scale: string;
1423
1199
  exclude?: (string | {
1424
1200
  glob: string;
@@ -1426,7 +1202,7 @@ declare const globalStyleGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind",
1426
1202
  })[] | undefined;
1427
1203
  }, {
1428
1204
  kind: "style.fontSize.mustMatchScale";
1429
- severity: "error" | "info" | "warn";
1205
+ severity: "error" | "warn" | "info";
1430
1206
  scale: string;
1431
1207
  exclude?: (string | {
1432
1208
  glob: string;
@@ -1447,14 +1223,14 @@ declare const globalStyleGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind",
1447
1223
  }>]>, "many">>;
1448
1224
  }, "strip", z.ZodTypeAny, {
1449
1225
  kind: "style.cssVars.mustBeDefined";
1450
- severity: "error" | "info" | "warn";
1226
+ severity: "error" | "warn" | "info";
1451
1227
  exclude?: (string | {
1452
1228
  glob: string;
1453
1229
  reason?: string | undefined;
1454
1230
  })[] | undefined;
1455
1231
  }, {
1456
1232
  kind: "style.cssVars.mustBeDefined";
1457
- severity: "error" | "info" | "warn";
1233
+ severity: "error" | "warn" | "info";
1458
1234
  exclude?: (string | {
1459
1235
  glob: string;
1460
1236
  reason?: string | undefined;
@@ -1475,14 +1251,14 @@ declare const globalJsxGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
1475
1251
  }>]>, "many">>;
1476
1252
  }, "strip", z.ZodTypeAny, {
1477
1253
  kind: "jsx.unknownProps.forbid";
1478
- severity: "error" | "info" | "warn";
1254
+ severity: "error" | "warn" | "info";
1479
1255
  exclude?: (string | {
1480
1256
  glob: string;
1481
1257
  reason?: string | undefined;
1482
1258
  })[] | undefined;
1483
1259
  }, {
1484
1260
  kind: "jsx.unknownProps.forbid";
1485
- severity: "error" | "info" | "warn";
1261
+ severity: "error" | "warn" | "info";
1486
1262
  exclude?: (string | {
1487
1263
  glob: string;
1488
1264
  reason?: string | undefined;
@@ -1503,7 +1279,7 @@ declare const globalJsxGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
1503
1279
  }>]>, "many">>;
1504
1280
  }, "strip", z.ZodTypeAny, {
1505
1281
  kind: "jsx.inlineStyle.forbidRaw";
1506
- severity: "error" | "info" | "warn";
1282
+ severity: "error" | "warn" | "info";
1507
1283
  properties: string[];
1508
1284
  exclude?: (string | {
1509
1285
  glob: string;
@@ -1511,7 +1287,7 @@ declare const globalJsxGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
1511
1287
  })[] | undefined;
1512
1288
  }, {
1513
1289
  kind: "jsx.inlineStyle.forbidRaw";
1514
- severity: "error" | "info" | "warn";
1290
+ severity: "error" | "warn" | "info";
1515
1291
  properties: string[];
1516
1292
  exclude?: (string | {
1517
1293
  glob: string;
@@ -1536,26 +1312,26 @@ declare const globalJsxGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
1536
1312
  }>]>, "many">>;
1537
1313
  }, "strip", z.ZodTypeAny, {
1538
1314
  kind: "jsx.importPath.prefer";
1539
- severity: "error" | "info" | "warn";
1315
+ severity: "error" | "warn" | "info";
1540
1316
  from: string;
1541
1317
  to: string;
1542
- because?: string | undefined;
1543
1318
  exclude?: (string | {
1544
1319
  glob: string;
1545
1320
  reason?: string | undefined;
1546
1321
  })[] | undefined;
1547
1322
  imported?: string | undefined;
1323
+ because?: string | undefined;
1548
1324
  }, {
1549
1325
  kind: "jsx.importPath.prefer";
1550
- severity: "error" | "info" | "warn";
1326
+ severity: "error" | "warn" | "info";
1551
1327
  from: string;
1552
1328
  to: string;
1553
- because?: string | undefined;
1554
1329
  exclude?: (string | {
1555
1330
  glob: string;
1556
1331
  reason?: string | undefined;
1557
1332
  })[] | undefined;
1558
1333
  imported?: string | undefined;
1334
+ because?: string | undefined;
1559
1335
  }>, z.ZodObject<{
1560
1336
  kind: z.ZodLiteral<"jsx.component.prefer">;
1561
1337
  from: z.ZodString;
@@ -1574,24 +1350,24 @@ declare const globalJsxGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
1574
1350
  }>]>, "many">>;
1575
1351
  }, "strip", z.ZodTypeAny, {
1576
1352
  kind: "jsx.component.prefer";
1577
- severity: "error" | "info" | "warn";
1353
+ severity: "error" | "warn" | "info";
1578
1354
  from: string;
1579
1355
  to: string;
1580
- because?: string | undefined;
1581
1356
  exclude?: (string | {
1582
1357
  glob: string;
1583
1358
  reason?: string | undefined;
1584
1359
  })[] | undefined;
1360
+ because?: string | undefined;
1585
1361
  }, {
1586
1362
  kind: "jsx.component.prefer";
1587
- severity: "error" | "info" | "warn";
1363
+ severity: "error" | "warn" | "info";
1588
1364
  from: string;
1589
1365
  to: string;
1590
- because?: string | undefined;
1591
1366
  exclude?: (string | {
1592
1367
  glob: string;
1593
1368
  reason?: string | undefined;
1594
1369
  })[] | undefined;
1370
+ because?: string | undefined;
1595
1371
  }>]>;
1596
1372
  declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
1597
1373
  kind: z.ZodDefault<z.ZodLiteral<"scale">>;
@@ -1631,7 +1407,7 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1631
1407
  }>]>, "many">>;
1632
1408
  }, "strip", z.ZodTypeAny, {
1633
1409
  kind: "style.rawColors.forbid";
1634
- severity: "error" | "info" | "warn";
1410
+ severity: "error" | "warn" | "info";
1635
1411
  except: string[];
1636
1412
  prefer: "token" | "css-variable";
1637
1413
  exclude?: (string | {
@@ -1640,7 +1416,7 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1640
1416
  })[] | undefined;
1641
1417
  }, {
1642
1418
  kind: "style.rawColors.forbid";
1643
- severity: "error" | "info" | "warn";
1419
+ severity: "error" | "warn" | "info";
1644
1420
  except: string[];
1645
1421
  prefer: "token" | "css-variable";
1646
1422
  exclude?: (string | {
@@ -1664,7 +1440,7 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1664
1440
  }>]>, "many">>;
1665
1441
  }, "strip", z.ZodTypeAny, {
1666
1442
  kind: "style.rawDimensions.forbid";
1667
- severity: "error" | "info" | "warn";
1443
+ severity: "error" | "warn" | "info";
1668
1444
  prefer: "token" | "css-variable";
1669
1445
  appliesTo: string[];
1670
1446
  exclude?: (string | {
@@ -1673,7 +1449,7 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1673
1449
  })[] | undefined;
1674
1450
  }, {
1675
1451
  kind: "style.rawDimensions.forbid";
1676
- severity: "error" | "info" | "warn";
1452
+ severity: "error" | "warn" | "info";
1677
1453
  prefer: "token" | "css-variable";
1678
1454
  appliesTo: string[];
1679
1455
  exclude?: (string | {
@@ -1697,7 +1473,7 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1697
1473
  }>]>, "many">>;
1698
1474
  }, "strip", z.ZodTypeAny, {
1699
1475
  kind: "style.rawSpacing.mustMatchScale";
1700
- severity: "error" | "info" | "warn";
1476
+ severity: "error" | "warn" | "info";
1701
1477
  scale: string;
1702
1478
  appliesTo: string[];
1703
1479
  exclude?: (string | {
@@ -1706,7 +1482,7 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1706
1482
  })[] | undefined;
1707
1483
  }, {
1708
1484
  kind: "style.rawSpacing.mustMatchScale";
1709
- severity: "error" | "info" | "warn";
1485
+ severity: "error" | "warn" | "info";
1710
1486
  scale: string;
1711
1487
  appliesTo: string[];
1712
1488
  exclude?: (string | {
@@ -1729,7 +1505,7 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1729
1505
  }>]>, "many">>;
1730
1506
  }, "strip", z.ZodTypeAny, {
1731
1507
  kind: "style.fontSize.mustMatchScale";
1732
- severity: "error" | "info" | "warn";
1508
+ severity: "error" | "warn" | "info";
1733
1509
  scale: string;
1734
1510
  exclude?: (string | {
1735
1511
  glob: string;
@@ -1737,7 +1513,7 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1737
1513
  })[] | undefined;
1738
1514
  }, {
1739
1515
  kind: "style.fontSize.mustMatchScale";
1740
- severity: "error" | "info" | "warn";
1516
+ severity: "error" | "warn" | "info";
1741
1517
  scale: string;
1742
1518
  exclude?: (string | {
1743
1519
  glob: string;
@@ -1758,14 +1534,14 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1758
1534
  }>]>, "many">>;
1759
1535
  }, "strip", z.ZodTypeAny, {
1760
1536
  kind: "style.cssVars.mustBeDefined";
1761
- severity: "error" | "info" | "warn";
1537
+ severity: "error" | "warn" | "info";
1762
1538
  exclude?: (string | {
1763
1539
  glob: string;
1764
1540
  reason?: string | undefined;
1765
1541
  })[] | undefined;
1766
1542
  }, {
1767
1543
  kind: "style.cssVars.mustBeDefined";
1768
- severity: "error" | "info" | "warn";
1544
+ severity: "error" | "warn" | "info";
1769
1545
  exclude?: (string | {
1770
1546
  glob: string;
1771
1547
  reason?: string | undefined;
@@ -1785,14 +1561,14 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1785
1561
  }>]>, "many">>;
1786
1562
  }, "strip", z.ZodTypeAny, {
1787
1563
  kind: "jsx.unknownProps.forbid";
1788
- severity: "error" | "info" | "warn";
1564
+ severity: "error" | "warn" | "info";
1789
1565
  exclude?: (string | {
1790
1566
  glob: string;
1791
1567
  reason?: string | undefined;
1792
1568
  })[] | undefined;
1793
1569
  }, {
1794
1570
  kind: "jsx.unknownProps.forbid";
1795
- severity: "error" | "info" | "warn";
1571
+ severity: "error" | "warn" | "info";
1796
1572
  exclude?: (string | {
1797
1573
  glob: string;
1798
1574
  reason?: string | undefined;
@@ -1813,7 +1589,7 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1813
1589
  }>]>, "many">>;
1814
1590
  }, "strip", z.ZodTypeAny, {
1815
1591
  kind: "jsx.inlineStyle.forbidRaw";
1816
- severity: "error" | "info" | "warn";
1592
+ severity: "error" | "warn" | "info";
1817
1593
  properties: string[];
1818
1594
  exclude?: (string | {
1819
1595
  glob: string;
@@ -1821,7 +1597,7 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1821
1597
  })[] | undefined;
1822
1598
  }, {
1823
1599
  kind: "jsx.inlineStyle.forbidRaw";
1824
- severity: "error" | "info" | "warn";
1600
+ severity: "error" | "warn" | "info";
1825
1601
  properties: string[];
1826
1602
  exclude?: (string | {
1827
1603
  glob: string;
@@ -1846,26 +1622,26 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1846
1622
  }>]>, "many">>;
1847
1623
  }, "strip", z.ZodTypeAny, {
1848
1624
  kind: "jsx.importPath.prefer";
1849
- severity: "error" | "info" | "warn";
1625
+ severity: "error" | "warn" | "info";
1850
1626
  from: string;
1851
1627
  to: string;
1852
- because?: string | undefined;
1853
1628
  exclude?: (string | {
1854
1629
  glob: string;
1855
1630
  reason?: string | undefined;
1856
1631
  })[] | undefined;
1857
1632
  imported?: string | undefined;
1633
+ because?: string | undefined;
1858
1634
  }, {
1859
1635
  kind: "jsx.importPath.prefer";
1860
- severity: "error" | "info" | "warn";
1636
+ severity: "error" | "warn" | "info";
1861
1637
  from: string;
1862
1638
  to: string;
1863
- because?: string | undefined;
1864
1639
  exclude?: (string | {
1865
1640
  glob: string;
1866
1641
  reason?: string | undefined;
1867
1642
  })[] | undefined;
1868
1643
  imported?: string | undefined;
1644
+ because?: string | undefined;
1869
1645
  }>, z.ZodObject<{
1870
1646
  kind: z.ZodLiteral<"jsx.component.prefer">;
1871
1647
  from: z.ZodString;
@@ -1884,24 +1660,24 @@ declare const globalGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
1884
1660
  }>]>, "many">>;
1885
1661
  }, "strip", z.ZodTypeAny, {
1886
1662
  kind: "jsx.component.prefer";
1887
- severity: "error" | "info" | "warn";
1663
+ severity: "error" | "warn" | "info";
1888
1664
  from: string;
1889
1665
  to: string;
1890
- because?: string | undefined;
1891
1666
  exclude?: (string | {
1892
1667
  glob: string;
1893
1668
  reason?: string | undefined;
1894
1669
  })[] | undefined;
1670
+ because?: string | undefined;
1895
1671
  }, {
1896
1672
  kind: "jsx.component.prefer";
1897
- severity: "error" | "info" | "warn";
1673
+ severity: "error" | "warn" | "info";
1898
1674
  from: string;
1899
1675
  to: string;
1900
- because?: string | undefined;
1901
1676
  exclude?: (string | {
1902
1677
  glob: string;
1903
1678
  reason?: string | undefined;
1904
1679
  })[] | undefined;
1680
+ because?: string | undefined;
1905
1681
  }>]>;
1906
1682
  declare const componentGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
1907
1683
  kind: z.ZodLiteral<"capability">;
@@ -1921,16 +1697,16 @@ declare const componentGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
1921
1697
  severity: z.ZodEnum<["error", "warn", "info"]>;
1922
1698
  }, "strip", z.ZodTypeAny, {
1923
1699
  kind: "prop.value.avoid";
1924
- prop: string;
1700
+ severity: "error" | "warn" | "info";
1925
1701
  because: string;
1926
- severity: "error" | "info" | "warn";
1702
+ prop: string;
1927
1703
  value?: unknown;
1928
1704
  suggest?: string | undefined;
1929
1705
  }, {
1930
1706
  kind: "prop.value.avoid";
1931
- prop: string;
1707
+ severity: "error" | "warn" | "info";
1932
1708
  because: string;
1933
- severity: "error" | "info" | "warn";
1709
+ prop: string;
1934
1710
  value?: unknown;
1935
1711
  suggest?: string | undefined;
1936
1712
  }>, z.ZodObject<{
@@ -1955,9 +1731,9 @@ declare const componentGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
1955
1731
  severity: z.ZodEnum<["error", "warn", "info"]>;
1956
1732
  }, "strip", z.ZodTypeAny, {
1957
1733
  kind: "prop.value.forbid";
1958
- prop: string;
1734
+ severity: "error" | "warn" | "info";
1959
1735
  because: string;
1960
- severity: "error" | "info" | "warn";
1736
+ prop: string;
1961
1737
  value?: unknown;
1962
1738
  when?: {
1963
1739
  path?: string | undefined;
@@ -1967,9 +1743,9 @@ declare const componentGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
1967
1743
  } | undefined;
1968
1744
  }, {
1969
1745
  kind: "prop.value.forbid";
1970
- prop: string;
1746
+ severity: "error" | "warn" | "info";
1971
1747
  because: string;
1972
- severity: "error" | "info" | "warn";
1748
+ prop: string;
1973
1749
  value?: unknown;
1974
1750
  when?: {
1975
1751
  path?: string | undefined;
@@ -1983,12 +1759,12 @@ declare const componentGovernanceRecordSchema: z.ZodDiscriminatedUnion<"kind", [
1983
1759
  severity: z.ZodEnum<["error", "warn", "info"]>;
1984
1760
  }, "strip", z.ZodTypeAny, {
1985
1761
  kind: "a11y.requireName";
1762
+ severity: "error" | "warn" | "info";
1986
1763
  because: string;
1987
- severity: "error" | "info" | "warn";
1988
1764
  }, {
1989
1765
  kind: "a11y.requireName";
1766
+ severity: "error" | "warn" | "info";
1990
1767
  because: string;
1991
- severity: "error" | "info" | "warn";
1992
1768
  }>]>;
1993
1769
  declare const componentGovernanceRecordsSchema: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
1994
1770
  kind: z.ZodLiteral<"capability">;
@@ -2008,16 +1784,16 @@ declare const componentGovernanceRecordsSchema: z.ZodArray<z.ZodDiscriminatedUni
2008
1784
  severity: z.ZodEnum<["error", "warn", "info"]>;
2009
1785
  }, "strip", z.ZodTypeAny, {
2010
1786
  kind: "prop.value.avoid";
2011
- prop: string;
1787
+ severity: "error" | "warn" | "info";
2012
1788
  because: string;
2013
- severity: "error" | "info" | "warn";
1789
+ prop: string;
2014
1790
  value?: unknown;
2015
1791
  suggest?: string | undefined;
2016
1792
  }, {
2017
1793
  kind: "prop.value.avoid";
2018
- prop: string;
1794
+ severity: "error" | "warn" | "info";
2019
1795
  because: string;
2020
- severity: "error" | "info" | "warn";
1796
+ prop: string;
2021
1797
  value?: unknown;
2022
1798
  suggest?: string | undefined;
2023
1799
  }>, z.ZodObject<{
@@ -2042,9 +1818,9 @@ declare const componentGovernanceRecordsSchema: z.ZodArray<z.ZodDiscriminatedUni
2042
1818
  severity: z.ZodEnum<["error", "warn", "info"]>;
2043
1819
  }, "strip", z.ZodTypeAny, {
2044
1820
  kind: "prop.value.forbid";
2045
- prop: string;
1821
+ severity: "error" | "warn" | "info";
2046
1822
  because: string;
2047
- severity: "error" | "info" | "warn";
1823
+ prop: string;
2048
1824
  value?: unknown;
2049
1825
  when?: {
2050
1826
  path?: string | undefined;
@@ -2054,9 +1830,9 @@ declare const componentGovernanceRecordsSchema: z.ZodArray<z.ZodDiscriminatedUni
2054
1830
  } | undefined;
2055
1831
  }, {
2056
1832
  kind: "prop.value.forbid";
2057
- prop: string;
1833
+ severity: "error" | "warn" | "info";
2058
1834
  because: string;
2059
- severity: "error" | "info" | "warn";
1835
+ prop: string;
2060
1836
  value?: unknown;
2061
1837
  when?: {
2062
1838
  path?: string | undefined;
@@ -2070,12 +1846,12 @@ declare const componentGovernanceRecordsSchema: z.ZodArray<z.ZodDiscriminatedUni
2070
1846
  severity: z.ZodEnum<["error", "warn", "info"]>;
2071
1847
  }, "strip", z.ZodTypeAny, {
2072
1848
  kind: "a11y.requireName";
1849
+ severity: "error" | "warn" | "info";
2073
1850
  because: string;
2074
- severity: "error" | "info" | "warn";
2075
1851
  }, {
2076
1852
  kind: "a11y.requireName";
1853
+ severity: "error" | "warn" | "info";
2077
1854
  because: string;
2078
- severity: "error" | "info" | "warn";
2079
1855
  }>]>, "many">;
2080
1856
  /** Parse portable component policy records; malformed authority is unavailable, never empty. */
2081
1857
  declare function parseComponentGovernancePolicyJson(policyJson: string): ComponentGovernanceRecord[] | null;
@@ -2098,16 +1874,16 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
2098
1874
  severity: z.ZodEnum<["error", "warn", "info"]>;
2099
1875
  }, "strip", z.ZodTypeAny, {
2100
1876
  kind: "prop.value.avoid";
2101
- prop: string;
1877
+ severity: "error" | "warn" | "info";
2102
1878
  because: string;
2103
- severity: "error" | "info" | "warn";
1879
+ prop: string;
2104
1880
  value?: unknown;
2105
1881
  suggest?: string | undefined;
2106
1882
  }, {
2107
1883
  kind: "prop.value.avoid";
2108
- prop: string;
1884
+ severity: "error" | "warn" | "info";
2109
1885
  because: string;
2110
- severity: "error" | "info" | "warn";
1886
+ prop: string;
2111
1887
  value?: unknown;
2112
1888
  suggest?: string | undefined;
2113
1889
  }>, z.ZodObject<{
@@ -2132,9 +1908,9 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
2132
1908
  severity: z.ZodEnum<["error", "warn", "info"]>;
2133
1909
  }, "strip", z.ZodTypeAny, {
2134
1910
  kind: "prop.value.forbid";
2135
- prop: string;
1911
+ severity: "error" | "warn" | "info";
2136
1912
  because: string;
2137
- severity: "error" | "info" | "warn";
1913
+ prop: string;
2138
1914
  value?: unknown;
2139
1915
  when?: {
2140
1916
  path?: string | undefined;
@@ -2144,9 +1920,9 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
2144
1920
  } | undefined;
2145
1921
  }, {
2146
1922
  kind: "prop.value.forbid";
2147
- prop: string;
1923
+ severity: "error" | "warn" | "info";
2148
1924
  because: string;
2149
- severity: "error" | "info" | "warn";
1925
+ prop: string;
2150
1926
  value?: unknown;
2151
1927
  when?: {
2152
1928
  path?: string | undefined;
@@ -2160,12 +1936,12 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
2160
1936
  severity: z.ZodEnum<["error", "warn", "info"]>;
2161
1937
  }, "strip", z.ZodTypeAny, {
2162
1938
  kind: "a11y.requireName";
1939
+ severity: "error" | "warn" | "info";
2163
1940
  because: string;
2164
- severity: "error" | "info" | "warn";
2165
1941
  }, {
2166
1942
  kind: "a11y.requireName";
1943
+ severity: "error" | "warn" | "info";
2167
1944
  because: string;
2168
- severity: "error" | "info" | "warn";
2169
1945
  }>]>, "many">;
2170
1946
  status: z.ZodOptional<z.ZodEnum<["active", "draft", "disabled"]>>;
2171
1947
  }, "strict", z.ZodTypeAny, {
@@ -2174,16 +1950,16 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
2174
1950
  capability: string;
2175
1951
  } | {
2176
1952
  kind: "prop.value.avoid";
2177
- prop: string;
1953
+ severity: "error" | "warn" | "info";
2178
1954
  because: string;
2179
- severity: "error" | "info" | "warn";
1955
+ prop: string;
2180
1956
  value?: unknown;
2181
1957
  suggest?: string | undefined;
2182
1958
  } | {
2183
1959
  kind: "prop.value.forbid";
2184
- prop: string;
1960
+ severity: "error" | "warn" | "info";
2185
1961
  because: string;
2186
- severity: "error" | "info" | "warn";
1962
+ prop: string;
2187
1963
  value?: unknown;
2188
1964
  when?: {
2189
1965
  path?: string | undefined;
@@ -2193,26 +1969,26 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
2193
1969
  } | undefined;
2194
1970
  } | {
2195
1971
  kind: "a11y.requireName";
1972
+ severity: "error" | "warn" | "info";
2196
1973
  because: string;
2197
- severity: "error" | "info" | "warn";
2198
1974
  })[];
2199
- status?: "active" | "draft" | "disabled" | undefined;
1975
+ status?: "disabled" | "active" | "draft" | undefined;
2200
1976
  }, {
2201
1977
  rules: ({
2202
1978
  kind: "capability";
2203
1979
  capability: string;
2204
1980
  } | {
2205
1981
  kind: "prop.value.avoid";
2206
- prop: string;
1982
+ severity: "error" | "warn" | "info";
2207
1983
  because: string;
2208
- severity: "error" | "info" | "warn";
1984
+ prop: string;
2209
1985
  value?: unknown;
2210
1986
  suggest?: string | undefined;
2211
1987
  } | {
2212
1988
  kind: "prop.value.forbid";
2213
- prop: string;
1989
+ severity: "error" | "warn" | "info";
2214
1990
  because: string;
2215
- severity: "error" | "info" | "warn";
1991
+ prop: string;
2216
1992
  value?: unknown;
2217
1993
  when?: {
2218
1994
  path?: string | undefined;
@@ -2222,10 +1998,10 @@ declare const componentPolicyRecordSchema: z.ZodObject<{
2222
1998
  } | undefined;
2223
1999
  } | {
2224
2000
  kind: "a11y.requireName";
2001
+ severity: "error" | "warn" | "info";
2225
2002
  because: string;
2226
- severity: "error" | "info" | "warn";
2227
2003
  })[];
2228
- status?: "active" | "draft" | "disabled" | undefined;
2004
+ status?: "disabled" | "active" | "draft" | undefined;
2229
2005
  }>;
2230
2006
  declare const componentPolicyOverrideSchema: z.ZodObject<{
2231
2007
  match: z.ZodObject<{
@@ -2240,25 +2016,25 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
2240
2016
  name: z.ZodOptional<z.ZodString>;
2241
2017
  scope: z.ZodOptional<z.ZodEnum<["one", "all"]>>;
2242
2018
  }, "strict", z.ZodTypeAny, {
2243
- path?: string | undefined;
2244
2019
  name?: string | undefined;
2020
+ path?: string | undefined;
2245
2021
  importPath?: string | undefined;
2246
- componentId?: string | undefined;
2022
+ exportName?: string | undefined;
2247
2023
  componentKey?: string | undefined;
2024
+ componentId?: string | undefined;
2248
2025
  publicRef?: string | undefined;
2249
2026
  sourcePath?: string | undefined;
2250
- exportName?: string | undefined;
2251
2027
  export?: string | undefined;
2252
2028
  scope?: "one" | "all" | undefined;
2253
2029
  }, {
2254
- path?: string | undefined;
2255
2030
  name?: string | undefined;
2031
+ path?: string | undefined;
2256
2032
  importPath?: string | undefined;
2257
- componentId?: string | undefined;
2033
+ exportName?: string | undefined;
2258
2034
  componentKey?: string | undefined;
2035
+ componentId?: string | undefined;
2259
2036
  publicRef?: string | undefined;
2260
2037
  sourcePath?: string | undefined;
2261
- exportName?: string | undefined;
2262
2038
  export?: string | undefined;
2263
2039
  scope?: "one" | "all" | undefined;
2264
2040
  }>;
@@ -2280,16 +2056,16 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
2280
2056
  severity: z.ZodEnum<["error", "warn", "info"]>;
2281
2057
  }, "strip", z.ZodTypeAny, {
2282
2058
  kind: "prop.value.avoid";
2283
- prop: string;
2059
+ severity: "error" | "warn" | "info";
2284
2060
  because: string;
2285
- severity: "error" | "info" | "warn";
2061
+ prop: string;
2286
2062
  value?: unknown;
2287
2063
  suggest?: string | undefined;
2288
2064
  }, {
2289
2065
  kind: "prop.value.avoid";
2290
- prop: string;
2066
+ severity: "error" | "warn" | "info";
2291
2067
  because: string;
2292
- severity: "error" | "info" | "warn";
2068
+ prop: string;
2293
2069
  value?: unknown;
2294
2070
  suggest?: string | undefined;
2295
2071
  }>, z.ZodObject<{
@@ -2314,9 +2090,9 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
2314
2090
  severity: z.ZodEnum<["error", "warn", "info"]>;
2315
2091
  }, "strip", z.ZodTypeAny, {
2316
2092
  kind: "prop.value.forbid";
2317
- prop: string;
2093
+ severity: "error" | "warn" | "info";
2318
2094
  because: string;
2319
- severity: "error" | "info" | "warn";
2095
+ prop: string;
2320
2096
  value?: unknown;
2321
2097
  when?: {
2322
2098
  path?: string | undefined;
@@ -2326,9 +2102,9 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
2326
2102
  } | undefined;
2327
2103
  }, {
2328
2104
  kind: "prop.value.forbid";
2329
- prop: string;
2105
+ severity: "error" | "warn" | "info";
2330
2106
  because: string;
2331
- severity: "error" | "info" | "warn";
2107
+ prop: string;
2332
2108
  value?: unknown;
2333
2109
  when?: {
2334
2110
  path?: string | undefined;
@@ -2342,12 +2118,12 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
2342
2118
  severity: z.ZodEnum<["error", "warn", "info"]>;
2343
2119
  }, "strip", z.ZodTypeAny, {
2344
2120
  kind: "a11y.requireName";
2121
+ severity: "error" | "warn" | "info";
2345
2122
  because: string;
2346
- severity: "error" | "info" | "warn";
2347
2123
  }, {
2348
2124
  kind: "a11y.requireName";
2125
+ severity: "error" | "warn" | "info";
2349
2126
  because: string;
2350
- severity: "error" | "info" | "warn";
2351
2127
  }>]>, "many">;
2352
2128
  status: z.ZodOptional<z.ZodEnum<["active", "draft", "disabled"]>>;
2353
2129
  }, "strict", z.ZodTypeAny, {
@@ -2356,16 +2132,16 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
2356
2132
  capability: string;
2357
2133
  } | {
2358
2134
  kind: "prop.value.avoid";
2359
- prop: string;
2135
+ severity: "error" | "warn" | "info";
2360
2136
  because: string;
2361
- severity: "error" | "info" | "warn";
2137
+ prop: string;
2362
2138
  value?: unknown;
2363
2139
  suggest?: string | undefined;
2364
2140
  } | {
2365
2141
  kind: "prop.value.forbid";
2366
- prop: string;
2142
+ severity: "error" | "warn" | "info";
2367
2143
  because: string;
2368
- severity: "error" | "info" | "warn";
2144
+ prop: string;
2369
2145
  value?: unknown;
2370
2146
  when?: {
2371
2147
  path?: string | undefined;
@@ -2375,38 +2151,38 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
2375
2151
  } | undefined;
2376
2152
  } | {
2377
2153
  kind: "a11y.requireName";
2154
+ severity: "error" | "warn" | "info";
2378
2155
  because: string;
2379
- severity: "error" | "info" | "warn";
2380
2156
  })[];
2381
2157
  match: {
2382
- path?: string | undefined;
2383
2158
  name?: string | undefined;
2159
+ path?: string | undefined;
2384
2160
  importPath?: string | undefined;
2385
- componentId?: string | undefined;
2161
+ exportName?: string | undefined;
2386
2162
  componentKey?: string | undefined;
2163
+ componentId?: string | undefined;
2387
2164
  publicRef?: string | undefined;
2388
2165
  sourcePath?: string | undefined;
2389
- exportName?: string | undefined;
2390
2166
  export?: string | undefined;
2391
2167
  scope?: "one" | "all" | undefined;
2392
2168
  };
2393
- status?: "active" | "draft" | "disabled" | undefined;
2169
+ status?: "disabled" | "active" | "draft" | undefined;
2394
2170
  }, {
2395
2171
  rules: ({
2396
2172
  kind: "capability";
2397
2173
  capability: string;
2398
2174
  } | {
2399
2175
  kind: "prop.value.avoid";
2400
- prop: string;
2176
+ severity: "error" | "warn" | "info";
2401
2177
  because: string;
2402
- severity: "error" | "info" | "warn";
2178
+ prop: string;
2403
2179
  value?: unknown;
2404
2180
  suggest?: string | undefined;
2405
2181
  } | {
2406
2182
  kind: "prop.value.forbid";
2407
- prop: string;
2183
+ severity: "error" | "warn" | "info";
2408
2184
  because: string;
2409
- severity: "error" | "info" | "warn";
2185
+ prop: string;
2410
2186
  value?: unknown;
2411
2187
  when?: {
2412
2188
  path?: string | undefined;
@@ -2416,33 +2192,33 @@ declare const componentPolicyOverrideSchema: z.ZodObject<{
2416
2192
  } | undefined;
2417
2193
  } | {
2418
2194
  kind: "a11y.requireName";
2195
+ severity: "error" | "warn" | "info";
2419
2196
  because: string;
2420
- severity: "error" | "info" | "warn";
2421
2197
  })[];
2422
2198
  match: {
2423
- path?: string | undefined;
2424
2199
  name?: string | undefined;
2200
+ path?: string | undefined;
2425
2201
  importPath?: string | undefined;
2426
- componentId?: string | undefined;
2202
+ exportName?: string | undefined;
2427
2203
  componentKey?: string | undefined;
2204
+ componentId?: string | undefined;
2428
2205
  publicRef?: string | undefined;
2429
2206
  sourcePath?: string | undefined;
2430
- exportName?: string | undefined;
2431
2207
  export?: string | undefined;
2432
2208
  scope?: "one" | "all" | undefined;
2433
2209
  };
2434
- status?: "active" | "draft" | "disabled" | undefined;
2210
+ status?: "disabled" | "active" | "draft" | undefined;
2435
2211
  }>;
2436
2212
  declare const canonicalBridgeV1Schema: z.ZodObject<{
2437
2213
  underlying: z.ZodObject<{
2438
2214
  packageName: z.ZodString;
2439
2215
  exportName: z.ZodString;
2440
2216
  }, "strict", z.ZodTypeAny, {
2441
- exportName: string;
2442
2217
  packageName: string;
2443
- }, {
2444
2218
  exportName: string;
2219
+ }, {
2445
2220
  packageName: string;
2221
+ exportName: string;
2446
2222
  }>;
2447
2223
  local: z.ZodObject<{
2448
2224
  componentKey: z.ZodString;
@@ -2450,13 +2226,13 @@ declare const canonicalBridgeV1Schema: z.ZodObject<{
2450
2226
  exportName: z.ZodString;
2451
2227
  implementationFiles: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
2452
2228
  }, "strict", z.ZodTypeAny, {
2453
- componentKey: string;
2454
2229
  exportName: string;
2230
+ componentKey: string;
2455
2231
  moduleSpecifier: string;
2456
2232
  implementationFiles: string[];
2457
2233
  }, {
2458
- componentKey: string;
2459
2234
  exportName: string;
2235
+ componentKey: string;
2460
2236
  moduleSpecifier: string;
2461
2237
  implementationFiles: string[];
2462
2238
  }>;
@@ -2472,12 +2248,12 @@ declare const canonicalBridgeV1Schema: z.ZodObject<{
2472
2248
  }>;
2473
2249
  }, "strict", z.ZodTypeAny, {
2474
2250
  underlying: {
2475
- exportName: string;
2476
2251
  packageName: string;
2252
+ exportName: string;
2477
2253
  };
2478
2254
  local: {
2479
- componentKey: string;
2480
2255
  exportName: string;
2256
+ componentKey: string;
2481
2257
  moduleSpecifier: string;
2482
2258
  implementationFiles: string[];
2483
2259
  };
@@ -2487,12 +2263,12 @@ declare const canonicalBridgeV1Schema: z.ZodObject<{
2487
2263
  };
2488
2264
  }, {
2489
2265
  underlying: {
2490
- exportName: string;
2491
2266
  packageName: string;
2267
+ exportName: string;
2492
2268
  };
2493
2269
  local: {
2494
- componentKey: string;
2495
2270
  exportName: string;
2271
+ componentKey: string;
2496
2272
  moduleSpecifier: string;
2497
2273
  implementationFiles: string[];
2498
2274
  };
@@ -2510,30 +2286,30 @@ declare const canonicalSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObjec
2510
2286
  }, "strip", z.ZodTypeAny, {
2511
2287
  kind: "npm";
2512
2288
  specifier: string;
2513
- exclude?: string[] | undefined;
2514
2289
  implementationPath?: string | undefined;
2515
2290
  include?: string[] | undefined;
2291
+ exclude?: string[] | undefined;
2516
2292
  }, {
2517
2293
  kind: "npm";
2518
2294
  specifier: string;
2519
- exclude?: string[] | undefined;
2520
2295
  implementationPath?: string | undefined;
2521
2296
  include?: string[] | undefined;
2297
+ exclude?: string[] | undefined;
2522
2298
  }>, z.ZodObject<{
2523
2299
  kind: z.ZodLiteral<"directory">;
2524
2300
  path: z.ZodString;
2525
2301
  include: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2526
2302
  exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2527
2303
  }, "strip", z.ZodTypeAny, {
2528
- path: string;
2529
2304
  kind: "directory";
2530
- exclude?: string[] | undefined;
2305
+ path: string;
2531
2306
  include?: string[] | undefined;
2307
+ exclude?: string[] | undefined;
2532
2308
  }, {
2533
- path: string;
2534
2309
  kind: "directory";
2535
- exclude?: string[] | undefined;
2310
+ path: string;
2536
2311
  include?: string[] | undefined;
2312
+ exclude?: string[] | undefined;
2537
2313
  }>, z.ZodObject<{
2538
2314
  kind: z.ZodLiteral<"registry">;
2539
2315
  registryId: z.ZodString;
@@ -2549,19 +2325,19 @@ declare const canonicalSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObjec
2549
2325
  registryId: string;
2550
2326
  receiptPath: string;
2551
2327
  installPath: string;
2552
- severity?: "error" | "info" | "warn" | undefined;
2553
2328
  importPath?: string | undefined;
2554
- exclude?: string[] | undefined;
2329
+ severity?: "error" | "warn" | "info" | undefined;
2555
2330
  include?: string[] | undefined;
2331
+ exclude?: string[] | undefined;
2556
2332
  registryHash?: string | undefined;
2557
2333
  }, {
2558
2334
  kind: "registry";
2559
2335
  registryId: string;
2560
2336
  installPath: string;
2561
- severity?: "error" | "info" | "warn" | undefined;
2562
2337
  importPath?: string | undefined;
2563
- exclude?: string[] | undefined;
2338
+ severity?: "error" | "warn" | "info" | undefined;
2564
2339
  include?: string[] | undefined;
2340
+ exclude?: string[] | undefined;
2565
2341
  registryHash?: string | undefined;
2566
2342
  receiptPath?: string | undefined;
2567
2343
  }>]>;
@@ -2587,30 +2363,30 @@ declare const governanceConfigSchema: z.ZodObject<{
2587
2363
  }, "strip", z.ZodTypeAny, {
2588
2364
  kind: "npm";
2589
2365
  specifier: string;
2590
- exclude?: string[] | undefined;
2591
2366
  implementationPath?: string | undefined;
2592
2367
  include?: string[] | undefined;
2368
+ exclude?: string[] | undefined;
2593
2369
  }, {
2594
2370
  kind: "npm";
2595
2371
  specifier: string;
2596
- exclude?: string[] | undefined;
2597
2372
  implementationPath?: string | undefined;
2598
2373
  include?: string[] | undefined;
2374
+ exclude?: string[] | undefined;
2599
2375
  }>, z.ZodObject<{
2600
2376
  kind: z.ZodLiteral<"directory">;
2601
2377
  path: z.ZodString;
2602
2378
  include: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2603
2379
  exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2604
2380
  }, "strip", z.ZodTypeAny, {
2605
- path: string;
2606
2381
  kind: "directory";
2607
- exclude?: string[] | undefined;
2382
+ path: string;
2608
2383
  include?: string[] | undefined;
2384
+ exclude?: string[] | undefined;
2609
2385
  }, {
2610
- path: string;
2611
2386
  kind: "directory";
2612
- exclude?: string[] | undefined;
2387
+ path: string;
2613
2388
  include?: string[] | undefined;
2389
+ exclude?: string[] | undefined;
2614
2390
  }>, z.ZodObject<{
2615
2391
  kind: z.ZodLiteral<"registry">;
2616
2392
  registryId: z.ZodString;
@@ -2626,19 +2402,19 @@ declare const governanceConfigSchema: z.ZodObject<{
2626
2402
  registryId: string;
2627
2403
  receiptPath: string;
2628
2404
  installPath: string;
2629
- severity?: "error" | "info" | "warn" | undefined;
2630
2405
  importPath?: string | undefined;
2631
- exclude?: string[] | undefined;
2406
+ severity?: "error" | "warn" | "info" | undefined;
2632
2407
  include?: string[] | undefined;
2408
+ exclude?: string[] | undefined;
2633
2409
  registryHash?: string | undefined;
2634
2410
  }, {
2635
2411
  kind: "registry";
2636
2412
  registryId: string;
2637
2413
  installPath: string;
2638
- severity?: "error" | "info" | "warn" | undefined;
2639
2414
  importPath?: string | undefined;
2640
- exclude?: string[] | undefined;
2415
+ severity?: "error" | "warn" | "info" | undefined;
2641
2416
  include?: string[] | undefined;
2417
+ exclude?: string[] | undefined;
2642
2418
  registryHash?: string | undefined;
2643
2419
  receiptPath?: string | undefined;
2644
2420
  }>]>, "many">>;
@@ -2647,11 +2423,11 @@ declare const governanceConfigSchema: z.ZodObject<{
2647
2423
  packageName: z.ZodString;
2648
2424
  exportName: z.ZodString;
2649
2425
  }, "strict", z.ZodTypeAny, {
2650
- exportName: string;
2651
2426
  packageName: string;
2652
- }, {
2653
2427
  exportName: string;
2428
+ }, {
2654
2429
  packageName: string;
2430
+ exportName: string;
2655
2431
  }>;
2656
2432
  local: z.ZodObject<{
2657
2433
  componentKey: z.ZodString;
@@ -2659,13 +2435,13 @@ declare const governanceConfigSchema: z.ZodObject<{
2659
2435
  exportName: z.ZodString;
2660
2436
  implementationFiles: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
2661
2437
  }, "strict", z.ZodTypeAny, {
2662
- componentKey: string;
2663
2438
  exportName: string;
2439
+ componentKey: string;
2664
2440
  moduleSpecifier: string;
2665
2441
  implementationFiles: string[];
2666
2442
  }, {
2667
- componentKey: string;
2668
2443
  exportName: string;
2444
+ componentKey: string;
2669
2445
  moduleSpecifier: string;
2670
2446
  implementationFiles: string[];
2671
2447
  }>;
@@ -2681,12 +2457,12 @@ declare const governanceConfigSchema: z.ZodObject<{
2681
2457
  }>;
2682
2458
  }, "strict", z.ZodTypeAny, {
2683
2459
  underlying: {
2684
- exportName: string;
2685
2460
  packageName: string;
2461
+ exportName: string;
2686
2462
  };
2687
2463
  local: {
2688
- componentKey: string;
2689
2464
  exportName: string;
2465
+ componentKey: string;
2690
2466
  moduleSpecifier: string;
2691
2467
  implementationFiles: string[];
2692
2468
  };
@@ -2696,12 +2472,12 @@ declare const governanceConfigSchema: z.ZodObject<{
2696
2472
  };
2697
2473
  }, {
2698
2474
  underlying: {
2699
- exportName: string;
2700
2475
  packageName: string;
2476
+ exportName: string;
2701
2477
  };
2702
2478
  local: {
2703
- componentKey: string;
2704
2479
  exportName: string;
2480
+ componentKey: string;
2705
2481
  moduleSpecifier: string;
2706
2482
  implementationFiles: string[];
2707
2483
  };
@@ -2711,12 +2487,12 @@ declare const governanceConfigSchema: z.ZodObject<{
2711
2487
  };
2712
2488
  }>, "many">, {
2713
2489
  underlying: {
2714
- exportName: string;
2715
2490
  packageName: string;
2491
+ exportName: string;
2716
2492
  };
2717
2493
  local: {
2718
- componentKey: string;
2719
2494
  exportName: string;
2495
+ componentKey: string;
2720
2496
  moduleSpecifier: string;
2721
2497
  implementationFiles: string[];
2722
2498
  };
@@ -2726,12 +2502,12 @@ declare const governanceConfigSchema: z.ZodObject<{
2726
2502
  };
2727
2503
  }[], {
2728
2504
  underlying: {
2729
- exportName: string;
2730
2505
  packageName: string;
2506
+ exportName: string;
2731
2507
  };
2732
2508
  local: {
2733
- componentKey: string;
2734
2509
  exportName: string;
2510
+ componentKey: string;
2735
2511
  moduleSpecifier: string;
2736
2512
  implementationFiles: string[];
2737
2513
  };
@@ -2780,7 +2556,7 @@ declare const governanceConfigSchema: z.ZodObject<{
2780
2556
  }>]>, "many">>;
2781
2557
  }, "strip", z.ZodTypeAny, {
2782
2558
  kind: "style.rawColors.forbid";
2783
- severity: "error" | "info" | "warn";
2559
+ severity: "error" | "warn" | "info";
2784
2560
  except: string[];
2785
2561
  prefer: "token" | "css-variable";
2786
2562
  exclude?: (string | {
@@ -2789,7 +2565,7 @@ declare const governanceConfigSchema: z.ZodObject<{
2789
2565
  })[] | undefined;
2790
2566
  }, {
2791
2567
  kind: "style.rawColors.forbid";
2792
- severity: "error" | "info" | "warn";
2568
+ severity: "error" | "warn" | "info";
2793
2569
  except: string[];
2794
2570
  prefer: "token" | "css-variable";
2795
2571
  exclude?: (string | {
@@ -2813,7 +2589,7 @@ declare const governanceConfigSchema: z.ZodObject<{
2813
2589
  }>]>, "many">>;
2814
2590
  }, "strip", z.ZodTypeAny, {
2815
2591
  kind: "style.rawDimensions.forbid";
2816
- severity: "error" | "info" | "warn";
2592
+ severity: "error" | "warn" | "info";
2817
2593
  prefer: "token" | "css-variable";
2818
2594
  appliesTo: string[];
2819
2595
  exclude?: (string | {
@@ -2822,7 +2598,7 @@ declare const governanceConfigSchema: z.ZodObject<{
2822
2598
  })[] | undefined;
2823
2599
  }, {
2824
2600
  kind: "style.rawDimensions.forbid";
2825
- severity: "error" | "info" | "warn";
2601
+ severity: "error" | "warn" | "info";
2826
2602
  prefer: "token" | "css-variable";
2827
2603
  appliesTo: string[];
2828
2604
  exclude?: (string | {
@@ -2846,7 +2622,7 @@ declare const governanceConfigSchema: z.ZodObject<{
2846
2622
  }>]>, "many">>;
2847
2623
  }, "strip", z.ZodTypeAny, {
2848
2624
  kind: "style.rawSpacing.mustMatchScale";
2849
- severity: "error" | "info" | "warn";
2625
+ severity: "error" | "warn" | "info";
2850
2626
  scale: string;
2851
2627
  appliesTo: string[];
2852
2628
  exclude?: (string | {
@@ -2855,7 +2631,7 @@ declare const governanceConfigSchema: z.ZodObject<{
2855
2631
  })[] | undefined;
2856
2632
  }, {
2857
2633
  kind: "style.rawSpacing.mustMatchScale";
2858
- severity: "error" | "info" | "warn";
2634
+ severity: "error" | "warn" | "info";
2859
2635
  scale: string;
2860
2636
  appliesTo: string[];
2861
2637
  exclude?: (string | {
@@ -2878,7 +2654,7 @@ declare const governanceConfigSchema: z.ZodObject<{
2878
2654
  }>]>, "many">>;
2879
2655
  }, "strip", z.ZodTypeAny, {
2880
2656
  kind: "style.fontSize.mustMatchScale";
2881
- severity: "error" | "info" | "warn";
2657
+ severity: "error" | "warn" | "info";
2882
2658
  scale: string;
2883
2659
  exclude?: (string | {
2884
2660
  glob: string;
@@ -2886,7 +2662,7 @@ declare const governanceConfigSchema: z.ZodObject<{
2886
2662
  })[] | undefined;
2887
2663
  }, {
2888
2664
  kind: "style.fontSize.mustMatchScale";
2889
- severity: "error" | "info" | "warn";
2665
+ severity: "error" | "warn" | "info";
2890
2666
  scale: string;
2891
2667
  exclude?: (string | {
2892
2668
  glob: string;
@@ -2907,14 +2683,14 @@ declare const governanceConfigSchema: z.ZodObject<{
2907
2683
  }>]>, "many">>;
2908
2684
  }, "strip", z.ZodTypeAny, {
2909
2685
  kind: "style.cssVars.mustBeDefined";
2910
- severity: "error" | "info" | "warn";
2686
+ severity: "error" | "warn" | "info";
2911
2687
  exclude?: (string | {
2912
2688
  glob: string;
2913
2689
  reason?: string | undefined;
2914
2690
  })[] | undefined;
2915
2691
  }, {
2916
2692
  kind: "style.cssVars.mustBeDefined";
2917
- severity: "error" | "info" | "warn";
2693
+ severity: "error" | "warn" | "info";
2918
2694
  exclude?: (string | {
2919
2695
  glob: string;
2920
2696
  reason?: string | undefined;
@@ -2935,14 +2711,14 @@ declare const governanceConfigSchema: z.ZodObject<{
2935
2711
  }>]>, "many">>;
2936
2712
  }, "strip", z.ZodTypeAny, {
2937
2713
  kind: "jsx.unknownProps.forbid";
2938
- severity: "error" | "info" | "warn";
2714
+ severity: "error" | "warn" | "info";
2939
2715
  exclude?: (string | {
2940
2716
  glob: string;
2941
2717
  reason?: string | undefined;
2942
2718
  })[] | undefined;
2943
2719
  }, {
2944
2720
  kind: "jsx.unknownProps.forbid";
2945
- severity: "error" | "info" | "warn";
2721
+ severity: "error" | "warn" | "info";
2946
2722
  exclude?: (string | {
2947
2723
  glob: string;
2948
2724
  reason?: string | undefined;
@@ -2963,7 +2739,7 @@ declare const governanceConfigSchema: z.ZodObject<{
2963
2739
  }>]>, "many">>;
2964
2740
  }, "strip", z.ZodTypeAny, {
2965
2741
  kind: "jsx.inlineStyle.forbidRaw";
2966
- severity: "error" | "info" | "warn";
2742
+ severity: "error" | "warn" | "info";
2967
2743
  properties: string[];
2968
2744
  exclude?: (string | {
2969
2745
  glob: string;
@@ -2971,7 +2747,7 @@ declare const governanceConfigSchema: z.ZodObject<{
2971
2747
  })[] | undefined;
2972
2748
  }, {
2973
2749
  kind: "jsx.inlineStyle.forbidRaw";
2974
- severity: "error" | "info" | "warn";
2750
+ severity: "error" | "warn" | "info";
2975
2751
  properties: string[];
2976
2752
  exclude?: (string | {
2977
2753
  glob: string;
@@ -2996,26 +2772,26 @@ declare const governanceConfigSchema: z.ZodObject<{
2996
2772
  }>]>, "many">>;
2997
2773
  }, "strip", z.ZodTypeAny, {
2998
2774
  kind: "jsx.importPath.prefer";
2999
- severity: "error" | "info" | "warn";
2775
+ severity: "error" | "warn" | "info";
3000
2776
  from: string;
3001
2777
  to: string;
3002
- because?: string | undefined;
3003
2778
  exclude?: (string | {
3004
2779
  glob: string;
3005
2780
  reason?: string | undefined;
3006
2781
  })[] | undefined;
3007
2782
  imported?: string | undefined;
2783
+ because?: string | undefined;
3008
2784
  }, {
3009
2785
  kind: "jsx.importPath.prefer";
3010
- severity: "error" | "info" | "warn";
2786
+ severity: "error" | "warn" | "info";
3011
2787
  from: string;
3012
2788
  to: string;
3013
- because?: string | undefined;
3014
2789
  exclude?: (string | {
3015
2790
  glob: string;
3016
2791
  reason?: string | undefined;
3017
2792
  })[] | undefined;
3018
2793
  imported?: string | undefined;
2794
+ because?: string | undefined;
3019
2795
  }>, z.ZodObject<{
3020
2796
  kind: z.ZodLiteral<"jsx.component.prefer">;
3021
2797
  from: z.ZodString;
@@ -3034,24 +2810,24 @@ declare const governanceConfigSchema: z.ZodObject<{
3034
2810
  }>]>, "many">>;
3035
2811
  }, "strip", z.ZodTypeAny, {
3036
2812
  kind: "jsx.component.prefer";
3037
- severity: "error" | "info" | "warn";
2813
+ severity: "error" | "warn" | "info";
3038
2814
  from: string;
3039
2815
  to: string;
3040
- because?: string | undefined;
3041
2816
  exclude?: (string | {
3042
2817
  glob: string;
3043
2818
  reason?: string | undefined;
3044
2819
  })[] | undefined;
2820
+ because?: string | undefined;
3045
2821
  }, {
3046
2822
  kind: "jsx.component.prefer";
3047
- severity: "error" | "info" | "warn";
2823
+ severity: "error" | "warn" | "info";
3048
2824
  from: string;
3049
2825
  to: string;
3050
- because?: string | undefined;
3051
2826
  exclude?: (string | {
3052
2827
  glob: string;
3053
2828
  reason?: string | undefined;
3054
2829
  })[] | undefined;
2830
+ because?: string | undefined;
3055
2831
  }>]>, "many">>;
3056
2832
  tailwind: z.ZodOptional<z.ZodObject<{
3057
2833
  palette: z.ZodOptional<z.ZodObject<{
@@ -3113,16 +2889,16 @@ declare const governanceConfigSchema: z.ZodObject<{
3113
2889
  severity: z.ZodEnum<["error", "warn", "info"]>;
3114
2890
  }, "strip", z.ZodTypeAny, {
3115
2891
  kind: "prop.value.avoid";
3116
- prop: string;
2892
+ severity: "error" | "warn" | "info";
3117
2893
  because: string;
3118
- severity: "error" | "info" | "warn";
2894
+ prop: string;
3119
2895
  value?: unknown;
3120
2896
  suggest?: string | undefined;
3121
2897
  }, {
3122
2898
  kind: "prop.value.avoid";
3123
- prop: string;
2899
+ severity: "error" | "warn" | "info";
3124
2900
  because: string;
3125
- severity: "error" | "info" | "warn";
2901
+ prop: string;
3126
2902
  value?: unknown;
3127
2903
  suggest?: string | undefined;
3128
2904
  }>, z.ZodObject<{
@@ -3147,9 +2923,9 @@ declare const governanceConfigSchema: z.ZodObject<{
3147
2923
  severity: z.ZodEnum<["error", "warn", "info"]>;
3148
2924
  }, "strip", z.ZodTypeAny, {
3149
2925
  kind: "prop.value.forbid";
3150
- prop: string;
2926
+ severity: "error" | "warn" | "info";
3151
2927
  because: string;
3152
- severity: "error" | "info" | "warn";
2928
+ prop: string;
3153
2929
  value?: unknown;
3154
2930
  when?: {
3155
2931
  path?: string | undefined;
@@ -3159,9 +2935,9 @@ declare const governanceConfigSchema: z.ZodObject<{
3159
2935
  } | undefined;
3160
2936
  }, {
3161
2937
  kind: "prop.value.forbid";
3162
- prop: string;
2938
+ severity: "error" | "warn" | "info";
3163
2939
  because: string;
3164
- severity: "error" | "info" | "warn";
2940
+ prop: string;
3165
2941
  value?: unknown;
3166
2942
  when?: {
3167
2943
  path?: string | undefined;
@@ -3175,12 +2951,12 @@ declare const governanceConfigSchema: z.ZodObject<{
3175
2951
  severity: z.ZodEnum<["error", "warn", "info"]>;
3176
2952
  }, "strip", z.ZodTypeAny, {
3177
2953
  kind: "a11y.requireName";
2954
+ severity: "error" | "warn" | "info";
3178
2955
  because: string;
3179
- severity: "error" | "info" | "warn";
3180
2956
  }, {
3181
2957
  kind: "a11y.requireName";
2958
+ severity: "error" | "warn" | "info";
3182
2959
  because: string;
3183
- severity: "error" | "info" | "warn";
3184
2960
  }>]>, "many">;
3185
2961
  status: z.ZodOptional<z.ZodEnum<["active", "draft", "disabled"]>>;
3186
2962
  }, "strict", z.ZodTypeAny, {
@@ -3189,16 +2965,16 @@ declare const governanceConfigSchema: z.ZodObject<{
3189
2965
  capability: string;
3190
2966
  } | {
3191
2967
  kind: "prop.value.avoid";
3192
- prop: string;
2968
+ severity: "error" | "warn" | "info";
3193
2969
  because: string;
3194
- severity: "error" | "info" | "warn";
2970
+ prop: string;
3195
2971
  value?: unknown;
3196
2972
  suggest?: string | undefined;
3197
2973
  } | {
3198
2974
  kind: "prop.value.forbid";
3199
- prop: string;
2975
+ severity: "error" | "warn" | "info";
3200
2976
  because: string;
3201
- severity: "error" | "info" | "warn";
2977
+ prop: string;
3202
2978
  value?: unknown;
3203
2979
  when?: {
3204
2980
  path?: string | undefined;
@@ -3208,26 +2984,26 @@ declare const governanceConfigSchema: z.ZodObject<{
3208
2984
  } | undefined;
3209
2985
  } | {
3210
2986
  kind: "a11y.requireName";
2987
+ severity: "error" | "warn" | "info";
3211
2988
  because: string;
3212
- severity: "error" | "info" | "warn";
3213
2989
  })[];
3214
- status?: "active" | "draft" | "disabled" | undefined;
2990
+ status?: "disabled" | "active" | "draft" | undefined;
3215
2991
  }, {
3216
2992
  rules: ({
3217
2993
  kind: "capability";
3218
2994
  capability: string;
3219
2995
  } | {
3220
2996
  kind: "prop.value.avoid";
3221
- prop: string;
2997
+ severity: "error" | "warn" | "info";
3222
2998
  because: string;
3223
- severity: "error" | "info" | "warn";
2999
+ prop: string;
3224
3000
  value?: unknown;
3225
3001
  suggest?: string | undefined;
3226
3002
  } | {
3227
3003
  kind: "prop.value.forbid";
3228
- prop: string;
3004
+ severity: "error" | "warn" | "info";
3229
3005
  because: string;
3230
- severity: "error" | "info" | "warn";
3006
+ prop: string;
3231
3007
  value?: unknown;
3232
3008
  when?: {
3233
3009
  path?: string | undefined;
@@ -3237,10 +3013,10 @@ declare const governanceConfigSchema: z.ZodObject<{
3237
3013
  } | undefined;
3238
3014
  } | {
3239
3015
  kind: "a11y.requireName";
3016
+ severity: "error" | "warn" | "info";
3240
3017
  because: string;
3241
- severity: "error" | "info" | "warn";
3242
3018
  })[];
3243
- status?: "active" | "draft" | "disabled" | undefined;
3019
+ status?: "disabled" | "active" | "draft" | undefined;
3244
3020
  }>>>;
3245
3021
  overrides: z.ZodOptional<z.ZodArray<z.ZodObject<{
3246
3022
  match: z.ZodObject<{
@@ -3255,25 +3031,25 @@ declare const governanceConfigSchema: z.ZodObject<{
3255
3031
  name: z.ZodOptional<z.ZodString>;
3256
3032
  scope: z.ZodOptional<z.ZodEnum<["one", "all"]>>;
3257
3033
  }, "strict", z.ZodTypeAny, {
3258
- path?: string | undefined;
3259
3034
  name?: string | undefined;
3035
+ path?: string | undefined;
3260
3036
  importPath?: string | undefined;
3261
- componentId?: string | undefined;
3037
+ exportName?: string | undefined;
3262
3038
  componentKey?: string | undefined;
3039
+ componentId?: string | undefined;
3263
3040
  publicRef?: string | undefined;
3264
3041
  sourcePath?: string | undefined;
3265
- exportName?: string | undefined;
3266
3042
  export?: string | undefined;
3267
3043
  scope?: "one" | "all" | undefined;
3268
3044
  }, {
3269
- path?: string | undefined;
3270
3045
  name?: string | undefined;
3046
+ path?: string | undefined;
3271
3047
  importPath?: string | undefined;
3272
- componentId?: string | undefined;
3048
+ exportName?: string | undefined;
3273
3049
  componentKey?: string | undefined;
3050
+ componentId?: string | undefined;
3274
3051
  publicRef?: string | undefined;
3275
3052
  sourcePath?: string | undefined;
3276
- exportName?: string | undefined;
3277
3053
  export?: string | undefined;
3278
3054
  scope?: "one" | "all" | undefined;
3279
3055
  }>;
@@ -3295,16 +3071,16 @@ declare const governanceConfigSchema: z.ZodObject<{
3295
3071
  severity: z.ZodEnum<["error", "warn", "info"]>;
3296
3072
  }, "strip", z.ZodTypeAny, {
3297
3073
  kind: "prop.value.avoid";
3298
- prop: string;
3074
+ severity: "error" | "warn" | "info";
3299
3075
  because: string;
3300
- severity: "error" | "info" | "warn";
3076
+ prop: string;
3301
3077
  value?: unknown;
3302
3078
  suggest?: string | undefined;
3303
3079
  }, {
3304
3080
  kind: "prop.value.avoid";
3305
- prop: string;
3081
+ severity: "error" | "warn" | "info";
3306
3082
  because: string;
3307
- severity: "error" | "info" | "warn";
3083
+ prop: string;
3308
3084
  value?: unknown;
3309
3085
  suggest?: string | undefined;
3310
3086
  }>, z.ZodObject<{
@@ -3329,9 +3105,9 @@ declare const governanceConfigSchema: z.ZodObject<{
3329
3105
  severity: z.ZodEnum<["error", "warn", "info"]>;
3330
3106
  }, "strip", z.ZodTypeAny, {
3331
3107
  kind: "prop.value.forbid";
3332
- prop: string;
3108
+ severity: "error" | "warn" | "info";
3333
3109
  because: string;
3334
- severity: "error" | "info" | "warn";
3110
+ prop: string;
3335
3111
  value?: unknown;
3336
3112
  when?: {
3337
3113
  path?: string | undefined;
@@ -3341,9 +3117,9 @@ declare const governanceConfigSchema: z.ZodObject<{
3341
3117
  } | undefined;
3342
3118
  }, {
3343
3119
  kind: "prop.value.forbid";
3344
- prop: string;
3120
+ severity: "error" | "warn" | "info";
3345
3121
  because: string;
3346
- severity: "error" | "info" | "warn";
3122
+ prop: string;
3347
3123
  value?: unknown;
3348
3124
  when?: {
3349
3125
  path?: string | undefined;
@@ -3357,12 +3133,12 @@ declare const governanceConfigSchema: z.ZodObject<{
3357
3133
  severity: z.ZodEnum<["error", "warn", "info"]>;
3358
3134
  }, "strip", z.ZodTypeAny, {
3359
3135
  kind: "a11y.requireName";
3136
+ severity: "error" | "warn" | "info";
3360
3137
  because: string;
3361
- severity: "error" | "info" | "warn";
3362
3138
  }, {
3363
3139
  kind: "a11y.requireName";
3140
+ severity: "error" | "warn" | "info";
3364
3141
  because: string;
3365
- severity: "error" | "info" | "warn";
3366
3142
  }>]>, "many">;
3367
3143
  status: z.ZodOptional<z.ZodEnum<["active", "draft", "disabled"]>>;
3368
3144
  }, "strict", z.ZodTypeAny, {
@@ -3371,16 +3147,16 @@ declare const governanceConfigSchema: z.ZodObject<{
3371
3147
  capability: string;
3372
3148
  } | {
3373
3149
  kind: "prop.value.avoid";
3374
- prop: string;
3150
+ severity: "error" | "warn" | "info";
3375
3151
  because: string;
3376
- severity: "error" | "info" | "warn";
3152
+ prop: string;
3377
3153
  value?: unknown;
3378
3154
  suggest?: string | undefined;
3379
3155
  } | {
3380
3156
  kind: "prop.value.forbid";
3381
- prop: string;
3157
+ severity: "error" | "warn" | "info";
3382
3158
  because: string;
3383
- severity: "error" | "info" | "warn";
3159
+ prop: string;
3384
3160
  value?: unknown;
3385
3161
  when?: {
3386
3162
  path?: string | undefined;
@@ -3390,38 +3166,38 @@ declare const governanceConfigSchema: z.ZodObject<{
3390
3166
  } | undefined;
3391
3167
  } | {
3392
3168
  kind: "a11y.requireName";
3169
+ severity: "error" | "warn" | "info";
3393
3170
  because: string;
3394
- severity: "error" | "info" | "warn";
3395
3171
  })[];
3396
3172
  match: {
3397
- path?: string | undefined;
3398
3173
  name?: string | undefined;
3174
+ path?: string | undefined;
3399
3175
  importPath?: string | undefined;
3400
- componentId?: string | undefined;
3176
+ exportName?: string | undefined;
3401
3177
  componentKey?: string | undefined;
3178
+ componentId?: string | undefined;
3402
3179
  publicRef?: string | undefined;
3403
3180
  sourcePath?: string | undefined;
3404
- exportName?: string | undefined;
3405
3181
  export?: string | undefined;
3406
3182
  scope?: "one" | "all" | undefined;
3407
3183
  };
3408
- status?: "active" | "draft" | "disabled" | undefined;
3184
+ status?: "disabled" | "active" | "draft" | undefined;
3409
3185
  }, {
3410
3186
  rules: ({
3411
3187
  kind: "capability";
3412
3188
  capability: string;
3413
3189
  } | {
3414
3190
  kind: "prop.value.avoid";
3415
- prop: string;
3191
+ severity: "error" | "warn" | "info";
3416
3192
  because: string;
3417
- severity: "error" | "info" | "warn";
3193
+ prop: string;
3418
3194
  value?: unknown;
3419
3195
  suggest?: string | undefined;
3420
3196
  } | {
3421
3197
  kind: "prop.value.forbid";
3422
- prop: string;
3198
+ severity: "error" | "warn" | "info";
3423
3199
  because: string;
3424
- severity: "error" | "info" | "warn";
3200
+ prop: string;
3425
3201
  value?: unknown;
3426
3202
  when?: {
3427
3203
  path?: string | undefined;
@@ -3431,22 +3207,22 @@ declare const governanceConfigSchema: z.ZodObject<{
3431
3207
  } | undefined;
3432
3208
  } | {
3433
3209
  kind: "a11y.requireName";
3210
+ severity: "error" | "warn" | "info";
3434
3211
  because: string;
3435
- severity: "error" | "info" | "warn";
3436
3212
  })[];
3437
3213
  match: {
3438
- path?: string | undefined;
3439
3214
  name?: string | undefined;
3215
+ path?: string | undefined;
3440
3216
  importPath?: string | undefined;
3441
- componentId?: string | undefined;
3217
+ exportName?: string | undefined;
3442
3218
  componentKey?: string | undefined;
3219
+ componentId?: string | undefined;
3443
3220
  publicRef?: string | undefined;
3444
3221
  sourcePath?: string | undefined;
3445
- exportName?: string | undefined;
3446
3222
  export?: string | undefined;
3447
3223
  scope?: "one" | "all" | undefined;
3448
3224
  };
3449
- status?: "active" | "draft" | "disabled" | undefined;
3225
+ status?: "disabled" | "active" | "draft" | undefined;
3450
3226
  }>, "many">>;
3451
3227
  ci: z.ZodOptional<z.ZodObject<{
3452
3228
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
@@ -3468,16 +3244,16 @@ declare const governanceConfigSchema: z.ZodObject<{
3468
3244
  capability: string;
3469
3245
  } | {
3470
3246
  kind: "prop.value.avoid";
3471
- prop: string;
3247
+ severity: "error" | "warn" | "info";
3472
3248
  because: string;
3473
- severity: "error" | "info" | "warn";
3249
+ prop: string;
3474
3250
  value?: unknown;
3475
3251
  suggest?: string | undefined;
3476
3252
  } | {
3477
3253
  kind: "prop.value.forbid";
3478
- prop: string;
3254
+ severity: "error" | "warn" | "info";
3479
3255
  because: string;
3480
- severity: "error" | "info" | "warn";
3256
+ prop: string;
3481
3257
  value?: unknown;
3482
3258
  when?: {
3483
3259
  path?: string | undefined;
@@ -3487,13 +3263,58 @@ declare const governanceConfigSchema: z.ZodObject<{
3487
3263
  } | undefined;
3488
3264
  } | {
3489
3265
  kind: "a11y.requireName";
3266
+ severity: "error" | "warn" | "info";
3490
3267
  because: string;
3491
- severity: "error" | "info" | "warn";
3492
3268
  })[];
3493
- status?: "active" | "draft" | "disabled" | undefined;
3269
+ status?: "disabled" | "active" | "draft" | undefined;
3494
3270
  }> | undefined;
3495
- severity?: "error" | "info" | "warn" | undefined;
3496
3271
  rules?: Record<string, unknown> | undefined;
3272
+ severity?: "error" | "warn" | "info" | undefined;
3273
+ extends?: string[] | undefined;
3274
+ agents?: Record<string, z.objectOutputType<{
3275
+ rules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3276
+ }, z.ZodTypeAny, "passthrough">> | undefined;
3277
+ audit?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
3278
+ runners?: Record<string, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">> | undefined;
3279
+ canonicalSources?: ({
3280
+ kind: "npm";
3281
+ specifier: string;
3282
+ implementationPath?: string | undefined;
3283
+ include?: string[] | undefined;
3284
+ exclude?: string[] | undefined;
3285
+ } | {
3286
+ kind: "directory";
3287
+ path: string;
3288
+ include?: string[] | undefined;
3289
+ exclude?: string[] | undefined;
3290
+ } | {
3291
+ kind: "registry";
3292
+ registryId: string;
3293
+ receiptPath: string;
3294
+ installPath: string;
3295
+ importPath?: string | undefined;
3296
+ severity?: "error" | "warn" | "info" | undefined;
3297
+ include?: string[] | undefined;
3298
+ exclude?: string[] | undefined;
3299
+ registryHash?: string | undefined;
3300
+ })[] | undefined;
3301
+ canonicalBridges?: {
3302
+ underlying: {
3303
+ packageName: string;
3304
+ exportName: string;
3305
+ };
3306
+ local: {
3307
+ exportName: string;
3308
+ componentKey: string;
3309
+ moduleSpecifier: string;
3310
+ implementationFiles: string[];
3311
+ };
3312
+ decision: {
3313
+ source: "authored" | "migration";
3314
+ state: "confirmed";
3315
+ };
3316
+ }[] | undefined;
3317
+ presets?: string[] | undefined;
3497
3318
  scales?: Record<string, {
3498
3319
  values: number[];
3499
3320
  kind: "scale";
@@ -3504,7 +3325,7 @@ declare const governanceConfigSchema: z.ZodObject<{
3504
3325
  }> | undefined;
3505
3326
  styles?: ({
3506
3327
  kind: "style.rawColors.forbid";
3507
- severity: "error" | "info" | "warn";
3328
+ severity: "error" | "warn" | "info";
3508
3329
  except: string[];
3509
3330
  prefer: "token" | "css-variable";
3510
3331
  exclude?: (string | {
@@ -3513,7 +3334,7 @@ declare const governanceConfigSchema: z.ZodObject<{
3513
3334
  })[] | undefined;
3514
3335
  } | {
3515
3336
  kind: "style.rawDimensions.forbid";
3516
- severity: "error" | "info" | "warn";
3337
+ severity: "error" | "warn" | "info";
3517
3338
  prefer: "token" | "css-variable";
3518
3339
  appliesTo: string[];
3519
3340
  exclude?: (string | {
@@ -3522,7 +3343,7 @@ declare const governanceConfigSchema: z.ZodObject<{
3522
3343
  })[] | undefined;
3523
3344
  } | {
3524
3345
  kind: "style.rawSpacing.mustMatchScale";
3525
- severity: "error" | "info" | "warn";
3346
+ severity: "error" | "warn" | "info";
3526
3347
  scale: string;
3527
3348
  appliesTo: string[];
3528
3349
  exclude?: (string | {
@@ -3531,7 +3352,7 @@ declare const governanceConfigSchema: z.ZodObject<{
3531
3352
  })[] | undefined;
3532
3353
  } | {
3533
3354
  kind: "style.fontSize.mustMatchScale";
3534
- severity: "error" | "info" | "warn";
3355
+ severity: "error" | "warn" | "info";
3535
3356
  scale: string;
3536
3357
  exclude?: (string | {
3537
3358
  glob: string;
@@ -3539,7 +3360,7 @@ declare const governanceConfigSchema: z.ZodObject<{
3539
3360
  })[] | undefined;
3540
3361
  } | {
3541
3362
  kind: "style.cssVars.mustBeDefined";
3542
- severity: "error" | "info" | "warn";
3363
+ severity: "error" | "warn" | "info";
3543
3364
  exclude?: (string | {
3544
3365
  glob: string;
3545
3366
  reason?: string | undefined;
@@ -3547,14 +3368,14 @@ declare const governanceConfigSchema: z.ZodObject<{
3547
3368
  })[] | undefined;
3548
3369
  jsx?: ({
3549
3370
  kind: "jsx.unknownProps.forbid";
3550
- severity: "error" | "info" | "warn";
3371
+ severity: "error" | "warn" | "info";
3551
3372
  exclude?: (string | {
3552
3373
  glob: string;
3553
3374
  reason?: string | undefined;
3554
3375
  })[] | undefined;
3555
3376
  } | {
3556
3377
  kind: "jsx.inlineStyle.forbidRaw";
3557
- severity: "error" | "info" | "warn";
3378
+ severity: "error" | "warn" | "info";
3558
3379
  properties: string[];
3559
3380
  exclude?: (string | {
3560
3381
  glob: string;
@@ -3562,25 +3383,25 @@ declare const governanceConfigSchema: z.ZodObject<{
3562
3383
  })[] | undefined;
3563
3384
  } | {
3564
3385
  kind: "jsx.importPath.prefer";
3565
- severity: "error" | "info" | "warn";
3386
+ severity: "error" | "warn" | "info";
3566
3387
  from: string;
3567
3388
  to: string;
3568
- because?: string | undefined;
3569
3389
  exclude?: (string | {
3570
3390
  glob: string;
3571
3391
  reason?: string | undefined;
3572
3392
  })[] | undefined;
3573
3393
  imported?: string | undefined;
3394
+ because?: string | undefined;
3574
3395
  } | {
3575
3396
  kind: "jsx.component.prefer";
3576
- severity: "error" | "info" | "warn";
3397
+ severity: "error" | "warn" | "info";
3577
3398
  from: string;
3578
3399
  to: string;
3579
- because?: string | undefined;
3580
3400
  exclude?: (string | {
3581
3401
  glob: string;
3582
3402
  reason?: string | undefined;
3583
3403
  })[] | undefined;
3404
+ because?: string | undefined;
3584
3405
  })[] | undefined;
3585
3406
  tailwind?: z.objectOutputType<{
3586
3407
  palette: z.ZodOptional<z.ZodObject<{
@@ -3594,22 +3415,25 @@ declare const governanceConfigSchema: z.ZodObject<{
3594
3415
  deny?: string[] | undefined;
3595
3416
  }>>;
3596
3417
  }, z.ZodTypeAny, "passthrough"> | undefined;
3418
+ agent?: z.objectOutputType<{
3419
+ repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3420
+ }, z.ZodTypeAny, "passthrough"> | undefined;
3597
3421
  overrides?: {
3598
3422
  rules: ({
3599
3423
  kind: "capability";
3600
3424
  capability: string;
3601
3425
  } | {
3602
3426
  kind: "prop.value.avoid";
3603
- prop: string;
3427
+ severity: "error" | "warn" | "info";
3604
3428
  because: string;
3605
- severity: "error" | "info" | "warn";
3429
+ prop: string;
3606
3430
  value?: unknown;
3607
3431
  suggest?: string | undefined;
3608
3432
  } | {
3609
3433
  kind: "prop.value.forbid";
3610
- prop: string;
3434
+ severity: "error" | "warn" | "info";
3611
3435
  because: string;
3612
- severity: "error" | "info" | "warn";
3436
+ prop: string;
3613
3437
  value?: unknown;
3614
3438
  when?: {
3615
3439
  path?: string | undefined;
@@ -3619,59 +3443,97 @@ declare const governanceConfigSchema: z.ZodObject<{
3619
3443
  } | undefined;
3620
3444
  } | {
3621
3445
  kind: "a11y.requireName";
3446
+ severity: "error" | "warn" | "info";
3622
3447
  because: string;
3623
- severity: "error" | "info" | "warn";
3624
3448
  })[];
3625
3449
  match: {
3626
- path?: string | undefined;
3627
3450
  name?: string | undefined;
3451
+ path?: string | undefined;
3628
3452
  importPath?: string | undefined;
3629
- componentId?: string | undefined;
3453
+ exportName?: string | undefined;
3630
3454
  componentKey?: string | undefined;
3455
+ componentId?: string | undefined;
3631
3456
  publicRef?: string | undefined;
3632
3457
  sourcePath?: string | undefined;
3633
- exportName?: string | undefined;
3634
3458
  export?: string | undefined;
3635
3459
  scope?: "one" | "all" | undefined;
3636
3460
  };
3637
- status?: "active" | "draft" | "disabled" | undefined;
3461
+ status?: "disabled" | "active" | "draft" | undefined;
3638
3462
  }[] | undefined;
3463
+ ci?: z.objectOutputType<{
3464
+ failOnWarnings: z.ZodOptional<z.ZodBoolean>;
3465
+ failOnInert: z.ZodOptional<z.ZodBoolean>;
3466
+ failOnAdoptionRegression: z.ZodOptional<z.ZodBoolean>;
3467
+ }, z.ZodTypeAny, "passthrough"> | undefined;
3468
+ }, {
3469
+ components?: Record<string, {
3470
+ rules: ({
3471
+ kind: "capability";
3472
+ capability: string;
3473
+ } | {
3474
+ kind: "prop.value.avoid";
3475
+ severity: "error" | "warn" | "info";
3476
+ because: string;
3477
+ prop: string;
3478
+ value?: unknown;
3479
+ suggest?: string | undefined;
3480
+ } | {
3481
+ kind: "prop.value.forbid";
3482
+ severity: "error" | "warn" | "info";
3483
+ because: string;
3484
+ prop: string;
3485
+ value?: unknown;
3486
+ when?: {
3487
+ path?: string | undefined;
3488
+ } | undefined;
3489
+ fix?: {
3490
+ replaceWith?: unknown;
3491
+ } | undefined;
3492
+ } | {
3493
+ kind: "a11y.requireName";
3494
+ severity: "error" | "warn" | "info";
3495
+ because: string;
3496
+ })[];
3497
+ status?: "disabled" | "active" | "draft" | undefined;
3498
+ }> | undefined;
3499
+ rules?: Record<string, unknown> | undefined;
3500
+ severity?: "error" | "warn" | "info" | undefined;
3639
3501
  extends?: string[] | undefined;
3640
- agents?: Record<string, z.objectOutputType<{
3502
+ agents?: Record<string, z.objectInputType<{
3641
3503
  rules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3642
3504
  }, z.ZodTypeAny, "passthrough">> | undefined;
3643
- audit?: z.objectOutputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
3644
- runners?: Record<string, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">> | undefined;
3505
+ audit?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
3506
+ runners?: Record<string, z.objectInputType<{}, z.ZodTypeAny, "passthrough">> | undefined;
3645
3507
  canonicalSources?: ({
3646
3508
  kind: "npm";
3647
3509
  specifier: string;
3648
- exclude?: string[] | undefined;
3649
3510
  implementationPath?: string | undefined;
3650
3511
  include?: string[] | undefined;
3512
+ exclude?: string[] | undefined;
3651
3513
  } | {
3652
- path: string;
3653
3514
  kind: "directory";
3654
- exclude?: string[] | undefined;
3515
+ path: string;
3655
3516
  include?: string[] | undefined;
3517
+ exclude?: string[] | undefined;
3656
3518
  } | {
3657
3519
  kind: "registry";
3658
3520
  registryId: string;
3659
- receiptPath: string;
3660
3521
  installPath: string;
3661
- severity?: "error" | "info" | "warn" | undefined;
3662
3522
  importPath?: string | undefined;
3663
- exclude?: string[] | undefined;
3523
+ severity?: "error" | "warn" | "info" | undefined;
3664
3524
  include?: string[] | undefined;
3525
+ exclude?: string[] | undefined;
3665
3526
  registryHash?: string | undefined;
3527
+ receiptPath?: string | undefined;
3666
3528
  })[] | undefined;
3667
3529
  canonicalBridges?: {
3668
3530
  underlying: {
3669
- exportName: string;
3670
3531
  packageName: string;
3532
+ exportName: string;
3671
3533
  };
3672
3534
  local: {
3673
- componentKey: string;
3674
3535
  exportName: string;
3536
+ componentKey: string;
3675
3537
  moduleSpecifier: string;
3676
3538
  implementationFiles: string[];
3677
3539
  };
@@ -3681,47 +3543,6 @@ declare const governanceConfigSchema: z.ZodObject<{
3681
3543
  };
3682
3544
  }[] | undefined;
3683
3545
  presets?: string[] | undefined;
3684
- agent?: z.objectOutputType<{
3685
- repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3686
- }, z.ZodTypeAny, "passthrough"> | undefined;
3687
- ci?: z.objectOutputType<{
3688
- failOnWarnings: z.ZodOptional<z.ZodBoolean>;
3689
- failOnInert: z.ZodOptional<z.ZodBoolean>;
3690
- failOnAdoptionRegression: z.ZodOptional<z.ZodBoolean>;
3691
- }, z.ZodTypeAny, "passthrough"> | undefined;
3692
- }, {
3693
- components?: Record<string, {
3694
- rules: ({
3695
- kind: "capability";
3696
- capability: string;
3697
- } | {
3698
- kind: "prop.value.avoid";
3699
- prop: string;
3700
- because: string;
3701
- severity: "error" | "info" | "warn";
3702
- value?: unknown;
3703
- suggest?: string | undefined;
3704
- } | {
3705
- kind: "prop.value.forbid";
3706
- prop: string;
3707
- because: string;
3708
- severity: "error" | "info" | "warn";
3709
- value?: unknown;
3710
- when?: {
3711
- path?: string | undefined;
3712
- } | undefined;
3713
- fix?: {
3714
- replaceWith?: unknown;
3715
- } | undefined;
3716
- } | {
3717
- kind: "a11y.requireName";
3718
- because: string;
3719
- severity: "error" | "info" | "warn";
3720
- })[];
3721
- status?: "active" | "draft" | "disabled" | undefined;
3722
- }> | undefined;
3723
- severity?: "error" | "info" | "warn" | undefined;
3724
- rules?: Record<string, unknown> | undefined;
3725
3546
  scales?: Record<string, {
3726
3547
  values: number[];
3727
3548
  unit: "px" | "rem";
@@ -3732,7 +3553,7 @@ declare const governanceConfigSchema: z.ZodObject<{
3732
3553
  }> | undefined;
3733
3554
  styles?: ({
3734
3555
  kind: "style.rawColors.forbid";
3735
- severity: "error" | "info" | "warn";
3556
+ severity: "error" | "warn" | "info";
3736
3557
  except: string[];
3737
3558
  prefer: "token" | "css-variable";
3738
3559
  exclude?: (string | {
@@ -3741,7 +3562,7 @@ declare const governanceConfigSchema: z.ZodObject<{
3741
3562
  })[] | undefined;
3742
3563
  } | {
3743
3564
  kind: "style.rawDimensions.forbid";
3744
- severity: "error" | "info" | "warn";
3565
+ severity: "error" | "warn" | "info";
3745
3566
  prefer: "token" | "css-variable";
3746
3567
  appliesTo: string[];
3747
3568
  exclude?: (string | {
@@ -3750,7 +3571,7 @@ declare const governanceConfigSchema: z.ZodObject<{
3750
3571
  })[] | undefined;
3751
3572
  } | {
3752
3573
  kind: "style.rawSpacing.mustMatchScale";
3753
- severity: "error" | "info" | "warn";
3574
+ severity: "error" | "warn" | "info";
3754
3575
  scale: string;
3755
3576
  appliesTo: string[];
3756
3577
  exclude?: (string | {
@@ -3759,7 +3580,7 @@ declare const governanceConfigSchema: z.ZodObject<{
3759
3580
  })[] | undefined;
3760
3581
  } | {
3761
3582
  kind: "style.fontSize.mustMatchScale";
3762
- severity: "error" | "info" | "warn";
3583
+ severity: "error" | "warn" | "info";
3763
3584
  scale: string;
3764
3585
  exclude?: (string | {
3765
3586
  glob: string;
@@ -3767,7 +3588,7 @@ declare const governanceConfigSchema: z.ZodObject<{
3767
3588
  })[] | undefined;
3768
3589
  } | {
3769
3590
  kind: "style.cssVars.mustBeDefined";
3770
- severity: "error" | "info" | "warn";
3591
+ severity: "error" | "warn" | "info";
3771
3592
  exclude?: (string | {
3772
3593
  glob: string;
3773
3594
  reason?: string | undefined;
@@ -3775,14 +3596,14 @@ declare const governanceConfigSchema: z.ZodObject<{
3775
3596
  })[] | undefined;
3776
3597
  jsx?: ({
3777
3598
  kind: "jsx.unknownProps.forbid";
3778
- severity: "error" | "info" | "warn";
3599
+ severity: "error" | "warn" | "info";
3779
3600
  exclude?: (string | {
3780
3601
  glob: string;
3781
3602
  reason?: string | undefined;
3782
3603
  })[] | undefined;
3783
3604
  } | {
3784
3605
  kind: "jsx.inlineStyle.forbidRaw";
3785
- severity: "error" | "info" | "warn";
3606
+ severity: "error" | "warn" | "info";
3786
3607
  properties: string[];
3787
3608
  exclude?: (string | {
3788
3609
  glob: string;
@@ -3790,25 +3611,25 @@ declare const governanceConfigSchema: z.ZodObject<{
3790
3611
  })[] | undefined;
3791
3612
  } | {
3792
3613
  kind: "jsx.importPath.prefer";
3793
- severity: "error" | "info" | "warn";
3614
+ severity: "error" | "warn" | "info";
3794
3615
  from: string;
3795
3616
  to: string;
3796
- because?: string | undefined;
3797
3617
  exclude?: (string | {
3798
3618
  glob: string;
3799
3619
  reason?: string | undefined;
3800
3620
  })[] | undefined;
3801
3621
  imported?: string | undefined;
3622
+ because?: string | undefined;
3802
3623
  } | {
3803
3624
  kind: "jsx.component.prefer";
3804
- severity: "error" | "info" | "warn";
3625
+ severity: "error" | "warn" | "info";
3805
3626
  from: string;
3806
3627
  to: string;
3807
- because?: string | undefined;
3808
3628
  exclude?: (string | {
3809
3629
  glob: string;
3810
3630
  reason?: string | undefined;
3811
3631
  })[] | undefined;
3632
+ because?: string | undefined;
3812
3633
  })[] | undefined;
3813
3634
  tailwind?: z.objectInputType<{
3814
3635
  palette: z.ZodOptional<z.ZodObject<{
@@ -3822,22 +3643,25 @@ declare const governanceConfigSchema: z.ZodObject<{
3822
3643
  deny?: string[] | undefined;
3823
3644
  }>>;
3824
3645
  }, z.ZodTypeAny, "passthrough"> | undefined;
3646
+ agent?: z.objectInputType<{
3647
+ repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3648
+ }, z.ZodTypeAny, "passthrough"> | undefined;
3825
3649
  overrides?: {
3826
3650
  rules: ({
3827
3651
  kind: "capability";
3828
3652
  capability: string;
3829
3653
  } | {
3830
3654
  kind: "prop.value.avoid";
3831
- prop: string;
3655
+ severity: "error" | "warn" | "info";
3832
3656
  because: string;
3833
- severity: "error" | "info" | "warn";
3657
+ prop: string;
3834
3658
  value?: unknown;
3835
3659
  suggest?: string | undefined;
3836
3660
  } | {
3837
3661
  kind: "prop.value.forbid";
3838
- prop: string;
3662
+ severity: "error" | "warn" | "info";
3839
3663
  because: string;
3840
- severity: "error" | "info" | "warn";
3664
+ prop: string;
3841
3665
  value?: unknown;
3842
3666
  when?: {
3843
3667
  path?: string | undefined;
@@ -3847,71 +3671,23 @@ declare const governanceConfigSchema: z.ZodObject<{
3847
3671
  } | undefined;
3848
3672
  } | {
3849
3673
  kind: "a11y.requireName";
3674
+ severity: "error" | "warn" | "info";
3850
3675
  because: string;
3851
- severity: "error" | "info" | "warn";
3852
3676
  })[];
3853
3677
  match: {
3854
- path?: string | undefined;
3855
3678
  name?: string | undefined;
3679
+ path?: string | undefined;
3856
3680
  importPath?: string | undefined;
3857
- componentId?: string | undefined;
3681
+ exportName?: string | undefined;
3858
3682
  componentKey?: string | undefined;
3683
+ componentId?: string | undefined;
3859
3684
  publicRef?: string | undefined;
3860
3685
  sourcePath?: string | undefined;
3861
- exportName?: string | undefined;
3862
3686
  export?: string | undefined;
3863
3687
  scope?: "one" | "all" | undefined;
3864
3688
  };
3865
- status?: "active" | "draft" | "disabled" | undefined;
3866
- }[] | undefined;
3867
- extends?: string[] | undefined;
3868
- agents?: Record<string, z.objectInputType<{
3869
- rules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3870
- }, z.ZodTypeAny, "passthrough">> | undefined;
3871
- audit?: z.objectInputType<{}, z.ZodTypeAny, "passthrough"> | undefined;
3872
- runners?: Record<string, z.objectInputType<{}, z.ZodTypeAny, "passthrough">> | undefined;
3873
- canonicalSources?: ({
3874
- kind: "npm";
3875
- specifier: string;
3876
- exclude?: string[] | undefined;
3877
- implementationPath?: string | undefined;
3878
- include?: string[] | undefined;
3879
- } | {
3880
- path: string;
3881
- kind: "directory";
3882
- exclude?: string[] | undefined;
3883
- include?: string[] | undefined;
3884
- } | {
3885
- kind: "registry";
3886
- registryId: string;
3887
- installPath: string;
3888
- severity?: "error" | "info" | "warn" | undefined;
3889
- importPath?: string | undefined;
3890
- exclude?: string[] | undefined;
3891
- include?: string[] | undefined;
3892
- registryHash?: string | undefined;
3893
- receiptPath?: string | undefined;
3894
- })[] | undefined;
3895
- canonicalBridges?: {
3896
- underlying: {
3897
- exportName: string;
3898
- packageName: string;
3899
- };
3900
- local: {
3901
- componentKey: string;
3902
- exportName: string;
3903
- moduleSpecifier: string;
3904
- implementationFiles: string[];
3905
- };
3906
- decision: {
3907
- source: "authored" | "migration";
3908
- state: "confirmed";
3909
- };
3689
+ status?: "disabled" | "active" | "draft" | undefined;
3910
3690
  }[] | undefined;
3911
- presets?: string[] | undefined;
3912
- agent?: z.objectInputType<{
3913
- repairOrder: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3914
- }, z.ZodTypeAny, "passthrough"> | undefined;
3915
3691
  ci?: z.objectInputType<{
3916
3692
  failOnWarnings: z.ZodOptional<z.ZodBoolean>;
3917
3693
  failOnInert: z.ZodOptional<z.ZodBoolean>;
@@ -4148,4 +3924,293 @@ declare const g: {
4148
3924
  component: ComponentGovernanceBuilder<Record<string, unknown>>;
4149
3925
  };
4150
3926
 
4151
- 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 };
3927
+ /**
3928
+ * Frontend Contract preimage — the projection that defines what the contract IS.
3929
+ *
3930
+ * The FCID used to be a hash of the raw `code-contracts` artifact payload. That
3931
+ * conflated identity with display: a copy-edit to a component description moved
3932
+ * the hash, and tokens / canonical mappings / policy — the things gates actually
3933
+ * enforce — were not part of identity at all. This module widens the preimage to
3934
+ * the full enforcement surface as ONE shared projection, imported by both Cloud
3935
+ * (mint) and the CLI (reportedHash). Neither side may reimplement it: parity is
3936
+ * a property of the shared import, not a test you can fail.
3937
+ *
3938
+ * Enforced-only is implemented structurally: {@link projectContractPreimage}
3939
+ * copies an explicit pick-list of fields per domain. Anything an adapter passes
3940
+ * beyond that list (descriptions, docs URLs, timestamps, heuristic signals)
3941
+ * never reaches the hash. Proposed canonical mappings are excluded for the same
3942
+ * reason — they cannot block, so they are not identity; confirmation is the
3943
+ * moment a mapping enters the contract.
3944
+ *
3945
+ * The preimage itself is the record of four domain sub-hashes, so
3946
+ * `contractHash(preimage)` is the fcid and a domain diff is a four-string
3947
+ * compare — no deep structural diffing. Determinism (key sorting, undefined
3948
+ * dropping, number normalization) is inherited from `canonicalPreimage`; this
3949
+ * module adds element-level sorting for the arrays it owns and nothing else.
3950
+ *
3951
+ * Runtime-portable by construction: no Node APIs, no Convex imports, no React.
3952
+ */
3953
+
3954
+ /**
3955
+ * Positive pick-list of per-component `contract` fields that enter the FCID.
3956
+ * Display/guidance fields (`propsSummary`, `canonicalUsage`, `scenarioTags`,
3957
+ * story `states`/`variants`, descriptions) are intentionally absent — adapters
3958
+ * may still pass them, but {@link projectEnforcementContract} never copies them.
3959
+ */
3960
+ declare const CONTRACT_ENFORCEMENT_FIELDS: readonly ["a11yRules", "bans", "performanceBudget", "compoundChildren", "composition"];
3961
+ type ContractEnforcementField = (typeof CONTRACT_ENFORCEMENT_FIELDS)[number];
3962
+ /** Display-only contract keys that must never enter the FCID positive pick-list. */
3963
+ declare const CONTRACT_DISPLAY_ONLY_FIELDS: readonly ["propsSummary", "canonicalUsage", "scenarioTags", "states", "variants"];
3964
+ /**
3965
+ * The fixed domain enum. Adding a domain is a spine change (update
3966
+ * `01-architecture.md` first); never rename — deprecate and alias.
3967
+ */
3968
+ declare const CONTRACT_DOMAINS: readonly ["components", "tokens", "canonicalMap", "policy"];
3969
+ type ContractDomain = (typeof CONTRACT_DOMAINS)[number];
3970
+ /**
3971
+ * One component's enforcement identity. Props are the *name* membership surface
3972
+ * (what unknown-prop checks today); prop types/defaults are not enforced by the
3973
+ * rules engine, so they are not identity — enforced-only cuts both ways.
3974
+ */
3975
+ interface ContractComponentInput {
3976
+ name: string;
3977
+ /** Parent component name when this is a subcomponent (compound identity). */
3978
+ parentName?: string;
3979
+ /** Prop names the component accepts. */
3980
+ props?: readonly string[];
3981
+ /**
3982
+ * The per-component contract as authored. Only {@link CONTRACT_ENFORCEMENT_FIELDS}
3983
+ * are projected into the FCID — display/guidance keys are stripped structurally.
3984
+ */
3985
+ contract?: unknown;
3986
+ /**
3987
+ * Resolved component governance records (`govern:` / `governance`). Editing
3988
+ * these changes what CI allows, so they are FCID identity.
3989
+ */
3990
+ governance?: readonly ComponentGovernanceRecord[];
3991
+ /** Required compound-children names, when the structure is declared. */
3992
+ compoundChildren?: readonly string[];
3993
+ }
3994
+ interface ContractTokenInput {
3995
+ name: string;
3996
+ value: string | number;
3997
+ type?: string;
3998
+ }
3999
+ type CanonicalMappingStatus = "confirmed" | "proposed" | "unknown";
4000
+ interface ContractPropMappingInput {
4001
+ rawProp: string;
4002
+ canonicalProp: string;
4003
+ valueMap?: Readonly<Record<string, string>>;
4004
+ }
4005
+ interface ContractCanonicalMappingInput {
4006
+ /** Source-qualified identity, required by the V2 projection; ignored by immutable V1. */
4007
+ source?: ContractComponentSource;
4008
+ /** The raw/source component the mapping covers. */
4009
+ component: string;
4010
+ /** The canonical component it maps to. */
4011
+ canonical: string;
4012
+ status: CanonicalMappingStatus;
4013
+ /** Local/offline canonical import target, when the mapping is config-authored. */
4014
+ importPath?: string;
4015
+ /** Confirmed package-to-local relation metadata. Absent for legacy mappings. */
4016
+ bridge?: {
4017
+ underlyingPackageName: string;
4018
+ underlyingExportName: string;
4019
+ localComponentKey: string;
4020
+ localExportName: string;
4021
+ implementationFiles: readonly string[];
4022
+ decisionSource: "authored" | "migration";
4023
+ };
4024
+ /** Explicit raw element or semantic resolutions covered by a local declaration. */
4025
+ resolves?: readonly {
4026
+ tag: string;
4027
+ role?: string;
4028
+ inputType?: string;
4029
+ }[];
4030
+ propMapping?: readonly ContractPropMappingInput[];
4031
+ }
4032
+ /**
4033
+ * An authored waiver record. Hashed as data — including `expiresOn` as a plain
4034
+ * date string. Expiry *evaluation* happens at enforcement time and must never
4035
+ * change the fcid (no time-dependent hashing).
4036
+ */
4037
+ interface ContractWaiverInput {
4038
+ id: string;
4039
+ /** The diagnostic code or rule the waiver suppresses. */
4040
+ target: string;
4041
+ reason: string;
4042
+ /** YYYY-MM-DD, treated as opaque data. */
4043
+ expiresOn?: string;
4044
+ }
4045
+ /**
4046
+ * Active policy: everything that changes what a gate would allow or deny.
4047
+ * Waivers live here (spine open question 1, resolved): a waiver changes what
4048
+ * blocks, so it is enforcement-relevant.
4049
+ */
4050
+ interface ContractPolicyInput {
4051
+ rules?: Readonly<Record<string, unknown>>;
4052
+ codes?: Readonly<Record<string, unknown>>;
4053
+ compositionPatterns?: readonly unknown[];
4054
+ waivers?: readonly ContractWaiverInput[];
4055
+ }
4056
+ /**
4057
+ * The neutral catalog shape both adapters (Cloud mint, CLI scan) assemble.
4058
+ * Adapters gather data; the projection owns all normalization — element order,
4059
+ * optional fields, and display-data stripping never reach the hash.
4060
+ */
4061
+ interface ContractCatalogInput {
4062
+ components?: readonly ContractComponentInput[];
4063
+ tokens?: readonly ContractTokenInput[];
4064
+ canonicalMappings?: readonly ContractCanonicalMappingInput[];
4065
+ policy?: ContractPolicyInput | null;
4066
+ }
4067
+ /** Deterministic runtime refusal for malformed or ambiguous FCID inputs. */
4068
+ declare class ContractCatalogValidationError extends TypeError {
4069
+ readonly issues: readonly string[];
4070
+ constructor(issues: readonly string[]);
4071
+ }
4072
+ declare const CONTRACT_PREIMAGE_SCHEMA: "fcid-preimage:v1";
4073
+ declare const CONTRACT_PREIMAGE_SCHEMA_V2: "fcid-preimage:v2";
4074
+ declare const SUPPORTED_CONTRACT_PREIMAGE_SCHEMAS: readonly ["fcid-preimage:v2", "fcid-preimage:v1"];
4075
+ type ContractPreimageSchema = (typeof SUPPORTED_CONTRACT_PREIMAGE_SCHEMAS)[number];
4076
+ declare const CONTRACT_PREIMAGE_CAPABILITIES: string;
4077
+ declare function isSupportedContractPreimageSchema(value: unknown): value is ContractPreimageSchema;
4078
+ /** Request header used by clients that can verify and consume this preimage. */
4079
+ declare const CONTRACT_PREIMAGE_CAPABILITY_HEADER: "X-Fragments-Contract-Preimage";
4080
+ /**
4081
+ * The hashed identity record: four domain sub-hashes plus the projection schema
4082
+ * version (so an intentional projection change mints a new fcid). The fcid is
4083
+ * `contractHash(preimage)` — hash of the domain hashes, per the spine pipeline.
4084
+ */
4085
+ interface ContractPreimage {
4086
+ schema: ContractPreimageSchema;
4087
+ domains: Record<ContractDomain, string>;
4088
+ }
4089
+ /**
4090
+ * Wire-compatible identity pin carried by Cloud policy responses. Older
4091
+ * contract rows may omit the schema/domains, so every field except the FCID is
4092
+ * intentionally nullable at this boundary.
4093
+ */
4094
+ interface ContractIdentityPin {
4095
+ contractHash: string;
4096
+ preimageSchema?: string | null;
4097
+ domainHashes?: Readonly<Record<string, string>> | null;
4098
+ }
4099
+ /**
4100
+ * Reconstruct and verify the canonical preimage behind a published FCID.
4101
+ *
4102
+ * This is the only supported bridge from the additive ledger/wire shape
4103
+ * (`preimageSchema` + `domainHashes`) back to the hash input. Consumers must
4104
+ * not trust `enforcedIdentityComparable` on its own: a malformed, partial, or
4105
+ * internally inconsistent pin returns `null` and therefore fails closed.
4106
+ */
4107
+ declare function verifiedContractPreimageFromPin(pin: ContractIdentityPin): ContractPreimage | null;
4108
+ /**
4109
+ * Project only enforcement fields from a per-component `contract` blob.
4110
+ * Unknown / display keys are dropped; an all-display contract becomes `undefined`.
4111
+ */
4112
+ declare function projectEnforcementContract(contract: unknown): unknown;
4113
+ /**
4114
+ * Project a catalog onto the contract preimage: four enforced-only domain
4115
+ * bodies, each hashed independently. `contractHash(projectContractPreimage(x))`
4116
+ * is the fcid.
4117
+ */
4118
+ declare function projectContractPreimage(catalog: ContractCatalogInput): ContractPreimage;
4119
+ /**
4120
+ * Name the domains whose identity differs between two preimages — a four-string
4121
+ * compare, no structural diffing. Returned in fixed {@link CONTRACT_DOMAINS}
4122
+ * order. Staleness checks compare these, never whole fcids.
4123
+ */
4124
+ declare function diffContractDomains(a: ContractPreimage, b: ContractPreimage): ContractDomain[];
4125
+ /**
4126
+ * Map defineFragment-shaped records — the `code-contracts` payload's
4127
+ * `fragments` array (Cloud mint) or the CLI's loaded fragment definitions —
4128
+ * onto their enforcement identity. The one shared mapping is what keeps the
4129
+ * two adapters from drifting into a second "catalog → preimage"
4130
+ * implementation: both sides gather fragments however they like, then this
4131
+ * picks the identity fields. Records without a string `meta.name` are skipped
4132
+ * (no identity to hash).
4133
+ */
4134
+ /**
4135
+ * The enforced-only slice of a resolved CLI governance config — the fields
4136
+ * that change what a scan allows or denies. CI gate options, agent repair
4137
+ * order, and runner config change how/when gates run, not what they enforce,
4138
+ * so they are not identity. This pick-list lives here, beside the projection,
4139
+ * so adapters cannot drift into private enforced-only boundaries: a new
4140
+ * enforcement field on {@link GovernanceConfig} is added to the contract in
4141
+ * exactly one place.
4142
+ */
4143
+ declare function contractPolicyFromGovernanceConfig(config: GovernanceConfig | null | undefined): ContractPolicyInput | null;
4144
+ declare function contractComponentsFromFragments(fragments: readonly unknown[]): ContractComponentInput[];
4145
+ /**
4146
+ * Derive a preview `artifactId` from modules, states, guidance/render content,
4147
+ * and runtime config. Never an FCID — callers must not assign
4148
+ * `derivedFromContractHash` into `artifactId` (or the reverse).
4149
+ */
4150
+ declare function deriveArtifactId(content: {
4151
+ modules?: unknown;
4152
+ states?: unknown;
4153
+ guidance?: unknown;
4154
+ render?: unknown;
4155
+ runtime?: unknown;
4156
+ }): string;
4157
+
4158
+ declare const APPROVED_COMPONENT_GOVERNANCE_LEGACY_MAX_BYTES: number;
4159
+ declare const APPROVED_COMPONENT_GOVERNANCE_QUALIFIED_MAX_BYTES: number;
4160
+ /** Expanded portable capacity requires the enclosing FCID and component generation to agree. */
4161
+ declare function approvedComponentGovernanceByteLimit(expectedPreimageSchema: unknown, sourceIdentitySchema: unknown): number | null;
4162
+ /** A portable address; authorization remains pinned to the enclosing contract. */
4163
+ type ContractComponentSource = {
4164
+ kind: "repository";
4165
+ path: string;
4166
+ symbol: string;
4167
+ } | {
4168
+ kind: "package";
4169
+ importPath: string;
4170
+ exportName: string;
4171
+ };
4172
+ type ContractComponentExport = {
4173
+ kind: "repository";
4174
+ path: string;
4175
+ exportName: string;
4176
+ } | {
4177
+ kind: "package";
4178
+ importPath: string;
4179
+ exportName: string;
4180
+ };
4181
+ interface ContractComponentInputV2 extends ContractComponentInput {
4182
+ source: ContractComponentSource;
4183
+ exports?: readonly ContractComponentExport[];
4184
+ }
4185
+ interface ContractCanonicalMappingInputV2 extends ContractCanonicalMappingInput {
4186
+ source: ContractComponentSource;
4187
+ }
4188
+ interface ContractCatalogInputV2 extends Omit<ContractCatalogInput, "components" | "canonicalMappings"> {
4189
+ components?: readonly ContractComponentInputV2[];
4190
+ canonicalMappings?: readonly ContractCanonicalMappingInputV2[];
4191
+ }
4192
+ declare function normalizeContractSourcePath(value: string): string;
4193
+ declare function normalizeContractComponentSource(value: ContractComponentSource): ContractComponentSource;
4194
+ declare function contractComponentSourceKey(source: ContractComponentSource): string;
4195
+ interface ComponentGuidance {
4196
+ name: string;
4197
+ source?: ContractComponentSource;
4198
+ exportAddresses?: readonly ContractComponentExport[];
4199
+ }
4200
+ /** Public addresses proven by the exact component source, never package display metadata. */
4201
+ declare function contractComponentExportAddresses(component: ComponentGuidance): Array<{
4202
+ importPath: string;
4203
+ exportName: string;
4204
+ }>;
4205
+ /** Existing replacement syntax supports a unique named JSX component binding. */
4206
+ declare function contractComponentReplacementImport(component: ComponentGuidance): {
4207
+ importPath: string;
4208
+ exportName: string;
4209
+ } | undefined;
4210
+ /** V1 remains immutable. V2 scopes the same enforcement projection by source. */
4211
+ declare function projectContractPreimageV2(catalog: ContractCatalogInputV2): ContractPreimage;
4212
+ /** Normalize one persisted fragment without using its display name as its address. */
4213
+ declare function contractSourceFromFragment(fragment: unknown, packageName?: string): ContractComponentSource;
4214
+ declare function contractComponentsFromFragmentsV2(fragments: readonly unknown[], packageName?: string): ContractComponentInputV2[];
4215
+
4216
+ export { type CanonicalMappingStatus as $, type RelationshipType as A, type BlockDefinition as B, type ComponentGovernanceRecord as C, type CanonicalSource as D, type CanonicalBridgeV1 as E, type FragmentDefinition as F, type GovernanceSeverity as G, type ContractCanonicalMappingInput as H, type ContractPreimage as I, type AIMetadata as J, APPROVED_COMPONENT_GOVERNANCE_LEGACY_MAX_BYTES as K, APPROVED_COMPONENT_GOVERNANCE_QUALIFIED_MAX_BYTES as L, type AccessibilityGovernanceBuilder as M, type AppConfig as N, type BaselineInfo as O, type PropAnnotation as P, type BoundingBox as Q, type ResolvedGovernedFragmentDefinition as R, CONTRACT_DISPLAY_ONLY_FIELDS as S, type TokenConfig as T, CONTRACT_DOMAINS as U, type VariantRenderOptions as V, CONTRACT_ENFORCEMENT_FIELDS as W, CONTRACT_PREIMAGE_CAPABILITIES as X, CONTRACT_PREIMAGE_CAPABILITY_HEADER as Y, CONTRACT_PREIMAGE_SCHEMA as Z, CONTRACT_PREIMAGE_SCHEMA_V2 as _, type FragmentDefinitionV2 as a, type VerifyResult as a$, type ComponentGovernanceBuilder as a0, type ComponentRef as a1, type ComponentRelation as a2, type CompositionMetadata as a3, type ContractCanonicalMappingInputV2 as a4, type ContractCatalogInputV2 as a5, ContractCatalogValidationError as a6, type ContractComponentInput as a7, type ContractComponentInputV2 as a8, type ContractEnforcementField as a9, type LocalCanonicalDeclaration as aA, type LocalCanonicalResolveRule as aB, type Manifest as aC, type PlayFunction as aD, type PlayFunctionContext as aE, type PropDefinition as aF, type PropGovernanceBuilder as aG, type PropGovernanceOptions as aH, type PropKey as aI, type PropType as aJ, type RegistryComponentEntry as aK, type RegistryOptions as aL, type RegistryPropEntry as aM, type RepoRelativePath as aN, SUPPORTED_CONTRACT_PREIMAGE_SCHEMAS as aO, type ScaleGovernanceRecord as aP, type Screenshot as aQ, type ScreenshotConfig as aR, type ScreenshotMetadata as aS, type ServiceConfig as aT, type SnapshotConfig as aU, type SnippetPolicyConfig as aV, type Theme as aW, type ThemeSeeds as aX, type TokenSourceConfig as aY, type TokenSourceFormat as aZ, type VerifyRequest as a_, type ContractIdentityPin as aa, type ContractPolicyInput as ab, type ContractPreimageSchema as ac, type ContractPropMappingInput as ad, type ContractTokenInput as ae, type ContractWaiverInput as af, type ControlType as ag, type DesignSystemConfig as ah, type DiffResult as ai, type FigmaPropMapping as aj, type FragmentContextOptions as ak, type FragmentContract as al, type FragmentExample as am, type FragmentGenerated as an, type FragmentGuidance as ao, type FragmentIndex as ap, type FragmentMeta as aq, type FragmentProvenance as ar, type FragmentRegistry as as, type FragmentUsage as at, type FragmentVariant as au, type GlobalGovernanceRecord as av, type GlobalJsxGovernanceRecord as aw, type GlobalStyleGovernanceRecord as ax, type GovernancePropValue as ay, type InspectConfig as az, type VariantLoader as b, type Viewport as b0, approvedComponentGovernanceByteLimit as b1, canonicalBridgeV1Schema as b2, componentGovernanceRecordSchema as b3, componentGovernanceRecordsSchema as b4, contractComponentExportAddresses as b5, contractComponentReplacementImport as b6, contractComponentSourceKey as b7, contractComponentsFromFragments as b8, contractComponentsFromFragmentsV2 as b9, contractPolicyFromGovernanceConfig as ba, contractSourceFromFragment as bb, deriveArtifactId as bc, diffContractDomains as bd, g as be, globalGovernanceRecordSchema as bf, globalJsxGovernanceRecordSchema as bg, globalStyleGovernanceRecordSchema as bh, governanceConfigSchema as bi, governanceConfigWithLocalCanonical as bj, governanceSeveritySchema as bk, isPresetSourcedRule as bl, isSupportedContractPreimageSchema as bm, localCanonicalContractMappings as bn, markPresetSourcedRules as bo, normalizeContractComponentSource as bp, normalizeContractSourcePath as bq, normalizeGovernanceConfig as br, parseComponentGovernancePolicyJson as bs, projectContractPreimage as bt, projectContractPreimageV2 as bu, projectEnforcementContract as bv, resolveComponentGovernance as bw, resolveGovernanceRecordsForIdentity as bx, scaleGovernanceRecordSchema as by, verifiedContractPreimageFromPin as bz, type ContractDomain as c, type ContractCatalogInput as d, type ContractComponentSource as e, type ContractComponentExport as f, type GovernedFragmentDefinition as g, type GovernanceConfig as h, type FragmentsConfig as i, type FragmentAnnotationsV3 as j, type FragmentDefinitionV3Body as k, type FragmentDefinitionV3 as l, type FragmentDesignV3 as m, type FragmentDontExampleV3 as n, type FragmentGuidanceV3 as o, type FragmentMatrixV3 as p, type FragmentMetaV3 as q, type FragmentPreviewV3 as r, type FragmentStateV3 as s, type FragmentComponent as t, type FigmaStringMapping as u, type FigmaBooleanMapping as v, type FigmaEnumMapping as w, type FigmaInstanceMapping as x, type FigmaChildrenMapping as y, type FigmaTextContentMapping as z };