qnce-engine 1.3.2 → 1.4.1

package/dist/utils/debug-logger.d.ts

@@ -0,0 +1,20 @@
+/** Lightweight ring-buffer debug logger (opt-in at runtime). */
+export interface DebugLogEntry {
+    ts: number;
+    level: 'debug';
+    event: string;
+    data?: Record<string, unknown>;
+}
+export declare class DebugLogger {
+    private enabled;
+    private buffer;
+    private capacity;
+    constructor(capacity?: number);
+    setEnabled(v: boolean): void;
+    isEnabled(): boolean;
+    log(event: string, data?: Record<string, unknown>): void;
+    flush(): DebugLogEntry[];
+    clear(): void;
+}
+export declare const globalDebugLogger: DebugLogger;
+//# sourceMappingURL=debug-logger.d.ts.map

package/dist/utils/debug-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-logger.d.ts","sourceRoot":"","sources":["../../src/utils/debug-logger.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,SAAM;IAE1B,UAAU,CAAC,CAAC,EAAE,OAAO;IACrB,SAAS;IAET,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAOjD,KAAK,IAAI,aAAa,EAAE;IACxB,KAAK;CACN;AAED,eAAO,MAAM,iBAAiB,aAAoB,CAAC"}

package/dist/utils/debug-logger.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalDebugLogger = exports.DebugLogger = void 0;
+class DebugLogger {
+    enabled = false;
+    buffer = [];
+    capacity;
+    constructor(capacity = 200) { this.capacity = capacity; }
+    setEnabled(v) { this.enabled = v; }
+    isEnabled() { return this.enabled; }
+    log(event, data) {
+        if (!this.enabled)
+            return;
+        const entry = { ts: Date.now(), level: 'debug', event, data };
+        if (this.buffer.length >= this.capacity)
+            this.buffer.shift();
+        this.buffer.push(entry);
+    }
+    flush() { return [...this.buffer]; }
+    clear() { this.buffer = []; }
+}
+exports.DebugLogger = DebugLogger;
+exports.globalDebugLogger = new DebugLogger();
+//# sourceMappingURL=debug-logger.js.map

package/dist/utils/debug-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-logger.js","sourceRoot":"","sources":["../../src/utils/debug-logger.ts"],"names":[],"mappings":";;;AAQA,MAAa,WAAW;IACd,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,GAAoB,EAAE,CAAC;IAC7B,QAAQ,CAAS;IAEzB,YAAY,QAAQ,GAAG,GAAG,IAAI,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC;IAEzD,UAAU,CAAC,CAAU,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5C,SAAS,KAAK,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAEpC,GAAG,CAAC,KAAa,EAAE,IAA8B;QAC/C,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,KAAK,GAAkB,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC7E,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC7D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,KAAsB,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrD,KAAK,KAAK,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC;CAC9B;AAnBD,kCAmBC;AAEY,QAAA,iBAAiB,GAAG,IAAI,WAAW,EAAE,CAAC"}

package/dist/utils/hot-profiler.d.ts

@@ -0,0 +1,21 @@
+/** Simple aggregated hot-path profiler for micro-sections. */
+export interface HotSample {
+    count: number;
+    totalMs: number;
+    maxMs: number;
+}
+export declare class HotProfiler {
+    private map;
+    private enabled;
+    enable(v?: boolean): void;
+    isEnabled(): boolean;
+    wrap<T>(label: string, fn: () => T): T;
+    summary(): Record<string, {
+        count: number;
+        avgMs: number;
+        maxMs: number;
+    }>;
+    reset(): void;
+}
+export declare const globalHotProfiler: HotProfiler;
+//# sourceMappingURL=hot-profiler.d.ts.map

package/dist/utils/hot-profiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hot-profiler.d.ts","sourceRoot":"","sources":["../../src/utils/hot-profiler.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CAAE;AAE7E,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,OAAO,CAAS;IACxB,MAAM,CAAC,CAAC,UAAO;IACf,SAAS;IACT,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAStC,OAAO;eAC8B,MAAM;eAAS,MAAM;eAAS,MAAM;;IAIzE,KAAK;CACN;AAED,eAAO,MAAM,iBAAiB,aAAoB,CAAC"}

package/dist/utils/hot-profiler.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalHotProfiler = exports.HotProfiler = void 0;
+class HotProfiler {
+    map = new Map();
+    enabled = false;
+    enable(v = true) { this.enabled = v; }
+    isEnabled() { return this.enabled; }
+    wrap(label, fn) {
+        if (!this.enabled)
+            return fn();
+        const t0 = performance.now();
+        try {
+            return fn();
+        }
+        finally {
+            const ms = performance.now() - t0;
+            const s = this.map.get(label) || { count: 0, totalMs: 0, maxMs: 0 };
+            s.count++;
+            s.totalMs += ms;
+            if (ms > s.maxMs)
+                s.maxMs = ms;
+            this.map.set(label, s);
+        }
+    }
+    summary() {
+        const out = {};
+        for (const [k, v] of this.map)
+            out[k] = { count: v.count, avgMs: v.totalMs / v.count, maxMs: v.maxMs };
+        return out;
+    }
+    reset() { this.map.clear(); }
+}
+exports.HotProfiler = HotProfiler;
+exports.globalHotProfiler = new HotProfiler();
+//# sourceMappingURL=hot-profiler.js.map

