lithent 1.18.5 → 1.20.0

package/README.md

@@ -38,6 +38,8 @@ used lightly in a variety of situations.
 - [Examples](#examples)
   - [With ESM](#with-esm)
   - [With UMD](#with-umd)
+- [Context API](#context-api)
+  - [Multi-value Provider Example](#multi-value-provider-example)
 - [Related Projects](#related-projects)
 - [Develop Guide](#develop-guide)
 - [Test](#test)
@@ -90,14 +92,14 @@ pnpm add lithent
 
 #### Or Use CDN
 
-* UMD : https://cdn.jsdelivr.net/npm/lithent@1.18.5/dist/lithent.umd.js
-* UMD-HELPER: https://cdn.jsdelivr.net/npm/lithent@1.18.5/helper/dist/lithentHelper.umd.js
-* UMD-FTAGS: https://cdn.jsdelivr.net/npm/lithent@1.18.5/ftags/dist/lithentFTags.umd.js
-* UMD-TAG: https://cdn.jsdelivr.net/npm/lithent@1.18.5/tag/dist/lithentTag.umd.js
-* ESM : https://cdn.jsdelivr.net/npm/lithent@1.18.5/dist/lithent.mjs
-* ESM-HELPER: https://cdn.jsdelivr.net/npm/lithent@1.18.5/helper/dist/lithentHelper.mjs
-* ESM-FTAGS: https://cdn.jsdelivr.net/npm/lithent@1.18.5/ftags/dist/lithentFTags.mjs
-* ESM-TAG: https://cdn.jsdelivr.net/npm/lithent@1.18.5/tag/dist/lithentTag.mjs
+* UMD : https://cdn.jsdelivr.net/npm/lithent@1.20.0/dist/lithent.umd.js
+* UMD-HELPER: https://cdn.jsdelivr.net/npm/lithent@1.20.0/helper/dist/lithentHelper.umd.js
+* UMD-FTAGS: https://cdn.jsdelivr.net/npm/lithent@1.20.0/ftags/dist/lithentFTags.umd.js
+* UMD-TAG: https://cdn.jsdelivr.net/npm/lithent@1.20.0/tag/dist/lithentTag.umd.js
+* ESM : https://cdn.jsdelivr.net/npm/lithent@1.20.0/dist/lithent.mjs
+* ESM-HELPER: https://cdn.jsdelivr.net/npm/lithent@1.20.0/helper/dist/lithentHelper.mjs
+* ESM-FTAGS: https://cdn.jsdelivr.net/npm/lithent@1.20.0/ftags/dist/lithentFTags.mjs
+* ESM-TAG: https://cdn.jsdelivr.net/npm/lithent@1.20.0/tag/dist/lithentTag.mjs
 
 
 It's easier to use lithent with JSX or HTM.
@@ -122,9 +124,9 @@ import { fTags, fFragment, fMount } from 'lithent/ftags';
 const { section, div, p, br, strong } = fTags;
 
 /* UMD
-<script src="https://cdn.jsdelivr.net/npm/lithent@1.18.5/dist/lithent.umd.js"></script>
-<script src="https://cdn.jsdelivr.net/npm/lithent@1.18.5/helper/dist/lithentHelper.umd.js"></script>
-<script src="https://cdn.jsdelivr.net/npm/lithent@1.18.5/ftags/dist/lithentFTags.umd.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/lithent@1.20.0/dist/lithent.umd.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/lithent@1.20.0/helper/dist/lithentHelper.umd.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/lithent@1.20.0/ftags/dist/lithentFTags.umd.js"></script>
 
 const { render } = lithent;
 const { fTags, fMount, fFragment } = lithentFTags;
@@ -197,10 +199,10 @@ const destroy = render(lTag`<${Component} />`, document.getElementById('root'),
 #### With UMD
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/lithent@1.18.5/dist/lithent.umd.js"></script>
-<!--script src="https://cdn.jsdelivr.net/npm/lithent@1.18.5/helper/dist/lithentHelper.umd.js"></script-->
-<script src="https://cdn.jsdelivr.net/npm/lithent@1.18.5/tag/dist/lithentTag.umd.js"></script>
-<!--script src="https://cdn.jsdelivr.net/npm/lithent@1.18.5/ftags/dist/lithentFTags.umd.js"></script-->
+<script src="https://cdn.jsdelivr.net/npm/lithent@1.20.0/dist/lithent.umd.js"></script>
+<!--script src="https://cdn.jsdelivr.net/npm/lithent@1.20.0/helper/dist/lithentHelper.umd.js"></script-->
+<script src="https://cdn.jsdelivr.net/npm/lithent@1.20.0/tag/dist/lithentTag.umd.js"></script>
+<!--script src="https://cdn.jsdelivr.net/npm/lithent@1.20.0/ftags/dist/lithentFTags.umd.js"></script-->
 
 <div id="root"></div>
 
@@ -232,6 +234,68 @@ const destroy = render(lTag`<${Component} />`, document.getElementById('root'),
 </script>
 ```
 
+## Context API
+
+Lithent-helper ships a lightweight context system so you can share state without manual prop drilling. Providers stay isolated from consumer renews and you can subscribe to every key or only the slices you need.
+
+### Multi-value Provider Example
+
+```tsx
+import { h, mount } from 'lithent';
+import { createContext } from 'lithent-helper';
+
+type AppState = { user: string; theme: string; count: number };
+
+const AppContext = createContext<AppState>();
+const { Provider, contextState, useContext } = AppContext;
+
+const AppProvider = mount((_renew, _props, children) => {
+  // Provider owns the shared state; consumers cannot trigger its renew directly.
+  const user = contextState('Alice');
+  const theme = contextState('dark');
+  const count = contextState(0);
+
+  return () => (
+    <Provider user={user} theme={theme} count={count}>
+      {children}
+    </Provider>
+  );
+});
+
+const StatsPanel = mount(renew => {
+  // Omitting the subscribe list subscribes to every value exposed by the Provider.
+  const ctx = useContext(AppContext, renew);
+  return () => (
+    <section>
+      <p>User: {ctx.user?.value}</p>
+      <p>Theme: {ctx.theme?.value}</p>
+      <p>Count: {ctx.count?.value}</p>
+      <button onClick={() => ctx.count && (ctx.count.value += 1)}>
+        Increment
+      </button>
+      <button onClick={() => ctx.count && (ctx.count.value = 3)}>
+        Set count to 3
+      </button>
+    </section>
+  );
+});
+
+const ThemeBadge = mount(renew => {
+  // Subscribe only to the theme key; user/count updates will not rerender this component.
+  const ctx = useContext(AppContext, renew, ['theme']);
+  return () => <span>Theme: {ctx.theme?.value}</span>;
+});
+
+const App = mount(() => {
+  return () => (
+    <AppProvider>
+      <StatsPanel />
+      <ThemeBadge />
+    </AppProvider>
+  );
+});
+```
+
 ## Related Projects
 - [htm](https://www.npmjs.com/package/htm) - making **H**yperscript **T**agged **M**arkup possible
 
@@ -276,4 +340,3 @@ pnpm install
 pnpm build
 pnpm test
 ```
-

package/devHelper/dist/componentMapControl.d.ts

@@ -0,0 +1,4 @@
+import type { CompKey } from 'lithent';
+export declare const enableComponentMapManualMode: () => void;
+export declare const disableComponentMapManualMode: () => void;
+export declare const removeComponentEntry: (compKey: CompKey) => void;

package/devHelper/dist/createBoundary.d.ts

@@ -0,0 +1,10 @@
+import type { CompKey, TagFunction } from 'lithent';
+export type BoundaryController = {
+    register: (compKey: CompKey) => () => void;
+    update: (nextCtor: TagFunction) => boolean;
+    dispose: () => void;
+};
+export declare const registerBoundaryInstance: (moduleId: string, compKey: CompKey) => () => void;
+export declare const disposeBoundary: (moduleId: string) => void;
+export declare const applyBoundaryUpdate: (moduleId: string, nextCtor: TagFunction) => boolean;
+export declare const createBoundary: (moduleId: string) => BoundaryController;

package/devHelper/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createBoundary } from './createBoundary';
+export type { BoundaryController } from './createBoundary';

package/devHelper/dist/lithentDevHelper.mjs

@@ -0,0 +1,72 @@
+import { setComponentMapManualMode as C, disposeComponentEntry as m, componentMap as p, replaceWDom as B } from "lithent";
+let c = 0;
+const R = () => {
+  c += 1, C(!0);
+}, b = () => {
+  c = Math.max(0, c - 1), c === 0 && C(!1);
+}, w = (t) => {
+  m(t);
+}, s = /* @__PURE__ */ new Map(), E = (t) => {
+  let e = s.get(t);
+  return e || (e = {
+    instances: /* @__PURE__ */ new Set(),
+    domMap: /* @__PURE__ */ new Map(),
+    scheduled: !1,
+    pendingCtor: void 0
+  }, s.set(t, e)), e;
+}, D = (t, e) => {
+  const n = E(t);
+  return n.instances.add(e), queueMicrotask(() => {
+    var o;
+    const r = p.get(e), a = ((o = r == null ? void 0 : r.vd) == null ? void 0 : o.value) ?? null;
+    a && n.domMap.set(e, a);
+  }), () => {
+    const r = s.get(t);
+    r && (r.instances.delete(e), r.domMap.delete(e), r.instances.size || s.delete(t));
+  };
+}, W = (t) => {
+  const e = s.get(t);
+  e && Array.from(e.instances).forEach(
+    (n) => w(n)
+  ), s.delete(t), b();
+}, k = (t, e) => {
+  const n = s.get(t);
+  return n ? (n.pendingCtor = e, n.scheduled || (n.scheduled = !0, queueMicrotask(() => y(t))), !0) : !1;
+}, y = (t) => {
+  const e = s.get(t);
+  if (!e) return;
+  e.scheduled = !1;
+  const n = e.pendingCtor;
+  if (!n)
+    return;
+  e.pendingCtor = void 0;
+  let r = !1, a = !1;
+  e.instances.forEach((o) => {
+    var g, M, h;
+    const u = p.get(o), v = e.domMap.get(o), i = ((g = u == null ? void 0 : u.vd) == null ? void 0 : g.value) || v;
+    if (!i || !i.el) {
+      a = !0;
+      return;
+    }
+    const { compProps: l, compChild: f } = i;
+    if (!l || !f) {
+      a = !0;
+      return;
+    }
+    try {
+      B(n, l, f, i);
+      const d = ((h = (M = p.get(o)) == null ? void 0 : M.vd) == null ? void 0 : h.value) || i;
+      e.domMap.set(o, d), r = !0;
+    } catch (d) {
+      console.warn(`[Lithent HMR] boundary update 실패: ${t}`, d);
+    }
+  }), (a && !r || e.pendingCtor) && (e.scheduled || (e.scheduled = !0, setTimeout(() => y(t), 0)));
+}, x = (t) => (R(), {
+  register: (e) => D(t, e),
+  update: (e) => k(t, e),
+  dispose: () => W(t)
+});
+export {
+  x as createBoundary
+};
+//# sourceMappingURL=lithentDevHelper.mjs.map

package/devHelper/dist/lithentDevHelper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lithentDevHelper.mjs","sources":["../src/componentMapControl.ts","../src/createBoundary.ts"],"sourcesContent":["import type { CompKey } from 'lithent';\nimport { setComponentMapManualMode, disposeComponentEntry } from 'lithent';\n\nlet manualModeRefCount = 0;\n\nexport const enableComponentMapManualMode = (): void => {\n  manualModeRefCount += 1;\n  setComponentMapManualMode(true);\n};\n\nexport const disableComponentMapManualMode = (): void => {\n  manualModeRefCount = Math.max(0, manualModeRefCount - 1);\n  if (manualModeRefCount === 0) {\n    setComponentMapManualMode(false);\n  }\n};\n\nexport const removeComponentEntry = (compKey: CompKey): void => {\n  disposeComponentEntry(compKey);\n};\n","import type { CompKey, TagFunction, WDom } from 'lithent';\nimport { componentMap, replaceWDom } from 'lithent';\nimport {\n  disableComponentMapManualMode,\n  enableComponentMapManualMode,\n  removeComponentEntry,\n} from './componentMapControl';\n\ntype InstanceRegistry = {\n  instances: Set<CompKey>;\n  domMap: Map<CompKey, WDom>;\n  scheduled: boolean;\n  pendingCtor?: TagFunction;\n};\n\nconst boundaryRegistry = new Map<string, InstanceRegistry>();\n\nconst getRegistry = (moduleId: string): InstanceRegistry => {\n  let registry = boundaryRegistry.get(moduleId);\n\n  if (!registry) {\n    registry = {\n      instances: new Set(),\n      domMap: new Map(),\n      scheduled: false,\n      pendingCtor: undefined,\n    };\n    boundaryRegistry.set(moduleId, registry);\n  }\n\n  return registry;\n};\n\nexport type BoundaryController = {\n  register: (compKey: CompKey) => () => void;\n  update: (nextCtor: TagFunction) => boolean;\n  dispose: () => void;\n};\n\nexport const registerBoundaryInstance = (\n  moduleId: string,\n  compKey: CompKey\n) => {\n  const registry = getRegistry(moduleId);\n\n  registry.instances.add(compKey);\n\n  queueMicrotask(() => {\n    const entry = componentMap.get(compKey);\n    const currentWDom = entry?.vd?.value ?? null;\n\n    if (currentWDom) {\n      registry.domMap.set(compKey, currentWDom);\n    }\n  });\n\n  return () => {\n    const currentRegistry = boundaryRegistry.get(moduleId);\n    if (!currentRegistry) return;\n\n    currentRegistry.instances.delete(compKey);\n    currentRegistry.domMap.delete(compKey);\n\n    if (!currentRegistry.instances.size) {\n      boundaryRegistry.delete(moduleId);\n    }\n  };\n};\n\nexport const disposeBoundary = (moduleId: string) => {\n  const registry = boundaryRegistry.get(moduleId);\n\n  if (registry) {\n    Array.from(registry.instances).forEach(compKey =>\n      removeComponentEntry(compKey)\n    );\n  }\n\n  boundaryRegistry.delete(moduleId);\n  disableComponentMapManualMode();\n};\n\nexport const applyBoundaryUpdate = (\n  moduleId: string,\n  nextCtor: TagFunction\n) => {\n  const registry = boundaryRegistry.get(moduleId);\n\n  if (!registry) return false;\n\n  registry.pendingCtor = nextCtor;\n\n  if (!registry.scheduled) {\n    registry.scheduled = true;\n    queueMicrotask(() => flushBoundary(moduleId));\n  }\n\n  return true;\n};\n\nconst flushBoundary = (moduleId: string) => {\n  const registry = boundaryRegistry.get(moduleId);\n  if (!registry) return;\n\n  registry.scheduled = false;\n\n  const ctor = registry.pendingCtor;\n  if (!ctor) {\n    return;\n  }\n\n  registry.pendingCtor = undefined;\n\n  let updated = false;\n  let hasMissing = false;\n\n  registry.instances.forEach(compKey => {\n    const entry = componentMap.get(compKey);\n    const cached = registry.domMap.get(compKey);\n    const currentWDom = entry?.vd?.value || cached;\n\n    if (!currentWDom || !currentWDom.el) {\n      hasMissing = true;\n      return;\n    }\n\n    const { compProps, compChild } = currentWDom;\n\n    if (!compProps || !compChild) {\n      hasMissing = true;\n      return;\n    }\n\n    try {\n      replaceWDom(ctor, compProps, compChild, currentWDom as any);\n      const refreshed = componentMap.get(compKey)?.vd?.value || currentWDom;\n      registry.domMap.set(compKey, refreshed as WDom);\n      updated = true;\n    } catch (error) {\n      console.warn(`[Lithent HMR] boundary update 실패: ${moduleId}`, error);\n    }\n  });\n\n  if ((hasMissing && !updated) || registry.pendingCtor) {\n    if (!registry.scheduled) {\n      registry.scheduled = true;\n      setTimeout(() => flushBoundary(moduleId), 0);\n    }\n  }\n};\n\nexport const createBoundary = (moduleId: string): BoundaryController => {\n  enableComponentMapManualMode();\n\n  return {\n    register: (compKey: CompKey) => registerBoundaryInstance(moduleId, compKey),\n    update: (nextCtor: TagFunction) => applyBoundaryUpdate(moduleId, nextCtor),\n    dispose: () => disposeBoundary(moduleId),\n  };\n};\n"],"names":["manualModeRefCount","enableComponentMapManualMode","setComponentMapManualMode","disableComponentMapManualMode","removeComponentEntry","compKey","disposeComponentEntry","boundaryRegistry","getRegistry","moduleId","registry","registerBoundaryInstance","entry","componentMap","currentWDom","_a","currentRegistry","disposeBoundary","applyBoundaryUpdate","nextCtor","flushBoundary","ctor","updated","hasMissing","cached","compProps","compChild","replaceWDom","refreshed","_c","_b","error","createBoundary"],"mappings":"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"}

package/devHelper/dist/lithentDevHelper.umd.js

@@ -0,0 +1,2 @@
+(function(a,r){typeof exports=="object"&&typeof module<"u"?r(exports,require("lithent")):typeof define=="function"&&define.amd?define(["exports","lithent"],r):(a=typeof globalThis<"u"?globalThis:a||self,r(a.lithentDevHelper={},a.lithent))})(this,function(a,r){"use strict";let d=0;const m=()=>{d+=1,r.setComponentMapManualMode(!0)},v=()=>{d=Math.max(0,d-1),d===0&&r.setComponentMapManualMode(!1)},b=t=>{r.disposeComponentEntry(t)},o=new Map,B=t=>{let e=o.get(t);return e||(e={instances:new Set,domMap:new Map,scheduled:!1,pendingCtor:void 0},o.set(t,e)),e},R=(t,e)=>{const n=B(t);return n.instances.add(e),queueMicrotask(()=>{var i;const s=r.componentMap.get(e),c=((i=s==null?void 0:s.vd)==null?void 0:i.value)??null;c&&n.domMap.set(e,c)}),()=>{const s=o.get(t);s&&(s.instances.delete(e),s.domMap.delete(e),s.instances.size||o.delete(t))}},w=t=>{const e=o.get(t);e&&Array.from(e.instances).forEach(n=>b(n)),o.delete(t),v()},D=(t,e)=>{const n=o.get(t);return n?(n.pendingCtor=e,n.scheduled||(n.scheduled=!0,queueMicrotask(()=>l(t))),!0):!1},l=t=>{const e=o.get(t);if(!e)return;e.scheduled=!1;const n=e.pendingCtor;if(!n)return;e.pendingCtor=void 0;let s=!1,c=!1;e.instances.forEach(i=>{var h,y,C;const p=r.componentMap.get(i),T=e.domMap.get(i),u=((h=p==null?void 0:p.vd)==null?void 0:h.value)||T;if(!u||!u.el){c=!0;return}const{compProps:M,compChild:g}=u;if(!M||!g){c=!0;return}try{r.replaceWDom(n,M,g,u);const f=((C=(y=r.componentMap.get(i))==null?void 0:y.vd)==null?void 0:C.value)||u;e.domMap.set(i,f),s=!0}catch(f){console.warn(`[Lithent HMR] boundary update 실패: ${t}`,f)}}),(c&&!s||e.pendingCtor)&&(e.scheduled||(e.scheduled=!0,setTimeout(()=>l(t),0)))},E=t=>(m(),{register:e=>R(t,e),update:e=>D(t,e),dispose:()=>w(t)});a.createBoundary=E,Object.defineProperty(a,Symbol.toStringTag,{value:"Module"})});
+//# sourceMappingURL=lithentDevHelper.umd.js.map

package/devHelper/dist/lithentDevHelper.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lithentDevHelper.umd.js","sources":["../src/componentMapControl.ts","../src/createBoundary.ts"],"sourcesContent":["import type { CompKey } from 'lithent';\nimport { setComponentMapManualMode, disposeComponentEntry } from 'lithent';\n\nlet manualModeRefCount = 0;\n\nexport const enableComponentMapManualMode = (): void => {\n  manualModeRefCount += 1;\n  setComponentMapManualMode(true);\n};\n\nexport const disableComponentMapManualMode = (): void => {\n  manualModeRefCount = Math.max(0, manualModeRefCount - 1);\n  if (manualModeRefCount === 0) {\n    setComponentMapManualMode(false);\n  }\n};\n\nexport const removeComponentEntry = (compKey: CompKey): void => {\n  disposeComponentEntry(compKey);\n};\n","import type { CompKey, TagFunction, WDom } from 'lithent';\nimport { componentMap, replaceWDom } from 'lithent';\nimport {\n  disableComponentMapManualMode,\n  enableComponentMapManualMode,\n  removeComponentEntry,\n} from './componentMapControl';\n\ntype InstanceRegistry = {\n  instances: Set<CompKey>;\n  domMap: Map<CompKey, WDom>;\n  scheduled: boolean;\n  pendingCtor?: TagFunction;\n};\n\nconst boundaryRegistry = new Map<string, InstanceRegistry>();\n\nconst getRegistry = (moduleId: string): InstanceRegistry => {\n  let registry = boundaryRegistry.get(moduleId);\n\n  if (!registry) {\n    registry = {\n      instances: new Set(),\n      domMap: new Map(),\n      scheduled: false,\n      pendingCtor: undefined,\n    };\n    boundaryRegistry.set(moduleId, registry);\n  }\n\n  return registry;\n};\n\nexport type BoundaryController = {\n  register: (compKey: CompKey) => () => void;\n  update: (nextCtor: TagFunction) => boolean;\n  dispose: () => void;\n};\n\nexport const registerBoundaryInstance = (\n  moduleId: string,\n  compKey: CompKey\n) => {\n  const registry = getRegistry(moduleId);\n\n  registry.instances.add(compKey);\n\n  queueMicrotask(() => {\n    const entry = componentMap.get(compKey);\n    const currentWDom = entry?.vd?.value ?? null;\n\n    if (currentWDom) {\n      registry.domMap.set(compKey, currentWDom);\n    }\n  });\n\n  return () => {\n    const currentRegistry = boundaryRegistry.get(moduleId);\n    if (!currentRegistry) return;\n\n    currentRegistry.instances.delete(compKey);\n    currentRegistry.domMap.delete(compKey);\n\n    if (!currentRegistry.instances.size) {\n      boundaryRegistry.delete(moduleId);\n    }\n  };\n};\n\nexport const disposeBoundary = (moduleId: string) => {\n  const registry = boundaryRegistry.get(moduleId);\n\n  if (registry) {\n    Array.from(registry.instances).forEach(compKey =>\n      removeComponentEntry(compKey)\n    );\n  }\n\n  boundaryRegistry.delete(moduleId);\n  disableComponentMapManualMode();\n};\n\nexport const applyBoundaryUpdate = (\n  moduleId: string,\n  nextCtor: TagFunction\n) => {\n  const registry = boundaryRegistry.get(moduleId);\n\n  if (!registry) return false;\n\n  registry.pendingCtor = nextCtor;\n\n  if (!registry.scheduled) {\n    registry.scheduled = true;\n    queueMicrotask(() => flushBoundary(moduleId));\n  }\n\n  return true;\n};\n\nconst flushBoundary = (moduleId: string) => {\n  const registry = boundaryRegistry.get(moduleId);\n  if (!registry) return;\n\n  registry.scheduled = false;\n\n  const ctor = registry.pendingCtor;\n  if (!ctor) {\n    return;\n  }\n\n  registry.pendingCtor = undefined;\n\n  let updated = false;\n  let hasMissing = false;\n\n  registry.instances.forEach(compKey => {\n    const entry = componentMap.get(compKey);\n    const cached = registry.domMap.get(compKey);\n    const currentWDom = entry?.vd?.value || cached;\n\n    if (!currentWDom || !currentWDom.el) {\n      hasMissing = true;\n      return;\n    }\n\n    const { compProps, compChild } = currentWDom;\n\n    if (!compProps || !compChild) {\n      hasMissing = true;\n      return;\n    }\n\n    try {\n      replaceWDom(ctor, compProps, compChild, currentWDom as any);\n      const refreshed = componentMap.get(compKey)?.vd?.value || currentWDom;\n      registry.domMap.set(compKey, refreshed as WDom);\n      updated = true;\n    } catch (error) {\n      console.warn(`[Lithent HMR] boundary update 실패: ${moduleId}`, error);\n    }\n  });\n\n  if ((hasMissing && !updated) || registry.pendingCtor) {\n    if (!registry.scheduled) {\n      registry.scheduled = true;\n      setTimeout(() => flushBoundary(moduleId), 0);\n    }\n  }\n};\n\nexport const createBoundary = (moduleId: string): BoundaryController => {\n  enableComponentMapManualMode();\n\n  return {\n    register: (compKey: CompKey) => registerBoundaryInstance(moduleId, compKey),\n    update: (nextCtor: TagFunction) => applyBoundaryUpdate(moduleId, nextCtor),\n    dispose: () => disposeBoundary(moduleId),\n  };\n};\n"],"names":["manualModeRefCount","enableComponentMapManualMode","setComponentMapManualMode","disableComponentMapManualMode","removeComponentEntry","compKey","disposeComponentEntry","boundaryRegistry","getRegistry","moduleId","registry","registerBoundaryInstance","entry","componentMap","currentWDom","_a","currentRegistry","disposeBoundary","applyBoundaryUpdate","nextCtor","flushBoundary","ctor","updated","hasMissing","cached","compProps","compChild","replaceWDom","refreshed","error","createBoundary"],"mappings":"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"}

package/devHelper/package.json

@@ -0,0 +1,35 @@
+{
+  "type": "module",
+  "name": "lithent-dev-helper",
+  "version": "0.21.0",
+  "description": "Lithent development helper utilities",
+  "private": true,
+  "packageManager": "pnpm@7.6.0",
+  "main": "./dist/lithentDevHelper.umd.js",
+  "module": "./dist/lithentDevHelper.mjs",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "dev": "vite",
+    "test:dev": "vitest",
+    "test": "vitest run --reporter verbose",
+    "watch": "vite build --watch",
+    "build": "vite build"
+  },
+  "author": "",
+  "repository": {
+    "type": "git",
+    "url": "https@github.com:superlucky84/lithent.git"
+  },
+  "homepage": "https://github.com/superlucky84/lithent",
+  "license": "MIT",
+  "keywords": ["lithent"],
+  "devDependencies": {
+    "lithent": "workspace:*"
+  },
+  "peerDependencies": {
+    "lithent": "workspace:*"
+  },
+  "volta": {
+    "node": "20.3.0"
+  }
+}

package/devHelper/src/componentMapControl.ts

@@ -0,0 +1,20 @@
+import type { CompKey } from 'lithent';
+import { setComponentMapManualMode, disposeComponentEntry } from 'lithent';
+
+let manualModeRefCount = 0;
+
+export const enableComponentMapManualMode = (): void => {
+  manualModeRefCount += 1;
+  setComponentMapManualMode(true);
+};
+
+export const disableComponentMapManualMode = (): void => {
+  manualModeRefCount = Math.max(0, manualModeRefCount - 1);
+  if (manualModeRefCount === 0) {
+    setComponentMapManualMode(false);
+  }
+};
+
+export const removeComponentEntry = (compKey: CompKey): void => {
+  disposeComponentEntry(compKey);
+};

package/devHelper/src/createBoundary.ts

@@ -0,0 +1,160 @@
+import type { CompKey, TagFunction, WDom } from 'lithent';
+import { componentMap, replaceWDom } from 'lithent';
+import {
+  disableComponentMapManualMode,
+  enableComponentMapManualMode,
+  removeComponentEntry,
+} from './componentMapControl';
+
+type InstanceRegistry = {
+  instances: Set<CompKey>;
+  domMap: Map<CompKey, WDom>;
+  scheduled: boolean;
+  pendingCtor?: TagFunction;
+};
+
+const boundaryRegistry = new Map<string, InstanceRegistry>();
+
+const getRegistry = (moduleId: string): InstanceRegistry => {
+  let registry = boundaryRegistry.get(moduleId);
+
+  if (!registry) {
+    registry = {
+      instances: new Set(),
+      domMap: new Map(),
+      scheduled: false,
+      pendingCtor: undefined,
+    };
+    boundaryRegistry.set(moduleId, registry);
+  }
+
+  return registry;
+};
+
+export type BoundaryController = {
+  register: (compKey: CompKey) => () => void;
+  update: (nextCtor: TagFunction) => boolean;
+  dispose: () => void;
+};
+
+export const registerBoundaryInstance = (
+  moduleId: string,
+  compKey: CompKey
+) => {
+  const registry = getRegistry(moduleId);
+
+  registry.instances.add(compKey);
+
+  queueMicrotask(() => {
+    const entry = componentMap.get(compKey);
+    const currentWDom = entry?.vd?.value ?? null;
+
+    if (currentWDom) {
+      registry.domMap.set(compKey, currentWDom);
+    }
+  });
+
+  return () => {
+    const currentRegistry = boundaryRegistry.get(moduleId);
+    if (!currentRegistry) return;
+
+    currentRegistry.instances.delete(compKey);
+    currentRegistry.domMap.delete(compKey);
+
+    if (!currentRegistry.instances.size) {
+      boundaryRegistry.delete(moduleId);
+    }
+  };
+};
+
+export const disposeBoundary = (moduleId: string) => {
+  const registry = boundaryRegistry.get(moduleId);
+
+  if (registry) {
+    Array.from(registry.instances).forEach(compKey =>
+      removeComponentEntry(compKey)
+    );
+  }
+
+  boundaryRegistry.delete(moduleId);
+  disableComponentMapManualMode();
+};
+
+export const applyBoundaryUpdate = (
+  moduleId: string,
+  nextCtor: TagFunction
+) => {
+  const registry = boundaryRegistry.get(moduleId);
+
+  if (!registry) return false;
+
+  registry.pendingCtor = nextCtor;
+
+  if (!registry.scheduled) {
+    registry.scheduled = true;
+    queueMicrotask(() => flushBoundary(moduleId));
+  }
+
+  return true;
+};
+
+const flushBoundary = (moduleId: string) => {
+  const registry = boundaryRegistry.get(moduleId);
+  if (!registry) return;
+
+  registry.scheduled = false;
+
+  const ctor = registry.pendingCtor;
+  if (!ctor) {
+    return;
+  }
+
+  registry.pendingCtor = undefined;
+
+  let updated = false;
+  let hasMissing = false;
+
+  registry.instances.forEach(compKey => {
+    const entry = componentMap.get(compKey);
+    const cached = registry.domMap.get(compKey);
+    const currentWDom = entry?.vd?.value || cached;
+
+    if (!currentWDom || !currentWDom.el) {
+      hasMissing = true;
+      return;
+    }
+
+    const { compProps, compChild } = currentWDom;
+
+    if (!compProps || !compChild) {
+      hasMissing = true;
+      return;
+    }
+
+    try {
+      replaceWDom(ctor, compProps, compChild, currentWDom as any);
+      const refreshed = componentMap.get(compKey)?.vd?.value || currentWDom;
+      registry.domMap.set(compKey, refreshed as WDom);
+      updated = true;
+    } catch (error) {
+      console.warn(`[Lithent HMR] boundary update 실패: ${moduleId}`, error);
+    }
+  });
+
+  if ((hasMissing && !updated) || registry.pendingCtor) {
+    if (!registry.scheduled) {
+      registry.scheduled = true;
+      setTimeout(() => flushBoundary(moduleId), 0);
+    }
+  }
+};
+
+export const createBoundary = (moduleId: string): BoundaryController => {
+  enableComponentMapManualMode();
+
+  return {
+    register: (compKey: CompKey) => registerBoundaryInstance(moduleId, compKey),
+    update: (nextCtor: TagFunction) => applyBoundaryUpdate(moduleId, nextCtor),
+    dispose: () => disposeBoundary(moduleId),
+  };
+};

package/devHelper/src/index.ts

@@ -0,0 +1,2 @@
+export { createBoundary } from './createBoundary';
+export type { BoundaryController } from './createBoundary';