altium-toolkit 1.1.40 → 1.2.0

package/src/parser.mjs

@@ -1,142 +1,16 @@
 // SPDX-FileCopyrightText: 2026 André Fiedler
-//
 // SPDX-License-Identifier: GPL-3.0-or-later
 
-export { BinaryReader, BinaryReaderCursor } from './core/BinaryReader.mjs'
-export { OleCompoundDocument } from './core/ole/OleCompoundDocument.mjs'
-export { OleConstants } from './core/ole/OleConstants.mjs'
-export { OleDirectoryEntry } from './core/ole/OleDirectoryEntry.mjs'
-export { OleCompoundDocumentWriter } from './core/ole/OleCompoundDocumentWriter.mjs'
-export { AltiumLibraryBatchExporter } from './core/altium/AltiumLibraryBatchExporter.mjs'
-export { AltiumLibraryRecordBuilder } from './core/altium/AltiumLibraryRecordBuilder.mjs'
-export { AltiumPcbLibExporter } from './core/altium/AltiumPcbLibExporter.mjs'
-export { AltiumSchLibExporter } from './core/altium/AltiumSchLibExporter.mjs'
-export { SelectedPartAltiumExportAdapter } from './core/altium/SelectedPartAltiumExportAdapter.mjs'
-export { AltiumUnits } from './core/altium/AltiumUnits.mjs'
-export { SourceBundleExporter } from './core/altium/SourceBundleExporter.mjs'
-export { SourceComponentBundleNormalizer } from './core/altium/SourceComponentBundleNormalizer.mjs'
-export { SourceComponentClient } from './core/altium/SourceComponentClient.mjs'
-export { AltiumParser } from './core/altium/AltiumParser.mjs'
-export { AltiumSchematicArcAngleNormalizer } from './core/altium/AltiumSchematicArcAngleNormalizer.mjs'
-export { AltiumSchematicFreeGraphicStrokeNormalizer } from './core/altium/AltiumSchematicFreeGraphicStrokeNormalizer.mjs'
-export { AltiumSchematicHiddenDesignatorResolver } from './core/altium/AltiumSchematicHiddenDesignatorResolver.mjs'
-export { AltiumSchematicPackedImageResolver } from './core/altium/AltiumSchematicPackedImageResolver.mjs'
-export { AltiumSchematicSheetBoundsNormalizer } from './core/altium/AltiumSchematicSheetBoundsNormalizer.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 { EmbeddedAssetReportBuilder } from './core/altium/EmbeddedAssetReportBuilder.mjs'
-export { EmbeddedFileInventoryBuilder } from './core/altium/EmbeddedFileInventoryBuilder.mjs'
-export { FixtureCoverageMatrixBuilder } from './core/altium/FixtureCoverageMatrixBuilder.mjs'
-export { GeometryBoundsReportBuilder } from './core/altium/GeometryBoundsReportBuilder.mjs'
 export {
-    ParameterCollection,
-    ParameterValue
-} from './core/altium/ParameterCollection.mjs'
-export {
-    AltiumFileError,
-    AltiumParseError,
-    AltiumCorruptFileError,
-    AltiumUnsupportedFeatureError
-} from './core/altium/ParserErrors.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 { LibraryCatalogArtifactBuilder } from './core/altium/LibraryCatalogArtifactBuilder.mjs'
-export { LibraryCompatibilityReportBuilder } from './core/altium/LibraryCompatibilityReportBuilder.mjs'
-export { LibraryDiffReportBuilder } from './core/altium/LibraryDiffReportBuilder.mjs'
-export { LibraryInspectionReportBuilder } from './core/altium/LibraryInspectionReportBuilder.mjs'
-export { LibraryQaReportBuilder } from './core/altium/LibraryQaReportBuilder.mjs'
-export { LibrarySearchIndex } from './core/altium/LibrarySearchIndex.mjs'
-export { NativeStreamInventoryBuilder } from './core/altium/NativeStreamInventoryBuilder.mjs'
-export { ParserUtils } from './core/altium/ParserUtils.mjs'
-export { ParameterRecordInventoryBuilder } from './core/altium/ParameterRecordInventoryBuilder.mjs'
-export { ParserCompatibilityFuzzer } from './core/altium/ParserCompatibilityFuzzer.mjs'
-export { ParserDiagnosticNormalizer } from './core/altium/ParserDiagnosticNormalizer.mjs'
-export { ParserFieldCoverageReportBuilder } from './core/altium/ParserFieldCoverageReportBuilder.mjs'
-export { ParserValueVerificationReportBuilder } from './core/altium/ParserValueVerificationReportBuilder.mjs'
-export { NormalizedModelSchema } from './core/altium/NormalizedModelSchema.mjs'
-export { ProjectDesignBundleBuilder } from './core/altium/ProjectDesignBundleBuilder.mjs'
-export { ProjectDocumentGraphBuilder } from './core/altium/ProjectDocumentGraphBuilder.mjs'
-export { ProjectHierarchyReportBuilder } from './core/altium/ProjectHierarchyReportBuilder.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'
-export { PcbDimensionReportBuilder } from './core/altium/PcbDimensionReportBuilder.mjs'
-export { PcbEmbeddedFontExtractor } from './core/altium/PcbEmbeddedFontExtractor.mjs'
-export { PcbEmbeddedModelExtractor } from './core/altium/PcbEmbeddedModelExtractor.mjs'
-export { PcbExtendedPrimitiveInformationParser } from './core/altium/PcbExtendedPrimitiveInformationParser.mjs'
-export { PcbFabricationReadinessReportBuilder } from './core/altium/PcbFabricationReadinessReportBuilder.mjs'
-export { PcbFontMetricsParser } from './core/altium/PcbFontMetricsParser.mjs'
-export { PcbLayerIdCodec } from './core/altium/PcbLayerIdCodec.mjs'
-export { PcbLayerGroups } from './core/altium/PcbLayerGroups.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'
-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 { PcbPrimitiveFieldOffsetReportBuilder } from './core/altium/PcbPrimitiveFieldOffsetReportBuilder.mjs'
-export { PcbRawRecordRegistry } from './core/altium/PcbRawRecordRegistry.mjs'
-export { PcbReviewMetadataBuilder } from './core/altium/PcbReviewMetadataBuilder.mjs'
-export { PcbReviewPolygonRealizationBuilder } from './core/altium/PcbReviewPolygonRealizationBuilder.mjs'
-export { PcbClassReportBuilder } from './core/altium/PcbClassReportBuilder.mjs'
-export { PcbInspectionReportBuilder } from './core/altium/PcbInspectionReportBuilder.mjs'
-export { PcbNetMembershipReportBuilder } from './core/altium/PcbNetMembershipReportBuilder.mjs'
-export { PcbRouteAnalysisBuilder } from './core/altium/PcbRouteAnalysisBuilder.mjs'
-export { PcbRuleImpactReportBuilder } from './core/altium/PcbRuleImpactReportBuilder.mjs'
-export { PcbRuleParser } from './core/altium/PcbRuleParser.mjs'
-export { PcbSidecarRecordParser } from './core/altium/PcbSidecarRecordParser.mjs'
-export { PcbSpecialStringResolver } from './core/altium/PcbSpecialStringResolver.mjs'
-export { PcbStatisticsBuilder } from './core/altium/PcbStatisticsBuilder.mjs'
-export { PcbStreamExtractor } from './core/altium/PcbStreamExtractor.mjs'
-export { PcbUnionParser } from './core/altium/PcbUnionParser.mjs'
-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 { RawDataPreservationReportBuilder } from './core/altium/RawDataPreservationReportBuilder.mjs'
-export { SchLibModelParser } from './core/altium/SchLibModelParser.mjs'
-export { SchLibStreamExtractor } from './core/altium/SchLibStreamExtractor.mjs'
-export { SchematicMultipartOwnerMatcher } from './core/altium/SchematicMultipartOwnerMatcher.mjs'
-export { SchematicCrossSheetConnectorParser } from './core/altium/SchematicCrossSheetConnectorParser.mjs'
-export { SchematicCodeSymbolParser } from './core/altium/SchematicCodeSymbolParser.mjs'
-export { SchematicConnectivityQaBuilder } from './core/altium/SchematicConnectivityQaBuilder.mjs'
-export { SchematicHarnessParser } from './core/altium/SchematicHarnessParser.mjs'
-export { SchematicImplementationParser } from './core/altium/SchematicImplementationParser.mjs'
-export { SchematicImageDiagnosticsBuilder } from './core/altium/SchematicImageDiagnosticsBuilder.mjs'
-export { SchematicOwnershipGraphParser } from './core/altium/SchematicOwnershipGraphParser.mjs'
-export { SchematicProjectParameterResolver } from './core/altium/SchematicProjectParameterResolver.mjs'
-export { SchematicQaReportBuilder } from './core/altium/SchematicQaReportBuilder.mjs'
-export { SchematicRecordStreamParser } from './core/altium/SchematicRecordStreamParser.mjs'
-export { SchematicRecordTypeRegistry } from './core/altium/SchematicRecordTypeRegistry.mjs'
-export { SchematicRepeatedChannelParser } from './core/altium/SchematicRepeatedChannelParser.mjs'
-export { SchematicTemplateParser } from './core/altium/SchematicTemplateParser.mjs'
-export { UnsupportedFeatureReportBuilder } from './core/altium/UnsupportedFeatureReportBuilder.mjs'
-export { SchematicTextRunParser } from './core/altium/SchematicTextRunParser.mjs'
-export { SchematicStandaloneCalloutNormalizer } from './core/altium/SchematicStandaloneCalloutNormalizer.mjs'
-export { SvgModelCrossLinkValidator } from './core/altium/SvgModelCrossLinkValidator.mjs'
+    CircuitJsonDocumentContext,
+    DocumentResult,
+    ParserWorkerClient,
+    ToolkitAsset,
+    ToolkitDiagnostic,
+    ToolkitError,
+    ToolkitProgress,
+    TOOLKIT_WORKER_PROTOCOL,
+    ToolkitWorkerProtocol
+} from 'circuitjson-toolkit/parser'
+
+export { Parser } from './convergence/Parser.mjs'

