@freighttech/ui 0.13.18

package/dist/backend/dynamic-table/hooks/useDensityPreference.js

@@ -0,0 +1,203 @@
+"use client";
+import * as React from "react";
+import { apiCall } from "@freighttech/ui/backend/utils/apiCall";
+import { getCurrentOrganizationScope } from "@open-mercato/shared/lib/frontend/organizationEvents";
+import { DEFAULT_DENSITY, isDensityLevel } from "../types/density.js";
+const DENSITY_STORAGE_PREFIX = "fms.dt.density";
+const DENSITY_SCOPE_CACHE_KEY = "fms.dt.uid";
+const FALLBACK_SCOPE = "shared";
+function keyFor(scope) {
+  return `${DENSITY_STORAGE_PREFIX}:${scope}`;
+}
+const listeners = /* @__PURE__ */ new Set();
+const levels = /* @__PURE__ */ new Map();
+let currentLevel = DEFAULT_DENSITY;
+let currentScope = null;
+let scopeFromCache = false;
+let hydrated = false;
+let storageListenerAttached = false;
+function emit() {
+  for (const listener of Array.from(listeners)) listener();
+}
+function readRaw(key) {
+  try {
+    const raw = window.localStorage.getItem(key);
+    return isDensityLevel(raw) ? raw : null;
+  } catch {
+    return null;
+  }
+}
+function writeRaw(key, level) {
+  try {
+    window.localStorage.setItem(key, level);
+  } catch {
+  }
+}
+function syncScope() {
+  try {
+    const cached = window.localStorage.getItem(DENSITY_SCOPE_CACHE_KEY);
+    if (cached) return { scope: cached, fromCache: true };
+  } catch {
+  }
+  let org = null;
+  try {
+    org = getCurrentOrganizationScope().organizationId;
+  } catch {
+  }
+  return { scope: org || FALLBACK_SCOPE, fromCache: false };
+}
+function hydrate() {
+  if (hydrated) return;
+  hydrated = true;
+  if (typeof window === "undefined") return;
+  const resolved = syncScope();
+  currentScope = resolved.scope;
+  scopeFromCache = resolved.fromCache;
+  currentLevel = readRaw(keyFor(resolved.scope)) ?? DEFAULT_DENSITY;
+}
+function onStorage(event) {
+  const watched = keyFor(currentScope ?? FALLBACK_SCOPE);
+  if (event.key !== null && event.key !== watched) return;
+  const next = readRaw(watched) ?? DEFAULT_DENSITY;
+  if (next === currentLevel) return;
+  currentLevel = next;
+  emit();
+}
+function getDensityPreference(tableKey) {
+  if (!hydrated) hydrate();
+  if (!tableKey) return currentLevel;
+  const own = levels.get(tableKey);
+  if (own) return own;
+  const stored = typeof window !== "undefined" ? readRaw(`${keyFor(currentScope ?? FALLBACK_SCOPE)}:${tableKey}`) : null;
+  if (stored) {
+    levels.set(tableKey, stored);
+    return stored;
+  }
+  return currentLevel;
+}
+function getServerDensityPreference() {
+  return DEFAULT_DENSITY;
+}
+function subscribeDensityPreference(listener) {
+  listeners.add(listener);
+  if (!storageListenerAttached && typeof window !== "undefined") {
+    storageListenerAttached = true;
+    window.addEventListener("storage", onStorage);
+  }
+  return () => {
+    listeners.delete(listener);
+  };
+}
+function setDensityPreference(level, tableKey) {
+  if (!isDensityLevel(level)) return;
+  hydrate();
+  const base = keyFor(currentScope ?? FALLBACK_SCOPE);
+  if (tableKey) {
+    if (levels.get(tableKey) === level) return;
+    levels.set(tableKey, level);
+    if (typeof window !== "undefined") writeRaw(`${base}:${tableKey}`, level);
+    emit();
+    return;
+  }
+  if (currentLevel === level) return;
+  currentLevel = level;
+  if (typeof window !== "undefined") writeRaw(base, level);
+  emit();
+}
+let identityPromise = null;
+function ensureDensityScope() {
+  if (identityPromise) return identityPromise;
+  identityPromise = (async () => {
+    if (typeof window === "undefined") return;
+    hydrate();
+    const painted = currentScope ?? FALLBACK_SCOPE;
+    const paintedFromCache = scopeFromCache;
+    let uid = null;
+    try {
+      const res = await apiCall("/api/auth/feature-check", {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ features: [] })
+      });
+      if (res.ok && typeof res.result?.userId === "string" && res.result.userId) {
+        uid = res.result.userId;
+      }
+    } catch {
+      return;
+    }
+    if (!uid || uid === painted) {
+      if (uid) {
+        try {
+          window.localStorage.setItem(DENSITY_SCOPE_CACHE_KEY, uid);
+        } catch {
+        }
+      }
+      return;
+    }
+    try {
+      window.localStorage.setItem(DENSITY_SCOPE_CACHE_KEY, uid);
+    } catch {
+    }
+    const uidKey = keyFor(uid);
+    if (!paintedFromCache) {
+      const carried = readRaw(keyFor(painted));
+      if (carried && readRaw(uidKey) === null) writeRaw(uidKey, carried);
+    }
+    currentScope = uid;
+    scopeFromCache = true;
+    const next = readRaw(uidKey) ?? DEFAULT_DENSITY;
+    if (next !== currentLevel) {
+      currentLevel = next;
+      emit();
+    }
+  })();
+  return identityPromise;
+}
+function resetDensityPreferenceStore() {
+  listeners.clear();
+  currentLevel = DEFAULT_DENSITY;
+  currentScope = null;
+  scopeFromCache = false;
+  hydrated = false;
+  identityPromise = null;
+  if (storageListenerAttached && typeof window !== "undefined") {
+    window.removeEventListener("storage", onStorage);
+    storageListenerAttached = false;
+  }
+}
+function useDensityPreference(override, tableKey) {
+  const getSnapshot = React.useCallback(() => getDensityPreference(tableKey), [tableKey]);
+  const stored = React.useSyncExternalStore(
+    subscribeDensityPreference,
+    getSnapshot,
+    getServerDensityPreference
+  );
+  React.useEffect(() => {
+    void ensureDensityScope();
+  }, []);
+  const isOverridden = isDensityLevel(override);
+  const setDensity = React.useCallback(
+    (level) => {
+      if (isOverridden) return;
+      setDensityPreference(level, tableKey);
+    },
+    [isOverridden, tableKey]
+  );
+  return {
+    density: isOverridden ? override : stored,
+    setDensity,
+    isOverridden
+  };
+}
+export {
+  DENSITY_SCOPE_CACHE_KEY,
+  DENSITY_STORAGE_PREFIX,
+  ensureDensityScope,
+  getDensityPreference,
+  getServerDensityPreference,
+  resetDensityPreferenceStore,
+  setDensityPreference,
+  subscribeDensityPreference,
+  useDensityPreference
+};
+//# sourceMappingURL=useDensityPreference.js.map

