@withpotter/components 0.13.0-next.101

package/dist/sidebar/rail-editor.js

@@ -0,0 +1,70 @@
+"use client";
+import { Fragment, jsx } from "react/jsx-runtime";
+import { useEffect, useMemo } from "react";
+import { useModuleNavigation } from "@withpotter/pages-core/dashboard/settings/features/_hooks/use-module-navigation";
+import { useAutoSave } from "@withpotter/pages-core/dashboard/settings/_hooks";
+import { RailBody } from "./rail-body";
+import { draftLabels, mergeSectionOrder, withLabel } from "./rail-edits";
+function EditableRailBody({
+  onDone,
+  savedLabels,
+  storedLabels,
+  ...rail
+}) {
+  const nav = useModuleNavigation();
+  const { state, schedule } = useAutoSave(nav.save);
+  const { discard } = nav;
+  useEffect(() => {
+    if (state === "error") discard();
+  }, [state, discard]);
+  useEffect(() => {
+    const onKey = (e) => {
+      if (e.key !== "Escape" || e.defaultPrevented) return;
+      const target = e.target;
+      if (target?.tagName === "INPUT") return;
+      if (document.querySelector(".nav-edit.is-dragging")) return;
+      onDone();
+    };
+    window.addEventListener("keydown", onKey);
+    return () => window.removeEventListener("keydown", onKey);
+  }, [onDone]);
+  const edit = useMemo(
+    () => ({
+      onRename: (key, next) => {
+        nav.setModuleLabels(withLabel(nav.moduleLabels, key, next));
+        schedule();
+      },
+      onReorder: (ids) => {
+        nav.setModuleOrder(mergeSectionOrder(nav.moduleOrder, ids));
+        schedule();
+      },
+      onRenameSection: (id, next) => {
+        nav.setSectionLabels(withLabel(nav.sectionLabels, id, next));
+        schedule();
+      }
+    }),
+    [nav, schedule]
+  );
+  const labels = useMemo(
+    () => draftLabels(savedLabels, storedLabels, nav.moduleLabels),
+    [savedLabels, storedLabels, nav.moduleLabels]
+  );
+  return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(
+    RailBody,
+    {
+      ...rail,
+      onDone,
+      edit,
+      edits: {
+        hidden: nav.hiddenModules,
+        order: nav.moduleOrder,
+        labels,
+        sectionLabels: nav.sectionLabels
+      }
+    }
+  ) });
+}
+export {
+  EditableRailBody
+};
+//# sourceMappingURL=rail-editor.js.map

