@livequery/react 2.0.95 → 2.0.96

package/dist/LivequeryCoreContext.d.ts

@@ -0,0 +1,5 @@
+import type { LivequeryCore } from "@livequery/core";
+export declare const useLivequeryCore: () => LivequeryCore, LivequeryCoreProvider: (props: import("react").PropsWithChildren<{
+    core: any;
+}>) => import("react").JSX.Element;
+//# sourceMappingURL=LivequeryCoreContext.d.ts.map

package/dist/LivequeryCoreContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LivequeryCoreContext.d.ts","sourceRoot":"","sources":["../src/LivequeryCoreContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,eAAO,MAAO,gBAAgB,uBAAE,qBAAqB;UACjC,GAAG;kCACtB,CAAA"}

package/dist/LivequeryCoreContext.js

@@ -0,0 +1,3 @@
+import { createContextFromHook } from "./createContextFromHook.js";
+export const [useLivequeryCore, LivequeryCoreProvider] = createContextFromHook((props) => props.core);
+//# sourceMappingURL=LivequeryCoreContext.js.map

package/dist/LivequeryCoreContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LivequeryCoreContext.js","sourceRoot":"","sources":["../src/LivequeryCoreContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,GAAG,qBAAqB,CAC1E,CAAC,KAAoB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAqB,CACxD,CAAA"}

package/dist/createContextFromHook.d.ts

@@ -1,16 +1,3 @@
-import { type PropsWithChildren } from "react";
-/**
- * Creates a React context pair from a hook-like factory.
- *
- * The returned tuple contains:
- * - a consumer hook that reads the computed value from context
- * - a provider component that calls `fn(props)` and places the result into context
- *
- * This pattern is useful when some shared state should feel like a normal hook at call
- * sites, while still being configured once at the edge of a subtree.
- *
- * @param fn Factory that receives provider props and returns the context value.
- * @returns A tuple of `[useValue, Provider]`.
- */
-export declare const createContextFromHook: <T, R>(fn: ((props: T) => R) | (() => R)) => [() => R, React.FC<PropsWithChildren<T>>];
+import { type JSX, type PropsWithChildren } from "react";
+export declare const createContextFromHook: <T, R>(fn: ((props: T) => R) | (() => R)) => [() => R, (props: PropsWithChildren<T>) => JSX.Element];
 //# sourceMappingURL=createContextFromHook.d.ts.map

