@kizmann/pico-js 2.0.7 → 2.0.9

package/types/utils/String.d.ts

@@ -1,14 +1,15 @@
-export class PicoString {
+import { Str } from "../index.esm.ts";
+export declare class PicoString {
     /**
      * Get character at index
      *
      * @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: any, index: any): string;
+    static get(value: any, index: number): string;
     /**
      * Replace substring at index
      *
@@ -41,7 +42,7 @@ export class PicoString {
      * @param {any} [search] Match source
      * @returns {string|null} Extracted string
      */
-    static extract(value: any, replace: string, search?: any): string | null;
+    static extract(value: any, replace: string, search?: any): string;
     /**
      * Match pattern in string
      *
@@ -49,19 +50,19 @@ 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: any, pattern: RegExp | string, cb?: any): any;
+    static match(value: any, pattern: RegExp | string, cb?: Function): any;
     /**
      * Escape regex characters
      *
      * @example Str.regex("a.b") // => "a\\.b"
      *
-     * @param {any} val Input string
+     * @param {any} value Input string
      * @returns {string} Escaped string
      */
-    static regex(val: any): string;
+    static regex(value: any): string;
     /**
      * Convert to uppercase
      *
@@ -80,10 +81,10 @@ 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: string): string;
+    static ucfirst(value: any): string;
     /**
      * Convert to lowercase
      *
@@ -102,19 +103,19 @@ 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: string): string;
+    static lcfirst(value: any): string;
     /**
      * Convert to camelCase
      *
      * @example Str.cc("hello-world") // => "helloWorld"
      *
-     * @param {string} value Input string
+     * @param {any} value Input string
      * @returns {string} camelCase string
      */
-    static cc(value: string): string;
+    static cc(value: any): string;
     /**
      * @see PicoString.cc
      */
@@ -124,10 +125,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: string): string;
+    static kc(value: any): string;
     /**
      * @see PicoString.kc
      */
@@ -137,10 +138,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: string): string;
+    static sc(value: any): string;
     /**
      * @see PicoString.sc
      */
@@ -150,10 +151,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: string): string;
+    static pc(value: any): string;
     /**
      * @see PicoString.pc
      */
@@ -163,11 +164,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: string, search: string): boolean;
+    static has(value: any, search: any): boolean;
     /**
      * Get index range of search
      *
@@ -176,9 +177,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: any, search: string, fallback?: any): Array<number> | any;
+    static range(value: any, search: string, fallback?: any): number[] | any;
     /**
      * Extract substring by range
      *
@@ -196,11 +197,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: any, empty?: any, html?: boolean): string;
+    static string(value: any, empty?: string, html?: boolean): string;
     /**
      * Get boolean representation
      *
@@ -209,10 +210,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: any, yes?: string, no?: string, empty?: any): string | any;
+    static boolean(value: any, yes?: string, no?: string, empty?: string): string;
     /**
      * Get formatted number
      *
@@ -222,9 +223,9 @@ 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: any, fixed?: number, locale?: string, config?: any): string | any;
+    static number(value: any, fixed?: number, locale?: string, config?: any): string;
     /**
      * Get formatted integer
      *
@@ -235,7 +236,7 @@ export class PicoString {
      * @param {string} [padding] Padding char
      * @returns {string|any} Formatted string
      */
-    static integer(value: any, leading?: number, padding?: string): string | any;
+    static integer(value: any, leading?: number, padding?: string): string;
     /**
      * Get formatted datetime
      *
@@ -243,10 +244,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 datetime(value: any, format?: string, empty?: any): string;
+    static datetime(value: any, format?: string, empty?: string): string;
     /**
      * Get formatted date
      *
@@ -254,10 +255,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: any, format?: string, empty?: any): string;
+    static date(value: any, format?: string, empty?: string): string;
     /**
      * Get formatted time
      *
@@ -268,7 +269,7 @@ export class PicoString {
      * @param {any} [empty] Empty fallback
      * @returns {string} Formatted string
      */
-    static time(value: any, format?: string, empty?: any): string;
+    static time(value: any, format?: string, empty?: string): string;
     /**
      * Parse string to object
      *
@@ -291,41 +292,4 @@ export class PicoString {
      */
     static stringify(value: any, mode?: string): string;
 }
