@hawsen-the-first/interactiv 0.0.1

package/dist/src/appBuilder.d.ts

@@ -0,0 +1,173 @@
+import { EventBus, EventOrchestrator } from "./eventBus";
+import { type ScreensaverConfig } from "./screensaverManager";
+import { type SettingsConfig } from "./settingsManager";
+import { EventManager } from "./eventManager";
+import { ComponentStateManager } from "./stateManager";
+import type { PointerEventData, DragCallbacks, HoverCallbacks, SwipeCallbacks } from "./eventManager";
+import type { RenderOptions } from "./types";
+declare abstract class RenderableComponent {
+    componentId: string;
+    state: any;
+    renderBus: EventBus;
+    protected shadowRoot: ShadowRoot;
+    protected bubbleChanges: boolean;
+    protected children: RenderableComponent[];
+    protected parent?: RenderableComponent;
+    protected template: string;
+    protected styles: string;
+    protected lastRenderedHTML: string;
+    protected properties: Map<string, any>;
+    protected hostElement: HTMLElement;
+    protected eventManager: EventManager;
+    protected stateManager: ComponentStateManager;
+    protected orchestrator: EventOrchestrator;
+    private globalSheets;
+    constructor(id: string, orchestrator: EventOrchestrator, bubbleChanges?: boolean);
+    private setupRenderListeners;
+    protected attachShadowDOM(): void;
+    useGlobalStyles(text: string): Promise<void>;
+    private initializeEventManager;
+    /**
+     * Clean up event listeners before re-render to prevent duplicates
+     */
+    private initializeStateManager;
+    private handleStateChange;
+    protected performRender(options?: RenderOptions): void;
+    private performRenderWithFade;
+    private performRenderImmediate;
+    private compileTemplate;
+    private updateShadowDOM;
+    private renderChildren;
+    protected getProperty(key: string): any;
+    getPublicProperty(key: string): any;
+    setProperty(key: string, value: any): void;
+    addChild(child: RenderableComponent): void;
+    removeChild(childId: string): void;
+    addSibling(sibling: RenderableComponent): void;
+    removeSibling(siblingId: string): void;
+    private notifyChildrenOfStructureChange;
+    private attachEventListeners;
+    protected handleAction(action: string, event: Event): void;
+    protected onBeforeRender(): void;
+    onAfterRender(): void;
+    protected shouldRerender(changeType: string, source: string): boolean;
+    protected handleParentChange(changeType: string): void;
+    protected handleChildChange(childId: string, changeType: string): void;
+    protected abstract defineTemplate(): void;
+    protected abstract defineStyles(): void;
+    performInitialRender(): void;
+    getHostElement(): HTMLElement;
+    getChildrenCount(): number;
+    /**
+     * Add a point interaction (click + tap) to elements matching the selector
+     */
+    protected point(selector: string, callback: (data: PointerEventData) => void): void;
+    /**
+     * Add an un-point interaction (click + tap) to elements matching the selector
+     */
+    protected unpoint(selector: string, callback: (data: PointerEventData) => void): void;
+    /**
+     * Add drag interaction (mouse drag + touch drag) to elements matching the selector
+     */
+    protected drag(selector: string, callbacks: DragCallbacks): void;
+    /**
+     * Add hover interaction (mouse enter/leave + touch fallback) to elements matching the selector
+     */
+    protected hover(selector: string, callbacks: HoverCallbacks): void;
+    /**
+     * Add long press interaction to elements matching the selector
+     */
+    protected longPress(selector: string, callback: (data: PointerEventData) => void, duration?: number): void;
+    /**
+     * Add swipe gesture detection to elements matching the selector
+     */
+    protected swipe(selector: string, callbacks: SwipeCallbacks, threshold?: number): void;
+    /**
+     * Add a custom event listener with automatic cleanup
+     */
+    protected addEventListener(element: Element | Document, type: string, listener: EventListener, options?: AddEventListenerOptions): void;
+    /**
+     * Remove a specific event listener
+     */
+    protected removeEventListener(element: Element, type: string, listener: EventListener): void;
+    /**
+     * Create and manage local component state
+     */
+    useState<T>(key: string, initialValue: T): [T, (newValue: T) => void];
+    /**
+     * Subscribe to and manage global application state
+     */
+    protected useGlobalState<T>(key: string, initialValue?: T): [T, (newValue: T) => void];
+    /**
+     * Get current local state value without subscribing
+     */
+    protected getLocalState(key: string): any;
+    /**
+     * Define multiple state properties at once with initial values
+     * This creates reactive state properties accessible via this.state
+     */
+    defineState(initialState: Record<string, any>): void;
+    /**
+     * Destroy the component and clean up all event listeners
+     */
+    destroy(): void;
+}
+declare class AppBuilder extends RenderableComponent {
+    private pages;
+    private navigationManager;
+    constructor(orchestrator: EventOrchestrator);
+    private setupNavigationContainer;
+    protected defineTemplate(): void;
+    protected defineStyles(): void;
+    addPage(page: Page): void;
+    removePage(pageId: string): void;
+    navigateToPage(pageId: string, config?: import("./navigationManager").TransitionConfig): void;
+    navigateToView(viewId: string, config?: import("./navigationManager").TransitionConfig): void;
+    getCurrentPageId(): string | null;
+    getCurrentViewId(): string | null;
+    isTransitioning(): boolean;
+    /**
+     * Add a screensaver page with the specified configuration
+     * The screensaver page can contain multiple views for rich interactive experiences
+     * @param screensaverPage The page to use as the screensaver (can contain multiple views)
+     * @param config Configuration object for the screensaver (excluding 'page' property)
+     */
+    addScreensaver(screensaverPage: Page, config: Omit<ScreensaverConfig, 'page'>): void;
+    attachToDom(): void;
+}
+declare class Page extends RenderableComponent {
+    private views;
+    constructor(id: string, orchestrator: EventOrchestrator, bubbleChanges?: boolean, customTemplate?: string, customStyles?: string);
+    protected defineTemplate(): void;
+    protected defineStyles(): void;
+    addView(view: View): void;
+    removeView(viewId: string): void;
+    /**
+     * Add a screensaver page with the specified configuration
+     * @param screensaverPage The page to use as the screensaver (can contain multiple views)
+     * @param config Configuration object for the screensaver (excluding 'page' property)
+     */
+    addScreensaver(screensaverPage: Page, config: Omit<ScreensaverConfig, 'page'>): void;
+    /**
+     * Add a hidden settings page to this page with the specified configuration
+     * The settings page is activated by touching corners in sequence: top-left, top-right, bottom-right
+     * @param view The view to use as the settings page
+     * @param config Configuration object for the settings page
+     */
+    addSettings(view: View, config: SettingsConfig): void;
+}
+declare class View extends RenderableComponent {
+    private components;
+    constructor(id: string, orchestrator: EventOrchestrator, bubbleChanges?: boolean, customTemplate?: string, customStyles?: string);
+    protected defineTemplate(): void;
+    protected defineStyles(): void;
+    addComponent(component: Component): void;
+    removeComponent(componentId: string): void;
+}
+declare class Component extends RenderableComponent {
+    constructor(id: string, orchestrator: EventOrchestrator, bubbleChanges?: boolean, customTemplate?: string, customStyles?: string);
+    protected defineTemplate(): void;
+    protected defineStyles(): void;
+}
+export { AppBuilder, Page, View, Component, RenderableComponent, EventBus };
+//# sourceMappingURL=appBuilder.d.ts.map

package/dist/src/appBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appBuilder.d.ts","sourceRoot":"","sources":["../../src/appBuilder.ts"],"names":[],"mappings":"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"}