@contractkit/plugin-typescript 0.17.5 → 0.18.0

package/coverage/src/path-utils.ts.html

@@ -23,30 +23,30 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">23.47% </span>
+                <span class="strong">36.52% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>27/115</span>
+                <span class='fraction'>42/115</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">18.84% </span>
+                <span class="strong">27.53% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>13/69</span>
+                <span class='fraction'>19/69</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">58.33% </span>
+                <span class="strong">75% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>7/12</span>
+                <span class='fraction'>9/12</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">23.71% </span>
+                <span class="strong">38.14% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>23/97</span>
+                <span class='fraction'>37/97</span>
             </div>
         
             
@@ -258,28 +258,28 @@
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">7x</span>
+<span class="cline-any cline-yes">16x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">7x</span>
-<span class="cline-any cline-yes">7x</span>
+<span class="cline-any cline-yes">12x</span>
+<span class="cline-any cline-yes">12x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">14x</span>
-<span class="cline-any cline-yes">16x</span>
-<span class="cline-any cline-yes">14x</span>
-<span class="cline-any cline-yes">14x</span>
-<span class="cline-any cline-yes">14x</span>
-<span class="cline-any cline-yes">16x</span>
-<span class="cline-any cline-yes">48x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">21x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">18x</span>
+<span class="cline-any cline-yes">21x</span>
+<span class="cline-any cline-yes">63x</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">14x</span>
+<span class="cline-any cline-yes">18x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -330,16 +330,16 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-yes">5x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-yes">5x</span>
+<span class="cline-any cline-yes">5x</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
@@ -373,22 +373,22 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-yes">4x</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-yes">4x</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-yes">4x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -511,23 +511,23 @@ export function computeContractOutPath(
 &nbsp;
 // ─── SDK output paths ──────────────────────────────────────────────────────
 &nbsp;
-export function <span class="fstat-no" title="function not covered" >computeSdkOutPath(</span>
+export function computeSdkOutPath(
     filePath: string,
     rootDir: string,
     clientOutput: string | undefined,
     commonRoot: string,
-    meta: Record&lt;string, string&gt; = <span class="branch-0 cbranch-no" title="branch not covered" >{},</span>
+    meta: Record&lt;string, string&gt; = {},
 ): string | null {
-<span class="cstat-no" title="statement not covered" >    if (!filePath.endsWith('.ck')) <span class="cstat-no" title="statement not covered" >return null;</span></span>
-    const baseName = <span class="cstat-no" title="statement not covered" >filePath.split('/').pop()!;</span>
-    const defaultOutName = <span class="cstat-no" title="statement not covered" >baseName.replace(/\.ck$/, '.client.ts');</span>
-    const <span class="cstat-no" title="statement not covered" >baseOutDir = resolve(rootDir);</span>
-    const <span class="cstat-no" title="statement not covered" >relDir = relative(commonRoot, dirname(filePath));</span>
-    const filename = <span class="cstat-no" title="statement not covered" >baseName.replace(/\.ck$/, '');</span>
+    <span class="missing-if-branch" title="if path not taken" >I</span>if (!filePath.endsWith('.ck')) <span class="cstat-no" title="statement not covered" >return null;</span>
+    const baseName = filePath.split('/').pop()!;
+    const defaultOutName = baseName.replace(/\.ck$/, '.client.ts');
+    const baseOutDir = resolve(rootDir);
+    const relDir = relative(commonRoot, dirname(filePath));
+    const filename = baseName.replace(/\.ck$/, '');
 &nbsp;
-<span class="cstat-no" title="statement not covered" >    if (clientOutput &amp;&amp; TEMPLATE_VAR_RE.test(clientOutput)) {</span>
-        const resolved = <span class="cstat-no" title="statement not covered" >resolveTemplate(clientOutput, { filename, dir: relDir, ext: 'ck', ...meta });</span>
-<span class="cstat-no" title="statement not covered" >        if (includesFilename(resolved)) <span class="cstat-no" title="statement not covered" >return join(baseOutDir, resolved);</span></span>
+    <span class="missing-if-branch" title="else path not taken" >E</span>if (clientOutput &amp;&amp; TEMPLATE_VAR_RE.test(clientOutput)) {
+        const resolved = resolveTemplate(clientOutput, { filename, dir: relDir, ext: 'ck', ...meta });
+        <span class="missing-if-branch" title="else path not taken" >E</span>if (includesFilename(resolved)) return join(baseOutDir, resolved);
 <span class="cstat-no" title="statement not covered" >        return join(baseOutDir, resolved, defaultOutName);</span>
     }
 <span class="cstat-no" title="statement not covered" >    if (clientOutput) {</span>
@@ -560,23 +560,23 @@ export function <span class="fstat-no" title="function not covered" >computeSdkT
 <span class="cstat-no" title="statement not covered" >    return join(baseOutDir, typeOutput, relDir, defaultOutName);</span>
 }
 &nbsp;
-export function <span class="fstat-no" title="function not covered" >generateBarrelFiles(c</span>ontractPaths: string[]): { outPath: string; content: string }[] {
-    const byDir = <span class="cstat-no" title="statement not covered" >new Map&lt;string, string[]&gt;();</span>
-<span class="cstat-no" title="statement not covered" >    for (const outPath of contractPaths) {</span>
+export function generateBarrelFiles(contractPaths: string[]): { outPath: string; content: string }[] {
+    const byDir = new Map&lt;string, string[]&gt;();
+    for (const outPath of contractPaths) {
         const <span class="cstat-no" title="statement not covered" >dir = dirname(outPath);</span>
         const group = <span class="cstat-no" title="statement not covered" >byDir.get(dir) ?? [];</span>
 <span class="cstat-no" title="statement not covered" >        group.push(outPath);</span>
 <span class="cstat-no" title="statement not covered" >        byDir.set(dir, group);</span>
     }
-    const results: { outPath: string; content: string }[] = <span class="cstat-no" title="statement not covered" >[];</span>
-<span class="cstat-no" title="statement not covered" >    for (const [dir, files] of byDir) {</span>
+    const results: { outPath: string; content: string }[] = [];
+    for (const [dir, files] of byDir) {
         const exports = <span class="cstat-no" title="statement not covered" >files</span>
             .map(<span class="fstat-no" title="function not covered" >f =&gt; <span class="cstat-no" title="statement not covered" >`</span>export * from './${f.split('/').pop()!.replace(/\.ts$/, '.js')}';`)</span>
             .sort()
             .join('\n');
 <span class="cstat-no" title="statement not covered" >        results.push({ outPath: join(dir, 'index.ts'), content: `// Auto-generated barrel file\n${exports}\n` });</span>
     }
-<span class="cstat-no" title="statement not covered" >    return results;</span>
+    return results;
 }
 &nbsp;
 export function <span class="fstat-no" title="function not covered" >computePubliclyReachableTypes(</span>
@@ -634,7 +634,7 @@ export function <span class="fstat-no" title="function not covered" >computePubl
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-06T12:37:14.475Z
+                at 2026-05-06T16:22:17.029Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/src/ts-render.ts.html

@@ -254,7 +254,7 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">343x</span>
+<span class="cline-any cline-yes">347x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">170x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -281,7 +281,7 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">4x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">115x</span>
+<span class="cline-any cline-yes">119x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">2x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -374,7 +374,7 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">91x</span>
+<span class="cline-any cline-yes">95x</span>
 <span class="cline-any cline-yes">8x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">3x</span>
@@ -577,7 +577,7 @@ export function renderOutputTsType(type: ContractTypeNode, modelsWithOutput?: Se
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-06T12:37:14.475Z
+                at 2026-05-06T16:22:17.029Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/tests/helpers.ts.html

@@ -341,7 +341,7 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">874x</span>
+<span class="cline-any cline-yes">892x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -377,7 +377,7 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">203x</span>
+<span class="cline-any cline-yes">207x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -446,16 +446,16 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">114x</span>
-<span class="cline-any cline-yes">114x</span>
+<span class="cline-any cline-yes">123x</span>
+<span class="cline-any cline-yes">123x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">100x</span>
-<span class="cline-any cline-yes">100x</span>
+<span class="cline-any cline-yes">104x</span>
+<span class="cline-any cline-yes">104x</span>
 <span class="cline-any cline-yes">7x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">93x</span>
+<span class="cline-any cline-yes">97x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -469,10 +469,10 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">203x</span>
-<span class="cline-any cline-yes">203x</span>
-<span class="cline-any cline-yes">203x</span>
-<span class="cline-any cline-yes">203x</span>
+<span class="cline-any cline-yes">212x</span>
+<span class="cline-any cline-yes">212x</span>
+<span class="cline-any cline-yes">212x</span>
+<span class="cline-any cline-yes">212x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -486,12 +486,12 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">193x</span>
-<span class="cline-any cline-yes">193x</span>
+<span class="cline-any cline-yes">202x</span>
+<span class="cline-any cline-yes">202x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">187x</span>
+<span class="cline-any cline-yes">198x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -811,7 +811,7 @@ operation /users/{id}: {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-06T12:37:14.475Z
+                at 2026-05-06T16:22:17.029Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/tests/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-05-06T12:37:14.475Z
+                at 2026-05-06T16:22:17.029Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/dist/codegen-sdk.d.ts

@@ -1,6 +1,9 @@
 import type { OpRootNode } from '@contractkit/core';
+/** Options shared by every SDK code-generation entry point. */
 export interface SdkCodegenOptions {
+    /** Template for type import paths when `modelOutPaths` is not provided. Supports `{module}` and `{base}`. */
     typeImportPathTemplate?: string;
+    /** Absolute path of the file currently being generated. Used to compute relative imports. */
     outPath?: string;
     /** Map from model name → absolute output file path (for cross-module type imports) */
     modelOutPaths?: Map<string, string>;
@@ -16,6 +19,12 @@ export interface SdkCodegenOptions {
      * to include them (e.g. for an internal-use SDK).
      */
     includeInternal?: boolean;
+    /**
+     * Override the generated client class name. When omitted, falls back to
+     * `deriveClientClassName(root.file)` (the legacy per-file name). The aggregator
+     * uses this to emit `<Area><Subarea>Client` for area+subarea leaf files.
+     */
+    clientClassName?: string;
 }
 /**
  * Returns true if the root contains at least one operation eligible for SDK emission.
@@ -23,16 +32,101 @@ export interface SdkCodegenOptions {
  * `includeInternal: true` any op qualifies.
  */
 export declare function hasPublicOperations(root: OpRootNode, includeInternal?: boolean): boolean;
+/**
+ * Generate a complete `*.client.ts` file for one operation root: imports, the client class
+ * declaration, and one method per public operation. Used for top-level (no-area) files and
+ * for subarea-leaf files. Area-level files are NOT routed through this — their methods get
+ * inlined into the SDK aggregator via {@link generateClientMethods} + {@link generateSdkAggregator}.
+ */
 export declare function generateSdk(root: OpRootNode, options?: SdkCodegenOptions): string;
+/**
+ * Render the method-block lines for an operation file as if they were declared inside a
+ * client class. Returns one consolidated array of strings (each pre-indented for class body
+ * level, with leading blank lines between methods) plus the set of method names emitted —
+ * the caller uses the names to detect cross-file collisions when multiple files contribute
+ * to the same area-level client.
+ *
+ * Skips operations marked `internal` unless `options.includeInternal` is set.
+ */
+export declare function generateClientMethods(root: OpRootNode, options: SdkCodegenOptions): {
+    lines: string[];
+    methodNames: string[];
+};
+/** Derive a client class name from a `.ck` file path, e.g. `users.ck` → `UsersClient`. Used for legacy flat (no-area) files. */
 export declare function deriveClientClassName(file: string): string;
+/** Camel-cased property name for a flat client on the SDK aggregator, e.g. `users.ck` → `users`. */
 export declare function deriveClientPropertyName(file: string): string;
+/**
+ * Pull `area` / `subarea` from a file's `root.meta` (set via `options { keys: { ... } }`).
+ * Both are optional. `area` drives top-level SDK grouping; `subarea` drives nesting under
+ * an area's client class.
+ */
+export declare function getAreaSubarea(root: OpRootNode): {
+    area?: string;
+    subarea?: string;
+};
+/** Class name for the area-level client, e.g. `area=identity` → `IdentityClient`. */
+export declare function deriveAreaClientClassName(area: string): string;
+/** Property name on the SDK aggregator for an area, e.g. `area=identity` → `identity`. */
+export declare function deriveAreaPropertyName(area: string): string;
+/** Class name for a leaf subarea client, e.g. `(identity, invitations)` → `IdentityInvitationsClient`. */
+export declare function deriveSubareaClientClassName(area: string, subarea: string): string;
+/** Property name on the area client for a subarea, e.g. `subarea=invitations` → `invitations`. */
+export declare function deriveSubareaPropertyName(subarea: string): string;
 /** Generate the shared SdkOptions interface file. */
 export declare function generateSdkOptions(): string;
+/**
+ * Reference to a per-file leaf client emitted to its own `*.client.ts`. Used by the
+ * aggregator to import the class and wire it as either a top-level `sdk.<prop>` or a
+ * nested `sdk.<area>.<subarea>` property.
+ */
 export interface SdkClientInfo {
+    /** Client class name (e.g. `UsersClient`, `IdentityInvitationsClient`). */
     className: string;
+    /** Property name to expose this client under (e.g. `users`, `invitations`). */
     propertyName: string;
+    /** Module specifier for the leaf file, relative to `sdk.ts` and `.js`-suffixed. */
     importPath: string;
 }
-/** Generate the sdk.ts aggregator that wraps all clients into a single Sdk class. */
-export declare function generateSdkAggregator(clients: SdkClientInfo[], sdkOptionsImportPath?: string, sdkClassName?: string): string;
+/**
+ * One area-level (no-subarea) `.ck` file whose methods are inlined directly into the
+ * generated `<Area>Client` class instead of getting a standalone `*.client.ts`.
+ */
+export interface SdkAreaInlineFile {
+    /** Parsed AST. */
+    root: OpRootNode;
+    /** Codegen options for this file (must have `outPath` pointing at the SDK aggregator file so type-import paths resolve correctly). */
+    codegenOptions: SdkCodegenOptions;
+}
+/** A grouping of files that share the same `keys.area`. */
+export interface SdkAreaInfo {
+    area: string;
+    /** Files for which all methods are inlined into the area client (no subarea). */
+    inlineFiles: SdkAreaInlineFile[];
+    /** Per-file leaf clients exposed as named properties on the area client. */
+    subareaClients: {
+        propertyName: string;
+        client: SdkClientInfo;
+    }[];
+}
+export interface SdkAggregatorInput {
+    /** Files with no `keys.area` — kept as flat `Sdk.<filename>` properties (legacy behavior). */
+    topLevelClients: SdkClientInfo[];
+    /** One entry per `keys.area`. */
+    areas: SdkAreaInfo[];
+    /** Path to `sdk-options.ts` to import `SdkOptions`/`createSdkFetch`/etc. from. */
+    sdkOptionsImportPath?: string;
+    /** Name of the top-level aggregator class. Defaults to `Sdk`. */
+    sdkClassName?: string;
+}
+/**
+ * Generate the SDK aggregator (`sdk.ts`) — the entry-point file consumers import.
+ *
+ * Emits one `<Area>Client` class per area (combining inlined area-level methods with
+ * subarea property wiring), one `class Sdk` exposing area properties + flat top-level
+ * properties, plus all imports needed by the inlined methods.
+ *
+ * @throws if two area-level files in the same area produce the same method name.
+ */
+export declare function generateSdkAggregator(input: SdkAggregatorInput): string;
 //# sourceMappingURL=codegen-sdk.d.ts.map

package/dist/codegen-sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen-sdk.d.ts","sourceRoot":"","sources":["../src/codegen-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAkF,MAAM,mBAAmB,CAAC;AA2DpI,MAAM,WAAW,iBAAiB;IAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,8GAA8G;IAC9G,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,UAAQ,GAAG,OAAO,CAOtF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAmHrF;AAsTD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7D;AA2QD,qDAAqD;AACrD,wBAAgB,kBAAkB,IAAI,MAAM,CA6E3C;AAED,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,oBAAoB,SAAqB,EAAE,YAAY,SAAQ,GAAG,MAAM,CAyBvI"}
+{"version":3,"file":"codegen-sdk.d.ts","sourceRoot":"","sources":["../src/codegen-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAkF,MAAM,mBAAmB,CAAC;AA2DpI,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAC9B,6GAA6G;IAC7G,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,8GAA8G;IAC9G,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,UAAQ,GAAG,OAAO,CAOtF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAmHrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACjC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,iBAAiB,GAC3B;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAe5C;AAsTD,gIAAgI;AAChI,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,oGAAoG;AACpG,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAEpF;AAeD,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,0GAA0G;AAC1G,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,kGAAkG;AAClG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjE;AA2QD,qDAAqD;AACrD,wBAAgB,kBAAkB,IAAI,MAAM,CA6E3C;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC1B,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,kBAAkB;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,sIAAsI;IACtI,cAAc,EAAE,iBAAiB,CAAC;CACrC;AAED,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,4EAA4E;IAC5E,cAAc,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,EAAE,CAAC;CACrE;AAED,MAAM,WAAW,kBAAkB;IAC/B,8FAA8F;IAC9F,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,iCAAiC;IACjC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CA6IvE"}

package/dist/index.d.ts

@@ -37,9 +37,9 @@ export interface SdkConfig {
     output?: {
         /** Path template for the SDK aggregator file. Supports {name}. Default: `sdk.ts`. */
         sdk?: string;
-        /** Path template for SDK type files. Supports {filename}, {dir}, {area}. */
+        /** Path template for SDK type files. Supports {filename}, {dir}, {area}, {subarea}. */
         types?: string;
-        /** Path template for client class files. Supports {filename}, {dir}, {area}. */
+        /** Path template for client class files. Supports {filename}, {dir}, {area}, {subarea}. */
         clients?: string;
     };
     /**
@@ -73,5 +73,10 @@ export interface TypescriptPluginConfig {
 }
 declare const plugin: ContractKitPlugin;
 export default plugin;
+/**
+ * Build a `@contractkit/plugin-typescript` instance with explicit configuration, for
+ * programmatic use (tests, custom build scripts). Prefer the default export when loading
+ * via `contractkit.config.json`.
+ */
 export declare function createTypescriptPlugin(config: TypescriptPluginConfig, rootDir: string): ContractKitPlugin;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAwB3D,MAAM,WAAW,YAAY;IACzB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE;QACL,+GAA+G;QAC/G,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACtB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE;QACL,qFAAqF;QACrF,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,4EAA4E;QAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,gFAAgF;QAChF,OAAO,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACtB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0GAA0G;IAC1G,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,uGAAuG;IACvG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yGAAyG;IACzG,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACnC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,oGAAoG;IACpG,KAAK,CAAC,EAAE,WAAW,CAAC;CACvB;AAsRD,QAAA,MAAM,MAAM,EAAE,iBAmBb,CAAC;AAEF,eAAe,MAAM,CAAC;AAItB,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAmBzG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA6B3D,MAAM,WAAW,YAAY;IACzB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE;QACL,+GAA+G;QAC/G,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACtB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE;QACL,qFAAqF;QACrF,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,uFAAuF;QACvF,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,2FAA2F;QAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACtB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0GAA0G;IAC1G,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,uGAAuG;IACvG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yGAAyG;IACzG,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACnC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,oGAAoG;IACpG,KAAK,CAAC,EAAE,WAAW,CAAC;CACvB;AAiXD,QAAA,MAAM,MAAM,EAAE,iBAmBb,CAAC;AAEF,eAAe,MAAM,CAAC;AAItB;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAmBzG"}