@flamingo-stack/openframe-frontend-core 0.0.424 → 0.0.425

package/src/embed-shims/__tests__/next-navigation.test.ts

@@ -0,0 +1,165 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+
+/**
+ * Regression tests for the `next/navigation` shim fallback (unregistered host).
+ *
+ * The guarantee under test: an unregistered `useRouter().push/replace` must
+ * perform a same-origin SPA navigation via the History API and NEVER hard-load
+ * the document — a `?search=` write from `useApiParams` used to hard-reload via
+ * `window.location.replace`. The registered path must delegate to the host
+ * router untouched.
+ *
+ * `impl` is module-level singleton state, so each test re-imports the module
+ * fresh via `vi.resetModules()` to isolate registration state. We also stub
+ * `window.location` with a spy object so any hard navigation (assign/replace/
+ * reload) is observable — jsdom leaves those methods unimplemented anyway.
+ */
+
+const ORIGIN = 'http://localhost:3000'
+
+async function freshModule() {
+  vi.resetModules()
+  return import('../next-navigation')
+}
+
+let assignSpy: ReturnType<typeof vi.fn>
+let replaceSpy: ReturnType<typeof vi.fn>
+let reloadSpy: ReturnType<typeof vi.fn>
+let pushStateSpy: ReturnType<typeof vi.spyOn>
+let replaceStateSpy: ReturnType<typeof vi.spyOn>
+let originalLocation: Location
+
+beforeEach(() => {
+  originalLocation = window.location
+  assignSpy = vi.fn()
+  replaceSpy = vi.fn()
+  reloadSpy = vi.fn()
+  Object.defineProperty(window, 'location', {
+    configurable: true,
+    value: {
+      href: `${ORIGIN}/`,
+      origin: ORIGIN,
+      pathname: '/',
+      search: '',
+      assign: assignSpy,
+      replace: replaceSpy,
+      reload: reloadSpy,
+    },
+  })
+  // Real jsdom history — spy without changing behavior so we can assert which
+  // History API the fallback used (push vs replace encodes the nav semantics).
+  pushStateSpy = vi.spyOn(window.history, 'pushState')
+  replaceStateSpy = vi.spyOn(window.history, 'replaceState')
+})
+
+afterEach(() => {
+  Object.defineProperty(window, 'location', { configurable: true, value: originalLocation })
+  vi.restoreAllMocks()
+})
+
+describe('fallback useRouter (unregistered host)', () => {
+  it('replace() writes the URL via history.replaceState — never a hard navigation', async () => {
+    const { useRouter } = await freshModule()
+    const popstate = vi.fn()
+    window.addEventListener('popstate', popstate)
+
+    useRouter().replace('?search=laptop')
+
+    expect(replaceStateSpy).toHaveBeenCalledWith(null, '', `${ORIGIN}/?search=laptop`)
+    expect(pushStateSpy).not.toHaveBeenCalled()
+    // No full-document navigation of any kind — this is the reported bug.
+    expect(assignSpy).not.toHaveBeenCalled()
+    expect(replaceSpy).not.toHaveBeenCalled()
+    expect(reloadSpy).not.toHaveBeenCalled()
+    // Subscribers (usePathname/useSearchParams) get a re-render signal.
+    expect(popstate).toHaveBeenCalledTimes(1)
+
+    window.removeEventListener('popstate', popstate)
+  })
+
+  it('push() uses history.pushState (new entry) — never a hard navigation', async () => {
+    const { useRouter } = await freshModule()
+    useRouter().push('/scripts?tab=list')
+
+    expect(pushStateSpy).toHaveBeenCalledWith(null, '', `${ORIGIN}/scripts?tab=list`)
+    expect(replaceStateSpy).not.toHaveBeenCalled()
+    expect(assignSpy).not.toHaveBeenCalled()
+    expect(reloadSpy).not.toHaveBeenCalled()
+  })
+
+  it('falls back to a real navigation for cross-origin targets, honoring replace semantics', async () => {
+    const { useRouter } = await freshModule()
+    useRouter().replace('https://example.com/evil')
+
+    // replace() must use location.replace (no back-button entry), not assign.
+    expect(replaceSpy).toHaveBeenCalledWith('https://example.com/evil')
+    expect(assignSpy).not.toHaveBeenCalled()
+    expect(replaceStateSpy).not.toHaveBeenCalled()
+    expect(pushStateSpy).not.toHaveBeenCalled()
+  })
+
+  it('uses location.assign for a cross-origin push (new history entry)', async () => {
+    const { useRouter } = await freshModule()
+    useRouter().push('https://example.com/evil')
+
+    expect(assignSpy).toHaveBeenCalledWith('https://example.com/evil')
+    expect(replaceSpy).not.toHaveBeenCalled()
+    expect(pushStateSpy).not.toHaveBeenCalled()
+  })
+
+  it('falls back to a real navigation for a malformed href (push → assign)', async () => {
+    const { useRouter } = await freshModule()
+    useRouter().push('http://[invalid')
+
+    expect(assignSpy).toHaveBeenCalledWith('http://[invalid')
+    expect(replaceSpy).not.toHaveBeenCalled()
+    expect(pushStateSpy).not.toHaveBeenCalled()
+  })
+
+  it('falls back to a real navigation for a malformed href (replace → replace)', async () => {
+    const { useRouter } = await freshModule()
+    useRouter().replace('http://[invalid')
+
+    expect(replaceSpy).toHaveBeenCalledWith('http://[invalid')
+    expect(assignSpy).not.toHaveBeenCalled()
+    expect(replaceStateSpy).not.toHaveBeenCalled()
+  })
+
+  it('back/forward remain history-based (unchanged)', async () => {
+    const { useRouter } = await freshModule()
+    const backSpy = vi.spyOn(window.history, 'back').mockImplementation(() => {})
+    const forwardSpy = vi.spyOn(window.history, 'forward').mockImplementation(() => {})
+    useRouter().back()
+    useRouter().forward()
+    expect(backSpy).toHaveBeenCalledTimes(1)
+    expect(forwardSpy).toHaveBeenCalledTimes(1)
+  })
+})
+
+describe('registered useRouter (Next host)', () => {
+  it('delegates to the host router and never touches window.location or history', async () => {
+    const { useRouter, registerNavigation } = await freshModule()
+    const hostRouter = {
+      push: vi.fn(),
+      replace: vi.fn(),
+      back: vi.fn(),
+      forward: vi.fn(),
+      refresh: vi.fn(),
+      prefetch: vi.fn(),
+    }
+    registerNavigation({ useRouter: () => hostRouter })
+
+    const r = useRouter()
+    r.replace('?search=laptop', { scroll: false })
+    r.push('/scripts')
+
+    expect(hostRouter.replace).toHaveBeenCalledWith('?search=laptop', { scroll: false })
+    expect(hostRouter.push).toHaveBeenCalledWith('/scripts')
+    // The fallback path is completely bypassed — no navigation side effects.
+    expect(assignSpy).not.toHaveBeenCalled()
+    expect(replaceSpy).not.toHaveBeenCalled()
+    expect(reloadSpy).not.toHaveBeenCalled()
+    expect(pushStateSpy).not.toHaveBeenCalled()
+    expect(replaceStateSpy).not.toHaveBeenCalled()
+  })
+})

