@orangelogic/orange-dam-content-browser-sdk 2.4.8 → 2.4.9

package/build/events/cx-content-browser-control-view-change.d.ts

@@ -1,7 +1,7 @@
-import { GridView } from '../types/content-browser';
+import { ContentBrowserView } from '../types/content-browser';
 export type CxContentBrowserControlViewChangeEvent = CustomEvent<{
     isSeeThrough: boolean;
-    view: GridView;
+    view: ContentBrowserView;
 }>;
 declare global {
     interface GlobalEventHandlersEventMap {

package/build/events/cx-content-browser-request-change.d.ts

@@ -1,9 +1,9 @@
 import { GetAssetsRequest } from '../types/asset';
-import { GridView } from '../types/content-browser';
+import { ContentBrowserView } from '../types/content-browser';
 export type CxContentBrowserRequestChangeEvent = CustomEvent<{
     folderTitle: string | undefined;
     request: GetAssetsRequest | null;
-    view: GridView;
+    view: ContentBrowserView;
 }>;
 declare global {
     interface GlobalEventHandlersEventMap {

package/build/events/cx-content-browser-table-column-resize.d.ts

@@ -0,0 +1,26 @@
+export interface CxContentBrowserTableColumnResizeEvent extends CustomEvent<{
+    field: string;
+    reset: boolean;
+    width: number | undefined;
+}> {
+    detail: {
+        /** The Cortex field the resized column maps to, trimmed of surrounding whitespace (see `TableColumn.field`). */
+        field: string;
+        /**
+         * `false` after a drag of the column divider. `true` after a double click on the divider, which
+         * removes the saved width and auto-fits the column again.
+         */
+        reset: boolean;
+        /**
+         * The column's width in whole pixels: the dragged width, or the auto-fit width after a reset.
+         * The SDK saves a dragged width itself. The value is never `undefined`. The type keeps
+         * `undefined` so that existing handlers stay valid.
+         */
+        width: number | undefined;
+    };
+}
+declare global {
+    interface GlobalEventHandlersEventMap {
+        'cx-content-browser-table-column-resize': CxContentBrowserTableColumnResizeEvent;
+    }
+}

package/build/events/index.d.ts

@@ -21,4 +21,5 @@ export * from './cx-content-browser-pin-asset-change';
 export * from './cx-content-browser-pin-asset-lookup';
 export * from './cx-content-browser-request-change';
 export * from './cx-content-browser-selected-asset';
+export * from './cx-content-browser-table-column-resize';
 export * from './cx-loaded';

package/build/index.d.ts

@@ -2,6 +2,7 @@ import './styles.css';
 export { default as CxContentBrowser } from './components/content-browser/content-browser';
 import { AppContextType } from './AppContext';
 import { CtaTextTransform, ImageCardDisplayInfo } from './GlobalConfigContext';
+import { type AutoSelectFormat, TableColumn, type TableRowActionPosition } from './types/content-browser';
 import { Folder, GetContentRequest, GetContentResponse, GetFoldersRequest } from './types/search';
 type OrangeDAMContentBrowser = {
     help: () => void;
@@ -208,10 +209,47 @@ type OrangeDAMContentBrowser = {
          */
         loadExternalFonts?: boolean;
         /**
-         * The default grid view to be used when showing asset (default Medium)
-         * Available values: small, medium, large
+         * The default view to be used when showing assets (default medium)
+         * Available values: small, medium, large, table.
+         * `table` only applies when `tableColumns` is also provided.
          */
         defaultGridView?: string;
+        /**
+         * The columns of the table view. Each column carries a `title` (the header text) and a `field`
+         * (the Cortex field it reads, e.g. "CoreField.Identifier"). The table fits each column to its
+         * content, and the columns share the spare width so that they fill the table. The user resizes
+         * a column, and the table keeps the width of a resized column for each site.
+         * When a user drags a column divider, the other columns keep their width until the page reloads,
+         * the view changes or the site changes. Thus the table can end before the right edge of the
+         * host, or scroll horizontally.
+         * `width`, `align` and `lines` are ignored.
+         *
+         * The table view is offered in the view menu only when this is set, and the fields listed here
+         * are requested on every search — so an asset with no thumbnail, such as a text fragment,
+         * becomes browsable and selectable by its metadata.
+         */
+        tableColumns?: TableColumn[];
+        /**
+         * Where the row action of the table view shows: at the right edge of the host (`host-edge`), or
+         * at the end of the last data column (`row-end`). Any other value gives `host-edge`.
+         * Default `host-edge`.
+         */
+        tableRowActionPosition?: TableRowActionPosition;
+        /**
+         * Import behaviour when picking an asset, for a host that would rather not show the format
+         * picker.
+         *
+         * - `false` (default) - the format dialog opens as usual.
+         * - `true` - insert with the first available format, without showing the dialog.
+         * - a format name - insert with that format. Matched case-insensitively against a proxy's
+         *   `proxyName` ("TRX") or the label the picker shows ("Original"). A name that matches no
+         *   available format opens the dialog as usual, so a stale value degrades rather than breaks.
+         *
+         * Skipping the dialog also skips everything else it offers for that asset: the preview, the
+         * ATS custom format, and the tracking-parameter panel. Assets are inserted with tracking off,
+         * which is the dialog's own default.
+         */
+        autoSelectFormat?: AutoSelectFormat;
     }) => Promise<void>;
     close: () => void;
     fetchAssets: (params: GetContentRequest) => Promise<GetContentResponse | undefined> | undefined;

package/build/index.html

@@ -92,6 +92,10 @@
         //   fileSize: false,
         //   tags: false,
         extraFields: ['coreField.OriginalFileName', 'document.CortexPath', 'ScrubUrl'],
+        // tableColumns: [
+        //   { title: 'Identifier', field: 'CoreField.Identifier', width: '160px' },
+        //   { title: 'Title', field: 'CoreField.TitleWithFallback', width: 'minmax(0, 2fr)' },
+        // ],
         persistMode: true,
         // publicApplicationName: "",
         // pluginName: "OrangeDAM Content Browser",