@dommaker/harness 1.7.0 → 1.8.0

package/dist/cli/commands/scaffold.js

@@ -0,0 +1,263 @@
+"use strict";
+/**
+ * 脚手架落盘模块（harness#132，架构评审候选3）
+ *
+ * 一个决策只写一次：受管文件（managed file — harness 模板拥有正本、用户也可能
+ * 持有的落盘文件）在不在场、在场时算跳过还是算请用户手工合并、要不要建父目录、
+ * 打什么颜色的哪句话，全部收在本模块。此前这段判定复印在 init 6 处 + validate 2 处。
+ *
+ * 三态：
+ * - `created` 不在场 → 落盘模板正文
+ * - `exists`  在场 → 灰字告知跳过（**不细分内容是否等于模板**，内容比较是独立特性）
+ * - `manual`  在场 → 打印片段请用户手工合并
+ *
+ * 纪律：本模块不持有覆盖/跳过策略——「哪些文件要落」由命令层翻成 plan 列表传进来，
+ * 本模块只见 plan；模板正文住在 `scaffold-templates.ts`。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeScaffoldFs = void 0;
+exports.writeManagedFile = writeManagedFile;
+exports.runPlan = runPlan;
+exports.preCommitHookFile = preCommitHookFile;
+exports.prePushHookFile = prePushHookFile;
+exports.harnessCheckCiFile = harnessCheckCiFile;
+exports.customConstraintsFile = customConstraintsFile;
+exports.checkpointsFile = checkpointsFile;
+exports.resolutionsFile = resolutionsFile;
+exports.changelogFile = changelogFile;
+exports.contextDocFile = contextDocFile;
+exports.governanceWorkflowFile = governanceWorkflowFile;
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const nodeFs = __importStar(require("fs/promises"));
+const command_contract_1 = require("../command-contract");
+const scaffold_templates_1 = require("./scaffold-templates");
+exports.nodeScaffoldFs = {
+    async exists(target) {
+        try {
+            await nodeFs.access(target);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    async mkdir(dir) {
+        await nodeFs.mkdir(dir, { recursive: true });
+    },
+    async writeFile(target, content) {
+        await nodeFs.writeFile(target, content, 'utf-8');
+    },
+    async chmod(target, mode) {
+        await nodeFs.chmod(target, mode);
+    },
+};
+/**
+ * 落一个受管文件：判定 → 建目录 → 写盘 → 上色打印
+ */
+async function writeManagedFile(file, io, fs = exports.nodeScaffoldFs) {
+    const present = file.present ? await file.present() : await fs.exists(file.target);
+    if (!present) {
+        await fs.mkdir(path.dirname(file.target));
+        await fs.writeFile(file.target, file.content);
+        if (file.mode !== undefined)
+            await fs.chmod(file.target, file.mode);
+        (0, command_contract_1.log)(io, chalk_1.default.green(file.created));
+        return 'created';
+    }
+    if (file.onPresent.outcome === 'skip') {
+        (0, command_contract_1.log)(io, chalk_1.default.gray(file.onPresent.notice));
+        return 'exists';
+    }
+    (0, command_contract_1.log)(io, chalk_1.default.yellow(file.onPresent.notice));
+    for (const line of file.onPresent.detail ?? []) {
+        (0, command_contract_1.log)(io, chalk_1.default.gray(line));
+    }
+    (0, command_contract_1.log)(io, chalk_1.default.gray(file.onPresent.instruction));
+    (0, command_contract_1.log)(io);
+    (0, command_contract_1.log)(io, chalk_1.default.cyan(file.onPresent.snippet));
+    return 'manual';
+}
+/** 按顺序落一组受管文件 */
+async function runPlan(plan, io, fs = exports.nodeScaffoldFs) {
+    const outcomes = [];
+    for (const file of plan) {
+        outcomes.push(await writeManagedFile(file, io, fs));
+    }
+    return outcomes;
+}
+// ── 站点：init 的 7 处 + 原住 validate 的 2 处 ──────────────────────────
+/** .git/hooks/pre-commit（冲突片段 = 落盘正文去掉 shebang 头，逐字同源） */
+function preCommitHookFile(projectPath) {
+    return {
+        target: path.join(projectPath, '.git', 'hooks', 'pre-commit'),
+        content: (0, scaffold_templates_1.renderPreCommitHook)(),
+        created: '✅ 已创建 .git/hooks/pre-commit',
+        mode: 0o755,
+        onPresent: {
+            outcome: 'merge',
+            notice: '⚠️  .git/hooks/pre-commit 已存在',
+            instruction: '💡 请手动添加以下内容到文件末尾：',
+            snippet: scaffold_templates_1.PRE_COMMIT_SNIPPET,
+        },
+    };
+}
+/**
+ * .git/hooks/pre-push（harness#144 的第 9 站点，冲突片段与落盘正文逐字同源）
+ *
+ * 与 pre-commit 的分工：那道查暂存的（增量、快反馈），这道查整仓的（全量、兜底）。
+ * 本地 hook 是自检与提醒，门禁真正的落点仍是服务端 CI。
+ */
+function prePushHookFile(projectPath) {
+    return {
+        target: path.join(projectPath, '.git', 'hooks', 'pre-push'),
+        content: (0, scaffold_templates_1.renderPrePushHook)(),
+        created: '✅ 已创建 .git/hooks/pre-push',
+        mode: 0o755,
+        onPresent: {
+            outcome: 'merge',
+            notice: '⚠️  .git/hooks/pre-push 已存在',
+            instruction: '💡 请手动添加以下内容到文件末尾：',
+            snippet: scaffold_templates_1.PRE_PUSH_SNIPPET,
+        },
+    };
+}
+/**
+ * 服务端 CI 门禁站点（平台维度，harness#143）
+ *
+ * - `github` → `.github/workflows/harness-check.yml`；冲突判定宽于 target 自身：
+ *   工作流目录里已有任何 CI 配置就算冲突，片段是完整 workflow 正文（打印的即落盘的，#103 判据）
+ * - `gitlab` → `.gitlab-ci.yml`；冲突面就是该文件自身在场，片段是 harness 拥有的任务正文。
+ *   GitLab 没有「第二个 CI 文件位」，所以 `-g` 档的治理任务并入同一份正文
+ *   ——这也是 `governanceLevel` 只对 gitlab 形有意义的原因（GH 侧治理站是独立的
+ *   `governanceWorkflowFile`）。
+ *
+ * `none`（不接线）不进来：那是命令层的 plan 里没有这个站点，scaffold 不持有跳过策略。
+ */
+function harnessCheckCiFile(projectPath, platform, existingCiWorkflows, governanceLevel) {
+    if (platform === 'gitlab') {
+        const content = (0, scaffold_templates_1.renderGitLabCiFile)(governanceLevel);
+        return {
+            target: path.join(projectPath, '.gitlab-ci.yml'),
+            content,
+            created: '✅ 已创建 .gitlab-ci.yml',
+            onPresent: {
+                outcome: 'merge',
+                notice: '⚠️  .gitlab-ci.yml 已存在',
+                instruction: '💡 请手动添加以下内容到文件中：',
+                snippet: (0, scaffold_templates_1.renderGitLabCiJobs)(governanceLevel),
+            },
+        };
+    }
+    const target = path.join(projectPath, '.github', 'workflows', 'harness-check.yml');
+    return {
+        target,
+        content: scaffold_templates_1.HARNESS_CHECK_WORKFLOW,
+        created: '✅ 已创建 .github/workflows/harness-check.yml',
+        present: async () => existingCiWorkflows.length > 0,
+        onPresent: {
+            outcome: 'merge',
+            notice: '⚠️  检测到已存在的 CI 配置：',
+            detail: existingCiWorkflows.map(f => `  - .github/workflows/${f}`),
+            instruction: '💡 请手动添加以下内容到 jobs 中：',
+            snippet: scaffold_templates_1.HARNESS_CHECK_WORKFLOW,
+        },
+    };
+}
+/** .harness/custom-constraints.yml 示例 */
+function customConstraintsFile(projectPath) {
+    return {
+        target: path.join(projectPath, '.harness', 'custom-constraints.yml'),
+        content: scaffold_templates_1.CUSTOM_CONSTRAINTS_TEMPLATE,
+        created: '✅ 已创建自定义约束示例: custom-constraints.yml',
+        onPresent: { outcome: 'skip', notice: 'custom-constraints.yml 已存在' },
+    };
+}
+/** .harness/checkpoints.yml 示例（原住 validate.ts，路径约定与 validate 共用） */
+function checkpointsFile(projectPath) {
+    const target = path.join(projectPath, scaffold_templates_1.DEFAULT_CHECKPOINT_FILE);
+    return {
+        target,
+        content: (0, scaffold_templates_1.renderCheckpoints)(),
+        created: `✅ 已创建示例检查点文件: ${target}`,
+        onPresent: { outcome: 'skip', notice: 'checkpoints.yml 已存在，跳过' },
+    };
+}
+/** .harness/resolutions.json（RKB 狗粮 — 约束 → 已知解法映射，原住 validate.ts） */
+function resolutionsFile(projectPath) {
+    const target = path.join(projectPath, '.harness', 'resolutions.json');
+    return {
+        target,
+        content: (0, scaffold_templates_1.renderResolutions)(),
+        created: `✅ 已创建 Resolutions 文件: ${target}`,
+        onPresent: { outcome: 'skip', notice: 'resolutions.json 已存在，跳过' },
+    };
+}
+/** CHANGELOG.md 骨架 */
+function changelogFile(projectPath, format) {
+    return {
+        target: path.join(projectPath, 'CHANGELOG.md'),
+        content: (0, scaffold_templates_1.renderChangelog)(format),
+        created: '✅ 已创建 CHANGELOG.md',
+        onPresent: { outcome: 'skip', notice: 'CHANGELOG.md 已存在' },
+    };
+}
+/** `<dir>/CONTEXT.md` 骨架 */
+function contextDocFile(projectPath, dir) {
+    return {
+        target: path.join(projectPath, dir, 'CONTEXT.md'),
+        content: (0, scaffold_templates_1.renderContextDoc)(dir),
+        created: `✅ 已创建 ${dir}/CONTEXT.md`,
+        onPresent: { outcome: 'skip', notice: `${dir}/CONTEXT.md 已存在` },
+    };
+}
+/**
+ * .github/workflows/harness-governance.yml（治理 CI 面，仅 github 形）
+ *
+ * gitlab 形的治理任务并入 `.gitlab-ci.yml`（见 `harnessCheckCiFile`），无本站点。
+ */
+function governanceWorkflowFile(projectPath, level) {
+    return {
+        target: path.join(projectPath, '.github', 'workflows', 'harness-governance.yml'),
+        content: (0, scaffold_templates_1.renderGovernanceWorkflow)(level, 'github'),
+        created: '✅ 已创建 .github/workflows/harness-governance.yml',
+        onPresent: { outcome: 'skip', notice: 'harness-governance.yml 已存在' },
+    };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/cli/commands/scaffold.js.map

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

package/dist/cli/commands/security.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/security.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAkB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzF,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IACpD,aAAa;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,eAAe,EACxB,EAAE,GAAE,SAAqB,GACxB,OAAO,CAAC,aAAa,CAAC,CAyCxB;AAoBD;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,eAAe,EACxB,EAAE,GAAE,SAAqB,GACxB,OAAO,CAAC,aAAa,CAAC,CAkCxB"}
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/security.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAkB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzF,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IACpD,aAAa;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,eAAe,EACxB,EAAE,GAAE,SAAqB,GACxB,OAAO,CAAC,aAAa,CAAC,CA4CxB;AAoBD;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,eAAe,EACxB,EAAE,GAAE,SAAqB,GACxB,OAAO,CAAC,aAAa,CAAC,CAkCxB"}

package/dist/cli/commands/security.js

@@ -13,6 +13,7 @@ exports.auditDetails = auditDetails;
 const chalk_1 = __importDefault(require("chalk"));
 const security_1 = require("../../gates/security");
 const command_contract_1 = require("../command-contract");
+const gate_command_1 = require("../gate-command");
 /**
  * 执行安全门控
  */
@@ -26,29 +27,26 @@ async function security(options, io = command_contract_1.processIO) {
             ignoreWarnings: options.ignoreWarnings,
             ignoreDevDependencies: options.ignoreDevDeps,
         });
