@withpotter/lib 0.13.0-next.101

package/dist/destination-alias.js

@@ -0,0 +1,146 @@
+const DEST_ALIAS_COOKIE = "pb_dest_alias";
+const RESERVED_SEGMENTS = /* @__PURE__ */ new Set([
+  "[...slug]",
+  "activity",
+  "agency",
+  "analytics",
+  "appearance",
+  "ask",
+  "attendees",
+  "availability",
+  "blog",
+  "blog_posts",
+  "bookings",
+  "build",
+  "builds",
+  "business",
+  "buttons-lab",
+  "calendar",
+  "calendar-sync",
+  "catalog",
+  "categories",
+  "charts-lab",
+  "check-in",
+  "collections",
+  "communications",
+  "companion",
+  "content",
+  "customers",
+  "design-system",
+  "discounts",
+  "editor",
+  "events",
+  "explore",
+  "finance",
+  "gift-cards",
+  "hardware",
+  "help",
+  "inbox",
+  "inquiries",
+  "invoices",
+  "loyalty",
+  "marketing",
+  "me",
+  "mobile-redesign",
+  "money-preview",
+  "operations",
+  "orders",
+  "payments",
+  "potter-lab",
+  "referrals",
+  "resources",
+  "reviews",
+  "sales",
+  "schedule",
+  "settings",
+  "staff",
+  "states-lab",
+  "store",
+  "subscriptions",
+  "support",
+  "tabs",
+  "templates",
+  "today",
+  "toolkit",
+  "waitlist",
+  "wallet",
+  "workspaces"
+]);
+const MAX_WORDS_PER_SCREEN = 3;
+const SEGMENT = /^[a-z0-9][a-z0-9_-]*$/;
+function labelSlug(label) {
+  return (label ?? "").normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40);
+}
+function aliasWordFor(label) {
+  const slug = labelSlug(label);
+  if (!slug || RESERVED_SEGMENTS.has(slug)) return null;
+  return slug;
+}
+function split(pathname) {
+  const match = /^\/dashboard\/([^/]+)(\/.*)?$/.exec(pathname);
+  return match ? [match[1], match[2] ?? ""] : null;
+}
+function parseAliasMap(cookie) {
+  const map = {};
+  const taken = /* @__PURE__ */ new Set();
+  let raw = cookie ?? "";
+  try {
+    raw = decodeURIComponent(raw);
+  } catch {
+    return map;
+  }
+  for (const entry of raw.split(";")) {
+    const [segment, words] = entry.split("=");
+    if (!segment || !words || !SEGMENT.test(segment)) continue;
+    for (const word of words.split(",")) {
+      const slug = aliasWordFor(word);
+      if (!slug || slug === segment || taken.has(slug)) continue;
+      taken.add(slug);
+      (map[segment] ??= []).push(slug);
+    }
+  }
+  return map;
+}
+function serializeAliasMap(map) {
+  return Object.entries(map).filter(([, words]) => words.length > 0).map(([segment, words]) => `${segment}=${words.join(",")}`).join(";");
+}
+function withAlias(map, segment, word) {
+  if (!word || word === segment) return map;
+  for (const [other, words] of Object.entries(map)) {
+    if (other !== segment && words.includes(word)) return map;
+  }
+  const current = map[segment] ?? [];
+  if (current[0] === word) return map;
+  return {
+    ...map,
+    [segment]: [word, ...current.filter((w) => w !== word)].slice(
+      0,
+      MAX_WORDS_PER_SCREEN
+    )
+  };
+}
+function toAliasPath(pathname, map) {
+  const parts = split(pathname);
+  const word = parts ? map[parts[0]]?.[0] : void 0;
+  return parts && word ? `/dashboard/${word}${parts[1]}` : pathname;
+}
+function toRealPath(pathname, map) {
+  const parts = split(pathname);
+  if (!parts) return pathname;
+  for (const [segment, words] of Object.entries(map)) {
+    if (words.includes(parts[0])) return `/dashboard/${segment}${parts[1]}`;
+  }
+  return pathname;
+}
+export {
+  DEST_ALIAS_COOKIE,
+  RESERVED_SEGMENTS,
+  aliasWordFor,
+  labelSlug,
+  parseAliasMap,
+  serializeAliasMap,
+  toAliasPath,
+  toRealPath,
+  withAlias
+};
+//# sourceMappingURL=destination-alias.js.map

