Version Packages

core/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @stackflow/core
 
+## 3.0.0
+
+### Major Changes
+
+- f0fc1fb: Distinguish how a stack is initialized — created fresh (`create`) or restored from a snapshot (`load`) — and add the surface a snapshot round-trip needs: `StackSnapshot`, `actions.captureSnapshot()`, the `provideSnapshot` / `onLoadError` plugin hooks, and `initInfo` on `onInit`. Runtime behavior is unchanged when no snapshot is provided; the breaks are type-level only — the `StackflowPluginHook` → `StackflowPluginInitHook` rename, plus new required members on `StackflowActions` and on the `onInit` / `overrideInitialEvents` hook signatures — hence the major.
+
+  **Added**
+
+  - `StackSnapshot` (with the `SnapshotEvent` / `NavigationEvent` unions) — a plain-data record of the events a stack recorded at runtime — plus `SnapshotLoadError`.
+  - `actions.captureSnapshot()` to export that record, and the `provideSnapshot` / `onLoadError` plugin hooks to supply a snapshot at creation time and route a failed load.
+  - `initInfo: { kind: "create" | "load" }` on `onInit`; `overrideInitialEvents` now runs on the load path too and receives the same `initInfo`.
+
+  **Changed**
+
+  - Renamed the `StackflowPluginHook` type to `StackflowPluginInitHook`.
+  - `StackflowActions` now requires `captureSnapshot`, the `onInit` / `overrideInitialEvents` hook arguments now require `initInfo`, and `overrideInitialEvents`' parameter widens from `(PushedEvent | StepPushedEvent)[]` to `SnapshotEvent[]` — hand-written mocks and wrap-and-forward plugins must adopt these.
+  - `validateEvents` now also rejects a `Replaced` that names an unregistered activity (does not fire in config-first usage).
+
 ## 2.0.1
 
 ### Patch Changes

