altium-toolkit 1.3.0 → 1.4.1

package/README.md

@@ -39,6 +39,18 @@ 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).
+
+Version 1.4.1 re-exports the canonical `SelfAdjustingComputation` runtime from
+CircuitJSON Toolkit 1.4.1. Persistent Altium consumers can retain dependency
+traces across input edits without changing parser, document, renderer, or
+native-extension contracts. See the
+[1.4.1 release notes](docs/release-notes-v1.4.1.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 +218,8 @@ 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.1 release notes](docs/release-notes-v1.4.1.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

@@ -13,7 +13,7 @@ the method documents a narrower input.
 
 ## Entrypoints
 
-The root exports exactly these 17 shared classes:
+The root exports exactly these 18 shared classes:
 
 - `Parser`, `ProjectLoader`, `CircuitJsonDocument`,
   `CircuitJsonDocumentContext`, `CircuitJsonIndexer`, and `CircuitJsonUnits`
@@ -22,6 +22,7 @@ The root exports exactly these 17 shared classes:
 - `ManufacturingService` and `SimulationService`
 - `PcbScene3dBuilder` and `PcbScene3dPreparator`
 - `ToolkitCapabilities` and `ToolkitError`
+- `SelfAdjustingComputation`
 
 Specialized entrypoints are also available:
 
@@ -111,6 +112,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/docs/release-notes-v1.4.1.md

@@ -0,0 +1,29 @@
+# altium-toolkit 1.4.1
+
+Version 1.4.1 exposes the shared self-adjusting computation runtime throughout
+the ECAD toolkit family while preserving every Altium parsing and rendering
+contract.
+
+## Shared incremental runtime
+
+- The root entrypoint re-exports `SelfAdjustingComputation` from
+  `circuitjson-toolkit` 1.4.1.
+- The runtime records dynamic data and control dependencies, invalidates only
+  changed reader traces, replaces stale branches, and reclaims retired graph
+  nodes explicitly.
+- Persistent consumers can update mutable input cells and stabilize affected
+  computations without rebuilding unrelated derived work.
+
+## Compatibility
+
+- Parser options, immutable document and project envelopes, native extension
+  namespaces, renderer output, workers, and service return shapes are
+  unchanged.
+- The release contains no Altium-specific incremental special cases; it shares
+  the canonical runtime object used by the other toolkits.
+
+## Verification
+
+- API tests prove that the root export is the canonical CircuitJSON runtime.
+- Release gates include the complete package suite, formatting, performance
+  checks, feature-preservation validation, and npm package dry run.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "altium-toolkit",
-    "version": "1.3.0",
+    "version": "1.4.1",
     "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.1",
         "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: {

package/src/index.mjs

@@ -14,6 +14,7 @@ export {
     PcbSvgRenderer,
     QueryService,
     SchematicSvgRenderer,
+    SelfAdjustingComputation,
     SimulationService,
     ToolkitError
 } from 'circuitjson-toolkit'