@harborclient/sdk 1.3.4 → 1.3.5

package/dist/components/CodeEditor/selectionActionToolbar.js

@@ -0,0 +1,319 @@
+import { EditorView, ViewPlugin } from '@codemirror/view';
+/** Delay before showing the selection action toolbar after selection settles. */
+export const SELECTION_TOOLBAR_SHOW_DELAY_MS = 450;
+/**
+ * Computes viewport anchor coordinates for the selection action toolbar.
+ *
+ * @param view - CodeMirror editor view (or test double).
+ * @param selectionFrom - Start offset (inclusive) of the selection.
+ * @param selectionTo - End offset (exclusive) of the selection.
+ * @returns Toolbar anchor position, or null when coords are unavailable.
+ */
+export function computeSelectionActionToolbarCoords(view, selectionFrom, selectionTo) {
+    const startCoords = view.coordsAtPos(selectionFrom);
+    if (!startCoords) {
+        return null;
+    }
+    const endCoords = view.coordsAtPos(selectionTo);
+    const startCenter = startCoords.left + (startCoords.right - startCoords.left) / 2;
+    const endCenter = endCoords
+        ? endCoords.left + (endCoords.right - endCoords.left) / 2
+        : startCenter;
+    return {
+        top: startCoords.top,
+        left: (startCenter + endCenter) / 2
+    };
+}
+/**
+ * Builds a toolbar snapshot from the current editor selection when it is usable.
+ *
+ * @param view - CodeMirror editor view (or test double).
+ * @returns Toolbar state, or null when the selection is empty, whitespace-only, or coords fail.
+ */
+export function buildSelectionActionToolbarState(view) {
+    const { from, to } = view.state.selection.main;
+    if (from === to) {
+        return null;
+    }
+    const selectionFrom = Math.min(from, to);
+    const selectionTo = Math.max(from, to);
+    const text = view.state.sliceDoc(selectionFrom, selectionTo);
+    if (!text.trim()) {
+        return null;
+    }
+    const coords = computeSelectionActionToolbarCoords(view, selectionFrom, selectionTo);
+    if (!coords) {
+        return null;
+    }
+    return {
+        top: coords.top,
+        left: coords.left,
+        text,
+        from: selectionFrom,
+        to: selectionTo
+    };
+}
+/**
+ * Creates a fresh controller used by the selection toolbar extensions and unit tests.
+ *
+ * @returns Mutable controller state for pointer-drag and debounce bookkeeping.
+ */
+export function createSelectionActionToolbarController() {
+    return {
+        showTimer: undefined,
+        isPointerSelecting: false,
+        isToolbarOpen: false,
+        pendingState: null,
+        lastNonEmptySelection: null,
+        suppressCollapseDismiss: false
+    };
+}
+/**
+ * Applies a view update to the selection toolbar controller.
+ *
+ * Encodes the RTL-gutter fix: collapsed selections during a pointer drag (or
+ * immediately after pointerup) do not dismiss a previously captured selection.
+ *
+ * @param controller - Shared toolbar controller.
+ * @param update - CodeMirror view update.
+ * @param options - Enable/open callbacks and notify/dismiss helpers.
+ * @returns Whether the toolbar should remain open after this update (for tests).
+ */
+export function applySelectionActionToolbarUpdate(controller, update, options) {
+    if (!options.isEnabled()) {
+        options.dismissToolbar();
+        return;
+    }
+    if (!update.selectionSet && !update.docChanged && !update.viewportChanged) {
+        return;
+    }
+    const { from, to } = update.state.selection.main;
+    if (from === to) {
+        // During drag or immediately after pointer finalize, CodeMirror may collapse
+        // into the gutter; keep the last non-empty selection for finalize.
+        if (controller.isPointerSelecting || controller.suppressCollapseDismiss) {
+            return;
+        }
+        options.dismissToolbar();
+        return;
+    }
+    const nextState = buildSelectionActionToolbarState(update.view);
+    if (!nextState) {
+        if (controller.isPointerSelecting || controller.suppressCollapseDismiss) {
+            return;
+        }
+        options.dismissToolbar();
+        return;
+    }
+    if (controller.isPointerSelecting) {
+        controller.lastNonEmptySelection = nextState;
+    }
+    if (options.isOpen() && !update.selectionSet && update.viewportChanged) {
+        options.showImmediately(nextState);
+        return;
+    }
+    if (options.isOpen() && update.selectionSet) {
+        options.scheduleShow(nextState);
+        return;
+    }
+    options.scheduleShow(nextState);
+}
+/**
+ * Finalizes the toolbar after a primary-button pointer drag ends.
+ *
+ * Prefers the live selection; falls back to {@link SelectionActionToolbarController.lastNonEmptySelection}
+ * so RTL releases into the gutter still reveal Copy to chat.
+ *
+ * @param controller - Shared toolbar controller.
+ * @param view - CodeMirror editor view at pointerup.
+ * @param options - Open check and show helpers.
+ */
+export function finalizeSelectionActionToolbarOnPointerUp(controller, view, options) {
+    if (!controller.isPointerSelecting) {
+        return;
+    }
+    controller.isPointerSelecting = false;
+    const liveSnapshot = buildSelectionActionToolbarState(view);
+    const snapshot = liveSnapshot ?? controller.lastNonEmptySelection;
+    controller.lastNonEmptySelection = null;
+    if (snapshot) {
+        controller.suppressCollapseDismiss = true;
+        options.showImmediately(snapshot);
+        return;
+    }
+    if (controller.pendingState != null && !options.isOpen()) {
+        options.scheduleShow(controller.pendingState);
+    }
+}
+/**
+ * Builds update and pointer handlers that debounce toolbar display until selection settles.
+ *
+ * @param onToolbarChange - React setter for toolbar visibility and position.
+ * @param isEnabled - Whether selection actions are currently configured.
+ * @param isOpen - Whether the toolbar is currently visible in React state.
+ * @param onDismiss - Extra host cleanup when Escape dismisses the toolbar.
+ * @returns CodeMirror extensions that drive the floating selection toolbar.
+ */
+export function createSelectionActionToolbarExtensions(onToolbarChange, isEnabled, isOpen, onDismiss) {
+    const controller = createSelectionActionToolbarController();
+    let activeView = null;
+    /**
+     * Clears a scheduled toolbar reveal without changing open state.
+     */
+    const clearShowTimer = () => {
+        if (controller.showTimer) {
+            clearTimeout(controller.showTimer);
+            controller.showTimer = undefined;
+        }
+    };
+    /**
+     * Notifies React of toolbar visibility while keeping controller state in sync.
+     *
+     * @param state - Next toolbar snapshot, or null to hide.
+     */
+    const notifyToolbarChange = (state) => {
+        controller.isToolbarOpen = state != null;
+        if (state == null) {
+            controller.pendingState = null;
+        }
+        onToolbarChange(state);
+    };
+    /**
+     * Hides the toolbar immediately and cancels any pending reveal.
+     *
+     * Does not clear {@link SelectionActionToolbarController.lastNonEmptySelection}
+     * so a later pointerup can still recover an RTL gutter collapse.
+     */
+    const dismissToolbar = () => {
+        clearShowTimer();
+        if (controller.isToolbarOpen || controller.pendingState != null) {
+            notifyToolbarChange(null);
+        }
+    };
+    /**
+     * Schedules toolbar display after the configured settle delay.
+     *
+     * @param state - Snapshot to show once the settle timer fires.
+     */
+    const scheduleShow = (state) => {
+        controller.pendingState = state;
+        clearShowTimer();
+        if (controller.isPointerSelecting) {
+            return;
+        }
+        controller.showTimer = setTimeout(() => {
+            controller.showTimer = undefined;
+            if (controller.isPointerSelecting) {
+                return;
+            }
+            notifyToolbarChange(state);
+        }, SELECTION_TOOLBAR_SHOW_DELAY_MS);
+    };
+    /**
+     * Repositions or reveals the toolbar without waiting when it is already open
+     * or when pointerup finalizes a drag selection.
+     *
+     * @param state - Snapshot to show immediately.
+     */
+    const showImmediately = (state) => {
+        clearShowTimer();
+        controller.pendingState = state;
+        notifyToolbarChange(state);
+    };
+    /**
+     * Finalizes an in-progress pointer drag using the last known editor view.
+     */
+    const finalizePointerSelection = () => {
+        if (activeView == null) {
+            return;
+        }
+        finalizeSelectionActionToolbarOnPointerUp(controller, activeView, {
+            isOpen,
+            scheduleShow,
+            showImmediately
+        });
+    };
+    if (typeof window !== 'undefined') {
+        /**
+         * Finalizes drag-select when pointerup lands in the gutter, which bypasses
+         * CodeMirror domEventHandlers.
+         */
+        const handleWindowPointerUp = () => {
+            if (!controller.isPointerSelecting) {
+                return;
+            }
+            finalizePointerSelection();
+        };
+        window.addEventListener('pointerup', handleWindowPointerUp, true);
+    }
+    const updateListener = EditorView.updateListener.of((update) => {
+        applySelectionActionToolbarUpdate(controller, {
+            selectionSet: update.selectionSet,
+            docChanged: update.docChanged,
+            viewportChanged: update.viewportChanged,
+            view: update.view,
+            state: update.state
+        }, {
+            isEnabled,
+            isOpen,
+            notifyToolbarChange,
+            clearShowTimer,
+            scheduleShow,
+            showImmediately,
+            dismissToolbar
+        });
+    });
+    const pointerGuard = EditorView.domEventHandlers({
+        /**
+         * Suppresses toolbar reveal while the user is drag-selecting with the primary button.
+         *
+         * @param event - Native pointerdown on the editor.
+         */
+        pointerdown(event, view) {
+            if (event.button === 0) {
+                activeView = view;
+                controller.suppressCollapseDismiss = false;
+                controller.isPointerSelecting = true;
+                controller.lastNonEmptySelection = null;
+                clearShowTimer();
+            }
+            return false;
+        },
+        /**
+         * Finalizes the toolbar after drag-select completes, recovering gutter collapses.
+         *
+         * @param _event - Native pointerup on the editor.
+         * @param view - CodeMirror view at release time.
+         */
+        pointerup(_event, view) {
+            activeView = view;
+            finalizePointerSelection();
+            return false;
+        }
+    });
+    const dismissHandler = EditorView.domEventHandlers({
+        /**
+         * Dismisses the open toolbar when Escape is pressed.
+         *
+         * @param event - Native keydown on the editor.
+         */
+        keydown(event) {
+            if (event.key === 'Escape' && isOpen()) {
+                event.preventDefault();
+                dismissToolbar();
+                onDismiss();
+                return true;
+            }
+            return false;
+        }
+    });
+    const cleanupPlugin = ViewPlugin.fromClass(class {
+        /**
+         * Clears any pending toolbar reveal when the editor extension is destroyed.
+         */
+        destroy() {
+            clearShowTimer();
+        }
+    });
+    return [updateListener, pointerGuard, dismissHandler, cleanupPlugin];
+}

