@kizmann/pico-js 2.0.0 → 2.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kizmann/pico-js",
-    "version": "2.0.0",
+    "version": "2.0.2",
     "license": "MIT",
     "type": "module",
     "private": false,
@@ -9,6 +9,12 @@
     "main": "src/index.esm.js",
     "unpkg": "dist/pico-js.browser.js",
     "types": "types/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./types/index.d.ts",
+            "import": "./src/index.esm.js"
+        }
+    },
     "imports": {
         "#src/*": "./src/*"
     },
@@ -49,7 +55,6 @@
         "sass-loader": "^12.0.0",
         "terser-webpack-plugin": "^4.2.3",
         "tinybench": "^6.0.0",
-        "tsc-alias": "^1.8.16",
         "typescript": "^5.9.3",
         "webpack": "^5.0.0",
         "webpack-cli": "^4.0.0",

package/src/dom/DomAttribute.js

@@ -1,4 +1,5 @@
-import { Arr, Dom, For, Mix, Obj } from "#src/index.esm.js";
+import { Arr, Dom, For, Mix, Obj } from "../index.esm.js";
+import { PicoDom } from "../utils/Dom.js";
 
 /**
  * @memberof PicoDom
@@ -22,7 +23,7 @@ export class PicoDomAttributeInstance
      * @param {string} key Attr key
      * @param {any} [value] Attr value
      * @param {any} [fallback] Fallback value
-     * @returns {any|this} Attr value or instance
+     * @returns {any|PicoDom} Attr value or instance
      */
     attr(key, value = undefined, fallback = null)
     {
@@ -61,7 +62,7 @@ export class PicoDomAttributeInstance
      * @param {string} key Data key
      * @param {any} [value] Data value
      * @param {any} [fallback] Fallback value
-     * @returns {any|this} Data value or instance
+     * @returns {any|PicoDom} Data value or instance
      */
     data(key, value = undefined, fallback = null)
     {
@@ -103,7 +104,7 @@ export class PicoDomAttributeInstance
      *
      * @param {any} [value] Style value
      * @param {boolean} [combine] Combine style
-     * @returns {any|this} Style or instance
+     * @returns {any|PicoDom} Style or instance
      */
     style(value = undefined, combine = true)
     {
@@ -141,7 +142,7 @@ export class PicoDomAttributeInstance
      *
      * @param {any} [value] Class value
      * @param {boolean} [combine] Combine classes
-     * @returns {any|this} Classes or instance
+     * @returns {any|PicoDom} Classes or instance
      */
     class(value = undefined, combine = false)
     {
@@ -178,7 +179,7 @@ export class PicoDomAttributeInstance
      * @example Dom.find("div").html("<span></span>")
      *
      * @param {any} [html] HTML content
-     * @returns {string|this} HTML or instance
+     * @returns {string|PicoDom} HTML or instance
      */
     html(html = undefined)
     {
@@ -238,7 +239,7 @@ export class PicoDomAttributeInstance
      * @example Dom.find("div").addClass("active")
      *
      * @param {any} cls Class name
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     addClass(cls)
     {
@@ -269,7 +270,7 @@ export class PicoDomAttributeInstance
      * @example Dom.find("div").remClass("active")
      *
      * @param {any} cls Class name
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     remClass(cls)
     {
@@ -300,7 +301,7 @@ export class PicoDomAttributeInstance
      * @example Dom.find("div").toggleClass("active")
      *
      * @param {any} cls Class name
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     toggleClass(cls)
     {
@@ -322,7 +323,7 @@ export class PicoDomAttributeInstance
      *
      * @param {any} cls Class name
      * @param {boolean} [state] Target state
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     stateClass(cls, state = true)
     {
@@ -356,7 +357,8 @@ PicoDomAttributeInstance.prototype.removeClass = function (...args) {
 };
 
 /**
- * @returns {typeof import('#src/utils/Dom.js').PicoDom}
+ * @param {typeof PicoDom} self
+ * @returns {typeof PicoDom}
  */
 export const PicoDomAttributePlugin = function (self) {
 

package/src/dom/DomBuilder.js

@@ -1,4 +1,5 @@
-import { Arr, Dom, Mix, Obj } from "#src/index.esm.js";
+import { Arr, Dom, Mix, Obj } from "../index.esm.js";
+import { PicoDom } from "../utils/Dom.js";
 
 /**
  * @memberof PicoDom
@@ -52,7 +53,7 @@ export class PicoDomBuilderInstance
      * @example Dom.find("div").prepend("<span></span>")
      *
      * @param {any} value Prepend value
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     prepend(value)
     {
@@ -69,7 +70,7 @@ export class PicoDomBuilderInstance
      * @example Dom.find("span").prependTo("div")
      *
      * @param {any} value Target element
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     prependTo(value)
     {
@@ -86,7 +87,7 @@ export class PicoDomBuilderInstance
      * @example Dom.find("div").append("<span></span>")
      *
      * @param {any} value Append value
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     append(value)
     {
@@ -103,7 +104,7 @@ export class PicoDomBuilderInstance
      * @example Dom.find("span").appendTo("div")
      *
      * @param {any} value Target element
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     appendTo(value)
     {
@@ -120,7 +121,7 @@ export class PicoDomBuilderInstance
      * @example Dom.find("div").replace("<span></span>")
      *
      * @param {any} value Replacement value
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     replace(value)
     {
@@ -134,7 +135,8 @@ export class PicoDomBuilderInstance
 }
 
 /**
- * @returns {typeof import('#src/utils/Dom.js').PicoDom}
+ * @param {typeof PicoDom} self
+ * @returns {typeof PicoDom}
  */
 export const PicoDomBuilderPlugin = function (self) {
 

package/src/dom/DomEvent.js

@@ -1,4 +1,5 @@
-import { Arr, Hash, Mix, Obj, Dom } from "#src/index.esm.js";
+import { Arr, Hash, Mix, Obj, Dom } from "../index.esm.js";
+import { PicoDom } from "../utils/Dom.js";
 
 /**
  * @memberof PicoDom
@@ -26,7 +27,7 @@ export class PicoDomEventInstance
      * @param {string} [selector] Event selector
      * @param {boolean} [pause] Pause listener
      * @param {any} [options] Listener options
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     bind(el, event, cb, selector = null, pause = false, options = {})
     {
@@ -52,7 +53,7 @@ export class PicoDomEventInstance
      * @param {string} event Event name
      * @param {string} [selector] Event selector
      * @param {any} [options] Listener options
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     unbind(el, event, selector = null, options = {})
     {
@@ -91,7 +92,7 @@ export class PicoDomEventInstance
      * @param {any} [options] Listener options
      * @param {boolean} [pause] Pause listener
      * @param {string} [selector] Event selector
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     on(event, cb, options = {}, pause = false, selector = null)
     {
@@ -122,7 +123,7 @@ export class PicoDomEventInstance
      * @param {any} event Event name
      * @param {string} [selector] Event selector
      * @param {any} [options] Listener options
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     off(event, selector = null, options = {})
     {
@@ -149,7 +150,7 @@ export class PicoDomEventInstance
      * @param {any} event Event name
      * @param {function} cb Callback fn
      * @param {any} [options] Listener options
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     once(event, cb, options = {})
     {
@@ -172,7 +173,7 @@ export class PicoDomEventInstance
      * @param {function} cb Callback fn
      * @param {any} [options] Listener options
      * @param {boolean} [pause] Pause listener
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     live(event, selector, cb, options = {}, pause = false)
     {
@@ -198,7 +199,7 @@ export class PicoDomEventInstance
      * @example Dom.find("div").fire("click")
      *
      * @param {string} event Event name
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     fire(event)
     {
@@ -235,7 +236,8 @@ PicoDomEventInstance.prototype.unpause = function () {
 };
 
 /**
- * @returns {typeof import('#src/utils/Dom.js').PicoDom}
+ * @param {typeof PicoDom} self
+ * @returns {typeof PicoDom}
  */
 export const PicoDomEventPlugin = function (self) {
 

package/src/dom/DomFinder.js

@@ -1,4 +1,5 @@
-import { Arr, Mix, Obj, Dom } from "#src/index.esm.js";
+import { Arr, Mix, Obj, Dom } from "../index.esm.js";
+import { PicoDom } from "../utils/Dom.js";
 
 /**
  * @memberof PicoDom
@@ -209,7 +210,7 @@ export class PicoDomFinderInstance
      * @example Dom.find("div").sanatize(1)
      *
      * @param {number} [filter] Node type
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     sanatize(filter = 1)
     {
@@ -332,7 +333,7 @@ export class PicoDomFinderInstance
      * @example Dom.find("div").each((el) => console.log(el))
      *
      * @param {function} cb Callback fn
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     each(cb)
     {
@@ -346,7 +347,7 @@ export class PicoDomFinderInstance
      *
      * @param {function} cb Callback fn
      * @param {any} [boundry] Loop limit
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     loopParent(cb, boundry = null)
     {
@@ -651,7 +652,8 @@ PicoDomFinderInstance.prototype.getNot = () => {
 };
 
 /**
- * @returns {typeof import('#src/utils/Dom.js').PicoDom}
+ * @param {typeof PicoDom} self
+ * @returns {typeof PicoDom}
  */
 export const PicoDomFinderPlugin = function (self) {
 

package/src/dom/DomForm.js

@@ -1,4 +1,5 @@
-import { Arr, Mix, Obj, Dom } from "#src/index.esm.js";
+import { Mix, Obj } from "../index.esm.js";
+import { PicoDom } from "../utils/Dom.js";
 
 /**
  * @memberof PicoDom
@@ -21,7 +22,7 @@ export class PicoDomFormInstance
      * @example Dom.find("input").value("hello")
      *
      * @param {any} [value] Input value
-     * @returns {any|this} Value or instance
+     * @returns {any|PicoDom} Value or instance
      */
     value(value = undefined)
     {
@@ -39,7 +40,8 @@ export class PicoDomFormInstance
 }
 
 /**
- * @returns {typeof import('#src/utils/Dom.js').PicoDom}
+ * @param {typeof PicoDom} self
+ * @returns {typeof PicoDom}
  */
 export const PicoDomFormPlugin = function (self) {
 

package/src/dom/DomGlobal.js

@@ -1,4 +1,5 @@
-import { Run, Mix, Obj, Dom } from "#src/index.esm.js";
+import { Run, Mix, Obj, Dom } from "../index.esm.js";
+import { PicoDom } from "../utils/Dom.js";
 
 /**
  * @memberof PicoDom
@@ -55,7 +56,7 @@ export class PicoDomGlobalStatic
      * @param {function} cb Callback fn
      * @param {number} [delay] Execution delay
      * @param {number} [limit] Wait limit
-     * @returns {this} Static class
+     * @returns {PicoDom} Static class
      */
     static ready(cb, delay = 0, limit = 6000)
     {
@@ -88,7 +89,7 @@ export class PicoDomGlobalStatic
      * @param {function} cb Callback fn
      * @param {number} [delay] Execution delay
      * @param {number} [limit] Wait limit
-     * @returns {this} Static class
+     * @returns {PicoDom} Static class
      */
     static complete(cb, delay = 0, limit = 6000)
     {
@@ -156,7 +157,7 @@ export class PicoDomGlobalInstance
      *
      * @param {function} cb Callback fn
      * @param {number} [limit] Wait limit
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     loaded(cb, limit = 6000)
     {
@@ -175,7 +176,8 @@ export class PicoDomGlobalInstance
 }
 
 /**
- * @returns {typeof import('#src/utils/Dom.js').PicoDom}
+ * @param {typeof PicoDom} self
+ * @returns {typeof PicoDom}
  */
 export const PicoDomGlobalPlugin = function (self) {
 

package/src/dom/DomInview.js

@@ -1,4 +1,5 @@
-import { Arr, Dom, Mix, Obj } from "#src/index.esm.js";
+import { Arr, Dom, Mix, Obj } from "../index.esm.js";
+import { PicoDom } from "../utils/Dom.js";
 
 /**
  * @memberof PicoDom
@@ -314,7 +315,8 @@ PicoDomInviewInstance.prototype.inviewWidth = function (...args) {
 }
 
 /**
- * @returns {typeof import('#src/utils/Dom.js').PicoDom}
+ * @param {typeof PicoDom} self
+ * @returns {typeof PicoDom}
  */
 export const PicoDomInviewPlugin = function (self) {
 

package/src/dom/DomMeta.js

@@ -1,4 +1,5 @@
-import { Arr, Mix, Obj, Dom, Locale } from "#src/index.esm.js";
+import { Arr, Mix, Obj, Dom, Locale } from "../index.esm.js";
+import { PicoDom } from "../utils/Dom.js";
 
 /**
  * @memberof PicoDom
@@ -14,7 +15,7 @@ export class PicoDomMetaStatic
      *
      * @param {string} value New title
      * @param {string} [glue] Title glue
-     * @returns {this} Static class
+     * @returns {PicoDom} Static class
      */
     static setMetaTitle(value, glue = ':value - :title')
     {
@@ -48,7 +49,8 @@ export class PicoDomMetaInstance
 }
 
 /**
- * @returns {typeof import('#src/utils/Dom.js').PicoDom}
+ * @param {typeof PicoDom} self
+ * @returns {typeof PicoDom}
  */
 export const PicoDomMetaPlugin = function (self) {
 

package/src/dom/DomObserver.js

@@ -1,4 +1,5 @@
-import { Arr, Mix, Obj, Dom } from "#src/index.esm.js";
+import { Arr, Mix, Obj, Dom } from "../index.esm.js";
+import { PicoDom } from "../utils/Dom.js";
 
 /**
  * @memberof PicoDom
@@ -21,7 +22,7 @@ export class PicoDomObserverInstance
      * @example Dom.find("input").value("hello")
      *
      * @param {any} [value] New value
-     * @returns {any|this} Value or instance
+     * @returns {any|PicoDom} Value or instance
      */
     value(value = undefined)
     {
@@ -39,7 +40,8 @@ export class PicoDomObserverInstance
 }
 
 /**
- * @returns {typeof import('#src/utils/Dom.js').PicoDom}
+ * @param {typeof PicoDom} self
+ * @returns {typeof PicoDom}
  */
 export const PicoDomObserverPlugin = function (self) {
 

package/src/dom/DomRectangle.js

@@ -1,5 +1,5 @@
-import { Arr, Dom, Mix, Obj } from "#src/index.esm.js";
-
+import { Arr, Dom, Mix, Obj } from "../index.esm.js";
+import { PicoDom } from "../utils/Dom.js";
 
 /**
  * @memberof PicoDom
@@ -409,7 +409,7 @@ export class PicoDomRectangleInstance
      *
      * @param {function} cb Callback fn
      * @param {any} [boundry] Loop limit
-     * @returns {this} Current instance
+     * @returns {PicoDom} Current instance
      */
     loopOffset(cb, boundry = null)
     {
@@ -529,7 +529,7 @@ export class PicoDomRectangleInstance
      *
      * @param {any} [value] Scroll value
      * @param {any} [boundry] View boundry
-     * @returns {number|this} Value or instance
+     * @returns {number|PicoDom} Value or instance
      */
     scrollTop(value = null, boundry = null)
     {
@@ -551,7 +551,7 @@ export class PicoDomRectangleInstance
      *
      * @param {any} [value] Scroll value
      * @param {any} [boundry] View boundry
-     * @returns {number|this} Value or instance
+     * @returns {number|PicoDom} Value or instance
      */
     scrollLeft(value = null, boundry = null)
     {
@@ -639,7 +639,8 @@ PicoDomRectangleInstance.prototype.scrollLeftGlobal = function () {
 };
 
 /**
- * @returns {typeof import('#src/utils/Dom.js').PicoDom}
+ * @param {typeof PicoDom} self
+ * @returns {typeof PicoDom}
  */
 export const PicoDomRectanglePlugin = function (self) {
 

package/src/format/FormatFile.js

@@ -1,4 +1,5 @@
-import { Mix, Obj, Num } from "#src/index.esm.js";
+import { Mix, Obj, Num } from "../index.esm.js";
+import { PicoFormat } from "../utils/Format.js";
 
 export const FILE_UNITS = [
     'B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'
@@ -42,7 +43,8 @@ export class PicoFormatFileStatic
 }
 
 /**
- * @returns {typeof import('#src/utils/Format.js').PicoFormat}
+ * @param {typeof PicoFormat} self
+ * @returns {typeof PicoFormat}
  */
 export const PicoFormatFilePlugin = function (self) {
 

package/src/format/FormatOption.js

@@ -1,4 +1,5 @@
-import { Arr, For, Mix, Obj } from "#src/index.esm.js";
+import { Arr, For, Mix, Obj } from "../index.esm.js";
+import { PicoFormat } from "../utils/Format.js";
 
 export const OPTION_REGEX = {
     entry: /(^|;)(\s*(?<key>.*?)\s*:\s*(?<val>".*?"|'.*?'|.*?)\s*)(?=;|$)/g
@@ -96,7 +97,8 @@ export class PicoFormatOptionStatic
 }
 
 /**
- * @returns {typeof import('#src/utils/Format.js').PicoFormat}
+ * @param {typeof PicoFormat} self
+ * @returns {typeof PicoFormat}
  */
 export const PicoFormatOptionPlugin = function (self) {
 

package/src/format/FormatParam.js

@@ -1,4 +1,5 @@
-import { Arr, Mix, Obj, For } from "#src/index.esm.js";
+import { Arr, Mix, Obj, For } from "../index.esm.js";
+import { PicoFormat } from "../utils/Format.js";
 
 export const PARAM_REGEX = {
     entry: /(?<=^|&|\?)(\s*(?<key>.*?)\s*=\s*(?<val>".*?"|'.*?'|.*?)\s*)(?=&|$)/g
@@ -95,7 +96,8 @@ export class PicoFormatParamStatic
 }
 
 /**
- * @returns {typeof import('#src/utils/Format.js').PicoFormat}
+ * @param {typeof PicoFormat} self
+ * @returns {typeof PicoFormat}
  */
 export const PicoFormatParamPlugin = function (self) {
 

package/src/format/FormatParser.js

@@ -1,4 +1,5 @@
-import { Mix, Obj } from "#src/index.esm.js";
+import { Mix, Obj } from "../index.esm.js";
+import { PicoFormat } from "../utils/Format.js";
 
 export const TYPE_PARSERS = [
     { // null
@@ -144,7 +145,8 @@ export class PicoFormatParserStatic
 }
 
 /**
- * @returns {typeof import('#src/utils/Format.js').PicoFormat}
+ * @param {typeof PicoFormat} self
+ * @returns {typeof PicoFormat}
  */
 export const PicoFormatParserPlugin = function (self) {
 

package/src/format/FormatUrl.js

@@ -1,4 +1,5 @@
-import { Arr, Mix, Obj } from "#src/index.esm.js";
+import { Arr, Mix, Obj } from "../index.esm.js";
+import { PicoFormat } from "../utils/Format.js";
 
 export const SLUG_CONVERT = [
     ['à', 'a'],
@@ -63,7 +64,8 @@ export class PicoFormatUrlStatic
 }
 
 /**
- * @returns {typeof import('#src/utils/Format.js').PicoFormat}
+ * @param {typeof PicoFormat} self
+ * @returns {typeof PicoFormat}
  */
 export const PicoFormatUrlPlugin = function (self) {
 

package/src/index.browser.js

@@ -1,10 +1,30 @@
-import * as pi from "#src/index.esm.js";
+import * as pi from "./index.esm.js";
 
-// Force immediate global access
-if (typeof globalThis !== 'undefined') {
-    if ( globalThis.pi === undefined ) {
-        globalThis.pi = pi;
-    } else {
-        globalThis.pix = pi;
-    }
-}
+/**
+ * @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;