@zmice/zc 0.2.0 → 0.2.2

package/vendor/packages/platform-claude/dist/index.js

@@ -0,0 +1,250 @@
+import { attachPlanMetadata, describeAsset, prefixArtifacts, } from "@zmice/platform-core";
+export const platformName = "claude";
+export const packageName = "@zmice/platform-claude";
+export const templateFiles = {
+    claude: "CLAUDE.md",
+};
+export const capability = {
+    platform: platformName,
+    namespace: "zc",
+    surfaces: ["entry-file", "commands-dir", "agents-dir"],
+    entryFile: {
+        fileName: templateFiles.claude,
+    },
+    commands: {
+        relativeDir: "commands",
+        fileExtension: ".md",
+    },
+    agents: {
+        relativeDir: "agents",
+        fileExtension: ".md",
+    },
+};
+function createCapability(scope) {
+    const relativeDir = (dir) => (scope === "project" ? `.claude/${dir}` : dir);
+    return {
+        ...capability,
+        commands: {
+            ...capability.commands,
+            relativeDir: relativeDir("commands"),
+        },
+        agents: {
+            ...capability.agents,
+            relativeDir: relativeDir("agents"),
+        },
+    };
+}
+function selectMatchedAssetsByKind(manifest, kind) {
+    return selectMatchedAssets(manifest).filter((asset) => asset.kind === kind);
+}
+function selectMatchedAssets(manifest) {
+    return manifest.assets.filter((asset) => asset.platforms.includes(platformName));
+}
+function renderAssetList(assets) {
+    if (assets.length === 0) {
+        return "- 尚未匹配到任何工具包资产。";
+    }
+    return assets
+        .map((asset) => `- \`${asset.kind}\` \`${asset.id}\`: ${describeAsset(asset)}`)
+        .join("\n");
+}
+function renderClaudeFile(manifestSource, assets, skippedSkills) {
+    const commandCount = assets.filter((asset) => asset.kind === "command").length;
+    const agentCount = assets.filter((asset) => asset.kind === "agent").length;
+    return `# Claude Code 工作流入口
+
+这是安装到 Claude Code 的薄入口文件。
+
+它负责三件事：
+
+1. 给出统一任务开始方式
+2. 说明固定 workflow 的选路规则
+3. 指向 \`.claude/commands\`、\`.claude/agents\` 里的详细内容
+
+## 核心规则
+
+- 默认先判断任务属于哪条 workflow，再决定入口
+- Claude Code 侧的统一命令语义通过自定义 slash command 承接
+- 中文优先，技术契约保持原样
+- 证据先于断言，完成前必须验证
+- 第一版不伪造 Claude 官方未明确给出的独立 skills 安装面
+
+## 固定 workflow
+
+### 1. product-analysis
+- 入口：\`/zc-product-analysis\`
+- 适用：需求模糊、范围和验收标准未收敛
+
+### 2. full-delivery
+- 入口：\`/zc-sdd-tdd\`
+- 适用：新功能、较大改动、完整交付
+
+### 3. bugfix
+- 入口：\`/zc-debug\`
+- 适用：Bug、失败测试、异常行为
+
+### 4. review-closure
+- 入口：\`/zc-quality-review\`
+- 适用：已有改动，需要审查与反馈收敛
+
+### 5. docs-release
+- 入口：\`/zc-doc\` 或 \`/zc-ship\`
+- 适用：文档、ADR、发布说明、上线准备
+
+### 6. investigation
+- 入口：\`/zc-onboard\` 或 \`/zc-ctx-health\`
+- 适用：陌生代码库、上下文失焦、技术摸底
+
+## 推荐开始方式
+
+- 不确定走哪条线：先用 \`/zc-start\`
+- 需求模糊：进 \`/zc-product-analysis\`
+- 已确认是完整交付：进 \`/zc-sdd-tdd\`
+- 明确是 bug：进 \`/zc-debug\`
+
+## 最常用入口速查
+
+- 做新需求但范围还没收敛：\`/zc-product-analysis\`
+- 进入完整交付主流程：\`/zc-sdd-tdd\`
+- 修 bug：\`/zc-debug\`
+- 做代码审查和反馈收敛：\`/zc-quality-review\`
+- 补文档或发布说明：\`/zc-doc\`
+- 陌生项目先摸底：\`/zc-onboard\` 或 \`/zc-ctx-health\`
+
+## 详细内容在哪里
+
+- commands：查看 \`.claude/commands/zc-*.md\`
+- agents：查看 \`.claude/agents/zc-*.md\`
+- 如果入口页不足以判断，就先打开对应 command 或 agent 再继续
+
+## 已安装能力
+
+- 清单来源：\`${manifestSource}\`
+- 匹配到的资产：${assets.length}
+- commands：${commandCount} 个
+- agents：${agentCount} 个
+- 未生成的 skill 资产：${skippedSkills.length} 个
+
+${renderAssetList(assets)}
+`;
+}
+function renderYamlFrontmatter(fields) {
+    const lines = ["---"];
+    for (const [key, value] of Object.entries(fields)) {
+        if (value === undefined) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            if (value.length === 0) {
+                continue;
+            }
+            lines.push(`${key}:`);
+            for (const entry of value) {
+                lines.push(`  - ${JSON.stringify(entry)}`);
+            }
+            continue;
+        }
+        lines.push(`${key}: ${JSON.stringify(value)}`);
+    }
+    lines.push("---");
+    return `${lines.join("\n")}\n`;
+}
+function renderMarkdownCommandFile(options) {
+    return `${renderYamlFrontmatter({
+        name: options.name,
+        description: options.description,
+    })}\n${options.body.trim()}\n`;
+}
+function renderMarkdownAgentFile(options) {
+    return `${renderYamlFrontmatter({
+        name: options.name,
+        description: options.description,
+        tools: options.tools,
+    })}\n${options.body.trim()}\n`;
+}
+function stripKindPrefix(value) {
+    return value.replace(/^(command|skill|agent)[:-]/, "");
+}
+function toNamespacedSlug(asset) {
+    const assetName = "name" in asset && typeof asset.name === "string" ? asset.name : undefined;
+    const base = (assetName ?? stripKindPrefix(asset.id))
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/-{2,}/g, "-")
+        .replace(/^-|-$/g, "");
+    return `zc-${base || stripKindPrefix(asset.id)}`;
+}
+function toScopedRelativeDir(scope, relativeDir) {
+    return scope === "project" ? `.claude/${relativeDir}` : relativeDir;
+}
+function renderCommandArtifacts(scope, assets) {
+    const relativeDir = toScopedRelativeDir(scope, capability.commands.relativeDir);
+    return assets.map((asset) => {
+        const slug = toNamespacedSlug(asset);
+        return {
+            path: `${relativeDir}/${slug}.md`,
+            content: renderMarkdownCommandFile({
+                name: slug,
+                description: asset.summary ?? describeAsset(asset),
+                body: asset.body ?? `# ${describeAsset(asset)}\n`,
+            }),
+        };
+    });
+}
+function renderAgentArtifacts(scope, assets) {
+    const relativeDir = toScopedRelativeDir(scope, capability.agents.relativeDir);
+    return assets.map((asset) => {
+        const slug = toNamespacedSlug(asset);
+        const assetTools = "tools" in asset && Array.isArray(asset.tools) ? asset.tools : undefined;
+        return {
+            path: `${relativeDir}/${slug}.md`,
+            content: renderMarkdownAgentFile({
+                name: slug,
+                description: asset.summary ?? describeAsset(asset),
+                body: asset.body ?? `# ${describeAsset(asset)}\n`,
+                tools: assetTools,
+            }),
+        };
+    });
+}
+export function createClaudeGenerationPlan(manifest, options = {}) {
+    const matchedAssets = selectMatchedAssets(manifest);
+    const commandAssets = selectMatchedAssetsByKind(manifest, "command");
+    const agentAssets = selectMatchedAssetsByKind(manifest, "agent");
+    const skippedSkills = selectMatchedAssetsByKind(manifest, "skill");
+    const manifestSource = options.manifestSource ?? manifest.source ?? "toolkit-manifest";
+    const resolvedPackageName = options.packageName ?? packageName;
+    const scope = options.scope ?? "project";
+    const scopedCapability = createCapability(scope);
+    return attachPlanMetadata({
+        platform: platformName,
+        packageName: resolvedPackageName,
+        manifestSource,
+        matchedAssets,
+        capability: scopedCapability,
+        artifacts: [
+            {
+                path: templateFiles.claude,
+                content: renderClaudeFile(manifestSource, matchedAssets, skippedSkills),
+            },
+            ...renderCommandArtifacts(scope, commandAssets),
+            ...renderAgentArtifacts(scope, agentAssets),
+        ],
+    });
+}
+export function createClaudeInstallPlan(manifest, options) {
+    const scope = options.scope ?? "project";
+    const generationPlan = createClaudeGenerationPlan(manifest, {
+        ...options,
+        scope,
+    });
+    return attachPlanMetadata({
+        ...generationPlan,
+        destinationRoot: options.destinationRoot,
+        scope,
+        overwrite: options.overwrite ?? "error",
+        artifacts: prefixArtifacts(options.destinationRoot, generationPlan.artifacts),
+    });
+}
+//# sourceMappingURL=index.js.map

