@baleada/logic 0.20.25 → 0.20.29

package/lib/index.cjs

@@ -2719,6 +2719,7 @@ class Grantable {
 const defaultOptions$2 = {
   initialLocation: 0
 };
+const defaultNavigateOptions = { allow: "possible" };
 const defaultNextAndPreviousOptions = {
   distance: 1,
   loops: true
@@ -2758,28 +2759,33 @@ class Navigateable {
     this.navigate(location);
     return this;
   }
-  navigate(location) {
-    this._navigate(location);
+  navigate(location, options = {}) {
+    const { allow } = { ...defaultNavigateOptions, ...options };
+    this._navigate(location, { allow });
     this.navigated();
     return this;
   }
   navigated() {
     this.computedStatus = "navigated";
   }
-  _navigate(location) {
+  _navigate(location, options = {}) {
+    const { allow } = { ...defaultNavigateOptions, ...options };
     const ensuredLocation = (() => {
-      if (location < 0) {
-        return 0;
-      }
-      if (location > this.array.length - 1) {
-        return Math.max(this.array.length - 1, 0);
+      if (allow === "possible") {
+        if (location < 0 && allow === "possible") {
+          return 0;
+        }
+        if (location > this.array.length - 1) {
+          return Math.max(this.array.length - 1, 0);
+        }
       }
       return location;
     })();
     this.computedLocation = ensuredLocation;
   }
   next(options = {}) {
-    const { distance, loops } = { ...defaultNextAndPreviousOptions, ...options }, lastLocation = this.array.length - 1, newLocation = (() => {
+    const { distance, loops } = { ...defaultNextAndPreviousOptions, ...options }, newLocation = (() => {
+      const lastLocation = this.array.length - 1;
       if (this.location + distance <= lastLocation) {
         return this.location + distance;
       }

package/lib/index.d.ts

@@ -704,6 +704,13 @@ declare type NavigateableOptions = {
     initialLocation?: number;
 };
 declare type NavigateableStatus = 'ready' | 'navigated' | 'navigated to next' | 'navigated to previous' | 'navigated to random' | 'navigated to first' | 'navigated to last';
+declare type NavigateOptions = {
+    allow?: 'possible' | 'any';
+};
+declare type NextAndPreviousOptions = {
+    distance?: number;
+    loops?: boolean;
+};
 declare class Navigateable<Item> {
     constructor(array: Item[], options?: NavigateableOptions);
     private computedStatus;
@@ -718,18 +725,12 @@ declare class Navigateable<Item> {
     get item(): Item;
     setArray(array: Item[]): this;
     setLocation(location: number): this;
-    navigate(location: number): this;
+    navigate(location: number, options?: NavigateOptions): this;
     private navigated;
     private _navigate;
-    next(options?: {
-        distance?: number;
-        loops?: boolean;
-    }): this;
+    next(options?: NextAndPreviousOptions): this;
     private nexted;
-    previous(options?: {
-        distance?: number;
-        loops?: boolean;
-    }): this;
+    previous(options?: NextAndPreviousOptions): this;
     private previoused;
     random(): this;
     private randomed;

package/lib/index.js

@@ -2708,6 +2708,7 @@ class Grantable {
 const defaultOptions$2 = {
   initialLocation: 0
 };
+const defaultNavigateOptions = { allow: "possible" };
 const defaultNextAndPreviousOptions = {
   distance: 1,
   loops: true
@@ -2747,28 +2748,33 @@ class Navigateable {
     this.navigate(location);
     return this;
   }
-  navigate(location) {
-    this._navigate(location);
+  navigate(location, options = {}) {
+    const { allow } = { ...defaultNavigateOptions, ...options };
+    this._navigate(location, { allow });
     this.navigated();
     return this;
   }
   navigated() {
     this.computedStatus = "navigated";
   }
-  _navigate(location) {
+  _navigate(location, options = {}) {
+    const { allow } = { ...defaultNavigateOptions, ...options };
     const ensuredLocation = (() => {
-      if (location < 0) {
-        return 0;
-      }
-      if (location > this.array.length - 1) {
-        return Math.max(this.array.length - 1, 0);
+      if (allow === "possible") {
+        if (location < 0 && allow === "possible") {
+          return 0;
+        }
+        if (location > this.array.length - 1) {
+          return Math.max(this.array.length - 1, 0);
+        }
       }
       return location;
     })();
     this.computedLocation = ensuredLocation;
   }
   next(options = {}) {
-    const { distance, loops } = { ...defaultNextAndPreviousOptions, ...options }, lastLocation = this.array.length - 1, newLocation = (() => {
+    const { distance, loops } = { ...defaultNextAndPreviousOptions, ...options }, newLocation = (() => {
+      const lastLocation = this.array.length - 1;
       if (this.location + distance <= lastLocation) {
         return this.location + distance;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baleada/logic",
-  "version": "0.20.25",
+  "version": "0.20.29",
   "description": "UI logic for the Baleada toolkit",
   "main": "lib/index.cjs",
   "module": "lib/index.js",
@@ -66,7 +66,7 @@
     "@types/resize-observer-browser": "^0.1.5",
     "bezier-easing": "^2.1.0",
     "dompurify": "^2.2.6",
-    "fast-fuzzy": "^1.10.8",
+    "fast-fuzzy": "^1.11.1",
     "lazy-collections": "^0.8.0",
     "perfect-freehand": "^1.0.4",
     "polygon-clipping": "^0.15.3"