lithent 1.19.1 → 1.20.0

package/README.md

@@ -92,14 +92,14 @@ pnpm add lithent
 
 #### Or Use CDN
 
-* UMD : https://cdn.jsdelivr.net/npm/lithent@1.19.1/dist/lithent.umd.js
-* UMD-HELPER: https://cdn.jsdelivr.net/npm/lithent@1.19.1/helper/dist/lithentHelper.umd.js
-* UMD-FTAGS: https://cdn.jsdelivr.net/npm/lithent@1.19.1/ftags/dist/lithentFTags.umd.js
-* UMD-TAG: https://cdn.jsdelivr.net/npm/lithent@1.19.1/tag/dist/lithentTag.umd.js
-* ESM : https://cdn.jsdelivr.net/npm/lithent@1.19.1/dist/lithent.mjs
-* ESM-HELPER: https://cdn.jsdelivr.net/npm/lithent@1.19.1/helper/dist/lithentHelper.mjs
-* ESM-FTAGS: https://cdn.jsdelivr.net/npm/lithent@1.19.1/ftags/dist/lithentFTags.mjs
-* ESM-TAG: https://cdn.jsdelivr.net/npm/lithent@1.19.1/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.
@@ -124,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.19.1/dist/lithent.umd.js"></script>
-<script src="https://cdn.jsdelivr.net/npm/lithent@1.19.1/helper/dist/lithentHelper.umd.js"></script>
-<script src="https://cdn.jsdelivr.net/npm/lithent@1.19.1/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;
@@ -199,10 +199,10 @@ const destroy = render(lTag`<${Component} />`, document.getElementById('root'),
 #### With UMD
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/lithent@1.19.1/dist/lithent.umd.js"></script>
-<!--script src="https://cdn.jsdelivr.net/npm/lithent@1.19.1/helper/dist/lithentHelper.umd.js"></script-->
-<script src="https://cdn.jsdelivr.net/npm/lithent@1.19.1/tag/dist/lithentTag.umd.js"></script>
-<!--script src="https://cdn.jsdelivr.net/npm/lithent@1.19.1/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>
 

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';