@bquery/bquery 1.2.0 → 1.4.0

package/dist/platform.es.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"platform.es.mjs","sources":["../src/platform/buckets.ts","../src/platform/cache.ts","../src/platform/notifications.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 * 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 * 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    return Object.keys(this.storage);\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"],"names":["IndexedDBBucket","bucketName","dbName","resolve","reject","request","db","mode","operation","store","key","data","buckets","name","CacheHandleImpl","cache","url","urls","response","req","c","notifications","title","options","WebStorageAdapter","storage","raw","value","serialized","LocalStorageAdapter","SessionStorageAdapter","IndexedDBAdapter"],"mappings":"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"}
+{"version":3,"file":"platform.es.mjs","sources":["../src/platform/buckets.ts","../src/platform/cache.ts","../src/platform/notifications.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 * 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","/**\r\n * Unified storage adapters for web platform storage APIs.\r\n * Provides a consistent, promise-based interface with predictable errors.\r\n */\r\n\r\n/**\r\n * Common interface for all storage adapters.\r\n * All methods return promises for a unified async API.\r\n */\r\nexport interface StorageAdapter {\r\n  /**\r\n   * Retrieve a value by key.\r\n   * @param key - The storage key\r\n   * @returns The stored value or null if not found\r\n   */\r\n  get<T>(key: string): Promise<T | null>;\r\n\r\n  /**\r\n   * Store a value by key.\r\n   * @param key - The storage key\r\n   * @param value - The value to store\r\n   */\r\n  set<T>(key: string, value: T): Promise<void>;\r\n\r\n  /**\r\n   * Remove a value by key.\r\n   * @param key - The storage key\r\n   */\r\n  remove(key: string): Promise<void>;\r\n\r\n  /**\r\n   * Clear all stored values.\r\n   */\r\n  clear(): Promise<void>;\r\n\r\n  /**\r\n   * Get all storage keys.\r\n   * @returns Array of all keys\r\n   */\r\n  keys(): Promise<string[]>;\r\n}\r\n\r\n/**\r\n * Abstract base class for web storage adapters (localStorage/sessionStorage).\r\n * Implements DRY principle by sharing common logic.\r\n */\r\nabstract class WebStorageAdapter implements StorageAdapter {\r\n  constructor(protected readonly storage: Storage) {}\r\n\r\n  async get<T>(key: string): Promise<T | null> {\r\n    const raw = this.storage.getItem(key);\r\n    if (raw === null) return null;\r\n    try {\r\n      return JSON.parse(raw) as T;\r\n    } catch {\r\n      return raw as unknown as T;\r\n    }\r\n  }\r\n\r\n  async set<T>(key: string, value: T): Promise<void> {\r\n    const serialized = typeof value === 'string' ? value : JSON.stringify(value);\r\n    this.storage.setItem(key, serialized);\r\n  }\r\n\r\n  async remove(key: string): Promise<void> {\r\n    this.storage.removeItem(key);\r\n  }\r\n\r\n  async clear(): Promise<void> {\r\n    this.storage.clear();\r\n  }\r\n\r\n  async keys(): Promise<string[]> {\r\n    const result: string[] = [];\r\n    for (let i = 0; i < this.storage.length; i++) {\r\n      const key = this.storage.key(i);\r\n      if (key !== null) {\r\n        result.push(key);\r\n      }\r\n    }\r\n    return result;\r\n  }\r\n}\r\n\r\n/**\r\n * localStorage adapter with async interface.\r\n */\r\nclass LocalStorageAdapter extends WebStorageAdapter {\r\n  constructor() {\r\n    super(localStorage);\r\n  }\r\n}\r\n\r\n/**\r\n * sessionStorage adapter with async interface.\r\n */\r\nclass SessionStorageAdapter extends WebStorageAdapter {\r\n  constructor() {\r\n    super(sessionStorage);\r\n  }\r\n}\r\n\r\n/**\r\n * IndexedDB configuration options.\r\n */\r\nexport interface IndexedDBOptions {\r\n  /** Database name */\r\n  name: string;\r\n  /** Object store name */\r\n  store: string;\r\n  /** Database version (optional) */\r\n  version?: number;\r\n}\r\n\r\n/**\r\n * IndexedDB key-value adapter.\r\n * Wraps IndexedDB with a simple key-value interface.\r\n */\r\nclass IndexedDBAdapter implements StorageAdapter {\r\n  private dbPromise: Promise<IDBDatabase> | null = null;\r\n\r\n  constructor(private readonly options: IndexedDBOptions) {}\r\n\r\n  /**\r\n   * Opens or creates the IndexedDB database.\r\n   */\r\n  private openDB(): Promise<IDBDatabase> {\r\n    if (this.dbPromise) return this.dbPromise;\r\n\r\n    this.dbPromise = new Promise((resolve, reject) => {\r\n      const request = indexedDB.open(this.options.name, this.options.version ?? 1);\r\n\r\n      request.onupgradeneeded = () => {\r\n        const db = request.result;\r\n        if (!db.objectStoreNames.contains(this.options.store)) {\r\n          db.createObjectStore(this.options.store);\r\n        }\r\n      };\r\n\r\n      request.onsuccess = () => resolve(request.result);\r\n      request.onerror = () => reject(request.error);\r\n    });\r\n\r\n    return this.dbPromise;\r\n  }\r\n\r\n  /**\r\n   * Executes a transaction on the object store.\r\n   */\r\n  private async withStore<T>(\r\n    mode: IDBTransactionMode,\r\n    operation: (store: IDBObjectStore) => IDBRequest<T>\r\n  ): Promise<T> {\r\n    const db = await this.openDB();\r\n    return new Promise((resolve, reject) => {\r\n      const tx = db.transaction(this.options.store, mode);\r\n      const store = tx.objectStore(this.options.store);\r\n      const request = operation(store);\r\n      request.onsuccess = () => resolve(request.result);\r\n      request.onerror = () => reject(request.error);\r\n    });\r\n  }\r\n\r\n  async get<T>(key: string): Promise<T | null> {\r\n    const result = await this.withStore<T | undefined>('readonly', (store) => store.get(key));\r\n    return result ?? null;\r\n  }\r\n\r\n  async set<T>(key: string, value: T): Promise<void> {\r\n    await this.withStore('readwrite', (store) => store.put(value, key));\r\n  }\r\n\r\n  async remove(key: string): Promise<void> {\r\n    await this.withStore('readwrite', (store) => store.delete(key));\r\n  }\r\n\r\n  async clear(): Promise<void> {\r\n    await this.withStore('readwrite', (store) => store.clear());\r\n  }\r\n\r\n  async keys(): Promise<string[]> {\r\n    const result = await this.withStore<IDBValidKey[]>('readonly', (store) => store.getAllKeys());\r\n    return result.map((key) => String(key));\r\n  }\r\n}\r\n\r\n/**\r\n * Storage factory providing access to different storage adapters.\r\n */\r\nexport const storage = {\r\n  /**\r\n   * Create a localStorage adapter.\r\n   * @returns StorageAdapter wrapping localStorage\r\n   */\r\n  local(): StorageAdapter {\r\n    return new LocalStorageAdapter();\r\n  },\r\n\r\n  /**\r\n   * Create a sessionStorage adapter.\r\n   * @returns StorageAdapter wrapping sessionStorage\r\n   */\r\n  session(): StorageAdapter {\r\n    return new SessionStorageAdapter();\r\n  },\r\n\r\n  /**\r\n   * Create an IndexedDB adapter with key-value interface.\r\n   * @param options - Database and store configuration\r\n   * @returns StorageAdapter wrapping IndexedDB\r\n   */\r\n  indexedDB(options: IndexedDBOptions): StorageAdapter {\r\n    return new IndexedDBAdapter(options);\r\n  },\r\n};\r\n"],"names":["IndexedDBBucket","bucketName","dbName","resolve","reject","request","db","mode","operation","store","key","data","buckets","name","CacheHandleImpl","cache","url","urls","response","req","c","notifications","title","options","WebStorageAdapter","storage","raw","value","serialized","result","i","LocalStorageAdapter","SessionStorageAdapter","IndexedDBAdapter"],"mappings":"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"}

