@bquery/bquery 1.6.0 → 1.7.0

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,13 +1,13 @@
-import { t as r } from "./effect-AFRW_Plg.js";
-import { d as o, f as e } from "./reactive-DSkct0dO.js";
-import { n as s } from "./core-BGQJVw0-.js";
-import { n as f, r as c, t as i } from "./view-C70lA3vf.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 {
   e as batch,
-  c as clearExpressionCache,
-  o as computed,
+  f as clearExpressionCache,
+  s as computed,
   i as createTemplate,
-  r as effect,
-  f as mount,
-  s as signal
+  o as effect,
+  c as mount,
+  a as signal
 };

package/package.json

@@ -1,141 +1,177 @@
-{
-  "name": "@bquery/bquery",
-  "version": "1.6.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",
-  "module": "./dist/index.es.mjs",
-  "types": "./dist/index.d.ts",
-  "unpkg": "./dist/full.umd.js",
-  "jsdelivr": "./dist/full.umd.js",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.es.mjs",
-      "require": "./dist/full.umd.js"
-    },
-    "./full": {
-      "types": "./dist/full.d.ts",
-      "import": "./dist/full.es.mjs",
-      "require": "./dist/full.umd.js"
-    },
-    "./core": {
-      "import": "./dist/core.es.mjs",
-      "types": "./dist/core/index.d.ts"
-    },
-    "./reactive": {
-      "import": "./dist/reactive.es.mjs",
-      "types": "./dist/reactive/index.d.ts"
-    },
-    "./component": {
-      "import": "./dist/component.es.mjs",
-      "types": "./dist/component/index.d.ts"
-    },
-    "./motion": {
-      "import": "./dist/motion.es.mjs",
-      "types": "./dist/motion/index.d.ts"
-    },
-    "./security": {
-      "import": "./dist/security.es.mjs",
-      "types": "./dist/security/index.d.ts"
-    },
-    "./platform": {
-      "import": "./dist/platform.es.mjs",
-      "types": "./dist/platform/index.d.ts"
-    },
-    "./router": {
-      "import": "./dist/router.es.mjs",
-      "types": "./dist/router/index.d.ts"
-    },
-    "./store": {
-      "import": "./dist/store.es.mjs",
-      "types": "./dist/store/index.d.ts"
-    },
-    "./view": {
-      "import": "./dist/view.es.mjs",
-      "types": "./dist/view/index.d.ts"
-    },
-    "./storybook": {
-      "import": "./dist/storybook.es.mjs",
-      "types": "./dist/storybook/index.d.ts"
-    }
-  },
-  "files": [
-    "dist",
-    "src",
-    "README.md",
-    "LICENSE.md"
-  ],
-  "sideEffects": false,
-  "scripts": {
-    "dev": "vitepress dev docs",
-    "build:docs": "vitepress build docs",
-    "preview": "vitepress preview docs",
-    "storybook": "storybook dev -p 6006",
-    "build:storybook": "storybook build",
-    "build": "bun run build:lib && bun run build:umd && bun run build:types",
-    "build:lib": "vite build",
-    "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",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "docs:api": "typedoc",
-    "clean": "rimraf dist",
-    "prepublishOnly": "bun run clean && bun run build && bun test"
-  },
-  "keywords": [
-    "dom",
-    "manipulation",
-    "jquery",
-    "modern",
-    "typescript",
-    "signals",
-    "reactive",
-    "components",
-    "web-components",
-    "animation",
-    "motion",
-    "zero-build",
-    "cdn"
-  ],
-  "author": "Jonas Pfalzgraf <support@josunlp.de>",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/bQuery/bQuery.git"
-  },
-  "homepage": "https://bQuery.flausch-code.de",
-  "bugs": {
-    "url": "https://github.com/bQuery/bQuery/issues"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "devDependencies": {
-    "@storybook/addon-docs": "^10.2.19",
-    "@storybook/web-components-vite": "^10.2.19",
-    "@typescript-eslint/eslint-plugin": "^8.57.0",
-    "@typescript-eslint/parser": "^8.57.0",
-    "bun-types": "^1.3.10",
-    "eslint": "^10.0.3",
-    "eslint-config-prettier": "^10.1.8",
-    "globals": "^17.4.0",
-    "happy-dom": "^20.8.4",
-    "prettier": "^3.8.1",
-    "rimraf": "^6.1.3",
-    "storybook": "^10.2.19",
-    "typedoc": "^0.28.17",
-    "typescript": "^5.9.3",
-    "vite": "^8.0.0",
-    "vitepress": "^1.6.4"
-  }
-}
+{
+  "name": "@bquery/bquery",
+  "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",
+  "module": "./dist/index.es.mjs",
+  "types": "./dist/index.d.ts",
+  "unpkg": "./dist/full.umd.js",
+  "jsdelivr": "./dist/full.umd.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.es.mjs",
+      "require": "./dist/full.umd.js"
+    },
+    "./full": {
+      "types": "./dist/full.d.ts",
+      "import": "./dist/full.es.mjs",
+      "require": "./dist/full.umd.js"
+    },
+    "./core": {
+      "import": "./dist/core.es.mjs",
+      "types": "./dist/core/index.d.ts"
+    },
+    "./reactive": {
+      "import": "./dist/reactive.es.mjs",
+      "types": "./dist/reactive/index.d.ts"
+    },
+    "./component": {
+      "import": "./dist/component.es.mjs",
+      "types": "./dist/component/index.d.ts"
+    },
+    "./motion": {
+      "import": "./dist/motion.es.mjs",
+      "types": "./dist/motion/index.d.ts"
+    },
+    "./security": {
+      "import": "./dist/security.es.mjs",
+      "types": "./dist/security/index.d.ts"
+    },
+    "./platform": {
+      "import": "./dist/platform.es.mjs",
+      "types": "./dist/platform/index.d.ts"
+    },
+    "./router": {
+      "import": "./dist/router.es.mjs",
+      "types": "./dist/router/index.d.ts"
+    },
+    "./store": {
+      "import": "./dist/store.es.mjs",
+      "types": "./dist/store/index.d.ts"
+    },
+    "./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": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "dev": "vitepress dev docs",
+    "build:docs": "vitepress build docs",
+    "preview": "vitepress preview docs",
+    "storybook": "storybook dev -p 6006",
+    "build:storybook": "storybook build",
+    "build": "bun run build:lib && bun run build:umd && bun run build:types",
+    "build:lib": "vite build",
+    "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",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "docs:api": "typedoc",
+    "clean": "rimraf dist",
+    "prepublishOnly": "bun run clean && bun run build && bun test"
+  },
+  "keywords": [
+    "dom",
+    "manipulation",
+    "jquery",
+    "modern",
+    "typescript",
+    "signals",
+    "reactive",
+    "components",
+    "web-components",
+    "animation",
+    "motion",
+    "zero-build",
+    "cdn"
+  ],
+  "author": "Jonas Pfalzgraf <support@josunlp.de>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bQuery/bQuery.git"
+  },
+  "homepage": "https://bQuery.flausch-code.de",
+  "bugs": {
+    "url": "https://github.com/bQuery/bQuery/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@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.9",
+    "prettier": "^3.8.1",
+    "rimraf": "^6.1.3",
+    "storybook": "^10.3.3",
+    "typedoc": "^0.28.18",
+    "typescript": "^5.9.3",
+    "vite": "^8.0.3",
+    "vitepress": "^1.6.4"
+  }
+}

