@thi.ng/fuzzy 2.1.80 → 2.1.82

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-04-23T07:02:18Z
+- **Last updated**: 2024-06-21T19:34:38Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 192 standalone projects, maintained as part
+> This is one of 193 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/fuzzy",
-  "version": "2.1.80",
+  "version": "2.1.82",
   "description": "Fuzzy logic operators & configurable rule inferencing engine",
   "type": "module",
   "module": "./index.js",
@@ -10,7 +10,7 @@
     "type": "git",
     "url": "https://github.com/thi-ng/umbrella.git"
   },
-  "homepage": "https://github.com/thi-ng/umbrella/tree/develop/packages/fuzzy#readme",
+  "homepage": "https://thi.ng/fuzzy",
   "funding": [
     {
       "type": "github",
@@ -36,14 +36,14 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.1",
-    "@thi.ng/math": "^5.10.12"
+    "@thi.ng/api": "^8.11.3",
+    "@thi.ng/math": "^5.11.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.43.0",
-    "esbuild": "^0.20.2",
-    "typedoc": "^0.25.12",
-    "typescript": "^5.4.3"
+    "@microsoft/api-extractor": "^7.47.0",
+    "esbuild": "^0.21.5",
+    "typedoc": "^0.25.13",
+    "typescript": "^5.5.2"
   },
   "keywords": [
     "agent",
@@ -92,9 +92,6 @@
     "./strategies/maxima": {
       "default": "./strategies/maxima.js"
     },
-    "./strategies/opts": {
-      "default": "./strategies/opts.js"
-    },
     "./tnorms": {
       "default": "./tnorms.js"
     },
@@ -105,5 +102,5 @@
   "thi.ng": {
     "year": 2020
   },
-  "gitHead": "5dd66c18a3862a3af69a5b2f49563f7cbdd960c2\n"
+  "gitHead": "154c95cf9d6bab32174498ec3b5b5d87e42be7f9\n"
 }

package/strategies/bisector.d.ts

@@ -12,10 +12,12 @@ import type { DefuzzStrategy, DefuzzStrategyOpts } from "../api.js";
  * Also see {@link DefuzzStrategyOpts}
  *
  * @example
- * ```ts
+ * ```ts tangle:../../export/bisector-strategy.ts
  * import { bisectorStrategy, trapezoid } from "@thi.ng/fuzzy";
  *
- * bisectorStrategy()(trapezoid(0,1,5,6), [0,6])
+ * console.log(
+ *   bisectorStrategy()(trapezoid(0,1,5,6), [0,6])
+ * );
  * // 2.97
  *
  * // ......▁█████████████|█████████████▁.....

package/strategies/bisector.js

@@ -1,7 +1,7 @@
 import { fit } from "@thi.ng/math/fit";
-import { defaultOpts } from "./opts.js";
+import { __defaultOpts } from "./opts.js";
 const bisectorStrategy = (opts) => {
-  let { samples } = defaultOpts(opts);
+  let { samples } = __defaultOpts(opts);
   return (fn, [min, max]) => {
     const delta = (max - min) / samples;
     let sum = [];
@@ -9,8 +9,7 @@ const bisectorStrategy = (opts) => {
       acc += fn(min + i * delta);
       sum.push(acc);
     }
-    if (!sum.length)
-      return min;
+    if (!sum.length) return min;
     const mean = sum[samples] * 0.5;
     for (let i = 1; i <= samples; i++) {
       if (sum[i] >= mean) {

package/strategies/centroid.d.ts

@@ -12,10 +12,12 @@ import type { DefuzzStrategy, DefuzzStrategyOpts } from "../api.js";
  * Also see {@link DefuzzStrategyOpts}
  *
  * @example
- * ```ts
+ * ```ts tangle:../../export/centroid-strategy.ts
  * import { centroidStrategy, trapezoid } from "@thi.ng/fuzzy";
  *
- * centroidStrategy()(trapezoid(0,1,5,6), [0,6])
+ * console.log(
+ *   centroidStrategy()(trapezoid(0,1,5,6), [0,6])
+ * );
  * // 3.0000000000000004
  *
  * // ......▁█████████████|█████████████▁.....

package/strategies/centroid.js

@@ -1,6 +1,6 @@
-import { defaultOpts } from "./opts.js";
+import { __defaultOpts } from "./opts.js";
 const centroidStrategy = (opts) => {
-  let { samples } = defaultOpts(opts);
+  let { samples } = __defaultOpts(opts);
   return (fn, [min, max]) => {
     const delta = (max - min) / samples;
     let num = 0;

package/strategies/maxima.d.ts

@@ -9,10 +9,12 @@ import type { DefuzzStrategy, DefuzzStrategyOpts } from "../api.js";
  * Also see {@link DefuzzStrategyOpts}
  *
  * @example
- * ```ts
+ * ```ts tangle:../../export/mean-of-maxima-strategy.ts
  * import { meanOfMaximaStrategy, trapezoid } from "@thi.ng/fuzzy";
  *
- * meanOfMaximaStrategy()(trapezoid(0,1,5,6), [0,6])
+ * console.log(
+ *   meanOfMaximaStrategy()(trapezoid(0,1,5,6), [0,6])
+ * );
  * // 3
  *
  * // ......▁█████████████|█████████████▁.....
@@ -40,10 +42,12 @@ export declare const meanOfMaximaStrategy: (opts?: Partial<DefuzzStrategyOpts>)
  * Also see {@link DefuzzStrategyOpts}
  *
  * @example
- * ```ts
+ * ```ts tangle:../../export/first-of-maxima-strategy.ts
  * import { firstOfMaximaStrategy, trapezoid } from "@thi.ng/fuzzy";
  *
- * firstOfMaximaStrategy()(trapezoid(0,1,5,6), [0,6])
+ * console.log(
+ *   firstOfMaximaStrategy()(trapezoid(0,1,5,6), [0,6])
+ * );
  * // 1.02
  *
  * // ......▁|██████████████████████████▁.....
@@ -71,10 +75,12 @@ export declare const firstOfMaximaStrategy: (opts?: Partial<DefuzzStrategyOpts>)
  * Also see {@link DefuzzStrategyOpts}
  *
  * @example
- * ```ts
+ * ```ts tangle:../../export/last-of-maxima-strategy.ts
  * import { lastOfMaximaStrategy, trapezoid } from "@thi.ng/fuzzy";
  *
- * lastOfMaximaStrategy()(trapezoid(0,1,5,6), [0,6])
+ * console.log(
+ *   lastOfMaximaStrategy()(trapezoid(0,1,5,6), [0,6])
+ * );
  * // 4.98
  *
  * // ......▁██████████████████████████|▁.....

package/strategies/maxima.js

@@ -1,7 +1,7 @@
 import { eqDelta } from "@thi.ng/math/eqdelta";
-import { defaultOpts } from "./opts.js";
+import { __defaultOpts } from "./opts.js";
 const meanOfMaximaStrategy = (opts) => {
-  const { samples, eps } = defaultOpts(opts);
+  const { samples, eps } = __defaultOpts(opts);
   return (fn, [min, max]) => {
     const delta = (max - min) / samples;
     let peak = -Infinity;
@@ -23,7 +23,7 @@ const meanOfMaximaStrategy = (opts) => {
   };
 };
 const firstOfMaximaStrategy = (opts) => {
-  const { samples } = defaultOpts(opts);
+  const { samples } = __defaultOpts(opts);
   return (fn, [min, max]) => {
     const delta = (max - min) / samples;
     let peak = -Infinity;

package/strategies/opts.d.ts

@@ -1,3 +1,4 @@
 import type { DefuzzStrategyOpts } from "../api.js";
-export declare const defaultOpts: (opts?: Partial<DefuzzStrategyOpts>) => DefuzzStrategyOpts;
+/** @internal */
+export declare const __defaultOpts: (opts?: Partial<DefuzzStrategyOpts>) => DefuzzStrategyOpts;
 //# sourceMappingURL=opts.d.ts.map

package/strategies/opts.js

@@ -1,8 +1,8 @@
-const defaultOpts = (opts) => ({
+const __defaultOpts = (opts) => ({
   samples: 100,
   eps: 1e-6,
   ...opts
 });
 export {
-  defaultOpts
+  __defaultOpts
 };

package/var.d.ts

@@ -1,5 +1,5 @@
 import type { Maybe } from "@thi.ng/api";
-import type { LVar } from "./api.js";
+import type { LVar, LVarDomain } from "./api.js";
 /**
  * Takes a `domain` interval and on object of named fuzzy sets and returns a new
  * Linguistic variable, which can then be used as input or output var for
@@ -21,7 +21,7 @@ import type { LVar } from "./api.js";
  * @param domain -
  * @param terms -
  */
-export declare const variable: <K extends string>(domain: import("@thi.ng/api").Range, terms: LVar<K>["terms"]) => LVar<K>;
+export declare const variable: <K extends string>(domain: LVarDomain, terms: LVar<K>["terms"]) => LVar<K>;
 /**
  * Takes an LVar and a domain value `x`. Returns the ID of the var's fuzzy set
  * term which yields the max truth value for given `x`. If `threshold` is
@@ -29,7 +29,7 @@ export declare const variable: <K extends string>(domain: import("@thi.ng/api").
  * considered. The function returns undefined if classification failed.
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/classify.ts
  * import { classify, variable, invSigmoid, sigmoid, trapezoid } from "@thi.ng/fuzzy";
  *
  * // temperature sets (in celsius)
@@ -40,7 +40,7 @@ export declare const variable: <K extends string>(domain: import("@thi.ng/api").
  *   hot: sigmoid(30, 2)
  * });
  *
- * classify(temp, 28)
+ * console.log(classify(temp, 28));
  * // "warm"
  * ```
  *
@@ -54,7 +54,7 @@ export declare const classify: <K extends string>({ terms }: LVar<K>, x: number,
  * `x` and returns object of results.
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/evaluate.ts
  * import { evaluate, variable, invSigmoid, sigmoid, trapezoid } from "@thi.ng/fuzzy";
  *
  * // temperature sets (in celsius)
@@ -65,7 +65,7 @@ export declare const classify: <K extends string>({ terms }: LVar<K>, x: number,
  *   hot: sigmoid(30, 2)
  * });
  *
- * evaluate(temp, 28)
+ * console.log(evaluate(temp, 28));
  * // { freezing: 0, cold: 0, warm: 0.4, hot: 0.01798620996209156 }
  * ```
  *

package/var.js

@@ -2,7 +2,7 @@ const variable = (domain, terms) => ({
   domain,
   terms
 });
-const classify = ({ terms }, x, threshold = 0.5) => {
+const classify = ({ terms }, x, threshold = 0) => {
   let max = threshold;
   let maxID;
   for (let id in terms) {