@bquery/bquery 1.6.0 → 1.8.1

package/dist/plugin/registry.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Global plugin registry for bQuery.
+ *
+ * Provides `use()` to register plugins and query helpers consumed by
+ * other modules (e.g. the view module reads custom directives from here).
+ *
+ * @module bquery/plugin
+ */
+import type { BQueryPlugin, CustomDirective, CustomDirectiveHandler } from './types';
+/**
+ * Register a bQuery plugin.
+ *
+ * Plugins are installed at most once (identified by `plugin.name`).
+ * Duplicate calls with the same name are silently ignored.
+ *
+ * @param plugin - The plugin object implementing `{ name, install }`.
+ * @param options - Optional configuration forwarded to `plugin.install()`.
+ * @throws If `plugin` is not a valid plugin object.
+ *
+ * @example
+ * ```ts
+ * import { use } from '@bquery/bquery/plugin';
+ *
+ * use({
+ *   name: 'highlight',
+ *   install(ctx) {
+ *     ctx.directive('highlight', (el, expr) => {
+ *       (el as HTMLElement).style.background = String(expr);
+ *     });
+ *   },
+ * });
+ * ```
+ */
+export declare const use: <TOptions = unknown>(plugin: BQueryPlugin<TOptions>, options?: TOptions) => void;
+/**
+ * Check whether a plugin with the given name has been installed.
+ *
+ * @param name - The plugin name to check.
+ * @returns `true` if the plugin was previously installed via `use()`.
+ *
+ * @example
+ * ```ts
+ * import { isInstalled } from '@bquery/bquery/plugin';
+ *
+ * if (!isInstalled('my-plugin')) {
+ *   use(myPlugin);
+ * }
+ * ```
+ */
+export declare const isInstalled: (name: string) => boolean;
+/**
+ * Return a read-only snapshot of all installed plugin names.
+ *
+ * @returns Array of plugin name strings.
+ *
+ * @example
+ * ```ts
+ * import { getInstalledPlugins } from '@bquery/bquery/plugin';
+ * console.log(getInstalledPlugins()); // ['my-plugin', 'other-plugin']
+ * ```
+ */
+export declare const getInstalledPlugins: () => readonly string[];
+/**
+ * Retrieve the handler for a custom directive registered by a plugin.
+ *
+ * This is used internally by the view module's `processElement` to
+ * resolve directives that aren't built-in.
+ *
+ * @param name - Directive name **without** prefix (e.g. `'tooltip'`).
+ * @returns The handler, or `undefined` if none is registered.
+ *
+ * @example
+ * ```ts
+ * import { getCustomDirective } from '@bquery/bquery/plugin';
+ * const handler = getCustomDirective('tooltip');
+ * ```
+ */
+export declare const getCustomDirective: (name: string) => CustomDirectiveHandler | undefined;
+/**
+ * Return a read-only snapshot of all registered custom directives.
+ *
+ * @returns Array of `{ name, handler }` descriptors.
+ *
+ * @example
+ * ```ts
+ * import { getCustomDirectives } from '@bquery/bquery/plugin';
+ * for (const { name, handler } of getCustomDirectives()) {
+ *   console.log(`Directive: bq-${name}`);
+ * }
+ * ```
+ */
+export declare const getCustomDirectives: () => readonly CustomDirective[];
+/**
+ * Reset all plugin registrations.
+ *
+ * Clears all installed plugins and custom directives.
+ *
+ * This utility is primarily intended for tests and other isolated environments
+ * that need to reinitialize plugin state between runs.
+ *
+ * @example
+ * ```ts
+ * import { resetPlugins } from '@bquery/bquery/plugin';
+ * afterEach(() => resetPlugins());
+ * ```
+ */
+export declare const resetPlugins: () => void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/plugin/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugin/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,sBAAsB,EAEvB,MAAM,SAAS,CAAC;AAsHjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,GAAG,GAAI,QAAQ,GAAG,OAAO,EACpC,QAAQ,YAAY,CAAC,QAAQ,CAAC,EAC9B,UAAU,QAAQ,KACjB,IAuCF,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,OAAqC,CAAC;AAEjF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,QAAO,SAAS,MAAM,EAA2B,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,sBAAsB,GAAG,SAC/C,CAAC;AAE7B;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,QAAO,SAAS,eAAe,EACgB,CAAC;AAEhF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,QAAO,IAI/B,CAAC"}

