@robinmordasiewicz/f5xc-api-mcp 3.5.0 → 3.6.0

package/dist/generator/dependency-graph.js

@@ -0,0 +1,330 @@
+/**
+ * Dependency Graph Builder
+ *
+ * Builds a complete resource dependency graph from parsed operations,
+ * computes reverse dependencies, and provides topological sorting
+ * for resource creation order.
+ */
+import { createResourceKey, parseResourceKey } from "./dependency-types.js";
+/**
+ * Build a complete dependency graph from parsed specifications
+ *
+ * @param specs - Array of parsed specification files
+ * @param options - Graph generation options
+ * @returns Complete dependency graph
+ */
+export function buildDependencyGraph(specs, options = {}) {
+    const opts = {
+        detectInlineRefs: true,
+        computeCreationOrder: true,
+        buildReverseDeps: true,
+        maxDepth: 10,
+        ...options,
+    };
+    // Collect all operations from all specs
+    const allOperations = [];
+    for (const spec of specs) {
+        allOperations.push(...spec.operations);
+    }
+    // Build resource map: domain/resource -> operations
+    const resourceMap = new Map();
+    for (const op of allOperations) {
+        const key = createResourceKey(op.domain, op.resource);
+        const existing = resourceMap.get(key) || [];
+        existing.push(op);
+        resourceMap.set(key, existing);
+    }
+    // Build dependencies map
+    const dependencies = {};
+    for (const [resourceKey, operations] of resourceMap) {
+        const { domain, resource } = parseResourceKey(resourceKey);
+        // Aggregate all dependencies, oneOf groups, and subscriptions from all operations
+        const allRefs = [];
+        const allOneOfGroups = [];
+        const allSubscriptions = [];
+        for (const op of operations) {
+            allRefs.push(...op.dependencies);
+            allOneOfGroups.push(...op.oneOfGroups);
+            allSubscriptions.push(...op.subscriptionRequirements);
+        }
+        // Deduplicate references by resourceType
+        const uniqueRefs = deduplicateReferences(allRefs);
+        // Deduplicate oneOf groups by choiceField
+        const uniqueOneOfGroups = deduplicateOneOfGroups(allOneOfGroups);
+        // Deduplicate subscriptions by addonService
+        const uniqueSubscriptions = deduplicateSubscriptions(allSubscriptions);
+        dependencies[resourceKey] = {
+            resource,
+            domain,
+            requires: uniqueRefs,
+            requiredBy: [], // Will be computed by buildReverseDependencies
+            oneOfGroups: uniqueOneOfGroups,
+            subscriptions: uniqueSubscriptions,
+            creationOrder: [], // Will be computed by computeCreationOrder
+        };
+    }
+    // Build reverse dependencies
+    const reverseDependencies = {};
+    if (opts.buildReverseDeps) {
+        buildReverseDependencies(dependencies, reverseDependencies);
+    }
+    // Compute creation order for each resource
+    if (opts.computeCreationOrder) {
+        for (const resourceKey of Object.keys(dependencies)) {
+            const dep = dependencies[resourceKey];
+            if (dep) {
+                dep.creationOrder = computeCreationOrder(resourceKey, dependencies, opts.maxDepth);
+            }
+        }
+    }
+    // Build addon service map
+    const addonServiceMap = {};
+    for (const [resourceKey, deps] of Object.entries(dependencies)) {
+        for (const sub of deps.subscriptions) {
+            const existingList = addonServiceMap[sub.addonService];
+            if (!existingList) {
+                addonServiceMap[sub.addonService] = [resourceKey];
+            }
+            else if (!existingList.includes(resourceKey)) {
+                existingList.push(resourceKey);
+            }
+        }
+    }
+    return {
+        version: "1.0.0",
+        generatedAt: opts.generatedAt || new Date().toISOString(),
+        totalResources: Object.keys(dependencies).length,
+        dependencies,
+        addonServiceMap,
+        reverseDependencies,
+    };
+}
+/**
+ * Deduplicate resource references by resourceType
+ */
+function deduplicateReferences(refs) {
+    const seen = new Map();
+    for (const ref of refs) {
+        const key = `${ref.domain}/${ref.resourceType}`;
+        const existing = seen.get(key);
+        if (!existing) {
+            seen.set(key, ref);
+        }
+        else {
+            // Merge: required takes precedence, inline is combined
+            seen.set(key, {
+                ...existing,
+                required: existing.required || ref.required,
+                inline: existing.inline || ref.inline,
+            });
+        }
+    }
+    return Array.from(seen.values());
+}
+/**
+ * Deduplicate oneOf groups by choiceField
+ */
+function deduplicateOneOfGroups(groups) {
+    const seen = new Map();
+    for (const group of groups) {
+        if (!seen.has(group.choiceField)) {
+            seen.set(group.choiceField, group);
+        }
+        // If already seen, keep the first occurrence
+    }
+    return Array.from(seen.values());
+}
+/**
+ * Deduplicate subscriptions by addonService
+ */
+function deduplicateSubscriptions(subs) {
+    const seen = new Map();
+    for (const sub of subs) {
+        if (!seen.has(sub.addonService)) {
+            seen.set(sub.addonService, sub);
+        }
+    }
+    return Array.from(seen.values());
+}
+/**
+ * Build reverse dependency map (requiredBy relationships)
+ */
+function buildReverseDependencies(dependencies, reverseDeps) {
+    for (const deps of Object.values(dependencies)) {
+        for (const ref of deps.requires) {
+            const refKey = createResourceKey(ref.domain || "unknown", ref.resourceType);
+            if (!reverseDeps[refKey]) {
+                reverseDeps[refKey] = [];
+            }
+            // Add reverse reference
+            reverseDeps[refKey].push({
+                resourceType: deps.resource,
+                domain: deps.domain,
+                fieldPath: ref.fieldPath,
+                required: ref.required,
+                inline: ref.inline,
+            });
+            // Also update the requiredBy on the target if it exists
+            const targetDep = dependencies[refKey];
+            if (targetDep) {
+                targetDep.requiredBy.push({
+                    resourceType: deps.resource,
+                    domain: deps.domain,
+                    fieldPath: ref.fieldPath,
+                    required: ref.required,
+                    inline: ref.inline,
+                });
+            }
+        }
+    }
+}
+/**
+ * Compute topologically sorted creation order for a resource
+ * Uses depth-first search with cycle detection
+ *
+ * @param resourceKey - The resource to compute creation order for
+ * @param dependencies - All resource dependencies
+ * @param maxDepth - Maximum depth for traversal
+ * @returns Array of resource keys in creation order
+ */
+export function computeCreationOrder(resourceKey, dependencies, maxDepth = 10) {
+    const order = [];
+    const visited = new Set();
+    const inProgress = new Set(); // For cycle detection
+    function visit(key, depth) {
+        if (depth > maxDepth) {
+            return; // Prevent infinite recursion
+        }
+        if (inProgress.has(key)) {
+            // Cycle detected, skip
+            return;
+        }
+        if (visited.has(key)) {
+            return;
+        }
+        inProgress.add(key);
+        const deps = dependencies[key];
+        if (deps) {
+            // Visit required dependencies first
+            for (const ref of deps.requires) {
+                const refKey = createResourceKey(ref.domain || "unknown", ref.resourceType);
+                visit(refKey, depth + 1);
+            }
+        }
+        inProgress.delete(key);
+        visited.add(key);
+        order.push(key);
+    }
+    visit(resourceKey, 0);
+    return order;
+}
+/**
+ * Serialize a dependency graph to JSON-compatible format
+ */
+export function serializeDependencyGraph(graph) {
+    const serialized = {
+        version: graph.version,
+        generatedAt: graph.generatedAt,
+        totalResources: graph.totalResources,
+        dependencies: graph.dependencies,
+        addonServiceMap: graph.addonServiceMap,
+        reverseDependencies: graph.reverseDependencies,
+    };
+    return JSON.stringify(serialized, null, 2);
+}
+/**
+ * Deserialize a dependency graph from JSON
+ */
+export function deserializeDependencyGraph(json) {
+    const parsed = JSON.parse(json);
+    return {
+        version: parsed.version,
+        generatedAt: parsed.generatedAt,
+        totalResources: parsed.totalResources,
+        dependencies: parsed.dependencies,
+        addonServiceMap: parsed.addonServiceMap,
+        reverseDependencies: parsed.reverseDependencies,
+    };
+}
+/**
+ * Get resources that must be created before a given resource
+ *
+ * @param resourceKey - The target resource ("domain/resource")
+ * @param graph - The dependency graph
+ * @returns Array of prerequisite resource keys
+ */
+export function getPrerequisites(resourceKey, graph) {
+    const deps = graph.dependencies[resourceKey];
+    if (!deps) {
+        return [];
+    }
+    return deps.requires.map((ref) => createResourceKey(ref.domain || "unknown", ref.resourceType));
+}
+/**
+ * Get resources that depend on a given resource
+ *
+ * @param resourceKey - The target resource ("domain/resource")
+ * @param graph - The dependency graph
+ * @returns Array of dependent resource keys
+ */
+export function getDependents(resourceKey, graph) {
+    const reverseDeps = graph.reverseDependencies[resourceKey];
+    if (!reverseDeps) {
+        return [];
+    }
+    return reverseDeps.map((ref) => createResourceKey(ref.domain, ref.resourceType));
+}
+/**
+ * Get all resources that require a specific subscription
+ *
+ * @param addonService - The addon service ID
+ * @param graph - The dependency graph
+ * @returns Array of resource keys requiring this subscription
+ */
+export function getResourcesBySubscription(addonService, graph) {
+    return graph.addonServiceMap[addonService] || [];
+}
+/**
+ * Validate the dependency graph for cycles
+ *
+ * @param graph - The dependency graph to validate
+ * @returns Array of cycle paths found (empty if no cycles)
+ */
+export function validateGraph(graph) {
+    const cycles = [];
+    const visited = new Set();
+    const recStack = new Set();
+    const path = [];
+    function dfs(key) {
+        if (recStack.has(key)) {
+            // Found a cycle - extract the cycle from current path
+            const cycleStart = path.indexOf(key);
+            if (cycleStart >= 0) {
+                cycles.push([...path.slice(cycleStart), key]);
+            }
+            return;
+        }
+        if (visited.has(key)) {
+            return;
+        }
+        visited.add(key);
+        recStack.add(key);
+        path.push(key);
+        const deps = graph.dependencies[key];
+        if (deps) {
+            for (const ref of deps.requires) {
+                const refKey = createResourceKey(ref.domain || "unknown", ref.resourceType);
+                dfs(refKey);
+            }
+        }
+        path.pop();
+        recStack.delete(key);
+    }
+    for (const key of Object.keys(graph.dependencies)) {
+        if (!visited.has(key)) {
+            dfs(key);
+        }
+    }
+    return cycles;
+}
+//# sourceMappingURL=dependency-graph.js.map

