polen 0.10.0-next.11 → 0.10.0-next.13

package/build/lib/graphql-document/example.js

@@ -0,0 +1,140 @@
+/**
+ * Example usage of the GraphQL Document Analysis library
+ *
+ * This demonstrates how to use the foundational layer for extracting
+ * identifiers and context from GraphQL documents - the building block
+ * for the interactive GraphQL Document Component.
+ */
+import { GraphQLDocument } from "./$.js";
+// Example GraphQL query with various constructs
+const exampleQuery = `
+  query GetPokemonWithAbilities($id: ID!, $limit: Int = 10) {
+    pokemon(id: $id) {
+      name
+      abilities(first: $limit) {
+        name
+        isHidden
+        pokemon {
+          name
+        }
+      }
+      ... on ElectricPokemon {
+        voltage
+      }
+    }
+  }
+
+  fragment PokemonBasics on Pokemon {
+    name
+    type
+    level
+  }
+`;
+/**
+ * Demonstrate basic analysis
+ */
+export const analyzeExample = () => {
+    console.log('🔍 Analyzing GraphQL Document...\n');
+    const result = GraphQLDocument.analyze(exampleQuery);
+    console.log(`✅ Valid: ${result.isValid}`);
+    console.log(`📊 Total identifiers: ${result.identifiers.all.length}`);
+    console.log(`🚨 Errors: ${result.errors.length}\n`);
+    // Show identifiers by kind
+    for (const [kind, identifiers] of result.identifiers.byKind) {
+        console.log(`${getKindEmoji(kind)} ${kind} (${identifiers.length}):`);
+        for (const identifier of identifiers) {
+            const pos = `${identifier.position.line}:${identifier.position.column}`;
+            const path = identifier.schemaPath.join(' → ');
+            const parent = identifier.parentType ? ` (in ${identifier.parentType})` : '';
+            console.log(`  • ${identifier.name}${parent} → ${path} @ ${pos}`);
+        }
+        console.log();
+    }
+    return result;
+};
+/**
+ * Demonstrate identifier lookup by position
+ */
+export const demonstratePositionLookup = () => {
+    console.log('📍 Position-based Identifier Lookup...\n');
+    const identifiers = GraphQLDocument.extractIdentifiers(exampleQuery);
+    // Find identifier at a specific position (e.g., cursor position in an editor)
+    const targetPosition = 180; // Approximate position of "abilities" field
+    // Find the closest identifier to this position
+    let closestIdentifier = null;
+    let closestDistance = Infinity;
+    for (const identifier of identifiers.all) {
+        const distance = Math.abs(identifier.position.start - targetPosition);
+        if (distance < closestDistance) {
+            closestDistance = distance;
+            closestIdentifier = identifier;
+        }
+    }
+    if (closestIdentifier) {
+        console.log(`🎯 Identifier near position ${targetPosition}:`);
+        console.log(`   Name: ${closestIdentifier.name}`);
+        console.log(`   Kind: ${closestIdentifier.kind}`);
+        console.log(`   Schema Path: ${closestIdentifier.schemaPath.join(' → ')}`);
+        console.log(`   Context: ${JSON.stringify(closestIdentifier.context, null, 2)}`);
+    }
+};
+/**
+ * Demonstrate how this enables hyperlink generation
+ */
+export const demonstrateHyperlinkGeneration = () => {
+    console.log('🔗 Hyperlink Generation Preview...\n');
+    const identifiers = GraphQLDocument.extractIdentifiers(exampleQuery);
+    // Show how each identifier could become a hyperlink
+    const typeIdentifiers = identifiers.byKind.get('Type') || [];
+    const fieldIdentifiers = identifiers.byKind.get('Field') || [];
+    console.log('📝 Type References → Schema Links:');
+    for (const identifier of typeIdentifiers) {
+        const referenceUrl = `/reference/${identifier.name}`;
+        console.log(`  ${identifier.name} → ${referenceUrl}`);
+    }
+    console.log('\n📝 Field References → Schema Links:');
+    for (const identifier of fieldIdentifiers.slice(0, 5)) { // Show first 5
+        const referenceUrl = identifier.parentType
+            ? `/reference/${identifier.parentType}#${identifier.name}`
+            : `/reference/${identifier.name}`;
+        console.log(`  ${identifier.name} → ${referenceUrl}`);
+    }
+};
+/**
+ * Show the foundation for hover tooltips
+ */
+export const demonstrateTooltipFoundation = () => {
+    console.log('💬 Tooltip Foundation...\n');
+    const identifiers = GraphQLDocument.extractIdentifiers(exampleQuery);
+    // Show context information that would be displayed in tooltips
+    const fieldIdentifiers = identifiers.byKind.get('Field') || [];
+    for (const identifier of fieldIdentifiers.slice(0, 3)) { // Show first 3
+        console.log(`🏷️  ${identifier.name}:`);
+        console.log(`    Position: Line ${identifier.position.line}, Column ${identifier.position.column}`);
+        console.log(`    Schema Path: ${identifier.schemaPath.join(' → ')}`);
+        console.log(`    Parent Type: ${identifier.parentType || 'Root'}`);
+        console.log(`    Operation: ${identifier.context.operationType || 'None'}`);
+        console.log(`    Selection Path: ${identifier.context.selectionPath.join(' → ')}`);
+        console.log();
+    }
+};
+// Helper function
+function getKindEmoji(kind) {
+    const emojis = {
+        'Type': '🏷️',
+        'Field': '📋',
+        'Argument': '⚙️',
+        'Variable': '💰',
+        'Directive': '🎯',
+        'Fragment': '🧩',
+    };
+    return emojis[kind] || '❓';
+}
+// Run example if executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    analyzeExample();
+    demonstratePositionLookup();
+    demonstrateHyperlinkGeneration();
+    demonstrateTooltipFoundation();
+}
+//# sourceMappingURL=example.js.map

