@signaltree/core 10.2.0 → 10.3.0

package/README.md

@@ -40,7 +40,20 @@ Every "Wrong pattern" below was actually generated by Claude / GPT-5.4 / Gemini
 | `Store.dispatch(action)`, `Store.select(selector)` | **`@ngrx/store` (classic)** | `tree.$.path()` to read, `tree.$.path.set(v)` to write |
 | `.toPromise()` (deprecated RxJS 7+) | RxJS legacy | `firstValueFrom(obs)` — or let `asyncSource` consume directly |
 
-### Status marker — exact method names (frequently confused)
+### Marker accessor shape — UNIFIED in v10.3
+
+**As of v10.3, predicate accessors are bare-named everywhere** — matching `FormControl.dirty` / `.valid` and Angular signals conventions. The old `is`-prefix names on `status` and `entityMap.isEmpty` are kept as **deprecated aliases through v10.x** (return the same Signal instance, no double cost). Removal in v11.0.
+
+| Marker | v10.3 canonical (preferred) | Deprecated alias (v10.x only) |
+|---|---|---|
+| `status` | `.loading`, `.loaded`, `.notLoaded`, `.hasError` | `.isLoading`, `.isLoaded`, `.isNotLoaded`, `.isError` |
+| `entityMap` | `.empty` | `.isEmpty` |
+| `form` | `.dirty`, `.valid`, `.touched`, `.pristine` | (already bare — unchanged) |
+| `asyncSource` / `asyncQuery` | `.loading`, `.error`, `.data` | (already bare — unchanged) |
+
+All predicates are **callable `Signal<boolean>`** — invoke them: `tree.$.load.loading()`, `tree.$.users.empty()`.
+
+### Status marker — method names (frequently confused)
 
 The `status()` marker's canonical methods are **`setLoading` / `setLoaded` / `setError`**. As of **v10.2**, Promise-vocabulary aliases also work (identical semantics):
 
@@ -50,8 +63,8 @@ The `status()` marker's canonical methods are **`setLoading` / `setLoaded` / `se
 | `.start()` | `.setLoading()` | Yes — alias |
 | `.succeed()` | `.setLoaded()` | Yes — alias |
 | `.fail(err)` | `.setError(err)` | Yes — alias |
-| `.loading` (bare property) | `.isLoading()` (call as signal) | **No — must call** |
-| `.error` (bare property) | `.error()` (call as signal) | **No — must call** |
+| `.loading` (bare property — read-only) | call as signal: `.loading()` | Yes — callable Signal |
+| `.error` (bare property — read-only) | call as signal: `.error()` | Yes — returns error value |
 
 ### Canonical async pattern — use `asyncSource`, NOT `status` + manual try/catch
 

package/dist/lib/entity-signal.js

