@kizmann/pico-js 2.0.13 → 2.1.0

package/package.json

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

package/src/index.esm.ts

@@ -28,12 +28,12 @@ export {
 }
 
 // Work in progress (not started yet)
-// import { default as Map } from "./wip/Map.ts";
-// import { default as Element } from "./wip/Element.ts";
+import { default as Map } from "./wip/Map.ts";
+import { default as Element } from "./wip/Element.ts";
 
-// export {
-//     Map, Element
-// }
+export {
+    Map, Element
+}
 
 /**
  * @type {Mix}

package/src/now/NowDefault.ts

@@ -20,11 +20,36 @@ export interface PicoNowDefault extends PicoNowInterface
  */
 export class PicoNowDefault
 {
-    static test(value : any) : boolean
+    calc(value : any, scope : string) : PicoNow
     {
-        return value instanceof Date;
-    }
+        if ( ! Mix.isNum(value) ) {
+            value = Mix.int(value);
+        }
+
+        let result = 0;
+
+        if ( /^seconds?$/i.test(scope) ) {
+            result = value * 1000;
+        }
+
+        if ( /^minutes?$/i.test(scope) ) {
+            result = value * 1000 * 60;
+        }
+
+        if ( /^hours?$/i.test(scope) ) {
+            result = value * 1000 * 60 * 60;
+        }
+
+        if ( /^dates?$/i.test(scope) ) {
+            result = value * 1000 * 60 * 60 * 24;
+        }
+
+        this.value.setTime(...[
+            this.value.getTime() + result
+        ]);
 
+        return <PicoNow> <unknown> this;
+    }
     /**
      * Get value by scope
      *
@@ -293,6 +318,22 @@ export class PicoNowDefault
             scope = 'date';
         }
 
+        if ( /^seconds?$/i.test(scope) ) {
+            return this.calc(value, scope);
+        }
+
+        if ( /^minutes?$/i.test(scope) ) {
+            return this.calc(value, scope);
+        }
+
+        if ( /^hours?$/i.test(scope) ) {
+            return this.calc(value, scope);
+        }
+
+        if ( /^dates?$/i.test(scope) ) {
+            return this.calc(value, scope);
+        }
+
         this.set(this.get(scope) + Mix.int(value), scope);
 
         return <PicoNow> <unknown> this;
@@ -313,7 +354,25 @@ export class PicoNowDefault
             scope = 'date';
         }
 
-        this.set(this.get(scope) - Mix.int(value), scope);
+        if ( /^seconds?$/i.test(scope) ) {
+            return this.calc(value * -1, scope);
+        }
+
+        if ( /^minutes?$/i.test(scope) ) {
+            return this.calc(value * -1, scope);
+        }
+
+        if ( /^hours?$/i.test(scope) ) {
+            return this.calc(value * -1, scope);
+        }
+
+        if ( /^dates?$/i.test(scope) ) {
+            return this.calc(value * -1, scope);
+        }
+
+        this.set(...[
+            this.get(scope) - Mix.int(value), scope
+        ]);
 
         return <PicoNow> <unknown> this;
     }

package/src/now/NowDuration.ts

@@ -0,0 +1,122 @@
+import { Arr, Mix, Now, Obj, Str } from "../index.esm.ts";
+import { PicoNow, PicoNowInterface } from "../utils/Now.ts";
+import PicoNowDefault from "./NowDefault.ts";
+import PicoNowFormat from "./NowFormat.ts";
+
+export interface PicoNowDuration extends PicoNowInterface,
+    PicoNowDefault,
+    PicoNowFormat
+{
+    //
+}
+
+/**
+ * @memberof PicoNow
+ */
+export class PicoNowDuration
+{
+
+    /**
+     * Calculate duration between two dates
+     *
+     * @example Now.make("2026-01-01").duration("2026-02-01") // => { years: 0, months: 1, ... }
+     *
+     * @param {any} value End date
+     * @returns {any} Duration object
+     */
+    duration(value : any) : any
+    {
+        if ( Mix.isNum(value) ) {
+            value = this.clone().add(value, 'seconds');
+        }
+
+        const date = Now.make(value);
+
+        const keys = [
+            'years', 'months', 'dates', 'hours', 'minutes', 'seconds'
+        ];
+
+        let result : any = {};
+
+        Arr.each(keys, (key : string) => {
+            result[key] = date.get(key) - this.get(key);
+        });
+
+        const last = date.clone().sub(1, 'month')
+            .last('date').date();
+
+        if ( result.minutes && result.seconds < 0 ) {
+            result.minutes -= 1, result.seconds += 60;
+        }
+
+        if ( result.hours && result.minutes < 0 ) {
+            result.hours -= 1, result.minutes += 60;
+        }
+
+        if ( result.dates && result.hours < 0 ) {
+            result.dates -= 1, result.hours += 24;
+        }
+
+        if ( result.months && result.dates < 0 ) {
+            result.months -= 1, result.dates += last;
+        }
+
+        if ( result.years && result.months < 0 ) {
+            result.years -= 1, result.months += 12;
+        }
+
+        return result;
+    }
+
+    /**
+     * Normalize seconds into duration parts
+     *
+     * @example Now.make().safeDuration(3661) // => { dates: 0, hours: 1, minutes: 1, seconds: 1 }
+     *
+     * @param {number} value Seconds value
+     * @returns {any} Duration object
+     */
+    safeDuration(value : number) : any
+    {
+        let result : any = {
+            dates: 0,
+            hours: 0,
+            minutes: 0,
+            seconds: Mix.int(value)
+        };
+
+        if ( result.seconds >= 60 ) {
+            result.minutes = Math.floor(result.seconds / 60);
+            result.seconds %= 60;
+        }
+
+        if ( result.minutes >= 60 ) {
+            result.hours = Math.floor(result.minutes / 60);
+            result.minutes %= 60;
+        }
+
+        if ( result.hours >= 24 ) {
+            result.dates = Math.floor(result.hours / 24);
+            result.hours %= 24;
+        }
+
+        return result;
+    }
+
+    /**
+     * Get difference between two dates in seconds
+     *
+     * @example Now.make("2026-01-02").diffrence("2026-01-01") // => 86400
+     *
+     * @param {any} [value=null] Compare date
+     * @returns {number} Seconds difference
+     */
+    diffrence(value : any = null) : number
+    {
+        return this.code('x') - Now.make(value).code('x');
+    }
+
+}
+
+
+export default PicoNowDuration;

