@bquery/bquery 1.9.0 → 1.11.0

package/README.md

@@ -1,10 +1,6 @@
-<p align="center">
-  <img src="https://raw.githubusercontent.com/bQuery/bQuery/main/assets/bquerry-logo.svg" alt="bQuery.js Logo" width="120" />
-</p>
+# bQuery.js
 
-<h1 align="center">bQuery.js</h1>
-
-<p align="center">
+![bQuery.js Logo](https://raw.githubusercontent.com/bQuery/bQuery/main/assets/bquerry-logo.svg)
 
 [![Repo](https://img.shields.io/badge/github-bquery%2Fbquery-24292f?logo=github)](https://github.com/bQuery/bQuery)
 [![Stars](https://img.shields.io/github/stars/bquery/bquery?style=flat&logo=github)](https://github.com/bQuery/bQuery/stargazers)
@@ -16,18 +12,17 @@
 [![CodeFactor](https://www.codefactor.io/repository/github/bquery/bquery/badge)](https://www.codefactor.io/repository/github/bquery/bquery)
 [![JsDelivr](https://data.jsdelivr.com/v1/package/npm/@bquery/bquery/badge)](https://www.jsdelivr.com/package/npm/@bquery/bquery)
 
-</p>
-
 **The jQuery for the modern Web Platform.**
 
-bQuery.js is a slim, TypeScript-first library that combines jQuery's direct DOM workflow with modern features like reactivity, async data composables, HTTP clients, polling and pagination helpers, realtime transports, REST workflows, Web Components, motion utilities, routing, stores, declarative views, accessibility helpers, forms, i18n, media signals, drag-and-drop, plugins, devtools, testing utilities, and SSR — without a mandatory build step.
+bQuery.js is a slim, TypeScript-first library that combines jQuery's direct DOM workflow with modern features like reactivity, zero-build worker tasks, async data composables, HTTP clients, polling and pagination helpers, realtime transports, REST workflows, lightweight server middleware and WebSocket session routing, Web Components, motion utilities, routing, stores, declarative views, accessibility helpers, forms, i18n, media signals, drag-and-drop, plugins, devtools, testing utilities, and SSR — without a mandatory build step.
 
-> **New in 1.9.0:** `watchDebounce()` / `watchThrottle()` smooth signal watchers, the View module adds `bq-error` and `bq-aria`, and the Media module now includes `useIntersectionObserver()`, `useResizeObserver()`, and `useMutationObserver()`.
+> **New in 1.11.0:** Runtime-agnostic SSR now adds DOM-free fallback rendering, `renderToStringAsync()`, `renderToStream()`, `renderToResponse()`, runtime adapters, hydration strategies, store snapshots, and resumability hooks, alongside the new `@bquery/bquery/server` entry point for dependency-free backend routing and WebSocket sessions.
 
 ## Highlights
 
 - **Zero-build capable**: runs directly in the browser; build tools are optional.
 - **Transport-ready reactive data**: fetch composables, HTTP clients, polling, pagination, debounced/throttled watchers, WebSocket / SSE, REST helpers, and request coordination plug directly into signals.
+- **Explicit concurrency primitives**: zero-build worker tasks, RPC helpers, bounded pools, reactive worker state mirrors, and collection helpers keep off-main-thread work predictable.
 - **Declarative UI bindings**: built-in directives now cover content, events, forms, error output, and reactive ARIA attributes.
 - **Security-focused**: DOM writes are sanitized by default; Trusted Types supported.
 - **Modular**: the core stays small; extra modules are opt-in.
@@ -127,6 +122,30 @@ import {
   deduplicateRequest,
 } from '@bquery/bquery/reactive';
 
+// Concurrency only
+import {
+  batchTasks,
+  callWorkerMethod,
+  createReactiveRpcPool,
+  createReactiveRpcWorker,
+  createReactiveTaskPool,
+  createReactiveTaskWorker,
+  createRpcPool,
+  createRpcWorker,
+  createTaskPool,
+  createTaskWorker,
+  every,
+  filter,
+  find,
+  getConcurrencySupport,
+  map,
+  parallel,
+  pipeline,
+  reduce,
+  runTask,
+  some,
+} from '@bquery/bquery/concurrency';
+
 // Components only
 import {
   bool,
@@ -164,11 +183,12 @@ import {
   clipboard,
 } from '@bquery/bquery/media';
 
-// Plugins, devtools, testing, SSR
+// Plugins, devtools, testing, SSR, server
 import { use } from '@bquery/bquery/plugin';
 import { enableDevtools, inspectSignals } from '@bquery/bquery/devtools';
 import { renderComponent, fireEvent, waitFor } from '@bquery/bquery/testing';
 import { renderToString, hydrateMount, serializeStoreState } from '@bquery/bquery/ssr';
+import { createServer } from '@bquery/bquery/server';
 
 // Storybook helpers
 import { storyHtml, when } from '@bquery/bquery/storybook';
@@ -176,29 +196,33 @@ import { storyHtml, when } from '@bquery/bquery/storybook';
 
 ## Modules at a glance
 
-| Module        | Description                                                                                                                                        |
-| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Core**      | Selectors, DOM manipulation, events, traversal, and typed utilities                                                                                |
-| **Reactive**  | `signal`, `computed`, `effect`, `watchDebounce`, `watchThrottle`, async data, HTTP clients, polling, pagination, WebSocket / SSE, and REST helpers |
-| **Component** | Typed Web Components with scoped reactivity and configurable Shadow DOM                                                                            |
-| **Storybook** | Safe story template helpers with boolean-attribute shorthand                                                                                       |
-| **Motion**    | View transitions, FLIP, morphing, parallax, typewriter, springs, and timelines                                                                     |
-| **Security**  | HTML sanitization, Trusted Types, CSP helpers, and trusted fragment composition                                                                    |
-| **Platform**  | Storage, cache, cookies, page metadata, announcers, and shared runtime config                                                                      |
-| **Router**    | SPA routing, constrained params, redirects, guards, `useRoute()`, and `<bq-link>`                                                                  |
-| **Store**     | Signal-based state management, persistence, migrations, and action hooks                                                                           |
-| **View**      | Declarative DOM bindings with `bq-*` directives for content, classes, forms, errors, ARIA, and plugins                                             |
-| **Forms**     | Reactive form state with sync/async validation and submit handling                                                                                 |
-| **i18n**      | Reactive locales, interpolation, pluralization, lazy loading, and Intl formatting                                                                  |
-| **A11y**      | Focus traps, live-region announcements, roving tabindex, skip links, and audits                                                                    |
-| **DnD**       | Draggable elements, droppable zones, and sortable lists                                                                                            |
-| **Media**     | Reactive browser/device signals for viewport, network, battery, geolocation, clipboard, and DOM observers                                          |
-| **Plugin**    | Global plugin registration for custom directives and Web Components                                                                                |
-| **Devtools**  | Runtime inspection helpers for signals, stores, components, and timelines                                                                          |
-| **Testing**   | Component mounting, mock signals/router helpers, and async test utilities                                                                          |
-| **SSR**       | Server-side rendering, hydration, and store-state serialization                                                                                    |
-
-Storybook authoring helpers are also available as a dedicated entry point via `@bquery/bquery/storybook`.
+| Module          | Description                                                                                                                                                                 |
+| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Core**        | Selectors, DOM manipulation, events, traversal, and typed utilities                                                                                                         |
+| **Reactive**    | `signal`, `computed`, `effect`, `watchDebounce`, `watchThrottle`, async data, HTTP clients, polling, pagination, WebSocket / SSE, and REST helpers                          |
+| **Concurrency** | Zero-build worker tasks, explicit RPC helpers, optional reactive state wrappers, bounded worker pools, high-level collection helpers, and an optional fluent pipeline layer |
+| **Component**   | Typed Web Components with scoped reactivity and configurable Shadow DOM                                                                                                     |
+| **Storybook**   | Safe story template helpers with boolean-attribute shorthand                                                                                                                |
+| **Motion**      | View transitions, FLIP, morphing, parallax, typewriter, springs, and timelines                                                                                              |
+| **Security**    | HTML sanitization, Trusted Types, CSP helpers, and trusted fragment composition                                                                                             |
+| **Platform**    | Storage, cache, cookies, page metadata, announcers, and shared runtime config                                                                                               |
+| **Router**      | SPA routing, constrained params, redirects, guards, `useRoute()`, and `<bq-link>`                                                                                           |
+| **Store**       | Signal-based state management, persistence, migrations, and action hooks                                                                                                    |
+| **View**        | Declarative DOM bindings with `bq-*` directives for content, classes, forms, errors, ARIA, and plugins                                                                      |
+| **Forms**       | Reactive form state with sync/async validation and submit handling                                                                                                          |
+| **i18n**        | Reactive locales, interpolation, pluralization, lazy loading, and Intl formatting                                                                                           |
+| **A11y**        | Focus traps, live-region announcements, roving tabindex, skip links, and audits                                                                                             |
+| **DnD**         | Draggable elements, droppable zones, and sortable lists                                                                                                                     |
+| **Media**       | Reactive browser/device signals for viewport, network, battery, geolocation, clipboard, and DOM observers                                                                   |
+| **Plugin**      | Global plugin registration for custom directives and Web Components                                                                                                         |
+| **Devtools**    | Runtime inspection helpers for signals, stores, components, and timelines                                                                                                   |
+| **Testing**     | Component mounting, mock signals/router helpers, and async test utilities                                                                                                   |
+| **SSR**         | Runtime-agnostic server-side rendering (Node ≥ 24, Deno, Bun), streaming, async loaders, hydration islands, head/asset/CSP-nonce management, runtime adapters               |
+| **Server**      | Express-inspired backend routing, middleware, safe response helpers, SSR-aware request handling, and runtime-agnostic WebSocket sessions                                    |
+
+Storybook authoring helpers are also available as a dedicated entry point via `@bquery/bquery/storybook`. Worker-task, RPC, worker-pool, high-level task-list / collection helpers, and the optional fluent pipeline layer ship as a dedicated entry point via `@bquery/bquery/concurrency`. Server-side middleware, HTTP routing, and runtime-agnostic WebSocket session helpers ship as a dedicated entry point via `@bquery/bquery/server`.
+
+Reusable workers and pools can also opt into readonly signal mirrors such as `state$`, `busy$`, `pending$`, and `size$` through the `createReactive*()` concurrency wrappers.
 
 ## Quick examples
 
@@ -283,6 +307,134 @@ const fullName = linkedSignal(
 fullName.value = 'Grace Hopper';
 ```
 
+### Concurrency – worker tasks
+
+```ts
+import { runTask } from '@bquery/bquery/concurrency';
+
+const total = await runTask(
+  ({ values }: { values: number[] }) => values.reduce((sum, value) => sum + value, 0),
+  { values: [1, 2, 3, 4] },
+  { timeout: 1_000 }
+);
+
+console.log(total); // 10
+```
+
+### Concurrency – RPC-style worker methods
+
+```ts
+import { createRpcWorker } from '@bquery/bquery/concurrency';
+
+const rpc = createRpcWorker({
+  formatUser: ({ first, last }: { first: string; last: string }) => `${last}, ${first}`,
+  sum: ({ values }: { values: number[] }) => values.reduce((total, value) => total + value, 0),
+});
+
+console.log(await rpc.call('formatUser', { first: 'Ada', last: 'Lovelace' }));
+console.log(await rpc.call('sum', { values: [1, 2, 3] }));
+
+rpc.terminate();
+```
+
+### Concurrency – pooled worker execution
+
+```ts
+import { createTaskPool } from '@bquery/bquery/concurrency';
+
+const pool = createTaskPool(({ value }: { value: number }) => value * 2, {
+  concurrency: 4,
+  maxQueue: 16,
+  name: 'double-pool',
+});
+
+const results = await Promise.all([
+  pool.run({ value: 1 }),
+  pool.run({ value: 2 }),
+  pool.run({ value: 3 }),
+]);
+
+console.log(results); // [2, 4, 6]
+pool.terminate();
+```
+
+### Concurrency – reactive pool state
+
+```ts
+import { createReactiveTaskPool } from '@bquery/bquery/concurrency';
+import { effect } from '@bquery/bquery/reactive';
+
+const pool = createReactiveTaskPool(
+  async ({ delay, value }: { delay: number; value: number }) => {
+    await new Promise((resolve) => setTimeout(resolve, delay));
+    return value * 2;
+  },
+  { concurrency: 2, maxQueue: 8 }
+);
+
+effect(() => {
+  console.log(pool.state$.value, pool.pending$.value, pool.size$.value);
+});
+
+await Promise.all([
+  pool.run({ delay: 20, value: 1 }),
+  pool.run({ delay: 20, value: 2 }),
+  pool.run({ delay: 0, value: 3 }),
+]);
+
+pool.terminate();
+```
+
+### Concurrency – task lists, collection helpers & pipelines
+
+```ts
+import {
+  batchTasks,
+  every,
+  filter,
+  find,
+  map,
+  parallel,
+  pipeline,
+  reduce,
+  some,
+} from '@bquery/bquery/concurrency';
+
+const tasks = await parallel([
+  { handler: (value: number) => value * 2, input: 5 },
+  {
+    handler: ({ first, last }: { first: string; last: string }) => `${last}, ${first}`,
+    input: { first: 'Ada', last: 'Lovelace' },
+  },
+]);
+
+const batched = await batchTasks(
+  [
+    { handler: (value: number) => value * 2, input: 1 },
+    { handler: (value: number) => value * 2, input: 2 },
+    { handler: (value: number) => value * 2, input: 3 },
+  ],
+  2
+);
+
+const mapped = await map([1, 2, 3, 4], (value, index) => value + index, {
+  batchSize: 2,
+  concurrency: 2,
+});
+
+const filtered = await filter([5, 2, 9, 4], (value) => value % 2 === 1);
+const hasEven = await some([1, 3, 4], (value) => value % 2 === 0);
+const allEven = await every([2, 4, 6], (value) => value % 2 === 0);
+const firstLarge = await find([3, 8, 11, 14], (value) => value > 10);
+const reduced = await reduce([1, 2, 3, 4], (accumulator, value) => accumulator + value, 0);
+const piped = await pipeline([1, 2, 3, 4], { batchSize: 2, concurrency: 2 })
+  .map((value) => value * 2)
+  .filter((value) => value > 4)
+  .toArray();
+
+console.log(tasks, batched, mapped, filtered, hasEven, allEven, firstLarge, reduced, piped);
+```
+
 ### Reactive – async data & fetch
 
 ```ts
@@ -628,13 +780,14 @@ drag.destroy();
 modalTrap.release();
 ```
 
-### Plugins, devtools, testing, and SSR
+### Plugins, devtools, testing, SSR, and server
 
 ```ts
 import { use } from '@bquery/bquery/plugin';
 import { enableDevtools, getTimeline } from '@bquery/bquery/devtools';
 import { renderComponent, fireEvent } from '@bquery/bquery/testing';
 import { renderToString } from '@bquery/bquery/ssr';
+import { createServer } from '@bquery/bquery/server';
 
 use({
   name: 'focus-plugin',
@@ -652,6 +805,20 @@ fireEvent(mounted.el, 'click');
 const { html } = renderToString('<p bq-text="label"></p>', { label: 'Hello SSR' });
 console.log(html);
 
+const app = createServer();
+app.get('/hello/:name', (ctx) => ctx.json({ name: ctx.params.name, q: ctx.query.q }));
+
+// Runtime-agnostic async render with head injection (works on Node, Deno, Bun):
+import { createSSRContext, renderToResponse } from '@bquery/bquery/ssr';
+const ctx = createSSRContext({ request: new Request('http://localhost/') });
+ctx.head.add({ title: 'Home' });
+ctx.assets.module('/app.js');
+const response = await renderToResponse(
+  '<html><head></head><body><p bq-text="label"></p></body></html>',
+  { label: 'Hello' },
+  { context: ctx, etag: true }
+);
+
 mounted.unmount();
 ```
 
@@ -728,10 +895,10 @@ mount('#app', {
 
 | Browser | Version | Support |
 | ------- | ------- | ------- |
-| Chrome  | 90+     | ✅ Full |
-| Firefox | 90+     | ✅ Full |
-| Safari  | 15+     | ✅ Full |
-| Edge    | 90+     | ✅ Full |
+| Chrome  | 90+     | ✅ Full  |
+| Firefox | 90+     | ✅ Full  |
+| Safari  | 15+     | ✅ Full  |
+| Edge    | 90+     | ✅ Full  |
 
 > **No IE support** by design.
 
@@ -758,9 +925,12 @@ mount('#app', {
 - **Devtools**: [docs/guide/devtools.md](docs/guide/devtools.md)
 - **Testing Utilities**: [docs/guide/testing.md](docs/guide/testing.md)
 - **SSR / Hydration**: [docs/guide/ssr.md](docs/guide/ssr.md)
+- **Server**: [docs/guide/server.md](docs/guide/server.md)
 
 ## Local Development
 
+The cross-runtime SSR examples in [`examples/`](examples/) import directly from `src/`, so you can run them from a repo checkout without building `dist/` first.
+
 ```bash
 # Install dependencies
 bun install
@@ -777,11 +947,19 @@ bun test
 # Build library
 bun run build
 
+# Verify AI guidance / release metadata sync
+bun run check:ai-guidance
+
 # Build docs
 bun run build:docs
 
 # Generate API documentation
 bun run docs:api
+
+# Run the cross-runtime SSR examples directly from source
+bun examples/ssr-bun/serve.ts
+deno run -A examples/ssr-deno/serve.ts
+node --experimental-strip-types examples/ssr-node/serve.ts
 ```
 
 ## Project Structure
@@ -791,6 +969,7 @@ bQuery.js
 ├── src/
 │   ├── core/       # Selectors, DOM ops, events, utils
 │   ├── reactive/   # Signals, computed, effects, async data
+│   ├── concurrency/ # Zero-build worker tasks, RPC, pools, collection helpers
 │   ├── component/  # Web Components helper + default library
 │   ├── storybook/  # Story template helpers
 │   ├── motion/     # View transitions, FLIP, springs
@@ -807,7 +986,8 @@ bQuery.js
 │   ├── plugin/     # Global plugin system
 │   ├── devtools/   # Runtime inspection helpers
 │   ├── testing/    # Test utilities
-│   └── ssr/        # Server-side rendering + hydration
+│   ├── ssr/        # Runtime-agnostic server-side rendering + hydration
+│   └── server/     # Backend helpers and WebSocket sessions
 ├── docs/           # VitePress documentation
 ├── .storybook/     # Storybook config
 ├── stories/        # Component stories
@@ -826,6 +1006,7 @@ This project provides dedicated context files for AI coding agents:
 - **[AGENT.md](AGENT.md)** — Architecture, module API reference, coding conventions, common tasks
 - **[llms.txt](llms.txt)** — Compact LLM-optimized project summary
 - **[.github/copilot-instructions.md](.github/copilot-instructions.md)** — GitHub Copilot context
+- **`bun run check:ai-guidance`** — Lightweight sync check for version / engine / AI guidance drift
 
 ## License
 

package/dist/{a11y-_9X-kt-_.js → a11y-DgUQ8-fI.js}

@@ -1,5 +1,5 @@
-import { n as E } from "./core-DdtZHzsS.js";
-import { g as I } from "./reactive-BjpLkclt.js";
+import { n as E } from "./core-CongXJuo.js";
+import { n as I } from "./readonly-C0ZwS1Tf.js";
 var w = /* @__PURE__ */ new Map(), A = /* @__PURE__ */ new Map(), q = 50, M = (e) => {
   const t = w.get(e);
   if (t && t.isConnected) return t;
@@ -418,4 +418,4 @@ export {
   G as u
 };
 
-//# sourceMappingURL=a11y-_9X-kt-_.js.map
+//# sourceMappingURL=a11y-DgUQ8-fI.js.map