polen 0.11.0-next.11 → 0.11.0-next.13

package/build/lib/graphql-path/definition.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Definition path operations
+ */
+import type { ArgumentSegment, FieldSegment, TypeSegment } from '#lib/graphql-path/types';
+/**
+ * Encode a definition path to a human-readable expression string
+ *
+ * @param path - The definition path to encode
+ * @returns A string expression representation
+ * @example
+ * encode(field('User', 'name')) // 'User.name'
+ * encode(argument('User', 'posts', 'limit')) // 'User.posts(limit)'
+ */
+export declare const encode: (path: DefinitionPath) => string;
+/**
+ * Decode a string expression into a definition path
+ *
+ * @param expression - The string expression to decode
+ * @returns The decoded definition path or null if invalid
+ * @example
+ * decode('User') // type definition path
+ * decode('User.name') // field definition path
+ * decode('User.posts(limit)') // argument definition path
+ */
+export declare const decode: (expression: string) => DefinitionPath | null;
+/**
+ * Extract the type name from any definition path
+ *
+ * @param path - The definition path
+ * @returns The type name
+ * @example getType([{ kind: 'type', type: 'User' }]) // 'User'
+ */
+export declare const getType: (path: DefinitionPath) => string;
+/**
+ * Extract the field name from a field or argument definition path
+ *
+ * @param path - The field or argument definition path
+ * @returns The field name
+ * @example getField([{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]) // 'name'
+ */
+export declare const getField: (path: FieldDefinitionPath | ArgumentDefinitionPath) => string;
+/**
+ * Extract the argument name from an argument definition path
+ *
+ * @param path - The argument definition path
+ * @returns The argument name
+ * @example getArgument([{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]) // 'limit'
+ */
+export declare const getArgument: (path: ArgumentDefinitionPath) => string;
+/**
+ * Parse field path like "User.email" into type and field names
+ */
+export declare const parseFieldPath: (path?: string) => {
+    typeName: string | null;
+    fieldName: string | null;
+};
+/**
+ * Definition paths - direct paths to schema definition elements
+ * These represent the "address" of a specific schema element
+ */
+export type DefinitionPath = TypeDefinitionPath | FieldDefinitionPath | ArgumentDefinitionPath;
+/**
+ * Path to a type definition
+ * @example [{ kind: 'type', type: 'User' }]
+ */
+export type TypeDefinitionPath = [TypeSegment];
+/**
+ * Path to a field definition (type + field)
+ * @example [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]
+ */
+export type FieldDefinitionPath = [TypeSegment, FieldSegment];
+/**
+ * Path to an argument definition (type + field + argument)
+ * @example [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]
+ */
+export type ArgumentDefinitionPath = [TypeSegment, FieldSegment, ArgumentSegment];
+/**
+ * Type guard to check if a path is a type definition path
+ *
+ * @param path - The path to check
+ * @returns True if the path is a type definition path
+ */
+export declare const isTypeDefinitionPath: (path: DefinitionPath) => path is TypeDefinitionPath;
+/**
+ * Type guard to check if a path is a field definition path
+ *
+ * @param path - The path to check
+ * @returns True if the path is a field definition path
+ */
+export declare const isFieldDefinitionPath: (path: DefinitionPath) => path is FieldDefinitionPath;
+/**
+ * Type guard to check if a path is an argument definition path
+ *
+ * @param path - The path to check
+ * @returns True if the path is an argument definition path
+ */
+export declare const isArgumentDefinitionPath: (path: DefinitionPath) => path is ArgumentDefinitionPath;
+/**
+ * Create a path to a type definition
+ *
+ * @param type - The type name
+ * @returns A type definition path
+ * @example createTypeDefinitionPath('User') // [{ kind: 'type', type: 'User' }]
+ */
+export declare const createTypeDefinitionPath: (type: string) => TypeDefinitionPath;
+/**
+ * Create a path to a field definition
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @returns A field definition path
+ * @example createFieldDefinitionPath('User', 'name') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]
+ */
+export declare const createFieldDefinitionPath: (type: string, field: string) => FieldDefinitionPath;
+/**
+ * Create a path to an argument definition
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @param argument - The argument name
+ * @returns An argument definition path
+ * @example createArgumentDefinitionPath('User', 'posts', 'limit') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]
+ */
+export declare const createArgumentDefinitionPath: (type: string, field: string, argument: string) => ArgumentDefinitionPath;
+/**
+ * Create a type definition path
+ *
+ * @param type - The type name
+ * @returns A type definition path
+ * @example type('User') // [{ kind: 'type', type: 'User' }]
+ */
+export declare const type: (type: string) => TypeDefinitionPath;
+/**
+ * Create a field definition path
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @returns A field definition path
+ * @example field('User', 'name') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]
+ */
+export declare const field: (type: string, field: string) => FieldDefinitionPath;
+/**
+ * Create an argument definition path
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @param argument - The argument name
+ * @returns An argument definition path
+ * @example argument('User', 'posts', 'limit') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]
+ */
+export declare const argument: (type: string, field: string, argument: string) => ArgumentDefinitionPath;
+//# sourceMappingURL=definition.d.ts.map

