kicadts 0.0.9 → 0.0.11

package/README.md

@@ -183,36 +183,26 @@ await fs.writeFile("Demo_TestPad.kicad_mod", footprint.getString())
 
 ## Load Existing KiCad Files
 
-Parsing works for schematics, boards, footprints, or any KiCad S-expression. `parseKicadSexpr` returns an array of `SxClass` instances; narrow to the concrete class with `instanceof` and mutate as needed.
+Use the specialized parse functions to load and validate schematics, boards, or footprints. Each function ensures the root element is the expected type.
 
 ```ts
 import { promises as fs } from "node:fs"
-import { KicadPcb, KicadSch, Footprint, parseKicadSexpr } from "kicadts"
+import { parseKicadSch, parseKicadPcb, parseKicadMod } from "kicadts"
 
-const load = async (path: string) => {
-  const raw = await fs.readFile(path, "utf8")
-  const [root] = parseKicadSexpr(raw)
+// Load and modify a schematic
+const schematic = parseKicadSch(await fs.readFile("existing.kicad_sch", "utf8"))
+schematic.generator = "kicadts"
+await fs.writeFile("existing.kicad_sch", schematic.getString())
 
-  if (root instanceof KicadSch) {
-    root.generator = "kicadts"
-    return root
-  }
+// Load and modify a PCB
+const pcb = parseKicadPcb(await fs.readFile("existing.kicad_pcb", "utf8"))
+pcb.generatorVersion = "(generated programmatically)"
+await fs.writeFile("existing.kicad_pcb", pcb.getString())
 
-  if (root instanceof KicadPcb) {
-    root.generatorVersion = "(generated programmatically)"
-    return root
-  }
-
-  if (root instanceof Footprint) {
-    root.descr = "Imported with kicadts"
-    return root
-  }
-
-  throw new Error(`Unsupported root token: ${root.token}`)
-}
-
-const updated = await load("existing.kicad_sch")
-await fs.writeFile("existing.kicad_sch", updated.getString())
+// Load and modify a footprint
+const footprint = parseKicadMod(await fs.readFile("Demo_TestPad.kicad_mod", "utf8"))
+footprint.descr = "Imported with kicadts"
+await fs.writeFile("Demo_TestPad.kicad_mod", footprint.getString())
 ```
 
-Any class exposes `getChildren()` if you need to walk the tree manually, and snapshot tests (`bun test`) ensure the emitted S-expression stays identical to KiCad’s own formatting.
+For generic S-expression parsing, use `parseKicadSexpr` which returns an array of `SxClass` instances. Any class exposes `getChildren()` if you need to walk the tree manually, and snapshot tests (`bun test`) ensure the emitted S-expression stays identical to KiCad's own formatting.

package/dist/index.d.ts

@@ -1195,38 +1195,6 @@ declare class Label extends SxClass {
     getString(): string;
 }
 