package/dist/plugin/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Public types for the bQuery plugin system.
+ *
+ * Plugins extend bQuery by registering custom directives and Web Components
+ * through a single unified interface.
+ *
+ * @module bquery/plugin
+ */
+import type { CleanupFn } from '../reactive/index';
+import type { BindingContext } from '../view/types';
+/**
+ * A custom directive handler that is invoked when the view module encounters
+ * a `bq-{name}` attribute during mount processing.
+ *
+ * @param el - The DOM element carrying the directive attribute
+ * @param expression - The raw attribute value (expression string)
+ * @param context - The current binding context (data / signals)
+ * @param cleanups - Array where the handler should push any cleanup functions
+ *
+ * @example
+ * ```ts
+ * const tooltipDirective: CustomDirectiveHandler = (el, expression, ctx, cleanups) => {
+ *   const tip = document.createElement('span');
+ *   tip.textContent = String(expression);
+ *   el.appendChild(tip);
+ *   cleanups.push(() => tip.remove());
+ * };
+ * ```
+ */
+export type CustomDirectiveHandler = (el: Element, expression: string, context: BindingContext, cleanups: CleanupFn[]) => void;
+/**
+ * Descriptor for a custom directive registered by a plugin.
+ */
+export interface CustomDirective {
+    /** The directive name (without prefix). e.g. `'tooltip'` → `bq-tooltip` */
+    readonly name: string;
+    /** The handler function called when the directive is encountered. */
+    readonly handler: CustomDirectiveHandler;
+}
+/**
+ * Context object provided to a plugin's `install` function.
+ *
+ * Plugins use these helpers to register their contributions into bQuery's
+ * global registries without directly importing internal modules.
+ */
+export interface PluginInstallContext {
+    /**
+     * Register a custom view directive that will be recognized during
+     * `mount()` processing.
+     *
+     * @param name - Directive name **without** the `bq-` prefix (e.g. `'tooltip'`)
+     * @param handler - The handler called for each element with the directive
+     *
+     * @example
+     * ```ts
+     * ctx.directive('focus', (el) => {
+     *   (el as HTMLElement).focus();
+     * });
+     * ```
+     */
+    directive(name: string, handler: CustomDirectiveHandler): void;
+    /**
+     * Register a Web Component via the native `customElements.define()` API.
+     *
+     * @param tagName - Custom element tag (e.g. `'my-counter'`)
+     * @param constructor - The `HTMLElement` subclass
+     * @param options - Optional `ElementDefinitionOptions` (e.g. `{ extends: 'div' }`)
+     *
+     * @example
+     * ```ts
+     * ctx.component('my-counter', MyCounterElement);
+     * ```
+     */
+    component(tagName: string, constructor: CustomElementConstructor, options?: ElementDefinitionOptions): void;
+}
+/**
+ * A bQuery plugin.
+ *
+ * Plugins are plain objects with a `name` and an `install` function.
+ * Call `use(plugin)` to activate a plugin before creating routers, stores,
+ * or mounting views.
+ *
+ * @example
+ * ```ts
+ * import { use } from '@bquery/bquery/plugin';
+ *
+ * const myPlugin: BQueryPlugin = {
+ *   name: 'my-plugin',
+ *   install(ctx, options) {
+ *     ctx.directive('highlight', (el, expr) => {
+ *       (el as HTMLElement).style.background = String(expr);
+ *     });
+ *   },
+ * };
+ *
+ * use(myPlugin, { color: 'yellow' });
+ * ```
+ */
+export interface BQueryPlugin<TOptions = unknown> {
+    /** Unique human-readable name for the plugin. */
+    readonly name: string;
+    /**
+     * Called once when the plugin is registered via `use()`.
+     *
+     * @param context - Helpers for registering directives, components, etc.
+     * @param options - User-provided options forwarded from `use(plugin, options)`.
+     */
+    install(context: PluginInstallContext, options?: TOptions): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugin/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugin/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAMpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,EAAE,EAAE,OAAO,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,SAAS,EAAE,KAClB,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;CAC1C;AAMD;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAE/D;;;;;;;;;;;OAWG;IACH,SAAS,CACP,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,wBAAwB,EACrC,OAAO,CAAC,EAAE,wBAAwB,GACjC,IAAI,CAAC;CACT;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,YAAY,CAAC,QAAQ,GAAG,OAAO;IAC9C,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;CAClE"}

package/dist/plugin-C2WuC8SF.js

@@ -0,0 +1,66 @@
+import { n as l } from "./custom-directives-Dr4C5lVV.js";
+var s = /* @__PURE__ */ new Set(), n = /* @__PURE__ */ new Map(), c = () => {
+  l((t) => n.get(t));
+};
+c();
+var u = (t) => {
+  n.clear();
+  for (const [e, r] of t) n.set(e, r);
+}, f = (t) => ({
+  directive(e, r) {
+    if (typeof e != "string" || e.length === 0) throw new Error("bQuery plugin directive: name must be a non-empty string");
+    if (e.startsWith("bq-")) {
+      const i = e.slice(3);
+      throw new Error(`bQuery plugin directive: name "${e}" must be provided without the "bq-" prefix` + (i ? ` (use "${i}")` : ""));
+    }
+    if (typeof r != "function") throw new Error(`bQuery plugin directive: handler for "${e}" must be a function`);
+    if (n.has(e)) throw new Error(`bQuery plugin directive: a directive named "${e}" is already registered`);
+    n.set(e, r);
+  },
+  component(e, r, i) {
+    if (typeof e != "string" || e.length === 0) throw new Error("bQuery plugin component: tagName must be a non-empty string");
+    if (!e.includes("-")) throw new Error(`bQuery plugin component: tagName "${e}" must be a valid custom element name containing a hyphen`);
+    if (typeof r != "function") throw new Error(`bQuery plugin component: constructor for "${e}" must be a function`);
+    if (typeof customElements > "u") {
+      typeof console < "u" && typeof console.warn == "function" && console.warn(`[bQuery] plugin component "${e}" was not registered because customElements is not available in this environment.`);
+      return;
+    }
+    !customElements.get(e) && !t.some((a) => a.tagName === e) && t.push({
+      tagName: e,
+      constructor: r,
+      options: i
+    });
+  }
+}), p = (t, e) => {
+  if (c(), !t || typeof t != "object") throw new Error("bQuery plugin: use() expects a plugin object with { name, install }");
+  if (typeof t.name != "string" || t.name.length === 0) throw new Error('bQuery plugin: plugin must have a non-empty "name" property');
+  if (typeof t.install != "function") throw new Error(`bQuery plugin: plugin "${t.name}" must have an "install" function`);
+  if (s.has(t.name)) return;
+  const r = [], i = f(r), a = new Map(n);
+  try {
+    t.install(i, e);
+  } catch (o) {
+    throw u(a), o;
+  }
+  try {
+    for (const o of r) customElements.get(o.tagName) || customElements.define(o.tagName, o.constructor, o.options);
+  } catch (o) {
+    throw u(a), o;
+  }
+  s.add(t.name);
+}, h = (t) => s.has(t), v = () => [...s], w = (t) => n.get(t), y = () => [...n.entries()].map(([t, e]) => ({
+  name: t,
+  handler: e
+})), d = () => {
+  s.clear(), n.clear(), c();
+};
+export {
+  d as a,
+  h as i,
+  y as n,
+  p as o,
+  v as r,
+  w as t
+};
+
+//# sourceMappingURL=plugin-C2WuC8SF.js.map

package/dist/plugin-C2WuC8SF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-C2WuC8SF.js","names":[],"sources":["../src/plugin/registry.ts"],"sourcesContent":["/**\n * Global plugin registry for bQuery.\n *\n * Provides `use()` to register plugins and query helpers consumed by\n * other modules (e.g. the view module reads custom directives from here).\n *\n * @module bquery/plugin\n */\n\nimport { registerCustomDirectiveResolver } from '../view/custom-directives';\nimport type {\n  BQueryPlugin,\n  CustomDirective,\n  CustomDirectiveHandler,\n  PluginInstallContext,\n} from './types';\n\n// ---------------------------------------------------------------------------\n// Internal registries\n// ---------------------------------------------------------------------------\n\n/** Set of installed plugin names — prevents double-install. */\nconst installedPlugins = new Set<string>();\n\n/** Custom directives contributed by plugins. */\nconst customDirectives = new Map<string, CustomDirectiveHandler>();\n\ntype PendingComponentRegistration = {\n  tagName: string;\n  constructor: CustomElementConstructor;\n  options?: ElementDefinitionOptions;\n};\n\n/**\n * Ensure the view pipeline resolves plugin directives against the current registry.\n *\n * This is intentionally idempotent so tests or internal modules can temporarily\n * clear the resolver without leaving plugin/view integration in a broken state.\n *\n * @internal\n */\nconst attachCustomDirectiveResolver = (): void => {\n  registerCustomDirectiveResolver((name) => customDirectives.get(name));\n};\n\nattachCustomDirectiveResolver();\n\n/**\n * Restore the directive registry to a previously captured snapshot.\n *\n * Used to roll back partial plugin installation when `install()` or staged\n * `customElements.define()` calls fail after directives were already registered.\n *\n * @internal\n */\nconst restoreDirectiveSnapshot = (\n  directivesSnapshot: ReadonlyMap<string, CustomDirectiveHandler>\n): void => {\n  customDirectives.clear();\n  for (const [name, handler] of directivesSnapshot) {\n    customDirectives.set(name, handler);\n  }\n};\n\n// ---------------------------------------------------------------------------\n// Install context factory\n// ---------------------------------------------------------------------------\n\n/**\n * Build the `PluginInstallContext` handed to each plugin's `install()`.\n * @internal\n */\nconst createInstallContext = (\n  pendingComponents: PendingComponentRegistration[]\n): PluginInstallContext => ({\n  directive(name: string, handler: CustomDirectiveHandler): void {\n    if (typeof name !== 'string' || name.length === 0) {\n      throw new Error('bQuery plugin directive: name must be a non-empty string');\n    }\n    if (name.startsWith('bq-')) {\n      const suggestedName = name.slice(3);\n      throw new Error(\n        `bQuery plugin directive: name \"${name}\" must be provided without the \"bq-\" prefix` +\n          (suggestedName ? ` (use \"${suggestedName}\")` : '')\n      );\n    }\n    if (typeof handler !== 'function') {\n      throw new Error(`bQuery plugin directive: handler for \"${name}\" must be a function`);\n    }\n    if (customDirectives.has(name)) {\n      throw new Error(`bQuery plugin directive: a directive named \"${name}\" is already registered`);\n    }\n    customDirectives.set(name, handler);\n  },\n\n  component(\n    tagName: string,\n    constructor: CustomElementConstructor,\n    options?: ElementDefinitionOptions\n  ): void {\n    if (typeof tagName !== 'string' || tagName.length === 0) {\n      throw new Error('bQuery plugin component: tagName must be a non-empty string');\n    }\n    if (!tagName.includes('-')) {\n      throw new Error(\n        `bQuery plugin component: tagName \"${tagName}\" must be a valid custom element name containing a hyphen`\n      );\n    }\n    if (typeof constructor !== 'function') {\n      throw new Error(`bQuery plugin component: constructor for \"${tagName}\" must be a function`);\n    }\n    if (typeof customElements === 'undefined') {\n      if (typeof console !== 'undefined' && typeof console.warn === 'function') {\n        console.warn(\n          `[bQuery] plugin component \"${tagName}\" was not registered because customElements is not available in this environment.`\n        );\n      }\n      return;\n    }\n    // Idempotent — skip if already defined or already staged during this install\n    if (\n      !customElements.get(tagName) &&\n      !pendingComponents.some((entry) => entry.tagName === tagName)\n    ) {\n      pendingComponents.push({ tagName, constructor, options });\n    }\n  },\n});\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Register a bQuery plugin.\n *\n * Plugins are installed at most once (identified by `plugin.name`).\n * Duplicate calls with the same name are silently ignored.\n *\n * @param plugin - The plugin object implementing `{ name, install }`.\n * @param options - Optional configuration forwarded to `plugin.install()`.\n * @throws If `plugin` is not a valid plugin object.\n *\n * @example\n * ```ts\n * import { use } from '@bquery/bquery/plugin';\n *\n * use({\n *   name: 'highlight',\n *   install(ctx) {\n *     ctx.directive('highlight', (el, expr) => {\n *       (el as HTMLElement).style.background = String(expr);\n *     });\n *   },\n * });\n * ```\n */\nexport const use = <TOptions = unknown>(\n  plugin: BQueryPlugin<TOptions>,\n  options?: TOptions\n): void => {\n  attachCustomDirectiveResolver();\n\n  if (!plugin || typeof plugin !== 'object') {\n    throw new Error('bQuery plugin: use() expects a plugin object with { name, install }');\n  }\n  if (typeof plugin.name !== 'string' || plugin.name.length === 0) {\n    throw new Error('bQuery plugin: plugin must have a non-empty \"name\" property');\n  }\n  if (typeof plugin.install !== 'function') {\n    throw new Error(`bQuery plugin: plugin \"${plugin.name}\" must have an \"install\" function`);\n  }\n\n  // Deduplicate\n  if (installedPlugins.has(plugin.name)) return;\n\n  const pendingComponents: PendingComponentRegistration[] = [];\n  const ctx = createInstallContext(pendingComponents);\n  const directivesSnapshot = new Map(customDirectives);\n\n  try {\n    plugin.install(ctx, options);\n  } catch (error) {\n    restoreDirectiveSnapshot(directivesSnapshot);\n    throw error;\n  }\n\n  try {\n    for (const entry of pendingComponents) {\n      if (!customElements.get(entry.tagName)) {\n        customElements.define(entry.tagName, entry.constructor, entry.options);\n      }\n    }\n  } catch (error) {\n    restoreDirectiveSnapshot(directivesSnapshot);\n    throw error;\n  }\n\n  installedPlugins.add(plugin.name);\n};\n\n/**\n * Check whether a plugin with the given name has been installed.\n *\n * @param name - The plugin name to check.\n * @returns `true` if the plugin was previously installed via `use()`.\n *\n * @example\n * ```ts\n * import { isInstalled } from '@bquery/bquery/plugin';\n *\n * if (!isInstalled('my-plugin')) {\n *   use(myPlugin);\n * }\n * ```\n */\nexport const isInstalled = (name: string): boolean => installedPlugins.has(name);\n\n/**\n * Return a read-only snapshot of all installed plugin names.\n *\n * @returns Array of plugin name strings.\n *\n * @example\n * ```ts\n * import { getInstalledPlugins } from '@bquery/bquery/plugin';\n * console.log(getInstalledPlugins()); // ['my-plugin', 'other-plugin']\n * ```\n */\nexport const getInstalledPlugins = (): readonly string[] => [...installedPlugins];\n\n/**\n * Retrieve the handler for a custom directive registered by a plugin.\n *\n * This is used internally by the view module's `processElement` to\n * resolve directives that aren't built-in.\n *\n * @param name - Directive name **without** prefix (e.g. `'tooltip'`).\n * @returns The handler, or `undefined` if none is registered.\n *\n * @example\n * ```ts\n * import { getCustomDirective } from '@bquery/bquery/plugin';\n * const handler = getCustomDirective('tooltip');\n * ```\n */\nexport const getCustomDirective = (name: string): CustomDirectiveHandler | undefined =>\n  customDirectives.get(name);\n\n/**\n * Return a read-only snapshot of all registered custom directives.\n *\n * @returns Array of `{ name, handler }` descriptors.\n *\n * @example\n * ```ts\n * import { getCustomDirectives } from '@bquery/bquery/plugin';\n * for (const { name, handler } of getCustomDirectives()) {\n *   console.log(`Directive: bq-${name}`);\n * }\n * ```\n */\nexport const getCustomDirectives = (): readonly CustomDirective[] =>\n  [...customDirectives.entries()].map(([name, handler]) => ({ name, handler }));\n\n/**\n * Reset all plugin registrations.\n *\n * Clears all installed plugins and custom directives.\n *\n * This utility is primarily intended for tests and other isolated environments\n * that need to reinitialize plugin state between runs.\n *\n * @example\n * ```ts\n * import { resetPlugins } from '@bquery/bquery/plugin';\n * afterEach(() => resetPlugins());\n * ```\n */\nexport const resetPlugins = (): void => {\n  installedPlugins.clear();\n  customDirectives.clear();\n  attachCustomDirectiveResolver();\n};\n"],"mappings":"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"}

package/dist/plugin.es.mjs

@@ -0,0 +1,9 @@
+import { a as e, i as t, n as a, o as i, r, t as l } from "./plugin-C2WuC8SF.js";
+export {
+  l as getCustomDirective,
+  a as getCustomDirectives,
+  r as getInstalledPlugins,
+  t as isInstalled,
+  e as resetPlugins,
+  i as use
+};

package/dist/reactive/async-data.d.ts

@@ -43,13 +43,24 @@ export interface AsyncDataState<TData> {
     execute: () => Promise<TData | undefined>;
     /** Alias for execute(). */
     refresh: () => Promise<TData | undefined>;
+    /** Abort the current in-flight request (useFetch only; no-op for useAsyncData). */
+    abort: () => void;
     /** Clear data, error, and status back to the initial state. */
     clear: () => void;
     /** Dispose reactive watchers and prevent future executions. */
     dispose: () => void;
 }
+/** Configuration for automatic request retries in useFetch(). */
+export interface UseFetchRetryConfig {
+    /** Maximum number of retry attempts (default: 3). */
+    count: number;
+    /** Delay in ms between retries, or a function receiving the attempt index. */
+    delay?: number | ((attempt: number) => number);
+    /** Predicate deciding whether to retry. Defaults to network / 5xx errors. */
+    retryOn?: (error: Error, attempt: number) => boolean;
+}
 /** Options for useFetch(). */
-export interface UseFetchOptions<TResponse = unknown, TData = TResponse> extends UseAsyncDataOptions<TResponse, TData>, Omit<RequestInit, 'body' | 'headers'> {
+export interface UseFetchOptions<TResponse = unknown, TData = TResponse> extends UseAsyncDataOptions<TResponse, TData>, Omit<RequestInit, 'body' | 'headers' | 'signal'> {
     /** Base URL prepended to relative URLs. */
     baseUrl?: string;
     /** Query parameters appended to the request URL. */
@@ -62,6 +73,14 @@ export interface UseFetchOptions<TResponse = unknown, TData = TResponse> extends
     parseAs?: BqueryFetchParseAs;
     /** Custom fetch implementation for testing or adapters. */
     fetcher?: typeof fetch;
+    /** Request timeout in milliseconds. 0 means no timeout. */
+    timeout?: number;
+    /** External AbortSignal for request cancellation. */
+    signal?: AbortSignal;
+    /** Retry configuration. Pass a number for simple retry count, or a config object. */
+    retry?: number | UseFetchRetryConfig;
+    /** Custom status validation. Returns `true` for acceptable statuses. */
+    validateStatus?: (status: number) => boolean;
 }
 /** Input accepted by useFetch(). */
 export type FetchInput = string | URL | Request | (() => string | URL | Request);
@@ -83,15 +102,21 @@ export declare const useAsyncData: <TResult, TData = TResult>(handler: () => Pro
 /**
  * Reactive fetch composable using the browser Fetch API.
  *
+ * Supports timeout, abort, retry, and custom status validation in addition
+ * to the core useFetch features (query params, JSON body, baseUrl, watch).
+ *
  * @template TResponse - Raw parsed response type
  * @template TData - Stored response type after optional transformation
  * @param input - Request URL, Request object, or lazy input factory
  * @param options - Request and reactive state options
- * @returns Reactive fetch state with execute(), refresh(), and clear()
+ * @returns Reactive fetch state with execute(), refresh(), abort(), clear(), and dispose()
  *
  * @example
  * ```ts
- * const users = useFetch<{ id: number; name: string }[]>('/api/users');
+ * const users = useFetch<{ id: number; name: string }[]>('/api/users', {
+ *   timeout: 5000,
+ *   retry: 3,
+ * });
  * ```
  */
 export declare const useFetch: <TResponse = unknown, TData = TResponse>(input: FetchInput, options?: UseFetchOptions<TResponse, TData>) => AsyncDataState<TData>;

package/dist/reactive/async-data.d.ts.map

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

package/dist/reactive/computed.d.ts

@@ -13,7 +13,9 @@ import { type ReactiveSource } from './internals';
 export declare class Computed<T> implements ReactiveSource {
     private readonly compute;
     private cachedValue;
+    private hasCachedValue;
     private dirty;
+    private disposed;
     private subscribers;
     private readonly markDirty;
     /**
@@ -38,10 +40,18 @@ export declare class Computed<T> implements ReactiveSource {
      * @internal
      */
     unsubscribe(observer: () => void): void;
+    /**
+     * Disposes the computed value by unsubscribing its internal observer
+     * from all upstream dependencies and clearing subscribers.
+     */
+    dispose(): void;
 }
 /**
  * Creates a new computed value.
  *
+ * If created inside an {@link effectScope}, the computed value is automatically
+ * collected and will be disposed when the scope stops.
+ *
  * @template T - The type of the computed value
  * @param fn - Function that computes the value from reactive sources
  * @returns A new Computed instance

package/dist/reactive/computed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"computed.d.ts","sourceRoot":"","sources":["../../src/reactive/computed.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAErB;;;;;;;GAOG;AACH,qBAAa,QAAQ,CAAC,CAAC,CAAE,YAAW,cAAc;IAiBpC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAhBpC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAOxB;IAEF;;;OAGG;gBAC0B,OAAO,EAAE,MAAM,CAAC;IAE7C;;;OAGG;IACH,IAAI,KAAK,IAAI,CAAC,CAab;IAED;;;;;OAKG;IACH,IAAI,IAAI,CAAC;IAUT;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;CAGxC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,IAAI,MAAM,CAAC,KAAG,QAAQ,CAAC,CAAC,CAAqB,CAAC"}
+{"version":3,"file":"computed.d.ts","sourceRoot":"","sources":["../../src/reactive/computed.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAGrB;;;;;;;GAOG;AACH,qBAAa,QAAQ,CAAC,CAAC,CAAE,YAAW,cAAc;IAsBpC,OAAO,CAAC,QAAQ,CAAC,OAAO;IArBpC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAUxB;IAEF;;;OAGG;gBAC0B,OAAO,EAAE,MAAM,CAAC;IAE7C;;;OAGG;IACH,IAAI,KAAK,IAAI,CAAC,CAsBb;IAED;;;;;OAKG;IACH,IAAI,IAAI,CAAC;IAmBT;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAIvC;;;OAGG;IACH,OAAO,IAAI,IAAI;CAShB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,IAAI,MAAM,CAAC,KAAG,QAAQ,CAAC,CAAC,CAUnD,CAAC"}

package/dist/reactive/effect.d.ts

@@ -8,6 +8,9 @@ import { CleanupFn } from './internals';
  * The effect runs immediately upon creation and then re-runs whenever
  * any signal or computed value read inside it changes.
  *
+ * If created inside an {@link effectScope}, the effect is automatically
+ * collected and will be disposed when the scope stops.
+ *
  * @param fn - The effect function to run
  * @returns A cleanup function to stop the effect
  */

package/dist/reactive/effect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../../src/reactive/effect.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAsC,MAAM,aAAa,CAAC;AAE5E;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,GAAI,IAAI,MAAM,IAAI,GAAG,SAAS,KAAG,SAsCnD,CAAC"}
+{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../../src/reactive/effect.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAsC,MAAM,aAAa,CAAC;AAG5E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM,GAAI,IAAI,MAAM,IAAI,GAAG,SAAS,KAAG,SAyDnD,CAAC"}

package/dist/reactive/http.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Imperative HTTP client with Axios-like API, interceptors, retry, timeout,
+ * cancellation, and progress tracking — built on the native Fetch API.
+ *
+ * @module bquery/reactive
+ */
+import { type BqueryFetchParseAs } from '../platform/config';
+/** Configuration for automatic request retries. */
+export interface RetryConfig {
+    /** Maximum number of retry attempts (default: 3). */
+    count: number;
+    /** Delay in ms between retries, or a function receiving the attempt index. */
+    delay?: number | ((attempt: number) => number);
+    /** Predicate deciding whether to retry a given error. Defaults to network / 5xx errors. */
+    retryOn?: (error: HttpError, attempt: number) => boolean;
+    /** Called before each retry attempt with the error and 1-indexed attempt number. */
+    onRetry?: (error: HttpError, attempt: number) => void;
+}
+/** Progress information emitted during upload or download. */
+export interface HttpProgressEvent {
+    /** Bytes transferred so far. */
+    loaded: number;
+    /** Total bytes if known, otherwise 0. */
+    total: number;
+    /** Percentage between 0 and 100, or `undefined` when total is unknown. */
+    percent: number | undefined;
+}
+/** Full request configuration accepted by the HTTP client. */
+export interface HttpRequestConfig extends Omit<RequestInit, 'body' | 'headers' | 'signal'> {
+    /** Request URL (resolved against `baseUrl`). */
+    url?: string;
+    /** Base URL prepended to relative request URLs. */
+    baseUrl?: string;
+    /** Request headers. */
+    headers?: HeadersInit;
+    /** Query parameters appended to the URL. */
+    query?: Record<string, unknown>;
+    /** Request body — plain objects/arrays are JSON-serialised automatically. */
+    body?: BodyInit | Record<string, unknown> | unknown[] | null;
+    /** Request timeout in milliseconds. 0 means no timeout (default). */
+    timeout?: number;
+    /** Response parsing strategy. */
+    parseAs?: BqueryFetchParseAs;
+    /** Custom status validation. Returns `true` for acceptable statuses. Default: `status >= 200 && status < 300`. */
+    validateStatus?: (status: number) => boolean;
+    /** Custom fetch implementation for testing or adapters. */
+    fetcher?: typeof fetch;
+    /** External `AbortSignal` for request cancellation. */
+    signal?: AbortSignal;
+    /** Retry configuration. Pass a number for simple retry count, or a `RetryConfig` object. */
+    retry?: number | RetryConfig;
+    /** Called repeatedly as response body chunks arrive. */
+    onDownloadProgress?: (event: HttpProgressEvent) => void;
+}
+/** Structured HTTP response returned by every client method. */
+export interface HttpResponse<T = unknown> {
+    /** Parsed response data. */
+    data: T;
+    /** HTTP status code. */
+    status: number;
+    /** HTTP status text. */
+    statusText: string;
+    /** Response headers. */
+    headers: Headers;
+    /** Resolved request configuration used for this call. */
+    config: HttpRequestConfig;
+}
+/** Error subclass thrown on failed HTTP requests with rich metadata. */
+export declare class HttpError extends Error {
+    /** HTTP response (available when the server replied). */
+    response?: HttpResponse;
+    /** Resolved request configuration. */
+    config: HttpRequestConfig;
+    /** Original error code string (e.g. `'TIMEOUT'`, `'ABORT'`, `'NETWORK'`). */
+    code: string;
+    constructor(message: string, config: HttpRequestConfig, code: string, response?: HttpResponse);
+}
+/** Single interceptor handler pair. */
+export interface Interceptor<T> {
+    fulfilled?: (value: T) => T | Promise<T>;
+    rejected?: (error: unknown) => unknown;
+}
+/** Manager for adding and removing interceptors. */
+export interface InterceptorManager<T> {
+    /** Register an interceptor. Returns a numeric id for later removal via `eject()`. */
+    use(fulfilled?: (value: T) => T | Promise<T>, rejected?: (error: unknown) => unknown): number;
+    /** Remove a previously registered interceptor by id. */
+    eject(id: number): void;
+    /** Remove all interceptors. */
+    clear(): void;
+}
+/** Imperative HTTP client with interceptors and convenience method shortcuts. */
+export interface HttpClient {
+    /** Send a request using the provided configuration. */
+    request<T = unknown>(config: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /** Send a GET request. */
+    get<T = unknown>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /** Send a POST request. */
+    post<T = unknown>(url: string, body?: HttpRequestConfig['body'], config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /** Send a PUT request. */
+    put<T = unknown>(url: string, body?: HttpRequestConfig['body'], config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /** Send a PATCH request. */
+    patch<T = unknown>(url: string, body?: HttpRequestConfig['body'], config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /** Send a DELETE request. */
+    delete<T = unknown>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /** Send a HEAD request. */
+    head<T = unknown>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /** Send an OPTIONS request. */
+    options<T = unknown>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+    /** Request and response interceptors. */
+    interceptors: {
+        request: InterceptorManager<HttpRequestConfig>;
+        response: InterceptorManager<HttpResponse>;
+    };
+    /** The merged default configuration used by this client. */
+    defaults: HttpRequestConfig;
+}
+/**
+ * Create a preconfigured HTTP client instance with interceptors.
+ *
+ * @param defaults - Default request configuration merged into every request
+ * @returns An `HttpClient` with `.get()`, `.post()`, `.put()`, `.patch()`, `.delete()`, `.head()`, `.options()`
+ *
+ * @example
+ * ```ts
+ * import { createHttp } from '@bquery/bquery/reactive';
+ *
+ * const api = createHttp({
+ *   baseUrl: 'https://api.example.com',
+ *   headers: { authorization: 'Bearer token' },
+ *   timeout: 10_000,
+ * });
+ *
+ * api.interceptors.request.use((config) => {
+ *   config.headers = { ...Object.fromEntries(new Headers(config.headers)), 'x-req-id': crypto.randomUUID() };
+ *   return config;
+ * });
+ *
+ * const { data } = await api.get<User[]>('/users');
+ * ```
+ */
+export declare function createHttp(defaults?: HttpRequestConfig): HttpClient;
+/**
+ * Default HTTP client instance using global bQuery fetch config.
+ *
+ * @example
+ * ```ts
+ * import { http } from '@bquery/bquery/reactive';
+ *
+ * const { data } = await http.get<User[]>('/api/users');
+ * const { data: created } = await http.post('/api/users', { name: 'Ada' });
+ * ```
+ */
+export declare const http: HttpClient;
+/** Options for `createRequestQueue()`. */
+export interface RequestQueueOptions {
+    /** Maximum number of concurrent in-flight requests (default: 6). */
+    concurrency?: number;
+}
+/** Return value of `createRequestQueue()`. */
+export interface RequestQueue {
+    /** Enqueue a request. Returns a promise that resolves when the request completes. */
+    add: <T = unknown>(execute: () => Promise<HttpResponse<T>>) => Promise<HttpResponse<T>>;
+    /** Number of requests currently being processed. */
+    readonly pending: number;
+    /** Number of requests waiting in the queue. */
+    readonly size: number;
+    /** Remove all pending (not yet started) requests from the queue. Their promises will reject. */
+    clear: () => void;
+}
+/**
+ * Create a request queue with a concurrency limit.
+ *
+ * Useful for rate-limiting parallel HTTP requests (e.g. browser connection limits,
+ * API throttling) while maintaining a simple promise-based interface.
+ *
+ * @param options - Queue configuration
+ * @returns A `RequestQueue` with `.add()`, `.clear()`, `.pending`, and `.size`
+ *
+ * @example
+ * ```ts
+ * import { createRequestQueue, createHttp } from '@bquery/bquery/reactive';
+ *
+ * const api = createHttp({ baseUrl: 'https://api.example.com' });
+ * const queue = createRequestQueue({ concurrency: 3 });
+ *
+ * // These will run at most 3 at a time
+ * const results = await Promise.all(
+ *   ids.map(id => queue.add(() => api.get(`/items/${id}`)))
+ * );
+ * ```
+ */
+export declare function createRequestQueue(options?: RequestQueueOptions): RequestQueue;
+//# sourceMappingURL=http.d.ts.map