@bquery/bquery 1.5.0 → 1.7.0

package/dist/testing-CsqjNUyy.js

@@ -0,0 +1,224 @@
+import { n as p } from "./core-DnlyjbF2.js";
+import { u as R } from "./reactive-Cfv0RK6x.js";
+import { t as q } from "./constraints-3lV9yyBw.js";
+var b = (e) => e !== void 0 && (e >= "a" && e <= "z" || e >= "A" && e <= "Z" || e >= "0" && e <= "9" || e === "_"), $ = (e, o) => {
+  let t = 1, i = "", r = o + 1;
+  for (; r < e.length; ) {
+    const n = e[r];
+    if (n === "\\" && r + 1 < e.length) {
+      i += n + e[r + 1], r += 2;
+      continue;
+    }
+    if (n === "(") t++;
+    else if (n === ")" && (t--, t === 0))
+      return {
+        constraint: i,
+        endIndex: r + 1
+      };
+    i += n, r++;
+  }
+  return null;
+}, E = /* @__PURE__ */ new Map(), O = (e) => {
+  const o = q(e), t = E.get(o);
+  if (t) return t;
+  const i = new RegExp(`^(?:${o})$`);
+  return E.set(o, i), i;
+};
+function x(e, o = {}) {
+  if (!e || !e.includes("-")) throw new Error(`bQuery testing: "${e}" is not a valid custom element tag name (must contain a hyphen)`);
+  const { props: t, slots: i, container: r = document.body } = o, n = document.createElement(e);
+  if (t) for (const [s, l] of Object.entries(t))
+    l != null && n.setAttribute(s, String(l));
+  if (i) if (typeof i == "string") n.innerHTML = i;
+  else {
+    const s = [];
+    for (const [l, a] of Object.entries(i)) if (l === "default") s.push(a);
+    else {
+      const c = l.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+      s.push(`<div slot="${c}">${a}</div>`);
+    }
+    n.innerHTML = s.join("");
+  }
+  return r.appendChild(n), {
+    el: n,
+    unmount: () => {
+      n.parentNode && n.parentNode.removeChild(n);
+    }
+  };
+}
+function P() {
+  R(() => {
+  });
+}
+function F(e) {
+  const o = p(e);
+  return Object.defineProperty(o, "initialValue", {
+    value: e,
+    writable: !1,
+    enumerable: !0
+  }), o.set = function(t) {
+    o.value = t;
+  }, o.reset = function() {
+    o.value = e;
+  }, o;
+}
+function M(e, o) {
+  let t = e;
+  o && t.startsWith(o) && (t = t.slice(o.length) || "/");
+  let i = "";
+  const r = t.indexOf("#");
+  r >= 0 && (i = t.slice(r + 1), t = t.slice(0, r));
+  const n = {}, u = t.indexOf("?");
+  if (u >= 0) {
+    const s = t.slice(u + 1);
+    t = t.slice(0, u);
+    for (const l of s.split("&")) {
+      const a = l.indexOf("="), c = a >= 0 ? decodeURIComponent(l.slice(0, a)) : decodeURIComponent(l), f = a >= 0 ? decodeURIComponent(l.slice(a + 1)) : "", d = n[c];
+      d !== void 0 ? Array.isArray(d) ? d.push(f) : n[c] = [d, f] : n[c] = f;
+    }
+  }
+  return {
+    path: t || "/",
+    query: n,
+    hash: i
+  };
+}
+function k(e, o) {
+  for (const t of o) {
+    const i = A(t.path, e);
+    if (i) return {
+      matched: t,
+      params: i
+    };
+  }
+  return {
+    matched: null,
+    params: {}
+  };
+}
+function A(e, o) {
+  if (e === "*") return {};
+  const t = /* @__PURE__ */ new Map(), i = (n, u) => {
+    const s = n.indexOf("/", u);
+    return s === -1 ? n.length : s;
+  }, r = (n, u) => {
+    const s = `${n}:${u}`;
+    if (t.has(s)) return t.get(s) ?? null;
+    if (n === e.length) {
+      const c = u === o.length ? {} : null;
+      return t.set(s, c), c;
+    }
+    const l = e[n];
+    if (l === "*") {
+      for (let c = o.length; c >= u; c--) {
+        const f = r(n + 1, c);
+        if (f)
+          return t.set(s, f), f;
+      }
+      return t.set(s, null), null;
+    }
+    if (l === ":" && b(e[n + 1])) {
+      let c = n + 2;
+      for (; c < e.length && b(e[c]); ) c++;
+      const f = e.slice(n + 1, c);
+      let d = c, h, g = !1;
+      if (e[c] === "(") {
+        const m = $(e, c);
+        m && (h = m.constraint, d = m.endIndex);
+      }
+      e[d] === "*" && (g = !0, d++);
+      const C = g || h ? o.length : i(o, u);
+      for (let m = C; m > u; m--) {
+        const v = o.slice(u, m);
+        if (h && !O(h).test(v))
+          continue;
+        const w = r(d, m);
+        if (w) {
+          const y = {
+            [f]: v,
+            ...w
+          };
+          return t.set(s, y), y;
+        }
+      }
+      return t.set(s, null), null;
+    }
+    if (u >= o.length || l !== o[u])
+      return t.set(s, null), null;
+    const a = r(n + 1, u + 1);
+    return t.set(s, a), a;
+  };
+  return r(0, 0);
+}
+function z(e = {}) {
+  const o = e.routes ?? [{
+    path: "*",
+    component: () => null
+  }], t = e.base ?? "", i = e.initialPath ?? "/", r = (u) => {
+    const { path: s, query: l, hash: a } = M(u, t), { matched: c, params: f } = k(s, o);
+    return {
+      path: s,
+      params: f,
+      query: l,
+      matched: c,
+      hash: a
+    };
+  }, n = p(r(i));
+  return {
+    push(u) {
+      n.value = r(u);
+    },
+    replace(u) {
+      n.value = r(u);
+    },
+    get currentRoute() {
+      return n;
+    },
+    get routes() {
+      return o;
+    },
+    destroy() {
+      n.dispose();
+    }
+  };
+}
+function L(e, o, t = {}) {
+  if (!e) throw new Error("bQuery testing: fireEvent requires a valid element");
+  if (!o) throw new Error("bQuery testing: fireEvent requires an event name");
+  const { bubbles: i = !0, cancelable: r = !0, composed: n = !0, detail: u } = t;
+  let s;
+  u !== void 0 ? s = new CustomEvent(o, {
+    bubbles: i,
+    cancelable: r,
+    composed: n,
+    detail: u
+  }) : s = new Event(o, {
+    bubbles: i,
+    cancelable: r,
+    composed: n
+  });
+  const l = e.dispatchEvent(s);
+  return P(), l;
+}
+async function T(e, o = {}) {
+  if (typeof e != "function") throw new Error("bQuery testing: waitFor requires a predicate function");
+  const { timeout: t = 1e3, interval: i = 10 } = o, r = Date.now();
+  for (; ; ) {
+    try {
+      if (await e()) return;
+    } catch {
+    }
+    if (Date.now() - r >= t) throw new Error(`bQuery testing: waitFor timed out after ${t}ms — predicate never returned true`);
+    await new Promise((n) => setTimeout(n, i));
+  }
+}
+export {
+  x as a,
+  F as i,
+  P as n,
+  T as o,
+  z as r,
+  L as t
+};
+
+//# sourceMappingURL=testing-CsqjNUyy.js.map

