@withpotter/components 0.13.0-next.101

package/dist/shell/sidebar-ask.d.ts

@@ -0,0 +1,6 @@
+export declare function SidebarAsk({ collapsed, variant, }: {
+    collapsed?: boolean;
+    /** `nav`: a row in the main nav list, drawn like the rows around it.
+     *  `icon`: a bare icon button for the head of the rail. */
+    variant?: 'row' | 'nav' | 'icon';
+}): import("react").JSX.Element;

package/dist/shell/sidebar-ask.js

@@ -0,0 +1,120 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { usePathname } from "@withpotter/lib/use-pathname";
+import { RailLabel } from "@withpotter/components/sidebar/rail-label";
+import { Search } from "lucide-react";
+import { AskPanel } from "./search-panel";
+import { usePotter } from "@withpotter/components/potter/potter-context";
+import { usePotterAsk } from "@withpotter/components/potter/use-potter-ask";
+import { useAuth } from "@withpotter/lib/auth-context";
+const OWNS_THE_THREAD = /* @__PURE__ */ new Set(["/dashboard", "/dashboard/ask"]);
+function SidebarAsk({
+  collapsed = false,
+  variant = "row"
+}) {
+  const [open, setOpen] = useState(false);
+  const { openPotter, messages } = usePotter();
+  const pathname = usePathname();
+  const recordsOnly = OWNS_THE_THREAD.has(pathname);
+  const ask = usePotterAsk();
+  const [value, setValue] = useState("");
+  const [scope, setScope] = useState(null);
+  const { tenant } = useAuth();
+  const inputRef = useRef(null);
+  const dismiss = useCallback(() => {
+    setValue("");
+    setScope(null);
+    setOpen(false);
+  }, []);
+  const openHere = useCallback(() => setOpen(true), []);
+  useEffect(() => {
+    const onKey = (e) => {
+      if (!((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === "k")) return;
+      const el = document.activeElement;
+      const tag = el?.tagName;
+      if (!open && (tag === "INPUT" || tag === "TEXTAREA" || el?.isContentEditable))
+        return;
+      e.preventDefault();
+      if (open) dismiss();
+      else openHere();
+    };
+    window.addEventListener("keydown", onKey);
+    return () => window.removeEventListener("keydown", onKey);
+  }, [open, openHere, dismiss]);
+  const submit = () => {
+    if (!value.trim() || value.trim().startsWith("/")) return;
+    ask(value.trim());
+    if (recordsOnly) {
+      dismiss();
+      return;
+    }
+    openPotter();
+    setValue("");
+    inputRef.current?.focus();
+  };
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    variant === "icon" ? /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        onClick: openHere,
+        className: "side-head-icon",
+        "aria-label": "Search",
+        title: "Search (\u2318K)",
+        "aria-haspopup": "dialog",
+        "aria-expanded": open,
+        children: /* @__PURE__ */ jsx(Search, { width: 16, height: 16 })
+      }
+    ) : variant === "nav" ? /* @__PURE__ */ jsx(RailLabel, { label: "Search", collapsed, children: /* @__PURE__ */ jsxs(
+      "button",
+      {
+        type: "button",
+        onClick: openHere,
+        className: "navlink",
+        "aria-haspopup": "dialog",
+        "aria-expanded": open,
+        "aria-label": collapsed ? "Search" : void 0,
+        children: [
+          /* @__PURE__ */ jsx("span", { className: "ic", children: /* @__PURE__ */ jsx(Search, { width: 18, height: 18 }) }),
+          /* @__PURE__ */ jsx("span", { className: "lbl", children: "Search" })
+        ]
+      }
+    ) }) : /* @__PURE__ */ jsxs(
+      "button",
+      {
+        type: "button",
+        onClick: openHere,
+        className: "side-foot-link",
+        title: collapsed ? "Search" : void 0,
+        "aria-haspopup": "dialog",
+        "aria-expanded": open,
+        children: [
+          /* @__PURE__ */ jsx(Search, { width: 15, height: 15, className: "shrink-0" }),
+          /* @__PURE__ */ jsx("span", { className: "lbl", children: "Search" }),
+          !collapsed && /* @__PURE__ */ jsx("kbd", { className: "side-foot-kbd", "aria-hidden": "true", children: "\u2318K" })
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      AskPanel,
+      {
+        open,
+        onClose: dismiss,
+        query: value,
+        messages: messages.length,
+        recordsOnly,
+        inputRef,
+        onQueryChange: setValue,
+        onSubmit: submit,
+        scope,
+        onScopeChange: setScope,
+        businessName: tenant?.businessName ?? "your business"
+      }
+    )
+  ] });
+}
+export {
+  SidebarAsk
+};
+//# sourceMappingURL=sidebar-ask.js.map