package/dist/generator/dependency-graph.js.map

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

package/dist/generator/dependency-types.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Dependency Intelligence Type Definitions
+ *
+ * Types for resource dependency tracking, oneOf/anyOf field extraction,
+ * subscription awareness, and sequencing intelligence.
+ *
+ * These types enable LLMs to understand resource relationships and
+ * execute operations in the correct order.
+ */
+/**
+ * Represents a reference from one resource to another via $ref patterns
+ */
+export interface ResourceReference {
+    /** The type of resource being referenced (e.g., "origin_pool") */
+    resourceType: string;
+    /** The domain the referenced resource belongs to (e.g., "network") */
+    domain: string;
+    /** The JSON path where this reference appears (e.g., "spec.default_route_pools") */
+    fieldPath: string;
+    /** Whether this reference is required for the parent resource to function */
+    required: boolean;
+    /** Whether the reference allows inline definition vs external reference only */
+    inline: boolean;
+}
+/**
+ * Represents a group of mutually exclusive fields (oneOf/anyOf patterns)
+ * Extracted from x-ves-oneof-field-* OpenAPI extensions
+ */
+export interface OneOfGroup {
+    /** The name of the choice field (e.g., "advertise_choice") */
+    choiceField: string;
+    /** Available options for this choice (e.g., ["site", "virtual_site", "public_default_vip"]) */
+    options: string[];
+    /** JSON path where this oneOf group appears */
+    fieldPath: string;
+    /** Human-readable description of the choice */
+    description?: string;
+}
+/**
+ * Represents a subscription or addon service requirement
+ */
+export interface SubscriptionRequirement {
+    /** Internal addon service identifier (e.g., "f5xc_waap_advanced") */
+    addonService: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Subscription tier level (e.g., "advanced", "premium") */
+    tier: string;
+    /** Whether this subscription is required or optional for the resource */
+    required: boolean;
+}
+/**
+ * Complete dependency information for a single resource
+ */
+export interface ResourceDependencies {
+    /** Resource name (e.g., "http-loadbalancer") */
+    resource: string;
+    /** Domain the resource belongs to (e.g., "virtual") */
+    domain: string;
+    /** Resources this resource depends on (must exist before creation) */
+    requires: ResourceReference[];
+    /** Resources that depend on this resource (will break if deleted) */
+    requiredBy: ResourceReference[];
+    /** Mutually exclusive field groups within this resource */
+    oneOfGroups: OneOfGroup[];
+    /** Subscription/addon requirements for this resource */
+    subscriptions: SubscriptionRequirement[];
+    /** Topologically sorted creation order for this resource and its dependencies */
+    creationOrder: string[];
+}
+/**
+ * Complete dependency graph for the entire API
+ */
+export interface DependencyGraph {
+    /** Schema version for forwards compatibility */
+    version: string;
+    /** Timestamp when the graph was generated */
+    generatedAt: string;
+    /** Total number of resources in the graph */
+    totalResources: number;
+    /** Map of "domain/resource" -> ResourceDependencies */
+    dependencies: Record<string, ResourceDependencies>;
+    /** Map of addon service ID -> list of resources requiring it */
+    addonServiceMap: Record<string, string[]>;
+    /** Reverse dependency lookup: "domain/resource" -> resources that depend on it */
+    reverseDependencies: Record<string, ResourceReference[]>;
+}
+/**
+ * Serializable version of DependencyGraph for JSON storage
+ * Uses Record instead of Map for JSON compatibility
+ */
+export interface SerializedDependencyGraph {
+    version: string;
+    generatedAt: string;
+    totalResources: number;
+    dependencies: Record<string, ResourceDependencies>;
+    addonServiceMap: Record<string, string[]>;
+    reverseDependencies: Record<string, ResourceReference[]>;
+}
+/**
+ * Result of parsing a $ref string from OpenAPI schema
+ */
+export interface ParsedRef {
+    /** Full schema path (e.g., "#/components/schemas/origin_poolCreateRequest") */
+    fullPath: string;
+    /** Extracted schema name (e.g., "origin_poolCreateRequest") */
+    schemaName: string;
+    /** Inferred resource type (e.g., "origin_pool") */
+    resourceType: string | null;
+    /** Inferred operation type (e.g., "create", "get", "list") */
+    operationType: string | null;
+}
+/**
+ * Extracted dependency information from a single operation's schema
+ */
+export interface ExtractedDependencies {
+    /** Direct resource references found in the schema */
+    references: ResourceReference[];
+    /** OneOf groups found in the schema */
+    oneOfGroups: OneOfGroup[];
+}
+/**
+ * Addon service definition extracted from billing specs
+ */
+export interface AddonServiceDefinition {
+    /** Internal service identifier */
+    serviceId: string;
+    /** Human-readable name */
+    displayName: string;
+    /** Service category/tier */
+    tier: string;
+    /** Description of the service */
+    description?: string;
+}
+/**
+ * Options for dependency graph generation
+ */
+export interface DependencyGraphOptions {
+    /** Whether to include inline reference capability detection */
+    detectInlineRefs: boolean;
+    /** Whether to compute full creation order sequences */
+    computeCreationOrder: boolean;
+    /** Whether to build reverse dependency map */
+    buildReverseDeps: boolean;
+    /** Maximum depth for dependency chain traversal */
+    maxDepth: number;
+    /** Fixed timestamp for deterministic generation (optional) */
+    generatedAt?: string;
+}
+/**
+ * Default options for dependency graph generation
+ */
+export declare const DEFAULT_DEPENDENCY_OPTIONS: DependencyGraphOptions;
+/**
+ * Discovery tool response format for dependency queries
+ */
+export interface DependencyDiscoveryResponse {
+    /** The queried resource */
+    resource: string;
+    /** The queried domain */
+    domain: string;
+    /** Human-readable list of prerequisites */
+    prerequisites: string[];
+    /** Human-readable list of dependent resources */
+    dependents: string[];
+    /** Mutually exclusive field information */
+    mutuallyExclusiveFields: Array<{
+        field: string;
+        options: string[];
+    }>;
+    /** Required subscription/addon services */
+    subscriptionRequirements: string[];
+    /** Recommended creation sequence for this resource */
+    creationSequence: string[];
+}
+/**
+ * Actions available for the f5xc-api-dependencies discovery tool
+ */
+export type DependencyDiscoveryAction = "prerequisites" | "dependents" | "oneOf" | "subscriptions" | "creationOrder" | "full";
+/**
+ * Input schema for the f5xc-api-dependencies discovery tool
+ */
+export interface DependencyDiscoveryInput {
+    /** Resource name to query (e.g., "http-loadbalancer") */
+    resource: string;
+    /** Domain containing the resource (e.g., "virtual") */
+    domain: string;
+    /** Type of dependency information to retrieve */
+    action: DependencyDiscoveryAction;
+}
+/**
+ * Resource key format: "domain/resource"
+ */
+export type ResourceKey = `${string}/${string}`;
+/**
+ * Helper to create a resource key from domain and resource
+ */
+export declare function createResourceKey(domain: string, resource: string): ResourceKey;
+/**
+ * Helper to parse a resource key into domain and resource
+ */
+export declare function parseResourceKey(key: ResourceKey): {
+    domain: string;
+    resource: string;
+};
+//# sourceMappingURL=dependency-types.d.ts.map

