@withpotter/components 0.13.0-next.101

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

@@ -0,0 +1,204 @@
+import { Layers, Package } from "lucide-react";
+import { coreModuleIds } from "@withpotter/lib/use-platform-modules";
+import { moduleLabelFor } from "@withpotter/lib/intents/use-entity-label";
+import { makeGroup } from "./nav-gates";
+import {
+  CORE_TOOL_PERMISSIONS,
+  PLATFORM_CONTENT_TYPES,
+  PLATFORM_CONTENT_ROUTES
+} from "./config";
+import { buildSpineGroups } from "./spine-groups";
+import { buildIntentGroups } from "./build-intent-groups";
+import { attachArchetypeCollections } from "./archetype-collections";
+import { renderedRows } from "./flatten-work-groups";
+import { inboxOwnsInquiries, withoutInquiries } from "./inbox-row";
+function buildNavGroups(deps) {
+  const groups = buildNavGroupsOnce(deps);
+  const labels = deps.moduleLabels;
+  if (!labels) return groups;
+  const seen = /* @__PURE__ */ new Map();
+  for (const row of renderedRows(groups)) {
+    const word = row.name.trim().toLowerCase();
+    seen.set(word, (seen.get(word) ?? 0) + 1);
+  }
+  const clashing = Object.keys(labels).filter(
+    (key) => (seen.get(labels[key]?.trim().toLowerCase()) ?? 0) > 1
+  );
+  if (clashing.length === 0) return groups;
+  const kept = { ...labels };
+  for (const key of clashing) delete kept[key];
+  return buildNavGroupsOnce({ ...deps, moduleLabels: kept });
+}
+function buildNavGroupsOnce({
+  hiddenModules,
+  moduleLabels,
+  enabledBehaviors,
+  inPersonOnly,
+  intentConfig,
+  coreNavigation,
+  template,
+  can,
+  isOwner,
+  permissionsLoading,
+  hasCapability
+}) {
+  const hidden = new Set(hiddenModules ?? []);
+  const activeIntentKeys = intentConfig.mode === "multi" ? intentConfig.all.map((config) => config.key) : [intentConfig.primary.key];
+  const hasEventAndBookings = activeIntentKeys.includes("event-tickets") && activeIntentKeys.includes("take-bookings");
+  const filterItems = (items) => items.filter((item) => !hidden.has(item.id)).filter(
+    (item) => !inPersonOnly || item.id !== "shipping" && item.id !== "shipping-settings"
+  ).filter(
+    (item) => !item.requiredCapability || (hasCapability?.(item.requiredCapability) ?? true)
+  ).filter(
+    (item) => !item.requiredBehavior || item.requiredBehavior.some(
+      (b) => enabledBehaviors.includes(b)
+    )
+  ).filter((item) => {
+    if (permissionsLoading) return true;
+    if (!item.requiredPermission || item.requiredPermission.length === 0)
+      return isOwner;
+    return item.requiredPermission.some((permission) => can(permission));
+  }).map((item) => {
+    const isBookingAppointments = hasEventAndBookings && item.id === "orders" && item.href.split("?")[0] === "/dashboard/bookings";
+    const renamed = isBookingAppointments ? void 0 : moduleLabelFor(moduleLabels, item.id, item.href);
+    return renamed ? { ...item, name: renamed } : item;
+  });
+  const built = buildIntentGroups({
+    intentConfig,
+    hidden,
+    enabledBehaviors,
+    filterItems
+  });
+  const claimed = inboxOwnsInquiries({
+    hiddenModules,
+    moduleLabels,
+    can,
+    isOwner,
+    permissionsLoading
+  }) ? withoutInquiries(built.intentGroups, built.sharedRows) : built;
+  const { sharedRows } = claimed;
+  let intentGroups = claimed.intentGroups;
+  const coreById = new Map(coreNavigation.map((mod) => [mod.id, mod]));
+  const catalogToolsItems = [];
+  const addCatalogTool = (item) => {
+    if (!item) return;
+    if (hidden.has(item.id)) return;
+    if (catalogToolsItems.some((existing) => existing.id === item.id)) return;
+    catalogToolsItems.push(item);
+  };
+  const templateContentModules = (template?.dashboardModules ?? []).filter(
+    (module) => {
+      const normalizedContentType = module.contentType?.toLowerCase();
+      const normalizedHref = module.href.split("?")[0].replace(/\/$/, "");
+      return normalizedContentType && !PLATFORM_CONTENT_TYPES.has(normalizedContentType) && !PLATFORM_CONTENT_ROUTES.has(normalizedHref) && !coreModuleIds.has(module.id);
+    }
+  );
+  templateContentModules.forEach((module) => {
+    addCatalogTool({
+      id: `content-${module.id}`,
+      name: `Content: ${module.name}`,
+      href: module.href,
+      icon: module.icon
+    });
+  });
+  const collectionsCore = coreById.get("collections");
+  const collectionsItem = {
+    id: "collections",
+    name: "Collections",
+    href: collectionsCore?.href ?? "/dashboard/collections",
+    icon: collectionsCore?.icon ?? Layers,
+    requiredPermission: CORE_TOOL_PERMISSIONS["collections"]
+  };
+  const perArchetype = attachArchetypeCollections({
+    groups: intentGroups,
+    configs: intentConfig.all,
+    hidden,
+    enabledBehaviors,
+    base: collectionsItem,
+    filterItems
+  });
+  intentGroups = perArchetype.groups;
+  let collectionsPlaced = perArchetype.attached > 0;
+  if (!collectionsPlaced && collectionsItem && !hidden.has("collections")) {
+    const rowsInPlay = [
+      ...sharedRows,
+      ...intentGroups.flatMap((group2) => group2.items ?? [])
+    ];
+    const catalogRow = rowsInPlay.find(
+      (item) => (item.href ?? "").split("?")[0] === "/dashboard/catalog"
+    ) ?? rowsInPlay.find((item) => item.id === "catalog");
+    const [allowed] = filterItems([collectionsItem]);
+    const collectionsAlreadyPlaced = rowsInPlay.some(
+      (item) => item.children?.some((child) => child.id === "collections")
+    );
+    if (collectionsAlreadyPlaced) {
+      collectionsPlaced = true;
+    } else if (catalogRow && allowed) {
+      catalogRow.children = [...catalogRow.children ?? [], allowed];
+      collectionsPlaced = true;
+    }
+  }
+  if (collectionsItem && !collectionsPlaced) addCatalogTool(collectionsItem);
+  const catalogToolsGroup = catalogToolsItems.length ? [
+    {
+      id: "catalog-tools",
+      label: collectionsPlaced ? "Content" : "Catalog",
+      icon: catalogToolsItems[0]?.icon ?? Package,
+      items: filterItems(catalogToolsItems)
+    }
+  ] : [];
+  const coreItem = (id, labelOverride) => {
+    const mod = coreById.get(id);
+    if (!mod || hidden.has(mod.id)) return null;
+    return {
+      id: mod.id,
+      name: labelOverride ?? mod.name,
+      href: mod.href,
+      icon: mod.icon,
+      requiredPermission: CORE_TOOL_PERMISSIONS[mod.id]
+    };
+  };
+  const group = makeGroup(can);
+  const renameGroup = (g) => {
+    const renamed = moduleLabelFor(moduleLabels, g.id, g.href);
+    return renamed ? { ...g, label: renamed } : g;
+  };
+  const SHARED_ROW_ORDER = ["today", "catalog", "orders"];
+  const sharedRank = (id) => {
+    const index = SHARED_ROW_ORDER.indexOf(id);
+    return index === -1 ? SHARED_ROW_ORDER.length : index;
+  };
+  const orderedSharedRows = [...sharedRows].sort(
+    (a, b) => sharedRank(a.id) - sharedRank(b.id)
+  );
+  const sharedGroups = orderedSharedRows.map((item) => ({
+    id: `shared-${item.id}`,
+    label: item.name,
+    icon: item.icon,
+    href: item.href,
+    requiredPermission: item.requiredPermission,
+    /**
+     * `alwaysHub` because `renderHub` drops a lone child otherwise: with
+     * exactly one item and no flag it renders the row as a flat link and the
+     * child never appears. Catalog carries exactly one — Collections — so
+     * without this, hoisting the row would have quietly deleted it.
+     */
+    ...item.children?.length ? { items: item.children, alwaysHub: true } : {}
+  }));
+  return buildSpineGroups({
+    filterItems,
+    coreItem,
+    group,
+    sharedGroups,
+    intentGroups,
+    catalogToolsGroup,
+    can,
+    enabledBehaviors,
+    intentConfig,
+    template
+  }).map(renameGroup);
+}
+export {
+  buildNavGroups
+};
+//# sourceMappingURL=build-nav-groups.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sidebar/build-nav-groups.ts"],"sourcesContent":["/**\n * Builds the sidebar's nav groups.\n *\n * Lifted out of sidebar.tsx, which had reached 1,510 lines — three times the\n * house limit — with this single builder accounting for 635 of them. It is a\n * pure function of its inputs, so it never needed the component's scope; the\n * caller still memoizes it on exactly the values it reads.\n */\nimport { Layers, Package } from 'lucide-react';\nimport { coreModuleIds, usePlatformModules } from '@withpotter/lib/use-platform-modules';\nimport { useCurrentTemplate } from '@withpotter/lib/template-context';\nimport { useIntentConfig } from '@withpotter/lib/intents/use-intent-config';\nimport { usePermissions } from '@withpotter/lib/use-permissions';\nimport { moduleLabelFor } from '@withpotter/lib/intents/use-entity-label';\nimport { resolveEnabledBehaviors } from '@withpotter/lib/resolve-enabled-behaviors';\nimport { makeGroup } from './nav-gates';\nimport {\n  CORE_TOOL_PERMISSIONS,\n  PLATFORM_CONTENT_TYPES,\n  PLATFORM_CONTENT_ROUTES,\n  type NavItem,\n  type NavGroup,\n} from './config';\nimport { buildSpineGroups } from './spine-groups';\nimport { buildIntentGroups } from './build-intent-groups';\nimport { attachArchetypeCollections } from './archetype-collections';\nimport { renderedRows } from './flatten-work-groups';\nimport { inboxOwnsInquiries, withoutInquiries } from './inbox-row';\n\nexport interface NavGroupDeps {\n  hiddenModules: string[] | undefined;\n  moduleLabels: Record<string, string> | undefined;\n  enabledBehaviors: ReturnType<typeof resolveEnabledBehaviors>;\n  inPersonOnly: boolean;\n  intentConfig: ReturnType<typeof useIntentConfig>;\n  coreNavigation: ReturnType<typeof usePlatformModules>['coreNavigation'];\n  template: ReturnType<typeof useCurrentTemplate>['template'];\n  can: ReturnType<typeof usePermissions>['can'];\n  /**\n   * Needed on its own, not derivable from `can`: `can(anything)` is true for an\n   * owner AND for anyone holding that one permission, so it cannot answer \"is\n   * this the owner\" — which is what the closed-by-default rule below turns on.\n   */\n  isOwner: boolean;\n  permissionsLoading: boolean;\n  /** Whether the box's engine offers a capability. Left out, every one is offered. */\n  hasCapability?: (key: string) => boolean;\n}\n\n/**\n * The nav, with any rename that would put one word on two rows set aside.\n *\n * A rename is keyed by the screen, and a screen can stand for more than the\n * merchant meant: Inventory renamed to \"Events\" renamed the hub for bookings,\n * products, food and invoices, beside the real Events row, and its landing link\n * read \"All events\" over a page with no events on it. Two rows with one word\n * and two destinations is the thing the rest of this builder exists to prevent,\n * so a rename that causes it loses to the row that already had the word. The\n * stored label is untouched; it applies again the moment the clash goes.\n */\nexport function buildNavGroups(deps: NavGroupDeps): NavGroup[] {\n  const groups = buildNavGroupsOnce(deps);\n  const labels = deps.moduleLabels;\n  if (!labels) return groups;\n  const seen = new Map<string, number>();\n  for (const row of renderedRows(groups)) {\n    const word = row.name.trim().toLowerCase();\n    seen.set(word, (seen.get(word) ?? 0) + 1);\n  }\n  const clashing = Object.keys(labels).filter(\n    (key) => (seen.get(labels[key]?.trim().toLowerCase()) ?? 0) > 1,\n  );\n  if (clashing.length === 0) return groups;\n  const kept = { ...labels };\n  for (const key of clashing) delete kept[key];\n  return buildNavGroupsOnce({ ...deps, moduleLabels: kept });\n}\n\nfunction buildNavGroupsOnce({\n  hiddenModules,\n  moduleLabels,\n  enabledBehaviors,\n  inPersonOnly,\n  intentConfig,\n  coreNavigation,\n  template,\n  can,\n  isOwner,\n  permissionsLoading,\n  hasCapability,\n}: NavGroupDeps): NavGroup[] {\n  const hidden = new Set(hiddenModules ?? []);\n  const activeIntentKeys =\n    intentConfig.mode === 'multi'\n      ? intentConfig.all.map((config) => config.key)\n      : [intentConfig.primary.key];\n  const hasEventAndBookings =\n    activeIntentKeys.includes('event-tickets') &&\n    activeIntentKeys.includes('take-bookings');\n\n  // Filter by behavior + hidden modules + role permissions, then apply\n  // custom labels. The permission filter is skipped while the team\n  // membership request is in flight so OWNER doesn't flicker into a\n  // reduced sidebar on cold load.\n  const filterItems = (items: NavItem[]) =>\n    items\n      .filter((item) => !hidden.has(item.id))\n      // In-person-only tenants don't ship — drop fulfillment surfaces.\n      .filter(\n        (item) =>\n          !inPersonOnly ||\n          (item.id !== 'shipping' && item.id !== 'shipping-settings'),\n      )\n      .filter(\n        (item) =>\n          !item.requiredCapability ||\n          (hasCapability?.(item.requiredCapability) ?? true),\n      )\n      .filter(\n        (item) =>\n          !item.requiredBehavior ||\n          item.requiredBehavior.some((b) =>\n            enabledBehaviors.includes(b as (typeof enabledBehaviors)[number]),\n          ),\n      )\n      .filter((item) => {\n        if (permissionsLoading) return true;\n        // Closed by default: an item with no declared permission is shown only\n        // to the owner, rather than to everyone. A row nobody remembered to gate\n        // then fails safe, and the coverage test makes the failure loud instead\n        // of silent.\n        if (!item.requiredPermission || item.requiredPermission.length === 0)\n          return isOwner;\n        return item.requiredPermission.some((permission) => can(permission));\n      })\n      .map((item) => {\n        // Through `moduleLabelFor`, because settings stores the rename against\n        // the SCREEN and this list is keyed by nav item id — which identifies\n        // neither reliably: `catalog` is stored as `inventory`, and `orders`\n        // reaches the order queue for a kitchen and the tee sheet for a club.\n        // Keyed by id alone, renaming Inventory to \"Properties\" reached the\n        // \"Add property\" button and not the row above it.\n        //\n        // Customers is no longer held back from this. It was, under a rule\n        // reading \"CRM is a shared layer — never relabel based on intent or\n        // moduleLabels\", and the first half of that is right: a merchant\n        // running four archetypes needs one back office, not four. But no\n        // archetype ever contributes a `customers` row, so the only thing that\n        // rule could block was `moduleLabels` — the merchant's OWN word, typed\n        // once, in Settings, which still offers and stores it. A hotel that had\n        // renamed the module to \"Guests\" had the word taken and then ignored.\n        // One word everywhere does not fragment a back office; it is the point.\n        const isBookingAppointments =\n          hasEventAndBookings &&\n          item.id === 'orders' &&\n          item.href.split('?')[0] === '/dashboard/bookings';\n        const renamed = isBookingAppointments\n          ? undefined\n          : moduleLabelFor(moduleLabels, item.id, item.href);\n        return renamed ? { ...item, name: renamed } : item;\n      });\n\n  const built = buildIntentGroups({\n    intentConfig,\n    hidden,\n    enabledBehaviors,\n    filterItems,\n  });\n  /**\n   * One door to the Inbox. `capture-leads` declares an Enquiries row to the\n   * same page the top-level Inbox opens, and a destination drawn by two rows\n   * is what the nav guard fails on. The archetype configs keep their\n   * declaration; the row is set aside here. See `inbox-row.ts`.\n   */\n  const claimed = inboxOwnsInquiries({\n    hiddenModules,\n    moduleLabels,\n    can,\n    isOwner,\n    permissionsLoading,\n  })\n    ? withoutInquiries(built.intentGroups, built.sharedRows)\n    : built;\n  const { sharedRows } = claimed;\n  let intentGroups = claimed.intentGroups;\n\n  const coreById = new Map(coreNavigation.map((mod) => [mod.id, mod]));\n  const catalogToolsItems: NavItem[] = [];\n\n  const addCatalogTool = (item: NavItem | null) => {\n    if (!item) return;\n    if (hidden.has(item.id)) return;\n    if (catalogToolsItems.some((existing) => existing.id === item.id)) return;\n    catalogToolsItems.push(item);\n  };\n\n  const templateContentModules = (template?.dashboardModules ?? []).filter(\n    (module) => {\n      const normalizedContentType = module.contentType?.toLowerCase();\n      const normalizedHref = module.href.split('?')[0].replace(/\\/$/, '');\n      return (\n        normalizedContentType &&\n        !PLATFORM_CONTENT_TYPES.has(normalizedContentType) &&\n        !PLATFORM_CONTENT_ROUTES.has(normalizedHref) &&\n        !coreModuleIds.has(module.id)\n      );\n    },\n  );\n\n  templateContentModules.forEach((module) => {\n    addCatalogTool({\n      id: `content-${module.id}`,\n      name: `Content: ${module.name}`,\n      href: module.href,\n      icon: module.icon,\n    });\n  });\n\n  /**\n   * Collections hangs under the catalogue row, not beside it.\n   *\n   * It used to head a collapsible group of its own labelled \"Catalog\", which\n   * every business got directly beneath the group holding its actual catalogue:\n   * a bookings business read Services under \"Bookings\" and then Collections\n   * under \"Catalog\", with nothing on screen saying the second grouped the\n   * first. Two rows claiming the catalogue, one of them spending a whole group\n   * on a single link.\n   *\n   * A collection is a view OF the catalogue, and this sidebar already has the\n   * pattern and states the rule: Waitlist is a child of Appointments because\n   * peers would say they are two equal destinations \"when one is a state of the\n   * other\". So Collections goes where the merchant's catalogue actually is —\n   * under Menu for a restaurant, Properties for a short-let, Plans for a\n   * membership — whatever this business calls it.\n   */\n  /**\n   * Collections has a row whether or not the module registry mentions it.\n   *\n   * `/dashboard/collections` is a real screen with a list, a create flow and a\n   * record page, and on a tenant whose `coreNavigation` did not carry the\n   * module this resolved to null — so the row was never built, nothing hung it\n   * under the catalogue, and the ONLY ways in were a collection chip on a\n   * product that was already in one, or the picker inside the product editor.\n   * A page you can only reach from a product that already references it cannot\n   * be where you go to make the first one.\n   *\n   * The registry still wins when it has an opinion (a tenant can rename or\n   * rehome the module); it just no longer decides whether the destination\n   * exists at all. `hidden` is still honoured below — hiding it is a choice,\n   * omitting it was an accident.\n   */\n  const collectionsCore = coreById.get('collections');\n  const collectionsItem = {\n    id: 'collections',\n    name: 'Collections',\n    href: collectionsCore?.href ?? '/dashboard/collections',\n    icon: collectionsCore?.icon ?? Layers,\n    requiredPermission: CORE_TOOL_PERMISSIONS['collections'],\n  };\n\n  /**\n   * Collections is a sub-nav under each archetype, one archetype or several, and\n   * the single general row below is only built when none could carry it. See\n   * `archetype-collections.ts`.\n   */\n  const perArchetype = attachArchetypeCollections({\n    groups: intentGroups,\n    configs: intentConfig.all,\n    hidden,\n    enabledBehaviors,\n    base: collectionsItem,\n    filterItems,\n  });\n  intentGroups = perArchetype.groups;\n\n  let collectionsPlaced = perArchetype.attached > 0;\n  if (!collectionsPlaced && collectionsItem && !hidden.has('collections')) {\n    // The catalogue row, wherever it ended up: hoisted to the top when several\n    // archetypes share it, or inside the one archetype's group when they do\n    // not. Looking only in the groups left Collections orphaned the moment the\n    // row was hoisted, and it fell back to heading a group called \"Catalog\" —\n    // beside a link also called Catalog.\n    //\n    // Found by WHERE IT GOES, not by what it is called. `subscriptions` gives\n    // the id `catalog` to **Plans**, which opens /dashboard/subscriptions — so\n    // a business running memberships beside anything else hung Collections\n    // under its billing tiers, and which row won depended on the order the\n    // merchant ticked archetypes in. sidebar.tsx already refuses to trust the\n    // id for this reason; this file was the half that still did. The id stays\n    // as the fallback, for archetypes whose catalogue is genuinely elsewhere.\n    const rowsInPlay = [\n      ...sharedRows,\n      ...intentGroups.flatMap((group) => group.items ?? []),\n    ];\n    const catalogRow =\n      rowsInPlay.find(\n        (item) => (item.href ?? '').split('?')[0] === '/dashboard/catalog',\n      ) ?? rowsInPlay.find((item) => item.id === 'catalog');\n\n    const [allowed] = filterItems([collectionsItem]);\n    const collectionsAlreadyPlaced = rowsInPlay.some((item) =>\n      item.children?.some((child) => child.id === 'collections'),\n    );\n    if (collectionsAlreadyPlaced) {\n      collectionsPlaced = true;\n    } else if (catalogRow && allowed) {\n      catalogRow.children = [...(catalogRow.children ?? []), allowed];\n      collectionsPlaced = true;\n    }\n  }\n\n  // No catalogue row to hang it under — a business whose archetypes contribute\n  // none, or one whose catalogue the merchant has hidden. Collections is still\n  // a destination, so it keeps a home rather than disappearing with the row.\n  if (collectionsItem && !collectionsPlaced) addCatalogTool(collectionsItem);\n\n  /**\n   * What is left is template content: a venue's Artists, a school's Courses.\n   * Those are genuinely their own content types rather than views of the\n   * catalogue, so they keep a group — under the word that describes them.\n   */\n  const catalogToolsGroup: NavGroup[] = catalogToolsItems.length\n    ? [\n        {\n          id: 'catalog-tools',\n          label: collectionsPlaced ? 'Content' : 'Catalog',\n          icon: catalogToolsItems[0]?.icon ?? Package,\n          items: filterItems(catalogToolsItems),\n        },\n      ]\n    : [];\n\n  // A core module (discounts, blog) surfaced as a nav item for a spine\n  // group other than Catalog. Returns null if the module isn't present\n  // for this tenant or is hidden.\n  const coreItem = (id: string, labelOverride?: string): NavItem | null => {\n    const mod = coreById.get(id);\n    if (!mod || hidden.has(mod.id)) return null;\n    return {\n      id: mod.id,\n      name: labelOverride ?? mod.name,\n      href: mod.href,\n      icon: mod.icon,\n      requiredPermission: CORE_TOOL_PERMISSIONS[mod.id],\n    };\n  };\n\n  // The gate lives in `nav-gates.ts`, beside its flat-row twin.\n  const group = makeGroup(can);\n\n  /**\n   * A rename reaches a hub's own row, not only the rows inside it.\n   *\n   * `filterItems` renames ITEMS, and the fixed spine's top-level entries are\n   * GROUPS — so a business that renamed Customers to \"Guests\" got a page headed\n   * Guests under a sidebar row still reading Customers. Same for any other\n   * module the Settings list offers a rename for.\n   */\n  const renameGroup = (g: NavGroup): NavGroup => {\n    const renamed = moduleLabelFor(moduleLabels, g.id, g.href);\n    return renamed ? { ...g, label: renamed } : g;\n  };\n\n  /**\n   * Each shared row as its own top-level link, in one fixed order.\n   *\n   * This comment used to claim the order was Today, Catalog, Orders and the\n   * code did not sort at all — it kept whatever order the definitions happened\n   * to produce, which is the order the merchant picked their archetypes in.\n   * So five of the sixteen multi-archetype businesses got **Orders above\n   * Catalog**, and all five were the ones that named a membership first:\n   * `subscriptions` files its catalogue under Plans, so the first shared row it\n   * contributes is the order queue.\n   *\n   * Two merchants running the same four archetypes got different sidebars\n   * because of the order they ticked boxes in months earlier. These are the two\n   * most-used rows in the app and their position is muscle memory, so it cannot\n   * depend on that.\n   *\n   * The order is the order a day runs in: what is happening now, then what you\n   * sell, then what was sold. Anything not named keeps its place at the end.\n   */\n  const SHARED_ROW_ORDER = ['today', 'catalog', 'orders'];\n  const sharedRank = (id: string) => {\n    const index = SHARED_ROW_ORDER.indexOf(id);\n    return index === -1 ? SHARED_ROW_ORDER.length : index;\n  };\n  const orderedSharedRows = [...sharedRows].sort(\n    (a, b) => sharedRank(a.id) - sharedRank(b.id),\n  );\n\n  const sharedGroups: NavGroup[] = orderedSharedRows.map((item) => ({\n    id: `shared-${item.id}`,\n    label: item.name,\n    icon: item.icon,\n    href: item.href,\n    requiredPermission: item.requiredPermission,\n    /**\n     * `alwaysHub` because `renderHub` drops a lone child otherwise: with\n     * exactly one item and no flag it renders the row as a flat link and the\n     * child never appears. Catalog carries exactly one — Collections — so\n     * without this, hoisting the row would have quietly deleted it.\n     */\n    ...(item.children?.length ? { items: item.children, alwaysHub: true } : {}),\n  }));\n\n  return buildSpineGroups({\n    filterItems,\n    coreItem,\n    group,\n    sharedGroups,\n    intentGroups,\n    catalogToolsGroup,\n    can,\n    enabledBehaviors,\n    intentConfig,\n    template,\n  }).map(renameGroup);\n}\n"],"mappings":"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","names":["group"]}

