@aithe/aithe-ui 26.2.2 → 26.3.1

package/dist/components/framework/dashboard-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-panel.d.ts","sourceRoot":"","sources":["../../../src/components/framework/dashboard-panel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAG9D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAuBnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBACa,mBAAoB,SAAQ,YAAY;IACnD,uCAAuC;IACY,OAAO,SAAM;IAEhE,8CAA8C;IAClB,CAAC,SAAK;IAElC,2CAA2C;IACf,CAAC,SAAK;IAElC,sCAAsC;IACV,CAAC,SAAK;IAElC,mCAAmC;IACP,CAAC,SAAK;IAElC,gDAAgD;IACnB,QAAQ,UAAQ;IAE7C,uCAAuC;IACX,KAAK,SAAM;IAEvC,wCAAwC;IACZ,IAAI,SAAM;IAEtC,wDAAwD;IACZ,OAAO,UAAQ;IAE3D,2DAA2D;IACf,SAAS,UAAS;IAE9D,sFAAsF;IAC1C,MAAM,UAAS;IAE3D,uDAAuD;IACe,UAAU,UAAQ;IAE/E,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,QAAQ,CAAS;IAEV,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAc;IAEhE,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IAEzB,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyIpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAO5B;;;;OAIG;IACH,OAAO,CAAC,aAAa;IASrB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAgB9B;IAEF,sCAAsC;IACtC,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAW9B;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAW5B;IAEF,OAAO,CAAC,WAAW;IAKnB,0CAA0C;IAC1C,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAW/B;IAEF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAc9B;IAEF,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAE1B;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAE7B;IAEF,oFAAoF;IACpF,OAAO,CAAC,YAAY;IAyCpB,kFAAkF;IAClF,OAAO,CAAC,mBAAmB;IAWlB,MAAM,IAAI,cAAc;CASlC"}

package/dist/components/framework/dashboard-panel.js

