polen 0.10.0-next.10 → 0.10.0-next.12

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

@@ -0,0 +1,45 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { useGraphQLSchema } from "../schema-context.js";
+import { GraphQLDocument } from "./GraphQLDocument.js";
+// Cache for highlighter
+let highlighterCache = null;
+/**
+ * GraphQL Document component that uses the schema context and handles syntax highlighting
+ */
+export const GraphQLDocumentWithSchema = (props) => {
+    const schema = useGraphQLSchema();
+    const [mounted, setMounted] = useState(false);
+    const [highlightedHtml, setHighlightedHtml] = useState(null);
+    useEffect(() => {
+        setMounted(true);
+        const loadHighlighter = async () => {
+            try {
+                // Load highlighter if not cached
+                if (!highlighterCache) {
+                    const { highlightCode } = await import('#lib/shiki/index');
+                    highlighterCache = highlightCode;
+                }
+                // Generate highlighted HTML
+                const highlighted = await highlighterCache({
+                    code: props['children'],
+                    lang: 'graphql',
+                    theme: 'light',
+                });
+                setHighlightedHtml(highlighted);
+            }
+            catch (error) {
+                console.error('Failed to load GraphQL document highlighter:', error);
+            }
+        };
+        loadHighlighter();
+    }, [props['children']]);
+    // Always render the same structure to avoid hydration issues
+    const isInteractive = mounted && schema && highlightedHtml;
+    if (!isInteractive) {
+        // Static fallback that looks like Shiki output
+        return (_jsx("div", { className: 'graphql-document graphql-document-static', "data-testid": 'graphql-document', children: _jsx("pre", { className: 'shiki shiki-themes github-light tokyo-night', style: { backgroundColor: 'var(--shiki-light-bg)', color: 'var(--shiki-light)' }, children: _jsx("code", { className: "language-graphql", children: props['children'] }) }) }));
+    }
+    return (_jsx(GraphQLDocument, { ...props, schema: schema, highlightedHtml: highlightedHtml }));
+};
+//# sourceMappingURL=GraphQLDocumentWithSchema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GraphQLDocumentWithSchema.js","sourceRoot":"","sources":["../../../../src/lib/graphql-document/components/GraphQLDocumentWithSchema.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAuB,CAAA;AACxD,OAAO,EAAE,eAAe,EAA6B,MAAM,sBAAuB,CAAA;AAElF,wBAAwB;AACxB,IAAI,gBAAgB,GAAQ,IAAI,CAAA;AAEhC;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAuE,CAC3G,KAAK,EACL,EAAE;IACF,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAA;IACjC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7C,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAA;IAE3E,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,IAAI,CAAC,CAAA;QAEhB,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE;YACjC,IAAI,CAAC;gBACH,iCAAiC;gBACjC,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACtB,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;oBAC1D,gBAAgB,GAAG,aAAa,CAAA;gBAClC,CAAC;gBAED,4BAA4B;gBAC5B,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC;oBACzC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC;oBACvB,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE,OAAO;iBACf,CAAC,CAAA;gBAEF,kBAAkB,CAAC,WAAW,CAAC,CAAA;YACjC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,8CAA8C,EAAE,KAAK,CAAC,CAAA;YACtE,CAAC;QACH,CAAC,CAAA;QAED,eAAe,EAAE,CAAA;IACnB,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IAEvB,6DAA6D;IAC7D,MAAM,aAAa,GAAG,OAAO,IAAI,MAAM,IAAI,eAAe,CAAA;IAE1D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,+CAA+C;QAC/C,OAAO,CACL,cAAK,SAAS,EAAC,0CAA0C,iBAAa,kBAAkB,YACtF,cACE,SAAS,EAAC,6CAA6C,EACvD,KAAK,EAAE,EAAE,eAAe,EAAE,uBAAuB,EAAE,KAAK,EAAE,oBAAoB,EAAE,YAEhF,eAAM,SAAS,EAAC,kBAAkB,YAAE,KAAK,CAAC,UAAU,CAAC,GAAQ,GACzD,GACF,CACP,CAAA;IACH,CAAC;IAED,OAAO,CACL,KAAC,eAAe,OACV,KAAK,EACT,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,GAChC,CACH,CAAA;AACH,CAAC,CAAA"}

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