package/dist/sidebar/commerce-build-navigation.d.ts

@@ -0,0 +1,2 @@
+import type { NavItem } from './navigation-types';
+export declare function withCommerceBuildNavigation(sectionId: string, items: NavItem[]): NavItem[];

package/dist/sidebar/commerce-build-navigation.js

@@ -0,0 +1,16 @@
+import { Package } from "lucide-react";
+import { isCommerceBuildEnabled } from "@withpotter/lib/editor-agent/flag";
+const COMMERCE_BUILD_ITEM = {
+  id: "commerce-build",
+  name: "Commerce Build",
+  href: "/dashboard/build",
+  icon: Package,
+  requiredPermission: ["canManageEditor"]
+};
+function withCommerceBuildNavigation(sectionId, items) {
+  return sectionId === "brand-site" && isCommerceBuildEnabled() ? [...items, COMMERCE_BUILD_ITEM] : items;
+}
+export {
+  withCommerceBuildNavigation
+};
+//# sourceMappingURL=commerce-build-navigation.js.map

package/dist/sidebar/commerce-build-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sidebar/commerce-build-navigation.ts"],"sourcesContent":["import { Package } from 'lucide-react';\nimport { isCommerceBuildEnabled } from '@withpotter/lib/editor-agent/flag';\nimport type { NavItem } from './navigation-types';\n\nconst COMMERCE_BUILD_ITEM: NavItem = {\n  id: 'commerce-build',\n  name: 'Commerce Build',\n  href: '/dashboard/build',\n  icon: Package,\n  requiredPermission: ['canManageEditor'],\n};\n\nexport function withCommerceBuildNavigation(\n  sectionId: string,\n  items: NavItem[],\n): NavItem[] {\n  return sectionId === 'brand-site' && isCommerceBuildEnabled()\n    ? [...items, COMMERCE_BUILD_ITEM]\n    : items;\n}\n"],"mappings":"AAAA,SAAS,eAAe;AACxB,SAAS,8BAA8B;AAGvC,MAAM,sBAA+B;AAAA,EACnC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,oBAAoB,CAAC,iBAAiB;AACxC;AAEO,SAAS,4BACd,WACA,OACW;AACX,SAAO,cAAc,gBAAgB,uBAAuB,IACxD,CAAC,GAAG,OAAO,mBAAmB,IAC9B;AACN;","names":[]}