package/build/lib/graphql-path/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-path/definition.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAEzF;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,cAAc,KAAG,MAS7C,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,GAAI,YAAY,MAAM,KAAG,cAAc,GAAG,IAwB5D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,cAAc,KAAG,MAE9C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,mBAAmB,GAAG,sBAAsB,KAAG,MAE7E,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,sBAAsB,KAAG,MAE1D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAYjG,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,mBAAmB,GACnB,sBAAsB,CAAA;AAE1B;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,WAAW,CAAC,CAAA;AAE9C;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAA;AAE7D;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,eAAe,CAAC,CAAA;AAEjF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,cAAc,KAAG,IAAI,IAAI,kBAEnE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,cAAc,KAAG,IAAI,IAAI,mBAEpE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,cAAc,KAAG,IAAI,IAAI,sBAEvE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,MAAM,KAAG,kBAEvD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,mBAEvE,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,UAAU,MAAM,KACf,sBAEF,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,SAxC8B,MAAM,KAAG,kBAwCZ,CAAA;AAE5C;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,SAtC8B,MAAM,SAAS,MAAM,KAAG,mBAsC1B,CAAA;AAE9C;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,SAnCb,MAAM,SACL,MAAM,YACH,MAAM,KACf,sBAgCiD,CAAA"}

package/build/lib/graphql-path/definition.js

