altium-toolkit 1.3.0 → 1.4.0

package/README.md

@@ -39,6 +39,12 @@ missing-image placeholder for those unusable payloads without changing the
 frozen native parser or healthy embedded images. See the
 [1.3.0 release notes](docs/release-notes-v1.3.0.md).
 
+Version 1.4.0 adopts newly decoded CircuitJSON and native extension graphs at
+the shared validation boundary. Their ordinary nodes retain identity and are
+deeply frozen without a redundant defensive graph copy. Parser parameters,
+document envelopes, extension fields, and return shapes remain unchanged. See
+the [1.4.0 release notes](docs/release-notes-v1.4.0.md).
+
 Default `extensions: 'canonical'` keeps compact Altium summary metadata.
 Request the complete native read model with `extensions: 'full'`,
 `preserveRaw: true`, or `extensions: ['altium.native-model']`. Project batches
@@ -206,6 +212,7 @@ const legacyCircuitJson = AltiumParser.parseArrayBuffer(file.name, arrayBuffer)
 - [API](docs/api.md)
 - [Capabilities](docs/capabilities.md)
 - [Migration from 1.1.41](docs/migration.md)
+- [1.4.0 release notes](docs/release-notes-v1.4.0.md)
 - [1.3.0 release notes](docs/release-notes-v1.3.0.md)
 - [1.2.1 release notes](docs/release-notes-v1.2.1.md)
 - [1.2.0 release notes](docs/release-notes-v1.2.0.md)

package/docs/api.md

@@ -111,6 +111,13 @@ metadata. The complete recovered native read model remains available through
 `document.model` and do not require the full native extension.
 `extensions: 'none'` or `extensions: []` returns exactly `extensions: {}`.
 
+The convergence builder transfers its newly decoded ordinary CircuitJSON and
+native extension graphs into the shared owned-document validator. Eligible
+graph nodes retain identity and are deeply frozen in place, avoiding a second
+full defensive copy. This is an internal ownership optimization after source
+decoding: raw caller data remains untrusted, and every public parser parameter,
+validation rule, document field, and return shape is unchanged.
+
 Canonical `.SchDoc` models preserve native drawing order, ownership, geometry,
 and style as shared `schematic_rect`, `schematic_circle`, `schematic_arc`,
 `schematic_path`, `schematic_text`, `schematic_table`, and

package/docs/release-notes-v1.4.0.md

@@ -0,0 +1,37 @@
+# altium-toolkit 1.4.0
+
+Version 1.4.0 adopts parser-owned CircuitJSON and retained native extension
+graphs through the CircuitJSON Toolkit 1.4 ownership boundary. It removes a
+redundant defensive graph copy from successful document construction without
+weakening validation or immutability.
+
+## Owned convergence graphs
+
+- The Altium convergence builder uses
+  `DocumentResult.createValidatedOwned(fields, runtime?)` for graphs it has
+  just constructed and exclusively owns.
+- Ordinary CircuitJSON model and native extension nodes retain their identities
+  and are deeply frozen in place. Binary properties continue through the
+  shared defensive binary boundary.
+- Raw input remains untrusted and is decoded and validated normally. The owned
+  path is applied only after the format parser has produced a new standard
+  local graph.
+
+## API and compatibility
+
+- Parser input, options, progress, cancellation, worker, and project contracts
+  are unchanged.
+- Successful parsing returns the same `ecad-toolkit.document.v1` envelope with
+  the same `model`, `source`, `extensions`, `assets`, `diagnostics`, and
+  `statistics` fields.
+- Canonical, metadata, full native-model, and empty extension selections retain
+  their existing behavior and return shapes.
+- No class, method, parameter, package subpath, native extension, or renderer
+  behavior is removed or renamed.
+
+## Performance verification
+
+The shared ownership regressions verify retained identity, deep freeze,
+bounded extension sealing, mutation isolation, binary protection, and direct
+and worker result parity. The Altium parser and packed cross-toolkit suites
+continue to validate the public envelope and renderer contracts.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "altium-toolkit",
-    "version": "1.3.0",
+    "version": "1.4.0",
     "description": "Altium document parsing and non-interactive rendering utilities",
     "keywords": [
         "altium",
@@ -67,7 +67,7 @@
         "check:features": "node scripts/check-feature-preservation.mjs"
     },
     "dependencies": {
-        "circuitjson-toolkit": "^1.2.0",
+        "circuitjson-toolkit": "^1.4.0",
         "fflate": "^0.8.2"
     },
     "devDependencies": {

package/src/convergence/AltiumDocumentBuilder.mjs

@@ -57,7 +57,7 @@ export class AltiumDocumentBuilder {
             normalized.options.retainSource === 'reference'
                 ? { sourceReference: normalized.sourceReference }
                 : {}
-        return DocumentResult.createValidated(
+        return DocumentResult.createValidatedOwned(
             {
                 model,
                 source: {