package/dist/testing-CsqjNUyy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing-CsqjNUyy.js","names":[],"sources":["../src/testing/testing.ts"],"sourcesContent":["/**\r\n * Testing utilities for bQuery.js.\r\n *\r\n * Provides helpers for mounting components, controlling signals, mocking\r\n * the router, dispatching events, and asserting async conditions — all\r\n * designed for use with `bun:test` and happy-dom.\r\n *\r\n * @module bquery/testing\r\n */\r\n\r\nimport { batch, Signal, signal } from '../reactive/index';\r\nimport { getNormalizedRouteConstraint } from '../router/constraints';\r\nimport type {\r\n  FireEventOptions,\r\n  MockRouteDefinition,\r\n  MockRouter,\r\n  MockRouterOptions,\r\n  MockSignal,\r\n  RenderComponentOptions,\r\n  RenderResult,\r\n  TestRoute,\r\n  WaitForOptions,\r\n} from './types';\r\n\r\n// ============================================================================\r\n// renderComponent\r\n// ============================================================================\r\n\r\nconst isWordChar = (char: string | undefined): boolean =>\r\n  char !== undefined &&\r\n  ((char >= 'a' && char <= 'z') ||\r\n    (char >= 'A' && char <= 'Z') ||\r\n    (char >= '0' && char <= '9') ||\r\n    char === '_');\r\n\r\nconst readRouteConstraint = (\r\n  pattern: string,\r\n  startIndex: number\r\n): { constraint: string; endIndex: number } | null => {\r\n  let depth = 1;\r\n  let constraint = '';\r\n  let i = startIndex + 1;\r\n\r\n  while (i < pattern.length) {\r\n    const char = pattern[i];\r\n\r\n    if (char === '\\\\' && i + 1 < pattern.length) {\r\n      constraint += char + pattern[i + 1];\r\n      i += 2;\r\n      continue;\r\n    }\r\n\r\n    if (char === '(') {\r\n      depth++;\r\n    } else if (char === ')') {\r\n      depth--;\r\n      if (depth === 0) {\r\n        return { constraint, endIndex: i + 1 };\r\n      }\r\n    }\r\n\r\n    constraint += char;\r\n    i++;\r\n  }\r\n\r\n  return null;\r\n};\r\n\r\nconst routeConstraintRegexCache = new Map<string, RegExp>();\r\n\r\nconst getRouteConstraintRegex = (constraint: string): RegExp => {\r\n  const normalized = getNormalizedRouteConstraint(constraint);\r\n  const cached = routeConstraintRegexCache.get(normalized);\r\n  if (cached) {\r\n    return cached;\r\n  }\r\n\r\n  const compiled = new RegExp(`^(?:${normalized})$`);\r\n  routeConstraintRegexCache.set(normalized, compiled);\r\n  return compiled;\r\n};\r\n\r\n/**\r\n * Mounts a custom element by tag name for testing and returns a handle\r\n * to interact with it.\r\n *\r\n * The element is created, configured with the given props and slots,\r\n * and appended to the container (defaults to `document.body`). Call\r\n * `unmount()` to remove the element and trigger its `disconnectedCallback`.\r\n *\r\n * @param tagName - The custom element tag name (must already be registered)\r\n * @param options - Props, slots, and container configuration\r\n * @returns A {@link RenderResult} with the element and an unmount function\r\n * @throws {Error} If the tag name is not a valid custom element name\r\n *\r\n * @example\r\n * ```ts\r\n * import { renderComponent } from '@bquery/bquery/testing';\r\n *\r\n * const { el, unmount } = renderComponent('my-counter', {\r\n *   props: { start: '5' },\r\n * });\r\n * expect(el.shadowRoot?.textContent).toContain('5');\r\n * unmount();\r\n * ```\r\n */\r\nexport function renderComponent(\r\n  tagName: string,\r\n  options: RenderComponentOptions = {}\r\n): RenderResult {\r\n  if (!tagName || !tagName.includes('-')) {\r\n    throw new Error(\r\n      `bQuery testing: \"${tagName}\" is not a valid custom element tag name (must contain a hyphen)`\r\n    );\r\n  }\r\n\r\n  const { props, slots, container = document.body } = options;\r\n\r\n  const el = document.createElement(tagName);\r\n\r\n  // Set attributes (props) before connecting\r\n  if (props) {\r\n    for (const [key, value] of Object.entries(props)) {\r\n      if (value === null || value === undefined) continue;\r\n      el.setAttribute(key, String(value));\r\n    }\r\n  }\r\n\r\n  // Inject slot content before connecting so the component can discover it\r\n  if (slots) {\r\n    if (typeof slots === 'string') {\r\n      el.innerHTML = slots;\r\n    } else {\r\n      const parts: string[] = [];\r\n      for (const [slotName, html] of Object.entries(slots)) {\r\n        if (slotName === 'default') {\r\n          parts.push(html);\r\n        } else {\r\n          const safeSlotName = slotName\r\n            .replace(/&/g, '&amp;')\r\n            .replace(/\"/g, '&quot;')\r\n            .replace(/</g, '&lt;')\r\n            .replace(/>/g, '&gt;');\r\n          parts.push(`<div slot=\"${safeSlotName}\">${html}</div>`);\r\n        }\r\n      }\r\n      el.innerHTML = parts.join('');\r\n    }\r\n  }\r\n\r\n  // Connect — triggers connectedCallback\r\n  container.appendChild(el);\r\n\r\n  const unmount = (): void => {\r\n    if (el.parentNode) {\r\n      el.parentNode.removeChild(el);\r\n    }\r\n  };\r\n\r\n  return { el, unmount };\r\n}\r\n\r\n// ============================================================================\r\n// flushEffects\r\n// ============================================================================\r\n\r\n/**\r\n * Synchronously flushes any pending reactive effects.\r\n *\r\n * In bQuery's reactive system, effects outside of a batch are executed\r\n * synchronously. This helper exists primarily for clarity and for\r\n * flushing effects that may have been deferred inside a batch.\r\n *\r\n * Internally it performs a no-op batch to trigger the flush of any\r\n * pending observers that were queued during a prior `batch()` call.\r\n *\r\n * @example\r\n * ```ts\r\n * import { signal, batch } from '@bquery/bquery/reactive';\r\n * import { flushEffects } from '@bquery/bquery/testing';\r\n *\r\n * const count = signal(0);\r\n * let observed = 0;\r\n * effect(() => { observed = count.value; });\r\n *\r\n * batch(() => { count.value = 42; });\r\n * flushEffects();\r\n * expect(observed).toBe(42);\r\n * ```\r\n */\r\nexport function flushEffects(): void {\r\n  // A no-op batch triggers endBatch which flushes any pending observers.\r\n  // Since bQuery's effects are synchronous outside of batches, this is\r\n  // mainly useful after manual batch calls or micro-task boundaries.\r\n  batch(() => {\r\n    /* intentionally empty — triggers pending observer flush */\r\n  });\r\n}\r\n\r\n// ============================================================================\r\n// mockSignal\r\n// ============================================================================\r\n\r\n/**\r\n * Creates a controllable signal for tests with `set()` and `reset()` helpers.\r\n *\r\n * This is a thin wrapper around `signal()` that records the initial value\r\n * and adds explicit `set()` / `reset()` methods for clearer test intent.\r\n *\r\n * @template T - The type of the signal value\r\n * @param initialValue - The initial value\r\n * @returns A {@link MockSignal} instance\r\n *\r\n * @example\r\n * ```ts\r\n * import { mockSignal } from '@bquery/bquery/testing';\r\n *\r\n * const count = mockSignal(0);\r\n * count.set(5);\r\n * expect(count.value).toBe(5);\r\n * count.reset();\r\n * expect(count.value).toBe(0);\r\n * ```\r\n */\r\nexport function mockSignal<T>(initialValue: T): MockSignal<T> {\r\n  const s = signal(initialValue) as Signal<T> & {\r\n    set: (value: T) => void;\r\n    reset: () => void;\r\n    initialValue: T;\r\n  };\r\n\r\n  Object.defineProperty(s, 'initialValue', {\r\n    value: initialValue,\r\n    writable: false,\r\n    enumerable: true,\r\n  });\r\n\r\n  s.set = function (value: T): void {\r\n    s.value = value;\r\n  };\r\n\r\n  s.reset = function (): void {\r\n    s.value = initialValue;\r\n  };\r\n\r\n  return s as MockSignal<T>;\r\n}\r\n\r\n// ============================================================================\r\n// mockRouter\r\n// ============================================================================\r\n\r\n/**\r\n * Parses a path string into the route's `path`, `query`, and `hash` parts.\r\n * @internal\r\n */\r\nfunction parsePath(\r\n  fullPath: string,\r\n  base: string\r\n): { path: string; query: Record<string, string | string[]>; hash: string } {\r\n  let working = fullPath;\r\n\r\n  // Strip base prefix\r\n  if (base && working.startsWith(base)) {\r\n    working = working.slice(base.length) || '/';\r\n  }\r\n\r\n  // Extract hash\r\n  let hash = '';\r\n  const hashIdx = working.indexOf('#');\r\n  if (hashIdx >= 0) {\r\n    hash = working.slice(hashIdx + 1);\r\n    working = working.slice(0, hashIdx);\r\n  }\r\n\r\n  // Extract query string\r\n  const query: Record<string, string | string[]> = {};\r\n  const qIdx = working.indexOf('?');\r\n  if (qIdx >= 0) {\r\n    const qs = working.slice(qIdx + 1);\r\n    working = working.slice(0, qIdx);\r\n    for (const pair of qs.split('&')) {\r\n      const eqIdx = pair.indexOf('=');\r\n      const key = eqIdx >= 0 ? decodeURIComponent(pair.slice(0, eqIdx)) : decodeURIComponent(pair);\r\n      const val = eqIdx >= 0 ? decodeURIComponent(pair.slice(eqIdx + 1)) : '';\r\n      const existing = query[key];\r\n      if (existing !== undefined) {\r\n        if (Array.isArray(existing)) {\r\n          existing.push(val);\r\n        } else {\r\n          query[key] = [existing, val];\r\n        }\r\n      } else {\r\n        query[key] = val;\r\n      }\r\n    }\r\n  }\r\n\r\n  return { path: working || '/', query, hash };\r\n}\r\n\r\n/**\r\n * Matches a path against a route definition, extracting params.\r\n * @internal\r\n */\r\nfunction matchRoute(\r\n  path: string,\r\n  routes: MockRouteDefinition[]\r\n): { matched: MockRouteDefinition | null; params: Record<string, string> } {\r\n  for (const route of routes) {\r\n    const params = matchRoutePattern(route.path, path);\r\n    if (params) {\r\n      return { matched: route, params };\r\n    }\r\n  }\r\n  return { matched: null, params: {} };\r\n}\r\n\r\n/**\r\n * Builds param matches from a route path pattern without compiling the full path into a regex.\r\n * @internal\r\n */\r\nfunction matchRoutePattern(pattern: string, path: string): Record<string, string> | null {\r\n  if (pattern === '*') {\r\n    return {};\r\n  }\r\n\r\n  // Memoization keeps wildcard/param backtracking linear for repeated subproblems\r\n  // within a single pattern/path match attempt.\r\n  const memo = new Map<string, Record<string, string> | null>();\r\n\r\n  const findSegmentBoundary = (value: string, startIndex: number): number => {\r\n    const slashIndex = value.indexOf('/', startIndex);\r\n    return slashIndex === -1 ? value.length : slashIndex;\r\n  };\r\n\r\n  const matchFrom = (patternIndex: number, pathIndex: number): Record<string, string> | null => {\r\n    const memoKey = `${patternIndex}:${pathIndex}`;\r\n    if (memo.has(memoKey)) {\r\n      return memo.get(memoKey) ?? null;\r\n    }\r\n\r\n    if (patternIndex === pattern.length) {\r\n      const result = pathIndex === path.length ? {} : null;\r\n      memo.set(memoKey, result);\r\n      return result;\r\n    }\r\n\r\n    const patternChar = pattern[patternIndex];\r\n\r\n    if (patternChar === '*') {\r\n      for (let candidateEnd = path.length; candidateEnd >= pathIndex; candidateEnd--) {\r\n        const suffixMatch = matchFrom(patternIndex + 1, candidateEnd);\r\n        if (suffixMatch) {\r\n          memo.set(memoKey, suffixMatch);\r\n          return suffixMatch;\r\n        }\r\n      }\r\n\r\n      memo.set(memoKey, null);\r\n      return null;\r\n    }\r\n\r\n    if (patternChar === ':' && isWordChar(pattern[patternIndex + 1])) {\r\n      let nameEnd = patternIndex + 2;\r\n      while (nameEnd < pattern.length && isWordChar(pattern[nameEnd])) {\r\n        nameEnd++;\r\n      }\r\n\r\n      const name = pattern.slice(patternIndex + 1, nameEnd);\r\n      let nextPatternIndex = nameEnd;\r\n      let constraint: string | undefined;\r\n      let catchAll = false;\r\n\r\n      if (pattern[nameEnd] === '(') {\r\n        const parsedConstraint = readRouteConstraint(pattern, nameEnd);\r\n        if (parsedConstraint) {\r\n          constraint = parsedConstraint.constraint;\r\n          nextPatternIndex = parsedConstraint.endIndex;\r\n        }\r\n      }\r\n\r\n      if (pattern[nextPatternIndex] === '*') {\r\n        catchAll = true;\r\n        nextPatternIndex++;\r\n      }\r\n\r\n      const candidateLimit = catchAll\r\n        ? path.length\r\n        : constraint\r\n          ? path.length\r\n          : findSegmentBoundary(path, pathIndex);\r\n\r\n      for (let candidateEnd = candidateLimit; candidateEnd > pathIndex; candidateEnd--) {\r\n        const candidateValue = path.slice(pathIndex, candidateEnd);\r\n        if (constraint) {\r\n          const constraintRegex = getRouteConstraintRegex(constraint);\r\n          if (!constraintRegex.test(candidateValue)) {\r\n            continue;\r\n          }\r\n        }\r\n\r\n        const suffixMatch = matchFrom(nextPatternIndex, candidateEnd);\r\n        if (suffixMatch) {\r\n          const result = {\r\n            [name]: candidateValue,\r\n            ...suffixMatch,\r\n          };\r\n          memo.set(memoKey, result);\r\n          return result;\r\n        }\r\n      }\r\n\r\n      memo.set(memoKey, null);\r\n      return null;\r\n    }\r\n\r\n    if (pathIndex >= path.length || patternChar !== path[pathIndex]) {\r\n      memo.set(memoKey, null);\r\n      return null;\r\n    }\r\n\r\n    const result = matchFrom(patternIndex + 1, pathIndex + 1);\r\n    memo.set(memoKey, result);\r\n    return result;\r\n  };\r\n\r\n  return matchFrom(0, 0);\r\n}\r\n\r\n/**\r\n * Creates a lightweight mock router for testing that does not interact\r\n * with the browser History API.\r\n *\r\n * The mock router provides a reactive `currentRoute` signal that updates\r\n * when `push()` or `replace()` is called, making it ideal for testing\r\n * components or logic that depend on route state.\r\n *\r\n * @param options - Mock router configuration\r\n * @returns A {@link MockRouter} instance\r\n *\r\n * @example\r\n * ```ts\r\n * import { mockRouter } from '@bquery/bquery/testing';\r\n *\r\n * const router = mockRouter({\r\n *   routes: [\r\n *     { path: '/', component: () => null },\r\n *     { path: '/user/:id', component: () => null },\r\n *   ],\r\n *   initialPath: '/',\r\n * });\r\n *\r\n * router.push('/user/42');\r\n * expect(router.currentRoute.value.params.id).toBe('42');\r\n * router.destroy();\r\n * ```\r\n */\r\nexport function mockRouter(options: MockRouterOptions = {}): MockRouter {\r\n  const routes = options.routes ?? [{ path: '*', component: () => null }];\r\n  const base = options.base ?? '';\r\n  const initialPath = options.initialPath ?? '/';\r\n\r\n  const resolveRoute = (fullPath: string): TestRoute => {\r\n    const { path, query, hash } = parsePath(fullPath, base);\r\n    const { matched, params } = matchRoute(path, routes);\r\n    return { path, params, query, matched, hash };\r\n  };\r\n\r\n  const routeSignal = signal<TestRoute>(resolveRoute(initialPath));\r\n\r\n  return {\r\n    push(path: string): void {\r\n      routeSignal.value = resolveRoute(path);\r\n    },\r\n    replace(path: string): void {\r\n      routeSignal.value = resolveRoute(path);\r\n    },\r\n    get currentRoute(): Signal<TestRoute> {\r\n      return routeSignal;\r\n    },\r\n    get routes(): MockRouteDefinition[] {\r\n      return routes;\r\n    },\r\n    destroy(): void {\r\n      routeSignal.dispose();\r\n    },\r\n  };\r\n}\r\n\r\n// ============================================================================\r\n// fireEvent\r\n// ============================================================================\r\n\r\n/**\r\n * Dispatches a synthetic event on an element and flushes pending effects.\r\n *\r\n * By default the event bubbles, is cancelable, and is composed (crosses\r\n * shadow DOM boundaries). Pass a `detail` option to create a `CustomEvent`.\r\n *\r\n * @param el - The target element\r\n * @param eventName - The event type (e.g. 'click', 'input', 'my-event')\r\n * @param options - Event configuration\r\n * @returns `true` if the event was not cancelled\r\n *\r\n * @example\r\n * ```ts\r\n * import { fireEvent } from '@bquery/bquery/testing';\r\n *\r\n * const button = document.createElement('button');\r\n * let clicked = false;\r\n * button.addEventListener('click', () => { clicked = true; });\r\n * fireEvent(button, 'click');\r\n * expect(clicked).toBe(true);\r\n * ```\r\n */\r\nexport function fireEvent(el: Element, eventName: string, options: FireEventOptions = {}): boolean {\r\n  if (!el) {\r\n    throw new Error('bQuery testing: fireEvent requires a valid element');\r\n  }\r\n  if (!eventName) {\r\n    throw new Error('bQuery testing: fireEvent requires an event name');\r\n  }\r\n\r\n  const { bubbles = true, cancelable = true, composed = true, detail } = options;\r\n\r\n  let event: Event;\r\n  if (detail !== undefined) {\r\n    event = new CustomEvent(eventName, { bubbles, cancelable, composed, detail });\r\n  } else {\r\n    event = new Event(eventName, { bubbles, cancelable, composed });\r\n  }\r\n\r\n  const result = el.dispatchEvent(event);\r\n\r\n  // Flush any effects triggered by event handlers\r\n  flushEffects();\r\n\r\n  return result;\r\n}\r\n\r\n// ============================================================================\r\n// waitFor\r\n// ============================================================================\r\n\r\n/**\r\n * Waits for a predicate to return `true`, polling at a configurable interval.\r\n *\r\n * Useful for asserting conditions that depend on asynchronous operations,\r\n * timers, or deferred reactive updates.\r\n *\r\n * @param predicate - A function that returns `true` when the condition is met\r\n * @param options - Timeout and interval configuration\r\n * @returns A promise that resolves when the predicate returns `true`\r\n * @throws {Error} If the predicate does not return `true` within the timeout\r\n *\r\n * @example\r\n * ```ts\r\n * import { waitFor } from '@bquery/bquery/testing';\r\n *\r\n * await waitFor(() => document.querySelector('.loaded') !== null, {\r\n *   timeout: 2000,\r\n * });\r\n * ```\r\n */\r\nexport async function waitFor(\r\n  predicate: () => boolean | Promise<boolean>,\r\n  options: WaitForOptions = {}\r\n): Promise<void> {\r\n  if (typeof predicate !== 'function') {\r\n    throw new Error('bQuery testing: waitFor requires a predicate function');\r\n  }\r\n\r\n  const { timeout = 1000, interval = 10 } = options;\r\n  const start = Date.now();\r\n\r\n  while (true) {\r\n    try {\r\n      const result = await predicate();\r\n      if (result) return;\r\n    } catch {\r\n      // Predicate threw — treat as not-yet-met and keep polling\r\n    }\r\n\r\n    if (Date.now() - start >= timeout) {\r\n      throw new Error(\r\n        `bQuery testing: waitFor timed out after ${timeout}ms — predicate never returned true`\r\n      );\r\n    }\r\n\r\n    await new Promise((resolve) => setTimeout(resolve, interval));\r\n  }\r\n}\r\n"],"mappings":"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"}

