create-foldkit-app 0.13.0 → 0.14.0

package/README.md

@@ -32,6 +32,7 @@ The CLI prompts you for a project name, starter example, and package manager. Pa
 | `shopping-cart`  | Complex state management with nested Models                                         |
 | `websocket-chat` | Managed resources with WebSocket                                                    |
 | `auth`           | Authentication with Submodels, OutMessage, and protected routes                     |
+| `embedding`      | A Foldkit widget embedded in a plain TypeScript host page with Ports and dispose    |
 | `ui-showcase`    | Every Foldkit UI component with routing                                             |
 
 ## License

package/dist/examples.js

@@ -18,6 +18,7 @@ export const EXAMPLE_VALUES = [
     'websocket-chat',
     'kanban',
     'web-components',
+    'embedding',
     'ui-showcase',
 ];
 export const examples = [
@@ -116,6 +117,11 @@ export const examples = [
         title: 'web-components',
         description: 'QR code designer wiring two real third-party web components into Foldkit with CustomElement.define (vanilla-colorful and Shoelace)',
     },
+    {
+        value: 'embedding',
+        title: 'embedding',
+        description: 'A Foldkit widget embedded in a plain TypeScript host page via Runtime.embed, with Flags in, typed Ports in both directions, and dispose on unmount',
+    },
     {
         value: 'ui-showcase',
         title: 'ui-showcase',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-foldkit-app",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Create Foldkit applications",
   "type": "module",
   "main": "./dist/index.js",

package/templates/base/AGENTS.md

@@ -66,7 +66,7 @@ For DOM operations (focus, scroll, modals, scroll lock), Foldkit ships a `Dom` m
 
 ### File Organization
 
-A Foldkit app lives in two files. `src/main.ts` holds the pure definitions (Model, Messages, init, update, view). `src/entry.ts` imports them and boots the runtime with `Runtime.makeProgram` and `Runtime.run`. `index.html` references `entry.ts`. The split keeps `main.ts` importable from tests without booting a runtime as a side effect. Never call `Runtime.run` from `main.ts`.
+A Foldkit app lives in two files. `src/main.ts` holds the pure definitions (Model, Messages, init, update, view). `src/entry.ts` imports them and boots the runtime with `Runtime.makeApplication` and `Runtime.run`. `index.html` references `entry.ts`. The split keeps `main.ts` importable from tests without booting a runtime as a side effect. Never call `Runtime.run` from `main.ts`.
 
 Use uppercase section headers (`// MODEL`, `// MESSAGE`, `// INIT`, `// UPDATE`, `// COMMAND`, `// VIEW`) for wayfinding.