@nisli/core 0.54.0 → 0.55.0

package/dist/emitter.d.ts

@@ -18,6 +18,7 @@
  * ```
  */
 import { type Signal } from './signal.js';
+import { type Disposer } from './disposable.js';
 type EventMap = Record<string, unknown>;
 type Listener<T> = (payload: T) => void;
 export declare class Emitter<Events extends EventMap> {
@@ -33,7 +34,7 @@ export declare class Emitter<Events extends EventMap> {
      * If called during component setup, the subscription is automatically
      * disposed on disconnectedCallback.
      */
-    on<K extends keyof Events>(event: K, fn: Listener<Events[K]>): () => void;
+    on<K extends keyof Events>(event: K, fn: Listener<Events[K]>): Disposer;
     /**
      * Bridge an event into the signal system.
      * Returns a signal that updates whenever the event fires.

package/dist/emitter.js

@@ -19,6 +19,7 @@
  */
 import { signal } from './signal.js';
 import { hasContext, getCurrentComponent } from './context.js';
+import { disposable } from './disposable.js';
 // ── Emitter base class ──────────────────────────────────────────────
 export class Emitter {
     listeners = new Map();
@@ -63,7 +64,7 @@ export class Emitter {
         if (hasContext()) {
             getCurrentComponent().addDisposer(unsubscribe);
         }
-        return unsubscribe;
+        return disposable(unsubscribe, unsubscribe);
     }
     /**
      * Bridge an event into the signal system.

package/dist/emitter.js.map

@@ -1 +1 @@
-{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,MAAM,EAAe,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAO/D,uEAAuE;AAEvE,MAAM,OAAO,OAAO;IACV,SAAS,GAAG,IAAI,GAAG,EAAoC,CAAC;IAEhE;;;OAGG;IACH,IAAI,CAAyB,KAAQ,EAAE,OAAkB;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO;QAEjB,sDAAsD;QACtD,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,EAAE,CAAC,OAAO,CAAC,CAAC;YACd,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,EAAE,CAAyB,KAAQ,EAAE,EAAuB;QAC1D,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEZ,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,GAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAChB,IAAI,GAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC;QAEF,iDAAiD;QACjD,IAAI,UAAU,EAAE,EAAE,CAAC;YACjB,mBAAmB,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CACN,KAAQ,EACR,QAAmC,EACnC,OAAU;QAEV,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACzB,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,MAAM,EAAe,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAiB,MAAM,iBAAiB,CAAC;AAO5D,uEAAuE;AAEvE,MAAM,OAAO,OAAO;IACV,SAAS,GAAG,IAAI,GAAG,EAAoC,CAAC;IAEhE;;;OAGG;IACH,IAAI,CAAyB,KAAQ,EAAE,OAAkB;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO;QAEjB,sDAAsD;QACtD,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,EAAE,CAAC,OAAO,CAAC,CAAC;YACd,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,EAAE,CAAyB,KAAQ,EAAE,EAAuB;QAC1D,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEZ,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,GAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAChB,IAAI,GAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC;QAEF,iDAAiD;QACjD,IAAI,UAAU,EAAE,EAAE,CAAC;YACjB,mBAAmB,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,UAAU,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CACN,KAAQ,EACR,QAAmC,EACnC,OAAU;QAEV,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACzB,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/hmr/registry.js

@@ -57,12 +57,19 @@ export function __register(tag, setup) {
         if (!suppressAutoDrain)
             scheduleRemount();
     }
-    return (props, host) => {
+    const thunk = (props, host) => {
         const current = registry.get(tag);
         if (!current)
             throw new Error(`[nisli-hmr] no setup registered for <${tag}>`);
         return current(props, host);
     };
+    // N201 exemption marker (ADR 0030.2 §3/§8): component() throws a coded dev
+    // error on duplicate `define`, EXCEPT when the incoming setup is a registry
+    // thunk — an HMR re-evaluation of the same module re-calling component() is
+    // the swap mechanism working, not a second definer. The marker rides the
+    // thunk itself so component.ts needs no import from this dev-only module.
+    thunk.__nisliHmr = true;
+    return thunk;
 }
 /** Number of tags awaiting a re-mount (for orchestration/tests). */
 export function pendingRemountCount() {

package/dist/hmr/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/hmr/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,uEAAuE;AAEvE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;AAE7C,0EAA0E;AAC1E,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;AAC1C,IAAI,gBAAgB,GAAG,KAAK,CAAC;AAE7B;;;;;GAKG;AACH,IAAI,iBAAiB,GAAG,KAAK,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,iBAAiB,GAAG,IAAI,CAAC;IACzB,gBAAgB,GAAG,KAAK,CAAC;AAC3B,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc;IAC5B,iBAAiB,GAAG,KAAK,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,KAAe;IACrD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACzC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,iBAAiB;YAAE,eAAe,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,KAAc,EAAE,IAAiB,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,GAAG,GAAG,CAAC,CAAC;QAC9E,OAAO,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,mBAAmB;IACjC,OAAO,eAAe,CAAC,IAAI,CAAC;AAC9B,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,aAAa;IAC3B,MAAM,IAAI,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC;IAClC,eAAe,CAAC,KAAK,EAAE,CAAC;IACxB,gBAAgB,GAAG,KAAK,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,gBAAgB;QAAE,OAAO;IAC7B,gBAAgB,GAAG,IAAI,CAAC;IACxB,wEAAwE;IACxE,cAAc,CAAC,GAAG,EAAE;QAClB,IAAI,gBAAgB;YAAE,aAAa,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AAEvE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAChD,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,EAAE,GAAG,IAAyB,CAAC;QACrC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;YAChB,EAAE,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QACD,uEAAuE;QACvE,2CAA2C;QAC3C,EAAE,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAC5B,wEAAwE;QACxE,EAAE,CAAC,eAAe,EAAE,CAAC;QACrB,gDAAgD;QAChD,EAAE,CAAC,iBAAiB,EAAE,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,eAAe;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjB,eAAe,CAAC,KAAK,EAAE,CAAC;IACxB,gBAAgB,GAAG,KAAK,CAAC;IACzB,iBAAiB,GAAG,KAAK,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/hmr/registry.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -13,15 +13,17 @@
  * } from './framework';
  * ```
  */
