@3fn/core 14.1.0 → 15.0.0

package/src/build/product/__tests__/WebEmitter.test.ts

@@ -1,111 +0,0 @@
-/**
- * @jest-environment node
- * @category evergreen
- * @purpose Unit tests for WebEmitter — CSS output format, refs, unresolved fallback
- */
-
-import { emitCSS } from '../emitters/WebEmitter';
-import type { ResolvedCategory, GeneratorConfig } from '../ProductTokenGenerator';
-
-const config: GeneratorConfig = {
-  productTokensDir: '',
-  tokenIndexDir: '',
-  outputDir: '',
-  configName: 'DesignerPunk',
-  configAbbreviation: 'DP',
-};
-
-const categories: ResolvedCategory[] = [
-  {
-    name: 'layout',
-    description: 'Layout tokens',
-    tokens: [
-      { name: 'contentMaxWidth', value: 1336, unitType: 'logical', ref: null, resolvedPlatformPath: null, themeVarying: false, description: 'Max width', platforms: ['web', 'ios', 'android'] },
-      { name: 'contentIndent', value: null, unitType: null, ref: 'space300', resolvedPlatformPath: { web: '--space-300', ios: 'space300', android: 'space_300' }, themeVarying: false, description: 'Left indent', platforms: ['web', 'ios', 'android'] },
-      { name: 'proseMeasureMax', value: 48, unitType: 'ch', ref: null, resolvedPlatformPath: null, themeVarying: false, description: 'Max line length', platforms: ['web'] },
-    ],
-  },
-  {
-    name: 'motion',
-    description: 'Motion tokens',
-    tokens: [
-      { name: 'flipDuration', value: null, unitType: null, ref: 'duration250', resolvedPlatformPath: { web: '--duration-250', ios: 'Duration.duration250', android: 'Duration.Duration250' }, themeVarying: false, description: 'Flip timing', platforms: ['web', 'ios', 'android'] },
-      { name: 'flickerCurve', value: null, unitType: null, ref: 'easeInOutCustom', resolvedPlatformPath: null, themeVarying: false, description: 'Broken ref', platforms: ['web'] },
-      { name: 'iosOnly', value: 100, unitType: 'logical', ref: null, resolvedPlatformPath: null, themeVarying: false, description: 'iOS only', platforms: ['ios'] },
-    ],
-  },
-  {
-    name: 'typography',
-    description: 'Typography tokens',
-    tokens: [
-      { name: 'statsHeroSize', value: 8, unitType: 'rem', ref: null, resolvedPlatformPath: null, themeVarying: false, description: 'Hero stat size', platforms: ['web'] },
-      { name: 'easterEggDisplay', value: 4.5, unitType: 'rem', ref: null, resolvedPlatformPath: null, themeVarying: false, description: 'Easter egg display', platforms: ['web'] },
-      { name: 'letterSpacingLabel', value: 0.04, unitType: 'em', ref: null, resolvedPlatformPath: null, themeVarying: false, description: 'Label tracking', platforms: ['web'] },
-    ],
-  },
-];
-
-describe('WebEmitter', () => {
-  const output = emitCSS(categories, config);
-
-  it('includes file header', () => {
-    expect(output).toContain('Product tokens — generated');
-    expect(output).toContain('Do not edit manually');
-  });
-
-  it('wraps in :root block', () => {
-    expect(output).toContain(':root {');
-    expect(output).toContain('}');
-  });
-
-  it('emits category headers', () => {
-    expect(output).toContain('/* Product tokens: layout */');
-    expect(output).toContain('/* Product tokens: motion */');
-  });
-
-  it('emits hard-value token with correct unit', () => {
-    expect(output).toContain('--product-layout-content-max-width: 1336px;');
-  });
-
-  it('emits ch unit correctly', () => {
-    expect(output).toContain('--product-layout-prose-measure-max: 48ch;');
-  });
-
-  // Regression: rem/em product tokens must emit with their unit suffix.
-  // Pre-fix these fell through formatCSSValue's default and emitted a bare
-  // number (e.g. "8"), producing invalid CSS the browser drops.
-  // See .kiro/issues/2026-06-12-product-generator-unit-drop.md
-  it('emits rem unit with suffix (integer value)', () => {
-    expect(output).toContain('--product-typography-stats-hero-size: 8rem;');
-  });
-
-  it('emits rem unit with suffix (fractional value)', () => {
-    expect(output).toContain('--product-typography-easter-egg-display: 4.5rem;');
-  });
-
-  it('emits em unit with suffix', () => {
-    expect(output).toContain('--product-typography-letter-spacing-label: 0.04em;');
-  });
-
-  it('emits ref token with var()', () => {
-    expect(output).toContain('--product-layout-content-indent: var(--space-300);');
-  });
-
-  it('emits duration ref with var()', () => {
-    expect(output).toContain('--product-motion-flip-duration: var(--duration-250);');
-  });
-
-  it('emits unresolved ref with warning comment', () => {
-    expect(output).toContain('/* ⚠️ UNRESOLVED */ --product-motion-flicker-curve: initial;');
-  });
-
-  it('includes description as inline comment', () => {
-    expect(output).toContain('/* Max width */');
-    expect(output).toContain('/* Left indent */');
-  });
-
-  it('excludes tokens not targeting web', () => {
-    expect(output).not.toContain('ios-only');
-    expect(output).not.toContain('iosOnly');
-  });
-});

