Move docs NPM structure to toplevel

Also, make sure docs align with polyfill.

Also, remove node_modules.

Author: jessealama

docs/buildDocs.js

@@ -175,8 +175,8 @@ async function build() {
     await mkdirp(outputDir);
 
     // Read header and footer templates
-    const head = await fs.readFile('head.html.part', { encoding });
-    const tail = await fs.readFile('tail.html.part', { encoding });
+    const head = await fs.readFile(path.join(__dirname, 'head.html.part'), { encoding });
+    const tail = await fs.readFile(path.join(__dirname, 'tail.html.part'), { encoding });
 
     // Get all markdown files
     const files = await fs.readdir(__dirname);
@@ -188,14 +188,14 @@ async function build() {
     }
 
     // Copy prism.css - using okaidia theme for vibrant syntax highlighting
-    const prismCss = path.join(__dirname, 'node_modules/prismjs/themes/prism-okaidia.css');
+    const prismCss = path.join(__dirname, '..', 'node_modules/prismjs/themes/prism-okaidia.css');
     const prismDest = path.join(outputDir, 'prism.css');
     await fs.copyFile(prismCss, prismDest);
     console.log(`  → ${prismDest}`);
 
     // Build and copy proposal-decimal polyfill as browser bundle
     const { execSync } = require('child_process');
-    const polyfillSrc = path.join(__dirname, 'node_modules/proposal-decimal/src/Decimal.mjs');
+    const polyfillSrc = path.join(__dirname, '..', 'node_modules/proposal-decimal/src/Decimal.mjs');
     const polyfillDest = path.join(outputDir, 'decimal-polyfill.js');
 
     // Build IIFE bundle that exposes DecimalPolyfill globally
@@ -205,6 +205,11 @@ async function build() {
     });
     console.log(`  → ${polyfillDest}`);
 