@@ -0,0 +1,192 @@
+/**
+ * Definition path operations
+ */
+import { createArgumentSegment, createFieldSegment, createTypeSegment } from './constructors.js';
+/**
+ * Encode a definition path to a human-readable expression string
+ *
+ * @param path - The definition path to encode
+ * @returns A string expression representation
+ * @example
+ * encode(field('User', 'name')) // 'User.name'
+ * encode(argument('User', 'posts', 'limit')) // 'User.posts(limit)'
+ */
+export const encode = (path) => {
+    if (isTypeDefinitionPath(path)) {
+        return path[0].type;
+    }
+    else if (isFieldDefinitionPath(path)) {
+        return `${path[0].type}.${path[1].field}`;
+    }
+    else if (isArgumentDefinitionPath(path)) {
+        return `${path[0].type}.${path[1].field}(${path[2].argument})`;
+    }
+    return '';
+};
+/**
+ * Decode a string expression into a definition path
+ *
+ * @param expression - The string expression to decode
+ * @returns The decoded definition path or null if invalid
+ * @example
+ * decode('User') // type definition path
+ * decode('User.name') // field definition path
+ * decode('User.posts(limit)') // argument definition path
+ */
+export const decode = (expression) => {
+    // Handle argument path: Type.field(argument)
+    const argMatch = expression.match(/^([^.]+)\.([^.(]+)\(([^)]+)\)$/);
+    if (argMatch) {
+        const [, typeName, fieldName, argName] = argMatch;
+        if (!typeName || !fieldName || !argName)
+            return null;
+        return createArgumentDefinitionPath(typeName, fieldName, argName);
+    }
+    // Handle field path: Type.field
+    const fieldMatch = expression.match(/^([^.]+)\.([^.]+)$/);
+    if (fieldMatch) {
+        const [, typeName, fieldName] = fieldMatch;
+        if (!typeName || !fieldName)
+            return null;
+        return createFieldDefinitionPath(typeName, fieldName);
+    }
+    // Handle type path: Type
+    const typeMatch = expression.match(/^[^.]+$/);
+    if (typeMatch) {
+        return createTypeDefinitionPath(expression);
+    }
+    return null;
+};
+/**
+ * Extract the type name from any definition path
+ *
+ * @param path - The definition path
+ * @returns The type name
+ * @example getType([{ kind: 'type', type: 'User' }]) // 'User'
+ */
+export const getType = (path) => {
+    return path[0].type;
+};
+/**
+ * Extract the field name from a field or argument definition path
+ *
+ * @param path - The field or argument definition path
+ * @returns The field name
+ * @example getField([{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]) // 'name'
+ */
+export const getField = (path) => {
+    return path[1].field;
+};
+/**
+ * Extract the argument name from an argument definition path
+ *
+ * @param path - The argument definition path
+ * @returns The argument name
+ * @example getArgument([{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]) // 'limit'
+ */
+export const getArgument = (path) => {
+    return path[2].argument;
+};
+/**
+ * Parse field path like "User.email" into type and field names
+ */
+export const parseFieldPath = (path) => {
+    if (!path)
+        return { typeName: null, fieldName: null };
+    const parts = path.split('.');
+    if (parts.length >= 2) {
+        return {
+            typeName: parts[0] || null,
+            fieldName: parts[1] || null,
+        };
+    }
+    return { typeName: null, fieldName: null };
+};
+/**
+ * Type guard to check if a path is a type definition path
+ *
+ * @param path - The path to check
+ * @returns True if the path is a type definition path
+ */
+export const isTypeDefinitionPath = (path) => {
+    return path.length === 1 && path[0].kind === 'type';
+};
+/**
+ * Type guard to check if a path is a field definition path
+ *
+ * @param path - The path to check
+ * @returns True if the path is a field definition path
+ */
+export const isFieldDefinitionPath = (path) => {
+    return path.length === 2 && path[0].kind === 'type' && path[1].kind === 'field';
+};
+/**
+ * Type guard to check if a path is an argument definition path
+ *
+ * @param path - The path to check
+ * @returns True if the path is an argument definition path
+ */
+export const isArgumentDefinitionPath = (path) => {
+    return path.length === 3 && path[0].kind === 'type' && path[1].kind === 'field' && path[2].kind === 'argument';
+};
+/**
+ * Create a path to a type definition
+ *
+ * @param type - The type name
+ * @returns A type definition path
+ * @example createTypeDefinitionPath('User') // [{ kind: 'type', type: 'User' }]
+ */
+export const createTypeDefinitionPath = (type) => {
+    return [createTypeSegment(type)];
+};
+/**
+ * Create a path to a field definition
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @returns A field definition path
+ * @example createFieldDefinitionPath('User', 'name') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]
+ */
+export const createFieldDefinitionPath = (type, field) => {
+    return [createTypeSegment(type), createFieldSegment(field)];
+};
+/**
+ * Create a path to an argument definition
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @param argument - The argument name
+ * @returns An argument definition path
+ * @example createArgumentDefinitionPath('User', 'posts', 'limit') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]
+ */
+export const createArgumentDefinitionPath = (type, field, argument) => {
+    return [createTypeSegment(type), createFieldSegment(field), createArgumentSegment(argument)];
+};
+/**
+ * Create a type definition path
+ *
+ * @param type - The type name
+ * @returns A type definition path
+ * @example type('User') // [{ kind: 'type', type: 'User' }]
+ */
+export const type = createTypeDefinitionPath;
+/**
+ * Create a field definition path
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @returns A field definition path
+ * @example field('User', 'name') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'name' }]
+ */
+export const field = createFieldDefinitionPath;
+/**
+ * Create an argument definition path
+ *
+ * @param type - The type name
+ * @param field - The field name
+ * @param argument - The argument name
+ * @returns An argument definition path
+ * @example argument('User', 'posts', 'limit') // [{ kind: 'type', type: 'User' }, { kind: 'field', field: 'posts' }, { kind: 'argument', argument: 'limit' }]
+ */
+export const argument = createArgumentDefinitionPath;
+//# sourceMappingURL=definition.js.map

package/build/lib/graphql-path/definition.js.map

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

package/build/lib/graphql-path/query.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Query path operations
+ */
+import type { QueryPath } from './types.js';
+/**
+ * Builder class for creating query paths with a fluent interface
+ *
+ * @example
+ * ```ts
+ * const path = builder()
+ *   .type('User')
+ *   .field('posts')
+ *   .type('Post')
+ *   .field('author')
+ *   .build()
+ * ```
+ */
+export declare class QueryPathBuilder {
+    private segments;
+    /**
+     * Add a type segment to the path
+     *
+     * @param typeName - The type name
+     * @returns The builder for chaining
+     */
+    type(typeName: string): this;
+    /**
+     * Add a field segment to the path
+     *
+     * @param fieldName - The field name
+     * @returns The builder for chaining
+     */
+    field(fieldName: string): this;
+    /**
+     * Build the final query path
+     *
+     * @returns The constructed query path
+     */
+    build(): QueryPath;
+}
+/**
+ * Create a new query path builder
+ *
+ * @returns A new query path builder instance
+ * @example
+ * ```ts
+ * const path = builder()
+ *   .type('User')
+ *   .field('posts')
+ *   .type('Post')
+ *   .field('author')
+ *   .build()
+ * ```
+ */
+export declare const builder: () => QueryPathBuilder;
+/**
+ * Encode a query path to a human-readable expression string
+ *
+ * @param path - The query path to encode
+ * @returns A string expression representation
+ * @example
+ * encode(builder().type('User').field('posts').type('Post').field('title').build()) // 'User.posts.Post.title'
+ */
+export declare const encode: (path: QueryPath) => string;
+/**
+ * Decode a string expression into a query path
+ * Note: This assumes alternating type.field.type.field pattern
+ *
+ * @param expression - The string expression to decode
+ * @returns The decoded query path or null if invalid
+ * @example
+ * decode('User.posts.Post.title') // Query path traversing User->posts->Post->title
+ */
+export declare const decode: (expression: string) => QueryPath | null;
+//# sourceMappingURL=query.d.ts.map