package/dist/sidebar/rail-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sidebar/rail-editor.tsx"],"sourcesContent":["'use client';\n\nimport { useEffect, useMemo } from 'react';\nimport { useModuleNavigation } from '@withpotter/pages-core/dashboard/settings/features/_hooks/use-module-navigation';\nimport { useAutoSave } from '@withpotter/pages-core/dashboard/settings/_hooks';\nimport { RailBody, type RailBodyProps, type RailEdit } from './rail-body';\nimport { draftLabels, mergeSectionOrder, withLabel } from './rail-edits';\n\ntype Props = Omit<RailBodyProps, 'edit' | 'edits' | 'onConfigure'> & {\n  /** Leave edit mode. */\n  onDone: () => void;\n  /** The labels the rail shows now, and the raw stored ones. */\n  savedLabels: Record<string, string> | undefined;\n  storedLabels: Record<string, string> | undefined;\n};\n\n/**\n * THE RAIL, EDITABLE IN PLACE.\n *\n * Mounted only while editing, so a resting sidebar pays nothing for it. It owns\n * the draft (`useModuleNavigation`, the same hook the Dashboard navigation\n * page uses, so the two cannot disagree) and saves as you go (`useAutoSave`).\n * It draws the ordinary rail with `edit` handlers switched on; a short bar at\n * the top carries Done, Reset and the save status.\n */\nexport function EditableRailBody({\n  onDone,\n  savedLabels,\n  storedLabels,\n  ...rail\n}: Props) {\n  const nav = useModuleNavigation();\n  const { state, schedule } = useAutoSave(nav.save);\n\n  // A failed save leaves the rail showing edits the server does not have, so\n  // it goes back to the server's copy and says so.\n  const { discard } = nav;\n  useEffect(() => {\n    if (state === 'error') discard();\n  }, [state, discard]);\n\n  // Escape leaves edit mode. A name field handles its own Escape first (it\n  // stops the event), and a drag in progress owns the key until it ends.\n  useEffect(() => {\n    const onKey = (e: KeyboardEvent) => {\n      if (e.key !== 'Escape' || e.defaultPrevented) return;\n      const target = e.target as HTMLElement | null;\n      if (target?.tagName === 'INPUT') return;\n      if (document.querySelector('.nav-edit.is-dragging')) return;\n      onDone();\n    };\n    window.addEventListener('keydown', onKey);\n    return () => window.removeEventListener('keydown', onKey);\n  }, [onDone]);\n\n  const edit: RailEdit = useMemo(\n    () => ({\n      onRename: (key, next) => {\n        nav.setModuleLabels(withLabel(nav.moduleLabels, key, next));\n        schedule();\n      },\n      onReorder: (ids) => {\n        nav.setModuleOrder(mergeSectionOrder(nav.moduleOrder, ids));\n        schedule();\n      },\n      onRenameSection: (id, next) => {\n        nav.setSectionLabels(withLabel(nav.sectionLabels, id, next));\n        schedule();\n      },\n    }),\n    [nav, schedule],\n  );\n\n  const labels = useMemo(\n    () => draftLabels(savedLabels, storedLabels, nav.moduleLabels),\n    [savedLabels, storedLabels, nav.moduleLabels],\n  );\n\n  return (\n    <>\n      <RailBody\n        {...rail}\n        onDone={onDone}\n        edit={edit}\n        edits={{\n          hidden: nav.hiddenModules,\n          order: nav.moduleOrder,\n          labels,\n          sectionLabels: nav.sectionLabels,\n        }}\n      />\n    </>\n  );\n}\n"],"mappings":";AA+EI,mBACE,WADF;AA7EJ,SAAS,WAAW,eAAe;AACnC,SAAS,2BAA2B;AACpC,SAAS,mBAAmB;AAC5B,SAAS,gBAAmD;AAC5D,SAAS,aAAa,mBAAmB,iBAAiB;AAmBnD,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAU;AACR,QAAM,MAAM,oBAAoB;AAChC,QAAM,EAAE,OAAO,SAAS,IAAI,YAAY,IAAI,IAAI;AAIhD,QAAM,EAAE,QAAQ,IAAI;AACpB,YAAU,MAAM;AACd,QAAI,UAAU,QAAS,SAAQ;AAAA,EACjC,GAAG,CAAC,OAAO,OAAO,CAAC;AAInB,YAAU,MAAM;AACd,UAAM,QAAQ,CAAC,MAAqB;AAClC,UAAI,EAAE,QAAQ,YAAY,EAAE,iBAAkB;AAC9C,YAAM,SAAS,EAAE;AACjB,UAAI,QAAQ,YAAY,QAAS;AACjC,UAAI,SAAS,cAAc,uBAAuB,EAAG;AACrD,aAAO;AAAA,IACT;AACA,WAAO,iBAAiB,WAAW,KAAK;AACxC,WAAO,MAAM,OAAO,oBAAoB,WAAW,KAAK;AAAA,EAC1D,GAAG,CAAC,MAAM,CAAC;AAEX,QAAM,OAAiB;AAAA,IACrB,OAAO;AAAA,MACL,UAAU,CAAC,KAAK,SAAS;AACvB,YAAI,gBAAgB,UAAU,IAAI,cAAc,KAAK,IAAI,CAAC;AAC1D,iBAAS;AAAA,MACX;AAAA,MACA,WAAW,CAAC,QAAQ;AAClB,YAAI,eAAe,kBAAkB,IAAI,aAAa,GAAG,CAAC;AAC1D,iBAAS;AAAA,MACX;AAAA,MACA,iBAAiB,CAAC,IAAI,SAAS;AAC7B,YAAI,iBAAiB,UAAU,IAAI,eAAe,IAAI,IAAI,CAAC;AAC3D,iBAAS;AAAA,MACX;AAAA,IACF;AAAA,IACA,CAAC,KAAK,QAAQ;AAAA,EAChB;AAEA,QAAM,SAAS;AAAA,IACb,MAAM,YAAY,aAAa,cAAc,IAAI,YAAY;AAAA,IAC7D,CAAC,aAAa,cAAc,IAAI,YAAY;AAAA,EAC9C;AAEA,SACE,gCACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ;AAAA,MACA;AAAA,MACA,OAAO;AAAA,QACL,QAAQ,IAAI;AAAA,QACZ,OAAO,IAAI;AAAA,QACX;AAAA,QACA,eAAe,IAAI;AAAA,MACrB;AAAA;AAAA,EACF,GACF;AAEJ;","names":[]}

package/dist/sidebar/rail-edits.d.ts

@@ -0,0 +1,88 @@
+/** Section ids. They are the keys of `settings.sectionLabels`. */
+export declare const SECTION_IDS: readonly ["manage", "grow"];
+export type SectionId = (typeof SECTION_IDS)[number];
+export declare const SECTION_DEFAULT_LABELS: Record<SectionId, string>;
+/** Longer than this is cut off in the rail anyway. */
+export declare const NAME_MAX = 24;
+/**
+ * Rows that cannot be hidden, and why.
+ *
+ *   home     the dashboard itself; the one door every member has
+ *   inbox    where customer mail lands. A hidden inbox is how mail piles up
+ *            unseen, which is the failure the row exists to prevent
+ *   toolkit  the only way in to Add more and Connectors, so hiding it would
+ *            strand a merchant who later wants to switch something on
+ *
+ * Home and Inbox are also fixed in place and cannot be renamed. Toolkit can be
+ * renamed and moved (it sits with More); it just cannot disappear.
+ */
+export declare const ESSENTIAL_IDS: ReadonlySet<string>;
+/** Rows pinned to their place and to their name. */
+export declare const FIXED_IDS: ReadonlySet<string>;
+export declare const isEssential: (id: string) => boolean;
+/**
+ * The key a rename is stored under. A rename of a catalogue row is stored as
+ * `inventory` (the module id), whatever the row's nav id, because that is what
+ * `moduleLabelFor` reads for `/dashboard/catalog`.
+ */
+export declare function renameKey(id: string, href?: string): string;
+/** Whether a row is hidden by the merchant. Essential rows never are. */
+export declare function isRailHidden(hidden: readonly string[] | undefined, id: string, href?: string): boolean;
+/** The row's name: the merchant's word if they gave one, else the default. */
+export declare function rowLabel(labels: Record<string, string> | undefined, id: string, fallback: string, href?: string): string;
+/** A section's heading: the merchant's word if they gave one. */
+export declare function sectionLabel(labels: Record<string, string> | undefined, id: SectionId): string;
+/**
+ * Put rows in the merchant's order, within one section.
+ *
+ * Rows the order lists take the slots that listed rows occupy, in the order
+ * given. Rows it does not list stay exactly where they were, so a row that
+ * appears later (a new archetype, a permission granted) lands in its default
+ * place and never jumps to the end or to the front. With nothing listed the
+ * rows come back untouched.
+ */
+export declare function applyRailOrder<T>(rows: readonly T[], idOf: (row: T) => string, order: readonly string[] | undefined): T[];
+/**
+ * Fold one section's new order into the stored `moduleOrder`.
+ *
+ * `moduleOrder` is one flat list shared with More and with the older module
+ * list, so the section's ids replace, in place, the positions its ids already
+ * held; ids not yet stored are appended; everything else is left alone.
+ */
+export declare function mergeSectionOrder(stored: readonly string[] | undefined, sectionIds: readonly string[]): string[];
+/** Move the entry at `from` to `to`, as a new array. */
+export declare function moveId(ids: readonly string[], from: number, to: number): string[];
+/** A rename, as the next `labels` map: an empty name clears it. */
+export declare function withLabel(labels: Record<string, string>, key: string, next: string): Record<string, string>;
+/**
+ * Hide a row, or show it again. Clears BOTH spellings of a catalogue row's id
+ * (`catalog` and `inventory`) so "show" always undoes "hide", whichever
+ * editor wrote it. Essential rows are left as they are.
+ */
+export declare function toggleHidden(hidden: readonly string[], id: string, href?: string): string[];
+/** The stored hidden list, without anything that may never be hidden. */
+export declare function usableHidden(hidden: readonly string[] | undefined): string[] | undefined;
+/**
+ * The rows of one section as they should be drawn: the merchant's order, then
+ * (outside edit mode) without the hidden ones. Ordering comes first so the
+ * edited rail is the normal rail plus the hidden rows, in the same places.
+ */
+export declare function arrangeRows<R>(rows: readonly R[], identify: (row: R) => {
+    id: string;
+    href?: string;
+}, edits: {
+    hidden?: readonly string[];
+    order?: readonly string[];
+}, editing: boolean): R[];
+/**
+ * The words to show while editing: what the rail already shows (`effective`),
+ * with this session's unsaved edits laid over it, so a rename appears the
+ * moment it is typed and not after the save round-trip.
+ *
+ * Only keys the merchant touched are taken from the draft. The draft starts as
+ * a copy of the stored labels, and stored labels can hold words the rail
+ * deliberately ignores (`effectiveModuleLabels` drops a stamped `customers`
+ * on a multi-archetype business); copying the whole draft would bring them
+ * back on screen.
+ */
+export declare function draftLabels(effective: Record<string, string> | undefined, stored: Record<string, string> | undefined, draft: Record<string, string>): Record<string, string>;

package/dist/sidebar/rail-edits.js

@@ -0,0 +1,129 @@
+import { MODULE_BY_PATH } from "@withpotter/lib/intents/use-entity-label";
+const SECTION_IDS = ["manage", "grow"];
+const SECTION_DEFAULT_LABELS = {
+  manage: "Manage",
+  grow: "Grow"
+};
+const NAME_MAX = 24;
+const ESSENTIAL_IDS = /* @__PURE__ */ new Set([
+  "home",
+  "inbox",
+  "toolkit"
+]);
+const FIXED_IDS = /* @__PURE__ */ new Set(["home", "inbox"]);
+const isEssential = (id) => ESSENTIAL_IDS.has(id);
+function renameKey(id, href) {
+  const byPath = href ? MODULE_BY_PATH[href.split("?")[0]] : void 0;
+  return byPath ?? id;
+}
+function isRailHidden(hidden, id, href) {
+  if (!hidden?.length || isEssential(id)) return false;
+  const key = renameKey(id, href);
+  return hidden.includes(id) || hidden.includes(key);
+}
+function rowLabel(labels, id, fallback, href) {
+  if (FIXED_IDS.has(id)) return fallback;
+  const word = labels?.[renameKey(id, href)] ?? labels?.[id];
+  return word?.trim() || fallback;
+}
+function sectionLabel(labels, id) {
+  return labels?.[id]?.trim() || SECTION_DEFAULT_LABELS[id];
+}
+function applyRailOrder(rows, idOf, order) {
+  if (!order?.length) return [...rows];
+  const rank = /* @__PURE__ */ new Map();
+  order.forEach((id, i) => {
+    if (!rank.has(id)) rank.set(id, i);
+  });
+  const slots = [];
+  const listed = [];
+  rows.forEach((row, i) => {
+    if (rank.has(idOf(row))) {
+      slots.push(i);
+      listed.push(row);
+    }
+  });
+  listed.sort((a, b) => rank.get(idOf(a)) - rank.get(idOf(b)));
+  const out = [...rows];
+  slots.forEach((slot, i) => {
+    out[slot] = listed[i];
+  });
+  return out;
+}
+function mergeSectionOrder(stored, sectionIds) {
+  const mine = new Set(sectionIds);
+  const next = [...sectionIds];
+  const out = [];
+  let used = 0;
+  for (const id of stored ?? []) {
+    if (mine.has(id)) {
+      if (used < next.length) out.push(next[used++]);
+    } else out.push(id);
+  }
+  while (used < next.length) out.push(next[used++]);
+  return out;
+}
+function moveId(ids, from, to) {
+  if (from === to || from < 0 || to < 0) return [...ids];
+  const out = [...ids];
+  const [moved] = out.splice(from, 1);
+  out.splice(to, 0, moved);
+  return out;
+}
+function withLabel(labels, key, next) {
+  const out = { ...labels };
+  const word = next.trim().slice(0, NAME_MAX);
+  if (!word) delete out[key];
+  else out[key] = word;
+  return out;
+}
+function toggleHidden(hidden, id, href) {
+  if (isEssential(id)) return [...hidden];
+  if (isRailHidden(hidden, id, href)) {
+    const key = renameKey(id, href);
+    return hidden.filter((h) => h !== id && h !== key);
+  }
+  return [...hidden, id];
+}
+function usableHidden(hidden) {
+  return hidden?.filter((id) => !isEssential(id));
+}
+function arrangeRows(rows, identify, edits, editing) {
+  const ordered = applyRailOrder(rows, (r) => identify(r).id, edits.order);
+  if (editing) return ordered;
+  return ordered.filter((r) => {
+    const { id, href } = identify(r);
+    return !isRailHidden(edits.hidden, id, href);
+  });
+}
+function draftLabels(effective, stored, draft) {
+  const out = { ...effective };
+  for (const [key, word] of Object.entries(draft)) {
+    if (word !== stored?.[key]) out[key] = word;
+  }
+  for (const key of Object.keys(stored ?? {})) {
+    if (!(key in draft)) delete out[key];
+  }
+  return out;
+}
+export {
+  ESSENTIAL_IDS,
+  FIXED_IDS,
+  NAME_MAX,
+  SECTION_DEFAULT_LABELS,
+  SECTION_IDS,
+  applyRailOrder,
+  arrangeRows,
+  draftLabels,
+  isEssential,
+  isRailHidden,
+  mergeSectionOrder,
+  moveId,
+  renameKey,
+  rowLabel,
+  sectionLabel,
+  toggleHidden,
+  usableHidden,
+  withLabel
+};
+//# sourceMappingURL=rail-edits.js.map

package/dist/sidebar/rail-edits.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sidebar/rail-edits.ts"],"sourcesContent":["/**\n * THE MERCHANT'S EDITS TO THE RAIL, as pure functions.\n *\n * Three settings shape the rail and they all live on the tenant:\n *\n *   hiddenModules   ids that are not drawn (outside edit mode)\n *   moduleLabels    id -> the merchant's word for the row\n *   moduleOrder     ids in the order the merchant put them\n *   sectionLabels   section id ('manage' | 'grow') -> the merchant's heading\n *\n * Hide and rename were already applied to most rows upstream, by id, in\n * `build-nav-groups`. Order was consumed only by More. This file is what makes\n * the whole rail honour all four, and it is what the in-place editor reads and\n * writes, so editing and drawing cannot disagree about an id.\n *\n * ROW IDS. A row's id is its rail key (`RailRow.key`): the nav item id for an\n * archetype's own work (`events`, `plans`, `orders`), and the hub id for the\n * shared hubs (`inventory`, `payments` for Money, `customers`, `hardware`,\n * `operations`, `marketing`, `analytics`, `website`). The Inbox, Toolkit and\n * More use `inbox`, `toolkit` and `more`.\n */\nimport { MODULE_BY_PATH } from '@withpotter/lib/intents/use-entity-label';\n\n/** Section ids. They are the keys of `settings.sectionLabels`. */\nexport const SECTION_IDS = ['manage', 'grow'] as const;\nexport type SectionId = (typeof SECTION_IDS)[number];\n\nexport const SECTION_DEFAULT_LABELS: Record<SectionId, string> = {\n  manage: 'Manage',\n  grow: 'Grow',\n};\n\n/** Longer than this is cut off in the rail anyway. */\nexport const NAME_MAX = 24;\n\n/**\n * Rows that cannot be hidden, and why.\n *\n *   home     the dashboard itself; the one door every member has\n *   inbox    where customer mail lands. A hidden inbox is how mail piles up\n *            unseen, which is the failure the row exists to prevent\n *   toolkit  the only way in to Add more and Connectors, so hiding it would\n *            strand a merchant who later wants to switch something on\n *\n * Home and Inbox are also fixed in place and cannot be renamed. Toolkit can be\n * renamed and moved (it sits with More); it just cannot disappear.\n */\nexport const ESSENTIAL_IDS: ReadonlySet<string> = new Set([\n  'home',\n  'inbox',\n  'toolkit',\n]);\n\n/** Rows pinned to their place and to their name. */\nexport const FIXED_IDS: ReadonlySet<string> = new Set(['home', 'inbox']);\n\nexport const isEssential = (id: string) => ESSENTIAL_IDS.has(id);\n\n/**\n * The key a rename is stored under. A rename of a catalogue row is stored as\n * `inventory` (the module id), whatever the row's nav id, because that is what\n * `moduleLabelFor` reads for `/dashboard/catalog`.\n */\nexport function renameKey(id: string, href?: string): string {\n  const byPath = href ? MODULE_BY_PATH[href.split('?')[0]] : undefined;\n  return byPath ?? id;\n}\n\n/** Whether a row is hidden by the merchant. Essential rows never are. */\nexport function isRailHidden(\n  hidden: readonly string[] | undefined,\n  id: string,\n  href?: string,\n): boolean {\n  if (!hidden?.length || isEssential(id)) return false;\n  const key = renameKey(id, href);\n  return hidden.includes(id) || hidden.includes(key);\n}\n\n/** The row's name: the merchant's word if they gave one, else the default. */\nexport function rowLabel(\n  labels: Record<string, string> | undefined,\n  id: string,\n  fallback: string,\n  href?: string,\n): string {\n  if (FIXED_IDS.has(id)) return fallback;\n  const word = labels?.[renameKey(id, href)] ?? labels?.[id];\n  return word?.trim() || fallback;\n}\n\n/** A section's heading: the merchant's word if they gave one. */\nexport function sectionLabel(\n  labels: Record<string, string> | undefined,\n  id: SectionId,\n): string {\n  return labels?.[id]?.trim() || SECTION_DEFAULT_LABELS[id];\n}\n\n/**\n * Put rows in the merchant's order, within one section.\n *\n * Rows the order lists take the slots that listed rows occupy, in the order\n * given. Rows it does not list stay exactly where they were, so a row that\n * appears later (a new archetype, a permission granted) lands in its default\n * place and never jumps to the end or to the front. With nothing listed the\n * rows come back untouched.\n */\nexport function applyRailOrder<T>(\n  rows: readonly T[],\n  idOf: (row: T) => string,\n  order: readonly string[] | undefined,\n): T[] {\n  if (!order?.length) return [...rows];\n  const rank = new Map<string, number>();\n  order.forEach((id, i) => {\n    if (!rank.has(id)) rank.set(id, i);\n  });\n  const slots: number[] = [];\n  const listed: T[] = [];\n  rows.forEach((row, i) => {\n    if (rank.has(idOf(row))) {\n      slots.push(i);\n      listed.push(row);\n    }\n  });\n  // Array.prototype.sort is stable, so duplicate ids keep their default order.\n  listed.sort((a, b) => rank.get(idOf(a))! - rank.get(idOf(b))!);\n  const out = [...rows];\n  slots.forEach((slot, i) => {\n    out[slot] = listed[i];\n  });\n  return out;\n}\n\n/**\n * Fold one section's new order into the stored `moduleOrder`.\n *\n * `moduleOrder` is one flat list shared with More and with the older module\n * list, so the section's ids replace, in place, the positions its ids already\n * held; ids not yet stored are appended; everything else is left alone.\n */\nexport function mergeSectionOrder(\n  stored: readonly string[] | undefined,\n  sectionIds: readonly string[],\n): string[] {\n  const mine = new Set(sectionIds);\n  const next = [...sectionIds];\n  const out: string[] = [];\n  let used = 0;\n  for (const id of stored ?? []) {\n    if (mine.has(id)) {\n      if (used < next.length) out.push(next[used++]);\n    } else out.push(id);\n  }\n  while (used < next.length) out.push(next[used++]);\n  return out;\n}\n\n/** Move the entry at `from` to `to`, as a new array. */\nexport function moveId(ids: readonly string[], from: number, to: number) {\n  if (from === to || from < 0 || to < 0) return [...ids];\n  const out = [...ids];\n  const [moved] = out.splice(from, 1);\n  out.splice(to, 0, moved);\n  return out;\n}\n\n/** A rename, as the next `labels` map: an empty name clears it. */\nexport function withLabel(\n  labels: Record<string, string>,\n  key: string,\n  next: string,\n): Record<string, string> {\n  const out = { ...labels };\n  const word = next.trim().slice(0, NAME_MAX);\n  if (!word) delete out[key];\n  else out[key] = word;\n  return out;\n}\n\n/**\n * Hide a row, or show it again. Clears BOTH spellings of a catalogue row's id\n * (`catalog` and `inventory`) so \"show\" always undoes \"hide\", whichever\n * editor wrote it. Essential rows are left as they are.\n */\nexport function toggleHidden(\n  hidden: readonly string[],\n  id: string,\n  href?: string,\n): string[] {\n  if (isEssential(id)) return [...hidden];\n  if (isRailHidden(hidden, id, href)) {\n    const key = renameKey(id, href);\n    return hidden.filter((h) => h !== id && h !== key);\n  }\n  return [...hidden, id];\n}\n\n/** The stored hidden list, without anything that may never be hidden. */\nexport function usableHidden(\n  hidden: readonly string[] | undefined,\n): string[] | undefined {\n  return hidden?.filter((id) => !isEssential(id));\n}\n\n/**\n * The rows of one section as they should be drawn: the merchant's order, then\n * (outside edit mode) without the hidden ones. Ordering comes first so the\n * edited rail is the normal rail plus the hidden rows, in the same places.\n */\nexport function arrangeRows<R>(\n  rows: readonly R[],\n  identify: (row: R) => { id: string; href?: string },\n  edits: { hidden?: readonly string[]; order?: readonly string[] },\n  editing: boolean,\n): R[] {\n  const ordered = applyRailOrder(rows, (r) => identify(r).id, edits.order);\n  if (editing) return ordered;\n  return ordered.filter((r) => {\n    const { id, href } = identify(r);\n    return !isRailHidden(edits.hidden, id, href);\n  });\n}\n\n/**\n * The words to show while editing: what the rail already shows (`effective`),\n * with this session's unsaved edits laid over it, so a rename appears the\n * moment it is typed and not after the save round-trip.\n *\n * Only keys the merchant touched are taken from the draft. The draft starts as\n * a copy of the stored labels, and stored labels can hold words the rail\n * deliberately ignores (`effectiveModuleLabels` drops a stamped `customers`\n * on a multi-archetype business); copying the whole draft would bring them\n * back on screen.\n */\nexport function draftLabels(\n  effective: Record<string, string> | undefined,\n  stored: Record<string, string> | undefined,\n  draft: Record<string, string>,\n): Record<string, string> {\n  const out = { ...effective };\n  for (const [key, word] of Object.entries(draft)) {\n    if (word !== stored?.[key]) out[key] = word;\n  }\n  for (const key of Object.keys(stored ?? {})) {\n    if (!(key in draft)) delete out[key];\n  }\n  return out;\n}\n"],"mappings":"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","names":[]}

package/dist/sidebar/rail-label.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A collapsed rail is icon-only, so the label IS the affordance — and it was
+ * being delivered by the native `title` attribute: ~1s browser delay, unstyled
+ * OS chrome, unthemeable, and inconsistently announced by screen readers.
+ *
+ * This routes it through the app's own Tooltip (200ms, themed, positioned) and
+ * adds the aria-label that `title` was standing in for. Expanded, the visible
+ * text is the label, so it passes straight through untouched.
+ */
+export declare function RailLabel({ label, collapsed, children, }: {
+    label: string;
+    collapsed: boolean;
+    children: React.ReactElement;
+}): import("react").JSX.Element;

package/dist/sidebar/rail-label.js

@@ -0,0 +1,15 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { Tooltip } from "@withpotter/ui-kit/tooltip";
+function RailLabel({
+  label,
+  collapsed,
+  children
+}) {
+  if (!collapsed) return children;
+  return /* @__PURE__ */ jsx(Tooltip, { label, side: "right", children });
+}
+export {
+  RailLabel
+};
+//# sourceMappingURL=rail-label.js.map

package/dist/sidebar/rail-label.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sidebar/rail-label.tsx"],"sourcesContent":["'use client';\n\nimport { Tooltip } from '@withpotter/ui-kit/tooltip';\n\n/**\n * A collapsed rail is icon-only, so the label IS the affordance — and it was\n * being delivered by the native `title` attribute: ~1s browser delay, unstyled\n * OS chrome, unthemeable, and inconsistently announced by screen readers.\n *\n * This routes it through the app's own Tooltip (200ms, themed, positioned) and\n * adds the aria-label that `title` was standing in for. Expanded, the visible\n * text is the label, so it passes straight through untouched.\n */\nexport function RailLabel({\n  label,\n  collapsed,\n  children,\n}: {\n  label: string;\n  collapsed: boolean;\n  children: React.ReactElement;\n}) {\n  if (!collapsed) return children;\n  return (\n    <Tooltip label={label} side=\"right\">\n      {children}\n    </Tooltip>\n  );\n}\n"],"mappings":";AAwBI;AAtBJ,SAAS,eAAe;AAWjB,SAAS,UAAU;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,MAAI,CAAC,UAAW,QAAO;AACvB,SACE,oBAAC,WAAQ,OAAc,MAAK,SACzB,UACH;AAEJ;","names":[]}

package/dist/sidebar/rail-rows.d.ts

@@ -0,0 +1,52 @@
+import type { ReactNode } from 'react';
+import type { NavGroup, NavItem } from './config';
+export interface RailRow {
+    key: string;
+    ref: NavItem | NavGroup;
+    node: () => ReactNode;
+}
+/**
+ * THE RAIL'S SECTIONS, in the order John set (2026-10-11):
+ *
+ *   (no heading)  Home, Inbox, Money   Home and Inbox are drawn by the
+ *                                      sidebar; Money is `moneyRow` here
+ *   Manage        the archetype hubs (Products, Events, ...), then Customers,
+ *                 Hardware (when present), then Operations
+ *   Grow          Marketing, Analytics, Website
+ *   (no heading)  Toolkit, More        the bottom, near the Support footer
+ *
+ * Money is a daily door of its own, like the Inbox, and no longer one of the
+ * things you manage. It is still the same hub (Wallet, Transactions, Invoices,
+ * Payouts, Disputes; a hardware-only role gets the one-row 'POS terminal'
+ * variant) with the same gating, badges and active highlight; only where it is
+ * drawn changed. Nothing here changes what a row is or when it shows: every row
+ * still self-gates (permission, hidden module, no hub), so a member who lacks
+ * Money or Customers simply has a shorter list, and an empty section draws
+ * nothing (NavSection returns null on no children).
+ *
+ * Inside Manage, one business's own work comes first, in the order it has
+ * always led in: what you sell (the Inventory hub), then the archetypes' rows,
+ * then the whole catalogue's Collections when no catalogue row holds it, then
+ * the archetypes' remaining rows. Customers, Hardware and Operations follow
+ * because they are shared by every archetype, so a two-archetype business gets
+ * several hubs, each with its own Collections child, before them.
+ */
+export declare function buildRailRows(input: {
+    inventoryHub?: NavGroup | null;
+    payHub?: NavGroup | null;
+    primaryWork: NavItem[];
+    extraWork?: NavItem[];
+    collectionsItem?: NavItem | null;
+    collectionsNested?: boolean;
+    customersHub?: NavGroup | null;
+    hardwareHub?: NavGroup | null;
+    operationsHub?: NavGroup | null;
+    growHubs?: (NavGroup | null | undefined)[];
+    renderHub: (group: NavGroup) => ReactNode;
+    renderRow: (item: NavItem) => ReactNode;
+    renderWorkRow: (item: NavItem) => ReactNode;
+}): {
+    moneyRow: RailRow | null;
+    manageRows: RailRow[];
+    growRows: RailRow[];
+};

package/dist/sidebar/rail-rows.js

@@ -0,0 +1,47 @@
+function buildRailRows(input) {
+  const {
+    inventoryHub,
+    payHub,
+    primaryWork,
+    extraWork = [],
+    collectionsItem,
+    collectionsNested,
+    customersHub,
+    hardwareHub,
+    operationsHub,
+    growHubs = [],
+    renderHub,
+    renderRow,
+    renderWorkRow
+  } = input;
+  const hub = (key, g) => g ? [{ key, ref: g, node: () => renderHub(g) }] : [];
+  const work = (items) => items.map((item) => ({
+    key: item.id,
+    ref: item,
+    node: () => renderWorkRow(item)
+  }));
+  const collectionsRow = !inventoryHub && collectionsItem && !collectionsNested ? [
+    {
+      key: "collections",
+      ref: collectionsItem,
+      node: () => renderRow(collectionsItem)
+    }
+  ] : [];
+  return {
+    moneyRow: hub("payments", payHub)[0] ?? null,
+    manageRows: [
+      ...hub("inventory", inventoryHub),
+      ...work(primaryWork),
+      ...collectionsRow,
+      ...work(extraWork),
+      ...hub("customers", customersHub),
+      ...hub("hardware", hardwareHub),
+      ...hub("operations", operationsHub)
+    ],
+    growRows: growHubs.flatMap((g) => hub(g?.id ?? "grow", g))
+  };
+}
+export {
+  buildRailRows
+};
+//# sourceMappingURL=rail-rows.js.map

package/dist/sidebar/rail-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sidebar/rail-rows.ts"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { NavGroup, NavItem } from './config';\n\nexport interface RailRow {\n  key: string;\n  ref: NavItem | NavGroup;\n  node: () => ReactNode;\n}\n\n/**\n * THE RAIL'S SECTIONS, in the order John set (2026-10-11):\n *\n *   (no heading)  Home, Inbox, Money   Home and Inbox are drawn by the\n *                                      sidebar; Money is `moneyRow` here\n *   Manage        the archetype hubs (Products, Events, ...), then Customers,\n *                 Hardware (when present), then Operations\n *   Grow          Marketing, Analytics, Website\n *   (no heading)  Toolkit, More        the bottom, near the Support footer\n *\n * Money is a daily door of its own, like the Inbox, and no longer one of the\n * things you manage. It is still the same hub (Wallet, Transactions, Invoices,\n * Payouts, Disputes; a hardware-only role gets the one-row 'POS terminal'\n * variant) with the same gating, badges and active highlight; only where it is\n * drawn changed. Nothing here changes what a row is or when it shows: every row\n * still self-gates (permission, hidden module, no hub), so a member who lacks\n * Money or Customers simply has a shorter list, and an empty section draws\n * nothing (NavSection returns null on no children).\n *\n * Inside Manage, one business's own work comes first, in the order it has\n * always led in: what you sell (the Inventory hub), then the archetypes' rows,\n * then the whole catalogue's Collections when no catalogue row holds it, then\n * the archetypes' remaining rows. Customers, Hardware and Operations follow\n * because they are shared by every archetype, so a two-archetype business gets\n * several hubs, each with its own Collections child, before them.\n */\nexport function buildRailRows(input: {\n  inventoryHub?: NavGroup | null;\n  payHub?: NavGroup | null;\n  primaryWork: NavItem[];\n  extraWork?: NavItem[];\n  collectionsItem?: NavItem | null;\n  collectionsNested?: boolean;\n  customersHub?: NavGroup | null;\n  hardwareHub?: NavGroup | null;\n  operationsHub?: NavGroup | null;\n  growHubs?: (NavGroup | null | undefined)[];\n  renderHub: (group: NavGroup) => ReactNode;\n  renderRow: (item: NavItem) => ReactNode;\n  renderWorkRow: (item: NavItem) => ReactNode;\n}): {\n  moneyRow: RailRow | null;\n  manageRows: RailRow[];\n  growRows: RailRow[];\n} {\n  const {\n    inventoryHub,\n    payHub,\n    primaryWork,\n    extraWork = [],\n    collectionsItem,\n    collectionsNested,\n    customersHub,\n    hardwareHub,\n    operationsHub,\n    growHubs = [],\n    renderHub,\n    renderRow,\n    renderWorkRow,\n  } = input;\n  const hub = (key: string, g: NavGroup | null | undefined): RailRow[] =>\n    g ? [{ key, ref: g, node: () => renderHub(g) }] : [];\n  const work = (items: NavItem[]): RailRow[] =>\n    items.map((item) => ({\n      key: item.id,\n      ref: item,\n      node: () => renderWorkRow(item),\n    }));\n  // With no catalogue row to hold it, Collections is a tool for the whole\n  // catalogue and not one intent's work, so it keeps a row of its own.\n  const collectionsRow: RailRow[] =\n    !inventoryHub && collectionsItem && !collectionsNested\n      ? [\n          {\n            key: 'collections',\n            ref: collectionsItem,\n            node: () => renderRow(collectionsItem),\n          },\n        ]\n      : [];\n  return {\n    moneyRow: hub('payments', payHub)[0] ?? null,\n    manageRows: [\n      ...hub('inventory', inventoryHub),\n      ...work(primaryWork),\n      ...collectionsRow,\n      ...work(extraWork),\n      ...hub('customers', customersHub),\n      ...hub('hardware', hardwareHub),\n      ...hub('operations', operationsHub),\n    ],\n    growRows: growHubs.flatMap((g) => hub(g?.id ?? 'grow', g)),\n  };\n}\n"],"mappings":"AAmCO,SAAS,cAAc,OAkB5B;AACA,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY,CAAC;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW,CAAC;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AACJ,QAAM,MAAM,CAAC,KAAa,MACxB,IAAI,CAAC,EAAE,KAAK,KAAK,GAAG,MAAM,MAAM,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC;AACrD,QAAM,OAAO,CAAC,UACZ,MAAM,IAAI,CAAC,UAAU;AAAA,IACnB,KAAK,KAAK;AAAA,IACV,KAAK;AAAA,IACL,MAAM,MAAM,cAAc,IAAI;AAAA,EAChC,EAAE;AAGJ,QAAM,iBACJ,CAAC,gBAAgB,mBAAmB,CAAC,oBACjC;AAAA,IACE;AAAA,MACE,KAAK;AAAA,MACL,KAAK;AAAA,MACL,MAAM,MAAM,UAAU,eAAe;AAAA,IACvC;AAAA,EACF,IACA,CAAC;AACP,SAAO;AAAA,IACL,UAAU,IAAI,YAAY,MAAM,EAAE,CAAC,KAAK;AAAA,IACxC,YAAY;AAAA,MACV,GAAG,IAAI,aAAa,YAAY;AAAA,MAChC,GAAG,KAAK,WAAW;AAAA,MACnB,GAAG;AAAA,MACH,GAAG,KAAK,SAAS;AAAA,MACjB,GAAG,IAAI,aAAa,YAAY;AAAA,MAChC,GAAG,IAAI,YAAY,WAAW;AAAA,MAC9B,GAAG,IAAI,cAAc,aAAa;AAAA,IACpC;AAAA,IACA,UAAU,SAAS,QAAQ,CAAC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,CAAC;AAAA,EAC3D;AACF;","names":[]}