package/dist/sidebar/composed-groups.d.ts

@@ -0,0 +1,20 @@
+import type { resolveEnabledBehaviors } from '@withpotter/lib/resolve-enabled-behaviors';
+import { type NavGroup, type NavItem } from './config';
+type Behavior = ReturnType<typeof resolveEnabledBehaviors>[number];
+/** Keys of the intents the composer owns; the legacy nav builder skips them. */
+export declare const COMPOSED_INTENT_KEYS: Set<string>;
+/**
+ * The sidebar group the composer gives a business, one per composed intent it
+ * runs.
+ *
+ * Each intent is ONE expandable row, headed by its `nav` label, with its routes
+ * inside. The intent's first route is its landing (it opens when the row does,
+ * and the hub renders it as the first child, "All events"), and the rest are
+ * its children, in the order the composer lists them. There is no vote and no
+ * shared row: two intents never contribute to one entry, so there is nothing
+ * for the first-ticked to win. A route appears only while one of its
+ * `requires` behaviors is active and the member may see it; if the landing is
+ * not visible to them, the first one that is stands in for it.
+ */
+export declare function buildComposedGroups(activeKeys: readonly string[], enabledBehaviors: readonly Behavior[], filterItems: (items: NavItem[]) => NavItem[]): NavGroup[];
+export {};

