@adaas/a-frame 0.0.21 → 0.0.23

package/dist/node/chunk-IIVYTS5M.mjs

@@ -0,0 +1,239 @@
+import { A_Component } from '@adaas/a-concept';
+
+// src/lib/A-FrameLogger/A-FrameLogger.constants.ts
+var A_FrameLogLevel = {
+  Debug: "debug",
+  Info: "info",
+  Success: "success",
+  Warn: "warn",
+  Error: "error"
+};
+var A_FRAME_LOG_LEVEL_PRIORITY = {
+  debug: 10,
+  info: 20,
+  success: 20,
+  warn: 30,
+  error: 40
+};
+var A_FrameLogIcon = {
+  debug: "\xB7",
+  info: "\u2139",
+  success: "\u2714",
+  warn: "\u26A0",
+  error: "\u2716"
+};
+var A_FRAME_ANSI = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  gray: "\x1B[90m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  cyan: "\x1B[36m"
+};
+var A_FRAME_BROWSER_CSS = {
+  debug: "color: #888;",
+  info: "color: #06b;",
+  success: "color: #2a7; font-weight: bold;",
+  warn: "color: #c80;",
+  error: "color: #c33; font-weight: bold;"
+};
+var A_FRAME_LOG_DEFAULTS = {
+  progressBarWidth: 24,
+  summaryTitle: "Summary",
+  /** Update progress at most this often (ms) for non-TTY/browser output. */
+  progressThrottleMs: 250
+};
+var A_FrameLoggerBase = class extends A_Component {
+  constructor(config = {}) {
+    super();
+    this.counters = /* @__PURE__ */ new Map();
+    this.startTime = Date.now();
+    this.level = config.level ?? "debug";
+    this.prefix = config.prefix ?? "";
+  }
+  // ─── Configuration ───────────────────────────────────────────────────────
+  setLevel(level) {
+    this.level = level;
+  }
+  /** Returns true when the entry passes the current level filter. */
+  shouldEmit(level) {
+    return A_FRAME_LOG_LEVEL_PRIORITY[level] >= A_FRAME_LOG_LEVEL_PRIORITY[this.level];
+  }
+  // ─── Level methods (shared) ──────────────────────────────────────────────
+  emit(level, message, metadata) {
+    if (!this.shouldEmit(level)) return;
+    this.write({
+      level,
+      message: this.prefix ? `${this.prefix} ${message}` : message,
+      timestamp: Date.now(),
+      metadata
+    });
+  }
+  debug(msg, meta) {
+    this.emit("debug", msg, meta);
+  }
+  info(msg, meta) {
+    this.emit("info", msg, meta);
+  }
+  success(msg, meta) {
+    this.emit("success", msg, meta);
+  }
+  warn(msg, meta) {
+    this.emit("warn", msg, meta);
+  }
+  error(msg, meta) {
+    this.emit("error", msg, meta);
+  }
+  /** Default implementation that subclasses may override for nicer headings. */
+  section(title) {
+    this.info(`\u2500\u2500 ${title} \u2500\u2500`);
+  }
+  divider() {
+    this.info("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  }
+  // ─── Counters / timing ───────────────────────────────────────────────────
+  increment(key, by = 1) {
+    this.counters.set(key, (this.counters.get(key) ?? 0) + by);
+  }
+  set(key, value) {
+    this.counters.set(key, value);
+  }
+  get(key) {
+    return this.counters.get(key) ?? 0;
+  }
+  resetTimer() {
+    this.startTime = Date.now();
+    this.counters.clear();
+  }
+  elapsed() {
+    const ms = Date.now() - this.startTime;
+    if (ms < 1e3) return `${ms}ms`;
+    const s = ms / 1e3;
+    if (s < 60) return `${s.toFixed(2)}s`;
+    const m = Math.floor(s / 60);
+    return `${m}m ${(s - m * 60).toFixed(1)}s`;
+  }
+  /**
+   * Print a left-aligned table of all counters plus elapsed time.
+   * Concrete subclasses can override for richer rendering.
+   */
+  summary(title = A_FRAME_LOG_DEFAULTS.summaryTitle) {
+    this.section(title);
+    const keys = [...this.counters.keys()];
+    const pad = keys.reduce((m, k) => Math.max(m, k.length), "elapsed".length);
+    for (const key of keys) {
+      this.info(`  ${key.padEnd(pad)}  ${this.counters.get(key)}`);
+    }
+    this.info(`  ${"elapsed".padEnd(pad)}  ${this.elapsed()}`);
+    this.divider();
+  }
+};
+
+// src/lib/A-FrameLogger/A-FrameLogger.component.env-node.ts
+var ICON_COLOR = {
+  debug: A_FRAME_ANSI.gray,
+  info: A_FRAME_ANSI.cyan,
+  success: A_FRAME_ANSI.green,
+  warn: A_FRAME_ANSI.yellow,
+  error: A_FRAME_ANSI.red
+};
+var A_FrameLogger = class extends A_FrameLoggerBase {
+  constructor(config = {}) {
+    super(config);
+    this.useColor = config.color ?? !!(process.stdout && process.stdout.isTTY);
+  }
+  c(code, str) {
+    return this.useColor ? `${code}${str}${A_FRAME_ANSI.reset}` : str;
+  }
+  write(entry) {
+    const icon = this.c(ICON_COLOR[entry.level], A_FrameLogIcon[entry.level]);
+    const line = `${icon} ${entry.message}`;
+    if (entry.level === "error") console.error(line);
+    else if (entry.level === "warn") console.warn(line);
+    else console.log(line);
+    if (entry.metadata && Object.keys(entry.metadata).length > 0) {
+      console.log(this.c(A_FRAME_ANSI.gray, `   ${JSON.stringify(entry.metadata)}`));
+    }
+  }
+  section(title) {
+    const line = "\u2500".repeat(Math.max(2, 60 - title.length - 4));
+    const heading = `\u2504 ${title} ${line}`;
+    console.log("\n" + this.c(A_FRAME_ANSI.bold + A_FRAME_ANSI.cyan, heading));
+  }
+  divider() {
+    console.log(this.c(A_FRAME_ANSI.gray, "\u2500".repeat(60)));
+  }
+  summary(title = A_FRAME_LOG_DEFAULTS.summaryTitle) {
+    this.section(title);
+    const keys = [...this.counters.keys()];
+    const pad = keys.reduce((m, k) => Math.max(m, k.length), "elapsed".length);
+    for (const key of keys) {
+      console.log(`  ${this.c(A_FRAME_ANSI.gray, key.padEnd(pad))}  ${this.c(A_FRAME_ANSI.bold, String(this.counters.get(key)))}`);
+    }
+    console.log(`  ${this.c(A_FRAME_ANSI.gray, "elapsed".padEnd(pad))}  ${this.c(A_FRAME_ANSI.bold, this.elapsed())}`);
+    this.divider();
+  }
+  // ─── Progress bar ────────────────────────────────────────────────────────
+  progress(label, total) {
+    const isTTY = this.useColor;
+    const width = A_FRAME_LOG_DEFAULTS.progressBarWidth;
+    const start = Date.now();
+    let current = 0;
+    let lastLabel = "";
+    const render = (status) => {
+      if (total === 0) {
+        if (status === "done") console.log(`${this.c(A_FRAME_ANSI.green, "\u2714")} ${label} (0/0)`);
+        return;
+      }
+      const pct = Math.min(1, current / total);
+      const filled = Math.round(pct * width);
+      if (isTTY) {
+        const bar = this.c(A_FRAME_ANSI.green, "\u2588".repeat(filled)) + this.c(A_FRAME_ANSI.gray, "\u2591".repeat(width - filled));
+        const head = status === "done" ? this.c(A_FRAME_ANSI.green, "\u2714") : status === "fail" ? this.c(A_FRAME_ANSI.red, "\u2716") : this.c(A_FRAME_ANSI.cyan, "\u27F3");
+        const tail = lastLabel ? this.c(A_FRAME_ANSI.dim, ` \u2014 ${lastLabel}`) : "";
+        process.stdout.write(`\r\x1B[2K${head} ${label} ${bar} ${current}/${total} (${(pct * 100).toFixed(0)}%)${tail}`);
+        if (status) process.stdout.write("\n");
+      } else {
+        if (status === "done") {
+          console.log(`[${label}] done ${current}/${total} in ${((Date.now() - start) / 1e3).toFixed(2)}s`);
+        } else if (status === "fail") {
+          console.log(`[${label}] FAILED at ${current}/${total}`);
+        } else {
+          const step = Math.max(1, Math.floor(total / 10));
+          if (current === total || current % step === 0) {
+            console.log(`[${label}] ${current}/${total}${lastLabel ? ` \u2014 ${lastLabel}` : ""}`);
+          }
+        }
+      }
+    };
+    render();
+    return {
+      tick: (l) => {
+        current = Math.min(total, current + 1);
+        if (l) lastLabel = l;
+        render();
+      },
+      succeed: (l) => {
+        if (l) lastLabel = l;
+        current = total;
+        render("done");
+      },
+      fail: (l) => {
+        if (l) lastLabel = l;
+        render("fail");
+      },
+      update: (n, l) => {
+        current = Math.min(total, Math.max(0, n));
+        if (l) lastLabel = l;
+        render();
+      }
+    };
+  }
+};
+
+export { A_FRAME_ANSI, A_FRAME_BROWSER_CSS, A_FRAME_LOG_DEFAULTS, A_FRAME_LOG_LEVEL_PRIORITY, A_FrameLogIcon, A_FrameLogLevel, A_FrameLogger, A_FrameLoggerBase };
+//# sourceMappingURL=chunk-IIVYTS5M.mjs.map
+//# sourceMappingURL=chunk-IIVYTS5M.mjs.map

package/dist/node/chunk-IIVYTS5M.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameLogger/A-FrameLogger.constants.ts","../../src/lib/A-FrameLogger/A-FrameLogger.component.ts","../../src/lib/A-FrameLogger/A-FrameLogger.component.env-node.ts"],"names":[],"mappings":";;;AAGO,IAAM,eAAA,GAAkB;AAAA,EAC3B,KAAA,EAAO,OAAA;AAAA,EACP,IAAA,EAAM,MAAA;AAAA,EACN,OAAA,EAAS,SAAA;AAAA,EACT,IAAA,EAAM,MAAA;AAAA,EACN,KAAA,EAAO;AACX;AAIO,IAAM,0BAAA,GAAkE;AAAA,EAC3E,KAAA,EAAO,EAAA;AAAA,EACP,IAAA,EAAM,EAAA;AAAA,EACN,OAAA,EAAS,EAAA;AAAA,EACT,IAAA,EAAM,EAAA;AAAA,EACN,KAAA,EAAO;AACX;AAIO,IAAM,cAAA,GAAsD;AAAA,EAC/D,KAAA,EAAO,MAAA;AAAA,EACP,IAAA,EAAM,QAAA;AAAA,EACN,OAAA,EAAS,QAAA;AAAA,EACT,IAAA,EAAM,QAAA;AAAA,EACN,KAAA,EAAO;AACX;AAIO,IAAM,YAAA,GAAe;AAAA,EACxB,KAAA,EAAO,SAAA;AAAA,EACP,IAAA,EAAM,SAAA;AAAA,EACN,GAAA,EAAK,SAAA;AAAA,EACL,IAAA,EAAM,UAAA;AAAA,EACN,GAAA,EAAK,UAAA;AAAA,EACL,KAAA,EAAO,UAAA;AAAA,EACP,MAAA,EAAQ,UAAA;AAAA,EACR,IAAA,EAAM,UAAA;AAAA,EACN,IAAA,EAAM;AACV;AAOO,IAAM,mBAAA,GAA2D;AAAA,EACpE,KAAA,EAAO,cAAA;AAAA,EACP,IAAA,EAAM,cAAA;AAAA,EACN,OAAA,EAAS,iCAAA;AAAA,EACT,IAAA,EAAM,cAAA;AAAA,EACN,KAAA,EAAO;AACX;AAIO,IAAM,oBAAA,GAAuB;AAAA,EAChC,gBAAA,EAAkB,EAAA;AAAA,EAClB,YAAA,EAAc,SAAA;AAAA;AAAA,EAEd,kBAAA,EAAoB;AACxB;AC5CO,IAAe,iBAAA,GAAf,cAAyC,WAAA,CAAsC;AAAA,EAOlF,WAAA,CAAY,MAAA,GAA8B,EAAC,EAAG;AAC1C,IAAA,KAAA,EAAM;AAJV,IAAA,IAAA,CAAU,QAAA,uBAAoC,GAAA,EAAI;AAClD,IAAA,IAAA,CAAU,SAAA,GAAoB,KAAK,GAAA,EAAI;AAInC,IAAA,IAAA,CAAK,KAAA,GAAQ,OAAO,KAAA,IAAS,OAAA;AAC7B,IAAA,IAAA,CAAK,MAAA,GAAS,OAAO,MAAA,IAAU,EAAA;AAAA,EACnC;AAAA;AAAA,EAYA,SAAS,KAAA,EAAkC;AACvC,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AAAA,EACjB;AAAA;AAAA,EAGU,WAAW,KAAA,EAAqC;AACtD,IAAA,OAAO,0BAAA,CAA2B,KAAK,CAAA,IAAK,0BAAA,CAA2B,KAAK,KAAK,CAAA;AAAA,EACrF;AAAA;AAAA,EAIQ,IAAA,CAAK,KAAA,EAA4B,OAAA,EAAiB,QAAA,EAA0C;AAChG,IAAA,IAAI,CAAC,IAAA,CAAK,UAAA,CAAW,KAAK,CAAA,EAAG;AAC7B,IAAA,IAAA,CAAK,KAAA,CAAM;AAAA,MACP,KAAA;AAAA,MACA,OAAA,EAAS,KAAK,MAAA,GAAS,CAAA,EAAG,KAAK,MAAM,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,GAAK,OAAA;AAAA,MACrD,SAAA,EAAW,KAAK,GAAA,EAAI;AAAA,MACpB;AAAA,KACH,CAAA;AAAA,EACL;AAAA,EAEA,KAAA,CAAM,KAAa,IAAA,EAAsC;AAAE,IAAA,IAAA,CAAK,IAAA,CAAK,OAAA,EAAS,GAAA,EAAK,IAAI,CAAA;AAAA,EAAG;AAAA,EAC1F,IAAA,CAAK,KAAa,IAAA,EAAsC;AAAE,IAAA,IAAA,CAAK,IAAA,CAAK,MAAA,EAAQ,GAAA,EAAK,IAAI,CAAA;AAAA,EAAG;AAAA,EACxF,OAAA,CAAQ,KAAa,IAAA,EAAsC;AAAE,IAAA,IAAA,CAAK,IAAA,CAAK,SAAA,EAAW,GAAA,EAAK,IAAI,CAAA;AAAA,EAAG;AAAA,EAC9F,IAAA,CAAK,KAAa,IAAA,EAAsC;AAAE,IAAA,IAAA,CAAK,IAAA,CAAK,MAAA,EAAQ,GAAA,EAAK,IAAI,CAAA;AAAA,EAAG;AAAA,EACxF,KAAA,CAAM,KAAa,IAAA,EAAsC;AAAE,IAAA,IAAA,CAAK,IAAA,CAAK,OAAA,EAAS,GAAA,EAAK,IAAI,CAAA;AAAA,EAAG;AAAA;AAAA,EAG1F,QAAQ,KAAA,EAAqB;AACzB,IAAA,IAAA,CAAK,IAAA,CAAK,CAAA,aAAA,EAAM,KAAK,CAAA,aAAA,CAAK,CAAA;AAAA,EAC9B;AAAA,EAEA,OAAA,GAAgB;AACZ,IAAA,IAAA,CAAK,KAAK,kVAA0D,CAAA;AAAA,EACxE;AAAA;AAAA,EAIA,SAAA,CAAU,GAAA,EAAa,EAAA,GAAK,CAAA,EAAS;AACjC,IAAA,IAAA,CAAK,QAAA,CAAS,IAAI,GAAA,EAAA,CAAM,IAAA,CAAK,SAAS,GAAA,CAAI,GAAG,CAAA,IAAK,CAAA,IAAK,EAAE,CAAA;AAAA,EAC7D;AAAA,EAEA,GAAA,CAAI,KAAa,KAAA,EAAqB;AAClC,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AAAA,EAChC;AAAA,EAEA,IAAI,GAAA,EAAqB;AACrB,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,GAAG,CAAA,IAAK,CAAA;AAAA,EACrC;AAAA,EAEA,UAAA,GAAmB;AACf,IAAA,IAAA,CAAK,SAAA,GAAY,KAAK,GAAA,EAAI;AAC1B,IAAA,IAAA,CAAK,SAAS,KAAA,EAAM;AAAA,EACxB;AAAA,EAEA,OAAA,GAAkB;AACd,IAAA,MAAM,EAAA,GAAK,IAAA,CAAK,GAAA,EAAI,GAAI,IAAA,CAAK,SAAA;AAC7B,IAAA,IAAI,EAAA,GAAK,GAAA,EAAM,OAAO,CAAA,EAAG,EAAE,CAAA,EAAA,CAAA;AAC3B,IAAA,MAAM,IAAI,EAAA,GAAK,GAAA;AACf,IAAA,IAAI,IAAI,EAAA,EAAI,OAAO,GAAG,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,CAAA;AAClC,IAAA,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,CAAA,GAAI,EAAE,CAAA;AAC3B,IAAA,OAAO,CAAA,EAAG,CAAC,CAAA,EAAA,EAAA,CAAM,CAAA,GAAI,IAAI,EAAA,EAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,CAAA;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAA,CAAQ,KAAA,GAAgB,oBAAA,CAAqB,YAAA,EAAoB;AAC7D,IAAA,IAAA,CAAK,QAAQ,KAAK,CAAA;AAClB,IAAA,MAAM,OAAO,CAAC,GAAG,IAAA,CAAK,QAAA,CAAS,MAAM,CAAA;AACrC,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,MAAA,CAAO,CAAC,CAAA,EAAG,CAAA,KAAM,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,CAAA,CAAE,MAAM,CAAA,EAAG,UAAU,MAAM,CAAA;AACzE,IAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACpB,MAAA,IAAA,CAAK,IAAA,CAAK,CAAA,EAAA,EAAK,GAAA,CAAI,MAAA,CAAO,GAAG,CAAC,CAAA,EAAA,EAAK,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,GAAG,CAAC,CAAA,CAAE,CAAA;AAAA,IAC/D;AACA,IAAA,IAAA,CAAK,IAAA,CAAK,CAAA,EAAA,EAAK,SAAA,CAAU,MAAA,CAAO,GAAG,CAAC,CAAA,EAAA,EAAK,IAAA,CAAK,OAAA,EAAS,CAAA,CAAE,CAAA;AACzD,IAAA,IAAA,CAAK,OAAA,EAAQ;AAAA,EACjB;AACJ;;;AC3GA,IAAM,UAAA,GAAkD;AAAA,EACpD,OAAO,YAAA,CAAa,IAAA;AAAA,EACpB,MAAM,YAAA,CAAa,IAAA;AAAA,EACnB,SAAS,YAAA,CAAa,KAAA;AAAA,EACtB,MAAM,YAAA,CAAa,MAAA;AAAA,EACnB,OAAO,YAAA,CAAa;AACxB,CAAA;AASO,IAAM,aAAA,GAAN,cAA4B,iBAAA,CAAkB;AAAA,EAIjD,WAAA,CAAY,MAAA,GAA8B,EAAC,EAAG;AAC1C,IAAA,KAAA,CAAM,MAAM,CAAA;AACZ,IAAA,IAAA,CAAK,QAAA,GAAW,OAAO,KAAA,IAAS,CAAC,EAAE,OAAA,CAAQ,MAAA,IAAU,QAAQ,MAAA,CAAO,KAAA,CAAA;AAAA,EACxE;AAAA,EAEQ,CAAA,CAAE,MAAc,GAAA,EAAqB;AACzC,IAAA,OAAO,IAAA,CAAK,WAAW,CAAA,EAAG,IAAI,GAAG,GAAG,CAAA,EAAG,YAAA,CAAa,KAAK,CAAA,CAAA,GAAK,GAAA;AAAA,EAClE;AAAA,EAEU,MAAM,KAAA,EAA8B;AAC1C,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,CAAA,CAAE,UAAA,CAAW,KAAA,CAAM,KAAK,CAAA,EAAG,cAAA,CAAe,KAAA,CAAM,KAAK,CAAC,CAAA;AACxE,IAAA,MAAM,IAAA,GAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,MAAM,OAAO,CAAA,CAAA;AACrC,IAAA,IAAI,KAAA,CAAM,KAAA,KAAU,OAAA,EAAS,OAAA,CAAQ,MAAM,IAAI,CAAA;AAAA,SAAA,IACtC,KAAA,CAAM,KAAA,KAAU,MAAA,EAAQ,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,SAC7C,OAAA,CAAQ,IAAI,IAAI,CAAA;AAErB,IAAA,IAAI,KAAA,CAAM,YAAY,MAAA,CAAO,IAAA,CAAK,MAAM,QAAQ,CAAA,CAAE,SAAS,CAAA,EAAG;AAC1D,MAAA,OAAA,CAAQ,GAAA,CAAI,IAAA,CAAK,CAAA,CAAE,YAAA,CAAa,IAAA,EAAM,CAAA,GAAA,EAAM,IAAA,CAAK,SAAA,CAAU,KAAA,CAAM,QAAQ,CAAC,CAAA,CAAE,CAAC,CAAA;AAAA,IACjF;AAAA,EACJ;AAAA,EAEA,QAAQ,KAAA,EAAqB;AACzB,IAAA,MAAM,IAAA,GAAO,QAAA,CAAI,MAAA,CAAO,IAAA,CAAK,GAAA,CAAI,GAAG,EAAA,GAAK,KAAA,CAAM,MAAA,GAAS,CAAC,CAAC,CAAA;AAC1D,IAAA,MAAM,OAAA,GAAU,CAAA,OAAA,EAAK,KAAK,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA;AAClC,IAAA,OAAA,CAAQ,GAAA,CAAI,OAAO,IAAA,CAAK,CAAA,CAAE,aAAa,IAAA,GAAO,YAAA,CAAa,IAAA,EAAM,OAAO,CAAC,CAAA;AAAA,EAC7E;AAAA,EAEA,OAAA,GAAgB;AACZ,IAAA,OAAA,CAAQ,GAAA,CAAI,KAAK,CAAA,CAAE,YAAA,CAAa,MAAM,QAAA,CAAI,MAAA,CAAO,EAAE,CAAC,CAAC,CAAA;AAAA,EACzD;AAAA,EAEA,OAAA,CAAQ,KAAA,GAAgB,oBAAA,CAAqB,YAAA,EAAoB;AAC7D,IAAA,IAAA,CAAK,QAAQ,KAAK,CAAA;AAClB,IAAA,MAAM,OAAO,CAAC,GAAG,IAAA,CAAK,QAAA,CAAS,MAAM,CAAA;AACrC,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,MAAA,CAAO,CAAC,CAAA,EAAG,CAAA,KAAM,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,CAAA,CAAE,MAAM,CAAA,EAAG,UAAU,MAAM,CAAA;AACzE,IAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACpB,MAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,EAAA,EAAK,IAAA,CAAK,CAAA,CAAE,YAAA,CAAa,MAAM,GAAA,CAAI,MAAA,CAAO,GAAG,CAAC,CAAC,CAAA,EAAA,EAAK,KAAK,CAAA,CAAE,YAAA,CAAa,IAAA,EAAM,MAAA,CAAO,IAAA,CAAK,QAAA,CAAS,IAAI,GAAG,CAAC,CAAC,CAAC,CAAA,CAAE,CAAA;AAAA,IAC/H;AACA,IAAA,OAAA,CAAQ,GAAA,CAAI,KAAK,IAAA,CAAK,CAAA,CAAE,aAAa,IAAA,EAAM,SAAA,CAAU,OAAO,GAAG,CAAC,CAAC,CAAA,EAAA,EAAK,IAAA,CAAK,EAAE,YAAA,CAAa,IAAA,EAAM,KAAK,OAAA,EAAS,CAAC,CAAA,CAAE,CAAA;AACjH,IAAA,IAAA,CAAK,OAAA,EAAQ;AAAA,EACjB;AAAA;AAAA,EAIA,QAAA,CAAS,OAAe,KAAA,EAAmC;AACvD,IAAA,MAAM,QAAQ,IAAA,CAAK,QAAA;AACnB,IAAA,MAAM,QAAQ,oBAAA,CAAqB,gBAAA;AACnC,IAAA,MAAM,KAAA,GAAQ,KAAK,GAAA,EAAI;AAEvB,IAAA,IAAI,OAAA,GAAU,CAAA;AACd,IAAA,IAAI,SAAA,GAAY,EAAA;AAEhB,IAAA,MAAM,MAAA,GAAS,CAAC,MAAA,KAA6B;AACzC,MAAA,IAAI,UAAU,CAAA,EAAG;AACb,QAAA,IAAI,MAAA,KAAW,MAAA,EAAQ,OAAA,CAAQ,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,CAAA,CAAE,YAAA,CAAa,KAAA,EAAO,QAAG,CAAC,CAAA,CAAA,EAAI,KAAK,CAAA,MAAA,CAAQ,CAAA;AACtF,QAAA;AAAA,MACJ;AACA,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,UAAU,KAAK,CAAA;AACvC,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,GAAA,GAAM,KAAK,CAAA;AAErC,MAAA,IAAI,KAAA,EAAO;AACP,QAAA,MAAM,MACF,IAAA,CAAK,CAAA,CAAE,aAAa,KAAA,EAAO,QAAA,CAAI,OAAO,MAAM,CAAC,CAAA,GAC7C,IAAA,CAAK,EAAE,YAAA,CAAa,IAAA,EAAM,SAAI,MAAA,CAAO,KAAA,GAAQ,MAAM,CAAC,CAAA;AACxD,QAAA,MAAM,IAAA,GAAO,WAAW,MAAA,GAAS,IAAA,CAAK,EAAE,YAAA,CAAa,KAAA,EAAO,QAAG,CAAA,GACzD,MAAA,KAAW,SAAS,IAAA,CAAK,CAAA,CAAE,aAAa,GAAA,EAAK,QAAG,IAC5C,IAAA,CAAK,CAAA,CAAE,YAAA,CAAa,IAAA,EAAM,QAAG,CAAA;AACvC,QAAA,MAAM,IAAA,GAAO,YAAY,IAAA,CAAK,CAAA,CAAE,aAAa,GAAA,EAAK,CAAA,QAAA,EAAM,SAAS,CAAA,CAAE,CAAA,GAAI,EAAA;AACvE,QAAA,OAAA,CAAQ,MAAA,CAAO,MAAM,CAAA,SAAA,EAAY,IAAI,IAAI,KAAK,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,EAAI,OAAO,IAAI,KAAK,CAAA,EAAA,EAAA,CAAM,MAAM,GAAA,EAAK,OAAA,CAAQ,CAAC,CAAC,CAAA,EAAA,EAAK,IAAI,CAAA,CAAE,CAAA;AAC/G,QAAA,IAAI,MAAA,EAAQ,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,IAAI,CAAA;AAAA,MACzC,CAAA,MAAO;AACH,QAAA,IAAI,WAAW,MAAA,EAAQ;AACnB,UAAA,OAAA,CAAQ,IAAI,CAAA,CAAA,EAAI,KAAK,CAAA,OAAA,EAAU,OAAO,IAAI,KAAK,CAAA,IAAA,EAAA,CAAA,CAAS,IAAA,CAAK,GAAA,KAAQ,KAAA,IAAS,GAAA,EAAM,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,QACrG,CAAA,MAAA,IAAW,WAAW,MAAA,EAAQ;AAC1B,UAAA,OAAA,CAAQ,IAAI,CAAA,CAAA,EAAI,KAAK,eAAe,OAAO,CAAA,CAAA,EAAI,KAAK,CAAA,CAAE,CAAA;AAAA,QAC1D,CAAA,MAAO;AAEH,UAAA,MAAM,IAAA,GAAO,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,KAAA,CAAM,KAAA,GAAQ,EAAE,CAAC,CAAA;AAC/C,UAAA,IAAI,OAAA,KAAY,KAAA,IAAS,OAAA,GAAU,IAAA,KAAS,CAAA,EAAG;AAC3C,YAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,CAAA,EAAI,KAAK,CAAA,EAAA,EAAK,OAAO,CAAA,CAAA,EAAI,KAAK,CAAA,EAAG,SAAA,GAAY,CAAA,QAAA,EAAM,SAAS,CAAA,CAAA,GAAK,EAAE,CAAA,CAAE,CAAA;AAAA,UACrF;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ,CAAA;AAEA,IAAA,MAAA,EAAO;AAEP,IAAA,OAAO;AAAA,MACH,IAAA,EAAM,CAAC,CAAA,KAAe;AAAE,QAAA,OAAA,GAAU,IAAA,CAAK,GAAA,CAAI,KAAA,EAAO,OAAA,GAAU,CAAC,CAAA;AAAG,QAAA,IAAI,GAAG,SAAA,GAAY,CAAA;AAAG,QAAA,MAAA,EAAO;AAAA,MAAG,CAAA;AAAA,MAChG,OAAA,EAAS,CAAC,CAAA,KAAe;AAAE,QAAA,IAAI,GAAG,SAAA,GAAY,CAAA;AAAG,QAAA,OAAA,GAAU,KAAA;AAAO,QAAA,MAAA,CAAO,MAAM,CAAA;AAAA,MAAG,CAAA;AAAA,MAClF,IAAA,EAAM,CAAC,CAAA,KAAe;AAAE,QAAA,IAAI,GAAG,SAAA,GAAY,CAAA;AAAG,QAAA,MAAA,CAAO,MAAM,CAAA;AAAA,MAAG,CAAA;AAAA,MAC9D,MAAA,EAAQ,CAAC,CAAA,EAAW,CAAA,KAAe;AAAE,QAAA,OAAA,GAAU,KAAK,GAAA,CAAI,KAAA,EAAO,KAAK,GAAA,CAAI,CAAA,EAAG,CAAC,CAAC,CAAA;AAAG,QAAA,IAAI,GAAG,SAAA,GAAY,CAAA;AAAG,QAAA,MAAA,EAAO;AAAA,MAAG;AAAA,KACpH;AAAA,EACJ;AACJ","file":"chunk-IIVYTS5M.mjs","sourcesContent":["import { A_FrameLogLevelType } from \"./A-FrameLogger.types\";\n\n\nexport const A_FrameLogLevel = {\n    Debug: 'debug',\n    Info: 'info',\n    Success: 'success',\n    Warn: 'warn',\n    Error: 'error',\n} as const satisfies Record<string, A_FrameLogLevelType>;\n\n\n/** Numeric priority used for level filtering. Higher = more severe. */\nexport const A_FRAME_LOG_LEVEL_PRIORITY: Record<A_FrameLogLevelType, number> = {\n    debug: 10,\n    info: 20,\n    success: 20,\n    warn: 30,\n    error: 40,\n};\n\n\n/** Glyphs used as the leading symbol for each log level. */\nexport const A_FrameLogIcon: Record<A_FrameLogLevelType, string> = {\n    debug: '·',\n    info: 'ℹ',\n    success: '✔',\n    warn: '⚠',\n    error: '✖',\n};\n\n\n/** ANSI escape sequences. Used by the Node implementation only. */\nexport const A_FRAME_ANSI = {\n    reset: '\\x1b[0m',\n    bold: '\\x1b[1m',\n    dim: '\\x1b[2m',\n    gray: '\\x1b[90m',\n    red: '\\x1b[31m',\n    green: '\\x1b[32m',\n    yellow: '\\x1b[33m',\n    blue: '\\x1b[34m',\n    cyan: '\\x1b[36m',\n} as const;\n\n\n/**\n * Browser console CSS — used with `console.log('%c...', style)` for coloured\n * output in DevTools. Mirrors the ANSI palette by intent.\n */\nexport const A_FRAME_BROWSER_CSS: Record<A_FrameLogLevelType, string> = {\n    debug: 'color: #888;',\n    info: 'color: #06b;',\n    success: 'color: #2a7; font-weight: bold;',\n    warn: 'color: #c80;',\n    error: 'color: #c33; font-weight: bold;',\n};\n\n\n/** Defaults applied when building a logger without explicit options. */\nexport const A_FRAME_LOG_DEFAULTS = {\n    progressBarWidth: 24,\n    summaryTitle: 'Summary',\n    /** Update progress at most this often (ms) for non-TTY/browser output. */\n    progressThrottleMs: 250,\n} as const;\n","import { A_Component } from \"@adaas/a-concept\";\nimport {\n    A_FrameLogEntry,\n    A_FrameLogLevelType,\n    A_FrameLoggerConfig,\n    A_FrameProgressBar,\n    IA_FrameLogger,\n} from \"./A-FrameLogger.types\";\nimport {\n    A_FRAME_LOG_LEVEL_PRIORITY,\n    A_FRAME_LOG_DEFAULTS,\n} from \"./A-FrameLogger.constants\";\n\n\n/**\n * Abstract base for `A_FrameLogger` — environment-agnostic state and behaviour.\n *\n * Concrete subclasses (`A-FrameLogger.component.env-node` and\n * `A-FrameLogger.component.env-browser`) implement `write()` and `progress()`\n * since each runtime renders to a different surface (TTY vs DevTools console).\n */\nexport abstract class A_FrameLoggerBase extends A_Component implements IA_FrameLogger {\n\n    protected level: A_FrameLogLevelType;\n    protected prefix: string;\n    protected counters: Map<string, number> = new Map();\n    protected startTime: number = Date.now();\n\n    constructor(config: A_FrameLoggerConfig = {}) {\n        super();\n        this.level = config.level ?? 'debug';\n        this.prefix = config.prefix ?? '';\n    }\n\n    // ─── Subclass hooks ──────────────────────────────────────────────────────\n\n    /** Render a fully-built log entry to the runtime-specific output. */\n    protected abstract write(entry: A_FrameLogEntry): void;\n\n    /** Create a runtime-specific progress bar. */\n    abstract progress(label: string, total: number): A_FrameProgressBar;\n\n    // ─── Configuration ───────────────────────────────────────────────────────\n\n    setLevel(level: A_FrameLogLevelType): void {\n        this.level = level;\n    }\n\n    /** Returns true when the entry passes the current level filter. */\n    protected shouldEmit(level: A_FrameLogLevelType): boolean {\n        return A_FRAME_LOG_LEVEL_PRIORITY[level] >= A_FRAME_LOG_LEVEL_PRIORITY[this.level];\n    }\n\n    // ─── Level methods (shared) ──────────────────────────────────────────────\n\n    private emit(level: A_FrameLogLevelType, message: string, metadata?: Record<string, unknown>): void {\n        if (!this.shouldEmit(level)) return;\n        this.write({\n            level,\n            message: this.prefix ? `${this.prefix} ${message}` : message,\n            timestamp: Date.now(),\n            metadata,\n        });\n    }\n\n    debug(msg: string, meta?: Record<string, unknown>): void { this.emit('debug', msg, meta); }\n    info(msg: string, meta?: Record<string, unknown>): void { this.emit('info', msg, meta); }\n    success(msg: string, meta?: Record<string, unknown>): void { this.emit('success', msg, meta); }\n    warn(msg: string, meta?: Record<string, unknown>): void { this.emit('warn', msg, meta); }\n    error(msg: string, meta?: Record<string, unknown>): void { this.emit('error', msg, meta); }\n\n    /** Default implementation that subclasses may override for nicer headings. */\n    section(title: string): void {\n        this.info(`── ${title} ──`);\n    }\n\n    divider(): void {\n        this.info('────────────────────────────────────────────────────────');\n    }\n\n    // ─── Counters / timing ───────────────────────────────────────────────────\n\n    increment(key: string, by = 1): void {\n        this.counters.set(key, (this.counters.get(key) ?? 0) + by);\n    }\n\n    set(key: string, value: number): void {\n        this.counters.set(key, value);\n    }\n\n    get(key: string): number {\n        return this.counters.get(key) ?? 0;\n    }\n\n    resetTimer(): void {\n        this.startTime = Date.now();\n        this.counters.clear();\n    }\n\n    elapsed(): string {\n        const ms = Date.now() - this.startTime;\n        if (ms < 1000) return `${ms}ms`;\n        const s = ms / 1000;\n        if (s < 60) return `${s.toFixed(2)}s`;\n        const m = Math.floor(s / 60);\n        return `${m}m ${(s - m * 60).toFixed(1)}s`;\n    }\n\n    /**\n     * Print a left-aligned table of all counters plus elapsed time.\n     * Concrete subclasses can override for richer rendering.\n     */\n    summary(title: string = A_FRAME_LOG_DEFAULTS.summaryTitle): void {\n        this.section(title);\n        const keys = [...this.counters.keys()];\n        const pad = keys.reduce((m, k) => Math.max(m, k.length), 'elapsed'.length);\n        for (const key of keys) {\n            this.info(`  ${key.padEnd(pad)}  ${this.counters.get(key)}`);\n        }\n        this.info(`  ${'elapsed'.padEnd(pad)}  ${this.elapsed()}`);\n        this.divider();\n    }\n}\n","import { A_FrameLoggerBase } from \"./A-FrameLogger.component\";\nimport {\n    A_FrameLogEntry,\n    A_FrameLogLevelType,\n    A_FrameLoggerConfig,\n    A_FrameProgressBar,\n} from \"./A-FrameLogger.types\";\nimport {\n    A_FRAME_ANSI,\n    A_FRAME_LOG_DEFAULTS,\n    A_FrameLogIcon,\n} from \"./A-FrameLogger.constants\";\n\n\n/** Map a level → ANSI colour code for its leading icon. */\nconst ICON_COLOR: Record<A_FrameLogLevelType, string> = {\n    debug: A_FRAME_ANSI.gray,\n    info: A_FRAME_ANSI.cyan,\n    success: A_FRAME_ANSI.green,\n    warn: A_FRAME_ANSI.yellow,\n    error: A_FRAME_ANSI.red,\n};\n\n\n/**\n * A_FrameLogger — Node.js environment.\n *\n * Renders to stdout with ANSI colour codes and inline progress bars when\n * stdout is a TTY. Falls back to plain text otherwise (CI, log files).\n */\nexport class A_FrameLogger extends A_FrameLoggerBase {\n\n    private readonly useColor: boolean;\n\n    constructor(config: A_FrameLoggerConfig = {}) {\n        super(config);\n        this.useColor = config.color ?? !!(process.stdout && process.stdout.isTTY);\n    }\n\n    private c(code: string, str: string): string {\n        return this.useColor ? `${code}${str}${A_FRAME_ANSI.reset}` : str;\n    }\n\n    protected write(entry: A_FrameLogEntry): void {\n        const icon = this.c(ICON_COLOR[entry.level], A_FrameLogIcon[entry.level]);\n        const line = `${icon} ${entry.message}`;\n        if (entry.level === 'error') console.error(line);\n        else if (entry.level === 'warn') console.warn(line);\n        else console.log(line);\n\n        if (entry.metadata && Object.keys(entry.metadata).length > 0) {\n            console.log(this.c(A_FRAME_ANSI.gray, `   ${JSON.stringify(entry.metadata)}`));\n        }\n    }\n\n    section(title: string): void {\n        const line = '─'.repeat(Math.max(2, 60 - title.length - 4));\n        const heading = `┄ ${title} ${line}`;\n        console.log('\\n' + this.c(A_FRAME_ANSI.bold + A_FRAME_ANSI.cyan, heading));\n    }\n\n    divider(): void {\n        console.log(this.c(A_FRAME_ANSI.gray, '─'.repeat(60)));\n    }\n\n    summary(title: string = A_FRAME_LOG_DEFAULTS.summaryTitle): void {\n        this.section(title);\n        const keys = [...this.counters.keys()];\n        const pad = keys.reduce((m, k) => Math.max(m, k.length), 'elapsed'.length);\n        for (const key of keys) {\n            console.log(`  ${this.c(A_FRAME_ANSI.gray, key.padEnd(pad))}  ${this.c(A_FRAME_ANSI.bold, String(this.counters.get(key)))}`);\n        }\n        console.log(`  ${this.c(A_FRAME_ANSI.gray, 'elapsed'.padEnd(pad))}  ${this.c(A_FRAME_ANSI.bold, this.elapsed())}`);\n        this.divider();\n    }\n\n    // ─── Progress bar ────────────────────────────────────────────────────────\n\n    progress(label: string, total: number): A_FrameProgressBar {\n        const isTTY = this.useColor; // colour ⟺ TTY by default\n        const width = A_FRAME_LOG_DEFAULTS.progressBarWidth;\n        const start = Date.now();\n\n        let current = 0;\n        let lastLabel = '';\n\n        const render = (status?: 'done' | 'fail') => {\n            if (total === 0) {\n                if (status === 'done') console.log(`${this.c(A_FRAME_ANSI.green, '✔')} ${label} (0/0)`);\n                return;\n            }\n            const pct = Math.min(1, current / total);\n            const filled = Math.round(pct * width);\n\n            if (isTTY) {\n                const bar =\n                    this.c(A_FRAME_ANSI.green, '█'.repeat(filled)) +\n                    this.c(A_FRAME_ANSI.gray, '░'.repeat(width - filled));\n                const head = status === 'done' ? this.c(A_FRAME_ANSI.green, '✔')\n                    : status === 'fail' ? this.c(A_FRAME_ANSI.red, '✖')\n                        : this.c(A_FRAME_ANSI.cyan, '⟳');\n                const tail = lastLabel ? this.c(A_FRAME_ANSI.dim, ` — ${lastLabel}`) : '';\n                process.stdout.write(`\\r\\x1b[2K${head} ${label} ${bar} ${current}/${total} (${(pct * 100).toFixed(0)}%)${tail}`);\n                if (status) process.stdout.write('\\n');\n            } else {\n                if (status === 'done') {\n                    console.log(`[${label}] done ${current}/${total} in ${((Date.now() - start) / 1000).toFixed(2)}s`);\n                } else if (status === 'fail') {\n                    console.log(`[${label}] FAILED at ${current}/${total}`);\n                } else {\n                    // Throttle: only print at 10% boundaries when not on a TTY\n                    const step = Math.max(1, Math.floor(total / 10));\n                    if (current === total || current % step === 0) {\n                        console.log(`[${label}] ${current}/${total}${lastLabel ? ` — ${lastLabel}` : ''}`);\n                    }\n                }\n            }\n        };\n\n        render();\n\n        return {\n            tick: (l?: string) => { current = Math.min(total, current + 1); if (l) lastLabel = l; render(); },\n            succeed: (l?: string) => { if (l) lastLabel = l; current = total; render('done'); },\n            fail: (l?: string) => { if (l) lastLabel = l; render('fail'); },\n            update: (n: number, l?: string) => { current = Math.min(total, Math.max(0, n)); if (l) lastLabel = l; render(); },\n        };\n    }\n}\n"]}

