@contractkit/plugin-typescript 0.17.5 → 0.18.0

package/.turbo/turbo-build$colon$ci.log

@@ -1,9 +1,9 @@
 
-> @contractkit/plugin-typescript@0.17.5 build:ci /home/runner/work/ContractKit/ContractKit/packages/plugin-typescript
+> @contractkit/plugin-typescript@0.18.0 build:ci /home/runner/work/ContractKit/ContractKit/packages/plugin-typescript
 > eslint --max-warnings=0 && pnpm run build
 
 
-> @contractkit/plugin-typescript@0.17.5 build /home/runner/work/ContractKit/ContractKit/packages/plugin-typescript
+> @contractkit/plugin-typescript@0.18.0 build /home/runner/work/ContractKit/ContractKit/packages/plugin-typescript
 > tsup src/index.ts --format esm --sourcemap --dts && tsc --emitDeclarationOnly --declaration
 
 CLI Building entry: src/index.ts
@@ -11,9 +11,9 @@
 CLI tsup v8.5.1
 CLI Target: esnext
 ESM Build start
-ESM dist/index.js     126.39 KB
-ESM dist/index.js.map 274.93 KB
-ESM ⚡️ Build success in 349ms
+ESM dist/index.js     135.58 KB
+ESM dist/index.js.map 298.86 KB
+ESM ⚡️ Build success in 308ms
 DTS Build start
-DTS ⚡️ Build success in 5193ms
-DTS dist/index.d.ts 3.44 KB
+DTS ⚡️ Build success in 5090ms
+DTS dist/index.d.ts 3.67 KB

package/.turbo/turbo-test$colon$ci.log

@@ -1,35 +1,35 @@
 
-> @contractkit/plugin-typescript@0.17.5 test:ci /home/runner/work/ContractKit/ContractKit/packages/plugin-typescript
+> @contractkit/plugin-typescript@0.18.0 test:ci /home/runner/work/ContractKit/ContractKit/packages/plugin-typescript
 > vitest run --coverage
 
 
  RUN  v4.1.5 /home/runner/work/ContractKit/ContractKit/packages/plugin-typescript
       Coverage enabled with v8
 
- ✓ tests/codegen-contract.test.ts (124 tests) 98ms
- ✓ tests/codegen-operation.test.ts (88 tests) 134ms
- ✓ tests/codegen-sdk.test.ts (123 tests) 127ms
- ✓ tests/codegen-server.test.ts (15 tests) 26ms
- ✓ tests/codegen-plain-types.test.ts (61 tests) 38ms
- ✓ tests/pipeline.test.ts (25 tests) 185ms
+ ✓ tests/codegen-operation.test.ts (88 tests) 53ms
+ ✓ tests/codegen-contract.test.ts (124 tests) 120ms
+ ✓ tests/codegen-sdk.test.ts (131 tests) 76ms
+ ✓ tests/codegen-plain-types.test.ts (61 tests) 37ms
+ ✓ tests/pipeline.test.ts (25 tests) 142ms
+ ✓ tests/codegen-server.test.ts (19 tests) 24ms
 
  Test Files  6 passed (6)
-      Tests  436 passed (436)
-   Start at  12:37:07
-   Duration  6.66s (transform 3.78s, setup 0ms, import 13.89s, tests 608ms, environment 9ms)
+      Tests  448 passed (448)
+   Start at  16:22:10
+   Duration  6.11s (transform 5.19s, setup 0ms, import 12.92s, tests 452ms, environment 1ms)
 
  % Coverage report from v8
 -------------------|---------|----------|---------|---------|-------------------
 File               | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s 
 -------------------|---------|----------|---------|---------|-------------------
-All files          |   77.84 |    74.45 |    82.5 |   79.74 |                   
- src               |   77.54 |    74.08 |   81.92 |    79.4 |                   
+All files          |   80.98 |    76.16 |   84.16 |   83.21 |                   
+ src               |   80.77 |    75.84 |   83.76 |   82.97 |                   
   ...n-contract.ts |   87.83 |    82.12 |   90.08 |   88.96 | ...1069,1074-1075 
   ...-operation.ts |   78.18 |    74.26 |   78.08 |   79.69 | ...68-679,684-685 
   ...lain-types.ts |   89.08 |    78.37 |   96.66 |    92.3 | ...31,243,249,301 