package/dist/destination-alias.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/destination-alias.ts"],"sourcesContent":["/**\n * The address a merchant sees for a screen.\n *\n * A screen's real route is fixed (/dashboard/orders, /dashboard/catalog, ...),\n * and 100+ files link to it. Its TITLE is the merchant's own word for it —\n * Products, Inventory, Menu, Kitchen Orders, or a custom label like \"Our Shop\"\n * — so the address bar disagreed with the page. The proxy answers that without\n * moving any route: it rewrites /dashboard/<word> to the real screen and\n * redirects the real one to <word>.\n *\n * The proxy cannot read tenant settings, so the client leaves the words in a\n * cookie once it knows them: one entry per real route, newest word first.\n * Until then the real route is served as it always was.\n *\n * Only top-level routes are aliased (/dashboard/<segment>); everything below\n * one follows its parent.\n */\nexport const DEST_ALIAS_COOKIE = 'pb_dest_alias';\n\n/** real segment → the words it has gone by, newest first. */\nexport type AliasMap = Record<string, string[]>;\n\n/**\n * Top-level dashboard routes that exist. A word may not shadow one of these,\n * or the screen it belongs to would become unreachable. `inventory` is absent\n * on purpose: it is only a redirect to the catalog, so claiming it is safe.\n * `alias.test.ts` fails when this drifts from the app directory.\n */\nexport const RESERVED_SEGMENTS = new Set([\n  '[...slug]',\n  'activity',\n  'agency',\n  'analytics',\n  'appearance',\n  'ask',\n  'attendees',\n  'availability',\n  'blog',\n  'blog_posts',\n  'bookings',\n  'build',\n  'builds',\n  'business',\n  'buttons-lab',\n  'calendar',\n  'calendar-sync',\n  'catalog',\n  'categories',\n  'charts-lab',\n  'check-in',\n  'collections',\n  'communications',\n  'companion',\n  'content',\n  'customers',\n  'design-system',\n  'discounts',\n  'editor',\n  'events',\n  'explore',\n  'finance',\n  'gift-cards',\n  'hardware',\n  'help',\n  'inbox',\n  'inquiries',\n  'invoices',\n  'loyalty',\n  'marketing',\n  'me',\n  'mobile-redesign',\n  'money-preview',\n  'operations',\n  'orders',\n  'payments',\n  'potter-lab',\n  'referrals',\n  'resources',\n  'reviews',\n  'sales',\n  'schedule',\n  'settings',\n  'staff',\n  'states-lab',\n  'store',\n  'subscriptions',\n  'support',\n  'tabs',\n  'templates',\n  'today',\n  'toolkit',\n  'waitlist',\n  'wallet',\n  'workspaces',\n]);\n\nconst MAX_WORDS_PER_SCREEN = 3;\n\nconst SEGMENT = /^[a-z0-9][a-z0-9_-]*$/;\n\n/** \"Our Shop\" → \"our-shop\". Empty when nothing usable is left. */\nexport function labelSlug(label: string | undefined | null): string {\n  return (label ?? '')\n    .normalize('NFKD')\n    .replace(/[\\u0300-\\u036f]/g, '')\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .slice(0, 40);\n}\n\n/** The word to use for a label, or null when it would shadow a real screen. */\nexport function aliasWordFor(label: string | undefined | null): string | null {\n  const slug = labelSlug(label);\n  if (!slug || RESERVED_SEGMENTS.has(slug)) return null;\n  return slug;\n}\n\n/** `/dashboard/<segment>/rest` → [segment, '/rest'], else null. */\nfunction split(pathname: string): [string, string] | null {\n  const match = /^\\/dashboard\\/([^/]+)(\\/.*)?$/.exec(pathname);\n  return match ? [match[1], match[2] ?? ''] : null;\n}\n\n/** `catalog=products,inventory;orders=kitchen` → a validated map. */\nexport function parseAliasMap(cookie: string | undefined | null): AliasMap {\n  const map: AliasMap = {};\n  const taken = new Set<string>();\n  let raw = cookie ?? '';\n  try {\n    raw = decodeURIComponent(raw);\n  } catch {\n    return map;\n  }\n  for (const entry of raw.split(';')) {\n    const [segment, words] = entry.split('=');\n    if (!segment || !words || !SEGMENT.test(segment)) continue;\n    for (const word of words.split(',')) {\n      const slug = aliasWordFor(word);\n      if (!slug || slug === segment || taken.has(slug)) continue;\n      taken.add(slug);\n      (map[segment] ??= []).push(slug);\n    }\n  }\n  return map;\n}\n\nexport function serializeAliasMap(map: AliasMap): string {\n  return Object.entries(map)\n    .filter(([, words]) => words.length > 0)\n    .map(([segment, words]) => `${segment}=${words.join(',')}`)\n    .join(';');\n}\n\n/**\n * Records `word` as the newest for `segment`. A word another screen already\n * holds is refused, so two screens never claim one address.\n */\nexport function withAlias(\n  map: AliasMap,\n  segment: string,\n  word: string | null,\n): AliasMap {\n  if (!word || word === segment) return map;\n  for (const [other, words] of Object.entries(map)) {\n    if (other !== segment && words.includes(word)) return map;\n  }\n  const current = map[segment] ?? [];\n  if (current[0] === word) return map;\n  return {\n    ...map,\n    [segment]: [word, ...current.filter((w) => w !== word)].slice(\n      0,\n      MAX_WORDS_PER_SCREEN,\n    ),\n  };\n}\n\n/** The real route → its newest word. Unchanged when it has none. */\nexport function toAliasPath(pathname: string, map: AliasMap): string {\n  const parts = split(pathname);\n  const word = parts ? map[parts[0]]?.[0] : undefined;\n  return parts && word ? `/dashboard/${word}${parts[1]}` : pathname;\n}\n\n/** Any word a screen has gone by → the real route. Unchanged otherwise. */\nexport function toRealPath(pathname: string, map: AliasMap): string {\n  const parts = split(pathname);\n  if (!parts) return pathname;\n  for (const [segment, words] of Object.entries(map)) {\n    if (words.includes(parts[0])) return `/dashboard/${segment}${parts[1]}`;\n  }\n  return pathname;\n}\n"],"mappings":"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","names":[]}

package/dist/document-numbering.d.ts

@@ -0,0 +1,40 @@
+/**
+ * What an order or invoice will be CALLED, previewed as the merchant types.
+ *
+ * A MIRROR, not a second opinion. The API owns the real thing —
+ * `potter-api/src/shared/document-numbering.ts` mints every number that
+ * actually lands on a record — and this exists only so the settings screen can
+ * show the result before anything is created. A preview that disagrees with the
+ * number the merchant later sees is worse than no preview.
+ *
+ * `document-numbering.test.ts` pins the same cases the API's spec pins. If the
+ * two ever drift, that test is the thing that says so.
+ */
+export interface DocumentNumbering {
+    prefix?: string;
+    suffix?: string;
+    /** Whether the number carries `YYYYMMDD`. Off means a sequence that never resets. */
+    includeDate?: boolean;
+    /** Where a never-resetting sequence starts. Ignored while `includeDate` is on. */
+    startAt?: number;
+}
+export interface NumberingSettings {
+    order?: DocumentNumbering;
+    invoice?: DocumentNumbering;
+}
+export declare const DEFAULT_ORDER_PREFIX = "ORD";
+export declare const DEFAULT_INVOICE_PREFIX = "INV";
+export declare const MAX_AFFIX_LENGTH = 10;
+/** Upper-case, letters digits and hyphens, capped. Empty means "use the default". */
+export declare function sanitiseAffix(raw: string | undefined | null): string;
+/** The date block and the sequence are one decision. See the API's copy. */
+export declare function countsPerDay(numbering: DocumentNumbering | undefined): boolean;
+export declare function sequenceFor(count: number, numbering: DocumentNumbering | undefined): number;
+export declare function buildDocumentNumber(input: {
+    numbering: DocumentNumbering | undefined;
+    fallbackPrefix: string;
+    sequence: number;
+    now?: Date;
+}): string;
+/** The next number this scheme would mint, for the settings screen. */
+export declare function previewDocumentNumber(numbering: DocumentNumbering | undefined, fallbackPrefix: string, now?: Date): string;