package/dist/testing.es.mjs

@@ -0,0 +1,9 @@
+import { a, i as r, n as e, o as s, r as t, t as n } from "./testing-CsqjNUyy.js";
+export {
+  n as fireEvent,
+  e as flushEffects,
+  t as mockRouter,
+  r as mockSignal,
+  a as renderComponent,
+  s as waitFor
+};

package/dist/type-guards-Do9DWgNp.js

@@ -0,0 +1,44 @@
+function t(n) {
+  return typeof Element < "u" && n instanceof Element;
+}
+function e(n) {
+  return !!(n && typeof n == "object" && "elements" in n);
+}
+function o(n) {
+  return typeof n == "function";
+}
+function i(n) {
+  return typeof n == "string";
+}
+function r(n) {
+  return typeof n == "number" && !Number.isNaN(n);
+}
+function s(n) {
+  return typeof n == "boolean";
+}
+function f(n) {
+  return Array.isArray(n);
+}
+function c(n) {
+  return n instanceof Date;
+}
+function u(n) {
+  return !!(n && (n instanceof Promise || typeof n == "object" && "then" in n && typeof n.then == "function"));
+}
+function a(n) {
+  return typeof n == "object" && n !== null;
+}
+export {
+  t as a,
+  a as c,
+  c as i,
+  u as l,
+  s as n,
+  o,
+  e as r,
+  r as s,
+  f as t,
+  i as u
+};
+
+//# sourceMappingURL=type-guards-Do9DWgNp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards-Do9DWgNp.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"}

