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

package/README.md

@@ -31,6 +31,7 @@ pnpm add -D graphql typescript
 For advanced usage (Subscription, directives, GraphQL mapping), see:
 
 - [Advanced Usage (Chinese)](./docs/advanced-usage.zh-CN.md)
+- [Runtime Integration Guide (Chinese)](./docs/runtime-integration.zh-CN.md)
 
 ### 1. Vite Plugin (Recommended)
 

package/README.zh-CN.md

@@ -23,6 +23,7 @@ pnpm add -D graphql typescript
 进阶内容（Subscription、指令、GraphQL 对照）见：
 
 - [typedgql 进阶用法（中文）](./docs/advanced-usage.zh-CN.md)
+- [typedgql 运行时接入指南（中文）](./docs/runtime-integration.zh-CN.md)
 
 ### 1. Vite 插件方式（推荐）
 

package/dist/node.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_schema_loader = require('./schema-loader-DbH39jYg.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,QA6XQ,sBAAA;EAAA,QAaA,sCAAA;EAAA,QAuCN,qBAAA;EAAA,QA2EA,iBAAA;EAAA,QAeA,kBAAA;EAAA,QAiBA,cAAA;AAAA;;;iBCtlBY,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,QA6XQ,sBAAA;EAAA,QAaA,sCAAA;EAAA,QAuCN,qBAAA;EAAA,QA2EA,iBAAA;EAAA,QAeA,kBAAA;EAAA,QAiBA,cAAA;AAAA;;;iBCtlBY,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-CtjEVmYv.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"}