package/src/project.mjs

@@ -0,0 +1,11 @@
+// SPDX-FileCopyrightText: 2026 André Fiedler
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+export {
+    ArchiveEntryPath,
+    ArchiveLimits,
+    ProjectResult,
+    ZipArchiveInspector
+} from 'circuitjson-toolkit/project'
+
+export { ProjectLoader } from './convergence/ProjectLoader.mjs'

package/src/query.mjs

@@ -0,0 +1,4 @@
+// SPDX-FileCopyrightText: 2026 André Fiedler
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+export { QueryService } from 'circuitjson-toolkit/query'

package/src/renderers.mjs

@@ -1,26 +1,8 @@
 // SPDX-FileCopyrightText: 2026 André Fiedler
-//
 // SPDX-License-Identifier: GPL-3.0-or-later
 
-export { BomTableRenderer } from './ui/BomTableRenderer.mjs'
-export { AltiumPcbBottomViewMirror } from './ui/AltiumPcbBottomViewMirror.mjs'
-export { PcbArcUtils } from './ui/PcbArcUtils.mjs'
-export { PcbEdgeFacingGlyphNormalizer } from './ui/PcbEdgeFacingGlyphNormalizer.mjs'
-export { PcbFootprintPrimitiveSelector } from './ui/PcbFootprintPrimitiveSelector.mjs'
-export { PcbFootprintPadAxisNormalizer } from './ui/PcbFootprintPadAxisNormalizer.mjs'
-export { PcbInteractionIndex } from './ui/PcbInteractionIndex.mjs'
-export { PcbInteractionItemRegistry } from './ui/PcbInteractionItemRegistry.mjs'
-export { PcbInteractionLayerModel } from './ui/PcbInteractionLayerModel.mjs'
-export { PcbLayerGroups } from './core/altium/PcbLayerGroups.mjs'
 export {
-    PcbSideResolvedRenderModel,
-    isCopperPrimitive,
-    preparePcbSideResolvedRenderModel
-} from './ui/PcbSideResolvedRenderModel.mjs'
-export { PcbSvgRenderer } from './ui/PcbSvgRenderer.mjs'
-export { SchematicColorResolver } from './ui/SchematicColorResolver.mjs'
-export { SchematicContentLayout } from './ui/SchematicContentLayout.mjs'
-export { SchematicOwnerPinLabelLayout } from './ui/SchematicOwnerPinLabelLayout.mjs'
-export { SchematicSvgRenderer } from './ui/SchematicSvgRenderer.mjs'
-export { SchematicSvgUtils } from './ui/SchematicSvgUtils.mjs'
-export { SchematicTypography } from './ui/SchematicTypography.mjs'
+    BomTableRenderer,
+    PcbSvgRenderer,
+    SchematicSvgRenderer
+} from 'circuitjson-toolkit/renderers'

