v3.0.0 — Deep clone fix, destroy(), modern build, sample upgrades

.github/workflows/nodejs-build-validation.yml

@@ -1,59 +1,108 @@
-# This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node
-# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs
-
-name: Build
+name: Build & Test
 
 on:
   push:
-    branches: [ "main" ]
+    branches: [main]
   pull_request:
-    branches: [ "main" ]
-
-jobs:
-  build-observable-store:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      publish:
+        description: 'Run publish step (dry-run by default)'
+        type: boolean
+        default: true
+      dry_run:
+        description: 'Dry run (no actual publish)'
+        type: boolean
+        default: true
 
+jobs:
+  build-and-test:
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: ./modules/observable-store/
 
     strategy:
       matrix:
-        node-version: [14.x, 16.x, 18.x]
-        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
+        node-version: [18.x, 20.x, 22.x]
 
     steps:
-    - uses: actions/checkout@v3
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v3
-      with:
-        node-version: ${{ matrix.node-version }}
-        cache: 'npm'
-        cache-dependency-path: ./modules/observable-store/package-lock.json
-    - run: npm ci
-    - run: npm run build --if-present
-    - run: npm test
-
-  build-observable-store-extensions:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+          cache-dependency-path: |
+            modules/observable-store/package-lock.json
+            modules/observable-store-extensions/package-lock.json
+
+      - name: Build modules
+        run: npm run build
 
+      - name: Run tests
+        run: npm test
+
+  build-samples:
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: ./modules/observable-store-extensions/
+    needs: build-and-test
 
-    strategy:
-      matrix:
-        node-version: [14.x, 16.x, 18.x]
-        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js 22.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22.x
+          cache: npm
+          cache-dependency-path: |
+            modules/observable-store/package-lock.json
+            modules/observable-store-extensions/package-lock.json
+
+      - name: Build modules
+        run: npm run build
+
+      - name: Build Angular Store sample
+        working-directory: samples/angular-store
+        run: npm install && npm run build
+
+      - name: Build React Store sample
+        working-directory: samples/react-store
+        run: npm install && npm run build
+
+      - name: Build JavaScript demo
+        working-directory: samples/javascript-demo
+        run: npm install && npm run build
+
+  publish:
+    if: |
+      (github.event_name == 'push' && github.ref == 'refs/heads/main' && startsWith(github.event.head_commit.message, 'release:')) ||
+      (github.event_name == 'workflow_dispatch' && inputs.publish)
+    needs: [build-and-test, build-samples]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
 
     steps:
-    - uses: actions/checkout@v3
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v3
-      with:
-        node-version: ${{ matrix.node-version }}
-        cache: 'npm'
-        cache-dependency-path: ./modules/observable-store-extensions/package-lock.json
-    - run: npm ci
-    - run: npm run build --if-present
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js 22.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22.x
+          registry-url: https://registry.npmjs.org
+
+      - name: Build modules
+        run: npm run build
+
+      - name: Publish observable-store
+        working-directory: modules/observable-store
+        run: npm publish --provenance --access public ${{ (github.event_name == 'workflow_dispatch' && inputs.dry_run) && '--dry-run' || '' }}
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
+      - name: Publish observable-store-extensions
+        working-directory: modules/observable-store-extensions
+        run: npm publish --provenance --access public ${{ (github.event_name == 'workflow_dispatch' && inputs.dry_run) && '--dry-run' || '' }}
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -2,6 +2,7 @@
 
 # compiled output
 modules/**/dist
+samples/**/dist
 tmp
 out-tsc
 .angular

CHANGELOG.md

