claude-skills-cli 0.0.1

package/README.md

@@ -0,0 +1,455 @@
+# claude-skills-cli
+
+TypeScript CLI toolkit for creating, validating, and packaging Claude skills.
+
+**Status:** 🚧 In Development - See implementation plan below
+
+---
+
+## What This Is
+
+A portable command-line tool for managing Claude Agent Skills, inspired by tools like `create-next-app` and `create-vite`. Install once, use anywhere:
+
+```bash
+pnpx claude-skills-cli init --name my-skill --description "..."
+pnpx claude-skills-cli validate .claude/skills/my-skill
+pnpx claude-skills-cli package .claude/skills/my-skill
+```
+
+This replaces the Python scripts that were previously in project `.claude/scripts/` directories.
+
+---
+
+## Repository Structure (Planned)
+
+Following the **mcpick** pattern:
+
+```
+claude-skills-cli/
+├── package.json                     # CLI package config
+├── tsconfig.json                    # TypeScript ES modules config
+├── README.md                        # This file
+├── .gitignore                       # Ignore node_modules, dist, etc.
+├── .prettierrc                      # Code formatting
+├── .changeset/                      # Version management
+│   ├── README.md
+│   └── config.json
+├── src/
+│   ├── index.ts                     # CLI entry (#!/usr/bin/env node)
+│   ├── types.ts                     # TypeScript type definitions
+│   ├── commands/
+│   │   ├── init.ts                  # Create new skill structure
+│   │   ├── validate.ts              # Validate skill format
+│   │   └── package.ts               # Package skill to zip
+│   ├── core/
+│   │   ├── templates.ts             # SKILL.md templates as strings
+│   │   └── validator.ts             # Validation logic (class-based)
+│   └── utils/
+│       ├── fs.ts                    # File system helpers
+│       └── output.ts                # Emoji/formatting (chalk)
+├── templates/                       # Copied from devhub-crm
+│   ├── SKILL-TEMPLATE.md
+│   └── skill-structure/
+│       ├── README.md
+│       ├── references/
+│       ├── scripts/
+│       └── assets/
+├── docs/                            # Copied from devhub-crm
+│   ├── SKILLS-ARCHITECTURE.md
+│   ├── SKILL-DEVELOPMENT.md
+│   └── SKILL-EXAMPLES.md
+└── skills/                          # Portable example skills
+    └── skill-creator/               # Meta-skill from devhub-crm
+        ├── SKILL.md
+        └── references/
+```
+
+---
+
+## Files to Move from devhub-crm
+
+The `.claude/` directory was copied wholesale, but needs reorganization:
+
+### ✅ Keep and Move to Root:
+
+```
+devhub-crm/.claude/docs/             → claude-skills-cli/docs/
+devhub-crm/.claude/templates/        → claude-skills-cli/templates/
+devhub-crm/.claude/skills/skill-creator/  → claude-skills-cli/skills/skill-creator/
+```
+
+### ✅ Convert to TypeScript:
+
+```
+devhub-crm/.claude/scripts/init_skill.py      → src/commands/init.ts
+devhub-crm/.claude/scripts/validate_skill.py  → src/commands/validate.ts
+devhub-crm/.claude/scripts/package_skill.py   → src/commands/package.ts
+```
+
+### ❌ Delete (Not Needed):
+
+```
+devhub-crm/.claude/settings.local.json        # Project-specific
+devhub-crm/.claude/skills/database-patterns/  # Project-specific
+devhub-crm/.claude/TYPESCRIPT-CONVERSION-PROMPT.md  # Completed
+```
+
+---
+
+## package.json Configuration
+
+```json
+{
+  "name": "claude-skills-cli",
+  "version": "0.0.1",
+  "description": "CLI toolkit for creating and managing Claude Agent Skills",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "claude-skills-cli": "./dist/index.js"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node ./dist/index.js",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "pnpm run build && changeset publish"
+  },
+  "keywords": ["claude", "skills", "cli", "agent", "anthropic", "claude-code"],
+  "author": "Scott Spence",
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "chalk": "^5.3.0",
+    "archiver": "^7.0.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.7",
+    "@types/node": "^24.7.0",
+    "@types/archiver": "^6.0.0",
+    "prettier": "^3.6.2",
+    "typescript": "^5.9.3"
+  }
+}
+```
+
+---
+
+## tsconfig.json Configuration
+
+```json
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "strict": true,
+    "outDir": "./dist",
+    "sourceMap": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}
+```
+
+---
+
+## Dependencies Explained
+
+### Runtime Dependencies:
+
+- **@clack/prompts** - Interactive CLI prompts (like mcpick uses)
+- **chalk** - Terminal string styling and colors
+- **archiver** - Create zip files (replaces Python's zipfile)
+
+### Dev Dependencies:
+
+- **@changesets/cli** - Version management and changelog
+- **@types/node** - TypeScript types for Node.js
+- **@types/archiver** - TypeScript types for archiver
+- **prettier** - Code formatting
+- **typescript** - TypeScript compiler
+
+---
+
+## CLI Interface (Must Match Python Version)
+
+### Command: init
+
+```bash
+claude-skills init --name my-skill --description "What it does and when to use it"
+claude-skills init --path /custom/path/my-skill
+```
+
+**Creates:**
+
+- SKILL.md with YAML frontmatter
+- README.md
+- references/detailed-guide.md
+- scripts/example.py (executable)
+- assets/ directory
+
+**Output:**
+
+```
+✅ Skill created at: .claude/skills/my-skill
+
+Next steps:
+1. Edit .claude/skills/my-skill/SKILL.md with your skill instructions
+2. Add detailed documentation to references/
+3. Add executable scripts to scripts/
+4. Remove example files you don't need
+
+Validate with: claude-skills validate .claude/skills/my-skill
+```
+
+### Command: validate
+
+```bash
+claude-skills validate .claude/skills/my-skill
+claude-skills validate .claude/skills/my-skill --strict
+```
+
+**Checks:**
+
+- SKILL.md exists
+- YAML frontmatter format
+- Required fields (name, description)
+- Name format (kebab-case, max 64 chars)
+- Description length (max 1024 chars)
+- References mentioned in SKILL.md
+- Scripts are executable
+- No TODO placeholders
+
+**Output:**
+
+```
+📋 Validating skill: my-skill
+============================================================
+
+⚠️  Warnings:
+  ⚠️  Reference file 'schema.md' not mentioned in SKILL.md
+
+✅ Skill is valid (with warnings)
+```
+
+**Exit codes:**
+
+- 0 = success
+- 1 = validation failed
+- 1 with --strict = warnings treated as errors
+
+### Command: package
+
+```bash
+claude-skills package .claude/skills/my-skill
+claude-skills package .claude/skills/my-skill --output dist/
+claude-skills package .claude/skills/my-skill --skip-validation
+```
+
+**Creates:**
+
+- Zip file with skill contents
+- Excludes hidden files, .pyc, **pycache**, etc.
+- Runs validation first (unless --skip-validation)
+
+**Output:**
+
+```
+🔍 Validating skill...
+✅ Skill is valid!
+
+📦 Packaging skill: my-skill
+  + my-skill/SKILL.md
+  + my-skill/README.md
+  + my-skill/references/detailed-guide.md
+
+✅ Skill packaged successfully!
+   File: dist/my-skill.zip
+   Size: 12.3 KB
+
+📤 Upload to Claude.ai: Settings > Features > Skills > Upload
+```
+
+---
+
+## Implementation Roadmap
+
+### Phase 1: Setup (You're here!)
+
+- [x] Create claude-skills-cli repo
+- [x] Copy .claude/ from devhub-crm
+- [ ] Create package.json
+- [ ] Create tsconfig.json
+- [ ] Setup .gitignore, .prettierrc
+- [ ] Install dependencies: `pnpm install`
+
+### Phase 2: Reorganize Files
+
+- [ ] Move `docs/` to root
+- [ ] Move `templates/` to root
+- [ ] Move `skills/skill-creator/` to root
+- [ ] Delete `.claude/settings.local.json`
+- [ ] Delete `.claude/skills/database-patterns/`
+
+### Phase 3: Convert Python → TypeScript
+
+#### init.ts (from init_skill.py)
+
+- [ ] Import types, fs, path, chalk
+- [ ] Create template strings (SKILL.md, README.md, etc.)
+- [ ] Implement createSkill() function
+  - Use fs.mkdirSync(path, { recursive: true })
+  - Use fs.writeFileSync()
+  - Use fs.chmodSync(scriptPath, 0o755) for executable
+- [ ] Use @clack/prompts for interactive mode (optional)
+- [ ] Match Python output format exactly (emoji, messages)
+
+#### validate.ts (from validate_skill.py)
+
+- [ ] Create SkillValidator class
+  - errors: string[]
+  - warnings: string[]
+- [ ] Implement validation methods:
+  - validateDirectory()
+  - validateSkillMd() - parse YAML frontmatter
+  - validateReferences()
+  - validateScripts() - check executable with fs.statSync()
+  - validateAssets()
+- [ ] Use chalk for colored output
+- [ ] Match Python emoji output exactly
+- [ ] Support --strict flag
+
+#### package.ts (from package_skill.py)
+
+- [ ] Import archiver for zip creation
+- [ ] Call validate.ts first (child_process.spawnSync)
+- [ ] Create zip with exclusions:
+  - Hidden files (starts with .)
+  - .pyc, .pyo, .swp, ~
+  - **pycache**, .DS_Store
+- [ ] Report file size in KB
+- [ ] Match Python output format
+
+### Phase 4: CLI Entry Point
+
+#### index.ts
+
+- [ ] Add shebang: `#!/usr/bin/env node`
+- [ ] Import @clack/prompts
+- [ ] Import commands (init, validate, package)
+- [ ] Create interactive menu (like mcpick)
+  - "Create new skill"
+  - "Validate skill"
+  - "Package skill"
+  - "Exit"
+- [ ] Handle command-line arguments (for non-interactive)
+- [ ] Error handling with try/catch
+
+### Phase 5: Testing
+
+- [ ] Build: `pnpm build`
+- [ ] Test init: `node dist/index.js init --name test-skill`
+- [ ] Test validate: `node dist/index.js validate skills/skill-creator`
+- [ ] Test package: `node dist/index.js package skills/skill-creator`
+- [ ] Verify output matches Python version
+
+### Phase 6: Publishing
+
+- [ ] Setup .changeset config
+- [ ] Add initial changeset
+- [ ] Test with `pnpx` locally
+- [ ] Publish to npm: `pnpm release`
+- [ ] Update devhub-crm to use `pnpx claude-skills-cli`
+
+---
+
+## Design Decisions
+
+### Why @clack/prompts instead of commander?
+
+- mcpick uses @clack/prompts for beautiful interactive menus
+- Provides better UX than raw commander arguments
+- Still support non-interactive mode with args
+
+### Why archiver instead of node:zlib?
+
+- archiver is battle-tested for creating zips
+- Handles file permissions, directory structure
+- Direct replacement for Python's zipfile
+
+### Why chalk for colors?
+
+- Match Python's emoji output (✅ ❌ ⚠️)
+- Better terminal color support
+- Widely used, stable
+
+### Why ES modules (type: "module")?
+
+- Modern Node.js best practice
+- Matches mcpick setup
+- Better tree-shaking, cleaner imports
+
+---
+
+## Testing Checklist
+
+Before publishing v1.0.0:
+
+- [ ] All three commands work (init, validate, package)
+- [ ] Output matches Python version exactly
+- [ ] Exit codes match (0 = success, 1 = error)
+- [ ] Emoji indicators work (✅ ❌ ⚠️)
+- [ ] --strict mode works on validate
+- [ ] --skip-validation works on package
+- [ ] Created skills validate successfully
+- [ ] Packaged zips can be uploaded to Claude.ai
+- [ ] Works via `pnpx claude-skills-cli`
+- [ ] Works when installed globally
+
+---
+
+## Resources
+
+### Official Anthropic Documentation:
+
+- [Agent Skills Overview](https://www.anthropic.com/news/skills)
+- [Engineering Blog: Agent Skills](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)
+- [Claude Docs: Skills](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview)
+- [Anthropic Skills Repo](https://github.com/anthropics/skills)
+
+### Included Documentation:
+
+- [docs/SKILLS-ARCHITECTURE.md](docs/SKILLS-ARCHITECTURE.md) - Progressive disclosure system
+- [docs/SKILL-DEVELOPMENT.md](docs/SKILL-DEVELOPMENT.md) - 6-step creation workflow
+- [docs/SKILL-EXAMPLES.md](docs/SKILL-EXAMPLES.md) - Real-world examples
+
+### Reference Implementation:
+
+- [mcpick](https://github.com/spences10/mcpick) - Similar CLI structure to follow
+
+---
+
+## Notes for Next Chat Session
+
+1. **Start with setup:** Create package.json and tsconfig.json first
+2. **Install deps:** `pnpm install` to get @clack/prompts, chalk, archiver
+3. **Reorganize files:** Move docs/, templates/, skills/ from .claude/ to root
+4. **Convert Python scripts one by one:** Start with init.ts (simplest), then validate.ts, then package.ts
+5. **Create index.ts:** Wire up commands with @clack/prompts menu
+6. **Test everything:** Build and run against skill-creator to verify
+
+**Key principle:** Match Python output and behavior EXACTLY. Users should not notice any difference except it's faster and more portable.
+
+---
+
+**Ready to build!** 🚀

package/dist/commands/init.js

@@ -0,0 +1,70 @@
+import { join } from 'path';
+import { SKILL_MD_TEMPLATE, REFERENCE_TEMPLATE, SCRIPT_TEMPLATE, README_TEMPLATE, } from '../core/templates.js';
+import { ensure_dir, write_file, make_executable, to_title_case, is_lowercase, } from '../utils/fs.js';
+import { success, error } from '../utils/output.js';
+export function init_command(options) {
+    let skill_path;
+    let name;
+    let description;
+    // Determine path and name
+    if (options.path) {
+        skill_path = options.path;
+        name = skill_path.split('/').pop() || '';
+        description = options.description || 'TODO: Add description';
+    }
+    else if (options.name) {
+        name = options.name;
+        description = options.description || 'TODO: Add description';
+        // Default to .claude/skills/ directory
+        skill_path = join('.claude', 'skills', name);
+    }
+    else {
+        error('Either --name or --path must be provided');
+        console.log('\nUsage:');
+        console.log('  claude-skills init --name my-skill --description "Description"');
+        console.log('  claude-skills init --path /custom/path/my-skill');
+        process.exit(1);
+    }
+    // Validate name format
+    const alphanumeric_check = name.replace(/-/g, '').replace(/_/g, '');
+    if (!/^[a-z0-9]+$/.test(alphanumeric_check)) {
+        error(`Skill name must be kebab-case alphanumeric: ${name}`);
+        process.exit(1);
+    }
+    if (!is_lowercase(name)) {
+        error(`Skill name must be lowercase: ${name}`);
+        process.exit(1);
+    }
+    // Create skill
+    create_skill(skill_path, name, description);
+}
+function create_skill(path, name, description) {
+    // Create directories
+    ensure_dir(path);
+    ensure_dir(join(path, 'references'));
+    ensure_dir(join(path, 'scripts'));
+    ensure_dir(join(path, 'assets'));
+    // Create SKILL.md
+    const title = to_title_case(name);
+    const skill_md = SKILL_MD_TEMPLATE(name, description, title);
+    write_file(join(path, 'SKILL.md'), skill_md);
+    // Create example reference
+    const reference_md = REFERENCE_TEMPLATE(title);
+    write_file(join(path, 'references', 'detailed-guide.md'), reference_md);
+    // Create example script
+    const script_py = SCRIPT_TEMPLATE('example.py');
+    const script_path = join(path, 'scripts', 'example.py');
+    write_file(script_path, script_py);
+    make_executable(script_path);
+    // Create README
+    const readme_md = README_TEMPLATE(title, description);
+    write_file(join(path, 'README.md'), readme_md);
+    success(`Skill created at: ${path}`);
+    console.log('\nNext steps:');
+    console.log(`1. Edit ${path}/SKILL.md with your skill instructions`);
+    console.log(`2. Add detailed documentation to references/`);
+    console.log(`3. Add executable scripts to scripts/`);
+    console.log(`4. Remove example files you don't need`);
+    console.log(`\nValidate with: claude-skills validate ${path}`);
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/package.js

@@ -0,0 +1,133 @@
+import { basename, join } from 'path';
+import { existsSync, statSync, readdirSync } from 'fs';
+import archiver from 'archiver';
+import { createWriteStream } from 'fs';
+import { SkillValidator } from '../core/validator.js';
+import { ensure_dir } from '../utils/fs.js';
+import { error, success, package_, upload, search, step, } from '../utils/output.js';
+function validate_skill(skill_path) {
+    search('Validating skill...');
+    const validator = new SkillValidator(skill_path);
+    const result = validator.validate_all();
+    if (result.errors.length > 0) {
+        console.log('\n❌ Errors:');
+        for (const err of result.errors) {
+            console.log(`  ${err}`);
+        }
+    }
+    if (result.warnings.length > 0) {
+        console.log('\n⚠️  Warnings:');
+        for (const warn of result.warnings) {
+            console.log(`  ${warn}`);
+        }
+    }
+    if (result.is_valid) {
+        success('Skill is valid!');
+        console.log('');
+        return true;
+    }
+    else {
+        error('Validation failed. Fix errors before packaging.');
+        return false;
+    }
+}
+function package_skill(skill_path, output_dir) {
+    return new Promise((resolve, reject) => {
+        const skill_name = basename(skill_path);
+        const output_file = join(output_dir, `${skill_name}.zip`);
+        package_(`Packaging skill: ${skill_name}`);
+        // Ensure output directory exists
+        ensure_dir(output_dir);
+        // Create output stream
+        const output = createWriteStream(output_file);
+        const archive = archiver('zip', {
+            zlib: { level: 9 },
+        });
+        // Listen for all archive data to be written
+        output.on('close', () => {
+            resolve(output_file);
+        });
+        // Handle errors
+        archive.on('error', (err) => {
+            reject(err);
+        });
+        // Pipe archive data to the file
+        archive.pipe(output);
+        // Add files recursively
+        function add_files(dir_path, base_path) {
+            const items = readdirSync(dir_path);
+            for (const item of items) {
+                const item_path = join(dir_path, item);
+                const stats = statSync(item_path);
+                // Skip hidden files and directories
+                if (item.startsWith('.')) {
+                    continue;
+                }
+                // Skip common temporary files
+                if (item.endsWith('.pyc') ||
+                    item.endsWith('.pyo') ||
+                    item.endsWith('.swp') ||
+                    item.endsWith('~')) {
+                    continue;
+                }
+                if (item === '__pycache__' || item === '.DS_Store') {
+                    continue;
+                }
+                if (stats.isDirectory()) {
+                    add_files(item_path, base_path);
+                }
+                else {
+                    const relative_path = item_path.replace(base_path + '/', '');
+                    archive.file(item_path, { name: relative_path });
+                    step(`+ ${relative_path}`);
+                }
+            }
+        }
+        add_files(skill_path, skill_path.substring(0, skill_path.lastIndexOf('/')));
+        // Finalize the archive
+        archive.finalize();
+    });
+}
+export async function package_command(options) {
+    const { skill_path, output, skip_validation } = options;
+    // Validate path
+    if (!existsSync(skill_path)) {
+        error(`Skill directory does not exist: ${skill_path}`);
+        process.exit(1);
+    }
+    const stats = statSync(skill_path);
+    if (!stats.isDirectory()) {
+        error(`Path is not a directory: ${skill_path}`);
+        process.exit(1);
+    }
+    // Check for SKILL.md
+    if (!existsSync(join(skill_path, 'SKILL.md'))) {
+        error(`SKILL.md not found in ${skill_path}`);
+        process.exit(1);
+    }
+    // Validate skill
+    if (!skip_validation) {
+        if (!validate_skill(skill_path)) {
+            process.exit(1);
+        }
+    }
+    // Package skill
+    try {
+        const output_dir = output || 'dist';
+        const output_file = await package_skill(skill_path, output_dir);
+        // Print success
+        const file_stats = statSync(output_file);
+        const size_kb = file_stats.size / 1024;
+        console.log('');
+        success('Skill packaged successfully!');
+        console.log(`   File: ${output_file}`);
+        console.log(`   Size: ${size_kb.toFixed(1)} KB`);
+        console.log('');
+        upload('Upload to Claude.ai: Settings > Features > Skills > Upload');
+    }
+    catch (err) {
+        error(`Failed to package skill: ${err}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=package.js.map

package/dist/commands/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/commands/package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AACvD,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,IAAI,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EACL,KAAK,EACL,OAAO,EACP,QAAQ,EACR,MAAM,EACN,MAAM,EACN,IAAI,GACL,MAAM,oBAAoB,CAAC;AAE5B,SAAS,cAAc,CAAC,UAAkB;IACxC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC;IAExC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,UAAkB,EAClB,UAAkB;IAElB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,UAAU,MAAM,CAAC,CAAC;QAE1D,QAAQ,CAAC,oBAAoB,UAAU,EAAE,CAAC,CAAC;QAE3C,iCAAiC;QACjC,UAAU,CAAC,UAAU,CAAC,CAAC;QAEvB,uBAAuB;QACvB,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE;YAC9B,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;SACnB,CAAC,CAAC;QAEH,4CAA4C;QAC5C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,OAAO,CAAC,WAAW,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,gBAAgB;QAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC1B,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,gCAAgC;QAChC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAErB,wBAAwB;QACxB,SAAS,SAAS,CAAC,QAAgB,EAAE,SAAiB;YACpD,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;YAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;gBAElC,oCAAoC;gBACpC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACzB,SAAS;gBACX,CAAC;gBAED,8BAA8B;gBAC9B,IACE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACrB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAClB,CAAC;oBACD,SAAS;gBACX,CAAC;gBAED,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;oBACnD,SAAS;gBACX,CAAC;gBAED,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;gBAClC,CAAC;qBAAM,CAAC;oBACN,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC;oBAC7D,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;oBACjD,IAAI,CAAC,KAAK,aAAa,EAAE,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QAED,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAE5E,uBAAuB;QACvB,OAAO,CAAC,QAAQ,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAuB;IAC3D,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAExD,gBAAgB;IAChB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,mCAAmC,UAAU,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,KAAK,CAAC,4BAA4B,UAAU,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,qBAAqB;IACrB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;QAC9C,KAAK,CAAC,yBAAyB,UAAU,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,iBAAiB;IACjB,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,IAAI,MAAM,CAAC;QACpC,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAEhE,gBAAgB;QAChB,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;QAEvC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,8BAA8B,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,YAAY,WAAW,EAAE,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,MAAM,CAAC,4DAA4D,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}