package/build/lib/graphql-path/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-path/query.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,YAAY,CAAA;AAEzD;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAqB;IAErC;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK5B;;;;;OAKG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK9B;;;;OAIG;IACH,KAAK,IAAI,SAAS;CAGnB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,QAAO,gBAA0C,CAAA;AAErE;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,SAAS,KAAG,MAMxC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,GAAI,YAAY,MAAM,KAAG,SAAS,GAAG,IAqBvD,CAAA"}

package/build/lib/graphql-path/query.js

@@ -0,0 +1,111 @@
+/**
+ * Query path operations
+ */
+import { createFieldSegment, createTypeSegment } from './constructors.js';
+/**
+ * Builder class for creating query paths with a fluent interface
+ *
+ * @example
+ * ```ts
+ * const path = builder()
+ *   .type('User')
+ *   .field('posts')
+ *   .type('Post')
+ *   .field('author')
+ *   .build()
+ * ```
+ */
+export class QueryPathBuilder {
+    segments = [];
+    /**
+     * Add a type segment to the path
+     *
+     * @param typeName - The type name
+     * @returns The builder for chaining
+     */
+    type(typeName) {
+        this.segments.push(createTypeSegment(typeName));
+        return this;
+    }
+    /**
+     * Add a field segment to the path
+     *
+     * @param fieldName - The field name
+     * @returns The builder for chaining
+     */
+    field(fieldName) {
+        this.segments.push(createFieldSegment(fieldName));
+        return this;
+    }
+    /**
+     * Build the final query path
+     *
+     * @returns The constructed query path
+     */
+    build() {
+        return this.segments;
+    }
+}
+/**
+ * Create a new query path builder
+ *
+ * @returns A new query path builder instance
+ * @example
+ * ```ts
+ * const path = builder()
+ *   .type('User')
+ *   .field('posts')
+ *   .type('Post')
+ *   .field('author')
+ *   .build()
+ * ```
+ */
+export const builder = () => new QueryPathBuilder();
+/**
+ * Encode a query path to a human-readable expression string
+ *
+ * @param path - The query path to encode
+ * @returns A string expression representation
+ * @example
+ * encode(builder().type('User').field('posts').type('Post').field('title').build()) // 'User.posts.Post.title'
+ */
+export const encode = (path) => {
+    return path.map(segment => {
+        if (segment.kind === 'type')
+            return segment.type;
+        if (segment.kind === 'field')
+            return segment.field;
+        return '';
+    }).filter(Boolean).join('.');
+};
+/**
+ * Decode a string expression into a query path
+ * Note: This assumes alternating type.field.type.field pattern
+ *
+ * @param expression - The string expression to decode
+ * @returns The decoded query path or null if invalid
+ * @example
+ * decode('User.posts.Post.title') // Query path traversing User->posts->Post->title
+ */
+export const decode = (expression) => {
+    if (!expression)
+        return null;
+    const parts = expression.split('.');
+    const segments = [];
+    // Assume alternating pattern: type.field.type.field...
+    for (let i = 0; i < parts.length; i++) {
+        const part = parts[i];
+        if (!part)
+            continue;
+        if (i % 2 === 0) {
+            // Even indices are types
+            segments.push(createTypeSegment(part));
+        }
+        else {
+            // Odd indices are fields
+            segments.push(createFieldSegment(part));
+        }
+    }
+    return segments;
+};
+//# sourceMappingURL=query.js.map