-export { signal, computed, effect, flush, tick, isSignal, flushEffects, untrack, SIGNAL_BRAND, type Signal, type ReadonlySignal, } from './signal.js';
+export { signal, computed, effect, flush, tick, isSignal, flushEffects, untrack, SIGNAL_BRAND, type Signal, type ReadonlySignal, type Disposer, } from './signal.js';
 export { runWithContext, getCurrentComponent, hasContext, type ComponentHost, } from './context.js';
 export { Emitter } from './emitter.js';
 export { inject, provide, createToken, resetInjector, type Constructor, type InjectionToken, } from './injector.js';
 export { createContext, type Context, type Inject, } from './element-context.js';
 export { component, type ReactiveProps, type AttrValueType, type SetupFunction, type ComponentFactory, type ComponentOptions, type AttrDecl, type ComponentAttrs, type PropInput, type HostAttrs, } from './component.js';
-export { html, el, when, each, type TemplateResult, type TypedEventHandler, type ElProps, type ElChild, } from './template.js';
+export { html, el, when, each, raw, sanitized, setSanitizerFallback, type RawHtml, type SanitizedHtml, type SanitizerFallback, type TemplateResult, type TypedEventHandler, type ElProps, type ElChild, } from './template.js';
 export { ref, isRef, type Ref, } from './ref.js';
 export { onMount, onCleanup, useHostEvent, } from './lifecycle.js';
 export { children, } from './projection.js';
-export { query, QueryClient, type QueryResult, type QueryOptions, } from './query.js';
+export { query, QueryClient, type QueryResult, type QueryOptions, type QueryKey, type QueryKeyElement, type QueryStatus, type QueryFetcher, } from './query.js';
 export { resource, type ResourceResult, } from './resource.js';
+export { settle } from './settle.js';
+export { viewTransition, type ViewTransitionOptions, } from './view-transition.js';

package/dist/index.js

@@ -26,15 +26,19 @@ export { createContext, } from './element-context.js';
 // ── Component model ─────────────────────────────────────────────────
 export { component, } from './component.js';
 // ── Template engine ─────────────────────────────────────────────────
-export { html, el, when, each, } from './template.js';
+export { html, el, when, each, raw, sanitized, setSanitizerFallback, } from './template.js';
 // ── Element refs ────────────────────────────────────────────────────
 export { ref, isRef, } from './ref.js';
 // ── Lifecycle hooks ─────────────────────────────────────────────────
 export { onMount, onCleanup, useHostEvent, } from './lifecycle.js';
 // ── Content projection (ADR 0025 item 1) ────────────────
 export { children, } from './projection.js';
-// ── Declarative data loading ────────────────────────────────────────
+// ── Declarative data loading (keyed logical-request store) ──────────
 export { query, QueryClient, } from './query.js';
 // ── Local async derivations ─────────────────────────────────────────
 export { resource, } from './resource.js';
