@warpgogol/werkstatt-shared 0.14.0 → 0.15.0

package/src/text/string-utils.ts

@@ -0,0 +1,24 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Maintains packages/share/src/string-utils.ts as an authored share authored module so agents can evolve it without rediscovering local boundaries.</purpose>
+<non-goals>
+  <item>Do not introduce app-specific runtime composition or deployment behavior into this reusable package source file.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine clean
+
+Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. werkstatt-engine now 0 diagnostics.</item>
+</CHANGE_SUMMARY>
+*/
+
+/** Lowercase, dash-only kebab-case. Strips leading/trailing hyphens. */
+export function toKebabCase(value: string): string {
+  return value
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+}

package/src/{share → text}/tests/text-normalize.test.ts

@@ -36,6 +36,11 @@ test("quotes: curly + guillemets become straight", () => {
   expect(normalizeText(input, ALL_ON)).toBe(`"hi" "yo" it's 'a' "de"`);
 });
 
+test("quotes: U+02BC modifier letter apostrophe becomes straight (RFC-1070)", () => {
+  const input = "it\u02BCs";
+  expect(normalizeText(input, ALL_ON)).toBe("it's");
+});
+
 test("ellipsis: single char becomes three dots", () => {
   expect(normalizeText("wait…", ALL_ON)).toBe("wait...");
 });

package/src/{share → text}/text-normalize.ts

@@ -18,6 +18,7 @@ never touched; this only transforms output strings.
 <CHANGE_SUMMARY>
   <item>RFC-0235: initial egress text normalizer.</item>
   <item>RFC-0569: add createDevNormalizeMiddleware for dev/prod egress parity.</item>
+  <item>RFC-1070: add U+02BC modifier letter apostrophe to quotes signal.</item>
 </CHANGE_SUMMARY>
 */
 
