@withpotter/lib 0.13.0-next.101

package/dist/intents/capture-leads.config.js

@@ -0,0 +1,231 @@
+const captureLeadsConfig = {
+  key: "capture-leads",
+  label: "Enquiries",
+  description: "Take enquiries and qualify them \u2014 viewings, quotes, admissions, consultations",
+  icon: "MessageSquare",
+  entities: {
+    // What is listed is what the enquiry is *about* — a property, a policy, a
+    // course — not something with a price and a buy button.
+    item: { singular: "Listing", plural: "Listings" },
+    order: { singular: "Enquiry", plural: "Enquiries" },
+    /**
+     * This does NOT name the Bookings row, and cannot.
+     *
+     * A pure `capture-leads` shell has no `bookable` behaviour, so there is no
+     * bookings surface for the word to land on. Add `take-bookings` and the row
+     * arrives as its own "Appointments" — because an estate agent doing
+     * viewings and a clinic doing consultations are the same archetype pair,
+     * and nothing here can tell them apart.
+     *
+     * Making `primary` win would be worse: it is whichever intent was ticked
+     * first, so the sidebar's wording would depend on the order somebody
+     * checked boxes at onboarding. `archetypeLabel` already refuses to do that,
+     * falling back to the neutral noun wherever archetypes disagree.
+     *
+     * The merchant's own word is the resolution — typed once in Settings ›
+     * Navigation, honoured by `moduleLabelFor`, and covered by "an estate agent
+     * can call the bookings row Viewings" in build-nav-groups.test.ts. This
+     * entry stays because it is the right noun for this archetype's vocabulary
+     * on the surfaces that do ask it, not because it names a screen.
+     */
+    booking: { singular: "Viewing", plural: "Viewings" },
+    resource: { singular: "Listing", plural: "Listings" }
+  },
+  navigation: {
+    groups: [
+      {
+        key: "catalog",
+        label: "Catalog",
+        items: [
+          {
+            id: "catalog",
+            label: "Listings",
+            href: "/dashboard/catalog",
+            icon: "FileText"
+          },
+          {
+            id: "collections",
+            label: "Collections",
+            href: "/dashboard/collections",
+            icon: "FolderOpen",
+            generic: true
+          }
+        ]
+      },
+      {
+        key: "pipeline",
+        label: "Pipeline",
+        items: [
+          {
+            // The primary work surface, so not `generic`: hiding it would
+            // leave the merchant with nowhere to do the only job they have.
+            id: "inquiries",
+            label: "Enquiries",
+            href: "/dashboard/inbox",
+            icon: "MessageSquare"
+          }
+        ]
+      }
+    ]
+  },
+  pages: [],
+  pageSections: {
+    orderDetail: [],
+    orderList: {
+      columns: [
+        { key: "customer", label: "Enquirer" },
+        { key: "status", label: "Stage" },
+        { key: "createdAt", label: "Received" }
+      ],
+      filters: [
+        { key: "status", label: "Stage", type: "select" },
+        { key: "dateRange", label: "Received", type: "dateRange" }
+      ],
+      actions: [
+        { key: "view", label: "Open", icon: "Eye", variant: "secondary" }
+      ],
+      bulkActions: [
+        {
+          key: "export-csv",
+          label: "Export CSV",
+          icon: "Download",
+          variant: "secondary"
+        }
+      ]
+    },
+    itemDetail: [
+      "item-header",
+      "pricing-info",
+      "media-gallery",
+      "seo-settings"
+    ],
+    itemList: {
+      columns: [
+        { key: "product", label: "Listing" },
+        { key: "status", label: "Status" }
+      ],
+      filters: [{ key: "status", label: "Status", type: "select" }],
+      stats: [
+        {
+          key: "total",
+          label: "Total listings",
+          dataKey: "total",
+          format: "number",
+          icon: "FileText"
+        },
+        {
+          key: "active",
+          label: "Live",
+          dataKey: "active",
+          format: "number",
+          icon: "CheckCircle"
+        }
+      ],
+      // Nothing is stocked — a listing is information, not units on a shelf.
+      trackInventory: false,
+      searchPlaceholder: "Search listings..."
+    }
+  },
+  dashboard: {
+    quickActions: [
+      {
+        key: "view-inquiries",
+        label: "Open enquiries",
+        icon: "MessageSquare",
+        href: "/dashboard/inbox",
+        variant: "primary"
+      },
+      {
+        key: "add-listing",
+        label: "Add listing",
+        icon: "Plus",
+        href: "/dashboard/catalog/new",
+        variant: "secondary"
+      }
+    ]
+  },
+  emptyStates: {
+    orders: {
+      title: "No enquiries yet",
+      description: "Your contact form feeds this inbox. The first enquiry lands here.",
+      actionLabel: "Open enquiries",
+      actionHref: "/dashboard/inbox"
+    },
+    items: {
+      title: "No listings yet",
+      description: "Add what people will be enquiring about.",
+      actionLabel: "Add listing",
+      actionHref: "/dashboard/catalog/new"
+    },
+    customers: {
+      title: "No contacts yet",
+      description: "People appear here once they enquire.",
+      actionLabel: "Open enquiries",
+      actionHref: "/dashboard/inbox"
+    }
+  },
+  orderDisplay: {
+    // Mirrors InquiryStatus in the API's inquiry.entity.ts, so a stage shown
+    // here is a stage the backend can actually be in.
+    /**
+     * The eight states an enquiry can be in, matching `InquiryStatus` exactly.
+     *
+     * `viewed` reads **Seen**, which is the word the inbox itself uses. It said
+     * "Viewed" here and "Seen" on the screen — one state, two words, in two
+     * files describing the same list.
+     *
+     * Worth knowing what this copy is for: `orderDisplay` means "this
+     * archetype's order-ish thing", and for `capture-leads` that thing is an
+     * enquiry. So these are inquiry statuses living in an order field, and the
+     * inbox reads its own list rather than this one — which is why the two
+     * could drift without anything failing.
+     */
+    statusLabels: {
+      new: "New",
+      viewed: "Seen",
+      in_progress: "In progress",
+      waiting_response: "Waiting on them",
+      converted: "Converted",
+      resolved: "Resolved",
+      closed: "Closed",
+      spam: "Spam"
+    },
+    statusColors: {
+      new: "blue",
+      viewed: "purple",
+      in_progress: "yellow",
+      waiting_response: "orange",
+      converted: "green",
+      resolved: "green",
+      closed: "gray",
+      spam: "gray"
+    },
+    statusIcons: {
+      new: "MessageSquare",
+      viewed: "Eye",
+      in_progress: "Clock",
+      waiting_response: "Hourglass",
+      converted: "CircleCheckBig",
+      resolved: "CheckCircle",
+      closed: "XCircle",
+      spam: "Ban"
+    },
+    pageSubtitle: "Answer people, and follow up until they are business",
+    hideFulfillment: true,
+    hideShipping: true
+  },
+  behaviorFilter: {
+    include: "leadCapture"
+  },
+  editor: {
+    intrinsicBehaviors: [],
+    hiddenBehaviors: ["ticketed", "shippable", "rentable", "downloadable"],
+    labels: {
+      titlePlaceholder: "e.g. 3-bed flat, Lekki Phase 1"
+    }
+  }
+};
+export {
+  captureLeadsConfig
+};
+//# sourceMappingURL=capture-leads.config.js.map

