polen 0.10.0-next.8 → 0.10.0

package/build/template/components/GraphQLInteractive/lib/graphql-node-types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Tree-sitter GraphQL Grammar Node Types
+ *
+ * This file defines all possible node types from the tree-sitter-graphql grammar.
+ * These types are used by the tree-sitter parser when parsing GraphQL documents.
+ *
+ * Source: https://github.com/bkegley/tree-sitter-graphql
+ *
+ * Having these as a TypeScript union type enables:
+ * - Type-safe node.type checking
+ * - IntelliSense/autocomplete in IDEs
+ * - Compile-time verification of node type strings
+ * - Better code maintainability and refactoring
+ */
+/**
+ * All possible node types that can be returned by tree-sitter-graphql
+ * when parsing GraphQL documents.
+ */
+export type TreeSitterGraphQLNodeType = 'document' | 'definition' | 'executable_definition' | 'type_system_definition' | 'type_system_extension' | 'source_file' | 'operation_definition' | 'selection_set' | 'selection' | 'field' | 'alias' | 'fragment_definition' | 'fragment_spread' | 'inline_fragment' | 'fragment_name' | 'type_condition' | 'arguments' | 'argument' | 'variable' | 'variable_definition' | 'variable_definitions' | 'default_value' | 'type' | 'named_type' | 'list_type' | 'non_null_type' | 'type_definition' | 'scalar_type_definition' | 'object_type_definition' | 'interface_type_definition' | 'union_type_definition' | 'enum_type_definition' | 'input_object_type_definition' | 'type_extension' | 'scalar_type_extension' | 'object_type_extension' | 'interface_type_extension' | 'union_type_extension' | 'enum_type_extension' | 'input_object_type_extension' | 'schema_definition' | 'schema_extension' | 'root_operation_type_definition' | 'fields_definition' | 'field_definition' | 'arguments_definition' | 'input_value_definition' | 'input_fields_definition' | 'directives' | 'directive' | 'directive_definition' | 'directive_locations' | 'directive_location' | 'enum_values_definition' | 'enum_value_definition' | 'enum_value' | 'implements_interfaces' | 'union_member_types' | 'description' | 'value' | 'string_value' | 'int_value' | 'float_value' | 'boolean_value' | 'null_value' | 'list_value' | 'object_value' | 'object_field' | 'name' | 'comment' | 'comma' | '{' | '}' | '(' | ')' | '[' | ']' | ':' | '=' | ',' | '!' | '|' | '&' | '@' | '...' | '$' | 'query' | 'mutation' | 'subscription' | 'fragment' | 'on' | 'type' | 'interface' | 'enum' | 'scalar' | 'union' | 'input' | 'schema' | 'directive' | 'implements' | 'extend' | 'true' | 'false' | 'null' | 'error_hint' | 'whitespace';
+/**
+ * Subset of node types that are interactive in Polen's GraphQL viewer
+ */
+export type InteractiveNodeParentType = 'named_type' | 'field';
+/**
+ * Subset of node types that are non-interactive user-defined names
+ */
+export type NonInteractiveNodeParentType = 'operation_definition' | 'fragment_definition' | 'variable_definition' | 'argument';
+/**
+ * Node types that represent keywords in GraphQL
+ */
+export type KeywordNodeType = 'query' | 'mutation' | 'subscription' | 'fragment' | 'on';
+/**
+ * Node types that represent literal values
+ */
+export type LiteralNodeType = 'string_value' | 'int_value' | 'float_value' | 'boolean_value' | 'null_value' | 'enum_value';
+/**
+ * Node types that represent punctuation
+ */
+export type PunctuationNodeType = '{' | '}' | '(' | ')' | '[' | ']' | ':' | '=' | ',' | '!' | '|' | '&' | '@' | '...' | '$';
+/**
+ * Helper function to check if a node type is a keyword
+ */
+export declare function isKeywordNodeType(type: string): type is KeywordNodeType;
+/**
+ * Helper function to check if a node type is a literal
+ */
+export declare function isLiteralNodeType(type: string): type is LiteralNodeType;
+/**
+ * Helper function to check if a node type is punctuation
+ */
+export declare function isPunctuationNodeType(type: string): type is PunctuationNodeType;
+//# sourceMappingURL=graphql-node-types.d.ts.map

