create-foldkit-app 0.31.0 → 0.31.1-canary.4e7d8d4010be

package/dist/templates/base/FOLDKIT.md

@@ -60,7 +60,7 @@ When composing one of those results, bind the whole result to a value named afte
 
 Pass optional Commands directly to APIs that accept them: `Command.mapMessages(homeInit.commands, toParentMessage)`. Use `result.commands ?? []` only when the next operation requires a concrete array for spreading, concatenating, execution, or an assertion.
 
-`Update.Return<Model, Message>` rejects an OutMessage-producing result where an API would consume only its Model and Commands. `Update.ReturnWithOutMessage<Model, Message, OutMessage>` still accepts a result with no `outMessage`, because omission means the update emitted nothing.
+Use `Update.Return<Model, Message>` when an update cannot emit an OutMessage. It prevents a result containing an OutMessage from entering code that would keep only its Model and Commands. A result with no `outMessage` can still be used where `Update.ReturnWithOutMessage<Model, Message, OutMessage>` is expected. The missing field means that update emitted no OutMessage.
 
 Manual unpacking of a child result usually means the site should use `Update.foldChild` or `Update.foldChildStep`.
 
@@ -68,7 +68,7 @@ Use `Update.combine` when a later Step should receive the Model produced by an e
 
 When the OutMessage is already known while constructing a new result, include it directly: `{ model, commands, outMessage }`. Use `Update.withOutMessage` when attaching an OutMessage to an existing plain return or when the value has the type `OutMessage | undefined`. Pipe an existing return into the helper: `pipe(dialogClose, Update.withOutMessage(outMessage))`. When constructing the plain return in the same expression, pass it first: `Update.withOutMessage({ model, commands }, outMessage)`.
 
-Add `toParentOutMessage` only when at least one child OutMessage is forwarded from the current Submodel to its parent. Omit it when no variant is forwarded. Local handling through `foldOutMessage` is independent, so a forwarded variant may also update the current parent. Never write `toParentOutMessage: () => undefined`.
+Add `toParentOutMessage` only when at least one child OutMessage should continue to the current Submodel's parent. For partial forwarding, match every child variant and return `undefined` for the variants that stop here. Omit `toParentOutMessage` when every variant stops here. `foldOutMessage` still handles each variant locally, including variants that continue upward. Never write `toParentOutMessage: () => undefined`.
 
 Use `evo()` from `foldkit/struct` for immutable model updates. Never spread or `Object.assign`.
 
@@ -109,7 +109,7 @@ Scene runs at any level, since a page's own `update`/`view` pair drops into `sce
 ## Code Style
 
 - Encode state in discriminated unions, not booleans or nullable fields. `Idle | Loading | Error | Ok`, not `isLoading: boolean`. Make impossible states unrepresentable.
-- Use `Option` for absence in the Model and domain values instead of `null` or `undefined`. Foldkit return records are the exception: omit `commands` and `outMessage` when absent. A partial `toParentOutMessage` mapper returns `undefined` for each named child variant that stops at the current parent. Prefix Option-typed values with `maybe*`. Match with `Option.match`; don't unwrap with `Option.map(...)` + `Option.getOrElse(...)` when you can just match.
+- Use `Option` for absence in the Model and domain values instead of `null` or `undefined`. Foldkit return records are the exception: omit `commands` and `outMessage` when absent. A partial `toParentOutMessage` mapper returns `undefined` for each child variant that stops at this Submodel. Prefix Option-typed values with `maybe*`. Match with `Option.match`; don't unwrap with `Option.map(...)` + `Option.getOrElse(...)` when you can just match.
 - Use Effect modules over native methods in `pipe` chains (`Array.map`, `String.startsWith`, `Array.findFirst`). Native methods are fine when calling directly on a named variable.
 - Never cast Schema values with `as Type`. Use the callable constructor: `Message.SucceededLogin({ sessionId })`, not `{ _tag: 'SucceededLogin', sessionId } as Message`.
 - Always `Array.isArrayEmpty` / `Array.isArrayNonEmpty` (not `.length === 0` / `.length > 0`). Use `Array.match` when handling both empty and non-empty cases.

package/dist/templates/examples/charting/src/view/chart.ts

@@ -13,53 +13,51 @@ import { formatInteger } from './format'
 
 export const CHART_HOST_ID = 'charting-chart'
 