package/dist/components/CopyToChatButton/constants.d.ts

@@ -0,0 +1,18 @@
+import type { IconDefinition } from '@fortawesome/fontawesome-svg-core';
+/** Visible button and menu label for Copy to chat. */
+export declare const COPY_TO_CHAT_LABEL = "Copy to chat";
+/** Display text for the copy-to-chat keyboard shortcut shown next to the label. */
+export declare const COPY_TO_CHAT_SHORTCUT_HINT = "Ctrl+Shift+O";
+/** CodeMirror keymap binding for the copy-to-chat selection action. */
+export declare const COPY_TO_CHAT_SHORTCUT_CODEMIRROR_KEY = "Ctrl-Shift-o";
+/** Lowercase letter key used by custom key handlers for copy-to-chat. */
+export declare const COPY_TO_CHAT_SHORTCUT_LETTER = "o";
+/** Icon shown on Copy to chat buttons. */
+export declare const COPY_TO_CHAT_ICON: IconDefinition;
+/**
+ * Builds the lint-tooltip / diagnostic action name that includes the shortcut hint.
+ *
+ * @returns Label such as `Copy to chat (Ctrl+Shift+O)`.
+ */
+export declare function copyToChatActionLabel(): string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/components/CopyToChatButton/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/components/CopyToChatButton/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGxE,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD,mFAAmF;AACnF,eAAO,MAAM,0BAA0B,iBAAiB,CAAC;AAEzD,uEAAuE;AACvE,eAAO,MAAM,oCAAoC,iBAAiB,CAAC;AAEnE,yEAAyE;AACzE,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,EAAE,cAAoC,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/components/CopyToChatButton/constants.js

