@techspokes/typescript-wsdl-client 0.33.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.34.0.md

@@ -0,0 +1,30 @@
+# TypeScript WSDL Client v0.34.0
+
+## Conformance Gate Readiness
+
+This release makes WSDL conformance coverage explicit in the release preflight path without adding a duplicate full test run.
+
+## What This Improves
+
+Maintainers can now see whether the focused conformance command, broad Vitest discovery, and CI script still line up before a release tag is created. The roadmap also now treats conformance gate wiring as shipped, which moves the 1.0 plan toward resolving remaining explicit deferrals and running release-candidate gates.
+
+## Highlights
+
+- Adds a release preflight `conformance-gate` check for `test:conformance`, `npm test`, and `npm run ci` wiring.
+- Documents `npm run test:conformance` as the focused command for WSDL capability rows and fixtures.
+- Updates the 1.0 roadmap so validation-gate wiring is no longer an open decision.
+
+## Upgrade Notes
+
+No special upgrade steps.
+
+## 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.34.0`.

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.
 
@@ -8,7 +8,7 @@ See the root [README.md](../../README.md) for project overview and the root [ROA
 
 This plan turns the 1.0 roadmap into implementation slices that can be picked up independently. Each slice has its own plan document with scope, testing strategy, acceptance gates, and release implications.
 
-The plan is optimized for preserving quality. The contract and compatibility baselines now exist, choice union mode is shipped, and JSON array streaming is shipped. The remaining readiness work is the capability conformance framework, WSDL coverage evidence, and the final release candidate gate pass.
+The plan is optimized for preserving quality. The contract and compatibility baselines now exist, choice union mode is shipped, JSON array streaming is shipped, and the conformance framework is wired into validation gates. The remaining readiness work is to resolve any explicit conformance deferrals and run the final release candidate gate pass.
 
 ## Route Summary
 
@@ -18,9 +18,9 @@ The plan is optimized for preserving quality. The contract and compatibility bas
 | OpenAPI compatibility | [OpenAPI Fastify Compatibility](v1.0-openapi-fastify-compatibility.md)       | baseline complete | Schema strategy is proven       |
 | 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) | phase 4 shipped   | Pipeline claims are test-backed |
-| WSDL coverage matrix  | [WSDL Coverage Matrix](v1.0-wsdl-coverage-matrix.md)                         | generated artifacts proven | Feature support is test-backed |
-| Release candidate     | [Release Candidate Gates](v1.0-release-candidate-gates.md)                   | remaining         | 1.0 release is repeatable       |
+| 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)                         | 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, and generated support matrix are shipped. The next work is to wire the right conformance subset into validation gates without making local development too slow.
+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, and documentation 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
 
@@ -54,7 +54,6 @@ Run the release candidate gates after feature work and documentation have conver
 
 ## Remaining Before 1.0
 
-- Decide which conformance checks should run in CI, release preflight, or local-only workflows.
 - Turn remaining unsupported, diagnostic, or partial matrix rows into diagnostics, documentation, or scoped fixes.
 - Confirm `docs/supported-patterns.md` matches the matrix.
 - Run the release-candidate gates.
@@ -84,7 +83,9 @@ Run the release candidate gates after feature work and documentation have conver
 
 ### Coverage Gate
 
-- A capability conformance matrix runs under test automation.
+- 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-capability-conformance-framework.md

@@ -1,10 +1,10 @@
 # Version 1.0 Capability Conformance Framework
 
-Status: Phase 4 shipped; validation-gate wiring remaining before `1.0.0`.
+Status: Phase 5 shipped; release-candidate gate pass remaining before `1.0.0`.
 
 Plan for turning SOAP, WSDL, OpenAPI, gateway, app, generated-test, and documentation support claims into fixture-backed conformance evidence.
 
-Phase 1 shipped a TypeScript registry, reusable WSDL fixtures, compile-stage runner, documentation drift tests, and generated public support matrix. Phase 2 added generated client type-checking, OpenAPI validation, and executable diagnostics for terminal rows. Phase 3 added generated gateway type-checking and Fastify runtime evidence for current supported and partial rows. Phase 4 added generated-test and app scaffold evidence for those rows.
+Phase 1 shipped a TypeScript registry, reusable WSDL fixtures, compile-stage runner, documentation drift tests, and generated public support matrix. Phase 2 added generated client type-checking, OpenAPI validation, and executable diagnostics for terminal rows. Phase 3 added generated gateway type-checking and Fastify runtime evidence for current supported and partial rows. Phase 4 added generated-test and app scaffold evidence for those rows. Phase 5 wired conformance into validation gates through broad Vitest discovery and release preflight script verification.
 
 See the root [README.md](../../README.md) for project overview and [Version 1.0 Roadmap Plan](README.md) for the complete 1.0 route.
 
