altium-toolkit 1.0.9 → 1.1.0

package/docs/schemas/altium_toolkit/schematic_render_ops_a1.schema.json

@@ -0,0 +1,55 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "altium-toolkit.schematic.render-ops.a1",
+    "title": "Altium Toolkit Schematic Render Operations A1",
+    "type": "object",
+    "additionalProperties": true,
+    "required": ["schema", "profile", "coordinateSpace", "summary", "records"],
+    "properties": {
+        "schema": {
+            "const": "altium-toolkit.schematic.render-ops.a1"
+        },
+        "profile": {
+            "type": "string"
+        },
+        "coordinateSpace": {
+            "type": "object",
+            "additionalProperties": true
+        },
+        "summary": {
+            "type": "object",
+            "additionalProperties": true
+        },
+        "records": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "additionalProperties": true,
+                "required": [
+                    "elementKey",
+                    "recordId",
+                    "primitive",
+                    "operations"
+                ],
+                "properties": {
+                    "elementKey": {
+                        "type": "string"
+                    },
+                    "recordId": {
+                        "type": "string"
+                    },
+                    "primitive": {
+                        "type": "string"
+                    },
+                    "operations": {
+                        "type": "array",
+                        "items": {
+                            "type": "object",
+                            "additionalProperties": true
+                        }
+                    }
+                }
+            }
+        }
+    }
+}

package/docs/schemas/altium_toolkit/schematic_template_extraction_a1.schema.json

@@ -0,0 +1,37 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "altium-toolkit.schematic.template-extraction.a1",
+    "title": "Altium Toolkit Schematic Template Extraction A1",
+    "type": "object",
+    "additionalProperties": true,
+    "required": [
+        "schema",
+        "sourceDocument",
+        "template",
+        "summary",
+        "diagnostics"
+    ],
+    "properties": {
+        "schema": {
+            "const": "altium-toolkit.schematic.template-extraction.a1"
+        },
+        "sourceDocument": {
+            "type": "string"
+        },
+        "template": {
+            "type": ["object", "null"],
+            "additionalProperties": true
+        },
+        "summary": {
+            "type": "object",
+            "additionalProperties": true
+        },
+        "diagnostics": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "additionalProperties": true
+            }
+        }
+    }
+}

package/docs/schemas/altium_toolkit/svg_model_cross_link_a1.schema.json

@@ -0,0 +1,39 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "altium-toolkit.svg-model-cross-link.a1",
+    "title": "Altium Toolkit SVG Model Cross-Link A1",
+    "type": "object",
+    "additionalProperties": true,
+    "required": [
+        "schema",
+        "documentKind",
+        "summary",
+        "missingElements",
+        "orphanElements",
+        "unresolvedReferences"
+    ],
+    "properties": {
+        "schema": {
+            "const": "altium-toolkit.svg-model-cross-link.a1"
+        },
+        "documentKind": {
+            "enum": ["schematic", "pcb", "unknown"]
+        },
+        "summary": {
+            "type": "object",
+            "additionalProperties": true
+        },
+        "missingElements": {
+            "type": "array"
+        },
+        "orphanElements": {
+            "type": "array"
+        },
+        "unresolvedReferences": {
+            "type": "array"
+        },
+        "metadata": {
+            "type": "object"
+        }
+    }
+}

package/package.json

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

package/src/core/altium/AltiumParser.mjs

@@ -15,10 +15,12 @@ import { AltiumLayoutParser } from './AltiumLayoutParser.mjs'
 import { NormalizedModelSchema } from './NormalizedModelSchema.mjs'
 import { IntLibModelParser } from './IntLibModelParser.mjs'
 import { IntLibStreamExtractor } from './IntLibStreamExtractor.mjs'
+import { DraftsmanDigestParser } from './DraftsmanDigestParser.mjs'
 import { PcbModelParser } from './PcbModelParser.mjs'
 import { PcbLibModelParser } from './PcbLibModelParser.mjs'
 import { PcbLibStreamExtractor } from './PcbLibStreamExtractor.mjs'
 import { PrjPcbModelParser } from './PrjPcbModelParser.mjs'
