@arbidocs/react 0.5.110 → 0.5.112

package/dist/session/layout.js

@@ -0,0 +1,339 @@
+import {
+  closeThreadTabIn,
+  openThreadTabIn,
+  parseSavedThreadTabs,
+  renameThreadTabIn,
+  savedThreadTabs,
+  selectThreadTabIn,
+  showThreadListIn
+} from "./thread-tabs.js";
+const PANEL_MODES = ["main", "docked", "overlay", "popout"];
+const defaultPinned = () => typeof window === "undefined" || window.innerWidth >= 640;
+function defaultLayoutState() {
+  return {
+    shell: {
+      page: "home",
+      sidebar: { pinned: defaultPinned(), hovering: false, drawerOpen: false },
+      panels: { main: null, docked: null, overlay: null, popout: null, modes: {}, sizes: {} },
+      focusedArea: "main"
+    },
+    tabs: {
+      threads: [],
+      activeThread: null,
+      threadScrollRestore: null,
+      dm: [],
+      activeDm: null,
+      dmMessageId: null,
+      projects: [],
+      activeProject: null
+    },
+    views: { tabs: {}, filters: {}, values: {}, transient: {} },
+    grid: { states: {}, rowHeights: {}, labelWidths: {}, savedViews: {} }
+  };
+}
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const recordOf = (value, keep) => isRecord(value) ? Object.fromEntries(Object.entries(value).filter(([, v]) => keep(v))) : {};
+const isString = (v) => typeof v === "string";
+const isNumber = (v) => typeof v === "number" && Number.isFinite(v);
+const isAny = (v) => v !== void 0;
+const isMode = (v) => PANEL_MODES.includes(v);
+const isSize = (v) => isRecord(v) && isNumber(v.width) && isNumber(v.height);
+const isList = (v) => Array.isArray(v);
+const stringOrNull = (v) => isString(v) ? v : null;
+function parseSavedLayout(saved) {
+  if (!isRecord(saved) || saved.version !== 1) return null;
+  const shell = isRecord(saved.shell) ? saved.shell : {};
+  const panels = isRecord(shell.panels) ? shell.panels : {};
+  const tabs = isRecord(saved.tabs) ? saved.tabs : {};
+  const views = isRecord(saved.views) ? saved.views : {};
+  const grid = isRecord(saved.grid) ? saved.grid : {};
+  const defaults = defaultLayoutState();
+  return {
+    version: 1,
+    migrated: isList(saved.migrated) ? saved.migrated.filter(isString) : [],
+    shell: {
+      page: isString(shell.page) ? shell.page : defaults.shell.page,
+      sidebarPinned: typeof shell.sidebarPinned === "boolean" ? shell.sidebarPinned : defaults.shell.sidebar.pinned,
+      panels: {
+        main: stringOrNull(panels.main),
+        docked: stringOrNull(panels.docked),
+        modes: recordOf(panels.modes, isMode),
+        sizes: recordOf(panels.sizes, isSize)
+      }
+    },
+    tabs: parseSavedThreadTabs(tabs.threads, tabs.activeThread),
+    views: {
+      tabs: recordOf(views.tabs, isString),
+      filters: recordOf(views.filters, isAny),
+      values: recordOf(views.values, isAny)
+    },
+    grid: {
+      states: recordOf(grid.states, isRecord),
+      rowHeights: recordOf(grid.rowHeights, isNumber),
+      labelWidths: recordOf(grid.labelWidths, isNumber),
+      savedViews: recordOf(grid.savedViews, isList)
+    }
+  };
+}
+function savedLayoutOf(layout, migrated) {
+  const { shell, tabs, views, grid } = layout;
+  return {
+    version: 1,
+    migrated,
+    shell: {
+      page: shell.page,
+      sidebarPinned: shell.sidebar.pinned,
+      // A panel over the page or in its own window does not come back after a reload.
+      panels: {
+        main: shell.panels.main,
+        docked: shell.panels.docked,
+        modes: shell.panels.modes,
+        sizes: shell.panels.sizes
+      }
+    },
+    tabs: { threads: savedThreadTabs(tabs.threads), activeThread: tabs.activeThread },
+    views: { tabs: views.tabs, filters: views.filters, values: views.values },
+    grid
+  };
+}
+function restoreLayout(current, saved) {
+  return {
+    ...current,
+    shell: {
+      ...current.shell,
+      page: saved.shell.page,
+      sidebar: { ...current.shell.sidebar, pinned: saved.shell.sidebarPinned },
+      panels: { ...current.shell.panels, ...saved.shell.panels }
+    },
+    tabs: { ...current.tabs, ...saved.tabs },
+    views: { ...saved.views, transient: current.views.transient },
+    grid: saved.grid
+  };
+}
+function openPanelIn(panels, panelId, mode) {
+  const leave = (slot) => slot === panelId ? null : slot;
+  const next = {
+    ...panels,
+    main: leave(panels.main),
+    docked: leave(panels.docked),
+    overlay: leave(panels.overlay),
+    popout: leave(panels.popout),
+    modes: { ...panels.modes, [panelId]: mode }
+  };
+  if (mode === "docked") return { ...next, docked: panelId, overlay: null };
+  if (mode === "overlay") return { ...next, overlay: panelId, docked: null };
+  return { ...next, [mode]: panelId };
+}
+function closePanelIn(panels, panelId) {
+  const leave = (slot) => slot === panelId ? null : slot;
+  return {
+    ...panels,
+    main: leave(panels.main),
+    docked: leave(panels.docked),
+    overlay: leave(panels.overlay),
+    popout: leave(panels.popout)
+  };
+}
+function panelPlace(panels, panelId) {
+  return PANEL_MODES.find((mode) => panels[mode] === panelId) ?? null;
+}
+const DOCUMENT_VIEWER_PANEL = "document-viewer";
+const isPanelOpen = (state, panelId) => panelPlace(state.shell.panels, panelId) !== null;
+const dmTabId = (tab) => tab.recipientId ?? "new";
+function createArbiLayoutStore({
+  persist,
+  initial
+} = {}) {
+  let layout = { ...defaultLayoutState(), ...initial };
+  let migrated = [];
+  let isHydrated = !persist;
+  const listeners = /* @__PURE__ */ new Set();
+  const save = () => {
+    if (persist && isHydrated) persist.save(savedLayoutOf(layout, migrated));
+  };
+  const update = (next) => {
+    if (next === layout) return;
+    const persisted = next.tabs.threads !== layout.tabs.threads || next.tabs.activeThread !== layout.tabs.activeThread || next.views.tabs !== layout.views.tabs || next.views.filters !== layout.views.filters || next.views.values !== layout.views.values || next.grid !== layout.grid || next.shell.page !== layout.shell.page || next.shell.sidebar.pinned !== layout.shell.sidebar.pinned || next.shell.panels !== layout.shell.panels;
+    layout = next;
+    listeners.forEach((listener) => listener());
+    if (persisted) save();
+  };
+  const shell = (change) => update({ ...layout, shell: { ...layout.shell, ...change } });
+  const tabs = (change) => update({ ...layout, tabs: { ...layout.tabs, ...change } });
+  const views = (change) => update({ ...layout, views: { ...layout.views, ...change } });
+  const grid = (change) => update({ ...layout, grid: { ...layout.grid, ...change } });
+  const hydration = persist ? persist.load().then(
+    (saved) => {
+      const parsed = parseSavedLayout(saved);
+      if (parsed) {
+        migrated = parsed.migrated;
+        layout = restoreLayout(layout, parsed);
+      }
+      isHydrated = true;
+      listeners.forEach((listener) => listener());
+    },
+    () => {
+      isHydrated = true;
+      listeners.forEach((listener) => listener());
+    }
+  ) : Promise.resolve();
+  return {
+    getLayout: () => layout,
+    reset: () => update(defaultLayoutState()),
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => listeners.delete(listener);
+    },
+    hydrated: () => hydration,
+    isHydrated: () => isHydrated,
+    threads: {
+      open: (conversationId, leaving) => {
+        const change = openThreadTabIn(layout.tabs, conversationId, leaving);
+        tabs(change.tabs);
+        return { tabId: change.tabId, show: change.show };
+      },
+      close: (tabId) => {
+        const change = closeThreadTabIn(layout.tabs, tabId);
+        tabs(change.tabs);
+        return change.show;
+      },
+      select: (tabId, leaving) => {
+        const change = selectThreadTabIn(layout.tabs, tabId, leaving);
+        if (change.tabs !== layout.tabs) tabs(change.tabs);
+        return change.show;
+      },
+      showList: (leaving) => tabs(showThreadListIn(layout.tabs, leaving)),
+      rename: (fromId, toId) => {
+        const next = renameThreadTabIn(layout.tabs, fromId, toId);
+        if (next !== layout.tabs) tabs(next);
+      },
+      clear: () => {
+        if (layout.tabs.threads.length > 0 || layout.tabs.activeThread !== null)
+          tabs({ threads: [], activeThread: null });
+      },
+      consumeScrollRestore: () => {
+        const value = layout.tabs.threadScrollRestore;
+        if (value !== null) tabs({ threadScrollRestore: null });
+        return value;
+      }
+    },
+    setPage: (page) => {
+      if (layout.shell.page !== page || layout.shell.focusedArea !== "main")
+        shell({ page, focusedArea: "main" });
+    },
+    setSidebar: (change) => {
+      const sidebar = { ...layout.shell.sidebar, ...change };
+      const current = layout.shell.sidebar;
+      if (sidebar.pinned !== current.pinned || sidebar.hovering !== current.hovering || sidebar.drawerOpen !== current.drawerOpen)
+        shell({ sidebar });
+    },
+    openPanel: (panelId, mode) => shell({ panels: openPanelIn(layout.shell.panels, panelId, mode), focusedArea: panelId }),
+    closePanel: (panelId) => shell({ panels: closePanelIn(layout.shell.panels, panelId), focusedArea: "main" }),
+    setPanelMode: (panelId, mode) => {
+      const panels = layout.shell.panels;
+      if (panelPlace(panels, panelId) !== null)
+        shell({ panels: openPanelIn(panels, panelId, mode), focusedArea: panelId });
+      else if (panels.modes[panelId] !== mode)
+        shell({ panels: { ...panels, modes: { ...panels.modes, [panelId]: mode } } });
+    },
+    setPanelSize: (panelId, size) => {
+      const panels = layout.shell.panels;
+      shell({ panels: { ...panels, sizes: { ...panels.sizes, [panelId]: size } } });
+    },
+    setFocusedArea: (focusedArea) => {
+      if (layout.shell.focusedArea !== focusedArea) shell({ focusedArea });
+    },
+    openDmTab: (recipientId, messageId) => {
+      const id = recipientId ?? "new";
+      const dm = layout.tabs.dm.some((tab) => dmTabId(tab) === id) ? layout.tabs.dm : [...layout.tabs.dm, { recipientId }];
+      tabs({ dm, activeDm: id, ...messageId ? { dmMessageId: messageId } : {} });
+    },
+    closeDmTab: (tabId) => {
+      const dm = layout.tabs.dm.filter((tab) => dmTabId(tab) !== tabId);
+      if (dm.length === layout.tabs.dm.length) return;
+      if (dm.length === 0) return tabs({ dm, activeDm: null });
+      if (layout.tabs.activeDm !== tabId) return tabs({ dm });
+      const index = layout.tabs.dm.findIndex((tab) => dmTabId(tab) === tabId);
+      tabs({ dm, activeDm: dmTabId(dm[Math.min(index, dm.length - 1)]) });
+    },
+    selectDmTab: (activeDm) => {
+      if (layout.tabs.activeDm !== activeDm) tabs({ activeDm });
+    },
+    clearDmTabs: () => tabs({ dm: [], activeDm: null }),
+    setDmMessageId: (dmMessageId) => {
+      if (layout.tabs.dmMessageId !== dmMessageId) tabs({ dmMessageId });
+    },
+    openProjectTab: (projectId) => tabs({
+      projects: layout.tabs.projects.includes(projectId) ? layout.tabs.projects : [...layout.tabs.projects, projectId],
+      activeProject: projectId
+    }),
+    closeProjectTab: (projectId) => {
+      const projects = layout.tabs.projects.filter((id) => id !== projectId);
+      if (projects.length === layout.tabs.projects.length) return;
+      if (layout.tabs.activeProject !== projectId) return tabs({ projects });
+      const index = layout.tabs.projects.indexOf(projectId);
+      tabs({
+        projects,
+        activeProject: projects.length ? projects[Math.min(index, projects.length - 1)] : null
+      });
+    },
+    selectProjectTab: (activeProject) => {
+      if (layout.tabs.activeProject !== activeProject) tabs({ activeProject });
+    },
+    setPageTab: (page, tab) => {
+      if (layout.views.tabs[page] !== tab) views({ tabs: { ...layout.views.tabs, [page]: tab } });
+    },
+    setViewFilter: (key, value) => views({ filters: { ...layout.views.filters, [key]: value } }),
+    setViewValue: (key, value) => {
+      if (layout.views.values[key] !== value)
+        views({ values: { ...layout.views.values, [key]: value } });
+    },
+    setTransientView: (key, value) => {
+      if (layout.views.transient[key] === value) return;
+      const transient = { ...layout.views.transient };
+      if (value === void 0) delete transient[key];
+      else transient[key] = value;
+      views({ transient });
+    },
+    setGridState: (gridId, state) => grid({ states: { ...layout.grid.states, [gridId]: state } }),
+    clearGridState: (gridId) => {
+      if (!(gridId in layout.grid.states)) return;
+      const states = { ...layout.grid.states };
+      delete states[gridId];
+      grid({ states });
+    },
+    setGridRowHeight: (gridId, height) => grid({ rowHeights: { ...layout.grid.rowHeights, [gridId]: height } }),
+    setGridLabelWidth: (gridId, width) => grid({ labelWidths: { ...layout.grid.labelWidths, [gridId]: width } }),
+    setGridSavedViews: (gridId, saved) => grid({ savedViews: { ...layout.grid.savedViews, [gridId]: saved } }),
+    resetLayout: (variant) => {
+      const fresh = defaultLayoutState();
+      update({
+        shell: {
+          ...fresh.shell,
+          panels: {
+            ...fresh.shell.panels,
+            modes: layout.shell.panels.modes,
+            sizes: layout.shell.panels.sizes
+          }
+        },
+        tabs: fresh.tabs,
+        views: { ...layout.views, tabs: {}, transient: {} },
+        grid: variant === "logout" ? { ...layout.grid, states: {} } : layout.grid
+      });
+    }
+  };
+}
+export {
+  DOCUMENT_VIEWER_PANEL,
+  closePanelIn,
+  createArbiLayoutStore,
+  defaultLayoutState,
+  dmTabId,
+  isPanelOpen,
+  openPanelIn,
+  panelPlace,
+  parseSavedLayout,
+  restoreLayout,
+  savedLayoutOf
+};
+//# sourceMappingURL=layout.js.map

