@withpotter/components 0.13.0-next.101

package/dist/shell/workspace-mark.d.ts

@@ -0,0 +1,22 @@
+/**
+ * A workspace's picture: the real logo when one is set, otherwise the name's
+ * own generated gradient with its initial on top.
+ *
+ * The fallback used to be a flat tile on one shared blue, so "John's kitchen"
+ * and "John and Sons' Hotels" rendered as two identical blue J's — the exact
+ * confusion a picture is there to prevent. The gradient is derived from the
+ * name, so no two workspaces land on the same mark.
+ *
+ * A module of its own because the switcher draws it at three sizes now — the
+ * trigger, its own header block, and every row of the switch list — and the
+ * file was at the 500-line house limit with the mark inlined in it.
+ *
+ * `className` rather than a size prop: the geometry belongs to the surface
+ * (`wmark` on the trigger, `pv-psw-ic` in the menu, both in shell.css), and
+ * the initial is absolutely positioned inside whichever one it lands in.
+ */
+export declare function WorkspaceMark({ className, logo, label, }: {
+    className: string;
+    logo?: string | null;
+    label?: string | null;
+}): import("react").JSX.Element;

package/dist/shell/workspace-mark.js

@@ -0,0 +1,20 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { generatedAvatarUri } from "@withpotter/ui-kit/generated-avatar";
+function WorkspaceMark({
+  className,
+  logo,
+  label
+}) {
+  const initial = label?.trim()?.[0]?.toUpperCase() ?? "B";
+  return /* @__PURE__ */ jsx("span", { className, "aria-hidden": "true", children: logo ? (
+    // eslint-disable-next-line @next/next/no-img-element
+    /* @__PURE__ */ jsx("img", { src: logo, alt: "" })
+  ) : /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("img", { src: generatedAvatarUri(label || "potter"), alt: "" }),
+    /* @__PURE__ */ jsx("span", { className: "pv-psw-initial", children: initial })
+  ] }) });
+}
+export {
+  WorkspaceMark
+};
+//# sourceMappingURL=workspace-mark.js.map

package/dist/shell/workspace-mark.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shell/workspace-mark.tsx"],"sourcesContent":["import { generatedAvatarUri } from '@withpotter/ui-kit/generated-avatar';\n\n/**\n * A workspace's picture: the real logo when one is set, otherwise the name's\n * own generated gradient with its initial on top.\n *\n * The fallback used to be a flat tile on one shared blue, so \"John's kitchen\"\n * and \"John and Sons' Hotels\" rendered as two identical blue J's — the exact\n * confusion a picture is there to prevent. The gradient is derived from the\n * name, so no two workspaces land on the same mark.\n *\n * A module of its own because the switcher draws it at three sizes now — the\n * trigger, its own header block, and every row of the switch list — and the\n * file was at the 500-line house limit with the mark inlined in it.\n *\n * `className` rather than a size prop: the geometry belongs to the surface\n * (`wmark` on the trigger, `pv-psw-ic` in the menu, both in shell.css), and\n * the initial is absolutely positioned inside whichever one it lands in.\n */\nexport function WorkspaceMark({\n  className,\n  logo,\n  label,\n}: {\n  className: string;\n  logo?: string | null;\n  label?: string | null;\n}) {\n  const initial = label?.trim()?.[0]?.toUpperCase() ?? 'B';\n\n  return (\n    <span className={className} aria-hidden=\"true\">\n      {logo ? (\n        // eslint-disable-next-line @next/next/no-img-element\n        <img src={logo} alt=\"\" />\n      ) : (\n        <>\n          {/* eslint-disable-next-line @next/next/no-img-element */}\n          <img src={generatedAvatarUri(label || 'potter')} alt=\"\" />\n          <span className=\"pv-psw-initial\">{initial}</span>\n        </>\n      )}\n    </span>\n  );\n}\n"],"mappings":"AAkCQ,SAEA,UAFA,KAEA,YAFA;AAlCR,SAAS,0BAA0B;AAmB5B,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,QAAM,UAAU,OAAO,KAAK,IAAI,CAAC,GAAG,YAAY,KAAK;AAErD,SACE,oBAAC,UAAK,WAAsB,eAAY,QACrC;AAAA;AAAA,IAEC,oBAAC,SAAI,KAAK,MAAM,KAAI,IAAG;AAAA,MAEvB,iCAEE;AAAA,wBAAC,SAAI,KAAK,mBAAmB,SAAS,QAAQ,GAAG,KAAI,IAAG;AAAA,IACxD,oBAAC,UAAK,WAAU,kBAAkB,mBAAQ;AAAA,KAC5C,GAEJ;AAEJ;","names":[]}

package/dist/sidebar/active-href.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Which sidebar row the current URL lights up.
+ *
+ * Pulled out of `sidebar.tsx` so it can be tested at all: it is pure — a URL
+ * and a list of hrefs in, one href out — and every bug it has ever had was a
+ * row lighting for its neighbour, which nothing could assert on while it lived
+ * inside the component.
+ */
+export interface SidebarLocation {
+    pathname: string;
+    /** The current URL's query. */
+    params: URLSearchParams;
+    /**
+     * Which archetypes the URL is narrowed to, or null when the workspace runs
+     * a single archetype. See `sidebar.tsx` for why this is not
+     * `intentConfig.primary`.
+     */
+    currentIntent: Set<string> | null;
+}
+/** Does this row lead to the screen we are on, ignoring how it is narrowed? */
+export declare const matchesPath: (href: string, { pathname }: SidebarLocation) => boolean;
+export declare const isActive: (href: string, location: SidebarLocation) => boolean;
+/**
+ * Exactly one row carries the active highlight: the deepest matching row,
+ * hub children included, so the sub-page you are on lights rather than only
+ * its hub. Keeping it unique lets the shared motion indicator spring cleanly.
+ */
+export declare const resolveActiveHref: (hrefs: string[], rawLocation: SidebarLocation) => string | null;

package/dist/sidebar/active-href.js

@@ -0,0 +1,44 @@
+import { EXACT_MATCH_ROUTES, parseSidebarHref, intentKeySet } from "./config";
+const matchesPath = (href, { pathname }) => {
+  const { path } = parseSidebarHref(href);
+  return pathname === path || !EXACT_MATCH_ROUTES.has(path) && pathname.startsWith(path + "/");
+};
+const isActive = (href, location) => {
+  const { intent, params } = parseSidebarHref(href);
+  if (!matchesPath(href, location)) return false;
+  for (const [key, value] of params) {
+    if (key === "intent") continue;
+    if (location.params.get(key) !== value) return false;
+  }
+  if (!intent || !location.currentIntent) return true;
+  const rowIntent = intentKeySet(intent);
+  if (rowIntent.size !== location.currentIntent.size) return false;
+  for (const key of rowIntent)
+    if (!location.currentIntent.has(key)) return false;
+  return true;
+};
+const BELONGS_TO = [
+  ["/dashboard/templates", "/dashboard/business"],
+  // Bank accounts (and a recipient's page under it) is opened from the Wallet's header and has no
+  // row of its own, so it lit nothing. It answers as the Wallet row, which is where it was opened.
+  ["/dashboard/accounts", "/dashboard/wallet"]
+];
+const asHubOf = (location) => {
+  const own = BELONGS_TO.find(
+    ([prefix]) => location.pathname === prefix || location.pathname.startsWith(prefix + "/")
+  );
+  return own ? { ...location, pathname: own[1] } : location;
+};
+const resolveActiveHref = (hrefs, rawLocation) => {
+  const location = asHubOf(rawLocation);
+  if (location.pathname === "/dashboard/ask") return null;
+  const exact = hrefs.filter((h) => isActive(h, location)).sort((a, b) => b.length - a.length)[0];
+  if (exact) return exact;
+  return hrefs.filter((h) => matchesPath(h, location)).sort((a, b) => b.length - a.length)[0] ?? null;
+};
+export {
+  isActive,
+  matchesPath,
+  resolveActiveHref
+};
+//# sourceMappingURL=active-href.js.map