package/src/embed-shims/next-navigation.tsx

@@ -22,9 +22,11 @@
  * After registration, every exported hook in this file delegates to
  * the real implementation. Without registration, the stubs run:
  *
- *   - `useRouter()` → push/replace use `window.location.assign/replace`;
- *     back/forward use `history.back/forward`; refresh reloads; prefetch
- *     is a no-op.
+ *   - `useRouter()` → push/replace do a same-origin SPA navigation via the
+ *     History API (`pushState`/`replaceState` + a synthetic `popstate`), so a
+ *     query-param write never reloads the document; cross-origin/malformed
+ *     hrefs fall back to `window.location`. back/forward use
+ *     `history.back/forward`; refresh reloads; prefetch is a no-op.
  *   - `usePathname()` → returns `window.location.pathname` (popstate-
  *     subscribed so back/forward re-renders).
  *   - `useSearchParams()` → returns `URLSearchParams` view of
@@ -34,10 +36,12 @@
  *   - `notFound()` / `redirect()` / `permanentRedirect()` —
  *     best-effort equivalents using `window.location`.
  *
- * The fallback path subscribes to `popstate` only. Programmatic
- * `pushState`/`replaceState` does NOT fire popstate, so the fallback
- * does not auto-re-render on programmatic navigation. Embedders that
- * need that should register a real router or supply their own.
+ * The fallback path subscribes to `popstate`. Native `pushState`/
+ * `replaceState` do NOT fire popstate, but the fallback `useRouter`'s
+ * push/replace dispatch a synthetic `popstate` so this file's own
+ * `usePathname`/`useSearchParams` subscribers re-render. A URL mutated
+ * through some OTHER API still won't auto-re-render here — embedders
+ * that need that should register a real router or supply their own.
  */
 'use client'
 import { useEffect, useState } from 'react'
