chrono-state-z 1.0.0-z

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Delpi.Kye
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,221 @@
+# ⚙️ chrono-state-z
+
+[![NPM](https://img.shields.io/npm/v/chrono-state-z.svg)](https://www.npmjs.com/package/chrono-state-z)  
+![Downloads](https://img.shields.io/npm/dt/chrono-state-z.svg)  
+
+<a href="https://codesandbox.io/p/sandbox/xt6npl" target="_blank">LIVE EXAMPLE</a>
+
+---
+
+**chrono-state-z** is a **reactive, intent-first runtime**
+with **atoms, computed, async effects, FSM, form engine, and devtools timeline.**
+
+> **Logic lives outside React.** React only renders state and emits intents.
+
+---
+
+## ✨ Why / When to Use
+
+- Zero hooks in UI components
+- Complex async flows (login → fetch → redirect)
+- Predictable & testable side effects
+- Headless testing without rendering
+- Architecture-driven reactive design
+- Devtools timeline for replay & debugging
+
+---
+
+## 📦 Installation
+
+```bash
+npm install chrono-state-z
+```
+
+## 🧠 Mental Model
+
+- Atoms: reactive state units
+- Computed: derived values
+- Effects: middleware-style interceptors
+- FSM / Form: orchestrate async flows & validations
+- Timeline: devtools recording & replay
+- React: purely renders state + emits intents
+
+## Examples
+
+#### 1️⃣ Core Atom + Computed + Scheduler
+```ts
+import { atom, computed } from 'chrono-state-z'
+
+const count = atom(0)
+const double = computed(() => count() * 2)
+
+count.set(5)
+console.log(count())   // 5
+console.log(double())  // 10
+
+count.set(10)
+console.log(count())   // 10
+console.log(double())  // 20
+```
+
+#### 2️⃣ Async Atom + Async Computed
+```ts
+import { asyncAtom, asyncComputed, atom } from 'chrono-state-z'
+
+const value = asyncAtom(async () => {
+  await new Promise(r => setTimeout(r, 100))
+  return 42
+})
+
+value.load().then(v => console.log('AsyncAtom loaded:', v)) // 42
+
+const count = atom(2)
+const doubleAsync = asyncComputed(async () => {
+  await new Promise(r => setTimeout(r, 50))
+  return count() * 2
+})
+
+doubleAsync().then(v => console.log('AsyncComputed:', v)) // 4
+```
+
+#### 3️⃣ Batch / Transaction
+```ts
+import { atom, batch } from 'chrono-state-z'
+
+const a = atom(1)
+const b = atom(2)
+
+batch(() => {
+  a.set(10)
+  b.set(20)
+})
+
+console.log(a(), b()) // 10, 20
+```
+
+#### 4️⃣ FSM Example
+```ts
+import { createFSM } from 'chrono-state-z'
+
+const loginFSM = createFSM({
+  initial: { status: 'idle' },
+  states: {
+    idle: { on: { SUBMIT: ({ state }) => ({ status: 'loading' }) } },
+    loading: { on: { SUCCESS: () => ({ status: 'success' }), FAIL: () => ({ status: 'error' }) } },
+    success: {},
+    error: {},
+  },
+})
+
+await loginFSM.dispatch('SUBMIT')
+console.log(loginFSM.state().status) // 'loading'
+
+await loginFSM.dispatch('SUCCESS')
+console.log(loginFSM.state().status) // 'success'
+
+```
+
+#### 5️⃣ Form Engine + Validation
+```ts
+import { useForm } from 'chrono-state-z'
+
+const loginForm = useForm({
+  username: { initial: '', validate: val => val ? null : 'Required' },
+  password: { initial: '', validate: val => val ? null : 'Required' },
+})
+
+loginForm.fields.username.value.set('admin')
+
+if (loginForm.isValid()) {
+  console.log(loginForm.values())
+} else {
+  console.log('Validation errors exist')
+}
+
+```
+
+#### 6️⃣ React Integration (Headless View)
+```ts
+import React from 'react'
+import { atom, useAtom } from 'chrono-state-z'
+
+const count = atom(0)
+
+function CounterView({ countAtom }: { countAtom: typeof count }) {
+  const value = useAtom(countAtom)
+
+  return (
+    <div>
+      <div>Count: {value}</div>
+      <button onClick={() => countAtom.set(countAtom() + 1)}>+</button>
+    </div>
+  )
+}
+
+export function App() {
+  return <CounterView countAtom={count} />
+}
+
+```
+
+#### 7️⃣ Devtools Timeline & Replay
+```ts
+import { trackNode, schedule } from 'chrono-state-z'
+
+const node = trackNode('count')
+
+schedule(() => {
+  console.log('Replay atom change:', node.value)
+}, 'normal')
+
+```
+
+#### 8️⃣ Effect Subscription
+```ts
+import { effect } from 'chrono-state-z'
+
+const count = atom(0)
+
+const unsubscribe = effect(() => {
+  console.log('Effect triggered:', count())
+})
+
+count.set(1) // logs "Effect triggered: 1"
+
+// cleanup
+unsubscribe()
+
+```
+
+---
+
+## 🔍 Comparison / Features
+| Feature              | chrono-state-z | Redux | Zustand |
+| -------------------- | -------------- | ----- | ------- |
+| Atoms / Computed     | ✅              | ⚠️    | ⚠️      |
+| Async Effects        | ✅              | ⚠️    | ⚠️      |
+| FSM / Form Engine    | ✅              | ❌     | ❌     |
+| Scheduler / Priority | ✅              | ❌     | ❌     |
+| Headless Testing     | ✅              | ⚠️    | ⚠️      |
+| Devtools Timeline    | ✅              | ⚠️    | ❌      |
+
+---
+
+## 🚫 Anti-patterns
+
+- Don’t mutate atoms outside runtime
+- Don’t put business logic inside React
+- Always emit intent or use effects for orchestration
+- Don’t bypass scheduler / computed dependencies
+
+---
+
+## 🧠 Philosophy
+
+- Logic lives outside React
+- Devtools timeline ensures determinism
+- Scheduler + priority enables safe async updates
+
+## 📜 License
+
+MIT / Delpi

package/build/core/asyncAtom.d.ts

@@ -0,0 +1,5 @@
+import { Atom } from './atom';
+export declare function asyncAtom<T>(fetcher: () => Promise<T>): Atom<T | undefined> & {
+    load: () => Promise<T>;
+    cancel: () => void;
+};

package/build/core/asyncComputed.d.ts

@@ -0,0 +1,8 @@
+import { Priority } from './';
+export declare function asyncComputed<T>(getter: () => Promise<T>, options?: {
+    priority?: Priority;
+}): (() => T | undefined) & {
+    load: () => Promise<T> | null;
+    invalidate: (priority?: Priority) => void;
+    node: import("../devtools/graph").GraphNode;
+};

package/build/core/atom.d.ts

@@ -0,0 +1,5 @@
+import { Priority } from './scheduler';
+export type Atom<T> = (() => T) & {
+    set: (v: T, p?: Priority) => void;
+};
+export declare function atom<T>(initial: T): Atom<T>;

package/build/core/batch.d.ts

@@ -0,0 +1 @@
+export declare function batch(fn: () => void): void;

package/build/core/computed.d.ts

@@ -0,0 +1 @@
+export declare function computed<T>(getter: () => T): () => T;

package/build/core/effect.d.ts

@@ -0,0 +1,2 @@
+import { Priority } from './scheduler';
+export declare function effect(fn: () => void, priority?: Priority): () => void;

package/build/core/effectContext.d.ts

@@ -0,0 +1,5 @@
+import type { GraphNode } from '../devtools/graph';
+export declare const effectContext: {
+    activeNode: GraphNode | null;
+    activeEffect: (() => void) | null;
+};

package/build/core/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./atom";
+export * from './asyncAtom';
+export * from "./computed";
+export * from "./effect";
+export * from "./watch";
+export * from "./batch";
+export { schedule } from "./scheduler";
+export type { Priority } from './scheduler';
+export type { Atom } from "./atom";

package/build/core/scheduler.d.ts

@@ -0,0 +1,5 @@
+type Job = () => void;
+export type Priority = 'high' | 'normal' | 'low';
+export declare function schedule(job: Job, priority?: Priority): void;
+export declare function scheduleCancelable(job: Job, priority?: Priority): () => void;
+export {};

package/build/core/transaction.d.ts

@@ -0,0 +1 @@
+export declare function transaction(fn: () => void): void;

package/build/core/watch.d.ts

@@ -0,0 +1,2 @@
+import { Priority } from './scheduler';
+export declare function watch<T>(getter: () => T, callback: (val: T) => void, priority?: Priority): () => void;

package/build/devtools/graph.d.ts

@@ -0,0 +1,22 @@
+export type NodeType = 'atom' | 'computed' | 'effect';
+export type GraphNode = {
+    id: number;
+    name?: string;
+    type: NodeType;
+    value?: any;
+    deps: Set<number>;
+    highlighted?: boolean;
+};
+export type GraphSnapshotNode = {
+    id: number;
+    name?: string;
+    type: NodeType;
+    value?: any;
+    deps: number[];
+    highlighted?: boolean;
+};
+export declare function trackNode(type: NodeType, name?: string, value?: any): GraphNode;
+export declare function linkNodes(from: GraphNode, to: GraphNode): void;
+export declare function getGraphSnapshot(): GraphSnapshotNode[];
+export declare function highlightNode(id: number): void;
+export declare function clearHighlights(): void;

package/build/form/createField.d.ts

@@ -0,0 +1,9 @@
+export declare function createField<T>(initial: T, validate?: (v: T) => string | undefined): {
+    state: import("../core").Atom<{
+        value: T;
+        touched: boolean;
+    }>;
+    error: () => string | undefined;
+    setValue: (v: T) => void;
+    touch: () => void;
+};

package/build/form/nestedForm.d.ts

@@ -0,0 +1,18 @@
+import { Atom } from "../core";
+export type FieldState<T> = {
+    value: T;
+    error: string | null;
+};
+export type FieldSchema<T> = {
+    initial: T;
+    validate?: (val: T) => string | null | Promise<string | null>;
+};
+export declare function createNestedForm<T extends Record<string, any>>(schema: {
+    [K in keyof T]: FieldSchema<T[K]>;
+}): {
+    fields: { [K in keyof T]: Atom<FieldState<T[K]>>; };
+    values: () => T;
+    isValid: () => Promise<boolean>;
+    setField: <K_1 extends keyof T>(key: K_1, value: T[K_1]) => void;
+    submit: () => Promise<T>;
+};

package/build/form/useField.d.ts

@@ -0,0 +1,5 @@
+import { Atom } from '../core';
+export declare function useField<T>(initial: T, validate?: (val: T) => string | null): {
+    value: Atom<T>;
+    error: Atom<string | null>;
+};

package/build/form/useForm.d.ts

@@ -0,0 +1,12 @@
+export declare function useForm<T extends Record<string, any>>(schema: {
+    [K in keyof T]: {
+        initial: T[K];
+        validate?: (val: T[K]) => string | null | Promise<string | null>;
+    };
+}): {
+    fields: Record<keyof T, any>;
+    setField: (key: keyof T, value: any) => void;
+    isValid: () => Promise<boolean>;
+    values: () => T;
+    submit: () => Promise<T>;
+};

package/build/form/validationFSM.d.ts

@@ -0,0 +1,6 @@
+export declare const validationFSM: {
+    state: import("..").Atom<{
+        status: string;
+    }>;
+    dispatch: (type: string, payload?: any) => Promise<void>;
+};

package/build/index.cjs.js

@@ -0,0 +1 @@
+"use strict";var e=require("react"),t=require("react/jsx-runtime");function n(e){var t=Object.create(null);return e&&Object.keys(e).forEach(function(n){if("default"!==n){var o=Object.getOwnPropertyDescriptor(e,n);Object.defineProperty(t,n,o.get?o:{enumerable:!0,get:function(){return e[n]}})}}),t.default=e,Object.freeze(t)}var o=n(e);const r={high:[],normal:[],low:[]};let a=!1;const i=e=>{var t,n,o;for(a=!0;r.high.length||r.normal.length||r.low.length;)if(r.high.length)null===(t=r.high.shift())||void 0===t||t();else if(r.normal.length)null===(n=r.normal.shift())||void 0===n||n();else if(r.low.length){if(void 0!==e&&e.timeRemaining()<1)break;null===(o=r.low.shift())||void 0===o||o()}a=!1,r.low.length>0&&("undefined"!=typeof requestIdleCallback?requestIdleCallback(i):setTimeout(()=>i(),16))};function s(e,t="normal"){r[t].push(e),a||("high"===t?i():"undefined"!=typeof requestIdleCallback?requestIdleCallback(i):setTimeout(()=>i(),16))}const c={activeNode:null,activeEffect:null};let l=0;const u=new Map;function f(e,t,n){const o={id:++l,type:e,name:t,value:n,deps:new Set,highlighted:!1};return u.set(o.id,o),o}function d(e,t){e.deps.add(t.id)}function v(){return Array.from(u.values()).map(e=>({id:e.id,name:e.name,type:e.type,value:e.value,deps:Array.from(e.deps),highlighted:e.highlighted}))}function h(e){let t=e;const n=new Set,o=f("atom"),r=()=>(c.activeNode&&d(c.activeNode,o),c.activeEffect&&n.add(c.activeEffect),t);return r.set=(e,r="normal")=>{Object.is(e,t)||(t=e,o.value=t,n.forEach(e=>s(e,r)))},r}function p(e){let t,n=!0;const o=new Set,r=f("computed"),a=()=>{n||(n=!0,o.forEach(e=>s(e)))};return()=>{if(c.activeNode&&d(c.activeNode,r),c.activeEffect&&o.add(c.activeEffect),n){const o=c.activeNode,i=c.activeEffect;c.activeNode=r,c.activeEffect=a,t=e(),n=!1,c.activeNode=o,c.activeEffect=i}return t}}function m(e,t="normal"){const n=f("effect","Effect"),o=[],r=()=>{try{c.activeNode=n,c.activeEffect=r,e()}catch(e){console.error("[Effect error]",e)}finally{c.activeNode=null,c.activeEffect=null}};return s(r,t),()=>{n.deps.clear(),o.forEach(e=>e())}}function g(e,t,n="normal"){return m(()=>{const n=e();t(n)},n)}const x=new Set;function y(e){e(),x.forEach(e=>s(e)),x.clear()}function w(e){const t=h(e.initial);return{state:t,dispatch:async function(n,o){var r;const a=t(),i=e.states[a.status],s=null===(r=null==i?void 0:i.on)||void 0===r?void 0:r[n];if(s){const e=s({state:a,payload:o}),n=e instanceof Promise?await e:e;y(()=>t.set(n))}}}}const E=w({initial:{status:"idle"},states:{idle:{on:{VALIDATE:()=>({status:"validating"})}},validating:{on:{SUCCESS:()=>({status:"valid"}),ERROR:()=>({status:"invalid"})}},valid:{},invalid:{}}});function b(e){const[,t]=o.useState(0);return o.useEffect(()=>{const n=m(()=>{e(),t(e=>e+1)},"normal");return()=>n()},[e]),e()}exports.DevtoolsReactPanel=function(){const[n,o]=e.useState(v());return e.useEffect(()=>{const e=setInterval(()=>o(v()),100);return()=>clearInterval(e)},[]),t.jsx("div",{style:{fontFamily:"monospace",fontSize:12,background:"#222",color:"#eee",padding:10,maxHeight:300,overflowY:"auto"},children:n.map(e=>t.jsxs("div",{children:["[",e.type,"] ",e.name||"anon"," → deps: ",e.deps.join(", ")]},e.id))})},exports.asyncAtom=function(e){const t=h(void 0);let n=null,o=!1;const r=()=>(n||(n=e().then(e=>(o||t.set(e,"low"),e)),n.finally(()=>n=null)),n);return Object.assign(()=>{const e=t();if(void 0===e)throw r();return e},{set:t.set,load:r,cancel:()=>{o=!0}})},exports.asyncComputed=function(e,t){const n=p(()=>{}),o=f("computed","asyncComputed");let r=null,a=!1,i=null;const l=()=>{if(c.activeNode&&d(c.activeNode,o),r||(a=!1,i=null,r=e().then(e=>(a||n.set(e),e)).catch(e=>{a||(i=e)}).finally(()=>r=null)),i)throw i;if(void 0===n())throw r;return n()};return Object.assign(l,{load:()=>r,invalidate:(e="normal")=>{a=!0,r=null,s(l,(null==t?void 0:t.priority)||e)},node:o})},exports.atom=h,exports.batch=y,exports.clearHighlights=function(){u.forEach(e=>e.highlighted=!1)},exports.computed=p,exports.createFSM=w,exports.createField=function(e,t){const n=h({value:e,touched:!1}),o=p(()=>t?t(n().value):void 0);return{state:n,error:o,setValue:e=>n.set({...n(),value:e}),touch:()=>n.set({...n(),touched:!0})}},exports.createIntentBus=function(){const e=new Map;return{on(t,n){e.set(t,n)},dispatch(t,n){const o=e.get(n.type);o&&o({state:t(),intent:n,setState:t.set})}}},exports.createNestedForm=function(e){const t={};for(const n in e){const o=e[n],r=h({value:o.initial,error:null});o.validate&&g(r,async e=>{try{const t=await o.validate(e.value);y(()=>{r.set({...r(),error:null!=t?t:null})})}catch(e){r.set({...r(),error:e.message})}}),t[n]=r}const n=()=>Object.fromEntries(Object.entries(t).map(([e,t])=>[e,t().value])),o=async()=>(await Promise.all(Object.values(t).map(e=>e().error))).every(e=>null==e);return{fields:t,values:n,isValid:o,setField:(e,n)=>{const o=t[e];o&&y(()=>o.set({...o(),value:n}))},submit:async()=>{if(!await o())throw new Error("Validation failed");return n()}}},exports.effect=m,exports.effectContext=c,exports.getGraphSnapshot=v,exports.highlightNode=function(e){const t=u.get(e);t&&(t.highlighted=!0)},exports.linkNodes=d,exports.schedule=s,exports.scheduleCancelable=function(e,t="normal"){let n=!1;return s(()=>{n||e()},t),()=>{n=!0}},exports.scheduleReactJob=function(t,n="normal"){"low"===n?e.startTransition(t):t()},exports.trackNode=f,exports.transaction=function(e){y(e)},exports.useAtom=b,exports.useBatch=function(){return y},exports.useComputed=function(e){return b(o.useMemo(()=>p(e),[e]))},exports.useEffectReact=function(e,t="normal"){o.useEffect(()=>{const n=m(e,t);return()=>n()},[e,t])},exports.useField=function(e,t){const n=h(e),o=h(null);return t&&g(n,e=>{const n=t(e);o.set(n)}),{value:n,error:o}},exports.useForm=function(e){const t={};for(const n in e){const o=h({value:e[n].initial,error:null});t[n]=o,e[n].validate&&g(o,async t=>{try{const r=await e[n].validate(t.value);y(()=>o.set({...t,error:r}))}catch(e){y(()=>o.set({...t,error:e.message}))}})}const n=async()=>(await Promise.all(Object.values(t).map(e=>e().error))).every(e=>null==e),o=()=>Object.fromEntries(Object.entries(t).map(([e,t])=>[e,t().value]));return{fields:t,setField:(e,n)=>{const o=t[e];o&&y(()=>o.set({...o(),value:n}))},isValid:n,values:o,submit:async()=>{if(!await n())throw new Error("Validation failed");return o()}}},exports.useWatch=function(e,t){o.useEffect(()=>{const n=g(e,t);return()=>null==n?void 0:n()},[e,t])},exports.validationFSM=E,exports.watch=g;

package/build/index.d.ts

@@ -0,0 +1,23 @@
+export * from './core/atom';
+export * from './core/asyncAtom';
+export * from './core/computed';
+export * from './core/asyncComputed';
+export * from './core/effect';
+export * from './core/effectContext';
+export * from './core/watch';
+export * from './core/batch';
+export * from './core/transaction';
+export * from './core/scheduler';
+export * from './runtime/intent';
+export * from './runtime/fsm';
+export * from './form/createField';
+export * from './form/useField';
+export * from './form/useForm';
+export * from './form/nestedForm';
+export * from './form/validationFSM';
+export * from './devtools/graph';
+export * from './react/hooks';
+export { DevtoolsReactPanel } from './react/DevtoolsReactPanel';
+export type { Atom } from './core/atom';
+export type { Priority } from './core/scheduler';
+export type { Intent } from './runtime/intent';

package/build/index.esm.js

@@ -0,0 +1 @@
+import*as t from"react";import e,{startTransition as n}from"react";import{jsx as o,jsxs as a}from"react/jsx-runtime";const i={high:[],normal:[],low:[]};let l=!1;const r=t=>{var e,n,o;for(l=!0;i.high.length||i.normal.length||i.low.length;)if(i.high.length)null===(e=i.high.shift())||void 0===e||e();else if(i.normal.length)null===(n=i.normal.shift())||void 0===n||n();else if(i.low.length){if(void 0!==t&&t.timeRemaining()<1)break;null===(o=i.low.shift())||void 0===o||o()}l=!1,i.low.length>0&&("undefined"!=typeof requestIdleCallback?requestIdleCallback(r):setTimeout(()=>r(),16))};function c(t,e="normal"){i[e].push(t),l||("high"===e?r():"undefined"!=typeof requestIdleCallback?requestIdleCallback(r):setTimeout(()=>r(),16))}function s(t,e="normal"){let n=!1;return c(()=>{n||t()},e),()=>{n=!0}}const u={activeNode:null,activeEffect:null};let f=0;const d=new Map;function v(t,e,n){const o={id:++f,type:t,name:e,value:n,deps:new Set,highlighted:!1};return d.set(o.id,o),o}function h(t,e){t.deps.add(e.id)}function m(){return Array.from(d.values()).map(t=>({id:t.id,name:t.name,type:t.type,value:t.value,deps:Array.from(t.deps),highlighted:t.highlighted}))}function p(t){const e=d.get(t);e&&(e.highlighted=!0)}function g(){d.forEach(t=>t.highlighted=!1)}function y(t){let e=t;const n=new Set,o=v("atom"),a=()=>(u.activeNode&&h(u.activeNode,o),u.activeEffect&&n.add(u.activeEffect),e);return a.set=(t,a="normal")=>{Object.is(t,e)||(e=t,o.value=e,n.forEach(t=>c(t,a)))},a}function w(t){const e=y(void 0);let n=null,o=!1;const a=()=>(n||(n=t().then(t=>(o||e.set(t,"low"),t)),n.finally(()=>n=null)),n);return Object.assign(()=>{const t=e();if(void 0===t)throw a();return t},{set:e.set,load:a,cancel:()=>{o=!0}})}function E(t){let e,n=!0;const o=new Set,a=v("computed"),i=()=>{n||(n=!0,o.forEach(t=>c(t)))};return()=>{if(u.activeNode&&h(u.activeNode,a),u.activeEffect&&o.add(u.activeEffect),n){const o=u.activeNode,l=u.activeEffect;u.activeNode=a,u.activeEffect=i,e=t(),n=!1,u.activeNode=o,u.activeEffect=l}return e}}function b(t,e="normal"){const n=v("effect","Effect"),o=[],a=()=>{try{u.activeNode=n,u.activeEffect=a,t()}catch(t){console.error("[Effect error]",t)}finally{u.activeNode=null,u.activeEffect=null}};return c(a,e),()=>{n.deps.clear(),o.forEach(t=>t())}}function N(t,e,n="normal"){return b(()=>{const n=t();e(n)},n)}const j=new Set;function S(t){t(),j.forEach(t=>c(t)),j.clear()}function O(t,e){const n=E(()=>{}),o=v("computed","asyncComputed");let a=null,i=!1,l=null;const r=()=>{if(u.activeNode&&h(u.activeNode,o),a||(i=!1,l=null,a=t().then(t=>(i||n.set(t),t)).catch(t=>{i||(l=t)}).finally(()=>a=null)),l)throw l;if(void 0===n())throw a;return n()};return Object.assign(r,{load:()=>a,invalidate:(t="normal")=>{i=!0,a=null,c(r,(null==e?void 0:e.priority)||t)},node:o})}function C(t){S(t)}function I(){const t=new Map;return{on(e,n){t.set(e,n)},dispatch(e,n){const o=t.get(n.type);o&&o({state:e(),intent:n,setState:e.set})}}}function k(t){const e=y(t.initial);return{state:e,dispatch:async function(n,o){var a;const i=e(),l=t.states[i.status],r=null===(a=null==l?void 0:l.on)||void 0===a?void 0:a[n];if(r){const t=r({state:i,payload:o}),n=t instanceof Promise?await t:t;S(()=>e.set(n))}}}}function V(t,e){const n=y({value:t,touched:!1}),o=E(()=>e?e(n().value):void 0);return{state:n,error:o,setValue:t=>n.set({...n(),value:t}),touch:()=>n.set({...n(),touched:!0})}}function q(t,e){const n=y(t),o=y(null);return e&&N(n,t=>{const n=e(t);o.set(n)}),{value:n,error:o}}function A(t){const e={};for(const n in t){const o=y({value:t[n].initial,error:null});e[n]=o,t[n].validate&&N(o,async e=>{try{const a=await t[n].validate(e.value);S(()=>o.set({...e,error:a}))}catch(t){S(()=>o.set({...e,error:t.message}))}})}const n=async()=>(await Promise.all(Object.values(e).map(t=>t().error))).every(t=>null==t),o=()=>Object.fromEntries(Object.entries(e).map(([t,e])=>[t,e().value]));return{fields:e,setField:(t,n)=>{const o=e[t];o&&S(()=>o.set({...o(),value:n}))},isValid:n,values:o,submit:async()=>{if(!await n())throw new Error("Validation failed");return o()}}}function R(t){const e={};for(const n in t){const o=t[n],a=y({value:o.initial,error:null});o.validate&&N(a,async t=>{try{const e=await o.validate(t.value);S(()=>{a.set({...a(),error:null!=e?e:null})})}catch(t){a.set({...a(),error:t.message})}}),e[n]=a}const n=()=>Object.fromEntries(Object.entries(e).map(([t,e])=>[t,e().value])),o=async()=>(await Promise.all(Object.values(e).map(t=>t().error))).every(t=>null==t);return{fields:e,values:n,isValid:o,setField:(t,n)=>{const o=e[t];o&&S(()=>o.set({...o(),value:n}))},submit:async()=>{if(!await o())throw new Error("Validation failed");return n()}}}const x=k({initial:{status:"idle"},states:{idle:{on:{VALIDATE:()=>({status:"validating"})}},validating:{on:{SUCCESS:()=>({status:"valid"}),ERROR:()=>({status:"invalid"})}},valid:{},invalid:{}}});function F(t,e="normal"){"low"===e?n(t):t()}function M(e){const[,n]=t.useState(0);return t.useEffect(()=>{const t=b(()=>{e(),n(t=>t+1)},"normal");return()=>t()},[e]),e()}function P(e){return M(t.useMemo(()=>E(e),[e]))}function T(e,n){t.useEffect(()=>{const t=N(e,n);return()=>null==t?void 0:t()},[e,n])}function z(){return S}function D(e,n="normal"){t.useEffect(()=>{const t=b(e,n);return()=>t()},[e,n])}function H(){const[t,n]=e.useState(m());return e.useEffect(()=>{const t=setInterval(()=>n(m()),100);return()=>clearInterval(t)},[]),o("div",{style:{fontFamily:"monospace",fontSize:12,background:"#222",color:"#eee",padding:10,maxHeight:300,overflowY:"auto"},children:t.map(t=>a("div",{children:["[",t.type,"] ",t.name||"anon"," → deps: ",t.deps.join(", ")]},t.id))})}export{H as DevtoolsReactPanel,w as asyncAtom,O as asyncComputed,y as atom,S as batch,g as clearHighlights,E as computed,k as createFSM,V as createField,I as createIntentBus,R as createNestedForm,b as effect,u as effectContext,m as getGraphSnapshot,p as highlightNode,h as linkNodes,c as schedule,s as scheduleCancelable,F as scheduleReactJob,v as trackNode,C as transaction,M as useAtom,z as useBatch,P as useComputed,D as useEffectReact,q as useField,A as useForm,T as useWatch,x as validationFSM,N as watch};

package/build/react/DevtoolsReactPanel.d.ts

@@ -0,0 +1 @@
+export declare function DevtoolsReactPanel(): import("react/jsx-runtime").JSX.Element;

package/build/react/hooks.d.ts

@@ -0,0 +1,7 @@
+import { batch as coreBatch, Priority } from '../core';
+export declare function scheduleReactJob(job: () => void, priority?: Priority): void;
+export declare function useAtom<T>(getter: () => T): T;
+export declare function useComputed<T>(fn: () => T): T;
+export declare function useWatch<T>(getter: () => T, cb: (val: T) => void): void;
+export declare function useBatch(): typeof coreBatch;
+export declare function useEffectReact(fn: () => void, priority?: Priority): void;

package/build/runtime/fsm.d.ts

@@ -0,0 +1,15 @@
+import { Atom } from '../core';
+export declare function createFSM<S extends {
+    status: string;
+}>(config: {
+    initial: S;
+    states: Record<S['status'], {
+        on?: Record<string, (ctx: {
+            state: S;
+            payload?: any;
+        }) => S | Promise<S>>;
+    }>;
+}): {
+    state: Atom<S>;
+    dispatch: (type: string, payload?: any) => Promise<void>;
+};

package/build/runtime/intent.d.ts

@@ -0,0 +1,13 @@
+import { Atom } from '../core';
+export type Intent<P = any> = {
+    type: string;
+    payload?: P;
+};
+export declare function createIntentBus<S>(): {
+    on<K extends string, P>(type: K, fn: (ctx: {
+        state: S;
+        intent: Intent<P>;
+        setState: (v: S) => void;
+    }) => void): void;
+    dispatch<P>(state: Atom<S>, intent: Intent<P>): void;
+};

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "chrono-state-z",
+  "version": "1.0.0-z",
+  "description": "Chrono-state-z: Reactive, intent-first state management with FSM, forms, async atoms.",
+  "license": "MIT",
+  "author": "Delpi.Kye",
+
+  "sideEffects": false,
+
+  "main": "build/index.cjs.js",
+  "module": "build/index.esm.js",
+  "types": "build/index.d.ts",
+
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "import": "./build/index.esm.js",
+      "require": "./build/index.cjs.js"
+    },
+    "./react": {
+      "types": "./build/react/index.d.ts",
+      "import": "./build/react/index.esm.js",
+      "require": "./build/react/index.cjs.js"
+    },
+    "./devtools": {
+      "types": "./build/devtools/index.d.ts",
+      "import": "./build/devtools/index.esm.js",
+      "require": "./build/devtools/index.cjs.js"
+    }
+  },
+
+  "files": ["build"],
+
+  "scripts": {
+    "clean": "rimraf build",
+    "build": "rollup -c",
+    "cb": "npm run clean && npm run build",
+    "prepublishOnly": "npm run cb"
+  },
+
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/delpikye-v/chrono-state.git"
+  },
+
+  "homepage": "https://github.com/delpikye-v/chrono-state#readme",
+  "bugs": {
+    "url": "https://github.com/delpikye-v/chrono-state/issues"
+  },
+
+  "keywords": [
+    "react",
+    "reactive",
+    "state-management",
+    "external-store",
+    "intent-runtime",
+    "fsm",
+    "form-engine",
+    "async-atom",
+    "computed-state",
+    "timeline",
+    "devtools",
+    "no-hooks",
+    "concurrent-safe",
+    "preemption"
+  ],
+
+  "peerDependencies": {
+    "react": "^18.0.0"
+  },
+
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "rimraf": "^5.0.5",
+    "rollup": "^4.9.6",
+    "rollup-plugin-peer-deps-external": "^2.2.4",
+    "rollup-plugin-typescript2": "^0.36.0",
+    "typescript": "^5.3.3",
+    "tslib": "^2.6.2",
+
+    "react": "^18.2.0",
+    "@types/react": "^18.2.43"
+  }
+}