package/dist/untrack-DJVQQ2WM.js

@@ -0,0 +1,33 @@
+import { a as e, c as h, d as t, l as c, s as u, u as i } from "./core-DnlyjbF2.js";
+var d = class {
+  constructor(s) {
+    this.compute = s, this.hasCachedValue = !1, this.dirty = !0, this.disposed = !1, this.subscribers = /* @__PURE__ */ new Set(), this.markDirty = () => {
+      if (this.disposed) return;
+      this.dirty = !0;
+      const r = Array.from(this.subscribers);
+      for (const a of r) c(a);
+    };
+  }
+  get value() {
+    if (this.disposed)
+      return this.hasCachedValue || (this.cachedValue = t(() => this.compute()), this.hasCachedValue = !0), this.cachedValue;
+    const s = u();
+    return s && (this.subscribers.add(s), h(s, this)), this.dirty && (this.dirty = !1, e(this.markDirty), this.cachedValue = i(this.markDirty, this.compute), this.hasCachedValue = !0), this.cachedValue;
+  }
+  peek() {
+    return this.disposed ? (this.hasCachedValue || (this.cachedValue = t(() => this.compute()), this.hasCachedValue = !0), this.cachedValue) : (this.dirty && (this.dirty = !1, e(this.markDirty), this.cachedValue = i(this.markDirty, this.compute), this.hasCachedValue = !0), this.cachedValue);
+  }
+  unsubscribe(s) {
+    this.subscribers.delete(s);
+  }
+  dispose() {
+    this.disposed = !0, this.dirty && (this.hasCachedValue = !1), this.dirty = !1, e(this.markDirty), this.subscribers.clear();
+  }
+}, o = (s) => new d(s), n = (s) => t(s);
+export {
+  d as n,
+  o as r,
+  n as t
+};
+
+//# sourceMappingURL=untrack-DJVQQ2WM.js.map

