@unofficialbox/box-open-elements 0.1.0

package/dist/patterns/content-explorer/adapters/table.js

@@ -0,0 +1,467 @@
+import { resolveExplorerItemGesture, shouldActivateOnClick, shouldToggleOnEnter, } from "../types.js";
+import { formatItemDate, formatItemOwner, formatItemShared, formatItemSize, itemSummarySignature, } from "./item-summary.js";
+import { BaseElement } from "../../../core/index.js";
+import { boeFocusVisibleStyles, boeNeutralInteractiveStyles, } from "../../../foundations/tokens/index.js";
+import { boeMotionDuration, boeMotionEasing } from "../../../foundations/motion/index.js";
+import { boePanel, boeRadius } from "../../../foundations/geometry/index.js";
+const DEFAULT_TAG_NAME = "box-explorer-table";
+const toKebabCase = (value) => value.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);
+const escapeHtml = (value) => value
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;")
+    .replaceAll("'", "&#39;");
+const elementStyles = `
+        :host {
+          display: block;
+          color: inherit;
+          font: inherit;
+        }
+
+        [part="table-shell"] {
+          border: 1px solid color-mix(in srgb, var(--boe-token-stroke-stroke, #e8e8e8) 84%, var(--boe-token-surface-surface, #ffffff) 16%);
+          border-radius: ${boePanel.radius};
+          background: var(--boe-token-surface-surface, #ffffff);
+          box-shadow: 0 1px 2px rgba(15, 23, 42, 0.04);
+          overflow: hidden;
+        }
+
+        [part="table-shell"][aria-busy="true"] {
+          opacity: 0.72;
+        }
+
+        [part="table"] {
+          width: 100%;
+          border-collapse: collapse;
+          font-size: 0.92rem;
+          color: var(--boe-token-text-text, #222222);
+        }
+
+        [part="header-row"] {
+          background: var(--boe-token-surface-surface-secondary, #fbfbfb);
+        }
+
+        [part="header-row"] th {
+          padding: 0.5rem 0.65rem;
+          text-align: left;
+          font-size: 0.75rem;
+          font-weight: 700;
+          letter-spacing: 0.08em;
+          text-transform: uppercase;
+          color: var(--boe-token-text-text-secondary, #6f6f6f);
+          border-bottom: 1px solid color-mix(in srgb, var(--boe-token-stroke-stroke, #e8e8e8) 84%, var(--boe-token-surface-surface, #ffffff) 16%);
+          white-space: nowrap;
+        }
+
+        [part="header-selection"] {
+          width: 2.5rem;
+        }
+
+        [part="header-actions"],
+        [part="actions-cell"] {
+          text-align: right;
+        }
+
+        [part="row"] td {
+          padding: 0.4rem 0.65rem;
+          border-bottom: 1px solid color-mix(in srgb, var(--boe-token-stroke-stroke, #e8e8e8) 55%, transparent);
+        }
+
+        tbody tr:last-child td {
+          border-bottom: 0;
+        }
+
+        [part="row"] {
+          transition: background-color ${boeMotionDuration.interactive} ${boeMotionEasing.standard};
+        }
+
+        [part="row"]:hover {
+          background: var(--boe-token-surface-surface-hover, #f4f4f4);
+        }
+
+        [part="row"][aria-selected="true"],
+        [part="row"][aria-selected="true"]:hover {
+          background: var(--boe-token-surface-item-surface-selected, #f2f7fd);
+        }
+
+        [part="selection"] {
+          accent-color: var(--boe-token-surface-surface-brand, #0061d5);
+          width: 1rem;
+          height: 1rem;
+          margin: 0;
+          display: block;
+          cursor: pointer;
+          border-radius: ${boeRadius.size};
+        }
+
+        ${boeFocusVisibleStyles('[part="selection"]')}
+
+        [part="row-item"] {
+          appearance: none;
+          border: 0;
+          margin: 0;
+          padding: 0.35rem 0.5rem;
+          border-radius: ${boeRadius.med};
+          background: transparent;
+          color: var(--boe-token-text-text, #222222);
+          font: inherit;
+          font-size: 0.94rem;
+          font-weight: 500;
+          text-align: left;
+          max-width: 100%;
+          overflow: hidden;
+          text-overflow: ellipsis;
+          white-space: nowrap;
+          cursor: pointer;
+          transition:
+            background-color ${boeMotionDuration.interactive} ${boeMotionEasing.standard},
+            color ${boeMotionDuration.interactive} ${boeMotionEasing.standard},
+            box-shadow ${boeMotionDuration.interactive} ${boeMotionEasing.standard};
+        }
+
+        [part="row-item"]:hover:not(:disabled) {
+          background: color-mix(in srgb, var(--boe-token-surface-surface-brand, #0061d5) 8%, var(--boe-token-surface-surface, #ffffff) 92%);
+          color: var(--boe-token-surface-surface-brand, #0061d5);
+        }
+
+        [part="row-item"]:active:not(:disabled) {
+          background: color-mix(in srgb, var(--boe-token-surface-surface-hover, #f4f4f4) 70%, var(--boe-token-surface-surface-secondary, #fbfbfb) 30%);
+        }
+
+        ${boeFocusVisibleStyles('[part="row-item"]')}
+
+        [part="row-item"]:disabled {
+          cursor: not-allowed;
+          opacity: 0.55;
+          box-shadow: none;
+        }
+
+        [part="type-cell"],
+        [part="modified-cell"],
+        [part="size-cell"],
+        [part="owner-cell"],
+        [part="shared-cell"] {
+          color: var(--boe-token-text-text-secondary, #6f6f6f);
+          font-size: 0.85rem;
+          white-space: nowrap;
+        }
+
+        [part="type-cell"] {
+          text-transform: capitalize;
+        }
+
+        [part="size-cell"] {
+          font-variant-numeric: tabular-nums;
+        }
+
+        [part="empty"] {
+          padding: 0.6rem 0.65rem;
+          color: var(--boe-token-text-text-secondary, #6f6f6f);
+          font-size: 0.9rem;
+        }
+
+        [part="load-more-region"] {
+          display: flex;
+          justify-content: center;
+          padding: 0.5rem 0.6rem 0.7rem;
+          border-top: 1px solid color-mix(in srgb, var(--boe-token-stroke-stroke, #e8e8e8) 55%, transparent);
+        }
+
+        [part="load-more"] {
+          appearance: none;
+          font: inherit;
+          font-size: 0.88rem;
+          font-weight: 500;
+          padding: 0.35rem 0.7rem;
+          border: 1px solid color-mix(in srgb, var(--boe-token-stroke-stroke, #e8e8e8) 86%, var(--boe-token-surface-surface, #ffffff) 14%);
+          border-radius: ${boePanel.radius};
+          background: var(--boe-token-surface-surface, #ffffff);
+          color: var(--boe-token-text-text, #222222);
+          cursor: pointer;
+          transition:
+            border-color ${boeMotionDuration.interactive} ${boeMotionEasing.standard},
+            background-color ${boeMotionDuration.interactive} ${boeMotionEasing.standard},
+            box-shadow ${boeMotionDuration.interactive} ${boeMotionEasing.standard};
+        }
+
+        ${boeNeutralInteractiveStyles('[part="load-more"]')}
+      `;
+export class BoxExplorerTableElement extends BaseElement {
+    static get observedAttributes() {
+        return ["item-gesture"];
+    }
+    controllerValue = null;
+    unsubscribeFns = [];
+    get itemGesture() {
+        return resolveExplorerItemGesture(this.getAttribute("item-gesture"));
+    }
+    set itemGesture(value) {
+        this.setAttribute("item-gesture", value);
+    }
+    get controller() {
+        return this.controllerValue;
+    }
+    set controller(value) {
+        this.controllerValue = value;
+        this.bindController();
+        if (this.isRendered) {
+            this.update();
+        }
+    }
+    connectedCallback() {
+        this.bindController();
+        super.connectedCallback();
+    }
+    disconnectedCallback() {
+        this.teardownSubscriptions();
+    }
+    bindController() {
+        this.teardownSubscriptions();
+        if (!this.isConnected || !this.controllerValue) {
+            return;
+        }
+        for (const eventName of [
+            "itemsChanged",
+            "itemActivated",
+            "itemActionInvoked",
+            "loadingChanged",
+            "paginationChanged",
+            "selectionChanged",
+        ]) {
+            this.unsubscribeFns.push(this.controllerValue.subscribe(eventName, payload => {
+                this.dispatchEvent(new CustomEvent(toKebabCase(String(eventName)), {
+                    bubbles: true,
+                    composed: true,
+                    detail: payload,
+                }));
+                if (this.isRendered) {
+                    this.update();
+                }
+            }));
+        }
+    }
+    teardownSubscriptions() {
+        for (const unsubscribe of this.unsubscribeFns) {
+            unsubscribe();
+        }
+        this.unsubscribeFns = [];
+    }
+    itemsSignature = "";
+    renderTemplate() {
+        if (!this.shadowRoot) {
+            return;
+        }
+        this.shadowRoot.innerHTML = `
+      <style>${elementStyles}</style>
+      <section part="table-shell">
+        <table part="table">
+          <caption part="caption" style="position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0;">
+            Content items
+          </caption>
+          <thead>
+            <tr part="header-row">
+              <th part="header-selection" scope="col">Select</th>
+              <th part="header-name" scope="col">Name</th>
+              <th part="header-type" scope="col">Type</th>
+              <th part="header-modified" scope="col">Modified</th>
+              <th part="header-size" scope="col">Size</th>
+              <th part="header-owner" scope="col">Owner</th>
+              <th part="header-shared" scope="col">Shared</th>
+              <th part="header-actions" scope="col">Actions</th>
+            </tr>
+          </thead>
+          <tbody></tbody>
+        </table>
+        <div part="load-more-region" hidden></div>
+      </section>
+    `;
+    }
+    setupListeners() {
+        const tbody = this.shadowRoot?.querySelector("tbody");
+        const loadMoreRegion = this.shadowRoot?.querySelector('[part="load-more-region"]');
+        if (!tbody || !loadMoreRegion) {
+            return;
+        }
+        tbody.addEventListener("click", event => {
+            const rowItem = event.target.closest('[part="row-item"]');
+            if (!rowItem || !tbody.contains(rowItem)) {
+                return;
+            }
+            if (event.detail > 1) {
+                return;
+            }
+            const itemId = rowItem.getAttribute("data-item-id");
+            if (itemId) {
+                this.controllerValue?.toggleSelection(itemId);
+                if (shouldActivateOnClick(this.itemGesture)) {
+                    void this.controllerValue?.activateItem(itemId);
+                }
+            }
+        });
+        tbody.addEventListener("dblclick", event => {
+            const rowItem = event.target.closest('[part="row-item"]');
+            if (!rowItem || !tbody.contains(rowItem)) {
+                return;
+            }
+            const itemId = rowItem.getAttribute("data-item-id");
+            if (itemId) {
+                void this.controllerValue?.activateItem(itemId);
+            }
+        });
+        tbody.addEventListener("keydown", event => {
+            const keyboardEvent = event;
+            const rowItem = keyboardEvent.target.closest('[part="row-item"]');
+            if (!rowItem || !tbody.contains(rowItem)) {
+                return;
+            }
+            const itemId = rowItem.getAttribute("data-item-id");
+            if (!itemId) {
+                return;
+            }
+            if (keyboardEvent.key === " ") {
+                keyboardEvent.preventDefault();
+                this.controllerValue?.toggleSelection(itemId);
+                if (shouldActivateOnClick(this.itemGesture)) {
+                    void this.controllerValue?.activateItem(itemId);
+                }
+                return;
+            }
+            if (keyboardEvent.key === "Enter") {
+                keyboardEvent.preventDefault();
+                if (shouldToggleOnEnter(this.itemGesture)) {
+                    this.controllerValue?.toggleSelection(itemId);
+                }
+                void this.controllerValue?.activateItem(itemId);
+            }
+        });
+        tbody.addEventListener("change", event => {
+            const checkbox = event.target.closest('[part="selection"]');
+            if (!checkbox || !tbody.contains(checkbox)) {
+                return;
+            }
+            const itemId = checkbox.getAttribute("data-item-id");
+            if (itemId) {
+                this.controllerValue?.toggleSelection(itemId);
+            }
+        });
+        loadMoreRegion.addEventListener("click", event => {
+            if (event.target.closest('[part="load-more"]')) {
+                void this.controllerValue?.loadNextPage();
+            }
+        });
+    }
+    syncActionMenus() {
+        this.shadowRoot?.querySelectorAll("box-explorer-action-menu").forEach(node => {
+            const itemId = node.getAttribute("data-item-id");
+            const menuElement = node;
+            menuElement.controller = this.controllerValue;
+            menuElement.itemId = itemId;
+        });
+    }
+    patchSelection() {
+        const state = this.controllerValue?.getState();
+        const tbody = this.shadowRoot?.querySelector("tbody");
+        if (!state || !tbody) {
+            return;
+        }
+        tbody.querySelectorAll('[part="row"]').forEach(row => {
+            const itemId = row.dataset.itemId ?? "";
+            const isSelected = state.selectedItemIds.includes(itemId);
+            row.setAttribute("aria-selected", isSelected ? "true" : "false");
+            const checkbox = row.querySelector('[part="selection"]');
+            if (checkbox && checkbox !== this.shadowRoot?.activeElement) {
+                checkbox.checked = isSelected;
+            }
+        });
+    }
+    update() {
+        if (!this.shadowRoot) {
+            return;
+        }
+        const state = this.controllerValue?.getState();
+        const shell = this.shadowRoot.querySelector('[part="table-shell"]');
+        const tbody = this.shadowRoot.querySelector("tbody");
+        const loadMoreRegion = this.shadowRoot.querySelector('[part="load-more-region"]');
+        if (!shell || !tbody || !loadMoreRegion) {
+            return;
+        }
+        shell.setAttribute("aria-busy", state?.loading ? "true" : "false");
+        const nextSignature = JSON.stringify({
+            items: state?.items.map(item => ({
+                id: item.id,
+                name: item.name,
+                type: item.type,
+                ...itemSummarySignature(item),
+            })) ?? [],
+            actions: state?.availableActionsByItemId ?? {},
+            hasMore: state?.pagination.hasMoreItems ?? false,
+            loading: state?.loading ?? false,
+        });
+        if (nextSignature !== this.itemsSignature) {
+            this.itemsSignature = nextSignature;
+            const rowsMarkup = state?.items.length
+                ? state.items
+                    .map(item => {
+                    const isSelected = state.selectedItemIds.includes(item.id);
+                    const actions = (state.availableActionsByItemId[item.id] ?? []).length
+                        ? `<box-explorer-action-menu part="row-action-menu" data-item-id="${escapeHtml(item.id)}"></box-explorer-action-menu>`
+                        : "";
+                    const sizeLabel = item.type === "file" ? formatItemSize(item.size) : "";
+                    const modifiedLabel = formatItemDate(item.modifiedAt);
+                    const ownerLabel = formatItemOwner(item);
+                    const sharedLabel = formatItemShared(item.sharedLink);
+                    return `
+                <tr part="row" data-item-id="${escapeHtml(item.id)}" aria-selected="${isSelected ? "true" : "false"}">
+                  <td part="selection-cell">
+                    <input
+                      type="checkbox"
+                      part="selection"
+                      data-item-id="${escapeHtml(item.id)}"
+                      aria-label="${escapeHtml(`Select ${item.name}`)}"
+                      ${isSelected ? "checked" : ""}
+                    />
+                  </td>
+                  <td part="name-cell">
+                    <button
+                      type="button"
+                      part="row-item"
+                      data-item-id="${escapeHtml(item.id)}"
+                      aria-label="${escapeHtml(item.name)}"
+                    >${escapeHtml(item.name)}</button>
+                  </td>
+                  <td part="type-cell">${escapeHtml(item.type)}</td>
+                  <td part="modified-cell">${escapeHtml(modifiedLabel)}</td>
+                  <td part="size-cell">${escapeHtml(sizeLabel)}</td>
+                  <td part="owner-cell">${escapeHtml(ownerLabel)}</td>
+                  <td part="shared-cell">${escapeHtml(sharedLabel)}</td>
+                  <td part="actions-cell">${actions}</td>
+                </tr>
+              `;
+                })
+                    .join("")
+                : `<tr part="empty-row"><td colspan="8" part="empty">No items loaded</td></tr>`;
+            tbody.innerHTML = rowsMarkup;
+            if (state?.pagination.hasMoreItems && !state.loading) {
+                loadMoreRegion.hidden = false;
+                loadMoreRegion.innerHTML = `<button type="button" part="load-more">Load more</button>`;
+            }
+            else {
+                loadMoreRegion.hidden = true;
+                loadMoreRegion.innerHTML = "";
+            }
+            this.syncActionMenus();
+            return;
+        }
+        // Preserve checkbox nodes across selection-only updates.
+        this.patchSelection();
+    }
+}
+export const defineBoxExplorerTableElement = (tagName = DEFAULT_TAG_NAME) => {
+    const existingElement = customElements.get(tagName);
+    if (existingElement) {
+        return existingElement;
+    }
+    customElements.define(tagName, BoxExplorerTableElement);
+    return BoxExplorerTableElement;
+};

package/dist/patterns/content-explorer/adapters/toolbar.d.ts

@@ -0,0 +1,19 @@
+import { ContentExplorerController } from "../controller.js";
+import { BaseElement } from "../../../core/index.js";
+export declare class BoxExplorerToolbarElement extends BaseElement {
+    private controllerValue;
+    private unsubscribeFns;
+    private listenersBound;
+    get controller(): ContentExplorerController | null;
+    set controller(value: ContentExplorerController | null);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private bindController;
+    private teardownSubscriptions;
+    private getSearchField;
+    private syncSearchField;
+    protected renderTemplate(): void;
+    protected setupListeners(): void;
+    protected update(): void;
+}
+export declare const defineBoxExplorerToolbarElement: (tagName?: string) => typeof BoxExplorerToolbarElement;