-        const result = await gate.scan({ projectPath, projectId: 'default' });
-        (0, command_contract_1.log)(io);
-        if (result.passed) {
-            (0, command_contract_1.log)(io, chalk_1.default.green('✅ 安全门控检查通过'));
-            if (result.details) {
-                (0, command_contract_1.log)(io, chalk_1.default.gray(`   critical: ${result.details.critical}, high: ${result.details.high}, moderate: ${result.details.moderate}, low: ${result.details.low}`));
-            }
-        }
-        else {
-            (0, command_contract_1.log)(io, chalk_1.default.red('❌ 安全门控检查失败'));
-            (0, command_contract_1.log)(io, chalk_1.default.red(`   ${result.message}`));
-            if (result.details?.vulnerabilities) {
-                (0, command_contract_1.log)(io);
-                result.details.vulnerabilities.forEach((v, i) => {
-                    const severityColor = getSeverityColor(v.severity);
-                    (0, command_contract_1.log)(io, severityColor(`  ${i + 1}. [${v.severity.toUpperCase()}] ${v.name}`));
-                    (0, command_contract_1.log)(io, chalk_1.default.gray(`     via: ${v.via}`));
-                });
-            }
-            (0, command_contract_1.log)(io, chalk_1.default.gray('\n   运行 harness security audit 查看详情'));
-            return { kind: 'fail', reason: `security gate denied (threshold ${options.severity || 'high'}): ${result.message}` };
-        }
-        return { kind: 'ok' };
+        const decision = await gate.evaluate({ projectPath });
+        return (0, gate_command_1.reportGateDecision)(io, {
+            gateId: 'security',
+            label: '安全门控',
+            onPass: (r) => r.details
+                ? [chalk_1.default.gray(`   critical: ${r.details.critical}, high: ${r.details.high}, moderate: ${r.details.moderate}, low: ${r.details.low}`)]
+                : [],
+            onFail: (r) => {
+                const lines = [chalk_1.default.gray(`   阈值: ${options.severity || 'high'}`)];
+                if (r.details?.vulnerabilities) {
+                    lines.push('');
+                    r.details.vulnerabilities.forEach((v, i) => {
+                        lines.push(getSeverityColor(v.severity)(`  ${i + 1}. [${v.severity.toUpperCase()}] ${v.name}`));
+                        lines.push(chalk_1.default.gray(`     via: ${v.via}`));
+                    });
+                }
+                lines.push(chalk_1.default.gray('\n   运行 harness security audit 查看详情'));
+                return lines;
+            },
+        }, decision);
     }
     catch (error) {
         (0, command_contract_1.log)(io);
@@ -84,7 +82,7 @@ async function auditDetails(options, io = command_contract_1.processIO) {
             severityThreshold: options.severity || 'low',
             scanCommand: options.scanCommand,
         });