package/dist/untrack-DJVQQ2WM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"untrack-DJVQQ2WM.js","names":[],"sources":["../src/reactive/computed.ts","../src/reactive/untrack.ts"],"sourcesContent":["/**\r\n * Computed reactive values.\r\n */\r\n\r\nimport {\r\n  clearDependencies,\r\n  getCurrentObserver,\r\n  registerDependency,\r\n  scheduleObserver,\r\n  track,\r\n  withoutCurrentObserver,\r\n  type ReactiveSource,\r\n} from './internals';\r\n\r\n/**\r\n * A computed value that derives from other reactive sources.\r\n *\r\n * Computed values are lazily evaluated and cached. They only\r\n * recompute when their dependencies change.\r\n *\r\n * @template T - The type of the computed value\r\n */\r\nexport class Computed<T> implements ReactiveSource {\r\n  private cachedValue!: T;\r\n  private hasCachedValue = false;\r\n  private dirty = true;\r\n  private disposed = false;\r\n  private subscribers = new Set<() => void>();\r\n  private readonly markDirty = () => {\r\n    if (this.disposed) {\r\n      return;\r\n    }\r\n    this.dirty = true;\r\n    // Create snapshot to avoid issues with subscribers modifying the set during iteration\r\n    const subscribersSnapshot = Array.from(this.subscribers);\r\n    for (const subscriber of subscribersSnapshot) {\r\n      scheduleObserver(subscriber);\r\n    }\r\n  };\r\n\r\n  /**\r\n   * Creates a new computed value.\r\n   * @param compute - Function that computes the value\r\n   */\r\n  constructor(private readonly compute: () => T) {}\r\n\r\n  /**\r\n   * Gets the computed value, recomputing if dependencies changed.\r\n   * During untrack calls, getCurrentObserver returns undefined, preventing dependency tracking.\r\n   */\r\n  get value(): T {\r\n    if (this.disposed) {\r\n      if (!this.hasCachedValue) {\r\n        this.cachedValue = withoutCurrentObserver(() => this.compute());\r\n        this.hasCachedValue = true;\r\n      }\r\n      return this.cachedValue;\r\n    }\r\n\r\n    const current = getCurrentObserver();\r\n    if (current) {\r\n      this.subscribers.add(current);\r\n      registerDependency(current, this);\r\n    }\r\n    if (this.dirty) {\r\n      this.dirty = false;\r\n      // Clear old dependencies before recomputing\r\n      clearDependencies(this.markDirty);\r\n      this.cachedValue = track(this.markDirty, this.compute);\r\n      this.hasCachedValue = true;\r\n    }\r\n    return this.cachedValue;\r\n  }\r\n\r\n  /**\r\n   * Reads the current computed value without tracking.\r\n   * Useful when you need the value but don't want to create a dependency.\r\n   *\r\n   * @returns The current cached value (recomputes if dirty)\r\n   */\r\n  peek(): T {\r\n    if (this.disposed) {\r\n      if (!this.hasCachedValue) {\r\n        this.cachedValue = withoutCurrentObserver(() => this.compute());\r\n        this.hasCachedValue = true;\r\n      }\r\n      return this.cachedValue;\r\n    }\r\n\r\n    if (this.dirty) {\r\n      this.dirty = false;\r\n      // Clear old dependencies before recomputing\r\n      clearDependencies(this.markDirty);\r\n      this.cachedValue = track(this.markDirty, this.compute);\r\n      this.hasCachedValue = true;\r\n    }\r\n    return this.cachedValue;\r\n  }\r\n\r\n  /**\r\n   * Removes an observer from this computed's subscriber set.\r\n   * @internal\r\n   */\r\n  unsubscribe(observer: () => void): void {\r\n    this.subscribers.delete(observer);\r\n  }\r\n\r\n  /**\r\n   * Disposes the computed value by unsubscribing its internal observer\r\n   * from all upstream dependencies and clearing subscribers.\r\n   */\r\n  dispose(): void {\r\n    this.disposed = true;\r\n    if (this.dirty) {\r\n      this.hasCachedValue = false;\r\n    }\r\n    this.dirty = false;\r\n    clearDependencies(this.markDirty);\r\n    this.subscribers.clear();\r\n  }\r\n}\r\n\r\n/**\r\n * Creates a new computed value.\r\n *\r\n * @template T - The type of the computed value\r\n * @param fn - Function that computes the value from reactive sources\r\n * @returns A new Computed instance\r\n */\r\nexport const computed = <T>(fn: () => T): Computed<T> => new Computed(fn);\r\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":";AAsBA,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;GAWR,IAAA,CAAe,MAA6B,IAAI,EAAS,CAAA,GCnGzD,IAAA,CAAc,MAAmB,EAAuB,CAAA"}

