@ptdgrp/typedgql 1.0.0-beta.15 → 1.0.0-beta.20

package/dist/{schema-loader-DolAa42F.cjs → config-loader-Bxj44SGD.cjs}

@@ -25,12 +25,15 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
+let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
 let graphql = require("graphql");
 let fs_promises = require("fs/promises");
 let fs = require("fs");
 let path = require("path");
 let typescript = require("typescript");
 typescript = __toESM(typescript);
+let smol_toml = require("smol-toml");
 
 //#region src/codegen/utils.ts
 /**
@@ -111,62 +114,63 @@ var JSImportCollector = class {
 		return Array.from(map.entries()).sort((a, b) => a[0].localeCompare(b[0]));
 	}
 };
-const RUNTIME_ENTRY_SOURCE = "../../dist/index.mjs";
+const DEFAULT_RUNTIME_ENTRY_SOURCE = "../../dist/index.mjs";
+const DEFAULT_ROOT_RUNTIME_ENTRY_SOURCE = "../dist/index.mjs";
 const TYPE_HIERARCHY_SOURCE = "../type-hierarchy";
 const ENUM_INPUT_METADATA_SOURCE = "../enum-input-metadata";
 const SCALAR_TYPES_SOURCE = "../scalar-types";
 const SCALAR_TYPES_NAMESPACE = "UserScalarTypes";
 const CODEGEN_IMPORT_SOURCE_MAP = {
 	AcceptableVariables: {
-		source: RUNTIME_ENTRY_SOURCE,
+		source: DEFAULT_RUNTIME_ENTRY_SOURCE,
 		kind: "type"
 	},
 	UnresolvedVariables: {
-		source: RUNTIME_ENTRY_SOURCE,
+		source: DEFAULT_RUNTIME_ENTRY_SOURCE,
 		kind: "type"
 	},
 	DirectiveArgs: {
-		source: RUNTIME_ENTRY_SOURCE,
+		source: DEFAULT_RUNTIME_ENTRY_SOURCE,
 		kind: "type"
 	},
 	Selection: {
-		source: RUNTIME_ENTRY_SOURCE,
+		source: DEFAULT_RUNTIME_ENTRY_SOURCE,
 		kind: "type"
 	},
 	ShapeOf: {
-		source: RUNTIME_ENTRY_SOURCE,
+		source: DEFAULT_RUNTIME_ENTRY_SOURCE,
 		kind: "type"
 	},
 	VariablesOf: {
-		source: RUNTIME_ENTRY_SOURCE,
+		source: DEFAULT_RUNTIME_ENTRY_SOURCE,
 		kind: "type"
 	},
 	ValueOrThunk: {
-		source: RUNTIME_ENTRY_SOURCE,
+		source: DEFAULT_RUNTIME_ENTRY_SOURCE,
 		kind: "type"
 	},
 	FragmentSpread: {
-		source: RUNTIME_ENTRY_SOURCE,
+		source: DEFAULT_RUNTIME_ENTRY_SOURCE,
 		kind: "type"
 	},
 	createSelection: {
-		source: RUNTIME_ENTRY_SOURCE,
+		source: DEFAULT_RUNTIME_ENTRY_SOURCE,
 		kind: "value"
 	},
 	withOperationName: {
-		source: RUNTIME_ENTRY_SOURCE,
+		source: DEFAULT_RUNTIME_ENTRY_SOURCE,
 		kind: "value"
 	},
 	createSchemaType: {
-		source: RUNTIME_ENTRY_SOURCE,
+		source: DEFAULT_RUNTIME_ENTRY_SOURCE,
 		kind: "value"
 	},
 	registerSchemaTypeFactory: {
-		source: RUNTIME_ENTRY_SOURCE,
+		source: DEFAULT_RUNTIME_ENTRY_SOURCE,
 		kind: "value"
 	},
 	resolveRegisteredSchemaType: {
-		source: RUNTIME_ENTRY_SOURCE,
+		source: DEFAULT_RUNTIME_ENTRY_SOURCE,
 		kind: "value"
 	},
 	ENUM_INPUT_METADATA: {
@@ -186,10 +190,73 @@ const CODEGEN_IMPORT_SOURCE_MAP = {
 		kind: "type"
 	},
 	EnumInputMetadataBuilder: {
-		source: "../dist/index.mjs",
+		source: DEFAULT_ROOT_RUNTIME_ENTRY_SOURCE,
 		kind: "value"
 	}
 };
+function createCodegenImportSourceMap(options) {
+	const runtimeEntrySource = options.runtimeEntrySource ?? DEFAULT_RUNTIME_ENTRY_SOURCE;
+	const rootRuntimeEntrySource = options.rootRuntimeEntrySource ?? DEFAULT_ROOT_RUNTIME_ENTRY_SOURCE;
+	return {
+		...CODEGEN_IMPORT_SOURCE_MAP,
+		AcceptableVariables: {
+			source: runtimeEntrySource,
+			kind: "type"
+		},
+		UnresolvedVariables: {
+			source: runtimeEntrySource,
+			kind: "type"
+		},
+		DirectiveArgs: {
+			source: runtimeEntrySource,
+			kind: "type"
+		},
+		Selection: {
+			source: runtimeEntrySource,
+			kind: "type"
+		},
+		ShapeOf: {
+			source: runtimeEntrySource,
+			kind: "type"
+		},
+		VariablesOf: {
+			source: runtimeEntrySource,
+			kind: "type"
+		},
+		ValueOrThunk: {
+			source: runtimeEntrySource,
+			kind: "type"
+		},
+		FragmentSpread: {
+			source: runtimeEntrySource,
+			kind: "type"
+		},
+		createSelection: {
+			source: runtimeEntrySource,
+			kind: "value"
+		},
+		withOperationName: {
+			source: runtimeEntrySource,
+			kind: "value"
+		},
+		createSchemaType: {
+			source: runtimeEntrySource,
+			kind: "value"
+		},
+		registerSchemaTypeFactory: {
+			source: runtimeEntrySource,
+			kind: "value"
+		},
+		resolveRegisteredSchemaType: {
+			source: runtimeEntrySource,
+			kind: "value"
+		},
+		EnumInputMetadataBuilder: {
+			source: rootRuntimeEntrySource,
+			kind: "value"
+		}
+	};
+}
 
 //#endregion
 //#region src/codegen/writer.ts
@@ -231,9 +298,10 @@ var Writer = class {
 	importedTypes = /* @__PURE__ */ new Set();
 	usesScalarTypeNamespaceImport = false;
 	importFinalized = false;
