canvasengine 2.0.0-beta.42 → 2.0.0-beta.44

package/dist/engine/FocusManager.d.ts

@@ -0,0 +1,173 @@
+import { Signal } from '@signe/reactive';
+import { Element } from './reactive';
+import { CanvasViewport } from '../components/Viewport';
+import { SignalOrPrimitive } from '../components/types';
+/**
+ * Options for scroll behavior when navigating to focused elements
+ *
+ * @property padding - Padding around the element in pixels (default: 0)
+ * @property smooth - Enable smooth scrolling animation (default: false)
+ * @property center - Center the element in the viewport (default: true)
+ * @property duration - Animation duration in ms if smooth=true (default: 300)
+ */
+export interface ScrollOptions {
+    padding?: number;
+    smooth?: boolean;
+    center?: boolean;
+    duration?: number;
+}
+/**
+ * Data structure for a focus container
+ */
+interface FocusContainerData {
+    id: string;
+    element?: Element;
+    focusables: Map<number, Element>;
+    currentIndex: Signal<number | null>;
+    focusedElement: Signal<Element | null>;
+    onFocusChange?: (index: number, element: Element | null) => void;
+    autoScroll?: boolean | ScrollOptions;
+    viewport?: CanvasViewport;
+    throttle?: number;
+    lastNavigateTime?: number;
+    tabindex?: SignalOrPrimitive<number>;
+    tabindexSubscription?: any;
+}
+/**
+ * Central manager for focus navigation system
+ *
+ * Manages focusable elements within containers, handles navigation,
+ * and provides scroll integration with Viewport.
+ *
+ * @example
+ * ```typescript
+ * const manager = FocusManager.getInstance();
+ * manager.registerContainer('menu', containerData);
+ * manager.navigate('menu', 'next');
+ * ```
+ */
+export declare class FocusManager {
+    private static instance;
+    private containers;
+    private scrollAnimations;
+    /**
+     * Get the singleton instance of FocusManager
+     *
+     * @returns The FocusManager instance
+     */
+    static getInstance(): FocusManager;
+    /**
+     * Register a focus container
+     *
+     * @param id - Unique identifier for the container
+     * @param data - Container data including signals and callbacks
+     */
+    registerContainer(id: string, data: Omit<FocusContainerData, 'id'>): void;
+    /**
+     * Update a focus container's data
+     *
+     * @param id - Container identifier
+     * @param data - Partial container data to update
+     */
+    updateContainer(id: string, data: Partial<Omit<FocusContainerData, 'id'>>): void;
+    setTabindex(id: string, tabindex: SignalOrPrimitive<number>): void;
+    /**
+     * Unregister a focus container
+     *
+     * @param id - Container identifier to remove
+     */
+    unregisterContainer(id: string): void;
+    /**
+     * Register a focusable element in a container
+     *
+     * @param containerId - Container identifier
+     * @param element - Element to register
+     * @param index - Focus index for this element
+     */
+    registerFocusable(containerId: string, element: Element, index: number): void;
+    /**
+     * Unregister a focusable element from a container
+     *
+     * @param containerId - Container identifier
+     * @param index - Focus index to remove
+     */
+    unregisterFocusable(containerId: string, index: number): void;
+    /**
+     * Navigate to next or previous focusable element
+     *
+     * @param containerId - Container identifier
+     * @param direction - Navigation direction ('next' or 'previous')
+     */
+    navigate(containerId: string, direction: 'next' | 'previous'): void;
+    /**
+     * Set the focus index for a container
+     *
+     * @param containerId - Container identifier
+     * @param index - Focus index to set
+     */
+    setIndex(containerId: string, index: number): void;
+    /**
+     * Get the element at a specific index
+     *
+     * @param containerId - Container identifier
+     * @param index - Focus index
+     * @returns Element at index or null
+     */
+    getElement(containerId: string, index: number): Element | null;
+    /**
+     * Get current focus index for a container
+     *
+     * @param containerId - Container identifier
+     * @returns Current index signal
+     */
+    getCurrentIndexSignal(containerId: string): Signal<number | null> | null;
+    /**
+     * Get current focused element signal for a container
+     *
+     * @param containerId - Container identifier
+     * @returns Current element signal
+     */
+    getFocusedElementSignal(containerId: string): Signal<Element | null> | null;
+    /**
+     * Check if an element is visible in the viewport
+     *
+     * @param element - Element to check
+     * @param viewport - Viewport to check against (optional)
+     * @returns True if element is visible
+     */
+    isElementVisible(element: Element, viewport?: CanvasViewport): boolean;
+    /**
+     * Get global bounds of an element
+     *
+     * @param element - Element to get bounds for
+     * @returns Bounds object with x, y, width, height
+     */
+    getElementBounds(element: Element): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /**
+     * Scroll viewport to show an element
+     *
+     * @param containerId - Container identifier
+     * @param index - Focus index of element to scroll to
+     * @param viewport - Viewport instance (optional, uses container's viewport if not provided)
+     * @param options - Scroll options
+     */
+    scrollToElement(containerId: string, index: number, viewport?: CanvasViewport, options?: ScrollOptions): void;
+    /**
+     * Animate smooth scrolling
+     *
+     * @param containerId - Container identifier
+     * @param viewport - Viewport instance
+     * @param targetX - Target X position
+     * @param targetY - Target Y position
+     * @param duration - Animation duration in ms
+     */
+    private animateScroll;
+}
+export declare const focusManager: FocusManager;
+export {};
+//# sourceMappingURL=FocusManager.d.ts.map

