altium-toolkit 1.0.9 → 1.1.0

package/src/core/circuit-json/CircuitJsonModelAdapterPcbElements.mjs

@@ -0,0 +1,244 @@
+// SPDX-FileCopyrightText: 2026 André Fiedler
+//
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+import { CircuitJsonModelAdapterPrimitives } from './CircuitJsonModelAdapterPrimitives.mjs'
+
+const Primitives = CircuitJsonModelAdapterPrimitives
+
+/**
+ * Builds upstream-compatible Circuit JSON PCB element records.
+ */
+export class CircuitJsonModelAdapterPcbElements {
+    /**
+     * Builds an upstream-compatible SMT pad element.
+     * @param {string} idScope
+     * @param {Record<string, unknown>} pad
+     * @param {number} padIndex
+     * @param {string} pcbComponentId
+     * @param {string} pcbPortId
+     * @param {{ x: number, y: number }} center
+     * @param {string} layer
+     * @param {string[]} portHints
+     * @returns {object}
+     */
+    static smtPad(
+        idScope,
+        pad,
+        padIndex,
+        pcbComponentId,
+        pcbPortId,
+        center,
+        layer,
+        portHints
+    ) {
+        const shape = Primitives.padShape(pad)
+        const width = Primitives.milNumber(
+            pad.sizeTopX || pad.sizeX || pad.width,
+            0
+        )
+        const height = Primitives.milNumber(
+            pad.sizeTopY || pad.sizeY || pad.height,
+            0
+        )
+        const rotation = Primitives.number(pad.rotation || pad.holeRotation, 0)
+        const base = {
+            type: 'pcb_smtpad',
+            pcb_smtpad_id: Primitives.id(idScope, ['pcb_smtpad', padIndex]),
+            pcb_component_id: pcbComponentId,
+            pcb_port_id: pcbPortId,
+            x: center.x,
+            y: center.y,
+            layer,
+            port_hints: portHints
+        }
+
+        if (shape === 'circle') {
+            return {
+                ...base,
+                shape,
+                radius: Primitives.round(Math.max(width, height) / 2)
+            }
+        }
+
+        if (shape === 'pill') {
+            return {
+                ...base,
+                shape: CircuitJsonModelAdapterPcbElements.#hasRotation(rotation)
+                    ? 'rotated_pill'
+                    : 'pill',
+                width,
+                height,
+                radius: Primitives.round(Math.min(width, height) / 2),
+                ...CircuitJsonModelAdapterPcbElements.#ccwRotationField(
+                    rotation
+                )
+            }
+        }
+
+        return {
+            ...base,
+            shape: CircuitJsonModelAdapterPcbElements.#hasRotation(rotation)
+                ? 'rotated_rect'
+                : 'rect',
+            width,
+            height,
+            ...CircuitJsonModelAdapterPcbElements.#ccwRotationField(rotation)
+        }
+    }
+
+    /**
+     * Builds an upstream-compatible non-plated hole element.
+     * @param {string} idScope
+     * @param {Record<string, unknown>} pad
+     * @param {number} padIndex
+     * @param {string} pcbComponentId
+     * @param {{ x: number, y: number }} center
+     * @returns {object}
+     */
+    static hole(idScope, pad, padIndex, pcbComponentId, center) {
+        const shape = Primitives.padShape(pad)
+        const width = Primitives.milNumber(
+            pad.sizeTopX || pad.sizeX || pad.width || pad.diameter,
+            0
+        )
+        const height = Primitives.milNumber(
+            pad.sizeTopY || pad.sizeY || pad.height || pad.diameter,
+            0
+        )
+        const holeDiameter = Primitives.milNumber(pad.holeDiameter, 0)
+        const base = {
+            type: 'pcb_hole',
+            pcb_hole_id: Primitives.id(idScope, ['pcb_hole', padIndex]),
+            pcb_component_id: pcbComponentId,
+            x: center.x,
+            y: center.y
+        }
+
+        if (shape === 'circle') {
+            return {
+                ...base,
+                hole_shape: 'circle',
+                hole_diameter: holeDiameter
+            }
+        }
+
+        return {
+            ...base,
+            hole_shape: shape === 'pill' ? 'pill' : 'rect',
+            hole_width: holeDiameter || width,
+            hole_height: holeDiameter || height
+        }
+    }
+
+    /**
+     * Builds an upstream-compatible plated hole element.
+     * @param {string} idScope
+     * @param {Record<string, unknown>} pad
+     * @param {number} padIndex
+     * @param {string} pcbComponentId
+     * @param {string} pcbPortId
+     * @param {{ x: number, y: number }} center
+     * @param {string[]} portHints
+     * @returns {object}
+     */
+    static platedHole(
+        idScope,
+        pad,
+        padIndex,
+        pcbComponentId,
+        pcbPortId,
+        center,
+        portHints
+    ) {
+        const shape = Primitives.padShape(pad)
+        const width = Primitives.milNumber(
+            pad.sizeTopX || pad.sizeX || pad.width || pad.diameter,
+            0
+        )
+        const height = Primitives.milNumber(
+            pad.sizeTopY || pad.sizeY || pad.height || pad.diameter,
+            0
+        )
+        const holeDiameter = Primitives.milNumber(pad.holeDiameter, 0)
+        const rotation = Primitives.number(pad.rotation || pad.holeRotation, 0)
+        const base = {
+            type: 'pcb_plated_hole',
+            pcb_plated_hole_id: Primitives.id(idScope, [
+                'pcb_plated_hole',
+                padIndex
+            ]),
+            pcb_component_id: pcbComponentId,
+            pcb_port_id: pcbPortId,
+            x: center.x,
+            y: center.y,
+            layers: ['top', 'bottom'],
+            port_hints: portHints
+        }
+
+        if (shape === 'circle') {
+            return {
+                ...base,
+                shape,
+                outer_diameter: Primitives.round(Math.max(width, height)),
+                hole_diameter: holeDiameter
+            }
+        }
+
+        if (shape === 'pill') {
+            return {
+                ...base,
+                shape,
+                outer_width: width,
+                outer_height: height,
+                hole_width: holeDiameter,
+                hole_height: holeDiameter,
+                ccw_rotation: rotation
+            }
+        }
+
+        return {
+            ...base,
+            shape: 'circular_hole_with_rect_pad',
+            hole_shape: 'circle',
+            pad_shape: 'rect',
+            hole_diameter: holeDiameter,
+            rect_pad_width: width,
+            rect_pad_height: height,
+            ...CircuitJsonModelAdapterPcbElements.#rectCcwRotationField(
+                rotation
+            )
+        }
+    }
+
+    /**
+     * Returns true when a rotation value should use a rotated pad shape.
+     * @param {number | null} rotation
+     * @returns {boolean}
+     */
+    static #hasRotation(rotation) {
+        return Math.abs(rotation || 0) > 0.000001
+    }
+
+    /**
+     * Returns an optional counter-clockwise rotation field.
+     * @param {number | null} rotation
+     * @returns {{ ccw_rotation?: number }}
+     */
+    static #ccwRotationField(rotation) {
+        return CircuitJsonModelAdapterPcbElements.#hasRotation(rotation)
+            ? { ccw_rotation: rotation || 0 }
+            : {}
+    }
+
+    /**
+     * Returns an optional rectangular pad rotation field.
+     * @param {number | null} rotation
+     * @returns {{ rect_ccw_rotation?: number }}
+     */
+    static #rectCcwRotationField(rotation) {
+        return CircuitJsonModelAdapterPcbElements.#hasRotation(rotation)
+            ? { rect_ccw_rotation: rotation || 0 }
+            : {}
+    }
+}