package/dist/document-numbering.js

@@ -0,0 +1,48 @@
+const DEFAULT_ORDER_PREFIX = "ORD";
+const DEFAULT_INVOICE_PREFIX = "INV";
+const MAX_AFFIX_LENGTH = 10;
+function sanitiseAffix(raw) {
+  return (raw ?? "").toUpperCase().replace(/[^A-Z0-9-]/g, "").replace(/-{2,}/g, "-").replace(/^-+|-+$/g, "").slice(0, MAX_AFFIX_LENGTH);
+}
+function dateBlock(date) {
+  return `${date.getFullYear()}${String(date.getMonth() + 1).padStart(2, "0")}${String(date.getDate()).padStart(2, "0")}`;
+}
+function countsPerDay(numbering) {
+  return numbering?.includeDate ?? true;
+}
+function sequenceFor(count, numbering) {
+  const next = count + 1;
+  if (countsPerDay(numbering)) return next;
+  const floor = Math.floor(numbering?.startAt ?? 1);
+  return Math.max(next, floor > 0 ? floor : 1);
+}
+function buildDocumentNumber(input) {
+  const { numbering, fallbackPrefix, sequence } = input;
+  const now = input.now ?? /* @__PURE__ */ new Date();
+  const prefix = sanitiseAffix(numbering?.prefix) || fallbackPrefix;
+  const suffix = sanitiseAffix(numbering?.suffix);
+  const parts = [prefix];
+  if (countsPerDay(numbering)) parts.push(dateBlock(now));
+  parts.push(String(sequence).padStart(4, "0"));
+  if (suffix) parts.push(suffix);
+  return parts.join("-");
+}
+function previewDocumentNumber(numbering, fallbackPrefix, now) {
+  return buildDocumentNumber({
+    numbering,
+    fallbackPrefix,
+    sequence: sequenceFor(0, numbering),
+    now
+  });
+}
+export {
+  DEFAULT_INVOICE_PREFIX,
+  DEFAULT_ORDER_PREFIX,
+  MAX_AFFIX_LENGTH,
+  buildDocumentNumber,
+  countsPerDay,
+  previewDocumentNumber,
+  sanitiseAffix,
+  sequenceFor
+};
+//# sourceMappingURL=document-numbering.js.map