package/vendor/packages/platform-claude/dist/index.js.map

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

package/vendor/packages/platform-claude/dist/index.test.js

@@ -0,0 +1,81 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { capability, createClaudeGenerationPlan, createClaudeInstallPlan, packageName, platformName, templateFiles, } from "./index.js";
+const manifest = {
+    source: "toolkit-manifest",
+    assets: [
+        {
+            id: "skill:alpha",
+            kind: "skill",
+            platforms: ["claude"],
+            title: "Alpha skill",
+            summary: "Alpha skill summary",
+            body: "Alpha skill body",
+        },
+        {
+            id: "command:start",
+            kind: "command",
+            platforms: ["claude"],
+            name: "start",
+            title: "开始",
+            summary: "Start command summary",
+            body: "开始一个新任务。",
+        },
+        {
+            id: "agent:architect",
+            kind: "agent",
+            platforms: ["claude"],
+            name: "architect",
+            title: "架构师",
+            summary: "Architect agent summary",
+            body: "作为架构师执行任务。",
+            tools: ["read", "edit"],
+        },
+    ],
+};
+describe("@zmice/platform-claude scaffold", () => {
+    it("creates a project-scoped generation plan from toolkit assets", () => {
+        const plan = createClaudeGenerationPlan(manifest, { scope: "project" });
+        assert.equal(plan.platform, platformName);
+        assert.equal(plan.packageName, packageName);
+        assert.equal(plan.manifestSource, "toolkit-manifest");
+        assert.equal(plan.capability?.namespace, capability.namespace);
+        assert.deepEqual(plan.matchedAssets.map((asset) => asset.id), [
+            "skill:alpha",
+            "command:start",
+            "agent:architect",
+        ]);
+        assert.deepEqual(plan.artifacts.map((artifact) => artifact.path), [
+            templateFiles.claude,
+            ".claude/commands/zc-start.md",
+            ".claude/agents/zc-architect.md",
+        ]);
+        assert.ok(plan.artifacts[0]?.content.includes("Claude Code 工作流入口"));
+        assert.ok(plan.artifacts[0]?.content.includes("未生成的 skill 资产：1 个"));
+        assert.ok(plan.artifacts[1]?.content.includes('name: "zc-start"'));
+        assert.ok(plan.artifacts[2]?.content.includes('tools:'));
+    });
+    it("creates a project-scoped install plan with .claude directories", () => {
+        const plan = createClaudeInstallPlan(manifest, {
+            destinationRoot: "/tmp/claude-project",
+            scope: "project",
+        });
+        assert.deepEqual(plan.artifacts.map((artifact) => artifact.path), [
+            "/tmp/claude-project/CLAUDE.md",
+            "/tmp/claude-project/.claude/commands/zc-start.md",
+            "/tmp/claude-project/.claude/agents/zc-architect.md",
+        ]);
+    });
+    it("creates a global-scoped install plan with root commands/agents directories", () => {
+        const plan = createClaudeInstallPlan(manifest, {
+            destinationRoot: "/tmp/claude-home",
+            scope: "global",
+        });
+        assert.deepEqual(plan.artifacts.map((artifact) => artifact.path), [
+            "/tmp/claude-home/CLAUDE.md",
+            "/tmp/claude-home/commands/zc-start.md",
+            "/tmp/claude-home/agents/zc-architect.md",
+        ]);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/vendor/packages/platform-claude/dist/index.test.js.map

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

package/vendor/packages/platform-claude/dist/install.d.ts

@@ -0,0 +1,2 @@
+export { createClaudeInstallPlan, type InstallOptions, type InstallPlan, type ToolkitManifestLike, } from "./index.js";
+//# sourceMappingURL=install.d.ts.map

package/vendor/packages/platform-claude/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC"}

package/vendor/packages/platform-claude/dist/install.js

@@ -0,0 +1,2 @@
+export { createClaudeInstallPlan, } from "./index.js";
+//# sourceMappingURL=install.js.map

package/vendor/packages/platform-claude/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,GAIxB,MAAM,YAAY,CAAC"}

package/vendor/packages/platform-claude/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@zmice/platform-claude",
+  "private": true,
+  "version": "0.1.0",
+  "description": "Manifest-driven generation and install scaffolding for Claude Code platform artifacts",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./generate": {
+      "types": "./dist/generate.d.ts",
+      "default": "./dist/generate.js"
+    },
+    "./install": {
+      "types": "./dist/install.d.ts",
+      "default": "./dist/install.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "generate": "tsc -p tsconfig.json",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm run build && node --test dist/index.test.js",
+    "verify": "pnpm run lint && pnpm run test && pnpm run build && pnpm run generate"
+  },
+  "dependencies": {
+    "@zmice/platform-core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/vendor/packages/platform-claude/templates/.gitkeep

@@ -0,0 +1 @@
+

package/vendor/packages/platform-claude/templates/CLAUDE.md

@@ -0,0 +1 @@
+# Claude Code 平台入口模板

package/vendor/packages/platform-codex/dist/index.d.ts

@@ -1,15 +1,49 @@
-import { type GenerationPlan, type InstallPlan, type InstallPlanOptions, type PlatformArtifact, type ToolkitAssetLike, type ToolkitManifestLike } from "@zmice/platform-core";
+import { type GenerationPlan as BaseGenerationPlan, type InstallPlan as BaseInstallPlan, type InstallPlanOptions as BaseInstallPlanOptions, type PlatformArtifact, type ToolkitAssetLike as BaseToolkitAssetLike, type ToolkitManifestLike as BaseToolkitManifestLike } from "@zmice/platform-core";
 export interface GenerationOptions {
     readonly packageName?: string;
     readonly manifestSource?: string;
 }
+export type InstallScope = "project" | "global" | "dir";
+export type PlatformCapabilitySurface = "entry-file" | "skills-dir";
+export interface PlatformCapability {
+    readonly platform: typeof platformName;
+    readonly namespace: string;
+    readonly surfaces: readonly PlatformCapabilitySurface[];
+    readonly entryFile?: {
+        readonly fileName: string;
+    };
+    readonly skills?: {
+        readonly relativeDir: string;
+        readonly fileName: "SKILL.md";
+    };
+}
+export interface ToolkitAssetLike extends BaseToolkitAssetLike {
+    readonly name?: string;
+}
+export interface ToolkitManifestLike extends Omit<BaseToolkitManifestLike, "assets"> {
+    readonly assets: readonly ToolkitAssetLike[];
+}
+export interface GenerationPlan extends BaseGenerationPlan {
+    readonly matchedAssets: readonly ToolkitAssetLike[];
+    readonly capability: PlatformCapability;
+}
+export interface InstallPlan extends BaseInstallPlan {
+    readonly matchedAssets: readonly ToolkitAssetLike[];
+    readonly capability: PlatformCapability;
+    readonly scope: InstallScope;
+}
+export interface InstallPlanOptions extends Omit<BaseInstallPlanOptions, "overwrite"> {
+    readonly overwrite?: "error" | "force";
+    readonly scope?: InstallScope;
+}
 export type InstallOptions = GenerationOptions & InstallPlanOptions;
 export declare const platformName: "codex";
 export declare const packageName: "@zmice/platform-codex";
-export type { GenerationPlan, InstallPlan, PlatformArtifact, ToolkitAssetLike, ToolkitManifestLike, };
+export type { PlatformArtifact, };
 export declare const templateFiles: {
     readonly agents: "AGENTS.md";
 };
+export declare const capability: PlatformCapability;
 export declare function createCodexGenerationPlan(manifest: ToolkitManifestLike, options?: GenerationOptions): GenerationPlan;
 export declare function createCodexInstallPlan(manifest: ToolkitManifestLike, options: InstallOptions): InstallPlan;
 //# sourceMappingURL=index.d.ts.map

package/vendor/packages/platform-codex/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAEpE,eAAO,MAAM,YAAY,EAAG,OAAgB,CAAC;AAC7C,eAAO,MAAM,WAAW,EAAG,uBAAgC,CAAC;AAE5D,YAAY,EACV,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,CAAC;AAEF,eAAO,MAAM,aAAa;;CAEhB,CAAC;AAwBX,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,GAAE,iBAAsB,GAC9B,cAAc,CAiBhB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,cAAc,GACtB,WAAW,CAEb"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,IAAI,kBAAkB,EACzC,KAAK,WAAW,IAAI,eAAe,EACnC,KAAK,kBAAkB,IAAI,sBAAsB,EACjD,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,IAAI,oBAAoB,EAC7C,KAAK,mBAAmB,IAAI,uBAAuB,EACpD,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;AACxD,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAAG,YAAY,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,OAAO,YAAY,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACxD,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC;IAClF,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,QAAQ,CAAC,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACzC;AAED,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,QAAQ,CAAC,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAEpE,eAAO,MAAM,YAAY,EAAG,OAAgB,CAAC;AAC7C,eAAO,MAAM,WAAW,EAAG,uBAAgC,CAAC;AAE5D,YAAY,EACV,gBAAgB,GACjB,CAAC;AAEF,eAAO,MAAM,aAAa;;CAEhB,CAAC;AAEX,eAAO,MAAM,UAAU,EAAE,kBAWxB,CAAC;AA0OF,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,GAAE,iBAAsB,GAC9B,cAAc,CAsBhB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,cAAc,GACtB,WAAW,CA4Bb"}