-export namespace PicoString {
-    /**
-     * @see PicoStr.regex
-     */
-    function regexEscape(...args: any[]): string;
-    /**
-     * @see PicoStr.pascalcase
-     */
-    function humancase(...args: any[]): string;
-    /**
-     * @see PicoFormat.slugify
-     */
-    function slugify(...args: any[]): any;
-    /**
-     * @see PicoFormat.castOptions
-     */
-    function options(...args: any[]): any;
-    /**
-     * @see PicoFormat.parseOptions
-     */
-    function fromOptions(...args: any[]): any;
-    /**
-     * @see PicoFormat.castParams
-     */
-    function params(...args: any[]): any;
-    /**
-     * @see PicoFormat.parseParams
-     */
-    function fromParams(...args: any[]): any;
-    /**
-     * @see PicoFormat.filesize
-     */
-    function filesize(...args: any[]): any;
-    function real(): void;
-    function array(): void;
-}
-export default Str;
-import { Str } from "../index.esm.js";
+export default PicoString;

package/src/dom/DomForm.js

@@ -1,59 +0,0 @@
-import { Mix, Obj } from "../index.esm.js";
-import { PicoDom } from "../utils/Dom.js";
-
-/**
- * @memberof PicoDom
- */
-export class PicoDomFormStatic
-{
-
-}
-
-/**
- * @memberof PicoDom
- * @extends {PicoDom}
- */
-export class PicoDomFormInstance
-{
-
-    /**
-     * Get or set input value
-     *
-     * @example Dom.find("input").value("hello")
-     *
-     * @param {any} [value] Input value
-     * @returns {any|PicoDom} Value or instance
-     */
-    value(value = undefined)
-    {
-        if ( value === undefined ) {
-            return this.el.value;
-        }
-
-        this.each((el) => {
-            el.value = value;
-        });
-
-        return this;
-    }
-
-}
-
-/**
- * @param {typeof PicoDom} self
- * @returns {typeof PicoDom}
- */
-export const PicoDomFormPlugin = function (self) {
-
-    Obj.each(Mix.class(PicoDomFormStatic), (fn, id) => {
-        self[id] = fn;
-    });
-
-    Obj.each(Mix.proto(PicoDomFormInstance), (fn, id) => {
-        self.prototype[id] = fn;
-    });
-
-    // self.init.push(PicoDomFormInstance.constructor);
-
-    return self;
-}

package/src/dom/DomMeta.js

@@ -1,68 +0,0 @@
-import { Arr, Mix, Obj, Dom, Locale } from "../index.esm.js";
-import { PicoDom } from "../utils/Dom.js";
-
-/**
- * @memberof PicoDom
- */
-export class PicoDomMetaStatic
-{
-    static $meta = {};
-
-    /**
-     * Set document title
-     *
-     * @example Dom.setMetaTitle("Home")
-     *
-     * @param {string} value New title
-     * @param {string} [glue] Title glue
-     * @returns {PicoDom} Static class
-     */
-    static setMetaTitle(value, glue = ':value - :title')
-    {
-        if ( ! this.$meta.title ) {
-            this.$meta.title = Dom.doc().title;
-        }
-
-        document.title = Locale.replace(glue, {
-            value, title: this.$meta.title
-        });
-
-        return this;
-    }
-}
-
-/**
- * @see PicoDom.setMetaTitle
- */
-PicoDomMetaStatic.title = (value) => {
-    console.warn('Dom.title() is deprecated, use Dom.setMetaTitle() instead.');
-    return Dom.setMetaTitle(value);
-};
-
-/**
- * @memberof PicoDom
- * @extends {PicoDom}
- */
-export class PicoDomMetaInstance
-{
-
-}
-
-/**
- * @param {typeof PicoDom} self
- * @returns {typeof PicoDom}
- */
-export const PicoDomMetaPlugin = function (self) {
-
-    Obj.each(Mix.class(PicoDomMetaStatic), (fn, id) => {
-        self[id] = fn;
-    });
-
-    Obj.each(Mix.proto(PicoDomMetaInstance), (fn, id) => {
-        self.prototype[id] = fn;
-    });
-
-    // self.init.push(PicoDomMetaInstance.constructor);
-
-    return self;
-}

package/src/dom/DomObserver.js

