@bquery/bquery 1.7.0 → 1.8.2

package/dist/view.es.mjs

@@ -1,7 +1,7 @@
-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";
+import { n as a, r as o } from "./core-DdtZHzsS.js";
+import { D as e } from "./reactive-DwkhUJfP.js";
+import { r as s } from "./untrack-D0fnO5k2.js";
+import { n as c, r as f, t as i } from "./mount-B4Y8bk8Z.js";
 export {
   e as batch,
   f as clearExpressionCache,

package/package.json

@@ -1,177 +1,178 @@
-{
-  "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"
-  }
-}
+{
+  "name": "@bquery/bquery",
+  "version": "1.8.2",
+  "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": ">=24.0.0",
+    "bun": ">=1.3.11"
+  },
+  "devDependencies": {
+    "@storybook/addon-docs": "^10.3.3",
+    "@storybook/web-components-vite": "^10.3.3",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "@typescript-eslint/parser": "^8.58.0",
+    "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

@@ -1,131 +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();
-};
+/**
+ * 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();
+};