package/src/build/product/__tests__/fixtures/tokens/layout.yaml

@@ -1,21 +0,0 @@
-category: layout
-description: Structural layout constraints
-
-tokens:
-  contentMaxWidth:
-    value: 1336
-    unitType: logical
-    description: Maximum content column width
-    rationale: "Optimized for readability"
-    platforms: [web, ios, android]
-
-  contentIndent:
-    ref: space300
-    description: Left indent for section content
-
-  proseMeasureMax:
-    value: 48
-    unitType: ch
-    description: Maximum line length for body text
-    rationale: "Typographic best practice"
-    platforms: [web]

package/src/build/product/__tests__/fixtures/tokens/motion.yaml

@@ -1,11 +0,0 @@
-category: motion
-description: Product-specific motion
-
-tokens:
-  flipDuration:
-    ref: duration250
-    description: Card-to-modal expansion timing
-
-  flickerCurve:
-    ref: easeInOutCustom
-    description: Broken ref for testing

package/src/build/product/__tests__/fixtures/tokens/visualization.yaml

@@ -1,8 +0,0 @@
-category: visualization
-description: Data visualization tokens
-
-tokens:
-  dangerZoneBackground:
-    ref: color.structure.canvas
-    description: Theme-varying color ref (base light/dark mode-varying via dark override)
-    platforms: [web, ios, android]

package/src/build/product/emitters/KotlinEmitter.ts