package/dist/intents/capture-leads.config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/capture-leads.config.ts"],"sourcesContent":["import type { IntentConfig } from './types';\n\n/**\n * Enquire & Qualify — businesses whose whole model is the enquiry: estate\n * agents, insurance brokers, schools taking admissions, B2B services.\n *\n * Nothing is sold from a catalogue and nothing is checked out. The thing that\n * arrives is a person asking a question, and the work is answering, qualifying\n * and following up until it becomes business elsewhere — a viewing, a policy,\n * a place, a contract.\n *\n * The loop exists end to end and nothing here builds it: the API has inquiries\n * with quote, follow-ups, stats and respond, and the Inquiries inbox is already\n * in the sidebar for everyone, deliberately ungated, because leads arrive\n * whether or not a merchant declared they wanted them.\n *\n * This comment used to claim that *every* storefront template ships a contact\n * form that feeds it. Counted rather than assumed, it was ten of the sixteen\n * built templates, and the misses included the portfolio — whose entire\n * conversion is a commission. Written from intent rather than from a grep,\n * which is the kind of claim worth checking before repeating.\n *\n * What was missing was a way to *say so* at onboarding. Without an intent,\n * these businesses landed on the generic commerce shell and were handed a\n * catalogue to fill and an Orders list that would never have a row in it.\n *\n * So: Orders is deliberately absent, exactly as it is for send-invoices. An\n * always-empty Orders list reads as broken software, not as an empty state.\n * The order entity labels still resolve for shared surfaces that ask for them\n * (analytics, exports).\n */\nexport const captureLeadsConfig: IntentConfig = {\n  key: 'capture-leads',\n  label: 'Enquiries',\n  description:\n    'Take enquiries and qualify them — viewings, quotes, admissions, consultations',\n  icon: 'MessageSquare',\n\n  entities: {\n    // What is listed is what the enquiry is *about* — a property, a policy, a\n    // course — not something with a price and a buy button.\n    item: { singular: 'Listing', plural: 'Listings' },\n    order: { singular: 'Enquiry', plural: 'Enquiries' },\n    /**\n     * This does NOT name the Bookings row, and cannot.\n     *\n     * A pure `capture-leads` shell has no `bookable` behaviour, so there is no\n     * bookings surface for the word to land on. Add `take-bookings` and the row\n     * arrives as its own \"Appointments\" — because an estate agent doing\n     * viewings and a clinic doing consultations are the same archetype pair,\n     * and nothing here can tell them apart.\n     *\n     * Making `primary` win would be worse: it is whichever intent was ticked\n     * first, so the sidebar's wording would depend on the order somebody\n     * checked boxes at onboarding. `archetypeLabel` already refuses to do that,\n     * falling back to the neutral noun wherever archetypes disagree.\n     *\n     * The merchant's own word is the resolution — typed once in Settings ›\n     * Navigation, honoured by `moduleLabelFor`, and covered by \"an estate agent\n     * can call the bookings row Viewings\" in build-nav-groups.test.ts. This\n     * entry stays because it is the right noun for this archetype's vocabulary\n     * on the surfaces that do ask it, not because it names a screen.\n     */\n    booking: { singular: 'Viewing', plural: 'Viewings' },\n    resource: { singular: 'Listing', plural: 'Listings' },\n  },\n\n  navigation: {\n    groups: [\n      {\n        key: 'catalog',\n        label: 'Catalog',\n        items: [\n          {\n            id: 'catalog',\n            label: 'Listings',\n            href: '/dashboard/catalog',\n            icon: 'FileText',\n          },\n          {\n            id: 'collections',\n            label: 'Collections',\n            href: '/dashboard/collections',\n            icon: 'FolderOpen',\n            generic: true,\n          },\n        ],\n      },\n      {\n        key: 'pipeline',\n        label: 'Pipeline',\n        items: [\n          {\n            // The primary work surface, so not `generic`: hiding it would\n            // leave the merchant with nowhere to do the only job they have.\n            id: 'inquiries',\n            label: 'Enquiries',\n            href: '/dashboard/inbox',\n            icon: 'MessageSquare',\n          },\n        ],\n      },\n    ],\n  },\n\n  pages: [],\n\n  pageSections: {\n    orderDetail: [],\n    orderList: {\n      columns: [\n        { key: 'customer', label: 'Enquirer' },\n        { key: 'status', label: 'Stage' },\n        { key: 'createdAt', label: 'Received' },\n      ],\n      filters: [\n        { key: 'status', label: 'Stage', type: 'select' },\n        { key: 'dateRange', label: 'Received', type: 'dateRange' },\n      ],\n      actions: [\n        { key: 'view', label: 'Open', icon: 'Eye', variant: 'secondary' },\n      ],\n      bulkActions: [\n        {\n          key: 'export-csv',\n          label: 'Export CSV',\n          icon: 'Download',\n          variant: 'secondary',\n        },\n      ],\n    },\n    itemDetail: [\n      'item-header',\n      'pricing-info',\n      'media-gallery',\n      'seo-settings',\n    ],\n    itemList: {\n      columns: [\n        { key: 'product', label: 'Listing' },\n        { key: 'status', label: 'Status' },\n      ],\n      filters: [{ key: 'status', label: 'Status', type: 'select' }],\n      stats: [\n        {\n          key: 'total',\n          label: 'Total listings',\n          dataKey: 'total',\n          format: 'number',\n          icon: 'FileText',\n        },\n        {\n          key: 'active',\n          label: 'Live',\n          dataKey: 'active',\n          format: 'number',\n          icon: 'CheckCircle',\n        },\n      ],\n      // Nothing is stocked — a listing is information, not units on a shelf.\n      trackInventory: false,\n      searchPlaceholder: 'Search listings...',\n    },\n  },\n\n  dashboard: {\n    quickActions: [\n      {\n        key: 'view-inquiries',\n        label: 'Open enquiries',\n        icon: 'MessageSquare',\n        href: '/dashboard/inbox',\n        variant: 'primary',\n      },\n      {\n        key: 'add-listing',\n        label: 'Add listing',\n        icon: 'Plus',\n        href: '/dashboard/catalog/new',\n        variant: 'secondary',\n      },\n    ],\n  },\n\n  emptyStates: {\n    orders: {\n      title: 'No enquiries yet',\n      description:\n        'Your contact form feeds this inbox. The first enquiry lands here.',\n      actionLabel: 'Open enquiries',\n      actionHref: '/dashboard/inbox',\n    },\n    items: {\n      title: 'No listings yet',\n      description: 'Add what people will be enquiring about.',\n      actionLabel: 'Add listing',\n      actionHref: '/dashboard/catalog/new',\n    },\n    customers: {\n      title: 'No contacts yet',\n      description: 'People appear here once they enquire.',\n      actionLabel: 'Open enquiries',\n      actionHref: '/dashboard/inbox',\n    },\n  },\n\n  orderDisplay: {\n    // Mirrors InquiryStatus in the API's inquiry.entity.ts, so a stage shown\n    // here is a stage the backend can actually be in.\n    /**\n     * The eight states an enquiry can be in, matching `InquiryStatus` exactly.\n     *\n     * `viewed` reads **Seen**, which is the word the inbox itself uses. It said\n     * \"Viewed\" here and \"Seen\" on the screen — one state, two words, in two\n     * files describing the same list.\n     *\n     * Worth knowing what this copy is for: `orderDisplay` means \"this\n     * archetype's order-ish thing\", and for `capture-leads` that thing is an\n     * enquiry. So these are inquiry statuses living in an order field, and the\n     * inbox reads its own list rather than this one — which is why the two\n     * could drift without anything failing.\n     */\n    statusLabels: {\n      new: 'New',\n      viewed: 'Seen',\n      in_progress: 'In progress',\n      waiting_response: 'Waiting on them',\n      converted: 'Converted',\n      resolved: 'Resolved',\n      closed: 'Closed',\n      spam: 'Spam',\n    },\n    statusColors: {\n      new: 'blue',\n      viewed: 'purple',\n      in_progress: 'yellow',\n      waiting_response: 'orange',\n      converted: 'green',\n      resolved: 'green',\n      closed: 'gray',\n      spam: 'gray',\n    },\n    statusIcons: {\n      new: 'MessageSquare',\n      viewed: 'Eye',\n      in_progress: 'Clock',\n      waiting_response: 'Hourglass',\n      converted: 'CircleCheckBig',\n      resolved: 'CheckCircle',\n      closed: 'XCircle',\n      spam: 'Ban',\n    },\n    pageSubtitle: 'Answer people, and follow up until they are business',\n    hideFulfillment: true,\n    hideShipping: true,\n  },\n\n  behaviorFilter: {\n    include: 'leadCapture',\n  },\n\n  editor: {\n    intrinsicBehaviors: [],\n    hiddenBehaviors: ['ticketed', 'shippable', 'rentable', 'downloadable'],\n    labels: {\n      titlePlaceholder: 'e.g. 3-bed flat, Lekki Phase 1',\n    },\n  },\n};\n"],"mappings":"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","names":[]}

package/dist/intents/catalog-stock.d.ts

@@ -0,0 +1,43 @@
+import type { ColumnDef, IntentConfig } from './types';
+/**
+ * Whether this business tracks stock at all, and the column that shows it.
+ *
+ * The catalogue read `primary.pageSections.itemList` — the archetype the
+ * merchant listed first. Only `sell-products` sets `trackInventory`, so every
+ * business that sells physical goods **alongside** something it named first
+ * lost stock entirely: no "3 left", no out-of-stock badge, and the stock filter
+ * silently dropped from the query.
+ *
+ * That is seven of the sixteen multi-archetype shapes in the walkthrough. A
+ * salon with a retail shelf, a gym selling kit, a photographer selling prints,
+ * a musician selling records — each with one catalogue holding stocked and
+ * unstocked things, and the stocked half unable to say it was running out.
+ *
+ * The page-level flag asks "does this business hold stock anywhere". The
+ * per-product `trackInventory` still decides each row: a download sitting next to
+ * a print shows "Always on" as it always did, because the badge is gated on
+ * both.
+ */
+export declare function tracksInventory(configs: IntentConfig[]): boolean;
+export declare function resolveCatalogColumns(configs: IntentConfig[], primary: IntentConfig): ColumnDef[];
+/**
+ * What the catalogue's search box says it will search.
+ *
+ * `primary.pageSections.itemList.searchPlaceholder` — so a clinic with
+ * appointments, care plans and a dispensary read **"Search services…"** over a
+ * list holding services and dispensary stock. A photographer read it over
+ * services, downloads and prints.
+ *
+ * The archetype's own words are right the moment the shelf is actually showing
+ * one archetype, which is what the filter chips are for. Narrowed to one, the
+ * box says what that chip holds. Showing everything, it names the screen —
+ * because that is what it will search.
+ */
+export declare function resolveCatalogSearchPlaceholder(configs: {
+    key: string;
+    pageSections: {
+        itemList: {
+            searchPlaceholder?: string;
+        };
+    };
+}[], activeKeys: string[], screenTitle: string): string | undefined;

package/dist/intents/catalog-stock.js

@@ -0,0 +1,43 @@
+function tracksInventory(configs) {
+  return configs.some(
+    (config) => config.pageSections.itemList.trackInventory ?? false
+  );
+}
+function catalogContributors(configs) {
+  return configs.filter(
+    (config) => config.key === "event-tickets" || config.navigation.groups.some(
+      (group) => group.items.some(
+        (item) => item.id === "catalog" && item.href.split("?")[0] === "/dashboard/catalog"
+      )
+    )
+  );
+}
+function resolveCatalogColumns(configs, primary) {
+  const contributors = catalogContributors(configs);
+  const source = contributors.includes(primary) ? primary : contributors[0] ?? primary;
+  const columns = source.pageSections.itemList.columns;
+  if (!tracksInventory(configs)) return columns;
+  if (columns.some((column) => column.key === "available")) return columns;
+  const tracking = configs.find(
+    (config) => config.pageSections.itemList.trackInventory
+  );
+  const available = tracking?.pageSections.itemList.columns.find(
+    (column) => column.key === "available"
+  );
+  if (!available) return columns;
+  const at = columns.findIndex((column) => column.key === "status");
+  if (at === -1) return [...columns, available];
+  return [...columns.slice(0, at), available, ...columns.slice(at)];
+}
+function resolveCatalogSearchPlaceholder(configs, activeKeys, screenTitle) {
+  const narrowed = activeKeys.length === 1 ? configs.find((config) => config.key === activeKeys[0]) : void 0;
+  if (narrowed) return narrowed.pageSections.itemList.searchPlaceholder;
+  if (configs.length > 1) return `Search ${screenTitle.toLowerCase()}`;
+  return configs[0]?.pageSections.itemList.searchPlaceholder;
+}
+export {
+  resolveCatalogColumns,
+  resolveCatalogSearchPlaceholder,
+  tracksInventory
+};
+//# sourceMappingURL=catalog-stock.js.map

package/dist/intents/catalog-stock.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/catalog-stock.ts"],"sourcesContent":["import type { ColumnDef, IntentConfig } from './types';\n\n/**\n * Whether this business tracks stock at all, and the column that shows it.\n *\n * The catalogue read `primary.pageSections.itemList` — the archetype the\n * merchant listed first. Only `sell-products` sets `trackInventory`, so every\n * business that sells physical goods **alongside** something it named first\n * lost stock entirely: no \"3 left\", no out-of-stock badge, and the stock filter\n * silently dropped from the query.\n *\n * That is seven of the sixteen multi-archetype shapes in the walkthrough. A\n * salon with a retail shelf, a gym selling kit, a photographer selling prints,\n * a musician selling records — each with one catalogue holding stocked and\n * unstocked things, and the stocked half unable to say it was running out.\n *\n * The page-level flag asks \"does this business hold stock anywhere\". The\n * per-product `trackInventory` still decides each row: a download sitting next to\n * a print shows \"Always on\" as it always did, because the badge is gated on\n * both.\n */\nexport function tracksInventory(configs: IntentConfig[]): boolean {\n  return configs.some(\n    (config) => config.pageSections.itemList.trackInventory ?? false,\n  );\n}\n\n/**\n * The primary archetype's columns, plus what is left is one number.\n *\n * Not the union: `sell-products` carries five stock columns (sku, quantity,\n * reserved, available, lowThreshold) and `take-bookings` carries duration, so\n * unioning gives a photographer a nine-column table where most cells are empty\n * for most rows.\n *\n * `available` is the one a merchant acts on — it is what \"3 left\" means — so\n * it joins the primary's columns when any archetype tracks stock, and the rest\n * stay where they belong, behind the chip that narrows to them.\n */\n/**\n * The archetypes whose catalogue IS this screen.\n *\n * Not every archetype that names a catalogue puts rows in `/dashboard/catalog`.\n * `subscriptions` calls its own `Plans` and points it at\n * `/dashboard/subscriptions`, and a plan is a `merchant_plans` row — a\n * different table from `content`, so it can never appear on the inventory\n * list.\n *\n * That matters because `primary` is whichever archetype last rode an\n * `?intent=` into sessionStorage, and every Back button out of a product\n * detail pushes a bare `/dashboard/catalog`. So a gym that had just looked at\n * its memberships came back to a shelf of services and kit whose columns were\n * chosen by an archetype with nothing on the shelf — and the services lost\n * their **duration** column, because `subscriptions` does not declare one.\n */\nfunction catalogContributors(configs: IntentConfig[]): IntentConfig[] {\n  return configs.filter(\n    (config) =>\n      config.key === 'event-tickets' ||\n      config.navigation.groups.some((group) =>\n        group.items.some(\n          (item) =>\n            item.id === 'catalog' &&\n            item.href.split('?')[0] === '/dashboard/catalog',\n        ),\n      ),\n  );\n}\n\nexport function resolveCatalogColumns(\n  configs: IntentConfig[],\n  primary: IntentConfig,\n): ColumnDef[] {\n  /*\n   * `primary` only when it is actually on this shelf; otherwise the first\n   * archetype that is. Falling back to `primary` when nothing contributes\n   * keeps a single-archetype business and the default shop exactly as they\n   * were — there is no better answer than the one they had.\n   */\n  const contributors = catalogContributors(configs);\n  const source = contributors.includes(primary)\n    ? primary\n    : (contributors[0] ?? primary);\n  const columns = source.pageSections.itemList.columns;\n  if (!tracksInventory(configs)) return columns;\n  if (columns.some((column) => column.key === 'available')) return columns;\n\n  const tracking = configs.find(\n    (config) => config.pageSections.itemList.trackInventory,\n  );\n  const available = tracking?.pageSections.itemList.columns.find(\n    (column) => column.key === 'available',\n  );\n  if (!available) return columns;\n\n  // Before status, which reads as the end of a row.\n  const at = columns.findIndex((column) => column.key === 'status');\n  if (at === -1) return [...columns, available];\n  return [...columns.slice(0, at), available, ...columns.slice(at)];\n}\n\n/**\n * What the catalogue's search box says it will search.\n *\n * `primary.pageSections.itemList.searchPlaceholder` — so a clinic with\n * appointments, care plans and a dispensary read **\"Search services…\"** over a\n * list holding services and dispensary stock. A photographer read it over\n * services, downloads and prints.\n *\n * The archetype's own words are right the moment the shelf is actually showing\n * one archetype, which is what the filter chips are for. Narrowed to one, the\n * box says what that chip holds. Showing everything, it names the screen —\n * because that is what it will search.\n */\nexport function resolveCatalogSearchPlaceholder(\n  configs: {\n    key: string;\n    pageSections: { itemList: { searchPlaceholder?: string } };\n  }[],\n  activeKeys: string[],\n  screenTitle: string,\n): string | undefined {\n  const narrowed =\n    activeKeys.length === 1\n      ? configs.find((config) => config.key === activeKeys[0])\n      : undefined;\n\n  if (narrowed) return narrowed.pageSections.itemList.searchPlaceholder;\n  if (configs.length > 1) return `Search ${screenTitle.toLowerCase()}`;\n  return configs[0]?.pageSections.itemList.searchPlaceholder;\n}\n"],"mappings":"AAqBO,SAAS,gBAAgB,SAAkC;AAChE,SAAO,QAAQ;AAAA,IACb,CAAC,WAAW,OAAO,aAAa,SAAS,kBAAkB;AAAA,EAC7D;AACF;AA8BA,SAAS,oBAAoB,SAAyC;AACpE,SAAO,QAAQ;AAAA,IACb,CAAC,WACC,OAAO,QAAQ,mBACf,OAAO,WAAW,OAAO;AAAA,MAAK,CAAC,UAC7B,MAAM,MAAM;AAAA,QACV,CAAC,SACC,KAAK,OAAO,aACZ,KAAK,KAAK,MAAM,GAAG,EAAE,CAAC,MAAM;AAAA,MAChC;AAAA,IACF;AAAA,EACJ;AACF;AAEO,SAAS,sBACd,SACA,SACa;AAOb,QAAM,eAAe,oBAAoB,OAAO;AAChD,QAAM,SAAS,aAAa,SAAS,OAAO,IACxC,UACC,aAAa,CAAC,KAAK;AACxB,QAAM,UAAU,OAAO,aAAa,SAAS;AAC7C,MAAI,CAAC,gBAAgB,OAAO,EAAG,QAAO;AACtC,MAAI,QAAQ,KAAK,CAAC,WAAW,OAAO,QAAQ,WAAW,EAAG,QAAO;AAEjE,QAAM,WAAW,QAAQ;AAAA,IACvB,CAAC,WAAW,OAAO,aAAa,SAAS;AAAA,EAC3C;AACA,QAAM,YAAY,UAAU,aAAa,SAAS,QAAQ;AAAA,IACxD,CAAC,WAAW,OAAO,QAAQ;AAAA,EAC7B;AACA,MAAI,CAAC,UAAW,QAAO;AAGvB,QAAM,KAAK,QAAQ,UAAU,CAAC,WAAW,OAAO,QAAQ,QAAQ;AAChE,MAAI,OAAO,GAAI,QAAO,CAAC,GAAG,SAAS,SAAS;AAC5C,SAAO,CAAC,GAAG,QAAQ,MAAM,GAAG,EAAE,GAAG,WAAW,GAAG,QAAQ,MAAM,EAAE,CAAC;AAClE;AAeO,SAAS,gCACd,SAIA,YACA,aACoB;AACpB,QAAM,WACJ,WAAW,WAAW,IAClB,QAAQ,KAAK,CAAC,WAAW,OAAO,QAAQ,WAAW,CAAC,CAAC,IACrD;AAEN,MAAI,SAAU,QAAO,SAAS,aAAa,SAAS;AACpD,MAAI,QAAQ,SAAS,EAAG,QAAO,UAAU,YAAY,YAAY,CAAC;AAClE,SAAO,QAAQ,CAAC,GAAG,aAAa,SAAS;AAC3C;","names":[]}

package/dist/intents/collapse-shared-nav.d.ts

@@ -0,0 +1,95 @@
+/**
+ * A multi-archetype business is one business, not several sharing a login.
+ *
+ * The sidebar builds one group per archetype. That is right for the work only
+ * one archetype does — Reservations, Tables, Tabs, Waitlist — and wrong for
+ * everything they have in common. A place that seats guests, does takeaway and
+ * sells its sauce got two items both called "Menu" and three called some
+ * variant of "Orders", each pointing at the same screen with a different
+ * `?intent=`.
+ *
+ * Items declare what they manage via `shares`. Anything several archetypes
+ * contribute is emitted once, unscoped — which reads as "all of it". Narrowing
+ * still exists on the screen itself: Catalog and Orders already render an
+ * intent switcher, so the repeated nav entries were duplicating a control the
+ * merchant already had in front of them.
+ */
+export interface ShareableNavItem {
+    id: string;
+    label: string;
+    /** What this manages, in the merchant's words. Absent = archetype-only. */
+    shares?: string;
+}
+/**
+ * What to call a destination once several archetypes share it.
+ *
+ * Picking one archetype's wording would be arbitrary — a combined restaurant
+ * would read "Kitchen Orders" for its dine-in covers, or "Product Orders" for
+ * its food. These are the plain nouns that stay true whichever mix is on.
+ */
+export declare const SHARED_LABELS: Record<string, string>;
+export interface CollapsedNavItem {
+    id: string;
+    label: string;
+    /** The archetype this item is scoped to, or null when it covers them all. */
+    intentKey: string | null;
+    /** Every archetype feeding this entry — one unless it was collapsed. */
+    contributedBy: string[];
+}
+/** What the sidebar needs to know about one archetype's one nav item. */
+export interface NavDecision {
+    /** False when an earlier archetype already emitted this shared entry. */
+    emit: boolean;
+    /** The wording to show: the shared noun when collapsed, the item's own otherwise. */
+    label: string;
+    /** True when this entry stands for more than one archetype, so it must not be scoped. */
+    unscoped: boolean;
+    /**
+     * True when the label is the generic noun rather than any archetype's own —
+     * the archetypes behind this row disagreed about what to call it. The row's
+     * glyph has to be generic too, or a row named "Catalog" wears the spanner
+     * that belongs to Services.
+     */
+    neutral: boolean;
+}
+/** Stable key for one item within one archetype. */
+export declare function navDecisionKey(definitionKey: string, itemId: string): string;
+/**
+ * Decide, for every item of every archetype, whether it survives collapsing and
+ * what it should be called.
+ *
+ * This is the single implementation. The sidebar renders from it and
+ * `collapseSharedNav` below reports it as a flat list for the tests that
+ * describe real businesses. It used to be written twice: once here, tested and
+ * called by nobody, and once inline in the sidebar, live and untested. Forty
+ * green tests were describing code that never ran.
+ *
+ * `single` mode decides nothing: with one archetype there is nothing to
+ * collapse, and its own wording ("Kitchen Orders" for a takeaway kitchen) is
+ * better than the generic noun.
+ */
+export declare function decideSharedNav(definitions: Array<{
+    key: string;
+    items: ShareableNavItem[];
+}>, mode: 'single' | 'multi'): Map<string, NavDecision>;
+/**
+ * Which archetypes feed the unscoped row for `itemId`.
+ *
+ * A collapsed row means "all of the ones behind it", and the screen it opens
+ * has to be able to say WHICH — asking for no intent at all is how a combined
+ * restaurant's Menu ended up listing its subscription plans, because "don't
+ * narrow to one" was implemented as "don't narrow at all".
+ *
+ * Empty when no unscoped row exists for the id.
+ */
+export declare function unscopedContributors(definitions: Array<{
+    key: string;
+    items: ShareableNavItem[];
+}>, itemId: string): string[];
+/**
+ * The same decisions as a flat list of what the merchant ends up seeing.
+ */
+export declare function collapseSharedNav(definitions: Array<{
+    key: string;
+    items: ShareableNavItem[];
+}>, mode: 'single' | 'multi'): CollapsedNavItem[];

package/dist/intents/collapse-shared-nav.js

@@ -0,0 +1,171 @@
+const SHARED_LABELS = {
+  orders: "Orders",
+  // Separate from `orders` because it is a separate screen. Appointments and
+  // reservations both open /dashboard/bookings while every other archetype's
+  // sales item opens /dashboard/orders, so sharing one key made the two
+  // destinations compete and whichever archetype was registered first silently
+  // deleted the other from the sidebar. A golf club lost its tee sheet; a spa
+  // with a kitchen lost its kitchen queue. Which one vanished depended on the
+  // order of INTENT_NAV_DEFINITIONS, which is nobody's idea of a rule.
+  bookings: "Bookings",
+  // Menu, Services, Inventory, Digital Catalog, Event Listings, Properties and
+  // Listings are ONE key because they are one screen: every one of them
+  // resolves to /dashboard/catalog and differs only by `?intent=`. Seven rows
+  // for one destination is a filter wearing the clothes of navigation, and the
+  // filter now lives on the screen (`useIntentFilter`) where it belongs.
+  //
+  // The generic word only appears when the archetypes DISAGREE — a restaurant
+  // that seats guests and does takeaway still reads "Menu", because both of its
+  // archetypes say Menu and there is no dispute to settle.
+  catalogue: "Catalog",
+  // Separate because it is a separate SCREEN: subscriptions' catalog opens
+  // /dashboard/subscriptions, not /dashboard/catalog. Path, not noun, is what
+  // makes two rows two rows.
+  plans: "Plans",
+  invoices: "Invoices",
+  waitlist: "Waitlist",
+  // One entry per share key, including the ones where every archetype already
+  // agrees on the word: a share key with no entry here is indistinguishable
+  // from a typo'd one, and this map is where the reader looks to find out what
+  // keys exist. `abandoned` is gone from it because the row is gone from the
+  // archetypes — it is Marketing's now (2026-09-03), and a spine row shares
+  // nothing.
+  "calendar-sync": "Scheduling",
+  // Tables, courts, rooms and studios are all rows in the same resource pool.
+  // A golf club running dine-in and tee-times books both from one screen.
+  resources: "Resources",
+  inquiries: "Enquiries",
+  // One day board serves the whole business. A golf club running tee-times and
+  // a dining room has one floor to run at 7pm, not two.
+  today: "Today"
+};
+function navDecisionKey(definitionKey, itemId) {
+  return `${definitionKey}:${itemId}`;
+}
+function decideSharedNav(definitions, mode) {
+  const decisions = /* @__PURE__ */ new Map();
+  const claimedBy = /* @__PURE__ */ new Map();
+  for (const definition of definitions) {
+    for (const item of definition.items) {
+      const key = navDecisionKey(definition.key, item.id);
+      if (mode === "single" || !item.shares) {
+        decisions.set(key, {
+          emit: true,
+          label: item.label,
+          unscoped: mode === "single",
+          neutral: false
+        });
+        continue;
+      }
+      const claimant = claimedBy.get(item.shares);
+      if (claimant) {
+        decisions.set(key, {
+          emit: false,
+          label: item.label,
+          unscoped: true,
+          neutral: false
+        });
+        const claimantKey = navDecisionKey(claimant, item.id);
+        const claimed = decisions.get(claimantKey);
+        if (claimed) claimed.unscoped = true;
+        continue;
+      }
+      claimedBy.set(item.shares, definition.key);
+      decisions.set(key, {
+        emit: true,
+        label: SHARED_LABELS[item.shares] ?? item.label,
+        unscoped: false,
+        neutral: !!SHARED_LABELS[item.shares]
+      });
+    }
+  }
+  const emitted = [...claimedBy].flatMap(([shareKey, claimant]) => {
+    const decision = decisions.get(
+      navDecisionKey(
+        claimant,
+        definitions.find((d) => d.key === claimant).items.find((i) => i.shares === shareKey).id
+      )
+    );
+    return decision ? [{ shareKey, decision }] : [];
+  });
+  for (const { shareKey, decision } of emitted) {
+    const contributed = definitions.flatMap(
+      (d) => d.items.filter((i) => i.shares === shareKey).map((i) => i.label)
+    );
+    const counted = /* @__PURE__ */ new Map();
+    for (const label of contributed)
+      counted.set(label, (counted.get(label) ?? 0) + 1);
+    const [leader, votes] = [...counted].reduce(
+      (best, entry) => entry[1] > best[1] ? entry : best
+    );
+    if (votes * 2 > contributed.length) {
+      decision.label = leader;
+      decision.neutral = false;
+    }
+  }
+  const counts = /* @__PURE__ */ new Map();
+  for (const decision of decisions.values())
+    if (decision.emit)
+      counts.set(decision.label, (counts.get(decision.label) ?? 0) + 1);
+  for (const { shareKey, decision } of emitted) {
+    if ((counts.get(decision.label) ?? 0) < 2) continue;
+    const generic = SHARED_LABELS[shareKey];
+    if (!generic || generic === decision.label) continue;
+    counts.set(decision.label, (counts.get(decision.label) ?? 1) - 1);
+    decision.label = generic;
+    decision.neutral = true;
+  }
+  return decisions;
+}
+function unscopedContributors(definitions, itemId) {
+  const decisions = decideSharedNav(definitions, "multi");
+  let shareKey;
+  for (const definition of definitions) {
+    for (const item of definition.items) {
+      if (item.id !== itemId) continue;
+      const decision = decisions.get(navDecisionKey(definition.key, item.id));
+      if (decision?.emit && decision.unscoped) shareKey = item.shares;
+    }
+  }
+  if (!shareKey) return [];
+  return definitions.filter(
+    (d) => d.items.some((i) => i.id === itemId && i.shares === shareKey)
+  ).map((d) => d.key);
+}
+function collapseSharedNav(definitions, mode) {
+  const decisions = decideSharedNav(definitions, mode);
+  const out = [];
+  const bySharedKey = /* @__PURE__ */ new Map();
+  for (const definition of definitions) {
+    for (const item of definition.items) {
+      const decision = decisions.get(navDecisionKey(definition.key, item.id));
+      if (!decision) continue;
+      if (!decision.emit) {
+        const owner = item.shares ? bySharedKey.get(item.shares) : void 0;
+        if (owner) {
+          owner.contributedBy.push(definition.key);
+          owner.intentKey = null;
+        }
+        continue;
+      }
+      const collapsed = {
+        id: item.id,
+        label: decision.label,
+        intentKey: mode === "multi" && !decision.unscoped ? definition.key : null,
+        contributedBy: [definition.key]
+      };
+      if (mode === "multi" && item.shares)
+        bySharedKey.set(item.shares, collapsed);
+      out.push(collapsed);
+    }
+  }
+  return out;
+}
+export {
+  SHARED_LABELS,
+  collapseSharedNav,
+  decideSharedNav,
+  navDecisionKey,
+  unscopedContributors
+};
+//# sourceMappingURL=collapse-shared-nav.js.map