@@ -0,0 +1,19 @@
+import { faWandMagicSparkles } from '@fortawesome/free-solid-svg-icons';
+/** Visible button and menu label for Copy to chat. */
+export const COPY_TO_CHAT_LABEL = 'Copy to chat';
+/** Display text for the copy-to-chat keyboard shortcut shown next to the label. */
+export const COPY_TO_CHAT_SHORTCUT_HINT = 'Ctrl+Shift+O';
+/** CodeMirror keymap binding for the copy-to-chat selection action. */
+export const COPY_TO_CHAT_SHORTCUT_CODEMIRROR_KEY = 'Ctrl-Shift-o';
+/** Lowercase letter key used by custom key handlers for copy-to-chat. */
+export const COPY_TO_CHAT_SHORTCUT_LETTER = 'o';
+/** Icon shown on Copy to chat buttons. */
+export const COPY_TO_CHAT_ICON = faWandMagicSparkles;
+/**
+ * Builds the lint-tooltip / diagnostic action name that includes the shortcut hint.
+ *
+ * @returns Label such as `Copy to chat (Ctrl+Shift+O)`.
+ */
+export function copyToChatActionLabel() {
+    return `${COPY_TO_CHAT_LABEL} (${COPY_TO_CHAT_SHORTCUT_HINT})`;
+}