package/build/lib/graphql-document/example.js.map

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

package/build/lib/graphql-document/graphql-document.d.ts

@@ -0,0 +1,35 @@
+/**
+ * GraphQL Document Component Library
+ *
+ * Transform static GraphQL code blocks into interactive documentation with
+ * hyperlinks, tooltips, and schema validation.
+ *
+ * ## Features
+ * - Hyperlinked identifiers that navigate to reference documentation
+ * - Hover tooltips showing type information and descriptions
+ * - Schema validation with error highlighting
+ * - Build-time GraphQL validation
+ * - Support for all GraphQL operations (queries, mutations, subscriptions, fragments)
+ *
+ * ## Usage
+ * ```typescript
+ * import { GraphQLDocument } from 'polen/lib/graphql-document'
+ *
+ * <GraphQLDocument schema={schema}>
+ *   {`query { user { name } }`}
+ * </GraphQLDocument>
+ * ```
+ *
+ * @see {@link GraphQLDocumentWithSchema} for MDX integration
+ * @see {@link GraphQLDocument} for the main React component
+ */
+export * from './analysis.ts';
+export * from './components/index.ts';
+export * from './positioning-simple.ts';
+export * from './schema-integration.ts';
+export * from './types.ts';
+export { analyze, analyzer, extractIdentifiers } from './analysis.ts';
+export { GraphQLDocument } from './components/GraphQLDocument.tsx';
+export { createSimpleOverlay, createSimplePositionCalculator } from './positioning-simple.ts';
+export { analyzeWithSchema, createPolenSchemaResolver } from './schema-integration.ts';
+//# sourceMappingURL=graphql-document.d.ts.map

package/build/lib/graphql-document/graphql-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-document.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-document/graphql-document.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,YAAY,CAAA;AAG1B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAA;AAC7F,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA"}

package/build/lib/graphql-document/graphql-document.js