package/dist/view/custom-directives.d.ts

@@ -0,0 +1,20 @@
+import type { DirectiveHandler } from './types';
+/**
+ * Function signature used to resolve custom directives without coupling the
+ * view pipeline directly to the plugin module.
+ * @internal
+ */
+export type CustomDirectiveResolver = (name: string) => DirectiveHandler | undefined;
+/**
+ * Registers the resolver used by the view pipeline for custom directives.
+ *
+ * Pass `null` to unregister the current resolver and reset to the default behavior.
+ * @internal
+ */
+export declare const registerCustomDirectiveResolver: (resolver: CustomDirectiveResolver | null) => void;
+/**
+ * Returns a custom directive handler when one is registered.
+ * @internal
+ */
+export declare const getCustomDirective: (name: string) => DirectiveHandler | undefined;
+//# sourceMappingURL=custom-directives.d.ts.map

package/dist/view/custom-directives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-directives.d.ts","sourceRoot":"","sources":["../../src/view/custom-directives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;AAIrF;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,GAC1C,UAAU,uBAAuB,GAAG,IAAI,KACvC,IAEF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,gBAAgB,GAAG,SAEpE,CAAC"}

package/dist/view/evaluate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/view/evaluate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA4D9C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,QAAO,IAGvC,CAAC;AA8BF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,GAAG,OAAO,EAAE,YAAY,MAAM,EAAE,SAAS,cAAc,KAAG,CAoBnF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,GAAG,OAAO,EAAE,YAAY,MAAM,EAAE,SAAS,cAAc,KAAG,CAiBtF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,YAAY,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAqH/E,CAAC"}
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/view/evaluate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA4D9C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,QAAO,IAGvC,CAAC;AA8BF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,GAAG,OAAO,EAAE,YAAY,MAAM,EAAE,SAAS,cAAc,KAAG,CAoBnF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,GAAG,OAAO,EAAE,YAAY,MAAM,EAAE,SAAS,cAAc,KAAG,CAiBtF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,YAAY,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAsH/E,CAAC"}