@@ -0,0 +1,35 @@
+import type { React } from '#dep/react/index';
+import type { DOMPosition } from '../positioning-simple.ts';
+import type { Documentation } from '../schema-integration.ts';
+import type { Identifier } from '../types.ts';
+/**
+ * Props for the HoverTooltip component
+ */
+export interface HoverTooltipProps {
+    /** The identifier being hovered */
+    identifier: Identifier;
+    /** Documentation from schema */
+    documentation: Documentation;
+    /** Position of the identifier */
+    position: DOMPosition;
+    /** Whether this identifier has an error */
+    hasError?: boolean;
+    /** Reference URL for "View docs" link */
+    referenceUrl: string;
+    /** Callback to close the tooltip */
+    onClose?: () => void;
+    /** Callback to navigate to docs */
+    onNavigate?: () => void;
+}
+/**
+ * Tooltip shown on hover over GraphQL identifiers
+ *
+ * Displays type information, descriptions, deprecation warnings,
+ * and links to full documentation.
+ */
+export declare const HoverTooltip: React.FC<HoverTooltipProps>;
+/**
+ * Default styles for hover tooltips
+ */
+export declare const hoverTooltipStyles = "\n.graphql-hover-tooltip {\n  /* Tooltip animation */\n  animation: graphql-tooltip-fade-in 0.2s ease-out;\n}\n\n@keyframes graphql-tooltip-fade-in {\n  from {\n    opacity: 0;\n    transform: translateY(4px);\n  }\n  to {\n    opacity: 1;\n    transform: translateY(0);\n  }\n}\n\n/* Ensure tooltips appear above other content */\n.graphql-hover-tooltip .rt-Card {\n  box-shadow: 0 10px 38px -10px rgba(22, 23, 24, 0.35), \n              0 10px 20px -15px rgba(22, 23, 24, 0.2);\n}\n";
+//# sourceMappingURL=HoverTooltip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HoverTooltip.d.ts","sourceRoot":"","sources":["../../../../src/lib/graphql-document/components/HoverTooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAG7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,UAAU,EAAE,UAAU,CAAA;IACtB,gCAAgC;IAChC,aAAa,EAAE,aAAa,CAAA;IAC5B,iCAAiC;IACjC,QAAQ,EAAE,WAAW,CAAA;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAA;IACpB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA6NpD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,yeAsB9B,CAAA"}

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

