@ersbeth/picoflow 0.2.2 → 0.2.3

package/dist/types/basic/index.d.ts

@@ -2,7 +2,6 @@ export { FlowSignal } from './signal';
 export { FlowState } from './state';
 export { FlowObservable } from './observable';
 export { FlowDerivation } from './derivation';
-export { FlowDerivationAsync } from './derivationAsync';
 export { FlowEffect } from './effect';
 export { FlowConstant } from './constant';
 export { isDisposable } from './disposable';

package/dist/types/basic/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/basic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/basic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/index.d.ts

@@ -7,9 +7,7 @@
  *
  */
 export { signal, state, constant, resource, stream, derivation, effect, map, array, streamAsync, resourceAsync, } from './creators';
-export { isDisposable } from './basic';
-export { FlowDerivation, FlowDerivationAsync, FlowEffect, FlowObservable, FlowSignal, FlowState, FlowConstant, } from './basic/';
-export type { FlowGetter, FlowWatcher, FlowDisposable, } from './basic/';
-export { FlowResource, FlowMap, FlowResourceAsync, FlowStreamAsync, FlowStream, FlowArray, } from './advanced/';
-export type { FlowStreamDisposer, FlowStreamSetter, FlowStreamUpdater, FlowArrayAction, } from './advanced/';
+export { isDisposable, FlowDerivation, FlowEffect, FlowObservable, FlowSignal, FlowState, FlowConstant, type FlowGetter, type FlowWatcher, type FlowDisposable, } from './basic/';
+export { FlowResource, FlowMap, FlowResourceAsync, FlowStreamAsync, FlowStream, FlowArray, type FlowStreamDisposer, type FlowStreamSetter, type FlowStreamUpdater, type FlowArrayAction, } from './advanced/';
+export { from, SolidState, SolidResource, SolidDerivation, type SolidObservable, type SolidGetter, } from './solid/';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACH,MAAM,EACN,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,UAAU,EACV,MAAM,EACN,GAAG,EACH,KAAK,EACL,WAAW,EACX,aAAa,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EACH,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,YAAY,GACf,MAAM,UAAU,CAAC;AAElB,YAAY,EACR,UAAU,EACV,WAAW,EACX,cAAc,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EACH,YAAY,EACZ,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,SAAS,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EACR,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAClB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACH,MAAM,EACN,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,UAAU,EACV,MAAM,EACN,GAAG,EACH,KAAK,EACL,WAAW,EACX,aAAa,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,YAAY,EACZ,cAAc,EACd,UAAU,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,cAAc,GACtB,MAAM,UAAU,CAAC;AAElB,OAAO,EACH,YAAY,EACZ,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,SAAS,EACT,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACvB,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,IAAI,EACJ,UAAU,EACV,aAAa,EACb,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,WAAW,GACnB,MAAM,UAAU,CAAC"}

package/dist/types/solid/converters.d.ts

