@gqlkit-ts/cli 0.0.1 → 0.2.0

package/dist/type-extractor/types/ts-type-reference-factory.d.ts

@@ -0,0 +1,39 @@
+import type ts from "typescript";
+import type { InlineEnumMemberInfo, InlineObjectPropertyDef, ScalarTypeInfo, TSTypeReference } from "./typescript.js";
+interface CreateReferenceTypeParams {
+    readonly name: string;
+    readonly nullable: boolean;
+}
+export declare function createReferenceType(params: CreateReferenceTypeParams): TSTypeReference;
+interface CreatePrimitiveTypeParams {
+    readonly name: string;
+    readonly nullable: boolean;
+}
+export declare function createPrimitiveType(params: CreatePrimitiveTypeParams): TSTypeReference;
+export declare function createArrayType(elementType: TSTypeReference): TSTypeReference;
+interface CreateUnionTypeParams {
+    readonly members: ReadonlyArray<TSTypeReference>;
+    readonly nullable: boolean;
+}
+export declare function createUnionType(params: CreateUnionTypeParams): TSTypeReference;
+export declare function createInlineObjectType(properties: ReadonlyArray<InlineObjectPropertyDef>): TSTypeReference;
+interface CreateScalarTypeParams {
+    readonly name: string;
+    readonly scalarInfo: ScalarTypeInfo;
+    readonly nullable: boolean;
+}
+export declare function createScalarType(params: CreateScalarTypeParams): TSTypeReference;
+export declare function createLiteralType(name: string): TSTypeReference;
+interface CreateInlineEnumTypeParams {
+    readonly members: ReadonlyArray<InlineEnumMemberInfo>;
+    readonly nullable: boolean;
+    /** External TypeScript enum symbol for deduplication (null for string literal unions) */
+    readonly externalEnumSymbol: ts.Symbol | null;
+    /** TSDoc description from the external enum type itself (null for string literal unions) */
+    readonly externalEnumDescription: string | null;
+    /** @deprecated tag from the external enum type itself (null for string literal unions) */
+    readonly externalEnumDeprecated: import("../../shared/tsdoc-parser.js").DeprecationInfo | null;
+}
+export declare function createInlineEnumType(params: CreateInlineEnumTypeParams): TSTypeReference;
+export {};
+//# sourceMappingURL=ts-type-reference-factory.d.ts.map

package/dist/type-extractor/types/ts-type-reference-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-type-reference-factory.d.ts","sourceRoot":"","sources":["../../../src/type-extractor/types/ts-type-reference-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EACV,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,eAAe,EAChB,MAAM,iBAAiB,CAAC;AA0BzB,UAAU,yBAAyB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,yBAAyB,GAChC,eAAe,CAKjB;AAED,UAAU,yBAAyB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,yBAAyB,GAChC,eAAe,CAKjB;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,eAAe,GAAG,eAAe,CAE7E;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,qBAAqB,GAC5B,eAAe,CAKjB;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,aAAa,CAAC,uBAAuB,CAAC,GACjD,eAAe,CAKjB;AAED,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,sBAAsB,GAC7B,eAAe,CASjB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAE/D;AAED,UAAU,0BAA0B;IAClC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,kBAAkB,EAAE,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC;IAC9C,4FAA4F;IAC5F,QAAQ,CAAC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,0FAA0F;IAC1F,QAAQ,CAAC,sBAAsB,EAC3B,OAAO,8BAA8B,EAAE,eAAe,GACtD,IAAI,CAAC;CACV;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,0BAA0B,GACjC,eAAe,CAWjB"}

package/dist/type-extractor/types/ts-type-reference-factory.js