@@ -0,0 +1,36 @@
+/**
+ * GraphQL Document Component Library
+ *
+ * Transform static GraphQL code blocks into interactive documentation with
+ * hyperlinks, tooltips, and schema validation.
+ *
+ * ## Features
+ * - Hyperlinked identifiers that navigate to reference documentation
+ * - Hover tooltips showing type information and descriptions
+ * - Schema validation with error highlighting
+ * - Build-time GraphQL validation
+ * - Support for all GraphQL operations (queries, mutations, subscriptions, fragments)
+ *
+ * ## Usage
+ * ```typescript
+ * import { GraphQLDocument } from 'polen/lib/graphql-document'
+ *
+ * <GraphQLDocument schema={schema}>
+ *   {`query { user { name } }`}
+ * </GraphQLDocument>
+ * ```
+ *
+ * @see {@link GraphQLDocumentWithSchema} for MDX integration
+ * @see {@link GraphQLDocument} for the main React component
+ */
+export * from "./analysis.js";
+export * from "./components/index.js";
+export * from "./positioning-simple.js";
+export * from "./schema-integration.js";
+export * from "./types.js";
+// Re-export key functions for convenience
+export { analyze, analyzer, extractIdentifiers } from "./analysis.js";
+export { GraphQLDocument } from "./components/GraphQLDocument.js";
+export { createSimpleOverlay, createSimplePositionCalculator } from "./positioning-simple.js";
+export { analyzeWithSchema, createPolenSchemaResolver } from "./schema-integration.js";
+//# sourceMappingURL=graphql-document.js.map

package/build/lib/graphql-document/graphql-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-document.js","sourceRoot":"","sources":["../../../src/lib/graphql-document/graphql-document.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,YAAY,CAAA;AAE1B,0CAA0C;AAC1C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAkC,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAA;AAC7F,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA"}

package/build/lib/graphql-document/hooks/use-tooltip-state.d.ts

@@ -0,0 +1,43 @@
+/**
+ * State management for GraphQL document tooltips
+ *
+ * Handles hover delays, pinning, and multiple tooltip coordination
+ */
+export interface TooltipState {
+    /** Currently visible tooltip (via hover) */
+    hoveredId: string | null;
+    /** Set of pinned tooltip IDs */
+    pinnedIds: Set<string>;
+    /** ID pending show (waiting for delay) */
+    pendingShowId: string | null;
+    /** ID pending hide (waiting for grace period) */
+    pendingHideId: string | null;
+}
+export interface UseTooltipStateOptions {
+    /** Delay before showing tooltip on hover (ms) */
+    showDelay?: number;
+    /** Delay before hiding tooltip on mouse leave (ms) */
+    hideDelay?: number;
+    /** Whether to allow multiple pinned tooltips */
+    allowMultiplePins?: boolean;
+}
+export interface UseTooltipStateReturn {
+    /** Check if a tooltip should be visible */
+    isOpen: (id: string) => boolean;
+    /** Check if a tooltip is pinned */
+    isPinned: (id: string) => boolean;
+    /** Handle hover start */
+    onHoverStart: (id: string) => void;
+    /** Handle hover end */
+    onHoverEnd: (id: string) => void;
+    /** Handle click (toggle pin) */
+    onTogglePin: (id: string) => void;
+    /** Handle tooltip content hover (cancels hide) */
+    onTooltipHover: (id: string) => void;
+    /** Unpin a specific tooltip */
+    unpin: (id: string) => void;
+    /** Unpin all tooltips */
+    unpinAll: () => void;
+}
+export declare const useTooltipState: (options?: UseTooltipStateOptions) => UseTooltipStateReturn;
+//# sourceMappingURL=use-tooltip-state.d.ts.map

package/build/lib/graphql-document/hooks/use-tooltip-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tooltip-state.d.ts","sourceRoot":"","sources":["../../../../src/lib/graphql-document/hooks/use-tooltip-state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,gCAAgC;IAChC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACtB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,iDAAiD;IACjD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAA;IAC/B,mCAAmC;IACnC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAA;IACjC,yBAAyB;IACzB,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,uBAAuB;IACvB,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,gCAAgC;IAChC,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,kDAAkD;IAClD,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,+BAA+B;IAC/B,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,eAAO,MAAM,eAAe,GAAI,UAAS,sBAA2B,KAAG,qBA+ItE,CAAA"}

package/build/lib/graphql-document/hooks/use-tooltip-state.js