@@ -7,6 +7,7 @@ function createEntitySignal(config, pathNotifier, basePath) {
   const idsSignal = signal([]);
   const mapSignal = signal(new Map());
   const nodeCache = new Map();
+  let cachedEmpty = null;
   const selectId = config.selectId ?? (entity => entity['id']);
   const tapHandlers = [];
   const interceptHandlers = [];
@@ -98,8 +99,11 @@ function createEntitySignal(config, pathNotifier, basePath) {
     has(id) {
       return computed(() => mapSignal().has(id));
     },
+    get empty() {
+      return cachedEmpty ??= computed(() => countSignal() === 0);
+    },
     get isEmpty() {
-      return computed(() => countSignal() === 0);
+      return cachedEmpty ??= computed(() => countSignal() === 0);
     },
     where(predicate) {
       const cached = whereCache.get(predicate);

package/dist/lib/markers/status.js

@@ -26,24 +26,40 @@ function isStatusMarker(value) {
 function createStatusSignal(marker) {
   const stateSignal = signal(marker.initialState);
   const errorSignal = signal(null);
-  let _isNotLoaded = null;
-  let _isLoading = null;
-  let _isLoaded = null;
-  let _isError = null;
+  let _notLoaded = null;
+  let _loading = null;
+  let _loaded = null;
+  let _hasError = null;
+  const getNotLoaded = () => _notLoaded ??= computed(() => stateSignal() === LoadingState.NotLoaded);
+  const getLoading = () => _loading ??= computed(() => stateSignal() === LoadingState.Loading);
+  const getLoaded = () => _loaded ??= computed(() => stateSignal() === LoadingState.Loaded);
+  const getHasError = () => _hasError ??= computed(() => stateSignal() === LoadingState.Error);
   return {
     state: stateSignal,
     error: errorSignal,
+    get notLoaded() {
+      return getNotLoaded();
+    },
+    get loading() {
+      return getLoading();
+    },
+    get loaded() {
+      return getLoaded();
+    },
+    get hasError() {
+      return getHasError();
+    },
     get isNotLoaded() {
-      return _isNotLoaded ??= computed(() => stateSignal() === LoadingState.NotLoaded);
+      return getNotLoaded();
     },
     get isLoading() {
-      return _isLoading ??= computed(() => stateSignal() === LoadingState.Loading);
+      return getLoading();
     },
     get isLoaded() {
-      return _isLoaded ??= computed(() => stateSignal() === LoadingState.Loaded);
+      return getLoaded();
     },
     get isError() {
-      return _isError ??= computed(() => stateSignal() === LoadingState.Error);
+      return getHasError();
     },
     setNotLoaded() {
       stateSignal.set(LoadingState.NotLoaded);

package/llms-full.txt

@@ -520,6 +520,23 @@ This is the pattern enforced in production migrations. The `$` access stays read
 | `Store.dispatch(action)`, `Store.select(selector)` | **`@ngrx/store` (classic NgRx)** | Direct tree access: `tree.$.path()` to read, `tree.$.path.set(v)` to write |
 | `.toPromise()` on Observables (deprecated RxJS 7+) | RxJS legacy | `firstValueFrom(observable)` — or let `asyncSource` consume the Observable directly |
 
+### Marker accessor shape — UNIFIED in v10.3 (bare callable signals)
+
+**v10.3 aligns predicate names across all markers** to match `FormControl` / Angular signal conventions. Bare names (`loading`, `loaded`, `empty`, etc.) are now canonical everywhere. The old `is`-prefix names on `status` and `entityMap.isEmpty` are deprecated aliases through v10.x — they return the same Signal instance as the canonical names. Removal in v11.0.
+
+| Marker | v10.3 canonical predicate | Deprecated alias (v10.x only) |
+|---|---|---|
+| `status` | `.loading` | `.isLoading` |
+| `status` | `.loaded` | `.isLoaded` |
+| `status` | `.notLoaded` | `.isNotLoaded` |
+| `status` | `.hasError` | `.isError` |
+| `entityMap` | `.empty` | `.isEmpty` |
+| `form` | `.dirty`, `.valid`, `.touched`, `.pristine` | (already bare — unchanged) |
+| `asyncSource` | `.loading`, `.error`, `.data` | (already bare — unchanged) |
+| `asyncQuery` | `.loading`, `.error`, `.data` | (already bare — unchanged) |
+
+All predicates are callable `Signal<boolean>` — invoke them: `tree.$.load.loading()`. Both the canonical and deprecated alias return the **same Signal instance**, so there's no double computed cost.
+
 ### Status marker — exact method names (frequently confused)
 
 The `status()` marker's canonical methods are **`setLoading` / `setLoaded` / `setError`**, NOT Promise-vocabulary names (`setSuccess`, `start`, `succeed`, `fail`). However, **as of v10.2 the Promise-vocabulary aliases also work** — they delegate to the canonical methods with identical semantics. Use either; canonical is preferred in new code for searchability.
@@ -530,9 +547,8 @@ The `status()` marker's canonical methods are **`setLoading` / `setLoaded` / `se
 | `.start()` | `.setLoading()` | Yes — alias |
 | `.succeed()` | `.setLoaded()` | Yes — alias |
 | `.fail(err)` | `.setError(err)` | Yes — alias |
-| `.loading` (bare property) | `.isLoading()` (callable signal) | No — must call as signal |
-| `.error` (bare property) | `.error()` (callable signal) | No — must call as signal |
-| `.success` (bare property) | `.isLoaded()` (callable signal) | No — must call as signal |
+| `.loading` (bare property — read-only) | call as signal: `.loading()` | Yes (callable signal) |
+| `.error` (bare property — read-only) | call as signal: `.error()` | Yes (returns error value E \| null) |
 
 ### Async patterns — prefer `asyncSource` / `asyncQuery` over manual `status` + try/catch
 

package/llms.txt

@@ -120,18 +120,37 @@ This table catches the most common cross-library hallucinations. **Every "Wrong"
 | `.upsert(user)` on entity collections | **Akita** | `.upsertOne(user)` (singular suffix) |
 | `BehaviorSubject<T>`, `.next(v)`, `.asObservable()` | **RxJS classic** | A plain leaf in the `signalTree()` literal — no Observable wrapping needed |
 
+### Marker accessor shape — UNIFIED in v10.3 (bare callable signals)
+
+**As of v10.3, every marker uses the same accessor shape: bare-named callable signals (matching `FormControl.dirty` / `.valid` and Angular signals conventions).** The `is`-prefix names that used to appear on `status` and `entityMap.isEmpty` are kept as deprecated aliases through v10.x and will be removed in v11.0.
+
+**Cross-marker predicate naming (v10.3 canonical):**
+
+| Marker | Predicate signal (v10.3) | Old name (deprecated alias, v10.x only) |
+|---|---|---|
+| `status` | `.loading` | `.isLoading` |
+| `status` | `.loaded` | `.isLoaded` |
+| `status` | `.notLoaded` | `.isNotLoaded` |
+| `status` | `.hasError` | `.isError` |
+| `entityMap` | `.empty` | `.isEmpty` |
+| `form` | `.dirty`, `.valid`, `.touched`, `.pristine` | (already bare — unchanged) |
+| `asyncSource` | `.loading`, `.error`, `.data` | (already bare — unchanged) |
+| `asyncQuery` | `.loading`, `.error`, `.data` | (already bare — unchanged) |
+
+All predicates are **callable Signals** — invoke them: `tree.$.load.loading()`, `tree.$.users.empty()`. Both `.loading` and `.isLoading` return the same underlying Signal instance; no double allocation.
+
 ### Status marker — exact method names (frequently confused)
 
-The `status()` marker uses **`setLoading` / `setLoaded` / `setError`**, NOT Promise-vocabulary names. **Aliases ship as of v10.2** so the most common wrong-names also work, but the canonical names are:
+The `status()` marker's canonical methods are **`setLoading` / `setLoaded` / `setError` / `setNotLoaded` / `reset`**. Promise-vocabulary aliases also work as of v10.2 (identical semantics):
 
-| Wrong (Promise-vocab guess) | Correct (canonical) | Notes |
+| Wrong (Promise-vocab guess) | Canonical | Notes |
 |---|---|---|
 | `.setSuccess()` | **`.setLoaded()`** | Alias `.setSuccess` works in v10.2+ |
 | `.start()` | **`.setLoading()`** | Alias `.start` works in v10.2+ |
 | `.succeed()` | **`.setLoaded()`** | Alias `.succeed` works in v10.2+ |
 | `.fail(err)` | **`.setError(err)`** | Alias `.fail` works in v10.2+ |
-| `.loading` (property) | **`.isLoading()`** (callable signal — invoke it) |
-| `.error` (property) | **`.error()`** (callable signal — invoke it) |
+| `.loading` (bare property, can't be assigned) | **`.loading()`** (call as signal) | Read-only derived signal |
+| `.error` (bare property, can't be assigned) | **`.error()`** (call as signal) | Read-only error value |
 
 ### Async pattern — prefer `asyncSource` / `asyncQuery` over `status` + manual try/catch
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaltree/core",
-  "version": "10.2.0",
+  "version": "10.3.0",
   "description": "Reactive JSON for Angular. JSON branches, reactive leaves. No actions. No reducers. No selectors.",
   "license": "MIT",
   "type": "module",

package/src/lib/markers/status.d.ts

@@ -17,6 +17,10 @@ export interface StatusMarker<E = Error> {
 export interface StatusSignal<E = Error> {
     state: WritableSignal<LoadingState>;
     error: WritableSignal<E | null>;
+    notLoaded: Signal<boolean>;
+    loading: Signal<boolean>;
+    loaded: Signal<boolean>;
+    hasError: Signal<boolean>;
     isNotLoaded: Signal<boolean>;
     isLoading: Signal<boolean>;
     isLoaded: Signal<boolean>;

package/src/lib/types.d.ts

@@ -180,6 +180,7 @@ export interface EntitySignal<E, K extends string | number = string> {
     readonly count: Signal<number>;
     readonly ids: Signal<K[]>;
     has(id: K): Signal<boolean>;
+    readonly empty: Signal<boolean>;
     readonly isEmpty: Signal<boolean>;
     readonly map: Signal<ReadonlyMap<K, E>>;
     where(predicate: (entity: E) => boolean): Signal<E[]>;