@breadstone/mosaik-elements-foundation 0.0.211 → 0.0.214

package/Controls/Components/Primitives/ResizeThumb/ResizeThumbElement.d.ts

@@ -0,0 +1,251 @@
+import { type IEventEmitter } from '@breadstone/mosaik-elements';
+import { type IAttachable } from '../../../Behaviors/Attachable';
+import { ResizeDirection } from '../../../Types/ResizeDirection';
+import { CustomElement } from '../../Abstracts/CustomElement';
+import type { IResizeThumbResizeEndEvent, IResizeThumbResizeEndEventDetail } from './Events/ResizeThumbResizeEndEvent';
+import type { IResizeThumbResizeStartEvent, IResizeThumbResizeStartEventDetail } from './Events/ResizeThumbResizeStartEvent';
+import type { IResizeThumbResizingEvent, IResizeThumbResizingEventDetail } from './Events/ResizeThumbResizingEvent';
+import type { IResizeThumbElementProps } from './IResizeThumbElementProps';
+declare const ResizeThumbElement_base: (abstract new (...args: Array<any>) => import("../../../Behaviors/Themeable").IThemeableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Disableable").IDisableableProps) & (abstract new (...args: Array<any>) => IAttachable) & typeof CustomElement & import("../../../Behaviors/Themeable").IThemeableCtor;
+/**
+ * ResizeThumb - A primitive element that provides resize handle functionality.
+ *
+ * @description
+ * The ResizeThumb element is a low-level primitive that signals resizing capability
+ * in a specific direction. It handles user interactions (mouse/touch) and automatically
+ * resizes the attached control element.
+ *
+ * The element uses the Attachable behavior to connect to its target element, either
+ * through the `for` attribute referencing an element ID, or by automatically attaching
+ * to its parent element.
+ *
+ * Internally, this element uses a {@link ResizeThumbController} for all resize logic.
+ * For programmatic usage without a visual thumb, use the controller directly.
+ *
+ * This element has minimal visual appearance by design - parent components like Dialog,
+ * Sheet, or Panel are expected to style the thumb appropriately for their context.
+ *
+ * @name ResizeThumb
+ * @element mosaik-resize-thumb
+ * @category Primitive
+ *
+ * @slot - Default slot for custom thumb content.
+ *
+ * @csspart thumb - The main thumb element.
+ *
+ * @fires resizestart - Fired when a resize operation begins.
+ * @fires resizing - Fired continuously during a resize operation.
+ * @fires resizeend - Fired when a resize operation ends.
+ *
+ * @example
+ * ```html
+ * <!-- Inside a parent element (attaches to parent) -->
+ * <mosaik-dialog>
+ *   <mosaik-resize-thumb direction="south-east"></mosaik-resize-thumb>
+ * </mosaik-dialog>
+ *
+ * <!-- Attached to specific element via for attribute -->
+ * <div id="resizable-box" style="width: 200px; height: 150px;">
+ *   Content
+ * </div>
+ * <mosaik-resize-thumb for="resizable-box" direction="south-east"></mosaik-resize-thumb>
+ *
+ * <!-- With constraints -->
+ * <mosaik-resize-thumb
+ *   direction="south-east"
+ *   min-width="100"
+ *   min-height="80"
+ *   max-width="500"
+ *   max-height="400">
+ * </mosaik-resize-thumb>
+ *
+ * <!-- Auto-apply disabled (manual handling via events) -->
+ * <mosaik-resize-thumb direction="east" auto-apply="false"></mosaik-resize-thumb>
+ * ```
+ *
+ * @see {@link ResizeThumbController} for programmatic usage without visual element.
+ *
+ * @public
+ */
+export declare class ResizeThumbElement extends ResizeThumbElement_base implements IResizeThumbElementProps, IAttachable {
+    private readonly _resizeStart;
+    private readonly _resizing;
+    private readonly _resizeEnd;
+    private _direction;
+    private _allowedDirections;
+    private _minWidth;
+    private _minHeight;
+    private _maxWidth;
+    private _maxHeight;
+    private _autoApply;
+    private _controller;
+    private _mouseDownSubscription;
+    private _touchStartSubscription;
+    /**
+     * @public
+     */
+    constructor();
+    /**
+     * Returns the `{@link is}` property.
+     * The `{@link is}` property represents natural name of this element.
+     *
+     * @public
+     * @static
+     * @readonly
+     */
+    static get is(): string;
+    /**
+     * Gets or sets the resize `direction`.
+     *
+     * Determines which direction this resize thumb represents.
+     * The cursor style is automatically updated based on this direction.
+     *
+     * @attr
+     * @public
+     */
+    get direction(): ResizeDirection;
+    set direction(value: ResizeDirection);
+    /**
+     * Gets or sets the `allowedDirections` array.
+     *
+     * When set, only the specified directions are permitted for resizing.
+     * If the current direction is not in the allowed list, resize operations
+     * will be blocked.
+     *
+     * @attr
+     * @public
+     */
+    get allowedDirections(): ReadonlyArray<ResizeDirection>;
+    set allowedDirections(value: ReadonlyArray<ResizeDirection>);
+    /**
+     * Gets or sets the minimum width the control can be resized to.
+     *
+     * @attr min-width
+     * @public
+     */
+    get minWidth(): number;
+    set minWidth(value: number);
+    /**
+     * Gets or sets the minimum height the control can be resized to.
+     *
+     * @attr min-height
+     * @public
+     */
+    get minHeight(): number;
+    set minHeight(value: number);
+    /**
+     * Gets or sets the maximum width the control can be resized to.
+     *
+     * @attr max-width
+     * @public
+     */
+    get maxWidth(): number;
+    set maxWidth(value: number);
+    /**
+     * Gets or sets the maximum height the control can be resized to.
+     *
+     * @attr max-height
+     * @public
+     */
+    get maxHeight(): number;
+    set maxHeight(value: number);
+    /**
+     * Gets or sets whether resize changes are automatically applied to the control element.
+     * If false, only events are emitted and the control is responsible for applying changes.
+     * Defaults to true.
+     *
+     * @attr auto-apply
+     * @public
+     */
+    get autoApply(): boolean;
+    set autoApply(value: boolean);
+    /**
+     * Gets whether a resize operation is currently in progress.
+     *
+     * @public
+     * @readonly
+     */
+    get isResizing(): boolean;
+    /**
+     * Called when a resize operation starts.
+     * Provides reference to `{@link IResizeThumbResizeStartEventDetail}` as event detail.
+     *
+     * @public
+     * @readonly
+     * @eventProperty
+     */
+    get resizeStart(): IEventEmitter<IResizeThumbResizeStartEventDetail>;
+    /**
+     * Called during a resize operation.
+     * Provides reference to `{@link IResizeThumbResizingEventDetail}` as event detail.
+     *
+     * @public
+     * @readonly
+     * @eventProperty
+     */
+    get resizing(): IEventEmitter<IResizeThumbResizingEventDetail>;
+    /**
+     * Called when a resize operation ends.
+     * Provides reference to `{@link IResizeThumbResizeEndEventDetail}` as event detail.
+     *
+     * @public
+     * @readonly
+     * @eventProperty
+     */
+    get resizeEnd(): IEventEmitter<IResizeThumbResizeEndEventDetail>;
+    /**
+     * @public
+     * @override
+     */
+    connectedCallback(): void;
+    /**
+     * @public
+     * @override
+     */
+    disconnectedCallback(): void;
+    /**
+     * @protected
+     * @override
+     */
+    protected onApplyTemplate(): void;
+    /**
+     * Checks if the current direction is allowed.
+     *
+     * @protected
+     * @returns True if the direction is in the allowed list, false otherwise.
+     */
+    protected isDirectionAllowed(): boolean;
+    /**
+     * Handles the start of a pointer (mouse or touch) interaction.
+     *
+     * @protected
+     */
+    protected onPointerStart(clientX: number, clientY: number, event: MouseEvent | TouchEvent): void;
+    /**
+     * Initializes or re-initializes the controller with the current control element.
+     *
+     * @private
+     */
+    private initializeController;
+}
+/**
+ * @public
+ */
+export declare namespace ResizeThumbElement {
+    type Props = IResizeThumbElementProps;
+}
+/**
+ * @public
+ */
+declare global {
+    interface HTMLElementTagNameMap {
+        'mosaik-resize-thumb': ResizeThumbElement;
+    }
+    interface HTMLElementEventMap {
+        resizestart: IResizeThumbResizeStartEvent;
+        resizing: IResizeThumbResizingEvent;
+        resizeend: IResizeThumbResizeEndEvent;
+    }
+}
+export {};
+//# sourceMappingURL=ResizeThumbElement.d.ts.map

package/Controls/Components/Primitives/ResizeThumb/ResizeThumbElement.d.ts.map

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