package/dist/createContextFromHook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createContextFromHook.d.ts","sourceRoot":"","sources":["../src/createContextFromHook.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAEzE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAqBzC,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAC3E,CAAA"}
+{"version":3,"file":"createContextFromHook.d.ts","sourceRoot":"","sources":["../src/createContextFromHook.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,GAAG,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAGnF,eAAO,MAAM,qBAAqB,GAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAczC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,CACzF,CAAA"}

package/dist/createContextFromHook.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+export const createContextFromHook = (fn) => {
+    const ctx = createContext(undefined);
+    const useState = () => {
+        return useContext(ctx);
+    };
+    const Provider = ({ children, ...props }) => {
+        const value = fn(props);
+        return (_jsx(ctx.Provider, { value: value, children: children }));
+    };
+    return [useState, Provider,];
+};
+//# sourceMappingURL=createContextFromHook.js.map

package/dist/createContextFromHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContextFromHook.js","sourceRoot":"","sources":["../src/createContextFromHook.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAoC,MAAM,OAAO,CAAA;AAGnF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAO,EAAiC,EAAE,EAAE;IAC7E,MAAM,GAAG,GAAG,aAAa,CAAgB,SAAS,CAAC,CAAA;IAEnD,MAAM,QAAQ,GAAG,GAAG,EAAE;QAClB,OAAO,UAAU,CAAC,GAAG,CAAM,CAAA;IAC/B,CAAC,CAAA;IACD,MAAM,QAAQ,GAAG,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAwB,EAAE,EAAE;QAC9D,MAAM,KAAK,GAAG,EAAE,CAAC,KAAU,CAAC,CAAA;QAC5B,OAAO,CACH,KAAC,GAAG,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACrB,QAAQ,GACE,CAClB,CAAA;IACL,CAAC,CAAA;IACD,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAA6D,CAAA;AAC3F,CAAC,CAAA"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export * from './createContextFromHook';
-export * from './useCollection';
-export * from './useDocument';
-export * from './useGlobalValue';
-export * from './useObservable';
+export * from './createContextFromHook.js';
+export * from './useCollection.js';
+export * from './useDocument.js';
+export * from './useObservable.js';
+export * from './LivequeryCoreContext.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA;AACvC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA"}

package/dist/index.js

@@ -1,4 +1,6 @@
-import{createContext as Y,useContext as B}from"react";import{jsx as H}from"react/jsx-runtime";var U=(D)=>{let X=Y(void 0);return[()=>{return B(X)},({children:Z,...$})=>{let A=D($);return H(X.Provider,{value:A,children:Z})}]};import{LivequeryCollection as F}from"@livequery/core";import{useMemo as M,useEffect as R}from"react";var V=U((D)=>D.core),J=V[0],q=V[1],m=(D,X={})=>{let N=J(),Q=M(()=>new F(X),[]);return R(()=>{if(!D||!N)return;let Z=Q.initialize(N,D);return()=>{Z?.unsubscribe()}},[Q,N,D]),Q};import{LivequeryCollection as K}from"@livequery/core";import{useMemo as S,useEffect as T}from"react";import{useEffect as _,useState as z}from"react";import{tap as E,EMPTY as O}from"rxjs";var P=(D,X)=>{let[N,Q]=z(typeof D?.getValue==="function"?D.getValue():X);return _(()=>{try{let $=((typeof D==="function"?D():D)||O).pipe(E((A)=>{Q(A)})).subscribe();return()=>{$.unsubscribe()}}catch(Z){}},typeof D==="function"?[]:[D]),N};var c=(D,X={})=>{let N=J(),Q=S(()=>new K(X),[]);T(()=>{if(!D||!N)return;let A=Q.initialize(N,D);return()=>{A?.unsubscribe()}},[Q,N,D]);let Z=P(Q.items),$=P(Q.loading);return[Z[0],$]};var I=Symbol.for("#livequery/react/global"),a=(D,X)=>{let N=globalThis;return N[I]=N[I]||{},N[I][D]=N[I][D]||X(),N[I][D]};export{P as useObservable,J as useLivequeryCore,a as useGlobalValue,c as useDocument,m as useCollection,U as createContextFromHook,q as LivequeryCoreProvider};
-
-//# debugId=691A0C6DD6BB1CED64756E2164756E21
-//# sourceMappingURL=index.js.map
+export * from './createContextFromHook.js';
+export * from './useCollection.js';
+export * from './useDocument.js';
+export * from './useObservable.js';
+export * from './LivequeryCoreContext.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,14 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/createContextFromHook.tsx", "../src/useCollection.ts", "../src/useDocument.ts", "../src/useObservable.ts", "../src/useGlobalValue.ts"],
-  "sourcesContent": [
-    "import { createContext, useContext, type PropsWithChildren } from \"react\"\n\n/**\n * Creates a React context pair from a hook-like factory.\n *\n * The returned tuple contains:\n * - a consumer hook that reads the computed value from context\n * - a provider component that calls `fn(props)` and places the result into context\n *\n * This pattern is useful when some shared state should feel like a normal hook at call\n * sites, while still being configured once at the edge of a subtree.\n *\n * @param fn Factory that receives provider props and returns the context value.\n * @returns A tuple of `[useValue, Provider]`.\n */\nexport const createContextFromHook = <T, R>(fn: ((props: T) => R) | (() => R)) => {\n    const ctx = createContext<R | undefined>(undefined)\n\n    /**\n     * Reads the current context value produced by the paired provider.\n     */\n    const useState = () => {\n        return useContext(ctx) as R\n    }\n\n    /**\n     * Computes the context value from provider props and exposes it to descendants.\n     */\n    const Provider = ({ children, ...props }: PropsWithChildren<T>) => {\n        const value = fn(props as T)\n        return (\n            <ctx.Provider value={value}>\n                {children}\n            </ctx.Provider>\n        )\n    }\n    return [useState, Provider,] as [() => R, React.FC<PropsWithChildren<T>>]\n}",
-    "import { LivequeryCollection, LivequeryCore, type Doc, type LivequeryCollectionOptions } from \"@livequery/core\"\nimport { useMemo, useEffect } from \"react\"\nimport { createContextFromHook } from \"./createContextFromHook\"\n\nconst livequeryCoreContext = createContextFromHook(\n    (props: { core: LivequeryCore }) => props.core\n)\n\n/**\n * Returns the `LivequeryCore` instance from the nearest provider.\n */\nexport const useLivequeryCore = livequeryCoreContext[0]\n\n/**\n * Provides a `LivequeryCore` instance to all descendants that use this package's hooks.\n */\nexport const LivequeryCoreProvider = livequeryCoreContext[1]\n\n/**\n * Creates and initializes a `LivequeryCollection` for the supplied collection path.\n *\n * The collection instance is stable for the lifetime of the component. Initialization is\n * skipped when `ref` is falsy.\n *\n * @param ref Collection path understood by `@livequery/core`.\n * @param options Collection options forwarded to `LivequeryCollection`.\n * @returns A stable `LivequeryCollection` instance.\n */\nexport const useCollection = <T extends Doc>(ref: string | undefined | '' | null | false, options: Partial<LivequeryCollectionOptions<T>> = {}) => {\n    const core = useLivequeryCore()\n    const collection = useMemo(() => new LivequeryCollection<T>(options), [])\n    useEffect(() => {\n        if (!ref || !core) return\n        const linker = collection.initialize(core, ref)\n        return () => {\n            linker?.unsubscribe()\n        }\n    }, [collection, core, ref])\n\n    return collection\n}",
-    "import { LivequeryCollection, type Doc } from \"@livequery/core\"\nimport { useMemo, useEffect } from \"react\"\nimport { useLivequeryCore } from \"./useCollection.js\"\nimport { useObservable } from \"./useObservable.js\"\n\n/**\n * Subscribes to a single document path and returns the first emitted item with loading state.\n *\n * Internally this hook creates a `LivequeryCollection`, initializes it with the document ref,\n * then reads the first item from the collection stream.\n *\n * @param ref Document path understood by `@livequery/core`.\n * @param options Collection options used when creating the backing collection.\n * @returns A tuple of `[document, loading]`.\n */\nexport const useDocument = <T extends Doc>(ref: string | undefined | '' | null | false, options: { lazy?: boolean } = {}) => {\n    const core = useLivequeryCore()\n\n    const collection = useMemo(() => new LivequeryCollection<T>(options), [])\n    useEffect(() => {\n        if (!ref || !core) return\n        const linker = collection.initialize(core, ref)\n        return () => {\n            linker?.unsubscribe()\n        }\n    }, [collection, core, ref])\n\n    const items = useObservable(collection.items)\n    const loading = useObservable(collection.loading)\n    return [items[0], loading] as const\n    // const doc: LivequeryDocument<T> | null = items[0] || of(null)\n    // return Object.assign(doc, {\n    //     loading,\n    //     del: () => id && collection.delete(id)\n    // })\n\n}",
-    "import { useEffect, useState } from \"react\";\nimport { Observable, BehaviorSubject, tap, EMPTY } from \"rxjs\";\n\n/**\n * Accepts either a value or a lazy factory returning that value.\n */\nexport type MaybeFunction<T> = T | (() => T)\n\n/**\n * Subscribes to an RxJS observable and mirrors its latest value into React state.\n *\n * When a `BehaviorSubject` is provided, the hook uses `getValue()` for the initial render.\n * When a factory is provided, the observable is resolved lazily inside the effect.\n *\n * @param o Observable source or factory returning the source.\n * @param default_value Fallback value used before the first emission when the source is not a `BehaviorSubject`.\n * @returns The latest value emitted by the source.\n */\nexport const useObservable = <T extends any>(o: MaybeFunction<BehaviorSubject<T> | Observable<T>>, default_value?: T) => {\n    const [v, s] = useState<T>(typeof (o as any)?.['getValue'] === 'function' ? (o as any).getValue() : (default_value as T))\n    useEffect(() => {\n        try {\n            const target = (typeof o === 'function' ? o() : o) || EMPTY\n            const subscription = target.pipe(\n                tap(value => {\n                    s(value)\n                })\n            ).subscribe()\n            return () => {\n                subscription.unsubscribe()\n            }\n        } catch (e) { }\n    }, typeof o === 'function' ? [] : [o])\n    return v\n}",
-    "import { useMemo } from \"react\"\n\nconst WindowGlobalKey = Symbol.for('#livequery/react/global')\n\n/**\n * Resolves a process-wide singleton value stored on `globalThis`.\n *\n * The resolver runs only the first time a given key is requested in the current runtime.\n * Later calls with the same key return the cached value.\n *\n * @param key Unique key within the package global registry.\n * @param resolver Lazy factory used when the value does not exist yet.\n * @returns The cached or newly created value.\n */\nexport const useGlobalValue = <T>(key: string, resolver: () => T) => {\n    const G = globalThis as any\n    G[WindowGlobalKey] = G[WindowGlobalKey] || {}\n    G[WindowGlobalKey]![key] = G[WindowGlobalKey]![key] || resolver()\n    return G[WindowGlobalKey]![key] as T\n}"
-  ],
-  "mappings": "AAAA,wBAAS,gBAAe,sDAejB,IAAM,EAAwB,CAAO,IAAsC,CAC9E,IAAM,EAAM,EAA6B,MAAS,EAoBlD,MAAO,CAfU,IAAM,CACnB,OAAO,EAAW,CAAG,GAMR,EAAG,cAAa,KAAkC,CAC/D,IAAM,EAAQ,EAAG,CAAU,EAC3B,OACI,EAEE,EAAI,SAFN,CAAc,MAAO,EAArB,SACK,EACH,EAGiB,GCpC/B,8BAAS,wBACT,kBAAS,eAAS,cAGlB,IAAM,EAAuB,EACzB,CAAC,IAAmC,EAAM,IAC9C,EAKa,EAAmB,EAAqB,GAKxC,EAAwB,EAAqB,GAY7C,EAAgB,CAAgB,EAA6C,EAAkD,CAAC,IAAM,CAC/I,IAAM,EAAO,EAAiB,EACxB,EAAa,EAAQ,IAAM,IAAI,EAAuB,CAAO,EAAG,CAAC,CAAC,EASxE,OARA,EAAU,IAAM,CACZ,GAAI,CAAC,GAAO,CAAC,EAAM,OACnB,IAAM,EAAS,EAAW,WAAW,EAAM,CAAG,EAC9C,MAAO,IAAM,CACT,GAAQ,YAAY,IAEzB,CAAC,EAAY,EAAM,CAAG,CAAC,EAEnB,GCvCX,8BAAS,wBACT,kBAAS,eAAS,cCDlB,oBAAS,cAAW,cACpB,cAAsC,WAAK,aAiBpC,IAAM,EAAgB,CAAgB,EAAsD,IAAsB,CACrH,IAAO,EAAG,GAAK,EAAY,OAAQ,GAAY,WAAgB,WAAc,EAAU,SAAS,EAAK,CAAmB,EAcxH,OAbA,EAAU,IAAM,CACZ,GAAI,CAEA,IAAM,IADU,OAAO,IAAM,WAAa,EAAE,EAAI,IAAM,GAC1B,KACxB,EAAI,KAAS,CACT,EAAE,CAAK,EACV,CACL,EAAE,UAAU,EACZ,MAAO,IAAM,CACT,EAAa,YAAY,GAE/B,MAAO,EAAG,IACb,OAAO,IAAM,WAAa,CAAC,EAAI,CAAC,CAAC,CAAC,EAC9B,GDlBJ,IAAM,EAAc,CAAgB,EAA6C,EAA8B,CAAC,IAAM,CACzH,IAAM,EAAO,EAAiB,EAExB,EAAa,EAAQ,IAAM,IAAI,EAAuB,CAAO,EAAG,CAAC,CAAC,EACxE,EAAU,IAAM,CACZ,GAAI,CAAC,GAAO,CAAC,EAAM,OACnB,IAAM,EAAS,EAAW,WAAW,EAAM,CAAG,EAC9C,MAAO,IAAM,CACT,GAAQ,YAAY,IAEzB,CAAC,EAAY,EAAM,CAAG,CAAC,EAE1B,IAAM,EAAQ,EAAc,EAAW,KAAK,EACtC,EAAU,EAAc,EAAW,OAAO,EAChD,MAAO,CAAC,EAAM,GAAI,CAAO,GE3B7B,IAAM,EAAkB,OAAO,IAAI,yBAAyB,EAY/C,EAAiB,CAAI,EAAa,IAAsB,CACjE,IAAM,EAAI,WAGV,OAFA,EAAE,GAAmB,EAAE,IAAoB,CAAC,EAC5C,EAAE,GAAkB,GAAO,EAAE,GAAkB,IAAQ,EAAS,EACzD,EAAE,GAAkB",
-  "debugId": "691A0C6DD6BB1CED64756E2164756E21",
-  "names": []
-}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,2BAA2B,CAAA"}