package/dist/backend/dynamic-table/hooks/useDensityPreference.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/hooks/useDensityPreference.ts"],
+  "sourcesContent": ["'use client'\n\n/**\n * DENSITY PREFERENCE \u2014 persistence for the user-settable row/type density.\n *\n * \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n * DECISION 1 \u2014 localStorage, NOT the perspective / preference API.\n * \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n *\n * The 3 Aug 2026 INF workshops recorded a real incident (A3): a user changed\n * what she believed was her own view setting and changed it for the whole\n * organisation. Her reaction, verbatim:\n *\n *     \"Czyli jak tu porobi\u0142am, to porobi\u0142am wszystkim?\"  \u2014  \"Tak.\"\n *\n * That was received as a BUG, not as a feature. Density is the same class of\n * setting \u2014 it is about one person's eyes and one person's monitor \u2014 so the\n * single hardest requirement here is that it CANNOT leak between users.\n *\n * Weighing the two options honestly:\n *\n *   localStorage                         perspective API (/api/perspectives/:id)\n *   \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500    \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n *   + physically cannot leak to          \u2212 perspectives are a SHARED, server-held\n *     another user account: it is a        object; sharing one is a supported\n *     browser-profile-local store          feature, which is exactly the A3\n *                                          leak vector we must not re-open\n *   + zero server work, zero new         \u2212 needs an endpoint change, a migration\n *     endpoint, no migration               path and a review\n *   + synchronous on read \u2192 the grid     \u2212 a round trip before the first paint,\n *     paints at the right density          i.e. a visible comfortable\u2192dense flash\n *     without a request                    on every page load\n *   + testable today                     \u2212 being modified by a concurrent wave\n *                                          RIGHT NOW; depending on it creates a\n *                                          coupling that cannot be tested today\n *   \u2212 does not follow the user to a      + follows the user across machines\n *     second machine\n *\n * Only the last row favours the API, and it is the weakest of the six: density\n * is a function of the SCREEN you are sitting at. A user on a 27\" desk monitor\n * and a 13\" laptop plausibly wants different answers, so per-device is arguably\n * the more correct semantics rather than a compromise. RECOMMENDATION TAKEN:\n * localStorage.\n *\n * This mirrors `useColumnWidthPersistence`, which reached the same conclusion\n * for column widths and states it in the same terms (\"a per-device ergonomic\n * preference\"). We deliberately share its `fms.dt.uid` scope cache rather than\n * inventing a second one.\n *\n * If cross-machine sync is ever asked for, the shape to add is a per-USER\n * (never per-perspective, never per-organisation) settings row that seeds\n * localStorage on login \u2014 not a move of the read path onto the network.\n *\n * \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n * DECISION 2 \u2014 ONE setting across ALL grids, not per table.\n * \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n *\n * The storage key contains NO tableId. That is deliberate.\n *\n * Argued from how the two users in the workshop actually work:\n *\n *   \u2022 Klaudiusz lives in ONE wide table all day. For him per-table and global\n *     are indistinguishable \u2014 he would set it once either way. Per-table buys\n *     him nothing.\n *\n *   \u2022 Agnieszka moves between the container table, offers, invoices and\n *     folders. Per-table would make her set the same preference four times,\n *     and \u2014 worse \u2014 would leave her with grids at inconsistent densities that\n *     she never chose, because she only ever visited some of them. She would\n *     read that as the application being broken, which is precisely how A3\n *     was received.\n *\n * Density is a statement about the reader (my eyes, my monitor, how I scan),\n * not about the data. A statement about the reader has exactly one correct\n * scope: the reader.\n *\n * The obvious objection \u2014 \"a 4-column drawer sub-table does not need dense\" \u2014\n * costs nothing: a user who selected `dense` selected it because they can read\n * 11px, and a narrow table rendered dense is merely tidier. Where a table\n * genuinely must pin a level for structural reasons (a two-row summary strip),\n * that is a DEVELOPER decision, not a user preference, and it is expressed by\n * passing `override` \u2014 which is read-only and never written to storage.\n *\n * \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n * WHY A MODULE-LEVEL STORE RATHER THAN useState\n * \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n *\n * A page can mount several grids at once (a list plus a drawer sub-table).\n * With `useState` per hook, changing density in the toolbar would restyle one\n * grid and leave its neighbour behind. One module-level value + a subscriber\n * set means every mounted grid and every `DensityControl` on the page observes\n * the same level, and `useSyncExternalStore` makes that correct under\n * concurrent rendering rather than merely usually right.\n */\n\nimport * as React from 'react'\nimport { apiCall } from '@freighttech/ui/backend/utils/apiCall'\nimport { getCurrentOrganizationScope } from '@open-mercato/shared/lib/frontend/organizationEvents'\nimport { DEFAULT_DENSITY, isDensityLevel, type DensityLevel } from '../types/density'\n\n/**\n * Storage key prefix. Note what is NOT in the key: no tableId, no perspective\n * id, no organisation id. See DECISION 2. The scope segment is the USER.\n */\nexport const DENSITY_STORAGE_PREFIX = 'fms.dt.density'\n\n/**\n * Cache of the last authoritative userId.\n *\n * SHARED WITH `useColumnWidthPersistence` on purpose \u2014 it is the same question\n * (\"who is this, synchronously, before the first paint?\") and two caches would\n * drift. Whichever hook resolves first populates it for the other.\n */\nexport const DENSITY_SCOPE_CACHE_KEY = 'fms.dt.uid'\n\n/** Scope used when neither a cached userId nor an organisation is knowable. */\nconst FALLBACK_SCOPE = 'shared'\n\nfunction keyFor(scope: string): string {\n  return `${DENSITY_STORAGE_PREFIX}:${scope}`\n}\n\n/* \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n   MODULE-LEVEL STORE\n   \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\ntype Listener = () => void\n\nconst listeners = new Set<Listener>()\n\n/**\n * The level every mounted grid observes. A primitive, so `getSnapshot` returns\n * a referentially stable value and `useSyncExternalStore` cannot loop.\n */\n/**\n * Level PER TABLE, not per app.\n *\n * This was a single module-level value, so choosing \"dense\" in one grid\n * silently re-laid-out every other grid on screen \u2014 very visible once split\n * view can show three at once. Keyed by the table's storage id (which is\n * already pane-scoped, so two panes of the same table are independent too).\n */\nconst levels = new Map<string, DensityLevel>()\n/** Applies to any table with no choice of its own. Also the legacy value. */\nlet currentLevel: DensityLevel = DEFAULT_DENSITY\n/** Scope the current level was read under. `null` until first hydration. */\nlet currentScope: string | null = null\n/** Whether `currentScope` came from the uid cache (vs an org/shared fallback). */\nlet scopeFromCache = false\nlet hydrated = false\nlet storageListenerAttached = false\n\nfunction emit(): void {\n  // Copy: a listener may unsubscribe during notification.\n  for (const listener of Array.from(listeners)) listener()\n}\n\n/** Raw read \u2014 returns the stored level, or `null` for absent/corrupt/blocked. */\nfunction readRaw(key: string): DensityLevel | null {\n  try {\n    const raw = window.localStorage.getItem(key)\n    return isDensityLevel(raw) ? raw : null\n  } catch {\n    // Storage blocked (Safari private mode, hardened profile). Not an error\n    // condition for us \u2014 a user with no reachable storage simply gets the\n    // default every load, which is today's rendering.\n    return null\n  }\n}\n\nfunction writeRaw(key: string, level: DensityLevel): void {\n  try {\n    window.localStorage.setItem(key, level)\n  } catch {\n    // Quota exceeded / storage blocked. Persistence is best-effort; the\n    // in-memory value still applies for this session, so the user's click is\n    // never ignored \u2014 it just does not survive a reload.\n  }\n}\n\n/**\n * Best-effort scope resolvable WITHOUT a network call: cached userId \u2192 active\n * organisation \u2192 shared. Synchronous, so the grid can paint at the right\n * density instead of flashing comfortable and re-laying-out.\n */\nfunction syncScope(): { scope: string; fromCache: boolean } {\n  try {\n    const cached = window.localStorage.getItem(DENSITY_SCOPE_CACHE_KEY)\n    if (cached) return { scope: cached, fromCache: true }\n  } catch {\n    /* storage unavailable */\n  }\n  let org: string | null = null\n  try {\n    org = getCurrentOrganizationScope().organizationId\n  } catch {\n    /* scope module not ready */\n  }\n  return { scope: org || FALLBACK_SCOPE, fromCache: false }\n}\n\n/**\n * Read storage into the module store. Idempotent, silent (never emits \u2014 it\n * runs inside `getSnapshot`, which must not have observable side effects).\n */\nfunction hydrate(): void {\n  if (hydrated) return\n  hydrated = true\n  if (typeof window === 'undefined') return\n  const resolved = syncScope()\n  currentScope = resolved.scope\n  scopeFromCache = resolved.fromCache\n  currentLevel = readRaw(keyFor(resolved.scope)) ?? DEFAULT_DENSITY\n}\n\nfunction onStorage(event: StorageEvent): void {\n  // `key === null` is a `localStorage.clear()` from another tab.\n  const watched = keyFor(currentScope ?? FALLBACK_SCOPE)\n  if (event.key !== null && event.key !== watched) return\n  const next = readRaw(watched) ?? DEFAULT_DENSITY\n  if (next === currentLevel) return\n  currentLevel = next\n  emit()\n}\n\n/* \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n   PUBLIC STORE API \u2014 usable outside React (tests, imperative callers)\n   \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\n/**\n * Current level for `tableKey`, falling back to the legacy app-wide value so a\n * user who had chosen a density before this was keyed keeps seeing it.\n */\nexport function getDensityPreference(tableKey?: string): DensityLevel {\n  if (!hydrated) hydrate()\n  if (!tableKey) return currentLevel\n  const own = levels.get(tableKey)\n  if (own) return own\n  const stored = typeof window !== 'undefined'\n    ? readRaw(`${keyFor(currentScope ?? FALLBACK_SCOPE)}:${tableKey}`)\n    : null\n  if (stored) {\n    levels.set(tableKey, stored)\n    return stored\n  }\n  return currentLevel\n}\n\n/**\n * The level React uses while hydrating a server-rendered tree.\n *\n * MUST be `DEFAULT_DENSITY`: the server has no access to the user's\n * localStorage, so any other answer would be a hydration mismatch. A user whose\n * stored preference is `dense` therefore hydrates at `comfortable` and is\n * corrected in the same commit \u2014 one attribute swap on a container, no reflow\n * beyond the grid, no request.\n */\nexport function getServerDensityPreference(): DensityLevel {\n  return DEFAULT_DENSITY\n}\n\n/** Subscribe to level changes. Returns an unsubscribe function. */\nexport function subscribeDensityPreference(listener: Listener): () => void {\n  listeners.add(listener)\n  if (!storageListenerAttached && typeof window !== 'undefined') {\n    storageListenerAttached = true\n    window.addEventListener('storage', onStorage)\n  }\n  return () => {\n    listeners.delete(listener)\n  }\n}\n\n/**\n * Set and persist the level. No-op for an unchanged or invalid value, so a\n * corrupt caller can never blank the grid or spam re-renders.\n */\nexport function setDensityPreference(level: DensityLevel, tableKey?: string): void {\n  if (!isDensityLevel(level)) return\n  hydrate()\n  const base = keyFor(currentScope ?? FALLBACK_SCOPE)\n  if (tableKey) {\n    if (levels.get(tableKey) === level) return\n    levels.set(tableKey, level)\n    if (typeof window !== 'undefined') writeRaw(`${base}:${tableKey}`, level)\n    emit()\n    return\n  }\n  if (currentLevel === level) return\n  currentLevel = level\n  if (typeof window !== 'undefined') writeRaw(base, level)\n  emit()\n}\n\n/* \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n   IDENTITY CONFIRMATION \u2014 the A3 guarantee\n   \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\nlet identityPromise: Promise<void> | null = null\n\n/**\n * Confirm the authoritative userId in the background and reconcile the scope.\n *\n * This is what closes the last leak. `syncScope()` can only guess before the\n * first request completes, and the guess (\"shared\", or the organisation id) is\n * shared by construction. Two cases, resolved differently on purpose:\n *\n *   \u2022 painted under a FALLBACK scope (no uid cache yet) \u2014 this is the same\n *     user's first visit on this browser, so carry their choice forward to the\n *     user-scoped key. Losing a just-made setting on reload reads as a bug.\n *\n *   \u2022 painted under a DIFFERENT cached uid \u2014 a second account on this machine.\n *     Do NOT carry anything: load this user's own preference, which for a new\n *     user is `comfortable`. This is the case A3 is about, and inheriting here\n *     would be the exact defect.\n *\n * Runs at most ONCE per page load however many grids mount (`identityPromise`),\n * and every failure path is silent: an unreachable auth endpoint must never\n * cost the user their density.\n */\nexport function ensureDensityScope(): Promise<void> {\n  if (identityPromise) return identityPromise\n  identityPromise = (async () => {\n    if (typeof window === 'undefined') return\n    hydrate()\n    const painted = currentScope ?? FALLBACK_SCOPE\n    const paintedFromCache = scopeFromCache\n\n    let uid: string | null = null\n    try {\n      const res = await apiCall<{ ok: boolean; userId?: string }>('/api/auth/feature-check', {\n        method: 'POST',\n        headers: { 'content-type': 'application/json' },\n        body: JSON.stringify({ features: [] }),\n      })\n      if (res.ok && typeof res.result?.userId === 'string' && res.result.userId) {\n        uid = res.result.userId\n      }\n    } catch {\n      return // keep the scope we painted with\n    }\n    if (!uid || uid === painted) {\n      if (uid) {\n        try {\n          window.localStorage.setItem(DENSITY_SCOPE_CACHE_KEY, uid)\n        } catch {\n          /* ignore */\n        }\n      }\n      return\n    }\n\n    try {\n      window.localStorage.setItem(DENSITY_SCOPE_CACHE_KEY, uid)\n    } catch {\n      /* ignore */\n    }\n\n    const uidKey = keyFor(uid)\n    if (!paintedFromCache) {\n      // Same user, first ever resolution \u2014 carry the fallback-scoped choice.\n      // Never overwrite a preference this user already has.\n      const carried = readRaw(keyFor(painted))\n      if (carried && readRaw(uidKey) === null) writeRaw(uidKey, carried)\n    }\n\n    currentScope = uid\n    scopeFromCache = true\n    const next = readRaw(uidKey) ?? DEFAULT_DENSITY\n    if (next !== currentLevel) {\n      currentLevel = next\n      emit()\n    }\n  })()\n  return identityPromise\n}\n\n/**\n * Drop all in-memory state. FOR TESTS ONLY \u2014 it exists because the store is\n * module-level and therefore survives between test cases.\n */\nexport function resetDensityPreferenceStore(): void {\n  listeners.clear()\n  currentLevel = DEFAULT_DENSITY\n  currentScope = null\n  scopeFromCache = false\n  hydrated = false\n  identityPromise = null\n  if (storageListenerAttached && typeof window !== 'undefined') {\n    window.removeEventListener('storage', onStorage)\n    storageListenerAttached = false\n  }\n}\n\n/* \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n   REACT HOOK\n   \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */\n\nexport interface UseDensityPreferenceResult {\n  /** The level to render at \u2014 the override when one is given, else the user's. */\n  density: DensityLevel\n  /**\n   * Persist a new level for this user, across every grid on the page.\n   * A no-op while an override is in force (a pinned table is not a preference).\n   */\n  setDensity: (level: DensityLevel) => void\n  /** True when `density` came from `override` rather than from the user. */\n  isOverridden: boolean\n}\n\n/**\n * Read (and write) the current user's density preference.\n *\n * @param override  A developer-pinned level for a table whose structure demands\n *                  one (e.g. a fixed-height summary strip). Read-only: it wins\n *                  over the preference for THIS table and is never persisted,\n *                  so it cannot silently become the user's setting everywhere.\n */\nexport function useDensityPreference(\n  override?: DensityLevel | null,\n  /** Table storage id \u2014 already pane-scoped, so panes are independent. */\n  tableKey?: string,\n): UseDensityPreferenceResult {\n  const getSnapshot = React.useCallback(() => getDensityPreference(tableKey), [tableKey])\n  const stored = React.useSyncExternalStore(\n    subscribeDensityPreference,\n    getSnapshot,\n    getServerDensityPreference,\n  )\n\n  // Fire-and-forget; resolves once per page however many grids mount.\n  React.useEffect(() => {\n    void ensureDensityScope()\n  }, [])\n\n  const isOverridden = isDensityLevel(override)\n\n  const setDensity = React.useCallback(\n    (level: DensityLevel) => {\n      if (isOverridden) return\n      setDensityPreference(level, tableKey)\n    },\n    [isOverridden, tableKey],\n  )\n\n  return {\n    density: isOverridden ? (override as DensityLevel) : stored,\n    setDensity,\n    isOverridden,\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}