package/dist/components/CopyToChatButton/index.d.ts

@@ -0,0 +1,49 @@
+import type { JSX, MouseEventHandler } from 'react';
+export { COPY_TO_CHAT_ICON, COPY_TO_CHAT_LABEL, COPY_TO_CHAT_SHORTCUT_CODEMIRROR_KEY, COPY_TO_CHAT_SHORTCUT_HINT, COPY_TO_CHAT_SHORTCUT_LETTER, copyToChatActionLabel } from './constants.js';
+export interface Props {
+    /**
+     * Invoked when the user activates the Copy to chat control.
+     */
+    onSelect: () => void;
+    /**
+     * Accessible name announced for the action button.
+     */
+    'aria-label': string;
+    /**
+     * Visual presentation of the control.
+     *
+     * - `labeled` — breadcrumb-style icon cap plus label and shortcut hint (default).
+     * - `icon` — icon-only button matching shared icon controls.
+     */
+    appearance?: 'labeled' | 'icon';
+    /**
+     * When set, portals a fixed-position floating button at these viewport coordinates
+     * so overflow-hidden editor or terminal containers cannot clip it.
+     */
+    coords?: {
+        top: number;
+        left: number;
+    };
+    /**
+     * Additional classes merged onto the button (layout tweaks only).
+     */
+    className?: string;
+    /**
+     * Optional native click handler for hosts that need stopPropagation.
+     * Defaults to calling {@link onSelect} only.
+     */
+    onClick?: MouseEventHandler<HTMLButtonElement>;
+    /**
+     * Optional native title attribute (icon appearance often pairs this with aria-label).
+     */
+    title?: string;
+}
+/**
+ * Shared Copy to chat control used for selection toolbars, floating overlays, and
+ * icon-only row/header actions so label, icon, shortcut, and styles stay in one place.
+ *
+ * The labeled appearance uses interlocking breadcrumb segments: a blue wand icon
+ * cap on the left and a dark label/shortcut segment on the right.
+ */
+export declare function CopyToChatButton({ onSelect, 'aria-label': ariaLabel, appearance, coords, className, onClick, title }: Props): JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/components/CopyToChatButton/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/CopyToChatButton/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAc,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAQhE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oCAAoC,EACpC,0BAA0B,EAC1B,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAMxB,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,QAAQ,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAEhC;;;OAGG;IACH,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAEvC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IAE/C;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,YAAY,EAAE,SAAS,EACvB,UAAsB,EACtB,MAAM,EACN,SAAS,EACT,OAAO,EACP,KAAK,EACN,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAuErB"}