package/dist/sidebar/route-context.d.ts

@@ -0,0 +1,20 @@
+/**
+ * WHICH RAIL A ROUTE BELONGS TO.
+ *
+ * The settings drill-in covers /settings only — account settings live in a
+ * modal now, and /workspaces shows the main nav. Account routes (profile,
+ * security, preferences, data & privacy, legal) show the ACCOUNT rail;
+ * drilling into a workspace setting swaps it for THAT workspace's rail, headed
+ * by the workspace and returning to its hub.
+ *
+ * HARDWARE IS NOT SETTINGS. It was, from 2026-09-03, and `/dashboard/hardware/*`
+ * joined the drill-in so a merchant deep in a request was not left standing on
+ * a rail that said they were nowhere. It moved to the Money group on
+ * 2026-10-05, so it renders the main rail again, where its Money row is lit by
+ * the address.
+ */
+export declare function railContextFor(pathname: string): {
+    inSettings: boolean;
+    isAccountContext: boolean;
+    businessContext: boolean;
+};

package/dist/sidebar/route-context.js

@@ -0,0 +1,16 @@
+import { ACCOUNT_ROUTE_PREFIXES } from "./config";
+function railContextFor(pathname) {
+  const inSettings = pathname.startsWith("/dashboard/settings");
+  const isAccountContext = ACCOUNT_ROUTE_PREFIXES.some(
+    (p) => pathname.startsWith(p)
+  );
+  return {
+    inSettings,
+    isAccountContext,
+    businessContext: inSettings && !isAccountContext
+  };
+}
+export {
+  railContextFor
+};
+//# sourceMappingURL=route-context.js.map

