@tjalve/cube-cli 0.1.0

package/dist/output/index.d.ts

@@ -0,0 +1,32 @@
+import { type CliErrorShape } from "../errors/index.js";
+export type JsonFields = Readonly<Record<string, unknown>>;
+export interface JsonSuccessEnvelope {
+    readonly ok: true;
+    readonly command: string;
+    readonly [key: string]: unknown;
+}
+export interface JsonErrorEnvelope {
+    readonly ok: false;
+    readonly command: string;
+    readonly error: {
+        readonly kind: string;
+        readonly operation: string;
+        readonly likelyCause: string;
+        readonly suggestedNextAction: string;
+        readonly category: string;
+        readonly exitCode: number;
+    };
+}
+export interface CommandResultShape {
+    readonly stdout?: string;
+    readonly stderr?: string;
+    readonly exitCode?: number;
+}
+export declare function createJsonSuccessEnvelope(command: string, fields?: JsonFields): JsonSuccessEnvelope;
+export declare function createJsonErrorEnvelope(error: CliErrorShape): JsonErrorEnvelope;
+export declare function renderJsonLine(value: unknown): string;
+export declare function renderJsonSuccess(command: string, fields?: JsonFields): string;
+export declare function renderJsonError(error: CliErrorShape): string;
+export declare function createJsonSuccessResult(command: string, fields?: JsonFields, stderr?: string): CommandResultShape;
+export declare function createHumanResult(stdout: string, stderr?: string, exitCode?: number): CommandResultShape;
+//# sourceMappingURL=index.d.ts.map

package/dist/output/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/output/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;QACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,UAAe,GAAG,mBAAmB,CAOvG;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB,CAa/E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMrD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,UAAe,GAAG,MAAM,CAElF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAE5D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,UAAe,EAAE,MAAM,SAAK,GAAG,kBAAkB,CAMjH;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAK,EAAE,QAAQ,SAAI,GAAG,kBAAkB,CAG/F"}

package/dist/output/index.js

@@ -0,0 +1,94 @@
+import {} from "../errors/index.js";
+import { isSensitiveKey, redactStructuredValue, redactText, redactionPlaceholder } from "../redaction/index.js";
+export function createJsonSuccessEnvelope(command, fields = {}) {
+    assertNoReservedFields(fields);
+    return Object.freeze({
+        ok: true,
+        command,
+        ...stableFields(fields)
+    });
+}
+export function createJsonErrorEnvelope(error) {
+    return Object.freeze({
+        ok: false,
+        command: error.command ?? "",
+        error: Object.freeze({
+            kind: error.kind,
+            operation: redactText(error.operation),
+            likelyCause: redactText(error.likelyCause),
+            suggestedNextAction: redactText(error.suggestedNextAction),
+            category: error.category,
+            exitCode: error.exitCode
+        })
+    });
+}
+export function renderJsonLine(value) {
+    const serialized = JSON.stringify(value);
+    if (serialized === undefined) {
+        throw new TypeError("JSON output value must be serializable as valid JSON.");
+    }
+    return `${serialized}\n`;
+}
+export function renderJsonSuccess(command, fields = {}) {
+    return renderJsonLine(createJsonSuccessEnvelope(command, fields));
+}
+export function renderJsonError(error) {
+    return renderJsonLine(createJsonErrorEnvelope(error));
+}
+export function createJsonSuccessResult(command, fields = {}, stderr = "") {
+    const result = {
+        exitCode: 0,
+        stdout: renderJsonSuccess(command, fields)
+    };
+    return stderr.length > 0 ? { ...result, stderr } : result;
+}
+export function createHumanResult(stdout, stderr = "", exitCode = 0) {
+    const result = { exitCode, stdout };
+    return stderr.length > 0 ? { ...result, stderr } : result;
+}
+function assertNoReservedFields(fields) {
+    for (const reserved of ["ok", "command"]) {
+        if (Object.hasOwn(fields, reserved)) {
+            throw new TypeError(`JSON result fields must not define reserved field "${reserved}".`);
+        }
+    }
+}
+function stableFields(fields) {
+    const result = {};
+    for (const key of Object.keys(fields).sort(compareText)) {
+        const value = fields[key];
+        if (value !== undefined) {
+            result[key] = stableValue(value, key);
+        }
+    }
+    return result;
+}
+function stableValue(value, key) {
+    if (key && isSensitiveKey(key) && value !== undefined && value !== null) {
+        return redactionPlaceholder;
+    }
+    if (typeof value === "string") {
+        return redactText(value);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => stableValue(item));
+    }
+    if (isRecord(value)) {
+        return stableFields(redactStructuredValue(value));
+    }
+    return value;
+}
+function isRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function compareText(left, right) {
+    if (left === right) {
+        return 0;
+    }
+    return left < right ? -1 : 1;
+}
+//# sourceMappingURL=index.js.map

