@principal-ai/subsystems-core 0.29.0 → 0.30.0

package/dist/spans/index.d.ts

@@ -1,12 +0,0 @@
-/**
- * Spans module
- *
- * Provides utilities for working with span conventions from .spans.canvas files.
- * Span colors are used as fill colors for events emitted within that span.
- *
- * Color Contract:
- * - Scope color → Border (from library.yaml owned-scopes)
- * - Span color → Fill (from .spans.canvas)
- */
-export { DEFAULT_SPAN_COLOR, extractSpanConvention, extractSpanConventions, buildSpanColorMap, buildSpanColorMapFromCanvases, buildSpanIconMap, matchSpanPattern, getSpanColor, getSpanIcon, resolveEventSpanColor, type NormalizedSpanConvention, } from './utils';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spans/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,6BAA6B,EAC7B,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,KAAK,wBAAwB,GAC9B,MAAM,SAAS,CAAC"}

package/dist/spans/index.js

@@ -1,25 +0,0 @@
-"use strict";
-/**
- * Spans module
- *
- * Provides utilities for working with span conventions from .spans.canvas files.
- * Span colors are used as fill colors for events emitted within that span.
- *
- * Color Contract:
- * - Scope color → Border (from library.yaml owned-scopes)
- * - Span color → Fill (from .spans.canvas)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveEventSpanColor = exports.getSpanIcon = exports.getSpanColor = exports.matchSpanPattern = exports.buildSpanIconMap = exports.buildSpanColorMapFromCanvases = exports.buildSpanColorMap = exports.extractSpanConventions = exports.extractSpanConvention = exports.DEFAULT_SPAN_COLOR = void 0;
-var utils_1 = require("./utils");
-Object.defineProperty(exports, "DEFAULT_SPAN_COLOR", { enumerable: true, get: function () { return utils_1.DEFAULT_SPAN_COLOR; } });
-Object.defineProperty(exports, "extractSpanConvention", { enumerable: true, get: function () { return utils_1.extractSpanConvention; } });
-Object.defineProperty(exports, "extractSpanConventions", { enumerable: true, get: function () { return utils_1.extractSpanConventions; } });
-Object.defineProperty(exports, "buildSpanColorMap", { enumerable: true, get: function () { return utils_1.buildSpanColorMap; } });
-Object.defineProperty(exports, "buildSpanColorMapFromCanvases", { enumerable: true, get: function () { return utils_1.buildSpanColorMapFromCanvases; } });
-Object.defineProperty(exports, "buildSpanIconMap", { enumerable: true, get: function () { return utils_1.buildSpanIconMap; } });
-Object.defineProperty(exports, "matchSpanPattern", { enumerable: true, get: function () { return utils_1.matchSpanPattern; } });
-Object.defineProperty(exports, "getSpanColor", { enumerable: true, get: function () { return utils_1.getSpanColor; } });
-Object.defineProperty(exports, "getSpanIcon", { enumerable: true, get: function () { return utils_1.getSpanIcon; } });
-Object.defineProperty(exports, "resolveEventSpanColor", { enumerable: true, get: function () { return utils_1.resolveEventSpanColor; } });
-//# sourceMappingURL=index.js.map

package/dist/spans/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/spans/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,iCAYiB;AAXf,2GAAA,kBAAkB,OAAA;AAClB,8GAAA,qBAAqB,OAAA;AACrB,+GAAA,sBAAsB,OAAA;AACtB,0GAAA,iBAAiB,OAAA;AACjB,sHAAA,6BAA6B,OAAA;AAC7B,yGAAA,gBAAgB,OAAA;AAChB,yGAAA,gBAAgB,OAAA;AAChB,qGAAA,YAAY,OAAA;AACZ,oGAAA,WAAW,OAAA;AACX,8GAAA,qBAAqB,OAAA"}

package/dist/spans/utils.d.ts

@@ -1,70 +0,0 @@
-/**
- * Span utility functions
- *
- * Helpers for working with span conventions from .spans.canvas files.
- * Span colors are used as fill colors for events emitted within that span.
- */
-import type { ExtendedCanvas, ExtendedCanvasNode } from '../types/canvas';
-/** Default color for spans without a defined color */
-export declare const DEFAULT_SPAN_COLOR = "#9CA3AF";
-/**
- * Normalized span convention entry
- */
-export interface NormalizedSpanConvention {
-    /** Unique identifier for this span convention */
-    id: string;
-    /** Pattern to match span names (e.g., "validate.*") */
-    spanPattern: string;
-    /** Color for this span (used as fill for events) */
-    color: string;
-    /** Icon identifier (Lucide icons) */
-    icon?: string;
-    /** Human-readable description */
-    description?: string;
-    /** Status of the span convention */
-    status?: 'draft' | 'approved' | 'implemented';
-}
-/**
- * Extract span convention from a canvas node
- */
-export declare function extractSpanConvention(node: ExtendedCanvasNode): NormalizedSpanConvention | null;
-/**
- * Extract all span conventions from a spans.canvas file
- */
-export declare function extractSpanConventions(canvas: ExtendedCanvas): NormalizedSpanConvention[];
-/**
- * Build a span color map from a spans.canvas
- * Returns a map of spanPattern -> color for fast lookups
- */
-export declare function buildSpanColorMap(canvas: ExtendedCanvas | null | undefined): Record<string, string>;
-/**
- * Build a span color map from multiple spans.canvas files
- * Later files override earlier ones for duplicate patterns
- */
-export declare function buildSpanColorMapFromCanvases(canvases: (ExtendedCanvas | null | undefined)[]): Record<string, string>;
-/**
- * Match a span name to a span pattern
- * Supports exact matches and wildcard patterns (e.g., "validate.*")
- */
-export declare function matchSpanPattern(spanName: string, pattern: string): boolean;
-/**
- * Find the color for a span name by matching against span patterns
- * Returns the first matching pattern's color, or default if none match
- */
-export declare function getSpanColor(spanName: string, spanColorMap: Record<string, string>): string;
-/**
- * Resolve span color for an event based on its workflow's spanPattern
- * This is the primary method for determining event fill color
- */
-export declare function resolveEventSpanColor(workflowSpanPattern: string | undefined, spanColorMap: Record<string, string>): string;
-/**
- * Build a span icon map from a spans.canvas
- * Returns a map of spanPattern -> icon for fast lookups
- */
-export declare function buildSpanIconMap(canvas: ExtendedCanvas | null | undefined): Record<string, string>;
-/**
- * Find the icon for a span name by matching against span patterns
- * Returns the first matching pattern's icon, or undefined if none match
- */
-export declare function getSpanIcon(spanName: string, spanIconMap: Record<string, string>): string | undefined;
-//# sourceMappingURL=utils.d.ts.map

