@bquery/bquery 1.11.1 → 1.12.0

package/dist/{testing-CeMUwrRD.js.map → testing-ByjwS2_D.js.map}

@@ -1 +1 @@
-{"version":3,"file":"testing-CeMUwrRD.js","names":[],"sources":["../src/testing/testing.ts"],"sourcesContent":["/**\n * Testing utilities for bQuery.js.\n *\n * Provides helpers for mounting components, controlling signals, mocking\n * the router, dispatching events, and asserting async conditions — all\n * designed for use with `bun:test` and happy-dom.\n *\n * @module bquery/testing\n */\n\nimport { batch, Signal, signal } from '../reactive/index';\nimport { getNormalizedRouteConstraint } from '../router/constraints';\nimport type {\n  FireEventOptions,\n  MockRouteDefinition,\n  MockRouter,\n  MockRouterOptions,\n  MockSignal,\n  RenderComponentOptions,\n  RenderResult,\n  TestRoute,\n  WaitForOptions,\n} from './types';\n\n// ============================================================================\n// renderComponent\n// ============================================================================\n\nconst isWordChar = (char: string | undefined): boolean =>\n  char !== undefined &&\n  ((char >= 'a' && char <= 'z') ||\n    (char >= 'A' && char <= 'Z') ||\n    (char >= '0' && char <= '9') ||\n    char === '_');\n\nconst readRouteConstraint = (\n  pattern: string,\n  startIndex: number\n): { constraint: string; endIndex: number } | null => {\n  let depth = 1;\n  let constraint = '';\n  let i = startIndex + 1;\n\n  while (i < pattern.length) {\n    const char = pattern[i];\n\n    if (char === '\\\\' && i + 1 < pattern.length) {\n      constraint += char + pattern[i + 1];\n      i += 2;\n      continue;\n    }\n\n    if (char === '(') {\n      depth++;\n    } else if (char === ')') {\n      depth--;\n      if (depth === 0) {\n        return { constraint, endIndex: i + 1 };\n      }\n    }\n\n    constraint += char;\n    i++;\n  }\n\n  return null;\n};\n\nconst routeConstraintRegexCache = new Map<string, RegExp>();\n\nconst getRouteConstraintRegex = (constraint: string): RegExp => {\n  const normalized = getNormalizedRouteConstraint(constraint);\n  const cached = routeConstraintRegexCache.get(normalized);\n  if (cached) {\n    return cached;\n  }\n\n  const compiled = new RegExp(`^(?:${normalized})$`);\n  routeConstraintRegexCache.set(normalized, compiled);\n  return compiled;\n};\n\n/**\n * Mounts a custom element by tag name for testing and returns a handle\n * to interact with it.\n *\n * The element is created, configured with the given props and slots,\n * and appended to the container (defaults to `document.body`). Call\n * `unmount()` to remove the element and trigger its `disconnectedCallback`.\n *\n * @param tagName - The custom element tag name (must already be registered)\n * @param options - Props, slots, and container configuration\n * @returns A {@link RenderResult} with the element and an unmount function\n * @throws {Error} If the tag name is not a valid custom element name\n *\n * @example\n * ```ts\n * import { renderComponent } from '@bquery/bquery/testing';\n *\n * const { el, unmount } = renderComponent('my-counter', {\n *   props: { start: '5' },\n * });\n * expect(el.shadowRoot?.textContent).toContain('5');\n * unmount();\n * ```\n */\nexport function renderComponent(\n  tagName: string,\n  options: RenderComponentOptions = {}\n): RenderResult {\n  if (!tagName || !tagName.includes('-')) {\n    throw new Error(\n      `bQuery testing: \"${tagName}\" is not a valid custom element tag name (must contain a hyphen)`\n    );\n  }\n\n  const { props, slots, container = document.body } = options;\n\n  const el = document.createElement(tagName);\n\n  // Set attributes (props) before connecting\n  if (props) {\n    for (const [key, value] of Object.entries(props)) {\n      if (value === null || value === undefined) continue;\n      el.setAttribute(key, String(value));\n    }\n  }\n\n  // Inject slot content before connecting so the component can discover it\n  if (slots) {\n    if (typeof slots === 'string') {\n      el.innerHTML = slots;\n    } else {\n      const parts: string[] = [];\n      for (const [slotName, html] of Object.entries(slots)) {\n        if (slotName === 'default') {\n          parts.push(html);\n        } else {\n          const safeSlotName = slotName\n            .replace(/&/g, '&amp;')\n            .replace(/\"/g, '&quot;')\n            .replace(/</g, '&lt;')\n            .replace(/>/g, '&gt;');\n          parts.push(`<div slot=\"${safeSlotName}\">${html}</div>`);\n        }\n      }\n      el.innerHTML = parts.join('');\n    }\n  }\n\n  // Connect — triggers connectedCallback\n  container.appendChild(el);\n\n  const unmount = (): void => {\n    if (el.parentNode) {\n      el.parentNode.removeChild(el);\n    }\n  };\n\n  return { el, unmount };\n}\n\n// ============================================================================\n// flushEffects\n// ============================================================================\n\n/**\n * Synchronously flushes any pending reactive effects.\n *\n * In bQuery's reactive system, effects outside of a batch are executed\n * synchronously. This helper exists primarily for clarity and for\n * flushing effects that may have been deferred inside a batch.\n *\n * Internally it performs a no-op batch to trigger the flush of any\n * pending observers that were queued during a prior `batch()` call.\n *\n * @example\n * ```ts\n * import { signal, batch } from '@bquery/bquery/reactive';\n * import { flushEffects } from '@bquery/bquery/testing';\n *\n * const count = signal(0);\n * let observed = 0;\n * effect(() => { observed = count.value; });\n *\n * batch(() => { count.value = 42; });\n * flushEffects();\n * expect(observed).toBe(42);\n * ```\n */\nexport function flushEffects(): void {\n  // A no-op batch triggers endBatch which flushes any pending observers.\n  // Since bQuery's effects are synchronous outside of batches, this is\n  // mainly useful after manual batch calls or micro-task boundaries.\n  batch(() => {\n    /* intentionally empty — triggers pending observer flush */\n  });\n}\n\n// ============================================================================\n// mockSignal\n// ============================================================================\n\n/**\n * Creates a controllable signal for tests with `set()` and `reset()` helpers.\n *\n * This is a thin wrapper around `signal()` that records the initial value\n * and adds explicit `set()` / `reset()` methods for clearer test intent.\n *\n * @template T - The type of the signal value\n * @param initialValue - The initial value\n * @returns A {@link MockSignal} instance\n *\n * @example\n * ```ts\n * import { mockSignal } from '@bquery/bquery/testing';\n *\n * const count = mockSignal(0);\n * count.set(5);\n * expect(count.value).toBe(5);\n * count.reset();\n * expect(count.value).toBe(0);\n * ```\n */\nexport function mockSignal<T>(initialValue: T): MockSignal<T> {\n  const s = signal(initialValue) as Signal<T> & {\n    set: (value: T) => void;\n    reset: () => void;\n    initialValue: T;\n  };\n\n  Object.defineProperty(s, 'initialValue', {\n    value: initialValue,\n    writable: false,\n    enumerable: true,\n  });\n\n  s.set = function (value: T): void {\n    s.value = value;\n  };\n\n  s.reset = function (): void {\n    s.value = initialValue;\n  };\n\n  return s as MockSignal<T>;\n}\n\n// ============================================================================\n// mockRouter\n// ============================================================================\n\n/**\n * Parses a path string into the route's `path`, `query`, and `hash` parts.\n * @internal\n */\nfunction parsePath(\n  fullPath: string,\n  base: string\n): { path: string; query: Record<string, string | string[]>; hash: string } {\n  let working = fullPath;\n\n  // Strip base prefix\n  if (base && working.startsWith(base)) {\n    working = working.slice(base.length) || '/';\n  }\n\n  // Extract hash\n  let hash = '';\n  const hashIdx = working.indexOf('#');\n  if (hashIdx >= 0) {\n    hash = working.slice(hashIdx + 1);\n    working = working.slice(0, hashIdx);\n  }\n\n  // Extract query string\n  const query: Record<string, string | string[]> = {};\n  const qIdx = working.indexOf('?');\n  if (qIdx >= 0) {\n    const qs = working.slice(qIdx + 1);\n    working = working.slice(0, qIdx);\n    for (const pair of qs.split('&')) {\n      const eqIdx = pair.indexOf('=');\n      const key = eqIdx >= 0 ? decodeURIComponent(pair.slice(0, eqIdx)) : decodeURIComponent(pair);\n      const val = eqIdx >= 0 ? decodeURIComponent(pair.slice(eqIdx + 1)) : '';\n      const existing = query[key];\n      if (existing !== undefined) {\n        if (Array.isArray(existing)) {\n          existing.push(val);\n        } else {\n          query[key] = [existing, val];\n        }\n      } else {\n        query[key] = val;\n      }\n    }\n  }\n\n  return { path: working || '/', query, hash };\n}\n\n/**\n * Matches a path against a route definition, extracting params.\n * @internal\n */\nfunction matchRoute(\n  path: string,\n  routes: MockRouteDefinition[]\n): { matched: MockRouteDefinition | null; params: Record<string, string> } {\n  for (const route of routes) {\n    const params = matchRoutePattern(route.path, path);\n    if (params) {\n      return { matched: route, params };\n    }\n  }\n  return { matched: null, params: {} };\n}\n\n/**\n * Builds param matches from a route path pattern without compiling the full path into a regex.\n * @internal\n */\nfunction matchRoutePattern(pattern: string, path: string): Record<string, string> | null {\n  if (pattern === '*') {\n    return {};\n  }\n\n  // Memoization keeps wildcard/param backtracking linear for repeated subproblems\n  // within a single pattern/path match attempt.\n  const memo = new Map<string, Record<string, string> | null>();\n\n  const findSegmentBoundary = (value: string, startIndex: number): number => {\n    const slashIndex = value.indexOf('/', startIndex);\n    return slashIndex === -1 ? value.length : slashIndex;\n  };\n\n  const matchFrom = (patternIndex: number, pathIndex: number): Record<string, string> | null => {\n    const memoKey = `${patternIndex}:${pathIndex}`;\n    if (memo.has(memoKey)) {\n      return memo.get(memoKey) ?? null;\n    }\n\n    if (patternIndex === pattern.length) {\n      const result = pathIndex === path.length ? {} : null;\n      memo.set(memoKey, result);\n      return result;\n    }\n\n    const patternChar = pattern[patternIndex];\n\n    if (patternChar === '*') {\n      for (let candidateEnd = path.length; candidateEnd >= pathIndex; candidateEnd--) {\n        const suffixMatch = matchFrom(patternIndex + 1, candidateEnd);\n        if (suffixMatch) {\n          memo.set(memoKey, suffixMatch);\n          return suffixMatch;\n        }\n      }\n\n      memo.set(memoKey, null);\n      return null;\n    }\n\n    if (patternChar === ':' && isWordChar(pattern[patternIndex + 1])) {\n      let nameEnd = patternIndex + 2;\n      while (nameEnd < pattern.length && isWordChar(pattern[nameEnd])) {\n        nameEnd++;\n      }\n\n      const name = pattern.slice(patternIndex + 1, nameEnd);\n      let nextPatternIndex = nameEnd;\n      let constraint: string | undefined;\n      let catchAll = false;\n\n      if (pattern[nameEnd] === '(') {\n        const parsedConstraint = readRouteConstraint(pattern, nameEnd);\n        if (parsedConstraint) {\n          constraint = parsedConstraint.constraint;\n          nextPatternIndex = parsedConstraint.endIndex;\n        }\n      }\n\n      if (pattern[nextPatternIndex] === '*') {\n        catchAll = true;\n        nextPatternIndex++;\n      }\n\n      const candidateLimit = catchAll\n        ? path.length\n        : constraint\n          ? path.length\n          : findSegmentBoundary(path, pathIndex);\n\n      for (let candidateEnd = candidateLimit; candidateEnd > pathIndex; candidateEnd--) {\n        const candidateValue = path.slice(pathIndex, candidateEnd);\n        if (constraint) {\n          const constraintRegex = getRouteConstraintRegex(constraint);\n          if (!constraintRegex.test(candidateValue)) {\n            continue;\n          }\n        }\n\n        const suffixMatch = matchFrom(nextPatternIndex, candidateEnd);\n        if (suffixMatch) {\n          const result = {\n            [name]: candidateValue,\n            ...suffixMatch,\n          };\n          memo.set(memoKey, result);\n          return result;\n        }\n      }\n\n      memo.set(memoKey, null);\n      return null;\n    }\n\n    if (pathIndex >= path.length || patternChar !== path[pathIndex]) {\n      memo.set(memoKey, null);\n      return null;\n    }\n\n    const result = matchFrom(patternIndex + 1, pathIndex + 1);\n    memo.set(memoKey, result);\n    return result;\n  };\n\n  return matchFrom(0, 0);\n}\n\n/**\n * Creates a lightweight mock router for testing that does not interact\n * with the browser History API.\n *\n * The mock router provides a reactive `currentRoute` signal that updates\n * when `push()` or `replace()` is called, making it ideal for testing\n * components or logic that depend on route state.\n *\n * @param options - Mock router configuration\n * @returns A {@link MockRouter} instance\n *\n * @example\n * ```ts\n * import { mockRouter } from '@bquery/bquery/testing';\n *\n * const router = mockRouter({\n *   routes: [\n *     { path: '/', component: () => null },\n *     { path: '/user/:id', component: () => null },\n *   ],\n *   initialPath: '/',\n * });\n *\n * router.push('/user/42');\n * expect(router.currentRoute.value.params.id).toBe('42');\n * router.destroy();\n * ```\n */\nexport function mockRouter(options: MockRouterOptions = {}): MockRouter {\n  const routes = options.routes ?? [{ path: '*', component: () => null }];\n  const base = options.base ?? '';\n  const initialPath = options.initialPath ?? '/';\n\n  const resolveRoute = (fullPath: string): TestRoute => {\n    const { path, query, hash } = parsePath(fullPath, base);\n    const { matched, params } = matchRoute(path, routes);\n    return { path, params, query, matched, hash };\n  };\n\n  const routeSignal = signal<TestRoute>(resolveRoute(initialPath));\n\n  return {\n    push(path: string): void {\n      routeSignal.value = resolveRoute(path);\n    },\n    replace(path: string): void {\n      routeSignal.value = resolveRoute(path);\n    },\n    get currentRoute(): Signal<TestRoute> {\n      return routeSignal;\n    },\n    get routes(): MockRouteDefinition[] {\n      return routes;\n    },\n    destroy(): void {\n      routeSignal.dispose();\n    },\n  };\n}\n\n// ============================================================================\n// fireEvent\n// ============================================================================\n\n/**\n * Dispatches a synthetic event on an element and flushes pending effects.\n *\n * By default the event bubbles, is cancelable, and is composed (crosses\n * shadow DOM boundaries). Pass a `detail` option to create a `CustomEvent`.\n *\n * @param el - The target element\n * @param eventName - The event type (e.g. 'click', 'input', 'my-event')\n * @param options - Event configuration\n * @returns `true` if the event was not cancelled\n *\n * @example\n * ```ts\n * import { fireEvent } from '@bquery/bquery/testing';\n *\n * const button = document.createElement('button');\n * let clicked = false;\n * button.addEventListener('click', () => { clicked = true; });\n * fireEvent(button, 'click');\n * expect(clicked).toBe(true);\n * ```\n */\nexport function fireEvent(el: Element, eventName: string, options: FireEventOptions = {}): boolean {\n  if (!el) {\n    throw new Error('bQuery testing: fireEvent requires a valid element');\n  }\n  if (!eventName) {\n    throw new Error('bQuery testing: fireEvent requires an event name');\n  }\n\n  const { bubbles = true, cancelable = true, composed = true, detail } = options;\n\n  let event: Event;\n  if (detail !== undefined) {\n    event = new CustomEvent(eventName, { bubbles, cancelable, composed, detail });\n  } else {\n    event = new Event(eventName, { bubbles, cancelable, composed });\n  }\n\n  const result = el.dispatchEvent(event);\n\n  // Flush any effects triggered by event handlers\n  flushEffects();\n\n  return result;\n}\n\n// ============================================================================\n// waitFor\n// ============================================================================\n\n/**\n * Waits for a predicate to return `true`, polling at a configurable interval.\n *\n * Useful for asserting conditions that depend on asynchronous operations,\n * timers, or deferred reactive updates.\n *\n * @param predicate - A function that returns `true` when the condition is met\n * @param options - Timeout and interval configuration\n * @returns A promise that resolves when the predicate returns `true`\n * @throws {Error} If the predicate does not return `true` within the timeout\n *\n * @example\n * ```ts\n * import { waitFor } from '@bquery/bquery/testing';\n *\n * await waitFor(() => document.querySelector('.loaded') !== null, {\n *   timeout: 2000,\n * });\n * ```\n */\nexport async function waitFor(\n  predicate: () => boolean | Promise<boolean>,\n  options: WaitForOptions = {}\n): Promise<void> {\n  if (typeof predicate !== 'function') {\n    throw new Error('bQuery testing: waitFor requires a predicate function');\n  }\n\n  const { timeout = 1000, interval = 10 } = options;\n  const start = Date.now();\n\n  while (true) {\n    try {\n      const result = await predicate();\n      if (result) return;\n    } catch {\n      // Predicate threw — treat as not-yet-met and keep polling\n    }\n\n    if (Date.now() - start >= timeout) {\n      throw new Error(\n        `bQuery testing: waitFor timed out after ${timeout}ms — predicate never returned true`\n      );\n    }\n\n    await new Promise((resolve) => setTimeout(resolve, interval));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"testing-ByjwS2_D.js","names":[],"sources":["../src/testing/testing.ts"],"sourcesContent":["/**\n * Testing utilities for bQuery.js.\n *\n * Provides helpers for mounting components, controlling signals, mocking\n * the router, dispatching events, and asserting async conditions — all\n * designed for use with `bun:test` and happy-dom.\n *\n * @module bquery/testing\n */\n\nimport { batch, Signal, signal } from '../reactive/index';\nimport { getNormalizedRouteConstraint } from '../router/constraints';\nimport type {\n  FireEventOptions,\n  MockRouteDefinition,\n  MockRouter,\n  MockRouterOptions,\n  MockSignal,\n  RenderComponentOptions,\n  RenderResult,\n  TestRoute,\n  WaitForOptions,\n} from './types';\n\n// ============================================================================\n// renderComponent\n// ============================================================================\n\nconst isWordChar = (char: string | undefined): boolean =>\n  char !== undefined &&\n  ((char >= 'a' && char <= 'z') ||\n    (char >= 'A' && char <= 'Z') ||\n    (char >= '0' && char <= '9') ||\n    char === '_');\n\nconst readRouteConstraint = (\n  pattern: string,\n  startIndex: number\n): { constraint: string; endIndex: number } | null => {\n  let depth = 1;\n  let constraint = '';\n  let i = startIndex + 1;\n\n  while (i < pattern.length) {\n    const char = pattern[i];\n\n    if (char === '\\\\' && i + 1 < pattern.length) {\n      constraint += char + pattern[i + 1];\n      i += 2;\n      continue;\n    }\n\n    if (char === '(') {\n      depth++;\n    } else if (char === ')') {\n      depth--;\n      if (depth === 0) {\n        return { constraint, endIndex: i + 1 };\n      }\n    }\n\n    constraint += char;\n    i++;\n  }\n\n  return null;\n};\n\nconst routeConstraintRegexCache = new Map<string, RegExp>();\n\nconst getRouteConstraintRegex = (constraint: string): RegExp => {\n  const normalized = getNormalizedRouteConstraint(constraint);\n  const cached = routeConstraintRegexCache.get(normalized);\n  if (cached) {\n    return cached;\n  }\n\n  const compiled = new RegExp(`^(?:${normalized})$`);\n  routeConstraintRegexCache.set(normalized, compiled);\n  return compiled;\n};\n\n/**\n * Mounts a custom element by tag name for testing and returns a handle\n * to interact with it.\n *\n * The element is created, configured with the given props and slots,\n * and appended to the container (defaults to `document.body`). Call\n * `unmount()` to remove the element and trigger its `disconnectedCallback`.\n *\n * @param tagName - The custom element tag name (must already be registered)\n * @param options - Props, slots, and container configuration\n * @returns A {@link RenderResult} with the element and an unmount function\n * @throws {Error} If the tag name is not a valid custom element name\n *\n * @example\n * ```ts\n * import { renderComponent } from '@bquery/bquery/testing';\n *\n * const { el, unmount } = renderComponent('my-counter', {\n *   props: { start: '5' },\n * });\n * expect(el.shadowRoot?.textContent).toContain('5');\n * unmount();\n * ```\n */\nexport function renderComponent(\n  tagName: string,\n  options: RenderComponentOptions = {}\n): RenderResult {\n  if (!tagName || !tagName.includes('-')) {\n    throw new Error(\n      `bQuery testing: \"${tagName}\" is not a valid custom element tag name (must contain a hyphen)`\n    );\n  }\n\n  const { props, slots, container = document.body } = options;\n\n  const el = document.createElement(tagName);\n\n  // Set attributes (props) before connecting\n  if (props) {\n    for (const [key, value] of Object.entries(props)) {\n      if (value === null || value === undefined) continue;\n      el.setAttribute(key, String(value));\n    }\n  }\n\n  // Inject slot content before connecting so the component can discover it\n  if (slots) {\n    if (typeof slots === 'string') {\n      el.innerHTML = slots;\n    } else {\n      const parts: string[] = [];\n      for (const [slotName, html] of Object.entries(slots)) {\n        if (slotName === 'default') {\n          parts.push(html);\n        } else {\n          const safeSlotName = slotName\n            .replace(/&/g, '&amp;')\n            .replace(/\"/g, '&quot;')\n            .replace(/</g, '&lt;')\n            .replace(/>/g, '&gt;');\n          parts.push(`<div slot=\"${safeSlotName}\">${html}</div>`);\n        }\n      }\n      el.innerHTML = parts.join('');\n    }\n  }\n\n  // Connect — triggers connectedCallback\n  container.appendChild(el);\n\n  const unmount = (): void => {\n    if (el.parentNode) {\n      el.parentNode.removeChild(el);\n    }\n  };\n\n  return { el, unmount };\n}\n\n// ============================================================================\n// flushEffects\n// ============================================================================\n\n/**\n * Synchronously flushes any pending reactive effects.\n *\n * In bQuery's reactive system, effects outside of a batch are executed\n * synchronously. This helper exists primarily for clarity and for\n * flushing effects that may have been deferred inside a batch.\n *\n * Internally it performs a no-op batch to trigger the flush of any\n * pending observers that were queued during a prior `batch()` call.\n *\n * @example\n * ```ts\n * import { signal, batch } from '@bquery/bquery/reactive';\n * import { flushEffects } from '@bquery/bquery/testing';\n *\n * const count = signal(0);\n * let observed = 0;\n * effect(() => { observed = count.value; });\n *\n * batch(() => { count.value = 42; });\n * flushEffects();\n * expect(observed).toBe(42);\n * ```\n */\nexport function flushEffects(): void {\n  // A no-op batch triggers endBatch which flushes any pending observers.\n  // Since bQuery's effects are synchronous outside of batches, this is\n  // mainly useful after manual batch calls or micro-task boundaries.\n  batch(() => {\n    /* intentionally empty — triggers pending observer flush */\n  });\n}\n\n// ============================================================================\n// mockSignal\n// ============================================================================\n\n/**\n * Creates a controllable signal for tests with `set()` and `reset()` helpers.\n *\n * This is a thin wrapper around `signal()` that records the initial value\n * and adds explicit `set()` / `reset()` methods for clearer test intent.\n *\n * @template T - The type of the signal value\n * @param initialValue - The initial value\n * @returns A {@link MockSignal} instance\n *\n * @example\n * ```ts\n * import { mockSignal } from '@bquery/bquery/testing';\n *\n * const count = mockSignal(0);\n * count.set(5);\n * expect(count.value).toBe(5);\n * count.reset();\n * expect(count.value).toBe(0);\n * ```\n */\nexport function mockSignal<T>(initialValue: T): MockSignal<T> {\n  const s = signal(initialValue) as Signal<T> & {\n    set: (value: T) => void;\n    reset: () => void;\n    initialValue: T;\n  };\n\n  Object.defineProperty(s, 'initialValue', {\n    value: initialValue,\n    writable: false,\n    enumerable: true,\n  });\n\n  s.set = function (value: T): void {\n    s.value = value;\n  };\n\n  s.reset = function (): void {\n    s.value = initialValue;\n  };\n\n  return s as MockSignal<T>;\n}\n\n// ============================================================================\n// mockRouter\n// ============================================================================\n\n/**\n * Parses a path string into the route's `path`, `query`, and `hash` parts.\n * @internal\n */\nfunction parsePath(\n  fullPath: string,\n  base: string\n): { path: string; query: Record<string, string | string[]>; hash: string } {\n  let working = fullPath;\n\n  // Strip base prefix\n  if (base && working.startsWith(base)) {\n    working = working.slice(base.length) || '/';\n  }\n\n  // Extract hash\n  let hash = '';\n  const hashIdx = working.indexOf('#');\n  if (hashIdx >= 0) {\n    hash = working.slice(hashIdx + 1);\n    working = working.slice(0, hashIdx);\n  }\n\n  // Extract query string\n  const query: Record<string, string | string[]> = {};\n  const qIdx = working.indexOf('?');\n  if (qIdx >= 0) {\n    const qs = working.slice(qIdx + 1);\n    working = working.slice(0, qIdx);\n    for (const pair of qs.split('&')) {\n      const eqIdx = pair.indexOf('=');\n      const key = eqIdx >= 0 ? decodeURIComponent(pair.slice(0, eqIdx)) : decodeURIComponent(pair);\n      const val = eqIdx >= 0 ? decodeURIComponent(pair.slice(eqIdx + 1)) : '';\n      const existing = query[key];\n      if (existing !== undefined) {\n        if (Array.isArray(existing)) {\n          existing.push(val);\n        } else {\n          query[key] = [existing, val];\n        }\n      } else {\n        query[key] = val;\n      }\n    }\n  }\n\n  return { path: working || '/', query, hash };\n}\n\n/**\n * Matches a path against a route definition, extracting params.\n * @internal\n */\nfunction matchRoute(\n  path: string,\n  routes: MockRouteDefinition[]\n): { matched: MockRouteDefinition | null; params: Record<string, string> } {\n  for (const route of routes) {\n    const params = matchRoutePattern(route.path, path);\n    if (params) {\n      return { matched: route, params };\n    }\n  }\n  return { matched: null, params: {} };\n}\n\n/**\n * Builds param matches from a route path pattern without compiling the full path into a regex.\n * @internal\n */\nfunction matchRoutePattern(pattern: string, path: string): Record<string, string> | null {\n  if (pattern === '*') {\n    return {};\n  }\n\n  // Memoization keeps wildcard/param backtracking linear for repeated subproblems\n  // within a single pattern/path match attempt.\n  const memo = new Map<string, Record<string, string> | null>();\n\n  const findSegmentBoundary = (value: string, startIndex: number): number => {\n    const slashIndex = value.indexOf('/', startIndex);\n    return slashIndex === -1 ? value.length : slashIndex;\n  };\n\n  const matchFrom = (patternIndex: number, pathIndex: number): Record<string, string> | null => {\n    const memoKey = `${patternIndex}:${pathIndex}`;\n    if (memo.has(memoKey)) {\n      return memo.get(memoKey) ?? null;\n    }\n\n    if (patternIndex === pattern.length) {\n      const result = pathIndex === path.length ? {} : null;\n      memo.set(memoKey, result);\n      return result;\n    }\n\n    const patternChar = pattern[patternIndex];\n\n    if (patternChar === '*') {\n      for (let candidateEnd = path.length; candidateEnd >= pathIndex; candidateEnd--) {\n        const suffixMatch = matchFrom(patternIndex + 1, candidateEnd);\n        if (suffixMatch) {\n          memo.set(memoKey, suffixMatch);\n          return suffixMatch;\n        }\n      }\n\n      memo.set(memoKey, null);\n      return null;\n    }\n\n    if (patternChar === ':' && isWordChar(pattern[patternIndex + 1])) {\n      let nameEnd = patternIndex + 2;\n      while (nameEnd < pattern.length && isWordChar(pattern[nameEnd])) {\n        nameEnd++;\n      }\n\n      const name = pattern.slice(patternIndex + 1, nameEnd);\n      let nextPatternIndex = nameEnd;\n      let constraint: string | undefined;\n      let catchAll = false;\n\n      if (pattern[nameEnd] === '(') {\n        const parsedConstraint = readRouteConstraint(pattern, nameEnd);\n        if (parsedConstraint) {\n          constraint = parsedConstraint.constraint;\n          nextPatternIndex = parsedConstraint.endIndex;\n        }\n      }\n\n      if (pattern[nextPatternIndex] === '*') {\n        catchAll = true;\n        nextPatternIndex++;\n      }\n\n      const candidateLimit = catchAll\n        ? path.length\n        : constraint\n          ? path.length\n          : findSegmentBoundary(path, pathIndex);\n\n      for (let candidateEnd = candidateLimit; candidateEnd > pathIndex; candidateEnd--) {\n        const candidateValue = path.slice(pathIndex, candidateEnd);\n        if (constraint) {\n          const constraintRegex = getRouteConstraintRegex(constraint);\n          if (!constraintRegex.test(candidateValue)) {\n            continue;\n          }\n        }\n\n        const suffixMatch = matchFrom(nextPatternIndex, candidateEnd);\n        if (suffixMatch) {\n          const result = {\n            [name]: candidateValue,\n            ...suffixMatch,\n          };\n          memo.set(memoKey, result);\n          return result;\n        }\n      }\n\n      memo.set(memoKey, null);\n      return null;\n    }\n\n    if (pathIndex >= path.length || patternChar !== path[pathIndex]) {\n      memo.set(memoKey, null);\n      return null;\n    }\n\n    const result = matchFrom(patternIndex + 1, pathIndex + 1);\n    memo.set(memoKey, result);\n    return result;\n  };\n\n  return matchFrom(0, 0);\n}\n\n/**\n * Creates a lightweight mock router for testing that does not interact\n * with the browser History API.\n *\n * The mock router provides a reactive `currentRoute` signal that updates\n * when `push()` or `replace()` is called, making it ideal for testing\n * components or logic that depend on route state.\n *\n * @param options - Mock router configuration\n * @returns A {@link MockRouter} instance\n *\n * @example\n * ```ts\n * import { mockRouter } from '@bquery/bquery/testing';\n *\n * const router = mockRouter({\n *   routes: [\n *     { path: '/', component: () => null },\n *     { path: '/user/:id', component: () => null },\n *   ],\n *   initialPath: '/',\n * });\n *\n * router.push('/user/42');\n * expect(router.currentRoute.value.params.id).toBe('42');\n * router.destroy();\n * ```\n */\nexport function mockRouter(options: MockRouterOptions = {}): MockRouter {\n  const routes = options.routes ?? [{ path: '*', component: () => null }];\n  const base = options.base ?? '';\n  const initialPath = options.initialPath ?? '/';\n\n  const resolveRoute = (fullPath: string): TestRoute => {\n    const { path, query, hash } = parsePath(fullPath, base);\n    const { matched, params } = matchRoute(path, routes);\n    return { path, params, query, matched, hash };\n  };\n\n  const routeSignal = signal<TestRoute>(resolveRoute(initialPath));\n\n  return {\n    push(path: string): void {\n      routeSignal.value = resolveRoute(path);\n    },\n    replace(path: string): void {\n      routeSignal.value = resolveRoute(path);\n    },\n    get currentRoute(): Signal<TestRoute> {\n      return routeSignal;\n    },\n    get routes(): MockRouteDefinition[] {\n      return routes;\n    },\n    destroy(): void {\n      routeSignal.dispose();\n    },\n  };\n}\n\n// ============================================================================\n// fireEvent\n// ============================================================================\n\n/**\n * Dispatches a synthetic event on an element and flushes pending effects.\n *\n * By default the event bubbles, is cancelable, and is composed (crosses\n * shadow DOM boundaries). Pass a `detail` option to create a `CustomEvent`.\n *\n * @param el - The target element\n * @param eventName - The event type (e.g. 'click', 'input', 'my-event')\n * @param options - Event configuration\n * @returns `true` if the event was not cancelled\n *\n * @example\n * ```ts\n * import { fireEvent } from '@bquery/bquery/testing';\n *\n * const button = document.createElement('button');\n * let clicked = false;\n * button.addEventListener('click', () => { clicked = true; });\n * fireEvent(button, 'click');\n * expect(clicked).toBe(true);\n * ```\n */\nexport function fireEvent(el: Element, eventName: string, options: FireEventOptions = {}): boolean {\n  if (!el) {\n    throw new Error('bQuery testing: fireEvent requires a valid element');\n  }\n  if (!eventName) {\n    throw new Error('bQuery testing: fireEvent requires an event name');\n  }\n\n  const { bubbles = true, cancelable = true, composed = true, detail } = options;\n\n  let event: Event;\n  if (detail !== undefined) {\n    event = new CustomEvent(eventName, { bubbles, cancelable, composed, detail });\n  } else {\n    event = new Event(eventName, { bubbles, cancelable, composed });\n  }\n\n  const result = el.dispatchEvent(event);\n\n  // Flush any effects triggered by event handlers\n  flushEffects();\n\n  return result;\n}\n\n// ============================================================================\n// waitFor\n// ============================================================================\n\n/**\n * Waits for a predicate to return `true`, polling at a configurable interval.\n *\n * Useful for asserting conditions that depend on asynchronous operations,\n * timers, or deferred reactive updates.\n *\n * @param predicate - A function that returns `true` when the condition is met\n * @param options - Timeout and interval configuration\n * @returns A promise that resolves when the predicate returns `true`\n * @throws {Error} If the predicate does not return `true` within the timeout\n *\n * @example\n * ```ts\n * import { waitFor } from '@bquery/bquery/testing';\n *\n * await waitFor(() => document.querySelector('.loaded') !== null, {\n *   timeout: 2000,\n * });\n * ```\n */\nexport async function waitFor(\n  predicate: () => boolean | Promise<boolean>,\n  options: WaitForOptions = {}\n): Promise<void> {\n  if (typeof predicate !== 'function') {\n    throw new Error('bQuery testing: waitFor requires a predicate function');\n  }\n\n  const { timeout = 1000, interval = 10 } = options;\n  const start = Date.now();\n\n  while (true) {\n    try {\n      const result = await predicate();\n      if (result) return;\n    } catch {\n      // Predicate threw — treat as not-yet-met and keep polling\n    }\n\n    if (Date.now() - start >= timeout) {\n      throw new Error(\n        `bQuery testing: waitFor timed out after ${timeout}ms — predicate never returned true`\n      );\n    }\n\n    await new Promise((resolve) => setTimeout(resolve, interval));\n  }\n}\n"],"mappings":";;;AA4BA,IAAM,IAAA,CAAc,MAClB,MAAS,WACP,KAAQ,OAAO,KAAQ,OACtB,KAAQ,OAAO,KAAQ,OACvB,KAAQ,OAAO,KAAQ,OACxB,MAAS,MAEP,IAAA,CACJ,GACA,MACoD;AACpD,MAAI,IAAQ,GACR,IAAa,IACb,IAAI,IAAa;AAErB,SAAO,IAAI,EAAQ,UAAQ;AACzB,UAAM,IAAO,EAAQ,CAAA;AAErB,QAAI,MAAS,QAAQ,IAAI,IAAI,EAAQ,QAAQ;AAC3C,MAAA,KAAc,IAAO,EAAQ,IAAI,CAAA,GACjC,KAAK;AACL;AAAA,IACF;AAEA,QAAI,MAAS,IACX,CAAA;AAAA,aACS,MAAS,QAClB,KACI,MAAU;AACZ,aAAO;AAAA,QAAE,YAAA;AAAA,QAAY,UAAU,IAAI;AAAA,MAAE;AAIzC,IAAA,KAAc,GACd;AAAA,EACF;AAEA,SAAO;AACT,GAEM,IAA4B,oBAAI,IAAoB,GAEpD,IAAA,CAA2B,MAA+B;AAC9D,QAAM,IAAa,EAA6B,CAAU,GACpD,IAAS,EAA0B,IAAI,CAAU;AACvD,MAAI,EACF,QAAO;AAGT,QAAM,IAAW,IAAI,OAAO,OAAO,CAAA,IAAc;AACjD,SAAA,EAA0B,IAAI,GAAY,CAAQ,GAC3C;AACT;AA0BA,SAAgB,EACd,GACA,IAAkC,CAAC,GACrB;AACd,MAAI,CAAC,KAAW,CAAC,EAAQ,SAAS,GAAG,EACnC,OAAM,IAAI,MACR,oBAAoB,CAAA,kEACtB;AAGF,QAAM,EAAE,OAAA,GAAO,OAAA,GAAO,WAAA,IAAY,SAAS,KAAA,IAAS,GAE9C,IAAK,SAAS,cAAc,CAAO;AAGzC,MAAI,EACF,YAAW,CAAC,GAAK,CAAA,KAAU,OAAO,QAAQ,CAAK;AAC7C,IAAI,KAAU,QACd,EAAG,aAAa,GAAK,OAAO,CAAK,CAAC;AAKtC,MAAI,EACF,KAAI,OAAO,KAAU,SACnB,CAAA,EAAG,YAAY;AAAA,OACV;AACL,UAAM,IAAkB,CAAC;AACzB,eAAW,CAAC,GAAU,CAAA,KAAS,OAAO,QAAQ,CAAK,EACjD,KAAI,MAAa,UACf,CAAA,EAAM,KAAK,CAAI;AAAA,SACV;AACL,YAAM,IAAe,EAClB,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,QAAQ,EACtB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM;AACvB,MAAA,EAAM,KAAK,cAAc,CAAA,KAAiB,CAAA,QAAY;AAAA,IACxD;AAEF,IAAA,EAAG,YAAY,EAAM,KAAK,EAAE;AAAA,EAC9B;AAIF,SAAA,EAAU,YAAY,CAAE,GAQjB;AAAA,IAAE,IAAA;AAAA,IAAI,SANP,MAAsB;AAC1B,MAAI,EAAG,cACL,EAAG,WAAW,YAAY,CAAE;AAAA,IAEhC;AAAA,EAEqB;AACvB;AA8BA,SAAgB,IAAqB;AAInC,EAAA,EAAA,MAAY;AAAA,EAEZ,CAAC;AACH;AA2BA,SAAgB,EAAc,GAAgC;AAC5D,QAAM,IAAI,EAAO,CAAY;AAM7B,gBAAO,eAAe,GAAG,gBAAgB;AAAA,IACvC,OAAO;AAAA,IACP,UAAU;AAAA,IACV,YAAY;AAAA,EACd,CAAC,GAED,EAAE,MAAM,SAAU,GAAgB;AAChC,IAAA,EAAE,QAAQ;AAAA,EACZ,GAEA,EAAE,QAAQ,WAAkB;AAC1B,IAAA,EAAE,QAAQ;AAAA,EACZ,GAEO;AACT;AAUA,SAAS,EACP,GACA,GAC0E;AAC1E,MAAI,IAAU;AAGd,EAAI,KAAQ,EAAQ,WAAW,CAAI,MACjC,IAAU,EAAQ,MAAM,EAAK,MAAM,KAAK;AAI1C,MAAI,IAAO;AACX,QAAM,IAAU,EAAQ,QAAQ,GAAG;AACnC,EAAI,KAAW,MACb,IAAO,EAAQ,MAAM,IAAU,CAAC,GAChC,IAAU,EAAQ,MAAM,GAAG,CAAO;AAIpC,QAAM,IAA2C,CAAC,GAC5C,IAAO,EAAQ,QAAQ,GAAG;AAChC,MAAI,KAAQ,GAAG;AACb,UAAM,IAAK,EAAQ,MAAM,IAAO,CAAC;AACjC,IAAA,IAAU,EAAQ,MAAM,GAAG,CAAI;AAC/B,eAAW,KAAQ,EAAG,MAAM,GAAG,GAAG;AAChC,YAAM,IAAQ,EAAK,QAAQ,GAAG,GACxB,IAAM,KAAS,IAAI,mBAAmB,EAAK,MAAM,GAAG,CAAK,CAAC,IAAI,mBAAmB,CAAI,GACrF,IAAM,KAAS,IAAI,mBAAmB,EAAK,MAAM,IAAQ,CAAC,CAAC,IAAI,IAC/D,IAAW,EAAM,CAAA;AACvB,MAAI,MAAa,SACX,MAAM,QAAQ,CAAQ,IACxB,EAAS,KAAK,CAAG,IAEjB,EAAM,CAAA,IAAO,CAAC,GAAU,CAAG,IAG7B,EAAM,CAAA,IAAO;AAAA,IAEjB;AAAA,EACF;AAEA,SAAO;AAAA,IAAE,MAAM,KAAW;AAAA,IAAK,OAAA;AAAA,IAAO,MAAA;AAAA,EAAK;AAC7C;AAMA,SAAS,EACP,GACA,GACyE;AACzE,aAAW,KAAS,GAAQ;AAC1B,UAAM,IAAS,EAAkB,EAAM,MAAM,CAAI;AACjD,QAAI,EACF,QAAO;AAAA,MAAE,SAAS;AAAA,MAAO,QAAA;AAAA,IAAO;AAAA,EAEpC;AACA,SAAO;AAAA,IAAE,SAAS;AAAA,IAAM,QAAQ,CAAC;AAAA,EAAE;AACrC;AAMA,SAAS,EAAkB,GAAiB,GAA6C;AACvF,MAAI,MAAY,IACd,QAAO,CAAC;AAKV,QAAM,IAAO,oBAAI,IAA2C,GAEtD,IAAA,CAAuB,GAAe,MAA+B;AACzE,UAAM,IAAa,EAAM,QAAQ,KAAK,CAAU;AAChD,WAAO,MAAe,KAAK,EAAM,SAAS;AAAA,EAC5C,GAEM,IAAA,CAAa,GAAsB,MAAqD;AAC5F,UAAM,IAAU,GAAG,CAAA,IAAgB,CAAA;AACnC,QAAI,EAAK,IAAI,CAAO,EAClB,QAAO,EAAK,IAAI,CAAO,KAAK;AAG9B,QAAI,MAAiB,EAAQ,QAAQ;AACnC,YAAM,IAAS,MAAc,EAAK,SAAS,CAAC,IAAI;AAChD,aAAA,EAAK,IAAI,GAAS,CAAM,GACjB;AAAA,IACT;AAEA,UAAM,IAAc,EAAQ,CAAA;AAE5B,QAAI,MAAgB,KAAK;AACvB,eAAS,IAAe,EAAK,QAAQ,KAAgB,GAAW,KAAgB;AAC9E,cAAM,IAAc,EAAU,IAAe,GAAG,CAAY;AAC5D,YAAI;AACF,iBAAA,EAAK,IAAI,GAAS,CAAW,GACtB;AAAA,MAEX;AAEA,aAAA,EAAK,IAAI,GAAS,IAAI,GACf;AAAA,IACT;AAEA,QAAI,MAAgB,OAAO,EAAW,EAAQ,IAAe,CAAA,CAAE,GAAG;AAChE,UAAI,IAAU,IAAe;AAC7B,aAAO,IAAU,EAAQ,UAAU,EAAW,EAAQ,CAAA,CAAQ,IAC5D,CAAA;AAGF,YAAM,IAAO,EAAQ,MAAM,IAAe,GAAG,CAAO;AACpD,UAAI,IAAmB,GACnB,GACA,IAAW;AAEf,UAAI,EAAQ,CAAA,MAAa,KAAK;AAC5B,cAAM,IAAmB,EAAoB,GAAS,CAAO;AAC7D,QAAI,MACF,IAAa,EAAiB,YAC9B,IAAmB,EAAiB;AAAA,MAExC;AAEA,MAAI,EAAQ,CAAA,MAAsB,QAChC,IAAW,IACX;AAGF,YAAM,IAAiB,KAEnB,IADA,EAAK,SAGH,EAAoB,GAAM,CAAS;AAEzC,eAAS,IAAe,GAAgB,IAAe,GAAW,KAAgB;AAChF,cAAM,IAAiB,EAAK,MAAM,GAAW,CAAY;AACzD,YAAI,KAEE,CADoB,EAAwB,CAC3C,EAAgB,KAAK,CAAc;AACtC;AAIJ,cAAM,IAAc,EAAU,GAAkB,CAAY;AAC5D,YAAI,GAAa;AACf,gBAAM,IAAS;AAAA,aACZ,CAAA,GAAO;AAAA,YACR,GAAG;AAAA,UACL;AACA,iBAAA,EAAK,IAAI,GAAS,CAAM,GACjB;AAAA,QACT;AAAA,MACF;AAEA,aAAA,EAAK,IAAI,GAAS,IAAI,GACf;AAAA,IACT;AAEA,QAAI,KAAa,EAAK,UAAU,MAAgB,EAAK,CAAA;AACnD,aAAA,EAAK,IAAI,GAAS,IAAI,GACf;AAGT,UAAM,IAAS,EAAU,IAAe,GAAG,IAAY,CAAC;AACxD,WAAA,EAAK,IAAI,GAAS,CAAM,GACjB;AAAA,EACT;AAEA,SAAO,EAAU,GAAG,CAAC;AACvB;AA8BA,SAAgB,EAAW,IAA6B,CAAC,GAAe;AACtE,QAAM,IAAS,EAAQ,UAAU,CAAC;AAAA,IAAE,MAAM;AAAA,IAAK,WAAA,MAAiB;AAAA,EAAK,CAAC,GAChE,IAAO,EAAQ,QAAQ,IACvB,IAAc,EAAQ,eAAe,KAErC,IAAA,CAAgB,MAAgC;AACpD,UAAM,EAAE,MAAA,GAAM,OAAA,GAAO,MAAA,EAAA,IAAS,EAAU,GAAU,CAAI,GAChD,EAAE,SAAA,GAAS,QAAA,EAAA,IAAW,EAAW,GAAM,CAAM;AACnD,WAAO;AAAA,MAAE,MAAA;AAAA,MAAM,QAAA;AAAA,MAAQ,OAAA;AAAA,MAAO,SAAA;AAAA,MAAS,MAAA;AAAA,IAAK;AAAA,EAC9C,GAEM,IAAc,EAAkB,EAAa,CAAW,CAAC;AAE/D,SAAO;AAAA,IACL,KAAK,GAAoB;AACvB,MAAA,EAAY,QAAQ,EAAa,CAAI;AAAA,IACvC;AAAA,IACA,QAAQ,GAAoB;AAC1B,MAAA,EAAY,QAAQ,EAAa,CAAI;AAAA,IACvC;AAAA,IACA,IAAI,eAAkC;AACpC,aAAO;AAAA,IACT;AAAA,IACA,IAAI,SAAgC;AAClC,aAAO;AAAA,IACT;AAAA,IACA,UAAgB;AACd,MAAA,EAAY,QAAQ;AAAA,IACtB;AAAA,EACF;AACF;AA4BA,SAAgB,EAAU,GAAa,GAAmB,IAA4B,CAAC,GAAY;AACjG,MAAI,CAAC,EACH,OAAM,IAAI,MAAM,oDAAoD;AAEtE,MAAI,CAAC,EACH,OAAM,IAAI,MAAM,kDAAkD;AAGpE,QAAM,EAAE,SAAA,IAAU,IAAM,YAAA,IAAa,IAAM,UAAA,IAAW,IAAM,QAAA,EAAA,IAAW;AAEvE,MAAI;AACJ,EAAI,MAAW,SACb,IAAQ,IAAI,YAAY,GAAW;AAAA,IAAE,SAAA;AAAA,IAAS,YAAA;AAAA,IAAY,UAAA;AAAA,IAAU,QAAA;AAAA,EAAO,CAAC,IAE5E,IAAQ,IAAI,MAAM,GAAW;AAAA,IAAE,SAAA;AAAA,IAAS,YAAA;AAAA,IAAY,UAAA;AAAA,EAAS,CAAC;AAGhE,QAAM,IAAS,EAAG,cAAc,CAAK;AAGrC,SAAA,EAAa,GAEN;AACT;AA0BA,eAAsB,EACpB,GACA,IAA0B,CAAC,GACZ;AACf,MAAI,OAAO,KAAc,WACvB,OAAM,IAAI,MAAM,uDAAuD;AAGzE,QAAM,EAAE,SAAA,IAAU,KAAM,UAAA,IAAW,GAAA,IAAO,GACpC,IAAQ,KAAK,IAAI;AAEvB,aAAa;AACX,QAAI;AAEF,UAAI,MADiB,EAAU,EACnB;AAAA,IACd,QAAQ;AAAA,IAER;AAEA,QAAI,KAAK,IAAI,IAAI,KAAS,EACxB,OAAM,IAAI,MACR,2CAA2C,CAAA,oCAC7C;AAGF,UAAM,IAAI,QAAA,CAAS,MAAY,WAAW,GAAS,CAAQ,CAAC;AAAA,EAC9D;AACF"}

package/dist/testing.es.mjs

@@ -1,4 +1,4 @@
-import { a, i as r, n as e, o as s, r as t, t as n } from "./testing-CeMUwrRD.js";
+import { a, i as r, n as e, o as s, r as t, t as n } from "./testing-ByjwS2_D.js";
 export {
   n as fireEvent,
   e as flushEffects,

package/dist/type-guards-BMX2c0LP.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-guards-BMX2c0LP.js","names":[],"sources":["../src/core/utils/type-guards.ts"],"sourcesContent":["/**\n * Type guard helpers.\n *\n * @module bquery/core/utils/type-guards\n */\n\n/**\n * Checks if a value is a DOM Element.\n *\n * @param value - The value to check\n * @returns True if the value is an Element\n */\nexport function isElement(value: unknown): value is Element {\n  return typeof Element !== 'undefined' && value instanceof Element;\n}\n\n/**\n * Checks if a value is a BQueryCollection-like object.\n *\n * @param value - The value to check\n * @returns True if the value has an elements array property\n */\nexport function isCollection(value: unknown): value is { elements: Element[] } {\n  return Boolean(value && typeof value === 'object' && 'elements' in (value as object));\n}\n\n/**\n * Checks if a value is a function.\n *\n * @param value - The value to check\n * @returns True if the value is a function\n */\nexport function isFunction(value: unknown): value is (...args: unknown[]) => unknown {\n  return typeof value === 'function';\n}\n\n/**\n * Checks if a value is a string.\n *\n * @param value - The value to check\n * @returns True if the value is a string\n */\nexport function isString(value: unknown): value is string {\n  return typeof value === 'string';\n}\n\n/**\n * Checks if a value is a number (excluding NaN).\n *\n * @param value - The value to check\n * @returns True if the value is a valid number\n */\nexport function isNumber(value: unknown): value is number {\n  return typeof value === 'number' && !Number.isNaN(value);\n}\n\n/**\n * Checks if a value is a boolean.\n *\n * @param value - The value to check\n * @returns True if the value is a boolean\n */\nexport function isBoolean(value: unknown): value is boolean {\n  return typeof value === 'boolean';\n}\n\n/**\n * Checks if a value is an array.\n *\n * @template T - The type of array elements\n * @param value - The value to check\n * @returns True if the value is an array\n */\nexport function isArray<T = unknown>(value: unknown): value is T[] {\n  return Array.isArray(value);\n}\n\n/**\n * Checks if a value is a Date instance.\n *\n * @param value - The value to check\n * @returns True if the value is a Date\n */\nexport function isDate(value: unknown): value is Date {\n  return value instanceof Date;\n}\n\n/**\n * Checks if a value is a Promise-like object.\n *\n * @param value - The value to check\n * @returns True if the value is a Promise-like object\n */\nexport function isPromise<T = unknown>(value: unknown): value is Promise<T> {\n  return Boolean(\n    value &&\n    (value instanceof Promise ||\n      (typeof value === 'object' &&\n        'then' in (value as object) &&\n        typeof (value as { then?: unknown }).then === 'function'))\n  );\n}\n\n/**\n * Checks if a value is a non-null object.\n *\n * @param value - The value to check\n * @returns True if the value is an object\n */\nexport function isObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n"],"mappings":"AAYA,SAAgB,EAAU,GAAkC;AAC1D,SAAO,OAAO,UAAY,OAAe,aAAiB;;AAS5D,SAAgB,EAAa,GAAkD;AAC7E,SAAO,GAAQ,KAAS,OAAO,KAAU,YAAY,cAAe;;AAStE,SAAgB,EAAW,GAA0D;AACnF,SAAO,OAAO,KAAU;;AAS1B,SAAgB,EAAS,GAAiC;AACxD,SAAO,OAAO,KAAU;;AAS1B,SAAgB,EAAS,GAAiC;AACxD,SAAO,OAAO,KAAU,YAAY,CAAC,OAAO,MAAM,CAAA;;AASpD,SAAgB,EAAU,GAAkC;AAC1D,SAAO,OAAO,KAAU;;AAU1B,SAAgB,EAAqB,GAA8B;AACjE,SAAO,MAAM,QAAQ,CAAA;;AASvB,SAAgB,EAAO,GAA+B;AACpD,SAAO,aAAiB;;AAS1B,SAAgB,EAAuB,GAAqC;AAC1E,SAAO,GACL,MACC,aAAiB,WACf,OAAO,KAAU,YAChB,UAAW,KACX,OAAQ,EAA6B,QAAS;;AAUtD,SAAgB,EAAS,GAAkD;AACzE,SAAO,OAAO,KAAU,YAAY,MAAU"}
+{"version":3,"file":"type-guards-BMX2c0LP.js","names":[],"sources":["../src/core/utils/type-guards.ts"],"sourcesContent":["/**\n * Type guard helpers.\n *\n * @module bquery/core/utils/type-guards\n */\n\n/**\n * Checks if a value is a DOM Element.\n *\n * @param value - The value to check\n * @returns True if the value is an Element\n */\nexport function isElement(value: unknown): value is Element {\n  return typeof Element !== 'undefined' && value instanceof Element;\n}\n\n/**\n * Checks if a value is a BQueryCollection-like object.\n *\n * @param value - The value to check\n * @returns True if the value has an elements array property\n */\nexport function isCollection(value: unknown): value is { elements: Element[] } {\n  return Boolean(value && typeof value === 'object' && 'elements' in (value as object));\n}\n\n/**\n * Checks if a value is a function.\n *\n * @param value - The value to check\n * @returns True if the value is a function\n */\nexport function isFunction(value: unknown): value is (...args: unknown[]) => unknown {\n  return typeof value === 'function';\n}\n\n/**\n * Checks if a value is a string.\n *\n * @param value - The value to check\n * @returns True if the value is a string\n */\nexport function isString(value: unknown): value is string {\n  return typeof value === 'string';\n}\n\n/**\n * Checks if a value is a number (excluding NaN).\n *\n * @param value - The value to check\n * @returns True if the value is a valid number\n */\nexport function isNumber(value: unknown): value is number {\n  return typeof value === 'number' && !Number.isNaN(value);\n}\n\n/**\n * Checks if a value is a boolean.\n *\n * @param value - The value to check\n * @returns True if the value is a boolean\n */\nexport function isBoolean(value: unknown): value is boolean {\n  return typeof value === 'boolean';\n}\n\n/**\n * Checks if a value is an array.\n *\n * @template T - The type of array elements\n * @param value - The value to check\n * @returns True if the value is an array\n */\nexport function isArray<T = unknown>(value: unknown): value is T[] {\n  return Array.isArray(value);\n}\n\n/**\n * Checks if a value is a Date instance.\n *\n * @param value - The value to check\n * @returns True if the value is a Date\n */\nexport function isDate(value: unknown): value is Date {\n  return value instanceof Date;\n}\n\n/**\n * Checks if a value is a Promise-like object.\n *\n * @param value - The value to check\n * @returns True if the value is a Promise-like object\n */\nexport function isPromise<T = unknown>(value: unknown): value is Promise<T> {\n  return Boolean(\n    value &&\n    (value instanceof Promise ||\n      (typeof value === 'object' &&\n        'then' in (value as object) &&\n        typeof (value as { then?: unknown }).then === 'function'))\n  );\n}\n\n/**\n * Checks if a value is a non-null object.\n *\n * @param value - The value to check\n * @returns True if the value is an object\n */\nexport function isObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n"],"mappings":"AAYA,SAAgB,EAAU,GAAkC;AAC1D,SAAO,OAAO,UAAY,OAAe,aAAiB;AAC5D;AAQA,SAAgB,EAAa,GAAkD;AAC7E,SAAO,GAAQ,KAAS,OAAO,KAAU,YAAY,cAAe;AACtE;AAQA,SAAgB,EAAW,GAA0D;AACnF,SAAO,OAAO,KAAU;AAC1B;AAQA,SAAgB,EAAS,GAAiC;AACxD,SAAO,OAAO,KAAU;AAC1B;AAQA,SAAgB,EAAS,GAAiC;AACxD,SAAO,OAAO,KAAU,YAAY,CAAC,OAAO,MAAM,CAAK;AACzD;AAQA,SAAgB,EAAU,GAAkC;AAC1D,SAAO,OAAO,KAAU;AAC1B;AASA,SAAgB,EAAqB,GAA8B;AACjE,SAAO,MAAM,QAAQ,CAAK;AAC5B;AAQA,SAAgB,EAAO,GAA+B;AACpD,SAAO,aAAiB;AAC1B;AAQA,SAAgB,EAAuB,GAAqC;AAC1E,SAAO,GACL,MACC,aAAiB,WACf,OAAO,KAAU,YAChB,UAAW,KACX,OAAQ,EAA6B,QAAS;AAEtD;AAQA,SAAgB,EAAS,GAAkD;AACzE,SAAO,OAAO,KAAU,YAAY,MAAU;AAChD"}

package/dist/{untrack-bjWDNdyE.js → untrack-uzz3JDNK.js}

@@ -1,5 +1,5 @@
-import { c as h, i, l as a, o as c, s as u, u as r } from "./core-CongXJuo.js";
-import { a as d, r as o } from "./effect-Cc51IH91.js";
+import { c as h, i, l as a, o as c, s as u, u as r } from "./core-yg9rJXiR.js";
+import { a as d, r as o } from "./effect-v8OIEmPs.js";
 var l = class {
   constructor(s) {
     this.compute = s, this.hasCachedValue = !1, this.dirty = !0, this.disposed = !1, this.subscribers = /* @__PURE__ */ new Set(), this.markDirty = () => {
@@ -34,4 +34,4 @@ export {
   b as t
 };
 
-//# sourceMappingURL=untrack-bjWDNdyE.js.map
+//# sourceMappingURL=untrack-uzz3JDNK.js.map

package/dist/{untrack-bjWDNdyE.js.map → untrack-uzz3JDNK.js.map}

@@ -1 +1 @@
-{"version":3,"file":"untrack-bjWDNdyE.js","names":[],"sources":["../src/reactive/computed.ts","../src/reactive/untrack.ts"],"sourcesContent":["/**\n * Computed reactive values.\n */\n\nimport {\n  clearDependencies,\n  getCurrentObserver,\n  registerDependency,\n  scheduleObserver,\n  track,\n  withoutCurrentObserver,\n  type ReactiveSource,\n} from './internals';\nimport { getActiveScope, hasScopeDisposer } from './scope';\n\n/**\n * A computed value that derives from other reactive sources.\n *\n * Computed values are lazily evaluated and cached. They only\n * recompute when their dependencies change.\n *\n * @template T - The type of the computed value\n */\nexport class Computed<T> implements ReactiveSource {\n  private cachedValue!: T;\n  private hasCachedValue = false;\n  private dirty = true;\n  private disposed = false;\n  private subscribers = new Set<() => void>();\n  private readonly markDirty = () => {\n    if (this.disposed) {\n      return;\n    }\n    this.dirty = true;\n    // Create snapshot to avoid issues with subscribers modifying the set during iteration\n    const subscribersSnapshot = Array.from(this.subscribers);\n    for (const subscriber of subscribersSnapshot) {\n      scheduleObserver(subscriber);\n    }\n  };\n\n  /**\n   * Creates a new computed value.\n   * @param compute - Function that computes the value\n   */\n  constructor(private readonly compute: () => T) {}\n\n  /**\n   * Gets the computed value, recomputing if dependencies changed.\n   * During untrack calls, getCurrentObserver returns undefined, preventing dependency tracking.\n   */\n  get value(): T {\n    if (this.disposed) {\n      if (!this.hasCachedValue) {\n        this.cachedValue = withoutCurrentObserver(() => this.compute());\n        this.hasCachedValue = true;\n      }\n      return this.cachedValue;\n    }\n\n    const current = getCurrentObserver();\n    if (current) {\n      this.subscribers.add(current);\n      registerDependency(current, this);\n    }\n    if (this.dirty) {\n      this.dirty = false;\n      // Clear old dependencies before recomputing\n      clearDependencies(this.markDirty);\n      this.cachedValue = track(this.markDirty, this.compute);\n      this.hasCachedValue = true;\n    }\n    return this.cachedValue;\n  }\n\n  /**\n   * Reads the current computed value without tracking.\n   * Useful when you need the value but don't want to create a dependency.\n   *\n   * @returns The current cached value (recomputes if dirty)\n   */\n  peek(): T {\n    if (this.disposed) {\n      if (!this.hasCachedValue) {\n        this.cachedValue = withoutCurrentObserver(() => this.compute());\n        this.hasCachedValue = true;\n      }\n      return this.cachedValue;\n    }\n\n    if (this.dirty) {\n      this.dirty = false;\n      // Clear old dependencies before recomputing\n      clearDependencies(this.markDirty);\n      this.cachedValue = track(this.markDirty, this.compute);\n      this.hasCachedValue = true;\n    }\n    return this.cachedValue;\n  }\n\n  /**\n   * Removes an observer from this computed's subscriber set.\n   * @internal\n   */\n  unsubscribe(observer: () => void): void {\n    this.subscribers.delete(observer);\n  }\n\n  /**\n   * Disposes the computed value by unsubscribing its internal observer\n   * from all upstream dependencies and clearing subscribers.\n   */\n  dispose(): void {\n    this.disposed = true;\n    if (this.dirty) {\n      this.hasCachedValue = false;\n    }\n    this.dirty = false;\n    clearDependencies(this.markDirty);\n    this.subscribers.clear();\n  }\n}\n\n/**\n * Creates a new computed value.\n *\n * If created inside an {@link effectScope}, the computed value is automatically\n * collected and will be disposed when the scope stops.\n *\n * @template T - The type of the computed value\n * @param fn - Function that computes the value from reactive sources\n * @returns A new Computed instance\n */\nexport const computed = <T>(fn: () => T): Computed<T> => {\n  const c = new Computed(fn);\n\n  // Auto-register with the current scope so scope.stop() disposes this computed\n  const scope = getActiveScope();\n  if (hasScopeDisposer(scope)) {\n    scope._addDisposer(() => c.dispose());\n  }\n\n  return c;\n};\n","/**\n * Dependency tracking control helpers.\n */\n\nimport { withoutCurrentObserver } from './internals';\n\n/**\n * Executes a function without tracking any signal dependencies.\n * Useful when reading a signal value without creating a reactive dependency.\n *\n * This implementation temporarily hides the current observer rather than\n * disabling tracking globally. This ensures that nested reactive internals\n * (e.g., computed recomputation triggered during untrack) can still properly\n * track their own dependencies.\n *\n * @template T - The return type of the function\n * @param fn - The function to execute without tracking\n * @returns The result of the function\n *\n * @example\n * ```ts\n * const count = signal(0);\n * effect(() => {\n *   // This read creates a dependency\n *   console.log(count.value);\n *   // This read does not create a dependency\n *   const snapshot = untrack(() => count.value);\n * });\n * ```\n */\nexport const untrack = <T>(fn: () => T): T => withoutCurrentObserver(fn);\n"],"mappings":";;AAuBA,IAAa,IAAb,MAAmD;AAAA,EAsBjD,YAAY,GAAmC;AAAlB,SAAA,UAAA,yBApBJ,iBACT,oBACG,uBACG,oBAAI,IAAA,0BACS;AACjC,UAAI,KAAK,SACP;AAEF,WAAK,QAAQ;AAEb,YAAM,IAAsB,MAAM,KAAK,KAAK,WAAA;AAC5C,iBAAW,KAAc,EACvB,CAAA,EAAiB,CAAA;AAAA;;EAcrB,IAAI,QAAW;AACb,QAAI,KAAK;AACP,aAAK,KAAK,mBACR,KAAK,cAAc,EAAA,MAA6B,KAAK,QAAA,CAAS,GAC9D,KAAK,iBAAiB,KAEjB,KAAK;AAGd,UAAM,IAAU,EAAA;AAChB,WAAI,MACF,KAAK,YAAY,IAAI,CAAA,GACrB,EAAmB,GAAS,IAAA,IAE1B,KAAK,UACP,KAAK,QAAQ,IAEb,EAAkB,KAAK,SAAA,GACvB,KAAK,cAAc,EAAM,KAAK,WAAW,KAAK,OAAA,GAC9C,KAAK,iBAAiB,KAEjB,KAAK;AAAA;EASd,OAAU;AACR,WAAI,KAAK,YACF,KAAK,mBACR,KAAK,cAAc,EAAA,MAA6B,KAAK,QAAA,CAAS,GAC9D,KAAK,iBAAiB,KAEjB,KAAK,gBAGV,KAAK,UACP,KAAK,QAAQ,IAEb,EAAkB,KAAK,SAAA,GACvB,KAAK,cAAc,EAAM,KAAK,WAAW,KAAK,OAAA,GAC9C,KAAK,iBAAiB,KAEjB,KAAK;AAAA;EAOd,YAAY,GAA4B;AACtC,SAAK,YAAY,OAAO,CAAA;AAAA;EAO1B,UAAgB;AACd,SAAK,WAAW,IACZ,KAAK,UACP,KAAK,iBAAiB,KAExB,KAAK,QAAQ,IACb,EAAkB,KAAK,SAAA,GACvB,KAAK,YAAY,MAAA;AAAA;GAcR,IAAA,CAAe,MAA6B;AACvD,QAAM,IAAI,IAAI,EAAS,CAAA,GAGjB,IAAQ,EAAA;AACd,SAAI,EAAiB,CAAA,KACnB,EAAM,aAAA,MAAmB,EAAE,QAAA,CAAS,GAG/B;GChHI,IAAA,CAAc,MAAmB,EAAuB,CAAA"}
+{"version":3,"file":"untrack-uzz3JDNK.js","names":[],"sources":["../src/reactive/computed.ts","../src/reactive/untrack.ts"],"sourcesContent":["/**\n * Computed reactive values.\n */\n\nimport {\n  clearDependencies,\n  getCurrentObserver,\n  registerDependency,\n  scheduleObserver,\n  track,\n  withoutCurrentObserver,\n  type ReactiveSource,\n} from './internals';\nimport { getActiveScope, hasScopeDisposer } from './scope';\n\n/**\n * A computed value that derives from other reactive sources.\n *\n * Computed values are lazily evaluated and cached. They only\n * recompute when their dependencies change.\n *\n * @template T - The type of the computed value\n */\nexport class Computed<T> implements ReactiveSource {\n  private cachedValue!: T;\n  private hasCachedValue = false;\n  private dirty = true;\n  private disposed = false;\n  private subscribers = new Set<() => void>();\n  private readonly markDirty = () => {\n    if (this.disposed) {\n      return;\n    }\n    this.dirty = true;\n    // Create snapshot to avoid issues with subscribers modifying the set during iteration\n    const subscribersSnapshot = Array.from(this.subscribers);\n    for (const subscriber of subscribersSnapshot) {\n      scheduleObserver(subscriber);\n    }\n  };\n\n  /**\n   * Creates a new computed value.\n   * @param compute - Function that computes the value\n   */\n  constructor(private readonly compute: () => T) {}\n\n  /**\n   * Gets the computed value, recomputing if dependencies changed.\n   * During untrack calls, getCurrentObserver returns undefined, preventing dependency tracking.\n   */\n  get value(): T {\n    if (this.disposed) {\n      if (!this.hasCachedValue) {\n        this.cachedValue = withoutCurrentObserver(() => this.compute());\n        this.hasCachedValue = true;\n      }\n      return this.cachedValue;\n    }\n\n    const current = getCurrentObserver();\n    if (current) {\n      this.subscribers.add(current);\n      registerDependency(current, this);\n    }\n    if (this.dirty) {\n      this.dirty = false;\n      // Clear old dependencies before recomputing\n      clearDependencies(this.markDirty);\n      this.cachedValue = track(this.markDirty, this.compute);\n      this.hasCachedValue = true;\n    }\n    return this.cachedValue;\n  }\n\n  /**\n   * Reads the current computed value without tracking.\n   * Useful when you need the value but don't want to create a dependency.\n   *\n   * @returns The current cached value (recomputes if dirty)\n   */\n  peek(): T {\n    if (this.disposed) {\n      if (!this.hasCachedValue) {\n        this.cachedValue = withoutCurrentObserver(() => this.compute());\n        this.hasCachedValue = true;\n      }\n      return this.cachedValue;\n    }\n\n    if (this.dirty) {\n      this.dirty = false;\n      // Clear old dependencies before recomputing\n      clearDependencies(this.markDirty);\n      this.cachedValue = track(this.markDirty, this.compute);\n      this.hasCachedValue = true;\n    }\n    return this.cachedValue;\n  }\n\n  /**\n   * Removes an observer from this computed's subscriber set.\n   * @internal\n   */\n  unsubscribe(observer: () => void): void {\n    this.subscribers.delete(observer);\n  }\n\n  /**\n   * Disposes the computed value by unsubscribing its internal observer\n   * from all upstream dependencies and clearing subscribers.\n   */\n  dispose(): void {\n    this.disposed = true;\n    if (this.dirty) {\n      this.hasCachedValue = false;\n    }\n    this.dirty = false;\n    clearDependencies(this.markDirty);\n    this.subscribers.clear();\n  }\n}\n\n/**\n * Creates a new computed value.\n *\n * If created inside an {@link effectScope}, the computed value is automatically\n * collected and will be disposed when the scope stops.\n *\n * @template T - The type of the computed value\n * @param fn - Function that computes the value from reactive sources\n * @returns A new Computed instance\n */\nexport const computed = <T>(fn: () => T): Computed<T> => {\n  const c = new Computed(fn);\n\n  // Auto-register with the current scope so scope.stop() disposes this computed\n  const scope = getActiveScope();\n  if (hasScopeDisposer(scope)) {\n    scope._addDisposer(() => c.dispose());\n  }\n\n  return c;\n};\n","/**\n * Dependency tracking control helpers.\n */\n\nimport { withoutCurrentObserver } from './internals';\n\n/**\n * Executes a function without tracking any signal dependencies.\n * Useful when reading a signal value without creating a reactive dependency.\n *\n * This implementation temporarily hides the current observer rather than\n * disabling tracking globally. This ensures that nested reactive internals\n * (e.g., computed recomputation triggered during untrack) can still properly\n * track their own dependencies.\n *\n * @template T - The return type of the function\n * @param fn - The function to execute without tracking\n * @returns The result of the function\n *\n * @example\n * ```ts\n * const count = signal(0);\n * effect(() => {\n *   // This read creates a dependency\n *   console.log(count.value);\n *   // This read does not create a dependency\n *   const snapshot = untrack(() => count.value);\n * });\n * ```\n */\nexport const untrack = <T>(fn: () => T): T => withoutCurrentObserver(fn);\n"],"mappings":";;AAuBA,IAAa,IAAb,MAAmD;AAAA,EAsBjD,YAAY,GAAmC;AAAlB,SAAA,UAAA,yBApBJ,iBACT,oBACG,uBACG,oBAAI,IAAgB,0BACP;AACjC,UAAI,KAAK,SACP;AAEF,WAAK,QAAQ;AAEb,YAAM,IAAsB,MAAM,KAAK,KAAK,WAAW;AACvD,iBAAW,KAAc,EACvB,CAAA,EAAiB,CAAU;AAAA,IAE/B;AAAA,EAMgD;AAAA,EAMhD,IAAI,QAAW;AACb,QAAI,KAAK;AACP,aAAK,KAAK,mBACR,KAAK,cAAc,EAAA,MAA6B,KAAK,QAAQ,CAAC,GAC9D,KAAK,iBAAiB,KAEjB,KAAK;AAGd,UAAM,IAAU,EAAmB;AACnC,WAAI,MACF,KAAK,YAAY,IAAI,CAAO,GAC5B,EAAmB,GAAS,IAAI,IAE9B,KAAK,UACP,KAAK,QAAQ,IAEb,EAAkB,KAAK,SAAS,GAChC,KAAK,cAAc,EAAM,KAAK,WAAW,KAAK,OAAO,GACrD,KAAK,iBAAiB,KAEjB,KAAK;AAAA,EACd;AAAA,EAQA,OAAU;AACR,WAAI,KAAK,YACF,KAAK,mBACR,KAAK,cAAc,EAAA,MAA6B,KAAK,QAAQ,CAAC,GAC9D,KAAK,iBAAiB,KAEjB,KAAK,gBAGV,KAAK,UACP,KAAK,QAAQ,IAEb,EAAkB,KAAK,SAAS,GAChC,KAAK,cAAc,EAAM,KAAK,WAAW,KAAK,OAAO,GACrD,KAAK,iBAAiB,KAEjB,KAAK;AAAA,EACd;AAAA,EAMA,YAAY,GAA4B;AACtC,SAAK,YAAY,OAAO,CAAQ;AAAA,EAClC;AAAA,EAMA,UAAgB;AACd,SAAK,WAAW,IACZ,KAAK,UACP,KAAK,iBAAiB,KAExB,KAAK,QAAQ,IACb,EAAkB,KAAK,SAAS,GAChC,KAAK,YAAY,MAAM;AAAA,EACzB;AACF,GAYa,IAAA,CAAe,MAA6B;AACvD,QAAM,IAAI,IAAI,EAAS,CAAE,GAGnB,IAAQ,EAAe;AAC7B,SAAI,EAAiB,CAAK,KACxB,EAAM,aAAA,MAAmB,EAAE,QAAQ,CAAC,GAG/B;AACT,GCjHa,IAAA,CAAc,MAAmB,EAAuB,CAAE"}

package/dist/view.es.mjs

@@ -1,14 +1,14 @@
-import { n as o } from "./core-CongXJuo.js";
-import { r as a } from "./readonly-C0ZwS1Tf.js";
-import { t as e } from "./effect-Cc51IH91.js";
-import { r as p } from "./untrack-bjWDNdyE.js";
-import { n as i, r as c, t as n } from "./mount-0A9qtcRJ.js";
+import { n as o } from "./core-yg9rJXiR.js";
+import { t as a } from "./effect-v8OIEmPs.js";
+import { r as e } from "./untrack-uzz3JDNK.js";
+import { r as p } from "./readonly-Br-6pAgj.js";
+import { n as i, r as c, t as n } from "./mount-DwUFujZ_.js";
 export {
-  a as batch,
+  p as batch,
   c as clearExpressionCache,
-  p as computed,
+  e as computed,
   n as createTemplate,
-  e as effect,
+  a as effect,
   i as mount,
   o as signal
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bquery/bquery",
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "bQuery.js — batteries-included TypeScript framework for the modern web: signals, SSR, Web Components, routing, and more, with a jQuery-inspired API.",
   "type": "module",
   "main": "./dist/full.umd.js",
@@ -122,6 +122,7 @@
     "build:umd": "vite build --config vite.umd.config.ts",
     "build:types": "tsc --emitDeclarationOnly --outDir dist",
     "check:ai-guidance": "bun scripts/check-ai-guidance.mjs",
+    "check:full-bundle": "bun scripts/check-full-bundle.mjs",
     "test": "bun test",
     "test:types": "tsc -p tsconfig.component-test.json --noEmit",
     "test:watch": "bun test --watch",
@@ -167,21 +168,21 @@
     "bun": ">=1.3.13"
   },
   "devDependencies": {
-    "@storybook/addon-docs": "^10.3.6",
-    "@storybook/web-components-vite": "^10.3.6",
+    "@storybook/addon-docs": "^10.4.0",
+    "@storybook/web-components-vite": "^10.4.0",
     "@typescript-eslint/eslint-plugin": "^8.59.3",
     "@typescript-eslint/parser": "^8.59.3",
-    "bun-types": "^1.3.13",
-    "eslint": "^10.3.0",
+    "bun-types": "^1.3.14",
+    "eslint": "^10.4.0",
     "eslint-config-prettier": "^10.1.8",
     "globals": "^17.6.0",
     "happy-dom": "^20.9.0",
     "prettier": "^3.8.3",
     "rimraf": "^6.1.3",
-    "storybook": "^10.3.6",
+    "storybook": "^10.4.0",
     "typedoc": "^0.28.19",
     "typescript": "^6.0.3",
-    "vite": "^8.0.12",
+    "vite": "^8.0.13",
     "vitepress": "^1.6.4"
   }
 }

package/src/full.ts

@@ -38,8 +38,53 @@
 // ============================================================================
 // Core Module: Selectors, DOM operations, events, utilities
 // ============================================================================
-export { $, $$, BQueryCollection, BQueryElement, utils } from './core/index';
-export type { BQueryUtils } from './core/index';
+export {
+  $,
+  $$,
+  BQueryCollection,
+  BQueryElement,
+  capitalize,
+  chunk,
+  clamp,
+  clone,
+  compact,
+  debounce,
+  ensureArray,
+  escapeRegExp,
+  flatten,
+  hasOwn,
+  inRange,
+  isArray,
+  isBoolean,
+  isCollection,
+  isDate,
+  isElement,
+  isEmpty,
+  isFunction,
+  isNumber,
+  isObject,
+  isPlainObject,
+  isPromise,
+  isString,
+  merge,
+  noop,
+  omit,
+  once,
+  parseJson,
+  pick,
+  randomInt,
+  sleep,
+  slugify,
+  throttle,
+  toCamelCase,
+  toKebabCase,
+  toNumber,
+  truncate,
+  uid,
+  unique,
+  utils,
+} from './core/index';
+export type { BQueryUtils, DebouncedFn, ThrottledFn } from './core/index';
 
 // ============================================================================
 // Reactive Module: Signals, computed values, effects, batching
@@ -134,6 +179,7 @@ export type {
   WatchOptions,
   WebSocketHeartbeatConfig,
   WebSocketReconnectConfig,
+  WebSocketSendData,
   WebSocketSerializer,
   WebSocketStatus,
 } from './reactive/index';
@@ -322,12 +368,22 @@ export {
 export type {
   AnnounceOptions,
   AnnouncerHandle,
+  BqueryAnnouncerConfig,
+  BqueryComponentLibraryConfig,
   BqueryConfig,
+  BqueryCookieConfig,
+  BqueryFetchConfig,
+  BqueryFetchParseAs,
+  BqueryPageMetaConfig,
+  BqueryTransitionConfig,
   Bucket,
   CacheHandle,
   IndexedDBOptions,
   NotificationOptions,
+  PageLinkTag,
+  PageMetaCleanup,
   PageMetaDefinition,
+  PageMetaTag,
   StorageAdapter,
   UseAnnouncerOptions,
   UseCookieOptions,
@@ -365,6 +421,7 @@ export type {
 // Store Module: Signal-based state management
 // ============================================================================
 export {
+  clearPlugins,
   createPersistedStore,
   createStore,
   defineStore,
@@ -375,6 +432,7 @@ export {
   mapGetters,
   mapState,
   registerPlugin,
+  unregisterPlugin,
   watchStore,
 } from './store/index';
 export type {
@@ -396,7 +454,7 @@ export type {
 // ============================================================================
 // View Module: Declarative DOM bindings without compiler
 // ============================================================================
-export { createTemplate, mount } from './view/index';
+export { clearExpressionCache, createTemplate, mount } from './view/index';
 export type { BindingContext, MountOptions, View } from './view/index';
 
 // ============================================================================
@@ -476,6 +534,7 @@ export type {
   ColorScheme,
   ContrastPreference,
   FocusTrapHandle,
+  MediaPreferenceSignal,
   RovingTabIndexHandle,
   RovingTabIndexOptions,
   SkipLinkHandle,
@@ -521,20 +580,30 @@ export {
   useViewport,
 } from './media/index';
 export type {
+  BatterySignal,
   BatteryState,
   BreakpointMap,
   ClipboardAPI,
+  DeviceMotionSignal,
   DeviceMotionState,
+  DeviceOrientationSignal,
   DeviceOrientationState,
   GeolocationOptions,
+  GeolocationSignal,
   GeolocationState,
   IntersectionObserverOptions,
+  IntersectionObserverSignal,
   IntersectionObserverState,
+  MediaSignalHandle,
   MutationObserverOptions,
+  MutationObserverSignal,
   MutationObserverState,
+  NetworkSignal,
   NetworkState,
   ResizeObserverOptions,
+  ResizeObserverSignal,
   ResizeObserverState,
+  ViewportSignal,
   ViewportState,
 } from './media/index';
 
@@ -630,7 +699,6 @@ export {
   detectRuntime,
   getSSRConfig,
   getSSRRuntimeFeatures,
-  HYDRATION_HASH_ATTR,
   hydrateIsland,
   hydrateMount,
   hydrateOnIdle,
@@ -640,6 +708,7 @@ export {
   hydrateStore,
   hydrateStores,
   hydrateStoreSnapshot,
+  HYDRATION_HASH_ATTR,
   isBrowserRuntime,
   isServerRuntime,
   readStoreSnapshot,
@@ -688,9 +757,9 @@ export type {
   SSRLink,
   SSRLoader,
   SSRMeta,
+  SSRRendererBackend,
   SSRRequestHandler,
   SSRResult,
-  SSRRendererBackend,
   SSRRouteLoader,
   SSRRuntime,
   SSRRuntimeFeatures,
@@ -710,7 +779,6 @@ export type {
   ServerApp,
   ServerContext,
   ServerHandler,
-  ServerResult,
   ServerHtmlResponseInit,
   ServerMiddleware,
   ServerNext,
@@ -718,6 +786,7 @@ export type {
   ServerRenderResponseOptions,
   ServerRequestInit,
   ServerResponseInit,
+  ServerResult,
   ServerRoute,
   ServerWebSocketConnection,
   ServerWebSocketData,

package/src/reactive/index.ts

@@ -5,9 +5,8 @@
  */
 
 export {
-  Computed,
-  Signal,
   batch,
+  Computed,
   computed,
   createHttp,
   createRequestQueue,
@@ -25,8 +24,10 @@ export {
   onScopeDispose,
   persistedSignal,
   readonly,
+  Signal,
   signal,
   toValue,
+  untrack,
   useAsyncData,
   useEventSource,
   useFetch,
@@ -38,7 +39,6 @@ export {
   useSubmit,
   useWebSocket,
   useWebSocketChannel,
-  untrack,
   watch,
   watchDebounce,
   watchThrottle,
@@ -52,6 +52,7 @@ export type {
   ChannelSubscription,
   CleanupFn,
   EffectScope,
+  EventSourceStatus,
   FetchInput,
   HttpClient,
   HttpProgressEvent,
@@ -64,7 +65,6 @@ export type {
   LinkedSignal,
   MaybeSignal,
   Observer,
-  EventSourceStatus,
   PaginatedState,
   PollingState,
   ReadonlySignal,
@@ -95,6 +95,7 @@ export type {
   WatchOptions,
   WebSocketHeartbeatConfig,
   WebSocketReconnectConfig,
+  WebSocketSendData,
   WebSocketSerializer,
   WebSocketStatus,
 } from './signal';

package/src/reactive/signal.ts

@@ -4,8 +4,8 @@
  * @module bquery/reactive
  */
 
-export { batch } from './batch';
 export { createUseFetch, useAsyncData, useFetch } from './async-data';
+export { batch } from './batch';
 export { Computed, computed } from './computed';
 export { Signal, signal } from './core';
 export { effect } from './effect';
@@ -23,13 +23,12 @@ export {
   useSubmit,
 } from './rest';
 export { effectScope, getCurrentScope, onScopeDispose } from './scope';
-export { isComputed, isSignal } from './type-guards';
 export { toValue } from './to-value';
+export { isComputed, isSignal } from './type-guards';
 export { untrack } from './untrack';
 export { watch, watchDebounce, watchThrottle } from './watch';
 export { useEventSource, useWebSocket, useWebSocketChannel } from './websocket';
 
-export type { CleanupFn, Observer } from './internals';
 export type {
   AsyncDataState,
   AsyncDataStatus,
@@ -50,6 +49,8 @@ export type {
   RequestQueueOptions,
   RetryConfig,
 } from './http';
+export type { CleanupFn, Observer } from './internals';
+export type { LinkedSignal } from './linked';
 export type {
   InfiniteState,
   PaginatedState,
@@ -57,7 +58,7 @@ export type {
   UsePaginatedFetchOptions,
 } from './pagination';
 export type { PollingState, UsePollingOptions } from './polling';
-export type { WatchOptions } from './watch';
+export type { ReadonlySignal, ReadonlySignalHandle } from './readonly';
 export type {
   IdExtractor,
   ResourceListActions,
@@ -70,9 +71,8 @@ export type {
   UseSubmitReturn,
 } from './rest';
 export type { EffectScope } from './scope';
-export type { LinkedSignal } from './linked';
 export type { MaybeSignal } from './to-value';
-export type { ReadonlySignal, ReadonlySignalHandle } from './readonly';
+export type { WatchOptions } from './watch';
 export type {
   ChannelMessage,
   ChannelSubscription,
@@ -85,6 +85,7 @@ export type {
   UseWebSocketReturn,
   WebSocketHeartbeatConfig,
   WebSocketReconnectConfig,
+  WebSocketSendData,
   WebSocketSerializer,
   WebSocketStatus,
 } from './websocket';

package/src/reactive/websocket.ts

@@ -8,8 +8,21 @@
 import { computed } from './computed';
 import { Signal, signal } from './core';
 
-/** @internal */
-type WebSocketSendData = string | Blob | ArrayBufferLike | ArrayBufferView;
+/**
+ * Binary/text payloads accepted by reactive WebSocket helpers.
+ *
+ * Mirrors the shape accepted by the native `WebSocket.send()` method and is
+ * used by {@link UseWebSocketReturn.sendRaw}, {@link WebSocketSerializer.serialize}'s
+ * return type, and {@link WebSocketHeartbeatConfig.message}.
+ *
+ * @example
+ * ```ts
+ * import type { WebSocketSendData } from '@bquery/bquery/reactive';
+ *
+ * const frames: WebSocketSendData[] = ['hello', new Blob(['x']), new Uint8Array([1])];
+ * ```
+ */
+export type WebSocketSendData = string | Blob | ArrayBufferLike | ArrayBufferView;
 
 // ---------------------------------------------------------------------------
 // Types

package/src/server/create-server.ts

@@ -525,7 +525,10 @@ const adaptHttpMiddlewareToWebSocket = (middleware: ServerMiddleware): WebSocket
       return middlewareResponse;
     }
 
-    if (middlewareResponse instanceof Response && isWebSocketPassthroughResponse(middlewareResponse)) {
+    if (
+      middlewareResponse instanceof Response &&
+      isWebSocketPassthroughResponse(middlewareResponse)
+    ) {
       return downstream;
     }
 
@@ -650,7 +653,11 @@ export const createServer = (options: CreateServerOptions = {}): ServerApp => {
     },
 
     ws(path, handler, routeMiddlewares) {
-      return addWebSocketRoute(path, handler as ServerWebSocketRouteHandler<unknown>, routeMiddlewares);
+      return addWebSocketRoute(
+        path,
+        handler as ServerWebSocketRouteHandler<unknown>,
+        routeMiddlewares
+      );
     },
 
     async handle(input) {
@@ -739,9 +746,7 @@ export const createServer = (options: CreateServerOptions = {}): ServerApp => {
         ];
         return await runWebSocketPipeline(context, stack, async () => {
           const handlers =
-            typeof route.handler === 'function'
-              ? await route.handler(context)
-              : route.handler;
+            typeof route.handler === 'function' ? await route.handler(context) : route.handler;
           return createWebSocketSession(context, handlers as ServerWebSocketHandlerSet<unknown>);
         });
       } catch (error) {

package/src/server/types.ts

@@ -215,11 +215,7 @@ export interface ServerContext {
    * return ctx.render('<h1 bq-text="title"></h1>', { title: 'Dashboard' });
    * ```
    */
-  render(
-    template: string,
-    data: BindingContext,
-    options?: ServerRenderResponseOptions
-  ): Response;
+  render(template: string, data: BindingContext, options?: ServerRenderResponseOptions): Response;
 
   /**
    * `true` when the incoming request is a WebSocket upgrade handshake.