package/dist/useAction.d.ts

@@ -0,0 +1,11 @@
+export declare const useAction: <T extends (...args: any[]) => Promise<any>>(fn: T, options?: Partial<{
+    onError: Function;
+}>) => T & {
+    loading: boolean;
+    data: null;
+    error: null | {
+        code: string;
+        message: string;
+    };
+};
+//# sourceMappingURL=useAction.d.ts.map

package/dist/useAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAction.d.ts","sourceRoot":"","sources":["../src/useAction.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,UAAS,OAAO,CAAC;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAM;;;WAIlG,IAAI,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAc9D,CAAA"}

package/dist/useAction.js

@@ -0,0 +1,22 @@
+import { useState } from "react";
+export const useAction = (fn, options = {}) => {
+    const [state, set_state] = useState({
+        loading: false,
+        data: null,
+        error: null
+    });
+    const f = async (...args) => {
+        set_state({ loading: true, data: null, error: null });
+        try {
+            const data = await fn(...args);
+            set_state({ loading: false, data, error: null });
+            return data;
+        }
+        catch (error) {
+            options.onError?.(error);
+            set_state({ loading: false, data: null, error: error instanceof Error ? { code: 'error', message: error.message } : { code: 'error', message: String(error) } });
+        }
+    };
+    return Object.assign(f, state);
+};
+//# sourceMappingURL=useAction.js.map

