synapsexcoder 6.0.0

package/dist/modes/custom-mode-registry.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Custom Mode Registry
+ *
+ * Enhanced registry for user-defined processing modes with validation,
+ * persistence, dependency tracking, and mode composition.
+ *
+ * 5 Laws of Elegant Defense compliance:
+ * - Early Exit: Invalid operations return immediately
+ * - Make Illegal States Unrepresentable: Types enforce valid state
+ * - Atomic Predictability: No hidden mutations
+ * - Fail Fast: Missing dependencies raise immediately
+ * - Intentional Naming: Self-documenting interfaces
+ */
+import type { ModeDefinition } from "./synapse-modes.js";
+import { type ModeValidationResult, type ModePreview } from "./mode-designer.js";
+export interface RegisteredMode extends ModeDefinition {
+    /** Timestamp when registered */
+    registeredAt: string;
+    /** Validation result at registration time */
+    validation: ModeValidationResult;
+    /** Whether the mode is active */
+    enabled: boolean;
+    /** Usage count (approximate) */
+    usageCount: number;
+}
+export interface ModeComposition {
+    /** Parent mode this composition inherits from */
+    parent?: string;
+    /** Ordered list of mode IDs to compose */
+    composedOf: string[];
+    /** Execution strategy: sequential, parallel, or conditional */
+    strategy: "sequential" | "parallel" | "conditional";
+}
+export interface RegistryStats {
+    totalModes: number;
+    builtinModes: number;
+    customModes: number;
+    enabledModes: number;
+    disabledModes: number;
+    mostUsed: {
+        id: string;
+        count: number;
+    } | null;
+}
+export declare class CustomModeRegistry {
+    private modes;
+    private compositions;
+    private configPath;
+    constructor(configPath?: string);
+    /**
+     * Register a custom mode. Validates before registration.
+     * Throws if validation fails.
+     */
+    register(def: ModeDefinition): RegisteredMode;
+    /**
+     * Register multiple modes at once.
+     */
+    registerMany(defs: ModeDefinition[]): {
+        succeeded: number;
+        failed: number;
+        errors: string[];
+    };
+    /**
+     * Unregister a custom mode.
+     */
+    unregister(modeId: string): boolean;
+    /**
+     * Get a registered mode by ID.
+     */
+    get(modeId: string): RegisteredMode | undefined;
+    /**
+     * List all registered custom modes.
+     */
+    list(): RegisteredMode[];
+    /**
+     * List enabled custom modes only.
+     */
+    listEnabled(): RegisteredMode[];
+    /**
+     * Search custom modes by query (matches id, label, description).
+     */
+    search(query: string): RegisteredMode[];
+    /**
+     * Toggle mode enabled/disabled.
+     */
+    setEnabled(modeId: string, enabled: boolean): boolean;
+    /**
+     * Increment usage count for a mode.
+     */
+    recordUsage(modeId: string): void;
+    /**
+     * Define a mode composition (combining multiple modes).
+     */
+    defineComposition(modeId: string, composition: ModeComposition): void;
+    /**
+     * Get composition for a mode.
+     */
+    getComposition(modeId: string): ModeComposition | undefined;
+    /**
+     * Resolve the full chain of mode execution order.
+     * Follows composition tree recursively, deduplicating.
+     */
+    resolveExecutionChain(modeId: string): string[];
+    /**
+     * Generate a visual preview for a registered mode.
+     */
+    getPreview(modeId: string): ModePreview | null;
+    /**
+     * Get registry statistics.
+     */
+    getStats(): RegistryStats;
+    /**
+     * Load modes from config file.
+     */
+    private load;
+    /**
+     * Persist current state to config file.
+     */
+    private persist;
+}
+//# sourceMappingURL=custom-mode-registry.d.ts.map