@@ -0,0 +1,69 @@
+function createTSTypeReference(params) {
+    return {
+        kind: params.kind,
+        name: null,
+        elementType: null,
+        members: null,
+        nullable: false,
+        scalarInfo: null,
+        inlineObjectProperties: null,
+        inlineEnumMembers: null,
+        externalEnumSymbol: null,
+        externalEnumDescription: null,
+        externalEnumDeprecated: null,
+        ...params.overrides,
+    };
+}
+export function createReferenceType(params) {
+    return createTSTypeReference({
+        kind: "reference",
+        overrides: { name: params.name, nullable: params.nullable },
+    });
+}
+export function createPrimitiveType(params) {
+    return createTSTypeReference({
+        kind: "primitive",
+        overrides: { name: params.name, nullable: params.nullable },
+    });
+}
+export function createArrayType(elementType) {
+    return createTSTypeReference({ kind: "array", overrides: { elementType } });
+}
+export function createUnionType(params) {
+    return createTSTypeReference({
+        kind: "union",
+        overrides: { members: params.members, nullable: params.nullable },
+    });
+}
+export function createInlineObjectType(properties) {
+    return createTSTypeReference({
+        kind: "inlineObject",
+        overrides: { inlineObjectProperties: properties },
+    });
+}
+export function createScalarType(params) {
+    return createTSTypeReference({
+        kind: "scalar",
+        overrides: {
+            name: params.name,
+            scalarInfo: params.scalarInfo,
+            nullable: params.nullable,
+        },
+    });
+}
+export function createLiteralType(name) {
+    return createTSTypeReference({ kind: "literal", overrides: { name } });
+}
+export function createInlineEnumType(params) {
+    return createTSTypeReference({
+        kind: "inlineEnum",
+        overrides: {
+            inlineEnumMembers: params.members,
+            nullable: params.nullable,
+            externalEnumSymbol: params.externalEnumSymbol,
+            externalEnumDescription: params.externalEnumDescription,
+            externalEnumDeprecated: params.externalEnumDeprecated,
+        },
+    });
+}
+//# sourceMappingURL=ts-type-reference-factory.js.map

package/dist/type-extractor/types/ts-type-reference-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-type-reference-factory.js","sourceRoot":"","sources":["../../../src/type-extractor/types/ts-type-reference-factory.ts"],"names":[],"mappings":"AAaA,SAAS,qBAAqB,CAC5B,MAAmC;IAEnC,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,IAAI;QACjB,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,IAAI;QAChB,sBAAsB,EAAE,IAAI;QAC5B,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,IAAI;QACxB,uBAAuB,EAAE,IAAI;QAC7B,sBAAsB,EAAE,IAAI;QAC5B,GAAG,MAAM,CAAC,SAAS;KACpB,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,mBAAmB,CACjC,MAAiC;IAEjC,OAAO,qBAAqB,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;KAC5D,CAAC,CAAC;AACL,CAAC;AAOD,MAAM,UAAU,mBAAmB,CACjC,MAAiC;IAEjC,OAAO,qBAAqB,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;KAC5D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAA4B;IAC1D,OAAO,qBAAqB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;AAC9E,CAAC;AAOD,MAAM,UAAU,eAAe,CAC7B,MAA6B;IAE7B,OAAO,qBAAqB,CAAC;QAC3B,IAAI,EAAE,OAAO;QACb,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;KAClE,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,UAAkD;IAElD,OAAO,qBAAqB,CAAC;QAC3B,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,EAAE,sBAAsB,EAAE,UAAU,EAAE;KAClD,CAAC,CAAC;AACL,CAAC;AAQD,MAAM,UAAU,gBAAgB,CAC9B,MAA8B;IAE9B,OAAO,qBAAqB,CAAC;QAC3B,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,qBAAqB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AACzE,CAAC;AAeD,MAAM,UAAU,oBAAoB,CAClC,MAAkC;IAElC,OAAO,qBAAqB,CAAC;QAC3B,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE;YACT,iBAAiB,EAAE,MAAM,CAAC,OAAO;YACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,uBAAuB,EAAE,MAAM,CAAC,uBAAuB;YACvD,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;SACtD;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/type-extractor/types/typescript.d.ts

@@ -0,0 +1,106 @@
+import type ts from "typescript";
+import type { DirectiveArgumentValue, DirectiveInfo } from "../../shared/directive-detector.js";
+import type { DeprecationInfo } from "../../shared/tsdoc-parser.js";
+import type { SourceLocation } from "./diagnostics.js";
+export type TypeKind = "object" | "interface" | "union" | "enum" | "graphqlInterface";
+/**
+ * Information about a detected scalar type.
+ */
+export interface ScalarTypeInfo {
+    /** The GraphQL scalar type name (ID, Int, Float, String, Boolean, or custom scalar name) */
+    readonly scalarName: string;
+    /** The TypeScript type name (e.g., "IDString", "Int", "DateTime") */
+    readonly typeName: string;
+    /** The underlying TypeScript primitive type (undefined for custom scalars) */
+    readonly baseType: "string" | "number" | undefined;
+    /** Whether this is a custom scalar */
+    readonly isCustom: boolean;
+    /** Usage constraint: "input" for input-only, "output" for output-only, null for both */
+    readonly only: "input" | "output" | null;
+}
+export interface TypeMetadata {
+    readonly name: string;
+    readonly kind: TypeKind;
+    readonly sourceFile: string;
+    readonly sourceLocation: SourceLocation;
+    readonly exportKind: "named" | "default";
+    readonly description: string | null;
+    readonly deprecated: DeprecationInfo | null;
+    readonly directives: ReadonlyArray<DirectiveInfo> | null;
+}
+export type TSTypeReferenceKind = "primitive" | "reference" | "array" | "union" | "literal" | "scalar" | "inlineObject" | "inlineEnum";
+/**
+ * Information about an inline enum member (string literal union value).
+ */
+export interface InlineEnumMemberInfo {
+    /** Original value from TypeScript (e.g., "pendingReview") */
+    readonly value: string;
+    /** Description from TSDoc (if available) */
+    readonly description: string | null;
+    /** Deprecation info from @deprecated tag */
+    readonly deprecated: DeprecationInfo | null;
+}
+export interface TSTypeReference {
+    readonly kind: TSTypeReferenceKind;
+    readonly name: string | null;
+    readonly elementType: TSTypeReference | null;
+    readonly members: ReadonlyArray<TSTypeReference> | null;
+    readonly nullable: boolean;
+    readonly scalarInfo: ScalarTypeInfo | null;
+    readonly inlineObjectProperties: ReadonlyArray<InlineObjectPropertyDef> | null;
+    /** Inline enum members when kind is "inlineEnum" */
+    readonly inlineEnumMembers: ReadonlyArray<InlineEnumMemberInfo> | null;
+    /** External TypeScript enum symbol for deduplication (Requirement 5.2) */
+    readonly externalEnumSymbol: ts.Symbol | null;
+    /** TSDoc description from the external enum type itself (Requirement 6.1) */
+    readonly externalEnumDescription: string | null;
+    /** @deprecated tag from the external enum type itself (Requirement 6.3) */
+    readonly externalEnumDeprecated: DeprecationInfo | null;
+}
+export interface InlineObjectPropertyDef {
+    readonly name: string;
+    readonly tsType: TSTypeReference;
+    readonly optional: boolean;
+    readonly description: string | null;
+    readonly deprecated: DeprecationInfo | null;
+    readonly directives: ReadonlyArray<DirectiveInfo> | null;
+    readonly defaultValue: DirectiveArgumentValue | null;
+    readonly sourceLocation: SourceLocation | null;
+}
+export interface FieldDefinition {
+    readonly name: string;
+    readonly tsType: TSTypeReference;
+    readonly optional: boolean;
+    readonly description: string | null;
+    readonly deprecated: DeprecationInfo | null;
+    readonly directives: ReadonlyArray<DirectiveInfo> | null;
+    readonly defaultValue: DirectiveArgumentValue | null;
+    readonly sourceLocation: SourceLocation | null;
+}
+export interface EnumMemberInfo {
+    readonly name: string;
+    readonly value: string;
+    /** Numeric value for numeric enums, null for string enums */
+    readonly numericValue: number | null;
+    readonly description: string | null;
+    readonly deprecated: DeprecationInfo | null;
+    readonly sourceLocation: SourceLocation | null;
+}
+export interface InlineObjectProperty {
+    readonly propertyName: string;
+    readonly propertyType: TSTypeReference;
+    readonly description: string | null;
+    readonly deprecated: DeprecationInfo | null;
+}
+export interface InlineObjectMember {
+    readonly properties: ReadonlyArray<InlineObjectProperty>;
+}
+export interface ExtractedTypeInfo {
+    readonly metadata: TypeMetadata;
+    readonly fields: ReadonlyArray<FieldDefinition>;
+    readonly unionMembers: ReadonlyArray<string> | null;
+    readonly inlineObjectMembers: ReadonlyArray<InlineObjectMember> | null;
+    readonly enumMembers: ReadonlyArray<EnumMemberInfo> | null;
+    readonly implementedInterfaces: ReadonlyArray<string> | null;
+}
+//# sourceMappingURL=typescript.d.ts.map

