@multiplatform.one/theme 6.4.3 → 6.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplatform.one/theme",
-  "version": "6.4.3",
+  "version": "6.7.0",
   "description": "Tamagui theme system for multiplatform.one",
   "keywords": [
     "multiplatform",
@@ -53,8 +53,8 @@
     "@tamagui/toast": "2.0.0-rc.41",
     "@tamagui/web": "2.0.0-rc.41",
     "react-cookie": "^8.1.2",
-    "@multiplatform.one/store": "6.4.3",
-    "@multiplatform.one/platform": "6.4.3"
+    "@multiplatform.one/store": "6.7.0",
+    "@multiplatform.one/platform": "6.7.0"
   },
   "devDependencies": {
     "@tamagui/animations-css": "2.0.0-rc.41",
@@ -69,8 +69,8 @@
     "tamagui": "2.0.0-rc.41",
     "typescript": "~5.9.3",
     "vitest": "^4.1.5",
-    "@multiplatform.one/config": "6.4.3",
-    "@multiplatform.one/test-utils": "6.4.3"
+    "@multiplatform.one/test-utils": "6.7.0",
+    "@multiplatform.one/config": "6.7.0"
   },
   "peerDependencies": {
     "@tamagui/animations-css": "^2.0.0-rc",
@@ -92,7 +92,7 @@
   },
   "scripts": {
     "test": "vitest run --coverage --coverage.provider=v8 --coverage.reporter=text --coverage.reporter=lcov --coverage.reporter=html",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsgo --noEmit",
     "build": "rm -rf types 2>/dev/null && tsc -p tsconfig.build.json"
   }
 }

package/src/dates.spec.ts

@@ -1,5 +1,17 @@
 import { describe, expect, it } from "vitest";
-import { formatAbsoluteDate, formatAbsoluteDateTime, formatRelativeTimestamp } from "./dates";
+import {
+  formatAbsoluteDate,
+  formatAbsoluteDateTime,
+  formatDayLong,
+  formatDayOfMonth,
+  formatMonthYear,
+  formatRelativeTimestamp,
+  formatTimeOfDay,
+  getMonthNames,
+  getWeekdayNames,
+  parseCalendarDate,
+  type DateInput,
+} from "./dates";
 
 // Pin locale so assertions don't depend on the host machine.
 const enUS = { locale: "en-US" } as const;
@@ -73,3 +85,148 @@ describe("formatRelativeTimestamp (feed/social register)", () => {
     expect(formatRelativeTimestamp("garbage", base)).toBe("garbage");
   });
 });
+
+describe("formatTimeOfDay (time-of-day register)", () => {
+  it("renders hour and minutes, never seconds", () => {
+    expect(formatTimeOfDay(new Date(2026, 7, 12, 14, 30, 45), enUS)).toBe("2:30 PM");
+  });
+
+  it("drops minutes for hour ticks", () => {
+    expect(formatTimeOfDay(new Date(2026, 7, 12, 14, 0), { ...enUS, minutes: false })).toBe("2 PM");
+  });
+
+  it("accepts a clock-time string — the wire shape Frappe Time fields send", () => {
+    expect(formatTimeOfDay("14:30", enUS)).toBe("2:30 PM");
+    expect(formatTimeOfDay("14:30:00", enUS)).toBe("2:30 PM");
+  });
+
+  it("passes unparseable strings through and renders empty input empty", () => {
+    expect(formatTimeOfDay("later", enUS)).toBe("later");
+    expect(formatTimeOfDay(null, enUS)).toBe("");
+  });
+});
+
+describe("calendar chrome registers", () => {
+  it("speaks a long day name for headers and accessible names", () => {
+    expect(formatDayLong(new Date(2026, 2, 10), enUS)).toBe("Tuesday, March 10");
+    expect(formatDayLong(new Date(2026, 2, 10), { ...enUS, weekday: false })).toBe("March 10");
+    expect(formatDayLong(new Date(2026, 2, 10), { ...enUS, year: true })).toBe(
+      "Tuesday, March 10, 2026",
+    );
+  });
+
+  it("names months and weekdays for calendar grids", () => {
+    expect(getMonthNames(enUS)[0]).toBe("January");
+    expect(getMonthNames({ ...enUS, style: "short" })[2]).toBe("Mar");
+    expect(getWeekdayNames(enUS)).toEqual(["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"]);
+    expect(getWeekdayNames({ ...enUS, firstDay: 1 })[0]).toBe("Mon");
+  });
+});
+
+describe("axis-tick registers", () => {
+  it("drops the year entirely so ticks keep a stable width", () => {
+    expect(formatAbsoluteDate(new Date(2025, 2, 10), { ...enUS, now, year: "never" })).toBe(
+      "Mar 10",
+    );
+  });
+
+  it("renders month-year and day-of-month ticks", () => {
+    expect(formatMonthYear(new Date(2026, 2, 10), enUS)).toBe("Mar 2026");
+    expect(formatMonthYear(new Date(2026, 2, 10), { ...enUS, month: "long" })).toBe("March 2026");
+    expect(formatDayOfMonth(new Date(2026, 2, 10), enUS)).toBe("10");
+  });
+});
+
+// Spans UTC, two negative offsets and the far positive extreme (UTC+14), so a
+// parse that leans on the host zone fails somewhere in this list.
+const ZONES = ["UTC", "America/Los_Angeles", "America/New_York", "Pacific/Kiritimati"] as const;
+
+function inZone<T>(timeZone: string, read: () => T): T {
+  const previous = process.env.TZ;
+  process.env.TZ = timeZone;
+  try {
+    return read();
+  } finally {
+    if (previous === undefined) delete process.env.TZ;
+    else process.env.TZ = previous;
+  }
+}
+
+/**
+ * Local wall-clock reading of a parse, taken INSIDE the zone — a Date is an
+ * instant, so its day and hour only mean something against an ambient zone.
+ */
+function readLocal(timeZone: string, value: DateInput) {
+  return inZone(timeZone, () => {
+    const date = parseCalendarDate(value);
+    if (!date) return null;
+    const pad = (n: number) => String(n).padStart(2, "0");
+    return {
+      day: `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`,
+      clock: `${pad(date.getHours())}:${pad(date.getMinutes())}`,
+    };
+  });
+}
+
+describe("parseCalendarDate (day-grid parse)", () => {
+  it("reads a date-only string as the same calendar day in every timezone", () => {
+    for (const timeZone of ZONES) {
+      expect({ timeZone, ...readLocal(timeZone, "2026-03-10") }).toEqual({
+        timeZone,
+        day: "2026-03-10",
+        // Local midnight, which is what day-grid math tests for: Gantt's
+        // normalizeSpanEdges only grants a date-only end its inclusive last
+        // day when the edge sits exactly on midnight.
+        clock: "00:00",
+      });
+    }
+  });
+
+  it("guards the ECMA-262 default this exists to avoid", () => {
+    // `new Date("YYYY-MM-DD")` is UTC midnight, so the naive parse names the
+    // previous day west of UTC. If this ever stops shifting, the test above
+    // has stopped proving anything.
+    const naive = inZone("America/Los_Angeles", () => new Date("2026-03-10").getDate());
+    expect(naive).toBe(9);
+  });
+
+  it("keeps the timezone-aware parse for values that carry a time", () => {
+    for (const timeZone of ZONES) {
+      // No offset in the string — a local wall-clock reading, unchanged.
+      expect(readLocal(timeZone, "2026-03-10 14:30:00")).toEqual({
+        day: "2026-03-10",
+        clock: "14:30",
+      });
+    }
+    // An explicit offset names one instant, which lands on different local
+    // days by design — genuine datetime semantics are untouched.
+    expect(readLocal("UTC", "2026-03-10T00:00:00Z")).toEqual({ day: "2026-03-10", clock: "00:00" });
+    expect(readLocal("America/Los_Angeles", "2026-03-10T00:00:00Z")).toEqual({
+      day: "2026-03-09",
+      clock: "17:00", // PDT — March 10 is past the 2026 DST switch
+    });
+  });
+
+  it("passes Date instances and epoch millis through untouched", () => {
+    const instance = new Date(2026, 2, 10, 9, 15);
+    expect(parseCalendarDate(instance)).toBe(instance);
+    expect(parseCalendarDate(Date.UTC(2026, 2, 10))?.toISOString()).toBe(
+      "2026-03-10T00:00:00.000Z",
+    );
+  });
+
+  it("returns null for empty, unparseable and out-of-range input", () => {
+    expect(parseCalendarDate(null)).toBeNull();
+    expect(parseCalendarDate(undefined)).toBeNull();
+    expect(parseCalendarDate("")).toBeNull();
+    expect(parseCalendarDate("not-a-date")).toBeNull();
+    expect(parseCalendarDate(new Date("nonsense"))).toBeNull();
+    // Rolled over rather than rejected would silently render April 14.
+    expect(parseCalendarDate("2026-13-45")).toBeNull();
+    expect(parseCalendarDate("2026-02-30")).toBeNull();
+  });
+
+  it("keeps a two-digit-looking year literal instead of mapping it to 19xx", () => {
+    expect(inZone("UTC", () => parseCalendarDate("0050-03-10")?.getFullYear())).toBe(50);
+  });
+});