package/dist/sidebar/route-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sidebar/route-context.ts"],"sourcesContent":["import { ACCOUNT_ROUTE_PREFIXES } from './config';\n\n/**\n * WHICH RAIL A ROUTE BELONGS TO.\n *\n * The settings drill-in covers /settings only — account settings live in a\n * modal now, and /workspaces shows the main nav. Account routes (profile,\n * security, preferences, data & privacy, legal) show the ACCOUNT rail;\n * drilling into a workspace setting swaps it for THAT workspace's rail, headed\n * by the workspace and returning to its hub.\n *\n * HARDWARE IS NOT SETTINGS. It was, from 2026-09-03, and `/dashboard/hardware/*`\n * joined the drill-in so a merchant deep in a request was not left standing on\n * a rail that said they were nowhere. It moved to the Money group on\n * 2026-10-05, so it renders the main rail again, where its Money row is lit by\n * the address.\n */\nexport function railContextFor(pathname: string): {\n  inSettings: boolean;\n  isAccountContext: boolean;\n  businessContext: boolean;\n} {\n  const inSettings = pathname.startsWith('/dashboard/settings');\n  const isAccountContext = ACCOUNT_ROUTE_PREFIXES.some((p) =>\n    pathname.startsWith(p),\n  );\n  return {\n    inSettings,\n    isAccountContext,\n    businessContext: inSettings && !isAccountContext,\n  };\n}\n"],"mappings":"AAAA,SAAS,8BAA8B;AAiBhC,SAAS,eAAe,UAI7B;AACA,QAAM,aAAa,SAAS,WAAW,qBAAqB;AAC5D,QAAM,mBAAmB,uBAAuB;AAAA,IAAK,CAAC,MACpD,SAAS,WAAW,CAAC;AAAA,EACvB;AACA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,iBAAiB,cAAc,CAAC;AAAA,EAClC;AACF;","names":[]}

