@c9up/atom 0.1.3 → 0.1.5

package/dist/math.js

@@ -0,0 +1,187 @@
+export function parseDecimal(input) {
+    const s = input.trim();
+    if (!s) {
+        throw new Error("Invalid decimal: empty string");
+    }
+    let sign = 1n;
+    let body = s;
+    if (body.startsWith("-")) {
+        sign = -1n;
+        body = body.slice(1);
+    }
+    else if (body.startsWith("+")) {
+        body = body.slice(1);
+    }
+    const parts = body.split(".");
+    if (parts.length > 2) {
+        throw new Error(`Invalid decimal: ${input}`);
+    }
+    const whole = parts[0] ?? "";
+    const frac = parts[1] ?? "";
+    if (!/^\d*$/.test(whole) || !/^\d*$/.test(frac)) {
+        throw new Error(`Invalid decimal: ${input}`);
+    }
+    const digits = `${whole}${frac}` || "0";
+    const int = BigInt(digits) * sign;
+    return { int, scale: frac.length };
+}
+export function formatDecimal(int, scale) {
+    if (scale === 0)
+        return int.toString();
+    const negative = int < 0n;
+    let s = (negative ? -int : int).toString();
+    if (s.length <= scale) {
+        s = `${"0".repeat(scale + 1 - s.length)}${s}`;
+    }
+    const split = s.length - scale;
+    const whole = s.slice(0, split);
+    let frac = s.slice(split);
+    frac = frac.replace(/0+$/, "");
+    let out = frac ? `${whole}.${frac}` : whole;
+    if (negative && out !== "0")
+        out = `-${out}`;
+    return out;
+}
+export function addTs(a, b) {
+    const da = parseDecimal(a);
+    const db = parseDecimal(b);
+    const [ai, bi, scale] = alignScale(da, db);
+    return formatDecimal(ai + bi, scale);
+}
+export function subTs(a, b) {
+    const da = parseDecimal(a);
+    const db = parseDecimal(b);
+    const [ai, bi, scale] = alignScale(da, db);
+    return formatDecimal(ai - bi, scale);
+}
+export function mulTs(a, b) {
+    const da = parseDecimal(a);
+    const db = parseDecimal(b);
+    return formatDecimal(da.int * db.int, da.scale + db.scale);
+}
+export function divTs(a, b, precision) {
+    const da = parseDecimal(a);
+    const db = parseDecimal(b);
+    if (db.int === 0n) {
+        throw new Error("Division by zero");
+    }
+    const numerator = da.int * pow10BigInt(precision + db.scale);
+    const denominator = db.int * pow10BigInt(da.scale);
+    const q = numerator / denominator;
+    return formatDecimal(q, precision);
+}
+export function cmpTs(a, b) {
+    const da = parseDecimal(a);
+    const db = parseDecimal(b);
+    const [ai, bi] = alignScale(da, db);
+    if (ai < bi)
+        return -1;
+    if (ai > bi)
+        return 1;
+    return 0;
+}
+/**
+ * Align two parsed decimals to the same scale by multiplying the less-precise
+ * one by `10^(scaleDelta)`. Used by the TS arithmetic helpers below
+ * (add/sub/cmp/mod). NOTE: `Decimal.ts` does NOT import this — it aligns scales
+ * inline via `pow10BigInt`, so this is not a shared-dedup point.
+ */
+export function alignScale(a, b) {
+    if (a.scale === b.scale)
+        return [a.int, b.int, a.scale];
+    if (a.scale > b.scale) {
+        const factor = pow10BigInt(a.scale - b.scale);
+        return [a.int, b.int * factor, a.scale];
+    }
+    const factor = pow10BigInt(b.scale - a.scale);
+    return [a.int * factor, b.int, b.scale];
+}
+/** Exact `10^exp` as a `bigint`. Exported — single definition for the whole TS side. */
+export function pow10BigInt(exp) {
+    let acc = 1n;
+    for (let i = 0; i < exp; i++)
+        acc *= 10n;
+    return acc;
+}
+/**
+ * Pure-TS modulo — fallback for when the native engine is unavailable. The
+ * Rust `rem` path should be preferred when `isNativeAvailable()`.
+ */
+export function modTs(a, b) {
+    const da = parseDecimal(a);
+    const db = parseDecimal(b);
+    if (db.int === 0n) {
+        throw new Error("Division by zero");
+    }
+    const [ai, bi, scale] = alignScale(da, db);
+    return formatDecimal(ai % bi, scale);
+}
+/**
+ * Pure-TS integer exponentiation with truncating div for negative exponents.
+ * Mirrors the Rust `pow` contract so the two paths produce identical results.
+ */
+export function powTs(a, exp, precision) {
+    if (!Number.isInteger(exp)) {
+        throw new Error(`Invalid exponent: ${exp}`);
+    }
+    if (exp === 0)
+        return "1";
+    if (exp < 0) {
+        return divTs("1", powTs(a, -exp, precision), precision);
+    }
+    const base = parseDecimal(a);
+    let resultInt = 1n;
+    let resultScale = 0;
+    let currentInt = base.int;
+    let currentScale = base.scale;
+    let e = exp;
+    while (e > 0) {
+        if (e & 1) {
+            resultInt *= currentInt;
+            resultScale += currentScale;
+        }
+        e >>= 1;
+        if (e > 0) {
+            currentInt *= currentInt;
+            currentScale *= 2;
+        }
+    }
+    return formatDecimal(resultInt, resultScale);
+}
+/**
+ * Pure-TS integer square root via Newton's iteration on BigInt, scaled to
+ * produce `precision` fractional digits. Truncates toward zero; rounding
+ * modes are applied by the caller.
+ */
+export function sqrtTs(a, precision) {
+    const parsed = parseDecimal(a);
+    if (parsed.int < 0n) {
+        throw new Error("Cannot compute sqrt of a negative decimal");
+    }
+    if (parsed.int === 0n)
+        return "0";
+    const factorExp = 2 * precision - parsed.scale;
+    let radicand = parsed.int;
+    if (factorExp >= 0) {
+        radicand *= pow10BigInt(factorExp);
+    }
+    else {
+        radicand /= pow10BigInt(-factorExp);
+    }
+    const root = bigintSqrt(radicand);
+    return formatDecimal(root, precision);
+}
+function bigintSqrt(value) {
+    if (value < 0n)
+        throw new Error("Cannot compute sqrt of negative bigint");
+    if (value < 2n)
+        return value;
+    let x0 = value;
+    let x1 = (x0 + value / x0) / 2n;
+    while (x1 < x0) {
+        x0 = x1;
+        x1 = (x0 + value / x0) / 2n;
+    }
+    return x0;
+}
+//# sourceMappingURL=math.js.map