core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackflow/core",
-  "version": "2.0.1",
+  "version": "3.0.0",
   "repository": {
     "type": "git",
     "url": "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/daangn/stackflow.git",

demo/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @stackflow/demo
 
+## 1.4.2
+
+### Patch Changes
+
+- Updated dependencies [f0fc1fb]
+- Updated dependencies [fd33557]
+  - @stackflow/core@3.0.0
+  - @stackflow/plugin-history-sync@1.12.0
+  - @stackflow/link@2.0.1
+  - @stackflow/plugin-basic-ui@1.18.3
+  - @stackflow/plugin-devtools@0.1.13
+  - @stackflow/plugin-renderer-basic@1.1.15
+  - @stackflow/plugin-stack-depth-change@1.1.7
+  - @stackflow/react@2.1.2
+
 ## 1.4.1
 
 ### Patch Changes

demo/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackflow/demo",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "private": true,
   "license": "MIT",
   "type": "module",
@@ -33,14 +33,14 @@
     "@seed-design/design-token": "^1.0.3",
     "@seed-design/stylesheet": "^1.0.4",
     "@stackflow/config": "^2.0.0",
-    "@stackflow/core": "^2.0.0",
-    "@stackflow/link": "^2.0.0",
-    "@stackflow/plugin-basic-ui": "^1.18.2",
-    "@stackflow/plugin-devtools": "^0.1.12",
-    "@stackflow/plugin-history-sync": "^1.11.0",
-    "@stackflow/plugin-renderer-basic": "^1.1.14",
-    "@stackflow/plugin-stack-depth-change": "^1.1.6",
-    "@stackflow/react": "^2.0.0",
+    "@stackflow/core": "^3.0.0",
+    "@stackflow/link": "^2.0.1",
+    "@stackflow/plugin-basic-ui": "^1.18.3",
+    "@stackflow/plugin-devtools": "^0.1.13",
+    "@stackflow/plugin-history-sync": "^1.12.0",
+    "@stackflow/plugin-renderer-basic": "^1.1.15",
+    "@stackflow/plugin-stack-depth-change": "^1.1.7",
+    "@stackflow/react": "^2.1.2",
     "lorem-ipsum": "^2.0.8",
     "lz-string": "^1.5.0",
     "normalize.css": "^8.0.1",

docs/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @stackflow/docs
 
+## 2.1.2
+
+### Patch Changes
+
+- Updated dependencies [f0fc1fb]
+- Updated dependencies [fd33557]
+  - @stackflow/core@3.0.0
+  - @stackflow/plugin-history-sync@1.12.0
+  - @stackflow/demo@1.4.2
+  - @stackflow/plugin-basic-ui@1.18.3
+  - @stackflow/plugin-renderer-basic@1.1.15
+  - @stackflow/react@2.1.2
+
 ## 2.1.1
 
 ### Patch Changes

docs/components/ChangelogContent.mdx

@@ -1,3 +1,31 @@
+## 2026.07.11
+
+Distinguish how a stack is initialized — created fresh (`create`) or restored from a snapshot (`load`) — and add the surface a snapshot round-trip needs: `StackSnapshot`, `actions.captureSnapshot()`, the `provideSnapshot` / `onLoadError` plugin hooks, and `initInfo` on `onInit`. Runtime behavior is unchanged when no snapshot is provided; the breaks are type-level only — the `StackflowPluginHook` → `StackflowPluginInitHook` rename, plus new required members on `StackflowActions` and on the `onInit` / `overrideInitialEvents` hook signatures — hence the major. [`f0fc1fb`](https://github.com/daangn/stackflow/commit/f0fc1fbdda3b23f7c1400f9659e45a970be1647d)
+
+**Added**
+
+- `StackSnapshot` (with the `SnapshotEvent` / `NavigationEvent` unions) — a plain-data record of the events a stack recorded at runtime — plus `SnapshotLoadError`.
+- `actions.captureSnapshot()` to export that record, and the `provideSnapshot` / `onLoadError` plugin hooks to supply a snapshot at creation time and route a failed load.
+- `initInfo: { kind: "create" | "load" }` on `onInit`; `overrideInitialEvents` now runs on the load path too and receives the same `initInfo`.
+
+**Changed**
+
+- Renamed the `StackflowPluginHook` type to `StackflowPluginInitHook`.
+- `StackflowActions` now requires `captureSnapshot`, the `onInit` / `overrideInitialEvents` hook arguments now require `initInfo`, and `overrideInitialEvents`' parameter widens from `(PushedEvent | StepPushedEvent)[]` to `SnapshotEvent[]` — hand-written mocks and wrap-and-forward plugins must adopt these.
+- `validateEvents` now also rejects a `Replaced` that names an unregistered activity (does not fire in config-first usage).
+
+Released packages:
+- 📦 [@stackflow/core@3.0.0](https://npmjs.com/package/@stackflow/core/v/3.0.0)
+
+---
+
+Pass `initialContext` to route `defaultHistory` callbacks so the initial stack can depend on request-specific context. [`fd33557`](https://github.com/daangn/stackflow/commit/fd33557036ef2f631ac5f895e741b7af04516ca9)
+
+Released packages:
+- 📦 [@stackflow/plugin-history-sync@2.0.0](https://npmjs.com/package/@stackflow/plugin-history-sync/v/2.0.0)
+
+---
+
 ## 2026.07.07
 
 Memoize the action functions returned by `useFlow` and `useStepFlow` so their references stay stable across renders. [`91c433c`](https://github.com/daangn/stackflow/commit/91c433cc2f60462c59f6e1b990bc8339d7fbbc00)

docs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackflow/docs",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "private": true,
   "description": "Mobile-first stack navigator framework with Composable Plugin System",
   "license": "MIT",
@@ -19,12 +19,12 @@
     "@mdx-js/react": "^3.0.1",
     "@opennextjs/cloudflare": "^1.0.0-beta.3",
     "@seed-design/design-token": "^1.0.3",
-    "@stackflow/core": "^2.0.0",
-    "@stackflow/demo": "^1.4.1",
-    "@stackflow/plugin-basic-ui": "^1.18.2",
-    "@stackflow/plugin-history-sync": "^1.11.0",
-    "@stackflow/plugin-renderer-basic": "^1.1.14",
-    "@stackflow/react": "^2.0.0",
+    "@stackflow/core": "^3.0.0",
+    "@stackflow/demo": "^1.4.2",
+    "@stackflow/plugin-basic-ui": "^1.18.3",
+    "@stackflow/plugin-history-sync": "^1.12.0",
+    "@stackflow/plugin-renderer-basic": "^1.1.15",
+    "@stackflow/react": "^2.1.2",
     "@types/react": "^18.3.3",
     "autoprefixer": "^10.4.20",
     "class-variance-authority": "^0.7.0",

extensions/link/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @stackflow/link
 
+## 2.0.1
+
+### Patch Changes
+
+- Updated dependencies [f0fc1fb]
+  - @stackflow/core@3.0.0
+
 ## 2.0.0
 
 ### Major Changes

extensions/link/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackflow/link",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "repository": {
     "type": "git",
     "url": "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/daangn/stackflow.git",
@@ -32,10 +32,10 @@
   },
   "devDependencies": {
     "@stackflow/config": "^2.0.0",
-    "@stackflow/core": "^2.0.0",
+    "@stackflow/core": "^3.0.0",
     "@stackflow/esbuild-config": "^1.0.3",
-    "@stackflow/plugin-history-sync": "^1.11.0",
-    "@stackflow/react": "^2.0.0",
+    "@stackflow/plugin-history-sync": "^1.12.0",
+    "@stackflow/react": "^2.1.2",
     "@types/react": "^18.3.3",
     "esbuild": "^0.23.0",
     "esbuild-plugin-file-path-extensions": "^2.1.3",
@@ -44,7 +44,7 @@
     "typescript": "^5.5.3"
   },
   "peerDependencies": {
-    "@stackflow/core": "^2.0.0",
+    "@stackflow/core": "^3.0.0",
     "@stackflow/plugin-history-sync": "^1.6.4-canary.0",
     "@stackflow/react": "^2.0.0",
     "@types/react": ">=16.8.0",

extensions/plugin-basic-ui/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @stackflow/plugin-basic-ui
 
+## 1.18.3
+
+### Patch Changes
+
+- Updated dependencies [f0fc1fb]
+  - @stackflow/core@3.0.0
+  - @stackflow/react-ui-core@1.3.6
+
 ## 1.18.2
 
 ### Patch Changes

extensions/plugin-basic-ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackflow/plugin-basic-ui",
-  "version": "1.18.2",
+  "version": "1.18.3",
   "repository": {
     "type": "git",
     "url": "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/daangn/stackflow.git",
@@ -32,25 +32,25 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@stackflow/react-ui-core": "^1.3.5",
+    "@stackflow/react-ui-core": "^1.3.6",
     "@vanilla-extract/css": "^1.15.3",
     "@vanilla-extract/dynamic": "^2.1.1",
     "@vanilla-extract/private": "^1.0.5",
     "@vanilla-extract/recipes": "^0.5.3",
     "clsx": "^2.1.1"
   },
   "devDependencies": {
-    "@stackflow/core": "^2.0.0",
+    "@stackflow/core": "^3.0.0",
     "@stackflow/esbuild-config": "^1.0.3",
-    "@stackflow/react": "^2.0.0",
+    "@stackflow/react": "^2.1.2",
     "@types/react": "^18.3.3",
     "esbuild": "^0.23.0",
     "react": "^18.3.1",
     "rimraf": "^3.0.2",
     "typescript": "^5.5.3"
   },
   "peerDependencies": {
-    "@stackflow/core": "^2.0.0",
+    "@stackflow/core": "^3.0.0",
     "@stackflow/react": "^2.0.0",
     "@types/react": ">=16.8.0",
     "react": ">=16.8.0"

extensions/plugin-blocker/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @stackflow/plugin-blocker
 
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [f0fc1fb]
+  - @stackflow/core@3.0.0
+
 ## 0.1.1
 
 ### Patch Changes

extensions/plugin-blocker/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackflow/plugin-blocker",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "repository": {
     "type": "git",
     "url": "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/daangn/stackflow.git",
@@ -42,10 +42,10 @@
   },
   "devDependencies": {
     "@stackflow/config": "^2.0.0",
-    "@stackflow/core": "^2.0.0",
+    "@stackflow/core": "^3.0.0",
     "@stackflow/esbuild-config": "^1.0.3",
-    "@stackflow/plugin-renderer-basic": "^1.1.14",
-    "@stackflow/react": "^2.0.0",
+    "@stackflow/plugin-renderer-basic": "^1.1.15",
+    "@stackflow/react": "^2.1.2",
     "@swc/core": "^1.6.6",
     "@swc/jest": "^0.2.36",
     "@testing-library/dom": "^10.4.0",
@@ -61,7 +61,7 @@
     "typescript": "^5.5.3"
   },
   "peerDependencies": {
-    "@stackflow/core": "^2.0.0",
+    "@stackflow/core": "^3.0.0",
     "@stackflow/react": "^2.0.0",
     "react": ">=16.8.0"
   },

extensions/plugin-devtools/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @stackflow/plugin-devtools
 
+## 0.1.13
+
+### Patch Changes
+
+- Updated dependencies [f0fc1fb]
+  - @stackflow/core@3.0.0
+
 ## 0.1.12
 
 ### Patch Changes

extensions/plugin-devtools/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackflow/plugin-devtools",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "repository": {
     "type": "git",
     "url": "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/daangn/stackflow.git",
@@ -30,15 +30,15 @@
     "dev": "yarn build:js --watch && yarn build:dts --watch"
   },
   "devDependencies": {
-    "@stackflow/core": "^2.0.0",
+    "@stackflow/core": "^3.0.0",
     "@stackflow/esbuild-config": "^1.0.3",
     "@types/node": "^20.14.9",
     "esbuild": "^0.23.0",
     "rimraf": "^3.0.2",
     "typescript": "^5.5.3"
   },
   "peerDependencies": {
-    "@stackflow/core": "^2.0.0"
+    "@stackflow/core": "^3.0.0"
   },
   "publishConfig": {
     "access": "public"

extensions/plugin-google-analytics-4/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @stackflow/plugin-google-analytics-4
 
+## 1.1.17
+
+### Patch Changes
+
+- Updated dependencies [f0fc1fb]
+  - @stackflow/core@3.0.0
+
 ## 1.1.16
 
 ### Patch Changes