@bquery/bquery 1.5.0 → 1.7.0

package/dist/{platform-B7JhGBc7.js → platform-CPbCprb6.js}

@@ -1,5 +1,5 @@
-import { n as w, r as v } from "./core-DPdbItcq.js";
-import { n as p } from "./config-DRmZZno3.js";
+import { n as w, r as v } from "./core-DnlyjbF2.js";
+import { n as p } from "./config-BW35FKuA.js";
 var k = class {
   constructor(e) {
     this.bucketName = e, this.dbPromise = null, this.storeName = "blobs";
@@ -358,4 +358,4 @@ export {
   Q as t
 };
 
-//# sourceMappingURL=platform-B7JhGBc7.js.map
+//# sourceMappingURL=platform-CPbCprb6.js.map

package/dist/platform-CPbCprb6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-CPbCprb6.js","names":[],"sources":["../src/platform/buckets.ts","../src/platform/cache.ts","../src/platform/cookies.ts","../src/platform/notifications.ts","../src/platform/announcer.ts","../src/platform/meta.ts","../src/platform/storage.ts"],"sourcesContent":["/**\n * Storage Buckets API wrapper.\n * Provides a simplified interface for storing blobs and binary data.\n * Falls back to IndexedDB when Storage Buckets API is not available.\n */\n\n/**\n * Bucket interface for blob storage operations.\n */\nexport interface Bucket {\n  /**\n   * Store a blob in the bucket.\n   * @param key - Unique identifier for the blob\n   * @param data - Blob data to store\n   */\n  put(key: string, data: Blob): Promise<void>;\n\n  /**\n   * Retrieve a blob from the bucket.\n   * @param key - Blob identifier\n   * @returns The stored blob or null if not found\n   */\n  get(key: string): Promise<Blob | null>;\n\n  /**\n   * Remove a blob from the bucket.\n   * @param key - Blob identifier\n   */\n  remove(key: string): Promise<void>;\n\n  /**\n   * List all keys in the bucket.\n   * @returns Array of blob keys\n   */\n  keys(): Promise<string[]>;\n}\n\n/**\n * IndexedDB-based bucket implementation.\n * Used as fallback when Storage Buckets API is unavailable.\n */\nclass IndexedDBBucket implements Bucket {\n  private dbPromise: Promise<IDBDatabase> | null = null;\n  private readonly storeName = 'blobs';\n\n  constructor(private readonly bucketName: string) {}\n\n  private openDB(): Promise<IDBDatabase> {\n    if (this.dbPromise) return this.dbPromise;\n\n    const dbName = `bquery-bucket-${this.bucketName}`;\n    this.dbPromise = new Promise((resolve, reject) => {\n      const request = indexedDB.open(dbName, 1);\n\n      request.onupgradeneeded = () => {\n        const db = request.result;\n        if (!db.objectStoreNames.contains(this.storeName)) {\n          db.createObjectStore(this.storeName);\n        }\n      };\n\n      request.onsuccess = () => resolve(request.result);\n      request.onerror = () => reject(request.error);\n    });\n\n    return this.dbPromise;\n  }\n\n  private async withStore<T>(\n    mode: IDBTransactionMode,\n    operation: (store: IDBObjectStore) => IDBRequest<T>\n  ): Promise<T> {\n    const db = await this.openDB();\n    return new Promise((resolve, reject) => {\n      const tx = db.transaction(this.storeName, mode);\n      const store = tx.objectStore(this.storeName);\n      const request = operation(store);\n      request.onsuccess = () => resolve(request.result);\n      request.onerror = () => reject(request.error);\n    });\n  }\n\n  async put(key: string, data: Blob): Promise<void> {\n    await this.withStore('readwrite', (store) => store.put(data, key));\n  }\n\n  async get(key: string): Promise<Blob | null> {\n    const result = await this.withStore<Blob | undefined>('readonly', (store) => store.get(key));\n    return result ?? null;\n  }\n\n  async remove(key: string): Promise<void> {\n    await this.withStore('readwrite', (store) => store.delete(key));\n  }\n\n  async keys(): Promise<string[]> {\n    const result = await this.withStore<IDBValidKey[]>('readonly', (store) => store.getAllKeys());\n    return result.map((key) => String(key));\n  }\n}\n\n/**\n * Bucket manager for creating and accessing storage buckets.\n */\nexport const buckets = {\n  /**\n   * Open or create a storage bucket.\n   * @param name - Bucket name\n   * @returns Bucket instance for blob operations\n   */\n  async open(name: string): Promise<Bucket> {\n    // Storage Buckets API is experimental; use IndexedDB fallback\n    return new IndexedDBBucket(name);\n  },\n};\n","/**\n * Cache Storage API wrapper.\n * Provides a simplified interface for caching responses and assets.\n */\n\n/**\n * Cache handle interface for managing cached resources.\n */\nexport interface CacheHandle {\n  /**\n   * Add a resource to the cache by URL.\n   * Fetches the resource and stores the response.\n   * @param url - URL to fetch and cache\n   */\n  add(url: string): Promise<void>;\n\n  /**\n   * Add multiple resources to the cache.\n   * @param urls - Array of URLs to fetch and cache\n   */\n  addAll(urls: string[]): Promise<void>;\n\n  /**\n   * Store a custom response in the cache.\n   * @param url - URL key for the cached response\n   * @param response - Response object to cache\n   */\n  put(url: string, response: Response): Promise<void>;\n\n  /**\n   * Retrieve a cached response.\n   * @param url - URL to look up\n   * @returns Cached Response or undefined if not found\n   */\n  match(url: string): Promise<Response | undefined>;\n\n  /**\n   * Remove a cached response.\n   * @param url - URL to remove from cache\n   * @returns True if the entry was deleted\n   */\n  remove(url: string): Promise<boolean>;\n\n  /**\n   * Get all cached request URLs.\n   * @returns Array of cached URLs\n   */\n  keys(): Promise<string[]>;\n}\n\n/**\n * Internal cache handle implementation.\n */\nclass CacheHandleImpl implements CacheHandle {\n  constructor(private readonly cache: Cache) {}\n\n  async add(url: string): Promise<void> {\n    await this.cache.add(url);\n  }\n\n  async addAll(urls: string[]): Promise<void> {\n    await this.cache.addAll(urls);\n  }\n\n  async put(url: string, response: Response): Promise<void> {\n    await this.cache.put(url, response);\n  }\n\n  async match(url: string): Promise<Response | undefined> {\n    return this.cache.match(url);\n  }\n\n  async remove(url: string): Promise<boolean> {\n    return this.cache.delete(url);\n  }\n\n  async keys(): Promise<string[]> {\n    const requests = await this.cache.keys();\n    return requests.map((req) => req.url);\n  }\n}\n\n/**\n * Cache manager for accessing the Cache Storage API.\n */\nexport const cache = {\n  /**\n   * Check if Cache Storage API is supported.\n   * @returns True if caches API is available\n   */\n  isSupported(): boolean {\n    return 'caches' in window;\n  },\n\n  /**\n   * Open or create a named cache.\n   * @param name - Cache name\n   * @returns CacheHandle for cache operations\n   */\n  async open(name: string): Promise<CacheHandle> {\n    if (!this.isSupported()) {\n      throw new Error('bQuery: Cache Storage API not supported');\n    }\n    const c = await caches.open(name);\n    return new CacheHandleImpl(c);\n  },\n\n  /**\n   * Delete a named cache.\n   * @param name - Cache name to delete\n   * @returns True if the cache was deleted\n   */\n  async delete(name: string): Promise<boolean> {\n    if (!this.isSupported()) {\n      return false;\n    }\n    return caches.delete(name);\n  },\n\n  /**\n   * List all cache names.\n   * @returns Array of cache names\n   */\n  async keys(): Promise<string[]> {\n    if (!this.isSupported()) {\n      return [];\n    }\n    return caches.keys();\n  },\n};\n","/**\n * Reactive cookie helpers.\n *\n * @module bquery/platform\n */\n\nimport { effect, signal, type Signal } from '../reactive/signal';\nimport { getBqueryConfig } from './config';\n\n/** Options for useCookie(). */\nexport interface UseCookieOptions<T> {\n  /** Default value when the cookie is not present. */\n  defaultValue?: T;\n  /** Cookie path. Defaults to the global config or `/`. */\n  path?: string;\n  /** Optional cookie domain. */\n  domain?: string;\n  /** Cookie SameSite attribute. */\n  sameSite?: 'Strict' | 'Lax' | 'None';\n  /** Whether the cookie should be marked secure. */\n  secure?: boolean;\n  /** Cookie expiry date. */\n  expires?: Date;\n  /** Cookie max-age in seconds. */\n  maxAge?: number;\n  /** Automatically persist signal updates back to document.cookie. */\n  watch?: boolean;\n  /** Serialize a value before writing it into the cookie. */\n  serialize?: (value: T) => string;\n  /** Deserialize a cookie string into a typed value. */\n  deserialize?: (value: string) => T;\n}\n\nconst readCookie = (name: string): string | null => {\n  if (typeof document === 'undefined') return null;\n\n  const prefix = `${encodeURIComponent(name)}=`;\n  const segments = document.cookie ? document.cookie.split(';') : [];\n\n  for (const segment of segments) {\n    const normalizedSegment = segment.trim();\n    if (normalizedSegment.startsWith(prefix)) {\n      const rawValue = normalizedSegment.slice(prefix.length);\n      try {\n        return decodeURIComponent(rawValue);\n      } catch {\n        return rawValue;\n      }\n    }\n  }\n\n  return null;\n};\n\nconst requiresJsonParsing = (value: string): boolean => {\n  const normalized = value.trim();\n  return normalized.startsWith('{') || normalized.startsWith('[') || normalized.startsWith('\"');\n};\n\nconst removeCookie = (\n  name: string,\n  options: Pick<UseCookieOptions<unknown>, 'path' | 'domain' | 'sameSite' | 'secure'>\n): void => {\n  if (typeof document === 'undefined') return;\n\n  const segments = [`${encodeURIComponent(name)}=`, 'Expires=Thu, 01 Jan 1970 00:00:00 GMT'];\n\n  if (options.path) segments.push(`Path=${options.path}`);\n  if (options.domain) segments.push(`Domain=${options.domain}`);\n  if (options.sameSite) segments.push(`SameSite=${options.sameSite}`);\n  if (options.secure) segments.push('Secure');\n\n  document.cookie = segments.join('; ');\n};\n\nconst writeCookie = <T>(name: string, value: T, options: UseCookieOptions<T>): void => {\n  if (typeof document === 'undefined') return;\n\n  const serialized = options.serialize\n    ? options.serialize(value)\n    : typeof value === 'string'\n      ? value\n      : JSON.stringify(value);\n\n  const segments = [`${encodeURIComponent(name)}=${encodeURIComponent(serialized)}`];\n\n  if (options.path) segments.push(`Path=${options.path}`);\n  if (options.domain) segments.push(`Domain=${options.domain}`);\n  if (typeof options.maxAge === 'number') segments.push(`Max-Age=${options.maxAge}`);\n  if (options.expires) segments.push(`Expires=${options.expires.toUTCString()}`);\n  if (options.sameSite) segments.push(`SameSite=${options.sameSite}`);\n  if (options.secure) segments.push('Secure');\n\n  document.cookie = segments.join('; ');\n};\n\n/**\n * Create a reactive cookie signal.\n *\n * @template T - Cookie value type\n * @param name - Cookie name\n * @param options - Read/write configuration for the cookie\n * @returns Reactive signal representing the cookie value\n *\n * @example\n * ```ts\n * const theme = useCookie('theme', { defaultValue: 'light' });\n * theme.value = 'dark';\n * ```\n */\nexport const useCookie = <T>(name: string, options: UseCookieOptions<T> = {}): Signal<T | null> => {\n  const cookieConfig = getBqueryConfig().cookies;\n  const resolvedOptions: UseCookieOptions<T> = {\n    path: cookieConfig?.path ?? '/',\n    sameSite: cookieConfig?.sameSite ?? 'Lax',\n    secure: cookieConfig?.secure ?? false,\n    watch: true,\n    ...options,\n  };\n\n  if (resolvedOptions.sameSite === 'None') {\n    resolvedOptions.secure = true;\n  }\n\n  const raw = readCookie(name);\n  let initialValue = (resolvedOptions.defaultValue ?? null) as T | null;\n\n  if (raw !== null) {\n    try {\n      initialValue = resolvedOptions.deserialize\n        ? resolvedOptions.deserialize(raw)\n        : requiresJsonParsing(raw)\n          ? (JSON.parse(raw) as T)\n          : ((raw as T) ?? initialValue);\n    } catch (error) {\n      console.warn(`bQuery: Failed to deserialize cookie \"${name}\", using raw string value`, error);\n      initialValue = (raw as T) ?? initialValue;\n    }\n  }\n\n  const cookie = signal<T | null>(initialValue);\n\n  if (typeof document === 'undefined' || resolvedOptions.watch === false) {\n    return cookie;\n  }\n\n  let initialized = false;\n  effect(() => {\n    const nextValue = cookie.value;\n\n    if (!initialized) {\n      initialized = true;\n      return;\n    }\n\n    if (nextValue == null) {\n      removeCookie(name, resolvedOptions);\n      return;\n    }\n\n    writeCookie(name, nextValue, resolvedOptions);\n  });\n\n  return cookie;\n};\n","/**\n * Web Notifications API wrapper.\n * Provides a simplified interface for browser notifications.\n */\n\n/**\n * Notification options matching the standard NotificationOptions interface.\n */\nexport interface NotificationOptions {\n  /** Body text of the notification */\n  body?: string;\n  /** Icon URL for the notification */\n  icon?: string;\n  /** Badge icon for mobile devices */\n  badge?: string;\n  /** Tag for grouping notifications */\n  tag?: string;\n  /** Whether to require user interaction */\n  requireInteraction?: boolean;\n  /** Vibration pattern for mobile devices */\n  vibrate?: number[];\n  /** Additional data attached to the notification */\n  data?: unknown;\n}\n\n/**\n * Notifications manager providing a clean interface for web notifications.\n */\nexport const notifications = {\n  /**\n   * Check if notifications are supported.\n   * @returns True if Notification API is available\n   */\n  isSupported(): boolean {\n    return 'Notification' in window;\n  },\n\n  /**\n   * Get current permission status.\n   * @returns Current permission state\n   */\n  getPermission(): NotificationPermission {\n    if (!this.isSupported()) return 'denied';\n    return Notification.permission;\n  },\n\n  /**\n   * Request notification permission from the user.\n   * @returns Promise resolving to the permission result\n   */\n  async requestPermission(): Promise<NotificationPermission> {\n    if (!this.isSupported()) {\n      return 'denied';\n    }\n\n    if (Notification.permission === 'granted') {\n      return 'granted';\n    }\n\n    if (Notification.permission === 'denied') {\n      return 'denied';\n    }\n\n    return Notification.requestPermission();\n  },\n\n  /**\n   * Send a notification.\n   * Requires 'granted' permission.\n   * @param title - Notification title\n   * @param options - Optional notification settings\n   * @returns The Notification instance or null if not permitted\n   */\n  send(title: string, options?: NotificationOptions): Notification | null {\n    if (!this.isSupported()) {\n      console.warn('bQuery: Notifications not supported in this browser');\n      return null;\n    }\n\n    if (Notification.permission !== 'granted') {\n      console.warn('bQuery: Notification permission not granted');\n      return null;\n    }\n\n    return new Notification(title, options);\n  },\n};\n","/**\n * Accessibility live-region announcer helpers.\n *\n * @module bquery/platform\n */\n\nimport { effect, signal, type Signal } from '../reactive/signal';\nimport { getBqueryConfig } from './config';\n\n/** Options for creating an announcer. */\nexport interface UseAnnouncerOptions {\n  /** Live region politeness. */\n  politeness?: 'polite' | 'assertive';\n  /** Whether the live region should be atomic. */\n  atomic?: boolean;\n  /** Delay before applying the message. */\n  delay?: number;\n  /** Delay after which the message is cleared automatically. */\n  clearDelay?: number;\n  /** Optional element id for the live region. */\n  id?: string;\n  /** Optional CSS class name. */\n  className?: string;\n  /** Optional container used to append the live region. */\n  container?: HTMLElement;\n}\n\n/** Runtime options for a single announcement. */\nexport interface AnnounceOptions {\n  /** Override politeness for this specific announcement. */\n  politeness?: 'polite' | 'assertive';\n  /** Override the message delay for this specific announcement. */\n  delay?: number;\n  /** Override the auto-clear delay for this specific announcement. */\n  clearDelay?: number;\n}\n\n/** Returned announcer API. */\nexport interface AnnouncerHandle {\n  /** The live region element or null outside the DOM. */\n  element: HTMLElement | null;\n  /** Reactive message signal. */\n  message: Signal<string>;\n  /** Announce a message to assistive technologies. */\n  announce: (value: string, options?: AnnounceOptions) => void;\n  /** Clear the current announcement. */\n  clear: () => void;\n  /** Remove the live region if it was created by this announcer. */\n  destroy: () => void;\n}\n\nconst visuallyHiddenStyle = [\n  'position:absolute',\n  'width:1px',\n  'height:1px',\n  'padding:0',\n  'margin:-1px',\n  'overflow:hidden',\n  'clip:rect(0, 0, 0, 0)',\n  'white-space:nowrap',\n  'border:0',\n].join(';');\n\n/**\n * Create or reuse an accessible live region.\n *\n * @param options - Live region configuration\n * @returns An announcer handle with announce(), clear(), and destroy()\n *\n * @example\n * ```ts\n * const announcer = useAnnouncer();\n * announcer.announce('Saved successfully');\n * ```\n */\nexport const useAnnouncer = (options: UseAnnouncerOptions = {}): AnnouncerHandle => {\n  const defaults = getBqueryConfig().announcer;\n  const resolvedOptions: Required<\n    Pick<UseAnnouncerOptions, 'politeness' | 'atomic' | 'delay' | 'clearDelay'>\n  > &\n    UseAnnouncerOptions = {\n    politeness: defaults?.politeness ?? 'polite',\n    atomic: defaults?.atomic ?? true,\n    delay: defaults?.delay ?? 16,\n    clearDelay: defaults?.clearDelay ?? 1000,\n    ...options,\n  };\n\n  const message = signal('');\n\n  if (typeof document === 'undefined') {\n    return {\n      element: null,\n      message,\n      announce(value: string) {\n        message.value = value;\n      },\n      clear() {\n        message.value = '';\n      },\n      destroy() {\n        message.value = '';\n      },\n    };\n  }\n\n  const existing = resolvedOptions.id ? document.getElementById(resolvedOptions.id) : null;\n  const element = (existing ?? document.createElement('div')) as HTMLElement;\n  const created = !existing;\n\n  if (resolvedOptions.id) {\n    element.id = resolvedOptions.id;\n  }\n\n  if (resolvedOptions.className) {\n    element.className = resolvedOptions.className;\n  }\n\n  element.setAttribute('aria-live', resolvedOptions.politeness);\n  element.setAttribute('aria-atomic', String(resolvedOptions.atomic));\n  element.setAttribute('role', resolvedOptions.politeness === 'assertive' ? 'alert' : 'status');\n  element.setAttribute('data-bquery-announcer', 'true');\n  if (!element.getAttribute('style')) {\n    element.setAttribute('style', visuallyHiddenStyle);\n  }\n\n  if (created) {\n    const parent = resolvedOptions.container ?? document.body ?? document.documentElement;\n    if (!parent) {\n      return {\n        element: null,\n        message,\n        announce(value: string) {\n          message.value = value;\n        },\n        clear() {\n          message.value = '';\n        },\n        destroy() {\n          message.value = '';\n        },\n      };\n    }\n    parent.appendChild(element);\n  }\n\n  const disposeMessageEffect = effect(() => {\n    element.textContent = message.value;\n  });\n\n  let messageTimer: ReturnType<typeof setTimeout> | undefined;\n  let clearTimer: ReturnType<typeof setTimeout> | undefined;\n  let destroyed = false;\n\n  const clearTimers = (): void => {\n    if (messageTimer) {\n      clearTimeout(messageTimer);\n      messageTimer = undefined;\n    }\n    if (clearTimer) {\n      clearTimeout(clearTimer);\n      clearTimer = undefined;\n    }\n  };\n\n  const clear = (): void => {\n    if (destroyed) return;\n    clearTimers();\n    message.value = '';\n  };\n\n  const announce = (value: string, announceOptions: AnnounceOptions = {}): void => {\n    if (destroyed) return;\n    const politeness = announceOptions.politeness ?? resolvedOptions.politeness;\n    const delay = announceOptions.delay ?? resolvedOptions.delay;\n    const clearDelay = announceOptions.clearDelay ?? resolvedOptions.clearDelay;\n\n    clearTimers();\n\n    element.setAttribute('aria-live', politeness);\n    element.setAttribute('role', politeness === 'assertive' ? 'alert' : 'status');\n    message.value = '';\n\n    messageTimer = setTimeout(() => {\n      if (destroyed) return;\n      message.value = value;\n      if (clearDelay > 0) {\n        clearTimer = setTimeout(() => {\n          if (destroyed) return;\n          message.value = '';\n        }, clearDelay);\n      }\n    }, delay);\n  };\n\n  const destroy = (): void => {\n    if (destroyed) return;\n    destroyed = true;\n    clearTimers();\n    message.value = '';\n    disposeMessageEffect();\n    if (created) {\n      element.remove();\n    }\n  };\n\n  return { element, message, announce, clear, destroy };\n};\n","/**\n * Document title and meta helpers.\n *\n * @module bquery/platform\n */\n\nimport { getBqueryConfig } from './config';\n\n/** Meta tag definition. */\nexport interface PageMetaTag {\n  /** Standard meta name attribute. */\n  name?: string;\n  /** Open Graph / custom property attribute. */\n  property?: string;\n  /** http-equiv attribute. */\n  httpEquiv?: string;\n  /** Meta tag content. */\n  content: string;\n}\n\n/** Link tag definition. */\nexport interface PageLinkTag {\n  /** Link relation. */\n  rel: string;\n  /** Link URL. */\n  href: string;\n  /** Optional type attribute. */\n  type?: string;\n  /** Optional media query. */\n  media?: string;\n  /** Optional crossOrigin attribute. */\n  crossOrigin?: 'anonymous' | 'use-credentials';\n}\n\n/** Page metadata definition. */\nexport interface PageMetaDefinition {\n  /** Document title. */\n  title?: string;\n  /** Convenience shortcut for the description meta tag. */\n  description?: string;\n  /** Additional meta tags. */\n  meta?: PageMetaTag[];\n  /** Additional link tags. */\n  link?: PageLinkTag[];\n  /** Attributes applied to the html element. */\n  htmlAttributes?: Record<string, string>;\n  /** Attributes applied to the body element. */\n  bodyAttributes?: Record<string, string>;\n}\n\n/** Cleanup function returned by definePageMeta(). */\nexport type PageMetaCleanup = () => void;\n\nconst setAttributes = (target: HTMLElement, attributes: Record<string, string>): (() => void) => {\n  const previousValues = new Map<string, string | null>();\n\n  for (const [name, value] of Object.entries(attributes)) {\n    previousValues.set(name, target.getAttribute(name));\n    target.setAttribute(name, value);\n  }\n\n  return () => {\n    for (const [name, value] of previousValues.entries()) {\n      if (value == null) {\n        target.removeAttribute(name);\n      } else {\n        target.setAttribute(name, value);\n      }\n    }\n  };\n};\n\nconst createElement = <T extends 'meta' | 'link'>(\n  tagName: T,\n  attributes: Record<string, string | undefined>\n): HTMLElementTagNameMap[T] => {\n  const element = document.createElement(tagName);\n  element.setAttribute('data-bquery-page-meta', 'true');\n\n  for (const [name, value] of Object.entries(attributes)) {\n    if (value !== undefined) {\n      element.setAttribute(name, value);\n    }\n  }\n\n  return element;\n};\n\n/**\n * Apply document metadata for the current page.\n *\n * @param definition - Title, meta tags, link tags, and document attributes\n * @returns Cleanup function that restores the previous document state\n *\n * @example\n * ```ts\n * const cleanup = definePageMeta({\n *   title: 'Dashboard',\n *   description: 'Overview of your account',\n * });\n * ```\n */\nexport const definePageMeta = (definition: PageMetaDefinition): PageMetaCleanup => {\n  if (typeof document === 'undefined') {\n    return () => {};\n  }\n\n  const config = getBqueryConfig().pageMeta;\n  const title = definition.title\n    ? config?.titleTemplate\n      ? config.titleTemplate(definition.title)\n      : definition.title\n    : undefined;\n\n  const inserted: HTMLElement[] = [];\n  const restoreFns: Array<() => void> = [];\n  const previousTitle = document.title;\n\n  if (title !== undefined) {\n    document.title = title;\n  }\n\n  const metaEntries = [...(definition.meta ?? [])];\n  if (definition.description) {\n    metaEntries.unshift({ name: 'description', content: definition.description });\n  }\n\n  for (const entry of metaEntries) {\n    const meta = createElement('meta', {\n      name: entry.name,\n      property: entry.property,\n      'http-equiv': entry.httpEquiv,\n      content: entry.content,\n    });\n    document.head.appendChild(meta);\n    inserted.push(meta);\n  }\n\n  for (const entry of definition.link ?? []) {\n    const link = createElement('link', {\n      rel: entry.rel,\n      href: entry.href,\n      type: entry.type,\n      media: entry.media,\n      crossorigin: entry.crossOrigin,\n    });\n    document.head.appendChild(link);\n    inserted.push(link);\n  }\n\n  if (definition.htmlAttributes) {\n    restoreFns.push(setAttributes(document.documentElement, definition.htmlAttributes));\n  }\n\n  if (definition.bodyAttributes && document.body) {\n    restoreFns.push(setAttributes(document.body, definition.bodyAttributes));\n  }\n\n  return () => {\n    document.title = previousTitle;\n    for (const restore of restoreFns.reverse()) {\n      restore();\n    }\n    for (const element of inserted) {\n      element.remove();\n    }\n  };\n};\n","/**\n * Unified storage adapters for web platform storage APIs.\n * Provides a consistent, promise-based interface with predictable errors.\n */\n\n/**\n * Common interface for all storage adapters.\n * All methods return promises for a unified async API.\n */\nexport interface StorageAdapter {\n  /**\n   * Retrieve a value by key.\n   * @param key - The storage key\n   * @returns The stored value or null if not found\n   */\n  get<T>(key: string): Promise<T | null>;\n\n  /**\n   * Store a value by key.\n   * @param key - The storage key\n   * @param value - The value to store\n   */\n  set<T>(key: string, value: T): Promise<void>;\n\n  /**\n   * Remove a value by key.\n   * @param key - The storage key\n   */\n  remove(key: string): Promise<void>;\n\n  /**\n   * Clear all stored values.\n   */\n  clear(): Promise<void>;\n\n  /**\n   * Get all storage keys.\n   * @returns Array of all keys\n   */\n  keys(): Promise<string[]>;\n}\n\n/**\n * Abstract base class for web storage adapters (localStorage/sessionStorage).\n * Implements DRY principle by sharing common logic.\n */\nabstract class WebStorageAdapter implements StorageAdapter {\n  constructor(protected readonly storage: Storage) {}\n\n  async get<T>(key: string): Promise<T | null> {\n    const raw = this.storage.getItem(key);\n    if (raw === null) return null;\n    try {\n      return JSON.parse(raw) as T;\n    } catch {\n      return raw as unknown as T;\n    }\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    const serialized = typeof value === 'string' ? value : JSON.stringify(value);\n    this.storage.setItem(key, serialized);\n  }\n\n  async remove(key: string): Promise<void> {\n    this.storage.removeItem(key);\n  }\n\n  async clear(): Promise<void> {\n    this.storage.clear();\n  }\n\n  async keys(): Promise<string[]> {\n    const result: string[] = [];\n    for (let i = 0; i < this.storage.length; i++) {\n      const key = this.storage.key(i);\n      if (key !== null) {\n        result.push(key);\n      }\n    }\n    return result;\n  }\n}\n\n/**\n * localStorage adapter with async interface.\n */\nclass LocalStorageAdapter extends WebStorageAdapter {\n  constructor() {\n    super(localStorage);\n  }\n}\n\n/**\n * sessionStorage adapter with async interface.\n */\nclass SessionStorageAdapter extends WebStorageAdapter {\n  constructor() {\n    super(sessionStorage);\n  }\n}\n\n/**\n * IndexedDB configuration options.\n */\nexport interface IndexedDBOptions {\n  /** Database name */\n  name: string;\n  /** Object store name */\n  store: string;\n  /** Database version (optional) */\n  version?: number;\n}\n\n/**\n * IndexedDB key-value adapter.\n * Wraps IndexedDB with a simple key-value interface.\n */\nclass IndexedDBAdapter implements StorageAdapter {\n  private dbPromise: Promise<IDBDatabase> | null = null;\n\n  constructor(private readonly options: IndexedDBOptions) {}\n\n  /**\n   * Opens or creates the IndexedDB database.\n   */\n  private openDB(): Promise<IDBDatabase> {\n    if (this.dbPromise) return this.dbPromise;\n\n    this.dbPromise = new Promise((resolve, reject) => {\n      const request = indexedDB.open(this.options.name, this.options.version ?? 1);\n\n      request.onupgradeneeded = () => {\n        const db = request.result;\n        if (!db.objectStoreNames.contains(this.options.store)) {\n          db.createObjectStore(this.options.store);\n        }\n      };\n\n      request.onsuccess = () => resolve(request.result);\n      request.onerror = () => reject(request.error);\n    });\n\n    return this.dbPromise;\n  }\n\n  /**\n   * Executes a transaction on the object store.\n   */\n  private async withStore<T>(\n    mode: IDBTransactionMode,\n    operation: (store: IDBObjectStore) => IDBRequest<T>\n  ): Promise<T> {\n    const db = await this.openDB();\n    return new Promise((resolve, reject) => {\n      const tx = db.transaction(this.options.store, mode);\n      const store = tx.objectStore(this.options.store);\n      const request = operation(store);\n      request.onsuccess = () => resolve(request.result);\n      request.onerror = () => reject(request.error);\n    });\n  }\n\n  async get<T>(key: string): Promise<T | null> {\n    const result = await this.withStore<T | undefined>('readonly', (store) => store.get(key));\n    return result ?? null;\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    await this.withStore('readwrite', (store) => store.put(value, key));\n  }\n\n  async remove(key: string): Promise<void> {\n    await this.withStore('readwrite', (store) => store.delete(key));\n  }\n\n  async clear(): Promise<void> {\n    await this.withStore('readwrite', (store) => store.clear());\n  }\n\n  async keys(): Promise<string[]> {\n    const result = await this.withStore<IDBValidKey[]>('readonly', (store) => store.getAllKeys());\n    return result.map((key) => String(key));\n  }\n}\n\n/**\n * Storage factory providing access to different storage adapters.\n */\nexport const storage = {\n  /**\n   * Create a localStorage adapter.\n   * @returns StorageAdapter wrapping localStorage\n   */\n  local(): StorageAdapter {\n    return new LocalStorageAdapter();\n  },\n\n  /**\n   * Create a sessionStorage adapter.\n   * @returns StorageAdapter wrapping sessionStorage\n   */\n  session(): StorageAdapter {\n    return new SessionStorageAdapter();\n  },\n\n  /**\n   * Create an IndexedDB adapter with key-value interface.\n   * @param options - Database and store configuration\n   * @returns StorageAdapter wrapping IndexedDB\n   */\n  indexedDB(options: IndexedDBOptions): StorageAdapter {\n    return new IndexedDBAdapter(options);\n  },\n};\n"],"mappings":"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"}

package/dist/platform.es.mjs

@@ -1,5 +1,5 @@
-import { n as a, t as s } from "./config-DRmZZno3.js";
-import { a as i, i as n, n as t, o as r, r as f, s as u, t as c } from "./platform-B7JhGBc7.js";
+import { n as a, t as s } from "./config-BW35FKuA.js";
+import { a as i, i as n, n as t, o as r, r as f, s as u, t as c } from "./platform-CPbCprb6.js";
 export {
   u as buckets,
   r as cache,

package/dist/plugin/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * bQuery Plugin System — register plugins that extend bQuery with custom
+ * directives and components.
+ *
+ * @module bquery/plugin
+ *
+ * @example
+ * ```ts
+ * import { use, isInstalled, getInstalledPlugins } from '@bquery/bquery/plugin';
+ *
+ * use({
+ *   name: 'my-plugin',
+ *   install(ctx, options) {
+ *     ctx.directive('tooltip', (el, expr) => { ... });
+ *     ctx.component('my-widget', MyWidgetElement);
+ *   },
+ * });
+ * ```
+ */
+export type { BQueryPlugin, CustomDirective, CustomDirectiveHandler, PluginInstallContext, } from './types';
+export { use, isInstalled, getInstalledPlugins, getCustomDirective, getCustomDirectives, resetPlugins, } from './registry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,YAAY,EACV,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,GAAG,EACH,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GACb,MAAM,YAAY,CAAC"}

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;AA0GjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,GAAG,GAAI,QAAQ,GAAG,OAAO,EACpC,QAAQ,YAAY,CAAC,QAAQ,CAAC,EAC9B,UAAU,QAAQ,KACjB,IAqCF,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,IAG/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-cPoOHFLY.js

@@ -0,0 +1,64 @@
+import { n as u } from "./custom-directives-7wAShnnd.js";
+var s = /* @__PURE__ */ new Set(), n = /* @__PURE__ */ new Map();
+u((t) => n.get(t));
+var c = (t) => {
+  n.clear();
+  for (const [e, r] of t) n.set(e, r);
+}, l = (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
+    });
+  }
+}), m = (t, e) => {
+  if (!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 = l(r), a = new Map(n);
+  try {
+    t.install(i, e);
+  } catch (o) {
+    throw c(a), o;
+  }
+  try {
+    for (const o of r) customElements.get(o.tagName) || customElements.define(o.tagName, o.constructor, o.options);
+  } catch (o) {
+    throw c(a), o;
+  }
+  s.add(t.name);
+}, p = (t) => s.has(t), h = () => [...s], w = (t) => n.get(t), y = () => [...n.entries()].map(([t, e]) => ({
+  name: t,
+  handler: e
+})), v = () => {
+  s.clear(), n.clear();
+};
+export {
+  v as a,
+  p as i,
+  y as n,
+  m as o,
+  h as r,
+  w as t
+};
+
+//# sourceMappingURL=plugin-cPoOHFLY.js.map

package/dist/plugin-cPoOHFLY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-cPoOHFLY.js","names":[],"sources":["../src/plugin/registry.ts"],"sourcesContent":["/**\r\n * Global plugin registry for bQuery.\r\n *\r\n * Provides `use()` to register plugins and query helpers consumed by\r\n * other modules (e.g. the view module reads custom directives from here).\r\n *\r\n * @module bquery/plugin\r\n */\r\n\r\nimport { registerCustomDirectiveResolver } from '../view/custom-directives';\r\nimport type {\r\n  BQueryPlugin,\r\n  CustomDirective,\r\n  CustomDirectiveHandler,\r\n  PluginInstallContext,\r\n} from './types';\r\n\r\n// ---------------------------------------------------------------------------\r\n// Internal registries\r\n// ---------------------------------------------------------------------------\r\n\r\n/** Set of installed plugin names — prevents double-install. */\r\nconst installedPlugins = new Set<string>();\r\n\r\n/** Custom directives contributed by plugins. */\r\nconst customDirectives = new Map<string, CustomDirectiveHandler>();\r\n\r\ntype PendingComponentRegistration = {\r\n  tagName: string;\r\n  constructor: CustomElementConstructor;\r\n  options?: ElementDefinitionOptions;\r\n};\r\n\r\nregisterCustomDirectiveResolver((name) => customDirectives.get(name));\r\n\r\n/**\r\n * Restore the directive registry to a previously captured snapshot.\r\n *\r\n * Used to roll back partial plugin installation when `install()` or staged\r\n * `customElements.define()` calls fail after directives were already registered.\r\n *\r\n * @internal\r\n */\r\nconst restoreDirectiveSnapshot = (\r\n  directivesSnapshot: ReadonlyMap<string, CustomDirectiveHandler>\r\n): void => {\r\n  customDirectives.clear();\r\n  for (const [name, handler] of directivesSnapshot) {\r\n    customDirectives.set(name, handler);\r\n  }\r\n};\r\n\r\n// ---------------------------------------------------------------------------\r\n// Install context factory\r\n// ---------------------------------------------------------------------------\r\n\r\n/**\r\n * Build the `PluginInstallContext` handed to each plugin's `install()`.\r\n * @internal\r\n */\r\nconst createInstallContext = (\r\n  pendingComponents: PendingComponentRegistration[]\r\n): PluginInstallContext => ({\r\n  directive(name: string, handler: CustomDirectiveHandler): void {\r\n    if (typeof name !== 'string' || name.length === 0) {\r\n      throw new Error('bQuery plugin directive: name must be a non-empty string');\r\n    }\r\n    if (name.startsWith('bq-')) {\r\n      const suggestedName = name.slice(3);\r\n      throw new Error(\r\n        `bQuery plugin directive: name \"${name}\" must be provided without the \"bq-\" prefix` +\r\n          (suggestedName ? ` (use \"${suggestedName}\")` : '')\r\n      );\r\n    }\r\n    if (typeof handler !== 'function') {\r\n      throw new Error(`bQuery plugin directive: handler for \"${name}\" must be a function`);\r\n    }\r\n    if (customDirectives.has(name)) {\r\n      throw new Error(`bQuery plugin directive: a directive named \"${name}\" is already registered`);\r\n    }\r\n    customDirectives.set(name, handler);\r\n  },\r\n\r\n  component(\r\n    tagName: string,\r\n    constructor: CustomElementConstructor,\r\n    options?: ElementDefinitionOptions\r\n  ): void {\r\n    if (typeof tagName !== 'string' || tagName.length === 0) {\r\n      throw new Error('bQuery plugin component: tagName must be a non-empty string');\r\n    }\r\n    if (!tagName.includes('-')) {\r\n      throw new Error(\r\n        `bQuery plugin component: tagName \"${tagName}\" must be a valid custom element name containing a hyphen`\r\n      );\r\n    }\r\n    if (typeof constructor !== 'function') {\r\n      throw new Error(`bQuery plugin component: constructor for \"${tagName}\" must be a function`);\r\n    }\r\n    if (typeof customElements === 'undefined') {\r\n      if (typeof console !== 'undefined' && typeof console.warn === 'function') {\r\n        console.warn(\r\n          `[bQuery] plugin component \"${tagName}\" was not registered because customElements is not available in this environment.`\r\n        );\r\n      }\r\n      return;\r\n    }\r\n    // Idempotent — skip if already defined or already staged during this install\r\n    if (\r\n      !customElements.get(tagName) &&\r\n      !pendingComponents.some((entry) => entry.tagName === tagName)\r\n    ) {\r\n      pendingComponents.push({ tagName, constructor, options });\r\n    }\r\n  },\r\n});\r\n\r\n// ---------------------------------------------------------------------------\r\n// Public API\r\n// ---------------------------------------------------------------------------\r\n\r\n/**\r\n * Register a bQuery plugin.\r\n *\r\n * Plugins are installed at most once (identified by `plugin.name`).\r\n * Duplicate calls with the same name are silently ignored.\r\n *\r\n * @param plugin - The plugin object implementing `{ name, install }`.\r\n * @param options - Optional configuration forwarded to `plugin.install()`.\r\n * @throws If `plugin` is not a valid plugin object.\r\n *\r\n * @example\r\n * ```ts\r\n * import { use } from '@bquery/bquery/plugin';\r\n *\r\n * use({\r\n *   name: 'highlight',\r\n *   install(ctx) {\r\n *     ctx.directive('highlight', (el, expr) => {\r\n *       (el as HTMLElement).style.background = String(expr);\r\n *     });\r\n *   },\r\n * });\r\n * ```\r\n */\r\nexport const use = <TOptions = unknown>(\r\n  plugin: BQueryPlugin<TOptions>,\r\n  options?: TOptions\r\n): void => {\r\n  if (!plugin || typeof plugin !== 'object') {\r\n    throw new Error('bQuery plugin: use() expects a plugin object with { name, install }');\r\n  }\r\n  if (typeof plugin.name !== 'string' || plugin.name.length === 0) {\r\n    throw new Error('bQuery plugin: plugin must have a non-empty \"name\" property');\r\n  }\r\n  if (typeof plugin.install !== 'function') {\r\n    throw new Error(`bQuery plugin: plugin \"${plugin.name}\" must have an \"install\" function`);\r\n  }\r\n\r\n  // Deduplicate\r\n  if (installedPlugins.has(plugin.name)) return;\r\n\r\n  const pendingComponents: PendingComponentRegistration[] = [];\r\n  const ctx = createInstallContext(pendingComponents);\r\n  const directivesSnapshot = new Map(customDirectives);\r\n\r\n  try {\r\n    plugin.install(ctx, options);\r\n  } catch (error) {\r\n    restoreDirectiveSnapshot(directivesSnapshot);\r\n    throw error;\r\n  }\r\n\r\n  try {\r\n    for (const entry of pendingComponents) {\r\n      if (!customElements.get(entry.tagName)) {\r\n        customElements.define(entry.tagName, entry.constructor, entry.options);\r\n      }\r\n    }\r\n  } catch (error) {\r\n    restoreDirectiveSnapshot(directivesSnapshot);\r\n    throw error;\r\n  }\r\n\r\n  installedPlugins.add(plugin.name);\r\n};\r\n\r\n/**\r\n * Check whether a plugin with the given name has been installed.\r\n *\r\n * @param name - The plugin name to check.\r\n * @returns `true` if the plugin was previously installed via `use()`.\r\n *\r\n * @example\r\n * ```ts\r\n * import { isInstalled } from '@bquery/bquery/plugin';\r\n *\r\n * if (!isInstalled('my-plugin')) {\r\n *   use(myPlugin);\r\n * }\r\n * ```\r\n */\r\nexport const isInstalled = (name: string): boolean => installedPlugins.has(name);\r\n\r\n/**\r\n * Return a read-only snapshot of all installed plugin names.\r\n *\r\n * @returns Array of plugin name strings.\r\n *\r\n * @example\r\n * ```ts\r\n * import { getInstalledPlugins } from '@bquery/bquery/plugin';\r\n * console.log(getInstalledPlugins()); // ['my-plugin', 'other-plugin']\r\n * ```\r\n */\r\nexport const getInstalledPlugins = (): readonly string[] => [...installedPlugins];\r\n\r\n/**\r\n * Retrieve the handler for a custom directive registered by a plugin.\r\n *\r\n * This is used internally by the view module's `processElement` to\r\n * resolve directives that aren't built-in.\r\n *\r\n * @param name - Directive name **without** prefix (e.g. `'tooltip'`).\r\n * @returns The handler, or `undefined` if none is registered.\r\n *\r\n * @example\r\n * ```ts\r\n * import { getCustomDirective } from '@bquery/bquery/plugin';\r\n * const handler = getCustomDirective('tooltip');\r\n * ```\r\n */\r\nexport const getCustomDirective = (name: string): CustomDirectiveHandler | undefined =>\r\n  customDirectives.get(name);\r\n\r\n/**\r\n * Return a read-only snapshot of all registered custom directives.\r\n *\r\n * @returns Array of `{ name, handler }` descriptors.\r\n *\r\n * @example\r\n * ```ts\r\n * import { getCustomDirectives } from '@bquery/bquery/plugin';\r\n * for (const { name, handler } of getCustomDirectives()) {\r\n *   console.log(`Directive: bq-${name}`);\r\n * }\r\n * ```\r\n */\r\nexport const getCustomDirectives = (): readonly CustomDirective[] =>\r\n  [...customDirectives.entries()].map(([name, handler]) => ({ name, handler }));\r\n\r\n/**\r\n * Reset all plugin registrations.\r\n *\r\n * Clears all installed plugins and custom directives.\r\n *\r\n * This utility is primarily intended for tests and other isolated environments\r\n * that need to reinitialize plugin state between runs.\r\n *\r\n * @example\r\n * ```ts\r\n * import { resetPlugins } from '@bquery/bquery/plugin';\r\n * afterEach(() => resetPlugins());\r\n * ```\r\n */\r\nexport const resetPlugins = (): void => {\r\n  installedPlugins.clear();\r\n  customDirectives.clear();\r\n};\r\n"],"mappings":";AAsBA,IAAM,IAAmB,oBAAI,IAAA,GAGvB,IAAmB,oBAAI,IAAA;AAQ7B,EAAA,CAAiC,MAAS,EAAiB,IAAI,CAAA,CAAK;AAUpE,IAAM,IAAA,CACJ,MACS;AACT,EAAA,EAAiB,MAAA;AACjB,aAAW,CAAC,GAAM,CAAA,KAAY,EAC5B,CAAA,EAAiB,IAAI,GAAM,CAAA;GAYzB,IAAA,CACJ,OAC0B;AAAA,EAC1B,UAAU,GAAc,GAAuC;AAC7D,QAAI,OAAO,KAAS,YAAY,EAAK,WAAW,EAC9C,OAAM,IAAI,MAAM,0DAAA;AAElB,QAAI,EAAK,WAAW,KAAA,GAAQ;AAC1B,YAAM,IAAgB,EAAK,MAAM,CAAA;AACjC,YAAM,IAAI,MACR,kCAAkC,CAAA,iDAC/B,IAAgB,UAAU,CAAA,OAAoB,GAAA;AAAA;AAGrD,QAAI,OAAO,KAAY,WACrB,OAAM,IAAI,MAAM,yCAAyC,CAAA,sBAAK;AAEhE,QAAI,EAAiB,IAAI,CAAA,EACvB,OAAM,IAAI,MAAM,+CAA+C,CAAA,yBAAK;AAEtE,IAAA,EAAiB,IAAI,GAAM,CAAA;AAAA;EAG7B,UACE,GACA,GACA,GACM;AACN,QAAI,OAAO,KAAY,YAAY,EAAQ,WAAW,EACpD,OAAM,IAAI,MAAM,6DAAA;AAElB,QAAI,CAAC,EAAQ,SAAS,GAAA,EACpB,OAAM,IAAI,MACR,qCAAqC,CAAA,2DAAQ;AAGjD,QAAI,OAAO,KAAgB,WACzB,OAAM,IAAI,MAAM,6CAA6C,CAAA,sBAAQ;AAEvE,QAAI,OAAO,iBAAmB,KAAa;AACzC,MAAI,OAAO,UAAY,OAAe,OAAO,QAAQ,QAAS,cAC5D,QAAQ,KACN,8BAA8B,CAAA,mFAAQ;AAG1C;AAAA;AAGF,IACE,CAAC,eAAe,IAAI,CAAA,KACpB,CAAC,EAAkB,KAAA,CAAM,MAAU,EAAM,YAAY,CAAA,KAErD,EAAkB,KAAK;AAAA,MAAE,SAAA;AAAA,MAAS,aAAA;AAAA,MAAa,SAAA;AAAA,KAAS;AAAA;IAiCjD,IAAA,CACX,GACA,MACS;AACT,MAAI,CAAC,KAAU,OAAO,KAAW,SAC/B,OAAM,IAAI,MAAM,qEAAA;AAElB,MAAI,OAAO,EAAO,QAAS,YAAY,EAAO,KAAK,WAAW,EAC5D,OAAM,IAAI,MAAM,6DAAA;AAElB,MAAI,OAAO,EAAO,WAAY,WAC5B,OAAM,IAAI,MAAM,0BAA0B,EAAO,IAAA,mCAAK;AAIxD,MAAI,EAAiB,IAAI,EAAO,IAAA,EAAO;AAEvC,QAAM,IAAoD,CAAA,GACpD,IAAM,EAAqB,CAAA,GAC3B,IAAqB,IAAI,IAAI,CAAA;AAEnC,MAAI;AACF,IAAA,EAAO,QAAQ,GAAK,CAAA;AAAA,WACb,GAAO;AACd,UAAA,EAAyB,CAAA,GACnB;AAAA;AAGR,MAAI;AACF,eAAW,KAAS,EAClB,CAAK,eAAe,IAAI,EAAM,OAAA,KAC5B,eAAe,OAAO,EAAM,SAAS,EAAM,aAAa,EAAM,OAAA;AAAA,WAG3D,GAAO;AACd,UAAA,EAAyB,CAAA,GACnB;AAAA;AAGR,EAAA,EAAiB,IAAI,EAAO,IAAA;GAkBjB,IAAA,CAAe,MAA0B,EAAiB,IAAI,CAAA,GAa9D,IAAA,MAA+C,CAAC,GAAG,CAAA,GAiBnD,IAAA,CAAsB,MACjC,EAAiB,IAAI,CAAA,GAeV,IAAA,MACX,CAAC,GAAG,EAAiB,QAAA,CAAS,EAAE,IAAA,CAAK,CAAC,GAAM,CAAA,OAAc;AAAA,EAAE,MAAA;AAAA,EAAM,SAAA;EAAS,GAgBhE,IAAA,MAA2B;AACtC,EAAA,EAAiB,MAAA,GACjB,EAAiB,MAAA"}

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-cPoOHFLY.js";
+export {
+  l as getCustomDirective,
+  a as getCustomDirectives,
+  r as getInstalledPlugins,
+  t as isInstalled,
+  e as resetPlugins,
+  i as use
+};

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,6 +40,11 @@ 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.

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;AAErB;;;;;;;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;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,IAAI,MAAM,CAAC,KAAG,QAAQ,CAAC,CAAC,CAAqB,CAAC"}