package/build/lib/graphql-path/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/lib/graphql-path/query.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAGzE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,gBAAgB;IACnB,QAAQ,GAAmB,EAAE,CAAA;IAErC;;;;;OAKG;IACH,IAAI,CAAC,QAAgB;QACnB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC/C,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAiB;QACrB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAA;QACjD,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,GAAqB,EAAE,CAAC,IAAI,gBAAgB,EAAE,CAAA;AAErE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAe,EAAU,EAAE;IAChD,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QACxB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,OAAO,CAAC,IAAI,CAAA;QAChD,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC,KAAK,CAAA;QAClD,OAAO,EAAE,CAAA;IACX,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9B,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,UAAkB,EAAoB,EAAE;IAC7D,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAA;IAE5B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACnC,MAAM,QAAQ,GAAmB,EAAE,CAAA;IAEnC,uDAAuD;IACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACrB,IAAI,CAAC,IAAI;YAAE,SAAQ;QAEnB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAChB,yBAAyB;YACzB,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAA;QACxC,CAAC;aAAM,CAAC;YACN,yBAAyB;YACzB,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA"}

package/build/lib/graphql-path/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * GraphQL Path type definitions
+ */
+/**
+ * Base segment representing a GraphQL type in a path
+ */
+export interface TypeSegment {
+    kind: 'type';
+    type: string;
+}
+/**
+ * Base segment representing a field in a path
+ */
+export interface FieldSegment {
+    kind: 'field';
+    field: string;
+}
+/**
+ * Base segment representing an argument in a path
+ */
+export interface ArgumentSegment {
+    kind: 'argument';
+    argument: string;
+}
+/**
+ * Union of all possible segments
+ */
+export type Segment = TypeSegment | FieldSegment | ArgumentSegment;
+/**
+ * Query segments - only types and fields can be traversed in queries
+ * Arguments cannot be part of query paths as they are not traversable
+ */
+export type QuerySegment = TypeSegment | FieldSegment;
+/**
+ * Query/Data paths - potentially deep paths that span multiple types through fields
+ * These represent traversal paths through the schema graph
+ *
+ * @example
+ * User.posts.author.name would be:
+ * [
+ *   { kind: 'type', type: 'User' },
+ *   { kind: 'field', field: 'posts' },
+ *   { kind: 'type', type: 'Post' },
+ *   { kind: 'field', field: 'author' },
+ *   { kind: 'type', type: 'User' },
+ *   { kind: 'field', field: 'name' }
+ * ]
+ */
+export type QueryPath = QuerySegment[];
+//# sourceMappingURL=types.d.ts.map

package/build/lib/graphql-path/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-path/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,eAAe,CAAA;AAElE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,YAAY,CAAA;AAErD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA"}

package/build/lib/graphql-path/types.js

@@ -0,0 +1,5 @@
+/**
+ * GraphQL Path type definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/build/lib/graphql-path/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/graphql-path/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/build/lib/graphql-schema-loader/{index.js → $.d.ts}

@@ -1,2 +1,2 @@
 export * as GraphqlSchemaLoader from './graphql-schema-loader.js';
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=$.d.ts.map

package/build/lib/graphql-schema-loader/$.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-schema-loader/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,mBAAmB,MAAM,4BAA4B,CAAA"}

package/build/lib/graphql-schema-loader/{index.d.ts → $.js}

@@ -1,2 +1,2 @@
 export * as GraphqlSchemaLoader from './graphql-schema-loader.js';
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=$.js.map

package/build/lib/graphql-schema-loader/$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$.js","sourceRoot":"","sources":["../../../src/lib/graphql-schema-loader/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,mBAAmB,MAAM,4BAA4B,CAAA"}

package/build/lib/graphql-schema-loader/graphql-schema-loader.d.ts

@@ -1,4 +1,4 @@
-import { Grafaid } from '#lib/grafaid/index';
+import { Grafaid } from '#lib/grafaid';
 export type SchemaPointer = {
     type: `introspect`;
     url: string;

package/build/lib/graphql-schema-loader/graphql-schema-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphql-schema-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-schema-loader/graphql-schema-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAM5C,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,YAAY,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,GAAG;IACF,IAAI,EAAE,KAAK,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG;IACF,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,IAAI,GAAU,QAAQ,aAAa,KAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CA+D/E,CAAA"}
+{"version":3,"file":"graphql-schema-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-schema-loader/graphql-schema-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAMtC,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,YAAY,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,GAAG;IACF,IAAI,EAAE,KAAK,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG;IACF,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,IAAI,GAAU,QAAQ,aAAa,KAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CA+D/E,CAAA"}

package/build/lib/graphql-schema-loader/graphql-schema-loader.js

@@ -1,4 +1,4 @@
-import { Grafaid } from '#lib/grafaid/index';
+import { Grafaid } from '#lib/grafaid';
 import { Fs } from '@wollybeard/kit';
 import { neverCase } from '@wollybeard/kit/language';
 import { Graffle } from 'graffle';