@@ -0,0 +1,70 @@
+# Changelog
+
+## 3.0.0 — February 2026
+
+### Breaking Changes
+
+- **Removed `includeStateChangesOnSubscribe` setting.** This was deprecated in v2.1.0. Use `stateWithPropertyChanges` or `globalStateWithPropertyChanges` instead.
+- **ES2022 build target.** The library now targets ES2022, which means it requires a modern JavaScript runtime. Older bundlers that cannot handle native classes (e.g., Angular 15's webpack) are no longer supported. If you need Angular 15 support, stay on v2.x.
+- **Dual ESM + CJS output.** The package now ships both ES module (`observable-store.js`) and CommonJS (`observable-store.cjs`) builds via the `exports` field in `package.json`. Most bundlers will resolve this automatically.
+
+### New Features
+
+- **`destroy()` method.** Call `destroy()` on a service to unregister it from the global store and complete its state dispatchers. This prevents memory leaks when services are created and destroyed dynamically (e.g., in Angular's `ngOnDestroy`).
+- **Deep cloning for complex objects.** Objects with custom prototypes (Dayjs, Moment.js, Luxon DateTime, etc.) are now cloned correctly using a 4-strategy cascade: `clone()` → constructor → `Object.create` → reference fallback. Previously, `JSON.parse(JSON.stringify())` would strip prototype methods and corrupt these objects. (Fixes [#314](https://github.com/DanWahlin/Observable-Store/issues/314))
+- **Deep Map/Set cloning.** Map and Set values are now individually deep-cloned rather than shallow-copied, preventing mutation leaks across state snapshots.
+
+### Improvements
+
+- **Vite build system.** Replaced `tsc` with [Vite](https://vitejs.dev/) library mode for building both `observable-store` and `observable-store-extensions`.
+- **Vitest test framework.** Replaced Jasmine with [Vitest](https://vitest.dev/). 103 tests run in ~50ms.
+- **TypeScript 5.8.** Upgraded from TypeScript 4.9.
+- **Reduced dev dependencies.** From 8 to 4 (removed jasmine, ts-node, @types/jasmine, @types/node).
+- **Code quality.** `hasOwnProperty()` → `Object.hasOwn()`, `var` → `const`, `==` → `===`, removed dead imports, reduced redundant cloning in `setState()`.
+
+### Samples
+
+All sample applications have been upgraded to current framework versions:
+- **Angular:** 15 → 21 (standalone components, `@if`/`@for` control flow, `provideZoneChangeDetection`)
+- **React:** 16 → 19 (hooks, React Router v7, Vite)
+- **Vue:** 2 → 3.5 (Composition API, Vue Router v4, Vite)
+- **JavaScript:** webpack → Vite
+
+### Extensions
+
+- `@codewithdan/observable-store-extensions` has been modernized with Vite + TypeScript 5.8 and ships dual ESM/CJS builds matching the core library.
+
+---
+
+## 2.2.15 — November 2022
+
+- New `isStoreInitialized` property. Thanks to [Jason Landbridge](https://github.com/JasonLandbridge).
+
+## 2.2.13 — August 2021
+
+- Added `getStateSliceProperty()` function. Thanks to [Connor Smith](https://github.com/ConnorSmith-pf).
+
+## 2.2.10 — May 2020
+
+- Fixed internal cloning to respect `deepClone` parameter. Thanks to [Steve-RW](https://github.com/Steve-RW).
+
+## 2.2.9 — May 2020
+
+- Added Map and Set cloning support. Thanks to [Chris Andrade](https://github.com/chrisjandrade).
+
+## 2.2.3 — December 2019
+
+- Added Redux DevTools extension (`@codewithdan/observable-store-extensions`).
+- Added `allStoreServices` property and `addExtension()` function.
+
+## 2.1.0 — October 2019
+
+- Added `stateWithPropertyChanges` and `globalStateWithPropertyChanges` observables.
+- Deprecated `includeStateChangesOnSubscribe`.
+
+## 2.0.0 — October 2019
+
+- Strongly-typed API.
+- RxJS moved to peer dependency.
+- Added `globalSettings`.
+- Added cloning for state immutability.

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022 Dan Wahlin
+Copyright (c) 2026 Dan Wahlin
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal