@contrail/documents 1.16.0-alpha.96c651c → 1.16.0-alpha.fd404ec

package/CHANGELOG.md

@@ -9,12 +9,26 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ### Added
 
-- `ASSET_VIEW_TEMPLATE` and its `asset-view` entry in `ComponentRegistry` — the component definition for an asset card. Image-forward: one image bound to the asset's viewable, one text row bound to `asset.name`. Consumers resolve it by slug through `DocumentElementFactory.createComponent('asset-view', …)`.
+- `ASSET_VIEW_TEMPLATE` and its `asset-view` entry in `ComponentRegistry` — the component definition for an asset card. Image-only in v1: one image bound to the asset's viewable. Label and attribute rows are deferred to the card customization work.
 
 ### Fixed
 
 - `DocumentElementPropertyBindingHandler` only unwrapped `viewable.content` when it was an array, which is the item shape. An asset's `content` is a single object, so asset viewables never resolved `alternateUrls.originalFile`, and an SVG asset's high-resolution url fell back to a raster derivative instead of its source file. Both shapes are now handled; item viewables still select the record matching `primaryViewableId`.
 
+## [1.15.1] - 2026-08-28
+
+### Added
+
+- `DYNAMIC_TEXT_DATA_SOURCE.SECTION`, the `DynamicTextContainer` type, `MOVE_TO_SECTION_TEXT`, and `isContainerBinding()`. `DynamicTextUtil.getDynamicTextValue` now evaluates `section.*` bindings (`name`, `count`, `itemFamilyCount`, `itemOptionCount`, `colorCount`) the same way it already evaluates `frame.*`.
+
+### Changed
+
+- `getDynamicTextValue`'s fourth parameter is typed `DynamicTextContainer | null` rather than `{ name, id }`. This is source-compatible: `source` is optional and a container without one is treated as a frame, so existing callers need no change. Which kind of container is rendered is read from the binding (`frame.count` vs `section.count`); `source` records what the caller resolved. The parameter is now nullable to match what it always accepted, since callers pass `null` for an element in no container.
+
+### Removed
+
+- A branch that cleared `property` for a container binding while handling a binding that names no container, which could never run.
+
 ## [1.15.0] - 2026-08-21
 
 ### Added

package/lib/components/components.d.ts

