@rkrupinski/stan 1.0.0-rc10

package/README.md

@@ -0,0 +1,5 @@
+# Stan
+
+[![CI](https://github.com/rkrupinski/stan/actions/workflows/ci.yml/badge.svg)](https://github.com/rkrupinski/stan/actions/workflows/ci.yml)
+
+Minimal, type-safe state management

package/dist/atom.d.ts

@@ -0,0 +1,13 @@
+import type { SetterOrUpdater, WritableState } from './state';
+import { type SerializableParam } from './misc';
+export type AtomEffect<T> = (param: {
+    init(value: T): void;
+    set: SetterOrUpdater<T>;
+    onSet(cb: (value: T) => void): void;
+}) => void;
+export type AtomOptions<T> = {
+    effects?: ReadonlyArray<AtomEffect<T>>;
+};
+export declare const atom: <T>(initialValue: T, { effects }?: AtomOptions<T>) => WritableState<T>;
+export type ValueFromParam<T, P extends SerializableParam> = (param: P) => T;
+export declare const atomFamily: <T, P extends SerializableParam>(initialValue: T | ValueFromParam<T, P>, options?: AtomOptions<T>) => (param: P) => WritableState<T>;

package/dist/cache.d.ts

@@ -0,0 +1,27 @@
+export interface Cache<T> {
+    has(key: string): boolean;
+    get(key: string): T | undefined;
+    set(key: string, value: T): void;
+    delete(key: string): boolean;
+    clear(): void;
+}
+export declare class LRUCache<T> implements Cache<T> {
+    #private;
+    constructor(maxSize: number);
+    has(key: string): boolean;
+    get(key: string): T | undefined;
+    set(key: string, value: T): void;
+    delete(key: string): boolean;
+    clear(): void;
+}
+export declare class SimpleCache<T> extends Map<string, T> implements Cache<T> {
+}
+export type CachePolicy = {
+    type: 'keep-all';
+} | {
+    type: 'most-recent';
+} | {
+    type: 'lru';
+    maxSize: number;
+};
+export declare const makeCache: <T>(policy: CachePolicy) => Cache<T>;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './utils';
+export * from './state';
+export * from './atom';
+export * from './selector';
+export type { SerializableParam } from './misc';

package/dist/index.js

@@ -0,0 +1 @@
+import{s as e,R as t,d as s}from"./utils-BY8H9TPH.js";export{r as refresh}from"./utils-BY8H9TPH.js";class c{#e;#t;constructor(e){this.#e=new Map,this.#t=e}#s(){const e=this.#e.keys().next().value;void 0!==e&&this.#e.delete(e)}has(e){return this.#e.has(e)}get(e){if(!this.has(e))return;const t=this.#e.get(e);return this.#e.delete(e),this.#e.set(e,t),t}set(e,t){this.#e.has(e)?this.#e.delete(e):this.#e.size>=this.#t&&this.#s(),this.#e.set(e,t)}delete(e){return this.#e.delete(e)}clear(){this.#e.clear()}}class a extends Map{}const n=e=>{switch(e.type){case"keep-all":return new a;case"most-recent":return new c(1);case"lru":return new c(e.maxSize);default:return e}},i=(e,{effects:t}={})=>{let s=!1,c=e;const a=new Set,r=new Set,n=(e=!1)=>t=>{c=t instanceof Function?t(c):t,a.forEach((e=>e(c))),e||r.forEach((e=>e(c)))};return t?.forEach((e=>e({init(e){s||(c=e)},set:n(!0),onSet(e){r.add(e)}}))),s=!0,{get:()=>c,set:n(),subscribe:e=>(a.add(e),()=>{a.delete(e)})}},h=(t,s)=>{const c=n({type:"keep-all"});return a=>{const r=e(a);return c.has(r)||c.set(r,i(t instanceof Function?t(a):t,s)),c.get(r)}},l=(e,{areValuesEqual:c=s}={})=>{let a,r=!1,n=!1;const i=new Set,h=new Set,l=new Set,o=e=>{let t=e.get();if(!h.has(e)){h.add(e);const s=e.subscribe((e=>{c(t,e)||(t=e,u(),d())}));l.add(s)}return t},u=()=>{a=e({get:o})},d=()=>{i.forEach((e=>e(a)))};return{get:()=>(r||(r=!0,u()),a),subscribe:e=>(0===i.size&&(n=!0),i.add(e),function(){i.delete(e),0===i.size&&(n=!1,l.forEach((e=>e())),l.clear(),h.clear())}),[t](){n?(u(),d()):r=!1}}},o=(t,{areValuesEqual:c=s,cachePolicy:a={type:"keep-all"}}={})=>{const r=n(a);return s=>{const a=e(s);if(!r.has(a)){const e=l(t(s),{areValuesEqual:c}),n=e.get.bind(e);e.get=()=>{const e=n();return e instanceof Promise&&e.catch((()=>{r.delete(a)})),e},r.set(a,e)}return r.get(a)}};export{i as atom,h as atomFamily,l as selector,o as selectorFamily};

package/dist/misc.d.ts

@@ -0,0 +1,7 @@
+export { default as stableStringify } from 'fast-json-stable-stringify';
+type Json = string | number | boolean | null | {
+    [property: string]: Json;
+} | Json[];
+export type SerializableParam = Json;
+export declare const REFRESH_TAG: unique symbol;
+export declare const dejaVu: <T>(a: T, b: T) => boolean;

package/dist/react.d.ts

@@ -0,0 +1,15 @@
+import type { State, ReadonlyState, WritableState } from './state';
+export type AsyncValue<T> = {
+    type: 'loading';
+} | {
+    type: 'ready';
+    value: T;
+} | {
+    type: 'error';
+    reason: string;
+};
+export declare const useStan: <T>(state: WritableState<T>) => readonly [T, import("./state").SetterOrUpdater<T>];
+export declare const useStanValue: <T>(state: State<T>) => T;
+export declare const useStanValueAsync: <T>(state: ReadonlyState<PromiseLike<T>>) => AsyncValue<T>;
+export declare const useSetStanValue: <T>(state: WritableState<T>) => import("./state").SetterOrUpdater<T>;
+export declare const useStanRefresher: (state: ReadonlyState<any>) => () => void;

package/dist/react.js

@@ -0,0 +1 @@
+import{useSyncExternalStore as e,useCallback as t,useState as r,useEffect as s}from"react";import{r as o}from"./utils-BY8H9TPH.js";const n=t=>[e(t.subscribe,t.get),t.set],a=t=>e(t.subscribe,t.get),i=t=>{const o=e(t.subscribe,t.get),[n,a]=r({type:"loading"});return s((()=>{let e=!0;return"loading"!==n.type&&a({type:"loading"}),o.then((t=>{e&&a({type:"ready",value:t})}),(t=>{e&&a({type:"error",reason:t?.message??"unknown"})})),()=>{e=!1}}),[o]),n},p=e=>e.set,u=e=>t((()=>{o(e)}),[e]);export{p as useSetStanValue,n as useStan,u as useStanRefresher,a as useStanValue,i as useStanValueAsync};

package/dist/selector.d.ts

@@ -0,0 +1,18 @@
+import type { ReadonlyState, State } from './state';
+import { type CachePolicy } from './cache';
+import { type SerializableParam } from './misc';
+export interface GetFn {
+    <T>(state: State<T>): T;
+}
+export type SelectorFn<T> = ({ get }: {
+    get: GetFn;
+}) => T;
+export type SelectorOptions = {
+    areValuesEqual?: <T>(a: T, b: T) => boolean;
+};
+export declare const selector: <T>(selectorFn: SelectorFn<T>, { areValuesEqual }?: SelectorOptions) => ReadonlyState<T>;
+export type SelectorFamilyFn<T, P extends SerializableParam> = (param: P) => SelectorFn<T>;
+export type SelectorFamilyOptions = SelectorOptions & {
+    cachePolicy?: CachePolicy;
+};
+export declare const selectorFamily: <T, P extends SerializableParam>(selectorFamilyFn: SelectorFamilyFn<T, P>, { areValuesEqual, cachePolicy, }?: SelectorFamilyOptions) => (param: P) => ReadonlyState<T>;

package/dist/state.d.ts

@@ -0,0 +1,12 @@
+import type { REFRESH_TAG } from './misc';
+export type SetterOrUpdater<T> = (valueOrUpdater: ((currentValue: T) => T) | T) => void;
+export interface State<T> {
+    get(): T;
+    subscribe(callback: (value: T) => void): () => void;
+}
+export interface ReadonlyState<T> extends State<T> {
+    [REFRESH_TAG](): void;
+}
+export interface WritableState<T> extends State<T> {
+    set: SetterOrUpdater<T>;
+}

package/dist/utils-BY8H9TPH.js

@@ -0,0 +1 @@
+function r(r){return r&&r.__esModule&&Object.prototype.hasOwnProperty.call(r,"default")?r.default:r}var t,e;var n=r(e?t:(e=1,t=function(r,t){t||(t={}),"function"==typeof t&&(t={cmp:t});var e,n="boolean"==typeof t.cycles&&t.cycles,o=t.cmp&&(e=t.cmp,function(r){return function(t,n){var o={key:t,value:r[t]},u={key:n,value:r[n]};return e(o,u)}}),u=[];return function r(t){if(t&&t.toJSON&&"function"==typeof t.toJSON&&(t=t.toJSON()),void 0!==t){if("number"==typeof t)return isFinite(t)?""+t:"null";if("object"!=typeof t)return JSON.stringify(t);var e,i;if(Array.isArray(t)){for(i="[",e=0;e<t.length;e++)e&&(i+=","),i+=r(t[e])||"null";return i+"]"}if(null===t)return"null";if(-1!==u.indexOf(t)){if(n)return JSON.stringify("__cycle__");throw new TypeError("Converting circular structure to JSON")}var f=u.push(t)-1,c=Object.keys(t).sort(o&&o(t));for(i="",e=0;e<c.length;e++){var l=c[e],a=r(t[l]);a&&(i&&(i+=","),i+=JSON.stringify(l)+":"+a)}return u.splice(f,1),"{"+i+"}"}}(r)}));const o=Symbol("__refresh__"),u=(r,t)=>r===t,i=r=>{r[o]()};export{o as R,u as d,i as r,n as s};

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+import type { ReadonlyState } from './state';
+export declare const refresh: (state: ReadonlyState<any>) => void;

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@rkrupinski/stan",
+  "description": "Minimal, type-safe state management",
+  "version": "1.0.0-rc10",
+  "exports": {
+    ".": "./dist/index.js",
+    "./react": "./dist/react.js"
+  },
+  "scripts": {
+    "typecheck": "tsc",
+    "lint": "eslint --max-warnings=0",
+    "test": "jest",
+    "build": "rm -rf dist && rollup --config",
+    "prepublishOnly": "yarn typecheck && yarn lint && yarn test && yarn build"
+  },
+  "dependencies": {
+    "fast-json-stable-stringify": "2.1.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.23.0",
+    "@rkrupinski/prettierconfig": "1.0.1",
+    "@rollup/plugin-commonjs": "28.0.3",
+    "@rollup/plugin-node-resolve": "16.0.1",
+    "@rollup/plugin-terser": "0.4.4",
+    "@rollup/plugin-typescript": "12.1.2",
+    "@testing-library/dom": "10.4.0",
+    "@testing-library/react": "16.2.0",
+    "@types/jest": "29.5.14",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "eslint": "^9.23.0",
+    "eslint-plugin-react": "^7.37.4",
+    "globals": "^16.0.0",
+    "jest": "29.7.0",
+    "jest-environment-jsdom": "29.7.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "rollup": "4.37.0",
+    "ts-jest": "29.3.0",
+    "tslib": "2.8.1",
+    "typescript": "5.8.2",
+    "typescript-eslint": "^8.28.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "author": "Rafał Krupiński <rkrupinski.npm@gmail.com> (https://github.com/rkrupinski)",
+  "homepage": "https://github.com/rkrupinski/stan#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rkrupinski/stan.git"
+  },
+  "license": "MIT",
+  "prettier": "@rkrupinski/prettierconfig"
+}