@nisli/core 0.43.0

package/dist/query.js

@@ -0,0 +1,231 @@
+/**
+ * query.ts — Declarative async data loading with cache
+ *
+ * `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.
+ *
+ * ```ts
+ * const tasks = query(
+ *   () => ['tasks', scopeId.value],
+ *   () => api.getTasks(scopeId.value),
+ * );
+ * tasks.data      // Signal<Task[] | undefined>
+ * tasks.loading   // Signal<boolean>
+ * tasks.error     // Signal<Error | null>
+ * tasks.refetch() // manual refetch
+ * ```
+ */
+import { signal, effect, computed } from './signal.js';
+import { hasContext, getCurrentComponent } from './context.js';
+import { inject } from './injector.js';
+/**
+ * Global query cache. Managed as an auto-singleton via inject().
+ * Components use query() which accesses the client internally.
+ */
+export class QueryClient {
+    cache = new Map();
+    inFlight = new Map();
+    /** Check if a cache entry is fresh */
+    isFresh(key, staleTime) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        return Date.now() - entry.fetchedAt < staleTime;
+    }
+    /** Get cached data */
+    getCached(key) {
+        return this.cache.get(key)?.data;
+    }
+    /** Store data in cache */
+    set(key, data, staleTime) {
+        this.cache.set(key, { data, fetchedAt: Date.now(), staleTime });
+    }
+    /** Get in-flight promise for deduplication */
+    getInFlight(key) {
+        return this.inFlight.get(key);
+    }
+    /** Register an in-flight request */
+    setInFlight(key, promise) {
+        // Attach a catch handler to prevent unhandled rejection on the stored promise.
+        // Callers who await this promise get the original behavior from their own try/catch.
+        const handled = promise.catch(() => { });
+        this.inFlight.set(key, promise);
+        // Clean up when done
+        handled.finally(() => {
+            if (this.inFlight.get(key) === promise) {
+                this.inFlight.delete(key);
+            }
+        });
+    }
+    /**
+     * Invalidate cached entries whose key array starts with the given prefix elements.
+     * Returns the number of entries invalidated.
+     *
+     * invalidate(['tasks']) matches ['tasks'], ['tasks', '1'], ['tasks', '2', 'x']
+     */
+    invalidate(keyPrefix) {
+        let count = 0;
+        for (const [serialized] of this.cache) {
+            try {
+                const key = JSON.parse(serialized);
+                if (Array.isArray(key) && keyPrefix.every((v, i) => JSON.stringify(v) === JSON.stringify(key[i]))) {
+                    this.cache.delete(serialized);
+                    count++;
+                }
+            }
+            catch {
+                // Skip invalid keys
+            }
+        }
+        return count;
+    }
+    /** Prefetch and cache data */
+    async prefetch(key, fetcher, staleTime = 0) {
+        const serialized = serializeKey(key);
+        if (this.isFresh(serialized, staleTime))
+            return;
+        const data = await fetcher();
+        this.set(serialized, data, staleTime);
+    }
+    /** Clear all cache */
+    clear() {
+        this.cache.clear();
+        this.inFlight.clear();
+    }
+}
+// ── Key serialization ───────────────────────────────────────────────
+function serializeKey(key) {
+    return JSON.stringify(key);
+}
+// ── query() — the main API ──────────────────────────────────────────
+/**
+ * Declarative async data loading with caching and auto-refetch.
+ *
+ * @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.)
+ */
+export function query(keyFn, fetcher, options = {}) {
+    const { staleTime = 0, retry = 0, enabled, initialData, onSuccess, onError, } = options;
+    const data = signal(initialData);
+    const loading = signal(false);
+    const error = signal(null);
+    // Get or lazily create the QueryClient
+    let client;
+    try {
+        client = inject(QueryClient);
+    }
+    catch {
+        // If no DI context, create a local client
+        client = new QueryClient();
+    }
+    // Track the current fetch generation to handle race conditions
+    let fetchGeneration = 0;
+    let disposed = false;
+    const doFetch = async () => {
+        if (disposed)
+            return;
+        // Check enabled
+        if (enabled && !enabled())
+            return;
+        const key = keyFn();
+        const serialized = serializeKey(key);
+        const generation = ++fetchGeneration;
+        // Check cache freshness
+        if (staleTime > 0 && client.isFresh(serialized, staleTime)) {
+            const cached = client.getCached(serialized);
+            if (cached !== undefined) {
+                data.value = cached;
+                return;
+            }
+        }
+        // Check for in-flight deduplication
+        const existing = client.getInFlight(serialized);
+        if (existing) {
+            loading.value = true;
+            try {
+                const result = await existing;
+                if (generation === fetchGeneration && !disposed) {
+                    data.value = result;
+                    error.value = null;
+                }
+            }
+            catch (e) {
+                if (generation === fetchGeneration && !disposed) {
+                    error.value = e instanceof Error ? e : new Error(String(e));
+                }
+            }
+            finally {
+                if (generation === fetchGeneration && !disposed) {
+                    loading.value = false;
+                }
+            }
+            return;
+        }
+        loading.value = true;
+        error.value = null;
+        let lastError = null;
+        const attempts = retry + 1;
+        for (let attempt = 0; attempt < attempts; attempt++) {
+            if (disposed || generation !== fetchGeneration)
+                return;
+            const promise = fetcher();
+            // Prevent unhandled rejection on the shared in-flight reference
+            promise.catch(() => { });
+            client.setInFlight(serialized, promise);
+            try {
+                const result = await promise;
+                // Guard against stale responses
+                if (generation === fetchGeneration && !disposed) {
+                    data.value = result;
+                    error.value = null;
+                    loading.value = false;
+                    client.set(serialized, result, staleTime);
+                    onSuccess?.(result);
+                }
+                return; // success
+            }
+            catch (e) {
+                lastError = e instanceof Error ? e : new Error(String(e));
+                // Continue to next retry attempt
+            }
+        }
+        // All retries exhausted
+        if (generation === fetchGeneration && !disposed) {
+            error.value = lastError;
+            loading.value = false;
+            if (lastError)
+                onError?.(lastError);
+        }
+    };
+    // Auto-fetch on mount and when dependencies change
+    const disposeEffect = effect(() => {
+        // Reading keyFn() inside the effect tracks signal dependencies
+        const _key = keyFn();
+        // Also track enabled()
+        if (enabled)
+            enabled();
+        // Schedule the async fetch — catch to prevent unhandled promise rejection
+        doFetch().catch(() => { });
+    });
+    // Register disposal if in component context
+    if (hasContext()) {
+        getCurrentComponent().addDisposer(() => {
+            disposed = true;
+            disposeEffect();
+        });
+    }
+    const refetch = () => {
+        fetchGeneration++; // invalidate any in-flight
+        doFetch().catch(() => { });
+    };
+    return {
+        data,
+        loading: loading,
+        error,
+        refetch,
+    };
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"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"}

