kicadts 0.0.13 → 0.0.14

package/dist/index.d.ts

@@ -1648,6 +1648,7 @@ declare class FootprintAttr extends SxClass {
     private _boardOnly;
     private _excludeFromPosFiles;
     private _excludeFromBom;
+    private _allowSoldermaskBridges;
     static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): FootprintAttr;
     private applyFlag;
     get type(): string | undefined;
@@ -1658,6 +1659,8 @@ declare class FootprintAttr extends SxClass {
     set excludeFromPosFiles(value: boolean);
     get excludeFromBom(): boolean;
     set excludeFromBom(value: boolean);
+    get allowSoldermaskBridges(): boolean;
+    set allowSoldermaskBridges(value: boolean);
     getChildren(): SxClass[];
     getString(): string;
 }
@@ -2137,12 +2140,16 @@ declare class PadPrimitiveGrCircleEnd extends PadPrimitiveGrCirclePoint {
     constructor(x: number, y: number);
     static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): PadPrimitiveGrCircleEnd;
 }
-declare class PadPrimitiveGrCircleFill extends SxPrimitiveBoolean {
+declare class PadPrimitiveGrCircleFill extends SxClass {
     static token: string;
     static parentToken: string;
     token: string;
-    constructor(value?: boolean);
+    value: string;
+    constructor(value?: boolean | string);
     static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): PadPrimitiveGrCircleFill;
+    get filled(): boolean;
+    set filled(value: boolean);
+    getString(): string;
 }
 
 type PadPrimitiveGraphic = PadPrimitiveGrPoly | PadPrimitiveGrLine | PadPrimitiveGrArc | PadPrimitiveGrCircle;
@@ -2870,11 +2877,12 @@ declare class FpArcEnd extends SxClass {
     getString(): string;
 }
 
