@eifi1/ui-kit 0.54.0 → 0.56.0

package/src/sync/hooks.ts

@@ -1,98 +0,0 @@
-import { useCallback, useEffect, useState, useSyncExternalStore } from "react";
-import { liveQuery } from "dexie";
-import type { SyncStatus } from "../shell/sync-status-indicator";
-import type { SyncDb } from "./db";
-import type { SyncEngine, SyncEngineState } from "./engine";
-
-/**
- * Keep `engine` running while it is mounted: started on mount, stopped on unmount or when
- * the engine changes (a company switch builds a new engine on its own database, D15).
- * `null` runs nothing — signed out, or a computer marked shared. Mount once, in the
- * signed-in layout (kastlan's `useHandoverSyncLoop`).
- */
-export function useSyncWorker(engine: SyncEngine | null): void {
-  useEffect(() => {
-    if (!engine) return;
-    engine.start();
-    return () => engine.stop();
-  }, [engine]);
-}
-
-const IDLE: SyncEngineState = {
-  phase: "idle",
-  online: true,
-  counts: { pending: 0, waiting: 0, blocked: 0, rejected: 0 },
-  lastSyncedAt: null,
-  nextRetryAt: null,
-};
-const noEngine = () => () => undefined;
-const idle = () => IDLE;
-
-/**
- * The engine's state as the kit's `SyncStatusIndicator` reads it (§2.3): `pending` = queued
- * and in flight (and the steps' pending), `waitingForPlan` = `waiting`, `blocked` = `blocked`
- * + `rejected`, `lastSyncedAt` from `meta`. `onSync` is "Sync now". Without an engine, an
- * idle status that follows the browser's connection.
- *
- * With a `null` engine (signed out, or a computer marked shared) `status.online` follows
- * `navigator.onLine` and its `online`/`offline` events, so an app may lean on
- * `status.online` for its own offline lock (kastlan's offline write lock) whether or not an
- * engine runs.
- */
-export function useSyncStatus(engine: SyncEngine | null): { status: SyncStatus; onSync: () => Promise<void> } {
-  const state = useSyncExternalStore(
-    engine ? engine.subscribe : noEngine,
-    engine ? engine.getState : idle,
-    engine ? engine.getState : idle,
-  );
-  const browserOnline = useSyncExternalStore(subscribeOnline, readOnline, () => true);
-  const onSync = useCallback(async () => {
-    await engine?.syncNow();
-  }, [engine]);
-  const status: SyncStatus = {
-    phase: state.phase,
-    online: engine ? state.online : browserOnline,
-    pending: state.counts.pending,
-    waitingForPlan: state.counts.waiting,
-    blocked: state.counts.blocked + state.counts.rejected,
-    lastSyncedAt: state.lastSyncedAt,
-  };
-  return { status, onSync };
-}
-
-function subscribeOnline(listener: () => void) {
-  window.addEventListener("online", listener);
-  window.addEventListener("offline", listener);
-  return () => {
-    window.removeEventListener("online", listener);
-    window.removeEventListener("offline", listener);
-  };
-}
-const readOnline = () => navigator.onLine !== false;
-
-/**
- * A read of the copy that follows every change to it (Dexie's `liveQuery`; kastlan's
- * `useLive`). `deps` names what `query` reads; `query` itself is rebuilt every render.
- * `query` gets the app's own database type (`HandoverDb`). Without a database (not open
- * yet) it answers `isLoading: true`, so a page shows no "empty" before the copy opens.
- */
-export function useSyncQuery<T, D extends SyncDb = SyncDb>(
-  db: D | null,
-  query: (db: D) => Promise<T>,
-  deps: readonly unknown[],
-): { data: T | undefined; isLoading: boolean } {
-  const [state, setState] = useState<{ data: T | undefined; isLoading: boolean }>({ data: undefined, isLoading: true });
-  useEffect(() => {
-    if (!db) return;
-    const subscription = liveQuery(() => query(db)).subscribe({
-      next: (data) => setState({ data, isLoading: false }),
-      error: () => setState({ data: undefined, isLoading: false }),
-    });
-    return () => subscription.unsubscribe();
-    // `query` is rebuilt every render; `deps` names what it reads.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [db, ...deps]);
-  return db ? state : NO_COPY;
-}
-
-const NO_COPY = { data: undefined, isLoading: true } as const;

package/src/sync/testing.ts

@@ -1,73 +0,0 @@
-import type { SyncRequestBody, SyncResponseBody } from "./wire";
-
-/*
- * `@eifi1/ui-kit/sync/testing` — a scripted `/sync` server for an app's tests of the engine
- * (docs/local-first-harmonization.md §2.3). Pass `transport.send` as the engine's `send`.
- * Imports nothing (no Dexie): it is the engine's `send`, not a store.
- */
-
-/** One scripted answer: a body, a function of the request, or a failure. */
-export type FakeSyncAnswer =
-  | SyncResponseBody
-  | ((body: SyncRequestBody) => SyncResponseBody | Promise<SyncResponseBody>)
-  | { fail: "offline" }
-  | { fail: number; data?: unknown };
-
-export interface FakeSyncTransport {
-  /** The engine's `send`. */
-  send(body: SyncRequestBody, signal?: AbortSignal): Promise<SyncResponseBody>;
-  /** Every request received, in order (the body as sent). */
-  readonly requests: SyncRequestBody[];
-  /** Queue answers for the next requests, in order; past them the default answers. */
-  answer(...answers: FakeSyncAnswer[]): void;
-  /** The next request meets no connection (an axios-like error with no response). */
-  failOffline(): void;
-  /** The next request answers `status` (a 5xx, a 402 `{code}`, a 403). */
-  failStatus(status: number, data?: unknown): void;
-  /** The default answer's server knowledge, raised by one for every request. */
-  knowledge: number;
-}
-
-/** The error an axios client throws: `isAxiosError`, and `response` only with an answer. */
-function wireError(fail: "offline" | number, data?: unknown): Error {
-  const err = new Error(fail === "offline" ? "Network Error" : `Request failed with status code ${fail}`);
-  return Object.assign(err, {
-    isAxiosError: true,
-    response: fail === "offline" ? undefined : { status: fail, data: data ?? {} },
-  });
-}
-
-/**
- * The default answer echoes every pushed change as applied, with a server id (`pk`, 100 on),
- * and an empty pull besides; `knowledge` goes up by one each request. Script anything else
- * with `answer(...)`, `failOffline()` and `failStatus(...)`.
- */
-export function createFakeSyncTransport(): FakeSyncTransport {
-  const script: FakeSyncAnswer[] = [];
-  let nextPk = 100;
-  const transport: FakeSyncTransport = {
-    requests: [],
-    knowledge: 0,
-    answer: (...answers) => void script.push(...answers),
-    failOffline: () => void script.push({ fail: "offline" }),
-    failStatus: (status, data) => void script.push({ fail: status, data }),
-    async send(body) {
-      transport.requests.push(structuredClone(body));
-      const next = script.shift();
-      if (next && typeof next === "object" && "fail" in next) {
-        throw wireError(next.fail, "data" in next ? next.data : undefined);
-      }
-      if (typeof next === "function") return next(body);
-      if (next) return next;
-      transport.knowledge += 1;
-      return {
-        server_knowledge: transport.knowledge,
-        changes: body.changes.map((change) => ({ ...change, pk: change.op === "delete" ? null : nextPk++ })),
-        rejections: [],
-        refused: null,
-        page_cursor: null,
-      };
-    },
-  };
-  return transport;
-}

package/src/sync/wire.ts

@@ -1,61 +0,0 @@
-/*
- * The `/sync` wire as the engine speaks it: server-kit's `eifi1_server_kit.sync` shapes
- * (SyncRequest, SyncResponse, SyncRefusal, SyncRejection, SyncPageCursor; keksdose's, which
- * are canon, D10), plus kastlan's `pk` on a pulled change. Types only.
- */
-
-/** One row's delta on the wire. */
-export interface SyncWireChange {
-  entity: string;
-  id: string;
-  op: "upsert" | "delete";
-  data?: Record<string, unknown> | null;
-  /** The device's edit time on a push (D2). */
-  updated_at?: string | null;
-  /** The server's id of the row, on a pull (kastlan). */
-  pk?: number | null;
-  knowledge?: number | null;
-}
-
-/** Where a paged pull stopped (server-kit `SyncPageCursor`); handed back as it came. */
-export interface SyncPageCursor {
-  entity: string;
-  knowledge?: number | null;
-  id?: string | null;
-  window_end: number;
-}
-
-export interface SyncRequestBody {
-  scope: string;
-  last_knowledge: number;
-  changes: SyncWireChange[];
-  /** This client keeps refused changes and reads `refused` and `rejections` (D1). */
-  refusals: true;
-  /** The device's clock as the body is built, fresh for every request (D2 amendment). */
-  client_now: string;
-  paged?: boolean;
-  page_cursor?: SyncPageCursor | null;
-}
-
-/** The WHOLE push refused (a lapsed plan): the pull is served all the same. */
-export interface SyncRefusalBody {
-  code: string;
-  detail: string;
-  change_ids: string[];
-}
-
-/** One pushed change the server did not apply, with its reason. */
-export interface SyncRejectionBody {
-  change_id: string;
-  code: string;
-  detail: string;
-}
-
-export interface SyncResponseBody {
-  server_knowledge: number;
-  changes: SyncWireChange[];
-  refused?: SyncRefusalBody | null;
-  rejections?: SyncRejectionBody[];
-  /** Set while the pull did not fit one page; `null` on the last page (D12). */
-  page_cursor?: SyncPageCursor | null;
-}

package/src/sync.ts

@@ -1,37 +0,0 @@
-// `@eifi1/ui-kit/sync` — local-first phase 3 (docs/local-first-harmonization.md §2.3, 0.46):
-// the sync engine on a Dexie copy, its worker and status hooks, and the live read of the copy.
-//
-// The only entry point that imports `dexie` — an optional peer for that reason. It never loads
-// `/offline`'s TanStack and idb-keyval peers: the leaf utilities both entries export live in
-// one module of their own (src/offline/local-first.ts). NOT re-exported from the main barrel.
-export { createSyncDb, rowByPk, SYNC_DB_PK_INDEX } from "./sync/db";
-export type {
-  CreateSyncDbOptions,
-  OutboxChange,
-  OutboxStatus,
-  SyncDb,
-  SyncDbUpgrade,
-  SyncedRow,
-  SyncMetaEntry,
-} from "./sync/db";
-export { createSyncEngine, DEFAULT_HOLD_CODES, releaseSyncEngine, syncEngineFor } from "./sync/engine";
-export type {
-  SyncCounts,
-  SyncEngine,
-  SyncEngineOptions,
-  SyncEngineState,
-  SyncRoundResult,
-  SyncStep,
-  SyncStepContext,
-  SyncStepResult,
-} from "./sync/engine";
-export { useSyncQuery, useSyncStatus, useSyncWorker } from "./sync/hooks";
-export type {
-  SyncPageCursor,
-  SyncRefusalBody,
-  SyncRejectionBody,
-  SyncRequestBody,
-  SyncResponseBody,
-  SyncWireChange,
-} from "./sync/wire";
-export { isOfflineError, readLocalFirst, stampAfter, uuid5, writeLocalFirst } from "./offline/local-first";

package/src/table-text.ts

@@ -1,8 +0,0 @@
-// `@eifi1/ui-kit/table-text` — the lexer for a table pasted out of a spreadsheet or read
-// from a CSV, and the three named rules for the comma. See the note at the top of
-// lib/table-text.ts.
-//
-// Pure functions over strings: no React, no DOM, nothing to install. It is its own
-// entry so an app that imports a CSV on a server, in a worker or in a script can take
-// it without reaching through a barrel of components.
-export * from "./lib/table-text";

package/src/testing/css-variables.generated.ts

@@ -1,112 +0,0 @@
-// GENERATED by scripts/gen-kit-css-variables.mjs — do not edit by hand. Re-run it after
-// changing tokens.css or upgrading Tailwind; src/__tests__/token-vars-declared.test.ts
-// fails while this is stale.
-
-/** Every custom property tokens.css declares, `@theme inline` names and `--app-nav-h`
- *  left out (102 names). */
-export const KIT_NAMES =
-  "--bg-active --bg-hover --bg-inverse --bg-page --bg-surface --bg-surface-2 --border " +
-  "--border-strong --brand --brand-bg --brand-bg-hover --brand-contrast --brand-hover --brand-muted " +
-  "--breakpoint-3xl --chart-1 --chart-2 --chart-3 --chart-4 --chart-5 --chart-6 --chart-7 --chart-8 " +
-  "--chart-9 --chart-ink --chart-muted --danger --danger-bg --danger-border --danger-border-strong " +
-  "--danger-contrast --danger-hover --flyout-from --focus-ring-width --hue-blue --hue-blue-bg " +
-  "--hue-blue-border --hue-blue-contrast --hue-indigo --hue-indigo-bg --hue-indigo-border " +
-  "--hue-indigo-contrast --hue-orange --hue-orange-bg --hue-orange-border --hue-orange-contrast " +
-  "--hue-purple --hue-purple-bg --hue-purple-border --hue-purple-contrast --hue-teal --hue-teal-bg " +
-  "--hue-teal-border --hue-teal-contrast --info --info-bg --info-border --info-contrast --media-ink " +
-  "--media-scrim --media-scrim-hover --money-expense --money-expense-contrast --money-income " +
-  "--money-income-contrast --money-net --money-net-contrast --money-neutral " +
-  "--money-neutral-contrast --neutral --neutral-contrast --status-edited --status-error " +
-  "--status-pending --status-synced --success --success-bg --success-border --success-contrast " +
-  "--text-caption --text-inverse --text-micro --text-muted --text-placeholder --text-primary " +
-  "--text-secondary --toast-action-bg --toast-action-fg --toast-danger-bg --toast-danger-border " +
-  "--toast-info-bg --toast-info-border --toast-success-bg --toast-success-border --toast-warning-bg " +
-  "--toast-warning-border --warning --warning-bg --warning-border --warning-border-strong " +
-  "--warning-contrast --z-toast";
-
-/** The theme variables of Tailwind 4.3.3's `theme.css` (413 names). */
-export const TAILWIND_THEME_NAMES =
-  "--animate-bounce --animate-ping --animate-pulse --animate-spin --aspect-video --blur-2xl " +
-  "--blur-3xl --blur-lg --blur-md --blur-sm --blur-xl --blur-xs --breakpoint-2xl --breakpoint-lg " +
-  "--breakpoint-md --breakpoint-sm --breakpoint-xl --color-amber-100 --color-amber-200 " +
-  "--color-amber-300 --color-amber-400 --color-amber-50 --color-amber-500 --color-amber-600 " +
-  "--color-amber-700 --color-amber-800 --color-amber-900 --color-amber-950 --color-black " +
-  "--color-blue-100 --color-blue-200 --color-blue-300 --color-blue-400 --color-blue-50 " +
-  "--color-blue-500 --color-blue-600 --color-blue-700 --color-blue-800 --color-blue-900 " +
-  "--color-blue-950 --color-cyan-100 --color-cyan-200 --color-cyan-300 --color-cyan-400 " +
-  "--color-cyan-50 --color-cyan-500 --color-cyan-600 --color-cyan-700 --color-cyan-800 " +
-  "--color-cyan-900 --color-cyan-950 --color-emerald-100 --color-emerald-200 --color-emerald-300 " +
-  "--color-emerald-400 --color-emerald-50 --color-emerald-500 --color-emerald-600 " +
-  "--color-emerald-700 --color-emerald-800 --color-emerald-900 --color-emerald-950 " +
-  "--color-fuchsia-100 --color-fuchsia-200 --color-fuchsia-300 --color-fuchsia-400 " +
-  "--color-fuchsia-50 --color-fuchsia-500 --color-fuchsia-600 --color-fuchsia-700 " +
-  "--color-fuchsia-800 --color-fuchsia-900 --color-fuchsia-950 --color-gray-100 --color-gray-200 " +
-  "--color-gray-300 --color-gray-400 --color-gray-50 --color-gray-500 --color-gray-600 " +
-  "--color-gray-700 --color-gray-800 --color-gray-900 --color-gray-950 --color-green-100 " +
-  "--color-green-200 --color-green-300 --color-green-400 --color-green-50 --color-green-500 " +
-  "--color-green-600 --color-green-700 --color-green-800 --color-green-900 --color-green-950 " +
-  "--color-indigo-100 --color-indigo-200 --color-indigo-300 --color-indigo-400 --color-indigo-50 " +
-  "--color-indigo-500 --color-indigo-600 --color-indigo-700 --color-indigo-800 --color-indigo-900 " +
-  "--color-indigo-950 --color-lime-100 --color-lime-200 --color-lime-300 --color-lime-400 " +
-  "--color-lime-50 --color-lime-500 --color-lime-600 --color-lime-700 --color-lime-800 " +
-  "--color-lime-900 --color-lime-950 --color-mauve-100 --color-mauve-200 --color-mauve-300 " +
-  "--color-mauve-400 --color-mauve-50 --color-mauve-500 --color-mauve-600 --color-mauve-700 " +
-  "--color-mauve-800 --color-mauve-900 --color-mauve-950 --color-mist-100 --color-mist-200 " +
-  "--color-mist-300 --color-mist-400 --color-mist-50 --color-mist-500 --color-mist-600 " +
-  "--color-mist-700 --color-mist-800 --color-mist-900 --color-mist-950 --color-neutral-100 " +
-  "--color-neutral-200 --color-neutral-300 --color-neutral-400 --color-neutral-50 " +
-  "--color-neutral-500 --color-neutral-600 --color-neutral-700 --color-neutral-800 " +
-  "--color-neutral-900 --color-neutral-950 --color-olive-100 --color-olive-200 --color-olive-300 " +
-  "--color-olive-400 --color-olive-50 --color-olive-500 --color-olive-600 --color-olive-700 " +
-  "--color-olive-800 --color-olive-900 --color-olive-950 --color-orange-100 --color-orange-200 " +
-  "--color-orange-300 --color-orange-400 --color-orange-50 --color-orange-500 --color-orange-600 " +
-  "--color-orange-700 --color-orange-800 --color-orange-900 --color-orange-950 --color-pink-100 " +
-  "--color-pink-200 --color-pink-300 --color-pink-400 --color-pink-50 --color-pink-500 " +
-  "--color-pink-600 --color-pink-700 --color-pink-800 --color-pink-900 --color-pink-950 " +
-  "--color-purple-100 --color-purple-200 --color-purple-300 --color-purple-400 --color-purple-50 " +
-  "--color-purple-500 --color-purple-600 --color-purple-700 --color-purple-800 --color-purple-900 " +
-  "--color-purple-950 --color-red-100 --color-red-200 --color-red-300 --color-red-400 " +
-  "--color-red-50 --color-red-500 --color-red-600 --color-red-700 --color-red-800 --color-red-900 " +
-  "--color-red-950 --color-rose-100 --color-rose-200 --color-rose-300 --color-rose-400 " +
-  "--color-rose-50 --color-rose-500 --color-rose-600 --color-rose-700 --color-rose-800 " +
-  "--color-rose-900 --color-rose-950 --color-sky-100 --color-sky-200 --color-sky-300 " +
-  "--color-sky-400 --color-sky-50 --color-sky-500 --color-sky-600 --color-sky-700 --color-sky-800 " +
-  "--color-sky-900 --color-sky-950 --color-slate-100 --color-slate-200 --color-slate-300 " +
-  "--color-slate-400 --color-slate-50 --color-slate-500 --color-slate-600 --color-slate-700 " +
-  "--color-slate-800 --color-slate-900 --color-slate-950 --color-stone-100 --color-stone-200 " +
-  "--color-stone-300 --color-stone-400 --color-stone-50 --color-stone-500 --color-stone-600 " +
-  "--color-stone-700 --color-stone-800 --color-stone-900 --color-stone-950 --color-taupe-100 " +
-  "--color-taupe-200 --color-taupe-300 --color-taupe-400 --color-taupe-50 --color-taupe-500 " +
-  "--color-taupe-600 --color-taupe-700 --color-taupe-800 --color-taupe-900 --color-taupe-950 " +
-  "--color-teal-100 --color-teal-200 --color-teal-300 --color-teal-400 --color-teal-50 " +
-  "--color-teal-500 --color-teal-600 --color-teal-700 --color-teal-800 --color-teal-900 " +
-  "--color-teal-950 --color-violet-100 --color-violet-200 --color-violet-300 --color-violet-400 " +
-  "--color-violet-50 --color-violet-500 --color-violet-600 --color-violet-700 --color-violet-800 " +
-  "--color-violet-900 --color-violet-950 --color-white --color-yellow-100 --color-yellow-200 " +
-  "--color-yellow-300 --color-yellow-400 --color-yellow-50 --color-yellow-500 --color-yellow-600 " +
-  "--color-yellow-700 --color-yellow-800 --color-yellow-900 --color-yellow-950 --color-zinc-100 " +
-  "--color-zinc-200 --color-zinc-300 --color-zinc-400 --color-zinc-50 --color-zinc-500 " +
-  "--color-zinc-600 --color-zinc-700 --color-zinc-800 --color-zinc-900 --color-zinc-950 " +
-  "--container-2xl --container-2xs --container-3xl --container-3xs --container-4xl --container-5xl " +
-  "--container-6xl --container-7xl --container-lg --container-md --container-sm --container-xl " +
-  "--container-xs --default-font-family --default-font-feature-settings " +
-  "--default-font-variation-settings --default-mono-font-family " +
-  "--default-mono-font-feature-settings --default-mono-font-variation-settings " +
-  "--default-transition-duration --default-transition-timing-function --drop-shadow-2xl " +
-  "--drop-shadow-lg --drop-shadow-md --drop-shadow-sm --drop-shadow-xl --drop-shadow-xs --ease-in " +
-  "--ease-in-out --ease-out --font-mono --font-sans --font-serif --font-weight-black " +
-  "--font-weight-bold --font-weight-extrabold --font-weight-extralight --font-weight-light " +
-  "--font-weight-medium --font-weight-normal --font-weight-semibold --font-weight-thin " +
-  "--inset-shadow-2xs --inset-shadow-sm --inset-shadow-xs --leading-loose --leading-normal " +
-  "--leading-relaxed --leading-snug --leading-tight --perspective-distant --perspective-dramatic " +
-  "--perspective-midrange --perspective-near --perspective-normal --radius-2xl --radius-3xl " +
-  "--radius-4xl --radius-lg --radius-md --radius-sm --radius-xl --radius-xs --shadow-2xl " +
-  "--shadow-2xs --shadow-lg --shadow-md --shadow-sm --shadow-xl --shadow-xs --spacing --text-2xl " +
-  "--text-2xl--line-height --text-3xl --text-3xl--line-height --text-4xl --text-4xl--line-height " +
-  "--text-5xl --text-5xl--line-height --text-6xl --text-6xl--line-height --text-7xl " +
-  "--text-7xl--line-height --text-8xl --text-8xl--line-height --text-9xl --text-9xl--line-height " +
-  "--text-base --text-base--line-height --text-lg --text-lg--line-height --text-shadow-2xs " +
-  "--text-shadow-lg --text-shadow-md --text-shadow-sm --text-shadow-xs --text-sm " +
-  "--text-sm--line-height --text-xl --text-xl--line-height --text-xs --text-xs--line-height " +
-  "--tracking-normal --tracking-tight --tracking-tighter --tracking-wide --tracking-wider " +
-  "--tracking-widest";

package/src/testing/css-variables.ts

@@ -1,189 +0,0 @@
-import { themeBlocks } from "../eslint/role-utilities";
-import { KIT_NAMES, TAILWIND_THEME_NAMES } from "./css-variables.generated";
-
-/**
- * The guard against an undeclared CSS custom property (0.33,
- * docs/colour-roles-harmonization.md §8, §12.5).
- *
- * A `var(--name)` with no fallback, where nothing declares `--name`, makes the whole
- * declaration invalid at computed-value time: `fill` inherits, `color` inherits, a
- * background goes transparent. Kurvenschmiede's control diagram painted
- * `fill-[var(--surface)]` — a token that never existed (the kit's is `--bg-surface`) —
- * and drew black boxes on a public page. The class compiled, the build passed, the type
- * checker had no opinion, and nothing in any suite noticed. This is the check that
- * notices, run from an app's own test over the source texts the app collects.
- *
- * Browser-safe on purpose, like the rest of the kit: it takes TEXTS, not paths, so an app
- * reads its files however its setup allows (`import.meta.glob` with `?raw`, or `node:fs`)
- * and the kit carries no `node:fs`.
- */
-
-/** Every custom property the installed kit declares or publishes to apps.
- *
- *  Generated from `tokens.css` when the kit is built (scripts/gen-kit-css-variables.mjs),
- *  so it is always the installed version's, and an app never searches `node_modules`.
- *  It leaves out two kinds of name on purpose:
- *  - a name declared only in an `@theme inline` block (`--text-color-muted`,
- *    `--background-color-surface`): Tailwind emits no variable for it, so
- *    `var(--text-color-muted)` would pass a guard that counted it and paint nothing;
- *  - AppShell's measured `--app-nav-h`, which exists only while an AppShell is mounted —
- *    on a landing, legal, sign-in or pay page it is undefined. Read it with a fallback,
- *    `var(--app-nav-h,0px)`, as every kit read does.
- *  Everything `applyTokenSet` and More contrast write on `<html>` is in, through the
- *  stylesheet's `:root` / `.dark` mirror. Component internals (`--slider-fill`, `--fp-*`,
- *  `--icon-button-tone`, `--label-strip-edge`) are not: an app that reads one depends on
- *  the kit's internals, and the guard says so. */
-export const KIT_CSS_VARIABLES: ReadonlySet<string> = new Set(KIT_NAMES.split(" "));
-
-/** Tailwind's own theme variables (`--color-rose-500`, `--spacing`, `--text-sm` …), from
- *  the `tailwindcss/theme.css` the kit builds with. Tailwind emits one when a scanned file
- *  names it, so a `var()` of it resolves. */
-const TAILWIND_THEME: ReadonlySet<string> = new Set(TAILWIND_THEME_NAMES.split(" "));
-
-/** A Tailwind PALETTE colour: a hue with a shade, black or white. `refusePalette` reports
- *  these although they resolve — an app that has no palette lint asks this test to be
- *  its refusal. */
-const PALETTE_VARIABLE = /^--color-(?:[a-z]+-\d{2,3}|black|white)$/;
-
-/** Read only where it is set: the guard accepts it in a fallback use, never bare. */
-const APP_NAV_H = "--app-nav-h";
-
-export interface UndeclaredCssVariablesOptions {
-  /** Variables a library writes at runtime, as names or patterns:
-   *  `["--radix-collapsible-content-height"]`. An app's own writes are found in its
-   *  source and need no listing. */
-  runtime?: readonly (string | RegExp)[];
-  /** Also check `var(--x, …)`. Off by default: a fallback says what happens when the
-   *  name is missing. `--app-nav-h` counts as declared only here. */
-  checkFallbacks?: boolean;
-  /** Report Tailwind palette variables (`--color-red-500`, `--color-white`) although
-   *  they resolve. Default false. */
-  refusePalette?: boolean;
-}
-
-/** Comments are not CSS. `/* *\/` in both; `//` in TS only (not after a `:`, so a URL in a
- *  string survives). Replaced by spaces of the same shape, so line numbers hold. */
-function stripComments(text: string, isCss: boolean): string {
-  const blank = (m: string) => m.replace(/[^\n]/g, " ");
-  const noBlocks = text.replace(/\/\*[\s\S]*?\*\//g, blank);
-  return isCss ? noBlocks : noBlocks.replace(/(^|[^:])(\/\/[^\n]*)/g, (_, pre: string, c: string) => pre + blank(c));
-}
-
-/** The text with every `@theme … inline … { … }` block blanked out, braces and all. The
- *  blocks are the kit's one block finder's, `themeBlocks` (src/eslint/role-utilities.ts,
- *  which imports nothing): this was a second brace-counting copy of it, kept equal to the
- *  generator's (scripts/gen-kit-css-variables.mjs, on `themeBlocks` since DUP-13) only by
- *  token-vars-declared.test.ts (0.52 code review). */
-function withoutInlineTheme(css: string): string {
-  let out = css;
-  for (const { start, end } of themeBlocks(css, { inline: true })) {
-    out = out.slice(0, start) + out.slice(start, end).replace(/[^\n]/g, " ") + out.slice(end);
-  }
-  return out;
-}
-
-/**
- * Every custom property a stylesheet declares (`--name:`), in any block — except a name
- * declared only inside `@theme inline`, which Tailwind never emits as a variable. Comments
- * are skipped. The same rule builds {@link KIT_CSS_VARIABLES} from `tokens.css`.
- */
-export function declaredCustomProperties(css: string): Set<string> {
-  const code = withoutInlineTheme(stripComments(css, true));
-  return new Set([...code.matchAll(/(--[a-zA-Z0-9_-]+)\s*:/g)].map((m) => m[1]));
-}
-
-/** What an app's source writes at runtime: `setProperty("--name"`, a React style key
- *  `"--name":`, a Tailwind arbitrary property `[--name:…]`. */
-function runtimeWrites(code: string): string[] {
-  return [
-    ...code.matchAll(/setProperty\(\s*["'`](--[a-zA-Z0-9_-]+)["'`]/g),
-    ...code.matchAll(/["'](--[a-zA-Z0-9_-]+)["']\s*:/g),
-    ...code.matchAll(/\[(--[a-zA-Z0-9_-]+):/g),
-  ].map((m) => m[1]);
-}
-
-/** A chart series' colour (`var(--color-total)`) is declared in a file with a `total: {`
- *  config entry: the kit's ChartContainer writes `--color-<key>` for each key. */
-function chartKeys(code: string): Set<string> {
-  return new Set([...code.matchAll(/(?:^|[\s{,])["']?([A-Za-z_][\w-]*)["']?\s*:\s*\{/g)].map((m) => m[1]));
-}
-
-const isCssPath = (path: string) => /\.css(?:\?|$)/.test(path);
-
-/**
- * Every `var(--name)` without a fallback that nothing declares, as `"path:line --name"`.
- *
- * `sources` maps a path to its text: the app's `.ts`, `.tsx` and `.css` source, tests
- * left out. A name counts as declared when it is:
- * 1. the kit's ({@link KIT_CSS_VARIABLES});
- * 2. declared in any `.css` entry of `sources` (outside `@theme inline`);
- * 3. written by the source at runtime (`setProperty`, a style key, `[--name:…]`);
- * 4. one of Tailwind's theme variables — unless `refusePalette` and it is a palette colour;
- * 5. a chart series' `--color-<key>`, in a file with a `<key>: {` entry;
- * 6. listed in `options.runtime`.
- *
- * Not counted: comments; a use with a fallback, unless `checkFallbacks`; a name built at
- * runtime (`` `var(--chart-${n})` `` — a name must be followed by `)` or `,`).
- *
- * It REFUSES A VACUOUS RUN: it throws when `sources` holds fewer than ten files, or when
- * a `.css` entry is empty. Vitest stubs every stylesheet with an empty string by default,
- * `?raw` included, so an app that reads its CSS that way without opting it out of the stub
- * (`test.css.include`) would otherwise lose every declaration and every use in it, and
- * this would pass or fail for the wrong reason.
- */
-export function undeclaredCssVariables(
-  sources: Record<string, string>,
-  options: UndeclaredCssVariablesOptions = {},
-): string[] {
-  const { runtime = [], checkFallbacks = false, refusePalette = false } = options;
-  const entries = Object.entries(sources);
-  if (entries.length < 10) {
-    throw new Error(
-      `undeclaredCssVariables: only ${entries.length} source file(s) — the glob or the file list found ` +
-        `(almost) nothing, and a check over nothing passes. Pass the app's .ts/.tsx/.css source.`,
-    );
-  }
-  const emptyCss = entries.filter(([path, text]) => isCssPath(path) && text.trim() === "").map(([path]) => path);
-  if (emptyCss.length) {
-    throw new Error(
-      `undeclaredCssVariables: ${emptyCss.join(", ")} read as empty. Vitest stubs stylesheets with "" ` +
-        `(\`?raw\` too) unless the file is listed in \`test.css.include\`.`,
-    );
-  }
-
-  const code = entries.map(([path, text]) => [path, stripComments(text, isCssPath(path))] as const);
-  const declared = new Set<string>();
-  for (const [path, text] of code) {
-    if (isCssPath(path)) for (const name of declaredCustomProperties(text)) declared.add(name);
-    for (const name of runtimeWrites(text)) declared.add(name);
-  }
-  const listed = (name: string) => runtime.some((r) => (typeof r === "string" ? r === name : r.test(name)));
-
-  const out: string[] = [];
-  for (const [path, text] of code) {
-    let keys: Set<string> | null = null;
-    for (const m of text.matchAll(/var\(\s*(--[a-zA-Z0-9_-]+)\s*([,)])/g)) {
-      const [, name, next] = m;
-      const fallback = next === ",";
-      if (fallback && !checkFallbacks) continue;
-      if (KIT_CSS_VARIABLES.has(name) || declared.has(name) || listed(name)) continue;
-      if (fallback && name === APP_NAV_H) continue;
-      if (TAILWIND_THEME.has(name)) {
-        if (refusePalette && PALETTE_VARIABLE.test(name)) {
-          out.push(`${path}:${lineOf(text, m.index)} ${name} (a Tailwind palette colour; refusePalette is on)`);
-        }
-        continue;
-      }
-      const chart = /^--color-([A-Za-z_][\w-]*)$/.exec(name);
-      if (chart && (keys ??= chartKeys(text)).has(chart[1])) continue;
-      out.push(`${path}:${lineOf(text, m.index)} ${name}`);
-    }
-  }
-  return out;
-}
-
-function lineOf(text: string, index: number): number {
-  let line = 1;
-  for (let i = 0; i < index; i++) if (text.charCodeAt(i) === 10) line++;
-  return line;
-}

package/src/testing/index.ts

@@ -1,29 +0,0 @@
-// `@eifi1/ui-kit/testing` — helpers an app runs from its OWN test suite (0.33).
-//
-// Not part of the main barrel: nothing here renders, and an app's production bundle has
-// no business carrying it. Browser-safe like the rest of the kit (no `node:fs`): each
-// helper takes texts, so an app collects them with `import.meta.glob` or `node:fs`, as
-// its setup allows. The first content is the guard against undeclared CSS custom
-// properties (docs/colour-roles-harmonization.md §8).
-export {
-  KIT_CSS_VARIABLES,
-  declaredCustomProperties,
-  undeclaredCssVariables,
-  type UndeclaredCssVariablesOptions,
-} from "./css-variables";
-// 0.34 (refactor audit 2026-10, TST-10): the environment jsdom lacks — a `matchMedia`
-// that answers from a viewport width (right at every text size) and a `ResizeObserver`
-// the test drives. Framework-free: each returns its own undo. 0.35: `setViewportWidth`,
-// a live resize of the stub in force — its lists flip and fire `change` (keksdose).
-export {
-  setViewportWidth,
-  stubResizeObserver,
-  stubViewportWidth,
-  viewportMatchMedia,
-  type ResizeObserverStub,
-  type StubbedBoxSize,
-  type ViewportOptions,
-} from "./viewport";
-// 0.50.1 (keksdose N4): a valid `TourStepContext` for a test that calls a step's
-// `beforeStep` or `when` itself — `beforeStep!(tourStepContext())`.
-export { tourStepContext, type TestTourStepContext, type TourStepContextOptions, type TourStepVia } from "./tour";