package/src/scene3d.mjs

@@ -1,11 +1,8 @@
 // SPDX-FileCopyrightText: 2026 André Fiedler
-//
 // SPDX-License-Identifier: GPL-3.0-or-later
 
-export { PcbScene3dBuilder } from './ui/PcbScene3dBuilder.mjs'
-export { AltiumScene3dAuthoredBodyAnchorAdapter } from './ui/AltiumScene3dAuthoredBodyAnchorAdapter.mjs'
-export { PcbScene3dModelRegistry } from './ui/PcbScene3dModelRegistry.mjs'
-export { PcbScene3dPackages } from './ui/PcbScene3dPackages.mjs'
-export { PcbScene3dScenePreparator } from './ui/PcbScene3dScenePreparator.mjs'
-export { PcbScene3dSummaryRenderer } from './ui/PcbScene3dSummaryRenderer.mjs'
-export { PcbScene3dTextBoxLayoutResolver } from './ui/PcbScene3dTextBoxLayoutResolver.mjs'
+export {
+    PcbScene3dBuilder,
+    PcbScene3dPreparator,
+    SceneAssetResolver
+} from 'circuitjson-toolkit/scene3d'

package/src/simulation.mjs

@@ -0,0 +1,4 @@
+// SPDX-FileCopyrightText: 2026 André Fiedler
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+export { SimulationService } from 'circuitjson-toolkit/simulation'