package/dist/output/index.js.map

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

package/dist/prompts/index.d.ts

@@ -0,0 +1,37 @@
+import { confirm, text } from "@clack/prompts";
+import type { CommandMetadata } from "../metadata/index.js";
+import { type TerminalCapabilities } from "../terminal/index.js";
+export type PromptBlockReason = "ci" | "json" | "non-interactive" | "non-tty" | "tty-prompt-disabled";
+export interface PromptGateOptions<Value> {
+    readonly command?: CommandMetadata | string;
+    readonly promptName?: string;
+    readonly terminal?: TerminalCapabilities;
+    readonly jsonMode?: boolean;
+    readonly nonInteractive?: boolean;
+    readonly value?: Value;
+    readonly defaultValue?: Value;
+    readonly defaults?: boolean;
+    readonly yes?: boolean;
+}
+export type PromptGateDecision = {
+    readonly allowed: true;
+} | {
+    readonly allowed: false;
+    readonly reason: PromptBlockReason;
+    readonly message: string;
+};
+export type PromptRunner<Value> = () => Promise<Value | symbol> | Value | symbol;
+export type ClackTextOptions = Parameters<typeof text>[0];
+export type ClackConfirmOptions = Parameters<typeof confirm>[0];
+export declare function evaluatePromptGate<Value>(options?: PromptGateOptions<Value>): PromptGateDecision;
+export declare function resolvePromptValue<Value>(options: PromptGateOptions<Value> & {
+    readonly prompt: PromptRunner<Value>;
+}): Promise<Value>;
+export declare function promptText(options: PromptGateOptions<string> & {
+    readonly clack: ClackTextOptions;
+}): Promise<string>;
+export declare function promptConfirm(options: PromptGateOptions<boolean> & {
+    readonly clack: ClackConfirmOptions;
+}): Promise<boolean>;
+export declare function isPromptCancel(value: unknown): value is symbol;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE7F,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,MAAM,GAAG,iBAAiB,GAAG,SAAS,GAAG,qBAAqB,CAAC;AAEtG,MAAM,WAAW,iBAAiB,CAAC,KAAK;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9F,MAAM,MAAM,YAAY,CAAC,KAAK,IAAI,MAAM,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC;AACjF,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAE,iBAAiB,CAAC,KAAK,CAAM,GAAG,kBAAkB,CAkBpG;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAuB5I;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3H;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAKnI;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D"}

package/dist/prompts/index.js