package/dist/node/chunk-JQBYDEMW.mjs

@@ -0,0 +1,33 @@
+import { version } from './chunk-TO4BPKCY.mjs';
+import { A_Fragment } from '@adaas/a-concept';
+
+var A_FrameEnv = class extends A_Fragment {
+  get A_FRAME_FILE_EXTENSION() {
+    return ".aframe";
+  }
+  get A_FRAME_NAMESPACES_BIN() {
+    return `__namespaces${this.A_FRAME_FILE_EXTENSION}`;
+  }
+  get A_FRAME_SYNC() {
+    return process.env.A_FRAME_SYNC === "false" ? false : true;
+  }
+  get A_FRAME_TOKEN() {
+    return process.env.A_FRAME_TOKEN || "";
+  }
+  get A_FRAME_SERVER_URL() {
+    return process.env.A_FRAME_SERVER_URL || "http://localhost:3663";
+  }
+  get A_FRAME_SERVER_API_KEY() {
+    return process.env.A_FRAME_SERVER_API_KEY || "";
+  }
+  get A_FRAME_STORAGE_DIR() {
+    return process.env.A_FRAME_STORAGE_DIR || ".aframestr";
+  }
+  get A_FRAME_VERSION() {
+    return version || "0.0.1";
+  }
+};
+
+export { A_FrameEnv };
+//# sourceMappingURL=chunk-JQBYDEMW.mjs.map
+//# sourceMappingURL=chunk-JQBYDEMW.mjs.map