-        const result = await gate.scan({ projectPath, projectId: 'default' });
+        const result = await gate.scan({ projectPath });
         if (result.passed && !result.details?.total) {
             (0, command_contract_1.log)(io, chalk_1.default.green('✅ 未发现安全漏洞'));
             return { kind: 'ok' };

package/dist/cli/commands/security.js.map

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

package/dist/cli/commands/spec-baseline-check.d.ts

@@ -24,8 +24,51 @@ export interface PrerequisiteResult {
  * 从 spec 内容中提取 Baseline/前置条件 section
  */
 export declare function extractBaselineSection(content: string): string[];
+/** package.json 依赖面的一次解析结果（失败态同样入库，不重试） */
+type DependencySnapshot = {
+    ok: true;
+    deps: Record<string, string>;
+} | {
+    ok: false;
+};
+/**
+ * 共享索引的驻留上限（#162，统一复审遗留项 3）：
+ * #146 把全仓源文件内容常驻一个 Map，排除面只有 node_modules/dist/隐藏目录与后缀，
+ * 无任何容量上限——峰值内存由 O(单文件) 变 O(全仓源码)，大 monorepo 会承担这个峰值。
+ * 超出任一上限即放弃驻留、回落逐文件流式读（峰值回到 O(单文件)），
+ * 正常规模仓仍保留「一次遍历」收益。
+ */
+export declare const SOURCE_INDEX_MAX_ENTRIES = 5000;
+export declare const SOURCE_INDEX_MAX_BYTES: number;
+/** 驻留上限（测试可注入小值走回落路径；生产一律缺省常量） */
+export interface SourceIndexLimits {
+    maxEntries: number;
+    maxBytes: number;
+}
+/**
+ * 一次 spec-baseline-check 运行内的取数面（工单 #146，母票 #140 A 票）：
+ * 全仓内容扫描、`package.json` 解析、同一落点的存在性探测各至多一遍，
+ * 逐条前置只在索引上重放判定——此前是「前置条件数 × 关键词数 × 源文件数」的逐条重扫。
+ *
+ * 懒建：没有任何前置需要某类数据时，该类读取一次都不发生（口径与改前一致）。
+ * 运行结束即弃，不跨命令、不扩 `RunEnv` 公共面（#140 triage 裁决 5）。
+ */
+interface BaselineIndex {
+    /**
+     * 内容含 keyword 的源文件数。上限内走驻留索引重放（一次运行全仓至多读一遍）；
+     * 超 SOURCE_INDEX_MAX_ENTRIES / SOURCE_INDEX_MAX_BYTES 即放弃驻留，
+     * 每个关键词回落逐文件流式读（#162：驻留条目数有上界，峰值 O(单文件)）。
+     */
+    countFilesContaining(keyword: string): number;
+    /** package.json 的 dependencies + devDependencies 合并面 */
+    dependencies(): DependencySnapshot;
+    /** 绝对路径是否在世（同一落点一次运行内只 stat 一次） */
+    exists(fullPath: string): boolean;
+}
+export declare function createBaselineIndex(projectPath: string, limits?: SourceIndexLimits): BaselineIndex;
 /**
  * spec-baseline-check CLI 命令
  */
 export declare function specBaselineCheck(specPath: string, options?: SpecBaselineCheckOptions, io?: CommandIO): Promise<CommandResult>;
+export {};
 //# sourceMappingURL=spec-baseline-check.d.ts.map

package/dist/cli/commands/spec-baseline-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-baseline-check.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/spec-baseline-check.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAA4B,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGnG,MAAM,WAAW,wBAAwB;IACvC,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,eAAe;AACf,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS;IACT,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA4ChE;AAyPD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,wBAA6B,EACtC,EAAE,GAAE,SAAqB,GACxB,OAAO,CAAC,aAAa,CAAC,CA4CxB"}
+{"version":3,"file":"spec-baseline-check.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/spec-baseline-check.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAA4B,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGnG,MAAM,WAAW,wBAAwB;IACvC,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,eAAe;AACf,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS;IACT,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA4ChE;AAMD,2CAA2C;AAC3C,KAAK,kBAAkB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAErF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,sBAAsB,QAAmB,CAAC;AAEvD,kCAAkC;AAClC,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,UAAU,aAAa;IACrB;;;;OAIG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9C,wDAAwD;IACxD,YAAY,IAAI,kBAAkB,CAAC;IACnC,mCAAmC;IACnC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,iBAA8F,GACrG,aAAa,CA8Ef;AAsPD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,wBAA6B,EACtC,EAAE,GAAE,SAAqB,GACxB,OAAO,CAAC,aAAa,CAAC,CA6CxB"}