-	constructor(stream, options) {
+	constructor(stream, options, importSourceMap = CODEGEN_IMPORT_SOURCE_MAP) {
 		this.stream = stream;
 		this.options = options;
+		this.importSourceMap = importSourceMap;
 		this.indent = options.indent ?? "    ";
 	}
 	/**
@@ -415,7 +483,7 @@ var Writer = class {
 	}
 	writeMappedScalarImports() {
 		if (!this.usesScalarTypeNamespaceImport) return;
-		const source = CODEGEN_IMPORT_SOURCE_MAP.SCALAR_TYPE_NAMESPACE.source;
+		const source = this.importSourceMap.SCALAR_TYPE_NAMESPACE.source;
 		const importSource = this.isUnderGlobalDir() ? source.replace(/^\.\.\//, "./") : source;
 		this.stream.write(`import type { ${SCALAR_TYPES_NAMESPACE} } from '${importSource}';\n`);
 	}
@@ -496,8 +564,8 @@ var SelectionWriter = class extends Writer {
 	fieldCategoryMap;
 	hasArgs;
 	_declaredFieldNames;
-	constructor(modelType, ctx, stream, options) {
-		super(stream, options);
+	constructor(modelType, ctx, stream, options, importSourceMap) {
+		super(stream, options, importSourceMap);
 		this.modelType = modelType;
 		this.ctx = ctx;
 		this.selectionTypeName = `${this.modelType.name}${options.selectionSuffix ?? "Selection"}`;
@@ -577,7 +645,7 @@ var SelectionWriter = class extends Writer {
 		return "SCALAR";
 	}
 	prepareImports() {
-		const imports = new JSImportCollector((stmt) => this.importStatement(stmt), CODEGEN_IMPORT_SOURCE_MAP);
+		const imports = new JSImportCollector((stmt) => this.importStatement(stmt), this.importSourceMap);
 		imports.useMapped("DirectiveArgs");
 		imports.useMapped("Selection");
 		if (this.hasArgs) {
@@ -1203,7 +1271,7 @@ const COMMENT$1 = `/*
  * Any instance of this interface is immutable,
  * all the properties and functions can only be used to create new instances,
  * they cannot modify the current instance.
- * 
+ *
  * So any instance of this interface is reuseable.
  */
 `;
@@ -1531,12 +1599,12 @@ var TypeHierarchyGraph = class {
 //#endregion
 //#region src/codegen/writers/enum-input-metadata.ts
 var EnumInputMetadataWriter = class EnumInputMetadataWriter extends Writer {
-	constructor(schema, stream, options) {
-		super(stream, options);
+	constructor(schema, stream, options, importSourceMap) {
+		super(stream, options, importSourceMap);
 		this.schema = schema;
 	}
 	prepareImports() {
-		const imports = new JSImportCollector((stmt) => this.importStatement(stmt), CODEGEN_IMPORT_SOURCE_MAP);
+		const imports = new JSImportCollector((stmt) => this.importStatement(stmt), this.importSourceMap);
 		imports.useMapped("EnumInputMetadataBuilder");
 		imports.emit();
 	}
@@ -1607,7 +1675,7 @@ var EnumInputMetadataWriter = class EnumInputMetadataWriter extends Writer {
 
 //#endregion
 //#region \0raw:/home/runner/work/typedgql/typedgql/src/codegen/templates/async-runtime.template
-var async_runtime_default = "import type { Selection } from \"../dist/index.mjs\";\nimport { TextBuilder, runtimeOf } from \"../dist/index.mjs\";\n\nexport type GraphQLExecutor = (\n  request: string,\n  variables: Record<string, unknown>,\n) => Promise<unknown>;\n\nexport type GraphQLSubscriber = (\n  request: string,\n  variables: Record<string, unknown>,\n) => AsyncIterable<unknown> | Promise<AsyncIterable<unknown>>;\n\n// Set global fallback executor used by `execute(...)`.\nexport function setGraphQLExecutor(executor: GraphQLExecutor) {\n  graphQLExecutor = executor;\n}\n\n// Set global fallback subscriber used by `subscribe(...)`.\nexport function setGraphQLSubscriber(subscriber: GraphQLSubscriber) {\n  graphQLSubscriber = subscriber;\n}\nexport type Simplify<T> = SimplifyDepth<T>;\ntype Primitive = string | number | boolean | bigint | symbol | null | undefined;\ntype Dec = [0,0,1,2,3,4,5,6,7,8,9];\ntype GraphQLRawResponse = {\n  readonly data?: unknown;\n  readonly errors?: unknown;\n};\nexport type SimplifyDepth<T, D extends number = 5> =\n  D extends 0 ? T :\n  T extends Primitive | Function ? T :\n  T extends readonly (infer U)[] ? readonly SimplifyDepth<U, Dec[D]>[] :\n  T extends object ? { [K in keyof T]: SimplifyDepth<T[K], Dec[D]> } & {} :\n  T;\n\nexport async function execute<\n  TData extends object,\n  TVariables extends Record<string, unknown>,\n>(\n  selection: Selection<\"Query\" | \"Mutation\", TData, TVariables>,\n  options?: {\n    readonly operationName?: string;\n    readonly variables?: TVariables;\n    readonly executor?: GraphQLExecutor;\n  },\n): Promise<Simplify<TData>> {\n  // Per-call override has priority over the globally registered executor.\n  const executor = options?.executor ?? graphQLExecutor;\n  if (executor === undefined) {\n    throw new Error(\n      \"Executor not set. Call 'setGraphQLExecutor' first or pass executor in options.\",\n    );\n  }\n\n  const request = buildRequest(selection, options?.operationName);\n  const rawResponse = exceptNullValues(\n    await executor(request, options?.variables ?? {}),\n  ) as GraphQLRawResponse;\n  // GraphQL transport errors are surfaced as exceptions.\n  if (rawResponse.errors) {\n    throw new GraphQLError(rawResponse.errors);\n  }\n  return rawResponse.data as unknown as Simplify<TData>;\n}\n\nexport async function* subscribe<\n  TData extends object,\n  TVariables extends Record<string, unknown>,\n>(\n  selection: Selection<\"Subscription\", TData, TVariables>,\n  options?: {\n    readonly operationName?: string;\n    readonly variables?: TVariables;\n    readonly subscriber?: GraphQLSubscriber;\n  },\n): AsyncIterable<Simplify<TData>> {\n  // Per-call override has priority over the globally registered subscriber.\n  const subscriber = options?.subscriber ?? graphQLSubscriber;\n  if (subscriber === undefined) {\n    throw new Error(\n      \"Subscriber not set. Call 'setGraphQLSubscriber' first or pass subscriber in options.\",\n    );\n  }\n\n  const request = buildRequest(selection, options?.operationName);\n  const stream = await subscriber(request, options?.variables ?? {});\n  // Stream payloads follow standard GraphQL response shape.\n  for await (const payload of stream) {\n    const rawResponse = exceptNullValues(payload) as GraphQLRawResponse;\n    if (rawResponse.errors) {\n      throw new GraphQLError(rawResponse.errors);\n    }\n    yield rawResponse.data as unknown as Simplify<TData>;\n  }\n}\n\nexport interface Response<TData> {\n  readonly data?: TData;\n  readonly error?: Error;\n}\n\nexport class GraphQLError extends Error {\n  readonly errors: readonly GraphQLSubError[];\n\n  constructor(errors: unknown) {\n    super();\n    this.errors = normalizeGraphQLErrors(errors);\n  }\n}\n\nexport interface GraphQLSubError {\n  readonly message: string;\n  readonly path: string[];\n}\n\nlet graphQLExecutor: GraphQLExecutor | undefined = undefined;\nlet graphQLSubscriber: GraphQLSubscriber | undefined = undefined;\n\nfunction normalizeGraphQLErrors(errors: unknown): readonly GraphQLSubError[] {\n  if (!Array.isArray(errors)) {\n    return [{ message: \"Unknown GraphQL error\", path: [] }];\n  }\n  return errors.map((item) => {\n    if (!item || typeof item !== \"object\") {\n      return { message: String(item), path: [] };\n    }\n    const rec = item as Record<string, unknown>;\n    return {\n      message: typeof rec.message === \"string\" ? rec.message : \"Unknown GraphQL error\",\n      path: Array.isArray(rec.path)\n        ? rec.path.filter((p): p is string => typeof p === \"string\")\n        : [],\n    };\n  });\n}\n\n// Build GraphQL document from selection tree and inferred variable declarations.\nfunction buildRequest<\n  TData extends object,\n  TVariables extends Record<string, unknown>,\n>(\n  selection: Selection<\"Query\" | \"Mutation\" | \"Subscription\", TData, TVariables>,\n  operationName?: string,\n): string {\n  const runtime = runtimeOf(selection);\n  const writer = new TextBuilder();\n  writer.text(`${runtime.schemaType.name.toLowerCase()} ${operationName ?? runtime.operationName ?? \"\"}`);\n  if (runtime.variableTypeMap.size !== 0) {\n    writer.scope(\n      {\n        type: \"arguments\",\n        multiLines: runtime.variableTypeMap.size > 2,\n        suffix: \" \",\n      },\n      () => {\n        for (const [name, registration] of runtime.variableTypeMap) {\n          writer.separator();\n          writer.text(`$${name}: ${registration.typeName}`);\n        }\n      },\n    );\n  }\n  writer.text(selection.toString());\n  writer.text(selection.toFragmentString());\n  return writer.toString();\n}\n\n// Convert all nullable fields to `undefined` for easier TS optional-field ergonomics.\nfunction exceptNullValues<T>(value: T): T {\n  if (value == null) return undefined as any;\n  if (typeof value !== \"object\") return value;\n  if (Array.isArray(value)) {\n    return value.map((el) => el == null ? undefined : exceptNullValues(el)) as any;\n  }\n  const out: any = {};\n  for (const k in value) {\n    const v = value[k];\n    out[k] = v != null ? exceptNullValues(v) : undefined;\n  }\n  return out;\n}\n";
+var async_runtime_default = "import type { Selection } from \"../dist/index.mjs\";\nimport { TextBuilder, runtimeOf } from \"../dist/index.mjs\";\n\nexport type GraphQLExecutor = (\n  request: string,\n  variables: Record<string, unknown>,\n) => Promise<unknown>;\n\nexport type GraphQLSubscriber = (\n  request: string,\n  variables: Record<string, unknown>,\n) => AsyncIterable<unknown> | Promise<AsyncIterable<unknown>>;\n\n// Set global fallback executor used by `execute(...)`.\nexport function setGraphQLExecutor(executor: GraphQLExecutor) {\n  graphQLExecutor = executor;\n}\n\n// Set global fallback subscriber used by `subscribe(...)`.\nexport function setGraphQLSubscriber(subscriber: GraphQLSubscriber) {\n  graphQLSubscriber = subscriber;\n}\nexport type Simplify<T> = SimplifyDepth<T>;\ntype Primitive = string | number | boolean | bigint | symbol | null | undefined;\ntype Dec = [0,0,1,2,3,4,5,6,7,8,9];\ntype IsEqual<A, B> =\n  (<T>() => T extends A ? 1 : 2) extends\n  (<T>() => T extends B ? 1 : 2)\n    ? (<T>() => T extends B ? 1 : 2) extends\n      (<T>() => T extends A ? 1 : 2)\n      ? true\n      : false\n    : false;\ntype Includes<TItems extends readonly unknown[], TItem> =\n  TItems extends readonly [infer Head, ...infer Tail]\n    ? IsEqual<Head, TItem> extends true\n      ? true\n      : Includes<Tail, TItem>\n    : false;\ntype GraphQLRawResponse = {\n  readonly data?: unknown;\n  readonly errors?: unknown;\n};\nexport type SimplifyDepth<\n  T,\n  D extends number = 5,\n  Seen extends readonly unknown[] = [],\n> =\n  D extends 0 ? T :\n  T extends Primitive | Function ? T :\n  Includes<Seen, T> extends true ? T :\n  T extends readonly (infer U)[] ? readonly SimplifyDepth<U, Dec[D], [...Seen, T]>[] :\n  T extends object ? { [K in keyof T]: SimplifyDepth<T[K], Dec[D], [...Seen, T]> } & {} :\n  T;\n\nexport async function execute<\n  TData extends object,\n  TVariables extends Record<string, unknown>,\n>(\n  selection: Selection<\"Query\" | \"Mutation\", TData, TVariables>,\n  options?: {\n    readonly operationName?: string;\n    readonly variables?: TVariables;\n    readonly executor?: GraphQLExecutor;\n  },\n): Promise<Simplify<TData>> {\n  // Per-call override has priority over the globally registered executor.\n  const executor = options?.executor ?? graphQLExecutor;\n  if (executor === undefined) {\n    throw new Error(\n      \"Executor not set. Call 'setGraphQLExecutor' first or pass executor in options.\",\n    );\n  }\n\n  const request = buildRequest(selection, options?.operationName);\n  const rawResponse = exceptNullValues(\n    await executor(request, options?.variables ?? {}),\n  ) as GraphQLRawResponse;\n  // GraphQL transport errors are surfaced as exceptions.\n  if (rawResponse.errors) {\n    throw new GraphQLError(rawResponse.errors);\n  }\n  return rawResponse.data as unknown as Simplify<TData>;\n}\n\nexport async function* subscribe<\n  TData extends object,\n  TVariables extends Record<string, unknown>,\n>(\n  selection: Selection<\"Subscription\", TData, TVariables>,\n  options?: {\n    readonly operationName?: string;\n    readonly variables?: TVariables;\n    readonly subscriber?: GraphQLSubscriber;\n  },\n): AsyncIterable<Simplify<TData>> {\n  // Per-call override has priority over the globally registered subscriber.\n  const subscriber = options?.subscriber ?? graphQLSubscriber;\n  if (subscriber === undefined) {\n    throw new Error(\n      \"Subscriber not set. Call 'setGraphQLSubscriber' first or pass subscriber in options.\",\n    );\n  }\n\n  const request = buildRequest(selection, options?.operationName);\n  const stream = await subscriber(request, options?.variables ?? {});\n  // Stream payloads follow standard GraphQL response shape.\n  for await (const payload of stream) {\n    const rawResponse = exceptNullValues(payload) as GraphQLRawResponse;\n    if (rawResponse.errors) {\n      throw new GraphQLError(rawResponse.errors);\n    }\n    yield rawResponse.data as unknown as Simplify<TData>;\n  }\n}\n\nexport interface Response<TData> {\n  readonly data?: TData;\n  readonly error?: Error;\n}\n\nexport class GraphQLError extends Error {\n  readonly errors: readonly GraphQLSubError[];\n\n  constructor(errors: unknown) {\n    super();\n    this.errors = normalizeGraphQLErrors(errors);\n  }\n}\n\nexport interface GraphQLSubError {\n  readonly message: string;\n  readonly path: string[];\n}\n\nlet graphQLExecutor: GraphQLExecutor | undefined = undefined;\nlet graphQLSubscriber: GraphQLSubscriber | undefined = undefined;\n\nfunction normalizeGraphQLErrors(errors: unknown): readonly GraphQLSubError[] {\n  if (!Array.isArray(errors)) {\n    return [{ message: \"Unknown GraphQL error\", path: [] }];\n  }\n  return errors.map((item) => {\n    if (!item || typeof item !== \"object\") {\n      return { message: String(item), path: [] };\n    }\n    const rec = item as Record<string, unknown>;\n    return {\n      message: typeof rec.message === \"string\" ? rec.message : \"Unknown GraphQL error\",\n      path: Array.isArray(rec.path)\n        ? rec.path.filter((p): p is string => typeof p === \"string\")\n        : [],\n    };\n  });\n}\n\n// Build GraphQL document from selection tree and inferred variable declarations.\nfunction buildRequest<\n  TData extends object,\n  TVariables extends Record<string, unknown>,\n>(\n  selection: Selection<\"Query\" | \"Mutation\" | \"Subscription\", TData, TVariables>,\n  operationName?: string,\n): string {\n  const runtime = runtimeOf(selection);\n  const writer = new TextBuilder();\n  writer.text(`${runtime.schemaType.name.toLowerCase()} ${operationName ?? runtime.operationName ?? \"\"}`);\n  if (runtime.variableTypeMap.size !== 0) {\n    writer.scope(\n      {\n        type: \"arguments\",\n        multiLines: runtime.variableTypeMap.size > 2,\n        suffix: \" \",\n      },\n      () => {\n        for (const [name, registration] of runtime.variableTypeMap) {\n          writer.separator();\n          writer.text(`$${name}: ${registration.typeName}`);\n        }\n      },\n    );\n  }\n  writer.text(selection.toString());\n  writer.text(selection.toFragmentString());\n  return writer.toString();\n}\n\n// Convert all nullable fields to `undefined` for easier TS optional-field ergonomics.\nfunction exceptNullValues<T>(value: T): T {\n  if (value == null) return undefined as any;\n  if (typeof value !== \"object\") return value;\n  if (Array.isArray(value)) {\n    return value.map((el) => el == null ? undefined : exceptNullValues(el)) as any;\n  }\n  const out: any = {};\n  for (const k in value) {\n    const v = value[k];\n    out[k] = v != null ? exceptNullValues(v) : undefined;\n  }\n  return out;\n}\n";
 
 //#endregion
 //#region src/codegen/scalar-type-declarations.ts
@@ -1638,12 +1706,123 @@ function analyzeScalarTypeDeclarations(source) {
 	return { exportedNames };
 }
 
+//#endregion
+//#region src/codegen/prettier-formatter.ts
+let prettierInstance = void 0;
+let prettierDetected = false;
+/**
+* Detect and dynamically import prettier if available.
+* Returns null if prettier is not installed.
+*/
+async function detectPrettier() {
+	if (prettierDetected) return prettierInstance ?? null;
+	prettierDetected = true;
+	try {
+		prettierInstance = await import("prettier");
+		return prettierInstance;
+	} catch {
+		prettierInstance = null;
+		return null;
+	}
+}
+/**
+* Format TypeScript code using prettier if available.
+* Returns the original code if prettier is not installed or formatting fails.
+*
+* @param code - TypeScript code to format
+* @param filePath - File path for prettier config resolution
+* @returns Formatted code or original code if formatting fails
+*/
+async function formatWithPrettier(code, filePath) {
+	const prettier = await detectPrettier();
+	if (!prettier) return code;
+	try {
+		const config = await prettier.resolveConfig(filePath);
+		return await prettier.format(code, {
+			...config,
+			parser: "typescript",
+			filepath: filePath
+		});
+	} catch (error) {
+		console.warn(`[typedgql] Failed to format ${filePath} with prettier: ${error.message}`);
+		return code;
+	}
+}
+/**
+* Check if prettier is available.
+* This is a lightweight check that doesn't actually import prettier.
+*/
+async function isPrettierAvailable() {
+	return await detectPrettier() !== null;
+}
+
+//#endregion
+//#region src/codegen/buffered-stream.ts
+/**
+* A buffered write stream that collects content in memory
+* instead of writing directly to disk.
+* This allows post-processing (like prettier formatting) before writing.
+*/
+var BufferedStream = class {
+	buffer = [];
+	ended = false;
+	path;
+	constructor(path) {
+		this.path = path;
+	}
+	/**
+	* Write content to the buffer.
+	*/
+	write(chunk) {
+		if (this.ended) throw new Error("Cannot write to ended stream");
+		this.buffer.push(chunk);
+		return true;
+	}
+	/**
+	* Mark the stream as ended.
+	* Returns a promise that resolves when the stream is closed.
+	*/
+	end(callback) {
+		this.ended = true;
+		if (callback) callback();
+		return Promise.resolve();
+	}
+	/**
+	* Get the buffered content as a string.
+	*/
+	getContent() {
+		return this.buffer.join("");
+	}
+	/**
+	* Write the buffered content to disk.
+	*/
+	async flush(formatter) {
+		let content = this.getContent();
+		if (formatter) content = await formatter(content, this.path);
+		await (0, fs_promises.writeFile)(this.path, content, "utf-8");
+	}
+	/**
+	* Create a WriteStream-compatible interface for this buffered stream.
+	* This allows it to be used with existing writer classes.
+	*/
+	toWriteStream() {
+		return {
+			write: (chunk) => this.write(chunk),
+			end: (callback) => {
+				this.end(callback);
+			}
+		};
+	}
+};
+
 //#endregion
 //#region src/codegen/generator.ts
 /** Default output directory: node_modules/@ptdgrp/typedgql/__generated */
 const DEFAULT_TARGET_DIR = (0, path.resolve)(process.cwd(), "node_modules/@ptdgrp/typedgql/__generated");
 /** Parent package dir: node_modules/@ptdgrp/typedgql */
 const PACKAGE_DIR = (0, path.resolve)(process.cwd(), "node_modules/@ptdgrp/typedgql");
+const RUNTIME_PACKAGE_NAME = "@ptdgrp/typedgql/runtime";
+const GENERATED_FILE_BANNER = "/* eslint-disable */\n// This file was generated by @ptdgrp/typedgql. Do not edit it manually.\n\n";
 /** Field names reserved by the runtime SelectionNode implementation. */
 const RESERVED_FIELDS = new Set([
 	"constructor",
@@ -1663,6 +1842,9 @@ const RESERVED_FIELDS = new Set([
 	"toFragmentString"
 ]);
 var Generator = class {
+	usePrettier = false;
+	isCustomOutputDir = false;
+	bufferedStreams = [];
 	constructor(options) {
 		this.options = options;
 	}
@@ -1670,6 +1852,62 @@ var Generator = class {
 	get targetDir() {
 		return this.options.targetDir ?? DEFAULT_TARGET_DIR;
 	}
+	/**
+	* Check if we should use prettier formatting.
+	* Only enabled when using custom outputDir (not in node_modules).
+	*/
+	async initializePrettier() {
+		const targetDir = this.targetDir;
+		this.isCustomOutputDir = !(0, path.normalize)(targetDir).includes("node_modules");
+		if (this.options.prettier === false) {
+			this.usePrettier = false;
+			return;
+		}
+		if (this.options.prettier === true || this.isCustomOutputDir) {
+			this.usePrettier = await isPrettierAvailable();
+			if (this.usePrettier) console.log("[typedgql] Prettier detected, will format generated files");
+		}
+	}
+	/**
+	* Create a stream for writing generated code.
+	* Uses BufferedStream when prettier formatting is enabled.
+	*/
+	createCodeStream(path$1) {
+		const writeBanner = (stream) => {
+			stream.write(GENERATED_FILE_BANNER);
+			return stream;
+		};
+		if (this.usePrettier) {
+			const buffered = new BufferedStream(path$1);
+			this.bufferedStreams.push(buffered);
+			return writeBanner(buffered.toWriteStream());
+		}
+		return writeBanner((0, fs.createWriteStream)(path$1));
+	}
+	get rootRuntimeImportSource() {
+		return this.usesPackageInternalRuntimeImports ? "../dist/index.mjs" : RUNTIME_PACKAGE_NAME;
+	}
+	get nestedRuntimeImportSource() {
+		return this.usesPackageInternalRuntimeImports ? "../../dist/index.mjs" : RUNTIME_PACKAGE_NAME;
+	}
+	get usesPackageInternalRuntimeImports() {
+		return (0, path.normalize)(this.targetDir) === (0, path.normalize)(DEFAULT_TARGET_DIR);
+	}
+	get generatedImportSourceMap() {
+		return createCodegenImportSourceMap({
+			runtimeEntrySource: this.nestedRuntimeImportSource,
+			rootRuntimeEntrySource: this.rootRuntimeImportSource
+		});
+	}
+	/**
+	* Flush all buffered streams with prettier formatting.
+	*/
+	async flushBufferedStreams() {
+		if (this.bufferedStreams.length === 0) return;
+		console.log(`[typedgql] Formatting ${this.bufferedStreams.length} files with prettier...`);
+		await Promise.all(this.bufferedStreams.map((stream) => stream.flush(this.usePrettier ? formatWithPrettier : void 0)));
+		this.bufferedStreams = [];
+	}
 	async generate() {
 		const schema = await this.options.schemaLoader();
 		this.validateSchema(schema);
@@ -1679,6 +1917,7 @@ var Generator = class {
 			force: true
 		});
 		await (0, fs_promises.mkdir)(this.targetDir, { recursive: true });
+		await this.initializePrettier();
 		const typeHierarchy = new TypeHierarchyGraph(schema);
 		const selectionTypes = [];
 		const inputTypes = [];
@@ -1756,10 +1995,11 @@ var Generator = class {
 		if (this.hasScalarTypes()) promises.push(this.generateScalarTypes());
 		promises.push(this.writeIndex(schema, ctx));
 		await Promise.all(promises);
+		await this.flushBufferedStreams();
 		if (this.options.targetDir === void 0) await this.writePackageEntrypoint(schema, ctx);
 	}
 	createSelectionWriter(modelType, ctx, stream, options) {
-		return new SelectionWriter(modelType, ctx, stream, options);
+		return new SelectionWriter(modelType, ctx, stream, options, this.generatedImportSourceMap);
 	}
 	additionalExportedTypeNamesForSelection(_modelType, _ctx) {
 		return [];
@@ -1770,7 +2010,8 @@ var Generator = class {
 		const defaultSelectionNameMap = /* @__PURE__ */ new Map();
 		const suffix = this.options?.selectionSuffix ?? "Selection";
 		const promises = ctx.selectionTypes.map(async (type) => {
-			const stream = createStream((0, path.join)(dir, `${toKebabCase(`${type.name}${suffix}`)}.ts`));
+			const selectionTypeName = `${type.name}${suffix}`;
+			const stream = this.createCodeStream((0, path.join)(dir, `${toKebabCase(selectionTypeName)}.ts`));
 			const writer = this.createSelectionWriter(type, ctx, stream, this.options);
 			emptySelectionNameMap.set(type, writer.emptySelectionName);
 			if (writer.defaultSelectionName !== void 0) defaultSelectionNameMap.set(type, writer.defaultSelectionName);
@@ -1778,7 +2019,7 @@ var Generator = class {
 			await endStream(stream);
 		});
 		await Promise.all([...promises, (async () => {
-			const stream = createStream((0, path.join)(dir, "index.ts"));
+			const stream = this.createCodeStream((0, path.join)(dir, "index.ts"));
 			for (const type of ctx.selectionTypes) {
 				const selectionTypeName = `${type.name}${suffix}`;
 				const selectionFileName = toKebabCase(selectionTypeName);
@@ -1798,7 +2039,7 @@ var Generator = class {
 	async generateInputTypes(inputTypes) {
 		const dir = (0, path.join)(this.targetDir, "inputs");
 		const promises = inputTypes.map(async (type) => {
-			const stream = createStream((0, path.join)(dir, `${toKebabCase(type.name)}.ts`));
+			const stream = this.createCodeStream((0, path.join)(dir, `${toKebabCase(type.name)}.ts`));
 			new InputWriter(type, stream, this.options).write();
 			await stream.end();
 		});
@@ -1807,35 +2048,35 @@ var Generator = class {
 	async generateEnumTypes(enumTypes) {
 		const dir = (0, path.join)(this.targetDir, "enums");
 		const promises = enumTypes.map(async (type) => {
-			const stream = createStream((0, path.join)(dir, `${toKebabCase(type.name)}.ts`));
+			const stream = this.createCodeStream((0, path.join)(dir, `${toKebabCase(type.name)}.ts`));
 			new EnumWriter(type, stream, this.options).write();
 			await stream.end();
 		});
 		await Promise.all([...promises, this.writeSimpleIndex(dir, enumTypes, true)]);
 	}
 	async generateTypeHierarchy(schema, typeHierarchy) {
-		const stream = createStream((0, path.join)(this.targetDir, "type-hierarchy.ts"));
+		const stream = this.createCodeStream((0, path.join)(this.targetDir, "type-hierarchy.ts"));
 		new TypeHierarchyWriter(schema, typeHierarchy, stream, this.options).write();
 		await endStream(stream);
 	}
 	async generateEnumInputMetadata(schema) {
-		const stream = createStream((0, path.join)(this.targetDir, "enum-input-metadata.ts"));
-		new EnumInputMetadataWriter(schema, stream, this.options).write();
+		const stream = this.createCodeStream((0, path.join)(this.targetDir, "enum-input-metadata.ts"));
+		new EnumInputMetadataWriter(schema, stream, this.options, this.generatedImportSourceMap).write();
 		await endStream(stream);
 	}
 	async writeSimpleIndex(dir, types, typeOnly = true) {
-		const stream = createStream((0, path.join)(dir, "index.ts"));
+		const stream = this.createCodeStream((0, path.join)(dir, "index.ts"));
 		const keyword = typeOnly ? "export type" : "export";
 		for (const type of types) stream.write(`${keyword} {${type.name}} from './${toKebabCase(type.name)}';\n`);
 		await stream.end();
 	}
 	async generateAsyncRuntime() {
-		const stream = createStream((0, path.join)(this.targetDir, "client-runtime.ts"));
-		stream.write(async_runtime_default);
+		const stream = this.createCodeStream((0, path.join)(this.targetDir, "client-runtime.ts"));
+		stream.write(async_runtime_default.replaceAll("../dist/index.mjs", this.rootRuntimeImportSource));
 		await endStream(stream);
 	}
 	async generateScalarTypes() {
-		const stream = createStream((0, path.join)(this.targetDir, "scalar-types.ts"));
+		const stream = this.createCodeStream((0, path.join)(this.targetDir, "scalar-types.ts"));
 		const analysis = analyzeScalarTypeDeclarations(this.options.scalarTypeDeclarations);
 		const code = this.options.scalarTypeDeclarations?.trim();
 		if (code && code.length !== 0) {
@@ -1864,10 +2105,10 @@ var Generator = class {
 		}
 	}
 	async writeIndex(schema, ctx) {
-		const stream = createStream((0, path.join)(this.targetDir, "index.ts"));
+		const stream = this.createCodeStream((0, path.join)(this.targetDir, "index.ts"));
 		const selectionSuffix = this.options.selectionSuffix ?? "Selection";
-		stream.write(`import type { Selection, ExecutableSelection, SchemaType, ShapeOf, VariablesOf } from "../dist/index.mjs";\n`);
-		stream.write(`import { FragmentRef, createSelection, resolveRegisteredSchemaType } from "../dist/index.mjs";\n`);
+		stream.write(`import type { Selection, ExecutableSelection, SchemaType, ShapeOf, VariablesOf } from "${this.rootRuntimeImportSource}";\n`);
+		stream.write(`import { FragmentRef, createSelection, resolveRegisteredSchemaType } from "${this.rootRuntimeImportSource}";\n`);
 		for (const type of ctx.selectionTypes) {
 			const selectionTypeName = `${type.name}${selectionSuffix}`;
 			stream.write(`import type { ${selectionTypeName} } from "./selections/${toKebabCase(selectionTypeName)}";\n`);
@@ -1916,6 +2157,7 @@ var Generator = class {
 	async writePackageEntrypoint(schema, ctx) {
 		await (0, fs_promises.mkdir)(PACKAGE_DIR, { recursive: true });
 		const indexStream = createStream((0, path.join)(PACKAGE_DIR, "index.ts"));
+		indexStream.write(GENERATED_FILE_BANNER);
 		this.writePackageIndexCode(indexStream, schema, ctx);
 		await endStream(indexStream);
 		await this.patchPackageJsonForGeneratedEntrypoint();
@@ -2023,8 +2265,8 @@ var Generator = class {
 		return (this.options.scalarTypeDeclarations?.trim().length ?? 0) !== 0 || Object.keys(this.options.scalarTypeMap ?? {}).length !== 0;
 	}
 };
-function createStream(path$1) {
-	return (0, fs.createWriteStream)(path$1);
+function createStream(path$2) {
+	return (0, fs.createWriteStream)(path$2);
 }
 function endStream(stream) {
 	return new Promise((resolve, reject) => {
@@ -2053,6 +2295,59 @@ async function loadLocalSchema(location) {
 	return (0, graphql.buildSchema)(await (0, fs_promises.readFile)(location, { encoding: "utf8" }));
 }
 
+//#endregion
+//#region src/codegen/config-loader.ts
+/**
+* Validate that the output directory is not inside node_modules.
+* @throws Error if the path is inside node_modules
+*/
+function validateOutputDir(outputDir) {
+	if ((0, node_path.normalize)(outputDir).includes("node_modules")) throw new Error(`Invalid outputDir: "${outputDir}". Output directory cannot be inside node_modules. Please specify a path outside node_modules, such as './src/__generated' or './__generated'.`);
+}
+/**
+* Load configuration from .typedgqlrc.toml file.
+*
+* @param configPath - Path to the config file (defaults to .typedgqlrc.toml in cwd)
+* @returns Parsed configuration object or undefined if file doesn't exist
+*/
+async function loadConfig(configPath) {
+	const path = configPath ?? (0, node_path.resolve)(process.cwd(), ".typedgqlrc.toml");
+	try {
+		const config = (0, smol_toml.parse)(await (0, node_fs_promises.readFile)(path, "utf-8"));
+		if (config.outputDir && !config.targetDir) config.targetDir = config.outputDir;
+		const outputPath = config.outputDir || config.targetDir;
+		if (outputPath) validateOutputDir(outputPath);
+		return config;
+	} catch (error) {
+		if (error.code === "ENOENT") return;
+		throw new Error(`Failed to load config from ${path}: ${error.message}`);
+	}
+}
+/**
+* Merge configuration from file with programmatic options.
+* Programmatic options take precedence over file config.
+*
+* @param fileConfig - Configuration loaded from .typedgqlrc.toml
+* @param programmaticConfig - Configuration passed programmatically
+* @returns Merged configuration
+*/
+function mergeConfig(fileConfig, programmaticConfig) {
+	let merged;
+	if (!fileConfig) merged = programmaticConfig;
+	else merged = {
+		...fileConfig,
+		...programmaticConfig,
+		schemaHeaders: {
+			...fileConfig.schemaHeaders,
+			...programmaticConfig.schemaHeaders
+		}
+	};
+	if (merged.outputDir && !merged.targetDir) merged.targetDir = merged.outputDir;
+	const outputPath = merged.outputDir || merged.targetDir;
+	if (outputPath) validateOutputDir(outputPath);
+	return merged;
+}
+
 //#endregion
 Object.defineProperty(exports, 'Generator', {
   enumerable: true,
@@ -2066,6 +2361,12 @@ Object.defineProperty(exports, '__toESM', {
     return __toESM;
   }
 });
+Object.defineProperty(exports, 'loadConfig', {
+  enumerable: true,
+  get: function () {
+    return loadConfig;
+  }
+});
 Object.defineProperty(exports, 'loadLocalSchema', {
   enumerable: true,
   get: function () {
@@ -2077,4 +2378,10 @@ Object.defineProperty(exports, 'loadRemoteSchema', {
   get: function () {
     return loadRemoteSchema;
   }
+});
+Object.defineProperty(exports, 'mergeConfig', {
+  enumerable: true,
+  get: function () {
+    return mergeConfig;
+  }
 });