+// ── Async quiescence (test/verify + SSG pre-snapshot barrier) ───────
+export { settle } from './settle.js';
+// ── View Transitions (opt-in wrapper over the synchronous flush) ────
+export { viewTransition, } from './view-transition.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,uEAAuE;AACvE,OAAO,EACL,MAAM,EACN,QAAQ,EACR,MAAM,EACN,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,YAAY,GAGb,MAAM,aAAa,CAAC;AAErB,uEAAuE;AACvE,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,UAAU,GAEX,MAAM,cAAc,CAAC;AAEtB,uEAAuE;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,uEAAuE;AACvE,OAAO,EACL,MAAM,EACN,OAAO,EACP,WAAW,EACX,aAAa,GAGd,MAAM,eAAe,CAAC;AAEvB,uEAAuE;AACvE,OAAO,EACL,aAAa,GAGd,MAAM,sBAAsB,CAAC;AAE9B,uEAAuE;AACvE,OAAO,EACL,SAAS,GAUV,MAAM,gBAAgB,CAAC;AAExB,uEAAuE;AACvE,OAAO,EACL,IAAI,EACJ,EAAE,EACF,IAAI,EACJ,IAAI,GAKL,MAAM,eAAe,CAAC;AAEvB,uEAAuE;AACvE,OAAO,EACL,GAAG,EACH,KAAK,GAEN,MAAM,UAAU,CAAC;AAElB,uEAAuE;AACvE,OAAO,EACL,OAAO,EACP,SAAS,EACT,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,2DAA2D;AAC3D,OAAO,EACL,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,uEAAuE;AACvE,OAAO,EACL,KAAK,EACL,WAAW,GAGZ,MAAM,YAAY,CAAC;AAEpB,uEAAuE;AACvE,OAAO,EACL,QAAQ,GAET,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,uEAAuE;AACvE,OAAO,EACL,MAAM,EACN,QAAQ,EACR,MAAM,EACN,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,YAAY,GAIb,MAAM,aAAa,CAAC;AAErB,uEAAuE;AACvE,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,UAAU,GAEX,MAAM,cAAc,CAAC;AAEtB,uEAAuE;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,uEAAuE;AACvE,OAAO,EACL,MAAM,EACN,OAAO,EACP,WAAW,EACX,aAAa,GAGd,MAAM,eAAe,CAAC;AAEvB,uEAAuE;AACvE,OAAO,EACL,aAAa,GAGd,MAAM,sBAAsB,CAAC;AAE9B,uEAAuE;AACvE,OAAO,EACL,SAAS,GAUV,MAAM,gBAAgB,CAAC;AAExB,uEAAuE;AACvE,OAAO,EACL,IAAI,EACJ,EAAE,EACF,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,SAAS,EACT,oBAAoB,GAQrB,MAAM,eAAe,CAAC;AAEvB,uEAAuE;AACvE,OAAO,EACL,GAAG,EACH,KAAK,GAEN,MAAM,UAAU,CAAC;AAElB,uEAAuE;AACvE,OAAO,EACL,OAAO,EACP,SAAS,EACT,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,2DAA2D;AAC3D,OAAO,EACL,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,uEAAuE;AACvE,OAAO,EACL,KAAK,EACL,WAAW,GAOZ,MAAM,YAAY,CAAC;AAEpB,uEAAuE;AACvE,OAAO,EACL,QAAQ,GAET,MAAM,eAAe,CAAC;AAEvB,uEAAuE;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,uEAAuE;AACvE,OAAO,EACL,cAAc,GAEf,MAAM,sBAAsB,CAAC"}

package/dist/injector.d.ts

@@ -42,8 +42,13 @@ export declare function inject<T>(token: InjectionToken<T>): T;
  * Register a factory override for a class or token.
  * The factory will be called on the next inject() if no cached instance exists.
  *
- * Call provide() before the first inject() of that token.
- * To override in tests, call resetInjector() first.
+ * Call provide() before the first inject() of that token. Once a token has
+ * been instantiated the injector is FROZEN for it (dev, coded error N501):
+ * everything that already injected holds the old instance while later
+ * inject() calls would get the new one — a silent mixed-instance split
+ * (ADR 0030.2 §3). `resetInjector()` is the escape hatch (tests use it).
+ * Production keeps the historical silent replace so a live page never breaks
+ * over an ordering issue that dev already surfaced.
  */
 export declare function provide<T>(token: Constructor<T>, factory: () => T): void;
 export declare function provide<T>(token: InjectionToken<T>, factory: () => T): void;
@@ -58,6 +63,8 @@ export declare function provide<T>(token: InjectionToken<T>, factory: () => T):
  * ```
  */
 export declare function createToken<T>(name: string, defaultFactory?: () => T): InjectionToken<T>;
+/** @internal Register a hook run by every resetInjector() call. */
+export declare function registerResetHook(hook: () => void): void;
 /**
  * Reset the injector — clears all singletons and factory overrides.
  * Used in tests to ensure isolation between test cases.

package/dist/injector.js

@@ -18,6 +18,7 @@
  * ```
  */
 import { hasContext, getCurrentComponent } from './context.js';
+import { formatDiag, isDev } from './diagnostics.js';
 // ── Global singleton registry ───────────────────────────────────────
 /** Stores singleton instances keyed by constructor or token. */
 const singletonCache = new Map();
@@ -67,6 +68,13 @@ export function inject(token) {
     }
 }
 export function provide(token, factory) {
+    if (isDev() && singletonCache.has(token)) {
+        const name = typeof token === 'function' ? token.name : token.name;
+        throw new Error(formatDiag('N501', `provide(${name}) after '${name}' was already instantiated — existing `
+            + `consumers keep the old instance while new inject() calls would get the `
+            + `new one (mixed-instance split). Call resetInjector() first (tests), or `
+            + `provide() before the first inject().`));
+    }
     factoryOverrides.set(token, factory);
     // Remove cached instance so next inject() uses the new factory
     singletonCache.delete(token);
@@ -88,6 +96,14 @@ export function createToken(name, defaultFactory) {
         _factory: defaultFactory,
     };
 }