package/src/core/circuit-json/CircuitJsonModelSchema.mjs

@@ -8,7 +8,7 @@
 export class CircuitJsonModelSchema {
     static CURRENT_SCHEMA_ID = 'https://github.com/tscircuit/circuit-json'
 
-    static CURRENT_SCHEMA_VERSION = '0.0.431'
+    static CURRENT_SCHEMA_VERSION = '0.0.433'
 
     static FORMAT_NAME = 'circuit-json'
 

package/src/parser.mjs

@@ -9,21 +9,31 @@ export { OleDirectoryEntry } from './core/ole/OleDirectoryEntry.mjs'
 export { AltiumParser } from './core/altium/AltiumParser.mjs'
 export { AltiumLayoutParser } from './core/altium/AltiumLayoutParser.mjs'
 export { AsciiRecordParser } from './core/altium/AsciiRecordParser.mjs'
+export { HostCapabilityDiagnosticsBuilder } from './core/altium/HostCapabilityDiagnosticsBuilder.mjs'
 export { IntLibModelParser } from './core/altium/IntLibModelParser.mjs'
 export { IntLibStreamExtractor } from './core/altium/IntLibStreamExtractor.mjs'
 export { EmbeddedFileInventoryBuilder } from './core/altium/EmbeddedFileInventoryBuilder.mjs'
+export { CiArtifactBundleBuilder } from './core/altium/CiArtifactBundleBuilder.mjs'
+export { ContractGateReportBuilder } from './core/altium/ContractGateReportBuilder.mjs'
+export { DraftsmanBoardViewMetadataBuilder } from './core/altium/DraftsmanBoardViewMetadataBuilder.mjs'
+export { DraftsmanDigestParser } from './core/altium/DraftsmanDigestParser.mjs'
 export { LibraryRenderManifestBuilder } from './core/altium/LibraryRenderManifestBuilder.mjs'
+export { LibraryQaReportBuilder } from './core/altium/LibraryQaReportBuilder.mjs'
 export { LibrarySearchIndex } from './core/altium/LibrarySearchIndex.mjs'
 export { ParserUtils } from './core/altium/ParserUtils.mjs'
+export { ParserCompatibilityFuzzer } from './core/altium/ParserCompatibilityFuzzer.mjs'
 export { NormalizedModelSchema } from './core/altium/NormalizedModelSchema.mjs'
 export { ProjectDesignBundleBuilder } from './core/altium/ProjectDesignBundleBuilder.mjs'
+export { ProjectDocumentGraphBuilder } from './core/altium/ProjectDocumentGraphBuilder.mjs'
 export { ProjectAnnotationParser } from './core/altium/ProjectAnnotationParser.mjs'
 export { ProjectNetlistExporter } from './core/altium/ProjectNetlistExporter.mjs'
 export { ProjectVariantViewBuilder } from './core/altium/ProjectVariantViewBuilder.mjs'
 export { CircuitJsonModelSchema } from './core/circuit-json/CircuitJsonModelSchema.mjs'
 export { CircuitJsonModelAdapter } from './core/circuit-json/CircuitJsonModelAdapter.mjs'
 export { PcbBinaryPrimitiveParser } from './core/altium/PcbBinaryPrimitiveParser.mjs'
+export { PcbBomProfileBuilder } from './core/altium/PcbBomProfileBuilder.mjs'
 export { PcbBoardRegionSemanticsParser } from './core/altium/PcbBoardRegionSemanticsParser.mjs'
+export { PcbComponentKindPolicy } from './core/altium/PcbComponentKindPolicy.mjs'
 export { PcbComponentPrimitiveIndexer } from './core/altium/PcbComponentPrimitiveIndexer.mjs'
 export { PcbCustomPadShapeParser } from './core/altium/PcbCustomPadShapeParser.mjs'
 export { PcbDimensionParser } from './core/altium/PcbDimensionParser.mjs'
@@ -32,7 +42,11 @@ export { PcbEmbeddedModelExtractor } from './core/altium/PcbEmbeddedModelExtract
 export { PcbExtendedPrimitiveInformationParser } from './core/altium/PcbExtendedPrimitiveInformationParser.mjs'
 export { PcbFontMetricsParser } from './core/altium/PcbFontMetricsParser.mjs'
 export { PcbLayerIdCodec } from './core/altium/PcbLayerIdCodec.mjs'
+export { PcbLayerStackFidelityReportBuilder } from './core/altium/PcbLayerStackFidelityReportBuilder.mjs'
+export { PcbLayerStackInterchangeParser } from './core/altium/PcbLayerStackInterchangeParser.mjs'
+export { PcbLayerStackQueryHelper } from './core/altium/PcbLayerStackQueryHelper.mjs'
 export { PcbLibModelParser } from './core/altium/PcbLibModelParser.mjs'
+export { PcbLibParityReportBuilder } from './core/altium/PcbLibParityReportBuilder.mjs'
 export { PcbLibStreamExtractor } from './core/altium/PcbLibStreamExtractor.mjs'
 export { PcbMechanicalLayerPairParser } from './core/altium/PcbMechanicalLayerPairParser.mjs'
 export { PcbModelParser } from './core/altium/PcbModelParser.mjs'
@@ -40,8 +54,12 @@ export { PcbOutlineRasterizer } from './core/altium/PcbOutlineRasterizer.mjs'
 export { PcbOutlineRecovery } from './core/altium/PcbOutlineRecovery.mjs'
 export { PcbOwnershipGraphBuilder } from './core/altium/PcbOwnershipGraphBuilder.mjs'
 export { PcbPadStackParser } from './core/altium/PcbPadStackParser.mjs'
+export { PcbPlacedFootprintManifestBuilder } from './core/altium/PcbPlacedFootprintManifestBuilder.mjs'
 export { PcbPickPlacePositionResolver } from './core/altium/PcbPickPlacePositionResolver.mjs'
+export { PcbPolygonRecordParser } from './core/altium/PcbPolygonRecordParser.mjs'
 export { PcbRawRecordRegistry } from './core/altium/PcbRawRecordRegistry.mjs'
+export { PcbReviewMetadataBuilder } from './core/altium/PcbReviewMetadataBuilder.mjs'
+export { PcbRouteAnalysisBuilder } from './core/altium/PcbRouteAnalysisBuilder.mjs'
 export { PcbRuleParser } from './core/altium/PcbRuleParser.mjs'
 export { PcbSidecarRecordParser } from './core/altium/PcbSidecarRecordParser.mjs'
 export { PcbSpecialStringResolver } from './core/altium/PcbSpecialStringResolver.mjs'
@@ -52,6 +70,8 @@ export { PcbViaStackParser } from './core/altium/PcbViaStackParser.mjs'
 export { PcbViaStructureParser } from './core/altium/PcbViaStructureParser.mjs'
 export { PrintableTextDecoder } from './core/altium/PrintableTextDecoder.mjs'
 export { PrjPcbModelParser } from './core/altium/PrjPcbModelParser.mjs'
+export { PrjScrModelParser } from './core/altium/PrjScrModelParser.mjs'
+export { ProjectBomPnpReconciliationBuilder } from './core/altium/ProjectBomPnpReconciliationBuilder.mjs'
 export { SchematicMultipartOwnerMatcher } from './core/altium/SchematicMultipartOwnerMatcher.mjs'
 export { SchematicCrossSheetConnectorParser } from './core/altium/SchematicCrossSheetConnectorParser.mjs'
 export { SchematicHarnessParser } from './core/altium/SchematicHarnessParser.mjs'
@@ -63,3 +83,4 @@ export { SchematicRecordTypeRegistry } from './core/altium/SchematicRecordTypeRe
 export { SchematicRepeatedChannelParser } from './core/altium/SchematicRepeatedChannelParser.mjs'
 export { SchematicTemplateParser } from './core/altium/SchematicTemplateParser.mjs'
 export { SchematicStandaloneCalloutNormalizer } from './core/altium/SchematicStandaloneCalloutNormalizer.mjs'
+export { SvgModelCrossLinkValidator } from './core/altium/SvgModelCrossLinkValidator.mjs'

package/src/ui/PcbFootprintPrimitiveSelector.mjs

@@ -141,9 +141,21 @@ export class PcbFootprintPrimitiveSelector {
      * @returns {boolean}
      */
     static #includesLayerName(layerName, needle) {
+        return PcbFootprintPrimitiveSelector.#compactLayerName(
+            layerName
+        ).includes(PcbFootprintPrimitiveSelector.#compactLayerName(needle))
+    }
+
+    /**
+     * Normalizes layer labels so compact names such as TopOverlay match
+     * spaced Altium labels such as Top Overlay.
+     * @param {string} layerName
+     * @returns {string}
+     */
+    static #compactLayerName(layerName) {
         return String(layerName || '')
             .trim()
             .toUpperCase()
-            .includes(needle)
+            .replace(/[^A-Z0-9]/g, '')
     }
 }

