kicadts 0.0.6 → 0.0.8

package/README.md

@@ -2,6 +2,8 @@
 
 `kicadts` is a TypeScript-first toolkit for reading, editing, and generating KiCad S-expression documents. Every KiCad token is modeled as a class, so you can compose schematics, boards, and footprints entirely in TypeScript and emit KiCad-compatible files with deterministic formatting.
 
+[![npm version](https://img.shields.io/npm/v/kicadts.svg)](https://www.npmjs.com/package/kicadts)
+
 ## Local Setup
 
 This repository uses [Bun](https://bun.sh) for scripts and testing.

package/dist/index.d.ts

@@ -1283,15 +1283,57 @@ declare class Property extends SxClass {
     getString(): string;
 }
 
+declare class SheetInstancesRoot extends SxClass {
+    static token: string;
+    token: string;
+    private _paths;
+    static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): SheetInstancesRoot;
+    get paths(): SheetInstancesRootPath[];
+    set paths(value: SheetInstancesRootPath[]);
+    getChildren(): SxClass[];
+}
+declare class SheetInstancesRootPath extends SxClass {
+    static token: string;
+    static parentToken: string;
+    token: string;
+    private _value;
+    private _pages;
+    static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): SheetInstancesRootPath;
+    get value(): string;
+    set value(newValue: string);
+    get pages(): SheetInstancesRootPage[];
+    set pages(value: SheetInstancesRootPage[]);
+    getChildren(): SxClass[];
+    getString(): string;
+}
+declare class SheetInstancesRootPage extends SxPrimitiveString {
+    static token: string;
+    static parentToken: string;
+    token: string;
+    static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): SheetInstancesRootPage;
+    getString(): string;
+}
+
 declare class SheetInstances extends SxClass {
     static token: string;
     static parentToken: string;
     token: string;
-    projects: SheetInstancesProject[];
+    private _projects;
+    private _paths;
     static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): SheetInstances;
+    get projects(): SheetInstancesProject[];
+    set projects(value: SheetInstancesProject[]);
+    get paths(): SheetInstancesRootPath[];
+    set paths(value: SheetInstancesRootPath[]);
     getChildren(): SxClass[];
     getString(): string;
 }
