@withpotter/lib 0.13.0-next.101

package/dist/file-intake.js

@@ -0,0 +1,162 @@
+const DEFAULT_MAX_SIZE_MB = 10;
+const EXTENSION_KINDS = {
+  png: "image",
+  jpg: "image",
+  jpeg: "image",
+  gif: "image",
+  webp: "image",
+  svg: "image",
+  avif: "image",
+  heic: "image",
+  mp4: "video",
+  mov: "video",
+  webm: "video",
+  m4v: "video",
+  mp3: "audio",
+  wav: "audio",
+  m4a: "audio",
+  aac: "audio",
+  ogg: "audio",
+  pdf: "pdf",
+  zip: "archive",
+  rar: "archive",
+  gz: "archive",
+  csv: "sheet",
+  tsv: "sheet",
+  xls: "sheet",
+  xlsx: "sheet",
+  doc: "doc",
+  docx: "doc",
+  txt: "doc",
+  md: "doc",
+  rtf: "doc",
+  ttf: "font",
+  otf: "font",
+  woff: "font",
+  woff2: "font"
+};
+const MIME_KINDS = [
+  ["image/", "image"],
+  ["video/", "video"],
+  ["audio/", "audio"],
+  ["font/", "font"],
+  ["application/pdf", "pdf"],
+  ["application/zip", "archive"],
+  ["application/x-zip", "archive"],
+  ["application/gzip", "archive"],
+  ["text/csv", "sheet"],
+  ["application/vnd.ms-excel", "sheet"],
+  ["application/vnd.openxmlformats-officedocument.spreadsheet", "sheet"],
+  ["application/msword", "doc"],
+  ["application/vnd.openxmlformats-officedocument.word", "doc"],
+  ["text/", "doc"]
+];
+function extensionOf(name) {
+  const clean = name.split(/[?#]/)[0];
+  const dot = clean.lastIndexOf(".");
+  return dot > 0 ? clean.slice(dot + 1).toLowerCase() : "";
+}
+function fileKind(input) {
+  const mime = (input.type ?? "").toLowerCase();
+  if (mime) {
+    for (const [prefix, kind] of MIME_KINDS) {
+      if (mime.startsWith(prefix)) return kind;
+    }
+  }
+  const ext = extensionOf(input.name ?? "");
+  return EXTENSION_KINDS[ext] ?? "file";
+}
+function matchesAccept(file, accept) {
+  if (!accept?.trim()) return true;
+  const mime = (file.type ?? "").toLowerCase();
+  const ext = `.${extensionOf(file.name)}`;
+  return accept.split(",").some((raw) => {
+    const token = raw.trim().toLowerCase();
+    if (!token) return false;
+    if (token === "*" || token === "*/*") return true;
+    if (token.startsWith(".")) return token === ext;
+    if (token.endsWith("/*")) return mime.startsWith(token.slice(0, -1));
+    return mime === token;
+  });
+}
+function describeAccept(accept) {
+  if (!accept?.trim()) return null;
+  const names = [];
+  for (const raw of accept.split(",")) {
+    const token = raw.trim().toLowerCase();
+    if (!token) continue;
+    let label;
+    if (token === "*" || token === "*/*") return null;
+    else if (token.endsWith("/*")) label = `${token.slice(0, -2)}s`;
+    else if (token.startsWith(".")) label = token.slice(1).toUpperCase();
+    else label = (token.split("/")[1] ?? token).toUpperCase();
+    if (label === "JPEG" && names.includes("JPG")) continue;
+    if (!names.includes(label)) names.push(label);
+  }
+  if (names.length === 0) return null;
+  if (names.length === 1) return names[0];
+  return `${names.slice(0, -1).join(", ")} or ${names[names.length - 1]}`;
+}
+function intakeHint(accept, maxSizeMb) {
+  const types = describeAccept(accept);
+  const size = maxSizeMb ? `Up to ${maxSizeMb}MB` : null;
+  return [types, size].filter(Boolean).join(" \xB7 ") || null;
+}
+function reasonSentence(reason, limits, file) {
+  const name = file ? `\u201C${file.name}\u201D` : "That file";
+  switch (reason) {
+    case "size":
+      return `${name} is over ${limits.maxSizeMb}MB.`;
+    case "count": {
+      const max = limits.maxFiles ?? 0;
+      return `There is room for ${max} ${max === 1 ? "file" : "files"} here.`;
+    }
+    case "type": {
+      const types = describeAccept(limits.accept);
+      return types ? `${name} is not a supported type. This takes ${types}.` : `${name} is not a supported type.`;
+    }
+  }
+}
+function screenFiles(files, limits = {}) {
+  const { accept, maxSizeMb, maxFiles, currentCount = 0 } = limits;
+  const accepted = [];
+  const rejected = [];
+  for (const file of files) {
+    if (!matchesAccept(file, accept)) {
+      rejected.push({ file, reason: "type" });
+      continue;
+    }
+    if (maxSizeMb && file.size > maxSizeMb * 1024 * 1024) {
+      rejected.push({ file, reason: "size" });
+      continue;
+    }
+    if (maxFiles && currentCount + accepted.length >= maxFiles) {
+      rejected.push({ file, reason: "count" });
+      continue;
+    }
+    accepted.push(file);
+  }
+  return { accepted, rejected, message: refusalMessage(rejected, limits) };
+}
+function refusalMessage(rejected, limits) {
+  if (rejected.length === 0) return null;
+  if (rejected.length === 1) {
+    return reasonSentence(rejected[0].reason, limits, rejected[0].file);
+  }
+  const reasons = new Set(rejected.map((r) => r.reason));
+  const count = `${rejected.length} files were not added.`;
+  if (reasons.size === 1) {
+    return `${count} ${reasonSentence([...reasons][0], limits)}`;
+  }
+  return `${count} Check the type and size limits.`;
+}
+export {
+  DEFAULT_MAX_SIZE_MB,
+  describeAccept,
+  extensionOf,
+  fileKind,
+  intakeHint,
+  matchesAccept,
+  screenFiles
+};
+//# sourceMappingURL=file-intake.js.map

package/dist/file-intake.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/file-intake.ts"],"sourcesContent":["/**\n * One answer to \"can this file come in, and what is it?\".\n *\n * Before this, every picker screened its own files: `MAX_SIZE_MB = 10` was\n * declared separately in logo-field and image-field, the catalog importer\n * capped at 5MB, and each one worded the refusal differently (\"Image must be\n * under 10MB\", \"Please select an image file\", \"That file is over 5MB\"). Type\n * checks were `file.type.startsWith('image/')` even where `accept` listed four\n * extensions, so a .tiff passed the check and failed at the server instead.\n *\n * The screening is here so a limit is one edit and a refusal reads the same\n * everywhere. Dropzone calls it for you; a surface that opens its own picker\n * (a logo field, a paste handler) should call `screenFiles` directly rather\n * than re-typing the two `if`s.\n */\n\nexport type FileKind =\n  | 'image'\n  | 'video'\n  | 'audio'\n  | 'pdf'\n  | 'archive'\n  | 'sheet'\n  | 'doc'\n  | 'font'\n  | 'link'\n  | 'file';\n\n/** The default ceiling for an image field. Storage plans start at 500MB. */\nexport const DEFAULT_MAX_SIZE_MB = 10;\n\nconst EXTENSION_KINDS: Record<string, FileKind> = {\n  png: 'image',\n  jpg: 'image',\n  jpeg: 'image',\n  gif: 'image',\n  webp: 'image',\n  svg: 'image',\n  avif: 'image',\n  heic: 'image',\n  mp4: 'video',\n  mov: 'video',\n  webm: 'video',\n  m4v: 'video',\n  mp3: 'audio',\n  wav: 'audio',\n  m4a: 'audio',\n  aac: 'audio',\n  ogg: 'audio',\n  pdf: 'pdf',\n  zip: 'archive',\n  rar: 'archive',\n  gz: 'archive',\n  csv: 'sheet',\n  tsv: 'sheet',\n  xls: 'sheet',\n  xlsx: 'sheet',\n  doc: 'doc',\n  docx: 'doc',\n  txt: 'doc',\n  md: 'doc',\n  rtf: 'doc',\n  ttf: 'font',\n  otf: 'font',\n  woff: 'font',\n  woff2: 'font',\n};\n\nconst MIME_KINDS: [string, FileKind][] = [\n  ['image/', 'image'],\n  ['video/', 'video'],\n  ['audio/', 'audio'],\n  ['font/', 'font'],\n  ['application/pdf', 'pdf'],\n  ['application/zip', 'archive'],\n  ['application/x-zip', 'archive'],\n  ['application/gzip', 'archive'],\n  ['text/csv', 'sheet'],\n  ['application/vnd.ms-excel', 'sheet'],\n  ['application/vnd.openxmlformats-officedocument.spreadsheet', 'sheet'],\n  ['application/msword', 'doc'],\n  ['application/vnd.openxmlformats-officedocument.word', 'doc'],\n  ['text/', 'doc'],\n];\n\nexport function extensionOf(name: string): string {\n  const clean = name.split(/[?#]/)[0];\n  const dot = clean.lastIndexOf('.');\n  return dot > 0 ? clean.slice(dot + 1).toLowerCase() : '';\n}\n\n/**\n * What kind of thing this is, for the leading icon on a row. Reads the MIME\n * type first and falls back to the extension, because a file dragged in from\n * some sources arrives with an empty `type`.\n */\nexport function fileKind(input: {\n  name?: string | null;\n  type?: string | null;\n}): FileKind {\n  const mime = (input.type ?? '').toLowerCase();\n  if (mime) {\n    for (const [prefix, kind] of MIME_KINDS) {\n      if (mime.startsWith(prefix)) return kind;\n    }\n  }\n  const ext = extensionOf(input.name ?? '');\n  return EXTENSION_KINDS[ext] ?? 'file';\n}\n\n/** Does this file satisfy an `accept` string? Empty accept means anything. */\nexport function matchesAccept(\n  file: { name: string; type?: string },\n  accept?: string,\n): boolean {\n  if (!accept?.trim()) return true;\n  const mime = (file.type ?? '').toLowerCase();\n  const ext = `.${extensionOf(file.name)}`;\n\n  return accept.split(',').some((raw) => {\n    const token = raw.trim().toLowerCase();\n    if (!token) return false;\n    if (token === '*' || token === '*/*') return true;\n    if (token.startsWith('.')) return token === ext;\n    if (token.endsWith('/*')) return mime.startsWith(token.slice(0, -1));\n    return mime === token;\n  });\n}\n\n/**\n * \"PNG, JPG or WEBP\" from an accept string, so the frame can state what it\n * takes instead of leaving the merchant to find out by being refused.\n */\nexport function describeAccept(accept?: string): string | null {\n  if (!accept?.trim()) return null;\n  const names: string[] = [];\n\n  for (const raw of accept.split(',')) {\n    const token = raw.trim().toLowerCase();\n    if (!token) continue;\n    let label: string;\n    if (token === '*' || token === '*/*') return null;\n    else if (token.endsWith('/*')) label = `${token.slice(0, -2)}s`;\n    else if (token.startsWith('.')) label = token.slice(1).toUpperCase();\n    else label = (token.split('/')[1] ?? token).toUpperCase();\n    if (label === 'JPEG' && names.includes('JPG')) continue;\n    if (!names.includes(label)) names.push(label);\n  }\n\n  if (names.length === 0) return null;\n  if (names.length === 1) return names[0];\n  return `${names.slice(0, -1).join(', ')} or ${names[names.length - 1]}`;\n}\n\n/** The line under a dropzone label: what it takes and how big. */\nexport function intakeHint(accept?: string, maxSizeMb?: number): string | null {\n  const types = describeAccept(accept);\n  const size = maxSizeMb ? `Up to ${maxSizeMb}MB` : null;\n  return [types, size].filter(Boolean).join(' · ') || null;\n}\n\nexport type RejectionReason = 'type' | 'size' | 'count';\n\nexport interface Rejection {\n  file: File;\n  reason: RejectionReason;\n}\n\nexport interface IntakeLimits {\n  accept?: string;\n  maxSizeMb?: number;\n  /** Total this surface can hold, counting what it already has. */\n  maxFiles?: number;\n  /** How many are already in, so `maxFiles` counts the whole set. */\n  currentCount?: number;\n}\n\nexport interface IntakeResult {\n  accepted: File[];\n  rejected: Rejection[];\n  /** Ready-to-render refusal, or null when everything came in. */\n  message: string | null;\n}\n\nfunction reasonSentence(\n  reason: RejectionReason,\n  limits: IntakeLimits,\n  file?: File,\n): string {\n  const name = file ? `“${file.name}”` : 'That file';\n  switch (reason) {\n    case 'size':\n      return `${name} is over ${limits.maxSizeMb}MB.`;\n    case 'count': {\n      const max = limits.maxFiles ?? 0;\n      return `There is room for ${max} ${max === 1 ? 'file' : 'files'} here.`;\n    }\n    case 'type': {\n      const types = describeAccept(limits.accept);\n      return types\n        ? `${name} is not a supported type. This takes ${types}.`\n        : `${name} is not a supported type.`;\n    }\n  }\n}\n\n/**\n * Screen a batch against the surface's limits. Nothing throws and nothing is\n * silently dropped: whatever is refused comes back with a sentence saying why,\n * because a picker that just ignores a file looks broken.\n */\nexport function screenFiles(\n  files: File[],\n  limits: IntakeLimits = {},\n): IntakeResult {\n  const { accept, maxSizeMb, maxFiles, currentCount = 0 } = limits;\n  const accepted: File[] = [];\n  const rejected: Rejection[] = [];\n\n  for (const file of files) {\n    if (!matchesAccept(file, accept)) {\n      rejected.push({ file, reason: 'type' });\n      continue;\n    }\n    if (maxSizeMb && file.size > maxSizeMb * 1024 * 1024) {\n      rejected.push({ file, reason: 'size' });\n      continue;\n    }\n    if (maxFiles && currentCount + accepted.length >= maxFiles) {\n      rejected.push({ file, reason: 'count' });\n      continue;\n    }\n    accepted.push(file);\n  }\n\n  return { accepted, rejected, message: refusalMessage(rejected, limits) };\n}\n\nfunction refusalMessage(\n  rejected: Rejection[],\n  limits: IntakeLimits,\n): string | null {\n  if (rejected.length === 0) return null;\n  if (rejected.length === 1) {\n    return reasonSentence(rejected[0].reason, limits, rejected[0].file);\n  }\n\n  const reasons = new Set(rejected.map((r) => r.reason));\n  const count = `${rejected.length} files were not added.`;\n  if (reasons.size === 1) {\n    return `${count} ${reasonSentence([...reasons][0], limits)}`;\n  }\n  return `${count} Check the type and size limits.`;\n}\n"],"mappings":"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","names":[]}

package/dist/first-run.d.ts

@@ -0,0 +1,5 @@
+export declare const flagFirstRun: () => void;
+export declare const takeFirstRun: () => boolean;
+export declare const endFirstRun: () => void;
+/** True while this page load is the arrival after provisioning. */
+export declare const isFirstRunVisit: () => boolean;

package/dist/first-run.js

@@ -0,0 +1,13 @@
+import { makeArrival } from "./arrival";
+const firstRun = makeArrival("pb_first_run");
+const flagFirstRun = firstRun.flag;
+const takeFirstRun = firstRun.take;
+const endFirstRun = firstRun.end;
+const isFirstRunVisit = firstRun.taken;
+export {
+  endFirstRun,
+  flagFirstRun,
+  isFirstRunVisit,
+  takeFirstRun
+};
+//# sourceMappingURL=first-run.js.map

package/dist/first-run.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/first-run.ts"],"sourcesContent":["import { makeArrival } from './arrival';\n\n/**\n * A merchant has just made their business, and is about to meet it.\n *\n * John, 2026-09-08: *\"then we transistion you to the daahboard which come with\n * an intro pop up modal boom you can start using it\"*.\n *\n * Flagged by the setup flow the moment provisioning succeeds, read once by the\n * dashboard. See `arrival` for why it is a stored flag and not `createdAt`.\n */\nconst firstRun = makeArrival('pb_first_run');\n\nexport const flagFirstRun = firstRun.flag;\nexport const takeFirstRun = firstRun.take;\nexport const endFirstRun = firstRun.end;\n/** True while this page load is the arrival after provisioning. */\nexport const isFirstRunVisit = firstRun.taken;\n"],"mappings":"AAAA,SAAS,mBAAmB;AAW5B,MAAM,WAAW,YAAY,cAAc;AAEpC,MAAM,eAAe,SAAS;AAC9B,MAAM,eAAe,SAAS;AAC9B,MAAM,cAAc,SAAS;AAE7B,MAAM,kBAAkB,SAAS;","names":[]}

package/dist/form-answers.d.ts

@@ -0,0 +1,57 @@
+/**
+ * What somebody typed into a form, made readable.
+ *
+ * Two surfaces collect arbitrary fields and store them in a `metadata` blob:
+ * a booking's intake questions, and an enquiry's qualifying fields — which the
+ * storefront builds per template, so the keys are not knowable here. A caterer
+ * asks for `guestCount` and `eventDate`; an estate agent asks which listing; a
+ * solar installer asks the monthly bill.
+ *
+ * The bookings side already did this, in
+ * `intake-answers-card.tsx`, as `String(value)` against the raw key. That is
+ * fine until a real payload arrives: `guestCount` renders as "guestCount",
+ * `2026-12-12` as "2026-12-12", `true` as "true", and a budget of 500000 as
+ * "500000". The answer is legible to whoever wrote the form and to nobody else.
+ *
+ * So the shaping lives here, once, and both surfaces read it.
+ *
+ * Nothing is dropped for being unrecognised — an unknown key is the normal
+ * case, and the whole point is to show what was asked without being told first.
+ */
+export interface Answer {
+    /** The original key, so React has a stable identity and debugging has a name. */
+    key: string;
+    label: string;
+    value: string;
+}
+export interface ToAnswersOptions {
+    /**
+     * Keys that are plumbing rather than answers. Excluded before anything else,
+     * so an excluded object is never flattened into view by the back door.
+     */
+    exclude?: readonly string[];
+    /**
+     * Nested objects whose contents belong at the top level. The API's own
+     * `metadata.quote` and `metadata.consultation` hold real submitted answers
+     * one level down; `metadata.customFields` is a bag with no meaning of its own.
+     */
+    flatten?: readonly string[];
+    /** For keys that read as money. Defaults to the workspace currency at the call site. */
+    currency?: string;
+}
+/**
+ * `guestCount` → "Guest count", `event_date` → "Event date".
+ *
+ * Only the first letter is capitalised. Title Case on a form label reads as a
+ * heading, and these sit in the left column of a definition list where the
+ * value is the thing being read.
+ */
+export declare function humanizeKey(key: string): string;
+/**
+ * Turn a metadata blob into rows a person can read.
+ *
+ * Order is the order the keys arrived in, which is the order the form asked
+ * them — a shape the merchant already recognises from their own site. Sorting
+ * alphabetically would scatter a date away from the headcount it belongs to.
+ */
+export declare function toAnswers(source: Record<string, unknown> | null | undefined, options?: ToAnswersOptions): Answer[];

package/dist/form-answers.js

@@ -0,0 +1,79 @@
+import { formatCurrency, formatDate } from "./utils";
+const MONEY_WORDS = /(budget|amount|price|total|fee|deposit|spend|cost|value|revenue|salary)/i;
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}(?:[T ]\d{2}:\d{2}|$)/;
+function humanizeKey(key) {
+  const spaced = key.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/[_-]+/g, " ").trim();
+  if (!spaced) return key;
+  const lower = spaced.toLowerCase();
+  const cased = lower.replace(/\butm\b/g, "UTM");
+  return cased.charAt(0).toUpperCase() + cased.slice(1);
+}
+function formatScalar(key, value, currency) {
+  if (value === null || value === void 0) return null;
+  if (typeof value === "boolean") return value ? "Yes" : "No";
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) return null;
+    return MONEY_WORDS.test(key) ? formatCurrency(value, currency) : value.toLocaleString("en-US");
+  }
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (!trimmed) return null;
+    if (ISO_DATE.test(trimmed)) {
+      const parsed = new Date(trimmed);
+      if (!Number.isNaN(parsed.getTime())) return formatDate(parsed);
+    }
+    if (MONEY_WORDS.test(key) && /^\d+(\.\d+)?$/.test(trimmed)) {
+      return formatCurrency(Number(trimmed), currency);
+    }
+    return trimmed;
+  }
+  if (Array.isArray(value)) {
+    const parts = value.map((entry) => formatScalar(key, entry, currency)).filter((entry) => entry !== null);
+    return parts.length ? parts.join(", ") : null;
+  }
+  if (typeof value === "object") {
+    const keys = Object.keys(value);
+    return keys.length ? keys.map(humanizeKey).join(", ") : null;
+  }
+  return null;
+}
+function toAnswers(source, options = {}) {
+  if (!source) return [];
+  const exclude = new Set(options.exclude ?? []);
+  const flatten = new Set(options.flatten ?? []);
+  const answers = [];
+  const seen = /* @__PURE__ */ new Set();
+  const push = (key, value, labelPrefix) => {
+    if (seen.has(key)) return;
+    const formatted = formatScalar(key, value, options.currency);
+    if (formatted === null) return;
+    seen.add(key);
+    answers.push({
+      key,
+      label: labelPrefix ? `${labelPrefix} \xB7 ${humanizeKey(key)}` : humanizeKey(key),
+      value: formatted
+    });
+  };
+  for (const [key, value] of Object.entries(source)) {
+    if (exclude.has(key)) continue;
+    if (flatten.has(key) && value !== null && typeof value === "object" && !Array.isArray(value)) {
+      for (const [innerKey, innerValue] of Object.entries(
+        value
+      )) {
+        push(
+          innerKey,
+          innerValue,
+          key === "customFields" ? void 0 : humanizeKey(key)
+        );
+      }
+      continue;
+    }
+    push(key, value);
+  }
+  return answers;
+}
+export {
+  humanizeKey,
+  toAnswers
+};
+//# sourceMappingURL=form-answers.js.map

