@withpotter/lib 0.13.0-next.101

package/dist/demo-content-poller.js

@@ -0,0 +1,80 @@
+import { isDemoContentBusy, nextPollDelay } from "./demo-content";
+function browserDemoPollEnv() {
+  return {
+    isVisible: () => document.visibilityState !== "hidden",
+    onVisibilityChange: (listener) => {
+      document.addEventListener("visibilitychange", listener);
+      return () => document.removeEventListener("visibilitychange", listener);
+    },
+    setTimer: (run, ms) => window.setTimeout(run, ms),
+    clearTimer: (timer) => window.clearTimeout(timer)
+  };
+}
+function startDemoPoller(handlers, env = browserDemoPollEnv()) {
+  let timer = null;
+  let inFlight = false;
+  let stopped = false;
+  let attempt = 0;
+  let failures = 0;
+  let lastKey = "";
+  const clear = () => {
+    if (timer !== null) env.clearTimer(timer);
+    timer = null;
+  };
+  const schedule = (ms) => {
+    clear();
+    if (stopped) return;
+    timer = env.setTimer(() => {
+      timer = null;
+      void ask();
+    }, ms);
+  };
+  async function ask() {
+    if (stopped || inFlight) return;
+    inFlight = true;
+    try {
+      const status = await handlers.read();
+      if (stopped) return;
+      failures = 0;
+      const key = `${status.state}:${status.progress?.phase}:${status.progress?.done}`;
+      attempt = key === lastKey ? attempt + 1 : 0;
+      lastKey = key;
+      handlers.onStatus(status);
+      if (isDemoContentBusy(status)) schedule(nextPollDelay(attempt, 0));
+    } catch (error) {
+      if (stopped) return;
+      failures += 1;
+      handlers.onError(error);
+      schedule(nextPollDelay(attempt, failures));
+    } finally {
+      inFlight = false;
+    }
+  }
+  const stopWatching = env.onVisibilityChange(() => {
+    if (stopped) return;
+    if (!env.isVisible()) {
+      clear();
+      return;
+    }
+    clear();
+    void ask();
+  });
+  void ask();
+  return {
+    refresh: () => {
+      clear();
+      attempt = 0;
+      void ask();
+    },
+    stop: () => {
+      stopped = true;
+      clear();
+      stopWatching();
+    }
+  };
+}
+export {
+  browserDemoPollEnv,
+  startDemoPoller
+};
+//# sourceMappingURL=demo-content-poller.js.map

