@kizmann/pico-js 1.0.13 → 2.0.0

package/types/utils/String.d.ts

@@ -0,0 +1,330 @@
+export class PicoString {
+    /**
+     * Get character at index
+     *
+     * @example Str.get("abc", 1) // => "b"
+     *
+     * @param {any} value Input string
+     * @param {any} index Char index
+     * @returns {string} Single char
+     */
+    static get(value: any, index: any): string;
+    /**
+     * Replace substring at index
+     *
+     * @example Str.set("abc", 1, "X") // => "aXc"
+     *
+     * @param {any} value Input string
+     * @param {any} index Start index
+     * @param {string} [replace] Replace value
+     * @returns {string} Updated string
+     */
+    static set(value: any, index: any, replace?: string): string;
+    /**
+     * Replace first occurrence
+     *
+     * @example Str.replace("abc", "X", "b") // => "aXc"
+     *
+     * @param {any} value Input string
+     * @param {string} replace Replace value
+     * @param {any} [search] Search value
+     * @returns {string} Updated string
+     */
+    static replace(value: any, replace: string, search?: any): string;
+    /**
+     * Extract substring by range
+     *
+     * @example Str.extract("abc", "b") // => "b"
+     *
+     * @param {any} value Input string
+     * @param {string} replace Search value
+     * @param {any} [search] Match source
+     * @returns {string|null} Extracted string
+     */
+    static extract(value: any, replace: string, search?: any): string | null;
+    /**
+     * Match pattern in string
+     *
+     * @example Str.match("abc", /b/) // => ["b"]
+     *
+     * @param {any} value Input string
+     * @param {RegExp|string} pattern Match pattern
+     * @param {any} [cb] Callback fn
+     * @returns {any} Match result
+     */
+    static match(value: any, pattern: RegExp | string, cb?: any): any;
+    /**
+     * Escape regex characters
+     *
+     * @example Str.regex("a.b") // => "a\\.b"
+     *
+     * @param {any} val Input string
+     * @returns {string} Escaped string
+     */
+    static regex(val: any): string;
+    /**
+     * Convert to uppercase
+     *
+     * @example Str.uc("abc") // => "ABC"
+     *
+     * @param {any} value Input string
+     * @returns {string} Uppercase string
+     */
+    static uc(value: any): string;
+    /**
+     * @see PicoString.uc
+     */
+    static upper: typeof PicoString.uc;
+    /**
+     * Uppercase first character
+     *
+     * @example Str.ucfirst("abc") // => "Abc"
+     *
+     * @param {string} value Input string
+     * @returns {string} Updated string
+     */
+    static ucfirst(value: string): string;
+    /**
+     * Convert to lowercase
+     *
+     * @example Str.lc("ABC") // => "abc"
+     *
+     * @param {any} value Input string
+     * @returns {string} Lowercase string
+     */
+    static lc(value: any): string;
+    /**
+     * @see PicoString.lc
+     */
+    static lower: typeof PicoString.lc;
+    /**
+     * Lowercase first character
+     *
+     * @example Str.lcfirst("ABC") // => "aBC"
+     *
+     * @param {string} value Input string
+     * @returns {string} Updated string
+     */
+    static lcfirst(value: string): string;
+    /**
+     * Convert to camelCase
+     *
+     * @example Str.cc("hello-world") // => "helloWorld"
+     *
+     * @param {string} value Input string
+     * @returns {string} camelCase string
+     */
+    static cc(value: string): string;
+    /**
+     * @see PicoString.cc
+     */
+    static camelcase: typeof PicoString.cc;
+    /**
+     * Convert to kebab-case
+     *
+     * @example Str.kc("helloWorld") // => "hello-world"
+     *
+     * @param {string} value Input string
+     * @returns {string} kebab-case string
+     */
+    static kc(value: string): string;
+    /**
+     * @see PicoString.kc
+     */
+    static kebabcase: typeof PicoString.kc;
+    /**
+     * Convert to snake_case
+     *
+     * @example Str.sc("helloWorld") // => "hello_world"
+     *
+     * @param {string} value Input string
+     * @returns {string} snake_case string
+     */
+    static sc(value: string): string;
+    /**
+     * @see PicoString.sc
+     */
+    static snakecase: typeof PicoString.sc;
+    /**
+     * Convert to PascalCase
+     *
+     * @example Str.pc("hello-world") // => "HelloWorld"
+     *
+     * @param {string} value Input string
+     * @returns {string} PascalCase string
+     */
+    static pc(value: string): string;
+    /**
+     * @see PicoString.pc
+     */
+    static pascalcase: typeof PicoString.pc;
+    /**
+     * Check if string contains value
+     *
+     * @example Str.has("abc", "b") // => true
+     *
+     * @param {string} value Input string
+     * @param {string} search Search string
+     * @returns {boolean} True if found
+     */
+    static has(value: string, search: string): boolean;
+    /**
+     * Get index range of search
+     *
+     * @example Str.range("abc", "b") // => [1, 2]
+     *
+     * @param {any} value Input string
+     * @param {string} search Search string
+     * @param {any} [fallback] Fallback value
+     * @returns {Array<number>|any} Index range
+     */
+    static range(value: any, search: string, fallback?: any): Array<number> | any;
+    /**
+     * Extract substring by range
+     *
+     * @example Str.slice("abc", 1, 2) // => "b"
+     *
+     * @param {any} value Input string
+     * @param {number} start Start index
+     * @param {number} limit End index
+     * @returns {string} Sliced string
+     */
+    static slice(value: any, start: number, limit: number): string;
+    /**
+     * Get string representation
+     *
+     * @example Str.string("<b>a</b>") // => "a"
+     *
+     * @param {any} value Input value
+     * @param {any} [empty] Empty fallback
+     * @param {boolean} [html] Keep HTML
+     * @returns {string} String value
+     */
+    static string(value: any, empty?: any, html?: boolean): string;
+    /**
+     * Get boolean representation
+     *
+     * @example Str.boolean(true) // => "Yes"
+     *
+     * @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
+     */
+    static boolean(value: any, yes?: string, no?: string, empty?: any): string | any;
+    /**
+     * Get formatted number
+     *
+     * @example Str.number(1234.56, 1) // => "1,234.6"
+     *
+     * @param {any} value Input value
+     * @param {number} [fixed] Decimal points
+     * @param {string} [locale] Locale code
+     * @param {any} [config] Format config
+     * @returns {string|any} Formatted string
+     */
+    static number(value: any, fixed?: number, locale?: string, config?: any): string | any;
+    /**
+     * Get formatted integer
+     *
+     * @example Str.integer(1, 2) // => "01"
+     *
+     * @param {any} value Input value
+     * @param {number} [leading] Leading zeros
+     * @param {string} [padding] Padding char
+     * @returns {string|any} Formatted string
+     */
+    static integer(value: any, leading?: number, padding?: string): string | any;
+    /**
+     * Get formatted datetime
+     *
+     * @example Str.datetime("2026-01-01", "DD.MM.YYYY")
+     *
+     * @param {any} value Input value
+     * @param {string} [format] Output format
+     * @param {any} [empty] Empty fallback
+     * @returns {string} Formatted string
+     */
+    static datetime(value: any, format?: string, empty?: any): string;
+    /**
+     * Get formatted date
+     *
+     * @example Str.date("2026-01-01", "DD.MM.YYYY")
+     *
+     * @param {any} value Input value
+     * @param {string} [format] Output format
+     * @param {any} [empty] Empty fallback
+     * @returns {string} Formatted string
+     */
+    static date(value: any, format?: string, empty?: any): string;
+    /**
+     * Get formatted time
+     *
+     * @example Str.time("12:00:00", "HH:mm")
+     *
+     * @param {any} value Input value
+     * @param {string} [format] Output format
+     * @param {any} [empty] Empty fallback
+     * @returns {string} Formatted string
+     */
+    static time(value: any, format?: string, empty?: any): string;
+    /**
+     * Parse string to object
+     *
+     * @example Str.objectify("a: 1;") // => { a: 1 }
+     *
+     * @param {any} value Input string
+     * @param {string} [mode] Parse mode
+     * @param {boolean} [toarray] Return array
+     * @returns {any} Parsed value
+     */
+    static objectify(value: any, mode?: string, toarray?: boolean): any;
+    /**
+     * Cast object to string
+     *
+     * @example Str.stringify({ a: 1 }) // => "a: 1;"
+     *
+     * @param {any} value Input value
+     * @param {string} [mode] Cast mode
+     * @returns {string} Casted string
+     */
+    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 PicoString;

package/types/wip/Element.d.ts

@@ -0,0 +1,119 @@
+export class PicoElement {
+    /**
+     * Prefix for attribute selector.
+     */
+    static prefix: string;
+    /**
+     * Mounted identifier.
+     */
+    static mount: string;
+    /**
+     * Instance storage.
+     */
+    static inis: {};
+    /**
+     * Runtime storage.
+     */
+    static runs: any[];
+    /**
+     * Instance storage.
+     */
+    static invi: any[];
+    /**
+     * Listen to scroll events
+     *
+     * @example PicoElement.listen()
+     *
+     * @returns {void} No return value
+     */
+    static listen(): void;
+    /**
+     * Handle scroll visibility
+     *
+     * @example PicoElement.scroll()
+     *
+     * @returns {void} No return value
+     */
+    static scroll(): void;
+    /**
+     * Register element alias
+     *
+     * @example PicoElement.alias("tab", Tab)
+     *
+     * @param {string} key Alias key
+     * @param {any} instance Class instance
+     * @returns {this} Current class
+     */
+    static alias(key: string, instance: any): this;
+    /**
+     * Bind element to selector
+     *
+     * @example PicoElement.bind("tab", ".tabs")
+     *
+     * @param {string} key Alias key
+     * @param {any} selector Dom selector
+     * @param {any} [options] Init options
+     * @returns {this} Current class
+     */
+    static bind(key: string, selector: any, options?: any): this;
+    /**
+     * Unbind element from selector
+     *
+     * @example PicoElement.unbind("tab", ".tabs")
+     *
+     * @param {string} key Alias key
+     * @param {any} selector Dom selector
+     * @param {any} [options] Init options
+     * @returns {this} Current class
+     */
+    static unbind(key: string, selector: any, options?: any): this;
+    /**
+     * Observe DOM changes
+     *
+     * @example PicoElement.observe("tab")
+     *
+     * @param {string} key Alias key
+     * @param {boolean} [plain] Plain options
+     * @returns {this} Current class
+     */
+    static observe(key: string, plain?: boolean): this;
+    /**
+     * Bind element on inview
+     *
+     * @example PicoElement.bindInview(el, cb)
+     *
+     * @param {Element} el Target element
+     * @param {function} cb Callback fn
+     * @returns {void} No return value
+     */
+    static bindInview(el: Element, cb: Function): void;
+    /**
+     * Unbind element on inview
+     *
+     * @example PicoElement.unbindInview(el, cb)
+     *
+     * @param {Element} el Target element
+     * @param {function} cb Callback fn
+     * @returns {void} No return value
+     */
+    static unbindInview(el: Element, cb: Function): void;
+    /**
+     * Get attribute prefix
+     *
+     * @example PicoElement.getPrefix("tab") // => "js-tab"
+     *
+     * @param {string} [key] Alias key
+     * @returns {string} Attribute prefix
+     */
+    static getPrefix(key?: string): string;
+    /**
+     * Set attribute prefix
+     *
+     * @example PicoElement.setPrefix("pi")
+     *
+     * @param {string} prefix New prefix
+     * @returns {void} No return value
+     */
+    static setPrefix(prefix: string): void;
+}
+export default PicoElement;

package/types/wip/Map.d.ts

@@ -0,0 +1,254 @@
+/**
+ * @const {object} google
+ */
+export class PicoMap {
+    static mapStyle: any[];
+    static markerStyles: {};
+    static hideMarkers: boolean;
+    static closeInfoWindows: boolean;
+    /**
+     * Set global map style
+     *
+     * @example Map.setMapStyle(style)
+     *
+     * @param {Array<any>} [style] Style array
+     * @returns {this} Current class
+     */
+    static setMapStyle(style?: Array<any>): this;
+    /**
+     * Set marker style
+     *
+     * @example Map.setMarkerStyle("default", { default: "icon.png" })
+     *
+     * @param {string} key Style key
+     * @param {any} [style] Style options
+     * @param {any} [extra] Extra options
+     * @returns {this} Current class
+     */
+    static setMarkerStyle(key: string, style?: any, extra?: any): this;
+    /**
+     * Create map instance
+     *
+     * @example new Map("#map", { lat: 0, lng: 0 })
+     *
+     * @param {any} el Target element
+     * @param {any} [options] Map options
+     */
+    constructor(el: any, options?: any);
+    map: any;
+    markers: {};
+    cluster: any;
+    clusterFilter: any;
+    clusterOptions: {};
+    /**
+     * Cluster map markers
+     *
+     * @example map.clusterMarkers()
+     *
+     * @param {any} [options] Cluster options
+     * @param {any} [filter] Marker filter
+     * @param {boolean} [allowCreate] Create cluster
+     * @returns {void} No return value
+     */
+    clusterMarkers(options?: any, filter?: any, allowCreate?: boolean): void;
+    /**
+     * Apply style to marker
+     *
+     * @example map.styleMarker("m1", "hover")
+     *
+     * @param {string} key Marker key
+     * @param {any} [type] Style type
+     * @returns {void} No return value
+     */
+    styleMarker(key: string, type?: any): void;
+    /**
+     * Get marker by key
+     *
+     * @example map.getMarker("m1")
+     *
+     * @param {string} key Marker key
+     * @returns {any} Marker object
+     */
+    getMarker(key: string): any;
+    /**
+     * Check if marker is visible
+     *
+     * @example map.getMarkerVisibility("m1") // => true
+     *
+     * @param {string} key Marker key
+     * @param {boolean} [fallback] Fallback value
+     * @returns {boolean} Visibility state
+     */
+    getMarkerVisibility(key: string, fallback?: boolean): boolean;
+    /**
+     * Get marker position
+     *
+     * @example map.getMarkerPositon("m1") // => LatLng
+     *
+     * @param {string} key Marker key
+     * @param {any} [fallback] Fallback value
+     * @returns {any} Position object
+     */
+    getMarkerPositon(key: string, fallback?: any): any;
+    /**
+     * Toggle marker visibility
+     *
+     * @example map.toggleMarker("m1")
+     *
+     * @param {string} key Marker key
+     * @returns {boolean|void} Visibility state
+     */
+    toggleMarker(key: string): boolean | void;
+    /**
+     * Show marker on map
+     *
+     * @example map.showMarker("m1")
+     *
+     * @param {string} key Marker key
+     * @returns {boolean|void} Previous state
+     */
+    showMarker(key: string): boolean | void;
+    /**
+     * Hide marker on map
+     *
+     * @example map.hideMarker("m1")
+     *
+     * @param {string} key Marker key
+     * @returns {boolean|void} Previous state
+     */
+    hideMarker(key: string): boolean | void;
+    /**
+     * Marker hover enter
+     *
+     * @example map.enterMarker("m1")
+     *
+     * @param {string} key Marker key
+     * @returns {this|void} Current instance
+     */
+    enterMarker(key: string): this | void;
+    /**
+     * Marker hover leave
+     *
+     * @example map.leaveMarker("m1")
+     *
+     * @param {string} key Marker key
+     * @returns {this|void} Current instance
+     */
+    leaveMarker(key: string): this | void;
+    /**
+     * Check if info is open
+     *
+     * @example map.getInfoVisibility("m1") // => true
+     *
+     * @param {string} key Marker key
+     * @param {boolean} [fallback] Fallback value
+     * @returns {boolean} Visibility state
+     */
+    getInfoVisibility(key: string, fallback?: boolean): boolean;
+    /**
+     * Toggle info window
+     *
+     * @example map.toggleInfo("m1")
+     *
+     * @param {string} key Marker key
+     * @returns {boolean|void} Visibility state
+     */
+    toggleInfo(key: string): boolean | void;
+    /**
+     * Open info window
+     *
+     * @example map.openInfo("m1")
+     *
+     * @param {string} key Marker key
+     * @returns {boolean|void} Previous state
+     */
+    openInfo(key: string): boolean | void;
+    /**
+     * Close info window
+     *
+     * @example map.closeInfo("m1")
+     *
+     * @param {string} key Marker key
+     * @returns {boolean|void} Previous state
+     */
+    closeInfo(key: string): boolean | void;
+    /**
+     * Create map marker
+     *
+     * @example map.createMarker("m1", { lat: 0, lng: 0 })
+     *
+     * @param {any} [key] Marker key
+     * @param {any} [options] Marker options
+     * @returns {any} Marker object
+     */
+    createMarker(key?: any, options?: any): any;
+    /**
+     * Set marker position
+     *
+     * @example map.setMarkerPosition("m1", { lat: 0, lng: 0 })
+     *
+     * @param {string} key Marker key
+     * @param {any} [options] Position options
+     * @returns {void} No return value
+     */
+    setMarkerPosition(key: string, options?: any): void;
+    /**
+     * Set marker by address
+     *
+     * @example map.setMarkerByAddress("m1", "Address")
+     *
+     * @param {string} key Marker key
+     * @param {any} address Search address
+     * @returns {Promise<any>} Response promise
+     */
+    setMarkerByAddress(key: string, address: any): Promise<any>;
+    /**
+     * Get location by address
+     *
+     * @example map.getLocationByAddress("Address")
+     *
+     * @param {any} address Search address
+     * @param {function} [callback] Success callback
+     * @returns {Promise<any>} Response promise
+     */
+    getLocationByAddress(address: any, callback?: Function): Promise<any>;
+    /**
+     * Show markers on map
+     *
+     * @example map.showMarkers()
+     *
+     * @param {any} [filter] Marker filter
+     * @returns {this} Current instance
+     */
+    showMarkers(filter?: any): this;
+    /**
+     * Get marker boundary
+     *
+     * @example map.getMarkerBoundry() // => LatLngBounds
+     *
+     * @param {any} [filter] Marker filter
+     * @returns {any} Boundary object
+     */
+    getMarkerBoundry(filter?: any): any;
+    /**
+     * Focus markers on map
+     *
+     * @example map.focusMarkers()
+     *
+     * @param {any} [filter] Marker filter
+     * @param {number} [maxZoom] Max zoom level
+     * @param {number} [boundSpace] Viewport space
+     * @returns {this} Current instance
+     */
+    focusMarkers(filter?: any, maxZoom?: number, boundSpace?: number): this;
+    /**
+     * Render directions on map
+     *
+     * @example map.renderDirections({ origin: "A", destination: "B" })
+     *
+     * @param {any} options Render options
+     * @returns {Promise<any>} Response promise
+     */
+    renderDirections(options: any): Promise<any>;
+}
+export default PicoMap;