@withpotter/lib 0.13.0-next.101

package/dist/intents/nav-coverage.d.ts

@@ -0,0 +1,71 @@
+/**
+ * What each archetype's sidebar actually calls each destination.
+ *
+ * The whole registry, not one tenant's slice: drift is a property of the
+ * definitions, and narrowing it would mean an archetype only reported itself
+ * broken once someone happened to switch it on.
+ *
+ * Children count as rendered. They are rows the merchant can reach, just one
+ * disclosure down — without this a surface moved from a top-level row into a
+ * sub-nav would report itself unreachable.
+ */
+export declare function renderedNavLabels(): Record<string, Record<string, string>>;
+/**
+ * Config nav items that no sidebar group renders.
+ *
+ * The sidebar builds its intent groups from a hardcoded list, taking the href
+ * from the config and the label from itself. So adding an item to a config does
+ * nothing until sidebar.tsx also changes — which is how /dashboard/waitlist
+ * ended up a finished screen that four configs pointed at and nothing linked
+ * to, for as long as it took someone to go looking.
+ *
+ * Pass the ids the sidebar actually renders; anything declared but unrendered
+ * and not spine-owned comes back.
+ */
+export declare function findUnreachableNavItems(renderedLabelsByIntent: Record<string, Record<string, string>>): {
+    intent: string;
+    itemId: string;
+    href: string;
+}[];
+/**
+ * Items whose config label disagrees with the label the sidebar renders.
+ *
+ * Both are read: the sidebar shows its own word, and /dashboard/operations
+ * builds its hub tiles straight from the config. So a mismatch means the same
+ * destination is called two different things on two screens — Scheduling in the
+ * sidebar, Calendar Sync on the hub. The sidebar is the authority; the config
+ * should echo it.
+ */
+export declare function findLabelMismatches(renderedLabelsByIntent: Record<string, Record<string, string>>): {
+    intent: string;
+    itemId: string;
+    config: string;
+    sidebar: string;
+}[];
+/**
+ * Dev-only. Shouts once if a config declares a destination the merchant has no
+ * way to reach, so the next unreachable screen is caught the day it's written
+ * rather than during an audit.
+ */
+export declare function warnOnUnreachableNavItems(renderedLabelsByIntent: Record<string, Record<string, string>>): void;
+/**
+ * Sidebar rows no intent config can back.
+ *
+ * The mirror of `findUnreachableNavItems`, and the half nothing checked. The
+ * sidebar takes each row's LABEL from `INTENT_NAV_DEFINITIONS` and its HREF
+ * from the config, so a row named in the definitions and absent from the config
+ * has nowhere to point: `buildIntentItem` returns null and the row disappears
+ * without a word.
+ *
+ * `event-tickets` named a **Check-ins** row under Attendees. The config had
+ * dropped it on purpose — it was Attendees minus the list, plus a scan log that
+ * rendered empty every load — and the definitions never got the memo. Twelve
+ * ticketing businesses carried a row in the definitions that none of them could
+ * see, and both existing checks passed the whole time: one asks whether every
+ * config item is rendered, and this asks the other direction.
+ */
+export declare function findUnbackedNavRows(): {
+    intent: string;
+    itemId: string;
+    label: string;
+}[];

package/dist/intents/nav-coverage.js

@@ -0,0 +1,132 @@
+import { intentRegistry, defaultCommerceConfig } from "./registry";
+import { INTENT_NAV_DEFINITIONS } from "./intent-nav";
+function renderedNavLabels() {
+  return Object.fromEntries(
+    INTENT_NAV_DEFINITIONS.map((d) => [
+      d.key,
+      Object.fromEntries(
+        d.items.flatMap((i) => [
+          [i.id, i.label],
+          ...(i.children ?? []).map((c) => [c.id, c.label])
+        ])
+      )
+    ])
+  );
+}
+const SPINE_OWNED_IDS = /* @__PURE__ */ new Set([
+  "collections",
+  // No 'discounts'. It is not a row anywhere any more — it is a tab on the
+  // Marketing hub — so a config declaring one again is real drift and should
+  // come back from here rather than be waved through.
+  "blog",
+  "loyalty",
+  "invoices",
+  "shipping",
+  "subscriptions",
+  // The subscriber list is a cut of the customer directory, so the Customers
+  // hub renders it and the archetype no longer does. `subscriptions.config`
+  // still declares it, and should: /dashboard/operations builds its tiles from
+  // the configs, and a membership business wants that tile.
+  "subscribers",
+  // The Inbox is a top-level row under Home (`sidebar/inbox-row.ts`), and
+  // `capture-leads` declares an Enquiries row to the same page. The sidebar sets
+  // the archetype's row aside, so it is spine-owned like the rows above.
+  "inquiries",
+  "locations",
+  "hours",
+  // reachable from Settings, gated on `bookable`
+  // A tab of the same Settings → Operations page that `hours` and `locations`
+  // are tabs of. Three configs declare it and no sidebar group renders it,
+  // which is correct — and which this list exists to say out loud, so the dev
+  // warning stops reporting a settled decision as drift.
+  "service-areas",
+  // Reached from the two screens that need it rather than a row of its own:
+  // the day board carries who is waiting for today next to the slots that come
+  // free, and Bookings links across to the full list. Four archetypes each had
+  // a Waitlist row and none of them linked to it from anywhere.
+  "waitlist"
+]);
+function findUnreachableNavItems(renderedLabelsByIntent) {
+  const configs = { ...intentRegistry, default: defaultCommerceConfig };
+  const orphans = [];
+  for (const [key, config] of Object.entries(configs)) {
+    const rendered = renderedLabelsByIntent[key] ?? {};
+    for (const group of config.navigation.groups) {
+      for (const item of group.items) {
+        if (item.id in rendered || SPINE_OWNED_IDS.has(item.id)) continue;
+        orphans.push({ intent: key, itemId: item.id, href: item.href });
+      }
+    }
+  }
+  return orphans;
+}
+function findLabelMismatches(renderedLabelsByIntent) {
+  const configs = { ...intentRegistry, default: defaultCommerceConfig };
+  const mismatches = [];
+  for (const [key, config] of Object.entries(configs)) {
+    const rendered = renderedLabelsByIntent[key] ?? {};
+    for (const group of config.navigation.groups) {
+      for (const item of group.items) {
+        const sidebarLabel = rendered[item.id];
+        if (!sidebarLabel || sidebarLabel === item.label) continue;
+        mismatches.push({
+          intent: key,
+          itemId: item.id,
+          config: item.label,
+          sidebar: sidebarLabel
+        });
+      }
+    }
+  }
+  return mismatches;
+}
+function warnOnUnreachableNavItems(renderedLabelsByIntent) {
+  if (process.env.NODE_ENV === "production") return;
+  const orphans = findUnreachableNavItems(renderedLabelsByIntent);
+  if (orphans.length > 0) {
+    console.warn(
+      "[intents] These nav items are declared in an intent config but rendered by no sidebar group, so nothing links to them. Add the id to intentDefinitions in sidebar.tsx, or drop it from the config:\n" + orphans.map((o) => `  ${o.intent} \u2192 ${o.itemId} (${o.href})`).join("\n")
+    );
+  }
+  const mismatches = findLabelMismatches(renderedLabelsByIntent);
+  if (mismatches.length > 0) {
+    console.warn(
+      "[intents] These nav items are called one thing in the sidebar and another on /dashboard/operations, which builds its tiles from the config. Update the config to match the sidebar:\n" + mismatches.map(
+        (m) => `  ${m.intent} \u2192 ${m.itemId}: config "${m.config}" vs sidebar "${m.sidebar}"`
+      ).join("\n")
+    );
+  }
+}
+function findUnbackedNavRows() {
+  const configs = {
+    ...intentRegistry,
+    default: defaultCommerceConfig
+  };
+  const unbacked = [];
+  for (const definition of INTENT_NAV_DEFINITIONS) {
+    const config = configs[definition.key];
+    if (!config) continue;
+    const declared = new Set(
+      config.navigation.groups.flatMap((g) => g.items.map((i) => i.id))
+    );
+    for (const item of definition.items) {
+      for (const row of [item, ...item.children ?? []]) {
+        if (declared.has(row.id) || SPINE_OWNED_IDS.has(row.id)) continue;
+        unbacked.push({
+          intent: definition.key,
+          itemId: row.id,
+          label: row.label
+        });
+      }
+    }
+  }
+  return unbacked;
+}
+export {
+  findLabelMismatches,
+  findUnbackedNavRows,
+  findUnreachableNavItems,
+  renderedNavLabels,
+  warnOnUnreachableNavItems
+};
+//# sourceMappingURL=nav-coverage.js.map

