ziko 0.49.6 → 0.50.1

package/types/hooks/use-event-emitter.d.ts

@@ -0,0 +1,46 @@
+declare class UseEventEmitter {
+    constructor(maxListeners?: number);
+
+    /**
+     * Register and listen for an event.
+     * The listener will be called every time the event is emitted.
+     */
+    on(event: string, listener: (...args: any[]) => void): this;
+
+    /**
+     * Register and listen for an event ONCE.
+     * After the first call, the listener is automatically removed.
+     */
+    once(event: string, listener: (...args: any[]) => void): this;
+
+    /**
+     * Remove a specific listener.
+     */
+    off(event: string, listener: (...args: any[]) => void): this;
+
+    /**
+     * Emit an event and call all listeners associated with it.
+     * Returns true if the event had listeners; otherwise false.
+     */
+    emit(event: string, data?: any): boolean;
+
+    /**
+     * Remove all listeners for a specific event.
+     */
+    remove(event: string): this;
+
+    /**
+     * Clear all events and their listeners.
+     */
+    clear(): this;
+
+    /**
+     * Set the maximum number of listeners allowed per event.
+     */
+    setMaxListeners(max: number): this;
+}
+
+/** Create a new event emitter instance */
+declare const useEventEmitter: (maxListeners?: number) => UseEventEmitter;
+
+export { UseEventEmitter, useEventEmitter };

package/types/hooks/use-favicon.d.ts

@@ -0,0 +1,41 @@
+export declare class UseFavIcon {
+    /**
+     * Create a favicon manager.
+     * @param FavIcon Initial favicon URL.
+     * @param withEmitter Whether to enable an internal event emitter (default: true).
+     */
+    constructor(FavIcon?: string, withEmitter?: boolean);
+
+    /**
+     * Sets the favicon URL.
+     * Emits "ziko:favicon-changed" if emitter is enabled.
+     */
+    setFavicon(href: string): this;
+
+    /**
+     * Returns the current favicon URL.
+     */
+    readonly current: string;
+
+    /**
+     * Listen for favicon changes.
+     * Callback receives the new href as a string.
+     */
+    onChange(callback: (href: string) => void): this;
+
+    /**
+     * To Do 
+     * Disable or remove the internal event emitter entirely.
+     */
+    removeEventEmitter(): this;
+
+    /**
+     * Enable the internal event emitter manually.
+     */
+    useEventEmitter(): this;
+}
+
+/**
+ * Factory function to create a `UseFavIcon` instance.
+ */
+export declare const useFavIcon: (FavIcon?: string, withEmitter?: boolean) => UseFavIcon;

package/types/hooks/{use-channel.d.ts → use-ipc.d.ts}