@@ -0,0 +1,132 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Badge, Box, Card, Flex, Text } from '@radix-ui/themes';
+import { useEffect, useRef, useState } from 'react';
+/**
+ * Tooltip shown on hover over GraphQL identifiers
+ *
+ * Displays type information, descriptions, deprecation warnings,
+ * and links to full documentation.
+ */
+export const HoverTooltip = ({ identifier, documentation, position, hasError = false, referenceUrl, onClose, onNavigate, }) => {
+    const tooltipRef = useRef(null);
+    const [tooltipPosition, setTooltipPosition] = useState({ top: 0, left: 0 });
+    // Calculate tooltip position to avoid viewport edges
+    useEffect(() => {
+        if (!tooltipRef.current)
+            return;
+        const tooltip = tooltipRef.current;
+        const rect = tooltip.getBoundingClientRect();
+        const viewportWidth = window.innerWidth;
+        const viewportHeight = window.innerHeight;
+        // Default position: above the identifier
+        let top = position.top - rect.height - 8;
+        let left = position.left;
+        // Adjust if tooltip would go off screen
+        if (top < 0) {
+            // Show below if not enough space above
+            top = position.top + position.height + 8;
+        }
+        if (left + rect.width > viewportWidth) {
+            // Align right edge with identifier if too wide
+            left = position.left + position.width - rect.width;
+        }
+        if (left < 0) {
+            // Keep on screen
+            left = 8;
+        }
+        setTooltipPosition({ top, left });
+    }, [position]);
+    // Determine badge color based on identifier kind
+    const getBadgeColor = () => {
+        switch (identifier.kind) {
+            case 'Type':
+                return 'blue';
+            case 'Field':
+                return 'green';
+            case 'Argument':
+                return 'orange';
+            case 'Variable':
+                return 'purple';
+            case 'Directive':
+                return 'amber';
+            case 'Fragment':
+                return 'cyan';
+            default:
+                return 'gray';
+        }
+    };
+    return (_jsx("div", { ref: tooltipRef, className: 'graphql-hover-tooltip', style: {
+            position: 'absolute',
+            top: tooltipPosition.top,
+            left: tooltipPosition.left,
+            zIndex: 100,
+            maxWidth: '400px',
+            pointerEvents: 'auto', // Make tooltip interactive
+        }, children: _jsx(Card, { size: '2', variant: 'surface', children: _jsxs(Flex, { direction: 'column', gap: '2', children: [_jsxs(Flex, { justify: 'between', align: 'center', children: [_jsxs(Flex, { align: 'center', gap: '2', children: [_jsx(Text, { size: '2', weight: 'bold', children: identifier.name }), _jsx(Badge, { color: getBadgeColor(), size: '1', children: identifier.kind })] }), onClose && (_jsx("button", { onClick: onClose, style: {
+                                    background: 'none',
+                                    border: 'none',
+                                    cursor: 'pointer',
+                                    padding: '4px',
+                                    color: 'var(--gray-11)',
+                                    fontSize: '18px',
+                                    lineHeight: '1',
+                                    fontWeight: 'bold',
+                                    borderRadius: '4px',
+                                    transition: 'background-color 0.2s',
+                                }, onMouseEnter: (e) => {
+                                    e.currentTarget.style.backgroundColor = 'var(--gray-a3)';
+                                }, onMouseLeave: (e) => {
+                                    e.currentTarget.style.backgroundColor = 'transparent';
+                                }, "aria-label": 'Close tooltip', children: "\u00D7" }))] }), _jsx(Box, { children: _jsxs(Text, { size: '1', color: 'gray', children: ["Type: ", _jsx(Text, { as: 'span', size: '1', style: { fontFamily: 'monospace' }, children: documentation.typeInfo })] }) }), documentation.description && (_jsx(Box, { children: _jsx(Text, { size: '1', children: documentation.description }) })), documentation.defaultValue && (_jsx(Box, { children: _jsxs(Text, { size: '1', color: 'gray', children: ["Default:", ' ', _jsx(Text, { as: 'span', size: '1', style: { fontFamily: 'monospace' }, children: documentation.defaultValue })] }) })), documentation.deprecated && (_jsxs(Box, { style: {
+                            padding: '8px',
+                            backgroundColor: 'var(--amber-2)',
+                            borderRadius: '4px',
+                            border: '1px solid var(--amber-6)',
+                        }, children: [_jsxs(Text, { size: '1', color: 'amber', children: ["\u26A0\uFE0F Deprecated: ", documentation.deprecated.reason] }), documentation.deprecated.replacement && (_jsxs(Text, { size: '1', color: 'amber', children: ["Use ", documentation.deprecated.replacement, " instead."] }))] })), hasError && (_jsx(Box, { style: {
+                            padding: '8px',
+                            backgroundColor: 'var(--red-2)',
+                            borderRadius: '4px',
+                            border: '1px solid var(--red-6)',
+                        }, children: _jsxs(Text, { size: '1', color: 'red', children: ["\u274C ", identifier.kind, " not found in schema"] }) })), _jsx(Box, { children: _jsxs(Text, { size: '1', color: 'gray', children: ["Path: ", identifier.schemaPath.join(' → ')] }) }), onNavigate && (_jsx(Box, { children: _jsx(Text, { size: '1', children: _jsx("a", { href: referenceUrl, onClick: (e) => {
+                                    e.preventDefault();
+                                    onNavigate();
+                                    onClose?.();
+                                }, style: {
+                                    color: 'var(--accent-9)',
+                                    textDecoration: 'none',
+                                    borderBottom: '1px solid transparent',
+                                    transition: 'border-color 0.2s',
+                                    cursor: 'pointer',
+                                }, onMouseEnter: (e) => {
+                                    e.currentTarget.style.borderBottomColor = 'var(--accent-9)';
+                                }, onMouseLeave: (e) => {
+                                    e.currentTarget.style.borderBottomColor = 'transparent';
+                                }, children: "View full documentation \u2192" }) }) }))] }) }) }));
+};
+/**
+ * Default styles for hover tooltips
+ */
+export const hoverTooltipStyles = `
+.graphql-hover-tooltip {
+  /* Tooltip animation */
+  animation: graphql-tooltip-fade-in 0.2s ease-out;
+}
+
+@keyframes graphql-tooltip-fade-in {
+  from {
+    opacity: 0;
+    transform: translateY(4px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+/* Ensure tooltips appear above other content */
+.graphql-hover-tooltip .rt-Card {
+  box-shadow: 0 10px 38px -10px rgba(22, 23, 24, 0.35), 
+              0 10px 20px -15px rgba(22, 23, 24, 0.2);
+}
+`;
+//# sourceMappingURL=HoverTooltip.js.map

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

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

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