package/dist/generator/dependency-types.d.ts.map

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

package/dist/generator/dependency-types.js

@@ -0,0 +1,37 @@
+/**
+ * Dependency Intelligence Type Definitions
+ *
+ * Types for resource dependency tracking, oneOf/anyOf field extraction,
+ * subscription awareness, and sequencing intelligence.
+ *
+ * These types enable LLMs to understand resource relationships and
+ * execute operations in the correct order.
+ */
+/**
+ * Default options for dependency graph generation
+ */
+export const DEFAULT_DEPENDENCY_OPTIONS = {
+    detectInlineRefs: true,
+    computeCreationOrder: true,
+    buildReverseDeps: true,
+    maxDepth: 10,
+};
+/**
+ * Helper to create a resource key from domain and resource
+ */
+export function createResourceKey(domain, resource) {
+    return `${domain}/${resource}`;
+}
+/**
+ * Helper to parse a resource key into domain and resource
+ */
+export function parseResourceKey(key) {
+    const parts = key.split("/");
+    const domain = parts[0] ?? "";
+    const resource = parts.slice(1).join("/");
+    return {
+        domain,
+        resource,
+    };
+}
+//# sourceMappingURL=dependency-types.js.map

package/dist/generator/dependency-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-types.js","sourceRoot":"","sources":["../../src/generator/dependency-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwJH;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAA2B;IAChE,gBAAgB,EAAE,IAAI;IACtB,oBAAoB,EAAE,IAAI;IAC1B,gBAAgB,EAAE,IAAI;IACtB,QAAQ,EAAE,EAAE;CACb,CAAC;AAqDF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,QAAgB;IAChE,OAAO,GAAG,MAAM,IAAI,QAAQ,EAAiB,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAgB;IAC/C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO;QACL,MAAM;QACN,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/generator/openapi-parser.d.ts

