@fluixi/reactive 1.0.0-alpha.83 → 1.0.0-alpha.84

package/dist/lib/signal/graph/debounced.d.ts

@@ -2,7 +2,7 @@ import type { Accessor, Setter } from './compat.js';
 import type { ResourceFetcherInfo, ResourceReturn } from './resource.js';
 /** Controls beyond reading and writing the value. */
 export interface DebounceControls<T> {
-    /** The value as written, before the delay — bind a controlled input to this. */
+    /** The value as written, before the delay: bind a controlled input to this. */
     immediate: Accessor<T>;
     /** True while a write is waiting to settle. Distinct from a request in flight. */
     pending: Accessor<boolean>;
@@ -34,7 +34,7 @@ export interface DebouncedResourceOptions<T> {
     initialValue?: T;
     /**
      * Whether a settled query should be fetched at all. Defaults to rejecting
-     * `undefined`, `null` and `''` — an empty search box shouldn't hit the network.
+     * `undefined`, `null` and `''`, an empty search box shouldn't hit the network.
      */
     shouldFetch?: (query: unknown) => boolean;
 }
@@ -45,7 +45,7 @@ export interface DebouncedResourceControls<S> extends DebounceControls<S> {
     refetch: (info?: unknown) => unknown;
 }
 /**
- * A resource driven by a debounced query — search-as-you-type, as one primitive.
+ * A resource driven by a debounced query: search-as-you-type, as one primitive.
  *
  * Two waiting states exist and they are not the same thing: `pending` is "the user
  * is still typing", `resource.loading` is "a request is in flight". A UI that
@@ -59,8 +59,8 @@ export interface DebouncedResourceControls<S> extends DebounceControls<S> {
  *   createDebouncedResource('', (q) => api.search(q));
  *
  * <input value={immediate()} onInput={(e) => setQuery(e.currentTarget.value)} />
- * <Show when={pending()}>typing…</Show>
- * <Show when={results.loading}>searching…</Show>
+ * <Show when={pending()}>typing...</Show>
+ * <Show when={results.loading}>searching...</Show>
  * ```
  */
 export declare function createDebouncedResource<T, S>(initial: S, fetcher: (query: S, info: ResourceFetcherInfo<T>) => T | Promise<T>, options?: DebouncedResourceOptions<T>): [ResourceReturn<T>[0], DebouncedResourceControls<S>];

package/dist/lib/signal/graph/debounced.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debounced.d.ts","sourceRoot":"","sources":["../../../../src/lib/signal/graph/debounced.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEzE,qDAAqD;AACrD,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,gFAAgF;IAChF,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvB,kFAAkF;IAClF,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC,CAAC;IACf,uEAAuE;IACvE,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,CAAC,EACV,KAAK,SAAM,GACV,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAqC/C;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IACvE,sDAAsD;IACtD,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;CACtC;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,CAAC,EAC1C,OAAO,EAAE,CAAC,EACV,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACnE,OAAO,GAAE,wBAAwB,CAAC,CAAC,CAAM,GACxC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAetD"}
+{"version":3,"file":"debounced.d.ts","sourceRoot":"","sources":["../../../../src/lib/signal/graph/debounced.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEzE,qDAAqD;AACrD,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,+EAA+E;IAC/E,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvB,kFAAkF;IAClF,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC,CAAC;IACf,uEAAuE;IACvE,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,CAAC,EACV,KAAK,SAAM,GACV,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAqC/C;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IACvE,sDAAsD;IACtD,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;CACtC;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,CAAC,EAC1C,OAAO,EAAE,CAAC,EACV,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACnE,OAAO,GAAE,wBAAwB,CAAC,CAAC,CAAM,GACxC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAetD"}

package/dist/lib/signal/graph/debounced.js

@@ -41,7 +41,7 @@ export function createDebouncedSignal(initial, delay = 300) {
     };
     const settle = () => {
         clear();
-        // untrack: settling is a write, and must not subscribe whoever triggered it.
+        // untrack, settling is a write, and must not subscribe whoever triggered it.
         const value = untrack(immediate);
         setSettled(() => value);
         setPending(false);
@@ -63,7 +63,7 @@ function meaningful(query) {
     return query !== undefined && query !== null && query !== '';
 }
 /**
- * A resource driven by a debounced query — search-as-you-type, as one primitive.
+ * A resource driven by a debounced query: search-as-you-type, as one primitive.
  *
  * Two waiting states exist and they are not the same thing: `pending` is "the user
  * is still typing", `resource.loading` is "a request is in flight". A UI that
@@ -77,15 +77,15 @@ function meaningful(query) {
  *   createDebouncedResource('', (q) => api.search(q));
  *
  * <input value={immediate()} onInput={(e) => setQuery(e.currentTarget.value)} />
- * <Show when={pending()}>typing…</Show>
- * <Show when={results.loading}>searching…</Show>
+ * <Show when={pending()}>typing...</Show>
+ * <Show when={results.loading}>searching...</Show>
  * ```
  */
 export function createDebouncedResource(initial, fetcher, options = {}) {
     const { delay = 300, initialValue, shouldFetch = meaningful } = options;
     const [query, setQuery, controls] = createDebouncedSignal(initial, delay);
     // createResource treats a falsy source as "don't fetch", which is exactly the
-    // empty-query case — so the predicate rides on the source rather than the fetcher.
+    // empty-query case, so the predicate rides on the source rather than the fetcher.
     const source = () => (shouldFetch(query()) ? query() : false);
     const [resource, { refetch }] = createResource(source, fetcher, initialValue === undefined ? {} : { initialValue });
     return [resource, { ...controls, query, setQuery, refetch }];