@audiofab-io/fv1-core 0.2.2 → 0.4.0

package/blocks/other/tone_gen_fixed.atl

@@ -0,0 +1,109 @@
+---
+{
+  "type": "other.tonegen.fixed",
+  "category": "Other",
+  "name": "Tone Generator (Fixed)",
+  "description": "Fixed frequency sine wave generator with amplitude control",
+  "color": "#FF9800",
+  "labelTemplate": "${param.frequency} Hz",
+  "inputs": [
+    { "id": "amplitude", "name": "Amplitude", "type": "control", "required": false }
+  ],
+  "outputs": [
+    { "id": "out", "name": "Output", "type": "audio" }
+  ],
+  "parameters": [
+    {
+      "id": "frequency",
+      "name": "Frequency",
+      "type": "number",
+      "default": 440,
+      "min": 20,
+      "max": 10000,
+      "step": 1
+    },
+    {
+      "id": "amplitude",
+      "name": "Amplitude",
+      "type": "number",
+      "default": 0.5,
+      "min": 0.0,
+      "max": 1.0,
+      "step": 0.01
+    }
+  ],
+  "registers": [
+    "freq", "s", "c", "p2fil", "amp"
+  ]
+}
+---
+@section init
+; Tone Generator (Fixed) init
+skp run, tonegen_fixed_init
+sof 0.0, 0.5
+wrax ${reg.s}, 0.0
+; The angle for frequency is approx (2*PI*freq) / (SampleRate*4) 
+sof 0.0, (6.2831853 * ${frequency}) / 131072.0
+wrax ${reg.freq}, 0.0
+tonegen_fixed_init:
+
+@section main
+; Sine Wave Generator - ${frequency} Hz (fixed)
+
+; Calculate amplitude (dB/step)
+@if pinConnected(amplitude)
+rdax ${input.amplitude}, 0.9375
+@else
+sof 0.0, (${amplitude} * 0.9375)
+@endif
+
+; Filter amplitude control
+rdfx ${reg.p2fil}, 0.01
+wrax ${reg.p2fil}, 1.0
+sof 1.0, -0.9375
+exp 1.0, 0.0
+wrax ${reg.amp}, 0.0
+
+; Rotation matrix oscillator (4x oversampled)
+
+; Iteration 1
+rdax ${reg.c}, 1.0
+mulx ${reg.freq}
+rdax ${reg.s}, 1.0
+wrax ${reg.s}, -1.0
+mulx ${reg.freq}
+rdax ${reg.c}, 1.0
+wrax ${reg.c}, 0.0
+
+; Iteration 2
+rdax ${reg.c}, 1.0
+mulx ${reg.freq}
+rdax ${reg.s}, 1.0
+wrax ${reg.s}, -1.0
+mulx ${reg.freq}
+rdax ${reg.c}, 1.0
+wrax ${reg.c}, 0.0
+
+; Iteration 3
+rdax ${reg.c}, 1.0
+mulx ${reg.freq}
+rdax ${reg.s}, 1.0
+wrax ${reg.s}, -1.0
+mulx ${reg.freq}
+rdax ${reg.c}, 1.0
+wrax ${reg.c}, 0.0
+
+; Iteration 4 (final - accumulate in ACC)
+rdax ${reg.c}, 1.0
+mulx ${reg.freq}
+rdax ${reg.s}, 1.0
+wrax ${reg.s}, -1.0
+mulx ${reg.freq}
+rdax ${reg.c}, 1.0
+wrax ${reg.c}, 1.99
+
+; Scale output by amplitude
+mulx ${reg.amp}
+
+; Write to output
+wrax ${output.out}, 0.0

package/dist/blockDiagram/blocks/BlockDirectoryLoader.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Node-only: recursively load ATL / JSON block definitions from a directory
+ * into a BlockRegistry. Kept separate from BlockRegistry so browser consumers
+ * never pull in `fs` / `path`.
+ */
+import { BlockRegistry } from './BlockRegistry.js';
+/**
+ * Recursively load .atl and .json block definitions from a directory into
+ * the provided registry. Errors on individual files are logged and skipped
+ * so one malformed file doesn't break the whole load.
+ */
+export declare function loadBlocksFromDirectory(registry: BlockRegistry, dir: string): void;
+//# sourceMappingURL=BlockDirectoryLoader.d.ts.map

