polen 0.10.0-next.9 → 0.10.0

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,iCAAiC,CAAA;AACjE,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,63 @@
+/**
+ * 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.js';
+/**
+ * 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 syntax-highlighted 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>;
+}
+/**
+ * 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;IAsGP;;OAEG;IACH,sBAAsB,CACpB,gBAAgB,EAAE,OAAO,EACzB,iBAAiB,CAAC,EAAE,OAAO,GAC1B,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;CA2C/B;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"}

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

@@ -0,0 +1,185 @@
+/**
+ * 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.
+ */
+/**
+ * Simplified position calculator for syntax-highlighted 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 class SimplePositionCalculator {
+    /**
+     * Prepare a code block for positioning by wrapping identifiers in spans
+     */
+    prepareCodeBlock(containerElement, identifiers) {
+        // Get the full text content of the container
+        const fullText = containerElement.textContent || ``;
+        const lines = fullText.split(`\n`);
+        // Build a map of line start positions in the full text
+        const lineStartPositions = [0];
+        for (let i = 0; i < lines.length - 1; i++) {
+            const lineLength = lines[i]?.length ?? 0;
+            lineStartPositions.push(lineStartPositions[i] + lineLength + 1); // +1 for newline
+        }
+        // Process identifiers by line
+        for (const identifier of identifiers) {
+            const lineIndex = identifier.position.line - 1;
+            if (lineIndex >= lines.length || lineIndex < 0)
+                continue;
+            const lineText = lines[lineIndex];
+            if (!lineText)
+                continue;
+            const columnIndex = identifier.position.column - 1;
+            // Check if the identifier exists at the expected position
+            if (lineText.substring(columnIndex).startsWith(identifier.name)) {
+                // Calculate the absolute position in the full text
+                const lineStartPosition = lineStartPositions[lineIndex] ?? 0;
+                const absolutePosition = lineStartPosition + columnIndex;
+                // Check if already wrapped at this specific position
+                const existingWrapped = containerElement.querySelectorAll(`[data-graphql-id]`);
+                let alreadyWrapped = false;
+                for (const wrapped of existingWrapped) {
+                    if (wrapped.textContent === identifier.name) {
+                        const startPos = parseInt(wrapped.getAttribute(`data-graphql-start`) || `0`);
+                        if (startPos === identifier.position.start) {
+                            alreadyWrapped = true;
+                            break;
+                        }
+                    }
+                }
+                if (alreadyWrapped)
+                    continue;
+                // Create wrapper span
+                const wrapper = document.createElement(`span`);
+                const id = `${identifier.position.start}-${identifier.name}-${identifier.kind}`;
+                wrapper.setAttribute(`data-graphql-id`, id);
+                wrapper.setAttribute(`data-graphql-name`, identifier.name);
+                wrapper.setAttribute(`data-graphql-kind`, identifier.kind);
+                wrapper.setAttribute(`data-graphql-start`, String(identifier.position.start));
+                wrapper.setAttribute(`data-graphql-end`, String(identifier.position.end));
+                wrapper.setAttribute(`data-graphql-line`, String(identifier.position.line));
+                wrapper.setAttribute(`data-graphql-column`, String(identifier.position.column));
+                wrapper.setAttribute(`data-graphql-path`, identifier.schemaPath.join(`,`));
+                // Find the position in the container and wrap the text
+                const walker = document.createTreeWalker(containerElement, NodeFilter.SHOW_TEXT, null);
+                let currentPos = 0;
+                let node;
+                while (node = walker.nextNode()) {
+                    const textNode = node;
+                    const text = textNode.textContent || ``;
+                    // Check if this text node contains our identifier
+                    if (currentPos <= absolutePosition && absolutePosition < currentPos + text.length) {
+                        const relativePos = absolutePosition - currentPos;
+                        if (text.substring(relativePos).startsWith(identifier.name)) {
+                            // Split the text node
+                            const before = text.substring(0, relativePos);
+                            const identifierText = identifier.name;
+                            const after = text.substring(relativePos + identifierText.length);
+                            const parent = textNode.parentNode;
+                            if (before) {
+                                parent.insertBefore(document.createTextNode(before), textNode);
+                            }
+                            wrapper.textContent = identifierText;
+                            parent.insertBefore(wrapper, textNode);
+                            if (after) {
+                                parent.insertBefore(document.createTextNode(after), textNode);
+                            }
+                            parent.removeChild(textNode);
+                            break;
+                        }
+                    }
+                    currentPos += text.length;
+                }
+            }
+        }
+    }
+    /**
+     * Get positions of all wrapped identifiers
+     */
+    getIdentifierPositions(containerElement, relativeToElement) {
+        const results = new Map();
+        // Find all wrapped identifiers
+        const wrappedIdentifiers = containerElement.querySelectorAll(`[data-graphql-id]`);
+        // Use the provided element for relative positioning, or the container itself
+        const referenceElement = relativeToElement || containerElement;
+        for (const element of wrappedIdentifiers) {
+            const id = element.getAttribute(`data-graphql-id`);
+            if (!id)
+                continue;
+            // Get position relative to the reference element
+            const referenceRect = referenceElement.getBoundingClientRect();
+            const elementRect = element.getBoundingClientRect();
+            const position = {
+                top: elementRect.top - referenceRect.top,
+                left: elementRect.left - referenceRect.left,
+                width: elementRect.width,
+                height: elementRect.height,
+            };
+            // Reconstruct identifier from data attributes
+            const identifier = {
+                name: element.getAttribute(`data-graphql-name`) || ``,
+                kind: (element.getAttribute(`data-graphql-kind`) || `Field`),
+                position: {
+                    start: parseInt(element.getAttribute(`data-graphql-start`) || `0`),
+                    end: parseInt(element.getAttribute(`data-graphql-end`) || `0`),
+                    line: parseInt(element.getAttribute(`data-graphql-line`) || `1`),
+                    column: parseInt(element.getAttribute(`data-graphql-column`) || `1`),
+                },
+                schemaPath: (element.getAttribute(`data-graphql-path`) || ``).split(`,`).filter(Boolean),
+                context: { selectionPath: [] },
+            };
+            results.set(id, { position, identifier });
+        }
+        return results;
+    }
+}
+/**
+ * Create invisible overlay for a position
+ */
+export const createSimpleOverlay = (position, identifier, options) => {
+    const overlay = document.createElement(`div`);
+    // Base styles for positioning
+    overlay.style.position = `absolute`;
+    overlay.style.top = `${position.top}px`;
+    overlay.style.left = `${position.left}px`;
+    overlay.style.width = `${position.width}px`;
+    overlay.style.height = `${position.height}px`;
+    overlay.style.cursor = `pointer`;
+    overlay.style.zIndex = `10`;
+    // Add custom class if provided
+    if (options?.className) {
+        overlay.className = options.className;
+    }
+    // Data attributes
+    overlay.setAttribute(`data-graphql-overlay`, `true`);
+    overlay.setAttribute(`data-graphql-name`, identifier.name);
+    overlay.setAttribute(`data-graphql-kind`, identifier.kind);
+    // Event handlers
+    if (options?.onClick) {
+        overlay.addEventListener(`click`, (e) => {
+            e.preventDefault();
+            options.onClick(identifier);
+        });
+    }
+    if (options?.onHover) {
+        overlay.addEventListener(`mouseenter`, (e) => {
+            options.onHover(identifier, e);
+        });
+    }
+    return overlay;
+};
+/**
+ * Factory function for position calculator
+ */
+export const createSimplePositionCalculator = () => {
+    return new SimplePositionCalculator();
+};
+//# sourceMappingURL=positioning-simple.js.map

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

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

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

