@haneullabs/codegen 0.8.2 → 0.8.3

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @mysten/codegen
 
+## 0.8.3
+
+### Patch Changes
+
+- 43e69f8: Add embedded LLM-friendly docs to published packages
+- Updated dependencies [43e69f8]
+- Updated dependencies [e51dc5d]
+  - @mysten/bcs@2.0.3
+  - @mysten/sui@2.8.0
+
 ## 0.8.2
 
 ### Patch Changes

package/README.md

@@ -13,9 +13,9 @@ pnpm install @haneullabs/codegen
 Then create a `haneul-codegen.config.ts` to define what packages you want to generate code for:
 
 ```ts
-import type { SuiCodegenConfig } from './src/config.js';
+import type { HaneulCodegenConfig } from './src/config.js';
 
-const config: SuiCodegenConfig = {
+const config: HaneulCodegenConfig = {
 	output: './src/generated',
 	generateSummaries: true,
 	prune: true,
@@ -32,7 +32,7 @@ export default config;
 
 The `package` field should be the MVR name for your move package. If you have not registered your
 package on MVR yet, you can use the `@local-pkg` scope, and set up an override in your
-`SuiGrpcClient` to resolve it to the correct address.
+`HaneulGrpcClient` to resolve it to the correct address.
 
 ## Generating code
 
@@ -68,13 +68,13 @@ or by adding something the following script to your package.json and running `pn
 ## Setting up Haneul Client with MVR
 
 If your package is registered on MVR, the generated code should work without additional
-configuration. If you are using a `@local-pkg` name, you will need to configure your `SuiGrpcClient`
+configuration. If you are using a `@local-pkg` name, you will need to configure your `HaneulGrpcClient`
 to resolve the package name correctly:
 
 ```ts
-import { SuiGrpcClient } from '@haneullabs/haneul/grpc';
+import { HaneulGrpcClient } from '@haneullabs/haneul/grpc';
 
-const client = new SuiGrpcClient({
+const client = new HaneulGrpcClient({
 	network: 'testnet',
 	baseUrl: 'https://fullnode.testnet.haneul.io:443',
 	mvr: {
@@ -92,7 +92,7 @@ instance:
 
 ```ts
 import { createDAppKit } from '@haneullabs/dapp-kit-core';
