@pithos/core 2.4.0 → 2.5.0

package/dist/autocompletion.d.ts

@@ -10,7 +10,7 @@
  * ❌ const distance = math.geometry.distance; // from autocompletion
  * ✅ import { distance } from 'pithos/math/geometry';
  * 
- * Generated on: 2026-03-29T23:24:53.486Z
+ * Generated on: 2026-04-03T14:52:39.923Z
  * */
 
 /** 
@@ -640,6 +640,9 @@ declare const _autocompletion: {
         observer: {
           createObservable: typeof import('./eidos/observer/observer.js')['createObservable'];
         };
+        observer_lite: {
+          createLiteObservable: typeof import('./eidos/observer/observer-lite.js')['createLiteObservable'];
+        };
         prototype: {
           deepClone: typeof import('./eidos/prototype/prototype.js')['deepClone'];
           deepCloneFull: typeof import('./eidos/prototype/prototype.js')['deepCloneFull'];
@@ -659,6 +662,9 @@ declare const _autocompletion: {
         state: {
           createMachine: typeof import('./eidos/state/state.js')['createMachine'];
         };
+        state_lite: {
+          createLiteMachine: typeof import('./eidos/state/state-lite.js')['createLiteMachine'];
+        };
         strategy: {
           createStrategies: typeof import('./eidos/strategy/strategy.js')['createStrategies'];
           safeStrategy: typeof import('./eidos/strategy/strategy.js')['safeStrategy'];

package/dist/eidos/observer/observer-lite.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Lightweight Observer Pattern — zero external dependencies.
+ *
+ * Provides the same `subscribe` / `notify` / `clear` API as
+ * {@link createObservable}, but without `safeNotify`, `once`, or `size`.
+ * This avoids pulling in `@zygos/result` and keeps the bundle minimal
+ * for consumers who only need basic pub/sub.
+ *
+ * @module eidos/observer/observer-lite
+ * @since 2.5.0
+ *
+ * @example
+ * ```ts
+ * import { createLiteObservable } from "@pithos/core/eidos/observer/observer-lite";
+ *
+ * const onClick = createLiteObservable<{ x: number; y: number }>();
+ *
+ * const unsub = onClick.subscribe(({ x, y }) => console.log(x, y));
+ * onClick.notify({ x: 10, y: 20 }); // logs: 10 20
+ * unsub();
+ * ```
+ */
+/** A listener callback that reacts to emitted values. */
+export type Listener<T> = (value: T) => void;
+/**
+ * A function that removes a listener when called.
+ *
+ * @since 2.5.0
+ */
+export type Unsubscribe = () => void;
+/**
+ * Creates a lightweight observable (pub/sub emitter).
+ *
+ * Only exposes `subscribe`, `notify`, and `clear`.
+ * No dependency on `@zygos/result` — ideal for size-sensitive bundles.
+ *
+ * @template T - The type of values emitted to listeners
+ * @returns Observable with `subscribe`, `notify`, `clear`
+ * @since 2.5.0
+ */
+export declare function createLiteObservable<T>(): {
+    /** Add a listener. Returns an unsubscribe function. */
+    subscribe: (listener: Listener<T>) => Unsubscribe;
+    /** Emit a value to all listeners (fail-fast). */
+    notify: (value: T) => void;
+    /** Remove all listeners. */
+    clear: () => void;
+};
+//# sourceMappingURL=observer-lite.d.ts.map

package/dist/eidos/observer/observer-lite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-lite.d.ts","sourceRoot":"","sources":["../../../src/eidos/observer/observer-lite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,yDAAyD;AACzD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAE7C;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,CAAC;IAIlC,uDAAuD;0BACjC,QAAQ,CAAC,CAAC,CAAC,KAAG,WAAW;IAO/C,iDAAiD;oBACjC,CAAC,KAAG,IAAI;IAMxB,4BAA4B;iBACjB,IAAI;EAIlB"}

package/dist/eidos/observer/observer-lite.js

@@ -0,0 +1,55 @@
+/**
+ * Lightweight Observer Pattern — zero external dependencies.
+ *
+ * Provides the same `subscribe` / `notify` / `clear` API as
+ * {@link createObservable}, but without `safeNotify`, `once`, or `size`.
+ * This avoids pulling in `@zygos/result` and keeps the bundle minimal
+ * for consumers who only need basic pub/sub.
+ *
+ * @module eidos/observer/observer-lite
+ * @since 2.5.0
+ *
+ * @example
+ * ```ts
+ * import { createLiteObservable } from "@pithos/core/eidos/observer/observer-lite";
+ *
+ * const onClick = createLiteObservable<{ x: number; y: number }>();
+ *
+ * const unsub = onClick.subscribe(({ x, y }) => console.log(x, y));
+ * onClick.notify({ x: 10, y: 20 }); // logs: 10 20
+ * unsub();
+ * ```
+ */
+/**
+ * Creates a lightweight observable (pub/sub emitter).
+ *
+ * Only exposes `subscribe`, `notify`, and `clear`.
+ * No dependency on `@zygos/result` — ideal for size-sensitive bundles.
+ *
+ * @template T - The type of values emitted to listeners
+ * @returns Observable with `subscribe`, `notify`, `clear`
+ * @since 2.5.0
+ */
+export function createLiteObservable() {
+    const listeners = new Set();
+    return {
+        /** Add a listener. Returns an unsubscribe function. */
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        /** Emit a value to all listeners (fail-fast). */
+        notify: (value) => {
+            for (const listener of listeners) {
+                listener(value);
+            }
+        },
+        /** Remove all listeners. */
+        clear: () => {
+            listeners.clear();
+        },
+    };
+}
+//# sourceMappingURL=observer-lite.js.map

