@withpotter/lib 0.13.0-next.101

package/dist/utils.d.ts

@@ -0,0 +1,53 @@
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;
+/**
+ * The value as a list, whatever actually arrived.
+ *
+ * `apiFetch<Thing[]>` is a promise of a type, not a guarantee of one: the
+ * generic tells TypeScript what to expect and nothing checks it at runtime. A
+ * 200 carrying an error object, a `{ data: [...] }` envelope from a changed
+ * endpoint, or `null` all satisfy the compiler and then meet `.filter`.
+ *
+ * A `= []` default does not cover this — that only fires when the value is
+ * `undefined`, and neither does `.catch(() => [])`, which only fires when the
+ * promise rejects. This is for the case in between, where the request
+ * succeeded and returned the wrong shape.
+ *
+ * Worth using anywhere the list drives render in the shell, where a throw
+ * takes down every page rather than one screen.
+ */
+export declare function asList<T>(value: T[] | null | undefined | unknown): T[];
+export declare function normalizeCurrencyCode(currency: unknown, fallback?: string): string;
+/**
+ * Point the formatter at a currency directly.
+ *
+ * `useCurrency` calls this when a live tenant differs from the stored one. An
+ * empty value is ignored rather than resetting a correct currency to dollars —
+ * workspaces load asynchronously and some have none set.
+ */
+export declare function setActiveCurrency(currency: string | undefined | null): void;
+export declare function getActiveCurrency(): string;
+export declare function formatCurrency(amount: number, currency?: string): string;
+export declare function formatDate(date: string | Date, options?: Intl.DateTimeFormatOptions): string;
+/**
+ * How long ago something happened: "just now", "4m", "3h", "2d", then a date.
+ *
+ * The counterpart to `formatRelativeTime`, which rounds to whole days and
+ * leans forward ("Tomorrow", "In 3 days") because it was written for things
+ * that are due. Anything that has already happened lands in its `Today` bucket
+ * and stops being a time at all, which is no use in a feed where every row is
+ * minutes old and the order is the whole point.
+ *
+ * Bare units, no "ago": in a list where every row is a past event, the word is
+ * on every line and carries nothing.
+ */
+export declare function formatTimeAgo(date: string | Date): string;
+export declare function formatRelativeTime(date: string | Date): string;
+export declare function capitalize(str: string): string;
+export declare function formatBytes(bytes: number): string;
+/**
+ * "3d ago". Lived in `reviews/_components` and was copied by hand into the
+ * abandoned-cart page, so two surfaces rounded time differently. It is a date
+ * helper, so it belongs beside the other date helpers.
+ */
+export declare function timeAgo(dateStr: string): string;

package/dist/utils.js