package/dist/reactive/batch.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Batched reactive updates.
+ */
+/**
+ * Batches multiple signal updates into a single notification cycle.
+ *
+ * Updates made inside the batch function are deferred until the batch
+ * completes, preventing intermediate re-renders and improving performance.
+ *
+ * @param fn - Function containing multiple signal updates
+ */
+export declare const batch: (fn: () => void) => void;
+//# sourceMappingURL=batch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/reactive/batch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,IAAI,KAAG,IAOtC,CAAC"}

package/dist/reactive/computed.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Computed reactive values.
+ */
+import { type ReactiveSource } from './internals';
+/**
+ * A computed value that derives from other reactive sources.
+ *
+ * Computed values are lazily evaluated and cached. They only
+ * recompute when their dependencies change.
+ *
+ * @template T - The type of the computed value
+ */
+export declare class Computed<T> implements ReactiveSource {
+    private readonly compute;
+    private cachedValue;
+    private dirty;
+    private subscribers;
+    private readonly markDirty;
+    /**
+     * Creates a new computed value.
+     * @param compute - Function that computes the value
+     */
+    constructor(compute: () => T);
+    /**
+     * Gets the computed value, recomputing if dependencies changed.
+     * During untrack calls, getCurrentObserver returns undefined, preventing dependency tracking.
+     */
+    get value(): T;
+    /**
+     * Reads the current computed value without tracking.
+     * Useful when you need the value but don't want to create a dependency.
+     *
+     * @returns The current cached value (recomputes if dirty)
+     */
+    peek(): T;
+    /**
+     * Removes an observer from this computed's subscriber set.
+     * @internal
+     */
+    unsubscribe(observer: () => void): void;
+}
+/**
+ * Creates a new computed value.
+ *
+ * @template T - The type of the computed value
+ * @param fn - Function that computes the value from reactive sources
+ * @returns A new Computed instance
+ */
+export declare const computed: <T>(fn: () => T) => Computed<T>;
+//# sourceMappingURL=computed.d.ts.map

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