package/dist/eidos/observer/observer-lite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-lite.js","sourceRoot":"","sources":["../../../src/eidos/observer/observer-lite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAYH;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAe,CAAC;IAEzC,OAAO;QACL,uDAAuD;QACvD,SAAS,EAAE,CAAC,QAAqB,EAAe,EAAE;YAChD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC;QAED,iDAAiD;QACjD,MAAM,EAAE,CAAC,KAAQ,EAAQ,EAAE;YACzB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,KAAK,EAAE,GAAS,EAAE;YAChB,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/eidos/state/state-lite.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Lightweight State Machine — zero external dependencies.
+ *
+ * Same core API as {@link createMachine} (`current`, `send`, `matches`,
+ * `onTransition`, `reset`) but without `trySend` (which pulls `@zygos/option`).
+ *
+ * @module eidos/state/state-lite
+ * @since 2.5.0
+ *
+ * @example
+ * ```ts
+ * import { createLiteMachine } from "@pithos/core/eidos/state/state-lite";
+ *
+ * const light = createLiteMachine({
+ *   green:  { timer: { to: "yellow" } },
+ *   yellow: { timer: { to: "red" } },
+ *   red:    { timer: { to: "green" } },
+ * }, "green");
+ *
+ * light.current();      // "green"
+ * light.send("timer");  // "yellow"
+ * ```
+ */
+/** A simple transition to a target state. */
+export interface SimpleTransition<S extends string> {
+    readonly to: S;
+}
+/**
+ * A transition that also updates context.
+ *
+ * @since 2.5.0
+ */
+export interface ContextTransition<S extends string, C> {
+    readonly to: S;
+    readonly update: (ctx: C) => C;
+}
+/**
+ * A transition is either simple (just target) or with context update.
+ *
+ * @since 2.5.0
+ */
+export type Transition<S extends string, C> = SimpleTransition<S> | ContextTransition<S, C>;
+/**
+ * A transition map for a single state.
+ *
+ * @since 2.5.0
+ */
+export type Transitions<S extends string, E extends string, C> = {
+    readonly [K in E]?: Transition<S, C>;
+};
+/**
+ * Full state machine definition.
+ *
+ * @since 2.5.0
+ */
+export type MachineDefinition<S extends string, E extends string, C> = {
+    readonly [K in S]: Transitions<S, E, C>;
+};
+/**
+ * A transition listener receives the previous state, the event, and the new state.
+ *
+ * @since 2.5.0
+ */
+export type TransitionListener<S extends string, E extends string> = (from: S, event: E, to: S) => void;
+/**
+ * Creates a lightweight finite state machine (no `trySend`, no `@zygos/option` dependency).
+ *
+ * @template S - Union of state names
+ * @template E - Union of event names
+ * @param definition - The state/transition map
+ * @param initial - The initial state
+ * @returns A machine with `current`, `send`, `matches`, `onTransition`, `reset`
+ * @since 2.5.0
+ */
+export declare function createLiteMachine<S extends string, E extends string>(definition: MachineDefinition<S, E, undefined>, initial: S): {
+    current: () => S;
+    send: (event: E) => S;
+    matches: (state: S) => boolean;
+    onTransition: (listener: TransitionListener<S, E>) => () => void;
+    reset: () => void;
+};
+/**
+ * Creates a lightweight finite state machine with context.
+ *
+ * @template S - Union of state names
+ * @template E - Union of event names
+ * @template C - Context type
+ * @param definition - The state/transition map
+ * @param initial - The initial state
+ * @param initialContext - The initial context value
+ * @returns A machine with `current`, `context`, `send`, `matches`, `onTransition`, `reset`
+ * @since 2.5.0
+ */
+export declare function createLiteMachine<S extends string, E extends string, C>(definition: MachineDefinition<S, E, C>, initial: S, initialContext: C): {
+    current: () => S;
+    context: () => C;
+    send: (event: E) => S;
+    matches: (state: S) => boolean;
+    onTransition: (listener: TransitionListener<S, E>) => () => void;
+    reset: () => void;
+};
+//# sourceMappingURL=state-lite.d.ts.map