@@ -0,0 +1,161 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+function asList(value) {
+  return Array.isArray(value) ? value : [];
+}
+const CURRENCY_SYMBOLS = {
+  NGN: "\u20A6",
+  USD: "$",
+  EUR: "\u20AC",
+  GBP: "\xA3",
+  CAD: "C$",
+  AUD: "A$",
+  GHS: "\u20B5",
+  KES: "KSh",
+  ZAR: "R",
+  INR: "\u20B9",
+  JPY: "\xA5",
+  CNY: "\xA5",
+  BRL: "R$",
+  MXN: "$",
+  AED: "\u062F.\u0625"
+};
+function normalizeCurrencyCode(currency, fallback = "NGN") {
+  const normalized = typeof currency === "string" ? currency.trim().toUpperCase() : "";
+  const supportedCurrencies = Intl.supportedValuesOf?.("currency") ?? [];
+  return supportedCurrencies.includes(normalized) ? normalized : fallback;
+}
+const WORKSPACE_KEY = "currentWorkspace";
+const TENANT_KEY = "tenant";
+let cachedSlug;
+let cachedCurrency = null;
+let override = null;
+function readStoredCurrency() {
+  try {
+    const raw = localStorage.getItem(TENANT_KEY);
+    if (!raw) return null;
+    const code = JSON.parse(raw)?.settings?.currency;
+    return typeof code === "string" && code ? code.toUpperCase() : null;
+  } catch {
+    return null;
+  }
+}
+function setActiveCurrency(currency) {
+  if (!currency) return;
+  override = currency.toUpperCase();
+  try {
+    cachedSlug = localStorage.getItem(WORKSPACE_KEY);
+  } catch {
+    cachedSlug = void 0;
+  }
+}
+function getActiveCurrency() {
+  if (typeof window === "undefined") return override ?? "NGN";
+  let slug = null;
+  try {
+    slug = localStorage.getItem(WORKSPACE_KEY);
+  } catch {
+    return override ?? cachedCurrency ?? "NGN";
+  }
+  if (slug !== cachedSlug) {
+    cachedSlug = slug;
+    cachedCurrency = readStoredCurrency();
+    override = null;
+  }
+  return override ?? cachedCurrency ?? "NGN";
+}
+function formatCurrency(amount, currency) {
+  const code = currency || getActiveCurrency();
+  const symbol = CURRENCY_SYMBOLS[code] || code;
+  const formatted = new Intl.NumberFormat("en-US", {
+    minimumFractionDigits: 0,
+    maximumFractionDigits: 0
+  }).format(amount);
+  return `${symbol}${formatted}`;
+}
+function formatDate(date, options) {
+  const defaultOptions = {
+    year: "numeric",
+    month: "short",
+    day: "numeric",
+    ...options
+  };
+  return new Intl.DateTimeFormat("en-NG", defaultOptions).format(
+    new Date(date)
+  );
+}
+function formatTimeAgo(date) {
+  const then = new Date(date).getTime();
+  if (Number.isNaN(then)) return "";
+  const seconds = Math.max(0, Math.floor((Date.now() - then) / 1e3));
+  if (seconds < 45) return "just now";
+  if (seconds < 3600) return `${Math.floor(seconds / 60)}m`;
+  if (seconds < 86400) return `${Math.floor(seconds / 3600)}h`;
+  if (seconds < 604800) return `${Math.floor(seconds / 86400)}d`;
+  return formatDate(date, { year: void 0, month: "short", day: "numeric" });
+}
+function formatRelativeTime(date) {
+  const now = /* @__PURE__ */ new Date();
+  const target = new Date(date);
+  const diffInDays = Math.ceil(
+    (target.getTime() - now.getTime()) / (1e3 * 60 * 60 * 24)
+  );
+  if (diffInDays < 0) {
+    return `${Math.abs(diffInDays)} days ago`;
+  } else if (diffInDays === 0) {
+    return "Today";
+  } else if (diffInDays === 1) {
+    return "Tomorrow";
+  } else if (diffInDays < 7) {
+    return `In ${diffInDays} days`;
+  } else if (diffInDays < 30) {
+    const weeks = Math.ceil(diffInDays / 7);
+    return `In ${weeks} week${weeks > 1 ? "s" : ""}`;
+  } else {
+    return formatDate(date);
+  }
+}
+function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+}
+function formatBytes(bytes) {
+  if (bytes === 0) return "0 B";
+  const units = ["B", "KB", "MB", "GB", "TB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(1024));
+  if (i === 0) return `${bytes} B`;
+  const value = bytes / Math.pow(1024, i);
+  return `${parseFloat(value.toFixed(1))} ${units[i]}`;
+}
+function timeAgo(dateStr) {
+  const now = Date.now();
+  const d = new Date(dateStr).getTime();
+  const diff = now - d;
+  const mins = Math.floor(diff / 6e4);
+  if (mins < 1) return "just now";
+  if (mins < 60) return `${mins}m ago`;
+  const hrs = Math.floor(mins / 60);
+  if (hrs < 24) return `${hrs}h ago`;
+  const days = Math.floor(hrs / 24);
+  if (days < 30) return `${days}d ago`;
+  const months = Math.floor(days / 30);
+  if (months < 12) return `${months}mo ago`;
+  return `${Math.floor(months / 12)}y ago`;
+}
+export {
+  asList,
+  capitalize,
+  cn,
+  formatBytes,
+  formatCurrency,
+  formatDate,
+  formatRelativeTime,
+  formatTimeAgo,
+  getActiveCurrency,
+  normalizeCurrencyCode,
+  setActiveCurrency,
+  timeAgo
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts"],"sourcesContent":["import { type ClassValue, clsx } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n\n/**\n * The value as a list, whatever actually arrived.\n *\n * `apiFetch<Thing[]>` is a promise of a type, not a guarantee of one: the\n * generic tells TypeScript what to expect and nothing checks it at runtime. A\n * 200 carrying an error object, a `{ data: [...] }` envelope from a changed\n * endpoint, or `null` all satisfy the compiler and then meet `.filter`.\n *\n * A `= []` default does not cover this — that only fires when the value is\n * `undefined`, and neither does `.catch(() => [])`, which only fires when the\n * promise rejects. This is for the case in between, where the request\n * succeeded and returned the wrong shape.\n *\n * Worth using anywhere the list drives render in the shell, where a throw\n * takes down every page rather than one screen.\n */\nexport function asList<T>(value: T[] | null | undefined | unknown): T[] {\n  return Array.isArray(value) ? (value as T[]) : [];\n}\n\n// Currency symbol map – avoids Intl locale inconsistencies (en-US renders NGN\n// as \"NGN\" instead of \"₦\"). Keep in sync with dynamic-form.tsx CURRENCY_SYMBOLS.\nconst CURRENCY_SYMBOLS: Record<string, string> = {\n  NGN: '₦',\n  USD: '$',\n  EUR: '€',\n  GBP: '£',\n  CAD: 'C$',\n  AUD: 'A$',\n  GHS: '₵',\n  KES: 'KSh',\n  ZAR: 'R',\n  INR: '₹',\n  JPY: '¥',\n  CNY: '¥',\n  BRL: 'R$',\n  MXN: '$',\n  AED: 'د.إ',\n};\n\nexport function normalizeCurrencyCode(\n  currency: unknown,\n  fallback = 'NGN',\n): string {\n  const normalized =\n    typeof currency === 'string' ? currency.trim().toUpperCase() : '';\n  const supportedCurrencies = Intl.supportedValuesOf?.('currency') ?? [];\n  return supportedCurrencies.includes(normalized) ? normalized : fallback;\n}\n\n/**\n * The workspace's own currency, for the 250-odd places that format money\n * without naming one.\n *\n * `formatCurrency` defaulted to USD, so a Lagos merchant's ₦500,000 quote read\n * \"$500,000\" on every screen that did not pass a code — Orders, Payments,\n * Customers, invoice totals, the enquiry stats. The ones that DO pass a code\n * are passing a product's or an invoice's own currency, which answers a\n * different question: what this row is priced in, not what this business\n * trades in. Those still win.\n *\n * Read from the persisted workspace rather than set by a provider. Auth already\n * writes the whole tenant to `localStorage.tenant` every time one becomes\n * current — login, reload and `switchWorkspace` all land there — so the value\n * is available to plain functions with no hook and no context, which is what\n * `toAnswers` and the table cell formatters are. It also keeps this out of\n * `auth-context.tsx`, which sits exactly on its length ledger.\n *\n * The parse is cached against `currentWorkspace`, a one-key string read: the\n * cheap read happens per call, the JSON parse only when the workspace changes.\n */\nconst WORKSPACE_KEY = 'currentWorkspace';\nconst TENANT_KEY = 'tenant';\n\nlet cachedSlug: string | null | undefined;\nlet cachedCurrency: string | null = null;\n/** Set from a live tenant, so a fresh fetch beats what was last persisted. */\nlet override: string | null = null;\n\nfunction readStoredCurrency(): string | null {\n  try {\n    const raw = localStorage.getItem(TENANT_KEY);\n    if (!raw) return null;\n    const code = (JSON.parse(raw) as { settings?: { currency?: unknown } })\n      ?.settings?.currency;\n    return typeof code === 'string' && code ? code.toUpperCase() : null;\n  } catch {\n    // Unparseable, or storage blocked. The default is naira; throwing is wrong\n    // for every merchant.\n    return null;\n  }\n}\n\n/**\n * Point the formatter at a currency directly.\n *\n * `useCurrency` calls this when a live tenant differs from the stored one. An\n * empty value is ignored rather than resetting a correct currency to dollars —\n * workspaces load asynchronously and some have none set.\n */\nexport function setActiveCurrency(currency: string | undefined | null): void {\n  if (!currency) return;\n  override = currency.toUpperCase();\n  try {\n    cachedSlug = localStorage.getItem(WORKSPACE_KEY);\n  } catch {\n    cachedSlug = undefined;\n  }\n}\n\nexport function getActiveCurrency(): string {\n  if (typeof window === 'undefined') return override ?? 'NGN';\n\n  let slug: string | null = null;\n  try {\n    slug = localStorage.getItem(WORKSPACE_KEY);\n  } catch {\n    return override ?? cachedCurrency ?? 'NGN';\n  }\n\n  if (slug !== cachedSlug) {\n    cachedSlug = slug;\n    cachedCurrency = readStoredCurrency();\n    // The override belonged to the workspace that just went away.\n    override = null;\n  }\n\n  return override ?? cachedCurrency ?? 'NGN';\n}\n\nexport function formatCurrency(amount: number, currency?: string): string {\n  const code = currency || getActiveCurrency();\n  const symbol = CURRENCY_SYMBOLS[code] || code;\n  const formatted = new Intl.NumberFormat('en-US', {\n    minimumFractionDigits: 0,\n    maximumFractionDigits: 0,\n  }).format(amount);\n  return `${symbol}${formatted}`;\n}\n\nexport function formatDate(\n  date: string | Date,\n  options?: Intl.DateTimeFormatOptions,\n): string {\n  const defaultOptions: Intl.DateTimeFormatOptions = {\n    year: 'numeric',\n    month: 'short',\n    day: 'numeric',\n    ...options,\n  };\n  return new Intl.DateTimeFormat('en-NG', defaultOptions).format(\n    new Date(date),\n  );\n}\n\n/**\n * How long ago something happened: \"just now\", \"4m\", \"3h\", \"2d\", then a date.\n *\n * The counterpart to `formatRelativeTime`, which rounds to whole days and\n * leans forward (\"Tomorrow\", \"In 3 days\") because it was written for things\n * that are due. Anything that has already happened lands in its `Today` bucket\n * and stops being a time at all, which is no use in a feed where every row is\n * minutes old and the order is the whole point.\n *\n * Bare units, no \"ago\": in a list where every row is a past event, the word is\n * on every line and carries nothing.\n */\nexport function formatTimeAgo(date: string | Date): string {\n  const then = new Date(date).getTime();\n  if (Number.isNaN(then)) return '';\n  const seconds = Math.max(0, Math.floor((Date.now() - then) / 1000));\n\n  if (seconds < 45) return 'just now';\n  if (seconds < 3600) return `${Math.floor(seconds / 60)}m`;\n  if (seconds < 86_400) return `${Math.floor(seconds / 3600)}h`;\n  if (seconds < 604_800) return `${Math.floor(seconds / 86_400)}d`;\n  return formatDate(date, { year: undefined, month: 'short', day: 'numeric' });\n}\n\nexport function formatRelativeTime(date: string | Date): string {\n  const now = new Date();\n  const target = new Date(date);\n  const diffInDays = Math.ceil(\n    (target.getTime() - now.getTime()) / (1000 * 60 * 60 * 24),\n  );\n\n  if (diffInDays < 0) {\n    return `${Math.abs(diffInDays)} days ago`;\n  } else if (diffInDays === 0) {\n    return 'Today';\n  } else if (diffInDays === 1) {\n    return 'Tomorrow';\n  } else if (diffInDays < 7) {\n    return `In ${diffInDays} days`;\n  } else if (diffInDays < 30) {\n    const weeks = Math.ceil(diffInDays / 7);\n    return `In ${weeks} week${weeks > 1 ? 's' : ''}`;\n  } else {\n    return formatDate(date);\n  }\n}\n\nexport function capitalize(str: string): string {\n  return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();\n}\n\nexport function formatBytes(bytes: number): string {\n  if (bytes === 0) return '0 B';\n  const units = ['B', 'KB', 'MB', 'GB', 'TB'];\n  const i = Math.floor(Math.log(bytes) / Math.log(1024));\n  if (i === 0) return `${bytes} B`;\n  const value = bytes / Math.pow(1024, i);\n  return `${parseFloat(value.toFixed(1))} ${units[i]}`;\n}\n\n/**\n * \"3d ago\". Lived in `reviews/_components` and was copied by hand into the\n * abandoned-cart page, so two surfaces rounded time differently. It is a date\n * helper, so it belongs beside the other date helpers.\n */\nexport function timeAgo(dateStr: string): string {\n  const now = Date.now();\n  const d = new Date(dateStr).getTime();\n  const diff = now - d;\n  const mins = Math.floor(diff / 60000);\n  if (mins < 1) return 'just now';\n  if (mins < 60) return `${mins}m ago`;\n  const hrs = Math.floor(mins / 60);\n  if (hrs < 24) return `${hrs}h ago`;\n  const days = Math.floor(hrs / 24);\n  if (days < 30) return `${days}d ago`;\n  const months = Math.floor(days / 30);\n  if (months < 12) return `${months}mo ago`;\n  return `${Math.floor(months / 12)}y ago`;\n}\n"],"mappings":"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","names":[]}

package/dist/wallet-format.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Wallet amounts arrive as minor units in strings ("150000" = ₦1,500.00).
+ * Divide by the currency's own number of decimals, in BigInt so large
+ * balances stay exact.
+ */
+export declare function formatMinor(minor: string, currency: string): string;
+/** Statuses come back in either case ("ACTIVE" from money, "active" elsewhere). */
+export declare const sameStatus: (status: string) => string;

package/dist/wallet-format.js

@@ -0,0 +1,36 @@
+function formatMinor(minor, currency) {
+  const format = new Intl.NumberFormat(void 0, {
+    style: "currency",
+    currencyDisplay: "narrowSymbol",
+    currency
+  });
+  const digits = format.resolvedOptions().maximumFractionDigits ?? 2;
+  let value;
+  try {
+    value = BigInt(minor);
+  } catch {
+    return `${minor} ${currency}`;
+  }
+  const negative = value < BigInt(0);
+  const abs = negative ? -value : value;
+  const scale = BigInt(10) ** BigInt(digits);
+  const whole = abs / scale;
+  const fraction = (abs % scale).toString().padStart(digits, "0");
+  const parts = format.formatToParts(0);
+  const decimal = parts.find((p) => p.type === "decimal")?.value ?? ".";
+  const grouped = format.formatToParts(Number(whole) <= Number.MAX_SAFE_INTEGER ? Number(whole) : 0).map((p) => {
+    if (p.type === "integer" && whole > BigInt(Number.MAX_SAFE_INTEGER)) {
+      return whole.toString();
+    }
+    if (p.type === "fraction") return fraction;
+    if (p.type === "decimal") return digits ? decimal : "";
+    return p.value;
+  }).join("");
+  return negative ? `-${grouped}` : grouped;
+}
+const sameStatus = (status) => status.toLowerCase();
+export {
+  formatMinor,
+  sameStatus
+};
+//# sourceMappingURL=wallet-format.js.map

package/dist/wallet-format.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/wallet-format.ts"],"sourcesContent":["/**\n * Wallet amounts arrive as minor units in strings (\"150000\" = ₦1,500.00).\n * Divide by the currency's own number of decimals, in BigInt so large\n * balances stay exact.\n */\nexport function formatMinor(minor: string, currency: string): string {\n  const format = new Intl.NumberFormat(undefined, {\n    style: 'currency',\n    currencyDisplay: 'narrowSymbol',\n    currency,\n  });\n  const digits = format.resolvedOptions().maximumFractionDigits ?? 2;\n\n  let value: bigint;\n\n  try {\n    value = BigInt(minor);\n  } catch {\n    return `${minor} ${currency}`;\n  }\n\n  const negative = value < BigInt(0);\n  const abs = negative ? -value : value;\n  const scale = BigInt(10) ** BigInt(digits);\n  const whole = abs / scale;\n  const fraction = (abs % scale).toString().padStart(digits, '0');\n  const parts = format.formatToParts(0);\n  const decimal = parts.find((p) => p.type === 'decimal')?.value ?? '.';\n  const grouped = format\n    .formatToParts(Number(whole) <= Number.MAX_SAFE_INTEGER ? Number(whole) : 0)\n    .map((p) => {\n      if (p.type === 'integer' && whole > BigInt(Number.MAX_SAFE_INTEGER)) {\n        return whole.toString();\n      }\n      if (p.type === 'fraction') return fraction;\n      if (p.type === 'decimal') return digits ? decimal : '';\n      return p.value;\n    })\n    .join('');\n\n  return negative ? `-${grouped}` : grouped;\n}\n\n/** Statuses come back in either case (\"ACTIVE\" from money, \"active\" elsewhere). */\nexport const sameStatus = (status: string) => status.toLowerCase();\n"],"mappings":"AAKO,SAAS,YAAY,OAAe,UAA0B;AACnE,QAAM,SAAS,IAAI,KAAK,aAAa,QAAW;AAAA,IAC9C,OAAO;AAAA,IACP,iBAAiB;AAAA,IACjB;AAAA,EACF,CAAC;AACD,QAAM,SAAS,OAAO,gBAAgB,EAAE,yBAAyB;AAEjE,MAAI;AAEJ,MAAI;AACF,YAAQ,OAAO,KAAK;AAAA,EACtB,QAAQ;AACN,WAAO,GAAG,KAAK,IAAI,QAAQ;AAAA,EAC7B;AAEA,QAAM,WAAW,QAAQ,OAAO,CAAC;AACjC,QAAM,MAAM,WAAW,CAAC,QAAQ;AAChC,QAAM,QAAQ,OAAO,EAAE,KAAK,OAAO,MAAM;AACzC,QAAM,QAAQ,MAAM;AACpB,QAAM,YAAY,MAAM,OAAO,SAAS,EAAE,SAAS,QAAQ,GAAG;AAC9D,QAAM,QAAQ,OAAO,cAAc,CAAC;AACpC,QAAM,UAAU,MAAM,KAAK,CAAC,MAAM,EAAE,SAAS,SAAS,GAAG,SAAS;AAClE,QAAM,UAAU,OACb,cAAc,OAAO,KAAK,KAAK,OAAO,mBAAmB,OAAO,KAAK,IAAI,CAAC,EAC1E,IAAI,CAAC,MAAM;AACV,QAAI,EAAE,SAAS,aAAa,QAAQ,OAAO,OAAO,gBAAgB,GAAG;AACnE,aAAO,MAAM,SAAS;AAAA,IACxB;AACA,QAAI,EAAE,SAAS,WAAY,QAAO;AAClC,QAAI,EAAE,SAAS,UAAW,QAAO,SAAS,UAAU;AACpD,WAAO,EAAE;AAAA,EACX,CAAC,EACA,KAAK,EAAE;AAEV,SAAO,WAAW,IAAI,OAAO,KAAK;AACpC;AAGO,MAAM,aAAa,CAAC,WAAmB,OAAO,YAAY;","names":[]}

package/dist/wallet-settlement.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Whether this box settles money into its own wallet.
+ *
+ * Boxspace pays a merchant out to a bank account they connect, so the home, the
+ * setup checklist and the Money group all ask for one. A box that holds the
+ * merchant's balance itself has no payout account to connect: the same prompts
+ * there send a merchant to add a bank that nothing will ever pay into, and
+ * tell them they cannot be paid when they already are.
+ *
+ * `NEXT_PUBLIC_BOX_WALLET_SETTLEMENT=true` says so. Build-time, like the other
+ * `NEXT_PUBLIC_BOX_*` switches, because it is a fact about the box and not
+ * about a tenant. Unset or anything else keeps the payout prompts.
+ */
+export declare const WALLET_SETTLEMENT: boolean;

package/dist/wallet-settlement.js

@@ -0,0 +1,5 @@
+const WALLET_SETTLEMENT = process.env.NEXT_PUBLIC_BOX_WALLET_SETTLEMENT === "true";
+export {
+  WALLET_SETTLEMENT
+};
+//# sourceMappingURL=wallet-settlement.js.map

package/dist/wallet-settlement.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/wallet-settlement.ts"],"sourcesContent":["/**\n * Whether this box settles money into its own wallet.\n *\n * Boxspace pays a merchant out to a bank account they connect, so the home, the\n * setup checklist and the Money group all ask for one. A box that holds the\n * merchant's balance itself has no payout account to connect: the same prompts\n * there send a merchant to add a bank that nothing will ever pay into, and\n * tell them they cannot be paid when they already are.\n *\n * `NEXT_PUBLIC_BOX_WALLET_SETTLEMENT=true` says so. Build-time, like the other\n * `NEXT_PUBLIC_BOX_*` switches, because it is a fact about the box and not\n * about a tenant. Unset or anything else keeps the payout prompts.\n */\nexport const WALLET_SETTLEMENT =\n  process.env.NEXT_PUBLIC_BOX_WALLET_SETTLEMENT === 'true';\n"],"mappings":"AAaO,MAAM,oBACX,QAAQ,IAAI,sCAAsC;","names":[]}

package/dist/web-url.d.ts

@@ -0,0 +1 @@
+export declare function resolveWebUrl(): string;

package/dist/web-url.js

@@ -0,0 +1,50 @@
+const DEFAULT_WEB_URL = "http://localhost:3000";
+function stripTrailingSlash(value) {
+  return value.replace(/\/+$/, "");
+}
+function canonicalizeKnownProductionHost(url) {
+  if (url.hostname === "withpotter.site" || url.hostname === "www.withpotter.site" || url.hostname === "manage.withpotter.com" || url.hostname === "mange.withpotter.com") {
+    url.hostname = "www.boxspace.live";
+  }
+  if (url.hostname === "boxspace.live") {
+    url.hostname = "www.boxspace.live";
+  }
+  if (url.hostname === "staging.withpotter.site" || url.hostname === "beta.withpotter.site") {
+    url.hostname = "beta.boxspace.live";
+  }
+  return url;
+}
+function inferWebUrlFromRuntimeOrigin() {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  const hostname = window.location.hostname.toLowerCase();
+  if (hostname === "manage.withpotter.com" || hostname === "mange.withpotter.com") {
+    return "https://www.boxspace.live";
+  }
+  if (hostname === "manage.boxspace.io") {
+    return "https://www.boxspace.live";
+  }
+  if (hostname === "manage-staging.boxspace.io" || hostname === "manage-beta.boxspace.io") {
+    return "https://beta.boxspace.live";
+  }
+  if (hostname === "manage-staging.withpotter.com") {
+    return "https://beta.boxspace.live";
+  }
+  return null;
+}
+function resolveWebUrl() {
+  const configured = process.env.NEXT_PUBLIC_WEB_URL;
+  const runtimeFallback = inferWebUrlFromRuntimeOrigin();
+  const selected = configured || runtimeFallback || DEFAULT_WEB_URL;
+  try {
+    const parsed = canonicalizeKnownProductionHost(new URL(selected));
+    return stripTrailingSlash(parsed.toString());
+  } catch {
+    return DEFAULT_WEB_URL;
+  }
+}
+export {
+  resolveWebUrl
+};
+//# sourceMappingURL=web-url.js.map

package/dist/web-url.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/web-url.ts"],"sourcesContent":["const DEFAULT_WEB_URL = 'http://localhost:3000';\n\nfunction stripTrailingSlash(value: string): string {\n  return value.replace(/\\/+$/, '');\n}\n\nfunction canonicalizeKnownProductionHost(url: URL): URL {\n  // Storefronts live on boxspace.live. The old withpotter.site renderer hosts\n  // (and the withpotter.com dashboards) are corrected to it, so a deployment\n  // that still has one in its environment follows. The platform redirects the\n  // apex to www, and a fetch cannot follow that cross-origin.\n  if (\n    url.hostname === 'withpotter.site' ||\n    url.hostname === 'www.withpotter.site' ||\n    url.hostname === 'manage.withpotter.com' ||\n    url.hostname === 'mange.withpotter.com'\n  ) {\n    url.hostname = 'www.boxspace.live';\n  }\n\n  // Same redirect on the boxspace.live zone, which the boxspace.io dashboards\n  // use: the apex answers 308 -> www, and a fetch cannot follow it cross-origin.\n  if (url.hostname === 'boxspace.live') {\n    url.hostname = 'www.boxspace.live';\n  }\n\n  /**\n   * `staging.withpotter.site` sits behind Vercel deployment protection, so it\n   * answers every request — the template registry included — with a 302 to\n   * `vercel.com/sso-api`. A fetch cannot follow that, and an iframe renders a\n   * login page, so the gallery comes up empty with nothing in the console that\n   * names the cause.\n   *\n   * Corrected here as well as at the mapping below, because `resolveWebUrl`\n   * prefers `NEXT_PUBLIC_WEB_URL` over the derived value: a deployment that\n   * still has the protected host in its environment would otherwise keep\n   * pointing at it no matter what the fallback says.\n   */\n  if (\n    url.hostname === 'staging.withpotter.site' ||\n    url.hostname === 'beta.withpotter.site'\n  ) {\n    url.hostname = 'beta.boxspace.live';\n  }\n\n  return url;\n}\n\nfunction inferWebUrlFromRuntimeOrigin(): string | null {\n  if (typeof window === 'undefined') {\n    return null;\n  }\n\n  const hostname = window.location.hostname.toLowerCase();\n\n  if (\n    hostname === 'manage.withpotter.com' ||\n    hostname === 'mange.withpotter.com'\n  ) {\n    return 'https://www.boxspace.live';\n  }\n\n  // The boxspace.io dashboards use the boxspace.live renderer. Both zones are\n  // served by the same web-prod project, so the registry is identical.\n  if (hostname === 'manage.boxspace.io') {\n    return 'https://www.boxspace.live';\n  }\n\n  /**\n   * Staging had no mapping, so it fell all the way to DEFAULT_WEB_URL and asked\n   * `http://localhost:3000` for the template registry — the VIEWER's own\n   * machine, from their browser. That request cannot succeed for anyone but a\n   * developer with the renderer running, so the registry fetch failed and the\n   * template picker silently fell back to the API's templates table: the stale\n   * cache the picker had just been changed to stop depending on.\n   *\n   * A dashboard host implies its renderer. Deriving it here rather than relying\n   * on NEXT_PUBLIC_WEB_URL means a deployment cannot lose its storefront by\n   * being missing one environment variable, which is exactly how this hid.\n   */\n  if (\n    hostname === 'manage-staging.boxspace.io' ||\n    hostname === 'manage-beta.boxspace.io'\n  ) {\n    return 'https://beta.boxspace.live';\n  }\n\n  if (hostname === 'manage-staging.withpotter.com') {\n    /**\n     * The renderer staging shows templates from is the `develop` deployment.\n     *\n     * This pointed at `staging.withpotter.site` (now `beta.boxspace.live`), which is a protected\n     * deployment: it 302s to Vercel SSO, so the registry fetch failed and the\n     * picker emptied — the same symptom as the localhost fallback described\n     * above, one host later. web-render has no staging deploy job on `develop`\n     * either, so that host is not where the renderer ships; `beta` is.\n     */\n    return 'https://beta.boxspace.live';\n  }\n\n  return null;\n}\n\nexport function resolveWebUrl(): string {\n  const configured = process.env.NEXT_PUBLIC_WEB_URL;\n  const runtimeFallback = inferWebUrlFromRuntimeOrigin();\n  const selected = configured || runtimeFallback || DEFAULT_WEB_URL;\n\n  try {\n    const parsed = canonicalizeKnownProductionHost(new URL(selected));\n    return stripTrailingSlash(parsed.toString());\n  } catch {\n    return DEFAULT_WEB_URL;\n  }\n}\n"],"mappings":"AAAA,MAAM,kBAAkB;AAExB,SAAS,mBAAmB,OAAuB;AACjD,SAAO,MAAM,QAAQ,QAAQ,EAAE;AACjC;AAEA,SAAS,gCAAgC,KAAe;AAKtD,MACE,IAAI,aAAa,qBACjB,IAAI,aAAa,yBACjB,IAAI,aAAa,2BACjB,IAAI,aAAa,wBACjB;AACA,QAAI,WAAW;AAAA,EACjB;AAIA,MAAI,IAAI,aAAa,iBAAiB;AACpC,QAAI,WAAW;AAAA,EACjB;AAcA,MACE,IAAI,aAAa,6BACjB,IAAI,aAAa,wBACjB;AACA,QAAI,WAAW;AAAA,EACjB;AAEA,SAAO;AACT;AAEA,SAAS,+BAA8C;AACrD,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,OAAO,SAAS,SAAS,YAAY;AAEtD,MACE,aAAa,2BACb,aAAa,wBACb;AACA,WAAO;AAAA,EACT;AAIA,MAAI,aAAa,sBAAsB;AACrC,WAAO;AAAA,EACT;AAcA,MACE,aAAa,gCACb,aAAa,2BACb;AACA,WAAO;AAAA,EACT;AAEA,MAAI,aAAa,iCAAiC;AAUhD,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEO,SAAS,gBAAwB;AACtC,QAAM,aAAa,QAAQ,IAAI;AAC/B,QAAM,kBAAkB,6BAA6B;AACrD,QAAM,WAAW,cAAc,mBAAmB;AAElD,MAAI;AACF,UAAM,SAAS,gCAAgC,IAAI,IAAI,QAAQ,CAAC;AAChE,WAAO,mBAAmB,OAAO,SAAS,CAAC;AAAA,EAC7C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/whats-new.d.ts

@@ -0,0 +1,59 @@
+/**
+ * What changed, in the merchant's words.
+ *
+ * A release note is not a commit message. Every entry here answers "what can I
+ * do now that I could not do on Monday" — so a refactor, a guard and a
+ * dependency bump never appear, however much work they were, and a one-line
+ * change to where a button sits does if it is where somebody kept looking.
+ *
+ * Newest first, and the id IS the date, because that is what the unread mark
+ * compares: a merchant has seen everything up to the last id they opened.
+ *
+ * WHY THIS IS A FILE AND NOT AN ENDPOINT. There is no releases table and this
+ * does not want one: the notes ship with the build that made them true, which
+ * is the only way they cannot describe a version the merchant is not running.
+ * Linear, Vercel and Raycast all ship theirs the same way.
+ */
+export interface Release {
+    /** ISO date. Also the sort key and what "seen" is measured against. */
+    id: string;
+    title: string;
+    /** One or two sentences. If it needs three, it is two entries. */
+    body: string;
+    /**
+     * The change, shown. A path under `public/whats-new/` — a GIF of the thing
+     * moving where the change IS a movement, a JPG or PNG where it is a place.
+     *
+     * Leads the note, because a merchant skimming these is asking "is any of
+     * this about me" and a loop answers that before a sentence gets going. A
+     * file that is not there yet collapses the frame rather than drawing a
+     * broken tile, so a note can ship before its capture does.
+     *
+     * Keep them small. This panel opens over the merchant's work and a 4MB GIF
+     * turns a two-second read into a spinner.
+     */
+    image?: string;
+    /** Where to go and use it. Omitted when the change is everywhere. */
+    href?: string;
+    hrefLabel?: string;
+}
+export declare const RELEASES: Release[];
+/** The newest id. What "you are up to date" means. */
+export declare const latestReleaseId: string;
+/**
+ * Whether anything has landed since this person last opened the panel.
+ *
+ * Per BROWSER, not per account, and deliberately: the alternative is a column
+ * on the user record and a write on every open, which is a request and a
+ * migration to decide whether to draw a 8px dot. Someone who reads the notes on
+ * a laptop and then signs in on a tablet sees the dot once more. That is the
+ * whole cost.
+ *
+ * Wrapped because storage throws outright in a few contexts (a private window
+ * with site data blocked), and a dot is never worth a crashed sidebar.
+ */
+export declare function hasUnreadReleases(): boolean;
+export declare function markReleasesSeen(): void;
+export declare function subscribeReleases(listener: () => void): () => void;
+/** The server has no storage, so it has no dot. */
+export declare function noUnreadOnServer(): boolean;

package/dist/whats-new.js

@@ -0,0 +1,77 @@
+const RELEASES = [
+  {
+    id: "2026-08-25-media-picker",
+    title: "Your photos, wherever you add one",
+    body: "Pick several at once, see each one at its real shape rather than cropped to a square, and reach the pictures you have already uploaded from the product editor as well as the site editor. Anything you upload from the picker joins your library without going onto your public gallery page.",
+    /* PLACEHOLDERS, and they are meant to be replaced.
+           John, 2026-09-03: *"the whats new images, just find cool square images
+           or cashapp as placeholders"*.
+    
+           The three `image` paths here pointed at an empty `public/whats-new/`
+           from August until now — the notes shipped and the captures never did.
+           These are flat square blocks in Cash App's register (one saturated hue,
+           one bold shape, no gradient and no type) rather than screenshots of the
+           screens, deliberately: a real capture is the artefact this field wants,
+           and a placeholder that LOOKS like a capture is one nobody ever gets
+           round to replacing. A green disc is obviously not a picture of the media
+           picker.
+    
+           Square because the strip is square now, and 600px because that is twice
+           the tile at 3x with room to spare. Generated, not downloaded — nothing
+           here needs a licence or a network. */
+    image: "/whats-new/2026-08-25-media-picker.png",
+    href: "/dashboard/business/gallery",
+    hrefLabel: "Open your gallery"
+  },
+  {
+    id: "2026-08-25-bill-widget",
+    title: "What Box costs, on your home",
+    body: "A card for your own bill: what this period comes to, when it is charged, and whether a plan is ending. Add it from the widget gallery on the home.",
+    image: "/whats-new/2026-08-25-bill-widget.png",
+    href: "/dashboard",
+    hrefLabel: "Go to your home"
+  },
+  {
+    id: "2026-08-25-category",
+    title: "Business category moved",
+    body: "It now sits under your business name in General settings, where the tagline prompt used to be, instead of in a row of its own above it.",
+    image: "/whats-new/2026-08-25-business-category.png",
+    href: "/dashboard/settings",
+    hrefLabel: "Open general settings"
+  }
+];
+const latestReleaseId = RELEASES[0]?.id ?? "";
+const SEEN_KEY = "potter:whats-new-seen";
+function hasUnreadReleases() {
+  try {
+    return window.localStorage.getItem(SEEN_KEY) !== latestReleaseId;
+  } catch {
+    return false;
+  }
+}
+function markReleasesSeen() {
+  try {
+    window.localStorage.setItem(SEEN_KEY, latestReleaseId);
+  } catch {
+  }
+  for (const listener of listeners) listener();
+}
+const listeners = /* @__PURE__ */ new Set();
+function subscribeReleases(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+function noUnreadOnServer() {
+  return false;
+}
+export {
+  RELEASES,
+  hasUnreadReleases,
+  latestReleaseId,
+  markReleasesSeen,
+  noUnreadOnServer,
+  subscribeReleases
+};
+//# sourceMappingURL=whats-new.js.map

package/dist/whats-new.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/whats-new.ts"],"sourcesContent":["/**\n * What changed, in the merchant's words.\n *\n * A release note is not a commit message. Every entry here answers \"what can I\n * do now that I could not do on Monday\" — so a refactor, a guard and a\n * dependency bump never appear, however much work they were, and a one-line\n * change to where a button sits does if it is where somebody kept looking.\n *\n * Newest first, and the id IS the date, because that is what the unread mark\n * compares: a merchant has seen everything up to the last id they opened.\n *\n * WHY THIS IS A FILE AND NOT AN ENDPOINT. There is no releases table and this\n * does not want one: the notes ship with the build that made them true, which\n * is the only way they cannot describe a version the merchant is not running.\n * Linear, Vercel and Raycast all ship theirs the same way.\n */\nexport interface Release {\n  /** ISO date. Also the sort key and what \"seen\" is measured against. */\n  id: string;\n  title: string;\n  /** One or two sentences. If it needs three, it is two entries. */\n  body: string;\n  /**\n   * The change, shown. A path under `public/whats-new/` — a GIF of the thing\n   * moving where the change IS a movement, a JPG or PNG where it is a place.\n   *\n   * Leads the note, because a merchant skimming these is asking \"is any of\n   * this about me\" and a loop answers that before a sentence gets going. A\n   * file that is not there yet collapses the frame rather than drawing a\n   * broken tile, so a note can ship before its capture does.\n   *\n   * Keep them small. This panel opens over the merchant's work and a 4MB GIF\n   * turns a two-second read into a spinner.\n   */\n  image?: string;\n  /** Where to go and use it. Omitted when the change is everywhere. */\n  href?: string;\n  hrefLabel?: string;\n}\n\nexport const RELEASES: Release[] = [\n  {\n    id: '2026-08-25-media-picker',\n    title: 'Your photos, wherever you add one',\n    body: 'Pick several at once, see each one at its real shape rather than cropped to a square, and reach the pictures you have already uploaded from the product editor as well as the site editor. Anything you upload from the picker joins your library without going onto your public gallery page.',\n    /* PLACEHOLDERS, and they are meant to be replaced.\n       John, 2026-09-03: *\"the whats new images, just find cool square images\n       or cashapp as placeholders\"*.\n\n       The three `image` paths here pointed at an empty `public/whats-new/`\n       from August until now — the notes shipped and the captures never did.\n       These are flat square blocks in Cash App's register (one saturated hue,\n       one bold shape, no gradient and no type) rather than screenshots of the\n       screens, deliberately: a real capture is the artefact this field wants,\n       and a placeholder that LOOKS like a capture is one nobody ever gets\n       round to replacing. A green disc is obviously not a picture of the media\n       picker.\n\n       Square because the strip is square now, and 600px because that is twice\n       the tile at 3x with room to spare. Generated, not downloaded — nothing\n       here needs a licence or a network. */\n    image: '/whats-new/2026-08-25-media-picker.png',\n    href: '/dashboard/business/gallery',\n    hrefLabel: 'Open your gallery',\n  },\n  {\n    id: '2026-08-25-bill-widget',\n    title: 'What Box costs, on your home',\n    body: 'A card for your own bill: what this period comes to, when it is charged, and whether a plan is ending. Add it from the widget gallery on the home.',\n    image: '/whats-new/2026-08-25-bill-widget.png',\n    href: '/dashboard',\n    hrefLabel: 'Go to your home',\n  },\n  {\n    id: '2026-08-25-category',\n    title: 'Business category moved',\n    body: 'It now sits under your business name in General settings, where the tagline prompt used to be, instead of in a row of its own above it.',\n    image: '/whats-new/2026-08-25-business-category.png',\n    href: '/dashboard/settings',\n    hrefLabel: 'Open general settings',\n  },\n];\n\n/** The newest id. What \"you are up to date\" means. */\nexport const latestReleaseId = RELEASES[0]?.id ?? '';\n\nconst SEEN_KEY = 'potter:whats-new-seen';\n\n/**\n * Whether anything has landed since this person last opened the panel.\n *\n * Per BROWSER, not per account, and deliberately: the alternative is a column\n * on the user record and a write on every open, which is a request and a\n * migration to decide whether to draw a 8px dot. Someone who reads the notes on\n * a laptop and then signs in on a tablet sees the dot once more. That is the\n * whole cost.\n *\n * Wrapped because storage throws outright in a few contexts (a private window\n * with site data blocked), and a dot is never worth a crashed sidebar.\n */\nexport function hasUnreadReleases(): boolean {\n  try {\n    return window.localStorage.getItem(SEEN_KEY) !== latestReleaseId;\n  } catch {\n    return false;\n  }\n}\n\nexport function markReleasesSeen(): void {\n  try {\n    window.localStorage.setItem(SEEN_KEY, latestReleaseId);\n  } catch {\n    // A preference that cannot be stored is not an error worth showing.\n  }\n  for (const listener of listeners) listener();\n}\n\n/**\n * A store rather than an effect that sets state.\n *\n * The dot cannot be read during render — `localStorage` does not exist on the\n * server — and reading it in an effect that calls `setState` is the cascading\n * render the lint rule is there to stop. `useSyncExternalStore` is the shape\n * React provides for exactly this: a value that lives outside React, absent on\n * the server, and changing when something tells it to.\n */\nconst listeners = new Set<() => void>();\n\nexport function subscribeReleases(listener: () => void): () => void {\n  listeners.add(listener);\n  return () => {\n    listeners.delete(listener);\n  };\n}\n\n/** The server has no storage, so it has no dot. */\nexport function noUnreadOnServer(): boolean {\n  return false;\n}\n"],"mappings":"AAwCO,MAAM,WAAsB;AAAA,EACjC;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAiBN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,WAAW;AAAA,EACb;AACF;AAGO,MAAM,kBAAkB,SAAS,CAAC,GAAG,MAAM;AAElD,MAAM,WAAW;AAcV,SAAS,oBAA6B;AAC3C,MAAI;AACF,WAAO,OAAO,aAAa,QAAQ,QAAQ,MAAM;AAAA,EACnD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,mBAAyB;AACvC,MAAI;AACF,WAAO,aAAa,QAAQ,UAAU,eAAe;AAAA,EACvD,QAAQ;AAAA,EAER;AACA,aAAW,YAAY,UAAW,UAAS;AAC7C;AAWA,MAAM,YAAY,oBAAI,IAAgB;AAE/B,SAAS,kBAAkB,UAAkC;AAClE,YAAU,IAAI,QAAQ;AACtB,SAAO,MAAM;AACX,cAAU,OAAO,QAAQ;AAAA,EAC3B;AACF;AAGO,SAAS,mBAA4B;AAC1C,SAAO;AACT;","names":[]}

package/dist/workspace-recents.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Which workspaces this person actually works in, most recent first.
+ *
+ * The switcher shows two of them before deferring to the full page, and two
+ * slots picked by whatever order the API returned is a coin toss — an agency
+ * with eight clients got the same two every time regardless of which they had
+ * open all morning. Recency is the only ordering that improves with use.
+ *
+ * Nothing on the server records this. It is not worth a column: it is a per
+ * PERSON, per DEVICE convenience, the answer changes every time somebody
+ * switches, and being wrong costs one extra click into a page that lists
+ * everything. localStorage rather than session, because "the two I always use"
+ * is exactly the fact that should survive closing the tab.
+ *
+ * Deliberately NOT surfaced as a heading. John, 2026-08-23: *"we should have
+ * recents there like recently used — no need to title it that, just how it
+ * should be."* A list that reorders itself does not need to announce that it
+ * reorders itself.
+ */
+export declare function noteWorkspaceUsed(slug: string): void;
+/** Most recent first. Empty until somebody has switched at least once. */
+export declare function readWorkspaceRecents(): string[];
+/**
+ * Order workspaces by when they were last opened, unseen ones keeping their
+ * incoming order behind the rest.
+ *
+ * A stable sort, so two workspaces nobody has opened stay in the order the API
+ * gave them rather than swapping on every render.
+ */
+export declare function byRecentlyUsed<T>(items: T[], slugOf: (item: T) => string): T[];

package/dist/workspace-recents.js

@@ -0,0 +1,37 @@
+const KEY = "pb_workspace_recents";
+const CAP = 12;
+function noteWorkspaceUsed(slug) {
+  if (typeof window === "undefined" || !slug) return;
+  try {
+    const next = [slug, ...read().filter((s) => s !== slug)].slice(0, CAP);
+    window.localStorage.setItem(KEY, JSON.stringify(next));
+  } catch {
+  }
+}
+function readWorkspaceRecents() {
+  return read();
+}
+function read() {
+  if (typeof window === "undefined") return [];
+  try {
+    const raw = JSON.parse(window.localStorage.getItem(KEY) || "[]");
+    return Array.isArray(raw) ? raw.filter((s) => typeof s === "string") : [];
+  } catch {
+    return [];
+  }
+}
+function byRecentlyUsed(items, slugOf) {
+  const recents = read();
+  if (recents.length === 0) return items;
+  const rank = (item) => {
+    const at = recents.indexOf(slugOf(item));
+    return at === -1 ? Number.MAX_SAFE_INTEGER : at;
+  };
+  return [...items].sort((a, b) => rank(a) - rank(b));
+}
+export {
+  byRecentlyUsed,
+  noteWorkspaceUsed,
+  readWorkspaceRecents
+};
+//# sourceMappingURL=workspace-recents.js.map

package/dist/workspace-recents.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/workspace-recents.ts"],"sourcesContent":["const KEY = 'pb_workspace_recents';\n/** Enough to order any menu; a merchant with more reads them on the page. */\nconst CAP = 12;\n\n/**\n * Which workspaces this person actually works in, most recent first.\n *\n * The switcher shows two of them before deferring to the full page, and two\n * slots picked by whatever order the API returned is a coin toss — an agency\n * with eight clients got the same two every time regardless of which they had\n * open all morning. Recency is the only ordering that improves with use.\n *\n * Nothing on the server records this. It is not worth a column: it is a per\n * PERSON, per DEVICE convenience, the answer changes every time somebody\n * switches, and being wrong costs one extra click into a page that lists\n * everything. localStorage rather than session, because \"the two I always use\"\n * is exactly the fact that should survive closing the tab.\n *\n * Deliberately NOT surfaced as a heading. John, 2026-08-23: *\"we should have\n * recents there like recently used — no need to title it that, just how it\n * should be.\"* A list that reorders itself does not need to announce that it\n * reorders itself.\n */\nexport function noteWorkspaceUsed(slug: string): void {\n  if (typeof window === 'undefined' || !slug) return;\n  try {\n    const next = [slug, ...read().filter((s) => s !== slug)].slice(0, CAP);\n    window.localStorage.setItem(KEY, JSON.stringify(next));\n  } catch {\n    // Private mode, or storage full. An unordered switcher is still a\n    // switcher; this must never be able to break making a workspace active.\n  }\n}\n\n/** Most recent first. Empty until somebody has switched at least once. */\nexport function readWorkspaceRecents(): string[] {\n  return read();\n}\n\nfunction read(): string[] {\n  if (typeof window === 'undefined') return [];\n  try {\n    const raw = JSON.parse(window.localStorage.getItem(KEY) || '[]');\n    // A 200 with the wrong shape is the failure `= []` does not cover, and\n    // this one is read straight into a sort comparator.\n    return Array.isArray(raw) ? raw.filter((s) => typeof s === 'string') : [];\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Order workspaces by when they were last opened, unseen ones keeping their\n * incoming order behind the rest.\n *\n * A stable sort, so two workspaces nobody has opened stay in the order the API\n * gave them rather than swapping on every render.\n */\nexport function byRecentlyUsed<T>(\n  items: T[],\n  slugOf: (item: T) => string,\n): T[] {\n  const recents = read();\n  if (recents.length === 0) return items;\n  const rank = (item: T) => {\n    const at = recents.indexOf(slugOf(item));\n    return at === -1 ? Number.MAX_SAFE_INTEGER : at;\n  };\n  return [...items].sort((a, b) => rank(a) - rank(b));\n}\n"],"mappings":"AAAA,MAAM,MAAM;AAEZ,MAAM,MAAM;AAqBL,SAAS,kBAAkB,MAAoB;AACpD,MAAI,OAAO,WAAW,eAAe,CAAC,KAAM;AAC5C,MAAI;AACF,UAAM,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE,OAAO,CAAC,MAAM,MAAM,IAAI,CAAC,EAAE,MAAM,GAAG,GAAG;AACrE,WAAO,aAAa,QAAQ,KAAK,KAAK,UAAU,IAAI,CAAC;AAAA,EACvD,QAAQ;AAAA,EAGR;AACF;AAGO,SAAS,uBAAiC;AAC/C,SAAO,KAAK;AACd;AAEA,SAAS,OAAiB;AACxB,MAAI,OAAO,WAAW,YAAa,QAAO,CAAC;AAC3C,MAAI;AACF,UAAM,MAAM,KAAK,MAAM,OAAO,aAAa,QAAQ,GAAG,KAAK,IAAI;AAG/D,WAAO,MAAM,QAAQ,GAAG,IAAI,IAAI,OAAO,CAAC,MAAM,OAAO,MAAM,QAAQ,IAAI,CAAC;AAAA,EAC1E,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AASO,SAAS,eACd,OACA,QACK;AACL,QAAM,UAAU,KAAK;AACrB,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,OAAO,CAAC,SAAY;AACxB,UAAM,KAAK,QAAQ,QAAQ,OAAO,IAAI,CAAC;AACvC,WAAO,OAAO,KAAK,OAAO,mBAAmB;AAAA,EAC/C;AACA,SAAO,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC;AACpD;","names":[]}

package/dist/workspace-slug.d.ts

@@ -0,0 +1 @@
+export declare function adoptRenamedWorkspace(oldSlug: string, newSlug: string): void;

package/dist/workspace-slug.js

@@ -0,0 +1,15 @@
+const KEYS = ["currentWorkspace", "pb_current_tenant", "pb_last_workspace"];
+function adoptRenamedWorkspace(oldSlug, newSlug) {
+  try {
+    for (const key of KEYS) {
+      if (localStorage.getItem(key) === oldSlug) {
+        localStorage.setItem(key, newSlug);
+      }
+    }
+  } catch {
+  }
+}
+export {
+  adoptRenamedWorkspace
+};
+//# sourceMappingURL=workspace-slug.js.map