@memberjunction/cli 5.41.0 → 5.42.0

package/dist/lib/claude-pack/SettingsMerger.js

@@ -0,0 +1,163 @@
+/**
+ * Deep-merge for `.claude/settings.json`.
+ *
+ * The pack ships a baseline `settings.json` with a top-level
+ * `__mj_managed: { version, mjMajor?, keys: ["permissions.allow", "env.MJ_CLAUDE_PACK", ...] }`
+ * block. `keys` lists the dotted JSON paths the pack owns.
+ *
+ * The merger:
+ *   1. Deep-clones the user's existing settings as the starting point
+ *   2. For each path in `__mj_managed.keys`, merges the pack's value into the
+ *      user's:
+ *        - Arrays  → union, deduped, user entries first then pack entries
+ *        - Objects → recursive merge (per-key)
+ *        - Primitives → pack wins (rare in practice — primitives shouldn't
+ *          really be managed keys, but the rule keeps the merger total)
+ *   3. Replaces `__mj_managed` wholesale with the pack's block (so version
+ *      and mjMajor stamps update on every merge)
+ *   4. Leaves every user key outside `__mj_managed.keys` completely alone
+ *
+ * @see plans/claude-install-pack.md §10.2
+ */
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+export class SettingsMergeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SettingsMergeError';
+    }
+}
+export function mergeSettings(opts) {
+    const packMeta = readManagedMeta(opts.Pack);
+    if (!packMeta) {
+        throw new SettingsMergeError('Pack settings.json has no __mj_managed.keys block — cannot determine what to merge.');
+    }
+    const result = deepClone(opts.Existing);
+    for (const dottedPath of packMeta.keys) {
+        const packValue = getAtPath(opts.Pack, dottedPath);
+        if (packValue === undefined)
+            continue; // pack declares the key but didn't ship a value — skip
+        const existingValue = getAtPath(result, dottedPath);
+        const merged = mergeValues(existingValue, packValue);
+        setAtPath(result, dottedPath, merged);
+    }
+    // Replace __mj_managed wholesale so version + mjMajor stamps refresh.
+    // Casting through unknown is required because the index signature is `unknown`.
+    result.__mj_managed = deepClone(opts.Pack.__mj_managed);
+    const changed = !shallowJsonEqual(result, opts.Existing);
+    return { Result: result, Changed: changed };
+}
+/** Read the `__mj_managed` block out of a settings object, or null if absent. */
+export function readManagedMeta(settings) {
+    const raw = settings.__mj_managed;
+    if (!isPlainObject(raw))
+        return null;
+    const obj = raw;
+    if (typeof obj.version !== 'string')
+        return null;
+    if (!Array.isArray(obj.keys))
+        return null;
+    if (!obj.keys.every((k) => typeof k === 'string'))
+        return null;
+    return {
+        version: obj.version,
+        mjMajor: typeof obj.mjMajor === 'string' ? obj.mjMajor : undefined,
+        keys: obj.keys,
+    };
+}
+// ---------------------------------------------------------------------------
+// Merge primitives
+// ---------------------------------------------------------------------------
+function mergeValues(existing, pack) {
+    if (Array.isArray(pack) && Array.isArray(existing)) {
+        return mergeArrays(existing, pack);
+    }
+    if (isPlainObject(pack) && isPlainObject(existing)) {
+        return mergeObjects(existing, pack);
+    }
+    // Type mismatch or primitive — pack wins.
+    return deepClone(pack);
+}
+/** Union user entries first, then pack entries; deduped by stable JSON encoding. */
+function mergeArrays(existing, pack) {
+    const seen = new Set();
+    const out = [];
+    for (const item of [...existing, ...pack]) {
+        const key = stableKey(item);
+        if (!seen.has(key)) {
+            seen.add(key);
+            out.push(deepClone(item));
+        }
+    }
+    return out;
+}
+function mergeObjects(existing, pack) {
+    const out = deepClone(existing);
+    for (const [key, value] of Object.entries(pack)) {
+        out[key] = mergeValues(out[key], value);
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+export function getAtPath(obj, dottedPath) {
+    const parts = dottedPath.split('.');
+    let cur = obj;
+    for (const p of parts) {
+        if (!isPlainObject(cur))
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+export function setAtPath(obj, dottedPath, value) {
+    const parts = dottedPath.split('.');
+    const last = parts.pop();
+    if (last === undefined)
+        return;
+    let cur = obj;
+    for (const p of parts) {
+        const next = cur[p];
+        if (!isPlainObject(next)) {
+            cur[p] = {};
+        }
+        cur = cur[p];
+    }
+    cur[last] = value;
+}
+// ---------------------------------------------------------------------------
+// Misc utilities
+// ---------------------------------------------------------------------------
+export function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+function deepClone(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value))
+        return value.map((v) => deepClone(v));
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+        out[k] = deepClone(v);
+    }
+    return out;
+}
+/**
+ * Stable string key for an arbitrary JSON-ish value, used to dedupe array
+ * entries. Sorts object keys so `{a:1,b:2}` and `{b:2,a:1}` produce the same
+ * key.
+ */
+function stableKey(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return '[' + value.map(stableKey).join(',') + ']';
+    const entries = Object.entries(value).sort(([a], [b]) => a.localeCompare(b));
+    return '{' + entries.map(([k, v]) => JSON.stringify(k) + ':' + stableKey(v)).join(',') + '}';
+}
+function shallowJsonEqual(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+//# sourceMappingURL=SettingsMerger.js.map

package/dist/lib/claude-pack/SettingsMerger.js.map

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

package/dist/lib/cli-plugins.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Loads all CLI plugins so their `@RegisterClass(BaseCLIPlugin, …)` decorators
+ * populate the ClassFactory — the basis for the `mj usage` / `mj <domain> usage`
+ * progressive-disclosure surface (plan §5).
+ *
+ * The metadata-sync and codegen-lib plugin entry points ship WITH the CLI, so
+ * they're loaded unconditionally as built-ins (available even when no
+ * `mj-cli-plugins.json` is present). Any third-party plugins listed in that file
+ * are then loaded on top.
+ *
+ * These plugin modules are intentionally light — they static-import only
+ * cli-core + oclif + global and dynamic-import their heavy engines at execution
+ * time — so loading them here for usage composition is cheap.
+ */
+export declare function loadAllCliPlugins(searchFrom?: string): Promise<void>;
+//# sourceMappingURL=cli-plugins.d.ts.map

package/dist/lib/cli-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-plugins.d.ts","sourceRoot":"","sources":["../../src/lib/cli-plugins.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CASzF"}

package/dist/lib/cli-plugins.js

@@ -0,0 +1,26 @@
+import { CLIPluginRegistry } from '@memberjunction/cli-core';
+/**
+ * Loads all CLI plugins so their `@RegisterClass(BaseCLIPlugin, …)` decorators
+ * populate the ClassFactory — the basis for the `mj usage` / `mj <domain> usage`
+ * progressive-disclosure surface (plan §5).
+ *
+ * The metadata-sync and codegen-lib plugin entry points ship WITH the CLI, so
+ * they're loaded unconditionally as built-ins (available even when no
+ * `mj-cli-plugins.json` is present). Any third-party plugins listed in that file
+ * are then loaded on top.
+ *
+ * These plugin modules are intentionally light — they static-import only
+ * cli-core + oclif + global and dynamic-import their heavy engines at execution
+ * time — so loading them here for usage composition is cheap.
+ */
+export async function loadAllCliPlugins(searchFrom = process.cwd()) {
+    await import('@memberjunction/metadata-sync/plugins');
+    await import('@memberjunction/codegen-lib/plugins');
+    const { failed } = await CLIPluginRegistry.LoadPluginsFromConfig(searchFrom);
+    // Surface (don't swallow) any third-party plugin that failed to load. stderr
+    // keeps stdout clean for `--format=json` consumers.
+    for (const f of failed) {
+        process.stderr.write(`Warning: could not load CLI plugin "${f.specifier}": ${f.error}\n`);
+    }
+}
+//# sourceMappingURL=cli-plugins.js.map

package/dist/lib/cli-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-plugins.js","sourceRoot":"","sources":["../../src/lib/cli-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,aAAqB,OAAO,CAAC,GAAG,EAAE;IACxE,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;IACtD,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;IACpD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,iBAAiB,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC7E,6EAA6E;IAC7E,oDAAoD;IACpD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC"}

package/dist/lib/domain-usage-command.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+/**
+ * Shared base for tier-2 usage commands (`mj <domain> usage`). Concrete
+ * subclasses under `commands/<domain>/usage.ts` set {@link Domain}. Returns every
+ * command in that domain — summary, flags, examples, runtime — composed from the
+ * registered plugins' `static Usage` (plan §5).
+ */
+export declare abstract class DomainUsageCommand extends Command {
+    static flags: {
+        format: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    /** The domain this command documents (e.g. 'sync', 'codegen'). */
+    protected abstract Domain: string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=domain-usage-command.d.ts.map

package/dist/lib/domain-usage-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-usage-command.d.ts","sourceRoot":"","sources":["../../src/lib/domain-usage-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAK7C;;;;;GAKG;AACH,8BAAsB,kBAAmB,SAAQ,OAAO;IACtD,MAAM,CAAC,KAAK;;MAEV;IAEF,kEAAkE;IAClE,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAE5B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAO3B"}

package/dist/lib/domain-usage-command.js

@@ -0,0 +1,23 @@
+import { Command, Flags } from '@oclif/core';
+import { CLIPluginRegistry } from '@memberjunction/cli-core';
+import { loadAllCliPlugins } from './cli-plugins.js';
+import { emitUsage, renderDomainDetail } from './usage-render.js';
+/**
+ * Shared base for tier-2 usage commands (`mj <domain> usage`). Concrete
+ * subclasses under `commands/<domain>/usage.ts` set {@link Domain}. Returns every
+ * command in that domain — summary, flags, examples, runtime — composed from the
+ * registered plugins' `static Usage` (plan §5).
+ */
+export class DomainUsageCommand extends Command {
+    static { this.flags = {
+        format: Flags.string({ options: ['text', 'json', 'md'], default: 'text', description: 'Output format' }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(this.constructor);
+        await loadAllCliPlugins(process.cwd());
+        const detail = CLIPluginRegistry.BuildDomainDetail(this.Domain);
+        const result = CLIPluginRegistry.AsResult(`${this.Domain}:usage`, { domain: detail.domain, commands: detail.commands });
+        emitUsage((m) => this.log(m), flags.format, result, renderDomainDetail(detail));
+    }
+}
+//# sourceMappingURL=domain-usage-command.js.map

package/dist/lib/domain-usage-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-usage-command.js","sourceRoot":"","sources":["../../src/lib/domain-usage-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAElE;;;;;GAKG;AACH,MAAM,OAAgB,kBAAmB,SAAQ,OAAO;aAC/C,UAAK,GAAG;QACb,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;KACzG,CAAC;IAKF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAwC,CAAC,CAAC;QAClF,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxH,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,MAAgB,EAAE,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,CAAC"}

package/dist/lib/usage-render.d.ts

@@ -0,0 +1,14 @@
+import { type MJCLIResult, type UsageDomainDetail, type UsageDomainMap } from '@memberjunction/cli-core';
+type LogFn = (message: string) => void;
+/**
+ * Serializes a usage {@link MJCLIResult} per `--format`, via the same
+ * {@link SerializeResult} the runtime host uses (single source of truth). For
+ * `text`, the caller supplies pre-rendered human lines.
+ */
+export declare function emitUsage(log: LogFn, format: string, result: MJCLIResult, textLines: string[]): void;
+/** Human-readable tier-1 domain map. */
+export declare function renderDomainMap(map: UsageDomainMap): string[];
+/** Human-readable tier-2 domain detail. */
+export declare function renderDomainDetail(detail: UsageDomainDetail): string[];
+export {};
+//# sourceMappingURL=usage-render.d.ts.map

package/dist/lib/usage-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-render.d.ts","sourceRoot":"","sources":["../../src/lib/usage-render.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,WAAW,EAAuC,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/J,KAAK,KAAK,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEvC;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAMpG;AAED,wCAAwC;AACxC,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAa7D;AAED,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAsBtE"}

package/dist/lib/usage-render.js

@@ -0,0 +1,64 @@
+import chalk from 'chalk';
+import { SerializeResult } from '@memberjunction/cli-core';
+/**
+ * Serializes a usage {@link MJCLIResult} per `--format`, via the same
+ * {@link SerializeResult} the runtime host uses (single source of truth). For
+ * `text`, the caller supplies pre-rendered human lines.
+ */
+export function emitUsage(log, format, result, textLines) {
+    if (format === 'json' || format === 'md') {
+        log(SerializeResult(result, format));
+    }
+    else {
+        textLines.forEach((line) => log(line));
+    }
+}
+/** Human-readable tier-1 domain map. */
+export function renderDomainMap(map) {
+    const lines = [];
+    lines.push(chalk.bold('\nmj — command domains'));
+    lines.push(chalk.gray(map.guidance) + '\n');
+    const pad = Math.max(...map.domains.map((d) => d.domain.length), 4);
+    for (const d of map.domains) {
+        const name = chalk.cyan(d.domain.padEnd(pad));
+        const rt = chalk.gray(`[${d.runtime}]`);
+        lines.push(`  ${name}  ${d.summary} ${rt}`);
+    }
+    lines.push('');
+    lines.push(chalk.gray('Next: `mj <domain> usage` for that domain\'s commands, flags, and timeouts.'));
+    return lines;
+}
+/** Human-readable tier-2 domain detail. */
+export function renderDomainDetail(detail) {
+    const lines = [];
+    lines.push(chalk.bold(`\nmj ${detail.domain} — commands`));
+    if (detail.commands.length === 0) {
+        lines.push(chalk.gray(`  (no commands registered for domain "${detail.domain}")`));
+        return lines;
+    }
+    for (const cmd of detail.commands) {
+        lines.push('');
+        lines.push(`  ${chalk.cyan(cmd.command)} — ${cmd.summary}`);
+        if (cmd.description)
+            lines.push(chalk.gray(`    ${cmd.description}`));
+        lines.push(`    ${chalk.gray('runtime:')} ${formatRuntime(cmd)}`);
+        if (cmd.flags?.length) {
+            lines.push(`    ${chalk.gray('flags:')}`);
+            for (const f of cmd.flags)
+                lines.push(`      ${chalk.yellow(f.name)} (${f.type}) — ${f.description}`);
+        }
+        if (cmd.examples?.length) {
+            lines.push(`    ${chalk.gray('examples:')}`);
+            for (const e of cmd.examples)
+                lines.push(`      ${e}`);
+        }
+    }
+    return lines;
+}
+function formatRuntime(cmd) {
+    const r = cmd.runtime;
+    const secs = r.typicalSeconds ? `~${r.typicalSeconds}s` : '';
+    const note = r.note ? ` — ${r.note}` : '';
+    return `${r.class}${secs ? ` (${secs})` : ''}${note}`;
+}
+//# sourceMappingURL=usage-render.js.map

package/dist/lib/usage-render.js.map

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

package/dist/light-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"light-commands.d.ts","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CA8C7C,CAAC"}
+{"version":3,"file":"light-commands.d.ts","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CA4D7C,CAAC"}

package/dist/light-commands.js

@@ -17,6 +17,13 @@ export const LIGHT_COMMANDS = new Set([
     // Built-in oclif plugins
     'version',
     'help',
+    // Progressive-disclosure usage (tier 1 + tier 2) — composes plugin static
+    // metadata only; no bootstrap needed. Plugin entry points are light.
+    'usage',
+    'sync usage',
+    'codegen usage',
+    // Plugin registry editing — just writes mj-cli-plugins.json
+    'plugin add',
     // Bump - uses zod, fast-glob, fs only
     'bump',
     // Database commands - use @memberjunction/skyway-core + config only
@@ -38,6 +45,10 @@ export const LIGHT_COMMANDS = new Set([
     // SQL conversion commands - use @memberjunction/sql-converter + sqlglot-ts only
     'sql-convert',
     'sql-audit',
+    // Claude pack commands - use only node stdlib + the lib/claude-pack/ helpers;
+    // no MJ runtime / bootstrap needed.
+    'install:claude',
+    'update:claude',
     // CodeGen manifest - uses @memberjunction/codegen-lib for AST scanning only, no bootstrap needed.
     // Must be light to break the circular dependency: server-bootstrap-lite's prebuild calls
     // `mj codegen manifest`, but bootstrap-lite must be built before MJCLI's prerun can import it.

package/dist/light-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"light-commands.js","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACzD,yBAAyB;IACzB,SAAS;IACT,MAAM;IAEN,sCAAsC;IACtC,MAAM;IAEN,oEAAoE;IACpE,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,gBAAgB;IAEhB,qFAAqF;IACrF,SAAS;IAET,6EAA6E;IAC7E,QAAQ;IAER,4FAA4F;IAC5F,QAAQ;IAER,kEAAkE;IAClE,IAAI;IACJ,UAAU;IACV,MAAM;IACN,OAAO;IAEP,gFAAgF;IAChF,aAAa;IACb,WAAW;IAEX,kGAAkG;IAClG,yFAAyF;IACzF,+FAA+F;IAC/F,kBAAkB;IAElB,0DAA0D;IAC1D,YAAY;IACZ,eAAe;IACf,cAAc;IACd,6BAA6B;IAC7B,wBAAwB;IACxB,aAAa;IACb,cAAc;CACf,CAAC,CAAC"}
+{"version":3,"file":"light-commands.js","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACzD,yBAAyB;IACzB,SAAS;IACT,MAAM;IAEN,0EAA0E;IAC1E,qEAAqE;IACrE,OAAO;IACP,YAAY;IACZ,eAAe;IAEf,4DAA4D;IAC5D,YAAY;IAEZ,sCAAsC;IACtC,MAAM;IAEN,oEAAoE;IACpE,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,gBAAgB;IAEhB,qFAAqF;IACrF,SAAS;IAET,6EAA6E;IAC7E,QAAQ;IAER,4FAA4F;IAC5F,QAAQ;IAER,kEAAkE;IAClE,IAAI;IACJ,UAAU;IACV,MAAM;IACN,OAAO;IAEP,gFAAgF;IAChF,aAAa;IACb,WAAW;IAEX,8EAA8E;IAC9E,oCAAoC;IACpC,gBAAgB;IAChB,eAAe;IAEf,kGAAkG;IAClG,yFAAyF;IACzF,+FAA+F;IAC/F,kBAAkB;IAElB,0DAA0D;IAC1D,YAAY;IACZ,eAAe;IACf,cAAc;IACd,6BAA6B;IAC7B,wBAAwB;IACxB,aAAa;IACb,cAAc;CACf,CAAC,CAAC"}