@uniweb/core 0.14.0 → 0.14.1

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@uniweb/core",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "Core classes for the Uniweb platform - Uniweb, Website, Page, Block",
   "type": "module",
   "exports": {
     ".": "./src/index.js",
     "./base-path": "./src/base-path.js",
-    "./collection-address": "./src/collection-address.js",
+    "./collection-address": "./src/query-address.js",
+    "./query-address": "./src/query-address.js",
     "./data-paths": "./src/data-paths.js",
     "./detail-url": "./src/detail-url.js",
     "./fetch-config": "./src/fetch-config.js",
@@ -41,8 +42,8 @@
     "vitest": "^4.1.7"
   },
   "dependencies": {
-    "@uniweb/semantic-parser": "^1.3.1",
-    "@uniweb/theming": "^0.1.15"
+    "@uniweb/theming": "^0.1.15",
+    "@uniweb/semantic-parser": "^1.3.1"
   },
   "scripts": {
     "test": "vitest run"

package/src/datastore.js

@@ -62,7 +62,7 @@ export default class DataStore {
    *
    * Two forms:
    *   - `subscribe(fn)`      — fires after every successful `set()` (all keys).
-   *   - `subscribe(key, fn)` — fires only when `set(key, ...)` is called.
+   *   - `subscribe(key, fn)` — fires only when `set(key, ...)` or `delete(key)` is called.
    *
    * The global form is useful for debugging / blanket observers. The keyed
    * form is what Layer-3 kit hooks (`useFetched`, `useCacheEntry`) use so
@@ -131,6 +131,29 @@ export default class DataStore {
     }
   }
 
+  /**
+   * Drop one entry, and any in-flight record for the same key.
+   *
+   * Fires the key's subscribers (and the global ones) so an observer re-reads
+   * and sees the absence, exactly as it would see a write. Exists for the case
+   * `clear()` is too blunt for: one consumer's entries must leave memory — a
+   * viewer's records at sign-out — while everything else stays warm.
+   *
+   * @param {string} key
+   * @returns {boolean} true if an entry was removed
+   */
+  delete(key) {
+    const had = this._cache.delete(key)
+    this._inflight.delete(key)
+    if (!had) return false
+    for (const fn of this._listeners) fn()
+    const keyed = this._keyedListeners.get(key)
+    if (keyed) {
+      for (const fn of keyed) fn()
+    }
+    return true
+  }
+
   /**
    * In-flight fetch registry — used by the dispatcher to dedup concurrent
    * requests and collect abort signals so the underlying fetch is cancelled

package/src/uniweb.js

@@ -88,6 +88,15 @@ export default class Uniweb {
     // `defaultInsets` above.
     this.tracking = new Tracker()
 
+    // Reserved for `@uniweb/api` — the one client instance per page. That
+    // package is bundled into each foundation, so a page with a primary
+    // foundation and extensions holds several copies of its code; the first to
+    // need a client creates one and parks it here, and every other copy adopts
+    // it instead of creating another. Core implements nothing on it: declared
+    // null so the seal permits the assignment, nothing more. Same pattern as
+    // `defaultInsets` above.
+    this.api = null
+
     Object.seal(this)
   }