package/dist/blockDiagram/blocks/BlockDirectoryLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockDirectoryLoader.d.ts","sourceRoot":"","sources":["../../../src/blockDiagram/blocks/BlockDirectoryLoader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CA2BlF"}

package/dist/blockDiagram/blocks/BlockDirectoryLoader.js

@@ -0,0 +1,44 @@
+/**
+ * Node-only: recursively load ATL / JSON block definitions from a directory
+ * into a BlockRegistry. Kept separate from BlockRegistry so browser consumers
+ * never pull in `fs` / `path`.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { BlockRegistry } from './BlockRegistry.js';
+/**
+ * Recursively load .atl and .json block definitions from a directory into
+ * the provided registry. Errors on individual files are logged and skipped
+ * so one malformed file doesn't break the whole load.
+ */
+export function loadBlocksFromDirectory(registry, dir) {
+    if (!fs.existsSync(dir)) {
+        return;
+    }
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            loadBlocksFromDirectory(registry, fullPath);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        try {
+            if (entry.name.endsWith('.json')) {
+                const content = fs.readFileSync(fullPath, 'utf8');
+                const definition = JSON.parse(content);
+                registry.registerDefinition(definition);
+            }
+            else if (entry.name.endsWith('.atl')) {
+                const content = fs.readFileSync(fullPath, 'utf8');
+                const definition = BlockRegistry.parseAtl(content);
+                registry.registerDefinition(definition);
+            }
+        }
+        catch (e) {
+            console.error(`Failed to load block definition ${fullPath}: ${e}`);
+        }
+    }
+}
+//# sourceMappingURL=BlockDirectoryLoader.js.map

package/dist/blockDiagram/blocks/BlockDirectoryLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockDirectoryLoader.js","sourceRoot":"","sources":["../../../src/blockDiagram/blocks/BlockDirectoryLoader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAuB,EAAE,GAAW;IACxE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO;IACX,CAAC;IACD,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACtB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC5C,SAAS;QACb,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,SAAS;QAE9B,IAAI,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAClD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;gBAClE,QAAQ,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAClD,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACnD,QAAQ,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,mCAAmC,QAAQ,KAAK,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/blockDiagram/blocks/BlockRegistry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Central registry for all available block types.
+ *
+ * Pure in-memory registry with no filesystem dependencies — runs in both
+ * Node (VS Code extension) and the browser. Consumers populate it via
+ * `loadManifest(defs)` or `register(block)`. For node-based directory
+ * scanning, see `./BlockDirectoryLoader.ts`.
+ */
+import { IBlockDefinition, BlockMetadata } from '../types/Block.js';
+import { BlockTemplateDefinition } from '../types/IR.js';
+export declare class BlockRegistry {
+    private blocks;
+    private categories;
+    private _onDidChangeBlocks;
+    readonly onDidChangeBlocks: (listener: (e: void) => void) => {
+        dispose: () => void;
+    };
+    /** Register a single already-instantiated block definition. */
+    register(block: IBlockDefinition): void;
+    /** Register a template definition (convenience around TemplateBlock). */
+    registerDefinition(definition: BlockTemplateDefinition): void;
+    /** Register a batch of template definitions (e.g. the built-in manifest). */
+    loadManifest(definitions: BlockTemplateDefinition[]): void;
+    /** Clear all registered blocks (used by refresh flows). */
+    clear(): void;
+    /** Notify subscribers that the registry contents have changed. */
+    fireChanged(): void;
+    /**
+     * Parse an ATL file body into a template definition. Format:
+     *     ---
+     *     { JSON metadata }
+     *     ---
+     *     assembly template body
+     */
+    static parseAtl(content: string): BlockTemplateDefinition;
+    getBlock(type: string): IBlockDefinition | undefined;
+    getAllTypes(): string[];
+    getBlocksByCategory(category: string): IBlockDefinition[];
+    getCategories(): string[];
+    getAllMetadata(): BlockMetadata[];
+    getMetadataByCategory(): Map<string, BlockMetadata[]>;
+}
+/**
+ * Default singleton — convenient for single-registry applications
+ * (the VS Code extension). Create your own instance for isolation if needed.
+ */
+export declare const blockRegistry: BlockRegistry;
+//# sourceMappingURL=BlockRegistry.d.ts.map