package/dist/components/CopyToChatButton/index.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@harborclient/sdk/jsx-runtime";
+import { SegmentShell } from '../Breadcrumb/SegmentShell.js';
+import { Button } from '../Button/index.js';
+import { FaIcon } from '../FaIcon/index.js';
+import { portalToBody } from '../portalToBody.js';
+import { cn } from '../utils.js';
+import { COPY_TO_CHAT_ICON, COPY_TO_CHAT_LABEL, COPY_TO_CHAT_SHORTCUT_HINT } from './constants.js';
+export { COPY_TO_CHAT_ICON, COPY_TO_CHAT_LABEL, COPY_TO_CHAT_SHORTCUT_CODEMIRROR_KEY, COPY_TO_CHAT_SHORTCUT_HINT, COPY_TO_CHAT_SHORTCUT_LETTER, copyToChatActionLabel } from './constants.js';
+/** Shared chrome for the labeled breadcrumb-style Copy to chat control. */
+const LABELED_BUTTON_CLASS = 'hc-copy-to-chat-button hc-code-editor-selection-action app-no-drag inline-flex cursor-pointer items-stretch overflow-hidden rounded-lg border-none bg-breadcrumb-background p-0 text-[14px] text-text shadow-sm hover:brightness-110 focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-accent';
+/**
+ * Shared Copy to chat control used for selection toolbars, floating overlays, and
+ * icon-only row/header actions so label, icon, shortcut, and styles stay in one place.
+ *
+ * The labeled appearance uses interlocking breadcrumb segments: a blue wand icon
+ * cap on the left and a dark label/shortcut segment on the right.
+ */
+export function CopyToChatButton({ onSelect, 'aria-label': ariaLabel, appearance = 'labeled', coords, className, onClick, title }) {
+    /**
+     * Runs optional host click side effects (for example stopPropagation), then
+     * invokes {@link onSelect}.
+     *
+     * @param event - Native click from the button.
+     */
+    const handleClick = (event) => {
+        onClick?.(event);
+        onSelect();
+    };
+    if (appearance === 'icon') {
+        const iconButton = (_jsx(Button, { type: "button", variant: "icon", "aria-label": ariaLabel, title: title, className: cn('hc-copy-to-chat-button', className), onClick: handleClick, children: _jsx(FaIcon, { icon: COPY_TO_CHAT_ICON, className: "h-3.5 w-3.5", "aria-hidden": true }) }));
+        if (coords == null) {
+            return iconButton;
+        }
+        return portalToBody(_jsx("div", { className: "pointer-events-auto fixed z-[70]", style: { top: coords.top, left: coords.left }, children: iconButton }));
+    }
+    const labeledButton = (_jsxs("button", { type: "button", className: cn(LABELED_BUTTON_CLASS, coords != null && 'pointer-events-auto fixed z-[70]', className), style: coords != null ? { top: coords.top, left: coords.left } : undefined, "aria-label": ariaLabel, title: title, onMouseDown: (event) => {
+            event.preventDefault();
+        }, onClick: handleClick, children: [_jsx(SegmentShell, { shape: "first", tone: "selection", density: "compact", className: "shrink-0", children: _jsx(FaIcon, { icon: COPY_TO_CHAT_ICON, className: "h-3.5 w-3.5 shrink-0", "aria-hidden": true }) }), _jsxs(SegmentShell, { shape: "last", tone: "current", density: "compact", className: "shrink-0", children: [_jsx("span", { children: COPY_TO_CHAT_LABEL }), _jsx("span", { className: "text-[14px] text-muted", children: COPY_TO_CHAT_SHORTCUT_HINT })] })] }));
+    if (coords == null) {
+        return labeledButton;
+    }
+    return portalToBody(labeledButton);
+}

