@nepopsx/cli 0.0.1

package/dist/generator/builtin-templates.js

@@ -0,0 +1,251 @@
+/**
+ * Builtin templates that are generated for every workspace regardless of agents.
+ * These provide the base workspace context files.
+ */
+export function getBuiltinTemplates() {
+    return [
+        {
+            outputPath: '.github/copilot-instructions.md',
+            template: COPILOT_INSTRUCTIONS_TEMPLATE,
+            source: 'builtin:copilot-instructions',
+        },
+        {
+            outputPath: 'AGENTS.md',
+            template: AGENTS_MD_TEMPLATE,
+            source: 'builtin:agents-md',
+        },
+        {
+            outputPath: 'Makefile',
+            template: MAKEFILE_TEMPLATE,
+            source: 'builtin:makefile',
+        },
+    ];
+}
+// ─── copilot-instructions.md ────────────────────────────────
+const COPILOT_INSTRUCTIONS_TEMPLATE = `# {{config.workspace.name}} — Copilot Instructions
+
+<!-- Auto-generated by OPSX CLI ({{timestamp}}). Do not edit manually. -->
+<!-- Regenerate with: npx @nepopsx/cli sync -->
+
+## Architecture Overview
+
+{{#if config.workspace.description}}
+{{config.workspace.description}}
+
+{{/if}}
+### Services
+
+| Service | Language | Framework | Path | Maturity |
+|---------|----------|-----------|------|----------|
+{{#each config.services}}
+| {{name}} | {{language}} | {{#if framework}}{{framework}}{{else}}—{{/if}} | \`{{path}}/\` | {{maturityBadge maturity}} |
+{{/each}}
+
+{{#if config.execution_order}}
+### Multi-Service Change Order
+
+When a feature spans multiple services, modify in this order:
+
+{{#each config.execution_order}}
+{{idx @index}}. **{{this}}**
+{{/each}}
+{{/if}}
+
+{{#if config.databases}}
+### Databases
+
+| Name | Type | Description |
+|------|------|-------------|
+{{#each config.databases}}
+| {{name}} | {{type}} | {{#if description}}{{description}}{{else}}—{{/if}} |
+{{/each}}
+{{/if}}
+
+## Coding Standards
+
+{{#hasLanguage config.services "typescript"}}
+### TypeScript
+- Strict TypeScript — explicit return types on exported functions
+- Prefer functional patterns, const assertions
+- Use path aliases where configured
+{{/hasLanguage}}
+
+{{#hasLanguage config.services "python"}}
+### Python
+- Type hints on public functions
+- Follow PEP 8 with project formatter (Black/Ruff)
+{{/hasLanguage}}
+
+{{#hasLanguage config.services "go"}}
+### Go
+- Standard project layout: cmd/, internal/, pkg/
+- Wrap errors with context, return errors (don't panic)
+- Table-driven tests
+{{/hasLanguage}}
+
+{{#hasLanguage config.services "rust"}}
+### Rust
+- Use clippy for linting
+- Prefer Result over unwrap/expect in library code
+{{/hasLanguage}}
+
+{{#hasLanguage config.services "java"}}
+### Java/Kotlin
+- Follow framework conventions (Spring Boot, etc.)
+- Use dependency injection
+{{/hasLanguage}}
+
+## Conventions
+
+{{#if config.conventions}}
+- **Branch naming**: \`{{config.conventions.branching}}\`
+- **Commits**: {{config.conventions.commits}}
+- **Default branch**: {{config.conventions.default_branch}}
+{{#if config.conventions.pr_required}}- **PRs required** before merge{{/if}}
+{{#if config.conventions.test_required}}- **Tests required** before merge{{/if}}
+{{/if}}
+
+{{#if config.safety}}
+## Safety Protocol
+
+{{#if config.safety.branch_isolation}}- Agents must work on feature branches only — never modify \`{{config.conventions.default_branch}}\` directly{{/if}}
+{{#if config.safety.checkpoint_before_destructive}}- Auto-commit checkpoint before destructive operations (deletions, migrations, force flags){{/if}}
+{{#if config.safety.confirm_destructive}}- Ask user confirmation before file deletions, database migrations, CI/CD changes{{/if}}
+{{#if config.safety.scope_restriction}}- Agents may only modify files within declared service paths:
+{{#each config.services}}
+  - \`{{path}}/\`
+{{/each}}
+{{#if config.safety.allowed_paths}}
+  Additional allowed paths:
+{{#each config.safety.allowed_paths}}
+  - \`{{this}}\`
+{{/each}}
+{{/if}}
+{{/if}}
+{{#if config.safety.blocked_commands}}- Blocked commands: {{#each config.safety.blocked_commands}}\`{{this}}\`{{#unless @last}}, {{/unless}}{{/each}}{{/if}}
+{{/if}}
+`;
+// ─── AGENTS.md ──────────────────────────────────────────────
+const AGENTS_MD_TEMPLATE = `# AI Agent Instructions — {{config.workspace.name}}
+
+<!-- Auto-generated by OPSX CLI ({{timestamp}}). Do not edit manually. -->
+
+## Services
+
+| Service | Language | Framework | Path | Port | Maturity |
+|---------|----------|-----------|------|------|----------|
+{{#each config.services}}
+| {{name}} | {{language}} | {{#if framework}}{{framework}}{{else}}—{{/if}} | \`{{path}}/\` | {{#if port}}{{port}}{{else}}—{{/if}} | {{maturityBadge maturity}} |
+{{/each}}
+
+## Common Commands
+
+{{#each config.services}}
+### {{name}} ({{language}}{{#if framework}} / {{framework}}{{/if}})
+
+\`\`\`bash
+cd {{path}}
+{{#if commands.dev}}
+# Development
+{{commands.dev}}
+{{/if}}
+{{#if commands.build}}
+# Build
+{{commands.build}}
+{{/if}}
+{{#if commands.test}}
+# Test
+{{commands.test}}
+{{/if}}
+{{#if commands.lint}}
+# Lint
+{{commands.lint}}
+{{/if}}
+\`\`\`
+
+{{/each}}
+
+{{#if config.execution_order}}
+## Cross-Service Change Order
+
+{{#each config.execution_order}}
+{{idx @index}}. {{this}}
+{{/each}}
+{{/if}}
+
+{{#if config.databases}}
+## Databases
+
+{{#each config.databases}}
+- **{{name}}** ({{type}}){{#if description}} — {{description}}{{/if}}
+{{/each}}
+{{/if}}
+
+## Service Ports
+
+| Service | Port |
+|---------|------|
+{{#each config.services}}
+{{#if port}}
+| {{name}} | {{port}} |
+{{/if}}
+{{/each}}
+`;
+// ─── Makefile ───────────────────────────────────────────────
+const MAKEFILE_TEMPLATE = `.PHONY: help
+help: ## Show this help
+\t@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\\033[36m%-20s\\033[0m %s\\n", $$1, $$2}'
+
+# ─── Build ──────────────────────────────────────────────────
+
+{{#each config.services}}
+{{#if commands.build}}
+build-{{name}}: ## Build {{name}}
+\tcd {{path}} && {{commands.build}}
+
+{{/if}}
+{{/each}}
+build-all: {{#each config.services}}{{#if commands.build}}build-{{name}} {{/if}}{{/each}}## Build all services
+
+# ─── Test ───────────────────────────────────────────────────
+
+{{#each config.services}}
+{{#if commands.test}}
+test-{{name}}: ## Test {{name}}
+\tcd {{path}} && {{commands.test}}
+
+{{/if}}
+{{/each}}
+test-all: {{#each config.services}}{{#if commands.test}}test-{{name}} {{/if}}{{/each}}## Test all services
+
+# ─── Lint ───────────────────────────────────────────────────
+
+{{#each config.services}}
+{{#if commands.lint}}
+lint-{{name}}: ## Lint {{name}}
+\tcd {{path}} && {{commands.lint}}
+
+{{/if}}
+{{/each}}
+lint-all: {{#each config.services}}{{#if commands.lint}}lint-{{name}} {{/if}}{{/each}}## Lint all services
+
+# ─── Dev ────────────────────────────────────────────────────
+
+{{#each config.services}}
+{{#if commands.dev}}
+dev-{{name}}: ## Start {{name}} dev server
+\tcd {{path}} && {{commands.dev}}
+
+{{/if}}
+{{/each}}
+
+# ─── Status ─────────────────────────────────────────────────
+
+env-state: ## Check service ports
+{{#each config.services}}
+{{#if port}}
+\t@timeout 1 nc -zv localhost {{port}} 2>&1 | grep -q succeeded && echo "{{name}} ({{port}}): UP" || echo "{{name}} ({{port}}): DOWN"
+{{/if}}
+{{/each}}
+`;
+//# sourceMappingURL=builtin-templates.js.map

