altium-toolkit 1.4.17 → 1.4.18

package/docs/api.md

@@ -619,3 +619,13 @@ Each script reads one input file and writes text, CSV, or JSON to stdout. The
 corpus smoke script reads a caller-provided directory and can include aggregate
 parser coverage and field-gap counters. The scripts are examples of library
 usage, not installed package binaries.
+
+## Loaded queries and retained native models
+
+`LoadedDesignNetlistService` also accepts canonical document envelopes whose
+explicit `extensions.altium.native` field retains the normalized source model.
+The library resolves that model before design discovery, component/net queries,
+and traversal, preserving session ids and active selection. Callers do not need
+to unwrap documents or add legacy properties to the canonical envelope.
+Canonical documents without a retained native model should use the shared
+`QueryService` from `altium-toolkit/query` instead of this native query API.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "altium-toolkit",
-    "version": "1.4.17",
+    "version": "1.4.18",
     "description": "Altium document parsing and non-interactive rendering utilities",
     "keywords": [
         "altium",

package/src/core/netlist-query/LoadedDesignNetlistService.mjs

@@ -2,6 +2,7 @@
 //
 // SPDX-License-Identifier: GPL-3.0-or-later
 
+import { AltiumExtensionResolver } from '../../convergence/AltiumExtensionResolver.mjs'
 import { ComponentGrouping, MPN_MISSING_NOTE } from './ComponentGrouping.mjs'
 import { CircuitTraversal } from './CircuitTraversal.mjs'
 import { QueryNetlistBuilder } from './QueryNetlistBuilder.mjs'
@@ -571,7 +572,10 @@ export class LoadedDesignNetlistService {
      * @returns {object}
      */
     static #normalizeEntry(entry) {
-        const documentModel = entry?.documentModel || entry
+        const sourceDocument = entry?.documentModel || entry
+        const documentModel =
+            AltiumExtensionResolver.nativeModel(sourceDocument) ||
+            sourceDocument
         return {
             id: String(entry?.id || documentModel?.id || ''),
             active: entry?.active === true,