altium-toolkit 1.0.7 → 1.0.9

package/src/core/altium/SchematicTextParser.mjs

@@ -57,6 +57,39 @@ export class SchematicTextParser {
         return fonts
     }
 
+    /**
+     * Extracts deterministic render diagnostics for schematic sheet fonts.
+     * @param {Record<string, string | string[]> | undefined} fields
+     * @returns {{ schema: string, fontFallbacks: object[] }}
+     */
+    static extractSchematicFontDiagnostics(fields) {
+        const count = ParserUtils.parseNumericField(fields, 'FontIdCount') || 0
+        const fontFallbacks = []
+
+        for (let index = 1; index <= count; index += 1) {
+            const rawFamily = ParserUtils.getField(fields, 'FontName' + index)
+            if (!SchematicTextParser.#needsFontFamilyFallback(rawFamily)) {
+                continue
+            }
+
+            fontFallbacks.push({
+                code: 'schematic.font.family-fallback',
+                severity: 'warning',
+                fontId: String(index),
+                sourceFamily: rawFamily,
+                resolvedFamily:
+                    SchematicTextParser.#sanitizeFontFamily(rawFamily),
+                message:
+                    'Schematic font family was missing or malformed and was replaced for deterministic SVG rendering.'
+            })
+        }
+
+        return {
+            schema: 'altium-toolkit.schematic.render-diagnostics.a1',
+            fontFallbacks
+        }
+    }
+
     /**
      * Normalizes one schematic text record into a drawable text node.
      * @param {Record<string, string | string[]>} fields
@@ -119,6 +152,8 @@ export class SchematicTextParser {
             ownerIndex: ParserUtils.getField(fields, 'OwnerIndex') || undefined,
             recordType,
             style: ParserUtils.parseNumericField(fields, 'Style') || 0,
+            renderOrder:
+                ParserUtils.parseNumericField(fields, 'IndexInSheet') ?? 0,
             fontSize: SchematicTextParser.#toSvgFontSize(font.size),
             fontFamily: font.family,
             fontWeight: font.bold ? 700 : 400,
@@ -152,6 +187,19 @@ export class SchematicTextParser {
         return textRecord
     }
 
+    /**
+     * Builds a normalized text-frame read model from visible text records.
+     * @param {object[]} texts Normalized schematic text records.
+     * @returns {object[]}
+     */
+    static extractSchematicTextFrames(texts) {
+        return (texts || [])
+            .filter((text) => text?.recordType === '28')
+            .map((text) =>
+                SchematicTextParser.#normalizeTextFrameContract(text)
+            )
+    }
+
     /**
      * Extracts footer metadata used for the synthesized title block.
      * @param {{ fields: Record<string, string | string[]> }[]} records
@@ -623,6 +671,17 @@ export class SchematicTextParser {
         return normalized
     }
 
+    /**
+     * Returns true when the font family must be replaced for SVG output.
+     * @param {string} family Raw font family value.
+     * @returns {boolean}
+     */
+    static #needsFontFamilyFallback(family) {
+        const normalized = String(family || '').trim()
+
+        return !normalized || /["|]/.test(normalized)
+    }
+
     /**
      * Returns the default schematic font when no sheet font entry exists.
      * @returns {{ size: number, family: string, bold: boolean, italic: boolean, rotation: number }}
@@ -697,6 +756,8 @@ export class SchematicTextParser {
                 fields.Color || fields.TextColor,
                 '#7b7753'
             ),
+            lineWidth:
+                ParserUtils.parseNumericField(fields, 'LineWidth') ?? undefined,
             isSolid: ParserUtils.parseBoolean(fields.IsSolid),
             showBorder: ParserUtils.parseBoolean(fields.ShowBorder),
             textMargin:
@@ -705,6 +766,68 @@ export class SchematicTextParser {
         }
     }
 
+    /**
+     * Converts one rendered text-frame record into an explicit read model.
+     * @param {object} text Normalized text-frame text record.
+     * @returns {object}
+     */
+    static #normalizeTextFrameContract(text) {
+        const left = Math.min(Number(text.x || 0), Number(text.cornerX || 0))
+        const right = Math.max(Number(text.x || 0), Number(text.cornerX || 0))
+        const top = Math.max(Number(text.y || 0), Number(text.cornerY || 0))
+        const bottom = Math.min(Number(text.y || 0), Number(text.cornerY || 0))
+
+        return SchematicTextParser.#stripUndefined({
+            x: text.x,
+            y: text.y,
+            cornerX: text.cornerX,
+            cornerY: text.cornerY,
+            width: right - left,
+            height: top - bottom,
+            text: text.text,
+            alignment: SchematicTextParser.#alignmentFromAnchor(text.anchor),
+            borderWidth: text.lineWidth || 1,
+            color: text.color,
+            borderColor: text.borderColor,
+            fill: text.fill,
+            isSolid: text.isSolid,
+            showBorder: text.showBorder,
+            font: {
+                size: text.fontSize,
+                family: text.fontFamily,
+                weight: text.fontWeight,
+                ...(text.fontStyle ? { style: text.fontStyle } : {})
+            },
+            textMargin: text.textMargin,
+            renderOrder: text.renderOrder,
+            ownerIndex: text.ownerIndex
+        })
+    }
+
+    /**
+     * Converts SVG text-anchor naming to a read-model alignment label.
+     * @param {string | undefined} anchor Text anchor.
+     * @returns {'left' | 'center' | 'right'}
+     */
+    static #alignmentFromAnchor(anchor) {
+        if (anchor === 'middle') return 'center'
+        if (anchor === 'end') return 'right'
+        return 'left'
+    }
+
+    /**
+     * Removes undefined values from one object.
+     * @param {object} value Source object.
+     * @returns {object}
+     */
+    static #stripUndefined(value) {
+        return Object.fromEntries(
+            Object.entries(value || {}).filter(
+                ([, entryValue]) => entryValue !== undefined
+            )
+        )
+    }
+
     /**
      * Decodes Altium note control codes into visible text rows.
      * @param {string} text

package/src/core/ole/OleCompoundDocument.mjs

@@ -30,6 +30,7 @@ export class OleCompoundDocument {
     constructor(arrayBuffer) {
         this.#reader = new BinaryReader(arrayBuffer)
         this.#header = this.#parseHeader()
+        this.#assertSectorAlignedFile()
         this.#fatEntries = this.#parseFatEntries()
         this.#directoryEntries = this.#parseDirectoryEntries()
         this.#miniFatEntries = this.#parseMiniFatEntries()
@@ -137,6 +138,25 @@ export class OleCompoundDocument {
         }
     }
 
+    /**
+     * Ensures the byte stream still matches the OLE sector grid.
+     */
+    #assertSectorAlignedFile() {
+        const payloadByteLength =
+            this.#reader.byteLength - OleConstants.HEADER_BYTE_LENGTH
+
+        if (
+            payloadByteLength < 0 ||
+            payloadByteLength % this.#header.sectorByteLength !== 0
+        ) {
+            throw new Error(
+                'OLE compound document byte length is not sector-aligned. ' +
+                    'The file may be truncated or line-ending normalized; ' +
+                    'keep Altium binary files committed and served as binary.'
+            )
+        }
+    }
+
     /**
      * Parses all FAT entries.
      * @returns {number[]}

package/src/parser.mjs

@@ -9,28 +9,57 @@ 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 { IntLibModelParser } from './core/altium/IntLibModelParser.mjs'
+export { IntLibStreamExtractor } from './core/altium/IntLibStreamExtractor.mjs'
+export { EmbeddedFileInventoryBuilder } from './core/altium/EmbeddedFileInventoryBuilder.mjs'
+export { LibraryRenderManifestBuilder } from './core/altium/LibraryRenderManifestBuilder.mjs'
+export { LibrarySearchIndex } from './core/altium/LibrarySearchIndex.mjs'
 export { ParserUtils } from './core/altium/ParserUtils.mjs'
 export { NormalizedModelSchema } from './core/altium/NormalizedModelSchema.mjs'
+export { ProjectDesignBundleBuilder } from './core/altium/ProjectDesignBundleBuilder.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 { PcbBoardRegionSemanticsParser } from './core/altium/PcbBoardRegionSemanticsParser.mjs'
 export { PcbComponentPrimitiveIndexer } from './core/altium/PcbComponentPrimitiveIndexer.mjs'
+export { PcbCustomPadShapeParser } from './core/altium/PcbCustomPadShapeParser.mjs'
+export { PcbDimensionParser } from './core/altium/PcbDimensionParser.mjs'
 export { PcbEmbeddedFontExtractor } from './core/altium/PcbEmbeddedFontExtractor.mjs'
 export { PcbEmbeddedModelExtractor } from './core/altium/PcbEmbeddedModelExtractor.mjs'
+export { PcbExtendedPrimitiveInformationParser } from './core/altium/PcbExtendedPrimitiveInformationParser.mjs'
 export { PcbFontMetricsParser } from './core/altium/PcbFontMetricsParser.mjs'
 export { PcbLayerIdCodec } from './core/altium/PcbLayerIdCodec.mjs'
 export { PcbLibModelParser } from './core/altium/PcbLibModelParser.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 { PcbPickPlacePositionResolver } from './core/altium/PcbPickPlacePositionResolver.mjs'
 export { PcbRawRecordRegistry } from './core/altium/PcbRawRecordRegistry.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 { SchematicMultipartOwnerMatcher } from './core/altium/SchematicMultipartOwnerMatcher.mjs'
+export { SchematicCrossSheetConnectorParser } from './core/altium/SchematicCrossSheetConnectorParser.mjs'
+export { SchematicHarnessParser } from './core/altium/SchematicHarnessParser.mjs'
+export { SchematicImplementationParser } from './core/altium/SchematicImplementationParser.mjs'
+export { SchematicOwnershipGraphParser } from './core/altium/SchematicOwnershipGraphParser.mjs'
+export { SchematicProjectParameterResolver } from './core/altium/SchematicProjectParameterResolver.mjs'
+export { SchematicQaReportBuilder } from './core/altium/SchematicQaReportBuilder.mjs'
+export { SchematicRecordTypeRegistry } from './core/altium/SchematicRecordTypeRegistry.mjs'
+export { SchematicRepeatedChannelParser } from './core/altium/SchematicRepeatedChannelParser.mjs'
+export { SchematicTemplateParser } from './core/altium/SchematicTemplateParser.mjs'
 export { SchematicStandaloneCalloutNormalizer } from './core/altium/SchematicStandaloneCalloutNormalizer.mjs'

package/src/renderers.mjs

@@ -6,6 +6,9 @@ export { BomTableRenderer } from './ui/BomTableRenderer.mjs'
 export { PcbArcUtils } from './ui/PcbArcUtils.mjs'
 export { PcbEdgeFacingGlyphNormalizer } from './ui/PcbEdgeFacingGlyphNormalizer.mjs'
 export { PcbFootprintPrimitiveSelector } from './ui/PcbFootprintPrimitiveSelector.mjs'
+export { PcbInteractionIndex } from './ui/PcbInteractionIndex.mjs'
+export { PcbInteractionItemRegistry } from './ui/PcbInteractionItemRegistry.mjs'
+export { PcbInteractionLayerModel } from './ui/PcbInteractionLayerModel.mjs'
 export {
     PcbSideResolvedRenderModel,
     isCopperPrimitive,

package/src/styles/altium-renderers.css

@@ -137,6 +137,7 @@
     --pcb-copper-fill: rgba(196, 118, 70, 0.24);
     --pcb-copper-solid-fill: rgba(196, 118, 70, 0.78);
     --pcb-track-color: #c7522d;
+    --pcb-track-opacity: 1;
     --pcb-via-ring-fill: rgba(232, 236, 233, 0.92);
     --pcb-via-hole-fill: #0f746c;
     --pcb-footprint-fill: rgba(247, 230, 117, 0.14);
@@ -203,6 +204,11 @@
     stroke-linejoin: round;
 }
 
+.pcb-track,
+.pcb-arc {
+    opacity: var(--pcb-track-opacity, 1);
+}
+
 .pcb-copper--surface .pcb-polygon {
     fill: var(--pcb-surface-copper-fill);
 }
@@ -289,6 +295,25 @@
     fill: #000;
 }
 
+.pcb-barcode__background,
+.pcb-barcode__bar {
+    fill: var(--pcb-footprint-track-color);
+}
+
+.pcb-text--barcode-inverted .pcb-barcode__background {
+    fill: var(--pcb-text-knockout-fill);
+}
+
+.pcb-text--barcode-inverted .pcb-barcode__bar {
+    fill: var(--pcb-footprint-track-color);
+}
+
+.pcb-barcode__caption {
+    fill: var(--pcb-footprint-track-color);
+    font-family: Arial, sans-serif;
+    font-weight: 700;
+}
+
 .bom-panel {
     display: grid;
     gap: 1rem;