@tmjeee/w-lib 0.0.1 → 0.1.0

package/CHANGELOG.md

@@ -5,18 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.0.1] - 2026-05-27
+## [0.1.0] - 2026-05-29
+- added initial version of
+  - event emitter
+  - state management
+  - finite state machine
+  - loading states
 
-### Added
+## [0.0.1] - 2026-05-27
 - Initial library skeleton for npm publishing
-- `helloWorld()` sample function exported as the public API
-- Full ESM + CJS dual package support via tsdown
+- Full ESM package support via tsdown
 - TypeScript strict configuration
 - Vitest test suite with coverage
-- `examples/basic.ts` runnable usage example
-- Complete publish-ready `package.json` (exports map, files, sideEffects, publishConfig)
 - MIT license and minimal conventional changelog
-
-### Notes
-- This is the bootstrap release of the w-lib skeleton.
-- Ready for `npm publish --access public`.

package/README.md

@@ -3,9 +3,12 @@
 [![npm version](https://img.shields.io/npm/v/@tmjeee/w-lib.svg)](https://www.npmjs.com/package/@tmjeee/w-lib)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A minimal, modern TypeScript library skeleton ready for publishing to npmjs.com.
+Disclaimer: Contains codes from [jyoung4242](https://github.com/jyoung4242/Game-Dev-Library).
 
-This package demonstrates current (2026) best practices for shipping small, tree-shakeable, dual-format (ESM + CJS) libraries with excellent TypeScript support.
+## Development
+See [here](./README_DEV.md) for more info.
+
+A minimal, Angular and TypeScript library.
 
 ## Installation
 
@@ -17,164 +20,120 @@ npm install @tmjeee/w-lib
 
 This package is **ESM-only**.
 
-```ts
-import { helloWorld } from '@tmjeee/w-lib';
-
-console.log(helloWorld()); // "Hello, world!"
-```
-
-> **Note**: CommonJS (`require()`) is not supported.  
-> If you are in a CommonJS environment, use dynamic import instead:
-> ```js
-> const { helloWorld } = await import('@tmjeee/w-lib');
-> ```
-
-For more information, see the [Node.js documentation on publishing ESM packages](https://nodejs.org/en/learn/modules/publishing-a-package).
-
-## API
-
-### `helloWorld(): string`
-
-Returns the classic greeting.
-
-```ts
-helloWorld(); // "Hello, world!"
-```
-
-## Development
-
-```bash
-# Install dependencies
-npm install
-
-# Type check
-npm run typecheck
-
-# Run tests (once, exits after completion)
-npm test
-
-# Run tests in watch mode (for development)
-npm run test:watch
-
-# Run tests with coverage
-npm run test:coverage
-
-# Build (outputs to dist/)
-npm run build
-
-# Watch mode during development
-npm run dev
-```
-
-### Project Structure
-
-```
-src/index.ts          # Source (helloWorld)
-test/index.test.ts    # Vitest tests
-examples/basic.ts     # Runnable usage demo
-dist/                 # Build output (generated)
-```
-
-## Publishing
-
-This package is configured for immediate publishing.
 
-### Recommended: One-command publish
+### loading-state
+```typescript
+import {createLoadingState} from '@tmjeee/w-lib';
 
-```bash
-# Bump version first (patch / minor / major)
-npm version patch
+const loadingState = createLoadingState();
+loadingState.withLoading('assets', async ()=>{
+   // xhr calls, long running calls
+   // loadingState.is('asset');  will be true while this function is running else false
+});
 
-# Dry-run first (highly recommended)
-npm run publish:npm:dry
+const isLoading = loadingState.is('assets'); // signal<boolean> - true when loading else false
 
-# Then publish for real
-npm run publish:npm
+loadingState.set('assets', false); // explicitly mark 'asset' as false 
 ```
 
-### Manual / step-by-step (with safety checks)
-
-```bash
-# 1. Make sure everything is clean
-npm run typecheck && npm test && npm run build
-# (npm test now runs once and exits automatically)
-
-# 2. Dry-run the publish (strongly recommended)
-npm publish --dry-run --access public
-
-# 3. Bump version
-npm version patch
-
-# 4. Publish
-npm publish --access public
+### Finite state machine 
+```typescript
+import {FsmState, Fsm} from '@tmjeee/w-lib';
+
+  class State1 extends FsmState {
+    enter(prevState: FsmState | null, ...params: any) {
+      console.log(`[State1] enter`);
+    }
+    exit(nextState: FsmState | null, ...params: any) {
+      console.log(`[State1] exit`);
+    }
+    update(...params: any) {
+      console.log(`[State1] update`);
+    }
+  }
+
+
+  class State2 extends FsmState {
+    enter(prevState: FsmState | null, ...params: any) {
+      console.log(`[State2] enter`);
+    }
+    exit(nextState: FsmState | null, ...params: any) {
+      console.log(`[State2] exit`);
+    }
+    update(...params: any) {
+      console.log(`[State2] update`);
+    }
+  }
+
+  const fsm = new Fsm();
+  fsm.register(
+    new State1(`state1`),
+    new State2(`state2`),
+  );
+
+  fsm.set('state1', {});  // state1.enter(...)
+  fsm.update();           // state1.update({})
+  fsm.set('state2');      // state1.exit(...) then state2.enter(...)
+  fsm.update();           // state2.update({});
+  fsm.get();              // return current state -> state2
 ```
 
-The `prepublishOnly` hook (and both `publish:npm*` scripts) ensure that `build` + `test` run before anything is published.
-
-### What gets published?
-
-Only the contents of the `dist/` folder plus `package.json`, `README.md`, `LICENSE`, and `CHANGELOG.md` (controlled via the `"files"` field).
-
-### Automated publishing with GitHub Actions
-
-This repository includes two GitHub Actions workflows:
-
-- **`.github/workflows/ci.yml`** — Runs type checking and tests on every push and pull request. Can also be triggered manually from the Actions tab.
-- **`.github/workflows/publish.yml`** — Publishes to npmjs.com when you create a new GitHub Release. Can also be triggered manually from the Actions tab (use with caution).
 
-#### Setup steps (one time)
-
-1. Create an npm access token:
-   - Go to https://www.npmjs.com/settings/~tokens
-   - Generate a new **Automation** token (or **Granular** with publish permission for `@tmjeee/w-lib`)
-2. Add the token as a repository secret:
-   - In your GitHub repo → **Settings → Secrets and variables → Actions**
-   - Create a new secret named `NPM_TOKEN` with the value from step 1
-3. (Optional but recommended) Enable npm **Trusted Publishing** (OIDC) for passwordless publishing:
-   - See the comments in `publish.yml` and https://docs.npmjs.com/trusted-publishers
-
-#### How to release
-
-```bash
-# 1. Update CHANGELOG.md
-# 2. Commit everything
-git add .
-git commit -m "chore: prepare v0.0.2"
-
-# 3. Create a version tag + GitHub Release
-npm version patch
-git push && git push --tags
-
-# 4. Go to GitHub → Releases → "Draft a new release"
-#    - Choose the tag you just pushed
-#    - Publish the release
-
-# → The publish workflow will run automatically and publish to npm
-
-**Alternative**: You can also manually trigger the publish workflow from the GitHub repo → **Actions** tab → **"Publish to npmjs"** → **"Run workflow"**.
+### State Management
+```typescript
+  const store = createStateStore<State>({
+    name: 'jim',
+    age: 12,
+    address: {
+      address1: '1 Kent Street',
+      address2: 'Sydney',
+      postcode: '2000',
+    }
+  });
+
+
+  const address1 = store.get('address.address1');
+  store.on('change', (change) => {
+    const state = change.state;
+    const previousState = change.previousState;
+    const value = change.value;
+    const previousValue = change.previousValue;
+
+    console.log(`change`, state, previousState, value, previousValue);
+  });
+
+  // all the following will trigger 'change' event
+  store.update('address', (address) => ({address1: 'new address1', address2: 'new address2', postcode: 'new postcode'}));
+  store.update('name', (name) => `name-${new Date()}`);
+  store.set('name', 'name1');
+  store.patch({age: 2, name: 'test'});
+  store.batch((ctx) => {
+    ctx.set('age', 1);
+    ctx.update('age', (age)=>age + 1);
+    ctx.patch({age: 2, name: 'test'});
+  });
 ```
 
-## Tooling
-
-- **Build**: [tsdown](https://tsdown.dev/) (Rolldown + Oxc)
-- **Testing**: [Vitest](https://vitest.dev/)
-- **TypeScript**: Strict mode, ES2022 target, bundler resolution
-
-### Optional: Add oxlint + oxfmt
 
-For consistency with other `@tmjeee` projects you can add:
-
-```bash
-npm install -D oxlint oxfmt
+### Event Emitter
+```typescript
+  const emitter1 = new JsEventEmitter();
+  const emitter2 = new JsEventEmitter();
+  emitter1.on('test',()=>{
+    console.log(`[Emitter1] Receive test event`);
+  });
+  emitter2.once('test', ()=>{
+    console.log(`[Emitter2] Receive test event - once only`);
+  });
+  emitter1.emit('test', {test: 'test1'});
+  emitter1.emit('test', {test: 'test2'});
+  emitter2.emit('test', {test: 'test1'});
+  emitter2.emit('test', {test: 'test2'});
+  emitter1.off('test'); // turn off listening
+  emitter1.emit('test', {test: 'test3'});
 ```
 
-Then add scripts:
 
-```json
-"lint": "oxlint",
-"format": "oxfmt --check",
-"format:fix": "oxfmt --write"
-```
 
 ## License
 

package/dist/index.d.ts

@@ -1,17 +1,144 @@
-//#region src/index.d.ts
+import { Signal } from "@angular/core";
+import { Subject } from "rxjs";
+
+//#region src/loading-state.d.ts
 /**
- * Classic hello world sample for the w-lib skeleton.
+ * A lightweight utility for managing per-action loading states using signals.
  *
- * @returns The canonical greeting string
+ * Philosophy:
+ * - Most errors should propagate to GlobalErrorHandler.
+ * - This utility helps manage UI loading states cleanly without forcing try/catch everywhere.
+ * - Use it when you need to disable buttons / show spinners during async actions.
  *
- * @example
- * ```ts
- * import { helloWorld } from '@tmjeee/w-lib';
+ * Recommended usage:
  *
- * console.log(helloWorld()); // "Hello, world!"
- * ```
+ * const loading = createLoadingState<'creatingBoard' | 'deletingBoard'>();
+ *
+ * async createBoard() {
+ *   const title = await openDialog();
+ *   if (!title) return;
+ *
+ *   await loading.withLoading('creatingBoard', async () => {
+ *     const board = await this.boardService.createBoard(...);
+ *     this.router.navigate(...);
+ *   });
+ * }
+ *
+ * In template:
+ * <button [disabled]="loading.is('creatingBoard')()">
+ *   {{ loading.is('creatingBoard')() ? 'Creating...' : 'Create Board' }}
+ * </button>
+ */
+declare function createLoadingState<T extends string = string>(): {
+  is: (key: T) => Signal<boolean>;
+  set: (key: T, value: boolean) => void;
+  withLoading: <R>(key: T, fn: () => Promise<R>) => Promise<R>;
+  states: Signal<Partial<Record<T, boolean>>>;
+};
+/**
+ * Type helper for action loading keys.
+ * Example: type UserAction = 'addingToWorkspace' | 'removingFromWorkspace';
  */
-declare function helloWorld(): string;
+type LoadingKey = string;
+//#endregion
+//#region src/event-emitter.d.ts
+interface EventEmitterHandler<T> {
+  (change: T): void;
+}
+interface EventEmitterSubscription {
+  unsubscribe: () => void;
+}
+interface EventEmitter<T> {
+  emit(event: string, payload: T): void;
+  on(event: string, handler: EventEmitterHandler<T>): void;
+  off(event: string, handler?: EventEmitterHandler<T>): void;
+  once(event: string, handler: EventEmitterHandler<T>): void;
+}
+declare class RxEventEmitter<T> implements EventEmitter<T> {
+  _listeners: Record<string, Subject<T>>;
+  emit(event: string, payload: T): void;
+  on(event: string, handler: EventEmitterHandler<T>): void;
+  off(event: string, handler?: EventEmitterHandler<T>): void;
+  once(event: string, handler: EventEmitterHandler<T>): void;
+}
+declare class JsEventEmitter<T> implements EventEmitter<T> {
+  _listeners: Record<string, EventEmitterHandler<T>[]>;
+  emit(event: string, payload: T): void;
+  on(event: string, handler: EventEmitterHandler<T>): void;
+  off(event: string, handler?: EventEmitterHandler<T>): void;
+  once(event: string, handler: EventEmitterHandler<T>): void;
+}
+//#endregion
+//#region src/state-management.d.ts
+type Primitive = string | number | boolean | null | undefined;
+type PathsOf<T, Prefix extends string = ""> = T extends Primitive ? never : T extends Array<infer _> ? never : { [K in keyof T & string]: Prefix extends "" ? K | (T[K] extends Primitive ? never : PathsOf<T[K], K>) : `${Prefix}.${K}` | (T[K] extends Primitive ? never : PathsOf<T[K], `${Prefix}.${K}`>) }[keyof T & string];
+type Path<T> = PathsOf<T>;
+type PathValue<T, P extends string> = P extends keyof T ? T[P] : P extends `${infer K}.${infer Rest}` ? K extends keyof T ? Rest extends Path<T[K]> ? PathValue<T[K], Rest> : never : never : never;
+interface ChangePayload<State, V = unknown> {
+  path: string;
+  previousValue: V;
+  value: V;
+  previousState: Readonly<State>;
+  state: Readonly<State>;
+}
+type ChangeEventMap<State> = {
+  change: ChangePayload<State>;
+  [key: `change:${string}`]: ChangePayload<State>;
+};
+interface StateStore<State extends object> {
+  get(): Readonly<State>;
+  get<K extends Path<State>>(path: K): Readonly<PathValue<State, K>>;
+  select<T>(selector: (state: Readonly<State>) => T): Readonly<T>;
+  set<K extends Path<State>>(path: K, value: PathValue<State, K>): void;
+  update<K extends Path<State>>(path: K, fn: (current: PathValue<State, K>) => PathValue<State, K>): void;
+  patch(partial: DeepPartial<State>): void;
+  batch(fn: (store: BatchContext<State>) => void): void;
+  on<E extends keyof ChangeEventMap<State>>(event: E, handler: (payload: ChangeEventMap<State>[E]) => void): void;
+  off<E extends keyof ChangeEventMap<State>>(event: E, handler: (payload: ChangeEventMap<State>[E]) => void): void;
+  subscribe<K extends Path<State>>(path: K, handler: (payload: ChangePayload<State, PathValue<State, K>>) => void): () => void;
+  serialize(): string;
+  reset(): void;
+}
+interface BatchContext<State extends object> {
+  set<K extends Path<State>>(path: K, value: PathValue<State, K>): void;
+  update<K extends Path<State>>(path: K, fn: (current: PathValue<State, K>) => PathValue<State, K>): void;
+  patch(partial: DeepPartial<State>): void;
+}
+type DeepPartial<T> = T extends Primitive ? T : { [K in keyof T]?: DeepPartial<T[K]> };
+declare function createStateStore<State extends object>(initialState: State, eventEmitter?: EventEmitter<ChangePayload<State>>): StateStore<State>;
+//#endregion
+//#region src/finite-state-machine.d.ts
+type FsmResult<T = void> = {
+  success: boolean;
+  message?: string;
+  value?: T;
+};
+declare class Fsm {
+  states: Map<string, FsmState>;
+  current: FsmState | null;
+  currentParams: any[];
+  currentTime: number;
+  constructor();
+  /** Register new states, returns array of registered ExState */
+  register(...types: (string | FsmState)[]): FsmResult<FsmState[]>;
+  /** Change current state */
+  set(state: string | FsmState, ...params: any[]): FsmResult<FsmState> | Promise<FsmResult<FsmState>>;
+  /** Check if a state is registered */
+  has(state: string | FsmState): boolean;
+  /** Get current state */
+  get(): FsmResult<FsmState>;
+  /** Reset FSM */
+  reset(): FsmResult<void>;
+  /** Update current state */
+  update(): FsmResult<void> | Promise<FsmResult<void>>;
+}
+declare class FsmState {
+  name: string;
+  constructor(name: string);
+  enter(_previous: FsmState | null, ..._params: any): void | Promise<void>;
+  exit(_next: FsmState | null, ..._params: any): void | Promise<void>;
+  update(..._params: any): void | Promise<void>;
+}
 //#endregion
-export { helloWorld };
+export { BatchContext, ChangePayload, EventEmitter, EventEmitterHandler, EventEmitterSubscription, Fsm, FsmResult, FsmState, JsEventEmitter, LoadingKey, Path, PathValue, RxEventEmitter, StateStore, createLoadingState, createStateStore };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;AAYA;;;;;;;;;;;iBAAgB,UAAA,CAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/loading-state.ts","../src/event-emitter.ts","../src/state-management.ts","../src/finite-state-machine.ts"],"mappings":"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"}

package/dist/index.js

@@ -1,20 +1,428 @@
-//#region src/index.ts
+import { computed, signal } from "@angular/core";
+import { Subject } from "rxjs";
+import { take } from "rxjs/operators";
+
+//#region src/loading-state.ts
 /**
-* Classic hello world sample for the w-lib skeleton.
+* A lightweight utility for managing per-action loading states using signals.
+*
+* Philosophy:
+* - Most errors should propagate to GlobalErrorHandler.
+* - This utility helps manage UI loading states cleanly without forcing try/catch everywhere.
+* - Use it when you need to disable buttons / show spinners during async actions.
+*
+* Recommended usage:
 *
-* @returns The canonical greeting string
+* const loading = createLoadingState<'creatingBoard' | 'deletingBoard'>();
 *
-* @example
-* ```ts
-* import { helloWorld } from '@tmjeee/w-lib';
+* async createBoard() {
+*   const title = await openDialog();
+*   if (!title) return;
 *
-* console.log(helloWorld()); // "Hello, world!"
-* ```
+*   await loading.withLoading('creatingBoard', async () => {
+*     const board = await this.boardService.createBoard(...);
+*     this.router.navigate(...);
+*   });
+* }
+*
+* In template:
+* <button [disabled]="loading.is('creatingBoard')()">
+*   {{ loading.is('creatingBoard')() ? 'Creating...' : 'Create Board' }}
+* </button>
 */
-function helloWorld() {
-	return "Hello, world!";
+function createLoadingState() {
+	const loadingMap = signal({});
+	const signalCache = /* @__PURE__ */ new Map();
+	/**
+	* Returns a reactive signal indicating if a specific action is loading.
+	* The returned signal is stable (same reference) for the same key.
+	*/
+	const is = (key) => {
+		if (!signalCache.has(key)) signalCache.set(key, computed(() => loadingMap()[key] ?? false));
+		return signalCache.get(key);
+	};
+	/**
+	* Manually set the loading state for a key.
+	*/
+	const set = (key, value) => {
+		loadingMap.update((map) => ({
+			...map,
+			[key]: value
+		}));
+	};
+	/**
+	* Runs an async function while automatically managing the loading state.
+	* Errors are allowed to propagate (as per project convention).
+	*/
+	const withLoading = async (key, fn) => {
+		set(key, true);
+		try {
+			return await fn();
+		} finally {
+			set(key, false);
+		}
+	};
+	return {
+		is,
+		set,
+		withLoading,
+		states: loadingMap.asReadonly()
+	};
+}
+
+//#endregion
+//#region src/event-emitter.ts
+var RxEventEmitter = class {
+	_listeners = {};
+	emit(event, payload) {
+		const handlers = this._listeners[event];
+		if (handlers) handlers.next(payload);
+	}
+	on(event, handler) {
+		if (!this._listeners[event]) this._listeners[event] = new Subject();
+		this._listeners[event].subscribe(handler);
+	}
+	off(event, handler) {
+		if (this._listeners[event]) {
+			this._listeners[event].complete();
+			delete this._listeners[event];
+		}
+	}
+	once(event, handler) {
+		if (!this._listeners[event]) this._listeners[event] = new Subject();
+		this._listeners[event].pipe(take(1)).subscribe(handler);
+	}
+};
+var JsEventEmitter = class {
+	_listeners = {};
+	emit(event, payload) {
+		const handlers = this._listeners[event];
+		if (handlers && handlers.length) handlers.forEach((h) => {
+			h(payload);
+		});
+	}
+	on(event, handler) {
+		if (!this._listeners[event]) this._listeners[event] = [];
+		if (!this._listeners[event].find((h) => h == handler)) this._listeners[event].push(handler);
+	}
+	off(event, handler) {
+		if (!this._listeners[event]) this._listeners[event] = [];
+		if (handler) {
+			const idx = this._listeners[event].findIndex((h) => h == handler);
+			if (idx >= 0) this._listeners[event].splice(idx, 1);
+		} else delete this._listeners[event];
+	}
+	once(event, handler) {
+		if (!this._listeners[event]) this._listeners[event] = [];
+		const onceOnlyHandler = (evt) => {
+			try {
+				handler(evt);
+			} finally {
+				this.off(event, onceOnlyHandler);
+			}
+		};
+		this._listeners[event].push(onceOnlyHandler);
+	}
+};
+
+//#endregion
+//#region src/state-management.ts
+function parsePath(path) {
+	return path.split(".");
 }
+function deepFreeze(obj) {
+	if (obj === null || typeof obj !== "object") return obj;
+	Object.getOwnPropertyNames(obj).forEach((name) => {
+		const val = obj[name];
+		if (val && typeof val === "object") deepFreeze(val);
+	});
+	return Object.freeze(obj);
+}
+function deepClone(obj) {
+	if (obj === null || typeof obj !== "object") return obj;
+	if (Array.isArray(obj)) return obj.map(deepClone);
+	const result = {};
+	for (const key of Object.keys(obj)) result[key] = deepClone(obj[key]);
+	return result;
+}
+function getAtPath(obj, segments) {
+	let current = obj;
+	for (const seg of segments) {
+		if (current === null || typeof current !== "object") throw new Error(`Invalid path segment "${seg}": not an object`);
+		current = current[seg];
+	}
+	return current;
+}
+function setAtPath(obj, segments, value) {
+	if (segments.length === 0) return value;
+	const [head, ...tail] = segments;
+	if (typeof obj !== "object" || obj === null) throw new Error(`Cannot set path on non-object at segment "${head}"`);
+	const record = obj;
+	const updated = { ...record };
+	if (tail.length === 0) updated[head] = value;
+	else {
+		const child = record[head];
+		if (child === null || typeof child !== "object") throw new Error(`Path segment "${head}" is not an object`);
+		updated[head] = setAtPath(child, tail, value);
+	}
+	return updated;
+}
+function shallowEqual(a, b) {
+	if (a === b) return true;
+	if (a === null || b === null) return false;
+	if (typeof a !== "object" || typeof b !== "object") return false;
+	const keysA = Object.keys(a);
+	const keysB = Object.keys(b);
+	if (keysA.length !== keysB.length) return false;
+	for (const k of keysA) if (a[k] !== b[k]) return false;
+	return true;
+}
+function deepMerge(base, partial) {
+	const result = { ...base };
+	for (const key of Object.keys(partial)) {
+		const pVal = partial[key];
+		const bVal = base[key];
+		if (pVal !== void 0 && pVal !== null && typeof pVal === "object" && !Array.isArray(pVal) && bVal !== null && typeof bVal === "object") result[key] = deepMerge(bVal, pVal);
+		else if (pVal !== void 0) result[key] = pVal;
+	}
+	return result;
+}
+function createStateStore(initialState, eventEmitter = new JsEventEmitter()) {
+	const _initial = deepFreeze(deepClone(initialState));
+	let _state = _initial;
+	const _emitter = eventEmitter;
+	function _emit(path, previousValue, value, previousState) {
+		const payload = {
+			path,
+			previousValue,
+			value,
+			previousState,
+			state: _state
+		};
+		_emitter.emit("change", payload);
+		_emitter.emit(`change:${path}`, payload);
+	}
+	function _applySet(currentState, segments, value) {
+		return deepFreeze(setAtPath(deepClone(currentState), segments, value));
+	}
+	function get(path) {
+		if (path === void 0) return _state;
+		const segments = parsePath(path);
+		return deepFreeze(deepClone(getAtPath(_state, segments)));
+	}
+	function select(selector) {
+		const result = selector(_state);
+		if (result !== null && typeof result === "object") return deepFreeze(deepClone(result));
+		return result;
+	}
+	function set(path, value) {
+		const segments = parsePath(path);
+		const previousValue = getAtPath(_state, segments);
+		if (shallowEqual(previousValue, value)) return;
+		const previousState = _state;
+		_state = _applySet(_state, segments, value);
+		_emit(path, previousValue, value, previousState);
+	}
+	function update(path, fn) {
+		const segments = parsePath(path);
+		set(path, fn(deepClone(getAtPath(_state, segments))));
+	}
+	function patch(partial) {
+		const nextState = deepFreeze(deepMerge(_state, partial));
+		const changedPaths = [];
+		collectChangedPaths("", _state, nextState, changedPaths);
+		if (changedPaths.length === 0) return;
+		const previousState = _state;
+		_state = nextState;
+		for (const entry of changedPaths) _emit(entry.path, entry.prev, entry.next, previousState);
+	}
+	function collectChangedPaths(prefix, prev, next, out) {
+		if (prev === next) return;
+		if (prev !== null && next !== null && typeof prev === "object" && typeof next === "object" && !Array.isArray(prev) && !Array.isArray(next)) {
+			const allKeys = new Set([...Object.keys(prev), ...Object.keys(next)]);
+			for (const k of allKeys) {
+				const pv = prev[k];
+				const nv = next[k];
+				collectChangedPaths(prefix ? `${prefix}.${k}` : k, pv, nv, out);
+			}
+		} else if (!shallowEqual(prev, next)) out.push({
+			path: prefix,
+			prev,
+			next
+		});
+	}
+	function batch(fn) {
+		let pendingState = _state;
+		const changes = [];
+		const ctx = {
+			set(path, value) {
+				const segments = parsePath(path);
+				const previousValue = getAtPath(pendingState, segments);
+				if (shallowEqual(previousValue, value)) return;
+				const prevState = pendingState;
+				pendingState = deepFreeze(setAtPath(deepClone(pendingState), segments, value));
+				changes.push({
+					path,
+					prev: previousValue,
+					next: value,
+					prevState
+				});
+			},
+			update(path, fn2) {
+				const segments = parsePath(path);
+				const next = fn2(deepClone(getAtPath(pendingState, segments)));
+				ctx.set(path, next);
+			},
+			patch(partial) {
+				const merged = deepFreeze(deepMerge(pendingState, partial));
+				const changedPaths = [];
+				collectChangedPaths("", pendingState, merged, changedPaths);
+				if (changedPaths.length === 0) return;
+				const prevState = pendingState;
+				pendingState = merged;
+				for (const entry of changedPaths) changes.push({
+					path: entry.path,
+					prev: entry.prev,
+					next: entry.next,
+					prevState
+				});
+			}
+		};
+		fn(ctx);
+		if (pendingState === _state) return;
+		_state = pendingState;
+		for (const change of changes) _emit(change.path, change.prev, change.next, change.prevState);
+	}
+	function on(event, handler) {
+		_emitter.on(event, handler);
+	}
+	function off(event, handler) {
+		_emitter.off(event, handler);
+	}
+	function subscribe(path, handler) {
+		const eventName = `change:${path}`;
+		const wrapped = (payload) => handler(payload);
+		_emitter.on(eventName, wrapped);
+		return () => _emitter.off(eventName, wrapped);
+	}
+	function serialize() {
+		return JSON.stringify(_state);
+	}
+	function reset() {
+		const previousState = _state;
+		_state = _initial;
+		const changes = [];
+		collectChangedPaths("", previousState, _state, changes);
+		for (const change of changes) _emit(change.path, change.prev, change.next, previousState);
+	}
+	return {
+		get,
+		select,
+		set,
+		update,
+		patch,
+		batch,
+		on,
+		off,
+		subscribe,
+		serialize,
+		reset
+	};
+}
+
+//#endregion
+//#region src/finite-state-machine.ts
+var Fsm = class {
+	states = /* @__PURE__ */ new Map();
+	current = null;
+	currentParams = [];
+	currentTime = 0;
+	constructor() {}
+	/** Register new states, returns array of registered ExState */
+	register(...types) {
+		const generatedStates = [];
+		for (const state of types) {
+			const newState = typeof state === "string" ? new FsmState(state) : state;
+			if (this.states.has(newState.name)) console.warn(`State "${newState.name}" is already registered and will be overwritten.`);
+			this.states.set(newState.name, newState);
+			generatedStates.push(newState);
+		}
+		return {
+			success: true,
+			value: generatedStates
+		};
+	}
+	/** Change current state */
+	set(state, ...params) {
+		const name = typeof state === "string" ? state : state.name;
+		const next = this.states.get(name);
+		if (!next) return {
+			success: false,
+			message: `State "${name}" not found`
+		};
+		const finalize = () => {
+			this.current = next;
+			this.currentParams = params;
+			this.currentTime = Date.now();
+			return {
+				success: true,
+				value: next
+			};
+		};
+		if (!this.current) {
+			const entering = next.enter(this.current, ...params);
+			return entering instanceof Promise ? entering.then(finalize) : finalize();
+		}
+		const leaving = this.current.exit(next, ...params);
+		if (leaving instanceof Promise) return leaving.then(() => {
+			const entering = next.enter(this.current, ...params);
+			return entering instanceof Promise ? entering.then(finalize) : finalize();
+		});
+		const entering = next.enter(this.current, ...params);
+		return entering instanceof Promise ? entering.then(finalize) : finalize();
+	}
+	/** Check if a state is registered */
+	has(state) {
+		const name = typeof state === "string" ? state : state.name;
+		return this.states.has(name);
+	}
+	/** Get current state */
+	get() {
+		if (!this.current) return {
+			success: false,
+			message: "No state set"
+		};
+		return {
+			success: true,
+			value: this.current
+		};
+	}
+	/** Reset FSM */
+	reset() {
+		this.current = null;
+		this.currentParams = [];
+		this.currentTime = 0;
+		return { success: true };
+	}
+	/** Update current state */
+	update() {
+		if (!this.current) return {
+			success: false,
+			message: "No current state"
+		};
+		const result = this.current.update(...this.currentParams);
+		return result instanceof Promise ? result.then(() => ({ success: true })) : { success: true };
+	}
+};
+var FsmState = class {
+	constructor(name) {
+		this.name = name;
+	}
+	enter(_previous, ..._params) {}
+	exit(_next, ..._params) {}
+	update(..._params) {}
+};
 
 //#endregion
-export { helloWorld };
+export { Fsm, FsmState, JsEventEmitter, RxEventEmitter, createLoadingState, createStateStore };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Classic hello world sample for the w-lib skeleton.\n *\n * @returns The canonical greeting string\n *\n * @example\n * ```ts\n * import { helloWorld } from '@tmjeee/w-lib';\n *\n * console.log(helloWorld()); // \"Hello, world!\"\n * ```\n */\nexport function helloWorld(): string {\n  return 'Hello, world!';\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,SAAgB,aAAqB;AACnC,QAAO"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/loading-state.ts","../src/event-emitter.ts","../src/state-management.ts","../src/finite-state-machine.ts"],"sourcesContent":["import { computed, signal, Signal } from '@angular/core';\n\n/**\n * A lightweight utility for managing per-action loading states using signals.\n *\n * Philosophy:\n * - Most errors should propagate to GlobalErrorHandler.\n * - This utility helps manage UI loading states cleanly without forcing try/catch everywhere.\n * - Use it when you need to disable buttons / show spinners during async actions.\n *\n * Recommended usage:\n *\n * const loading = createLoadingState<'creatingBoard' | 'deletingBoard'>();\n *\n * async createBoard() {\n *   const title = await openDialog();\n *   if (!title) return;\n *\n *   await loading.withLoading('creatingBoard', async () => {\n *     const board = await this.boardService.createBoard(...);\n *     this.router.navigate(...);\n *   });\n * }\n *\n * In template:\n * <button [disabled]=\"loading.is('creatingBoard')()\">\n *   {{ loading.is('creatingBoard')() ? 'Creating...' : 'Create Board' }}\n * </button>\n */\nexport function createLoadingState<T extends string = string>() {\n  const loadingMap = signal<Partial<Record<T, boolean>>>({});\n  const signalCache = new Map<T, Signal<boolean>>();\n\n  /**\n   * Returns a reactive signal indicating if a specific action is loading.\n   * The returned signal is stable (same reference) for the same key.\n   */\n  const is = (key: T): Signal<boolean> => {\n    if (!signalCache.has(key)) {\n      signalCache.set(\n        key,\n        computed(() => loadingMap()[key] ?? false)\n      );\n    }\n    return signalCache.get(key)!;\n  };\n\n  /**\n   * Manually set the loading state for a key.\n   */\n  const set = (key: T, value: boolean): void => {\n    loadingMap.update((map) => ({ ...map, [key]: value }));\n  };\n\n  /**\n   * Runs an async function while automatically managing the loading state.\n   * Errors are allowed to propagate (as per project convention).\n   */\n  const withLoading = async <R>(key: T, fn: () => Promise<R>): Promise<R> => {\n    set(key, true);\n    try {\n      return await fn();\n    } finally {\n      set(key, false);\n    }\n  };\n\n  /**\n   * Raw access to the loading map (rarely needed).\n   */\n  const states = loadingMap.asReadonly();\n\n  return {\n    is,\n    set,\n    withLoading,\n    states,\n  };\n}\n\n/**\n * Type helper for action loading keys.\n * Example: type UserAction = 'addingToWorkspace' | 'removingFromWorkspace';\n */\nexport type LoadingKey = string;\n","\nexport interface EventEmitterHandler<T> {\n  (change:T):void;\n}\n\nexport interface EventEmitterSubscription {\n  unsubscribe:()=>void;\n}\n\n\nexport interface EventEmitter<T> {\n  emit(event: string,  payload: T): void;\n  on(event: string, handler: EventEmitterHandler<T>): void;\n  off(event: string, handler?: EventEmitterHandler<T>): void;\n  once(event: string, handler: EventEmitterHandler<T>): void;\n}\n\n// =============================================================\n// ============== RxJs =========================================\n// =============================================================\n\nimport {Subject} from 'rxjs';\nimport {take} from 'rxjs/operators';\n\nexport class RxEventEmitter<T> implements EventEmitter<T> {\n\n  _listeners: Record<string, Subject<T>> = {};\n\n  emit(event: string, payload: T): void {\n    const handlers = this._listeners[event];\n    if (handlers) {\n      handlers.next(payload);\n    }\n  }\n  on(event: string, handler: EventEmitterHandler<T>): void {\n    if (!this._listeners[event]) {\n      this._listeners[event] = new Subject();\n    }\n    this._listeners[event].subscribe(handler)\n  }\n  off(event: string, handler?: EventEmitterHandler<T>): void {\n    const s = this._listeners[event];\n    if (s) {\n      this._listeners[event].complete();\n      delete this._listeners[event];\n    }\n  }\n  once(event: string, handler: EventEmitterHandler<T>): void {\n    if (!this._listeners[event]) {\n      this._listeners[event] = new Subject();\n    }\n    this._listeners[event].pipe(\n      take(1)\n    ).subscribe(handler);\n  }\n}\n\n\n// =============================================================\n// ============== Js ===========================================\n// =============================================================\n\nexport class JsEventEmitter<T> implements EventEmitter<T> {\n\n  _listeners: Record<string, EventEmitterHandler<T>[]> = {};\n\n  emit(event: string, payload: T): void {\n    const handlers = this._listeners[event];\n    if (handlers && handlers.length) {\n      handlers.forEach(h => {\n        h(payload);\n      })\n    }\n  }\n  on(event: string, handler: EventEmitterHandler<T>): void {\n    if (!this._listeners[event]) {\n      this._listeners[event] = [];\n    }\n    const exists = this._listeners[event].find(h => h == handler);\n    if (!exists) {\n      this._listeners[event].push(handler);\n    }\n  }\n  off(event: string, handler?: EventEmitterHandler<T>): void {\n    if (!this._listeners[event]) {\n      this._listeners[event] = [];\n    }\n    if (handler) {\n      const idx = this._listeners[event].findIndex(h => h == handler);\n      if (idx >= 0) {\n        this._listeners[event].splice(idx, 1);\n      }\n    } else {\n      delete this._listeners[event];\n    }\n  }\n  once(event: string, handler:EventEmitterHandler<T>): void {\n    if (!this._listeners[event]) {\n      this._listeners[event] = [];\n    }\n    const onceOnlyHandler = (evt: T) => {\n      try {\n        handler(evt);\n      } finally {\n        this.off(event, onceOnlyHandler);\n      }\n    };\n    this._listeners[event].push(onceOnlyHandler);\n  }\n}","// ─── Path Typing ────────────────────────────────────────────────────────────\nimport {EventEmitter, JsEventEmitter} from './event-emitter';\n\ntype Primitive = string | number | boolean | null | undefined;\n\ntype PathsOf<T, Prefix extends string = \"\"> = T extends Primitive\n  ? never\n  : T extends Array<infer _>\n    ? never\n    : {\n        [K in keyof T & string]: Prefix extends \"\"\n          ? K | (T[K] extends Primitive ? never : PathsOf<T[K], K>)\n          : `${Prefix}.${K}` | (T[K] extends Primitive ? never : PathsOf<T[K], `${Prefix}.${K}`>);\n      }[keyof T & string];\n\nexport type Path<T> = PathsOf<T>;\n\nexport type PathValue<T, P extends string> = P extends keyof T\n  ? T[P]\n  : P extends `${infer K}.${infer Rest}`\n    ? K extends keyof T\n      ? Rest extends Path<T[K]>\n        ? PathValue<T[K], Rest>\n        : never\n      : never\n    : never;\n\n// ─── Event Types ─────────────────────────────────────────────────────────────\n\nexport interface ChangePayload<State, V = unknown> {\n  path: string;\n  previousValue: V;\n  value: V;\n  previousState: Readonly<State>;\n  state: Readonly<State>;\n}\n\ntype ChangeEventMap<State> = {\n  change: ChangePayload<State>;\n  [key: `change:${string}`]: ChangePayload<State>;\n};\n\n// ─── StateStore Interface ────────────────────────────────────────────────────\n\nexport interface StateStore<State extends object> {\n  get(): Readonly<State>;\n  get<K extends Path<State>>(path: K): Readonly<PathValue<State, K>>;\n  select<T>(selector: (state: Readonly<State>) => T): Readonly<T>;\n\n  set<K extends Path<State>>(path: K, value: PathValue<State, K>): void;\n  update<K extends Path<State>>(path: K, fn: (current: PathValue<State, K>) => PathValue<State, K>): void;\n  patch(partial: DeepPartial<State>): void;\n  batch(fn: (store: BatchContext<State>) => void): void;\n\n  on<E extends keyof ChangeEventMap<State>>(event: E, handler: (payload: ChangeEventMap<State>[E]) => void): void;\n  off<E extends keyof ChangeEventMap<State>>(event: E, handler: (payload: ChangeEventMap<State>[E]) => void): void;\n\n  subscribe<K extends Path<State>>(path: K, handler: (payload: ChangePayload<State, PathValue<State, K>>) => void): () => void;\n\n  serialize(): string;\n  reset(): void;\n}\n\nexport interface BatchContext<State extends object> {\n  set<K extends Path<State>>(path: K, value: PathValue<State, K>): void;\n  update<K extends Path<State>>(path: K, fn: (current: PathValue<State, K>) => PathValue<State, K>): void;\n  patch(partial: DeepPartial<State>): void;\n}\n\ntype DeepPartial<T> = T extends Primitive ? T : { [K in keyof T]?: DeepPartial<T[K]> };\n\n// ─── Utility Helpers ─────────────────────────────────────────────────────────\n\nfunction parsePath(path: string): string[] {\n  return path.split(\".\");\n}\n\nfunction deepFreeze<T>(obj: T): Readonly<T> {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  Object.getOwnPropertyNames(obj).forEach(name => {\n    const val = (obj as Record<string, unknown>)[name];\n    if (val && typeof val === \"object\") deepFreeze(val);\n  });\n  return Object.freeze(obj);\n}\n\nfunction deepClone<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  if (Array.isArray(obj)) return (obj as unknown[]).map(deepClone) as unknown as T;\n  const result = {} as Record<string, unknown>;\n  for (const key of Object.keys(obj as object)) {\n    result[key] = deepClone((obj as Record<string, unknown>)[key]);\n  }\n  return result as T;\n}\n\nfunction getAtPath<T>(obj: T, segments: string[]): unknown {\n  let current: unknown = obj;\n  for (const seg of segments) {\n    if (current === null || typeof current !== \"object\") {\n      throw new Error(`Invalid path segment \"${seg}\": not an object`);\n    }\n    current = (current as Record<string, unknown>)[seg];\n  }\n  return current;\n}\n\nfunction setAtPath<T extends object>(obj: T, segments: string[], value: unknown): T {\n  if (segments.length === 0) return value as T;\n  const [head, ...tail] = segments;\n  if (typeof obj !== \"object\" || obj === null) {\n    throw new Error(`Cannot set path on non-object at segment \"${head}\"`);\n  }\n  const record = obj as Record<string, unknown>;\n  const updated = { ...record };\n  if (tail.length === 0) {\n    updated[head] = value;\n  } else {\n    const child = record[head];\n    if (child === null || typeof child !== \"object\") {\n      throw new Error(`Path segment \"${head}\" is not an object`);\n    }\n    updated[head] = setAtPath(child as object, tail, value);\n  }\n  return updated as T;\n}\n\nfunction shallowEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (a === null || b === null) return false;\n  if (typeof a !== \"object\" || typeof b !== \"object\") return false;\n  const keysA = Object.keys(a as object);\n  const keysB = Object.keys(b as object);\n  if (keysA.length !== keysB.length) return false;\n  for (const k of keysA) {\n    if ((a as Record<string, unknown>)[k] !== (b as Record<string, unknown>)[k]) return false;\n  }\n  return true;\n}\n\nfunction deepMerge<T extends object>(base: T, partial: DeepPartial<T>): T {\n  const result = { ...base } as Record<string, unknown>;\n  for (const key of Object.keys(partial as object)) {\n    const pVal = (partial as Record<string, unknown>)[key];\n    const bVal = (base as Record<string, unknown>)[key];\n    if (\n      pVal !== undefined &&\n      pVal !== null &&\n      typeof pVal === \"object\" &&\n      !Array.isArray(pVal) &&\n      bVal !== null &&\n      typeof bVal === \"object\"\n    ) {\n      result[key] = deepMerge(bVal as object, pVal as DeepPartial<object>);\n    } else if (pVal !== undefined) {\n      result[key] = pVal;\n    }\n  }\n  return result as T;\n}\n\n// ─── Factory ─────────────────────────────────────────────────────────────────\n\nexport function createStateStore<State extends object>(\n  initialState: State, \n  eventEmitter: EventEmitter<ChangePayload<State>> = new JsEventEmitter<ChangePayload<State>>()\n): StateStore<State> {\n\n  const _initial: Readonly<State> = deepFreeze(deepClone(initialState));\n  let _state: Readonly<State> = _initial;\n\n  const _emitter = eventEmitter;\n\n  function _emit(path: string, previousValue: unknown, value: unknown, previousState: Readonly<State>): void {\n    const payload: ChangePayload<State> = {\n      path,\n      previousValue,\n      value,\n      previousState,\n      state: _state,\n    };\n    _emitter.emit(\"change\", payload);\n    _emitter.emit(`change:${path}` as `change:${string}`, payload);\n  }\n\n  function _applySet(currentState: Readonly<State>, segments: string[], value: unknown): Readonly<State> {\n    return deepFreeze(setAtPath(deepClone(currentState), segments, value));\n  }\n\n  // Overloaded get\n  function get(): Readonly<State>;\n  function get<K extends Path<State>>(path: K): Readonly<PathValue<State, K>>;\n  function get<K extends Path<State>>(path?: K): Readonly<State> | Readonly<PathValue<State, K>> {\n    if (path === undefined) return _state;\n    const segments = parsePath(path);\n    const val = getAtPath(_state, segments);\n    return deepFreeze(deepClone(val)) as Readonly<PathValue<State, K>>;\n  }\n\n  function select<T>(selector: (state: Readonly<State>) => T): Readonly<T> {\n    const result = selector(_state);\n    if (result !== null && typeof result === \"object\") {\n      return deepFreeze(deepClone(result)) as Readonly<T>;\n    }\n    return result as Readonly<T>;\n  }\n\n  function set<K extends Path<State>>(path: K, value: PathValue<State, K>): void {\n    const segments = parsePath(path);\n    const previousValue = getAtPath(_state, segments);\n    if (shallowEqual(previousValue, value)) return;\n    const previousState = _state;\n    _state = _applySet(_state, segments, value);\n    _emit(path, previousValue, value, previousState);\n  }\n\n  function update<K extends Path<State>>(path: K, fn: (current: PathValue<State, K>) => PathValue<State, K>): void {\n    const segments = parsePath(path);\n    const current = getAtPath(_state, segments) as PathValue<State, K>;\n    const next = fn(deepClone(current));\n    set(path, next);\n  }\n\n  function patch(partial: DeepPartial<State>): void {\n    const merged = deepMerge(_state as State, partial);\n    const nextState = deepFreeze(merged);\n    const changedPaths: Array<{ path: string; prev: unknown; next: unknown }> = [];\n    collectChangedPaths(\"\", _state, nextState, changedPaths);\n    if (changedPaths.length === 0) return;\n    const previousState = _state;\n    _state = nextState;\n    for (const entry of changedPaths) {\n      _emit(entry.path, entry.prev, entry.next, previousState);\n    }\n  }\n\n  function collectChangedPaths(\n    prefix: string,\n    prev: unknown,\n    next: unknown,\n    out: Array<{ path: string; prev: unknown; next: unknown }>,\n  ): void {\n    if (prev === next) return;\n    if (\n      prev !== null &&\n      next !== null &&\n      typeof prev === \"object\" &&\n      typeof next === \"object\" &&\n      !Array.isArray(prev) &&\n      !Array.isArray(next)\n    ) {\n      const allKeys = new Set([...Object.keys(prev as object), ...Object.keys(next as object)]);\n      for (const k of allKeys) {\n        const pv = (prev as Record<string, unknown>)[k];\n        const nv = (next as Record<string, unknown>)[k];\n        const childPath = prefix ? `${prefix}.${k}` : k;\n        collectChangedPaths(childPath, pv, nv, out);\n      }\n    } else if (!shallowEqual(prev, next)) {\n      out.push({ path: prefix, prev, next });\n    }\n  }\n\n  function batch(fn: (ctx: BatchContext<State>) => void): void {\n    let pendingState = _state;\n    const changes: Array<{ path: string; prev: unknown; next: unknown; prevState: Readonly<State> }> = [];\n\n    const ctx: BatchContext<State> = {\n      set<K extends Path<State>>(path: K, value: PathValue<State, K>): void {\n        const segments = parsePath(path);\n        const previousValue = getAtPath(pendingState, segments);\n        if (shallowEqual(previousValue, value)) return;\n        const prevState = pendingState;\n        pendingState = deepFreeze(setAtPath(deepClone(pendingState), segments, value));\n        changes.push({ path, prev: previousValue, next: value, prevState });\n      },\n      update<K extends Path<State>>(path: K, fn2: (current: PathValue<State, K>) => PathValue<State, K>): void {\n        const segments = parsePath(path);\n        const current = getAtPath(pendingState, segments) as PathValue<State, K>;\n        const next = fn2(deepClone(current));\n        ctx.set(path, next);\n      },\n      patch(partial: DeepPartial<State>): void {\n        const merged = deepFreeze(deepMerge(pendingState as State, partial));\n        const changedPaths: Array<{ path: string; prev: unknown; next: unknown }> = [];\n        collectChangedPaths(\"\", pendingState, merged, changedPaths);\n        if (changedPaths.length === 0) return;\n        const prevState = pendingState;\n        pendingState = merged;\n        for (const entry of changedPaths) {\n          changes.push({ path: entry.path, prev: entry.prev, next: entry.next, prevState });\n        }\n      },\n    };\n\n    fn(ctx);\n\n    if (pendingState === _state) return;\n    _state = pendingState;\n\n    for (const change of changes) {\n      _emit(change.path, change.prev, change.next, change.prevState);\n    }\n  }\n\n  function on<E extends keyof ChangeEventMap<State>>(event: E, handler: (payload: ChangeEventMap<State>[E]) => void): void {\n    _emitter.on(event, handler as (payload: ChangeEventMap<State>[E]) => void);\n  }\n\n  function off<E extends keyof ChangeEventMap<State>>(event: E, handler: (payload: ChangeEventMap<State>[E]) => void): void {\n    _emitter.off(event, handler as (payload: ChangeEventMap<State>[E]) => void);\n  }\n\n  function subscribe<K extends Path<State>>(\n    path: K,\n    handler: (payload: ChangePayload<State, PathValue<State, K>>) => void,\n  ): () => void {\n    const eventName = `change:${path}` as `change:${string}`;\n    const wrapped = (payload: ChangePayload<State>) => handler(payload as unknown as ChangePayload<State, PathValue<State, K>>);\n    _emitter.on(eventName, wrapped);\n    return () => _emitter.off(eventName, wrapped);\n  }\n\n  function serialize(): string {\n    return JSON.stringify(_state);\n  }\n\n  function reset(): void {\n    const previousState = _state;\n    _state = _initial;\n    const changes: Array<{ path: string; prev: unknown; next: unknown }> = [];\n    collectChangedPaths(\"\", previousState, _state, changes);\n    for (const change of changes) {\n      _emit(change.path, change.prev, change.next, previousState);\n    }\n  }\n\n  return { get, select, set, update, patch, batch, on, off, subscribe, serialize, reset };\n}","export type FsmResult<T = void> = {\n  success: boolean;\n  message?: string;\n  value?: T;\n};\n\nexport class Fsm {\n  public states = new Map<string, FsmState>();\n  public current: FsmState | null = null;\n  public currentParams: any[] = [];\n  public currentTime: number = 0;\n\n  constructor() {}\n\n  /** Register new states, returns array of registered ExState */\n  register(...types: (string | FsmState)[]): FsmResult<FsmState[]> {\n    const generatedStates: FsmState[] = [];\n\n    for (const state of types) {\n      const newState = typeof state === \"string\" ? new FsmState(state) : state;\n\n      if (this.states.has(newState.name)) {\n        console.warn(`State \"${newState.name}\" is already registered and will be overwritten.`);\n      }\n\n      this.states.set(newState.name, newState);\n      generatedStates.push(newState);\n    }\n\n    return { success: true, value: generatedStates };\n  }\n\n  /** Change current state */\n  set(state: string | FsmState, ...params: any[]): FsmResult<FsmState> | Promise<FsmResult<FsmState>> {\n    const name = typeof state === \"string\" ? state : state.name;\n    const next = this.states.get(name);\n\n    if (!next) return { success: false, message: `State \"${name}\" not found` };\n\n    const finalize = () => {\n      this.current = next;\n      this.currentParams = params;\n      this.currentTime = Date.now();\n      return { success: true, value: next };\n    };\n\n    // No current state, only enter next\n    if (!this.current) {\n      const entering = next.enter(this.current, ...params);\n      return entering instanceof Promise ? entering.then(finalize) : finalize();\n    }\n\n    // Handle current exit\n    const leaving = this.current.exit(next, ...params);\n    if (leaving instanceof Promise) {\n      return leaving.then(() => {\n        const entering = next.enter(this.current, ...params);\n        return entering instanceof Promise ? entering.then(finalize) : finalize();\n      });\n    }\n\n    const entering = next.enter(this.current, ...params);\n    return entering instanceof Promise ? entering.then(finalize) : finalize();\n  }\n\n  /** Check if a state is registered */\n  has(state: string | FsmState): boolean {\n    const name = typeof state === \"string\" ? state : state.name;\n    return this.states.has(name);\n  }\n\n  /** Get current state */\n  get(): FsmResult<FsmState> {\n    if (!this.current) return { success: false, message: \"No state set\" };\n    return { success: true, value: this.current };\n  }\n\n  /** Reset FSM */\n  reset(): FsmResult<void> {\n    this.current = null;\n    this.currentParams = [];\n    this.currentTime = 0;\n    return { success: true };\n  }\n\n  /** Update current state */\n  update(): FsmResult<void> | Promise<FsmResult<void>> {\n    if (!this.current) return { success: false, message: \"No current state\" };\n\n    const result = this.current.update(...this.currentParams);\n    return result instanceof Promise ? result.then(() => ({ success: true })) : { success: true };\n  }\n}\n\nexport class FsmState {\n  constructor(public name: string) {}\n\n  enter(_previous: FsmState | null, ..._params: any): void | Promise<void> {}\n  exit(_next: FsmState | null, ..._params: any): void | Promise<void> {}\n  update(..._params: any): void | Promise<void> {}\n}"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmjeee/w-lib",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "A minimal, modern TypeScript library skeleton ready for publishing to npmjs.com. Includes helloWorld sample.",
   "keywords": [
     "typescript",
@@ -52,6 +52,18 @@
     "publish:npm": "npm run build && npm run test && npm publish --access public",
     "publish:npm:dry": "npm run build && npm run test && npm publish --access public --dry-run"
   },
+  "dependencies": {
+    "@angular/animations": "^21.2.13",
+    "@angular/cdk": "^21.2.11",
+    "@angular/common": "^21.2.0",
+    "@angular/compiler": "^21.2.0",
+    "@angular/core": "^21.2.0",
+    "@angular/forms": "^21.2.0",
+    "@angular/material": "^21.2.11",
+    "@angular/platform-browser": "^21.2.0",
+    "@angular/router": "^21.2.0",
+    "rxjs": "^7.8.2"
+  },
   "devDependencies": {
     "@types/node": "^22.15.0",
     "tsdown": "^0.20.3",