@@ -0,0 +1,8 @@
+import type { GraphQLSchema } from 'graphql';
+import React from 'react';
+export declare const GraphQLSchemaContext: React.Context<GraphQLSchema | null>;
+export declare const useGraphQLSchema: () => GraphQLSchema | null;
+export declare const GraphQLSchemaProvider: React.FC<React.PropsWithChildren<{
+    schema: GraphQLSchema | null;
+}>>;
+//# sourceMappingURL=schema-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-context.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-document/schema-context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,eAAO,MAAM,oBAAoB,qCAAkD,CAAA;AAEnF,eAAO,MAAM,gBAAgB,4BAG5B,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,CAAC,CASrG,CAAA"}

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

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+export const GraphQLSchemaContext = React.createContext(null);
+export const useGraphQLSchema = () => {
+    const schema = React.useContext(GraphQLSchemaContext);
+    return schema;
+};
+export const GraphQLSchemaProvider = ({ children, schema, }) => {
+    return (_jsx(GraphQLSchemaContext.Provider, { value: schema, children: children }));
+};
+//# sourceMappingURL=schema-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-context.js","sourceRoot":"","sources":["../../../src/lib/graphql-document/schema-context.tsx"],"names":[],"mappings":";AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC,aAAa,CAAuB,IAAI,CAAC,CAAA;AAEnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,EAAE;IACnC,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAA;IACrD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAwE,CAAC,EACzG,QAAQ,EACR,MAAM,GACP,EAAE,EAAE;IACH,OAAO,CACL,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YACzC,QAAQ,GACqB,CACjC,CAAA;AACH,CAAC,CAAA"}

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