@@ -5,6 +5,7 @@
  * operation metadata for MCP tool generation.
  */
 import { z } from "zod";
+import type { ResourceReference, OneOfGroup, SubscriptionRequirement } from "./dependency-types.js";
 /**
  * OpenAPI Schema Types
  */
@@ -639,6 +640,12 @@ export interface ParsedOperation {
     operationMetadata: OperationMetadata | null;
     /** Curl example from schema x-ves-minimum-configuration */
     curlExample: string | null;
+    /** Resource dependencies extracted from $ref patterns */
+    dependencies: ResourceReference[];
+    /** Mutually exclusive field groups from x-ves-oneof-field-* */
+    oneOfGroups: OneOfGroup[];
+    /** Subscription/addon service requirements */
+    subscriptionRequirements: SubscriptionRequirement[];
 }
 /**
  * Parsed specification file

package/dist/generator/openapi-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-parser.d.ts","sourceRoot":"","sources":["../../src/generator/openapi-parser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"openapi-parser.d.ts","sourceRoot":"","sources":["../../src/generator/openapi-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AASpG;;GAEG;AACH,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;iBAW1B,CAAC;AAsEH,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiB1B,CAAC;AAWH,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAerB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE;QACX,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;IACF,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,YAAY,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,yBAAyB,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,uBAAuB;IACvB,eAAe,EAAE,gBAAgB,EAAE,CAAC;IACpC,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClD,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,0BAA0B;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IAGnB,kDAAkD;IAClD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,wDAAwD;IACxD,WAAW,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9C,yDAAyD;IACzD,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,gEAAgE;IAChE,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,qEAAqE;IACrE,oBAAoB,EAAE,OAAO,CAAC;IAC9B,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,4DAA4D;IAC5D,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,2DAA2D;IAC3D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAG3B,yDAAyD;IACzD,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,+DAA+D;IAC/D,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,8CAA8C;IAC9C,wBAAwB,EAAE,uBAAuB,EAAE,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA0CpF;AAmRD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAyChE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,eAAe,EAAE,CAgBvE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,eAAe,EAAE,GAC5B,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAwBhC;AAiLD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA+C1F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAuCnE"}