package/dist/node/chunk-JQBYDEMW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameEnv/A-FrameEnv.fragment.env-node.ts"],"names":[],"mappings":";;;AAKO,IAAM,UAAA,GAAN,cAAyB,UAAA,CAAkC;AAAA,EAE9D,IAAI,sBAAA,GAAyB;AACzB,IAAA,OAAO,SAAA;AAAA,EACX;AAAA,EAEA,IAAI,sBAAA,GAAyB;AACzB,IAAA,OAAO,CAAA,YAAA,EAAe,KAAK,sBAAsB,CAAA,CAAA;AAAA,EACrD;AAAA,EAEA,IAAI,YAAA,GAAe;AACf,IAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,YAAA,KAAiB,OAAA,GAAU,KAAA,GAAQ,IAAA;AAAA,EAC1D;AAAA,EAEA,IAAI,aAAA,GAAgB;AAChB,IAAA,OAAO,OAAA,CAAQ,IAAI,aAAA,IAAiB,EAAA;AAAA,EACxC;AAAA,EAEA,IAAI,kBAAA,GAAqB;AACrB,IAAA,OAAO,OAAA,CAAQ,IAAI,kBAAA,IAAsB,uBAAA;AAAA,EAC7C;AAAA,EAEA,IAAI,sBAAA,GAAyB;AACzB,IAAA,OAAO,OAAA,CAAQ,IAAI,sBAAA,IAA0B,EAAA;AAAA,EACjD;AAAA,EAEA,IAAI,mBAAA,GAAsB;AACtB,IAAA,OAAO,OAAA,CAAQ,IAAI,mBAAA,IAAuB,YAAA;AAAA,EAC9C;AAAA,EAEA,IAAI,eAAA,GAAkB;AAClB,IAAA,OAAW,OAAA,IAAW,OAAA;AAAA,EAC1B;AACJ","file":"chunk-JQBYDEMW.mjs","sourcesContent":["import { A_Fragment } from \"@adaas/a-concept\";\nimport * as pkg from '../../../package.json';\nimport { IA_FrameEnv } from \"./A-FrameEnv.types\";\n\n\nexport class A_FrameEnv extends A_Fragment implements IA_FrameEnv {\n\n    get A_FRAME_FILE_EXTENSION() {\n        return '.aframe';\n    }\n\n    get A_FRAME_NAMESPACES_BIN() {\n        return `__namespaces${this.A_FRAME_FILE_EXTENSION}`;\n    }\n\n    get A_FRAME_SYNC() {\n        return process.env.A_FRAME_SYNC === 'false' ? false : true;\n    }\n\n    get A_FRAME_TOKEN() {\n        return process.env.A_FRAME_TOKEN || '';\n    }\n\n    get A_FRAME_SERVER_URL() {\n        return process.env.A_FRAME_SERVER_URL || 'http://localhost:3663';\n    }\n\n    get A_FRAME_SERVER_API_KEY() {\n        return process.env.A_FRAME_SERVER_API_KEY || '';\n    }\n\n    get A_FRAME_STORAGE_DIR() {\n        return process.env.A_FRAME_STORAGE_DIR || '.aframestr';\n    }\n\n    get A_FRAME_VERSION() {\n        return pkg.version || '0.0.1';\n    }\n}"]}