@@ -0,0 +1,135 @@
+/**
+ * Layer 2: Schema Integration
+ *
+ * Bridge between GraphQL analysis and Polen's schema system.
+ * Resolves identifiers against the actual schema, extracts documentation,
+ * and generates reference URLs for navigation.
+ */
+import { type GraphQLSchema, type GraphQLType } from 'graphql';
+import type { Identifier } from './types.js';
+/**
+ * Documentation extracted from GraphQL schema
+ */
+export interface Documentation {
+    /** Description from schema SDL or introspection */
+    description?: string;
+    /** Type signature (e.g., "String!", "[User!]!") */
+    typeInfo: string;
+    /** Whether this field/type is deprecated */
+    deprecated?: {
+        reason: string;
+        replacement?: string;
+    };
+    /** Default value for arguments */
+    defaultValue?: string;
+}
+/**
+ * Result of resolving an identifier against the schema
+ */
+export interface SchemaResolution {
+    /** Whether the identifier exists in the schema */
+    exists: boolean;
+    /** Documentation extracted from schema */
+    documentation?: Documentation;
+    /** URL to the reference page for this identifier */
+    referenceUrl: string;
+    /** Whether this identifier is deprecated */
+    deprecated?: {
+        reason: string;
+        replacement?: string;
+    };
+    /** The GraphQL type if this is a type identifier */
+    graphqlType?: GraphQLType;
+}
+/**
+ * Interface for resolving GraphQL identifiers against a schema
+ */
+export interface SchemaResolver {
+    /**
+     * Resolve an identifier against the schema
+     */
+    resolveIdentifier(identifier: Identifier): SchemaResolution | null;
+    /**
+     * Get documentation for a schema path
+     */
+    getDocumentation(schemaPath: string[]): Documentation | null;
+    /**
+     * Generate a reference URL for a schema path
+     */
+    generateReferenceLink(schemaPath: string[]): string;
+    /**
+     * Check if a type exists in the schema
+     */
+    typeExists(typeName: string): boolean;
+    /**
+     * Get all available types for validation
+     */
+    getAllTypes(): string[];
+}
+/**
+ * Configuration for URL generation
+ */
+export interface RouteConfig {
+    /** Base path for reference pages (default: "/reference") */
+    basePath?: string;
+    /** Whether to include fragments in URLs (default: true) */
+    includeFragments?: boolean;
+}
+/**
+ * Polen's implementation of SchemaResolver
+ */
+export declare class PolenSchemaResolver implements SchemaResolver {
+    private schema;
+    private routeConfig;
+    constructor(schema: GraphQLSchema, routeConfig?: RouteConfig);
+    /**
+     * Resolve an identifier against the schema
+     */
+    resolveIdentifier(identifier: Identifier): SchemaResolution | null;
+    /**
+     * Get documentation for a schema path
+     */
+    getDocumentation(schemaPath: string[]): Documentation | null;
+    /**
+     * Generate a reference URL for a schema path
+     */
+    generateReferenceLink(schemaPath: string[]): string;
+    /**
+     * Check if a type exists in the schema
+     */
+    typeExists(typeName: string): boolean;
+    /**
+     * Get all available types for validation
+     */
+    getAllTypes(): string[];
+    private resolveType;
+    private resolveField;
+    private resolveArgument;
+    private resolveDirective;
+    private getFieldFromType;
+    private getTypeSignature;
+}
+/**
+ * Create a schema resolver for Polen
+ */
+export declare const createPolenSchemaResolver: (schema: GraphQLSchema, routeConfig?: RouteConfig) => SchemaResolver;
+/**
+ * Enhanced analysis result with schema resolution
+ */
+export interface SchemaAwareAnalysisResult {
+    /** Original analysis result */
+    analysis: import('./types.js').AnalysisResult;
+    /** Schema resolutions for all identifiers */
+    resolutions: Map<string, SchemaResolution>;
+    /** Validation errors from schema checking */
+    schemaErrors: {
+        identifier: Identifier;
+        message: string;
+        severity: `error` | `warning`;
+    }[];
+}
+/**
+ * Perform schema-aware analysis of a GraphQL document
+ */
+export declare const analyzeWithSchema: (source: string, schema: GraphQLSchema, routeConfig?: RouteConfig) => SchemaAwareAnalysisResult;
+//# sourceMappingURL=schema-integration.d.ts.map