@@ -0,0 +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"}

package/dist/reactive/core.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Core reactive signals.
+ */
+import { type ReactiveSource } from './internals';
+/**
+ * A reactive value container that notifies subscribers on change.
+ *
+ * Signals are the foundational primitive of the reactive system.
+ * Reading a signal's value inside an effect or computed automatically
+ * establishes a reactive dependency.
+ *
+ * @template T - The type of the stored value
+ */
+export declare class Signal<T> implements ReactiveSource {
+    private _value;
+    private subscribers;
+    /**
+     * Creates a new signal with an initial value.
+     * @param _value - The initial value
+     */
+    constructor(_value: T);
+    /**
+     * Gets the current value and tracks the read if inside an observer.
+     * During untrack calls, getCurrentObserver returns undefined, preventing dependency tracking.
+     */
+    get value(): T;
+    /**
+     * Sets a new value and notifies all subscribers if the value changed.
+     * Uses Object.is for equality comparison.
+     */
+    set value(next: T);
+    /**
+     * Reads the current value without tracking.
+     * Useful when you need the value but don't want to create a dependency.
+     *
+     * @returns The current value
+     */
+    peek(): T;
+    /**
+     * Updates the value using a function.
+     * Useful for updates based on the current value.
+     *
+     * @param updater - Function that receives current value and returns new value
+     */
+    update(updater: (current: T) => T): void;
+    /**
+     * Removes all subscribers from this signal.
+     * Use this when a signal is no longer needed to prevent memory leaks.
+     *
+     * @example
+     * ```ts
+     * const count = signal(0);
+     * effect(() => console.log(count.value));
+     * count.dispose(); // All subscribers removed
+     * ```
+     */
+    dispose(): void;
+    /**
+     * Removes an observer from this signal's subscriber set.
+     * @internal
+     */
+    unsubscribe(observer: () => void): void;
+}
+/**
+ * Creates a new reactive signal.
+ *
+ * @template T - The type of the signal value
+ * @param value - The initial value
+ * @returns A new Signal instance
+ */
+export declare const signal: <T>(value: T) => Signal<T>;
+//# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/reactive/core.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAErB;;;;;;;;GAQG;AACH,qBAAa,MAAM,CAAC,CAAC,CAAE,YAAW,cAAc;IAOlC,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,WAAW,CAAyB;IAE5C;;;OAGG;gBACiB,MAAM,EAAE,CAAC;IAE7B;;;OAGG;IACH,IAAI,KAAK,IAAI,CAAC,CAOb;IAED;;;OAGG;IACH,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,EAQhB;IAED;;;;;OAKG;IACH,IAAI,IAAI,CAAC;IAIT;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI;IAIxC;;;;;;;;;;OAUG;IACH,OAAO,IAAI,IAAI;IASf;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;CAGxC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,MAAM,CAAC,CAAC,CAAsB,CAAC"}