package/dist/view/process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/view/process.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,gBAAgB,CAAC;IACvB,EAAE,EAAE,gBAAgB,CAAC;IACrB,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,GAAG,EAAE,gBAAgB,CAAC;IACtB,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,gBAAgB,CAAC;IAC7C,EAAE,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,gBAAgB,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,IAAI,OAAO,EACX,SAAS,cAAc,EACvB,QAAQ,MAAM,EACd,UAAU,SAAS,EAAE,EACrB,UAAU,iBAAiB,KAC1B,IAyCF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,IAAI,OAAO,EACX,SAAS,cAAc,EACvB,QAAQ,MAAM,EACd,UAAU,SAAS,EAAE,EACrB,UAAU,iBAAiB,KAC1B,IAWF,CAAC"}
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/view/process.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,gBAAgB,CAAC;IACvB,EAAE,EAAE,gBAAgB,CAAC;IACrB,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,GAAG,EAAE,gBAAgB,CAAC;IACtB,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,gBAAgB,CAAC;IAC7C,EAAE,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,gBAAgB,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,IAAI,OAAO,EACX,SAAS,cAAc,EACvB,QAAQ,MAAM,EACd,UAAU,SAAS,EAAE,EACrB,UAAU,iBAAiB,KAC1B,IAuDF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,IAAI,OAAO,EACX,SAAS,cAAc,EACvB,QAAQ,MAAM,EACd,UAAU,SAAS,EAAE,EACrB,UAAU,iBAAiB,KAC1B,IAWF,CAAC"}