@@ -0,0 +1,132 @@
+/**
+ * State management for GraphQL document tooltips
+ *
+ * Handles hover delays, pinning, and multiple tooltip coordination
+ */
+import { React } from '#dep/react/index';
+export const useTooltipState = (options = {}) => {
+    const { showDelay = 300, hideDelay = 200, allowMultiplePins = true, } = options;
+    const [hoveredId, setHoveredId] = React.useState(null);
+    const [pinnedIds, setPinnedIds] = React.useState(new Set());
+    const [pendingShowId, setPendingShowId] = React.useState(null);
+    const [pendingHideId, setPendingHideId] = React.useState(null);
+    // Timer refs
+    const showTimerRef = React.useRef(null);
+    const hideTimerRef = React.useRef(null);
+    // Clear any pending timers
+    const clearTimers = React.useCallback(() => {
+        if (showTimerRef.current) {
+            clearTimeout(showTimerRef.current);
+            showTimerRef.current = null;
+        }
+        if (hideTimerRef.current) {
+            clearTimeout(hideTimerRef.current);
+            hideTimerRef.current = null;
+        }
+        setPendingShowId(null);
+        setPendingHideId(null);
+    }, []);
+    // Check if tooltip should be visible
+    const isOpen = React.useCallback((id) => {
+        return hoveredId === id || pinnedIds.has(id);
+    }, [hoveredId, pinnedIds]);
+    // Check if tooltip is pinned
+    const isPinned = React.useCallback((id) => {
+        return pinnedIds.has(id);
+    }, [pinnedIds]);
+    // Handle hover start
+    const onHoverStart = React.useCallback((id) => {
+        // Don't show if already pinned
+        if (pinnedIds.has(id))
+            return;
+        // Cancel any pending hide for this ID
+        if (pendingHideId === id) {
+            clearTimeout(hideTimerRef.current);
+            hideTimerRef.current = null;
+            setPendingHideId(null);
+            return;
+        }
+        // Clear any other pending operations
+        clearTimers();
+        // Schedule show
+        setPendingShowId(id);
+        showTimerRef.current = setTimeout(() => {
+            setHoveredId(id);
+            setPendingShowId(null);
+        }, showDelay);
+    }, [pinnedIds, pendingHideId, clearTimers, showDelay]);
+    // Handle hover end
+    const onHoverEnd = React.useCallback((id) => {
+        // Don't hide if pinned
+        if (pinnedIds.has(id))
+            return;
+        // Cancel pending show if still waiting
+        if (pendingShowId === id) {
+            clearTimeout(showTimerRef.current);
+            showTimerRef.current = null;
+            setPendingShowId(null);
+            return;
+        }
+        // Only hide if currently showing this tooltip
+        if (hoveredId === id) {
+            setPendingHideId(id);
+            hideTimerRef.current = setTimeout(() => {
+                // First set hovered to null to trigger close animation
+                setHoveredId(null);
+                setPendingHideId(null);
+            }, hideDelay);
+        }
+    }, [pinnedIds, pendingShowId, hoveredId, hideDelay]);
+    // Handle tooltip content hover (cancels hide)
+    const onTooltipHover = React.useCallback((id) => {
+        if (pendingHideId === id) {
+            clearTimeout(hideTimerRef.current);
+            hideTimerRef.current = null;
+            setPendingHideId(null);
+        }
+    }, [pendingHideId]);
+    // Toggle pin state
+    const onTogglePin = React.useCallback((id) => {
+        clearTimers();
+        setPinnedIds((prev) => {
+            const next = new Set(prev);
+            if (next.has(id)) {
+                // Unpin
+                next.delete(id);
+                setHoveredId(null); // Also clear hover state
+            }
+            else {
+                // Pin
+                if (!allowMultiplePins) {
+                    next.clear(); // Clear other pins
+                }
+                next.add(id);
+                setHoveredId(null); // Clear hover state since it's now pinned
+            }
+            return next;
+        });
+    }, [clearTimers, allowMultiplePins]);
+    // Unpin specific tooltip
+    const unpin = React.useCallback((id) => {
+        setPinnedIds((prev) => {
+            const next = new Set(prev);
+            next.delete(id);
+            return next;
+        });
+    }, []);
+    // Unpin all tooltips
+    const unpinAll = React.useCallback(() => {
+        setPinnedIds(new Set());
+    }, []);
+    return {
+        isOpen,
+        isPinned,
+        onHoverStart,
+        onHoverEnd,
+        onTogglePin,
+        onTooltipHover,
+        unpin,
+        unpinAll,
+    };
+};
+//# sourceMappingURL=use-tooltip-state.js.map