package/dist/components/FloatingDialog/floatingDialogPosition.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Minimum gap between a floating dialog and the viewport edge.
+ */
+export declare const FLOATING_DIALOG_VIEWPORT_MARGIN_PX = 8;
+/**
+ * Default corner left offset used when a dialog must be relocated on-screen.
+ */
+export declare const FLOATING_DIALOG_DEFAULT_LEFT = 96;
+/**
+ * Default corner top offset used when a dialog must be relocated on-screen.
+ */
+export declare const FLOATING_DIALOG_DEFAULT_TOP = 96;
+/**
+ * Top-left coordinates for a fixed floating dialog.
+ */
+export interface FloatingDialogPosition {
+    /**
+     * CSS `left` in viewport pixels.
+     */
+    left: number;
+    /**
+     * CSS `top` in viewport pixels.
+     */
+    top: number;
+}
+/**
+ * Measured floating dialog dimensions.
+ */
+export interface FloatingDialogSize {
+    /**
+     * Panel width in pixels.
+     */
+    width: number;
+    /**
+     * Panel height in pixels.
+     */
+    height: number;
+}
+/**
+ * Returns whether a floating dialog at `position` with `size` fits fully inside
+ * the viewport, respecting the viewport margin.
+ *
+ * @param position - Proposed top-left coordinates.
+ * @param size - Measured panel width and height.
+ * @param viewport - Optional viewport size (defaults to `window` when available).
+ * @returns True when the panel is fully visible inside the margin.
+ */
+export declare function isFloatingDialogFullyOnScreen(position: FloatingDialogPosition, size: FloatingDialogSize, viewport?: {
+    width: number;
+    height: number;
+}): boolean;
+//# sourceMappingURL=floatingDialogPosition.d.ts.map

package/dist/components/FloatingDialog/floatingDialogPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floatingDialogPosition.d.ts","sourceRoot":"","sources":["../../../src/components/FloatingDialog/floatingDialogPosition.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,sBAAsB,EAChC,IAAI,EAAE,kBAAkB,EACxB,QAAQ,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3C,OAAO,CAgBT"}

package/dist/components/FloatingDialog/floatingDialogPosition.js

@@ -0,0 +1,33 @@
+/**
+ * Minimum gap between a floating dialog and the viewport edge.
+ */
+export const FLOATING_DIALOG_VIEWPORT_MARGIN_PX = 8;
+/**
+ * Default corner left offset used when a dialog must be relocated on-screen.
+ */
+export const FLOATING_DIALOG_DEFAULT_LEFT = 96;
+/**
+ * Default corner top offset used when a dialog must be relocated on-screen.
+ */
+export const FLOATING_DIALOG_DEFAULT_TOP = 96;
+/**
+ * Returns whether a floating dialog at `position` with `size` fits fully inside
+ * the viewport, respecting the viewport margin.
+ *
+ * @param position - Proposed top-left coordinates.
+ * @param size - Measured panel width and height.
+ * @param viewport - Optional viewport size (defaults to `window` when available).
+ * @returns True when the panel is fully visible inside the margin.
+ */
+export function isFloatingDialogFullyOnScreen(position, size, viewport) {
+    const margin = FLOATING_DIALOG_VIEWPORT_MARGIN_PX;
+    const viewportWidth = viewport?.width ?? (typeof window !== 'undefined' ? window.innerWidth : 0);
+    const viewportHeight = viewport?.height ?? (typeof window !== 'undefined' ? window.innerHeight : 0);
+    if (size.width <= 0 || size.height <= 0 || viewportWidth <= 0 || viewportHeight <= 0) {
+        return true;
+    }
+    return (position.left >= margin &&
+        position.top >= margin &&
+        position.left + size.width <= viewportWidth - margin &&
+        position.top + size.height <= viewportHeight - margin);
+}