package/dist/shell/sidebar-ask.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shell/sidebar-ask.tsx"],"sourcesContent":["'use client';\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { usePathname } from '@withpotter/lib/use-pathname';\nimport { RailLabel } from '@withpotter/components/sidebar/rail-label';\nimport { Search } from 'lucide-react';\nimport { AskPanel } from './search-panel';\nimport { type Scope } from './search-scopes';\nimport { usePotter } from '@withpotter/components/potter/potter-context';\nimport { usePotterAsk } from '@withpotter/components/potter/use-potter-ask';\nimport { useAuth } from '@withpotter/lib/auth-context';\n\n/**\n * SEARCH — the rail's row, and the panel it summons.\n *\n * ── WHY POTTER LEFT THE CORNER ──\n *\n * Box used to live bottom-right, and the feedback from the team was that it\n * \"looks like support and works like support\". They were right, and the icon\n * was never the problem — THE POSITION IS THE PROBLEM. Intercom, Zendesk,\n * Drift and Crisp all put a round button in that exact corner, so that slot has\n * been trained for a decade to mean \"help desk\". A mark, a sparkle or a face\n * changes nothing: whatever sits there gets read as the thing that fetches a\n * human when the software has failed you. Which is the opposite of an assistant\n * you are supposed to work THROUGH.\n *\n * Arc's answer was to delete the chrome and put the input in the sidebar, and\n * we took it whole — for a while the field itself lived here, under the\n * workspace switcher, at Arc's slot.\n *\n * ── IT IS A ROW NOW, NOT A FIELD (John, 2026-09-03) ──\n *\n * That field was removed twice in ten minutes on 2026-08-25 — *\"remove the ask\n * anything on the side bar side put it on the footer sidebar\"*, then, with it\n * sitting in the footer, *\"the ask anything search bar remove it form the\n * sidebar\"* — and the objection read as being about a TEXT FIELD in a rail at\n * all: the sidebar is where you go somewhere, and a box you type sentences into\n * is a surface you work in. So desktop had no door to Box on any screen\n * between the home and /dashboard/ask, and no way to find a record by name\n * anywhere. This file sat unmounted for nine days.\n *\n * *\"we need somewhere to put search be it the search icon or search bar\"* —\n * John, 2026-09-03. A row is the shape that answers both complaints: a\n * magnifier, the word, and the shortcut, sitting in the foot with Help and\n * Workspace settings, reading as a destination like everything around it. The\n * input moved INTO the panel, where a surface you work in belongs.\n *\n * ── ONE DOOR, NOT TWO ──\n *\n * ⌘K used to open a command palette and the palette was never wrong as a\n * control; it was a SECOND PRODUCT. It searched records by name while the bar\n * took sentences, so the app had two doors with two different ideas of what a\n * question is, and \"which one do I use\" had no answer a merchant could reason\n * about. This is one field doing both: typing shows records live (typeahead, a\n * shortcut to a row), Enter hands the sentence to Box. ⌘K is back, and it\n * opens THIS — the note this file has always carried says the fast path, if it\n * ever returned, must open the same input and never a second thing.\n *\n * `useCommandSearch` is the old palette's search engine and it is still what\n * powers the typeahead, through `AskResults`. The modal went; the search\n * stayed.\n *\n * ── THE PANEL ──\n *\n * Centred, and the size of `AccountSettingsModal` — John, 2026-09-03. It hung\n * off the rail before that, and the argument for anchoring is in the panel's\n * own note below along with why it stopped holding once this became a thing\n * you summon from a keyboard rather than a field you clicked into.\n */\n/**\n * Routes that draw the conversation themselves.\n *\n * The row still appears on them — a rail row that vanishes on two screens is a\n * rail row a merchant cannot rely on — but the panel it opens carries records\n * ONLY. Drawing Box here would put the same thread on screen twice, once\n * behind a scrim, which is exactly what John caught in a screenshot when this\n * panel opened itself off the home bar's shared `open` flag.\n *\n * A SET, not one comparison, because a third surface will come and whoever\n * adds it will not read this file. Anything drawing `PotterSurface` full-size\n * belongs here.\n */\nconst OWNS_THE_THREAD = new Set(['/dashboard', '/dashboard/ask']);\n\nexport function SidebarAsk({\n  collapsed = false,\n  variant = 'row',\n}: {\n  collapsed?: boolean;\n  /** `nav`: a row in the main nav list, drawn like the rows around it.\n   *  `icon`: a bare icon button for the head of the rail. */\n  variant?: 'row' | 'nav' | 'icon';\n}) {\n  /**\n   * LOCAL, not Box's shared `open`.\n   *\n   * It used to read `usePotter().open`, and that is what made the panel throw\n   * itself over the home: `usePotterAsk` flips the shared flag from whichever\n   * door you used, so typing in the home's own bar opened this panel on top of\n   * the answer that had just landed underneath it. Summoning is this\n   * component's business; the conversation is Box's.\n   */\n  const [open, setOpen] = useState(false);\n  const { openPotter, messages } = usePotter();\n  const pathname = usePathname();\n  /** On a screen already drawing the thread, the panel is records only. */\n  const recordsOnly = OWNS_THE_THREAD.has(pathname);\n  const ask = usePotterAsk();\n  const [value, setValue] = useState('');\n  /** The chip that has been moved into the field, or null for everything. */\n  const [scope, setScope] = useState<Scope | null>(null);\n  const { tenant } = useAuth();\n  const inputRef = useRef<HTMLInputElement>(null);\n  /* Every close runs through here, `useModalBehaviour`'s Escape and scrim\n     included — closing on Escape used to leave the query behind, so the next\n     ⌘K opened on the last thing somebody searched for rather than an empty\n     box. */\n  const dismiss = useCallback(() => {\n    setValue('');\n    setScope(null);\n    setOpen(false);\n  }, []);\n\n  const openHere = useCallback(() => setOpen(true), []);\n\n  /**\n   * ⌘K, AND IT OPENS THIS.\n   *\n   * The shortcut belonged to the deleted command palette, and the note at the\n   * top of this file has always said that if the fast path came back it must\n   * open the same input rather than a second thing. This is that. Ignored while\n   * a field already has focus, so typing K in a search box does not summon a\n   * different search box on top of it.\n   */\n  useEffect(() => {\n    const onKey = (e: KeyboardEvent) => {\n      if (!((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'k')) return;\n      const el = document.activeElement;\n      const tag = el?.tagName;\n      if (\n        !open &&\n        (tag === 'INPUT' ||\n          tag === 'TEXTAREA' ||\n          (el as HTMLElement | null)?.isContentEditable)\n      )\n        return;\n      e.preventDefault();\n      if (open) dismiss();\n      else openHere();\n    };\n    window.addEventListener('keydown', onKey);\n    return () => window.removeEventListener('keydown', onKey);\n  }, [open, openHere, dismiss]);\n\n  const submit = () => {\n    // A slash is a create command (`/new`), handled by the list under the box.\n    if (!value.trim() || value.trim().startsWith('/')) return;\n    /* On a screen that draws the thread itself there is nowhere in this panel\n       to show a reply, so a sentence hands over to the surface that owns it and\n       the panel gets out of the way. */\n    ask(value.trim());\n    if (recordsOnly) {\n      dismiss();\n      return;\n    }\n    openPotter();\n    setValue('');\n    inputRef.current?.focus();\n  };\n\n  return (\n    <>\n      {/* The row. It carries `side-foot-link` like every other row in the foot\n          — same 28px, same optical column — because it IS one: a place you go,\n          not a box you fill in. The shortcut hint is the only thing here that\n          is not a label, and it sits on the right margin where a keyboard hint\n          sits in every product that has one. */}\n      {variant === 'icon' ? (\n        <button\n          type=\"button\"\n          onClick={openHere}\n          className=\"side-head-icon\"\n          aria-label=\"Search\"\n          title=\"Search (⌘K)\"\n          aria-haspopup=\"dialog\"\n          aria-expanded={open}\n        >\n          <Search width={16} height={16} />\n        </button>\n      ) : variant === 'nav' ? (\n        <RailLabel label=\"Search\" collapsed={collapsed}>\n          <button\n            type=\"button\"\n            onClick={openHere}\n            className=\"navlink\"\n            aria-haspopup=\"dialog\"\n            aria-expanded={open}\n            aria-label={collapsed ? 'Search' : undefined}\n          >\n            <span className=\"ic\">\n              <Search width={18} height={18} />\n            </span>\n            <span className=\"lbl\">Search</span>\n          </button>\n        </RailLabel>\n      ) : (\n        <button\n          type=\"button\"\n          onClick={openHere}\n          className=\"side-foot-link\"\n          title={collapsed ? 'Search' : undefined}\n          aria-haspopup=\"dialog\"\n          aria-expanded={open}\n        >\n          <Search width={15} height={15} className=\"shrink-0\" />\n          <span className=\"lbl\">Search</span>\n          {/* Dropped when the rail is collapsed rather than hidden in CSS: there\n              is no room beside a centred glyph, and a hint nobody can read is a\n              hint that should not have been painted. */}\n          {!collapsed && (\n            <kbd className=\"side-foot-kbd\" aria-hidden=\"true\">\n              ⌘K\n            </kbd>\n          )}\n        </button>\n      )}\n\n      <AskPanel\n        open={open}\n        onClose={dismiss}\n        query={value}\n        messages={messages.length}\n        recordsOnly={recordsOnly}\n        inputRef={inputRef}\n        onQueryChange={setValue}\n        onSubmit={submit}\n        scope={scope}\n        onScopeChange={setScope}\n        businessName={tenant?.businessName ?? 'your business'}\n      />\n    </>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/shell/sidebar-cards.d.ts

@@ -0,0 +1,32 @@
+import { type ReactNode } from 'react';
+/**
+ * What a host adds to the rail's foot and the business menu for its plan.
+ *
+ * Nothing here is on by default: a host that never wraps the dashboard in
+ * `SidebarCardsProvider` gets the rail it had. Olive does, because its plans
+ * come from its own engine and the pricing switches this package reads
+ * (`menuUpgrade`) are not what turns them on there.
+ */
+export interface SidebarCardsConfig {
+    /** The front card: where to go to change plan. Leave out on the top plan. */
+    upgrade?: {
+        title: string;
+        hint: string;
+        href: string;
+    };
+    /** The plan, as a tag on the current business in the business menu. */
+    planLabel?: string;
+}
+export declare function SidebarCardsProvider({ value, children, }: {
+    value: SidebarCardsConfig | null;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useSidebarCards(): SidebarCardsConfig | null;
+/**
+ * Two standing cards stacked at the foot of the rail, the way Lovable does it.
+ * At rest the Upgrade card sits in front with the next card's edge showing
+ * beneath it; on hover or focus the stack opens and both are readable. The back
+ * card is the setup progress, and it is simply absent once setup is done, which
+ * leaves the Upgrade card alone.
+ */
+export declare function SidebarCardStack(): import("react").JSX.Element | null;

package/dist/shell/sidebar-cards.js

@@ -0,0 +1,37 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import Link from "next/link";
+import { createContext, useContext } from "react";
+import { Zap } from "lucide-react";
+import { SetupProgress } from "../sidebar/setup-progress";
+const Context = createContext(null);
+function SidebarCardsProvider({
+  value,
+  children
+}) {
+  return /* @__PURE__ */ jsx(Context.Provider, { value, children });
+}
+function useSidebarCards() {
+  return useContext(Context);
+}
+function SidebarCardStack() {
+  const config = useSidebarCards();
+  if (!config?.upgrade) return null;
+  const { title, hint, href } = config.upgrade;
+  return /* @__PURE__ */ jsx("div", { className: "side-stack", children: /* @__PURE__ */ jsxs("div", { className: "side-stack-in", children: [
+    /* @__PURE__ */ jsxs(Link, { href, className: "side-stack-card side-stack-front", children: [
+      /* @__PURE__ */ jsxs("span", { className: "side-stack-text", children: [
+        /* @__PURE__ */ jsx("b", { children: title }),
+        /* @__PURE__ */ jsx("span", { children: hint })
+      ] }),
+      /* @__PURE__ */ jsx("span", { className: "side-stack-glyph", "aria-hidden": true, children: /* @__PURE__ */ jsx(Zap, { width: 15, height: 15 }) })
+    ] }),
+    /* @__PURE__ */ jsx(SetupProgress, { stacked: true })
+  ] }) });
+}
+export {
+  SidebarCardStack,
+  SidebarCardsProvider,
+  useSidebarCards
+};
+//# sourceMappingURL=sidebar-cards.js.map

package/dist/shell/sidebar-cards.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shell/sidebar-cards.tsx"],"sourcesContent":["'use client';\n\nimport Link from 'next/link';\nimport { createContext, useContext, type ReactNode } from 'react';\nimport { Zap } from 'lucide-react';\nimport { SetupProgress } from '../sidebar/setup-progress';\n\n/**\n * What a host adds to the rail's foot and the business menu for its plan.\n *\n * Nothing here is on by default: a host that never wraps the dashboard in\n * `SidebarCardsProvider` gets the rail it had. Olive does, because its plans\n * come from its own engine and the pricing switches this package reads\n * (`menuUpgrade`) are not what turns them on there.\n */\nexport interface SidebarCardsConfig {\n  /** The front card: where to go to change plan. Leave out on the top plan. */\n  upgrade?: { title: string; hint: string; href: string };\n  /** The plan, as a tag on the current business in the business menu. */\n  planLabel?: string;\n}\n\nconst Context = createContext<SidebarCardsConfig | null>(null);\n\nexport function SidebarCardsProvider({\n  value,\n  children,\n}: {\n  value: SidebarCardsConfig | null;\n  children: ReactNode;\n}) {\n  return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\nexport function useSidebarCards(): SidebarCardsConfig | null {\n  return useContext(Context);\n}\n\n/**\n * Two standing cards stacked at the foot of the rail, the way Lovable does it.\n * At rest the Upgrade card sits in front with the next card's edge showing\n * beneath it; on hover or focus the stack opens and both are readable. The back\n * card is the setup progress, and it is simply absent once setup is done, which\n * leaves the Upgrade card alone.\n */\nexport function SidebarCardStack() {\n  const config = useSidebarCards();\n\n  if (!config?.upgrade) return null;\n\n  const { title, hint, href } = config.upgrade;\n\n  return (\n    <div className=\"side-stack\">\n      <div className=\"side-stack-in\">\n        <Link href={href} className=\"side-stack-card side-stack-front\">\n          <span className=\"side-stack-text\">\n            <b>{title}</b>\n            <span>{hint}</span>\n          </span>\n          <span className=\"side-stack-glyph\" aria-hidden>\n            <Zap width={15} height={15} />\n          </span>\n        </Link>\n        <SetupProgress stacked />\n      </div>\n    </div>\n  );\n}\n"],"mappings":";AA+BS,cAyBC,YAzBD;AA7BT,OAAO,UAAU;AACjB,SAAS,eAAe,kBAAkC;AAC1D,SAAS,WAAW;AACpB,SAAS,qBAAqB;AAiB9B,MAAM,UAAU,cAAyC,IAAI;AAEtD,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA;AACF,GAGG;AACD,SAAO,oBAAC,QAAQ,UAAR,EAAiB,OAAe,UAAS;AACnD;AAEO,SAAS,kBAA6C;AAC3D,SAAO,WAAW,OAAO;AAC3B;AASO,SAAS,mBAAmB;AACjC,QAAM,SAAS,gBAAgB;AAE/B,MAAI,CAAC,QAAQ,QAAS,QAAO;AAE7B,QAAM,EAAE,OAAO,MAAM,KAAK,IAAI,OAAO;AAErC,SACE,oBAAC,SAAI,WAAU,cACb,+BAAC,SAAI,WAAU,iBACb;AAAA,yBAAC,QAAK,MAAY,WAAU,oCAC1B;AAAA,2BAAC,UAAK,WAAU,mBACd;AAAA,4BAAC,OAAG,iBAAM;AAAA,QACV,oBAAC,UAAM,gBAAK;AAAA,SACd;AAAA,MACA,oBAAC,UAAK,WAAU,oBAAmB,eAAW,MAC5C,8BAAC,OAAI,OAAO,IAAI,QAAQ,IAAI,GAC9B;AAAA,OACF;AAAA,IACA,oBAAC,iBAAc,SAAO,MAAC;AAAA,KACzB,GACF;AAEJ;","names":[]}

package/dist/shell/sidebar-footer.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The foot of the sidebar: who's in this business, and the things that are
+ * about YOU rather than about the page.
+ *
+ * One exception, and it leads: Take payment. It belongs to no page, which is
+ * precisely why it cannot live on one — see `take-payment-button.tsx`.
+ *
+ * THREE THINGS LEFT OR MOVED, against Lovable, the reference for this rail:
+ * workspace at the top, nav, then the foot. Lovable's bottom row is an avatar
+ * on the left and an inbox on the right, and ours is not any more — the
+ * account went into the switcher on 2026-09-03, so the last line is two
+ * switches rather than an identity.
+ *
+ *   Invite/Team  → BACK, and it is one row now rather than a face stack you
+ *                  could not act on. It went to the workspace switcher on the
+ *                  argument that adding someone to a business is a workspace
+ *                  act; scope turned
+ *                  out to be the wrong axis to sort that menu on.
+ *   Help         → BACK, on John's call 2026-08-23. It was moved to the home
+ *                  on the argument that a rail row for a twice-a-year
+ *                  destination is rail spent on the rare case. What that
+ *                  missed is WHEN it is wanted: a merchant looking for help is
+ *                  stuck on some screen deep in the app, and "go back to the
+ *                  home first" is the one instruction a stuck person will not
+ *                  follow. A rail row costs 30px on every screen and is on the
+ *                  screen where the trouble actually is. The two escapes that
+ *                  used to sit inside the ask intro — "Report a bug" and
+ *                  "Message the team" — are gone with it; this is where a
+ *                  person goes when something is wrong, and three doors to the
+ *                  same room is worse than one that is always visible.
+ *   Notifications→ BACK. It was built against a live API and mounted nowhere,
+ *                  so the whole read model had no face: notifications were
+ *                  being written and nobody could see one. It now shares the
+ *                  bottom line with the theme flip, the account having gone to
+ *                  the switcher.
+ *
+ * TWO WORKSPACE-SCOPE ROWS SIT HERE — Workspace settings and Team, moved back
+ * out of the switcher on John's call, 2026-09-03, and they are the LAST block
+ * before the account line rather than the first; the rows argue their own
+ * order where they are written. That is a deliberate hole in
+ * the "footer is person scope" line above, and the line is the thing that was
+ * wrong: a rail sorted by scope makes a merchant work out which scope a
+ * destination belongs to before they can find it, which is the same complaint
+ * the nav has. They are rows because they are destinations, and a destination
+ * you visit weekly should not be behind a control whose job is switching
+ * business. Both are gated — `canManageSettings` and, inside the row itself,
+ * `canManageTeam` — so someone working a shift sees neither.
+ *
+ * Pinned with margin-top:auto and nothing stretched to meet it: the gap above
+ * is the nav's breathing room, not a hole that wants filling.
+ */
+export declare function SidebarFooter({ collapsed, }: {
+    collapsed?: boolean;
+    /** Still passed by the sidebar until the navigation PR drops the footer's
+     *  old edit toggle; the footer no longer draws one. */
+    editing?: boolean;
+    onToggleEdit?: () => void;
+}): import("react").JSX.Element;

package/dist/shell/sidebar-footer.js

@@ -0,0 +1,49 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { usePathname } from "@withpotter/lib/use-pathname";
+import { useAuth } from "@withpotter/lib/auth-context";
+import { usePermissions } from "@withpotter/lib/use-permissions";
+import { NotificationsDropdown } from "../notifications-dropdown";
+import { SetupProgress } from "../sidebar/setup-progress";
+import { FootResourcesMenu } from "./foot-resources-menu";
+import { FootThemeMenu } from "./foot-theme-menu";
+import { PlanUpgradeLink } from "./plan-upgrade-link";
+import { SidebarCardStack, useSidebarCards } from "./sidebar-cards";
+function SidebarFooter({
+  collapsed = false
+}) {
+  const pathname = usePathname();
+  const { tenant } = useAuth();
+  const onSettings = pathname?.startsWith("/dashboard/settings") ?? false;
+  const iconBtn = "side-foot-link !w-7 !justify-center !gap-0 !px-0";
+  const { isOwner } = usePermissions();
+  const stacked = Boolean(useSidebarCards()?.upgrade) && isOwner && !collapsed && !onSettings;
+  return /* @__PURE__ */ jsxs("div", { className: "side-foot-wrap", children: [
+    stacked ? /* @__PURE__ */ jsx(SidebarCardStack, {}) : !collapsed && !onSettings && /* @__PURE__ */ jsx(SetupProgress, {}),
+    /* @__PURE__ */ jsxs("div", { className: "side-foot", children: [
+      !stacked && /* @__PURE__ */ jsx(PlanUpgradeLink, { collapsed }),
+      /* @__PURE__ */ jsx("div", { className: "side-foot-switch", children: /* @__PURE__ */ jsxs("div", { className: "side-foot-icons", children: [
+        /* @__PURE__ */ jsx(FootResourcesMenu, { className: "side-foot-link !w-auto" }),
+        /* @__PURE__ */ jsx(
+          "span",
+          {
+            "aria-hidden": "true",
+            className: "mx-1 h-4 w-px shrink-0 bg-[var(--border-subtle)]"
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          NotificationsDropdown,
+          {
+            tenantSlug: tenant?.slug,
+            className: iconBtn
+          }
+        ),
+        /* @__PURE__ */ jsx(FootThemeMenu, { className: iconBtn })
+      ] }) })
+    ] })
+  ] });
+}
+export {
+  SidebarFooter
+};
+//# sourceMappingURL=sidebar-footer.js.map

package/dist/shell/sidebar-footer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shell/sidebar-footer.tsx"],"sourcesContent":["'use client';\n\nimport { usePathname } from '@withpotter/lib/use-pathname';\nimport { useAuth } from '@withpotter/lib/auth-context';\nimport { usePermissions } from '@withpotter/lib/use-permissions';\nimport { NotificationsDropdown } from '../notifications-dropdown';\nimport { SetupProgress } from '../sidebar/setup-progress';\nimport { FootResourcesMenu } from './foot-resources-menu';\nimport { FootThemeMenu } from './foot-theme-menu';\nimport { PlanUpgradeLink } from './plan-upgrade-link';\nimport { SidebarCardStack, useSidebarCards } from './sidebar-cards';\n\n/**\n * The foot of the sidebar: who's in this business, and the things that are\n * about YOU rather than about the page.\n *\n * One exception, and it leads: Take payment. It belongs to no page, which is\n * precisely why it cannot live on one — see `take-payment-button.tsx`.\n *\n * THREE THINGS LEFT OR MOVED, against Lovable, the reference for this rail:\n * workspace at the top, nav, then the foot. Lovable's bottom row is an avatar\n * on the left and an inbox on the right, and ours is not any more — the\n * account went into the switcher on 2026-09-03, so the last line is two\n * switches rather than an identity.\n *\n *   Invite/Team  → BACK, and it is one row now rather than a face stack you\n *                  could not act on. It went to the workspace switcher on the\n *                  argument that adding someone to a business is a workspace\n *                  act; scope turned\n *                  out to be the wrong axis to sort that menu on.\n *   Help         → BACK, on John's call 2026-08-23. It was moved to the home\n *                  on the argument that a rail row for a twice-a-year\n *                  destination is rail spent on the rare case. What that\n *                  missed is WHEN it is wanted: a merchant looking for help is\n *                  stuck on some screen deep in the app, and \"go back to the\n *                  home first\" is the one instruction a stuck person will not\n *                  follow. A rail row costs 30px on every screen and is on the\n *                  screen where the trouble actually is. The two escapes that\n *                  used to sit inside the ask intro — \"Report a bug\" and\n *                  \"Message the team\" — are gone with it; this is where a\n *                  person goes when something is wrong, and three doors to the\n *                  same room is worse than one that is always visible.\n *   Notifications→ BACK. It was built against a live API and mounted nowhere,\n *                  so the whole read model had no face: notifications were\n *                  being written and nobody could see one. It now shares the\n *                  bottom line with the theme flip, the account having gone to\n *                  the switcher.\n *\n * TWO WORKSPACE-SCOPE ROWS SIT HERE — Workspace settings and Team, moved back\n * out of the switcher on John's call, 2026-09-03, and they are the LAST block\n * before the account line rather than the first; the rows argue their own\n * order where they are written. That is a deliberate hole in\n * the \"footer is person scope\" line above, and the line is the thing that was\n * wrong: a rail sorted by scope makes a merchant work out which scope a\n * destination belongs to before they can find it, which is the same complaint\n * the nav has. They are rows because they are destinations, and a destination\n * you visit weekly should not be behind a control whose job is switching\n * business. Both are gated — `canManageSettings` and, inside the row itself,\n * `canManageTeam` — so someone working a shift sees neither.\n *\n * Pinned with margin-top:auto and nothing stretched to meet it: the gap above\n * is the nav's breathing room, not a hole that wants filling.\n */\nexport function SidebarFooter({\n  collapsed = false,\n}: {\n  collapsed?: boolean;\n  /** Still passed by the sidebar until the navigation PR drops the footer's\n   *  old edit toggle; the footer no longer draws one. */\n  editing?: boolean;\n  onToggleEdit?: () => void;\n}) {\n  const pathname = usePathname();\n  const { tenant } = useAuth();\n  const onSettings = pathname?.startsWith('/dashboard/settings') ?? false;\n  /* The same shape as Support (`side-foot-link`: 28px, 10px corners, the same\n     hover and open fill), square so it holds only the icon. */\n  const iconBtn = 'side-foot-link !w-7 !justify-center !gap-0 !px-0';\n  /* A host that supplies plan cards gets the stack in place of the setup bar and\n     the Upgrade row; every other host keeps both exactly as they were. */\n  const { isOwner } = usePermissions();\n  const stacked = Boolean(useSidebarCards()?.upgrade) && isOwner && !collapsed && !onSettings;\n\n  return (\n    <div className=\"side-foot-wrap\">\n      {/* How far through setting up, ABOVE the foot's divider. Not on the\n          collapsed rail or inside settings, where there is no room or no need. */}\n      {stacked ? <SidebarCardStack /> : !collapsed && !onSettings && <SetupProgress />}\n      <div className=\"side-foot\">\n        {/* NO CARDS IN THE RAIL. John, 2026-09-03: *\"this credits card and refer\n          a business thingy, let's remove it from the sidebar footer... the\n          refer a business can be on the homepage and the credits maybe.\"*\n\n          Right, and the deck's own note had the reason without following it:\n          the argument for Lovable's stacked pair is that a sidebar can carry\n          two standing offers without spending two rows on them ALL DAY. It\n          still spends them on every screen — a merchant reading an order has a\n          credit meter and a referral pitch in the corner of their eye. The\n          home is where a business looks up rather than down, and it already\n          has a board built for exactly this: widgets a merchant can size,\n          move, or throw away, which is the one thing a rail card can never\n          offer.\n\n          The deck's mechanic is not lost. `AnimatedHeight` came out of the\n          create-business modal for it and stayed in `ui/`. */}\n\n        {/* Search is at the head of the rail now (see `sidebar.tsx`). */}\n\n        {/* NO HELP ROW. John, 2026-09-03: *\"let's remove the help and support\n          from the sidebar footer and let's see how the footer looks like\"*.\n\n          WHAT LEFT WITH IT, because this row was carrying more than its\n          label by the end of that day: Give feedback had been merged INTO the\n          help page an hour before (two rows for one errand), and\n          `/dashboard/help` is the only door in the app to support cases — it\n          is where \"Start a case\" and \"Your cases\" live. So removing one row\n          took out the app's only desktop route to help, to feedback, and to a\n          case a merchant had already opened.\n\n          The consolation written here was wrong and worth recording: it said\n          search covered part of it by answering from `HELP_TOPICS` inline. It\n          does not. `sidebar-ask` and `use-command-search` between them search\n          orders, customers, invoices, products and support cases, and no help\n          topic — so the removal left zero doors, not a partial one. That is\n          the shape of this whole class of bug: a row is deleted and the thing\n          that was supposed to absorb it never did.\n\n          IT NOW LIVES IN THE SWITCHER, which is where the note that used to\n          be here said it should go — `switcher-account-group`, two rows under\n          the person: Help & support, and Send feedback. The foot stays lean\n          and the doors exist. */}\n\n        {/* NO ASK FIELD IN THIS RAIL, at either end of it. John, 2026-08-25,\n            twice in ten minutes: first *\"remove the ask anything on the side\n            bar side put it on the footer sidebar\"*, then — with it sitting in\n            the footer — *\"the ask anything search bar remove it form the\n            sidebar\"*. Read together, the objection is not the slot, it is a\n            text field in the rail at all: the sidebar is where you go\n            somewhere, and a box you type sentences into is a surface you work\n            in.\n\n            So the app's doors to Box are the home's own bar, `/dashboard/\n            ask`, and `PotterLauncher` on mobile. Desktop has none on the\n            screens in between; that is the trade this makes, and the mount is\n            one revert away in `components/shell/sidebar-ask.tsx` if it should\n            come back somewhere that is not a rail. */}\n        {/* THE LAST LINE: the help menu, the notifications bell and the theme\n            flip, at the left. The account is in the workspace menu at the top\n            now (John, 2026-10-11). The bell is the one the note above says came\n            BACK: it had been left out of this line, so notifications were\n            written and still nobody could see one. */}\n        {/* Upgrade, only when the admin switches it on (Pricing › Display). */}\n        {!stacked && <PlanUpgradeLink collapsed={collapsed} />}\n        <div className=\"side-foot-switch\">\n          <div className=\"side-foot-icons\">\n            <FootResourcesMenu className=\"side-foot-link !w-auto\" />\n            <span\n              aria-hidden=\"true\"\n              className=\"mx-1 h-4 w-px shrink-0 bg-[var(--border-subtle)]\"\n            />\n            <NotificationsDropdown\n              tenantSlug={tenant?.slug}\n              className={iconBtn}\n            />\n            <FootThemeMenu className={iconBtn} />\n          </div>\n        </div>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";AAuFiB,cAmEP,YAnEO;AArFjB,SAAS,mBAAmB;AAC5B,SAAS,eAAe;AACxB,SAAS,sBAAsB;AAC/B,SAAS,6BAA6B;AACtC,SAAS,qBAAqB;AAC9B,SAAS,yBAAyB;AAClC,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAChC,SAAS,kBAAkB,uBAAuB;AAqD3C,SAAS,cAAc;AAAA,EAC5B,YAAY;AACd,GAMG;AACD,QAAM,WAAW,YAAY;AAC7B,QAAM,EAAE,OAAO,IAAI,QAAQ;AAC3B,QAAM,aAAa,UAAU,WAAW,qBAAqB,KAAK;AAGlE,QAAM,UAAU;AAGhB,QAAM,EAAE,QAAQ,IAAI,eAAe;AACnC,QAAM,UAAU,QAAQ,gBAAgB,GAAG,OAAO,KAAK,WAAW,CAAC,aAAa,CAAC;AAEjF,SACE,qBAAC,SAAI,WAAU,kBAGZ;AAAA,cAAU,oBAAC,oBAAiB,IAAK,CAAC,aAAa,CAAC,cAAc,oBAAC,iBAAc;AAAA,IAC9E,qBAAC,SAAI,WAAU,aAgEZ;AAAA,OAAC,WAAW,oBAAC,mBAAgB,WAAsB;AAAA,MACpD,oBAAC,SAAI,WAAU,oBACb,+BAAC,SAAI,WAAU,mBACb;AAAA,4BAAC,qBAAkB,WAAU,0BAAyB;AAAA,QACtD;AAAA,UAAC;AAAA;AAAA,YACC,eAAY;AAAA,YACZ,WAAU;AAAA;AAAA,QACZ;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,YAAY,QAAQ;AAAA,YACpB,WAAW;AAAA;AAAA,QACb;AAAA,QACA,oBAAC,iBAAc,WAAW,SAAS;AAAA,SACrC,GACF;AAAA,OACF;AAAA,KACF;AAEJ;","names":[]}

package/dist/shell/sidebar-seam-toggle.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The sidebar's collapse control: a chevron on the rail's right edge. It is
+ * also bound to ⌘\.
+ *
+ * Rendered by the layout rather than inside the sidebar so the rail's
+ * `overflow: hidden` cannot clip it, and it springs to the new edge position on
+ * toggle (elastic overshoot).
+ *
+ * IT SITS ON THE SIDEBAR'S OWN EDGE, 1px past it, so the 20px pill ends inside
+ * the 12px gutter and never reaches the content card. It used to be centred on
+ * the card's edge, which put half of it on a light surface and half on a dark
+ * one once the card could be light, and at its resting 55% opacity a dark pill
+ * across that join washed out to a grey blob with an unreadable chevron.
+ */
+export declare function SidebarSeamToggle({ collapsed, onToggle, }: {
+    collapsed: boolean;
+    onToggle: () => void;
+}): import("react").JSX.Element;

package/dist/shell/sidebar-seam-toggle.js

@@ -0,0 +1,25 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { ChevronLeft } from "lucide-react";
+function SidebarSeamToggle({
+  collapsed,
+  onToggle
+}) {
+  return /* @__PURE__ */ jsx(
+    "button",
+    {
+      type: "button",
+      onClick: onToggle,
+      className: "shell-seam-toggle hidden lg:grid",
+      "data-collapsed": collapsed,
+      style: { left: (collapsed ? 68 : 236) + 1 },
+      title: collapsed ? "Expand sidebar (\u2318\\)" : "Collapse sidebar (\u2318\\)",
+      "aria-label": collapsed ? "Expand sidebar" : "Collapse sidebar",
+      children: /* @__PURE__ */ jsx(ChevronLeft, { width: 14, height: 14 })
+    }
+  );
+}
+export {
+  SidebarSeamToggle
+};
+//# sourceMappingURL=sidebar-seam-toggle.js.map

package/dist/shell/sidebar-seam-toggle.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shell/sidebar-seam-toggle.tsx"],"sourcesContent":["'use client';\n\nimport { ChevronLeft } from 'lucide-react';\n\n/**\n * The sidebar's collapse control: a chevron on the rail's right edge. It is\n * also bound to ⌘\\.\n *\n * Rendered by the layout rather than inside the sidebar so the rail's\n * `overflow: hidden` cannot clip it, and it springs to the new edge position on\n * toggle (elastic overshoot).\n *\n * IT SITS ON THE SIDEBAR'S OWN EDGE, 1px past it, so the 20px pill ends inside\n * the 12px gutter and never reaches the content card. It used to be centred on\n * the card's edge, which put half of it on a light surface and half on a dark\n * one once the card could be light, and at its resting 55% opacity a dark pill\n * across that join washed out to a grey blob with an unreadable chevron.\n */\nexport function SidebarSeamToggle({\n  collapsed,\n  onToggle,\n}: {\n  collapsed: boolean;\n  onToggle: () => void;\n}) {\n  return (\n    <button\n      type=\"button\"\n      onClick={onToggle}\n      className=\"shell-seam-toggle hidden lg:grid\"\n      data-collapsed={collapsed}\n      style={{ left: (collapsed ? 68 : 236) + 1 }}\n      title={collapsed ? 'Expand sidebar (⌘\\\\)' : 'Collapse sidebar (⌘\\\\)'}\n      aria-label={collapsed ? 'Expand sidebar' : 'Collapse sidebar'}\n    >\n      <ChevronLeft width={14} height={14} />\n    </button>\n  );\n}\n"],"mappings":";AAmCM;AAjCN,SAAS,mBAAmB;AAgBrB,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AACF,GAGG;AACD,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL,SAAS;AAAA,MACT,WAAU;AAAA,MACV,kBAAgB;AAAA,MAChB,OAAO,EAAE,OAAO,YAAY,KAAK,OAAO,EAAE;AAAA,MAC1C,OAAO,YAAY,8BAAyB;AAAA,MAC5C,cAAY,YAAY,mBAAmB;AAAA,MAE3C,8BAAC,eAAY,OAAO,IAAI,QAAQ,IAAI;AAAA;AAAA,EACtC;AAEJ;","names":[]}

package/dist/shell/switcher-location-group.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A pin on the closed trigger while one branch is selected: a scope nobody can
+ * see is the reason a page looks empty. Nothing when viewing everything.
+ */
+export declare function LocationScopePin(): import("react").JSX.Element | null;
+/**
+ * Locations, as a row with a flyout beside it.
+ *
+ * The branches used to be listed flat in the business menu, above the team and
+ * settings rows, with "Manage locations" as a bare line at the end. The row now
+ * says what it is — Locations, with an arrow — and the choice opens beside it on
+ * hover or press: every branch (the one in view ticked), and a button through
+ * to the full page.
+ *
+ * "All locations" is a real choice and the default. Renders nothing for a
+ * single-site business, which is almost every business: a switcher with one
+ * option is a control that cannot be used. Staff assigned to one branch see it
+ * too, but the API narrows their lists whatever they pick — this is a view, not
+ * a permission.
+ *
+ * The flyout is portalled and fixed, because the menu scrolls and a child
+ * positioned inside it would be clipped. It carries `data-pv-psw-flyout` so the
+ * menu's outside-press handler knows a press in it is not outside.
+ */
+export declare function SwitcherLocationGroup({ onPicked, onManage, }: {
+    onPicked: () => void;
+    onManage: () => void;
+}): import("react").JSX.Element | null;

package/dist/shell/switcher-location-group.js

@@ -0,0 +1,152 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { createPortal } from "react-dom";
+import {
+  ArrowUpRight,
+  Check,
+  ChevronRight,
+  MapPin,
+  MapPinned
+} from "lucide-react";
+import { useLocationScope } from "@withpotter/lib/location-scope-context";
+function LocationScopePin() {
+  const { activeLocationName } = useLocationScope();
+  if (!activeLocationName) return null;
+  return /* @__PURE__ */ jsx(
+    MapPin,
+    {
+      width: 13,
+      height: 13,
+      "aria-label": `Viewing ${activeLocationName}`
+    }
+  );
+}
+function SwitcherLocationGroup({
+  onPicked,
+  onManage
+}) {
+  const { locations, isMultiSite, activeLocationId, setActiveLocationId } = useLocationScope();
+  const rowRef = useRef(null);
+  const closeTimer = useRef(void 0);
+  const [open, setOpen] = useState(false);
+  const [pos, setPos] = useState(null);
+  const FLY_W = 240;
+  const show = () => {
+    window.clearTimeout(closeTimer.current);
+    const rect = rowRef.current?.getBoundingClientRect();
+    if (!rect) return;
+    const room = window.innerWidth - rect.right - 12;
+    setPos({
+      top: Math.max(8, rect.top - 5),
+      left: room >= FLY_W ? rect.right + 6 : Math.max(8, rect.left - FLY_W - 6)
+    });
+    setOpen(true);
+  };
+  const hideSoon = () => {
+    window.clearTimeout(closeTimer.current);
+    closeTimer.current = window.setTimeout(() => setOpen(false), 160);
+  };
+  useEffect(() => () => window.clearTimeout(closeTimer.current), []);
+  if (!isMultiSite) return null;
+  const options = [
+    { id: null, label: "All locations" },
+    ...locations.map((l) => ({ id: l.id, label: l.name }))
+  ];
+  return /* @__PURE__ */ jsxs("div", { role: "group", "aria-label": "Location", onMouseLeave: hideSoon, children: [
+    /* @__PURE__ */ jsxs(
+      "button",
+      {
+        ref: rowRef,
+        type: "button",
+        className: "pv-psw-row",
+        role: "menuitem",
+        "aria-haspopup": "menu",
+        "aria-expanded": open,
+        onMouseEnter: show,
+        onClick: () => open ? setOpen(false) : show(),
+        onKeyDown: (e) => {
+          if (e.key === "ArrowRight") {
+            e.preventDefault();
+            e.stopPropagation();
+            show();
+          }
+        },
+        children: [
+          /* @__PURE__ */ jsx(MapPinned, { width: 15, height: 15 }),
+          /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate", children: "Locations" }),
+          /* @__PURE__ */ jsx(ChevronRight, { width: 14, height: 14, className: "opacity-60" })
+        ]
+      }
+    ),
+    open && pos && typeof document !== "undefined" && createPortal(
+      /* @__PURE__ */ jsxs(
+        "div",
+        {
+          "data-pv-psw-flyout": true,
+          role: "menu",
+          "aria-label": "Locations",
+          className: "pv-psw-menu",
+          style: { top: pos.top, left: pos.left, width: FLY_W },
+          onMouseEnter: () => window.clearTimeout(closeTimer.current),
+          onMouseLeave: hideSoon,
+          onKeyDown: (e) => {
+            if (e.key === "ArrowLeft") {
+              e.stopPropagation();
+              setOpen(false);
+              rowRef.current?.focus();
+            }
+          },
+          children: [
+            options.map((option) => {
+              const selected = activeLocationId === option.id;
+              return /* @__PURE__ */ jsxs(
+                "button",
+                {
+                  type: "button",
+                  className: "pv-psw-row",
+                  role: "menuitemradio",
+                  "aria-checked": selected,
+                  onClick: () => {
+                    setActiveLocationId(option.id);
+                    setOpen(false);
+                    onPicked();
+                  },
+                  children: [
+                    /* @__PURE__ */ jsx(MapPin, { width: 15, height: 15 }),
+                    /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate", children: option.label }),
+                    selected && /* @__PURE__ */ jsx(Check, { width: 15, height: 15 })
+                  ]
+                },
+                option.id ?? "all"
+              );
+            }),
+            /* @__PURE__ */ jsx("div", { className: "pv-psw-sep" }),
+            /* @__PURE__ */ jsxs(
+              "button",
+              {
+                type: "button",
+                className: "pv-psw-row",
+                role: "menuitem",
+                onClick: () => {
+                  setOpen(false);
+                  onManage();
+                },
+                children: [
+                  /* @__PURE__ */ jsx(ArrowUpRight, { width: 15, height: 15 }),
+                  /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate", children: "Manage all locations" })
+                ]
+              }
+            )
+          ]
+        }
+      ),
+      document.body
+    )
+  ] });
+}
+export {
+  LocationScopePin,
+  SwitcherLocationGroup
+};
+//# sourceMappingURL=switcher-location-group.js.map

package/dist/shell/switcher-location-group.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shell/switcher-location-group.tsx"],"sourcesContent":["'use client';\n\nimport { useEffect, useRef, useState } from 'react';\nimport { createPortal } from 'react-dom';\nimport {\n  ArrowUpRight,\n  Check,\n  ChevronRight,\n  MapPin,\n  MapPinned,\n} from 'lucide-react';\nimport { useLocationScope } from '@withpotter/lib/location-scope-context';\n\n/**\n * A pin on the closed trigger while one branch is selected: a scope nobody can\n * see is the reason a page looks empty. Nothing when viewing everything.\n */\nexport function LocationScopePin() {\n  const { activeLocationName } = useLocationScope();\n  if (!activeLocationName) return null;\n  return (\n    <MapPin\n      width={13}\n      height={13}\n      aria-label={`Viewing ${activeLocationName}`}\n    />\n  );\n}\n\n/**\n * Locations, as a row with a flyout beside it.\n *\n * The branches used to be listed flat in the business menu, above the team and\n * settings rows, with \"Manage locations\" as a bare line at the end. The row now\n * says what it is — Locations, with an arrow — and the choice opens beside it on\n * hover or press: every branch (the one in view ticked), and a button through\n * to the full page.\n *\n * \"All locations\" is a real choice and the default. Renders nothing for a\n * single-site business, which is almost every business: a switcher with one\n * option is a control that cannot be used. Staff assigned to one branch see it\n * too, but the API narrows their lists whatever they pick — this is a view, not\n * a permission.\n *\n * The flyout is portalled and fixed, because the menu scrolls and a child\n * positioned inside it would be clipped. It carries `data-pv-psw-flyout` so the\n * menu's outside-press handler knows a press in it is not outside.\n */\nexport function SwitcherLocationGroup({\n  onPicked,\n  onManage,\n}: {\n  onPicked: () => void;\n  onManage: () => void;\n}) {\n  const { locations, isMultiSite, activeLocationId, setActiveLocationId } =\n    useLocationScope();\n  const rowRef = useRef<HTMLButtonElement>(null);\n  const closeTimer = useRef<number | undefined>(undefined);\n  const [open, setOpen] = useState(false);\n  const [pos, setPos] = useState<{ top: number; left: number } | null>(null);\n\n  const FLY_W = 240;\n\n  const show = () => {\n    window.clearTimeout(closeTimer.current);\n    const rect = rowRef.current?.getBoundingClientRect();\n    if (!rect) return;\n    // Right of the row; left of it when the screen runs out.\n    const room = window.innerWidth - rect.right - 12;\n    setPos({\n      top: Math.max(8, rect.top - 5),\n      left: room >= FLY_W ? rect.right + 6 : Math.max(8, rect.left - FLY_W - 6),\n    });\n    setOpen(true);\n  };\n  // A short grace, so the pointer can cross the gap between row and flyout.\n  const hideSoon = () => {\n    window.clearTimeout(closeTimer.current);\n    closeTimer.current = window.setTimeout(() => setOpen(false), 160);\n  };\n\n  useEffect(() => () => window.clearTimeout(closeTimer.current), []);\n\n  if (!isMultiSite) return null;\n\n  const options = [\n    { id: null, label: 'All locations' },\n    ...locations.map((l) => ({ id: l.id as string | null, label: l.name })),\n  ];\n\n  return (\n    <div role=\"group\" aria-label=\"Location\" onMouseLeave={hideSoon}>\n      <button\n        ref={rowRef}\n        type=\"button\"\n        className=\"pv-psw-row\"\n        role=\"menuitem\"\n        aria-haspopup=\"menu\"\n        aria-expanded={open}\n        onMouseEnter={show}\n        onClick={() => (open ? setOpen(false) : show())}\n        onKeyDown={(e) => {\n          if (e.key === 'ArrowRight') {\n            e.preventDefault();\n            e.stopPropagation();\n            show();\n          }\n        }}\n      >\n        <MapPinned width={15} height={15} />\n        <span className=\"min-w-0 flex-1 truncate\">Locations</span>\n        <ChevronRight width={14} height={14} className=\"opacity-60\" />\n      </button>\n\n      {open &&\n        pos &&\n        typeof document !== 'undefined' &&\n        createPortal(\n          <div\n            data-pv-psw-flyout\n            role=\"menu\"\n            aria-label=\"Locations\"\n            className=\"pv-psw-menu\"\n            style={{ top: pos.top, left: pos.left, width: FLY_W }}\n            onMouseEnter={() => window.clearTimeout(closeTimer.current)}\n            onMouseLeave={hideSoon}\n            onKeyDown={(e) => {\n              if (e.key === 'ArrowLeft') {\n                e.stopPropagation();\n                setOpen(false);\n                rowRef.current?.focus();\n              }\n            }}\n          >\n            {options.map((option) => {\n              const selected = activeLocationId === option.id;\n              return (\n                <button\n                  key={option.id ?? 'all'}\n                  type=\"button\"\n                  className=\"pv-psw-row\"\n                  role=\"menuitemradio\"\n                  aria-checked={selected}\n                  onClick={() => {\n                    setActiveLocationId(option.id);\n                    setOpen(false);\n                    onPicked();\n                  }}\n                >\n                  <MapPin width={15} height={15} />\n                  <span className=\"min-w-0 flex-1 truncate\">\n                    {option.label}\n                  </span>\n                  {selected && <Check width={15} height={15} />}\n                </button>\n              );\n            })}\n            <div className=\"pv-psw-sep\" />\n            <button\n              type=\"button\"\n              className=\"pv-psw-row\"\n              role=\"menuitem\"\n              onClick={() => {\n                setOpen(false);\n                onManage();\n              }}\n            >\n              <ArrowUpRight width={15} height={15} />\n              <span className=\"min-w-0 flex-1 truncate\">\n                Manage all locations\n              </span>\n            </button>\n          </div>,\n          document.body,\n        )}\n    </div>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/shell/switcher-scrim.d.ts

@@ -0,0 +1,2 @@
+/** The dim behind the switcher menu. Styled by `.pv-psw-scrim` in shell.css. */
+export declare function SwitcherScrim(): import("react").JSX.Element;