@eifi1/ui-kit 0.43.0 → 0.45.0

package/dist/tour/use-tour-progress.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tour/use-tour-progress.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from \"react\";\nimport { readStored, removeStored, writeStored } from \"../lib/safe-storage\";\nimport { isTourDone, type TourCompletions } from \"./tour-info\";\n\n/**\n * Which tours this device has completed (docs/tours-harmonization.md §2.6, §6.2) —\n * keksdose's `tour-progress-store` and kastlan's `completions.ts`, as one hook.\n *\n * - **Device storage, the app's key.** `storageKey` is always the app's: an app on shared\n *   devices scopes it per account (KS, bench PCs), and an app that lists its keys\n *   (KS `storage-keys.ts`) spells it there. Every access is guarded: a blocked or full\n *   storage keeps the marks for this page's life instead of throwing.\n * - **One store, every reader.** A change notifies every hook on the same key in this tab\n *   (an in-tab emitter) and in other tabs (the `storage` event), so the tours page and\n *   `TourMenu` agree without a reload (ka F3).\n * - **`migrate(raw)`** reads an older shape, so nobody loses their done marks at adoption:\n *   it gets the stored JSON (or the raw text, if it is no JSON) and returns the record for\n *   a shape it recognises, `undefined` for any other — the kit's own shape included,\n *   which it then reads itself. keksdose: zustand's `{state: {completed}, version: 1}`;\n *   kastlan: an array of ids, completed without a date (`null`). It runs only on a stored\n *   text that is not the kit's shape already, once per text and key, whichever reader\n *   reads it first; its identity is ignored. **Define `migrate` once, at module level**,\n *   and hand every reader of the key the same one: readers of one key share one snapshot.\n * - **Resetting the device** (settings §11): register the key with `reset: () =>\n *   resetTourProgress(storageKey)`, which clears storage and the page's memory and tells\n *   every reader in this tab.\n *\n * The kit's own shape is the record itself, `{ [id]: ISO | null }`; an empty string reads\n * as `null` (kastlan's record of 0.42).\n */\nexport interface UseTourProgressOptions {\n  storageKey: string;\n  migrate?: (raw: unknown) => Record<string, string | null> | undefined;\n}\n\nexport interface TourProgress {\n  /** Tour id → the completion's ISO timestamp, or `null` when recorded without a date. */\n  completed: TourCompletions;\n  /**\n   * Record a completion. Keeps the FIRST completion's date, so a replay changes nothing —\n   * unless the tour was reset by an update since (§8): pass the tour (`{id, updated}`) and\n   * a completion from before `updated.date` is replaced by today's.\n   *\n   * Returns `true` when this counts as a new completion — the moment to award the tour's\n   * points and show the app's toast (§6.1) — and `false` for a replay.\n   */\n  complete: (tour: string | { id: string; updated?: { date: string } | null }) => boolean;\n  /** \"Mark as not done\": forget the completion. */\n  reset: (id: string) => void;\n}\n\n/* ── The store: one per key, shared by every hook ───────────────────────────── */\n\nconst EMPTY: TourCompletions = Object.freeze({});\n/** In-tab listeners per key. */\nconst listeners = new Map<string, Set<() => void>>();\n/** What this page wrote where storage refused to keep it (blocked, full): per key. */\nconst memory = new Map<string, string>();\n/**\n * The last raw text read per key and what it parsed to, so a snapshot keeps its identity:\n * the same text gives the same object, whichever reader asks and whatever `migrate` it\n * holds. Several readers of one key with inline `migrate` arrows used to evict each other\n * here and loop (kastlan B1, 0.43).\n */\nconst cache = new Map<string, { raw: string | null; value: TourCompletions }>();\n\nfunction emit(key: string) {\n  listeners.get(key)?.forEach((listener) => listener());\n}\n\nfunction rawOf(key: string): string | null {\n  return memory.get(key) ?? readStored(key);\n}\n\n/** Is this the kit's own shape already: a record whose every value is a string or null? */\nfunction isKitShape(value: unknown): boolean {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n  return Object.values(value as Record<string, unknown>).every((at) => at === null || typeof at === \"string\");\n}\n\n/** The kit's own shape: a record of string or null; anything else is dropped. */\nfunction fromRecord(value: unknown): TourCompletions | undefined {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n  const out: Record<string, string | null> = {};\n  for (const [id, at] of Object.entries(value as Record<string, unknown>)) {\n    if (at === null || at === \"\") out[id] = null;\n    else if (typeof at === \"string\") out[id] = at;\n  }\n  return out;\n}\n\nfunction parse(raw: string | null, migrate: UseTourProgressOptions[\"migrate\"]): TourCompletions {\n  if (raw === null) return EMPTY;\n  let value: unknown = raw;\n  try {\n    value = JSON.parse(raw);\n  } catch {\n    // Not JSON: `migrate` still sees the text.\n  }\n  if (migrate && !isKitShape(value)) {\n    try {\n      const migrated = migrate(value);\n      if (migrated !== undefined) return fromRecord(migrated) ?? EMPTY;\n    } catch {\n      // A migrate that throws reads as \"not a shape it knows\".\n    }\n  }\n  return fromRecord(value) ?? EMPTY;\n}\n\nfunction snapshot(key: string, migrate: UseTourProgressOptions[\"migrate\"]): TourCompletions {\n  const raw = rawOf(key);\n  const hit = cache.get(key);\n  if (hit && hit.raw === raw) return hit.value;\n  const value = parse(raw, migrate);\n  cache.set(key, { raw, value });\n  return value;\n}\n\nfunction write(key: string, record: TourCompletions) {\n  const raw = JSON.stringify(record);\n  writeStored(key, raw);\n  // Storage refused it (blocked, full): keep it for this page's life instead.\n  if (readStored(key) === raw) memory.delete(key);\n  else memory.set(key, raw);\n  emit(key);\n}\n\nfunction subscribe(key: string, listener: () => void): () => void {\n  let set = listeners.get(key);\n  if (!set) listeners.set(key, (set = new Set()));\n  set.add(listener);\n  // Another tab wrote (or cleared all storage: `key` null).\n  const onStorage = (event: StorageEvent) => {\n    if (event.key !== null && event.key !== key) return;\n    memory.delete(key);\n    listener();\n  };\n  if (typeof window !== \"undefined\") window.addEventListener(\"storage\", onStorage);\n  return () => {\n    set.delete(listener);\n    if (typeof window !== \"undefined\") window.removeEventListener(\"storage\", onStorage);\n  };\n}\n\n/**\n * Forget every tour completion under `storageKey` on this device: the stored key, what the\n * page kept in memory where storage refused it, and every reader in this tab moves at\n * once. For \"Reset this device's settings\" (settings §11):\n *\n *     registerDeviceSetting({ key: TOUR_KEY, kind: \"view\", reset: () => resetTourProgress(TOUR_KEY) });\n */\nexport function resetTourProgress(storageKey: string): void {\n  removeStored(storageKey);\n  memory.delete(storageKey);\n  cache.delete(storageKey);\n  emit(storageKey);\n}\n\n/** The device's tour completions under `storageKey`; see {@link UseTourProgressOptions}. */\nexport function useTourProgress({ storageKey, migrate }: UseTourProgressOptions): TourProgress {\n  // Held, not depended on: an inline arrow is a new function every render, and neither the\n  // snapshot nor the callbacks may change with it.\n  const migrateRef = useRef(migrate);\n  useEffect(() => {\n    migrateRef.current = migrate;\n  });\n  const completed = useSyncExternalStore(\n    useCallback((listener: () => void) => subscribe(storageKey, listener), [storageKey]),\n    () => snapshot(storageKey, migrateRef.current),\n    () => EMPTY,\n  );\n\n  const complete = useCallback(\n    (tour: string | { id: string; updated?: { date: string } | null }) => {\n      const subject = typeof tour === \"string\" ? { id: tour } : tour;\n      // Read now rather than from the render: two completions in one handler both count.\n      const current = snapshot(storageKey, migrateRef.current);\n      if (isTourDone(subject, current[subject.id])) return false;\n      write(storageKey, { ...current, [subject.id]: new Date().toISOString() });\n      return true;\n    },\n    [storageKey],\n  );\n\n  const reset = useCallback(\n    (id: string) => {\n      const current = snapshot(storageKey, migrateRef.current);\n      if (current[id] === undefined) return;\n      const next = { ...current };\n      delete next[id];\n      write(storageKey, next);\n    },\n    [storageKey],\n  );\n\n  return useMemo(() => ({ completed, complete, reset }), [completed, complete, reset]);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tour/use-tour-progress.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from \"react\";\nimport { readStored, removeStored, writeStored } from \"../lib/safe-storage\";\nimport { httpStatusOf } from \"../auth/auth-errors\";\nimport { isTourDone, type TourCompletions } from \"./tour-info\";\n\n/**\n * Which tours this device has completed (docs/tours-harmonization.md §2.6, §6.2) —\n * keksdose's `tour-progress-store` and kastlan's `completions.ts`, as one hook.\n *\n * - **Device storage, the app's key.** `storageKey` is always the app's: an app on shared\n *   devices scopes it per account (KS, bench PCs), and an app that lists its keys\n *   (KS `storage-keys.ts`) spells it there. Every access is guarded: a blocked or full\n *   storage keeps the marks for this page's life instead of throwing.\n * - **One store, every reader.** A change notifies every hook on the same key in this tab\n *   (an in-tab emitter) and in other tabs (the `storage` event), so the tours page and\n *   `TourMenu` agree without a reload (ka F3).\n * - **`migrate(raw)`** reads an older shape, so nobody loses their done marks at adoption:\n *   it gets the stored JSON (or the raw text, if it is no JSON) and returns the record for\n *   a shape it recognises, `undefined` for any other — the kit's own shape included,\n *   which it then reads itself. keksdose: zustand's `{state: {completed}, version: 1}`;\n *   kastlan: an array of ids, completed without a date (`null`). It runs only on a stored\n *   text that is not the kit's shape already, once per text and key. The FIRST `migrate`\n *   any reader, `TourProvider` or {@link completeTour} passes for a key is remembered for\n *   that key (later identities are ignored), so a reader without one, mounted first, no\n *   longer hides the old marks from the rest (keksdose B-2). **Still, define the options\n *   once, at module level, and hand the provider and every reader the same object.**\n * - **Never overwritten unread** (keksdose B-1): a write (`complete`, the provider's,\n *   `completeTour`) on a stored text that is neither empty nor the kit's shape, and that no\n *   known `migrate` reads, THROWS instead of replacing the old marks.\n * - **Resetting the device** (settings §11): register the key with `reset: () =>\n *   resetTourProgress(storageKey)`, which clears storage and the page's memory and tells\n *   every reader in this tab.\n *\n * **The stored shape** (§9.3, §9.6.6), for an app's tests and seeds: the JSON record\n * `{ [id]: ISO instant | \"\" }` under `storageKey`, where `\"\"` is a completion without a\n * date (a migrated record: kastlan's id list). That is the one written form; the hooks\n * and callbacks (`completed`, `TourCompletions`) give `null` for `\"\"`. A `null` read from\n * storage (or returned by `migrate`) is accepted as the same thing and written back as\n * `\"\"`. To write a completion from outside a page, use {@link completeTour}.\n *\n * **On the account** (0.45, §10.2–§10.3): with `account`, the device key becomes the\n * account's CACHE — see {@link TourProgressAccount}. Without it, nothing changes from 0.44.\n */\nexport interface UseTourProgressOptions {\n  storageKey: string;\n  migrate?: (raw: unknown) => Record<string, string | null> | undefined;\n  /**\n   * 0.45: the account's record behind the device key (§10.2.4). Remembered per key like\n   * `migrate` (the FIRST one any reader or the provider passes wins). With it,\n   * `storageKey` must be per account (a prefix plus the user id), so build the options per\n   * account and keep ONE stable object per key — memoise them in a `Map` by user id — and\n   * let `load`/`save` read the current token when they run, never capture one:\n   *\n   *     const byUser = new Map<string, UseTourProgressOptions>();\n   *     function tourProgressFor(user: { id: string; isDemo: boolean } | null) {\n   *       if (!user || user.isDemo) return { storageKey: \"app.tours.completions\" }; // no account\n   *       let options = byUser.get(user.id);\n   *       if (!options) byUser.set(user.id, (options = { storageKey: `app.tours.completions:${user.id}`, account }));\n   *       return options;\n   *     }\n   *\n   * Signed out, and in a demo, pass none (and a fixed key): the device record works as in\n   * 0.44, and a demo neither PATCHes into a 403 nor leaves an orphan key per demo id.\n   */\n  account?: TourProgressAccount;\n}\n\n/** The record on the wire (§10.2.2): tour id → ISO instant, or `\"\"` (done, no date). */\ntype TourProgressWire = Record<string, string>;\n\n/** The `PATCH /tours/progress` body (§10.2.2): what to mark done, and what to forget.\n *  An id is never in both. Either may be left out. */\nexport interface TourProgressBody {\n  completed?: TourProgressWire;\n  forget?: string[];\n}\n\n/**\n * Taking over a device-wide record from before the account (§10.2.5), on the FIRST load\n * of the account key on this page:\n * - `{storageKey, discard: true}` (kastlan): removes the old key and uploads nothing — a\n *   shared PC must not hand one person another's marks. Removing an absent key is a no-op.\n * - `{storageKey, migrate?}`: reads the old key once (through `migrate` for an older\n *   shape), uploads it to the first account that signs in on this device, then removes it.\n */\nexport type TourProgressAdopt =\n  | { storageKey: string; discard: true; migrate?: never }\n  | { storageKey: string; discard?: false; migrate?: UseTourProgressOptions[\"migrate\"] };\n\n/**\n * The app's account record (§10.3): `load()` is its `GET /tours/progress`, `save(body)`\n * its `PATCH`, each resolving to the parsed answer, `{completed}` — the whole record.\n *\n * - The page paints from the device key at once (and offline); the account is loaded on\n *   the first reader of the key on this page, on `online`, and after each save, and its\n *   answer replaces the cache.\n * - A write (`complete`, the provider's finish, `reset`) goes to the cache at once and to\n *   a PENDING record beside it, `<storageKey>:pending` (`{synced, completed, forget}`),\n *   sent as one PATCH and cleared by its answer. A failure with no answer (offline, 5xx,\n *   401) keeps it for the next load or `online`; a 402 (a lapsed plan) keeps it but sends it\n *   no more on this page (the next session or page load tries again); a 403 or 422 drops\n *   it and logs.\n * - `awarded` stays the device's answer against the cache (§10.2.4).\n * - The pending record is NOT the app's outbox: leave it out of any \"N waiting\" count\n *   and any sign-out guard (losing a tour mark is acceptable).\n * - A device record never synced (no `:pending` with `synced: true`) is uploaded whole on\n *   its first load, by the server's merge rule (later completion wins).\n * - On every end of a session call {@link signOutTourProgress}.\n */\nexport interface TourProgressAccount {\n  load: () => Promise<{ completed: TourProgressWire }>;\n  save: (body: TourProgressBody) => Promise<{ completed: TourProgressWire }>;\n  adopt?: TourProgressAdopt;\n}\n\n/** What `complete` takes: a tour id, or the tour (`{id, updated}`, a `TourInfo` fits). */\ntype CompletedTour = string | { id: string; updated?: { date: string } | null };\n\nexport interface TourProgress {\n  /** Tour id → the completion's ISO timestamp, or `null` when recorded without a date. */\n  completed: TourCompletions;\n  /**\n   * Record a completion. Keeps the FIRST completion's date, so a replay changes nothing —\n   * unless the tour was reset by an update since (§8): pass the tour (`{id, updated}`) and\n   * a completion from before `updated.date` is replaced by today's.\n   *\n   * Returns `true` when this counts as a new completion — the moment to award the tour's\n   * points and show the app's toast (§6.1) — and `false` for a replay.\n   *\n   * A tour started with `start(steps, {tour})` under a `TourProvider` that has `progress`\n   * is recorded by the provider (§9.6.2): do not call this from that start's `onFinish`\n   * too, or the second write answers `false`.\n   */\n  complete: (tour: CompletedTour) => boolean;\n  /** \"Mark as not done\": forget the completion. */\n  reset: (id: string) => void;\n}\n\n/* ── The store: one per key, shared by every hook ───────────────────────────── */\n\nconst EMPTY: TourCompletions = Object.freeze({});\n/** In-tab listeners per key. */\nconst listeners = new Map<string, Set<() => void>>();\n/** What this page wrote where storage refused to keep it (blocked, full): per key. */\nconst memory = new Map<string, string>();\n/**\n * The last raw text read per key and what it parsed to, so a snapshot keeps its identity:\n * the same text gives the same object, whichever reader asks and whatever `migrate` it\n * holds. Several readers of one key with inline `migrate` arrows used to evict each other\n * here and loop (kastlan B1, 0.43).\n */\nconst cache = new Map<string, { raw: string | null; value: TourCompletions; readable: boolean }>();\ntype Migrate = NonNullable<UseTourProgressOptions[\"migrate\"]>;\n/** Each key's migrate: the first one any reader, the provider or `completeTour` passes (B-2). */\nconst migrates = new Map<string, Migrate>();\n\n/**\n * Remember `migrate` for `key` if it is the first one, and return the key's migrate. A\n * snapshot parsed before the key had one is dropped and re-parsed, and the key's readers\n * hear of it after this render (never from inside one).\n * @internal Not part of the barrel; `TourProvider` registers its `progress` with it.\n */\nexport function rememberMigrate(key: string, migrate: UseTourProgressOptions[\"migrate\"]): Migrate | undefined {\n  if (migrate && !migrates.has(key)) {\n    migrates.set(key, migrate);\n    if (cache.delete(key)) queueMicrotask(() => emit(key));\n  }\n  return migrates.get(key);\n}\n\nfunction emit(key: string) {\n  listeners.get(key)?.forEach((listener) => listener());\n}\n\nfunction rawOf(key: string): string | null {\n  return memory.get(key) ?? readStored(key);\n}\n\n/** Is this the kit's own shape already: a record whose every value is a string or null? */\nfunction isKitShape(value: unknown): boolean {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n  return Object.values(value as Record<string, unknown>).every((at) => at === null || typeof at === \"string\");\n}\n\n/** The kit's own shape: a record of string or null; anything else is dropped. */\nfunction fromRecord(value: unknown): TourCompletions | undefined {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n  const out: Record<string, string | null> = {};\n  for (const [id, at] of Object.entries(value as Record<string, unknown>)) {\n    if (at === null || at === \"\") out[id] = null;\n    else if (typeof at === \"string\") out[id] = at;\n  }\n  return out;\n}\n\n/**\n * The record, and whether the text was READ (empty, the kit's shape, or a shape `migrate`\n * knows) rather than dropped: a write over an unread text would lose it (B-1).\n */\nfunction parse(raw: string | null, migrate: UseTourProgressOptions[\"migrate\"]): { value: TourCompletions; readable: boolean } {\n  if (raw === null || raw.trim() === \"\") return { value: EMPTY, readable: true };\n  let value: unknown = raw;\n  try {\n    value = JSON.parse(raw);\n  } catch {\n    // Not JSON: `migrate` still sees the text.\n  }\n  if (migrate && !isKitShape(value)) {\n    try {\n      const migrated = fromRecord(migrate(value));\n      if (migrated !== undefined) return { value: migrated, readable: true };\n    } catch {\n      // A migrate that throws reads as \"not a shape it knows\".\n    }\n  }\n  return { value: fromRecord(value) ?? EMPTY, readable: isKitShape(value) };\n}\n\nfunction snapshot(key: string, migrate: UseTourProgressOptions[\"migrate\"]): TourCompletions {\n  const known = rememberMigrate(key, migrate);\n  const raw = rawOf(key);\n  const hit = cache.get(key);\n  if (hit && hit.raw === raw) return hit.value;\n  const parsed = parse(raw, known);\n  cache.set(key, { raw, ...parsed });\n  return parsed.value;\n}\n\n/** The record a write builds on; throws rather than overwrite a text nobody could read (B-1). */\nfunction readForWrite(key: string, migrate: UseTourProgressOptions[\"migrate\"], own = false): TourCompletions {\n  // `own`: this migrate, even where the key registered another (completeTour's `{migrate}`).\n  const known = rememberMigrate(key, migrate);\n  const { value, readable } =\n    own && migrate && known !== migrate\n      ? parse(rawOf(key), migrate)\n      : { value: snapshot(key, migrate), readable: cache.get(key)?.readable };\n  if (!readable) {\n    throw new Error(\n      `[ui-kit] tour progress: the text stored under \"${key}\" is not the kit's shape and no migrate reads it; ` +\n        \"refusing to overwrite it. Pass the key's migrate (the shared useTourProgress / TourProvider options, \" +\n        \"or completeTour's {migrate}).\",\n    );\n  }\n  return value;\n}\n\n/** The one written form (§9.6.6): a completion without a date is stored as `\"\"`, never `null`. */\nfunction write(key: string, record: TourCompletions) {\n  const stored: Record<string, string> = {};\n  for (const [id, at] of Object.entries(record)) stored[id] = at ?? \"\";\n  const raw = JSON.stringify(stored);\n  writeStored(key, raw);\n  // Storage refused it (blocked, full): keep it for this page's life instead.\n  if (readStored(key) === raw) memory.delete(key);\n  else memory.set(key, raw);\n  emit(key);\n}\n\n/* ── The account behind the device key (0.45, §10.2.4–§10.2.8) ─────────────── */\n\n/** The key's account: the first one any reader or the provider passes (as `migrate`). */\nconst accounts = new Map<string, TourProgressAccount>();\n/** Keys whose account was loaded (or is loading) on this page: the first reader loads. */\nconst loaded = new Set<string>();\n/** Keys with a sync running, and those asked for another while it ran. */\nconst running = new Set<string>();\nconst rerun = new Set<string>();\n/** Keys with a sync queued for the end of this task: two writes in one handler, one PATCH. */\nconst queued = new Set<string>();\n/** Bumped by a sign-out: an answer that comes back after it never refills the cache. */\nconst epochs = new Map<string, number>();\n/** Keys whose PATCH got a 402 (a lapsed plan): the pending record is kept but not sent\n *  again on this page; the next session (or page load) tries once more. */\nconst parked = new Set<string>();\n/** The pending record where storage refused to keep it. */\nconst pendingMemory = new Map<string, string>();\nlet onlineListening = false;\n\n/** The pending record (§10.2.4): what waits to be sent, and whether the device key was\n *  ever synced. */\ninterface PendingRecord {\n  synced: boolean;\n  completed: TourProgressWire;\n  forget: string[];\n}\n\nconst pendingKey = (key: string) => `${key}:pending`;\n\nfunction devWarn(message: string) {\n  if (import.meta.env?.DEV) console.warn(message);\n}\n\n/**\n * Remember `account` for `key` if it is the first one, and return the key's account.\n * @internal Not part of the barrel; `TourProvider` registers its `progress` with it.\n */\nexport function rememberAccount(key: string, account: TourProgressAccount | undefined): TourProgressAccount | undefined {\n  if (account && !accounts.has(key)) {\n    accounts.set(key, account);\n    if (account.adopt && account.adopt.storageKey === key) {\n      devWarn(\n        `[ui-kit] tour progress: the account key \"${key}\" is the key \\`adopt\\` takes over. ` +\n          \"With an account the key must be per account (a prefix plus the user id), apart from the old device-wide key.\",\n      );\n    }\n    if (!onlineListening && typeof window !== \"undefined\") {\n      onlineListening = true;\n      window.addEventListener(\"online\", () => {\n        for (const known of loaded) void sync(known);\n      });\n    }\n  }\n  return accounts.get(key);\n}\n\nfunction readPending(key: string): PendingRecord | null {\n  const raw = pendingMemory.get(key) ?? readStored(pendingKey(key));\n  if (raw === null) return null;\n  try {\n    const value = JSON.parse(raw) as Partial<PendingRecord> | null;\n    if (!value || typeof value !== \"object\") return null;\n    const completed: TourProgressWire = {};\n    for (const [id, at] of Object.entries(value.completed ?? {})) {\n      if (typeof at === \"string\") completed[id] = at;\n      else if (at === null) completed[id] = \"\";\n    }\n    const forget = Array.isArray(value.forget) ? value.forget.filter((id): id is string => typeof id === \"string\") : [];\n    return { synced: value.synced === true, completed, forget };\n  } catch {\n    return null;\n  }\n}\n\nfunction writePending(key: string, record: PendingRecord) {\n  const raw = JSON.stringify(record);\n  writeStored(pendingKey(key), raw);\n  if (readStored(pendingKey(key)) === raw) pendingMemory.delete(key);\n  else pendingMemory.set(key, raw);\n}\n\nconst hasWork = (record: PendingRecord) => Object.keys(record.completed).length > 0 || record.forget.length > 0;\n\n/** \"Later completion wins\" (§10.2.3), as the server merges: an instant beats `\"\"`, `\"\"`\n *  beats nothing, and between two instants the later is kept. */\nfunction later(a: string | undefined, b: string): string {\n  if (a === undefined || a === \"\") return b;\n  if (b === \"\") return a;\n  return Date.parse(b) > Date.parse(a) ? b : a;\n}\n\n/** Note a completion (or, with `forget`, its removal) in the key's pending record. */\nfunction markPending(key: string, id: string, at: string | null | undefined, forget = false) {\n  const record = readPending(key) ?? { synced: false, completed: {}, forget: [] };\n  if (forget) {\n    delete record.completed[id];\n    if (!record.forget.includes(id)) record.forget.push(id);\n  } else {\n    record.completed[id] = at ?? \"\";\n    record.forget = record.forget.filter((other) => other !== id);\n  }\n  writePending(key, record);\n}\n\n/** After an answer (or a 403/422): take what was sent out of the pending record, keeping\n *  what was written while the request ran. */\nfunction clearSent(key: string, sent: TourProgressBody, synced: boolean) {\n  const record = readPending(key) ?? { synced: false, completed: {}, forget: [] };\n  for (const [id, at] of Object.entries(sent.completed ?? {})) {\n    if (record.completed[id] === at) delete record.completed[id];\n  }\n  const forgotten = new Set(sent.forget ?? []);\n  record.forget = record.forget.filter((id) => !forgotten.has(id));\n  record.synced = record.synced || synced;\n  writePending(key, record);\n}\n\n/** The account's answer as the cache, with what still waits to be sent laid over it. */\nfunction refill(key: string, answer: { completed: TourProgressWire } | null | undefined) {\n  const next: Record<string, string> = {};\n  for (const [id, at] of Object.entries(fromRecord(answer?.completed) ?? {})) next[id] = at ?? \"\";\n  const waiting = readPending(key);\n  if (waiting) {\n    for (const [id, at] of Object.entries(waiting.completed)) next[id] = later(next[id], at);\n    for (const id of waiting.forget) delete next[id];\n  }\n  const record: Record<string, string | null> = {};\n  for (const [id, at] of Object.entries(next)) record[id] = at === \"\" ? null : at;\n  write(key, record);\n}\n\n/** The first load of an account key on this page takes over the old device-wide key\n *  (§10.2.5). */\nfunction adoptOldRecord(key: string, account: TourProgressAccount) {\n  const adopt = account.adopt;\n  if (!adopt || adopt.storageKey === key) return;\n  const old = adopt.storageKey;\n  if (!adopt.discard) {\n    const { value } = parse(rawOf(old), adopt.migrate ?? migrates.get(old));\n    const entries = Object.entries(value);\n    if (entries.length > 0) {\n      const record = readPending(key) ?? { synced: false, completed: {}, forget: [] };\n      for (const [id, at] of entries) record.completed[id] = later(record.completed[id], at ?? \"\");\n      writePending(key, record);\n    }\n  }\n  // Removed either way, at once: no second account on this device gets it.\n  removeStored(old);\n  memory.delete(old);\n  cache.delete(old);\n  emit(old);\n}\n\n/** A device record never synced is uploaded whole on its first load (§10.2.5). */\nfunction uploadUnsynced(key: string) {\n  const record = readPending(key);\n  if (record?.synced) return;\n  const device = snapshot(key, migrates.get(key));\n  const entries = Object.entries(device);\n  const next = record ?? { synced: false, completed: {}, forget: [] };\n  if (entries.length === 0 && record) return;\n  for (const [id, at] of entries) {\n    if (!next.forget.includes(id)) next.completed[id] = later(next.completed[id], at ?? \"\");\n  }\n  writePending(key, next);\n}\n\n/** The key's first sync on this page: take over the old record, upload a never-synced one. */\nfunction prepare(key: string) {\n  loaded.add(key);\n  adoptOldRecord(key, accounts.get(key)!);\n  uploadUnsynced(key);\n}\n\n/** Queue a sync for the end of this task, so a handler's writes go as one PATCH. */\nfunction queueSync(key: string) {\n  if (!loaded.has(key)) prepare(key);\n  if (queued.has(key)) return;\n  queued.add(key);\n  queueMicrotask(() => {\n    queued.delete(key);\n    void sync(key);\n  });\n}\n\n/** The first reader of an account key on this page loads it. */\nfunction ensureLoaded(key: string) {\n  if (!accounts.has(key) || loaded.has(key)) return;\n  prepare(key);\n  void sync(key);\n}\n\n/**\n * Send what waits (one PATCH) or, with nothing waiting, load; the answer replaces the\n * cache. One at a time per key; a request asked for while one runs follows it.\n */\nasync function sync(key: string): Promise<void> {\n  const account = accounts.get(key);\n  if (!account || !loaded.has(key)) return;\n  if (running.has(key)) {\n    rerun.add(key);\n    return;\n  }\n  if (typeof navigator !== \"undefined\" && navigator.onLine === false) return;\n  running.add(key);\n  const epoch = epochs.get(key) ?? 0;\n  try {\n    const waiting = readPending(key);\n    if (waiting && hasWork(waiting)) {\n      if (parked.has(key)) return;\n      const body: TourProgressBody = {};\n      if (Object.keys(waiting.completed).length > 0) body.completed = { ...waiting.completed };\n      if (waiting.forget.length > 0) body.forget = [...waiting.forget];\n      let answer: { completed: TourProgressWire };\n      try {\n        answer = await account.save(body);\n      } catch (error) {\n        const status = httpStatusOf(error);\n        if (status === 403 || status === 422) {\n          // Refused for good (a demo, a malformed or full record): dropped, not retried.\n          if ((epochs.get(key) ?? 0) === epoch) clearSent(key, body, false);\n          console.warn(`[ui-kit] tour progress: the account refused the pending record (${status}); dropped.`, error);\n        } else if (status === 402) {\n          // A lapsed plan refuses every write: kept, but not re-sent after each finish\n          // and each `online` — the next session or page load tries again.\n          parked.add(key);\n        }\n        // No answer (offline, 5xx, 401): it stays for the next load or `online`.\n        return;\n      }\n      if ((epochs.get(key) ?? 0) !== epoch) return;\n      clearSent(key, body, true);\n      refill(key, answer);\n    } else {\n      const answer = await account.load();\n      if ((epochs.get(key) ?? 0) !== epoch) return;\n      if (waiting && !waiting.synced) writePending(key, { ...waiting, synced: true });\n      else if (!waiting) writePending(key, { synced: true, completed: {}, forget: [] });\n      refill(key, answer);\n    }\n  } catch {\n    // A load that failed keeps the cache as it is.\n  } finally {\n    running.delete(key);\n    if (rerun.delete(key)) void sync(key);\n  }\n}\n\n/**\n * The end of a session (§10.2.6) — sign-out, a 401 nothing could renew, the account's\n * deletion, every path: removes the CACHE only (the device key and the page's snapshot;\n * every reader in this tab moves), synchronously and with no request, and KEEPS\n * `<storageKey>:pending`. That record sits under this person's own key, holds tour ids and\n * dates only, and goes out on their next sign-in. An answer still on its way is ignored.\n *\n *     function logout() { …; signOutTourProgress(`app.tours:${user.id}`); }\n */\nexport function signOutTourProgress(storageKey: string): void {\n  epochs.set(storageKey, (epochs.get(storageKey) ?? 0) + 1);\n  loaded.delete(storageKey);\n  rerun.delete(storageKey);\n  parked.delete(storageKey);\n  removeStored(storageKey);\n  memory.delete(storageKey);\n  cache.delete(storageKey);\n  emit(storageKey);\n}\n\nfunction subscribe(key: string, listener: () => void): () => void {\n  let set = listeners.get(key);\n  if (!set) listeners.set(key, (set = new Set()));\n  set.add(listener);\n  // Another tab wrote (or cleared all storage: `key` null).\n  const onStorage = (event: StorageEvent) => {\n    if (event.key !== null && event.key !== key) return;\n    memory.delete(key);\n    listener();\n  };\n  if (typeof window !== \"undefined\") window.addEventListener(\"storage\", onStorage);\n  return () => {\n    set.delete(listener);\n    if (typeof window !== \"undefined\") window.removeEventListener(\"storage\", onStorage);\n  };\n}\n\n/**\n * Forget every tour completion under `storageKey` on this device: the stored key, what the\n * page kept in memory where storage refused it, and every reader in this tab moves at\n * once. For \"Reset this device's settings\" (settings §11):\n *\n *     registerDeviceSetting({ key: TOUR_KEY, kind: \"view\", reset: () => resetTourProgress(TOUR_KEY) });\n *\n * With an account (0.45) it clears the cache only: the account is never written, the\n * pending record stays (\"anything waiting to be sent\", settings §11.2.2) and the next load\n * refills the cache. Tour progress is never registered with the device reset (§10.2.8).\n */\nexport function resetTourProgress(storageKey: string): void {\n  if (accounts.has(storageKey)) loaded.delete(storageKey);\n  removeStored(storageKey);\n  memory.delete(storageKey);\n  cache.delete(storageKey);\n  emit(storageKey);\n}\n\n/**\n * Record a completion under `storageKey`, as {@link TourProgress.complete} does: through\n * the one shared store and snapshot (never a copy), so every reader of the key moves.\n * Returns `true` when it counts anew. `TourProvider` calls this on a tour's last step.\n * @internal Not part of the barrel.\n */\nexport function completeStored(\n  storageKey: string,\n  migrate: UseTourProgressOptions[\"migrate\"],\n  tour: CompletedTour,\n): boolean {\n  const subject = typeof tour === \"string\" ? { id: tour } : tour;\n  // Read now rather than from a render: two completions in one handler both count.\n  const current = readForWrite(storageKey, migrate);\n  if (isTourDone(subject, current[subject.id])) return false;\n  const at = new Date().toISOString();\n  write(storageKey, { ...current, [subject.id]: at });\n  if (accounts.has(storageKey)) {\n    markPending(storageKey, subject.id, at);\n    queueSync(storageKey);\n  }\n  return true;\n}\n\n/** \"Mark as not done\" (§10.2.8): off the cache, and `forget` to the account. @internal */\nfunction resetStored(storageKey: string, migrate: UseTourProgressOptions[\"migrate\"], id: string) {\n  const current = snapshot(storageKey, migrate);\n  if (current[id] === undefined) return;\n  const next = { ...current };\n  delete next[id];\n  write(storageKey, next);\n  if (accounts.has(storageKey)) {\n    markPending(storageKey, id, undefined, true);\n    queueSync(storageKey);\n  }\n}\n\n/**\n * Write a completion from outside a page (§9.2): for an app's tests, seeds and scripts,\n * beside {@link resetTourProgress}. It writes the kit's stored shape (`{[id]: ISO | \"\"}`)\n * under `storageKey`, keeps the other tours' marks, and notifies every reader of the key\n * in this tab directly (the `storage` event reaches only OTHER tabs), so a mounted\n * `useTourProgress` or `TourCatalogue` moves at once.\n *\n * Unlike `complete`, it always writes (over a readable text; see below): `at` is the\n * completion's instant (an ISO string or a `Date`, default now), `null` a completion\n * without a date (stored as `\"\"`, read back as `null`).\n *\n *     completeTour(TOUR_KEY, \"budget\", \"2026-09-01T10:00:00Z\");\n *\n * A stored text in an app's older shape is read through `opts.migrate`, or else the\n * migrate a reader or the provider registered for the key. If the text is neither empty\n * nor the kit's shape and no migrate reads it, this THROWS and writes nothing (B-1):\n *\n *     completeTour(TOUR_KEY, \"budget\", undefined, { migrate: fromZustand });\n *\n * With an account on the key (0.45) it stays a device write — no request — and is marked\n * pending, so the next load sends it.\n */\nexport function completeTour(\n  storageKey: string,\n  tour: string | { id: string },\n  at?: string | Date | null,\n  opts?: { migrate?: UseTourProgressOptions[\"migrate\"] },\n): void {\n  const id = typeof tour === \"string\" ? tour : tour.id;\n  const when = at === null ? null : at instanceof Date ? at.toISOString() : (at ?? new Date().toISOString());\n  write(storageKey, { ...readForWrite(storageKey, opts?.migrate, true), [id]: when });\n  if (accounts.has(storageKey)) markPending(storageKey, id, when);\n}\n\n/** The device's tour completions under `storageKey`; see {@link UseTourProgressOptions}. */\nexport function useTourProgress({ storageKey, migrate, account }: UseTourProgressOptions): TourProgress {\n  // Held, not depended on: an inline arrow is a new function every render, and neither the\n  // snapshot nor the callbacks may change with it.\n  const migrateRef = useRef(migrate);\n  useEffect(() => {\n    migrateRef.current = migrate;\n  });\n  // The first account for the key wins (as `migrate`); its first reader on the page loads.\n  const accountRef = useRef(account);\n  useEffect(() => {\n    accountRef.current = account;\n  });\n  useEffect(() => {\n    if (rememberAccount(storageKey, accountRef.current)) ensureLoaded(storageKey);\n  }, [storageKey]);\n  const completed = useSyncExternalStore(\n    useCallback((listener: () => void) => subscribe(storageKey, listener), [storageKey]),\n    () => snapshot(storageKey, migrateRef.current),\n    () => EMPTY,\n  );\n\n  const complete = useCallback(\n    (tour: CompletedTour) => completeStored(storageKey, migrateRef.current, tour),\n    [storageKey],\n  );\n\n  const reset = useCallback((id: string) => resetStored(storageKey, migrateRef.current, id), [storageKey]);\n\n  return useMemo(() => ({ completed, complete, reset }), [completed, complete, reset]);\n}\n"],"mappings":"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","names":[]}