package/dist/type-extractor/types/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../src/type-extractor/types/typescript.ts"],"names":[],"mappings":"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"}

package/dist/type-extractor/types/typescript.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typescript.js.map

package/dist/type-extractor/types/typescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../../src/type-extractor/types/typescript.ts"],"names":[],"mappings":""}

package/dist/type-extractor/validator/type-validator.d.ts

@@ -0,0 +1,11 @@
+import type { Diagnostic, GraphQLTypeInfo } from "../types/index.js";
+export interface ValidationResult {
+    readonly valid: boolean;
+    readonly diagnostics: ReadonlyArray<Diagnostic>;
+}
+export interface ValidateTypesOptions {
+    readonly types: ReadonlyArray<GraphQLTypeInfo>;
+    readonly customScalarNames: ReadonlyArray<string> | null;
+}
+export declare function validateTypes(typesOrOptions: ReadonlyArray<GraphQLTypeInfo> | ValidateTypesOptions): ValidationResult;
+//# sourceMappingURL=type-validator.d.ts.map

package/dist/type-extractor/validator/type-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-validator.d.ts","sourceRoot":"","sources":["../../../src/type-extractor/validator/type-validator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CAC1D;AASD,wBAAgB,aAAa,CAC3B,cAAc,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,oBAAoB,GACpE,gBAAgB,CAsDlB"}

package/dist/type-extractor/validator/type-validator.js

@@ -0,0 +1,53 @@
+import { BUILT_IN_SCALARS } from "../../shared/constants.js";
+const PLACEHOLDER_TYPES = new Set(["__INLINE_OBJECT__", "__INLINE_ENUM__"]);
+function isOptionsObject(arg) {
+    return !Array.isArray(arg) && "types" in arg;
+}
+export function validateTypes(typesOrOptions) {
+    const types = isOptionsObject(typesOrOptions)
+        ? typesOrOptions.types
+        : typesOrOptions;
+    const customScalarNames = isOptionsObject(typesOrOptions)
+        ? typesOrOptions.customScalarNames
+        : undefined;
+    const diagnostics = [];
+    const typeNames = new Set(types.map((t) => t.name));
+    const knownScalars = new Set([
+        ...BUILT_IN_SCALARS,
+        ...(customScalarNames ?? []),
+    ]);
+    for (const type of types) {
+        if (type.kind === "Object" && type.fields) {
+            for (const field of type.fields) {
+                const typeName = field.type.typeName;
+                if (!typeNames.has(typeName) &&
+                    !knownScalars.has(typeName) &&
+                    !PLACEHOLDER_TYPES.has(typeName)) {
+                    diagnostics.push({
+                        code: "UNRESOLVED_REFERENCE",
+                        message: `Field '${field.name}' references unresolved type '${typeName}'`,
+                        severity: "error",
+                        location: { file: type.sourceFile, line: 1, column: 1 },
+                    });
+                }
+            }
+        }
+        if (type.kind === "Union" && type.unionMembers) {
+            for (const member of type.unionMembers) {
+                if (!typeNames.has(member) && !knownScalars.has(member)) {
+                    diagnostics.push({
+                        code: "UNRESOLVED_REFERENCE",
+                        message: `Union '${type.name}' references unresolved type '${member}'`,
+                        severity: "error",
+                        location: { file: type.sourceFile, line: 1, column: 1 },
+                    });
+                }
+            }
+        }
+    }
+    return {
+        valid: diagnostics.length === 0,
+        diagnostics,
+    };
+}
+//# sourceMappingURL=type-validator.js.map

