@bquery/bquery 1.1.2 → 1.2.0

package/dist/router.es.mjs

@@ -0,0 +1,166 @@
+import { computed as E, signal as S } from "./reactive.es.mjs";
+let h = null;
+const d = S({
+  path: "",
+  params: {},
+  query: {},
+  matched: null,
+  hash: ""
+}), _ = E(() => d.value), z = (r) => {
+  if (r === "*")
+    return /^.*$/;
+  const o = "\0P\0", e = "\0W\0", a = [];
+  let t = r.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, (u, p) => (a.push(p), o));
+  t = t.replace(/\*/g, e), t = t.replace(/[\\^$.*+?()[\]{}|]/g, "\\$&");
+  let n = 0;
+  return t = t.replace(/\u0000P\u0000/g, () => `(?<${a[n++]}>[^/]+)`), t = t.replace(/\u0000W\u0000/g, ".*"), new RegExp(`^${t}$`);
+}, N = (r) => {
+  const o = r.match(/:([a-zA-Z_][a-zA-Z0-9_]*)/g);
+  return o ? o.map((e) => e.slice(1)) : [];
+}, W = (r, o) => {
+  for (const e of o) {
+    const a = z(e.path), t = r.match(a);
+    if (t) {
+      const n = N(e.path), u = {};
+      return t.groups ? Object.assign(u, t.groups) : n.forEach((p, w) => {
+        u[p] = t[w + 1] || "";
+      }), { matched: e, params: u };
+    }
+  }
+  return null;
+}, C = (r) => {
+  const o = {};
+  return new URLSearchParams(r).forEach((a, t) => {
+    const n = o[t];
+    n === void 0 ? o[t] = a : Array.isArray(n) ? n.push(a) : o[t] = [n, a];
+  }), o;
+}, y = (r, o, e, a) => {
+  const t = W(r, a);
+  return {
+    path: r,
+    params: t?.params ?? {},
+    query: C(o),
+    matched: t?.matched ?? null,
+    hash: e.replace(/^#/, "")
+  };
+}, P = async (r, o = {}) => {
+  if (!h)
+    throw new Error("bQuery router: No router initialized. Call createRouter() first.");
+  await h[o.replace ? "replace" : "push"](r);
+}, Q = () => {
+  h ? h.back() : history.back();
+}, Z = () => {
+  h ? h.forward() : history.forward();
+}, q = (r) => {
+  h && h.destroy();
+  const { routes: o, base: e = "", hash: a = !1 } = r, t = [], n = [], u = x(o, e), p = () => {
+    if (a) {
+      const c = window.location.hash.slice(1) || "/", [f, i = ""] = c.split("?"), [m, l = ""] = i.split("#");
+      return {
+        pathname: f,
+        search: m ? `?${m}` : "",
+        hash: l ? `#${l}` : ""
+      };
+    }
+    let s = window.location.pathname;
+    return e && s.startsWith(e) && (s = s.slice(e.length) || "/"), {
+      pathname: s,
+      search: window.location.search,
+      hash: window.location.hash
+    };
+  }, w = () => {
+    const { pathname: s, search: c, hash: f } = p(), i = y(s, c, f, u);
+    d.value = i;
+  }, $ = async (s, c) => {
+    const { pathname: f, search: i, hash: m } = p(), l = y(f, i, m, u), g = new URL(s, window.location.origin), R = a ? s : g.pathname, k = y(R, g.search, g.hash, u);
+    for (const v of t)
+      if (await v(k, l) === !1)
+        return;
+    const L = a ? `#${s}` : `${e}${s}`;
+    history[c]({}, "", L), w();
+    for (const v of n)
+      v(d.value, l);
+  }, b = async () => {
+    const { pathname: s, search: c, hash: f } = p(), i = d.value, m = y(s, c, f, u);
+    for (const l of t)
+      if (await l(m, i) === !1) {
+        const R = a ? `#${i.path}` : `${e}${i.path}`;
+        history.pushState({}, "", R);
+        return;
+      }
+    w();
+    for (const l of n)
+      l(d.value, i);
+  };
+  window.addEventListener("popstate", b), w();
+  const A = {
+    push: (s) => $(s, "pushState"),
+    replace: (s) => $(s, "replaceState"),
+    back: () => history.back(),
+    forward: () => history.forward(),
+    go: (s) => history.go(s),
+    beforeEach: (s) => (t.push(s), () => {
+      const c = t.indexOf(s);
+      c > -1 && t.splice(c, 1);
+    }),
+    afterEach: (s) => (n.push(s), () => {
+      const c = n.indexOf(s);
+      c > -1 && n.splice(c, 1);
+    }),
+    currentRoute: _,
+    routes: u,
+    destroy: () => {
+      window.removeEventListener("popstate", b), t.length = 0, n.length = 0, h = null;
+    }
+  };
+  return h = A, A;
+}, x = (r, o = "") => {
+  const e = [];
+  for (const a of r) {
+    const t = a.path === "*" ? "*" : `${o}${a.path}`.replace(/\/+/g, "/");
+    e.push({
+      ...a,
+      path: t
+    }), a.children && e.push(...x(a.children, t));
+  }
+  return e;
+}, I = (r, o = {}) => {
+  if (!h)
+    throw new Error("bQuery router: No router initialized.");
+  const e = h.routes.find((t) => t.name === r);
+  if (!e)
+    throw new Error(`bQuery router: Route "${r}" not found.`);
+  let a = e.path;
+  for (const [t, n] of Object.entries(o))
+    a = a.replace(`:${t}`, encodeURIComponent(n));
+  return a;
+}, M = (r, o = !1) => {
+  const e = d.value.path;
+  return o ? e === r : e.startsWith(r);
+}, U = (r, o = !1) => E(() => {
+  const e = d.value.path;
+  return o ? e === r : e.startsWith(r);
+}), j = (r, o = {}) => (e) => {
+  e.preventDefault(), P(r, o);
+}, H = (r = document.body) => {
+  const o = (e) => {
+    const t = e.target.closest("a");
+    if (!t || t.target || t.hasAttribute("download") || t.origin !== window.location.origin) return;
+    const n = t.pathname + t.search + t.hash;
+    e.preventDefault(), P(n);
+  };
+  return r.addEventListener("click", o), () => r.removeEventListener("click", o);
+};
+export {
+  Q as back,
+  q as createRouter,
+  _ as currentRoute,
+  Z as forward,
+  H as interceptLinks,
+  M as isActive,
+  U as isActiveSignal,
+  j as link,
+  P as navigate,
+  I as resolve
+};
+//# sourceMappingURL=router.es.mjs.map

package/dist/router.es.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.es.mjs","sources":["../src/router/index.ts"],"sourcesContent":["/**\r\n * Minimal SPA router with History API integration.\r\n *\r\n * This module provides a lightweight, signal-based router for single-page\r\n * applications. Features include:\r\n * - History API navigation\r\n * - Route matching with params and wildcards\r\n * - Lazy route loading\r\n * - Navigation guards (beforeEach, afterEach)\r\n * - Reactive current route via signals\r\n * - Multi-value query params (e.g., `?tag=a&tag=b` → `{ tag: ['a', 'b'] }`)\r\n *\r\n * @module bquery/router\r\n *\r\n * @example\r\n * ```ts\r\n * import { createRouter, navigate, currentRoute } from 'bquery/router';\r\n * import { effect } from 'bquery/reactive';\r\n *\r\n * const router = createRouter({\r\n *   routes: [\r\n *     { path: '/', component: () => import('./Home') },\r\n *     { path: '/user/:id', component: () => import('./User') },\r\n *     { path: '*', component: () => import('./NotFound') },\r\n *   ],\r\n * });\r\n *\r\n * effect(() => {\r\n *   console.log('Route changed:', currentRoute.value);\r\n * });\r\n *\r\n * navigate('/user/42');\r\n * ```\r\n */\r\n\r\nimport { computed, signal, type ReadonlySignal, type Signal } from '../reactive/index';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Represents a parsed route with matched params.\r\n */\r\nexport type Route = {\r\n  /** The current path (e.g., '/user/42') */\r\n  path: string;\r\n  /** Extracted route params (e.g., { id: '42' }) */\r\n  params: Record<string, string>;\r\n  /**\r\n   * Query string params.\r\n   * Each key maps to a single string value by default.\r\n   * Only keys that appear multiple times in the query string become arrays.\r\n   * @example\r\n   * // ?foo=1 → { foo: '1' }\r\n   * // ?tag=a&tag=b → { tag: ['a', 'b'] }\r\n   * // ?x=1&y=2&x=3 → { x: ['1', '3'], y: '2' }\r\n   */\r\n  query: Record<string, string | string[]>;\r\n  /** The matched route definition */\r\n  matched: RouteDefinition | null;\r\n  /** Hash fragment without # */\r\n  hash: string;\r\n};\r\n\r\n/**\r\n * Route definition for configuration.\r\n */\r\nexport type RouteDefinition = {\r\n  /** Path pattern (e.g., '/user/:id', '/posts/*') */\r\n  path: string;\r\n  /** Component loader (sync or async) */\r\n  component: () => unknown | Promise<unknown>;\r\n  /** Optional route name for programmatic navigation */\r\n  name?: string;\r\n  /** Optional metadata */\r\n  meta?: Record<string, unknown>;\r\n  /** Nested child routes */\r\n  children?: RouteDefinition[];\r\n};\r\n\r\n/**\r\n * Router configuration options.\r\n */\r\nexport type RouterOptions = {\r\n  /** Array of route definitions */\r\n  routes: RouteDefinition[];\r\n  /** Base path for all routes (default: '') */\r\n  base?: string;\r\n  /** Use hash-based routing instead of history (default: false) */\r\n  hash?: boolean;\r\n};\r\n\r\n/**\r\n * Navigation guard function type.\r\n */\r\nexport type NavigationGuard = (to: Route, from: Route) => boolean | void | Promise<boolean | void>;\r\n\r\n/**\r\n * Router instance returned by createRouter.\r\n */\r\nexport type Router = {\r\n  /** Navigate to a path */\r\n  push: (path: string) => Promise<void>;\r\n  /** Replace current history entry */\r\n  replace: (path: string) => Promise<void>;\r\n  /** Go back in history */\r\n  back: () => void;\r\n  /** Go forward in history */\r\n  forward: () => void;\r\n  /** Go to a specific history entry */\r\n  go: (delta: number) => void;\r\n  /** Add a beforeEach guard */\r\n  beforeEach: (guard: NavigationGuard) => () => void;\r\n  /** Add an afterEach hook */\r\n  afterEach: (hook: (to: Route, from: Route) => void) => () => void;\r\n  /** Current route (reactive) */\r\n  currentRoute: ReadonlySignal<Route>;\r\n  /** All route definitions */\r\n  routes: RouteDefinition[];\r\n  /** Destroy the router and cleanup listeners */\r\n  destroy: () => void;\r\n};\r\n\r\n// ============================================================================\r\n// Internal State\r\n// ============================================================================\r\n\r\n/** @internal */\r\nlet activeRouter: Router | null = null;\r\n\r\n/** @internal */\r\nconst routeSignal: Signal<Route> = signal<Route>({\r\n  path: '',\r\n  params: {},\r\n  query: {},\r\n  matched: null,\r\n  hash: '',\r\n});\r\n\r\n/**\r\n * Reactive signal containing the current route.\r\n *\r\n * @example\r\n * ```ts\r\n * import { currentRoute } from 'bquery/router';\r\n * import { effect } from 'bquery/reactive';\r\n *\r\n * effect(() => {\r\n *   document.title = `Page: ${currentRoute.value.path}`;\r\n * });\r\n * ```\r\n */\r\nexport const currentRoute: ReadonlySignal<Route> = computed(() => routeSignal.value);\r\n\r\n// ============================================================================\r\n// Route Matching\r\n// ============================================================================\r\n\r\n/**\r\n * Converts a route path pattern to a RegExp for matching.\r\n * Uses placeholder approach to preserve :param and * patterns during escaping.\r\n * @internal\r\n */\r\nconst pathToRegex = (path: string): RegExp => {\r\n  // Handle wildcard-only route\r\n  if (path === '*') {\r\n    return /^.*$/;\r\n  }\r\n\r\n  // Unique placeholders using null chars (won't appear in normal paths)\r\n  const PARAM_MARKER = '\\u0000P\\u0000';\r\n  const WILDCARD_MARKER = '\\u0000W\\u0000';\r\n\r\n  // Store param names for restoration\r\n  const paramNames: string[] = [];\r\n\r\n  // Step 1: Extract :param patterns before escaping\r\n  let pattern = path.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, (_, name) => {\r\n    paramNames.push(name);\r\n    return PARAM_MARKER;\r\n  });\r\n\r\n  // Step 2: Extract * wildcards before escaping\r\n  pattern = pattern.replace(/\\*/g, WILDCARD_MARKER);\r\n\r\n  // Step 3: Escape ALL regex metacharacters: \\ ^ $ . * + ? ( ) [ ] { } |\r\n  pattern = pattern.replace(/[\\\\^$.*+?()[\\]{}|]/g, '\\\\$&');\r\n\r\n  // Step 4: Restore param capture groups\r\n  let paramIdx = 0;\r\n  pattern = pattern.replace(/\\u0000P\\u0000/g, () => `(?<${paramNames[paramIdx++]}>[^/]+)`);\r\n\r\n  // Step 5: Restore wildcards as .*\r\n  pattern = pattern.replace(/\\u0000W\\u0000/g, '.*');\r\n\r\n  return new RegExp(`^${pattern}$`);\r\n};\r\n\r\n/**\r\n * Extracts param names from a route path.\r\n * @internal\r\n */\r\nconst extractParamNames = (path: string): string[] => {\r\n  const matches = path.match(/:([a-zA-Z_][a-zA-Z0-9_]*)/g);\r\n  return matches ? matches.map((m) => m.slice(1)) : [];\r\n};\r\n\r\n/**\r\n * Matches a path against route definitions and extracts params.\r\n * @internal\r\n */\r\nconst matchRoute = (\r\n  path: string,\r\n  routes: RouteDefinition[]\r\n): { matched: RouteDefinition; params: Record<string, string> } | null => {\r\n  for (const route of routes) {\r\n    const regex = pathToRegex(route.path);\r\n    const match = path.match(regex);\r\n\r\n    if (match) {\r\n      const paramNames = extractParamNames(route.path);\r\n      const params: Record<string, string> = {};\r\n\r\n      // Extract named groups if available\r\n      if (match.groups) {\r\n        Object.assign(params, match.groups);\r\n      } else {\r\n        // Fallback for browsers without named groups\r\n        paramNames.forEach((name, index) => {\r\n          params[name] = match[index + 1] || '';\r\n        });\r\n      }\r\n\r\n      return { matched: route, params };\r\n    }\r\n  }\r\n\r\n  return null;\r\n};\r\n\r\n/**\r\n * Parses query string into an object.\r\n * Single values are stored as strings, duplicate keys become arrays.\r\n * @internal\r\n *\r\n * @example\r\n * parseQuery('?foo=1') // { foo: '1' }\r\n * parseQuery('?tag=a&tag=b') // { tag: ['a', 'b'] }\r\n * parseQuery('?x=1&y=2&x=3') // { x: ['1', '3'], y: '2' }\r\n */\r\nconst parseQuery = (search: string): Record<string, string | string[]> => {\r\n  const query: Record<string, string | string[]> = {};\r\n  const params = new URLSearchParams(search);\r\n\r\n  params.forEach((value, key) => {\r\n    const existing = query[key];\r\n    if (existing === undefined) {\r\n      // First occurrence: store as string\r\n      query[key] = value;\r\n    } else if (Array.isArray(existing)) {\r\n      // Already an array: append\r\n      existing.push(value);\r\n    } else {\r\n      // Second occurrence: convert to array\r\n      query[key] = [existing, value];\r\n    }\r\n  });\r\n\r\n  return query;\r\n};\r\n\r\n/**\r\n * Creates a Route object from the current URL.\r\n * @internal\r\n */\r\nconst createRoute = (\r\n  pathname: string,\r\n  search: string,\r\n  hash: string,\r\n  routes: RouteDefinition[]\r\n): Route => {\r\n  const result = matchRoute(pathname, routes);\r\n\r\n  return {\r\n    path: pathname,\r\n    params: result?.params ?? {},\r\n    query: parseQuery(search),\r\n    matched: result?.matched ?? null,\r\n    hash: hash.replace(/^#/, ''),\r\n  };\r\n};\r\n\r\n// ============================================================================\r\n// Navigation\r\n// ============================================================================\r\n\r\n/**\r\n * Navigates to a new path.\r\n *\r\n * @param path - The path to navigate to\r\n * @param options - Navigation options\r\n *\r\n * @example\r\n * ```ts\r\n * import { navigate } from 'bquery/router';\r\n *\r\n * // Push to history\r\n * await navigate('/dashboard');\r\n *\r\n * // Replace current entry\r\n * await navigate('/login', { replace: true });\r\n * ```\r\n */\r\nexport const navigate = async (\r\n  path: string,\r\n  options: { replace?: boolean } = {}\r\n): Promise<void> => {\r\n  if (!activeRouter) {\r\n    throw new Error('bQuery router: No router initialized. Call createRouter() first.');\r\n  }\r\n\r\n  await activeRouter[options.replace ? 'replace' : 'push'](path);\r\n};\r\n\r\n/**\r\n * Programmatically go back in history.\r\n *\r\n * @example\r\n * ```ts\r\n * import { back } from 'bquery/router';\r\n * back();\r\n * ```\r\n */\r\nexport const back = (): void => {\r\n  if (activeRouter) {\r\n    activeRouter.back();\r\n  } else {\r\n    history.back();\r\n  }\r\n};\r\n\r\n/**\r\n * Programmatically go forward in history.\r\n *\r\n * @example\r\n * ```ts\r\n * import { forward } from 'bquery/router';\r\n * forward();\r\n * ```\r\n */\r\nexport const forward = (): void => {\r\n  if (activeRouter) {\r\n    activeRouter.forward();\r\n  } else {\r\n    history.forward();\r\n  }\r\n};\r\n\r\n// ============================================================================\r\n// Router Creation\r\n// ============================================================================\r\n\r\n/**\r\n * Creates and initializes a router instance.\r\n *\r\n * @param options - Router configuration\r\n * @returns The router instance\r\n *\r\n * @example\r\n * ```ts\r\n * import { createRouter } from 'bquery/router';\r\n *\r\n * const router = createRouter({\r\n *   routes: [\r\n *     { path: '/', component: () => import('./pages/Home') },\r\n *     { path: '/about', component: () => import('./pages/About') },\r\n *     { path: '/user/:id', component: () => import('./pages/User') },\r\n *     { path: '*', component: () => import('./pages/NotFound') },\r\n *   ],\r\n *   base: '/app',\r\n * });\r\n *\r\n * router.beforeEach((to, from) => {\r\n *   if (to.path === '/admin' && !isAuthenticated()) {\r\n *     return false; // Cancel navigation\r\n *   }\r\n * });\r\n * ```\r\n */\r\nexport const createRouter = (options: RouterOptions): Router => {\r\n  // Clean up any existing router to prevent guard leakage\r\n  if (activeRouter) {\r\n    activeRouter.destroy();\r\n  }\r\n\r\n  const { routes, base = '', hash: useHash = false } = options;\r\n\r\n  // Instance-specific guards and hooks (not shared globally)\r\n  const beforeGuards: NavigationGuard[] = [];\r\n  const afterHooks: Array<(to: Route, from: Route) => void> = [];\r\n\r\n  // Flatten nested routes\r\n  const flatRoutes = flattenRoutes(routes, base);\r\n\r\n  /**\r\n   * Gets the current path from the URL.\r\n   */\r\n  const getCurrentPath = (): { pathname: string; search: string; hash: string } => {\r\n    if (useHash) {\r\n      const hashPath = window.location.hash.slice(1) || '/';\r\n      const [pathname, rest = ''] = hashPath.split('?');\r\n      const [search, hashPart = ''] = rest.split('#');\r\n      return {\r\n        pathname,\r\n        search: search ? `?${search}` : '',\r\n        hash: hashPart ? `#${hashPart}` : '',\r\n      };\r\n    }\r\n\r\n    let pathname = window.location.pathname;\r\n    if (base && pathname.startsWith(base)) {\r\n      pathname = pathname.slice(base.length) || '/';\r\n    }\r\n\r\n    return {\r\n      pathname,\r\n      search: window.location.search,\r\n      hash: window.location.hash,\r\n    };\r\n  };\r\n\r\n  /**\r\n   * Updates the route signal with current URL state.\r\n   */\r\n  const syncRoute = (): void => {\r\n    const { pathname, search, hash } = getCurrentPath();\r\n    const newRoute = createRoute(pathname, search, hash, flatRoutes);\r\n    routeSignal.value = newRoute;\r\n  };\r\n\r\n  /**\r\n   * Performs navigation with guards.\r\n   */\r\n  const performNavigation = async (\r\n    path: string,\r\n    method: 'pushState' | 'replaceState'\r\n  ): Promise<void> => {\r\n    const { pathname, search, hash } = getCurrentPath();\r\n    const from = createRoute(pathname, search, hash, flatRoutes);\r\n\r\n    // Parse the target path\r\n    const url = new URL(path, window.location.origin);\r\n    const toPath = useHash ? path : url.pathname;\r\n    const to = createRoute(toPath, url.search, url.hash, flatRoutes);\r\n\r\n    // Run beforeEach guards\r\n    for (const guard of beforeGuards) {\r\n      const result = await guard(to, from);\r\n      if (result === false) {\r\n        return; // Cancel navigation\r\n      }\r\n    }\r\n\r\n    // Update browser history\r\n    const fullPath = useHash ? `#${path}` : `${base}${path}`;\r\n    history[method]({}, '', fullPath);\r\n\r\n    // Update route signal\r\n    syncRoute();\r\n\r\n    // Run afterEach hooks\r\n    for (const hook of afterHooks) {\r\n      hook(routeSignal.value, from);\r\n    }\r\n  };\r\n\r\n  /**\r\n   * Handle popstate events (back/forward).\r\n   */\r\n  const handlePopState = async (): Promise<void> => {\r\n    const { pathname, search, hash } = getCurrentPath();\r\n    const from = routeSignal.value;\r\n    const to = createRoute(pathname, search, hash, flatRoutes);\r\n\r\n    // Run beforeEach guards (supports async guards)\r\n    for (const guard of beforeGuards) {\r\n      const result = await guard(to, from);\r\n      if (result === false) {\r\n        // Restore previous state\r\n        const restorePath = useHash ? `#${from.path}` : `${base}${from.path}`;\r\n        history.pushState({}, '', restorePath);\r\n        return;\r\n      }\r\n    }\r\n\r\n    syncRoute();\r\n\r\n    for (const hook of afterHooks) {\r\n      hook(routeSignal.value, from);\r\n    }\r\n  };\r\n\r\n  // Attach popstate listener\r\n  window.addEventListener('popstate', handlePopState);\r\n\r\n  // Initialize route\r\n  syncRoute();\r\n\r\n  const router: Router = {\r\n    push: (path: string) => performNavigation(path, 'pushState'),\r\n    replace: (path: string) => performNavigation(path, 'replaceState'),\r\n    back: () => history.back(),\r\n    forward: () => history.forward(),\r\n    go: (delta: number) => history.go(delta),\r\n\r\n    beforeEach: (guard: NavigationGuard) => {\r\n      beforeGuards.push(guard);\r\n      return () => {\r\n        const index = beforeGuards.indexOf(guard);\r\n        if (index > -1) beforeGuards.splice(index, 1);\r\n      };\r\n    },\r\n\r\n    afterEach: (hook: (to: Route, from: Route) => void) => {\r\n      afterHooks.push(hook);\r\n      return () => {\r\n        const index = afterHooks.indexOf(hook);\r\n        if (index > -1) afterHooks.splice(index, 1);\r\n      };\r\n    },\r\n\r\n    currentRoute,\r\n    routes: flatRoutes,\r\n\r\n    destroy: () => {\r\n      window.removeEventListener('popstate', handlePopState);\r\n      beforeGuards.length = 0;\r\n      afterHooks.length = 0;\r\n      activeRouter = null;\r\n    },\r\n  };\r\n\r\n  activeRouter = router;\r\n  return router;\r\n};\r\n\r\n// ============================================================================\r\n// Utilities\r\n// ============================================================================\r\n\r\n/**\r\n * Flattens nested routes into a single array with full paths.\r\n * @internal\r\n */\r\nconst flattenRoutes = (routes: RouteDefinition[], base = ''): RouteDefinition[] => {\r\n  const result: RouteDefinition[] = [];\r\n\r\n  for (const route of routes) {\r\n    const fullPath = route.path === '*' ? '*' : `${base}${route.path}`.replace(/\\/+/g, '/');\r\n\r\n    result.push({\r\n      ...route,\r\n      path: fullPath,\r\n    });\r\n\r\n    if (route.children) {\r\n      result.push(...flattenRoutes(route.children, fullPath));\r\n    }\r\n  }\r\n\r\n  return result;\r\n};\r\n\r\n/**\r\n * Resolves a route by name and params.\r\n *\r\n * @param name - The route name\r\n * @param params - Route params to interpolate\r\n * @returns The resolved path\r\n *\r\n * @example\r\n * ```ts\r\n * import { resolve } from 'bquery/router';\r\n *\r\n * const path = resolve('user', { id: '42' });\r\n * // Returns '/user/42' if route is defined as { name: 'user', path: '/user/:id' }\r\n * ```\r\n */\r\nexport const resolve = (name: string, params: Record<string, string> = {}): string => {\r\n  if (!activeRouter) {\r\n    throw new Error('bQuery router: No router initialized.');\r\n  }\r\n\r\n  const route = activeRouter.routes.find((r) => r.name === name);\r\n  if (!route) {\r\n    throw new Error(`bQuery router: Route \"${name}\" not found.`);\r\n  }\r\n\r\n  let path = route.path;\r\n  for (const [key, value] of Object.entries(params)) {\r\n    path = path.replace(`:${key}`, encodeURIComponent(value));\r\n  }\r\n\r\n  return path;\r\n};\r\n\r\n/**\r\n * Checks if a path matches the current route.\r\n *\r\n * @param path - Path to check\r\n * @param exact - Whether to match exactly (default: false)\r\n * @returns True if the path matches\r\n *\r\n * @example\r\n * ```ts\r\n * import { isActive } from 'bquery/router';\r\n *\r\n * if (isActive('/dashboard')) {\r\n *   // Highlight nav item\r\n * }\r\n * ```\r\n */\r\nexport const isActive = (path: string, exact = false): boolean => {\r\n  const current = routeSignal.value.path;\r\n  return exact ? current === path : current.startsWith(path);\r\n};\r\n\r\n/**\r\n * Creates a computed signal that checks if a path is active.\r\n *\r\n * @param path - Path to check\r\n * @param exact - Whether to match exactly\r\n * @returns A reactive signal\r\n *\r\n * @example\r\n * ```ts\r\n * import { isActiveSignal } from 'bquery/router';\r\n * import { effect } from 'bquery/reactive';\r\n *\r\n * const dashboardActive = isActiveSignal('/dashboard');\r\n * effect(() => {\r\n *   navItem.classList.toggle('active', dashboardActive.value);\r\n * });\r\n * ```\r\n */\r\nexport const isActiveSignal = (path: string, exact = false): ReadonlySignal<boolean> => {\r\n  return computed(() => {\r\n    const current = routeSignal.value.path;\r\n    return exact ? current === path : current.startsWith(path);\r\n  });\r\n};\r\n\r\n// ============================================================================\r\n// Router Link Helper\r\n// ============================================================================\r\n\r\n/**\r\n * Creates click handler for router links.\r\n * Attach to anchor elements to enable client-side navigation.\r\n *\r\n * @param path - Target path\r\n * @param options - Navigation options\r\n * @returns Click event handler\r\n *\r\n * @example\r\n * ```ts\r\n * import { link } from 'bquery/router';\r\n * import { $ } from 'bquery/core';\r\n *\r\n * $('#nav-home').on('click', link('/'));\r\n * $('#nav-about').on('click', link('/about'));\r\n * ```\r\n */\r\nexport const link = (path: string, options: { replace?: boolean } = {}): ((e: Event) => void) => {\r\n  return (e: Event) => {\r\n    e.preventDefault();\r\n    navigate(path, options);\r\n  };\r\n};\r\n\r\n/**\r\n * Intercepts all link clicks within a container for client-side routing.\r\n * Only intercepts links with matching origins and no target attribute.\r\n *\r\n * @param container - The container element to intercept links in\r\n * @returns Cleanup function to remove the listener\r\n *\r\n * @example\r\n * ```ts\r\n * import { interceptLinks } from 'bquery/router';\r\n *\r\n * // Intercept all links in the app\r\n * const cleanup = interceptLinks(document.body);\r\n *\r\n * // Later, remove the interceptor\r\n * cleanup();\r\n * ```\r\n */\r\nexport const interceptLinks = (container: Element = document.body): (() => void) => {\r\n  const handler = (e: Event) => {\r\n    const target = e.target as HTMLElement;\r\n    const anchor = target.closest('a');\r\n\r\n    if (!anchor) return;\r\n    if (anchor.target) return; // Has target attribute\r\n    if (anchor.hasAttribute('download')) return;\r\n    if (anchor.origin !== window.location.origin) return; // External link\r\n\r\n    const path = anchor.pathname + anchor.search + anchor.hash;\r\n\r\n    e.preventDefault();\r\n    navigate(path);\r\n  };\r\n\r\n  container.addEventListener('click', handler);\r\n  return () => container.removeEventListener('click', handler);\r\n};\r\n"],"names":["activeRouter","routeSignal","signal","currentRoute","computed","pathToRegex","path","PARAM_MARKER","WILDCARD_MARKER","paramNames","pattern","_","name","paramIdx","extractParamNames","matches","m","matchRoute","routes","route","regex","match","params","index","parseQuery","search","query","value","key","existing","createRoute","pathname","hash","result","navigate","options","back","forward","createRouter","base","useHash","beforeGuards","afterHooks","flatRoutes","flattenRoutes","getCurrentPath","hashPath","rest","hashPart","syncRoute","newRoute","performNavigation","method","from","url","toPath","to","guard","fullPath","hook","handlePopState","restorePath","router","delta","resolve","r","isActive","exact","current","isActiveSignal","link","interceptLinks","container","handler","anchor"],"mappings":"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"}

package/dist/store/index.d.ts

@@ -0,0 +1,288 @@
+/**
+ * Minimal state management built on signals.
+ *
+ * This module provides a lightweight store pattern inspired by Pinia/Vuex
+ * but built entirely on bQuery's reactive primitives. Features include:
+ * - Signal-based reactive state
+ * - Computed getters
+ * - Actions with async support
+ * - Devtools hooks for debugging
+ * - Plugin system for extensions
+ *
+ * @module bquery/store
+ *
+ * @example
+ * ```ts
+ * import { createStore } from 'bquery/store';
+ * import { effect } from 'bquery/reactive';
+ *
+ * const counterStore = createStore({
+ *   id: 'counter',
+ *   state: () => ({ count: 0 }),
+ *   getters: {
+ *     doubled: (state) => state.count * 2,
+ *     isPositive: (state) => state.count > 0,
+ *   },
+ *   actions: {
+ *     increment() {
+ *       this.count++;
+ *     },
+ *     async fetchAndSet(url: string) {
+ *       const response = await fetch(url);
+ *       const data = await response.json();
+ *       this.count = data.count;
+ *     },
+ *   },
+ * });
+ *
+ * effect(() => {
+ *   console.log('Count:', counterStore.count);
+ *   console.log('Doubled:', counterStore.doubled);
+ * });
+ *
+ * counterStore.increment();
+ * ```
+ */
+/**
+ * Store state factory function.
+ */
+export type StateFactory<S> = () => S;
+/**
+ * Getter definition - derives computed values from state.
+ */
+export type Getters<S, G> = {
+    [K in keyof G]: (state: S, getters: G) => G[K];
+};
+/**
+ * Action definition - methods that can modify state.
+ */
+export type Actions<S, A> = {
+    [K in keyof A]: A[K] extends (...args: infer P) => infer R ? (this: S & A, ...args: P) => R : never;
+};
+/**
+ * Store definition for createStore.
+ */
+export type StoreDefinition<S extends Record<string, unknown> = Record<string, unknown>, G extends Record<string, unknown> = Record<string, unknown>, A extends Record<string, (...args: any[]) => any> = Record<string, never>> = {
+    /** Unique store identifier for devtools */
+    id: string;
+    /** State factory function */
+    state: StateFactory<S>;
+    /** Computed getters */
+    getters?: Getters<S, G>;
+    /** Action methods */
+    actions?: A;
+};
+/**
+ * The returned store instance with state, getters, and actions merged.
+ */
+export type Store<S extends Record<string, unknown>, G extends Record<string, unknown>, A extends Record<string, (...args: any[]) => any>> = S & G & A & {
+    /** Store identifier */
+    $id: string;
+    /** Reset state to initial values */
+    $reset: () => void;
+    /** Subscribe to state changes */
+    $subscribe: (callback: (state: S) => void) => () => void;
+    /** Patch multiple state properties at once (shallow) */
+    $patch: (partial: Partial<S> | ((state: S) => void)) => void;
+    /**
+     * Patch with deep reactivity support.
+     * Unlike $patch, this method deep-clones nested objects before mutation,
+     * ensuring that all changes trigger reactive updates.
+     */
+    $patchDeep: (partial: Partial<S> | ((state: S) => void)) => void;
+    /** Get raw state object (non-reactive snapshot) */
+    $state: S;
+};
+/**
+ * Plugin that can extend store functionality.
+ */
+export type StorePlugin<S = unknown> = (context: {
+    store: Store<any, any, any>;
+    options: StoreDefinition<any, any, any>;
+}) => Partial<S> | void;
+/** @internal Devtools hook */
+declare global {
+    interface Window {
+        __BQUERY_DEVTOOLS__?: {
+            stores: Map<string, unknown>;
+            onStoreCreated?: (id: string, store: unknown) => void;
+            onStateChange?: (id: string, state: unknown) => void;
+        };
+    }
+}
+/**
+ * Creates a reactive store with state, getters, and actions.
+ *
+ * @template S - State type
+ * @template G - Getters type
+ * @template A - Actions type
+ * @param definition - Store definition
+ * @returns The reactive store instance
+ *
+ * @example
+ * ```ts
+ * import { createStore } from 'bquery/store';
+ *
+ * // Simple counter store
+ * const useCounter = createStore({
+ *   id: 'counter',
+ *   state: () => ({ count: 0, step: 1 }),
+ *   getters: {
+ *     doubled: (state) => state.count * 2,
+ *     next: (state) => state.count + state.step,
+ *   },
+ *   actions: {
+ *     increment() {
+ *       this.count += this.step;
+ *     },
+ *     decrement() {
+ *       this.count -= this.step;
+ *     },
+ *     setStep(newStep: number) {
+ *       this.step = newStep;
+ *     },
+ *     async loadFromServer() {
+ *       const res = await fetch('/api/counter');
+ *       const data = await res.json();
+ *       this.count = data.count;
+ *     },
+ *   },
+ * });
+ *
+ * // Use the store
+ * useCounter.increment();
+ * console.log(useCounter.count); // 1
+ * console.log(useCounter.doubled); // 2
+ * ```
+ */
+export declare const createStore: <S extends Record<string, unknown>, G extends Record<string, unknown> = Record<string, never>, A extends Record<string, (...args: any[]) => any> = Record<string, never>>(definition: StoreDefinition<S, G, A>) => Store<S, G, A>;
+/**
+ * Retrieves an existing store by its ID.
+ *
+ * @param id - The store identifier
+ * @returns The store instance or undefined if not found
+ *
+ * @example
+ * ```ts
+ * import { getStore } from 'bquery/store';
+ *
+ * const counter = getStore('counter');
+ * if (counter) {
+ *   counter.increment();
+ * }
+ * ```
+ */
+export declare const getStore: <T = unknown>(id: string) => T | undefined;
+/**
+ * Lists all registered store IDs.
+ *
+ * @returns Array of store IDs
+ *
+ * @example
+ * ```ts
+ * import { listStores } from 'bquery/store';
+ *
+ * console.log('Active stores:', listStores());
+ * ```
+ */
+export declare const listStores: () => string[];
+/**
+ * Removes a store from the registry.
+ *
+ * @param id - The store identifier
+ *
+ * @example
+ * ```ts
+ * import { destroyStore } from 'bquery/store';
+ *
+ * destroyStore('counter');
+ * ```
+ */
+export declare const destroyStore: (id: string) => void;
+/**
+ * Registers a plugin that extends all stores.
+ *
+ * @param plugin - The plugin function
+ *
+ * @example
+ * ```ts
+ * import { registerPlugin } from 'bquery/store';
+ *
+ * // Add localStorage persistence
+ * registerPlugin(({ store, options }) => {
+ *   const key = `bquery-store-${options.id}`;
+ *
+ *   // Load saved state
+ *   const saved = localStorage.getItem(key);
+ *   if (saved) {
+ *     store.$patch(JSON.parse(saved));
+ *   }
+ *
+ *   // Save on changes
+ *   store.$subscribe((state) => {
+ *     localStorage.setItem(key, JSON.stringify(state));
+ *   });
+ * });
+ * ```
+ */
+export declare const registerPlugin: (plugin: StorePlugin) => void;
+/**
+ * Creates a store with automatic persistence to localStorage.
+ *
+ * @param definition - Store definition
+ * @param storageKey - Optional custom storage key
+ * @returns The reactive store instance
+ *
+ * @example
+ * ```ts
+ * import { createPersistedStore } from 'bquery/store';
+ *
+ * const settings = createPersistedStore({
+ *   id: 'settings',
+ *   state: () => ({
+ *     theme: 'dark',
+ *     language: 'en',
+ *   }),
+ * });
+ *
+ * // State is automatically saved/loaded from localStorage
+ * settings.theme = 'light';
+ * ```
+ */
+export declare const createPersistedStore: <S extends Record<string, unknown>, G extends Record<string, unknown> = Record<string, never>, A extends Record<string, (...args: unknown[]) => unknown> = Record<string, never>>(definition: StoreDefinition<S, G, A>, storageKey?: string) => Store<S, G, A>;
+/**
+ * Maps store state properties to a reactive object for use in components.
+ *
+ * @param store - The store instance
+ * @param keys - State keys to map
+ * @returns Object with mapped properties
+ *
+ * @example
+ * ```ts
+ * import { mapState } from 'bquery/store';
+ *
+ * const counter = useCounter();
+ * const { count, step } = mapState(counter, ['count', 'step']);
+ * ```
+ */
+export declare const mapState: <S extends Record<string, unknown>, K extends keyof S>(store: S, keys: K[]) => Pick<S, K>;
+/**
+ * Maps store actions to an object for easier destructuring.
+ *
+ * @param store - The store instance
+ * @param keys - Action keys to map
+ * @returns Object with mapped actions
+ *
+ * @example
+ * ```ts
+ * import { mapActions } from 'bquery/store';
+ *
+ * const counter = useCounter();
+ * const { increment, decrement } = mapActions(counter, ['increment', 'decrement']);
+ *
+ * // Use directly
+ * increment();
+ * ```
+ */
+export declare const mapActions: <A extends Record<string, (...args: unknown[]) => unknown>, K extends keyof A>(store: A, keys: K[]) => Pick<A, K>;
+//# sourceMappingURL=index.d.ts.map

package/dist/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"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"}