package/dist/blockDiagram/blocks/BlockRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockRegistry.d.ts","sourceRoot":"","sources":["../../../src/blockDiagram/blocks/BlockRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAczD,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,UAAU,CAAoC;IAEtD,OAAO,CAAC,kBAAkB,CAA4B;IACtD,SAAgB,iBAAiB,0BAdG,IAAI;;MAc0B;IAElE,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAQvC,yEAAyE;IACzE,kBAAkB,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI;IAI7D,6EAA6E;IAC7E,YAAY,CAAC,WAAW,EAAE,uBAAuB,EAAE,GAAG,IAAI;IAM1D,2DAA2D;IAC3D,KAAK,IAAI,IAAI;IAKb,kEAAkE;IAClE,WAAW,IAAI,IAAI;IAInB;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB;IAczD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIpD,WAAW,IAAI,MAAM,EAAE;IAIvB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAKzD,aAAa,IAAI,MAAM,EAAE;IAIzB,cAAc,IAAI,aAAa,EAAE;IAIjC,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;CAUxD;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/blockDiagram/blocks/BlockRegistry.js

@@ -0,0 +1,109 @@
+/**
+ * Central registry for all available block types.
+ *
+ * Pure in-memory registry with no filesystem dependencies — runs in both
+ * Node (VS Code extension) and the browser. Consumers populate it via
+ * `loadManifest(defs)` or `register(block)`. For node-based directory
+ * scanning, see `./BlockDirectoryLoader.ts`.
+ */
+import { TemplateBlock } from './TemplateBlock.js';
+// Minimal event emitter so the registry stays free of any host API.
+class EventEmitter {
+    constructor() {
+        this.listeners = [];
+        this.event = (listener) => {
+            this.listeners.push(listener);
+            return { dispose: () => { this.listeners = this.listeners.filter(l => l !== listener); } };
+        };
+    }
+    fire(data) {
+        this.listeners.forEach(l => l(data));
+    }
+}
+export class BlockRegistry {
+    constructor() {
+        this.blocks = new Map();
+        this.categories = new Map();
+        this._onDidChangeBlocks = new EventEmitter();
+        this.onDidChangeBlocks = this._onDidChangeBlocks.event;
+    }
+    /** Register a single already-instantiated block definition. */
+    register(block) {
+        this.blocks.set(block.type, block);
+        if (!this.categories.has(block.category)) {
+            this.categories.set(block.category, []);
+        }
+        this.categories.get(block.category).push(block.type);
+    }
+    /** Register a template definition (convenience around TemplateBlock). */
+    registerDefinition(definition) {
+        this.register(new TemplateBlock(definition));
+    }
+    /** Register a batch of template definitions (e.g. the built-in manifest). */
+    loadManifest(definitions) {
+        for (const def of definitions) {
+            this.registerDefinition(def);
+        }
+    }
+    /** Clear all registered blocks (used by refresh flows). */
+    clear() {
+        this.blocks.clear();
+        this.categories.clear();
+    }
+    /** Notify subscribers that the registry contents have changed. */
+    fireChanged() {
+        this._onDidChangeBlocks.fire();
+    }
+    /**
+     * Parse an ATL file body into a template definition. Format:
+     *     ---
+     *     { JSON metadata }
+     *     ---
+     *     assembly template body
+     */
+    static parseAtl(content) {
+        const parts = content.split('---');
+        if (parts.length < 3) {
+            throw new Error('Invalid ATL format: missing frontmatter delimiters (---)');
+        }
+        const metadata = JSON.parse(parts[1].trim());
+        const template = parts.slice(2).join('---').trim();
+        return {
+            ...metadata,
+            template,
+            _rawAtl: content,
+        };
+    }
+    getBlock(type) {
+        return this.blocks.get(type);
+    }
+    getAllTypes() {
+        return Array.from(this.blocks.keys());
+    }
+    getBlocksByCategory(category) {
+        const types = this.categories.get(category) || [];
+        return types.map(type => this.blocks.get(type)).filter(b => b !== undefined);
+    }
+    getCategories() {
+        return Array.from(this.categories.keys());
+    }
+    getAllMetadata() {
+        return Array.from(this.blocks.values()).map(block => block.getMetadata());
+    }
+    getMetadataByCategory() {
+        const result = new Map();
+        for (const [category, types] of this.categories.entries()) {
+            const metadata = types
+                .map(type => this.blocks.get(type)?.getMetadata())
+                .filter(m => m !== undefined);
+            result.set(category, metadata);
+        }
+        return result;
+    }
+}
+/**
+ * Default singleton — convenient for single-registry applications
+ * (the VS Code extension). Create your own instance for isolation if needed.
+ */
+export const blockRegistry = new BlockRegistry();
+//# sourceMappingURL=BlockRegistry.js.map

