@withpotter/lib 0.13.0-next.101

package/dist/theme-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/theme-context.tsx"],"sourcesContent":["'use client';\n\nimport {\n  createContext,\n  useContext,\n  useEffect,\n  useRef,\n  useState,\n  ReactNode,\n  useCallback,\n} from 'react';\nimport { Sun, Moon, Monitor } from 'lucide-react';\nimport { usePathname } from '@withpotter/lib/use-pathname';\nimport {\n  DESKTOP_QUERY,\n  LIGHT_SURFACE,\n  isDesktopWindow,\n  rootThemeFor,\n  shellLightFor,\n  themeForPath,\n} from './theme-policy';\nimport { ViewSwitch, type ViewOption } from '@withpotter/ui-kit/view-switch';\n\ntype Theme = 'light' | 'dark' | 'system';\ntype ResolvedTheme = 'light' | 'dark';\nexport type ThemeMode = 'dark' | 'light' | 'full-light';\n\ninterface ThemeContextType {\n  theme: Theme;\n  resolvedTheme: ResolvedTheme;\n  /**\n   * The desktop dashboard's content card should be light. The page root stays\n   * dark there, so the sidebar and everything that opens over the page do too;\n   * see `rootThemeFor`.\n   */\n  shellLight: boolean;\n  /**\n   * The three looks of the desktop dashboard: all dark; a light card on a dark\n   * frame; and everything light. `cycleThemeMode` steps through them.\n   */\n  themeMode: ThemeMode;\n  cycleThemeMode: () => void;\n  /** Go straight to one of the three looks. */\n  setThemeMode: (mode: ThemeMode) => void;\n  setTheme: (theme: Theme) => void;\n  toggleTheme: () => void;\n}\n\nconst ThemeContext = createContext<ThemeContextType | undefined>(undefined);\n\nconst STORAGE_KEY = 'potter-theme';\n/** `light` when the frame goes light with the card. Read by the pre-paint script. */\nconst FRAME_KEY = 'potter-theme-frame';\n\n/**\n * Fallback theme when the visitor has no stored preference. A box can pin its\n * default via NEXT_PUBLIC_BOX_DEFAULT_THEME (light | dark | system), inlined by\n * Next at build time. Defaults to 'dark' when unset or invalid. Users can\n * still toggle — their choice is persisted and always wins over this default.\n */\nconst DEFAULT_THEME: Theme = (() => {\n  const v = (process.env.NEXT_PUBLIC_BOX_DEFAULT_THEME ?? '').toLowerCase();\n  return v === 'light' || v === 'dark' || v === 'system'\n    ? (v as Theme)\n    : 'dark';\n})();\n\nfunction getSystemTheme(): ResolvedTheme {\n  if (typeof window === 'undefined') return 'light';\n  return window.matchMedia('(prefers-color-scheme: dark)').matches\n    ? 'dark'\n    : 'light';\n}\n\n/**\n * Switching look repaints every surface at once, but each one has its own\n * colour transition (0.12s here, 0.2s there), so the page used to flicker as\n * they landed at different times. Transitions are switched off for the frame\n * the look changes in, then restored.\n */\nfunction withoutTransitions(change: () => void) {\n  const style = document.createElement('style');\n  style.textContent =\n    '*,*::before,*::after{transition:none !important;animation-duration:0s !important}';\n  document.head.appendChild(style);\n  change();\n  // Force the new styles to be computed with transitions off before lifting.\n  void window.getComputedStyle(document.documentElement).opacity;\n  requestAnimationFrame(() => requestAnimationFrame(() => style.remove()));\n}\n\nexport function ThemeProvider({ children }: { children: ReactNode }) {\n  const pathname = usePathname();\n  // Dark is the default; an explicitly stored choice still wins. These\n  // seeds must match the pre-paint script in app/layout.tsx.\n  const [theme, setThemeState] = useState<Theme>('dark');\n  const [resolvedTheme, setResolvedTheme] = useState<ResolvedTheme>('dark');\n  const [mounted, setMounted] = useState(false);\n  /* Whether this is a large screen. A ref as well as state, because\n     `applyTheme` is called from event handlers and must read the current value\n     without being re-created every time the window crosses the breakpoint. */\n  const [desktop, setDesktop] = useState(false);\n  const desktopRef = useRef(false);\n  const [frameLight, setFrameLight] = useState(false);\n  const frameLightRef = useRef(false);\n\n  // Apply theme to document\n  const applyTheme = useCallback((resolved: ResolvedTheme) => {\n    const root = document.documentElement;\n    /* On a large dashboard screen the root is dark whatever was chosen, and\n       the setting only decides whether the content card is light. */\n    const applied = rootThemeFor(\n      resolved,\n      window.location.pathname,\n      desktopRef.current,\n      frameLightRef.current,\n    );\n    root.classList.remove('light', 'dark');\n    root.classList.add(applied);\n    root.style.colorScheme = applied;\n    /* Say on the root when the card is light, so CSS can give everything that\n       opens over it (dialogs, menus, toasts) the same light; see globals.css. */\n    if (\n      shellLightFor(\n        resolved,\n        window.location.pathname,\n        desktopRef.current,\n        frameLightRef.current,\n      )\n    ) {\n      root.dataset.shellLight = 'true';\n    } else {\n      delete root.dataset.shellLight;\n    }\n  }, []);\n\n  // Set theme and persist\n  const setTheme = useCallback(\n    (newTheme: Theme) => {\n      setThemeState(newTheme);\n      localStorage.setItem(STORAGE_KEY, newTheme);\n      const resolved = themeForPath(newTheme, getSystemTheme(), pathname);\n      applyTheme(resolved);\n      setResolvedTheme(resolved);\n    },\n    [applyTheme, pathname],\n  );\n\n  // Toggle between light and dark\n  const toggleTheme = useCallback(() => {\n    const newTheme = resolvedTheme === 'light' ? 'dark' : 'light';\n    setTheme(newTheme);\n  }, [resolvedTheme, setTheme]);\n\n  const themeMode: ThemeMode =\n    resolvedTheme === 'dark' ? 'dark' : frameLight ? 'full-light' : 'light';\n\n  const setThemeMode = useCallback(\n    (next: ThemeMode) => {\n      withoutTransitions(() => {\n        const frame = next === 'full-light';\n        frameLightRef.current = frame;\n        setFrameLight(frame);\n        localStorage.setItem(FRAME_KEY, frame ? 'light' : 'dark');\n        setTheme(next === 'dark' ? 'dark' : 'light');\n      });\n    },\n    [setTheme],\n  );\n\n  // Dark → light card on a dark frame → everything light → dark.\n  const cycleThemeMode = useCallback(() => {\n    setThemeMode(\n      themeMode === 'dark'\n        ? 'light'\n        : themeMode === 'light'\n          ? 'full-light'\n          : 'dark',\n    );\n  }, [themeMode, setThemeMode]);\n\n  // Initialize theme on mount - use layout effect to avoid flash\n  useEffect(() => {\n    // Read stored theme synchronously during initial render\n    const stored = localStorage.getItem(STORAGE_KEY) as Theme | null;\n    const initialTheme = stored ?? DEFAULT_THEME;\n    const path = window.location.pathname;\n    frameLightRef.current = localStorage.getItem(FRAME_KEY) === 'light';\n    desktopRef.current = isDesktopWindow(\n      window.matchMedia(DESKTOP_QUERY).matches,\n      window.self !== window.top,\n    );\n    // Apply theme immediately to avoid flash\n    const resolvedInitialTheme = themeForPath(\n      initialTheme,\n      getSystemTheme(),\n      path,\n    );\n    applyTheme(resolvedInitialTheme);\n\n    // Then update React state\n    // Using a microtask to batch state updates\n    queueMicrotask(() => {\n      setThemeState(initialTheme);\n      setResolvedTheme(resolvedInitialTheme);\n      setDesktop(desktopRef.current);\n      setFrameLight(frameLightRef.current);\n      setMounted(true);\n    });\n  }, [applyTheme]);\n\n  /* Crossing the breakpoint (a window resized, a tablet turned) swaps between\n     the phone's arrangement and the desktop's, so the root is re-applied. */\n  useEffect(() => {\n    const query = window.matchMedia(DESKTOP_QUERY);\n    const onChange = (event: MediaQueryListEvent) => {\n      const isDesktop = isDesktopWindow(\n        event.matches,\n        window.self !== window.top,\n      );\n      desktopRef.current = isDesktop;\n      setDesktop(isDesktop);\n      applyTheme(themeForPath(theme, getSystemTheme(), pathname));\n    };\n    query.addEventListener('change', onChange);\n    return () => query.removeEventListener('change', onChange);\n  }, [theme, pathname, applyTheme]);\n\n  // Navigation must restore the current preference, never a palette captured\n  // by an entry screen before the merchant changed their setting.\n  useEffect(() => {\n    if (!mounted) return;\n    const resolved = themeForPath(theme, getSystemTheme(), pathname);\n    applyTheme(resolved);\n    let active = true;\n    queueMicrotask(() => {\n      if (active) setResolvedTheme(resolved);\n    });\n    return () => {\n      active = false;\n    };\n  }, [mounted, theme, pathname, applyTheme]);\n\n  // Listen for system theme changes\n  useEffect(() => {\n    if (theme !== 'system') return;\n\n    const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\n    const handleChange = () => {\n      const resolved = themeForPath(theme, getSystemTheme(), pathname);\n      applyTheme(resolved);\n      setResolvedTheme(resolved);\n    };\n\n    mediaQuery.addEventListener('change', handleChange);\n    return () => mediaQuery.removeEventListener('change', handleChange);\n  }, [theme, pathname, applyTheme]);\n\n  // Always wrap in provider, but hide visually until mounted to prevent flash\n  return (\n    <ThemeContext.Provider\n      value={{\n        theme,\n        resolvedTheme,\n        shellLight:\n          mounted &&\n          shellLightFor(resolvedTheme, pathname, desktop, frameLight),\n        themeMode,\n        cycleThemeMode,\n        setThemeMode,\n        setTheme,\n        toggleTheme,\n      }}\n    >\n      <div style={mounted ? undefined : { visibility: 'hidden' }}>\n        {children}\n      </div>\n    </ThemeContext.Provider>\n  );\n}\n\nexport function useTheme() {\n  const context = useContext(ThemeContext);\n  if (context === undefined) {\n    throw new Error('useTheme must be used within a ThemeProvider');\n  }\n  return context;\n}\n\n/**\n * Three-way display control: Light / Dark / System. Reflects the chosen\n * SETTING (so \"System\" stays selectable and visible), not the resolved theme.\n *\n * `ViewSwitch`, because that is what this always was: one set re-drawn, a\n * recessed track with the chosen segment lifted out of it. It had been a\n * hand-rolled copy in `shell.css` — same shape, but the lifted chip carried\n * `rgba(0, 0, 0, 0.08)`, frozen in light theme on a control whose whole job is\n * switching to dark, and its icons were 15px, either side of the scale.\n */\nconst THEME_SEGMENTS: ViewOption<Theme>[] = [\n  { value: 'light', label: 'Light', icon: Sun },\n  { value: 'dark', label: 'Dark', icon: Moon },\n  { value: 'system', label: 'System', icon: Monitor },\n];\n\nexport function ThemeSegmented({ className }: { className?: string } = {}) {\n  const { theme, setTheme } = useTheme();\n  return (\n    <ViewSwitch\n      options={THEME_SEGMENTS}\n      value={theme}\n      onChange={setTheme}\n      size=\"comfortable\"\n      aria-label=\"Theme\"\n      className={className}\n    />\n  );\n}\n\nconst THEME_HINT = 'Light or dark theme';\n\n/**\n * Theme toggle. By default a bare icon button, as before.\n *\n * `hint` says what the button is for, because an icon alone was not found:\n * - 'label'   — the words sit beside the icon, always visible. Use where there is room.\n * - 'tooltip' — the words appear under the button on hover, keyboard focus, and\n *               after a tap. Use in a tight icon row.\n */\nexport function ThemeToggle({\n  className = '',\n  hint = 'none',\n}: {\n  className?: string;\n  hint?: 'none' | 'label' | 'tooltip';\n}) {\n  const { resolvedTheme, toggleTheme } = useTheme();\n  const button = (\n    <ThemeToggleButton\n      className={className}\n      resolvedTheme={resolvedTheme}\n      onToggle={toggleTheme}\n      showLabel={hint === 'label'}\n    />\n  );\n\n  if (hint !== 'tooltip') return button;\n\n  // The button's aria-label already names it for screen readers, so the\n  // tooltip is for sighted users only.\n  return (\n    <span className=\"group relative inline-flex\">\n      {button}\n      <span\n        aria-hidden=\"true\"\n        className=\"pointer-events-none absolute right-0 top-full z-50 mt-1 hidden whitespace-nowrap rounded-md border border-[var(--border-default)] bg-[var(--bg-base)] px-2 py-1 text-xs text-[var(--text-secondary)] group-hover:block group-focus-within:block\"\n      >\n        {THEME_HINT}\n      </span>\n    </span>\n  );\n}\n\nfunction ThemeToggleButton({\n  className,\n  resolvedTheme,\n  onToggle,\n  showLabel,\n}: {\n  className: string;\n  resolvedTheme: ResolvedTheme;\n  onToggle: () => void;\n  showLabel: boolean;\n}) {\n  const next = resolvedTheme === 'light' ? 'dark' : 'light';\n\n  return (\n    <button\n      type=\"button\"\n      onClick={onToggle}\n      className={`\n        ${showLabel ? 'inline-flex items-center gap-2 text-sm' : ''}\n        p-2 rounded-md transition-colors\n        text-[var(--text-tertiary)] hover:text-[var(--text-secondary)] hover:bg-[var(--interactive-active)]\n        dark:text-[var(--text-muted)] dark:hover:text-[var(--text-secondary)] dark:hover:bg-[var(--text-primary)]\n        ${className}\n      `}\n      aria-label={\n        showLabel\n          ? `${THEME_HINT}: switch to ${next}`\n          : `Switch to ${next} mode`\n      }\n    >\n      {resolvedTheme === 'dark' ? (\n        <svg className=\"w-5 h-5\" fill=\"currentColor\" viewBox=\"0 0 20 20\">\n          <path\n            fillRule=\"evenodd\"\n            d=\"M10 2a1 1 0 011 1v1a1 1 0 11-2 0V3a1 1 0 011-1zm4 8a4 4 0 11-8 0 4 4 0 018 0zm-.464 4.95l.707.707a1 1 0 001.414-1.414l-.707-.707a1 1 0 00-1.414 1.414zm2.12-10.607a1 1 0 010 1.414l-.706.707a1 1 0 11-1.414-1.414l.707-.707a1 1 0 011.414 0zM17 11a1 1 0 100-2h-1a1 1 0 100 2h1zm-7 4a1 1 0 011 1v1a1 1 0 11-2 0v-1a1 1 0 011-1zM5.05 6.464A1 1 0 106.465 5.05l-.708-.707a1 1 0 00-1.414 1.414l.707.707zm1.414 8.486l-.707.707a1 1 0 01-1.414-1.414l.707-.707a1 1 0 011.414 1.414zM4 11a1 1 0 100-2H3a1 1 0 000 2h1z\"\n            clipRule=\"evenodd\"\n          />\n        </svg>\n      ) : (\n        <svg className=\"w-5 h-5\" fill=\"currentColor\" viewBox=\"0 0 20 20\">\n          <path d=\"M17.293 13.293A8 8 0 016.707 2.707a8.001 8.001 0 1010.586 10.586z\" />\n        </svg>\n      )}\n      {showLabel && <span>{THEME_HINT}</span>}\n    </button>\n  );\n}\n\n/**\n * Whether the desktop dashboard's content card is light, for anything that\n * needs to follow it. Unlike `useTheme` it does not throw outside the provider\n * (a popup rendered somewhere the provider does not reach): it says false.\n */\nexport function useShellLight(): boolean {\n  return useContext(ThemeContext)?.shellLight ?? false;\n}\n\n/**\n * The class that makes a popup light while the desktop card is. Menus, selects\n * and panels mount on the body, outside the card, so they would otherwise\n * inherit the dark root and float over a white page as dark boxes. Dialogs,\n * menus and toasts are also covered by one rule in globals.css keyed on the\n * root, so this is for the popups that style themselves.\n */\nexport function useLightSurface(): string {\n  return useShellLight() ? LIGHT_SURFACE : '';\n}\n"],"mappings":"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","names":[]}

package/dist/theme-policy.d.ts

@@ -0,0 +1,41 @@
+export type ThemePreference = 'light' | 'dark' | 'system';
+export type ResolvedTheme = 'light' | 'dark';
+export declare function isDarkEntryPath(path: string): boolean;
+export declare function themeForPath(preference: ThemePreference, systemTheme: ResolvedTheme, path: string): ResolvedTheme;
+/** The classes that make a subtree light on a dark page (see `.mb-force-light`). */
+export declare const LIGHT_SURFACE = "mb-force-light text-[var(--text-primary)]";
+/**
+ * A window inside a frame (the settings window is a page in an iframe) is not
+ * "the desktop dashboard", whatever its width: the frame around it is what is
+ * dark, and the page inside follows the setting. Saying so here keeps that from
+ * depending on the frame happening to be narrower than the breakpoint.
+ */
+export declare function isDesktopWindow(matchesQuery: boolean, framed: boolean): boolean;
+/** The `lg` breakpoint: where the dashboard stops being the phone shell. */
+export declare const DESKTOP_QUERY = "(min-width: 1024px)";
+export declare function isDashboardPath(path: string): boolean;
+/**
+ * THE DESKTOP DASHBOARD HAS A DARK FRAME AND A CONTENT CARD THAT FOLLOWS THE
+ * SETTING.
+ *
+ * On a large screen the sidebar, the ground around the card and everything that
+ * opens over the page (dialogs, menus, the settings window, toasts) stay dark
+ * whatever was chosen; the light setting turns the content card light and
+ * nothing else. It is the phone's arrangement (a dark frame around a light
+ * sheet), with the setting deciding whether the sheet is light.
+ *
+ * So for those screens the page root is always dark, and `shellLightFor` says
+ * whether the card on it should be light. Everywhere else, and on a phone, the
+ * root follows the setting as it always did.
+ */
+export declare function rootThemeFor(resolved: ResolvedTheme, path: string, desktop: boolean, frameLight?: boolean): ResolvedTheme;
+export declare function shellLightFor(resolved: ResolvedTheme, path: string, desktop: boolean, frameLight?: boolean): boolean;
+/**
+ * FULL LIGHT: the frame goes light too.
+ *
+ * The arrangement above is the default for a light setting: a light card on a
+ * dark frame. Some people want the whole screen light, sidebar and everything
+ * that opens over the page included, so `frameLight` lets the root follow the
+ * setting on the desktop dashboard instead of staying dark. It only means
+ * anything when the setting is light.
+ */

package/dist/theme-policy.js

@@ -0,0 +1,32 @@
+function isDarkEntryPath(path) {
+  return path === "/login" || path === "/onboarding" || path.startsWith("/onboarding/");
+}
+function themeForPath(preference, systemTheme, path) {
+  if (isDarkEntryPath(path)) return "dark";
+  return preference === "system" ? systemTheme : preference;
+}
+const LIGHT_SURFACE = "mb-force-light text-[var(--text-primary)]";
+function isDesktopWindow(matchesQuery, framed) {
+  return matchesQuery && !framed;
+}
+const DESKTOP_QUERY = "(min-width: 1024px)";
+function isDashboardPath(path) {
+  return path === "/dashboard" || path.startsWith("/dashboard/");
+}
+function rootThemeFor(resolved, path, desktop, frameLight = false) {
+  return desktop && isDashboardPath(path) && !frameLight ? "dark" : resolved;
+}
+function shellLightFor(resolved, path, desktop, frameLight = false) {
+  return desktop && isDashboardPath(path) && resolved === "light" && !frameLight;
+}
+export {
+  DESKTOP_QUERY,
+  LIGHT_SURFACE,
+  isDarkEntryPath,
+  isDashboardPath,
+  isDesktopWindow,
+  rootThemeFor,
+  shellLightFor,
+  themeForPath
+};
+//# sourceMappingURL=theme-policy.js.map

package/dist/theme-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/theme-policy.ts"],"sourcesContent":["export type ThemePreference = 'light' | 'dark' | 'system';\nexport type ResolvedTheme = 'light' | 'dark';\n\nexport function isDarkEntryPath(path: string): boolean {\n  return (\n    path === '/login' ||\n    path === '/onboarding' ||\n    path.startsWith('/onboarding/')\n  );\n}\n\nexport function themeForPath(\n  preference: ThemePreference,\n  systemTheme: ResolvedTheme,\n  path: string,\n): ResolvedTheme {\n  if (isDarkEntryPath(path)) return 'dark';\n  return preference === 'system' ? systemTheme : preference;\n}\n\n/** The classes that make a subtree light on a dark page (see `.mb-force-light`). */\nexport const LIGHT_SURFACE = 'mb-force-light text-[var(--text-primary)]';\n\n/**\n * A window inside a frame (the settings window is a page in an iframe) is not\n * \"the desktop dashboard\", whatever its width: the frame around it is what is\n * dark, and the page inside follows the setting. Saying so here keeps that from\n * depending on the frame happening to be narrower than the breakpoint.\n */\nexport function isDesktopWindow(\n  matchesQuery: boolean,\n  framed: boolean,\n): boolean {\n  return matchesQuery && !framed;\n}\n\n/** The `lg` breakpoint: where the dashboard stops being the phone shell. */\nexport const DESKTOP_QUERY = '(min-width: 1024px)';\n\nexport function isDashboardPath(path: string): boolean {\n  return path === '/dashboard' || path.startsWith('/dashboard/');\n}\n\n/**\n * THE DESKTOP DASHBOARD HAS A DARK FRAME AND A CONTENT CARD THAT FOLLOWS THE\n * SETTING.\n *\n * On a large screen the sidebar, the ground around the card and everything that\n * opens over the page (dialogs, menus, the settings window, toasts) stay dark\n * whatever was chosen; the light setting turns the content card light and\n * nothing else. It is the phone's arrangement (a dark frame around a light\n * sheet), with the setting deciding whether the sheet is light.\n *\n * So for those screens the page root is always dark, and `shellLightFor` says\n * whether the card on it should be light. Everywhere else, and on a phone, the\n * root follows the setting as it always did.\n */\nexport function rootThemeFor(\n  resolved: ResolvedTheme,\n  path: string,\n  desktop: boolean,\n  frameLight = false,\n): ResolvedTheme {\n  return desktop && isDashboardPath(path) && !frameLight ? 'dark' : resolved;\n}\n\nexport function shellLightFor(\n  resolved: ResolvedTheme,\n  path: string,\n  desktop: boolean,\n  frameLight = false,\n): boolean {\n  return (\n    desktop && isDashboardPath(path) && resolved === 'light' && !frameLight\n  );\n}\n\n/**\n * FULL LIGHT: the frame goes light too.\n *\n * The arrangement above is the default for a light setting: a light card on a\n * dark frame. Some people want the whole screen light, sidebar and everything\n * that opens over the page included, so `frameLight` lets the root follow the\n * setting on the desktop dashboard instead of staying dark. It only means\n * anything when the setting is light.\n */\n"],"mappings":"AAGO,SAAS,gBAAgB,MAAuB;AACrD,SACE,SAAS,YACT,SAAS,iBACT,KAAK,WAAW,cAAc;AAElC;AAEO,SAAS,aACd,YACA,aACA,MACe;AACf,MAAI,gBAAgB,IAAI,EAAG,QAAO;AAClC,SAAO,eAAe,WAAW,cAAc;AACjD;AAGO,MAAM,gBAAgB;AAQtB,SAAS,gBACd,cACA,QACS;AACT,SAAO,gBAAgB,CAAC;AAC1B;AAGO,MAAM,gBAAgB;AAEtB,SAAS,gBAAgB,MAAuB;AACrD,SAAO,SAAS,gBAAgB,KAAK,WAAW,aAAa;AAC/D;AAgBO,SAAS,aACd,UACA,MACA,SACA,aAAa,OACE;AACf,SAAO,WAAW,gBAAgB,IAAI,KAAK,CAAC,aAAa,SAAS;AACpE;AAEO,SAAS,cACd,UACA,MACA,SACA,aAAa,OACJ;AACT,SACE,WAAW,gBAAgB,IAAI,KAAK,aAAa,WAAW,CAAC;AAEjE;","names":[]}

package/dist/ticket-access.d.ts

@@ -0,0 +1,20 @@
+import type { BookingItem, TicketItem } from '@withpotter/lib/api/types';
+type TicketCodeCarrier = Pick<TicketItem, 'ticketCode'> | null | undefined;
+type BookingCodeCarrier = Pick<BookingItem, 'ticketCode' | 'quantity'> | null | undefined;
+/**
+ * A ticket code the rest of the app can rely on.
+ *
+ * Codes arrive from two places today: the ticket row itself, and the booking
+ * record for older or single-ticket flows. The second is only safe to use when
+ * one code really can stand for the booking.
+ */
+export declare function resolveTicketCode(input: {
+    ticket?: TicketCodeCarrier;
+    booking?: BookingCodeCarrier;
+}): string | null;
+export declare function normaliseTicketCode(value: string | null | undefined): string | null;
+export declare function buildTicketCheckInPath(ticketCode: string): string;
+export declare function buildCustomerTicketPath(tenantSlug: string, ticketCode: string): string;
+export declare function buildTicketCheckInUrl(origin: string, ticketCode: string): string;
+export declare function findTicketByCode(tickets: TicketItem[], ticketCode: string, booking?: BookingCodeCarrier): TicketItem | null;
+export {};

package/dist/ticket-access.js

@@ -0,0 +1,39 @@
+function resolveTicketCode(input) {
+  const ticketCode = normaliseTicketCode(input.ticket?.ticketCode);
+  if (ticketCode) return ticketCode;
+  const bookingCode = normaliseTicketCode(input.booking?.ticketCode);
+  if (!bookingCode) return null;
+  const quantity = input.booking?.quantity;
+  return quantity == null || quantity <= 1 ? bookingCode : null;
+}
+function normaliseTicketCode(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  return trimmed ? trimmed : null;
+}
+function buildTicketCheckInPath(ticketCode) {
+  return `/check-in/t/${encodeURIComponent(ticketCode)}`;
+}
+function buildCustomerTicketPath(tenantSlug, ticketCode) {
+  return `/tickets/${encodeURIComponent(tenantSlug)}/${encodeURIComponent(ticketCode)}`;
+}
+function buildTicketCheckInUrl(origin, ticketCode) {
+  return new URL(buildTicketCheckInPath(ticketCode), origin).toString();
+}
+function findTicketByCode(tickets, ticketCode, booking) {
+  const normalisedTarget = normaliseTicketCode(ticketCode);
+  if (!normalisedTarget) return null;
+  const exact = tickets.find(
+    (ticket) => resolveTicketCode({ ticket, booking }) === normalisedTarget
+  );
+  return exact ?? null;
+}
+export {
+  buildCustomerTicketPath,
+  buildTicketCheckInPath,
+  buildTicketCheckInUrl,
+  findTicketByCode,
+  normaliseTicketCode,
+  resolveTicketCode
+};
+//# sourceMappingURL=ticket-access.js.map

package/dist/ticket-access.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ticket-access.ts"],"sourcesContent":["import type { BookingItem, TicketItem } from '@withpotter/lib/api/types';\n\ntype TicketCodeCarrier = Pick<TicketItem, 'ticketCode'> | null | undefined;\ntype BookingCodeCarrier =\n  Pick<BookingItem, 'ticketCode' | 'quantity'> | null | undefined;\n\n/**\n * A ticket code the rest of the app can rely on.\n *\n * Codes arrive from two places today: the ticket row itself, and the booking\n * record for older or single-ticket flows. The second is only safe to use when\n * one code really can stand for the booking.\n */\nexport function resolveTicketCode(input: {\n  ticket?: TicketCodeCarrier;\n  booking?: BookingCodeCarrier;\n}): string | null {\n  const ticketCode = normaliseTicketCode(input.ticket?.ticketCode);\n  if (ticketCode) return ticketCode;\n\n  const bookingCode = normaliseTicketCode(input.booking?.ticketCode);\n  if (!bookingCode) return null;\n\n  const quantity = input.booking?.quantity;\n  return quantity == null || quantity <= 1 ? bookingCode : null;\n}\n\nexport function normaliseTicketCode(\n  value: string | null | undefined,\n): string | null {\n  if (typeof value !== 'string') return null;\n  const trimmed = value.trim();\n  return trimmed ? trimmed : null;\n}\n\nexport function buildTicketCheckInPath(ticketCode: string): string {\n  return `/check-in/t/${encodeURIComponent(ticketCode)}`;\n}\n\nexport function buildCustomerTicketPath(\n  tenantSlug: string,\n  ticketCode: string,\n): string {\n  return `/tickets/${encodeURIComponent(tenantSlug)}/${encodeURIComponent(ticketCode)}`;\n}\n\nexport function buildTicketCheckInUrl(\n  origin: string,\n  ticketCode: string,\n): string {\n  return new URL(buildTicketCheckInPath(ticketCode), origin).toString();\n}\n\nexport function findTicketByCode(\n  tickets: TicketItem[],\n  ticketCode: string,\n  booking?: BookingCodeCarrier,\n): TicketItem | null {\n  const normalisedTarget = normaliseTicketCode(ticketCode);\n  if (!normalisedTarget) return null;\n\n  const exact = tickets.find(\n    (ticket) => resolveTicketCode({ ticket, booking }) === normalisedTarget,\n  );\n  return exact ?? null;\n}\n"],"mappings":"AAaO,SAAS,kBAAkB,OAGhB;AAChB,QAAM,aAAa,oBAAoB,MAAM,QAAQ,UAAU;AAC/D,MAAI,WAAY,QAAO;AAEvB,QAAM,cAAc,oBAAoB,MAAM,SAAS,UAAU;AACjE,MAAI,CAAC,YAAa,QAAO;AAEzB,QAAM,WAAW,MAAM,SAAS;AAChC,SAAO,YAAY,QAAQ,YAAY,IAAI,cAAc;AAC3D;AAEO,SAAS,oBACd,OACe;AACf,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,MAAM,KAAK;AAC3B,SAAO,UAAU,UAAU;AAC7B;AAEO,SAAS,uBAAuB,YAA4B;AACjE,SAAO,eAAe,mBAAmB,UAAU,CAAC;AACtD;AAEO,SAAS,wBACd,YACA,YACQ;AACR,SAAO,YAAY,mBAAmB,UAAU,CAAC,IAAI,mBAAmB,UAAU,CAAC;AACrF;AAEO,SAAS,sBACd,QACA,YACQ;AACR,SAAO,IAAI,IAAI,uBAAuB,UAAU,GAAG,MAAM,EAAE,SAAS;AACtE;AAEO,SAAS,iBACd,SACA,YACA,SACmB;AACnB,QAAM,mBAAmB,oBAAoB,UAAU;AACvD,MAAI,CAAC,iBAAkB,QAAO;AAE9B,QAAM,QAAQ,QAAQ;AAAA,IACpB,CAAC,WAAW,kBAAkB,EAAE,QAAQ,QAAQ,CAAC,MAAM;AAAA,EACzD;AACA,SAAO,SAAS;AAClB;","names":[]}

package/dist/timeline-copy.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Timeline copy/messaging for the dashboard activity feed.
+ *
+ * All user-facing strings for the "What's happening" timeline live here
+ * so we can iterate on tone, A/B test, or add i18n without touching
+ * component logic.
+ *
+ * Each generator receives contextual data and returns { title, description }.
+ */
+export declare function productAdded(itemTitle: string, contentType: string): {
+    title: string;
+    description: string;
+    emoji: string;
+};
+export declare function productUpdated(itemTitle: string, contentType: string): {
+    title: string;
+    description: string;
+    emoji: string;
+};
+export declare function orderPlaced(customerName: string, orderNumber: string, formattedTotal: string, industryKey?: string | null, isPaid?: boolean): {
+    title: string;
+    description: string;
+    emoji: string;
+};
+export declare function orderCompleted(customerName: string, orderNumber: string): {
+    title: string;
+    description: string;
+    emoji: string;
+};
+export declare function memberSignup(name: string, email: string, industryKey?: string | null): {
+    title: string;
+    description: string;
+    emoji: string;
+};
+export declare function memberConverted(name: string, email: string): {
+    title: string;
+    description: string;
+    emoji: string;
+};
+export declare function subscriptionCreated(name: string, planName: string, formattedAmount: string): {
+    title: string;
+    description: string;
+    emoji: string;
+};
+export declare function invoicePaid(customerName: string, invoiceNumber: string, formattedAmount: string): {
+    title: string;
+    description: string;
+    emoji: string;
+};
+export declare function invoiceSent(customerName: string, invoiceNumber: string, formattedAmount: string): {
+    title: string;
+    description: string;
+    emoji: string;
+};
+export declare const emptyTimeline: {
+    heading: string;
+    subtext: string;
+};
+export declare function getEmptyTimeline(industryKey: string | null): {
+    heading: string;
+    subtext: string;
+};
+export declare const feedHeader = "What\u2019s happening";
+export declare function showMoreLabel(remaining: number): string;
+export declare const showLessLabel = "Show less";

package/dist/timeline-copy.js

@@ -0,0 +1,150 @@
+function productAdded(itemTitle, contentType) {
+  return {
+    title: `${itemTitle} is now live`,
+    description: `New ${contentType.toLowerCase()} added to your store`,
+    emoji: "\u{1F4E6}"
+  };
+}
+function productUpdated(itemTitle, contentType) {
+  return {
+    title: `${itemTitle} was updated`,
+    description: `You updated your ${contentType.toLowerCase()}`,
+    emoji: "\u{1F504}"
+  };
+}
+const ORDER_VERB = {
+  food: "ordered",
+  hospitality: "booked",
+  events: "purchased tickets for"
+};
+const UNPAID_ORDER_VERB = {
+  events: "started a ticket order for"
+};
+function orderPlaced(customerName, orderNumber, formattedTotal, industryKey, isPaid = true) {
+  const verbs = isPaid ? ORDER_VERB : { ...ORDER_VERB, ...UNPAID_ORDER_VERB };
+  const verb = industryKey && verbs[industryKey] || "placed an order";
+  return {
+    title: `${customerName} ${verb}`,
+    description: `${orderNumber} \u2022 ${formattedTotal}`,
+    emoji: "\u{1F6CD}\uFE0F"
+  };
+}
+function orderCompleted(customerName, orderNumber) {
+  return {
+    title: `${orderNumber} is fulfilled`,
+    description: `${customerName}'s order is complete`,
+    emoji: "\u2705"
+  };
+}
+const BOOKABLE_INDUSTRIES = /* @__PURE__ */ new Set([
+  "beauty",
+  "wellness",
+  "professional",
+  "fitness"
+]);
+function memberSignup(name, email, industryKey) {
+  const verb = industryKey && BOOKABLE_INDUSTRIES.has(industryKey) ? "became a client" : "joined your store";
+  return {
+    title: `${name} ${verb}`,
+    description: email,
+    emoji: "\u{1F464}"
+  };
+}
+function memberConverted(name, email) {
+  return {
+    title: `${name} just became a customer`,
+    description: `Converted from guest \xB7 ${email}`,
+    emoji: "\u{1F389}"
+  };
+}
+function subscriptionCreated(name, planName, formattedAmount) {
+  return {
+    title: `${name} subscribed to ${planName}`,
+    description: `Recurring revenue: ${formattedAmount}/month`,
+    emoji: "\u{1F4B3}"
+  };
+}
+function invoicePaid(customerName, invoiceNumber, formattedAmount) {
+  return {
+    title: `${customerName} paid invoice ${invoiceNumber}`,
+    description: `Payment received: ${formattedAmount}`,
+    emoji: "\u{1F4B0}"
+  };
+}
+function invoiceSent(customerName, invoiceNumber, formattedAmount) {
+  return {
+    title: `Invoice ${invoiceNumber} sent to ${customerName}`,
+    description: `Amount due: ${formattedAmount}`,
+    emoji: "\u{1F4E8}"
+  };
+}
+const INDUSTRY_EMPTY_TIMELINE = {
+  retail: {
+    heading: "Nothing here yet",
+    subtext: "Orders, signups, and updates will show up here as they happen."
+  },
+  beauty: {
+    heading: "Nothing here yet",
+    subtext: "Appointments, bookings, and client activity will show up here."
+  },
+  wellness: {
+    heading: "Nothing here yet",
+    subtext: "Appointments, bookings, and client activity will show up here."
+  },
+  hospitality: {
+    heading: "Nothing here yet",
+    subtext: "Reservations, guest check-ins, and updates will show up here."
+  },
+  food: {
+    heading: "Nothing here yet",
+    subtext: "Orders and customer activity will show up here as they happen."
+  },
+  fitness: {
+    heading: "Nothing here yet",
+    subtext: "Class sign-ups, member activity, and updates will show up here."
+  },
+  professional: {
+    heading: "Nothing here yet",
+    subtext: "Appointments, bookings, and client activity will show up here."
+  },
+  creative: {
+    heading: "Nothing here yet",
+    subtext: "Bookings, orders, and client activity will show up here."
+  },
+  events: {
+    heading: "Nothing here yet",
+    subtext: "Ticket sales, attendee activity, and event updates will show up here."
+  }
+};
+const emptyTimeline = {
+  heading: "Nothing here yet",
+  subtext: "Orders, signups, and updates will show up here as they happen."
+};
+function getEmptyTimeline(industryKey) {
+  if (industryKey && INDUSTRY_EMPTY_TIMELINE[industryKey]) {
+    return INDUSTRY_EMPTY_TIMELINE[industryKey];
+  }
+  return emptyTimeline;
+}
+const feedHeader = "What\u2019s happening";
+function showMoreLabel(remaining) {
+  return `Show ${remaining} more`;
+}
+const showLessLabel = "Show less";
+export {
+  emptyTimeline,
+  feedHeader,
+  getEmptyTimeline,
+  invoicePaid,
+  invoiceSent,
+  memberConverted,
+  memberSignup,
+  orderCompleted,
+  orderPlaced,
+  productAdded,
+  productUpdated,
+  showLessLabel,
+  showMoreLabel,
+  subscriptionCreated
+};
+//# sourceMappingURL=timeline-copy.js.map

package/dist/timeline-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/timeline-copy.ts"],"sourcesContent":["/**\n * Timeline copy/messaging for the dashboard activity feed.\n *\n * All user-facing strings for the \"What's happening\" timeline live here\n * so we can iterate on tone, A/B test, or add i18n without touching\n * component logic.\n *\n * Each generator receives contextual data and returns { title, description }.\n */\n\n// ─── Product / Content ──────────────────────────────────────────────\n\nexport function productAdded(itemTitle: string, contentType: string) {\n  return {\n    title: `${itemTitle} is now live`,\n    description: `New ${contentType.toLowerCase()} added to your store`,\n    emoji: '📦',\n  };\n}\n\nexport function productUpdated(itemTitle: string, contentType: string) {\n  return {\n    title: `${itemTitle} was updated`,\n    description: `You updated your ${contentType.toLowerCase()}`,\n    emoji: '🔄',\n  };\n}\n\n// ─── Orders ─────────────────────────────────────────────────────────\n\nconst ORDER_VERB: Record<string, string> = {\n  food: 'ordered',\n  hospitality: 'booked',\n  events: 'purchased tickets for',\n};\n\n// A ticket is only bought once it is paid. An unpaid ticket order is a checkout\n// that was started, and calling it a purchase puts money on the feed that is\n// not in the wallet.\nconst UNPAID_ORDER_VERB: Record<string, string> = {\n  events: 'started a ticket order for',\n};\n\nexport function orderPlaced(\n  customerName: string,\n  orderNumber: string,\n  formattedTotal: string,\n  industryKey?: string | null,\n  isPaid = true,\n) {\n  const verbs = isPaid ? ORDER_VERB : { ...ORDER_VERB, ...UNPAID_ORDER_VERB };\n  const verb = (industryKey && verbs[industryKey]) || 'placed an order';\n  return {\n    title: `${customerName} ${verb}`,\n    description: `${orderNumber} • ${formattedTotal}`,\n    emoji: '🛍️',\n  };\n}\n\nexport function orderCompleted(customerName: string, orderNumber: string) {\n  return {\n    title: `${orderNumber} is fulfilled`,\n    description: `${customerName}'s order is complete`,\n    emoji: '✅',\n  };\n}\n\n// ─── Customers / Members ────────────────────────────────────────────\n\nconst BOOKABLE_INDUSTRIES = new Set([\n  'beauty',\n  'wellness',\n  'professional',\n  'fitness',\n]);\n\nexport function memberSignup(\n  name: string,\n  email: string,\n  industryKey?: string | null,\n) {\n  const verb =\n    industryKey && BOOKABLE_INDUSTRIES.has(industryKey)\n      ? 'became a client'\n      : 'joined your store';\n  return {\n    title: `${name} ${verb}`,\n    description: email,\n    emoji: '👤',\n  };\n}\n\nexport function memberConverted(name: string, email: string) {\n  return {\n    title: `${name} just became a customer`,\n    description: `Converted from guest · ${email}`,\n    emoji: '🎉',\n  };\n}\n\n// ─── Subscriptions ──────────────────────────────────────────────────\n\nexport function subscriptionCreated(\n  name: string,\n  planName: string,\n  formattedAmount: string,\n) {\n  return {\n    title: `${name} subscribed to ${planName}`,\n    description: `Recurring revenue: ${formattedAmount}/month`,\n    emoji: '💳',\n  };\n}\n\n// ─── Invoices ───────────────────────────────────────────────────────\n\nexport function invoicePaid(\n  customerName: string,\n  invoiceNumber: string,\n  formattedAmount: string,\n) {\n  return {\n    title: `${customerName} paid invoice ${invoiceNumber}`,\n    description: `Payment received: ${formattedAmount}`,\n    emoji: '💰',\n  };\n}\n\nexport function invoiceSent(\n  customerName: string,\n  invoiceNumber: string,\n  formattedAmount: string,\n) {\n  return {\n    title: `Invoice ${invoiceNumber} sent to ${customerName}`,\n    description: `Amount due: ${formattedAmount}`,\n    emoji: '📨',\n  };\n}\n\n// ─── Empty state ────────────────────────────────────────────────────\n\nconst INDUSTRY_EMPTY_TIMELINE: Record<\n  string,\n  { heading: string; subtext: string }\n> = {\n  retail: {\n    heading: 'Nothing here yet',\n    subtext: 'Orders, signups, and updates will show up here as they happen.',\n  },\n  beauty: {\n    heading: 'Nothing here yet',\n    subtext: 'Appointments, bookings, and client activity will show up here.',\n  },\n  wellness: {\n    heading: 'Nothing here yet',\n    subtext: 'Appointments, bookings, and client activity will show up here.',\n  },\n  hospitality: {\n    heading: 'Nothing here yet',\n    subtext: 'Reservations, guest check-ins, and updates will show up here.',\n  },\n  food: {\n    heading: 'Nothing here yet',\n    subtext: 'Orders and customer activity will show up here as they happen.',\n  },\n  fitness: {\n    heading: 'Nothing here yet',\n    subtext: 'Class sign-ups, member activity, and updates will show up here.',\n  },\n  professional: {\n    heading: 'Nothing here yet',\n    subtext: 'Appointments, bookings, and client activity will show up here.',\n  },\n  creative: {\n    heading: 'Nothing here yet',\n    subtext: 'Bookings, orders, and client activity will show up here.',\n  },\n  events: {\n    heading: 'Nothing here yet',\n    subtext:\n      'Ticket sales, attendee activity, and event updates will show up here.',\n  },\n};\n\nexport const emptyTimeline = {\n  heading: 'Nothing here yet',\n  subtext: 'Orders, signups, and updates will show up here as they happen.',\n};\n\nexport function getEmptyTimeline(industryKey: string | null) {\n  if (industryKey && INDUSTRY_EMPTY_TIMELINE[industryKey]) {\n    return INDUSTRY_EMPTY_TIMELINE[industryKey];\n  }\n  return emptyTimeline;\n}\n\n// ─── Feed chrome ────────────────────────────────────────────────────\n\n// Curly apostrophe, matching every other apostrophe in the product's copy.\nexport const feedHeader = 'What’s happening';\n\nexport function showMoreLabel(remaining: number) {\n  return `Show ${remaining} more`;\n}\n\nexport const showLessLabel = 'Show less';\n"],"mappings":"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","names":[]}

package/dist/url-params.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The query-string arithmetic behind `useUrlState`, kept out of the hook so it
+ * can be tested without a renderer.
+ *
+ * The interesting part is `bufferFor`. Everything else is bookkeeping.
+ */
+export declare function bufferFor(pathname: string, current: string, 
+/** Injected in tests so the drain can be observed rather than waited on. */
+schedule?: (fn: () => void) => void): URLSearchParams;
+/** Only for tests, which share module state between cases. */
+export declare function resetBuffers(): void;
+/**
+ * Apply a patch, dropping anything that carries no information.
+ *
+ * A value equal to its default is removed rather than written, so clearing a
+ * filter does not leave `?status=` behind and the address stops growing a tail
+ * of empty params on every interaction.
+ */
+export declare function writeParams(params: URLSearchParams, patch: Record<string, string | undefined>, defaults: Record<string, string>): URLSearchParams;
+/** Drop the given keys, leaving anything else on the URL untouched. */
+export declare function clearParams(params: URLSearchParams, keys: string[]): URLSearchParams;
+/** The state a query string means, with defaults filled in for absent keys. */
+export declare function readParams<T extends Record<string, string>>(query: string, defaults: T): T;

package/dist/url-params.js

@@ -0,0 +1,43 @@
+const pending = /* @__PURE__ */ new Map();
+function bufferFor(pathname, current, schedule = queueMicrotask) {
+  const open = pending.get(pathname);
+  if (open) return open;
+  const fresh = new URLSearchParams(current);
+  pending.set(pathname, fresh);
+  schedule(() => pending.delete(pathname));
+  return fresh;
+}
+function resetBuffers() {
+  pending.clear();
+}
+function writeParams(params, patch, defaults) {
+  for (const [key, value] of Object.entries(patch)) {
+    if (value == null || value === "" || value === defaults[key]) {
+      params.delete(key);
+    } else {
+      params.set(key, String(value));
+    }
+  }
+  return params;
+}
+function clearParams(params, keys) {
+  for (const key of keys) params.delete(key);
+  return params;
+}
+function readParams(query, defaults) {
+  const params = new URLSearchParams(query);
+  const next = { ...defaults };
+  for (const key of Object.keys(defaults)) {
+    const raw = params.get(String(key));
+    if (raw != null) next[key] = raw;
+  }
+  return next;
+}
+export {
+  bufferFor,
+  clearParams,
+  readParams,
+  resetBuffers,
+  writeParams
+};
+//# sourceMappingURL=url-params.js.map

package/dist/url-params.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/url-params.ts"],"sourcesContent":["/**\n * The query-string arithmetic behind `useUrlState`, kept out of the hook so it\n * can be tested without a renderer.\n *\n * The interesting part is `bufferFor`. Everything else is bookkeeping.\n */\n\n/**\n * Writes made in one tick, composed.\n *\n * `useSearchParams` hands every caller the query string as it was at the last\n * render, so two writes in one handler both build on the same stale snapshot\n * and the second silently drops the first.\n *\n * That is not theoretical. The money rail's Refunds press sets a date window,\n * clears the cash filter, sets the type to refund and then changes the lens,\n * one after another in a single handler. Only the lens would survive, so the\n * merchant would press Refunds and be handed the unfiltered ledger under a\n * figure it could not add up to: the exact bug that moving filters into the URL\n * was meant to end.\n *\n * So writes accumulate into one buffer per path until the tick drains. Keyed by\n * pathname because two routes are two addresses, and a buffer outliving a\n * navigation would write one page's filters onto another.\n */\nconst pending = new Map<string, URLSearchParams>();\n\nexport function bufferFor(\n  pathname: string,\n  current: string,\n  /** Injected in tests so the drain can be observed rather than waited on. */\n  schedule: (fn: () => void) => void = queueMicrotask,\n): URLSearchParams {\n  const open = pending.get(pathname);\n  if (open) return open;\n  const fresh = new URLSearchParams(current);\n  pending.set(pathname, fresh);\n  // Drains after the handler that opened it, so the next interaction starts\n  // from whatever the URL actually became.\n  schedule(() => pending.delete(pathname));\n  return fresh;\n}\n\n/** Only for tests, which share module state between cases. */\nexport function resetBuffers(): void {\n  pending.clear();\n}\n\n/**\n * Apply a patch, dropping anything that carries no information.\n *\n * A value equal to its default is removed rather than written, so clearing a\n * filter does not leave `?status=` behind and the address stops growing a tail\n * of empty params on every interaction.\n */\nexport function writeParams(\n  params: URLSearchParams,\n  patch: Record<string, string | undefined>,\n  defaults: Record<string, string>,\n): URLSearchParams {\n  for (const [key, value] of Object.entries(patch)) {\n    if (value == null || value === '' || value === defaults[key]) {\n      params.delete(key);\n    } else {\n      params.set(key, String(value));\n    }\n  }\n  return params;\n}\n\n/** Drop the given keys, leaving anything else on the URL untouched. */\nexport function clearParams(\n  params: URLSearchParams,\n  keys: string[],\n): URLSearchParams {\n  for (const key of keys) params.delete(key);\n  return params;\n}\n\n/** The state a query string means, with defaults filled in for absent keys. */\nexport function readParams<T extends Record<string, string>>(\n  query: string,\n  defaults: T,\n): T {\n  const params = new URLSearchParams(query);\n  const next = { ...defaults };\n  for (const key of Object.keys(defaults) as (keyof T)[]) {\n    const raw = params.get(String(key));\n    if (raw != null) next[key] = raw as T[keyof T];\n  }\n  return next;\n}\n"],"mappings":"AAyBA,MAAM,UAAU,oBAAI,IAA6B;AAE1C,SAAS,UACd,UACA,SAEA,WAAqC,gBACpB;AACjB,QAAM,OAAO,QAAQ,IAAI,QAAQ;AACjC,MAAI,KAAM,QAAO;AACjB,QAAM,QAAQ,IAAI,gBAAgB,OAAO;AACzC,UAAQ,IAAI,UAAU,KAAK;AAG3B,WAAS,MAAM,QAAQ,OAAO,QAAQ,CAAC;AACvC,SAAO;AACT;AAGO,SAAS,eAAqB;AACnC,UAAQ,MAAM;AAChB;AASO,SAAS,YACd,QACA,OACA,UACiB;AACjB,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,SAAS,QAAQ,UAAU,MAAM,UAAU,SAAS,GAAG,GAAG;AAC5D,aAAO,OAAO,GAAG;AAAA,IACnB,OAAO;AACL,aAAO,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,IAC/B;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,YACd,QACA,MACiB;AACjB,aAAW,OAAO,KAAM,QAAO,OAAO,GAAG;AACzC,SAAO;AACT;AAGO,SAAS,WACd,OACA,UACG;AACH,QAAM,SAAS,IAAI,gBAAgB,KAAK;AACxC,QAAM,OAAO,EAAE,GAAG,SAAS;AAC3B,aAAW,OAAO,OAAO,KAAK,QAAQ,GAAkB;AACtD,UAAM,MAAM,OAAO,IAAI,OAAO,GAAG,CAAC;AAClC,QAAI,OAAO,KAAM,MAAK,GAAG,IAAI;AAAA,EAC/B;AACA,SAAO;AACT;","names":[]}

package/dist/use-behaviors.d.ts

@@ -0,0 +1,13 @@
+import { type BehaviorDefinition } from './api';
+interface UseBehaviorsReturn {
+    behaviors: BehaviorDefinition[];
+    isLoading: boolean;
+    error: string | null;
+    getBehavior: (id: string) => BehaviorDefinition | undefined;
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook to fetch and access the behavior registry
+ */
+export declare function useBehaviors(): UseBehaviorsReturn;
+export {};

package/dist/use-behaviors.js

@@ -0,0 +1,41 @@
+"use client";
+import { useState, useEffect, useCallback } from "react";
+import { behaviorsApi } from "./api";
+function useBehaviors() {
+  const [behaviors, setBehaviors] = useState([]);
+  const [isLoading, setIsLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const fetchBehaviors = useCallback(async () => {
+    try {
+      setIsLoading(true);
+      setError(null);
+      const response = await behaviorsApi.list();
+      setBehaviors(response.data);
+    } catch (err) {
+      setError(
+        err instanceof Error ? err.message : "Failed to fetch behaviors"
+      );
+      console.error("[useBehaviors] Error fetching behaviors:", err);
+    } finally {
+      setIsLoading(false);
+    }
+  }, []);
+  useEffect(() => {
+    fetchBehaviors();
+  }, [fetchBehaviors]);
+  const getBehavior = useCallback(
+    (id) => behaviors.find((b) => b.id === id),
+    [behaviors]
+  );
+  return {
+    behaviors,
+    isLoading,
+    error,
+    getBehavior,
+    refetch: fetchBehaviors
+  };
+}
+export {
+  useBehaviors
+};
+//# sourceMappingURL=use-behaviors.js.map

package/dist/use-behaviors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-behaviors.ts"],"sourcesContent":["'use client';\n\nimport { useState, useEffect, useCallback } from 'react';\nimport { behaviorsApi, type BehaviorDefinition } from './api';\n\ninterface UseBehaviorsReturn {\n  behaviors: BehaviorDefinition[];\n  isLoading: boolean;\n  error: string | null;\n  getBehavior: (id: string) => BehaviorDefinition | undefined;\n  refetch: () => Promise<void>;\n}\n\n/**\n * Hook to fetch and access the behavior registry\n */\nexport function useBehaviors(): UseBehaviorsReturn {\n  const [behaviors, setBehaviors] = useState<BehaviorDefinition[]>([]);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<string | null>(null);\n\n  const fetchBehaviors = useCallback(async () => {\n    try {\n      setIsLoading(true);\n      setError(null);\n      const response = await behaviorsApi.list();\n      setBehaviors(response.data);\n    } catch (err) {\n      setError(\n        err instanceof Error ? err.message : 'Failed to fetch behaviors',\n      );\n      console.error('[useBehaviors] Error fetching behaviors:', err);\n    } finally {\n      setIsLoading(false);\n    }\n  }, []);\n\n  useEffect(() => {\n    fetchBehaviors();\n  }, [fetchBehaviors]);\n\n  const getBehavior = useCallback(\n    (id: string) => behaviors.find((b) => b.id === id),\n    [behaviors],\n  );\n\n  return {\n    behaviors,\n    isLoading,\n    error,\n    getBehavior,\n    refetch: fetchBehaviors,\n  };\n}\n"],"mappings":";AAEA,SAAS,UAAU,WAAW,mBAAmB;AACjD,SAAS,oBAA6C;AAa/C,SAAS,eAAmC;AACjD,QAAM,CAAC,WAAW,YAAY,IAAI,SAA+B,CAAC,CAAC;AACnE,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,IAAI;AAC/C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAwB,IAAI;AAEtD,QAAM,iBAAiB,YAAY,YAAY;AAC7C,QAAI;AACF,mBAAa,IAAI;AACjB,eAAS,IAAI;AACb,YAAM,WAAW,MAAM,aAAa,KAAK;AACzC,mBAAa,SAAS,IAAI;AAAA,IAC5B,SAAS,KAAK;AACZ;AAAA,QACE,eAAe,QAAQ,IAAI,UAAU;AAAA,MACvC;AACA,cAAQ,MAAM,4CAA4C,GAAG;AAAA,IAC/D,UAAE;AACA,mBAAa,KAAK;AAAA,IACpB;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,YAAU,MAAM;AACd,mBAAe;AAAA,EACjB,GAAG,CAAC,cAAc,CAAC;AAEnB,QAAM,cAAc;AAAA,IAClB,CAAC,OAAe,UAAU,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE;AAAA,IACjD,CAAC,SAAS;AAAA,EACZ;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,EACX;AACF;","names":[]}

package/dist/use-business-locations.d.ts

@@ -0,0 +1,35 @@
+import type { BusinessLocation, CreateBusinessLocationData, UpdateBusinessLocationData } from '@withpotter/lib/api/types';
+/**
+ * The business's physical locations, shared by the settings page and the
+ * invite dialog.
+ *
+ * `isMultiSite` is the important one. Almost every merchant runs a single
+ * place, and a "Works at" picker on their invite form is a field with one
+ * possible answer — pure tax on the common case. Surfaces gate on this flag
+ * rather than counting the array themselves, so they can't disagree about
+ * when the concept is worth showing.
+ */
+export declare function useBusinessLocations({ enabled }?: {
+    enabled?: boolean | undefined;
+}): {
+    locations: BusinessLocation[];
+    loading: boolean;
+    error: string | null;
+    /** The backend has no locations service. Not an error; see above. */
+    unavailable: boolean;
+    /** True once a second location exists. See the note above. */
+    isMultiSite: boolean;
+    defaultLocation: BusinessLocation;
+    create: import("@tanstack/react-query").UseMutationResult<BusinessLocation, Error, CreateBusinessLocationData, unknown>;
+    update: import("@tanstack/react-query").UseMutationResult<BusinessLocation, Error, UpdateBusinessLocationData & {
+        id: string;
+    }, unknown>;
+    archive: import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;
+};
+/**
+ * Render a member's scope as one line.
+ *
+ * An empty list means every location, which is the state owners and every
+ * single-site member are in — so this must never render as "none".
+ */
+export declare function describeScope(locationIds: string[] | undefined, locations: BusinessLocation[]): string;