package/src/ui/PcbScene3dBuilder.mjs

@@ -986,16 +986,38 @@ export class PcbScene3dBuilder {
         return new Set(
             (Array.isArray(primitiveLayers) ? primitiveLayers : [])
                 .filter((layer) =>
-                    String(layer?.name || '')
-                        .trim()
-                        .toUpperCase()
-                        .includes(needle)
+                    PcbScene3dBuilder.#includesLayerName(layer?.name, needle)
                 )
                 .map((layer) => Number(layer.layerId))
                 .filter((layerId) => Number.isInteger(layerId))
         )
     }
 
+    /**
+     * Returns true when one layer name matches a spaced or compact target.
+     * @param {string} layerName
+     * @param {string} needle
+     * @returns {boolean}
+     */
+    static #includesLayerName(layerName, needle) {
+        return PcbScene3dBuilder.#compactLayerName(layerName).includes(
+            PcbScene3dBuilder.#compactLayerName(needle)
+        )
+    }
+
+    /**
+     * Normalizes layer labels so compact names such as TopOverlay match
+     * spaced Altium labels such as Top Overlay.
+     * @param {string} layerName
+     * @returns {string}
+     */
+    static #compactLayerName(layerName) {
+        return String(layerName || '')
+            .trim()
+            .toUpperCase()
+            .replace(/[^A-Z0-9]/g, '')
+    }
+
     /**
      * Normalizes one Altium overlay text into the runtime stroke-text shape.
      * @param {{ text?: string, value?: string, x?: number, y?: number, height?: number, strokeWidth?: number, rotation?: number, mirrored?: boolean | number | string, isMirrored?: boolean | number | string, mirrorFlag?: boolean | number | string, Mirrored?: boolean | number | string, IsMirrored?: boolean | number | string, MirrorFlag?: boolean | number | string, layerId?: number }} text

package/src/ui/PcbSvgRenderer.mjs

@@ -829,6 +829,7 @@ export class PcbSvgRenderer {
         return {
             schema: PcbSvgRenderer.#SEMANTIC_SCHEMA,
             view: PcbSvgRenderer.#buildViewMetadata(pcb, semanticContext),
+            lookups: PcbSvgRenderer.#buildSemanticLookups(pcb, semanticContext),
             boardOutline: {
                 feature: 'board-outline',
                 elementKeys: ['pcb-board-outline', 'pcb-board-outline-stroke']
@@ -887,6 +888,70 @@ export class PcbSvgRenderer {
         }
     }
 
+    /**
+     * Builds stable lookup maps for semantic SVG consumers.
+     * @param {object} pcb Normalized PCB model.
+     * @param {object} semanticContext Semantic lookup context.
+     * @returns {object}
+     */
+    static #buildSemanticLookups(pcb, semanticContext) {
+        const netsByIndex = {}
+        const netIndexByName = {}
+        const netClassesByName = {}
+        const componentsByIndex = {}
+        const componentIndexByDesignator = {}
+        const layersByKey = {}
+        const layerKeyByDisplayName = {}
+
+        for (const net of pcb?.nets || []) {
+            const netIndex = Number(net?.netIndex)
+            if (Number.isInteger(netIndex) && net?.name) {
+                netsByIndex[netIndex] = net.name
+                netIndexByName[net.name] = netIndex
+            }
+        }
+
+        for (const [
+            netName,
+            classNames
+        ] of semanticContext.netClassNamesByNetName) {
+            netClassesByName[netName] = [...classNames].sort((left, right) =>
+                left.localeCompare(right, undefined, { numeric: true })
+            )
+        }
+
+        for (const [
+            componentIndex,
+            component
+        ] of semanticContext.componentsByIndex) {
+            componentsByIndex[componentIndex] =
+                PcbSvgRenderer.#stripEmptySemanticObject({
+                    designator: component.designator,
+                    uniqueId: component.uniqueId,
+                    pattern: component.pattern
+                })
+            if (component.designator) {
+                componentIndexByDesignator[component.designator] =
+                    componentIndex
+            }
+        }
+
+        for (const layer of semanticContext.layerDescriptors) {
+            layersByKey[layer.layerKey] = layer
+            layerKeyByDisplayName[layer.displayName] = layer.layerKey
+        }
+
+        return {
+            netsByIndex,
+            netIndexByName,
+            netClassesByName,
+            componentsByIndex,
+            componentIndexByDesignator,
+            layersByKey,
+            layerKeyByDisplayName
+        }
+    }
+
     /**
      * Builds metadata for the rendered PCB view.
      * @param {object} pcb Normalized PCB model.