package/src/utils/Array.ts

@@ -107,7 +107,7 @@ export class PicoArray
             return 0;
         }
 
-        if ( index + 1 > target.length ) {
+        if ( index + 1 > target.length - 1 ) {
             return 0;
         }
 

package/src/utils/Dom.ts

@@ -28,11 +28,35 @@ export const PicoDomPlugins = [
 
 export interface PicoDomInterface
 {
+    /**
+     * @type {any}
+     */
     el: any;
+
+    /**
+     * @type {any[]}
+     */
     els: any[];
+
+    /**
+     * @param {Function} plugin
+     * @returns {void}
+     */
     extend(plugin : Function) : void;
+
+    /**
+     * @returns {any}
+     */
     win() : any;
+
+    /**
+     * @returns {any}
+     */
     doc() : any;
+
+    /**
+     * @returns {any}
+     */
     body() : any;
 }
 
@@ -199,6 +223,18 @@ export class PicoDom extends trait(PicoDomPlugins)
         return this.doc().body;
     }
 
+    /**
+     * Remove elements from DOM
+     *
+     * @example Dom.find("div").remove()
+     *
+     * @returns {void} No return value
+     */
+    remove() : void
+    {
+        this.each((el : any) => el.remove());
+    }
+
 }
 
 export default PicoDom;

package/src/utils/Format.ts

@@ -27,6 +27,13 @@ export interface PicoFormat extends PicoFormatParser,
     //
 }
 
+/**
+ * @class PicoFormat
+ * @extends PicoFormatParam
+ * @extends PicoFormatOption
+ * @extends PicoFormatUrl
+ * @extends PicoFormatFile
+ */
 export class PicoFormat extends trait(PicoFormatPlugins)
 {
 

package/src/utils/Hash.ts

@@ -1,4 +1,4 @@
-import { Str } from "../index.esm.ts";
+import { Mix, Str } from "../index.esm.ts";
 
 /**
  * @var {string[]} RADIX_NUMBER Radix from 0 to 9
@@ -159,6 +159,25 @@ export class PicoHash
         return hash;
     }
 
+    /**
+     * Get a numeric hash for object
+     *
+     * @example Hash.object({ a: 1 }) // => '8823432'
+     *
+     * @param {any} value Object to hash
+     * @returns {string} String numeric hash
+     */
+    static object(value : any) : string
+    {
+        let conv = JSON.stringify(value), hash = 0;
+
+        for (let i = 0; i < conv.length; i++) {
+            hash = (hash << 5) - hash + conv.charCodeAt(i) | 0;
+        }
+
+        return Mix.str(hash).replace('-', 'X');
+    }
+
 }
 
 export default PicoHash;

