@fractary/faber 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Fractary Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,146 @@
+# Faber
+
+> Universal AI Agent Orchestration Framework - Core SDK
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](package.json)
+[![TypeScript](https://img.shields.io/badge/typescript-5.3.3-blue)](https://www.typescriptlang.org/)
+
+## Overview
+
+Faber is the core SDK for building universal AI agents that can be deployed across multiple AI frameworks (Claude Code, LangGraph, CrewAI, etc.) and adapted to different platforms and organizational contexts.
+
+This is the **core framework package**. For the CLI tool, see [@fractary/faber-cli](https://www.npmjs.com/package/@fractary/faber-cli).
+
+## Installation
+
+```bash
+npm install @fractary/faber
+```
+
+## Programmatic Usage
+
+```typescript
+import { FaberAPI, RoleLoader } from '@fractary/faber';
+
+// Initialize API
+const api = new FaberAPI({
+  projectPath: './my-agents'
+});
+
+// Load and build an agent
+const result = await api.build('claude', 'role', 'issue-manager', {
+  output: './deployments/claude',
+  platform: 'github-issues'
+});
+
+console.log('Built agent:', result.files);
+```
+
+## Core Features
+
+- **Concept System** - Roles, Teams, Tools, Workflows, Evals
+- **Context System** - 7 categories of dynamic knowledge loading
+- **Overlay System** - Customization without forking
+- **Binding Framework** - Transform to any AI framework
+- **Configuration Management** - Flexible config system
+- **TypeScript First** - Full type safety
+
+## API Reference
+
+### FaberAPI
+
+Main programmatic interface:
+
+```typescript
+class FaberAPI {
+  // Initialize a new Faber project
+  async init(options: InitOptions): Promise<void>
+
+  // Create new concepts
+  async create(type: ConceptType, name: string, options: CreateOptions): Promise<void>
+
+  // List available concepts
+  async list(type?: ConceptType, filter?: ListFilter): Promise<ConceptInfo[]>
+
+  // Validate a concept
+  async validate(type: ConceptType, name: string): Promise<ValidationResult>
+
+  // Build/transform for a framework
+  async build(binding: string, type: ConceptType, name: string, options: BuildOptions): Promise<DeploymentArtifact>
+
+  // Load configuration
+  async loadConfig(): Promise<Config>
+
+  // Apply overlays
+  async applyOverlays(concept: Concept, overlays: Overlays): Promise<Concept>
+}
+```
+
+### Concept Loaders
+
+Direct access to loaders:
+
+```typescript
+import { RoleLoader, TeamLoader, ToolLoader } from '@fractary/faber/loaders';
+
+const loader = new RoleLoader();
+const role = await loader.load('./roles/my-agent');
+const validation = await loader.validate(role);
+```
+
+### Bindings
+
+Create custom framework bindings:
+
+```typescript
+import { BindingTransformer, DeploymentArtifact } from '@fractary/faber/bindings';
+
+class MyCustomBinding implements BindingTransformer {
+  async transform(concept: Concept, config: Config, overlays?: Overlays): Promise<DeploymentArtifact> {
+    // Custom transformation logic
+  }
+
+  async validate(concept: Concept): Promise<ValidationResult> {
+    // Validation logic
+  }
+
+  getRequirements(): BindingRequirements {
+    return {
+      supportedConcepts: [ConceptType.ROLE, ConceptType.TEAM]
+    };
+  }
+}
+```
+
+## Documentation
+
+- [Core Concepts](https://github.com/fractary/faber-cli/blob/main/docs/concepts.md)
+- [Context System](https://github.com/fractary/faber-cli/blob/main/docs/contexts.md)
+- [Overlay System](https://github.com/fractary/faber-cli/blob/main/docs/overlays.md)
+- [Binding System](https://github.com/fractary/faber-cli/blob/main/docs/bindings.md)
+- [API Reference](https://github.com/fractary/faber-cli/blob/main/docs/api.md)
+
+## CLI Tool
+
+For command-line usage, install the CLI package:
+
+```bash
+npm install -g @fractary/faber-cli
+```
+
+See [@fractary/faber-cli](https://www.npmjs.com/package/@fractary/faber-cli) for CLI documentation.
+
+## Contributing
+
+See [Contributing Guide](https://github.com/fractary/faber-cli/blob/main/docs/contributing.md).
+
+## License
+
+MIT - see [LICENSE](LICENSE) file for details.
+
+---
+
+**Part of the Faber Ecosystem**
+- [@fractary/faber](https://www.npmjs.com/package/@fractary/faber) - Core SDK (this package)
+- [@fractary/faber-cli](https://www.npmjs.com/package/@fractary/faber-cli) - CLI tool

package/dist/api.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Faber-CLI Programmatic API
+ */
+import { EventEmitter } from 'events';
+import { Config, ConceptType, ValidationResult, Concept } from './types';
+import { Overlays } from './core/overlays/resolver';
+import { ConceptInfo, DeploymentArtifact } from './types';
+export interface FaberOptions {
+    projectPath?: string;
+    configPath?: string;
+    verbose?: boolean;
+    quiet?: boolean;
+}
+export interface CreateOptions {
+    org?: string;
+    system?: string;
+    platforms?: string[];
+    description?: string;
+    members?: string[];
+    type?: string;
+    target?: string;
+}
+export interface BuildOptions {
+    output?: string;
+    noOverlays?: boolean;
+    platform?: string;
+    dryRun?: boolean;
+    verbose?: boolean;
+}
+export declare class FaberAPI extends EventEmitter {
+    private projectPath;
+    private configPath;
+    private config;
+    private configLoader;
+    constructor(options?: FaberOptions);
+    /**
+     * Initialize a new Faber project
+     */
+    init(template?: string): Promise<void>;
+    /**
+     * Get project configuration
+     */
+    getConfig(): Promise<Config>;
+    /**
+     * Set configuration value
+     */
+    setConfig(key: string, value: any): Promise<void>;
+    /**
+     * Create a new concept
+     */
+    createConcept(type: ConceptType, name: string, options?: CreateOptions): Promise<void>;
+    /**
+     * Load a concept
+     */
+    loadConcept<T extends Concept>(type: ConceptType, name: string): Promise<T>;
+    /**
+     * List concepts
+     */
+    listConcepts(type?: ConceptType): Promise<ConceptInfo[]>;
+    /**
+     * Validate a concept
+     */
+    validateConcept(type: ConceptType, name: string): Promise<ValidationResult>;
+    /**
+     * Build a deployment
+     */
+    build(framework: string, concept: Concept, options?: BuildOptions): Promise<DeploymentArtifact>;
+    /**
+     * Deploy an artifact
+     */
+    deploy(artifact: DeploymentArtifact, target: string): Promise<void>;
+    /**
+     * Resolve overlays
+     */
+    resolveOverlays(type: string, name: string, platform?: string): Promise<Overlays>;
+    /**
+     * Apply overlays to concept
+     */
+    applyOverlays(concept: Concept, overlays: Overlays): Promise<Concept>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAOzE,OAAO,EAAmB,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGrE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,QAAS,SAAQ,YAAY;IACxC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAAe;gBAEvB,OAAO,GAAE,YAAiB;IAOtC;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C5C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAOlC;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvD;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2ChG;;OAEG;IACG,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BjF;;OAEG;IACG,YAAY,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAY9D;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6BjF;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuCzG;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzE;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKvF;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;CAK5E"}

package/dist/api.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * Faber-CLI Programmatic API
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FaberAPI = void 0;
+const events_1 = require("events");
+const path_1 = __importDefault(require("path"));
+const types_1 = require("./types");
+const loader_1 = require("./core/config/loader");
+const role_1 = require("./core/concepts/role");
+const team_1 = require("./core/concepts/team");
+const workflow_1 = require("./core/concepts/workflow");
+const tool_1 = require("./core/concepts/tool");
+const eval_1 = require("./core/concepts/eval");
+const resolver_1 = require("./core/overlays/resolver");
+const transformer_1 = require("./bindings/claude-code/transformer");
+const file_system_1 = require("./utils/file-system");
+class FaberAPI extends events_1.EventEmitter {
+    constructor(options = {}) {
+        super();
+        this.config = null;
+        this.projectPath = options.projectPath || process.cwd();
+        this.configPath = options.configPath || path_1.default.join(this.projectPath, '.faber', 'config.yml');
+        this.configLoader = new loader_1.ConfigLoader();
+    }
+    /**
+     * Initialize a new Faber project
+     */
+    async init(template) {
+        // Create project structure
+        const dirs = [
+            '.faber/overlays/organization',
+            '.faber/overlays/platforms',
+            '.faber/overlays/roles',
+            '.faber/overlays/teams',
+            '.faber/overlays/workflows',
+            'roles',
+            'tools',
+            'teams',
+            'workflows',
+            'evals',
+            'deployments'
+        ];
+        for (const dir of dirs) {
+            await (0, file_system_1.ensureDirectoryExists)(path_1.default.join(this.projectPath, dir));
+        }
+        // Create default config
+        const defaultConfig = {
+            platforms: {},
+            mcp_servers: {},
+            overlays: {
+                enabled: true,
+                paths: ['.faber/overlays']
+            },
+            bindings: {
+                claude: {
+                    auto_activate: true
+                }
+            }
+        };
+        await (0, file_system_1.writeFile)(this.configPath, `# Faber-CLI Configuration\n\n${JSON.stringify(defaultConfig, null, 2)}`);
+        this.emit('init', { projectPath: this.projectPath, template });
+    }
+    /**
+     * Get project configuration
+     */
+    async getConfig() {
+        if (!this.config) {
+            this.config = await this.configLoader.load(this.configPath);
+        }
+        return this.config;
+    }
+    /**
+     * Set configuration value
+     */
+    async setConfig(key, value) {
+        const config = await this.getConfig();
+        const keys = key.split('.');
+        let obj = config;
+        for (let i = 0; i < keys.length - 1; i++) {
+            if (!(keys[i] in obj)) {
+                obj[keys[i]] = {};
+            }
+            obj = obj[keys[i]];
+        }
+        obj[keys[keys.length - 1]] = value;
+        await (0, file_system_1.writeFile)(this.configPath, JSON.stringify(config, null, 2));
+        this.config = config;
+        this.emit('config:set', { key, value });
+    }
+    /**
+     * Create a new concept
+     */
+    async createConcept(type, name, options = {}) {
+        const conceptPath = path_1.default.join(this.projectPath, `${type}s`, name);
+        await (0, file_system_1.ensureDirectoryExists)(conceptPath);
+        // Create metadata file based on type
+        const metadata = {
+            name,
+            description: options.description || `${type} ${name}`,
+            ...options
+        };
+        const metadataFile = type === types_1.ConceptType.ROLE ? 'agent.yml' :
+            type === types_1.ConceptType.TEAM ? 'team.yml' :
+                type === types_1.ConceptType.WORKFLOW ? 'workflow.yml' :
+                    type === types_1.ConceptType.TOOL ? 'tool.yml' :
+                        'eval.yml';
+        await (0, file_system_1.writeFile)(path_1.default.join(conceptPath, metadataFile), `name: ${name}\n` +
+            `description: ${metadata.description}\n` +
+            (type === types_1.ConceptType.ROLE && options.platforms ?
+                `platforms:\n${options.platforms.map(p => `  - ${p}`).join('\n')}\n` : '') +
+            (type === types_1.ConceptType.TEAM && options.members ?
+                `members:\n${options.members.map(m => `  - role: ${m}`).join('\n')}\n` : ''));
+        // Create prompt.md for roles
+        if (type === types_1.ConceptType.ROLE) {
+            await (0, file_system_1.writeFile)(path_1.default.join(conceptPath, 'prompt.md'), `# ${name}\n\n${metadata.description}\n\n## Core Behavior\n\n[Define agent behavior here]`);
+            // Create subdirectories
+            for (const dir of ['tasks', 'flows', 'contexts']) {
+                await (0, file_system_1.ensureDirectoryExists)(path_1.default.join(conceptPath, dir));
+            }
+        }
+        this.emit('concept:created', { type, name, options });
+    }
+    /**
+     * Load a concept
+     */
+    async loadConcept(type, name) {
+        const conceptPath = path_1.default.join(this.projectPath, `${type}s`, name);
+        let loader;
+        switch (type) {
+            case types_1.ConceptType.ROLE:
+                loader = new role_1.RoleLoader();
+                break;
+            case types_1.ConceptType.TEAM:
+                loader = new team_1.TeamLoader();
+                break;
+            case types_1.ConceptType.WORKFLOW:
+                loader = new workflow_1.WorkflowLoader();
+                break;
+            case types_1.ConceptType.TOOL:
+                loader = new tool_1.ToolLoader();
+                break;
+            case types_1.ConceptType.EVAL:
+                loader = new eval_1.EvalLoader();
+                break;
+            default:
+                throw new Error(`Unknown concept type: ${type}`);
+        }
+        const concept = await loader.load(conceptPath);
+        this.emit('concept:loaded', { type, name, concept });
+        return concept;
+    }
+    /**
+     * List concepts
+     */
+    async listConcepts(type) {
+        const concepts = [];
+        const types = type ? [type] : Object.values(types_1.ConceptType);
+        for (const t of types) {
+            // Implementation would scan directories and load metadata
+            // For now, returning empty array
+        }
+        return concepts;
+    }
+    /**
+     * Validate a concept
+     */
+    async validateConcept(type, name) {
+        const concept = await this.loadConcept(type, name);
+        let loader;
+        switch (type) {
+            case types_1.ConceptType.ROLE:
+                loader = new role_1.RoleLoader();
+                break;
+            case types_1.ConceptType.TEAM:
+                loader = new team_1.TeamLoader();
+                break;
+            case types_1.ConceptType.WORKFLOW:
+                loader = new workflow_1.WorkflowLoader();
+                break;
+            case types_1.ConceptType.TOOL:
+                loader = new tool_1.ToolLoader();
+                break;
+            case types_1.ConceptType.EVAL:
+                loader = new eval_1.EvalLoader();
+                break;
+            default:
+                throw new Error(`Unknown concept type: ${type}`);
+        }
+        const result = await loader.validate(concept);
+        this.emit('concept:validated', { type, name, result });
+        return result;
+    }
+    /**
+     * Build a deployment
+     */
+    async build(framework, concept, options = {}) {
+        this.emit('build:start', { framework, concept: concept.name });
+        const config = await this.getConfig();
+        // Resolve overlays
+        const overlayResolver = new resolver_1.OverlayResolver(this.projectPath);
+        const overlays = options.noOverlays ?
+            {} :
+            await overlayResolver.resolveOverlays(concept.type, concept.name, options.platform);
+        // Get transformer
+        let transformer;
+        switch (framework) {
+            case 'claude':
+                transformer = new transformer_1.ClaudeCodeTransformer();
+                break;
+            default:
+                throw new Error(`Unknown framework: ${framework}`);
+        }
+        // Transform
+        const artifact = await transformer.transform(concept, config, overlays);
+        // Write files unless dry-run
+        if (!options.dryRun) {
+            const outputDir = options.output || path_1.default.join(this.projectPath, 'deployments', framework);
+            for (const file of artifact.files) {
+                const filePath = path_1.default.join(outputDir, file.path);
+                await (0, file_system_1.ensureDirectoryExists)(path_1.default.dirname(filePath));
+                await (0, file_system_1.writeFile)(filePath, file.content);
+            }
+        }
+        this.emit('build:complete', artifact);
+        return artifact;
+    }
+    /**
+     * Deploy an artifact
+     */
+    async deploy(artifact, target) {
+        this.emit('deploy:start', { artifact, target });
+        for (const file of artifact.files) {
+            const filePath = path_1.default.join(target, file.path);
+            await (0, file_system_1.ensureDirectoryExists)(path_1.default.dirname(filePath));
+            await (0, file_system_1.writeFile)(filePath, file.content);
+        }
+        this.emit('deploy:complete', { artifact, target });
+    }
+    /**
+     * Resolve overlays
+     */
+    async resolveOverlays(type, name, platform) {
+        const resolver = new resolver_1.OverlayResolver(this.projectPath);
+        return resolver.resolveOverlays(type, name, platform);
+    }
+    /**
+     * Apply overlays to concept
+     */
+    async applyOverlays(concept, overlays) {
+        // Deep merge logic would go here
+        // For now, returning original concept
+        return concept;
+    }
+}
+exports.FaberAPI = FaberAPI;
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/bindings/claude-code/transformer.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Claude Code binding transformer
+ */
+import { Role, Config, DeploymentArtifact } from '../../types';
+import { Overlays } from '../../core/overlays';
+export declare class ClaudeCodeTransformer {
+    private bindingConfig;
+    private templates;
+    constructor(bindingConfigPath?: string);
+    /**
+     * Transform role to Claude Code deployment
+     */
+    transform(role: Role, config: Config, overlays: Overlays): Promise<DeploymentArtifact>;
+    /**
+     * Generate agent file content
+     */
+    private generateAgentFile;
+    /**
+     * Copy contexts to deployment
+     */
+    private copyContexts;
+    /**
+     * Copy overlay contexts to deployment
+     */
+    private copyOverlayContexts;
+    /**
+     * Copy tasks to deployment
+     */
+    private copyTasks;
+    /**
+     * Copy flows to deployment
+     */
+    private copyFlows;
+    /**
+     * Load binding configuration
+     */
+    private loadBindingConfig;
+    /**
+     * Load Handlebars templates
+     */
+    private loadTemplates;
+    /**
+     * Resolve path template
+     */
+    private resolvePath;
+    /**
+     * Collect overlay contexts for template
+     */
+    private collectOverlayContexts;
+    /**
+     * Get MCP servers used by role
+     */
+    private getMCPServers;
+}
+//# sourceMappingURL=transformer.d.ts.map

package/dist/bindings/claude-code/transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.d.ts","sourceRoot":"","sources":["../../../src/bindings/claude-code/transformer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EACL,IAAI,EACJ,MAAM,EACN,kBAAkB,EAKnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,qBAAa,qBAAqB;IAChC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,SAAS,CAGV;gBAEK,iBAAiB,CAAC,EAAE,MAAM;IAOtC;;OAEG;IACG,SAAS,CACb,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,kBAAkB,CAAC;IA6C9B;;OAEG;YACW,iBAAiB;IAuC/B;;OAEG;YACW,YAAY;IAyB1B;;OAEG;YACW,mBAAmB;IAuDjC;;OAEG;YACW,SAAS;IAkBvB;;OAEG;YACW,SAAS;IAkBvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkC9B;;OAEG;IACH,OAAO,CAAC,aAAa;CAgBtB"}