@deck.gl-community/widgets 9.2.8 → 9.3.0-beta.2

package/dist/widget-panels/keyboard-shortcuts-widget.js

@@ -0,0 +1,301 @@
+var _a;
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "preact/jsx-runtime";
+/** @jsxImportSource preact */
+import { Widget } from '@deck.gl/core';
+import { render } from 'preact';
+import { DEFAULT_SHORTCUTS, formatKey } from "../keyboard-shortcuts/keyboard-shortcuts.js";
+import { KeyboardShortcutsManager } from "../keyboard-shortcuts/keyboard-shortcuts-manager.js";
+/**
+ * A panel definition representing keyboard shortcut details for a modal/tab container.
+ */
+export class KeyboardShortcutsPanel {
+    id = 'keyboard-shortcuts';
+    title = 'Keyboard Shortcuts';
+    theme;
+    content;
+    constructor({ keyboardShortcuts = [], theme = 'inherit' } = {}) {
+        this.theme = theme;
+        this.content = _jsx(KeyboardSettingsPanelContent, { keyboardShortcuts: keyboardShortcuts });
+    }
+}
+export class KeyboardShortcutsWidget extends Widget {
+    static defaultProps = {
+        ...Widget.defaultProps,
+        id: 'keyboard-bindings',
+        placement: 'top-left',
+        keyboardShortcuts: []
+    };
+    className = 'deck-widget-keyboard-bindings';
+    placement = _a.defaultProps.placement;
+    #isOpen = false;
+    #rootElement = null;
+    #keyboardShortcuts = _a.defaultProps.keyboardShortcuts;
+    #keyboardShortcutsManager = null;
+    constructor(props) {
+        super({ ..._a.defaultProps, ...props });
+        this.#keyboardShortcuts = props.keyboardShortcuts;
+        if (props.placement !== undefined) {
+            this.placement = props.placement;
+        }
+    }
+    setProps(props) {
+        if (props.keyboardShortcuts !== undefined) {
+            this.#keyboardShortcuts = props.keyboardShortcuts;
+            this.#restartKeyboardShortcutsManager();
+            this.#renderRootElement();
+        }
+        if (props.installShortcuts !== undefined) {
+            this.#restartKeyboardShortcutsManager();
+        }
+        if (props.placement !== undefined) {
+            this.placement = props.placement;
+        }
+        super.setProps(props);
+    }
+    onAdd() {
+        this.#restartKeyboardShortcutsManager();
+    }
+    onRenderHTML(rootElement) {
+        this.#rootElement = rootElement;
+        const className = ['deck-widget', this.className, this.props.className]
+            .filter(Boolean)
+            .join(' ');
+        rootElement.className = className;
+        this.#renderRootElement();
+    }
+    onRemove() {
+        if (this.#rootElement) {
+            render(null, this.#rootElement);
+        }
+        if (this.#keyboardShortcutsManager) {
+            this.#keyboardShortcutsManager.stop();
+            this.#keyboardShortcutsManager = null;
+        }
+    }
+    #restartKeyboardShortcutsManager() {
+        if (this.#keyboardShortcutsManager) {
+            this.#keyboardShortcutsManager.stop();
+            this.#keyboardShortcutsManager = null;
+        }
+        // @ts-expect-error Accessing protected member 'eventManager'.
+        const eventManager = this.deck?.eventManager;
+        if (eventManager && this.props.installShortcuts) {
+            this.#keyboardShortcutsManager = new KeyboardShortcutsManager(eventManager, this.#getEffectiveKeyboardShortcuts());
+            this.#keyboardShortcutsManager.start();
+        }
+    }
+    #renderRootElement() {
+        if (!this.#rootElement) {
+            return;
+        }
+        render(_jsx(KeyboardShortcutsWidgetView, { isOpen: this.#isOpen, keyboardShortcuts: this.#getEffectiveKeyboardShortcuts(), onClose: this.#handleClose, onOpen: this.#handleOpen }), this.#rootElement);
+    }
+    #getEffectiveKeyboardShortcuts() {
+        return [
+            ...DEFAULT_SHORTCUTS.map((shortcut) => ({
+                ...shortcut,
+                onKeyPress: this.#handleOpen
+            })),
+            ...this.#keyboardShortcuts
+        ];
+    }
+    #handleOpen = () => {
+        if (this.#isOpen) {
+            return;
+        }
+        this.#isOpen = true;
+        this.#renderRootElement();
+    };
+    #handleClose = () => {
+        if (!this.#isOpen) {
+            return;
+        }
+        this.#isOpen = false;
+        this.#renderRootElement();
+    };
+}
+_a = KeyboardShortcutsWidget;
+const MODAL_BACKDROP_STYLE = {
+    position: 'fixed',
+    inset: 0,
+    display: 'flex',
+    alignItems: 'center',
+    justifyContent: 'center',
+    backgroundColor: 'rgba(15, 23, 42, 0.28)',
+    pointerEvents: 'auto',
+    zIndex: 1000
+};
+const MODAL_STYLE = {
+    width: 'min(640px, calc(100vw - 24px))',
+    maxHeight: 'min(520px, calc(100vh - 24px))',
+    borderRadius: '14px',
+    border: '1px solid rgba(148, 163, 184, 0.75)',
+    backgroundColor: 'rgba(255, 255, 255, 0.98)',
+    boxShadow: '0 14px 40px rgba(15, 23, 42, 0.28)',
+    display: 'flex',
+    flexDirection: 'column',
+    overflow: 'hidden'
+};
+const KEY_STYLE = {
+    borderRadius: '6px',
+    border: '1px solid rgba(148, 163, 184, 0.85)',
+    backgroundColor: 'rgba(248, 250, 252, 1)',
+    padding: '2px 8px',
+    fontSize: '11px',
+    color: 'var(--button-text, #0f172a)',
+    whiteSpace: 'nowrap'
+};
+const ICON_COLOR = 'var(--button-icon-idle, var(--button-text, currentColor))';
+const SHORTCUT_BADGE_STYLE = {
+    display: 'inline-flex',
+    alignItems: 'center',
+    borderRadius: '999px',
+    border: '1px solid rgba(148, 163, 184, 0.75)',
+    backgroundColor: 'rgba(248, 250, 252, 1)',
+    padding: '1px 6px',
+    fontSize: '10px',
+    lineHeight: '12px',
+    color: 'rgb(71, 85, 105)',
+    whiteSpace: 'nowrap'
+};
+const SHORTCUT_ROW_STYLE = {
+    display: 'grid',
+    gridTemplateColumns: 'minmax(104px, 148px) minmax(0, 1fr) auto',
+    gap: '10px 14px',
+    alignItems: 'start',
+    padding: '10px 0',
+    borderBottom: '1px solid rgba(226, 232, 240, 0.8)'
+};
+const SHORTCUT_KEYS_STYLE = {
+    display: 'flex',
+    alignItems: 'flex-start',
+    flexWrap: 'wrap',
+    gap: '10px',
+    minWidth: 0
+};
+const SHORTCUT_DESCRIPTION_STYLE = {
+    fontSize: '13px',
+    lineHeight: '18px',
+    fontWeight: 500,
+    color: 'rgb(71, 85, 105)',
+    textAlign: 'left',
+    minWidth: 0,
+    width: '100%'
+};
+const SHORTCUT_BADGES_STYLE = {
+    display: 'flex',
+    alignItems: 'flex-start',
+    gap: '6px',
+    flexWrap: 'wrap',
+    justifySelf: 'end'
+};
+const SHORTCUT_CHORD_STYLE = {
+    display: 'inline-flex',
+    alignItems: 'center',
+    gap: '2px',
+    color: 'rgb(51, 65, 85)',
+    fontSize: '11px',
+    whiteSpace: 'nowrap'
+};
+function KeyboardShortcutsWidgetView({ isOpen, keyboardShortcuts, onClose, onOpen }) {
+    return (_jsxs(_Fragment, { children: [_jsx("div", { className: "deck-widget-button", children: _jsx("button", { className: "deck-widget-icon-button", style: { color: 'var(--button-text, currentColor)' }, type: "button", title: "Keyboard shortcuts", "aria-label": "Keyboard shortcuts", onClick: onOpen, children: _jsx("span", { style: {
+                            fontSize: '12px',
+                            fontWeight: 700,
+                            color: ICON_COLOR
+                        }, children: _jsx("kbd", { style: {
+                                color: ICON_COLOR
+                            }, children: "?" }) }) }) }), isOpen && (_jsx("div", { style: MODAL_BACKDROP_STYLE, onClick: onClose, children: _jsxs("div", { style: MODAL_STYLE, role: "dialog", "aria-label": "Keyboard Shortcuts", onClick: (event) => event.stopPropagation(), children: [_jsxs("div", { style: {
+                                display: 'flex',
+                                alignItems: 'center',
+                                justifyContent: 'space-between',
+                                borderBottom: '1px solid rgba(226, 232, 240, 1)',
+                                padding: '10px 12px'
+                            }, children: [_jsx("div", { style: { fontSize: '14px', fontWeight: 700, color: 'rgb(30, 41, 59)' }, children: "Keyboard Shortcuts" }), _jsx("button", { type: "button", onClick: onClose, style: {
+                                        border: 0,
+                                        background: 'transparent',
+                                        color: 'rgb(71, 85, 105)',
+                                        cursor: 'pointer',
+                                        fontSize: '18px',
+                                        lineHeight: '18px'
+                                    }, "aria-label": "Close keyboard shortcuts", title: "Close", children: "\u00D7" })] }), _jsx(KeyboardSettingsPanelContent, { keyboardShortcuts: keyboardShortcuts })] }) }))] }));
+}
+function KeyboardSettingsPanelContent({ keyboardShortcuts }) {
+    const shortcutRows = buildKeyboardShortcutRows(keyboardShortcuts);
+    return (_jsx("div", { style: { overflowY: 'auto', padding: '10px 12px', flex: 1, minHeight: 0 }, children: _jsx("div", { style: { display: 'flex', flexDirection: 'column' }, children: shortcutRows.map((row) => (_jsxs("div", { style: SHORTCUT_ROW_STYLE, children: [_jsx("div", { "data-shortcut-row-kind": row.shortcuts.length === 2 ? 'pair' : 'single', style: SHORTCUT_KEYS_STYLE, children: row.shortcuts.map((shortcut, index) => (_jsx("div", { style: { display: 'inline-flex', alignItems: 'center' }, children: _jsx("div", { "data-shortcut-key-group": "true", children: _jsx(ShortcutKey, { shortcut: shortcut }) }, `${row.key}-${index}`) }, `${row.key}-${index}`))) }), _jsx("span", { "data-shortcut-description": "true", style: SHORTCUT_DESCRIPTION_STYLE, children: row.description }), row.badges.length > 0 ? (_jsx("span", { "data-shortcut-badges": "true", style: SHORTCUT_BADGES_STYLE, children: row.badges.map((badge) => (_jsx("span", { style: SHORTCUT_BADGE_STYLE, children: badge }, `${row.key}-${badge}`))) })) : null] }, row.key))) }) }));
+}
+function ShortcutKey({ shortcut }) {
+    const parts = [];
+    if (shortcut.commandKey) {
+        parts.push(_jsx("kbd", { style: KEY_STYLE, children: "\u2318" }, "command"));
+    }
+    if (shortcut.ctrlKey) {
+        parts.push(_jsx("kbd", { style: KEY_STYLE, children: "^" }, "ctrl"));
+    }
+    if (shortcut.shiftKey) {
+        parts.push(_jsx("kbd", { style: KEY_STYLE, children: "Shift" }, "shift"));
+    }
+    if (shortcut.key) {
+        parts.push(_jsx("kbd", { style: KEY_STYLE, children: formatKey(shortcut.key) }, "key"));
+    }
+    if (shortcut.dragMouse) {
+        parts.push(_jsx("span", { style: { whiteSpace: 'nowrap' }, children: "drag mouse" }, "drag"));
+    }
+    return (_jsx("div", { style: SHORTCUT_CHORD_STYLE, children: parts.map((part, index) => (_jsx("span", { style: { display: 'inline-flex', alignItems: 'center' }, children: part }, `shortcut-part-${index}`))) }));
+}
+function buildKeyboardShortcutRows(shortcuts) {
+    const rows = [];
+    for (let index = 0; index < shortcuts.length; index += 1) {
+        const shortcut = shortcuts[index];
+        const nextShortcut = shortcuts[index + 1];
+        const shortcutDisplayPair = shortcut?.displayPair;
+        if (shortcut &&
+            shortcutDisplayPair &&
+            nextShortcut &&
+            canPairShortcuts(shortcut, nextShortcut)) {
+            rows.push({
+                badges: mergeShortcutBadges(shortcut, nextShortcut),
+                description: shortcutDisplayPair.description,
+                key: `${shortcutDisplayPair.id}-${index}`,
+                shortcuts: [shortcut, nextShortcut]
+            });
+            index += 1;
+        }
+        else if (shortcut) {
+            rows.push({
+                badges: [...(shortcut.badges ?? [])],
+                description: shortcut.description,
+                key: `${shortcut.name}-${shortcut.key}-${index}`,
+                shortcuts: [shortcut]
+            });
+        }
+    }
+    return rows;
+}
+function canPairShortcuts(shortcut, nextShortcut) {
+    if (!nextShortcut) {
+        return false;
+    }
+    const shortcutPair = shortcut.displayPair;
+    const nextShortcutPair = nextShortcut.displayPair;
+    if (!shortcutPair || !nextShortcutPair) {
+        return false;
+    }
+    return (shortcutPair.position === 'primary' &&
+        nextShortcutPair.position === 'secondary' &&
+        shortcutPair.id === nextShortcutPair.id &&
+        shortcutPair.description === nextShortcutPair.description);
+}
+function mergeShortcutBadges(...shortcuts) {
+    const seenBadges = new Set();
+    const mergedBadges = [];
+    for (const shortcut of shortcuts) {
+        for (const badge of shortcut.badges ?? []) {
+            if (!seenBadges.has(badge)) {
+                seenBadges.add(badge);
+                mergedBadges.push(badge);
+            }
+        }
+    }
+    return mergedBadges;
+}
+//# sourceMappingURL=keyboard-shortcuts-widget.js.map

