@ersbeth/picoflow 0.2.1 → 0.2.3

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

@@ -1 +1 @@
-{"version":3,"file":"derivation.d.ts","sourceRoot":"","sources":["../../../src/basic/derivation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;GAQG;AACH,qBAAa,cAAc,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACpD;;;;;OAKG;gBACS,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,KAAK,CAAC;IAK/D;;;;;;;OAOG;IACI,GAAG,IAAI,CAAC;IASf,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,WAAW,CAAyD;IAC5E,OAAO,CAAC,aAAa,CAAoD;IACzE,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,eAAe,CAA4C;IACnE,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,iBAAiB,CAAW;IAEpC,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,SAAS;CAyBpB"}
+{"version":3,"file":"derivation.d.ts","sourceRoot":"","sources":["../../../src/basic/derivation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;GAQG;AACH,qBAAa,cAAc,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACpD;;;;;OAKG;gBACS,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,KAAK,CAAC;IAK/D;;;;;;;OAOG;IACI,GAAG,IAAI,CAAC;IASf,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,WAAW,CAAyD;IAC5E,OAAO,CAAC,aAAa,CAAoD;IACzE,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,eAAe,CAA4C;IACnE,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,iBAAiB,CAAW;IAEpC,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,SAAS;CA0CpB"}

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, 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,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.1",
+    "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/derivation.ts

@@ -67,7 +67,24 @@ export class FlowDerivation<T> extends FlowObservable<T> {
 
     /* @internal */ _compute(): void {
         if (this._dirty) {
-            this._value = this._untrackedCompute();
+            // we cant use untrackedCompute because it will not track dependencies
+            // that changed dynamically
+
+            // store current dependencies
+            const dependencies = [...this._dependencies];
+
+            // clear current dependencies, compute and retrack dependencies
+            this._dependencies.clear();
+            this._value = this._trackedCompute();
+
+            // unsubscribe from dependencies that are no longer needed
+            const dependenciesToRemove = dependencies.filter(
+                (dependency) => !this._dependencies.has(dependency),
+            );
+            dependenciesToRemove.forEach((dependency) =>
+                dependency._unregisterDependency(this),
+            );
+
             this._dirty = false;
         }
     }

package/src/index.ts

@@ -19,21 +19,20 @@ export {
     streamAsync,
     resourceAsync,
 } from "./creators";
-export { isDisposable } from "./basic";
+
 export {
+    isDisposable,
     FlowDerivation,
     FlowEffect,
     FlowObservable,
     FlowSignal,
     FlowState,
     FlowConstant,
+    type FlowGetter,
+    type FlowWatcher,
+    type FlowDisposable,
 } from "./basic/";
 
-export type {
-    FlowGetter,
-    FlowWatcher,
-    FlowDisposable,
-} from "./basic/";
 export {
     FlowResource,
     FlowMap,
@@ -41,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/test/derivation.test.ts

@@ -443,4 +443,102 @@ describe("effect", () => {
             expect(effectFn).toHaveBeenLastCalledWith(4);
         });
     });
+
+    describe("complex test", () => {
+        test("test", () => {
+            const obj1 = {
+                cond: state(false),
+                num: state(2),
+                dispose: (options: { self: boolean }) => {
+                    obj1.cond.dispose(options);
+                    obj1.num.dispose(options);
+                }
+            }
+            const obj2 = {
+                cond: state(false),
+                num: state(4),
+                dispose: (options: { self: boolean }) => {
+                    obj2.cond.dispose(options);
+                    obj2.num.dispose(options);
+                }
+            }
+            const $state = state(obj1);
+            const $derivationCond = derivation((get) => get(get($state).cond));
+            const $derivationNum = derivation((get) => get(get($state).num) * 2);
+            const effectCondFn = vi.fn();
+            const effectNumFn = vi.fn();
+            effect((get) => effectCondFn(get($derivationCond)));
+            effect((get) => effectNumFn(get($derivationNum)));
+
+            expect(effectCondFn).toHaveBeenCalledTimes(1);
+            expect(effectCondFn).toHaveBeenLastCalledWith(false);
+            expect(effectNumFn).toHaveBeenCalledTimes(1);
+            expect(effectNumFn).toHaveBeenLastCalledWith(4);
+
+            $state.get().num.set(3);
+            expect(effectCondFn).toHaveBeenCalledTimes(1);
+            expect(effectCondFn).toHaveBeenLastCalledWith(false);
+            expect(effectNumFn).toHaveBeenCalledTimes(2);
+            expect(effectNumFn).toHaveBeenLastCalledWith(6);
+
+            $state.get().cond.set(true);
+            expect(effectCondFn).toHaveBeenCalledTimes(2);
+            expect(effectCondFn).toHaveBeenLastCalledWith(true);
+            expect(effectNumFn).toHaveBeenCalledTimes(2);
+            expect(effectNumFn).toHaveBeenLastCalledWith(6);
+
+            $state.set(obj2)
+            expect(effectCondFn).toHaveBeenCalledTimes(3);
+            expect(effectCondFn).toHaveBeenLastCalledWith(false);
+            expect(effectNumFn).toHaveBeenCalledTimes(3);
+            expect(effectNumFn).toHaveBeenLastCalledWith(8);
+
+            $state.get().cond.set(true);
+            expect(effectCondFn).toHaveBeenCalledTimes(4); // fails -> called 3 times
+            expect(effectCondFn).toHaveBeenLastCalledWith(true);
+            expect(effectNumFn).toHaveBeenCalledTimes(3);
+            expect(effectNumFn).toHaveBeenLastCalledWith(8);
+
+            $state.get().num.set(5);
+            expect(effectCondFn).toHaveBeenCalledTimes(4);
+            expect(effectCondFn).toHaveBeenLastCalledWith(true);
+            expect(effectNumFn).toHaveBeenCalledTimes(4);
+            expect(effectNumFn).toHaveBeenLastCalledWith(10);
+        });
+
+        test("test", () => {
+            const obj = {
+                cond: state(false),
+                b: state(2)
+            }
+
+            const $state = state(obj);
+            const $derivation = derivation((get) => {
+                const cond = get(get($state).cond);
+                if (cond) {
+                    return get(get($state).b) * 2;
+                }
+                return 0;
+            });
+
+
+            const effectFn = vi.fn();
+            effect((get) => effectFn(get($derivation)));
+
+            expect(effectFn).toHaveBeenCalledTimes(1);
+            expect(effectFn).toHaveBeenLastCalledWith(0);
+
+            $state.get().cond.set(true);
+            expect(effectFn).toHaveBeenCalledTimes(2);
+            expect(effectFn).toHaveBeenLastCalledWith(4);
+
+            $state.set({ cond: state(false), b: state(3) })
+            expect(effectFn).toHaveBeenCalledTimes(3);
+            expect(effectFn).toHaveBeenLastCalledWith(0);
+
+            $state.get().cond.set(true);
+            expect(effectFn).toHaveBeenCalledTimes(4);
+            expect(effectFn).toHaveBeenLastCalledWith(6);
+        });
+    });
 });