package/src/styles/altium-renderers.css

@@ -142,6 +142,16 @@
     --pcb-via-hole-fill: #0f746c;
     --pcb-footprint-fill: rgba(247, 230, 117, 0.14);
     --pcb-footprint-track-color: rgba(237, 172, 36, 1);
+    --pcb-detail-paste-fill: rgba(146, 146, 146, 0.94);
+    --pcb-detail-paste-stroke: rgba(154, 154, 154, 0.96);
+    --pcb-detail-mask-fill: rgba(137, 34, 132, 0.4);
+    --pcb-detail-mask-stroke: rgba(137, 34, 132, 0.82);
+    --pcb-detail-mechanical-fill: rgba(148, 160, 166, 0.32);
+    --pcb-detail-mechanical-stroke: rgba(96, 110, 118, 0.86);
+    --pcb-detail-drill-fill: rgba(79, 87, 93, 0.46);
+    --pcb-detail-drill-stroke: rgba(42, 50, 56, 0.88);
+    --pcb-detail-fill: rgba(150, 160, 166, 0.38);
+    --pcb-detail-stroke: rgba(80, 92, 100, 0.82);
     --pcb-dimension-color: rgba(39, 88, 111, 0.78);
     --pcb-dimension-text: #22343b;
     --pcb-text-knockout-fill: rgba(248, 246, 239, 0.96);
@@ -200,7 +210,9 @@
 .pcb-track,
 .pcb-arc,
 .pcb-footprint-track,
