create-foldkit-app 0.21.0 → 0.22.0

package/README.md

@@ -32,6 +32,7 @@ The CLI prompts you for a project name, starter example, and package manager. Pa
 | `api-cache`              | Query caching in the Model with stale-while-revalidate, request deduplication, and interval refetching |
 | `charting`               | Live GitHub and npm telemetry rendered through an ECharts Mount adapter                                |
 | `routing`                | URL routing with parser combinators and route parameters                                               |
+| `upload`                 | Simulated file uploads with cancellable, restartable interruptible Commands                            |
 | `query-sync`             | URL-driven filtering, sorting, and search with query parameters                                        |
 | `snake`                  | Classic game built with Subscriptions                                                                  |
 | `canvas-art`             | Declarative 2D canvas with shapes, animation-frame Subscriptions, and pointer events                   |

package/dist/examples.js

@@ -12,6 +12,7 @@ export const EXAMPLE_VALUES = [
     'charting',
     'routing',
     'route-transitions',
+    'interrupting-commands',
     'query-sync',
     'snake',
     'canvas-art',
@@ -94,6 +95,11 @@ export const examples = [
         title: 'route-transitions',
         description: 'Live transition log with entry, exit, and stayed navigation policies',
     },
+    {
+        value: 'interrupting-commands',
+        title: 'interrupting-commands',
+        description: 'Simulated file uploads with cancellable, restartable interruptible Commands',
+    },
     {
         value: 'query-sync',
         title: 'query-sync',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-foldkit-app",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Create Foldkit applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,15 +12,15 @@
     "templates"
   ],
   "dependencies": {
-    "@effect/platform-node": "4.0.0-beta.88",
-    "@effect/platform-node-shared": "4.0.0-beta.88",
+    "@effect/platform-node": "4.0.0-beta.97",
+    "@effect/platform-node-shared": "4.0.0-beta.97",
     "chalk": "^5.6.2",
-    "effect": "4.0.0-beta.88",
+    "effect": "4.0.0-beta.97",
     "rimraf": "^6.1.3",
     "typescript": "^6.0.3"
   },
   "devDependencies": {
-    "@effect/vitest": "4.0.0-beta.88",
+    "@effect/vitest": "4.0.0-beta.97",
     "@types/node": "^25.9.3",
     "vitest": "^4.1.9"
   },

package/templates/base/AGENTS.md

@@ -54,7 +54,7 @@ Use `evo()` from `foldkit/struct` for immutable model updates. Never spread or `
 
 Bind the `html` factory inside each view function with `const h = html<Message>()` (never at module level), then reach for `h.div`, `h.OnClick`, etc. off the returned record. Use `empty` (not `null`) for conditional rendering, `M.value().pipe(M.tagsExhaustive({...}))` for discriminated unions, and `Array.match` for lists that may be empty.
 
-Use `keyed` wrappers whenever the view branches into structurally different layouts based on route or model state. Without keying, the virtual DOM tries to diff one layout into another, causing stale DOM and event handler mismatches.
+Keys are for mapped list items only: key each row by a stable Model identifier (`h.keyed('li')(item.id, [], [...])`), never by array position, and never derive a key from displayed data. Never key branches; the build gives each view function's output its own identity, so branch switches replace DOM automatically. When switching an inline same-tag ternary must reset DOM state, extract each arm into its own named view function.
 
 ### Commands