formulab 0.13.3 → 0.13.4

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.13.4] - 2026-06-18
+
+### Changed (breaking within 0.x)
+
+- **`earthwork()` / `formwork()` (construction): zero-filled result on invalid input migrated to the standard error policy** — both functions previously returned an all-zero result for non-positive dimensions instead of throwing, and their existing tests encoded that as an "edge case". They now **throw `RangeError`** with a per-constraint message, matching `ERRORS.md` (which already documented them as `throw`) and the beamLoad/compressedAirCost migrations:
+  - `earthwork()`: non-positive `length`/`width`/`depth`, or non-positive `swellFactor`/`shrinkFactor` (a zero factor silently produced a zero loose/compacted volume).
+  - `formwork()`: non-positive dimension **consumed by the element type's area formula** (column/beam/footing → length, width, height; slab → length, width; wall → length, height) or non-positive `quantity`. Dimensions a given element type ignores (slab height, wall width) are left unvalidated, so a formula-irrelevant zero is still accepted. `reuses ≤ 0 → 1` remains intentional lenient behavior.
+
+  Reported by online-tools: ISSUE-20260618-formulab-earthwork-formwork-zerofill (NT-9). `ERRORS.md` condition text updated from "Negative dimensions" to the precise non-positive constraints.
+
 ## [0.13.3] - 2026-06-12
 
 ### Changed (breaking within 0.x)

package/dist/construction/earthwork.d.ts

@@ -8,6 +8,8 @@ import type { EarthworkInput, EarthworkResult } from './types.js';
  *
  * @param input - Earthwork dimensions and factors
  * @returns Volume calculations in m³
+ * @throws RangeError if any dimension (length, width, depth) is not positive,
+ *   or if swellFactor/shrinkFactor is not positive
  */
 export declare function earthwork(input: EarthworkInput): EarthworkResult;
 //# sourceMappingURL=earthwork.d.ts.map

