@kizmann/pico-js 2.0.7 → 2.0.9

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

@@ -1,4 +1,4 @@
-import { Arr, For, Locale, Mix, Now, Str } from "../index.esm.js";
+import { Arr, For, Locale, Mix, Now, Str } from "../index.esm.ts";
 
 export class PicoString
 {
@@ -8,12 +8,12 @@ export class PicoString
      * @example Str.get("abc", 1) // => "b"
      *
      * @param {any} value Input string
-     * @param {any} index Char index
+     * @param {number} index Char index
      * @returns {string} Single char
      */
-    static get(value, index)
+    static get(value : any, index : number) : string
     {
-        if ( ! Mix.isStr(value) ) {
+        if ( !Mix.isStr(value) ) {
             value = Mix.str(value);
         }
 
@@ -34,9 +34,9 @@ export class PicoString
      * @param {string} [replace] Replace value
      * @returns {string} Updated string
      */
-    static set(value, index, replace = '')
+    static set(value : any, index : any, replace : string = '') : string
     {
-        if ( ! Mix.isStr(value) ) {
+        if ( !Mix.isStr(value) ) {
             value = Mix.str(value);
         }
 
@@ -58,7 +58,7 @@ export class PicoString
      * @param {any} [search] Search value
      * @returns {string} Updated string
      */
-    static replace(value, replace, search = null)
+    static replace(value : any, replace : string, search : any = null) : string
     {
         if ( Mix.isNull(search) ) {
             search = value;
@@ -83,13 +83,13 @@ export class PicoString
      * @param {any} [search] Match source
      * @returns {string|null} Extracted string
      */
-    static extract(value, replace, search = null)
+    static extract(value : any, replace : string, search : any = null) : string
     {
         if ( Mix.isNull(search) ) {
             search = value;
         }
 
-        let index = this.range(search, replace);
+        let index : [number, number] = this.range(search, replace);
 
         if ( index === null ) {
             return null;
@@ -105,10 +105,10 @@ export class PicoString
      *
      * @param {any} value Input string
      * @param {RegExp|string} pattern Match pattern
-     * @param {any} [cb] Callback fn
+     * @param {Function} [cb] Callback fn
      * @returns {any} Match result
      */
-    static match(value, pattern, cb = null)
+    static match(value : any, pattern : RegExp | string, cb : Function = null) : any
     {
         let result = Mix.str(value).match(pattern);
 
@@ -124,12 +124,12 @@ export class PicoString
      *
      * @example Str.regex("a.b") // => "a\\.b"
      *
-     * @param {any} val Input string
+     * @param {any} value Input string
      * @returns {string} Escaped string
      */
-    static regex(val)
+    static regex(value : any) : string
     {
-        return Mix.str(val).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return Mix.str(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
     }
 
     /**
@@ -140,7 +140,7 @@ export class PicoString
      * @param {any} value Input string
      * @returns {string} Uppercase string
      */
-    static uc(value)
+    static uc(value : any) : string
     {
         return Mix.str(value).toUpperCase();
     }
@@ -155,12 +155,12 @@ export class PicoString
      *
      * @example Str.ucfirst("abc") // => "Abc"
      *
-     * @param {string} value Input string
+     * @param {any} value Input string
      * @returns {string} Updated string
      */
-    static ucfirst(value)
+    static ucfirst(value : any) : string
     {
-        return value.charAt(0).toUpperCase() + value.slice(1);
+        return Mix.str(value).charAt(0).toUpperCase() + value.slice(1);
     }
 
     /**
@@ -171,7 +171,7 @@ export class PicoString
      * @param {any} value Input string
      * @returns {string} Lowercase string
      */
-    static lc(value)
+    static lc(value : any) : string
     {
         return Mix.str(value).toLowerCase();
     }
@@ -186,12 +186,12 @@ export class PicoString
      *
      * @example Str.lcfirst("ABC") // => "aBC"
      *
-     * @param {string} value Input string
+     * @param {any} value Input string
      * @returns {string} Updated string
      */
-    static lcfirst(value)
+    static lcfirst(value : any) : string
     {
-        return value.charAt(0).toLowerCase() + value.slice(1);
+        return Mix.str(value).charAt(0).toLowerCase() + value.slice(1);
     }
 
     /**
@@ -199,10 +199,10 @@ export class PicoString
      *
      * @example Str.cc("hello-world") // => "helloWorld"
      *
-     * @param {string} value Input string
+     * @param {any} value Input string
      * @returns {string} camelCase string
      */
-    static cc(value)
+    static cc(value : any) : string
     {
         let splits = Arr.each(For.slugify(value).split('-'), (v, i) => {
             return i ? this.ucfirst(v) : v;
@@ -221,10 +221,10 @@ export class PicoString
      *
      * @example Str.kc("helloWorld") // => "hello-world"
      *
-     * @param {string} value Input string
+     * @param {any} value Input string
      * @returns {string} kebab-case string
      */
-    static kc(value)
+    static kc(value : any) : string
     {
         return For.slugify(value);
     }
@@ -239,10 +239,10 @@ export class PicoString
      *
      * @example Str.sc("helloWorld") // => "hello_world"
      *
-     * @param {string} value Input string
+     * @param {any} value Input string
      * @returns {string} snake_case string
      */
-    static sc(value)
+    static sc(value : any) : string
     {
         return For.slugify(value).replace('-', '_');
     }
@@ -257,10 +257,10 @@ export class PicoString
      *
      * @example Str.pc("hello-world") // => "HelloWorld"
      *
-     * @param {string} value Input string
+     * @param {any} value Input string
      * @returns {string} PascalCase string
      */
-    static pc(value)
+    static pc(value : any) : string
     {
         let splits = Arr.each(For.slugify(value).split('-'), (v) => {
             return this.ucfirst(v);
@@ -279,11 +279,11 @@ export class PicoString
      *
      * @example Str.has("abc", "b") // => true
      *
-     * @param {string} value Input string
-     * @param {string} search Search string
+     * @param {any} value Input string
+     * @param {any} search Search string
      * @returns {boolean} True if found
      */
-    static has(value, search)
+    static has(value : any, search : any) : boolean
     {
         return this.lc(value).indexOf(this.lc(search)) !== -1;
     }
@@ -296,9 +296,9 @@ export class PicoString
      * @param {any} value Input string
      * @param {string} search Search string
      * @param {any} [fallback] Fallback value
-     * @returns {Array<number>|any} Index range
+     * @returns {number[]|any} Index range
      */
-    static range(value, search, fallback = null)
+    static range(value : any, search : string, fallback : any = null) : number[] | any
     {
         let index = Mix.str(value).indexOf(search);
 
@@ -319,7 +319,7 @@ export class PicoString
      * @param {number} limit End index
      * @returns {string} Sliced string
      */
-    static slice(value, start, limit)
+    static slice(value : any, start : number, limit : number) : string
     {
         return Mix.str(value).slice(start, limit);
     }
@@ -330,11 +330,11 @@ export class PicoString
      * @example Str.string("<b>a</b>") // => "a"
      *
      * @param {any} value Input value
-     * @param {any} [empty] Empty fallback
+     * @param {string} [empty] Empty fallback
      * @param {boolean} [html] Keep HTML
      * @returns {string} String value
      */
-    static string(value, empty = '-', html = false)
+    static string(value : any, empty : string = '-', html : boolean = false) : string
     {
         if ( Mix.isEmpty(value) ) {
             return empty;
@@ -357,10 +357,10 @@ export class PicoString
      * @param {any} value Input value
      * @param {string} [yes] True string
      * @param {string} [no] False string
-     * @param {any} [empty] Empty fallback
-     * @returns {string|any} Boolean string
+     * @param {string} [empty] Empty fallback
+     * @returns {string} Boolean string
      */
-    static boolean(value, yes = 'Yes', no = 'No', empty = '-')
+    static boolean(value : any, yes : string = 'Yes', no : string = 'No', empty : string = '-') : string
     {
         if ( Mix.isEmpty(value) ) {
             return empty;
@@ -378,12 +378,12 @@ export class PicoString
      * @param {number} [fixed] Decimal points
      * @param {string} [locale] Locale code
      * @param {any} [config] Format config
-     * @returns {string|any} Formatted string
+     * @returns {string} Formatted string
      */
-    static number(value, fixed = null, locale = null, config = {})
+    static number(value : any, fixed : number = null, locale : string = null, config : any = {}) : string
     {
-        if ( ! Mix.isNum(value) ) {
-            return value;
+        if ( !Mix.isNum(value) ) {
+            return Mix.str(value);
         }
 
         if ( locale == null ) {
@@ -412,19 +412,19 @@ export class PicoString
      * @param {string} [padding] Padding char
      * @returns {string|any} Formatted string
      */
-    static integer(value, leading = 0, padding = '0')
+    static integer(value : any, leading : number = 0, padding : string = '0') : string
     {
-        if ( ! Mix.isNum(value) ) {
-            return value;
+        if ( !Mix.isNum(value) ) {
+            return Mix.str(value);
         }
 
-        if ( ! Mix.isInt(value) ) {
+        if ( !Mix.isInt(value) ) {
             value = Mix.int(value);
         }
 
         value = Mix.int(value);
 
-        if ( ! leading ) {
+        if ( !leading ) {
             return Mix.str(value);
         }
 
@@ -438,16 +438,16 @@ export class PicoString
      *
      * @param {any} value Input value
      * @param {string} [format] Output format
-     * @param {any} [empty] Empty fallback
+     * @param {string} [empty] Empty fallback
      * @returns {string} Formatted string
      */
-    static datetime(value, format = 'YYYY-MM-DD HH:mm:ss', empty = '-')
+    static datetime(value : any, format : string = 'YYYY-MM-DD HH:mm:ss', empty : string = '-') : string
     {
-        if ( ! Mix.isDate(value) ) {
+        if ( !Mix.isDate(value) ) {
             value = Now.make(value);
         }
 
-        if ( ! value.valid() ) {
+        if ( !value.valid() ) {
             return empty;
         }
 
@@ -461,10 +461,10 @@ export class PicoString
      *
      * @param {any} value Input value
      * @param {string} [format] Output format
-     * @param {any} [empty] Empty fallback
+     * @param {string} [empty] Empty fallback
      * @returns {string} Formatted string
      */
-    static date(value, format = 'YYYY-MM-DD', empty = '-')
+    static date(value : any, format : string = 'YYYY-MM-DD', empty : string = '-') : string
     {
         return this.datetime(value, format, empty);
     }
@@ -479,7 +479,7 @@ export class PicoString
      * @param {any} [empty] Empty fallback
      * @returns {string} Formatted string
      */
-    static time(value, format = 'HH:mm:ss', empty = '-')
+    static time(value : any, format : string = 'HH:mm:ss', empty : string = '-') : string
     {
         return this.datetime(value, format, empty);
     }
@@ -494,7 +494,7 @@ export class PicoString
      * @param {boolean} [toarray] Return array
      * @returns {any} Parsed value
      */
-    static objectify(value, mode = 'options', toarray = false)
+    static objectify(value : any, mode : string = 'options', toarray : boolean = false) : any
     {
         if ( Mix.isRef(value) ) {
             return value;
@@ -508,7 +508,7 @@ export class PicoString
             value = For.parseOptions(value);
         }
 
-        if ( ! Mix.isRef(value) ) {
+        if ( !Mix.isRef(value) ) {
             value = JSON.parse(value)
         }
 
@@ -524,7 +524,7 @@ export class PicoString
      * @param {string} [mode] Cast mode
      * @returns {string} Casted string
      */
-    static stringify(value, mode = 'options')
+    static stringify(value : any, mode : string = 'options') : string
     {
         if ( Mix.isStr(value) ) {
             return value;
@@ -546,7 +546,8 @@ export class PicoString
 /**
  * @see PicoStr.regex
  */
-PicoString.regexEscape = (...args) => {
+// @ts-ignore
+PicoString.regexEscape = (...args : Parameters<typeof Str.regex>) => {
     console.warn('Str.regexEscape() is deprecated, use Str.regex() instead.');
     return Str.regex(...args);
 };
@@ -554,15 +555,17 @@ PicoString.regexEscape = (...args) => {
 /**
  * @see PicoStr.pascalcase
  */
-PicoString.humancase = (...args) => {
+// @ts-ignore
+PicoString.humancase = (...args : Parameters<typeof Str.pc>) => {
     console.warn('Str.humancase() is deprecated, use Str.pascalcase() instead.');
-    return Str.pascalcase(...args);
+    return Str.pc(...args);
 };
 
 /**
  * @see PicoFormat.slugify
  */
-PicoString.slugify = (...args) => {
+// @ts-ignore
+PicoString.slugify = (...args : Parameters<typeof For.slugify>) => {
     console.warn('Str.slugify() is deprecated, use For.slugify() instead.');
     return For.slugify(...args);
 };
@@ -570,7 +573,8 @@ PicoString.slugify = (...args) => {
 /**
  * @see PicoFormat.castOptions
  */
-PicoString.options = (...args) => {
+// @ts-ignore
+PicoString.options = (...args : Parameters<typeof For.castOptions>) => {
     console.warn('Str.options() is deprecated, use For.castOptions() instead.');
     return For.castOptions(...args);
 };
@@ -578,7 +582,8 @@ PicoString.options = (...args) => {
 /**
  * @see PicoFormat.parseOptions
  */
-PicoString.fromOptions = (...args) => {
+// @ts-ignore
+PicoString.fromOptions = (...args : Parameters<typeof For.parseOptions>) => {
     console.warn('Str.fromOptions() is deprecated, use For.parseOptions() instead.');
     return For.parseOptions(...args);
 };
@@ -586,7 +591,8 @@ PicoString.fromOptions = (...args) => {
 /**
  * @see PicoFormat.castParams
  */
-PicoString.params = (...args) => {
+// @ts-ignore
+PicoString.params = (...args : Parameters<typeof For.castParams>) => {
     console.warn('Str.params() is deprecated, use For.castParams() instead.');
     return For.castParams(...args);
 };
@@ -594,7 +600,8 @@ PicoString.params = (...args) => {
 /**
  * @see PicoFormat.parseParams
  */
-PicoString.fromParams = (...args) => {
+// @ts-ignore
+PicoString.fromParams = (...args : Parameters<typeof For.parseParams>) => {
     console.warn('Str.fromParams() is deprecated, use For.parseParams() instead.');
     return For.parseParams(...args);
 };
@@ -602,15 +609,18 @@ PicoString.fromParams = (...args) => {
 /**
  * @see PicoFormat.filesize
  */
-PicoString.filesize = (...args) => {
+// @ts-ignore
+PicoString.filesize = (...args : Parameters<typeof For.filesize>) => {
     console.warn('Str.filesize() is deprecated, use For.filesize() instead.');
     return For.filesize(...args);
 };
 
+// @ts-ignore
 PicoString.real = () => {
     console.error('Str.real() is not implemented anymore.');
 };
 
+// @ts-ignore
 PicoString.array = () => {
     console.error('Str.array() is not implemented anymore.');
 };

package/src/wip/{Element.js → Element.ts}

@@ -1,4 +1,4 @@
-import { Str, Obj, Dom, Mix, Arr } from "#src/index.esm.js";
+import { Str, Obj, Dom, Mix, Arr } from "../index.esm.ts";
 
 export class PicoElement
 {
@@ -58,7 +58,7 @@ export class PicoElement
                 return;
             }
 
-            Arr.removeIndex(this.invi, index);
+            Arr.unset(this.invi, index);
 
             item.cb();
         });

package/src/wip/{Map.js → Map.ts}

@@ -1,4 +1,4 @@
-import { go, Obj, Arr, Mix, Dom, Event, Hash } from "#src/index.esm.js";
+import { go, Obj, Arr, Mix, Dom, Event, Hash } from "../index.esm.ts";
 
 /**
  * @const {object} google

package/types/dom/DomAttribute.d.ts

@@ -1,13 +1,11 @@
-/**
- * @memberof PicoDom
- */
-export class PicoDomAttributeStatic {
+import { PicoDom, PicoDomInterface } from "../utils/Dom.ts";
+import PicoDomFinder from "./DomFinder.js";
+export interface PicoDomAttribute extends PicoDomInterface, PicoDomFinder {
 }
 /**
  * @memberof PicoDom
- * @extends {PicoDom}
  */
-export class PicoDomAttributeInstance {
+export declare class PicoDomAttribute {
     /**
      * Get or set attribute
      *
@@ -16,9 +14,9 @@ export class PicoDomAttributeInstance {
      * @param {string} key Attr key
      * @param {any} [value] Attr value
      * @param {any} [fallback] Fallback value
-     * @returns {any|PicoDom} Attr value or instance
+     * @returns {any} Attr value or instance
      */
-    attr(key: string, value?: any, fallback?: any): any | PicoDom;
+    attr(key: string, value?: any, fallback?: any): any;
     /**
      * Get or set data attribute
      *
@@ -27,9 +25,9 @@ export class PicoDomAttributeInstance {
      * @param {string} key Data key
      * @param {any} [value] Data value
      * @param {any} [fallback] Fallback value
-     * @returns {any|PicoDom} Data value or instance
+     * @returns {any} Data value or instance
      */
-    data(key: string, value?: any, fallback?: any): any | PicoDom;
+    data(key: string, value?: any, fallback?: any): any;
     /**
      * Get computed style
      *
@@ -47,9 +45,9 @@ export class PicoDomAttributeInstance {
      *
      * @param {any} [value] Style value
      * @param {boolean} [combine] Combine style
-     * @returns {any|PicoDom} Style or instance
+     * @returns {any} Style or instance
      */
-    style(value?: any, combine?: boolean): any | PicoDom;
+    style(value?: any, combine?: boolean): any;
     /**
      * Get or set classes
      *
@@ -57,24 +55,24 @@ export class PicoDomAttributeInstance {
      *
      * @param {any} [value] Class value
      * @param {boolean} [combine] Combine classes
-     * @returns {any|PicoDom} Classes or instance
+     * @returns {any} Classes or instance
      */
-    class(value?: any, combine?: boolean): any | PicoDom;
+    class(value?: any, combine?: boolean): any;
     /**
      * Get or set inner HTML
      *
      * @example Dom.find("div").html("<span></span>")
      *
      * @param {any} [html] HTML content
-     * @returns {string|PicoDom} HTML or instance
+     * @returns {any} HTML or instance
      */
-    html(html?: any): string | PicoDom;
+    html(html?: any): any;
     /**
      * Get actual style value
      *
      * @example Dom.find("div").actual((el) => el.offsetWidth, { display: "block" })
      *
-     * @param {function} cb Callback fn
+     * @param {Function} cb Callback fn
      * @param {any} [style] Temp style
      * @returns {any} Callback result
      */
@@ -125,14 +123,5 @@ export class PicoDomAttributeInstance {
      * @returns {PicoDom} Current instance
      */
     stateClass(cls: any, state?: boolean): PicoDom;
-    /**
-     * @see PicoDom.style
-     */
-    css(...args: any[]): any;
-    /**
-     * @see PicoDom.remClass
-     */
-    removeClass(...args: any[]): PicoDom;
 }
-export function PicoDomAttributePlugin(self: typeof PicoDom): typeof PicoDom;
-import { PicoDom } from "../utils/Dom.js";
+export default PicoDomAttribute;

package/types/dom/DomBuilder.d.ts

@@ -1,7 +1,11 @@
+import { PicoDom, PicoDomInterface } from "../utils/Dom.ts";
+import PicoDomFinder from "./DomFinder.js";
+export interface PicoDomBuilder extends PicoDomInterface, PicoDomFinder {
+}
 /**
  * @memberof PicoDom
  */
-export class PicoDomBuilderStatic {
+export declare class PicoDomBuilder {
     /**
      * Create element from tag
      *
@@ -12,12 +16,6 @@ export class PicoDomBuilderStatic {
      * @returns {PicoDom} Dom instance
      */
     static make(el: any, options?: any): PicoDom;
-}
-/**
- * @memberof PicoDom
- * @extends {PicoDom}
- */
-export class PicoDomBuilderInstance {
     /**
      * Prepend value to element
      *
@@ -64,5 +62,4 @@ export class PicoDomBuilderInstance {
      */
     replace(value: any): PicoDom;
 }
-export function PicoDomBuilderPlugin(self: typeof PicoDom): typeof PicoDom;
-import { PicoDom } from "../utils/Dom.js";
+export default PicoDomBuilder;