package/build/template/components/GraphQLInteractive/lib/graphql-node-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-node-types.d.ts","sourceRoot":"","sources":["../../../../../src/template/components/GraphQLInteractive/lib/graphql-node-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAEjC,UAAU,GACV,YAAY,GACZ,uBAAuB,GACvB,wBAAwB,GACxB,uBAAuB,GACvB,aAAa,GAEb,sBAAsB,GACtB,eAAe,GACf,WAAW,GACX,OAAO,GACP,OAAO,GAEP,qBAAqB,GACrB,iBAAiB,GACjB,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAEhB,WAAW,GACX,UAAU,GACV,UAAU,GACV,qBAAqB,GACrB,sBAAsB,GACtB,eAAe,GAEf,MAAM,GACN,YAAY,GACZ,WAAW,GACX,eAAe,GAEf,iBAAiB,GACjB,wBAAwB,GACxB,wBAAwB,GACxB,2BAA2B,GAC3B,uBAAuB,GACvB,sBAAsB,GACtB,8BAA8B,GAE9B,gBAAgB,GAChB,uBAAuB,GACvB,uBAAuB,GACvB,0BAA0B,GAC1B,sBAAsB,GACtB,qBAAqB,GACrB,6BAA6B,GAE7B,mBAAmB,GACnB,kBAAkB,GAClB,gCAAgC,GAEhC,mBAAmB,GACnB,kBAAkB,GAClB,sBAAsB,GACtB,wBAAwB,GACxB,yBAAyB,GAEzB,YAAY,GACZ,WAAW,GACX,sBAAsB,GACtB,qBAAqB,GACrB,oBAAoB,GAEpB,wBAAwB,GACxB,uBAAuB,GACvB,YAAY,GAEZ,uBAAuB,GACvB,oBAAoB,GACpB,aAAa,GAEb,OAAO,GACP,cAAc,GACd,WAAW,GACX,aAAa,GACb,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,cAAc,GACd,cAAc,GAEd,MAAM,GACN,SAAS,GACT,OAAO,GAEP,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,KAAK,GACL,GAAG,GAEH,OAAO,GACP,UAAU,GACV,cAAc,GACd,UAAU,GACV,IAAI,GACJ,MAAM,GACN,WAAW,GACX,MAAM,GACN,QAAQ,GACR,OAAO,GACP,OAAO,GACP,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,QAAQ,GACR,MAAM,GACN,OAAO,GACP,MAAM,GAEN,YAAY,GACZ,YAAY,CAAA;AAEhB;;GAEG;AACH,MAAM,MAAM,yBAAyB,GACjC,YAAY,GACZ,OAAO,CAAA;AAEX;;GAEG;AACH,MAAM,MAAM,4BAA4B,GACpC,sBAAsB,GACtB,qBAAqB,GACrB,qBAAqB,GACrB,UAAU,CAAA;AAEd;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,UAAU,GAAG,cAAc,GAAG,UAAU,GAAG,IAAI,CAAA;AAEvF;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,WAAW,GACX,aAAa,GACb,eAAe,GACf,YAAY,GACZ,YAAY,CAAA;AAEhB;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,KAAK,GACL,GAAG,CAAA;AAEP;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,eAAe,CAEvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,eAAe,CAGvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,mBAAmB,CAE/E"}

package/build/template/components/GraphQLInteractive/lib/graphql-node-types.js

@@ -0,0 +1,34 @@
+/**
+ * Tree-sitter GraphQL Grammar Node Types
+ *
+ * This file defines all possible node types from the tree-sitter-graphql grammar.
+ * These types are used by the tree-sitter parser when parsing GraphQL documents.
+ *
+ * Source: https://github.com/bkegley/tree-sitter-graphql
+ *
+ * Having these as a TypeScript union type enables:
+ * - Type-safe node.type checking
+ * - IntelliSense/autocomplete in IDEs
+ * - Compile-time verification of node type strings
+ * - Better code maintainability and refactoring
+ */
+/**
+ * Helper function to check if a node type is a keyword
+ */
+export function isKeywordNodeType(type) {
+    return type === 'query' || type === 'mutation' || type === 'subscription' || type === 'fragment' || type === 'on';
+}
+/**
+ * Helper function to check if a node type is a literal
+ */
+export function isLiteralNodeType(type) {
+    return type === 'string_value' || type === 'int_value' || type === 'float_value'
+        || type === 'boolean_value' || type === 'null_value' || type === 'enum_value';
+}
+/**
+ * Helper function to check if a node type is punctuation
+ */
+export function isPunctuationNodeType(type) {
+    return ['{', '}', '(', ')', '[', ']', ':', '=', ',', '!', '|', '&', '@', '...', '$'].includes(type);
+}
+//# sourceMappingURL=graphql-node-types.js.map

package/build/template/components/GraphQLInteractive/lib/graphql-node-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-node-types.js","sourceRoot":"","sources":["../../../../../src/template/components/GraphQLInteractive/lib/graphql-node-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAuLH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,IAAI,CAAA;AACnH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,aAAa;WAC3E,IAAI,KAAK,eAAe,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,YAAY,CAAA;AACjF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AACrG,CAAC"}