package/dist/construction/earthwork.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"earthwork.d.ts","sourceRoot":"","sources":["../../src/construction/earthwork.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAiBhE"}
+{"version":3,"file":"earthwork.d.ts","sourceRoot":"","sources":["../../src/construction/earthwork.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAiChE"}

package/dist/construction/earthwork.js

@@ -7,9 +7,26 @@
  *
  * @param input - Earthwork dimensions and factors
  * @returns Volume calculations in m³
+ * @throws RangeError if any dimension (length, width, depth) is not positive,
+ *   or if swellFactor/shrinkFactor is not positive
  */
 export function earthwork(input) {
     const { length, width, depth, swellFactor, shrinkFactor } = input;
+    if (length <= 0) {
+        throw new RangeError('length must be greater than 0');
+    }
+    if (width <= 0) {
+        throw new RangeError('width must be greater than 0');
+    }
+    if (depth <= 0) {
+        throw new RangeError('depth must be greater than 0');
+    }
+    if (swellFactor <= 0) {
+        throw new RangeError('swellFactor must be greater than 0');
+    }
+    if (shrinkFactor <= 0) {
+        throw new RangeError('shrinkFactor must be greater than 0');
+    }
     // Bank volume = undisturbed volume
     const bankVolume = length * width * depth;
     // Loose volume = bank volume × swell factor

package/dist/construction/earthwork.js.map

@@ -1 +1 @@
-{"version":3,"file":"earthwork.js","sourceRoot":"","sources":["../../src/construction/earthwork.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IAElE,mCAAmC;IACnC,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAE1C,4CAA4C;IAC5C,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;IAE7C,iDAAiD;IACjD,MAAM,eAAe,GAAG,UAAU,GAAG,YAAY,CAAC;IAElD,OAAO;QACL,UAAU;QACV,WAAW;QACX,eAAe;KAChB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"earthwork.js","sourceRoot":"","sources":["../../src/construction/earthwork.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IAElE,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAC,8BAA8B,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAC,8BAA8B,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,UAAU,CAAC,oCAAoC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;IAC9D,CAAC;IAED,mCAAmC;IACnC,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAE1C,4CAA4C;IAC5C,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;IAE7C,iDAAiD;IACjD,MAAM,eAAe,GAAG,UAAU,GAAG,YAAY,CAAC;IAElD,OAAO;QACL,UAAU;QACV,WAAW;QACX,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/construction/formwork.d.ts

@@ -4,6 +4,9 @@ import type { FormworkInput, FormworkResult } from './types.js';
  *
  * @param input - Formwork calculation parameters
  * @returns Formwork area results
+ * @throws RangeError if a dimension consumed by the element type's area formula
+ *   is not positive (column/beam/footing: length, width, height; slab: length,
+ *   width; wall: length, height), or if quantity is not positive
  */
 export declare function formwork(input: FormworkInput): FormworkResult;
 //# sourceMappingURL=formwork.d.ts.map

package/dist/construction/formwork.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formwork.d.ts","sourceRoot":"","sources":["../../src/construction/formwork.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgD7E;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAwB7D"}
+{"version":3,"file":"formwork.d.ts","sourceRoot":"","sources":["../../src/construction/formwork.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA8E7E;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CA8B7D"}

package/dist/construction/formwork.js

@@ -32,14 +32,49 @@ function calculateSingleArea(elementType, length, width, height) {
             return 0;
     }
 }
+/**
+ * Validate that the dimensions actually consumed by an element type's area
+ * formula are positive. Dimensions not used by a given element type are left
+ * unvalidated (e.g. a slab ignores height, a wall ignores width).
+ */
+function validateDimensions(elementType, length, width, height) {
+    if (length <= 0) {
+        throw new RangeError('length must be greater than 0');
+    }
+    switch (elementType) {
+        case 'column':
+        case 'beam':
+        case 'footing':
+            if (width <= 0)
+                throw new RangeError('width must be greater than 0');
+            if (height <= 0)
+                throw new RangeError('height must be greater than 0');
+            break;
+        case 'slab':
+            if (width <= 0)
+                throw new RangeError('width must be greater than 0');
+            break;
+        case 'wall':
+            if (height <= 0)
+                throw new RangeError('height must be greater than 0');
+            break;
+    }
+}
 /**
  * Calculate formwork area requirements
  *
  * @param input - Formwork calculation parameters
  * @returns Formwork area results
+ * @throws RangeError if a dimension consumed by the element type's area formula
+ *   is not positive (column/beam/footing: length, width, height; slab: length,
+ *   width; wall: length, height), or if quantity is not positive
  */
 export function formwork(input) {
     const { elementType, length, width, height, quantity, reuses } = input;
+    validateDimensions(elementType, length, width, height);
+    if (quantity <= 0) {
+        throw new RangeError('quantity must be greater than 0');
+    }
     // Calculate area for single element
     const singleAreaSqm = calculateSingleArea(elementType, length, width, height);
     // Total area = single area × quantity

package/dist/construction/formwork.js.map

@@ -1 +1 @@
-{"version":3,"file":"formwork.js","sourceRoot":"","sources":["../../src/construction/formwork.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC;;GAEG;AACH,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;;;;;GAOG;AACH,SAAS,mBAAmB,CAC1B,WAAwB,EACxB,MAAc,EACd,KAAa,EACb,MAAc;IAEd,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,gCAAgC;YAChC,OAAO,OAAO,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;QAEnD,KAAK,MAAM;YACT,uCAAuC;YACvC,OAAO,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;QAE1D,KAAK,MAAM;YACT,4BAA4B;YAC5B,OAAO,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;QAEpC,KAAK,MAAM;YACT,4BAA4B;YAC5B,OAAO,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;QAEzC,KAAK,SAAS;YACZ,iCAAiC;YACjC,OAAO,OAAO,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;QAEnD;YACE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAEvE,oCAAoC;IACpC,MAAM,aAAa,GAAG,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAE9E,sCAAsC;IACtC,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC;IAE1D,qCAAqC;IACrC,MAAM,eAAe,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,eAAe,EAAE,CAAC,CAAC,CAAC;IAEpE,6CAA6C;IAC7C,MAAM,aAAa,GAAG,gBAAgB,GAAG,CAAC;QACxC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,GAAG,kBAAkB,CAAC;QAClD,CAAC,CAAC,CAAC,CAAC;IAEN,OAAO;QACL,aAAa;QACb,YAAY;QACZ,gBAAgB;QAChB,aAAa;KACd,CAAC;AACJ,CAAC"}
+{"version":3,"file":"formwork.js","sourceRoot":"","sources":["../../src/construction/formwork.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "formulab",
-  "version": "0.13.3",
+  "version": "0.13.4",
   "description": "Manufacturing & Engineering calculation formulas library - 182 industrial calculations across 15 domains for OEE, Cpk, SPC, FMEA, Nelson Rules, metal weight, CNC machining, GD&T, battery, environmental, pipe flow, logistics, IE time study, and more",
   "type": "module",
   "main": "./dist/index.js",