package/dist/sidebar/composed-groups.js

@@ -0,0 +1,54 @@
+import { Package } from "lucide-react";
+import { INTENTS } from "@withpotter/components/intents";
+import { ICON_MAP } from "./config";
+const COMPOSED_INTENT_KEYS = new Set(
+  INTENTS.map((intent) => intent.key)
+);
+function buildComposedGroups(activeKeys, enabledBehaviors, filterItems) {
+  return INTENTS.filter(
+    (intent) => COMPOSED_INTENT_KEYS.has(intent.key) && activeKeys.includes(intent.key)
+  ).flatMap((intent) => {
+    const landingLabels = new Map(
+      intent.routes.map((route) => [
+        route.navId ?? route.path,
+        route.landingLabel
+      ])
+    );
+    const [landing, ...children] = filterItems(
+      intent.routes.filter((route) => !route.hidden).filter(
+        (route) => !route.requires || route.requires.some(
+          (behavior) => enabledBehaviors.includes(behavior)
+        )
+      ).map((route) => ({
+        id: route.navId ?? route.path,
+        name: route.label,
+        href: `/dashboard/${route.path}`,
+        icon: ICON_MAP[route.icon] ?? Package,
+        requiredPermission: [...route.permissions]
+      }))
+    );
+    if (!landing) return [];
+    const row = {
+      ...landing,
+      name: intent.nav.label,
+      icon: ICON_MAP[intent.nav.icon] ?? landing.icon,
+      ...children.length > 0 && {
+        children,
+        landingLabel: landingLabels.get(landing.id) ?? "All {label}"
+      }
+    };
+    return [
+      {
+        id: intent.key,
+        label: intent.nav.label,
+        icon: row.icon,
+        items: [row]
+      }
+    ];
+  });
+}
+export {
+  COMPOSED_INTENT_KEYS,
+  buildComposedGroups
+};
+//# sourceMappingURL=composed-groups.js.map

