@simcups/chance-utils 1.0.1 → 1.0.3

package/dist/chance.d.ts

@@ -1,6 +1,9 @@
+import { convertClampedRange, convertRange } from "./linear-scale";
 export declare function randomInteger(min: number, max: number): number;
 export declare function randomFloat(min: number, max: number): number;
 export declare function chance(likelihood?: number, max?: number): boolean;
 export declare function weightedBool(trueLikelihood: number, falseLikelihood: number): boolean;
 export declare function sample<T>(array: T[]): T;
+export declare function boolRange(...args: Parameters<typeof convertRange>): boolean;
+export declare function boolRangeClamp(...args: Parameters<typeof convertClampedRange>): boolean;
 //# sourceMappingURL=chance.d.ts.map

package/dist/chance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chance.d.ts","sourceRoot":"","sources":["../src/chance.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAErD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,wBAAgB,MAAM,CAAC,UAAU,GAAE,MAAW,EAAE,GAAG,GAAE,MAAU,GAAG,OAAO,CAExE;AAED,wBAAgB,YAAY,CAC1B,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,OAAO,CAET;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,CAUvC"}
+{"version":3,"file":"chance.d.ts","sourceRoot":"","sources":["../src/chance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,mBAAmB,EAAE,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAEjE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAErD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,wBAAgB,MAAM,CAAC,UAAU,GAAE,MAAW,EAAE,GAAG,GAAE,MAAU,GAAG,OAAO,CAExE;AAED,wBAAgB,YAAY,CAC1B,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,OAAO,CAET;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,CAUvC;AAED,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,WAEjE;AAED,wBAAgB,cAAc,CAC1B,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,WAGlD"}

package/dist/chance.js

@@ -1,5 +1,6 @@
 import { clampLikelihood } from "./clamp.js";
 import { weightedSample } from "./weighted-sample.js";
+import { convertClampedRange, convertRange } from "./linear-scale";
 export function randomInteger(min, max) {
     return Math.floor(Math.random() * (max - min + 1)) + min;
 }
@@ -22,4 +23,10 @@ export function sample(array) {
     }
     return item;
 }
+export function boolRange(...args) {
+    return chance(convertRange(...args));
+}
+export function boolRangeClamp(...args) {
+    return chance(convertClampedRange(...args));
+}
 //# sourceMappingURL=chance.js.map

package/dist/chance.js.map

@@ -1 +1 @@
-{"version":3,"file":"chance.js","sourceRoot":"","sources":["../src/chance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAEpD,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,GAAW;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,GAAW;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,8BAA8B;AAC1E,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,aAAqB,EAAE,EAAE,MAAc,CAAC;IAC7D,OAAO,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,cAAsB,EACtB,eAAuB;IAEvB,OAAO,cAAc,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC,CAAE,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,MAAM,CAAI,KAAU;IAClC,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAE1B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,kEAAkE;QAClE,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"chance.js","sourceRoot":"","sources":["../src/chance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAC,mBAAmB,EAAE,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAEjE,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,GAAW;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,GAAW;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,8BAA8B;AAC1E,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,aAAqB,EAAE,EAAE,MAAc,CAAC;IAC7D,OAAO,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,cAAsB,EACtB,eAAuB;IAEvB,OAAO,cAAc,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC,CAAE,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,MAAM,CAAI,KAAU;IAClC,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAE1B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,kEAAkE;QAClE,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAG,IAAqC;IAChE,OAAO,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,cAAc,CAC1B,GAAG,IAA4C;IAEjD,OAAO,MAAM,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './weighted-sample';
 export * from './chance';
 export * from "./clamp";
+export * from "./linear-scale";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './weighted-sample';
 export * from './chance';
 export * from "./clamp";
+export * from "./linear-scale";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA"}

package/dist/linear-scale.d.ts

@@ -0,0 +1,10 @@
+export declare function convertRange(value: number, r1: [number, number], // Using a Tuple type ensures at least 2 items
+r2: [number, number], enforceMinimum?: boolean): number;
+/**
+ * Maps a value between ranges and clamps the output.
+ */
+export declare function convertClampedRange(value: number, r1: [number, number], r2: [number, number], clampData?: {
+    min: number;
+    max: number;
+}): number;
+//# sourceMappingURL=linear-scale.d.ts.map

package/dist/linear-scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-scale.d.ts","sourceRoot":"","sources":["../src/linear-scale.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CACxB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,8CAA8C;AACpE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EACpB,cAAc,UAAO,GACtB,MAAM,CAYR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EACpB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EACpB,SAAS,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACzC,MAAM,CAWR"}

package/dist/linear-scale.js

@@ -0,0 +1,25 @@
+export function convertRange(value, r1, // Using a Tuple type ensures at least 2 items
+r2, enforceMinimum = true) {
+    const [low1, high1] = r1;
+    const [low2, high2] = r2;
+    // Avoid division by zero if r1 is a point instead of a range
+    const divisor = high1 - low1;
+    if (divisor === 0)
+        return low2;
+    const newValue = ((value - low1) * (high2 - low2)) / divisor + low2;
+    const rangeMin = Math.min(low2, high2);
+    return enforceMinimum ? Math.max(newValue, rangeMin) : newValue;
+}
+/**
+ * Maps a value between ranges and clamps the output.
+ */
+export function convertClampedRange(value, r1, r2, clampData) {
+    const [low2, high2] = r2;
+    // Fallback to r2 bounds if clampData isn't provided
+    const min = clampData?.min ?? Math.min(low2, high2);
+    const max = clampData?.max ?? Math.max(low2, high2);
+    const newValue = convertRange(value, r1, r2, false);
+    // Assuming you have your 'clamp' utility in the same library
+    return Math.min(Math.max(newValue, min), max);
+}
+//# sourceMappingURL=linear-scale.js.map

package/dist/linear-scale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-scale.js","sourceRoot":"","sources":["../src/linear-scale.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CACxB,KAAa,EACb,EAAoB,EAAE,8CAA8C;AACpE,EAAoB,EACpB,cAAc,GAAG,IAAI;IAErB,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IAEzB,6DAA6D;IAC7D,MAAM,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC;IAC7B,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/B,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAEvC,OAAO,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAC/B,KAAa,EACb,EAAoB,EACpB,EAAoB,EACpB,SAAwC;IAExC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IAEzB,oDAAoD;IACpD,MAAM,GAAG,GAAG,SAAS,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,SAAS,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAEpD,6DAA6D;IAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAClD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simcups/chance-utils",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Slim utility for weighted sampling, chance logic, and math clamping.",
   "type": "module",
   "main": "./dist/index.js",