siderust-js 0.1.0

package/qtty-js/qtty-node/index.js

@@ -0,0 +1,323 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'qtty.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./qtty.android-arm64.node')
+          } else {
+            nativeBinding = require('@siderust/qtty-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'qtty.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./qtty.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@siderust/qtty-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'qtty.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./qtty.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@siderust/qtty-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'qtty.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./qtty.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@siderust/qtty-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'qtty.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./qtty.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@siderust/qtty-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'qtty.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./qtty.darwin-universal.node')
+      } else {
+        nativeBinding = require('@siderust/qtty-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'qtty.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./qtty.darwin-x64.node')
+          } else {
+            nativeBinding = require('@siderust/qtty-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'qtty.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./qtty.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@siderust/qtty-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'qtty.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./qtty.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@siderust/qtty-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'qtty.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./qtty.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@siderust/qtty-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'qtty.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./qtty.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@siderust/qtty-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'qtty.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./qtty.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@siderust/qtty-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'qtty.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./qtty.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@siderust/qtty-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'qtty.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./qtty.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@siderust/qtty-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'qtty.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./qtty.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@siderust/qtty-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'qtty.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./qtty.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@siderust/qtty-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'qtty.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./qtty.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@siderust/qtty-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'qtty.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./qtty.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@siderust/qtty-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { Quantity, DerivedQuantity, convert, isCompatible, unitDimension, unitSymbol, isValidUnit, ffiVersion, listUnits } = nativeBinding
+
+module.exports.Quantity = Quantity
+module.exports.DerivedQuantity = DerivedQuantity
+module.exports.convert = convert
+module.exports.isCompatible = isCompatible
+module.exports.unitDimension = unitDimension
+module.exports.unitSymbol = unitSymbol
+module.exports.isValidUnit = isValidUnit
+module.exports.ffiVersion = ffiVersion
+module.exports.listUnits = listUnits

package/qtty-js/qtty-node/lib/DerivedQuantity.js

@@ -0,0 +1,122 @@
+/**
+ * @siderust/qtty — DerivedQuantity façade class.
+ *
+ * A compound quantity like velocity (m/s) or angular velocity (rad/s).
+ * This is a plain JS class, mirroring the Quantity façade design.
+ *
+ * @module @siderust/qtty/lib/DerivedQuantity
+ */
+
+'use strict';
+
+const backend = require('./backend.js');
+
+class DerivedQuantity {
+  /**
+   * @param {number} value       Numeric value.
+   * @param {string} numerator   Numerator unit name, e.g. `"Meter"`.
+   * @param {string} denominator Denominator unit name, e.g. `"Second"`.
+   */
+  constructor(value, numerator, denominator) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+      throw new Error('DerivedQuantity value must be a finite number');
+    }
+    if (!backend.isValidUnit(numerator)) {
+      throw new Error(`Unknown numerator unit: "${numerator}"`);
+    }
+    if (!backend.isValidUnit(denominator)) {
+      throw new Error(`Unknown denominator unit: "${denominator}"`);
+    }
+    this._value = value;
+    this._numerator = numerator;
+    this._denominator = denominator;
+    this._numSymbol = backend.unitSymbol(numerator);
+    this._denSymbol = backend.unitSymbol(denominator);
+  }
+
+  /** The numeric value. */
+  get value() {
+    return this._value;
+  }
+
+  /** The numerator unit name. */
+  get numerator() {
+    return this._numerator;
+  }
+
+  /** The denominator unit name. */
+  get denominator() {
+    return this._denominator;
+  }
+
+  /** The compound symbol, e.g. `"m/s"`. */
+  get symbol() {
+    return `${this._numSymbol}/${this._denSymbol}`;
+  }
+
+  /**
+   * Convert to different units.
+   * @param {string} numerator   Target numerator unit.
+   * @param {string} denominator Target denominator unit.
+   * @returns {DerivedQuantity}
+   */
+  to(numerator, denominator) {
+    // Convert numerator and denominator independently.
+    // v_new = v_old × (numFactor / denFactor)
+    const numFactor = backend.convert(1, this._numerator, numerator);
+    const denFactor = backend.convert(1, this._denominator, denominator);
+    return new DerivedQuantity((this._value * numFactor) / denFactor, numerator, denominator);
+  }
+
+  /**
+   * Multiply by a scalar.
+   * @param {number} scalar
+   * @returns {DerivedQuantity}
+   */
+  mul(scalar) {
+    return new DerivedQuantity(this._value * scalar, this._numerator, this._denominator);
+  }
+
+  /**
+   * Divide by a scalar.
+   * @param {number} scalar
+   * @returns {DerivedQuantity}
+   */
+  div(scalar) {
+    return new DerivedQuantity(this._value / scalar, this._numerator, this._denominator);
+  }
+
+  /** Negate the value. */
+  neg() {
+    return new DerivedQuantity(-this._value, this._numerator, this._denominator);
+  }
+
+  /**
+   * Format as a human-readable string.
+   * @param {number} [precision]
+   * @returns {string}
+   */
+  format(precision) {
+    const v =
+      precision != null && precision >= 0 ? this._value.toFixed(precision) : String(this._value);
+    return `${v} ${this.symbol}`;
+  }
+
+  /**
+   * Serialize to a plain JSON object.
+   * @returns {{ value: number, numerator: string, denominator: string }}
+   */
+  toJson() {
+    return {
+      value: this._value,
+      numerator: this._numerator,
+      denominator: this._denominator,
+    };
+  }
+
+  toString() {
+    return this.format();
+  }
+}
+
+module.exports = { DerivedQuantity };

package/qtty-js/qtty-node/lib/Quantity.js

@@ -0,0 +1,151 @@
+/**
+ * @siderust/qtty — Quantity façade class.
+ *
+ * This is the public runtime class for a physical quantity.  It is a plain
+ * JS object (not a native addon class) so that the same `Quantity` identity
+ * works in both Node (NAPI-RS) and Web (WASM) environments, and instances
+ * produced by `@siderust/qtty` can flow through `@siderust/tempoch` and
+ * `@siderust/siderust` without cross-addon identity mismatches.
+ *
+ * @module @siderust/qtty/lib/Quantity
+ */
+
+'use strict';
+
+const backend = require('./backend.js');
+
+class Quantity {
+  /**
+   * @param {number} value  Numeric value.
+   * @param {string} unit   Unit name, e.g. `"Meter"`, `"Kilometer"`.
+   */
+  constructor(value, unit) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+      throw new Error('Quantity value must be a finite number');
+    }
+    if (!backend.isValidUnit(unit)) {
+      throw new Error(`Unknown unit: "${unit}". Use listUnits() to list valid units.`);
+    }
+    this._value = value;
+    this._unit = unit;
+    this._symbol = backend.unitSymbol(unit);
+    this._dimension = backend.unitDimension(unit);
+  }
+
+  /** The numeric value of this quantity. */
+  get value() {
+    return this._value;
+  }
+
+  /** The unit name, e.g. `"Meter"`. */
+  get unit() {
+    return this._unit;
+  }
+
+  /** The unit symbol, e.g. `"m"`. */
+  get symbol() {
+    return this._symbol;
+  }
+
+  /** The dimension name, e.g. `"Length"`. */
+  get dimension() {
+    return this._dimension;
+  }
+
+  /**
+   * Convert to a different unit.
+   * @param {string} targetUnit
+   * @returns {Quantity}
+   */
+  to(targetUnit) {
+    const converted = backend.convert(this._value, this._unit, targetUnit);
+    return new Quantity(converted, targetUnit);
+  }
+
+  /**
+   * Check dimensional compatibility with another Quantity.
+   * @param {Quantity} other
+   * @returns {boolean}
+   */
+  compatible(other) {
+    return backend.isCompatible(this._unit, other._unit);
+  }
+
+  /**
+   * Add another quantity (same dimension). Result uses this quantity's unit.
+   * @param {Quantity} other
+   * @returns {Quantity}
+   */
+  add(other) {
+    if (!this.compatible(other)) {
+      throw new Error(
+        `Cannot add quantities with different dimensions: ${this._dimension} vs ${other._dimension}`,
+      );
+    }
+    const otherInMyUnit = backend.convert(other._value, other._unit, this._unit);
+    return new Quantity(this._value + otherInMyUnit, this._unit);
+  }
+
+  /**
+   * Subtract another quantity (same dimension). Result uses this quantity's unit.
+   * @param {Quantity} other
+   * @returns {Quantity}
+   */
+  sub(other) {
+    if (!this.compatible(other)) {
+      throw new Error(
+        `Cannot subtract quantities with different dimensions: ${this._dimension} vs ${other._dimension}`,
+      );
+    }
+    const otherInMyUnit = backend.convert(other._value, other._unit, this._unit);
+    return new Quantity(this._value - otherInMyUnit, this._unit);
+  }
+
+  /**
+   * Multiply by a scalar.
+   * @param {number} scalar
+   * @returns {Quantity}
+   */
+  mul(scalar) {
+    return new Quantity(this._value * scalar, this._unit);
+  }
+
+  /**
+   * Divide by a scalar.
+   * @param {number} scalar
+   * @returns {Quantity}
+   */
+  div(scalar) {
+    return new Quantity(this._value / scalar, this._unit);
+  }
+
+  /** Negate the value. */
+  neg() {
+    return new Quantity(-this._value, this._unit);
+  }
+
+  /**
+   * Format as a human-readable string.
+   * @param {number} [precision]
+   * @returns {string}
+   */
+  format(precision) {
+    const v =
+      precision != null && precision >= 0 ? this._value.toFixed(precision) : String(this._value);
+    return `${v} ${this._symbol}`;
+  }
+
+  /**
+   * Serialize to a plain JSON object.
+   * @returns {{ value: number, unit: string }}
+   */
+  toJson() {
+    return { value: this._value, unit: this._unit };
+  }
+
+  toString() {
+    return this.format();
+  }
+}
+
+module.exports = { Quantity };

package/qtty-js/qtty-node/lib/backend.js

@@ -0,0 +1,25 @@
+/**
+ * @siderust/qtty — Internal backend abstraction.
+ *
+ * This module loads the native NAPI-RS addon and re-exports only the
+ * primitive-level helpers that the JS façade classes need. Consumer code
+ * should never import this module directly.
+ *
+ * @module @siderust/qtty/lib/backend
+ * @private
+ */
+
+'use strict';
+
+const native = require('../native.cjs');
+
+// Re-export the primitive operations the façade needs.
+module.exports = {
+  convert: native.convert,
+  isCompatible: native.isCompatible,
+  unitDimension: native.unitDimension,
+  unitSymbol: native.unitSymbol,
+  isValidUnit: native.isValidUnit,
+  listUnits: native.listUnits,
+  ffiVersion: native.ffiVersion,
+};