@@ -72,7 +73,7 @@ export const SIGNAL_REGISTRY: readonly SignalSpec[] = [
   {
     id: "quotes",
     title: "Typographic / smart quotes",
-    unicode: "U+00AB U+00BB U+2018-U+201F",
+    unicode: "U+00AB U+00BB U+2018-U+201F U+02BC",
     replacement: "straight double / single quote",
     default: true,
   },
@@ -148,8 +149,8 @@ export function resolveNormalizeConfig(manifest: unknown): NormalizeConfig {
 const RE_DASHES = /[‐‑‒–—―−]/g;
 // U+00AB U+00BB U+201C U+201D U+201E U+201F
 const RE_QUOTES_DOUBLE = /[«»“”„‟]/g;
-// U+2018 U+2019 U+201A U+201B
-const RE_QUOTES_SINGLE = /[‘’‚‛]/g;
+// U+2018 U+2019 U+201A U+201B U+02BC (modifier letter apostrophe, RFC-1070)
+const RE_QUOTES_SINGLE = /[‘’‚‛ʼ]/g;
 const RE_ELLIPSIS = /…/g;
 // U+00A0 nbsp, U+1680 ogham, U+2000-U+200A, U+202F narrow nbsp, U+205F medium math,
 // U+3000 ideographic space.

package/src/{share → text}/wrap-inline-numbers.ts

@@ -8,7 +8,7 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>RFC-0041: Created as SSR inline number pre-wrap utility in @warpgogol/werkstatt-shared/share.</item>
+  <item>RFC-0041: Created as SSR inline number pre-wrap utility in @warpgogol/werkstatt-shared/text.</item>
 </CHANGE_SUMMARY>
 */
 

package/src/types/axiom-study.d.ts

@@ -0,0 +1,36 @@
+/*
+<MODULE_CONTRACT>
+<purpose>axiom-study.d.ts — ambient module declaration for the external @syrokomskyi/axiom-study package types.</purpose>
+<non-goals>
+  <item>Do not implement runtime code — this file only declares types for an external package.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1097: sweep — tail packages clean
+
+Sweep batch 3: rewrote ~95 purposes across werkstatt-knowledge, werkstatt-shared, godot-game, phaser-game, lifecycle-core, projektarchiv-*, portal-*, billing-*, typescript (CONTRACT-02/PURPOSE-02). Real KEY_DECISIONS on 5 godot utils, non-goals on 5 CONTRACT-03 files, headers on 4 headerless files, CS-07 history literal fix on 2 files. Policy: vitest.config.ts + test-fixtures testPatterns, worker-configuration.d.ts excludedPath. All non-site/engine packages now 0 diagnostics.</item>
+</CHANGE_SUMMARY>
+*/
+
+declare module "@syrokomskyi/axiom-study" {
+  export interface Finding {
+    findingId: string;
+    semanticFingerprint: { algorithm: "sha256"; digest: string; size: number; mediaType: string };
+    methodologyId: string;
+    ruleId: string;
+    affectedSubjectId: string;
+    title: string;
+    severity: "info" | "low" | "medium" | "high" | "critical";
+    evidence: Array<{
+      evidenceRef: {
+        artifactId: string;
+        rootDigest: { algorithm: "sha256"; digest: string; size: number; mediaType: string };
+        schema: string;
+      };
+      selector: string;
+      evidenceClass: string;
+    }>;
+    uncertainty: unknown[];
+    extension: Record<string, unknown>;
+  }
+}

package/src/types/hls-js-light.d.ts

@@ -0,0 +1,21 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Type shim for the official `hls.js/light` export used by the lazy feature-video runtime.</purpose>
+<non-goals>
+  <item>Do not change runtime resolution; this file only fills the missing package declaration.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine clean
+
+Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. werkstatt-engine now 0 diagnostics.</item>
+</CHANGE_SUMMARY>
+*/
+
+declare module "hls.js/light" {
+  export { default } from "hls.js";
+  export * from "hls.js";
+}

package/src/types/qrcode-browser.d.ts

@@ -0,0 +1,23 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Type shim for the qrcode browser entry point (qrcode/lib/browser.js).
+The qrcode package only ships types for its main entry, but the browser entry
+exports the same toCanvas function. This shim re-exports all types from qrcode
+so the client-side QR code script gets full type safety.</purpose>
+<non-goals>
+  <item>Do not change runtime resolution; this file only fills the missing package declaration.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine clean
+
+Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. werkstatt-engine now 0 diagnostics.</item>
+</CHANGE_SUMMARY>
+*/
+
+declare module "qrcode/lib/browser.js" {
+  export * from "qrcode";
+}

package/src/typography/fix.pbt.test.ts

@@ -0,0 +1,208 @@
+import { describe, it, expect } from "vitest";
+import fc from "fast-check";
+import { applyFixes, FIXABLE_RULE_IDS, isFixable } from "./fix.ts";
+import {
+  TIER1_RULES,
+  createTypographyContext,
+  type TypographyFinding,
+  type TypographyRule,
+} from "./rules-tier1.ts";
+import { TIER2_LOCALE_RULES } from "./rules-tier2-locale.ts";
+import type { TextSegment } from "./text-surface.ts";
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function makeSegment(text: string, locale = "de"): TextSegment {
+  return {
+    file: "test.md",
+    line: 1,
+    path: "$body",
+    source: "body",
+    text,
+    raw: text,
+    isTableRow: false,
+    locale,
+  };
+}
+
+const ALL_FIXABLE_RULES: readonly TypographyRule[] = [...TIER1_RULES, ...TIER2_LOCALE_RULES].filter(
+  (rule) => isFixable(rule.id),
+);
+
+function runFixableRules(text: string, locale: string): TypographyFinding[] {
+  const segment = makeSegment(text, locale);
+  const ctx = createTypographyContext(locale, new Set());
+  const findings: TypographyFinding[] = [];
+  for (const rule of ALL_FIXABLE_RULES) {
+    if (rule.id === "TYPO-ABBR-02" && locale !== "de") continue;
+    if ((rule.id === "TYPO-APOS-01" || rule.id === "TYPO-APOS-02") && locale !== "uk") continue;
+    findings.push(...rule.check(segment, ctx));
+  }
+  return findings;
+}
+
+// ---------------------------------------------------------------------------
+// Property tests (DNA-101: idempotency)
+// ---------------------------------------------------------------------------
+
+describe("Fix engine — property-based tests (RFC-1072, DNA-101)", () => {
+  it("FIXABLE_RULE_IDS contains exactly 7 rule IDs", () => {
+    expect(FIXABLE_RULE_IDS).toHaveLength(7);
+    expect(FIXABLE_RULE_IDS).toContain("TYPO-PUNCT-01");
+    expect(FIXABLE_RULE_IDS).toContain("TYPO-SPACE-01");
+    expect(FIXABLE_RULE_IDS).toContain("TYPO-SPACE-02");
+    expect(FIXABLE_RULE_IDS).toContain("TYPO-APOS-01");
+    expect(FIXABLE_RULE_IDS).toContain("TYPO-APOS-02");
+    expect(FIXABLE_RULE_IDS).toContain("TYPO-ABBR-01");
+    expect(FIXABLE_RULE_IDS).toContain("TYPO-ABBR-02");
+  });
+
+  it("isFixable returns true only for whitelisted rules", () => {
+    for (const id of FIXABLE_RULE_IDS) {
+      expect(isFixable(id)).toBe(true);
+    }
+    expect(isFixable("TYPO-PUNCT-02")).toBe(false);
+    expect(isFixable("TYPO-CASE-01")).toBe(false);
+    expect(isFixable("TYPO-UNICODE-01")).toBe(false);
+  });
+
+  it("applyFixes is idempotent: fixing an already-fixed text produces no new fixes", () => {
+    fc.assert(
+      fc.property(
+        fc.oneof(
+          fc.constant("Hello  world"), // SPACE-01
+          fc.constant("Hello   "), // SPACE-02
+          fc.constant("Hello,, world"), // PUNCT-01
+          fc.constant("Hello:: world"), // PUNCT-01
+          fc.constant("z.B. Hallo"), // ABBR-02 (de)
+          fc.constant("z. B. Hallo"), // already fixed ABBR-02
+        ),
+        (text) => {
+          const findings1 = runFixableRules(text, "de");
+          const { fixedSegments } = applyFixes(findings1, createTypographyContext("de", new Set()));
+          const fixedText = fixedSegments.get("test.md:1:$body") ?? text;
+
+          // Running fixable rules on the fixed text should produce zero fixable findings
+          const findings2 = runFixableRules(fixedText, "de");
+          const fixableFindings2 = findings2.filter((f) => f.fix !== null);
+          expect(fixableFindings2).toHaveLength(0);
+        },
+      ),
+      { numRuns: 100 },
+    );
+  });
+
+  it("applyFixes with no fixable findings returns empty map", () => {
+    const findings: TypographyFinding[] = [];
+    const ctx = createTypographyContext("de", new Set());
+    const result = applyFixes(findings, ctx);
+    expect(result.fixedSegments.size).toBe(0);
+    expect(result.fixCount).toBe(0);
+  });
+
+  it("applyFixes skips findings with fix: null", () => {
+    const segment = makeSegment("Hello world", "de");
+    const findings: TypographyFinding[] = [
+      {
+        ruleId: "TYPO-PUNCT-02",
+        segment,
+        match: "..",
+        column: 5,
+        message: "test",
+        fixHint: "test",
+        fix: null,
+      },
+    ];
+    const ctx = createTypographyContext("de", new Set());
+    const result = applyFixes(findings, ctx);
+    expect(result.fixedSegments.size).toBe(0);
+    expect(result.fixCount).toBe(0);
+  });
+
+  it("replace action replaces the match at the given column", () => {
+    const segment = makeSegment("Hello,, world", "de");
+    const findings: TypographyFinding[] = [
+      {
+        ruleId: "TYPO-PUNCT-01",
+        segment,
+        match: ",,",
+        column: 5,
+        message: "test",
+        fixHint: "test",
+        fix: { type: "replace", old: ",,", new: "," },
+      },
+    ];
+    const ctx = createTypographyContext("de", new Set());
+    const result = applyFixes(findings, ctx);
+    const fixed = result.fixedSegments.get("test.md:1:$body");
+    expect(fixed).toBe("Hello, world");
+  });
+
+  it("insert action inserts text at the specified position", () => {
+    const segment = makeSegment("zB Hallo", "de");
+    const findings: TypographyFinding[] = [
+      {
+        ruleId: "TYPO-ABBR-01",
+        segment,
+        match: "zB",
+        column: 0,
+        message: "test",
+        fixHint: "test",
+        fix: { type: "insert", at: 2, text: "." },
+      },
+    ];
+    const ctx = createTypographyContext("de", new Set());
+    const result = applyFixes(findings, ctx);
+    const fixed = result.fixedSegments.get("test.md:1:$body");
+    expect(fixed).toBe("zB. Hallo");
+  });
+
+  it("delete action removes characters at the specified position", () => {
+    const segment = makeSegment("Hello   ", "de");
+    const findings: TypographyFinding[] = [
+      {
+        ruleId: "TYPO-SPACE-02",
+        segment,
+        match: "   ",
+        column: 5,
+        message: "test",
+        fixHint: "test",
+        fix: { type: "delete", at: 5, length: 3 },
+      },
+    ];
+    const ctx = createTypographyContext("de", new Set());
+    const result = applyFixes(findings, ctx);
+    const fixed = result.fixedSegments.get("test.md:1:$body");
+    expect(fixed).toBe("Hello");
+  });
+
+  it("multiple fixes in the same segment are applied correctly (right-to-left)", () => {
+    const segment = makeSegment("Hello,,  world", "de");
+    const findings: TypographyFinding[] = [
+      {
+        ruleId: "TYPO-PUNCT-01",
+        segment,
+        match: ",,",
+        column: 5,
+        message: "test",
+        fixHint: "test",
+        fix: { type: "replace", old: ",,", new: "," },
+      },
+      {
+        ruleId: "TYPO-SPACE-01",
+        segment,
+        match: "  w",
+        column: 7,
+        message: "test",
+        fixHint: "test",
+        fix: { type: "replace", old: "  w", new: " w" },
+      },
+    ];
+    const ctx = createTypographyContext("de", new Set());
+    const result = applyFixes(findings, ctx);
+    const fixed = result.fixedSegments.get("test.md:1:$body");
+    expect(fixed).toBe("Hello, world");
+  });
+});

package/src/typography/fix.ts

@@ -0,0 +1,148 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Mechanical fix engine for typography violations (RFC-1072). Provides the
+FixAction discriminated union, the FIXABLE_RULE_IDS whitelist, and the applyFixes
+pure function that transforms findings into fixed segment text. Only rules
+whitelisted in FIXABLE_RULE_IDS populate the fix field on TypographyFinding.</purpose>
+<non-goals>
+  <item>Do not read or write files — that is the command adapter in werkstatt-site.</item>
+  <item>Do not run convergence guards — the command adapter re-runs typography.validate.</item>
+  <item>Do not fix rules outside the whitelist — those require human judgment.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1072: initial creation with FixAction type, FIXABLE_RULE_IDS, and applyFixes.</item>
+</CHANGE_SUMMARY>
+*/
+
+import type { TextSegment } from "./text-surface.ts";
+import type { TypographyFinding, TypographyContext } from "./rules-tier1.ts";
+
+// ---------------------------------------------------------------------------
+// FixAction: discriminated union for mechanical fix actions
+// ---------------------------------------------------------------------------
+
+/**
+ * Discriminated union for mechanical fix actions.
+ * Stored on `TypographyFinding.fix` (replacing `null` from RFC-1068).
+ * Only rules whitelisted in FIXABLE_RULE_IDS populate this field;
+ * all other rules keep `fix: null`.
+ */
+export type FixAction =
+  | { type: "replace"; old: string; new: string }
+  | { type: "insert"; at: number; text: string }
+  | { type: "delete"; at: number; length: number };
+
+// ---------------------------------------------------------------------------
+// Whitelist of fixable rule IDs (RFC-1072)
+// ---------------------------------------------------------------------------
+
+/**
+ * Rules that are safe for mechanical fixing. Only PUNCT, SPACE, APOS, and ABBR
+ * families are fixable — other families require human judgment.
+ */
+export const FIXABLE_RULE_IDS: readonly string[] = [
+  "TYPO-PUNCT-01",
+  "TYPO-SPACE-01",
+  "TYPO-SPACE-02",
+  "TYPO-APOS-01",
+  "TYPO-APOS-02",
+  "TYPO-ABBR-01",
+  "TYPO-ABBR-02",
+] as const;
+
+const FIXABLE_SET: ReadonlySet<string> = new Set(FIXABLE_RULE_IDS);
+
+/**
+ * Check if a rule ID is in the fixable whitelist.
+ */
+export function isFixable(ruleId: string): boolean {
+  return FIXABLE_SET.has(ruleId);
+}
+
+// ---------------------------------------------------------------------------
+// Segment identity key (for Map<TextSegment, string>)
+// ---------------------------------------------------------------------------
+
+function segmentKey(segment: TextSegment): string {
+  return `${segment.file}:${segment.line}:${segment.path}`;
+}
+
+// ---------------------------------------------------------------------------
+// Apply a single fix action to segment text
+// ---------------------------------------------------------------------------
+
+function applyAction(text: string, action: FixAction, column: number): string {
+  switch (action.type) {
+    case "replace": {
+      // Replace the match at the given column
+      const before = text.slice(0, column);
+      const after = text.slice(column + action.old.length);
+      return before + action.new + after;
+    }
+    case "insert": {
+      // Insert text at the specified position (relative to segment text)
+      const before = text.slice(0, action.at);
+      const after = text.slice(action.at);
+      return before + action.text + after;
+    }
+    case "delete": {
+      // Delete `length` characters starting at `at`
+      const before = text.slice(0, action.at);
+      const after = text.slice(action.at + action.length);
+      return before + after;
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// applyFixes: apply all fixes to findings, returning fixed segment text
+// ---------------------------------------------------------------------------
+
+/**
+ * Apply mechanical fixes to findings. Each finding must have a non-null `fix`
+ * (populated by the rule when whitelisted in FIXABLE_RULE_IDS).
+ *
+ * The function groups findings by segment, then applies all fixes within a
+ * segment in reverse column order (to avoid offset shifts). Returns a Map keyed
+ * by segment identity, with the full fixed segment text as the value.
+ *
+ * Findings with `fix: null` (non-whitelisted rules) are skipped.
+ */
+export function applyFixes(
+  findings: TypographyFinding[],
+  _context: TypographyContext,
+): { fixedSegments: Map<string, string>; fixCount: number } {
+  // Group findings by segment key
+  const bySegment = new Map<string, { segment: TextSegment; findings: TypographyFinding[] }>();
+
+  for (const f of findings) {
+    if (f.fix === null) continue;
+    const key = segmentKey(f.segment);
+    let entry = bySegment.get(key);
+    if (!entry) {
+      entry = { segment: f.segment, findings: [] };
+      bySegment.set(key, entry);
+    }
+    entry.findings.push(f);
+  }
+
+  const fixedSegments = new Map<string, string>();
+  let fixCount = 0;
+
+  for (const [key, { segment, findings: segFindings }] of bySegment) {
+    // Sort findings by column in descending order to apply from right to left
+    const sorted = [...segFindings].sort((a, b) => b.column - a.column);
+
+    let text = segment.text;
+    for (const f of sorted) {
+      if (f.fix === null) continue;
+      text = applyAction(text, f.fix, f.column);
+      fixCount++;
+    }
+
+    fixedSegments.set(key, text);
+  }
+
+  return { fixedSegments, fixCount };
+}

package/src/typography/index.ts

@@ -0,0 +1,54 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Barrel export for the typography module (RFC-1068, RFC-1069, RFC-1070,
+RFC-1071). Provides the text-surface extractor, Tier 1, Tier 2, and Tier 3 rule
+engines, and locale defaults for the typography.validate command and future
+typography rule families.</purpose>
+<non-goals>
+  <item>Do not implement command adapters — that lives in werkstatt-site.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1068: initial creation.</item>
+  <item>RFC-1069: added Tier 2 structure rules export.</item>
+  <item>RFC-1070: added Tier 2 locale rules export.</item>
+  <item>RFC-1071: added Tier 3 advisory rules export.</item>
+  <item>RFC-1072: added fix module export (FixAction, FIXABLE_RULE_IDS, applyFixes, isFixable).</item>
+</CHANGE_SUMMARY>
+*/
+
+export {
+  extractTextSurface,
+  TECHNICAL_KEYS,
+  deriveFileLocale,
+  type TextSegment,
+  type TextSegmentSource,
+  type TextSurfaceOptions,
+  type YamlError,
+  type ExtractTextSurfaceResult,
+} from "./text-surface.ts";
+
+export {
+  TIER1_RULES,
+  DEFAULT_ALLOWED_TOKENS,
+  createTypographyContext,
+  type TypographyRuleId,
+  type TypographyRuleFamily,
+  type TypographyFinding,
+  type TypographyRule,
+  type TypographyContext,
+} from "./rules-tier1.ts";
+
+export { TIER2_STRUCTURE_RULES } from "./rules-tier2-structure.ts";
+
+export { TIER2_LOCALE_RULES, type Tier2LocaleRuleId } from "./rules-tier2-locale.ts";
+
+export { TIER3_ADVISORY_RULES, type Tier3AdvisoryRuleId } from "./rules-tier3-advisory.ts";
+
+export {
+  LOCALE_DEFAULTS,
+  getLocaleDefaults,
+  type LocaleTypographyDefaults,
+} from "./locale-defaults.ts";
+
+export { type FixAction, FIXABLE_RULE_IDS, isFixable, applyFixes } from "./fix.ts";

package/src/typography/locale-defaults.ts

@@ -0,0 +1,97 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Locale-specific typography defaults for the typography rule engine.
+Exports abbreviation sets, number format defaults, and apostrophe policy keyed
+by locale code (RFC-1068, RFC-1070).</purpose>
+<non-goals>
+  <item>Do not define typography rules — only locale-specific data.</item>
+  <item>Do not read system.md or site configuration.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1068: initial creation with de, uk, en abbreviation sets.</item>
+  <item>RFC-1070: added numberFormat and apostrophePolicy to LocaleTypographyDefaults.</item>
+</CHANGE_SUMMARY>
+*/
+
+export interface LocaleTypographyDefaults {
+  /** Abbreviations ending with a period, used for TYPO-CASE-02 exclusion. */
+  abbreviations: ReadonlySet<string>;
+  /** Number format defaults for TYPO-NUM rules. Added by RFC-1070. */
+  numberFormat: {
+    decimalSeparator: "," | ".";
+    thousandsSeparator: "." | "," | " " | "\u202F";
+  };
+  /** Apostrophe policy for TYPO-APOS rules. Added by RFC-1070. */
+  apostrophePolicy: "straight" | "modifier";
+}
+
+const DE_ABBREVIATIONS = new Set([
+  "z. B.",
+  "u. a.",
+  "d. h.",
+  "bzw.",
+  "ca.",
+  "inkl.",
+  "exkl.",
+  "ggf.",
+  "evtl.",
+  "vgl.",
+  "usw.",
+  "etc.",
+  "Nr.",
+  "Abs.",
+  "Std.",
+  "Min.",
+  "Str.",
+  "vs.",
+  "lit.",
+  "Art.",
+  "Inc.",
+  "e.V.",
+]);
+
+const UK_ABBREVIATIONS = new Set([
+  "напр.",
+  "тис.",
+  "грн",
+  "т. ч.",
+  "ст.",
+  "п.",
+  "р.",
+  "див.",
+  "Див.",
+  "нім.",
+  "Inc.",
+  "e.V.",
+]);
+
+const EN_ABBREVIATIONS = new Set(["e.g.", "i.e.", "etc.", "vs.", "No.", "Inc.", "e.V."]);
+
+export const LOCALE_DEFAULTS: Record<string, LocaleTypographyDefaults> = {
+  de: {
+    abbreviations: DE_ABBREVIATIONS,
+    numberFormat: { decimalSeparator: ",", thousandsSeparator: "." },
+    apostrophePolicy: "straight",
+  },
+  uk: {
+    abbreviations: UK_ABBREVIATIONS,
+    numberFormat: { decimalSeparator: ",", thousandsSeparator: "\u202F" },
+    apostrophePolicy: "straight",
+  },
+  en: {
+    abbreviations: EN_ABBREVIATIONS,
+    numberFormat: { decimalSeparator: ".", thousandsSeparator: "," },
+    apostrophePolicy: "straight",
+  },
+};
+
+export function getLocaleDefaults(locale: string): LocaleTypographyDefaults {
+  return (
+    LOCALE_DEFAULTS[locale] ?? {
+      abbreviations: new Set(),
+      numberFormat: { decimalSeparator: ".", thousandsSeparator: "," },
+      apostrophePolicy: "straight",
+    }
+  );
+}