+declare class SheetInstancesForSheet extends SheetInstances {
+    static token: string;
+    static parentToken: string;
+    token: string;
+    static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): SheetInstancesForSheet;
+}
 declare class SheetInstancesProject extends SxClass {
     static token: string;
     static parentToken: string;
@@ -1478,7 +1520,7 @@ interface KicadSchConstructorParams {
     paper?: Paper;
     titleBlock?: TitleBlock;
     libSymbols?: LibSymbols;
-    sheetInstances?: SheetInstances;
+    sheetInstances?: SheetInstances | SheetInstances[];
     embeddedFonts?: EmbeddedFonts;
     properties?: Property[];
     images?: Image[];
@@ -1499,7 +1541,7 @@ declare class KicadSch extends SxClass {
     private _sxPaper?;
     private _sxTitleBlock?;
     private _sxLibSymbols?;
-    private _sxSheetInstances?;
+    private _sheetInstances;
     private _sxEmbeddedFonts?;
     private _properties;
     private _images;
@@ -1525,8 +1567,8 @@ declare class KicadSch extends SxClass {
     set titleBlock(value: TitleBlock | undefined);
     get libSymbols(): LibSymbols | undefined;
     set libSymbols(value: LibSymbols | undefined);
-    get sheetInstances(): SheetInstances | undefined;
-    set sheetInstances(value: SheetInstances | undefined);
+    get sheetInstances(): SheetInstances[];
+    set sheetInstances(value: SheetInstances | SheetInstances[] | undefined);
     get embeddedFonts(): EmbeddedFonts | undefined;
     set embeddedFonts(value: EmbeddedFonts | undefined);
     get properties(): Property[];
@@ -3390,37 +3432,6 @@ declare class FpPolyLocked extends SxPrimitiveBoolean {
     getString(): string;
 }
 
-declare class SheetInstancesRoot extends SxClass {
-    static token: string;
-    token: string;
-    private _paths;
-    static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): SheetInstancesRoot;
-    get paths(): SheetInstancesRootPath[];
-    set paths(value: SheetInstancesRootPath[]);
-    getChildren(): SxClass[];
-}
-declare class SheetInstancesRootPath extends SxClass {
-    static token: string;
-    static parentToken: string;
-    token: string;
-    private _value;
-    private _pages;
-    static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): SheetInstancesRootPath;
-    get value(): string;
-    set value(newValue: string);
-    get pages(): SheetInstancesRootPage[];
-    set pages(value: SheetInstancesRootPage[]);
-    getChildren(): SxClass[];
-    getString(): string;
-}
-declare class SheetInstancesRootPage extends SxPrimitiveString {
-    static token: string;
-    static parentToken: string;
-    token: string;
-    static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): SheetInstancesRootPage;
-    getString(): string;
-}
-
 declare class PcbPlotParams extends SxClass {
     static token: string;
     static parentToken: string;
@@ -4463,4 +4474,4 @@ declare class KicadPcb extends SxClass {
 
 declare const parseKicadSexpr: (sexpr: string) => SxClass[];
 
-export { At, type AtInput, Bus, type BusConstructorParams, BusEntry, type BusEntryConstructorParams, BusEntrySize, Color, Dnp, EmbeddedFonts, ExcludeFromSim, FieldsAutoplaced, Footprint, FootprintAttr, FootprintAutoplaceCost180, FootprintAutoplaceCost90, FootprintClearance, type FootprintConstructorParams, FootprintDescr, FootprintLocked, FootprintModel, FootprintNetTiePadGroups, FootprintPad, type FootprintPadConstructorParams, FootprintPath, FootprintPlaced, FootprintPrivateLayers, FootprintSheetfile, FootprintSheetname, FootprintSolderMaskMargin, FootprintSolderPasteMargin, FootprintSolderPasteRatio, FootprintTags, FootprintTedit, FootprintThermalGap, FootprintThermalWidth, FootprintZoneConnect, FpArc, type FpArcConstructorParams, FpArcEnd, FpArcMid, FpArcStart, FpCircle, FpCircleCenter, type FpCircleConstructorParams, FpCircleEnd, FpCircleFill, FpLine, type FpLineConstructorParams, FpLineEnd, FpLineStart, FpPoly, type FpPolyConstructorParams, FpPolyFill, FpPolyLocked, FpRect, type FpRectConstructorParams, FpRectEnd, FpRectFill, FpRectStart, FpText, FpTextBox, FpTextBoxAngle, type FpTextBoxConstructorParams, FpTextBoxEnd, FpTextBoxStart, type FpTextConstructorParams, type FpTextType, GrLine, GrLineAngle, type GrLineConstructorParams, GrLineEnd, GrLineLocked, type GrLinePoint, GrLineStart, GrText, type GrTextConstructorParams, type GrTextPosition, Image, type ImageConstructorParams, ImageData, ImageScale, InBom, Junction, type JunctionConstructorParams, JunctionDiameter, KicadPcb, type KicadPcbConstructorParams, KicadSch, type KicadSchConstructorParams, KicadSchGenerator, KicadSchGeneratorVersion, KicadSchVersion, Label, type LabelConstructorParams, Layer, Layers, LibSymbols, type ModelVector, NoConnect, type NoConnectConstructorParams, OnBoard, PadChamfer, PadChamferRatio, PadClearance, PadDieLength, PadDrill, PadDrillOffset, PadLayers, type PadLayersInput, PadNet, PadOptions, type PadOptionsAnchorShape, type PadOptionsClearanceType, PadPinFunction, PadPinType, PadPrimitiveGrArc, type PadPrimitiveGrArcConstructorParams, PadPrimitiveGrCircle, type PadPrimitiveGrCircleConstructorParams, PadPrimitiveGrLine, PadPrimitiveGrPoly, PadPrimitives, PadRectDelta, PadRoundrectRratio, PadSize, type PadSizeInput, PadSolderMaskMargin, PadSolderPasteMargin, PadSolderPasteMarginRatio, PadTeardrops, PadThermalBridgeAngle, PadThermalGap, PadThermalWidth, PadZoneConnect, Paper, PcbGeneral, PcbGeneralLegacyTeardrops, PcbGeneralThickness, PcbGenerator, PcbGeneratorVersion, PcbLayerDefinition, PcbLayers, PcbNet, PcbPlotParams, PcbVersion, PlotParamCreateGerberJobFile, PlotParamCrossoutDnpOnFab, PlotParamDashedLineDashRatio, PlotParamDashedLineGapRatio, PlotParamDisableApertMacros, PlotParamDrillShape, PlotParamDxfImperialUnits, PlotParamDxfPolygonMode, PlotParamDxfUsePcbnewFont, PlotParamExcludeEdgeLayer, PlotParamHideDnpOnFab, PlotParamHpglPenDiameter, PlotParamHpglPenNumber, PlotParamHpglPenOverlay, PlotParamHpglPenSpeed, PlotParamLayerSelection, PlotParamLineWidth, PlotParamMirror, PlotParamMode, PlotParamOutputDirectory, PlotParamOutputFormat, PlotParamPadOnSilk, PlotParamPdfBackFpPropertyPopups, PlotParamPdfFrontFpPropertyPopups, PlotParamPdfMetadata, PlotParamPdfSingleDocument, PlotParamPlotBlackAndWhite, PlotParamPlotFrameRef, PlotParamPlotInvisible, PlotParamPlotInvisibleText, PlotParamPlotOnAllLayers, PlotParamPlotOnAllLayersSelection, PlotParamPlotOtherText, PlotParamPlotPadNumbers, PlotParamPlotReference, PlotParamPlotValue, PlotParamProperty, PlotParamPsA4Output, PlotParamPsNegative, PlotParamScaleSelection, PlotParamSketchDnpOnFab, PlotParamSketchPadsOnFab, PlotParamSubtractMaskFromSilk, PlotParamSvgPrecision, PlotParamUseAuxOrigin, PlotParamUseGerberAdvancedAttributes, PlotParamUseGerberAttributes, PlotParamUseGerberExtensions, PlotParamViaOnMask, Property, type PropertyConstructorParams, PropertyHide, PropertyUnlocked, Pts, type RGBAColor, RenderCache, SchematicSymbol, type SchematicSymbolConstructorParams, SchematicText, type SchematicTextConstructorParams, Segment, type SegmentConstructorParams, SegmentEnd, SegmentLocked, SegmentNet, SegmentStart, Setup, SetupAllowSoldermaskBridgesInFootprints, SetupAuxAxisOrigin, SetupEdgeWidth, SetupGridOrigin, SetupLastTraceWidth, SetupModEdgeWidth, SetupModTextSize, SetupModTextWidth, SetupPadDrill, SetupPadSize, SetupPadToMaskClearance, SetupPadToPasteClearance, SetupPadToPasteClearanceRatio, SetupPadToPasteClearanceValues, SetupPcbTextSize, SetupPcbTextWidth, type SetupProperty, type SetupPropertyValues, SetupSegmentWidth, SetupSolderMaskMinWidth, SetupTenting, SetupTraceClearance, SetupTraceMin, SetupTraceWidth, SetupUviaDrill, SetupUviaMinDrill, SetupUviaMinSize, SetupUviaSize, SetupUviasAllowed, SetupViaDrill, SetupViaMinDrill, SetupViaMinSize, SetupViaSize, SetupVisibleElements, SetupZone45Only, SetupZoneClearance, Sheet, type SheetConstructorParams, SheetFill, SheetInstancePage, SheetInstancePath, SheetInstances, SheetInstancesProject, SheetInstancesRoot, SheetInstancesRootPage, SheetInstancesRootPath, SheetPin, type SheetPinElectricalType, SheetProperty, SheetSize, Stackup, StackupCastellatedPads, StackupCopperFinish, StackupDielectricConstraints, StackupEdgeConnector, StackupEdgePlating, StackupLayer, StackupLayerColor, StackupLayerEpsilonR, StackupLayerLossTangent, StackupLayerMaterial, StackupLayerThickness, StackupLayerType, type StandardPaperSize, Stroke, type StrokeProperty, StrokeType, type StrokeTypeString, SxClass, SymbolArc, SymbolArcEnd, SymbolArcFill, SymbolArcMid, SymbolArcStart, SymbolCircle, SymbolCircleCenter, SymbolCircleFill, SymbolCircleRadius, SymbolDuplicatePinNumbersAreJumpers, SymbolFillType, SymbolInstancePath, SymbolInstanceReference, SymbolInstanceUnit, SymbolInstances, SymbolInstancesProject, SymbolLibId, SymbolPin, SymbolPinLength, SymbolPinName, SymbolPinNames, SymbolPinNamesHide, SymbolPinNamesOffset, SymbolPinNumber, SymbolPinNumbers, SymbolPinNumbersHide, SymbolPolyline, SymbolPolylineFill, SymbolPower, SymbolProperty, SymbolPropertyId, SymbolRectangle, SymbolRectangleEnd, SymbolRectangleFill, SymbolRectangleStart, SymbolText, SymbolUnit, TextEffects, type TextEffectsConstructorParams, TextEffectsFont, TextEffectsFontFace, TextEffectsFontLineSpacing, type TextEffectsFontProperty, TextEffectsFontSize, TextEffectsFontThickness, TextEffectsJustify, type TextEffectsProperty, TitleBlock, TitleBlockComment, TitleBlockCompany, type TitleBlockConstructorParams, TitleBlockDate, TitleBlockRevision, TitleBlockTitle, Unit, type UnitString, Uuid, Via, type ViaConstructorParams, ViaNet, Width, Wire, type WireConstructorParams, Xy, Zone, parseKicadSexpr };
+export { At, type AtInput, Bus, type BusConstructorParams, BusEntry, type BusEntryConstructorParams, BusEntrySize, Color, Dnp, EmbeddedFonts, ExcludeFromSim, FieldsAutoplaced, Footprint, FootprintAttr, FootprintAutoplaceCost180, FootprintAutoplaceCost90, FootprintClearance, type FootprintConstructorParams, FootprintDescr, FootprintLocked, FootprintModel, FootprintNetTiePadGroups, FootprintPad, type FootprintPadConstructorParams, FootprintPath, FootprintPlaced, FootprintPrivateLayers, FootprintSheetfile, FootprintSheetname, FootprintSolderMaskMargin, FootprintSolderPasteMargin, FootprintSolderPasteRatio, FootprintTags, FootprintTedit, FootprintThermalGap, FootprintThermalWidth, FootprintZoneConnect, FpArc, type FpArcConstructorParams, FpArcEnd, FpArcMid, FpArcStart, FpCircle, FpCircleCenter, type FpCircleConstructorParams, FpCircleEnd, FpCircleFill, FpLine, type FpLineConstructorParams, FpLineEnd, FpLineStart, FpPoly, type FpPolyConstructorParams, FpPolyFill, FpPolyLocked, FpRect, type FpRectConstructorParams, FpRectEnd, FpRectFill, FpRectStart, FpText, FpTextBox, FpTextBoxAngle, type FpTextBoxConstructorParams, FpTextBoxEnd, FpTextBoxStart, type FpTextConstructorParams, type FpTextType, GrLine, GrLineAngle, type GrLineConstructorParams, GrLineEnd, GrLineLocked, type GrLinePoint, GrLineStart, GrText, type GrTextConstructorParams, type GrTextPosition, Image, type ImageConstructorParams, ImageData, ImageScale, InBom, Junction, type JunctionConstructorParams, JunctionDiameter, KicadPcb, type KicadPcbConstructorParams, KicadSch, type KicadSchConstructorParams, KicadSchGenerator, KicadSchGeneratorVersion, KicadSchVersion, Label, type LabelConstructorParams, Layer, Layers, LibSymbols, type ModelVector, NoConnect, type NoConnectConstructorParams, OnBoard, PadChamfer, PadChamferRatio, PadClearance, PadDieLength, PadDrill, PadDrillOffset, PadLayers, type PadLayersInput, PadNet, PadOptions, type PadOptionsAnchorShape, type PadOptionsClearanceType, PadPinFunction, PadPinType, PadPrimitiveGrArc, type PadPrimitiveGrArcConstructorParams, PadPrimitiveGrCircle, type PadPrimitiveGrCircleConstructorParams, PadPrimitiveGrLine, PadPrimitiveGrPoly, PadPrimitives, PadRectDelta, PadRoundrectRratio, PadSize, type PadSizeInput, PadSolderMaskMargin, PadSolderPasteMargin, PadSolderPasteMarginRatio, PadTeardrops, PadThermalBridgeAngle, PadThermalGap, PadThermalWidth, PadZoneConnect, Paper, PcbGeneral, PcbGeneralLegacyTeardrops, PcbGeneralThickness, PcbGenerator, PcbGeneratorVersion, PcbLayerDefinition, PcbLayers, PcbNet, PcbPlotParams, PcbVersion, PlotParamCreateGerberJobFile, PlotParamCrossoutDnpOnFab, PlotParamDashedLineDashRatio, PlotParamDashedLineGapRatio, PlotParamDisableApertMacros, PlotParamDrillShape, PlotParamDxfImperialUnits, PlotParamDxfPolygonMode, PlotParamDxfUsePcbnewFont, PlotParamExcludeEdgeLayer, PlotParamHideDnpOnFab, PlotParamHpglPenDiameter, PlotParamHpglPenNumber, PlotParamHpglPenOverlay, PlotParamHpglPenSpeed, PlotParamLayerSelection, PlotParamLineWidth, PlotParamMirror, PlotParamMode, PlotParamOutputDirectory, PlotParamOutputFormat, PlotParamPadOnSilk, PlotParamPdfBackFpPropertyPopups, PlotParamPdfFrontFpPropertyPopups, PlotParamPdfMetadata, PlotParamPdfSingleDocument, PlotParamPlotBlackAndWhite, PlotParamPlotFrameRef, PlotParamPlotInvisible, PlotParamPlotInvisibleText, PlotParamPlotOnAllLayers, PlotParamPlotOnAllLayersSelection, PlotParamPlotOtherText, PlotParamPlotPadNumbers, PlotParamPlotReference, PlotParamPlotValue, PlotParamProperty, PlotParamPsA4Output, PlotParamPsNegative, PlotParamScaleSelection, PlotParamSketchDnpOnFab, PlotParamSketchPadsOnFab, PlotParamSubtractMaskFromSilk, PlotParamSvgPrecision, PlotParamUseAuxOrigin, PlotParamUseGerberAdvancedAttributes, PlotParamUseGerberAttributes, PlotParamUseGerberExtensions, PlotParamViaOnMask, Property, type PropertyConstructorParams, PropertyHide, PropertyUnlocked, Pts, type RGBAColor, RenderCache, SchematicSymbol, type SchematicSymbolConstructorParams, SchematicText, type SchematicTextConstructorParams, Segment, type SegmentConstructorParams, SegmentEnd, SegmentLocked, SegmentNet, SegmentStart, Setup, SetupAllowSoldermaskBridgesInFootprints, SetupAuxAxisOrigin, SetupEdgeWidth, SetupGridOrigin, SetupLastTraceWidth, SetupModEdgeWidth, SetupModTextSize, SetupModTextWidth, SetupPadDrill, SetupPadSize, SetupPadToMaskClearance, SetupPadToPasteClearance, SetupPadToPasteClearanceRatio, SetupPadToPasteClearanceValues, SetupPcbTextSize, SetupPcbTextWidth, type SetupProperty, type SetupPropertyValues, SetupSegmentWidth, SetupSolderMaskMinWidth, SetupTenting, SetupTraceClearance, SetupTraceMin, SetupTraceWidth, SetupUviaDrill, SetupUviaMinDrill, SetupUviaMinSize, SetupUviaSize, SetupUviasAllowed, SetupViaDrill, SetupViaMinDrill, SetupViaMinSize, SetupViaSize, SetupVisibleElements, SetupZone45Only, SetupZoneClearance, Sheet, type SheetConstructorParams, SheetFill, SheetInstancePage, SheetInstancePath, SheetInstances, SheetInstancesForSheet, SheetInstancesProject, SheetInstancesRoot, SheetInstancesRootPage, SheetInstancesRootPath, SheetPin, type SheetPinElectricalType, SheetProperty, SheetSize, Stackup, StackupCastellatedPads, StackupCopperFinish, StackupDielectricConstraints, StackupEdgeConnector, StackupEdgePlating, StackupLayer, StackupLayerColor, StackupLayerEpsilonR, StackupLayerLossTangent, StackupLayerMaterial, StackupLayerThickness, StackupLayerType, type StandardPaperSize, Stroke, type StrokeProperty, StrokeType, type StrokeTypeString, SxClass, SymbolArc, SymbolArcEnd, SymbolArcFill, SymbolArcMid, SymbolArcStart, SymbolCircle, SymbolCircleCenter, SymbolCircleFill, SymbolCircleRadius, SymbolDuplicatePinNumbersAreJumpers, SymbolFillType, SymbolInstancePath, SymbolInstanceReference, SymbolInstanceUnit, SymbolInstances, SymbolInstancesProject, SymbolLibId, SymbolPin, SymbolPinLength, SymbolPinName, SymbolPinNames, SymbolPinNamesHide, SymbolPinNamesOffset, SymbolPinNumber, SymbolPinNumbers, SymbolPinNumbersHide, SymbolPolyline, SymbolPolylineFill, SymbolPower, SymbolProperty, SymbolPropertyId, SymbolRectangle, SymbolRectangleEnd, SymbolRectangleFill, SymbolRectangleStart, SymbolText, SymbolUnit, TextEffects, type TextEffectsConstructorParams, TextEffectsFont, TextEffectsFontFace, TextEffectsFontLineSpacing, type TextEffectsFontProperty, TextEffectsFontSize, TextEffectsFontThickness, TextEffectsJustify, type TextEffectsProperty, TitleBlock, TitleBlockComment, TitleBlockCompany, type TitleBlockConstructorParams, TitleBlockDate, TitleBlockRevision, TitleBlockTitle, Unit, type UnitString, Uuid, Via, type ViaConstructorParams, ViaNet, Width, Wire, type WireConstructorParams, Xy, Zone, parseKicadSexpr };

package/dist/index.js

@@ -4133,34 +4133,215 @@ var Property = class _Property extends SxClass {
 };
 SxClass.register(Property);
 
+// lib/sexpr/classes/SheetInstancesRoot.ts
+var SUPPORTED_ARRAY_TOKENS2 = /* @__PURE__ */ new Set(["page"]);
+var SheetInstancesRoot = class _SheetInstancesRoot extends SxClass {
+  static token = "sheet_instances";
+  token = "sheet_instances";
+  _paths = [];
+  static fromSexprPrimitives(primitiveSexprs) {
+    const sheetInstances = new _SheetInstancesRoot();
+    const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(primitiveSexprs, this.token);
+    const unsupportedSingularTokens = Object.keys(propertyMap).filter(
+      (token) => token !== "path"
+    );
+    if (unsupportedSingularTokens.length > 0) {
+      throw new Error(
+        `Unsupported singular child tokens inside sheet_instances expression: ${unsupportedSingularTokens.join(", ")}`
+      );
+    }
+    const unsupportedArrayTokens = Object.keys(arrayPropertyMap).filter(
+      (token) => token !== "path"
+    );
+    if (unsupportedArrayTokens.length > 0) {
+      throw new Error(
+        `Unsupported repeated child tokens inside sheet_instances expression: ${unsupportedArrayTokens.join(", ")}`
+      );
+    }
+    const paths = arrayPropertyMap.path ?? [];
+    if (!paths.length && propertyMap.path) {
+      paths.push(propertyMap.path);
+    }
+    sheetInstances._paths = paths;
+    return sheetInstances;
+  }
+  get paths() {
+    return [...this._paths];
+  }
+  set paths(value) {
+    this._paths = [...value];
+  }
+  getChildren() {
+    return [...this._paths];
+  }
+};
+SxClass.register(SheetInstancesRoot);
+var SheetInstancesRootPath = class _SheetInstancesRootPath extends SxClass {
+  static token = "path";
+  static parentToken = "sheet_instances";
+  token = "path";
+  _value = "";
+  _pages = [];
+  static fromSexprPrimitives(primitiveSexprs) {
+    const [valuePrimitive, ...rest] = primitiveSexprs;
+    const value = toStringValue(valuePrimitive);
+    if (value === void 0) {
+      throw new Error("sheet_instances path requires a string identifier");
+    }
+    const path = new _SheetInstancesRootPath();
+    path._value = value;
+    const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(rest, "sheet_instances_path");
+    const unsupportedSingularTokens = Object.keys(propertyMap).filter(
+      (token) => !SUPPORTED_ARRAY_TOKENS2.has(token)
+    );
+    if (unsupportedSingularTokens.length > 0) {
+      throw new Error(
+        `Unsupported singular child tokens inside sheet_instances path expression: ${unsupportedSingularTokens.join(", ")}`
+      );
+    }
+    const unsupportedArrayTokens = Object.keys(arrayPropertyMap).filter(
+      (token) => !SUPPORTED_ARRAY_TOKENS2.has(token)
+    );
+    if (unsupportedArrayTokens.length > 0) {
+      throw new Error(
+        `Unsupported repeated child tokens inside sheet_instances path expression: ${unsupportedArrayTokens.join(", ")}`
+      );
+    }
+    const pages = arrayPropertyMap.page ?? [];
+    if (!pages.length && propertyMap.page) {
+      pages.push(propertyMap.page);
+    }
+    path._pages = pages;
+    return path;
+  }
+  get value() {
+    return this._value;
+  }
+  set value(newValue) {
+    this._value = newValue;
+  }
+  get pages() {
+    return [...this._pages];
+  }
+  set pages(value) {
+    this._pages = [...value];
+  }
+  getChildren() {
+    return [...this._pages];
+  }
+  getString() {
+    const lines = [`(path ${quoteSExprString(this._value)}`];
+    for (const page of this._pages) {
+      lines.push(page.getStringIndented());
+    }
+    lines.push(")");
+    return lines.join("\n");
+  }
+};
+SxClass.register(SheetInstancesRootPath);
+var SheetInstancesRootPage = class _SheetInstancesRootPage extends SxPrimitiveString {
+  static token = "page";
+  static parentToken = "sheet_instances_path";
+  token = "page";
+  static fromSexprPrimitives(primitiveSexprs) {
+    const [valuePrimitive] = primitiveSexprs;
+    const value = toStringValue(valuePrimitive);
+    if (value === void 0) {
+      throw new Error("sheet_instances page expects a string value");
+    }
+    return new _SheetInstancesRootPage(value);
+  }
+  getString() {
+    return `(page ${quoteSExprString(this.value)})`;
+  }
+};
+SxClass.register(SheetInstancesRootPage);
+
 // lib/sexpr/classes/SheetInstances.ts
+var SUPPORTED_CHILD_TOKENS = /* @__PURE__ */ new Set(["project", "path"]);
+var parseSheetInstancesChildren = (primitiveSexprs) => {
+  const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(primitiveSexprs, "sheet_instances");
+  const unsupportedSingularTokens = Object.keys(propertyMap).filter(
+    (token) => !SUPPORTED_CHILD_TOKENS.has(token)
+  );
+  if (unsupportedSingularTokens.length > 0) {
+    throw new Error(
+      `sheet_instances encountered unsupported child token${unsupportedSingularTokens.length > 1 ? "s" : ""} ${unsupportedSingularTokens.map((token) => `"${token}"`).join(", ")}`
+    );
+  }
+  const unsupportedArrayTokens = Object.keys(arrayPropertyMap).filter(
+    (token) => !SUPPORTED_CHILD_TOKENS.has(token)
+  );
+  if (unsupportedArrayTokens.length > 0) {
+    throw new Error(
+      `sheet_instances encountered unsupported repeated child token${unsupportedArrayTokens.length > 1 ? "s" : ""} ${unsupportedArrayTokens.map((token) => `"${token}"`).join(", ")}`
+    );
+  }
+  const projects = arrayPropertyMap.project ?? [];
+  if (!projects.length && propertyMap.project) {
+    projects.push(propertyMap.project);
+  }
+  const paths = arrayPropertyMap.path ?? [];
+  if (!paths.length && propertyMap.path) {
+    paths.push(propertyMap.path);
+  }
+  return { projects, paths };
+};
 var SheetInstances = class _SheetInstances extends SxClass {
   static token = "sheet_instances";
   static parentToken = "kicad_sch";
   token = "sheet_instances";
-  projects = [];
+  _projects = [];
+  _paths = [];
   static fromSexprPrimitives(primitiveSexprs) {
     const instances = new _SheetInstances();
-    const { arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(
-      primitiveSexprs,
-      "sheet_instances"
-    );
-    instances.projects = arrayPropertyMap.project ?? [];
+    const { projects, paths } = parseSheetInstancesChildren(primitiveSexprs);
+    instances.projects = projects;
+    instances.paths = paths;
     return instances;
   }
+  get projects() {
+    return [...this._projects];
+  }
+  set projects(value) {
+    this._projects = [...value];
+  }
+  get paths() {
+    return [...this._paths];
+  }
+  set paths(value) {
+    this._paths = [...value];
+  }
   getChildren() {
-    return [...this.projects];
+    return [...this._projects, ...this._paths];
   }
   getString() {
-    const lines = ["(sheet_instances"];
-    for (const project of this.projects) {
-      lines.push(project.getStringIndented());
+    const children = this.getChildren();
+    if (children.length === 0) {
+      return `(${this.token})`;
+    }
+    const lines = [`(${this.token}`];
+    for (const child of children) {
+      lines.push(child.getStringIndented());
     }
     lines.push(")");
     return lines.join("\n");
   }
 };
 SxClass.register(SheetInstances);
+var SheetInstancesForSheet = class _SheetInstancesForSheet extends SheetInstances {
+  static token = "instances";
+  static parentToken = "sheet";
+  token = "instances";
+  static fromSexprPrimitives(primitiveSexprs) {
+    const instances = new _SheetInstancesForSheet();
+    const { projects, paths } = parseSheetInstancesChildren(primitiveSexprs);
+    instances.projects = projects;
+    instances.paths = paths;
+    return instances;
+  }
+};
+SxClass.register(SheetInstancesForSheet);
 var SheetInstancesProject = class _SheetInstancesProject extends SxClass {
   static token = "project";
   static parentToken = "sheet_instances";
@@ -4678,7 +4859,6 @@ var SINGLE_CHILD_TOKENS = /* @__PURE__ */ new Set([
   "paper",
   "title_block",
   "lib_symbols",
-  "sheet_instances",
   "embedded_fonts"
 ]);
 var MULTI_CHILD_TOKENS = /* @__PURE__ */ new Set([
@@ -4689,9 +4869,10 @@ var MULTI_CHILD_TOKENS = /* @__PURE__ */ new Set([
   "text",
   "label",
   "junction",
-  "wire"
+  "wire",
+  "sheet_instances"
 ]);
-var SUPPORTED_CHILD_TOKENS = /* @__PURE__ */ new Set([
+var SUPPORTED_CHILD_TOKENS2 = /* @__PURE__ */ new Set([
   ...SINGLE_CHILD_TOKENS,
   ...MULTI_CHILD_TOKENS
 ]);
@@ -4705,7 +4886,7 @@ var KicadSch = class _KicadSch extends SxClass {
   _sxPaper;
   _sxTitleBlock;
   _sxLibSymbols;
-  _sxSheetInstances;
+  _sheetInstances = [];
   _sxEmbeddedFonts;
   _properties = [];
   _images = [];
@@ -4790,14 +4971,14 @@ var KicadSch = class _KicadSch extends SxClass {
     }
     const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(primitiveSexprs, this.token);
     for (const token of Object.keys(propertyMap)) {
-      if (!SUPPORTED_CHILD_TOKENS.has(token)) {
+      if (!SUPPORTED_CHILD_TOKENS2.has(token)) {
         throw new Error(
           `kicad_sch encountered unsupported child token "${token}"`
         );
       }
     }
     for (const [token, entries] of Object.entries(arrayPropertyMap)) {
-      if (!SUPPORTED_CHILD_TOKENS.has(token)) {
+      if (!SUPPORTED_CHILD_TOKENS2.has(token)) {
         throw new Error(
           `kicad_sch encountered unsupported child token "${token}"`
         );
@@ -4816,7 +4997,7 @@ var KicadSch = class _KicadSch extends SxClass {
       paper: propertyMap.paper,
       titleBlock: propertyMap.title_block,
       libSymbols: propertyMap.lib_symbols,
-      sheetInstances: propertyMap.sheet_instances,
+      sheetInstances: arrayPropertyMap.sheet_instances,
       embeddedFonts: propertyMap.embedded_fonts,
       properties: arrayPropertyMap.property ?? [],
       images: arrayPropertyMap.image ?? [],
@@ -4875,10 +5056,14 @@ var KicadSch = class _KicadSch extends SxClass {
     this._sxLibSymbols = value;
   }
   get sheetInstances() {
-    return this._sxSheetInstances;
+    return [...this._sheetInstances];
   }
   set sheetInstances(value) {
-    this._sxSheetInstances = value;
+    if (value === void 0) {
+      this._sheetInstances = [];
+      return;
+    }
+    this._sheetInstances = Array.isArray(value) ? [...value] : [value];
   }
   get embeddedFonts() {
     return this._sxEmbeddedFonts;
@@ -4943,7 +5128,7 @@ var KicadSch = class _KicadSch extends SxClass {
     if (this._sxPaper) children.push(this._sxPaper);
     if (this._sxTitleBlock) children.push(this._sxTitleBlock);
     if (this._sxLibSymbols) children.push(this._sxLibSymbols);
-    if (this._sxSheetInstances) children.push(this._sxSheetInstances);
+    children.push(...this._sheetInstances);
     if (this._sxEmbeddedFonts) children.push(this._sxEmbeddedFonts);
     children.push(...this._properties);
     children.push(...this._images);
@@ -11059,130 +11244,6 @@ var Layers = class _Layers extends SxClass {
 };
 SxClass.register(Layers);
 
-// lib/sexpr/classes/SheetInstancesRoot.ts
-var SUPPORTED_ARRAY_TOKENS2 = /* @__PURE__ */ new Set(["page"]);
-var SheetInstancesRoot = class _SheetInstancesRoot extends SxClass {
-  static token = "sheet_instances";
-  token = "sheet_instances";
-  _paths = [];
-  static fromSexprPrimitives(primitiveSexprs) {
-    const sheetInstances = new _SheetInstancesRoot();
-    const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(primitiveSexprs, this.token);
-    const unsupportedSingularTokens = Object.keys(propertyMap).filter(
-      (token) => token !== "path"
-    );
-    if (unsupportedSingularTokens.length > 0) {
-      throw new Error(
-        `Unsupported singular child tokens inside sheet_instances expression: ${unsupportedSingularTokens.join(", ")}`
-      );
-    }
-    const unsupportedArrayTokens = Object.keys(arrayPropertyMap).filter(
-      (token) => token !== "path"
-    );
-    if (unsupportedArrayTokens.length > 0) {
-      throw new Error(
-        `Unsupported repeated child tokens inside sheet_instances expression: ${unsupportedArrayTokens.join(", ")}`
-      );
-    }
-    const paths = arrayPropertyMap.path ?? [];
-    if (!paths.length && propertyMap.path) {
-      paths.push(propertyMap.path);
-    }
-    sheetInstances._paths = paths;
-    return sheetInstances;
-  }
-  get paths() {
-    return [...this._paths];
-  }
-  set paths(value) {
-    this._paths = [...value];
-  }
-  getChildren() {
-    return [...this._paths];
-  }
-};
-SxClass.register(SheetInstancesRoot);
-var SheetInstancesRootPath = class _SheetInstancesRootPath extends SxClass {
-  static token = "path";
-  static parentToken = "sheet_instances";
-  token = "path";
-  _value = "";
-  _pages = [];
-  static fromSexprPrimitives(primitiveSexprs) {
-    const [valuePrimitive, ...rest] = primitiveSexprs;
-    const value = toStringValue(valuePrimitive);
-    if (value === void 0) {
-      throw new Error("sheet_instances path requires a string identifier");
-    }
-    const path = new _SheetInstancesRootPath();
-    path._value = value;
-    const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(rest, "sheet_instances_path");
-    const unsupportedSingularTokens = Object.keys(propertyMap).filter(
-      (token) => !SUPPORTED_ARRAY_TOKENS2.has(token)
-    );
-    if (unsupportedSingularTokens.length > 0) {
-      throw new Error(
-        `Unsupported singular child tokens inside sheet_instances path expression: ${unsupportedSingularTokens.join(", ")}`
-      );
-    }
-    const unsupportedArrayTokens = Object.keys(arrayPropertyMap).filter(
-      (token) => !SUPPORTED_ARRAY_TOKENS2.has(token)
-    );
-    if (unsupportedArrayTokens.length > 0) {
-      throw new Error(
-        `Unsupported repeated child tokens inside sheet_instances path expression: ${unsupportedArrayTokens.join(", ")}`
-      );
-    }
-    const pages = arrayPropertyMap.page ?? [];
-    if (!pages.length && propertyMap.page) {
-      pages.push(propertyMap.page);
-    }
-    path._pages = pages;
-    return path;
-  }
-  get value() {
-    return this._value;
-  }
-  set value(newValue) {
-    this._value = newValue;
-  }
-  get pages() {
-    return [...this._pages];
-  }
-  set pages(value) {
-    this._pages = [...value];
-  }
-  getChildren() {
-    return [...this._pages];
-  }
-  getString() {
-    const lines = [`(path ${quoteSExprString(this._value)}`];
-    for (const page of this._pages) {
-      lines.push(page.getStringIndented());
-    }
-    lines.push(")");
-    return lines.join("\n");
-  }
-};
-SxClass.register(SheetInstancesRootPath);
-var SheetInstancesRootPage = class _SheetInstancesRootPage extends SxPrimitiveString {
-  static token = "page";
-  static parentToken = "sheet_instances_path";
-  token = "page";
-  static fromSexprPrimitives(primitiveSexprs) {
-    const [valuePrimitive] = primitiveSexprs;
-    const value = toStringValue(valuePrimitive);
-    if (value === void 0) {
-      throw new Error("sheet_instances page expects a string value");
-    }
-    return new _SheetInstancesRootPage(value);
-  }
-  getString() {
-    return `(page ${quoteSExprString(this.value)})`;
-  }
-};
-SxClass.register(SheetInstancesRootPage);
-
 // lib/sexpr/classes/Setup/base.ts
 var SingleValueProperty = class extends SxClass {
   _value;
@@ -14168,6 +14229,7 @@ export {
   SheetInstancePage,
   SheetInstancePath,
   SheetInstances,
+  SheetInstancesForSheet,
   SheetInstancesProject,
   SheetInstancesRoot,
   SheetInstancesRootPage,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kicadts",
   "main": "dist/index.js",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "type": "module",
   "repository": {
     "type": "git",