package/dist/node/chunk-K4MZY4ME.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-K4MZY4ME.mjs.map
+//# sourceMappingURL=chunk-K4MZY4ME.mjs.map

package/dist/node/chunk-K4MZY4ME.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-K4MZY4ME.mjs"}

package/dist/node/chunk-KK64VLZN.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=chunk-KK64VLZN.cjs.map
+//# sourceMappingURL=chunk-KK64VLZN.cjs.map

package/dist/node/chunk-KK64VLZN.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-KK64VLZN.cjs"}

package/dist/node/chunk-KLG6HKFU.cjs

@@ -0,0 +1,175 @@
+'use strict';
+
+var chunkZM2RLVVH_cjs = require('./chunk-ZM2RLVVH.cjs');
+var chunkYWWGJ6EJ_cjs = require('./chunk-YWWGJ6EJ.cjs');
+var aConcept = require('@adaas/a-concept');
+
+// src/lib/A-FrameNamespace/A-FrameNamespace.constants.ts
+var A_FRAME_DEFAULT_NAMESPACE_KEY = "default";
+var A_FrameNamespaceFeatures = {
+  Load: "_A_FRAME_NAMESPACE_LOAD",
+  Save: "_A_FRAME_NAMESPACE_SAVE",
+  Embed: "_A_FRAME_NAMESPACE_EMBED",
+  Destroy: "_A_FRAME_NAMESPACE_DESTROY"
+};
+var A_FrameNamespace = class extends aConcept.A_Entity {
+  static get concept() {
+    return "a-frame";
+  }
+  // ─── Getters ──────────────────────────────────────────────────────────────
+  get id() {
+    return this.aseid.id;
+  }
+  get name() {
+    return this._name;
+  }
+  get hash() {
+    return this._hash;
+  }
+  get description() {
+    return this._description;
+  }
+  get metadata() {
+    return this._metadata || {};
+  }
+  get vector() {
+    return this._vector;
+  }
+  get embedding() {
+    return this._vector?.values ?? null;
+  }
+  //-----------------------------------------------------------------------------------------------------
+  //--------------------------------------- Computed properties -----------------------------------------
+  //-----------------------------------------------------------------------------------------------------
+  get aFrameServerVersion() {
+    return this._aFrameServerVersion;
+  }
+  get aFrameVersion() {
+    return this._aFrameVersion;
+  }
+  get isEmbed() {
+    return this._vector !== void 0;
+  }
+  /**
+    * Saves Namespace to storage. The actual implementation of saving is handled by the A_FrameNamespaceFeatures.Save feature, which can be implemented by the environment to persist the definition to a database, file system, or other storage mechanism.
+    * 
+    * @param scope 
+    * @returns 
+    */
+  save(scope) {
+    console.log(`Saving namespace "${this._name}"...`);
+    return this.call(A_FrameNamespaceFeatures.Save, scope);
+  }
+  /**
+   * Deletes the namespace from storage. The actual implementation of deletion is handled by the A_FrameNamespaceFeatures.Destroy feature, which can be implemented by the environment to remove the namespace from the database, file system, or other storage mechanism.
+   * 
+   * @param scope 
+   * @returns 
+   */
+  destroy(scope) {
+    return this.call(A_FrameNamespaceFeatures.Destroy, scope);
+  }
+  /**
+   * Loads the namespace from storage. The actual implementation of loading is handled by the A_FrameNamespaceFeatures.Load feature, which can be implemented by the environment to retrieve the namespace from the database, file system, or other storage mechanism and populate the entity's properties accordingly.
+   * 
+   * @param scope 
+   * @returns 
+   */
+  async load(scope) {
+    return this.call(A_FrameNamespaceFeatures.Load, scope);
+  }
+  /**
+   * Updates the definition's properties. This can be used to modify the source code, description, metadata, or namespace of the definition. After updating, you may want to call `embed()` again to refresh the embedding based on the new content.
+   * 
+   * @param updates 
+   */
+  update(updates) {
+    if (updates.name) this._name = updates.name;
+    if (updates.description !== void 0) this._description = updates.description;
+    if (updates.metadata !== void 0) this._metadata = updates.metadata;
+  }
+  /**
+   * Generates an embedding vector for the namespace using the A_FrameNamespaceFeatures.Embed feature. This typically involves sending the namespace's content (name + description) to an embedding model and storing the resulting vector in the entity. Once embedded, the namespace can be searched using its vector representation.
+   * 
+   * @param scope 
+   * @returns 
+   */
+  embed(scope) {
+    console.log(`Embedding namespace "${this._name}"...`);
+    return this.call(A_FrameNamespaceFeatures.Embed, scope);
+  }
+  // ─── A_Entity lifecycle ───────────────────────────────────────────────────
+  fromNew(init) {
+    this.aseid = this.generateASEID({
+      id: aConcept.A_FormatterHelper.toKebabCase(init.name),
+      scope: "a-frame"
+    });
+    this._name = init.name;
+    const hashSource = this._name + (init.description || "") + (init.metadata ? JSON.stringify(init.metadata) : "");
+    this._hash = chunkZM2RLVVH_cjs.A_FrameHashHelper.fnv1a(hashSource);
+    this._description = init.description;
+    this._metadata = init.metadata;
+  }
+  fromJSON(serialized) {
+    this._name = serialized.name;
+    this._hash = serialized.hash;
+    this._description = serialized.description;
+    this._metadata = serialized.metadata;
+    this._vector = serialized.embedding ? new chunkYWWGJ6EJ_cjs.A_FrameVector(serialized.embedding) : void 0;
+    this._embeddedAt = serialized.embeddedAt;
+    this._embeddingModel = serialized.embeddingModel;
+    this._credentialId = serialized.credentialId;
+    this._aFrameVersion = serialized.aFrameVersion;
+    this._aFrameServerVersion = serialized.aFrameServerVersion;
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      hash: this._hash,
+      name: this._name,
+      description: this._description,
+      metadata: this._metadata,
+      embedding: this._vector?.values,
+      embeddedAt: this._embeddedAt ?? Date.now(),
+      embeddingModel: this._embeddingModel,
+      credentialId: this._credentialId,
+      aFrameVersion: this._aFrameVersion,
+      aFrameServerVersion: this._aFrameServerVersion
+    };
+  }
+  // ─── Embedding hydration ──────────────────────────────────────────────────
+  hydrateFromRecord(record) {
+    if (record.hash !== this._hash) {
+      throw new Error(
+        `A_FrameNamespace.hydrateFromRecord: hash mismatch for "${this._name}" (expected ${this._hash}, got ${record.hash})`
+      );
+    }
+    this._vector = new chunkYWWGJ6EJ_cjs.A_FrameVector(record.embedding);
+    this._embeddedAt = record.embeddedAt;
+  }
+  hydrateFromEmbedding(embedding, meta) {
+    this._vector = new chunkYWWGJ6EJ_cjs.A_FrameVector(embedding);
+    this._embeddedAt = Date.now();
+    if (meta) {
+      this._embeddingModel = meta.model;
+      this._credentialId = meta.credentialId ?? void 0;
+      this._aFrameVersion = meta.aFrameVersion;
+      this._aFrameServerVersion = meta.aFrameServerVersion;
+    }
+  }
+  /**
+   * Build the text string sent to the embedding model.
+   * Uses name + description so the vector captures semantic intent.
+   */
+  toString() {
+    const parts = [`// namespace: ${this._name}`];
+    if (this._description) parts.push(`// ${this._description}`);
+    return parts.join("\n");
+  }
+};
+
+exports.A_FRAME_DEFAULT_NAMESPACE_KEY = A_FRAME_DEFAULT_NAMESPACE_KEY;
+exports.A_FrameNamespace = A_FrameNamespace;
+exports.A_FrameNamespaceFeatures = A_FrameNamespaceFeatures;
+//# sourceMappingURL=chunk-KLG6HKFU.cjs.map
+//# sourceMappingURL=chunk-KLG6HKFU.cjs.map

