@rb-games/core 0.1.0

package/dist/ui/behaviors/ScrollbarBehavior.d.ts

@@ -0,0 +1,371 @@
+import { type Container, type FederatedPointerEvent } from 'pixi.js';
+import { EventEmitter } from 'eventemitter3';
+export interface ScrollbarEvents {
+    /** Fired when scrollbar value changes */
+    scroll: (value: number, percentage: number) => void;
+    /** Fired when scrolling starts */
+    scrollStart: (value: number) => void;
+    /** Fired when scrolling ends */
+    scrollEnd: (value: number) => void;
+    /** Fired when track is clicked */
+    click: (clickPosition: {
+        x: number;
+        y: number;
+    }, percentage: number) => void;
+    /** Fired when views are attached */
+    viewAttached: (trackView: Container, knobView: Container) => void;
+    /** Fired when views are detached */
+    viewDetached: (trackView: Container, knobView: Container) => void;
+    /** Fired when state changes */
+    stateChanged: (state: ScrollbarState) => void;
+    /** Fired when pointer enters knob */
+    knobOver?: (event: FederatedPointerEvent) => void;
+    /** Fired when pointer leaves knob */
+    knobOut?: (event: FederatedPointerEvent) => void;
+    /** Fired when knob is pressed */
+    knobDown?: (event: FederatedPointerEvent) => void;
+    /** Fired when knob is released */
+    knobUp?: (event: FederatedPointerEvent) => void;
+    /** Fired when knob is clicked */
+    knobClick?: (event: FederatedPointerEvent) => void;
+    /** Fired when pointer enters track */
+    trackOver?: (event: FederatedPointerEvent) => void;
+    /** Fired when pointer leaves track */
+    trackOut?: (event: FederatedPointerEvent) => void;
+    /** Fired when track is pressed */
+    trackDown?: (event: FederatedPointerEvent) => void;
+    /** Fired when track is released */
+    trackUp?: (event: FederatedPointerEvent) => void;
+    /** Fired when track is clicked */
+    trackClick?: (event: FederatedPointerEvent) => void;
+}
+export interface ScrollbarMargin {
+    /** Left margin for horizontal, top margin for vertical */
+    start?: number;
+    /** Right margin for horizontal, bottom margin for vertical */
+    end?: number;
+}
+export interface ScrollbarOptions {
+    /** Scrollbar orientation */
+    orientation?: 'horizontal' | 'vertical';
+    /** Minimum value */
+    min?: number;
+    /** Maximum value */
+    max?: number;
+    /** Current value */
+    value?: number;
+    /** Step size for value changes */
+    step?: number;
+    /** Mouse wheel step size */
+    wheelStep?: number;
+    /** Enable/disable wheel scrolling */
+    enableWheel?: boolean;
+    /** Margin for knob movement area */
+    margin?: ScrollbarMargin;
+    /** Cursor style for track */
+    trackCursor?: string;
+    /** Cursor style for knob */
+    knobCursor?: string;
+}
+export interface ScrollbarState {
+    /** Whether scrollbar is enabled */
+    enabled: boolean;
+    /** Whether knob is being dragged */
+    dragging: boolean;
+    /** Current value */
+    value: number;
+    /** Current value as percentage (0-1) */
+    percentage: number;
+    /** Scrollbar orientation */
+    orientation: 'horizontal' | 'vertical';
+    /** Track size in pixels */
+    trackSize: number;
+    /** Track thickness in pixels */
+    trackThickness: number;
+    /** Knob size in pixels */
+    knobSize: number;
+}
+/**
+ * Scrollbar interaction behavior for PixiJS containers.
+ *
+ * This module provides ScrollbarBehavior for complete scrollbar functionality including
+ * drag scrolling with knob, track click to jump, mouse wheel support, and configurable
+ * horizontal/vertical orientation.
+ *
+ * ## Features
+ *
+ * - **Drag Scrolling**: Smooth knob dragging
+ * - **Track Click**: Click track to jump to position
+ * - **Mouse Wheel**: Scroll with mouse wheel
+ * - **Orientation**: Horizontal or vertical
+ * - **Margins**: Configurable start/end margins for knob movement
+ * - **Step Values**: Snap to step increments
+ * - **Event-Driven**: Rich event system for all interactions
+ *
+ * @example
+ * Basic horizontal scrollbar:
+ * ```typescript
+ * import { ScrollbarBehavior } from '@rb-games/core/ui/behaviors';
+ *
+ * const scrollbar = new ScrollbarBehavior({
+ *   orientation: 'horizontal',
+ *   min: 0,
+ *   max: 100,
+ *   value: 0,
+ *   step: 1
+ * });
+ *
+ * scrollbar.attachViews(trackContainer, knobContainer);
+ *
+ * scrollbar.on('scroll', (value, percentage) => {
+ *   console.log(`Scrolled to: ${value} (${percentage * 100}%)`);
+ *   contentContainer.x = -value * contentWidth;
+ * });
+ * ```
+ *
+ * @example
+ * Vertical scrollbar with margins:
+ * ```typescript
+ * const scrollbar = new ScrollbarBehavior({
+ *   orientation: 'vertical',
+ *   min: 0,
+ *   max: 1000,
+ *   margin: { start: 10, end: 10 },  // 10px margin on top/bottom
+ *   wheelStep: 50  // Scroll 50 units per wheel tick
+ * });
+ *
+ * scrollbar.attachViews(trackContainer, knobContainer);
+ *
+ * scrollbar.on('scroll', (value, percentage) => {
+ *   contentContainer.y = -value;
+ * });
+ * ```
+ *
+ * @example
+ * Factory method with views:
+ * ```typescript
+ * const scrollbar = ScrollbarBehavior.withViews(
+ *   trackContainer,
+ *   knobContainer,
+ *   {
+ *     orientation: 'horizontal',
+ *     min: 0,
+ *     max: 500,
+ *     trackCursor: 'pointer',
+ *     knobCursor: 'grab'
+ *   }
+ * );
+ * ```
+ *
+ * @example
+ * Listening to drag events:
+ * ```typescript
+ * scrollbar.on('scrollStart', (value) => {
+ *   console.log('Started dragging at:', value);
+ *   knobContainer.tint = 0xCCCCCC;
+ * });
+ *
+ * scrollbar.on('scroll', (value, percentage) => {
+ *   updateContent(value);
+ * });
+ *
+ * scrollbar.on('scrollEnd', (value) => {
+ *   console.log('Stopped dragging at:', value);
+ *   knobContainer.tint = 0xFFFFFF;
+ * });
+ * ```
+ *
+ * @example
+ * Track click handling:
+ * ```typescript
+ * scrollbar.on('click', (clickPos, percentage) => {
+ *   console.log(`Clicked at ${clickPos.x}, ${clickPos.y}`);
+ *   console.log(`Jump to ${percentage * 100}%`);
+ * });
+ * ```
+ *
+ * @example
+ * State-based visual updates:
+ * ```typescript
+ * scrollbar.on('stateChanged', (state) => {
+ *   if (state.dragging) {
+ *     knobContainer.tint = 0xFFFF00;
+ *   } else {
+ *     knobContainer.tint = 0xFFFFFF;
+ *   }
+ *
+ *   console.log('Current value:', state.value);
+ *   console.log('Percentage:', state.percentage);
+ * });
+ * ```
+ *
+ * @example
+ * Dynamic orientation change:
+ * ```typescript
+ * const scrollbar = new ScrollbarBehavior({
+ *   orientation: 'horizontal'
+ * });
+ * scrollbar.attachViews(trackContainer, knobContainer);
+ *
+ * // Later, switch to vertical
+ * scrollbar.orientation = 'vertical';
+ * scrollbar.refreshSizes();  // Update sizes after orientation change
+ * ```
+ *
+ * @example
+ * Knob and track UI events:
+ * ```typescript
+ * // Knob events
+ * scrollbar.on('knobOver', () => {
+ *   knobContainer.tint = 0xFFFFAA;
+ * });
+ *
+ * scrollbar.on('knobOut', () => {
+ *   knobContainer.tint = 0xFFFFFF;
+ * });
+ *
+ * // Track events
+ * scrollbar.on('trackOver', () => {
+ *   trackContainer.alpha = 1.0;
+ * });
+ *
+ * scrollbar.on('trackOut', () => {
+ *   trackContainer.alpha = 0.8;
+ * });
+ * ```
+ *
+ * @example
+ * Content scrolling with scrollbar:
+ * ```typescript
+ * const contentHeight = 2000;
+ * const viewportHeight = 500;
+ * const maxScroll = contentHeight - viewportHeight;
+ *
+ * const scrollbar = new ScrollbarBehavior({
+ *   orientation: 'vertical',
+ *   min: 0,
+ *   max: maxScroll,
+ *   value: 0,
+ *   wheelStep: 50
+ * });
+ *
+ * scrollbar.attachViews(trackContainer, knobContainer);
+ *
+ * scrollbar.on('scroll', (value) => {
+ *   contentContainer.y = -value;
+ * });
+ *
+ * // Update scrollbar when content size changes
+ * function updateContentSize(newHeight: number) {
+ *   const newMaxScroll = newHeight - viewportHeight;
+ *   scrollbar.setRange(0, newMaxScroll);
+ *   scrollbar.refreshSizes();
+ * }
+ * ```
+ *
+ * @see {@link ScrollbarEvents} for available events
+ * @see {@link ScrollbarOptions} for configuration options
+ * @see {@link ScrollbarState} for state interface
+ * @see {@link ScrollbarMargin} for margin configuration
+ *
+ * @category UI
+ * @public
+ */
+export declare class ScrollbarBehavior extends EventEmitter<ScrollbarEvents> {
+    private _trackView;
+    private _knobView;
+    private _enabled;
+    private _isDragging;
+    private _dragStartPosition;
+    private _dragStartValue;
+    private _dragOffset;
+    private _orientation;
+    private _min;
+    private _max;
+    private _value;
+    private _step;
+    private _margin;
+    private _wheelStep;
+    private _enableWheel;
+    private _trackCursor;
+    private _knobCursor;
+    private _eventsBound;
+    private _onTrackPointerDown;
+    private _onKnobPointerDown;
+    private _onKnobPointerUp;
+    private _onKnobPointerUpOutside;
+    private _onGlobalPointerMove;
+    private _onTrackWheel;
+    private _onKnobWheel;
+    static withViews(trackView: Container, knobView: Container, options?: ScrollbarOptions): ScrollbarBehavior;
+    constructor(options?: ScrollbarOptions);
+    attachTrackView(trackView: Container): void;
+    attachKnobView(knobView: Container): void;
+    attachViews(trackView: Container, knobView: Container): void;
+    detachViews(): void;
+    get trackView(): Container | null;
+    get knobView(): Container | null;
+    get hasViews(): boolean;
+    private _setupTrackInteractivity;
+    private _setupKnobInteractivity;
+    private _bindTrackEvents;
+    private _unbindTrackEvents;
+    private _bindKnobEvents;
+    private _unbindKnobEvents;
+    private _unbindAllEvents;
+    private _updateEventsBoundState;
+    private _handleTrackPointerDown;
+    private _handleKnobPointerDown;
+    private _handleKnobPointerUp;
+    private _handleGlobalPointerMove;
+    private _handleWheel;
+    private _getTrackSize;
+    private _getTrackThickness;
+    private _getKnobSize;
+    private _getEffectiveTrackArea;
+    private _updateKnobPosition;
+    private _emitStateChange;
+    get enabled(): boolean;
+    set enabled(value: boolean);
+    get isDragging(): boolean;
+    get value(): number;
+    set value(newValue: number);
+    get percentage(): number;
+    get trackSize(): number;
+    get trackThickness(): number;
+    get knobSize(): number;
+    get orientation(): 'horizontal' | 'vertical';
+    set orientation(value: 'horizontal' | 'vertical');
+    get margin(): ScrollbarMargin;
+    set margin(value: ScrollbarMargin);
+    get wheelStep(): number;
+    set wheelStep(value: number);
+    get enableWheel(): boolean;
+    set enableWheel(value: boolean);
+    get step(): number;
+    set step(value: number);
+    get trackCursor(): string;
+    set trackCursor(value: string);
+    get knobCursor(): string;
+    set knobCursor(value: string);
+    get min(): number;
+    set min(value: number);
+    get max(): number;
+    set max(value: number);
+    getTrackBounds(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    getEffectiveArea(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    refreshSizes(): void;
+    setRange(min: number, max: number): void;
+    destroy(): void;
+}
+//# sourceMappingURL=ScrollbarBehavior.d.ts.map

package/dist/ui/behaviors/ScrollbarBehavior.d.ts.map

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

package/dist/ui/behaviors/index.d.ts

@@ -0,0 +1,4 @@
+export * from './ButtonBehavior';
+export * from './ScrollbarBehavior';
+export * from './InputBehavior';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/behaviors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../ui/behaviors/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}

package/dist/ui/components/ButtonComp.d.ts

@@ -0,0 +1,138 @@
+import { Container, Graphics, Text, Sprite, TextStyleOptions, PointData } from 'pixi.js';
+import type { DeepPartial, GraphicsConfig, SpriteConfig } from './Component.types';
+import { SpriteText, type SpriteTextSkinData } from './spriteText';
+import { ButtonBehavior, ButtonVisualState } from '../behaviors';
+import type { LayoutStyles } from '@pixi/layout';
+type PixiTextButtonConfig = {
+    type: 'text';
+    textStyle?: TextStyleOptions;
+    spriteData?: never;
+    layout?: boolean | LayoutStyles | null;
+    anchor?: PointData;
+};
+type SpriteTextButtonConfig = {
+    type: 'sprite';
+    textStyle?: never;
+    spriteData: SpriteTextSkinData;
+    layout?: boolean | LayoutStyles | null;
+    anchor?: never;
+};
+type ButtonTextConfig = PixiTextButtonConfig | SpriteTextButtonConfig;
+export interface ButtonCompStateData {
+    base?: string;
+    background?: GraphicsConfig | SpriteConfig;
+    textConfig?: ButtonTextConfig;
+    icon?: GraphicsConfig | SpriteConfig;
+    layout?: boolean | LayoutStyles | null;
+    placeHolderLayout?: boolean | LayoutStyles | null;
+    zIndex?: number;
+}
+export type ButtonStateKey = ButtonVisualState;
+export type IconTextureConfig = string | Partial<Record<ButtonStateKey, string>>;
+export interface ButtonCompSkinData {
+    up: ButtonCompStateData;
+    down?: DeepPartial<ButtonCompStateData>;
+    over?: DeepPartial<ButtonCompStateData>;
+    disabled?: DeepPartial<ButtonCompStateData>;
+    selected_up?: DeepPartial<ButtonCompStateData>;
+    selected_down?: DeepPartial<ButtonCompStateData>;
+    selected_over?: DeepPartial<ButtonCompStateData>;
+    selected_disabled?: DeepPartial<ButtonCompStateData>;
+}
+export interface ButtonCompOptions {
+    text?: string;
+    label?: string;
+    icon?: string;
+    skinData?: ButtonCompSkinData;
+    enabled?: boolean;
+}
+/**
+ * Button effect instance that can be attached to buttons.
+ *
+ * Created by {@link createButtonEffect} function.
+ */
+export interface ButtonEffect {
+    /**
+     * Unique name for the effect.
+     */
+    readonly name: string;
+    /**
+     * Internal attach handler.
+     * @internal
+     */
+    _onAttach(button: ButtonComp, state: ButtonStateKey): void;
+    /**
+     * Internal detach handler.
+     * @internal
+     */
+    _onDetach(): void;
+    /**
+     * Internal state change handler.
+     * @internal
+     */
+    _onStateChange(button: ButtonComp, state: ButtonStateKey, previousState?: ButtonStateKey): void;
+    /**
+     * Internal destroy handler.
+     * @internal
+     */
+    _onDestroy(): void;
+}
+declare const ButtonComp_base: new (options?: import("pixi.js").ContainerOptions<import("pixi.js").ContainerChild> | undefined) => Container<import("pixi.js").ContainerChild> & {
+    setSkinData: (data: ButtonCompSkinData | Partial<ButtonCompSkinData> | null, opts?: {
+        mergeWithExisting?: boolean;
+    } | undefined) => void;
+    getSkinData: () => ButtonCompSkinData | null;
+};
+export declare class ButtonComp extends ButtonComp_base {
+    private _buttonBehaviors;
+    private _background;
+    private _placeHolder;
+    private _icon?;
+    private _labelText;
+    private _buttonLabel;
+    private _iconTextures;
+    private _currentState;
+    private _enabled;
+    private _effects;
+    private _previousState?;
+    private _stateDataCache;
+    constructor(options?: ButtonCompOptions);
+    private setupEventListeners;
+    private setState;
+    private _lastLayout;
+    private _lastPlaceHolderLayout;
+    private _lastBackgroundConfig;
+    private _lastIconConfig;
+    private _lastTextConfig;
+    private _lastZIndex;
+    private updateVisualState;
+    protected skinApply(skinData: ButtonCompSkinData | null): void;
+    private precomputeAllStates;
+    private static readonly stateFallbackChain;
+    private getCurrentStateData;
+    private updateBackground;
+    private updateIcon;
+    private drawSprite;
+    private drawGraphic;
+    private updateText;
+    get enabled(): boolean;
+    set enabled(value: boolean);
+    get buttonLabel(): string;
+    set buttonLabel(value: string);
+    set iconTexture(iconTextures: IconTextureConfig | null);
+    get iconTexture(): IconTextureConfig | null;
+    get text(): Text | SpriteText | null;
+    get background(): Graphics | Sprite;
+    get icon(): Graphics | Sprite | undefined;
+    get placeHolder(): Container;
+    get currentState(): keyof ButtonCompSkinData;
+    addButtonEffect(...effects: ButtonEffect[]): this;
+    removeButtonEffect(name: string): boolean;
+    hasButtonEffect(name: string): boolean;
+    getButtonEffect(name: string): ButtonEffect | undefined;
+    private notifyEffectsStateChange;
+    destroy(): void;
+    get behavior(): ButtonBehavior;
+}
+export {};
+//# sourceMappingURL=ButtonComp.d.ts.map

package/dist/ui/components/ButtonComp.d.ts.map

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