@@ -95,11 +99,44 @@ const noopRouter: RouterStub = {
   prefetch: () => {},
 }
 
+/**
+ * SPA navigation for the unregistered fallback. Uses the History API instead of
+ * `window.location.assign/replace` so a same-origin URL change (e.g. a table's
+ * `?search=` write via `useApiParams`) never triggers a full document reload —
+ * even if a real router was never registered, or the registration landed on a
+ * DIFFERENT module instance than this one (duplicate lib copy / ESM-CJS dual
+ * package). A synthetic `popstate` is dispatched so this file's own
+ * `usePathname`/`useSearchParams` subscribers re-render in response.
+ * Cross-origin or malformed hrefs still fall back to a real `window.location`
+ * navigation, which is the only correct behavior there.
+ */
+function softNavigate(href: string, mode: 'push' | 'replace'): void {
+  if (typeof window === 'undefined') return
+  try {
+    const url = new URL(href, window.location.href)
+    if (url.origin !== window.location.origin) {
+      // Preserve the caller's history semantics: replace() must not leave a
+      // back-button entry, so it uses `location.replace`, not `location.assign`.
+      if (mode === 'push') window.location.assign(url.href)
+      else window.location.replace(url.href)
+      return
+    }
+    if (mode === 'push') window.history.pushState(null, '', url.href)
+    else window.history.replaceState(null, '', url.href)
+    window.dispatchEvent(new PopStateEvent('popstate'))
+  } catch {
+    // Malformed href — a real navigation is safer than swallowing it, but still
+    // honor push vs replace history semantics.
+    if (mode === 'push') window.location.assign(href)
+    else window.location.replace(href)
+  }
+}
+
 function fallbackUseRouter(): RouterStub {
   if (typeof window === 'undefined') return noopRouter
   return {
-    push: (href: string) => window.location.assign(href),
-    replace: (href: string) => window.location.replace(href),
+    push: (href: string) => softNavigate(href, 'push'),
+    replace: (href: string) => softNavigate(href, 'replace'),
     back: () => window.history.back(),
     forward: () => window.history.forward(),
     refresh: () => window.location.reload(),

package/src/stories/StackedRowsPanel.stories.tsx

@@ -1,5 +1,6 @@
 import type { Meta, StoryObj } from '@storybook/nextjs-vite'
 import { useMemo } from 'react'
+import { InfoCircleIcon } from '../components/icons-v2-generated/signs-and-symbols'
 import { type ColumnDef, DataTable, type Row, useDataTable } from '../components/ui/data-table'
 import { EntityImage } from '../components/ui/entity-image'
 import { StackedRowsPanel } from '../components/ui/stacked-rows-panel'
@@ -105,6 +106,26 @@ export const SingleRow: Story = {
   },
 }
 
+/** Info-banner row: `leadingIcon` centers a 24px glyph against both text lines. */
+export const InfoBanner: Story = {
+  args: {
+    rows: [
+      {
+        id: 'banner',
+        className: 'p-[var(--spacing-system-s)]',
+        columns: [
+          {
+            key: 'banner',
+            leadingIcon: <InfoCircleIcon className="size-6 text-ods-text-secondary" />,
+            value: 'Using OpenFrame default actions',
+            label: 'These quick actions are curated and approved by OpenFrame.',
+          },
+        ],
+      },
+    ],
+  },
+}
+
 interface DemoDevice {
   id: string
   name: string

package/dist/chunk-G7UE6RKV.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-G7UE6RKV.cjs","../src/embed-shims/next-navigation.tsx"],"names":[],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-G7UE6RKV.cjs","sourcesContent":[null,"/**\n * `next/navigation` shim — environment-aware app-router hooks.\n *\n * Defaults to lightweight stubs backed by `window.location` and\n * `URLSearchParams` so lib components that read the URL work outside\n * a Next.js router shell. Next.js hosts can opt into the REAL\n * `next/navigation` exports (full client-router integration —\n * `router.replace(href, { scroll: false })`, etc.) by calling\n * {@link registerNavigation} ONCE at app init:\n *\n *   // hub: lib/embed-shim-registration.ts\n *   import {\n *     useRouter, usePathname, useSearchParams, useParams,\n *     redirect, permanentRedirect, notFound,\n *   } from 'next/navigation'\n *   import { registerNavigation } from '@flamingo-stack/openframe-frontend-core/embed-shims'\n *   registerNavigation({\n *     useRouter, usePathname, useSearchParams, useParams,\n *     redirect, permanentRedirect, notFound,\n *   })\n *\n * After registration, every exported hook in this file delegates to\n * the real implementation. Without registration, the stubs run:\n *\n *   - `useRouter()` → push/replace use `window.location.assign/replace`;\n *     back/forward use `history.back/forward`; refresh reloads; prefetch\n *     is a no-op.\n *   - `usePathname()` → returns `window.location.pathname` (popstate-\n *     subscribed so back/forward re-renders).\n *   - `useSearchParams()` → returns `URLSearchParams` view of\n *     `window.location.search` (popstate-subscribed).\n *   - `useParams()` → returns `{}` — embedders that need dynamic\n *     params should parse them from `usePathname()` themselves.\n *   - `notFound()` / `redirect()` / `permanentRedirect()` —\n *     best-effort equivalents using `window.location`.\n *\n * The fallback path subscribes to `popstate` only. Programmatic\n * `pushState`/`replaceState` does NOT fire popstate, so the fallback\n * does not auto-re-render on programmatic navigation. Embedders that\n * need that should register a real router or supply their own.\n */\n'use client'\nimport { useEffect, useState } from 'react'\n\n// --- Router shape — matches Next's AppRouterInstance surface enough to\n// --- satisfy hub callsites that pass options like `{ scroll: false }`.\ninterface NavigateOptions {\n  scroll?: boolean\n}\n\ninterface PrefetchOptions {\n  kind?: unknown\n}\n\ninterface RouterStub {\n  push: (href: string, options?: NavigateOptions) => void\n  replace: (href: string, options?: NavigateOptions) => void\n  back: () => void\n  forward: () => void\n  refresh: () => void\n  prefetch: (href: string, options?: PrefetchOptions) => void\n}\n\n// --- Registration surface — partial so a host can register only the\n// --- hooks it needs (e.g. routes that don't use redirect()).\nexport interface NavigationImpl {\n  useRouter: () => RouterStub\n  usePathname: () => string\n  useSearchParams: () => URLSearchParams\n  useParams: <T extends Record<string, string | string[]>>() => T\n  redirect: (url: string, type?: unknown) => never\n  permanentRedirect: (url: string, type?: unknown) => never\n  notFound: () => never\n}\n\nlet impl: Partial<NavigationImpl> = {}\n\n/**\n * Register real `next/navigation` exports. Merges with any prior\n * registration so partial-overrides are safe. Call ONCE at app init\n * in a Next.js host.\n */\nexport function registerNavigation(nav: Partial<NavigationImpl>): void {\n  impl = { ...impl, ...nav }\n}\n\n// --- Fallback impls ----------------------------------------------------\n\nconst noopRouter: RouterStub = {\n  push: () => {},\n  replace: () => {},\n  back: () => {},\n  forward: () => {},\n  refresh: () => {},\n  prefetch: () => {},\n}\n\nfunction fallbackUseRouter(): RouterStub {\n  if (typeof window === 'undefined') return noopRouter\n  return {\n    push: (href: string) => window.location.assign(href),\n    replace: (href: string) => window.location.replace(href),\n    back: () => window.history.back(),\n    forward: () => window.history.forward(),\n    refresh: () => window.location.reload(),\n    prefetch: () => {},\n  }\n}\n\nfunction readLocation<T>(read: () => T, fallback: T): T {\n  return typeof window === 'undefined' ? fallback : read()\n}\n\n/** Subscribes to `popstate` only. pushState/replaceState do NOT fire\n *  popstate by design — callers that mutate the URL programmatically\n *  (and want their component to re-render in response) need a real\n *  router. */\nfunction useLocationSubscription(): number {\n  const [tick, setTick] = useState(0)\n  useEffect(() => {\n    if (typeof window === 'undefined') return\n    const onChange = () => setTick((t) => t + 1)\n    window.addEventListener('popstate', onChange)\n    return () => window.removeEventListener('popstate', onChange)\n  }, [])\n  return tick\n}\n\nfunction fallbackUsePathname(): string {\n  useLocationSubscription()\n  return readLocation(() => window.location.pathname, '/')\n}\n\nfunction fallbackUseSearchParams(): URLSearchParams {\n  useLocationSubscription()\n  return readLocation(\n    () => new URLSearchParams(window.location.search),\n    new URLSearchParams(),\n  )\n}\n\nfunction fallbackUseParams<T extends Record<string, string | string[]>>(): T {\n  return {} as T\n}\n\nfunction fallbackRedirect(url: string): never {\n  if (typeof window !== 'undefined') window.location.assign(url)\n  throw new Error(`[next-navigation shim] redirect(${url})`)\n}\n\nfunction fallbackPermanentRedirect(url: string): never {\n  if (typeof window !== 'undefined') window.location.replace(url)\n  throw new Error(`[next-navigation shim] permanentRedirect(${url})`)\n}\n\nfunction fallbackNotFound(): never {\n  throw new Error('[next-navigation shim] notFound()')\n}\n\n// --- Public surface — each export checks the registry and falls\n// --- through to the fallback. Hooks must remain hooks (no early-\n// --- return-before-hook) — the registry lookup is itself synchronous\n// --- and the registered impl is a hook in its own right.\n\nexport function useRouter(): RouterStub {\n  return (impl.useRouter ?? fallbackUseRouter)()\n}\n\nexport function usePathname(): string {\n  return (impl.usePathname ?? fallbackUsePathname)()\n}\n\nexport function useSearchParams(): URLSearchParams {\n  return (impl.useSearchParams ?? fallbackUseSearchParams)()\n}\n\nexport function useParams<T extends Record<string, string | string[]>>(): T {\n  return ((impl.useParams as (() => T) | undefined) ?? fallbackUseParams)()\n}\n\nexport function redirect(url: string, type?: unknown): never {\n  return (impl.redirect ?? fallbackRedirect)(url, type)\n}\n\nexport function permanentRedirect(url: string, type?: unknown): never {\n  return (impl.permanentRedirect ?? fallbackPermanentRedirect)(url, type)\n}\n\nexport function notFound(): never {\n  return (impl.notFound ?? fallbackNotFound)()\n}\n\n/** Match Next's RedirectType enum surface for code that imports it. */\nexport const RedirectType = {\n  push: 'push' as const,\n  replace: 'replace' as const,\n}\n\n/** Match Next's ServerInsertedHTMLContext surface — non-functional in\n *  the embed environment but importable so consumers don't crash. */\nexport const ServerInsertedHTMLContext = null as any\n"]}

package/dist/chunk-PLJLE4A4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/embed-shims/next-navigation.tsx"],"sourcesContent":["/**\n * `next/navigation` shim — environment-aware app-router hooks.\n *\n * Defaults to lightweight stubs backed by `window.location` and\n * `URLSearchParams` so lib components that read the URL work outside\n * a Next.js router shell. Next.js hosts can opt into the REAL\n * `next/navigation` exports (full client-router integration —\n * `router.replace(href, { scroll: false })`, etc.) by calling\n * {@link registerNavigation} ONCE at app init:\n *\n *   // hub: lib/embed-shim-registration.ts\n *   import {\n *     useRouter, usePathname, useSearchParams, useParams,\n *     redirect, permanentRedirect, notFound,\n *   } from 'next/navigation'\n *   import { registerNavigation } from '@flamingo-stack/openframe-frontend-core/embed-shims'\n *   registerNavigation({\n *     useRouter, usePathname, useSearchParams, useParams,\n *     redirect, permanentRedirect, notFound,\n *   })\n *\n * After registration, every exported hook in this file delegates to\n * the real implementation. Without registration, the stubs run:\n *\n *   - `useRouter()` → push/replace use `window.location.assign/replace`;\n *     back/forward use `history.back/forward`; refresh reloads; prefetch\n *     is a no-op.\n *   - `usePathname()` → returns `window.location.pathname` (popstate-\n *     subscribed so back/forward re-renders).\n *   - `useSearchParams()` → returns `URLSearchParams` view of\n *     `window.location.search` (popstate-subscribed).\n *   - `useParams()` → returns `{}` — embedders that need dynamic\n *     params should parse them from `usePathname()` themselves.\n *   - `notFound()` / `redirect()` / `permanentRedirect()` —\n *     best-effort equivalents using `window.location`.\n *\n * The fallback path subscribes to `popstate` only. Programmatic\n * `pushState`/`replaceState` does NOT fire popstate, so the fallback\n * does not auto-re-render on programmatic navigation. Embedders that\n * need that should register a real router or supply their own.\n */\n'use client'\nimport { useEffect, useState } from 'react'\n\n// --- Router shape — matches Next's AppRouterInstance surface enough to\n// --- satisfy hub callsites that pass options like `{ scroll: false }`.\ninterface NavigateOptions {\n  scroll?: boolean\n}\n\ninterface PrefetchOptions {\n  kind?: unknown\n}\n\ninterface RouterStub {\n  push: (href: string, options?: NavigateOptions) => void\n  replace: (href: string, options?: NavigateOptions) => void\n  back: () => void\n  forward: () => void\n  refresh: () => void\n  prefetch: (href: string, options?: PrefetchOptions) => void\n}\n\n// --- Registration surface — partial so a host can register only the\n// --- hooks it needs (e.g. routes that don't use redirect()).\nexport interface NavigationImpl {\n  useRouter: () => RouterStub\n  usePathname: () => string\n  useSearchParams: () => URLSearchParams\n  useParams: <T extends Record<string, string | string[]>>() => T\n  redirect: (url: string, type?: unknown) => never\n  permanentRedirect: (url: string, type?: unknown) => never\n  notFound: () => never\n}\n\nlet impl: Partial<NavigationImpl> = {}\n\n/**\n * Register real `next/navigation` exports. Merges with any prior\n * registration so partial-overrides are safe. Call ONCE at app init\n * in a Next.js host.\n */\nexport function registerNavigation(nav: Partial<NavigationImpl>): void {\n  impl = { ...impl, ...nav }\n}\n\n// --- Fallback impls ----------------------------------------------------\n\nconst noopRouter: RouterStub = {\n  push: () => {},\n  replace: () => {},\n  back: () => {},\n  forward: () => {},\n  refresh: () => {},\n  prefetch: () => {},\n}\n\nfunction fallbackUseRouter(): RouterStub {\n  if (typeof window === 'undefined') return noopRouter\n  return {\n    push: (href: string) => window.location.assign(href),\n    replace: (href: string) => window.location.replace(href),\n    back: () => window.history.back(),\n    forward: () => window.history.forward(),\n    refresh: () => window.location.reload(),\n    prefetch: () => {},\n  }\n}\n\nfunction readLocation<T>(read: () => T, fallback: T): T {\n  return typeof window === 'undefined' ? fallback : read()\n}\n\n/** Subscribes to `popstate` only. pushState/replaceState do NOT fire\n *  popstate by design — callers that mutate the URL programmatically\n *  (and want their component to re-render in response) need a real\n *  router. */\nfunction useLocationSubscription(): number {\n  const [tick, setTick] = useState(0)\n  useEffect(() => {\n    if (typeof window === 'undefined') return\n    const onChange = () => setTick((t) => t + 1)\n    window.addEventListener('popstate', onChange)\n    return () => window.removeEventListener('popstate', onChange)\n  }, [])\n  return tick\n}\n\nfunction fallbackUsePathname(): string {\n  useLocationSubscription()\n  return readLocation(() => window.location.pathname, '/')\n}\n\nfunction fallbackUseSearchParams(): URLSearchParams {\n  useLocationSubscription()\n  return readLocation(\n    () => new URLSearchParams(window.location.search),\n    new URLSearchParams(),\n  )\n}\n\nfunction fallbackUseParams<T extends Record<string, string | string[]>>(): T {\n  return {} as T\n}\n\nfunction fallbackRedirect(url: string): never {\n  if (typeof window !== 'undefined') window.location.assign(url)\n  throw new Error(`[next-navigation shim] redirect(${url})`)\n}\n\nfunction fallbackPermanentRedirect(url: string): never {\n  if (typeof window !== 'undefined') window.location.replace(url)\n  throw new Error(`[next-navigation shim] permanentRedirect(${url})`)\n}\n\nfunction fallbackNotFound(): never {\n  throw new Error('[next-navigation shim] notFound()')\n}\n\n// --- Public surface — each export checks the registry and falls\n// --- through to the fallback. Hooks must remain hooks (no early-\n// --- return-before-hook) — the registry lookup is itself synchronous\n// --- and the registered impl is a hook in its own right.\n\nexport function useRouter(): RouterStub {\n  return (impl.useRouter ?? fallbackUseRouter)()\n}\n\nexport function usePathname(): string {\n  return (impl.usePathname ?? fallbackUsePathname)()\n}\n\nexport function useSearchParams(): URLSearchParams {\n  return (impl.useSearchParams ?? fallbackUseSearchParams)()\n}\n\nexport function useParams<T extends Record<string, string | string[]>>(): T {\n  return ((impl.useParams as (() => T) | undefined) ?? fallbackUseParams)()\n}\n\nexport function redirect(url: string, type?: unknown): never {\n  return (impl.redirect ?? fallbackRedirect)(url, type)\n}\n\nexport function permanentRedirect(url: string, type?: unknown): never {\n  return (impl.permanentRedirect ?? fallbackPermanentRedirect)(url, type)\n}\n\nexport function notFound(): never {\n  return (impl.notFound ?? fallbackNotFound)()\n}\n\n/** Match Next's RedirectType enum surface for code that imports it. */\nexport const RedirectType = {\n  push: 'push' as const,\n  replace: 'replace' as const,\n}\n\n/** Match Next's ServerInsertedHTMLContext surface — non-functional in\n *  the embed environment but importable so consumers don't crash. */\nexport const ServerInsertedHTMLContext = null as any\n"],"mappings":";;;;;;AA0CA,SAAS,WAAW,gBAAgB;AAwC7B,SAAS,mBAAmB,KAAoC;AACrE,SAAO,EAAE,GAAG,MAAM,GAAG,IAAI;AAC3B;AAaA,SAAS,oBAAgC;AACvC,MAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,SAAO;AAAA,IACL,MAAM,CAAC,SAAiB,OAAO,SAAS,OAAO,IAAI;AAAA,IACnD,SAAS,CAAC,SAAiB,OAAO,SAAS,QAAQ,IAAI;AAAA,IACvD,MAAM,MAAM,OAAO,QAAQ,KAAK;AAAA,IAChC,SAAS,MAAM,OAAO,QAAQ,QAAQ;AAAA,IACtC,SAAS,MAAM,OAAO,SAAS,OAAO;AAAA,IACtC,UAAU,MAAM;AAAA,IAAC;AAAA,EACnB;AACF;AAEA,SAAS,aAAgB,MAAe,UAAgB;AACtD,SAAO,OAAO,WAAW,cAAc,WAAW,KAAK;AACzD;AAMA,SAAS,0BAAkC;AACzC,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,CAAC;AAClC,YAAU,MAAM;AACd,QAAI,OAAO,WAAW,YAAa;AACnC,UAAM,WAAW,MAAM,QAAQ,CAAC,MAAM,IAAI,CAAC;AAC3C,WAAO,iBAAiB,YAAY,QAAQ;AAC5C,WAAO,MAAM,OAAO,oBAAoB,YAAY,QAAQ;AAAA,EAC9D,GAAG,CAAC,CAAC;AACL,SAAO;AACT;AAEA,SAAS,sBAA8B;AACrC,0BAAwB;AACxB,SAAO,aAAa,MAAM,OAAO,SAAS,UAAU,GAAG;AACzD;AAEA,SAAS,0BAA2C;AAClD,0BAAwB;AACxB,SAAO;AAAA,IACL,MAAM,IAAI,gBAAgB,OAAO,SAAS,MAAM;AAAA,IAChD,IAAI,gBAAgB;AAAA,EACtB;AACF;AAEA,SAAS,oBAAoE;AAC3E,SAAO,CAAC;AACV;AAEA,SAAS,iBAAiB,KAAoB;AAC5C,MAAI,OAAO,WAAW,YAAa,QAAO,SAAS,OAAO,GAAG;AAC7D,QAAM,IAAI,MAAM,mCAAmC,GAAG,GAAG;AAC3D;AAEA,SAAS,0BAA0B,KAAoB;AACrD,MAAI,OAAO,WAAW,YAAa,QAAO,SAAS,QAAQ,GAAG;AAC9D,QAAM,IAAI,MAAM,4CAA4C,GAAG,GAAG;AACpE;AAEA,SAAS,mBAA0B;AACjC,QAAM,IAAI,MAAM,mCAAmC;AACrD;AAOO,SAAS,YAAwB;AACtC,UAAQ,KAAK,aAAa,mBAAmB;AAC/C;AAEO,SAAS,cAAsB;AACpC,UAAQ,KAAK,eAAe,qBAAqB;AACnD;AAEO,SAAS,kBAAmC;AACjD,UAAQ,KAAK,mBAAmB,yBAAyB;AAC3D;AAEO,SAAS,YAA4D;AAC1E,UAAS,KAAK,aAAuC,mBAAmB;AAC1E;AAEO,SAAS,SAAS,KAAa,MAAuB;AAC3D,UAAQ,KAAK,YAAY,kBAAkB,KAAK,IAAI;AACtD;AAEO,SAAS,kBAAkB,KAAa,MAAuB;AACpE,UAAQ,KAAK,qBAAqB,2BAA2B,KAAK,IAAI;AACxE;AAEO,SAAS,WAAkB;AAChC,UAAQ,KAAK,YAAY,kBAAkB;AAC7C;AA9LA,IA2EI,MAaE,YAyGO,cAOA;AAxMb;AAAA;AA2EA,IAAI,OAAgC,CAAC;AAarC,IAAM,aAAyB;AAAA,MAC7B,MAAM,MAAM;AAAA,MAAC;AAAA,MACb,SAAS,MAAM;AAAA,MAAC;AAAA,MAChB,MAAM,MAAM;AAAA,MAAC;AAAA,MACb,SAAS,MAAM;AAAA,MAAC;AAAA,MAChB,SAAS,MAAM;AAAA,MAAC;AAAA,MAChB,UAAU,MAAM;AAAA,MAAC;AAAA,IACnB;AAkGO,IAAM,eAAe;AAAA,MAC1B,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAIO,IAAM,4BAA4B;AAAA;AAAA;","names":[]}