foldkit 0.97.0 → 0.97.2

package/dist/devTools/webSocketBridge.d.ts

@@ -13,7 +13,11 @@ type Hot = NonNullable<ImportMeta['hot']>;
  *
  * `dispatch` enqueues a Message into the runtime's message queue; the bridge
  * uses it to fulfill `RequestDispatchMessage` after decoding the payload
- * against `maybeMessageSchema`. When `maybeMessageSchema` is `None`, dispatch
+ * against a JSON-canonical derivation of `maybeMessageSchema` (via
+ * `Schema.toCodecJson`). The derivation reconstructs runtime values like
+ * `Option`, `Date`, `Map`, and `Set` from their JSON-tagged shapes, so
+ * application Message Schemas using stdlib types Just Work over dispatch
+ * without author-side changes. When `maybeMessageSchema` is `None`, dispatch
  * requests are rejected with an informative error.
  *
  * Production-safe: callers must check `import.meta.hot` is defined before

package/dist/devTools/webSocketBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webSocketBridge.d.ts","sourceRoot":"","sources":["../../src/devTools/webSocketBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,MAAM,EAIN,MAAM,EAEN,MAAM,IAAI,CAAC,EAGZ,MAAM,QAAQ,CAAA;AA+Bf,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,YAAY,CAAA;AAQ3D,KAAK,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;AAczC;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,aAAa,EACpB,KAAK,GAAG,EACR,UAAU,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EACnD,oBAAoB,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KACnD,MAAM,CAAC,MAAM,CAAC,IAAI,CA+EjB,CAAA"}
+{"version":3,"file":"webSocketBridge.d.ts","sourceRoot":"","sources":["../../src/devTools/webSocketBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,MAAM,EAIN,MAAM,EAEN,MAAM,IAAI,CAAC,EAGZ,MAAM,QAAQ,CAAA;AA+Bf,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,YAAY,CAAA;AAQ3D,KAAK,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;AAczC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,aAAa,EACpB,KAAK,GAAG,EACR,UAAU,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EACnD,oBAAoB,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KACnD,MAAM,CAAC,MAAM,CAAC,IAAI,CAiFjB,CAAA"}

package/dist/devTools/webSocketBridge.js

@@ -21,7 +21,11 @@ const currentAbsoluteIndex = (entriesLength, startIndex) => (entriesLength === 0
  *
  * `dispatch` enqueues a Message into the runtime's message queue; the bridge
  * uses it to fulfill `RequestDispatchMessage` after decoding the payload
- * against `maybeMessageSchema`. When `maybeMessageSchema` is `None`, dispatch
+ * against a JSON-canonical derivation of `maybeMessageSchema` (via
+ * `Schema.toCodecJson`). The derivation reconstructs runtime values like
+ * `Option`, `Date`, `Map`, and `Set` from their JSON-tagged shapes, so
+ * application Message Schemas using stdlib types Just Work over dispatch
+ * without author-side changes. When `maybeMessageSchema` is `None`, dispatch
  * requests are rejected with an informative error.
  *
  * Production-safe: callers must check `import.meta.hot` is defined before
@@ -30,6 +34,7 @@ const currentAbsoluteIndex = (entriesLength, startIndex) => (entriesLength === 0
 export const startWebSocketBridge = (store, hot, dispatch, maybeMessageSchema) => Effect.gen(function* () {
     const connectionId = generateConnectionId();
     const capturedContext = yield* Effect.context();
+    const maybeDispatchSchema = Option.map(maybeMessageSchema, S.toCodecJson);
     const encodeEventFrame = S.encodeUnknownSync(EventFrame);
     const encodeResponseFrame = S.encodeUnknownSync(ResponseFrame);
     const sendEvent = (event) => {
@@ -49,7 +54,7 @@ export const startWebSocketBridge = (store, hot, dispatch, maybeMessageSchema) =
         }),
     }));
     const handleRequest = (id, request) => Effect.gen(function* () {
-        const response = yield* dispatchRequest(store, dispatch, maybeMessageSchema, request);
+        const response = yield* dispatchRequest(store, dispatch, maybeDispatchSchema, request);
         sendResponse(id, response);
     });
     const handleRequestFrame = (frame) => {
@@ -94,7 +99,7 @@ const readModelResponse = (store, index, maybePath, expand) => Effect.gen(functi
 }).pipe(Effect.catchCause(cause => Effect.succeed(ResponseError({
     reason: `Failed to read Model at index ${index}: ${Cause.pretty(cause)}`,
 }))));
-const dispatchRequest = (store, dispatch, maybeMessageSchema, request) => Match.value(request).pipe(Match.tagsExhaustive({
+const dispatchRequest = (store, dispatch, maybeDispatchSchema, request) => Match.value(request).pipe(Match.tagsExhaustive({
     RequestGetModel: ({ maybePath, expand }) => Effect.gen(function* () {
         const state = yield* SubscriptionRef.get(store.stateRef);
         const index = currentAbsoluteIndex(state.entries.length, state.startIndex);
@@ -147,12 +152,12 @@ const dispatchRequest = (store, dispatch, maybeMessageSchema, request) => Match.
     }).pipe(Effect.catchCause(cause => Effect.succeed(ResponseError({
         reason: `Failed to resume: ${Cause.pretty(cause)}`,
     })))),
-    RequestDispatchMessage: ({ message }) => Option.match(maybeMessageSchema, {
+    RequestDispatchMessage: ({ message }) => Option.match(maybeDispatchSchema, {
         onNone: () => Effect.succeed(ResponseError({
             reason: 'Cannot dispatch: DevToolsConfig.Message not configured. Pass your Message Schema to enable dispatch.',
         })),
-        onSome: messageSchema => Effect.gen(function* () {
-            const decodedMessage = yield* S.decodeUnknownEffect(messageSchema)(message);
+        onSome: dispatchSchema => Effect.gen(function* () {
+            const decodedMessage = yield* S.decodeUnknownEffect(dispatchSchema)(message);
             const stateBefore = yield* SubscriptionRef.get(store.stateRef);
             const acceptedAtIndex = stateBefore.startIndex + stateBefore.entries.length;
             yield* dispatch(decodedMessage);

package/dist/html/lazy.d.ts

@@ -4,11 +4,22 @@ import type { Html } from './index.js';
  *  equal (`===`) to the previous call, the cached VNode is returned without
  *  re-running the view function. Snabbdom's `patchVnode` short-circuits when
  *  it sees the same VNode reference, so both VNode construction and subtree
- *  diffing are skipped. */
+ *  diffing are skipped.
+ *
+ *  The cached VNode must be rendered at a single position in the tree.
+ *  Snabbdom tracks the real DOM through each VNode's mutable `.elm` field
+ *  and assumes one VNode per position. Rendering the same cached VNode at
+ *  two positions causes patches to collide and can duplicate or misplace
+ *  DOM nodes. If the same content needs to appear in multiple positions,
+ *  create one slot per position. */
 export declare const createLazy: () => (<Args extends ReadonlyArray<unknown>>(fn: (...args: Args) => Html, args: Args) => Html);
 /** Creates a keyed memoization map for view functions rendered in a loop. Each
  *  key gets its own independent cache slot. On each render, only entries whose
  *  function reference, dispatch context, or arguments have changed by reference
- *  are recomputed. */
+ *  are recomputed.
+ *
+ *  Like `createLazy`, each key's cached VNode must be rendered at a single
+ *  position in the tree. If the same item needs to appear in multiple
+ *  positions, create one keyed lazy per position. */
 export declare const createKeyedLazy: () => (<Args extends ReadonlyArray<unknown>>(key: string, fn: (...args: Args) => Html, args: Args) => Html);
 //# sourceMappingURL=lazy.d.ts.map

package/dist/html/lazy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../src/html/lazy.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAsCtC;;;;;2BAK2B;AAC3B,eAAO,MAAM,UAAU,QAAO,CAAC,CAAC,IAAI,SAAS,aAAa,CAAC,OAAO,CAAC,EACjE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,EAC3B,IAAI,EAAE,IAAI,KACP,IAAI,CAUR,CAAA;AAED;;;sBAGsB;AACtB,eAAO,MAAM,eAAe,QAAO,CAAC,CAAC,IAAI,SAAS,aAAa,CAAC,OAAO,CAAC,EACtE,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,EAC3B,IAAI,EAAE,IAAI,KACP,IAAI,CAWR,CAAA"}
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../src/html/lazy.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAsCtC;;;;;;;;;;;;oCAYoC;AACpC,eAAO,MAAM,UAAU,QAAO,CAAC,CAAC,IAAI,SAAS,aAAa,CAAC,OAAO,CAAC,EACjE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,EAC3B,IAAI,EAAE,IAAI,KACP,IAAI,CAUR,CAAA;AAED;;;;;;;qDAOqD;AACrD,eAAO,MAAM,eAAe,QAAO,CAAC,CAAC,IAAI,SAAS,aAAa,CAAC,OAAO,CAAC,EACtE,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,EAC3B,IAAI,EAAE,IAAI,KACP,IAAI,CAWR,CAAA"}

package/dist/html/lazy.js

@@ -19,7 +19,14 @@ const resolveOrCache = (previousEntry, fn, args, onCache) => Effect.gen(function
  *  equal (`===`) to the previous call, the cached VNode is returned without
  *  re-running the view function. Snabbdom's `patchVnode` short-circuits when
  *  it sees the same VNode reference, so both VNode construction and subtree
- *  diffing are skipped. */
+ *  diffing are skipped.
+ *
+ *  The cached VNode must be rendered at a single position in the tree.
+ *  Snabbdom tracks the real DOM through each VNode's mutable `.elm` field
+ *  and assumes one VNode per position. Rendering the same cached VNode at
+ *  two positions causes patches to collide and can duplicate or misplace
+ *  DOM nodes. If the same content needs to appear in multiple positions,
+ *  create one slot per position. */
 export const createLazy = () => {
     let cached;
     return (fn, args) => resolveOrCache(cached, fn, args, entry => {
@@ -29,7 +36,11 @@ export const createLazy = () => {
 /** Creates a keyed memoization map for view functions rendered in a loop. Each
  *  key gets its own independent cache slot. On each render, only entries whose
  *  function reference, dispatch context, or arguments have changed by reference
- *  are recomputed. */
+ *  are recomputed.
+ *
+ *  Like `createLazy`, each key's cached VNode must be rendered at a single
+ *  position in the tree. If the same item needs to appear in multiple
+ *  positions, create one keyed lazy per position. */
 export const createKeyedLazy = () => {
     const cache = new Map();
     return (key, fn, args) => resolveOrCache(cache.get(key), fn, args, entry => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foldkit",
-  "version": "0.97.0",
+  "version": "0.97.2",
   "description": "A TypeScript frontend framework, built on Effect and architected like Elm",
   "type": "module",
   "main": "./dist/index.js",