package/dist/tour.d.ts

@@ -3,7 +3,9 @@ export { TourCatalogue, TourCatalogueCard, DEFAULT_TOUR_CATALOGUE_LABELS } from
 export type { TourCatalogueProps, TourCatalogueCardProps, TourCatalogueLabels } from "./tour/tour-catalogue.js";
 export { isTourNew, isTourReset, isTourDone, doneCount, earnedPoints } from "./tour/tour-info.js";
 export type { TourInfo, TourGroup, TourUpdate, TourCompletions } from "./tour/tour-info.js";
-export { useTourProgress, resetTourProgress } from "./tour/use-tour-progress.js";
+export { useTourProgress, resetTourProgress, completeTour } from "./tour/use-tour-progress.js";
 export type { UseTourProgressOptions, TourProgress } from "./tour/use-tour-progress.js";
+export { signOutTourProgress } from "./tour/use-tour-progress.js";
+export type { TourProgressAccount, TourProgressAdopt, TourProgressBody } from "./tour/use-tour-progress.js";
 export { useTourUrlSync, useTourCatalogueUrlState } from "./tour/use-tour-url-sync.js";
 export type { UseTourUrlSyncOptions, TourCatalogueFilter, TourStateFilter } from "./tour/use-tour-url-sync.js";

package/dist/tour.js