+// Hooks run by resetInjector() — module-level caches elsewhere (settle's
+// pending registry) stay test-isolated without upside-down imports: those
+// modules import the injector and self-register, never the reverse.
+const resetHooks = new Set();
+/** @internal Register a hook run by every resetInjector() call. */
+export function registerResetHook(hook) {
+    resetHooks.add(hook);
+}
 /**
  * Reset the injector — clears all singletons and factory overrides.
  * Used in tests to ensure isolation between test cases.
@@ -96,5 +112,7 @@ export function resetInjector() {
     singletonCache.clear();
     factoryOverrides.clear();
     instantiating.clear();
+    for (const hook of resetHooks)
+        hook();
 }
 //# sourceMappingURL=injector.js.map

package/dist/injector.js.map

@@ -1 +1 @@
-{"version":3,"file":"injector.js","sourceRoot":"","sources":["../src/injector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAe/D,uEAAuE;AAEvE,gEAAgE;AAChE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkD,CAAC;AAEjF,+CAA+C;AAC/C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAwD,CAAC;AAEzF,uFAAuF;AACvF,MAAM,aAAa,GAAG,IAAI,GAAG,EAAyC,CAAC;AAgBvE,MAAM,UAAU,MAAM,CAAI,KAAyC;IACjE,oBAAoB;IACpB,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,CAAM,CAAC;IACxC,CAAC;IAED,gCAAgC;IAChC,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,KAA2B,CAAC,IAAI,CAAC;QAC1F,MAAM,IAAI,KAAK,CACb,oDAAoD,IAAI,KAAK;YAC7D,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,CAAC;QACH,IAAI,QAAW,CAAC;QAEhB,6BAA6B;QAC7B,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAA8C,CAAC,CAAC;QACrF,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,GAAG,OAAO,EAAO,CAAC;QAC5B,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YACvC,4CAA4C;YAC5C,QAAQ,GAAG,IAAK,KAAwB,EAAE,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,sCAAsC;YACtC,MAAM,QAAQ,GAAG,KAA0B,CAAC;YAC5C,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACtB,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CACb,gCAAgC,QAAQ,CAAC,IAAI,KAAK;oBAClD,8DAA8D,CAC/D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,KAA8C,EAAE,QAAQ,CAAC,CAAC;QAC7E,OAAO,QAAQ,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAWD,MAAM,UAAU,OAAO,CAAI,KAAyC,EAAE,OAAgB;IACpF,gBAAgB,CAAC,GAAG,CAAC,KAA8C,EAAE,OAAO,CAAC,CAAC;IAC9E,+DAA+D;IAC/D,cAAc,CAAC,MAAM,CAAC,KAA8C,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAI,IAAY,EAAE,cAAwB;IACnE,OAAO;QACL,OAAO,EAAE,gBAAyB;QAClC,IAAI;QACJ,QAAQ,EAAE,cAAc;KACzB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,cAAc,CAAC,KAAK,EAAE,CAAC;IACvB,gBAAgB,CAAC,KAAK,EAAE,CAAC;IACzB,aAAa,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC"}
+{"version":3,"file":"injector.js","sourceRoot":"","sources":["../src/injector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAerD,uEAAuE;AAEvE,gEAAgE;AAChE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkD,CAAC;AAEjF,+CAA+C;AAC/C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAwD,CAAC;AAEzF,uFAAuF;AACvF,MAAM,aAAa,GAAG,IAAI,GAAG,EAAyC,CAAC;AAgBvE,MAAM,UAAU,MAAM,CAAI,KAAyC;IACjE,oBAAoB;IACpB,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,CAAM,CAAC;IACxC,CAAC;IAED,gCAAgC;IAChC,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,KAA2B,CAAC,IAAI,CAAC;QAC1F,MAAM,IAAI,KAAK,CACb,oDAAoD,IAAI,KAAK;YAC7D,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,CAAC;QACH,IAAI,QAAW,CAAC;QAEhB,6BAA6B;QAC7B,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAA8C,CAAC,CAAC;QACrF,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,GAAG,OAAO,EAAO,CAAC;QAC5B,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YACvC,4CAA4C;YAC5C,QAAQ,GAAG,IAAK,KAAwB,EAAE,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,sCAAsC;YACtC,MAAM,QAAQ,GAAG,KAA0B,CAAC;YAC5C,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACtB,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CACb,gCAAgC,QAAQ,CAAC,IAAI,KAAK;oBAClD,8DAA8D,CAC/D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,KAA8C,EAAE,QAAQ,CAAC,CAAC;QAC7E,OAAO,QAAQ,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAgBD,MAAM,UAAU,OAAO,CAAI,KAAyC,EAAE,OAAgB;IACpF,IAAI,KAAK,EAAE,IAAI,cAAc,CAAC,GAAG,CAAC,KAA8C,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,KAA2B,CAAC,IAAI,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,UAAU,CACxB,MAAM,EACN,WAAW,IAAI,YAAY,IAAI,wCAAwC;cACrE,yEAAyE;cACzE,yEAAyE;cACzE,sCAAsC,CACzC,CAAC,CAAC;IACL,CAAC;IACD,gBAAgB,CAAC,GAAG,CAAC,KAA8C,EAAE,OAAO,CAAC,CAAC;IAC9E,+DAA+D;IAC/D,cAAc,CAAC,MAAM,CAAC,KAA8C,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAI,IAAY,EAAE,cAAwB;IACnE,OAAO;QACL,OAAO,EAAE,gBAAyB;QAClC,IAAI;QACJ,QAAQ,EAAE,cAAc;KACzB,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,0EAA0E;AAC1E,oEAAoE;AACpE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAc,CAAC;AAEzC,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAChD,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,cAAc,CAAC,KAAK,EAAE,CAAC;IACvB,gBAAgB,CAAC,KAAK,EAAE,CAAC;IACzB,aAAa,CAAC,KAAK,EAAE,CAAC;IACtB,KAAK,MAAM,IAAI,IAAI,UAAU;QAAE,IAAI,EAAE,CAAC;AACxC,CAAC"}

package/dist/lifecycle.d.ts

@@ -52,6 +52,15 @@ export declare function useHostEvent<E extends Event = Event>(target: EventTarge
 /**
  * Run all registered mount callbacks for a component host.
  * Called by component.ts after the template is mounted to the DOM.
+ *
+ * A throw here PROPAGATES to component.ts's containment boundary — the SAME
+ * boundary as a setup throw (ADR 0030.2 T6, code N402): remaining callbacks
+ * are skipped, the partial scope (including cleanups already registered by
+ * earlier callbacks) is disposed, the error fallback renders, and the host is
+ * stamped `data-nisli-error`. The pre-T6 behavior (console-and-limp per
+ * callback) left a half-mounted component alive with no machine-readable
+ * trace and no teardown — the one containment semantics setup already had
+ * (issue 0010) now covers mount too.
  * @internal
  */
 export declare function runMountCallbacks(comp: object): void;