package/dist/form-answers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/form-answers.ts"],"sourcesContent":["import { formatCurrency, formatDate } from './utils';\n\n/**\n * What somebody typed into a form, made readable.\n *\n * Two surfaces collect arbitrary fields and store them in a `metadata` blob:\n * a booking's intake questions, and an enquiry's qualifying fields — which the\n * storefront builds per template, so the keys are not knowable here. A caterer\n * asks for `guestCount` and `eventDate`; an estate agent asks which listing; a\n * solar installer asks the monthly bill.\n *\n * The bookings side already did this, in\n * `intake-answers-card.tsx`, as `String(value)` against the raw key. That is\n * fine until a real payload arrives: `guestCount` renders as \"guestCount\",\n * `2026-12-12` as \"2026-12-12\", `true` as \"true\", and a budget of 500000 as\n * \"500000\". The answer is legible to whoever wrote the form and to nobody else.\n *\n * So the shaping lives here, once, and both surfaces read it.\n *\n * Nothing is dropped for being unrecognised — an unknown key is the normal\n * case, and the whole point is to show what was asked without being told first.\n */\n\nexport interface Answer {\n  /** The original key, so React has a stable identity and debugging has a name. */\n  key: string;\n  label: string;\n  value: string;\n}\n\nexport interface ToAnswersOptions {\n  /**\n   * Keys that are plumbing rather than answers. Excluded before anything else,\n   * so an excluded object is never flattened into view by the back door.\n   */\n  exclude?: readonly string[];\n  /**\n   * Nested objects whose contents belong at the top level. The API's own\n   * `metadata.quote` and `metadata.consultation` hold real submitted answers\n   * one level down; `metadata.customFields` is a bag with no meaning of its own.\n   */\n  flatten?: readonly string[];\n  /** For keys that read as money. Defaults to the workspace currency at the call site. */\n  currency?: string;\n}\n\n/**\n * Keys whose value is money rather than a count.\n *\n * Matched as a whole word inside the key so `budgetMax` and `monthly_spend`\n * both land, while `pricePerNightNotes` — a string — is caught by the type\n * check before it gets here.\n */\nconst MONEY_WORDS =\n  /(budget|amount|price|total|fee|deposit|spend|cost|value|revenue|salary)/i;\n\n/** ISO dates, with or without a time. Anything looser is left as typed. */\nconst ISO_DATE = /^\\d{4}-\\d{2}-\\d{2}(?:[T ]\\d{2}:\\d{2}|$)/;\n\n/**\n * `guestCount` → \"Guest count\", `event_date` → \"Event date\".\n *\n * Only the first letter is capitalised. Title Case on a form label reads as a\n * heading, and these sit in the left column of a definition list where the\n * value is the thing being read.\n */\nexport function humanizeKey(key: string): string {\n  const spaced = key\n    // camelCase and PascalCase, including runs like `utmSource` → `utm Source`.\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n    // An acronym running into a word: `UTMSource` → `UTM Source`.\n    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')\n    .replace(/[_-]+/g, ' ')\n    .trim();\n\n  if (!spaced) return key;\n\n  const lower = spaced.toLowerCase();\n  // `utm` is the one acronym these forms actually carry, and \"Utm source\" is\n  // wrong in a way a merchant will notice.\n  const cased = lower.replace(/\\butm\\b/g, 'UTM');\n  return cased.charAt(0).toUpperCase() + cased.slice(1);\n}\n\nfunction formatScalar(\n  key: string,\n  value: unknown,\n  currency: string | undefined,\n): string | null {\n  if (value === null || value === undefined) return null;\n\n  if (typeof value === 'boolean') return value ? 'Yes' : 'No';\n\n  if (typeof value === 'number') {\n    if (!Number.isFinite(value)) return null;\n    return MONEY_WORDS.test(key)\n      ? formatCurrency(value, currency)\n      : value.toLocaleString('en-US');\n  }\n\n  if (typeof value === 'string') {\n    const trimmed = value.trim();\n    if (!trimmed) return null;\n    if (ISO_DATE.test(trimmed)) {\n      const parsed = new Date(trimmed);\n      // An unparseable string that merely looks like a date stays as typed\n      // rather than becoming \"Invalid Date\".\n      if (!Number.isNaN(parsed.getTime())) return formatDate(parsed);\n    }\n    // A number that arrived as a string is still money if the key says so.\n    if (MONEY_WORDS.test(key) && /^\\d+(\\.\\d+)?$/.test(trimmed)) {\n      return formatCurrency(Number(trimmed), currency);\n    }\n    return trimmed;\n  }\n\n  if (Array.isArray(value)) {\n    const parts = value\n      .map((entry) => formatScalar(key, entry, currency))\n      .filter((entry): entry is string => entry !== null);\n    return parts.length ? parts.join(', ') : null;\n  }\n\n  // A nested object that was not asked to be flattened. Showing `[object\n  // Object]` is worse than showing nothing, and dropping it silently loses an\n  // answer, so it is summarised by what it holds.\n  if (typeof value === 'object') {\n    const keys = Object.keys(value as Record<string, unknown>);\n    return keys.length ? keys.map(humanizeKey).join(', ') : null;\n  }\n\n  return null;\n}\n\n/**\n * Turn a metadata blob into rows a person can read.\n *\n * Order is the order the keys arrived in, which is the order the form asked\n * them — a shape the merchant already recognises from their own site. Sorting\n * alphabetically would scatter a date away from the headcount it belongs to.\n */\nexport function toAnswers(\n  source: Record<string, unknown> | null | undefined,\n  options: ToAnswersOptions = {},\n): Answer[] {\n  if (!source) return [];\n\n  const exclude = new Set(options.exclude ?? []);\n  const flatten = new Set(options.flatten ?? []);\n  const answers: Answer[] = [];\n  const seen = new Set<string>();\n\n  const push = (key: string, value: unknown, labelPrefix?: string) => {\n    if (seen.has(key)) return;\n    const formatted = formatScalar(key, value, options.currency);\n    if (formatted === null) return;\n    seen.add(key);\n    answers.push({\n      key,\n      label: labelPrefix\n        ? `${labelPrefix} · ${humanizeKey(key)}`\n        : humanizeKey(key),\n      value: formatted,\n    });\n  };\n\n  for (const [key, value] of Object.entries(source)) {\n    if (exclude.has(key)) continue;\n\n    if (\n      flatten.has(key) &&\n      value !== null &&\n      typeof value === 'object' &&\n      !Array.isArray(value)\n    ) {\n      for (const [innerKey, innerValue] of Object.entries(\n        value as Record<string, unknown>,\n      )) {\n        // `customFields` is a container with no name worth showing; `quote` and\n        // `consultation` are contexts, and an unprefixed \"Duration\" next to an\n        // unprefixed \"Preferred date\" loses which is which.\n        push(\n          innerKey,\n          innerValue,\n          key === 'customFields' ? undefined : humanizeKey(key),\n        );\n      }\n      continue;\n    }\n\n    push(key, value);\n  }\n\n  return answers;\n}\n"],"mappings":"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","names":[]}

package/dist/form-draft.d.ts

@@ -0,0 +1,30 @@
+/**
+ * An unsaved form, kept so an interruption does not take it with it.
+ *
+ * A phone drops a backgrounded page from memory whenever it needs the room — a
+ * call comes in, the merchant switches app — and opening it again is a fresh
+ * page load. Anything typed and not yet saved is gone with it. Component state
+ * cannot survive that; the browser's own storage can.
+ *
+ * Per workspace and per form, local to this device, and gone after a day: a
+ * draft is for getting back to what you were doing, not for keeping a second
+ * copy of a record. Every access is wrapped, because storage can be blocked or
+ * full and a draft failing to save must never be the reason a form breaks.
+ */
+export declare const DRAFT_MAX_AGE_MS: number;
+export declare function draftKey(tenantSlug: string | undefined, form: string): string | null;
+export declare function readDraft<T>(key: string | null, now?: number): T | null;
+export declare function writeDraft<T>(key: string | null, data: T, now?: number): void;
+export declare function clearDraft(key: string | null): void;
+/**
+ * A draft of an EXISTING record is only good for the record it was made from.
+ *
+ * It is stored beside a fingerprint of how that record looked when it was
+ * loaded. Someone else editing it, or saving it from another device, changes
+ * the fingerprint, and the draft is then worth less than the newer record — so
+ * it is dropped, never restored over it.
+ */
+export declare function draftStillApplies(savedFingerprint: string | null, currentFingerprint: string | null): boolean;
+export declare function readFingerprint(key: string | null): string | null;
+export declare function writeFingerprint(key: string | null, fingerprint: string): void;
+export declare function clearDraftAndFingerprint(key: string | null): void;

package/dist/form-draft.js

@@ -0,0 +1,73 @@
+const PREFIX = "pb:draft:";
+const DRAFT_MAX_AGE_MS = 24 * 60 * 60 * 1e3;
+function draftKey(tenantSlug, form) {
+  return tenantSlug ? `${PREFIX}${tenantSlug}:${form}` : null;
+}
+function readDraft(key, now = Date.now()) {
+  if (!key) return null;
+  try {
+    const raw = localStorage.getItem(key);
+    if (!raw) return null;
+    const stored = JSON.parse(raw);
+    if (typeof stored?.savedAt !== "number" || now - stored.savedAt > DRAFT_MAX_AGE_MS) {
+      localStorage.removeItem(key);
+      return null;
+    }
+    return stored.data;
+  } catch {
+    return null;
+  }
+}
+function writeDraft(key, data, now = Date.now()) {
+  if (!key) return;
+  try {
+    localStorage.setItem(key, JSON.stringify({ savedAt: now, data }));
+  } catch {
+  }
+}
+function clearDraft(key) {
+  if (!key) return;
+  try {
+    localStorage.removeItem(key);
+  } catch {
+  }
+}
+function draftStillApplies(savedFingerprint, currentFingerprint) {
+  return savedFingerprint !== null && currentFingerprint !== null && savedFingerprint === currentFingerprint;
+}
+const FINGERPRINT_SUFFIX = ":from";
+function readFingerprint(key) {
+  if (!key) return null;
+  try {
+    return localStorage.getItem(key + FINGERPRINT_SUFFIX);
+  } catch {
+    return null;
+  }
+}
+function writeFingerprint(key, fingerprint) {
+  if (!key) return;
+  try {
+    localStorage.setItem(key + FINGERPRINT_SUFFIX, fingerprint);
+  } catch {
+  }
+}
+function clearDraftAndFingerprint(key) {
+  clearDraft(key);
+  if (!key) return;
+  try {
+    localStorage.removeItem(key + FINGERPRINT_SUFFIX);
+  } catch {
+  }
+}
+export {
+  DRAFT_MAX_AGE_MS,
+  clearDraft,
+  clearDraftAndFingerprint,
+  draftKey,
+  draftStillApplies,
+  readDraft,
+  readFingerprint,
+  writeDraft,
+  writeFingerprint
+};
+//# sourceMappingURL=form-draft.js.map

package/dist/form-draft.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/form-draft.ts"],"sourcesContent":["/**\n * An unsaved form, kept so an interruption does not take it with it.\n *\n * A phone drops a backgrounded page from memory whenever it needs the room — a\n * call comes in, the merchant switches app — and opening it again is a fresh\n * page load. Anything typed and not yet saved is gone with it. Component state\n * cannot survive that; the browser's own storage can.\n *\n * Per workspace and per form, local to this device, and gone after a day: a\n * draft is for getting back to what you were doing, not for keeping a second\n * copy of a record. Every access is wrapped, because storage can be blocked or\n * full and a draft failing to save must never be the reason a form breaks.\n */\n\nconst PREFIX = 'pb:draft:';\nexport const DRAFT_MAX_AGE_MS = 24 * 60 * 60 * 1000;\n\ninterface StoredDraft<T> {\n  savedAt: number;\n  data: T;\n}\n\nexport function draftKey(\n  tenantSlug: string | undefined,\n  form: string,\n): string | null {\n  return tenantSlug ? `${PREFIX}${tenantSlug}:${form}` : null;\n}\n\nexport function readDraft<T>(key: string | null, now = Date.now()): T | null {\n  if (!key) return null;\n  try {\n    const raw = localStorage.getItem(key);\n    if (!raw) return null;\n    const stored = JSON.parse(raw) as StoredDraft<T>;\n    if (\n      typeof stored?.savedAt !== 'number' ||\n      now - stored.savedAt > DRAFT_MAX_AGE_MS\n    ) {\n      localStorage.removeItem(key);\n      return null;\n    }\n    return stored.data;\n  } catch {\n    return null;\n  }\n}\n\nexport function writeDraft<T>(key: string | null, data: T, now = Date.now()) {\n  if (!key) return;\n  try {\n    localStorage.setItem(key, JSON.stringify({ savedAt: now, data }));\n  } catch {\n    // Storage full or blocked: the form still works, it just is not protected.\n  }\n}\n\nexport function clearDraft(key: string | null) {\n  if (!key) return;\n  try {\n    localStorage.removeItem(key);\n  } catch {\n    // Nothing to clear if storage is not available.\n  }\n}\n\n/**\n * A draft of an EXISTING record is only good for the record it was made from.\n *\n * It is stored beside a fingerprint of how that record looked when it was\n * loaded. Someone else editing it, or saving it from another device, changes\n * the fingerprint, and the draft is then worth less than the newer record — so\n * it is dropped, never restored over it.\n */\nexport function draftStillApplies(\n  savedFingerprint: string | null,\n  currentFingerprint: string | null,\n): boolean {\n  return (\n    savedFingerprint !== null &&\n    currentFingerprint !== null &&\n    savedFingerprint === currentFingerprint\n  );\n}\n\nconst FINGERPRINT_SUFFIX = ':from';\n\nexport function readFingerprint(key: string | null): string | null {\n  if (!key) return null;\n  try {\n    return localStorage.getItem(key + FINGERPRINT_SUFFIX);\n  } catch {\n    return null;\n  }\n}\n\nexport function writeFingerprint(key: string | null, fingerprint: string) {\n  if (!key) return;\n  try {\n    localStorage.setItem(key + FINGERPRINT_SUFFIX, fingerprint);\n  } catch {\n    // Without it the draft is simply never restored: safe, not harmful.\n  }\n}\n\nexport function clearDraftAndFingerprint(key: string | null) {\n  clearDraft(key);\n  if (!key) return;\n  try {\n    localStorage.removeItem(key + FINGERPRINT_SUFFIX);\n  } catch {\n    // Nothing to clear if storage is not available.\n  }\n}\n"],"mappings":"AAcA,MAAM,SAAS;AACR,MAAM,mBAAmB,KAAK,KAAK,KAAK;AAOxC,SAAS,SACd,YACA,MACe;AACf,SAAO,aAAa,GAAG,MAAM,GAAG,UAAU,IAAI,IAAI,KAAK;AACzD;AAEO,SAAS,UAAa,KAAoB,MAAM,KAAK,IAAI,GAAa;AAC3E,MAAI,CAAC,IAAK,QAAO;AACjB,MAAI;AACF,UAAM,MAAM,aAAa,QAAQ,GAAG;AACpC,QAAI,CAAC,IAAK,QAAO;AACjB,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,QACE,OAAO,QAAQ,YAAY,YAC3B,MAAM,OAAO,UAAU,kBACvB;AACA,mBAAa,WAAW,GAAG;AAC3B,aAAO;AAAA,IACT;AACA,WAAO,OAAO;AAAA,EAChB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,WAAc,KAAoB,MAAS,MAAM,KAAK,IAAI,GAAG;AAC3E,MAAI,CAAC,IAAK;AACV,MAAI;AACF,iBAAa,QAAQ,KAAK,KAAK,UAAU,EAAE,SAAS,KAAK,KAAK,CAAC,CAAC;AAAA,EAClE,QAAQ;AAAA,EAER;AACF;AAEO,SAAS,WAAW,KAAoB;AAC7C,MAAI,CAAC,IAAK;AACV,MAAI;AACF,iBAAa,WAAW,GAAG;AAAA,EAC7B,QAAQ;AAAA,EAER;AACF;AAUO,SAAS,kBACd,kBACA,oBACS;AACT,SACE,qBAAqB,QACrB,uBAAuB,QACvB,qBAAqB;AAEzB;AAEA,MAAM,qBAAqB;AAEpB,SAAS,gBAAgB,KAAmC;AACjE,MAAI,CAAC,IAAK,QAAO;AACjB,MAAI;AACF,WAAO,aAAa,QAAQ,MAAM,kBAAkB;AAAA,EACtD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,iBAAiB,KAAoB,aAAqB;AACxE,MAAI,CAAC,IAAK;AACV,MAAI;AACF,iBAAa,QAAQ,MAAM,oBAAoB,WAAW;AAAA,EAC5D,QAAQ;AAAA,EAER;AACF;AAEO,SAAS,yBAAyB,KAAoB;AAC3D,aAAW,GAAG;AACd,MAAI,CAAC,IAAK;AACV,MAAI;AACF,iBAAa,WAAW,MAAM,kBAAkB;AAAA,EAClD,QAAQ;AAAA,EAER;AACF;","names":[]}

package/dist/format.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The number and date shapes the whole app writes, in one place.
+ *
+ * These lived in `app/dashboard/analytics/helpers.ts` — a route folder — and
+ * were reached from outside it by the traffic funnel and by every chart. A
+ * shared component importing from a route is backwards, and it is the reason
+ * `components/charts/` could not hold the charts that use them.
+ *
+ * `analytics/helpers` re-exports these, so nothing that already imports them
+ * from there has to change. New callers should come here.
+ */
+/**
+ * Compact counts: 1.2K, 3.4M. For places where the exact figure is noise and
+ * the magnitude is the point — a chart axis, a funnel step, a stat tile.
+ *
+ * Not for money. A price rendered as "₦1.2K" is a price nobody can act on;
+ * use the currency formatter for that.
+ */
+export declare function formatNumber(num: number | null | undefined): string;
+/**
+ * A percentage, rounded to whole numbers except near zero.
+ *
+ * The sub-10 case keeps one decimal because the difference between 0.4% and
+ * 0% is the difference between "a trickle" and "nothing", and rounding it
+ * away turns a small real number into an absence.
+ */
+export declare function formatPercent(value: number): string;
+/** An axis-width date: "Aug 16". */
+export declare function formatShortDate(iso: string): string;

package/dist/format.js

@@ -0,0 +1,21 @@
+function formatNumber(num) {
+  if (num == null || !Number.isFinite(num)) return "\u2014";
+  if (num >= 1e6) return `${(num / 1e6).toFixed(1)}M`;
+  if (num >= 1e3) return `${(num / 1e3).toFixed(1)}K`;
+  return num.toLocaleString();
+}
+function formatPercent(value) {
+  const abs = Math.abs(value);
+  const shown = abs < 10 && abs > 0 ? Number(value.toFixed(1)) : Math.round(value);
+  return `${shown}%`;
+}
+function formatShortDate(iso) {
+  const d = new Date(iso);
+  return d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
+}
+export {
+  formatNumber,
+  formatPercent,
+  formatShortDate
+};
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/format.ts"],"sourcesContent":["/**\n * The number and date shapes the whole app writes, in one place.\n *\n * These lived in `app/dashboard/analytics/helpers.ts` — a route folder — and\n * were reached from outside it by the traffic funnel and by every chart. A\n * shared component importing from a route is backwards, and it is the reason\n * `components/charts/` could not hold the charts that use them.\n *\n * `analytics/helpers` re-exports these, so nothing that already imports them\n * from there has to change. New callers should come here.\n */\n\n/**\n * Compact counts: 1.2K, 3.4M. For places where the exact figure is noise and\n * the magnitude is the point — a chart axis, a funnel step, a stat tile.\n *\n * Not for money. A price rendered as \"₦1.2K\" is a price nobody can act on;\n * use the currency formatter for that.\n */\nexport function formatNumber(num: number | null | undefined): string {\n  // A missing figure is an em dash, not a crash and not a zero.\n  //\n  // The parameter used to be `number`, which TypeScript was happy to satisfy\n  // from any field the API types declare as required — and a declared type is\n  // not a runtime guarantee. `RetentionRail` took down the whole Retention view\n  // this way: it guarded that `overview` existed and then read\n  // `overview.newInPriorPeriod` off it, so a 200 carrying a partial body threw\n  // `Cannot read properties of undefined (reading 'toLocaleString')` from\n  // inside a formatter three components deep.\n  //\n  // Nullish reads as \"—\" rather than \"0\" for the reason `RailStat` already\n  // states about its own value: nothing to show is not the same as none. NaN\n  // and Infinity go the same way — they are arithmetic that went wrong, and\n  // printing \"NaN\" at a merchant is worse than printing nothing.\n  if (num == null || !Number.isFinite(num)) return '—';\n  if (num >= 1_000_000) return `${(num / 1_000_000).toFixed(1)}M`;\n  if (num >= 1_000) return `${(num / 1_000).toFixed(1)}K`;\n  return num.toLocaleString();\n}\n\n/**\n * A percentage, rounded to whole numbers except near zero.\n *\n * The sub-10 case keeps one decimal because the difference between 0.4% and\n * 0% is the difference between \"a trickle\" and \"nothing\", and rounding it\n * away turns a small real number into an absence.\n */\nexport function formatPercent(value: number): string {\n  const abs = Math.abs(value);\n  const shown =\n    abs < 10 && abs > 0 ? Number(value.toFixed(1)) : Math.round(value);\n  return `${shown}%`;\n}\n\n/** An axis-width date: \"Aug 16\". */\nexport function formatShortDate(iso: string): string {\n  const d = new Date(iso);\n  return d.toLocaleDateString('en-US', { month: 'short', day: 'numeric' });\n}\n"],"mappings":"AAmBO,SAAS,aAAa,KAAwC;AAenE,MAAI,OAAO,QAAQ,CAAC,OAAO,SAAS,GAAG,EAAG,QAAO;AACjD,MAAI,OAAO,IAAW,QAAO,IAAI,MAAM,KAAW,QAAQ,CAAC,CAAC;AAC5D,MAAI,OAAO,IAAO,QAAO,IAAI,MAAM,KAAO,QAAQ,CAAC,CAAC;AACpD,SAAO,IAAI,eAAe;AAC5B;AASO,SAAS,cAAc,OAAuB;AACnD,QAAM,MAAM,KAAK,IAAI,KAAK;AAC1B,QAAM,QACJ,MAAM,MAAM,MAAM,IAAI,OAAO,MAAM,QAAQ,CAAC,CAAC,IAAI,KAAK,MAAM,KAAK;AACnE,SAAO,GAAG,KAAK;AACjB;AAGO,SAAS,gBAAgB,KAAqB;AACnD,QAAM,IAAI,IAAI,KAAK,GAAG;AACtB,SAAO,EAAE,mBAAmB,SAAS,EAAE,OAAO,SAAS,KAAK,UAAU,CAAC;AACzE;","names":[]}

package/dist/fulfilment-nav.d.ts

@@ -0,0 +1,79 @@
+/**
+ * The words for how orders reach people, in one place.
+ *
+ * THE WORD WAS FORKED. The page at `/dashboard/settings/shipping` is a
+ * component called `DeliverySettingsPage` with the title "Delivery", and every
+ * row that pointed at it said "Shipping" — the sidebar's Selling group, the
+ * spine's Operations group, the platform-module list, the mobile Store screen
+ * (which said "Shipping & delivery", both words at once), the help topic and
+ * the capability reveal. A merchant clicked Shipping and landed on Delivery.
+ *
+ * Underneath, the two are not synonyms at all: they are SIBLINGS. A zone's
+ * `method` is `delivery` (a rider of the merchant's own) or `shipping` (a
+ * courier), and an order's `deliveryMethod` is pickup / delivery / shipping /
+ * none. So "Delivery" was doing duty as both the parent — every way an order
+ * moves — and one of its children.
+ *
+ * Delivery wins as the parent. It is the word merchants here use, it covers a
+ * courier without straining, and "shipping" implies a parcel service in a
+ * market where most orders go out on a bike. The child stops using it: the
+ * two sections are "Your riders" and "Couriers". The stored values `delivery`
+ * and `shipping` are untouched — those are API contract, not copy — and so are
+ * the `shippable` / `hideShipping` behavior flags, which no merchant reads.
+ *
+ * Six files spelled this destination's label by hand, so renaming it meant
+ * finding all six. They import from here now, and
+ * `fulfilment-nav.test.ts` fails the build when a seventh types it out.
+ *
+ * The `href` on each row is deliberately still written out at the call site.
+ * The route never drifted — all six agreed on it — and the sibling contract
+ * guards read nav sources as TEXT: `tab-title-coverage` learns which routes
+ * have a nav row by matching `href: '…'`, so folding the literal into a
+ * constant made three settings screens report themselves nameless. The href
+ * here is for the places that link without declaring a row.
+ */
+/** Where orders go and what it costs. Zones, rates, collection. */
+export declare const DELIVERY_NAV: {
+    readonly href: "/dashboard/business/shipping";
+    readonly label: "Delivery";
+};
+/**
+ * The places the business operates FROM. Origins, counters, staff.
+ *
+ * "Business locations", not "Locations". The bare word is the most overloaded
+ * noun in this settings tree — a service area is a location row, a shipping
+ * zone names locations, a booking resource has one — so a merchant reading
+ * "Locations" in the rail had no way to know which of those it opened. The
+ * qualifier says whose: the branches the business itself operates from.
+ */
+export declare const LOCATIONS_NAV: {
+    readonly href: "/dashboard/operations/locations";
+    readonly label: "Business locations";
+};
+/**
+ * RETIRED. A zone is the delivery footprint now.
+ *
+ * This named a list of country/state/city rows (`location_catalog`) that
+ * carried geography and nothing else — a copy of the delivery zones a merchant
+ * had already drawn, kept in step by hand, and free to disagree with them: the
+ * checkout dropdown came from one and the price from the other.
+ *
+ * The zone is the one that does work. `public/locations/hierarchy` already
+ * derived the dropdown from zones whenever this list was empty (which most
+ * tenants' was), and `get-fulfilment-options` already refuses a delivery it
+ * cannot match to a zone, offering collection instead. So this row asked
+ * merchants to state their footprint a second time for nothing.
+ *
+ * Left as a comment rather than deleted silently, because the word will come
+ * back otherwise: whatever names a delivery footprint next, it is a zone.
+ */
+/**
+ * The two methods, as a merchant reads them.
+ *
+ * Keyed on the stored value so a section heading and a zone's badge cannot
+ * disagree about what `method: 'shipping'` is called.
+ */
+export declare const DELIVERY_METHOD_LABELS: {
+    readonly delivery: "Your riders";
+    readonly shipping: "Couriers";
+};

package/dist/fulfilment-nav.js

@@ -0,0 +1,18 @@
+const DELIVERY_NAV = {
+  href: "/dashboard/business/shipping",
+  label: "Delivery"
+};
+const LOCATIONS_NAV = {
+  href: "/dashboard/operations/locations",
+  label: "Business locations"
+};
+const DELIVERY_METHOD_LABELS = {
+  delivery: "Your riders",
+  shipping: "Couriers"
+};
+export {
+  DELIVERY_METHOD_LABELS,
+  DELIVERY_NAV,
+  LOCATIONS_NAV
+};
+//# sourceMappingURL=fulfilment-nav.js.map