create-foldkit-app 0.35.1 → 0.35.2

package/dist/templates/base/FOLDKIT.md

@@ -61,7 +61,7 @@ Then replace this file whole. Foldkit's conventions change with its APIs, and a
 const update = (model: Model, message: Message) =>
   Message.match<Update.Return<Model, Message>>(message, {
     ClickedIncrement: () => ({
-      model: evo(model, { count: count => count + 1 }),
+      model: modifyFields(model, { count: count => count + 1 }),
     }),
   })
 ```
@@ -86,7 +86,7 @@ Add `toParentOutMessage` only when at least one child OutMessage should continue
 
 When a `foldChildInits` entry can derive or forward an OutMessage, add `resolveOutMessage` to construct one parent OutMessage from the named OutMessages after every local fold completes. Combine their information when both results matter; choosing one discards the other. The callback also receives the final Model. If that Model alone contains everything needed, use local folds and attach a parent OutMessage afterward with `Update.withOutMessage`.
 
-Use `evo()` from `foldkit/struct` for immutable model updates. Never spread or `Object.assign`.
+Use `modifyFields()` from `foldkit/struct` for immutable model updates. Never spread or `Object.assign`.
 
 ### View
 

package/dist/templates/examples/api-cache/package.json

@@ -9,9 +9,9 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@effect/platform-browser": "4.0.0-rc.115",
+    "@effect/platform-browser": "4.0.0-rc.116",
     "@foldkit/ui": "workspace:*",
-    "effect": "4.0.0-rc.115",
+    "effect": "4.0.0-rc.116",
     "foldkit": "workspace:*"
   },
   "devDependencies": {

package/dist/templates/examples/api-cache/src/main.fixture.ts

@@ -1,5 +1,5 @@
 import { HashMap, Option } from 'effect'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 
 import { Tabs } from '@foldkit/ui'
 
@@ -44,14 +44,14 @@ export const loadingPostsModel: Model = {
   stats: StatsData.Idle(),
 }
 
-export const loadedPostsModel: Model = evo(loadingPostsModel, {
+export const loadedPostsModel: Model = modifyFields(loadingPostsModel, {
   posts: () =>
     PostsData.Success({
       data: { posts: fixturePosts, fetchedAt: FETCHED_AT },
     }),
 })
 
-export const cachedFirstPostModel: Model = evo(loadedPostsModel, {
+export const cachedFirstPostModel: Model = modifyFields(loadedPostsModel, {
   postDetailById: () =>
     HashMap.set(
       HashMap.empty(),
@@ -62,7 +62,7 @@ export const cachedFirstPostModel: Model = evo(loadedPostsModel, {
     ),
 })
 
-export const loadedStatsModel: Model = evo(loadedPostsModel, {
+export const loadedStatsModel: Model = modifyFields(loadedPostsModel, {
   activeTab: () => 'Stats',
   stats: () =>
     StatsData.Success({

package/dist/templates/examples/api-cache/src/main.ts

@@ -13,7 +13,7 @@ import {
 import { AsyncData, Command, Runtime, Subscription, Update } from 'foldkit'
 import { Document, Html, HtmlBuilder } from 'foldkit/html'
 import { defineMessageUnion } from 'foldkit/message'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 
 import { Button, Tabs } from '@foldkit/ui'
 
@@ -102,7 +102,7 @@ const applyPostsTransition = (
   Option.match(maybeNextPosts, {
     onNone: () => ({ model }),
     onSome: nextPosts => ({
-      model: evo(model, { posts: () => nextPosts }),
+      model: modifyFields(model, { posts: () => nextPosts }),
       commands: [FetchPosts()],
     }),
   })
@@ -114,7 +114,7 @@ const applyStatsTransition = (
   Option.match(maybeNextStats, {
     onNone: () => ({ model }),
     onSome: nextStats => ({
-      model: evo(model, { stats: () => nextStats }),
+      model: modifyFields(model, { stats: () => nextStats }),
       commands: [FetchStats()],
     }),
   })
@@ -123,7 +123,7 @@ const setPostDetail = (postId: string, postDetail: PostDetailData) =>
   HashMap.set(postId, postDetail)
 
 const activateTab = (model: Model, tab: Tab): UpdateReturn => {
-  const modelWithActiveTab = evo(model, { activeTab: () => tab })
+  const modelWithActiveTab = modifyFields(model, { activeTab: () => tab })
 
   return Match.value(tab).pipe(
     Match.withReturnType<UpdateReturn>(),
@@ -156,7 +156,7 @@ const foldTabsOutMessage = Tabs.OutMessage.match<
 const foldTabs = Update.foldChild({
   update: AppTabs.update,
   read: (model: Model) => Option.some(model.tabs),
-  write: (model, nextTabs) => evo(model, { tabs: () => nextTabs }),
+  write: (model, nextTabs) => modifyFields(model, { tabs: () => nextTabs }),
   toParentMessage: message => Message.GotTabsMessage({ message }),
   foldOutMessage: foldTabsOutMessage,
 })
@@ -166,13 +166,13 @@ export const update = (model: Model, message: Message) =>
     GotTabsMessage: ({ message }) => foldTabs(model, message),
 
     ClickedPost: ({ postId }) => {
-      const selectedModel = evo(model, {
+      const selectedModel = modifyFields(model, {
         maybeSelectedPostId: () => Option.some(postId),
       })
 
       return Option.match(HashMap.get(model.postDetailById, postId), {
         onNone: () => ({
-          model: evo(selectedModel, {
+          model: modifyFields(selectedModel, {
             postDetailById: setPostDetail(postId, PostDetailData.Loading()),
           }),
           commands: [FetchPostDetail({ postId })],
@@ -182,7 +182,7 @@ export const update = (model: Model, message: Message) =>
     },
 
     ClickedBackToPosts: () => ({
-      model: evo(model, { maybeSelectedPostId: () => Option.none() }),
+      model: modifyFields(model, { maybeSelectedPostId: () => Option.none() }),
     }),
 
     ClickedInvalidatePosts: () =>
@@ -192,7 +192,7 @@ export const update = (model: Model, message: Message) =>
       applyPostsTransition(model, AsyncData.revalidateOrLoad(model.posts)),
 
     ClickedRetryPostDetail: ({ postId }) => ({
-      model: evo(model, {
+      model: modifyFields(model, {
         postDetailById: setPostDetail(postId, PostDetailData.Loading()),
       }),
       commands: [FetchPostDetail({ postId })],
@@ -208,17 +208,17 @@ export const update = (model: Model, message: Message) =>
       applyStatsTransition(model, AsyncData.revalidate(model.stats)),
 
     SettledFetchPosts: ({ result }) => ({
-      model: evo(model, { posts: AsyncData.settle(result) }),
+      model: modifyFields(model, { posts: AsyncData.settle(result) }),
     }),
 
     SettledFetchPostDetail: ({ postId, result }) => ({
-      model: evo(model, {
+      model: modifyFields(model, {
         postDetailById: HashMap.modify(postId, AsyncData.settle(result)),
       }),
     }),
 
     SettledFetchStats: ({ result }) => ({
-      model: evo(model, { stats: AsyncData.settle(result) }),
+      model: modifyFields(model, { stats: AsyncData.settle(result) }),
     }),
   })
 

package/dist/templates/examples/api-cache/src/story.test.ts

@@ -1,6 +1,6 @@
 import { HashMap, Option, Result } from 'effect'
 import { Command, given, message, model, story } from 'foldkit/story'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 import { expect, test } from 'vitest'
 
 import { Tabs } from '@foldkit/ui'
@@ -97,7 +97,7 @@ test('a revalidation tick keeps stale stats on screen while refetching', () => {
       FetchStats,
       Message.SettledFetchStats({
         result: Result.succeed({
-          stats: evo(fixtureStats, { activeUsers: () => 99 }),
+          stats: modifyFields(fixtureStats, { activeUsers: () => 99 }),
           fetchedAt: FETCHED_AT + 5000,
         }),
       }),
@@ -135,7 +135,7 @@ test('a failed refresh keeps the stale stats on screen with the error', () => {
 test('refresh clicks during an in-flight fetch are deduplicated', () => {
   story(
     update,
-    given(evo(loadedStatsModel, { stats: () => StatsData.Loading() })),
+    given(modifyFields(loadedStatsModel, { stats: () => StatsData.Loading() })),
     message(Message.ClickedRefreshStats()),
     Command.expectNone(),
   )
@@ -145,7 +145,7 @@ test('a revalidation tick during a refresh is deduplicated', () => {
   story(
     update,
     given(
-      evo(loadedStatsModel, {
+      modifyFields(loadedStatsModel, {
         stats: () =>
           StatsData.Refreshing({
             data: { stats: fixtureStats, fetchedAt: FETCHED_AT },
@@ -187,7 +187,7 @@ test('retrying failed posts shows the loading state and refetches', () => {
   story(
     update,
     given(
-      evo(loadedPostsModel, {
+      modifyFields(loadedPostsModel, {
         posts: () => PostsData.Failure({ error: 'The server is down.' }),
       }),
     ),
@@ -274,7 +274,7 @@ test('revisiting a post with a cached failure shows it without refetching', () =
   story(
     update,
     given(
-      evo(loadedPostsModel, {
+      modifyFields(loadedPostsModel, {
         postDetailById: () =>
           HashMap.set(
             HashMap.empty(),

package/dist/templates/examples/auth/package.json

@@ -9,10 +9,10 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@effect/platform-browser": "4.0.0-rc.115",
+    "@effect/platform-browser": "4.0.0-rc.116",
     "@foldkit/ui": "workspace:*",
     "clsx": "^2.1.1",
-    "effect": "4.0.0-rc.115",
+    "effect": "4.0.0-rc.116",
     "foldkit": "workspace:*"
   },
   "devDependencies": {

package/dist/templates/examples/auth/src/page/loggedOut/page/login.scene.test.ts

@@ -11,12 +11,12 @@ import {
   type,
   within,
 } from 'foldkit/scene'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 import { describe, test } from 'vitest'
 
 import { Message, SimulateAuthRequest, initModel, update, view } from './login'
 
-const validModel = evo(initModel(), {
+const validModel = modifyFields(initModel(), {
   email: () => Valid({ value: 'alice@example.com' }),
   password: () => Valid({ value: 'password' }),
 })

package/dist/templates/examples/auth/src/page/loggedOut/page/login.story.test.ts

@@ -8,7 +8,7 @@ import {
   model,
   story,
 } from 'foldkit/story'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 import { describe, expect, test } from 'vitest'
 
 import {
@@ -19,7 +19,7 @@ import {
   update,
 } from './login'
 
-const validModel = evo(initModel(), {
+const validModel = modifyFields(initModel(), {
   email: () => Valid({ value: 'alice@example.com' }),
   password: () => Valid({ value: 'password' }),
 })

package/dist/templates/examples/auth/src/page/loggedOut/page/login.ts

@@ -12,7 +12,7 @@ import {
 } from 'foldkit/fieldValidation'
 import { Html, HtmlBuilder } from 'foldkit/html'
 import { defineMessageUnion } from 'foldkit/message'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 
 import { Button, Input } from '@foldkit/ui'
 
@@ -111,11 +111,11 @@ export const update = (model: Model, message: Message) =>
     message,
     {
       ChangedEmail: ({ value }) => ({
-        model: evo(model, { email: () => validateEmail(value) }),
+        model: modifyFields(model, { email: () => validateEmail(value) }),
       }),
 
       ChangedPassword: ({ value }) => ({
-        model: evo(model, { password: () => validatePassword(value) }),
+        model: modifyFields(model, { password: () => validatePassword(value) }),
       }),
 
       SubmittedForm: () => {
@@ -128,7 +128,7 @@ export const update = (model: Model, message: Message) =>
         }
 
         return {
-          model: evo(model, { isSubmitting: () => true }),
+          model: modifyFields(model, { isSubmitting: () => true }),
           commands: [
             SimulateAuthRequest({
               email: model.email.value,
@@ -144,7 +144,7 @@ export const update = (model: Model, message: Message) =>
       }),
 
       FailedSimulateAuthRequest: ({ error }) => ({
-        model: evo(model, {
+        model: modifyFields(model, {
           password: () =>
             Invalid({
               value: model.password.value,

package/dist/templates/examples/auth/src/page/loggedOut/update.ts

@@ -1,6 +1,6 @@
 import { Option } from 'effect'
 import { Update } from 'foldkit'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 
 import { Message, OutMessage } from './message'
 import { Model } from './model'
@@ -10,7 +10,7 @@ const foldLogin = Update.foldChild({
   update: Login.update,
   read: (model: Model) => Option.some(model.loginModel),
   write: (model, nextLoginModel) =>
-    evo(model, { loginModel: () => nextLoginModel }),
+    modifyFields(model, { loginModel: () => nextLoginModel }),
   toParentMessage: message => Message.GotLoginMessage({ message }),
   toParentOutMessage: Login.OutMessage.match<OutMessage>({
     SucceededLogin: ({ session }) => OutMessage.SucceededLogin({ session }),

package/dist/templates/examples/auth/src/scene.test.ts

@@ -8,7 +8,7 @@ import {
   submit,
   text,
 } from 'foldkit/scene'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 import { describe, test } from 'vitest'
 
 import { SaveSession } from './command'
@@ -26,7 +26,7 @@ import { view } from './view'
 
 const validModel = LoggedOut.Model({
   route: AppRoute.Login(),
-  loginModel: evo(initLoginModel(), {
+  loginModel: modifyFields(initLoginModel(), {
     email: () => Valid({ value: 'alice@example.com' }),
     password: () => Valid({ value: 'password' }),
   }),

package/dist/templates/examples/auth/src/update.ts

@@ -1,7 +1,7 @@
 import { Effect, Match, Option, Schema } from 'effect'
 import { Command, Update } from 'foldkit'
 import { UrlRequest, load, pushUrl, replaceUrl } from 'foldkit/navigation'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 import { toString as urlToString } from 'foldkit/url'
 
 import { ClearSession, LogError, SaveSession } from './command'
@@ -125,7 +125,7 @@ export const update = (model: Model, message: Message) =>
             Match.value(route).pipe(
               withUpdateReturn,
               Match.tag('Home', 'Login', 'NotFound', route => ({
-                model: evo(loggedOutModel, { route: () => route }),
+                model: modifyFields(loggedOutModel, { route: () => route }),
               })),
               Match.orElse(() => ({ model, commands: [RedirectToLogin()] })),
             ),
@@ -134,7 +134,7 @@ export const update = (model: Model, message: Message) =>
             Match.value(route).pipe(
               withUpdateReturn,
               Match.tag('Dashboard', 'Settings', 'NotFound', route => ({
-                model: evo(loggedInModel, { route: () => route }),
+                model: modifyFields(loggedInModel, { route: () => route }),
               })),
               Match.orElse(() => ({
                 model,

package/dist/templates/examples/canvas-art/package.json

@@ -9,9 +9,9 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@effect/platform-browser": "4.0.0-rc.115",
+    "@effect/platform-browser": "4.0.0-rc.116",
     "@foldkit/ui": "workspace:*",
-    "effect": "4.0.0-rc.115",
+    "effect": "4.0.0-rc.116",
     "foldkit": "workspace:*"
   },
   "devDependencies": {

package/dist/templates/examples/canvas-art/src/main.ts

@@ -2,7 +2,7 @@ import { Array, Effect, Number, Option, Random, Schema, pipe } from 'effect'
 import { Canvas, Command, Runtime, Subscription, type Update } from 'foldkit'
 import { Document, Html, HtmlBuilder } from 'foldkit/html'
 import { defineMessageUnion } from 'foldkit/message'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 
 import { Button } from '@foldkit/ui'
 
@@ -113,7 +113,7 @@ const advanceBall =
     const maxY = CANVAS_HEIGHT - ball.radius
     const bouncedX = nextX < minX || nextX > maxX
     const bouncedY = nextY < minY || nextY > maxY
-    return evo(ball, {
+    return modifyFields(ball, {
       x: () => Math.max(minX, Math.min(maxX, nextX)),
       y: () => Math.max(minY, Math.min(maxY, nextY)),
       vx: vx => (bouncedX ? -vx : vx),
@@ -124,7 +124,7 @@ const advanceBall =
 export const update = (model: Model, message: Message) =>
   Message.match<Update.Return<Model, Message>>(message, {
     TickedFrame: ({ deltaTime }) => ({
-      model: evo(model, {
+      model: modifyFields(model, {
         balls: Array.map(advanceBall(deltaTime / MS_PER_SECOND)),
       }),
     }),
@@ -135,7 +135,7 @@ export const update = (model: Model, message: Message) =>
     }),
 
     CompletedGenerateBall: ({ x, y, vx, vy, radius, color }) => ({
-      model: evo(model, {
+      model: modifyFields(model, {
         balls: Array.append({
           id: model.nextId,
           x,
@@ -149,10 +149,10 @@ export const update = (model: Model, message: Message) =>
       }),
     }),
 
-    ClickedClear: () => ({ model: evo(model, { balls: () => [] }) }),
+    ClickedClear: () => ({ model: modifyFields(model, { balls: () => [] }) }),
 
     ClickedTogglePlay: () => ({
-      model: evo(model, { isRunning: running => !running }),
+      model: modifyFields(model, { isRunning: running => !running }),
     }),
   })
 

package/dist/templates/examples/canvas-art/src/scene.test.ts

@@ -1,5 +1,5 @@
 import { click, expect, given, role, scene, text } from 'foldkit/scene'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 import { describe, test } from 'vitest'
 
 import { type Model, update, view } from './main'
@@ -34,7 +34,7 @@ describe('view', () => {
   })
 
   test('the ball count reflects spawned balls in the Model', () => {
-    const populatedModel: Model = evo(emptyModel, {
+    const populatedModel: Model = modifyFields(emptyModel, {
       balls: () => [
         { id: 0, x: 10, y: 20, vx: 1, vy: 1, radius: 8, color: '#ff2d55' },
         { id: 1, x: 30, y: 40, vx: -1, vy: 1, radius: 12, color: '#5ac8fa' },
@@ -51,7 +51,7 @@ describe('view', () => {
   })
 
   test('Clear empties the rendered ball count', () => {
-    const populatedModel: Model = evo(emptyModel, {
+    const populatedModel: Model = modifyFields(emptyModel, {
       balls: () => [
         { id: 0, x: 10, y: 20, vx: 1, vy: 1, radius: 8, color: '#ff2d55' },
       ],

package/dist/templates/examples/canvas-art/src/story.test.ts

@@ -1,5 +1,5 @@
 import { Command, given, message, model, story } from 'foldkit/story'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 import { describe, expect, test } from 'vitest'
 
 import { GenerateBall, Message, type Model, update } from './main'
@@ -10,7 +10,7 @@ const emptyModel: Model = {
   isRunning: true,
 }
 
-const populatedModel: Model = evo(emptyModel, {
+const populatedModel: Model = modifyFields(emptyModel, {
   balls: () => [
     { id: 0, x: 100, y: 100, vx: 50, vy: 50, radius: 10, color: '#ff2d55' },
     { id: 1, x: 200, y: 200, vx: -50, vy: -50, radius: 15, color: '#5ac8fa' },
@@ -97,7 +97,7 @@ describe('update', () => {
     })
 
     test('bounces a ball off the canvas edges, flipping its velocity', () => {
-      const movingRightModel: Model = evo(emptyModel, {
+      const movingRightModel: Model = modifyFields(emptyModel, {
         balls: () => [
           {
             id: 0,

package/dist/templates/examples/charting/package.json

@@ -9,11 +9,11 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@effect/platform-browser": "4.0.0-rc.115",
+    "@effect/platform-browser": "4.0.0-rc.116",
     "@foldkit/ui": "workspace:*",
     "clsx": "^2.1.1",
     "echarts": "^6.1.0",
-    "effect": "4.0.0-rc.115",
+    "effect": "4.0.0-rc.116",
     "foldkit": "workspace:*"
   },
   "devDependencies": {

package/dist/templates/examples/charting/src/main.fixture.ts

@@ -1,5 +1,5 @@
 import { Option } from 'effect'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 
 import { RadioGroup } from '@foldkit/ui'
 
@@ -120,7 +120,7 @@ export const loadingModel = Model.make({
   maybeSelectedDatumId: Option.none(),
 })
 
-export const readyModel = evo(loadingModel, {
+export const readyModel = modifyFields(loadingModel, {
   telemetry: () => TelemetryAsyncData.Success({ data: sampleTelemetry }),
   maybeChartHostId: () => Option.some('test-chart-host'),
 })

package/dist/templates/examples/charting/src/scene.test.ts

@@ -9,7 +9,7 @@ import {
   scene,
   text,
 } from 'foldkit/scene'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 import { describe, test } from 'vitest'
 
 import { RadioGroup } from '@foldkit/ui'
@@ -79,7 +79,7 @@ describe('view', () => {
     scene(
       { update, view },
       given(
-        evo(readyModel, {
+        modifyFields(readyModel, {
           telemetry: () =>
             TelemetryAsyncData.Refreshing({ data: sampleTelemetry }),
         }),
@@ -95,7 +95,7 @@ describe('view', () => {
     scene(
       { update, view },
       given(
-        evo(loadingModel, {
+        modifyFields(loadingModel, {
           telemetry: () => TelemetryAsyncData.Failure({ error: 'offline' }),
         }),
       ),

package/dist/templates/examples/charting/src/story.test.ts

@@ -1,5 +1,5 @@
 import { Command, given, message, model, story } from 'foldkit/story'
-import { evo } from 'foldkit/struct'
+import { modifyFields } from 'foldkit/struct'
 import { expect, test } from 'vitest'
 
 import { RadioGroup } from '@foldkit/ui'
@@ -103,7 +103,7 @@ test('a failed refresh preserves stale data in the stale state', () => {
   story(
     update,
     given(
-      evo(readyModel, {
+      modifyFields(readyModel, {
         telemetry: () =>
           TelemetryAsyncData.Refreshing({ data: sampleTelemetry }),
       }),