altium-toolkit 1.4.0 → 1.4.2

package/README.md

@@ -45,6 +45,18 @@ 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).
+
+Version 1.4.2 rebuilds project-resolved canonical documents through the
+toolkit-owned validation path and CircuitJSON Toolkit 1.4.2. Large native
+extension graphs retain their proven ownership instead of repeating defensive
+binary classification. See the
+[1.4.2 release notes](docs/release-notes-v1.4.2.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
@@ -212,6 +224,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.2 release notes](docs/release-notes-v1.4.2.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)

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:
 

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/docs/release-notes-v1.4.2.md

@@ -0,0 +1,27 @@
+# altium-toolkit 1.4.2
+
+Version 1.4.2 removes redundant immutable-extension validation from canonical
+project document rebuilding. Parser output, project resolution, extension
+selection, and renderer contracts remain unchanged.
+
+## Faster project resolution
+
+- `AltiumProjectDocumentResolver` rebuilds changed canonical documents through
+  the shared toolkit-owned `DocumentResult` boundary.
+- Already proven and frozen native extension graphs retain their identity when
+  project parameters update canonical or retained-native schematic text.
+- Defensive binary classification is no longer repeated across every record of
+  a large owned extension graph.
+
+## Dependency
+
+- `circuitjson-toolkit` 1.4.2 supplies the owned-extension reuse and atomic
+  cooperative structured-clone finalization behavior.
+- Arbitrary caller data still uses the defensive shared validation path.
+
+## Verification
+
+- An inspector-backed regression bounds exception-driven binary brand probes
+  during a project rebuild.
+- The complete package suite, formatting, performance, feature-preservation,
+  and npm dry-run gates verify the release.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "altium-toolkit",
-    "version": "1.4.0",
+    "version": "1.4.2",
     "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.4.0",
+        "circuitjson-toolkit": "^1.4.2",
         "fflate": "^0.8.2"
     },
     "devDependencies": {

package/src/convergence/AltiumProjectDocumentResolver.mjs

@@ -239,13 +239,13 @@ export class AltiumProjectDocumentResolver {
     }
 
     /**
-     * Rebuilds one canonical document through the validating shared boundary.
+     * Rebuilds one canonical document through the toolkit-owned shared boundary.
      * @param {object} document Existing canonical document.
      * @param {{ model?: object[], extensions?: object, statistics?: object }} fields Replacements.
      * @returns {object} Proven immutable document.
      */
     static #rebuild(document, fields) {
-        return DocumentResult.createValidated(
+        return DocumentResult.createValidatedOwned(
             {
                 id: document.id,
                 model: fields.model || document.model,

package/src/index.mjs

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