package/dist/node/chunk-KLG6HKFU.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameNamespace/A-FrameNamespace.constants.ts","../../src/lib/A-FrameNamespace/A-FrameNamespace.entity.ts"],"names":["A_Entity","A_FormatterHelper","A_FrameHashHelper","A_FrameVector"],"mappings":"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","file":"chunk-KLG6HKFU.cjs","sourcesContent":["import { A_FrameNamespace } from \"./A-FrameNamespace.entity\";\n\n\nexport const A_FRAME_DEFAULT_NAMESPACE_KEY = 'default';\n\n\nexport const A_FrameNamespaceFeatures = {\n    Load: '_A_FRAME_NAMESPACE_LOAD',\n    Save: '_A_FRAME_NAMESPACE_SAVE',\n    Embed: '_A_FRAME_NAMESPACE_EMBED',\n    Destroy: '_A_FRAME_NAMESPACE_DESTROY',\n} as const;","import { A_Context, A_Entity, A_FormatterHelper, A_Scope } from \"@adaas/a-concept\";\nimport { A_FrameVector } from \"../A-FrameVector/A-FrameVector.entity\";\nimport {\n    A_FrameNamespace_Init,\n    A_FrameNamespace_Serialized,\n    A_FrameNamespace_Record,\n    A_FrameNamespace_EmbeddingMeta,\n} from \"./A-FrameNamespace.types\";\nimport { A_FrameHashHelper } from \"@adaas/a-frame/helpers/Hash.helper\";\nimport { A_FrameNamespaceFeatures } from \"./A-FrameNamespace.constants\";\n\n\nexport class A_FrameNamespace extends A_Entity<A_FrameNamespace_Init, A_FrameNamespace_Serialized> {\n\n    static get concept(): string {\n        return 'a-frame';\n    }\n\n    protected _name!: string;\n    protected _hash!: string;\n    protected _description?: string;\n    protected _metadata?: Record<string, any>;\n    protected _vector?: A_FrameVector;\n    protected _embeddedAt?: number;\n    // ─── Provenance ───────────────────────────────────────────────────────────\n    protected _embeddingModel?: string;\n    protected _credentialId?: string;\n    protected _aFrameVersion?: string;\n    protected _aFrameServerVersion?: string;\n\n\n    // ─── Getters ──────────────────────────────────────────────────────────────\n\n    get id(): string {\n        return this.aseid.id;\n    }\n\n    get name(): string {\n        return this._name;\n    }\n\n    get hash(): string {\n        return this._hash;\n    }\n\n    get description(): string | undefined {\n        return this._description;\n    }\n\n    get metadata(): Record<string, any> {\n        return this._metadata || {};\n    }\n\n    get vector(): A_FrameVector | undefined {\n        return this._vector;\n    }\n\n    get embedding(): Float32Array | null {\n        return this._vector?.values ?? null;\n    }\n\n    //-----------------------------------------------------------------------------------------------------\n    //--------------------------------------- Computed properties -----------------------------------------\n    //-----------------------------------------------------------------------------------------------------\n    get aFrameServerVersion(): string | undefined {\n        return this._aFrameServerVersion;\n    }\n\n    get aFrameVersion(): string | undefined {\n        return this._aFrameVersion;\n    }\n\n    get isEmbed(): boolean {\n        return this._vector !== undefined;\n    }\n    /**\n      * Saves Namespace to storage. The actual implementation of saving is handled by the A_FrameNamespaceFeatures.Save feature, which can be implemented by the environment to persist the definition to a database, file system, or other storage mechanism.\n      * \n      * @param scope \n      * @returns \n      */\n    save(scope?: A_Scope): Promise<void> | void {\n        console.log(`Saving namespace \"${this._name}\"...`);\n        return this.call(A_FrameNamespaceFeatures.Save, scope);\n    }\n    /**\n     * Deletes the namespace from storage. The actual implementation of deletion is handled by the A_FrameNamespaceFeatures.Destroy feature, which can be implemented by the environment to remove the namespace from the database, file system, or other storage mechanism.\n     * \n     * @param scope \n     * @returns \n     */\n    destroy(scope?: A_Scope): Promise<void> | void {\n        return this.call(A_FrameNamespaceFeatures.Destroy, scope);\n    }\n    /**\n     * Loads the namespace from storage. The actual implementation of loading is handled by the A_FrameNamespaceFeatures.Load feature, which can be implemented by the environment to retrieve the namespace from the database, file system, or other storage mechanism and populate the entity's properties accordingly.\n     * \n     * @param scope \n     * @returns \n     */\n    async load(scope?: A_Scope): Promise<void> {\n        return this.call(A_FrameNamespaceFeatures.Load, scope);\n    }\n    /**\n     * Updates the definition's properties. This can be used to modify the source code, description, metadata, or namespace of the definition. After updating, you may want to call `embed()` again to refresh the embedding based on the new content.\n     * \n     * @param updates \n     */\n    update(updates: Partial<Pick<A_FrameNamespace, 'name' | 'description' | 'metadata'>>): void {\n        if (updates.name) this._name = updates.name;\n        if (updates.description !== undefined) this._description = updates.description;\n        if (updates.metadata !== undefined) this._metadata = updates.metadata;\n    }\n    /**\n     * Generates an embedding vector for the namespace using the A_FrameNamespaceFeatures.Embed feature. This typically involves sending the namespace's content (name + description) to an embedding model and storing the resulting vector in the entity. Once embedded, the namespace can be searched using its vector representation.\n     * \n     * @param scope \n     * @returns \n     */\n    embed(scope?: A_Scope): Promise<void> | void {\n        console.log(`Embedding namespace \"${this._name}\"...`);\n        return this.call(A_FrameNamespaceFeatures.Embed, scope);\n    }\n\n    // ─── A_Entity lifecycle ───────────────────────────────────────────────────\n\n    fromNew(init: A_FrameNamespace_Init): void {\n\n        this.aseid = this.generateASEID({\n            id: A_FormatterHelper.toKebabCase(init.name),\n            scope: 'a-frame',\n        });\n\n        this._name = init.name;\n\n        const hashSource = this._name\n            + (init.description || '')\n            + (init.metadata ? JSON.stringify(init.metadata) : '');\n\n        this._hash = A_FrameHashHelper.fnv1a(hashSource);\n        this._description = init.description;\n        this._metadata = init.metadata;\n    }\n\n    fromJSON(serialized: A_FrameNamespace_Serialized): void {\n        this._name = serialized.name;\n        this._hash = serialized.hash;\n        this._description = serialized.description;\n        this._metadata = serialized.metadata;\n        this._vector = serialized.embedding ? new A_FrameVector(serialized.embedding) : undefined;\n        this._embeddedAt = serialized.embeddedAt;\n        this._embeddingModel = serialized.embeddingModel;\n        this._credentialId = serialized.credentialId;\n        this._aFrameVersion = serialized.aFrameVersion;\n        this._aFrameServerVersion = serialized.aFrameServerVersion;\n    }\n\n\n\n    toJSON(): A_FrameNamespace_Serialized {\n        return {\n            ...super.toJSON(),\n            hash: this._hash,\n            name: this._name,\n            description: this._description,\n            metadata: this._metadata,\n            embedding: this._vector?.values,\n            embeddedAt: this._embeddedAt ?? Date.now(),\n            embeddingModel: this._embeddingModel,\n            credentialId: this._credentialId,\n            aFrameVersion: this._aFrameVersion,\n            aFrameServerVersion: this._aFrameServerVersion,\n        };\n    }\n\n\n    // ─── Embedding hydration ──────────────────────────────────────────────────\n\n    hydrateFromRecord(record: A_FrameNamespace_Record): void {\n        if (record.hash !== this._hash) {\n            throw new Error(\n                `A_FrameNamespace.hydrateFromRecord: hash mismatch for \"${this._name}\" ` +\n                `(expected ${this._hash}, got ${record.hash})`\n            );\n        }\n        this._vector = new A_FrameVector(record.embedding);\n        this._embeddedAt = record.embeddedAt;\n    }\n\n    hydrateFromEmbedding(embedding: Float32Array, meta?: A_FrameNamespace_EmbeddingMeta): void {\n        this._vector = new A_FrameVector(embedding);\n        this._embeddedAt = Date.now();\n        if (meta) {\n            this._embeddingModel = meta.model;\n            this._credentialId = meta.credentialId ?? undefined;\n            this._aFrameVersion = meta.aFrameVersion;\n            this._aFrameServerVersion = meta.aFrameServerVersion;\n        }\n    }\n\n    /**\n     * Build the text string sent to the embedding model.\n     * Uses name + description so the vector captures semantic intent.\n     */\n    toString(): string {\n        const parts: string[] = [`// namespace: ${this._name}`];\n        if (this._description) parts.push(`// ${this._description}`);\n        return parts.join('\\n');\n    }\n}\n\n"]}