package/dist/sidebar/row-entrance.d.ts

@@ -0,0 +1,42 @@
+/**
+ * A new sidebar row growing open, written so that it leaves nothing behind.
+ *
+ * This used Motion's `animate(li, { height })` and cleared the inline height in
+ * its `.then`. Motion keeps a motion value per animated property and writes
+ * every one of them back to `style` on its next render, which lands a frame
+ * AFTER the promise resolves: the height came back as the row's closed height
+ * (30px) with `overflow` already cleared. Nothing showed until the row was a
+ * hub and was opened, and then its children spilled over the rows below
+ * instead of pushing them down (Dining on Olive, 2026-10-15).
+ *
+ * The Web Animations API has no such shadow state. With `fill: 'backwards'`
+ * the first keyframe holds through the delay, and without a forwards fill the
+ * animation stops affecting the element the moment it ends, so the row goes
+ * back to its natural height whatever opens inside it later.
+ */
+export interface EntranceTarget {
+    style: {
+        height: string;
+        overflow: string;
+        opacity: string;
+    };
+    animate?: (keyframes: Keyframe[], options: KeyframeAnimationOptions) => {
+        finished: Promise<unknown>;
+    };
+}
+export interface EntranceTiming {
+    /** Seconds, as the rest of the rail's motion is written. */
+    duration: number;
+    delay: number;
+    ease: readonly number[];
+}
+/** Hides a row before its first paint, so it never flashes at full size. */
+export declare function holdRow(row: EntranceTarget): void;
+/** Lets a held row go back to its own height, opacity and overflow. */
+export declare function releaseRow(row: EntranceTarget): void;
+/**
+ * Grows a held row to `height` and fades it in. The inline hold is handed to
+ * the animation's first keyframe before it is removed, so there is no frame at
+ * full size in between, and only `overflow` stays inline while it runs.
+ */
+export declare function growRow(row: EntranceTarget, height: number, { duration, delay, ease }: EntranceTiming): Promise<void>;

