altium-toolkit 1.4.18 → 1.4.19

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.18",
+    "version": "1.4.19",
     "description": "Altium document parsing and non-interactive rendering utilities",
     "keywords": [
         "altium",

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

@@ -96,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))
         }
     }
 
@@ -112,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.'
@@ -389,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.