@ptdgrp/typedgql 1.0.0-beta.13 → 1.0.0-beta.14

package/dist/node.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_schema_loader = require('./schema-loader-DxKAN2ER.cjs');
+const require_schema_loader = require('./schema-loader-DO6j6Gbm.cjs');
 
 exports.Generator = require_schema_loader.Generator;
 exports.loadLocalSchema = require_schema_loader.loadLocalSchema;

package/dist/node.d.cts

@@ -1,4 +1,4 @@
-import { t as CodegenOptions } from "./options-CaWo97vV.cjs";
+import { t as CodegenOptions } from "./options-CgrZ2der.cjs";
 import { GraphQLSchema } from "graphql";
 
 //#region src/codegen/generator.d.ts
@@ -17,6 +17,8 @@ declare class Generator {
   private generateEnumInputMetadata;
   private writeSimpleIndex;
   private generateAsyncRuntime;
+  private generateScalarTypes;
+  private writeScalarMapAliases;
   private writeIndex;
   /**
    * Creates node_modules/@ptdgrp/typedgql/index.ts
@@ -29,6 +31,8 @@ declare class Generator {
   private hasGeneratedEnums;
   private hasGeneratedInputs;
   private validateSchema;
+  private validateScalarTypeDeclarations;
+  private hasScalarTypes;
 }
 //#endregion
 //#region src/codegen/schema-loader.d.ts

package/dist/node.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.cts","names":[],"sources":["../src/codegen/generator.ts","../src/codegen/schema-loader.ts"],"mappings":";;;;cAsDa,SAAA;EAAA,UACW,OAAA,EAAS,cAAA;cAAT,OAAA,EAAS,cAAA;EADX;EAAA,YAIR,SAAA,CAAA;EAIN,QAAA,CAAA,GAAQ,OAAA;EAAA,QA8IN,qBAAA;EAAA,QASA,uCAAA;EAAA,QAOM,sBAAA;EAAA,QAmEA,kBAAA;EAAA,QAUA,iBAAA;EAAA,QAaA,qBAAA;EAAA,QAcA,yBAAA;EAAA,QAMA,gBAAA;EAAA,QAeA,oBAAA;EAAA,QAMA,UAAA;EAjSR;;;;;EAAA,QAmXQ,sBAAA;EAAA,QAaA,sCAAA;EAAA,QAuCN,qBAAA;EAAA,QA2EA,iBAAA;EAAA,QAeA,kBAAA;EAAA,QAiBA,cAAA;AAAA;;;iBC5kBY,gBAAA,CACpB,QAAA,UACA,OAAA;EAAA,CAAa,GAAA;AAAA,IACZ,OAAA,CAAQ,aAAA;AAAA,iBAuBW,eAAA,CACpB,QAAA,WACC,OAAA,CAAQ,aAAA"}
+{"version":3,"file":"node.d.cts","names":[],"sources":["../src/codegen/generator.ts","../src/codegen/schema-loader.ts"],"mappings":";;;;cAwDa,SAAA;EAAA,UACW,OAAA,EAAS,cAAA;cAAT,OAAA,EAAS,cAAA;EADX;EAAA,YAIR,SAAA,CAAA;EAIN,QAAA,CAAA,GAAQ,OAAA;EAAA,QAkJN,qBAAA;EAAA,QASA,uCAAA;EAAA,QAOM,sBAAA;EAAA,QAmEA,kBAAA;EAAA,QAUA,iBAAA;EAAA,QAaA,qBAAA;EAAA,QAcA,yBAAA;EAAA,QAMA,gBAAA;EAAA,QAeA,oBAAA;EAAA,QAMA,mBAAA;EAAA,QA4BN,qBAAA;EAAA,QAeM,UAAA;EA9LN;;;;;EAAA,QAqRM,sBAAA;EAAA,QAaA,sCAAA;EAAA,QAuCN,qBAAA;EAAA,QAgFA,iBAAA;EAAA,QAeA,kBAAA;EAAA,QAiBA,cAAA;EAAA,QAqFA,8BAAA;EAAA,QAWA,cAAA;AAAA;;;iBCvuBY,gBAAA,CACpB,QAAA,UACA,OAAA;EAAA,CAAa,GAAA;AAAA,IACZ,OAAA,CAAQ,aAAA;AAAA,iBAuBW,eAAA,CACpB,QAAA,WACC,OAAA,CAAQ,aAAA"}

package/dist/node.d.mts

@@ -1,4 +1,4 @@
-import { t as CodegenOptions } from "./options-D2L-tv7C.mjs";
+import { t as CodegenOptions } from "./options-BWcHrC-1.mjs";
 import { GraphQLSchema } from "graphql";
 
 //#region src/codegen/generator.d.ts
@@ -17,6 +17,8 @@ declare class Generator {
   private generateEnumInputMetadata;
   private writeSimpleIndex;
   private generateAsyncRuntime;
+  private generateScalarTypes;
+  private writeScalarMapAliases;
   private writeIndex;
   /**
    * Creates node_modules/@ptdgrp/typedgql/index.ts
@@ -29,6 +31,8 @@ declare class Generator {
   private hasGeneratedEnums;
   private hasGeneratedInputs;
   private validateSchema;
+  private validateScalarTypeDeclarations;
+  private hasScalarTypes;
 }
 //#endregion
 //#region src/codegen/schema-loader.d.ts

package/dist/node.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.mts","names":[],"sources":["../src/codegen/generator.ts","../src/codegen/schema-loader.ts"],"mappings":";;;;cAsDa,SAAA;EAAA,UACW,OAAA,EAAS,cAAA;cAAT,OAAA,EAAS,cAAA;EADX;EAAA,YAIR,SAAA,CAAA;EAIN,QAAA,CAAA,GAAQ,OAAA;EAAA,QA8IN,qBAAA;EAAA,QASA,uCAAA;EAAA,QAOM,sBAAA;EAAA,QAmEA,kBAAA;EAAA,QAUA,iBAAA;EAAA,QAaA,qBAAA;EAAA,QAcA,yBAAA;EAAA,QAMA,gBAAA;EAAA,QAeA,oBAAA;EAAA,QAMA,UAAA;EAjSR;;;;;EAAA,QAmXQ,sBAAA;EAAA,QAaA,sCAAA;EAAA,QAuCN,qBAAA;EAAA,QA2EA,iBAAA;EAAA,QAeA,kBAAA;EAAA,QAiBA,cAAA;AAAA;;;iBC5kBY,gBAAA,CACpB,QAAA,UACA,OAAA;EAAA,CAAa,GAAA;AAAA,IACZ,OAAA,CAAQ,aAAA;AAAA,iBAuBW,eAAA,CACpB,QAAA,WACC,OAAA,CAAQ,aAAA"}
+{"version":3,"file":"node.d.mts","names":[],"sources":["../src/codegen/generator.ts","../src/codegen/schema-loader.ts"],"mappings":";;;;cAwDa,SAAA;EAAA,UACW,OAAA,EAAS,cAAA;cAAT,OAAA,EAAS,cAAA;EADX;EAAA,YAIR,SAAA,CAAA;EAIN,QAAA,CAAA,GAAQ,OAAA;EAAA,QAkJN,qBAAA;EAAA,QASA,uCAAA;EAAA,QAOM,sBAAA;EAAA,QAmEA,kBAAA;EAAA,QAUA,iBAAA;EAAA,QAaA,qBAAA;EAAA,QAcA,yBAAA;EAAA,QAMA,gBAAA;EAAA,QAeA,oBAAA;EAAA,QAMA,mBAAA;EAAA,QA4BN,qBAAA;EAAA,QAeM,UAAA;EA9LN;;;;;EAAA,QAqRM,sBAAA;EAAA,QAaA,sCAAA;EAAA,QAuCN,qBAAA;EAAA,QAgFA,iBAAA;EAAA,QAeA,kBAAA;EAAA,QAiBA,cAAA;EAAA,QAqFA,8BAAA;EAAA,QAWA,cAAA;AAAA;;;iBCvuBY,gBAAA,CACpB,QAAA,UACA,OAAA;EAAA,CAAa,GAAA;AAAA,IACZ,OAAA,CAAQ,aAAA;AAAA,iBAuBW,eAAA,CACpB,QAAA,WACC,OAAA,CAAQ,aAAA"}

package/dist/node.mjs

@@ -1,3 +1,3 @@
-import { n as loadRemoteSchema, r as Generator, t as loadLocalSchema } from "./schema-loader-CB4j3yYF.mjs";
+import { n as loadRemoteSchema, r as Generator, t as loadLocalSchema } from "./schema-loader-dqwha5aR.mjs";
 
 export { Generator, loadLocalSchema, loadRemoteSchema };

package/dist/{options-CaWo97vV.d.cts → options-BWcHrC-1.d.mts}

@@ -56,18 +56,24 @@ interface CodegenOptions {
   /**
    * Scalar type mapping for generated TypeScript types.
    *
-   * - String form: directly uses the provided TS type name.
-   * - Object form: uses `typeName` and emits an import from `importSource`.
+   * Each mapped scalar is exposed as `UserScalarTypes.<ScalarName>` in generated
+   * files, and codegen emits `export type <ScalarName> = <mappedType>` inside
+   * generated `scalar-types.ts`.
    *
    * Example:
-   * `DateTime: { typeName: "DateTimeISO", importSource: "types/scalars" }`
+   * `{ JSON: "JsonObject", DateTime: "string" }`
    */
   readonly scalarTypeMap?: {
-    readonly [key: string]: string | {
-      readonly typeName: string;
-      readonly importSource: string;
-    };
+    readonly [key: string]: string;
   };
+  /**
+   * TypeScript declaration source emitted into generated `scalar-types.ts` namespace.
+   *
+   * Only `type/interface` declarations are allowed.
+   * Exported declarations are visible for consumers, and non-exported ones can
+   * be used as private helper types inside the namespace.
+   */
+  readonly scalarTypeDeclarations?: string;
   /**
    * Override ID field name per GraphQL object/interface type.
    *
@@ -96,4 +102,4 @@ interface CodegenOptions {
 }
 //#endregion
 export { CodegenOptions as t };
-//# sourceMappingURL=options-CaWo97vV.d.cts.map
+//# sourceMappingURL=options-BWcHrC-1.d.mts.map

package/dist/options-BWcHrC-1.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-BWcHrC-1.d.mts","names":[],"sources":["../src/codegen/options.ts"],"mappings":";;;;;AAQA;;;;UAAiB,cAAA;EA6CU;;;;;;EAAA,SAtChB,YAAA,QAAoB,OAAA,CAAQ,aAAA;EAY5B;;;;;EAAA,SANA,SAAA;EA2CA;;;;;EAAA,SArCA,MAAA;EA2DyC;;;;;;EAAA,SApDzC,cAAA;;;;;;;WAOA,aAAA;;;;;;;;WAQA,eAAA;;;;WAIA,aAAA,GAAgB,aAAA;;;;;;;;;;;WAWhB,aAAA;IAAA,UACG,GAAA;EAAA;;;;;;;;WASH,sBAAA;;;;;;WAMA,UAAA;IAAA,UAAyB,GAAA;EAAA;;;;;;WAMzB,0BAAA;IAAA,UAAyC,GAAA;EAAA;;;;;;;;;WASzC,MAAA;AAAA"}

package/dist/{options-D2L-tv7C.d.mts → options-CgrZ2der.d.cts}

@@ -56,18 +56,24 @@ interface CodegenOptions {
   /**
    * Scalar type mapping for generated TypeScript types.
    *
-   * - String form: directly uses the provided TS type name.
-   * - Object form: uses `typeName` and emits an import from `importSource`.
+   * Each mapped scalar is exposed as `UserScalarTypes.<ScalarName>` in generated
+   * files, and codegen emits `export type <ScalarName> = <mappedType>` inside
+   * generated `scalar-types.ts`.
    *
    * Example:
-   * `DateTime: { typeName: "DateTimeISO", importSource: "types/scalars" }`
+   * `{ JSON: "JsonObject", DateTime: "string" }`
    */
   readonly scalarTypeMap?: {
-    readonly [key: string]: string | {
-      readonly typeName: string;
-      readonly importSource: string;
-    };
+    readonly [key: string]: string;
   };
+  /**
+   * TypeScript declaration source emitted into generated `scalar-types.ts` namespace.
+   *
+   * Only `type/interface` declarations are allowed.
+   * Exported declarations are visible for consumers, and non-exported ones can
+   * be used as private helper types inside the namespace.
+   */
+  readonly scalarTypeDeclarations?: string;
   /**
    * Override ID field name per GraphQL object/interface type.
    *
@@ -96,4 +102,4 @@ interface CodegenOptions {
 }
 //#endregion
 export { CodegenOptions as t };
-//# sourceMappingURL=options-D2L-tv7C.d.mts.map
+//# sourceMappingURL=options-CgrZ2der.d.cts.map

package/dist/options-CgrZ2der.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-CgrZ2der.d.cts","names":[],"sources":["../src/codegen/options.ts"],"mappings":";;;;;AAQA;;;;UAAiB,cAAA;EA6CU;;;;;;EAAA,SAtChB,YAAA,QAAoB,OAAA,CAAQ,aAAA;EAY5B;;;;;EAAA,SANA,SAAA;EA2CA;;;;;EAAA,SArCA,MAAA;EA2DyC;;;;;;EAAA,SApDzC,cAAA;;;;;;;WAOA,aAAA;;;;;;;;WAQA,eAAA;;;;WAIA,aAAA,GAAgB,aAAA;;;;;;;;;;;WAWhB,aAAA;IAAA,UACG,GAAA;EAAA;;;;;;;;WASH,sBAAA;;;;;;WAMA,UAAA;IAAA,UAAyB,GAAA;EAAA;;;;;;WAMzB,0BAAA;IAAA,UAAyC,GAAA;EAAA;;;;;;;;;WASzC,MAAA;AAAA"}

package/dist/{schema-loader-DxKAN2ER.cjs → schema-loader-DO6j6Gbm.cjs}

@@ -1,7 +1,36 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
 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);
 
 //#region src/codegen/utils.ts
 /**
@@ -36,6 +65,132 @@ function toKebabCase(name) {
 	return name.replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2").replace(/([a-z\d])([A-Z])/g, "$1-$2").toLowerCase();
 }
 
+//#endregion
+//#region src/codegen/imports.ts
+/**
+* Shared import collector for codegen writers.
+*
+* Responsibilities:
+* - normalize imports by source
+* - deduplicate symbols
+* - keep emitted import statements stable (sorted)
+*/
+var JSImportCollector = class {
+	typeBySource = /* @__PURE__ */ new Map();
+	valueBySource = /* @__PURE__ */ new Map();
+	sideEffects = /* @__PURE__ */ new Set();
+	constructor(sink, sourceMap) {
+		this.sink = sink;
+		this.sourceMap = sourceMap;
+	}
+	useMapped(symbol) {
+		const spec = this.sourceMap[symbol];
+		if (spec.kind === "type") this.useType(spec.source, symbol);
+		else this.useValue(spec.source, symbol);
+	}
+	useType(source, symbol) {
+		this.collect(this.typeBySource, source, symbol);
+	}
+	useValue(source, symbol) {
+		this.collect(this.valueBySource, source, symbol);
+	}
+	useSideEffect(source) {
+		this.sideEffects.add(source);
+	}
+	emit() {
+		for (const [source, symbols] of this.sorted(this.typeBySource)) this.sink(`import type { ${Array.from(symbols).sort().join(", ")} } from '${source}';`);
+		for (const [source, symbols] of this.sorted(this.valueBySource)) this.sink(`import { ${Array.from(symbols).sort().join(", ")} } from '${source}';`);
+		for (const source of Array.from(this.sideEffects).sort()) this.sink(`import '${source}';`);
+	}
+	collect(map, source, symbol) {
+		const set = map.get(source) ?? /* @__PURE__ */ new Set();
+		set.add(symbol);
+		map.set(source, set);
+	}
+	sorted(map) {
+		return Array.from(map.entries()).sort((a, b) => a[0].localeCompare(b[0]));
+	}
+};
+const 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,
+		kind: "type"
+	},
+	UnresolvedVariables: {
+		source: RUNTIME_ENTRY_SOURCE,
+		kind: "type"
+	},
+	DirectiveArgs: {
+		source: RUNTIME_ENTRY_SOURCE,
+		kind: "type"
+	},
+	Selection: {
+		source: RUNTIME_ENTRY_SOURCE,
+		kind: "type"
+	},
+	ShapeOf: {
+		source: RUNTIME_ENTRY_SOURCE,
+		kind: "type"
+	},
+	VariablesOf: {
+		source: RUNTIME_ENTRY_SOURCE,
+		kind: "type"
+	},
+	ValueOrThunk: {
+		source: RUNTIME_ENTRY_SOURCE,
+		kind: "type"
+	},
+	FragmentSpread: {
+		source: RUNTIME_ENTRY_SOURCE,
+		kind: "type"
+	},
+	createSelection: {
+		source: RUNTIME_ENTRY_SOURCE,
+		kind: "value"
+	},
+	withOperationName: {
+		source: RUNTIME_ENTRY_SOURCE,
+		kind: "value"
+	},
+	createSchemaType: {
+		source: RUNTIME_ENTRY_SOURCE,
+		kind: "value"
+	},
+	registerSchemaTypeFactory: {
+		source: RUNTIME_ENTRY_SOURCE,
+		kind: "value"
+	},
+	resolveRegisteredSchemaType: {
+		source: RUNTIME_ENTRY_SOURCE,
+		kind: "value"
+	},
+	ENUM_INPUT_METADATA: {
+		source: ENUM_INPUT_METADATA_SOURCE,
+		kind: "value"
+	},
+	SCALAR_TYPE_NAMESPACE: {
+		source: SCALAR_TYPES_SOURCE,
+		kind: "type"
+	},
+	WithTypeName: {
+		source: TYPE_HIERARCHY_SOURCE,
+		kind: "type"
+	},
+	ImplementationType: {
+		source: TYPE_HIERARCHY_SOURCE,
+		kind: "type"
+	},
+	EnumInputMetadataBuilder: {
+		source: "../dist/index.mjs",
+		kind: "value"
+	}
+};
+
 //#endregion
 //#region src/codegen/writer.ts
 const SCOPE_BRACKETS = {
@@ -74,7 +229,7 @@ var Writer = class {
 	needIndent = false;
 	importStatements = /* @__PURE__ */ new Set();
 	importedTypes = /* @__PURE__ */ new Set();
-	importedScalarTypes = /* @__PURE__ */ new Map();
+	usesScalarTypeNamespaceImport = false;
 	importFinalized = false;
 	constructor(stream, options) {
 		this.stream = stream;
@@ -117,11 +272,7 @@ var Writer = class {
 			return;
 		}
 		if (namedType instanceof graphql.GraphQLScalarType && this.options.scalarTypeMap) {
-			const mapped = this.options.scalarTypeMap[namedType.name];
-			if (typeof mapped !== "object") return;
-			const set = this.importedScalarTypes.get(mapped.importSource) ?? /* @__PURE__ */ new Set();
-			set.add(mapped.typeName);
-			this.importedScalarTypes.set(mapped.importSource, set);
+			if (this.options.scalarTypeMap[namedType.name]) this.usesScalarTypeNamespaceImport = true;
 		}
 	}
 	importStatement(statement) {
@@ -209,9 +360,13 @@ var Writer = class {
 			return;
 		}
 		if (type instanceof graphql.GraphQLScalarType) {
-			const mapped = this.options.scalarTypeMap?.[type.name] ?? SCALAR_MAP[type.name];
-			if (!mapped) throw new Error(`Unknown scalar type ${type.name}`);
-			this.text(typeof mapped === "string" ? mapped : mapped.typeName);
+			if (this.options.scalarTypeMap?.[type.name]) {
+				this.text(`${SCALAR_TYPES_NAMESPACE}.${type.name}`);
+				return;
+			}
+			const fallback = SCALAR_MAP[type.name];
+			if (!fallback) throw new Error(`Unknown scalar type ${type.name}`);
+			this.text(fallback);
 			return;
 		}
 		if (type instanceof graphql.GraphQLEnumType || type instanceof graphql.GraphQLInputObjectType) {
@@ -259,10 +414,10 @@ var Writer = class {
 		}
 	}
 	writeMappedScalarImports() {
-		if (this.importedScalarTypes.size === 0) return;
-		const sourcePrefix = this.isUnderGlobalDir() ? "../" : "../../";
-		const sortedEntries = Array.from(this.importedScalarTypes.entries()).sort((a, b) => a[0].localeCompare(b[0]));
-		for (const [importSource, typeNames] of sortedEntries) this.stream.write(`import type { ${Array.from(typeNames).sort().join(", ")} } from '${sourcePrefix}${importSource}';\n`);
+		if (!this.usesScalarTypeNamespaceImport) return;
+		const source = CODEGEN_IMPORT_SOURCE_MAP.SCALAR_TYPE_NAMESPACE.source;
+		const importSource = this.isUnderGlobalDir() ? source.replace(/^\.\.\//, "./") : source;
+		this.stream.write(`import type { ${SCALAR_TYPES_NAMESPACE} } from '${importSource}';\n`);
 	}
 	typeApplication(typeName, renderTypeArg) {
 		this.text(`${typeName}<`);
@@ -307,7 +462,7 @@ var Writer = class {
 		});
 	}
 	get hasAnyImports() {
-		return this.importStatements.size !== 0 || this.importedTypes.size !== 0 || this.importedScalarTypes.size !== 0;
+		return this.importStatements.size !== 0 || this.importedTypes.size !== 0 || this.usesScalarTypeNamespaceImport;
 	}
 	writeUnion(members) {
 		this.enter("blank");
@@ -329,126 +484,6 @@ function unwrapType(type) {
 	return type;
 }
 
-//#endregion
-//#region src/codegen/imports.ts
-/**
-* Shared import collector for codegen writers.
-*
-* Responsibilities:
-* - normalize imports by source
-* - deduplicate symbols
-* - keep emitted import statements stable (sorted)
-*/
-var JSImportCollector = class {
-	typeBySource = /* @__PURE__ */ new Map();
-	valueBySource = /* @__PURE__ */ new Map();
-	sideEffects = /* @__PURE__ */ new Set();
-	constructor(sink, sourceMap) {
-		this.sink = sink;
-		this.sourceMap = sourceMap;
-	}
-	useMapped(symbol) {
-		const spec = this.sourceMap[symbol];
-		if (spec.kind === "type") this.useType(spec.source, symbol);
-		else this.useValue(spec.source, symbol);
-	}
-	useType(source, symbol) {
-		this.collect(this.typeBySource, source, symbol);
-	}
-	useValue(source, symbol) {
-		this.collect(this.valueBySource, source, symbol);
-	}
-	useSideEffect(source) {
-		this.sideEffects.add(source);
-	}
-	emit() {
-		for (const [source, symbols] of this.sorted(this.typeBySource)) this.sink(`import type { ${Array.from(symbols).sort().join(", ")} } from '${source}';`);
-		for (const [source, symbols] of this.sorted(this.valueBySource)) this.sink(`import { ${Array.from(symbols).sort().join(", ")} } from '${source}';`);
-		for (const source of Array.from(this.sideEffects).sort()) this.sink(`import '${source}';`);
-	}
-	collect(map, source, symbol) {
-		const set = map.get(source) ?? /* @__PURE__ */ new Set();
-		set.add(symbol);
-		map.set(source, set);
-	}
-	sorted(map) {
-		return Array.from(map.entries()).sort((a, b) => a[0].localeCompare(b[0]));
-	}
-};
-const RUNTIME_ENTRY_SOURCE = "../../dist/index.mjs";
-const TYPE_HIERARCHY_SOURCE = "../type-hierarchy";
-const ENUM_INPUT_METADATA_SOURCE = "../enum-input-metadata";
-const CODEGEN_IMPORT_SOURCE_MAP = {
-	AcceptableVariables: {
-		source: RUNTIME_ENTRY_SOURCE,
-		kind: "type"
-	},
-	UnresolvedVariables: {
-		source: RUNTIME_ENTRY_SOURCE,
-		kind: "type"
-	},
-	DirectiveArgs: {
-		source: RUNTIME_ENTRY_SOURCE,
-		kind: "type"
-	},
-	Selection: {
-		source: RUNTIME_ENTRY_SOURCE,
-		kind: "type"
-	},
-	ShapeOf: {
-		source: RUNTIME_ENTRY_SOURCE,
-		kind: "type"
-	},
-	VariablesOf: {
-		source: RUNTIME_ENTRY_SOURCE,
-		kind: "type"
-	},
-	ValueOrThunk: {
-		source: RUNTIME_ENTRY_SOURCE,
-		kind: "type"
-	},
-	FragmentSpread: {
-		source: RUNTIME_ENTRY_SOURCE,
-		kind: "type"
-	},
-	createSelection: {
-		source: RUNTIME_ENTRY_SOURCE,
-		kind: "value"
-	},
-	withOperationName: {
-		source: RUNTIME_ENTRY_SOURCE,
-		kind: "value"
-	},
-	createSchemaType: {
-		source: RUNTIME_ENTRY_SOURCE,
-		kind: "value"
-	},
-	registerSchemaTypeFactory: {
-		source: RUNTIME_ENTRY_SOURCE,
-		kind: "value"
-	},
-	resolveRegisteredSchemaType: {
-		source: RUNTIME_ENTRY_SOURCE,
-		kind: "value"
-	},
-	ENUM_INPUT_METADATA: {
-		source: ENUM_INPUT_METADATA_SOURCE,
-		kind: "value"
-	},
-	WithTypeName: {
-		source: TYPE_HIERARCHY_SOURCE,
-		kind: "type"
-	},
-	ImplementationType: {
-		source: TYPE_HIERARCHY_SOURCE,
-		kind: "type"
-	},
-	EnumInputMetadataBuilder: {
-		source: "../dist/index.mjs",
-		kind: "value"
-	}
-};
-
 //#endregion
 //#region src/codegen/writers/selection.ts
 var SelectionWriter = class extends Writer {
@@ -1571,9 +1606,38 @@ var EnumInputMetadataWriter = class EnumInputMetadataWriter extends Writer {
 };
 
 //#endregion
-//#region \0raw:/home/runner/work/typedgql/typedgql/src/codegen/templates/async-runtime.template
+//#region \0raw:/Users/ashen/Projects/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, type] of runtime.variableTypeMap) {\n          writer.separator();\n          writer.text(`$${name}: ${type}`);\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
+function analyzeScalarTypeDeclarations(source) {
+	if (!source || source.trim().length === 0) return { exportedNames: /* @__PURE__ */ new Set() };
+	if ((typescript.default.transpileModule(source, {
+		reportDiagnostics: true,
+		compilerOptions: {
+			target: typescript.default.ScriptTarget.ESNext,
+			module: typescript.default.ModuleKind.ESNext
+		},
+		fileName: "scalar-types.ts"
+	}).diagnostics ?? []).some((d) => d.category === typescript.default.DiagnosticCategory.Error)) throw new Error("scalarTypeDeclarations has TypeScript syntax errors");
+	const sf = typescript.default.createSourceFile("scalar-types.ts", source, typescript.default.ScriptTarget.Latest, true, typescript.default.ScriptKind.TS);
+	const exportedNames = /* @__PURE__ */ new Set();
+	for (let i = 0; i < sf.statements.length; i++) {
+		const stmt = sf.statements[i];
+		if (typescript.default.isTypeAliasDeclaration(stmt) || typescript.default.isInterfaceDeclaration(stmt)) {
+			if (stmt.modifiers?.some((m) => m.kind === typescript.default.SyntaxKind.ExportKeyword)) {
+				const name = stmt.name.text;
+				if (exportedNames.has(name)) throw new Error(`scalarTypeDeclarations has duplicate export '${name}'`);
+				exportedNames.add(name);
+			}
+			continue;
+		}
+		throw new Error(`scalarTypeDeclarations statement[${i}] must be type/interface declaration`);
+	}
+	return { exportedNames };
+}
+
 //#endregion
 //#region src/codegen/generator.ts
 /** Default output directory: node_modules/@ptdgrp/typedgql/__generated */
@@ -1609,6 +1673,7 @@ var Generator = class {
 	async generate() {
 		const schema = await this.options.schemaLoader();
 		this.validateSchema(schema);
+		this.validateScalarTypeDeclarations();
 		await (0, fs_promises.rm)(this.targetDir, {
 			recursive: true,
 			force: true
@@ -1688,6 +1753,7 @@ var Generator = class {
 		promises.push(this.generateTypeHierarchy(schema, typeHierarchy));
 		promises.push(this.generateEnumInputMetadata(schema));
 		promises.push(this.generateAsyncRuntime());
+		if (this.hasScalarTypes()) promises.push(this.generateScalarTypes());
 		promises.push(this.writeIndex(schema, ctx));
 		await Promise.all(promises);
 		if (this.options.targetDir === void 0) await this.writePackageEntrypoint(schema, ctx);
@@ -1768,6 +1834,35 @@ var Generator = class {
 		stream.write(async_runtime_default);
 		await endStream(stream);
 	}
+	async generateScalarTypes() {
+		const stream = createStream((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) {
+			const indented = code.split("\n").map((line) => line.length === 0 ? line : `  ${line}`).join("\n");
+			stream.write(`export declare namespace ${SCALAR_TYPES_NAMESPACE} {\n`);
+			stream.write(`${indented}\n`);
+			this.writeScalarMapAliases(stream, analysis.exportedNames);
+			stream.write("}\n");
+		} else {
+			const scalarMap = this.options.scalarTypeMap;
+			if (scalarMap && Object.keys(scalarMap).length !== 0) {
+				stream.write(`export declare namespace ${SCALAR_TYPES_NAMESPACE} {\n`);
+				this.writeScalarMapAliases(stream, analysis.exportedNames);
+				stream.write("}\n");
+			} else stream.write("export {};\n");
+		}
+		await endStream(stream);
+	}
+	writeScalarMapAliases(stream, exportedNames) {
+		const scalarMap = this.options.scalarTypeMap;
+		if (!scalarMap) return;
+		const entries = Object.entries(scalarMap).sort((a, b) => a[0].localeCompare(b[0]));
+		for (const [scalarName, mappedType] of entries) {
+			if (exportedNames.has(scalarName)) continue;
+			stream.write(`  export type ${scalarName} = ${mappedType};\n`);
+		}
+	}
 	async writeIndex(schema, ctx) {
 		const stream = createStream((0, path.join)(this.targetDir, "index.ts"));
 		const selectionSuffix = this.options.selectionSuffix ?? "Selection";
@@ -1778,6 +1873,7 @@ var Generator = class {
 			stream.write(`import type { ${selectionTypeName} } from "./selections/${toKebabCase(selectionTypeName)}";\n`);
 		}
 		stream.write(`import { ENUM_INPUT_METADATA } from "./enum-input-metadata";\n\n`);
+		if (this.hasScalarTypes()) stream.write(`export type { ${SCALAR_TYPES_NAMESPACE} } from "./scalar-types";\n`);
 		stream.write(`export type { GraphQLExecutor, GraphQLSubscriber, Simplify } from "./client-runtime";\n`);
 		stream.write(`export { setGraphQLExecutor, setGraphQLSubscriber, execute, subscribe } from "./client-runtime";\n`);
 		stream.write("export type { ImplementationType } from './type-hierarchy';\n");
@@ -1847,6 +1943,7 @@ var Generator = class {
 		const mutationType = typeMap["Mutation"];
 		const subscriptionType = typeMap["Subscription"];
 		stream.write(`export * from './__generated/index';\n`);
+		if (this.hasScalarTypes()) stream.write(`export type { ${SCALAR_TYPES_NAMESPACE} } from './__generated/scalar-types';\n`);
 		stream.write(`export type { Selection, ExecutableSelection, ShapeOf, VariablesOf, Expand, FieldSelection, DirectiveArgs, EnumInputMetadata, EnumInputMetaType, AcceptableVariables, UnresolvedVariables, ValueOrThunk, SchemaType, SchemaField, SchemaTypeCategory, SchemaFieldCategory, FieldOptions } from './dist/index.mjs';\n`);
 		stream.write(`export { FragmentSpread, FragmentRef, StringValue, runtimeOf, createSchemaType, resolveRegisteredSchemaType, registerSchemaTypeFactory, SelectionNode, createSelection, ParameterRef, EnumInputMetadataBuilder, TextBuilder, cyrb53 } from './dist/index.mjs';\n`);
 		stream.write(`import { fragment$ } from './__generated/index';\n`);
@@ -1916,6 +2013,15 @@ var Generator = class {
 			}
 		}
 	}
+	validateScalarTypeDeclarations() {
+		analyzeScalarTypeDeclarations(this.options.scalarTypeDeclarations);
+		const scalarMap = this.options.scalarTypeMap;
+		if (!scalarMap) return;
+		for (const scalarName of Object.keys(scalarMap)) if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(scalarName)) throw new Error(`scalarTypeMap key '${scalarName}' is not identifier`);
+	}
+	hasScalarTypes() {
+		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);
@@ -1954,6 +2060,12 @@ Object.defineProperty(exports, 'Generator', {
     return Generator;
   }
 });
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});
 Object.defineProperty(exports, 'loadLocalSchema', {
   enumerable: true,
   get: function () {