package/dist/ref.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ref.ts — Element reference primitive for imperative DOM access
+ *
+ * `ref()` creates a container that receives a DOM element reference
+ * after the template is mounted. Use it for focus management, DOM
+ * measurement, scroll management, and third-party library init.
+ *
+ * ```ts
+ * const inputRef = ref<HTMLInputElement>();
+ *
+ * onMount(() => inputRef.current?.focus());
+ *
+ * return html`<input ${inputRef} @keydown.enter=${onSubmit} />`;
+ * ```
+ *
+ * The template engine detects `Ref` objects in expression positions
+ * (not inside attribute values) and assigns the nearest parent element.
+ */
+export declare const REF_BRAND: unique symbol;
+export interface Ref<T extends Element = Element> {
+    readonly [REF_BRAND]: true;
+    /** The DOM element, or null before mount / after unmount */
+    current: T | null;
+}
+/**
+ * Create a ref container for imperative DOM access.
+ *
+ * After the template is mounted, `ref.current` holds the element.
+ * After dispose, `ref.current` is set back to null.
+ */
+export declare function ref<T extends Element = Element>(): Ref<T>;
+/**
+ * Check if a value is a Ref.
+ * Used by the template engine to detect refs in expression slots.
+ */
+export declare function isRef(value: unknown): value is Ref;

package/dist/ref.js

@@ -0,0 +1,43 @@
+/**
+ * ref.ts — Element reference primitive for imperative DOM access
+ *
+ * `ref()` creates a container that receives a DOM element reference
+ * after the template is mounted. Use it for focus management, DOM
+ * measurement, scroll management, and third-party library init.
+ *
+ * ```ts
+ * const inputRef = ref<HTMLInputElement>();
+ *
+ * onMount(() => inputRef.current?.focus());
+ *
+ * return html`<input ${inputRef} @keydown.enter=${onSubmit} />`;
+ * ```
+ *
+ * The template engine detects `Ref` objects in expression positions
+ * (not inside attribute values) and assigns the nearest parent element.
+ */
+// ── Brand for ref detection in templates ─────────────────────────────
+export const REF_BRAND = Symbol.for('backlog.ref');
+// ── Public API ──────────────────────────────────────────────────────
+/**
+ * Create a ref container for imperative DOM access.
+ *
+ * After the template is mounted, `ref.current` holds the element.
+ * After dispose, `ref.current` is set back to null.
+ */
+export function ref() {
+    return {
+        [REF_BRAND]: true,
+        current: null,
+    };
+}
+/**
+ * Check if a value is a Ref.
+ * Used by the template engine to detect refs in expression slots.
+ */
+export function isRef(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        REF_BRAND in value);
+}
+//# sourceMappingURL=ref.js.map

