lbrnts 0.0.20 → 0.0.22

package/README.md

@@ -20,6 +20,32 @@ const project = LightBurnProject.parse(fs.readFileSync("project.lbrn2", "utf8"))
 console.log(project.children)
 ```
 
+### Offsetting Project Content
+
+```tsx
+import {
+  applyOffsetToLbrn,
+  LightBurnBaseElement,
+  LightBurnProject,
+} from "lbrnts"
+
+const source = fs.readFileSync("project.lbrn2", "utf8")
+const project = LightBurnBaseElement.parse(source)
+
+if (project instanceof LightBurnProject) {
+  applyOffsetToLbrn({
+    lbrnProject: project,
+    xOffset: 10,
+    yOffset: -5,
+  })
+
+  const shifted = project.getString()
+}
+```
+
+This mutates the parsed project by offsetting top-level shape transforms. Call
+`getString()` when you need LightBurn XML output.
+
 ### Creating Projects from Scratch
 
 You can programmatically create LightBurn projects by constructing the project and its elements. Below is a table of all constructible classes with links to their documentation:
@@ -132,6 +158,8 @@ new CutSetting(init?: {
   angle?: number              // Scan angle
   overScanning?: number       // Over-scanning distance
   lineAngle?: number          // Line angle for fill
+  wobbleEnable?: boolean      // Enable wobble for scan fills
+  anglePerPass?: number       // Hatch angle increment per pass
 })
 ```
 

package/dist/index.d.ts

@@ -92,6 +92,8 @@ interface CutSettingInit {
     overScanning?: number;
     lineAngle?: number;
     crossHatch?: boolean;
+    wobbleEnable?: boolean;
+    anglePerPass?: number;
     frequency?: number;
     qPulseWidth?: number;
 }
