@rawsql-ts/ddl-docs-cli 0.2.2

package/dist/src/cli.js

@@ -0,0 +1,264 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCli = runCli;
+const node_path_1 = __importDefault(require("node:path"));
+const generate_1 = require("./commands/generate");
+const prune_1 = require("./commands/prune");
+const ddlInputDedupe_1 = require("./utils/ddlInputDedupe");
+const DEFAULT_DDL_DIRECTORY = 'ztd/ddl';
+const DEFAULT_OUT_DIR = node_path_1.default.join('ztd', 'docs', 'tables');
+/**
+ * Runs ddl-docs-cli command dispatch and executes generate/prune subcommands.
+ *
+ * @param argv Command-line arguments without the node executable and script path.
+ * @returns A promise that resolves when command execution completes.
+ * Side effects include console output and filesystem writes/removals via subcommands.
+ */
+async function runCli(argv) {
+    const [command, ...rest] = argv;
+    if (!command || command === '--help' || command === '-h') {
+        printHelp('all');
+        return;
+    }
+    if (command === 'help') {
+        const target = rest[0];
+        if (!target) {
+            printHelp('all');
+            return;
+        }
+        if (target === 'generate' || target === 'prune') {
+            printHelp(target);
+            return;
+        }
+        throw new Error(`Unknown command for help: ${target}`);
+    }
+    if (command === 'generate') {
+        const options = parseGenerateOptions(rest);
+        if (!options) {
+            return;
+        }
+        await (0, generate_1.runGenerateDocs)(options);
+        return;
+    }
+    if (command === 'prune') {
+        const options = parsePruneOptions(rest);
+        if (!options) {
+            return;
+        }
+        await (0, prune_1.runPruneDocs)(options);
+        return;
+    }
+    throw new Error(`Unknown command: ${command}`);
+}
+function parseGenerateOptions(args) {
+    const options = {
+        ddlDirectories: [],
+        ddlFiles: [],
+        ddlGlobs: [],
+        extensions: ['.sql'],
+        outDir: DEFAULT_OUT_DIR,
+        includeIndexes: true,
+        strict: false,
+        dialect: 'postgres',
+        columnOrder: 'definition',
+        labelSeparator: undefined,
+        locale: undefined,
+        dictionaryPath: undefined,
+        configPath: undefined,
+        defaultSchema: undefined,
+        searchPath: undefined,
+    };
+    let currentInstance = '';
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--ddl-instance') {
+            currentInstance = readRequiredValue(args, ++index, '--ddl-instance');
+            continue;
+        }
+        if (arg === '--ddl-dir') {
+            options.ddlDirectories.push({ path: readRequiredValue(args, ++index, '--ddl-dir'), instance: currentInstance });
+            continue;
+        }
+        if (arg === '--ddl-file') {
+            options.ddlFiles.push({ path: readRequiredValue(args, ++index, '--ddl-file'), instance: currentInstance });
+            continue;
+        }
+        if (arg === '--ddl') {
+            options.ddlFiles.push({ path: readRequiredValue(args, ++index, '--ddl'), instance: currentInstance });
+            continue;
+        }
+        if (arg === '--ddl-glob') {
+            options.ddlGlobs.push({ path: readRequiredValue(args, ++index, '--ddl-glob'), instance: currentInstance });
+            continue;
+        }
+        if (arg === '--extensions') {
+            options.extensions = parseExtensions(readRequiredValue(args, ++index, '--extensions'));
+            continue;
+        }
+        if (arg === '--out-dir') {
+            options.outDir = readRequiredValue(args, ++index, '--out-dir');
+            continue;
+        }
+        if (arg === '--config') {
+            options.configPath = readRequiredValue(args, ++index, '--config');
+            continue;
+        }
+        if (arg === '--dictionary') {
+            options.dictionaryPath = readRequiredValue(args, ++index, '--dictionary');
+            continue;
+        }
+        if (arg === '--locale') {
+            options.locale = readRequiredValue(args, ++index, '--locale');
+            continue;
+        }
+        if (arg === '--default-schema') {
+            options.defaultSchema = readRequiredValue(args, ++index, '--default-schema');
+            continue;
+        }
+        if (arg === '--search-path') {
+            options.searchPath = parseCsvList(readRequiredValue(args, ++index, '--search-path'));
+            continue;
+        }
+        if (arg === '--no-index') {
+            options.includeIndexes = false;
+            continue;
+        }
+        if (arg === '--strict') {
+            options.strict = true;
+            continue;
+        }
+        if (arg === '--column-order') {
+            const value = readRequiredValue(args, ++index, '--column-order');
+            if (value !== 'definition' && value !== 'name') {
+                throw new Error('--column-order must be "definition" or "name".');
+            }
+            options.columnOrder = value;
+            continue;
+        }
+        if (arg === '--label-separator') {
+            options.labelSeparator = readRequiredValue(args, ++index, '--label-separator');
+            continue;
+        }
+        if (arg === '--filter-pg-dump') {
+            options.filterPgDump = true;
+            continue;
+        }
+        if (arg === '--help' || arg === '-h') {
+            printHelp('generate');
+            return null;
+        }
+        throw new Error(`Unknown option for generate: ${arg}`);
+    }
+    if (options.ddlDirectories.length === 0 && options.ddlFiles.length === 0 && options.ddlGlobs.length === 0) {
+        options.ddlDirectories = [{ path: DEFAULT_DDL_DIRECTORY, instance: '' }];
+    }
+    options.ddlDirectories = (0, ddlInputDedupe_1.dedupeDdlInputsByInstanceAndPath)(options.ddlDirectories);
+    options.ddlFiles = (0, ddlInputDedupe_1.dedupeDdlInputsByInstanceAndPath)(options.ddlFiles);
+    options.ddlGlobs = (0, ddlInputDedupe_1.dedupeDdlInputsByInstanceAndPath)(options.ddlGlobs);
+    options.extensions = dedupe(options.extensions);
+    return options;
+}
+function parsePruneOptions(args) {
+    const options = {
+        outDir: DEFAULT_OUT_DIR,
+        dryRun: false,
+        pruneOrphans: false,
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--out-dir') {
+            options.outDir = readRequiredValue(args, ++index, '--out-dir');
+            continue;
+        }
+        if (arg === '--dry-run') {
+            options.dryRun = true;
+            continue;
+        }
+        if (arg === '--prune-orphans') {
+            options.pruneOrphans = true;
+            continue;
+        }
+        if (arg === '--help' || arg === '-h') {
+            printHelp('prune');
+            return null;
+        }
+        throw new Error(`Unknown option for prune: ${arg}`);
+    }
+    return options;
+}
+function readRequiredValue(args, index, optionName) {
+    const value = args[index];
+    if (!value || value.startsWith('--')) {
+        throw new Error(`Missing value for ${optionName}`);
+    }
+    return value;
+}
+function parseExtensions(rawValue) {
+    const tokens = rawValue
+        .split(',')
+        .map((entry) => entry.trim())
+        .filter(Boolean)
+        .map((entry) => (entry.startsWith('.') ? entry : `.${entry}`))
+        .map((entry) => entry.toLowerCase());
+    if (tokens.length === 0) {
+        throw new Error('Expected at least one extension value.');
+    }
+    return tokens;
+}
+function parseCsvList(rawValue) {
+    return rawValue
+        .split(',')
+        .map((entry) => entry.trim())
+        .filter(Boolean)
+        .map((entry) => entry.replace(/^"|"$/g, '').toLowerCase());
+}
+function dedupe(values) {
+    return Array.from(new Set(values));
+}
+function printHelp(target) {
+    const generateHelp = `ddl-docs generate [options]
+  --ddl-instance <name>   DB instance name for subsequent --ddl-dir/--ddl-file/--ddl-glob (repeatable)
+  --ddl-dir <directory>   Recursively scan DDL files under directory (repeatable)
+  --ddl-file <file>       Include explicit DDL file (repeatable)
+  --ddl <file>            Alias of --ddl-file
+  --ddl-glob <pattern>    Glob pattern for DDL files (repeatable)
+  --extensions <list>     Comma-separated extensions (default: .sql)
+  --out-dir <directory>   Output root directory (default: ztd/docs/tables)
+  --config <path>         Optional ztd.config.json path
+  --dictionary <path>     Optional column dictionary json
+  --locale <code>         Dictionary locale (fallback: LANG -> en -> first)
+  --default-schema <name> Override default schema for unqualified tables
+  --search-path <list>    Comma-separated schema search path
+  --no-index              Skip schema/table index page generation
+  --strict                Exit non-zero when warnings exist
+  --column-order <mode>   Column order: definition|name (default: definition)
+  --label-separator <pat> Regex to split comment into Label+Comment columns (if omitted, no Label column)
+  --filter-pg-dump        Strip GRANT/REVOKE/OWNER TO/SET/\\connect statements from pg_dump output
+`;
+    const pruneHelp = `ddl-docs prune [options]
+  --out-dir <directory>   Output root directory (default: ztd/docs/tables)
+  --dry-run               Print deletion targets without deleting files
+  --prune-orphans         Also prune generated markdown not listed in manifest
+`;
+    if (target === 'generate') {
+        console.log(generateHelp);
+        return;
+    }
+    if (target === 'prune') {
+        console.log(pruneHelp);
+        return;
+    }
+    console.log(`ddl-docs <command> [options]
+
+Commands:
+  generate               Generate markdown docs from DDL
+  prune                  Remove stale generated markdown docs
+  help [command]         Show help for all commands or one command
+
+${generateHelp}
+${pruneHelp}`);
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/commands/generate.d.ts

@@ -0,0 +1,5 @@
+import type { GenerateDocsOptions } from '../types';
+/**
+ * Generates markdown docs and metadata files from DDL inputs.
+ */
+export declare function runGenerateDocs(options: GenerateDocsOptions): void;

package/dist/src/commands/generate.js

@@ -0,0 +1,266 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGenerateDocs = runGenerateDocs;
+const node_path_1 = __importDefault(require("node:path"));
+const dictionary_1 = require("../analyzer/dictionary");
+const columnConcepts_1 = require("../analyzer/columnConcepts");
+const config_1 = require("../config");
+const snapshotTableDocs_1 = require("../parser/snapshotTableDocs");
+const columnPages_1 = require("../render/columnPages");
+const indexPages_1 = require("../render/indexPages");
+const referencesPage_1 = require("../render/referencesPage");
+const tableMarkdown_1 = require("../render/tableMarkdown");
+const manifest_1 = require("../state/manifest");
+const ddlInputDedupe_1 = require("../utils/ddlInputDedupe");
+const fs_1 = require("../utils/fs");
+const pgDumpFilter_1 = require("../utils/pgDumpFilter");
+const io_1 = require("../utils/io");
+const GENERATOR_VERSION = '1.0.0';
+/**
+ * Generates markdown docs and metadata files from DDL inputs.
+ */
+function runGenerateDocs(options) {
+    var _a, _b;
+    const normalizedDirectories = normalizeDdlInputs(options.ddlDirectories);
+    const normalizedFiles = normalizeDdlInputs(options.ddlFiles);
+    const normalizedGlobs = normalizeDdlInputs(options.ddlGlobs);
+    if (normalizedDirectories.length === 0 && normalizedFiles.length === 0 && normalizedGlobs.length === 0) {
+        throw new Error('At least one DDL input is required via --ddl-dir, --ddl-file, or --ddl-glob.');
+    }
+    const mergedFiles = [...normalizedFiles];
+    for (const globInput of normalizedGlobs) {
+        for (const p of (0, fs_1.expandGlobPatterns)([globInput.path])) {
+            mergedFiles.push({ path: p, instance: (_a = globInput.instance) !== null && _a !== void 0 ? _a : '' });
+        }
+    }
+    const uniqueFiles = (0, ddlInputDedupe_1.dedupeDdlInputsByInstanceAndPath)(mergedFiles);
+    const rawSources = (0, fs_1.collectSqlFiles)(normalizedDirectories, uniqueFiles, options.extensions);
+    const sources = options.filterPgDump
+        ? rawSources.map((s) => ({ ...s, sql: (0, pgDumpFilter_1.filterPgDump)(s.sql) }))
+        : rawSources;
+    if (options.filterPgDump) {
+        for (const source of sources) {
+            if (source.sql.trim().length === 0) {
+                throw new Error(`No schema DDL remained after --filter-pg-dump for input: ${source.path}.`);
+            }
+        }
+    }
+    if (sources.length === 0) {
+        throw new Error('No SQL files were discovered from the provided inputs.');
+    }
+    const schemaSettings = (0, config_1.resolveSchemaSettings)(options.configPath, options.defaultSchema, options.searchPath);
+    const snapshot = (0, snapshotTableDocs_1.snapshotTableDocs)(sources, schemaSettings, { columnOrder: options.columnOrder });
+    if (snapshot.tables.length === 0) {
+        throw new Error('No table definitions were detected in the supplied DDL.');
+    }
+    const dictionary = (0, dictionary_1.loadDictionary)(options.dictionaryPath);
+    const locale = (0, dictionary_1.resolveLocale)(options.locale, dictionary);
+    const analysis = (0, columnConcepts_1.analyzeColumns)(snapshot.tables, { locale, dictionary });
+    const referenceSuggestions = buildReferenceSuggestions(snapshot.tables);
+    const allSuggestions = [...analysis.suggestions, ...referenceSuggestions].sort((a, b) => a.sql.localeCompare(b.sql));
+    const tableSuggestSet = new Set(allSuggestions.map((item) => `${item.schema}.${item.table}`));
+    const generatedFiles = [];
+    const tableOutputs = [];
+    const columnOutputs = [];
+    const nameMap = {};
+    const suggestionsByTable = groupSuggestionsByTable(allSuggestions);
+    for (const table of snapshot.tables) {
+        const outputPath = (0, tableMarkdown_1.tableDocPath)(options.outDir, table.schemaSlug, table.tableSlug);
+        (0, fs_1.ensureDirectory)(node_path_1.default.dirname(outputPath));
+        const tableSuggestions = (_b = suggestionsByTable.get(`${table.schema}.${table.table}`)) !== null && _b !== void 0 ? _b : {
+            columnCommentSql: [],
+            foreignKeySql: [],
+        };
+        (0, io_1.writeTextFileNormalized)(outputPath, (0, tableMarkdown_1.renderTableMarkdown)(table, tableSuggestions, { labelSeparator: options.labelSeparator }));
+        generatedFiles.push(outputPath);
+        tableOutputs.push(outputPath);
+        nameMap[`${table.schema}.${table.table}`] = `${table.schemaSlug}/${table.tableSlug}.md`;
+    }
+    if (options.includeIndexes) {
+        const indexPages = (0, indexPages_1.renderIndexPages)(options.outDir, snapshot.tables, analysis.findings, tableSuggestSet);
+        for (const page of indexPages) {
+            (0, fs_1.ensureDirectory)(node_path_1.default.dirname(page.path));
+            (0, io_1.writeTextFileNormalized)(page.path, page.content);
+            generatedFiles.push(page.path);
+            tableOutputs.push(page.path);
+        }
+    }
+    const columnPages = (0, columnPages_1.renderColumnPages)(options.outDir, analysis.observed, analysis.findings);
+    for (const page of columnPages) {
+        (0, fs_1.ensureDirectory)(node_path_1.default.dirname(page.path));
+        (0, io_1.writeTextFileNormalized)(page.path, page.content);
+        generatedFiles.push(page.path);
+        columnOutputs.push(page.path);
+    }
+    const referencesPage = (0, referencesPage_1.renderReferencesPage)(options.outDir, snapshot.tables);
+    (0, fs_1.ensureDirectory)(node_path_1.default.dirname(referencesPage.path));
+    (0, io_1.writeTextFileNormalized)(referencesPage.path, referencesPage.content);
+    generatedFiles.push(referencesPage.path);
+    tableOutputs.push(referencesPage.path);
+    const metaDir = node_path_1.default.join(options.outDir, '_meta');
+    (0, fs_1.ensureDirectory)(metaDir);
+    const warningsJsonPath = node_path_1.default.join(metaDir, 'warnings.json');
+    const warningsMdPath = node_path_1.default.join(metaDir, 'warnings.md');
+    const findingsJsonPath = node_path_1.default.join(metaDir, 'findings.json');
+    const findingsMdPath = node_path_1.default.join(metaDir, 'findings.md');
+    const snapshotPath = node_path_1.default.join(metaDir, 'snapshot.json');
+    const observedPath = node_path_1.default.join(metaDir, 'observed-column-dictionary.json');
+    const suggestedPath = node_path_1.default.join(metaDir, 'suggested.sql');
+    (0, io_1.writeTextFileNormalized)(warningsJsonPath, JSON.stringify(snapshot.warnings, null, 2));
+    (0, io_1.writeTextFileNormalized)(warningsMdPath, renderWarningsMarkdown(snapshot.warnings));
+    (0, io_1.writeTextFileNormalized)(findingsJsonPath, JSON.stringify(analysis.findings, null, 2));
+    (0, io_1.writeTextFileNormalized)(findingsMdPath, renderFindingsMarkdown(analysis.findings));
+    (0, io_1.writeTextFileNormalized)(snapshotPath, JSON.stringify(snapshot.tables, null, 2));
+    (0, io_1.writeTextFileNormalized)(observedPath, JSON.stringify(analysis.observed, null, 2));
+    (0, io_1.writeTextFileNormalized)(suggestedPath, renderSuggestedSql(allSuggestions));
+    generatedFiles.push(warningsJsonPath, warningsMdPath, findingsJsonPath, findingsMdPath, snapshotPath, observedPath, suggestedPath);
+    const manifest = (0, manifest_1.writeManifest)({
+        outDir: options.outDir,
+        generatorVersion: GENERATOR_VERSION,
+        dialect: options.dialect,
+        optionsForHash: {
+            dialect: options.dialect,
+            locale,
+            includeIndexes: options.includeIndexes,
+            columnOrder: options.columnOrder,
+            strict: options.strict,
+            extensions: options.extensions,
+            ddlDirectories: normalizedDirectories,
+            ddlFiles: uniqueFiles,
+            ddlGlobs: normalizedGlobs,
+        },
+        nameMap,
+        tableOutputs,
+        columnOutputs,
+    });
+    const totalIssues = snapshot.warnings.length + analysis.findings.length;
+    if (options.strict && totalIssues > 0) {
+        throw new Error(`Strict mode failed: ${totalIssues} issues found.`);
+    }
+}
+function normalizeDdlInputs(inputs) {
+    return inputs
+        .map((entry) => {
+        var _a;
+        if (typeof entry === 'string') {
+            return { path: entry, instance: '' };
+        }
+        return { path: entry.path, instance: (_a = entry.instance) !== null && _a !== void 0 ? _a : '' };
+    })
+        .filter((entry) => Boolean(entry.path));
+}
+function groupSuggestionsByTable(suggestions) {
+    var _a;
+    const map = new Map();
+    for (const suggestion of suggestions) {
+        const key = `${suggestion.schema}.${suggestion.table}`;
+        const bucket = (_a = map.get(key)) !== null && _a !== void 0 ? _a : { columnCommentSql: [], foreignKeySql: [] };
+        if (suggestion.kind === 'column_comment') {
+            bucket.columnCommentSql.push(suggestion.sql);
+        }
+        else {
+            bucket.foreignKeySql.push(suggestion.sql);
+        }
+        map.set(key, bucket);
+    }
+    for (const [key, bucket] of map.entries()) {
+        map.set(key, {
+            columnCommentSql: Array.from(new Set(bucket.columnCommentSql)).sort(),
+            foreignKeySql: Array.from(new Set(bucket.foreignKeySql)).sort(),
+        });
+    }
+    return map;
+}
+function renderWarningsMarkdown(warnings) {
+    const lines = [];
+    lines.push('# Warnings');
+    lines.push('');
+    if (warnings.length === 0) {
+        lines.push('- None');
+        lines.push('');
+        return lines.join('\n');
+    }
+    for (const warning of warnings) {
+        lines.push(`- [${warning.kind}] ${warning.message}`);
+        lines.push(`  - source: ${warning.source.filePath}${warning.source.statementIndex != null ? `#${warning.source.statementIndex}` : ''}`);
+        lines.push(`  - statement: ${warning.statementPreview}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function renderFindingsMarkdown(findings) {
+    const lines = [];
+    lines.push('# Findings');
+    lines.push('');
+    if (findings.length === 0) {
+        lines.push('- None');
+        lines.push('');
+        return lines.join('\n');
+    }
+    for (const finding of findings) {
+        lines.push(`- [${finding.kind}] (${finding.severity}) ${finding.message}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function renderSuggestedSql(suggestions) {
+    const lines = [];
+    lines.push('-- suggested: v1 (not applied)');
+    if (suggestions.length === 0) {
+        lines.push('-- none');
+        return lines.join('\n');
+    }
+    for (const suggestion of suggestions.sort((a, b) => a.sql.localeCompare(b.sql))) {
+        lines.push(suggestion.sql);
+    }
+    return lines.join('\n');
+}
+function buildReferenceSuggestions(tables) {
+    var _a, _b;
+    const dedupe = new Set();
+    const suggestions = [];
+    for (const table of tables) {
+        for (const reference of table.outgoingReferences) {
+            if (reference.source !== 'suggested') {
+                continue;
+            }
+            const key = `${reference.fromTableKey}|${reference.fromColumns.join(',')}|${reference.targetTableKey}|${reference.targetColumns.join(',')}`;
+            if (dedupe.has(key)) {
+                continue;
+            }
+            dedupe.add(key);
+            const tableKeyParts = reference.fromTableKey.split('.');
+            const schema = (_a = tableKeyParts[0]) !== null && _a !== void 0 ? _a : '';
+            const tableName = (_b = tableKeyParts[1]) !== null && _b !== void 0 ? _b : '';
+            if (!schema || !tableName) {
+                continue;
+            }
+            suggestions.push({
+                kind: 'foreign_key',
+                schema,
+                table: tableName,
+                column: reference.fromColumns.join(','),
+                sql: `ALTER TABLE ${quoteQualifiedName(reference.fromTableKey)} ADD FOREIGN KEY (${reference.fromColumns
+                    .map((column) => quoteIdentifier(column))
+                    .join(', ')}) REFERENCES ${quoteQualifiedName(reference.targetTableKey)}(${reference.targetColumns
+                    .map((column) => quoteIdentifier(column))
+                    .join(', ')});`,
+            });
+        }
+    }
+    return suggestions.sort((a, b) => a.sql.localeCompare(b.sql));
+}
+function quoteQualifiedName(value) {
+    return value
+        .split('.')
+        .map((part) => quoteIdentifier(part))
+        .join('.');
+}
+function quoteIdentifier(value) {
+    const normalized = value.replace(/^"|"$/g, '');
+    return `"${normalized.replace(/"/g, '""')}"`;
+}
+//# sourceMappingURL=generate.js.map

package/dist/src/commands/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/commands/generate.ts"],"names":[],"mappings":";;;;;AAsBA,0CA4IC;AAlKD,0DAA6B;AAC7B,uDAAuE;AACvE,+DAA4D;AAC5D,sCAAkD;AAClD,mEAAgE;AAChE,uDAA0D;AAC1D,qDAAwD;AACxD,6DAAgE;AAChE,2DAA4E;AAE5E,gDAAkD;AAElD,4DAA2E;AAC3E,oCAAmF;AACnF,wDAAqD;AACrD,oCAAsD;AAEtD,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAElC;;GAEG;AACH,SAAgB,eAAe,CAAC,OAA4B;;IAC1D,MAAM,qBAAqB,GAAG,kBAAkB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACzE,MAAM,eAAe,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7D,MAAM,eAAe,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE7D,IAAI,qBAAqB,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvG,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IAED,MAAM,WAAW,GAAe,CAAC,GAAG,eAAe,CAAC,CAAC;IACrD,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,IAAA,uBAAkB,EAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACrD,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAA,SAAS,CAAC,QAAQ,mCAAI,EAAE,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,MAAM,WAAW,GAAG,IAAA,iDAAgC,EAAC,WAAW,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,IAAA,oBAAe,EAAC,qBAAqB,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3F,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY;QAClC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,IAAA,2BAAY,EAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAC,UAAU,CAAC;IACf,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CACb,4DAA4D,MAAM,CAAC,IAAI,GAAG,CAC3E,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,cAAc,GAAG,IAAA,8BAAqB,EAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5G,MAAM,QAAQ,GAAG,IAAA,qCAAiB,EAAC,OAAO,EAAE,cAAc,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAClG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,2BAAc,EAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,IAAA,0BAAa,EAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,IAAA,+BAAc,EAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACzE,MAAM,oBAAoB,GAAG,yBAAyB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxE,MAAM,cAAc,GAAG,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,GAAG,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAE9F,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,cAAc,CAAC,CAAC;IAEnE,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,IAAA,4BAAY,EAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACnF,IAAA,oBAAe,EAAC,mBAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QAC1C,MAAM,gBAAgB,GAAG,MAAA,kBAAkB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,mCAAI;YACnF,gBAAgB,EAAE,EAAE;YACpB,aAAa,EAAE,EAAE;SAClB,CAAC;QACF,IAAA,4BAAuB,EAAC,UAAU,EAAE,IAAA,mCAAmB,EAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;QAC9H,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,SAAS,KAAK,CAAC;IAC1F,CAAC;IAED,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAA,6BAAgB,EAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;QACzG,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAA,oBAAe,EAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACzC,IAAA,4BAAuB,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACjD,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,IAAA,+BAAiB,EAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5F,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAA,oBAAe,EAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,IAAA,4BAAuB,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACjD,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,cAAc,GAAG,IAAA,qCAAoB,EAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7E,IAAA,oBAAe,EAAC,mBAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,IAAA,4BAAuB,EAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACrE,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACzC,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAEvC,MAAM,OAAO,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,IAAA,oBAAe,EAAC,OAAO,CAAC,CAAC;IACzB,MAAM,gBAAgB,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAC7D,MAAM,cAAc,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACzD,MAAM,gBAAgB,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAC7D,MAAM,cAAc,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,iCAAiC,CAAC,CAAC;IAC3E,MAAM,aAAa,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAE1D,IAAA,4BAAuB,EAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtF,IAAA,4BAAuB,EAAC,cAAc,EAAE,sBAAsB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnF,IAAA,4BAAuB,EAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtF,IAAA,4BAAuB,EAAC,cAAc,EAAE,sBAAsB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnF,IAAA,4BAAuB,EAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAChF,IAAA,4BAAuB,EAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAClF,IAAA,4BAAuB,EAAC,aAAa,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC,CAAC;IAC3E,cAAc,CAAC,IAAI,CACjB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,CACd,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAA,wBAAa,EAAC;QAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,gBAAgB,EAAE,iBAAiB;QACnC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,cAAc,EAAE;YACd,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM;YACN,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,cAAc,EAAE,qBAAqB;YACrC,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,eAAe;SAC1B;QACD,OAAO;QACP,YAAY;QACZ,aAAa;KACd,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxE,IAAI,OAAO,CAAC,MAAM,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,uBAAuB,WAAW,gBAAgB,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAgC;IAC1D,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;;QACb,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACvC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAA,KAAK,CAAC,QAAQ,mCAAI,EAAE,EAAE,CAAC;IAC9D,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,uBAAuB,CAC9B,WAA6B;;IAE7B,MAAM,GAAG,GAAG,IAAI,GAAG,EAA8B,CAAC;IAClD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,GAAG,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACvD,MAAM,MAAM,GAAG,MAAA,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,mCAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3E,IAAI,UAAU,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACzC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC5C,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACvB,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1C,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE;YACX,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE;YACrE,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE;SAChE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAmI;IACjK,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxI,KAAK,CAAC,IAAI,CAAC,kBAAkB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAoE;IAClG,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,IAAI,MAAM,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,kBAAkB,CAAC,WAA6B;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC7C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,yBAAyB,CAAC,MAA8J;;IAC/L,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;YACjD,IAAI,SAAS,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACrC,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,YAAY,IAAI,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,cAAc,IAAI,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5I,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,SAAS;YACX,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,MAAM,aAAa,GAAG,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,MAAA,aAAa,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,MAAA,aAAa,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC1B,SAAS;YACX,CAAC;YACD,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,aAAa;gBACnB,MAAM;gBACN,KAAK,EAAE,SAAS;gBAChB,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;gBACvC,GAAG,EAAE,eAAe,kBAAkB,CAAC,SAAS,CAAC,YAAY,CAAC,qBAAqB,SAAS,CAAC,WAAW;qBACrG,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;qBACxC,IAAI,CAAC,IAAI,CAAC,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC,aAAa;qBACjG,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;qBACxC,IAAI,CAAC,IAAI,CAAC,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;SACpC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AAC/C,CAAC"}

package/dist/src/commands/prune.d.ts

@@ -0,0 +1,2 @@
+import type { PruneDocsOptions } from '../types';
+export declare function runPruneDocs(options: PruneDocsOptions): void;

package/dist/src/commands/prune.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPruneDocs = runPruneDocs;
+const manifest_1 = require("../state/manifest");
+function runPruneDocs(options) {
+    const result = (0, manifest_1.pruneManagedFiles)(options.outDir, options.dryRun, options.pruneOrphans);
+    if (result.removed.length === 0) {
+        console.log(`No managed files were found in ${options.outDir}`);
+        return;
+    }
+    const mode = result.dryRun ? 'Dry-run candidates' : 'Pruned';
+    console.log(`${mode}: ${result.removed.length} files in ${options.outDir}`);
+    for (const file of result.removed) {
+        console.log(` - ${file}`);
+    }
+}
+//# sourceMappingURL=prune.js.map

package/dist/src/commands/prune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.js","sourceRoot":"","sources":["../../../src/commands/prune.ts"],"names":[],"mappings":";;AAGA,oCAWC;AAdD,gDAAsD;AAGtD,SAAgB,YAAY,CAAC,OAAyB;IACpD,MAAM,MAAM,GAAG,IAAA,4BAAiB,EAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACvF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,kCAAkC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAChE,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,KAAK,MAAM,CAAC,OAAO,CAAC,MAAM,aAAa,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5E,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedSchemaSettings } from './types';
+/**
+ * Resolves default schema and search path from CLI options and optional ztd config.
+ */
+export declare function resolveSchemaSettings(explicitConfigPath: string | undefined, cliDefaultSchema: string | undefined, cliSearchPath: string[] | undefined): ResolvedSchemaSettings;