@orangelogic/orange-dam-content-browser-sdk 2.3.6 → 2.3.7-table-view-beta-2

package/build/tools/fetch-and-merge-assets.d.ts

@@ -6,6 +6,8 @@ import { Facet, SortOrder } from '../types/content-browser';
 import { GetFolderRequest } from '../types/folder';
 import type { ReactiveController } from 'lit';
 type FetchAndMergeAssetsControllerOptions = {
+    /** Cortex fields the table-view columns read, requested on every search alongside the fixed set. */
+    additionalFields?: string[];
     availableDocTypes: string[];
     baseUrl: string;
     defaultFolderId: string;
@@ -44,6 +46,7 @@ export declare class FetchAndMergeAssetsController implements ReactiveController
     private resolvePendingTokenRefresh;
     private readonly tokenRefreshTimeoutMs;
     private readonly availableDocTypes;
+    private additionalFields;
     private readonly defaultSearchText;
     private readonly defaultSelectedFacets;
     private readonly defaultSortOrderName;
@@ -52,7 +55,7 @@ export declare class FetchAndMergeAssetsController implements ReactiveController
     private readonly defaultIsSeeThrough;
     private requestInterceptorId;
     private responseInterceptorId;
-    constructor(host: CortexElement, { availableDocTypes, baseUrl, defaultFolderId, defaultIsSeeThrough, defaultSearchText, defaultSelectedFacets, defaultSortDirection, defaultSortOrderName, token, useSession, useSiteSession, }: FetchAndMergeAssetsControllerOptions);
+    constructor(host: CortexElement, { additionalFields, availableDocTypes, baseUrl, defaultFolderId, defaultIsSeeThrough, defaultSearchText, defaultSelectedFacets, defaultSortDirection, defaultSortOrderName, token, useSession, useSiteSession, }: FetchAndMergeAssetsControllerOptions);
     private waitForNewToken;
     /**
      * Site-session mode decides the transport (cookies on the Cortex origin vs. Token/UseSession
@@ -64,6 +67,12 @@ export declare class FetchAndMergeAssetsController implements ReactiveController
      * step with the UI instead of serving requests through the mode the controller was built with.
      */
     updateSiteSession(useSiteSession: boolean, baseUrl: string, token: string, useSession: string): void;
+    /**
+     * Table columns are host configuration and can be reconfigured after mount, unlike the rest of
+     * these options — every later fetch must ask for the current field list, not the one that
+     * happened to be set when the controller was constructed.
+     */
+    updateAdditionalFields(additionalFields: string[]): void;
     updateAuth(token: string, useSession: string): void;
     private fetchInitialData;
     private _debounceTimeout;

package/build/types/asset.d.ts

@@ -80,6 +80,11 @@ export type GetAssetLinksRequest = {
     useRepresentative?: boolean;
 };
 export type GetAssetsRequest = {
+    /**
+     * Extra Cortex fields to request alongside the fixed set, returned on each item under the field
+     * name as sent. Used by the table view to resolve host-configured columns.
+     */
+    fields?: string[];
     folderId?: string;
     isSeeThrough?: boolean;
     limitedToDocTypes?: string[];

package/build/types/content-browser.d.ts

@@ -39,6 +39,34 @@ export declare enum GridView {
     Medium = "medium",
     Small = "small"
 }
+/**
+ * The table layout. `GridView` members are the grid's pixel-width presets, so a layout that is not
+ * a grid at all cannot be one of them.
+ */
+export declare const TABLE_VIEW = "table";
+/** What the content browser is currently rendering: one of the grid size presets, or the table. */
+export type ContentBrowserView = GridView | typeof TABLE_VIEW;
+export type TableColumnAlign = 'center' | 'left' | 'right';
+/**
+ * One column of the table view. The host owns the column set: the SDK ships the mechanism and no
+ * default column list, so nothing here is guessed from the asset's doc type.
+ */
+export type TableColumn = {
+    /** Horizontal alignment of the cell text. Default `left`. */
+    align?: TableColumnAlign;
+    /**
+     * Cortex field the column reads, e.g. `CoreField.Identifier` or `Dell.Snippet`. It is appended to
+     * the field list of the same search call the grid uses, so what a given caller gets back is decided
+     * server-side — the SDK neither filters nor resolves fields of its own.
+     */
+    field: string;
+    /** Lines a cell shows before the text is clamped. Default 1. */
+    lines?: number;
+    /** Column header text. */
+    title: string;
+    /** CSS grid track for the column, e.g. `200px`, `2fr`, `minmax(120px, 1fr)`. Default `minmax(0, 1fr)`. */
+    width?: string;
+};
 export declare const ASSET_SIZE: {
     small: {
         maxWidth: number;
@@ -113,6 +141,31 @@ export type FocusMode = {
     value: string;
 };
 export type DefaultFocusMode = 'manual' | 'center';
+/**
+ * Import behaviour when the host would rather not show the format picker.
+ *
+ * - `false` — 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` or `proxyLabel`. A name matching nothing opens the dialog as usual.
+ */
+export type AutoSelectFormat = boolean | string;
+/**
+ * React 19 sets a hyphenated prop as an attribute rather than a property, so the union has to
+ * survive a round trip through a string: `"true"`/`"false"` are the booleans, anything else is a
+ * format name. A bare attribute means `true`, matching how a boolean attribute normally reads.
+ */
+export declare const autoSelectFormatConverter: {
+    fromAttribute: (value: string | null) => AutoSelectFormat;
+    toAttribute: (value: AutoSelectFormat) => string | null;
+};
+/**
+ * Whether `autoSelectFormat` is switched on at all — a blank string is off, not a format named " ".
+ *
+ * Config-level, not per-asset: it says the host has asked to skip the picker, not that this
+ * particular asset will skip it. A named format that no proxy matches still opens the dialog.
+ */
+export declare function isAutoSelectFormatActive(value: AutoSelectFormat): boolean;
 export type CtaTextTransform = 'none' | 'uppercase' | 'lowercase' | 'capitalize';
 export declare enum ContentBrowserFormatDialogVariant {
     Dialog = "dialog",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orangelogic/orange-dam-content-browser-sdk",
-  "version": "2.3.6",
+  "version": "2.3.7-table-view-beta-2",
   "description": "OrangeDAM Content Browser SDK source code",
   "main": "./build/OrangeDAMContentBrowserSDK.min.js",
   "module": "./build/index.mjs",