@clidoc/core 0.1.0

package/dist/index.js

@@ -0,0 +1,326 @@
+import { createHash } from 'node:crypto';
+export * from './discovery.js';
+export * from './merge.js';
+export * from './docgen.js';
+export * from './completion.js';
+import { Ajv2020 } from 'ajv/dist/2020.js';
+import * as formatsModule from 'ajv-formats';
+import { parse as parseYaml } from 'yaml';
+import { schema } from './schema.js';
+import { logicalErrors } from './logical.js';
+/** Supported version of the vendored OpenCLI schema. */
+export const OPENCLI_VERSION = '1.0.0-alpha.14';
+/** Vendored JSON Schema used to validate OpenCLI documents. */
+export const openCliSchema = schema;
+const ajv = new Ajv2020({ allErrors: true, strict: false });
+formatsModule.default(ajv);
+const check = ajv.compile(schema);
+/** Validate against the exact vendored upstream JSON Schema, plus upstream's logical checks. */
+export function validate(document) {
+    const schemaValid = check(document);
+    if (!schemaValid) {
+        return {
+            valid: false,
+            errors: (check.errors ?? []).map((error) => `${error.instancePath || '/'} ${error.message ?? 'is invalid'}`),
+        };
+    }
+    const errors = logicalErrors(document);
+    return { valid: errors.length === 0, errors };
+}
+/** Parse JSON or YAML and reject documents that do not match the specification. */
+export function parse(input, options = {}) {
+    const looksLikeJson = /^\s*[{[]/.test(input);
+    const format = options.format ?? (looksLikeJson ? 'json' : 'yaml');
+    let document;
+    if (format === 'json') {
+        try {
+            document = JSON.parse(input);
+        }
+        catch (error) {
+            throw new Error(`Invalid OpenCLI JSON: ${error instanceof Error ? error.message : String(error)}`, {
+                cause: error,
+            });
+        }
+    }
+    else {
+        try {
+            document = parseYaml(input, { uniqueKeys: true });
+        }
+        catch (error) {
+            throw new Error(`Invalid OpenCLI YAML: ${error instanceof Error ? error.message : String(error)}`, {
+                cause: error,
+            });
+        }
+    }
+    const result = validate(document);
+    if (!result.valid)
+        throw new Error(`Invalid OpenCLI document: ${result.errors.join('; ')}`);
+    return document;
+}
+const heading = (level, text) => `${'#'.repeat(level)} ${text}\n\n`;
+const escapeCell = (value) => String(value).replace(/\|/g, '\\|').replace(/\r?\n/g, ' ');
+function code(value) {
+    const longest = Math.max(0, ...Array.from(value.matchAll(/`+/g), (match) => match[0].length));
+    const delim = '`'.repeat(longest + 1);
+    const padded = value.startsWith('`') || value.endsWith('`') ? ` ${value} ` : value;
+    return `${delim}${padded}${delim}`;
+}
+const values = (choices) => choices
+    .map((choice) => (choice.description ? `${choice.value} (${choice.description})` : String(choice.value)))
+    .join(', ');
+const details = (item) => {
+    const parts = [item.description ?? item.summary ?? ''];
+    if (item.aliases?.length)
+        parts.push(`Aliases: ${item.aliases.map(code).join(', ')}`);
+    if (item.variadic)
+        parts.push(`Variadic${item.minItems === undefined ? '' : ` (min ${item.minItems})`}${item.maxItems === undefined ? '' : ` (max ${item.maxItems})`}`);
+    if (item.choices?.length)
+        parts.push(`Choices: ${values(item.choices)}`);
+    if (item.default !== undefined)
+        parts.push(`Default: ${code(String(item.default))}`);
+    if (item.hint)
+        parts.push(`Hint: ${item.hint}`);
+    if (item.passthrough)
+        parts.push('Passthrough');
+    if (item.alternativeSources?.length)
+        parts.push(item.alternativeSources
+            .map((source) => `${source.type === '$ENV' ? 'Env' : 'File'}: ${code(source.property)}`)
+            .join(', '));
+    return parts.filter(Boolean).join('; ');
+};
+function table(headers, rows) {
+    if (!rows.length)
+        return '';
+    return `| ${headers.join(' | ')} |\n| ${headers.map(() => '---').join(' | ')} |\n${rows.map((row) => `| ${row.map(escapeCell).join(' | ')} |`).join('\n')}\n\n`;
+}
+function fenced(content, language = 'sh') {
+    const longest = Math.max(0, ...Array.from(content.matchAll(/`+/g), (match) => match[0].length));
+    const fence = '`'.repeat(Math.max(3, longest + 1));
+    return `${fence}${language}\n${content}\n${fence}\n\n`;
+}
+function placeholder(name, hint) {
+    const value = hint?.trim();
+    if (value?.startsWith('<') && value.endsWith('>'))
+        return value;
+    return `<${value || name}>`;
+}
+function repeatable(token, required) {
+    return required ? `${token} [${token}]...` : `[${token}]...`;
+}
+function renderArgumentUsage(arg) {
+    const token = placeholder(arg.name);
+    const required = Boolean(arg.required || (arg.minItems ?? 0) > 0);
+    if (arg.passthrough) {
+        const operand = `${token}${arg.variadic ? '...' : ''}`;
+        return required ? `-- ${operand}` : `[-- ${operand}]`;
+    }
+    if (arg.variadic)
+        return required ? `${token}...` : `[${token}...]`;
+    return required ? token : `[${token}]`;
+}
+function renderFlagUsage(flag) {
+    const token = `--${flag.name}${flag.type === 'boolean' ? '' : ` ${placeholder(flag.name, flag.hint)}`}`;
+    const required = Boolean(flag.required || (flag.minItems ?? 0) > 0);
+    if (flag.variadic)
+        return repeatable(token, required);
+    return required ? token : `[${token}]`;
+}
+function commandInvocation(name, binary) {
+    const parts = [];
+    const allParts = name.trim().split(/\s+/);
+    for (const part of allParts) {
+        if (part === '--' || ['<', '{', '['].some((marker) => part.includes(marker)))
+            break;
+        parts.push(part);
+    }
+    const relative = parts.join(' ');
+    const command = !binary || relative === binary || relative.startsWith(`${binary} `) ? relative : `${binary} ${relative}`;
+    return { command, syntax: allParts.slice(parts.length) };
+}
+function renderUsage(name, command, binary, globalFlags) {
+    const combinedFlags = new Map(globalFlags.map((flag) => [flag.name, flag]));
+    for (const flag of command.flags ?? [])
+        combinedFlags.set(flag.name, flag);
+    const flags = [...combinedFlags.values()].filter((flag) => !flag.hidden).map(renderFlagUsage);
+    const args = (command.args ?? []).map(renderArgumentUsage);
+    const invocation = commandInvocation(name, binary);
+    const legacyArgs = args.length
+        ? []
+        : invocation.syntax.filter((part) => !/^\[?flags\]?$/.test(part) && !/^\{commands?\}$/.test(part));
+    const legacyFlags = combinedFlags.size ? [] : invocation.syntax.filter((part) => /^\[?flags\]?$/.test(part));
+    const operands = [...legacyArgs, ...args];
+    const options = [...legacyFlags, ...flags];
+    const optionTerminated = (command.args ?? []).some((arg) => arg.passthrough) || legacyArgs.includes('--');
+    return (heading(3, 'Usage') +
+        fenced([invocation.command, ...(optionTerminated ? options : operands), ...(optionTerminated ? operands : options)].join(' ')));
+}
+function renderCommand(name, command, binary = '', globalFlags = []) {
+    let out = heading(2, name);
+    if (command.summary)
+        out += `${command.summary}\n\n`;
+    if (command.description)
+        out += `${command.description}\n\n`;
+    if (command.aliases?.length)
+        out += `Aliases: ${command.aliases.map(code).join(', ')}\n\n`;
+    if (command.kind === 'group')
+        out += 'Command group\n\n';
+    out += renderUsage(name, command, binary, globalFlags);
+    out += table(['Argument', 'Type', 'Required', 'Description'], (command.args ?? []).map((arg) => [
+        code(arg.name),
+        arg.type ?? 'string',
+        arg.required || (arg.minItems ?? 0) > 0 ? 'Yes' : 'No',
+        details(arg),
+    ]));
+    out += renderFlags(command.flags ?? []);
+    out += renderExitCodes(command.exitCodes ?? []);
+    if (command.examples?.length) {
+        out += heading(3, 'Examples');
+        for (const example of command.examples) {
+            if (example.title)
+                out += heading(4, example.title);
+            out += fenced(example.content);
+        }
+    }
+    return out;
+}
+function renderFlags(flags) {
+    return table(['Flag', 'Type', 'Required', 'Description'], flags
+        .filter((flag) => !flag.hidden)
+        .map((flag) => [
+        code(`--${flag.name}`),
+        flag.type,
+        flag.required || (flag.minItems ?? 0) > 0 ? 'Yes' : 'No',
+        details(flag),
+    ]));
+}
+function renderExitCodes(codes) {
+    return table(['Exit code', 'Status', 'Description'], codes.map((item) => [item.code, item.status, item.description ?? item.summary]));
+}
+function renderLicense(license) {
+    const label = license.url ? `[${license.name}](${license.url})` : license.name;
+    return `License: ${label}${license.spdxId ? ` (${license.spdxId})` : ''}\n\n`;
+}
+function renderContact(contact) {
+    const parts = [contact.name, contact.email, contact.url].filter(Boolean);
+    return `Contact: ${parts.join(' · ')}\n\n`;
+}
+function renderConfig(config) {
+    const rows = [];
+    if (config.json)
+        rows.push(['JSON', config.json]);
+    if (config.toml)
+        rows.push(['TOML', config.toml]);
+    if (config.yaml)
+        rows.push(['YAML', config.yaml]);
+    if (!rows.length)
+        return '';
+    return (heading(2, 'Configuration') +
+        table(['Format', 'Path'], rows.map(([format, path]) => [format, code(path)])));
+}
+/** Render the shared header both `renderMarkdown` and `generatePages`' landing page use. */
+function renderDocumentHeader(document) {
+    let out = heading(1, document.info.title);
+    if (document.info.summary)
+        out += `${document.info.summary}\n\n`;
+    if (document.info.description)
+        out += `${document.info.description}\n\n`;
+    out += `Binary: ${code(document.info.binary)} · Version: ${code(document.info.version)}\n\n`;
+    if (document.info.license)
+        out += renderLicense(document.info.license);
+    if (document.info.contact)
+        out += renderContact(document.info.contact);
+    if (document.install?.length)
+        out +=
+            heading(2, 'Installation') +
+                table(['Method', 'Command or URL', 'Description'], document.install.map((method) => [
+                    method.name,
+                    method.command ? code(method.command) : (method.url ?? ''),
+                    method.description ?? '',
+                ]));
+    if (document.global?.config)
+        out += renderConfig(document.global.config);
+    if (document.global?.flags?.length)
+        out += heading(2, 'Global flags') + renderFlags(document.global.flags);
+    if (document.global?.exitCodes?.length)
+        out += heading(2, 'Global exit codes') + renderExitCodes(document.global.exitCodes);
+    return out;
+}
+function assertDocument(document) {
+    const result = validate(document);
+    if (!result.valid)
+        throw new Error(`Invalid OpenCLI document: ${result.errors.join('; ')}`);
+}
+/** Render a complete Markdown reference, preserving spec-authored Markdown prose. */
+export function renderMarkdown(document) {
+    assertDocument(document);
+    let out = renderDocumentHeader(document);
+    for (const [name, command] of Object.entries(document.commands ?? {}).toSorted(([a], [b]) => a.localeCompare(b))) {
+        if (!command.hidden)
+            out += renderCommand(name, command, document.info.binary, document.global?.flags ?? []);
+    }
+    return out.trimEnd() + '\n';
+}
+/** Strip the leading `<binary> ` prefix commands are keyed with, e.g. `acme run` -> `run`. */
+function withoutBinaryPrefix(name, binary) {
+    if (binary && name.startsWith(`${binary} `)) {
+        const rest = name.slice(binary.length + 1).trim();
+        if (rest)
+            return rest;
+    }
+    return name;
+}
+/** Reserve `~` for deterministic names outside the readable namespace. */
+function commandRoute(name, binary) {
+    const display = withoutBinaryPrefix(name, binary);
+    const hasPrefix = !binary || name === `${binary} ${display}`;
+    if (hasPrefix && display.length <= 64 && /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(display))
+        return display;
+    // Hash UTF-16 code units to preserve distinctions even for lone surrogates.
+    const units = Buffer.allocUnsafe(name.length * 2);
+    for (let index = 0; index < name.length; index++)
+        units.writeUInt16BE(name.charCodeAt(index), index * 2);
+    const readable = display
+        .toLowerCase()
+        .normalize('NFKD')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 64) || 'command';
+    return `${readable}~${createHash('sha256').update(units).digest('hex')}`;
+}
+/** Produce a landing page and one page per visible command with safe, stable routes. */
+export function generatePages(document, options = {}) {
+    assertDocument(document);
+    const rawBase = (options.basePath ?? '').replace(/\\/g, '/');
+    const segments = rawBase.split('/').filter(Boolean);
+    if (segments.some((segment) => segment === '.' || segment === '..' || /%(?:2e|2f|5c)/i.test(segment)))
+        throw new Error('Invalid basePath segment');
+    const prefix = segments.length ? '/' + segments.map((segment) => encodeURIComponent(segment)).join('/') : '';
+    const pages = [];
+    const names = Object.keys(document.commands ?? {})
+        .filter((name) => !document.commands?.[name]?.hidden)
+        .toSorted((a, b) => a.localeCompare(b));
+    const routes = new Map(names.map((name) => [name, commandRoute(name, document.info.binary)]));
+    if (new Set(routes.values()).size !== routes.size)
+        throw new Error('Generated command routes collide');
+    let landing = renderDocumentHeader(document);
+    if (names.length)
+        landing +=
+            heading(2, 'Commands') +
+                names
+                    .map((name) => `- [${name.replace(/[[\]\\]/g, '\\$&')}](${`${prefix}/commands/${routes.get(name)}`})`)
+                    .join('\n') +
+                '\n\n';
+    pages.push({ id: 'index', title: document.info.title, path: prefix || '/', content: landing.trimEnd() + '\n' });
+    for (const name of names) {
+        const route = routes.get(name);
+        pages.push({
+            id: `command-${route}`,
+            title: name,
+            path: `${prefix}/commands/${route}`,
+            content: renderCommand(name, document.commands[name], document.info.binary, document.global?.flags ?? []).trimEnd() +
+                '\n',
+        });
+    }
+    return pages;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logical.d.ts

@@ -0,0 +1,9 @@
+import type { OpenCliDocument } from './types.js';
+/**
+ * Logical validations ported from upstream `validate/validate.go`, beyond what the JSON Schema
+ * can express: positional argument ordering, variadic/min/max constraints, `$FILE` alternative
+ * sources referencing a declared `global.config` file, duplicate flag names/aliases, and group
+ * commands carrying args or flags.
+ */
+export declare function logicalErrors(document: OpenCliDocument): string[];
+//# sourceMappingURL=logical.d.ts.map

package/dist/logical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logical.d.ts","sourceRoot":"","sources":["../src/logical.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAwC,MAAM,YAAY,CAAC;AAExF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,EAAE,CAWjE"}

package/dist/logical.js

@@ -0,0 +1,112 @@
+/**
+ * Logical validations ported from upstream `validate/validate.go`, beyond what the JSON Schema
+ * can express: positional argument ordering, variadic/min/max constraints, `$FILE` alternative
+ * sources referencing a declared `global.config` file, duplicate flag names/aliases, and group
+ * commands carrying args or flags.
+ */
+export function logicalErrors(document) {
+    const errors = [];
+    const definedConfigFiles = new Set();
+    if (document.global?.config?.json)
+        definedConfigFiles.add('json');
+    if (document.global?.config?.toml)
+        definedConfigFiles.add('toml');
+    if (document.global?.config?.yaml)
+        definedConfigFiles.add('yaml');
+    for (const [name, command] of Object.entries(document.commands ?? {})) {
+        validateCommand(name, command, definedConfigFiles, errors);
+    }
+    return errors;
+}
+function validateCommand(name, command, definedConfigFiles, errors) {
+    const base = `/commands/${name}`;
+    const args = command.args ?? [];
+    const flags = command.flags ?? [];
+    if (args.length > 0) {
+        validateArgumentOrdering(base, args, errors);
+        validateArgumentConstraints(base, args, errors);
+    }
+    if (flags.length > 0) {
+        validateFlagFileReferences(base, flags, definedConfigFiles, errors);
+        validateFlagConstraints(base, flags, errors);
+    }
+    if (command.kind === 'group') {
+        if (args.length > 0)
+            errors.push(`${base} group command cannot have arguments`);
+        if (flags.length > 0)
+            errors.push(`${base} group command cannot have flags`);
+    }
+}
+/** Ensures required positional args don't come after optional ones. */
+function validateArgumentOrdering(base, args, errors) {
+    let seenOptional = false;
+    for (const [i, arg] of args.entries()) {
+        const isRequired = arg.required === true;
+        if (seenOptional && isRequired) {
+            errors.push(`${base}/args/${i} required positional argument '${arg.name}' cannot come after optional arguments`);
+        }
+        if (!isRequired)
+            seenOptional = true;
+    }
+}
+/** Checks that minItems/maxItems are only used with variadic args, and min <= max. */
+function validateArgumentConstraints(base, args, errors) {
+    for (const [i, arg] of args.entries()) {
+        const path = `${base}/args/${i}`;
+        if ((arg.minItems !== undefined || arg.maxItems !== undefined) && !arg.variadic) {
+            const field = arg.minItems !== undefined ? 'minItems' : 'maxItems';
+            errors.push(`${path} argument '${arg.name}' has ${field} but is not variadic`);
+        }
+        if (arg.variadic && arg.minItems !== undefined && arg.maxItems !== undefined && arg.minItems > arg.maxItems) {
+            errors.push(`${path} argument '${arg.name}' has minItems (${arg.minItems}) greater than maxItems (${arg.maxItems})`);
+        }
+    }
+}
+/** Checks that `$FILE` alternative sources reference a file declared in global.config. */
+function validateFlagFileReferences(base, flags, definedConfigFiles, errors) {
+    for (const [i, flag] of flags.entries()) {
+        validateFileReferences(`${base}/flags/${i}`, 'flag', flag.name, flag.alternativeSources, definedConfigFiles, errors);
+    }
+}
+function validateFileReferences(path, itemType, itemName, altSources, definedConfigFiles, errors) {
+    for (const [j, source] of (altSources ?? []).entries()) {
+        if (source.type === '$FILE' && definedConfigFiles.size === 0) {
+            errors.push(`${path}/alternativeSources/${j} ${itemType} '${itemName}' references $FILE but no config files are defined in global.config`);
+        }
+    }
+}
+/** Checks for duplicate flag names/aliases and variadic+required/minItems/maxItems constraints. */
+function validateFlagConstraints(base, flags, errors) {
+    const seen = new Map();
+    for (const [i, flag] of flags.entries()) {
+        const path = `${base}/flags/${i}`;
+        const flagName = flag.name;
+        if (flagName) {
+            const prevIdx = seen.get(flagName);
+            if (prevIdx !== undefined) {
+                errors.push(`${path} duplicate flag name '${flagName}' (also defined at index ${prevIdx})`);
+            }
+            seen.set(flagName, i);
+            for (const alias of flag.aliases ?? []) {
+                if (!alias)
+                    continue;
+                const prevAliasIdx = seen.get(alias);
+                if (prevAliasIdx !== undefined) {
+                    errors.push(`${path}/aliases duplicate flag alias '${alias}' (already defined at index ${prevAliasIdx})`);
+                }
+                seen.set(alias, i);
+            }
+        }
+        if (flag.variadic && flag.required) {
+            errors.push(`${path} variadic flag '${flagName}' cannot be marked as required (variadic flags can be provided 0 or more times)`);
+        }
+        if ((flag.minItems !== undefined || flag.maxItems !== undefined) && !flag.variadic) {
+            const field = flag.minItems !== undefined ? 'minItems' : 'maxItems';
+            errors.push(`${path} flag '${flagName}' has ${field} but is not variadic`);
+        }
+        if (flag.variadic && flag.minItems !== undefined && flag.maxItems !== undefined && flag.minItems > flag.maxItems) {
+            errors.push(`${path} flag '${flagName}' has minItems (${flag.minItems}) greater than maxItems (${flag.maxItems})`);
+        }
+    }
+}
+//# sourceMappingURL=logical.js.map

package/dist/logical.js.map

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

package/dist/merge.d.ts

@@ -0,0 +1,44 @@
+import type { ArgumentItemObject, CommandItemObject, FlagItemObject, GlobalObject, InfoObject, InstallMethodItemObject, OpenCliDocument } from './types.js';
+/** A named array entry merged with a generated entry of the same name. */
+export type NamedOverride<T extends {
+    name: string;
+}> = Pick<T, 'name'> & Partial<Omit<T, 'name'>>;
+/** Metadata layered onto a generated command. */
+export type CommandOverride = Omit<Partial<CommandItemObject>, 'args' | 'flags'> & {
+    args?: NamedOverride<ArgumentItemObject>[];
+    flags?: NamedOverride<FlagItemObject>[];
+};
+/** Metadata layered onto the generated global settings. */
+export type GlobalOverride = Omit<Partial<GlobalObject>, 'config' | 'flags'> & {
+    config?: Partial<NonNullable<GlobalObject['config']>>;
+    flags?: NamedOverride<FlagItemObject>[];
+};
+/** Metadata layered onto the generated CLI identity. */
+export type InfoOverride = Omit<Partial<InfoObject>, 'license' | 'contact'> & {
+    license?: Partial<NonNullable<InfoObject['license']>>;
+    contact?: Partial<NonNullable<InfoObject['contact']>>;
+};
+/**
+ * Author-supplied additions layered onto a generated OpenCLI document by {@link mergeDocument}.
+ * Named flags and arguments require a name for matching, but their remaining fields may be
+ * supplied by the generated document. The merged result is validated before it is returned.
+ */
+export type DocumentOverrides = {
+    info?: InfoOverride;
+    install?: InstallMethodItemObject[];
+    global?: GlobalOverride;
+    commands?: Record<string, CommandOverride>;
+    [key: `x-${string}`]: unknown;
+};
+/**
+ * Return a new document with `overrides` deep-merged onto `base`. Plain objects merge
+ * recursively (so `info.license`, `global`, and individual commands can be extended without
+ * repeating the rest). Arrays in `overrides` replace the base array, except `examples` and
+ * `exitCodes`, which append, and `flags`/`args`, which are merged item-by-item matched by
+ * `name` (so an author can add e.g. `alternativeSources` to one generated flag without
+ * repeating the whole flag list). Commands not present in `base` are added as-is.
+ *
+ * Throws if the merged result fails OpenCLI schema validation, listing every problem found.
+ */
+export declare function mergeDocument(base: OpenCliDocument, overrides: DocumentOverrides): OpenCliDocument;
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,uBAAuB,EACvB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,0EAA0E;AAC1E,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AACnG,iDAAiD;AACjD,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG;IACjF,IAAI,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC;IAC3C,KAAK,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC;CACzC,CAAC;AACF,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtD,KAAK,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC;CACzC,CAAC;AACF,wDAAwD;AACxD,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC,GAAG;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;CACvD,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3C,CAAC,GAAG,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC;CAC/B,CAAC;AAuCF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,iBAAiB,GAAG,eAAe,CAMlG"}

package/dist/merge.js

@@ -0,0 +1,59 @@
+import { validate } from './index.js';
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Arrays under these keys are appended rather than replaced. */
+const APPEND_KEYS = new Set(['examples', 'exitCodes']);
+/** Arrays under these keys are merged item-by-item, matched by `name`. */
+const NAME_MERGE_KEYS = new Set(['flags', 'args']);
+/** Merge two arrays of `{ name: ... }` items (flags/args): match by `name`, append the rest. */
+function mergeNamedArray(base, override) {
+    const result = base.map((item) => ({ ...item }));
+    for (const item of override) {
+        const index = result.findIndex((entry) => entry.name === item.name);
+        if (index >= 0)
+            result[index] = mergeObjects(result[index], item);
+        else
+            result.push(item);
+    }
+    return result;
+}
+function mergeValue(key, base, override) {
+    if (override === undefined)
+        return base;
+    if (Array.isArray(base) && Array.isArray(override)) {
+        if (APPEND_KEYS.has(key))
+            return [...base, ...override];
+        if (NAME_MERGE_KEYS.has(key))
+            return mergeNamedArray(base, override);
+        return override;
+    }
+    if (isPlainObject(base) && isPlainObject(override))
+        return mergeObjects(base, override);
+    return override;
+}
+function mergeObjects(base, override) {
+    const result = { ...base };
+    for (const key of Object.keys(override))
+        result[key] = mergeValue(key, base[key], override[key]);
+    return result;
+}
+/**
+ * Return a new document with `overrides` deep-merged onto `base`. Plain objects merge
+ * recursively (so `info.license`, `global`, and individual commands can be extended without
+ * repeating the rest). Arrays in `overrides` replace the base array, except `examples` and
+ * `exitCodes`, which append, and `flags`/`args`, which are merged item-by-item matched by
+ * `name` (so an author can add e.g. `alternativeSources` to one generated flag without
+ * repeating the whole flag list). Commands not present in `base` are added as-is.
+ *
+ * Throws if the merged result fails OpenCLI schema validation, listing every problem found.
+ */
+export function mergeDocument(base, overrides) {
+    const merged = mergeObjects(base, overrides);
+    const result = merged;
+    const { valid, errors } = validate(result);
+    if (!valid)
+        throw new Error(`Invalid OpenCLI document after merge: ${errors.join('; ')}`);
+    return result;
+}
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA0CtC,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,iEAAiE;AACjE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AACvD,0EAA0E;AAC1E,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAEnD,gGAAgG;AAChG,SAAS,eAAe,CAAC,IAAe,EAAE,QAAmB;IAC3D,MAAM,MAAM,GAAI,IAAkC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IAChF,KAAK,MAAM,IAAI,IAAI,QAAqC,EAAE,CAAC;QACzD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,IAAI,KAAK,IAAI,CAAC;YAAE,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAE,EAAE,IAAI,CAAC,CAAC;;YAC9D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,GAAW,EAAE,IAAa,EAAE,QAAiB;IAC/D,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;QACxD,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACrE,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC;QAAE,OAAO,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACxF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,IAA6B,EAAE,QAAiC;IACpF,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IACpD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACjG,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,IAAqB,EAAE,SAA4B;IAC/E,MAAM,MAAM,GAAG,YAAY,CAAC,IAA0C,EAAE,SAAoC,CAAC,CAAC;IAC9G,MAAM,MAAM,GAAG,MAAoC,CAAC;IACpD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1F,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,2 @@
+export declare const schema: object;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,MAAM,EAAE,MA+apB,CAAC"}