@kizmann/pico-js 0.5.5 → 1.0.1

package/docs/style.css

@@ -1,41 +0,0 @@
-
-* {
-    outline: none;
-}
-
-html, body {
-    -webkit-font-smoothing: subpixel-antialiased;
-    -moz-osx-font-smoothing: grayscale;
-    font-size: 15px;
-    font-variant-numeric: normal;
-    font-feature-settings: normal;
-}
-
-body {
-    font-size: 14px;
-    min-height: 100vh;
-}
-
-#app {
-    max-width: 1024px;
-    width: 100%;
-    margin: 0 auto;
-    padding: 30px;
-}
-
-pre {
-    font-family: 'Fira Code', monospace;
-}
-
-.n-inverse pre {
-    color: #fff;
-}
-
-#app > .n-form {
-    border-radius: 4px;
-    padding: 30px;
-}
-
-.n-inverse {
-    background: #32383e;
-}

package/docs/utility/any.md

@@ -1,427 +0,0 @@
-# Any Utility
-
-The `Any` class provides a wide range of utility functions for various data type checks, conversions, and operations such as debounce and throttle. This class is part of a larger utility library and can be imported as shown below.
-
-Here is a list of all headlines with anchor links:
-
-- [isEmpty](#isempty)
-- [isNull](#isnull)
-- [isEqual](#isequal)
-- [isString](#isstring)
-- [isNumber](#isnumber)
-- [isBool](#isbool)
-- [isFunction](#isfunction)
-- [isObject](#isobject)
-- [isPlain](#isplain)
-- [isArray](#isarray)
-- [isDate](#isdate)
-- [string](#string)
-- [convertString](#convertstring)
-- [integer](#integer)
-- [float](#float)
-- [bool](#bool)
-- [boolean](#boolean)
-- [convertBool](#convertbool)
-- [convertBoolean](#convertboolean)
-- [convertDatetime](#convertdatetime)
-- [vals](#vals)
-- [keys](#keys)
-- [async](#async)
-- [delay](#delay)
-- [debounce](#debounce)
-- [throttle](#throttle)
-- [framerate](#framerate)
-- [form](#form)
-
-You can click on any of these links to navigate to the respective section in the documentation.
-
-## Import
-
-```javascript
-import { Any } from "../index.js";
-```
-
-## Methods
-
-### [isEmpty](#isempty)
-
-Checks if a value is empty.
-
-- **Parameters**:
-    - `val`: The value to check.
-- **Returns**: `true` if the value is empty, `false` otherwise.
-
-```javascript
-Any.isEmpty(''); // true
-Any.isEmpty([]); // true
-Any.isEmpty({}); // true
-Any.isEmpty(0);  // false
-```
-
-### [isNull](#isnull)
-
-Checks if a value is `null`.
-
-- **Parameters**:
-    - `val`: The value to check.
-- **Returns**: `true` if the value is `null`, `false` otherwise.
-
-```javascript
-Any.isNull(null); // true
-Any.isNull(undefined); // false
-```
-
-### [isEqual](#isequal)
-
-Checks if two values are equal.
-
-- **Parameters**:
-    - `obj`: The first value.
-    - `val`: The second value.
-- **Returns**: `true` if the values are equal, `false` otherwise.
-
-```javascript
-Any.isEqual(1, '1'); // false
-Any.isEqual({a: 1}, {a: 1}); // true
-```
-
-### [isString](#isstring)
-
-Checks if a value is a string.
-
-- **Parameters**:
-    - `val`: The value to check.
-- **Returns**: `true` if the value is a string, `false` otherwise.
-
-```javascript
-Any.isString('hello'); // true
-Any.isString(123); // false
-```
-
-### [isNumber](#isnumber)
-
-Checks if a value is a number or a numeric string.
-
-- **Parameters**:
-    - `val`: The value to check.
-- **Returns**: `true` if the value is a number or numeric string, `false` otherwise.
-
-```javascript
-Any.isNumber(123); // true
-Any.isNumber('123'); // true
-Any.isNumber('abc'); // false
-```
-
-### [isBool](#isbool)
-
-Checks if a value is a boolean or a boolean string.
-
-- **Parameters**:
-    - `val`: The value to check.
-- **Returns**: `true` if the value is a boolean or boolean string, `false` otherwise.
-
-```javascript
-Any.isBool(true); // true
-Any.isBool('false'); // true
-Any.isBool('yes'); // false
-```
-
-### [isFunction](#isfunction)
-
-Checks if a value is a function.
-
-- **Parameters**:
-    - `val`: The value to check.
-- **Returns**: `true` if the value is a function, `false` otherwise.
-
-```javascript
-Any.isFunction(function() {}); // true
-Any.isFunction(() => {}); // true
-```
-
-### [isObject](#isobject)
-
-Checks if a value is an object.
-
-- **Parameters**:
-    - `val`: The value to check.
-- **Returns**: `true` if the value is an object, `false` otherwise.
-
-```javascript
-Any.isObject({}); // true
-Any.isObject(null); // false
-```
-
-### [isPlain](#isplain)
-
-Checks if a value is a plain object.
-
-- **Parameters**:
-    - `val`: The value to check.
-- **Returns**: `true` if the value is a plain object, `false` otherwise.
-
-```javascript
-Any.isPlain({}); // true
-Any.isPlain(new Date()); // false
-```
-
-### [isArray](#isarray)
-
-Checks if a value is an array.
-
-- **Parameters**:
-    - `val`: The value to check.
-- **Returns**: `true` if the value is an array, `false` otherwise.
-
-```javascript
-Any.isArray([]); // true
-Any.isArray({}); // false
-```
-
-### [isDate](#isdate)
-
-Checks if a value is a `Date` object.
-
-- **Parameters**:
-    - `val`: The value to check.
-- **Returns**: `true` if the value is a `Date` object, `false` otherwise.
-
-```javascript
-Any.isDate(new Date()); // true
-Any.isDate('2021-01-01'); // false
-```
-
-### [string](#string)
-
-Converts a value to a string.
-
-- **Parameters**:
-    - `val`: The value to convert.
-- **Returns**: The value as a string.
-
-```javascript
-Any.string(123); // '123'
-```
-
-### [convertString](#convertstring)
-
-Converts a value to a string or returns a default string if the value is empty.
-
-- **Parameters**:
-    - `val`: The value to convert.
-    - `empty`: The default string if the value is empty (default is `'-'`).
-- **Returns**: The value as a string or the default string if empty.
-
-```javascript
-Any.convertString(123); // '123'
-Any.convertString('', '-'); // '-'
-```
-
-### [integer](#integer)
-
-Converts a value to an integer.
-
-- **Parameters**:
-    - `val`: The value to convert.
-- **Returns**: The value as an integer.
-
-```javascript
-Any.integer('123'); // 123
-```
-
-### [float](#float)
-
-Converts a value to a float.
-
-- **Parameters**:
-    - `val`: The value to convert.
-- **Returns**: The value as a float.
-
-```javascript
-Any.float('123.45'); // 123.45
-```
-
-### [bool](#bool)
-
-Converts a value to a boolean.
-
-- **Parameters**:
-    - `val`: The value to convert.
-- **Returns**: The value as a boolean.
-
-```javascript
-Any.bool('true'); // true
-Any.bool(0); // false
-```
-
-### [boolean](#boolean)
-
-Alias for `bool`.
-
-- **Parameters**:
-    - `val`: The value to convert.
-- **Returns**: The value as a boolean.
-
-```javascript
-Any.boolean('yes'); // true
-Any.boolean('no'); // false
-```
-
-### [convertBool](#convertbool)
-
-Converts a value to a boolean string representation.
-
-- **Parameters**:
-    - `val`: The value to convert.
-    - `yes`: The string to return if the value is truthy (default is `'Yes'`).
-    - `no`: The string to return if the value is falsy (default is `'No'`).
-- **Returns**: The string representation of the boolean value.
-
-```javascript
-Any.convertBool(true); // 'Yes'
-Any.convertBool(false); // 'No'
-```
-
-### [convertBoolean](#convertboolean)
-
-Alias for `convertBool`.
-
-- **Parameters**:
-    - `val`: The value to convert.
-    - `yes`: The string to return if the value is truthy (default is `'Yes'`).
-    - `no`: The string to return if the value is falsy (default is `'No'`).
-- **Returns**: The string representation of the boolean value.
-
-```javascript
-Any.convertBoolean('1'); // 'Yes'
-Any.convertBoolean('0'); // 'No'
-```
-
-### [convertDatetime](#convertdatetime)
-
-Converts a value to a formatted datetime string.
-
-- **Parameters**:
-    - `val`: The value to convert.
-    - `format`: The datetime format (default is `'YYYY-MM-DD hh:mm:ss'`).
-    - `empty`: The default string if the value is empty (default is `'-'`).
-- **Returns**: The formatted datetime string or the default string if empty.
-
-```javascript
-Any.convertDatetime(new Date(), 'MM/DD/YYYY'); // '05/28/2024'
-```
-
-### [vals](#vals)
-
-Gets the values of an object.
-
-- **Parameters**:
-    - `obj`: The object to get values from.
-- **Returns**: An array of the object's values.
-
-```javascript
-Any.vals({a: 1, b: 2}); // [1, 2]
-```
-
-### [keys](#keys)
-
-Gets the keys of an object.
-
-- **Parameters**:
-    - `obj`: The object to get keys from.
-- **Returns**: An array of the object's keys.
-
-```javascript
-Any.keys({a: 1, b: 2}); // ['a', 'b']
-```
-
-### [async](#async)
-
-Executes a callback asynchronously.
-
-- **Parameters**:
-    - `callback`: The callback function.
-    - `...args`: The arguments to pass to the callback.
-- **Returns**: The `Any` class.
-
-```javascript
-Any.async(() => console.log('Async call'));
-```
-
-### [delay](#delay)
-
-Executes a callback after a delay.
-
-- **Parameters**:
-    - `callback`: The callback function.
-    - `delay`: The delay in milliseconds (default is `100`).
-    - `...args`: The arguments to pass to the callback.
-- **Returns**: The `Any` class.
-
-```javascript
-Any.delay(() => console.log('Delayed call'), 500);
-```
-
-### [debounce](#debounce)
-
-Creates a debounced function that delays invoking the callback
-
-until after the specified delay.
-
-- **Parameters**:
-    - `callback`: The callback function.
-    - `delay`: The delay in milliseconds (default is `100`).
-    - `ref`: Optional reference to store the debounce timer.
-- **Returns**: A debounced function.
-
-```javascript
-const debouncedFn = Any.debounce(() => console.log('Debounced call'), 300);
-debouncedFn();
-```
-
-### [throttle](#throttle)
-
-Creates a throttled function that only invokes the callback at most once per every specified delay.
-
-- **Parameters**:
-    - `callback`: The callback function.
-    - `delay`: The delay in milliseconds (default is `100`).
-    - `ref`: Optional reference to store the throttle state.
-- **Returns**: A throttled function.
-
-```javascript
-const throttledFn = Any.throttle(() => console.log('Throttled call'), 300);
-throttledFn();
-```
-
-### [framerate](#framerate)
-
-Creates a function that invokes the callback at a specified frame rate.
-
-- **Parameters**:
-    - `callback`: The callback function.
-    - `rate`: The frame rate in frames per second (default is `30`).
-    - `ref`: Optional reference to store the last invocation time.
-- **Returns**: A function that enforces the specified frame rate.
-
-```javascript
-const frameRateFn = Any.framerate(() => console.log('Frame rate call'), 60);
-frameRateFn();
-```
-
-### [form](#form)
-
-Creates a `FormData` object from a plain object.
-
-- **Parameters**:
-    - `obj`: The plain object to convert.
-- **Returns**: A `FormData` object.
-
-```javascript
-const formData = Any.form({a: 1, b: 2});
-```
-
-## License
-
-This documentation is based on the source code of the `Any` class. The `Any` class is part of a utility library. Please refer to the library's license for more information.
-```

package/mix-manifest.json

@@ -1,4 +0,0 @@
-{
-    "/dist/js/index.js": "/dist/js/index.js",
-    "/dist/css/pico-ui.css": "/dist/css/pico-ui.css"
-}

package/pico.svg

@@ -1,52 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Generator: Adobe Illustrator 25.1.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
-<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
-	 viewBox="0 0 300 120" style="enable-background:new 0 0 300 120;" xml:space="preserve">
-<style type="text/css">
-	.st0{fill:url(#SVGID_1_);}
-	.st1{fill:url(#SVGID_2_);}
-	.st2{fill:url(#SVGID_3_);}
-	.st3{fill:url(#SVGID_4_);}
-</style>
-<g>
-	<linearGradient id="SVGID_1_" gradientUnits="userSpaceOnUse" x1="262.8699" y1="12.8418" x2="223.9448" y2="71.4924">
-		<stop  offset="0" style="stop-color:#00E99E"/>
-		<stop  offset="1" style="stop-color:#008E9E"/>
-	</linearGradient>
-	<path class="st0" d="M234.7347,46.9182v12.3925c14.9295,0,27.1537-11.7949,27.8493-26.5553h11.541V20.363h-11.5073v-8.3028
-		h-12.3925v8.3028H233.407v12.3925h16.7511C249.481,40.6764,242.8279,46.9182,234.7347,46.9182z"/>
-	<linearGradient id="SVGID_2_" gradientUnits="userSpaceOnUse" x1="284.4135" y1="27.1398" x2="245.4884" y2="85.7904">
-		<stop  offset="0" style="stop-color:#00E99E"/>
-		<stop  offset="1" style="stop-color:#008E9E"/>
-	</linearGradient>
-	<path class="st1" d="M271.2327,52.429c-7.3978,12.9807-21.2537,21.0445-36.1617,21.0445V85.866
-		c19.3494,0,37.3313-10.4609,46.929-27.3008L271.2327,52.429z"/>
-</g>
-<g>
-	<path d="M50.5869,39.8896c2.7451-1.4746,5.8828-2.2119,9.4102-2.2119c4.1045,0,7.8184,1.0122,11.1436,3.0356
-		c3.3242,2.0249,5.9551,4.8999,7.8926,8.6294c1.9365,3.7295,2.9053,8.0518,2.9053,12.9658c0,4.915-0.9688,9.2656-2.9053,13.0518
-		c-1.9375,3.7881-4.5684,6.7217-7.8926,8.8027c-3.3252,2.082-7.0391,3.1221-11.1436,3.1221c-3.5273,0-6.6348-0.7236-9.3232-2.168
-		s-4.8721-3.2656-6.5479-5.4639v29.7471H31.9844V38.4585H44.126v6.938C45.6865,43.2002,47.8398,41.3633,50.5869,39.8896z
-		 M67.7588,54.8066c-1.1855-2.1104-2.7471-3.7148-4.6836-4.8135c-1.9375-1.0977-4.0322-1.6475-6.2871-1.6475
-		c-2.1982,0-4.2646,0.5635-6.2012,1.6904c-1.9375,1.1279-3.499,2.7617-4.6836,4.9004c-1.1855,2.1396-1.7773,4.6543-1.7773,7.5449
-		c0,2.8916,0.5918,5.4072,1.7773,7.5459c1.1846,2.1396,2.7461,3.7725,4.6836,4.8994c1.9365,1.1279,4.0029,1.6914,6.2012,1.6914
-		c2.2549,0,4.3496-0.5771,6.2871-1.7344c1.9365-1.1562,3.498-2.8037,4.6836-4.9434c1.1846-2.1387,1.7783-4.6836,1.7783-7.6318
-		C69.5371,59.418,68.9434,56.918,67.7588,54.8066z"/>
-	<path d="M102.9258,38.4585v48.0464H90.7842V38.4585H102.9258z"/>
-	<path d="M114.8076,49.4297c2.0234-3.7295,4.8271-6.6201,8.4121-8.6729c3.585-2.0518,7.6895-3.0791,12.3154-3.0791
-		c5.9541,0,10.8838,1.4893,14.7871,4.4668c3.9023,2.9785,6.5176,7.1543,7.8486,12.5322h-13.0957
-		c-0.6943-2.082-1.8643-3.7148-3.5127-4.9004c-1.6475-1.1846-3.6855-1.7783-6.1143-1.7783c-3.4688,0-6.2158,1.2578-8.2393,3.7725
-		c-2.0244,2.5156-3.0352,6.0859-3.0352,10.7109c0,4.5684,1.0107,8.1094,3.0352,10.624c2.0234,2.5156,4.7705,3.7725,8.2393,3.7725
-		c4.9141,0,8.123-2.1963,9.627-6.5908h13.0957c-1.3311,5.2031-3.9609,9.3379-7.8926,12.4014
-		c-3.9326,3.0654-8.8457,4.5967-14.7432,4.5967c-4.626,0-8.7305-1.0254-12.3154-3.0781c-3.585-2.0518-6.3887-4.9434-8.4121-8.6729
-		c-2.0244-3.7295-3.0352-8.0791-3.0352-13.0527C111.7725,57.5098,112.7832,53.1582,114.8076,49.4297z"/>
-	<path d="M175.9482,84.207c-3.7002-2.0518-6.6064-4.957-8.7158-8.7168c-2.1113-3.7568-3.166-8.0938-3.166-13.0088
-		c0-4.9131,1.085-9.25,3.2529-13.0088c2.168-3.7578,5.1299-6.6631,8.8896-8.7158c3.7568-2.0518,7.9482-3.0791,12.5752-3.0791
-		c4.625,0,8.8164,1.0273,12.5752,3.0791c3.7578,2.0527,6.7207,4.958,8.8896,8.7158c2.168,3.7588,3.252,8.0957,3.252,13.0088
-		c0,4.915-1.1143,9.252-3.3389,13.0088c-2.2266,3.7598-5.2334,6.665-9.0195,8.7168c-3.7881,2.0527-8.0225,3.0781-12.7061,3.0781
-		C183.8105,87.2852,179.6475,86.2598,175.9482,84.207z M194.6377,75.1006c1.9365-1.0693,3.4824-2.6738,4.6396-4.8135
-		c1.1562-2.1387,1.7354-4.7402,1.7354-7.8057c0-4.5664-1.2012-8.0791-3.5996-10.5371c-2.3994-2.457-5.334-3.6855-8.8027-3.6855
-		s-6.374,1.2285-8.7158,3.6855c-2.3418,2.458-3.5127,5.9707-3.5127,10.5371c0,4.5684,1.1416,8.0811,3.4258,10.5371
-		c2.2832,2.459,5.1602,3.6865,8.6289,3.6865C190.6338,76.7051,192.7002,76.1709,194.6377,75.1006z"/>
-</g>
-</svg>

package/tsconfig.json

@@ -1,14 +0,0 @@
-{
-    "compilerOptions": {
-        "baseUrl": ".",
-        "paths": {
-            "*": [
-                "types/*"
-            ]
-        },
-        "typeRoots": [
-            "./node_modules/@types",
-            "./types"
-        ]
-    }
-}

package/types/index.d.ts

@@ -1,25 +0,0 @@
-// types/index.d.ts
-import { Arr } from "./utility/array";
-import { Obj } from "./utility/object";
-import { Any } from "./utility/any";
-import { Num } from "./utility/number";
-import { Str } from "./utility/string";
-import { Now } from "./utility/now";
-
-export declare module "@kizmann/pico-js" {
-
-    const Arr: Arr;
-    const Obj: Obj;
-    const Any: Any;
-    const Str: Str;
-    const Num: Num;
-    const Now: Now;
-
-    export {
-        Arr, Obj, Any, Str, Num, Now
-    };
-
-    export default {
-        Arr, Obj, Any, Str, Num, Now
-    };
-}

package/types/utility/any.d.ts

@@ -1,66 +0,0 @@
-// types/utility/any.d.ts
-
-
-import { Arr } from "./array";
-import { Obj } from "./object";
-import { Now } from "./now";
-
-declare class Any {
-    static isEmpty(val : any) : boolean;
-
-    static isNull(val : any) : boolean;
-
-    static isEqual(obj : any, val : any) : boolean;
-
-    static isString(val : any) : boolean;
-
-    static isNumber(val : any) : boolean;
-
-    static isBool(val : any) : boolean;
-
-    static isFunction(val : any) : boolean;
-
-    static isObject(val : any) : boolean;
-
-    static isPlain(val : any) : boolean;
-
-    static isArray(val : any) : boolean;
-
-    static isDate(val : any) : boolean;
-
-    static string(val : any) : string;
-
-    static convertString(val : any, empty? : string) : string;
-
-    static integer(val : any) : number;
-
-    static float(val : any) : number;
-
-    static bool(val : any) : boolean;
-
-    static boolean(val : any) : boolean;
-
-    static convertBool(val : any, yes? : string, no? : string) : string;
-
-    static convertBoolean(val : any, yes? : string, no? : string) : string;
-
-    static convertDatetime(val : any, format? : string, empty? : string) : string;
-
-    static vals(obj : any) : any[];
-
-    static keys(obj : any) : string[];
-
-    static async(callback : (...args : any[]) => void, ...args : any[]) : Any;
-
-    static delay(callback : (...args : any[]) => void, delay? : number, ...args : any[]) : Any;
-
-    static debounce(callback : (...args : any[]) => void, delay? : number, ref? : any) : (...args : any[]) => void;
-
-    static throttle(callback : (...args : any[]) => void, delay? : number, ref? : any) : (...args : any[]) => void;
-
-    static framerate(callback : (...args : any[]) => void, rate? : number, ref? : any) : (...args : any[]) => void;
-
-    static form(obj : any) : FormData;
-}
-
-export default Any;

package/types/utility/array.d.ts

@@ -1,46 +0,0 @@
-// types/utility/array.d.ts
-
-declare class Arr {
-    static make(count: number): number[];
-    static all<T>(arr: T | T[]): T[];
-    static get<T>(arr: T[], index: number, fallback?: T): T;
-    static set<T>(arr: T[], index: number, value: T): T;
-    static first<T>(arr: T[], fallback?: T): T;
-    static second<T>(arr: T[], fallback?: T): T;
-    static third<T>(arr: T[], fallback?: T): T;
-    static last<T>(arr: T[], fallback?: T): T;
-    static prepend<T>(arr: T[], val: T): T[];
-    static append<T>(arr: T[], val: T): T[];
-    static sort<T>(obj: AnyObject, key: string | ((a: T, b: T) => number)): T[];
-    static sortString<T>(obj: AnyObject, key: string): T[];
-    static filter<T>(arr: T[], filter: any): T[];
-    static filterIndex(arr: any[], filter: any): number[];
-    static find<T>(arr: T[], val: any, fallback?: T): T;
-    static findIndex(arr: any[], val: any, fallback?: number): number;
-    static has<T>(arr: T[], val: any): boolean;
-    static add<T>(arr: T[], val: T, finder?: any): T[];
-    static replace<T>(arr: T[], val: T, finder?: any): T[];
-    static remove<T>(arr: T[], val: any): T[];
-    static toggle<T>(arr: T[], val: T): T[];
-    static removeIndex<T>(arr: T[], val: number): T[];
-    static insert<T>(arr: T[], key: number, val: T): T[];
-    static slice<T>(arr: T[], key: number, count?: number): T[];
-    static splice<T>(arr: T[], key: number, count?: number): T[];
-    static equal<T>(arr1: T[], arr2: T[]): boolean;
-    static includes<T>(arr: T[], val: T): boolean;
-    static contains<T>(arr: T[], val: T[]): boolean;
-    static concat<T>(arr: T[], ...args: T[]): T[];
-    static clone<T>(arr: T[]): T[];
-    static merge<T>(arr: T[], ...args: T[]): T[];
-    static push<T>(arr: T[], ...args: T[]): T[];
-    static diff<T>(arr: T[], val: T[]): T[];
-    static intersect<T>(...args: T[][]): T[];
-    static chunk<T>(arr: T[], chunk?: number): T[][];
-    static reduce<T, U>(arr: T[], callback: (accumulator: U, currentValue: T, currentIndex: number, array: T[]) => U, accumulator: U): U;
-    static extract<T>(arr: T[], path: string): any[];
-    static each<T>(arr: T[], callback: (val: T, key: number | string) => any): any[];
-    static map<T>(arr: T[], callback: (val: T, key: number | string) => any): T[];
-    static recursive<T>(arr: T[], key: string, callback: (val: any, cascade: any[]) => any, cascade?: any[]): T[];
-}
-
-export default Arr;