package/dist/sidebar/composed-groups.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/sidebar/composed-groups.ts"],"sourcesContent":["import { Package } from 'lucide-react';\nimport { INTENTS } from '@withpotter/components/intents';\nimport type { resolveEnabledBehaviors } from '@withpotter/lib/resolve-enabled-behaviors';\nimport { ICON_MAP, type NavGroup, type NavItem } from './config';\n\ntype Behavior = ReturnType<typeof resolveEnabledBehaviors>[number];\n\n/** Keys of the intents the composer owns; the legacy nav builder skips them. */\nexport const COMPOSED_INTENT_KEYS: Set<string> = new Set(\n  INTENTS.map((intent) => intent.key),\n);\n\n/**\n * The sidebar group the composer gives a business, one per composed intent it\n * runs.\n *\n * Each intent is ONE expandable row, headed by its `nav` label, with its routes\n * inside. The intent's first route is its landing (it opens when the row does,\n * and the hub renders it as the first child, \"All events\"), and the rest are\n * its children, in the order the composer lists them. There is no vote and no\n * shared row: two intents never contribute to one entry, so there is nothing\n * for the first-ticked to win. A route appears only while one of its\n * `requires` behaviors is active and the member may see it; if the landing is\n * not visible to them, the first one that is stands in for it.\n */\nexport function buildComposedGroups(\n  activeKeys: readonly string[],\n  enabledBehaviors: readonly Behavior[],\n  filterItems: (items: NavItem[]) => NavItem[],\n): NavGroup[] {\n  return INTENTS.filter(\n    (intent) =>\n      COMPOSED_INTENT_KEYS.has(intent.key) && activeKeys.includes(intent.key),\n  ).flatMap((intent) => {\n    const landingLabels = new Map(\n      intent.routes.map((route) => [\n        route.navId ?? route.path,\n        route.landingLabel,\n      ]),\n    );\n    const [landing, ...children] = filterItems(\n      intent.routes\n        .filter((route) => !route.hidden)\n        .filter(\n          (route) =>\n            !route.requires ||\n            route.requires.some((behavior) =>\n              enabledBehaviors.includes(behavior as Behavior),\n            ),\n        )\n        .map((route): NavItem => ({\n          id: route.navId ?? route.path,\n          name: route.label,\n          href: `/dashboard/${route.path}`,\n          icon: ICON_MAP[route.icon] ?? Package,\n          requiredPermission: [...route.permissions],\n        })),\n    );\n    if (!landing) return [];\n\n    const row: NavItem = {\n      ...landing,\n      name: intent.nav.label,\n      icon: ICON_MAP[intent.nav.icon] ?? landing.icon,\n      ...(children.length > 0 && {\n        children,\n        landingLabel: landingLabels.get(landing.id) ?? 'All {label}',\n      }),\n    };\n\n    return [\n      {\n        id: intent.key,\n        label: intent.nav.label,\n        icon: row.icon,\n        items: [row],\n      },\n    ];\n  });\n}\n"],"mappings":"AAAA,SAAS,eAAe;AACxB,SAAS,eAAe;AAExB,SAAS,gBAA6C;AAK/C,MAAM,uBAAoC,IAAI;AAAA,EACnD,QAAQ,IAAI,CAAC,WAAW,OAAO,GAAG;AACpC;AAeO,SAAS,oBACd,YACA,kBACA,aACY;AACZ,SAAO,QAAQ;AAAA,IACb,CAAC,WACC,qBAAqB,IAAI,OAAO,GAAG,KAAK,WAAW,SAAS,OAAO,GAAG;AAAA,EAC1E,EAAE,QAAQ,CAAC,WAAW;AACpB,UAAM,gBAAgB,IAAI;AAAA,MACxB,OAAO,OAAO,IAAI,CAAC,UAAU;AAAA,QAC3B,MAAM,SAAS,MAAM;AAAA,QACrB,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AACA,UAAM,CAAC,SAAS,GAAG,QAAQ,IAAI;AAAA,MAC7B,OAAO,OACJ,OAAO,CAAC,UAAU,CAAC,MAAM,MAAM,EAC/B;AAAA,QACC,CAAC,UACC,CAAC,MAAM,YACP,MAAM,SAAS;AAAA,UAAK,CAAC,aACnB,iBAAiB,SAAS,QAAoB;AAAA,QAChD;AAAA,MACJ,EACC,IAAI,CAAC,WAAoB;AAAA,QACxB,IAAI,MAAM,SAAS,MAAM;AAAA,QACzB,MAAM,MAAM;AAAA,QACZ,MAAM,cAAc,MAAM,IAAI;AAAA,QAC9B,MAAM,SAAS,MAAM,IAAI,KAAK;AAAA,QAC9B,oBAAoB,CAAC,GAAG,MAAM,WAAW;AAAA,MAC3C,EAAE;AAAA,IACN;AACA,QAAI,CAAC,QAAS,QAAO,CAAC;AAEtB,UAAM,MAAe;AAAA,MACnB,GAAG;AAAA,MACH,MAAM,OAAO,IAAI;AAAA,MACjB,MAAM,SAAS,OAAO,IAAI,IAAI,KAAK,QAAQ;AAAA,MAC3C,GAAI,SAAS,SAAS,KAAK;AAAA,QACzB;AAAA,QACA,cAAc,cAAc,IAAI,QAAQ,EAAE,KAAK;AAAA,MACjD;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,QACE,IAAI,OAAO;AAAA,QACX,OAAO,OAAO,IAAI;AAAA,QAClB,MAAM,IAAI;AAAA,QACV,OAAO,CAAC,GAAG;AAAA,MACb;AAAA,IACF;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/sidebar/config.d.ts