@@ -0,0 +1,64 @@
+import { FlowObservable, FlowGetter } from '@ersbeth/picoflow';
+import { SolidResource, SolidDerivation } from './primitives';
+/**
+ * Utility type that excludes Promise types from T.
+ * Used to ensure type safety for synchronous derivations/resources.
+ *
+ * @public
+ */
+export type NotPromise<T> = T extends Promise<unknown> ? never : T;
+/**
+ * Converts a FlowObservable of a Promise value into a SolidResource.
+ *
+ * @param flow - The FlowObservable to convert.
+ * @returns A SolidResource wrapping the observable.
+ *
+ * @public
+ */
+export declare function from<T>(flow: FlowObservable<Promise<NotPromise<T>>>): SolidResource<NotPromise<T>>;
+/**
+ * Converts a FlowObservable of a non-Promise value into a SolidDerivation.
+ *
+ * @param flow - The FlowObservable to convert.
+ * @returns A SolidDerivation wrapping the observable.
+ *
+ * @public
+ */
+export declare function from<T>(flow: FlowObservable<NotPromise<T>>): SolidDerivation<NotPromise<T>>;
+/**
+ * Converts a FlowObservable into a Solid derivation or resource, depending on whether the value is synchronous or asynchronous.
+ *
+ * @param flow - The FlowObservable to convert.
+ * @returns A SolidDerivation or SolidResource, depending on the input type.
+ *
+ * @public
+ */
+export declare function from<T>(flow: FlowObservable<Promise<NotPromise<T>>> | FlowObservable<NotPromise<T>>): SolidDerivation<NotPromise<T>> | SolidResource<NotPromise<T>>;
+/**
+ * Converts a getter function returning a non-Promise value into a SolidDerivation.
+ *
+ * @param flow - The getter function to convert.
+ * @returns A SolidDerivation wrapping the getter.
+ *
+ * @public
+ */
+export declare function from<T>(flow: (get: FlowGetter) => NotPromise<T>): SolidDerivation<NotPromise<T>>;
+/**
+ * Converts a getter function returning a Promise into a SolidResource.
+ *
+ * @param flow - The getter function to convert.
+ * @returns A SolidResource wrapping the getter.
+ *
+ * @public
+ */
+export declare function from<T>(flow: (get: FlowGetter) => Promise<NotPromise<T>>): SolidResource<NotPromise<T>>;
+/**
+ * Converts a getter function into a Solid derivation or resource, depending on whether the returned value is synchronous or asynchronous.
+ *
+ * @param flow - The getter function to convert.
+ * @returns A SolidDerivation or SolidResource, depending on the input type.
+ *
+ * @public
+ */
+export declare function from<T>(flow: ((get: FlowGetter) => NotPromise<T>) | ((get: FlowGetter) => Promise<NotPromise<T>>)): SolidDerivation<T> | SolidResource<T>;
+//# sourceMappingURL=converters.d.ts.map

package/dist/types/solid/converters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converters.d.ts","sourceRoot":"","sources":["../../../src/solid/converters.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEhG,OAAO,EAAE,aAAa,EAAc,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAsE/E;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;AAEnE;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACpG;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7F;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAClB,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAC7E,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACjE;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAClG;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACzG;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAClB,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAC3F,eAAe,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/solid/index.d.ts

@@ -0,0 +1,3 @@
+export { from } from './converters';
+export { SolidState, SolidResource, SolidDerivation, type SolidObservable, type SolidGetter } from './primitives';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/solid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/solid/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/solid/primitives.d.ts

@@ -0,0 +1,88 @@
+import { ResourceFetcher } from 'solid-js';
+/**
+ * A getter function or value for Solid state/derivation.
+ *
+ * @typeParam T - The value type.
+ * @public
+ */
+export type SolidGetter<T> = ((previous: T) => T) | T;
+/**
+ * Interface for a Solid-style observable value.
+ *
+ * @typeParam T - The value type.
+ * @public
+ */
+export interface SolidObservable<T> {
+    /**
+     * Returns the current value.
+     */
+    get: () => T;
+}
+/**
+ * Solid-style state container, similar to a writable signal.
+ *
+ * @typeParam T - The value type.
+ * @public
+ */
+export declare class SolidState<T> implements SolidObservable<T> {
+    /**
+     * Returns the current value.
+     */
+    readonly get: () => T;
+    /**
+     * Sets the value or updates it using a getter function.
+     */
+    readonly set: (param: SolidGetter<T>) => void;
+    /**
+     * Creates a new SolidState with the given initial value.
+     * @param initialValue - The initial value.
+     */
+    constructor(initialValue: T);
+}
+/**
+ * Solid-style derivation, similar to a computed/memoized value.
+ *
+ * @typeParam T - The value type.
+ * @public
+ */
+export declare class SolidDerivation<T> implements SolidObservable<T> {
+    /**
+     * Returns the current derived value.
+     */
+    readonly get: () => T;
+    /**
+     * Creates a new SolidDerivation from a getter function or value.
+     * @param calculator - The getter function or value.
+     */
+    constructor(calculator: SolidGetter<T>);
+}
+/**
+ * Solid-style resource, similar to an async resource or data loader.
+ *
+ * @typeParam T - The value type.
+ * @public
+ */
+export declare class SolidResource<T> implements SolidObservable<T | undefined> {
+    /**
+     * Returns the current value (or undefined if not yet loaded).
+     */
+    readonly get: () => T | undefined;
+    /**
+     * Returns the current resource state.
+     */
+    readonly state: () => 'unresolved' | 'pending' | 'errored' | 'ready' | 'refreshing';
+    /**
+     * Returns the latest successfully loaded value (or undefined).
+     */
+    readonly latest: () => T | undefined;
+    /**
+     * Triggers a refetch of the resource.
+     */
+    readonly refetch: () => void;
+    /**
+     * Creates a new SolidResource from a fetcher function.
+     * @param fetcher - The async fetcher function.
+     */
+    constructor(fetcher: ResourceFetcher<true, T, unknown>);
+}
+//# sourceMappingURL=primitives.d.ts.map