package/dist/eidos/state/state-lite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-lite.d.ts","sourceRoot":"","sources":["../../../src/eidos/state/state-lite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM;IAChD,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC;IACpD,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;IACf,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IACtC,gBAAgB,CAAC,CAAC,CAAC,GACnB,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE5B;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,IAAI;IAC/D,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;CACrC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,IAAI;IACrE,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;CACxC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,CACnE,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,CAAC,EACR,EAAE,EAAE,CAAC,KACF,IAAI,CAAC;AAQV;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAClE,UAAU,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,EAC9C,OAAO,EAAE,CAAC,GACT;IACD,OAAO,EAAE,MAAM,CAAC,CAAC;IACjB,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;IACtB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;IAC/B,YAAY,EAAE,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC;IACjE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,EACrE,UAAU,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACtC,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,CAAC,GAChB;IACD,OAAO,EAAE,MAAM,CAAC,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,CAAC;IACjB,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;IACtB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;IAC/B,YAAY,EAAE,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC;IACjE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC"}

package/dist/eidos/state/state-lite.js

@@ -0,0 +1,69 @@
+/**
+ * Lightweight State Machine — zero external dependencies.
+ *
+ * Same core API as {@link createMachine} (`current`, `send`, `matches`,
+ * `onTransition`, `reset`) but without `trySend` (which pulls `@zygos/option`).
+ *
+ * @module eidos/state/state-lite
+ * @since 2.5.0
+ *
+ * @example
+ * ```ts
+ * import { createLiteMachine } from "@pithos/core/eidos/state/state-lite";
+ *
+ * const light = createLiteMachine({
+ *   green:  { timer: { to: "yellow" } },
+ *   yellow: { timer: { to: "red" } },
+ *   red:    { timer: { to: "green" } },
+ * }, "green");
+ *
+ * light.current();      // "green"
+ * light.send("timer");  // "yellow"
+ * ```
+ */
+function hasUpdate(t) {
+    return "update" in t;
+}
+export function createLiteMachine(definition, initial, initialContext) {
+    let state = initial;
+    let ctx = initialContext;
+    const listeners = new Set();
+    const send = (event) => {
+        const transitions = definition[state];
+        const transition = transitions[event];
+        if (transition === undefined)
+            return state;
+        const from = state;
+        state = transition.to;
+        // Stryker disable next-line ConditionalExpression: ctx check is defensive - TypeScript prevents update on machines without context
+        if (hasUpdate(transition) && ctx !== undefined) {
+            ctx = transition.update(ctx);
+        }
+        for (const listener of listeners) {
+            listener(from, event, state);
+        }
+        return state;
+    };
+    const onTransition = (listener) => {
+        listeners.add(listener);
+        return () => { listeners.delete(listener); };
+    };
+    const base = {
+        current: () => state,
+        send,
+        matches: (s) => state === s,
+        onTransition,
+        reset: () => {
+            state = initial;
+            ctx = initialContext;
+        },
+    };
+    if (initialContext !== undefined) {
+        return {
+            ...base,
+            context: () => ctx,
+        };
+    }
+    return base;
+}
+//# sourceMappingURL=state-lite.js.map

package/dist/eidos/state/state-lite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-lite.js","sourceRoot":"","sources":["../../../src/eidos/state/state-lite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAuDH,SAAS,SAAS,CAChB,CAAmB;IAEnB,OAAO,QAAQ,IAAI,CAAC,CAAC;AACvB,CAAC;AAgDD,MAAM,UAAU,iBAAiB,CAC/B,UAAsC,EACtC,OAAU,EACV,cAAkB;IAElB,IAAI,KAAK,GAAM,OAAO,CAAC;IACvB,IAAI,GAAG,GAAkB,cAAc,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEtD,MAAM,IAAI,GAAG,CAAC,KAAQ,EAAK,EAAE;QAC3B,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,UAAU,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAE3C,MAAM,IAAI,GAAG,KAAK,CAAC;QACnB,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC;QAEtB,mIAAmI;QACnI,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC/C,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,CAAC,QAAkC,EAAgB,EAAE;QACxE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG;QACX,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK;QACpB,IAAI;QACJ,OAAO,EAAE,CAAC,CAAI,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC;QAC9B,YAAY;QACZ,KAAK,EAAE,GAAG,EAAE;YACV,KAAK,GAAG,OAAO,CAAC;YAChB,GAAG,GAAG,cAAc,CAAC;QACvB,CAAC;KACF,CAAC;IAEF,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO;YACL,GAAG,IAAI;YACP,OAAO,EAAE,GAAG,EAAE,CAAC,GAAQ;SACxB,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pithos/core",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Advanced JavaScript/TypeScript superset providing utilities, validation, and functional patterns",
   "type": "module",
   "publishConfig": {