altium-toolkit 1.4.17 → 1.4.19

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/docs/model-format.md

@@ -640,3 +640,13 @@ Focused machine-readable schemas are available under
 `docs/schemas/altium_toolkit/` for the normalized root plus focused project,
 netlist, SVG, PCB review, layer-stack, Draftsman, library, parser QA,
 inspection, unsupported-feature, and CI/reporting contracts.
+
+## Loaded net-name queries
+
+The `LoadedDesignNetlistService` extension lists and searches declared names in
+`schematic.nets` and `pcb.nets`, including named nets without component pins.
+Names are trimmed, deduplicated, and sorted. Retained native document envelopes
+use the same lookup. Missing net names still produce a missing-data error.
+
+Net listing does not create schematic connectivity: `hasConnectivity`, component
+pin queries, and extended-net traversal continue to use the schematic pin graph.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "altium-toolkit",
-    "version": "1.4.17",
+    "version": "1.4.19",
     "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'
@@ -95,13 +96,20 @@ export class LoadedDesignNetlistService {
      * @returns {{ nets: string[] } | { error: string }}
      */
     listNets(args = {}) {
-        const resolved = this.#resolveDesignWithConnectivity(args.design)
+        const resolved = this.#resolveDesign(args.design)
         if (resolved.error) return resolved
 
+        const netNames = LoadedDesignNetlistService.#netNames(
+            resolved.entry.documentModel
+        )
+        if (!netNames.length) {
+            return {
+                error: 'No schematic connectivity is available for this loaded design.'
+            }
+        }
+
         return {
-            nets: Object.keys(resolved.netlist.nets).sort((left, right) =>
-                left.localeCompare(right)
-            )
+            nets: netNames.sort((left, right) => left.localeCompare(right))
         }
     }
 
@@ -111,13 +119,22 @@ export class LoadedDesignNetlistService {
      * @returns {{ results: Record<string, string[]>, notes?: string[] } | { error: string }}
      */
     searchNets(args = {}) {
-        const resolved = this.#resolveDesignWithConnectivity(args.design)
+        const resolved = this.#resolveDesign(args.design)
         if (resolved.error) return resolved
 
+        const netNames = LoadedDesignNetlistService.#netNames(
+            resolved.entry.documentModel
+        )
+        if (!netNames.length) {
+            return {
+                error: 'No schematic connectivity is available for this loaded design.'
+            }
+        }
+
         const parsed = RegexPattern.parse(args.pattern)
         if (parsed.error) return parsed
 
-        const allNets = Object.keys(resolved.netlist.nets)
+        const allNets = netNames
         if (RegexPattern.rejectsBroadMatch(args.pattern, allNets)) {
             return {
                 error: 'Pattern matches every net. Use list_nets for full net lists.'
@@ -388,6 +405,24 @@ export class LoadedDesignNetlistService {
         return response
     }
 
+    /**
+     * Lists declared net names independently of schematic pin connectivity.
+     * @param {object} documentModel Resolved native document model.
+     * @returns {string[]} Unique nonempty net names.
+     */
+    static #netNames(documentModel) {
+        // Listing names does not require the pin graph used for traversal.
+        return [
+            ...new Set(
+                [documentModel?.schematic?.nets, documentModel?.pcb?.nets]
+                    .filter(Array.isArray)
+                    .flatMap((nets) => nets)
+                    .map((net) => String(net?.name || '').trim())
+                    .filter(Boolean)
+            )
+        ]
+    }
+
     /**
      * Resolves one design and requires schematic connectivity.
      * @param {string | undefined} design Design selector.
@@ -571,7 +606,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,