package/dist/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../src/math.ts"],"names":[],"mappings":"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"}

package/dist/native.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Universal engine loader — auto-detects Node (NAPI) vs Browser (WASM).
+ *
+ * - **Node**: loads the prebuilt `.node` binary via `createRequire` (sync, fast)
+ * - **Browser**: loads the `.wasm` binary via the wasm-pack JS glue (async init on
+ *   first module import via top-level await, then sync function calls)
+ *
+ * The consumer imports `nativeAtom()` and gets the same `NativeAtom` interface
+ * regardless of the environment. No conditional imports needed at the call site.
+ */
+export interface NativeAtom {
+    add(a: string, b: string): string;
+    sub(a: string, b: string): string;
+    mul(a: string, b: string): string;
+    div(a: string, b: string, precision: number): string;
+    rem(a: string, b: string): string;
+    pow(a: string, exp: number, precision: number): string;
+    sqrt(a: string, precision: number): string;
+    cmp(a: string, b: string): number;
+}
+/** Whether the native engine (NAPI or WASM) loaded successfully. */
+export declare function isNativeAvailable(): boolean;
+export declare function nativeAtom(): NativeAtom;
+export declare function __overrideNativeForTesting(impl: NativeAtom | null | undefined): void;
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,UAAU;IAC1B,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACrD,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACvD,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAgDD,oEAAoE;AACpE,wBAAgB,iBAAiB,IAAI,OAAO,CAI3C;AAED,wBAAgB,UAAU,IAAI,UAAU,CAmBvC;AAKD,wBAAgB,0BAA0B,CACzC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACjC,IAAI,CAEN"}

package/dist/native.js