package/dist/useAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAction.js","sourceRoot":"","sources":["../src/useAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhC,MAAM,CAAC,MAAM,SAAS,GAAG,CAA6C,EAAK,EAAE,UAA0C,EAAE,EAAE,EAAE;IACzH,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC;QAChC,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,IAAgD;KAC1D,CAAC,CAAA;IACF,MAAM,CAAC,GAAG,KAAK,EAAE,GAAG,IAAS,EAAE,EAAE;QAC7B,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACrD,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;YAC9B,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YAChD,OAAO,IAAI,CAAA;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;YACxB,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;QACpK,CAAC;IACL,CAAC,CAAA;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAM,EAAE,KAAK,CAAC,CAAA;AACvC,CAAC,CAAA"}

package/dist/useCollection.d.ts

@@ -1,23 +1,3 @@
-import { LivequeryCollection, LivequeryCore, type Doc, type LivequeryCollectionOptions } from "@livequery/core";
-/**
- * Returns the `LivequeryCore` instance from the nearest provider.
- */
-export declare const useLivequeryCore: () => LivequeryCore;
-/**
- * Provides a `LivequeryCore` instance to all descendants that use this package's hooks.
- */
-export declare const LivequeryCoreProvider: import("react").FC<import("react").PropsWithChildren<{
-    core: LivequeryCore;
-}>>;
-/**
- * Creates and initializes a `LivequeryCollection` for the supplied collection path.
- *
- * The collection instance is stable for the lifetime of the component. Initialization is
- * skipped when `ref` is falsy.
- *
- * @param ref Collection path understood by `@livequery/core`.
- * @param options Collection options forwarded to `LivequeryCollection`.
- * @returns A stable `LivequeryCollection` instance.
- */
+import { LivequeryCollection, type Doc, type LivequeryCollectionOptions } from "@livequery/core";
 export declare const useCollection: <T extends Doc>(ref: string | undefined | "" | null | false, options?: Partial<LivequeryCollectionOptions<T>>) => LivequeryCollection<T>;
 //# sourceMappingURL=useCollection.d.ts.map