package/dist/type-extractor/validator/type-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-validator.js","sourceRoot":"","sources":["../../../src/type-extractor/validator/type-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAY7D,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAE5E,SAAS,eAAe,CACtB,GAA0D;IAE1D,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,IAAI,GAAG,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,cAAqE;IAErE,MAAM,KAAK,GAAG,eAAe,CAAC,cAAc,CAAC;QAC3C,CAAC,CAAC,cAAc,CAAC,KAAK;QACtB,CAAC,CAAC,cAAc,CAAC;IACnB,MAAM,iBAAiB,GAAG,eAAe,CAAC,cAAc,CAAC;QACvD,CAAC,CAAC,cAAc,CAAC,iBAAiB;QAClC,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,WAAW,GAAiB,EAAE,CAAC;IAErC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;QAC3B,GAAG,gBAAgB;QACnB,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;KAC7B,CAAC,CAAC;IAEH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAErC,IACE,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;oBACxB,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC;oBAC3B,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAChC,CAAC;oBACD,WAAW,CAAC,IAAI,CAAC;wBACf,IAAI,EAAE,sBAAsB;wBAC5B,OAAO,EAAE,UAAU,KAAK,CAAC,IAAI,iCAAiC,QAAQ,GAAG;wBACzE,QAAQ,EAAE,OAAO;wBACjB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;qBACxD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACvC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBACxD,WAAW,CAAC,IAAI,CAAC;wBACf,IAAI,EAAE,sBAAsB;wBAC5B,OAAO,EAAE,UAAU,IAAI,CAAC,IAAI,iCAAiC,MAAM,GAAG;wBACtE,QAAQ,EAAE,OAAO;wBACjB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;qBACxD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC;QAC/B,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/docs/configuration.md

@@ -0,0 +1,163 @@
+# Configuration
+
+gqlkit can be configured via `gqlkit.config.ts` in your project root.
+
+## Basic Configuration
+
+```ts
+// gqlkit.config.ts
+import { defineConfig } from "@gqlkit-ts/cli";
+
+export default defineConfig({
+  // Source directory (default: "src/gqlkit/schema")
+  sourceDir: "src/gqlkit/schema",
+
+  // Glob patterns to exclude from scanning
+  sourceIgnoreGlobs: ["**/*.test.ts"],
+
+  // Custom scalar mappings (config-based approach)
+  scalars: [
+    {
+      name: "DateTime",
+      tsType: { from: "./src/gqlkit/schema/scalars", name: "DateTime" },
+      description: "ISO 8601 datetime",
+    },
+    {
+      name: "UUID",
+      tsType: { name: "string" }, // Global type
+    },
+  ],
+
+  // Output paths
+  output: {
+    typeDefsPath: "src/gqlkit/__generated__/typeDefs.ts",
+    resolversPath: "src/gqlkit/__generated__/resolvers.ts",
+    schemaPath: "src/gqlkit/__generated__/schema.graphql",
+    // Set to null to disable output:
+    // schemaPath: null,
+  },
+
+  // Hooks
+  hooks: {
+    // Run after all files are written (e.g., formatting)
+    afterAllFileWrite: "prettier --write",
+    // Or multiple commands:
+    // afterAllFileWrite: ["prettier --write", "eslint --fix"],
+  },
+});
+```
+
+## Custom Scalar Types
+
+Map TypeScript types to GraphQL custom scalars via config:
+
+```ts
+export default defineConfig({
+  scalars: [
+    {
+      name: "DateTime",
+      tsType: { from: "./src/gqlkit/schema/scalars", name: "DateTime" },
+      description: "ISO 8601 datetime string",
+    },
+    {
+      name: "UUID",
+      tsType: { name: "string" },
+      only: "input", // Input-only scalar
+    },
+  ],
+});
+```
+
+### Scalar Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `name` | `string` | The GraphQL scalar name |
+| `tsType.name` | `string` | The TypeScript type name |
+| `tsType.from` | `string` (optional) | Import path for the type (omit for global types) |
+| `description` | `string` (optional) | Description for the GraphQL schema |
+| `only` | `"input"` \| `"output"` (optional) | Restrict scalar to input or output positions |
+
+> [!TIP]
+>
+> You can also define custom scalars using the `GqlScalar` utility type directly in your schema files. See [Scalars](/schema/scalars) for more details.
+
+## Output Paths
+
+Customize output file locations or disable specific outputs:
+
+```ts
+export default defineConfig({
+  output: {
+    typeDefsPath: "generated/schema.ts", // Custom path
+    resolversPath: "generated/resolvers.ts",
+    schemaPath: null, // Disable SDL output
+  },
+});
+```
+
+### Output Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `typeDefsPath` | `string` \| `null` | `"src/gqlkit/__generated__/typeDefs.ts"` | Path for the TypeDefs output |
+| `resolversPath` | `string` \| `null` | `"src/gqlkit/__generated__/resolvers.ts"` | Path for the resolvers output |
+| `schemaPath` | `string` \| `null` | `"src/gqlkit/__generated__/schema.graphql"` | Path for the SDL output |
+
+Set any path to `null` to disable that output.
+
+## Hooks
+
+Execute commands after file generation:
+
+```ts
+export default defineConfig({
+  hooks: {
+    // Single command
+    afterAllFileWrite: "prettier --write",
+  },
+});
+```
+
+You can also specify multiple commands to run sequentially:
+
+```ts
+export default defineConfig({
+  hooks: {
+    // Multiple commands (executed sequentially)
+    afterAllFileWrite: ["prettier --write", "eslint --fix"],
+  },
+});
+```
+
+### Available Hooks
+
+| Hook | Description |
+|------|-------------|
+| `afterAllFileWrite` | Runs after all generated files are written. Receives the list of written file paths. |
+
+## Source Directory
+
+By default, gqlkit scans `src/gqlkit/schema` for types and resolvers.
+
+```ts
+export default defineConfig({
+  sourceDir: "src/graphql/schema", // Custom source directory
+});
+```
+
+All TypeScript files (`.ts`, `.cts`, `.mts`) under this directory are scanned.
+
+## Ignore Patterns
+
+Exclude files from scanning using glob patterns:
+
+```ts
+export default defineConfig({
+  sourceIgnoreGlobs: [
+    "**/*.test.ts",
+    "**/*.spec.ts",
+    "**/testdata/**",
+  ],
+});
+```