@@ -0,0 +1,78 @@
+import { confirm, isCancel, text } from "@clack/prompts";
+import { createCliError } from "../errors/index.js";
+import { detectTerminalCapabilities } from "../terminal/index.js";
+export function evaluatePromptGate(options = {}) {
+    const terminal = options.terminal ?? (options.jsonMode === undefined ? detectTerminalCapabilities() : detectTerminalCapabilities({ jsonMode: options.jsonMode }));
+    if (options.jsonMode === true || terminal.jsonMode) {
+        return blocked("json", "Prompts are disabled in JSON output mode.");
+    }
+    if (options.nonInteractive === true || options.defaults === true || options.yes === true) {
+        return blocked("non-interactive", "Prompts are disabled for explicit non-interactive flows.");
+    }
+    if (typeof options.command === "object" && options.command.interactions?.ttyPrompt === false) {
+        return blocked("tty-prompt-disabled", "Command metadata declares that TTY prompts are disabled.");
+    }
+    if (terminal.ci) {
+        return blocked("ci", "Prompts are disabled in CI environments.");
+    }
+    if (!terminal.stdinIsTTY || !terminal.stdoutIsTTY) {
+        return blocked("non-tty", "Prompts are disabled when stdin or stdout is not a TTY.");
+    }
+    return Object.freeze({ allowed: true });
+}
+export async function resolvePromptValue(options) {
+    if (options.value !== undefined) {
+        return options.value;
+    }
+    const gate = evaluatePromptGate(options);
+    if (!gate.allowed) {
+        if (options.defaultValue !== undefined) {
+            return options.defaultValue;
+        }
+        throw createPromptBlockedError(options, gate);
+    }
+    const value = await options.prompt();
+    if (isPromptCancel(value)) {
+        throw createCliError({
+            command: commandName(options.command),
+            kind: "prompt-cancelled",
+            operation: `prompt ${options.promptName ?? "value"}`,
+            likelyCause: "The interactive prompt was cancelled.",
+            suggestedNextAction: "Retry with a flag or config value instead of relying on an interactive prompt.",
+            category: "usage"
+        });
+    }
+    return value;
+}
+export async function promptText(options) {
+    return resolvePromptValue({
+        ...options,
+        prompt: () => text(options.clack)
+    });
+}
+export async function promptConfirm(options) {
+    return resolvePromptValue({
+        ...options,
+        prompt: () => confirm(options.clack)
+    });
+}
+export function isPromptCancel(value) {
+    return isCancel(value);
+}
+function createPromptBlockedError(options, gate) {
+    return createCliError({
+        command: commandName(options.command),
+        kind: "prompt-blocked",
+        operation: `prompt ${options.promptName ?? "value"}`,
+        likelyCause: gate.message,
+        suggestedNextAction: "Provide the value with flags or config, or rerun in an interactive terminal.",
+        category: "usage"
+    });
+}
+function blocked(reason, message) {
+    return Object.freeze({ allowed: false, reason, message });
+}
+function commandName(command) {
+    return typeof command === "string" ? command : command?.name ?? "<prompt>";
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

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

package/dist/redaction/index.d.ts

@@ -0,0 +1,10 @@
+export declare const redactionPlaceholder = "[REDACTED]";
+export interface RedactionOptions {
+    readonly placeholder?: string;
+    readonly sensitiveKeys?: readonly string[];
+}
+export type RedactedStructuredValue = Readonly<Record<string, unknown>>;
+export declare function redactText(value: string, options?: RedactionOptions): string;
+export declare function redactStructuredValue(value: Readonly<Record<string, unknown>>, options?: RedactionOptions): RedactedStructuredValue;
+export declare function isSensitiveKey(key: string, sensitiveKeys?: readonly string[]): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/redaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/redaction/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AA0BxE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAKhF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAE,gBAAqB,GAAG,uBAAuB,CAEvI;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,GAAE,SAAS,MAAM,EAAyB,GAAG,OAAO,CAG5G"}

package/dist/redaction/index.js

@@ -0,0 +1,83 @@
+export const redactionPlaceholder = "[REDACTED]";
+const directTokenPatterns = Object.freeze([
+    /\b(sk-ant-api03-[A-Za-z0-9_-]{40,})\b/g,
+    /\b(sk-(?:proj-|svcacct-|admin-)?[A-Za-z0-9_-]{20,})\b/g,
+    /\b(gh[pousr]_[A-Za-z0-9_]{30,}|github_pat_[A-Za-z0-9_]{40,})\b/g,
+    /\b((?:AKIA|ASIA)[0-9A-Z]{16})\b/g,
+    /\b(eyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,})\b/g
+]);
+const bearerPattern = /\b(Bearer\s+)([A-Za-z0-9._-]{20,})\b/gi;
+const assignmentPattern = /\b((?:[A-Za-z][A-Za-z0-9_-]*[_-])?(?:api[_-]?key|access[_-]?token|refresh[_-]?token|secret|password|credential)\s*[:=]\s*["']?)([A-Za-z0-9_./+=-]{12,})(["']?)/gi;
+const defaultSensitiveKeys = Object.freeze([
+    "apiKey",
+    "apikey",
+    "accessToken",
+    "refreshToken",
+    "authorization",
+    "credential",
+    "password",
+    "privateKey",
+    "secret",
+    "token"
+]);
+export function redactText(value, options = {}) {
+    const placeholder = options.placeholder ?? redactionPlaceholder;
+    const directRedacted = directTokenPatterns.reduce((text, pattern) => text.replace(pattern, placeholder), value);
+    const bearerRedacted = directRedacted.replace(bearerPattern, (_match, prefix) => `${prefix}${placeholder}`);
+    return bearerRedacted.replace(assignmentPattern, (_match, prefix, _secret, suffix) => `${prefix}${placeholder}${suffix}`);
+}
+export function redactStructuredValue(value, options = {}) {
+    return redactRecord(value, options, new WeakMap());
+}
+export function isSensitiveKey(key, sensitiveKeys = defaultSensitiveKeys) {
+    const normalized = normalizeKey(key);
+    return sensitiveKeys.some((sensitiveKey) => normalizeKey(sensitiveKey) === normalized);
+}
+function redactValue(value, options, key, seen) {
+    if (key && isSensitiveKey(key, options.sensitiveKeys) && value !== undefined && value !== null) {
+        return options.placeholder ?? redactionPlaceholder;
+    }
+    if (typeof value === "string") {
+        return redactText(value, options);
+    }
+    if (Array.isArray(value)) {
+        const existing = seen.get(value);
+        if (existing) {
+            return existing;
+        }
+        const copy = [];
+        seen.set(value, copy);
+        for (const item of value) {
+            copy.push(redactValue(item, options, undefined, seen));
+        }
+        return Object.freeze(copy);
+    }
+    if (isRecord(value)) {
+        return redactRecord(value, options, seen);
+    }
+    return value;
+}
+function redactRecord(value, options, seen) {
+    const existing = seen.get(value);
+    if (existing && isRecord(existing)) {
+        return existing;
+    }
+    const copy = {};
+    seen.set(value, copy);
+    for (const entryKey of Object.keys(value)) {
+        const entryValue = value[entryKey];
+        copy[entryKey] = redactValue(entryValue, options, entryKey, seen);
+    }
+    return Object.freeze(copy);
+}
+function normalizeKey(key) {
+    return key.replace(/[^a-z0-9]/gi, "").toLowerCase();
+}
+function isRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=index.js.map

package/dist/redaction/index.js.map

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

package/dist/registry/index.d.ts

@@ -0,0 +1,25 @@
+import type { CommandMetadata, DefinitionMetadata, TopicMetadata } from "../metadata/index.js";
+export interface CommandRegistry {
+    readonly topics: readonly TopicMetadata[];
+    readonly commands: readonly CommandMetadata[];
+}
+export interface CommandRegistryDefinitionGroups {
+    readonly topics?: readonly TopicMetadata[];
+    readonly commands?: readonly CommandMetadata[];
+}
+export type CommandRegistryInput = readonly DefinitionMetadata[] | CommandRegistryDefinitionGroups;
+export interface CommandRegistryValidationIssue {
+    readonly path: string;
+    readonly message: string;
+}
+export declare class CommandRegistryValidationError extends TypeError {
+    readonly issues: readonly CommandRegistryValidationIssue[];
+    constructor(issues: readonly CommandRegistryValidationIssue[]);
+}
+export declare function createCommandRegistry(input: CommandRegistryInput): Readonly<CommandRegistry>;
+export declare function validateCommandRegistry(registry: CommandRegistry): void;
+export declare function findCommand(registry: CommandRegistry, nameOrAlias: string): CommandMetadata | undefined;
+export declare function findTopic(registry: CommandRegistry, nameOrAlias: string): TopicMetadata | undefined;
+export declare function listCommands(registry: CommandRegistry): readonly CommandMetadata[];
+export declare function listTopics(registry: CommandRegistry): readonly TopicMetadata[];
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAElB,aAAa,EACd,MAAM,sBAAsB,CAAC;AAK9B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAChD;AAED,MAAM,MAAM,oBAAoB,GAAG,SAAS,kBAAkB,EAAE,GAAG,+BAA+B,CAAC;AAEnG,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,8BAA+B,SAAQ,SAAS;IAC3D,QAAQ,CAAC,MAAM,EAAE,SAAS,8BAA8B,EAAE,CAAC;gBAE/C,MAAM,EAAE,SAAS,8BAA8B,EAAE;CAK9D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,QAAQ,CAAC,eAAe,CAAC,CAI5F;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAevE;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAIvG;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEnG;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,eAAe,EAAE,CAElF;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,aAAa,EAAE,CAE9E"}