package/dist/ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../src/ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,wEAAwE;AAExE,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAUnD,uEAAuE;AAEvE;;;;;GAKG;AACH,MAAM,UAAU,GAAG;IACjB,OAAO;QACL,CAAC,SAAS,CAAC,EAAE,IAAa;QAC1B,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,SAAS,IAAK,KAAiC,CAChD,CAAC;AACJ,CAAC"}

package/dist/signal.d.ts

@@ -0,0 +1,93 @@
+/**
+ * signal.ts — Reactive primitives: signal(), computed(), effect()
+ *
+ * Push-pull hybrid model:
+ * - Writes push "dirty" flags up the dependency graph
+ * - Reads pull fresh values lazily (computed only recalculates when read)
+ * - Multiple synchronous writes coalesce into one microtask flush
+ *
+ * Dependency tracking is automatic: reading a signal inside a computed
+ * or effect registers it as a dependency. Dependencies are re-tracked
+ * on every execution (dynamic/conditional tracking).
+ */
+/**
+ * Register the context hook. Called by component.ts at module init.
+ * The hook returns an `addDisposer` function if inside setup context, null otherwise.
+ */
+export declare function setContextHook(hook: () => ((fn: () => void) => void) | null): void;
+export declare const SIGNAL_BRAND: unique symbol;
+/** Readable reactive container. */
+export interface ReadonlySignal<T> {
+    readonly [SIGNAL_BRAND]: true;
+    readonly value: T;
+    /** Subscribe to value changes. Returns unsubscribe function. */
+    subscribe(fn: (value: T) => void): () => void;
+}
+/** Read-write reactive container. */
+export interface Signal<T> extends ReadonlySignal<T> {
+    value: T;
+}
+/**
+ * Create a writable reactive signal.
+ *
+ * ```ts
+ * const count = signal(0);
+ * count.value;     // read (auto-tracks in reactive contexts)
+ * count.value = 5; // write (notifies dependents)
+ * ```
+ */
+export declare function signal<T>(initialValue: T): Signal<T>;
+/**
+ * Create a derived, lazy, cached computed signal.
+ * Re-evaluates only when dependencies change AND the value is read.
+ *
+ * ```ts
+ * const doubled = computed(() => count.value * 2);
+ * doubled.value; // lazy evaluation
+ * ```
+ */
+export declare function computed<T>(fn: () => T): ReadonlySignal<T>;
+/**
+ * Create a side-effect that re-runs when its dependencies change.
+ * Returns a dispose function to stop the effect.
+ *
+ * The effect function may return a cleanup callback that runs
+ * before each re-execution and on disposal.
+ *
+ * ```ts
+ * const dispose = effect(() => {
+ *   console.log('count is', count.value);
+ *   return () => { // cleanup
+ *     console.log('cleaning up');
+ *   };
+ * });
+ * dispose(); // stop the effect
+ * ```
+ */
+export declare function effect(fn: () => void | (() => void)): () => void;
+/**
+ * Check if a value is a signal (writable or computed).
+ * Used by the template engine to detect signals in expression slots.
+ */
+export declare function isSignal(value: unknown): value is ReadonlySignal<unknown>;
+/**
+ * Run a function with activeObserver set to null, preventing any
+ * signal reads inside `fn` from being tracked by an outer effect.
+ *
+ * Used by component.ts to isolate connectedCallback: child component
+ * setup signal reads must not leak into a parent effect's dependency
+ * set. See ADR 0008 Gap 1.
+ */
+export declare function untrack(fn: () => void): void;
+/**
+ * Synchronously execute all pending effects.
+ *
+ * In normal usage, effects run automatically on the next microtask.
+ * Use flush() only when you need effects to have executed before
+ * the next line — e.g., imperative DOM measurement after state change.
+ *
+ * flush() is idempotent: calling it with no pending effects is a no-op.
+ */
+export declare function flush(): void;
+/** Backward compat alias for tests. */
+export { flush as flushEffects };