package/docs/getting-started.md

@@ -0,0 +1,117 @@
+# Getting Started
+
+## Installation
+
+```sh filename="npm"
+npm install @gqlkit-ts/runtime @graphql-tools/schema graphql
+npm install -D @gqlkit-ts/cli
+```
+
+```sh filename="pnpm"
+pnpm add @gqlkit-ts/runtime @graphql-tools/schema graphql
+pnpm add -D @gqlkit-ts/cli
+```
+
+```sh filename="yarn"
+yarn add @gqlkit-ts/runtime @graphql-tools/schema graphql
+yarn add -D @gqlkit-ts/cli
+```
+
+## Project Structure
+
+gqlkit expects your types and resolvers to be in `src/gqlkit/schema/`:
+
+```
+src/
+└── gqlkit/
+    ├── context.ts       # Context type definition
+    ├── gqlkit.ts        # Resolver factories
+    └── schema/
+        ├── user.ts      # User type and resolvers
+        ├── post.ts      # Post type and resolvers
+        └── query.ts     # Query resolvers
+```
+
+## Set Up Context and Resolver Factories
+
+Create `src/gqlkit/context.ts` to define your context type:
+
+```typescript
+export type Context = {
+  currentUser: { id: string; name: string; email: string | null } | null;
+};
+```
+
+Create `src/gqlkit/gqlkit.ts` to export resolver factories:
+
+```typescript
+import { createGqlkitApis } from "@gqlkit-ts/runtime";
+import type { Context } from "./context";
+
+export const { defineQuery, defineMutation, defineField } =
+  createGqlkitApis<Context>();
+```
+
+## Define Your First Type
+
+Create a simple User type in `src/gqlkit/schema/user.ts`:
+
+```typescript
+export type User = {
+  id: string;
+  name: string;
+  email: string | null;
+};
+```
+
+## Define a Query
+
+Create a query resolver in `src/gqlkit/schema/query.ts`:
+
+```typescript
+import { defineQuery } from "../gqlkit";
+import type { NoArgs } from "@gqlkit-ts/runtime";
+import type { User } from "./user";
+
+export const me = defineQuery<NoArgs, User | null>(
+  (_root, _args, ctx) => ctx.currentUser
+);
+```
+
+## Generate Schema
+
+Run the generator:
+
+```sh filename="npm"
+npm exec gqlkit gen
+```
+
+```sh filename="pnpm"
+pnpm gqlkit gen
+```
+
+```sh filename="yarn"
+yarn gqlkit gen
+```
+
+This will create files in `src/gqlkit/__generated__/`:
+- `schema.ts` - GraphQL schema AST (DocumentNode)
+- `resolvers.ts` - Resolver map
+
+## Create GraphQL Schema
+
+Use `@graphql-tools/schema` to combine the generated outputs into an executable schema:
+
+```typescript
+import { makeExecutableSchema } from "@graphql-tools/schema";
+import { typeDefs } from "./gqlkit/__generated__/schema";
+import { resolvers } from "./gqlkit/__generated__/resolvers";
+
+export const schema = makeExecutableSchema({ typeDefs, resolvers });
+```
+
+## Next Steps
+
+- [HTTP Server Integration](./integration/yoga) - Connect your schema to graphql-yoga, Apollo Server, or other HTTP servers
+- [Object Types](./schema/objects) - Learn more about defining types
+- [Queries & Mutations](./schema/queries-mutations) - Advanced resolver patterns