@@ -0,0 +1,80 @@
+/**
+ * Universal engine loader — auto-detects Node (NAPI) vs Browser (WASM).
+ *
+ * - **Node**: loads the prebuilt `.node` binary via `createRequire` (sync, fast)
+ * - **Browser**: loads the `.wasm` binary via the wasm-pack JS glue (async init on
+ *   first module import via top-level await, then sync function calls)
+ *
+ * The consumer imports `nativeAtom()` and gets the same `NativeAtom` interface
+ * regardless of the environment. No conditional imports needed at the call site.
+ */
+let native;
+let loadError;
+const isNode = typeof globalThis.process !== "undefined" &&
+    typeof globalThis.process.versions?.node === "string";
+if (isNode) {
+    // Node path: load NAPI binary (sync).
+    try {
+        const { createRequire } = await import("node:module");
+        const { dirname, join } = await import("node:path");
+        const { fileURLToPath } = await import("node:url");
+        const { arch, platform } = await import("node:process");
+        const nodeRequire = createRequire(import.meta.url);
+        const currentDir = dirname(fileURLToPath(import.meta.url));
+        const platformMap = {
+            "linux-x64": "linux-x64-gnu",
+            "linux-arm64": "linux-arm64-gnu",
+            "darwin-x64": "darwin-x64",
+            "darwin-arm64": "darwin-arm64",
+            "win32-x64": "win32-x64-msvc",
+        };
+        const suffix = platformMap[`${platform}-${arch}`];
+        if (suffix) {
+            native = nodeRequire(join(currentDir, `../index.${suffix}.node`));
+        }
+    }
+    catch (e) {
+        loadError = e;
+    }
+}
+else {
+    // Browser path: load WASM (async init, then sync calls).
+    try {
+        const wasm = await import("../wasm/atom_engine_wasm.js");
+        await wasm.default();
+        native = wasm;
+    }
+    catch (e) {
+        loadError = e;
+    }
+}
+/** Whether the native engine (NAPI or WASM) loaded successfully. */
+export function isNativeAvailable() {
+    if (overrideNative === null)
+        return false;
+    if (overrideNative !== undefined)
+        return true;
+    return native !== undefined;
+}
+export function nativeAtom() {
+    if (overrideNative !== undefined) {
+        if (overrideNative === null) {
+            throw new Error("[ATOM_NAPI_DISABLED] Native engine is disabled (test override)");
+        }
+        return overrideNative;
+    }
+    if (!native) {
+        throw new Error(`[ATOM_ENGINE_NOT_FOUND] Decimal engine not available.\n` +
+            `  Environment: ${isNode ? "Node" : "Browser"}\n` +
+            `  Reason: ${loadError ?? "binary not found"}\n` +
+            `  Fix (Node): cd packages/atom && pnpm build:napi\n` +
+            `  Fix (Browser): cd packages/atom && pnpm build:wasm`);
+    }
+    return native;
+}
+// Test override (unchanged from before)
+let overrideNative;
+export function __overrideNativeForTesting(impl) {
+    overrideNative = impl;
+}
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,IAAI,MAA8B,CAAC;AACnC,IAAI,SAAkB,CAAC;AAEvB,MAAM,MAAM,GACX,OAAO,UAAU,CAAC,OAAO,KAAK,WAAW;IACzC,OAAO,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,KAAK,QAAQ,CAAC;AAEvD,IAAI,MAAM,EAAE,CAAC;IACZ,sCAAsC;IACtC,IAAI,CAAC;QACJ,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACtD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QACpD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QAExD,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAE3D,MAAM,WAAW,GAA2B;YAC3C,WAAW,EAAE,eAAe;YAC5B,aAAa,EAAE,iBAAiB;YAChC,YAAY,EAAE,YAAY;YAC1B,cAAc,EAAE,cAAc;YAC9B,WAAW,EAAE,gBAAgB;SAC7B,CAAC;QAEF,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;QAClD,IAAI,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,MAAM,OAAO,CAAC,CAAC,CAAC;QACnE,CAAC;IACF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,SAAS,GAAG,CAAC,CAAC;IACf,CAAC;AACF,CAAC;KAAM,CAAC;IACP,yDAAyD;IACzD,IAAI,CAAC;QACJ,MAAM,IAAI,GAAqD,MAAM,MAAM,CAC1E,6BAA6B,CAC7B,CAAC;QACF,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,GAAG,IAAI,CAAC;IACf,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,SAAS,GAAG,CAAC,CAAC;IACf,CAAC;AACF,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,iBAAiB;IAChC,IAAI,cAAc,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,MAAM,KAAK,SAAS,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,UAAU;IACzB,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACd,gEAAgE,CAChE,CAAC;QACH,CAAC;QACD,OAAO,cAAc,CAAC;IACvB,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACd,yDAAyD;YACxD,kBAAkB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI;YACjD,aAAa,SAAS,IAAI,kBAAkB,IAAI;YAChD,qDAAqD;YACrD,sDAAsD,CACvD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,wCAAwC;AACxC,IAAI,cAA6C,CAAC;AAElD,MAAM,UAAU,0BAA0B,CACzC,IAAmC;IAEnC,cAAc,GAAG,IAAI,CAAC;AACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c9up/atom",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Atom — exact decimal arithmetic for the Ream ecosystem (TypeScript + Rust N-API)",
   "license": "MIT",
   "type": "module",

package/src/math.ts

@@ -95,9 +95,9 @@ export function cmpTs(a: string, b: string): -1 | 0 | 1 {
 
 /**
  * Align two parsed decimals to the same scale by multiplying the less-precise
- * one by `10^(scaleDelta)`. Exported so `Decimal.ts` can reuse it — previously
- * both files had their own copy under different names (`alignScale` vs
- * `alignScaleParts`), which is a maintenance hazard.
+ * one by `10^(scaleDelta)`. Used by the TS arithmetic helpers below
+ * (add/sub/cmp/mod). NOTE: `Decimal.ts` does NOT import this — it aligns scales
+ * inline via `pow10BigInt`, so this is not a shared-dedup point.
  */
 export function alignScale(
 	a: ParsedDecimal,