package/dist/engine/FocusManager.d.ts.map

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

package/dist/engine/animation.d.ts

@@ -1,6 +1,5 @@
 import { WritableSignal, Signal } from '@signe/reactive';
 import { Tick } from '../directives/Scheduler';
-
 export interface AnimateOptions<T> {
     duration?: number;
     ease?: (t: number) => number;

package/dist/engine/bootstrap.d.ts

@@ -1,6 +1,5 @@
 import { Application, ApplicationOptions } from 'pixi.js';
 import { ComponentFunction } from './signal';
-
 /**
  * Extended options for bootstrapCanvas that includes component registration configuration.
  *

package/dist/engine/directive.d.ts

@@ -1,5 +1,4 @@
 import { Element } from './reactive';
-
 export declare const directives: {
     [key: string]: any;
 };

package/dist/engine/reactive.d.ts

@@ -2,7 +2,6 @@ import { Signal } from '@signe/reactive';
 import { Observable, Subject, Subscription } from 'rxjs';
 import { ComponentInstance } from '../components/DisplayObject';
 import { Directive } from './directive';
-
 export interface Props {
     [key: string]: any;
 }

package/dist/engine/reactive.d.ts.map

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

package/dist/engine/signal.d.ts

@@ -1,7 +1,6 @@
 import { Subscription } from 'rxjs';
 import { Element } from './reactive';
 import { Tick } from '../directives/Scheduler';
-
 type MountFunction = (fn: (element: Element) => void) => void;
 export type ComponentFunction<P = {}> = (props: P) => Element | Promise<Element>;
 export declare let currentSubscriptionsTracker: ((subscription: Subscription) => void) | null;

package/dist/engine/utils.d.ts

@@ -1,5 +1,4 @@
 import { ObservablePoint } from 'pixi.js';
-
 /**
  * Checks if code is running in a browser environment
  * @returns {boolean} True if running in browser, false otherwise

package/dist/hooks/useFocus.d.ts

@@ -0,0 +1,60 @@
+import { Signal } from '@signe/reactive';
+import { Element } from '../engine/reactive';
+/**
+ * Get the current focus index signal for a container
+ *
+ * Returns a reactive signal that updates when the focus index changes.
+ *
+ * @param containerId - Container identifier
+ * @returns Signal for current focus index, or null if container not found
+ *
+ * @example
+ * ```typescript
+ * const focusIndex = useFocusIndex('myContainer');
+ * effect(() => {
+ *   console.log('Current focus index:', focusIndex?.());
+ * });
+ * ```
+ */
+export declare function useFocusIndex(containerId: string): Signal<number | null> | null;
+/**
+ * Get the current focused element signal for a container
+ *
+ * Returns a reactive signal that updates when the focused element changes.
+ *
+ * @param containerId - Container identifier
+ * @returns Signal for current focused element, or null if container not found
+ *
+ * @example
+ * ```typescript
+ * const focusedElement = useFocusedElement('myContainer');
+ * effect(() => {
+ *   const element = focusedElement?.();
+ *   if (element) {
+ *     console.log('Focused element:', element);
+ *   }
+ * });
+ * ```
+ */
+export declare function useFocusedElement(containerId: string): Signal<Element | null> | null;
+/**
+ * Hook to react to focus changes
+ *
+ * Sets up a reactive effect that calls the callback whenever the focus changes.
+ *
+ * @param containerId - Container identifier
+ * @param callback - Function to call when focus changes
+ * @returns Cleanup function to unsubscribe
+ *
+ * @example
+ * ```typescript
+ * useFocusChange('myContainer', (index, element) => {
+ *   console.log('Focus changed to index', index);
+ *   if (element) {
+ *     console.log('Focused element:', element);
+ *   }
+ * });
+ * ```
+ */
+export declare function useFocusChange(containerId: string, callback: (index: number | null, element: Element | null) => void): () => void;
+//# sourceMappingURL=useFocus.d.ts.map

package/dist/hooks/useFocus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFocus.d.ts","sourceRoot":"","sources":["../../src/hooks/useFocus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAI7C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAE/E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,IAAI,CAEpF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,GAChE,MAAM,IAAI,CAsBZ"}

package/dist/hooks/useRef.d.ts

@@ -1,5 +1,4 @@
 import { Element } from '../engine/reactive';
 import { ComponentInstance } from '../components/DisplayObject';
-
 export declare function useRef(element: Element<ComponentInstance>, ref: string): Element<ComponentInstance> | null;
 //# sourceMappingURL=useRef.d.ts.map