@mlightcad/data-model 1.5.3 → 1.5.5

package/lib/misc/AcDbOsnapMode.js

@@ -1,3 +1,14 @@
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
 /**
  * Enumeration of object snap modes used in AutoCAD.
  *
@@ -49,4 +60,155 @@ export var AcDbOsnapMode;
      */
     AcDbOsnapMode[AcDbOsnapMode["Centroid"] = 11] = "Centroid";
 })(AcDbOsnapMode || (AcDbOsnapMode = {}));
+/**
+ * Converts an array of {@link AcDbOsnapMode} values into a single integer bitmask.
+ *
+ * ⚠️ Important:
+ * {@link AcDbOsnapMode} values are **ordinal identifiers**, not bit flags.
+ * Each mode is mapped to a bit position using the rule:
+ *
+ * `bit = (mode - 1)`
+ *
+ * This allows multiple object snap modes to be stored efficiently
+ * in a single integer using bitwise operations.
+ *
+ * @param modes - Array of object snap modes to enable
+ * @returns Integer bitmask representing the enabled object snap modes
+ *
+ * @example
+ * ```ts
+ * const mask = acDbOsnapModesToMask([
+ *   AcDbOsnapMode.EndPoint,
+ *   AcDbOsnapMode.MidPoint,
+ *   AcDbOsnapMode.Perpendicular
+ * ])
+ * // mask === 131
+ * ```
+ */
+export function acdbOsnapModesToMask(modes) {
+    var e_1, _a;
+    var mask = 0;
+    try {
+        for (var modes_1 = __values(modes), modes_1_1 = modes_1.next(); !modes_1_1.done; modes_1_1 = modes_1.next()) {
+            var mode = modes_1_1.value;
+            mask |= 1 << (mode - 1);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (modes_1_1 && !modes_1_1.done && (_a = modes_1.return)) _a.call(modes_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return mask;
+}
+/**
+ * Converts an integer bitmask into an array of {@link AcDbOsnapMode} values.
+ *
+ * The function iterates over all {@link AcDbOsnapMode} enum values and
+ * checks whether the corresponding bit (computed as `1 << (mode - 1)`)
+ * is set in the provided mask.
+ *
+ * @param mask - Integer bitmask containing object snap mode flags
+ * @returns Array of enabled {@link AcDbOsnapMode} values
+ *
+ * @example
+ * ```ts
+ * const modes = acDbMaskToOsnapModes(131)
+ * // [
+ * //   AcDbOsnapMode.EndPoint,
+ * //   AcDbOsnapMode.MidPoint,
+ * //   AcDbOsnapMode.Perpendicular
+ * // ]
+ * ```
+ */
+export function acdbMaskToOsnapModes(mask) {
+    var e_2, _a;
+    var modes = [];
+    try {
+        for (var _b = __values(Object.values(AcDbOsnapMode)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var value = _c.value;
+            if (typeof value !== 'number')
+                continue;
+            var bit = 1 << (value - 1);
+            if ((mask & bit) !== 0) {
+                modes.push(value);
+            }
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return modes;
+}
+/**
+ * Toggles a specific {@link AcDbOsnapMode} in an object snap bitmask.
+ *
+ * If the mode is currently enabled, it will be disabled.
+ * If the mode is disabled, it will be enabled.
+ *
+ * @param mask - Current object snap mode bitmask
+ * @param mode - Object snap mode to toggle
+ * @returns Updated bitmask with the specified mode toggled
+ *
+ * @example
+ * ```ts
+ * mask = acdbToggleOsnapMode(mask, AcDbOsnapMode.MidPoint)
+ * ```
+ */
+export function acdbToggleOsnapMode(mask, mode) {
+    return mask ^ (1 << (mode - 1));
+}
+/**
+ * Checks whether a specific {@link AcDbOsnapMode} is enabled in the bitmask.
+ *
+ * @param mask - Object snap mode bitmask
+ * @param mode - Object snap mode to test
+ * @returns `true` if the mode is enabled; otherwise `false`
+ *
+ * @example
+ * ```ts
+ * if (acdbHasOsnapMode(mask, AcDbOsnapMode.EndPoint)) {
+ *   // EndPoint snapping is enabled
+ * }
+ * ```
+ */
+export function acdbHasOsnapMode(mask, mode) {
+    return (mask & (1 << (mode - 1))) !== 0;
+}
+/**
+ * Enables a specific {@link AcDbOsnapMode} in the object snap bitmask.
+ *
+ * @param mask - Current object snap mode bitmask
+ * @param mode - Object snap mode to enable
+ * @returns Updated bitmask with the mode enabled
+ *
+ * @example
+ * ```ts
+ * mask = acdbEnableOsnapMode(mask, AcDbOsnapMode.Tangent)
+ * ```
+ */
+export function acdbEnableOsnapMode(mask, mode) {
+    return mask | (1 << (mode - 1));
+}
+/**
+ * Disables a specific {@link AcDbOsnapMode} in the object snap bitmask.
+ *
+ * @param mask - Current object snap mode bitmask
+ * @param mode - Object snap mode to disable
+ * @returns Updated bitmask with the mode disabled
+ *
+ * @example
+ * ```ts
+ * mask = acdbDisableOsnapMode(mask, AcDbOsnapMode.Nearest)
+ * ```
+ */
+export function acdbDisableOsnapMode(mask, mode) {
+    return mask & ~(1 << (mode - 1));
+}
 //# sourceMappingURL=AcDbOsnapMode.js.map

package/lib/misc/AcDbOsnapMode.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcDbOsnapMode.js","sourceRoot":"","sources":["../../src/misc/AcDbOsnapMode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,aA0CX;AA1CD,WAAY,aAAa;IACvB;;OAEG;IACH,yDAAY,CAAA;IACZ;;OAEG;IACH,yDAAY,CAAA;IACZ;;OAEG;IACH,qDAAU,CAAA;IACV;;OAEG;IACH,iDAAQ,CAAA;IACR;;;OAGG;IACH,yDAAY,CAAA;IACZ;;OAEG;IACH,2DAAa,CAAA;IACb;;OAEG;IACH,mEAAiB,CAAA;IACjB;;OAEG;IACH,uDAAW,CAAA;IACX;;OAEG;IACH,wDAAY,CAAA;IACZ;;OAEG;IACH,0DAAa,CAAA;AACf,CAAC,EA1CW,aAAa,KAAb,aAAa,QA0CxB"}
+{"version":3,"file":"AcDbOsnapMode.js","sourceRoot":"","sources":["../../src/misc/AcDbOsnapMode.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,aA0CX;AA1CD,WAAY,aAAa;IACvB;;OAEG;IACH,yDAAY,CAAA;IACZ;;OAEG;IACH,yDAAY,CAAA;IACZ;;OAEG;IACH,qDAAU,CAAA;IACV;;OAEG;IACH,iDAAQ,CAAA;IACR;;;OAGG;IACH,yDAAY,CAAA;IACZ;;OAEG;IACH,2DAAa,CAAA;IACb;;OAEG;IACH,mEAAiB,CAAA;IACjB;;OAEG;IACH,uDAAW,CAAA;IACX;;OAEG;IACH,wDAAY,CAAA;IACZ;;OAEG;IACH,0DAAa,CAAA;AACf,CAAC,EA1CW,aAAa,KAAb,aAAa,QA0CxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAsB;;IAEtB,IAAI,IAAI,GAAG,CAAC,CAAA;;QAEZ,KAAmB,IAAA,UAAA,SAAA,KAAK,CAAA,4BAAA,+CAAE,CAAC;YAAtB,IAAM,IAAI,kBAAA;YACb,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;QACzB,CAAC;;;;;;;;;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY;;IAEZ,IAAM,KAAK,GAAoB,EAAE,CAAA;;QAEjC,KAAoB,IAAA,KAAA,SAAA,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA,gBAAA,4BAAE,CAAC;YAA9C,IAAM,KAAK,WAAA;YACd,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,SAAQ;YAEvC,IAAM,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;YAC5B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACnB,CAAC;QACH,CAAC;;;;;;;;;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,IAAmB;IAEnB,OAAO,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAA;AACjC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,IAAmB;IAEnB,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;AACzC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,IAAmB;IAEnB,OAAO,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAA;AACjC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,IAAmB;IAEnB,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAA;AAClC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mlightcad/data-model",
-  "version": "1.5.3",
+  "version": "1.5.5",
   "license": "MIT",
   "type": "module",
   "repository": {