@@ -545,12 +545,15 @@ Acceptance criteria:
 
 ## Phase 5: Documentation And Release Gates
 
-Wire the conformance framework into docs validation, CI, or release preflight once runtime cost is acceptable. Keep a focused command for maintainers who want only conformance checks.
+Phase 5 is implemented. Keep this section as the baseline for conformance gate ownership.
+
+`npm run test:conformance` remains the focused maintainer command for WSDL capability rows. `npm test` and `npm run ci` cover conformance through broad Vitest discovery, so release preflight does not run a duplicate full conformance pass. Release preflight instead runs a cheap `conformance-gate` script check that fails if the focused command disappears, if `npm test` becomes scoped away from `test/conformance`, or if `npm run ci` stops running the broad test command.
 
 Acceptance criteria:
 
 - `docs/supported-patterns.md` cannot drift from the registry.
-- CI or release preflight runs the selected conformance subset.
+- CI runs conformance through broad Vitest discovery.
+- Release preflight verifies conformance command and CI wiring.
 - Full conformance can run locally before `1.0.0`.
 - Release notes can cite capability IDs for behavior changes.
 
@@ -567,7 +570,6 @@ Acceptance criteria:
 
 ## Open Decisions
 
-- Decide how much generated output type-checking is acceptable in CI runtime.
 - Decide which inspector output format becomes public before `1.0.0`.
 - Decide whether docs should remain manually maintained or eventually generated from the registry.
 

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

@@ -33,7 +33,11 @@ Run `npm run docs:validate`. Confirm README, CLI reference, API reference, confi
 
 ### Test Gate
 
-Run `npm test`. Confirm unit, snapshot, and integration suites cover the 1.0 contract.
+Run `npm test`. Confirm unit, snapshot, integration, and conformance suites cover the 1.0 contract.
+
+### Conformance Gate
+
+Run `npm run test:conformance` when changing capability rows or fixture-backed behavior. Confirm `npm test` and `npm run ci` keep broad Vitest discovery so `test/conformance` stays covered, and confirm release preflight reports a passing `conformance-gate` script check.
 
 ### Smoke Gate
 
@@ -49,11 +53,11 @@ 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
 
-Run `npm run release:preflight -- v1.0.0` during release preparation. Confirm release notes, changelog, dependency pins, generated examples, CI, and skill packaging pass.
+Run `npm run release:preflight -- v1.0.0` during release preparation. Confirm release notes, changelog, dependency pins, conformance wiring, generated examples, CI, and skill packaging pass.
 
 ## Documentation Checklist
 
@@ -62,6 +66,8 @@ Run `npm run release:preflight -- v1.0.0` during release preparation. Confirm re
 - API reference lists implemented options only.
 - 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 and app evidence shipped; validation-gate wiring remaining 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. The remaining work is to decide which conformance checks belong in CI and release preflight.
+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.
@@ -30,10 +30,9 @@ Each matrix row should have a minimal fixture, an expected support status, and a
 
 ## Remaining Scope
 
-- Decide which conformance checks should run in CI, release preflight, and focused local commands.
 - 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
 
@@ -46,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       |
@@ -98,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.
@@ -153,12 +159,14 @@ Partial rows must prove only the documented subset. `xs:anyAttribute` should not
 
 ### Next Slice
 
-The next slice is Phase 5 documentation and release-gate wiring. Implement it before adding more feature rows unless a production bug requires a focused diagnostic or support decision.
+The next slice is release-candidate preparation. Run it before adding more feature rows unless a production bug requires a focused diagnostic or support decision.
 
 Work items:
 
-- Decide whether `npm run test:conformance` should run in CI, release preflight, or both.
-- Keep a focused command for maintainers who want only conformance checks.
+- 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

@@ -21,6 +21,7 @@ npm test              # All Vitest tests
 npm run test:unit     # Unit tests only
 npm run test:snap     # Snapshot tests only
 npm run test:integration  # Integration tests only
+npm run test:conformance  # WSDL capability conformance tests only
 npm run test:watch    # Watch mode for development
 ```
 
@@ -30,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:
@@ -169,6 +186,18 @@ import { pathToFileURL } from "node:url";
 const pluginModule = await import(pathToFileURL(join(outDir, "gateway", "plugin.ts")).href);
 ```
 
+## Conformance Tests
+
+Conformance tests live under `test/conformance/` and prove WSDL capability claims through committed fixtures, registry rows, generated artifacts, diagnostics, and documentation alignment. Use the focused command when changing capability rows or fixture-backed behavior:
+
+```bash
+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.33.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\`.
    */