package/dist/generator/builtin-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-templates.js","sourceRoot":"","sources":["../../src/generator/builtin-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,6BAA6B;YACvC,MAAM,EAAE,8BAA8B;SACvC;QACD;YACE,UAAU,EAAE,WAAW;YACvB,QAAQ,EAAE,kBAAkB;YAC5B,MAAM,EAAE,mBAAmB;SAC5B;QACD;YACE,UAAU,EAAE,UAAU;YACtB,QAAQ,EAAE,iBAAiB;YAC3B,MAAM,EAAE,kBAAkB;SAC3B;KACF,CAAC;AACJ,CAAC;AAED,+DAA+D;AAE/D,MAAM,6BAA6B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsGrC,CAAC;AAEF,+DAA+D;AAE/D,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgE1B,CAAC;AAEF,+DAA+D;AAE/D,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDzB,CAAC"}

package/dist/generator/philosophy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Philosophy-to-instructions mapping.
+ * Translates each workspace.yaml philosophy axis value into concrete
+ * directives that get injected into agent templates.
+ */
+import type { Philosophy } from '@nepopsx/core';
+/**
+ * Convert a Philosophy config into a markdown block of concrete instructions.
+ * Returns empty string if no philosophy is configured.
+ */
+export declare function philosophyToInstructions(philosophy: Philosophy | undefined): string;
+//# sourceMappingURL=philosophy.d.ts.map

package/dist/generator/philosophy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"philosophy.d.ts","sourceRoot":"","sources":["../../src/generator/philosophy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAmFhD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CA6BnF"}

package/dist/generator/philosophy.js

@@ -0,0 +1,106 @@
+// ─── Axis Mappings ──────────────────────────────────────────
+const ERROR_HANDLING = {
+    'result-types': `Prefer Result/Either types over try-catch. Return errors as values. Only use try-catch at system boundaries (HTTP handlers, CLI entry points, top-level event handlers).`,
+    'try-catch': `Use try-catch for error handling. Catch specific error types, never bare catch. Always include meaningful error messages and re-throw when appropriate.`,
+    'error-boundaries': `Use error boundaries for UI error handling. For backend, use middleware-level error catchers. Individual functions should throw typed errors caught by the boundary layer.`,
+    'mixed': `Use the error handling approach that best fits each context: Result types for business logic, try-catch for I/O operations, error boundaries for UI components.`,
+};
+const STATE_MANAGEMENT = {
+    'immutable': `Prefer immutable data structures and patterns. Use spread operators, Object.freeze, or immutable libraries. Never mutate function arguments. Use map/filter/reduce over for-loops that mutate accumulators.`,
+    'mutable': `Mutable state is acceptable when it improves readability. Prefer direct mutation over creating unnecessary copies. Use classes with encapsulated mutable state where appropriate.`,
+    'mixed': `Use immutable patterns for shared state and data flowing between components. Mutable state is acceptable for local/temporary variables and performance-critical paths.`,
+};
+const TESTING_PHILOSOPHY = {
+    'tdd': `Follow Test-Driven Development: write tests BEFORE implementation. Red → Green → Refactor cycle. Every public function must have a test. Aim for >80% coverage on critical paths.`,
+    'test-after': `Write tests after implementation. Focus on testing behavior, not implementation details. Every feature should have corresponding tests before the task is marked complete.`,
+    'integration-first': `Prioritize integration tests over unit tests. Test the system through its public interfaces (API endpoints, UI interactions). Unit tests only for complex algorithms or business logic.`,
+    'minimal': `Write tests only for critical business logic, complex algorithms, and regression-prone code. Don't test simple CRUD, getters/setters, or framework boilerplate.`,
+};
+const ABSTRACTION_LEVEL = {
+    'explicit': `Prefer explicit, verbose code over clever abstractions. Repeat yourself rather than creating premature abstractions. Inline small utility functions. Favor readability over DRY.`,
+    'dry': `Follow DRY (Don't Repeat Yourself) strictly. Extract shared logic into helper functions, base classes, or shared modules. Create abstractions when a pattern appears twice.`,
+    'pragmatic': `Extract shared code when a pattern appears three or more times (Rule of Three). For two occurrences, tolerate some duplication. Balance readability with reuse.`,
+};
+const DEPENDENCY_INJECTION = {
+    'constructor': `Use constructor injection for dependencies. Pass dependencies explicitly via constructor parameters. This makes dependencies visible, testable, and refactor-safe.`,
+    'container': `Use a dependency injection container (IoC container). Register services in a central module. Resolve dependencies via decorators or container lookups.`,
+    'none': `Avoid dependency injection frameworks. Import modules directly. For testing, use module mocking (jest.mock, monkey-patching, etc.) rather than DI abstractions.`,
+};
+const API_STYLE = {
+    'rest-resource': `Design REST APIs around resources. Use nouns for endpoints (/users, /orders). Standard HTTP methods: GET (read), POST (create), PUT (full update), PATCH (partial update), DELETE. Return consistent envelope: { data, meta }.`,
+    'rest-rpc': `Design REST APIs as RPC-style actions. Use verbs for endpoints (/calculatePrice, /sendNotification). POST for mutations, GET for queries. Group by domain, not by resource.`,
+    'graphql': `Use GraphQL for API design. Define schema-first with types and resolvers. Use queries for reads, mutations for writes. Implement DataLoader for N+1 prevention.`,
+};
+const COMPONENT_PATTERN = {
+    'functional': `Use functional components exclusively. Use hooks for state and side effects. Prefer composition via custom hooks. No class components unless wrapping legacy code.`,
+    'class': `Use class components with clear lifecycle methods. Encapsulate state and behavior in classes. Use inheritance sparingly, prefer composition.`,
+    'mixed': `Use functional components with hooks for new code. Class components are acceptable for complex stateful components. Choose whichever is clearer for each use case.`,
+};
+const ORM_USAGE = {
+    'repository': `Use the Repository pattern. Separate database access into repository classes/modules. Business logic should not contain SQL or ORM queries directly.`,
+    'active-record': `Use Active Record pattern. Models contain both data and database operations. Keep queries close to the model they operate on.`,
+    'raw-sql': `Use raw SQL for database queries. Parameterize all inputs. Keep SQL in dedicated query files or constants, not inline in business logic.`,
+    'query-builder': `Use a query builder (Knex, Prisma, TypeORM QueryBuilder) for type-safe query construction. Prefer the query builder over raw SQL for maintainability.`,
+};
+const DOCUMENTATION = {
+    'jsdoc-all': `Document ALL exported functions, classes, types, and interfaces with JSDoc/docstrings. Include @param, @returns, @throws, and @example where non-obvious.`,
+    'jsdoc-on-public': `Document public API surfaces only: exported functions, class methods, and module interfaces. Internal/private helpers don't need documentation unless complex.`,
+    'minimal': `Document only non-obvious behavior. If the function name and types make the intent clear, skip the docstring. Focus on "why" comments, not "what" comments.`,
+    'none': `Code should be self-documenting. Use descriptive names instead of comments. Only add comments for workarounds, edge cases, or business rule explanations.`,
+};
+const PR_SIZE = {
+    'small': `Keep PRs small: target <300 lines of code changed. Break large features into sequential PRs. Prefer more, smaller PRs over fewer, larger ones.`,
+    'medium': `Keep PRs under ~800 lines of code changed. A single task from the implementation plan should map to one PR. Split only when crossing service boundaries.`,
+    'large': `PR size is not limited. Prefer completing a full feature in one PR for atomic review. Only split if different reviewers are needed for different services.`,
+};
+// ─── Public API ─────────────────────────────────────────────
+const AXIS_MAP = {
+    error_handling: ERROR_HANDLING,
+    state_management: STATE_MANAGEMENT,
+    testing_philosophy: TESTING_PHILOSOPHY,
+    abstraction_level: ABSTRACTION_LEVEL,
+    dependency_injection: DEPENDENCY_INJECTION,
+    api_style: API_STYLE,
+    component_pattern: COMPONENT_PATTERN,
+    orm_usage: ORM_USAGE,
+    documentation: DOCUMENTATION,
+    pr_size: PR_SIZE,
+};
+/**
+ * Convert a Philosophy config into a markdown block of concrete instructions.
+ * Returns empty string if no philosophy is configured.
+ */
+export function philosophyToInstructions(philosophy) {
+    if (!philosophy)
+        return '';
+    const lines = [];
+    lines.push('## Team Coding Philosophy');
+    lines.push('');
+    lines.push('These are the team\'s coding preferences. Follow them when writing or reviewing code.');
+    lines.push('');
+    for (const [axis, mapping] of Object.entries(AXIS_MAP)) {
+        const value = philosophy[axis];
+        if (typeof value === 'string' && mapping[value]) {
+            lines.push(`- **${formatAxisName(axis)}:** ${mapping[value]}`);
+        }
+    }
+    // Custom freeform rules
+    if (philosophy.custom && philosophy.custom.length > 0) {
+        lines.push('');
+        lines.push('### Additional Team Rules');
+        lines.push('');
+        for (const rule of philosophy.custom) {
+            lines.push(`- ${rule}`);
+        }
+    }
+    // Only return if there are actual directives (beyond header)
+    const hasDirectives = lines.some((l) => l.startsWith('- '));
+    return hasDirectives ? lines.join('\n') : '';
+}
+function formatAxisName(axis) {
+    return axis
+        .split('_')
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=philosophy.js.map

package/dist/generator/philosophy.js.map

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

package/dist/generator/render.d.ts

@@ -0,0 +1,74 @@
+import type { WorkspaceConfig, WatermarkData } from '@nepopsx/core';
+/**
+ * Parsed custom instruction file.
+ */
+export interface CustomInstruction {
+    content: string;
+    applies_to?: string[];
+    scope?: string;
+    source: string;
+}
+/**
+ * Set the philosophy markdown block for the current sync run.
+ */
+export declare function setPhilosophyBlock(block: string): void;
+/**
+ * Set the custom instructions for the current sync run.
+ */
+export declare function setCustomInstructions(customs: CustomInstruction[]): void;
+export interface RenderContext {
+    config: WorkspaceConfig;
+    agent?: {
+        name: string;
+        version: string;
+    };
+    timestamp: string;
+}
+/**
+ * Register all partials from an agent package's partials/ directory.
+ * .hbs partials are pre-rendered with config context; .md partials are included as-is.
+ */
+export declare function registerAgentPartials(partialsDir: string, config: WorkspaceConfig, agentMeta?: {
+    name: string;
+    version: string;
+}): void;
+/**
+ * Unregister all partials (call between agent packages to avoid cross-contamination).
+ */
+export declare function clearPartials(partialsDir: string): void;
+/**
+ * Register partials from a remote template map keyed by relative file path.
+ * Returns the partial names so they can be unregistered after rendering.
+ */
+export declare function registerAgentPartialsFromMap(templateMap: Record<string, string>, config: WorkspaceConfig, agentMeta?: {
+    name: string;
+    version: string;
+}): string[];
+export declare function clearPartialNames(partialNames: string[]): void;
+/**
+ * Render a Handlebars template string with workspace config context.
+ * Context is sanitized to prevent prototype pollution attacks.
+ */
+export declare function renderTemplate(templateSource: string, config: WorkspaceConfig, agentMeta?: {
+    name: string;
+    version: string;
+}): string;
+/**
+ * Render a template file.
+ */
+export declare function renderTemplateFile(templatePath: string, config: WorkspaceConfig, agentMeta?: {
+    name: string;
+    version: string;
+}): string;
+/**
+ * Set watermark data for the current sync run.
+ * When set, every rendered file gets a watermark header + steganographic fingerprint.
+ * Pass null to disable (e.g., dev mode / free tier).
+ */
+export declare function setWatermarkData(data: WatermarkData | null): void;
+/**
+ * Apply watermark header + steganographic fingerprint to rendered content.
+ * Should be called AFTER Handlebars rendering, on the final output.
+ */
+export declare function applyLicenseWatermark(content: string): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/generator/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/generator/render.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAW,aAAa,EAAE,MAAM,eAAe,CAAC;AAyE7E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAExE;AAyCD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqBvI;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAQvD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,MAAM,EAAE,eAAe,EACvB,SAAS,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5C,MAAM,EAAE,CAoBV;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAI9D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAUrI;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAGvI;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAEjE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAW7D"}