package/dist/sidebar/row-entrance.js

@@ -0,0 +1,41 @@
+const bezier = (e) => `cubic-bezier(${e.join(", ")})`;
+function holdRow(row) {
+  row.style.overflow = "hidden";
+  row.style.height = "0px";
+  row.style.opacity = "0";
+}
+function releaseRow(row) {
+  row.style.height = "";
+  row.style.overflow = "";
+  row.style.opacity = "";
+}
+function growRow(row, height, { duration, delay, ease }) {
+  if (typeof row.animate !== "function") {
+    releaseRow(row);
+    return Promise.resolve();
+  }
+  const run = row.animate(
+    [
+      { height: "0px", opacity: 0 },
+      { height: `${height}px`, opacity: 1 }
+    ],
+    {
+      duration: duration * 1e3,
+      delay: delay * 1e3,
+      easing: bezier(ease),
+      fill: "backwards"
+    }
+  );
+  row.style.height = "";
+  row.style.opacity = "";
+  return run.finished.then(
+    () => releaseRow(row),
+    () => releaseRow(row)
+  );
+}
+export {
+  growRow,
+  holdRow,
+  releaseRow
+};
+//# sourceMappingURL=row-entrance.js.map

package/dist/sidebar/row-entrance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sidebar/row-entrance.ts"],"sourcesContent":["/**\n * A new sidebar row growing open, written so that it leaves nothing behind.\n *\n * This used Motion's `animate(li, { height })` and cleared the inline height in\n * its `.then`. Motion keeps a motion value per animated property and writes\n * every one of them back to `style` on its next render, which lands a frame\n * AFTER the promise resolves: the height came back as the row's closed height\n * (30px) with `overflow` already cleared. Nothing showed until the row was a\n * hub and was opened, and then its children spilled over the rows below\n * instead of pushing them down (Dining on Olive, 2026-10-15).\n *\n * The Web Animations API has no such shadow state. With `fill: 'backwards'`\n * the first keyframe holds through the delay, and without a forwards fill the\n * animation stops affecting the element the moment it ends, so the row goes\n * back to its natural height whatever opens inside it later.\n */\n\nexport interface EntranceTarget {\n  style: { height: string; overflow: string; opacity: string };\n  animate?: (\n    keyframes: Keyframe[],\n    options: KeyframeAnimationOptions,\n  ) => { finished: Promise<unknown> };\n}\n\nexport interface EntranceTiming {\n  /** Seconds, as the rest of the rail's motion is written. */\n  duration: number;\n  delay: number;\n  ease: readonly number[];\n}\n\nconst bezier = (e: readonly number[]) => `cubic-bezier(${e.join(', ')})`;\n\n/** Hides a row before its first paint, so it never flashes at full size. */\nexport function holdRow(row: EntranceTarget) {\n  row.style.overflow = 'hidden';\n  row.style.height = '0px';\n  row.style.opacity = '0';\n}\n\n/** Lets a held row go back to its own height, opacity and overflow. */\nexport function releaseRow(row: EntranceTarget) {\n  row.style.height = '';\n  row.style.overflow = '';\n  row.style.opacity = '';\n}\n\n/**\n * Grows a held row to `height` and fades it in. The inline hold is handed to\n * the animation's first keyframe before it is removed, so there is no frame at\n * full size in between, and only `overflow` stays inline while it runs.\n */\nexport function growRow(\n  row: EntranceTarget,\n  height: number,\n  { duration, delay, ease }: EntranceTiming,\n): Promise<void> {\n  if (typeof row.animate !== 'function') {\n    releaseRow(row);\n    return Promise.resolve();\n  }\n  const run = row.animate(\n    [\n      { height: '0px', opacity: 0 },\n      { height: `${height}px`, opacity: 1 },\n    ],\n    {\n      duration: duration * 1000,\n      delay: delay * 1000,\n      easing: bezier(ease),\n      fill: 'backwards',\n    },\n  );\n  row.style.height = '';\n  row.style.opacity = '';\n  // Cleared whether the animation finishes or is cancelled: a cancelled one\n  // rejects, and a row left clipped would hide whatever opens inside it.\n  return run.finished.then(\n    () => releaseRow(row),\n    () => releaseRow(row),\n  );\n}\n"],"mappings":"AAgCA,MAAM,SAAS,CAAC,MAAyB,gBAAgB,EAAE,KAAK,IAAI,CAAC;AAG9D,SAAS,QAAQ,KAAqB;AAC3C,MAAI,MAAM,WAAW;AACrB,MAAI,MAAM,SAAS;AACnB,MAAI,MAAM,UAAU;AACtB;AAGO,SAAS,WAAW,KAAqB;AAC9C,MAAI,MAAM,SAAS;AACnB,MAAI,MAAM,WAAW;AACrB,MAAI,MAAM,UAAU;AACtB;AAOO,SAAS,QACd,KACA,QACA,EAAE,UAAU,OAAO,KAAK,GACT;AACf,MAAI,OAAO,IAAI,YAAY,YAAY;AACrC,eAAW,GAAG;AACd,WAAO,QAAQ,QAAQ;AAAA,EACzB;AACA,QAAM,MAAM,IAAI;AAAA,IACd;AAAA,MACE,EAAE,QAAQ,OAAO,SAAS,EAAE;AAAA,MAC5B,EAAE,QAAQ,GAAG,MAAM,MAAM,SAAS,EAAE;AAAA,IACtC;AAAA,IACA;AAAA,MACE,UAAU,WAAW;AAAA,MACrB,OAAO,QAAQ;AAAA,MACf,QAAQ,OAAO,IAAI;AAAA,MACnB,MAAM;AAAA,IACR;AAAA,EACF;AACA,MAAI,MAAM,SAAS;AACnB,MAAI,MAAM,UAAU;AAGpB,SAAO,IAAI,SAAS;AAAA,IAClB,MAAM,WAAW,GAAG;AAAA,IACpB,MAAM,WAAW,GAAG;AAAA,EACtB;AACF;","names":[]}

package/dist/sidebar/settings-nav.d.ts

@@ -0,0 +1,22 @@
+import { resolveEnabledBehaviors } from '@withpotter/lib/resolve-enabled-behaviors';
+/**
+ * The settings drill-in rail.
+ *
+ * Settings replaces the main nav rather than nesting inside it: a settings page
+ * has its own spine, and showing both at once asks the merchant to hold two
+ * navigations in their head. Back returns to the dashboard — not to whatever
+ * settings-shaped index they came through.
+ */
+export declare function SettingsNav({ businessContext, pathname, collapsed, enabledBehaviors, tenant, onBack: settingsBack, }: {
+    /** A workspace's own settings, as opposed to the account rail. */
+    businessContext: boolean;
+    pathname: string;
+    collapsed: boolean;
+    enabledBehaviors: ReturnType<typeof resolveEnabledBehaviors>;
+    tenant: {
+        name?: string;
+        slug?: string;
+        businessName?: string;
+    } | null | undefined;
+    onBack: () => void;
+}): import("react").JSX.Element;