+    // Also copy the original ES module
+    const polyfillMjsDest = path.join(outputDir, 'decimal-polyfill.mjs');
+    await fs.copyFile(polyfillSrc, polyfillMjsDest);
+    console.log(`  → ${polyfillMjsDest}`);
+    
     console.log('\nBuild complete!');
   } catch (error) {
     console.error('Build failed:', error);

docs/decimal.md

@@ -44,19 +44,6 @@ d5 = new Decimal(0.1); // Actually Decimal("0.1000000000000000055511151231257827
 d6 = new Decimal(123n);
 ```
 
-## Static Methods
-
-### Decimal.**from**(_value_: string | number | bigint | Decimal) : Decimal
-
-Converts a value to a `Decimal`. Unlike the constructor, this method also accepts existing `Decimal` objects (returning them unchanged).
-
-```js
-Decimal.from("123.45"); // => Decimal("123.45")
-Decimal.from(123.45); // => Decimal("123.45")
-Decimal.from(123n); // => Decimal("123")
-Decimal.from(existingDecimal); // => existingDecimal (same object)
-```
-
 ## Special Values
 
 ### NaN (Not a Number)
@@ -87,43 +74,43 @@ posInf.add(new Decimal("1")).toString(); // => "Infinity"
 new Decimal("1").divide(new Decimal("0")).toString(); // => "Infinity"
 ```
 
-## Properties
+## Methods
 
-### **magnitude** : bigint
+### **significand()** : bigint
 
 Returns the significand (mantissa) of the decimal number as a bigint, without regard to the exponent.
 
 ```js
-new Decimal("123.45").magnitude; // => 12345n
-new Decimal("0.00123").magnitude; // => 123n
+new Decimal("123.45").significand(); // => 12345n
+new Decimal("0.00123").significand(); // => 123n
 ```
 
-### **exponent** : number
+### **exponent()** : number
 
 Returns the base-10 exponent of the decimal number.
 
 ```js
-new Decimal("123.45").exponent; // => -2 (representing 12345 × 10^-2)
-new Decimal("1.23e5").exponent; // => 3 (representing 123 × 10^3)
+new Decimal("123.45").exponent(); // => -2 (representing 12345 × 10^-2)
+new Decimal("1.23e5").exponent(); // => 3 (representing 123 × 10^3)
 ```
 
-### **isNaN** : boolean
+### **isNaN()** : boolean
 
 Returns true if the value is NaN (Not a Number).
 
 ```js
-new Decimal("NaN").isNaN; // => true
-new Decimal("123").isNaN; // => false
+new Decimal("NaN").isNaN(); // => true
+new Decimal("123").isNaN(); // => false
 ```
 
-### **isFinite** : boolean
+### **isFinite()** : boolean
 
 Returns true if the value is finite (not NaN or infinity).
 
 ```js
-new Decimal("123").isFinite; // => true
-new Decimal("Infinity").isFinite; // => false
-new Decimal("NaN").isFinite; // => false
+new Decimal("123").isFinite(); // => true
+new Decimal("Infinity").isFinite(); // => false
+new Decimal("NaN").isFinite(); // => false
 ```
 
 ## Arithmetic Methods
@@ -215,7 +202,7 @@ Rounds to a given number of decimal places.
 **Parameters:**
 
 - `scale` (number): Number of decimal places to round to (default: 0)
-- `options.roundingMode` (string): One of "ceil", "floor", "trunc", "halfEven" (default), or "halfAwayFromZero"
+- `options.roundingMode` (string): One of "ceil", "floor", "trunc", "halfEven" (default), or "halfExpand"
 
 ```js
 const d = new Decimal("123.456");
@@ -286,35 +273,35 @@ new Decimal("123.45").toString(); // => "123.45"
 new Decimal("1.23e5").toString(); // => "123000"
 ```
 
-### **toFixed**(_digits_: number) : string
+### **toFixed**({_digits_: number}) : string
 
 Returns a string with a fixed number of decimal places.
 
 ```js
 const d = new Decimal("123.456");
-d.toFixed(0); // => "123"
-d.toFixed(2); // => "123.46"
-d.toFixed(5); // => "123.45600"
+d.toFixed({ digits: 0 }); // => "123"
+d.toFixed({ digits: 2 }); // => "123.46"
+d.toFixed({ digits: 5 }); // => "123.45600"
 ```
 
-### **toExponential**(_fractionDigits_?: number) : string
+### **toExponential**({_digits_: number}?) : string
 
 Returns a string in exponential notation.
 
 ```js
 const d = new Decimal("123.456");
 d.toExponential(); // => "1.23456e+2"
-d.toExponential(2); // => "1.23e+2"
+d.toExponential({ digits: 2 }); // => "1.23e+2"
 ```
 
-### **toPrecision**(_precision_: number) : string
+### **toPrecision**({ _digits_: number}) : string
 
 Returns a string with the specified number of significant digits.
 
 ```js
 const d = new Decimal("123.456");
-d.toPrecision(2); // => "1.2e+2"
-d.toPrecision(5); // => "123.46"
+d.toPrecision({ digits: 2 }); // => "1.2e+2"
+d.toPrecision({ digits: 5 }); // => "123.46"
 ```
 
 ### **toNumber**() : number
@@ -328,17 +315,14 @@ new Decimal("123.456789012345678901234567890123").toNumber(); // => 123.45678901
 
 ### **toBigInt**() : bigint
 
-Converts to a BigInt, truncating any fractional part.
+Converts to a BigInt, throwing if the number isn't actually an integer:
 
 ```js
-new Decimal("123.45").toBigInt(); // => 123n
-new Decimal("123.99").toBigInt(); // => 123n
+new Decimal("123").toBigInt(); // => 123n
+new Decimal("123.99").toBigInt(); // throws
 ```
 
-### **valueOf**() : string
+### **valueOf**()
 
-Returns the string representation. This method is called by JavaScript when a primitive value is needed.
-
-```js
-new Decimal("123.45").valueOf(); // => "123.45"
+This method always throws, since there is currently no primitive that would exactly match the numeric representation of a Decimal.
 ```