@contrail/documents 2.4.0-alpha.c01727c → 2.4.0-alpha.ce67280

package/CHANGELOG.md

@@ -13,67 +13,75 @@ Also shipped on the 1.x line as 1.21.0.
 
 - `DocumentContainerService.buildIndex` and `DocumentContainerIndex` — which containers hold which
   elements, for one document, resolved once and read back by lookup. A container is a frame or a
-  section, described by a `ContainerKind` carrying `elementType`, `nests` and `layer`. An element
-  belongs to the container whose box covers its anchor point and which is drawn below it. Nesting
-  gives a path with one container per depth, the later-drawn one winning where two cross. A
-  container is only ever content of a kind layered behind it, so a frame belongs to a section and a
-  section never to a frame. Shapes wider and taller than the container, and groups holding it, are
-  excluded.
-- `SECTION_ELEMENT_TYPE`, `FRAME_ELEMENT_TYPE` and `SHAPE_ELEMENT_TYPES` in
-  `document-element-constants`, so the rule above has one definition rather than one per app.
-- `DocumentContainerUtil` — the container geometry as statics, with `anchorFor` for a caller
-  holding an element rather than a measured box.
-- `positionKeepingAnchor` — where an element has to sit for its drawn corner to land where it did
-  before a resize. Rotation turns about the centre and the centre moves with the size, so a rotated
-  element resized about its stored position drags its corner along with it. The board already makes
-  this move; a server recomputing a dynamic text has to make the same one, or the corner is not the
-  fixed point the anchor rule needs.
+  section; membership is geometry, draw order and kind, with nothing inherited and nothing stored.
+  The rule is written out in `src/containers/DOCUMENT_CONTAINERS_SPEC.md`, which the code is
+  measured against.
+- `DocumentContainerUtil` — the container geometry as statics. `anchorFor` answers "which point is
+  this element placed by" for a caller holding an element rather than a measured box, and
+  `resizeKeepingAnchor` returns the size a new value needs with the position that keeps that point
+  still. Applying one without the other drags the corner membership reads.
+- `SECTION_ELEMENT_TYPE` and `FRAME_ELEMENT_TYPE` in `document-element-constants`, alongside
+  `SHAPE_ELEMENT_TYPES`, which moved here for the board's shape handling.
 - `DocumentElementFactory.getBoundingClientRectScaled` — the space an element covers on the canvas,
-  with `scale` applied. `getBoundingClientRect` keeps returning the element's own box before scale,
-  which is what layout works in: `@contrail/document-table` places table members from it, and
-  scaling it moves a scaled member into a different cell. Anything deciding what an element overlaps
-  or sits on wants the scaled one.
+  with `scale` applied. `getBoundingClientRect` still returns the unscaled box, which is what layout
+  works in: `@contrail/document-table` places table members from it, and scaling it moves a scaled
+  member into a different cell. Anything deciding what an element overlaps or sits on wants the
+  scaled one.
+
+### Removed
+
+- `DocumentContainerIndex.containerPathAtPoint`. It applied the anchor rule alone, because a bare
+  point has nothing to compare against a container, and returned the same shape as `containerIdsOf`,
+  so it read as a second way to ask one question. `containerPathFor(element, kind)` replaces it and
+  applies every rule. Callers that hold a position pass the element with that position on it. This
+  is the one removal a consumer has to act on.
+- `ContainerKind.layer`, `DocumentContainer.name` and `DocumentContainer.depth`, and
+  `DocumentContainerIndex.maxDepth`. The container API has not shipped in a released version, so
+  nothing outside this repository can be holding them. Read a container's name from
+  `documentElement.name`.
 
 ### Deprecated
 
 - `isContainerBinding()` in favour of `DynamicTextUtil.takesValueFromContainer()`. Same rule, named
-  for what it decides: whether the binding's value comes from the container rather than a type
-  property. The old name still works and delegates to the new one.
+  for what it decides. The old name still works and delegates to the new one.
 
 ### Fixed
 
-- A dynamic text is now anchored at its drawn top-left corner rather than its centre when deciding
-  which container it belongs to, and `DynamicTextUtil.isDynamicText` is the shared test for one. Its
-  size comes from the value it resolves to, and that value depends on the container, so letting its
-  width feed membership meant its own text could choose its container: near an edge the two answers
-  disagreed indefinitely, flipping between a value and "Move to a frame" on every read. Everything
-  else still resolves on its centre.
-- The corner is the rotated one (VIBE-9567). A 200x20 text turned on its side draws as a 20x200
-  column, and its unrotated `position` can sit well clear of the frame it is visibly on, which
-  reported "Move to a frame" for a vertical text the user could see was placed correctly.
-- A dynamic text is also exempt from the oversized-shape exclusion, which keeps a shape wider and
-  taller than a container off it. That rule reads size too, so a dynamic text larger than its frame
-  in both directions had two self-consistent answers and kept whichever it started from. The rule
-  exists to keep a backdrop shape off a frame it covers, which is not what a dynamic text is doing.
-- `min` and `max` rendered an infinity sign when every member value was empty. The early return
-  checked the list length before the empty values were filtered out, so `Math.min` of nothing
-  reached the formatter. Both now fall through to `n/a`.
-- `DynamicTextUtil.calculateSize` threw on an element that reached it without a `size`, which on
-  the server failed the read for the whole document. It now measures from a zero size instead.
+- A dynamic text is anchored at its drawn top-left corner rather than its centre. Its size comes
+  from the value it resolves to and that value comes from its container, so an anchor that moved
+  with the size let the two choose each other: near an edge they never settled, flipping between a
+  value and "Move to a frame" on every read. The corner is the rotated one, so a text turned on its
+  side anchors where it appears (VIBE-9567).
+- `isDynamicText` requires a `propertyBindings.text` binding, the one the value is read from. The
+  text tool creates an element with empty bindings and empty metadata, both truthy, so an
+  unconfigured text was anchored at its corner while the canvas centred it.
+- An element covering a container is not inside it, whatever its type. The rule it replaces looked
+  only at shapes wider and taller than the container, so a background image joined the frame it
+  covered.
+- A line or callout is measured from the elements it connects even with no stored `position`, where
+  it was previously left out of the index entirely.
+- `min` and `max` rendered an infinity sign when every member value was empty; both fall through to
+  `n/a`. `calculateSize` no longer throws on an element that reaches it without a `size`, which on
+  the server failed the read for the whole document.
 
 ### Changed
 