@@ -2,18 +2,21 @@
 export * from "./tour/tour.js";
 import { TourCatalogue, TourCatalogueCard, DEFAULT_TOUR_CATALOGUE_LABELS } from "./tour/tour-catalogue.js";
 import { isTourNew, isTourReset, isTourDone, doneCount, earnedPoints } from "./tour/tour-info.js";
-import { useTourProgress, resetTourProgress } from "./tour/use-tour-progress.js";
+import { useTourProgress, resetTourProgress, completeTour } from "./tour/use-tour-progress.js";
+import { signOutTourProgress } from "./tour/use-tour-progress.js";
 import { useTourUrlSync, useTourCatalogueUrlState } from "./tour/use-tour-url-sync.js";
 export {
   DEFAULT_TOUR_CATALOGUE_LABELS,
   TourCatalogue,
   TourCatalogueCard,
+  completeTour,
   doneCount,
   earnedPoints,
   isTourDone,
   isTourNew,
   isTourReset,
   resetTourProgress,
+  signOutTourProgress,
   useTourCatalogueUrlState,
   useTourProgress,
   useTourUrlSync

package/dist/tour.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/tour.ts"],"sourcesContent":["// `@eifi1/ui-kit/tour` — guided tours.\n// A re-slicing of the main barrel, not a new API.\nexport * from \"./tour/tour\";\n// 0.43.0: the tours page (docs/tours-harmonization.md §3, §8) — keksdose's catalogue, its\n// card, the NEW and reset rules, device progress and the URL. `useTourUrlSync` and\n// `useTourCatalogueUrlState` need react-router (a peer already, for /shell).\nexport { TourCatalogue, TourCatalogueCard, DEFAULT_TOUR_CATALOGUE_LABELS } from \"./tour/tour-catalogue\";\nexport type { TourCatalogueProps, TourCatalogueCardProps, TourCatalogueLabels } from \"./tour/tour-catalogue\";\nexport { isTourNew, isTourReset, isTourDone, doneCount, earnedPoints } from \"./tour/tour-info\";\nexport type { TourInfo, TourGroup, TourUpdate, TourCompletions } from \"./tour/tour-info\";\nexport { useTourProgress, resetTourProgress } from \"./tour/use-tour-progress\";\nexport type { UseTourProgressOptions, TourProgress } from \"./tour/use-tour-progress\";\nexport { useTourUrlSync, useTourCatalogueUrlState } from \"./tour/use-tour-url-sync\";\nexport type { UseTourUrlSyncOptions, TourCatalogueFilter, TourStateFilter } from \"./tour/use-tour-url-sync\";\n"],"mappings":";AAEA,cAAc;AAId,SAAS,eAAe,mBAAmB,qCAAqC;AAEhF,SAAS,WAAW,aAAa,YAAY,WAAW,oBAAoB;AAE5E,SAAS,iBAAiB,yBAAyB;AAEnD,SAAS,gBAAgB,gCAAgC;","names":[]}
+{"version":3,"sources":["../src/tour.ts"],"sourcesContent":["// `@eifi1/ui-kit/tour` — guided tours.\n// A re-slicing of the main barrel, not a new API.\nexport * from \"./tour/tour\";\n// 0.43.0: the tours page (docs/tours-harmonization.md §3, §8) — keksdose's catalogue, its\n// card, the NEW and reset rules, device progress and the URL. `useTourUrlSync` and\n// `useTourCatalogueUrlState` need react-router (a peer already, for /shell).\nexport { TourCatalogue, TourCatalogueCard, DEFAULT_TOUR_CATALOGUE_LABELS } from \"./tour/tour-catalogue\";\nexport type { TourCatalogueProps, TourCatalogueCardProps, TourCatalogueLabels } from \"./tour/tour-catalogue\";\nexport { isTourNew, isTourReset, isTourDone, doneCount, earnedPoints } from \"./tour/tour-info\";\nexport type { TourInfo, TourGroup, TourUpdate, TourCompletions } from \"./tour/tour-info\";\n// 0.44.0: the writer outside a page (§9.2).\nexport { useTourProgress, resetTourProgress, completeTour } from \"./tour/use-tour-progress\";\nexport type { UseTourProgressOptions, TourProgress } from \"./tour/use-tour-progress\";\n// 0.45.0: progress on the account (§10.2–§10.3) and the end of a session.\nexport { signOutTourProgress } from \"./tour/use-tour-progress\";\nexport type { TourProgressAccount, TourProgressAdopt, TourProgressBody } from \"./tour/use-tour-progress\";\nexport { useTourUrlSync, useTourCatalogueUrlState } from \"./tour/use-tour-url-sync\";\nexport type { UseTourUrlSyncOptions, TourCatalogueFilter, TourStateFilter } from \"./tour/use-tour-url-sync\";\n"],"mappings":";AAEA,cAAc;AAId,SAAS,eAAe,mBAAmB,qCAAqC;AAEhF,SAAS,WAAW,aAAa,YAAY,WAAW,oBAAoB;AAG5E,SAAS,iBAAiB,mBAAmB,oBAAoB;AAGjE,SAAS,2BAA2B;AAEpC,SAAS,gBAAgB,gCAAgC;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eifi1/ui-kit",
-  "version": "0.43.0",
+  "version": "0.45.0",
   "type": "module",
   "description": "App-agnostic shared design system: domain-free React components, theme and tokens.",
   "_sideEffects": "The barrel (src/index.ts) re-exports EVERY component, including components/chart, which statically imports recharts. Without this field a bundler must assume each of those modules has side effects, so it cannot drop the unused ones: importing a Button from '@eifi1/ui-kit' dragged all 433KB of recharts into the consumer's ENTRY chunk, and Keksdose was preloading it on every page load, login included. Nothing in src/ imports for side effects (no bare imports, no CSS imports from JS, no module-level global writes) — the token stylesheet is its own './tokens.css' export — so this is safe. CSS is still listed so any future stylesheet survives. Re-checked when `flag-icons` left `dependencies` and tsup started emitting a `\"use client\"` banner: neither touches this. The flag stylesheet was never imported from JS in the first place (that was the finding), and a directive prologue is a string literal every bundler lifts out before it decides whether a module is inert.",
@@ -64,6 +64,10 @@
       "types": "./dist/rhf.d.ts",
       "import": "./dist/rhf.js"
     },
+    "./offline": {
+      "types": "./dist/offline.d.ts",
+      "import": "./dist/offline.js"
+    },
     "./i18n/*": {
       "types": "./dist/i18n/locales/*.d.ts",
       "import": "./dist/i18n/locales/*.js"
@@ -112,6 +116,10 @@
     "deps:outdated": "npm outdated || true"
   },
   "peerDependencies": {
+    "@tanstack/query-async-storage-persister": "^5",
+    "@tanstack/react-query": "^5",
+    "@tanstack/react-query-persist-client": "^5",
+    "idb-keyval": "^6",
     "lucide-react": ">=0.400.0 <2",
     "modern-screenshot": "^4.7.0",
     "react": ">=19.2",
@@ -122,6 +130,18 @@
     "sonner": ">=2"
   },
   "peerDependenciesMeta": {
+    "@tanstack/query-async-storage-persister": {
+      "optional": true
+    },
+    "@tanstack/react-query": {
+      "optional": true
+    },
+    "@tanstack/react-query-persist-client": {
+      "optional": true
+    },
+    "idb-keyval": {
+      "optional": true
+    },
     "modern-screenshot": {
       "optional": true
     },
@@ -141,6 +161,9 @@
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@tailwindcss/vite": "^4.3.3",
+    "@tanstack/query-async-storage-persister": "^5.104.1",
+    "@tanstack/react-query": "^5.104.1",
+    "@tanstack/react-query-persist-client": "^5.104.1",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.0",
     "@testing-library/user-event": "^14.6.7",
@@ -159,6 +182,7 @@
     "flag-icons": "^7.5.0",
     "globals": "^17.12.0",
     "husky": "^9.1.7",
+    "idb-keyval": "^6.2.6",
     "jsdom": "^30.0.1",
     "lucide-react": "^1.47.0",
     "modern-screenshot": "^4.7.0",

package/src/admin/admin-action-log-labels.ts

@@ -33,11 +33,14 @@ export const DEFAULT_ADMIN_ACTION_LOG_LABELS: AdminActionLogLabels = {
     erase: "Account erased",
     plan: "Plan changed",
   },
+  renamedFromTo: (from, to) => `from ${from} to ${to}`,
   groupActions: {
     group: {
       group_create: "Group created",
       group_rename: "Group renamed",
       group_delete: "Group deleted",
+      group_deactivate: "Group deactivated",
+      group_reactivate: "Group reactivated",
       membership_add: "Added to the group",
       membership_role: "Role in the group changed",
       membership_remove: "Removed from the group",
@@ -47,6 +50,8 @@ export const DEFAULT_ADMIN_ACTION_LOG_LABELS: AdminActionLogLabels = {
       group_create: "Team created",
       group_rename: "Team renamed",
       group_delete: "Team deleted",
+      group_deactivate: "Team deactivated",
+      group_reactivate: "Team reactivated",
       membership_add: "Added to the team",
       membership_role: "Role in the team changed",
       membership_remove: "Removed from the team",
@@ -56,6 +61,8 @@ export const DEFAULT_ADMIN_ACTION_LOG_LABELS: AdminActionLogLabels = {
       group_create: "Company created",
       group_rename: "Company renamed",
       group_delete: "Company deleted",
+      group_deactivate: "Company deactivated",
+      group_reactivate: "Company reactivated",
       membership_add: "Added to the company",
       membership_role: "Role in the company changed",
       membership_remove: "Removed from the company",
@@ -65,6 +72,8 @@ export const DEFAULT_ADMIN_ACTION_LOG_LABELS: AdminActionLogLabels = {
       group_create: "Budget created",
       group_rename: "Budget renamed",
       group_delete: "Budget deleted",
+      group_deactivate: "Budget deactivated",
+      group_reactivate: "Budget reactivated",
       membership_add: "Added to the budget",
       membership_role: "Role in the budget changed",
       membership_remove: "Removed from the budget",

package/src/admin/admin-action-log.tsx

@@ -72,7 +72,11 @@ export type AdminActionKind =
   | "group_rename"
   | "group_delete"
   | "membership_add"
-  | "membership_role";
+  | "membership_role"
+  // 0.45 (admin §9.1.3): a group switched off or on again — kastlan's company PATCH
+  // (`is_active`). server-kit 0.15's `AdminAction.GROUP_DEACTIVATE` / `GROUP_REACTIVATE`.
+  | "group_deactivate"
+  | "group_reactivate";
 
 /** Every {@link AdminActionKind}, in the contract's order. */
 export const ADMIN_ACTION_KINDS: readonly AdminActionKind[] = [
@@ -98,6 +102,8 @@ export const ADMIN_ACTION_KINDS: readonly AdminActionKind[] = [
   "group_delete",
   "membership_add",
   "membership_role",
+  "group_deactivate",
+  "group_reactivate",
 ];
 
 /** The app's word for its groups (§11.5): Kurvenschmiede's teams, kastlan's companies,
@@ -105,11 +111,14 @@ export const ADMIN_ACTION_KINDS: readonly AdminActionKind[] = [
  *  actions are said in. */
 export type AdminGroupNoun = "group" | "team" | "company" | "budget";
 
-/** The kinds said in the noun's words: the five of 0.34, and `membership_remove`. */
+/** The kinds said in the noun's words: the five of 0.34, `membership_remove`, and 0.45's
+ *  `group_deactivate` / `group_reactivate`. */
 type AdminGroupActionKind =
   | "group_create"
   | "group_rename"
   | "group_delete"
+  | "group_deactivate"
+  | "group_reactivate"
   | "membership_add"
   | "membership_role"
   | "membership_remove";
@@ -118,6 +127,8 @@ const GROUP_ACTION_KINDS: ReadonlySet<string> = new Set<AdminGroupActionKind>([
   "group_create",
   "group_rename",
   "group_delete",
+  "group_deactivate",
+  "group_reactivate",
   "membership_add",
   "membership_role",
   "membership_remove",
@@ -184,6 +195,13 @@ export interface AdminActionLogEntry {
   group?: AdminGroupTarget | null;
   /** The `detail` in the app's words — "Member → Admin", "12 items to Ben Example". */
   detail?: ReactNode;
+  /**
+   * 0.45 (admin §9.4, Marcel 2026-10-19): a `group_rename` row's `detail.{from, to}` —
+   * kastlan's company rename logs both names. With both, the row reads "Company renamed
+   * from A to B" (`renamedFromTo`) in place of the target. A rename that logs `{}` (KS's
+   * team rename: never a name) leaves it out and reads "Team renamed" and the group.
+   */
+  renamed?: { from?: string | null; to?: string | null } | null;
 }
 
 /** The `adminActionLog` namespace. */
@@ -206,6 +224,8 @@ export interface AdminActionLogLabels {
   showAll: string;
   /** A target name as a filter button — "Show only the actions on Ada Example". */
   filterBy: (target: string) => string;
+  /** 0.45: after "Company renamed" when the row carries both names — "from A to B". */
+  renamedFromTo: (from: string, to: string) => string;
   /** What each action is called, past tense, keyed by the vocabulary. An app adds its
    *  own here (`labels={{ actions: { plan: "Plan changed" } }}`). A word given here
    *  outranks the noun's in `groupActions` — so no catalogue holds the group kinds
@@ -223,6 +243,11 @@ interface AdminGroupActionLabels {
   group_rename: string;
   /** "Team deleted". */
   group_delete: string;
+  /** "Company deactivated" (0.45, admin §9.1.3): the group switched off — its people
+   *  locked out — not a person's `deactivate`. */
+  group_deactivate: string;
+  /** "Company reactivated" (0.45). */
+  group_reactivate: string;
   /** "Added to the team" — said of the person, so it agrees with the account where a
    *  language agrees (es "Añadida", fr "Ajouté"). */
   membership_add: string;
@@ -384,12 +409,22 @@ export function AdminActionLog({
           aria-busy={loading || undefined}
           className={cn("divide-y divide-subtle", loading && "opacity-60")}
         >
-          {entries.map((entry) => (
+          {entries.map((entry) => {
+            const from = (entry.renamed?.from ?? "").trim();
+            const to = (entry.renamed?.to ?? "").trim();
+            const renamed = entry.action === "group_rename" && from !== "" && to !== "";
+            return (
             <li key={entry.id} data-action={entry.action} className="space-y-0.5 py-2 first:pt-0 last:pb-0">
               <div className="flex flex-wrap items-baseline justify-between gap-x-3 gap-y-0.5">
                 <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-0.5 text-sm">
                   <span className="font-medium text-primary">{actionText(entry.action)}</span>
-                  {entry.target !== undefined && <span className="min-w-0 break-words">{targetNode(entry)}</span>}
+                  {renamed ? (
+                    <span data-private data-renamed className="min-w-0 break-words text-primary">
+                      {labels.renamedFromTo(from, to)}
+                    </span>
+                  ) : (
+                    entry.target !== undefined && <span className="min-w-0 break-words">{targetNode(entry)}</span>
+                  )}
                   {entry.group && (
                     <span data-group className="min-w-0 break-words text-xs text-muted">
                       {groupText(entry.group)}
@@ -410,7 +445,8 @@ export function AdminActionLog({
                 )}
               </div>
             </li>
-          ))}
+            );
+          })}
         </ol>
       )}
       {paging && paging.total > 0 && (

package/src/admin/admin-area-labels.ts

@@ -32,6 +32,12 @@ export interface AdminAreaLabels {
   /** The row's waiting count, for a reader ("Administration, 3 waiting"); the eye sees
    *  the number in the badge. */
   waiting: (count: number) => string;
+  /**
+   * 0.45 (admin §9.3.4): a button's whole name with its count — "Platform, 2 waiting" —
+   * for an `IconButton` whose `badge` is an `AdminWaitingBadge`: the badge is decorative
+   * there, so the name carries the count. `label` is the button's own name.
+   */
+  waitingLabel: (label: string, count: number) => string;
   /** The 403 page's heading (§2.2 decision 8). */
   forbiddenTitle: string;
   /**
@@ -59,6 +65,7 @@ export interface AdminAreaLabels {
 export const DEFAULT_ADMIN_AREA_LABELS: AdminAreaLabels = {
   title: "Administration",
   waiting: (count) => `${count} waiting`,
+  waitingLabel: (label, count) => `${label}, ${count} waiting`,
   forbiddenTitle: "Only for administrators",
   forbiddenBody: (appName) => `This is where administrators run ${appName}. Your account cannot open this page.`,
   forbiddenHome: "Go to the start page",

package/src/admin/mail-test-card-labels.ts

@@ -0,0 +1,19 @@
+// The English words of ./mail-test-card, in a module with no component code: the English
+// catalogue (src/i18n/defaults.ts) imports them without the component, so `en` loads as one
+// chunk like the other languages (0.34, KS U8). ./mail-test-card re-exports them.
+
+import { englishRateLimited } from "../auth/auth-errors";
+import type { MailTestCardLabels } from "./mail-test-card";
+
+/** docs/admin-harmonization.md §9.2.4, word for word. */
+export const DEFAULT_MAIL_TEST_CARD_LABELS: MailTestCardLabels = {
+  title: "Test mail",
+  description: "Sends one mail to your own address, through the transport this installation sends all its mail with.",
+  transport: (backend) => `Transport: ${backend}`,
+  action: "Send a test mail to me",
+  sent: (address) => `Sent to ${address}. Check the inbox.`,
+  console: "The console transport only logs mail; nothing was sent.",
+  failed: "Could not send. The server log has the provider’s answer.",
+  rateLimited: englishRateLimited,
+  keywords: "test mail email e-mail transport smtp resend console send deliver",
+};

package/src/admin/mail-test-card.tsx

@@ -0,0 +1,186 @@
+import { useState } from "react";
+import type { ReactNode } from "react";
+import { Send } from "lucide-react";
+
+import { useKitLabels, type LabelOverride } from "../i18n/kit-labels";
+import { isRateLimited, retryAfterSeconds } from "../auth/auth-errors";
+import { AlertBanner } from "../components/alert-banner";
+import { Button } from "../components/button";
+import { Chip } from "../components/chip";
+import { SettingsSection, type SettingsSectionProps } from "../settings/settings-section";
+import { DEFAULT_MAIL_TEST_CARD_LABELS } from "./mail-test-card-labels";
+
+/* ── Labels ──────────────────────────────────────────────────────────────── */
+
+/** Every string {@link MailTestCard} renders — the `mailTestCard` namespace of
+ *  `<UiKitProvider labels>`, overridable per instance through `labels`
+ *  (docs/admin-harmonization.md §9.2.4). */
+export interface MailTestCardLabels {
+  /** The card's title, and the app's catalogue entry's. */
+  title: string;
+  /** The sentence under it. */
+  description: string;
+  /** The transport's chip: "Transport: resend". `backend` is the server's `mail_backend`. */
+  transport: (backend: string) => string;
+  /** The button. */
+  action: string;
+  /** The answer said "sent" through a real transport. `address` is masked ("a…@example.com"). */
+  sent: (address: string) => string;
+  /** `mail_backend` is `console`: said whatever `sent` is — a console answers `true`. */
+  console: string;
+  /** Not sent, or the request failed. The provider's error stays in the server log. */
+  failed: string;
+  /** HTTP 429 — the app's limiter (server-kit's `MAIL_TEST_LIMIT`, 3 per 10 minutes);
+   *  `seconds` from `Retry-After` when the response has one. */
+  rateLimited: (seconds?: number) => string;
+  /** For the app's catalogue entry (`keywords`); the card never reads it. */
+  keywords: string;
+}
+
+// Defined in ./mail-test-card-labels, which holds no component code.
+export { DEFAULT_MAIL_TEST_CARD_LABELS };
+
+/* ── The card ────────────────────────────────────────────────────────────── */
+
+/** The answer of `POST /admin/mail/test` — server-kit 0.15's `MailTestResult`. */
+export interface MailTestAnswer {
+  sent: boolean;
+  /** The transport that took it: `console`, `resend`, `smtp`, … */
+  mail_backend: string;
+}
+
+/** The card's default DOM id: its catalogue entry's `anchor`, the `?focus=` target. */
+export const MAIL_TEST_ANCHOR = "admin-mail-test";
+
+export interface MailTestCardProps
+  extends Omit<SettingsSectionProps, "anchor" | "title" | "description" | "children"> {
+  /** The installation's transport, as the admin page has it (`mail_backend`): the chip
+   *  before a send. After one, the answer's. */
+  mailBackend: string;
+  /** The app's `POST /admin/mail/test` (kastlan `/platform/mail/test`), no body: it
+   *  awaits the app's own send and answers `{sent, mail_backend}`. A rejection is read
+   *  for a 429 (the limiter); anything else is "could not send". */
+  send: () => Promise<MailTestAnswer>;
+  /** The signed-in admin's own address — where the mail goes. Shown masked. */
+  address: string;
+  /** Default {@link MAIL_TEST_ANCHOR}; the app's catalogue entry names the same. */
+  anchor?: string;
+  /** The app's sentence after the kit's description. */
+  description?: ReactNode;
+  labels?: LabelOverride<MailTestCardLabels>;
+}
+
+/**
+ * An address with its local part masked to its first character: "ada@example.com" →
+ * "a…@example.com". The domain stays, so the admin sees which mailbox to open.
+ */
+export function maskMailAddress(address: string): string {
+  const text = address.trim();
+  const at = text.lastIndexOf("@");
+  if (at <= 0) return text === "" ? "" : `${Array.from(text)[0]}…`;
+  return `${Array.from(text.slice(0, at))[0]}…${text.slice(at)}`;
+}
+
+type Outcome =
+  | { kind: "sent"; backend: string }
+  | { kind: "console"; backend: string }
+  | { kind: "failed"; backend?: string }
+  | { kind: "limited"; seconds?: number };
+
+/**
+ * "Send a test mail to me" (docs/admin-harmonization.md §9.2): a `SettingsSection` with a
+ * sentence, the transport as a chip, the button and the result line. One mail goes to the
+ * signed-in admin's own address, never another, through the app's own send.
+ *
+ * **The result line reads `mail_backend` first**: with `console` it says "nothing was sent"
+ * whatever `sent` is, since every console path answers `true` (§9.2 Today). Otherwise
+ * `sent` says "Sent to a…@example.com. Check the inbox." or "Could not send." — the
+ * provider's error stays in the server log (§9.2.7). A 429 says the limiter's line. The
+ * button is busy while the request runs; the line is a live region.
+ *
+ * Not a commit: the test writes nothing, so it is not under the write lock (a demo never
+ * reaches the admin area, and the server refuses it anyway). The app adds the catalogue
+ * entry `{ id, anchor: MAIL_TEST_ANCHOR, title, keywords }` from these labels.
+ */
+export function MailTestCard({
+  mailBackend,
+  send,
+  address,
+  anchor = MAIL_TEST_ANCHOR,
+  description,
+  labels: labelsProp,
+  ...rest
+}: MailTestCardProps) {
+  const labels = useKitLabels("mailTestCard", DEFAULT_MAIL_TEST_CARD_LABELS, labelsProp);
+  const [busy, setBusy] = useState(false);
+  const [outcome, setOutcome] = useState<Outcome | null>(null);
+
+  const run = async () => {
+    if (busy) return;
+    setBusy(true);
+    setOutcome(null);
+    try {
+      const answer = await send();
+      const backend = answer.mail_backend;
+      if (backend === "console") setOutcome({ kind: "console", backend });
+      else setOutcome(answer.sent ? { kind: "sent", backend } : { kind: "failed", backend });
+    } catch (error) {
+      setOutcome(isRateLimited(error) ? { kind: "limited", seconds: retryAfterSeconds(error) } : { kind: "failed" });
+    } finally {
+      setBusy(false);
+    }
+  };
+
+  const backend = outcome && "backend" in outcome && outcome.backend ? outcome.backend : mailBackend;
+
+  return (
+    <SettingsSection
+      {...rest}
+      anchor={anchor}
+      title={labels.title}
+      description={
+        description != null ? (
+          <>
+            {labels.description} {description}
+          </>
+        ) : (
+          labels.description
+        )
+      }
+    >
+      <div className="space-y-2">
+        <div className="flex flex-wrap items-center gap-2">
+          <Button variant="secondary" pending={busy} onClick={() => void run()}>
+            <Send className="size-4" aria-hidden />
+            {labels.action}
+          </Button>
+          {backend && (
+            <Chip size="sm" data-slot="mail-backend">
+              {labels.transport(backend)}
+            </Chip>
+          )}
+        </div>
+        {outcome?.kind === "sent" && (
+          <AlertBanner variant="inline" block tone="success">
+            <span data-private>{labels.sent(maskMailAddress(address))}</span>
+          </AlertBanner>
+        )}
+        {outcome?.kind === "console" && (
+          <AlertBanner variant="inline" block tone="info">
+            {labels.console}
+          </AlertBanner>
+        )}
+        {outcome?.kind === "failed" && (
+          <AlertBanner variant="inline" block tone="danger">
+            {labels.failed}
+          </AlertBanner>
+        )}
+        {outcome?.kind === "limited" && (
+          <AlertBanner variant="inline" block tone="warning">
+            {labels.rateLimited(outcome.seconds)}
+          </AlertBanner>
+        )}
+      </div>
+    </SettingsSection>
+  );
+}

package/src/billing/provider-page.ts

@@ -39,6 +39,15 @@ export interface OpenProviderPageOptions {
  *     />
  *
  * Resolves with the way it went.
+ *
+ * **The test seam is `options.window`** (docs/tours-harmonization.md §9.5, kk 7): an app's
+ * test passes a stub with `open` (returning a fake tab, or `null` for a blocked pop-up)
+ * and `location.assign`, instead of patching the global `window`:
+ *
+ *     const tab = { opener: {}, closed: false, location: { href: "" }, close: vi.fn() };
+ *     const win = { open: vi.fn(() => tab), location: { assign: vi.fn() } } as unknown as Window;
+ *     await openProviderPage(async () => "https://pay.example/portal", { window: win });
+ *     expect(tab.location.href).toBe("https://pay.example/portal");
  */
 export async function openProviderPage(
   fetchUrl: () => Promise<string>,