@@ -0,0 +1,180 @@
+import type { LucideIcon } from 'lucide-react';
+import type { PermissionKey } from '@withpotter/lib/use-permissions';
+/** Map string icon names from IntentConfig to Lucide components */
+export declare const ICON_MAP: Record<string, LucideIcon>;
+export { INTENT_ITEM_PERMISSIONS, CORE_TOOL_PERMISSIONS, } from './nav-permissions';
+export interface NavItem {
+    id: string;
+    name: string;
+    href: string;
+    icon: LucideIcon;
+    requiredBehavior?: string[];
+    /**
+     * The row is only drawn on a box whose capability list carries this key. A
+     * box that published no list is unchanged, so the main app keeps every row.
+     * For a screen whose backend only some engines have: without it the row led
+     * to "Cannot GET /referrals/stats" on a box that never had that module.
+     */
+    requiredCapability?: string;
+    /**
+     * The item is only rendered when the current team member has AT LEAST ONE of
+     * these permissions (OWNER always passes). Undefined or empty means the item
+     * is hidden from every non-owner — see INTENT_ITEM_PERMISSIONS for why the
+     * default is closed rather than open.
+     */
+    requiredPermission?: PermissionKey[];
+    /**
+     * Rows revealed under this one. An item with children renders with the same
+     * disclosure the fixed spine hubs use, so an Operations surface can carry a
+     * smaller surface (Appointments → Waitlist) without claiming a second
+     * top-level row for it.
+     */
+    children?: NavItem[];
+    /**
+     * Names this row's own landing page once it carries children.
+     *
+     * A work row with children renders through `renderHub`, which moves the
+     * row's own screen into the group as its first child — a row is a place or a
+     * container, never both. Without this the child falls back to "Overview",
+     * which the hub renderer says outright no new hub should rely on: every hub
+     * could carry one, so the word tells the merchant nothing about which hub
+     * they are in. `{label}` interpolates the row's post-rename label, so a
+     * tenant calling them Bookings gets "All bookings" rather than a literal.
+     */
+    landingLabel?: string;
+}
+export interface NavGroupSection {
+    id: string;
+    label: string;
+    items: NavItem[];
+}
+export interface NavGroup {
+    id: string;
+    label: string;
+    icon: LucideIcon;
+    items?: NavItem[];
+    sections?: NavGroupSection[];
+    /**
+     * With no `items`, the group is a flat top-level destination (rendered like
+     * the Home link — no chevron, no children).
+     *
+     * With `items`, this is the group's landing page, and it is rendered as the
+     * FIRST CHILD rather than on the group's own row. A row is either a place or
+     * a container, never both: a row that navigated *and* disclosed gave two
+     * answers to one click, and the highlight landed on the parent while the
+     * list that had just opened underneath it looked like a menu you had yet to
+     * choose from. See `landingLabel` for what the child is called.
+     */
+    href?: string;
+    /**
+     * What this group's landing page is called once it sits among its own
+     * children. Defaults to "Overview". Ignored unless the group has both an
+     * `href` and `items`.
+     *
+     * `{label}` interpolates the group's OWN label, after renaming. A hub named
+     * for a merchant-facing noun is renamed per tenant — Customers becomes
+     * Guests, Clients, Members — and a literal "All customers" would have sat
+     * under a hub reading "Guests", which is the exact mismatch `renameGroup`
+     * exists to prevent. Write `All {label}`, not `All customers`.
+     */
+    landingLabel?: string;
+    /**
+     * Where the landing page sits among the children, counting from 0. Absent, it
+     * leads, which every hub but Money wants. Money puts the wallet above its
+     * Transactions page (John, 2026-10-11): the balance a business holds is the
+     * first question, the log of what moved it the second.
+     */
+    landingAt?: number;
+    /**
+     * Only meaningful for flat (href) groups: gate visibility on AT LEAST ONE
+     * of these permissions (OWNER always passes). Collapsible groups gate at
+     * the item level instead.
+     */
+    requiredPermission?: PermissionKey[];
+    /**
+     * Render as a disclosure hub even with a single child (normally a 1-child
+     * group collapses to a flat link). Used by Inventory so Collections shows
+     * inside it.
+     */
+    alwaysHub?: boolean;
+}
+export declare const EXACT_MATCH_ROUTES: Set<string>;
+export declare const PLATFORM_CONTENT_TYPES: Set<string>;
+export declare const PLATFORM_CONTENT_ROUTES: Set<string>;
+/** Settings sub-nav — shown in the sidebar (drill-in) when on a settings route. */
+export type SettingsItem = {
+    name: string;
+    href: string;
+    requires?: string;
+    requiresAny?: string[];
+    /** Extra routes that also mark this (collapsed) entry active, e.g. tabs. */
+    match?: string[];
+    /** Rail glyph. The settings rail had labels only, so it was the one nav in
+     *  the app you had to read rather than recognise — and it's the nav people
+     *  visit least often, which is exactly where recognition helps most. */
+    icon: LucideIcon;
+};
+export declare const ACCOUNT_GROUPS: {
+    label: string;
+    items: SettingsItem[];
+}[];
+/**
+ * ONE ORDERED LIST, NO GROUP HEADINGS.
+ *
+ * These rows sat under `Setup` / `Selling` / `Records` and the headings were
+ * doing no work. `Setup` held Billing and Notifications, which you visit for
+ * years after setting up. `Records` held exactly one row. And a merchant
+ * looking for Taxes does not first decide which of the three thirds it is in —
+ * they scan for the word "Taxes".
+ *
+ * Shopify carries nineteen settings rows with no headings at all and it reads
+ * fine, because every label is a noun the merchant already owns. What does the
+ * work there is the ORDER, and it is not alphabetical: identity, then money,
+ * then people, then selling, then places, then the storefront, then the log.
+ * That is the order below.
+ *
+ * ON THE LABELS: an ampersand is fine when the second half says what else is
+ * inside — `Team & permissions`, `Billing & plan`, `Login & security`,
+ * `Data & privacy` each tell you something the first word alone does not. What
+ * is not fine is a word from our side of the fence:
+ *
+ * `Operations` → **Locations**. An umbrella nobody says out loud; the row lands
+ * on the locations list, hours and booking policy are tabs of a location, and
+ * Locations is what both Shopify and Square call it.
+ *
+ * `Integrations` → **Connections**. Integration is a developer's word for what
+ * a merchant experiences as connecting their WhatsApp or their Google Calendar.
+ * Not `Apps` — that is Shopify's word for a marketplace we do not have, and the
+ * label would promise a store that isn't there.
+ *
+ * `Tracking`, not Shopify's `Customer events`: a merchant running Meta ads
+ * already calls it tracking, and "customer events" is a platform's internal
+ * noun leaking into the nav.
+ */
+export declare const BUSINESS_GROUPS: {
+    label: string;
+    items: SettingsItem[];
+}[];
+export declare const ACCOUNT_ROUTE_PREFIXES: string[];
+export declare const parseSidebarHref: (href: string) => {
+    path: string;
+    intent: string | null;
+    /**
+     * Everything else the row narrows by — `group`, `tab`, `view`.
+     *
+     * This was `group` alone, added because a business with more than one group
+     * of bookable things reaches the roster through rows that all lead to the
+     * same PATH: without it every row lit and the tie-break picked whichever
+     * href was longer. Every OTHER param is the same row on the same path, and
+     * was still invisible — see `active-href.ts`.
+     */
+    params: URLSearchParams;
+};
+/**
+ * The archetypes an `?intent=` narrows to.
+ *
+ * A comma list, because a collapsed row stands for every archetype behind it —
+ * a restaurant's Menu is `dine-in,food-orders`, which is neither one archetype
+ * nor all of them. One key is still the common case; empty means not narrowed.
+ */
+export declare const intentKeySet: (intent: string | null | undefined) => Set<string>;