package/dist/demo-content-poller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/demo-content-poller.ts"],"sourcesContent":["import type { DemoContentStatus } from './api/demo-content';\nimport { isDemoContentBusy, nextPollDelay } from './demo-content';\n\n/**\n * Keeps asking the server how a demo-content job is going until it stops.\n *\n * No React in it, and the clock and the tab are handed in, so a test moves time\n * by hand. The rules:\n *\n * - Asks once straight away, which is also what picks up a job that was\n *   running when the page was closed and opened again.\n * - Keeps asking only while the job is running (`applying` or `clearing`).\n * - A hidden tab stops asking and asks once when it is shown again.\n * - Requests never overlap; the next is timed from the end of the last.\n * - A failed ask is not the end of the job: it backs off and tries again, and\n *   reports the error without losing the last good answer.\n */\nexport interface DemoPollEnv {\n  isVisible: () => boolean;\n  onVisibilityChange: (listener: () => void) => () => void;\n  setTimer: (run: () => void, ms: number) => unknown;\n  clearTimer: (timer: unknown) => void;\n}\n\nexport function browserDemoPollEnv(): DemoPollEnv {\n  return {\n    isVisible: () => document.visibilityState !== 'hidden',\n    onVisibilityChange: (listener) => {\n      document.addEventListener('visibilitychange', listener);\n      return () => document.removeEventListener('visibilitychange', listener);\n    },\n    setTimer: (run, ms) => window.setTimeout(run, ms),\n    clearTimer: (timer) => window.clearTimeout(timer as number),\n  };\n}\n\nexport interface DemoPollHandlers {\n  read: () => Promise<DemoContentStatus>;\n  onStatus: (status: DemoContentStatus) => void;\n  onError: (error: unknown) => void;\n}\n\nexport interface DemoPoller {\n  /** Ask now (after the merchant starts or clears), then keep going while busy. */\n  refresh: () => void;\n  stop: () => void;\n}\n\nexport function startDemoPoller(\n  handlers: DemoPollHandlers,\n  env: DemoPollEnv = browserDemoPollEnv(),\n): DemoPoller {\n  let timer: unknown = null;\n  let inFlight = false;\n  let stopped = false;\n  let attempt = 0;\n  let failures = 0;\n  let lastKey = '';\n\n  const clear = () => {\n    if (timer !== null) env.clearTimer(timer);\n    timer = null;\n  };\n\n  const schedule = (ms: number) => {\n    clear();\n    if (stopped) return;\n    timer = env.setTimer(() => {\n      timer = null;\n      void ask();\n    }, ms);\n  };\n\n  async function ask() {\n    if (stopped || inFlight) return;\n    inFlight = true;\n    try {\n      const status = await handlers.read();\n      if (stopped) return;\n      failures = 0;\n      const key = `${status.state}:${status.progress?.phase}:${status.progress?.done}`;\n      attempt = key === lastKey ? attempt + 1 : 0;\n      lastKey = key;\n      handlers.onStatus(status);\n      if (isDemoContentBusy(status)) schedule(nextPollDelay(attempt, 0));\n    } catch (error) {\n      if (stopped) return;\n      failures += 1;\n      handlers.onError(error);\n      schedule(nextPollDelay(attempt, failures));\n    } finally {\n      inFlight = false;\n    }\n  }\n\n  const stopWatching = env.onVisibilityChange(() => {\n    if (stopped) return;\n    if (!env.isVisible()) {\n      clear();\n      return;\n    }\n    // Shown again: ask once now. The answer decides whether to keep going.\n    clear();\n    void ask();\n  });\n\n  void ask();\n\n  return {\n    refresh: () => {\n      clear();\n      attempt = 0;\n      void ask();\n    },\n    stop: () => {\n      stopped = true;\n      clear();\n      stopWatching();\n    },\n  };\n}\n"],"mappings":"AACA,SAAS,mBAAmB,qBAAqB;AAuB1C,SAAS,qBAAkC;AAChD,SAAO;AAAA,IACL,WAAW,MAAM,SAAS,oBAAoB;AAAA,IAC9C,oBAAoB,CAAC,aAAa;AAChC,eAAS,iBAAiB,oBAAoB,QAAQ;AACtD,aAAO,MAAM,SAAS,oBAAoB,oBAAoB,QAAQ;AAAA,IACxE;AAAA,IACA,UAAU,CAAC,KAAK,OAAO,OAAO,WAAW,KAAK,EAAE;AAAA,IAChD,YAAY,CAAC,UAAU,OAAO,aAAa,KAAe;AAAA,EAC5D;AACF;AAcO,SAAS,gBACd,UACA,MAAmB,mBAAmB,GAC1B;AACZ,MAAI,QAAiB;AACrB,MAAI,WAAW;AACf,MAAI,UAAU;AACd,MAAI,UAAU;AACd,MAAI,WAAW;AACf,MAAI,UAAU;AAEd,QAAM,QAAQ,MAAM;AAClB,QAAI,UAAU,KAAM,KAAI,WAAW,KAAK;AACxC,YAAQ;AAAA,EACV;AAEA,QAAM,WAAW,CAAC,OAAe;AAC/B,UAAM;AACN,QAAI,QAAS;AACb,YAAQ,IAAI,SAAS,MAAM;AACzB,cAAQ;AACR,WAAK,IAAI;AAAA,IACX,GAAG,EAAE;AAAA,EACP;AAEA,iBAAe,MAAM;AACnB,QAAI,WAAW,SAAU;AACzB,eAAW;AACX,QAAI;AACF,YAAM,SAAS,MAAM,SAAS,KAAK;AACnC,UAAI,QAAS;AACb,iBAAW;AACX,YAAM,MAAM,GAAG,OAAO,KAAK,IAAI,OAAO,UAAU,KAAK,IAAI,OAAO,UAAU,IAAI;AAC9E,gBAAU,QAAQ,UAAU,UAAU,IAAI;AAC1C,gBAAU;AACV,eAAS,SAAS,MAAM;AACxB,UAAI,kBAAkB,MAAM,EAAG,UAAS,cAAc,SAAS,CAAC,CAAC;AAAA,IACnE,SAAS,OAAO;AACd,UAAI,QAAS;AACb,kBAAY;AACZ,eAAS,QAAQ,KAAK;AACtB,eAAS,cAAc,SAAS,QAAQ,CAAC;AAAA,IAC3C,UAAE;AACA,iBAAW;AAAA,IACb;AAAA,EACF;AAEA,QAAM,eAAe,IAAI,mBAAmB,MAAM;AAChD,QAAI,QAAS;AACb,QAAI,CAAC,IAAI,UAAU,GAAG;AACpB,YAAM;AACN;AAAA,IACF;AAEA,UAAM;AACN,SAAK,IAAI;AAAA,EACX,CAAC;AAED,OAAK,IAAI;AAET,SAAO;AAAA,IACL,SAAS,MAAM;AACb,YAAM;AACN,gBAAU;AACV,WAAK,IAAI;AAAA,IACX;AAAA,IACA,MAAM,MAAM;AACV,gBAAU;AACV,YAAM;AACN,mBAAa;AAAA,IACf;AAAA,EACF;AACF;","names":[]}

package/dist/demo-content.d.ts

@@ -0,0 +1,43 @@
+import type { DemoContentCounts, DemoContentStatus } from './api/demo-content';
+/**
+ * What the demo-content screens decide, with no React and no network in it, so
+ * every rule is a plain function a test can call.
+ */
+/**
+ * Who may start, clear or re-apply demo content: the owner, or a team member
+ * whose permissions include both managing products and managing settings (the
+ * admin-level role). Matches the server's rule; anyone else is refused there
+ * with `not_owner_or_admin`, so the screens hide the actions first.
+ */
+export declare function canManageDemoContent(role: string | null | undefined, permissions?: Record<string, boolean> | null): boolean;
+/** A job is running on the server; the page keeps asking until it stops. */
+export declare function isDemoContentBusy(status: DemoContentStatus | null): boolean;
+/**
+ * How long to wait before asking again.
+ *
+ * Starts quick so a short job feels live, slows as it runs so a long one does
+ * not hammer the server, and backs off further after each failed ask. `attempt`
+ * counts asks since the last change in the answer; `failures` counts failed
+ * asks in a row.
+ */
+export declare const POLL_FIRST_MS = 1500;
+export declare const POLL_MAX_MS = 10000;
+export declare const POLL_ERROR_MAX_MS = 30000;
+export declare function nextPollDelay(attempt: number, failures: number): number;
+/** 0 to 100, or null when the server has not said how big the job is. */
+export declare function progressPercent(status: DemoContentStatus | null): number | null;
+/** The server's phase name as a short phrase; an unknown phase reads plainly. */
+export declare function phaseLabel(phase: string | undefined, job?: 'apply' | 'clear'): string;
+/** "12 products, 3 collections, 5 pages and 20 pictures" from the counts the server gave. */
+export declare function describeCounts(counts: (Partial<DemoContentCounts> & {
+    images?: number;
+}) | undefined): string | null;
+/**
+ * A product (or collection) the demo pack added and the merchant has not kept.
+ * The server marks it with the tag `demo-pack` and `data.demoPack`; Keep this
+ * removes both.
+ */
+export declare function isDemoProduct(product: {
+    tags?: string[] | null;
+    data?: Record<string, unknown> | null;
+}): boolean;

package/dist/demo-content.js

@@ -0,0 +1,78 @@
+function canManageDemoContent(role, permissions) {
+  if (role === "owner") return true;
+  return permissions?.canManageProducts === true && permissions?.canManageSettings === true;
+}
+function isDemoContentBusy(status) {
+  return status?.state === "applying" || status?.state === "clearing";
+}
+const POLL_FIRST_MS = 1500;
+const POLL_MAX_MS = 1e4;
+const POLL_ERROR_MAX_MS = 3e4;
+function nextPollDelay(attempt, failures) {
+  if (failures > 0) {
+    return Math.min(POLL_ERROR_MAX_MS, POLL_MAX_MS * 2 ** (failures - 1));
+  }
+  return Math.min(POLL_MAX_MS, Math.round(POLL_FIRST_MS * 1.5 ** attempt));
+}
+function progressPercent(status) {
+  const p = status?.progress;
+  if (!p || !(p.total > 0)) return null;
+  return Math.max(0, Math.min(100, Math.round(p.done / p.total * 100)));
+}
+const APPLY_PHASE_LABEL = {
+  fetching: "Getting the demo ready",
+  media: "Adding pictures",
+  products: "Adding products",
+  collections: "Adding collections",
+  content: "Adding content",
+  tenant: "Setting up your store",
+  pages: "Setting up pages",
+  shipping: "Setting up delivery",
+  pruning: "Tidying up",
+  activating: "Making it visible"
+};
+const CLEAR_PHASE_LABEL = {
+  catalogue: "Removing demo products and collections",
+  pages: "Putting pages back",
+  shipping: "Removing demo delivery",
+  settings: "Restoring settings"
+};
+function phaseLabel(phase, job = "apply") {
+  if (!phase) return "Working";
+  const table = job === "clear" ? CLEAR_PHASE_LABEL : APPLY_PHASE_LABEL;
+  return table[phase] ?? "Working";
+}
+function plural(n, one, many) {
+  return `${n.toLocaleString("en-US")} ${n === 1 ? one : many}`;
+}
+function describeCounts(counts) {
+  if (!counts) return null;
+  const parts = [];
+  if (counts.products) parts.push(plural(counts.products, "product", "products"));
+  if (counts.collections)
+    parts.push(plural(counts.collections, "collection", "collections"));
+  if (counts.pages) parts.push(plural(counts.pages, "page", "pages"));
+  const pictures = counts.media ?? counts.images;
+  if (pictures) parts.push(plural(pictures, "picture", "pictures"));
+  if (parts.length === 0) return null;
+  if (parts.length === 1) return parts[0];
+  return `${parts.slice(0, -1).join(", ")} and ${parts[parts.length - 1]}`;
+}
+function isDemoProduct(product) {
+  if (product.tags?.includes("demo-pack")) return true;
+  const d = product.data?.demoPack;
+  return typeof d === "object" && d !== null;
+}
+export {
+  POLL_ERROR_MAX_MS,
+  POLL_FIRST_MS,
+  POLL_MAX_MS,
+  canManageDemoContent,
+  describeCounts,
+  isDemoContentBusy,
+  isDemoProduct,
+  nextPollDelay,
+  phaseLabel,
+  progressPercent
+};
+//# sourceMappingURL=demo-content.js.map

package/dist/demo-content.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/demo-content.ts"],"sourcesContent":["import type {\n  DemoContentCounts,\n  DemoContentStatus,\n} from './api/demo-content';\n\n/**\n * What the demo-content screens decide, with no React and no network in it, so\n * every rule is a plain function a test can call.\n */\n\n/**\n * Who may start, clear or re-apply demo content: the owner, or a team member\n * whose permissions include both managing products and managing settings (the\n * admin-level role). Matches the server's rule; anyone else is refused there\n * with `not_owner_or_admin`, so the screens hide the actions first.\n */\nexport function canManageDemoContent(\n  role: string | null | undefined,\n  permissions?: Record<string, boolean> | null,\n): boolean {\n  if (role === 'owner') return true;\n  return permissions?.canManageProducts === true && permissions?.canManageSettings === true;\n}\n\n/** A job is running on the server; the page keeps asking until it stops. */\nexport function isDemoContentBusy(status: DemoContentStatus | null): boolean {\n  return status?.state === 'applying' || status?.state === 'clearing';\n}\n\n/**\n * How long to wait before asking again.\n *\n * Starts quick so a short job feels live, slows as it runs so a long one does\n * not hammer the server, and backs off further after each failed ask. `attempt`\n * counts asks since the last change in the answer; `failures` counts failed\n * asks in a row.\n */\nexport const POLL_FIRST_MS = 1_500;\nexport const POLL_MAX_MS = 10_000;\nexport const POLL_ERROR_MAX_MS = 30_000;\n\nexport function nextPollDelay(attempt: number, failures: number): number {\n  if (failures > 0) {\n    return Math.min(POLL_ERROR_MAX_MS, POLL_MAX_MS * 2 ** (failures - 1));\n  }\n  return Math.min(POLL_MAX_MS, Math.round(POLL_FIRST_MS * 1.5 ** attempt));\n}\n\n/** 0 to 100, or null when the server has not said how big the job is. */\nexport function progressPercent(status: DemoContentStatus | null): number | null {\n  const p = status?.progress;\n  if (!p || !(p.total > 0)) return null;\n  return Math.max(0, Math.min(100, Math.round((p.done / p.total) * 100)));\n}\n\n/** The server's phases, apply and clear, as short phrases. */\nconst APPLY_PHASE_LABEL: Record<string, string> = {\n  fetching: 'Getting the demo ready',\n  media: 'Adding pictures',\n  products: 'Adding products',\n  collections: 'Adding collections',\n  content: 'Adding content',\n  tenant: 'Setting up your store',\n  pages: 'Setting up pages',\n  shipping: 'Setting up delivery',\n  pruning: 'Tidying up',\n  activating: 'Making it visible',\n};\nconst CLEAR_PHASE_LABEL: Record<string, string> = {\n  catalogue: 'Removing demo products and collections',\n  pages: 'Putting pages back',\n  shipping: 'Removing demo delivery',\n  settings: 'Restoring settings',\n};\n\n/** The server's phase name as a short phrase; an unknown phase reads plainly. */\nexport function phaseLabel(\n  phase: string | undefined,\n  job: 'apply' | 'clear' = 'apply',\n): string {\n  if (!phase) return 'Working';\n  const table = job === 'clear' ? CLEAR_PHASE_LABEL : APPLY_PHASE_LABEL;\n  return table[phase] ?? 'Working';\n}\n\nfunction plural(n: number, one: string, many: string): string {\n  return `${n.toLocaleString('en-US')} ${n === 1 ? one : many}`;\n}\n\n/** \"12 products, 3 collections, 5 pages and 20 pictures\" from the counts the server gave. */\nexport function describeCounts(\n  counts:\n    | (Partial<DemoContentCounts> & { images?: number })\n    | undefined,\n): string | null {\n  if (!counts) return null;\n  const parts: string[] = [];\n  if (counts.products) parts.push(plural(counts.products, 'product', 'products'));\n  if (counts.collections)\n    parts.push(plural(counts.collections, 'collection', 'collections'));\n  if (counts.pages) parts.push(plural(counts.pages, 'page', 'pages'));\n  const pictures = counts.media ?? counts.images;\n  if (pictures) parts.push(plural(pictures, 'picture', 'pictures'));\n  if (parts.length === 0) return null;\n  if (parts.length === 1) return parts[0];\n  return `${parts.slice(0, -1).join(', ')} and ${parts[parts.length - 1]}`;\n}\n\n/**\n * A product (or collection) the demo pack added and the merchant has not kept.\n * The server marks it with the tag `demo-pack` and `data.demoPack`; Keep this\n * removes both.\n */\nexport function isDemoProduct(product: {\n  tags?: string[] | null;\n  data?: Record<string, unknown> | null;\n}): boolean {\n  if (product.tags?.includes('demo-pack')) return true;\n  const d = product.data?.demoPack;\n  return typeof d === 'object' && d !== null;\n}\n"],"mappings":"AAgBO,SAAS,qBACd,MACA,aACS;AACT,MAAI,SAAS,QAAS,QAAO;AAC7B,SAAO,aAAa,sBAAsB,QAAQ,aAAa,sBAAsB;AACvF;AAGO,SAAS,kBAAkB,QAA2C;AAC3E,SAAO,QAAQ,UAAU,cAAc,QAAQ,UAAU;AAC3D;AAUO,MAAM,gBAAgB;AACtB,MAAM,cAAc;AACpB,MAAM,oBAAoB;AAE1B,SAAS,cAAc,SAAiB,UAA0B;AACvE,MAAI,WAAW,GAAG;AAChB,WAAO,KAAK,IAAI,mBAAmB,cAAc,MAAM,WAAW,EAAE;AAAA,EACtE;AACA,SAAO,KAAK,IAAI,aAAa,KAAK,MAAM,gBAAgB,OAAO,OAAO,CAAC;AACzE;AAGO,SAAS,gBAAgB,QAAiD;AAC/E,QAAM,IAAI,QAAQ;AAClB,MAAI,CAAC,KAAK,EAAE,EAAE,QAAQ,GAAI,QAAO;AACjC,SAAO,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,KAAK,MAAO,EAAE,OAAO,EAAE,QAAS,GAAG,CAAC,CAAC;AACxE;AAGA,MAAM,oBAA4C;AAAA,EAChD,UAAU;AAAA,EACV,OAAO;AAAA,EACP,UAAU;AAAA,EACV,aAAa;AAAA,EACb,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,UAAU;AAAA,EACV,SAAS;AAAA,EACT,YAAY;AACd;AACA,MAAM,oBAA4C;AAAA,EAChD,WAAW;AAAA,EACX,OAAO;AAAA,EACP,UAAU;AAAA,EACV,UAAU;AACZ;AAGO,SAAS,WACd,OACA,MAAyB,SACjB;AACR,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,QAAQ,QAAQ,UAAU,oBAAoB;AACpD,SAAO,MAAM,KAAK,KAAK;AACzB;AAEA,SAAS,OAAO,GAAW,KAAa,MAAsB;AAC5D,SAAO,GAAG,EAAE,eAAe,OAAO,CAAC,IAAI,MAAM,IAAI,MAAM,IAAI;AAC7D;AAGO,SAAS,eACd,QAGe;AACf,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,QAAkB,CAAC;AACzB,MAAI,OAAO,SAAU,OAAM,KAAK,OAAO,OAAO,UAAU,WAAW,UAAU,CAAC;AAC9E,MAAI,OAAO;AACT,UAAM,KAAK,OAAO,OAAO,aAAa,cAAc,aAAa,CAAC;AACpE,MAAI,OAAO,MAAO,OAAM,KAAK,OAAO,OAAO,OAAO,QAAQ,OAAO,CAAC;AAClE,QAAM,WAAW,OAAO,SAAS,OAAO;AACxC,MAAI,SAAU,OAAM,KAAK,OAAO,UAAU,WAAW,UAAU,CAAC;AAChE,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,MAAI,MAAM,WAAW,EAAG,QAAO,MAAM,CAAC;AACtC,SAAO,GAAG,MAAM,MAAM,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,QAAQ,MAAM,MAAM,SAAS,CAAC,CAAC;AACxE;AAOO,SAAS,cAAc,SAGlB;AACV,MAAI,QAAQ,MAAM,SAAS,WAAW,EAAG,QAAO;AAChD,QAAM,IAAI,QAAQ,MAAM;AACxB,SAAO,OAAO,MAAM,YAAY,MAAM;AACxC;","names":[]}

package/dist/describe-activity.d.ts

@@ -0,0 +1,44 @@
+/**
+ * How one activity row should read, given that the name attached to it is NOT
+ * the person who acted.
+ *
+ * The api derives this feed from timestamped domain rows, because Box has no
+ * per-action log for tenants. Its `actor` is documented as "the person the
+ * record is ABOUT" — the customer on an order, the member who joined — and its
+ * own header says plainly that it "cannot attribute an action to the staff
+ * member who performed it".
+ *
+ * The card rendered `summary · name`, and the summaries are bare verb phrases
+ * with no subject: "refunded order #1042". Appending a name to a subjectless
+ * verb makes that name the subject. So on the Team settings page, beside the
+ * list of people who hold keys to the business, a row read
+ *
+ *     refunded order #1042 · Chidi Okafor
+ *
+ * and Chidi Okafor is the customer who was refunded, not whoever pressed the
+ * button. The component's own comment was careful about this; the rendering
+ * quietly undid it.
+ *
+ * Fixed by role, not by hiding the name — the name is useful, it just is not an
+ * author:
+ *
+ *   order.*    the name is the customer the order belongs to  → "for X"
+ *   member.*   the name IS the subject of the sentence        → "X joined ..."
+ *   otherwise  no name to place                               → summary alone
+ */
+export interface ActivityRowParts {
+    /** The sentence to render, with the name already placed correctly. */
+    text: string;
+    /**
+     * True when the row genuinely has no person attached. Kept separate so the
+     * card does not have to re-derive it.
+     */
+    nameless: boolean;
+}
+export declare function describeActivityRow(entry: {
+    action?: string;
+    summary: string;
+    actor?: {
+        name?: string;
+    } | null;
+}): ActivityRowParts;

package/dist/describe-activity.js

@@ -0,0 +1,16 @@
+function describeActivityRow(entry) {
+  const name = entry.actor?.name?.trim();
+  if (!name) return { text: entry.summary, nameless: true };
+  const action = entry.action ?? "";
+  if (action.startsWith("order.")) {
+    return { text: `${entry.summary} for ${name}`, nameless: false };
+  }
+  if (action.startsWith("member.")) {
+    return { text: `${name} ${entry.summary}`, nameless: false };
+  }
+  return { text: `${entry.summary} \u2014 ${name}`, nameless: false };
+}
+export {
+  describeActivityRow
+};
+//# sourceMappingURL=describe-activity.js.map

package/dist/describe-activity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/describe-activity.ts"],"sourcesContent":["/**\n * How one activity row should read, given that the name attached to it is NOT\n * the person who acted.\n *\n * The api derives this feed from timestamped domain rows, because Box has no\n * per-action log for tenants. Its `actor` is documented as \"the person the\n * record is ABOUT\" — the customer on an order, the member who joined — and its\n * own header says plainly that it \"cannot attribute an action to the staff\n * member who performed it\".\n *\n * The card rendered `summary · name`, and the summaries are bare verb phrases\n * with no subject: \"refunded order #1042\". Appending a name to a subjectless\n * verb makes that name the subject. So on the Team settings page, beside the\n * list of people who hold keys to the business, a row read\n *\n *     refunded order #1042 · Chidi Okafor\n *\n * and Chidi Okafor is the customer who was refunded, not whoever pressed the\n * button. The component's own comment was careful about this; the rendering\n * quietly undid it.\n *\n * Fixed by role, not by hiding the name — the name is useful, it just is not an\n * author:\n *\n *   order.*    the name is the customer the order belongs to  → \"for X\"\n *   member.*   the name IS the subject of the sentence        → \"X joined ...\"\n *   otherwise  no name to place                               → summary alone\n */\nexport interface ActivityRowParts {\n  /** The sentence to render, with the name already placed correctly. */\n  text: string;\n  /**\n   * True when the row genuinely has no person attached. Kept separate so the\n   * card does not have to re-derive it.\n   */\n  nameless: boolean;\n}\n\nexport function describeActivityRow(entry: {\n  action?: string;\n  summary: string;\n  actor?: { name?: string } | null;\n}): ActivityRowParts {\n  const name = entry.actor?.name?.trim();\n  if (!name) return { text: entry.summary, nameless: true };\n\n  const action = entry.action ?? '';\n\n  // The customer an order belongs to. \"for\" makes the relationship explicit so\n  // the name cannot be read as the person who did it.\n  if (action.startsWith('order.')) {\n    return { text: `${entry.summary} for ${name}`, nameless: false };\n  }\n\n  // The member IS the subject: \"joined as a retail customer\" is their sentence,\n  // so the name leads it rather than trailing after a separator.\n  if (action.startsWith('member.')) {\n    return { text: `${name} ${entry.summary}`, nameless: false };\n  }\n\n  // Unknown shape. Fall back to naming the relationship rather than guessing at\n  // authorship, because guessing wrong is the whole bug this module exists for.\n  return { text: `${entry.summary} — ${name}`, nameless: false };\n}\n"],"mappings":"AAsCO,SAAS,oBAAoB,OAIf;AACnB,QAAM,OAAO,MAAM,OAAO,MAAM,KAAK;AACrC,MAAI,CAAC,KAAM,QAAO,EAAE,MAAM,MAAM,SAAS,UAAU,KAAK;AAExD,QAAM,SAAS,MAAM,UAAU;AAI/B,MAAI,OAAO,WAAW,QAAQ,GAAG;AAC/B,WAAO,EAAE,MAAM,GAAG,MAAM,OAAO,QAAQ,IAAI,IAAI,UAAU,MAAM;AAAA,EACjE;AAIA,MAAI,OAAO,WAAW,SAAS,GAAG;AAChC,WAAO,EAAE,MAAM,GAAG,IAAI,IAAI,MAAM,OAAO,IAAI,UAAU,MAAM;AAAA,EAC7D;AAIA,SAAO,EAAE,MAAM,GAAG,MAAM,OAAO,WAAM,IAAI,IAAI,UAAU,MAAM;AAC/D;","names":[]}

package/dist/describe-invite.d.ts

@@ -0,0 +1,19 @@
+/**
+ * What an invite reaches, and what it does not, in the merchant's words.
+ *
+ * `describeAreas` in team-roles.ts already answers the first half. This answers
+ * both halves, because on the accept screen the second one is the more useful
+ * column: it tells a new hire the shape of their job in four words, and it tells
+ * them that nobody handed them the bank account by accident.
+ *
+ * Administration switches (workspace settings, team, domains) are left out of
+ * BOTH lists. They are not part of anybody's day, and listing three things a
+ * person cannot do turns a welcome into a rejection notice.
+ */
+export interface InviteGrants {
+    /** Areas this invite can reach, by label. */
+    allowed: string[];
+    /** Everyday areas it cannot, by label. */
+    withheld: string[];
+}
+export declare function describeInvite(permissions: Record<string, boolean> | undefined): InviteGrants;

package/dist/describe-invite.js

@@ -0,0 +1,46 @@
+import { PERMISSION_AREAS } from "./team-roles";
+const DOES = {
+  products: { manage: "Add and edit products", view: "See the product list" },
+  orders: {
+    manage: "Take and fulfil orders",
+    view: "Follow orders as they come in"
+  },
+  customers: { manage: "Keep customer records", view: "See who is buying" },
+  discounts: {
+    manage: "Run discounts and offers",
+    view: "See what is on offer"
+  },
+  messages: {
+    manage: "Answer customer messages",
+    view: "Read customer messages"
+  },
+  reviews: { manage: "Reply to reviews", view: "Read reviews" },
+  analytics: {
+    manage: "Dig into how the business is doing",
+    view: "See how the business is doing"
+  },
+  website: { manage: "Edit the website", view: "See the website" },
+  blog: { manage: "Write and publish posts", view: "Read the blog" },
+  money: { manage: "Handle payouts and money", view: "See the money" }
+};
+function describeInvite(permissions) {
+  const granted = permissions ?? {};
+  const everyday = PERMISSION_AREAS.filter((area) => !area.advanced);
+  const allowed = [];
+  const withheld = [];
+  for (const area of everyday) {
+    const phrase = DOES[area.id];
+    if (granted[area.manage]) {
+      allowed.push(phrase?.manage ?? area.label);
+    } else if (area.view && granted[area.view]) {
+      allowed.push(phrase?.view ?? area.label);
+    } else {
+      withheld.push(area.label);
+    }
+  }
+  return { allowed, withheld };
+}
+export {
+  describeInvite
+};
+//# sourceMappingURL=describe-invite.js.map

package/dist/describe-invite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/describe-invite.ts"],"sourcesContent":["import { PERMISSION_AREAS } from './team-roles';\n\n/**\n * What an invite reaches, and what it does not, in the merchant's words.\n *\n * `describeAreas` in team-roles.ts already answers the first half. This answers\n * both halves, because on the accept screen the second one is the more useful\n * column: it tells a new hire the shape of their job in four words, and it tells\n * them that nobody handed them the bank account by accident.\n *\n * Administration switches (workspace settings, team, domains) are left out of\n * BOTH lists. They are not part of anybody's day, and listing three things a\n * person cannot do turns a welcome into a rejection notice.\n */\nexport interface InviteGrants {\n  /** Areas this invite can reach, by label. */\n  allowed: string[];\n  /** Everyday areas it cannot, by label. */\n  withheld: string[];\n}\n\n/**\n * What somebody will DO here, in the words they would use for it.\n *\n * The screen listed the areas by name — \"Products, Orders, Customers\" — which\n * is the permission model's vocabulary, not a job's. Nobody has ever described\n * their work as \"Customers\". A person deciding whether to take a job wants to\n * recognise the job, and a noun cannot be recognised, only looked up.\n *\n * Two phrasings per area, because the difference between reading a screen and\n * working it is the whole difference between two roles that otherwise list the\n * same word. Falls back to the area's label when a new area arrives without a\n * phrase, so the cost of forgetting one is a plain word rather than a gap.\n */\nconst DOES: Record<string, { manage: string; view: string }> = {\n  products: { manage: 'Add and edit products', view: 'See the product list' },\n  orders: {\n    manage: 'Take and fulfil orders',\n    view: 'Follow orders as they come in',\n  },\n  customers: { manage: 'Keep customer records', view: 'See who is buying' },\n  discounts: {\n    manage: 'Run discounts and offers',\n    view: 'See what is on offer',\n  },\n  messages: {\n    manage: 'Answer customer messages',\n    view: 'Read customer messages',\n  },\n  reviews: { manage: 'Reply to reviews', view: 'Read reviews' },\n  analytics: {\n    manage: 'Dig into how the business is doing',\n    view: 'See how the business is doing',\n  },\n  website: { manage: 'Edit the website', view: 'See the website' },\n  blog: { manage: 'Write and publish posts', view: 'Read the blog' },\n  money: { manage: 'Handle payouts and money', view: 'See the money' },\n};\n\nexport function describeInvite(\n  permissions: Record<string, boolean> | undefined,\n): InviteGrants {\n  const granted = permissions ?? {};\n  const everyday = PERMISSION_AREAS.filter((area) => !area.advanced);\n\n  const allowed: string[] = [];\n  const withheld: string[] = [];\n\n  for (const area of everyday) {\n    const phrase = DOES[area.id];\n\n    if (granted[area.manage]) {\n      allowed.push(phrase?.manage ?? area.label);\n    } else if (area.view && granted[area.view]) {\n      allowed.push(phrase?.view ?? area.label);\n    } else {\n      withheld.push(area.label);\n    }\n  }\n\n  return { allowed, withheld };\n}\n"],"mappings":"AAAA,SAAS,wBAAwB;AAkCjC,MAAM,OAAyD;AAAA,EAC7D,UAAU,EAAE,QAAQ,yBAAyB,MAAM,uBAAuB;AAAA,EAC1E,QAAQ;AAAA,IACN,QAAQ;AAAA,IACR,MAAM;AAAA,EACR;AAAA,EACA,WAAW,EAAE,QAAQ,yBAAyB,MAAM,oBAAoB;AAAA,EACxE,WAAW;AAAA,IACT,QAAQ;AAAA,IACR,MAAM;AAAA,EACR;AAAA,EACA,UAAU;AAAA,IACR,QAAQ;AAAA,IACR,MAAM;AAAA,EACR;AAAA,EACA,SAAS,EAAE,QAAQ,oBAAoB,MAAM,eAAe;AAAA,EAC5D,WAAW;AAAA,IACT,QAAQ;AAAA,IACR,MAAM;AAAA,EACR;AAAA,EACA,SAAS,EAAE,QAAQ,oBAAoB,MAAM,kBAAkB;AAAA,EAC/D,MAAM,EAAE,QAAQ,2BAA2B,MAAM,gBAAgB;AAAA,EACjE,OAAO,EAAE,QAAQ,4BAA4B,MAAM,gBAAgB;AACrE;AAEO,SAAS,eACd,aACc;AACd,QAAM,UAAU,eAAe,CAAC;AAChC,QAAM,WAAW,iBAAiB,OAAO,CAAC,SAAS,CAAC,KAAK,QAAQ;AAEjE,QAAM,UAAoB,CAAC;AAC3B,QAAM,WAAqB,CAAC;AAE5B,aAAW,QAAQ,UAAU;AAC3B,UAAM,SAAS,KAAK,KAAK,EAAE;AAE3B,QAAI,QAAQ,KAAK,MAAM,GAAG;AACxB,cAAQ,KAAK,QAAQ,UAAU,KAAK,KAAK;AAAA,IAC3C,WAAW,KAAK,QAAQ,QAAQ,KAAK,IAAI,GAAG;AAC1C,cAAQ,KAAK,QAAQ,QAAQ,KAAK,KAAK;AAAA,IACzC,OAAO;AACL,eAAS,KAAK,KAAK,KAAK;AAAA,IAC1B;AAAA,EACF;AAEA,SAAO,EAAE,SAAS,SAAS;AAC7B;","names":[]}

package/dist/design-schema.d.ts

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+export declare const designPaletteSchema: z.ZodObject<{
+    primary: z.ZodOptional<z.ZodString>;
+    accent: z.ZodOptional<z.ZodString>;
+    surface: z.ZodOptional<z.ZodString>;
+    surfaceAlt: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    textMuted: z.ZodOptional<z.ZodString>;
+    border: z.ZodOptional<z.ZodString>;
+    highlight: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const designTypographySchema: z.ZodObject<{
+    display: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    scale: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const designRadiusSchema: z.ZodEnum<{
+    sm: "sm";
+    md: "md";
+    none: "none";
+    full: "full";
+}>;
+export declare const designSectionSchema: z.ZodObject<{
+    variant: z.ZodOptional<z.ZodString>;
+    overlay: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const settingsDesignSchema: z.ZodObject<{
+    palette: z.ZodOptional<z.ZodObject<{
+        primary: z.ZodOptional<z.ZodString>;
+        accent: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodString>;
+        surfaceAlt: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        textMuted: z.ZodOptional<z.ZodString>;
+        border: z.ZodOptional<z.ZodString>;
+        highlight: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    typography: z.ZodOptional<z.ZodObject<{
+        display: z.ZodOptional<z.ZodString>;
+        body: z.ZodOptional<z.ZodString>;
+        scale: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    shape: z.ZodOptional<z.ZodObject<{
+        radius: z.ZodOptional<z.ZodEnum<{
+            sm: "sm";
+            md: "md";
+            none: "none";
+            full: "full";
+        }>>;
+    }, z.core.$strict>>;
+    density: z.ZodOptional<z.ZodEnum<{
+        expansive: "expansive";
+        balanced: "balanced";
+        compressed: "compressed";
+        "high-contrast": "high-contrast";
+    }>>;
+    motion: z.ZodOptional<z.ZodEnum<{
+        "tier-1": "tier-1";
+        "tier-2": "tier-2";
+        "tier-3": "tier-3";
+    }>>;
+    sections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        variant: z.ZodOptional<z.ZodString>;
+        overlay: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type DesignPalette = z.infer<typeof designPaletteSchema>;
+export type DesignTypography = z.infer<typeof designTypographySchema>;
+export type DesignRadius = z.infer<typeof designRadiusSchema>;
+export type SettingsDesign = z.infer<typeof settingsDesignSchema>;
+/**
+ * Parse an untrusted `tenant.settings.design` value. Invalid or absent input
+ * resolves to `undefined` so the editor hydrates to "no overrides" instead of
+ * crashing on a malformed blob.
+ */
+export declare function parseSettingsDesign(value: unknown): SettingsDesign | undefined;

package/dist/design-schema.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+const hexColor = z.string().regex(
+  /^#(?:[0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/,
+  "must be a hex color"
+);
+const designPaletteSchema = z.object({
+  primary: hexColor,
+  accent: hexColor,
+  surface: hexColor,
+  surfaceAlt: hexColor,
+  text: hexColor,
+  textMuted: hexColor,
+  border: hexColor,
+  highlight: hexColor
+}).partial().strict();
+const designTypographySchema = z.object({
+  display: z.string().min(1).max(64),
+  body: z.string().min(1).max(64),
+  scale: z.number().min(0.85).max(1.25)
+}).partial().strict();
+const designRadiusSchema = z.enum(["none", "sm", "md", "full"]);
+const designSectionSchema = z.object({
+  variant: z.string().min(1).max(64),
+  overlay: z.string().min(1).max(64)
+}).partial().strict();
+const settingsDesignSchema = z.object({
+  palette: designPaletteSchema,
+  typography: designTypographySchema,
+  shape: z.object({ radius: designRadiusSchema }).partial().strict(),
+  density: z.enum(["expansive", "balanced", "compressed", "high-contrast"]),
+  motion: z.enum(["tier-1", "tier-2", "tier-3"]),
+  sections: z.record(z.string(), designSectionSchema)
+}).partial().strict();
+function parseSettingsDesign(value) {
+  if (value == null || typeof value !== "object") return void 0;
+  const result = settingsDesignSchema.safeParse(value);
+  return result.success ? result.data : void 0;
+}
+export {
+  designPaletteSchema,
+  designRadiusSchema,
+  designSectionSchema,
+  designTypographySchema,
+  parseSettingsDesign,
+  settingsDesignSchema
+};
+//# sourceMappingURL=design-schema.js.map

package/dist/design-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/design-schema.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * `tenant.settings.design` — structured brand tokens (frozen v0 contract,\n * `COMMERCE_AI_PHASES.md` §1.3). Mirror of web-render\n * `src/lib/design-tokens/schema.ts`; keep the two in lockstep.\n *\n * Every field is optional; template defaults fill gaps. Freeform tenant CSS\n * is forbidden by design.\n */\n\nconst hexColor = z\n  .string()\n  .regex(\n    /^#(?:[0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/,\n    'must be a hex color',\n  );\n\nexport const designPaletteSchema = z\n  .object({\n    primary: hexColor,\n    accent: hexColor,\n    surface: hexColor,\n    surfaceAlt: hexColor,\n    text: hexColor,\n    textMuted: hexColor,\n    border: hexColor,\n    highlight: hexColor,\n  })\n  .partial()\n  .strict();\n\nexport const designTypographySchema = z\n  .object({\n    display: z.string().min(1).max(64),\n    body: z.string().min(1).max(64),\n    scale: z.number().min(0.85).max(1.25),\n  })\n  .partial()\n  .strict();\n\nexport const designRadiusSchema = z.enum(['none', 'sm', 'md', 'full']);\n\nexport const designSectionSchema = z\n  .object({\n    variant: z.string().min(1).max(64),\n    overlay: z.string().min(1).max(64),\n  })\n  .partial()\n  .strict();\n\nexport const settingsDesignSchema = z\n  .object({\n    palette: designPaletteSchema,\n    typography: designTypographySchema,\n    shape: z.object({ radius: designRadiusSchema }).partial().strict(),\n    density: z.enum(['expansive', 'balanced', 'compressed', 'high-contrast']),\n    motion: z.enum(['tier-1', 'tier-2', 'tier-3']),\n    sections: z.record(z.string(), designSectionSchema),\n  })\n  .partial()\n  .strict();\n\nexport type DesignPalette = z.infer<typeof designPaletteSchema>;\nexport type DesignTypography = z.infer<typeof designTypographySchema>;\nexport type DesignRadius = z.infer<typeof designRadiusSchema>;\nexport type SettingsDesign = z.infer<typeof settingsDesignSchema>;\n\n/**\n * Parse an untrusted `tenant.settings.design` value. Invalid or absent input\n * resolves to `undefined` so the editor hydrates to \"no overrides\" instead of\n * crashing on a malformed blob.\n */\nexport function parseSettingsDesign(\n  value: unknown,\n): SettingsDesign | undefined {\n  if (value == null || typeof value !== 'object') return undefined;\n  const result = settingsDesignSchema.safeParse(value);\n  return result.success ? result.data : undefined;\n}\n"],"mappings":"AAAA,SAAS,SAAS;AAWlB,MAAM,WAAW,EACd,OAAO,EACP;AAAA,EACC;AAAA,EACA;AACF;AAEK,MAAM,sBAAsB,EAChC,OAAO;AAAA,EACN,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,MAAM;AAAA,EACN,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,WAAW;AACb,CAAC,EACA,QAAQ,EACR,OAAO;AAEH,MAAM,yBAAyB,EACnC,OAAO;AAAA,EACN,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AAAA,EACjC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AAAA,EAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,IAAI,IAAI;AACtC,CAAC,EACA,QAAQ,EACR,OAAO;AAEH,MAAM,qBAAqB,EAAE,KAAK,CAAC,QAAQ,MAAM,MAAM,MAAM,CAAC;AAE9D,MAAM,sBAAsB,EAChC,OAAO;AAAA,EACN,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AAAA,EACjC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AACnC,CAAC,EACA,QAAQ,EACR,OAAO;AAEH,MAAM,uBAAuB,EACjC,OAAO;AAAA,EACN,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,OAAO,EAAE,OAAO,EAAE,QAAQ,mBAAmB,CAAC,EAAE,QAAQ,EAAE,OAAO;AAAA,EACjE,SAAS,EAAE,KAAK,CAAC,aAAa,YAAY,cAAc,eAAe,CAAC;AAAA,EACxE,QAAQ,EAAE,KAAK,CAAC,UAAU,UAAU,QAAQ,CAAC;AAAA,EAC7C,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,mBAAmB;AACpD,CAAC,EACA,QAAQ,EACR,OAAO;AAYH,SAAS,oBACd,OAC4B;AAC5B,MAAI,SAAS,QAAQ,OAAO,UAAU,SAAU,QAAO;AACvD,QAAM,SAAS,qBAAqB,UAAU,KAAK;AACnD,SAAO,OAAO,UAAU,OAAO,OAAO;AACxC;","names":[]}

package/dist/destination-alias.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The address a merchant sees for a screen.
+ *
+ * A screen's real route is fixed (/dashboard/orders, /dashboard/catalog, ...),
+ * and 100+ files link to it. Its TITLE is the merchant's own word for it —
+ * Products, Inventory, Menu, Kitchen Orders, or a custom label like "Our Shop"
+ * — so the address bar disagreed with the page. The proxy answers that without
+ * moving any route: it rewrites /dashboard/<word> to the real screen and
+ * redirects the real one to <word>.
+ *
+ * The proxy cannot read tenant settings, so the client leaves the words in a
+ * cookie once it knows them: one entry per real route, newest word first.
+ * Until then the real route is served as it always was.
+ *
+ * Only top-level routes are aliased (/dashboard/<segment>); everything below
+ * one follows its parent.
+ */
+export declare const DEST_ALIAS_COOKIE = "pb_dest_alias";
+/** real segment → the words it has gone by, newest first. */
+export type AliasMap = Record<string, string[]>;
+/**
+ * Top-level dashboard routes that exist. A word may not shadow one of these,
+ * or the screen it belongs to would become unreachable. `inventory` is absent
+ * on purpose: it is only a redirect to the catalog, so claiming it is safe.
+ * `alias.test.ts` fails when this drifts from the app directory.
+ */
+export declare const RESERVED_SEGMENTS: Set<string>;
+/** "Our Shop" → "our-shop". Empty when nothing usable is left. */
+export declare function labelSlug(label: string | undefined | null): string;
+/** The word to use for a label, or null when it would shadow a real screen. */
+export declare function aliasWordFor(label: string | undefined | null): string | null;
+/** `catalog=products,inventory;orders=kitchen` → a validated map. */
+export declare function parseAliasMap(cookie: string | undefined | null): AliasMap;
+export declare function serializeAliasMap(map: AliasMap): string;
+/**
+ * Records `word` as the newest for `segment`. A word another screen already
+ * holds is refused, so two screens never claim one address.
+ */
+export declare function withAlias(map: AliasMap, segment: string, word: string | null): AliasMap;
+/** The real route → its newest word. Unchanged when it has none. */
+export declare function toAliasPath(pathname: string, map: AliasMap): string;
+/** Any word a screen has gone by → the real route. Unchanged otherwise. */
+export declare function toRealPath(pathname: string, map: AliasMap): string;