@@ -1,4 +1,4 @@
-export declare class UseChannel {
+export declare class UseIPC {
     emit(event: string, data: any, rooms?: string[]): this;
     on(event: string, handler: (data: any) => void, rooms?: string | string[]): this;
     off(event: string, handler: (data: any) => void): this;
@@ -9,4 +9,4 @@ export declare class UseChannel {
 
 }
 
-export declare const useChannel: (name?: string) => UseChannel;
+export declare const useIPC: (name?: string) => UseIPC;

package/types/hooks/use-media-query.d.ts

@@ -0,0 +1,24 @@
+export interface MediaQueryRule {
+    query: string;
+    callback: () => void;
+}
+
+export class UseMediaQuery {
+    // Private fields (only for type awareness; not accessible)
+    private readonly #mediaQueryRules: MediaQueryRule[];
+    private readonly #fallback: () => void;
+    private #lastCalledCallback: (() => void) | null;
+
+    constructor(
+        mediaQueryRules?: MediaQueryRule[],
+        fallback?: () => void
+    );
+}
+
+/**
+ * Helper function to create a UseMediaQuery instance.
+ */
+export function useMediaQuery(
+    mediaQueryRules?: MediaQueryRule[],
+    fallback?: () => void
+): UseMediaQuery;

package/types/hooks/use-root.d.ts

@@ -0,0 +1,15 @@
+export declare class UseRoot<PropMap extends Record<string, string>> {
+    constructor(PropsMap: PropMap, options?: UseRootOptions);
+
+    currentPropsMap: PropMap;
+    namespace: string;
+    ValidateCssProps: boolean;
+
+    /** Dynamically created CSS variable references */
+    [K in keyof PropMap]: string;
+
+    /**
+     * Apply a new set of properties
+     */
+    use(PropsMap: PropMap): this;
+}

package/types/hooks/use-storage.d.ts

@@ -0,0 +1,47 @@
+// use-storage.d.ts
+
+export declare class UseStorage {
+    constructor(
+        storage: Storage,
+        globalKey: string,
+        initialValue?: Record<string, any>,
+        use_channel?: boolean
+    );
+
+    /** Current stored items */
+    readonly items: Record<string, any>;
+
+    /** Set entire storage */
+    set(data: Record<string, any>): this;
+
+    /** Merge new data into existing storage */
+    add(data: Record<string, any>): this;
+
+    /** Remove keys from storage */
+    remove(...keys: string[]): this;
+
+    /** Get a single key */
+    get(key: string): any;
+
+    /** Clear storage completely */
+    clear(): this;
+
+    /**
+     * Listen for any storage updates.
+     * Callback receives the data passed to the last .set() / .add() / .remove()
+     */
+    onStorageUpdated(callback: (data: Record<string, any>) => void): this;
+}
+
+/** Factory functions */
+export declare const useLocaleStorage: (
+    key: string,
+    initialValue?: Record<string, any>,
+    use_channel?: boolean
+) => UseStorage;
+
+export declare const useSessionStorage: (
+    key: string,
+    initialValue?: Record<string, any>,
+    use_channel?: boolean
+) => UseStorage;

package/types/hooks/use-title.d.ts

@@ -0,0 +1,37 @@
+export declare class UseTitle {
+    /**
+     * Create a reactive title manager.
+     * @param title Initial title. Defaults to `document.title`.
+     * @param withEmitter Whether to create an internal event emitter. Default: true.
+     */
+    constructor(title?: string, withEmitter?: boolean);
+
+    /**
+     * Enables the internal event emitter.
+     */
+    useEventEmitter(): this;
+
+    /**
+     * Sets the document title.
+     * Emits "ziko:title-changed" if emitter is enabled.
+     */
+    setTitle(title: string): this;
+
+    /**
+     * Returns the current document title.
+     */
+    readonly current: string;
+
+    /**
+     * Listen for title changes.
+     */
+    onChange(callback: (title: string) => void): this;
+
+    /**
+     * To Do 
+     * Disable or remove the internal event emitter entirely.
+     */
+    removeEventEmitter(): this;
+}
+
+export declare const useTitle: (title?: string, withEmitter?: boolean) => UseTitle;

package/src/events/binders/click.js

@@ -1,20 +0,0 @@
-import { __ZikoEvent__ } from "../__ZikoEvent__.js";
-import { Events } from "../__Events__.js";
-// import { register_click_away_event } from "./custom-events/click-away.js";
-class ZikoEventClick extends __ZikoEvent__{
-    constructor(target, customizer){
-        super(target, Events.Click, details_setter, customizer);
-        // register_click_away_event(target.element)
-    }
-}
-function details_setter(){
-    if(this.currentEvent==="click") this.dx = 0
-    else this.dx = 1
-    // console.log(this.currentEvent)
-}
-const bind_click_event = (target, customizer) => new ZikoEventClick(target, customizer)
-
-export{
-    bind_click_event,
-    ZikoEventClick
-}

package/src/events/binders/clipboard.js

@@ -1,16 +0,0 @@
-import { __ZikoEvent__ } from "../__ZikoEvent__.js";
-import { Events } from "../__Events__.js";
-class ZikoEventClipboard extends __ZikoEvent__{
-    constructor(target, customizer){
-        super(target, Events.Clipboard, details_setter, customizer)
-    }
-}
-function details_setter(){
-
-}
-const bind_clipboard_event = (target, customizer) => new ZikoEventClipboard(target, customizer)
-
-export{
-    bind_clipboard_event,
-    ZikoEventClipboard
-}

package/src/events/binders/drag.js

@@ -1,16 +0,0 @@
-import { __ZikoEvent__ } from "../__ZikoEvent__.js";
-import { Events } from "../__Events__.js";
-class ZikoEventDrag extends __ZikoEvent__{
-    constructor(target, customizer){
-        super(target, Events.Drag, details_setter, customizer)
-    }
-}
-function details_setter(){
-
-}
-const bind_drag_event = (target, customizer) => new ZikoEventDrag(target, customizer)
-
-export{
-    bind_drag_event,
-    ZikoEventDrag
-}

package/src/events/binders/focus.js

@@ -1,16 +0,0 @@
-import { __ZikoEvent__ } from "../__ZikoEvent__.js";
-import { Events } from "../__Events__.js";
-class ZikoEventFocus extends __ZikoEvent__{
-    constructor(target, customizer){
-        super(target, Events.Focus, details_setter, customizer)
-    }
-}
-function details_setter(){
-
-}
-const bind_focus_event = (target, customizer) => new ZikoEventFocus(target, customizer)
-
-export{
-    bind_focus_event,
-    ZikoEventFocus
-}

package/src/events/binders/hash.js

@@ -1,16 +0,0 @@
-import { __ZikoEvent__ } from "../__ZikoEvent__.js";
-import { Events } from "../__Events__.js";
-class ZikoEventHash extends __ZikoEvent__{
-    constructor(target, customizer){
-        super(target, Events.Hash, details_setter, customizer)
-    }
-}
-function details_setter(){
-
-}
-const bindHashEvent = (target, customizer) => new ZikoEventHash(target, customizer)
-
-export{
-    bindHashEvent,
-    ZikoEventHash
-}

package/src/events/binders/key.js

@@ -1,27 +0,0 @@
-import { __ZikoEvent__ } from "../__ZikoEvent__.js";
-import { Events } from "../__Events__.js";
-class ZikoEventKey extends __ZikoEvent__{
-    constructor(target, customizer){
-        super(target, Events.Key, details_setter, customizer)
-    }
-}
-function details_setter(){
-    switch(this.currentEvent){
-        case "keydown" : {
-            this.kd = this.event.key
-        }; break;
-        case "keypress" : {
-            this.kp = this.event.key
-        }; break;
-        case "keyup" : {
-            this.ku = this.event.key
-        }; break;
-
-    }
-}
-const bind_key_event = (target, customizer) => new ZikoEventKey(target, customizer)
-
-export{
-    bind_key_event,
-    ZikoEventKey
-}

package/src/events/binders/mouse.js

@@ -1,16 +0,0 @@
-import { __ZikoEvent__ } from "../__ZikoEvent__.js";
-import { Events } from "../__Events__.js";
-class ZikoEventMouse extends __ZikoEvent__{
-    constructor(target, customizer){
-        super(target, Events.Mouse, details_setter, customizer)
-    }
-}
-function details_setter(){
-
-}
-const bind_mouse_event = (target, customizer) => new ZikoEventMouse(target, customizer)
-
-export{
-    bind_mouse_event,
-    ZikoEventMouse
-}

package/src/events/binders/touch.js

@@ -1,16 +0,0 @@
-import { __ZikoEvent__ } from "../__ZikoEvent__.js";
-import { Events } from "../__Events__.js";
-class ZikoEventTouch extends __ZikoEvent__{
-    constructor(target, customizer){
-        super(target, Events.Touch, details_setter, customizer)
-    }
-}
-function details_setter(){
-
-}
-const bindTouchEvent = (target, customizer) => new ZikoEventTouch(target, customizer)
-
-export{
-    bindTouchEvent,
-    ZikoEventTouch
-}

package/src/events/binders/wheel.js

@@ -1,16 +0,0 @@
-import { __ZikoEvent__ } from "../__ZikoEvent__.js";
-import { Events } from "../__Events__.js";
-class ZikoEventWheel extends __ZikoEvent__{
-    constructor(target, customizer){
-        super(target, Events.Wheel, details_setter, customizer)
-    }
-}
-function details_setter(){
-
-}
-const bind_wheel_event = (target, customizer) => new ZikoEventWheel(target, customizer)
-
-export{
-    bind_wheel_event,
-    ZikoEventWheel
-}

package/src/events/index.d.ts.txt

@@ -1,3 +0,0 @@
-export type * from "./types/pointer.d.ts"
-export type * from "./types/clipboard.d.ts"
-export type * from "./types/focus.d.ts"