-import { SuiGrpcClient } from '@haneullabs/haneul/grpc';
+import { HaneulGrpcClient } from '@haneullabs/haneul/grpc';
 
 const GRPC_URLS = {
 	testnet: 'https://fullnode.testnet.haneul.io:443',
@@ -107,7 +107,7 @@ const PACKAGE_IDS = {
 const dAppKit = createDAppKit({
 	networks: ['testnet'],
 	createClient: (network) => {
-		return new SuiGrpcClient({
+		return new HaneulGrpcClient({
 			network,
 			baseUrl: GRPC_URLS[network],
 			mvr: {
@@ -142,7 +142,7 @@ async function createCounter() {
 	// Add a create call
 	tx.add(counter.create());
 
-	const { digest } = suiClient.signAndExecuteTransaction({
+	const { digest } = haneulClient.signAndExecuteTransaction({
 		transaction: tx,
 		signer: keypair,
 	});
@@ -161,7 +161,7 @@ async function incrementCount(id: string) {
 		}),
 	);
 
-	const { digest } = suiClient.signAndExecuteTransaction({
+	const { digest } = haneulClient.signAndExecuteTransaction({
 		transaction: tx,
 		signer: keypair,
 	});
@@ -180,7 +180,7 @@ First, you will need to load the bcs data for your object, then parse it with yo
 import * as counter from './generated/counter/counter';
 
 async await function readCounter(id: string) {
-	const data = suiClient.getObject({
+	const data = haneulClient.getObject({
 		id,
 		options: {
 			// request the bcs data when loading your object

package/dist/bin/bash-complete.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"bash-complete.d.mts","names":[],"sources":["../../src/bin/bash-complete.ts"],"sourcesContent":[],"mappings":";;iBAqBsB,IAAA,CAAA,GAAI"}
+{"version":3,"file":"bash-complete.d.mts","names":[],"sources":["../../src/bin/bash-complete.ts"],"mappings":";;iBAqBsB,IAAA,CAAA,GAAI,OAAA"}

package/dist/config.d.mts

@@ -1,7 +1,6 @@
 import * as z from "zod/v4";
 
 //#region src/config.d.ts
-
 declare const globalGenerateSchema: z.ZodObject<{
   functions: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
     private: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"entry">]>>;

package/dist/config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config.ts"],"sourcesContent":[],"mappings":";;;;cAwBa,sBAAoB,CAAA,CAAA;;;;;;cAoCpB,qBAAmB,CAAA,CAAA,mBAAA,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAEnB,uBAAqB,CAAA,CAAA,mBAAA,CAAA,CAAA,mBAAA,CAAA,CAAA,mBAAA,CAAA,CAAA;KACtB,eAAA,GAAkB,CAAA,CAAE,aAAa;KAEjC,YAAA,GAAe,CAAA,CAAE,aAAa;AALV,cAUnB,YAVmB,EAUP,CAAA,CAAA,SAVO,CAAA;EAEnB,MAAA,aAAA;EAAqB,KAAA,cAAA,cAAA,aAAA,CAAA,CAAA;EAAA,iBAAA,cAAA,cAAA,aAAA,CAAA,CAAA;EAAA,QAAA,YAAA,WAAA,CAAA,SAAA,YAAA,CAAA;IAAA,OAAA,aAAA;IAAA,WAAA,aAAA;IACtB,IAAA,eAAe,WAAkB,CAAA;IAEjC,OAAA,WAAY,CAAA;MAKX,OAUX,EAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAEU,aAAA,GAAgB,CAAA,CAAE,aAAa;KAC/B,mBAAA,GAAsB,CAAA,CAAE,aAAa"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config.ts"],"mappings":";;;cAwBa,oBAAA,EAAoB,CAAA,CAAA,SAAA;;;;;;cAoCpB,mBAAA,EAAmB,CAAA,CAAA,QAAA,WAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAEnB,qBAAA,EAAqB,CAAA,CAAA,QAAA,WAAA,CAAA,CAAA,UAAA,SAAA,CAAA,CAAA,UAAA,SAAA,CAAA,CAAA,UAAA;AAAA,KACtB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,qBAAA;AAAA,KAEjC,YAAA,GAAe,CAAA,CAAE,KAAA,QAAa,oBAAA;AAAA,cAK7B,YAAA,EAAY,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAYb,aAAA,GAAgB,CAAA,CAAE,KAAA,QAAa,mBAAA;AAAA,KAC/B,mBAAA,GAAsB,CAAA,CAAE,KAAA,QAAa,YAAA"}

package/dist/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { isValidNamedPackage, isValidHaneulObjectId } from '@haneullabs/haneul/utils';\nimport { cosmiconfig } from 'cosmiconfig';\nimport * as z from 'zod/v4';\n\nexport const globalFunctionsOptionSchema = z.union([\n\tz.boolean(),\n\tz.object({\n\t\tprivate: z.union([z.boolean(), z.literal('entry')]).optional(),\n\t}),\n]);\n\nexport const functionsOptionSchema = z.union([\n\tz.boolean(),\n\tz.array(z.string()),\n\tz.object({\n\t\tprivate: z.union([z.boolean(), z.literal('entry')]).optional(),\n\t}),\n]);\n\nexport const typesOptionSchema = z.union([z.boolean(), z.array(z.string())]);\n\nexport const globalGenerateSchema = z.object({\n\tfunctions: globalFunctionsOptionSchema.optional(),\n\ttypes: z.boolean().optional(),\n});\n\nexport const moduleGenerateSchema = z.object({\n\tfunctions: functionsOptionSchema.optional(),\n\ttypes: typesOptionSchema.optional(),\n});\n\nexport const packageGenerateSchema = globalGenerateSchema.extend({\n\tmodules: z\n\t\t.union([\n\t\t\tz.array(z.string()),\n\t\t\tz.record(z.string(), z.union([z.literal(true), moduleGenerateSchema])),\n\t\t])\n\t\t.optional(),\n});\n\nexport const onChainPackageSchema = z.object({\n\tpackage: z.string().refine((name) => isValidNamedPackage(name) || isValidHaneulObjectId(name), {\n\t\tmessage: 'Invalid package name or package ID',\n\t}),\n\tpackageName: z.string(),\n\tpath: z.never().optional(),\n\tnetwork: z.enum(['mainnet', 'testnet']),\n\tgenerate: packageGenerateSchema.optional(),\n});\n\nexport const localPackageSchema = z.object({\n\tpath: z.string(),\n\tpackage: z.string(),\n\tpackageName: z.string().optional(),\n\tgenerate: packageGenerateSchema.optional(),\n});\n\nexport const packageConfigSchema = z.union([onChainPackageSchema, localPackageSchema]);\n\nexport const importExtensionSchema = z.union([z.literal('.js'), z.literal('.ts'), z.literal('')]);\nexport type ImportExtension = z.infer<typeof importExtensionSchema>;\n\nexport type GenerateBase = z.infer<typeof globalGenerateSchema>;\nexport type PackageGenerate = z.infer<typeof packageGenerateSchema>;\nexport type FunctionsOption = z.infer<typeof functionsOptionSchema>;\nexport type TypesOption = z.infer<typeof typesOptionSchema>;\n\nexport const configSchema = z.object({\n\toutput: z.string(),\n\tprune: z.boolean().optional().default(true),\n\tgenerateSummaries: z.boolean().optional().default(true),\n\tpackages: z.array(packageConfigSchema),\n\tgenerate: globalGenerateSchema.optional(),\n\t/** @deprecated Use `generate: { functions: { private: 'entry' } }` instead */\n\tprivateMethods: z.union([z.literal('none'), z.literal('entry'), z.literal('all')]).optional(),\n\timportExtension: importExtensionSchema.optional().default('.js'),\n\tincludePhantomTypeParameters: z.boolean().optional().default(false),\n});\n\nexport type PackageConfig = z.infer<typeof packageConfigSchema>;\nexport type HaneulCodegenConfig = z.input<typeof configSchema>;\nexport type ParsedSuiCodegenConfig = z.infer<typeof configSchema>;\n\nexport async function loadConfig(): Promise<ParsedSuiCodegenConfig> {\n\tconst config = await cosmiconfig('haneul-codegen').search();\n\n\tif (!config) {\n\t\treturn {\n\t\t\toutput: './generated',\n\t\t\tpackages: [],\n\t\t\tprune: true,\n\t\t\tgenerateSummaries: true,\n\t\t\timportExtension: '.js',\n\t\t\tincludePhantomTypeParameters: false,\n\t\t};\n\t}\n\n\treturn configSchema.parse(config.config);\n}\n"],"mappings":";;;;;AAOA,MAAa,8BAA8B,EAAE,MAAM,CAClD,EAAE,SAAS,EACX,EAAE,OAAO,EACR,SAAS,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,QAAQ,CAAC,CAAC,CAAC,UAAU,EAC9D,CAAC,CACF,CAAC;AAEF,MAAa,wBAAwB,EAAE,MAAM;CAC5C,EAAE,SAAS;CACX,EAAE,MAAM,EAAE,QAAQ,CAAC;CACnB,EAAE,OAAO,EACR,SAAS,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,QAAQ,CAAC,CAAC,CAAC,UAAU,EAC9D,CAAC;CACF,CAAC;AAEF,MAAa,oBAAoB,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE5E,MAAa,uBAAuB,EAAE,OAAO;CAC5C,WAAW,4BAA4B,UAAU;CACjD,OAAO,EAAE,SAAS,CAAC,UAAU;CAC7B,CAAC;AAEF,MAAa,uBAAuB,EAAE,OAAO;CAC5C,WAAW,sBAAsB,UAAU;CAC3C,OAAO,kBAAkB,UAAU;CACnC,CAAC;AAEF,MAAa,wBAAwB,qBAAqB,OAAO,EAChE,SAAS,EACP,MAAM,CACN,EAAE,MAAM,EAAE,QAAQ,CAAC,EACnB,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,KAAK,EAAE,qBAAqB,CAAC,CAAC,CACtE,CAAC,CACD,UAAU,EACZ,CAAC;AAEF,MAAa,uBAAuB,EAAE,OAAO;CAC5C,SAAS,EAAE,QAAQ,CAAC,QAAQ,SAAS,oBAAoB,KAAK,IAAI,sBAAsB,KAAK,EAAE,EAC9F,SAAS,sCACT,CAAC;CACF,aAAa,EAAE,QAAQ;CACvB,MAAM,EAAE,OAAO,CAAC,UAAU;CAC1B,SAAS,EAAE,KAAK,CAAC,WAAW,UAAU,CAAC;CACvC,UAAU,sBAAsB,UAAU;CAC1C,CAAC;AAEF,MAAa,qBAAqB,EAAE,OAAO;CAC1C,MAAM,EAAE,QAAQ;CAChB,SAAS,EAAE,QAAQ;CACnB,aAAa,EAAE,QAAQ,CAAC,UAAU;CAClC,UAAU,sBAAsB,UAAU;CAC1C,CAAC;AAEF,MAAa,sBAAsB,EAAE,MAAM,CAAC,sBAAsB,mBAAmB,CAAC;AAEtF,MAAa,wBAAwB,EAAE,MAAM;CAAC,EAAE,QAAQ,MAAM;CAAE,EAAE,QAAQ,MAAM;CAAE,EAAE,QAAQ,GAAG;CAAC,CAAC;AAQjG,MAAa,eAAe,EAAE,OAAO;CACpC,QAAQ,EAAE,QAAQ;CAClB,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;CAC3C,mBAAmB,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;CACvD,UAAU,EAAE,MAAM,oBAAoB;CACtC,UAAU,qBAAqB,UAAU;CAEzC,gBAAgB,EAAE,MAAM;EAAC,EAAE,QAAQ,OAAO;EAAE,EAAE,QAAQ,QAAQ;EAAE,EAAE,QAAQ,MAAM;EAAC,CAAC,CAAC,UAAU;CAC7F,iBAAiB,sBAAsB,UAAU,CAAC,QAAQ,MAAM;CAChE,8BAA8B,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,MAAM;CACnE,CAAC;AAMF,eAAsB,aAA8C;CACnE,MAAM,SAAS,MAAM,YAAY,iBAAiB,CAAC,QAAQ;AAE3D,KAAI,CAAC,OACJ,QAAO;EACN,QAAQ;EACR,UAAU,EAAE;EACZ,OAAO;EACP,mBAAmB;EACnB,iBAAiB;EACjB,8BAA8B;EAC9B;AAGF,QAAO,aAAa,MAAM,OAAO,OAAO"}
+{"version":3,"file":"config.mjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { isValidNamedPackage, isValidHaneulObjectId } from '@haneullabs/haneul/utils';\nimport { cosmiconfig } from 'cosmiconfig';\nimport * as z from 'zod/v4';\n\nexport const globalFunctionsOptionSchema = z.union([\n\tz.boolean(),\n\tz.object({\n\t\tprivate: z.union([z.boolean(), z.literal('entry')]).optional(),\n\t}),\n]);\n\nexport const functionsOptionSchema = z.union([\n\tz.boolean(),\n\tz.array(z.string()),\n\tz.object({\n\t\tprivate: z.union([z.boolean(), z.literal('entry')]).optional(),\n\t}),\n]);\n\nexport const typesOptionSchema = z.union([z.boolean(), z.array(z.string())]);\n\nexport const globalGenerateSchema = z.object({\n\tfunctions: globalFunctionsOptionSchema.optional(),\n\ttypes: z.boolean().optional(),\n});\n\nexport const moduleGenerateSchema = z.object({\n\tfunctions: functionsOptionSchema.optional(),\n\ttypes: typesOptionSchema.optional(),\n});\n\nexport const packageGenerateSchema = globalGenerateSchema.extend({\n\tmodules: z\n\t\t.union([\n\t\t\tz.array(z.string()),\n\t\t\tz.record(z.string(), z.union([z.literal(true), moduleGenerateSchema])),\n\t\t])\n\t\t.optional(),\n});\n\nexport const onChainPackageSchema = z.object({\n\tpackage: z.string().refine((name) => isValidNamedPackage(name) || isValidHaneulObjectId(name), {\n\t\tmessage: 'Invalid package name or package ID',\n\t}),\n\tpackageName: z.string(),\n\tpath: z.never().optional(),\n\tnetwork: z.enum(['mainnet', 'testnet']),\n\tgenerate: packageGenerateSchema.optional(),\n});\n\nexport const localPackageSchema = z.object({\n\tpath: z.string(),\n\tpackage: z.string(),\n\tpackageName: z.string().optional(),\n\tgenerate: packageGenerateSchema.optional(),\n});\n\nexport const packageConfigSchema = z.union([onChainPackageSchema, localPackageSchema]);\n\nexport const importExtensionSchema = z.union([z.literal('.js'), z.literal('.ts'), z.literal('')]);\nexport type ImportExtension = z.infer<typeof importExtensionSchema>;\n\nexport type GenerateBase = z.infer<typeof globalGenerateSchema>;\nexport type PackageGenerate = z.infer<typeof packageGenerateSchema>;\nexport type FunctionsOption = z.infer<typeof functionsOptionSchema>;\nexport type TypesOption = z.infer<typeof typesOptionSchema>;\n\nexport const configSchema = z.object({\n\toutput: z.string(),\n\tprune: z.boolean().optional().default(true),\n\tgenerateSummaries: z.boolean().optional().default(true),\n\tpackages: z.array(packageConfigSchema),\n\tgenerate: globalGenerateSchema.optional(),\n\t/** @deprecated Use `generate: { functions: { private: 'entry' } }` instead */\n\tprivateMethods: z.union([z.literal('none'), z.literal('entry'), z.literal('all')]).optional(),\n\timportExtension: importExtensionSchema.optional().default('.js'),\n\tincludePhantomTypeParameters: z.boolean().optional().default(false),\n});\n\nexport type PackageConfig = z.infer<typeof packageConfigSchema>;\nexport type HaneulCodegenConfig = z.input<typeof configSchema>;\nexport type ParsedHaneulCodegenConfig = z.infer<typeof configSchema>;\n\nexport async function loadConfig(): Promise<ParsedHaneulCodegenConfig> {\n\tconst config = await cosmiconfig('haneul-codegen').search();\n\n\tif (!config) {\n\t\treturn {\n\t\t\toutput: './generated',\n\t\t\tpackages: [],\n\t\t\tprune: true,\n\t\t\tgenerateSummaries: true,\n\t\t\timportExtension: '.js',\n\t\t\tincludePhantomTypeParameters: false,\n\t\t};\n\t}\n\n\treturn configSchema.parse(config.config);\n}\n"],"mappings":";;;;;AAOA,MAAa,8BAA8B,EAAE,MAAM,CAClD,EAAE,SAAS,EACX,EAAE,OAAO,EACR,SAAS,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,QAAQ,CAAC,CAAC,CAAC,UAAU,EAC9D,CAAC,CACF,CAAC;AAEF,MAAa,wBAAwB,EAAE,MAAM;CAC5C,EAAE,SAAS;CACX,EAAE,MAAM,EAAE,QAAQ,CAAC;CACnB,EAAE,OAAO,EACR,SAAS,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,QAAQ,CAAC,CAAC,CAAC,UAAU,EAC9D,CAAC;CACF,CAAC;AAEF,MAAa,oBAAoB,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE5E,MAAa,uBAAuB,EAAE,OAAO;CAC5C,WAAW,4BAA4B,UAAU;CACjD,OAAO,EAAE,SAAS,CAAC,UAAU;CAC7B,CAAC;AAEF,MAAa,uBAAuB,EAAE,OAAO;CAC5C,WAAW,sBAAsB,UAAU;CAC3C,OAAO,kBAAkB,UAAU;CACnC,CAAC;AAEF,MAAa,wBAAwB,qBAAqB,OAAO,EAChE,SAAS,EACP,MAAM,CACN,EAAE,MAAM,EAAE,QAAQ,CAAC,EACnB,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,KAAK,EAAE,qBAAqB,CAAC,CAAC,CACtE,CAAC,CACD,UAAU,EACZ,CAAC;AAEF,MAAa,uBAAuB,EAAE,OAAO;CAC5C,SAAS,EAAE,QAAQ,CAAC,QAAQ,SAAS,oBAAoB,KAAK,IAAI,sBAAsB,KAAK,EAAE,EAC9F,SAAS,sCACT,CAAC;CACF,aAAa,EAAE,QAAQ;CACvB,MAAM,EAAE,OAAO,CAAC,UAAU;CAC1B,SAAS,EAAE,KAAK,CAAC,WAAW,UAAU,CAAC;CACvC,UAAU,sBAAsB,UAAU;CAC1C,CAAC;AAEF,MAAa,qBAAqB,EAAE,OAAO;CAC1C,MAAM,EAAE,QAAQ;CAChB,SAAS,EAAE,QAAQ;CACnB,aAAa,EAAE,QAAQ,CAAC,UAAU;CAClC,UAAU,sBAAsB,UAAU;CAC1C,CAAC;AAEF,MAAa,sBAAsB,EAAE,MAAM,CAAC,sBAAsB,mBAAmB,CAAC;AAEtF,MAAa,wBAAwB,EAAE,MAAM;CAAC,EAAE,QAAQ,MAAM;CAAE,EAAE,QAAQ,MAAM;CAAE,EAAE,QAAQ,GAAG;CAAC,CAAC;AAQjG,MAAa,eAAe,EAAE,OAAO;CACpC,QAAQ,EAAE,QAAQ;CAClB,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;CAC3C,mBAAmB,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;CACvD,UAAU,EAAE,MAAM,oBAAoB;CACtC,UAAU,qBAAqB,UAAU;CAEzC,gBAAgB,EAAE,MAAM;EAAC,EAAE,QAAQ,OAAO;EAAE,EAAE,QAAQ,QAAQ;EAAE,EAAE,QAAQ,MAAM;EAAC,CAAC,CAAC,UAAU;CAC7F,iBAAiB,sBAAsB,UAAU,CAAC,QAAQ,MAAM;CAChE,8BAA8B,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,MAAM;CACnE,CAAC;AAMF,eAAsB,aAAiD;CACtE,MAAM,SAAS,MAAM,YAAY,iBAAiB,CAAC,QAAQ;AAE3D,KAAI,CAAC,OACJ,QAAO;EACN,QAAQ;EACR,UAAU,EAAE;EACZ,OAAO;EACP,mBAAmB;EACnB,iBAAiB;EACjB,8BAA8B;EAC9B;AAGF,QAAO,aAAa,MAAM,OAAO,OAAO"}

package/dist/file-builder.mjs

@@ -36,6 +36,7 @@ var FileBuilder = class {
 			deConflictedName = `${name}_${i}`;
 			i++;
 		}
+		this.reservedNames.add(deConflictedName);
 		return deConflictedName;
 	}
 	async getHeader() {

package/dist/file-builder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"file-builder.mjs","names":[],"sources":["../src/file-builder.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type ts from 'typescript';\nimport { parseTS, printNodes } from './utils.js';\nimport { relative, resolve } from 'path';\nimport { getSafeName } from './render-types.js';\n\nexport class FileBuilder {\n\tstatements: ts.Statement[] = [];\n\texports: string[] = [];\n\timports: Map<string, Set<string>> = new Map();\n\tstarImports: Map<string, string> = new Map();\n\tprotected reservedNames: Set<string> = new Set();\n\n\taddImport(module: string, name: string): string {\n\t\tif (!this.imports.has(module)) {\n\t\t\tthis.imports.set(module, new Set());\n\t\t}\n\n\t\tconst isTypeImport = name.startsWith('type ');\n\t\tconst baseName = isTypeImport ? name.slice(5) : name;\n\n\t\tif (this.reservedNames.has(baseName)) {\n\t\t\tconst alias = this.getUnusedName(baseName);\n\t\t\tconst aliasedImport = isTypeImport\n\t\t\t\t? `type ${baseName} as ${alias}`\n\t\t\t\t: `${baseName} as ${alias}`;\n\t\t\tthis.imports.get(module)!.add(aliasedImport);\n\t\t\treturn alias;\n\t\t}\n\n\t\tthis.imports.get(module)!.add(name);\n\t\treturn baseName;\n\t}\n\n\taddStarImport(module: string, name: string) {\n\t\tconst importName = this.getUnusedName(name);\n\t\tthis.starImports.set(importName, module);\n\t\treturn importName;\n\t}\n\n\tgetUnusedName(name: string) {\n\t\tlet deConflictedName = getSafeName(name);\n\n\t\tlet i = 1;\n\t\twhile (this.reservedNames.has(deConflictedName)) {\n\t\t\tdeConflictedName = `${name}_${i}`;\n\t\t\ti++;\n\t\t}\n\n\t\treturn deConflictedName;\n\t}\n\n\tasync getHeader() {\n\t\treturn [\n\t\t\t'/**************************************************************',\n\t\t\t' * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *',\n\t\t\t' **************************************************************/',\n\t\t\t'',\n\t\t].join('\\n');\n\t}\n\n\tasync toString(modDir: string, filePath: string) {\n\t\tconst importStatements = [...this.imports.entries()].flatMap(\n\t\t\t([module, names]) =>\n\t\t\t\tparseTS`import { ${[...names].join(', ')} } from '${modulePath(module)}'`,\n\t\t);\n\t\tconst starImportStatements = [...this.starImports.entries()].flatMap(\n\t\t\t([name, module]) => parseTS`import * as ${name} from '${modulePath(module)}'`,\n\t\t);\n\n\t\treturn `${await this.getHeader()}${printNodes(...importStatements, ...starImportStatements, ...this.statements)}`;\n\n\t\tfunction modulePath(mod: string) {\n\t\t\tif (!mod.startsWith('~root/')) {\n\t\t\t\treturn mod;\n\t\t\t}\n\n\t\t\tconst sourcePath = resolve(modDir, filePath);\n\t\t\tconst destPath = resolve(modDir, mod.replace('~root/', './'));\n\t\t\tconst sourceDirectory = sourcePath.split('/').slice(0, -1).join('/');\n\t\t\tconst relativePath = relative(sourceDirectory, destPath);\n\t\t\treturn relativePath.startsWith('.') ? relativePath : `./${relativePath}`;\n\t\t}\n\t}\n}\n"],"mappings":";;;;;AAQA,IAAa,cAAb,MAAyB;;oBACK,EAAE;iBACX,EAAE;iCACc,IAAI,KAAK;qCACV,IAAI,KAAK;uCACL,IAAI,KAAK;;CAEhD,UAAU,QAAgB,MAAsB;AAC/C,MAAI,CAAC,KAAK,QAAQ,IAAI,OAAO,CAC5B,MAAK,QAAQ,IAAI,wBAAQ,IAAI,KAAK,CAAC;EAGpC,MAAM,eAAe,KAAK,WAAW,QAAQ;EAC7C,MAAM,WAAW,eAAe,KAAK,MAAM,EAAE,GAAG;AAEhD,MAAI,KAAK,cAAc,IAAI,SAAS,EAAE;GACrC,MAAM,QAAQ,KAAK,cAAc,SAAS;GAC1C,MAAM,gBAAgB,eACnB,QAAQ,SAAS,MAAM,UACvB,GAAG,SAAS,MAAM;AACrB,QAAK,QAAQ,IAAI,OAAO,CAAE,IAAI,cAAc;AAC5C,UAAO;;AAGR,OAAK,QAAQ,IAAI,OAAO,CAAE,IAAI,KAAK;AACnC,SAAO;;CAGR,cAAc,QAAgB,MAAc;EAC3C,MAAM,aAAa,KAAK,cAAc,KAAK;AAC3C,OAAK,YAAY,IAAI,YAAY,OAAO;AACxC,SAAO;;CAGR,cAAc,MAAc;EAC3B,IAAI,mBAAmB,YAAY,KAAK;EAExC,IAAI,IAAI;AACR,SAAO,KAAK,cAAc,IAAI,iBAAiB,EAAE;AAChD,sBAAmB,GAAG,KAAK,GAAG;AAC9B;;AAGD,SAAO;;CAGR,MAAM,YAAY;AACjB,SAAO;GACN;GACA;GACA;GACA;GACA,CAAC,KAAK,KAAK;;CAGb,MAAM,SAAS,QAAgB,UAAkB;EAChD,MAAM,mBAAmB,CAAC,GAAG,KAAK,QAAQ,SAAS,CAAC,CAAC,SACnD,CAAC,QAAQ,WACT,OAAO,YAAY,CAAC,GAAG,MAAM,CAAC,KAAK,KAAK,CAAC,WAAW,WAAW,OAAO,CAAC,GACxE;EACD,MAAM,uBAAuB,CAAC,GAAG,KAAK,YAAY,SAAS,CAAC,CAAC,SAC3D,CAAC,MAAM,YAAY,OAAO,eAAe,KAAK,SAAS,WAAW,OAAO,CAAC,GAC3E;AAED,SAAO,GAAG,MAAM,KAAK,WAAW,GAAG,WAAW,GAAG,kBAAkB,GAAG,sBAAsB,GAAG,KAAK,WAAW;EAE/G,SAAS,WAAW,KAAa;AAChC,OAAI,CAAC,IAAI,WAAW,SAAS,CAC5B,QAAO;GAGR,MAAM,aAAa,QAAQ,QAAQ,SAAS;GAC5C,MAAM,WAAW,QAAQ,QAAQ,IAAI,QAAQ,UAAU,KAAK,CAAC;GAE7D,MAAM,eAAe,SADG,WAAW,MAAM,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,KAAK,IAAI,EACrB,SAAS;AACxD,UAAO,aAAa,WAAW,IAAI,GAAG,eAAe,KAAK"}
+{"version":3,"file":"file-builder.mjs","names":[],"sources":["../src/file-builder.ts"],"sourcesContent":["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type ts from 'typescript';\nimport { parseTS, printNodes } from './utils.js';\nimport { relative, resolve } from 'path';\nimport { getSafeName } from './render-types.js';\n\nexport class FileBuilder {\n\tstatements: ts.Statement[] = [];\n\texports: string[] = [];\n\timports: Map<string, Set<string>> = new Map();\n\tstarImports: Map<string, string> = new Map();\n\tprotected reservedNames: Set<string> = new Set();\n\n\taddImport(module: string, name: string): string {\n\t\tif (!this.imports.has(module)) {\n\t\t\tthis.imports.set(module, new Set());\n\t\t}\n\n\t\tconst isTypeImport = name.startsWith('type ');\n\t\tconst baseName = isTypeImport ? name.slice(5) : name;\n\n\t\tif (this.reservedNames.has(baseName)) {\n\t\t\tconst alias = this.getUnusedName(baseName);\n\t\t\tconst aliasedImport = isTypeImport\n\t\t\t\t? `type ${baseName} as ${alias}`\n\t\t\t\t: `${baseName} as ${alias}`;\n\t\t\tthis.imports.get(module)!.add(aliasedImport);\n\t\t\treturn alias;\n\t\t}\n\n\t\tthis.imports.get(module)!.add(name);\n\t\treturn baseName;\n\t}\n\n\taddStarImport(module: string, name: string) {\n\t\tconst importName = this.getUnusedName(name);\n\t\tthis.starImports.set(importName, module);\n\t\treturn importName;\n\t}\n\n\tgetUnusedName(name: string) {\n\t\tlet deConflictedName = getSafeName(name);\n\n\t\tlet i = 1;\n\t\twhile (this.reservedNames.has(deConflictedName)) {\n\t\t\tdeConflictedName = `${name}_${i}`;\n\t\t\ti++;\n\t\t}\n\n\t\tthis.reservedNames.add(deConflictedName);\n\t\treturn deConflictedName;\n\t}\n\n\tasync getHeader() {\n\t\treturn [\n\t\t\t'/**************************************************************',\n\t\t\t' * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *',\n\t\t\t' **************************************************************/',\n\t\t\t'',\n\t\t].join('\\n');\n\t}\n\n\tasync toString(modDir: string, filePath: string) {\n\t\tconst importStatements = [...this.imports.entries()].flatMap(\n\t\t\t([module, names]) =>\n\t\t\t\tparseTS`import { ${[...names].join(', ')} } from '${modulePath(module)}'`,\n\t\t);\n\t\tconst starImportStatements = [...this.starImports.entries()].flatMap(\n\t\t\t([name, module]) => parseTS`import * as ${name} from '${modulePath(module)}'`,\n\t\t);\n\n\t\treturn `${await this.getHeader()}${printNodes(...importStatements, ...starImportStatements, ...this.statements)}`;\n\n\t\tfunction modulePath(mod: string) {\n\t\t\tif (!mod.startsWith('~root/')) {\n\t\t\t\treturn mod;\n\t\t\t}\n\n\t\t\tconst sourcePath = resolve(modDir, filePath);\n\t\t\tconst destPath = resolve(modDir, mod.replace('~root/', './'));\n\t\t\tconst sourceDirectory = sourcePath.split('/').slice(0, -1).join('/');\n\t\t\tconst relativePath = relative(sourceDirectory, destPath);\n\t\t\treturn relativePath.startsWith('.') ? relativePath : `./${relativePath}`;\n\t\t}\n\t}\n}\n"],"mappings":";;;;;AAQA,IAAa,cAAb,MAAyB;;oBACK,EAAE;iBACX,EAAE;iCACc,IAAI,KAAK;qCACV,IAAI,KAAK;uCACL,IAAI,KAAK;;CAEhD,UAAU,QAAgB,MAAsB;AAC/C,MAAI,CAAC,KAAK,QAAQ,IAAI,OAAO,CAC5B,MAAK,QAAQ,IAAI,wBAAQ,IAAI,KAAK,CAAC;EAGpC,MAAM,eAAe,KAAK,WAAW,QAAQ;EAC7C,MAAM,WAAW,eAAe,KAAK,MAAM,EAAE,GAAG;AAEhD,MAAI,KAAK,cAAc,IAAI,SAAS,EAAE;GACrC,MAAM,QAAQ,KAAK,cAAc,SAAS;GAC1C,MAAM,gBAAgB,eACnB,QAAQ,SAAS,MAAM,UACvB,GAAG,SAAS,MAAM;AACrB,QAAK,QAAQ,IAAI,OAAO,CAAE,IAAI,cAAc;AAC5C,UAAO;;AAGR,OAAK,QAAQ,IAAI,OAAO,CAAE,IAAI,KAAK;AACnC,SAAO;;CAGR,cAAc,QAAgB,MAAc;EAC3C,MAAM,aAAa,KAAK,cAAc,KAAK;AAC3C,OAAK,YAAY,IAAI,YAAY,OAAO;AACxC,SAAO;;CAGR,cAAc,MAAc;EAC3B,IAAI,mBAAmB,YAAY,KAAK;EAExC,IAAI,IAAI;AACR,SAAO,KAAK,cAAc,IAAI,iBAAiB,EAAE;AAChD,sBAAmB,GAAG,KAAK,GAAG;AAC9B;;AAGD,OAAK,cAAc,IAAI,iBAAiB;AACxC,SAAO;;CAGR,MAAM,YAAY;AACjB,SAAO;GACN;GACA;GACA;GACA;GACA,CAAC,KAAK,KAAK;;CAGb,MAAM,SAAS,QAAgB,UAAkB;EAChD,MAAM,mBAAmB,CAAC,GAAG,KAAK,QAAQ,SAAS,CAAC,CAAC,SACnD,CAAC,QAAQ,WACT,OAAO,YAAY,CAAC,GAAG,MAAM,CAAC,KAAK,KAAK,CAAC,WAAW,WAAW,OAAO,CAAC,GACxE;EACD,MAAM,uBAAuB,CAAC,GAAG,KAAK,YAAY,SAAS,CAAC,CAAC,SAC3D,CAAC,MAAM,YAAY,OAAO,eAAe,KAAK,SAAS,WAAW,OAAO,CAAC,GAC3E;AAED,SAAO,GAAG,MAAM,KAAK,WAAW,GAAG,WAAW,GAAG,kBAAkB,GAAG,sBAAsB,GAAG,KAAK,WAAW;EAE/G,SAAS,WAAW,KAAa;AAChC,OAAI,CAAC,IAAI,WAAW,SAAS,CAC5B,QAAO;GAGR,MAAM,aAAa,QAAQ,QAAQ,SAAS;GAC5C,MAAM,WAAW,QAAQ,QAAQ,IAAI,QAAQ,UAAU,KAAK,CAAC;GAE7D,MAAM,eAAe,SADG,WAAW,MAAM,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,KAAK,IAAI,EACrB,SAAS;AACxD,UAAO,aAAa,WAAW,IAAI,GAAG,eAAe,KAAK"}

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;iBAmBsB,0BAAA;WACZ;;;;;;;EADY,OAAA,EAQZ,aARY;EACZ,KAAA,EAAA,OAAA;EACT,SAAA,EAAA,MAAA;EACA,cAAA,CAAA,EAQiB,YARjB;EACA,eAAA,CAAA,EAQkB,eARlB;EACA,4BAAA,CAAA,EAAA,OAAA;CACA,CAAA,EAQA,OARA,CAAA,IAAA,CAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;iBAmBsB,0BAAA,CAAA;EACrB,OAAA,EAAS,GAAA;EACT,KAAA;EACA,SAAA;EACA,cAAA;EACA,eAAA;EACA;AAAA;EAEA,OAAA,EAAS,aAAA;EACT,KAAA;EACA,SAAA;EACA,cAAA,GAAiB,YAAA;EACjB,eAAA,GAAkB,eAAA;EAClB,4BAAA;AAAA,IACA,OAAA"}

package/docs/index.md

@@ -0,0 +1,436 @@
+# Haneul TypeScript Codegen
+
+> Generate type-safe TypeScript bindings from on-chain Haneul Move packages
+
+The `@haneullabs/codegen` package automatically generates type-safe TypeScript code from your Move
+packages, enabling seamless interaction with your smart contracts from TypeScript applications.
+
+> **Warning:** This package is currently in development and may have breaking changes.
+
+## Features
+
+- **Type-safe Move calls**: Generate TypeScript functions with full type safety for calling your
+  Move functions
+- **BCS type definitions**: Automatic BCS struct definitions for parsing on-chain data
+- **Auto-completion**: IDE support with intelligent code completion for Move function arguments
+- **Package resolution**: Support for both MVR-registered packages and local packages
+
+## Installation
+
+Install the codegen package as a dev dependency:
+
+```sh npm2yarn
+npm install -D @haneullabs/codegen
+```
+
+## Quick Start
+
+### 1. Create a configuration file
+
+Create a `haneul-codegen.config.ts` file in your project root:
+
+```typescript
+const config: HaneulCodegenConfig = {
+	output: './src/contracts',
+	packages: [
+		{
+			package: '@local-pkg/counter',
+			path: './move/counter',
+		},
+	],
+};
+```
+
+### 2. Generate TypeScript code
+
+Add a script to your `package.json`:
+
+```json
+{
+	"scripts": {
+		"codegen": "haneul-ts-codegen generate"
+	}
+}
+```
+
+Then run:
+
+```bash
+pnpm codegen
+```
+
+This generates TypeScript code in your configured output directory (e.g., `./src/contracts`).
+
+## Configuration Options
+
+The `HaneulCodegenConfig` type supports the following options:
+
+| Option                         | Type                   | Default | Description                                                                                                                                                           |
+| ------------------------------ | ---------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `output`                       | `string`               | —       | The directory where generated code will be written                                                                                                                    |
+| `packages`                     | `PackageConfig[]`      | —       | Array of Move packages to generate code for                                                                                                                           |
+| `prune`                        | `boolean`              | `true`  | When enabled, only generates code for the main package and omits dependency modules (dependency types referenced by included types are still generated under `deps/`) |
+| `generateSummaries`            | `boolean`              | `true`  | Automatically run `haneul move summary` before generating code. Creates a `package_summaries` directory in your Move package which can be added to `.gitignore`       |
+| `generate`                     | `GenerateOptions`      | —       | Default [generate options](#the-generate-option) (types, functions) for all packages                                                                                  |
+| `importExtension`              | `'.js' \| '.ts' \| ''` | `'.js'` | File extension used in generated import statements                                                                                                                    |
+| `includePhantomTypeParameters` | `boolean`              | `false` | Include [phantom type parameters](#phantom-types) as function arguments in generated BCS types                                                                        |
+
+### Package Configuration
+
+Each entry in the `packages` array configures a Move package to generate code from. Packages can be
+local (from source) or on-chain (fetched from a network).
+
+#### Local Packages
+
+| Option        | Type                     | Required | Description                                        |
+| ------------- | ------------------------ | -------- | -------------------------------------------------- |
+| `package`     | `string`                 | yes      | Package identifier (e.g., `@local-pkg/my-package`) |
+| `path`        | `string`                 | yes      | Path to the Move package directory                 |
+| `packageName` | `string`                 | no       | Custom name for generated code directory           |
+| `generate`    | `PackageGenerateOptions` | no       | Control what gets generated from this package      |
+
+```typescript
+{
+  package: '@local-pkg/my-package',
+  path: './move/my-package',
+}
+```
+
+#### On-Chain Packages
+
+For packages already deployed on-chain, generate code directly from a package ID or MVR name without
+needing local source code:
+
+| Option        | Type                     | Required | Description                                   |
+| ------------- | ------------------------ | -------- | --------------------------------------------- |
+| `package`     | `string`                 | yes      | Package ID or MVR name                        |
+| `packageName` | `string`                 | yes      | Name for the generated code directory         |
+| `network`     | `'mainnet' \| 'testnet'` | yes      | Network to fetch the package from             |
+| `generate`    | `PackageGenerateOptions` | no       | Control what gets generated from this package |
+
+```typescript
+{
+  package: '0xabf837e98c26087cba0883c0a7a28326b1fa3c5e1e2c5abdb486f9e8f594c837',
+  packageName: 'pyth',
+  network: 'testnet',
+}
+```
+
+## The `generate` option
+
+The `generate` option controls what code is produced. It can be set at the global level (as a
+default for all packages), at the per-package level, and at the per-module level. More specific
+settings override less specific ones.
+
+When no `generate` option is set, everything is generated (all types and functions). Package-level
+`types` and `functions` also default to `true`. In the record form of `modules`, per-module `types`
+and `functions` default to `false` — you opt in to exactly what you need from each module. Use
+`true` as a shorthand to include everything from a module with package-level defaults.
+
+At the **global** and **package** levels, `types` and `functions` only accept boolean values (or an
+object for `functions`). Name-based filtering with `string[]` is only available at the **module**
+level inside the record form of `modules`, where the filter applies unambiguously to a single
+module.
+
+```typescript
+// Global or package level
+generate: {
+  types: true | false,
+  functions: true | false | { private: boolean | 'entry' },
+  modules: string[] | Record<string, true | { types?, functions? }>,  // package-level only
+}
+
+// Module level (inside the record form of modules)
+modules: {
+  my_module: true,  // shorthand for "include everything"
+  other_module: {
+    types: true | false | string[],
+    functions: true | false | string[] | { private: boolean | 'entry' },
+  }
+}
+```
+
+### Types
+
+Controls which BCS type definitions (structs and enums) are generated:
+
+- `true` — generate all types
+- `false` — skip type generation
+- `string[]` — generate only the listed types by name _(module level only)_
+
+### Functions
+
+Controls which Move function wrappers are generated:
+
+- `true` — generate all public functions and private entry functions
+- `false` — skip function generation
+- `string[]` — generate only the listed functions by name; includes private functions _(module level
+  only)_
+- `{ private: 'entry' }` — generate public functions plus private entry functions
+- `{ private: true }` — generate all functions including private
+- `{ private: false }` — only generate public functions
+
+### Modules
+
+Controls which modules from the package are included. Only available at the package level, not at
+the global level.
+
+- Not set (default) — include all modules
+- `string[]` — only include the listed modules
+- `Record<string, true | { types?, functions? }>` — only include the listed modules, with per-module
+  overrides for `types` and `functions`. Use `true` as a shorthand to include everything from a
+  module with package-level defaults
+
+### Examples
+
+Only generate code from specific modules of the Haneul framework:
+
+```typescript
+{
+  package: '0x0000000000000000000000000000000000000000000000000000000000000002',
+  packageName: '0x2',
+  network: 'testnet',
+  generate: {
+    modules: ['kiosk', 'kiosk_extension', 'transfer_policy'],
+  },
+}
+```
+
+Only generate a single type from a dependency (functions are omitted automatically since `generate`
+is configured and `functions` is not specified):
+
+```typescript
+{
+  package: '0xabf837e98c26087cba0883c0a7a28326b1fa3c5e1e2c5abdb486f9e8f594c837',
+  packageName: 'pyth',
+  network: 'testnet',
+  generate: {
+    modules: {
+      state: { types: ['State'] },
+    },
+  },
+}
+```
+
+Generate specific types and functions from individual modules:
+
+```typescript
+{
+  package: '@local-pkg/my-package',
+  path: './move/my-package',
+  generate: {
+    modules: {
+      token: {
+        types: ['Token', 'TokenMetadata'],
+        functions: ['mint', 'burn', 'transfer'],
+      },
+      admin: {
+        types: true,
+        functions: ['initialize'],
+      },
+    },
+  },
+}
+```
+
+Generate all types but include all private functions for a local package:
+
+```typescript
+{
+  package: '@local-pkg/my-package',
+  path: './move/my-package',
+  generate: {
+    functions: { private: true },
+  },
+}
+```
+
+### Dependency pruning
+
+The global `prune` option (default: `true`) controls whether dependency packages are included in the
+output. Even when pruning is enabled, dependency types referenced by your included types are still
+generated under `deps/`:
+
+```
+src/contracts/
+├── mypackage/
+│   ├── module_a.ts
+│   ├── module_b.ts
+│   └── deps/
+│       └── 0x2/
+│           └── balance.ts     # Auto-included dependency type
+└── utils/
+    └── index.ts               # Shared utilities (always generated)
+```
+
+Set `prune: false` to generate all dependency modules with their full types and functions.
+
+## Phantom Types
+
+In Move, phantom type parameters are type parameters that only appear at the type level and don't
+affect the runtime data layout of a struct. For example, `Balance<T>` has a phantom type parameter
+`T` that indicates the coin type, but the actual serialized data only contains a `u64` value:
+
+```move
+public struct Balance<phantom T> has store {
+    value: u64,
+}
+```
+
+### Default Behavior
+
+By default, codegen excludes phantom type parameters from the generated BCS type functions since
+they don't affect serialization. The generated type is a constant rather than a function:
+
+```typescript
+
+	name: `${$moduleName}::Balance<phantom T>`,
+	fields: {
+		value: bcs.u64(),
+	},
+});
+```
+
+This works correctly for parsing on-chain data because phantom types don't change the binary layout.
+
+> **Note:** With the default behavior, phantom parameters appear as literals in the type name (e.g.,
+> `Balance<phantom T>`). These names are useful for debugging but are not valid on-chain type tags.
+> If you need valid type names with resolved phantom parameters, enable
+> `includePhantomTypeParameters`.
+
+### Including Phantom Type Parameters
+
+If you need the phantom type parameters as function arguments (for example, to preserve type
+information for other tooling), enable `includePhantomTypeParameters`:
+
+```typescript
+const config: HaneulCodegenConfig = {
+	output: './src/contracts',
+	includePhantomTypeParameters: true,
+	packages: [
+		// ...
+	],
+};
+```
+
+With this option enabled, phantom type parameters become function arguments:
+
+```typescript
+
+	return new MoveStruct({
+		name: `${$moduleName}::Balance<${T.name}>` as const,
+		fields: {
+			value: bcs.u64(),
+		},
+	});
+}
+```
+
+## Using Generated Code
+
+### Calling Move Functions
+
+The generated code provides type-safe functions for calling Move functions:
+
+```typescript
+// Increment a counter
+const tx = new Transaction();
+tx.add(
+	counter.increment({
+		arguments: {
+			counter: '0x123...', // Counter object ID
+		},
+	}),
+);
+```
+
+### Parsing BCS Data
+
+Use generated BCS types to parse on-chain object data. Fetch the object with
+`include: { content: true }` and pass `object.content` to the generated type's `.parse()` method:
+
+```typescript
+async function readCounter(client: ClientWithCoreApi, id: string) {
+	const { object } = await client.core.getObject({
+		objectId: id,
+		include: { content: true },
+	});
+
+	// Parse the Move struct fields from BCS content
+	const parsed = CounterStruct.parse(object.content);
+	console.log('Counter value:', parsed.value);
+	console.log('Counter owner:', parsed.owner);
+
+	return parsed;
+}
+```
+
+> **Warning:** Always use `content`, not `objectBcs`, when parsing with generated types. The
+> `objectBcs` field contains a full object envelope with additional metadata that will cause parsing
+> to fail. See the [Core API docs](/haneul/clients/core#objectbcs) for details.
+
+## Client Configuration
+
+### Using with MVR (Move Version Registry)
+
+If your package is registered on MVR, the generated code works without additional configuration.
+
+### Local Packages
+
+For local packages using `@local-pkg/*` identifiers, configure your client with package overrides:
+
+```typescript
+const client = new HaneulGrpcClient({
+	network: 'testnet',
+	baseUrl: 'https://fullnode.testnet.haneul.io:443',
+	mvr: {
+		overrides: {
+			packages: {
+				'@local-pkg/counter': '0xYOUR_PACKAGE_ID',
+			},
+		},
+	},
+});
+```
+
+### With dApp Kit
+
+Configure package overrides when creating your dApp Kit instance:
+
+```typescript
+const GRPC_URLS = {
+	testnet: 'https://fullnode.testnet.haneul.io:443',
+};
+
+const PACKAGE_IDS = {
+	testnet: {
+		counter: '0xYOUR_PACKAGE_ID',
+	},
+};
+
+const dAppKit = createDAppKit({
+	networks: ['testnet'],
+	createClient: (network) => {
+		return new HaneulGrpcClient({
+			network,
+			baseUrl: GRPC_URLS[network],
+			mvr: {
+				overrides: {
+					packages: {
+						'@local-pkg/counter': PACKAGE_IDS[network].counter,
+					},
+				},
+			},
+		});
+	},
+});
+```
+
+## Related Resources
+
+- [create-dapp](/dapp-kit/getting-started/create-dapp) - Bootstrap a working dApp with codegen
+  already configured
+- [Haneul Move documentation](https://docs.haneul.io/concepts/haneul-move-concepts)
+- [BCS documentation](/bcs)
+- [Transaction building](/haneul/transaction-building/basics)
+- [dApp Kit](/dapp-kit)

package/docs/llms-index.md

@@ -0,0 +1,6 @@
+# TypeScript Codegen
+
+> Generate type-safe TypeScript code from Haneul Move packages
+
+- [Haneul TypeScript Codegen](./index.md): Generate type-safe TypeScript bindings from on-chain
+  Haneul Move packages

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haneullabs/codegen",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "typescript codegen for haneul move",
   "license": "Apache-2.0",
   "author": "Haneul Labs <build@haneul-labs.com>",
@@ -18,11 +18,12 @@
   "files": [
     "CHANGELOG.md",
     "dist",
+    "docs",
     "src"
   ],
   "bin": {
     "haneul-ts-codegen": "dist/bin/cli.mjs",
-    "__sui-ts-codegen_bash_complete": "dist/bin/bash-complete.mjs"
+    "__haneul-ts-codegen_bash_complete": "dist/bin/bash-complete.mjs"
   },
   "repository": {
     "type": "git",
@@ -34,7 +35,7 @@
     "haneul"
   ],
   "bugs": {
-    "url": "https://github.com/mystenlabs/ts-sdks/issues"
+    "url": "https://github.com/GeunhwaJeong/ts-sdks/issues"
   },
   "homepage": "https://github.com/GeunhwaJeong/ts-sdks/blob/main/packages/codegen#readme",
   "devDependencies": {
@@ -49,13 +50,14 @@
     "toml": "^3.0.0",
     "typescript": "^5.9.3",
     "zod": "^4.3.5",
-    "@haneullabs/bcs": "^2.0.2",
-    "@haneullabs/haneul": "^2.4.0"
+    "@haneullabs/bcs": "^2.0.3",
+    "@haneullabs/haneul": "^2.13.0"
   },
   "scripts": {
     "clean": "rm -rf tsconfig.tsbuildinfo ./dist",
     "dev": "pnpm build --watch",
     "build": "rm -rf dist && tsc --noEmit && tsdown",
+    "build:docs": "tsx ../docs/scripts/build-docs.ts",
     "codegen": "pnpm tsx src/bin/cli.ts generate && pnpm lint:fix",
     "test": "vitest run",
     "test:watch": "vitest",

package/src/config.ts

@@ -82,9 +82,9 @@ export const configSchema = z.object({
 
 export type PackageConfig = z.infer<typeof packageConfigSchema>;
 export type HaneulCodegenConfig = z.input<typeof configSchema>;
-export type ParsedSuiCodegenConfig = z.infer<typeof configSchema>;
+export type ParsedHaneulCodegenConfig = z.infer<typeof configSchema>;
 
-export async function loadConfig(): Promise<ParsedSuiCodegenConfig> {
+export async function loadConfig(): Promise<ParsedHaneulCodegenConfig> {
 	const config = await cosmiconfig('haneul-codegen').search();
 
 	if (!config) {

package/src/file-builder.ts

@@ -49,6 +49,7 @@ export class FileBuilder {
 			i++;
 		}
 
+		this.reservedNames.add(deConflictedName);
 		return deConflictedName;
 	}