@@ -0,0 +1,37 @@
+import type { React } from '#dep/react/index';
+import type { DOMPosition } from '../positioning-simple.ts';
+import type { SchemaResolution } from '../schema-integration.ts';
+import type { Identifier } from '../types.ts';
+/**
+ * Props for the IdentifierLink component
+ */
+export interface IdentifierLinkProps {
+    /** The GraphQL identifier */
+    identifier: Identifier;
+    /** Schema resolution information */
+    resolution: SchemaResolution;
+    /** DOM position for overlay placement */
+    position: DOMPosition;
+    /** Navigation handler */
+    onNavigate: (url: string) => void;
+    /** Whether to show debug visuals */
+    debug?: boolean;
+    /** Whether this tooltip is open */
+    isOpen?: boolean;
+    /** Toggle tooltip open state */
+    onToggle?: (open: boolean) => void;
+}
+/**
+ * Interactive overlay for a GraphQL identifier
+ *
+ * Renders an invisible clickable area over the identifier text
+ * with hover tooltips and navigation to schema reference pages.
+ */
+export declare const IdentifierLink: React.FC<IdentifierLinkProps>;
+/**
+ * Default styles for identifier overlays
+ *
+ * These can be included in the document or overridden by custom styles.
+ */
+export declare const identifierLinkStyles = "\n.graphql-identifier-overlay {\n  /* Base styles for all overlays */\n  transition: background-color 0.2s ease;\n}\n\n.graphql-identifier-overlay.graphql-clickable:hover {\n  /* Subtle highlight on hover for clickable identifiers */\n  background-color: rgba(59, 130, 246, 0.05);\n}\n\n.graphql-identifier-overlay.graphql-error {\n  /* Error indicator */\n  border-bottom: 2px wavy red;\n}\n\n.graphql-identifier-overlay.graphql-deprecated {\n  /* Deprecated indicator */\n  text-decoration: line-through;\n  opacity: 0.7;\n}\n\n.graphql-identifier-overlay.graphql-debug {\n  /* Debug mode makes overlays visible */\n  background-color: rgba(59, 130, 246, 0.1) !important;\n  border: 1px solid rgba(59, 130, 246, 0.3) !important;\n}\n\n/* Kind-specific styles */\n.graphql-identifier-overlay.graphql-type {\n  /* Type identifiers */\n}\n\n.graphql-identifier-overlay.graphql-field {\n  /* Field identifiers */\n}\n\n.graphql-identifier-overlay.graphql-argument {\n  /* Argument identifiers */\n  font-style: italic;\n}\n\n.graphql-identifier-overlay.graphql-variable {\n  /* Variable identifiers */\n  color: var(--purple-11);\n}\n\n.graphql-identifier-overlay.graphql-directive {\n  /* Directive identifiers */\n  color: var(--amber-11);\n}\n";
+//# sourceMappingURL=IdentifierLink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IdentifierLink.d.ts","sourceRoot":"","sources":["../../../../src/lib/graphql-document/components/IdentifierLink.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,UAAU,EAAE,UAAU,CAAA;IACtB,oCAAoC;IACpC,UAAU,EAAE,gBAAgB,CAAA;IAC5B,yCAAyC;IACzC,QAAQ,EAAE,WAAW,CAAA;IACrB,yBAAyB;IACzB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAiIxD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,iuCAmDhC,CAAA"}

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