-- Container membership measures a scaled element from its scaled box, through the new
-  `getBoundingClientRectScaled` above. Only a sticky note, a regular iframe, a text-tool text or a
-  table carries `scale` at all; for this work the one that matters is a text-tool dynamic text,
-  which previously measured at its unscaled size and could resolve to the wrong container.
-- `DocumentContainerUtil.anchorFor` measures through the same factory call the index uses, so a
-  caller holding an element gets the answer the index would give it. Reading `size` directly
-  disagreed for the types whose box is not position plus size: a component's box is built from the
-  rows it draws, and a line's comes from its `lineDefinition`.
-- Container depth counts nesting levels rather than enclosing boxes. Two containers that merely
-  cross both enclose anything inside the overlap, so counting ancestors put that inner container a
-  level too deep and made `maxDepth` report a level no path could reach.
+- `anchorFor` and the index measure through the same factory call, so a caller holding an element
+  gets the answer the index would give it. Reading `size` directly disagreed for the types whose box
+  is not position plus size.
+- A container path is a containment chain, walked outward from the container the element sits on, so
+  two containers that merely cross no longer both claim it.
+- `buildIndex` scans element types before measuring, so a document with no containers of the kinds
+  asked for returns an empty index without a geometry pass.
+- **A section nests inside another only when it is drawn above it.** A section drawn over one it
+  encloses hides it, so the hidden section holds nothing and a `section.count` on it reads zero.
+  This changes existing boards wherever the outer section was drawn last.
+- `containerIdsOf` and `memberIdsOf` return copies. `readonly` is erased at runtime, and a caller
+  sorting what it got back reordered the index's own list for every later read.
+- A member list is a set of ids, so two elements sharing an id count once.
+- `min` and `max` no longer read an empty member as zero, and `uniqueArray` no longer emits one as
+  a blank entry. A text box narrower than its own padding measures without a fixed width.
+- A nullish entry in the element list is dropped rather than throwing.
 
 ## [2.3.0] - 2026-09-21
 

package/lib/containers/container-kind.d.ts

@@ -3,7 +3,6 @@ export type ContainerElementType = typeof FRAME_ELEMENT_TYPE | typeof SECTION_EL
 export interface ContainerKind {
     elementType: ContainerElementType;
     nests: boolean;
-    layer: number;
 }
 export declare const SECTION_KIND: ContainerKind;
 export declare const FRAME_KIND: ContainerKind;

package/lib/containers/container-kind.js

@@ -2,6 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CONTAINER_KINDS = exports.FRAME_KIND = exports.SECTION_KIND = void 0;
 const document_element_constants_1 = require("../document-element-constants");
-exports.SECTION_KIND = { elementType: document_element_constants_1.SECTION_ELEMENT_TYPE, nests: true, layer: 0 };
-exports.FRAME_KIND = { elementType: document_element_constants_1.FRAME_ELEMENT_TYPE, nests: false, layer: 1 };
+exports.SECTION_KIND = { elementType: document_element_constants_1.SECTION_ELEMENT_TYPE, nests: true };
+exports.FRAME_KIND = { elementType: document_element_constants_1.FRAME_ELEMENT_TYPE, nests: false };
 exports.CONTAINER_KINDS = [exports.SECTION_KIND, exports.FRAME_KIND];

package/lib/containers/document-container-index.d.ts

