mirage-engine 0.2.5 → 0.2.6

package/README.md

@@ -3,9 +3,11 @@
 > **An engine that mirrors HTML DOM elements to a WebGL scene in real-time.**
 
 [![npm version](https://img.shields.io/npm/v/mirage-engine.svg?style=flat-square)](https://www.npmjs.com/package/mirage-engine)
+[![NPM Downloads](https://img.shields.io/npm/dm/mirage-engine.svg)](https://www.npmjs.org/package/mirage-engine)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg?style=flat-square)](https://www.typescriptlang.org/)
 
+
 MirageEngine directly mirrors HTML DOM elements to WebGL objects. It observes DOM mutations and synchronizes position, style, and content in real-time, allowing standard HTML elements to exist within a WebGL context.
 
 ## Installation
@@ -19,8 +21,11 @@ npm install mirage-engine
 ```ts
 import { Mirage } from 'mirage-engine';
 
-const engine = new Mirage("#target");
-engine.start();
+const target = document.querySelector("#target") as HTMLElement;
+
+const mirage = new Mirage(target);
+
+mirage.start();
 ```
 
 **License | MIT © dltldn333**

package/dist/mirage-engine.js

@@ -1,268 +1,297 @@
-var v = Object.defineProperty;
-var D = (n, e, t) => e in n ? v(n, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : n[e] = t;
-var o = (n, e, t) => (D(n, typeof e != "symbol" ? e + "" : e, t), t);
-import * as m from "three";
-const T = 0, y = 1, x = 2, M = 4, S = 8, C = 16;
-function F(n, e, t) {
-  const i = e.split(`
-`), r = [];
-  return i.forEach((s) => {
-    const g = s.split(" ");
-    let l = g[0];
-    for (let p = 1; p < g.length; p++) {
-      const a = g[p];
-      n.measureText(l + " " + a).width < t ? l += " " + a : (r.push(l), l = a);
+var L = Object.defineProperty;
+var z = (r, t, e) => t in r ? L(r, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : r[t] = e;
+var a = (r, t, e) => (z(r, typeof t != "symbol" ? t + "" : t, e), e);
+import * as g from "three";
+const x = 0, R = 1, v = 2, I = 4, C = 8, S = 16;
+function N(r, t, e) {
+  const i = t.split(`
+`), s = [];
+  return i.forEach((n) => {
+    const o = n.split(" ");
+    let c = o[0];
+    for (let d = 1; d < o.length; d++) {
+      const l = o[d];
+      r.measureText(c + " " + l).width < e ? c += " " + l : (s.push(c), c = l);
     }
-    r.push(l);
-  }), r;
+    s.push(c);
+  }), s;
 }
-function N(n, e, t, i) {
-  const r = document.createElement("canvas"), s = r.getContext("2d");
-  if (!s)
+function X(r, t, e, i, s = 2) {
+  const n = document.createElement("canvas"), o = n.getContext("2d");
+  if (!o)
     throw new Error("[Mirage] Failed to create canvas context");
-  const g = 2, l = (window.devicePixelRatio || 2) * g;
-  r.width = t * l, r.height = i * l, s.scale(l, l), s.font = e.font, s.fillStyle = e.color, s.textBaseline = "top", s.globalAlpha = 1;
-  const p = F(s, n, t), a = e.lineHeight;
-  p.forEach((h, u) => {
-    const f = u * a + 2;
-    let d = 0;
-    e.textAlign === "center" ? d = t / 2 : e.textAlign === "right" && (d = t), s.textAlign = e.textAlign, s.fillText(h, d, f);
+  const d = (window.devicePixelRatio || 1) * s;
+  n.width = e * d, n.height = i * d, o.scale(d, d), o.font = t.font, o.fillStyle = t.color, o.textBaseline = "top", o.globalAlpha = 1;
+  const l = N(o, r, e), f = t.lineHeight;
+  l.forEach((y, u) => {
+    const p = u * f + 2;
+    let m = 0;
+    t.textAlign === "center" ? m = e / 2 : t.textAlign === "right" && (m = e), o.textAlign = t.textAlign, o.fillText(y, m, p);
   });
-  const c = new m.CanvasTexture(r);
-  return c.colorSpace = m.SRGBColorSpace, c.minFilter = m.LinearFilter, c.magFilter = m.LinearFilter, c.needsUpdate = !0, c;
+  const h = new g.CanvasTexture(n);
+  return h.colorSpace = g.SRGBColorSpace, h.minFilter = g.LinearFilter, h.magFilter = g.LinearFilter, h.needsUpdate = !0, h;
 }
-class L {
-  constructor() {
-    o(this, "canvas");
-    o(this, "scene");
-    o(this, "camera");
-    o(this, "renderer");
-    o(this, "renderOrder", 0);
-    o(this, "meshMap", /* @__PURE__ */ new Map());
-    this.canvas = document.createElement("canvas"), this.scene = new m.Scene();
-    const e = window.innerWidth, t = window.innerHeight;
-    this.camera = new m.OrthographicCamera(
-      e / -2,
-      e / 2,
-      t / 2,
-      t / -2,
+class _ {
+  constructor(t, e, i) {
+    a(this, "canvas");
+    a(this, "scene");
+    a(this, "camera");
+    a(this, "renderer");
+    a(this, "renderOrder", 0);
+    a(this, "textQualityFactor", 2);
+    a(this, "mode", "overlay");
+    a(this, "customZIndex", "9999");
+    a(this, "target");
+    a(this, "mountContainer");
+    a(this, "targetRect");
+    a(this, "meshMap", /* @__PURE__ */ new Map());
+    var o;
+    this.target = t, this.mountContainer = i, this.mode = e.mode ?? "overlay", (o = e.style) != null && o.zIndex && (this.customZIndex = e.style.zIndex), this.canvas = document.createElement("canvas"), this.scene = new g.Scene(), this.targetRect = this.target.getBoundingClientRect();
+    const s = this.targetRect.width, n = this.targetRect.height;
+    this.camera = new g.OrthographicCamera(
+      s / -2,
+      s / 2,
+      n / 2,
+      n / -2,
       1,
       1e3
-    ), this.camera.position.z = 100, this.renderer = new m.WebGLRenderer({
+    ), this.camera.position.z = 100, this.renderer = new g.WebGLRenderer({
       canvas: this.canvas,
-      alpha: !0
-    }), this.renderer.setPixelRatio(window.devicePixelRatio), this.renderer.setSize(e, t);
+      alpha: !0,
+      antialias: !0
+    }), this.renderer.setPixelRatio(window.devicePixelRatio), this.renderer.setSize(s, n), this.applyTextQuality(e.textQuality ?? "medium");
   }
-  mount(e) {
-    e.appendChild(this.canvas);
+  applyTextQuality(t) {
+    if (typeof t == "number") {
+      this.textQualityFactor = Math.max(0.1, t);
+      return;
+    }
+    switch (t) {
+      case "low":
+        this.textQualityFactor = 1;
+        break;
+      case "high":
+        this.textQualityFactor = 4;
+        break;
+      case "medium":
+      default:
+        this.textQualityFactor = 2;
+        break;
+    }
+  }
+  mount() {
+    this.mountContainer.appendChild(this.canvas), this.canvas.style.zIndex = this.customZIndex, this.canvas.style.pointerEvents = this.mode === "overlay" ? "none" : "auto", this.updateCanvasLayout();
+  }
+  updateCanvasLayout() {
+    this.canvas.style.width = `${this.targetRect.width}px`, this.canvas.style.height = `${this.targetRect.height}px`, this.mode === "duplicate" ? (this.canvas.style.position = "", this.canvas.style.top = "", this.canvas.style.left = "", this.canvas.style.display = "block") : (this.canvas.style.position = "absolute", this.canvas.style.top = `${this.target.offsetTop}px`, this.canvas.style.left = `${this.target.offsetLeft}px`, this.canvas.style.display = "block");
   }
   dispose() {
-    try {
-      this.renderer.dispose();
-    } catch {
-    }
-    this.canvas.parentElement && this.canvas.parentElement.removeChild(this.canvas);
+    this.renderer.dispose(), this.canvas.remove();
   }
-  setSize(e, t) {
-    this.renderer.setSize(e, t), this.camera.left = e / -2, this.camera.right = e / 2, this.camera.top = t / 2, this.camera.bottom = t / -2, this.camera.updateProjectionMatrix();
+  setSize(t, e) {
+    this.renderer.setSize(t, e), this.camera.left = t / -2, this.camera.right = t / 2, this.camera.top = e / 2, this.camera.bottom = e / -2, this.camera.updateProjectionMatrix();
   }
-  syncScene(e) {
-    this.renderOrder = 0;
-    const t = /* @__PURE__ */ new Set();
-    this.reconcileNode(e, t);
-    for (const [i, r] of this.meshMap.entries())
-      t.has(i) || (this.scene.remove(r), r.geometry.dispose(), r.material instanceof m.Material && r.material.dispose(), this.meshMap.delete(i));
+  syncScene(t) {
+    const e = this.target.getBoundingClientRect(), i = Math.abs(e.width - this.targetRect.width) > 0.1 || Math.abs(e.height - this.targetRect.height) > 0.1, s = this.mode === "overlay" && (Math.abs(e.top - this.targetRect.top) > 0.1 || Math.abs(e.left - this.targetRect.left) > 0.1);
+    i ? (this.targetRect = e, this.renderer.setSize(this.targetRect.width, this.targetRect.height), this.camera.left = this.targetRect.width / -2, this.camera.right = this.targetRect.width / 2, this.camera.top = this.targetRect.height / 2, this.camera.bottom = this.targetRect.height / -2, this.camera.updateProjectionMatrix(), this.updateCanvasLayout()) : s ? (this.targetRect = e, this.updateCanvasLayout()) : this.targetRect = e, this.renderOrder = 0;
+    const n = /* @__PURE__ */ new Set();
+    this.reconcileNode(t, n);
+    for (const [o, c] of this.meshMap.entries())
+      n.has(o) || (this.scene.remove(c), c.geometry.dispose(), c.material instanceof g.Material && c.material.dispose(), this.meshMap.delete(o));
   }
-  reconcileNode(e, t) {
-    t.add(e.element);
-    let i = this.meshMap.get(e.element);
+  reconcileNode(t, e) {
+    e.add(t.element);
+    let i = this.meshMap.get(t.element);
     if (!i) {
-      const r = new m.PlaneGeometry(1, 1), s = new m.MeshBasicMaterial({ transparent: !0 });
-      i = new m.Mesh(r, s), e.type === "TEXT" && (i.name = "BG_MESH"), this.scene.add(i), this.meshMap.set(e.element, i);
+      const s = new g.PlaneGeometry(1, 1), n = new g.MeshBasicMaterial({ transparent: !0 });
+      i = new g.Mesh(s, n), t.type === "TEXT" && (i.name = "BG_MESH"), this.scene.add(i), this.meshMap.set(t.element, i);
     }
-    if (i.userData.domRect = e.rect, this.updateMeshProperties(i, e), e.type === "BOX")
-      for (const r of e.children)
-        this.reconcileNode(r, t);
+    if (i.userData.domRect = t.rect, this.updateMeshProperties(i, t), t.type === "BOX")
+      for (const s of t.children)
+        this.reconcileNode(s, e);
     else
-      e.type === "TEXT" && this.reconcileTextChild(i, e);
+      t.type === "TEXT" && this.reconcileTextChild(i, t);
   }
-  reconcileTextChild(e, t) {
-    var l, p;
-    let i = e.children.find(
-      (a) => a.name === "TEXT_CHILD"
+  reconcileTextChild(t, e) {
+    var c, d;
+    let i = t.children.find(
+      (l) => l.name === "TEXT_CHILD"
     );
-    const r = JSON.stringify(t.textStyles), s = (l = i == null ? void 0 : i.userData) == null ? void 0 : l.styleHash;
-    if (!i || t.dirtyMask & C || r !== s) {
-      i && ((p = i.material.map) == null || p.dispose(), i.geometry.dispose(), e.remove(i));
-      const a = N(
-        t.textContent || "",
-        t.textStyles,
-        t.rect.width,
-        t.rect.height
-      ), c = new m.PlaneGeometry(1, 1), h = new m.MeshBasicMaterial({
-        map: a,
+    const s = JSON.stringify(e.textStyles), n = (c = i == null ? void 0 : i.userData) == null ? void 0 : c.styleHash;
+    if (!i || e.dirtyMask & S || s !== n) {
+      i && ((d = i.material.map) == null || d.dispose(), i.geometry.dispose(), t.remove(i));
+      const l = X(
+        e.textContent || "",
+        e.textStyles,
+        e.rect.width,
+        e.rect.height,
+        this.textQualityFactor
+      ), f = new g.PlaneGeometry(1, 1), h = new g.MeshBasicMaterial({
+        map: l,
         transparent: !0,
-        side: m.FrontSide,
+        side: g.FrontSide,
         color: 16777215
       });
-      i = new m.Mesh(c, h), i.name = "TEXT_CHILD", i.userData = { styleHash: r }, e.add(i);
+      i = new g.Mesh(f, h), i.name = "TEXT_CHILD", i.userData = { styleHash: s }, t.add(i);
     }
     if (i) {
-      const a = e.userData.domRect, c = a.x + a.width / 2, h = a.y + a.height / 2, u = t.rect.x + t.rect.width / 2, f = t.rect.y + t.rect.height / 2, d = u - c, w = -(f - h);
-      i.position.set(d, w, 5e-3);
+      const l = t.userData.domRect, f = l.x + l.width / 2, h = l.y + l.height / 2, y = e.rect.x + e.rect.width / 2, u = e.rect.y + e.rect.height / 2, p = y - f, m = -(u - h);
+      i.position.set(p, m, 5e-3);
     }
   }
-  updateMeshProperties(e, t) {
-    const { rect: i, styles: r } = t, s = this.renderer.getPixelRatio(), g = this.renderer.domElement.width / s, l = this.renderer.domElement.height / s;
-    e.scale.set(i.width, i.height, 1);
-    const p = 1e-3;
-    this.renderOrder++, e.position.set(
-      i.x - g / 2 + i.width / 2,
-      -i.y + l / 2 - i.height / 2,
-      r.zIndex + this.renderOrder * p
+  updateMeshProperties(t, e) {
+    const { rect: i, styles: s } = e, n = this.renderer.getPixelRatio(), o = this.renderer.domElement.width / n, c = this.renderer.domElement.height / n;
+    t.scale.set(i.width, i.height, 1);
+    const d = 1e-3;
+    this.renderOrder++;
+    const l = this.targetRect.left + window.scrollX, f = this.targetRect.top + window.scrollY, h = i.x - l, y = i.y - f;
+    t.position.set(
+      h - o / 2 + i.width / 2,
+      -y + c / 2 - i.height / 2,
+      s.zIndex + this.renderOrder * d
     );
-    const a = e.material, c = r.backgroundColor;
-    let h = c, u = 1;
-    if (c === "transparent" || c === "rgba(0, 0, 0, 0)")
-      h = "#ffffff", u = 0;
-    else if (c.startsWith("rgba")) {
-      const d = c.match(/[\d.]+/g);
-      if (d && d.length >= 4) {
-        const w = d[0], R = d[1], E = d[2];
-        u = parseFloat(d[3]), h = `rgb(${w}, ${R}, ${E})`;
+    const u = t.material, p = s.backgroundColor;
+    let m = p, T = 1;
+    if (p === "transparent" || p === "rgba(0, 0, 0, 0)")
+      m = "#ffffff", T = 0;
+    else if (p.startsWith("rgba")) {
+      const w = p.match(/[\d.]+/g);
+      if (w && w.length >= 4) {
+        const M = w[0], D = w[1], F = w[2];
+        T = parseFloat(w[3]), m = `rgb(${M}, ${D}, ${F})`;
       }
     }
-    const f = r.opacity * u;
-    a.color.set(h), a.opacity = f, a.transparent = f < 1;
+    const b = s.opacity * T;
+    u.color.set(m), u.opacity = b, u.transparent = b < 1;
   }
   render() {
     this.renderer.render(this.scene, this.camera);
   }
 }
-function z(n) {
-  const e = document.createRange();
-  e.selectNodeContents(n);
-  const t = e.getBoundingClientRect();
+function k(r) {
+  const t = document.createRange();
+  t.selectNodeContents(r);
+  const e = t.getBoundingClientRect();
   return {
-    left: t.left,
-    top: t.top,
-    width: t.width,
-    height: t.height
+    left: e.left,
+    top: e.top,
+    width: e.width,
+    height: e.height
   };
 }
-function I(n) {
-  const e = parseFloat(n.fontSize);
-  let t = parseFloat(n.lineHeight);
-  isNaN(t) && (t = e * 1.2);
-  let i = parseFloat(n.letterSpacing);
+function O(r) {
+  const t = parseFloat(r.fontSize);
+  let e = parseFloat(r.lineHeight);
+  isNaN(e) && (e = t * 1.2);
+  let i = parseFloat(r.letterSpacing);
   return isNaN(i) && (i = 0), {
-    font: `${n.fontStyle} ${n.fontWeight} ${n.fontSize} ${n.fontFamily}`,
-    color: n.color,
-    textAlign: n.textAlign || "start",
+    font: `${r.fontStyle} ${r.fontWeight} ${r.fontSize} ${r.fontFamily}`,
+    color: r.color,
+    textAlign: r.textAlign || "start",
     textBaseline: "alphabetic",
-    direction: n.direction || "inherit",
-    lineHeight: t,
+    direction: r.direction || "inherit",
+    lineHeight: e,
     letterSpacing: i
   };
 }
-function b(n, e = y | x | M | C | S) {
-  if (n.nodeType === Node.TEXT_NODE) {
-    const h = n;
+function E(r, t = R | v | I | S | C) {
+  if (r.nodeType === Node.TEXT_NODE) {
+    const h = r;
     if (!h.textContent || !h.textContent.trim())
       return null;
-    const u = h.textContent.replace(/\s+/g, " ").trim();
-    if (u.length === 0)
+    const y = h.textContent.replace(/\s+/g, " ").trim();
+    if (y.length === 0)
       return null;
-    const f = z(h);
-    if (f.width === 0 || f.height === 0)
+    const u = k(h);
+    if (u.width === 0 || u.height === 0)
       return null;
-    const d = h.parentElement, w = d ? window.getComputedStyle(d) : null;
-    return w ? {
+    const p = h.parentElement, m = p ? window.getComputedStyle(p) : null;
+    return m ? {
       id: Math.random().toString(36).substring(2, 9),
       type: "TEXT",
       element: h,
       rect: {
-        x: f.left + window.scrollX,
-        y: f.top + window.scrollY,
-        width: f.width,
-        height: f.height
+        x: u.left + window.scrollX,
+        y: u.top + window.scrollY,
+        width: u.width,
+        height: u.height
       },
       styles: {
         backgroundColor: "transparent",
-        opacity: parseFloat(w.opacity),
+        opacity: parseFloat(m.opacity),
         zIndex: 0,
         borderRadius: "0px",
         borderColor: "transparent",
         borderWidth: "0px"
       },
-      textContent: u,
-      textStyles: I(w),
-      dirtyMask: e,
+      textContent: y,
+      textStyles: O(m),
+      dirtyMask: t,
       children: []
     } : null;
   }
-  const t = n, i = t.getBoundingClientRect(), r = window.getComputedStyle(t);
-  if (i.width === 0 || i.height === 0 || r.display === "none")
+  const e = r, i = e.getBoundingClientRect(), s = window.getComputedStyle(e);
+  if (i.width === 0 || i.height === 0 || s.display === "none")
     return null;
-  let s = t.getAttribute("data-mid");
-  s || (s = Math.random().toString(36).substring(2, 11), t.setAttribute("data-mid", s));
-  const g = parseInt(r.zIndex), l = {
-    backgroundColor: r.backgroundColor,
-    opacity: parseFloat(r.opacity),
-    zIndex: isNaN(g) ? 0 : g,
-    borderRadius: r.borderRadius,
-    borderColor: r.borderColor,
-    borderWidth: r.borderWidth
+  let n = e.getAttribute("data-mid");
+  n || (n = Math.random().toString(36).substring(2, 11), e.setAttribute("data-mid", n));
+  const o = parseInt(s.zIndex), c = {
+    backgroundColor: s.backgroundColor,
+    opacity: parseFloat(s.opacity),
+    zIndex: isNaN(o) ? 0 : o,
+    borderRadius: s.borderRadius,
+    borderColor: s.borderColor,
+    borderWidth: s.borderWidth
   };
-  let p, a;
-  const c = [];
-  return Array.from(t.childNodes).forEach((h) => {
-    const u = b(h, e);
-    u && c.push(u);
+  let d, l;
+  const f = [];
+  return Array.from(e.childNodes).forEach((h) => {
+    const y = E(h, t);
+    y && f.push(y);
   }), {
-    id: s,
+    id: n,
     type: "BOX",
-    element: t,
+    element: e,
     rect: {
       x: i.left + window.scrollX,
       y: i.top + window.scrollY,
       width: i.width,
       height: i.height
     },
-    styles: l,
-    textContent: p,
-    textStyles: a,
-    dirtyMask: e,
-    children: c
+    styles: c,
+    textContent: d,
+    textStyles: l,
+    dirtyMask: t,
+    children: f
   };
 }
-class H {
-  constructor(e, t) {
-    o(this, "target");
-    o(this, "renderer");
-    o(this, "observer");
-    o(this, "isDomDirty", !1);
-    o(this, "isRunning", !1);
-    o(this, "pendingMask", T);
-    o(this, "mutationTimer", null);
-    o(this, "cssTimer", null);
-    o(this, "onTransitionFinished", (e) => {
-      this.target.contains(e.target) && this.mutationTimer === null && (this.cssTimer && clearTimeout(this.cssTimer), this.pendingMask |= y | x, this.cssTimer = window.setTimeout(() => {
+class Y {
+  constructor(t, e) {
+    a(this, "target");
+    a(this, "renderer");
+    a(this, "observer");
+    a(this, "isDomDirty", !1);
+    a(this, "isRunning", !1);
+    a(this, "pendingMask", x);
+    a(this, "mutationTimer", null);
+    a(this, "cssTimer", null);
+    a(this, "onTransitionFinished", (t) => {
+      this.target.contains(t.target) && this.mutationTimer === null && (this.cssTimer && clearTimeout(this.cssTimer), this.pendingMask |= R | v, this.cssTimer = window.setTimeout(() => {
         this.isDomDirty = !0, this.cssTimer = null;
       }, 50));
     });
-    o(this, "onWindowResize", () => {
+    a(this, "onWindowResize", () => {
       this.renderer.setSize(window.innerWidth, window.innerHeight), this.isDomDirty = !0;
     });
-    o(this, "renderLoop", () => {
+    a(this, "renderLoop", () => {
       this.isRunning && (this.isDomDirty && this.forceUpdateScene(), this.renderer.render(), requestAnimationFrame(this.renderLoop));
     });
-    this.target = e, this.renderer = t, this.observer = new MutationObserver((i) => {
-      let r = T;
-      for (const s of i)
-        s.type === "childList" ? r |= S : s.type === "attributes" && (s.attributeName === "style" || s.attributeName === "class") && (r |= y | x);
-      if (r !== T) {
-        if (this.pendingMask |= r, r & S) {
+    this.target = t, this.renderer = e, this.observer = new MutationObserver((i) => {
+      let s = x;
+      for (const n of i)
+        n.type === "childList" ? s |= C : n.type === "attributes" && (n.attributeName === "style" || n.attributeName === "class") && (s |= R | v);
+      if (s !== x) {
+        if (this.pendingMask |= s, s & C) {
           this.clearTimers(), console.log("Structural Change detected"), this.isDomDirty = !0;
           return;
         }
@@ -288,27 +317,51 @@ class H {
   }
   forceUpdateScene() {
     this.isDomDirty = !1;
-    const e = b(this.target, this.pendingMask);
-    e && this.renderer.syncScene(e), this.pendingMask = T;
+    const t = E(this.target, this.pendingMask);
+    t && this.renderer.syncScene(t), this.pendingMask = x;
   }
 }
-class X {
-  constructor(e) {
-    o(this, "renderer");
-    o(this, "syncer");
-    o(this, "target");
-    const t = document.querySelector(e);
-    if (!t)
-      throw new Error(`[Mirage] Element not found: ${e}`);
-    this.target = t, this.renderer = new L(), this.renderer.mount(document.body), this.syncer = new H(this.target, this.renderer);
+class H {
+  constructor(t, e) {
+    a(this, "renderer");
+    a(this, "syncer");
+    a(this, "target");
+    this.target = t;
+    let i;
+    if (e.mode === "duplicate" ? i = e.container ?? this.target.parentElement ?? void 0 : i = this.target.parentElement ?? void 0, !i)
+      throw new Error("[Mirage] Cannot find a container (parent or option).");
+    this.renderer = new _(this.target, e, i), this.renderer.mount(), this.syncer = new Y(this.target, this.renderer);
   }
   start() {
     this.syncer.start();
   }
   stop() {
+    this.syncer.stop();
+  }
+  dispose() {
     this.syncer.stop(), this.renderer.dispose();
   }
 }
+class P {
+  constructor(t, e = {}) {
+    a(this, "_engine");
+    if (!t)
+      throw new Error("[Mirage] Target element is required.");
+    this._engine = new H(t, e);
+  }
+  start() {
+    this._engine.start();
+  }
+  stop() {
+    this._engine.stop();
+  }
+  /**
+   * 엔진 종료 및 메모리 해제
+   */
+  destroy() {
+    this._engine.dispose();
+  }
+}
 export {
-  X as Mirage
+  P as Mirage
 };

package/dist/mirage-engine.umd.js

@@ -1,2 +1,2 @@
-(function(m,f){typeof exports=="object"&&typeof module<"u"?f(exports,require("three")):typeof define=="function"&&define.amd?define(["exports","three"],f):(m=typeof globalThis<"u"?globalThis:m||self,f(m.MirageEngine={},m.THREE))})(this,function(m,f){"use strict";var X=Object.defineProperty;var k=(m,f,y)=>f in m?X(m,f,{enumerable:!0,configurable:!0,writable:!0,value:y}):m[f]=y;var o=(m,f,y)=>(k(m,typeof f!="symbol"?f+"":f,y),y);function y(n){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(n){for(const t in n)if(t!=="default"){const i=Object.getOwnPropertyDescriptor(n,t);Object.defineProperty(e,t,i.get?i:{enumerable:!0,get:()=>n[t]})}}return e.default=n,Object.freeze(e)}const d=y(f),S=0,b=1,C=2,D=4,E=8,R=16;function M(n,e,t){const i=e.split(`
-`),r=[];return i.forEach(s=>{const T=s.split(" ");let l=T[0];for(let w=1;w<T.length;w++){const a=T[w];n.measureText(l+" "+a).width<t?l+=" "+a:(r.push(l),l=a)}r.push(l)}),r}function F(n,e,t,i){const r=document.createElement("canvas"),s=r.getContext("2d");if(!s)throw new Error("[Mirage] Failed to create canvas context");const T=2,l=(window.devicePixelRatio||2)*T;r.width=t*l,r.height=i*l,s.scale(l,l),s.font=e.font,s.fillStyle=e.color,s.textBaseline="top",s.globalAlpha=1;const w=M(s,n,t),a=e.lineHeight;w.forEach((h,p)=>{const g=p*a+2;let u=0;e.textAlign==="center"?u=t/2:e.textAlign==="right"&&(u=t),s.textAlign=e.textAlign,s.fillText(h,u,g)});const c=new d.CanvasTexture(r);return c.colorSpace=d.SRGBColorSpace,c.minFilter=d.LinearFilter,c.magFilter=d.LinearFilter,c.needsUpdate=!0,c}class N{constructor(){o(this,"canvas");o(this,"scene");o(this,"camera");o(this,"renderer");o(this,"renderOrder",0);o(this,"meshMap",new Map);this.canvas=document.createElement("canvas"),this.scene=new d.Scene;const e=window.innerWidth,t=window.innerHeight;this.camera=new d.OrthographicCamera(e/-2,e/2,t/2,t/-2,1,1e3),this.camera.position.z=100,this.renderer=new d.WebGLRenderer({canvas:this.canvas,alpha:!0}),this.renderer.setPixelRatio(window.devicePixelRatio),this.renderer.setSize(e,t)}mount(e){e.appendChild(this.canvas)}dispose(){try{this.renderer.dispose()}catch{}this.canvas.parentElement&&this.canvas.parentElement.removeChild(this.canvas)}setSize(e,t){this.renderer.setSize(e,t),this.camera.left=e/-2,this.camera.right=e/2,this.camera.top=t/2,this.camera.bottom=t/-2,this.camera.updateProjectionMatrix()}syncScene(e){this.renderOrder=0;const t=new Set;this.reconcileNode(e,t);for(const[i,r]of this.meshMap.entries())t.has(i)||(this.scene.remove(r),r.geometry.dispose(),r.material instanceof d.Material&&r.material.dispose(),this.meshMap.delete(i))}reconcileNode(e,t){t.add(e.element);let i=this.meshMap.get(e.element);if(!i){const r=new d.PlaneGeometry(1,1),s=new d.MeshBasicMaterial({transparent:!0});i=new d.Mesh(r,s),e.type==="TEXT"&&(i.name="BG_MESH"),this.scene.add(i),this.meshMap.set(e.element,i)}if(i.userData.domRect=e.rect,this.updateMeshProperties(i,e),e.type==="BOX")for(const r of e.children)this.reconcileNode(r,t);else e.type==="TEXT"&&this.reconcileTextChild(i,e)}reconcileTextChild(e,t){var l,w;let i=e.children.find(a=>a.name==="TEXT_CHILD");const r=JSON.stringify(t.textStyles),s=(l=i==null?void 0:i.userData)==null?void 0:l.styleHash;if(!i||t.dirtyMask&R||r!==s){i&&((w=i.material.map)==null||w.dispose(),i.geometry.dispose(),e.remove(i));const a=F(t.textContent||"",t.textStyles,t.rect.width,t.rect.height),c=new d.PlaneGeometry(1,1),h=new d.MeshBasicMaterial({map:a,transparent:!0,side:d.FrontSide,color:16777215});i=new d.Mesh(c,h),i.name="TEXT_CHILD",i.userData={styleHash:r},e.add(i)}if(i){const a=e.userData.domRect,c=a.x+a.width/2,h=a.y+a.height/2,p=t.rect.x+t.rect.width/2,g=t.rect.y+t.rect.height/2,u=p-c,x=-(g-h);i.position.set(u,x,.005)}}updateMeshProperties(e,t){const{rect:i,styles:r}=t,s=this.renderer.getPixelRatio(),T=this.renderer.domElement.width/s,l=this.renderer.domElement.height/s;e.scale.set(i.width,i.height,1);const w=.001;this.renderOrder++,e.position.set(i.x-T/2+i.width/2,-i.y+l/2-i.height/2,r.zIndex+this.renderOrder*w);const a=e.material,c=r.backgroundColor;let h=c,p=1;if(c==="transparent"||c==="rgba(0, 0, 0, 0)")h="#ffffff",p=0;else if(c.startsWith("rgba")){const u=c.match(/[\d.]+/g);if(u&&u.length>=4){const x=u[0],I=u[1],_=u[2];p=parseFloat(u[3]),h=`rgb(${x}, ${I}, ${_})`}}const g=r.opacity*p;a.color.set(h),a.opacity=g,a.transparent=g<1}render(){this.renderer.render(this.scene,this.camera)}}function O(n){const e=document.createRange();e.selectNodeContents(n);const t=e.getBoundingClientRect();return{left:t.left,top:t.top,width:t.width,height:t.height}}function z(n){const e=parseFloat(n.fontSize);let t=parseFloat(n.lineHeight);isNaN(t)&&(t=e*1.2);let i=parseFloat(n.letterSpacing);return isNaN(i)&&(i=0),{font:`${n.fontStyle} ${n.fontWeight} ${n.fontSize} ${n.fontFamily}`,color:n.color,textAlign:n.textAlign||"start",textBaseline:"alphabetic",direction:n.direction||"inherit",lineHeight:t,letterSpacing:i}}function v(n,e=b|C|D|R|E){if(n.nodeType===Node.TEXT_NODE){const h=n;if(!h.textContent||!h.textContent.trim())return null;const p=h.textContent.replace(/\s+/g," ").trim();if(p.length===0)return null;const g=O(h);if(g.width===0||g.height===0)return null;const u=h.parentElement,x=u?window.getComputedStyle(u):null;return x?{id:Math.random().toString(36).substring(2,9),type:"TEXT",element:h,rect:{x:g.left+window.scrollX,y:g.top+window.scrollY,width:g.width,height:g.height},styles:{backgroundColor:"transparent",opacity:parseFloat(x.opacity),zIndex:0,borderRadius:"0px",borderColor:"transparent",borderWidth:"0px"},textContent:p,textStyles:z(x),dirtyMask:e,children:[]}:null}const t=n,i=t.getBoundingClientRect(),r=window.getComputedStyle(t);if(i.width===0||i.height===0||r.display==="none")return null;let s=t.getAttribute("data-mid");s||(s=Math.random().toString(36).substring(2,11),t.setAttribute("data-mid",s));const T=parseInt(r.zIndex),l={backgroundColor:r.backgroundColor,opacity:parseFloat(r.opacity),zIndex:isNaN(T)?0:T,borderRadius:r.borderRadius,borderColor:r.borderColor,borderWidth:r.borderWidth};let w,a;const c=[];return Array.from(t.childNodes).forEach(h=>{const p=v(h,e);p&&c.push(p)}),{id:s,type:"BOX",element:t,rect:{x:i.left+window.scrollX,y:i.top+window.scrollY,width:i.width,height:i.height},styles:l,textContent:w,textStyles:a,dirtyMask:e,children:c}}class L{constructor(e,t){o(this,"target");o(this,"renderer");o(this,"observer");o(this,"isDomDirty",!1);o(this,"isRunning",!1);o(this,"pendingMask",S);o(this,"mutationTimer",null);o(this,"cssTimer",null);o(this,"onTransitionFinished",e=>{this.target.contains(e.target)&&this.mutationTimer===null&&(this.cssTimer&&clearTimeout(this.cssTimer),this.pendingMask|=b|C,this.cssTimer=window.setTimeout(()=>{this.isDomDirty=!0,this.cssTimer=null},50))});o(this,"onWindowResize",()=>{this.renderer.setSize(window.innerWidth,window.innerHeight),this.isDomDirty=!0});o(this,"renderLoop",()=>{this.isRunning&&(this.isDomDirty&&this.forceUpdateScene(),this.renderer.render(),requestAnimationFrame(this.renderLoop))});this.target=e,this.renderer=t,this.observer=new MutationObserver(i=>{let r=S;for(const s of i)s.type==="childList"?r|=E:s.type==="attributes"&&(s.attributeName==="style"||s.attributeName==="class")&&(r|=b|C);if(r!==S){if(this.pendingMask|=r,r&E){this.clearTimers(),console.log("Structural Change detected"),this.isDomDirty=!0;return}this.mutationTimer&&clearTimeout(this.mutationTimer),this.mutationTimer=window.setTimeout(()=>{this.mutationTimer=null,this.isDomDirty=!0},200)}})}start(){this.isRunning||(this.isRunning=!0,this.observer.observe(this.target,{childList:!0,subtree:!0,attributes:!0,characterData:!0}),this.target.addEventListener("transitionend",this.onTransitionFinished),this.target.addEventListener("animationend",this.onTransitionFinished),window.addEventListener("resize",this.onWindowResize),this.forceUpdateScene(),this.renderLoop())}stop(){this.isRunning=!1,this.observer.disconnect(),this.clearTimers(),this.target.removeEventListener("transitionend",this.onTransitionFinished),this.target.removeEventListener("animationend",this.onTransitionFinished),window.removeEventListener("resize",this.onWindowResize)}clearTimers(){this.mutationTimer&&(clearTimeout(this.mutationTimer),this.mutationTimer=null),this.cssTimer&&(clearTimeout(this.cssTimer),this.cssTimer=null)}forceUpdateScene(){this.isDomDirty=!1;const e=v(this.target,this.pendingMask);e&&this.renderer.syncScene(e),this.pendingMask=S}}class H{constructor(e){o(this,"renderer");o(this,"syncer");o(this,"target");const t=document.querySelector(e);if(!t)throw new Error(`[Mirage] Element not found: ${e}`);this.target=t,this.renderer=new N,this.renderer.mount(document.body),this.syncer=new L(this.target,this.renderer)}start(){this.syncer.start()}stop(){this.syncer.stop(),this.renderer.dispose()}}m.Mirage=H,Object.defineProperty(m,Symbol.toStringTag,{value:"Module"})});
+(function(m,p){typeof exports=="object"&&typeof module<"u"?p(exports,require("three")):typeof define=="function"&&define.amd?define(["exports","three"],p):(m=typeof globalThis<"u"?globalThis:m||self,p(m.MirageEngine={},m.THREE))})(this,function(m,p){"use strict";var A=Object.defineProperty;var $=(m,p,T)=>p in m?A(m,p,{enumerable:!0,configurable:!0,writable:!0,value:T}):m[p]=T;var a=(m,p,T)=>($(m,typeof p!="symbol"?p+"":p,T),T);function T(r){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(r){for(const t in r)if(t!=="default"){const i=Object.getOwnPropertyDescriptor(r,t);Object.defineProperty(e,t,i.get?i:{enumerable:!0,get:()=>r[t]})}}return e.default=r,Object.freeze(e)}const d=T(p),v=0,b=1,C=2,z=4,S=8,M=16;function L(r,e,t){const i=e.split(`
+`),s=[];return i.forEach(n=>{const o=n.split(" ");let h=o[0];for(let u=1;u<o.length;u++){const l=o[u];r.measureText(h+" "+l).width<t?h+=" "+l:(s.push(h),h=l)}s.push(h)}),s}function N(r,e,t,i,s=2){const n=document.createElement("canvas"),o=n.getContext("2d");if(!o)throw new Error("[Mirage] Failed to create canvas context");const u=(window.devicePixelRatio||1)*s;n.width=t*u,n.height=i*u,o.scale(u,u),o.font=e.font,o.fillStyle=e.color,o.textBaseline="top",o.globalAlpha=1;const l=L(o,r,t),w=e.lineHeight;l.forEach((x,g)=>{const y=g*w+2;let f=0;e.textAlign==="center"?f=t/2:e.textAlign==="right"&&(f=t),o.textAlign=e.textAlign,o.fillText(x,f,y)});const c=new d.CanvasTexture(n);return c.colorSpace=d.SRGBColorSpace,c.minFilter=d.LinearFilter,c.magFilter=d.LinearFilter,c.needsUpdate=!0,c}class I{constructor(e,t,i){a(this,"canvas");a(this,"scene");a(this,"camera");a(this,"renderer");a(this,"renderOrder",0);a(this,"textQualityFactor",2);a(this,"mode","overlay");a(this,"customZIndex","9999");a(this,"target");a(this,"mountContainer");a(this,"targetRect");a(this,"meshMap",new Map);var o;this.target=e,this.mountContainer=i,this.mode=t.mode??"overlay",(o=t.style)!=null&&o.zIndex&&(this.customZIndex=t.style.zIndex),this.canvas=document.createElement("canvas"),this.scene=new d.Scene,this.targetRect=this.target.getBoundingClientRect();const s=this.targetRect.width,n=this.targetRect.height;this.camera=new d.OrthographicCamera(s/-2,s/2,n/2,n/-2,1,1e3),this.camera.position.z=100,this.renderer=new d.WebGLRenderer({canvas:this.canvas,alpha:!0,antialias:!0}),this.renderer.setPixelRatio(window.devicePixelRatio),this.renderer.setSize(s,n),this.applyTextQuality(t.textQuality??"medium")}applyTextQuality(e){if(typeof e=="number"){this.textQualityFactor=Math.max(.1,e);return}switch(e){case"low":this.textQualityFactor=1;break;case"high":this.textQualityFactor=4;break;case"medium":default:this.textQualityFactor=2;break}}mount(){this.mountContainer.appendChild(this.canvas),this.canvas.style.zIndex=this.customZIndex,this.canvas.style.pointerEvents=this.mode==="overlay"?"none":"auto",this.updateCanvasLayout()}updateCanvasLayout(){this.canvas.style.width=`${this.targetRect.width}px`,this.canvas.style.height=`${this.targetRect.height}px`,this.mode==="duplicate"?(this.canvas.style.position="",this.canvas.style.top="",this.canvas.style.left="",this.canvas.style.display="block"):(this.canvas.style.position="absolute",this.canvas.style.top=`${this.target.offsetTop}px`,this.canvas.style.left=`${this.target.offsetLeft}px`,this.canvas.style.display="block")}dispose(){this.renderer.dispose(),this.canvas.remove()}setSize(e,t){this.renderer.setSize(e,t),this.camera.left=e/-2,this.camera.right=e/2,this.camera.top=t/2,this.camera.bottom=t/-2,this.camera.updateProjectionMatrix()}syncScene(e){const t=this.target.getBoundingClientRect(),i=Math.abs(t.width-this.targetRect.width)>.1||Math.abs(t.height-this.targetRect.height)>.1,s=this.mode==="overlay"&&(Math.abs(t.top-this.targetRect.top)>.1||Math.abs(t.left-this.targetRect.left)>.1);i?(this.targetRect=t,this.renderer.setSize(this.targetRect.width,this.targetRect.height),this.camera.left=this.targetRect.width/-2,this.camera.right=this.targetRect.width/2,this.camera.top=this.targetRect.height/2,this.camera.bottom=this.targetRect.height/-2,this.camera.updateProjectionMatrix(),this.updateCanvasLayout()):s?(this.targetRect=t,this.updateCanvasLayout()):this.targetRect=t,this.renderOrder=0;const n=new Set;this.reconcileNode(e,n);for(const[o,h]of this.meshMap.entries())n.has(o)||(this.scene.remove(h),h.geometry.dispose(),h.material instanceof d.Material&&h.material.dispose(),this.meshMap.delete(o))}reconcileNode(e,t){t.add(e.element);let i=this.meshMap.get(e.element);if(!i){const s=new d.PlaneGeometry(1,1),n=new d.MeshBasicMaterial({transparent:!0});i=new d.Mesh(s,n),e.type==="TEXT"&&(i.name="BG_MESH"),this.scene.add(i),this.meshMap.set(e.element,i)}if(i.userData.domRect=e.rect,this.updateMeshProperties(i,e),e.type==="BOX")for(const s of e.children)this.reconcileNode(s,t);else e.type==="TEXT"&&this.reconcileTextChild(i,e)}reconcileTextChild(e,t){var h,u;let i=e.children.find(l=>l.name==="TEXT_CHILD");const s=JSON.stringify(t.textStyles),n=(h=i==null?void 0:i.userData)==null?void 0:h.styleHash;if(!i||t.dirtyMask&M||s!==n){i&&((u=i.material.map)==null||u.dispose(),i.geometry.dispose(),e.remove(i));const l=N(t.textContent||"",t.textStyles,t.rect.width,t.rect.height,this.textQualityFactor),w=new d.PlaneGeometry(1,1),c=new d.MeshBasicMaterial({map:l,transparent:!0,side:d.FrontSide,color:16777215});i=new d.Mesh(w,c),i.name="TEXT_CHILD",i.userData={styleHash:s},e.add(i)}if(i){const l=e.userData.domRect,w=l.x+l.width/2,c=l.y+l.height/2,x=t.rect.x+t.rect.width/2,g=t.rect.y+t.rect.height/2,y=x-w,f=-(g-c);i.position.set(y,f,.005)}}updateMeshProperties(e,t){const{rect:i,styles:s}=t,n=this.renderer.getPixelRatio(),o=this.renderer.domElement.width/n,h=this.renderer.domElement.height/n;e.scale.set(i.width,i.height,1);const u=.001;this.renderOrder++;const l=this.targetRect.left+window.scrollX,w=this.targetRect.top+window.scrollY,c=i.x-l,x=i.y-w;e.position.set(c-o/2+i.width/2,-x+h/2-i.height/2,s.zIndex+this.renderOrder*u);const g=e.material,y=s.backgroundColor;let f=y,E=1;if(y==="transparent"||y==="rgba(0, 0, 0, 0)")f="#ffffff",E=0;else if(y.startsWith("rgba")){const R=y.match(/[\d.]+/g);if(R&&R.length>=4){const P=R[0],Y=R[1],B=R[2];E=parseFloat(R[3]),f=`rgb(${P}, ${Y}, ${B})`}}const F=s.opacity*E;g.color.set(f),g.opacity=F,g.transparent=F<1}render(){this.renderer.render(this.scene,this.camera)}}function O(r){const e=document.createRange();e.selectNodeContents(r);const t=e.getBoundingClientRect();return{left:t.left,top:t.top,width:t.width,height:t.height}}function _(r){const e=parseFloat(r.fontSize);let t=parseFloat(r.lineHeight);isNaN(t)&&(t=e*1.2);let i=parseFloat(r.letterSpacing);return isNaN(i)&&(i=0),{font:`${r.fontStyle} ${r.fontWeight} ${r.fontSize} ${r.fontFamily}`,color:r.color,textAlign:r.textAlign||"start",textBaseline:"alphabetic",direction:r.direction||"inherit",lineHeight:t,letterSpacing:i}}function D(r,e=b|C|z|M|S){if(r.nodeType===Node.TEXT_NODE){const c=r;if(!c.textContent||!c.textContent.trim())return null;const x=c.textContent.replace(/\s+/g," ").trim();if(x.length===0)return null;const g=O(c);if(g.width===0||g.height===0)return null;const y=c.parentElement,f=y?window.getComputedStyle(y):null;return f?{id:Math.random().toString(36).substring(2,9),type:"TEXT",element:c,rect:{x:g.left+window.scrollX,y:g.top+window.scrollY,width:g.width,height:g.height},styles:{backgroundColor:"transparent",opacity:parseFloat(f.opacity),zIndex:0,borderRadius:"0px",borderColor:"transparent",borderWidth:"0px"},textContent:x,textStyles:_(f),dirtyMask:e,children:[]}:null}const t=r,i=t.getBoundingClientRect(),s=window.getComputedStyle(t);if(i.width===0||i.height===0||s.display==="none")return null;let n=t.getAttribute("data-mid");n||(n=Math.random().toString(36).substring(2,11),t.setAttribute("data-mid",n));const o=parseInt(s.zIndex),h={backgroundColor:s.backgroundColor,opacity:parseFloat(s.opacity),zIndex:isNaN(o)?0:o,borderRadius:s.borderRadius,borderColor:s.borderColor,borderWidth:s.borderWidth};let u,l;const w=[];return Array.from(t.childNodes).forEach(c=>{const x=D(c,e);x&&w.push(x)}),{id:n,type:"BOX",element:t,rect:{x:i.left+window.scrollX,y:i.top+window.scrollY,width:i.width,height:i.height},styles:h,textContent:u,textStyles:l,dirtyMask:e,children:w}}class k{constructor(e,t){a(this,"target");a(this,"renderer");a(this,"observer");a(this,"isDomDirty",!1);a(this,"isRunning",!1);a(this,"pendingMask",v);a(this,"mutationTimer",null);a(this,"cssTimer",null);a(this,"onTransitionFinished",e=>{this.target.contains(e.target)&&this.mutationTimer===null&&(this.cssTimer&&clearTimeout(this.cssTimer),this.pendingMask|=b|C,this.cssTimer=window.setTimeout(()=>{this.isDomDirty=!0,this.cssTimer=null},50))});a(this,"onWindowResize",()=>{this.renderer.setSize(window.innerWidth,window.innerHeight),this.isDomDirty=!0});a(this,"renderLoop",()=>{this.isRunning&&(this.isDomDirty&&this.forceUpdateScene(),this.renderer.render(),requestAnimationFrame(this.renderLoop))});this.target=e,this.renderer=t,this.observer=new MutationObserver(i=>{let s=v;for(const n of i)n.type==="childList"?s|=S:n.type==="attributes"&&(n.attributeName==="style"||n.attributeName==="class")&&(s|=b|C);if(s!==v){if(this.pendingMask|=s,s&S){this.clearTimers(),console.log("Structural Change detected"),this.isDomDirty=!0;return}this.mutationTimer&&clearTimeout(this.mutationTimer),this.mutationTimer=window.setTimeout(()=>{this.mutationTimer=null,this.isDomDirty=!0},200)}})}start(){this.isRunning||(this.isRunning=!0,this.observer.observe(this.target,{childList:!0,subtree:!0,attributes:!0,characterData:!0}),this.target.addEventListener("transitionend",this.onTransitionFinished),this.target.addEventListener("animationend",this.onTransitionFinished),window.addEventListener("resize",this.onWindowResize),this.forceUpdateScene(),this.renderLoop())}stop(){this.isRunning=!1,this.observer.disconnect(),this.clearTimers(),this.target.removeEventListener("transitionend",this.onTransitionFinished),this.target.removeEventListener("animationend",this.onTransitionFinished),window.removeEventListener("resize",this.onWindowResize)}clearTimers(){this.mutationTimer&&(clearTimeout(this.mutationTimer),this.mutationTimer=null),this.cssTimer&&(clearTimeout(this.cssTimer),this.cssTimer=null)}forceUpdateScene(){this.isDomDirty=!1;const e=D(this.target,this.pendingMask);e&&this.renderer.syncScene(e),this.pendingMask=v}}class X{constructor(e,t){a(this,"renderer");a(this,"syncer");a(this,"target");this.target=e;let i;if(t.mode==="duplicate"?i=t.container??this.target.parentElement??void 0:i=this.target.parentElement??void 0,!i)throw new Error("[Mirage] Cannot find a container (parent or option).");this.renderer=new I(this.target,t,i),this.renderer.mount(),this.syncer=new k(this.target,this.renderer)}start(){this.syncer.start()}stop(){this.syncer.stop()}dispose(){this.syncer.stop(),this.renderer.dispose()}}class H{constructor(e,t={}){a(this,"_engine");if(!e)throw new Error("[Mirage] Target element is required.");this._engine=new X(e,t)}start(){this._engine.start()}stop(){this._engine.stop()}destroy(){this._engine.dispose()}}m.Mirage=H,Object.defineProperty(m,Symbol.toStringTag,{value:"Module"})});

package/dist/src/core/Engine.d.ts

@@ -0,0 +1,10 @@
+import { MirageConfig } from '../types';
+export declare class Engine {
+    private renderer;
+    private syncer;
+    private target;
+    constructor(target: HTMLElement, config: MirageConfig);
+    start(): void;
+    stop(): void;
+    dispose(): void;
+}

package/dist/src/core/Mirage.d.ts

@@ -1,8 +1,11 @@
+import { MirageConfig } from '../types';
 export declare class Mirage {
-    private renderer;
-    private syncer;
-    private target;
-    constructor(selector: string);
+    private _engine;
+    constructor(element: HTMLElement, config?: MirageConfig);
     start(): void;
     stop(): void;
+    /**
+     * 엔진 종료 및 메모리 해제
+     */
+    destroy(): void;
 }

package/dist/src/renderer/Renderer.d.ts

@@ -1,13 +1,21 @@
-import { SceneNode } from '../types';
+import { SceneNode, MirageConfig } from '../types';
 export declare class Renderer {
     readonly canvas: HTMLCanvasElement;
     private readonly scene;
     private readonly camera;
     private readonly renderer;
     private renderOrder;
+    private textQualityFactor;
+    private mode;
+    private customZIndex;
+    private target;
+    private mountContainer;
+    private targetRect;
     private meshMap;
-    constructor();
-    mount(parent: HTMLElement): void;
+    constructor(target: HTMLElement, config: MirageConfig, mountContainer: HTMLElement);
+    private applyTextQuality;
+    mount(): void;
+    private updateCanvasLayout;
     dispose(): void;
     setSize(width: number, height: number): void;
     syncScene(graphNode: SceneNode): void;

package/dist/src/renderer/utils/TextGenerator.d.ts

@@ -0,0 +1,3 @@
+import { TextStyles } from '../../types';
+import * as THREE from "three";
+export declare function createTextTexture(text: string, styles: TextStyles, rectWidth: number, rectHeight: number, qualityFactor?: number): THREE.CanvasTexture;

package/dist/src/types/common.d.ts

@@ -0,0 +1,35 @@
+export type NodeType = "BOX" | "TEXT";
+export interface NodeRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface BoxStyles {
+    backgroundColor: string;
+    opacity: number;
+    zIndex: number;
+    borderRadius: string;
+    borderColor: string;
+    borderWidth: string;
+}
+export interface TextStyles {
+    font: string;
+    color: string;
+    textAlign: CanvasTextAlign;
+    textBaseline: CanvasTextBaseline;
+    direction: CanvasDirection;
+    lineHeight: number;
+    letterSpacing: number;
+}
+export interface SceneNode {
+    id: string;
+    type: NodeType;
+    element: HTMLElement;
+    rect: NodeRect;
+    styles: BoxStyles;
+    textContent?: string;
+    textStyles?: TextStyles;
+    dirtyMask: number;
+    children: SceneNode[];
+}

package/dist/src/types/config.d.ts

@@ -0,0 +1,18 @@
+export type TextQuality = "low" | "medium" | "high" | number;
+export type MirageMode = "overlay" | "duplicate";
+interface BaseConfig {
+    debug?: boolean;
+    textQuality?: TextQuality;
+    style?: {
+        zIndex?: string;
+    };
+}
+export interface OverlayConfig extends BaseConfig {
+    mode?: "overlay";
+}
+export interface DuplicateConfig extends BaseConfig {
+    mode: "duplicate";
+    container?: HTMLElement;
+}
+export type MirageConfig = OverlayConfig | DuplicateConfig;
+export {};

package/dist/src/types/flags.d.ts

@@ -0,0 +1,6 @@
+export declare const DIRTY_NONE = 0;
+export declare const DIRTY_RECT: number;
+export declare const DIRTY_STYLE: number;
+export declare const DIRTY_ZINDEX: number;
+export declare const DIRTY_STRUCTURE: number;
+export declare const DIRTY_CONTENT: number;

package/dist/src/types/index.d.ts

@@ -1,41 +1,3 @@
-export type NodeType = "BOX" | "TEXT";
-export interface NodeRect {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-export interface BoxStyles {
-    backgroundColor: string;
-    opacity: number;
-    zIndex: number;
-    borderRadius: string;
-    borderColor: string;
-    borderWidth: string;
-}
-export interface TextStyles {
-    font: string;
-    color: string;
-    textAlign: CanvasTextAlign;
-    textBaseline: CanvasTextBaseline;
-    direction: CanvasDirection;
-    lineHeight: number;
-    letterSpacing: number;
-}
-export interface SceneNode {
-    id: string;
-    type: NodeType;
-    element: HTMLElement;
-    rect: NodeRect;
-    styles: BoxStyles;
-    textContent?: string;
-    textStyles?: TextStyles;
-    dirtyMask: number;
-    children: SceneNode[];
-}
-export declare const DIRTY_NONE = 0;
-export declare const DIRTY_RECT: number;
-export declare const DIRTY_STYLE: number;
-export declare const DIRTY_ZINDEX: number;
-export declare const DIRTY_STRUCTURE: number;
-export declare const DIRTY_CONTENT: number;
+export * from './config';
+export * from './common';
+export * from './flags';

package/dist/src/utils/math.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Converts DOM coordinates (Top-Left 0,0) to WebGL coordinates (Center 0,0).
+ * @param x - The x coordinate of the DOM element (Left)
+ * @param y - The y coordinate of the DOM element (Top)
+ * @param width - The width of the DOM element
+ * @param height - The height of the DOM element
+ * @param canvasWidth - The total width of the canvas
+ * @param canvasHeight - The total height of the canvas
+ */
+export declare function domToWebGL(x: number, y: number, width: number, height: number, canvasWidth: number, canvasHeight: number): {
+    x: number;
+    y: number;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mirage-engine",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "An engine that mirrors HTML DOM elements to a WebGL scene in real-time.",
   "type": "module",
   "types": "./dist/index.d.ts",

package/dist/src/renderer/DomProjector.d.ts

@@ -1,4 +0,0 @@
-export declare function domToWebGL(x: number, y: number, canvasWidth: number, canvasHeight: number): {
-    x: number;
-    y: number;
-};

package/dist/src/renderer/TextTextureGenerator.d.ts

@@ -1,3 +0,0 @@
-import { TextStyles } from '../types';
-import * as THREE from "three";
-export declare function createTextTexture(text: string, styles: TextStyles, rectWidth: number, rectHeight: number): THREE.CanvasTexture;