package/src/dates.ts

@@ -65,6 +65,43 @@ function coerceDateInput(value: DateInput): CoercedDate | null {
   return Number.isNaN(date.getTime()) ? null : { date, dateOnly: false };
 }
 
+/**
+ * Parse a date value onto the LOCAL calendar day it names — the canonical
+ * parse for anything that will be positioned on a day grid (calendar cells,
+ * Gantt bars, date axes) rather than merely formatted.
+ *
+ * A date-only string ("YYYY-MM-DD") is a calendar date carrying no timezone,
+ * which is how Frappe sends `Date` fields. ECMA-262 parses that form as UTC
+ * midnight, so every zone west of UTC reads it as the *previous* local day,
+ * and no zone but UTC lands it on the local midnight that day-grid math tests
+ * for. Those are built from local parts instead.
+ *
+ * Values that carry a time ("YYYY-MM-DD HH:MM:SS", ISO with an offset, epoch
+ * millis) are genuine instants and keep the timezone-aware parse untouched.
+ *
+ * Returns null for empty and unparseable input, and for out-of-range parts
+ * ("2026-13-45") rather than silently rolling them into the next month.
+ */
+export function parseCalendarDate(value: DateInput): Date | null {
+  if (value == null || value === "") return null;
+  if (value instanceof Date) return Number.isNaN(value.getTime()) ? null : value;
+  if (typeof value === "number") {
+    const fromEpoch = new Date(value);
+    return Number.isNaN(fromEpoch.getTime()) ? null : fromEpoch;
+  }
+  const trimmed = value.trim();
+  if (ISO_DATE_ONLY.test(trimmed)) {
+    const [year, month, day] = trimmed.split("-").map(Number);
+    const date = new Date(year, month - 1, day);
+    // `new Date(50, …)` means 1950 — pin the year the string actually named.
+    if (year < 100) date.setFullYear(year);
+    if (date.getMonth() !== month - 1 || date.getDate() !== day) return null;
+    return date;
+  }
+  const parsed = new Date(trimmed.replace(" ", "T"));
+  return Number.isNaN(parsed.getTime()) ? null : parsed;
+}
+
 /**
  * Compact absolute date — the house register for every absolute date.
  * "Jul 1" / "Jul 1, 2025" (year auto-elided when current), or with

package/src/devWarn.ts

@@ -32,6 +32,42 @@ export type DevWarnDetail = {
   [key: string]: unknown;
 };
 
+/**
+ * LC-57 GUARDRAIL-CLEAN-STORIES allowlist entry, declared as a Storybook story
+ * parameter (`parameters.guardrailSpecimen`).
+ *
+ * Catalog stories emit zero `[theme]` guardrail warnings at rest. A story whose
+ * whole purpose is to demonstrate the warned state (a disabled-dial specimen, a
+ * pager boundary case) is allowlisted by declaring itself:
+ *
+ * ```ts
+ * export const Disabled: Story = {
+ *   parameters: {
+ *     guardrailSpecimen: {
+ *       warns: ["bare-disabled"],
+ *       reason: "Demonstrates the disabled dial; Stepper has no disabledReason plumbing.",
+ *     } satisfies GuardrailSpecimenParameter,
+ *   },
+ * };
+ * ```
+ *
+ * Semantics, pinned:
+ * - `warns` is the CLOSED set of codes the story may emit at rest. An emitted
+ *   code outside the set still FAILs the story.
+ * - A declared code that happens not to fire passes — component improvements
+ *   must never break an allowlist entry.
+ * - The declaration NEVER suppresses the console warning — the warn still
+ *   fires; only the warn-harvester tolerates it (explicit, never tacit).
+ * - Harvesters (`p-results/story-hygiene/verify.mjs`) read this parameter off
+ *   the rendered story and fail CLOSED when parameters cannot be read at all.
+ */
+export type GuardrailSpecimenParameter = {
+  /** Warn codes this story may emit at rest — a closed set, not a wildcard. */
+  warns: DevWarnCode[];
+  /** Why the warned state is the story's subject (recorded per LC-57). */
+  reason: string;
+};
+
 const seen = new Set<string>();
 
 function isDev(): boolean {

package/src/numbers.spec.ts

@@ -0,0 +1,112 @@
+import { describe, expect, it } from "vitest";
+import { formatCurrency, formatNumber, formatPercent, resolveCurrencyCode } from "./numbers";
+
+// Pin locale so assertions don't depend on the host machine.
+const enUS = { locale: "en-US" } as const;
+
+describe("formatNumber (LC-12 cardinal register)", () => {
+  it("groups thousands — the aggregate that used to render raw", () => {
+    expect(formatNumber(15400, enUS)).toBe("15,400");
+    expect(formatNumber(1234567, enUS)).toBe("1,234,567");
+  });
+
+  it("keeps up to two fraction digits without inventing any", () => {
+    expect(formatNumber(5133.33, enUS)).toBe("5,133.33");
+    expect(formatNumber(5133.3, enUS)).toBe("5,133.3");
+    expect(formatNumber(5133, enUS)).toBe("5,133");
+    expect(formatNumber(5133.336, enUS)).toBe("5,133.34");
+  });
+
+  it("pins fraction digits with precision (fixed-precision columns)", () => {
+    expect(formatNumber(15400, { ...enUS, precision: 2 })).toBe("15,400.00");
+    expect(formatNumber(15400.6, { ...enUS, precision: 0 })).toBe("15,401");
+  });
+
+  it("honours a wider maximum for report floats", () => {
+    expect(formatNumber(3.14159, { ...enUS, maximumFractionDigits: 4 })).toBe("3.1416");
+  });
+
+  it("can drop grouping when a caller owns the layout", () => {
+    expect(formatNumber(15400, { ...enUS, grouping: false })).toBe("15400");
+  });
+
+  it("coerces numeric strings — wire values still reach the register", () => {
+    expect(formatNumber("15400", enUS)).toBe("15,400");
+  });
+
+  it("renders empty input as empty and passes unparseable text through", () => {
+    expect(formatNumber(null, enUS)).toBe("");
+    expect(formatNumber(undefined, enUS)).toBe("");
+    expect(formatNumber("", enUS)).toBe("");
+    expect(formatNumber("n/a", enUS)).toBe("n/a");
+    expect(formatNumber(Number.NaN, enUS)).toBe("");
+  });
+});
+
+describe("formatCurrency (LC-12 money register)", () => {
+  it("defaults to two fraction digits so a money column stays aligned", () => {
+    expect(formatCurrency(15400, enUS)).toBe("15,400.00");
+    expect(formatCurrency(15400, { ...enUS, symbol: "$" })).toBe("$15,400.00");
+  });
+
+  it("elides a whole-value .00 in the summary-tile variant", () => {
+    expect(formatCurrency(48250, { ...enUS, symbol: "$", fractionDigits: "auto" })).toBe("$48,250");
+  });
+
+  it("still shows cents in the summary variant when the value has them", () => {
+    expect(formatCurrency(48250.5, { ...enUS, symbol: "$", fractionDigits: "auto" })).toBe(
+      "$48,250.50",
+    );
+  });
+
+  it("renders an ISO code through the currency's own symbol placement", () => {
+    expect(formatCurrency(15400, { ...enUS, currency: "USD" })).toBe("$15,400.00");
+    expect(formatCurrency(15400, { ...enUS, currency: "EUR" })).toBe("€15,400.00");
+  });
+
+  it("resolves a known symbol to its code, prefixes an unknown one", () => {
+    expect(formatCurrency(1500, { ...enUS, symbol: "₹" })).toBe("₹1,500.00");
+    expect(formatCurrency(1500, { ...enUS, symbol: "¤" })).toBe("¤1,500.00");
+  });
+
+  it("keeps the grouped register when a bad code makes Intl throw", () => {
+    // A Frappe field can hand over a malformed code; the money register must
+    // still group ("EUROS1,500.00", never a bare "1500").
+    expect(formatCurrency(1500, { ...enUS, currency: "EUROS" })).toBe("EUROS1,500.00");
+  });
+
+  it("honours an explicit precision from a Frappe field", () => {
+    expect(formatCurrency(1500.456, { ...enUS, symbol: "$", precision: 3 })).toBe("$1,500.456");
+  });
+
+  it("renders empty input as empty", () => {
+    expect(formatCurrency(null, enUS)).toBe("");
+    expect(formatCurrency("", { ...enUS, symbol: "$" })).toBe("");
+  });
+});
+
+describe("formatPercent (LC-12 rate register)", () => {
+  it("takes percent units, not a ratio", () => {
+    expect(formatPercent(94.2, enUS)).toBe("94.2%");
+    expect(formatPercent(3, enUS)).toBe("3%");
+  });
+
+  it("pins report precision", () => {
+    expect(formatPercent(94.25, { ...enUS, precision: 1 })).toBe("94.3%");
+  });
+
+  it("renders empty input as empty", () => {
+    expect(formatPercent(null, enUS)).toBe("");
+  });
+});
+
+describe("resolveCurrencyCode", () => {
+  it("maps the common symbols and passes codes through", () => {
+    expect(resolveCurrencyCode("$")).toBe("USD");
+    expect(resolveCurrencyCode("₹")).toBe("INR");
+    expect(resolveCurrencyCode("eur")).toBe("EUR");
+    expect(resolveCurrencyCode("R$")).toBe("BRL");
+    expect(resolveCurrencyCode("¤")).toBeUndefined();
+    expect(resolveCurrencyCode(undefined)).toBeUndefined();
+  });
+});

package/src/numbers.ts

@@ -62,6 +62,8 @@ const CURRENCY_SYMBOL_TO_CODE: Record<string, string> = {
   "¥": "JPY",
   "₹": "INR",
   "₩": "KRW",
+  "₽": "RUB",
+  R$: "BRL",
 };
 
 /**
@@ -97,14 +99,22 @@ function resolveDigits(
   return { minimumFractionDigits: min, maximumFractionDigits: Math.max(min, max) };
 }
 
-function formatWith(num: number, options: Intl.NumberFormatOptions, locale?: string): string {
+function tryFormatWith(
+  num: number,
+  options: Intl.NumberFormatOptions,
+  locale?: string,
+): string | null {
   try {
     return new Intl.NumberFormat(locale, options).format(num);
   } catch {
-    return String(num);
+    return null;
   }
 }
 
+function formatWith(num: number, options: Intl.NumberFormatOptions, locale?: string): string {
+  return tryFormatWith(num, options, locale) ?? String(num);
+}
+
 /**
  * Cardinal / aggregate register — grouped digits, at most two fraction
  * digits ("15,400", "5,133.33"). Empty input renders "" and an unparseable
@@ -142,14 +152,19 @@ export function formatCurrency(value: NumberInput, options: CurrencyFormatOption
   const code = currency ?? resolveCurrencyCode(symbol);
   const useGrouping = grouping ?? true;
   if (code) {
-    return formatWith(
+    // A malformed code from a Frappe field must not cost the whole money
+    // register: fall back to the grouped register with the label prefixed
+    // rather than letting Intl's throw leak a bare `String(num)`.
+    const styled = tryFormatWith(
       coerced.num,
       { ...digits, useGrouping, style: "currency", currency: code },
       locale,
     );
+    if (styled != null) return styled;
   }
   const amount = formatWith(coerced.num, { ...digits, useGrouping }, locale);
-  return symbol ? `${symbol}${amount}` : amount;
+  const label = symbol ?? currency;
+  return label ? `${label}${amount}` : amount;
 }
 
 /**

package/src/theme/cookies.spec.ts

@@ -104,6 +104,85 @@ describe("readOverridesCookie", () => {
   });
 });
 
+// Regression: react-cookie's jar (universal-cookie) auto-JSON-parses every
+// cookie value it can, so the KnobBridge/useTheme read path receives
+// already-parsed OBJECTS — the old reader joined them into "[object Object]",
+// JSON.parse threw, and overrides silently resolved to {} app-wide.
+describe("readOverridesCookie with universal-cookie auto-parsed values", () => {
+  it("accepts an already-parsed object cookie value (universal-cookie shape)", () => {
+    const overrides: Partial<Knobs> = { borderRadius: "none", space: "small" };
+    expect(readOverridesCookie({ "mp.ov.0": overrides })).toEqual(overrides);
+  });
+
+  it("accepts a raw JSON string cookie value (document.cookie / SSR shape)", () => {
+    const overrides: Partial<Knobs> = { borderRadius: "none", space: "small" };
+    expect(readOverridesCookie({ "mp.ov.0": JSON.stringify(overrides) })).toEqual(overrides);
+  });
+
+  it("preserves nested interaction-state overrides from a parsed object", () => {
+    const overrides: Partial<Knobs> = { hover: { elevation: "large" } };
+    expect(readOverridesCookie({ "mp.ov.0": overrides })).toEqual(overrides);
+  });
+
+  it("round-trips writeOverridesCookie output through an auto-parsing jar", () => {
+    const overrides: Partial<Knobs> = { density: "compact", fillStyle: "outlined" };
+    const { toSet } = writeOverridesCookie(overrides);
+    // Simulate universal-cookie readCookie: JSON.parse succeeds on the
+    // single-chunk value, so the jar hands back an object.
+    const jar = Object.fromEntries(toSet.map(({ key, value }) => [key, JSON.parse(value)]));
+    expect(readOverridesCookie(jar)).toEqual(overrides);
+  });
+
+  it("round-trips oversized multi-chunk payloads through an auto-parsing jar", () => {
+    const bigValue = "x".repeat(8000);
+    const overrides = { animation: bigValue } as unknown as Partial<Knobs>;
+    const { toSet } = writeOverridesCookie(overrides);
+    expect(toSet.length).toBeGreaterThan(1);
+    // universal-cookie leaves each chunk a string: a JSON fragment throws in
+    // its JSON.parse attempt, so readCookie falls back to the raw value.
+    const jar = Object.fromEntries(
+      toSet.map(({ key, value }) => {
+        try {
+          return [key, JSON.parse(value)];
+        } catch {
+          return [key, value];
+        }
+      }),
+    );
+    expect(readOverridesCookie(jar)).toEqual(overrides);
+  });
+
+  it("returns safe empty for garbage values", () => {
+    expect(readOverridesCookie({ "mp.ov.0": 42 })).toEqual({});
+    expect(readOverridesCookie({ "mp.ov.0": true })).toEqual({});
+    expect(readOverridesCookie({ "mp.ov.0": ["not", "overrides"] })).toEqual({});
+    expect(readOverridesCookie({ "mp.ov.0": "not{valid json" })).toEqual({});
+    expect(readOverridesCookie({ "mp.ov.0": "[object Object]" })).toEqual({});
+  });
+
+  it("returns safe empty for mixed chunk types (object followed by string)", () => {
+    expect(
+      readOverridesCookie({
+        "mp.ov.0": { borderRadius: "none" },
+        "mp.ov.1": '{"space":"small"}',
+      }),
+    ).toEqual({});
+  });
+
+  it("drops non-knob-shaped entries inside a parsed object", () => {
+    expect(
+      readOverridesCookie({
+        "mp.ov.0": {
+          borderRadius: "none",
+          count: 3,
+          list: ["a"],
+          hover: { elevation: "large", depth: { nested: true } },
+        },
+      }),
+    ).toEqual({ borderRadius: "none", hover: { elevation: "large" } });
+  });
+});
+
 describe("readPresetCookie", () => {
   it("returns undefined when cookie is missing", () => {
     expect(readPresetCookie({})).toBeUndefined();
@@ -116,6 +195,11 @@ describe("readPresetCookie", () => {
   it("returns the preset name", () => {
     expect(readPresetCookie({ [cookiePreset]: "dark-mode" })).toBe("dark-mode");
   });
+
+  it("returns undefined for non-string jar values (universal-cookie auto-parse)", () => {
+    expect(readPresetCookie({ [cookiePreset]: 123 })).toBeUndefined();
+    expect(readPresetCookie({ [cookiePreset]: { nested: true } })).toBeUndefined();
+  });
 });
 
 describe("writePresetCookie", () => {

package/src/theme/cookies.ts

@@ -69,34 +69,82 @@ function chunkKey(index: number): string {
 // Cookie read helpers (work with raw cookie objects from react-cookie)
 // ---------------------------------------------------------------------------
 
+/**
+ * Shape-validate a parsed overrides payload before it reaches knob
+ * resolution: keep knob-shaped entries — string values plus one-level
+ * StateKnobs-style objects of string values (`hover`, `press`, …) — and drop
+ * everything else, so a corrupt or foreign cookie can never spread garbage
+ * (arrays, numbers, deep objects) into `{ ...preset.knobs, ...overrides }`.
+ */
+function sanitizeOverrides(parsed: unknown): Partial<Knobs> {
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    return {};
+  }
+  const overrides: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(parsed)) {
+    if (typeof value === "string") {
+      overrides[key] = value;
+    } else if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+      const nested: Record<string, string> = {};
+      for (const [stateKey, stateValue] of Object.entries(value)) {
+        if (typeof stateValue === "string") nested[stateKey] = stateValue;
+      }
+      overrides[key] = nested;
+    }
+  }
+  return overrides as Partial<Knobs>;
+}
+
 /**
  * Read the overrides cookie value, handling chunked cookies.
- * Accepts the cookies object from `useCookies()`.
+ *
+ * Accepts BOTH value shapes a cookie jar can deliver:
+ *   - already-parsed OBJECTS — react-cookie's `useCookies()` jar
+ *     (universal-cookie) auto-JSON-parses every cookie value it can (its
+ *     `readCookie` tries `JSON.parse` unless `doNotParse` is set), so a
+ *     single-chunk overrides cookie arrives here as an object, not a string;
+ *   - raw JSON STRINGS — direct `document.cookie` / SSR cookie-header reads
+ *     (`loadPresetOverrides`), and multi-chunk payloads on every path (a
+ *     fragment of a split JSON document does not parse on its own, so even
+ *     universal-cookie leaves those chunks as strings).
+ *
+ * Anything else (numbers, arrays, mixed chunk types, malformed JSON) reads
+ * as no overrides, and every parsed payload is shape-validated before use.
  */
