@unofficialbox/box-open-elements 0.4.0 → 0.6.0

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

@@ -1,7 +1,8 @@
 import { ContentExplorerController } from "../controller.js";
 import { resolveExplorerItemGesture } from "../types.js";
 import { BaseElement } from "../../../core/index.js";
-export declare class BoxExplorerListElement extends BaseElement {
+export declare class ExplorerList extends BaseElement {
+    static readonly tagName: string;
     static get observedAttributes(): string[];
     private controllerValue;
     private focusItemId;
@@ -25,4 +26,3 @@ export declare class BoxExplorerListElement extends BaseElement {
     private patchFocusAndSelection;
     protected update(): void;
 }
-export declare const defineBoxExplorerListElement: (tagName?: string) => typeof BoxExplorerListElement;

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

@@ -191,7 +191,8 @@ const elementStyles = `
 
         ${boeNeutralInteractiveStyles('[part="load-more"]')}
       `;
-export class BoxExplorerListElement extends BaseElement {
+export class ExplorerList extends BaseElement {
+    static tagName = DEFAULT_TAG_NAME;
     static get observedAttributes() {
         return ["item-gesture"];
     }
@@ -517,11 +518,4 @@ export class BoxExplorerListElement extends BaseElement {
         this.patchFocusAndSelection();
     }
 }
-export const defineBoxExplorerListElement = (tagName = DEFAULT_TAG_NAME) => {
-    const existingElement = customElements.get(tagName);
-    if (existingElement) {
-        return existingElement;
-    }
-    customElements.define(tagName, BoxExplorerListElement);
-    return BoxExplorerListElement;
-};
+ExplorerList.register();

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

@@ -1,7 +1,8 @@
 import { ContentExplorerController } from "../controller.js";
 import { resolveExplorerItemGesture } from "../types.js";
 import { BaseElement } from "../../../core/index.js";
-export declare class BoxExplorerTableElement extends BaseElement {
+export declare class ExplorerTable extends BaseElement {
+    static readonly tagName: string;
     static get observedAttributes(): string[];
     private controllerValue;
     private unsubscribeFns;
@@ -20,4 +21,3 @@ export declare class BoxExplorerTableElement extends BaseElement {
     private patchSelection;
     protected update(): void;
 }
-export declare const defineBoxExplorerTableElement: (tagName?: string) => typeof BoxExplorerTableElement;

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

@@ -194,7 +194,8 @@ const elementStyles = `
 
         ${boeNeutralInteractiveStyles('[part="load-more"]')}
       `;
-export class BoxExplorerTableElement extends BaseElement {
+export class ExplorerTable extends BaseElement {
+    static tagName = DEFAULT_TAG_NAME;
     static get observedAttributes() {
         return ["item-gesture"];
     }
@@ -464,11 +465,4 @@ export class BoxExplorerTableElement extends BaseElement {
         this.patchSelection();
     }
 }
-export const defineBoxExplorerTableElement = (tagName = DEFAULT_TAG_NAME) => {
-    const existingElement = customElements.get(tagName);
-    if (existingElement) {
-        return existingElement;
-    }
-    customElements.define(tagName, BoxExplorerTableElement);
-    return BoxExplorerTableElement;
-};
+ExplorerTable.register();

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

@@ -1,6 +1,7 @@
 import { ContentExplorerController } from "../controller.js";
 import { BaseElement } from "../../../core/index.js";
-export declare class BoxExplorerToolbarElement extends BaseElement {
+export declare class ExplorerToolbar extends BaseElement {
+    static readonly tagName: string;
     private controllerValue;
     private unsubscribeFns;
     private listenersBound;
@@ -16,4 +17,3 @@ export declare class BoxExplorerToolbarElement extends BaseElement {
     protected setupListeners(): void;
     protected update(): void;
 }
-export declare const defineBoxExplorerToolbarElement: (tagName?: string) => typeof BoxExplorerToolbarElement;

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

@@ -1,5 +1,5 @@
 import { BaseElement } from "../../../core/index.js";
-import { defineBoxSearchFieldElement, } from "../../../components/forms/search-field.js";
+import { SearchField, } from "../../../components/forms/search-field.js";
 import { applyRovingTabindex, handleRovingKeydown } from "../../../foundations/a11y/index.js";
 import { boeNeutralInteractiveStyles } from "../../../foundations/tokens/index.js";
 import { boeMotionDuration, boeMotionEasing } from "../../../foundations/motion/index.js";
@@ -68,7 +68,8 @@ const elementStyles = `
         ${boeNeutralInteractiveStyles('[part="refresh"]')}
         ${boeNeutralInteractiveStyles('[part="clear-selection"]')}
       `;
-export class BoxExplorerToolbarElement extends BaseElement {
+export class ExplorerToolbar extends BaseElement {
+    static tagName = DEFAULT_TAG_NAME;
     controllerValue = null;
     unsubscribeFns = [];
     listenersBound = false;
@@ -83,7 +84,7 @@ export class BoxExplorerToolbarElement extends BaseElement {
         }
     }
     connectedCallback() {
-        defineBoxSearchFieldElement();
+        SearchField.register();
         this.bindController();
         super.connectedCallback();
     }
@@ -140,7 +141,7 @@ export class BoxExplorerToolbarElement extends BaseElement {
         if (!this.shadowRoot) {
             return;
         }
-        defineBoxSearchFieldElement();
+        SearchField.register();
         this.shadowRoot.innerHTML = `
       <style>${elementStyles}</style>
       <div part="toolbar" role="toolbar" aria-label="Explorer toolbar">
@@ -223,12 +224,5 @@ export class BoxExplorerToolbarElement extends BaseElement {
         applyRovingTabindex(buttons, restoreIndex >= 0 ? restoreIndex : 0);
     }
 }
-export const defineBoxExplorerToolbarElement = (tagName = DEFAULT_TAG_NAME) => {
-    defineBoxSearchFieldElement();
-    const existingElement = customElements.get(tagName);
-    if (existingElement) {
-        return existingElement;
-    }
-    customElements.define(tagName, BoxExplorerToolbarElement);
-    return BoxExplorerToolbarElement;
-};
+SearchField.register();
+ExplorerToolbar.register();

package/dist/patterns/content-explorer/box-transport.js

@@ -123,29 +123,48 @@ const resolveFetch = (providedFetch) => {
     }
     return globalThis.fetch.bind(globalThis);
 };
-const createFolderItemsUrl = (apiBaseUrl, folderId, fields, limit, offset) => {
+/** Box folder-items sort param values match our vocabulary directly. */
+const applySortParams = (url, sortBy, sortDirection) => {
+    if (sortBy) {
+        url.searchParams.set("sort", sortBy);
+        url.searchParams.set("direction", sortDirection ?? "ASC");
+    }
+};
+const createFolderItemsUrl = (apiBaseUrl, folderId, fields, request) => {
     const url = new URL(`${apiBaseUrl.replace(/\/$/, "")}/folders/${folderId}/items`);
     url.searchParams.set("fields", fields.join(","));
-    if (typeof limit === "number") {
-        url.searchParams.set("limit", String(limit));
+    if (typeof request.limit === "number") {
+        url.searchParams.set("limit", String(request.limit));
     }
-    if (typeof offset === "number") {
-        url.searchParams.set("offset", String(offset));
+    if (typeof request.offset === "number") {
+        url.searchParams.set("offset", String(request.offset));
     }
+    applySortParams(url, request.sortBy, request.sortDirection);
+    return url.toString();
+};
+const createFolderInfoUrl = (apiBaseUrl, folderId) => {
+    const url = new URL(`${apiBaseUrl.replace(/\/$/, "")}/folders/${folderId}`);
+    url.searchParams.set("fields", "id,name,path_collection");
     return url.toString();
 };
-const createSearchUrl = (apiBaseUrl, query, fields, ancestorFolderId, limit, offset) => {
+const createSearchUrl = (apiBaseUrl, fields, request) => {
     const url = new URL(`${apiBaseUrl.replace(/\/$/, "")}/search`);
-    url.searchParams.set("query", query);
+    url.searchParams.set("query", request.query);
     url.searchParams.set("fields", fields.join(","));
-    if (ancestorFolderId) {
-        url.searchParams.set("ancestor_folder_ids", ancestorFolderId);
+    if (request.ancestorFolderId) {
+        url.searchParams.set("ancestor_folder_ids", request.ancestorFolderId);
     }
-    if (typeof limit === "number") {
-        url.searchParams.set("limit", String(limit));
+    if (typeof request.limit === "number") {
+        url.searchParams.set("limit", String(request.limit));
     }
-    if (typeof offset === "number") {
-        url.searchParams.set("offset", String(offset));
+    if (typeof request.offset === "number") {
+        url.searchParams.set("offset", String(request.offset));
+    }
+    // Box search only sorts by modified date (or relevance, its default); name
+    // and size sorts stay client concerns there, so only "date" maps through.
+    if (request.sortBy === "date") {
+        url.searchParams.set("sort", "modified_at");
+        url.searchParams.set("direction", (request.sortDirection ?? "DESC") === "ASC" ? "ASC" : "DESC");
     }
     return url.toString();
 };
@@ -178,13 +197,14 @@ export const createBoxExplorerTransport = (options = {}) => {
     const apiBaseUrl = options.apiBaseUrl ?? DEFAULT_API_BASE_URL;
     const fields = options.fields ?? DEFAULT_FIELDS;
     const fetchImpl = resolveFetch(options.fetch);
+    const requestHeaders = (request) => ({
+        Authorization: `Bearer ${request.token}`,
+        "Accept-Language": request.language ?? "en-US",
+    });
     return {
         async loadFolderItems(request) {
-            const response = await fetchImpl(createFolderItemsUrl(apiBaseUrl, request.folderId, fields, request.limit, request.offset), {
-                headers: {
-                    Authorization: `Bearer ${request.token}`,
-                    "Accept-Language": request.language ?? "en-US",
-                },
+            const response = await fetchImpl(createFolderItemsUrl(apiBaseUrl, request.folderId, fields, request), {
+                headers: requestHeaders(request),
                 method: "GET",
                 signal: request.signal,
             });
@@ -194,9 +214,34 @@ export const createBoxExplorerTransport = (options = {}) => {
             const payload = (await response.json());
             const rawEntries = payload.entries ?? [];
             const { entries } = normalizeItems(rawEntries);
-            const folder = normalizeFolder(payload, request.folderId);
+            // The real `GET /folders/:id/items` payload carries no folder metadata
+            // (no id/name/path_collection), which would degrade the folder header
+            // and breadcrumbs to raw ids. When the first page lacks it, fetch
+            // `GET /folders/:id` for the metadata — best-effort: a failed info
+            // request keeps the listing usable rather than failing it.
+            let folderSource = payload;
+            const missingMetadata = payload.name === undefined || payload.id === undefined || payload.path_collection === undefined;
+            if (!request.offset && missingMetadata) {
+                const info = await Promise.resolve()
+                    .then(() => fetchImpl(createFolderInfoUrl(apiBaseUrl, request.folderId), {
+                    headers: requestHeaders(request),
+                    method: "GET",
+                    signal: request.signal,
+                }))
+                    .then(infoResponse => infoResponse?.ok ? infoResponse.json() : null)
+                    .catch(() => null);
+                if (info) {
+                    folderSource = {
+                        ...payload,
+                        id: payload.id ?? info.id,
+                        name: payload.name ?? info.name,
+                        path_collection: payload.path_collection ?? info.path_collection,
+                    };
+                }
+            }
+            const folder = normalizeFolder(folderSource, request.folderId);
             return {
-                breadcrumbs: normalizeBreadcrumbs(payload, folder),
+                breadcrumbs: normalizeBreadcrumbs(folderSource, folder),
                 folder,
                 folderId: request.folderId,
                 items: entries,
@@ -204,11 +249,8 @@ export const createBoxExplorerTransport = (options = {}) => {
             };
         },
         async searchItems(request) {
-            const response = await fetchImpl(createSearchUrl(apiBaseUrl, request.query, fields, request.ancestorFolderId, request.limit, request.offset), {
-                headers: {
-                    Authorization: `Bearer ${request.token}`,
-                    "Accept-Language": request.language ?? "en-US",
-                },
+            const response = await fetchImpl(createSearchUrl(apiBaseUrl, fields, request), {
+                headers: requestHeaders(request),
                 method: "GET",
                 signal: request.signal,
             });
@@ -225,5 +267,55 @@ export const createBoxExplorerTransport = (options = {}) => {
                 pagination: toPagination(payload, rawEntries.length, request),
             };
         },
+        async createFolder(request) {
+            const response = await fetchImpl(`${apiBaseUrl.replace(/\/$/, "")}/folders`, {
+                headers: { ...requestHeaders(request), "Content-Type": "application/json" },
+                method: "POST",
+                body: JSON.stringify({ name: request.name, parent: { id: request.parentFolderId } }),
+                signal: request.signal,
+            });
+            if (!response.ok) {
+                throw new Error(await getErrorMessage(response));
+            }
+            const payload = (await response.json());
+            const item = normalizeBoxExplorerItem(payload);
+            if (!item) {
+                throw new Error("Box API returned an unsupported item for the created folder");
+            }
+            return item;
+        },
+        async renameItem(request) {
+            const segment = request.itemType === "folder" ? "folders" : request.itemType === "web_link" ? "web_links" : "files";
+            const response = await fetchImpl(`${apiBaseUrl.replace(/\/$/, "")}/${segment}/${request.itemId}`, {
+                headers: { ...requestHeaders(request), "Content-Type": "application/json" },
+                method: "PUT",
+                body: JSON.stringify({ name: request.name }),
+                signal: request.signal,
+            });
+            if (!response.ok) {
+                throw new Error(await getErrorMessage(response));
+            }
+            const payload = (await response.json());
+            const item = normalizeBoxExplorerItem(payload);
+            if (!item) {
+                throw new Error("Box API returned an unsupported item for the rename");
+            }
+            return item;
+        },
+        async deleteItem(request) {
+            const segment = request.itemType === "folder" ? "folders" : request.itemType === "web_link" ? "web_links" : "files";
+            const url = new URL(`${apiBaseUrl.replace(/\/$/, "")}/${segment}/${request.itemId}`);
+            if (request.itemType === "folder") {
+                url.searchParams.set("recursive", "true");
+            }
+            const response = await fetchImpl(url.toString(), {
+                headers: requestHeaders(request),
+                method: "DELETE",
+                signal: request.signal,
+            });
+            if (!response.ok && response.status !== 204) {
+                throw new Error(await getErrorMessage(response));
+            }
+        },
     };
 };

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

@@ -1,35 +1,37 @@
-import { type ExplorerItemAction, type ExplorerItem, type ExplorerItemGesture, type ExplorerSelectionMode, type ExplorerState, type ExplorerTransport } from "./types.js";
+import { ContentExplorerController } from "./controller.js";
+import { type ExplorerItemAction, type ExplorerItem, type ExplorerItemGesture, type ExplorerSelectionMode, type ExplorerSortState, type ExplorerState, type ExplorerTransport } from "./types.js";
 import { BaseElement } from "../../core/index.js";
-export interface BoxContentExplorerTemplateContext {
-    element: BoxContentExplorerElement;
+export interface ContentExplorerTemplateContext {
+    element: ContentExplorer;
     state: Readonly<ExplorerState> | null;
 }
-export interface BoxContentExplorerFolderTemplateArgs extends BoxContentExplorerTemplateContext {
+export interface ContentExplorerFolderTemplateArgs extends ContentExplorerTemplateContext {
     breadcrumbsMarkup: string;
 }
-export interface BoxContentExplorerBreadcrumbTemplateArgs extends BoxContentExplorerTemplateContext {
+export interface ContentExplorerBreadcrumbTemplateArgs extends ContentExplorerTemplateContext {
     buttonAttributes: string;
     id: string;
     name: string;
 }
-export interface BoxContentExplorerItemActionTemplateArgs extends BoxContentExplorerTemplateContext {
+export interface ContentExplorerItemActionTemplateArgs extends ContentExplorerTemplateContext {
     action: ExplorerItemAction;
     buttonAttributes: string;
     item: ExplorerItem;
 }
-export interface BoxContentExplorerItemTemplateArgs extends BoxContentExplorerTemplateContext {
+export interface ContentExplorerItemTemplateArgs extends ContentExplorerTemplateContext {
     isSelected: boolean;
     item: ExplorerItem;
     itemActionsMarkup: string;
     itemButtonAttributes: string;
 }
-export interface BoxContentExplorerTemplates {
-    renderBreadcrumb?: (args: BoxContentExplorerBreadcrumbTemplateArgs) => string;
-    renderFolder?: (args: BoxContentExplorerFolderTemplateArgs) => string;
-    renderItem?: (args: BoxContentExplorerItemTemplateArgs) => string;
-    renderItemAction?: (args: BoxContentExplorerItemActionTemplateArgs) => string;
+export interface ContentExplorerTemplates {
+    renderBreadcrumb?: (args: ContentExplorerBreadcrumbTemplateArgs) => string;
+    renderFolder?: (args: ContentExplorerFolderTemplateArgs) => string;
+    renderItem?: (args: ContentExplorerItemTemplateArgs) => string;
+    renderItemAction?: (args: ContentExplorerItemActionTemplateArgs) => string;
 }
-export declare class BoxContentExplorerElement extends BaseElement {
+export declare class ContentExplorer extends BaseElement {
+    static readonly tagName: string;
     static get observedAttributes(): string[];
     private controller;
     private pendingStart;
@@ -54,8 +56,8 @@ export declare class BoxContentExplorerElement extends BaseElement {
     set transport(value: ExplorerTransport | null);
     get itemActions(): ExplorerItemAction[];
     set itemActions(value: ExplorerItemAction[]);
-    get templates(): BoxContentExplorerTemplates;
-    set templates(value: BoxContentExplorerTemplates);
+    get templates(): ContentExplorerTemplates;
+    set templates(value: ContentExplorerTemplates);
     get state(): Readonly<ExplorerState> | null;
     get searchQuery(): string | null;
     set searchQuery(value: string | null);
@@ -72,6 +74,16 @@ export declare class BoxContentExplorerElement extends BaseElement {
     toggleSelection(itemId: string): void;
     clearSelection(): void;
     invokeItemAction(itemId: string, actionId: string): void;
+    setSort(sort: ExplorerSortState | null): Promise<void>;
+    createFolder(name: string): Promise<ExplorerItem | null>;
+    renameItem(itemId: string, name: string): Promise<ExplorerItem | null>;
+    deleteItem(itemId: string): Promise<boolean>;
+    /**
+     * The live session controller, for pairing the shell with the standalone
+     * adapter elements (`box-explorer-toolbar`, `box-explorer-breadcrumbs`, …)
+     * or host-chrome bindings. Null until connected.
+     */
+    get explorerController(): ContentExplorerController | null;
     private updateStringAttribute;
     private scheduleStart;
     private startController;
@@ -81,5 +93,5 @@ export declare class BoxContentExplorerElement extends BaseElement {
     private getFocusableItemIds;
     protected renderTemplate(): void;
     protected update(): void;
+    private isFocusInsideHost;
 }
-export declare const defineBoxContentExplorerElement: (tagName?: string) => typeof BoxContentExplorerElement;

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

@@ -1,7 +1,7 @@
 import { ContentExplorerController } from "./controller.js";
 import { resolveExplorerItemGesture, shouldActivateOnClick, shouldToggleOnEnter, } from "./types.js";
 import { formatItemMetaLine } from "./adapters/item-summary.js";
-import { defineBoxSearchResultsHeaderElement, } from "../search/search-results-header.js";
+import { SearchResultsHeader, } from "../search/search-results-header.js";
 import { BaseElement } from "../../core/index.js";
 import { boeMotionDuration, boeMotionEasing } from "../../foundations/motion/index.js";
 import { boePanel, boeRadius } from "../../foundations/geometry/index.js";
@@ -249,7 +249,8 @@ const elementStyles = `
           justify-content: center;
         }
       `;
-export class BoxContentExplorerElement extends BaseElement {
+export class ContentExplorer extends BaseElement {
+    static tagName = DEFAULT_TAG_NAME;
     static get observedAttributes() {
         return ["item-gesture", "language", "page-size", "root-folder-id", "search-query", "selection-mode", "token"];
     }
@@ -385,6 +386,26 @@ export class BoxContentExplorerElement extends BaseElement {
     invokeItemAction(itemId, actionId) {
         this.controller?.invokeItemAction(itemId, actionId);
     }
+    async setSort(sort) {
+        await this.controller?.setSort(sort);
+    }
+    async createFolder(name) {
+        return (await this.controller?.createFolder(name)) ?? null;
+    }
+    async renameItem(itemId, name) {
+        return (await this.controller?.renameItem(itemId, name)) ?? null;
+    }
+    async deleteItem(itemId) {
+        return (await this.controller?.deleteItem(itemId)) ?? false;
+    }
+    /**
+     * The live session controller, for pairing the shell with the standalone
+     * adapter elements (`box-explorer-toolbar`, `box-explorer-breadcrumbs`, …)
+     * or host-chrome bindings. Null until connected.
+     */
+    get explorerController() {
+        return this.controller;
+    }
     updateStringAttribute(name, value) {
         if (value === null || value === "") {
             this.removeAttribute(name);
@@ -563,6 +584,7 @@ export class BoxContentExplorerElement extends BaseElement {
                         "data-item-id": item.id,
                         part: "item-action",
                         type: "button",
+                        ...(action.disabled ? { disabled: "", "aria-disabled": "true" } : {}),
                     });
                     return this.templatesValue.renderItemAction
                         ? this.templatesValue.renderItemAction({
@@ -593,7 +615,7 @@ export class BoxContentExplorerElement extends BaseElement {
                         itemButtonAttributes,
                         state,
                     })
-                    : `<li data-item-id="${item.id}" role="presentation">
+                    : `<li data-item-id="${escapeHtml(item.id)}" role="presentation">
                     <button ${itemButtonAttributes}><span part="item-name">${escapeHtml(item.name)}</span>${meta ? `<span part="item-meta">${escapeHtml(meta)}</span>` : ""}</button>
                     ${actions ? `<div part="item-actions">${actions}</div>` : ""}
                   </li>`;
@@ -614,13 +636,15 @@ export class BoxContentExplorerElement extends BaseElement {
         if (!host) {
             return;
         }
+        // Sample focus BEFORE the rebuild wipes the focused node.
+        const hadFocusInside = this.isFocusInsideHost();
         host.innerHTML = `
       <section aria-busy="${state?.loading ? "true" : "false"}">
         ${folderMarkup}
         <p part="status" data-status="${statusText}" role="status" aria-live="polite">${statusText}</p>
         ${errorMarkup}
         <button type="button" part="refresh" aria-label="Refresh items" ${refreshDisabled}>Refresh</button>
-        <ul part="items" role="listbox" aria-label="Explorer items">${itemsMarkup}</ul>
+        <ul part="items" role="listbox" aria-label="Explorer items" aria-multiselectable="${(this.selectionMode ?? "multiple") === "multiple" ? "true" : "false"}">${itemsMarkup}</ul>
         ${loadMoreMarkup ? `<div part="load-more-region">${loadMoreMarkup}</div>` : ""}
       </section>
     `;
@@ -726,20 +750,23 @@ export class BoxContentExplorerElement extends BaseElement {
                 }
             });
         });
-        if (this.focusItemId) {
+        // Restore focus only when it already lived inside this element before the
+        // rebuild — an unrelated state update (loading tick, selection change from
+        // the API) must never steal focus from elsewhere on the page.
+        if (this.focusItemId && hadFocusInside) {
             queueMicrotask(() => {
                 const target = Array.from(this.shadowRoot?.querySelectorAll('[part="item"]') ?? []).find(node => node.dataset.itemId === this.focusItemId);
                 target?.focus();
             });
         }
     }
+    isFocusInsideHost() {
+        const active = document.activeElement;
+        if (!active) {
+            return false;
+        }
+        return active === this || (this.shadowRoot?.contains(active) ?? false);
+    }
 }
-export const defineBoxContentExplorerElement = (tagName = DEFAULT_TAG_NAME) => {
-    defineBoxSearchResultsHeaderElement();
-    const existingElement = customElements.get(tagName);
-    if (existingElement) {
-        return existingElement;
-    }
-    customElements.define(tagName, BoxContentExplorerElement);
-    return BoxContentExplorerElement;
-};
+SearchResultsHeader.register();
+ContentExplorer.register();

package/dist/patterns/content-explorer/contracts.d.ts

@@ -1,4 +1,4 @@
-import type { ExplorerFetchLike, ExplorerSearchResult, ExplorerTransport, ExplorerTransportResult } from "./types.js";
+import type { ExplorerFetchLike, ExplorerItem, ExplorerSearchResult, ExplorerSortBy, ExplorerSortDirection, ExplorerTransport, ExplorerTransportResult } from "./types.js";
 export interface ContentExplorerRequestContext {
     locale?: string;
     requestId?: string;
@@ -8,6 +8,8 @@ export interface ContentExplorerListFolderInput {
     folderId: string;
     limit?: number;
     offset?: number;
+    sortBy?: ExplorerSortBy;
+    sortDirection?: ExplorerSortDirection;
     context?: ContentExplorerRequestContext;
 }
 export interface ContentExplorerSearchInput {
@@ -15,11 +17,32 @@ export interface ContentExplorerSearchInput {
     ancestorFolderId?: string;
     limit?: number;
     offset?: number;
+    sortBy?: ExplorerSortBy;
+    sortDirection?: ExplorerSortDirection;
+    context?: ContentExplorerRequestContext;
+}
+export interface ContentExplorerCreateFolderInput {
+    parentFolderId: string;
+    name: string;
+    context?: ContentExplorerRequestContext;
+}
+export interface ContentExplorerRenameItemInput {
+    itemId: string;
+    itemType: ExplorerItem["type"];
+    name: string;
+    context?: ContentExplorerRequestContext;
+}
+export interface ContentExplorerDeleteItemInput {
+    itemId: string;
+    itemType: ExplorerItem["type"];
     context?: ContentExplorerRequestContext;
 }
 export interface ContentExplorerDataSource {
     listFolderItems(input: ContentExplorerListFolderInput): Promise<ExplorerTransportResult>;
     search?(input: ContentExplorerSearchInput): Promise<ExplorerSearchResult>;
+    createFolder?(input: ContentExplorerCreateFolderInput): Promise<ExplorerItem>;
+    renameItem?(input: ContentExplorerRenameItemInput): Promise<ExplorerItem>;
+    deleteItem?(input: ContentExplorerDeleteItemInput): Promise<void>;
 }
 export interface ContentExplorerHttpDataSourceOptions {
     baseUrl?: string;