package/dist/intents/nav-coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/nav-coverage.ts"],"sourcesContent":["import { intentRegistry, defaultCommerceConfig } from './registry';\nimport type { IntentConfig } from './types';\nimport { INTENT_NAV_DEFINITIONS } from './intent-nav';\n\n/**\n * What each archetype's sidebar actually calls each destination.\n *\n * The whole registry, not one tenant's slice: drift is a property of the\n * definitions, and narrowing it would mean an archetype only reported itself\n * broken once someone happened to switch it on.\n *\n * Children count as rendered. They are rows the merchant can reach, just one\n * disclosure down — without this a surface moved from a top-level row into a\n * sub-nav would report itself unreachable.\n */\nexport function renderedNavLabels(): Record<string, Record<string, string>> {\n  return Object.fromEntries(\n    INTENT_NAV_DEFINITIONS.map((d) => [\n      d.key,\n      Object.fromEntries(\n        d.items.flatMap((i) => [\n          [i.id, i.label] as const,\n          ...(i.children ?? []).map((c) => [c.id, c.label] as const),\n        ]),\n      ),\n    ]),\n  );\n}\n\n/**\n * Nav items the fixed spine renders on every intent (Marketing, Payments,\n * Website, Catalog tools). An intent config may declare these; the sidebar's\n * intent groups deliberately don't render them, and that's not a mistake.\n */\nconst SPINE_OWNED_IDS = new Set([\n  'collections',\n  // No 'discounts'. It is not a row anywhere any more — it is a tab on the\n  // Marketing hub — so a config declaring one again is real drift and should\n  // come back from here rather than be waved through.\n  'blog',\n  'loyalty',\n  'invoices',\n  'shipping',\n  'subscriptions',\n  // The subscriber list is a cut of the customer directory, so the Customers\n  // hub renders it and the archetype no longer does. `subscriptions.config`\n  // still declares it, and should: /dashboard/operations builds its tiles from\n  // the configs, and a membership business wants that tile.\n  'subscribers',\n  // The Inbox is a top-level row under Home (`sidebar/inbox-row.ts`), and\n  // `capture-leads` declares an Enquiries row to the same page. The sidebar sets\n  // the archetype's row aside, so it is spine-owned like the rows above.\n  'inquiries',\n  'locations',\n  'hours', // reachable from Settings, gated on `bookable`\n  // A tab of the same Settings → Operations page that `hours` and `locations`\n  // are tabs of. Three configs declare it and no sidebar group renders it,\n  // which is correct — and which this list exists to say out loud, so the dev\n  // warning stops reporting a settled decision as drift.\n  'service-areas',\n  // Reached from the two screens that need it rather than a row of its own:\n  // the day board carries who is waiting for today next to the slots that come\n  // free, and Bookings links across to the full list. Four archetypes each had\n  // a Waitlist row and none of them linked to it from anywhere.\n  'waitlist',\n]);\n\n/**\n * Config nav items that no sidebar group renders.\n *\n * The sidebar builds its intent groups from a hardcoded list, taking the href\n * from the config and the label from itself. So adding an item to a config does\n * nothing until sidebar.tsx also changes — which is how /dashboard/waitlist\n * ended up a finished screen that four configs pointed at and nothing linked\n * to, for as long as it took someone to go looking.\n *\n * Pass the ids the sidebar actually renders; anything declared but unrendered\n * and not spine-owned comes back.\n */\nexport function findUnreachableNavItems(\n  renderedLabelsByIntent: Record<string, Record<string, string>>,\n): { intent: string; itemId: string; href: string }[] {\n  const configs = { ...intentRegistry, default: defaultCommerceConfig };\n  const orphans: { intent: string; itemId: string; href: string }[] = [];\n\n  for (const [key, config] of Object.entries(configs)) {\n    const rendered = renderedLabelsByIntent[key] ?? {};\n\n    for (const group of config.navigation.groups) {\n      for (const item of group.items) {\n        if (item.id in rendered || SPINE_OWNED_IDS.has(item.id)) continue;\n        orphans.push({ intent: key, itemId: item.id, href: item.href });\n      }\n    }\n  }\n\n  return orphans;\n}\n\n/**\n * Items whose config label disagrees with the label the sidebar renders.\n *\n * Both are read: the sidebar shows its own word, and /dashboard/operations\n * builds its hub tiles straight from the config. So a mismatch means the same\n * destination is called two different things on two screens — Scheduling in the\n * sidebar, Calendar Sync on the hub. The sidebar is the authority; the config\n * should echo it.\n */\nexport function findLabelMismatches(\n  renderedLabelsByIntent: Record<string, Record<string, string>>,\n): { intent: string; itemId: string; config: string; sidebar: string }[] {\n  const configs = { ...intentRegistry, default: defaultCommerceConfig };\n  const mismatches: {\n    intent: string;\n    itemId: string;\n    config: string;\n    sidebar: string;\n  }[] = [];\n\n  for (const [key, config] of Object.entries(configs)) {\n    const rendered = renderedLabelsByIntent[key] ?? {};\n\n    for (const group of config.navigation.groups) {\n      for (const item of group.items) {\n        const sidebarLabel = rendered[item.id];\n        if (!sidebarLabel || sidebarLabel === item.label) continue;\n        mismatches.push({\n          intent: key,\n          itemId: item.id,\n          config: item.label,\n          sidebar: sidebarLabel,\n        });\n      }\n    }\n  }\n\n  return mismatches;\n}\n\n/**\n * Dev-only. Shouts once if a config declares a destination the merchant has no\n * way to reach, so the next unreachable screen is caught the day it's written\n * rather than during an audit.\n */\nexport function warnOnUnreachableNavItems(\n  renderedLabelsByIntent: Record<string, Record<string, string>>,\n): void {\n  if (process.env.NODE_ENV === 'production') return;\n\n  const orphans = findUnreachableNavItems(renderedLabelsByIntent);\n  if (orphans.length > 0) {\n    console.warn(\n      '[intents] These nav items are declared in an intent config but rendered ' +\n        'by no sidebar group, so nothing links to them. Add the id to ' +\n        'intentDefinitions in sidebar.tsx, or drop it from the config:\\n' +\n        orphans\n          .map((o) => `  ${o.intent} → ${o.itemId} (${o.href})`)\n          .join('\\n'),\n    );\n  }\n\n  const mismatches = findLabelMismatches(renderedLabelsByIntent);\n  if (mismatches.length > 0) {\n    console.warn(\n      '[intents] These nav items are called one thing in the sidebar and ' +\n        'another on /dashboard/operations, which builds its tiles from the ' +\n        'config. Update the config to match the sidebar:\\n' +\n        mismatches\n          .map(\n            (m) =>\n              `  ${m.intent} → ${m.itemId}: config \"${m.config}\" vs sidebar \"${m.sidebar}\"`,\n          )\n          .join('\\n'),\n    );\n  }\n}\n\n/**\n * Sidebar rows no intent config can back.\n *\n * The mirror of `findUnreachableNavItems`, and the half nothing checked. The\n * sidebar takes each row's LABEL from `INTENT_NAV_DEFINITIONS` and its HREF\n * from the config, so a row named in the definitions and absent from the config\n * has nowhere to point: `buildIntentItem` returns null and the row disappears\n * without a word.\n *\n * `event-tickets` named a **Check-ins** row under Attendees. The config had\n * dropped it on purpose — it was Attendees minus the list, plus a scan log that\n * rendered empty every load — and the definitions never got the memo. Twelve\n * ticketing businesses carried a row in the definitions that none of them could\n * see, and both existing checks passed the whole time: one asks whether every\n * config item is rendered, and this asks the other direction.\n */\nexport function findUnbackedNavRows(): {\n  intent: string;\n  itemId: string;\n  label: string;\n}[] {\n  const configs: Record<string, IntentConfig> = {\n    ...intentRegistry,\n    default: defaultCommerceConfig,\n  };\n  const unbacked: { intent: string; itemId: string; label: string }[] = [];\n\n  for (const definition of INTENT_NAV_DEFINITIONS) {\n    const config = configs[definition.key];\n    if (!config) continue;\n\n    const declared = new Set(\n      config.navigation.groups.flatMap((g) => g.items.map((i) => i.id)),\n    );\n\n    for (const item of definition.items) {\n      for (const row of [item, ...(item.children ?? [])]) {\n        // Spine-owned rows are rendered by the spine from its own list and\n        // never looked up in a config, so an absence there is not a hole.\n        if (declared.has(row.id) || SPINE_OWNED_IDS.has(row.id)) continue;\n        unbacked.push({\n          intent: definition.key,\n          itemId: row.id,\n          label: row.label,\n        });\n      }\n    }\n  }\n\n  return unbacked;\n}\n"],"mappings":"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","names":[]}

package/dist/intents/operating-shell.d.ts

@@ -0,0 +1,45 @@
+import type { IntentConfig } from './types';
+export interface OperatingModelOrderShell {
+    hideFulfillment?: boolean;
+    hideShipping?: boolean;
+}
+export interface OperatingModelProfile {
+    key: string;
+    label: string;
+    description?: string;
+    enabled?: boolean;
+    intentKeys?: string[];
+    behaviorKeys?: string[];
+    orderShell?: OperatingModelOrderShell;
+}
+export interface OperatingModelOverrides {
+    byIntent?: Record<string, Partial<OperatingModelProfile>>;
+    byLocation?: Record<string, Partial<OperatingModelProfile>>;
+}
+export interface OperatingModelSettings {
+    version: 1;
+    defaultProfileKey?: string;
+    profiles: OperatingModelProfile[];
+    overrides?: OperatingModelOverrides;
+}
+/**
+ * Resolve the tenant operating model from JSONB settings.
+ *
+ * When the persisted operating model is not available yet, it projects from
+ * the tenant's selected intents so the UI still reflects the active setup.
+ * Consumed by the settings editor; the render path uses
+ * getOrderShellOverrides() below.
+ */
+export declare function resolveOperatingModel(tenantSettings?: Record<string, unknown>): OperatingModelSettings;
+/**
+ * Build a lookup of intent-key → order shell from the resolved operating
+ * model. Keyed by both the profile key and each of its intentKeys so a
+ * resolved IntentConfig can find its shell by `config.key`.
+ */
+export declare function getOrderShellOverrides(tenantSettings?: Record<string, unknown>): Map<string, OperatingModelOrderShell>;
+/**
+ * Return the config with its orderDisplay visibility overridden by the
+ * tenant's operating shell for that intent, if any. A pass-through when there
+ * is no matching override (the projected shell equals the intent baseline).
+ */
+export declare function applyOrderShellOverrides(config: IntentConfig, overrides: Map<string, OperatingModelOrderShell>): IntentConfig;

package/dist/intents/operating-shell.js

@@ -0,0 +1,142 @@
+import { intentRegistry } from "./registry";
+const HIDE_FULFILLMENT_INTENTS = /* @__PURE__ */ new Set([
+  "take-bookings",
+  "rent-property",
+  "subscriptions",
+  "digital-products",
+  "event-tickets"
+]);
+const DEFAULT_OPERATING_MODEL = {
+  version: 1,
+  defaultProfileKey: "default-commerce",
+  profiles: [
+    {
+      key: "default-commerce",
+      label: "Commerce",
+      orderShell: {
+        hideFulfillment: false,
+        hideShipping: false
+      }
+    }
+  ]
+};
+function toProjectedProfile(config) {
+  return {
+    key: config.key,
+    label: config.label,
+    description: config.description,
+    enabled: true,
+    intentKeys: [config.key],
+    behaviorKeys: config.behaviorFilter?.include ? [config.behaviorFilter.include] : void 0,
+    orderShell: {
+      hideFulfillment: config.orderDisplay.hideFulfillment,
+      hideShipping: config.orderDisplay.hideShipping
+    }
+  };
+}
+function buildProjectedOperatingModelFromIntents(intentKeys) {
+  const profiles = intentKeys.map((key) => intentRegistry[key]).filter(Boolean).map((config) => toProjectedProfile(config));
+  if (profiles.length === 0) {
+    return DEFAULT_OPERATING_MODEL;
+  }
+  return {
+    version: 1,
+    defaultProfileKey: profiles[0]?.key,
+    profiles
+  };
+}
+function shouldHideFulfillment(profile) {
+  if (profile.visibility?.hideFulfillment !== void 0) {
+    return profile.visibility.hideFulfillment;
+  }
+  if (profile.visibility?.showKitchenStatus) {
+    return false;
+  }
+  if (profile.visibility?.showCheckIn) {
+    return true;
+  }
+  return profile.intentKeys?.some(
+    (intentKey) => HIDE_FULFILLMENT_INTENTS.has(intentKey)
+  ) ?? false;
+}
+function toOrderShell(profile) {
+  if (profile.orderShell) {
+    return { ...profile.orderShell };
+  }
+  return {
+    hideFulfillment: shouldHideFulfillment(profile),
+    hideShipping: profile.visibility?.hideShipping ?? false
+  };
+}
+function normalizePersistedProfile(profile) {
+  return {
+    key: profile.key,
+    label: profile.label,
+    description: profile.description,
+    enabled: profile.enabled ?? true,
+    intentKeys: profile.intentKeys ? [...profile.intentKeys] : void 0,
+    behaviorKeys: profile.behaviorKeys ? [...profile.behaviorKeys] : void 0,
+    orderShell: toOrderShell(profile)
+  };
+}
+function normalizeOperatingModel(operatingModel) {
+  const profiles = Array.isArray(operatingModel.profiles) ? operatingModel.profiles.map(
+    (profile) => normalizePersistedProfile(profile)
+  ) : [];
+  const defaultProfileKey = operatingModel.defaultProfileKey && (profiles.length === 0 || profiles.some(
+    (profile) => profile.key === operatingModel.defaultProfileKey
+  )) ? operatingModel.defaultProfileKey : profiles[0]?.key;
+  return {
+    version: 1,
+    defaultProfileKey,
+    profiles,
+    overrides: operatingModel.overrides
+  };
+}
+function resolveOperatingModel(tenantSettings) {
+  const operatingModel = tenantSettings?.operatingModel;
+  if (operatingModel !== void 0 && operatingModel !== null) {
+    return normalizeOperatingModel(operatingModel);
+  }
+  const selectedIntents = tenantSettings?.selectedIntents;
+  if (Array.isArray(selectedIntents) && selectedIntents.length > 0) {
+    return buildProjectedOperatingModelFromIntents(selectedIntents);
+  }
+  return DEFAULT_OPERATING_MODEL;
+}
+function mergeOrderDisplay(orderDisplay, operatingShell) {
+  if (!operatingShell) {
+    return orderDisplay;
+  }
+  return {
+    ...orderDisplay,
+    hideFulfillment: operatingShell.hideFulfillment ?? orderDisplay.hideFulfillment,
+    hideShipping: operatingShell.hideShipping ?? orderDisplay.hideShipping
+  };
+}
+function getOrderShellOverrides(tenantSettings) {
+  const resolved = resolveOperatingModel(tenantSettings);
+  const overrides = /* @__PURE__ */ new Map();
+  for (const profile of resolved.profiles) {
+    if (!profile.orderShell) continue;
+    overrides.set(profile.key, profile.orderShell);
+    for (const intentKey of profile.intentKeys ?? []) {
+      overrides.set(intentKey, profile.orderShell);
+    }
+  }
+  return overrides;
+}
+function applyOrderShellOverrides(config, overrides) {
+  const shell = overrides.get(config.key);
+  if (!shell) return config;
+  return {
+    ...config,
+    orderDisplay: mergeOrderDisplay(config.orderDisplay, shell)
+  };
+}
+export {
+  applyOrderShellOverrides,
+  getOrderShellOverrides,
+  resolveOperatingModel
+};
+//# sourceMappingURL=operating-shell.js.map

package/dist/intents/operating-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/operating-shell.ts"],"sourcesContent":["/**\n * Operating shell — the thin visibility layer folded into the intent engine.\n *\n * IntentConfig is the single source of dashboard labels, pages, sections and\n * status semantics. The operating shell only overrides the operational shell\n * around those intents: shipping and fulfillment visibility. It used to be a\n * parallel `operating-model` system with its own resolver hook mirroring\n * useIntentConfig; it now lives here and is applied once during intent\n * resolution, so consumers read a single pre-merged config.\n */\nimport { intentRegistry } from './registry';\nimport type { IntentConfig, OrderDisplay } from './types';\n\n// ── Types (formerly operating-model/types.ts) ──────────────────────────────\n\nexport interface OperatingModelOrderShell {\n  hideFulfillment?: boolean;\n  hideShipping?: boolean;\n}\n\nexport interface OperatingModelProfile {\n  key: string;\n  label: string;\n  description?: string;\n  enabled?: boolean;\n  intentKeys?: string[];\n  behaviorKeys?: string[];\n  orderShell?: OperatingModelOrderShell;\n}\n\nexport interface OperatingModelOverrides {\n  byIntent?: Record<string, Partial<OperatingModelProfile>>;\n  byLocation?: Record<string, Partial<OperatingModelProfile>>;\n}\n\nexport interface OperatingModelSettings {\n  version: 1;\n  defaultProfileKey?: string;\n  profiles: OperatingModelProfile[];\n  overrides?: OperatingModelOverrides;\n}\n\n// ── Persisted (JSONB) shape ────────────────────────────────────────────────\n\ninterface PersistedOperatingModelVisibility {\n  hideShipping?: boolean;\n  hideFulfillment?: boolean;\n  showCheckIn?: boolean;\n  showKitchenStatus?: boolean;\n  showDeliveryStatus?: boolean;\n}\n\ninterface PersistedOperatingModelProfile {\n  key: string;\n  label: string;\n  description?: string;\n  enabled?: boolean;\n  intentKeys?: string[];\n  behaviorKeys?: string[];\n  visibility?: PersistedOperatingModelVisibility;\n  orderShell?: OperatingModelOrderShell;\n}\n\ninterface PersistedOperatingModelSettings {\n  version?: number;\n  defaultProfileKey?: string;\n  profiles?: PersistedOperatingModelProfile[];\n  overrides?: OperatingModelSettings['overrides'];\n}\n\nconst HIDE_FULFILLMENT_INTENTS = new Set([\n  'take-bookings',\n  'rent-property',\n  'subscriptions',\n  'digital-products',\n  'event-tickets',\n]);\n\nconst DEFAULT_OPERATING_MODEL: OperatingModelSettings = {\n  version: 1,\n  defaultProfileKey: 'default-commerce',\n  profiles: [\n    {\n      key: 'default-commerce',\n      label: 'Commerce',\n      orderShell: {\n        hideFulfillment: false,\n        hideShipping: false,\n      },\n    },\n  ],\n};\n\nfunction toProjectedProfile(config: IntentConfig): OperatingModelProfile {\n  return {\n    key: config.key,\n    label: config.label,\n    description: config.description,\n    enabled: true,\n    intentKeys: [config.key],\n    behaviorKeys: config.behaviorFilter?.include\n      ? [config.behaviorFilter.include]\n      : undefined,\n    orderShell: {\n      hideFulfillment: config.orderDisplay.hideFulfillment,\n      hideShipping: config.orderDisplay.hideShipping,\n    },\n  };\n}\n\nfunction buildProjectedOperatingModelFromIntents(\n  intentKeys: string[],\n): OperatingModelSettings {\n  const profiles = intentKeys\n    .map((key) => intentRegistry[key])\n    .filter(Boolean)\n    .map((config) => toProjectedProfile(config));\n\n  if (profiles.length === 0) {\n    return DEFAULT_OPERATING_MODEL;\n  }\n\n  return {\n    version: 1,\n    defaultProfileKey: profiles[0]?.key,\n    profiles,\n  };\n}\n\nfunction shouldHideFulfillment(\n  profile: PersistedOperatingModelProfile,\n): boolean {\n  if (profile.visibility?.hideFulfillment !== undefined) {\n    return profile.visibility.hideFulfillment;\n  }\n\n  if (profile.visibility?.showKitchenStatus) {\n    return false;\n  }\n\n  if (profile.visibility?.showCheckIn) {\n    return true;\n  }\n\n  return (\n    profile.intentKeys?.some((intentKey) =>\n      HIDE_FULFILLMENT_INTENTS.has(intentKey),\n    ) ?? false\n  );\n}\n\nfunction toOrderShell(\n  profile: PersistedOperatingModelProfile,\n): OperatingModelOrderShell {\n  if (profile.orderShell) {\n    return { ...profile.orderShell };\n  }\n\n  return {\n    hideFulfillment: shouldHideFulfillment(profile),\n    hideShipping: profile.visibility?.hideShipping ?? false,\n  };\n}\n\nfunction normalizePersistedProfile(\n  profile: PersistedOperatingModelProfile,\n): OperatingModelProfile {\n  return {\n    key: profile.key,\n    label: profile.label,\n    description: profile.description,\n    enabled: profile.enabled ?? true,\n    intentKeys: profile.intentKeys ? [...profile.intentKeys] : undefined,\n    behaviorKeys: profile.behaviorKeys ? [...profile.behaviorKeys] : undefined,\n    orderShell: toOrderShell(profile),\n  };\n}\n\nfunction normalizeOperatingModel(\n  operatingModel: PersistedOperatingModelSettings,\n): OperatingModelSettings {\n  const profiles = Array.isArray(operatingModel.profiles)\n    ? operatingModel.profiles.map((profile) =>\n        normalizePersistedProfile(profile),\n      )\n    : [];\n  const defaultProfileKey =\n    operatingModel.defaultProfileKey &&\n    (profiles.length === 0 ||\n      profiles.some(\n        (profile) => profile.key === operatingModel.defaultProfileKey,\n      ))\n      ? operatingModel.defaultProfileKey\n      : profiles[0]?.key;\n\n  return {\n    version: 1,\n    defaultProfileKey,\n    profiles,\n    overrides: operatingModel.overrides,\n  };\n}\n\n/**\n * Resolve the tenant operating model from JSONB settings.\n *\n * When the persisted operating model is not available yet, it projects from\n * the tenant's selected intents so the UI still reflects the active setup.\n * Consumed by the settings editor; the render path uses\n * getOrderShellOverrides() below.\n */\nexport function resolveOperatingModel(\n  tenantSettings?: Record<string, unknown>,\n): OperatingModelSettings {\n  const operatingModel = tenantSettings?.operatingModel as\n    | PersistedOperatingModelSettings\n    | undefined;\n\n  if (operatingModel !== undefined && operatingModel !== null) {\n    return normalizeOperatingModel(operatingModel);\n  }\n\n  const selectedIntents = tenantSettings?.selectedIntents;\n  if (Array.isArray(selectedIntents) && selectedIntents.length > 0) {\n    return buildProjectedOperatingModelFromIntents(selectedIntents);\n  }\n\n  return DEFAULT_OPERATING_MODEL;\n}\n\n// ── The fold: apply an operating shell onto an IntentConfig's orderDisplay ──\n\nfunction mergeOrderDisplay(\n  orderDisplay: OrderDisplay,\n  operatingShell?: OperatingModelOrderShell,\n): OrderDisplay {\n  if (!operatingShell) {\n    return orderDisplay;\n  }\n\n  return {\n    ...orderDisplay,\n    hideFulfillment:\n      operatingShell.hideFulfillment ?? orderDisplay.hideFulfillment,\n    hideShipping: operatingShell.hideShipping ?? orderDisplay.hideShipping,\n  };\n}\n\n/**\n * Build a lookup of intent-key → order shell from the resolved operating\n * model. Keyed by both the profile key and each of its intentKeys so a\n * resolved IntentConfig can find its shell by `config.key`.\n */\nexport function getOrderShellOverrides(\n  tenantSettings?: Record<string, unknown>,\n): Map<string, OperatingModelOrderShell> {\n  const resolved = resolveOperatingModel(tenantSettings);\n  const overrides = new Map<string, OperatingModelOrderShell>();\n\n  for (const profile of resolved.profiles) {\n    if (!profile.orderShell) continue;\n    overrides.set(profile.key, profile.orderShell);\n    for (const intentKey of profile.intentKeys ?? []) {\n      overrides.set(intentKey, profile.orderShell);\n    }\n  }\n\n  return overrides;\n}\n\n/**\n * Return the config with its orderDisplay visibility overridden by the\n * tenant's operating shell for that intent, if any. A pass-through when there\n * is no matching override (the projected shell equals the intent baseline).\n */\nexport function applyOrderShellOverrides(\n  config: IntentConfig,\n  overrides: Map<string, OperatingModelOrderShell>,\n): IntentConfig {\n  const shell = overrides.get(config.key);\n  if (!shell) return config;\n  return {\n    ...config,\n    orderDisplay: mergeOrderDisplay(config.orderDisplay, shell),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/intents/order-display.d.ts

@@ -0,0 +1,21 @@
+import type { ReactNode } from 'react';
+import type { FulfillmentStatus, OrderStatus } from '@withpotter/lib/api/types';
+import type { OrderDisplay } from './types';
+export interface StatusVisual {
+    label: string;
+    color: string;
+    bgColor: string;
+    icon: ReactNode;
+}
+export interface FulfillmentModalCopy {
+    title: string;
+    description: string;
+    actionLabel: string;
+    showShippingFields: boolean;
+}
+export declare function resolveOrderStatusLabel(orderDisplay: OrderDisplay | undefined, status: OrderStatus): string;
+export declare function resolveOrderStatusVisual(orderDisplay: OrderDisplay | undefined, status: OrderStatus): StatusVisual;
+export declare function resolveFulfillmentStatusLabel(orderDisplay: OrderDisplay | undefined, status: FulfillmentStatus): string;
+export declare function resolveFulfillmentStatusVisual(orderDisplay: OrderDisplay | undefined, status: FulfillmentStatus): StatusVisual;
+export declare function resolveFulfillmentModalCopy(orderDisplay: OrderDisplay | undefined): FulfillmentModalCopy;
+export declare function resolveFulfillmentStatusKeys(orderDisplay: OrderDisplay | undefined): FulfillmentStatus[];

package/dist/intents/order-display.js

@@ -0,0 +1,110 @@
+import { jsx } from "react/jsx-runtime";
+import { defaultCommerceConfig } from "./registry";
+import { resolveIcon } from "./icon-map";
+const NEUTRAL_STATUS_STYLE = {
+  color: "text-[var(--text-secondary)]",
+  bgColor: "bg-[var(--bg-muted)]"
+};
+const FULFILLMENT_COLOR_STYLES = {
+  unfulfilled: {
+    color: "text-[var(--warning)]",
+    bgColor: "bg-[var(--warning-bg)]"
+  },
+  partial: {
+    color: "text-[var(--info)]",
+    bgColor: "bg-[var(--info-bg)]"
+  },
+  ready: {
+    color: "text-[var(--info)]",
+    bgColor: "bg-[var(--info-bg)]"
+  },
+  fulfilled: {
+    color: "text-[var(--success)]",
+    bgColor: "bg-[var(--success-bg)]"
+  },
+  collected: {
+    color: "text-[var(--success)]",
+    bgColor: "bg-[var(--success-bg)]"
+  },
+  delivered: {
+    color: "text-[var(--success)]",
+    bgColor: "bg-[var(--success-bg)]"
+  }
+};
+const FULFILLMENT_ICON_NAMES = {
+  unfulfilled: "Package",
+  partial: "Truck",
+  ready: "Package",
+  fulfilled: "CheckCircle",
+  collected: "CheckCircle",
+  delivered: "CheckCircle"
+};
+function titleCase(value) {
+  return value.replace(/_/g, " ").replace(/\b\w/g, (character) => character.toUpperCase());
+}
+function resolveStatusStyles() {
+  return NEUTRAL_STATUS_STYLE;
+}
+function resolveOrderStatusLabel(orderDisplay, status) {
+  const display = orderDisplay ?? defaultCommerceConfig.orderDisplay;
+  return display.statusLabels[status] ?? titleCase(status);
+}
+function resolveOrderStatusVisual(orderDisplay, status) {
+  const display = orderDisplay ?? defaultCommerceConfig.orderDisplay;
+  const label = resolveOrderStatusLabel(display, status);
+  const { color, bgColor } = resolveStatusStyles();
+  const Icon = resolveIcon(display.statusIcons[status] ?? "Package");
+  return {
+    label,
+    color,
+    bgColor,
+    icon: /* @__PURE__ */ jsx(Icon, { className: "w-4 h-4" })
+  };
+}
+function resolveFulfillmentStatusLabel(orderDisplay, status) {
+  const display = orderDisplay ?? defaultCommerceConfig.orderDisplay;
+  return display.fulfillmentLabels?.[status] ?? titleCase(status);
+}
+function resolveFulfillmentStatusVisual(orderDisplay, status) {
+  const label = resolveFulfillmentStatusLabel(orderDisplay, status);
+  const { color, bgColor } = FULFILLMENT_COLOR_STYLES[status] ?? FULFILLMENT_COLOR_STYLES.unfulfilled;
+  const Icon = resolveIcon(FULFILLMENT_ICON_NAMES[status]);
+  return {
+    label,
+    color,
+    bgColor,
+    icon: /* @__PURE__ */ jsx(Icon, { className: "w-4 h-4" })
+  };
+}
+function resolveFulfillmentModalCopy(orderDisplay) {
+  const display = orderDisplay ?? defaultCommerceConfig.orderDisplay;
+  if (display.hideShipping) {
+    const fulfilledLabel = display.fulfillmentLabels?.fulfilled ?? "Fulfilled";
+    return {
+      title: `Mark as ${fulfilledLabel}`,
+      description: `Confirm this order should be marked as ${fulfilledLabel.toLowerCase()}.`,
+      actionLabel: `Mark as ${fulfilledLabel}`,
+      showShippingFields: false
+    };
+  }
+  return {
+    title: "Mark as Shipped",
+    description: "Add tracking information to notify your customer. All fields are optional.",
+    actionLabel: "Mark as Shipped",
+    showShippingFields: true
+  };
+}
+function resolveFulfillmentStatusKeys(orderDisplay) {
+  const display = orderDisplay ?? defaultCommerceConfig.orderDisplay;
+  const fulfillmentLabels = display.fulfillmentLabels ?? defaultCommerceConfig.orderDisplay.fulfillmentLabels;
+  return Object.keys(fulfillmentLabels ?? {});
+}
+export {
+  resolveFulfillmentModalCopy,
+  resolveFulfillmentStatusKeys,
+  resolveFulfillmentStatusLabel,
+  resolveFulfillmentStatusVisual,
+  resolveOrderStatusLabel,
+  resolveOrderStatusVisual
+};
+//# sourceMappingURL=order-display.js.map

package/dist/intents/order-display.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/order-display.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { FulfillmentStatus, OrderStatus } from '@withpotter/lib/api/types';\nimport { defaultCommerceConfig } from './registry';\nimport type { OrderDisplay } from './types';\nimport { resolveIcon } from './icon-map';\n\nexport interface StatusVisual {\n  label: string;\n  color: string;\n  bgColor: string;\n  icon: ReactNode;\n}\n\nexport interface FulfillmentModalCopy {\n  title: string;\n  description: string;\n  actionLabel: string;\n  showShippingFields: boolean;\n}\n\n/**\n * One neutral chip for every status.\n *\n * Each archetype used to name a colour per status — yellow pending, green\n * confirmed, blue checked-in, red cancelled — and an orders table came out as a\n * column of six hues down the right-hand side. That is colour restating the\n * word next to it: the chip already reads \"Cancelled\", and painting it red adds\n * nothing a reader did not have. It also made the eye rank the rows by hue,\n * which put \"Cancelled\" top of the visual order on a page whose actual priority\n * is money waiting on a human.\n *\n * Two of the seven were not even tokens (`purple-600`/`purple-50`,\n * `orange-600`/`orange-50` are raw Tailwind), so they were light-mode swatches\n * sitting on a dark surface.\n *\n * The `statusColors` entry in each intent config still resolves through here\n * and is deliberately ignored rather than deleted from eleven config files: the\n * shape is part of the published `OrderDisplay` contract, and one function\n * neutralising it fixes every archetype at once. See the note on colour in\n * CLAUDE.md — it encodes identity or a live relationship, never a repeat of the\n * label beside it.\n */\nconst NEUTRAL_STATUS_STYLE = {\n  color: 'text-[var(--text-secondary)]',\n  bgColor: 'bg-[var(--bg-muted)]',\n};\n\nconst FULFILLMENT_COLOR_STYLES: Record<\n  FulfillmentStatus,\n  { color: string; bgColor: string }\n> = {\n  unfulfilled: {\n    color: 'text-[var(--warning)]',\n    bgColor: 'bg-[var(--warning-bg)]',\n  },\n  partial: {\n    color: 'text-[var(--info)]',\n    bgColor: 'bg-[var(--info-bg)]',\n  },\n  ready: {\n    color: 'text-[var(--info)]',\n    bgColor: 'bg-[var(--info-bg)]',\n  },\n  fulfilled: {\n    color: 'text-[var(--success)]',\n    bgColor: 'bg-[var(--success-bg)]',\n  },\n  collected: {\n    color: 'text-[var(--success)]',\n    bgColor: 'bg-[var(--success-bg)]',\n  },\n  delivered: {\n    color: 'text-[var(--success)]',\n    bgColor: 'bg-[var(--success-bg)]',\n  },\n};\n\nconst FULFILLMENT_ICON_NAMES: Record<FulfillmentStatus, string> = {\n  unfulfilled: 'Package',\n  partial: 'Truck',\n  ready: 'Package',\n  fulfilled: 'CheckCircle',\n  collected: 'CheckCircle',\n  delivered: 'CheckCircle',\n};\n\nfunction titleCase(value: string): string {\n  return value\n    .replace(/_/g, ' ')\n    .replace(/\\b\\w/g, (character) => character.toUpperCase());\n}\n\nfunction resolveStatusStyles(): { color: string; bgColor: string } {\n  return NEUTRAL_STATUS_STYLE;\n}\n\nexport function resolveOrderStatusLabel(\n  orderDisplay: OrderDisplay | undefined,\n  status: OrderStatus,\n): string {\n  const display = orderDisplay ?? defaultCommerceConfig.orderDisplay;\n  return display.statusLabels[status] ?? titleCase(status);\n}\n\nexport function resolveOrderStatusVisual(\n  orderDisplay: OrderDisplay | undefined,\n  status: OrderStatus,\n): StatusVisual {\n  const display = orderDisplay ?? defaultCommerceConfig.orderDisplay;\n  const label = resolveOrderStatusLabel(display, status);\n  const { color, bgColor } = resolveStatusStyles();\n  const Icon = resolveIcon(display.statusIcons[status] ?? 'Package');\n\n  return {\n    label,\n    color,\n    bgColor,\n    icon: <Icon className=\"w-4 h-4\" />,\n  };\n}\n\nexport function resolveFulfillmentStatusLabel(\n  orderDisplay: OrderDisplay | undefined,\n  status: FulfillmentStatus,\n): string {\n  const display = orderDisplay ?? defaultCommerceConfig.orderDisplay;\n  return display.fulfillmentLabels?.[status] ?? titleCase(status);\n}\n\nexport function resolveFulfillmentStatusVisual(\n  orderDisplay: OrderDisplay | undefined,\n  status: FulfillmentStatus,\n): StatusVisual {\n  const label = resolveFulfillmentStatusLabel(orderDisplay, status);\n  const { color, bgColor } =\n    FULFILLMENT_COLOR_STYLES[status] ?? FULFILLMENT_COLOR_STYLES.unfulfilled;\n  const Icon = resolveIcon(FULFILLMENT_ICON_NAMES[status]);\n\n  return {\n    label,\n    color,\n    bgColor,\n    icon: <Icon className=\"w-4 h-4\" />,\n  };\n}\n\nexport function resolveFulfillmentModalCopy(\n  orderDisplay: OrderDisplay | undefined,\n): FulfillmentModalCopy {\n  const display = orderDisplay ?? defaultCommerceConfig.orderDisplay;\n\n  if (display.hideShipping) {\n    const fulfilledLabel = display.fulfillmentLabels?.fulfilled ?? 'Fulfilled';\n    return {\n      title: `Mark as ${fulfilledLabel}`,\n      description: `Confirm this order should be marked as ${fulfilledLabel.toLowerCase()}.`,\n      actionLabel: `Mark as ${fulfilledLabel}`,\n      showShippingFields: false,\n    };\n  }\n\n  return {\n    title: 'Mark as Shipped',\n    description:\n      'Add tracking information to notify your customer. All fields are optional.',\n    actionLabel: 'Mark as Shipped',\n    showShippingFields: true,\n  };\n}\n\nexport function resolveFulfillmentStatusKeys(\n  orderDisplay: OrderDisplay | undefined,\n): FulfillmentStatus[] {\n  const display = orderDisplay ?? defaultCommerceConfig.orderDisplay;\n  const fulfillmentLabels: Record<string, string> | undefined =\n    display.fulfillmentLabels ??\n    defaultCommerceConfig.orderDisplay.fulfillmentLabels;\n\n  return Object.keys(fulfillmentLabels ?? {}) as FulfillmentStatus[];\n}\n"],"mappings":"AAqHU;AAnHV,SAAS,6BAA6B;AAEtC,SAAS,mBAAmB;AAsC5B,MAAM,uBAAuB;AAAA,EAC3B,OAAO;AAAA,EACP,SAAS;AACX;AAEA,MAAM,2BAGF;AAAA,EACF,aAAa;AAAA,IACX,OAAO;AAAA,IACP,SAAS;AAAA,EACX;AAAA,EACA,SAAS;AAAA,IACP,OAAO;AAAA,IACP,SAAS;AAAA,EACX;AAAA,EACA,OAAO;AAAA,IACL,OAAO;AAAA,IACP,SAAS;AAAA,EACX;AAAA,EACA,WAAW;AAAA,IACT,OAAO;AAAA,IACP,SAAS;AAAA,EACX;AAAA,EACA,WAAW;AAAA,IACT,OAAO;AAAA,IACP,SAAS;AAAA,EACX;AAAA,EACA,WAAW;AAAA,IACT,OAAO;AAAA,IACP,SAAS;AAAA,EACX;AACF;AAEA,MAAM,yBAA4D;AAAA,EAChE,aAAa;AAAA,EACb,SAAS;AAAA,EACT,OAAO;AAAA,EACP,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AACb;AAEA,SAAS,UAAU,OAAuB;AACxC,SAAO,MACJ,QAAQ,MAAM,GAAG,EACjB,QAAQ,SAAS,CAAC,cAAc,UAAU,YAAY,CAAC;AAC5D;AAEA,SAAS,sBAA0D;AACjE,SAAO;AACT;AAEO,SAAS,wBACd,cACA,QACQ;AACR,QAAM,UAAU,gBAAgB,sBAAsB;AACtD,SAAO,QAAQ,aAAa,MAAM,KAAK,UAAU,MAAM;AACzD;AAEO,SAAS,yBACd,cACA,QACc;AACd,QAAM,UAAU,gBAAgB,sBAAsB;AACtD,QAAM,QAAQ,wBAAwB,SAAS,MAAM;AACrD,QAAM,EAAE,OAAO,QAAQ,IAAI,oBAAoB;AAC/C,QAAM,OAAO,YAAY,QAAQ,YAAY,MAAM,KAAK,SAAS;AAEjE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM,oBAAC,QAAK,WAAU,WAAU;AAAA,EAClC;AACF;AAEO,SAAS,8BACd,cACA,QACQ;AACR,QAAM,UAAU,gBAAgB,sBAAsB;AACtD,SAAO,QAAQ,oBAAoB,MAAM,KAAK,UAAU,MAAM;AAChE;AAEO,SAAS,+BACd,cACA,QACc;AACd,QAAM,QAAQ,8BAA8B,cAAc,MAAM;AAChE,QAAM,EAAE,OAAO,QAAQ,IACrB,yBAAyB,MAAM,KAAK,yBAAyB;AAC/D,QAAM,OAAO,YAAY,uBAAuB,MAAM,CAAC;AAEvD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM,oBAAC,QAAK,WAAU,WAAU;AAAA,EAClC;AACF;AAEO,SAAS,4BACd,cACsB;AACtB,QAAM,UAAU,gBAAgB,sBAAsB;AAEtD,MAAI,QAAQ,cAAc;AACxB,UAAM,iBAAiB,QAAQ,mBAAmB,aAAa;AAC/D,WAAO;AAAA,MACL,OAAO,WAAW,cAAc;AAAA,MAChC,aAAa,0CAA0C,eAAe,YAAY,CAAC;AAAA,MACnF,aAAa,WAAW,cAAc;AAAA,MACtC,oBAAoB;AAAA,IACtB;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO;AAAA,IACP,aACE;AAAA,IACF,aAAa;AAAA,IACb,oBAAoB;AAAA,EACtB;AACF;AAEO,SAAS,6BACd,cACqB;AACrB,QAAM,UAAU,gBAAgB,sBAAsB;AACtD,QAAM,oBACJ,QAAQ,qBACR,sBAAsB,aAAa;AAErC,SAAO,OAAO,KAAK,qBAAqB,CAAC,CAAC;AAC5C;","names":[]}

package/dist/intents/order-intent.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Which status workflow an order follows, read from what its items can do.
+ *
+ * THE API DECIDES, AND THIS MUST AGREE WITH IT. `update-order-status` resolves
+ * the workflow from the order's item behaviours and, when none applies, checks
+ * the DEFAULT commerce map — never the workspace's own archetype. This used to
+ * fall back to the page-level intent whenever the items did not name one, so a
+ * food-ordering workspace offered `processing → checked_in` ("Ready for
+ * Pickup") on a plain product order; the API, on the default map, answered
+ * "Cannot transition from processing to checked_in" and the order sat where it
+ * was.
+ *
+ * Only four workflows exist on the API (event tickets, food orders, bookings,
+ * rentals). `subscribable` and `downloadable` are read first there and resolve
+ * to a workflow that does not exist, so they end on the default map too — which
+ * is why they return nothing here rather than falling through to `sellable`.
+ */
+export declare function resolveOrderIntentKey(behaviors: Iterable<string>): string | undefined;

package/dist/intents/order-intent.js

@@ -0,0 +1,14 @@
+function resolveOrderIntentKey(behaviors) {
+  const has = new Set(behaviors);
+  if (has.has("ticketed")) return "event-tickets";
+  if (has.has("bookable") && has.has("rentable")) return "rent-property";
+  if (has.has("bookable")) return "take-bookings";
+  if (has.has("subscribable") || has.has("downloadable")) return void 0;
+  if (has.has("sellable") && has.has("shippable")) return void 0;
+  if (has.has("sellable")) return "food-orders";
+  return void 0;
+}
+export {
+  resolveOrderIntentKey
+};
+//# sourceMappingURL=order-intent.js.map

package/dist/intents/order-intent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/order-intent.ts"],"sourcesContent":["/**\n * Which status workflow an order follows, read from what its items can do.\n *\n * THE API DECIDES, AND THIS MUST AGREE WITH IT. `update-order-status` resolves\n * the workflow from the order's item behaviours and, when none applies, checks\n * the DEFAULT commerce map — never the workspace's own archetype. This used to\n * fall back to the page-level intent whenever the items did not name one, so a\n * food-ordering workspace offered `processing → checked_in` (\"Ready for\n * Pickup\") on a plain product order; the API, on the default map, answered\n * \"Cannot transition from processing to checked_in\" and the order sat where it\n * was.\n *\n * Only four workflows exist on the API (event tickets, food orders, bookings,\n * rentals). `subscribable` and `downloadable` are read first there and resolve\n * to a workflow that does not exist, so they end on the default map too — which\n * is why they return nothing here rather than falling through to `sellable`.\n */\nexport function resolveOrderIntentKey(\n  behaviors: Iterable<string>,\n): string | undefined {\n  const has = new Set(behaviors);\n\n  if (has.has('ticketed')) return 'event-tickets';\n  if (has.has('bookable') && has.has('rentable')) return 'rent-property';\n  if (has.has('bookable')) return 'take-bookings';\n  if (has.has('subscribable') || has.has('downloadable')) return undefined;\n  if (has.has('sellable') && has.has('shippable')) return undefined;\n  if (has.has('sellable')) return 'food-orders';\n\n  return undefined;\n}\n"],"mappings":"AAiBO,SAAS,sBACd,WACoB;AACpB,QAAM,MAAM,IAAI,IAAI,SAAS;AAE7B,MAAI,IAAI,IAAI,UAAU,EAAG,QAAO;AAChC,MAAI,IAAI,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,EAAG,QAAO;AACvD,MAAI,IAAI,IAAI,UAAU,EAAG,QAAO;AAChC,MAAI,IAAI,IAAI,cAAc,KAAK,IAAI,IAAI,cAAc,EAAG,QAAO;AAC/D,MAAI,IAAI,IAAI,UAAU,KAAK,IAAI,IAAI,WAAW,EAAG,QAAO;AACxD,MAAI,IAAI,IAAI,UAAU,EAAG,QAAO;AAEhC,SAAO;AACT;","names":[]}