package/dist/types/solid/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/solid/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,eAAe,EAAG,MAAM,UAAU,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAC9B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IACpD;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAE9C;;;OAGG;gBACS,YAAY,EAAE,CAAC;CAK9B;AAGD;;;;;GAKG;AACH,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IACzD;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAEtB;;;OAGG;gBACS,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;CAIzC;AAED;;;;;GAKG;AACH,qBAAa,aAAa,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,GAAG,SAAS,CAAC;IACnE;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAClC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC;IACpF;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACrC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAE7B;;;OAGG;gBACS,OAAO,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC;CAOzD"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ersbeth/picoflow",
-    "version": "0.2.2",
+    "version": "0.2.3",
     "description": "Minimal Dataflow librairy for TypeScript",
     "type": "module",
     "exports": {
@@ -20,6 +20,9 @@
         "api:clean": "rm ./api/temp/*",
         "api": "npm run api:extract && npm run api:generate && npm run api:clean"
     },
+    "peerDependencies": {
+        "solid-js": "^1.9.7"
+    },
     "devDependencies": {
         "@biomejs/biome": "^1.9.4",
         "@vitest/coverage-v8": "^3.0.9",

package/src/basic/index.ts

@@ -2,7 +2,6 @@ export { FlowSignal } from "./signal";
 export { FlowState } from "./state";
 export { FlowObservable } from "./observable";
 export { FlowDerivation } from "./derivation";
-export { FlowDerivationAsync } from "./derivationAsync";
 export { FlowEffect } from "./effect";
 export { FlowConstant } from "./constant";
 export { isDisposable } from "./disposable";

package/src/index.ts

@@ -19,22 +19,20 @@ export {
     streamAsync,
     resourceAsync,
 } from "./creators";
-export { isDisposable } from "./basic";
+
 export {
+    isDisposable,
     FlowDerivation,
-    FlowDerivationAsync,
     FlowEffect,
     FlowObservable,
     FlowSignal,
     FlowState,
     FlowConstant,
+    type FlowGetter,
+    type FlowWatcher,
+    type FlowDisposable,
 } from "./basic/";
 
-export type {
-    FlowGetter,
-    FlowWatcher,
-    FlowDisposable,
-} from "./basic/";
 export {
     FlowResource,
     FlowMap,
@@ -42,10 +40,17 @@ export {
     FlowStreamAsync,
     FlowStream,
     FlowArray,
+    type FlowStreamDisposer,
+    type FlowStreamSetter,
+    type FlowStreamUpdater,
+    type FlowArrayAction,
 } from "./advanced/";
-export type {
-    FlowStreamDisposer,
-    FlowStreamSetter,
-    FlowStreamUpdater,
-    FlowArrayAction,
-} from "./advanced/";
+
+export {
+    from,
+    SolidState,
+    SolidResource,
+    SolidDerivation,
+    type SolidObservable,
+    type SolidGetter,
+} from "./solid/";

package/src/solid/converters.ts

@@ -0,0 +1,159 @@
+import { FlowDerivation, FlowEffect, FlowObservable, type FlowGetter } from '@ersbeth/picoflow';
+import { onCleanup, onMount } from 'solid-js';
+import { SolidResource, SolidState, type SolidDerivation } from './primitives';
+
+
+function fromSync<T>(state: FlowObservable<T>): SolidDerivation<T> {
+
+    const solidState = new SolidState<T>(state.get());
+
+    let fx: FlowEffect;
+
+    onMount(() => {
+        fx = new FlowEffect((get) => {
+            const value = get(state);
+            solidState.set(() => value);
+        });
+    });
+
+    onCleanup(() => fx.dispose());
+
+    return solidState
+}
+
+function fromAsync<T>(derivation: FlowObservable<Promise<T>>): SolidResource<T> {
+
+    const solidResource = new SolidResource<T>(async () => {
+        const value = await derivation.get();
+        return value;
+    });
+
+    let fx: FlowEffect;
+
+    onMount(() => {
+        fx = new FlowEffect(async (get) => {
+            await get(derivation);
+            solidResource.refetch();
+        });
+    });
+
+    onCleanup(() => fx.dispose());
+
+    return solidResource;
+}
+
+function shallowFrom<T>(flow: FlowObservable<Promise<T>>): SolidResource<T>;
+function shallowFrom<T>(flow: FlowObservable<T>): SolidDerivation<T>;
+function shallowFrom<T>(flow: FlowObservable<Promise<T>> | FlowObservable<T>): SolidDerivation<T> | SolidResource<T> {
+    const initialValue = flow.get();
+    const isAsync = initialValue instanceof Promise;
+    if (isAsync) {
+        return fromAsync(flow as FlowObservable<Promise<T>>);
+    }
+    return fromSync(flow as FlowObservable<T>);
+}
+
+function deepFrom<T>(getter: (get: FlowGetter) => T): SolidDerivation<T>;
+function deepFrom<T>(getter: (get: FlowGetter) => Promise<T>): SolidResource<T>;
+function deepFrom<T>(getter: (get: FlowGetter) => T | Promise<T>): SolidDerivation<T> | SolidResource<T> {
+    const derivation = new FlowDerivation((get) => {
+        return getter(get);
+    });
+
+    const initialValue = derivation.get();
+    const isAsync = initialValue instanceof Promise;
+
+    if (isAsync) {
+        return fromAsync(derivation as FlowObservable<Promise<T>>);
+    }
+
+    return fromSync(derivation as FlowObservable<T>);
+}
+
+/**
+ * Utility type that excludes Promise types from T.
+ * Used to ensure type safety for synchronous derivations/resources.
+ *
+ * @public
+ */
+export type NotPromise<T> = T extends Promise<unknown> ? never : T;
+
+/**
+ * Converts a FlowObservable of a Promise value into a SolidResource.
+ *
+ * @param flow - The FlowObservable to convert.
+ * @returns A SolidResource wrapping the observable.
+ *
+ * @public
+ */
+export function from<T>(flow: FlowObservable<Promise<NotPromise<T>>>): SolidResource<NotPromise<T>>;
+/**
+ * Converts a FlowObservable of a non-Promise value into a SolidDerivation.
+ *
+ * @param flow - The FlowObservable to convert.
+ * @returns A SolidDerivation wrapping the observable.
+ *
+ * @public
+ */
+export function from<T>(flow: FlowObservable<NotPromise<T>>): SolidDerivation<NotPromise<T>>;
+/**
+ * Converts a FlowObservable into a Solid derivation or resource, depending on whether the value is synchronous or asynchronous.
+ *
+ * @param flow - The FlowObservable to convert.
+ * @returns A SolidDerivation or SolidResource, depending on the input type.
+ *
+ * @public
+ */
+export function from<T>(
+    flow: FlowObservable<Promise<NotPromise<T>>> | FlowObservable<NotPromise<T>>,
+): SolidDerivation<NotPromise<T>> | SolidResource<NotPromise<T>>;
+/**
+ * Converts a getter function returning a non-Promise value into a SolidDerivation.
+ *
+ * @param flow - The getter function to convert.
+ * @returns A SolidDerivation wrapping the getter.
+ *
+ * @public
+ */
+export function from<T>(flow: (get: FlowGetter) => NotPromise<T>): SolidDerivation<NotPromise<T>>;
+/**
+ * Converts a getter function returning a Promise into a SolidResource.
+ *
+ * @param flow - The getter function to convert.
+ * @returns A SolidResource wrapping the getter.
+ *
+ * @public
+ */
+export function from<T>(flow: (get: FlowGetter) => Promise<NotPromise<T>>): SolidResource<NotPromise<T>>;
+/**
+ * Converts a getter function into a Solid derivation or resource, depending on whether the returned value is synchronous or asynchronous.
+ *
+ * @param flow - The getter function to convert.
+ * @returns A SolidDerivation or SolidResource, depending on the input type.
+ *
+ * @public
+ */
+export function from<T>(
+    flow: ((get: FlowGetter) => NotPromise<T>) | ((get: FlowGetter) => Promise<NotPromise<T>>),
+): SolidDerivation<T> | SolidResource<T>;
+/**
+ * Converts a FlowObservable or getter function into a Solid derivation or resource, depending on whether the value is synchronous or asynchronous.
+ *
+ * - If passed a FlowObservable of a non-Promise value, returns a SolidDerivation.
+ * - If passed a FlowObservable of a Promise, returns a SolidResource.
+ * - If passed a getter function returning a non-Promise value, returns a SolidDerivation.
+ * - If passed a getter function returning a Promise, returns a SolidResource.
+ *
+ * @param flow - The FlowObservable or getter function to convert.
+ * @returns A SolidDerivation or SolidResource, depending on the input type. 
+ * @public
+ */
+export function from<T>(
+    flow: FlowObservable<Promise<T>> | FlowObservable<T> | ((get: FlowGetter) => T) | ((get: FlowGetter) => Promise<T>),
+): SolidDerivation<T> | SolidResource<T> {
+    if (flow instanceof FlowObservable) {
+        return shallowFrom(flow as FlowObservable<T | Promise<T>>) as SolidDerivation<T> | SolidResource<T>;
+    }
+
+    return deepFrom(flow as (get: FlowGetter) => T | Promise<T>) as SolidDerivation<T> | SolidResource<T>;
+}

package/src/solid/index.ts

@@ -0,0 +1,2 @@
+export { from } from './converters';
+export { SolidState, SolidResource, SolidDerivation, type SolidObservable, type SolidGetter } from './primitives';

package/src/solid/primitives.ts

@@ -0,0 +1,109 @@
+import { createMemo, createResource, createSignal, type ResourceFetcher, } from "solid-js";
+
+/**
+ * A getter function or value for Solid state/derivation.
+ *
+ * @typeParam T - The value type.
+ * @public
+ */
+export type SolidGetter<T> = ((previous: T) => T) | T;
+
+/**
+ * Interface for a Solid-style observable value.
+ *
+ * @typeParam T - The value type.
+ * @public
+ */
+export interface SolidObservable<T> {
+    /**
+     * Returns the current value.
+     */
+    get: () => T;
+}
+
+/**
+ * Solid-style state container, similar to a writable signal.
+ *
+ * @typeParam T - The value type.
+ * @public
+ */
+export class SolidState<T> implements SolidObservable<T> {
+    /**
+     * Returns the current value.
+     */
+    readonly get: () => T;
+    /**
+     * Sets the value or updates it using a getter function.
+     */
+    readonly set: (param: SolidGetter<T>) => void;
+
+    /**
+     * Creates a new SolidState with the given initial value.
+     * @param initialValue - The initial value.
+     */
+    constructor(initialValue: T) {
+        const [get, set] = createSignal<T>(initialValue);
+        this.get = get;
+        this.set = set;
+    }
+}
+
+type EffectFunction<Prev, Next extends Prev = Prev> = (v: Prev) => Next;
+/**
+ * Solid-style derivation, similar to a computed/memoized value.
+ *
+ * @typeParam T - The value type.
+ * @public
+ */
+export class SolidDerivation<T> implements SolidObservable<T> {
+    /**
+     * Returns the current derived value.
+     */
+    readonly get: () => T;
+
+    /**
+     * Creates a new SolidDerivation from a getter function or value.
+     * @param calculator - The getter function or value.
+     */
+    constructor(calculator: SolidGetter<T>) {
+        const get = createMemo<T>(calculator as EffectFunction<T | undefined, T>);
+        this.get = get;
+    }
+}
+
+/**
+ * Solid-style resource, similar to an async resource or data loader.
+ *
+ * @typeParam T - The value type.
+ * @public
+ */
+export class SolidResource<T> implements SolidObservable<T | undefined> {
+    /**
+     * Returns the current value (or undefined if not yet loaded).
+     */
+    readonly get: () => T | undefined;
+    /**
+     * Returns the current resource state.
+     */
+    readonly state: () => 'unresolved' | 'pending' | 'errored' | 'ready' | 'refreshing';
+    /**
+     * Returns the latest successfully loaded value (or undefined).
+     */
+    readonly latest: () => T | undefined;
+    /**
+     * Triggers a refetch of the resource.
+     */
+    readonly refetch: () => void;
+
+    /**
+     * Creates a new SolidResource from a fetcher function.
+     * @param fetcher - The async fetcher function.
+     */
+    constructor(fetcher: ResourceFetcher<true, T, unknown>) {
+        const [get, set] = createResource<T>(fetcher);
+        this.get = get;
+        this.state = () => get.state;
+        this.latest = () => get.latest;
+        this.refetch = () => set.refetch();
+    }
+}

package/api/doc/picoflow.flowderivationasync._constructor_.md

@@ -1,49 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@ersbeth/picoflow](./picoflow.md) &gt; [FlowDerivationAsync](./picoflow.flowderivationasync.md) &gt; [(constructor)](./picoflow.flowderivationasync._constructor_.md)
-
-## FlowDerivationAsync.(constructor)
-
-Creates a new FlowDerivation.
-
-**Signature:**
-
-```typescript
-constructor(compute: (get: FlowGetter, watch: FlowWatcher) => Promise<T>);
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-compute
-
-
-</td><td>
-
-(get: [FlowGetter](./picoflow.flowgetter.md)<!-- -->, watch: [FlowWatcher](./picoflow.flowwatcher.md)<!-- -->) =&gt; Promise&lt;T&gt;
-
-
-</td><td>
-
-A function that computes the derived value. It is provided with two parameters: a getter and a watcher that respect dependency tracking.
-
-
-</td></tr>
-</tbody></table>

package/api/doc/picoflow.flowderivationasync.get.md

@@ -1,23 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@ersbeth/picoflow](./picoflow.md) &gt; [FlowDerivationAsync](./picoflow.flowderivationasync.md) &gt; [get](./picoflow.flowderivationasync.get.md)
-
-## FlowDerivationAsync.get() method
-
-Retrieves the current resource value.
-
-**Signature:**
-
-```typescript
-get(): Promise<T>;
-```
-**Returns:**
-
-Promise&lt;T&gt;
-
-The current value, or undefined if the resource has not been fetched yet.
-
-## Exceptions
-
-Error if the resource is disposed.
-