@@ -354,7 +354,7 @@ export declare const PATTERN_VIEW_TEMPLATE: {
     })[];
 };
 export declare const ASSET_VIEW_TEMPLATE: {
-    elements: ({
+    elements: {
         type: string;
         size: {
             width: number;
@@ -364,34 +364,11 @@ export declare const ASSET_VIEW_TEMPLATE: {
             background: {
                 size: BackgroundSizeType;
             };
-            font?: undefined;
         };
         propertyBindings: {
             url: string;
-            text?: undefined;
         };
-        position?: undefined;
-    } | {
-        type: string;
-        position: {
-            x: number;
-            y: number;
-        };
-        size: {
-            height: number;
-            width: number;
-        };
-        style: {
-            font: {
-                size: number;
-            };
-            background?: undefined;
-        };
-        propertyBindings: {
-            text: string;
-            url?: undefined;
-        };
-    })[];
+    }[];
 };
 export declare const ITEM_VIEW: {
     slug: string;
@@ -760,7 +737,7 @@ export declare const PATTERN_VIEW: {
 export declare const ASSET_VIEW: {
     slug: string;
     defaultTemplate: {
-        elements: ({
+        elements: {
             type: string;
             size: {
                 width: number;
@@ -770,34 +747,11 @@ export declare const ASSET_VIEW: {
                 background: {
                     size: BackgroundSizeType;
                 };
-                font?: undefined;
             };
             propertyBindings: {
                 url: string;
-                text?: undefined;
             };
-            position?: undefined;
-        } | {
-            type: string;
-            position: {
-                x: number;
-                y: number;
-            };
-            size: {
-                height: number;
-                width: number;
-            };
-            style: {
-                font: {
-                    size: number;
-                };
-                background?: undefined;
-            };
-            propertyBindings: {
-                text: string;
-                url?: undefined;
-            };
-        })[];
+        }[];
     };
 };
 export declare class ComponentRegistry {

package/lib/components/components.js

@@ -210,17 +210,6 @@ exports.ASSET_VIEW_TEMPLATE = {
             style: { background: { size: types_1.BackgroundSizeType.CONTAIN } },
             propertyBindings: { url: 'viewable.mediumViewableDownloadUrl' },
         },
-        {
-            type: 'text',
-            position: { x: 0, y: 126 },
-            size: { height: 25, width: 125 },
-            style: {
-                font: {
-                    size: 8,
-                },
-            },
-            propertyBindings: { text: 'asset.name' },
-        },
     ],
 };
 exports.ITEM_VIEW = {

package/lib/util/dynamic-text/dynamic-text-util.d.ts

@@ -4,7 +4,14 @@ export declare enum DYNAMIC_TEXT_DATA_SOURCE {
     PROJECT = "project",
     BOARD = "board",
     SHOWCASE = "showcase",
-    FRAME = "frame"
+    FRAME = "frame",
+    SECTION = "section"
+}
+export type DynamicTextContainerSource = DYNAMIC_TEXT_DATA_SOURCE.FRAME | DYNAMIC_TEXT_DATA_SOURCE.SECTION;
+export interface DynamicTextContainer {
+    name: string;
+    id?: string;
+    source?: DynamicTextContainerSource;
 }
 export declare enum DynamicTextDisplayFunction {
     VALUE = "value",
@@ -18,6 +25,7 @@ export declare enum DynamicTextDisplayFunction {
     SUM = "sum"
 }
 export declare const MOVE_TO_FRAME_TEXT = "Move to a frame";
+export declare const MOVE_TO_SECTION_TEXT = "Move to a section";
 export declare const CLICK_TO_CONFIGURE = "Click to configure";
 export declare const HARD_CODED_TEXT: {
     'project.name': string;
@@ -34,12 +42,15 @@ export declare const HARD_CODED_TEXT: {
     'frame.itemFamilyCount': string;
     'frame.itemOptionCount': string;
     'frame.colorCount': string;
+    'section.name': string;
+    'section.count': string;
+    'section.itemFamilyCount': string;
+    'section.itemOptionCount': string;
+    'section.colorCount': string;
 };
+export declare function isContainerBinding(bindingProperty: string | null | undefined): boolean;
 export declare class DynamicTextUtil {
-    static getDynamicTextValue(dynamicTextElement: DocumentElement, property: TypeProperty, propertyLevel: PropertyLevel, frame: {
-        name: string;
-        id?: string;
-    }, componentModels: any[], ownerReferenceModel?: any): string;
+    static getDynamicTextValue(dynamicTextElement: DocumentElement, property: TypeProperty, propertyLevel: PropertyLevel, container: DynamicTextContainer | null, componentModels: any[], ownerReferenceModel?: any): string;
     static calculateSize(dynamicTextElement: DocumentElement, entityType: any, text: string): import("../..").SizeDefinition;
     static getTextFromFrameMemberValues(displayFunction: string, property: any, memberValues: any[]): string;
     private static getItemCount;

package/lib/util/dynamic-text/dynamic-text-util.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DynamicTextUtil = exports.HARD_CODED_TEXT = exports.CLICK_TO_CONFIGURE = exports.MOVE_TO_FRAME_TEXT = exports.DynamicTextDisplayFunction = exports.DYNAMIC_TEXT_DATA_SOURCE = void 0;
+exports.DynamicTextUtil = exports.HARD_CODED_TEXT = exports.CLICK_TO_CONFIGURE = exports.MOVE_TO_SECTION_TEXT = exports.MOVE_TO_FRAME_TEXT = exports.DynamicTextDisplayFunction = exports.DYNAMIC_TEXT_DATA_SOURCE = void 0;
+exports.isContainerBinding = isContainerBinding;
 const types_1 = require("@contrail/types");
 const util_1 = require("@contrail/util");
 const document_util_1 = require("@contrail/document-util");
@@ -10,6 +11,7 @@ var DYNAMIC_TEXT_DATA_SOURCE;
     DYNAMIC_TEXT_DATA_SOURCE["BOARD"] = "board";
     DYNAMIC_TEXT_DATA_SOURCE["SHOWCASE"] = "showcase";
     DYNAMIC_TEXT_DATA_SOURCE["FRAME"] = "frame";
+    DYNAMIC_TEXT_DATA_SOURCE["SECTION"] = "section";
 })(DYNAMIC_TEXT_DATA_SOURCE || (exports.DYNAMIC_TEXT_DATA_SOURCE = DYNAMIC_TEXT_DATA_SOURCE = {}));
 var DynamicTextDisplayFunction;
 (function (DynamicTextDisplayFunction) {
@@ -24,6 +26,7 @@ var DynamicTextDisplayFunction;
     DynamicTextDisplayFunction["SUM"] = "sum";
 })(DynamicTextDisplayFunction || (exports.DynamicTextDisplayFunction = DynamicTextDisplayFunction = {}));
 exports.MOVE_TO_FRAME_TEXT = 'Move to a frame';
+exports.MOVE_TO_SECTION_TEXT = 'Move to a section';
 exports.CLICK_TO_CONFIGURE = 'Click to configure';
 exports.HARD_CODED_TEXT = {
     'project.name': 'Project name',
@@ -40,16 +43,23 @@ exports.HARD_CODED_TEXT = {
     'frame.itemFamilyCount': 'Item family count',
     'frame.itemOptionCount': 'Item option count',
     'frame.colorCount': 'Color count',
+    'section.name': 'Section name',
+    'section.count': 'Total count',
+    'section.itemFamilyCount': 'Item family count',
+    'section.itemOptionCount': 'Item option count',
+    'section.colorCount': 'Color count',
 };
-const frameProperties = [
-    'frame.name',
-    'frame.count',
-    'frame.itemFamilyCount',
-    'frame.itemOptionCount',
-    'frame.colorCount',
-];
+const CONTAINER_PROPERTY_SLUGS = ['name', 'count', 'itemFamilyCount', 'itemOptionCount', 'colorCount'];
+const CONTAINER_SOURCES = [DYNAMIC_TEXT_DATA_SOURCE.FRAME, DYNAMIC_TEXT_DATA_SOURCE.SECTION];
+function isContainerBinding(bindingProperty) {
+    if (!bindingProperty) {
+        return false;
+    }
+    const [entityType, propertySlug] = bindingProperty.split('.');
+    return CONTAINER_SOURCES.includes(entityType) && CONTAINER_PROPERTY_SLUGS.includes(propertySlug);
+}
 class DynamicTextUtil {
-    static getDynamicTextValue(dynamicTextElement, property, propertyLevel, frame, componentModels, ownerReferenceModel = null) {
+    static getDynamicTextValue(dynamicTextElement, property, propertyLevel, container, componentModels, ownerReferenceModel = null) {
         var _a, _b, _c, _d;
         if (!dynamicTextElement.propertyBindings || !dynamicTextElement.propertyBindings.text) {
             return exports.CLICK_TO_CONFIGURE;
@@ -78,11 +88,11 @@ class DynamicTextUtil {
                 : formatter.formatValue(text, types_1.PropertyType.String);
         }
         else {
-            if (!frame && !isSpecRelated) {
-                text = exports.MOVE_TO_FRAME_TEXT;
+            if (!container && !isSpecRelated) {
+                text = entityType === DYNAMIC_TEXT_DATA_SOURCE.SECTION ? exports.MOVE_TO_SECTION_TEXT : exports.MOVE_TO_FRAME_TEXT;
             }
             else {
-                if (entityType === 'frame') {
+                if (CONTAINER_SOURCES.includes(entityType)) {
                     if (propertySlug === 'count') {
                         text = componentModels.length.toString();
                     }
@@ -90,13 +100,10 @@ class DynamicTextUtil {
                         text = this.getItemCount(propertySlug, componentModels);
                     }
                     else {
-                        text = frame === null || frame === void 0 ? void 0 : frame.name;
+                        text = container === null || container === void 0 ? void 0 : container.name;
                     }
                 }
                 else {
-                    if (frameProperties.includes(bindingProperty)) {
-                        property = null;
-                    }
                     const frameMemberValues = [];
                     if (propertyLevel) {
                         componentModels = Array.from(new Map(componentModels
@@ -121,13 +128,13 @@ class DynamicTextUtil {
             }
         }
         if (displayFunction === DynamicTextDisplayFunction.LABEL) {
-            if (['showcase', 'board', 'project', 'frame'].includes(entityType) || isSpecRelated) {
+            if (['showcase', 'board', 'project', ...CONTAINER_SOURCES].includes(entityType) || isSpecRelated) {
                 text = exports.HARD_CODED_TEXT[bindingProperty] || (property === null || property === void 0 ? void 0 : property.label);
             }
-            else if (!frame) {
+            else if (!container) {
                 text = exports.MOVE_TO_FRAME_TEXT;
             }
-            else if (frame) {
+            else {
                 text = property === null || property === void 0 ? void 0 : property.label;
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/documents",
-  "version": "1.16.0-alpha.96c651c",
+  "version": "1.16.0-alpha.fd404ec",
   "description": "Documents library for contrail platform",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",