package/dist/spans/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/spans/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1E,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;CAC/C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,wBAAwB,GAAG,IAAI,CA2D/F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,wBAAwB,EAAE,CAazF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWnG;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,CAAC,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAW3E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,CAcR;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,mBAAmB,EAAE,MAAM,GAAG,SAAS,EACvC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,CASR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAalG;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,MAAM,GAAG,SAAS,CAcpB"}

package/dist/spans/utils.js

@@ -1,205 +0,0 @@
-"use strict";
-/**
- * Span utility functions
- *
- * Helpers for working with span conventions from .spans.canvas files.
- * Span colors are used as fill colors for events emitted within that span.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSpanIcon = exports.buildSpanIconMap = exports.resolveEventSpanColor = exports.getSpanColor = exports.matchSpanPattern = exports.buildSpanColorMapFromCanvases = exports.buildSpanColorMap = exports.extractSpanConventions = exports.extractSpanConvention = exports.DEFAULT_SPAN_COLOR = void 0;
-const canvas_1 = require("../types/canvas");
-/** Default color for spans without a defined color */
-exports.DEFAULT_SPAN_COLOR = '#9CA3AF'; // gray-400
-/**
- * Extract span convention from a canvas node
- */
-function extractSpanConvention(node) {
-    // Handle OTEL span convention nodes (top-level otel field)
-    if ((0, canvas_1.isOtelSpanConventionNode)(node)) {
-        const spanPattern = node.otel?.spanPattern;
-        if (!spanPattern)
-            return null;
-        const color = node.color;
-        if (!color)
-            return null;
-        return {
-            id: node.id,
-            spanPattern,
-            color,
-            icon: node.icon,
-            description: node.description,
-            status: node.otel?.status,
-        };
-    }
-    // Handle standard nodes with pv.nodeType === 'span-convention'
-    if (!(0, canvas_1.isStandardCanvasNode)(node))
-        return null;
-    const pv = node.pv;
-    if (!pv)
-        return null;
-    const nodeType = pv.nodeType;
-    if (nodeType !== 'span-convention')
-        return null;
-    const otel = pv.otel;
-    const spanPattern = otel?.spanPattern;
-    if (!spanPattern)
-        return null;
-    // Get color from node (required for span conventions)
-    const color = node.color;
-    if (!color)
-        return null;
-    // Extract description from node text if present (only text nodes have text)
-    let description;
-    if ('text' in node && typeof node.text === 'string') {
-        const text = node.text;
-        // Try to extract description from markdown (lines after the header)
-        const lines = text.split('\n');
-        const descLines = lines.filter(line => !line.startsWith('#') && line.trim());
-        if (descLines.length > 0) {
-            description = descLines.join(' ').trim();
-        }
-    }
-    // Get icon from pv.icon (Lucide icon identifier)
-    const icon = pv.icon;
-    return {
-        id: node.id,
-        spanPattern,
-        color,
-        icon,
-        description,
-        status: pv.status,
-    };
-}
-exports.extractSpanConvention = extractSpanConvention;
-/**
- * Extract all span conventions from a spans.canvas file
- */
-function extractSpanConventions(canvas) {
-    const conventions = [];
-    if (!canvas.nodes)
-        return conventions;
-    for (const node of canvas.nodes) {
-        const convention = extractSpanConvention(node);
-        if (convention) {
-            conventions.push(convention);
-        }
-    }
-    return conventions;
-}
-exports.extractSpanConventions = extractSpanConventions;
-/**
- * Build a span color map from a spans.canvas
- * Returns a map of spanPattern -> color for fast lookups
- */
-function buildSpanColorMap(canvas) {
-    const colorMap = {};
-    if (!canvas)
-        return colorMap;
-    const conventions = extractSpanConventions(canvas);
-    for (const convention of conventions) {
-        colorMap[convention.spanPattern] = convention.color;
-    }
-    return colorMap;
-}
-exports.buildSpanColorMap = buildSpanColorMap;
-/**
- * Build a span color map from multiple spans.canvas files
- * Later files override earlier ones for duplicate patterns
- */
-function buildSpanColorMapFromCanvases(canvases) {
-    const colorMap = {};
-    for (const canvas of canvases) {
-        if (!canvas)
-            continue;
-        const conventions = extractSpanConventions(canvas);
-        for (const convention of conventions) {
-            colorMap[convention.spanPattern] = convention.color;
-        }
-    }
-    return colorMap;
-}
-exports.buildSpanColorMapFromCanvases = buildSpanColorMapFromCanvases;
-/**
- * Match a span name to a span pattern
- * Supports exact matches and wildcard patterns (e.g., "validate.*")
- */
-function matchSpanPattern(spanName, pattern) {
-    // Exact match
-    if (spanName === pattern)
-        return true;
-    // Wildcard pattern (e.g., "validate.*")
-    if (pattern.endsWith('.*')) {
-        const prefix = pattern.slice(0, -2);
-        return spanName.startsWith(prefix + '.') || spanName === prefix;
-    }
-    return false;
-}
-exports.matchSpanPattern = matchSpanPattern;
-/**
- * Find the color for a span name by matching against span patterns
- * Returns the first matching pattern's color, or default if none match
- */
-function getSpanColor(spanName, spanColorMap) {
-    // First try exact match
-    if (spanColorMap[spanName]) {
-        return spanColorMap[spanName];
-    }
-    // Then try pattern matching
-    for (const [pattern, color] of Object.entries(spanColorMap)) {
-        if (matchSpanPattern(spanName, pattern)) {
-            return color;
-        }
-    }
-    return exports.DEFAULT_SPAN_COLOR;
-}
-exports.getSpanColor = getSpanColor;
-/**
- * Resolve span color for an event based on its workflow's spanPattern
- * This is the primary method for determining event fill color
- */
-function resolveEventSpanColor(workflowSpanPattern, spanColorMap) {
-    if (!workflowSpanPattern)
-        return exports.DEFAULT_SPAN_COLOR;
-    // Direct lookup (pattern as key)
-    if (spanColorMap[workflowSpanPattern]) {
-        return spanColorMap[workflowSpanPattern];
-    }
-    return exports.DEFAULT_SPAN_COLOR;
-}
-exports.resolveEventSpanColor = resolveEventSpanColor;
-/**
- * Build a span icon map from a spans.canvas
- * Returns a map of spanPattern -> icon for fast lookups
- */
-function buildSpanIconMap(canvas) {
-    const iconMap = {};
-    if (!canvas)
-        return iconMap;
-    const conventions = extractSpanConventions(canvas);
-    for (const convention of conventions) {
-        if (convention.icon) {
-            iconMap[convention.spanPattern] = convention.icon;
-        }
-    }
-    return iconMap;
-}
-exports.buildSpanIconMap = buildSpanIconMap;
-/**
- * Find the icon for a span name by matching against span patterns
- * Returns the first matching pattern's icon, or undefined if none match
- */
-function getSpanIcon(spanName, spanIconMap) {
-    // First try exact match
-    if (spanIconMap[spanName]) {
-        return spanIconMap[spanName];
-    }
-    // Then try pattern matching
-    for (const [pattern, icon] of Object.entries(spanIconMap)) {
-        if (matchSpanPattern(spanName, pattern)) {
-            return icon;
-        }
-    }
-    return undefined;
-}
-exports.getSpanIcon = getSpanIcon;
-//# sourceMappingURL=utils.js.map