package/dist/view.es.mjs

@@ -1,12 +1,13 @@
-import { n as r, r as e } from "./core-DPdbItcq.js";
-import { f as o, p as s } from "./reactive-BDya-ia8.js";
-import { n as p, r as c, t as f } from "./view-Cdi0g-qo.js";
+import { n as a, r as o } from "./core-DnlyjbF2.js";
+import { u as e } from "./reactive-Cfv0RK6x.js";
+import { r as s } from "./untrack-DJVQQ2WM.js";
+import { n as c, r as f, t as i } from "./mount-SM07RUa6.js";
 export {
-  s as batch,
-  c as clearExpressionCache,
-  o as computed,
-  f as createTemplate,
-  e as effect,
-  p as mount,
-  r as signal
+  e as batch,
+  f as clearExpressionCache,
+  s as computed,
+  i as createTemplate,
+  o as effect,
+  c as mount,
+  a as signal
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bquery/bquery",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "The jQuery for the Modern Web Platform - Zero build, TypeScript-first library with reactivity, components, and motion",
   "type": "module",
   "main": "./dist/full.umd.js",
@@ -54,6 +54,46 @@
     "./view": {
       "import": "./dist/view.es.mjs",
       "types": "./dist/view/index.d.ts"
+    },
+    "./storybook": {
+      "import": "./dist/storybook.es.mjs",
+      "types": "./dist/storybook/index.d.ts"
+    },
+    "./forms": {
+      "import": "./dist/forms.es.mjs",
+      "types": "./dist/forms/index.d.ts"
+    },
+    "./i18n": {
+      "import": "./dist/i18n.es.mjs",
+      "types": "./dist/i18n/index.d.ts"
+    },
+    "./a11y": {
+      "import": "./dist/a11y.es.mjs",
+      "types": "./dist/a11y/index.d.ts"
+    },
+    "./dnd": {
+      "import": "./dist/dnd.es.mjs",
+      "types": "./dist/dnd/index.d.ts"
+    },
+    "./media": {
+      "import": "./dist/media.es.mjs",
+      "types": "./dist/media/index.d.ts"
+    },
+    "./plugin": {
+      "import": "./dist/plugin.es.mjs",
+      "types": "./dist/plugin/index.d.ts"
+    },
+    "./devtools": {
+      "import": "./dist/devtools.es.mjs",
+      "types": "./dist/devtools/index.d.ts"
+    },
+    "./testing": {
+      "import": "./dist/testing.es.mjs",
+      "types": "./dist/testing/index.d.ts"
+    },
+    "./ssr": {
+      "import": "./dist/ssr.es.mjs",
+      "types": "./dist/ssr/index.d.ts"
     }
   },
   "files": [
@@ -74,6 +114,7 @@
     "build:umd": "vite build --config vite.umd.config.ts",
     "build:types": "tsc --emitDeclarationOnly --outDir dist",
     "test": "bun test",
+    "test:types": "tsc -p tsconfig.component-test.json --noEmit",
     "test:watch": "bun test --watch",
     "lint": "eslint . --fix",
     "lint:types": "tsc --noEmit",
@@ -116,21 +157,21 @@
     "node": ">=18.0.0"
   },
   "devDependencies": {
-    "@storybook/addon-docs": "^10.2.17",
-    "@storybook/web-components-vite": "^10.2.17",
-    "@typescript-eslint/eslint-plugin": "^8.57.0",
-    "@typescript-eslint/parser": "^8.57.0",
-    "bun-types": "^1.3.10",
-    "eslint": "^10.0.3",
+    "@storybook/addon-docs": "^10.3.3",
+    "@storybook/web-components-vite": "^10.3.3",
+    "@typescript-eslint/eslint-plugin": "^8.57.2",
+    "@typescript-eslint/parser": "^8.57.2",
+    "bun-types": "^1.3.11",
+    "eslint": "^10.1.0",
     "eslint-config-prettier": "^10.1.8",
     "globals": "^17.4.0",
-    "happy-dom": "^20.8.3",
+    "happy-dom": "^20.8.9",
     "prettier": "^3.8.1",
     "rimraf": "^6.1.3",
-    "storybook": "^10.2.17",
-    "typedoc": "^0.28.17",
+    "storybook": "^10.3.3",
+    "typedoc": "^0.28.18",
     "typescript": "^5.9.3",
-    "vite": "^8.0.0",
+    "vite": "^8.0.3",
     "vitepress": "^1.6.4"
   }
 }