package/dist/blockDiagram/blocks/BlockRegistry.js.map

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

package/dist/blockDiagram/blocks/TemplateBlock.d.ts

@@ -0,0 +1,20 @@
+/**
+ * TemplateBlock
+ * Wrapper for declarative block definitions using the BlockTemplate engine.
+ */
+import { BaseBlock } from './base/BaseBlock.js';
+import { BlockTemplateDefinition } from '../types/IR.js';
+import { CodeGenContext } from '../types/Block.js';
+export declare class TemplateBlock extends BaseBlock {
+    readonly type: string;
+    readonly category: string;
+    readonly subcategory?: string;
+    readonly name: string;
+    readonly description: string;
+    private templateEngine;
+    constructor(definition: BlockTemplateDefinition);
+    getCustomLabel(params: Record<string, any>, ctx?: any, blockId?: string): string | null;
+    generateCode(ctx: CodeGenContext): void;
+    getRawTemplate(): string | undefined;
+}
+//# sourceMappingURL=TemplateBlock.d.ts.map

package/dist/blockDiagram/blocks/TemplateBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateBlock.d.ts","sourceRoot":"","sources":["../../../src/blockDiagram/blocks/TemplateBlock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,qBAAa,aAAc,SAAQ,SAAS;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,SAAiB,WAAW,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,cAAc,CAAgB;gBAE1B,UAAU,EAAE,uBAAuB;IAsC/C,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAiBvF,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAQvC,cAAc,IAAI,MAAM,GAAG,SAAS;CAevC"}

package/dist/blockDiagram/blocks/TemplateBlock.js