@@ -119,6 +121,8 @@ declare class CutSetting extends LightBurnBaseElement {
     private _overScanning?;
     private _lineAngle?;
     private _crossHatch?;
+    private _wobbleEnable?;
+    private _anglePerPass?;
     private _frequency?;
     private _qPulseWidth?;
     constructor(init?: CutSettingInit);
@@ -168,6 +172,10 @@ declare class CutSetting extends LightBurnBaseElement {
     set lineAngle(value: number | undefined);
     get crossHatch(): boolean | undefined;
     set crossHatch(value: boolean | undefined);
+    get wobbleEnable(): boolean | undefined;
+    set wobbleEnable(value: boolean | undefined);
+    get anglePerPass(): number | undefined;
+    set anglePerPass(value: number | undefined);
     get frequency(): number | undefined;
     set frequency(value: number | undefined);
     get qPulseWidth(): number | undefined;
@@ -382,6 +390,13 @@ interface SplitLightBurnProjectFile {
 }
 declare function splitLightBurnProjectByCutSetting(input: string | LightBurnProject, originalFileName?: string): SplitLightBurnProjectFile[];
 
+interface ApplyOffsetToLbrnParams {
+    lbrnProject: LightBurnProject;
+    xOffset: number;
+    yOffset: number;
+}
+declare function applyOffsetToLbrn(params: ApplyOffsetToLbrnParams): LightBurnProject;
+
 declare const parseXml: (xml: string) => XmlJson;
 
-export { LightBurnBaseElement as BaseLightBurnElement, CutSetting, type CutSettingInit, type GenerateSvgOptions, LightBurnBaseElement, LightBurnProject, type LightBurnProjectInit, type Mat, Notes, type Prim, ShapeBase, ShapeBitmap, ShapeEllipse, ShapeGroup, ShapePath, type ShapePathInit, ShapeRect, ShapeText, type SplitLightBurnProjectFile, Thumbnail, UIPrefs, VariableText, type Vert, generateLightBurnSvg, parseXml, splitLightBurnProjectByCutSetting };
+export { type ApplyOffsetToLbrnParams, LightBurnBaseElement as BaseLightBurnElement, CutSetting, type CutSettingInit, type GenerateSvgOptions, LightBurnBaseElement, LightBurnProject, type LightBurnProjectInit, type Mat, Notes, type Prim, ShapeBase, ShapeBitmap, ShapeEllipse, ShapeGroup, ShapePath, type ShapePathInit, ShapeRect, ShapeText, type SplitLightBurnProjectFile, Thumbnail, UIPrefs, VariableText, type Vert, applyOffsetToLbrn, generateLightBurnSvg, parseXml, splitLightBurnProjectByCutSetting };

package/dist/index.js

@@ -294,6 +294,8 @@ var CutSetting = class _CutSetting extends LightBurnBaseElement {
   _overScanning;
   _lineAngle;
   _crossHatch;
+  _wobbleEnable;
+  _anglePerPass;
   _frequency;
   _qPulseWidth;
   constructor(init) {
@@ -325,6 +327,10 @@ var CutSetting = class _CutSetting extends LightBurnBaseElement {
         this._overScanning = init.overScanning;
       if (init.lineAngle !== void 0) this._lineAngle = init.lineAngle;
       if (init.crossHatch !== void 0) this._crossHatch = init.crossHatch;
+      if (init.wobbleEnable !== void 0)
+        this._wobbleEnable = init.wobbleEnable;
+      if (init.anglePerPass !== void 0)
+        this._anglePerPass = init.anglePerPass;
       if (init.frequency !== void 0) this._frequency = init.frequency;
       if (init.qPulseWidth !== void 0) this._qPulseWidth = init.qPulseWidth;
     }
@@ -467,6 +473,18 @@ var CutSetting = class _CutSetting extends LightBurnBaseElement {
   set crossHatch(value) {
     this._crossHatch = value;
   }
+  get wobbleEnable() {
+    return this._wobbleEnable;
+  }
+  set wobbleEnable(value) {
+    this._wobbleEnable = value;
+  }
+  get anglePerPass() {
+    return this._anglePerPass;
+  }
+  set anglePerPass(value) {
+    this._anglePerPass = value;
+  }
   get frequency() {
     return this._frequency;
   }
@@ -509,6 +527,8 @@ var CutSetting = class _CutSetting extends LightBurnBaseElement {
       "overScanning",
       "lineAngle",
       "crossHatch",
+      "wobbleEnable",
+      "anglePerPass",
       "frequency",
       "qPulseWidth"
     ];
@@ -551,6 +571,8 @@ var CutSetting = class _CutSetting extends LightBurnBaseElement {
     cs.overScanning = num(getChildValue("overScanning"), void 0);
     cs.lineAngle = num(getChildValue("lineAngle"), void 0);
     cs.crossHatch = boolish(getChildValue("crossHatch"), void 0);
+    cs.wobbleEnable = boolish(getChildValue("wobbleEnable"), void 0);
+    cs.anglePerPass = num(getChildValue("anglePerPass"), void 0);
     cs.frequency = num(getChildValue("frequency"), void 0);
     cs.qPulseWidth = num(getChildValue("QPulseWidth"), void 0);
     return cs;
@@ -566,7 +588,7 @@ var CutSettingPropertyElement = class extends LightBurnBaseElement {
     this.propValue = propValue;
   }
   formatValue(value) {
-    if (this.propName === "crossHatch" && typeof value === "boolean") {
+    if ((this.propName === "crossHatch" || this.propName === "wobbleEnable") && typeof value === "boolean") {
       return value ? "1" : "0";
     }
     if (typeof value === "number") {
@@ -2067,6 +2089,28 @@ function splitLightBurnProjectByCutSetting(input, originalFileName) {
   }
   return files;
 }
+
+// lib/apply-offset.ts
+function assertFiniteOffset(name, value) {
+  if (!Number.isFinite(value)) {
+    throw new Error(`${name} must be a finite number`);
+  }
+}
+function applyOffsetToShape(shape, xOffset, yOffset) {
+  const [a, b, c, d, tx, ty] = shape.xform;
+  shape.xform = [a, b, c, d, tx + xOffset, ty + yOffset];
+}
+function applyOffsetToLbrn(params) {
+  const { lbrnProject, xOffset, yOffset } = params;
+  assertFiniteOffset("xOffset", xOffset);
+  assertFiniteOffset("yOffset", yOffset);
+  for (const child of lbrnProject.children) {
+    if (child instanceof ShapeBase) {
+      applyOffsetToShape(child, xOffset, yOffset);
+    }
+  }
+  return lbrnProject;
+}
 export {
   LightBurnBaseElement as BaseLightBurnElement,
   CutSetting,
@@ -2083,6 +2127,7 @@ export {
   Thumbnail,
   UIPrefs,
   VariableText,
+  applyOffsetToLbrn,
   generateLightBurnSvg,
   parseXml,
   splitLightBurnProjectByCutSetting

package/package.json

@@ -2,7 +2,7 @@
   "name": "lbrnts",
   "main": "dist/index.js",
   "type": "module",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "files": [
     "dist"
   ],