@@ -1,83 +0,0 @@
-/**
- * KotlinEmitter — emits Kotlin objects from ResolvedCategory[].
- *
- * @see .kiro/specs/109-product-tokens-validation-generation/design.md § "Kotlin Emitter"
- */
-
-import type { ResolvedCategory, ResolvedToken, GeneratorConfig } from '../ProductTokenGenerator';
-
-export function emitKotlin(categories: ResolvedCategory[], config: GeneratorConfig): string {
-  const lines: string[] = [];
-  const localTheme = `Local${config.configAbbreviation}Theme`;
-
-  const androidTokens = categories.map(c => ({
-    ...c,
-    tokens: c.tokens.filter(t => t.platforms.includes('android')),
-  })).filter(c => c.tokens.length > 0);
-
-  const hasLogical = androidTokens.some(c => c.tokens.some(t => !t.themeVarying && t.unitType === 'logical'));
-  const hasColor = androidTokens.some(c => c.tokens.some(t => !t.themeVarying && t.unitType === 'color'));
-  const hasThemeVarying = androidTokens.some(c => c.tokens.some(t => t.themeVarying));
-  const hasRefs = androidTokens.some(c => c.tokens.some(t => t.ref && !t.themeVarying));
-
-  lines.push('package com.designerpunk.product.tokens');
-  lines.push('');
-
-  // Conditional imports
-  if (hasRefs || hasLogical) lines.push('import com.designerpunk.tokens.DesignTokens');
-  if (hasLogical) lines.push('import androidx.compose.ui.unit.dp');
-  if (hasColor || hasThemeVarying) lines.push('import androidx.compose.ui.graphics.Color');
-  if (hasThemeVarying) {
-    lines.push('import androidx.compose.runtime.Composable');
-    lines.push('import androidx.compose.runtime.ReadOnlyComposable');
-    lines.push(`import com.designerpunk.tokens.${localTheme}`);
-  }
-  lines.push('');
-  lines.push(`// Product tokens — generated ${new Date().toISOString()}`);
-  lines.push('// Do not edit manually. Source: product/tokens/*.yaml');
-  if (hasThemeVarying) {
-    lines.push('// Note: Theme-varying tokens use @Composable getters — must be read inside composition scope.');
-  }
-  lines.push('');
-
-  for (const category of androidTokens) {
-    if (category.tokens.length === 0) continue;
-
-    const objectName = `Product${toPascalCase(category.name)}`;
-    lines.push(`object ${objectName} {`);
-    for (const token of category.tokens) {
-      if (token.themeVarying) {
-        const prop = token.resolvedPlatformPath?.android?.replace('theme.', '') || 'unknown';
-        lines.push(`    val ${token.name}: Color`);
-        lines.push(`        @Composable @ReadOnlyComposable get() = ${localTheme}.current.${prop}`);
-      } else {
-        const value = formatKotlinValue(token);
-        lines.push(`    ${value}`);
-      }
-    }
-    lines.push('}');
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}
-
-function formatKotlinValue(token: ResolvedToken): string {
-  if (token.ref && token.resolvedPlatformPath) {
-    return `val ${token.name} = DesignTokens.${token.resolvedPlatformPath.android}`;
-  }
-  // Hard value
-  switch (token.unitType) {
-    case 'logical': return `val ${token.name} = ${token.value}.dp`;
-    case 'duration': return `val ${token.name}: Int = ${token.value} // ms`;
-    case 'count': return `val ${token.name} = ${token.value}`;
-    case 'ratio': return `val ${token.name} = ${token.value}f`;
-    case 'percent': return `val ${token.name} = ${Number(token.value) / 100}f`;
-    case 'color': return `val ${token.name} = Color(0xFF${String(token.value).replace('#', '')})`;
-    default: return `val ${token.name} = ${token.value}`;
-  }
-}
-
-function toPascalCase(name: string): string {
-  return name.split('-').map(s => s.charAt(0).toUpperCase() + s.slice(1)).join('');
-}

package/src/build/product/emitters/SwiftEmitter.ts

@@ -1,95 +0,0 @@
-/**
- * SwiftEmitter — emits Swift constants from ResolvedCategory[].
- *
- * @see .kiro/specs/109-product-tokens-validation-generation/design.md § "Swift Emitter"
- */
-
-import type { ResolvedCategory, ResolvedToken, GeneratorConfig } from '../ProductTokenGenerator';
-
-export function emitSwift(categories: ResolvedCategory[], config: GeneratorConfig): string {
-  const lines: string[] = [];
-  const themeName = `${config.configName}Theme`;
-
-  const iosTokens = categories.map(c => ({
-    ...c,
-    tokens: c.tokens.filter(t => t.platforms.includes('ios')),
-  })).filter(c => c.tokens.length > 0);
-
-  const hasStatic = iosTokens.some(c => c.tokens.some(t => !t.themeVarying));
-  const hasThemeVarying = iosTokens.some(c => c.tokens.some(t => t.themeVarying));
-
-  // Imports
-  if (hasStatic) lines.push('import UIKit');
-  if (hasThemeVarying) lines.push('import SwiftUI');
-  lines.push('');
-  lines.push(`// Product tokens — generated ${new Date().toISOString()}`);
-  lines.push('// Do not edit manually. Source: product/tokens/*.yaml');
-  lines.push('');
-
-  // Static tokens (enums)
-  for (const category of iosTokens) {
-    const staticTokens = category.tokens.filter(t => !t.themeVarying);
-    if (staticTokens.length === 0) continue;
-
-    const enumName = `Product${toPascalCase(category.name)}`;
-    lines.push(`public enum ${enumName} {`);
-    for (const token of staticTokens) {
-      const { type, value } = formatSwiftValue(token);
-      lines.push(`    public static let ${token.name}: ${type} = ${value}`);
-    }
-    lines.push('}');
-    lines.push('');
-  }
-
-  // Theme-varying tokens (protocol extension)
-  const themeTokens = iosTokens.flatMap(c =>
-    c.tokens.filter(t => t.themeVarying).map(t => ({ ...t, category: c.name }))
-  );
-
-  if (themeTokens.length > 0) {
-    lines.push(`// Theme-varying product tokens — access via @Environment(\\.${config.configAbbreviation.toLowerCase()}Theme)`);
-    lines.push(`public extension ${themeName} {`);
-    for (const token of themeTokens) {
-      const propName = `product${toPascalCase(token.category)}${capitalize(token.name)}`;
-      const systemProp = token.resolvedPlatformPath?.ios?.replace('theme.', '') || 'unknown';
-      lines.push(`    var ${propName}: Color { self.${systemProp} }`);
-    }
-    lines.push('}');
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}
-
-function formatSwiftValue(token: ResolvedToken): { type: string; value: string } {
-  if (token.ref && token.resolvedPlatformPath) {
-    const path = token.resolvedPlatformPath.ios;
-    const type = inferSwiftType(token);
-    return { type, value: `DesignTokens.${path}` };
-  }
-  // Hard value
-  switch (token.unitType) {
-    case 'logical': return { type: 'CGFloat', value: `${token.value}` };
-    case 'duration': return { type: 'TimeInterval', value: `${Number(token.value) / 1000}` };
-    case 'count': return { type: 'Int', value: `${token.value}` };
-    case 'ratio': return { type: 'CGFloat', value: `${token.value}` };
-    case 'percent': return { type: 'CGFloat', value: `${Number(token.value) / 100}` };
-    case 'color': return { type: 'UIColor', value: `UIColor(hex: "${token.value}")` };
-    default: return { type: 'CGFloat', value: `${token.value}` };
-  }
-}
-
-function inferSwiftType(token: ResolvedToken): string {
-  const path = token.resolvedPlatformPath?.ios || '';
-  if (path.startsWith('Duration.') || path.includes('duration')) return 'TimeInterval';
-  if (path.includes('color') || path.includes('Color')) return 'CGFloat'; // static ref to color primitive
-  return 'CGFloat';
-}
-
-function toPascalCase(name: string): string {
-  return name.split('-').map(s => s.charAt(0).toUpperCase() + s.slice(1)).join('');
-}
-
-function capitalize(name: string): string {
-  return name.charAt(0).toUpperCase() + name.slice(1);
-}

package/src/build/product/emitters/WebEmitter.ts

@@ -1,69 +0,0 @@
-/**
- * WebEmitter — emits CSS custom properties from ResolvedCategory[].
- *
- * @see .kiro/specs/109-product-tokens-validation-generation/design.md § "Web (CSS) Emitter"
- */
-
-import { convertToNamingConvention } from '../../../naming/PlatformNamingRules';
-import type { ResolvedCategory, ResolvedToken, GeneratorConfig } from '../ProductTokenGenerator';
-
-export function emitCSS(categories: ResolvedCategory[], _config: GeneratorConfig): string {
-  const lines: string[] = [];
-  lines.push(`/* Product tokens — generated ${new Date().toISOString()} */`);
-  lines.push(`/* Do not edit manually. Source: product/tokens/*.yaml */`);
-  lines.push('');
-  lines.push(':root {');
-
-  for (const category of categories) {
-    const webTokens = category.tokens.filter(t => t.platforms.includes('web'));
-    if (webTokens.length === 0) continue;
-
-    lines.push(`  /* Product tokens: ${category.name} */`);
-    for (const token of webTokens) {
-      const cssName = `--product-${kebabCase(category.name)}-${camelToKebab(token.name)}`;
-      const value = formatValue(token);
-      const comment = token.description ? ` /* ${token.description} */` : '';
-      if (token.ref && !token.resolvedPlatformPath) {
-        lines.push(`  /* ⚠️ UNRESOLVED */ ${cssName}: initial;${comment}`);
-      } else {
-        lines.push(`  ${cssName}: ${value};${comment}`);
-      }
-    }
-    lines.push('');
-  }
-
-  lines.push('}');
-  return lines.join('\n');
-}
-
-function formatValue(token: ResolvedToken): string {
-  if (token.ref && token.resolvedPlatformPath) {
-    return `var(${token.resolvedPlatformPath.web})`;
-  }
-  return formatCSSValue(token.value, token.unitType);
-}
-
-function formatCSSValue(value: number | string | null, unitType: string | null): string {
-  if (value == null) return 'initial';
-  switch (unitType) {
-    case 'logical': return `${value}px`;
-    case 'duration': return `${value}ms`;
-    case 'rem': return `${value}rem`;
-    case 'em': return `${value}em`;
-    case 'ch': return `${value}ch`;
-    case 'percent': return `${value}%`;
-    case 'color':
-    case 'ratio':
-    case 'count':
-    default: return `${value}`;
-  }
-}
-
-function camelToKebab(name: string): string {
-  return convertToNamingConvention(name, 'kebab-case');
-}
-
-function kebabCase(name: string): string {
-  // Category names are already lowercase with hyphens
-  return name;
-}

package/src/build/tokens/.gitkeep

@@ -1 +0,0 @@
-# Token integration layer directory

package/src/build/tokens/__tests__/ClassInvariantGuard.test.ts

@@ -1,167 +0,0 @@
-/**
- * Class-Invariant Guard — PREVENTIVE source scan (authoring surface)
- *
- * Spec 118 Task 9.4 (R8 AC3 — the broader lint codification flagged by Spec 124)
- *
- * THE CLASS INVARIANT (Spec 124 isolation audit):
- *   "No mutable-accumulate-then-read-back state crosses the scopedTsRequire boundary."
- *
- * A module-level singleton is dangerous across that boundary only if it is WRITTEN in
- * one module copy and READ BACK from another. `scopedTsRequire` loads a second copy of
- * `@3fn/core/build`; any singleton compared by shared identity across that boundary
- * desyncs. `ComponentTokenRegistry` was exactly this: `defineComponentTokens` wrote it
- * as an import side effect in the loaded (duplicate) copy, and `loadComponentTokens`
- * read `getAll()` from the canonical (parent) copy → silent zero component tokens
- * (the Spec 118 Task 9.5.3 blocker). Spec 124 converted that seam to a return-value
- * harvest: `defineComponentTokens` no longer self-registers, and `loadComponentTokens`
- * (in src/cli/, OUTSIDE this surface) is the sole writer.
- *
- * WHAT THIS GUARD PINS (the reintroduction vector):
- *   No module in the AUTHORING surface (src/build/tokens/**) writes to a registry
- *   singleton — i.e. no `<Something>Registry.{register|registerBatch|add|set|push}(...)`
- *   call. That is the exact shape of the self-registration side effect 124 removed; a
- *   future `defineX` that re-adds it would reintroduce the cross-boundary split. The
- *   sole LEGITIMATE writer is `loadComponentTokens` (the harvest) in src/cli/, which is
- *   deliberately out of this scan's scope.
- *
- * RELATIONSHIP TO THE OTHER GUARDS (not a duplicate):
- *   - Spec 124 R8 AC2 (src/cli/__tests__/loadComponentTokens.test.ts) pins the SPECIFIC
- *     singleton BEHAVIORALLY: invoking defineComponentTokens in isolation leaves the
- *     canonical registry empty.
- *   - THIS guard is the STRUCTURAL generalization (R8 AC3): it catches ANY future
- *     authoring-surface module reintroducing a registry-write side effect, by source
- *     scan, before it can desync.
- *   - Task 11 codifies the invariant in prose (governance).
- *   It is a structural PROXY for the invariant scoped to the reintroduction vector, not
- *   a full dataflow proof — by design (precision over recall for a preventive guard).
- *
- * Runs under the standard `npm test` AND the consumer-guard CI lane — no separate host.
- *
- * @see .kiro/specs/124-component-token-return-contract/findings/isolation-audit.md
- * @see src/cli/__tests__/loadComponentTokens.test.ts (Spec 124 R8 AC2 — behavioral)
- * @see Spec 118 Task 9.4 (R8 AC3 — the class-invariant lint)
- */
-
-import * as fs from 'fs';
-import * as path from 'path';
-import { glob } from 'glob';
-
-/**
- * A registry-singleton ACCUMULATE-WRITE call: an identifier ending in `Registry`
- * (the codebase convention for these singletons — ComponentTokenRegistry, etc.)
- * followed by a mutation method. Deliberately NOT bare `.set(`/`.add(` (those match
- * benign Map/Set usage) — anchored to a `*Registry` receiver to stay high-signal.
- *
- * Matches: ComponentTokenRegistry.register(  fooRegistry.add(  BarRegistry.push(
- * Does NOT match: this.primitiveRegistry.get(  someMap.set(  registry.query(
- */
-const REGISTRY_WRITE = /\b(\w*[Rr]egistry)\.(register|registerBatch|add|set|push)\s*\(/g;
-
-interface Violation {
-  file: string;
-  line: number;
-  text: string;
-  receiver: string;
-  method: string;
-}
-
-/** Authoring-surface TS files: src/build/tokens/** excluding test files. */
-function getAuthoringSurfaceFiles(): string[] {
-  const surfaceDir = path.resolve(__dirname, '..');
-  return glob.sync('**/*.ts', {
-    cwd: surfaceDir,
-    absolute: true,
-    ignore: ['**/node_modules/**', '**/__tests__/**', '**/*.test.ts', '**/*.spec.ts'],
-  });
-}
-
-/** Scan a file for registry-write side effects. Skips comment lines. */
-function findRegistryWrites(relPath: string, content: string): Violation[] {
-  const violations: Violation[] = [];
-  content.split('\n').forEach((line, index) => {
-    const trimmed = line.trim();
-    if (trimmed.startsWith('//') || trimmed.startsWith('*')) return;
-
-    REGISTRY_WRITE.lastIndex = 0;
-    let match: RegExpExecArray | null;
-    while ((match = REGISTRY_WRITE.exec(line)) !== null) {
-      violations.push({
-        file: relPath,
-        line: index + 1,
-        text: trimmed,
-        receiver: match[1],
-        method: match[2],
-      });
-    }
-  });
-  return violations;
-}
-
-describe('Class-Invariant Guard — authoring surface has no registry-write side effect (Spec 118 Task 9.4)', () => {
-  let surfaceFiles: string[];
-
-  beforeAll(() => {
-    surfaceFiles = getAuthoringSurfaceFiles();
-  });
-
-  it('finds authoring-surface files to scan (sanity check)', () => {
-    // If this reds, the glob or directory moved — the guard would silently have no scope.
-    expect(surfaceFiles.length).toBeGreaterThan(0);
-  });
-
-  it('scanned set excludes test files (scope discipline check)', () => {
-    const testFiles = surfaceFiles.filter(
-      (f) => f.includes('__tests__') || f.includes('.test.ts') || f.includes('.spec.ts')
-    );
-    expect(testFiles).toHaveLength(0);
-  });
-
-  it('DETECTOR BITES: flags a synthetic registry-write side effect', () => {
-    // Prove the scan actually fires (Review: not a formality). If the detector were
-    // broken, the zero-violations assertion below would false-green forever.
-    const positive = [
-      `export function defineBad(x: unknown) {`,
-      `  ComponentTokenRegistry.register(x); // self-registration side effect — the 124 bug`,
-      `  return x;`,
-      `}`,
-    ].join('\n');
-    const hits = findRegistryWrites('synthetic/defineBad.ts', positive);
-    expect(hits.length).toBeGreaterThan(0);
-    expect(hits[0].receiver).toBe('ComponentTokenRegistry');
-    expect(hits[0].method).toBe('register');
-
-    // And does NOT fire on the benign reads/injected-registry usage that fill this surface.
-    const benign = [
-      `const t = this.primitiveRegistry.get(ref);`,
-      `const all = this.semanticRegistry.query();`,
-      `someMap.set(k, v);`,
-    ].join('\n');
-    expect(findRegistryWrites('synthetic/benign.ts', benign)).toHaveLength(0);
-  });
-
-  it('PREVENTIVE: no authoring-surface module writes to a registry singleton (class invariant)', () => {
-    const root = path.resolve(__dirname, '../../../..');
-    const allViolations: Violation[] = [];
-    for (const filePath of surfaceFiles) {
-      const content = fs.readFileSync(filePath, 'utf-8');
-      allViolations.push(
-        ...findRegistryWrites(path.relative(root, filePath), content)
-      );
-    }
-
-    if (allViolations.length > 0) {
-      const report = allViolations
-        .map((v) => `  ${v.file}:${v.line} — ${v.receiver}.${v.method}(\n    > ${v.text}`)
-        .join('\n');
-      throw new Error(
-        `Class-invariant guard tripped: a registry-write side effect was reintroduced in the\n` +
-          `authoring surface (src/build/tokens/**). This is the mutable-accumulate-read-back\n` +
-          `pattern that desyncs across the scopedTsRequire boundary (Spec 118 Task 9.5.3 blocker;\n` +
-          `fixed by Spec 124). Authoring functions (defineComponentTokens & siblings) must RETURN\n` +
-          `their tokens; loadComponentTokens (src/cli/) is the sole registry writer.\n\n` +
-          `Violations (${allViolations.length}):\n${report}`
-      );
-    }
-    expect(allViolations).toHaveLength(0);
-  });
-});