package/src/utils/Now.ts

@@ -7,6 +7,7 @@ import { PicoNowGrid } from "../now/NowGrid.ts";
 import { PicoNowWalker } from "../now/NowWalker.ts";
 import { PicoNowRange } from "../now/NowRange.ts";
 import { PicoNowHuman } from "../now/NowHuman.ts";
+import PicoNowDuration from "../now/NowDuration.ts";
 
 export const PicoNowPlugins = [
     PicoNowDefault,
@@ -16,6 +17,7 @@ export const PicoNowPlugins = [
     PicoNowWalker,
     PicoNowRange,
     PicoNowHuman,
+    PicoNowDuration,
 ];
 
 export interface PicoNowInterface

package/src/utils/Number.ts

@@ -148,7 +148,13 @@ export class PicoNumber
      */
     static combine(value : number[]) : number
     {
-        return Arr.reduce(value, (acc : number, val : any) => acc + val, 0);
+        const iter = Arr.slice(...[
+            value, 1, value.length
+        ]);
+
+        return Arr.reduce(iter, (acc : number, val : any) => {
+            return acc + val;
+        }, Arr.first(value) ?? 0);
     }
 
     /**
@@ -162,7 +168,13 @@ export class PicoNumber
      */
     static subtract(value : number[]) : number
     {
-        return Arr.reduce(value, (acc : number, val : any) => acc - val, 0);
+        const iter = Arr.slice(...[
+            value, 1, value.length
+        ]);
+
+        return Arr.reduce(iter, (acc : number, val : any) => {
+            return acc - val;
+        }, Arr.first(value) ?? 0);
     }
 
     /**

package/src/utils/Runner.ts

@@ -221,7 +221,7 @@ export class PicoRunner
      */
     static framerate(cb : Function, fps : number = 30, finish : boolean = true) : Function
     {
-        let timer : any, last = 0, hertz = 1000 / fps;
+        let timer : any, frame : any, last = 0, hertz = 1000 / fps;
 
         const fn = (...args : any) => {
 
@@ -231,7 +231,13 @@ export class PicoRunner
                 return finish && (timer = setTimeout(fn, hertz + 1));
             }
 
-            (this.frame(() => cb(...args)), last = Date.now());
+            cancelAnimationFrame(frame);
+
+            frame = requestAnimationFrame(() => {
+                cb(...args);
+            });
+
+            last = Date.now()
         };
 
         return fn;

package/src/utils/String.ts

@@ -285,6 +285,10 @@ export class PicoString
      */
     static has(value : any, search : any) : boolean
     {
+        if ( Mix.isEmpty(search) ) {
+            return true;
+        }
+
         return this.lc(value).indexOf(this.lc(search)) !== -1;
     }
 

package/types/index.esm.d.ts

@@ -17,6 +17,9 @@ export { go, browser, device, trait };
 import { default as Data } from "./utils/Data.ts";
 import { default as Route } from "./utils/Route.ts";
 export { Route, Data };
+import { default as Map } from "./wip/Map.ts";
+import { default as Element } from "./wip/Element.ts";
+export { Map, Element };
 /**
  * @type {Mix}
  */

package/types/now/NowDefault.d.ts

@@ -6,7 +6,7 @@ export interface PicoNowDefault extends PicoNowInterface {
  * @memberof PicoNow
  */
 export declare class PicoNowDefault {
-    static test(value: any): boolean;
+    calc(value: any, scope: string): PicoNow;
     /**
      * Get value by scope
      *

package/types/now/NowDuration.d.ts

@@ -0,0 +1,38 @@
+import { PicoNowInterface } from "../utils/Now.ts";
+import PicoNowDefault from "./NowDefault.ts";
+import PicoNowFormat from "./NowFormat.ts";
+export interface PicoNowDuration extends PicoNowInterface, PicoNowDefault, PicoNowFormat {
+}
+/**
+ * @memberof PicoNow
+ */
+export declare class PicoNowDuration {
+    /**
+     * Calculate duration between two dates
+     *
+     * @example Now.make("2026-01-01").duration("2026-02-01") // => { years: 0, months: 1, ... }
+     *
+     * @param {any} value End date
+     * @returns {any} Duration object
+     */
+    duration(value: any): any;
+    /**
+     * Normalize seconds into duration parts
+     *
+     * @example Now.make().safeDuration(3661) // => { dates: 0, hours: 1, minutes: 1, seconds: 1 }
+     *
+     * @param {number} value Seconds value
+     * @returns {any} Duration object
+     */
+    safeDuration(value: number): any;
+    /**
+     * Get difference between two dates in seconds
+     *
+     * @example Now.make("2026-01-02").diffrence("2026-01-01") // => 86400
+     *
+     * @param {any} [value=null] Compare date
+     * @returns {number} Seconds difference
+     */
+    diffrence(value?: any): number;
+}
+export default PicoNowDuration;

package/types/utils/Dom.d.ts

@@ -11,11 +11,30 @@ import { PicoDomObserver } from "../dom/DomObserver.ts";
 import { PicoDomPopover } from "../dom/DomPopover.ts";
 export declare const PicoDomPlugins: (typeof PicoDomObserver)[];
 export interface PicoDomInterface {
+    /**
+     * @type {any}
+     */
     el: any;
+    /**
+     * @type {any[]}
+     */
     els: any[];
+    /**
+     * @param {Function} plugin
+     * @returns {void}
+     */
     extend(plugin: Function): void;
+    /**
+     * @returns {any}
+     */
     win(): any;
+    /**
+     * @returns {any}
+     */
     doc(): any;
+    /**
+     * @returns {any}
+     */
     body(): any;
 }
 export interface PicoDom extends PicoDomFinder, PicoDomGlobal, PicoDomForm, PicoDomEvent, PicoDomBuilder, PicoDomRectangle, PicoDomAttribute, PicoDomInview, PicoDomMeta, PicoDomObserver, PicoDomPopover {
@@ -107,5 +126,13 @@ export declare class PicoDom extends PicoDom_base {
      * @returns {any} Body or {}
      */
     static body(): any;
+    /**
+     * Remove elements from DOM
+     *
+     * @example Dom.find("div").remove()
+     *
+     * @returns {void} No return value
+     */
+    remove(): void;
 }
 export default PicoDom;

package/types/utils/Format.d.ts

@@ -10,6 +10,13 @@ export interface PicoFormatInterface {
 export interface PicoFormat extends PicoFormatParser, PicoFormatParam, PicoFormatOption, PicoFormatUrl, PicoFormatFile {
 }
 declare const PicoFormat_base: any;
+/**
+ * @class PicoFormat
+ * @extends PicoFormatParam
+ * @extends PicoFormatOption
+ * @extends PicoFormatUrl
+ * @extends PicoFormatFile
+ */
 export declare class PicoFormat extends PicoFormat_base {
     /**
      * Extend format with a plugin

package/types/utils/Hash.d.ts

@@ -77,5 +77,14 @@ export declare class PicoHash {
      * @returns {string} A random password with fixed length
      */
     static password(length?: number, symbols?: string[]): string;
+    /**
+     * Get a numeric hash for object
+     *
+     * @example Hash.object({ a: 1 }) // => '8823432'
+     *
+     * @param {any} value Object to hash
+     * @returns {string} String numeric hash
+     */
+    static object(value: any): string;
 }
 export default PicoHash;

package/types/utils/Now.d.ts

@@ -5,7 +5,7 @@ import { PicoNowGrid } from "../now/NowGrid.ts";
 import { PicoNowWalker } from "../now/NowWalker.ts";
 import { PicoNowRange } from "../now/NowRange.ts";
 import { PicoNowHuman } from "../now/NowHuman.ts";
-export declare const PicoNowPlugins: (typeof PicoNowDefault | typeof PicoNowWalker | typeof PicoNowRange | typeof PicoNowHuman)[];
+export declare const PicoNowPlugins: (typeof PicoNowDefault | typeof PicoNowRange)[];
 export interface PicoNowInterface {
     value: Date;
     input: any;