package/build/lib/graphql-document/hooks/use-tooltip-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tooltip-state.js","sourceRoot":"","sources":["../../../../src/lib/graphql-document/hooks/use-tooltip-state.ts"],"names":[],"mappings":"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"}

package/build/lib/graphql-document/positioning-simple.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Layer 3: Simplified Positioning & Layout Engine
+ *
+ * Maps GraphQL AST positions to DOM coordinates for overlay placement.
+ * This simplified version focuses on working with Polen's existing infrastructure.
+ */
+import type { Identifier } from './types.ts';
+/**
+ * DOM position for rendering overlays
+ */
+export interface DOMPosition {
+    /** Distance from top of container in pixels */
+    top: number;
+    /** Distance from left of container in pixels */
+    left: number;
+    /** Width of the identifier in pixels */
+    width: number;
+    /** Height of the identifier in pixels */
+    height: number;
+}
+/**
+ * Position calculation result
+ */
+export interface PositionResult {
+    /** The calculated DOM position */
+    position: DOMPosition;
+    /** The identifier this position is for */
+    identifier: Identifier;
+}
+/**
+ * Simplified position calculator for Shiki-rendered code
+ *
+ * This version uses a more straightforward approach:
+ * 1. Find the line element by line number
+ * 2. Search for the identifier text within that line
+ * 3. Create a span around the identifier for positioning
+ *
+ * This approach modifies the DOM but is more reliable for testing
+ * and works well with React's reconciliation.
+ */
+export declare class SimplePositionCalculator {
+    /**
+     * Prepare a code block for positioning by wrapping identifiers in spans
+     */
+    prepareCodeBlock(containerElement: Element, identifiers: Identifier[]): void;
+    /**
+     * Get positions of all wrapped identifiers
+     */
+    getIdentifierPositions(containerElement: Element, relativeToElement?: Element): Map<string, PositionResult>;
+    /**
+     * Wrap an identifier in a span for positioning
+     * Returns true if the identifier was successfully wrapped
+     */
+    private wrapIdentifier;
+}
+/**
+ * Create invisible overlay for a position
+ */
+export declare const createSimpleOverlay: (position: DOMPosition, identifier: Identifier, options?: {
+    onClick?: (identifier: Identifier) => void;
+    onHover?: (identifier: Identifier, event: MouseEvent) => void;
+    className?: string;
+}) => HTMLElement;
+/**
+ * Factory function for position calculator
+ */
+export declare const createSimplePositionCalculator: () => SimplePositionCalculator;
+//# sourceMappingURL=positioning-simple.d.ts.map

package/build/lib/graphql-document/positioning-simple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioning-simple.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-document/positioning-simple.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAA;IACX,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,QAAQ,EAAE,WAAW,CAAA;IACrB,0CAA0C;IAC1C,UAAU,EAAE,UAAU,CAAA;CACvB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,wBAAwB;IACnC;;OAEG;IACH,gBAAgB,CACd,gBAAgB,EAAE,OAAO,EACzB,WAAW,EAAE,UAAU,EAAE,GACxB,IAAI;IAmBP;;OAEG;IACH,sBAAsB,CACpB,gBAAgB,EAAE,OAAO,EACzB,iBAAiB,CAAC,EAAE,OAAO,GAC1B,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IA4C9B;;;OAGG;IACH,OAAO,CAAC,cAAc;CAyFvB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,WAAW,EACrB,YAAY,UAAU,EACtB,UAAU;IACR,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAA;IAC1C,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,KACA,WAqCF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,QAAO,wBAEjD,CAAA"}