@kizmann/pico-js 2.0.7 → 2.0.9

package/src/utils/{Cookie.js → Cookie.ts}

@@ -1,4 +1,4 @@
-import { For, Arr, Now, Mix } from "../index.esm.js";
+import { For, Arr, Now, Mix } from "../index.esm.ts";
 
 export const COOKIE_REGEX = {
     entry: /(?<=^|;)\s*(?<key>.*?)\s*=\s*(?<value>[^;$]+)/g
@@ -6,7 +6,10 @@ export const COOKIE_REGEX = {
 
 export class PicoCookie
 {
-    static $cookie = null;
+    /**
+     * @type {Record<string, any>}
+     */
+    static $cookie : any;
 
     /**
      * Read raw document.cookie
@@ -15,7 +18,7 @@ export class PicoCookie
      *
      * @returns {string} Cookie string
      */
-    static global()
+    static global() : string
     {
         if ( globalThis.document == null ) {
             return '';
@@ -33,7 +36,7 @@ export class PicoCookie
      * @param {boolean} [fresh] Force refresh
      * @returns {Record<string, any>} Cookie map
      */
-    static parse(fresh = false)
+    static parse(fresh : boolean = false) : Record<string, any>
     {
         if ( !fresh && this.$cookie ) {
             return this.$cookie;
@@ -49,7 +52,7 @@ export class PicoCookie
             return this.$cookie;
         }
 
-        let fn = (value) => {
+        let fn = (value : any) => {
             return value.replaceAll('{:}', ';');
         }
 
@@ -71,7 +74,7 @@ export class PicoCookie
      * @param {string} [decode] Decode mode
      * @returns {any} Cookie value
      */
-    static get(key, fallback = null, decode = 'string')
+    static get(key : string, fallback : any = null, decode : string = 'string') : any
     {
         if ( !this.$cookie ) {
             this.parse();
@@ -110,9 +113,9 @@ export class PicoCookie
      * @param {any} value Cookie value
      * @param {any} [expire] Expire date spec
      * @param {any} [options] Cookie options
-     * @returns {typeof PicoCookie} Cookie class
+     * @returns {PicoCookie} Cookie class
      */
-    static set(key, value, expire = null, options = {})
+    static set(key : string, value : any, expire : any = null, options : any = {}) : PicoCookie
     {
         if ( !this.$cookie ) {
             this.parse();
@@ -138,7 +141,7 @@ export class PicoCookie
             ';', '{:}'
         ]);
 
-        Arr.each(options, (value, key) => {
+        Arr.each(options, (value : any, key : any) => {
             plain += `;${key}=${value}`;
         });
 
@@ -154,9 +157,9 @@ export class PicoCookie
      *
      * @param {string} key Cookie key
      * @param {any} [options] Cookie options
-     * @returns {typeof PicoCookie} Cookie class
+     * @returns {PicoCookie} Cookie class
      */
-    static forget(key, options = {})
+    static forget(key : string, options : any = {}) : PicoCookie
     {
         let expires = 'Thu, 01 Jan 1970 00:00:01 GMT';
 
@@ -170,7 +173,7 @@ export class PicoCookie
 
         let plain = `${key}=null`;
 
-        Arr.each(options, (value, key) => {
+        Arr.each(options, (value : any, key : any) => {
             plain += `;${key}=${value}`;
         });
 

package/src/utils/{Data.js → Data.ts}

@@ -1,13 +1,13 @@
-import { Arr, Num, Event, Mix, Obj } from "../index.esm.js";
+import { Arr, Num, Signal, Mix, Obj } from "../index.esm.ts";
 
 export class PicoData
 {
     /**
      * In-memory data store
      *
-     * @type {Record<string, any>}
+     * @type {any}
      */
-    static $data = {};
+    static $data : any = {};
 
     /**
      * Check if store key exists
@@ -17,7 +17,7 @@ export class PicoData
      * @param {any} input Store key input
      * @returns {boolean} True if exists
      */
-    static has(input)
+    static has(input : any) : boolean
     {
         return Obj.has(this.$data, ...[
             Arr.first(input)
@@ -34,7 +34,7 @@ export class PicoData
      * @param {any} value Value to set
      * @returns {void} No return value
      */
-    static set(input, value)
+    static set(input : any, value : any) : void
     {
         let [stored, key] = [
             null, Arr.first(input)
@@ -52,7 +52,7 @@ export class PicoData
             this.$data, key, value
         ]);
 
-        Event.fire('store:' + key, value, key);
+        Signal.fire('store:' + key, value, key);
     }
 
     /**
@@ -63,7 +63,7 @@ export class PicoData
      * @param {any} input Store key input
      * @returns {void} No return value
      */
-    static unset(input)
+    static unset(input : any) : void
     {
         Obj.unset(this.$data, [
             ...Arr.first(input)
@@ -81,7 +81,7 @@ export class PicoData
      * @param {boolean} [forceSet] Set if missing
      * @returns {any} Stored value
      */
-    static get(input, fallback = null, forceSet = false)
+    static get(input : any, fallback : any = null, forceSet : boolean = false) : any
     {
         let key = Arr.first(input);
 
@@ -112,7 +112,7 @@ export class PicoData
      * @param {any} [fallback] Fallback value
      * @returns {any} Found item
      */
-    static find(input, value, fallback = null)
+    static find(input : any, value : any, fallback : any = null) : any
     {
         let key = Arr.first(input);
 
@@ -128,7 +128,7 @@ export class PicoData
             id: value.id
         });
 
-        if ( index === - 1 ) {
+        if ( index === -1 ) {
             return fallback;
         }
 
@@ -144,7 +144,7 @@ export class PicoData
      * @param {any} value Item to replace
      * @returns {void} No return value
      */
-    static replace(input, value)
+    static replace(input : any, value : any) : void
     {
         let key = Arr.first(input);
 
@@ -160,7 +160,7 @@ export class PicoData
             id: Num.int(value.id)
         });
 
-        if ( index === - 1 ) {
+        if ( index === -1 ) {
             return;
         }
 
@@ -173,12 +173,12 @@ export class PicoData
      * @example Data.add(["list"], 1, 2)
      *
      * @param {any} input Store key input
-     * @param {...any} args Items to add
+     * @param {[...any]} args Items to add
      * @returns {void} No return value
      */
-    static add(input, ...args)
+    static add(input : any, ...args : [...any]) : void
     {
-        this.set(input, Arr.concat(this.get(input, []), args));
+        this.set(input, Arr.merge(this.get(input, []), args));
     }
 
     /**
@@ -187,10 +187,10 @@ export class PicoData
      * @example Data.remove(["list"], 1)
      *
      * @param {any} input Store key input
-     * @param {...any} args Items to remove
+     * @param {[...any]} args Items to remove
      * @returns {void} No return value
      */
-    static remove(input, ...args)
+    static remove(input : any, ...args : [...any]) : void
     {
         this.set(input, Arr.diff(this.get(input, []), args));
     }

package/src/utils/Dom.ts

@@ -0,0 +1,204 @@
+import { trait } from "../tool/scope.ts";
+import { Mix, Dom, Arr } from "../index.esm.ts";
+import { PicoDomFinder } from "../dom/DomFinder.ts";
+import { PicoDomForm } from "../dom/DomForm.ts";
+import { PicoDomEvent } from "../dom/DomEvent.ts";
+import { PicoDomBuilder } from "../dom/DomBuilder.ts";
+import { PicoDomGlobal } from "../dom/DomGlobal.ts";
+import { PicoDomRectangle } from "../dom/DomRectangle.ts";
+import { PicoDomAttribute } from "../dom/DomAttribute.ts";
+import { PicoDomInview } from "../dom/DomInview.ts";
+import { PicoDomMeta } from "../dom/DomMeta.ts";
+import { PicoDomObserver } from "../dom/DomObserver.ts";
+import { PicoDomPopover } from "../dom/DomPopover.ts";
+
+export const PicoDomPlugins = [
+    PicoDomFinder,
+    PicoDomGlobal,
+    PicoDomForm,
+    PicoDomEvent,
+    PicoDomBuilder,
+    PicoDomRectangle,
+    PicoDomAttribute,
+    PicoDomInview,
+    PicoDomMeta,
+    PicoDomObserver,
+    PicoDomPopover,
+];
+
+export interface PicoDomInterface
+{
+    el: any;
+    els: any[];
+    extend(plugin : Function) : void;
+    win() : any;
+    doc() : any;
+    body() : any;
+}
+
+export interface PicoDom extends
+    PicoDomFinder,
+    PicoDomGlobal,
+    PicoDomForm,
+    PicoDomEvent,
+    PicoDomBuilder,
+    PicoDomRectangle,
+    PicoDomAttribute,
+    PicoDomInview,
+    PicoDomMeta,
+    PicoDomObserver,
+    PicoDomPopover
+{
+    //
+}
+
+/**
+ * @class PicoDom
+ *
+ * @mixes PicoDomFinder
+ * @mixes PicoDomGlobal
+ * @mixes PicoDomForm
+ * @mixes PicoDomEvent
+ * @mixes PicoDomBuilder
+ * @mixes PicoDomRectangle
+ * @mixes PicoDomAttribute
+ * @mixes PicoDomInview
+ * @mixes PicoDomMeta
+ * @mixes PicoDomObserver
+ * @mixes PicoDomPopover
+ */
+export class PicoDom extends trait(PicoDomPlugins)
+{
+
+    /**
+     * Init hooks for constructor
+     *
+     * @type {Function[]}
+     */
+    static init : Function[] = [];
+
+    /**
+     * First selected element
+     *
+     * @type {any}
+     */
+    el : any = null;
+
+    /**
+     * All selected elements
+     *
+     * @type {any[]}
+     */
+    els : any[] = [];
+
+    /**
+     * Create Dom wrapper from input
+     *
+     * @example new Dom("body").get(0) // => HTMLElement
+     *
+     * @param {any} el Element or selector
+     * @param {[...any]} args Plugin args
+     */
+    constructor(el : any, ...args : [...any])
+    {
+        super(el, ...args);
+
+        if ( typeof el === 'string' ) {
+            el = document.querySelectorAll(el);
+        }
+
+        if ( el instanceof NodeList ) {
+            el = Mix.nodes(el);
+        }
+
+        if ( el instanceof Dom ) {
+            el = el.el;
+        }
+
+        if ( !Mix.isArr(el) ) {
+            el = [el];
+        }
+
+        (this.el = el[0], this.els = el);
+
+        return this;
+    }
+
+    /**
+     * Create new Dom wrapper
+     *
+     * @example Dom.find("body") // => Dom
+     *
+     * @param {any} el Element or selector
+     * @param {[...any]} args Plugin args
+     * @returns {PicoDom} Dom wrapper
+     */
+    static find(el : any, ...args : [...any]) : PicoDom
+    {
+        return new Dom(el, ...args);
+    }
+
+    /**
+     * Extend Dom with a plugin
+     *
+     * @example Dom.extend(fn)
+     *
+     * @param {Function} plugin Plugin function
+     * @returns {void} No return value
+     */
+    static extend(plugin : Function) : void
+    {
+        plugin.call({}, this);
+    }
+
+    /**
+     * Get window or empty object
+     *
+     * @example Dom.win().innerWidth // => number|undefined
+     *
+     * @returns {any} Window or {}
+     */
+    static win() : any
+    {
+        if ( globalThis.window == null ) {
+            return {};
+        }
+
+        return window;
+    }
+
+    /**
+     * Get document or empty object
+     *
+     * @example Dom.doc().body // => HTMLElement
+     *
+     * @returns {any} Document or {}
+     */
+    static doc() : any
+    {
+        if ( globalThis.document == null ) {
+            return {};
+        }
+
+        return document;
+    }
+
+    /**
+     * Get document.body or empty
+     *
+     * @example Dom.body().nodeType // => 1|undefined
+     *
+     * @returns {any} Body or {}
+     */
+    static body() : any
+    {
+        if ( !this.doc().body ) {
+            return {};
+        }
+
+        return this.doc().body;
+    }
+
+}
+
+export default PicoDom;

package/src/utils/Format.ts

@@ -0,0 +1,48 @@
+import { trait } from "../tool/scope.ts";
+import { PicoFormatParser } from "../format/FormatParser.ts";
+import { PicoFormatParam } from "../format/FormatParam.ts";
+import { PicoFormatOption } from "../format/FormatOption.ts";
+import { PicoFormatUrl } from "../format/FormatUrl.ts";
+import { PicoFormatFile } from "../format/FormatFile.ts";
+
+export const PicoFormatPlugins = [
+    PicoFormatParser,
+    PicoFormatParam,
+    PicoFormatOption,
+    PicoFormatUrl,
+    PicoFormatFile,
+];
+
+export interface PicoFormatInterface
+{
+    extend(plugin : Function) : void;
+}
+
+export interface PicoFormat extends PicoFormatParser,
+    PicoFormatParam,
+    PicoFormatOption,
+    PicoFormatUrl,
+    PicoFormatFile
+{
+    //
+}
+
+export class PicoFormat extends trait(PicoFormatPlugins)
+{
+
+    /**
+     * Extend format with a plugin
+     *
+     * @example For.extend(fn)
+     *
+     * @param {Function} plugin Plugin function
+     * @returns {void} No return value
+     */
+    static extend(plugin : Function) : void
+    {
+        plugin.call({}, this);
+    }
+
+}
+
+export default PicoFormat;

package/src/utils/{Hash.js → Hash.ts}

@@ -1,28 +1,28 @@
-import { Str } from "../index.esm.js";
+import { Str } from "../index.esm.ts";
 
 /**
- * @var {Array<string>} RADIX_NUMBER Radix from 0 to 9
+ * @var {string[]} RADIX_NUMBER Radix from 0 to 9
  */
 export const RADIX_NUMBER = [
     '0', '1', '2', '3', '4', '5', '6', '7', '8', '9'
 ];
 
 /**
- * @var {Array<string>} RADIX_LETTER_LC Radix from a to z
+ * @var {string[]} RADIX_LETTER_LC Radix from a to z
  */
 export const RADIX_LETTER_LC = [
     'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z',
 ];
 
 /**
- * @var {Array<string>} RADIX_LETTER_UC Radix from A to Z
+ * @var {string[]} RADIX_LETTER_UC Radix from A to Z
  */
 export const RADIX_LETTER_UC = [
     'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'
 ];
 
 /**
- * @var {Array<string>} RADIX_UUID Radix from 0-9, a-f and A-F
+ * @var {string[]} RADIX_UUID Radix from 0-9, a-f and A-F
  */
 export const RADIX_UUID = [
     '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f', 'A', 'B', 'C', 'D', 'E', 'F',
@@ -30,14 +30,14 @@ export const RADIX_UUID = [
 
 
 /**
- * @var {Array<string>} RADIX_UP19 Radix with 8, 9, a and b
+ * @var {string[]} RADIX_UP19 Radix with 8, 9, a and b
  */
 export const RADIX_UP19 = [
     '8', '9', 'a', 'b',
 ];
 
 /**
- * @var {Array<string>} radix_symbol_pass Radix for passwords
+ * @var {string[]} radix_symbol_pass Radix for passwords
  */
 export const radix_symbol_pass = [
     '@', '#', '$', '%', '^', '&', '*', '(', ')', '_', '+', '-', '=', '[', ']', '{', '}', ';', ':', ',', '.', '/', '<', '>', '?'
@@ -47,9 +47,9 @@ export class PicoHash
 {
 
     /**
-     * @var {Array<string>} RADIX
+     * @type {string[]}
      */
-    static RADIX = [
+    static RADIX : string[] = [
         ...RADIX_NUMBER, ...RADIX_LETTER_LC, ...RADIX_LETTER_UC
     ];
 
@@ -59,10 +59,10 @@ export class PicoHash
      * @example Hash.radix(2, ['R', 'f']) // => 'R' or 'f'
      *
      * @param {number} [limit=60] Maximum radix char index
-     * @param {Array<string>} [radix=null] A defined radix or null for default
+     * @param {string[]} [radix=null] A defined radix or null for default
      * @returns {string} Returns random char from radix
      */
-    static radix(limit = 60, radix = null)
+    static radix(limit : number = 60, radix : string[] = null) : string
     {
         return (radix || this.RADIX)[this.number(limit - 1)];
     }
@@ -76,7 +76,7 @@ export class PicoHash
      * @param {number} [start=0] Minimum value
      * @returns {number} Returns a random number between start and limit
      */
-    static number(limit = 1024, start = 0)
+    static number(limit : number = 1024, start : number = 0) : number
     {
         return Math.floor(Math.random() * (limit - start + 1)) + start;
     }
@@ -88,14 +88,14 @@ export class PicoHash
      *
      * @param {number} [length] Length of generated hash
      * @param {number} [radix] Maximum radix char index (10 for 0-9, 36 incl. a-z, 62 incl. A-Z)
-     * @param {Record<number, string>} [map] Remap for generated string
+     * @param {any} [map] Remap for generated string
      * @returns {string} Returns a random hash with fixed length
      */
-    static make(length = 6, radix = 62, map = {})
+    static make(length : number = 6, radix : number = 62, map : any = {}) : string
     {
         let hash = '';
 
-        for ( let i = 0; i < length; i ++ ) {
+        for ( let i = 0; i < length; i++ ) {
             hash += this.radix(radix);
         }
 
@@ -114,12 +114,12 @@ export class PicoHash
      * @param {string|number} [version] UUID version number
      * @returns {string} Returns a valid UUID
      */
-    static uuid(version = 4)
+    static uuid(version : number = 4) : string
     {
         let hash = '';
 
         // Use only selected chars from the radix store
-        for ( let i = 0; i < 31; i ++ ) {
+        for ( let i = 0; i < 31; i++ ) {
             if ( i === 15 ) {
                 hash += this.radix(RADIX_UP19.length, RADIX_UP19);
             } else {
@@ -141,10 +141,10 @@ export class PicoHash
      * @example Hash.password(12, ['%', '&']) // => '0unJ%VDi2RJX'
      *
      * @param {number} [length=24] Length of password
-     * @param {Array<string>} [symbols=null] Defined symbols or null for default
+     * @param {string[]} [symbols=null] Defined symbols or null for default
      * @returns {string} A random password with fixed length
      */
-    static password(length = 24, symbols = null)
+    static password(length : number = 24, symbols : string[] = null) : string
     {
         let radix = [
             ...this.RADIX, ...(symbols || radix_symbol_pass)
@@ -152,7 +152,7 @@ export class PicoHash
 
         let hash = '';
 
-        for ( let i = 0; i < length; i ++ ) {
+        for ( let i = 0; i < length; i++ ) {
             hash += this.radix(radix.length, radix);
         }