package/dist/reactive/effect.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Reactive effects.
+ */
+import { CleanupFn } from './internals';
+/**
+ * Creates a side effect that automatically re-runs when dependencies change.
+ *
+ * The effect runs immediately upon creation and then re-runs whenever
+ * any signal or computed value read inside it changes.
+ *
+ * @param fn - The effect function to run
+ * @returns A cleanup function to stop the effect
+ */
+export declare const effect: (fn: () => void | CleanupFn) => CleanupFn;
+//# sourceMappingURL=effect.d.ts.map

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

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

package/dist/reactive/index.d.ts

@@ -3,6 +3,6 @@
  *
  * @module bquery/reactive
  */
-export { Computed, Signal, batch, computed, effect, isComputed, isSignal, persistedSignal, readonly, signal, untrack, watch, } from './signal';
-export type { CleanupFn, Observer, ReadonlySignal } from './signal';
+export { Computed, Signal, batch, computed, effect, isComputed, isSignal, linkedSignal, persistedSignal, readonly, signal, untrack, watch, } from './signal';
+export type { CleanupFn, LinkedSignal, Observer, ReadonlySignal } from './signal';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reactive/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EACR,MAAM,EACN,KAAK,EACL,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAK,GACN,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reactive/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EACR,MAAM,EACN,KAAK,EACL,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAK,GACN,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/reactive/internals.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Internal reactive plumbing shared across primitives.
+ * @internal
+ */
+export type Observer = () => void;
+export type CleanupFn = () => void;
+/**
+ * Interface for reactive sources (Signals, Computed) that can unsubscribe observers.
+ * @internal
+ */
+export interface ReactiveSource {
+    unsubscribe(observer: Observer): void;
+}
+export declare const track: <T>(observer: Observer, fn: () => T) => T;
+export declare const getCurrentObserver: () => Observer | undefined;
+/**
+ * Executes a function without exposing the current observer to dependencies.
+ * Unlike disabling tracking globally, this still allows nested reactive internals
+ * (e.g., computed recomputation) to track their own dependencies.
+ * @internal
+ */
+export declare const withoutCurrentObserver: <T>(fn: () => T) => T;
+export declare const scheduleObserver: (observer: Observer) => void;
+export declare const beginBatch: () => void;
+export declare const endBatch: () => void;
+/**
+ * Registers a dependency between an observer and a reactive source.
+ * @internal
+ */
+export declare const registerDependency: (observer: Observer, source: ReactiveSource) => void;
+/**
+ * Removes a specific source from an observer's dependency set.
+ * Used when a source (e.g. Signal) is disposed to prevent stale references.
+ * @internal
+ */
+export declare const removeDependency: (observer: Observer, source: ReactiveSource) => void;
+/**
+ * Clears all dependencies for an observer, unsubscribing from all sources.
+ * @internal
+ */
+export declare const clearDependencies: (observer: Observer) => void;
+//# sourceMappingURL=internals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internals.d.ts","sourceRoot":"","sources":["../../src/reactive/internals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;AAClC,MAAM,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC;AAEnC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CACvC;AASD,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,UAAU,QAAQ,EAAE,IAAI,MAAM,CAAC,KAAG,CAO1D,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAAO,QAAQ,GAAG,SACR,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,EAAE,IAAI,MAAM,CAAC,KAAG,CAUvD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,UAAU,QAAQ,KAAG,IAMrD,CAAC;AAaF,eAAO,MAAM,UAAU,QAAO,IAE7B,CAAC;AAEF,eAAO,MAAM,QAAQ,QAAO,IAM3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,QAAQ,EAAE,QAAQ,cAAc,KAAG,IAO/E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,QAAQ,EAAE,QAAQ,cAAc,KAAG,IAK7E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,QAAQ,KAAG,IAQtD,CAAC"}