package/dist/widget-panels/keyboard-shortcuts-widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-shortcuts-widget.js","sourceRoot":"","sources":["../../src/widget-panels/keyboard-shortcuts-widget.tsx"],"names":[],"mappings":"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"}

package/dist/widget-panels/modal-widget.d.ts

@@ -0,0 +1,62 @@
+/** @jsxImportSource preact */
+import { Widget } from '@deck.gl/core';
+import type { WidgetContainer, WidgetPanel } from "./widget-containers.js";
+import type { WidgetPlacement, WidgetProps } from '@deck.gl/core';
+/** Trigger and panel configuration for a modal-style widget. */
+export type ModalWidgetProps = WidgetProps & {
+    /** Trigger icon alias for legacy compatibility. */
+    icon?: string;
+    /** The content container to show when the modal is open. */
+    container?: WidgetContainer;
+    /** Optional shorthand panel. When supplied, shown directly in the modal body. */
+    panel?: WidgetPanel;
+    /** Button and panel placement anchor. */
+    placement?: WidgetPlacement;
+    /** Optional modal title shown in the header. */
+    title?: string;
+    /** Optional trigger button label visible in the UI. */
+    triggerLabel?: string;
+    /** Optional trigger icon. Defaults to a menu-like glyph. */
+    triggerIcon?: string;
+    /**
+     * Hides the trigger. Useful when trigger is implemented externally.
+     */
+    hideTrigger?: boolean;
+    /**
+     * Whether to render the built-in trigger button.
+     * If false, no built-in trigger is rendered.
+     */
+    button?: boolean;
+    /**
+     * Uncontrolled default open state.
+     */
+    defaultOpen?: boolean;
+    /**
+     * Controlled open state. If supplied, callers own open/closed state.
+     */
+    open?: boolean;
+    /**
+     * Called when user intent changes open/closed state.
+     */
+    onOpenChange?: (open: boolean) => void;
+};
+/**
+ * A reusable deck widget that renders a trigger + modal panel assembled from widget containers.
+ */
+export declare class ModalWidget extends Widget<ModalWidgetProps> {
+    #private;
+    static defaultProps: Required<ModalWidgetProps>;
+    className: string;
+    placement: WidgetPlacement;
+    triggerLabel: string;
+    triggerIcon: string;
+    hideTrigger: boolean;
+    title: string;
+    isOpen: boolean;
+    constructor(props?: Partial<ModalWidgetProps>);
+    setProps(props: Partial<ModalWidgetProps>): void;
+    onAdd(): void;
+    onRemove(): void;
+    onRenderHTML(rootElement: HTMLElement): void;
+}
+//# sourceMappingURL=modal-widget.d.ts.map

package/dist/widget-panels/modal-widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal-widget.d.ts","sourceRoot":"","sources":["../../src/widget-panels/modal-widget.tsx"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,OAAO,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AAMrC,OAAO,KAAK,EAAC,eAAe,EAAE,WAAW,EAAC,+BAA4B;AACtE,OAAO,KAAK,EAAC,eAAe,EAAE,WAAW,EAAC,MAAM,eAAe,CAAC;AAGhE,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAC3C,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,iFAAiF;IACjF,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC,CAAC;AA8HF;;GAEG;AACH,qBAAa,WAAY,SAAQ,MAAM,CAAC,gBAAgB,CAAC;;IACvD,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAwB7C;IAEF,SAAS,SAAsB;IAC/B,SAAS,EAAE,eAAe,CAAsC;IAChE,YAAY,EAAE,MAAM,CAAyC;IAC7D,WAAW,EAAE,MAAM,CAAwC;IAC3D,WAAW,UAAwC;IACnD,KAAK,SAAkC;IACvC,MAAM,UAAS;gBAUH,KAAK,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAUjD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAQhD,KAAK,IAAI,IAAI;IAIb,QAAQ,IAAI,IAAI;IAQhB,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;CAgJ7C"}