package/dist/sidebar/active-href.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sidebar/active-href.ts"],"sourcesContent":["import { EXACT_MATCH_ROUTES, parseSidebarHref, intentKeySet } from './config';\n\n/**\n * Which sidebar row the current URL lights up.\n *\n * Pulled out of `sidebar.tsx` so it can be tested at all: it is pure — a URL\n * and a list of hrefs in, one href out — and every bug it has ever had was a\n * row lighting for its neighbour, which nothing could assert on while it lived\n * inside the component.\n */\nexport interface SidebarLocation {\n  pathname: string;\n  /** The current URL's query. */\n  params: URLSearchParams;\n  /**\n   * Which archetypes the URL is narrowed to, or null when the workspace runs\n   * a single archetype. See `sidebar.tsx` for why this is not\n   * `intentConfig.primary`.\n   */\n  currentIntent: Set<string> | null;\n}\n\n/** Does this row lead to the screen we are on, ignoring how it is narrowed? */\nexport const matchesPath = (href: string, { pathname }: SidebarLocation) => {\n  const { path } = parseSidebarHref(href);\n  return (\n    pathname === path ||\n    (!EXACT_MATCH_ROUTES.has(path) && pathname.startsWith(path + '/'))\n  );\n};\n\nexport const isActive = (href: string, location: SidebarLocation) => {\n  const { intent, params } = parseSidebarHref(href);\n\n  if (!matchesPath(href, location)) return false;\n\n  /**\n   * A row that narrows by a query param is the row for THAT narrowing, never\n   * for its neighbour's.\n   *\n   * This used to check `group` alone, and every other param a row carried was\n   * invisible to it. Members is `/dashboard/subscriptions?tab=subscribers` and\n   * the hub landing is the same path bare, so on the Plans tab both matched\n   * and the longest-href tie-break below handed the highlight to Members — the\n   * merchant clicked Plans and watched a different row light up.\n   *\n   * `intent` is excluded because it is a SET, compared below.\n   */\n  for (const [key, value] of params) {\n    if (key === 'intent') continue;\n    if (location.params.get(key) !== value) return false;\n  }\n\n  if (!intent || !location.currentIntent) return true;\n\n  // A narrowed row matches only the exact set it narrows to. A bare row still\n  // matches the path, and loses to the narrowed one on the longest-href\n  // tie-break — so the hub landing carries the highlight only when nothing\n  // more specific claims it.\n  const rowIntent = intentKeySet(intent);\n  if (rowIntent.size !== location.currentIntent.size) return false;\n  for (const key of rowIntent)\n    if (!location.currentIntent.has(key)) return false;\n  return true;\n};\n\n/**\n * Screens that are part of another row's job and have no row of their own.\n *\n * Changing the template is reached from the Website hub and returns to it, so\n * it is not duplicated in the nav (see `spine-website.ts`). Without a row it\n * lit nothing and the Website group stayed shut, which read as being nowhere.\n * It answers as the hub, so \"Your site\" stays lit and the group stays open.\n */\nconst BELONGS_TO: [prefix: string, hub: string][] = [\n  ['/dashboard/templates', '/dashboard/business'],\n  // Bank accounts (and a recipient's page under it) is opened from the Wallet's header and has no\n  // row of its own, so it lit nothing. It answers as the Wallet row, which is where it was opened.\n  ['/dashboard/accounts', '/dashboard/wallet'],\n];\n\nconst asHubOf = (location: SidebarLocation): SidebarLocation => {\n  const own = BELONGS_TO.find(\n    ([prefix]) =>\n      location.pathname === prefix ||\n      location.pathname.startsWith(prefix + '/'),\n  );\n  return own ? { ...location, pathname: own[1] } : location;\n};\n\n/**\n * Exactly one row carries the active highlight: the deepest matching row,\n * hub children included, so the sub-page you are on lights rather than only\n * its hub. Keeping it unique lets the shared motion indicator spring cleanly.\n */\nexport const resolveActiveHref = (\n  hrefs: string[],\n  rawLocation: SidebarLocation,\n): string | null => {\n  const location = asHubOf(rawLocation);\n  // The ask screen is not a nav destination and lit HOME without this: it\n  // matches no href exactly, so the path-prefix fallback below handed it\n  // `/dashboard`. A wrong answer to \"where am I\" is one you act on, and the\n  // screen carries its own way back instead.\n  if (location.pathname === '/dashboard/ask') return null;\n\n  const exact = hrefs\n    .filter((h) => isActive(h, location))\n    .sort((a, b) => b.length - a.length)[0];\n  if (exact) return exact;\n\n  /**\n   * Nothing matched exactly, and we are on a screen with no `?intent=`.\n   *\n   * A collapsed row carries every archetype behind it, so it can never match a\n   * URL that carries none — and after the catalogue rework there is no bare row\n   * left to fall back to. So a merchant landing on `/dashboard/catalog` from a\n   * plain link, a redirect, or the \"Everything\" filter had a sidebar with\n   * NOTHING lit: the page they were on had no row.\n   *\n   * Unnarrowed means every archetype on that screen, which is exactly what the\n   * collapsed row stands for. Match on the path alone and let the longest-href\n   * tie-break pick one, so the answer stays deterministic.\n   */\n  return (\n    hrefs\n      .filter((h) => matchesPath(h, location))\n      .sort((a, b) => b.length - a.length)[0] ?? null\n  );\n};\n"],"mappings":"AAAA,SAAS,oBAAoB,kBAAkB,oBAAoB;AAuB5D,MAAM,cAAc,CAAC,MAAc,EAAE,SAAS,MAAuB;AAC1E,QAAM,EAAE,KAAK,IAAI,iBAAiB,IAAI;AACtC,SACE,aAAa,QACZ,CAAC,mBAAmB,IAAI,IAAI,KAAK,SAAS,WAAW,OAAO,GAAG;AAEpE;AAEO,MAAM,WAAW,CAAC,MAAc,aAA8B;AACnE,QAAM,EAAE,QAAQ,OAAO,IAAI,iBAAiB,IAAI;AAEhD,MAAI,CAAC,YAAY,MAAM,QAAQ,EAAG,QAAO;AAczC,aAAW,CAAC,KAAK,KAAK,KAAK,QAAQ;AACjC,QAAI,QAAQ,SAAU;AACtB,QAAI,SAAS,OAAO,IAAI,GAAG,MAAM,MAAO,QAAO;AAAA,EACjD;AAEA,MAAI,CAAC,UAAU,CAAC,SAAS,cAAe,QAAO;AAM/C,QAAM,YAAY,aAAa,MAAM;AACrC,MAAI,UAAU,SAAS,SAAS,cAAc,KAAM,QAAO;AAC3D,aAAW,OAAO;AAChB,QAAI,CAAC,SAAS,cAAc,IAAI,GAAG,EAAG,QAAO;AAC/C,SAAO;AACT;AAUA,MAAM,aAA8C;AAAA,EAClD,CAAC,wBAAwB,qBAAqB;AAAA;AAAA;AAAA,EAG9C,CAAC,uBAAuB,mBAAmB;AAC7C;AAEA,MAAM,UAAU,CAAC,aAA+C;AAC9D,QAAM,MAAM,WAAW;AAAA,IACrB,CAAC,CAAC,MAAM,MACN,SAAS,aAAa,UACtB,SAAS,SAAS,WAAW,SAAS,GAAG;AAAA,EAC7C;AACA,SAAO,MAAM,EAAE,GAAG,UAAU,UAAU,IAAI,CAAC,EAAE,IAAI;AACnD;AAOO,MAAM,oBAAoB,CAC/B,OACA,gBACkB;AAClB,QAAM,WAAW,QAAQ,WAAW;AAKpC,MAAI,SAAS,aAAa,iBAAkB,QAAO;AAEnD,QAAM,QAAQ,MACX,OAAO,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC,EACnC,KAAK,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AACxC,MAAI,MAAO,QAAO;AAelB,SACE,MACG,OAAO,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC,EACtC,KAAK,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,KAAK;AAEjD;","names":[]}

package/dist/sidebar/archetype-collections.d.ts

@@ -0,0 +1,44 @@
+import type { IntentConfig } from '@withpotter/lib/intents/types';
+import type { NavGroup, NavItem } from './config';
+/**
+ * Where an archetype's own Collections lives: UNDER the archetype.
+ *
+ * A collection belongs to one archetype (John, 2026-10-11), and Collections is
+ * a sub-nav under its archetype in every case. With a single archetype on it is
+ * the whole catalogue, so the child links to the bare address. With two or more,
+ * one row opening one list reads as "all of it" and hides the fact that a
+ * collection of events and a collection of products are different things the
+ * merchant manages separately. So each active archetype carries its own
+ * Collections child, scoped to it.
+ *
+ * `decideSharedNav` is not involved and never was: no config gives Collections
+ * a `shares` key, so it has never been folded into a shared row. What produced
+ * the single general row was `build-nav-groups` building one item for the
+ * whole business. This replaces that item in multi mode and leaves it alone
+ * otherwise.
+ *
+ * The child is attached to the archetype's own row (Products, Events), not to
+ * a row for the catalogue: a composed archetype's row IS its hub, and its
+ * children render as the nested list under it. The page you are on lights its
+ * row and opens its archetype automatically, because `renderHub` opens the
+ * hub that owns the active href.
+ */
+/** The scoped link the Collections screen reads its archetype from. */
+export declare const collectionsHref: (intentKey: string) => string;
+/**
+ * Attach a scoped Collections child to every archetype row that can have one.
+ * Mutates nothing it was given; returns the new groups and how many rows got
+ * a child, so the caller knows whether the shared row is still needed.
+ */
+export declare function attachArchetypeCollections({ groups, configs, hidden, enabledBehaviors, base, filterItems, }: {
+    groups: NavGroup[];
+    configs: IntentConfig[];
+    hidden: Set<string>;
+    enabledBehaviors: readonly string[];
+    /** The Collections row the business would otherwise have: icon, permission. */
+    base: Pick<NavItem, 'id' | 'name' | 'icon' | 'requiredPermission'>;
+    filterItems: (items: NavItem[]) => NavItem[];
+}): {
+    groups: NavGroup[];
+    attached: number;
+};

package/dist/sidebar/archetype-collections.js

@@ -0,0 +1,50 @@
+const collectionsHref = (intentKey) => `/dashboard/collections?intent=${encodeURIComponent(intentKey)}`;
+function attachArchetypeCollections({
+  groups,
+  configs,
+  hidden,
+  enabledBehaviors,
+  base,
+  filterItems
+}) {
+  if (configs.length < 1 || hidden.has("collections"))
+    return { groups, attached: 0 };
+  const scoped = configs.length >= 2;
+  const byKey = new Map(configs.map((config) => [config.key, config]));
+  let attached = 0;
+  const next = groups.map((group) => {
+    const config = byKey.get(group.id);
+    const row = group.items?.[0];
+    if (!config || !row || group.items?.length !== 1) return group;
+    const declared = config.navigation.groups.flatMap((g) => g.items).find((item) => item.id === "collections");
+    if (!declared) return group;
+    if (declared.requiredBehavior && !declared.requiredBehavior.some((b) => enabledBehaviors.includes(b)))
+      return group;
+    const [child] = filterItems([
+      {
+        ...base,
+        href: scoped ? collectionsHref(config.key) : "/dashboard/collections"
+      }
+    ]);
+    if (!child) return group;
+    attached += 1;
+    return {
+      ...group,
+      items: [
+        {
+          ...row,
+          children: [...row.children ?? [], child],
+          // A row with no children of its own has never rendered a landing
+          // row, so it names none; the hub needs one once it has a child.
+          landingLabel: row.landingLabel ?? "All {label}"
+        }
+      ]
+    };
+  });
+  return { groups: next, attached };
+}
+export {
+  attachArchetypeCollections,
+  collectionsHref
+};
+//# sourceMappingURL=archetype-collections.js.map

package/dist/sidebar/archetype-collections.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sidebar/archetype-collections.ts"],"sourcesContent":["import type { IntentConfig } from '@withpotter/lib/intents/types';\nimport type { NavGroup, NavItem } from './config';\n\n/**\n * Where an archetype's own Collections lives: UNDER the archetype.\n *\n * A collection belongs to one archetype (John, 2026-10-11), and Collections is\n * a sub-nav under its archetype in every case. With a single archetype on it is\n * the whole catalogue, so the child links to the bare address. With two or more,\n * one row opening one list reads as \"all of it\" and hides the fact that a\n * collection of events and a collection of products are different things the\n * merchant manages separately. So each active archetype carries its own\n * Collections child, scoped to it.\n *\n * `decideSharedNav` is not involved and never was: no config gives Collections\n * a `shares` key, so it has never been folded into a shared row. What produced\n * the single general row was `build-nav-groups` building one item for the\n * whole business. This replaces that item in multi mode and leaves it alone\n * otherwise.\n *\n * The child is attached to the archetype's own row (Products, Events), not to\n * a row for the catalogue: a composed archetype's row IS its hub, and its\n * children render as the nested list under it. The page you are on lights its\n * row and opens its archetype automatically, because `renderHub` opens the\n * hub that owns the active href.\n */\n\n/** The scoped link the Collections screen reads its archetype from. */\nexport const collectionsHref = (intentKey: string) =>\n  `/dashboard/collections?intent=${encodeURIComponent(intentKey)}`;\n\n/**\n * Attach a scoped Collections child to every archetype row that can have one.\n * Mutates nothing it was given; returns the new groups and how many rows got\n * a child, so the caller knows whether the shared row is still needed.\n */\nexport function attachArchetypeCollections({\n  groups,\n  configs,\n  hidden,\n  enabledBehaviors,\n  base,\n  filterItems,\n}: {\n  groups: NavGroup[];\n  configs: IntentConfig[];\n  hidden: Set<string>;\n  enabledBehaviors: readonly string[];\n  /** The Collections row the business would otherwise have: icon, permission. */\n  base: Pick<NavItem, 'id' | 'name' | 'icon' | 'requiredPermission'>;\n  filterItems: (items: NavItem[]) => NavItem[];\n}): { groups: NavGroup[]; attached: number } {\n  if (configs.length < 1 || hidden.has('collections'))\n    return { groups, attached: 0 };\n  // One archetype owns every collection, so its link needs no narrowing: the\n  // bare address keeps old links and bookmarks working. Two or more narrow.\n  const scoped = configs.length >= 2;\n\n  const byKey = new Map(configs.map((config) => [config.key, config]));\n  let attached = 0;\n\n  const next = groups.map((group) => {\n    const config = byKey.get(group.id);\n    const row = group.items?.[0];\n    if (!config || !row || group.items?.length !== 1) return group;\n\n    // The archetype's own declaration decides whether it has Collections at\n    // all, and its behaviour gate still applies — same rule `isAllowed` holds\n    // the generic items to when the legacy builder renders them.\n    const declared = config.navigation.groups\n      .flatMap((g) => g.items)\n      .find((item) => item.id === 'collections');\n    if (!declared) return group;\n    if (\n      declared.requiredBehavior &&\n      !declared.requiredBehavior.some((b) => enabledBehaviors.includes(b))\n    )\n      return group;\n\n    // Through filterItems, so the permission gate and any rename reach the\n    // scoped row exactly as they reach the shared one.\n    const [child] = filterItems([\n      {\n        ...base,\n        href: scoped ? collectionsHref(config.key) : '/dashboard/collections',\n      } as NavItem,\n    ]);\n    if (!child) return group;\n\n    attached += 1;\n    return {\n      ...group,\n      items: [\n        {\n          ...row,\n          children: [...(row.children ?? []), child],\n          // A row with no children of its own has never rendered a landing\n          // row, so it names none; the hub needs one once it has a child.\n          landingLabel: row.landingLabel ?? 'All {label}',\n        },\n      ],\n    };\n  });\n\n  return { groups: next, attached };\n}\n"],"mappings":"AA4BO,MAAM,kBAAkB,CAAC,cAC9B,iCAAiC,mBAAmB,SAAS,CAAC;AAOzD,SAAS,2BAA2B;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAQ6C;AAC3C,MAAI,QAAQ,SAAS,KAAK,OAAO,IAAI,aAAa;AAChD,WAAO,EAAE,QAAQ,UAAU,EAAE;AAG/B,QAAM,SAAS,QAAQ,UAAU;AAEjC,QAAM,QAAQ,IAAI,IAAI,QAAQ,IAAI,CAAC,WAAW,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;AACnE,MAAI,WAAW;AAEf,QAAM,OAAO,OAAO,IAAI,CAAC,UAAU;AACjC,UAAM,SAAS,MAAM,IAAI,MAAM,EAAE;AACjC,UAAM,MAAM,MAAM,QAAQ,CAAC;AAC3B,QAAI,CAAC,UAAU,CAAC,OAAO,MAAM,OAAO,WAAW,EAAG,QAAO;AAKzD,UAAM,WAAW,OAAO,WAAW,OAChC,QAAQ,CAAC,MAAM,EAAE,KAAK,EACtB,KAAK,CAAC,SAAS,KAAK,OAAO,aAAa;AAC3C,QAAI,CAAC,SAAU,QAAO;AACtB,QACE,SAAS,oBACT,CAAC,SAAS,iBAAiB,KAAK,CAAC,MAAM,iBAAiB,SAAS,CAAC,CAAC;AAEnE,aAAO;AAIT,UAAM,CAAC,KAAK,IAAI,YAAY;AAAA,MAC1B;AAAA,QACE,GAAG;AAAA,QACH,MAAM,SAAS,gBAAgB,OAAO,GAAG,IAAI;AAAA,MAC/C;AAAA,IACF,CAAC;AACD,QAAI,CAAC,MAAO,QAAO;AAEnB,gBAAY;AACZ,WAAO;AAAA,MACL,GAAG;AAAA,MACH,OAAO;AAAA,QACL;AAAA,UACE,GAAG;AAAA,UACH,UAAU,CAAC,GAAI,IAAI,YAAY,CAAC,GAAI,KAAK;AAAA;AAAA;AAAA,UAGzC,cAAc,IAAI,gBAAgB;AAAA,QACpC;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAC;AAED,SAAO,EAAE,QAAQ,MAAM,SAAS;AAClC;","names":[]}

package/dist/sidebar/build-intent-groups.d.ts

@@ -0,0 +1,12 @@
+import type { useIntentConfig } from '@withpotter/lib/intents/use-intent-config';
+import type { resolveEnabledBehaviors } from '@withpotter/lib/resolve-enabled-behaviors';
+import { type NavItem, type NavGroup } from './config';
+export declare function buildIntentGroups({ intentConfig, hidden, enabledBehaviors, filterItems, }: {
+    intentConfig: ReturnType<typeof useIntentConfig>;
+    hidden: Set<string>;
+    enabledBehaviors: ReturnType<typeof resolveEnabledBehaviors>;
+    filterItems: (items: NavItem[]) => NavItem[];
+}): {
+    intentGroups: NavGroup[];
+    sharedRows: NavItem[];
+};

package/dist/sidebar/build-intent-groups.js

@@ -0,0 +1,227 @@
+import { Package, Receipt } from "lucide-react";
+import { INTENT_NAV_DEFINITIONS } from "@withpotter/lib/intents/intent-nav";
+import {
+  renderedNavLabels,
+  warnOnUnreachableNavItems
+} from "@withpotter/lib/intents/nav-coverage";
+import {
+  decideSharedNav,
+  navDecisionKey,
+  unscopedContributors
+} from "@withpotter/lib/intents/collapse-shared-nav";
+import { buildComposedGroups, COMPOSED_INTENT_KEYS } from "./composed-groups";
+import {
+  ICON_MAP,
+  INTENT_ITEM_PERMISSIONS
+} from "./config";
+const NEUTRAL_ICONS = {
+  catalog: Package,
+  orders: Receipt
+};
+function buildIntentGroups({
+  intentConfig,
+  hidden,
+  enabledBehaviors,
+  filterItems
+}) {
+  const isMulti = intentConfig.mode === "multi";
+  const everyIntent = intentConfig.mode === "multi" ? intentConfig.all : [intentConfig.primary];
+  const activeIntents = everyIntent.filter(
+    (config) => !COMPOSED_INTENT_KEYS.has(config.key)
+  );
+  const intentsByKey = new Map(
+    activeIntents.map((config) => [config.key, config])
+  );
+  const isAllowed = (item) => {
+    if (item.generic) {
+      if (hidden.has(item.id)) return false;
+      if (item.requiredBehavior && !item.requiredBehavior.some(
+        (b) => enabledBehaviors.includes(b)
+      ))
+        return false;
+    }
+    return true;
+  };
+  const withIntent = (href, intent) => {
+    const [path, query] = href.split("?");
+    const params = new URLSearchParams(query ?? "");
+    params.set("intent", intent);
+    return `${path}?${params.toString()}`;
+  };
+  const buildIntentHref = (href, intentKey) => isMulti ? withIntent(href, intentKey) : href;
+  const stripIntent = (href) => {
+    const [path, query] = href.split("?");
+    const params = new URLSearchParams(query ?? "");
+    params.delete("intent");
+    const rest = params.toString();
+    return rest ? `${path}?${rest}` : path;
+  };
+  const findIntentNavItem = (config, itemId) => {
+    for (const group of config.navigation.groups) {
+      const match = group.items.find((item) => item.id === itemId);
+      if (match) return match;
+    }
+    return void 0;
+  };
+  const buildIntentItem = (config, itemId, label, iconOverride) => {
+    const item = findIntentNavItem(config, itemId);
+    if (!item || !isAllowed(item)) return null;
+    return {
+      id: item.id,
+      name: label,
+      href: buildIntentHref(item.href, config.key),
+      icon: iconOverride ?? ICON_MAP[item.icon] ?? Package,
+      requiredBehavior: item.requiredBehavior,
+      requiredPermission: INTENT_ITEM_PERMISSIONS[item.id]
+    };
+  };
+  const intentDefinitions = activeIntents.map(
+    (config) => INTENT_NAV_DEFINITIONS.find(
+      (definition) => definition.key === config.key
+    )
+  ).filter(
+    (definition) => Boolean(definition)
+  );
+  warnOnUnreachableNavItems(renderedNavLabels());
+  const decisionDefinitions = intentDefinitions.map((definition) => ({
+    ...definition,
+    items: definition.items.flatMap((item) => [item, ...item.children ?? []])
+  }));
+  const navDecisions = decideSharedNav(
+    decisionDefinitions,
+    isMulti ? "multi" : "single"
+  );
+  const sharedRows = [];
+  const orphanedChildren = /* @__PURE__ */ new Map();
+  if (isMulti) {
+    for (const definition of intentDefinitions) {
+      const config = intentsByKey.get(definition.key);
+      if (!config) continue;
+      for (const item of definition.items) {
+        const decision = navDecisions.get(
+          navDecisionKey(definition.key, item.id)
+        );
+        if (decision?.emit || !item.children?.length) continue;
+        const children = filterItems(
+          item.children.map((child) => {
+            const childDecision = navDecisions.get(
+              navDecisionKey(definition.key, child.id)
+            );
+            if (childDecision && !childDecision.emit) return null;
+            return buildIntentItem(
+              config,
+              child.id,
+              childDecision?.emit ? childDecision.label : child.label,
+              child.icon
+            );
+          }).filter(Boolean)
+        );
+        const orphanKey = item.shares ?? item.id;
+        if (children.length)
+          orphanedChildren.set(orphanKey, [
+            ...orphanedChildren.get(orphanKey) ?? [],
+            ...children
+          ]);
+      }
+    }
+  }
+  const intentGroups = intentDefinitions.flatMap((definition) => {
+    const config = intentsByKey.get(definition.key);
+    if (!config) return [];
+    const items = filterItems(
+      definition.items.map((item) => {
+        const decision = navDecisions.get(
+          navDecisionKey(definition.key, item.id)
+        );
+        if (!decision?.emit) return null;
+        const built = buildIntentItem(
+          config,
+          item.id,
+          decision.label,
+          decision.neutral ? NEUTRAL_ICONS[item.id] ?? Package : item.icon
+        );
+        if (!built) return null;
+        const children = filterItems(
+          (item.children ?? []).map((child) => {
+            const childDecision = navDecisions.get(
+              navDecisionKey(definition.key, child.id)
+            );
+            if (isMulti && childDecision && !childDecision.emit)
+              return null;
+            const kid = buildIntentItem(
+              config,
+              child.id,
+              childDecision?.emit ? childDecision.label : child.label,
+              child.icon
+            );
+            if (!kid || !isMulti || !childDecision?.unscoped) return kid;
+            const behind = unscopedContributors(
+              intentDefinitions,
+              child.id
+            );
+            return {
+              ...kid,
+              href: behind.length ? withIntent(stripIntent(kid.href), behind.join(",")) : stripIntent(kid.href)
+            };
+          }).filter(Boolean)
+        );
+        const inherited = (orphanedChildren.get(item.shares ?? item.id) ?? []).filter((child) => !children.some((own) => own.id === child.id));
+        const allChildren = [...children, ...inherited];
+        if (allChildren.length)
+          Object.assign(built, {
+            children: allChildren,
+            landingLabel: item.landingLabel
+          });
+        if (!decision.unscoped || !isMulti) return built;
+        const contributors = unscopedContributors(intentDefinitions, item.id);
+        return {
+          ...built,
+          href: contributors.length ? withIntent(stripIntent(built.href), contributors.join(",")) : stripIntent(built.href)
+        };
+      }).filter(Boolean)
+    );
+    const ownItems = [];
+    for (const item of items) {
+      const decision = navDecisions.get(
+        navDecisionKey(definition.key, item.id)
+      );
+      if (isMulti && decision?.unscoped) {
+        const at = sharedRows.findIndex((row) => row.id === item.id);
+        const existing = at === -1 ? void 0 : sharedRows[at];
+        if (!existing) {
+          sharedRows.push(item);
+        } else if (item.children?.length) {
+          const kept = existing.children ?? [];
+          sharedRows[at] = {
+            ...existing,
+            children: [
+              ...kept,
+              ...item.children.filter(
+                (child) => !kept.some((seen) => seen.id === child.id)
+              )
+            ]
+          };
+        }
+        continue;
+      }
+      ownItems.push(item);
+    }
+    if (ownItems.length === 0) return [];
+    const icon = definition.groupIcon ?? ICON_MAP[config.icon] ?? ownItems[0]?.icon ?? Package;
+    return [
+      {
+        id: config.key,
+        label: definition.label,
+        icon,
+        items: ownItems
+      }
+    ];
+  });
+  const allKeys = everyIntent.map((config) => config.key);
+  const composed = buildComposedGroups(allKeys, enabledBehaviors, filterItems);
+  return { intentGroups: [...intentGroups, ...composed], sharedRows };
+}
+export {
+  buildIntentGroups
+};
+//# sourceMappingURL=build-intent-groups.js.map

package/dist/sidebar/build-intent-groups.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sidebar/build-intent-groups.ts"],"sourcesContent":["/**\n * The archetype groups of the sidebar, and the rows they share.\n *\n * Lifted out of `build-nav-groups.ts`, where it was most of the file. Given the\n * archetypes a business runs, it decides which rows each one contributes, which\n * rows several of them share (those are hoisted out and returned separately),\n * and what hangs off a row that folded away. The caller builds the fixed spine\n * around what comes back.\n */\nimport { Package, Receipt } from 'lucide-react';\nimport type { LucideIcon } from 'lucide-react';\nimport { INTENT_NAV_DEFINITIONS } from '@withpotter/lib/intents/intent-nav';\nimport {\n  renderedNavLabels,\n  warnOnUnreachableNavItems,\n} from '@withpotter/lib/intents/nav-coverage';\nimport type { useIntentConfig } from '@withpotter/lib/intents/use-intent-config';\nimport type { resolveEnabledBehaviors } from '@withpotter/lib/resolve-enabled-behaviors';\nimport {\n  decideSharedNav,\n  navDecisionKey,\n  unscopedContributors,\n} from '@withpotter/lib/intents/collapse-shared-nav';\nimport { buildComposedGroups, COMPOSED_INTENT_KEYS } from './composed-groups';\nimport {\n  ICON_MAP,\n  INTENT_ITEM_PERMISSIONS,\n  type NavItem,\n  type NavGroup,\n} from './config';\n\n/** The glyph for a row named by the generic noun rather than an archetype's. */\nconst NEUTRAL_ICONS: Record<string, LucideIcon> = {\n  catalog: Package,\n  orders: Receipt,\n};\n\nexport function buildIntentGroups({\n  intentConfig,\n  hidden,\n  enabledBehaviors,\n  filterItems,\n}: {\n  intentConfig: ReturnType<typeof useIntentConfig>;\n  hidden: Set<string>;\n  enabledBehaviors: ReturnType<typeof resolveEnabledBehaviors>;\n  filterItems: (items: NavItem[]) => NavItem[];\n}): { intentGroups: NavGroup[]; sharedRows: NavItem[] } {\n  const isMulti = intentConfig.mode === 'multi';\n  const everyIntent =\n    intentConfig.mode === 'multi' ? intentConfig.all : [intentConfig.primary];\n  const activeIntents = everyIntent.filter(\n    (config) => !COMPOSED_INTENT_KEYS.has(config.key),\n  );\n  const intentsByKey = new Map(\n    activeIntents.map((config) => [config.key, config]),\n  );\n\n  const isAllowed = (item: {\n    generic?: boolean;\n    requiredBehavior?: string[];\n  }) => {\n    if (item.generic) {\n      if (hidden.has((item as { id: string }).id)) return false;\n      if (\n        item.requiredBehavior &&\n        !item.requiredBehavior.some((b) =>\n          enabledBehaviors.includes(b as (typeof enabledBehaviors)[number]),\n        )\n      )\n        return false;\n    }\n    return true;\n  };\n\n  /**\n   * Scope a row to its archetype without trampling the query it already has.\n   *\n   * This appended `?intent=…` to the raw href, which is fine until a row\n   * carries a query of its own: Subscribers points at\n   * `/dashboard/subscriptions?tab=subscribers`, and the result was\n   * `…?tab=subscribers?intent=subscriptions` — two question marks, one dead\n   * link, for any membership business running a second archetype.\n   */\n  const withIntent = (href: string, intent: string) => {\n    const [path, query] = href.split('?');\n    const params = new URLSearchParams(query ?? '');\n    params.set('intent', intent);\n    return `${path}?${params.toString()}`;\n  };\n\n  const buildIntentHref = (href: string, intentKey: string) =>\n    isMulti ? withIntent(href, intentKey) : href;\n\n  /** Everything the row asked for except the scoping. */\n  const stripIntent = (href: string) => {\n    const [path, query] = href.split('?');\n    const params = new URLSearchParams(query ?? '');\n    params.delete('intent');\n    const rest = params.toString();\n    return rest ? `${path}?${rest}` : path;\n  };\n\n  const findIntentNavItem = (\n    config: (typeof activeIntents)[number],\n    itemId: string,\n  ) => {\n    for (const group of config.navigation.groups) {\n      const match = group.items.find((item) => item.id === itemId);\n      if (match) return match;\n    }\n    return undefined;\n  };\n\n  const buildIntentItem = (\n    config: (typeof activeIntents)[number],\n    itemId: string,\n    label: string,\n    iconOverride?: LucideIcon,\n  ): NavItem | null => {\n    const item = findIntentNavItem(config, itemId);\n    if (!item || !isAllowed(item)) return null;\n\n    return {\n      id: item.id,\n      name: label,\n      href: buildIntentHref(item.href, config.key),\n      icon: iconOverride ?? ICON_MAP[item.icon] ?? Package,\n      requiredBehavior: item.requiredBehavior,\n      requiredPermission: INTENT_ITEM_PERMISSIONS[item.id],\n    };\n  };\n\n  /**\n   * Only the archetypes this business actually runs.\n   *\n   * `decideSharedNav` collapses by first claim: whichever definition reaches a\n   * `shares` key first emits the row, and every later one folds into it. Run\n   * over the whole registry that is a claim made by businesses this merchant\n   * is not — `food-orders` claims `menu` and `send-invoices` claims `services`\n   * whether or not either is switched on — so the merchant's own row was\n   * either deleted or wrongly marked unscoped.\n   *\n   * Both showed up at once on a business running bookings, subscriptions,\n   * takeaway and dine-in: Services was flipped unscoped by `send-invoices`\n   * (not on) and Menu by `dine-in` (on), which left two rows on the same\n   * `/dashboard/catalog` href — the sidebar highlighted both, drew the tree\n   * connector to both, and React saw duplicate keys. A restaurant with a\n   * retail shelf had it worse: dine-in + sell-products emitted Reservations\n   * and Tabs and nothing else, because `default` had already claimed\n   * `products`, `orders` and `shipping` and `take-bookings` had claimed\n   * `today` and `resources`.\n   */\n  /**\n   * And in the merchant's own order, not the file's.\n   *\n   * `decideSharedNav` collapses by FIRST claim, and \"first\" was first in this\n   * file. `event-tickets` is declared before both food archetypes, so a\n   * restaurant that seats guests, does takeaway and sells tickets to supper\n   * clubs got its **Menu and its Orders filed under a group headed Events** —\n   * and the Food Orders group disappeared completely, both its rows having\n   * folded into a heading about ticketing.\n   *\n   * The order a merchant picked their archetypes in is the order they think\n   * about their business in. It is already carried on `selectedIntents` and\n   * through `intentConfig.all`, so the sidebar can simply follow it: the\n   * groups appear in that order, and the first claim on a shared row goes to\n   * the archetype they named first rather than to whichever happens to sit\n   * highest in a source file.\n   */\n  const intentDefinitions = activeIntents\n    .map((config) =>\n      INTENT_NAV_DEFINITIONS.find(\n        (definition) => definition.key === config.key,\n      ),\n    )\n    .filter(\n      (definition): definition is (typeof INTENT_NAV_DEFINITIONS)[number] =>\n        Boolean(definition),\n    );\n\n  // This list — not the configs — decides what the merchant can reach and\n  // what each item is called. But /dashboard/operations builds its hub tiles\n  // straight from the config, so a config that drifts from this list either\n  // points somewhere unreachable or gives the same destination a second name\n  // on another screen. Both get shouted about in dev.\n  //\n  // Checked against the whole registry, not this tenant's slice: drift is a\n  // property of the definitions, and narrowing it would mean an archetype only\n  // reported itself broken once someone happened to switch it on.\n  warnOnUnreachableNavItems(renderedNavLabels());\n\n  // A multi-archetype business is one business, not several sharing a login.\n  // A place that seats guests and does takeaway has ONE menu and ONE order\n  // queue; listing each once per archetype gave Ember Palm two items both\n  // called \"Menu\" and three called some variant of \"Orders\", all pointing at\n  // the same screen with a different ?intent=.\n  //\n  // Anything several archetypes contribute (declared by `shares`) is emitted\n  // once, unscoped — which means \"all of it\". Narrowing still exists, on the\n  // screen itself: Catalog and Orders already render an intent switcher, so\n  // the sidebar was duplicating a control the merchant already had.\n  //\n  // Archetype-only items (Reservations, Tables, Tabs, Waitlist) declare no\n  // `shares` and stay in their own group, since nothing collapses them.\n  //\n  // The decision is made by decideSharedNav rather than here. This used to be\n  // a second copy of that algorithm, so the tests covering it were green\n  // against code the app never called.\n  /**\n   * Children take part too.\n   *\n   * The collapse only ever saw top-level rows, so a child pointing at a screen\n   * another archetype also lists was invisible to it. A club running courts\n   * and ticketed nights got **Calendar sync** under Resources and **Calendar\n   * Sync** under Events: one Google connection, two rows, two spellings.\n   *\n   * Flattened for the decision only — where a child collapses it is hoisted\n   * like any other shared row, and where it does not it stays under its\n   * parent.\n   */\n  const decisionDefinitions = intentDefinitions.map((definition) => ({\n    ...definition,\n    items: definition.items.flatMap((item) => [item, ...(item.children ?? [])]),\n  }));\n  const navDecisions = decideSharedNav(\n    decisionDefinitions,\n    isMulti ? 'multi' : 'single',\n  );\n\n  /**\n   * A row several archetypes share belongs to none of their groups.\n   *\n   * The collapse already produces ONE Catalog and ONE Orders for a business\n   * running four archetypes — that part was right, and the narrowing lives on\n   * the screen, where Catalog and Orders render an intent filter. What was\n   * wrong is where that single row was put: inside whichever archetype group\n   * happened to claim it first.\n   *\n   * First was first in `INTENT_NAV_DEFINITIONS`, so a restaurant's menu and\n   * order queue were filed under **Events**. Ordering by the merchant's own\n   * picks instead only moved the accident: a golf club's kitchen and pro-shop\n   * sales then filed under **Subscriptions**, because membership was named\n   * first.\n   *\n   * There is no right archetype to file it under, because it spans them. So it\n   * comes out: shared rows sit at the top as their own links, above the groups\n   * that hold each archetype's specific work. One Orders, one Catalog, one\n   * Today — filtered on the screen, not in the sidebar.\n   */\n  const sharedRows: NavItem[] = [];\n\n  /**\n   * What hung off the rows that folded away.\n   *\n   * When several archetypes contribute the same row, first claim wins and every\n   * later one returns null — the row AND everything nested under it. That is\n   * right for the row, which is the same destination twice, and wrong for the\n   * children, which are not: they are the losing archetype's own screens and\n   * nothing else renders them.\n   *\n   * A bakery with a counter, tables and cake consultations shares Resources\n   * between `dine-in` and `take-bookings`. `dine-in` claims it first with no\n   * children; `take-bookings` carries **Calendar sync** underneath. So the row\n   * survived under dine-in's word, take-bookings' row folded, and the bakery\n   * could not reach /dashboard/calendar-sync from anywhere in its dashboard.\n   *\n   * Nothing errored, no archetype was broken on its own, and the existing\n   * coverage check could not see it: it runs per archetype over the whole\n   * registry, and this screen only disappears in the combination.\n   *\n   * So the children are collected before anything folds and grafted onto the\n   * row that survives. First claim decides what the row is CALLED; it does not\n   * get to decide what is reachable.\n   */\n  const orphanedChildren = new Map<string, NavItem[]>();\n  if (isMulti) {\n    for (const definition of intentDefinitions) {\n      const config = intentsByKey.get(definition.key);\n      if (!config) continue;\n\n      for (const item of definition.items) {\n        const decision = navDecisions.get(\n          navDecisionKey(definition.key, item.id),\n        );\n        if (decision?.emit || !item.children?.length) continue;\n\n        const children = filterItems(\n          item.children\n            .map((child) => {\n              const childDecision = navDecisions.get(\n                navDecisionKey(definition.key, child.id),\n              );\n              // A child that collapsed into a shared row of its own is emitted\n              // at the top, not renested under a parent that folded.\n              if (childDecision && !childDecision.emit) return null;\n              return buildIntentItem(\n                config,\n                child.id,\n                childDecision?.emit ? childDecision.label : child.label,\n                child.icon,\n              );\n            })\n            .filter(Boolean) as NavItem[],\n        );\n\n        // Keyed by what actually decides the fold, not by the row id.\n        //\n        // `id` collides: `take-bookings` and `rent-property` call their row\n        // Appointments and Reservations, point it at /dashboard/bookings and\n        // share `bookings` — but its item id is still `orders`. Keyed by id, a\n        // gym running subscriptions + sell-products + take-bookings grafted\n        // the orders children onto BOTH the surviving Orders row and the\n        // Appointments row, so Explore appeared twice and one of them pointed\n        // at an explorer for a list Appointments does not show.\n        const orphanKey = item.shares ?? item.id;\n        if (children.length)\n          orphanedChildren.set(orphanKey, [\n            ...(orphanedChildren.get(orphanKey) ?? []),\n            ...children,\n          ]);\n      }\n    }\n  }\n\n  const intentGroups = intentDefinitions.flatMap((definition) => {\n    const config = intentsByKey.get(definition.key);\n    if (!config) return [];\n\n    // buildIntentItem tags each item with requiredPermission from\n    // INTENT_ITEM_PERMISSIONS; running through filterItems collapses\n    // that plus any hidden/label overrides in one pass so intent-based\n    // groups obey the same role gating as the fixed groups below.\n    const items = filterItems(\n      definition.items\n        .map((item) => {\n          const decision = navDecisions.get(\n            navDecisionKey(definition.key, item.id),\n          );\n          if (!decision?.emit) return null;\n\n          // A neutral label needs a neutral glyph. The row that several\n          // archetypes disagreed about is called \"Catalog\"; wearing\n          // take-bookings' spanner because it claimed the key first would name\n          // it after one of the archetypes it deliberately refuses to name.\n          const built = buildIntentItem(\n            config,\n            item.id,\n            decision.label,\n            decision.neutral ? (NEUTRAL_ICONS[item.id] ?? Package) : item.icon,\n          );\n          if (!built) return null;\n\n          // Children come from the same config the parent does, so a child\n          // the archetype never declared is never rendered.\n          const children = filterItems(\n            (item.children ?? [])\n              .map((child) => {\n                const childDecision = navDecisions.get(\n                  navDecisionKey(definition.key, child.id),\n                );\n                // A child that collapsed into a shared row is emitted once, at\n                // the top, rather than nested under each parent that lists it.\n                if (isMulti && childDecision && !childDecision.emit)\n                  return null;\n                const kid = buildIntentItem(\n                  config,\n                  child.id,\n                  childDecision?.emit ? childDecision.label : child.label,\n                  child.icon,\n                );\n                // A shared child carries every archetype behind it, the way its\n                // parent row does below. Without this the one \"Abandoned carts\"\n                // standing for three archetypes kept `?intent=dine-in` — the\n                // key of whichever claimed it — and opened filtered to one.\n                if (!kid || !isMulti || !childDecision?.unscoped) return kid;\n                const behind = unscopedContributors(\n                  intentDefinitions,\n                  child.id,\n                );\n                return {\n                  ...kid,\n                  href: behind.length\n                    ? withIntent(stripIntent(kid.href), behind.join(','))\n                    : stripIntent(kid.href),\n                };\n              })\n              .filter(Boolean) as NavItem[],\n          );\n          // Plus whatever hung off the same row in an archetype that folded.\n          // Deduped by id: two archetypes nesting the same child under the same\n          // parent mean one child, not two rows on one href.\n          const inherited = (\n            orphanedChildren.get(item.shares ?? item.id) ?? []\n          ).filter((child) => !children.some((own) => own.id === child.id));\n          const allChildren = [...children, ...inherited];\n          // The landing name rides along with the children, because it only\n          // means anything once the row is a hub — a row with no children\n          // keeps its own href and never renders a landing child at all.\n          if (allChildren.length)\n            Object.assign(built, {\n              children: allChildren,\n              landingLabel: item.landingLabel,\n            });\n          // Unscoped on purpose: one entry covering every archetype that feeds\n          // it, not the first one that happened to claim it — so it carries\n          // all of them rather than none.\n          //\n          // It used to strip the param entirely. \"Don't narrow to one\" then\n          // read as \"don't narrow\", which the catalog page worked around by\n          // reconstructing the list from the absence of a param — leaving the\n          // Catalog hub above it, which means everything and is also bare,\n          // with no way to say so. Two views, one URL, and the hub got the\n          // menu's filter.\n          if (!decision.unscoped || !isMulti) return built;\n          const contributors = unscopedContributors(intentDefinitions, item.id);\n          return {\n            ...built,\n            href: contributors.length\n              ? withIntent(stripIntent(built.href), contributors.join(','))\n              : stripIntent(built.href),\n          };\n        })\n        .filter(Boolean) as NavItem[],\n    );\n\n    /**\n     * Shared rows are hoisted; what stays is this archetype's own work —\n     * Reservations, Tabs, Tables, Attendees. A group with nothing left of its\n     * own does not render, which is correct: it contributed only things the\n     * business already sees once, higher up.\n     */\n    const ownItems: NavItem[] = [];\n    for (const item of items) {\n      const decision = navDecisions.get(\n        navDecisionKey(definition.key, item.id),\n      );\n      if (isMulti && decision?.unscoped) {\n        const at = sharedRows.findIndex((row) => row.id === item.id);\n        const existing = at === -1 ? undefined : sharedRows[at];\n        if (!existing) {\n          sharedRows.push(item);\n        } else if (item.children?.length) {\n          /**\n           * A hoisted row keeps the children of EVERY archetype that\n           * contributes it, not just the first one's.\n           *\n           * This kept the first and dropped the rest, and the rest are not\n           * decoration. A bakery with a counter, tables and cake\n           * consultations shares Resources between `dine-in` and\n           * `take-bookings`: `dine-in` claims it first with no children,\n           * `take-bookings` carries Calendar sync underneath it — so the row\n           * survived, the child did not, and the bakery could not reach\n           * /dashboard/calendar-sync from anywhere in its dashboard.\n           *\n           * Nothing errored and no other archetype was affected, because the\n           * row only loses a child in the combination. First claim decides the\n           * row's word; it must not decide what hangs off it.\n           */\n          const kept = existing.children ?? [];\n          sharedRows[at] = {\n            ...existing,\n            children: [\n              ...kept,\n              ...item.children.filter(\n                (child) => !kept.some((seen) => seen.id === child.id),\n              ),\n            ],\n          };\n        }\n        continue;\n      }\n      ownItems.push(item);\n    }\n\n    if (ownItems.length === 0) return [];\n\n    const icon =\n      definition.groupIcon ??\n      ICON_MAP[config.icon] ??\n      ownItems[0]?.icon ??\n      Package;\n    return [\n      {\n        id: config.key,\n        label: definition.label,\n        icon,\n        items: ownItems,\n      },\n    ];\n  });\n\n  const allKeys = everyIntent.map((config) => config.key);\n  const composed = buildComposedGroups(allKeys, enabledBehaviors, filterItems);\n  return { intentGroups: [...intentGroups, ...composed], sharedRows };\n}\n"],"mappings":"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","names":[]}

package/dist/sidebar/build-nav-groups.d.ts

@@ -0,0 +1,37 @@
+import { usePlatformModules } from '@withpotter/lib/use-platform-modules';
+import { useCurrentTemplate } from '@withpotter/lib/template-context';
+import { useIntentConfig } from '@withpotter/lib/intents/use-intent-config';
+import { usePermissions } from '@withpotter/lib/use-permissions';
+import { resolveEnabledBehaviors } from '@withpotter/lib/resolve-enabled-behaviors';
+import { type NavGroup } from './config';
+export interface NavGroupDeps {
+    hiddenModules: string[] | undefined;
+    moduleLabels: Record<string, string> | undefined;
+    enabledBehaviors: ReturnType<typeof resolveEnabledBehaviors>;
+    inPersonOnly: boolean;
+    intentConfig: ReturnType<typeof useIntentConfig>;
+    coreNavigation: ReturnType<typeof usePlatformModules>['coreNavigation'];
+    template: ReturnType<typeof useCurrentTemplate>['template'];
+    can: ReturnType<typeof usePermissions>['can'];
+    /**
+     * Needed on its own, not derivable from `can`: `can(anything)` is true for an
+     * owner AND for anyone holding that one permission, so it cannot answer "is
+     * this the owner" — which is what the closed-by-default rule below turns on.
+     */
+    isOwner: boolean;
+    permissionsLoading: boolean;
+    /** Whether the box's engine offers a capability. Left out, every one is offered. */
+    hasCapability?: (key: string) => boolean;
+}
+/**
+ * The nav, with any rename that would put one word on two rows set aside.
+ *
+ * A rename is keyed by the screen, and a screen can stand for more than the
+ * merchant meant: Inventory renamed to "Events" renamed the hub for bookings,
+ * products, food and invoices, beside the real Events row, and its landing link
+ * read "All events" over a page with no events on it. Two rows with one word
+ * and two destinations is the thing the rest of this builder exists to prevent,
+ * so a rename that causes it loses to the row that already had the word. The
+ * stored label is untouched; it applies again the moment the clash goes.
+ */
+export declare function buildNavGroups(deps: NavGroupDeps): NavGroup[];