@@ -1,23 +1,24 @@
-import { DocumentElement, PositionDefinition } from '../types';
-import { ContainerElementType } from './container-kind';
-import { DocumentContainer } from './document-container';
+import { DocumentElement } from '../types';
+import { ContainerElementType, ContainerKind } from './container-kind';
+import { DocumentContainer, MeasuredDocumentElement } from './document-container';
 export declare class DocumentContainerIndex {
     private readonly data;
     constructor(data: {
         documentElementsById: Map<string, DocumentElement>;
+        measuredById: Map<string, MeasuredDocumentElement>;
         containersById: Map<string, DocumentContainer>;
         containerPathsByDocumentElementId: Map<string, Map<string, string[]>>;
         memberIdsByContainerId: Map<string, string[]>;
         containerIdsByElementType: Map<string, string[]>;
     });
+    static empty(): DocumentContainerIndex;
     getContainer(containerId: string): DocumentContainer | null;
     containersOf(documentElementId: string, elementType: ContainerElementType): DocumentContainer[];
     containerIdsOf(documentElementId: string, elementType: ContainerElementType): readonly string[];
     innermostContainerIdOf(documentElementId: string, elementType: ContainerElementType): string | null;
     memberIdsOf(containerId: string): readonly string[];
     memberDocumentElementsOf(containerId: string): DocumentElement[];
-    containerPathAtPoint(point: PositionDefinition, elementType: ContainerElementType): readonly string[];
-    maxDepth(elementType: ContainerElementType): number;
+    containerPathFor(documentElement: DocumentElement, kind: ContainerKind): readonly string[];
     private containersOfType;
     private resolveAll;
     private containerPath;

package/lib/containers/document-container-index.js

@@ -6,6 +6,16 @@ class DocumentContainerIndex {
     constructor(data) {
         this.data = data;
     }
+    static empty() {
+        return new DocumentContainerIndex({
+            documentElementsById: new Map(),
+            measuredById: new Map(),
+            containersById: new Map(),
+            containerPathsByDocumentElementId: new Map(),
+            memberIdsByContainerId: new Map(),
+            containerIdsByElementType: new Map(),
+        });
+    }
     getContainer(containerId) {
         var _a;
         return (_a = this.data.containersById.get(containerId)) !== null && _a !== void 0 ? _a : null;
@@ -14,7 +24,7 @@ class DocumentContainerIndex {
         return this.resolveAll(this.containerIdsOf(documentElementId, elementType));
     }
     containerIdsOf(documentElementId, elementType) {
-        return this.containerPath(documentElementId, elementType);
+        return [...this.containerPath(documentElementId, elementType)];
     }
     innermostContainerIdOf(documentElementId, elementType) {
         const path = this.containerPath(documentElementId, elementType);
@@ -22,7 +32,7 @@ class DocumentContainerIndex {
     }
     memberIdsOf(containerId) {
         var _a;
-        return (_a = this.data.memberIdsByContainerId.get(containerId)) !== null && _a !== void 0 ? _a : [];
+        return [...((_a = this.data.memberIdsByContainerId.get(containerId)) !== null && _a !== void 0 ? _a : [])];
     }
     memberDocumentElementsOf(containerId) {
         const members = [];
@@ -34,12 +44,17 @@ class DocumentContainerIndex {
         }
         return members;
     }
-    containerPathAtPoint(point, elementType) {
-        const covering = this.containersOfType(elementType).filter((container) => document_container_1.DocumentContainerUtil.containsPoint(container.box, point));
-        return document_container_1.DocumentContainerUtil.topmostPerDepth(covering).map((container) => container.id);
-    }
-    maxDepth(elementType) {
-        return this.containersOfType(elementType).reduce((max, container) => Math.max(max, container.depth + 1), 0);
+    containerPathFor(documentElement, kind) {
+        var _a, _b;
+        if (!documentElement) {
+            return [];
+        }
+        const measured = {
+            documentElement,
+            box: document_container_1.DocumentContainerUtil.measureBox(documentElement, this.data.documentElementsById),
+            drawOrder: (_b = (_a = this.data.measuredById.get(documentElement.id)) === null || _a === void 0 ? void 0 : _a.drawOrder) !== null && _b !== void 0 ? _b : Number.MAX_SAFE_INTEGER,
+        };
+        return document_container_1.DocumentContainerUtil.pathFor(measured, kind, this.containersOfType(kind.elementType)).map((container) => container.id);
     }
     containersOfType(elementType) {
         var _a;

package/lib/containers/document-container.d.ts

@@ -3,10 +3,8 @@ import { ContainerKind } from './container-kind';
 export interface DocumentContainer {
     id: string;
     kind: ContainerKind;
-    name: string;
     documentElement: DocumentElement;
     box: CoordinateBox;
-    depth: number;
     drawOrder: number;
 }
 export interface MeasuredDocumentElement {
@@ -19,9 +17,17 @@ export declare class DocumentContainerUtil {
     static centerOf(box: CoordinateBox): PositionDefinition;
     static anchorOf(documentElement: DocumentElement, box: CoordinateBox): PositionDefinition;
     static positionKeepingAnchor(documentElement: DocumentElement, newSize: SizeDefinition): PositionDefinition;
+    static resizeKeepingAnchor(dynamicTextElement: DocumentElement, entityType: any, text: string): {
+        size: SizeDefinition;
+        position: PositionDefinition;
+    };
     static anchorFor(documentElement: DocumentElement, position?: PositionDefinition, startElement?: DocumentElement, endElement?: DocumentElement): PositionDefinition;
     static containsPoint(box: CoordinateBox, point: PositionDefinition): boolean;
     static encloses(outer: CoordinateBox, inner: CoordinateBox): boolean;
-    static isWiderAndTallerThan(box: CoordinateBox, other: CoordinateBox): boolean;
-    static topmostPerDepth(containers: DocumentContainer[]): DocumentContainer[];
+    static chain(candidates: DocumentContainer[]): DocumentContainer[];
+    static measureBox(documentElement: DocumentElement, documentElementsById: Map<string, DocumentElement>): CoordinateBox | null;
+    static pathFor(measured: MeasuredDocumentElement, kind: ContainerKind, containers: DocumentContainer[]): DocumentContainer[];
+    static enclosersOf(measured: MeasuredDocumentElement, containers: DocumentContainer[]): DocumentContainer[];
+    static candidatesFor(measured: MeasuredDocumentElement, containers: DocumentContainer[]): DocumentContainer[];
+    static topmost(containers: DocumentContainer[]): DocumentContainer[];
 }

package/lib/containers/document-container.js

@@ -24,9 +24,12 @@ class DocumentContainerUtil {
         var _a, _b, _c, _d, _e;
         const position = documentElement === null || documentElement === void 0 ? void 0 : documentElement.position;
         const angle = (_a = documentElement === null || documentElement === void 0 ? void 0 : documentElement.rotate) === null || _a === void 0 ? void 0 : _a.angle;
-        if (!position || !angle || !newSize || !documentElement.size) {
+        if (!position) {
             return position;
         }
+        if (!angle || !newSize || !documentElement.size) {
+            return Object.assign({}, position);
+        }
         const scaleX = (_c = (_b = documentElement.scale) === null || _b === void 0 ? void 0 : _b.x) !== null && _c !== void 0 ? _c : 1;
         const scaleY = (_e = (_d = documentElement.scale) === null || _d === void 0 ? void 0 : _d.y) !== null && _e !== void 0 ? _e : 1;
         const cornerOffset = (size) => {
@@ -36,23 +39,23 @@ class DocumentContainerUtil {
         };
         const before = cornerOffset(documentElement.size);
         const after = cornerOffset(newSize);
-        return { x: position.x + before.x - after.x, y: position.y + before.y - after.y };
+        const moved = { x: position.x + before.x - after.x, y: position.y + before.y - after.y };
+        return Number.isFinite(moved.x) && Number.isFinite(moved.y) ? moved : Object.assign({}, position);
+    }
+    static resizeKeepingAnchor(dynamicTextElement, entityType, text) {
+        const size = dynamic_text_util_1.DynamicTextUtil.calculateSize(dynamicTextElement, entityType, text);
+        return { size, position: DocumentContainerUtil.positionKeepingAnchor(dynamicTextElement, size) };
     }
     static anchorFor(documentElement, position, startElement, endElement) {
-        var _a, _b, _c, _d, _e;
         const at = position !== null && position !== void 0 ? position : documentElement === null || documentElement === void 0 ? void 0 : documentElement.position;
-        if (!at) {
-            return null;
-        }
-        const size = (_a = documentElement === null || documentElement === void 0 ? void 0 : documentElement.size) !== null && _a !== void 0 ? _a : { width: 0, height: 0 };
-        let box = DocumentContainerUtil.toCoordinateBox(at.x, at.y, size.width * ((_c = (_b = documentElement === null || documentElement === void 0 ? void 0 : documentElement.scale) === null || _b === void 0 ? void 0 : _b.x) !== null && _c !== void 0 ? _c : 1), size.height * ((_e = (_d = documentElement === null || documentElement === void 0 ? void 0 : documentElement.scale) === null || _d === void 0 ? void 0 : _d.y) !== null && _e !== void 0 ? _e : 1));
         try {
-            const measured = document_element_factory_1.DocumentElementFactory.getBoundingClientRectScaled(Object.assign(Object.assign({}, documentElement), { position: at }), startElement, endElement);
-            box = DocumentContainerUtil.toCoordinateBox(measured.x, measured.y, measured.width, measured.height);
+            const measured = document_element_factory_1.DocumentElementFactory.getBoundingClientRectScaled(at ? Object.assign(Object.assign({}, documentElement), { position: at }) : documentElement, startElement, endElement);
+            const box = DocumentContainerUtil.toCoordinateBox(measured.x, measured.y, measured.width, measured.height);
+            return DocumentContainerUtil.anchorOf(documentElement, box);
         }
-        catch (_f) {
+        catch (_a) {
+            return null;
         }
-        return DocumentContainerUtil.anchorOf(documentElement, box);
     }
     static containsPoint(box, point) {
         return point.x >= box.left && point.x <= box.right && point.y >= box.top && point.y <= box.bottom;
@@ -65,18 +68,75 @@ class DocumentContainerUtil {
             outer.bottom === inner.bottom;
         return covers && !identical;
     }
-    static isWiderAndTallerThan(box, other) {
-        return box.width > other.width && box.height > other.height;
+    static chain(candidates) {
+        if (!candidates.length) {
+            return [];
+        }
+        const topmostOf = (of) => of.reduce((topmost, container) => (container.drawOrder > topmost.drawOrder ? container : topmost));
+        const path = [topmostOf(candidates)];
+        for (;;) {
+            const current = path[0];
+            const enclosing = candidates.filter((container) => !path.includes(container) && this.encloses(container.box, current.box));
+            if (!enclosing.length) {
+                return path;
+            }
+            path.unshift(topmostOf(enclosing));
+        }
     }
-    static topmostPerDepth(containers) {
-        const byDepth = [];
-        for (const container of containers) {
-            const existing = byDepth[container.depth];
-            if (!existing || container.drawOrder > existing.drawOrder) {
-                byDepth[container.depth] = container;
+    static measureBox(documentElement, documentElementsById) {
+        var _a, _b;
+        try {
+            const start = ((_a = documentElement === null || documentElement === void 0 ? void 0 : documentElement.start) === null || _a === void 0 ? void 0 : _a.id) ? documentElementsById.get(documentElement.start.id) : undefined;
+            const end = ((_b = documentElement === null || documentElement === void 0 ? void 0 : documentElement.end) === null || _b === void 0 ? void 0 : _b.id) ? documentElementsById.get(documentElement.end.id) : undefined;
+            const { x, y, width, height } = document_element_factory_1.DocumentElementFactory.getBoundingClientRectScaled(documentElement, start, end);
+            if (!width && !height && !x && !y) {
+                return null;
             }
+            return DocumentContainerUtil.toCoordinateBox(x, y, width, height);
         }
-        return byDepth.filter(Boolean);
+        catch (_c) {
+            return null;
+        }
+    }
+    static pathFor(measured, kind, containers) {
+        if (!containers.length || !measured.box) {
+            return [];
+        }
+        if (measured.documentElement.type === kind.elementType) {
+            return kind.nests ? DocumentContainerUtil.chain(DocumentContainerUtil.enclosersOf(measured, containers)) : [];
+        }
+        const candidates = DocumentContainerUtil.candidatesFor(measured, containers);
+        return kind.nests ? DocumentContainerUtil.chain(candidates) : DocumentContainerUtil.topmost(candidates);
+    }
+    static enclosersOf(measured, containers) {
+        return containers.filter((container) => {
+            var _a;
+            return container.id !== measured.documentElement.id &&
+                DocumentContainerUtil.encloses(container.box, measured.box) &&
+                measured.drawOrder > container.drawOrder &&
+                !((_a = measured.documentElement.elementIds) === null || _a === void 0 ? void 0 : _a.includes(container.id));
+        });
+    }
+    static candidatesFor(measured, containers) {
+        const anchor = DocumentContainerUtil.anchorOf(measured.documentElement, measured.box);
+        return containers.filter((container) => {
+            var _a;
+            if (container.id === measured.documentElement.id || measured.drawOrder <= container.drawOrder) {
+                return false;
+            }
+            if (!DocumentContainerUtil.containsPoint(container.box, anchor)) {
+                return false;
+            }
+            if (DocumentContainerUtil.encloses(measured.box, container.box)) {
+                return false;
+            }
+            return !((_a = measured.documentElement.elementIds) === null || _a === void 0 ? void 0 : _a.includes(container.id));
+        });
+    }
+    static topmost(containers) {
+        return containers.length
+            ? [containers.reduce((topmost, container) => (container.drawOrder > topmost.drawOrder ? container : topmost))]
+            : [];
     }
 }
 exports.DocumentContainerUtil = DocumentContainerUtil;

package/lib/containers/document-container.service.d.ts

@@ -4,12 +4,6 @@ import { DocumentContainerIndex } from './document-container-index';
 export declare class DocumentContainerService {
     static buildIndex(documentElements: readonly DocumentElement[], kinds?: ContainerKind[]): DocumentContainerIndex;
     static isContainer(documentElement: DocumentElement, kinds?: ContainerKind[]): boolean;
-    private static inherit;
     private static measureDocumentElements;
-    private static measure;
     private static collectContainers;
-    private static resolveDirectPath;
-    private static enclosersOf;
-    private static chain;
-    private static candidateContainers;
 }

package/lib/containers/document-container.service.js

@@ -1,64 +1,63 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DocumentContainerService = void 0;
-const document_element_factory_1 = require("../document-element-factory");
-const dynamic_text_util_1 = require("../util/dynamic-text/dynamic-text-util");
-const document_element_constants_1 = require("../document-element-constants");
 const container_kind_1 = require("./container-kind");
 const document_container_index_1 = require("./document-container-index");
 const document_container_1 = require("./document-container");
 class DocumentContainerService {
     static buildIndex(documentElements, kinds = container_kind_1.CONTAINER_KINDS) {
-        var _a, _b, _c;
-        const measuredDocumentElements = this.measureDocumentElements(documentElements !== null && documentElements !== void 0 ? documentElements : []);
-        const kindsByLayer = [...kinds].sort((first, second) => second.layer - first.layer);
-        const containersByElementType = new Map(kindsByLayer.map((kind) => [kind.elementType, this.collectContainers(measuredDocumentElements, kind)]));
+        var _a, _b;
+        const elements = (documentElements !== null && documentElements !== void 0 ? documentElements : []).filter((element) => !!element);
+        const containerElementTypes = new Set(kinds.map((kind) => kind.elementType));
+        if (!elements.some((element) => containerElementTypes.has(element.type))) {
+            return document_container_index_1.DocumentContainerIndex.empty();
+        }
+        const documentElementsById = new Map(elements.map((element) => [element.id, element]));
+        const measuredDocumentElements = this.measureDocumentElements(elements, documentElementsById);
+        const containersByElementType = new Map(kinds.map((kind) => [kind.elementType, this.collectContainers(measuredDocumentElements, kind)]));
         const containersById = new Map();
         const containerIdsByElementType = new Map();
         containersByElementType.forEach((containers, elementType) => {
             containerIdsByElementType.set(elementType, containers.map((container) => container.id));
             containers.forEach((container) => containersById.set(container.id, container));
         });
-        const directPaths = new Map();
+        const pathsByMeasured = new Map();
         for (const measured of measuredDocumentElements) {
             const byElementType = new Map();
-            for (const kind of kindsByLayer) {
-                byElementType.set(kind.elementType, this.resolveDirectPath(measured, kind, (_a = containersByElementType.get(kind.elementType)) !== null && _a !== void 0 ? _a : []));
-            }
-            directPaths.set(measured, byElementType);
-        }
-        for (const measured of measuredDocumentElements) {
-            const container = containersById.get(measured.documentElement.id);
-            if (container && container.documentElement === measured.documentElement) {
-                container.depth = ((_c = (_b = directPaths.get(measured)) === null || _b === void 0 ? void 0 : _b.get(container.kind.elementType)) !== null && _c !== void 0 ? _c : []).length;
-            }
-        }
-        const measuredById = new Map();
-        for (const measured of measuredDocumentElements) {
-            if (!measuredById.has(measured.documentElement.id)) {
-                measuredById.set(measured.documentElement.id, measured);
+            for (const kind of kinds) {
+                byElementType.set(kind.elementType, document_container_1.DocumentContainerUtil.pathFor(measured, kind, (_a = containersByElementType.get(kind.elementType)) !== null && _a !== void 0 ? _a : []));
             }
+            pathsByMeasured.set(measured, byElementType);
         }
         const containerPathsByDocumentElementId = new Map();
         const memberIdsByContainerId = new Map();
+        const memberIdsSeen = new Map();
         for (const measured of measuredDocumentElements) {
             const documentElementId = measured.documentElement.id;
-            const pathsByElementType = this.inherit(measured, kindsByLayer, directPaths, measuredById, new Set());
+            const pathsByElementType = new Map();
+            ((_b = pathsByMeasured.get(measured)) !== null && _b !== void 0 ? _b : new Map()).forEach((path, elementType) => pathsByElementType.set(elementType, path.map((container) => container.id)));
             for (const path of pathsByElementType.values()) {
                 for (const containerId of path) {
-                    const members = memberIdsByContainerId.get(containerId);
-                    if (members) {
-                        members.push(documentElementId);
-                    }
-                    else {
+                    const seen = memberIdsSeen.get(containerId);
+                    if (!seen) {
+                        memberIdsSeen.set(containerId, new Set([documentElementId]));
                         memberIdsByContainerId.set(containerId, [documentElementId]);
                     }
+                    else if (!seen.has(documentElementId)) {
+                        seen.add(documentElementId);
+                        memberIdsByContainerId.get(containerId).push(documentElementId);
+                    }
                 }
             }
             containerPathsByDocumentElementId.set(documentElementId, pathsByElementType);
         }
+        const measuredById = new Map();
+        for (const measured of measuredDocumentElements) {
+            measuredById.set(measured.documentElement.id, measured);
+        }
         return new document_container_index_1.DocumentContainerIndex({
-            documentElementsById: new Map([...measuredById].map(([id, measured]) => [id, measured.documentElement])),
+            documentElementsById,
+            measuredById,
             containersById,
             containerPathsByDocumentElementId,
             memberIdsByContainerId,
@@ -68,122 +67,23 @@ class DocumentContainerService {
     static isContainer(documentElement, kinds = container_kind_1.CONTAINER_KINDS) {
         return kinds.some((kind) => kind.elementType === (documentElement === null || documentElement === void 0 ? void 0 : documentElement.type));
     }
-    static inherit(measured, kindsByLayer, directPaths, measuredById, resolving) {
-        var _a, _b, _c;
-        const direct = (_a = directPaths.get(measured)) !== null && _a !== void 0 ? _a : new Map();
-        const paths = new Map();
-        let inheritFromId = null;
-        for (const kind of kindsByLayer) {
-            if (inheritFromId && !resolving.has(inheritFromId)) {
-                const container = measuredById.get(inheritFromId);
-                const inherited = container
-                    ? this.inherit(container, kindsByLayer, directPaths, measuredById, new Set(resolving).add(inheritFromId))
-                    : null;
-                paths.set(kind.elementType, (_b = inherited === null || inherited === void 0 ? void 0 : inherited.get(kind.elementType)) !== null && _b !== void 0 ? _b : []);
-                continue;
-            }
-            const path = (_c = direct.get(kind.elementType)) !== null && _c !== void 0 ? _c : [];
-            paths.set(kind.elementType, path.map((container) => container.id));
-            if (path.length) {
-                inheritFromId = path[path.length - 1].id;
-            }
-        }
-        return paths;
-    }
-    static measureDocumentElements(documentElements) {
-        const documentElementsById = new Map(documentElements.map((documentElement) => [documentElement.id, documentElement]));
+    static measureDocumentElements(documentElements, documentElementsById) {
         return documentElements.map((documentElement, drawOrder) => ({
             documentElement,
             drawOrder,
-            box: this.measure(documentElement, documentElementsById),
+            box: document_container_1.DocumentContainerUtil.measureBox(documentElement, documentElementsById),
         }));
     }
-    static measure(documentElement, documentElementsById) {
-        var _a, _b;
-        if (!(documentElement === null || documentElement === void 0 ? void 0 : documentElement.position)) {
-            return null;
-        }
-        try {
-            const start = ((_a = documentElement.start) === null || _a === void 0 ? void 0 : _a.id) ? documentElementsById.get(documentElement.start.id) : undefined;
-            const end = ((_b = documentElement.end) === null || _b === void 0 ? void 0 : _b.id) ? documentElementsById.get(documentElement.end.id) : undefined;
-            const { x, y, width, height } = document_element_factory_1.DocumentElementFactory.getBoundingClientRectScaled(documentElement, start, end);
-            return document_container_1.DocumentContainerUtil.toCoordinateBox(x, y, width, height);
-        }
-        catch (_c) {
-            return null;
-        }
-    }
     static collectContainers(measuredDocumentElements, kind) {
         return measuredDocumentElements
             .filter((measured) => measured.documentElement.type === kind.elementType && measured.box)
             .map((measured) => ({
             id: measured.documentElement.id,
             kind,
-            name: measured.documentElement.name,
             documentElement: measured.documentElement,
             box: measured.box,
-            depth: 0,
             drawOrder: measured.drawOrder,
         }));
     }
-    static resolveDirectPath(measured, kind, containers) {
-        if (!containers.length || !measured.box) {
-            return [];
-        }
-        const ownKind = container_kind_1.CONTAINER_KINDS.find((candidate) => candidate.elementType === measured.documentElement.type);
-        if (ownKind) {
-            if (ownKind.elementType === kind.elementType) {
-                return kind.nests ? this.chain(this.enclosersOf(measured, containers)) : [];
-            }
-            if (kind.layer > ownKind.layer) {
-                return [];
-            }
-        }
-        return this.chain(this.candidateContainers(measured, containers));
-    }
-    static enclosersOf(measured, containers) {
-        return containers.filter((container) => {
-            var _a;
-            return container.documentElement !== measured.documentElement &&
-                document_container_1.DocumentContainerUtil.encloses(container.box, measured.box) &&
-                measured.drawOrder > container.drawOrder &&
-                !((_a = measured.documentElement.elementIds) === null || _a === void 0 ? void 0 : _a.includes(container.id));
-        });
-    }
-    static chain(candidates) {
-        if (!candidates.length) {
-            return [];
-        }
-        const innermostOf = (of) => of
-            .filter((container) => !of.some((other) => other !== container && document_container_1.DocumentContainerUtil.encloses(container.box, other.box)))
-            .reduce((topmost, container) => (container.drawOrder > topmost.drawOrder ? container : topmost));
-        const path = [innermostOf(candidates)];
-        for (;;) {
-            const current = path[0];
-            const enclosing = candidates.filter((container) => !path.includes(container) && document_container_1.DocumentContainerUtil.encloses(container.box, current.box));
-            if (!enclosing.length) {
-                return path;
-            }
-            path.unshift(innermostOf(enclosing));
-        }
-    }
-    static candidateContainers(measured, containers) {
-        const anchor = document_container_1.DocumentContainerUtil.anchorOf(measured.documentElement, measured.box);
-        const isShape = document_element_constants_1.SHAPE_ELEMENT_TYPES.includes(measured.documentElement.type) &&
-            !dynamic_text_util_1.DynamicTextUtil.isDynamicText(measured.documentElement);
-        return containers.filter((container) => {
-            var _a;
-            if (container.documentElement === measured.documentElement || measured.drawOrder <= container.drawOrder) {
-                return false;
-            }
-            if (!document_container_1.DocumentContainerUtil.containsPoint(container.box, anchor)) {
-                return false;
-            }
-            if (isShape && document_container_1.DocumentContainerUtil.isWiderAndTallerThan(measured.box, container.box)) {
-                return false;
-            }
-            return !((_a = measured.documentElement.elementIds) === null || _a === void 0 ? void 0 : _a.includes(container.id));
-        });
-    }
 }
 exports.DocumentContainerService = DocumentContainerService;

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

@@ -27,6 +27,8 @@ export declare enum DynamicTextDisplayFunction {
 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 function placeholderForMissingContainer(entityType: string): string;
+export declare function isPlaceholderText(text: string): boolean;
 export declare const HARD_CODED_TEXT: {
     'project.name': string;
     'project.createdBy.email': string;
@@ -53,7 +55,10 @@ export declare class DynamicTextUtil {
     static isDynamicText(documentElement: DocumentElement): boolean;
     static takesValueFromContainer(bindingProperty: string | null | undefined): boolean;
     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 calculateSize(dynamicTextElement: DocumentElement, entityType: any, text: string): {
+        width: number;
+        height: number;
+    };
     static getTextFromFrameMemberValues(displayFunction: string, property: any, memberValues: any[]): string;
     private static getItemCount;
 }

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

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 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.placeholderForMissingContainer = placeholderForMissingContainer;
+exports.isPlaceholderText = isPlaceholderText;
 exports.isContainerBinding = isContainerBinding;
 const types_1 = require("@contrail/types");
 const util_1 = require("@contrail/util");
@@ -28,6 +30,12 @@ var 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';
+function placeholderForMissingContainer(entityType) {
+    return entityType === DYNAMIC_TEXT_DATA_SOURCE.SECTION ? exports.MOVE_TO_SECTION_TEXT : exports.MOVE_TO_FRAME_TEXT;
+}
+function isPlaceholderText(text) {
+    return text === exports.MOVE_TO_FRAME_TEXT || text === exports.MOVE_TO_SECTION_TEXT || text === exports.CLICK_TO_CONFIGURE;
+}
 exports.HARD_CODED_TEXT = {
     'project.name': 'Project name',
     'project.createdBy.email': 'Project created by',
@@ -57,7 +65,9 @@ function isContainerBinding(bindingProperty) {
 class DynamicTextUtil {
     static isDynamicText(documentElement) {
         var _a;
-        return (documentElement === null || documentElement === void 0 ? void 0 : documentElement.type) === 'text' && !!((_a = documentElement.propertyBindings) === null || _a === void 0 ? void 0 : _a.text);
+        return ((documentElement === null || documentElement === void 0 ? void 0 : documentElement.type) === 'text' &&
+            !!((_a = documentElement.propertyBindings) === null || _a === void 0 ? void 0 : _a.text) &&
+            !!documentElement.propertyBindingsMetaData);
     }
     static takesValueFromContainer(bindingProperty) {
         if (!bindingProperty) {
@@ -96,7 +106,7 @@ class DynamicTextUtil {
         }
         else {
             if (!container && !isSpecRelated) {
-                text = entityType === DYNAMIC_TEXT_DATA_SOURCE.SECTION ? exports.MOVE_TO_SECTION_TEXT : exports.MOVE_TO_FRAME_TEXT;
+                text = placeholderForMissingContainer(entityType);
             }
             else {
                 if (CONTAINER_SOURCES.includes(entityType)) {
@@ -139,7 +149,7 @@ class DynamicTextUtil {
                 text = exports.HARD_CODED_TEXT[bindingProperty] || (property === null || property === void 0 ? void 0 : property.label);
             }
             else if (!container) {
-                text = exports.MOVE_TO_FRAME_TEXT;
+                text = placeholderForMissingContainer(entityType);
             }
             else {
                 text = property === null || property === void 0 ? void 0 : property.label;
@@ -149,7 +159,7 @@ class DynamicTextUtil {
             text = 'n/a';
         }
         if (displayLabel &&
-            ![exports.MOVE_TO_FRAME_TEXT, exports.CLICK_TO_CONFIGURE].includes(text) &&
+            !isPlaceholderText(text) &&
             displayFunction !== DynamicTextDisplayFunction.LABEL &&
             text !== bindingProperty) {
             text = `${exports.HARD_CODED_TEXT[bindingProperty] || (property === null || property === void 0 ? void 0 : property.label) || ''}: ${text}`;
@@ -157,16 +167,19 @@ class DynamicTextUtil {
         return text;
     }
     static calculateSize(dynamicTextElement, entityType, text) {
-        var _a, _b, _c, _d, _e;
-        let size = (_a = dynamicTextElement.size) !== null && _a !== void 0 ? _a : { width: 0, height: 0 };
-        const fontFamily = (_b = document_util_1.DocumentStyleUtil.getFirstFontFamily(dynamicTextElement === null || dynamicTextElement === void 0 ? void 0 : dynamicTextElement.text)) !== null && _b !== void 0 ? _b : document_util_1.DEFAULT_TEXT_FONT_FAMILY;
-        const fontSize = (_e = (dynamicTextElement.isTextTool
-            ? (_d = (_c = dynamicTextElement.style) === null || _c === void 0 ? void 0 : _c.font) === null || _d === void 0 ? void 0 : _d.size
-            : document_util_1.DocumentStyleUtil.getFirstFontSize(dynamicTextElement === null || dynamicTextElement === void 0 ? void 0 : dynamicTextElement.text, true))) !== null && _e !== void 0 ? _e : document_util_1.DEFAULT_TEXT_FONT_SIZE;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+        let size = {
+            width: (_b = (_a = dynamicTextElement.size) === null || _a === void 0 ? void 0 : _a.width) !== null && _b !== void 0 ? _b : 0,
+            height: (_d = (_c = dynamicTextElement.size) === null || _c === void 0 ? void 0 : _c.height) !== null && _d !== void 0 ? _d : 0,
+        };
+        const fontFamily = (_f = document_util_1.DocumentStyleUtil.getFirstFontFamily((_e = dynamicTextElement === null || dynamicTextElement === void 0 ? void 0 : dynamicTextElement.text) !== null && _e !== void 0 ? _e : '')) !== null && _f !== void 0 ? _f : document_util_1.DEFAULT_TEXT_FONT_FAMILY;
+        const fontSize = (_j = (dynamicTextElement.isTextTool
+            ? (_h = (_g = dynamicTextElement.style) === null || _g === void 0 ? void 0 : _g.font) === null || _h === void 0 ? void 0 : _h.size
+            : document_util_1.DocumentStyleUtil.getFirstFontSize(dynamicTextElement === null || dynamicTextElement === void 0 ? void 0 : dynamicTextElement.text, true))) !== null && _j !== void 0 ? _j : document_util_1.DEFAULT_TEXT_FONT_SIZE;
         const fontSizePx = document_util_1.DocumentStyleUtil.toPx(fontSize, 4);
         const padding = dynamicTextElement.isTextTool ? document_util_1.TEXT_TOOL_PADDING : document_util_1.TEXT_BOX_PADDING;
-        const bold = document_util_1.DocumentStyleUtil.isBold(dynamicTextElement === null || dynamicTextElement === void 0 ? void 0 : dynamicTextElement.text, fontFamily);
-        const italic = document_util_1.DocumentStyleUtil.isItalic(dynamicTextElement === null || dynamicTextElement === void 0 ? void 0 : dynamicTextElement.text);
+        const bold = document_util_1.DocumentStyleUtil.isBold((_k = dynamicTextElement === null || dynamicTextElement === void 0 ? void 0 : dynamicTextElement.text) !== null && _k !== void 0 ? _k : '', fontFamily);
+        const italic = document_util_1.DocumentStyleUtil.isItalic((_l = dynamicTextElement === null || dynamicTextElement === void 0 ? void 0 : dynamicTextElement.text) !== null && _l !== void 0 ? _l : '');
         const measureTextSettings = {
             fontFamily,
             fontSize: fontSizePx,
@@ -207,7 +220,7 @@ class DynamicTextUtil {
         }
         else if (displayFunction === DynamicTextDisplayFunction.UNIQUE_ARRAY) {
             text = Array.from(new Set(memberValues
-                .filter((e) => e !== null && e !== undefined)
+                .filter((e) => e !== null && e !== undefined && e !== '')
                 .flat()
                 .map((e) => formatter.formatValueForProperty(e, property))))
                 .sort()

package/package.json

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