@usefragments/core 1.0.0 → 1.3.0

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

@@ -8,6 +8,13 @@ import {
 
 // src/schemas/index.ts
 import { z } from "zod";
+var evidenceGradeSchema = z.enum([
+  "none",
+  "runtime_advisory",
+  "provenance_bound",
+  "source_backed",
+  "receipt_backed"
+]);
 var factLocationSchema = z.object({
   file: z.string(),
   line: z.number().int().nonnegative(),
@@ -76,6 +83,7 @@ var findingSchema = z.object({
   fingerprint: z.string(),
   location: factLocationSchema,
   evidence: z.array(factEvidenceSchema).min(1),
+  evidenceGrade: evidenceGradeSchema.optional(),
   fix: findingFixSchema.optional(),
   attributes: z.record(z.unknown()).optional(),
   /**
@@ -163,14 +171,46 @@ var agentFindingSchema = z.object({
   severity: severitySchema,
   level: severityLevelSchema,
   message: z.string(),
+  evidenceGrade: evidenceGradeSchema.optional(),
   evidence: z.array(factEvidenceSchema),
   plan: agentPlanSchema
 });
-var agentFormatSchema = z.object({
-  schemaVersion: z.literal("typestyle.agent.v1"),
-  passed: z.boolean(),
-  score: z.number(),
+var AGENT_FORMAT_SCHEMA_VERSION = "typestyle.agent.v2";
+var agentIntegritySchema = z.object({
+  rulesLoaded: z.number().int().nonnegative(),
+  status: z.enum(["healthy", "degraded", "inert"]),
+  healthy: z.boolean(),
+  inert: z.boolean(),
+  reasons: z.array(z.string())
+});
+var agentRunProvenanceSchema = z.object({
+  runId: z.string().regex(/^run_[a-f0-9]{12}$/),
+  fcid: z.string().min(1),
+  baselineId: z.string().min(1).optional(),
+  scope: z.object({
+    method: z.enum([
+      "three-dot",
+      "tree-diff",
+      "status",
+      "fallback-full",
+      "explicit",
+      "full"
+    ]),
+    gitOk: z.boolean()
+  }),
+  engineVersion: z.string().min(1),
+  scopeHash: z.string().regex(/^[a-f0-9]{64}$/),
+  inputFilesHash: z.string().regex(/^[a-f0-9]{64}$/)
+});
+var agentRunVerdictSchema = z.object({
+  exitCode: z.union([z.literal(0), z.literal(1)]),
+  reasons: z.array(z.string()),
+  gatingFindingCount: z.number().int().nonnegative()
+});
+var agentFormatBaseSchema = z.object({
+  schemaVersion: z.literal(AGENT_FORMAT_SCHEMA_VERSION),
   summary: z.string(),
+  integrity: agentIntegritySchema,
   fix_first: z.array(agentFindingSchema),
   remaining: z.array(agentFindingSchema),
   suppression_template: z.object({
@@ -184,14 +224,65 @@ var agentFormatSchema = z.object({
     scoreDelta: z.number()
   }),
   findings: z.array(findingSchema).optional(),
-  suppressions: z.array(suppressionDirectiveSchema).optional()
+  suppressions: z.array(suppressionDirectiveSchema).optional(),
+  provenance: agentRunProvenanceSchema.optional(),
+  verdict: agentRunVerdictSchema.optional()
+});
+var agentFormatSchema = z.union([
+  agentFormatBaseSchema.extend({
+    passed: z.boolean(),
+    score: z.number(),
+    status: z.never().optional(),
+    reasons: z.never().optional(),
+    integrity: agentIntegritySchema.extend({
+      rulesLoaded: z.number().int().positive()
+    })
+  }),
+  agentFormatBaseSchema.extend({
+    passed: z.literal(false),
+    score: z.never().optional(),
+    status: z.literal("indeterminate"),
+    reasons: z.tuple([z.literal("zero_rules_loaded")]),
+    integrity: agentIntegritySchema.extend({
+      rulesLoaded: z.literal(0)
+    })
+  }),
+  // A finalized Run can explicitly allow inert governance. Preserve the
+  // indeterminate integrity truth while making `passed` match that Run's sole
+  // verdict; requiring Run pins prevents generic zero-rule envelopes from
+  // accidentally becoming green.
+  agentFormatBaseSchema.extend({
+    passed: z.literal(true),
+    score: z.never().optional(),
+    status: z.literal("indeterminate"),
+    reasons: z.tuple([z.literal("zero_rules_loaded")]),
+    integrity: agentIntegritySchema.extend({
+      rulesLoaded: z.literal(0)
+    }),
+    provenance: agentRunProvenanceSchema,
+    verdict: agentRunVerdictSchema.extend({ exitCode: z.literal(0) })
+  })
+]);
+var agentErrorEnvelopeSchema = z.object({
+  schemaVersion: z.literal(AGENT_FORMAT_SCHEMA_VERSION),
+  passed: z.literal(false),
+  error: z.object({
+    code: z.string().min(1),
+    message: z.string().min(1)
+  }),
+  provenance: agentRunProvenanceSchema.optional(),
+  verdict: agentRunVerdictSchema.optional(),
+  cloudReport: z.enum(["reported", "failed", "skipped"]).optional(),
+  notices: z.array(z.string()).optional()
 });
+var agentOutputSchema = z.union([agentFormatSchema, agentErrorEnvelopeSchema]);
 function normalizeSeverity(severity) {
   return severitySchema.safeParse(severity).success ? severity : severityFromLevel(legacySeverityLevelSchema.parse(severity));
 }
 function normalizeFinding(input) {
   return {
     ...input,
+    evidenceGrade: input.evidenceGrade ?? "source_backed",
     level: input.level ?? severityLevel(input.severity)
   };
 }
@@ -220,9 +311,13 @@ export {
   suppressionDirectiveSchema,
   agentPlanSchema,
   agentFindingSchema,
+  AGENT_FORMAT_SCHEMA_VERSION,
+  agentIntegritySchema,
   agentFormatSchema,
+  agentErrorEnvelopeSchema,
+  agentOutputSchema,
   normalizeSeverity,
   normalizeFinding,
   normalizeViolation
 };
-//# sourceMappingURL=chunk-R3X7UBHU.js.map
+//# sourceMappingURL=chunk-57QDBEHQ.js.map

package/dist/chunk-57QDBEHQ.js.map

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

package/dist/{chunk-243QYRUF.js → chunk-MLRDNSSA.js}

@@ -1,7 +1,7 @@
 import {
   normalizeFinding,
   normalizeViolation
-} from "./chunk-R3X7UBHU.js";
+} from "./chunk-57QDBEHQ.js";
 import {
   authorOwnedImport,
   canonicalizeOwnedComponentId,
@@ -14,6 +14,32 @@ import {
   portableRepoPathError
 } from "./chunk-EIYNNS77.js";
 
+// src/rules/fix-availability.ts
+var RULE_FIX_AVAILABLE = {
+  "components/unknown-prop": false,
+  "components/forbidden-prop-value": true,
+  "props/invalid-value": true,
+  "imports/preferred-path": true,
+  "components/preferred-component": true,
+  "components/prefer-library": true,
+  "styles/no-raw-color": true,
+  "styles/no-raw-dimensions": true,
+  "styles/no-raw-spacing": true,
+  "styles/no-raw-typography": true,
+  "tailwind/arbitrary-color": false,
+  "tailwind/arbitrary-spacing": true,
+  "tailwind/forbidden-palette": true,
+  "tailwind/off-scale-spacing-token": true,
+  "tailwind/raw-color-via-token": false,
+  "tailwind/unknown-class": false,
+  "tokens/require-dual-fallback": true,
+  "tokens/css-vars-must-be-defined": false,
+  "theme/no-theme-coupled-literal": false,
+  "a11y/required-accessible-name": false,
+  "composition/cardinality": false,
+  "composition/co-occurrence": false
+};
+
 // src/codes/codes.ts
 var EXPLAIN_URL_BASE = "https://usefragments.com/errors/";
 function code(entry) {
@@ -22,6 +48,14 @@ function code(entry) {
     explainUrl: `${EXPLAIN_URL_BASE}${entry.code}`
   };
 }
+function ruleCode(entry) {
+  const { evidenceRequired, ...metadata } = entry;
+  return code({
+    ...metadata,
+    fixAvailable: RULE_FIX_AVAILABLE[entry.ruleId],
+    evidenceRequired
+  });
+}
 var CODES = [
   code({
     code: "FUI1001",
@@ -33,34 +67,31 @@ var CODES = [
     fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI1002",
     ruleId: "components/preferred-component",
     category: "canonical-usage",
     defaultSeverity: "serious",
     title: "Preferred component should be used",
     lifecycle: "experimental",
-    fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI1003",
     ruleId: "imports/preferred-path",
     category: "canonical-usage",
     defaultSeverity: "moderate",
     title: "Import should use the preferred path",
     lifecycle: "experimental",
-    fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI1004",
     ruleId: "components/prefer-library",
     category: "canonical-usage",
     defaultSeverity: "moderate",
     title: "Library component should be preferred",
     lifecycle: "experimental",
-    fixAvailable: true,
     evidenceRequired: true
   }),
   code({
@@ -103,104 +134,94 @@ var CODES = [
     fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI2003",
     ruleId: "tokens/require-dual-fallback",
     category: "tokens",
     defaultSeverity: "serious",
     title: "Token fallback is required",
     lifecycle: "experimental",
-    fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI2004",
     ruleId: "styles/no-raw-dimensions",
     category: "tokens",
     defaultSeverity: "serious",
     title: "Raw dimension should use a token",
     lifecycle: "experimental",
-    fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI2005",
     ruleId: "styles/no-raw-color",
     category: "tokens",
     defaultSeverity: "serious",
     title: "Raw color should use a token",
     lifecycle: "experimental",
-    fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI2006",
     ruleId: "styles/no-raw-spacing",
     category: "tokens",
     defaultSeverity: "serious",
     title: "Raw spacing should use the scale",
     lifecycle: "experimental",
-    fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI2007",
     ruleId: "tailwind/arbitrary-color",
     category: "tokens",
     defaultSeverity: "moderate",
     title: "Tailwind arbitrary color should use a token",
     lifecycle: "experimental",
-    fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI2008",
     ruleId: "tailwind/arbitrary-spacing",
     category: "tokens",
     defaultSeverity: "moderate",
     title: "Tailwind arbitrary spacing should use the scale",
     lifecycle: "experimental",
-    fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI2009",
     ruleId: "tailwind/forbidden-palette",
     category: "tokens",
     defaultSeverity: "moderate",
     title: "Tailwind palette is forbidden",
     lifecycle: "experimental",
-    fixAvailable: false,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI2010",
     ruleId: "tailwind/raw-color-via-token",
     category: "tokens",
     defaultSeverity: "moderate",
     title: "Tailwind color should use a resolved token",
     lifecycle: "experimental",
-    fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI2011",
     ruleId: "tailwind/off-scale-spacing-token",
     category: "tokens",
     defaultSeverity: "moderate",
     title: "Tailwind spacing token is off scale",
     lifecycle: "experimental",
-    fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI2012",
     ruleId: "tailwind/unknown-class",
     category: "tokens",
     defaultSeverity: "moderate",
     title: "Tailwind class is unknown",
     lifecycle: "experimental",
-    fixAvailable: false,
     evidenceRequired: true
   }),
   code({
@@ -213,34 +234,40 @@ var CODES = [
     fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI2014",
     ruleId: "theme/no-theme-coupled-literal",
     category: "tokens",
     defaultSeverity: "moderate",
     title: "Theme-coupled literal should use a semantic token",
     lifecycle: "experimental",
-    fixAvailable: false,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI2015",
     ruleId: "tokens/css-vars-must-be-defined",
     category: "tokens",
     defaultSeverity: "moderate",
     title: "CSS variable is not in the contract vocabulary",
     lifecycle: "experimental",
-    fixAvailable: false,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
+    code: "FUI2016",
+    ruleId: "styles/no-raw-typography",
+    category: "tokens",
+    defaultSeverity: "serious",
+    title: "Raw typography should use a token",
+    lifecycle: "experimental",
+    evidenceRequired: true
+  }),
+  ruleCode({
     code: "FUI3001",
     ruleId: "a11y/required-accessible-name",
     category: "a11y",
     defaultSeverity: "serious",
     title: "Accessible name is required",
     lifecycle: "experimental",
-    fixAvailable: false,
     evidenceRequired: true
   }),
   code({
@@ -274,24 +301,22 @@ var CODES = [
     fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI5003",
     ruleId: "composition/cardinality",
     category: "composition",
     defaultSeverity: "moderate",
     title: "Too many of a component in one region",
     lifecycle: "experimental",
-    fixAvailable: false,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI5004",
     ruleId: "composition/co-occurrence",
     category: "composition",
     defaultSeverity: "moderate",
     title: "Required companion component is missing from the region",
     lifecycle: "experimental",
-    fixAvailable: false,
     evidenceRequired: true
   }),
   code({
@@ -304,14 +329,13 @@ var CODES = [
     fixAvailable: false,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI6002",
     ruleId: "props/invalid-value",
     category: "props",
     defaultSeverity: "serious",
     title: "Prop value is invalid",
     lifecycle: "experimental",
-    fixAvailable: true,
     evidenceRequired: true
   }),
   code({
@@ -324,24 +348,22 @@ var CODES = [
     fixAvailable: false,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI6004",
     ruleId: "components/forbidden-prop-value",
     category: "props",
     defaultSeverity: "serious",
     title: "Prop value is forbidden",
     lifecycle: "experimental",
-    fixAvailable: true,
     evidenceRequired: true
   }),
-  code({
+  ruleCode({
     code: "FUI6005",
     ruleId: "components/unknown-prop",
     category: "props",
     defaultSeverity: "moderate",
     title: "Component prop is unknown",
     lifecycle: "experimental",
-    fixAvailable: false,
     evidenceRequired: true
   }),
   code({
@@ -774,8 +796,10 @@ function makeTokenDefinitionFact(input) {
     kind: "token_definition",
     name: input.name,
     value: input.value,
+    ...input.location ? { location: input.location } : {},
     category: input.category,
-    referenceFormat: input.referenceFormat
+    referenceFormat: input.referenceFormat,
+    ...input.sourceNames?.length ? { sourceNames: [...input.sourceNames] } : {}
   };
 }
 function makeTailwindPaletteAllowFact(input) {
@@ -1044,6 +1068,10 @@ function logicalComponentId(componentId2) {
   return canonicalizeOwnedComponentId(componentId2);
 }
 function logicalFactForComparison(fact) {
+  if (fact.kind === "token_definition") {
+    const { location: _location, sourceNames: _sourceNames, ...logicalFact } = fact;
+    return logicalFact;
+  }
   if (fact.kind === "jsx_import_path_preferred") {
     return {
       ...fact,
@@ -1084,12 +1112,16 @@ var FactIndex = class {
   facts = /* @__PURE__ */ new Map();
   idsByKind = /* @__PURE__ */ new Map();
   idsByComponent = /* @__PURE__ */ new Map();
+  tokenBySymbol = /* @__PURE__ */ new Map();
   add(fact) {
+    if (fact.kind === "token_definition") {
+      this.indexTokenSymbols(fact);
+    }
     const existing = this.facts.get(fact.id);
     if (existing) {
       if (canonicalJson(logicalFactForComparison(existing)) !== canonicalJson(logicalFactForComparison(fact))) {
         console.warn(
-          `FactIndex: conflicting facts for id ${fact.id} \u2014 keeping first fact, skipping ${describeFactForConflict(fact)}`
+          `FactIndex: conflicting facts for id ${fact.id} \u2014 keeping ${describeFactForConflict(existing)}, skipping ${describeFactForConflict(fact)}`
         );
       }
       return;
@@ -1251,11 +1283,20 @@ var FactIndex = class {
   // ---------------------------------------------------------------------
   tokens = {
     list: () => this.byKind("token_definition"),
-    byCategory: (category) => this.byKind("token_definition").filter((t) => t.category === category)
+    byCategory: (category) => this.byKind("token_definition").filter((t) => t.category === category),
+    symbolExists: (name) => this.tokenBySymbol.has(name),
+    definitionForSymbol: (name) => this.tokenBySymbol.get(name)
   };
   // ---------------------------------------------------------------------
   // Internals
   // ---------------------------------------------------------------------
+  indexTokenSymbols(fact) {
+    const legacyScssAlias = fact.referenceFormat === "scss-var" && fact.name.startsWith("--") ? `$${fact.name.slice(2)}` : fact.referenceFormat === "scss-var" && fact.name.startsWith("$") ? `--${fact.name.slice(1)}` : void 0;
+    for (const symbol of [fact.name, ...fact.sourceNames ?? [], legacyScssAlias]) {
+      if (!symbol) continue;
+      if (!this.tokenBySymbol.has(symbol)) this.tokenBySymbol.set(symbol, fact);
+    }
+  }
   byComponentOfKind(componentId2, kind) {
     const ids = this.idsByComponent.get(logicalComponentId(componentId2));
     if (!ids) return [];
@@ -2142,4 +2183,4 @@ export {
   bridgeSourceViolation,
   bridgeSourceViolations
 };
-//# sourceMappingURL=chunk-243QYRUF.js.map
+//# sourceMappingURL=chunk-MLRDNSSA.js.map