@withpotter/lib 0.13.0-next.101

package/dist/intents/resolve-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/resolve-stats.ts"],"sourcesContent":["import type { StatDef } from './types';\nimport type { StatCardProps } from '../stat-card-types';\nimport { resolveIcon } from './icon-map';\n\n/**\n * Maps intent-config StatDef[] + raw API stats data → StatCardProps[]\n * ready for the existing <StatsGrid> component.\n */\nexport function resolveStatDefs(\n  defs: StatDef[],\n  data: Record<string, unknown>,\n  formatCurrency?: (amount: number) => string,\n): StatCardProps[] {\n  return defs.map((def) => {\n    const raw = data[def.dataKey];\n    const numValue = typeof raw === 'number' ? raw : 0;\n\n    let value: string | number;\n    switch (def.format) {\n      case 'currency':\n        value = formatCurrency\n          ? formatCurrency(numValue)\n          : `$${numValue.toLocaleString()}`;\n        break;\n      case 'percentage':\n        value = `${numValue}%`;\n        break;\n      case 'number':\n      default:\n        value = numValue.toLocaleString();\n        break;\n    }\n\n    return {\n      label: def.label,\n      value,\n      icon: resolveIcon(def.icon),\n    };\n  });\n}\n"],"mappings":"AAEA,SAAS,mBAAmB;AAMrB,SAAS,gBACd,MACA,MACA,gBACiB;AACjB,SAAO,KAAK,IAAI,CAAC,QAAQ;AACvB,UAAM,MAAM,KAAK,IAAI,OAAO;AAC5B,UAAM,WAAW,OAAO,QAAQ,WAAW,MAAM;AAEjD,QAAI;AACJ,YAAQ,IAAI,QAAQ;AAAA,MAClB,KAAK;AACH,gBAAQ,iBACJ,eAAe,QAAQ,IACvB,IAAI,SAAS,eAAe,CAAC;AACjC;AAAA,MACF,KAAK;AACH,gBAAQ,GAAG,QAAQ;AACnB;AAAA,MACF,KAAK;AAAA,MACL;AACE,gBAAQ,SAAS,eAAe;AAChC;AAAA,IACJ;AAEA,WAAO;AAAA,MACL,OAAO,IAAI;AAAA,MACX;AAAA,MACA,MAAM,YAAY,IAAI,IAAI;AAAA,IAC5B;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/intents/resolve-tenant-intents.d.ts

@@ -0,0 +1,11 @@
+import type { IntentConfig } from './types';
+/**
+ * Resolve the active intent configs for a tenant.
+ *
+ * Priority:
+ *   1. operatingModel.profiles intentKeys, in profile order
+ *   2. selectedIntents (backward compatibility when no operating model exists)
+ *   3. inferred intents from enabledBehaviors (backward compatibility)
+ *   4. defaultCommerceConfig
+ */
+export declare function resolveTenantIntentConfigs(tenantSettings?: Record<string, unknown>, templateCategory?: string): IntentConfig[];

package/dist/intents/resolve-tenant-intents.js

@@ -0,0 +1,61 @@
+import { defaultCommerceConfig, intentRegistry } from "./registry";
+import { inferIntentsFromBehaviors } from "./infer-intents";
+function resolveConfigsFromIntentKeys(intentKeys) {
+  const configs = [];
+  for (const key of intentKeys) {
+    const config = intentRegistry[key];
+    if (config) {
+      configs.push(config);
+    }
+  }
+  return configs;
+}
+function collectOperatingModelIntentKeys(operatingModel) {
+  if (!Array.isArray(operatingModel?.profiles)) {
+    return [];
+  }
+  const keys = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const profile of operatingModel.profiles) {
+    if (profile.enabled === false || !Array.isArray(profile.intentKeys)) {
+      continue;
+    }
+    for (const intentKey of profile.intentKeys) {
+      if (!intentRegistry[intentKey] || seen.has(intentKey)) {
+        continue;
+      }
+      seen.add(intentKey);
+      keys.push(intentKey);
+    }
+  }
+  return keys;
+}
+function resolveTenantIntentConfigs(tenantSettings, templateCategory) {
+  if (templateCategory === "ecommerce") {
+    return [defaultCommerceConfig];
+  }
+  const selectedIntents = tenantSettings?.selectedIntents;
+  const enabledBehaviors = tenantSettings?.enabledBehaviors;
+  const operatingModel = tenantSettings?.operatingModel;
+  const modelKeys = collectOperatingModelIntentKeys(operatingModel);
+  const chosen = Array.isArray(selectedIntents) ? selectedIntents : [];
+  const intentKeys = modelKeys.length > 0 ? [...modelKeys, ...chosen.filter((key) => !modelKeys.includes(key))] : modelKeys;
+  if (intentKeys.length > 0) {
+    const configs = resolveConfigsFromIntentKeys(intentKeys);
+    return configs.length > 0 ? configs : [defaultCommerceConfig];
+  }
+  if (Array.isArray(selectedIntents) && selectedIntents.length > 0) {
+    const configs = resolveConfigsFromIntentKeys(selectedIntents);
+    return configs.length > 0 ? configs : [defaultCommerceConfig];
+  }
+  if (enabledBehaviors?.length) {
+    const inferred = inferIntentsFromBehaviors(enabledBehaviors);
+    const configs = resolveConfigsFromIntentKeys(inferred);
+    return configs.length > 0 ? configs : [defaultCommerceConfig];
+  }
+  return [defaultCommerceConfig];
+}
+export {
+  resolveTenantIntentConfigs
+};
+//# sourceMappingURL=resolve-tenant-intents.js.map