package/dist/lifecycle.js

@@ -83,25 +83,35 @@ export function useHostEvent(target, eventName, handler) {
 /**
  * Run all registered mount callbacks for a component host.
  * Called by component.ts after the template is mounted to the DOM.
+ *
+ * A throw here PROPAGATES to component.ts's containment boundary — the SAME
+ * boundary as a setup throw (ADR 0030.2 T6, code N402): remaining callbacks
+ * are skipped, the partial scope (including cleanups already registered by
+ * earlier callbacks) is disposed, the error fallback renders, and the host is
+ * stamped `data-nisli-error`. The pre-T6 behavior (console-and-limp per
+ * callback) left a half-mounted component alive with no machine-readable
+ * trace and no teardown — the one containment semantics setup already had
+ * (issue 0010) now covers mount too.
  * @internal
  */
 export function runMountCallbacks(comp) {
     const callbacks = mountCallbacks.get(comp);
     if (!callbacks)
         return;
-    for (const cb of callbacks) {
-        try {
+    try {
+        for (const cb of callbacks) {
             const cleanup = cb();
             if (typeof cleanup === 'function') {
                 // Register cleanup as a disposer on the component
                 comp.addDisposer(cleanup);
             }
         }
-        catch (err) {
-            console.error('onMount callback error:', err);
-        }
     }
-    // Clear — mount callbacks run once
-    mountCallbacks.delete(comp);
+    finally {
+        // Clear — mount callbacks run once (also when a throw contains the scope:
+        // the boundary re-runs setup from scratch on the next mount, which
+        // re-registers a fresh callback list).
+        mountCallbacks.delete(comp);
+    }
 }
 //# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE/D,uEAAuE;AAEvE,wFAAwF;AACxF,MAAM,cAAc,GAAG,IAAI,OAAO,EAAyC,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,QAAmC;IACzD,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,oCAAoC;YACpC,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;IACnC,IAAI,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,EAAE,CAAC;QACf,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACtC,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,QAAoB;IAC5C,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,sCAAsC;YACtC,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,mBAAmB,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAmB,EACnB,SAAiB,EACjB,OAA2B;IAE3B,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,yCAAyC;YACzC,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAwB,CAAC,CAAC;IAC7D,mBAAmB,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QACrC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAwB,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS;QAAE,OAAO;IAEvB,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,EAAE,CAAC;YACrB,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,kDAAkD;gBACjD,IAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE/D,uEAAuE;AAEvE,wFAAwF;AACxF,MAAM,cAAc,GAAG,IAAI,OAAO,EAAyC,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,QAAmC;IACzD,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,oCAAoC;YACpC,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;IACnC,IAAI,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,EAAE,CAAC;QACf,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACtC,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,QAAoB;IAC5C,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,sCAAsC;YACtC,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,mBAAmB,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAmB,EACnB,SAAiB,EACjB,OAA2B;IAE3B,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,yCAAyC;YACzC,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAwB,CAAC,CAAC;IAC7D,mBAAmB,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QACrC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAwB,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS;QAAE,OAAO;IAEvB,IAAI,CAAC;QACH,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,EAAE,EAAE,CAAC;YACrB,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,kDAAkD;gBACjD,IAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,0EAA0E;QAC1E,mEAAmE;QACnE,uCAAuC;QACvC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/projection.js

@@ -34,7 +34,7 @@
  * has any, and only children() consumes them.
  */
 import { getCurrentComponent } from './context.js';
-import { onMount, onCleanup } from './lifecycle.js';
+import { onCleanup } from './lifecycle.js';
 import { signal, computed, flush } from './signal.js';
 /** True if the nodes carry meaningful content (element or non-blank text). */
 function isMeaningful(nodes) {
@@ -63,11 +63,9 @@ function textTemplate(text) {
 }
 /**
  * Normalize a slot value so the template ALWAYS sees a TemplateResult / factory
- * / array / null — never a bare primitive. The engine picks the slot binding
- * kind by probing the FIRST value: a bare string would bind a plain text node,
- * which then can't host a later template child (it stringifies to
- * "[object Object]"). Wrapping primitives keeps the slot a reactive-template
- * slot for its whole life.
+ * / array / null — never a bare primitive. Projection values may be detached
+ * and reinserted as fallback/light-DOM ownership changes, so wrapping primitive
+ * text keeps that projection value explicitly re-mountable.
  */
 function asSlot(value) {
     if (value == null || value === '')
@@ -100,18 +98,37 @@ export function children(fallback) {
     const childrenProp = host._propSignal ? host._propSignal('children') : undefined;
     // Projected light-DOM nodes; grows when the late-parser sweep finds more.
     const projectedNodes = signal(captured);
+    // True once this setup scope has been disposed (true disconnect, HMR
+    // teardown, OR the containment boundary tearing down a failed mount). The
+    // queued sweep below must then no-op: it would otherwise misread the
+    // post-teardown host children (restored light DOM, or the error fallback)
+    // as "late" and relocate them into a dead slot.
+    let disposed = false;
     // A true disconnect/HMR teardown clears the component-owned rendered tree
     // before setup runs again. Hand the plain light-DOM nodes back to component.ts
     // so it can restore them as direct host children for the next capture.
     onCleanup(() => {
+        disposed = true;
         const nodes = projectedNodes.value;
         host.__capturedChildren = nodes.length ? nodes : undefined;
     });
-    onMount(() => {
-        // The host's direct children right after mount are the rendered template
-        // roots. Anything that appears later is a late parser/innerHTML child.
+    // LATE-CHILDREN SWEEP — scheduled by component.ts's dedicated projection
+    // phase (ADR 0030.2 §3), which runs after the template is committed and
+    // BEFORE any onMount callback. Pre-0030.2 this was registered via
+    // children()'s own onMount, so the rendered-roots snapshot depended on
+    // where children() sat relative to other onMount() registrations (the 0025
+    // batch-3B ordering trap). Hoisting the SCHEDULING makes the rule
+    // universal: the snapshot is exactly the rendered template roots, and
+    // anything appearing after it — late parser/innerHTML children AND onMount
+    // host-appends — classifies as projected content. Only scheduling moved;
+    // the prop READ path (the computed below) is unchanged.
+    host.__nisliProjectionSweep = () => {
+        // The host's direct children at phase time are the rendered template
+        // roots. Anything that appears later is late projected content.
         const renderedRoots = new Set(Array.from(host.childNodes));
         queueMicrotask(() => {
+            if (disposed)
+                return; // scope torn down before the sweep ran
             const late = Array.from(host.childNodes).filter((n) => !renderedRoots.has(n));
             if (late.length && isMeaningful(late)) {
                 for (const node of late)
@@ -123,7 +140,7 @@ export function children(fallback) {
                 flush();
             }
         });
-    });
+    };
     // Stable, RE-MOUNTABLE fallback slot: the same slot object is returned on
     // every empty render, and it can be mounted → unmounted → mounted again
     // (empty → filled → empty) without crashing. A string wraps to a fresh text

package/dist/projection.js.map

@@ -1 +1 @@
-{"version":3,"file":"projection.js","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAoC,MAAM,aAAa,CAAC;AAGxF,8EAA8E;AAC9E,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,IAAI,CACf,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CACrF,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO;QACL,gBAAgB,EAAE,IAAI;QACtB,KAAK,CAAC,CAAc;YAClB,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,KAAkE,CAAC;KAC9C,CAAC;AACjC,CAAC;AAED,mFAAmF;AACnF,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO;QACL,gBAAgB,EAAE,IAAI;QACtB,KAAK,CAAC,CAAc;YAClB,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,KAAyC,CAAC;KACrB,CAAC;AACjC,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC/C,IACE,OAAO,KAAK,KAAK,QAAQ;WACtB,CAAC,kBAAkB,IAAK,KAAgB,IAAI,QAAQ,IAAK,KAAgB,CAAC,EAC7E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAkC;IACzD,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC,OAGlC,CAAC;IAEF,4EAA4E;IAC5E,mDAAmD;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,IAAI,EAAE,CAAC;IAC/C,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;YAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,gFAAgF;IAChF,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,0EAA0E;IAC1E,MAAM,cAAc,GAAG,MAAM,CAAS,QAAQ,CAAC,CAAC;IAEhD,0EAA0E;IAC1E,+EAA+E;IAC/E,uEAAuE;IACvE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;QACnC,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,EAAE;QACX,yEAAyE;QACzE,uEAAuE;QACvE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QACjE,cAAc,CAAC,GAAG,EAAE;YAClB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9E,IAAI,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,KAAK,MAAM,IAAI,IAAI,IAAI;oBAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAChD,cAAc,CAAC,KAAK,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;gBAC1D,mEAAmE;gBACnE,kEAAkE;gBAClE,mEAAmE;gBACnE,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,wEAAwE;IACxE,4EAA4E;IAC5E,yEAAyE;IACzE,4EAA4E;IAC5E,6EAA6E;IAC7E,sDAAsD;IACtD,IAAI,YAAY,GAAY,IAAI,CAAC;IACjC,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,QAAQ,CAAC,sBAAsB,EAAE,CAAC;YACjD,QAAQ,CAAC,KAAK,CAAC,MAAgC,CAAC,CAAC;YACjD,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACpD,SAAS,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;gBAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAAC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5E,YAAY,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,yEAAyE;IACzE,OAAO,QAAQ,CAAC,GAAG,EAAE;QACnB,MAAM,IAAI,GAAG,YAAY,EAAE,KAAK,CAAC;QACjC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,EAAE;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;QACnC,IAAI,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QACrD,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"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"}

package/dist/query.d.ts

@@ -1,85 +1,164 @@
 /**
- * query.ts — Declarative async data loading with cache
+ * query.ts — Keyed logical-request store (ADR 0030.2 T1).
  *
- * `query()` absorbs the loading/error/cache/refetch boilerplate that
- * every data-fetching component would otherwise write manually.
- *
- * Inspired by TanStack Query / React Query, but built on signals.
+ * The cache unit is a per-key RECORD living in `QueryClient`:
+ * `{data, error, status, fetchedAt}` as signals, plus exactly one `run()`
+ * owning the retry loop, a per-run `AbortController` handed to the fetcher,
+ * and the cache commit. `query()` is a thin OBSERVER: an effect keeps it
+ * registered on the record its current key points at, and its outputs are
+ * `computed()` views over that record. Dedup unit = logical request, by
+ * construction (issues 0005–0009 close as a class).
  *
  * ```ts
  * const tasks = query(
  *   () => ['tasks', scopeId.value],
- *   () => api.getTasks(scopeId.value),
+ *   (signal) => api.getTasks(scopeId.value, { signal }),
  * );
- * tasks.data      // Signal<Task[] | undefined>
- * tasks.loading   // Signal<boolean>
- * tasks.error     // Signal<Error | null>
- * tasks.refetch() // manual refetch
+ * tasks.data      // ReadonlySignal<Task[] | undefined>
+ * tasks.loading   // ReadonlySignal<boolean>
+ * tasks.error     // ReadonlySignal<Error | null>
+ * tasks.status    // ReadonlySignal<'idle' | 'loading' | 'success' | 'error'>
+ * tasks.refetch() // force a refetch (joins an in-flight run)
+ * tasks.dispose() // standalone callers; component setup auto-disposes
  * ```
+ *
+ * Ownership rules (ADR 0030.2 §8, binding):
+ * - The most-recently-mounted enabled observer's fetcher/options own the
+ *   next run for a shared key; `staleTime` freshness is per-observer POLICY
+ *   (it decides whether *that* observer triggers a run), while the record
+ *   state is shared truth.
+ * - `invalidate()` marks records stale and reruns only records with ≥1
+ *   enabled observer; disabled observers revalidate on re-enable.
+ * - A zero-observer record's in-flight run completes and commits.
+ * - Records are NEVER garbage-collected: the cache is unbounded for the
+ *   life of the client (restates today's unbounded-cache bound). Bound it
+ *   operationally with `clear()` or a fresh client per app lifetime.
+ *
+ * Key contract: keys are FLAT — `readonly (string|number|boolean|null)[]`.
+ * Objects and `undefined` are rejected with coded error N602 (`null` is
+ * the optional sentinel). Flat keys are order-sensitive: prefer
+ * per-endpoint key-builder helpers — a reordered key is a silent cache
+ * *miss*, benign relative to a collision, but a miss.
+ *
+ * SSG stance (documented, not built): under core-render, records fetch
+ * into the build-lifetime client and must TERMINATE before snapshot —
+ * `await settle()` is the barrier. Otherwise queries must be statically
+ * disabled for the build.
  */
 import { type Signal, type ReadonlySignal } from './signal.js';
-export interface QueryResult<T> {
-    /** The resolved data, or undefined if not yet loaded */
-    data: Signal<T | undefined>;
-    /** True while fetching */
+import { type DisposableResource } from './disposable.js';
+/** A single query-key element. `null` is the optional sentinel. */
+export type QueryKeyElement = string | number | boolean | null;
+/** The supported key contract: a flat, order-sensitive tuple. */
+export type QueryKey = readonly QueryKeyElement[];
+export type QueryStatus = 'idle' | 'loading' | 'success' | 'error';
+/** Fetcher contract: receives the run's AbortSignal. Zero-arg fetchers
+ *  remain assignable. */
+export type QueryFetcher<T> = (signal: AbortSignal) => Promise<T>;
+export interface QueryResult<T> extends DisposableResource {
+    /** The record's data, or `initialData`/undefined before first commit. */
+    data: ReadonlySignal<T | undefined>;
+    /** True while this observer is enabled and its record is fetching. */
     loading: ReadonlySignal<boolean>;
-    /** The error if the fetch failed, null otherwise */
-    error: Signal<Error | null>;
-    /** Manually trigger a refetch. Bypasses staleTime's fresh-cache
-     *  suppression — a manual refetch inside the freshness window is never a
-     *  silent no-op (react-query semantics). It does not bypass in-flight
-     *  deduplication: if a request for the same key is already running, this
-     *  joins it rather than starting a second fetch. */
+    /** The record's terminal error, or null. Cleared when a run starts. */
+    error: ReadonlySignal<Error | null>;
+    /** The record's lifecycle status. */
+    status: ReadonlySignal<QueryStatus>;
+    /** Force a refetch: bypasses staleTime freshness, but JOINS an in-flight
+     *  logical request rather than starting a second one (issue 0005). No-op
+     *  while disabled. */
     refetch(): void;
+    /** Unregister this observer. Component setup calls this automatically at
+     *  teardown; standalone callers (tests, scripts) call it explicitly. The
+     *  record — and any in-flight run — survives: zero-observer runs complete
+     *  and commit (ADR 0030.2 §8). */
+    dispose(): void;
 }
 export interface QueryOptions<T> {
-    /** Cache freshness duration in ms. Default: 0 (always refetch) */
+    /** Cache freshness duration in ms for THIS observer. Default: 0 (a
+     *  registration/re-enable always revalidates). */
     staleTime?: number;
-    /** Number of retries on failure. Default: 0 */
+    /** Number of retries the run performs when this observer owns it. Default: 0 */
     retry?: number;
-    /** Skip fetch when returns false. Signal reads are tracked. */
+    /** Skip fetching while this returns false. Signal reads are tracked. */
     enabled?: () => boolean;
-    /** Synchronous initial value before first fetch */
+    /** Synchronous seed committed into an untouched (idle) record. */
     initialData?: T;
-    /** Callback after successful fetch */
-    onSuccess?: (data: T) => void;
-    /** Callback after failed fetch */
-    onError?: (error: Error) => void;
+}
+interface QueryRecord {
+    readonly key: QueryKey;
+    readonly serialized: string;
+    readonly data: Signal<unknown>;
+    readonly error: Signal<Error | null>;
+    readonly status: Signal<QueryStatus>;
+    /** Epoch ms of the last successful commit; 0 = never. */
+    readonly fetchedAt: Signal<number>;
+    /** Marked by invalidate(); cleared when a run starts. */
+    stale: boolean;
+    /** True while a run is in flight (status mirrors it reactively). */
+    running: boolean;
+    /** Increments per run start; a superseded run may never commit. */
+    generation: number;
+    controller: AbortController | null;
+    /** The in-flight run (joinable by prefetch). */
+    runPromise: Promise<void> | null;
+    /** settle() terminator for the in-flight run. */
+    terminate: (() => void) | null;
+    readonly observers: Set<QueryObserver>;
+}
+interface QueryObserver {
+    readonly mountIndex: number;
+    readonly fetcher: QueryFetcher<unknown>;
+    readonly staleTime: number;
+    readonly retry: number;
+    enabled: boolean;
+    record: QueryRecord | null;
 }
 /**
- * Global query cache. Managed as an auto-singleton via inject().
- * Components use query() which accesses the client internally.
+ * Global keyed logical-request store. One per app: resolved via
+ * `inject(QueryClient)` (auto-singleton; override with
+ * `provide(QueryClient, ...)` BEFORE the first query() call).
+ *
+ * Records are never GC'd — see the module doc for the bound.
  */
 export declare class QueryClient {
-    private cache;
-    private inFlight;
-    /** Check if a cache entry is fresh */
-    isFresh(key: string, staleTime: number): boolean;
-    /** Get cached data */
-    getCached<T>(key: string): T | undefined;
-    /** Store data in cache */
-    set(key: string, data: unknown, staleTime: number): void;
-    /** Get in-flight promise for deduplication */
-    getInFlight(key: string): Promise<unknown> | undefined;
-    /** Register an in-flight request */
-    setInFlight(key: string, promise: Promise<unknown>): void;
+    /** @internal */ _records: Map<string, QueryRecord>;
+    /** @internal clear() bumps this; observer effects track it and re-resolve. */
+    _version: Signal<number>;
+    /** @internal live observer count (N601 mixed-client diagnostic). */
+    _observers: number;
     /**
-     * Invalidate cached entries whose key array starts with the given prefix elements.
-     * Returns the number of entries invalidated.
+     * Mark records matching the key prefix stale and rerun those with ≥1
+     * enabled observer (using the owning observer's fetcher/options).
+     * Disabled observers revalidate on re-enable; a record with only
+     * disabled/no observers stays stale until one arrives. Returns the
+     * number of records invalidated.
      *
-     * invalidate(['tasks']) matches ['tasks'], ['tasks', '1'], ['tasks', '2', 'x']
+     * invalidate(['tasks']) matches ['tasks'], ['tasks', '1'], ['tasks', '2', 'x'].
+     */
+    invalidate(keyPrefix: QueryKey): number;
+    /**
+     * Drop every record. In-flight runs are aborted (a settle() termination).
+     * Live observers re-resolve fresh records on the version bump — enabled
+     * ones revalidate immediately.
      */
-    invalidate(keyPrefix: unknown[]): number;
-    /** Prefetch and cache data */
-    prefetch(key: unknown[], fetcher: () => Promise<unknown>, staleTime?: number): Promise<void>;
-    /** Clear all cache */
     clear(): void;
+    /**
+     * Imperatively warm a record. Joins an in-flight run; a fresh record
+     * (per the given staleTime) is a no-op. Otherwise starts a run with THE
+     * GIVEN fetcher — an explicit imperative is its own owner. The run
+     * commits even with zero observers. Resolves at run termination.
+     */
+    prefetch<T>(key: QueryKey, fetcher: QueryFetcher<T>, staleTime?: number): Promise<void>;
 }
 /**
- * Declarative async data loading with caching and auto-refetch.
+ * Observe the record the reactive key points at.
  *
- * @param keyFn - Returns a cache key array. Signal reads are auto-tracked for refetch.
- * @param fetcher - Async function that fetches the data.
- * @param options - Optional configuration (staleTime, retry, enabled, etc.)
+ * @param keyFn - Returns the flat cache key. Signal reads are tracked; a
+ *   key change re-registers the observer on the new record.
+ * @param fetcher - Fetches the data; receives the run's AbortSignal.
+ * @param options - staleTime / retry / enabled / initialData.
+ * @throws N602 synchronously when the initial key violates the contract.
  */
-export declare function query<T>(keyFn: () => unknown[], fetcher: () => Promise<T>, options?: QueryOptions<T>): QueryResult<T>;
+export declare function query<T>(keyFn: () => QueryKey, fetcher: QueryFetcher<T>, options?: QueryOptions<T>): QueryResult<T>;
+export {};