package/dist/document-numbering.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/document-numbering.ts"],"sourcesContent":["/**\n * What an order or invoice will be CALLED, previewed as the merchant types.\n *\n * A MIRROR, not a second opinion. The API owns the real thing —\n * `potter-api/src/shared/document-numbering.ts` mints every number that\n * actually lands on a record — and this exists only so the settings screen can\n * show the result before anything is created. A preview that disagrees with the\n * number the merchant later sees is worse than no preview.\n *\n * `document-numbering.test.ts` pins the same cases the API's spec pins. If the\n * two ever drift, that test is the thing that says so.\n */\n\nexport interface DocumentNumbering {\n  prefix?: string;\n  suffix?: string;\n  /** Whether the number carries `YYYYMMDD`. Off means a sequence that never resets. */\n  includeDate?: boolean;\n  /** Where a never-resetting sequence starts. Ignored while `includeDate` is on. */\n  startAt?: number;\n}\n\nexport interface NumberingSettings {\n  order?: DocumentNumbering;\n  invoice?: DocumentNumbering;\n}\n\nexport const DEFAULT_ORDER_PREFIX = 'ORD';\nexport const DEFAULT_INVOICE_PREFIX = 'INV';\nexport const MAX_AFFIX_LENGTH = 10;\n\n/** Upper-case, letters digits and hyphens, capped. Empty means \"use the default\". */\nexport function sanitiseAffix(raw: string | undefined | null): string {\n  return (raw ?? '')\n    .toUpperCase()\n    .replace(/[^A-Z0-9-]/g, '')\n    .replace(/-{2,}/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .slice(0, MAX_AFFIX_LENGTH);\n}\n\nfunction dateBlock(date: Date): string {\n  return (\n    `${date.getFullYear()}` +\n    `${String(date.getMonth() + 1).padStart(2, '0')}` +\n    `${String(date.getDate()).padStart(2, '0')}`\n  );\n}\n\n/** The date block and the sequence are one decision. See the API's copy. */\nexport function countsPerDay(\n  numbering: DocumentNumbering | undefined,\n): boolean {\n  return numbering?.includeDate ?? true;\n}\n\nexport function sequenceFor(\n  count: number,\n  numbering: DocumentNumbering | undefined,\n): number {\n  const next = count + 1;\n  if (countsPerDay(numbering)) return next;\n  const floor = Math.floor(numbering?.startAt ?? 1);\n  return Math.max(next, floor > 0 ? floor : 1);\n}\n\nexport function buildDocumentNumber(input: {\n  numbering: DocumentNumbering | undefined;\n  fallbackPrefix: string;\n  sequence: number;\n  now?: Date;\n}): string {\n  const { numbering, fallbackPrefix, sequence } = input;\n  const now = input.now ?? new Date();\n\n  const prefix = sanitiseAffix(numbering?.prefix) || fallbackPrefix;\n  const suffix = sanitiseAffix(numbering?.suffix);\n\n  const parts = [prefix];\n  if (countsPerDay(numbering)) parts.push(dateBlock(now));\n  parts.push(String(sequence).padStart(4, '0'));\n  if (suffix) parts.push(suffix);\n\n  return parts.join('-');\n}\n\n/** The next number this scheme would mint, for the settings screen. */\nexport function previewDocumentNumber(\n  numbering: DocumentNumbering | undefined,\n  fallbackPrefix: string,\n  now?: Date,\n): string {\n  return buildDocumentNumber({\n    numbering,\n    fallbackPrefix,\n    sequence: sequenceFor(0, numbering),\n    now,\n  });\n}\n"],"mappings":"AA2BO,MAAM,uBAAuB;AAC7B,MAAM,yBAAyB;AAC/B,MAAM,mBAAmB;AAGzB,SAAS,cAAc,KAAwC;AACpE,UAAQ,OAAO,IACZ,YAAY,EACZ,QAAQ,eAAe,EAAE,EACzB,QAAQ,UAAU,GAAG,EACrB,QAAQ,YAAY,EAAE,EACtB,MAAM,GAAG,gBAAgB;AAC9B;AAEA,SAAS,UAAU,MAAoB;AACrC,SACE,GAAG,KAAK,YAAY,CAAC,GAClB,OAAO,KAAK,SAAS,IAAI,CAAC,EAAE,SAAS,GAAG,GAAG,CAAC,GAC5C,OAAO,KAAK,QAAQ,CAAC,EAAE,SAAS,GAAG,GAAG,CAAC;AAE9C;AAGO,SAAS,aACd,WACS;AACT,SAAO,WAAW,eAAe;AACnC;AAEO,SAAS,YACd,OACA,WACQ;AACR,QAAM,OAAO,QAAQ;AACrB,MAAI,aAAa,SAAS,EAAG,QAAO;AACpC,QAAM,QAAQ,KAAK,MAAM,WAAW,WAAW,CAAC;AAChD,SAAO,KAAK,IAAI,MAAM,QAAQ,IAAI,QAAQ,CAAC;AAC7C;AAEO,SAAS,oBAAoB,OAKzB;AACT,QAAM,EAAE,WAAW,gBAAgB,SAAS,IAAI;AAChD,QAAM,MAAM,MAAM,OAAO,oBAAI,KAAK;AAElC,QAAM,SAAS,cAAc,WAAW,MAAM,KAAK;AACnD,QAAM,SAAS,cAAc,WAAW,MAAM;AAE9C,QAAM,QAAQ,CAAC,MAAM;AACrB,MAAI,aAAa,SAAS,EAAG,OAAM,KAAK,UAAU,GAAG,CAAC;AACtD,QAAM,KAAK,OAAO,QAAQ,EAAE,SAAS,GAAG,GAAG,CAAC;AAC5C,MAAI,OAAQ,OAAM,KAAK,MAAM;AAE7B,SAAO,MAAM,KAAK,GAAG;AACvB;AAGO,SAAS,sBACd,WACA,gBACA,KACQ;AACR,SAAO,oBAAoB;AAAA,IACzB;AAAA,IACA;AAAA,IACA,UAAU,YAAY,GAAG,SAAS;AAAA,IAClC;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/document-title.d.ts

@@ -0,0 +1,22 @@
+export declare function ScreenTitleProvider({ children, }: {
+    children: React.ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Claim the tab for this screen while it is mounted.
+ *
+ * A no-op outside the provider rather than a throw: the page frames call this,
+ * and a frame is a shared primitive that cannot assume which section of the app
+ * it was rendered into. A nameless tab is a far smaller failure than a screen
+ * that will not render.
+ */
+export declare function useDocumentTitle(name: string | undefined): void;
+/**
+ * Names the tab after the sidebar row that owns the route, for every screen
+ * that never names itself. Renders nothing.
+ *
+ * Its own component, and not folded into the provider, because the nav lookup
+ * reaches `useSearchParams` — which in a layout with no Suspense boundary above
+ * it bails the whole route out of rendering and blanks every dashboard page.
+ * Isolated here, the boundary wraps something that draws nothing.
+ */
+export declare function NavScreenTitle(): null;

package/dist/document-title.js

@@ -0,0 +1,85 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useEffect,
+  useId,
+  useMemo,
+  useState
+} from "react";
+import { tabTitle } from "@withpotter/lib/app-name";
+import { useOptionalTenant } from "@withpotter/lib/auth-context";
+import { useNavScreenName } from "@withpotter/lib/use-nav-groups";
+const PRIORITY_FRAME = 2;
+const PRIORITY_NAV = 1;
+const TitleClaimsContext = createContext(null);
+function ScreenTitleProvider({
+  children
+}) {
+  const [claims, setClaims] = useState([]);
+  const owner = useOptionalTenant()?.businessName;
+  const claim = useCallback(
+    (id, name, priority) => {
+      setClaims((prev) => {
+        const rest = prev.filter((c) => c.id !== id);
+        const trimmed = name?.trim();
+        if (!trimmed) return rest;
+        const seq = prev.reduce((max, c) => Math.max(max, c.seq), 0) + 1;
+        return [...rest, { id, name: trimmed, priority, seq }];
+      });
+    },
+    []
+  );
+  const release = useCallback((id) => {
+    setClaims((prev) => prev.filter((c) => c.id !== id));
+  }, []);
+  const screen = useMemo(() => {
+    let best;
+    for (const c of claims) {
+      if (!best || c.priority > best.priority || c.priority === best.priority && c.seq > best.seq) {
+        best = c;
+      }
+    }
+    return best?.name;
+  }, [claims]);
+  const title = tabTitle(screen, owner);
+  useEffect(() => {
+    const apply = () => {
+      if (document.title !== title) document.title = title;
+    };
+    apply();
+    const observer = new MutationObserver(apply);
+    observer.observe(document.head, {
+      childList: true,
+      subtree: true,
+      characterData: true
+    });
+    return () => observer.disconnect();
+  }, [title]);
+  const api = useMemo(() => ({ claim, release }), [claim, release]);
+  return /* @__PURE__ */ jsx(TitleClaimsContext.Provider, { value: api, children });
+}
+function useClaimTitle(name, priority) {
+  const claims = useContext(TitleClaimsContext);
+  const id = useId();
+  useEffect(() => {
+    if (!claims) return;
+    claims.claim(id, name, priority);
+    return () => claims.release(id);
+  }, [claims, id, name, priority]);
+}
+function useDocumentTitle(name) {
+  useClaimTitle(name, PRIORITY_FRAME);
+}
+function NavScreenTitle() {
+  useClaimTitle(useNavScreenName(), PRIORITY_NAV);
+  return null;
+}
+export {
+  NavScreenTitle,
+  ScreenTitleProvider,
+  useDocumentTitle
+};
+//# sourceMappingURL=document-title.js.map

package/dist/document-title.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/document-title.tsx"],"sourcesContent":["'use client';\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useId,\n  useMemo,\n  useState,\n} from 'react';\nimport { tabTitle } from '@withpotter/lib/app-name';\nimport { useOptionalTenant } from '@withpotter/lib/auth-context';\nimport { useNavScreenName } from '@withpotter/lib/use-nav-groups';\n\n/**\n * Name the browser tab after the screen you are on, and the business you are\n * in: \"Orders · Ààrò Ceramics\".\n *\n * The root layout's `%s · Box` template only fires for a route that exports\n * metadata, and all 143 dashboard screens are client components that cannot. So\n * every tab fell through to the same default, and with the catalogue and the\n * orders list both open there was nothing to tell them apart in the strip or in\n * browser history.\n *\n * One writer, because two would fight over the same DOM node. The provider\n * holds the tab; screens only say what they are called, and the loudest claim\n * wins:\n *\n *   FRAME  a screen naming itself, including a record called \"Order #1042\"\n *   NAV    the row the sidebar would highlight, which is the only thing that\n *          names the 94 screens sitting on no page frame\n *\n * With neither, the business stands in the tab alone.\n */\n\n/** A screen naming itself beats the nav's name for the route it sits on. */\nconst PRIORITY_FRAME = 2;\nconst PRIORITY_NAV = 1;\n\ninterface Claim {\n  id: string;\n  name: string;\n  priority: number;\n  /** Tie-break within a priority: a remount should beat what it replaced. */\n  seq: number;\n}\n\ninterface TitleClaims {\n  claim: (id: string, name: string | undefined, priority: number) => void;\n  release: (id: string) => void;\n}\n\nconst TitleClaimsContext = createContext<TitleClaims | null>(null);\n\nexport function ScreenTitleProvider({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  const [claims, setClaims] = useState<Claim[]>([]);\n  const owner = useOptionalTenant()?.businessName;\n\n  const claim = useCallback(\n    (id: string, name: string | undefined, priority: number) => {\n      setClaims((prev) => {\n        const rest = prev.filter((c) => c.id !== id);\n        const trimmed = name?.trim();\n        if (!trimmed) return rest;\n        const seq = prev.reduce((max, c) => Math.max(max, c.seq), 0) + 1;\n        return [...rest, { id, name: trimmed, priority, seq }];\n      });\n    },\n    [],\n  );\n\n  const release = useCallback((id: string) => {\n    setClaims((prev) => prev.filter((c) => c.id !== id));\n  }, []);\n\n  const screen = useMemo(() => {\n    let best: Claim | undefined;\n    for (const c of claims) {\n      if (\n        !best ||\n        c.priority > best.priority ||\n        (c.priority === best.priority && c.seq > best.seq)\n      ) {\n        best = c;\n      }\n    }\n    return best?.name;\n  }, [claims]);\n\n  const title = tabTitle(screen, owner);\n\n  useEffect(() => {\n    const apply = () => {\n      if (document.title !== title) document.title = title;\n    };\n    apply();\n\n    // Assigning once is not enough. Next streams its metadata, so React commits\n    // the route's own <title> after this effect has run and puts the bare app\n    // name back — the symptom was a page headed \"Orders\" whose tab still read\n    // \"Box\". Watching the head and re-asserting beats racing it on a timer,\n    // and `apply` is a string compare that no-ops on the write it just made, so\n    // it cannot loop.\n    const observer = new MutationObserver(apply);\n    observer.observe(document.head, {\n      childList: true,\n      subtree: true,\n      characterData: true,\n    });\n    return () => observer.disconnect();\n  }, [title]);\n\n  const api = useMemo(() => ({ claim, release }), [claim, release]);\n\n  return (\n    <TitleClaimsContext.Provider value={api}>\n      {children}\n    </TitleClaimsContext.Provider>\n  );\n}\n\nfunction useClaimTitle(name: string | undefined, priority: number) {\n  const claims = useContext(TitleClaimsContext);\n  const id = useId();\n\n  useEffect(() => {\n    if (!claims) return;\n    claims.claim(id, name, priority);\n    return () => claims.release(id);\n  }, [claims, id, name, priority]);\n}\n\n/**\n * Claim the tab for this screen while it is mounted.\n *\n * A no-op outside the provider rather than a throw: the page frames call this,\n * and a frame is a shared primitive that cannot assume which section of the app\n * it was rendered into. A nameless tab is a far smaller failure than a screen\n * that will not render.\n */\nexport function useDocumentTitle(name: string | undefined) {\n  useClaimTitle(name, PRIORITY_FRAME);\n}\n\n/**\n * Names the tab after the sidebar row that owns the route, for every screen\n * that never names itself. Renders nothing.\n *\n * Its own component, and not folded into the provider, because the nav lookup\n * reaches `useSearchParams` — which in a layout with no Suspense boundary above\n * it bails the whole route out of rendering and blanks every dashboard page.\n * Isolated here, the boundary wraps something that draws nothing.\n */\nexport function NavScreenTitle() {\n  useClaimTitle(useNavScreenName(), PRIORITY_NAV);\n  return null;\n}\n"],"mappings":";AAwHI;AAtHJ;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,gBAAgB;AACzB,SAAS,yBAAyB;AAClC,SAAS,wBAAwB;AAwBjC,MAAM,iBAAiB;AACvB,MAAM,eAAe;AAerB,MAAM,qBAAqB,cAAkC,IAAI;AAE1D,SAAS,oBAAoB;AAAA,EAClC;AACF,GAEG;AACD,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAkB,CAAC,CAAC;AAChD,QAAM,QAAQ,kBAAkB,GAAG;AAEnC,QAAM,QAAQ;AAAA,IACZ,CAAC,IAAY,MAA0B,aAAqB;AAC1D,gBAAU,CAAC,SAAS;AAClB,cAAM,OAAO,KAAK,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE;AAC3C,cAAM,UAAU,MAAM,KAAK;AAC3B,YAAI,CAAC,QAAS,QAAO;AACrB,cAAM,MAAM,KAAK,OAAO,CAAC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,GAAG,GAAG,CAAC,IAAI;AAC/D,eAAO,CAAC,GAAG,MAAM,EAAE,IAAI,MAAM,SAAS,UAAU,IAAI,CAAC;AAAA,MACvD,CAAC;AAAA,IACH;AAAA,IACA,CAAC;AAAA,EACH;AAEA,QAAM,UAAU,YAAY,CAAC,OAAe;AAC1C,cAAU,CAAC,SAAS,KAAK,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAAA,EACrD,GAAG,CAAC,CAAC;AAEL,QAAM,SAAS,QAAQ,MAAM;AAC3B,QAAI;AACJ,eAAW,KAAK,QAAQ;AACtB,UACE,CAAC,QACD,EAAE,WAAW,KAAK,YACjB,EAAE,aAAa,KAAK,YAAY,EAAE,MAAM,KAAK,KAC9C;AACA,eAAO;AAAA,MACT;AAAA,IACF;AACA,WAAO,MAAM;AAAA,EACf,GAAG,CAAC,MAAM,CAAC;AAEX,QAAM,QAAQ,SAAS,QAAQ,KAAK;AAEpC,YAAU,MAAM;AACd,UAAM,QAAQ,MAAM;AAClB,UAAI,SAAS,UAAU,MAAO,UAAS,QAAQ;AAAA,IACjD;AACA,UAAM;AAQN,UAAM,WAAW,IAAI,iBAAiB,KAAK;AAC3C,aAAS,QAAQ,SAAS,MAAM;AAAA,MAC9B,WAAW;AAAA,MACX,SAAS;AAAA,MACT,eAAe;AAAA,IACjB,CAAC;AACD,WAAO,MAAM,SAAS,WAAW;AAAA,EACnC,GAAG,CAAC,KAAK,CAAC;AAEV,QAAM,MAAM,QAAQ,OAAO,EAAE,OAAO,QAAQ,IAAI,CAAC,OAAO,OAAO,CAAC;AAEhE,SACE,oBAAC,mBAAmB,UAAnB,EAA4B,OAAO,KACjC,UACH;AAEJ;AAEA,SAAS,cAAc,MAA0B,UAAkB;AACjE,QAAM,SAAS,WAAW,kBAAkB;AAC5C,QAAM,KAAK,MAAM;AAEjB,YAAU,MAAM;AACd,QAAI,CAAC,OAAQ;AACb,WAAO,MAAM,IAAI,MAAM,QAAQ;AAC/B,WAAO,MAAM,OAAO,QAAQ,EAAE;AAAA,EAChC,GAAG,CAAC,QAAQ,IAAI,MAAM,QAAQ,CAAC;AACjC;AAUO,SAAS,iBAAiB,MAA0B;AACzD,gBAAc,MAAM,cAAc;AACpC;AAWO,SAAS,iBAAiB;AAC/B,gBAAc,iBAAiB,GAAG,YAAY;AAC9C,SAAO;AACT;","names":[]}

package/dist/editor/row-ops.d.ts

@@ -0,0 +1,39 @@
+/**
+ * What duplicating or dropping a repeater row actually does to the array.
+ *
+ * Lifted out of the editor shell so it can be tested. It was four lines of
+ * splice inside a click handler, which is exactly where a wrong index or a
+ * shared id hides — the kind of bug that only shows up as "editing the new one
+ * changed the old one", weeks later, in someone's live site.
+ */
+export type Row = Record<string, unknown>;
+/**
+ * A copy, placed directly after the one it was copied from.
+ *
+ * A copy rather than an empty row: an empty one renders as a gap with nothing
+ * to click, which on a canvas is indistinguishable from nothing having
+ * happened. A copy is visibly there and every word in it is already editable,
+ * so the merchant retypes rather than conjures.
+ *
+ * `id` is dropped where a row carries one. Two rows sharing an id is how a
+ * later edit to the copy silently rewrites the original — the storefront keys
+ * by it, and the pages module writes by it.
+ */
+export declare function duplicateRow(rows: Row[], index: number): Row[];
+/**
+ * Drop one, unless it is the last.
+ *
+ * A repeater with nothing in it renders an empty band and offers no way back —
+ * there is no row left to click, so no control to bring one. "Delete the
+ * section" is a different decision, made somewhere that can undo it.
+ */
+export declare function removeRow(rows: Row[], index: number): Row[];
+/**
+ * Where a photograph's description lives, by the templates' own convention.
+ *
+ * Counted across every template that declares one: `image` → `imageAlt`,
+ * `heroImage` → `heroImageAlt`, `menuImage` → `menuImageAlt`, `card` →
+ * `cardAlt`. A repeater path keeps its prefix, so `_items.2.image` becomes
+ * `_items.2.imageAlt` and not `_items.2.image.Alt` or `imageAlt`.
+ */
+export declare function altFieldFor(fieldId: string): string;

package/dist/editor/row-ops.js

@@ -0,0 +1,25 @@
+function duplicateRow(rows, index) {
+  const source = rows[index];
+  if (!source) return rows;
+  const copy = { ...source };
+  delete copy.id;
+  const next = [...rows];
+  next.splice(index + 1, 0, copy);
+  return next;
+}
+function removeRow(rows, index) {
+  if (rows.length <= 1) return rows;
+  if (index < 0 || index >= rows.length) return rows;
+  return rows.filter((_, i) => i !== index);
+}
+function altFieldFor(fieldId) {
+  const parts = fieldId.split(".");
+  parts[parts.length - 1] = `${parts[parts.length - 1]}Alt`;
+  return parts.join(".");
+}
+export {
+  altFieldFor,
+  duplicateRow,
+  removeRow
+};
+//# sourceMappingURL=row-ops.js.map

package/dist/editor/row-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/editor/row-ops.ts"],"sourcesContent":["/**\n * What duplicating or dropping a repeater row actually does to the array.\n *\n * Lifted out of the editor shell so it can be tested. It was four lines of\n * splice inside a click handler, which is exactly where a wrong index or a\n * shared id hides — the kind of bug that only shows up as \"editing the new one\n * changed the old one\", weeks later, in someone's live site.\n */\n\nexport type Row = Record<string, unknown>;\n\n/**\n * A copy, placed directly after the one it was copied from.\n *\n * A copy rather than an empty row: an empty one renders as a gap with nothing\n * to click, which on a canvas is indistinguishable from nothing having\n * happened. A copy is visibly there and every word in it is already editable,\n * so the merchant retypes rather than conjures.\n *\n * `id` is dropped where a row carries one. Two rows sharing an id is how a\n * later edit to the copy silently rewrites the original — the storefront keys\n * by it, and the pages module writes by it.\n */\nexport function duplicateRow(rows: Row[], index: number): Row[] {\n  const source = rows[index];\n  if (!source) return rows;\n  const copy = { ...source };\n  delete copy.id;\n  const next = [...rows];\n  next.splice(index + 1, 0, copy);\n  return next;\n}\n\n/**\n * Drop one, unless it is the last.\n *\n * A repeater with nothing in it renders an empty band and offers no way back —\n * there is no row left to click, so no control to bring one. \"Delete the\n * section\" is a different decision, made somewhere that can undo it.\n */\nexport function removeRow(rows: Row[], index: number): Row[] {\n  if (rows.length <= 1) return rows;\n  if (index < 0 || index >= rows.length) return rows;\n  return rows.filter((_, i) => i !== index);\n}\n\n/**\n * Where a photograph's description lives, by the templates' own convention.\n *\n * Counted across every template that declares one: `image` → `imageAlt`,\n * `heroImage` → `heroImageAlt`, `menuImage` → `menuImageAlt`, `card` →\n * `cardAlt`. A repeater path keeps its prefix, so `_items.2.image` becomes\n * `_items.2.imageAlt` and not `_items.2.image.Alt` or `imageAlt`.\n */\nexport function altFieldFor(fieldId: string): string {\n  const parts = fieldId.split('.');\n  parts[parts.length - 1] = `${parts[parts.length - 1]}Alt`;\n  return parts.join('.');\n}\n"],"mappings":"AAuBO,SAAS,aAAa,MAAa,OAAsB;AAC9D,QAAM,SAAS,KAAK,KAAK;AACzB,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,OAAO,EAAE,GAAG,OAAO;AACzB,SAAO,KAAK;AACZ,QAAM,OAAO,CAAC,GAAG,IAAI;AACrB,OAAK,OAAO,QAAQ,GAAG,GAAG,IAAI;AAC9B,SAAO;AACT;AASO,SAAS,UAAU,MAAa,OAAsB;AAC3D,MAAI,KAAK,UAAU,EAAG,QAAO;AAC7B,MAAI,QAAQ,KAAK,SAAS,KAAK,OAAQ,QAAO;AAC9C,SAAO,KAAK,OAAO,CAAC,GAAG,MAAM,MAAM,KAAK;AAC1C;AAUO,SAAS,YAAY,SAAyB;AACnD,QAAM,QAAQ,QAAQ,MAAM,GAAG;AAC/B,QAAM,MAAM,SAAS,CAAC,IAAI,GAAG,MAAM,MAAM,SAAS,CAAC,CAAC;AACpD,SAAO,MAAM,KAAK,GAAG;AACvB;","names":[]}

package/dist/editor-agent/apply-proposal.d.ts

@@ -0,0 +1,12 @@
+import type { EditProposal, PageDiffOp } from './contracts';
+export interface ApplyProposalResult {
+    /** Count of ops applied optimistically to the iframe. */
+    appliedCount: number;
+    /** Structural ops that can only render after Accept + refresh. */
+    structuralOps: PageDiffOp[];
+}
+/**
+ * Dispatch author-patches for every previewable op in `proposal`. Returns a
+ * summary so the caller can note structural ops that only land on save.
+ */
+export declare function applyProposalOptimistically(proposal: EditProposal): ApplyProposalResult;

package/dist/editor-agent/apply-proposal.js

@@ -0,0 +1,44 @@
+"use client";
+import { dispatchAuthorPatch } from "@withpotter/lib/template-preview/preview-author-patch";
+const DESIGN_BLOCK_ID = "__design__";
+function applyProposalOptimistically(proposal) {
+  let appliedCount = 0;
+  const structuralOps = [];
+  for (const op of proposal.ops) {
+    switch (op.op) {
+      case "set-field":
+      case "set-extension":
+        dispatchAuthorPatch({
+          blockId: op.sectionId,
+          field: op.field,
+          value: op.value
+        });
+        appliedCount += 1;
+        break;
+      case "set-variant":
+        dispatchAuthorPatch({
+          blockId: DESIGN_BLOCK_ID,
+          field: `sections.${op.sectionId}.variant`,
+          value: op.variant
+        });
+        appliedCount += 1;
+        break;
+      case "add-block":
+      case "remove-block":
+      case "reorder":
+        structuralOps.push(op);
+        break;
+    }
+  }
+  if (proposal.designDiff) {
+    for (const [field, value] of Object.entries(proposal.designDiff)) {
+      dispatchAuthorPatch({ blockId: DESIGN_BLOCK_ID, field, value });
+      appliedCount += 1;
+    }
+  }
+  return { appliedCount, structuralOps };
+}
+export {
+  applyProposalOptimistically
+};
+//# sourceMappingURL=apply-proposal.js.map

package/dist/editor-agent/apply-proposal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/editor-agent/apply-proposal.ts"],"sourcesContent":["'use client';\n\n/**\n * Optimistic apply for an editor-agent proposal.\n *\n * Translates typed `PageDiffOp`s into field-level `dispatchAuthorPatch` calls\n * that ride the shipped `PB_AUTHOR_PATCH` bridge (E5c) into the preview iframe\n * with no save. The Accept button is the approval gate — nothing here persists.\n *\n * Only field-level ops (`set-field`, `set-extension`, `set-variant`) and the\n * `designDiff` can be previewed instantly. Structural ops (`add-block`,\n * `remove-block`, `reorder`) change the section graph and are not expressible\n * as single-field patches; they are reported back so the caller can surface\n * \"applies on save\" and let the post-Accept refresh render them.\n */\n\nimport { dispatchAuthorPatch } from '@withpotter/lib/template-preview/preview-author-patch';\nimport type { EditProposal, PageDiffOp } from './contracts';\n\n/** The `PB_AUTHOR_PATCH` blockId that carries `settings.design` token patches. */\nconst DESIGN_BLOCK_ID = '__design__';\n\nexport interface ApplyProposalResult {\n  /** Count of ops applied optimistically to the iframe. */\n  appliedCount: number;\n  /** Structural ops that can only render after Accept + refresh. */\n  structuralOps: PageDiffOp[];\n}\n\n/**\n * Dispatch author-patches for every previewable op in `proposal`. Returns a\n * summary so the caller can note structural ops that only land on save.\n */\nexport function applyProposalOptimistically(\n  proposal: EditProposal,\n): ApplyProposalResult {\n  let appliedCount = 0;\n  const structuralOps: PageDiffOp[] = [];\n\n  for (const op of proposal.ops) {\n    switch (op.op) {\n      case 'set-field':\n      case 'set-extension':\n        dispatchAuthorPatch({\n          blockId: op.sectionId,\n          field: op.field,\n          value: op.value,\n        });\n        appliedCount += 1;\n        break;\n      case 'set-variant':\n        // Variants are server-rendered (`data._variant` branches). They ride\n        // the reserved `__design__` blockId as `sections.<id>.variant`, which\n        // the preview listener resolves against `settings.design` and\n        // soft-refreshes — matching how the brand panel persists variants.\n        dispatchAuthorPatch({\n          blockId: DESIGN_BLOCK_ID,\n          field: `sections.${op.sectionId}.variant`,\n          value: op.variant,\n        });\n        appliedCount += 1;\n        break;\n      case 'add-block':\n      case 'remove-block':\n      case 'reorder':\n        structuralOps.push(op);\n        break;\n    }\n  }\n\n  if (proposal.designDiff) {\n    for (const [field, value] of Object.entries(proposal.designDiff)) {\n      dispatchAuthorPatch({ blockId: DESIGN_BLOCK_ID, field, value });\n      appliedCount += 1;\n    }\n  }\n\n  return { appliedCount, structuralOps };\n}\n"],"mappings":";AAgBA,SAAS,2BAA2B;AAIpC,MAAM,kBAAkB;AAajB,SAAS,4BACd,UACqB;AACrB,MAAI,eAAe;AACnB,QAAM,gBAA8B,CAAC;AAErC,aAAW,MAAM,SAAS,KAAK;AAC7B,YAAQ,GAAG,IAAI;AAAA,MACb,KAAK;AAAA,MACL,KAAK;AACH,4BAAoB;AAAA,UAClB,SAAS,GAAG;AAAA,UACZ,OAAO,GAAG;AAAA,UACV,OAAO,GAAG;AAAA,QACZ,CAAC;AACD,wBAAgB;AAChB;AAAA,MACF,KAAK;AAKH,4BAAoB;AAAA,UAClB,SAAS;AAAA,UACT,OAAO,YAAY,GAAG,SAAS;AAAA,UAC/B,OAAO,GAAG;AAAA,QACZ,CAAC;AACD,wBAAgB;AAChB;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AACH,sBAAc,KAAK,EAAE;AACrB;AAAA,IACJ;AAAA,EACF;AAEA,MAAI,SAAS,YAAY;AACvB,eAAW,CAAC,OAAO,KAAK,KAAK,OAAO,QAAQ,SAAS,UAAU,GAAG;AAChE,0BAAoB,EAAE,SAAS,iBAAiB,OAAO,MAAM,CAAC;AAC9D,sBAAgB;AAAA,IAClB;AAAA,EACF;AAEA,SAAO,EAAE,cAAc,cAAc;AACvC;","names":[]}