es6-fuzz 6.0.8 → 7.0.1

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

@@ -1,107 +1,96 @@
-# es6-fuzz 
+# es6-fuzz
 
-> Fuzzy Logic in Javascript
+> 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)
 [![GitHub issues](https://img.shields.io/github/issues/sebs/es6-fuzz.svg)](https://github.com/sebs/es6-fuzz/issues)
 
-## Supported fuzzyfiers
+## Supported Fuzzifiers
 
-* Constant
-* Grade
-* Reverse Grade
-* Sigmoid
-* Trapezoid
-* Triangle
+* **Constant** - Fixed membership value
+* **Grade** - Linear membership function
+* **Reverse Grade** - Inverted linear membership
+* **Sigmoid** - S-shaped membership curve
+* **Trapezoid** - Trapezoidal membership function
+* **Triangle** - Triangular membership functionve
+## Documentation
 
-* [api docs](http://sebs.github.io/es6-fuzz)
-* [changelog](https://github.com/sebs/es6-fuzz/blob/master/docs/CHANGELOG.md)
+* [API Documentation](http://sebs.github.io/es6-fuzz)
+* [Changelog](https://github.com/sebs/es6-fuzz/releases)
 
-## Install and Usage
+## Installation
 
-es6-fuzz is available as a NPM package.
-
-```
+```bash
 npm install es6-fuzz
 ```
-## Example
+
+## Quick Start
 
 ```javascript
-var logic = new Logic();
-var res = logic
+const { Logic, Triangle, Trapezoid, Grade } = require('es6-fuzz');
+
+const logic = new Logic();
+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.toString()); // 'enragedAttack'
 ```
-* enraged attack
 
-## Example 2
+## Temperature Example
 
 <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/6/61/Fuzzy_logic_temperature_en.svg/300px-Fuzzy_logic_temperature_en.svg.png" />
 
 ```javascript
-var Trapezoid = require('./lib/curve/trapezoid');
+const { Logic, Trapezoid } = require('es6-fuzz');
 
-var logic = new Logic();
-var res = logic
+const logic = new Logic();
+const result = logic
   .init('cold', new Trapezoid(0, 12, 18, 20))   
   .or('hot', new Trapezoid(12, 14, 16, 100)) 
   .defuzzify(20);
 
+console.log(result.toString()); // 'hot'
 ```
 
-* hot
-
 
-## Usage with boon-js
+## Advanced Usage with boon-js
 
-In order to combine 2 fuzzy functions with boolean logic, there is a compat layer for boon-js which allows the sauge of 'boolean expression language'. 
-
-Example of a monster biting when its cold and you are close to it: 
- 
-
-Heat part:
-
-```js
-var logicHeat = new Logic();
-const optimalTemperature = new Triangle(10, 20, 30);
-const toColdTemperature = new Triangle(0, 10, 15);
-const toHotTemperature = new Triangle(25, 40, 60);
-
-logicHeat.init('cold', toColdTemperature)
-logicHeat.or('optimal', optimalTemperature)
-logicHeat.or('hot', toHotTemperature);
-```
+Combine multiple fuzzy functions with boolean logic using the boon-js compatibility layer.
 
-Distance Part
+### Example: Monster AI
 
-```js
+A monster that bites when it's cold AND you're close to it:
 
-var logicDistance = new Logic();
-const close = new Triangle(0, 10, 20);
-const far = new Triangle(5, 50, 100);
+```javascript
+const { Logic, Triangle } = require('es6-fuzz');
+const { getEvaluator } = require('boon-js');
 
-logicDistance.init('close', close)
-logicDistance.or('far', far)
+// Temperature logic
+const logicHeat = new Logic();
+logicHeat.init('cold', new Triangle(0, 10, 15))
+  .or('optimal', new Triangle(10, 20, 30))
+  .or('hot', new Triangle(25, 40, 60));
 
-```
+// Distance logic  
+const logicDistance = new Logic();
+logicDistance.init('close', new Triangle(0, 10, 20))
+  .or('far', new Triangle(5, 50, 100));
 
-Now we marry the 2 and use boon js
+// Combine with boolean logic
+const monsterBiteTest = getEvaluator('heat.cold AND distance.close');
 
-```js
-const monsterBiteTest = getEvaluator(
-    'heat.cold AND distance.close',
-);
 const resHeat = logicHeat.defuzzify(2, 'heat');
 const resClose = logicDistance.defuzzify(2, 'distance');
 
-const jsBoonInput = { ...resHeat.boonJsInputs, ...resClose.boonJsInputs }
+const jsBoonInput = { ...resHeat.boonJsInputs, ...resClose.boonJsInputs };
 
-monsterBiteTest(jsBoonInput) 
-// returns true
+console.log(monsterBiteTest(jsBoonInput)); // true
 ```
 
     
@@ -110,24 +99,46 @@ monsterBiteTest(jsBoonInput)
 
 
 
-## development
+## Development
+
+### Running Tests
+
+```bash
+npm test               # build + run the test suite
+npm run test:coverage  # same, with a coverage report
+```
 
-**Tests** use node internal testing framework
+### Building Documentation
 
+```bash
+npm run docs    # Generate the TypeDoc API site into ./out
 ```
-npm test
+
+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
 ```
 
-* docs: npm run docs, npm run docs:site
+Open `examples/index.html` in a browser to see the membership curves.
+
+## Requirements
 
-# Stuff
-* http://de.slideshare.net/BCSLeicester/fuzzy-logic-in-the-real-world-2326817
-* http://computing.dcu.ie/~humphrys/Notes/Neural/sigmoid.html
+* Node.js 22+
 
-## Supported Node.js Versions
+## Resources
 
-Versions: 20+
+* [Fuzzy Logic in the Real World](http://de.slideshare.net/BCSLeicester/fuzzy-logic-in-the-real-world-2326817)
+* [Understanding Sigmoid Functions](http://computing.dcu.ie/~humphrys/Notes/Neural/sigmoid.html)
 
-## Related
+## Related Projects
 
-* https://www.npmjs.com/package/gaussian
+* [gaussian](https://www.npmjs.com/package/gaussian) - Gaussian distribution functions

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;CAO7B"}

package/lib/curve/fuzzy-function.js

@@ -20,7 +20,7 @@ class FuzzyFunction {
         if (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,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,KAAK,CAAC,kDAAkD,GAAG,GAAG,CAAC,CAAC;IACxE,CAAC;CACF;AArBD,sCAqBC"}

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;IAGlC;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAqB7B"}

package/lib/curve/grade.js

@@ -8,6 +8,14 @@ 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);
+    }
     /**
      * Fuzzify
      * @param {number} val - Point on X axis
@@ -16,11 +24,13 @@ class Grade extends shape_1.Shape {
     fuzzify(val) {
         let result = 0;
         const x = val;
-        // Handle case where x0 = x1 (vertical grade/step function)
+        // 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 +39,7 @@ class Grade extends shape_1.Shape {
             result = 1;
         }
         else {
-            result = (x / (this.x1 - this.x0)) - (this.x0 / (this.x1 - this.x0));
+            result = x / (this.x1 - this.x0) - 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;IACxB,CAAC;IACD;;;;OAIG;IACH,OAAO,CAAC,GAAW;QACjB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,MAAM,CAAC,GAAG,GAAG,CAAC;QAEd,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,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAnCD,sBAmCC"}

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;IAGlC;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAe7B"}

package/lib/curve/reverse-grade.js

@@ -2,32 +2,40 @@
 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);
+    }
     /**
      * 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));
-            }
+        // 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;
+        return -x / (this.x1 - this.x0) + this.x1 / (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;IACxB,CAAC;IACD;;;;OAIG;IACH,OAAO,CAAC,GAAW;QACjB,MAAM,CAAC,GAAG,GAAG,CAAC;QAEd,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,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;CACF;AA7BD,oCA6BC"}

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;IAmB1D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CACtC"}

package/lib/curve/shape.js

@@ -17,19 +17,19 @@ class Shape {
     constructor(x0, x1, x2, x3) {
         Object.defineProperty(this, 'x0', {
             value: x0,
-            writable: false
+            writable: false,
         });
         Object.defineProperty(this, 'x1', {
             value: x1,
-            writable: false
+            writable: false,
         });
         Object.defineProperty(this, 'x2', {
             value: x2,
-            writable: false
+            writable: false,
         });
         Object.defineProperty(this, 'x3', {
             value: x3,
-            writable: false
+            writable: false,
         });
     }
 }

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,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"}