@@ -0,0 +1,141 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { HoverTooltip } from "./HoverTooltip.js";
+/**
+ * Interactive overlay for a GraphQL identifier
+ *
+ * Renders an invisible clickable area over the identifier text
+ * with hover tooltips and navigation to schema reference pages.
+ */
+export const IdentifierLink = ({ identifier, resolution, position, onNavigate, debug = false, isOpen = false, onToggle, }) => {
+    const [isHovered, setIsHovered] = useState(false);
+    // Use external state if provided, otherwise manage locally
+    const showTooltip = isOpen;
+    const setShowTooltip = (show) => {
+        onToggle?.(show);
+    };
+    // Determine visual state
+    const isClickable = resolution.exists;
+    const hasError = !resolution.exists && (identifier.kind === 'Type' || identifier.kind === 'Field');
+    const isDeprecated = !!resolution.deprecated;
+    // Build class names
+    const classNames = [
+        'graphql-identifier-overlay',
+        `graphql-${identifier.kind.toLowerCase()}`,
+        isClickable && 'graphql-clickable',
+        hasError && 'graphql-error',
+        isDeprecated && 'graphql-deprecated',
+        isHovered && 'graphql-hovered',
+        showTooltip && 'graphql-tooltip-open',
+        debug && 'graphql-debug',
+    ].filter(Boolean).join(' ');
+    const handleClick = (e) => {
+        e.preventDefault();
+        e.stopPropagation();
+        // Toggle tooltip on click
+        setShowTooltip(!showTooltip);
+    };
+    const handleNavigate = (e) => {
+        e.preventDefault();
+        e.stopPropagation();
+        if (isClickable) {
+            onNavigate(resolution.referenceUrl);
+        }
+    };
+    return (_jsxs(_Fragment, { children: [isClickable
+                ? (_jsx("a", { href: resolution.referenceUrl, className: classNames + ' graphql-identifier-link', style: {
+                        position: 'absolute',
+                        top: position.top,
+                        left: position.left,
+                        width: position.width,
+                        height: position.height,
+                        cursor: 'pointer',
+                        zIndex: 10,
+                        pointerEvents: 'auto',
+                        display: 'block',
+                        textDecoration: 'none',
+                        // Debug mode visual
+                        ...(debug && {
+                            backgroundColor: hasError ? 'rgba(239, 68, 68, 0.1)' : 'rgba(59, 130, 246, 0.1)',
+                            border: `1px solid ${hasError ? 'rgba(239, 68, 68, 0.3)' : 'rgba(59, 130, 246, 0.3)'}`,
+                        }),
+                    }, onClick: handleClick, onMouseEnter: () => setIsHovered(true), onMouseLeave: () => setIsHovered(false), "aria-label": `${identifier.kind} ${identifier.name} - Click to view documentation`, "data-graphql-identifier": identifier.name, "data-graphql-kind": identifier.kind }))
+                : (_jsx("div", { className: classNames, style: {
+                        position: 'absolute',
+                        top: position.top,
+                        left: position.left,
+                        width: position.width,
+                        height: position.height,
+                        cursor: 'pointer', // Make it clickable even for errors
+                        zIndex: 10,
+                        pointerEvents: 'auto',
+                        // Debug mode visual
+                        ...(debug && {
+                            backgroundColor: 'rgba(239, 68, 68, 0.1)',
+                            border: `1px solid rgba(239, 68, 68, 0.3)`,
+                        }),
+                    }, onClick: handleClick, onMouseEnter: () => setIsHovered(true), onMouseLeave: () => setIsHovered(false), role: 'button', "aria-label": `${identifier.kind} ${identifier.name} - Click to view information`, "data-graphql-identifier": identifier.name, "data-graphql-kind": identifier.kind })), showTooltip && (_jsx(HoverTooltip, { identifier: identifier, documentation: resolution.documentation || {
+                    description: hasError
+                        ? `${identifier.kind} "${identifier.name}" not found in schema. This ${identifier.kind.toLowerCase()} does not exist in the current GraphQL schema.`
+                        : `${identifier.kind}: ${identifier.name}`,
+                    typeInfo: identifier.kind,
+                }, position: position, hasError: hasError, referenceUrl: resolution.referenceUrl, onClose: () => setShowTooltip(false), onNavigate: isClickable ? () => onNavigate(resolution.referenceUrl) : undefined }))] }));
+};
+/**
+ * Default styles for identifier overlays
+ *
+ * These can be included in the document or overridden by custom styles.
+ */
+export const identifierLinkStyles = `
+.graphql-identifier-overlay {
+  /* Base styles for all overlays */
+  transition: background-color 0.2s ease;
+}
+
+.graphql-identifier-overlay.graphql-clickable:hover {
+  /* Subtle highlight on hover for clickable identifiers */
+  background-color: rgba(59, 130, 246, 0.05);
+}
+
+.graphql-identifier-overlay.graphql-error {
+  /* Error indicator */
+  border-bottom: 2px wavy red;
+}
+
+.graphql-identifier-overlay.graphql-deprecated {
+  /* Deprecated indicator */
+  text-decoration: line-through;
+  opacity: 0.7;
+}
+
+.graphql-identifier-overlay.graphql-debug {
+  /* Debug mode makes overlays visible */
+  background-color: rgba(59, 130, 246, 0.1) !important;
+  border: 1px solid rgba(59, 130, 246, 0.3) !important;
+}
+
+/* Kind-specific styles */
+.graphql-identifier-overlay.graphql-type {
+  /* Type identifiers */
+}
+
+.graphql-identifier-overlay.graphql-field {
+  /* Field identifiers */
+}
+
+.graphql-identifier-overlay.graphql-argument {
+  /* Argument identifiers */
+  font-style: italic;
+}
+
+.graphql-identifier-overlay.graphql-variable {
+  /* Variable identifiers */
+  color: var(--purple-11);
+}
+
+.graphql-identifier-overlay.graphql-directive {
+  /* Directive identifiers */
+  color: var(--amber-11);
+}
+`;
+//# sourceMappingURL=IdentifierLink.js.map

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

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

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