package/dist/intents/resolve-tenant-intents.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/resolve-tenant-intents.ts"],"sourcesContent":["import { defaultCommerceConfig, intentRegistry } from './registry';\nimport { inferIntentsFromBehaviors } from './infer-intents';\nimport type { IntentConfig } from './types';\n\ninterface PersistedOperatingModelProfile {\n  enabled?: boolean;\n  intentKeys?: string[];\n}\n\ninterface PersistedOperatingModelSettings {\n  profiles?: PersistedOperatingModelProfile[];\n}\n\nfunction resolveConfigsFromIntentKeys(intentKeys: string[]): IntentConfig[] {\n  const configs: IntentConfig[] = [];\n\n  for (const key of intentKeys) {\n    const config = intentRegistry[key];\n    if (config) {\n      configs.push(config);\n    }\n  }\n\n  return configs;\n}\n\nfunction collectOperatingModelIntentKeys(\n  operatingModel: PersistedOperatingModelSettings | undefined,\n): string[] {\n  if (!Array.isArray(operatingModel?.profiles)) {\n    return [];\n  }\n\n  const keys: string[] = [];\n  const seen = new Set<string>();\n\n  for (const profile of operatingModel.profiles) {\n    if (profile.enabled === false || !Array.isArray(profile.intentKeys)) {\n      continue;\n    }\n\n    for (const intentKey of profile.intentKeys) {\n      if (!intentRegistry[intentKey] || seen.has(intentKey)) {\n        continue;\n      }\n\n      seen.add(intentKey);\n      keys.push(intentKey);\n    }\n  }\n\n  return keys;\n}\n\n/**\n * Resolve the active intent configs for a tenant.\n *\n * Priority:\n *   1. operatingModel.profiles intentKeys, in profile order\n *   2. selectedIntents (backward compatibility when no operating model exists)\n *   3. inferred intents from enabledBehaviors (backward compatibility)\n *   4. defaultCommerceConfig\n */\nexport function resolveTenantIntentConfigs(\n  tenantSettings?: Record<string, unknown>,\n  templateCategory?: string,\n): IntentConfig[] {\n  if (templateCategory === 'ecommerce') {\n    return [defaultCommerceConfig];\n  }\n\n  const selectedIntents = tenantSettings?.selectedIntents as\n    | string[]\n    | undefined;\n  const enabledBehaviors = tenantSettings?.enabledBehaviors as\n    | string[]\n    | undefined;\n  const operatingModel = tenantSettings?.operatingModel as\n    | PersistedOperatingModelSettings\n    | undefined;\n\n  const modelKeys = collectOperatingModelIntentKeys(operatingModel);\n  // The operating model is written by the engine, and an engine older than this\n  // dashboard writes no profile for a model it does not know. The merchant's\n  // own choice still stands, so a chosen model the profiles leave out is added.\n  const chosen = Array.isArray(selectedIntents) ? selectedIntents : [];\n  const intentKeys =\n    modelKeys.length > 0\n      ? [...modelKeys, ...chosen.filter((key) => !modelKeys.includes(key))]\n      : modelKeys;\n\n  if (intentKeys.length > 0) {\n    const configs = resolveConfigsFromIntentKeys(intentKeys);\n    return configs.length > 0 ? configs : [defaultCommerceConfig];\n  }\n\n  // An empty selection is \"unset\", not \"no business model\" — same rule as\n  // resolveEnabledBehaviors, so the nav and the behaviors can't disagree.\n  if (Array.isArray(selectedIntents) && selectedIntents.length > 0) {\n    const configs = resolveConfigsFromIntentKeys(selectedIntents);\n    return configs.length > 0 ? configs : [defaultCommerceConfig];\n  }\n\n  if (enabledBehaviors?.length) {\n    const inferred = inferIntentsFromBehaviors(enabledBehaviors);\n    const configs = resolveConfigsFromIntentKeys(inferred);\n    return configs.length > 0 ? configs : [defaultCommerceConfig];\n  }\n\n  return [defaultCommerceConfig];\n}\n"],"mappings":"AAAA,SAAS,uBAAuB,sBAAsB;AACtD,SAAS,iCAAiC;AAY1C,SAAS,6BAA6B,YAAsC;AAC1E,QAAM,UAA0B,CAAC;AAEjC,aAAW,OAAO,YAAY;AAC5B,UAAM,SAAS,eAAe,GAAG;AACjC,QAAI,QAAQ;AACV,cAAQ,KAAK,MAAM;AAAA,IACrB;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,gCACP,gBACU;AACV,MAAI,CAAC,MAAM,QAAQ,gBAAgB,QAAQ,GAAG;AAC5C,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,OAAiB,CAAC;AACxB,QAAM,OAAO,oBAAI,IAAY;AAE7B,aAAW,WAAW,eAAe,UAAU;AAC7C,QAAI,QAAQ,YAAY,SAAS,CAAC,MAAM,QAAQ,QAAQ,UAAU,GAAG;AACnE;AAAA,IACF;AAEA,eAAW,aAAa,QAAQ,YAAY;AAC1C,UAAI,CAAC,eAAe,SAAS,KAAK,KAAK,IAAI,SAAS,GAAG;AACrD;AAAA,MACF;AAEA,WAAK,IAAI,SAAS;AAClB,WAAK,KAAK,SAAS;AAAA,IACrB;AAAA,EACF;AAEA,SAAO;AACT;AAWO,SAAS,2BACd,gBACA,kBACgB;AAChB,MAAI,qBAAqB,aAAa;AACpC,WAAO,CAAC,qBAAqB;AAAA,EAC/B;AAEA,QAAM,kBAAkB,gBAAgB;AAGxC,QAAM,mBAAmB,gBAAgB;AAGzC,QAAM,iBAAiB,gBAAgB;AAIvC,QAAM,YAAY,gCAAgC,cAAc;AAIhE,QAAM,SAAS,MAAM,QAAQ,eAAe,IAAI,kBAAkB,CAAC;AACnE,QAAM,aACJ,UAAU,SAAS,IACf,CAAC,GAAG,WAAW,GAAG,OAAO,OAAO,CAAC,QAAQ,CAAC,UAAU,SAAS,GAAG,CAAC,CAAC,IAClE;AAEN,MAAI,WAAW,SAAS,GAAG;AACzB,UAAM,UAAU,6BAA6B,UAAU;AACvD,WAAO,QAAQ,SAAS,IAAI,UAAU,CAAC,qBAAqB;AAAA,EAC9D;AAIA,MAAI,MAAM,QAAQ,eAAe,KAAK,gBAAgB,SAAS,GAAG;AAChE,UAAM,UAAU,6BAA6B,eAAe;AAC5D,WAAO,QAAQ,SAAS,IAAI,UAAU,CAAC,qBAAqB;AAAA,EAC9D;AAEA,MAAI,kBAAkB,QAAQ;AAC5B,UAAM,WAAW,0BAA0B,gBAAgB;AAC3D,UAAM,UAAU,6BAA6B,QAAQ;AACrD,WAAO,QAAQ,SAAS,IAAI,UAAU,CAAC,qBAAqB;AAAA,EAC9D;AAEA,SAAO,CAAC,qBAAqB;AAC/B;","names":[]}

package/dist/intents/resolvers.d.ts

@@ -0,0 +1,52 @@
+import type { LucideIcon } from 'lucide-react';
+import type { InventoryProduct } from '@withpotter/lib/api/types';
+import type { ColumnDef, StatDef, ActionDef } from './types';
+export type ListingContextType = 'retail' | 'services' | 'properties' | 'menu';
+export declare function getStockStatus(p: InventoryProduct): 'inStock' | 'lowStock' | 'outOfStock';
+export declare const stockStatusConfig: Record<string, {
+    label: string;
+    className: string;
+    dot: string;
+    icon: React.ElementType;
+}>;
+export type ListingColumnId = 'checkbox' | 'product' | 'sku' | 'price' | 'quantity' | 'reserved' | 'available' | 'lowThreshold' | 'status' | 'duration';
+export interface ListingColumn {
+    id: ListingColumnId;
+    header: string;
+    align: 'left' | 'center' | 'right';
+    sortable?: boolean;
+    sortField?: 'title' | 'quantity' | 'price';
+    editable?: boolean;
+    editField?: 'quantity' | 'lowStockThreshold';
+}
+/**
+ * Resolve declarative ColumnDef[] from intent config → full ListingColumn[]
+ * with rendering metadata from the column registry.
+ * Always prepends checkbox column.
+ */
+export declare function resolveColumns(defs: ColumnDef[]): ListingColumn[];
+export interface ListingStat {
+    key: string;
+    label: string;
+    icon: React.ElementType;
+    getValue: (products: InventoryProduct[], currencySymbol: string) => string | number;
+}
+/**
+ * Resolve declarative StatDef[] from intent config → ListingStat[]
+ * with computation functions from the stat registry.
+ */
+export declare function resolveItemStats(defs: StatDef[]): ListingStat[];
+export interface QuickAction {
+    label: string;
+    href: string;
+    icon: LucideIcon;
+}
+export declare function resolveQuickActions(defs: ActionDef[]): QuickAction[];
+/**
+ * Derive CSV headers from resolved columns (excluding checkbox).
+ */
+export declare function deriveCsvHeaders(columns: ListingColumn[]): string[];
+/**
+ * Standard CSV row generator based on column IDs.
+ */
+export declare function deriveCsvRow(columns: ListingColumn[], product: InventoryProduct): string[];

package/dist/intents/resolvers.js

@@ -0,0 +1,177 @@
+import {
+  Package,
+  CheckCircle,
+  AlertTriangle,
+  XCircle,
+  BarChart3,
+  Coins,
+  FileText
+} from "lucide-react";
+import { INTENT_ICON_MAP, resolveIcon } from "./icon-map";
+function getStockStatus(p) {
+  if (!p.trackInventory) return "inStock";
+  const available = p.quantity - (p.reserved || 0);
+  if (available <= 0) return "outOfStock";
+  if (available <= (p.lowStockThreshold || 5)) return "lowStock";
+  return "inStock";
+}
+const stockStatusConfig = {
+  inStock: {
+    label: "In stock",
+    className: "bg-[var(--success-bg)] text-[var(--success)]",
+    /** The same state as a single swatch, for surfaces that render a dot
+        rather than a filled pill — see the catalogue table. */
+    dot: "var(--success)",
+    icon: CheckCircle
+  },
+  lowStock: {
+    label: "Low stock",
+    className: "bg-[var(--warning-bg)] text-[var(--warning)]",
+    dot: "var(--warning)",
+    icon: AlertTriangle
+  },
+  outOfStock: {
+    label: "Out of stock",
+    className: "bg-[var(--error-bg)] text-[var(--error)]",
+    dot: "var(--error)",
+    icon: XCircle
+  }
+};
+const COLUMN_REGISTRY = {
+  checkbox: { id: "checkbox", align: "left" },
+  product: {
+    id: "product",
+    align: "left",
+    sortable: true,
+    sortField: "title"
+  },
+  sku: { id: "sku", align: "left" },
+  price: {
+    id: "price",
+    align: "right",
+    sortable: true,
+    sortField: "price"
+  },
+  quantity: {
+    id: "quantity",
+    align: "right",
+    sortable: true,
+    sortField: "quantity",
+    editable: true,
+    editField: "quantity"
+  },
+  reserved: { id: "reserved", align: "right" },
+  available: { id: "available", align: "right" },
+  lowThreshold: {
+    id: "lowThreshold",
+    align: "right",
+    editable: true,
+    editField: "lowStockThreshold"
+  },
+  /* Left, like every other non-numeric column and like the orders queue.
+     A centred column in a table whose text columns all start at the same left
+     edge puts one ragged edge in the middle of the row, and the pill is
+     content rather than a measurement — only numbers earn the right edge. */
+  status: { id: "status", align: "left" },
+  duration: { id: "duration", align: "left" }
+};
+function resolveColumns(defs) {
+  const cols = [{ ...COLUMN_REGISTRY.checkbox, header: "" }];
+  for (const def of defs) {
+    const reg = COLUMN_REGISTRY[def.key];
+    if (reg) {
+      cols.push({ ...reg, header: def.label });
+    }
+  }
+  return cols;
+}
+const STAT_ICON_MAP = {
+  Package,
+  CheckCircle,
+  AlertTriangle,
+  XCircle,
+  BarChart3,
+  Coins,
+  FileText
+};
+function resolveStatIcon(iconName) {
+  return INTENT_ICON_MAP[iconName] ?? STAT_ICON_MAP[iconName] ?? Package;
+}
+const ITEM_STAT_COMPUTATIONS = {
+  total: (p) => p.length,
+  tracked: (p) => p.filter((x) => x.trackInventory).length,
+  inStock: (p) => p.filter((x) => getStockStatus(x) === "inStock").length,
+  lowStock: (p) => p.filter((x) => getStockStatus(x) === "lowStock").length,
+  outOfStock: (p) => p.filter((x) => getStockStatus(x) === "outOfStock").length,
+  active: (p) => p.filter((x) => x.isActive !== false).length,
+  draft: (p) => p.filter((x) => x.isActive === false).length,
+  totalValue: (p, cs) => {
+    const total = p.reduce((sum, x) => sum + (Number(x.price) || 0), 0);
+    return `${cs} ${total.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+  },
+  avgPrice: (p, cs) => {
+    if (p.length === 0) return `${cs} 0.00`;
+    const avg = p.reduce((sum, x) => sum + (Number(x.price) || 0), 0) / p.length;
+    return `${cs} ${avg.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+  }
+};
+function resolveItemStats(defs) {
+  return defs.map((def) => {
+    const compute = ITEM_STAT_COMPUTATIONS[def.dataKey];
+    if (!compute) return null;
+    return {
+      key: def.key,
+      label: def.label,
+      icon: resolveStatIcon(def.icon),
+      getValue: compute
+    };
+  }).filter(Boolean);
+}
+function resolveQuickActions(defs) {
+  return defs.filter((a) => a.href).map((a) => ({
+    label: a.label,
+    href: a.href,
+    icon: resolveIcon(a.icon)
+  }));
+}
+function deriveCsvHeaders(columns) {
+  return columns.filter((c) => c.id !== "checkbox").map((c) => c.header);
+}
+function deriveCsvRow(columns, product) {
+  return columns.filter((c) => c.id !== "checkbox").map((col) => {
+    switch (col.id) {
+      case "product":
+        return product.title;
+      case "sku":
+        return product.sku || "";
+      case "price":
+        return product.price?.toString() || "0";
+      case "quantity":
+        return product.quantity?.toString() || "0";
+      case "reserved":
+        return (product.reserved || 0).toString();
+      case "available":
+        return ((product.quantity || 0) - (product.reserved || 0)).toString();
+      case "lowThreshold":
+        return (product.lowStockThreshold || 5).toString();
+      case "status":
+        return getStockStatus(product);
+      case "duration": {
+        const behaviors = product.behaviors;
+        return behaviors?.bookable?.durationMinutes?.toString() || "";
+      }
+      default:
+        return "";
+    }
+  });
+}
+export {
+  deriveCsvHeaders,
+  deriveCsvRow,
+  getStockStatus,
+  resolveColumns,
+  resolveItemStats,
+  resolveQuickActions,
+  stockStatusConfig
+};
+//# sourceMappingURL=resolvers.js.map

package/dist/intents/resolvers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/resolvers.ts"],"sourcesContent":["// ─── Intent-Driven Page Composition: Resolvers ───\n//\n// Bridges declarative IntentConfig definitions → renderable props.\n// Intent configs say *what* to show (keys + labels).\n// Registries know *how* to render (alignment, sorting, cell format).\n// Resolvers combine both into props that components consume directly.\n\nimport type { LucideIcon } from 'lucide-react';\nimport {\n  Package,\n  CheckCircle,\n  AlertTriangle,\n  XCircle,\n  BarChart3,\n  Coins,\n  FileText,\n} from 'lucide-react';\nimport type { InventoryProduct } from '@withpotter/lib/api/types';\nimport type { ColumnDef, StatDef, ActionDef } from './types';\nimport { INTENT_ICON_MAP, resolveIcon } from './icon-map';\n\n// ============================================================================\n// SHARED HELPERS (migrated from listing-config.ts)\n// ============================================================================\n\nexport type ListingContextType = 'retail' | 'services' | 'properties' | 'menu';\n\nexport function getStockStatus(\n  p: InventoryProduct,\n): 'inStock' | 'lowStock' | 'outOfStock' {\n  if (!p.trackInventory) return 'inStock';\n  const available = p.quantity - (p.reserved || 0);\n  if (available <= 0) return 'outOfStock';\n  if (available <= (p.lowStockThreshold || 5)) return 'lowStock';\n  return 'inStock';\n}\n\nexport const stockStatusConfig: Record<\n  string,\n  { label: string; className: string; dot: string; icon: React.ElementType }\n> = {\n  inStock: {\n    label: 'In stock',\n    className: 'bg-[var(--success-bg)] text-[var(--success)]',\n    /** The same state as a single swatch, for surfaces that render a dot\n        rather than a filled pill — see the catalogue table. */\n    dot: 'var(--success)',\n    icon: CheckCircle,\n  },\n  lowStock: {\n    label: 'Low stock',\n    className: 'bg-[var(--warning-bg)] text-[var(--warning)]',\n    dot: 'var(--warning)',\n    icon: AlertTriangle,\n  },\n  outOfStock: {\n    label: 'Out of stock',\n    className: 'bg-[var(--error-bg)] text-[var(--error)]',\n    dot: 'var(--error)',\n    icon: XCircle,\n  },\n};\n\n// ============================================================================\n// COLUMN REGISTRY\n// ============================================================================\n\nexport type ListingColumnId =\n  | 'checkbox'\n  | 'product'\n  | 'sku'\n  | 'price'\n  | 'quantity'\n  | 'reserved'\n  | 'available'\n  | 'lowThreshold'\n  | 'status'\n  | 'duration';\n\nexport interface ListingColumn {\n  id: ListingColumnId;\n  header: string;\n  align: 'left' | 'center' | 'right';\n  sortable?: boolean;\n  sortField?: 'title' | 'quantity' | 'price';\n  editable?: boolean;\n  editField?: 'quantity' | 'lowStockThreshold';\n}\n\nconst COLUMN_REGISTRY: Record<string, Omit<ListingColumn, 'header'>> = {\n  checkbox: { id: 'checkbox', align: 'left' },\n  product: {\n    id: 'product',\n    align: 'left',\n    sortable: true,\n    sortField: 'title',\n  },\n  sku: { id: 'sku', align: 'left' },\n  price: {\n    id: 'price',\n    align: 'right',\n    sortable: true,\n    sortField: 'price',\n  },\n  quantity: {\n    id: 'quantity',\n    align: 'right',\n    sortable: true,\n    sortField: 'quantity',\n    editable: true,\n    editField: 'quantity',\n  },\n  reserved: { id: 'reserved', align: 'right' },\n  available: { id: 'available', align: 'right' },\n  lowThreshold: {\n    id: 'lowThreshold',\n    align: 'right',\n    editable: true,\n    editField: 'lowStockThreshold',\n  },\n  /* Left, like every other non-numeric column and like the orders queue.\n     A centred column in a table whose text columns all start at the same left\n     edge puts one ragged edge in the middle of the row, and the pill is\n     content rather than a measurement — only numbers earn the right edge. */\n  status: { id: 'status', align: 'left' },\n  duration: { id: 'duration', align: 'left' },\n};\n\n/**\n * Resolve declarative ColumnDef[] from intent config → full ListingColumn[]\n * with rendering metadata from the column registry.\n * Always prepends checkbox column.\n */\nexport function resolveColumns(defs: ColumnDef[]): ListingColumn[] {\n  const cols: ListingColumn[] = [{ ...COLUMN_REGISTRY.checkbox, header: '' }];\n  for (const def of defs) {\n    const reg = COLUMN_REGISTRY[def.key];\n    if (reg) {\n      cols.push({ ...reg, header: def.label });\n    }\n  }\n  return cols;\n}\n\n// ============================================================================\n// ITEM STAT REGISTRY (client-computed from product array)\n// ============================================================================\n\n/** Icon map for stat keys that use icons not in INTENT_ICON_MAP */\nconst STAT_ICON_MAP: Record<string, React.ElementType> = {\n  Package,\n  CheckCircle,\n  AlertTriangle,\n  XCircle,\n  BarChart3,\n  Coins,\n  FileText,\n};\n\nfunction resolveStatIcon(iconName: string): React.ElementType {\n  return INTENT_ICON_MAP[iconName] ?? STAT_ICON_MAP[iconName] ?? Package;\n}\n\nexport interface ListingStat {\n  key: string;\n  label: string;\n  icon: React.ElementType;\n  getValue: (\n    products: InventoryProduct[],\n    currencySymbol: string,\n  ) => string | number;\n}\n\nconst ITEM_STAT_COMPUTATIONS: Record<\n  string,\n  (products: InventoryProduct[], currencySymbol: string) => string | number\n> = {\n  total: (p) => p.length,\n  tracked: (p) => p.filter((x) => x.trackInventory).length,\n  inStock: (p) => p.filter((x) => getStockStatus(x) === 'inStock').length,\n  lowStock: (p) => p.filter((x) => getStockStatus(x) === 'lowStock').length,\n  outOfStock: (p) => p.filter((x) => getStockStatus(x) === 'outOfStock').length,\n  active: (p) => p.filter((x) => x.isActive !== false).length,\n  draft: (p) => p.filter((x) => x.isActive === false).length,\n  totalValue: (p, cs) => {\n    const total = p.reduce((sum, x) => sum + (Number(x.price) || 0), 0);\n    return `${cs} ${total.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;\n  },\n  avgPrice: (p, cs) => {\n    if (p.length === 0) return `${cs} 0.00`;\n    const avg =\n      p.reduce((sum, x) => sum + (Number(x.price) || 0), 0) / p.length;\n    return `${cs} ${avg.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;\n  },\n};\n\n/**\n * Resolve declarative StatDef[] from intent config → ListingStat[]\n * with computation functions from the stat registry.\n */\nexport function resolveItemStats(defs: StatDef[]): ListingStat[] {\n  return defs\n    .map((def) => {\n      const compute = ITEM_STAT_COMPUTATIONS[def.dataKey];\n      if (!compute) return null;\n      return {\n        key: def.key,\n        label: def.label,\n        icon: resolveStatIcon(def.icon),\n        getValue: compute,\n      };\n    })\n    .filter(Boolean) as ListingStat[];\n}\n\n// ============================================================================\n// QUICK ACTION RESOLVER\n// ============================================================================\n\nexport interface QuickAction {\n  label: string;\n  href: string;\n  icon: LucideIcon;\n}\n\nexport function resolveQuickActions(defs: ActionDef[]): QuickAction[] {\n  return defs\n    .filter((a) => a.href)\n    .map((a) => ({\n      label: a.label,\n      href: a.href!,\n      icon: resolveIcon(a.icon),\n    }));\n}\n\n// ============================================================================\n// CSV EXPORT HELPERS\n// ============================================================================\n\n/**\n * Derive CSV headers from resolved columns (excluding checkbox).\n */\nexport function deriveCsvHeaders(columns: ListingColumn[]): string[] {\n  return columns.filter((c) => c.id !== 'checkbox').map((c) => c.header);\n}\n\n/**\n * Standard CSV row generator based on column IDs.\n */\nexport function deriveCsvRow(\n  columns: ListingColumn[],\n  product: InventoryProduct,\n): string[] {\n  return columns\n    .filter((c) => c.id !== 'checkbox')\n    .map((col) => {\n      switch (col.id) {\n        case 'product':\n          return product.title;\n        case 'sku':\n          return product.sku || '';\n        case 'price':\n          return product.price?.toString() || '0';\n        case 'quantity':\n          return product.quantity?.toString() || '0';\n        case 'reserved':\n          return (product.reserved || 0).toString();\n        case 'available':\n          return ((product.quantity || 0) - (product.reserved || 0)).toString();\n        case 'lowThreshold':\n          return (product.lowStockThreshold || 5).toString();\n        case 'status':\n          return getStockStatus(product);\n        case 'duration': {\n          const behaviors = product.behaviors as\n            | Record<string, { durationMinutes?: number } | undefined>\n            | undefined;\n          return behaviors?.bookable?.durationMinutes?.toString() || '';\n        }\n        default:\n          return '';\n      }\n    });\n}\n"],"mappings":"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","names":[]}

package/dist/intents/row-identity.d.ts

@@ -0,0 +1,62 @@
+import type { IntentConfig } from './types';
+/**
+ * What one ROW is, asked of the row.
+ *
+ * Every archetype defect in the multi-archetype audit was the same question
+ * asked of the wrong thing: *what archetype is this SCREEN about?* — which has
+ * no answer for a business running four, and `primary` returned one anyway.
+ * The single resolver that never had a bug found against it is
+ * `resolveOrderSections`, and it is the only one that asks something else: it
+ * reads the record's own behaviours.
+ *
+ * This is that question, one screen over. A catalogue holding a membership, a
+ * personal-training session and a lifting belt has no true word — the sweep
+ * measured the noun falling through to "Items" in 13 of the 16 businesses this
+ * system exists for. But the shelf was never one thing, and each row has always
+ * known what it is: `InventoryProduct.behaviors` ships on every row already.
+ *
+ * So the heading stays neutral, because it genuinely covers all of them, and
+ * the rows carry the meaning. Nothing is guessed and nothing is averaged.
+ *
+ * Returns null where a row identifies as nothing in particular — an item with
+ * no behaviours, or one whose archetype this business does not run. A row that
+ * cannot say what it is says nothing, rather than borrowing a neighbour's word.
+ */
+export declare function resolveRowNoun(behaviors: Record<string, boolean> | undefined, configs: IntentConfig[], renamed?: boolean): string | null;
+/**
+ * The core the three adapters share.
+ *
+ * A catalogue row keeps its behaviours as an object, an order line as an array,
+ * and a commitment as an array the API now sends. Three shapes, one question,
+ * so one place answers it.
+ */
+export declare function resolveBehaviourNoun(present: string[], configs: IntentConfig[], 
+/**
+ * True when the merchant has renamed this slot in Settings.
+ *
+ * They typed ONE word for the shelf — "Properties" — and per-row archetype
+ * words contradict it: the row would say Product under a heading the
+ * merchant wrote themselves. A rename is the strongest statement anyone
+ * makes about a noun, so it wins by silencing this rather than by being
+ * repeated on every row, which would erase the distinction the row exists to
+ * draw.
+ */
+renamed?: boolean): string | null;
+/**
+ * The same question, of an order.
+ *
+ * `Commitment` — the Sales register's row — carries eleven flat fields and no
+ * behaviours, so the cross-rail list cannot answer this without the API sending
+ * more. An ORDER can: every line carries `behaviors`, which is what
+ * `resolveOrderSections` has always read to decide the detail screen's shape.
+ *
+ * A mixed order resolves to nothing on purpose. One that holds a membership and
+ * a lifting belt is genuinely both, and the row has one line to say it in;
+ * `resolveOrderSections` unions the SECTIONS for exactly that case because a
+ * detail screen has room to show both, and a table cell does not.
+ */
+export declare function resolveOrderRowNoun(order: {
+    items?: {
+        behaviors?: string[];
+    }[] | null;
+}, configs: IntentConfig[], renamed?: boolean): string | null;

package/dist/intents/row-identity.js

@@ -0,0 +1,25 @@
+import { configsForBehaviors, orderBehaviors } from "./order-sections";
+function resolveRowNoun(behaviors, configs, renamed = false) {
+  if (!behaviors) return null;
+  return resolveBehaviourNoun(
+    Object.entries(behaviors).filter(([, on]) => on).map(([name]) => name),
+    configs,
+    renamed
+  );
+}
+function resolveBehaviourNoun(present, configs, renamed = false) {
+  if (!present.length) return null;
+  if (configs.length < 2 || renamed) return null;
+  const matched = configsForBehaviors(configs, present);
+  if (matched.length !== 1) return null;
+  return matched[0].entities.item.singular;
+}
+function resolveOrderRowNoun(order, configs, renamed = false) {
+  return resolveBehaviourNoun([...orderBehaviors(order)], configs, renamed);
+}
+export {
+  resolveBehaviourNoun,
+  resolveOrderRowNoun,
+  resolveRowNoun
+};
+//# sourceMappingURL=row-identity.js.map

package/dist/intents/row-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/row-identity.ts"],"sourcesContent":["import type { IntentConfig } from './types';\nimport { configsForBehaviors, orderBehaviors } from './order-sections';\n\n/**\n * What one ROW is, asked of the row.\n *\n * Every archetype defect in the multi-archetype audit was the same question\n * asked of the wrong thing: *what archetype is this SCREEN about?* — which has\n * no answer for a business running four, and `primary` returned one anyway.\n * The single resolver that never had a bug found against it is\n * `resolveOrderSections`, and it is the only one that asks something else: it\n * reads the record's own behaviours.\n *\n * This is that question, one screen over. A catalogue holding a membership, a\n * personal-training session and a lifting belt has no true word — the sweep\n * measured the noun falling through to \"Items\" in 13 of the 16 businesses this\n * system exists for. But the shelf was never one thing, and each row has always\n * known what it is: `InventoryProduct.behaviors` ships on every row already.\n *\n * So the heading stays neutral, because it genuinely covers all of them, and\n * the rows carry the meaning. Nothing is guessed and nothing is averaged.\n *\n * Returns null where a row identifies as nothing in particular — an item with\n * no behaviours, or one whose archetype this business does not run. A row that\n * cannot say what it is says nothing, rather than borrowing a neighbour's word.\n */\nexport function resolveRowNoun(\n  behaviors: Record<string, boolean> | undefined,\n  configs: IntentConfig[],\n  renamed = false,\n): string | null {\n  if (!behaviors) return null;\n  return resolveBehaviourNoun(\n    Object.entries(behaviors)\n      .filter(([, on]) => on)\n      .map(([name]) => name),\n    configs,\n    renamed,\n  );\n}\n\n/**\n * The core the three adapters share.\n *\n * A catalogue row keeps its behaviours as an object, an order line as an array,\n * and a commitment as an array the API now sends. Three shapes, one question,\n * so one place answers it.\n */\nexport function resolveBehaviourNoun(\n  present: string[],\n  configs: IntentConfig[],\n  /**\n   * True when the merchant has renamed this slot in Settings.\n   *\n   * They typed ONE word for the shelf — \"Properties\" — and per-row archetype\n   * words contradict it: the row would say Product under a heading the\n   * merchant wrote themselves. A rename is the strongest statement anyone\n   * makes about a noun, so it wins by silencing this rather than by being\n   * repeated on every row, which would erase the distinction the row exists to\n   * draw.\n   */\n  renamed = false,\n): string | null {\n  if (!present.length) return null;\n\n  /*\n   * A noun that repeats the heading is noise.\n   *\n   * One archetype means the shelf already says what everything on it is —\n   * \"Inventory\" over rows each reading Product. The row noun exists to\n   * separate things a heading CANNOT name, so with nothing to separate it\n   * says nothing. That is the same reason the heading itself falls through to\n   * the neutral word when archetypes disagree: each says the part it can.\n   */\n  if (configs.length < 2 || renamed) return null;\n\n  const matched = configsForBehaviors(configs, present);\n\n  /*\n   * Exactly one, or nothing.\n   *\n   * A row can satisfy two archetypes — `dine-in` and `food-orders` are both\n   * identified by `sellable`, so no line can tell a plate from a takeaway bag.\n   * Naming it either would be the same invention this replaces, one level\n   * down, so an ambiguous row stays quiet. The place to fix that is the data:\n   * until an order line records which it is, no resolver can know.\n   */\n  if (matched.length !== 1) return null;\n\n  return matched[0].entities.item.singular;\n}\n\n/**\n * The same question, of an order.\n *\n * `Commitment` — the Sales register's row — carries eleven flat fields and no\n * behaviours, so the cross-rail list cannot answer this without the API sending\n * more. An ORDER can: every line carries `behaviors`, which is what\n * `resolveOrderSections` has always read to decide the detail screen's shape.\n *\n * A mixed order resolves to nothing on purpose. One that holds a membership and\n * a lifting belt is genuinely both, and the row has one line to say it in;\n * `resolveOrderSections` unions the SECTIONS for exactly that case because a\n * detail screen has room to show both, and a table cell does not.\n */\nexport function resolveOrderRowNoun(\n  order: { items?: { behaviors?: string[] }[] | null },\n  configs: IntentConfig[],\n  renamed = false,\n): string | null {\n  return resolveBehaviourNoun([...orderBehaviors(order)], configs, renamed);\n}\n"],"mappings":"AACA,SAAS,qBAAqB,sBAAsB;AAyB7C,SAAS,eACd,WACA,SACA,UAAU,OACK;AACf,MAAI,CAAC,UAAW,QAAO;AACvB,SAAO;AAAA,IACL,OAAO,QAAQ,SAAS,EACrB,OAAO,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EACrB,IAAI,CAAC,CAAC,IAAI,MAAM,IAAI;AAAA,IACvB;AAAA,IACA;AAAA,EACF;AACF;AASO,SAAS,qBACd,SACA,SAWA,UAAU,OACK;AACf,MAAI,CAAC,QAAQ,OAAQ,QAAO;AAW5B,MAAI,QAAQ,SAAS,KAAK,QAAS,QAAO;AAE1C,QAAM,UAAU,oBAAoB,SAAS,OAAO;AAWpD,MAAI,QAAQ,WAAW,EAAG,QAAO;AAEjC,SAAO,QAAQ,CAAC,EAAE,SAAS,KAAK;AAClC;AAeO,SAAS,oBACd,OACA,SACA,UAAU,OACK;AACf,SAAO,qBAAqB,CAAC,GAAG,eAAe,KAAK,CAAC,GAAG,SAAS,OAAO;AAC1E;","names":[]}

package/dist/intents/sales-verb.d.ts

@@ -0,0 +1,8 @@
+import type { IntentConfig } from './types';
+export interface SalesVerb {
+    /** Column header: "Sold" / "Booked". */
+    noun: string;
+    /** Past participle used in a phrase: "Never sold" / "Booked 3d ago". */
+    past: string;
+}
+export declare function resolveSalesVerb(configs: IntentConfig[]): SalesVerb;

package/dist/intents/sales-verb.js

@@ -0,0 +1,12 @@
+const BOOKED = /* @__PURE__ */ new Set(["rent-property", "take-bookings"]);
+const SOLD = { noun: "Sold", past: "Sold" };
+const BOOKED_VERB = { noun: "Booked", past: "Booked" };
+function resolveSalesVerb(configs) {
+  const keys = configs.map((c) => c.key);
+  const booked = keys.filter((k) => BOOKED.has(k)).length;
+  return booked > 0 && booked === keys.length ? BOOKED_VERB : SOLD;
+}
+export {
+  resolveSalesVerb
+};
+//# sourceMappingURL=sales-verb.js.map

package/dist/intents/sales-verb.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/sales-verb.ts"],"sourcesContent":["import type { IntentConfig } from './types';\n\n/**\n * The word for \"this has been paid for\", in the merchant's trade.\n *\n * The catalogue hardcoded **Sold**: a \"Sold\" column, and a signal reading\n * \"Never sold\", \"Sold today\", \"Sold 3d ago\". On a beach house that is not\n * shorthand, it is the wrong verb — a property is booked, a consultation is\n * booked, and neither is ever sold. CLAUDE.md has one rule about this and it is\n * \"never hardcode a merchant-facing noun\".\n *\n * Only the archetypes whose thing is genuinely not sold override it. A menu\n * item, a ticket, a download and a product are all sold, and inventing a\n * distinction for them would be the mistake this walkthrough keeps finding in\n * the other direction.\n */\nconst BOOKED = new Set(['rent-property', 'take-bookings']);\n\nexport interface SalesVerb {\n  /** Column header: \"Sold\" / \"Booked\". */\n  noun: string;\n  /** Past participle used in a phrase: \"Never sold\" / \"Booked 3d ago\". */\n  past: string;\n}\n\nconst SOLD: SalesVerb = { noun: 'Sold', past: 'Sold' };\nconst BOOKED_VERB: SalesVerb = { noun: 'Booked', past: 'Booked' };\n\nexport function resolveSalesVerb(configs: IntentConfig[]): SalesVerb {\n  const keys = configs.map((c) => c.key);\n  const booked = keys.filter((k) => BOOKED.has(k)).length;\n\n  // A business that only ever books says Booked. One that does both sells\n  // some of what is on this shelf, and Sold is the word that covers a mixed\n  // list — the same reason a shared row is called Catalog rather than Menu.\n  return booked > 0 && booked === keys.length ? BOOKED_VERB : SOLD;\n}\n"],"mappings":"AAgBA,MAAM,SAAS,oBAAI,IAAI,CAAC,iBAAiB,eAAe,CAAC;AASzD,MAAM,OAAkB,EAAE,MAAM,QAAQ,MAAM,OAAO;AACrD,MAAM,cAAyB,EAAE,MAAM,UAAU,MAAM,SAAS;AAEzD,SAAS,iBAAiB,SAAoC;AACnE,QAAM,OAAO,QAAQ,IAAI,CAAC,MAAM,EAAE,GAAG;AACrC,QAAM,SAAS,KAAK,OAAO,CAAC,MAAM,OAAO,IAAI,CAAC,CAAC,EAAE;AAKjD,SAAO,SAAS,KAAK,WAAW,KAAK,SAAS,cAAc;AAC9D;","names":[]}

package/dist/intents/scoped-config.d.ts

@@ -0,0 +1,12 @@
+import type { IntentConfig, ResolvedIntentConfig } from './types';
+/**
+ * The resolved config for a screen scoped to one intent.
+ *
+ * Takes the tenant's own copy of the config when it runs the intent, which
+ * carries their operating-shell overrides, and falls back to the registry's
+ * when it does not — a route can be opened by URL on a business that never
+ * selected the intent, and a blank screen there is worse than the intent's own
+ * default wording. Unknown keys answer undefined so the caller can fall
+ * through to the ordinary resolution.
+ */
+export declare function resolveScopedConfig(tenantConfigs: readonly IntentConfig[], scopeKey: string, registryConfig: IntentConfig | undefined): ResolvedIntentConfig | undefined;

package/dist/intents/scoped-config.js

@@ -0,0 +1,17 @@
+function resolveScopedConfig(tenantConfigs, scopeKey, registryConfig) {
+  const only = tenantConfigs.find((config) => config.key === scopeKey) ?? registryConfig;
+  if (!only) return void 0;
+  return {
+    mode: "single",
+    primary: only,
+    all: [only],
+    activeKeys: [only.key],
+    active: [only],
+    hasArchetype: true,
+    isAllIntents: false
+  };
+}
+export {
+  resolveScopedConfig
+};
+//# sourceMappingURL=scoped-config.js.map

package/dist/intents/scoped-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/scoped-config.ts"],"sourcesContent":["import type { IntentConfig, ResolvedIntentConfig } from './types';\n\n/**\n * The resolved config for a screen scoped to one intent.\n *\n * Takes the tenant's own copy of the config when it runs the intent, which\n * carries their operating-shell overrides, and falls back to the registry's\n * when it does not — a route can be opened by URL on a business that never\n * selected the intent, and a blank screen there is worse than the intent's own\n * default wording. Unknown keys answer undefined so the caller can fall\n * through to the ordinary resolution.\n */\nexport function resolveScopedConfig(\n  tenantConfigs: readonly IntentConfig[],\n  scopeKey: string,\n  registryConfig: IntentConfig | undefined,\n): ResolvedIntentConfig | undefined {\n  const only =\n    tenantConfigs.find((config) => config.key === scopeKey) ?? registryConfig;\n  if (!only) return undefined;\n\n  return {\n    mode: 'single',\n    primary: only,\n    all: [only],\n    activeKeys: [only.key],\n    active: [only],\n    hasArchetype: true,\n    isAllIntents: false,\n  };\n}\n"],"mappings":"AAYO,SAAS,oBACd,eACA,UACA,gBACkC;AAClC,QAAM,OACJ,cAAc,KAAK,CAAC,WAAW,OAAO,QAAQ,QAAQ,KAAK;AAC7D,MAAI,CAAC,KAAM,QAAO;AAElB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT,KAAK,CAAC,IAAI;AAAA,IACV,YAAY,CAAC,KAAK,GAAG;AAAA,IACrB,QAAQ,CAAC,IAAI;AAAA,IACb,cAAc;AAAA,IACd,cAAc;AAAA,EAChB;AACF;","names":[]}

package/dist/intents/screen-title.d.ts

@@ -0,0 +1,27 @@
+import type { IntentConfig } from './types';
+/**
+ * What the screen at this route is called.
+ *
+ * A page must not name itself. The sidebar row and the page heading were two
+ * independent strings in two different files, and nothing failed when they
+ * disagreed — so a restaurant clicked **Tables** and got "Staff", a short-let
+ * clicked **Availability** and got "Calendar Sync", a membership business
+ * clicked **Plans** and got "Subscriptions". Each was found by a person using
+ * the product, one at a time, and each was fixed as a copy problem.
+ *
+ * The fix that scales is to remove the second string. This resolves a route to
+ * the label the nav is showing for it, from the same `decideSharedNav` pass the
+ * sidebar runs, so the two cannot drift: there is only one value.
+ *
+ * Pure, and takes everything it needs, so `screen-title.test.ts` can assert it
+ * for every archetype and every row without rendering anything.
+ */
+export declare function resolveScreenTitle({ configs, mode, pathname, search, moduleLabels, }: {
+    configs: IntentConfig[];
+    mode: 'single' | 'multi';
+    /** May carry its own query string, which is honoured. */
+    pathname: string;
+    /** The live query string, when the caller has it separately. */
+    search?: string;
+    moduleLabels?: Record<string, string>;
+}): string | undefined;

package/dist/intents/screen-title.js

@@ -0,0 +1,59 @@
+import { INTENT_NAV_DEFINITIONS } from "./intent-nav";
+import { decideSharedNav, navDecisionKey } from "./collapse-shared-nav";
+import { moduleLabelFor } from "./use-entity-label";
+function resolveScreenTitle({
+  configs,
+  mode,
+  pathname,
+  search,
+  moduleLabels
+}) {
+  const active = new Set(configs.map((c) => c.key));
+  const definitions = INTENT_NAV_DEFINITIONS.filter((d) => active.has(d.key));
+  const decisions = decideSharedNav(
+    definitions,
+    mode === "multi" && definitions.length > 1 ? "multi" : "single"
+  );
+  const [rawPath, inlineQuery] = pathname.split("?");
+  const path = rawPath.replace(/\/$/, "");
+  const query = new URLSearchParams(search ?? inlineQuery ?? "");
+  const scoped = (query.get("intent") ?? "").split(",").map((key) => key.trim()).filter(Boolean);
+  let best;
+  for (const definition of definitions) {
+    const config = configs.find((c) => c.key === definition.key);
+    if (!config) continue;
+    const declared = new Map(
+      config.navigation.groups.flatMap((g) => g.items).map((i) => [i.id, i.href.replace(/\/$/, "")])
+    );
+    const rows = definition.items.flatMap((item) => [
+      item,
+      ...item.children ?? []
+    ]);
+    for (const item of rows) {
+      const declaredHref = declared.get(item.id);
+      if (!declaredHref) continue;
+      const [target, targetQuery] = declaredHref.split("?");
+      if (path !== target && !path.startsWith(target + "/")) continue;
+      const wanted = new URLSearchParams(targetQuery ?? "");
+      let matched = 0;
+      let contradicted = false;
+      for (const [key, value] of wanted) {
+        if (query.get(key) === value) matched += 1;
+        else contradicted = true;
+      }
+      if (contradicted) continue;
+      const decision = decisions.get(navDecisionKey(definition.key, item.id));
+      const navLabel = decision?.emit ? decision.label : item.label;
+      const label = moduleLabelFor(moduleLabels, item.id, target) ?? navLabel;
+      const owned = scoped.length === 1 && scoped[0] === definition.key;
+      const better = !best || target.length > best.length || target.length === best.length && (owned !== best.owned ? owned : matched > best.query);
+      if (better)
+        best = { label, length: target.length, query: matched, owned };
+    }
+  }
+  return best?.label;
+}
+export {
+  resolveScreenTitle
+};
+//# sourceMappingURL=screen-title.js.map

package/dist/intents/screen-title.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/screen-title.ts"],"sourcesContent":["import type { IntentConfig } from './types';\nimport { INTENT_NAV_DEFINITIONS } from './intent-nav';\nimport { decideSharedNav, navDecisionKey } from './collapse-shared-nav';\nimport { moduleLabelFor } from './use-entity-label';\n\n/**\n * What the screen at this route is called.\n *\n * A page must not name itself. The sidebar row and the page heading were two\n * independent strings in two different files, and nothing failed when they\n * disagreed — so a restaurant clicked **Tables** and got \"Staff\", a short-let\n * clicked **Availability** and got \"Calendar Sync\", a membership business\n * clicked **Plans** and got \"Subscriptions\". Each was found by a person using\n * the product, one at a time, and each was fixed as a copy problem.\n *\n * The fix that scales is to remove the second string. This resolves a route to\n * the label the nav is showing for it, from the same `decideSharedNav` pass the\n * sidebar runs, so the two cannot drift: there is only one value.\n *\n * Pure, and takes everything it needs, so `screen-title.test.ts` can assert it\n * for every archetype and every row without rendering anything.\n */\nexport function resolveScreenTitle({\n  configs,\n  mode,\n  pathname,\n  search,\n  moduleLabels,\n}: {\n  configs: IntentConfig[];\n  mode: 'single' | 'multi';\n  /** May carry its own query string, which is honoured. */\n  pathname: string;\n  /** The live query string, when the caller has it separately. */\n  search?: string;\n  moduleLabels?: Record<string, string>;\n}): string | undefined {\n  const active = new Set(configs.map((c) => c.key));\n  const definitions = INTENT_NAV_DEFINITIONS.filter((d) => active.has(d.key));\n  const decisions = decideSharedNav(\n    definitions,\n    mode === 'multi' && definitions.length > 1 ? 'multi' : 'single',\n  );\n\n  const [rawPath, inlineQuery] = pathname.split('?');\n  const path = rawPath.replace(/\\/$/, '');\n  const query = new URLSearchParams(search ?? inlineQuery ?? '');\n\n  /**\n   * Two rows can open the same path and differ only by query.\n   *\n   * A membership business has **Plans** at `/dashboard/subscriptions` and\n   * **Subscribers** at `/dashboard/subscriptions?tab=subscribers`; a restaurant\n   * has **Reservations** at `/dashboard/bookings?intent=dine-in` beside a\n   * collapsed **Bookings** at the same path. Matching on pathname alone\n   * answered with whichever was declared first — which is the drift this\n   * function exists to remove, one level down.\n   *\n   * So: the deepest path wins, and among equal paths the row whose query the\n   * URL actually carries wins. `/dashboard/bookings/attendees` is Attendees\n   * rather than the Bookings row above it, for the same reason.\n   */\n  /**\n   * `?intent=` says whose row this was.\n   *\n   * A hotel with a dining room has two rows on `/dashboard/bookings`: the\n   * stays, collapsed to **Bookings**, and dine-in's **Reservations**. Neither\n   * declares a query of its own, so the path alone cannot tell them apart and\n   * the answer fell to whichever archetype is declared first. The sidebar\n   * already scopes each row — that is what the param is for.\n   */\n  const scoped = (query.get('intent') ?? '')\n    .split(',')\n    .map((key) => key.trim())\n    .filter(Boolean);\n\n  let best:\n    | { label: string; length: number; query: number; owned: boolean }\n    | undefined;\n\n  for (const definition of definitions) {\n    const config = configs.find((c) => c.key === definition.key);\n    if (!config) continue;\n\n    const declared = new Map(\n      config.navigation.groups\n        .flatMap((g) => g.items)\n        .map((i) => [i.id, i.href.replace(/\\/$/, '')] as const),\n    );\n\n    const rows = definition.items.flatMap((item) => [\n      item,\n      ...(item.children ?? []),\n    ]);\n\n    for (const item of rows) {\n      const declaredHref = declared.get(item.id);\n      if (!declaredHref) continue;\n      const [target, targetQuery] = declaredHref.split('?');\n      if (path !== target && !path.startsWith(target + '/')) continue;\n\n      // A row that names a query only answers for a URL carrying it.\n      const wanted = new URLSearchParams(targetQuery ?? '');\n      let matched = 0;\n      let contradicted = false;\n      for (const [key, value] of wanted) {\n        if (query.get(key) === value) matched += 1;\n        else contradicted = true;\n      }\n      if (contradicted) continue;\n\n      const decision = decisions.get(navDecisionKey(definition.key, item.id));\n      // A child row is not part of the collapse pass, so it keeps its own word.\n      const navLabel = decision?.emit ? decision.label : item.label;\n      // The merchant's own rename outranks every archetype's word, and it is\n      // stored against the destination rather than the row.\n      const label = moduleLabelFor(moduleLabels, item.id, target) ?? navLabel;\n\n      // Exactly this archetype's row, not one of several the param names.\n      const owned = scoped.length === 1 && scoped[0] === definition.key;\n\n      const better =\n        !best ||\n        target.length > best.length ||\n        (target.length === best.length &&\n          (owned !== best.owned ? owned : matched > best.query));\n\n      if (better)\n        best = { label, length: target.length, query: matched, owned };\n    }\n  }\n\n  return best?.label;\n}\n"],"mappings":"AACA,SAAS,8BAA8B;AACvC,SAAS,iBAAiB,sBAAsB;AAChD,SAAS,sBAAsB;AAmBxB,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAQuB;AACrB,QAAM,SAAS,IAAI,IAAI,QAAQ,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;AAChD,QAAM,cAAc,uBAAuB,OAAO,CAAC,MAAM,OAAO,IAAI,EAAE,GAAG,CAAC;AAC1E,QAAM,YAAY;AAAA,IAChB;AAAA,IACA,SAAS,WAAW,YAAY,SAAS,IAAI,UAAU;AAAA,EACzD;AAEA,QAAM,CAAC,SAAS,WAAW,IAAI,SAAS,MAAM,GAAG;AACjD,QAAM,OAAO,QAAQ,QAAQ,OAAO,EAAE;AACtC,QAAM,QAAQ,IAAI,gBAAgB,UAAU,eAAe,EAAE;AAyB7D,QAAM,UAAU,MAAM,IAAI,QAAQ,KAAK,IACpC,MAAM,GAAG,EACT,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,EACvB,OAAO,OAAO;AAEjB,MAAI;AAIJ,aAAW,cAAc,aAAa;AACpC,UAAM,SAAS,QAAQ,KAAK,CAAC,MAAM,EAAE,QAAQ,WAAW,GAAG;AAC3D,QAAI,CAAC,OAAQ;AAEb,UAAM,WAAW,IAAI;AAAA,MACnB,OAAO,WAAW,OACf,QAAQ,CAAC,MAAM,EAAE,KAAK,EACtB,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,QAAQ,OAAO,EAAE,CAAC,CAAU;AAAA,IAC1D;AAEA,UAAM,OAAO,WAAW,MAAM,QAAQ,CAAC,SAAS;AAAA,MAC9C;AAAA,MACA,GAAI,KAAK,YAAY,CAAC;AAAA,IACxB,CAAC;AAED,eAAW,QAAQ,MAAM;AACvB,YAAM,eAAe,SAAS,IAAI,KAAK,EAAE;AACzC,UAAI,CAAC,aAAc;AACnB,YAAM,CAAC,QAAQ,WAAW,IAAI,aAAa,MAAM,GAAG;AACpD,UAAI,SAAS,UAAU,CAAC,KAAK,WAAW,SAAS,GAAG,EAAG;AAGvD,YAAM,SAAS,IAAI,gBAAgB,eAAe,EAAE;AACpD,UAAI,UAAU;AACd,UAAI,eAAe;AACnB,iBAAW,CAAC,KAAK,KAAK,KAAK,QAAQ;AACjC,YAAI,MAAM,IAAI,GAAG,MAAM,MAAO,YAAW;AAAA,YACpC,gBAAe;AAAA,MACtB;AACA,UAAI,aAAc;AAElB,YAAM,WAAW,UAAU,IAAI,eAAe,WAAW,KAAK,KAAK,EAAE,CAAC;AAEtE,YAAM,WAAW,UAAU,OAAO,SAAS,QAAQ,KAAK;AAGxD,YAAM,QAAQ,eAAe,cAAc,KAAK,IAAI,MAAM,KAAK;AAG/D,YAAM,QAAQ,OAAO,WAAW,KAAK,OAAO,CAAC,MAAM,WAAW;AAE9D,YAAM,SACJ,CAAC,QACD,OAAO,SAAS,KAAK,UACpB,OAAO,WAAW,KAAK,WACrB,UAAU,KAAK,QAAQ,QAAQ,UAAU,KAAK;AAEnD,UAAI;AACF,eAAO,EAAE,OAAO,QAAQ,OAAO,QAAQ,OAAO,SAAS,MAAM;AAAA,IACjE;AAAA,EACF;AAEA,SAAO,MAAM;AACf;","names":[]}