package/dist/modes/custom-mode-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-mode-registry.d.ts","sourceRoot":"","sources":["../../src/modes/custom-mode-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAM5B,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,UAAU,EAAE,oBAAoB,CAAC;IACjC,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,EAAE,YAAY,GAAG,UAAU,GAAG,aAAa,CAAC;CACrD;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAChD;AAMD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,CAAC,EAAE,MAAM;IAU/B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,cAAc;IAqB7C;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAoB7F;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAYnC;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI/C;;OAEG;IACH,IAAI,IAAI,cAAc,EAAE;IAIxB;;OAEG;IACH,WAAW,IAAI,cAAc,EAAE;IAI/B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE;IAUvC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAQrD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAYjC;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,IAAI;IAgBrE;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI3D;;;OAGG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IA0B/C;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAU9C;;OAEG;IACH,QAAQ,IAAI,aAAa;IAqBzB;;OAEG;IACH,OAAO,CAAC,IAAI;IAoDZ;;OAEG;IACH,OAAO,CAAC,OAAO;CAmChB"}

package/dist/modes/custom-mode-registry.js

@@ -0,0 +1,306 @@
+/**
+ * Custom Mode Registry
+ *
+ * Enhanced registry for user-defined processing modes with validation,
+ * persistence, dependency tracking, and mode composition.
+ *
+ * 5 Laws of Elegant Defense compliance:
+ * - Early Exit: Invalid operations return immediately
+ * - Make Illegal States Unrepresentable: Types enforce valid state
+ * - Atomic Predictability: No hidden mutations
+ * - Fail Fast: Missing dependencies raise immediately
+ * - Intentional Naming: Self-documenting interfaces
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+import { homedir } from "os";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { validateModeDefinition, generateModePreview, } from "./mode-designer.js";
+// ============================================================================
+// CustomModeRegistry
+// ============================================================================
+export class CustomModeRegistry {
+    modes = new Map();
+    compositions = new Map();
+    configPath;
+    constructor(configPath) {
+        this.configPath =
+            configPath ?? join(homedir(), ".synapsexcoder", "custom-modes.yaml");
+        this.load();
+    }
+    // --------------------------------------------------------------------------
+    // Registration
+    // --------------------------------------------------------------------------
+    /**
+     * Register a custom mode. Validates before registration.
+     * Throws if validation fails.
+     */
+    register(def) {
+        const validation = validateModeDefinition(def);
+        if (!validation.valid) {
+            const msgs = validation.errors.map((e) => `  - ${e.field}: ${e.message}`).join("\n");
+            throw new Error(`Mode validation failed:\n${msgs}`);
+        }
+        const registered = {
+            ...def,
+            registeredAt: new Date().toISOString(),
+            validation,
+            enabled: true,
+            usageCount: 0,
+        };
+        this.modes.set(def.id, registered);
+        this.persist();
+        return registered;
+    }
+    /**
+     * Register multiple modes at once.
+     */
+    registerMany(defs) {
+        let succeeded = 0;
+        const errors = [];
+        for (const def of defs) {
+            try {
+                this.register(def);
+                succeeded++;
+            }
+            catch (e) {
+                errors.push(`${def.id}: ${e instanceof Error ? e.message : e}`);
+            }
+        }
+        return {
+            succeeded,
+            failed: defs.length - succeeded,
+            errors,
+        };
+    }
+    /**
+     * Unregister a custom mode.
+     */
+    unregister(modeId) {
+        const existed = this.modes.has(modeId);
+        this.modes.delete(modeId);
+        this.compositions.delete(modeId);
+        if (existed)
+            this.persist();
+        return existed;
+    }
+    // --------------------------------------------------------------------------
+    // Query
+    // --------------------------------------------------------------------------
+    /**
+     * Get a registered mode by ID.
+     */
+    get(modeId) {
+        return this.modes.get(modeId);
+    }
+    /**
+     * List all registered custom modes.
+     */
+    list() {
+        return Array.from(this.modes.values());
+    }
+    /**
+     * List enabled custom modes only.
+     */
+    listEnabled() {
+        return this.list().filter((m) => m.enabled);
+    }
+    /**
+     * Search custom modes by query (matches id, label, description).
+     */
+    search(query) {
+        const lower = query.toLowerCase();
+        return this.list().filter((m) => m.id.toLowerCase().includes(lower) ||
+            m.label.toLowerCase().includes(lower) ||
+            m.description.toLowerCase().includes(lower));
+    }
+    /**
+     * Toggle mode enabled/disabled.
+     */
+    setEnabled(modeId, enabled) {
+        const mode = this.modes.get(modeId);
+        if (!mode)
+            return false;
+        mode.enabled = enabled;
+        this.persist();
+        return true;
+    }
+    /**
+     * Increment usage count for a mode.
+     */
+    recordUsage(modeId) {
+        const mode = this.modes.get(modeId);
+        if (mode) {
+            mode.usageCount++;
+            this.persist();
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Composition
+    // --------------------------------------------------------------------------
+    /**
+     * Define a mode composition (combining multiple modes).
+     */
+    defineComposition(modeId, composition) {
+        if (!this.modes.has(modeId) && modeId !== composition.parent) {
+            throw new Error(`Mode "${modeId}" is not registered`);
+        }
+        // Validate that all composed modes exist
+        for (const dep of composition.composedOf) {
+            if (!this.modes.has(dep)) {
+                throw new Error(`Composition dependency "${dep}" is not registered`);
+            }
+        }
+        this.compositions.set(modeId, composition);
+        this.persist();
+    }
+    /**
+     * Get composition for a mode.
+     */
+    getComposition(modeId) {
+        return this.compositions.get(modeId);
+    }
+    /**
+     * Resolve the full chain of mode execution order.
+     * Follows composition tree recursively, deduplicating.
+     */
+    resolveExecutionChain(modeId) {
+        const visited = new Set();
+        const chain = [];
+        const resolve = (id) => {
+            if (visited.has(id))
+                return;
+            visited.add(id);
+            const comp = this.compositions.get(id);
+            if (comp) {
+                for (const dep of comp.composedOf) {
+                    resolve(dep);
+                }
+            }
+            chain.push(id);
+        };
+        resolve(modeId);
+        return chain;
+    }
+    // --------------------------------------------------------------------------
+    // Preview
+    // --------------------------------------------------------------------------
+    /**
+     * Generate a visual preview for a registered mode.
+     */
+    getPreview(modeId) {
+        const mode = this.modes.get(modeId);
+        if (!mode)
+            return null;
+        return generateModePreview(mode);
+    }
+    // --------------------------------------------------------------------------
+    // Statistics
+    // --------------------------------------------------------------------------
+    /**
+     * Get registry statistics.
+     */
+    getStats() {
+        const all = this.list();
+        const enabled = all.filter((m) => m.enabled);
+        const sorted = [...all].sort((a, b) => b.usageCount - a.usageCount);
+        return {
+            totalModes: all.length,
+            builtinModes: 16, // known built-in count
+            customModes: all.length,
+            enabledModes: enabled.length,
+            disabledModes: all.length - enabled.length,
+            mostUsed: sorted.length > 0 && sorted[0].usageCount > 0
+                ? { id: sorted[0].id, count: sorted[0].usageCount }
+                : null,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // Persistence
+    // --------------------------------------------------------------------------
+    /**
+     * Load modes from config file.
+     */
+    load() {
+        if (!existsSync(this.configPath))
+            return;
+        try {
+            const raw = readFileSync(this.configPath, "utf-8");
+            const doc = parseYaml(raw);
+            // Load registered modes
+            if (doc?.modes) {
+                for (const [id, data] of Object.entries(doc.modes)) {
+                    const modeData = data;
+                    const def = {
+                        id,
+                        label: modeData.label ?? id,
+                        description: modeData.description ?? "",
+                        agents: modeData.agents,
+                        tools: modeData.tools,
+                        basePipeline: modeData.basePipeline,
+                    };
+                    // Re-validate but allow loading even with warnings
+                    const validation = validateModeDefinition(def);
+                    this.modes.set(id, {
+                        ...def,
+                        registeredAt: modeData.registeredAt ?? new Date().toISOString(),
+                        validation,
+                        enabled: modeData.enabled ?? true,
+                        usageCount: modeData.usageCount ?? 0,
+                    });
+                }
+            }
+            // Load compositions
+            if (doc?.compositions) {
+                for (const [id, data] of Object.entries(doc.compositions)) {
+                    const comp = data;
+                    this.compositions.set(id, {
+                        parent: comp.parent,
+                        composedOf: comp.composedOf,
+                        strategy: comp.strategy ?? "sequential",
+                    });
+                }
+            }
+        }
+        catch {
+            // Silently fail — corrupted config should not crash the app
+        }
+    }
+    /**
+     * Persist current state to config file.
+     */
+    persist() {
+        const dir = dirname(this.configPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        const modes = {};
+        for (const [id, mode] of this.modes) {
+            modes[id] = {
+                label: mode.label,
+                description: mode.description,
+                agents: mode.agents,
+                tools: mode.tools,
+                basePipeline: mode.basePipeline,
+                registeredAt: mode.registeredAt,
+                enabled: mode.enabled,
+                usageCount: mode.usageCount,
+            };
+        }
+        const compositions = {};
+        for (const [id, comp] of this.compositions) {
+            compositions[id] = {
+                parent: comp.parent,
+                composedOf: comp.composedOf,
+                strategy: comp.strategy,
+            };
+        }
+        const output = {};
+        if (Object.keys(modes).length > 0)
+            output.modes = modes;
+        if (Object.keys(compositions).length > 0)
+            output.compositions = compositions;
+        writeFileSync(this.configPath, stringifyYaml(output), "utf-8");
+    }
+}
+//# sourceMappingURL=custom-mode-registry.js.map

package/dist/modes/custom-mode-registry.js.map

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

package/dist/modes/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Modes barrel export
+ */
+export { SynapseModeRegistry, synapseModeRegistry } from "./synapse-modes.js";
+export type { ModeDefinition } from "./synapse-modes.js";
+export { ModeManager, modeManager } from "./mode-manager.js";
+export type { ModeManagerStats } from "./mode-manager.js";
+export { CustomModeRegistry, type RegisteredMode, type ModeComposition, type RegistryStats, } from "./custom-mode-registry.js";
+export { validateModeDefinition, generateModePreview, getModeTemplates, getTemplatesByCategory, createFromTemplate, saveModeToFile, deleteModeFromFile, listCustomModesFromFile, modeToYaml, parseModeFromYaml, isBuiltInMode, type ModeDesignerOptions, type ModeValidationError, type ModeValidationResult, type ModeTemplate, type ModePreview, } from "./mode-designer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/modes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/modes/index.js

@@ -0,0 +1,8 @@
+/**
+ * Modes barrel export
+ */
+export { SynapseModeRegistry, synapseModeRegistry } from "./synapse-modes.js";
+export { ModeManager, modeManager } from "./mode-manager.js";
+export { CustomModeRegistry, } from "./custom-mode-registry.js";
+export { validateModeDefinition, generateModePreview, getModeTemplates, getTemplatesByCategory, createFromTemplate, saveModeToFile, deleteModeFromFile, listCustomModesFromFile, modeToYaml, parseModeFromYaml, isBuiltInMode, } from "./mode-designer.js";
+//# sourceMappingURL=index.js.map

package/dist/modes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,EACL,kBAAkB,GAInB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,UAAU,EACV,iBAAiB,EACjB,aAAa,GAMd,MAAM,oBAAoB,CAAC"}

package/dist/modes/mode-designer.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Mode Designer
+ *
+ * Custom mode definition designer with YAML/JSON parsing, validation,
+ * template generation, and visual preview. Follows the 5 Laws of Elegant Defense:
+ * - Early Exit: Parse failures return immediately
+ * - Make Illegal States Unrepresentable: Schema validation at boundaries
+ * - Atomic Predictability: Pure functions where possible
+ * - Fail Fast: Invalid mode definitions raise immediately
+ * - Intentional Naming: Self-documenting interfaces
+ */
+import type { ModeDefinition } from "./synapse-modes.js";
+export interface ModeDesignerOptions {
+    /** Directory for custom mode files (default: ~/.synapsexcoder/modes/) */
+    modesDir?: string;
+    /** Default custom modes config path */
+    configPath?: string;
+}
+export interface ModeValidationError {
+    field: string;
+    message: string;
+    severity: "error" | "warning";
+}
+export interface ModeValidationResult {
+    valid: boolean;
+    errors: ModeValidationError[];
+    warnings: ModeValidationError[];
+    suggestion?: string;
+}
+export interface ModeTemplate {
+    name: string;
+    description: string;
+    template: ModeDefinition;
+    category: "analysis" | "generation" | "security" | "debug" | "custom";
+}
+export interface ModePreview {
+    markdown: string;
+    agentCount: number;
+    pipelineSteps: string[];
+    description: string;
+    pipelineChain: string[];
+}
+/**
+ * Validate a custom mode definition against schema constraints.
+ * Pure function — no side effects.
+ */
+export declare function validateModeDefinition(def: unknown): ModeValidationResult;
+/**
+ * Get all available mode templates.
+ */
+export declare function getModeTemplates(): ModeTemplate[];
+/**
+ * Get templates by category.
+ */
+export declare function getTemplatesByCategory(category: ModeTemplate["category"]): ModeTemplate[];
+/**
+ * Create a mode definition from a template.
+ */
+export declare function createFromTemplate(templateName: string, overrides?: Partial<ModeDefinition>): ModeDefinition | null;
+/**
+ * Save a mode definition to the custom modes YAML file.
+ */
+export declare function saveModeToFile(def: ModeDefinition, options?: ModeDesignerOptions): void;
+/**
+ * Delete a mode from the custom modes YAML file.
+ */
+export declare function deleteModeFromFile(modeId: string, options?: ModeDesignerOptions): boolean;
+/**
+ * List custom modes from the YAML config file.
+ */
+export declare function listCustomModesFromFile(options?: ModeDesignerOptions): ModeDefinition[];
+/**
+ * Generate a visual preview of a mode definition as Markdown.
+ * Pure function — no side effects.
+ */
+export declare function generateModePreview(def: ModeDefinition): ModePreview;
+/**
+ * Check if a mode ID is a built-in mode.
+ */
+export declare function isBuiltInMode(modeId: string): boolean;
+/**
+ * Convert a mode definition to YAML string.
+ */
+export declare function modeToYaml(def: ModeDefinition): string;
+/**
+ * Parse a YAML string into a mode definition.
+ */
+export declare function parseModeFromYaml(yaml: string, modeId?: string): ModeDefinition | null;
+//# sourceMappingURL=mode-designer.d.ts.map

package/dist/modes/mode-designer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-designer.d.ts","sourceRoot":"","sources":["../../src/modes/mode-designer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMzD,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;CACvE;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAwFD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CAyHzE;AAyBD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,EAAE,CAEjD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,GAAG,YAAY,EAAE,CAEzF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAClC,cAAc,GAAG,IAAI,CASvB;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,cAAc,EACnB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CA8BN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAaT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,cAAc,EAAE,CAqBlB;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,WAAW,CAyEpE;AA8BD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAYtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,cAAc,GAAG,IAAI,CAqCvB"}