package/docs/index.md

@@ -0,0 +1,33 @@
+# gqlkit
+
+> gqlkit is a convention-driven code generator for GraphQL servers in TypeScript. Define GraphQL types and resolver signatures in TypeScript, then `gqlkit gen` generates GraphQL schema AST and a resolver map from your codebase.
+
+## Documentation
+
+- [What is gqlkit?](./what-is-gqlkit.md): gqlkit is a convention-driven code generator for GraphQL servers in TypeScript.
+- [Getting Started](./getting-started.md): gqlkit expects your types and resolvers to be in `src/gqlkit/schema/`:
+
+## Schema Definition
+
+- [Schema Definition](./schema.md): gqlkit generates GraphQL schema from your TypeScript types. All exported types from `src/gqlkit/schema/` are automatically scanned and converted to GraphQL types.
+- [Object Types](./schema/objects.md): Plain TypeScript type exports become GraphQL Object types.
+- [Input Types](./schema/inputs.md): TypeScript types with `Input` suffix are treated as GraphQL input types.
+- [Queries & Mutations](./schema/queries-mutations.md): Define Query and Mutation fields using the `@gqlkit-ts/runtime` API.
+- [Field Resolvers](./schema/fields.md): Add computed fields to object types using `defineField`. Define them alongside the type.
+- [Scalar Types](./schema/scalars.md): gqlkit provides built-in scalar types and supports custom scalar definitions.
+- [Enum Types](./schema/enums.md): gqlkit converts TypeScript string literal unions and enums to GraphQL enum types.
+- [Union Types](./schema/unions.md): TypeScript union types of object types are converted to GraphQL union types.
+- [Interface Types](./schema/interfaces.md): Define GraphQL interface types using the `GqlInterface` utility type.
+- [Abstract Type Resolution](./schema/abstract-resolvers.md): GraphQL abstract types (unions and interfaces) require runtime type resolution to determine the concrete type of returned values. gqlkit provides `defineResolveType` and `defineIsTypeOf` to handle this.
+- [Documentation](./schema/documentation.md): gqlkit extracts TSDoc/JSDoc comments and converts them to GraphQL descriptions.
+- [Custom Directives](./schema/directives.md): Define custom directives using the `GqlDirective` utility type and attach them using `GqlField` or `GqlObject`.
+
+## Integration
+
+- [graphql-yoga](./integration/yoga.md): [graphql-yoga](https://the-guild.dev/graphql/yoga-server) is a batteries-included GraphQL server that works in any JavaScript runtime.
+- [Apollo Server](./integration/apollo.md): [Apollo Server](https://www.apollographql.com/docs/apollo-server/) is a popular GraphQL server with extensive features and ecosystem.
+- [Drizzle ORM](./integration/drizzle.md): [Drizzle ORM](https://orm.drizzle.team/) is a TypeScript ORM with type-safe schema definitions. gqlkit integrates seamlessly with Drizzle by using `InferSelectModel` and `InferInsertModel` to derive GraphQL types from your table definitions.
+
+## Guides
+
+- [Configuration](./configuration.md): gqlkit can be configured via `gqlkit.config.ts` in your project root.