@@ -0,0 +1,82 @@
+/**
+ * TemplateBlock
+ * Wrapper for declarative block definitions using the BlockTemplate engine.
+ */
+import { BaseBlock } from './base/BaseBlock.js';
+import { BlockTemplate } from '../compiler/BlockTemplate.js';
+export class TemplateBlock extends BaseBlock {
+    constructor(definition) {
+        super();
+        this.type = definition.type;
+        this.category = definition.category;
+        this.subcategory = definition.subcategory;
+        this.name = definition.name;
+        this.description = definition.description;
+        this.color = definition.color || '#607D8B';
+        this.width = definition.width || 200;
+        this._inputs = definition.inputs.map(i => ({
+            ...i
+        }));
+        this._outputs = definition.outputs.map(o => ({
+            ...o
+        }));
+        this._parameters = definition.parameters.map(p => {
+            const param = {
+                ...p,
+                type: p.type
+            };
+            // Add display metadata for the UI ONLY if not already specified in ATL
+            if (p.conversion === 'LOGFREQ') {
+                if (param.displayMin === undefined)
+                    param.displayMin = p.min || 20;
+                if (param.displayMax === undefined)
+                    param.displayMax = p.max || 5000;
+                if (param.displayUnit === undefined)
+                    param.displayUnit = 'Hz';
+            }
+            else if (p.conversion === 'DBLEVEL') {
+                if (param.displayUnit === undefined)
+                    param.displayUnit = 'dB';
+            }
+            return param;
+        });
+        this.templateEngine = new BlockTemplate(definition);
+        this.autoCalculateHeight();
+    }
+    getCustomLabel(params, ctx, blockId) {
+        // Try resolving template from definition
+        const dynamicLabel = this.templateEngine.resolveLabel(params, ctx, blockId);
+        // If an explicit label template was provided (even if empty ""), respect it and skip fallback
+        if (dynamicLabel !== null)
+            return dynamicLabel;
+        // Fallback to frequency heuristic (only if no explicit label template exists)
+        const freqParam = this._parameters.find(p => p.conversion === 'LOGFREQ');
+        if (freqParam) {
+            const val = params[freqParam.id] ?? freqParam.default;
+            const hz = typeof val === 'number' && val < 1.0 ? this.filterCoeffToHz(val) : val;
+            return `${Math.round(hz)} Hz`;
+        }
+        return null;
+    }
+    generateCode(ctx) {
+        const blockInstance = ctx.getBlock(ctx.getCurrentBlock());
+        const irNodes = this.templateEngine.generateIR(blockInstance, ctx);
+        for (const node of irNodes) {
+            ctx.pushIR(node);
+        }
+    }
+    getRawTemplate() {
+        const def = this.templateEngine.definition;
+        if (!def)
+            return undefined;
+        if (def._rawAtl) {
+            return def._rawAtl;
+        }
+        // Fallback: Reconstruct ATL string
+        const metadata = { ...def };
+        delete metadata.template;
+        delete metadata._rawAtl;
+        return `---\n${JSON.stringify(metadata, null, 4)}\n---\n${def.template}`;
+    }
+}
+//# sourceMappingURL=TemplateBlock.js.map

package/dist/blockDiagram/blocks/TemplateBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateBlock.js","sourceRoot":"","sources":["../../../src/blockDiagram/blocks/TemplateBlock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,MAAM,OAAO,aAAc,SAAQ,SAAS;IASxC,YAAY,UAAmC;QAC3C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,SAAS,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,GAAG,CAAC;QAErC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACvC,GAAG,CAAC;SACP,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzC,GAAG,CAAC;SACP,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAC7C,MAAM,KAAK,GAAQ;gBACf,GAAG,CAAC;gBACJ,IAAI,EAAE,CAAC,CAAC,IAAW;aACtB,CAAC;YAEF,uEAAuE;YACvE,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;oBAAE,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;gBACnE,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;oBAAE,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;gBACrE,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;oBAAE,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;YAClE,CAAC;iBAAM,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACpC,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;oBAAE,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;YAClE,CAAC;YAED,OAAO,KAAK,CAAC;QACjB,CAAC,CAAQ,CAAC;QAEV,IAAI,CAAC,cAAc,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC/B,CAAC;IAED,cAAc,CAAC,MAA2B,EAAE,GAAS,EAAE,OAAgB;QACnE,yCAAyC;QACzC,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAE5E,8FAA8F;QAC9F,IAAI,YAAY,KAAK,IAAI;YAAE,OAAO,YAAY,CAAC;QAE/C,8EAA8E;QAC9E,MAAM,SAAS,GAAI,IAAI,CAAC,WAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC;QACpF,IAAI,SAAS,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC;YACtD,MAAM,EAAE,GAAG,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAClF,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,YAAY,CAAC,GAAmB;QAC5B,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAG,CAAE,CAAC;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QACnE,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YACzB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACL,CAAC;IAED,cAAc;QACV,MAAM,GAAG,GAAI,IAAI,CAAC,cAAsB,CAAC,UAAU,CAAC;QACpD,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAE3B,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,GAAG,CAAC,OAAO,CAAC;QACvB,CAAC;QAED,mCAAmC;QACnC,MAAM,QAAQ,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAC,QAAQ,CAAC;QACzB,OAAO,QAAQ,CAAC,OAAO,CAAC;QAExB,OAAO,QAAQ,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC7E,CAAC;CACJ"}