-export function readOverridesCookie(cookies: Record<string, string | undefined>): Partial<Knobs> {
+export function readOverridesCookie(cookies: Record<string, unknown>): Partial<Knobs> {
   // Reconstruct from chunked cookies: mp.ov.0, mp.ov.1, …
-  const chunks: string[] = [];
+  const chunks: unknown[] = [];
   for (let i = 0; i < maxChunks; i++) {
     const chunk = cookies[chunkKey(i)];
     if (!chunk) break;
     chunks.push(chunk);
   }
-  if (chunks.length > 0) {
-    try {
-      return JSON.parse(joinSplitCookieValues(chunks));
-    } catch {
-      return {};
-    }
+  if (chunks.length === 0) return {};
+
+  // universal-cookie path: the jar already parsed the JSON for us.
+  if (chunks.length === 1 && typeof chunks[0] === "object") {
+    return sanitizeOverrides(chunks[0]);
   }
 
-  return {};
+  // Raw string path: join chunks and parse the canonical JSON serialization.
+  if (!chunks.every((chunk): chunk is string => typeof chunk === "string")) {
+    return {};
+  }
+  try {
+    return sanitizeOverrides(JSON.parse(joinSplitCookieValues(chunks)));
+  } catch {
+    return {};
+  }
 }
 
 /**
- * Read the preset name from the cookie.
+ * Read the preset name from the cookie. universal-cookie auto-JSON-parses
+ * jar values, so a numeric-looking name would arrive as a number — preset
+ * names are strings by contract, anything else reads as no preset.
  */
-export function readPresetCookie(cookies: Record<string, string | undefined>): string | undefined {
-  return cookies[cookiePreset] || undefined;
+export function readPresetCookie(cookies: Record<string, unknown>): string | undefined {
+  const value = cookies[cookiePreset];
+  return typeof value === "string" && value.length > 0 ? value : undefined;
 }
 
 // ---------------------------------------------------------------------------

package/src/theme/index.ts

@@ -18,6 +18,7 @@ export * from "./Preset";
 export type { Preset as PresetDefinition, IntentOverride } from "./preset.types";
 export * from "./PresetContext";
 export * from "./presets";
+export * from "./radiusClass";
 export * from "./readableColor";
 export * from "./recipes";
 export * from "./resolveKnobs";

package/src/theme/radiusClass.ts

@@ -0,0 +1,51 @@
+/**
+ * Radius-class declarations (D-09 / LC-60).
+ *
+ * Most parts prove they obey the radius knob by simply going square at
+ * `borderRadius:none`. A few legitimately do not — an ornamental dot has no
+ * arc for the knob to move (R-PILL), and an avatar's circle is the object's
+ * identity rather than a style (R-IDENTITY). Those parts must SAY SO on the
+ * node, because the alternative — a probe that skips anything that looks
+ * round — silently exempts real KNOB-TOTALITY defects (LC-18).
+ *
+ * The declaration is only half the contract: the `radius:none` sweep
+ * validates it against the registry GENERATED from the spec's radius-class
+ * table (`scripts/radius-identity-registry.mjs`), so a class this file cannot
+ * spell, or an R-IDENTITY part the spec never adjudicated, still fails. This
+ * module is the writing end; `docs/theme-propagation-spec.md` is the registry.
+ */
+
+/**
+ * The radius classes whose parts stay round at `borderRadius:none`.
+ *
+ * - `R-PILL` — a pill/circle at every radius value (ornamental dots, badge
+ *   indicators, icon wells). Size still tracks the size knob.
+ * - `R-IDENTITY` — the shape IS the part's identity (Avatar, brand marks).
+ *   Membership is enumerated in the spec table and enforced per part.
+ */
+export type KnobImmuneRadiusClass = "R-PILL" | "R-IDENTITY";
+
+export interface RadiusClassDeclaration {
+  "data-radius-class": KnobImmuneRadiusClass;
+  "data-radius-part": string;
+}
+
+/**
+ * Declare a knob-immune shape so the `radius:none` sweep can license it.
+ *
+ * Spread onto the outermost node of the shape — a declaration covers its own
+ * anatomy, so inner painted parts (an avatar's image/fallback) inherit it.
+ *
+ * @param radiusClass the class the spec's Radius table assigns the part
+ * @param part the part name as the spec writes it (the R-IDENTITY registry
+ *   is matched by this name)
+ *
+ * @example
+ * <Frame {...radiusClassProps("R-IDENTITY", "Avatar")} circular />
+ */
+export function radiusClassProps(
+  radiusClass: KnobImmuneRadiusClass,
+  part: string,
+): RadiusClassDeclaration {
+  return { "data-radius-class": radiusClass, "data-radius-part": part };
+}

package/src/theme/readableColor.spec.ts

@@ -0,0 +1,115 @@
+import { describe, expect, it } from "vitest";
+import { resolveAccentTintedSurface } from "./readableColor";
+import { contrastRatio, normalizeToHex, relativeLuminance } from "./colorRules";
+
+// The stock accent ramp (defaults/accent.ts) as the theme resolves it.
+const lightAccent = [
+  "hsla(250, 50%, 62%, 1)",
+  "hsla(250, 50%, 58%, 1)",
+  "hsla(250, 50%, 54%, 1)",
+  "hsla(250, 50%, 48%, 1)",
+  "hsla(250, 50%, 46%, 1)",
+  "hsla(250, 50%, 44%, 1)",
+  "hsla(250, 50%, 42%, 1)",
+  "hsla(250, 50%, 40%, 1)",
+  "hsla(250, 50%, 38%, 1)",
+  "hsla(250, 50%, 36%, 1)",
+  "hsla(250, 50%, 95%, 1)",
+  "hsla(250, 50%, 98%, 1)",
+];
+const darkAccent = [
+  "hsla(250, 50%, 35%, 1)",
+  "hsla(250, 50%, 38%, 1)",
+  "hsla(250, 50%, 41%, 1)",
+  "hsla(250, 50%, 43%, 1)",
+  "hsla(250, 50%, 46%, 1)",
+  "hsla(250, 50%, 49%, 1)",
+  "hsla(250, 50%, 52%, 1)",
+  "hsla(250, 50%, 54%, 1)",
+  "hsla(250, 50%, 57%, 1)",
+  "hsla(250, 50%, 60%, 1)",
+  "hsla(250, 50%, 90%, 1)",
+  "hsla(250, 50%, 95%, 1)",
+];
+
+const lightPaper = "#ffffff";
+const lightInk = "#242226";
+const darkPaper = "#161519";
+const darkInk = "#f0eff1";
+
+const lum = (raw: string) => relativeLuminance(normalizeToHex(raw)!);
+
+describe("resolveAccentTintedSurface", () => {
+  it("takes the ramp's pale surface end in a light scheme", () => {
+    const tint = resolveAccentTintedSurface({
+      steps: lightAccent,
+      paper: lightPaper,
+      ink: lightInk,
+    });
+    expect(tint).toBe(lightAccent[10]);
+  });
+
+  it("takes the ramp's deep surface end in a dark scheme", () => {
+    const tint = resolveAccentTintedSurface({ steps: darkAccent, paper: darkPaper, ink: darkInk });
+    expect(tint).toBe(darkAccent[0]);
+  });
+
+  // The bug this rule replaced: keying the pick off a SURFACE token let a tint
+  // sub-theme (which re-ramps surfaces) slide the chip a step per tint. Scheme
+  // polarity comes from the paper/ink anchors, which a tint leaves alone.
+  it("does not drift when surrounding surfaces are re-ramped by a tint", () => {
+    const untinted = resolveAccentTintedSurface({
+      steps: lightAccent,
+      paper: lightPaper,
+      ink: lightInk,
+    });
+    for (const tintedPaper of ["#fffce8", "#fff8f8", "#f2fbf5"]) {
+      expect(
+        resolveAccentTintedSurface({ steps: lightAccent, paper: tintedPaper, ink: lightInk }),
+      ).toBe(untinted);
+    }
+  });
+
+  it("stays a SURFACE tier — never the solid an accent CTA takes", () => {
+    // The solid is accentBackground (= the ramp's mid, palette-shape solid).
+    const lightSolid = lightAccent[2];
+    const darkSolid = darkAccent[9];
+    expect(
+      resolveAccentTintedSurface({ steps: lightAccent, paper: lightPaper, ink: lightInk }),
+    ).not.toBe(lightSolid);
+    expect(
+      resolveAccentTintedSurface({ steps: darkAccent, paper: darkPaper, ink: darkInk }),
+    ).not.toBe(darkSolid);
+  });
+
+  it("keeps a luminance-picked label readable on the tint in both schemes", () => {
+    const cases = [
+      { steps: lightAccent, paper: lightPaper, ink: lightInk },
+      { steps: darkAccent, paper: darkPaper, ink: darkInk },
+    ];
+    for (const c of cases) {
+      const tint = resolveAccentTintedSurface(c)!;
+      const best = Math.max(
+        contrastRatio(lum(tint), lum(c.paper)),
+        contrastRatio(lum(tint), lum(c.ink)),
+      );
+      expect(best).toBeGreaterThanOrEqual(4.5);
+    }
+  });
+
+  it("returns undefined when the accent ramp or an anchor is missing", () => {
+    expect(
+      resolveAccentTintedSurface({ steps: [], paper: lightPaper, ink: lightInk }),
+    ).toBeUndefined();
+    expect(
+      resolveAccentTintedSurface({ steps: lightAccent, paper: undefined, ink: lightInk }),
+    ).toBeUndefined();
+    expect(
+      resolveAccentTintedSurface({
+        steps: Array.from({ length: 12 }, () => "var(--nope)"),
+        paper: lightPaper,
+        ink: lightInk,
+      }),
+    ).toBeUndefined();
+  });
+});

package/src/theme/readableColor.ts

@@ -102,41 +102,62 @@ export function useAccentOnSurface(): string {
 }
 
 /**
- * Accent-TINTED surface step — the accent-ramp analogue of a neutral surface
- * tier, for selected/current chips that carry the accent language at surface
- * strength rather than as a solid fill (LC-05: selected state is accent; the
- * ViewSwitcher rider pins segmented-control strength at "tinted", not solid).
+ * Accent SURFACE tier of the accent ramp, mirrored by scheme — the fill for a
+ * selected/current chip that must carry the accent language at SURFACE
+ * strength rather than as a solid (LC-05: selection is accent; the ViewSwitcher
+ * rider pins segmented-control strength at "tinted", not the solid an accent
+ * CTA takes).
  *
- * Picks the accent step whose relative luminance sits closest to the neutral
- * tier it replaces, so the chip stays a surface in BOTH schemes without a
- * per-component light/dark fork: against this repo's stock accent ramp that
- * resolves to a pale violet in light and a deep violet in dark, because the
- * accent ramp flips with the scheme exactly as the neutral ramp does.
+ * The step is a declared ramp POSITION, the same way the neutral ramp declares
+ * its tiers (surface `$color2`, UI background `$color3`-`$color5`, text
+ * `$color11`-`$color12`): the accent ramp's surface end is its palest step in a
+ * light scheme and its deepest in a dark one, so the chip reads as a tinted
+ * surface on either page. Scheme polarity comes from the paper/ink ANCHORS,
+ * never from a surface token — a tint re-ramps surfaces, and keying off one
+ * made this pick drift a step per tint (measured: the chip slid from the pale
+ * accent to the palest accent under a yellow tint).
  *
- * Returns `undefined` when the accent ramp is absent or unparseable — callers
- * keep their neutral default rather than render an unthemed chip.
+ * Returns `undefined` when the accent ramp is absent or unparseable (tint
+ * sub-themes without an accent ramp) — callers keep their neutral default
+ * rather than render an unthemed chip.
  */
-export function useAccentTintedSurface(neutralToken = "$color4"): string | undefined {
+// Ramp positions (1-based) of the accent surface tier per scheme.
+const ACCENT_SURFACE_STEP_LIGHT = 11;
+const ACCENT_SURFACE_STEP_DARK = 1;
+
+export interface ResolveAccentTintedSurfaceInput {
+  /** Accent ramp steps 1..12, as raw color values; holes allowed. */
+  steps: (string | undefined)[];
+  /** Scheme paper anchor (`$color1`). */
+  paper?: string;
+  /** Scheme ink anchor (`$color12`). */
+  ink?: string;
+}
+
+/** Pure resolver behind {@link useAccentTintedSurface} — see its docs. */
+export function resolveAccentTintedSurface({
+  steps,
+  paper,
+  ink,
+}: ResolveAccentTintedSurfaceInput): string | undefined {
+  const paperHex = paper ? normalizeToHex(paper) : null;
+  const inkHex = ink ? normalizeToHex(ink) : null;
+  if (!paperHex || !inkHex) return undefined;
+  const isLight = relativeLuminance(paperHex) > relativeLuminance(inkHex);
+  const step = steps[(isLight ? ACCENT_SURFACE_STEP_LIGHT : ACCENT_SURFACE_STEP_DARK) - 1];
+  if (!step || !normalizeToHex(step)) return undefined;
+  return step;
+}
+
+export function useAccentTintedSurface(): string | undefined {
   const theme = useTamaguiTheme() as unknown as Record<string, { val?: unknown } | undefined>;
-  const neutral = resolveTokenValue(theme, neutralToken);
+  const paper = resolveTokenValue(theme, "color1");
+  const ink = resolveTokenValue(theme, "color12");
   const steps: (string | undefined)[] = [];
   for (let i = 1; i <= 12; i++) steps.push(resolveTokenValue(theme, `accent${i}`));
   // eslint-disable-next-line react-hooks/exhaustive-deps
-  return useMemo(() => {
-    const neutralHex = neutral ? normalizeToHex(neutral) : null;
-    if (!neutralHex) return undefined;
-    const target = relativeLuminance(neutralHex);
-    let best: string | undefined;
-    let bestDelta = Number.POSITIVE_INFINITY;
-    for (const step of steps) {
-      const hex = step ? normalizeToHex(step) : null;
-      if (!step || !hex) continue;
-      const delta = Math.abs(relativeLuminance(hex) - target);
-      if (delta < bestDelta) {
-        bestDelta = delta;
-        best = step;
-      }
-    }
-    return best;
-  }, [neutral, steps.join("|")]);
+  return useMemo(
+    () => resolveAccentTintedSurface({ steps, paper, ink }),
+    [paper, ink, steps.join("|")],
+  );
 }

package/src/theme/resolveKnobs.spec.ts

@@ -18,8 +18,13 @@ import {
 import type { Knobs } from "./knobs";
 import type { KnobProps } from "./recipes";
 import { cornerSmoothClassName } from "./cornerSmoothing";
-import { defaultPreset, boldPreset } from "./presets";
-import { applyDensity, capContainerRadius, resolveKnobs } from "./resolveKnobs";
+import { defaultPreset, boldPreset, heroPreset } from "./presets";
+import {
+  applyDensity,
+  capContainerRadius,
+  resolveKnobs,
+  resolvePageTitleScale,
+} from "./resolveKnobs";
 import {
   normalizeToHex,
   relativeLuminance,
@@ -47,6 +52,7 @@ const expectedKnobPropKeys: (keyof KnobProps)[] = [
   "gapLg",
   "sizeToken",
   "heading",
+  "pageTitle",
   "body",
   "textWeight",
   "transition",
@@ -731,6 +737,44 @@ describe("resolveKnobs", () => {
     });
   });
 
+  // ── pageTitleScale (D-11 hero-H1 dial) ──────────────────────
+
+  describe("pageTitleScale knob", () => {
+    it("defaults to the moderate page-title step ($8 = 32px)", () => {
+      expect(resolveKnobs(defaultKnobs).knobProps.pageTitle).toEqual({ size: "$8" });
+    });
+
+    it('"display" re-opens the hero step ($10 = 64px)', () => {
+      expect(resolveKnobs(knobsWith({ pageTitleScale: "display" })).knobProps.pageTitle).toEqual({
+        size: "$10",
+      });
+    });
+
+    it("an omitted knob still resolves moderate (preset constructions predate the dial)", () => {
+      const { pageTitleScale: _omitted, ...withoutDial } = defaultKnobs;
+      expect(resolveKnobs(withoutDial as Knobs).knobProps.pageTitle).toEqual({ size: "$8" });
+    });
+
+    it("resolvePageTitleScale is the one table both channels read", () => {
+      expect(resolvePageTitleScale("moderate")).toEqual({ size: "$8" });
+      expect(resolvePageTitleScale("display")).toEqual({ size: "$10" });
+    });
+
+    it("product presets ship moderate; `hero` is the only display opt-in", () => {
+      expect(defaultPreset.knobs.pageTitleScale).toBe("moderate");
+      expect(boldPreset.knobs.pageTitleScale).toBe("moderate");
+      expect(heroPreset.knobs.pageTitleScale).toBe("display");
+      expect(resolveKnobs(heroPreset.knobs).knobProps.pageTitle).toEqual({ size: "$10" });
+    });
+
+    it("`hero` differs from the default preset in nothing but the title step", () => {
+      const { pageTitleScale: _hero, ...heroRest } = heroPreset.knobs;
+      const { pageTitleScale: _default, ...defaultRest } = defaultPreset.knobs;
+      expect(heroRest).toEqual(defaultRest);
+      expect(heroPreset.theme).toBe(defaultPreset.theme);
+    });
+  });
+
   // ── animation ─────────────────────────────────────────────
 
   describe("animation knob", () => {

package/types/dates.d.ts

@@ -38,6 +38,24 @@ export interface AbsoluteDateFormatOptions {
 }
 /** ISO date-only shape ("YYYY-MM-DD"). */
 export declare const ISO_DATE_ONLY: RegExp;
+/**
+ * Parse a date value onto the LOCAL calendar day it names — the canonical
+ * parse for anything that will be positioned on a day grid (calendar cells,
+ * Gantt bars, date axes) rather than merely formatted.
+ *
+ * A date-only string ("YYYY-MM-DD") is a calendar date carrying no timezone,
+ * which is how Frappe sends `Date` fields. ECMA-262 parses that form as UTC
+ * midnight, so every zone west of UTC reads it as the *previous* local day,
+ * and no zone but UTC lands it on the local midnight that day-grid math tests
+ * for. Those are built from local parts instead.
+ *
+ * Values that carry a time ("YYYY-MM-DD HH:MM:SS", ISO with an offset, epoch
+ * millis) are genuine instants and keep the timezone-aware parse untouched.
+ *
+ * Returns null for empty and unparseable input, and for out-of-range parts
+ * ("2026-13-45") rather than silently rolling them into the next month.
+ */
+export declare function parseCalendarDate(value: DateInput): Date | null;
 /**
  * Compact absolute date — the house register for every absolute date.
  * "Jul 1" / "Jul 1, 2025" (year auto-elided when current), or with

package/types/dates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../src/dates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAElE,MAAM,WAAW,yBAAyB;IACxC;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,0CAA0C;AAC1C,eAAO,MAAM,aAAa,QAAwB,CAAC;AAyBnD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,yBAA8B,GACtC,MAAM,CA0BR;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,UAAU,CAAM,GACxD,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAgB1F;AAED,iFAAiF;AACjF,eAAO,MAAM,UAAU,QAAqC,CAAC;AAE7D,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAuB9F;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAa1F;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAW9F;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAU5F;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,EAAE,CAO3E;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAC3B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAO,GAC1D,MAAM,EAAE,CAIV"}
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../src/dates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAElE,MAAM,WAAW,yBAAyB;IACxC;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,0CAA0C;AAC1C,eAAO,MAAM,aAAa,QAAwB,CAAC;AAyBnD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAkB/D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,yBAA8B,GACtC,MAAM,CA0BR;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,UAAU,CAAM,GACxD,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAgB1F;AAED,iFAAiF;AACjF,eAAO,MAAM,UAAU,QAAqC,CAAC;AAE7D,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAuB9F;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAa1F;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAW9F;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAU5F;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,EAAE,CAO3E;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAC3B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAO,GAC1D,MAAM,EAAE,CAIV"}

package/types/devWarn.d.ts

@@ -16,6 +16,41 @@ export type DevWarnDetail = {
     region?: string;
     [key: string]: unknown;
 };
+/**
+ * LC-57 GUARDRAIL-CLEAN-STORIES allowlist entry, declared as a Storybook story
+ * parameter (`parameters.guardrailSpecimen`).
+ *
+ * Catalog stories emit zero `[theme]` guardrail warnings at rest. A story whose
+ * whole purpose is to demonstrate the warned state (a disabled-dial specimen, a
+ * pager boundary case) is allowlisted by declaring itself:
+ *
+ * ```ts
+ * export const Disabled: Story = {
+ *   parameters: {
+ *     guardrailSpecimen: {
+ *       warns: ["bare-disabled"],
+ *       reason: "Demonstrates the disabled dial; Stepper has no disabledReason plumbing.",
+ *     } satisfies GuardrailSpecimenParameter,
+ *   },
+ * };
+ * ```
+ *
+ * Semantics, pinned:
+ * - `warns` is the CLOSED set of codes the story may emit at rest. An emitted
+ *   code outside the set still FAILs the story.
+ * - A declared code that happens not to fire passes — component improvements
+ *   must never break an allowlist entry.
+ * - The declaration NEVER suppresses the console warning — the warn still
+ *   fires; only the warn-harvester tolerates it (explicit, never tacit).
+ * - Harvesters (`p-results/story-hygiene/verify.mjs`) read this parameter off
+ *   the rendered story and fail CLOSED when parameters cannot be read at all.
+ */
+export type GuardrailSpecimenParameter = {
+    /** Warn codes this story may emit at rest — a closed set, not a wildcard. */
+    warns: DevWarnCode[];
+    /** Why the warned state is the story's subject (recorded per LC-57). */
+    reason: string;
+};
 /**
  * Emit a once-per-key console warning in non-production builds.
  */

package/types/devWarn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"devWarn.d.ts","sourceRoot":"","sources":["../src/devWarn.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"devWarn.d.ts","sourceRoot":"","sources":["../src/devWarn.ts"],"names":[],"mappings":"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"}

package/types/numbers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../src/numbers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sDAAsD;IACtD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CACpC;AAED,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAYvD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIlF;AAiCD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAQ1F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAyB9F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAK5F"}
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../src/numbers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sDAAsD;IACtD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CACpC;AAED,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAcvD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIlF;AAyCD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAQ1F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM,CA8B9F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAK5F"}

package/types/theme/colorRules.d.ts

@@ -55,7 +55,7 @@ export interface ButtonColorConfig extends ComponentColorConfig {
 }
 export declare const buttonColors: ButtonColorConfig;
 export declare const inputColors: ComponentColorConfig;
-export declare function $color(step: ColorStep): "$color1" | "$color12" | "$color2" | "$color7" | "$color4" | "$color5" | "$color11" | "$color3" | "$color6" | "$color8" | "$color9" | "$color10";
+export declare function $color(step: ColorStep): "$color3" | "$color1" | "$color2" | "$color12" | "$color7" | "$color4" | "$color5" | "$color11" | "$color6" | "$color8" | "$color9" | "$color10";
 export interface SemanticGroup {
     key: string;
     label: string;

package/types/theme/cookies.d.ts

@@ -26,13 +26,27 @@ export declare function splitCookieValue(value: string): string[];
 export declare function joinSplitCookieValues(chunks: string[]): string;
 /**
  * Read the overrides cookie value, handling chunked cookies.
- * Accepts the cookies object from `useCookies()`.
+ *
+ * Accepts BOTH value shapes a cookie jar can deliver:
+ *   - already-parsed OBJECTS — react-cookie's `useCookies()` jar
+ *     (universal-cookie) auto-JSON-parses every cookie value it can (its
+ *     `readCookie` tries `JSON.parse` unless `doNotParse` is set), so a
+ *     single-chunk overrides cookie arrives here as an object, not a string;
+ *   - raw JSON STRINGS — direct `document.cookie` / SSR cookie-header reads
+ *     (`loadPresetOverrides`), and multi-chunk payloads on every path (a
+ *     fragment of a split JSON document does not parse on its own, so even
+ *     universal-cookie leaves those chunks as strings).
+ *
+ * Anything else (numbers, arrays, mixed chunk types, malformed JSON) reads
+ * as no overrides, and every parsed payload is shape-validated before use.
  */
-export declare function readOverridesCookie(cookies: Record<string, string | undefined>): Partial<Knobs>;
+export declare function readOverridesCookie(cookies: Record<string, unknown>): Partial<Knobs>;
 /**
- * Read the preset name from the cookie.
+ * Read the preset name from the cookie. universal-cookie auto-JSON-parses
+ * jar values, so a numeric-looking name would arrive as a number — preset
+ * names are strings by contract, anything else reads as no preset.
  */
-export declare function readPresetCookie(cookies: Record<string, string | undefined>): string | undefined;
+export declare function readPresetCookie(cookies: Record<string, unknown>): string | undefined;
 /**
  * Write the preset name cookie.
  * Returns the cookie key and value for the caller to pass to setCookie.

package/types/theme/cookies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/theme/cookies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMrC,6CAA6C;AAC7C,eAAO,MAAM,YAAY,cAAc,CAAC;AAExC,sDAAsD;AACtD,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAY7C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CASxD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAE9D;AAeD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAiB/F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAEhG;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG;IAC/D,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAgBA;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAQ5E;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAM7C;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAQtE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAC9C,OAAO,CAAC,KAAK,CAAC,CAGhB"}
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/theme/cookies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMrC,6CAA6C;AAC7C,eAAO,MAAM,YAAY,cAAc,CAAC;AAExC,sDAAsD;AACtD,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAY7C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CASxD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAE9D;AAyCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAwBpF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAGrF;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG;IAC/D,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAgBA;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAQ5E;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAM7C;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAQtE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAC9C,OAAO,CAAC,KAAK,CAAC,CAGhB"}

package/types/theme/defaults/fonts.d.ts

@@ -2,6 +2,6 @@
 export declare function interTrackingEm(sizePx: number): number;
 /** Inter dynamic tracking for a rendered `sizePx`, in px (2-decimal). */
 export declare function interTrackingPx(sizePx: number): number;
-export declare const defaultHeadingFont: import("@tamagui/web").FillInFont<import("tamagui").GenericFont, 1 | 12 | 2 | 7 | 4 | 5 | 11 | 13 | 14 | 15 | 16 | 3 | 6 | 8 | 9 | 10 | "true">;
-export declare const defaultBodyFont: import("@tamagui/web").FillInFont<import("tamagui").GenericFont, 1 | 12 | 2 | 7 | 4 | 5 | 11 | 13 | 14 | 15 | 16 | 3 | 6 | 8 | 9 | 10 | "true">;
+export declare const defaultHeadingFont: import("@tamagui/web").FillInFont<import("tamagui").GenericFont, 3 | 1 | 2 | 12 | 7 | 4 | 5 | 11 | 13 | 14 | 15 | 16 | 6 | 8 | 9 | 10 | "true">;
+export declare const defaultBodyFont: import("@tamagui/web").FillInFont<import("tamagui").GenericFont, 3 | 1 | 2 | 12 | 7 | 4 | 5 | 11 | 13 | 14 | 15 | 16 | 6 | 8 | 9 | 10 | "true">;
 //# sourceMappingURL=fonts.d.ts.map

package/types/theme/index.d.ts

@@ -18,6 +18,7 @@ export * from "./Preset";
 export type { Preset as PresetDefinition, IntentOverride } from "./preset.types";
 export * from "./PresetContext";
 export * from "./presets";
+export * from "./radiusClass";
 export * from "./readableColor";
 export * from "./recipes";
 export * from "./resolveKnobs";

package/types/theme/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,YAAY,EAAE,MAAM,IAAI,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACjF,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AAEzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,YAAY,EAAE,MAAM,IAAI,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACjF,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AAEzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}

package/types/theme/radiusClass.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Radius-class declarations (D-09 / LC-60).
+ *
+ * Most parts prove they obey the radius knob by simply going square at
+ * `borderRadius:none`. A few legitimately do not — an ornamental dot has no
+ * arc for the knob to move (R-PILL), and an avatar's circle is the object's
+ * identity rather than a style (R-IDENTITY). Those parts must SAY SO on the
+ * node, because the alternative — a probe that skips anything that looks
+ * round — silently exempts real KNOB-TOTALITY defects (LC-18).
+ *
+ * The declaration is only half the contract: the `radius:none` sweep
+ * validates it against the registry GENERATED from the spec's radius-class
+ * table (`scripts/radius-identity-registry.mjs`), so a class this file cannot
+ * spell, or an R-IDENTITY part the spec never adjudicated, still fails. This
+ * module is the writing end; `docs/theme-propagation-spec.md` is the registry.
+ */
+/**
+ * The radius classes whose parts stay round at `borderRadius:none`.
+ *
+ * - `R-PILL` — a pill/circle at every radius value (ornamental dots, badge
+ *   indicators, icon wells). Size still tracks the size knob.
+ * - `R-IDENTITY` — the shape IS the part's identity (Avatar, brand marks).
+ *   Membership is enumerated in the spec table and enforced per part.
+ */
+export type KnobImmuneRadiusClass = "R-PILL" | "R-IDENTITY";
+export interface RadiusClassDeclaration {
+    "data-radius-class": KnobImmuneRadiusClass;
+    "data-radius-part": string;
+}
+/**
+ * Declare a knob-immune shape so the `radius:none` sweep can license it.
+ *
+ * Spread onto the outermost node of the shape — a declaration covers its own
+ * anatomy, so inner painted parts (an avatar's image/fallback) inherit it.
+ *
+ * @param radiusClass the class the spec's Radius table assigns the part
+ * @param part the part name as the spec writes it (the R-IDENTITY registry
+ *   is matched by this name)
+ *
+ * @example
+ * <Frame {...radiusClassProps("R-IDENTITY", "Avatar")} circular />
+ */
+export declare function radiusClassProps(radiusClass: KnobImmuneRadiusClass, part: string): RadiusClassDeclaration;
+//# sourceMappingURL=radiusClass.d.ts.map

package/types/theme/radiusClass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radiusClass.d.ts","sourceRoot":"","sources":["../../src/theme/radiusClass.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE5D,MAAM,WAAW,sBAAsB;IACrC,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,qBAAqB,EAClC,IAAI,EAAE,MAAM,GACX,sBAAsB,CAExB"}

package/types/theme/readableColor.d.ts

@@ -15,20 +15,15 @@ export declare function useReadableTextOn(fill_: string | undefined): string | u
  * tint sub-themes, where neutral text is the house default anyway).
  */
 export declare function useAccentOnSurface(): string;
-/**
- * Accent-TINTED surface step — the accent-ramp analogue of a neutral surface
- * tier, for selected/current chips that carry the accent language at surface
- * strength rather than as a solid fill (LC-05: selected state is accent; the
- * ViewSwitcher rider pins segmented-control strength at "tinted", not solid).
- *
- * Picks the accent step whose relative luminance sits closest to the neutral
- * tier it replaces, so the chip stays a surface in BOTH schemes without a
- * per-component light/dark fork: against this repo's stock accent ramp that
- * resolves to a pale violet in light and a deep violet in dark, because the
- * accent ramp flips with the scheme exactly as the neutral ramp does.
- *
- * Returns `undefined` when the accent ramp is absent or unparseable — callers
- * keep their neutral default rather than render an unthemed chip.
- */
-export declare function useAccentTintedSurface(neutralToken?: string): string | undefined;
+export interface ResolveAccentTintedSurfaceInput {
+    /** Accent ramp steps 1..12, as raw color values; holes allowed. */
+    steps: (string | undefined)[];
+    /** Scheme paper anchor (`$color1`). */
+    paper?: string;
+    /** Scheme ink anchor (`$color12`). */
+    ink?: string;
+}
+/** Pure resolver behind {@link useAccentTintedSurface} — see its docs. */
+export declare function resolveAccentTintedSurface({ steps, paper, ink, }: ResolveAccentTintedSurfaceInput): string | undefined;
+export declare function useAccentTintedSurface(): string | undefined;
 //# sourceMappingURL=readableColor.d.ts.map

package/types/theme/readableColor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readableColor.d.ts","sourceRoot":"","sources":["../../src/theme/readableColor.ts"],"names":[],"mappings":"AA4CA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAU/E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CA8B3C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,SAAY,GAAG,MAAM,GAAG,SAAS,CAuBnF"}
+{"version":3,"file":"readableColor.d.ts","sourceRoot":"","sources":["../../src/theme/readableColor.ts"],"names":[],"mappings":"AA4CA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAU/E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CA8B3C;AA0BD,MAAM,WAAW,+BAA+B;IAC9C,mEAAmE;IACnE,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAC9B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,EACzC,KAAK,EACL,KAAK,EACL,GAAG,GACJ,EAAE,+BAA+B,GAAG,MAAM,GAAG,SAAS,CAQtD;AAED,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAW3D"}