@@ -0,0 +1,5 @@
+export * from './GraphQLDocument.tsx';
+export * from './GraphQLDocumentWithSchema.tsx';
+export * from './HoverTooltip.tsx';
+export * from './IdentifierLink.tsx';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/graphql-document/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA"}

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

@@ -0,0 +1,5 @@
+export * from "./GraphQLDocument.js";
+export * from "./GraphQLDocumentWithSchema.js";
+export * from "./HoverTooltip.js";
+export * from "./IdentifierLink.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/graphql-document/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAuB,CAAA;AACrC,cAAc,gCAAiC,CAAA;AAC/C,cAAc,mBAAoB,CAAA;AAClC,cAAc,qBAAsB,CAAA"}

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

@@ -0,0 +1,25 @@
+/**
+ * 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 './$.ts';
+/**
+ * Demonstrate basic analysis
+ */
+export declare const analyzeExample: () => GraphQLDocument.AnalysisResult;
+/**
+ * Demonstrate identifier lookup by position
+ */
+export declare const demonstratePositionLookup: () => void;
+/**
+ * Demonstrate how this enables hyperlink generation
+ */
+export declare const demonstrateHyperlinkGeneration: () => void;
+/**
+ * Show the foundation for hover tooltips
+ */
+export declare const demonstrateTooltipFoundation: () => void;
+//# sourceMappingURL=example.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-document/example.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AA2BxC;;GAEG;AACH,eAAO,MAAM,cAAc,sCAsB1B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,YA2BrC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,YAsB1C,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,YAiBxC,CAAA"}

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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"}