package/src/a11y/announce.ts

@@ -0,0 +1,131 @@
+/**
+ * Screen reader announcement utility using ARIA live regions.
+ *
+ * Creates and manages off-screen live regions to announce dynamic
+ * content changes to assistive technologies.
+ *
+ * @module bquery/a11y
+ */
+
+import type { AnnouncePriority } from './types';
+
+/** Cache for live region containers, keyed by priority. */
+const liveRegions = new Map<AnnouncePriority, HTMLElement>();
+const pendingAnnouncements = new Map<AnnouncePriority, ReturnType<typeof setTimeout>>();
+
+/**
+ * Delay in milliseconds before updating the live region text.
+ * This ensures screen readers detect the content change even when
+ * the same message is announced consecutively — clearing first and
+ * setting after a short timer delay forces a new live-region mutation event.
+ * @internal
+ */
+const ANNOUNCEMENT_DELAY_MS = 50;
+
+/**
+ * Gets or creates a visually-hidden ARIA live region for the given priority.
+ *
+ * @param priority - The aria-live priority level
+ * @returns The live region element
+ * @internal
+ */
+const getOrCreateLiveRegion = (priority: AnnouncePriority): HTMLElement => {
+  const existing = liveRegions.get(priority);
+  if (existing && existing.isConnected) {
+    return existing;
+  }
+
+  const el = document.createElement('div');
+  el.setAttribute('aria-live', priority);
+  el.setAttribute('aria-atomic', 'true');
+  el.setAttribute('role', priority === 'assertive' ? 'alert' : 'status');
+
+  // Visually hidden but accessible to screen readers
+  Object.assign(el.style, {
+    position: 'absolute',
+    width: '1px',
+    height: '1px',
+    padding: '0',
+    margin: '-1px',
+    overflow: 'hidden',
+    clip: 'rect(0, 0, 0, 0)',
+    whiteSpace: 'nowrap',
+    border: '0',
+  });
+
+  document.body.appendChild(el);
+  liveRegions.set(priority, el);
+
+  return el;
+};
+
+/**
+ * Announces a message to screen readers via an ARIA live region.
+ *
+ * The message is injected into a visually-hidden live region element.
+ * Screen readers will pick up the change and announce it to the user.
+ *
+ * @param message - The text message to announce
+ * @param priority - The urgency level: `'polite'` (default) or `'assertive'`
+ *
+ * @example
+ * ```ts
+ * import { announceToScreenReader } from '@bquery/bquery/a11y';
+ *
+ * // Polite announcement (waits for idle)
+ * announceToScreenReader('3 search results found');
+ *
+ * // Assertive announcement (interrupts current speech)
+ * announceToScreenReader('Error: Please fix the form', 'assertive');
+ * ```
+ */
+export const announceToScreenReader = (
+  message: string,
+  priority: AnnouncePriority = 'polite'
+): void => {
+  if (!message) return;
+  if (typeof document === 'undefined' || !document.body) return;
+
+  const region = getOrCreateLiveRegion(priority);
+  const pendingTimeout = pendingAnnouncements.get(priority);
+  if (pendingTimeout !== undefined) {
+    clearTimeout(pendingTimeout);
+  }
+
+  // Clear first, then set after a short timer delay to ensure screen readers
+  // detect the change even if the same message is announced twice.
+  region.textContent = '';
+
+  // Use setTimeout to ensure the DOM update triggers a live region change event
+  const timeout = setTimeout(() => {
+    pendingAnnouncements.delete(priority);
+    if (region.isConnected) {
+      region.textContent = message;
+    }
+  }, ANNOUNCEMENT_DELAY_MS);
+
+  pendingAnnouncements.set(priority, timeout);
+};
+
+/**
+ * Removes all live region elements created by `announceToScreenReader`.
+ * Useful for cleanup in tests or when unmounting an application.
+ *
+ * @example
+ * ```ts
+ * import { clearAnnouncements } from '@bquery/bquery/a11y';
+ *
+ * clearAnnouncements();
+ * ```
+ */
+export const clearAnnouncements = (): void => {
+  for (const timeout of pendingAnnouncements.values()) {
+    clearTimeout(timeout);
+  }
+  pendingAnnouncements.clear();
+
+  for (const [, el] of liveRegions) {
+    el.remove();
+  }
+  liveRegions.clear();
+};