package/dist/useCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCollection.d.ts","sourceRoot":"","sources":["../src/useCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,KAAK,GAAG,EAAE,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAQ/G;;GAEG;AACH,eAAO,MAAM,gBAAgB,qBAA0B,CAAA;AAEvD;;GAEG;AACH,eAAO,MAAM,qBAAqB;UAXd,aAAa;GAW2B,CAAA;AAE5D;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,GAAG,EAAE,KAAK,MAAM,GAAG,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,KAAK,EAAE,UAAS,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAM,2BAY7I,CAAA"}
+{"version":3,"file":"useCollection.d.ts","sourceRoot":"","sources":["../src/useCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,GAAG,EAAE,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAMhG,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,GAAG,EAAE,KAAK,MAAM,GAAG,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,KAAK,EAAE,UAAS,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAM,2BAW7I,CAAA"}

package/dist/useCollection.js

@@ -0,0 +1,17 @@
+import { LivequeryCollection } from "@livequery/core";
+import { useMemo, useEffect } from "react";
+import { useLivequeryCore } from "./LivequeryCoreContext.js";
+export const useCollection = (ref, options = {}) => {
+    const core = useLivequeryCore();
+    const collection = useMemo(() => new LivequeryCollection(core, options), []);
+    useEffect(() => {
+        if (!ref || !core)
+            return;
+        const linker = collection.initialize(ref);
+        return () => {
+            linker?.unsubscribe();
+        };
+    }, [collection, core, ref]);
+    return collection;
+};
+//# sourceMappingURL=useCollection.js.map

package/dist/useCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollection.js","sourceRoot":"","sources":["../src/useCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA6C,MAAM,iBAAiB,CAAA;AAChG,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAI5D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAgB,GAA2C,EAAE,UAAkD,EAAE,EAAE,EAAE;IAC9I,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAA;IAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,mBAAmB,CAAI,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;IAC/E,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI;YAAE,OAAM;QACzB,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QACzC,OAAO,GAAG,EAAE;YACR,MAAM,EAAE,WAAW,EAAE,CAAA;QACzB,CAAC,CAAA;IACL,CAAC,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAA;IAC3B,OAAO,UAAU,CAAA;AACrB,CAAC,CAAA"}

package/dist/useDocument.d.ts

@@ -1,15 +1,5 @@
-import { type Doc } from "@livequery/core";
-/**
- * Subscribes to a single document path and returns the first emitted item with loading state.
- *
- * Internally this hook creates a `LivequeryCollection`, initializes it with the document ref,
- * then reads the first item from the collection stream.
- *
- * @param ref Document path understood by `@livequery/core`.
- * @param options Collection options used when creating the backing collection.
- * @returns A tuple of `[document, loading]`.
- */
+import { LivequeryDocument, type Doc, type DocState } from "@livequery/core";
 export declare const useDocument: <T extends Doc>(ref: string | undefined | "" | null | false, options?: {
     lazy?: boolean;
-}) => readonly [import("@livequery/core").LivequeryDocument<import("@livequery/core").DocState<T>> | undefined, import("@livequery/core").LivequeryLoadingState];
+}) => readonly [LivequeryDocument<DocState<T>> | undefined, import("@livequery/core").LivequeryLoadingState | undefined];
 //# sourceMappingURL=useDocument.d.ts.map