@@ -1,38 +0,0 @@
-import { Arr, Mix, Obj, Dom } from "../index.esm.js";
-import { PicoDom } from "../utils/Dom.js";
-
-/**
- * @memberof PicoDom
- */
-export class PicoDomObserverStatic
-{
-
-}
-
-/**
- * @memberof PicoDom
- * @extends {PicoDom}
- */
-export class PicoDomObserverInstance
-{
-    //
-}
-
-/**
- * @param {typeof PicoDom} self
- * @returns {typeof PicoDom}
- */
-export const PicoDomObserverPlugin = function (self) {
-
-    Obj.each(Mix.class(PicoDomObserverStatic), (fn, id) => {
-        self[id] = fn;
-    });
-
-    Obj.each(Mix.proto(PicoDomObserverInstance), (fn, id) => {
-        self.prototype[id] = fn;
-    });
-
-    // self.init.push(PicoDomObserverInstance.constructor);
-
-    return self;
-}

package/src/index.browser.js

@@ -1,36 +0,0 @@
-import * as pi from "./index.esm.js";
-
-/**
- * @typedef {Object} PicoLibrary
- * @property {function(): *} [go]
- * @property {function(): void} [browser]
- * @property {function(): void} [device]
- * @property {PicoDom} [Dom]
- * @property {PicoNow} [Now]
- * @property {PicoFormat} [For]
- * @property {PicoArray} [Arr]
- * @property {PicoMixed} [Mix]
- * @property {PicoNumber} [Num]
- * @property {PicoObject} [Obj]
- * @property {PicoRunner} [Run]
- * @property {PicoString} [Str]
- * @property {PicoHash} [Hash]
- * @property {PicoEvent} [Event]
- * @property {PicoLocale} [Locale]
- * @property {PicoCookie} [Cookie]
- * @property {PicoData} [Data]
- * @property {PicoRoute} [Route]
- * @property {PicoMap} [Map]
- * @property {PicoElement} [Element]
- */
-
-/**
- * @type {PicoLibrary}
- */
-globalThis.pi = pi;
-
-globalThis.addEventListener && globalThis.addEventListener('beforeunload', (e) => {
-    pi.Arr.map(pi.Dom.$events, ({ el, cb, event }) => {
-        return (el.removeEventListener(event, cb), null);
-    });
-});

package/src/index.esm.js

@@ -1,80 +0,0 @@
-import { PicoRunner, default as Run } from "./utils/Runner.js";
-import { PicoString, default as Str } from "./utils/String.js";
-import { PicoNumber, default as Num } from "./utils/Number.js";
-import { PicoArray, default as Arr } from "./utils/Array.js";
-import { PicoObject, default as Obj } from "./utils/Object.js";
-import { PicoMixed, default as Mix } from "./utils/Mixed.js";
-import { PicoHash, default as Hash } from "./utils/Hash.js";
-import { PicoSignal, default as Signal } from "./utils/Signal.js";
-import { PicoLocale, default as Locale } from "./utils/Locale.js";
-import { PicoCookie, default as Cookie } from "./utils/Cookie.js";
-
-/**
- * @type {typeof PicoDom}
- */
-const Dom = DomBuilder();
-
-/**
- * @type {typeof PicoNow}
- */
-const Now = NowBuilder();
-
-/**
- * @type {typeof PicoFormat}
- */
-const For = ForBuilder();
-
-export {
-    Dom, Now, For, Run, Str, Num, Arr, Obj, Mix, Hash, Signal, Locale, Cookie
-}
-
-import { PicoDom, default as DomBuilder } from "./utils/Dom.js";
-import { PicoNow, default as NowBuilder } from "./utils/Now.js";
-import { PicoFormat, default as ForBuilder } from "./utils/Format.js";
-
-import { go, browser, device } from "./tool/scope.js";
-export { go, browser, device };
-
-// You will be removed soon
-import { default as Data } from "./utils/Data.js";
-import { default as Route } from "./utils/Route.js";
-
-export {
-    Map, Data
-}
-
-// Work in progress (not started yet)
-import { default as Map } from "./wip/Map.js";
-import { default as Element } from "./wip/Element.js";
-
-export {
-    Route, Element
-}
-
-/**
- * @type {typeof PicoMixed}
- */
-export const Any = new Proxy({}, {
-    get: function (target, prop) {
-        console.warn(`Any.${prop} is deprecated, use Mix.${prop}() instead.`);
-        return (...args) => Mix[prop](...args);
-    }
-});
-
-/**
- * @type {typeof PicoMixed}
- */
-export const Event = new Proxy({}, {
-    get: function (target, prop) {
-        console.warn(`Event.${prop} is deprecated, use Signal.${prop}() instead.`);
-        return (...args) => Signal[prop](...args);
-    }
-});
-
-/**
- * @returns {string}
- */
-export const UUID = function () {
-    console.warn('UUID() is deprecated, use Hash.make() instead.');
-    return Hash.make();
-};