@@ -0,0 +1,519 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * @file Dashboard Panel 子组件 / Dashboard Panel child component
+ * @description 仪表盘面板子组件，支持拖拽、调整大小、关闭、最大化，通过插槽分发内容。
+ *              Dashboard panel child component with drag, resize, close, maximize support
+ *              and slot-based content distribution.
+ */
+import { css, html, nothing } from 'lit';
+import { customElement, property, state, query } from 'lit/decorators.js';
+import { AitheElement } from '../../core/aithe-element';
+import { aitheBaseStyles } from '../../core/styles';
+const RESIZE_HANDLES = [
+    { edge: 'n', style: 'top:-3px;left:8px;right:8px;height:6px;cursor:ns-resize;' },
+    { edge: 's', style: 'bottom:-3px;left:8px;right:8px;height:6px;cursor:ns-resize;' },
+    { edge: 'e', style: 'right:-3px;top:8px;bottom:8px;width:6px;cursor:ew-resize;' },
+    { edge: 'w', style: 'left:-3px;top:8px;bottom:8px;width:6px;cursor:ew-resize;' },
+    { edge: 'ne', style: 'top:-3px;right:-3px;width:10px;height:10px;cursor:nesw-resize;' },
+    { edge: 'nw', style: 'top:-3px;left:-3px;width:10px;height:10px;cursor:nwse-resize;' },
+    { edge: 'se', style: 'bottom:-3px;right:-3px;width:10px;height:10px;cursor:nwse-resize;' },
+    { edge: 'sw', style: 'bottom:-3px;left:-3px;width:10px;height:10px;cursor:nesw-resize;' },
+];
+/**
+ * Dashboard panel child component. Renders as a card with header bar (icon + label),
+ * close/maximize buttons, resize handles, and a default slot for arbitrary content.
+ * The header has a flat style consistent with the body area.
+ *
+ * 仪表盘面板子组件。渲染为带标题栏（图标 + 标签）、关闭/最大化按钮、调整大小手柄和默认插槽的卡片。
+ * 标题栏采用与内容区一致的扁平样式。
+ *
+ * @slot - Panel body content. 面板正文内容。
+ * @slot header-actions - Slot for custom action buttons in the header (inserted before close/maximize buttons). 标题栏操作插槽，用于插入自定义按钮（位于关闭/最大化按钮之前）。
+ *
+ * @csspart header - The panel header bar. 面板标题栏。
+ * @csspart body - The panel body area. 面板正文区域。
+ * @csspart close-btn - The close button. 关闭按钮。
+ * @csspart maximize-btn - The maximize button. 最大化按钮。
+ *
+ * @fires aithe-panel-close - Emitted when the close button is clicked with `{ panelId }`. 关闭按钮点击时发出。
+ * @fires aithe-panel-drag-start - Emitted when drag starts with `{ panelId, startX, startY }`. 拖拽开始时发出。
+ * @fires aithe-panel-drag - Emitted during drag with `{ panelId, deltaX, deltaY }`. 拖拽过程中发出。
+ * @fires aithe-panel-drag-end - Emitted when drag ends with `{ panelId, deltaX, deltaY }`. 拖拽结束时发出。
+ * @fires aithe-panel-maximize - Emitted when maximize button is clicked with `{ panelId }`. 最大化按钮点击时发出。
+ * @fires aithe-panel-resize-start - Emitted when resize starts with `{ panelId, edge, startX, startY }`. 调整大小开始时发出。
+ * @fires aithe-panel-resize - Emitted during resize with `{ panelId, edge, deltaX, deltaY }`. 调整大小过程中发出。
+ * @fires aithe-panel-resize-end - Emitted when resize ends with `{ panelId, edge, deltaX, deltaY }`. 调整大小结束时发出。
+ *
+ * @example
+ * ```html
+ * <aithe-dashboard-panel
+ *   panel-id="stats"
+ *   x="0" y="0" w="6" h="4"
+ *   label="Statistics"
+ *   icon="barChart"
+ *   closable
+ * >
+ *   <p>Panel content here</p>
+ * </aithe-dashboard-panel>
+ * ```
+ */
+let AitheDashboardPanel = class AitheDashboardPanel extends AitheElement {
+    constructor() {
+        super(...arguments);
+        /** Panel unique identifier. 面板唯一标识。 */
+        this.panelId = '';
+        /** Starting column (0-based). 起始列（从 0 开始）。 */
+        this.x = 0;
+        /** Starting row (0-based). 起始行（从 0 开始）。 */
+        this.y = 0;
+        /** Number of columns spanned. 占列数。 */
+        this.w = 1;
+        /** Number of rows spanned. 占行数。 */
+        this.h = 1;
+        /** Whether the panel can be closed. 面板是否可关闭。 */
+        this.closable = true;
+        /** Panel header label text. 面板标题文本。 */
+        this.label = '';
+        /** Panel header icon name. 面板标题图标名称。 */
+        this.icon = '';
+        /** Whether the panel is currently visible. 面板当前是否可见。 */
+        this.visible = true;
+        /** Whether the panel is currently maximized. 面板当前是否最大化。 */
+        this.maximized = false;
+        /** Whether the dashboard is locked (disables drag and resize). 仪表盘是否锁定（禁用拖拽和调整大小）。 */
+        this.locked = false;
+        /** Whether to show the panel header bar. 是否显示面板标题栏。 */
+        this.showHeader = true;
+        this.dragging = false;
+        this.resizing = false;
+        this.dragStartX = 0;
+        this.dragStartY = 0;
+        this.dragOffsetX = 0;
+        this.dragOffsetY = 0;
+        this.resizeEdge = null;
+        this.resizeStartX = 0;
+        this.resizeStartY = 0;
+        this.resizeDeltaX = 0;
+        this.resizeDeltaY = 0;
+        this.handleMouseDown = (event) => {
+            if (this.maximized)
+                return;
+            const resizeEdge = this.getResizeEdge(event);
+            if (resizeEdge && !this.locked) {
+                event.preventDefault();
+                this.startResize(event, resizeEdge);
+                return;
+            }
+            if (this.locked)
+                return;
+            if (!this.isHeaderClick(event))
+                return;
+            if (this.isActionButtonClick(event))
+                return;
+            event.preventDefault();
+            this.startDrag(event);
+        };
+        this.handleMouseMove = (event) => {
+            if (this.dragging) {
+                this.dragOffsetX = event.clientX - this.dragStartX;
+                this.dragOffsetY = event.clientY - this.dragStartY;
+                this.emit('aithe-panel-drag', {
+                    panelId: this.panelId,
+                    deltaX: this.dragOffsetX,
+                    deltaY: this.dragOffsetY,
+                });
+            }
+        };
+        this.handleMouseUp = () => {
+            if (!this.dragging)
+                return;
+            this.dragging = false;
+            delete this.dataset.dragging;
+            this.cleanupDrag();
+            this.emit('aithe-panel-drag-end', {
+                panelId: this.panelId,
+                deltaX: this.dragOffsetX,
+                deltaY: this.dragOffsetY,
+            });
+        };
+        this.handleResizeMove = (event) => {
+            if (!this.resizing || !this.resizeEdge)
+                return;
+            this.resizeDeltaX = event.clientX - this.resizeStartX;
+            this.resizeDeltaY = event.clientY - this.resizeStartY;
+            this.emit('aithe-panel-resize', {
+                panelId: this.panelId,
+                edge: this.resizeEdge,
+                deltaX: this.resizeDeltaX,
+                deltaY: this.resizeDeltaY,
+            });
+        };
+        this.handleResizeEnd = () => {
+            if (!this.resizing)
+                return;
+            const edge = this.resizeEdge;
+            this.resizing = false;
+            this.resizeEdge = null;
+            delete this.dataset.resizing;
+            this.cleanupResize();
+            this.emit('aithe-panel-resize-end', {
+                panelId: this.panelId,
+                edge,
+                deltaX: this.resizeDeltaX,
+                deltaY: this.resizeDeltaY,
+            });
+        };
+        this.handleClose = () => {
+            this.emit('aithe-panel-close', { panelId: this.panelId });
+        };
+        this.handleMaximize = () => {
+            this.emit('aithe-panel-maximize', { panelId: this.panelId });
+        };
+    }
+    static { this.styles = [
+        aitheBaseStyles,
+        css `
+      :host {
+        display: block;
+        border-radius: var(--aithe-container-radius-lg);
+        background: var(--aithe-color-surface, #fff);
+        border: 1px solid var(--aithe-color-border-strong, rgba(52, 66, 96, 0.28));
+        box-shadow: var(--aithe-shadow-2, 0 2px 8px rgba(0, 0, 0, 0.08));
+        overflow: hidden;
+        transition:
+          box-shadow var(--aithe-duration-base, 0.2s) var(--aithe-ease-standard, ease),
+          transform var(--aithe-duration-fast, 0.1s) var(--aithe-ease-standard, ease);
+      }
+
+      :host([hidden]) {
+        display: none !important;
+      }
+
+      :host([data-dragging]) {
+        box-shadow: var(--aithe-shadow-4, 0 8px 24px rgba(0, 0, 0, 0.16));
+        transform: scale(1.02);
+        z-index: 10;
+        opacity: 0.92;
+      }
+
+      :host([maximized]) {
+        border-radius: 0;
+      }
+
+      :host([maximized]) .resize-handle {
+        display: none;
+      }
+
+      .panel-header {
+        display: flex;
+        align-items: center;
+        gap: var(--aithe-space-2, 8px);
+        padding: var(--aithe-space-2, 8px) var(--aithe-space-3, 12px);
+        user-select: none;
+        min-height: 36px;
+      }
+
+      :host(:not([locked])) .panel-header {
+        cursor: grab;
+      }
+
+      :host(:not([locked])) .panel-header:active {
+        cursor: grabbing;
+      }
+
+      .panel-icon {
+        flex-shrink: 0;
+        color: var(--aithe-color-text-muted, #6b7280);
+      }
+
+      .panel-label {
+        flex: 1;
+        font-size: var(--aithe-font-size-sm, 14px);
+        font-weight: var(--aithe-font-weight-semibold, 600);
+        color: var(--aithe-color-text, #1a1a1a);
+        white-space: nowrap;
+        overflow: hidden;
+        text-overflow: ellipsis;
+      }
+
+      .panel-actions {
+        display: flex;
+        align-items: center;
+        gap: 2px;
+        flex-shrink: 0;
+        opacity: 0;
+        transition: opacity var(--aithe-duration-fast, 0.1s) var(--aithe-ease-standard, ease);
+      }
+
+      :host(:hover) .panel-actions {
+        opacity: 1;
+      }
+
+      .action-btn {
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        width: 28px;
+        height: 28px;
+        border: none;
+        border-radius: var(--aithe-radius-sm, 4px);
+        background: transparent;
+        color: var(--aithe-color-text-muted, #6b7280);
+        cursor: pointer;
+        transition:
+          background 0.15s,
+          color 0.15s;
+      }
+
+      .action-btn:hover {
+        background: var(--aithe-color-surface-muted, #f3f4f6);
+        color: var(--aithe-color-text, #1a1a1a);
+      }
+
+      .action-btn.close-btn:hover {
+        background: var(--aithe-danger-6, #ef4444);
+        color: var(--aithe-color-text-on-primary, #fff);
+      }
+
+      .panel-body {
+        padding: var(--aithe-space-3, 12px);
+        overflow: auto;
+      }
+
+      .resize-handle {
+        position: absolute;
+        z-index: 5;
+      }
+
+      :host([locked]) .resize-handle {
+        display: none;
+      }
+
+      :host(:not([show-header])) .panel-header {
+        display: none;
+      }
+
+      @media (max-width: 768px) {
+        :host {
+          border-radius: var(--aithe-radius-md, 6px);
+        }
+
+        .resize-handle {
+          display: none !important;
+        }
+
+        .panel-actions {
+          opacity: 1;
+        }
+      }
+    `,
+    ]; }
+    connectedCallback() {
+        super.connectedCallback();
+        this.addEventListener('mousedown', this.handleMouseDown);
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.removeEventListener('mousedown', this.handleMouseDown);
+        this.cleanupDrag();
+        this.cleanupResize();
+    }
+    /**
+     * Check if a mousedown event originated from the panel header.
+     * Uses composedPath() to traverse Shadow DOM boundaries.
+     * 检查 mousedown 事件是否源自面板标题栏。使用 composedPath() 穿透 Shadow DOM 边界。
+     */
+    isHeaderClick(event) {
+        if (!this.headerEl)
+            return false;
+        const path = event.composedPath();
+        for (const node of path) {
+            if (node === this.headerEl)
+                return true;
+        }
+        return false;
+    }
+    /**
+     * Check if a mousedown event originated from an action button.
+     * 检查 mousedown 事件是否源自操作按钮。
+     */
+    isActionButtonClick(event) {
+        const path = event.composedPath();
+        for (const node of path) {
+            if (node instanceof HTMLElement && node.closest('.action-btn'))
+                return true;
+        }
+        return false;
+    }
+    /**
+     * Check if a mousedown event originated from a resize handle.
+     * Returns the edge identifier or null.
+     * 检查 mousedown 事件是否源自调整大小手柄。返回边缘标识或 null。
+     */
+    getResizeEdge(event) {
+        const path = event.composedPath();
+        for (const node of path) {
+            if (node instanceof HTMLElement && node.dataset.edge) {
+                return node.dataset.edge;
+            }
+        }
+        return null;
+    }
+    /** Start a drag operation. 开始拖拽操作。 */
+    startDrag(event) {
+        this.dragging = true;
+        this.dragStartX = event.clientX;
+        this.dragStartY = event.clientY;
+        this.dragOffsetX = 0;
+        this.dragOffsetY = 0;
+        this.dataset.dragging = '';
+        this.emit('aithe-panel-drag-start', {
+            panelId: this.panelId,
+            startX: event.clientX,
+            startY: event.clientY,
+        });
+        document.addEventListener('mousemove', this.handleMouseMove);
+        document.addEventListener('mouseup', this.handleMouseUp);
+    }
+    cleanupDrag() {
+        document.removeEventListener('mousemove', this.handleMouseMove);
+        document.removeEventListener('mouseup', this.handleMouseUp);
+    }
+    /** Start a resize operation. 开始调整大小操作。 */
+    startResize(event, edge) {
+        this.resizing = true;
+        this.resizeEdge = edge;
+        this.resizeStartX = event.clientX;
+        this.resizeStartY = event.clientY;
+        this.resizeDeltaX = 0;
+        this.resizeDeltaY = 0;
+        this.dataset.resizing = '';
+        this.emit('aithe-panel-resize-start', {
+            panelId: this.panelId,
+            edge,
+            startX: event.clientX,
+            startY: event.clientY,
+        });
+        document.addEventListener('mousemove', this.handleResizeMove);
+        document.addEventListener('mouseup', this.handleResizeEnd);
+    }
+    cleanupResize() {
+        document.removeEventListener('mousemove', this.handleResizeMove);
+        document.removeEventListener('mouseup', this.handleResizeEnd);
+    }
+    /** Render panel header with icon, label, and action buttons. 渲染面板头部，含图标、标签和操作按钮。 */
+    renderHeader() {
+        if (!this.showHeader)
+            return nothing;
+        const maxTitle = this.maximized ? 'Restore' : 'Maximize';
+        const maxIcon = this.maximized ? 'minimize' : 'maximize';
+        return html `
+      <div class="panel-header" part="header">
+        ${this.icon
+            ? html `
+              <aithe-icon class="panel-icon" name=${this.icon} size="16"></aithe-icon>
+            `
+            : nothing}
+        <span class="panel-label">${this.label}</span>
+        <slot name="header-actions"></slot>
+        <div class="panel-actions">
+          <button
+            class="action-btn maximize-btn"
+            part="maximize-btn"
+            type="button"
+            title=${maxTitle}
+            @click=${this.handleMaximize}
+          >
+            <aithe-icon name=${maxIcon} size="14"></aithe-icon>
+          </button>
+          ${this.closable
+            ? html `
+                <button
+                  class="action-btn close-btn"
+                  part="close-btn"
+                  type="button"
+                  title="Close"
+                  @click=${this.handleClose}
+                >
+                  <aithe-icon name="close" size="14"></aithe-icon>
+                </button>
+              `
+            : nothing}
+        </div>
+      </div>
+    `;
+    }
+    /** Render resize handles when not locked and not maximized. 非锁定且非最大化时渲染调整大小手柄。 */
+    renderResizeHandles() {
+        if (this.locked || this.maximized)
+            return nothing;
+        return html `
+      ${RESIZE_HANDLES.map((h) => html `
+          <div class="resize-handle" data-edge=${h.edge} style=${h.style}></div>
+        `)}
+    `;
+    }
+    render() {
+        return html `
+      ${this.renderHeader()}
+      <div class="panel-body" part="body">
+        <slot></slot>
+      </div>
+      ${this.renderResizeHandles()}
+    `;
+    }
+};
+__decorate([
+    property({ type: String, attribute: 'panel-id' })
+], AitheDashboardPanel.prototype, "panelId", void 0);
+__decorate([
+    property({ type: Number })
+], AitheDashboardPanel.prototype, "x", void 0);
+__decorate([
+    property({ type: Number })
+], AitheDashboardPanel.prototype, "y", void 0);
+__decorate([
+    property({ type: Number })
+], AitheDashboardPanel.prototype, "w", void 0);
+__decorate([
+    property({ type: Number })
+], AitheDashboardPanel.prototype, "h", void 0);
+__decorate([
+    property({ type: Boolean })
+], AitheDashboardPanel.prototype, "closable", void 0);
+__decorate([
+    property({ type: String })
+], AitheDashboardPanel.prototype, "label", void 0);
+__decorate([
+    property({ type: String })
+], AitheDashboardPanel.prototype, "icon", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], AitheDashboardPanel.prototype, "visible", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], AitheDashboardPanel.prototype, "maximized", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], AitheDashboardPanel.prototype, "locked", void 0);
+__decorate([
+    property({ type: Boolean, attribute: 'show-header', reflect: true })
+], AitheDashboardPanel.prototype, "showHeader", void 0);
+__decorate([
+    state()
+], AitheDashboardPanel.prototype, "dragging", void 0);
+__decorate([
+    state()
+], AitheDashboardPanel.prototype, "resizing", void 0);
+__decorate([
+    query('.panel-header')
+], AitheDashboardPanel.prototype, "headerEl", void 0);
+AitheDashboardPanel = __decorate([
+    customElement('aithe-dashboard-panel')
+], AitheDashboardPanel);
+export { AitheDashboardPanel };