package/dist/components/FloatingDialog/index.d.ts

@@ -0,0 +1,95 @@
+import type { JSX, ReactNode } from 'react';
+import { type FloatingDialogPosition, type FloatingDialogSize } from './floatingDialogPosition.js';
+interface Props {
+    /**
+     * Accessible name for the dialog when no labelled heading id is provided.
+     */
+    label: string;
+    /**
+     * Optional id of a visible heading that labels the dialog.
+     */
+    labelledBy?: string;
+    /**
+     * Called when Escape is pressed (parent decides discard / close).
+     */
+    onClose: () => void;
+    /**
+     * When true, Escape does not call `onClose`.
+     */
+    disableEscape?: boolean;
+    /**
+     * Optional width/position classes for the floating panel.
+     */
+    className?: string;
+    /**
+     * Optional classes for the scrollable body region.
+     */
+    bodyClassName?: string;
+    /**
+     * Initial CSS `left` in pixels.
+     */
+    initialLeft?: number;
+    /**
+     * Initial CSS `top` in pixels.
+     */
+    initialTop?: number;
+    /**
+     * Called when the panel position changes after a drag ends or a corner reset.
+     *
+     * @param position - Final top-left coordinates in viewport pixels.
+     */
+    onPositionChange?: (position: FloatingDialogPosition) => void;
+    /**
+     * When set with {@link initialHeight}, enables SE resize with explicit pixel size.
+     */
+    initialWidth?: number;
+    /**
+     * When set with {@link initialWidth}, enables SE resize with explicit pixel size.
+     */
+    initialHeight?: number;
+    /**
+     * Minimum panel width while resizing (defaults to 240).
+     */
+    minWidth?: number;
+    /**
+     * Minimum panel height while resizing (defaults to 120).
+     */
+    minHeight?: number;
+    /**
+     * Maximum panel width while resizing (defaults to viewport minus margins).
+     */
+    maxWidth?: number;
+    /**
+     * Maximum panel height while resizing (defaults to viewport minus margins).
+     */
+    maxHeight?: number;
+    /**
+     * Called when a resize gesture ends (or keyboard resize applies).
+     *
+     * @param size - Final width and height in viewport pixels.
+     */
+    onSizeChange?: (size: FloatingDialogSize) => void;
+    /**
+     * Header content used as the drag handle.
+     */
+    dragHandle: ReactNode;
+    /**
+     * Dialog body content.
+     */
+    children: ReactNode;
+}
+/**
+ * Non-blocking, draggable dialog panel with no modal mask.
+ *
+ * Clicks pass through to the UI behind the panel. Drag by the handle region.
+ * When `initialWidth` and `initialHeight` are provided, a southeast resize
+ * handle appears (pointer + arrow-key accessible). Parents persist geometry via
+ * `onPositionChange` / `onSizeChange`. If the panel would open or remain
+ * off-screen after a window resize, it relocates to the default corner.
+ *
+ * @param props - Dialog labelling, geometry, and content props.
+ * @returns Floating dialog element.
+ */
+export declare function FloatingDialog({ label, labelledBy, onClose, disableEscape, className, bodyClassName, initialLeft, initialTop, onPositionChange, initialWidth, initialHeight, minWidth, minHeight, maxWidth, maxHeight, onSizeChange, dragHandle, children }: Props): JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/components/FloatingDialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/FloatingDialog/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAqD,SAAS,EAAE,MAAM,OAAO,CAAC;AAE/F,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EAExB,MAAM,6BAA6B,CAAC;AAErC,UAAU,KAAK;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAE9D;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAElD;;OAEG;IACH,UAAU,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAuCD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,UAAU,EACV,OAAO,EACP,aAAqB,EACrB,SAAS,EACT,aAAa,EACb,WAA0C,EAC1C,UAAwC,EACxC,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,QAAc,EACd,SAAe,EACf,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,QAAQ,EACT,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CA+VrB"}