package/dist/session/layout.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/session/layout.ts"],
+  "sourcesContent": ["/**\n * The layout part of the session state: the shell (the page on screen, the sidebar, the panels and\n * where each one shows, the area with focus), the open tabs (threads, direct messages, projects),\n * each page's view (its tab, its filters, other view settings) and the grids' saved state. Kits and\n * the host read and change it through the session store; the parts a person arranges (the page, the\n * pinned sidebar, the panels, the thread tabs, the views, the grids) are kept across reloads by the\n * host's {@link ArbiSessionPersist}.\n */\n\nimport type { ArbiSessionPersist } from './persist'\nimport {\n  closeThreadTabIn,\n  openThreadTabIn,\n  parseSavedThreadTabs,\n  renameThreadTabIn,\n  savedThreadTabs,\n  selectThreadTabIn,\n  showThreadListIn,\n  type ArbiThreadComposer,\n  type ArbiThreadTabShow,\n  type ArbiThreadTabsState,\n} from './thread-tabs'\n\n/** Where a panel shows: the page's area, docked beside it, over it, or in its own window. */\nexport type ArbiPanelMode = 'main' | 'docked' | 'overlay' | 'popout'\n\nexport interface ArbiPanelsState {\n  /** The panel in each place (one each): filling the page, docked, over the page, popped out. */\n  main: string | null\n  docked: string | null\n  overlay: string | null\n  popout: string | null\n  /** Where each panel last showed (it opens there again). */\n  modes: Readonly<Record<string, ArbiPanelMode>>\n  /** A floating panel's size. */\n  sizes: Readonly<Record<string, { width: number; height: number }>>\n}\n\nexport interface ArbiSidebarState {\n  /** Pinned open (on wide screens; phones show a drawer). */\n  pinned: boolean\n  /** The rail is expanded under the pointer. */\n  hovering: boolean\n  /** The phone drawer is open. */\n  drawerOpen: boolean\n}\n\nexport interface ArbiShellState {\n  /** The page on screen (a host's page id). */\n  page: string\n  sidebar: ArbiSidebarState\n  panels: ArbiPanelsState\n  /** The area with focus: `main` or a panel id. */\n  focusedArea: string\n}\n\n/** A direct-message tab: a person's or agent's id, a group chat's id, or null (a new message). */\nexport interface ArbiDmTab {\n  recipientId: string | null\n}\n\nexport interface ArbiTabsState extends ArbiThreadTabsState {\n  dm: readonly ArbiDmTab[]\n  activeDm: string | null\n  /** The message a direct-message tab scrolls to once open. */\n  dmMessageId: string | null\n  projects: readonly string[]\n  activeProject: string | null\n}\n\nexport interface ArbiViewsState {\n  /** Each page's tab, by page. */\n  tabs: Readonly<Record<string, string>>\n  /** Each list's quick filters, by list. */\n  filters: Readonly<Record<string, unknown>>\n  /** Other view settings, by key (a page's view mode, a zoom, a filter box's text). */\n  values: Readonly<Record<string, unknown>>\n  /** View state kept for this session only, by key (a search's results); not saved. */\n  transient: Readonly<Record<string, unknown>>\n}\n\nexport interface ArbiGridLayoutState {\n  /** Each grid's saved state (columns, widths, sort), by grid id. */\n  states: Readonly<Record<string, unknown>>\n  /** Each grid's row height. */\n  rowHeights: Readonly<Record<string, number>>\n  /** Each timeline's label column width. */\n  labelWidths: Readonly<Record<string, number>>\n  /** Views an earlier build saved on this device, by grid id (moved to user settings once). */\n  savedViews: Readonly<Record<string, readonly unknown[]>>\n}\n\nexport interface ArbiLayoutState {\n  shell: ArbiShellState\n  tabs: ArbiTabsState\n  views: ArbiViewsState\n  grid: ArbiGridLayoutState\n}\n\n/** What is kept across reloads. */\nexport interface ArbiSavedLayout {\n  version: 1\n  /** The pieces an earlier build's own saved state was brought in for (the host's migration). */\n  migrated: string[]\n  shell: {\n    page: string\n    sidebarPinned: boolean\n    panels: { main: string | null; docked: string | null } & Pick<\n      ArbiPanelsState,\n      'modes' | 'sizes'\n    >\n  }\n  /** The open thread tabs (without what was typed in them) and the one on screen. */\n  tabs: Pick<ArbiThreadTabsState, 'threads' | 'activeThread'>\n  views: Omit<ArbiViewsState, 'transient'>\n  grid: ArbiGridLayoutState\n}\n\nconst PANEL_MODES: readonly ArbiPanelMode[] = ['main', 'docked', 'overlay', 'popout']\n\n/** Phones start with the sidebar as a drawer, wider screens pinned. */\nconst defaultPinned = () => typeof window === 'undefined' || window.innerWidth >= 640\n\nexport function defaultLayoutState(): ArbiLayoutState {\n  return {\n    shell: {\n      page: 'home',\n      sidebar: { pinned: defaultPinned(), hovering: false, drawerOpen: false },\n      panels: { main: null, docked: null, overlay: null, popout: null, modes: {}, sizes: {} },\n      focusedArea: 'main',\n    },\n    tabs: {\n      threads: [],\n      activeThread: null,\n      threadScrollRestore: null,\n      dm: [],\n      activeDm: null,\n      dmMessageId: null,\n      projects: [],\n      activeProject: null,\n    },\n    views: { tabs: {}, filters: {}, values: {}, transient: {} },\n    grid: { states: {}, rowHeights: {}, labelWidths: {}, savedViews: {} },\n  }\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst recordOf = <T>(value: unknown, keep: (entry: unknown) => entry is T): Record<string, T> =>\n  isRecord(value)\n    ? (Object.fromEntries(Object.entries(value).filter(([, v]) => keep(v))) as Record<string, T>)\n    : {}\n\nconst isString = (v: unknown): v is string => typeof v === 'string'\nconst isNumber = (v: unknown): v is number => typeof v === 'number' && Number.isFinite(v)\nconst isAny = (v: unknown): v is unknown => v !== undefined\nconst isMode = (v: unknown): v is ArbiPanelMode => PANEL_MODES.includes(v as ArbiPanelMode)\nconst isSize = (v: unknown): v is { width: number; height: number } =>\n  isRecord(v) && isNumber(v.width) && isNumber(v.height)\nconst isList = (v: unknown): v is unknown[] => Array.isArray(v)\nconst stringOrNull = (v: unknown): string | null => (isString(v) ? v : null)\n\n/**\n * A saved layout as this build reads it: whatever an earlier or a broken save left is dropped\n * rather than read. Never throws; null when there is nothing usable.\n */\nexport function parseSavedLayout(saved: unknown): ArbiSavedLayout | null {\n  if (!isRecord(saved) || saved.version !== 1) return null\n  const shell = isRecord(saved.shell) ? saved.shell : {}\n  const panels = isRecord(shell.panels) ? shell.panels : {}\n  const tabs = isRecord(saved.tabs) ? saved.tabs : {}\n  const views = isRecord(saved.views) ? saved.views : {}\n  const grid = isRecord(saved.grid) ? saved.grid : {}\n  const defaults = defaultLayoutState()\n  return {\n    version: 1,\n    migrated: isList(saved.migrated) ? saved.migrated.filter(isString) : [],\n    shell: {\n      page: isString(shell.page) ? shell.page : defaults.shell.page,\n      sidebarPinned:\n        typeof shell.sidebarPinned === 'boolean'\n          ? shell.sidebarPinned\n          : defaults.shell.sidebar.pinned,\n      panels: {\n        main: stringOrNull(panels.main),\n        docked: stringOrNull(panels.docked),\n        modes: recordOf(panels.modes, isMode),\n        sizes: recordOf(panels.sizes, isSize),\n      },\n    },\n    tabs: parseSavedThreadTabs(tabs.threads, tabs.activeThread),\n    views: {\n      tabs: recordOf(views.tabs, isString),\n      filters: recordOf(views.filters, isAny),\n      values: recordOf(views.values, isAny),\n    },\n    grid: {\n      states: recordOf(grid.states, isRecord),\n      rowHeights: recordOf(grid.rowHeights, isNumber),\n      labelWidths: recordOf(grid.labelWidths, isNumber),\n      savedViews: recordOf(grid.savedViews, isList),\n    },\n  }\n}\n\n/** What of a layout is saved. */\nexport function savedLayoutOf(layout: ArbiLayoutState, migrated: string[]): ArbiSavedLayout {\n  const { shell, tabs, views, grid } = layout\n  return {\n    version: 1,\n    migrated,\n    shell: {\n      page: shell.page,\n      sidebarPinned: shell.sidebar.pinned,\n      // A panel over the page or in its own window does not come back after a reload.\n      panels: {\n        main: shell.panels.main,\n        docked: shell.panels.docked,\n        modes: shell.panels.modes,\n        sizes: shell.panels.sizes,\n      },\n    },\n    tabs: { threads: savedThreadTabs(tabs.threads), activeThread: tabs.activeThread },\n    views: { tabs: views.tabs, filters: views.filters, values: views.values },\n    grid,\n  }\n}\n\n/** The layout a saved one restores (the parts not saved keep their current values). */\nexport function restoreLayout(current: ArbiLayoutState, saved: ArbiSavedLayout): ArbiLayoutState {\n  return {\n    ...current,\n    shell: {\n      ...current.shell,\n      page: saved.shell.page,\n      sidebar: { ...current.shell.sidebar, pinned: saved.shell.sidebarPinned },\n      panels: { ...current.shell.panels, ...saved.shell.panels },\n    },\n    tabs: { ...current.tabs, ...saved.tabs },\n    views: { ...saved.views, transient: current.views.transient },\n    grid: saved.grid,\n  }\n}\n\n// \u2500\u2500 Changes \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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/** Show a panel in a place: it leaves the place it was in, and what was in that place closes. */\nexport function openPanelIn(\n  panels: ArbiPanelsState,\n  panelId: string,\n  mode: ArbiPanelMode\n): ArbiPanelsState {\n  const leave = (slot: string | null) => (slot === panelId ? null : slot)\n  const next: ArbiPanelsState = {\n    ...panels,\n    main: leave(panels.main),\n    docked: leave(panels.docked),\n    overlay: leave(panels.overlay),\n    popout: leave(panels.popout),\n    modes: { ...panels.modes, [panelId]: mode },\n  }\n  // Docked and over the page are both the secondary surface beside the page: one at a time.\n  if (mode === 'docked') return { ...next, docked: panelId, overlay: null }\n  if (mode === 'overlay') return { ...next, overlay: panelId, docked: null }\n  return { ...next, [mode]: panelId }\n}\n\nexport function closePanelIn(panels: ArbiPanelsState, panelId: string): ArbiPanelsState {\n  const leave = (slot: string | null) => (slot === panelId ? null : slot)\n  return {\n    ...panels,\n    main: leave(panels.main),\n    docked: leave(panels.docked),\n    overlay: leave(panels.overlay),\n    popout: leave(panels.popout),\n  }\n}\n\n/** Where a panel shows now, or null while it is closed. */\nexport function panelPlace(panels: ArbiPanelsState, panelId: string): ArbiPanelMode | null {\n  return PANEL_MODES.find((mode) => panels[mode] === panelId) ?? null\n}\n\n/**\n * The panel that shows the session's `viewingDocument` (a host that shows documents in a panel\n * gives it this id): kits open a document with the environment's `openDocument` and close it here.\n */\nexport const DOCUMENT_VIEWER_PANEL = 'document-viewer'\n\n/** Whether a panel is open (anywhere). */\nexport const isPanelOpen = (state: { shell: ArbiShellState }, panelId: string): boolean =>\n  panelPlace(state.shell.panels, panelId) !== null\n\nexport const dmTabId = (tab: ArbiDmTab): string => tab.recipientId ?? 'new'\n\n/** The actions on the layout (part of {@link ArbiSessionStore}). */\nexport interface ArbiLayoutActions {\n  /** Show a page; the focus goes to the page area. */\n  setPage(page: string): void\n  setSidebar(change: Partial<ArbiSidebarState>): void\n  /** Show a panel in a place (`mode`), focused. */\n  openPanel(panelId: string, mode: ArbiPanelMode): void\n  closePanel(panelId: string): void\n  /** Where a panel shows: an open one moves there, a closed one opens there next time. */\n  setPanelMode(panelId: string, mode: ArbiPanelMode): void\n  setPanelSize(panelId: string, size: { width: number; height: number }): void\n  setFocusedArea(area: string): void\n  /** Open (or show) a direct-message tab, optionally scrolled to a message. */\n  openDmTab(recipientId: string | null, messageId?: string): void\n  closeDmTab(tabId: string): void\n  /** null: no direct-message tab (the panel's own). */\n  selectDmTab(tabId: string | null): void\n  clearDmTabs(): void\n  setDmMessageId(messageId: string | null): void\n  openProjectTab(projectId: string): void\n  closeProjectTab(projectId: string): void\n  /** null: the projects list. */\n  selectProjectTab(projectId: string | null): void\n  setPageTab(page: string, tab: string): void\n  setViewFilter(key: string, value: unknown): void\n  setViewValue(key: string, value: unknown): void\n  /** Set (or with `undefined`, drop) view state kept for this session only. */\n  setTransientView(key: string, value: unknown): void\n  setGridState(gridId: string, state: unknown): void\n  clearGridState(gridId: string): void\n  setGridRowHeight(gridId: string, height: number): void\n  setGridLabelWidth(gridId: string, width: number): void\n  setGridSavedViews(gridId: string, views: readonly unknown[]): void\n  /**\n   * Start over: a sign-in shows the home page with the sidebar at its default and no panel, tab\n   * or page tab open; a sign-out also forgets the grids.\n   */\n  resetLayout(variant: 'login' | 'logout'): void\n}\n\n/**\n * The thread tabs' changes on a layout store. Each takes the composer being left (saved into the tab\n * on screen) and says what the composer shows next; the session store applies that to whatever\n * holds the composer (`ArbiSessionStore.openThreadTab` and the like are built on these).\n */\nexport interface ArbiThreadTabsController {\n  open(\n    conversationId: string | null,\n    leaving: ArbiThreadComposer\n  ): { tabId: string; show: ArbiThreadTabShow }\n  close(tabId: string): ArbiThreadTabShow\n  select(tabId: string, leaving: ArbiThreadComposer): ArbiThreadTabShow\n  showList(leaving: ArbiThreadComposer): void\n  /** The tab of `fromId` is now `toId`'s (a new chat got its id). */\n  rename(fromId: string, toId: string): void\n  clear(): void\n  /** The scroll position the last tab switch brought back (once; null after). */\n  consumeScrollRestore(): number | null\n}\n\n/** A store of the layout alone; the session stores are built on it. */\nexport interface ArbiLayoutStore extends ArbiLayoutActions {\n  getLayout(): ArbiLayoutState\n  /** Back to the defaults, everything (unit tests; a reset from an error screen). */\n  reset(): void\n  subscribe(listener: () => void): () => void\n  /** Resolves once the saved layout has been read (at once without a `persist`). */\n  hydrated(): Promise<void>\n  isHydrated(): boolean\n  /** The thread tabs' changes (not session actions: the session store's apply them). */\n  threads: ArbiThreadTabsController\n}\n\nexport interface ArbiLayoutStoreOptions {\n  persist?: ArbiSessionPersist<ArbiSavedLayout>\n  /** The layout to start from (unit tests, a host's initial state); a saved one replaces it. */\n  initial?: Partial<ArbiLayoutState>\n}\n\nexport function createArbiLayoutStore({\n  persist,\n  initial,\n}: ArbiLayoutStoreOptions = {}): ArbiLayoutStore {\n  let layout: ArbiLayoutState = { ...defaultLayoutState(), ...initial }\n  let migrated: string[] = []\n  let isHydrated = !persist\n  const listeners = new Set<() => void>()\n  const save = () => {\n    // Nothing is saved before the saved layout is read: it would overwrite it with the defaults.\n    if (persist && isHydrated) persist.save(savedLayoutOf(layout, migrated))\n  }\n  const update = (next: ArbiLayoutState) => {\n    if (next === layout) return\n    const persisted =\n      next.tabs.threads !== layout.tabs.threads ||\n      next.tabs.activeThread !== layout.tabs.activeThread ||\n      next.views.tabs !== layout.views.tabs ||\n      next.views.filters !== layout.views.filters ||\n      next.views.values !== layout.views.values ||\n      next.grid !== layout.grid ||\n      next.shell.page !== layout.shell.page ||\n      next.shell.sidebar.pinned !== layout.shell.sidebar.pinned ||\n      next.shell.panels !== layout.shell.panels\n    layout = next\n    listeners.forEach((listener) => listener())\n    if (persisted) save()\n  }\n  const shell = (change: Partial<ArbiShellState>) =>\n    update({ ...layout, shell: { ...layout.shell, ...change } })\n  const tabs = (change: Partial<ArbiTabsState>) =>\n    update({ ...layout, tabs: { ...layout.tabs, ...change } })\n  const views = (change: Partial<ArbiViewsState>) =>\n    update({ ...layout, views: { ...layout.views, ...change } })\n  const grid = (change: Partial<ArbiGridLayoutState>) =>\n    update({ ...layout, grid: { ...layout.grid, ...change } })\n\n  const hydration: Promise<void> = persist\n    ? persist.load().then(\n        (saved) => {\n          const parsed = parseSavedLayout(saved)\n          if (parsed) {\n            migrated = parsed.migrated\n            layout = restoreLayout(layout, parsed)\n          }\n          isHydrated = true\n          listeners.forEach((listener) => listener())\n        },\n        () => {\n          isHydrated = true\n          listeners.forEach((listener) => listener())\n        }\n      )\n    : Promise.resolve()\n\n  return {\n    getLayout: () => layout,\n    reset: () => update(defaultLayoutState()),\n    subscribe: (listener) => {\n      listeners.add(listener)\n      return () => listeners.delete(listener)\n    },\n    hydrated: () => hydration,\n    isHydrated: () => isHydrated,\n    threads: {\n      open: (conversationId, leaving) => {\n        const change = openThreadTabIn(layout.tabs, conversationId, leaving)\n        tabs(change.tabs)\n        return { tabId: change.tabId, show: change.show }\n      },\n      close: (tabId) => {\n        const change = closeThreadTabIn(layout.tabs, tabId)\n        tabs(change.tabs)\n        return change.show\n      },\n      select: (tabId, leaving) => {\n        const change = selectThreadTabIn(layout.tabs, tabId, leaving)\n        if (change.tabs !== layout.tabs) tabs(change.tabs)\n        return change.show\n      },\n      showList: (leaving) => tabs(showThreadListIn(layout.tabs, leaving)),\n      rename: (fromId, toId) => {\n        const next = renameThreadTabIn(layout.tabs, fromId, toId)\n        if (next !== layout.tabs) tabs(next)\n      },\n      clear: () => {\n        if (layout.tabs.threads.length > 0 || layout.tabs.activeThread !== null)\n          tabs({ threads: [], activeThread: null })\n      },\n      consumeScrollRestore: () => {\n        const value = layout.tabs.threadScrollRestore\n        if (value !== null) tabs({ threadScrollRestore: null })\n        return value\n      },\n    },\n    setPage: (page) => {\n      if (layout.shell.page !== page || layout.shell.focusedArea !== 'main')\n        shell({ page, focusedArea: 'main' })\n    },\n    setSidebar: (change) => {\n      const sidebar = { ...layout.shell.sidebar, ...change }\n      const current = layout.shell.sidebar\n      if (\n        sidebar.pinned !== current.pinned ||\n        sidebar.hovering !== current.hovering ||\n        sidebar.drawerOpen !== current.drawerOpen\n      )\n        shell({ sidebar })\n    },\n    openPanel: (panelId, mode) =>\n      shell({ panels: openPanelIn(layout.shell.panels, panelId, mode), focusedArea: panelId }),\n    closePanel: (panelId) =>\n      shell({ panels: closePanelIn(layout.shell.panels, panelId), focusedArea: 'main' }),\n    setPanelMode: (panelId, mode) => {\n      const panels = layout.shell.panels\n      if (panelPlace(panels, panelId) !== null)\n        shell({ panels: openPanelIn(panels, panelId, mode), focusedArea: panelId })\n      else if (panels.modes[panelId] !== mode)\n        shell({ panels: { ...panels, modes: { ...panels.modes, [panelId]: mode } } })\n    },\n    setPanelSize: (panelId, size) => {\n      const panels = layout.shell.panels\n      shell({ panels: { ...panels, sizes: { ...panels.sizes, [panelId]: size } } })\n    },\n    setFocusedArea: (focusedArea) => {\n      if (layout.shell.focusedArea !== focusedArea) shell({ focusedArea })\n    },\n    openDmTab: (recipientId, messageId) => {\n      const id = recipientId ?? 'new'\n      const dm = layout.tabs.dm.some((tab) => dmTabId(tab) === id)\n        ? layout.tabs.dm\n        : [...layout.tabs.dm, { recipientId }]\n      tabs({ dm, activeDm: id, ...(messageId ? { dmMessageId: messageId } : {}) })\n    },\n    closeDmTab: (tabId) => {\n      const dm = layout.tabs.dm.filter((tab) => dmTabId(tab) !== tabId)\n      if (dm.length === layout.tabs.dm.length) return\n      if (dm.length === 0) return tabs({ dm, activeDm: null })\n      if (layout.tabs.activeDm !== tabId) return tabs({ dm })\n      // The tab beside the closed one shows.\n      const index = layout.tabs.dm.findIndex((tab) => dmTabId(tab) === tabId)\n      tabs({ dm, activeDm: dmTabId(dm[Math.min(index, dm.length - 1)]) })\n    },\n    selectDmTab: (activeDm) => {\n      if (layout.tabs.activeDm !== activeDm) tabs({ activeDm })\n    },\n    clearDmTabs: () => tabs({ dm: [], activeDm: null }),\n    setDmMessageId: (dmMessageId) => {\n      if (layout.tabs.dmMessageId !== dmMessageId) tabs({ dmMessageId })\n    },\n    openProjectTab: (projectId) =>\n      tabs({\n        projects: layout.tabs.projects.includes(projectId)\n          ? layout.tabs.projects\n          : [...layout.tabs.projects, projectId],\n        activeProject: projectId,\n      }),\n    closeProjectTab: (projectId) => {\n      const projects = layout.tabs.projects.filter((id) => id !== projectId)\n      if (projects.length === layout.tabs.projects.length) return\n      if (layout.tabs.activeProject !== projectId) return tabs({ projects })\n      const index = layout.tabs.projects.indexOf(projectId)\n      tabs({\n        projects,\n        activeProject: projects.length ? projects[Math.min(index, projects.length - 1)] : null,\n      })\n    },\n    selectProjectTab: (activeProject) => {\n      if (layout.tabs.activeProject !== activeProject) tabs({ activeProject })\n    },\n    setPageTab: (page, tab) => {\n      if (layout.views.tabs[page] !== tab) views({ tabs: { ...layout.views.tabs, [page]: tab } })\n    },\n    setViewFilter: (key, value) => views({ filters: { ...layout.views.filters, [key]: value } }),\n    setViewValue: (key, value) => {\n      if (layout.views.values[key] !== value)\n        views({ values: { ...layout.views.values, [key]: value } })\n    },\n    setTransientView: (key, value) => {\n      if (layout.views.transient[key] === value) return\n      const transient = { ...layout.views.transient }\n      if (value === undefined) delete transient[key]\n      else transient[key] = value\n      views({ transient })\n    },\n    setGridState: (gridId, state) => grid({ states: { ...layout.grid.states, [gridId]: state } }),\n    clearGridState: (gridId) => {\n      if (!(gridId in layout.grid.states)) return\n      const states = { ...layout.grid.states }\n      delete states[gridId]\n      grid({ states })\n    },\n    setGridRowHeight: (gridId, height) =>\n      grid({ rowHeights: { ...layout.grid.rowHeights, [gridId]: height } }),\n    setGridLabelWidth: (gridId, width) =>\n      grid({ labelWidths: { ...layout.grid.labelWidths, [gridId]: width } }),\n    setGridSavedViews: (gridId, saved) =>\n      grid({ savedViews: { ...layout.grid.savedViews, [gridId]: saved } }),\n    resetLayout: (variant) => {\n      const fresh = defaultLayoutState()\n      update({\n        shell: {\n          ...fresh.shell,\n          panels: {\n            ...fresh.shell.panels,\n            modes: layout.shell.panels.modes,\n            sizes: layout.shell.panels.sizes,\n          },\n        },\n        tabs: fresh.tabs,\n        views: { ...layout.views, tabs: {}, transient: {} },\n        grid: variant === 'logout' ? { ...layout.grid, states: {} } : layout.grid,\n      })\n    },\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/session/persist.js

@@ -0,0 +1,106 @@
+function createDebouncedWriter({
+  write,
+  delayMs,
+  maxWaitMs,
+  onError
+}) {
+  const queue = /* @__PURE__ */ new Map();
+  const run = (key, value) => {
+    try {
+      void Promise.resolve(write(key, value)).catch((error) => onError?.(key, error));
+    } catch (error) {
+      onError?.(key, error);
+    }
+  };
+  const flush = (key) => {
+    const entry = queue.get(key);
+    if (!entry) return;
+    clearTimeout(entry.timer);
+    queue.delete(key);
+    run(key, entry.value);
+  };
+  return {
+    schedule(key, value) {
+      const now = Date.now();
+      const existing = queue.get(key);
+      if (existing) clearTimeout(existing.timer);
+      const firstQueuedAt = existing?.firstQueuedAt ?? now;
+      const wait = Math.max(0, Math.min(delayMs, firstQueuedAt + maxWaitMs - now));
+      queue.set(key, { value, firstQueuedAt, timer: setTimeout(() => flush(key), wait) });
+    },
+    pending: (key) => queue.get(key)?.value,
+    cancel(key) {
+      const entry = queue.get(key);
+      if (!entry) return;
+      clearTimeout(entry.timer);
+      queue.delete(key);
+    },
+    flushAll() {
+      for (const key of Array.from(queue.keys())) flush(key);
+    }
+  };
+}
+function flushOnPageExit(writer) {
+  if (typeof window === "undefined" || typeof document === "undefined") return () => {
+  };
+  const flush = () => writer.flushAll();
+  const onVisibility = () => {
+    if (document.visibilityState === "hidden") writer.flushAll();
+  };
+  window.addEventListener("beforeunload", flush);
+  window.addEventListener("pagehide", flush);
+  document.addEventListener("visibilitychange", onVisibility);
+  return () => {
+    window.removeEventListener("beforeunload", flush);
+    window.removeEventListener("pagehide", flush);
+    document.removeEventListener("visibilitychange", onVisibility);
+  };
+}
+function createStoragePersist({
+  storage,
+  key,
+  parse = (saved) => saved,
+  migrate,
+  delayMs = 250,
+  maxWaitMs = 1e3
+}) {
+  const writer = createDebouncedWriter({
+    write: (k, value) => storage.set(k, value),
+    delayMs,
+    maxWaitMs,
+    onError: (k, error) => console.error(`[session] Failed to save ${k}:`, error)
+  });
+  flushOnPageExit(writer);
+  const read = async () => {
+    const pending = writer.pending(key);
+    const raw = pending ?? await storage.get(key);
+    if (raw === null || raw === void 0) return null;
+    return parse(JSON.parse(raw));
+  };
+  return {
+    async load() {
+      try {
+        const saved = await read();
+        if (!migrate) return saved;
+        const migrated = await migrate(saved);
+        if (migrated !== null && migrated !== saved)
+          await storage.set(key, JSON.stringify(migrated));
+        return migrated;
+      } catch (error) {
+        console.warn("[session] The saved layout could not be read; starting from defaults", error);
+        return null;
+      }
+    },
+    save: (value) => writer.schedule(key, JSON.stringify(value)),
+    async clear() {
+      writer.cancel(key);
+      await storage.remove(key);
+    }
+  };
+}
+export {
+  createDebouncedWriter,
+  createStoragePersist,
+  flushOnPageExit
+};
+//# sourceMappingURL=persist.js.map

package/dist/session/persist.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/session/persist.ts"],
+  "sourcesContent": ["/**\n * Keeping the session's layout across reloads: a host gives the session store a\n * {@link ArbiSessionPersist} (where the saved layout is read and written), and the store reads it\n * once at start and writes it after each change. {@link createStoragePersist} makes one from any\n * key-value storage (IndexedDB, `localStorage`), writing at most once per quiet period and on page\n * exit, so a stream of changes (dragging a column) is one write and a reload never loses the last.\n */\n\n/** Where a session store keeps its saved layout. */\nexport interface ArbiSessionPersist<T = unknown> {\n  /** The saved value, or null when none (or it cannot be read). Never rejects. */\n  load(): Promise<T | null>\n  /** Save the latest value (may be written later; the latest one wins). */\n  save(value: T): void\n  /** Forget the saved value (signing out). */\n  clear?(): Promise<void>\n}\n\n/** A key-value storage, asynchronous or not (IndexedDB, `localStorage`). */\nexport interface ArbiKeyValueStorage {\n  get(key: string): Promise<string | null> | string | null\n  set(key: string, value: string): Promise<void> | void\n  remove(key: string): Promise<void> | void\n}\n\nexport interface DebouncedWriterOptions {\n  /** Performs the write. Errors are reported through `onError`, never thrown to the caller. */\n  write: (key: string, value: string) => Promise<void> | void\n  /** Trailing-edge quiet period. */\n  delayMs: number\n  /** Longest a pending value may wait from its first unwritten change. */\n  maxWaitMs: number\n  onError?: (key: string, error: unknown) => void\n}\n\nexport interface DebouncedWriter {\n  /** Queue `value` as the latest value of `key`. */\n  schedule: (key: string, value: string) => void\n  /** The value queued for `key` but not yet written, if any. */\n  pending: (key: string) => string | undefined\n  /** Drop the queued value of `key` without writing it. */\n  cancel: (key: string) => void\n  /** Write every queued value now. */\n  flushAll: () => void\n}\n\ninterface Pending {\n  value: string\n  timer: ReturnType<typeof setTimeout>\n  /** When the first change not yet written was queued. */\n  firstQueuedAt: number\n}\n\n/**\n * Per-key debounced writer. Rapid successive writes of one key collapse into a single\n * trailing-edge write `delayMs` after the last call; `maxWaitMs` caps how long a steady stream of\n * changes can postpone it.\n */\nexport function createDebouncedWriter({\n  write,\n  delayMs,\n  maxWaitMs,\n  onError,\n}: DebouncedWriterOptions): DebouncedWriter {\n  const queue = new Map<string, Pending>()\n\n  const run = (key: string, value: string) => {\n    try {\n      void Promise.resolve(write(key, value)).catch((error: unknown) => onError?.(key, error))\n    } catch (error) {\n      onError?.(key, error)\n    }\n  }\n\n  const flush = (key: string) => {\n    const entry = queue.get(key)\n    if (!entry) return\n    clearTimeout(entry.timer)\n    queue.delete(key)\n    run(key, entry.value)\n  }\n\n  return {\n    schedule(key, value) {\n      const now = Date.now()\n      const existing = queue.get(key)\n      if (existing) clearTimeout(existing.timer)\n      const firstQueuedAt = existing?.firstQueuedAt ?? now\n      const wait = Math.max(0, Math.min(delayMs, firstQueuedAt + maxWaitMs - now))\n      queue.set(key, { value, firstQueuedAt, timer: setTimeout(() => flush(key), wait) })\n    },\n    pending: (key) => queue.get(key)?.value,\n    cancel(key) {\n      const entry = queue.get(key)\n      if (!entry) return\n      clearTimeout(entry.timer)\n      queue.delete(key)\n    },\n    flushAll() {\n      for (const key of Array.from(queue.keys())) flush(key)\n    },\n  }\n}\n\n/**\n * Flush `writer` whenever the page may be about to go away: `pagehide`, `visibilitychange` to\n * hidden (often the last event a mobile browser delivers) and `beforeunload`. Returns a function\n * that removes the listeners.\n */\nexport function flushOnPageExit(writer: Pick<DebouncedWriter, 'flushAll'>): () => void {\n  if (typeof window === 'undefined' || typeof document === 'undefined') return () => {}\n  const flush = () => writer.flushAll()\n  const onVisibility = () => {\n    if (document.visibilityState === 'hidden') writer.flushAll()\n  }\n  window.addEventListener('beforeunload', flush)\n  window.addEventListener('pagehide', flush)\n  document.addEventListener('visibilitychange', onVisibility)\n  return () => {\n    window.removeEventListener('beforeunload', flush)\n    window.removeEventListener('pagehide', flush)\n    document.removeEventListener('visibilitychange', onVisibility)\n  }\n}\n\nexport interface StoragePersistOptions<T> {\n  storage: ArbiKeyValueStorage\n  /** The storage key. */\n  key: string\n  /** Read a value saved under `key` by an earlier build (default: as JSON). Never throws. */\n  parse?: (saved: unknown) => T | null\n  /**\n   * Bring in what an earlier build saved elsewhere: called on every load with what is saved under\n   * `key` (null: nothing yet), it returns the value to start from. A value other than the one given\n   * is saved under `key` at once, so each piece is brought in once.\n   */\n  migrate?: (saved: T | null) => Promise<T | null>\n  /** Quiet period before a write (default 250 ms), and the longest wait (default 1 s). */\n  delayMs?: number\n  maxWaitMs?: number\n}\n\n/** A {@link ArbiSessionPersist} on a key-value storage, debounced and flushed on page exit. */\nexport function createStoragePersist<T>({\n  storage,\n  key,\n  parse = (saved) => saved as T,\n  migrate,\n  delayMs = 250,\n  maxWaitMs = 1000,\n}: StoragePersistOptions<T>): ArbiSessionPersist<T> {\n  const writer = createDebouncedWriter({\n    write: (k, value) => storage.set(k, value),\n    delayMs,\n    maxWaitMs,\n    onError: (k, error) => console.error(`[session] Failed to save ${k}:`, error),\n  })\n  flushOnPageExit(writer)\n  const read = async (): Promise<T | null> => {\n    // A queued write is the latest value.\n    const pending = writer.pending(key)\n    const raw = pending ?? (await storage.get(key))\n    if (raw === null || raw === undefined) return null\n    return parse(JSON.parse(raw))\n  }\n  return {\n    async load() {\n      try {\n        const saved = await read()\n        if (!migrate) return saved\n        const migrated = await migrate(saved)\n        if (migrated !== null && migrated !== saved)\n          await storage.set(key, JSON.stringify(migrated))\n        return migrated\n      } catch (error) {\n        console.warn('[session] The saved layout could not be read; starting from defaults', error)\n        return null\n      }\n    },\n    save: (value) => writer.schedule(key, JSON.stringify(value)),\n    async clear() {\n      writer.cancel(key)\n      await storage.remove(key)\n    },\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/session/session-hooks.js

@@ -0,0 +1,53 @@
+import { useCallback, useSyncExternalStore } from "react";
+import { useArbiHost } from "../host/config.js";
+import { OWN_SESSION_SLOT } from "../host/merge.js";
+import { createArbiSessionStore } from "./store.js";
+import { createSealedDraftStorage } from "./drafts.js";
+function signedInUser(host) {
+  const state = host.arbi?.session?.getState();
+  return state?.signedIn && state.userExtId ? state.userExtId : null;
+}
+const createOwnStore = (host) => createArbiSessionStore(
+  {},
+  { draftStorage: createSealedDraftStorage({ owner: () => signedInUser(host) }) }
+);
+let moduleDefault = null;
+const defaultStore = () => moduleDefault ??= createArbiSessionStore();
+function useArbiSessionStore() {
+  const host = useArbiHost();
+  if (host.session) return host.session;
+  const own = host[OWN_SESSION_SLOT];
+  if (own) return own.current ??= createOwnStore(host);
+  return defaultStore();
+}
+function useArbiSessionState(selector) {
+  const store = useArbiSessionStore();
+  const select = () => selector(store.getState());
+  return useSyncExternalStore(store.subscribe, select, select);
+}
+function useSessionView(key, fallback) {
+  const store = useArbiSessionStore();
+  const value = useArbiSessionState((state) => state.views.values[key]);
+  const set = useCallback((next) => store.setViewValue(key, next), [store, key]);
+  return [value === void 0 ? fallback : value, set];
+}
+function useTransientView(key, fallback) {
+  const store = useArbiSessionStore();
+  const value = useArbiSessionState((state) => state.views.transient[key]);
+  const set = useCallback((next) => store.setTransientView(key, next), [store, key]);
+  return [value === void 0 ? fallback : value, set];
+}
+function useSessionPageTab(page, fallback) {
+  const store = useArbiSessionStore();
+  const activeTab = useArbiSessionState((state) => state.views.tabs[page]) || fallback;
+  const setActiveTab = useCallback((tab) => store.setPageTab(page, tab), [store, page]);
+  return { activeTab, setActiveTab };
+}
+export {
+  useArbiSessionState,
+  useArbiSessionStore,
+  useSessionPageTab,
+  useSessionView,
+  useTransientView
+};
+//# sourceMappingURL=session-hooks.js.map

package/dist/session/session-hooks.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/session/session-hooks.ts"],
+  "sourcesContent": ["/**\n * The session state the blocks share (see `./store`). A host passes its own {@link ArbiSessionStore}\n * as the host configuration's `session` (ARBI-frontend backs it with its zustand store). Without\n * one, each top-level `<ArbiHost>` keeps an in-memory one, and blocks rendered with no host share a\n * module default, so a standalone block still coordinates with its siblings. A host's own store\n * keeps the composers' drafts across reloads, sealed to the person signed in on the host's `Arbi`\n * and only for them; the module default (no host, so no one signed in) keeps them in memory.\n */\n\nimport { useCallback, useSyncExternalStore } from 'react'\nimport { useArbiHost, type ArbiHostConfig } from '../host/config'\nimport { OWN_SESSION_SLOT } from '../host/merge'\nimport { createArbiSessionStore, type ArbiSessionState, type ArbiSessionStore } from './store'\nimport { createSealedDraftStorage } from './drafts'\n\n/** Who is signed in on the host's `Arbi` (its session), `null` when no one is. */\nfunction signedInUser(host: ArbiHostConfig): string | null {\n  const state = host.arbi?.session?.getState()\n  return state?.signedIn && state.userExtId ? state.userExtId : null\n}\n\n/** A host's own session: in memory, with its drafts kept sealed for the signed-in person. */\nconst createOwnStore = (host: ArbiHostConfig) =>\n  createArbiSessionStore(\n    {},\n    { draftStorage: createSealedDraftStorage({ owner: () => signedInUser(host) }) }\n  )\n\nlet moduleDefault: ArbiSessionStore | null = null\nconst defaultStore = () => (moduleDefault ??= createArbiSessionStore())\n\n/** The session store: its setters, and `getState()` for the state as of now (in callbacks). */\nexport function useArbiSessionStore(): ArbiSessionStore {\n  const host = useArbiHost()\n  if (host.session) return host.session\n  const own = (host as Record<string, unknown>)[OWN_SESSION_SLOT] as\n    { current: ArbiSessionStore | null } | undefined\n  if (own) return (own.current ??= createOwnStore(host))\n  return defaultStore()\n}\n\n/**\n * A slice of the session state; re-renders when it changes. The selector returns a value from the\n * state or a primitive (a new object each call would never settle).\n */\nexport function useArbiSessionState<T>(selector: (state: ArbiSessionState) => T): T {\n  const store = useArbiSessionStore()\n  const select = () => selector(store.getState())\n  return useSyncExternalStore(store.subscribe, select, select)\n}\n\n/**\n * A view setting kept in the session and saved across reloads (`views.values`: a page's view\n * mode, a zoom, a filter box's text), and its setter. `fallback` while none is set.\n */\nexport function useSessionView<T>(key: string, fallback: T): [T, (value: T) => void] {\n  const store = useArbiSessionStore()\n  const value = useArbiSessionState((state) => state.views.values[key]) as T | undefined\n  const set = useCallback((next: T) => store.setViewValue(key, next), [store, key])\n  return [value === undefined ? fallback : value, set]\n}\n\n/**\n * View state kept for this session only (`views.transient`: a search's results, a one-shot\n * request), and its setter (`undefined` drops it). `fallback` while none is set.\n */\nexport function useTransientView<T>(key: string, fallback: T): [T, (value: T | undefined) => void] {\n  const store = useArbiSessionStore()\n  const value = useArbiSessionState((state) => state.views.transient[key]) as T | undefined\n  const set = useCallback((next: T | undefined) => store.setTransientView(key, next), [store, key])\n  return [value === undefined ? fallback : value, set]\n}\n\n/** A page's selected tab, kept across reloads; the host supplies its default tab. */\nexport function useSessionPageTab(\n  page: string,\n  fallback: string\n): {\n  activeTab: string\n  setActiveTab: (tab: string) => void\n} {\n  const store = useArbiSessionStore()\n  const activeTab = useArbiSessionState((state) => state.views.tabs[page]) || fallback\n  const setActiveTab = useCallback((tab: string) => store.setPageTab(page, tab), [store, page])\n  return { activeTab, setActiveTab }\n}\n"],
+  "mappings": "AASA,SAAS,aAAa,4BAA4B;AAClD,SAAS,mBAAwC;AACjD,SAAS,wBAAwB;AACjC,SAAS,8BAA4E;AACrF,SAAS,gCAAgC;AAGzC,SAAS,aAAa,MAAqC;AACzD,QAAM,QAAQ,KAAK,MAAM,SAAS,SAAS;AAC3C,SAAO,OAAO,YAAY,MAAM,YAAY,MAAM,YAAY;AAChE;AAGA,MAAM,iBAAiB,CAAC,SACtB;AAAA,EACE,CAAC;AAAA,EACD,EAAE,cAAc,yBAAyB,EAAE,OAAO,MAAM,aAAa,IAAI,EAAE,CAAC,EAAE;AAChF;AAEF,IAAI,gBAAyC;AAC7C,MAAM,eAAe,MAAO,kBAAkB,uBAAuB;AAG9D,SAAS,sBAAwC;AACtD,QAAM,OAAO,YAAY;AACzB,MAAI,KAAK,QAAS,QAAO,KAAK;AAC9B,QAAM,MAAO,KAAiC,gBAAgB;AAE9D,MAAI,IAAK,QAAQ,IAAI,YAAY,eAAe,IAAI;AACpD,SAAO,aAAa;AACtB;AAMO,SAAS,oBAAuB,UAA6C;AAClF,QAAM,QAAQ,oBAAoB;AAClC,QAAM,SAAS,MAAM,SAAS,MAAM,SAAS,CAAC;AAC9C,SAAO,qBAAqB,MAAM,WAAW,QAAQ,MAAM;AAC7D;AAMO,SAAS,eAAkB,KAAa,UAAsC;AACnF,QAAM,QAAQ,oBAAoB;AAClC,QAAM,QAAQ,oBAAoB,CAAC,UAAU,MAAM,MAAM,OAAO,GAAG,CAAC;AACpE,QAAM,MAAM,YAAY,CAAC,SAAY,MAAM,aAAa,KAAK,IAAI,GAAG,CAAC,OAAO,GAAG,CAAC;AAChF,SAAO,CAAC,UAAU,SAAY,WAAW,OAAO,GAAG;AACrD;AAMO,SAAS,iBAAoB,KAAa,UAAkD;AACjG,QAAM,QAAQ,oBAAoB;AAClC,QAAM,QAAQ,oBAAoB,CAAC,UAAU,MAAM,MAAM,UAAU,GAAG,CAAC;AACvE,QAAM,MAAM,YAAY,CAAC,SAAwB,MAAM,iBAAiB,KAAK,IAAI,GAAG,CAAC,OAAO,GAAG,CAAC;AAChG,SAAO,CAAC,UAAU,SAAY,WAAW,OAAO,GAAG;AACrD;AAGO,SAAS,kBACd,MACA,UAIA;AACA,QAAM,QAAQ,oBAAoB;AAClC,QAAM,YAAY,oBAAoB,CAAC,UAAU,MAAM,MAAM,KAAK,IAAI,CAAC,KAAK;AAC5E,QAAM,eAAe,YAAY,CAAC,QAAgB,MAAM,WAAW,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC;AAC5F,SAAO,EAAE,WAAW,aAAa;AACnC;",
+  "names": []
+}