+import { PrjScrModelParser } from './PrjScrModelParser.mjs'
 import { PcbStreamExtractor } from './PcbStreamExtractor.mjs'
 import { SchematicMultipartOwnerMatcher } from './SchematicMultipartOwnerMatcher.mjs'
 import { SchematicSheetStyleResolver } from './SchematicSheetStyleResolver.mjs'
@@ -89,7 +91,7 @@ export class AltiumParser {
      * Parses a native Altium buffer into the renderer compatibility model.
      * @param {string} fileName
      * @param {ArrayBuffer} arrayBuffer
-     * @returns {{ schema: string, kind: 'schematic' | 'pcb' | 'pcb-library' | 'project' | 'integrated-library', fileType: 'SchDoc' | 'PcbDoc' | 'PcbLib' | 'PrjPcb' | 'IntLib', fileName: string, summary: Record<string, number | string>, diagnostics: { severity: 'info' | 'warning', message: string }[], schematic?: Record<string, unknown>, pcb?: Record<string, unknown>, pcbLibrary?: Record<string, unknown>, project?: Record<string, unknown>, integratedLibrary?: Record<string, unknown>, bom: { designators: string[], quantity: number, pattern: string, source: string, value: string }[] }}
+     * @returns {{ schema: string, kind: 'schematic' | 'pcb' | 'pcb-library' | 'project' | 'project-script' | 'integrated-library' | 'draftsman', fileType: 'SchDoc' | 'PcbDoc' | 'PcbLib' | 'PrjPcb' | 'PrjScr' | 'IntLib' | 'PCBDwf', fileName: string, summary: Record<string, number | string>, diagnostics: { severity: 'info' | 'warning', message: string }[], schematic?: Record<string, unknown>, pcb?: Record<string, unknown>, pcbLibrary?: Record<string, unknown>, project?: Record<string, unknown>, projectScript?: Record<string, unknown>, integratedLibrary?: Record<string, unknown>, draftsman?: Record<string, unknown>, bom: { designators: string[], quantity: number, pattern: string, source: string, value: string }[] }}
      */
     static parseArrayBufferToRendererModel(fileName, arrayBuffer) {
         const records = AsciiRecordParser.parse(arrayBuffer)
@@ -122,12 +124,18 @@ export class AltiumParser {
         if (fileType === 'PrjPcb') {
             return PrjPcbModelParser.parse(fileName, arrayBuffer)
         }
+        if (fileType === 'PrjScr') {
+            return PrjScrModelParser.parse(fileName, arrayBuffer)
+        }
         if (fileType === 'IntLib') {
             return IntLibModelParser.parse(
                 fileName,
                 IntLibStreamExtractor.extractFromArrayBuffer(arrayBuffer)
             )
         }
+        if (fileType === 'PCBDwf') {
+            return DraftsmanDigestParser.parse(fileName, arrayBuffer)
+        }
         throw new Error('Unsupported file type: ' + fileName)
     }
 
@@ -135,7 +143,7 @@ export class AltiumParser {
      * Chooses the format based on extension and content.
      * @param {string} fileName
      * @param {{ fields: Record<string, string | string[]> }[]} records
-     * @returns {'SchDoc' | 'PcbDoc' | 'PcbLib' | 'PrjPcb' | 'IntLib'}
+     * @returns {'SchDoc' | 'PcbDoc' | 'PcbLib' | 'PrjPcb' | 'PrjScr' | 'IntLib' | 'PCBDwf'}
      */
     static #sniffFileType(fileName, records) {
         const normalized = String(fileName || '').toLowerCase()
@@ -143,7 +151,9 @@ export class AltiumParser {
         if (normalized.endsWith('.pcbdoc')) return 'PcbDoc'
         if (normalized.endsWith('.pcblib')) return 'PcbLib'
         if (normalized.endsWith('.prjpcb')) return 'PrjPcb'
+        if (normalized.endsWith('.prjscr')) return 'PrjScr'
         if (normalized.endsWith('.intlib')) return 'IntLib'
+        if (normalized.endsWith('.pcbdwf')) return 'PCBDwf'
 
         const hasSchematicHeader = records.some((record) =>
             getField(record.fields, 'HEADER').includes('Schematic')

package/src/core/altium/CiArtifactBundleBuilder.mjs

@@ -0,0 +1,213 @@
+// SPDX-FileCopyrightText: 2026 André Fiedler
+//
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+import { PcbSvgRenderer } from '../../ui/PcbSvgRenderer.mjs'
+import { SchematicSvgRenderer } from '../../ui/SchematicSvgRenderer.mjs'
+import { ContractGateReportBuilder } from './ContractGateReportBuilder.mjs'
+import { PcbStatisticsBuilder } from './PcbStatisticsBuilder.mjs'
+import { ProjectDesignBundleBuilder } from './ProjectDesignBundleBuilder.mjs'
+import { ProjectDocumentGraphBuilder } from './ProjectDocumentGraphBuilder.mjs'
+import { ProjectNetlistExporter } from './ProjectNetlistExporter.mjs'
+
+/**
+ * Builds one deterministic CI artifact package from parsed project documents.
+ */
+export class CiArtifactBundleBuilder {
+    static SCHEMA = 'altium-toolkit.ci.artifact-bundle.a1'
+
+    static #UNITS = {
+        coordinate: 'mil',
+        length: 'mil',
+        board: 'mil',
+        pnp: 'mil',
+        angle: 'deg'
+    }
+
+    static #PNP_UNITS = {
+        coordinate: 'mil',
+        angle: 'deg'
+    }
+
+    /**
+     * Builds a deterministic bundle of normalized, rendered, and report outputs.
+     * @param {{ projectModel?: object, documentModels?: object[], designBundle?: object, annotationModels?: object[], variantName?: string, renderSchematicSvg?: boolean, renderPcbLayerSvgs?: boolean, schematicSvgOptions?: object }} options Bundle options.
+     * @returns {object}
+     */
+    static build(options = {}) {
+        const documentModels = Array.isArray(options.documentModels)
+            ? options.documentModels
+            : []
+        const designBundle =
+            options.designBundle ||
+            ProjectDesignBundleBuilder.build({
+                projectModel: options.projectModel,
+                documentModels,
+                annotationModels: options.annotationModels || [],
+                variantName: options.variantName
+            })
+        const activeBundle = designBundle.effectiveVariant || designBundle
+        const schematicSvgs =
+            options.renderSchematicSvg === false
+                ? []
+                : CiArtifactBundleBuilder.#schematicSvgs(
+                      documentModels,
+                      options.schematicSvgOptions || {}
+                  )
+        const pcbLayerSvgs =
+            options.renderPcbLayerSvgs === false
+                ? []
+                : CiArtifactBundleBuilder.#pcbLayerSvgs(documentModels)
+        const statistics = CiArtifactBundleBuilder.#statistics(documentModels)
+        const diagnostics = CiArtifactBundleBuilder.#diagnostics(
+            designBundle,
+            documentModels
+        )
+        const netlistJson =
+            ProjectNetlistExporter.buildNetlistJson(activeBundle)
+        const netlist = {
+            json: netlistJson,
+            wirelist: ProjectNetlistExporter.buildWirelist(activeBundle)
+        }
+        const contractGate = ContractGateReportBuilder.build({
+            documentModels,
+            netlist,
+            schematicSvgs,
+            pcbLayerSvgs,
+            diagnostics
+        })
+        const documentGraph =
+            designBundle.project?.documentGraph ||
+            ProjectDocumentGraphBuilder.build(
+                options.projectModel?.project || designBundle.project || {}
+            )
+
+        return {
+            schema: CiArtifactBundleBuilder.SCHEMA,
+            summary: {
+                normalizedModelCount: documentModels.length,
+                schematicSvgCount: schematicSvgs.length,
+                pcbLayerSvgCount: pcbLayerSvgs.reduce(
+                    (total, entry) => total + entry.layers.length,
+                    0
+                ),
+                netCount: netlistJson.nets.length,
+                bomRowCount: (activeBundle.bom || designBundle.bom || [])
+                    .length,
+                pnpCount: (activeBundle.pnp?.entries || []).length,
+                diagnosticCount: diagnostics.length,
+                contractGateStatus: contractGate.status
+            },
+            units: designBundle.units || CiArtifactBundleBuilder.#UNITS,
+            designBundle,
+            documentGraph,
+            normalizedModels: documentModels,
+            netlist,
+            bom: {
+                rows: activeBundle.bom || designBundle.bom || []
+            },
+            pnp: CiArtifactBundleBuilder.#pnp(activeBundle, designBundle),
+            schematicSvgs,
+            pcbLayerSvgs,
+            statistics,
+            contractGate,
+            diagnostics
+        }
+    }
+
+    /**
+     * Resolves a PnP payload with explicit output units.
+     * @param {object} activeBundle Effective bundle or variant.
+     * @param {object} designBundle Source design bundle.
+     * @returns {object}
+     */
+    static #pnp(activeBundle, designBundle) {
+        const pnp = activeBundle.pnp || designBundle.pnp || { entries: [] }
+
+        return {
+            units: pnp.units || CiArtifactBundleBuilder.#PNP_UNITS,
+            ...pnp
+        }
+    }
+
+    /**
+     * Renders schematic SVG entries.
+     * @param {object[]} documentModels Parsed document models.
+     * @param {object} renderOptions Schematic SVG render options.
+     * @returns {object[]}
+     */
+    static #schematicSvgs(documentModels, renderOptions) {
+        return documentModels
+            .filter((model) => model?.kind === 'schematic')
+            .map((model) => ({
+                fileName: model.fileName || '',
+                svg: SchematicSvgRenderer.render(model, renderOptions)
+            }))
+    }
+
+    /**
+     * Renders per-layer PCB SVG entries.
+     * @param {object[]} documentModels Parsed document models.
+     * @returns {object[]}
+     */
+    static #pcbLayerSvgs(documentModels) {
+        return documentModels
+            .filter((model) => model?.kind === 'pcb')
+            .map((model) => ({
+                fileName: model.fileName || '',
+                layers: PcbSvgRenderer.renderLayerSvgs(model)
+            }))
+    }
+
+    /**
+     * Builds statistics package entries.
+     * @param {object[]} documentModels Parsed document models.
+     * @returns {{ pcb: object[] }}
+     */
+    static #statistics(documentModels) {
+        return {
+            pcb: documentModels
+                .filter((model) => model?.kind === 'pcb')
+                .map((model) => ({
+                    fileName: model.fileName || '',
+                    statistics:
+                        model.pcb?.statistics ||
+                        PcbStatisticsBuilder.build(model.pcb || {})
+                }))
+        }
+    }
+
+    /**
+     * Collects diagnostics from the bundle and source documents.
+     * @param {object} designBundle Composed design bundle.
+     * @param {object[]} documentModels Parsed document models.
+     * @returns {object[]}
+     */
+    static #diagnostics(designBundle, documentModels) {
+        return [
+            ...CiArtifactBundleBuilder.#sourceDiagnostics(
+                'design-bundle',
+                designBundle.diagnostics || []
+            ),
+            ...documentModels.flatMap((model) =>
+                CiArtifactBundleBuilder.#sourceDiagnostics(
+                    model.fileName || model.kind || 'document',
+                    model.diagnostics || []
+                )
+            )
+        ]
+    }
+
+    /**
+     * Adds source labels to diagnostics without changing their codes.
+     * @param {string} source Diagnostic source label.
+     * @param {object[]} diagnostics Source diagnostics.
+     * @returns {object[]}
+     */
+    static #sourceDiagnostics(source, diagnostics) {
+        return (diagnostics || []).map((diagnostic) => ({
+            source,
+            ...diagnostic
+        }))
+    }
+}