@dooboostore/simple-web-component 1.0.55 → 1.0.56

package/README.md

@@ -1992,6 +1992,40 @@ constructor(private service: Service) { super(); }  // Web Components can't have
 
 ---
 
+## ⚡ Benchmarks
+
+Measured in real Chrome against a hand-written `innerHTML` renderer and Lit, rendering the same 1,000-row table (state in fields, a decorated method returns the HTML, `@replaceChildren*` applies it):
+
+- **Bulk rendering keeps up with Lit.** Creating 10,000 rows takes 244 ms, versus 232 ms for Lit and 222 ms for a hand-written `innerHTML` loop.
+- **Low memory.** 1,000 rows keep about 94 KB of JS heap, 6x less than Lit (558 KB); at 10,000 rows it is 1.6 MB versus 4.9 MB (3x less). Only the data is retained, no per-row template bookkeeping.
+- **Thin layer.** Rendering through the decorators costs within about 5% to 25% of the equivalent hand-written `innerHTML` code.
+
+```text
+create 10,000 rows  (lower is better)
+  vanilla (innerHTML)   ██████████████████████████        222  ▲
+  lit                   ████████████████████████████      232
+  simple-web-component  █████████████████████████████     244
+  vanilla (DOM calls)   ████████████████████████████████  269
+
+JS heap, 1,000 rows (KB)  (lower is better)
+  vanilla (innerHTML)   ████                              73.4  ▲
+  simple-web-component  █████                             93.5
+  vanilla (DOM calls)   ███████                           119
+  lit                   ████████████████████████████████  558
+```
+
+Full results, including the operations where other approaches are faster, methodology and caveats: [bench/RESULTS.md](./bench/RESULTS.md). Reproduce with `pnpm bench` inside `bench/`.
+
+---
+
+## 🧰 Editor Support (LSP)
+
+The package ships a language server for SWC templates — `npx swc-lsp --stdio`:
+tag / attribute / `@state@` / `$host.` completion, hover, go to definition, parameter hints, and type errors inside `swc-on-*`, `{{= }}` and `@x@`
+(`swc-on-click="$host.tt(4)"` → *number is not assignable to string*).
+
+Setup for IntelliJ, VS Code and Neovim: [lsp/README.md](https://github.com/dooboostore-develop/packages/tree/main/@dooboostore/simple-web-component/lsp).
+
 ## 🧪 Testing
 
 `pnpm test` type-checks the tests and runs them in a real browser (Chromium via Playwright, falling back to the installed Chrome) — no jsdom. Each test gets its own same-origin iframe window, so custom elements, `history` and `location` never leak between tests.

package/dist/esm-bundle/dooboostore-simple-web-component.esm.js

@@ -30,9 +30,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
-// ../../../node_modules/.pnpm/reflect-metadata@0.2.2/node_modules/reflect-metadata/Reflect.js
+// ../../node_modules/.pnpm/reflect-metadata@0.2.2/node_modules/reflect-metadata/Reflect.js
 var require_Reflect = __commonJS({
-  "../../../node_modules/.pnpm/reflect-metadata@0.2.2/node_modules/reflect-metadata/Reflect.js"() {
+  "../../node_modules/.pnpm/reflect-metadata@0.2.2/node_modules/reflect-metadata/Reflect.js"() {
     var Reflect2;
     (function(Reflect3) {
       (function(factory) {
@@ -21124,26 +21124,45 @@ var SimstanceManager = class _SimstanceManager {
       return registed.instance;
     }
     if (this.storage.has(targetKey) && void 0 === registed?.instance) {
-      newInstanceCarrier.depth++;
-      const newSim = this.newSim({
-        target: registed?.type ?? targetKey,
-        newInstanceCarrier,
-        simCreateAfter: (data) => {
-          if (getSim(registed?.type ?? target ?? targetKey)?.scope === Lifecycle.Singleton) {
-            this.setStoreSet(targetKey, data, target);
+      const resolving = newInstanceCarrier.resolving ?? (newInstanceCarrier.resolving = []);
+      if (resolving.includes(targetKey)) {
+        const nameOf = (t) => typeof t === "symbol" ? t.toString() : t?.name ?? String(t);
+        throw new Error(
+          `Circular dependency detected: ${[...resolving.map(nameOf), nameOf(targetKey)].join(" -> ")}`
+        );
+      }
+      resolving.push(targetKey);
+      let settled = false;
+      try {
+        newInstanceCarrier.depth++;
+        const newSim = this.newSim({
+          target: registed?.type ?? targetKey,
+          newInstanceCarrier,
+          simCreateAfter: (data) => {
+            if (getSim(registed?.type ?? target ?? targetKey)?.scope === Lifecycle.Singleton) {
+              this.setStoreSet(targetKey, data, target);
+            }
           }
-        }
-      });
-      newInstanceCarrier.depth--;
-      if (newInstanceCarrier.depth === 0) {
-        newInstanceCarrier.newInstances.forEach((it) => {
-          this.callBindPostConstruct(it);
         });
+        newInstanceCarrier.depth--;
+        resolving.pop();
+        settled = true;
+        if (newInstanceCarrier.depth === 0) {
+          newInstanceCarrier.newInstances.forEach((it) => {
+            this.callBindPostConstruct(it);
+          });
+        }
+        if (isOnSimCreate(newSim)) {
+          newSim.onSimCreate();
+        }
+        return newSim;
+      } finally {
+        if (!settled) {
+          newInstanceCarrier.depth--;
+          const idx = resolving.lastIndexOf(targetKey);
+          if (idx !== -1) resolving.splice(idx, 1);
+        }
       }
-      if (isOnSimCreate(newSim)) {
-        newSim.onSimCreate();
-      }
-      return newSim;
     }
     const simNoSuch = new SimNoSuch("SimNoSuch: no simple instance(resolve) name:" + targetKey?.prototype?.constructor?.name + "," + targetKey);
     console.error(simNoSuch);