package/dist/utils/hot-profiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hot-profiler.js","sourceRoot":"","sources":["../../src/utils/hot-profiler.ts"],"names":[],"mappings":";;;AAGA,MAAa,WAAW;IACd,GAAG,GAAG,IAAI,GAAG,EAAqB,CAAC;IACnC,OAAO,GAAG,KAAK,CAAC;IACxB,MAAM,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;IACtC,SAAS,KAAK,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACpC,IAAI,CAAI,KAAa,EAAE,EAAW;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC;YAAC,OAAO,EAAE,EAAE,CAAC;QAAC,CAAC;gBAAS,CAAC;YAC5B,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACpE,CAAC,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;YAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK;gBAAE,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,OAAO;QACL,MAAM,GAAG,GAAoE,EAAE,CAAC;QAChF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACvG,OAAO,GAAG,CAAC;IACb,CAAC;IACD,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;CAC9B;AApBD,kCAoBC;AAEY,QAAA,iBAAiB,GAAG,IAAI,WAAW,EAAE,CAAC"}

package/dist/utils/intern.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Intern a short string. Returns a canonical instance from a small pool.
+ * Non-string or long strings are returned as-is.
+ * @internal
+ */
+export declare function internString<T = unknown>(value: T): T;
+/** Intern all string keys and string values in an object (shallow).
+ * @internal
+ */
+export declare function internShallowRecord(obj: Record<string, unknown> | undefined | null): Record<string, unknown> | undefined;
+//# sourceMappingURL=intern.d.ts.map

package/dist/utils/intern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intern.d.ts","sourceRoot":"","sources":["../../src/utils/intern.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAcrD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CASxH"}

package/dist/utils/intern.js

@@ -0,0 +1,45 @@
+"use strict";
+// Lightweight string interning utility to reduce duplicate string allocations
+// Intended for short, frequently repeated keys/values on hot paths
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.internString = internString;
+exports.internShallowRecord = internShallowRecord;
+const MAX_ENTRIES = 1024; // soft cap to avoid unbounded growth
+const pool = new Map();
+/**
+ * Intern a short string. Returns a canonical instance from a small pool.
+ * Non-string or long strings are returned as-is.
+ * @internal
+ */
+function internString(value) {
+    if (typeof value !== 'string')
+        return value;
+    if (value.length > 64)
+        return value;
+    const existing = pool.get(value);
+    if (existing)
+        return existing;
+    // Evict oldest when exceeding cap (Map preserves insertion order)
+    if (pool.size >= MAX_ENTRIES) {
+        const firstKey = pool.keys().next().value;
+        if (firstKey !== undefined)
+            pool.delete(firstKey);
+    }
+    pool.set(value, value);
+    return value;
+}
+/** Intern all string keys and string values in an object (shallow).
+ * @internal
+ */
+function internShallowRecord(obj) {
+    if (!obj)
+        return obj;
+    const out = {};
+    for (const k of Object.keys(obj)) {
+        const ik = internString(k);
+        const v = obj[k];
+        out[ik] = typeof v === 'string' ? internString(v) : v;
+    }
+    return out;
+}
+//# sourceMappingURL=intern.js.map

package/dist/utils/intern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intern.js","sourceRoot":"","sources":["../../src/utils/intern.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,mEAAmE;;AAWnE,oCAcC;AAKD,kDASC;AArCD,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,qCAAqC;AAE/D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEvC;;;;GAIG;AACH,SAAgB,YAAY,CAAc,KAAQ;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAqB,CAAC;IAEpD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,QAAQ;QAAE,OAAO,QAAwB,CAAC;IAE9C,kEAAkE;IAClE,IAAI,IAAI,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAC1C,IAAI,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACvB,OAAO,KAAqB,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,GAA+C;IACjF,IAAI,CAAC,GAAG;QAAE,OAAO,GAA2B,CAAC;IAC7C,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,GAAI,GAA+B,CAAC,CAAC,CAAC,CAAC;QAC9C,GAAG,CAAC,EAAY,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,34 @@
+/** Lightweight logger with level filtering and pluggable sink (no external deps). */
+export type LogLevelName = 'silent' | 'error' | 'warn' | 'info' | 'success' | 'debug';
+export interface LogEntry {
+    level: LogLevelName;
+    message: string;
+    ts: number;
+}
+export interface LoggerSink {
+    write(entry: LogEntry): void;
+}
+export interface CreateLoggerOptions {
+    level?: LogLevelName;
+    sink?: LoggerSink;
+    useColor?: boolean;
+}
+export interface Logger {
+    level: LogLevelName;
+    setLevel(lvl: LogLevelName): void;
+    error(msg: string): void;
+    warn(msg: string): void;
+    info(msg: string): void;
+    success(msg: string): void;
+    debug(msg: string): void;
+    child(pfx: string): Logger;
+}
+/** Serialize arbitrary values safely for log messages (avoids generic [object Object]). */
+export declare function formatLog(value: unknown, depth?: number, seen?: WeakSet<object>): string;
+export declare function createLogger(opts?: CreateLoggerOptions): Logger;
+/** Helper to derive level from flags */
+export declare function deriveLogLevel(flags: {
+    quiet?: boolean;
+    verbose?: boolean;
+}): LogLevelName;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAWtF,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC9B;AAiCD,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,EAAE,IAAI,kBAAwB,GAAG,MAAM,CAsBzF;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,MAAM,CAoBnE;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,YAAY,CAI1F"}