-declare class FpPolyFill extends SxPrimitiveBoolean {
+declare class FpPolyFill extends SxClass {
     static token: string;
     static parentToken: string;
     token: string;
-    constructor(filled: boolean);
+    value: string;
+    constructor(value: string | boolean);
     static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): FpPolyFill;
     get filled(): boolean;
     set filled(filled: boolean);
@@ -3047,6 +3055,7 @@ declare class FootprintModel extends SxClass {
     private _offset?;
     private _scale?;
     private _rotate?;
+    private _hide;
     constructor(path: string);
     static fromSexprPrimitives(primitiveSexprs: PrimitiveSExpr[]): FootprintModel;
     get path(): string;
@@ -3057,6 +3066,8 @@ declare class FootprintModel extends SxClass {
     set scale(value: ModelVector | undefined);
     get rotate(): ModelVector | undefined;
     set rotate(value: ModelVector | undefined);
+    get hide(): boolean;
+    set hide(value: boolean);
     getChildren(): SxClass[];
     getString(): string;
 }
@@ -3523,6 +3534,7 @@ interface GrTextConstructorParams {
     text?: string;
     position?: AtInput | Xy | GrTextPosition;
     layer?: Layer | string | Array<string | number>;
+    tstamp?: Tstamp | string;
     uuid?: Uuid | string;
     effects?: TextEffects;
 }
@@ -3532,6 +3544,7 @@ declare class GrText extends SxClass {
     private _text;
     private _sxPosition?;
     private _sxLayer?;
+    private _sxTstamp?;
     private _sxUuid?;
     private _sxEffects?;
     constructor(params?: GrTextConstructorParams | string);
@@ -3542,6 +3555,8 @@ declare class GrText extends SxClass {
     set position(value: AtInput | Xy | GrTextPosition | undefined);
     get layer(): Layer | undefined;
     set layer(value: Layer | string | Array<string | number> | undefined);
+    get tstamp(): Tstamp | undefined;
+    set tstamp(value: Tstamp | string | undefined);
     get uuid(): Uuid | undefined;
     set uuid(value: Uuid | string | undefined);
     get effects(): TextEffects | undefined;

package/dist/index.js

@@ -578,6 +578,18 @@ var At = class _At extends SxClass {
 };
 SxClass.register(At);
 
+// lib/sexpr/utils/quoteSExprString.ts
+var needsQuoting = (value) => {
+  if (value.length === 0) return true;
+  return /[\s()"\\]/.test(value);
+};
+var quoteSExprString = (value) => {
+  return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t")}"`;
+};
+var quoteIfNeeded = (value) => {
+  return needsQuoting(value) ? quoteSExprString(value) : value;
+};
+
 // lib/sexpr/base-classes/SxPrimitiveString.ts
 var SxPrimitiveString = class extends SxClass {
   value;
@@ -592,15 +604,10 @@ var SxPrimitiveString = class extends SxClass {
     return new this(primitiveSexprs[0]);
   }
   getString() {
-    return `(${this.token} ${this.value})`;
+    return `(${this.token} ${quoteIfNeeded(this.value)})`;
   }
 };
 
-// lib/sexpr/utils/quoteSExprString.ts
-var quoteSExprString = (value) => {
-  return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t")}"`;
-};
-
 // lib/sexpr/utils/toStringValue.ts
 var toStringValue = (value) => {
   if (value === void 0) return void 0;
@@ -5336,7 +5343,8 @@ SxClass.register(KicadSch);
 var FLAG_TOKENS = /* @__PURE__ */ new Set([
   "board_only",
   "exclude_from_pos_files",
-  "exclude_from_bom"
+  "exclude_from_bom",
+  "allow_soldermask_bridges"
 ]);
 var FootprintAttr = class _FootprintAttr extends SxClass {
   static token = "attr";
@@ -5346,6 +5354,7 @@ var FootprintAttr = class _FootprintAttr extends SxClass {
   _boardOnly = false;
   _excludeFromPosFiles = false;
   _excludeFromBom = false;
+  _allowSoldermaskBridges = false;
   static fromSexprPrimitives(primitiveSexprs) {
     const attr = new _FootprintAttr();
     for (const primitive of primitiveSexprs) {
@@ -5379,6 +5388,9 @@ var FootprintAttr = class _FootprintAttr extends SxClass {
       case "exclude_from_bom":
         this._excludeFromBom = true;
         break;
+      case "allow_soldermask_bridges":
+        this._allowSoldermaskBridges = true;
+        break;
     }
   }
   get type() {
@@ -5405,6 +5417,12 @@ var FootprintAttr = class _FootprintAttr extends SxClass {
   set excludeFromBom(value) {
     this._excludeFromBom = value;
   }
+  get allowSoldermaskBridges() {
+    return this._allowSoldermaskBridges;
+  }
+  set allowSoldermaskBridges(value) {
+    this._allowSoldermaskBridges = value;
+  }
   getChildren() {
     return [];
   }
@@ -5414,6 +5432,7 @@ var FootprintAttr = class _FootprintAttr extends SxClass {
     if (this._boardOnly) tokens.push("board_only");
     if (this._excludeFromPosFiles) tokens.push("exclude_from_pos_files");
     if (this._excludeFromBom) tokens.push("exclude_from_bom");
+    if (this._allowSoldermaskBridges) tokens.push("allow_soldermask_bridges");
     return `(${tokens.join(" ")})`;
   }
 };
@@ -6604,7 +6623,7 @@ var PadPrimitiveGrCircle = class _PadPrimitiveGrCircle extends SxClass {
     return this._sxWidth;
   }
   get fill() {
-    return this._sxFill?.value;
+    return this._sxFill?.filled;
   }
   set fill(value) {
     if (value === void 0) {
@@ -6711,34 +6730,50 @@ var PadPrimitiveGrCircleEnd = class _PadPrimitiveGrCircleEnd extends PadPrimitiv
   }
 };
 SxClass.register(PadPrimitiveGrCircleEnd);
-var PadPrimitiveGrCircleFill = class _PadPrimitiveGrCircleFill extends SxPrimitiveBoolean {
+var truthyFillStrings = /* @__PURE__ */ new Set(["yes", "true"]);
+var falsyFillStrings = /* @__PURE__ */ new Set(["no", "false", "none"]);
+var PadPrimitiveGrCircleFill = class _PadPrimitiveGrCircleFill extends SxClass {
   static token = "fill";
   static parentToken = "gr_circle";
   token = "fill";
+  value;
   constructor(value) {
-    super(value ?? false);
+    super();
+    if (value === void 0 || value === false) {
+      this.value = "no";
+    } else if (value === true) {
+      this.value = "yes";
+    } else {
+      this.value = value;
+    }
   }
   static fromSexprPrimitives(primitiveSexprs) {
     const [raw] = primitiveSexprs;
     if (raw === void 0) {
-      return new _PadPrimitiveGrCircleFill(false);
+      return new _PadPrimitiveGrCircleFill("no");
     }
     if (typeof raw === "boolean") {
       return new _PadPrimitiveGrCircleFill(raw);
     }
     if (typeof raw === "string") {
       const normalized = raw.toLowerCase();
-      if (normalized === "yes" || normalized === "true") {
-        return new _PadPrimitiveGrCircleFill(true);
-      }
-      if (normalized === "no" || normalized === "false" || normalized === "none") {
-        return new _PadPrimitiveGrCircleFill(false);
+      if (truthyFillStrings.has(normalized) || falsyFillStrings.has(normalized)) {
+        return new _PadPrimitiveGrCircleFill(raw);
       }
     }
     throw new Error(
       `pad primitive gr_circle fill expects yes/no/none or boolean, received ${JSON.stringify(raw)}`
     );
   }
+  get filled() {
+    return truthyFillStrings.has(this.value.toLowerCase());
+  }
+  set filled(value) {
+    this.value = value ? "yes" : "no";
+  }
+  getString() {
+    return `(fill ${this.value})`;
+  }
 };
 SxClass.register(PadPrimitiveGrCircleFill);
 
@@ -9316,35 +9351,41 @@ var FpArcEnd = class _FpArcEnd extends SxClass {
 SxClass.register(FpArcEnd);
 
 // lib/sexpr/classes/FpPolyFill.ts
-var truthyStrings = /* @__PURE__ */ new Set(["yes", "true", "1"]);
-var FpPolyFill = class _FpPolyFill extends SxPrimitiveBoolean {
+var truthyStrings = /* @__PURE__ */ new Set(["yes", "true", "1", "solid"]);
+var FpPolyFill = class _FpPolyFill extends SxClass {
   static token = "fill";
   static parentToken = "fp_poly";
   token = "fill";
-  constructor(filled) {
-    super(filled);
+  value;
+  constructor(value) {
+    super();
+    if (typeof value === "boolean") {
+      this.value = value ? "yes" : "no";
+    } else {
+      this.value = value;
+    }
   }
   static fromSexprPrimitives(primitiveSexprs) {
     const [rawValue] = primitiveSexprs;
     if (rawValue === void 0) {
-      return new _FpPolyFill(false);
+      return new _FpPolyFill("no");
     }
     if (typeof rawValue === "boolean") {
       return new _FpPolyFill(rawValue);
     }
     if (typeof rawValue === "string") {
-      return new _FpPolyFill(truthyStrings.has(rawValue.toLowerCase()));
+      return new _FpPolyFill(rawValue);
     }
-    return new _FpPolyFill(false);
+    return new _FpPolyFill("no");
   }
   get filled() {
-    return this.value;
+    return truthyStrings.has(this.value.toLowerCase());
   }
   set filled(filled) {
-    this.value = filled;
+    this.value = filled ? "yes" : "no";
   }
   getString() {
-    return `(fill ${this.value ? "yes" : "no"})`;
+    return `(fill ${this.value})`;
   }
 };
 SxClass.register(FpPolyFill);
@@ -9938,6 +9979,7 @@ var FootprintModel = class _FootprintModel extends SxClass {
   _offset;
   _scale;
   _rotate;
+  _hide = false;
   constructor(path) {
     super();
     this._path = path;
@@ -9953,6 +9995,13 @@ var FootprintModel = class _FootprintModel extends SxClass {
     }
     const model = new _FootprintModel(path);
     for (const primitive of rest) {
+      if (typeof primitive === "string") {
+        if (primitive === "hide") {
+          model._hide = true;
+          continue;
+        }
+        throw new Error(`model encountered unsupported flag "${primitive}"`);
+      }
       if (!Array.isArray(primitive) || primitive.length === 0) {
         throw new Error(
           `model encountered invalid child expression: ${JSON.stringify(primitive)}`
@@ -9999,11 +10048,20 @@ var FootprintModel = class _FootprintModel extends SxClass {
   set rotate(value) {
     this._rotate = value ? { ...value } : void 0;
   }
+  get hide() {
+    return this._hide;
+  }
+  set hide(value) {
+    this._hide = value;
+  }
   getChildren() {
     return [];
   }
   getString() {
     const lines = [`(model ${quoteSExprString(this._path)}`];
+    if (this._hide) {
+      lines.push("  hide");
+    }
     if (this._offset) {
       lines.push(renderVectorBlock("offset", this._offset));
     }
@@ -11725,6 +11783,7 @@ var SUPPORTED_SINGLE_TOKENS8 = /* @__PURE__ */ new Set([
   "at",
   "xy",
   "layer",
+  "tstamp",
   "uuid",
   "effects"
 ]);
@@ -11734,6 +11793,7 @@ var GrText = class _GrText extends SxClass {
   _text = "";
   _sxPosition;
   _sxLayer;
+  _sxTstamp;
   _sxUuid;
   _sxEffects;
   constructor(params = {}) {
@@ -11744,6 +11804,7 @@ var GrText = class _GrText extends SxClass {
       if (params.text !== void 0) this.text = params.text;
       if (params.position !== void 0) this.position = params.position;
       if (params.layer !== void 0) this.layer = params.layer;
+      if (params.tstamp !== void 0) this.tstamp = params.tstamp;
       if (params.uuid !== void 0) this.uuid = params.uuid;
       if (params.effects !== void 0) this.effects = params.effects;
     }
@@ -11794,6 +11855,7 @@ var GrText = class _GrText extends SxClass {
     }
     grText._sxPosition = atInstance ?? xyInstance;
     grText._sxLayer = propertyMap.layer;
+    grText._sxTstamp = propertyMap.tstamp;
     grText._sxUuid = propertyMap.uuid;
     grText._sxEffects = propertyMap.effects;
     if (!grText._sxPosition) {
@@ -11802,8 +11864,8 @@ var GrText = class _GrText extends SxClass {
     if (!grText._sxLayer) {
       throw new Error("gr_text requires a layer child token");
     }
-    if (!grText._sxUuid) {
-      throw new Error("gr_text requires a uuid child token");
+    if (!grText._sxUuid && !grText._sxTstamp) {
+      throw new Error("gr_text requires a uuid or tstamp child token");
     }
     if (!grText._sxEffects) {
       throw new Error("gr_text requires an effects child token");
@@ -11854,6 +11916,16 @@ var GrText = class _GrText extends SxClass {
     const names = Array.isArray(value) ? value : [value];
     this._sxLayer = new Layer(names);
   }
+  get tstamp() {
+    return this._sxTstamp;
+  }
+  set tstamp(value) {
+    if (value === void 0) {
+      this._sxTstamp = void 0;
+      return;
+    }
+    this._sxTstamp = value instanceof Tstamp ? value : new Tstamp(value);
+  }
   get uuid() {
     return this._sxUuid;
   }
@@ -11874,6 +11946,7 @@ var GrText = class _GrText extends SxClass {
     const children = [];
     if (this._sxPosition) children.push(this._sxPosition);
     if (this._sxLayer) children.push(this._sxLayer);
+    if (this._sxTstamp) children.push(this._sxTstamp);
     if (this._sxUuid) children.push(this._sxUuid);
     if (this._sxEffects) children.push(this._sxEffects);
     return children;
@@ -14777,10 +14850,10 @@ var Via = class _Via extends SxClass {
     if (this._type !== void 0) {
       lines.push(`  (type ${this._type})`);
     }
-    if (this._locked) lines.push("  locked");
-    if (this._free) lines.push("  free");
-    if (this._removeUnusedLayers) lines.push("  remove_unused_layers");
-    if (this._keepEndLayers) lines.push("  keep_end_layers");
+    if (this._locked) lines.push("  (locked)");
+    if (this._free) lines.push("  (free)");
+    if (this._removeUnusedLayers) lines.push("  (remove_unused_layers)");
+    if (this._keepEndLayers) lines.push("  (keep_end_layers)");
     if (this._sxAt) lines.push(this._sxAt.getStringIndented());
     if (this._size !== void 0) lines.push(`  (size ${this._size})`);
     if (this._drill !== void 0) lines.push(`  (drill ${this._drill})`);

package/package.json

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