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

package/dist/index.cjs

@@ -104,21 +104,43 @@ const registerSchemaType = (type) => {
 //#endregion
 //#region src/runtime/parameter.ts
 /**
-* @author ChenTao
+* Runtime marker for `ParameterRef`.
 *
-* 1. If object is used by field arguments, don't specify the graphqlTypeName
-* 2. If object is used by directive arguments, graphqlTypeName is required
+* We use a unique symbol instead of string keys to avoid accidental collision
+* with user objects passed as argument literals.
 */
 const __marker = Symbol("__parameter_ref_marker");
 var ParameterRef = class ParameterRef {
 	[__marker] = true;
-	constructor(name, graphqlTypeName) {
+	constructor(name, explicitType) {
 		this.name = name;
-		this.graphqlTypeName = graphqlTypeName;
+		this.explicitType = explicitType;
 		if (name.startsWith("$")) throw new Error("parameter name cannot start with '$'");
 	}
-	static of(name, graphqlTypeName) {
-		return new ParameterRef(name, graphqlTypeName);
+	/**
+	* Represents a GraphQL variable reference used in DSL argument objects.
+	*
+	* Example:
+	* - `id: ParameterRef.of("postId")` -> `id: $postId`
+	*
+	* Main use cases:
+	* 1. Rename/bind a field argument to a different variable name.
+	* 2. Explicitly annotate variable type when runtime cannot infer it from a
+	*    field argument position (for example directive args or nested literals).
+	*
+	* When `explicitType` is NOT needed:
+	* - Field arg slot with schema type:
+	*   `q.user({ id: ParameterRef.of("userId") }, (u) => u.id)`
+	*   `id` type is inferred from schema (`ID!`).
+	*
+	* When `explicitType` IS needed:
+	* - Directive arg slot:
+	*   `node.$directive("include", { if: ParameterRef.of("withEmail", "Boolean!") })`
+	* - Nested input slot without direct arg type context:
+	*   `q.search({ filter: { keyword: ParameterRef.of("kw", "String!") } }, ...)`
+	*/
+	static of(name, explicitType) {
+		return new ParameterRef(name, explicitType);
 	}
 };
 
@@ -414,7 +436,7 @@ var SerializeContext = class SerializeContext {
 				t(name);
 				if (field.argGraphQLTypes) {
 					const meta = sel._enumInputMetadata;
-					this.acceptArgs(field.args, field.argGraphQLTypes, meta);
+					this.acceptArgs(field.args, field.argGraphQLTypes, meta, `field '${runtime.schemaType.name}.${name}'`);
 				}
 				this.acceptDirectives(field.fieldOptionsValue?.directives);
 			}
@@ -456,10 +478,10 @@ var SerializeContext = class SerializeContext {
 		if (!directives) return;
 		for (const [directive, args] of directives) {
 			this.writer.text(`\n@${directive}`);
-			this.acceptArgs(args);
+			this.acceptArgs(args, void 0, void 0, `directive '@${directive}'`);
 		}
 	}
-	acceptArgs(args, argGraphQLTypeMap, enumInputMetadata) {
+	acceptArgs(args, argGraphQLTypeMap, enumInputMetadata, argContext = "argument") {
 		if (!args) return;
 		const t = this.writer.text.bind(this.writer);
 		let hasField;
@@ -481,7 +503,7 @@ var SerializeContext = class SerializeContext {
 					const typeName = argGraphQLTypeMap.get(argName);
 					if (typeName !== void 0) if (arg?.[__marker]) {
 						const ref = arg;
-						this.registerVariableType(ref, typeName, false, "field argument");
+						this.registerVariableType(ref, typeName, false, `${argContext}.${argName}`);
 						t(`${argName}: $${ref.name}`);
 					} else {
 						t(`${argName}: `);
@@ -490,8 +512,8 @@ var SerializeContext = class SerializeContext {
 					else throw new Error(`Unknown argument '${argName}'`);
 				} else if (arg?.[__marker]) {
 					const ref = arg;
-					if (!ref.graphqlTypeName) throw new Error(`Directive argument '${ref.name}' requires graphqlTypeName`);
-					this.registerVariableType(ref, ref.graphqlTypeName, false, "directive argument");
+					if (!ref.explicitType) throw new Error(`Cannot infer the type of directive argument '${ref.name}'; an explicit type annotation is required.`);
+					this.registerVariableType(ref, ref.explicitType, false, `${argContext}.${argName}`);
 					t(`${argName}: $${ref.name}`);
 				} else {
 					t(`${argName}: `);
@@ -500,7 +522,7 @@ var SerializeContext = class SerializeContext {
 			}
 		});
 	}
-	acceptLiteral(value, metaType, graphqlTypeName) {
+	acceptLiteral(value, metaType, explicitType) {
 		const t = this.writer.text.bind(this.writer);
 		if (value == null) {
 			t("null");
@@ -520,8 +542,8 @@ var SerializeContext = class SerializeContext {
 		}
 		if (value?.[__marker]) {
 			const ref = value;
-			if (!graphqlTypeName && !ref.graphqlTypeName) throw new Error(`Argument '${ref.name}' nested type cannot be inferred; provide graphqlTypeName`);
-			this.registerVariableType(ref, graphqlTypeName, true, "nested argument");
+			if (!explicitType && !ref.explicitType) throw new Error(`Cannot infer the nested type of argument '${ref.name}'; an explicit type annotation is required.`);
+			this.registerVariableType(ref, explicitType, true, "nested argument");
 			t(`$${ref.name}`);
 			return;
 		}
@@ -530,7 +552,7 @@ var SerializeContext = class SerializeContext {
 			return;
 		}
 		if (Array.isArray(value) || value instanceof Set) {
-			const elementGraphQLTypeName = SerializeContext.elementTypeName(graphqlTypeName);
+			const elementGraphQLTypeName = SerializeContext.elementTypeName(explicitType);
 			this.writer.scope({ type: "array" }, () => {
 				for (const e of value) {
 					this.writer.separator(", ");
@@ -555,12 +577,15 @@ var SerializeContext = class SerializeContext {
 		});
 	}
 	registerVariableType(ref, expectedTypeName, allowImplicitFromRef = false, context = "argument") {
-		const typeName = expectedTypeName ?? (allowImplicitFromRef ? ref.graphqlTypeName : void 0);
-		if (!typeName) throw new Error(`Directive argument '${ref.name}' requires graphqlTypeName`);
-		if (ref.graphqlTypeName && ref.graphqlTypeName !== typeName) throw new Error(`Argument '${ref.name}' type conflict: '${typeName}' vs ParameterRef '${ref.graphqlTypeName}' (${context})`);
+		const typeName = expectedTypeName ?? (allowImplicitFromRef ? ref.explicitType : void 0);
+		if (!typeName) throw new Error(`Cannot infer the type of directive argument '${ref.name}'; an explicit type annotation is required.`);
+		if (ref.explicitType && ref.explicitType !== typeName) throw new Error(`Variable '$${ref.name}' has conflicting GraphQL types at ${context}: inferred '${typeName}', but ParameterRef declares '${ref.explicitType}'`);
 		const existing = this.variableTypeMap.get(ref.name);
-		if (existing && existing !== typeName) throw new Error(`Argument '${ref.name}' type conflict: '${existing}' vs '${typeName}' (${context})`);
-		this.variableTypeMap.set(ref.name, typeName);
+		if (existing && existing.typeName !== typeName) throw new Error(`Variable '$${ref.name}' has conflicting GraphQL types: first '${existing.typeName}' at ${existing.source}, then '${typeName}' at ${context}`);
+		this.variableTypeMap.set(ref.name, {
+			typeName,
+			source: context
+		});
 	}
 	static enumMetaType(meta, typeName) {
 		if (!meta || !typeName) return void 0;
@@ -720,13 +745,15 @@ const createChildSelectionProxy = (schemaType, enumInputMetadata) => {
 		void 0
 	], false, ""), proxyHandler(schemaType));
 };
-const buildRequiredArgs = (argTypeMap) => {
-	if (!argTypeMap.size) return void 0;
-	const requiredArgNames = Array.from(argTypeMap.entries()).filter(([, type]) => type.endsWith("!")).map(([name]) => name);
-	if (!requiredArgNames.length) return void 0;
-	const args = {};
-	for (const name of requiredArgNames) args[name] = ParameterRef.of(name);
-	return args;
+const resolveAutoPropagatedArgs = (declaredArgTypeMap, providedArgs) => {
+	if (!declaredArgTypeMap?.size) return providedArgs;
+	const autoArgs = {};
+	for (const argName of declaredArgTypeMap.keys()) autoArgs[argName] = ParameterRef.of(argName);
+	if (!providedArgs) return autoArgs;
+	return {
+		...autoArgs,
+		...providedArgs
+	};
 };
 const resolveAssociationTarget = (fieldName, fieldTargetTypeName, ownerTypeName) => {
 	if (!fieldTargetTypeName) throw new Error(`Field "${fieldName}" has no target type`);
@@ -793,8 +820,8 @@ const proxyHandler = (schemaType) => {
 					let { args, childSelectionFactory, childSelection } = parseAssociationArgs(argArray);
 					if (childSelectionFactory) childSelection = childSelectionFactory(createChildSelectionProxy(targetSchemaType, target._enumInputMetadata));
 					if (!childSelection) throw new Error(`Field "${p}" requires a child selection`);
-					if (!args) args = buildRequiredArgs(field.argGraphQLTypeMap);
-					return new Proxy(target.addField(p, args, childSelection), handler);
+					const resolvedArgs = resolveAutoPropagatedArgs(field.argGraphQLTypeMap, args);
+					return new Proxy(target.addField(p, resolvedArgs, childSelection), handler);
 				};
 				if (field.isFunction) return new Proxy(DUMMY, methodHandler(target, handler, p));
 				return new Proxy(target.addField(p), handler);
@@ -862,11 +889,9 @@ const methodHandler = (targetSelection, handler, field) => {
 			return new Proxy(current, handler);
 		}
 		let { args, child, optionsValue } = parseMethodArgs(argArray);
-		if (!args) {
-			const argMap = targetSelection.schemaType.ownFields.get(field)?.argGraphQLTypeMap;
-			args = argMap ? buildRequiredArgs(argMap) : void 0;
-		}
-		return new Proxy(targetSelection.addField(field, args, child, optionsValue), handler);
+		const declaredArgTypeMap = targetSelection.schemaType.fields.get(field)?.argGraphQLTypeMap;
+		const resolvedArgs = resolveAutoPropagatedArgs(declaredArgTypeMap, args);
+		return new Proxy(targetSelection.addField(field, resolvedArgs, child, optionsValue), handler);
 	} };
 };
 const DUMMY = () => {};

package/dist/index.d.cts

@@ -74,18 +74,48 @@ declare const createSchemaType: <E extends string>(name: E, category: SchemaType
 //#endregion
 //#region src/runtime/parameter.d.ts
 /**
- * @author ChenTao
+ * Runtime marker for `ParameterRef`.
  *
- * 1. If object is used by field arguments, don't specify the graphqlTypeName
- * 2. If object is used by directive arguments, graphqlTypeName is required
+ * We use a unique symbol instead of string keys to avoid accidental collision
+ * with user objects passed as argument literals.
  */
 declare const __marker: unique symbol;
 declare class ParameterRef<TName extends string> {
+  /** GraphQL variable name without `$` prefix. */
   readonly name: TName;
-  readonly graphqlTypeName?: string | undefined;
+  /**
+   * Optional GraphQL type annotation (e.g. `Boolean!`, `[String!]`).
+   *
+   * - Field argument position: usually omitted, type can be inferred from
+   *   schema `argGraphQLTypeMap`.
+   * - Directive/nested position: usually required to register variable type.
+   */
+  readonly explicitType?: string | undefined;
   readonly [__marker] = true;
   private constructor();
-  static of<TName extends string>(name: TName, graphqlTypeName?: string): ParameterRef<TName>;
+  /**
+   * Represents a GraphQL variable reference used in DSL argument objects.
+   *
+   * Example:
+   * - `id: ParameterRef.of("postId")` -> `id: $postId`
+   *
+   * Main use cases:
+   * 1. Rename/bind a field argument to a different variable name.
+   * 2. Explicitly annotate variable type when runtime cannot infer it from a
+   *    field argument position (for example directive args or nested literals).
+   *
+   * When `explicitType` is NOT needed:
+   * - Field arg slot with schema type:
+   *   `q.user({ id: ParameterRef.of("userId") }, (u) => u.id)`
+   *   `id` type is inferred from schema (`ID!`).
+   *
+   * When `explicitType` IS needed:
+   * - Directive arg slot:
+   *   `node.$directive("include", { if: ParameterRef.of("withEmail", "Boolean!") })`
+   * - Nested input slot without direct arg type context:
+   *   `q.search({ filter: { keyword: ParameterRef.of("kw", "String!") } }, ...)`
+   */
+  static of<TName extends string>(name: TName, explicitType?: string): ParameterRef<TName>;
 }
 type AcceptableVariables<T extends object> = { [K in keyof T]: T[K] | ParameterRef<string> };
 type UnresolvedVariables<T, TVariables> = ReversedType<UnresolvedNames<UnresolvedRefs<T>>, TVariables>;
@@ -128,7 +158,7 @@ interface SelectionRuntime<E extends string = string> {
   readonly operationName?: string;
   readonly fieldMap: ReadonlyMap<string, FieldSelection>;
   readonly directiveMap: ReadonlyMap<string, DirectiveArgs>;
-  readonly variableTypeMap: ReadonlyMap<string, string>;
+  readonly variableTypeMap: ReadonlyMap<string, VariableTypeRegistration>;
   findField(fieldKey: string): FieldSelection | undefined;
   findFieldsByName(fieldName: string): readonly FieldSelection[];
   findFieldByName(fieldName: string): FieldSelection | undefined;
@@ -141,6 +171,10 @@ type ShapeOf<F> = F extends Selection<string, infer M, object> ? M : never;
 type VariablesOf<T> = T extends Selection<string, object, infer TVariables> ? TVariables : never;
 type Expand<T> = T extends ReadonlyArray<infer U> ? ReadonlyArray<Expand<U>> : T extends Array<infer U> ? Array<Expand<U>> : T extends object ? { [K in keyof T]: Expand<T[K]> } : T;
 type ValueOrThunk<T> = T | (() => T);
+interface VariableTypeRegistration {
+  readonly typeName: string;
+  readonly source: string;
+}
 interface FieldSelection {
   readonly name: string;
   readonly argGraphQLTypes?: ReadonlyMap<string, string>;
@@ -252,7 +286,7 @@ declare class SelectionImpl<E extends string, T extends object, TVariables exten
   withOperationName<F extends SelectionImpl<string, object, object>>(operationName?: string): F;
   get fieldMap(): ReadonlyMap<string, FieldSelection>;
   get directiveMap(): ReadonlyMap<string, DirectiveArgs>;
-  get variableTypeMap(): ReadonlyMap<string, string>;
+  get variableTypeMap(): ReadonlyMap<string, VariableTypeRegistration>;
   findField(fieldKey: string): FieldSelection | undefined;
   findFieldsByName(fieldName: string): readonly FieldSelection[];
   findFieldByName(fieldName: string): FieldSelection | undefined;

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/runtime/schema.ts","../src/runtime/parameter.ts","../src/runtime/field-options.ts","../src/runtime/types.ts","../src/runtime/enum-metadata.ts","../src/runtime/selection.ts","../src/runtime/proxy.ts","../src/runtime/text-builder.ts","../src/runtime/cyrb53.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/runtime/schema.ts","../src/runtime/parameter.ts","../src/runtime/field-options.ts","../src/runtime/types.ts","../src/runtime/enum-metadata.ts","../src/runtime/selection.ts","../src/runtime/proxy.ts","../src/runtime/text-builder.ts","../src/runtime/cyrb53.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -74,18 +74,48 @@ declare const createSchemaType: <E extends string>(name: E, category: SchemaType
 //#endregion
 //#region src/runtime/parameter.d.ts
 /**
- * @author ChenTao
+ * Runtime marker for `ParameterRef`.
  *
- * 1. If object is used by field arguments, don't specify the graphqlTypeName
- * 2. If object is used by directive arguments, graphqlTypeName is required
+ * We use a unique symbol instead of string keys to avoid accidental collision
+ * with user objects passed as argument literals.
  */
 declare const __marker: unique symbol;
 declare class ParameterRef<TName extends string> {
+  /** GraphQL variable name without `$` prefix. */
   readonly name: TName;
-  readonly graphqlTypeName?: string | undefined;
+  /**
+   * Optional GraphQL type annotation (e.g. `Boolean!`, `[String!]`).
+   *
+   * - Field argument position: usually omitted, type can be inferred from
+   *   schema `argGraphQLTypeMap`.
+   * - Directive/nested position: usually required to register variable type.
+   */
+  readonly explicitType?: string | undefined;
   readonly [__marker] = true;
   private constructor();
-  static of<TName extends string>(name: TName, graphqlTypeName?: string): ParameterRef<TName>;
+  /**
+   * Represents a GraphQL variable reference used in DSL argument objects.
+   *
+   * Example:
+   * - `id: ParameterRef.of("postId")` -> `id: $postId`
+   *
+   * Main use cases:
+   * 1. Rename/bind a field argument to a different variable name.
+   * 2. Explicitly annotate variable type when runtime cannot infer it from a
+   *    field argument position (for example directive args or nested literals).
+   *
+   * When `explicitType` is NOT needed:
+   * - Field arg slot with schema type:
+   *   `q.user({ id: ParameterRef.of("userId") }, (u) => u.id)`
+   *   `id` type is inferred from schema (`ID!`).
+   *
+   * When `explicitType` IS needed:
+   * - Directive arg slot:
+   *   `node.$directive("include", { if: ParameterRef.of("withEmail", "Boolean!") })`
+   * - Nested input slot without direct arg type context:
+   *   `q.search({ filter: { keyword: ParameterRef.of("kw", "String!") } }, ...)`
+   */
+  static of<TName extends string>(name: TName, explicitType?: string): ParameterRef<TName>;
 }
 type AcceptableVariables<T extends object> = { [K in keyof T]: T[K] | ParameterRef<string> };
 type UnresolvedVariables<T, TVariables> = ReversedType<UnresolvedNames<UnresolvedRefs<T>>, TVariables>;
@@ -128,7 +158,7 @@ interface SelectionRuntime<E extends string = string> {
   readonly operationName?: string;
   readonly fieldMap: ReadonlyMap<string, FieldSelection>;
   readonly directiveMap: ReadonlyMap<string, DirectiveArgs>;
-  readonly variableTypeMap: ReadonlyMap<string, string>;
+  readonly variableTypeMap: ReadonlyMap<string, VariableTypeRegistration>;
   findField(fieldKey: string): FieldSelection | undefined;
   findFieldsByName(fieldName: string): readonly FieldSelection[];
   findFieldByName(fieldName: string): FieldSelection | undefined;
@@ -141,6 +171,10 @@ type ShapeOf<F> = F extends Selection<string, infer M, object> ? M : never;
 type VariablesOf<T> = T extends Selection<string, object, infer TVariables> ? TVariables : never;
 type Expand<T> = T extends ReadonlyArray<infer U> ? ReadonlyArray<Expand<U>> : T extends Array<infer U> ? Array<Expand<U>> : T extends object ? { [K in keyof T]: Expand<T[K]> } : T;
 type ValueOrThunk<T> = T | (() => T);
+interface VariableTypeRegistration {
+  readonly typeName: string;
+  readonly source: string;
+}
 interface FieldSelection {
   readonly name: string;
   readonly argGraphQLTypes?: ReadonlyMap<string, string>;
@@ -252,7 +286,7 @@ declare class SelectionImpl<E extends string, T extends object, TVariables exten
   withOperationName<F extends SelectionImpl<string, object, object>>(operationName?: string): F;
   get fieldMap(): ReadonlyMap<string, FieldSelection>;
   get directiveMap(): ReadonlyMap<string, DirectiveArgs>;
-  get variableTypeMap(): ReadonlyMap<string, string>;
+  get variableTypeMap(): ReadonlyMap<string, VariableTypeRegistration>;
   findField(fieldKey: string): FieldSelection | undefined;
   findFieldsByName(fieldName: string): readonly FieldSelection[];
   findFieldByName(fieldName: string): FieldSelection | undefined;

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/runtime/schema.ts","../src/runtime/parameter.ts","../src/runtime/field-options.ts","../src/runtime/types.ts","../src/runtime/enum-metadata.ts","../src/runtime/selection.ts","../src/runtime/proxy.ts","../src/runtime/text-builder.ts","../src/runtime/cyrb53.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/runtime/schema.ts","../src/runtime/parameter.ts","../src/runtime/field-options.ts","../src/runtime/types.ts","../src/runtime/enum-metadata.ts","../src/runtime/selection.ts","../src/runtime/proxy.ts","../src/runtime/text-builder.ts","../src/runtime/cyrb53.ts"],"mappings":";;AAYA;;;;;AAcA;;;;KAdY,kBAAA;AAqBZ;;;;;;;;;;;;AAAA,KAPY,mBAAA;;;;UAOK,UAAA;EAMN;EAAA,SAJA,IAAA,EAAM,CAAA;EAMN;EAAA,SAJA,QAAA,EAAU,kBAAA;EAIqB;EAAA,SAF/B,UAAA,WAAqB,UAAA;EAIb;EAAA,SAFR,SAAA,EAAW,WAAA,SAAoB,WAAA;EAEQ;EAAA,SAAvC,MAAA,EAAQ,WAAA,SAAoB,WAAA;AAAA;;;;UAMtB,WAAA;EAIN;EAAA,SAFA,IAAA;EAIA;EAAA,SAFA,QAAA,EAAU,mBAAA;EAIV;EAAA,SAFA,iBAAA,EAAmB,WAAA;EAMnB;EAAA,SAJA,cAAA;EAQA;EAAA,SANA,QAAA;EAMa;EAAA,SAJb,aAAA;EAsCV;EAAA,SApCU,UAAA;EAUT;EAAA,SARS,aAAA;AAAA;AAAA,cAOE,2BAAA,GACX,QAAA,aACC,UAAA;AAAA,cA2BU,yBAAA,GACX,QAAA,UACA,OAAA,QAAe,UAAA;AAAA,KASZ,eAAA;EAAA,SAGU,IAAA;EAAA,SACA,QAAA,EAAU,mBAAA;EAAA,SACV,WAAA;EAAA,SACA,iBAAA;IAAA,UAAgC,GAAA;EAAA;EAAA,SAChC,cAAA;AAAA;AAAA,cAKF,gBAAA,qBACX,IAAA,EAAM,CAAA,EACN,QAAA,EAAU,kBAAA,EACV,UAAA,WAAqB,UAAA,IACrB,cAAA,WAAyB,eAAA,OACxB,UAAA,CAAW,CAAA;;;;AArHd;;;;;cCNa,QAAA;AAAA,cAEA,YAAA;;WAKA,IAAA,EAAM,KAAA;EDaY;AAO/B;;;;;;EAP+B,SCLlB,YAAA;EAAA,UAZD,QAAA;EAAA,QAEH,WAAA,CAAA;EDgCU;;;;;;;;;;;;;;;;;;AAMnB;;;;EANmB,OCOV,EAAA,sBAAA,CACL,IAAA,EAAM,KAAA,EACN,YAAA,YACC,YAAA,CAAa,KAAA;AAAA;AAAA,KAKN,mBAAA,mCACE,CAAA,GAAI,CAAA,CAAE,CAAA,IAAK,YAAA;AAAA,KAGb,mBAAA,kBAAqC,YAAA,CAC/C,eAAA,CAAgB,cAAA,CAAe,CAAA,IAC/B,UAAA;AAAA,KAGG,cAAA,eAA6B,IAAA,CAChC,UAAA,gBAEc,UAAA,GAAa,UAAA,CAAW,CAAA,UAAW,YAAA,WAC3C,CAAA,iBAEE,UAAA;AAAA,KAGL,eAAA,0CACS,uBAAA,GAA0B,gBAAA,CACpC,uBAAA,CAAwB,CAAA;AAAA,KAIvB,YAAA,WAAuB,MAAA,OAAa,CAAA,mCACjC,CAAA,OAAQ,CAAA,kBACA,CAAA,GAAI,CAAA,CAAE,CAAA,UAAW,CAAA,GACzB,CAAA,eAAgB,SAAA,GACd,SAAA,CAAU,CAAA,0BAGV,CAAA;AAAA,KAGL,gBAAA,MACH,CAAA,SAAU,YAAA,mBAA+B,QAAA;;;UCrF1B,iBAAA;EAAA,SACN,KAAA;EAAA,SACA,UAAA,EAAY,WAAA,SAAoB,aAAA;AAAA;AAAA,cAG9B,YAAA;EAAA,UAEqB,GAAA,WAAc,aAAA;AAAA;EAAA,iBAM3B,KAAA;EAAA,iBACA,MAAA;EAAA,iBACA,UAAA;EAAA,iBACA,cAAA;EAAA,QANX,MAAA;cAGW,KAAA,GAAQ,YAAA,gCACR,MAAA,uBACA,UAAA,uBACA,cAAA;EAGnB,KAAA,uBAAA,CACE,KAAA,EAAO,MAAA,GACN,YAAA,CAAa,MAAA,EAAQ,WAAA,EAAa,mBAAA;EAOrC,SAAA,0CAAmD,aAAA,MAAA,CACjD,SAAA,EAAW,UAAA,EACX,IAAA,GAAO,KAAA,GACN,YAAA,CACD,MAAA,EACA,WAAA,sBAAiC,UAAA,GAAa,KAAA,IAC9C,mBAAA,GAAsB,mBAAA,CAAoB,KAAA,EAAO,MAAA,OAAa,KAAA;EAAA,IAc5D,KAAA,CAAA,GAAS,iBAAA;EAAA,QAIL,WAAA;AAAA;;;cCxDG,SAAA;AAAA,cACA,SAAA;AAAA,UAII,SAAA;EAKf,QAAA;EACA,gBAAA;EACA,MAAA;EAAA,UAEU,SAAA,aAAsB,CAAA,EAAG,CAAA,EAAG,UAAA;AAAA;AAAA,UAGvB,gBAAA;EAAA,SACN,UAAA,EAAY,UAAA,CAAW,CAAA;EAAA,SACvB,aAAA;EAAA,SACA,QAAA,EAAU,WAAA,SAAoB,cAAA;EAAA,SAC9B,YAAA,EAAc,WAAA,SAAoB,aAAA;EAAA,SAClC,eAAA,EAAiB,WAAA,SAAoB,wBAAA;EAE9C,SAAA,CAAU,QAAA,WAAmB,cAAA;EAC7B,gBAAA,CAAiB,SAAA,oBAA6B,cAAA;EAC9C,eAAA,CAAgB,SAAA,WAAoB,cAAA;AAAA;AAAA,KAG1B,mBAAA,kEAIR,SAAA,CAAU,CAAA,EAAG,CAAA,EAAG,UAAA;EAAA,UACR,SAAA,GAAY,gBAAA,CAAiB,CAAA;AAAA;AAAA,iBAGzB,SAAA,+DAAA,CAId,SAAA,EAAW,SAAA,CAAU,CAAA,EAAG,CAAA,EAAG,UAAA,IAAc,gBAAA,CAAiB,CAAA;AAAA,KAMhD,OAAA,MACV,CAAA,SAAU,SAAA,4BAAqC,CAAA;AAAA,KAErC,WAAA,MACV,CAAA,SAAU,SAAA,qCAA8C,UAAA;AAAA,KAE9C,MAAA,MACV,CAAA,SAAU,aAAA,YACN,aAAA,CAAc,MAAA,CAAO,CAAA,KACrB,CAAA,SAAU,KAAA,YACR,KAAA,CAAM,MAAA,CAAO,CAAA,KACb,CAAA,gCACgB,CAAA,GAAI,MAAA,CAAO,CAAA,CAAE,CAAA,OAC3B,CAAA;AAAA,KAEE,YAAA,MAAkB,CAAA,UAAW,CAAA;AAAA,UAExB,wBAAA;EAAA,SACN,QAAA;EAAA,SACA,MAAA;AAAA;AAAA,UAGM,cAAA;EAAA,SACN,IAAA;EAAA,SACA,eAAA,GAAkB,WAAA;EAAA,SAClB,IAAA;EAAA,SACA,iBAAA,GAAoB,iBAAA;EAAA,SACpB,MAAA;EAAA,SACA,eAAA,GAAkB,aAAA,CACzB,mBAAA;AAAA;AAAA,KAMQ,aAAA;EAAA,UACI,GAAA,WAAc,YAAA,WAAuB,WAAA;AAAA;AAAA,cAGxC,WAAA;EAAA,SAEA,KAAA;EAAA,SACA,cAAA;cADA,KAAA,OACA,cAAA;AAAA;AAAA,cAIA,iBAAA;AAAA,uBAES,cAAA;EAAA,SAST,IAAA,EAAM,aAAA;EAAA,SACN,SAAA,EAAW,mBAAA,CAAoB,CAAA,EAAG,CAAA,EAAG,UAAA;EAAA,UAJtC,iBAAA;EAAA,UAED,WAAA,CACE,IAAA,EAAM,aAAA,EACN,SAAA,EAAW,mBAAA,CAAoB,CAAA,EAAG,CAAA,EAAG,UAAA;AAAA;AAAA,cAIrC,WAAA,sGAKH,cAAA,CAAe,aAAA,EAAe,CAAA,EAAG,CAAA,EAAG,UAAA;cAE1C,IAAA,EAAM,aAAA,EACN,SAAA,EAAW,mBAAA,CAAoB,CAAA,EAAG,CAAA,EAAG,UAAA;AAAA;;;;AH7GzC;;;;;AAcA;;;KIhBY,iBAAA,GAAoB,WAAA,SAAoB,iBAAA;;UAGnC,iBAAA;EJoBU;EAAA,SIlBhB,IAAA;EJoBM;EAAA,SIlBN,IAAA;EJsBqB;EAAA,SIpBrB,MAAA,GAAS,WAAA,SAAoB,iBAAA;EJsBlB;EAAA,SIpBX,mBAAA,GAAsB,WAAA;AAAA;;UAIhB,QAAA;EAAA,SACN,IAAA;EAAA,SACA,QAAA;EAAA,SACA,eAAA;EAAA,SACA,MAAA;AAAA;;;;;;;;;;;AJoBX;cINa,wBAAA;EAAA,QACH,OAAA;EAAA,wBACgB,eAAA;EJMf;EIGT,GAAA,CAAI,IAAA,UAAc,MAAA,GAAS,aAAA,CAAc,QAAA;EJDtB;EIOnB,KAAA,CAAA,GAAS,iBAAA;AAAA;;;cCvCE,aAAA,2EAIA,SAAA,CAAU,CAAA,EAAG,CAAA,EAAG,UAAA;EAAA,iBASR,IAAA;EAAA,iBAGA,SAAA;EAAA,iBACA,MAAA;EAAA,iBACA,KAAA;EAAA,iBACA,MAAA;EAAA,iBACA,kBAAA;EAAA,iBACA,UAAA;EAAA,iBACA,cAAA;EAAA,iBACA,cAAA;EAAA,UAlBD,SAAA,aAAsB,CAAA,EAAG,CAAA,EAAG,UAAA;EAAA,UACpC,SAAA,GAAY,gBAAA,CAAiB,CAAA;EAAA,QAE/B,SAAA;EAAA,QACA,aAAA;EAAA,QACA,OAAA;cAGW,IAAA,EACb,aAAA,qCACU,UAAA,CAAW,CAAA,GAAI,iBAAA,yBACZ,SAAA,WACA,MAAA,UACA,KAAA;IAAA,CAAW,GAAA;EAAA,eACX,MAAA,GAAS,aAAA,sCACT,kBAAA,GAAqB,iBAAA,cACrB,UAAA,uBACA,cAAA,GAAiB,aAAA,EACjB,cAAA;EAAA,IAKf,SAAA,CAAA;EAAA,YAMQ,WAAA,CAAA;EAAA,YAOA,kBAAA,CAAA;EAAA,YAMA,eAAA,CAAA;EAAA,YAQA,KAAA,CAAA;EAAA,IAMR,UAAA,CAAA,GAAc,UAAA,CAAW,CAAA;EAAA,IAIzB,aAAA,CAAA;EASJ,QAAA,WAAmB,aAAA,yBAAA,CACjB,KAAA,UACA,IAAA;IAAA,CAAU,GAAA;EAAA,GACV,KAAA,GAAQ,aAAA,0BACR,YAAA,GAAe,iBAAA,GACd,CAAA;EAWH,WAAA,WAAsB,aAAA,yBAAA,CACpB,KAAA,WACC,CAAA;EAKH,aAAA,WAAwB,aAAA,yBAAA,CACtB,KAAA,EAAO,aAAA,0BACP,YAAA,YACC,CAAA;EAyBH,YAAA,WAAuB,aAAA,yBAAA,CACrB,SAAA,UACA,aAAA,GAAgB,aAAA,GACf,CAAA;EAaH,iBAAA,WAA4B,aAAA,yBAAA,CAC1B,aAAA,YACC,CAAA;EAAA,IAsBC,QAAA,CAAA,GAAY,WAAA,SAAoB,cAAA;EAAA,IAIhC,YAAA,CAAA,GAAgB,WAAA,SAAoB,aAAA;EAAA,IAIpC,eAAA,CAAA,GAAmB,WAAA,SAAoB,wBAAA;EAM3C,SAAA,CAAU,QAAA,WAAmB,cAAA;EAc7B,gBAAA,CAAiB,SAAA,oBAA6B,cAAA;EAM9C,eAAA,CAAgB,SAAA,WAAoB,cAAA;EAYpC,QAAA,CAAA;EAIA,gBAAA,CAAA;EAIA,MAAA,CAAA;EAAA,QAQQ,cAAA;EAAA,QAgDA,kBAAA;EAAA,QAcA,oBAAA;EAAA,QAcA,UAAA;AAAA;AAAA,cAKG,iBAAA,aAA+B,SAAA,0BAC1C,SAAA,EAAW,CAAA,EACX,aAAA,cACC,CAAA;;;cCrTU,eAAA,+BAED,SAAA,CAAU,CAAA,mBAEpB,UAAA,EAAY,UAAA,CAAW,CAAA,GACvB,iBAAA,EAAmB,iBAAA,EACnB,gBAAA,2BACC,CAAA;;;KC9BS,SAAA;AAAA,UAEK,YAAA;EAAA,SACN,IAAA,EAAM,SAAA;EAAA,SACN,UAAA;EAAA,SACA,SAAA;EAAA,SACA,MAAA;EAAA,SACA,MAAA;AAAA;AAAA,cAqBE,WAAA;EAAA,iBAKkB,MAAA;EAAA,QAJrB,MAAA;EAAA,QACA,SAAA;EAAA,iBACS,MAAA;cAEY,MAAA;EAE7B,IAAA,CAAK,KAAA;EAsBL,KAAA,CAAM,OAAA,EAAS,YAAA,EAAc,MAAA;EA0B7B,SAAA,CAAU,KAAA;EAWV,QAAA,CAAA;EAAA,QAIQ,WAAA;EAAA,QAOA,SAAA;AAAA;;;cCzGG,MAAA,GAAU,GAAA,UAAa,IAAA"}

package/dist/index.mjs

@@ -102,21 +102,43 @@ const registerSchemaType = (type) => {
 //#endregion
 //#region src/runtime/parameter.ts
 /**
-* @author ChenTao
+* Runtime marker for `ParameterRef`.
 *
-* 1. If object is used by field arguments, don't specify the graphqlTypeName
-* 2. If object is used by directive arguments, graphqlTypeName is required
+* We use a unique symbol instead of string keys to avoid accidental collision
+* with user objects passed as argument literals.
 */
 const __marker = Symbol("__parameter_ref_marker");
 var ParameterRef = class ParameterRef {
 	[__marker] = true;
-	constructor(name, graphqlTypeName) {
+	constructor(name, explicitType) {
 		this.name = name;
-		this.graphqlTypeName = graphqlTypeName;
+		this.explicitType = explicitType;
 		if (name.startsWith("$")) throw new Error("parameter name cannot start with '$'");
 	}
-	static of(name, graphqlTypeName) {
-		return new ParameterRef(name, graphqlTypeName);
+	/**
+	* Represents a GraphQL variable reference used in DSL argument objects.
+	*
+	* Example:
+	* - `id: ParameterRef.of("postId")` -> `id: $postId`
+	*
+	* Main use cases:
+	* 1. Rename/bind a field argument to a different variable name.
+	* 2. Explicitly annotate variable type when runtime cannot infer it from a
+	*    field argument position (for example directive args or nested literals).
+	*
+	* When `explicitType` is NOT needed:
+	* - Field arg slot with schema type:
+	*   `q.user({ id: ParameterRef.of("userId") }, (u) => u.id)`
+	*   `id` type is inferred from schema (`ID!`).
+	*
+	* When `explicitType` IS needed:
+	* - Directive arg slot:
+	*   `node.$directive("include", { if: ParameterRef.of("withEmail", "Boolean!") })`
+	* - Nested input slot without direct arg type context:
+	*   `q.search({ filter: { keyword: ParameterRef.of("kw", "String!") } }, ...)`
+	*/
+	static of(name, explicitType) {
+		return new ParameterRef(name, explicitType);
 	}
 };
 
@@ -412,7 +434,7 @@ var SerializeContext = class SerializeContext {
 				t(name);
 				if (field.argGraphQLTypes) {
 					const meta = sel._enumInputMetadata;
-					this.acceptArgs(field.args, field.argGraphQLTypes, meta);
+					this.acceptArgs(field.args, field.argGraphQLTypes, meta, `field '${runtime.schemaType.name}.${name}'`);
 				}
 				this.acceptDirectives(field.fieldOptionsValue?.directives);
 			}
@@ -454,10 +476,10 @@ var SerializeContext = class SerializeContext {
 		if (!directives) return;
 		for (const [directive, args] of directives) {
 			this.writer.text(`\n@${directive}`);
-			this.acceptArgs(args);
+			this.acceptArgs(args, void 0, void 0, `directive '@${directive}'`);
 		}
 	}
-	acceptArgs(args, argGraphQLTypeMap, enumInputMetadata) {
+	acceptArgs(args, argGraphQLTypeMap, enumInputMetadata, argContext = "argument") {
 		if (!args) return;
 		const t = this.writer.text.bind(this.writer);
 		let hasField;
@@ -479,7 +501,7 @@ var SerializeContext = class SerializeContext {
 					const typeName = argGraphQLTypeMap.get(argName);
 					if (typeName !== void 0) if (arg?.[__marker]) {
 						const ref = arg;
-						this.registerVariableType(ref, typeName, false, "field argument");
+						this.registerVariableType(ref, typeName, false, `${argContext}.${argName}`);
 						t(`${argName}: $${ref.name}`);
 					} else {
 						t(`${argName}: `);
@@ -488,8 +510,8 @@ var SerializeContext = class SerializeContext {
 					else throw new Error(`Unknown argument '${argName}'`);
 				} else if (arg?.[__marker]) {
 					const ref = arg;
-					if (!ref.graphqlTypeName) throw new Error(`Directive argument '${ref.name}' requires graphqlTypeName`);
-					this.registerVariableType(ref, ref.graphqlTypeName, false, "directive argument");
+					if (!ref.explicitType) throw new Error(`Cannot infer the type of directive argument '${ref.name}'; an explicit type annotation is required.`);
+					this.registerVariableType(ref, ref.explicitType, false, `${argContext}.${argName}`);
 					t(`${argName}: $${ref.name}`);
 				} else {
 					t(`${argName}: `);
@@ -498,7 +520,7 @@ var SerializeContext = class SerializeContext {
 			}
 		});
 	}
-	acceptLiteral(value, metaType, graphqlTypeName) {
+	acceptLiteral(value, metaType, explicitType) {
 		const t = this.writer.text.bind(this.writer);
 		if (value == null) {
 			t("null");
@@ -518,8 +540,8 @@ var SerializeContext = class SerializeContext {
 		}
 		if (value?.[__marker]) {
 			const ref = value;
-			if (!graphqlTypeName && !ref.graphqlTypeName) throw new Error(`Argument '${ref.name}' nested type cannot be inferred; provide graphqlTypeName`);
-			this.registerVariableType(ref, graphqlTypeName, true, "nested argument");
+			if (!explicitType && !ref.explicitType) throw new Error(`Cannot infer the nested type of argument '${ref.name}'; an explicit type annotation is required.`);
+			this.registerVariableType(ref, explicitType, true, "nested argument");
 			t(`$${ref.name}`);
 			return;
 		}
@@ -528,7 +550,7 @@ var SerializeContext = class SerializeContext {
 			return;
 		}
 		if (Array.isArray(value) || value instanceof Set) {
-			const elementGraphQLTypeName = SerializeContext.elementTypeName(graphqlTypeName);
+			const elementGraphQLTypeName = SerializeContext.elementTypeName(explicitType);
 			this.writer.scope({ type: "array" }, () => {
 				for (const e of value) {
 					this.writer.separator(", ");
@@ -553,12 +575,15 @@ var SerializeContext = class SerializeContext {
 		});
 	}
 	registerVariableType(ref, expectedTypeName, allowImplicitFromRef = false, context = "argument") {
-		const typeName = expectedTypeName ?? (allowImplicitFromRef ? ref.graphqlTypeName : void 0);
-		if (!typeName) throw new Error(`Directive argument '${ref.name}' requires graphqlTypeName`);
-		if (ref.graphqlTypeName && ref.graphqlTypeName !== typeName) throw new Error(`Argument '${ref.name}' type conflict: '${typeName}' vs ParameterRef '${ref.graphqlTypeName}' (${context})`);
+		const typeName = expectedTypeName ?? (allowImplicitFromRef ? ref.explicitType : void 0);
+		if (!typeName) throw new Error(`Cannot infer the type of directive argument '${ref.name}'; an explicit type annotation is required.`);
+		if (ref.explicitType && ref.explicitType !== typeName) throw new Error(`Variable '$${ref.name}' has conflicting GraphQL types at ${context}: inferred '${typeName}', but ParameterRef declares '${ref.explicitType}'`);
 		const existing = this.variableTypeMap.get(ref.name);
-		if (existing && existing !== typeName) throw new Error(`Argument '${ref.name}' type conflict: '${existing}' vs '${typeName}' (${context})`);
-		this.variableTypeMap.set(ref.name, typeName);
+		if (existing && existing.typeName !== typeName) throw new Error(`Variable '$${ref.name}' has conflicting GraphQL types: first '${existing.typeName}' at ${existing.source}, then '${typeName}' at ${context}`);
+		this.variableTypeMap.set(ref.name, {
+			typeName,
+			source: context
+		});
 	}
 	static enumMetaType(meta, typeName) {
 		if (!meta || !typeName) return void 0;
@@ -718,13 +743,15 @@ const createChildSelectionProxy = (schemaType, enumInputMetadata) => {
 		void 0
 	], false, ""), proxyHandler(schemaType));
 };
-const buildRequiredArgs = (argTypeMap) => {
-	if (!argTypeMap.size) return void 0;
-	const requiredArgNames = Array.from(argTypeMap.entries()).filter(([, type]) => type.endsWith("!")).map(([name]) => name);
-	if (!requiredArgNames.length) return void 0;
-	const args = {};
-	for (const name of requiredArgNames) args[name] = ParameterRef.of(name);
-	return args;
+const resolveAutoPropagatedArgs = (declaredArgTypeMap, providedArgs) => {
+	if (!declaredArgTypeMap?.size) return providedArgs;
+	const autoArgs = {};
+	for (const argName of declaredArgTypeMap.keys()) autoArgs[argName] = ParameterRef.of(argName);
+	if (!providedArgs) return autoArgs;
+	return {
+		...autoArgs,
+		...providedArgs
+	};
 };
 const resolveAssociationTarget = (fieldName, fieldTargetTypeName, ownerTypeName) => {
 	if (!fieldTargetTypeName) throw new Error(`Field "${fieldName}" has no target type`);
@@ -791,8 +818,8 @@ const proxyHandler = (schemaType) => {
 					let { args, childSelectionFactory, childSelection } = parseAssociationArgs(argArray);
 					if (childSelectionFactory) childSelection = childSelectionFactory(createChildSelectionProxy(targetSchemaType, target._enumInputMetadata));
 					if (!childSelection) throw new Error(`Field "${p}" requires a child selection`);
-					if (!args) args = buildRequiredArgs(field.argGraphQLTypeMap);
-					return new Proxy(target.addField(p, args, childSelection), handler);
+					const resolvedArgs = resolveAutoPropagatedArgs(field.argGraphQLTypeMap, args);
+					return new Proxy(target.addField(p, resolvedArgs, childSelection), handler);
 				};
 				if (field.isFunction) return new Proxy(DUMMY, methodHandler(target, handler, p));
 				return new Proxy(target.addField(p), handler);
@@ -860,11 +887,9 @@ const methodHandler = (targetSelection, handler, field) => {
 			return new Proxy(current, handler);
 		}
 		let { args, child, optionsValue } = parseMethodArgs(argArray);
-		if (!args) {
-			const argMap = targetSelection.schemaType.ownFields.get(field)?.argGraphQLTypeMap;
-			args = argMap ? buildRequiredArgs(argMap) : void 0;
-		}
-		return new Proxy(targetSelection.addField(field, args, child, optionsValue), handler);
+		const declaredArgTypeMap = targetSelection.schemaType.fields.get(field)?.argGraphQLTypeMap;
+		const resolvedArgs = resolveAutoPropagatedArgs(declaredArgTypeMap, args);
+		return new Proxy(targetSelection.addField(field, resolvedArgs, child, optionsValue), handler);
 	} };
 };
 const DUMMY = () => {};