package/dist/utils/logger.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatLog = formatLog;
+exports.createLogger = createLogger;
+exports.deriveLogLevel = deriveLogLevel;
+const LEVEL_ORDER = {
+    silent: 100, // suppress all
+    error: 50,
+    warn: 40,
+    info: 30,
+    success: 30, // treat success same visibility as info
+    debug: 10
+};
+class ConsoleSink {
+    useColor;
+    constructor(useColor) {
+        this.useColor = useColor;
+    }
+    write(entry) {
+        const { level, message } = entry;
+        const color = this.colorFor(level);
+        const prefix = this.prefixFor(level);
+        // Use process.stdout / stderr directly to avoid triggering no-console
+        const out = (level === 'error' ? process.stderr : process.stdout);
+        out.write(`${color}${prefix}${message}${this.useColor ? '\u001b[0m' : ''}\n`);
+    }
+    colorFor(level) {
+        if (!this.useColor)
+            return '';
+        switch (level) {
+            case 'error': return '\u001b[31m'; // red
+            case 'warn': return '\u001b[33m'; // yellow
+            case 'success': return '\u001b[32m'; // green
+            case 'debug': return '\u001b[90m'; // gray
+            default: return '\u001b[36m'; // cyan/info
+        }
+    }
+    prefixFor(level) {
+        switch (level) {
+            case 'error': return '❌ ';
+            case 'warn': return '⚠️  ';
+            case 'success': return '✅ ';
+            case 'debug': return '🔍 ';
+            default: return '';
+        }
+    }
+}
+/** Serialize arbitrary values safely for log messages (avoids generic [object Object]). */
+function formatLog(value, depth = 0, seen = new WeakSet()) {
+    if (typeof value === 'string')
+        return value;
+    if (value instanceof Error)
+        return value.stack || value.message;
+    const t = typeof value;
+    if (value == null || t === 'number' || t === 'boolean')
+        return String(value);
+    if (t === 'function')
+        return `[Function ${value.name || 'anonymous'}]`;
+    if (t === 'symbol')
+        return value.toString();
+    if (Array.isArray(value)) {
+        if (depth > 2)
+            return `[Array(${value.length})]`;
+        return '[' + value.map(v => formatLog(v, depth + 1, seen)).join(', ') + ']';
+    }
+    if (t === 'object') {
+        if (seen.has(value))
+            return '[Circular]';
+        seen.add(value);
+        if (depth > 2)
+            return '{…}';
+        const entries = Object.entries(value)
+            .slice(0, 25)
+            .map(([k, v]) => `${k}: ${formatLog(v, depth + 1, seen)}`);
+        const truncated = Object.keys(value).length > 25 ? ' …' : '';
+        return '{ ' + entries.join(', ') + truncated + ' }';
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function createLogger(opts = {}) {
+    const sink = opts.sink || new ConsoleSink(opts.useColor ?? process.stdout.isTTY);
+    let level = opts.level || 'info';
+    const basePrefix = '';
+    function emit(l, msg) {
+        // lower numeric = more verbose; allow if candidate order >= current level order
+        if (LEVEL_ORDER[l] < LEVEL_ORDER[level])
+            return; // require candidate >= threshold
+        sink.write({ level: l, message: basePrefix + formatLog(msg), ts: Date.now() });
+    }
+    const logger = {
+        get level() { return level; },
+        setLevel(lvl) { level = lvl; },
+        error(msg) { emit('error', msg); },
+        warn(msg) { emit('warn', msg); },
+        info(msg) { emit('info', msg); },
+        success(msg) { emit('success', msg); },
+        debug(msg) { emit('debug', msg); },
+        child() { return createLogger({ level, sink, useColor: (opts.useColor ?? process.stdout.isTTY) }); }
+    };
+    return logger;
+}
+/** Helper to derive level from flags */
+function deriveLogLevel(flags) {
+    if (flags.quiet)
+        return 'warn';
+    if (flags.verbose)
+        return 'debug';
+    return 'info';
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}