@kizmann/pico-js 2.0.11 → 2.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kizmann/pico-js",
-    "version": "2.0.11",
+    "version": "2.0.13",
     "license": "MIT",
     "type": "module",
     "private": false,

package/src/now/NowDefault.ts

@@ -81,6 +81,10 @@ export class PicoNowDefault
      */
     set(value : any, scope : string) : PicoNow
     {
+        if ( value == null) {
+            return <PicoNow> <unknown> this;
+        }
+
         if ( !Mix.isNum(value) ) {
             value = Mix.int(value);
         }

package/src/now/NowFormat.ts

@@ -70,6 +70,7 @@ export class PicoNowFormat
             format = 'YYYY-MM-DD';
         }
 
+
         if ( this.isModifible(value) ) {
             return this.modify(value);
         }

package/src/now/NowGrid.ts

@@ -1,5 +1,5 @@
 import { Arr } from "../index.esm.ts";
-import { PicoNowInterface } from "../utils/Now.ts";
+import { PicoNow, PicoNowInterface } from "../utils/Now.ts";
 import PicoNowWalker from "./NowWalker.js";
 
 export interface PicoNowGrid extends PicoNowInterface,
@@ -19,9 +19,9 @@ export class PicoNowGrid
      * @example Now.grid("month") // => [Now, Now, ...]
      *
      * @param {string} [scope] Grid scope
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    grid(scope : string = 'day') : Array<PicoNowInterface>
+    grid(scope : string = 'day') : Array<PicoNow>
     {
         if ( /^seconds?$/i.test(scope) ) {
             return this.getSecondsGrid();
@@ -64,9 +64,9 @@ export class PicoNowGrid
      * @example Now.getSecondsGrid(10)
      *
      * @param {number} [interval] Step interval
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getSecondsGrid(interval : number = 1) : Array<PicoNowInterface>
+    getSecondsGrid(interval : number = 1) : Array<PicoNow>
     {
         if ( interval == null ) {
             interval = 1;
@@ -83,9 +83,9 @@ export class PicoNowGrid
      * @example Now.getMinutesGrid(10)
      *
      * @param {number} [interval] Step interval
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getMinutesGrid(interval : number = 1) : Array<PicoNowInterface>
+    getMinutesGrid(interval : number = 1) : Array<PicoNow>
     {
         if ( interval == null ) {
             interval = 1;
@@ -102,9 +102,9 @@ export class PicoNowGrid
      * @example Now.getHoursGrid(2)
      *
      * @param {number} [interval] Step interval
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getHoursGrid(interval : number = 1) : Array<PicoNowInterface>
+    getHoursGrid(interval : number = 1) : Array<PicoNow>
     {
         if ( interval == null ) {
             interval = 1;
@@ -120,9 +120,9 @@ export class PicoNowGrid
      *
      * @example Now.getDaysGrid()
      *
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getDaysGrid() : Array<PicoNowInterface>
+    getDaysGrid() : Array<PicoNow>
     {
         let dates = [
             this.first('date').first('day'), this.last('date').last('day')
@@ -136,9 +136,9 @@ export class PicoNowGrid
      *
      * @example Now.getDatesGrid()
      *
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getDatesGrid() : Array<PicoNowInterface>
+    getDatesGrid() : Array<PicoNow>
     {
         let dates = [
             this.first('date'), this.last('date')
@@ -152,9 +152,9 @@ export class PicoNowGrid
      *
      * @example Now.getMonthsGrid()
      *
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getMonthsGrid() : Array<PicoNowInterface>
+    getMonthsGrid() : Array<PicoNow>
     {
         let dates = [
             this.first('month'), this.last('month')
@@ -168,9 +168,9 @@ export class PicoNowGrid
      *
      * @example Now.getYearsGrid()
      *
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getYearsGrid() : Array<PicoNowInterface>
+    getYearsGrid() : Array<PicoNow>
     {
         let dates = [
             this.first('year'), this.clone().last('year')
@@ -184,9 +184,9 @@ export class PicoNowGrid
      *
      * @example Now.getDecadesGrid()
      *
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getDecadesGrid() : Array<PicoNowInterface>
+    getDecadesGrid() : Array<PicoNow>
     {
         let dates = [
             this.first('decade'), this.clone().last('decade')
@@ -201,7 +201,7 @@ export class PicoNowGrid
  * @deprecated use Now.grid instead
  */
 // @ts-ignore
-PicoNowGrid.prototype.getYears = function() : Array<PicoNowInterface> {
+PicoNowGrid.prototype.getYears = function() : Array<PicoNow> {
     console.warn('Now.getYears() is deprecated, use Now.grid(\'years\') instead.');
     return this.grid('years');
 };
@@ -210,7 +210,7 @@ PicoNowGrid.prototype.getYears = function() : Array<PicoNowInterface> {
  * @deprecated use Now.grid instead
  */
 // @ts-ignore
-PicoNowGrid.prototype.getMonths = function() : Array<PicoNowInterface> {
+PicoNowGrid.prototype.getMonths = function() : Array<PicoNow> {
     console.warn('Now.getMonths() is deprecated, use Now.grid(\'months\') instead.');
     return this.grid('months');
 };
@@ -219,7 +219,7 @@ PicoNowGrid.prototype.getMonths = function() : Array<PicoNowInterface> {
  * @deprecated use Now.grid instead
  */
 // @ts-ignore
-PicoNowGrid.prototype.getDates = function() : Array<PicoNowInterface> {
+PicoNowGrid.prototype.getDates = function() : Array<PicoNow> {
     console.warn('Now.getDates() is deprecated, use Now.grid(\'dates\') instead.');
     return this.grid('dates');
 };
@@ -228,7 +228,7 @@ PicoNowGrid.prototype.getDates = function() : Array<PicoNowInterface> {
  * @deprecated use Now.grid instead
  */
 // @ts-ignore
-PicoNowGrid.prototype.getHours = function() : Array<PicoNowInterface> {
+PicoNowGrid.prototype.getHours = function() : Array<PicoNow> {
     console.warn('Now.getHours() is deprecated, use Now.grid(\'hours\') instead.');
     return this.grid('hours');
 };
@@ -237,7 +237,7 @@ PicoNowGrid.prototype.getHours = function() : Array<PicoNowInterface> {
  * @deprecated use Now.grid instead
  */
 // @ts-ignore
-PicoNowGrid.prototype.getMinutes = function() : Array<PicoNowInterface> {
+PicoNowGrid.prototype.getMinutes = function() : Array<PicoNow> {
     console.warn('Now.getMinutes() is deprecated, use Now.grid(\'minutes\') instead.');
     return this.grid('minutes');
 };
@@ -246,7 +246,7 @@ PicoNowGrid.prototype.getMinutes = function() : Array<PicoNowInterface> {
  * @deprecated use Now.grid instead
  */
 // @ts-ignore
-PicoNowGrid.prototype.getSeconds = function() : Array<PicoNowInterface> {
+PicoNowGrid.prototype.getSeconds = function() : Array<PicoNow> {
     console.warn('Now.getSeconds() is deprecated, use Now.grid(\'seconds\') instead.');
     return this.grid('seconds');
 };

package/src/now/NowHuman.ts

@@ -66,7 +66,7 @@ export class PicoNowHuman
      */
     getHumanDay(substr : number = null) : string
     {
-        let day = this.day() - 1;
+        let day = this.day();
 
         if ( !NOW_HUMAN_DAYS[day] ) {
             throw new Error(`Invalid day number "${day}".`);
@@ -91,7 +91,7 @@ export class PicoNowHuman
      */
     getHumanMonth(substr : number = null) : string
     {
-        let month = this.day() - 1;
+        let month = this.month() - 1;
 
         if ( !NOW_HUMAN_MONTHS[month] ) {
             throw new Error(`Invalid month number "${month}".`);

package/src/utils/Now.ts

@@ -62,9 +62,9 @@ export class PicoNow extends trait(PicoNowPlugins)
     /**
      * Original input value
      *
-     * @type {any}
+     * @type {Date}
      */
-    input : any = null;
+    input : Date = null;
 
     /**
      * Current Date instance
@@ -195,7 +195,8 @@ export class PicoNow extends trait(PicoNowPlugins)
      */
     valid() : boolean
     {
-        return !isNaN(this.input);
+        // @ts-ignore
+        return !isNaN(this.input) && !isNaN(this.value);
     }
 
     /**

package/src/utils/Number.ts

@@ -111,6 +111,32 @@ export class PicoNumber
         return Math.round(value);
     }
 
+    /**
+     * Keep value within min and max range
+     *
+     * @example Num.minmax(10, 0, 5) // => 0
+     * @example Num.minmax(-1, 0, 5) // => 5
+     *
+     * @param {any} value Input value
+     * @param {number} [min=0] Minimum value
+     * @param {number} [max=Number.MAX_SAFE_INTEGER] Maximum value
+     * @returns {number} Normalized value
+     */
+    static minmax(value : any, min : number = 0, max : number = Number.MAX_SAFE_INTEGER) : number
+    {
+        value = Mix.num(value);
+
+        if ( value < min ) {
+            value = max;
+        }
+
+        if ( value > max ) {
+            value = min;
+        }
+
+        return Mix.num(value);
+    }
+
     /**
      * Sum numbers in list
      *

package/types/now/NowGrid.d.ts

@@ -1,4 +1,4 @@
-import { PicoNowInterface } from "../utils/Now.ts";
+import { PicoNow, PicoNowInterface } from "../utils/Now.ts";
 import PicoNowWalker from "./NowWalker.js";
 export interface PicoNowGrid extends PicoNowInterface, PicoNowWalker {
 }
@@ -12,75 +12,75 @@ export declare class PicoNowGrid {
      * @example Now.grid("month") // => [Now, Now, ...]
      *
      * @param {string} [scope] Grid scope
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    grid(scope?: string): Array<PicoNowInterface>;
+    grid(scope?: string): Array<PicoNow>;
     /**
      * Get seconds grid
      *
      * @example Now.getSecondsGrid(10)
      *
      * @param {number} [interval] Step interval
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getSecondsGrid(interval?: number): Array<PicoNowInterface>;
+    getSecondsGrid(interval?: number): Array<PicoNow>;
     /**
      * Get minutes grid
      *
      * @example Now.getMinutesGrid(10)
      *
      * @param {number} [interval] Step interval
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getMinutesGrid(interval?: number): Array<PicoNowInterface>;
+    getMinutesGrid(interval?: number): Array<PicoNow>;
     /**
      * Get hours grid
      *
      * @example Now.getHoursGrid(2)
      *
      * @param {number} [interval] Step interval
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getHoursGrid(interval?: number): Array<PicoNowInterface>;
+    getHoursGrid(interval?: number): Array<PicoNow>;
     /**
      * Get days grid
      *
      * @example Now.getDaysGrid()
      *
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getDaysGrid(): Array<PicoNowInterface>;
+    getDaysGrid(): Array<PicoNow>;
     /**
      * Get dates grid
      *
      * @example Now.getDatesGrid()
      *
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getDatesGrid(): Array<PicoNowInterface>;
+    getDatesGrid(): Array<PicoNow>;
     /**
      * Get months grid
      *
      * @example Now.getMonthsGrid()
      *
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getMonthsGrid(): Array<PicoNowInterface>;
+    getMonthsGrid(): Array<PicoNow>;
     /**
      * Get years grid
      *
      * @example Now.getYearsGrid()
      *
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getYearsGrid(): Array<PicoNowInterface>;
+    getYearsGrid(): Array<PicoNow>;
     /**
      * Get decades grid
      *
      * @example Now.getDecadesGrid()
      *
-     * @returns {Array<PicoNowInterface>} Array of dates
+     * @returns {Array<PicoNow>} Array of dates
      */
-    getDecadesGrid(): Array<PicoNowInterface>;
+    getDecadesGrid(): Array<PicoNow>;
 }
 export default PicoNowGrid;

package/types/utils/Now.d.ts

@@ -38,9 +38,9 @@ export declare class PicoNow extends PicoNow_base {
     /**
      * Original input value
      *
-     * @type {any}
+     * @type {Date}
      */
-    input: any;
+    input: Date;
     /**
      * Current Date instance
      *

package/types/utils/Number.d.ts

@@ -60,6 +60,18 @@ export declare class PicoNumber {
      * @returns {number} Rounded value
      */
     static round(value: any): number;
+    /**
+     * Keep value within min and max range
+     *
+     * @example Num.minmax(10, 0, 5) // => 0
+     * @example Num.minmax(-1, 0, 5) // => 5
+     *
+     * @param {any} value Input value
+     * @param {number} [min=0] Minimum value
+     * @param {number} [max=Number.MAX_SAFE_INTEGER] Maximum value
+     * @returns {number} Normalized value
+     */
+    static minmax(value: any, min?: number, max?: number): number;
     /**
      * Sum numbers in list
      *