-export const MountChart = Mount.define(
-  'MountChart',
-  { hostId: S.String },
-  Message.SucceededMountChart,
-  Message.FailedMountChart,
-)(
-  ({ hostId }) =>
-    element =>
-      Effect.gen(function* () {
-        if (!(element instanceof HTMLElement)) {
-          return Message.FailedMountChart({
-            reason: 'Chart host is not an HTMLElement.',
-          })
-        }
+const mountChart = (element: Element, hostId: string) =>
+  Effect.gen(function* () {
+    if (!(element instanceof HTMLElement)) {
+      return Message.FailedMountChart({
+        reason: 'Chart host is not an HTMLElement.',
+      })
+    }
 
-        return yield* Effect.acquireRelease(
-          Effect.try({
-            try: () => {
-              const chart = echarts.init(element, undefined, {
-                renderer: 'canvas',
-              })
-              const resizeObserver = new ResizeObserver(() => chart.resize())
-              resizeObserver.observe(element)
-              const onWindowResize = () => chart.resize()
-              window.addEventListener('resize', onWindowResize)
-              setChart(hostId, chart)
-              return { resizeObserver, onWindowResize }
-            },
-            catch: error =>
-              error instanceof Error
-                ? error
-                : new Error(`Failed to mount chart: ${error}`),
-          }),
-          ({ resizeObserver, onWindowResize }) =>
-            Effect.sync(() => {
-              resizeObserver.disconnect()
-              window.removeEventListener('resize', onWindowResize)
-              removeChart(hostId)
-            }),
-        ).pipe(
-          Effect.map(() => Message.SucceededMountChart({ hostId })),
-          Effect.catch(error =>
-            Effect.succeed(Message.FailedMountChart({ reason: error.message })),
-          ),
-        )
+    return yield* Effect.acquireRelease(
+      Effect.try({
+        try: () => {
+          const chart = echarts.init(element, undefined, {
+            renderer: 'canvas',
+          })
+          const resizeObserver = new ResizeObserver(() => chart.resize())
+          resizeObserver.observe(element)
+          const onWindowResize = () => chart.resize()
+          window.addEventListener('resize', onWindowResize)
+          setChart(hostId, chart)
+          return { resizeObserver, onWindowResize }
+        },
+        catch: error =>
+          error instanceof Error
+            ? error
+            : new Error(`Failed to mount chart: ${error}`),
       }),
-)
+      ({ resizeObserver, onWindowResize }) =>
+        Effect.sync(() => {
+          resizeObserver.disconnect()
+          window.removeEventListener('resize', onWindowResize)
+          removeChart(hostId)
+        }),
+    ).pipe(
+      Effect.map(() => Message.SucceededMountChart({ hostId })),
+      Effect.catch(error =>
+        Effect.succeed(Message.FailedMountChart({ reason: error.message })),
+      ),
+    )
+  })
+
+export const MountChart = Mount.define('MountChart', {
+  args: { hostId: S.String },
+  messages: [Message.SucceededMountChart, Message.FailedMountChart],
+  execute: ({ element, hostId }) => mountChart(element, hostId),
+})
 
 export const chartPanelView = (
   model: Model,

package/dist/templates/examples/map/src/main.ts

@@ -310,61 +310,58 @@ export const init: Runtime.ApplicationInit<Model, Message> = () => ({
 
 // MAP MOUNT
 
-export const MountMap = Mount.define(
-  'MountMap',
-  { hostId: S.String },
-  Message.SucceededMountMap,
-  Message.FailedMountMap,
-)(
-  ({ hostId }) =>
-    element =>
-      Effect.gen(function* () {
-        if (!(element instanceof HTMLElement)) {
-          return Message.FailedMountMap({
-            reason: 'Map host is not an HTMLElement.',
+const mountMap = (element: Element, hostId: string) =>
+  Effect.gen(function* () {
+    if (!(element instanceof HTMLElement)) {
+      return Message.FailedMountMap({
+        reason: 'Map host is not an HTMLElement.',
+      })
+    }
+
+    return yield* Effect.gen(function* () {
+      yield* Effect.acquireRelease(
+        Effect.gen(function* () {
+          const maplibre = yield* Effect.tryPromise(() => import('maplibre-gl'))
+          const map = new maplibre.Map({
+            container: element,
+            style: 'https://demotiles.maplibre.org/style.json',
+            center: [0, 20],
+            zoom: INITIAL_MAP_ZOOM,
           })
-        }
-        return yield* Effect.gen(function* () {
-          yield* Effect.acquireRelease(
-            Effect.gen(function* () {
-              const maplibre = yield* Effect.tryPromise(
-                () => import('maplibre-gl'),
-              )
-              const map = new maplibre.Map({
-                container: element,
-                style: 'https://demotiles.maplibre.org/style.json',
-                center: [0, 20],
-                zoom: INITIAL_MAP_ZOOM,
-              })
-
-              Array.forEach(featuredLocations, ({ id, lng, lat }) => {
-                const markerElement = document.createElement('button')
-                markerElement.setAttribute('data-location-id', id)
-                markerElement.setAttribute('aria-label', `Marker: ${id}`)
-                markerElement.className = markerStyle
-                new maplibre.Marker({ element: markerElement })
-                  .setLngLat([lng, lat])
-                  .addTo(map)
-              })
-
-              setMap(hostId, map)
-              return map
-            }),
-            () => Effect.sync(() => removeMap(hostId)),
-          )
 
-          return Message.SucceededMountMap({ hostId })
-        }).pipe(
-          Effect.catch(error =>
-            Effect.succeed(
-              Message.FailedMountMap({
-                reason: error instanceof Error ? error.message : `${error}`,
-              }),
-            ),
-          ),
-        )
-      }),
-)
+          Array.forEach(featuredLocations, ({ id, lng, lat }) => {
+            const markerElement = document.createElement('button')
+            markerElement.setAttribute('data-location-id', id)
+            markerElement.setAttribute('aria-label', `Marker: ${id}`)
+            markerElement.className = markerStyle
+            new maplibre.Marker({ element: markerElement })
+              .setLngLat([lng, lat])
+              .addTo(map)
+          })
+
+          setMap(hostId, map)
+          return map
+        }),
+        () => Effect.sync(() => removeMap(hostId)),
+      )
+
+      return Message.SucceededMountMap({ hostId })
+    }).pipe(
+      Effect.catch(error =>
+        Effect.succeed(
+          Message.FailedMountMap({
+            reason: error instanceof Error ? error.message : `${error}`,
+          }),
+        ),
+      ),
+    )
+  })
+
+export const MountMap = Mount.define('MountMap', {
+  args: { hostId: S.String },
+  messages: [Message.SucceededMountMap, Message.FailedMountMap],
+  execute: ({ element, hostId }) => mountMap(element, hostId),
+})
 
 // SUBSCRIPTIONS
 

package/dist/templates/release.json

@@ -1,22 +1,22 @@
 {
   "schemaVersion": 1,
-  "channel": "stable",
-  "sourceCommit": "51ee84596c4ff4c6141d2642c7c76446d6bf7890",
+  "channel": "canary",
+  "sourceCommit": "4e7d8d4010be5a84dd37d1dc48bb97b4f4e599f3",
   "packages": {
-    "create-foldkit-app": "0.31.0",
-    "@foldkit/devtools": "0.153.0",
-    "@foldkit/devtools-mcp": "0.19.0",
-    "foldkit": "0.153.0",
-    "@foldkit/markdown": "0.8.0",
-    "@foldkit/oxlint-plugin": "0.9.0",
-    "@foldkit/ui": "0.153.0",
-    "@foldkit/vite-plugin": "0.19.0"
+    "create-foldkit-app": "0.31.1-canary.4e7d8d4010be",
+    "@foldkit/devtools": "0.154.0-canary.4e7d8d4010be",
+    "@foldkit/devtools-mcp": "0.19.1-canary.4e7d8d4010be",
+    "foldkit": "0.154.0-canary.4e7d8d4010be",
+    "@foldkit/markdown": "0.8.0-canary.4e7d8d4010be",
+    "@foldkit/oxlint-plugin": "0.10.0-canary.4e7d8d4010be",
+    "@foldkit/ui": "0.154.0-canary.4e7d8d4010be",
+    "@foldkit/vite-plugin": "0.19.0-canary.4e7d8d4010be"
   },
   "dependencies": {
-    "@foldkit/devtools": "0.153.0",
-    "@foldkit/vite-plugin": "0.19.0",
-    "@foldkit/devtools-mcp": "0.19.0",
-    "@foldkit/oxlint-plugin": "0.9.0",
+    "@foldkit/devtools": "0.154.0-canary.4e7d8d4010be",
+    "@foldkit/vite-plugin": "0.19.0-canary.4e7d8d4010be",
+    "@foldkit/devtools-mcp": "0.19.1-canary.4e7d8d4010be",
+    "@foldkit/oxlint-plugin": "0.10.0-canary.4e7d8d4010be",
     "@trivago/prettier-plugin-sort-imports": "^6.0.2",
     "@types/node": "^25.9.3",
     "happy-dom": "^20.10.4",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-foldkit-app",
-  "version": "0.31.0",
+  "version": "0.31.1-canary.4e7d8d4010be",
   "description": "Create Foldkit applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,6 +38,7 @@
     "url": "https://github.com/foldkit/foldkit.git",
     "directory": "packages/create-foldkit-app"
   },
+  "homepage": "https://foldkit.dev/get-started/getting-started",
   "publishConfig": {
     "access": "public"
   },