package/dist/spans/utils.js.map

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

package/dist/storyboard/builder.d.ts

@@ -1,135 +0,0 @@
-/**
- * Storyboard Context Builder
- *
- * Utilities for building StoryboardContextSliceData from canvas and workflow artifacts.
- * Used by hosts to create the context slice for panels like File City.
- */
-import type { ExtendedCanvas, ExtendedCanvasNode } from '../types/canvas';
-import type { WorkflowTemplate, WorkflowScenario } from '../workflow/types';
-import type { StoryboardReference, StoryboardContextSliceData } from './types';
-import type { CanvasType } from '../discovery/types';
-/**
- * Map of event name to canvas node IDs that emit that event.
- */
-export type EventNodeMap = Map<string, string[]>;
-/**
- * Options for building storyboard context.
- */
-export interface BuildStoryboardContextOptions {
-    /** The parsed canvas content */
-    canvas: ExtendedCanvas;
-    /** Storyboard metadata (id, name, path) */
-    storyboard: StoryboardReference;
-    /** Canvas type (defaults to 'otel') */
-    canvasType?: CanvasType;
-    /** Optional: Selected workflow template and its path */
-    workflow?: {
-        template: WorkflowTemplate;
-        path: string;
-    };
-    /** Optional: Selected scenario within the workflow */
-    scenario?: WorkflowScenario;
-    /** Optional: Additional supporting files to include */
-    additionalSupportingFiles?: string[];
-}
-/**
- * Build a map of event name to canvas node IDs.
- * Uses `pv.event.name` or `pv.eventRef` from each node.
- *
- * @param canvas - The extended canvas with nodes
- * @returns Map of event names to node IDs that emit those events
- *
- * @example
- * ```typescript
- * const eventMap = buildEventNodeMap(canvas);
- * // Map { 'auth.login' => ['node-abc'], 'api.fetch' => ['node-xyz', 'node-def'] }
- * ```
- */
-export declare function buildEventNodeMap(canvas: ExtendedCanvas): EventNodeMap;
-/**
- * Get the event name from a canvas node.
- *
- * Supports two schema locations:
- * 1. Top-level `event.name` / `eventRef` (OtelEventNode in .otel.canvas files)
- * 2. `pv.event.name` / `pv.eventRef` (PVNodeExtension for generic canvas nodes)
- *
- * @param node - The canvas node
- * @returns Event name or undefined if node doesn't emit events
- */
-export declare function getNodeEventName(node: ExtendedCanvasNode): string | undefined;
-/**
- * Resolve workflow scenario event requirements to canvas node IDs.
- *
- * Given a scenario's required events, finds which canvas nodes emit those events.
- *
- * @param canvas - The extended canvas with nodes
- * @param scenario - The workflow scenario with event requirements
- * @returns Array of canvas node IDs involved in this scenario
- *
- * @example
- * ```typescript
- * const nodeIds = resolveScenarioNodeIds(canvas, scenario);
- * // ['node-abc', 'node-xyz'] - nodes that emit events required by the scenario
- * ```
- */
-export declare function resolveScenarioNodeIds(canvas: ExtendedCanvas, scenario: WorkflowScenario): string[];
-/**
- * Resolve workflow template to canvas node IDs.
- *
- * Returns all unique node IDs that are involved in any scenario of the workflow.
- *
- * @param canvas - The extended canvas with nodes
- * @param workflow - The workflow template with scenarios
- * @returns Array of canvas node IDs involved in this workflow
- */
-export declare function resolveWorkflowNodeIds(canvas: ExtendedCanvas, workflow: WorkflowTemplate): string[];
-/**
- * Find node IDs matching an event pattern (supports glob-style wildcards).
- *
- * @param eventMap - Map of event names to node IDs
- * @param pattern - Event pattern (e.g., "auth.login", "*.error", "api.*")
- * @returns Array of matching node IDs
- */
-export declare function findNodesMatchingEventPattern(eventMap: EventNodeMap, pattern: string): string[];
-/**
- * Get all node IDs from a canvas.
- * Useful when no specific workflow/scenario is selected (widest scope).
- *
- * @param canvas - The extended canvas with nodes
- * @returns Array of all node IDs in the canvas
- */
-export declare function getAllNodeIds(canvas: ExtendedCanvas): string[];
-/**
- * Build a complete StoryboardContextSliceData from canvas and optional workflow/scenario.
- *
- * This is the main function for creating the context slice that panels consume.
- *
- * @param options - Build options with canvas, storyboard, and optional workflow/scenario
- * @returns Complete storyboard context slice data
- *
- * @example
- * ```typescript
- * // Just storyboard selected (widest scope)
- * const context = buildStoryboardContext({
- *   canvas: parsedCanvas,
- *   storyboard: { id: 'checkout-flow', name: 'Checkout Flow', path: 'canvas.otel.canvas' },
- * });
- *
- * // With workflow selected (medium scope)
- * const context = buildStoryboardContext({
- *   canvas: parsedCanvas,
- *   storyboard: { id: 'checkout-flow', name: 'Checkout Flow', path: 'canvas.otel.canvas' },
- *   workflow: { template: workflowTemplate, path: 'workflow.workflow.json' },
- * });
- *
- * // With scenario selected (narrowest scope)
- * const context = buildStoryboardContext({
- *   canvas: parsedCanvas,
- *   storyboard: { id: 'checkout-flow', name: 'Checkout Flow', path: 'canvas.otel.canvas' },
- *   workflow: { template: workflowTemplate, path: 'workflow.workflow.json' },
- *   scenario: selectedScenario,
- * });
- * ```
- */
-export declare function buildStoryboardContext(options: BuildStoryboardContextOptions): StoryboardContextSliceData;
-//# sourceMappingURL=builder.d.ts.map

package/dist/storyboard/builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/storyboard/builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EACV,mBAAmB,EAGnB,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOrD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,gCAAgC;IAChC,MAAM,EAAE,cAAc,CAAC;IAEvB,2CAA2C;IAC3C,UAAU,EAAE,mBAAmB,CAAC;IAEhC,uCAAuC;IACvC,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,wDAAwD;IACxD,QAAQ,CAAC,EAAE;QACT,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,sDAAsD;IACtD,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAE5B,uDAAuD;IACvD,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAC;CACtC;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAiBtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAgB7E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,gBAAgB,GACzB,MAAM,EAAE,CAgBV;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,gBAAgB,GACzB,MAAM,EAAE,CAWV;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,MAAM,GACd,MAAM,EAAE,CAiBV;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAK9D;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,6BAA6B,GACrC,0BAA0B,CA+C5B"}