foldkit 0.97.0 → 0.97.1

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.1",
   "description": "A TypeScript frontend framework, built on Effect and architected like Elm",
   "type": "module",
   "main": "./dist/index.js",