package/dist/reactive/linked.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Linked (writable) computed helpers.
+ */
+/**
+ * A writable computed-like signal.
+ */
+export interface LinkedSignal<T> {
+    /** Gets or sets the current value with dependency tracking. */
+    value: T;
+    /** Gets the current value without dependency tracking. */
+    peek(): T;
+}
+/**
+ * Creates a writable computed signal by linking a getter and setter.
+ *
+ * @template T - The derived value type
+ * @param getValue - Getter that derives the current value
+ * @param setValue - Setter that writes back to underlying signals
+ * @returns A writable computed-like signal
+ *
+ * @example
+ * ```ts
+ * const first = signal('Ada');
+ * const last = signal('Lovelace');
+ * const fullName = linkedSignal(
+ *   () => `${first.value} ${last.value}`,
+ *   (next) => {
+ *     const [a, b] = next.split(' ');
+ *     first.value = a ?? '';
+ *     last.value = b ?? '';
+ *   }
+ * );
+ * ```
+ */
+export declare const linkedSignal: <T>(getValue: () => T, setValue: (value: T) => void) => LinkedSignal<T>;
+//# sourceMappingURL=linked.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linked.d.ts","sourceRoot":"","sources":["../../src/reactive/linked.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,+DAA+D;IAC/D,KAAK,EAAE,CAAC,CAAC;IACT,0DAA0D;IAC1D,IAAI,IAAI,CAAC,CAAC;CACX;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,EAC5B,UAAU,MAAM,CAAC,EACjB,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,KAC3B,YAAY,CAAC,CAAC,CAchB,CAAC"}

package/dist/reactive/persisted.d.ts

@@ -0,0 +1,14 @@
+/**
+ * LocalStorage-backed signals.
+ */
+import { Signal } from './core';
+/**
+ * Creates a signal that persists to localStorage.
+ *
+ * @template T - The type of the signal value
+ * @param key - The localStorage key
+ * @param initialValue - The initial value if not found in storage
+ * @returns A Signal that syncs with localStorage (falls back to in-memory if unavailable)
+ */
+export declare const persistedSignal: <T>(key: string, initialValue: T) => Signal<T>;
+//# sourceMappingURL=persisted.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persisted.d.ts","sourceRoot":"","sources":["../../src/reactive/persisted.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGxC;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,cAAc,CAAC,KAAG,MAAM,CAAC,CAAC,CA0DzE,CAAC"}

package/dist/reactive/readonly.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Read-only signal wrappers.
+ */
+import type { Signal } from './core';
+/**
+ * A readonly wrapper around a signal that prevents writes.
+ * Provides read-only access to a signal's value while maintaining reactivity.
+ *
+ * @template T - The type of the wrapped value
+ */
+export interface ReadonlySignal<T> {
+    /** Gets the current value with dependency tracking. */
+    readonly value: T;
+    /** Gets the current value without dependency tracking. */
+    peek(): T;
+}
+/**
+ * Creates a read-only view of a signal.
+ * Useful for exposing reactive state without allowing modifications.
+ *
+ * @template T - The type of the signal value
+ * @param sig - The signal to wrap
+ * @returns A readonly signal wrapper
+ */
+export declare const readonly: <T>(sig: Signal<T>) => ReadonlySignal<T>;
+//# sourceMappingURL=readonly.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readonly.d.ts","sourceRoot":"","sources":["../../src/reactive/readonly.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,0DAA0D;IAC1D,IAAI,IAAI,CAAC,CAAC;CACX;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,KAAG,cAAc,CAAC,CAAC,CAO3D,CAAC"}