-interface SchematicTextConstructorParams {
-    value?: string;
-    excludeFromSim?: boolean | ExcludeFromSim;
-    at?: AtInput;
-    effects?: TextEffects;
-    uuid?: string | Uuid;
-}
-declare class SchematicText extends SxClass {
-    static token: string;
-    static parentToken: string;
-    token: string;
-    private _value;
-    private _sxExcludeFromSim?;
-    private _sxAt?;
-    private _sxEffects?;
-    private _sxUuid?;
-    constructor(params?: SchematicTextConstructorParams);
-    static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): SchematicText;
-    get value(): string;
-    set value(newValue: string);
-    get excludeFromSim(): boolean;
-    set excludeFromSim(value: boolean);
-    get at(): At | undefined;
-    set at(value: AtInput | undefined);
-    get effects(): TextEffects | undefined;
-    set effects(value: TextEffects | undefined);
-    get uuid(): Uuid | undefined;
-    set uuid(value: Uuid | string | undefined);
-    getChildren(): SxClass[];
-    getString(): string;
-}
-
 declare class PropertyHide extends SxPrimitiveBoolean {
     static token: string;
     static parentToken: string;
@@ -1283,6 +1251,79 @@ declare class Property extends SxClass {
     getString(): string;
 }
 
+type GlobalLabelShape = "input" | "output" | "bidirectional" | "tri_state" | "passive";
+interface GlobalLabelConstructorParams {
+    value?: string;
+    shape?: GlobalLabelShape;
+    at?: AtInput;
+    effects?: TextEffects;
+    uuid?: string | Uuid;
+    fieldsAutoplaced?: boolean | FieldsAutoplaced;
+    properties?: Property[];
+}
+declare class GlobalLabel extends SxClass {
+    static token: string;
+    static parentToken: string;
+    token: string;
+    private _value;
+    private _shape;
+    private _sxAt?;
+    private _sxEffects?;
+    private _sxUuid?;
+    private _sxFieldsAutoplaced?;
+    private _properties;
+    constructor(params?: GlobalLabelConstructorParams);
+    static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): GlobalLabel;
+    get value(): string;
+    set value(newValue: string);
+    get shape(): GlobalLabelShape;
+    set shape(value: GlobalLabelShape);
+    get at(): At | undefined;
+    set at(value: AtInput | undefined);
+    get effects(): TextEffects | undefined;
+    set effects(value: TextEffects | undefined);
+    get uuid(): Uuid | undefined;
+    set uuid(value: Uuid | string | undefined);
+    get fieldsAutoplaced(): boolean;
+    set fieldsAutoplaced(value: boolean);
+    get properties(): Property[];
+    set properties(value: Property[]);
+    getChildren(): SxClass[];
+    getString(): string;
+}
+
+interface SchematicTextConstructorParams {
+    value?: string;
+    excludeFromSim?: boolean | ExcludeFromSim;
+    at?: AtInput;
+    effects?: TextEffects;
+    uuid?: string | Uuid;
+}
+declare class SchematicText extends SxClass {
+    static token: string;
+    static parentToken: string;
+    token: string;
+    private _value;
+    private _sxExcludeFromSim?;
+    private _sxAt?;
+    private _sxEffects?;
+    private _sxUuid?;
+    constructor(params?: SchematicTextConstructorParams);
+    static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): SchematicText;
+    get value(): string;
+    set value(newValue: string);
+    get excludeFromSim(): boolean;
+    set excludeFromSim(value: boolean);
+    get at(): At | undefined;
+    set at(value: AtInput | undefined);
+    get effects(): TextEffects | undefined;
+    set effects(value: TextEffects | undefined);
+    get uuid(): Uuid | undefined;
+    set uuid(value: Uuid | string | undefined);
+    getChildren(): SxClass[];
+    getString(): string;
+}
+
 declare class SheetInstancesRoot extends SxClass {
     static token: string;
     token: string;
@@ -1528,6 +1569,7 @@ interface KicadSchConstructorParams {
     symbols?: SchematicSymbol[];
     texts?: SchematicText[];
     labels?: Label[];
+    globalLabels?: GlobalLabel[];
     wires?: Wire[];
     junctions?: Junction[];
 }
@@ -1549,6 +1591,7 @@ declare class KicadSch extends SxClass {
     private _symbols;
     private _texts;
     private _labels;
+    private _globalLabels;
     private _wires;
     private _junctions;
     constructor(params?: KicadSchConstructorParams);
@@ -1583,6 +1626,8 @@ declare class KicadSch extends SxClass {
     set texts(value: SchematicText[]);
     get labels(): Label[];
     set labels(value: Label[]);
+    get globalLabels(): GlobalLabel[];
+    set globalLabels(value: GlobalLabel[]);
     get junctions(): Junction[];
     set junctions(value: Junction[]);
     get wires(): Wire[];
@@ -4473,5 +4518,8 @@ declare class KicadPcb extends SxClass {
 }
 
 declare const parseKicadSexpr: (sexpr: string) => SxClass[];
+declare const parseKicadSch: (sexpr: string) => KicadSch;
+declare const parseKicadPcb: (sexpr: string) => KicadPcb;
+declare const parseKicadMod: (sexpr: string) => Footprint;
 
-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 };
+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, GlobalLabel, type GlobalLabelConstructorParams, type GlobalLabelShape, 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, parseKicadMod, parseKicadPcb, parseKicadSch, parseKicadSexpr };

package/dist/index.js

@@ -3776,121 +3776,6 @@ var Label = class _Label extends SxClass {
 };
 SxClass.register(Label);
 
-// lib/sexpr/classes/SchematicText.ts
-var SUPPORTED_TOKENS6 = /* @__PURE__ */ new Set(["exclude_from_sim", "at", "effects", "uuid"]);
-var SchematicText = class _SchematicText extends SxClass {
-  static token = "text";
-  static parentToken = "kicad_sch";
-  token = "text";
-  _value = "";
-  _sxExcludeFromSim;
-  _sxAt;
-  _sxEffects;
-  _sxUuid;
-  constructor(params = {}) {
-    super();
-    if (params.value !== void 0) {
-      this.value = params.value;
-    }
-    if (params.excludeFromSim !== void 0) {
-      this.excludeFromSim = typeof params.excludeFromSim === "boolean" ? params.excludeFromSim : params.excludeFromSim.value;
-    }
-    if (params.at !== void 0) {
-      this.at = params.at;
-    }
-    if (params.effects !== void 0) {
-      this.effects = params.effects;
-    }
-    if (params.uuid !== void 0) {
-      this.uuid = params.uuid;
-    }
-  }
-  static fromSexprPrimitives(primitiveSexprs) {
-    const [textPrimitive, ...rest] = primitiveSexprs;
-    const value = toStringValue(textPrimitive);
-    if (value === void 0) {
-      throw new Error("text expects a string value");
-    }
-    const text = new _SchematicText();
-    text._value = value;
-    const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(rest, this.token);
-    const unsupportedTokens = Object.keys(propertyMap).filter(
-      (token) => !SUPPORTED_TOKENS6.has(token)
-    );
-    if (unsupportedTokens.length > 0) {
-      throw new Error(
-        `Unsupported child tokens inside text expression: ${unsupportedTokens.join(", ")}`
-      );
-    }
-    for (const [token, entries] of Object.entries(arrayPropertyMap)) {
-      if (!SUPPORTED_TOKENS6.has(token)) {
-        throw new Error(
-          `Unsupported child tokens inside text expression: ${token}`
-        );
-      }
-      if (entries.length > 1) {
-        throw new Error(`text does not support repeated child tokens: ${token}`);
-      }
-    }
-    text._sxExcludeFromSim = arrayPropertyMap.exclude_from_sim?.[0] ?? propertyMap.exclude_from_sim;
-    text._sxAt = arrayPropertyMap.at?.[0] ?? propertyMap.at;
-    text._sxEffects = arrayPropertyMap.effects?.[0] ?? propertyMap.effects;
-    text._sxUuid = arrayPropertyMap.uuid?.[0] ?? propertyMap.uuid;
-    return text;
-  }
-  get value() {
-    return this._value;
-  }
-  set value(newValue) {
-    this._value = newValue;
-  }
-  get excludeFromSim() {
-    return this._sxExcludeFromSim?.value ?? false;
-  }
-  set excludeFromSim(value) {
-    this._sxExcludeFromSim = value ? new ExcludeFromSim(true) : void 0;
-  }
-  get at() {
-    return this._sxAt;
-  }
-  set at(value) {
-    this._sxAt = value !== void 0 ? At.from(value) : void 0;
-  }
-  get effects() {
-    return this._sxEffects;
-  }
-  set effects(value) {
-    this._sxEffects = value;
-  }
-  get uuid() {
-    return this._sxUuid;
-  }
-  set uuid(value) {
-    if (value === void 0) {
-      this._sxUuid = void 0;
-      return;
-    }
-    this._sxUuid = value instanceof Uuid ? value : new Uuid(value);
-  }
-  getChildren() {
-    const children = [];
-    if (this._sxExcludeFromSim) children.push(this._sxExcludeFromSim);
-    if (this._sxAt) children.push(this._sxAt);
-    if (this._sxEffects) children.push(this._sxEffects);
-    if (this._sxUuid) children.push(this._sxUuid);
-    return children;
-  }
-  getString() {
-    const lines = [`(text ${quoteSExprString(this._value)}`];
-    for (const child of this.getChildren()) {
-      lines.push(child.getStringIndented());
-    }
-    lines.push(")");
-    return lines.join("\n");
-  }
-};
-SxClass.register(SchematicText);
-
 // lib/sexpr/classes/PropertyHide.ts
 var PropertyHide = class extends SxPrimitiveBoolean {
   static token = "hide";
@@ -4138,6 +4023,285 @@ var Property = class _Property extends SxClass {
 };
 SxClass.register(Property);
 
+// lib/sexpr/classes/GlobalLabel.ts
+var SUPPORTED_TOKENS6 = /* @__PURE__ */ new Set([
+  "shape",
+  "at",
+  "effects",
+  "uuid",
+  "fields_autoplaced",
+  "property"
+]);
+var GlobalLabel = class _GlobalLabel extends SxClass {
+  static token = "global_label";
+  static parentToken = "kicad_sch";
+  token = "global_label";
+  _value = "";
+  _shape = "input";
+  _sxAt;
+  _sxEffects;
+  _sxUuid;
+  _sxFieldsAutoplaced;
+  _properties = [];
+  constructor(params = {}) {
+    super();
+    if (params.value !== void 0) {
+      this.value = params.value;
+    }
+    if (params.shape !== void 0) {
+      this.shape = params.shape;
+    }
+    if (params.at !== void 0) {
+      this.at = params.at;
+    }
+    if (params.effects !== void 0) {
+      this.effects = params.effects;
+    }
+    if (params.uuid !== void 0) {
+      this.uuid = params.uuid;
+    }
+    if (params.fieldsAutoplaced !== void 0) {
+      if (params.fieldsAutoplaced instanceof FieldsAutoplaced) {
+        this._sxFieldsAutoplaced = params.fieldsAutoplaced;
+      } else {
+        this.fieldsAutoplaced = params.fieldsAutoplaced;
+      }
+    }
+    if (params.properties !== void 0) {
+      this.properties = params.properties;
+    }
+  }
+  static fromSexprPrimitives(primitiveSexprs) {
+    const [textPrimitive, ...rest] = primitiveSexprs;
+    const value = toStringValue(textPrimitive);
+    if (value === void 0) {
+      throw new Error("global_label expects a string value");
+    }
+    const globalLabel = new _GlobalLabel();
+    globalLabel._value = value;
+    let shapeIndex = -1;
+    for (let i = 0; i < rest.length; i++) {
+      const item = rest[i];
+      if (Array.isArray(item) && item[0] === "shape" && item.length === 2) {
+        shapeIndex = i;
+        const shapeValue = toStringValue(item[1]);
+        if (shapeValue) {
+          globalLabel._shape = shapeValue;
+        }
+        break;
+      }
+    }
+    const restWithoutShape = shapeIndex >= 0 ? rest.filter((_, i) => i !== shapeIndex) : rest;
+    const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(restWithoutShape, this.token);
+    const unsupportedTokens = Object.keys(propertyMap).filter(
+      (token) => !SUPPORTED_TOKENS6.has(token)
+    );
+    if (unsupportedTokens.length > 0) {
+      throw new Error(
+        `Unsupported child tokens inside global_label expression: ${unsupportedTokens.join(", ")}`
+      );
+    }
+    for (const [token, entries] of Object.entries(arrayPropertyMap)) {
+      if (!SUPPORTED_TOKENS6.has(token)) {
+        throw new Error(
+          `Unsupported child tokens inside global_label expression: ${token}`
+        );
+      }
+      if (token !== "property" && entries.length > 1) {
+        throw new Error(
+          `global_label does not support repeated child tokens: ${token}`
+        );
+      }
+    }
+    globalLabel._sxAt = arrayPropertyMap.at?.[0] ?? propertyMap.at;
+    globalLabel._sxEffects = arrayPropertyMap.effects?.[0] ?? propertyMap.effects;
+    globalLabel._sxUuid = arrayPropertyMap.uuid?.[0] ?? propertyMap.uuid;
+    globalLabel._sxFieldsAutoplaced = arrayPropertyMap.fields_autoplaced?.[0] ?? propertyMap.fields_autoplaced;
+    globalLabel._properties = arrayPropertyMap.property ?? [];
+    return globalLabel;
+  }
+  get value() {
+    return this._value;
+  }
+  set value(newValue) {
+    this._value = newValue;
+  }
+  get shape() {
+    return this._shape;
+  }
+  set shape(value) {
+    this._shape = value;
+  }
+  get at() {
+    return this._sxAt;
+  }
+  set at(value) {
+    this._sxAt = value !== void 0 ? At.from(value) : void 0;
+  }
+  get effects() {
+    return this._sxEffects;
+  }
+  set effects(value) {
+    this._sxEffects = value;
+  }
+  get uuid() {
+    return this._sxUuid;
+  }
+  set uuid(value) {
+    if (value === void 0) {
+      this._sxUuid = void 0;
+      return;
+    }
+    this._sxUuid = value instanceof Uuid ? value : new Uuid(value);
+  }
+  get fieldsAutoplaced() {
+    return this._sxFieldsAutoplaced?.value ?? false;
+  }
+  set fieldsAutoplaced(value) {
+    this._sxFieldsAutoplaced = new FieldsAutoplaced(value);
+  }
+  get properties() {
+    return [...this._properties];
+  }
+  set properties(value) {
+    this._properties = [...value];
+  }
+  getChildren() {
+    const children = [];
+    if (this._sxAt) children.push(this._sxAt);
+    if (this._sxEffects) children.push(this._sxEffects);
+    if (this._sxUuid) children.push(this._sxUuid);
+    children.push(...this._properties);
+    if (this._sxFieldsAutoplaced) children.push(this._sxFieldsAutoplaced);
+    return children;
+  }
+  getString() {
+    const lines = [`(global_label ${quoteSExprString(this._value)}`];
+    lines.push(`  (shape ${this._shape})`);
+    for (const child of this.getChildren()) {
+      lines.push(child.getStringIndented());
+    }
+    lines.push(")");
+    return lines.join("\n");
+  }
+};
+SxClass.register(GlobalLabel);
+
+// lib/sexpr/classes/SchematicText.ts
+var SUPPORTED_TOKENS7 = /* @__PURE__ */ new Set(["exclude_from_sim", "at", "effects", "uuid"]);
+var SchematicText = class _SchematicText extends SxClass {
+  static token = "text";
+  static parentToken = "kicad_sch";
+  token = "text";
+  _value = "";
+  _sxExcludeFromSim;
+  _sxAt;
+  _sxEffects;
+  _sxUuid;
+  constructor(params = {}) {
+    super();
+    if (params.value !== void 0) {
+      this.value = params.value;
+    }
+    if (params.excludeFromSim !== void 0) {
+      this.excludeFromSim = typeof params.excludeFromSim === "boolean" ? params.excludeFromSim : params.excludeFromSim.value;
+    }
+    if (params.at !== void 0) {
+      this.at = params.at;
+    }
+    if (params.effects !== void 0) {
+      this.effects = params.effects;
+    }
+    if (params.uuid !== void 0) {
+      this.uuid = params.uuid;
+    }
+  }
+  static fromSexprPrimitives(primitiveSexprs) {
+    const [textPrimitive, ...rest] = primitiveSexprs;
+    const value = toStringValue(textPrimitive);
+    if (value === void 0) {
+      throw new Error("text expects a string value");
+    }
+    const text = new _SchematicText();
+    text._value = value;
+    const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(rest, this.token);
+    const unsupportedTokens = Object.keys(propertyMap).filter(
+      (token) => !SUPPORTED_TOKENS7.has(token)
+    );
+    if (unsupportedTokens.length > 0) {
+      throw new Error(
+        `Unsupported child tokens inside text expression: ${unsupportedTokens.join(", ")}`
+      );
+    }
+    for (const [token, entries] of Object.entries(arrayPropertyMap)) {
+      if (!SUPPORTED_TOKENS7.has(token)) {
+        throw new Error(
+          `Unsupported child tokens inside text expression: ${token}`
+        );
+      }
+      if (entries.length > 1) {
+        throw new Error(`text does not support repeated child tokens: ${token}`);
+      }
+    }
+    text._sxExcludeFromSim = arrayPropertyMap.exclude_from_sim?.[0] ?? propertyMap.exclude_from_sim;
+    text._sxAt = arrayPropertyMap.at?.[0] ?? propertyMap.at;
+    text._sxEffects = arrayPropertyMap.effects?.[0] ?? propertyMap.effects;
+    text._sxUuid = arrayPropertyMap.uuid?.[0] ?? propertyMap.uuid;
+    return text;
+  }
+  get value() {
+    return this._value;
+  }
+  set value(newValue) {
+    this._value = newValue;
+  }
+  get excludeFromSim() {
+    return this._sxExcludeFromSim?.value ?? false;
+  }
+  set excludeFromSim(value) {
+    this._sxExcludeFromSim = value ? new ExcludeFromSim(true) : void 0;
+  }
+  get at() {
+    return this._sxAt;
+  }
+  set at(value) {
+    this._sxAt = value !== void 0 ? At.from(value) : void 0;
+  }
+  get effects() {
+    return this._sxEffects;
+  }
+  set effects(value) {
+    this._sxEffects = value;
+  }
+  get uuid() {
+    return this._sxUuid;
+  }
+  set uuid(value) {
+    if (value === void 0) {
+      this._sxUuid = void 0;
+      return;
+    }
+    this._sxUuid = value instanceof Uuid ? value : new Uuid(value);
+  }
+  getChildren() {
+    const children = [];
+    if (this._sxExcludeFromSim) children.push(this._sxExcludeFromSim);
+    if (this._sxAt) children.push(this._sxAt);
+    if (this._sxEffects) children.push(this._sxEffects);
+    if (this._sxUuid) children.push(this._sxUuid);
+    return children;
+  }
+  getString() {
+    const lines = [`(text ${quoteSExprString(this._value)}`];
+    for (const child of this.getChildren()) {
+      lines.push(child.getStringIndented());
+    }
+    lines.push(")");
+    return lines.join("\n");
+  }
+};
+SxClass.register(SchematicText);
+
 // lib/sexpr/classes/SheetInstancesRoot.ts
 var SUPPORTED_ARRAY_TOKENS2 = /* @__PURE__ */ new Set(["page"]);
 var SheetInstancesRoot = class _SheetInstancesRoot extends SxClass {
@@ -4873,6 +5037,7 @@ var MULTI_CHILD_TOKENS = /* @__PURE__ */ new Set([
   "symbol",
   "text",
   "label",
+  "global_label",
   "junction",
   "wire",
   "sheet_instances"
@@ -4899,6 +5064,7 @@ var KicadSch = class _KicadSch extends SxClass {
   _symbols = [];
   _texts = [];
   _labels = [];
+  _globalLabels = [];
   _wires = [];
   _junctions = [];
   constructor(params = {}) {
@@ -4954,6 +5120,9 @@ var KicadSch = class _KicadSch extends SxClass {
     if (params.labels !== void 0) {
       this.labels = params.labels;
     }
+    if (params.globalLabels !== void 0) {
+      this.globalLabels = params.globalLabels;
+    }
     if (params.wires !== void 0) {
       this.wires = params.wires;
     }
@@ -5010,6 +5179,7 @@ var KicadSch = class _KicadSch extends SxClass {
       symbols: arrayPropertyMap.symbol ?? [],
       texts: arrayPropertyMap.text ?? [],
       labels: arrayPropertyMap.label ?? [],
+      globalLabels: arrayPropertyMap.global_label ?? [],
       junctions: arrayPropertyMap.junction ?? [],
       wires: arrayPropertyMap.wire ?? []
     });
@@ -5112,6 +5282,12 @@ var KicadSch = class _KicadSch extends SxClass {
   set labels(value) {
     this._labels = [...value];
   }
+  get globalLabels() {
+    return [...this._globalLabels];
+  }
+  set globalLabels(value) {
+    this._globalLabels = [...value];
+  }
   get junctions() {
     return [...this._junctions];
   }
@@ -5141,6 +5317,7 @@ var KicadSch = class _KicadSch extends SxClass {
     children.push(...this._symbols);
     children.push(...this._texts);
     children.push(...this._labels);
+    children.push(...this._globalLabels);
     children.push(...this._junctions);
     children.push(...this._wires);
     return children;
@@ -6046,7 +6223,7 @@ var GrLineStart = class _GrLineStart extends SxClass {
 SxClass.register(GrLineStart);
 
 // lib/sexpr/classes/PadPrimitiveGrLine.ts
-var SUPPORTED_TOKENS7 = /* @__PURE__ */ new Set(["start", "end", "width"]);
+var SUPPORTED_TOKENS8 = /* @__PURE__ */ new Set(["start", "end", "width"]);
 var PadPrimitiveGrLine = class _PadPrimitiveGrLine extends SxClass {
   static token = "gr_line";
   static parentToken = "primitives";
@@ -6058,14 +6235,14 @@ var PadPrimitiveGrLine = class _PadPrimitiveGrLine extends SxClass {
     const line = new _PadPrimitiveGrLine();
     const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(primitiveSexprs, this.token);
     for (const token of Object.keys(propertyMap)) {
-      if (!SUPPORTED_TOKENS7.has(token)) {
+      if (!SUPPORTED_TOKENS8.has(token)) {
         throw new Error(
           `pad primitive gr_line encountered unsupported child token "${token}"`
         );
       }
     }
     for (const [token, entries] of Object.entries(arrayPropertyMap)) {
-      if (!SUPPORTED_TOKENS7.has(token)) {
+      if (!SUPPORTED_TOKENS8.has(token)) {
         throw new Error(
           `pad primitive gr_line encountered unsupported child token "${token}"`
         );
@@ -6147,7 +6324,7 @@ var PadPrimitiveGrLine = class _PadPrimitiveGrLine extends SxClass {
 SxClass.register(PadPrimitiveGrLine);
 
 // lib/sexpr/classes/PadPrimitiveGrArc.ts
-var SUPPORTED_TOKENS8 = /* @__PURE__ */ new Set(["start", "mid", "end", "width"]);
+var SUPPORTED_TOKENS9 = /* @__PURE__ */ new Set(["start", "mid", "end", "width"]);
 var PadPrimitiveGrArc = class _PadPrimitiveGrArc extends SxClass {
   static token = "gr_arc";
   static parentToken = "primitives";
@@ -6167,14 +6344,14 @@ var PadPrimitiveGrArc = class _PadPrimitiveGrArc extends SxClass {
     const arc = new _PadPrimitiveGrArc();
     const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(primitiveSexprs, this.token);
     for (const token of Object.keys(propertyMap)) {
-      if (!SUPPORTED_TOKENS8.has(token)) {
+      if (!SUPPORTED_TOKENS9.has(token)) {
         throw new Error(
           `pad primitive gr_arc encountered unsupported child token "${token}"`
         );
       }
     }
     for (const [token, entries] of Object.entries(arrayPropertyMap)) {
-      if (!SUPPORTED_TOKENS8.has(token)) {
+      if (!SUPPORTED_TOKENS9.has(token)) {
         throw new Error(
           `pad primitive gr_arc encountered unsupported child token "${token}"`
         );
@@ -6344,7 +6521,7 @@ var PadPrimitiveGrArcEnd = class _PadPrimitiveGrArcEnd extends PadPrimitiveGrArc
 SxClass.register(PadPrimitiveGrArcEnd);
 
 // lib/sexpr/classes/PadPrimitiveGrCircle.ts
-var SUPPORTED_TOKENS9 = /* @__PURE__ */ new Set(["center", "end", "width", "fill"]);
+var SUPPORTED_TOKENS10 = /* @__PURE__ */ new Set(["center", "end", "width", "fill"]);
 var PadPrimitiveGrCircle = class _PadPrimitiveGrCircle extends SxClass {
   static token = "gr_circle";
   static parentToken = "primitives";
@@ -6364,14 +6541,14 @@ var PadPrimitiveGrCircle = class _PadPrimitiveGrCircle extends SxClass {
     const circle = new _PadPrimitiveGrCircle();
     const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(primitiveSexprs, this.token);
     for (const token of Object.keys(propertyMap)) {
-      if (!SUPPORTED_TOKENS9.has(token)) {
+      if (!SUPPORTED_TOKENS10.has(token)) {
         throw new Error(
           `pad primitive gr_circle encountered unsupported child token "${token}"`
         );
       }
     }
     for (const [token, entries] of Object.entries(arrayPropertyMap)) {
-      if (!SUPPORTED_TOKENS9.has(token)) {
+      if (!SUPPORTED_TOKENS10.has(token)) {
         throw new Error(
           `pad primitive gr_circle encountered unsupported child token "${token}"`
         );
@@ -7139,7 +7316,7 @@ var SINGLE_TOKENS = /* @__PURE__ */ new Set([
   "teardrops"
 ]);
 var MULTI_TOKENS = /* @__PURE__ */ new Set(["property"]);
-var SUPPORTED_TOKENS10 = /* @__PURE__ */ new Set([...SINGLE_TOKENS, ...MULTI_TOKENS]);
+var SUPPORTED_TOKENS11 = /* @__PURE__ */ new Set([...SINGLE_TOKENS, ...MULTI_TOKENS]);
 var ensureSingle = (arrayPropertyMap, token) => {
   const entries = arrayPropertyMap[token];
   if (entries && entries.length > 1) {
@@ -7278,12 +7455,12 @@ var FootprintPad = class _FootprintPad extends SxClass {
     }
     const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(primitiveNodes, this.token);
     for (const token of Object.keys(propertyMap)) {
-      if (!SUPPORTED_TOKENS10.has(token)) {
+      if (!SUPPORTED_TOKENS11.has(token)) {
         throw new Error(`pad encountered unsupported child token "${token}"`);
       }
     }
     for (const [token, entries] of Object.entries(arrayPropertyMap)) {
-      if (!SUPPORTED_TOKENS10.has(token)) {
+      if (!SUPPORTED_TOKENS11.has(token)) {
         throw new Error(`pad encountered unsupported child token "${token}"`);
       }
       if (!MULTI_TOKENS.has(token) && entries.length > 1) {
@@ -9149,7 +9326,7 @@ var FpPolyLocked = class _FpPolyLocked extends SxPrimitiveBoolean {
 SxClass.register(FpPolyLocked);
 
 // lib/sexpr/classes/FpPoly.ts
-var SUPPORTED_TOKENS11 = /* @__PURE__ */ new Set([
+var SUPPORTED_TOKENS12 = /* @__PURE__ */ new Set([
   "pts",
   "xy",
   "layer",
@@ -9184,12 +9361,12 @@ var FpPoly = class _FpPoly extends SxClass {
     const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(primitiveSexprs, this.token);
     const unexpectedTokens = /* @__PURE__ */ new Set();
     for (const token of Object.keys(propertyMap)) {
-      if (!SUPPORTED_TOKENS11.has(token)) {
+      if (!SUPPORTED_TOKENS12.has(token)) {
         unexpectedTokens.add(token);
       }
     }
     for (const token of Object.keys(arrayPropertyMap)) {
-      if (!SUPPORTED_TOKENS11.has(token)) {
+      if (!SUPPORTED_TOKENS12.has(token)) {
         unexpectedTokens.add(token);
       }
       if (token !== "xy" && arrayPropertyMap[token].length > 1) {
@@ -9242,7 +9419,7 @@ var FpPoly = class _FpPoly extends SxClass {
           `fp_poly child token must be a string, received: ${JSON.stringify(token)}`
         );
       }
-      if (!SUPPORTED_TOKENS11.has(token)) {
+      if (!SUPPORTED_TOKENS12.has(token)) {
         throw new Error(
           `Unsupported child token inside fp_poly expression: ${token}`
         );
@@ -9867,7 +10044,7 @@ var MULTI_TOKENS2 = /* @__PURE__ */ new Set([
   "pad",
   "model"
 ]);
-var SUPPORTED_TOKENS12 = /* @__PURE__ */ new Set([...SINGLE_TOKENS2, ...MULTI_TOKENS2]);
+var SUPPORTED_TOKENS13 = /* @__PURE__ */ new Set([...SINGLE_TOKENS2, ...MULTI_TOKENS2]);
 var Footprint = class _Footprint extends SxClass {
   static token = "footprint";
   token = "footprint";
@@ -9977,14 +10154,14 @@ var Footprint = class _Footprint extends SxClass {
     }
     const { propertyMap, arrayPropertyMap } = SxClass.parsePrimitivesToClassProperties(rawNodes, this.token);
     for (const token of Object.keys(propertyMap)) {
-      if (!SUPPORTED_TOKENS12.has(token)) {
+      if (!SUPPORTED_TOKENS13.has(token)) {
         throw new Error(
           `footprint encountered unsupported child token "${token}"`
         );
       }
     }
     for (const [token, entries] of Object.entries(arrayPropertyMap)) {
-      if (!SUPPORTED_TOKENS12.has(token)) {
+      if (!SUPPORTED_TOKENS13.has(token)) {
         throw new Error(
           `footprint encountered unsupported child token "${token}"`
         );
@@ -14016,6 +14193,33 @@ SxClass.register(KicadPcb);
 var parseKicadSexpr = (sexpr) => {
   return SxClass.parse(sexpr);
 };
+var parseKicadSch = (sexpr) => {
+  const [root] = parseKicadSexpr(sexpr);
+  if (!(root instanceof KicadSch)) {
+    throw new Error(
+      `Expected KicadSch root, got ${root?.constructor.name ?? "undefined"}`
+    );
+  }
+  return root;
+};
+var parseKicadPcb = (sexpr) => {
+  const [root] = parseKicadSexpr(sexpr);
+  if (!(root instanceof KicadPcb)) {
+    throw new Error(
+      `Expected KicadPcb root, got ${root?.constructor.name ?? "undefined"}`
+    );
+  }
+  return root;
+};
+var parseKicadMod = (sexpr) => {
+  const [root] = parseKicadSexpr(sexpr);
+  if (!(root instanceof Footprint)) {
+    throw new Error(
+      `Expected Footprint root, got ${root?.constructor.name ?? "undefined"}`
+    );
+  }
+  return root;
+};
 export {
   At,
   Bus,
@@ -14072,6 +14276,7 @@ export {
   FpTextBoxAngle,
   FpTextBoxEnd,
   FpTextBoxStart,
+  GlobalLabel,
   GrLine,
   GrLineAngle,
   GrLineEnd,
@@ -14316,5 +14521,8 @@ export {
   Wire,
   Xy,
   Zone,
+  parseKicadMod,
+  parseKicadPcb,
+  parseKicadSch,
   parseKicadSexpr
 };

package/package.json

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