package/dist/useDocument.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDocument.d.ts","sourceRoot":"","sources":["../src/useDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAK/D;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,GAAG,EAAE,KAAK,MAAM,GAAG,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,KAAK,EAAE,UAAS;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,+JAqBvH,CAAA"}
+{"version":3,"file":"useDocument.d.ts","sourceRoot":"","sources":["../src/useDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAK5E,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,GAAG,EAAE,KAAK,MAAM,GAAG,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,KAAK,EAAE,UAAS;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,uHAKvH,CAAA"}

package/dist/useDocument.js

@@ -0,0 +1,10 @@
+import { LivequeryDocument } from "@livequery/core";
+import { useObservable } from "./useObservable.js";
+import { useCollection } from "./useCollection.js";
+export const useDocument = (ref, options = {}) => {
+    const collection = useCollection(ref, { lazy: options.lazy });
+    const items = useObservable(collection.items, []);
+    const loading = useObservable(collection.loading);
+    return [items[0], loading];
+};
+//# sourceMappingURL=useDocument.js.map

package/dist/useDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDocument.js","sourceRoot":"","sources":["../src/useDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA2B,MAAM,iBAAiB,CAAA;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAgB,GAA2C,EAAE,UAA8B,EAAE,EAAE,EAAE;IACxH,MAAM,UAAU,GAAG,aAAa,CAAI,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAChE,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,KAAK,EAAE,EAAsC,CAAC,CAAA;IACrF,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IACjD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAU,CAAA;AACvC,CAAC,CAAA"}

package/dist/useObservable.d.ts

@@ -1,17 +1,4 @@
 import { Observable, BehaviorSubject } from "rxjs";
-/**
- * Accepts either a value or a lazy factory returning that value.
- */
 export type MaybeFunction<T> = T | (() => T);
-/**
- * Subscribes to an RxJS observable and mirrors its latest value into React state.
- *
- * When a `BehaviorSubject` is provided, the hook uses `getValue()` for the initial render.
- * When a factory is provided, the observable is resolved lazily inside the effect.
- *
- * @param o Observable source or factory returning the source.
- * @param default_value Fallback value used before the first emission when the source is not a `BehaviorSubject`.
- * @returns The latest value emitted by the source.
- */
-export declare const useObservable: <T extends any>(o: MaybeFunction<BehaviorSubject<T> | Observable<T>>, default_value?: T) => T;
+export declare const useObservable: <T extends any, R = undefined>(o: MaybeFunction<BehaviorSubject<T> | Observable<T>> | undefined, default_value?: R) => T | R;
 //# sourceMappingURL=useObservable.d.ts.map

package/dist/useObservable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useObservable.d.ts","sourceRoot":"","sources":["../src/useObservable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAc,MAAM,MAAM,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;AAE5C;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,GAAG,EAAE,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,MAgBnH,CAAA"}
+{"version":3,"file":"useObservable.d.ts","sourceRoot":"","sources":["../src/useObservable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAc,MAAM,MAAM,CAAC;AAG/D,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;AAE5C,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,GAAG,EAAE,CAAC,GAAG,SAAS,EAAE,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,gBAAgB,CAAC,UAkB9I,CAAA"}

package/dist/useObservable.js

@@ -0,0 +1,21 @@
+import { useEffect, useState } from "react";
+import { Observable, BehaviorSubject, tap, EMPTY } from "rxjs";
+import { skip } from "rxjs/operators";
+export const useObservable = (o, default_value) => {
+    const getValue = o?.getValue;
+    const [v, s] = useState(getValue ? getValue() : default_value);
+    useEffect(() => {
+        try {
+            const target = (typeof o === 'function' ? o() : (o || EMPTY));
+            const subscription = target.pipe(skip(getValue ? 1 : 0), tap(value => {
+                s(value);
+            })).subscribe();
+            return () => {
+                subscription.unsubscribe();
+            };
+        }
+        catch (e) { }
+    }, typeof o === 'function' ? [] : [o]);
+    return v;
+};
+//# sourceMappingURL=useObservable.js.map

package/dist/useObservable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObservable.js","sourceRoot":"","sources":["../src/useObservable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAItC,MAAM,CAAC,MAAM,aAAa,GAAG,CAA+B,CAAgE,EAAE,aAAiB,EAAE,EAAE;IAC/I,MAAM,QAAQ,GAAI,CAAS,EAAE,QAAQ,CAAA;IACrC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAQ,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAO,CAAC,CAAC,CAAC,aAAkB,CAAC,CAAA;IAC/E,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAA;YAC7D,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAC5B,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACtB,GAAG,CAAC,KAAK,CAAC,EAAE;gBACR,CAAC,CAAC,KAAK,CAAC,CAAA;YACZ,CAAC,CAAC,CACL,CAAC,SAAS,EAAE,CAAA;YACb,OAAO,GAAG,EAAE;gBACR,YAAY,CAAC,WAAW,EAAE,CAAA;YAC9B,CAAC,CAAA;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IACnB,CAAC,EAAE,OAAO,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACtC,OAAO,CAAC,CAAA;AACZ,CAAC,CAAA"}

package/package.json

@@ -4,7 +4,7 @@
         "url": "https://github.com/livequery/react"
     },
     "type": "module",
-    "version": "2.0.95",
+    "version": "2.0.96",
     "description": "",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
@@ -13,13 +13,43 @@
             "types": "./dist/index.d.ts",
             "import": "./dist/index.js",
             "default": "./dist/index.js"
+        },
+        "./createContextFromHook": {
+            "types": "./dist/createContextFromHook.d.ts",
+            "import": "./dist/createContextFromHook.js",
+            "default": "./dist/createContextFromHook.js"
+        },
+        "./LivequeryCoreContext": {
+            "types": "./dist/LivequeryCoreContext.d.ts",
+            "import": "./dist/LivequeryCoreContext.js",
+            "default": "./dist/LivequeryCoreContext.js"
+        },
+        "./useAction": {
+            "types": "./dist/useAction.d.ts",
+            "import": "./dist/useAction.js",
+            "default": "./dist/useAction.js"
+        },
+        "./useCollection": {
+            "types": "./dist/useCollection.d.ts",
+            "import": "./dist/useCollection.js",
+            "default": "./dist/useCollection.js"
+        },
+        "./useDocument": {
+            "types": "./dist/useDocument.d.ts",
+            "import": "./dist/useDocument.js",
+            "default": "./dist/useDocument.js"
+        },
+        "./useObservable": {
+            "types": "./dist/useObservable.d.ts",
+            "import": "./dist/useObservable.js",
+            "default": "./dist/useObservable.js"
         }
     },
     "files": [
         "dist/**/*"
     ],
     "dependencies": {
-        "@livequery/core": "^2.0.92",
+        "@livequery/core": "^2.0.96",
         "rxjs": "^7.8.2"
     },
     "devDependencies": {
@@ -30,12 +60,10 @@
     },
     "scripts": {
         "clean": "rm -rf dist",
-        "build:js": "bun build ./src/index.ts --outdir ./dist --target browser --format esm --sourcemap --packages=external --production",
-        "build:js:prod": "bun build ./src/index.ts --outdir ./dist --target browser --format esm --sourcemap --packages=external --production",
         "build:types": "bunx tsc -p tsconfig.build.json",
-        "build": "bun run clean && bun run build:js && bun run build:types",
-        "build:prod": "bun run clean && bun run build:js:prod && bun run build:types",
-        "build:watch": "bun build ./src/index.ts --outdir ./dist --target browser --format esm --sourcemap --packages=external --watch"
+        "build": "bun run clean && bun run build:types",
+        "build:prod": "bun run build",
+        "build:watch": "bunx tsc -p tsconfig.build.json --watch"
     },
     "author": "",
     "license": "ISC"

package/dist/useGlobalValue.d.ts

@@ -1,12 +0,0 @@
-/**
- * Resolves a process-wide singleton value stored on `globalThis`.
- *
- * The resolver runs only the first time a given key is requested in the current runtime.
- * Later calls with the same key return the cached value.
- *
- * @param key Unique key within the package global registry.
- * @param resolver Lazy factory used when the value does not exist yet.
- * @returns The cached or newly created value.
- */
-export declare const useGlobalValue: <T>(key: string, resolver: () => T) => T;
-//# sourceMappingURL=useGlobalValue.d.ts.map

package/dist/useGlobalValue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useGlobalValue.d.ts","sourceRoot":"","sources":["../src/useGlobalValue.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,UAAU,MAAM,CAAC,KAIzB,CACtC,CAAA"}