@techspokes/typescript-wsdl-client 0.34.0 → 0.35.0

package/README.md

@@ -39,7 +39,7 @@ npm install --save-dev @techspokes/typescript-wsdl-client
 npm install soap
 ```
 
-Requirements: Node.js 20+ and the `soap` package as a runtime dependency.
+Requirements: Node.js 24+ and the `soap` package as a runtime dependency.
 
 ## Quick Start
 

package/dist/test/generators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../src/test/generators.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,UAAU,EAAE,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAA0C,KAAK,eAAe,EAAC,MAAM,eAAe,CAAC;AAG5F,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AA6FrF;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAkBzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAgFR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,UAAU,GACrB,MAAM,CAsCR;AAED;;;;;;;GAOG;AAEH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CA8FR;AAED;;;;;;;GAOG;AAEH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAiIR;AAED;;GAEG;AAEH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAuER;AAED;;GAEG;AAEH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,CAAC,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CAwDR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAChC,MAAM,CAgFR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAChC,MAAM,CAgDR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,OAAO,EAAE,eAAe,GACvB,MAAM,GAAG,IAAI,CAkEf"}
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../src/test/generators.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,UAAU,EAAE,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAA0C,KAAK,eAAe,EAAC,MAAM,eAAe,CAAC;AAG5F,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAsGrF;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAkBzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAgFR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,UAAU,GACrB,MAAM,CAsCR;AAED;;;;;;;GAOG;AAEH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CA8FR;AAED;;;;;;;GAOG;AAEH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAiIR;AAED;;GAEG;AAEH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAuER;AAED;;GAEG;AAEH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,CAAC,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CAwDR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAChC,MAAM,CAgFR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAChC,MAAM,CAgDR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,OAAO,EAAE,eAAe,GACvB,MAAM,GAAG,IAAI,CAkEf"}

package/dist/test/generators.js

@@ -29,6 +29,13 @@ function isRecord(value) {
 function cloneRecord(value) {
     return JSON.parse(JSON.stringify(value));
 }
+function formatInjectPayloadFields(value) {
+    if (value == null || typeof value !== "object") {
+        return `        headers: {"content-type": "application/json"},
+        payload: JSON.stringify(${JSON.stringify(value)}),`;
+    }
+    return `        payload: ${JSON.stringify(value, null, 4).replace(/\n/g, "\n    ")},`;
+}
 function mockChoiceBranchValue(branch, catalog) {
     const isArray = branch.max === "unbounded" || (typeof branch.max === "number" && branch.max > 1);
     const value = branch.tsType === "string" || branch.tsType === "number" || branch.tsType === "boolean"
@@ -253,7 +260,7 @@ export function emitRoutesTest(testDir, importsMode, operations, mocks) {
     const sortedOps = [...operations].sort((a, b) => a.operationId.localeCompare(b.operationId));
     const testCases = sortedOps.map((op) => {
         const mockData = mocks.get(op.operationId);
-        const requestPayload = JSON.stringify(mockData?.request ?? {}, null, 4).replace(/\n/g, "\n    ");
+        const requestPayloadFields = formatInjectPayloadFields(mockData?.request ?? {});
         const hint = formatOperationHint(op.summary, op.description);
         const hintComment = hint ? `  // ${hint}\n` : "";
         if (op.stream?.format === "json-array") {
@@ -264,7 +271,7 @@ export function emitRoutesTest(testDir, importsMode, operations, mocks) {
       const res = await app.inject({
         method: "${op.method.toUpperCase()}",
         url: "${op.path}",
-        payload: ${requestPayload},
+${requestPayloadFields}
       });
       expect(res.statusCode).toBe(200);
       expect(String(res.headers["content-type"] ?? "")).toContain(${JSON.stringify(op.stream.mediaType)});
@@ -287,7 +294,7 @@ export function emitRoutesTest(testDir, importsMode, operations, mocks) {
       const res = await app.inject({
         method: "${op.method.toUpperCase()}",
         url: "${op.path}",
-        payload: ${requestPayload},
+${requestPayloadFields}
       });
       expect(res.statusCode).toBe(200);
       expect(String(res.headers["content-type"] ?? "")).toContain(${JSON.stringify(op.stream.mediaType)});
@@ -308,7 +315,7 @@ export function emitRoutesTest(testDir, importsMode, operations, mocks) {
       const res = await app.inject({
         method: "${op.method.toUpperCase()}",
         url: "${op.path}",
-        payload: ${requestPayload},
+${requestPayloadFields}
       });
       expect(res.statusCode).toBe(200);
       const body = res.json();
@@ -354,7 +361,7 @@ export function emitErrorsTest(testDir, importsMode, operations, mocks) {
     if (!op)
         return "// No operations found\n";
     const mockData = mocks.get(op.operationId);
-    const requestPayload = JSON.stringify(mockData?.request ?? {}, null, 4).replace(/\n/g, "\n    ");
+    const requestPayloadFields = formatInjectPayloadFields(mockData?.request ?? {});
     return `/**
  * Gateway Error Handling Tests
  *
@@ -379,7 +386,7 @@ describe("gateway routes — error handling", () => {
       const res = await app.inject({
         method: "${op.method.toUpperCase()}",
         url: "${op.path}",
-        payload: ${requestPayload},
+${requestPayloadFields}
       });
       expect(res.statusCode).toBe(500);
       const body = res.json();
@@ -413,7 +420,7 @@ describe("gateway routes — error handling", () => {
       const res = await app.inject({
         method: "${op.method.toUpperCase()}",
         url: "${op.path}",
-        payload: ${requestPayload},
+${requestPayloadFields}
       });
       expect(res.statusCode).toBe(502);
       const body = res.json();
@@ -436,7 +443,7 @@ describe("gateway routes — error handling", () => {
       const res = await app.inject({
         method: "${op.method.toUpperCase()}",
         url: "${op.path}",
-        payload: ${requestPayload},
+${requestPayloadFields}
       });
       expect(res.statusCode).toBe(503);
       const body = res.json();
@@ -459,7 +466,7 @@ describe("gateway routes — error handling", () => {
       const res = await app.inject({
         method: "${op.method.toUpperCase()}",
         url: "${op.path}",
-        payload: ${requestPayload},
+${requestPayloadFields}
       });
       expect(res.statusCode).toBe(504);
       const body = res.json();
@@ -486,7 +493,7 @@ export function emitEnvelopeTest(testDir, importsMode, operations, mocks) {
     if (!op)
         return "// No operations found\n";
     const mockData = mocks.get(op.operationId);
-    const requestPayload = JSON.stringify(mockData?.request ?? {}, null, 4).replace(/\n/g, "\n    ");
+    const requestPayloadFields = formatInjectPayloadFields(mockData?.request ?? {});
     return `/**
  * Gateway Envelope Structure Tests
  *
@@ -505,7 +512,7 @@ describe("gateway — envelope structure", () => {
       const res = await app.inject({
         method: "${op.method.toUpperCase()}",
         url: "${op.path}",
-        payload: ${requestPayload},
+${requestPayloadFields}
       });
       expect(res.statusCode).toBe(200);
       const body = res.json();
@@ -530,7 +537,7 @@ describe("gateway — envelope structure", () => {
       const res = await app.inject({
         method: "${op.method.toUpperCase()}",
         url: "${op.path}",
-        payload: ${requestPayload},
+${requestPayloadFields}
       });
       expect(res.statusCode).toBe(500);
       const body = res.json();

package/docs/migration.md

@@ -18,6 +18,7 @@ These steps apply to every version upgrade:
 
 | wsdl-tsc | Node.js | TypeScript | soap | Fastify | saxes |
 |----------|---------|------------|------|---------|-------|
+| 0.35.x and later | >= 24.0 | >= 6.0 | >= 1.9 | >= 5.8 | >= 6.0 |
 | 0.17.x | >= 20.0 | >= 6.0 | >= 1.9 | >= 5.8 | >= 6.0 |
 | 0.16.x | >= 20.0 | >= 6.0 | >= 1.9 | >= 5.8 | N/A |
 | 0.15.x | >= 20.0 | >= 6.0 | >= 1.8 | >= 5.4 | N/A |

package/docs/releases/v0.35.0.md

@@ -0,0 +1,33 @@
+# TypeScript WSDL Client v0.35.0
+
+## Baseline Conformance And Node Policy
+
+This release expands the WSDL conformance baseline and raises the supported runtime floor to Node 24.
+
+## What This Improves
+
+Maintainers now have fixture-backed evidence for the common WSDL and XSD patterns that already form the everyday generation baseline: the canonical weather WSDL, complex sequences, simple type restrictions and lists, same-name simple type aliases, simple content with attributes, documentation propagation, SOAP binding detection, and relative XSD imports.
+
+The conformance harness also keeps its XML evidence self-contained under `test/conformance/fixtures/`, which makes the public support matrix easier to trust during release review. CI now covers Node 24 as the supported floor and Node 26 as the current line, while release workflows run on Node 24.
+
+## Highlights
+
+- Adds baseline WSDL and XSD conformance rows across compile, client, OpenAPI, gateway, generated-test, and app stages.
+- Raises the package engine floor to Node 24 and release-gates Node 24 and Node 26 CI coverage.
+- Keeps repository-owned temporary outputs in classified `tmp/` subfolders for smoke, conformance, preflight, npm cache, and generated-test workspaces.
+- Hardens generated gateway tests for scalar JSON payloads.
+
+## Upgrade Notes
+
+Consumers should run Node 24 or newer.
+
+## Validation
+
+- CI passed.
+- NPM package contents were validated.
+- Agent skill artifact was validated and packaged.
+- Release preflight passed against the target tag.
+
+## Notes
+
+Release tag: `v0.35.0`.

package/docs/roadmap/README.md

@@ -1,6 +1,6 @@
 # Version 1.0 Roadmap Plan
 
-Detailed plan for moving `@techspokes/typescript-wsdl-client` from the released `0.30.x` line to a stable `1.0.0` release.
+Detailed plan for moving `@techspokes/typescript-wsdl-client` from the current `0.x` line to a stable `1.0.0` release.
 
 See the root [README.md](../../README.md) for project overview and the root [ROADMAP.md](../../ROADMAP.md) for the public roadmap summary.
 
@@ -19,7 +19,7 @@ The plan is optimized for preserving quality. The contract and compatibility bas
 | Choice union mode     | [Choice Union Mode](v1.0-choice-union-mode.md)                               | complete          | Implemented in `0.26.0`         |
 | JSON array streaming  | [JSON Array Streaming](v1.0-json-array-streaming.md)                         | complete          | Implemented in `0.28.0`         |
 | Conformance framework | [Capability Conformance Framework](v1.0-capability-conformance-framework.md) | gate wired        | Pipeline claims are test-backed |
-| WSDL coverage matrix  | [WSDL Coverage Matrix](v1.0-wsdl-coverage-matrix.md)                         | gate wired        | Feature support is test-backed |
+| WSDL coverage matrix  | [WSDL Coverage Matrix](v1.0-wsdl-coverage-matrix.md)                         | baseline registry | Public support is test-backed |
 | Release candidate     | [Release Candidate Gates](v1.0-release-candidate-gates.md)                   | next              | 1.0 release is repeatable       |
 
 ## Execution Order
@@ -42,11 +42,11 @@ JSON array streaming is complete in `0.28.0`. The default `ndjson` format remain
 
 ### Slice 5: Capability Conformance Framework
 
-The registry, fixture strategy, compile runner, client evidence, OpenAPI evidence, gateway runtime evidence, generated-test evidence, app evidence, documentation drift check, generated support matrix, and validation-gate wiring are shipped. Keep `npm run test:conformance` as the focused local command while broad Vitest discovery covers conformance in `npm test`, `npm run ci`, and release preflight.
+The registry, fixture strategy, compile runner, client evidence, OpenAPI evidence, gateway runtime evidence, generated-test evidence, app evidence, documentation drift check, generated support matrix, and validation-gate wiring are shipped. The registry is the public baseline support source, while examples remain demos. Keep `npm run test:conformance` as the focused local command while broad Vitest discovery covers conformance in `npm test`, `npm run ci`, and release preflight.
 
 ### Slice 6: WSDL Coverage Matrix
 
-The first WSDL matrix rows now exist as conformance registry entries with compile, client, OpenAPI, gateway runtime, generated-test, app, documentation, and release-gate evidence. The next work is to keep those rows current while release candidate gates are prepared.
+The WSDL matrix rows now exist as conformance registry entries with compile, client, OpenAPI, gateway runtime, generated-test, app, documentation, and release-gate evidence. The next work is to keep those rows current while release candidate gates are prepared.
 
 ### Slice 7: Release Candidate Gates
 
@@ -85,6 +85,7 @@ Run the release candidate gates after feature work and documentation have conver
 
 - A capability conformance matrix runs under broad Vitest test automation.
 - Release preflight verifies the focused conformance command and CI wiring.
+- Release preflight verifies CI covers Node 24 and Node 26 and release workflows use Node 24.
 - Each matrix entry has a fixture, status, and stage expectations.
 - Unsupported features fail loudly or are documented as deliberately unsupported.
 

package/docs/roadmap/v1.0-release-candidate-gates.md

@@ -53,7 +53,7 @@ Run the generated example freshness check through release preflight. Confirm com
 
 ### Node Gate
 
-Run the supported Node.js floor and the newest active Node.js line in CI before the release candidate is accepted.
+Run Node 24 as the supported Node.js floor and Node 26 as the current line in CI before the release candidate is accepted. Release workflows should run on Node 24, and release preflight should fail if CI stops covering either line.
 
 ### Release Gate
 
@@ -67,6 +67,7 @@ Run `npm run release:preflight -- v1.0.0` during release preparation. Confirm re
 - Configuration docs describe both stream formats.
 - Supported patterns reflects the WSDL matrix.
 - The conformance gate documents `npm run test:conformance`, broad Vitest discovery, and release preflight wiring.
+- The Node gate documents Node 24 as the package floor and Node 26 as the current-line CI check.
 - Production docs describe terminal-error behavior for both stream formats.
 - Migration docs explain any behavior changes since `0.x`.
 

package/docs/roadmap/v1.0-wsdl-coverage-matrix.md

@@ -1,25 +1,25 @@
 # Version 1.0 WSDL Coverage Matrix
 
-Status: generated-test, app evidence, and validation-gate wiring shipped before `1.0.0`.
+Status: baseline support registry, generated-test evidence, app evidence, and validation-gate wiring shipped before `1.0.0`.
 
 Plan for turning WSDL and XSD support claims into automated, fixture-backed evidence before 1.0. This is the first domain under the [Capability Conformance Framework](v1.0-capability-conformance-framework.md).
 
-The initial fixture-backed compile matrix shipped in `0.30.2` and `0.30.3`. Client, OpenAPI, gateway runtime, generated-test, and app evidence now prove the current supported and partial rows, and terminal rows have executable diagnostics. `npm test` and `npm run ci` cover the conformance suite through broad Vitest discovery, and release preflight verifies that the script wiring remains intact.
+The initial fixture-backed compile matrix shipped in `0.30.2` and `0.30.3`. Client, OpenAPI, gateway runtime, generated-test, and app evidence now prove the current supported and partial rows, and terminal rows have executable diagnostics. The matrix is now the public baseline support registry. Examples remain demos, while conformance fixtures are the durable support evidence. `npm test` and `npm run ci` cover the conformance suite through broad Vitest discovery, and release preflight verifies that the script wiring remains intact.
 
 See the root [README.md](../../README.md) for project overview and [Version 1.0 Roadmap Plan](README.md) for the complete 1.0 route.
 
 ## Goal
 
-The project should have an automated WSDL and XSD feature matrix that proves which patterns are supported, partially supported, or rejected with diagnostics. The matrix should feed the conformance registry, align with `docs/supported-patterns.md`, and protect 1.0 from silent miscompilation.
+The project should have an automated WSDL and XSD feature matrix that proves which patterns are supported, partially supported, or rejected with diagnostics. The matrix is the conformance registry, aligns with `docs/supported-patterns.md`, and protects 1.0 from silent miscompilation.
 
 ## Design Direction
 
-Each matrix row should have a minimal fixture, an expected support status, and a test that proves the status. A supported feature must compile and generate aligned client, OpenAPI, and gateway artifacts where applicable. An unsupported feature must fail with a clear diagnostic or be documented as intentionally out of scope.
+Each matrix row should have a minimal fixture, an expected support status, and a test that proves the status. A supported or partial feature must compile and generate aligned client, OpenAPI, gateway, generated-test, and app artifacts unless the row documents why a stage is inapplicable. An unsupported, diagnostic, or terminal feature must stop before downstream generation and fail with a clear diagnostic or be documented as intentionally out of scope.
 
 ## Shipped Baseline
 
-- `test/conformance/fixtures/` contains the first priority WSDL fixture set.
-- `test/conformance/registry.ts` lists priority rows with status, decision, provenance, and public contract text.
+- `test/conformance/fixtures/` contains the baseline WSDL and XSD support fixture set.
+- `test/conformance/registry.ts` lists baseline support rows with status, decision, provenance, and public contract text.
 - `test/conformance/conformance.test.ts` runs compile-stage expectations for runnable rows.
 - Supported and partial rows generate client artifacts that type-check.
 - Supported and partial rows generate validated OpenAPI specs with targeted contract assertions.
@@ -32,7 +32,7 @@ Each matrix row should have a minimal fixture, an expected support status, and a
 
 - Keep diagnostics executable as more unsupported rows are added.
 - Keep fixture metadata useful for a future public conformance fixture corpus.
-- Preserve the weather smoke fixture as the canonical end-to-end happy path.
+- Preserve the weather smoke fixture as the canonical end-to-end demo while the copied conformance fixture proves the baseline support claim.
 
 ## Out Of Scope
 
@@ -45,6 +45,13 @@ Each matrix row should have a minimal fixture, an expected support status, and a
 
 | Feature                    | Expected 1.0 Status     | Notes                                 |
 |----------------------------|-------------------------|---------------------------------------|
+| Weather document-literal baseline | supported        | Canonical demo also lives in conformance |
+| Complex sequences          | supported               | Nested references, repeated fields, and optional wrappers |
+| Simple restrictions        | supported               | Enumerations, list aliases, and same-name aliases |
+| Simple content attributes  | supported               | `$value` text content and flattened attributes |
+| Documentation propagation  | supported               | Catalog, TypeScript, OpenAPI, and gateway comments |
+| SOAP binding detection     | supported               | SOAP 1.1, SOAP 1.2, and first SOAP binding behavior |
+| Relative XSD imports       | supported               | Local imports with committed companion XSDs |
 | `xs:choice` union mode     | supported               | Implemented in `0.26.0`               |
 | `xs:union`                 | supported               | Simple unions implemented after fixture work |
 | Abstract types             | diagnostic              | Avoid silent concrete treatment       |
@@ -97,8 +104,8 @@ Ensure every documented unsupported or partial feature has a corresponding matri
 ## Acceptance Criteria
 
 - The matrix includes every roadmap priority feature.
-- Supported rows have compile, client, and OpenAPI evidence when those stages apply.
-- Unsupported or diagnostic rows fail with clear diagnostics, or are explicitly deferred without support claims.
+- Supported and partial rows have compile, client, OpenAPI, gateway, generated-test, and app evidence when those stages apply.
+- Unsupported, diagnostic, or terminal rows fail with clear diagnostics, or are explicitly deferred without support claims.
 - `docs/supported-patterns.md` reflects the matrix.
 - No known feature silently miscompiles in matrix coverage.
 - The matrix can run in CI or release preflight without network access.
@@ -159,6 +166,7 @@ Work items:
 - Keep `npm run test:conformance` as the focused command for maintainers who want only conformance checks.
 - Keep `npm test` and `npm run ci` broad enough for Vitest to discover `test/conformance`.
 - Keep release preflight's `conformance-gate` script check aligned with the package scripts.
+- Keep release preflight's Node gate aligned with the package engine, Node 24 CI coverage, Node 26 CI coverage, and Node 24 release workflows.
 - Confirm release preflight runtime remains acceptable.
 - Keep diagnostic and unsupported rows stopped at compile.
 - Update public docs only when a row status or public contract changes.

package/docs/supported-patterns.md

@@ -9,6 +9,14 @@ The rows below are backed by committed conformance fixtures under `test/conforma
 <!-- support-matrix:start -->
 | Capability ID | Status | Public contract |
 |---|---|---|
+| `weather-document-literal-soap` | supported | The canonical weather WSDL compiles through client, OpenAPI, gateway, generated-test, and app artifacts with document-literal SOAP operations. |
+| `sequence-baseline-complex` | supported | Complex type sequences support nested complex references, repeated elements, optional fields, and all-optional request wrappers. |
+| `simple-restriction-list` | supported | Named simple type restrictions, enumerations, and `xs:list` declarations emit aligned TypeScript aliases and OpenAPI schemas. |
+| `same-name-simple-alias` | supported | A global element with the same local name as its named simple type reuses the scalar alias instead of emitting a duplicate wrapper interface. |
+| `simple-content-attributes` | supported | Simple content emits text content through `$value` and flattens XML attributes as peer properties. |
+| `documentation-propagation` | supported | WSDL and XSD documentation propagates into catalog metadata, generated TypeScript comments, OpenAPI descriptions, and gateway route comments. |
+| `soap12-first-binding` | supported | SOAP 1.1 and SOAP 1.2 bindings are detected, and the first SOAP binding deterministically provides operation binding metadata. |
+| `xsd-import-relative` | supported | Relative XSD imports are resolved and imported complex types participate in client, OpenAPI, gateway, generated-test, and app artifacts. |
 | `choice-union-simple` | supported | `xs:choice` union mode retains choice metadata and drives generated TypeScript/OpenAPI constraints. |
 | `xs-union-simple-type` | supported | Simple `xs:union` aliases compile to TypeScript unions and OpenAPI `oneOf` schemas. |
 | `abstract-complex-type` | diagnostic | Abstract complex types are rejected with a diagnostic instead of being treated as concrete. |

package/docs/testing.md

@@ -31,6 +31,22 @@ For the full CI pipeline including smoke tests:
 npm run ci
 ```
 
+## Node Support Policy
+
+The package supports Node.js >= 24.0.0. CI runs the complete project check on Node 24 and Node 26 so the supported floor and current Node line are both covered.
+
+## Temporary Workspaces
+
+Repository test and release automation keeps disposable output classified under `tmp/`:
+
+- `tmp/smoke/`: smoke-script client, OpenAPI, gateway, app, and catalog output
+- `tmp/cache/npm/`: local npm cache used by package and dependency checks
+- `tmp/preflight/examples/`: regenerated examples used by release preflight
+- `tmp/conformance/`: conformance mini-projects that need repository-local module resolution
+- `tmp/test-generation/`: generated-test integration spikes
+
+Keep new repository-owned temporary writers under the closest existing subfolder. Public CLI examples may still use simple `tmp/...` paths when those examples are clearer for users.
+
 ## Unit Tests
 
 Unit tests cover pure functions with no I/O or side effects:
@@ -180,6 +196,8 @@ npm run test:conformance
 
 `npm test` includes the conformance suite through normal Vitest discovery. `npm run ci` and release preflight cover conformance through that broad test command, while release preflight also checks that the focused command and broad CI discovery remain wired.
 
+Examples under `examples/` are consumer-facing demos and smoke-test inputs. Reusable WSDL and XSD behavior that represents a public support claim belongs in `test/conformance/fixtures/` with a matching registry row.
+
 ## Known Issues
 
 ### ArrayOf* Schema-Type Mismatch (Resolved)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techspokes/typescript-wsdl-client",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "description": "Turn legacy WSDL/SOAP services into typed TypeScript clients, OpenAPI 3.1 specs, and production-ready Fastify REST gateways. Built for enterprise SOAP modernization.",
   "keywords": [
     "wsdl",
@@ -35,7 +35,7 @@
   ],
   "type": "module",
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=24.0.0"
   },
   "bin": {
     "wsdl-tsc": "dist/cli.js"
@@ -74,12 +74,12 @@
     "test:watch": "vitest",
     "prepublishOnly": "npm run clean && npm run build && npm run package:validate",
     "smoke:reset": "npm run clean:tmp",
-    "smoke:compile": "npm run smoke:reset && tsx src/cli.ts compile --wsdl-source examples/minimal/weather.wsdl --catalog-file tmp/catalog.json",
-    "smoke:client": "npm run smoke:reset && tsx src/cli.ts client --wsdl-source examples/minimal/weather.wsdl --client-dir tmp/client && tsc -p tsconfig.smoke.json",
-    "smoke:openapi": "npm run smoke:reset && tsx src/cli.ts openapi --wsdl-source examples/minimal/weather.wsdl --openapi-file tmp/openapi.json --openapi-format json && tsc -p tsconfig.smoke.json",
-    "smoke:gateway": "npm run smoke:reset && tsx src/cli.ts client --wsdl-source examples/minimal/weather.wsdl --client-dir tmp/client && tsx src/cli.ts openapi --catalog-file tmp/client/catalog.json --openapi-file tmp/openapi.json --openapi-format json && tsx src/cli.ts gateway --openapi-file tmp/openapi.json --client-dir tmp/client --gateway-dir tmp/gateway --gateway-service-name weather --gateway-version-prefix v1 && tsc -p tsconfig.smoke.json",
-    "smoke:pipeline": "npm run smoke:reset && tsx src/cli.ts pipeline --wsdl-source examples/minimal/weather.wsdl --client-dir tmp/client --openapi-file tmp/openapi.json --gateway-dir tmp/gateway --gateway-service-name weather --gateway-version-prefix v1 --openapi-format json --init-app && tsc -p tsconfig.smoke.json",
-    "smoke:app": "npm run smoke:reset && tsx src/cli.ts pipeline --wsdl-source examples/minimal/weather.wsdl --client-dir tmp/client --openapi-file tmp/openapi.json --gateway-dir tmp/gateway --gateway-service-name weather --gateway-version-prefix v1 --openapi-format json --openapi-servers https://example.com/api && tsx src/cli.ts app --client-dir tmp/client --gateway-dir tmp/gateway --openapi-file tmp/openapi.json --app-dir tmp/app --port 8080 && tsc -p tsconfig.smoke.json",
+    "smoke:compile": "npm run smoke:reset && tsx src/cli.ts compile --wsdl-source examples/minimal/weather.wsdl --catalog-file tmp/smoke/catalog.json",
+    "smoke:client": "npm run smoke:reset && tsx src/cli.ts client --wsdl-source examples/minimal/weather.wsdl --client-dir tmp/smoke/client && tsc -p tsconfig.smoke.json",
+    "smoke:openapi": "npm run smoke:reset && tsx src/cli.ts openapi --wsdl-source examples/minimal/weather.wsdl --openapi-file tmp/smoke/openapi.json --openapi-format json && tsc -p tsconfig.smoke.json",
+    "smoke:gateway": "npm run smoke:reset && tsx src/cli.ts client --wsdl-source examples/minimal/weather.wsdl --client-dir tmp/smoke/client && tsx src/cli.ts openapi --catalog-file tmp/smoke/client/catalog.json --openapi-file tmp/smoke/openapi.json --openapi-format json && tsx src/cli.ts gateway --openapi-file tmp/smoke/openapi.json --client-dir tmp/smoke/client --gateway-dir tmp/smoke/gateway --gateway-service-name weather --gateway-version-prefix v1 && tsc -p tsconfig.smoke.json",
+    "smoke:pipeline": "npm run smoke:reset && tsx src/cli.ts pipeline --wsdl-source examples/minimal/weather.wsdl --client-dir tmp/smoke/client --openapi-file tmp/smoke/openapi.json --gateway-dir tmp/smoke/gateway --gateway-service-name weather --gateway-version-prefix v1 --openapi-format json --init-app && tsc -p tsconfig.smoke.json",
+    "smoke:app": "npm run smoke:reset && tsx src/cli.ts pipeline --wsdl-source examples/minimal/weather.wsdl --client-dir tmp/smoke/client --openapi-file tmp/smoke/openapi.json --gateway-dir tmp/smoke/gateway --gateway-service-name weather --gateway-version-prefix v1 --openapi-format json --openapi-servers https://example.com/api && tsx src/cli.ts app --client-dir tmp/smoke/client --gateway-dir tmp/smoke/gateway --openapi-file tmp/smoke/openapi.json --app-dir tmp/smoke/app --port 8080 && tsc -p tsconfig.smoke.json",
     "maint:deps": "node scripts/maint-deps.mjs",
     "docs:support-matrix": "tsx scripts/generate-support-matrix.ts",
     "docs:support-matrix:check": "tsx scripts/generate-support-matrix.ts --check",

package/src/runtime/clientStreamMethods.tpl.txt

@@ -163,7 +163,7 @@
   }
 
   /**
-   * Iterate an uploaded web ReadableStream as Uint8Array chunks. Node 20+
+   * Iterate an uploaded web ReadableStream as Uint8Array chunks. Node 24+
    * ReadableStream implements Symbol.asyncIterator natively; this helper
    * normalizes the types so TypeScript can drive it through \`for await\`.
    */