-  codegen-sdk.ts   |   88.75 |     83.6 |      85 |   91.49 | ...23,678,712-729 
-  index.ts         |   23.35 |    19.51 |   33.33 |   25.69 | ...97,415,418,421 
-  path-utils.ts    |   23.47 |    18.84 |   58.33 |   23.71 | ...1,54-55,80-187 
+  codegen-sdk.ts   |   88.26 |    83.01 |   87.14 |   91.22 | ...1087-1088,1091 
+  index.ts         |   57.28 |    46.93 |   59.25 |   61.27 | ...90,493,519,522 
+  path-utils.ts    |   36.52 |    27.53 |      75 |   38.14 | ...32-136,147-187 
   ts-render.ts     |   82.19 |    85.39 |   72.22 |   87.09 | 56,90,126,157-165 
  tests             |   90.38 |     90.9 |   89.28 |   93.47 |                   
   helpers.ts       |   90.38 |     90.9 |   89.28 |   93.47 | 110-118           

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @contractkit/contractkit-plugin-typescript
 
+## 0.18.0
+
+### Minor Changes
+
+- 6f8e3b6: Group TypeScript SDK clients by `keys.area` and `keys.subarea`. Files declaring `subarea` produce a leaf `<Area><Subarea>Client` exposed at `sdk.<area>.<subarea>`; area-only files (no subarea) inline their methods directly onto a synthesized `<Area>Client` and surface as `sdk.<area>.<method>`. Files with no area keep the legacy flat `sdk.<filename>` shape.
+
+    `{subarea}` is a new path-template variable on `output.clients` and `output.types`, enabling layouts like `src/{area}/{subarea}.client.ts`. Multiple area-level files merging into one client throw a codegen-time error if any method names collide — disambiguate with `sdk:` or move into a subarea.
+
+    Breaking: area-level files no longer emit a standalone `*.client.ts` (their methods live on the area client in `sdk.ts`). The `generateSdkAggregator` signature now takes a structured `SdkAggregatorInput` rather than `(clients, importPath?, className?)`.
+
 ## 0.17.5
 
 ### Patch Changes

package/README.md

@@ -104,6 +104,7 @@ Output paths support the following variables:
 | `{filename}` | Base name of the `.ck` source file (without extension) |
 | `{dir}` | Relative directory of the `.ck` source file |
 | `{area}` | Value of the `area` key from the `options` block |
+| `{subarea}` | Value of the `subarea` key from the `options` block |
 | `{name}` | The `name` option from the SDK sub-config |
 
 ## What gets generated
@@ -124,7 +125,15 @@ Each operation file generates one Koa router. Request bodies and path/query para
 
 ### SDK client shape (from `operation`)
 
-Each operation file generates one client class. The aggregator SDK class (in `output.sdk`) instantiates all clients and exposes them as properties.
+Operation files cluster on the SDK based on `keys.area` and `keys.subarea` (set in each file's `options { keys: { ... } }` block):
+
+| File metadata | Generated layout |
+| --- | --- |
+| `area: identity, subarea: invitations` | leaf `IdentityInvitationsClient` emitted as `<output.clients>` (path can use `{subarea}`); aggregator wires it as `sdk.identity.invitations` |
+| `area: identity` (no subarea) | methods inlined directly on `IdentityClient` (no standalone `*.client.ts`); exposed as `sdk.identity.<method>` |
+| neither | flat `<Filename>Client` exposed as `sdk.<filename>` (legacy behavior) |
+
+Multiple files mapping to the same `(area, subarea)` are merged into one leaf class. Multiple area-level files merge into a single `<Area>Client`; duplicate method names across them throw at codegen — disambiguate with `sdk:` or move one into a subarea.
 
 Method names follow this priority: