@yaasl/core 0.8.0 → 0.9.1

package/dist/cjs/{middleware → effects}/migration.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createMigrationStep = exports.migration = void 0;
 const utils_1 = require("@yaasl/utils");
-const middleware_1 = require("./middleware");
+const createEffect_1 = require("./createEffect");
 const base_1 = require("../base");
 const sortMigrations = (migrations) => {
     const first = migrations.find(migration => migration.previous === null);
@@ -58,7 +58,17 @@ const performMigration = (atom, version, migrations) => {
         return migrateVersion(atom, data, migration);
     }, currentState);
 };
-exports.migration = (0, middleware_1.middleware)({
+/** Effect to migrate the persisted value of an atom to a newer version.
+ *  You can use the `createMigrationStep` helper to create migration steps.
+ *
+ *  @param {MigrationOptions} options
+ *  @param options.steps An array of migration steps to perform for outdated values.
+ *
+ * __Note:__ One step must have a `previous` version set to null as entry point.
+ *
+ *  @returns The effect to be used on atoms.
+ **/
+exports.migration = (0, createEffect_1.createEffect)({
     didInit: ({ atom, options }) => {
         var _a, _b;
         const steps = sortMigrations(options.steps);
@@ -87,5 +97,11 @@ exports.migration = (0, middleware_1.middleware)({
         atom.set(data);
     },
 });
+/** Helper to create a step for the migration effect.
+ *
+ *  @param migration Migration step to create.
+ *
+ *  @returns The migration step.
+ **/
 const createMigrationStep = (migration) => migration;
 exports.createMigrationStep = createMigrationStep;

package/dist/cjs/index.js

@@ -15,4 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./base"), exports);
-__exportStar(require("./middleware"), exports);
+__exportStar(require("./effects"), exports);

package/dist/mjs/base/createActions.js

@@ -0,0 +1,24 @@
+/** Create actions to change the state of an atom.
+ *
+ *  @param atom Atom to be used.
+ *  @param reducers Reducers for custom actions to set the atoms value.
+ *
+ *  @returns Actions to change the state of the atom.
+ *
+ *  @example
+ *  const counter = createAtom({ defaultValue: 0 })
+ *  const actions = createActions(counter, {
+ *    increment: (state) => state + 1,
+ *    decrement: (state) => state - 1,
+ *    add: (state, value: number) => state + value,
+ *    subtract: (state, value: number) => state - value,
+ *  })
+ *  actions.increment()
+ *  actions.add(5)
+ **/
+export const createActions = (atom, reducers) => Object.entries(reducers).reduce((result, [key, reducerFn]) => {
+    result[key] = (...payloadArgs) => {
+        atom.set((state) => reducerFn(state, ...payloadArgs));
+    };
+    return result;
+}, {});

package/dist/mjs/base/createAtom.js

@@ -0,0 +1,43 @@
+import { createActions } from "./createActions";
+import { Stateful } from "./Stateful";
+import { EffectDispatcher } from "../effects/EffectDispatcher";
+let key = 0;
+export class Atom extends Stateful {
+    constructor({ defaultValue, name = `atom-${++key}`, effects, reducers = {}, }) {
+        super(defaultValue);
+        this.name = name;
+        this.defaultValue = defaultValue;
+        this.actions = createActions(this, reducers);
+        if (!effects || effects.length === 0) {
+            this.didInit = true;
+            return;
+        }
+        const { didInit } = new EffectDispatcher({ atom: this, effects });
+        this.setDidInit(didInit);
+    }
+    /** Set the value of the atom.
+     *
+     * @param next New value or function to create the
+     * new value based off the previous value.
+     */
+    set(next) {
+        const value = next instanceof Function ? next(this.get()) : next;
+        super.update(value);
+    }
+}
+/** Creates an atom store.
+ *
+ * @param config.defaultValue Value that will be used initially.
+ * @param config.name Name of the atom. Must be unique among all atoms. Defaults to "atom-{number}".
+ * @param config.effects Effects that will be applied on the atom.
+ * @param config.reducers Reducers for custom actions to set the atom's value.
+ *
+ * @returns An atom instance.
+ * - `result.get`: Read the value of state.
+ * - `result.subscribe`: Subscribe to value changes.
+ * - `result.set`: Set the value of the atom.
+ * - `result.actions`: All actions that were created with reducers.
+ * - `result.didInit`: State of the atom's effects initialization process.
+ *   Will be a promise if the initialization is pending and `true` if finished.
+ **/
+export const createAtom = (config) => new Atom(config);

package/dist/mjs/base/{derive.js → createDerived.js}

@@ -68,7 +68,7 @@ export class SettableDerive extends Derive {
         return Array.from(setterDependencies).every(dependency => getterDependencies.has(dependency));
     }
 }
-export function derive(getter, setter) {
+export function createDerived(getter, setter) {
     if (setter) {
         return new SettableDerive(getter, setter);
     }

package/dist/mjs/base/createSelector.js

@@ -0,0 +1,40 @@
+import { toVoid } from "@yaasl/utils";
+import { Stateful } from "./Stateful";
+const selectPath = (state, path) => path
+    .split(".")
+    .reduce((result, key) => result[key], state);
+export class PathSelector extends Stateful {
+    constructor(atom, path) {
+        super(selectPath(atom.get(), path));
+        atom.subscribe(state => this.update(selectPath(state, path)));
+        this.setDidInit(atom.didInit);
+    }
+}
+// -- Combiner selector
+const allDidInit = (atoms) => {
+    const inits = atoms
+        .map(atom => atom.didInit)
+        .filter((didInit) => typeof didInit !== "boolean");
+    return inits.length === 0 ? true : Promise.all(inits).then(toVoid);
+};
+export class CombinerSelector extends Stateful {
+    constructor(atoms, combiner) {
+        const selectState = () => {
+            const values = atoms.map(atom => atom.get());
+            return combiner(...values);
+        };
+        super(selectState());
+        atoms.forEach(atom => atom.subscribe(() => this.update(selectState())));
+        this.setDidInit(allDidInit(atoms));
+    }
+}
+export const createSelector = (atoms, selector) => {
+    if (atoms instanceof Stateful && typeof selector === "string") {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return new PathSelector(atoms, selector);
+    }
+    if (Array.isArray(atoms) && typeof selector === "function") {
+        return new CombinerSelector(atoms, selector);
+    }
+    throw new Error("Selector args do not match any overload");
+};

package/dist/mjs/base/index.js

@@ -1,5 +1,5 @@
-export * from "./atom";
-export * from "./derive";
 export * from "./config";
-export * from "./select";
+export * from "./createAtom";
+export * from "./createDerived";
+export * from "./createSelector";
 export * from "./Stateful";

package/dist/mjs/{middleware/MiddlewareDispatcher.js → effects/EffectDispatcher.js}

@@ -1,14 +1,14 @@
 import { isPromiseLike } from "@yaasl/utils";
 import { Scheduler } from "../utils/Scheduler";
-export class MiddlewareDispatcher {
-    constructor({ atom, middleware }) {
+export class EffectDispatcher {
+    constructor({ atom, effects }) {
         this.didInit = false;
-        this.middleware = [];
+        this.effects = [];
         this.scheduler = new Scheduler();
-        this.middleware = middleware.map(create => create(atom));
-        this.callMiddlewareAction("init", atom);
+        this.effects = effects.map(create => create(atom));
+        this.callEffectAction("init", atom);
         this.subscribeSetters(atom);
-        this.callMiddlewareAction("didInit", atom);
+        this.callEffectAction("didInit", atom);
         const { queue } = this.scheduler;
         if (!isPromiseLike(queue)) {
             this.didInit = true;
@@ -19,12 +19,12 @@ export class MiddlewareDispatcher {
         });
     }
     subscribeSetters(atom) {
-        atom.subscribe(value => this.callMiddlewareAction("set", atom, () => value));
+        atom.subscribe(value => this.callEffectAction("set", atom, () => value));
     }
-    callMiddlewareAction(action, atom, 
+    callEffectAction(action, atom, 
     /* Must be a function to make sure it is using the latest value when used in promise */
     getValue = () => atom.get()) {
-        const tasks = this.middleware.map(({ actions, options }) => {
+        const tasks = this.effects.map(({ actions, options }) => {
             const actionFn = actions[action];
             return () => actionFn?.({ value: getValue(), atom, options });
         });

package/dist/mjs/effects/createEffect.js

@@ -0,0 +1,23 @@
+/** Create effects to be used in combination with atoms.
+ *
+ * Effects can be used to interact with an atom by using the following lifecycle actions:
+ *
+ * - `init`: Action to be called when the atom is created, but before subscribing to `set` events.
+ *   May return a promise that can be awaited by using `atom.didInit`.
+ * - `didInit`: Action to be called when the atom is created, but after subscribing to `set` events.
+ *   May return a promise that can be awaited by using `atom.didInit`.
+ * - `set`: Action to be called when the atom's `set` function is called.
+ *
+ * @param setup Effect actions or function to create effect actions.
+ *   Effect actions are fired in the atom lifecycle, alongside to the subscriptions.
+ *
+ * @returns The effect to be used on atoms.
+ **/
+export const createEffect = (setup) => (...[optionsArg]) => (atom) => {
+    const options = optionsArg;
+    const actions = setup instanceof Function ? setup({ options, atom }) : setup;
+    return {
+        options,
+        actions,
+    };
+};

package/dist/mjs/{middleware → effects}/expiration.js

@@ -1,4 +1,4 @@
-import { middleware } from "./middleware";
+import { createEffect } from "./createEffect";
 import { CONFIG } from "../base";
 import { Expiration } from "../utils/Expiration";
 const STORAGE = window.localStorage;
@@ -10,7 +10,7 @@ const syncOverBrowserTabs = (observingKey, onChange) => window.addEventListener(
         return;
     onChange(newValue);
 });
-/** Middleware to make an atom value expirable and reset to its defaulValue.
+/** Effect to make an atom value expirable and reset to its defaulValue.
  *
  * __Note:__ When using `expiresAt`, a function returning the date should be prefered since using a static date might end in an infinite loop.
  *
@@ -18,9 +18,9 @@ const syncOverBrowserTabs = (observingKey, onChange) => window.addEventListener(
  * @param options.expiresAt Date at which the value expires
  * @param options.expiresIn Milliseconds in which the value expires. Will be ignored if expiresAt is set.
  *
- * @returns The middleware to be used on atoms.
+ * @returns The effect to be used on atoms.
  **/
-export const expiration = middleware(({ atom, options = {} }) => {
+export const expiration = createEffect(({ atom, options = {} }) => {
     const hasExpiration = Boolean(options.expiresAt ?? options.expiresIn);
     if (!hasExpiration)
         return {};

package/dist/mjs/{middleware → effects}/index.js

@@ -1,4 +1,4 @@
-export { middleware } from "./middleware";
+export { createEffect } from "./createEffect";
 export { localStorage } from "./localStorage";
 export { indexedDb } from "./indexedDb";
 export { expiration } from "./expiration";

package/dist/mjs/{middleware → effects}/indexedDb.js

@@ -1,4 +1,4 @@
-import { middleware } from "./middleware";
+import { createEffect } from "./createEffect";
 import { CONFIG } from "../base";
 import { Store } from "../utils/Store";
 let atomDb = null;
@@ -10,9 +10,9 @@ let atomDb = null;
  * @param {IndexedDbOptions | undefined} options
  * @param options.key Use your own store key. Will be `atom.name` by default.
  *
- * @returns The middleware to be used on atoms.
+ * @returns The effect to be used on atoms.
  **/
-export const indexedDb = middleware(({ atom, options }) => {
+export const indexedDb = createEffect(({ atom, options }) => {
     const key = options?.key ?? atom.name;
     return {
         init: ({ atom }) => {

package/dist/mjs/{middleware → effects}/localStorage.js

@@ -1,4 +1,4 @@
-import { middleware } from "./middleware";
+import { createEffect } from "./createEffect";
 import { CONFIG } from "../base";
 import { LocalStorage } from "../utils/LocalStorage";
 /** Middleware to save and load atom values to the local storage.
@@ -9,9 +9,9 @@ import { LocalStorage } from "../utils/LocalStorage";
  * @param options.noTabSync Disable the synchronization of values over browser tabs.
  * @param options.parser Custom functions to stringify and parse values. Defaults to JSON.stringify and JSON.parse. Use this when handling complex datatypes like Maps or Sets.
  *
- * @returns The middleware to be used on atoms.
+ * @returns The effect to be used on atoms.
  **/
-export const localStorage = middleware(({ atom, options = {} }) => {
+export const localStorage = createEffect(({ atom, options = {} }) => {
     const internalKey = CONFIG.name ? `${CONFIG.name}/${atom.name}` : atom.name;
     const { key = internalKey, parser, noTabSync } = options;
     const storage = new LocalStorage(key, {

package/dist/mjs/{middleware → effects}/migration.js

@@ -1,5 +1,5 @@
 import { log } from "@yaasl/utils";
-import { middleware } from "./middleware";
+import { createEffect } from "./createEffect";
 import { CONFIG } from "../base";
 const sortMigrations = (migrations) => {
     const first = migrations.find(migration => migration.previous === null);
@@ -55,7 +55,17 @@ const performMigration = (atom, version, migrations) => {
         return migrateVersion(atom, data, migration);
     }, currentState);
 };
-export const migration = middleware({
+/** Effect to migrate the persisted value of an atom to a newer version.
+ *  You can use the `createMigrationStep` helper to create migration steps.
+ *
+ *  @param {MigrationOptions} options
+ *  @param options.steps An array of migration steps to perform for outdated values.
+ *
+ * __Note:__ One step must have a `previous` version set to null as entry point.
+ *
+ *  @returns The effect to be used on atoms.
+ **/
+export const migration = createEffect({
     didInit: ({ atom, options }) => {
         const steps = sortMigrations(options.steps);
         const currentVersion = getVersion(atom);
@@ -83,4 +93,10 @@ export const migration = middleware({
         atom.set(data);
     },
 });
+/** Helper to create a step for the migration effect.
+ *
+ *  @param migration Migration step to create.
+ *
+ *  @returns The migration step.
+ **/
 export const createMigrationStep = (migration) => migration;

package/dist/mjs/index.js

@@ -1,2 +1,2 @@
 export * from "./base";
-export * from "./middleware";
+export * from "./effects";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaasl/core",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "yet another atomic store library (vanilla-js)",
   "author": "PrettyCoffee",
   "license": "MIT",
@@ -38,7 +38,7 @@
     "validate": "run-s lint test build"
   },
   "dependencies": {
-    "@yaasl/utils": "0.8.0"
+    "@yaasl/utils": "0.9.1"
   },
   "eslintConfig": {
     "extends": [

package/dist/@types/base/atom.d.ts

@@ -1,33 +0,0 @@
-import { SetStateAction } from "@yaasl/utils";
-import { Stateful } from "./Stateful";
-import { MiddlewareActions, MiddlewareAtomCallback } from "../middleware/middleware";
-export interface AtomConfig<Value> {
-    /** Value that will be returned if the atom is not defined in the store */
-    defaultValue: Value;
-    /** Name of the atom. Must be unique among all atoms. */
-    name?: string;
-    /** Middleware that will be applied on the atom */
-    middleware?: MiddlewareAtomCallback<any>[];
-    /** Inline middleware to apply on the atom */
-    actions?: MiddlewareActions<undefined, Value>;
-}
-export declare class Atom<Value = unknown> extends Stateful<Value> {
-    readonly defaultValue: Value;
-    readonly name: string;
-    constructor({ defaultValue, name, middleware: externalMiddleware, actions, }: AtomConfig<Value>);
-    /** Set the value of the atom.
-     *
-     * @param next New value or function to create the
-     * new value based off the previous value.
-     */
-    set(next: SetStateAction<Value>): void;
-}
-/** Creates an atom store.
- *
- * @param config.defaultValue Value that will be used initially.
- * @param config.name Name of the atom. Must be unique among all atoms. Defaults to "atom-{number}".
- * @param config.middleware Middleware that will be applied on the atom.
- *
- * @returns An atom instance.
- **/
-export declare const atom: <Value>(config: AtomConfig<Value>) => Atom<Value>;

package/dist/@types/base/select.d.ts

@@ -1,20 +0,0 @@
-import { Stateful } from "./Stateful";
-type Selectable = Record<string | number, unknown>;
-type DeepKeys<T> = T extends object ? {
-    [K in keyof T]: `${Exclude<K, symbol>}${"" | `.${DeepKeys<T[K]>}`}`;
-}[keyof T] : never;
-type DeepValue<T, Path> = T extends Record<string | number, unknown> ? Path extends `${infer Current}.${infer Next}` ? DeepValue<T[Current], Next> : T[Path & string] : never;
-export declare class Select<Path extends DeepKeys<State>, State extends Selectable> extends Stateful<DeepValue<State, Path>> {
-    protected readonly parent: Stateful<State>;
-    protected readonly path: Path;
-    constructor(parent: Stateful<State>, path: Path);
-}
-/** Creates a value, selected from any stateful value.
- *
- *  @param parent The parent element to select a value from. The internal state must be an object.
- *  @param path The path to the value you want to select.
- *
- *  @returns A select instance.
- **/
-export declare const select: <Path extends DeepKeys<State>, State extends Selectable>(parent: Stateful<State>, path: Path) => Select<Path, State>;
-export {};

package/dist/@types/middleware/MiddlewareDispatcher.d.ts

@@ -1,15 +0,0 @@
-import { MiddlewareAtomCallback } from "./middleware";
-import { Atom } from "../base/atom";
-interface MiddlewareDispatcherConstructor {
-    atom: Atom<any>;
-    middleware: MiddlewareAtomCallback<any>[];
-}
-export declare class MiddlewareDispatcher {
-    didInit: PromiseLike<void> | boolean;
-    private middleware;
-    private scheduler;
-    constructor({ atom, middleware }: MiddlewareDispatcherConstructor);
-    private subscribeSetters;
-    private callMiddlewareAction;
-}
-export {};

package/dist/@types/middleware/middleware.d.ts

@@ -1,31 +0,0 @@
-import { Atom } from "../base";
-export type ActionType = "init" | "didInit" | "set";
-interface MiddlewarePayload<Options, AtomValue> {
-    value: AtomValue;
-    atom: Atom<AtomValue>;
-    options: Options;
-}
-export interface MiddlewareActions<Options, AtomValue> {
-    init?: (payload: MiddlewarePayload<Options, AtomValue>) => Promise<any> | void;
-    didInit?: (payload: MiddlewarePayload<Options, AtomValue>) => Promise<any> | void;
-    set?: (payload: MiddlewarePayload<Options, AtomValue>) => void;
-}
-interface MiddlewareSetupProps<Options, AtomValue> {
-    atom: Atom<AtomValue>;
-    options: Options;
-}
-export type MiddlewareAtomCallback<Options = unknown, AtomValue = unknown> = (atom: Atom<AtomValue>) => Middleware<Options, AtomValue>;
-type MiddlewareSetup<Options, AtomValue> = MiddlewareActions<Options, AtomValue> | ((props: MiddlewareSetupProps<Options, AtomValue>) => MiddlewareActions<Options, AtomValue>);
-export interface Middleware<Options = unknown, AtomValue = unknown> {
-    options: Options;
-    actions: MiddlewareActions<Options, AtomValue>;
-}
-/** Create middlewares to be used in combination with atoms.
- *
- * @param setup Middleware actions or function to create middleware actions.
- *   Middleware actions are fired in the atom lifecycle, alongside to the subscriptions.
- *
- * @returns A middleware function to be used in atoms.
- **/
-export declare const middleware: <Options = undefined, AtomValue = any>(setup: MiddlewareSetup<Options, AtomValue>) => (...[optionsArg]: Options extends undefined ? [Options] | [] : [Options]) => MiddlewareAtomCallback<Options, AtomValue>;
-export {};

package/dist/cjs/base/atom.js

@@ -1,47 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.atom = exports.Atom = void 0;
-const Stateful_1 = require("./Stateful");
-const middleware_1 = require("../middleware/middleware");
-const MiddlewareDispatcher_1 = require("../middleware/MiddlewareDispatcher");
-let key = 0;
-class Atom extends Stateful_1.Stateful {
-    constructor({ defaultValue, name = `atom-${++key}`, middleware: externalMiddleware, actions, }) {
-        super(defaultValue);
-        this.name = name;
-        this.defaultValue = defaultValue;
-        const items = [
-            ...(actions ? [(0, middleware_1.middleware)(actions)()] : []),
-            ...(externalMiddleware !== null && externalMiddleware !== void 0 ? externalMiddleware : []),
-        ];
-        if (items.length === 0) {
-            this.didInit = true;
-            return;
-        }
-        const { didInit } = new MiddlewareDispatcher_1.MiddlewareDispatcher({
-            atom: this,
-            middleware: items,
-        });
-        this.setDidInit(didInit);
-    }
-    /** Set the value of the atom.
-     *
-     * @param next New value or function to create the
-     * new value based off the previous value.
-     */
-    set(next) {
-        const value = next instanceof Function ? next(this.get()) : next;
-        super.update(value);
-    }
-}
-exports.Atom = Atom;
-/** Creates an atom store.
- *
- * @param config.defaultValue Value that will be used initially.
- * @param config.name Name of the atom. Must be unique among all atoms. Defaults to "atom-{number}".
- * @param config.middleware Middleware that will be applied on the atom.
- *
- * @returns An atom instance.
- **/
-const atom = (config) => new Atom(config);
-exports.atom = atom;

package/dist/cjs/base/select.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.select = exports.Select = void 0;
-const Stateful_1 = require("./Stateful");
-const selectValue = (state, path) => path
-    .split(".")
-    .reduce((result, key) => result[key], state);
-class Select extends Stateful_1.Stateful {
-    constructor(parent, path) {
-        super(selectValue(parent.get(), path));
-        this.parent = parent;
-        this.path = path;
-        parent.subscribe(state => this.update(selectValue(state, path)));
-        this.setDidInit(parent.didInit);
-    }
-}
-exports.Select = Select;
-/** Creates a value, selected from any stateful value.
- *
- *  @param parent The parent element to select a value from. The internal state must be an object.
- *  @param path The path to the value you want to select.
- *
- *  @returns A select instance.
- **/
-const select = (parent, path) => new Select(parent, path);
-exports.select = select;

package/dist/cjs/middleware/middleware.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.middleware = void 0;
-/** Create middlewares to be used in combination with atoms.
- *
- * @param setup Middleware actions or function to create middleware actions.
- *   Middleware actions are fired in the atom lifecycle, alongside to the subscriptions.
- *
- * @returns A middleware function to be used in atoms.
- **/
-const middleware = (setup) => (...[optionsArg]) => (atom) => {
-    const options = optionsArg;
-    const actions = setup instanceof Function ? setup({ options, atom }) : setup;
-    return {
-        options,
-        actions,
-    };
-};
-exports.middleware = middleware;

package/dist/mjs/base/atom.js

@@ -1,42 +0,0 @@
-import { Stateful } from "./Stateful";
-import { middleware, } from "../middleware/middleware";
-import { MiddlewareDispatcher } from "../middleware/MiddlewareDispatcher";
-let key = 0;
-export class Atom extends Stateful {
-    constructor({ defaultValue, name = `atom-${++key}`, middleware: externalMiddleware, actions, }) {
-        super(defaultValue);
-        this.name = name;
-        this.defaultValue = defaultValue;
-        const items = [
-            ...(actions ? [middleware(actions)()] : []),
-            ...(externalMiddleware ?? []),
-        ];
-        if (items.length === 0) {
-            this.didInit = true;
-            return;
-        }
-        const { didInit } = new MiddlewareDispatcher({
-            atom: this,
-            middleware: items,
-        });
-        this.setDidInit(didInit);
-    }
-    /** Set the value of the atom.
-     *
-     * @param next New value or function to create the
-     * new value based off the previous value.
-     */
-    set(next) {
-        const value = next instanceof Function ? next(this.get()) : next;
-        super.update(value);
-    }
-}
-/** Creates an atom store.
- *
- * @param config.defaultValue Value that will be used initially.
- * @param config.name Name of the atom. Must be unique among all atoms. Defaults to "atom-{number}".
- * @param config.middleware Middleware that will be applied on the atom.
- *
- * @returns An atom instance.
- **/
-export const atom = (config) => new Atom(config);

package/dist/mjs/base/select.js

@@ -1,21 +0,0 @@
-import { Stateful } from "./Stateful";
-const selectValue = (state, path) => path
-    .split(".")
-    .reduce((result, key) => result[key], state);
-export class Select extends Stateful {
-    constructor(parent, path) {
-        super(selectValue(parent.get(), path));
-        this.parent = parent;
-        this.path = path;
-        parent.subscribe(state => this.update(selectValue(state, path)));
-        this.setDidInit(parent.didInit);
-    }
-}
-/** Creates a value, selected from any stateful value.
- *
- *  @param parent The parent element to select a value from. The internal state must be an object.
- *  @param path The path to the value you want to select.
- *
- *  @returns A select instance.
- **/
-export const select = (parent, path) => new Select(parent, path);

package/dist/mjs/middleware/middleware.js

@@ -1,15 +0,0 @@
-/** Create middlewares to be used in combination with atoms.
- *
- * @param setup Middleware actions or function to create middleware actions.
- *   Middleware actions are fired in the atom lifecycle, alongside to the subscriptions.
- *
- * @returns A middleware function to be used in atoms.
- **/
-export const middleware = (setup) => (...[optionsArg]) => (atom) => {
-    const options = optionsArg;
-    const actions = setup instanceof Function ? setup({ options, atom }) : setup;
-    return {
-        options,
-        actions,
-    };
-};