package/build/template/components/GraphQLInteractive/lib/parser.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Tree-sitter GraphQL parsing with semantic analysis
+ *
+ * This module combines tree-sitter syntax parsing with GraphQL semantic
+ * analysis to create unified tokens for interactive code blocks.
+ */
+import type { CodeAnnotation } from 'codehike/code';
+import { type GraphQLSchema } from 'graphql';
+import * as WebTreeSitter from 'web-tree-sitter';
+import type { SemanticNode } from './semantic-nodes.js';
+/**
+ * Unified token structure that combines tree-sitter and GraphQL semantics
+ *
+ * This interface represents a single parsed token from a GraphQL document,
+ * enriched with semantic information from the GraphQL schema when available.
+ * It provides a consistent API for accessing syntax highlighting, interactivity,
+ * and CodeHike annotation data.
+ *
+ * @example
+ * ```typescript
+ * const tokens = await parseGraphQLWithTreeSitter(code, [], schema)
+ * const fieldToken = tokens.find(t => t.text === 'name')
+ *
+ * if (fieldToken?.polen.isInteractive()) {
+ *   const url = fieldToken.polen.getReferenceUrl()
+ *   console.log(`Navigate to: ${url}`)
+ * }
+ * ```
+ */
+export interface GraphQLToken {
+    /** Reference to the tree-sitter node that this token represents */
+    treeSitterNode: WebTreeSitter.Node;
+    /**
+     * Optional semantic information from GraphQL schema analysis
+     * This includes type information, field definitions, and validation results
+     */
+    semantic?: SemanticNode;
+    /** Text content of the token (computed from tree-sitter node) */
+    get text(): string;
+    /** Start character position in the source code (computed from tree-sitter node) */
+    get start(): number;
+    /** End character position in the source code (computed from tree-sitter node) */
+    get end(): number;
+    /** Polen specific functionality for interactive GraphQL documentation */
+    polen: {
+        /** Check if this token should be interactive (clickable/hoverable) */
+        isInteractive: () => boolean;
+        /** Get the reference URL for navigation, or null if not applicable */
+        getReferenceUrl: () => string | null;
+    };
+    /** Syntax highlighting functionality */
+    highlighter: {
+        /** Get the CSS class name for styling this token */
+        getCssClass: () => string;
+    };
+    /** CodeHike integration for enhanced code block features */
+    codeHike: {
+        /** Array of CodeHike annotations that apply to this token */
+        annotations: CodeAnnotation[];
+    };
+}
+/**
+ * Parse GraphQL code into interactive tokens with semantic information
+ *
+ * @param code - The raw GraphQL code to parse
+ * @param annotations - CodeHike annotations that might affect rendering
+ * @param schema - Optional GraphQL schema for semantic analysis
+ * @returns Array of tokens representing the parsed code
+ */
+export declare function parseGraphQLWithTreeSitter(code: string, annotations?: CodeAnnotation[], schema?: GraphQLSchema): Promise<GraphQLToken[]>;
+//# sourceMappingURL=parser.d.ts.map

package/build/template/components/GraphQLInteractive/lib/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../../src/template/components/GraphQLInteractive/lib/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAUL,KAAK,aAAa,EAInB,MAAM,SAAS,CAAA;AAEhB,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAA;AAQhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAWvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,cAAc,EAAE,aAAa,CAAC,IAAI,CAAA;IAElC;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAA;IAEvB,iEAAiE;IACjE,IAAI,IAAI,IAAI,MAAM,CAAA;IAElB,mFAAmF;IACnF,IAAI,KAAK,IAAI,MAAM,CAAA;IAEnB,iFAAiF;IACjF,IAAI,GAAG,IAAI,MAAM,CAAA;IAEjB,yEAAyE;IACzE,KAAK,EAAE;QACL,sEAAsE;QACtE,aAAa,EAAE,MAAM,OAAO,CAAA;QAC5B,sEAAsE;QACtE,eAAe,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;KACrC,CAAA;IAED,wCAAwC;IACxC,WAAW,EAAE;QACX,oDAAoD;QACpD,WAAW,EAAE,MAAM,MAAM,CAAA;KAC1B,CAAA;IAED,4DAA4D;IAC5D,QAAQ,EAAE;QACR,6DAA6D;QAC7D,WAAW,EAAE,cAAc,EAAE,CAAA;KAC9B,CAAA;CACF;AAqYD;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,EACZ,WAAW,GAAE,cAAc,EAAO,EAClC,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC,CAiDzB"}