es6-fuzz 6.0.9 → 7.1.0

package/CONTRIBUTING.md

@@ -0,0 +1,87 @@
+# Contributing to es6-fuzz
+
+Thanks for your interest in improving es6-fuzz! This guide covers the local
+workflow and the conventions used in this repository.
+
+## Prerequisites
+
+- Node.js 22+ (see `engines` in [package.json](package.json))
+- npm
+
+`package-lock.json` is intentionally not committed, so use `npm install`
+(not `npm ci`).
+
+## Getting started
+
+```bash
+git clone https://github.com/sebs/es6-fuzz.git
+cd es6-fuzz
+npm install
+npm test
+```
+
+## Common scripts
+
+| Script | What it does |
+| --- | --- |
+| `npm run build` | Clean `lib/` and compile TypeScript |
+| `npm test` | Build, then run the test suite |
+| `npm run test:coverage` | Run the suite with a coverage report |
+| `npm run check` | Strict type-check (`tsc --noEmit`) without emitting |
+| `npm run docs` | Generate the TypeDoc API site into `out/` |
+| `npm run render-examples` | Render fuzzifier SVGs + viewer into `examples/` |
+
+Generated output (`lib/`, `out/`, `docs/CHANGELOG.md`, `examples/`) is not
+committed — it is produced by the build and CI pipeline.
+
+## Tests
+
+Tests use the built-in Node.js test runner (`node:test`) executed via `tsx`,
+and live under [test/](test/). Test files import from the compiled `lib/`
+output, which is why `npm test` builds first. Please add or update tests for any
+behavior change, and keep the suite green:
+
+```bash
+npm test
+npm run check
+```
+
+## Coding conventions
+
+- TypeScript in `strict` mode — no new type errors (`npm run check`).
+- Each fuzzifier implements the `Fuzzify` contract in
+  [src/curve/fuzzifier.ts](src/curve/fuzzifier.ts) and maps a crisp input to a
+  membership degree in `0..1`.
+- Match the style of the surrounding code.
+
+## Commit messages
+
+This project uses [Conventional Commits](https://www.conventionalcommits.org/)
+prefixes — e.g. `feat:`, `fix:`, `chore:`, `ci:`, `build:`, `refactor:`,
+`docs:`. Keep commits focused and the subject line imperative.
+
+## Submitting changes
+
+1. Fork and branch from `master`.
+2. Make your change with tests and passing `npm test` / `npm run check`.
+3. Open a pull request describing the change and the motivation.
+
+CI runs the test suite and the strict type-check on Node 22 and 24
+(see [.github/workflows/ci.yml](.github/workflows/ci.yml)).
+
+## Releases
+
+Maintainers release by bumping the version, which creates a matching tag:
+
+```bash
+npm version <patch|minor|major>   # postversion pushes the commit + tag
+```
+
+Pushing the `v*` tag triggers the release workflow (builds, packs, and
+generates release notes); publishing to npm is a separate, manually dispatched
+workflow.
+
+## License
+
+By contributing you agree that your contributions are licensed under the
+project's [MIT License](LICENSE.md).

package/Readme.md

@@ -2,6 +2,7 @@
 
 > Fuzzy Logic in JavaScript
 
+[![CI](https://github.com/sebs/es6-fuzz/actions/workflows/ci.yml/badge.svg)](https://github.com/sebs/es6-fuzz/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/dt/es6-fuzz.svg)](https://www.npmjs.com/package/es6-fuzz)
 [![license](https://img.shields.io/github/license/sebs/es6-fuzz.svg)](https://github.com/sebs/es6-fuzz/blob/master/LICENSE.md)
 [![GitHub tag](https://img.shields.io/github/tag/sebs/es6-fuzz.svg)](https://github.com/sebs/es6-fuzz)
@@ -14,12 +15,11 @@
 * **Reverse Grade** - Inverted linear membership
 * **Sigmoid** - S-shaped membership curve
 * **Trapezoid** - Trapezoidal membership function
-* **Triangle** - Triangular membership function
-
+* **Triangle** - Triangular membership functionve
 ## Documentation
 
 * [API Documentation](http://sebs.github.io/es6-fuzz)
-* [Changelog](https://github.com/sebs/es6-fuzz/blob/master/docs/CHANGELOG.md)
+* [Changelog](https://github.com/sebs/es6-fuzz/releases)
 
 ## Installation
 
@@ -37,9 +37,9 @@ const result = logic
   .init('noAttack', new Triangle(0, 20, 40))
   .or('normalAttack', new Trapezoid(20, 30, 90, 100))
   .or('enragedAttack', new Grade(90, 100))
-  .defuzzify(40);
+  .defuzzify(99);
 
-console.log(result); // 'enragedAttack'
+console.log(result.toString()); // 'enragedAttack'
 ```
 
 ## Temperature Example
@@ -55,7 +55,7 @@ const result = logic
   .or('hot', new Trapezoid(12, 14, 16, 100)) 
   .defuzzify(20);
 
-console.log(result); // 'hot'
+console.log(result.toString()); // 'hot'
 ```
 
 
@@ -104,19 +104,35 @@ console.log(monsterBiteTest(jsBoonInput)); // true
 ### Running Tests
 
 ```bash
-npm test
+npm test               # build + run the test suite
+npm run test:coverage  # same, with a coverage report
 ```
 
 ### Building Documentation
 
 ```bash
-npm run docs        # Generate API docs
-npm run docs:site   # Build documentation site
+npm run docs    # Generate the TypeDoc API site into ./out
+```
+
+The site is deployed to GitHub Pages automatically on every push to `master`
+by the [Docs workflow](.github/workflows/docs.yml); `npm run docs` is for local
+preview.
+
+### Visual Examples
+
+The `render-examples` script renders every fuzzifier and a few composite
+systems (temperature/speed controllers) to SVG, plus an `index.html` viewer:
+
+```bash
+npm run build            # render-examples runs from the compiled output
+npm run render-examples  # writes SVGs + index.html into ./examples
 ```
 
+Open `examples/index.html` in a browser to see the membership curves.
+
 ## Requirements
 
-* Node.js 20+
+* Node.js 22+
 
 ## Resources
 

package/SECURITY.md

@@ -2,14 +2,13 @@
 
 ## Supported Versions
 
-Use this section to tell people about which versions of your project are
-currently being supported with security updates.
+The following versions of es6-fuzz are currently supported with security updates:
 
 | Version | Supported          |
 | ------- | ------------------ |
-| 5.1.x   | :white_check_mark: |
-| 5.0.x   | :x:                |
-| 4.0.x   | :X:|
+| 6.0.x   | :white_check_mark: |
+| 5.x.x   | :x:                |
+| 4.x.x   | :x:                |
 | < 4.0   | :x:                |
 
 ## Reporting a Vulnerability

package/lib/curve/constant.d.ts

@@ -1,11 +1,12 @@
+import { Fuzzifier } from './fuzzifier';
 /** Class representing a Constant. */
-export declare class Constant {
+export declare class Constant implements Fuzzifier {
     private readonly cValue;
     /**
      * Create a Constant Value.
-     * @param {number} constantValue - The value.
+     * @param {number} constantValue - The membership value, must be within 0..1.
      * @example
-     * new Constant(10)
+     * new Constant(0.5)
      */
     constructor(constantValue: number);
     /**

package/lib/curve/constant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constant.d.ts","sourceRoot":"","sources":["../../src/curve/constant.ts"],"names":[],"mappings":"AACA,qCAAqC;AACrC,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC;;;;;OAKG;gBACS,aAAa,EAAE,MAAM;IAGjC;;;OAGG;IACH,OAAO,IAAI,MAAM;CAGlB"}
+{"version":3,"file":"constant.d.ts","sourceRoot":"","sources":["../../src/curve/constant.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,qCAAqC;AACrC,qBAAa,QAAS,YAAW,SAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC;;;;;OAKG;gBACS,aAAa,EAAE,MAAM;IAMjC;;;OAGG;IACH,OAAO,IAAI,MAAM;CAGlB"}

package/lib/curve/constant.js

@@ -6,11 +6,14 @@ class Constant {
     cValue;
     /**
      * Create a Constant Value.
-     * @param {number} constantValue - The value.
+     * @param {number} constantValue - The membership value, must be within 0..1.
      * @example
-     * new Constant(10)
+     * new Constant(0.5)
      */
     constructor(constantValue) {
+        if (!(constantValue >= 0 && constantValue <= 1)) {
+            throw Error('Constant value must be between 0 and 1 but is ' + constantValue);
+        }
         this.cValue = constantValue;
     }
     /**

package/lib/curve/constant.js.map

@@ -1 +1 @@
-{"version":3,"file":"constant.js","sourceRoot":"","sources":["../../src/curve/constant.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AACb,qCAAqC;AACrC,MAAa,QAAQ;IACF,MAAM,CAAS;IAEhC;;;;;OAKG;IACH,YAAY,aAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC;IAC9B,CAAC;IACD;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAnBD,4BAmBC"}
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../../src/curve/constant.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AAEb,qCAAqC;AACrC,MAAa,QAAQ;IACF,MAAM,CAAS;IAEhC;;;;;OAKG;IACH,YAAY,aAAqB;QAC/B,IAAI,CAAC,CAAC,aAAa,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC,CAAC,EAAE,CAAC;YAChD,MAAM,KAAK,CAAC,gDAAgD,GAAG,aAAa,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC;IAC9B,CAAC;IACD;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAtBD,4BAsBC"}

package/lib/curve/fuzzifier.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Common interface implemented by every fuzzifier.
+ *
+ * Anything that maps a crisp input value to a membership degree can be used
+ * with {@link Logic}. This includes the geometric {@link Shape} curves as well
+ * as {@link Constant}, {@link Sigmoid} and {@link FuzzyFunction}, none of which
+ * are point-based shapes.
+ */
+export interface Fuzzifier {
+    /**
+     * Fuzzify
+     * @param {number} val - Point on X axis
+     * @return {number} fuzzy output 0..1
+     */
+    fuzzify(val: number): number;
+}
+//# sourceMappingURL=fuzzifier.d.ts.map

package/lib/curve/fuzzifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzifier.d.ts","sourceRoot":"","sources":["../../src/curve/fuzzifier.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B"}

package/lib/curve/fuzzifier.js

@@ -0,0 +1,3 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=fuzzifier.js.map

package/lib/curve/fuzzifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzifier.js","sourceRoot":"","sources":["../../src/curve/fuzzifier.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC"}

package/lib/curve/fuzzy-function.d.ts

@@ -1,5 +1,6 @@
+import { Fuzzifier } from './fuzzifier';
 /** Class representing a FuzzyFunction. */
-export declare class FuzzyFunction {
+export declare class FuzzyFunction implements Fuzzifier {
     private readonly cb;
     /**
      * Create a FuzzyFunction.

package/lib/curve/fuzzy-function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fuzzy-function.d.ts","sourceRoot":"","sources":["../../src/curve/fuzzy-function.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA0B;IAE7C;;;OAGG;gBACS,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM;IAGvC;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAO7B"}
+{"version":3,"file":"fuzzy-function.d.ts","sourceRoot":"","sources":["../../src/curve/fuzzy-function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,0CAA0C;AAC1C,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA0B;IAE7C;;;OAGG;gBACS,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM;IAGvC;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAU7B"}

package/lib/curve/fuzzy-function.js

@@ -17,10 +17,13 @@ class FuzzyFunction {
      */
     fuzzify(val) {
         const res = this.cb(val);
-        if (res >= 0 && res <= 1) {
+        // The relational checks coerce their operands, so a non-number (string,
+        // boolean, null, array) could pass `res >= 0 && res <= 1` and be returned
+        // verbatim, breaking the `number` contract. Require an actual number.
+        if (typeof res === 'number' && res >= 0 && res <= 1) {
             return res;
         }
-        throw Error('fuzzified result must be smaller than 1 but greater than 0 but is' + res);
+        throw Error('fuzzified result must be between 0 and 1 but is ' + res);
     }
 }
 exports.FuzzyFunction = FuzzyFunction;

package/lib/curve/fuzzy-function.js.map

@@ -1 +1 @@
-{"version":3,"file":"fuzzy-function.js","sourceRoot":"","sources":["../../src/curve/fuzzy-function.ts"],"names":[],"mappings":";;;AAAA,0CAA0C;AAC1C,MAAa,aAAa;IACP,EAAE,CAA0B;IAE7C;;;OAGG;IACH,YAAY,EAA2B;QACrC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IACD;;;OAGG;IACH,OAAO,CAAC,GAAW;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,KAAK,CAAC,mEAAmE,GAAG,GAAG,CAAC,CAAC;IACzF,CAAC;CACF;AArBD,sCAqBC"}
+{"version":3,"file":"fuzzy-function.js","sourceRoot":"","sources":["../../src/curve/fuzzy-function.ts"],"names":[],"mappings":";;;AACA,0CAA0C;AAC1C,MAAa,aAAa;IACP,EAAE,CAA0B;IAE7C;;;OAGG;IACH,YAAY,EAA2B;QACrC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IACD;;;OAGG;IACH,OAAO,CAAC,GAAW;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACzB,wEAAwE;QACxE,0EAA0E;QAC1E,sEAAsE;QACtE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACpD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,KAAK,CAAC,kDAAkD,GAAG,GAAG,CAAC,CAAC;IACxE,CAAC;CACF;AAxBD,sCAwBC"}

package/lib/curve/grade.d.ts

@@ -5,6 +5,12 @@ import { Shape } from './shape';
  * new Grade(0, 10)
  */
 export declare class Grade extends Shape {
+    /**
+     * Create a Grade.
+     * @param {number} x0 - start of the rising edge (membership 0)
+     * @param {number} x1 - end of the rising edge (membership 1)
+     */
+    constructor(x0: number, x1: number);
     /**
      * Fuzzify
      * @param {number} val - Point on X axis

package/lib/curve/grade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grade.d.ts","sourceRoot":"","sources":["../../src/curve/grade.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC;;;;GAIG;AACH,qBAAa,KAAM,SAAQ,KAAK;IAC9B;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAmB7B"}
+{"version":3,"file":"grade.d.ts","sourceRoot":"","sources":["../../src/curve/grade.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC;;;;GAIG;AACH,qBAAa,KAAM,SAAQ,KAAK;IAC9B;;;;OAIG;gBACS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;IAUlC;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CA2B7B"}

package/lib/curve/grade.js

@@ -8,6 +8,21 @@ const shape_1 = require("./shape");
  * new Grade(0, 10)
  */
 class Grade extends shape_1.Shape {
+    /**
+     * Create a Grade.
+     * @param {number} x0 - start of the rising edge (membership 0)
+     * @param {number} x1 - end of the rising edge (membership 1)
+     */
+    constructor(x0, x1) {
+        super(x0, x1, x1, x1);
+        // Reject reversed finite params: with x0 > x1 the `x <= x0` guard swallows
+        // the whole interior, so the ramp collapses into a hard step and the linear
+        // branch becomes dead code. NaN/Infinity are left untouched (handled at
+        // fuzzify time and relied on by callers passing open-ended bounds).
+        if (Number.isFinite(x0) && Number.isFinite(x1) && x0 > x1) {
+            throw Error('Grade requires x0 <= x1 but got x0=' + x0 + ', x1=' + x1);
+        }
+    }
     /**
      * Fuzzify
      * @param {number} val - Point on X axis
@@ -16,11 +31,16 @@ class Grade extends shape_1.Shape {
     fuzzify(val) {
         let result = 0;
         const x = val;
-        // Handle case where x0 = x1 (vertical grade/step function)
+        // NaN has no meaningful membership; treat it as outside the ramp (0).
+        if (Number.isNaN(x))
+            return 0;
+        // Handle case where x0 = x1 (vertical grade/step function).
+        // Treat it as the limit of the ramp: the foot at x0 is 0, like the normal
+        // grade below, so behaviour stays continuous as x1 approaches x0.
         if (this.x1 === this.x0) {
-            if (x < this.x0)
+            if (x <= this.x0)
                 return 0;
-            return 1; // x >= x0
+            return 1; // x > x0
         }
         if (x <= this.x0) {
             result = 0;
@@ -29,7 +49,10 @@ class Grade extends shape_1.Shape {
             result = 1;
         }
         else {
-            result = (x / (this.x1 - this.x0)) - (this.x0 / (this.x1 - this.x0));
+            // Algebraically equal to x/(x1-x0) - x0/(x1-x0) but numerically stable:
+            // the split form subtracts two large nearly-equal quotients and loses
+            // significance for large coordinates (see Grade large-coordinate bug).
+            result = (x - this.x0) / (this.x1 - this.x0);
         }
         return result;
     }

package/lib/curve/grade.js.map

@@ -1 +1 @@
-{"version":3,"file":"grade.js","sourceRoot":"","sources":["../../src/curve/grade.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AACb,mCAAgC;AAChC;;;;GAIG;AACH,MAAa,KAAM,SAAQ,aAAK;IAC9B;;;;OAIG;IACH,OAAO,CAAC,GAAW;QACjB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,MAAM,CAAC,GAAG,GAAG,CAAC;QAEd,2DAA2D;QAC3D,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE;gBAAE,OAAO,CAAC,CAAC;YAC1B,OAAO,CAAC,CAAC,CAAC,UAAU;QACtB,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACxB,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAzBD,sBAyBC"}
+{"version":3,"file":"grade.js","sourceRoot":"","sources":["../../src/curve/grade.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AACb,mCAAgC;AAChC;;;;GAIG;AACH,MAAa,KAAM,SAAQ,aAAK;IAC9B;;;;OAIG;IACH,YAAY,EAAU,EAAE,EAAU;QAChC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACtB,2EAA2E;QAC3E,4EAA4E;QAC5E,wEAAwE;QACxE,oEAAoE;QACpE,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;YAC1D,MAAM,KAAK,CAAC,qCAAqC,GAAG,EAAE,GAAG,OAAO,GAAG,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD;;;;OAIG;IACH,OAAO,CAAC,GAAW;QACjB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,MAAM,CAAC,GAAG,GAAG,CAAC;QAEd,sEAAsE;QACtE,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;QAE9B,4DAA4D;QAC5D,0EAA0E;QAC1E,kEAAkE;QAClE,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;gBAAE,OAAO,CAAC,CAAC;YAC3B,OAAO,CAAC,CAAC,CAAC,SAAS;QACrB,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACxB,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;aAAM,CAAC;YACN,wEAAwE;YACxE,sEAAsE;YACtE,uEAAuE;YACvE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAhDD,sBAgDC"}

package/lib/curve/reverse-grade.d.ts

@@ -1,6 +1,16 @@
 import { Shape } from './shape';
-/** Class representing a ReverseGrade. */
+/**
+ * Class representing a ReverseGrade.
+ * @example
+ * new ReverseGrade(0, 10)
+ */
 export declare class ReverseGrade extends Shape {
+    /**
+     * Create a ReverseGrade.
+     * @param {number} x0 - end of the full-membership plateau (membership 1)
+     * @param {number} x1 - end of the falling edge (membership 0)
+     */
+    constructor(x0: number, x1: number);
     /**
      * Fuzzify
      * @param {number} val - Point on X axis

package/lib/curve/reverse-grade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reverse-grade.d.ts","sourceRoot":"","sources":["../../src/curve/reverse-grade.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,yCAAyC;AACzC,qBAAa,YAAa,SAAQ,KAAK;IACrC;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAkB7B"}
+{"version":3,"file":"reverse-grade.d.ts","sourceRoot":"","sources":["../../src/curve/reverse-grade.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC;;;;OAIG;gBACS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;IASlC;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAqB7B"}

package/lib/curve/reverse-grade.js

@@ -2,32 +2,52 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReverseGrade = void 0;
 const shape_1 = require("./shape");
-/** Class representing a ReverseGrade. */
+/**
+ * Class representing a ReverseGrade.
+ * @example
+ * new ReverseGrade(0, 10)
+ */
 class ReverseGrade extends shape_1.Shape {
+    /**
+     * Create a ReverseGrade.
+     * @param {number} x0 - end of the full-membership plateau (membership 1)
+     * @param {number} x1 - end of the falling edge (membership 0)
+     */
+    constructor(x0, x1) {
+        super(x0, x1, x1, x1);
+        // Reject reversed finite params: with x0 > x1 the falling edge collapses
+        // into a hard step and the linear branch becomes dead code. NaN/Infinity
+        // are left untouched (handled at fuzzify time).
+        if (Number.isFinite(x0) && Number.isFinite(x1) && x0 > x1) {
+            throw Error('ReverseGrade requires x0 <= x1 but got x0=' + x0 + ', x1=' + x1);
+        }
+    }
     /**
      * Fuzzify
      * @param {number} val - Point on X axis
      * @return {number} fuzzy output 0..1
      */
     fuzzify(val) {
-        let result = 0;
         const x = val;
-        if (x <= this.x0) {
-            result = 1;
-        }
-        else if (x >= this.x1) {
-            result = 0;
-        }
-        else {
-            // Handle case where x0 = x1 (vertical reverse grade)
-            if (this.x1 === this.x0) {
-                result = 0;
-            }
-            else {
-                result = (-x / (this.x1 - this.x0)) + (this.x1 / (this.x1 - this.x0));
-            }
+        // NaN has no meaningful membership; treat it as outside the ramp (0).
+        if (Number.isNaN(x))
+            return 0;
+        // Vertical reverse grade (x0 = x1): step down, the mirror of Grade.
+        // (The previous inline x0 === x1 handling sat in an unreachable branch:
+        // when x0 === x1 every value is caught by x <= x0 or x >= x1 first.)
+        if (this.x1 === this.x0) {
+            if (x <= this.x0)
+                return 1;
+            return 0; // x > x0
         }
-        return result;
+        if (x <= this.x0)
+            return 1;
+        if (x >= this.x1)
+            return 0;
+        // Algebraically equal to -x/(x1-x0) + x1/(x1-x0) but numerically stable:
+        // the split form adds two large nearly-equal quotients and loses
+        // significance for large coordinates.
+        return (this.x1 - x) / (this.x1 - this.x0);
     }
 }
 exports.ReverseGrade = ReverseGrade;

package/lib/curve/reverse-grade.js.map

@@ -1 +1 @@
-{"version":3,"file":"reverse-grade.js","sourceRoot":"","sources":["../../src/curve/reverse-grade.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AACb,mCAAgC;AAChC,yCAAyC;AACzC,MAAa,YAAa,SAAQ,aAAK;IACrC;;;;OAIG;IACH,OAAO,CAAC,GAAW;QACjB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,MAAM,CAAC,GAAG,GAAG,CAAC;QAEd,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACxB,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;aAAM,CAAC;YACN,qDAAqD;YACrD,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;gBACxB,MAAM,GAAG,CAAC,CAAC;YACb,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAxBD,oCAwBC"}
+{"version":3,"file":"reverse-grade.js","sourceRoot":"","sources":["../../src/curve/reverse-grade.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AACb,mCAAgC;AAChC;;;;GAIG;AACH,MAAa,YAAa,SAAQ,aAAK;IACrC;;;;OAIG;IACH,YAAY,EAAU,EAAE,EAAU;QAChC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACtB,yEAAyE;QACzE,yEAAyE;QACzE,gDAAgD;QAChD,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;YAC1D,MAAM,KAAK,CAAC,4CAA4C,GAAG,EAAE,GAAG,OAAO,GAAG,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IACD;;;;OAIG;IACH,OAAO,CAAC,GAAW;QACjB,MAAM,CAAC,GAAG,GAAG,CAAC;QAEd,sEAAsE;QACtE,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;QAE9B,oEAAoE;QACpE,wEAAwE;QACxE,qEAAqE;QACrE,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;gBAAE,OAAO,CAAC,CAAC;YAC3B,OAAO,CAAC,CAAC,CAAC,SAAS;QACrB,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;YAAE,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;YAAE,OAAO,CAAC,CAAC;QAC3B,yEAAyE;QACzE,iEAAiE;QACjE,sCAAsC;QACtC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC;CACF;AAzCD,oCAyCC"}

package/lib/curve/shape.d.ts

@@ -1,5 +1,6 @@
+import { Fuzzifier } from './fuzzifier';
 /** Base class representing a Shape. */
-export declare abstract class Shape {
+export declare abstract class Shape implements Fuzzifier {
     readonly x0: number;
     readonly x1: number;
     readonly x2: number;

package/lib/curve/shape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../../src/curve/shape.ts"],"names":[],"mappings":"AACA,uCAAuC;AACvC,8BAAsB,KAAK;IACzB,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IAErB;;;;;;OAMG;gBACS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;IAmB1D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CACtC"}
+{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../../src/curve/shape.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,uCAAuC;AACvC,8BAAsB,KAAM,YAAW,SAAS;IAC9C,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAC;IAErB;;;;;;OAMG;gBACS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;IAuB1D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CACtC"}

package/lib/curve/shape.js

@@ -15,22 +15,26 @@ class Shape {
      * @param {number} x3 - x3
      */
     constructor(x0, x1, x2, x3) {
-        Object.defineProperty(this, 'x0', {
-            value: x0,
-            writable: false
-        });
-        Object.defineProperty(this, 'x1', {
-            value: x1,
-            writable: false
-        });
-        Object.defineProperty(this, 'x2', {
-            value: x2,
-            writable: false
-        });
-        Object.defineProperty(this, 'x3', {
-            value: x3,
-            writable: false
-        });
+        // Define the coordinates as truly immutable: not writable AND not
+        // configurable, so they can't be reassigned, deleted or redefined. With
+        // useDefineForClassFields the field declarations above otherwise leave them
+        // configurable:true, letting `delete shape.x0` or a redefine defeat the
+        // read-only intent. They stay enumerable so they remain visible as the
+        // documented public properties (e.g. in JSON.stringify).
+        const coords = [
+            ['x0', x0],
+            ['x1', x1],
+            ['x2', x2],
+            ['x3', x3],
+        ];
+        for (const [name, value] of coords) {
+            Object.defineProperty(this, name, {
+                value,
+                writable: false,
+                enumerable: true,
+                configurable: false,
+            });
+        }
     }
 }
 exports.Shape = Shape;

package/lib/curve/shape.js.map

@@ -1 +1 @@
-{"version":3,"file":"shape.js","sourceRoot":"","sources":["../../src/curve/shape.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AACb,uCAAuC;AACvC,MAAsB,KAAK;IAChB,EAAE,CAAU;IACZ,EAAE,CAAU;IACZ,EAAE,CAAU;IACZ,EAAE,CAAU;IAErB;;;;;;OAMG;IACH,YAAY,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;YAChC,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;YAChC,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;YAChC,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;YAChC,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;IACL,CAAC;CAQF;AAtCD,sBAsCC"}
+{"version":3,"file":"shape.js","sourceRoot":"","sources":["../../src/curve/shape.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AAEb,uCAAuC;AACvC,MAAsB,KAAK;IAChB,EAAE,CAAU;IACZ,EAAE,CAAU;IACZ,EAAE,CAAU;IACZ,EAAE,CAAU;IAErB;;;;;;OAMG;IACH,YAAY,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU;QACxD,kEAAkE;QAClE,wEAAwE;QACxE,4EAA4E;QAC5E,wEAAwE;QACxE,uEAAuE;QACvE,yDAAyD;QACzD,MAAM,MAAM,GAA4B;YACtC,CAAC,IAAI,EAAE,EAAE,CAAC;YACV,CAAC,IAAI,EAAE,EAAE,CAAC;YACV,CAAC,IAAI,EAAE,EAAE,CAAC;YACV,CAAC,IAAI,EAAE,EAAE,CAAC;SACX,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;YACnC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;gBAChC,KAAK;gBACL,QAAQ,EAAE,KAAK;gBACf,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,KAAK;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CAQF;AA1CD,sBA0CC"}

package/lib/curve/sigmoid.d.ts

@@ -1,3 +1,4 @@
+import { Fuzzifier } from './fuzzifier';
 /**
  * Class representing a Sigmoid.
  * @example
@@ -5,13 +6,19 @@
  * sigmoid = new Sigmoid(0, 100000);
  * sigmoid2.fuzzify(10);
  */
-export declare class Sigmoid {
+export declare class Sigmoid implements Fuzzifier {
     private readonly center;
     private readonly slope;
     /**
      * Create a Sigmoid Function.
-     * @param {number} center - The center point of the sigmoid curve (where it outputs 0.5)
-     * @param {number} slope - The slope of the sigmoid curve (higher = steeper transition)
+     * @param {number} center - The center point of the sigmoid curve (where it outputs 0.5).
+     *   Must be finite.
+     * @param {number} slope - Width of the transition: it appears in the denominator
+     *   as 1 / (1 + exp(-(x - center) / slope)), so a smaller magnitude means a steeper
+     *   transition and a larger magnitude a gentler one. A **negative** slope inverts the
+     *   curve into a decreasing S (high membership below the center, low above). A slope of
+     *   `0` degenerates to an increasing step at the center (0.5 exactly at the center).
+     *   Must be finite; non-finite center/slope throw.
      */
     constructor(center?: number, slope?: number);
     /**

package/lib/curve/sigmoid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sigmoid.d.ts","sourceRoot":"","sources":["../../src/curve/sigmoid.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B;;;;OAIG;gBACS,MAAM,GAAE,MAAU,EAAE,KAAK,GAAE,MAAU;IAIjD;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;CAS3B"}
+{"version":3,"file":"sigmoid.d.ts","sourceRoot":"","sources":["../../src/curve/sigmoid.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC;;;;;;GAMG;AACH,qBAAa,OAAQ,YAAW,SAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B;;;;;;;;;;OAUG;gBACS,MAAM,GAAE,MAAU,EAAE,KAAK,GAAE,MAAU;IAajD;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;CAW3B"}

package/lib/curve/sigmoid.js

@@ -13,10 +13,25 @@ class Sigmoid {
     slope;
     /**
      * Create a Sigmoid Function.
-     * @param {number} center - The center point of the sigmoid curve (where it outputs 0.5)
-     * @param {number} slope - The slope of the sigmoid curve (higher = steeper transition)
+     * @param {number} center - The center point of the sigmoid curve (where it outputs 0.5).
+     *   Must be finite.
+     * @param {number} slope - Width of the transition: it appears in the denominator
+     *   as 1 / (1 + exp(-(x - center) / slope)), so a smaller magnitude means a steeper
+     *   transition and a larger magnitude a gentler one. A **negative** slope inverts the
+     *   curve into a decreasing S (high membership below the center, low above). A slope of
+     *   `0` degenerates to an increasing step at the center (0.5 exactly at the center).
+     *   Must be finite; non-finite center/slope throw.
      */
     constructor(center = 0, slope = 1) {
+        // Validate up front (like Constant/FuzzyFunction): a non-finite center or
+        // slope makes fuzzify return NaN, breaking the documented 0..1 contract and
+        // making defuzzify report no winner ('none') for an otherwise valid rule.
+        if (!Number.isFinite(center)) {
+            throw Error('Sigmoid center must be a finite number but is ' + center);
+        }
+        if (!Number.isFinite(slope)) {
+            throw Error('Sigmoid slope must be a finite number but is ' + slope);
+        }
         this.center = center;
         this.slope = slope;
     }
@@ -26,6 +41,9 @@ class Sigmoid {
      * @return {number} fuzzy output 0..1
      */
     fuzzify(x) {
+        // NaN has no meaningful membership; treat it as 0 instead of returning NaN.
+        if (Number.isNaN(x))
+            return 0;
         if (this.slope === 0) {
             // When slope is 0, sigmoid becomes a step function
             if (x < this.center)