-.pcb-footprint-arc {
+.pcb-footprint-arc,
+.pcb-detail-track,
+.pcb-detail-arc {
     fill: none;
     stroke-linecap: round;
     stroke-linejoin: round;
@@ -271,6 +283,60 @@
     stroke: var(--pcb-footprint-track-color);
 }
 
+.pcb-detail-fill,
+.pcb-detail-region {
+    fill: var(--pcb-detail-fill);
+}
+
+.pcb-detail-track,
+.pcb-detail-arc {
+    stroke: var(--pcb-detail-stroke);
+}
+
+.pcb-detail-fill--paste,
+.pcb-detail-region--paste {
+    fill: var(--pcb-detail-paste-fill);
+}
+
+.pcb-detail-track--paste,
+.pcb-detail-arc--paste {
+    stroke: var(--pcb-detail-paste-stroke);
+}
+
+.pcb-detail-fill--mask,
+.pcb-detail-region--mask,
+.pcb-detail-fill--solder-mask,
+.pcb-detail-region--solder-mask {
+    fill: var(--pcb-detail-mask-fill);
+}
+
+.pcb-detail-track--mask,
+.pcb-detail-arc--mask,
+.pcb-detail-track--solder-mask,
+.pcb-detail-arc--solder-mask {
+    stroke: var(--pcb-detail-mask-stroke);
+}
+
+.pcb-detail-fill--mechanical,
+.pcb-detail-region--mechanical {
+    fill: var(--pcb-detail-mechanical-fill);
+}
+
+.pcb-detail-track--mechanical,
+.pcb-detail-arc--mechanical {
+    stroke: var(--pcb-detail-mechanical-stroke);
+}
+
+.pcb-detail-fill--drill,
+.pcb-detail-region--drill {
+    fill: var(--pcb-detail-drill-fill);
+}
+
+.pcb-detail-track--drill,
+.pcb-detail-arc--drill {
+    stroke: var(--pcb-detail-drill-stroke);
+}
+
 .pcb-dimensions {
     pointer-events: none;
 }

package/src/styles/renderers.css

@@ -0,0 +1,27 @@
+/* SPDX-FileCopyrightText: 2026 André Fiedler */
+/* SPDX-License-Identifier: GPL-3.0-or-later */
+
+.pcb-svg,
+.schematic-svg {
+    display: block;
+    width: 100%;
+    max-width: 100%;
+    height: auto;
+}
+
+.pcb-svg text,
+.schematic-svg text {
+    font-family: ui-sans-serif, system-ui, sans-serif;
+}
+
+.bom-table {
+    width: 100%;
+    border-collapse: collapse;
+}
+
+.bom-table th,
+.bom-table td {
+    padding: 0.35rem 0.5rem;
+    border: 1px solid currentColor;
+    text-align: left;
+}

package/src/testing.mjs

@@ -0,0 +1,8 @@
+// SPDX-FileCopyrightText: 2026 André Fiedler
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+export {
+    ToolkitContractFixtures,
+    ToolkitLoopbackWorker,
+    runToolkitContract
+} from 'circuitjson-toolkit/testing'

package/src/ui/PcbInteractionLayerModel.mjs

@@ -56,13 +56,17 @@ export class PcbInteractionLayerModel {
             const key = String(layer?.name || layer?.layer || '').trim()
             if (!key || seen.has(key)) continue
             seen.add(key)
-            layers.push({
+            const row = {
                 key,
                 label: key,
                 layerId: Number.isFinite(Number(layer?.layerId))
                     ? Number(layer.layerId)
                     : null
-            })
+            }
+            if (Number.isFinite(Number(layer?.legacyLayerId))) {
+                row.legacyLayerId = Number(layer.legacyLayerId)
+            }
+            layers.push(row)
         }
 
         return layers

package/src/ui/PcbPadMaskApertureRenderer.mjs

@@ -0,0 +1,288 @@
+// SPDX-FileCopyrightText: 2026 André Fiedler
+//
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+import { SchematicSvgUtils } from './SchematicSvgUtils.mjs'
+
+/**
+ * Renders pad-derived paste and solder-mask apertures as independent SVG layers.
+ */
+export class PcbPadMaskApertureRenderer {
+    static #PAD_SHAPE_RECTANGULAR = 2
+    static #SPECS = [
+        {
+            flag: 'hasTopPasteMaskOpening',
+            kind: 'paste',
+            primitiveKind: 'pad-paste',
+            side: 'top',
+            layerId: 35,
+            layerName: 'Top Paste',
+            expansionKey: 'effectivePasteMaskExpansion'
+        },
+        {
+            flag: 'hasBottomPasteMaskOpening',
+            kind: 'paste',
+            primitiveKind: 'pad-paste',
+            side: 'bottom',
+            layerId: 36,
+            layerName: 'Bottom Paste',
+            expansionKey: 'effectivePasteMaskExpansion'
+        },
+        {
+            flag: 'hasTopSolderMaskOpening',
+            kind: 'solder-mask',
+            primitiveKind: 'pad-solder-mask',
+            side: 'top',
+            layerId: 37,
+            layerName: 'Top Solder',
+            expansionKey: 'effectiveSolderMaskExpansion'
+        },
+        {
+            flag: 'hasBottomSolderMaskOpening',
+            kind: 'solder-mask',
+            primitiveKind: 'pad-solder-mask',
+            side: 'bottom',
+            layerId: 38,
+            layerName: 'Bottom Solder',
+            expansionKey: 'effectiveSolderMaskExpansion'
+        }
+    ]
+
+    /**
+     * Builds one SVG group containing all derived pad mask apertures.
+     * @param {object[]} pads Normalized pad records.
+     * @param {{ attributes?: (aperture: object) => string, padIndex?: (pad: object, index: number) => number }} [options]
+     * @returns {string}
+     */
+    static render(pads, options = {}) {
+        const apertures = []
+
+        for (const [fallbackIndex, pad] of (pads || []).entries()) {
+            const padIndex = PcbPadMaskApertureRenderer.#padIndex(
+                pad,
+                fallbackIndex,
+                options
+            )
+            for (const [specIndex, spec] of this.#SPECS.entries()) {
+                if (!pad?.[spec.flag]) continue
+                const aperture = this.#apertureForPad(
+                    pad,
+                    padIndex,
+                    specIndex,
+                    spec
+                )
+                if (!aperture) continue
+                apertures.push(
+                    this.#renderAperture(aperture, options.attributes)
+                )
+            }
+        }
+
+        if (!apertures.length) return ''
+
+        return '<g class="pcb-pad-mask-layers">' + apertures.join('') + '</g>'
+    }
+
+    /**
+     * Resolves one stable pad index.
+     * @param {object} pad Pad record.
+     * @param {number} fallbackIndex Array index.
+     * @param {{ padIndex?: (pad: object, index: number) => number }} options
+     * @returns {number}
+     */
+    static #padIndex(pad, fallbackIndex, options) {
+        const resolved = options.padIndex?.(pad, fallbackIndex)
+        return Number.isInteger(resolved) ? resolved : fallbackIndex
+    }
+
+    /**
+     * Builds one normalized aperture descriptor for a pad/spec pair.
+     * @param {object} pad Pad record.
+     * @param {number} padIndex Stable pad index.
+     * @param {number} specIndex Spec index.
+     * @param {object} spec Aperture layer spec.
+     * @returns {object | null}
+     */
+    static #apertureForPad(pad, padIndex, specIndex, spec) {
+        const size = this.#sizeForPad(pad, spec)
+        if (size.width <= 0 || size.height <= 0) return null
+
+        return {
+            pad,
+            padIndex,
+            index: padIndex * this.#SPECS.length + specIndex,
+            spec,
+            size,
+            primitive: {
+                ...pad,
+                layerId: spec.layerId,
+                layerCode: spec.layerId,
+                legacyLayerId: spec.layerId,
+                layerName: spec.layerName
+            }
+        }
+    }
+
+    /**
+     * Resolves aperture dimensions after the parsed mask expansion.
+     * @param {object} pad Pad record.
+     * @param {object} spec Aperture layer spec.
+     * @returns {{ width: number, height: number }}
+     */
+    static #sizeForPad(pad, spec) {
+        const side = spec.side === 'bottom' ? 'Bottom' : 'Top'
+        const width = Number(pad?.['size' + side + 'X'] || pad?.sizeMidX || 0)
+        const height = Number(pad?.['size' + side + 'Y'] || pad?.sizeMidY || 0)
+        const expansion = Number(pad?.[spec.expansionKey] || 0)
+
+        return {
+            width: Math.max(width + expansion * 2, 0),
+            height: Math.max(height + expansion * 2, 0)
+        }
+    }
+
+    /**
+     * Renders one aperture shape.
+     * @param {object} aperture Aperture descriptor.
+     * @param {(aperture: object) => string | undefined} attributes Attribute callback.
+     * @returns {string}
+     */
+    static #renderAperture(aperture, attributes) {
+        const className =
+            'pcb-detail-fill pcb-detail-fill--' +
+            (aperture.spec.kind === 'solder-mask' ? 'mask' : 'paste') +
+            ' pcb-pad-mask-aperture pcb-pad-mask-aperture--' +
+            aperture.spec.kind
+        const renderedAttributes = attributes?.(aperture) || ''
+
+        return PcbPadMaskApertureRenderer.#isRoundAperture(aperture)
+            ? PcbPadMaskApertureRenderer.#renderCircle(
+                  aperture,
+                  className,
+                  renderedAttributes
+              )
+            : PcbPadMaskApertureRenderer.#renderRect(
+                  aperture,
+                  className,
+                  renderedAttributes
+              )
+    }
+
+    /**
+     * Renders one circular aperture.
+     * @param {object} aperture Aperture descriptor.
+     * @param {string} className SVG class list.
+     * @param {string} attributes SVG attributes.
+     * @returns {string}
+     */
+    static #renderCircle(aperture, className, attributes) {
+        const { pad, size } = aperture
+        const radius = Math.max(size.width, size.height) / 2
+
+        return (
+            '<circle class="' +
+            className +
+            '" cx="' +
+            SchematicSvgUtils.formatNumber(Number(pad.x || 0)) +
+            '" cy="' +
+            SchematicSvgUtils.formatNumber(Number(pad.y || 0)) +
+            '" r="' +
+            SchematicSvgUtils.formatNumber(radius) +
+            '"' +
+            attributes +
+            ' />'
+        )
+    }
+
+    /**
+     * Renders one rectangular aperture.
+     * @param {object} aperture Aperture descriptor.
+     * @param {string} className SVG class list.
+     * @param {string} attributes SVG attributes.
+     * @returns {string}
+     */
+    static #renderRect(aperture, className, attributes) {
+        const { pad, size } = aperture
+        const x = Number(pad.x || 0) - size.width / 2
+        const y = Number(pad.y || 0) - size.height / 2
+
+        return (
+            '<rect class="' +
+            className +
+            '" x="' +
+            SchematicSvgUtils.formatNumber(x) +
+            '" y="' +
+            SchematicSvgUtils.formatNumber(y) +
+            '" width="' +
+            SchematicSvgUtils.formatNumber(size.width) +
+            '" height="' +
+            SchematicSvgUtils.formatNumber(size.height) +
+            '" rx="' +
+            SchematicSvgUtils.formatNumber(
+                PcbPadMaskApertureRenderer.#cornerRadius(aperture)
+            ) +
+            '" transform="rotate(' +
+            SchematicSvgUtils.formatNumber(Number(pad.rotation || 0)) +
+            ' ' +
+            SchematicSvgUtils.formatNumber(Number(pad.x || 0)) +
+            ' ' +
+            SchematicSvgUtils.formatNumber(Number(pad.y || 0)) +
+            ')"' +
+            attributes +
+            ' />'
+        )
+    }
+
+    /**
+     * Returns true when one aperture should be rendered as a circle.
+     * @param {object} aperture Aperture descriptor.
+     * @returns {boolean}
+     */
+    static #isRoundAperture(aperture) {
+        const shape = PcbPadMaskApertureRenderer.#shapeForAperture(aperture)
+        return (
+            shape !== PcbPadMaskApertureRenderer.#PAD_SHAPE_RECTANGULAR &&
+            Math.abs(aperture.size.width - aperture.size.height) < 0.001
+        )
+    }
+
+    /**
+     * Resolves the side-specific pad shape code.
+     * @param {object} aperture Aperture descriptor.
+     * @returns {number}
+     */
+    static #shapeForAperture(aperture) {
+        const side = aperture.spec.side === 'bottom' ? 'Bottom' : 'Top'
+        if (
+            side === 'Top' &&
+            aperture.pad?.hasRoundedRect &&
+            Number.isInteger(aperture.pad.roundedRectShapeTop)
+        ) {
+            return Number(aperture.pad.roundedRectShapeTop)
+        }
+        return Number(aperture.pad?.['shape' + side] || 0)
+    }
+
+    /**
+     * Resolves rectangle corner radius for rounded pad shapes.
+     * @param {object} aperture Aperture descriptor.
+     * @returns {number}
+     */
+    static #cornerRadius(aperture) {
+        if (
+            aperture.spec.side === 'top' &&
+            aperture.pad?.hasRoundedRect &&
+            Number.isFinite(aperture.pad.cornerRadiusTop)
+        ) {
+            return (
+                Math.min(aperture.size.width, aperture.size.height) *
+                (Number(aperture.pad.cornerRadiusTop) / 100)
+            )
+        }
+        if (PcbPadMaskApertureRenderer.#shapeForAperture(aperture) === 1) {
+            return Math.min(aperture.size.width, aperture.size.height) / 2
+        }
+
+        return 0
+    }
+}