import { Bezier } from 'bezier-js';
import { Colors } from 'browndash-components';
import { action, computed, IReactionDisposer, observable, reaction, runInAction, trace } from 'mobx';
import { observer } from 'mobx-react';
import { computedFn } from 'mobx-utils';
import { DateField } from '../../../../fields/DateField';
import { Doc, DocListCast, Opt } from '../../../../fields/Doc';
import { DocData, Height, Width } from '../../../../fields/DocSymbols';
import { Id } from '../../../../fields/FieldSymbols';
import { InkData, InkField, InkTool, PointData, Segment } from '../../../../fields/InkField';
import { List } from '../../../../fields/List';
import { RichTextField } from '../../../../fields/RichTextField';
import { listSpec } from '../../../../fields/Schema';
import { ScriptField } from '../../../../fields/ScriptField';
import { BoolCast, Cast, DocCast, FieldValue, NumCast, ScriptCast, StrCast } from '../../../../fields/Types';
import { ImageField } from '../../../../fields/URLField';
import { TraceMobx } from '../../../../fields/util';
import { GestureUtils } from '../../../../pen-gestures/GestureUtils';
import { aggregateBounds, emptyFunction, intersectRect, returnFalse, returnNone, returnTrue, returnZero, setupMoveUpEvents, Utils } from '../../../../Utils';
import { CognitiveServices } from '../../../cognitive_services/CognitiveServices';
import { Docs, DocUtils } from '../../../documents/Documents';
import { CollectionViewType, DocumentType } from '../../../documents/DocumentTypes';
import { DocumentManager } from '../../../util/DocumentManager';
import { DragManager, dropActionType } from '../../../util/DragManager';
import { InteractionUtils } from '../../../util/InteractionUtils';
import { ReplayMovements } from '../../../util/ReplayMovements';
import { ScriptingGlobals } from '../../../util/ScriptingGlobals';
import { SelectionManager } from '../../../util/SelectionManager';
import { ColorScheme, freeformScrollMode } from '../../../util/SettingsManager';
import { SnappingManager } from '../../../util/SnappingManager';
import { Transform } from '../../../util/Transform';
import { undoBatch, UndoManager } from '../../../util/UndoManager';
import { COLLECTION_BORDER_WIDTH } from '../../../views/global/globalCssVariables.scss';
import { Timeline } from '../../animationtimeline/Timeline';
import { ContextMenu } from '../../ContextMenu';
import { DocumentDecorations } from '../../DocumentDecorations';
import { GestureOverlay } from '../../GestureOverlay';
import { ActiveArrowEnd, ActiveArrowStart, ActiveDash, ActiveFillColor, ActiveInkBezierApprox, ActiveInkColor, ActiveInkWidth, ActiveIsInkMask, InkingStroke, SetActiveInkColor, SetActiveInkWidth } from '../../InkingStroke';
import { LightboxView } from '../../LightboxView';
import { CollectionFreeFormDocumentView } from '../../nodes/CollectionFreeFormDocumentView';
import { DocFocusOptions, DocumentView, DocumentViewProps, OpenWhere } from '../../nodes/DocumentView';
import { FieldViewProps } from '../../nodes/FieldView';
import { FormattedTextBox } from '../../nodes/formattedText/FormattedTextBox';
import { PinProps, PresBox } from '../../nodes/trails/PresBox';
import { CreateImage } from '../../nodes/WebBoxRenderer';
import { StyleProp } from '../../StyleProvider';
import { CollectionSubView } from '../CollectionSubView';
import { TreeViewType } from '../CollectionTreeView';
import { TabDocView } from '../TabDocView';
import { computePassLayout, computePivotLayout, computeStarburstLayout, computeTimelineLayout, PoolData, ViewDefBounds, ViewDefResult } from './CollectionFreeFormLayoutEngines';
import { CollectionFreeFormRemoteCursors } from './CollectionFreeFormRemoteCursors';
import './CollectionFreeFormView.scss';
import { MarqueeView } from './MarqueeView';
import React = require('react');

export type collectionFreeformViewProps = {
    NativeWidth?: () => number;
    NativeHeight?: () => number;
    originTopLeft?: boolean;
    annotationLayerHostsContent?: boolean; // whether to force scaling of content (needed by ImageBox)
    viewDefDivClick?: ScriptField;
    childPointerEvents?: string;
    viewField?: string;
    noOverlay?: boolean; // used to suppress docs in the overlay (z) layer (ie, for minimap since overlay doesn't scale)
    engineProps?: any;
    getScrollHeight?: () => number | undefined;
    dontRenderDocuments?: boolean; // used for annotation overlays which need to distribute documents into different freeformviews with different mixBlendModes depending on whether they are transparent or not.
    // However, this screws up interactions since only the top layer gets events.  so we render the freeformview a 3rd time with all documents in order to get interaction events (eg., marquee) but we don't actually want to display the documents.
};

@observer
export class CollectionFreeFormView extends CollectionSubView<Partial<collectionFreeformViewProps>>() {
    public get displayName() {
        return 'CollectionFreeFormView(' + this.props.Document.title?.toString() + ')';
    } // this makes mobx trace() statements more descriptive

    @observable
    public static ShowPresPaths = false;

    private _panZoomTransitionTimer: any;
    private _lastX: number = 0;
    private _lastY: number = 0;
    private _downX: number = 0;
    private _downY: number = 0;
    private _inkToTextStartX: number | undefined;
    private _inkToTextStartY: number | undefined;
    private _wordPalette: Map<string, string> = new Map<string, string>();
    private _clusterDistance: number = 75;
    private _hitCluster: number = -1;
    private _disposers: { [name: string]: IReactionDisposer } = {};
    private _renderCutoffData = observable.map<string, boolean>();
    private _layoutPoolData = observable.map<string, PoolData>();
    private _layoutSizeData = observable.map<string, { width?: number; height?: number }>();
    private _cachedPool: Map<string, PoolData> = new Map();
    private _lastTap = 0;
    private _batch: UndoManager.Batch | undefined = undefined;
    private _brushtimer: any;
    private _brushtimer1: any;

    private get isAnnotationOverlay() {
        return this.props.isAnnotationOverlay;
    }
    public get scaleFieldKey() {
        return (this.props.viewField ?? '') + '_freeform_scale';
    }
    private get panXFieldKey() {
        return (this.props.viewField ?? '') + '_freeform_panX';
    }
    private get panYFieldKey() {
        return (this.props.viewField ?? '') + '_freeform_panY';
    }
    private get borderWidth() {
        return this.isAnnotationOverlay ? 0 : COLLECTION_BORDER_WIDTH;
    }

    @observable.shallow _layoutElements: ViewDefResult[] = []; // shallow because some layout items (eg pivot labels) are just generated 'divs' and can't be frozen as observables
    @observable _panZoomTransition: number = 0; // sets the pan/zoom transform ease time- used by nudge(), focus() etc to smoothly zoom/pan.  set to 0 to use document's transition time or default of 0
    @observable _hLines: number[] | undefined;
    @observable _vLines: number[] | undefined;
    @observable _firstRender = false; // this turns off rendering of the collection's content so that there's instant feedback when a tab is switched of what content will be shown.  could be used for performance improvement
    @observable _showAnimTimeline = false;
    @observable _clusterSets: Doc[][] = [];
    @observable _deleteList: DocumentView[] = [];
    @observable _timelineRef = React.createRef<Timeline>();
    @observable _marqueeRef: HTMLDivElement | null = null;
    @observable _marqueeViewRef = React.createRef<MarqueeView>();
    @observable ChildDrag: DocumentView | undefined; // child document view being dragged.  needed to update drop areas of groups when a group item is dragged.
    @observable _brushedView = { width: 0, height: 0, panX: 0, panY: 0, opacity: 0 }; // highlighted region of freeform canvas used by presentations to indicate a region

    constructor(props: any) {
        super(props);
    }

    @computed get views() {
        const viewsMask = this._layoutElements.filter(ele => ele.bounds && !ele.bounds.z && ele.inkMask !== -1 && ele.inkMask !== undefined).map(ele => ele.ele);
        const renderableEles = this._layoutElements.filter(ele => ele.bounds && !ele.bounds.z && (ele.inkMask === -1 || ele.inkMask === undefined)).map(ele => ele.ele);
        if (viewsMask.length) renderableEles.push(<div className={`collectionfreeformview-mask${this._layoutElements.some(ele => (ele.inkMask ?? 0) > 0) ? '' : '-empty'}`}>{viewsMask}</div>);
        return renderableEles;
    }
    @computed get fitToContentVals() {
        return {
            bounds: { ...this.contentBounds, cx: (this.contentBounds.x + this.contentBounds.r) / 2, cy: (this.contentBounds.y + this.contentBounds.b) / 2 },
            scale:
                !this.childDocs.length || !Number.isFinite(this.contentBounds.b - this.contentBounds.y) || !Number.isFinite(this.contentBounds.r - this.contentBounds.x)
                    ? 1
                    : Math.min(this.props.PanelHeight() / (this.contentBounds.b - this.contentBounds.y), this.props.PanelWidth() / (this.contentBounds.r - this.contentBounds.x)),
        };
    }
    @computed get fitContentsToBox() {
        return (this.props.fitContentsToBox?.() || this.Document._freeform_fitContentsToBox) && !this.isAnnotationOverlay;
    }
    @computed get contentBounds() {
        const cb = Cast(this.rootDoc.contentBounds, listSpec('number'));
        return cb
            ? { x: cb[0], y: cb[1], r: cb[2], b: cb[3] }
            : this.props.contentBounds?.() ??
                  aggregateBounds(
                      this._layoutElements.filter(e => e.bounds && e.bounds.width && !e.bounds.z).map(e => e.bounds!),
                      NumCast(this.layoutDoc._xPadding, 10),
                      NumCast(this.layoutDoc._yPadding, 10)
                  );
    }
    @computed get nativeWidth() {
        return this.props.NativeWidth?.() || (this.fitContentsToBox ? 0 : Doc.NativeWidth(this.Document, Cast(this.Document.resolvedDataDoc, Doc, null)));
    }
    @computed get nativeHeight() {
        return this.props.NativeHeight?.() || (this.fitContentsToBox ? 0 : Doc.NativeHeight(this.Document, Cast(this.Document.resolvedDataDoc, Doc, null)));
    }
    @computed get cachedCenteringShiftX(): number {
        const scaling = this.fitContentsToBox || !this.nativeDimScaling ? 1 : this.nativeDimScaling;
        return this.props.isAnnotationOverlay || this.props.originTopLeft ? 0 : this.props.PanelWidth() / 2 / scaling; // shift so pan position is at center of window for non-overlay collections
    }
    @computed get cachedCenteringShiftY(): number {
        const dv = this.props.DocumentView?.();
        const scaling = this.fitContentsToBox || !this.nativeDimScaling ? 1 : this.nativeDimScaling;
        // if freeform has a native aspect, then the panel height needs to be adjusted to match it
        const aspect = dv?.nativeWidth && dv?.nativeHeight && !dv.layoutDoc.layout_fitWidth ? dv.nativeHeight / dv.nativeWidth : this.props.PanelHeight() / this.props.PanelWidth();
        return this.props.isAnnotationOverlay || this.props.originTopLeft ? 0 : (aspect * this.props.PanelWidth()) / 2 / scaling; // shift so pan position is at center of window for non-overlay collections
    }
    @computed get cachedGetLocalTransform(): Transform {
        return Transform.Identity()
            .scale(1 / this.zoomScaling())
            .translate(this.panX(), this.panY());
    }
    @computed get cachedGetContainerTransform(): Transform {
        return this.props.ScreenToLocalTransform().translate(-this.borderWidth, -this.borderWidth);
    }
    @computed get cachedGetTransform(): Transform {
        return this.getContainerTransform().translate(-this.cachedCenteringShiftX, -this.cachedCenteringShiftY).transform(this.cachedGetLocalTransform);
    }

    public static gotoKeyframe(timer: NodeJS.Timeout | undefined, docs: Doc[], duration: number) {
        if (timer) clearTimeout(timer);
        return DocumentView.SetViewTransition(docs, 'all', duration, undefined, true);
    }
    public static updateKeyframe(timer: NodeJS.Timeout | undefined, docs: Doc[], time: number) {
        if (timer) clearTimeout(timer);
        const newTimer = DocumentView.SetViewTransition(docs, 'all', 1000, undefined, true);
        const timecode = Math.round(time);
        docs.forEach(doc => {
            CollectionFreeFormDocumentView.animFields.forEach(val => {
                const findexed = Cast(doc[`${val.key}-indexed`], listSpec('number'), null);
                findexed?.length <= timecode + 1 && findexed.push(undefined as any as number);
            });
            CollectionFreeFormDocumentView.animStringFields.forEach(val => {
                const findexed = Cast(doc[`${val}-indexed`], listSpec('string'), null);
                findexed?.length <= timecode + 1 && findexed.push(undefined as any as string);
            });
            CollectionFreeFormDocumentView.animDataFields(doc).forEach(val => {
                const findexed = Cast(doc[`${val}-indexed`], listSpec(InkField), null);
                findexed?.length <= timecode + 1 && findexed.push(undefined as any);
            });
        });
        return newTimer;
    }

    _keyTimer: NodeJS.Timeout | undefined; // timer for turning off transition flag when key frame change has completed.  Need to clear this if you do a second navigation before first finishes, or else first timer can go off during second naviation.
    changeKeyFrame = (back = false) => {
        const currentFrame = Cast(this.Document._currentFrame, 'number', null);
        if (currentFrame === undefined) {
            this.Document._currentFrame = 0;
            CollectionFreeFormDocumentView.setupKeyframes(this.childDocs, 0);
        }
        if (back) {
            this._keyTimer = CollectionFreeFormView.gotoKeyframe(this._keyTimer, [...this.childDocs, this.layoutDoc], 1000);
            this.Document._currentFrame = Math.max(0, (currentFrame || 0) - 1);
        } else {
            this._keyTimer = CollectionFreeFormView.updateKeyframe(this._keyTimer, [...this.childDocs, this.layoutDoc], currentFrame || 0);
            this.Document._currentFrame = Math.max(0, (currentFrame || 0) + 1);
            this.Document.lastFrame = Math.max(NumCast(this.Document._currentFrame), NumCast(this.Document.lastFrame));
        }
    };
    @observable _keyframeEditing = false;
    @action setKeyFrameEditing = (set: boolean) => (this._keyframeEditing = set);
    getKeyFrameEditing = () => this._keyframeEditing;
    onBrowseClickHandler = () => this.props.onBrowseClick?.() || ScriptCast(this.layoutDoc.onBrowseClick);
    onChildClickHandler = () => this.props.childClickScript || ScriptCast(this.Document.onChildClick);
    onChildDoubleClickHandler = () => this.props.childDoubleClickScript || ScriptCast(this.Document.onChildDoubleClick);
    elementFunc = () => this._layoutElements;
    fitContentOnce = () => {
        if (this.props.DocumentView?.().nativeWidth) return;
        const vals = this.fitToContentVals;
        this.layoutDoc._freeform_panX = vals.bounds.cx;
        this.layoutDoc._freeform_panY = vals.bounds.cy;
        this.layoutDoc._freeform_scale = vals.scale;
    };
    freeformData = (force?: boolean) => (!this._firstRender && (this.fitContentsToBox || force) ? this.fitToContentVals : undefined);
    reverseNativeScaling = () => (this.fitContentsToBox ? true : false);
    // freeform_panx, freeform_pany, freeform_scale all attempt to get values first from the layout controller, then from the layout/dataDoc (or template layout doc), and finally from the resolved template data document.
    // this search order, for example, allows icons of cropped images to find the panx/pany/zoom on the cropped image's data doc instead of the usual layout doc because the zoom/panX/panY define the cropped image
    panX = () => this.freeformData()?.bounds.cx ?? NumCast(this.Document[this.panXFieldKey], NumCast(Cast(this.Document.resolvedDataDoc, Doc, null)?.freeform_panX, 1));
    panY = () => this.freeformData()?.bounds.cy ?? NumCast(this.Document[this.panYFieldKey], NumCast(Cast(this.Document.resolvedDataDoc, Doc, null)?.freeform_panY, 1));
    zoomScaling = () => this.freeformData()?.scale ?? NumCast(Doc.Layout(this.Document)[this.scaleFieldKey], NumCast(Cast(this.Document.resolvedDataDoc, Doc, null)?.[this.scaleFieldKey], 1));
    contentTransform = () =>
        this.props.isAnnotationOverlay && this.zoomScaling() === 1 ? `` : `translate(${this.cachedCenteringShiftX}px, ${this.cachedCenteringShiftY}px) scale(${this.zoomScaling()}) translate(${-this.panX()}px, ${-this.panY()}px)`;
    getTransform = () => this.cachedGetTransform.copy();
    getLocalTransform = () => this.cachedGetLocalTransform.copy();
    getContainerTransform = () => this.cachedGetContainerTransform.copy();
    getActiveDocuments = () => this.childLayoutPairs.filter(pair => this.isCurrent(pair.layout)).map(pair => pair.layout);
    isAnyChildContentActive = () => this.props.isAnyChildContentActive();
    addLiveTextBox = (newBox: Doc) => {
        FormattedTextBox.SelectOnLoad = newBox[Id]; // track the new text box so we can give it a prop that tells it to focus itself when it's displayed
        this.addDocument(newBox);
    };
    selectDocuments = (docs: Doc[]) => {
        SelectionManager.DeselectAll();
        docs.map(doc => DocumentManager.Instance.getDocumentView(doc, this.props.DocumentView?.())).map(dv => dv && SelectionManager.SelectView(dv, true));
    };
    addDocument = (newBox: Doc | Doc[]) => {
        let retVal = false;
        if (newBox instanceof Doc) {
            if ((retVal = this.props.addDocument?.(newBox) || false)) {
                this.bringToFront(newBox);
                this.updateCluster(newBox);
            }
        } else {
            retVal = this.props.addDocument?.(newBox) || false;
            // bcz: deal with clusters
        }
        if (retVal) {
            const newBoxes = newBox instanceof Doc ? [newBox] : newBox;
            for (const newBox of newBoxes) {
                if (newBox.activeFrame !== undefined) {
                    const vals = CollectionFreeFormDocumentView.animFields.map(field => newBox[field.key]);
                    CollectionFreeFormDocumentView.animFields.forEach(field => delete newBox[`${field.key}-indexed`]);
                    CollectionFreeFormDocumentView.animFields.forEach(field => delete newBox[field.key]);
                    delete newBox.activeFrame;
                    CollectionFreeFormDocumentView.animFields.forEach((field, i) => field.key !== 'opacity' && (newBox[field.key] = vals[i]));
                }
            }
            if (this.Document._currentFrame !== undefined && !this.props.isAnnotationOverlay) {
                CollectionFreeFormDocumentView.setupKeyframes(newBoxes, NumCast(this.Document._currentFrame), true);
            }
        }
        return retVal;
    };

    isCurrent(doc: Doc) {
        const dispTime = NumCast(doc._timecodeToShow, -1);
        const endTime = NumCast(doc._timecodeToHide, dispTime + 1.5);
        const curTime = NumCast(this.Document._layout_currentTimecode, -1);
        return dispTime === -1 || curTime === -1 || (curTime - dispTime >= -1e-4 && curTime <= endTime);
    }

    groupFocus = (anchor: Doc, options: DocFocusOptions) => {
        options.docTransform = new Transform(-NumCast(this.rootDoc[this.panXFieldKey]) + NumCast(anchor.x), -NumCast(this.rootDoc[this.panYFieldKey]) + NumCast(anchor.y), 1);
        const res = this.props.focus(this.rootDoc, options);
        options.docTransform = undefined;
        return res;
    };

    focus = (anchor: Doc, options: DocFocusOptions) => {
        if (this._lightboxDoc) return;
        const xfToCollection = options?.docTransform ?? Transform.Identity();
        const savedState = { panX: NumCast(this.Document[this.panXFieldKey]), panY: NumCast(this.Document[this.panYFieldKey]), scale: options?.willZoomCentered ? this.Document[this.scaleFieldKey] : undefined };
        const cantTransform = this.fitContentsToBox || ((this.rootDoc._isGroup || this.layoutDoc._lockedTransform) && !LightboxView.LightboxDoc);
        const { panX, panY, scale } = cantTransform || (!options.willPan && !options.willZoomCentered) ? savedState : this.calculatePanIntoView(anchor, xfToCollection, options?.willZoomCentered ? options?.zoomScale ?? 0.75 : undefined);

        // focus on the document in the collection
        const didMove = !cantTransform && !anchor.z && (panX !== savedState.panX || panY !== savedState.panY || scale !== savedState.scale);
        if (didMove) options.didMove = true;
        // glr: freeform transform speed can be set by adjusting presentation_transition field - needs a way of knowing when presentation is not active...
        if (didMove) {
            const focusTime = options?.instant ? 0 : options.zoomTime ?? 500;
            (options.zoomScale ?? options.willZoomCentered) && scale && (this.Document[this.scaleFieldKey] = scale);
            this.setPan(panX, panY, focusTime, true); // docs that are floating in their collection can't be panned to from their collection -- need to propagate the pan to a parent freeform somehow
            return focusTime;
        }
    };

    getView = async (doc: Doc): Promise<Opt<DocumentView>> => {
        return new Promise<Opt<DocumentView>>(res => {
            if (doc.hidden && this._lightboxDoc !== doc) doc.hidden = false;
            const findDoc = (finish: (dv: DocumentView) => void) => DocumentManager.Instance.AddViewRenderedCb(doc, dv => finish(dv));
            findDoc(dv => res(dv));
        });
    };

    @action
    internalDocDrop(e: Event, de: DragManager.DropEvent, docDragData: DragManager.DocumentDragData, xp: number, yp: number) {
        if (!de.embedKey && !this.ChildDrag && this.rootDoc._isGroup) return false;
        if (!super.onInternalDrop(e, de)) return false;
        const refDoc = docDragData.droppedDocuments[0];
        const [xpo, ypo] = this.getContainerTransform().transformPoint(de.x, de.y);
        const z = NumCast(refDoc.z);
        const x = (z ? xpo : xp) - docDragData.offset[0];
        const y = (z ? ypo : yp) - docDragData.offset[1];
        const zsorted = this.childLayoutPairs
            .map(pair => pair.layout)
            .slice()
            .sort((doc1, doc2) => NumCast(doc1.zIndex) - NumCast(doc2.zIndex));
        zsorted.forEach((doc, index) => (doc.zIndex = doc.stroke_isInkMask ? 5000 : index + 1));
        const dvals = CollectionFreeFormDocumentView.getValues(refDoc, NumCast(refDoc.activeFrame, 1000));
        const dropPos = this.Document._currentFrame !== undefined ? [NumCast(dvals.x), NumCast(dvals.y)] : [NumCast(refDoc.x), NumCast(refDoc.y)];

        for (let i = 0; i < docDragData.droppedDocuments.length; i++) {
            const d = docDragData.droppedDocuments[i];
            const layoutDoc = Doc.Layout(d);
            if (this.Document._currentFrame !== undefined) {
                CollectionFreeFormDocumentView.setupKeyframes([d], NumCast(this.Document._currentFrame), false);
                const pvals = CollectionFreeFormDocumentView.getValues(d, NumCast(d.activeFrame, 1000)); // get filled in values (uses defaults when not value is specified) for position
                const vals = CollectionFreeFormDocumentView.getValues(d, NumCast(d.activeFrame, 1000), false); // get non-default values for everything else
                vals.x = x + NumCast(pvals.x) - dropPos[0];
                vals.y = y + NumCast(pvals.y) - dropPos[1];
                CollectionFreeFormDocumentView.setValues(NumCast(this.Document._currentFrame), d, vals);
            } else {
                d.x = x + NumCast(d.x) - dropPos[0];
                d.y = y + NumCast(d.y) - dropPos[1];
            }
            d._layout_modificationDate = new DateField();
            const nd = [Doc.NativeWidth(layoutDoc), Doc.NativeHeight(layoutDoc)];
            layoutDoc._width = NumCast(layoutDoc._width, 300);
            layoutDoc._height = NumCast(layoutDoc._height, nd[0] && nd[1] ? (nd[1] / nd[0]) * NumCast(layoutDoc._width) : 300);
            (d._raiseWhenDragged === undefined ? DragManager.GetRaiseWhenDragged() : d._raiseWhenDragged) && (d.zIndex = zsorted.length + 1 + i); // bringToFront
        }

        if (this.layoutDoc._autoArrange || de.metaKey) {
            const sorted = this.childLayoutPairs.slice().sort((a, b) => NumCast(a.layout.y) - NumCast(b.layout.y));
            sorted.splice(
                sorted.findIndex(pair => pair.layout === refDoc),
                1
            );
            if (sorted.length && refDoc && NumCast(sorted[0].layout.y) < NumCast(refDoc.y)) {
                const topIndexed = NumCast(refDoc.y) < NumCast(sorted[0].layout.y) + NumCast(sorted[0].layout._height) / 2;
                const deltay = sorted.length > 1 ? NumCast(refDoc.y) - (NumCast(sorted[0].layout.y) + (topIndexed ? 0 : NumCast(sorted[0].layout._height))) : 0;
                const deltax = sorted.length > 1 ? NumCast(refDoc.x) - NumCast(sorted[0].layout.x) : 0;

                let lastx = NumCast(refDoc.x);
                let lasty = NumCast(refDoc.y) + (topIndexed ? 0 : NumCast(refDoc._height));
                runInAction(() =>
                    sorted.slice(1).forEach((pair, i) => {
                        lastx = pair.layout.x = lastx + deltax;
                        lasty = (pair.layout.y = lasty + deltay) + (topIndexed ? 0 : NumCast(pair.layout._height));
                    })
                );
            }
        }

        (docDragData.droppedDocuments.length === 1 || de.shiftKey) && this.updateClusterDocs(docDragData.droppedDocuments);
        return true;
    }

    @undoBatch
    internalAnchorAnnoDrop(e: Event, annoDragData: DragManager.AnchorAnnoDragData, xp: number, yp: number) {
        const dropCreator = annoDragData.dropDocCreator;
        annoDragData.dropDocCreator = (annotationOn: Doc | undefined) => {
            const dropDoc = dropCreator(annotationOn);
            if (dropDoc) {
                dropDoc.x = xp - annoDragData.offset[0];
                dropDoc.y = yp - annoDragData.offset[1];
                this.bringToFront(dropDoc);
            }
            return dropDoc || this.rootDoc;
        };
        return true;
    }

    @undoBatch
    internalLinkDrop(e: Event, de: DragManager.DropEvent, linkDragData: DragManager.LinkDragData, xp: number, yp: number) {
        if (linkDragData.linkDragView.props.docViewPath().includes(this.props.docViewPath().lastElement())) {
            let added = false;
            //  do nothing if link is dropped into any freeform view parent of dragged document
            if (!linkDragData.dragDocument.embedContainer || linkDragData.dragDocument.embedContainer !== this.rootDoc) {
                const source = Docs.Create.TextDocument('', { _width: 200, _height: 75, x: xp, y: yp, title: 'dropped annotation' });
                added = this.props.addDocument?.(source) ? true : false;
                de.complete.linkDocument = DocUtils.MakeLink(linkDragData.linkSourceGetAnchor(), source, { link_relationship: 'annotated by:annotation of' }); // TODODO this is where in text links get passed
            }
            e.stopPropagation();
            !added && e.preventDefault();
            return added;
        }
        return false;
    }

    onInternalDrop = (e: Event, de: DragManager.DropEvent) => {
        const [xp, yp] = this.getTransform().transformPoint(de.x, de.y);
        if (de.complete.annoDragData?.dragDocument && super.onInternalDrop(e, de)) return this.internalAnchorAnnoDrop(e, de.complete.annoDragData, xp, yp);
        else if (de.complete.linkDragData) return this.internalLinkDrop(e, de, de.complete.linkDragData, xp, yp);
        else if (de.complete.docDragData?.droppedDocuments.length) return this.internalDocDrop(e, de, de.complete.docDragData, xp, yp);
        return false;
    };

    onExternalDrop = (e: React.DragEvent) => {
        return (pt => super.onExternalDrop(e, { x: pt[0], y: pt[1] }))(this.getTransform().transformPoint(e.pageX, e.pageY));
    };

    pickCluster(probe: number[]) {
        return this.childLayoutPairs
            .map(pair => pair.layout)
            .reduce((cluster, cd) => {
                const grouping = this.props.Document._freeform_useClusters ? NumCast(cd.layout_cluster, -1) : NumCast(cd.group, -1);
                if (grouping !== -1) {
                    const layoutDoc = Doc.Layout(cd);
                    const cx = NumCast(cd.x) - this._clusterDistance / 2;
                    const cy = NumCast(cd.y) - this._clusterDistance / 2;
                    const cw = NumCast(layoutDoc._width) + this._clusterDistance;
                    const ch = NumCast(layoutDoc._height) + this._clusterDistance;
                    return !layoutDoc.z && intersectRect({ left: cx, top: cy, width: cw, height: ch }, { left: probe[0], top: probe[1], width: 1, height: 1 }) ? grouping : cluster;
                }
                return cluster;
            }, -1);
    }

    tryDragCluster(e: PointerEvent | TouchEvent, cluster: number) {
        if (cluster !== -1) {
            const ptsParent = e instanceof PointerEvent ? e : e.targetTouches.item(0);
            if (ptsParent) {
                const eles = this.childLayoutPairs.map(pair => pair.layout).filter(cd => (this.props.Document._freeform_useClusters ? NumCast(cd.layout_cluster) : NumCast(cd.group, -1)) === cluster);
                const clusterDocs = eles.map(ele => DocumentManager.Instance.getDocumentView(ele, this.props.DocumentView?.())!);
                const { left, top } = clusterDocs[0].getBounds() || { left: 0, top: 0 };
                const de = new DragManager.DocumentDragData(eles, e.ctrlKey || e.altKey ? 'embed' : undefined);
                de.moveDocument = this.props.moveDocument;
                de.offset = this.getTransform().transformDirection(ptsParent.clientX - left, ptsParent.clientY - top);
                DragManager.StartDocumentDrag(
                    clusterDocs.map(v => v.ContentDiv!),
                    de,
                    ptsParent.clientX,
                    ptsParent.clientY,
                    { hideSource: !de.dropAction }
                );
                return true;
            }
        }

        return false;
    }

    @action
    updateClusters(_freeform_useClusters: boolean) {
        this.props.Document._freeform_useClusters = _freeform_useClusters;
        this._clusterSets.length = 0;
        this.childLayoutPairs.map(pair => pair.layout).map(c => this.updateCluster(c));
    }

    @action
    updateClusterDocs(docs: Doc[]) {
        const childLayouts = this.childLayoutPairs.map(pair => pair.layout);
        if (this.props.Document._freeform_useClusters) {
            const docFirst = docs[0];
            docs.map(doc => this._clusterSets.map(set => Doc.IndexOf(doc, set) !== -1 && set.splice(Doc.IndexOf(doc, set), 1)));
            const preferredInd = NumCast(docFirst.layout_cluster);
            docs.map(doc => (doc.layout_cluster = -1));
            docs.map(doc =>
                this._clusterSets.map((set, i) =>
                    set.map(member => {
                        if (docFirst.layout_cluster === -1 && Doc.IndexOf(member, childLayouts) !== -1 && Doc.overlapping(doc, member, this._clusterDistance)) {
                            docFirst.layout_cluster = i;
                        }
                    })
                )
            );
            if (
                docFirst.layout_cluster === -1 &&
                preferredInd !== -1 &&
                this._clusterSets.length > preferredInd &&
                (!this._clusterSets[preferredInd] || !this._clusterSets[preferredInd].filter(member => Doc.IndexOf(member, childLayouts) !== -1).length)
            ) {
                docFirst.layout_cluster = preferredInd;
            }
            this._clusterSets.map((set, i) => {
                if (docFirst.layout_cluster === -1 && !set.filter(member => Doc.IndexOf(member, childLayouts) !== -1).length) {
                    docFirst.layout_cluster = i;
                }
            });
            if (docFirst.layout_cluster === -1) {
                docs.map(doc => {
                    doc.layout_cluster = this._clusterSets.length;
                    this._clusterSets.push([doc]);
                });
            } else if (this._clusterSets.length) {
                for (let i = this._clusterSets.length; i <= NumCast(docFirst.layout_cluster); i++) !this._clusterSets[i] && this._clusterSets.push([]);
                docs.map(doc => this._clusterSets[(doc.layout_cluster = NumCast(docFirst.layout_cluster))].push(doc));
            }
            childLayouts.map(child => !this._clusterSets.some((set, i) => Doc.IndexOf(child, set) !== -1 && child.layout_cluster === i) && this.updateCluster(child));
        }
    }

    @action
    updateCluster(doc: Doc) {
        const childLayouts = this.childLayoutPairs.map(pair => pair.layout);
        if (this.props.Document._freeform_useClusters) {
            this._clusterSets.forEach(set => Doc.IndexOf(doc, set) !== -1 && set.splice(Doc.IndexOf(doc, set), 1));
            const preferredInd = NumCast(doc.layout_cluster);
            doc.layout_cluster = -1;
            this._clusterSets.forEach((set, i) =>
                set.forEach(member => {
                    if (doc.layout_cluster === -1 && Doc.IndexOf(member, childLayouts) !== -1 && Doc.overlapping(doc, member, this._clusterDistance)) {
                        doc.layout_cluster = i;
                    }
                })
            );
            if (doc.layout_cluster === -1 && preferredInd !== -1 && this._clusterSets.length > preferredInd && (!this._clusterSets[preferredInd] || !this._clusterSets[preferredInd].filter(member => Doc.IndexOf(member, childLayouts) !== -1).length)) {
                doc.layout_cluster = preferredInd;
            }
            this._clusterSets.forEach((set, i) => {
                if (doc.layout_cluster === -1 && !set.filter(member => Doc.IndexOf(member, childLayouts) !== -1).length) {
                    doc.layout_cluster = i;
                }
            });
            if (doc.layout_cluster === -1) {
                doc.layout_cluster = this._clusterSets.length;
                this._clusterSets.push([doc]);
            } else if (this._clusterSets.length) {
                for (let i = this._clusterSets.length; i <= doc.layout_cluster; i++) !this._clusterSets[i] && this._clusterSets.push([]);
                this._clusterSets[doc.layout_cluster ?? 0].push(doc);
            }
        }
    }

    getClusterColor = (doc: Opt<Doc>, props: Opt<DocumentViewProps>, property: string) => {
        let styleProp = this.props.styleProvider?.(doc, props, property); // bcz: check 'props'  used to be renderDepth + 1
        switch (property) {
            case StyleProp.BackgroundColor:
                const cluster = NumCast(doc?.layout_cluster);
                if (this.Document._freeform_useClusters && doc?.type !== DocumentType.IMG) {
                    if (this._clusterSets.length <= cluster) {
                        setTimeout(() => doc && this.updateCluster(doc));
                    } else {
                        // choose a cluster color from a palette
                        const colors = ['#da42429e', '#31ea318c', 'rgba(197, 87, 20, 0.55)', '#4a7ae2c4', 'rgba(216, 9, 255, 0.5)', '#ff7601', '#1dffff', 'yellow', 'rgba(27, 130, 49, 0.55)', 'rgba(0, 0, 0, 0.268)'];
                        styleProp = colors[cluster % colors.length];
                        const set = this._clusterSets[cluster]?.filter(s => s.backgroundColor);
                        // override the cluster color with an explicitly set color on a non-background document.  then override that with an explicitly set color on a background document
                        set?.map(s => (styleProp = StrCast(s.backgroundColor)));
                    }
                }
                break;
            case StyleProp.FillColor:
                if (doc && this.Document._currentFrame !== undefined) {
                    return CollectionFreeFormDocumentView.getStringValues(doc, NumCast(this.Document._currentFrame))?.fillColor;
                }
        }
        return styleProp;
    };

    trySelectCluster = (addToSel: boolean) => {
        if (this._hitCluster !== -1) {
            !addToSel && SelectionManager.DeselectAll();
            const eles = this.childLayoutPairs.map(pair => pair.layout).filter(cd => (this.props.Document._freeform_useClusters ? NumCast(cd.layout_cluster) : NumCast(cd.group, -1)) === this._hitCluster);
            this.selectDocuments(eles);
            return true;
        }
        return false;
    };

    @action
    onPenUp = (e: PointerEvent): void => {
        if (!InteractionUtils.IsType(e, InteractionUtils.TOUCHTYPE)) {
            document.removeEventListener('pointerup', this.onPenUp);
            const currentCol = DocListCast(this.rootDoc.currentInkDoc);
            const rootDocList = DocListCast(this.rootDoc.data);
            currentCol.push(rootDocList[rootDocList.length - 1]);

            this._batch?.end();
        }
    };

    @action
    onPointerDown = (e: React.PointerEvent): void => {
        this._downX = this._lastX = e.pageX;
        this._downY = this._lastY = e.pageY;
        if (e.button === 0 && !e.altKey && !e.ctrlKey && this.props.isContentActive(true)) {
            if (
                !this.props.Document._isGroup && // group freeforms don't pan when dragged -- instead let the event go through to allow the group itself to drag
                !InteractionUtils.IsType(e, InteractionUtils.TOUCHTYPE) &&
                !InteractionUtils.IsType(e, InteractionUtils.PENTYPE)
            ) {
                // prettier-ignore
                switch (Doc.ActiveTool) {
                    case InkTool.Highlighter:  break;
                    case InkTool.Write: break;
                    case InkTool.Pen:  break; // the GestureOverlay handles ink stroke input -- either as gestures, or drying as ink strokes that are added to document views
                    case InkTool.Eraser:
                        this._batch = UndoManager.StartBatch('collectionErase');
                        setupMoveUpEvents(this, e, this.onEraserMove, this.onEraserUp, emptyFunction);
                        break;
                    case InkTool.None:
                        if (!(this.props.layoutEngine?.() || StrCast(this.layoutDoc._layoutEngine))) {
                            this._hitCluster = this.pickCluster(this.getTransform().transformPoint(e.clientX, e.clientY));
                            setupMoveUpEvents(this, e, this.onPointerMove, emptyFunction, emptyFunction, this._hitCluster !== -1 ? true : false, false);
                        }
                        break;
                }
            }
        }
    };

    @action
    handle1PointerDown = (e: React.TouchEvent, me: InteractionUtils.MultiTouchEvent<React.TouchEvent>) => {
        // const myTouches = InteractionUtils.GetMyTargetTouches(me, this.prevPoints, true);
        const pt = me.changedTouches[0];
        if (pt) {
            this._hitCluster = this.pickCluster(this.getTransform().transformPoint(pt.clientX, pt.clientY));
            if (!e.shiftKey && !e.altKey && !e.ctrlKey && this.props.isContentActive(true)) {
                this.removeMoveListeners();
                this.addMoveListeners();
                this.removeEndListeners();
                this.addEndListeners();
                if (Doc.ActiveTool === InkTool.None) {
                    this._lastX = pt.pageX;
                    this._lastY = pt.pageY;
                    e.preventDefault();
                    e.stopPropagation();
                } else {
                    e.preventDefault();
                }
            }
        }
    };

    public unprocessedDocs: Doc[] = [];
    public static collectionsWithUnprocessedInk = new Set<CollectionFreeFormView>();
    @undoBatch
    onGesture = (e: Event, ge: GestureUtils.GestureEvent) => {
        switch (ge.gesture) {
            default:
            case GestureUtils.Gestures.Line:
            case GestureUtils.Gestures.Circle:
            case GestureUtils.Gestures.Rectangle:
            case GestureUtils.Gestures.Triangle:
            case GestureUtils.Gestures.Stroke:
                const points = ge.points;
                const B = this.getTransform().transformBounds(ge.bounds.left, ge.bounds.top, ge.bounds.width, ge.bounds.height);
                console.log(ge.bounds.left, ge.bounds.top, ge.bounds.width, ge.bounds.height);
                const inkDoc = Docs.Create.InkDocument(
                    ActiveInkColor(),
                    ActiveInkWidth() * this.props.ScreenToLocalTransform().Scale,
                    ActiveInkBezierApprox(),
                    ActiveFillColor(),
                    ActiveArrowStart(),
                    ActiveArrowEnd(),
                    ActiveDash(),
                    points,
                    ActiveIsInkMask(),
                    {
                        title: 'ink stroke',
                        x: B.x - (ActiveInkWidth() * this.props.ScreenToLocalTransform().Scale) / 2,
                        y: B.y - (ActiveInkWidth() * this.props.ScreenToLocalTransform().Scale) / 2,
                        _width: B.width + ActiveInkWidth() * this.props.ScreenToLocalTransform().Scale,
                        _height: B.height + ActiveInkWidth() * this.props.ScreenToLocalTransform().Scale,
                    }
                );
                if (Doc.ActiveTool === InkTool.Write) {
                    this.unprocessedDocs.push(inkDoc);
                    CollectionFreeFormView.collectionsWithUnprocessedInk.add(this);
                }
                this.addDocument(inkDoc);
                e.stopPropagation();
                break;
            case GestureUtils.Gestures.Rectangle:
                if (this._inkToTextStartX && this._inkToTextStartY) {
                    const end = this.getTransform().transformPoint(Math.max(...ge.points.map(p => p.X)), Math.max(...ge.points.map(p => p.Y)));
                    const setDocs = this.getActiveDocuments().filter(s => DocCast(s.proto)?.type === DocumentType.RTF && s.color);
                    const sets = setDocs.map(sd => {
                        return Cast(sd.text, RichTextField)?.Text as string;
                    });
                    if (sets.length && sets[0]) {
                        this._wordPalette.clear();
                        const colors = setDocs.map(sd => FieldValue(sd.color) as string);
                        sets.forEach((st: string, i: number) => st.split(',').forEach(word => this._wordPalette.set(word, colors[i])));
                    }
                    const inks = this.getActiveDocuments().filter(doc => {
                        if (doc.type === 'ink') {
                            const l = NumCast(doc.x);
                            const r = l + doc[Width]();
                            const t = NumCast(doc.y);
                            const b = t + doc[Height]();
                            const pass = !(this._inkToTextStartX! > r || end[0] < l || this._inkToTextStartY! > b || end[1] < t);
                            return pass;
                        }
                        return false;
                    });
                    // const inkFields = inks.map(i => Cast(i.data, InkField));
                    const strokes: InkData[] = [];
                    inks.forEach(i => {
                        const d = Cast(i.data, InkField);
                        const x = NumCast(i.x);
                        const y = NumCast(i.y);
                        const left = Math.min(...(d?.inkData.map(pd => pd.X) ?? [0]));
                        const top = Math.min(...(d?.inkData.map(pd => pd.Y) ?? [0]));
                        if (d) {
                            strokes.push(d.inkData.map(pd => ({ X: pd.X + x - left, Y: pd.Y + y - top })));
                        }
                    });

                    CognitiveServices.Inking.Appliers.InterpretStrokes(strokes).then(results => {
                        const wordResults = results.filter((r: any) => r.category === 'inkWord');
                        for (const word of wordResults) {
                            const indices: number[] = word.strokeIds;
                            indices.forEach(i => {
                                const otherInks: Doc[] = [];
                                indices.forEach(i2 => i2 !== i && otherInks.push(inks[i2]));
                                inks[i].relatedInks = new List<Doc>(otherInks);
                                const uniqueColors: string[] = [];
                                Array.from(this._wordPalette.values()).forEach(c => uniqueColors.indexOf(c) === -1 && uniqueColors.push(c));
                                inks[i].alternativeColors = new List<string>(uniqueColors);
                                if (this._wordPalette.has(word.recognizedText.toLowerCase())) {
                                    inks[i].color = this._wordPalette.get(word.recognizedText.toLowerCase());
                                } else if (word.alternates) {
                                    for (const alt of word.alternates) {
                                        if (this._wordPalette.has(alt.recognizedString.toLowerCase())) {
                                            inks[i].color = this._wordPalette.get(alt.recognizedString.toLowerCase());
                                            break;
                                        }
                                    }
                                }
                            });
                        }
                    });
                    this._inkToTextStartX = end[0];
                }
                break;
            case GestureUtils.Gestures.Text:
                if (ge.text) {
                    const B = this.getTransform().transformPoint(ge.points[0].X, ge.points[0].Y);
                    this.addDocument(Docs.Create.TextDocument(ge.text, { title: ge.text, x: B[0], y: B[1] }));
                    e.stopPropagation();
                }
        }
    };
    @action
    onEraserUp = (e: PointerEvent): void => {
        this._deleteList.forEach(ink => ink.props.removeDocument?.(ink.rootDoc));
        this._deleteList = [];
        this._batch?.end();
    };

    @action
    onClick = (e: React.MouseEvent) => {
        if (this._lightboxDoc) this._lightboxDoc = undefined;
        if (this.onBrowseClickHandler()) {
            if (this.props.DocumentView?.()) {
                this.onBrowseClickHandler().script.run({ documentView: this.props.DocumentView(), clientX: e.clientX, clientY: e.clientY });
            }
            e.stopPropagation();
            e.preventDefault();
        } else if (Math.abs(e.pageX - this._downX) < 3 && Math.abs(e.pageY - this._downY) < 3) {
            if (e.shiftKey && (this.props.renderDepth === 0 || this.isContentActive())) {
                if (Date.now() - this._lastTap < 300) {
                    // reset zoom of freeform view to 1-to-1 on a shift + double click
                    this.zoomSmoothlyAboutPt(this.getTransform().transformPoint(e.clientX, e.clientY), 1);
                }
                e.stopPropagation();
                e.preventDefault();
            }
            this._lastTap = Date.now();
        }
    };

    @action
    scrollPan = (e: WheelEvent | { deltaX: number; deltaY: number }): void => {
        PresBox.Instance?.pauseAutoPres();
        const dx = e.deltaX;
        const dy = e.deltaY;
        this.setPan(NumCast(this.Document[this.panXFieldKey]) - dx, NumCast(this.Document[this.panYFieldKey]) - dy, 0, true);
    };

    @action
    pan = (e: PointerEvent | React.Touch | { clientX: number; clientY: number }): void => {
        PresBox.Instance?.pauseAutoPres();
        this.props.DocumentView?.().clearViewTransition();
        const [dx, dy] = this.getTransform().transformDirection(e.clientX - this._lastX, e.clientY - this._lastY);
        this.setPan(NumCast(this.Document[this.panXFieldKey]) - dx, NumCast(this.Document[this.panYFieldKey]) - dy, 0, true);
        this._lastX = e.clientX;
        this._lastY = e.clientY;
    };

    _eraserLock = 0;
    /**
     * Erases strokes by intersecting them with an invisible "eraser stroke".
     *  By default this iterates through all intersected ink strokes, determines their segmentation, draws back the non-intersected segments,
     * and deletes the original stroke.
     *  However, if Shift is held, then no segmentation is done -- instead any intersected stroke is deleted in its entirety.
     */
    @action
    onEraserMove = (e: PointerEvent, down: number[], delta: number[]) => {
        const currPoint = { X: e.clientX, Y: e.clientY };
        if (this._eraserLock) return false; // bcz: should be fixed by putting it on a queue to be processed after the last eraser movement is processed.
        this.getEraserIntersections({ X: currPoint.X - delta[0], Y: currPoint.Y - delta[1] }, currPoint).forEach(intersect => {
            if (!this._deleteList.includes(intersect.inkView)) {
                this._deleteList.push(intersect.inkView);
                SetActiveInkWidth(StrCast(intersect.inkView.rootDoc.stroke_width?.toString()) || '1');
                SetActiveInkColor(StrCast(intersect.inkView.rootDoc.color?.toString()) || 'black');
                // create a new curve by appending all curves of the current segment together in order to render a single new stroke.
                if (!e.shiftKey) {
                    this._eraserLock++;
                    this.segmentInkStroke(intersect.inkView, intersect.t).forEach(segment =>
                        this.forceStrokeGesture(
                            e,
                            GestureUtils.Gestures.Stroke,
                            segment.reduce((data, curve) => [...data, ...curve.points.map(p => intersect.inkView.ComponentView?.ptToScreen?.({ X: p.x, Y: p.y }) ?? { X: 0, Y: 0 })], [] as PointData[])
                        )
                    );
                    setTimeout(() => this._eraserLock--);
                }
                // Lower ink opacity to give the user a visual indicator of deletion.
                intersect.inkView.layoutDoc.opacity = 0.5;
                intersect.inkView.layoutDoc.dontIntersect = true;
            }
        });
        return false;
    };
    forceStrokeGesture = (e: PointerEvent, gesture: GestureUtils.Gestures, points: InkData, text?: any) => {
        this.onGesture(e, new GestureUtils.GestureEvent(gesture, points, GestureOverlay.getBounds(points), text));
    };

    @action
    onPointerMove = (e: PointerEvent): boolean => {
        if (InteractionUtils.IsType(e, InteractionUtils.PENTYPE)) return false;
        if (InteractionUtils.IsType(e, InteractionUtils.TOUCHTYPE)) {
            Doc.ActiveTool = InkTool.None;
        } else {
            if (this.tryDragCluster(e, this._hitCluster)) {
                e.stopPropagation(); // we're moving a cluster, so stop propagation and return true to end panning and let the document drag take over
                return true;
            }
            // pan the view if this is a regular collection, or it's an overlay and the overlay is zoomed (otherwise, there's nothing to pan)
            if (!this.props.isAnnotationOverlay || 1 - NumCast(this.rootDoc._freeform_scale_min, 1) / this.getLocalTransform().inverse().Scale) {
                this.pan(e);
                e.stopPropagation(); // if we are actually panning, stop propagation -- this will preven things like the overlayView from dragging the document while we're panning
            }
        }
        return false;
    };

    /**
     * Determines if the Eraser tool has intersected with an ink stroke in the current freeform collection.
     * @returns an array of tuples containing the intersected ink DocumentView and the t-value where it was intersected
     */
    getEraserIntersections = (lastPoint: { X: number; Y: number }, currPoint: { X: number; Y: number }) => {
        const eraserMin = { X: Math.min(lastPoint.X, currPoint.X), Y: Math.min(lastPoint.Y, currPoint.Y) };
        const eraserMax = { X: Math.max(lastPoint.X, currPoint.X), Y: Math.max(lastPoint.Y, currPoint.Y) };

        return this.childDocs
            .map(doc => DocumentManager.Instance.getDocumentView(doc, this.props.DocumentView?.()))
            .filter(inkView => inkView?.ComponentView instanceof InkingStroke)
            .map(inkView => ({ inkViewBounds: inkView!.getBounds(), inkStroke: inkView!.ComponentView as InkingStroke, inkView: inkView! }))
            .filter(
                ({ inkViewBounds }) =>
                    inkViewBounds && // bounding box of eraser segment and ink stroke overlap
                    eraserMin.X <= inkViewBounds.right &&
                    eraserMin.Y <= inkViewBounds.bottom &&
                    eraserMax.X >= inkViewBounds.left &&
                    eraserMax.Y >= inkViewBounds.top
            )
            .reduce((intersections, { inkStroke, inkView }) => {
                const { inkData } = inkStroke.inkScaledData();
                // Convert from screen space to ink space for the intersection.
                const prevPointInkSpace = inkStroke.ptFromScreen(lastPoint);
                const currPointInkSpace = inkStroke.ptFromScreen(currPoint);
                for (var i = 0; i < inkData.length - 3; i += 4) {
                    const rawIntersects = InkField.Segment(inkData, i).intersects({
                        // compute all unique intersections
                        p1: { x: prevPointInkSpace.X, y: prevPointInkSpace.Y },
                        p2: { x: currPointInkSpace.X, y: currPointInkSpace.Y },
                    });
                    const intersects = Array.from(new Set(rawIntersects as (number | string)[])); // convert to more manageable union array type
                    // return tuples of the inkingStroke intersected, and the t value of the intersection
                    intersections.push(...intersects.map(t => ({ inkView, t: +t + Math.floor(i / 4) }))); // convert string t's to numbers and add start of curve segment to convert from local t value to t value along complete curve
                }
                return intersections;
            }, [] as { t: number; inkView: DocumentView }[]);
    };

    /**
     * Performs segmentation of the ink stroke - creates "segments" or subsections of the current ink stroke at points in which the
     * ink stroke intersects any other ink stroke (including itself).
     * @param ink The ink DocumentView intersected by the eraser.
     * @param excludeT The index of the curve in the ink document that the eraser intersection occurred.
     * @returns The ink stroke represented as a list of segments, excluding the segment in which the eraser intersection occurred.
     */
    @action
    segmentInkStroke = (ink: DocumentView, excludeT: number): Segment[] => {
        const segments: Segment[] = [];
        var segment: Segment = [];
        var startSegmentT = 0;
        const { inkData } = (ink?.ComponentView as InkingStroke).inkScaledData();
        // This iterates through all segments of the curve and splits them where they intersect another curve.
        // if 'excludeT' is specified, then any segment containing excludeT will be skipped (ie, deleted)
        for (var i = 0; i < inkData.length - 3; i += 4) {
            const inkSegment = InkField.Segment(inkData, i);
            // Getting all t-value intersections of the current curve with all other curves.
            const tVals = this.getInkIntersections(i, ink, inkSegment).sort();
            if (tVals.length) {
                tVals.forEach((t, index) => {
                    const docCurveTVal = t + Math.floor(i / 4);
                    if (excludeT < startSegmentT || excludeT > docCurveTVal) {
                        const localStartTVal = startSegmentT - Math.floor(i / 4);
                        t !== (localStartTVal < 0 ? 0 : localStartTVal) && segment.push(inkSegment.split(localStartTVal < 0 ? 0 : localStartTVal, t));
                        segment.length && segments.push(segment);
                    }
                    // start a new segment from the intersection t value
                    segment = tVals.length - 1 === index ? [inkSegment.split(t).right] : [];
                    startSegmentT = docCurveTVal;
                });
            } else {
                segment.push(inkSegment);
            }
        }
        if (excludeT < startSegmentT || excludeT > inkData.length / 4) {
            segment.length && segments.push(segment);
        }
        return segments;
    };

    // for some reason bezier.js doesn't handle the case of intersecting a linear curve, so we wrap the intersection
    // call in a test for linearity
    bintersects = (curve: Bezier, otherCurve: Bezier) => {
        if ((otherCurve as any)._linear) {
            return curve.lineIntersects({ p1: otherCurve.points[0], p2: otherCurve.points[3] });
        }
        return curve.intersects(otherCurve);
    };

    /**
     * Determines all possible intersections of the current curve of the intersected ink stroke with all other curves of all
     * ink strokes in the current collection.
     * @param i The index of the current curve within the inkData of the intersected ink stroke.
     * @param ink The intersected DocumentView of the ink stroke.
     * @param curve The current curve of the intersected ink stroke.
     * @returns A list of all t-values at which intersections occur at the current curve of the intersected ink stroke.
     */
    getInkIntersections = (i: number, ink: DocumentView, curve: Bezier): number[] => {
        const tVals: number[] = [];
        // Iterating through all ink strokes in the current freeform collection.
        this.childDocs
            .filter(doc => doc.type === DocumentType.INK && !doc.dontIntersect)
            .forEach(doc => {
                const otherInk = DocumentManager.Instance.getDocumentView(doc, this.props.DocumentView?.())?.ComponentView as InkingStroke;
                const { inkData: otherInkData } = otherInk?.inkScaledData() ?? { inkData: [] };
                const otherScreenPts = otherInkData.map(point => otherInk.ptToScreen(point));
                const otherCtrlPts = otherScreenPts.map(spt => (ink.ComponentView as InkingStroke).ptFromScreen(spt));
                for (var j = 0; j < otherCtrlPts.length - 3; j += 4) {
                    const neighboringSegment = i === j || i === j - 4 || i === j + 4;
                    // Ensuring that the curve intersected by the eraser is not checked for further ink intersections.
                    if (ink?.Document === otherInk.props.Document && neighboringSegment) continue;

                    const otherCurve = new Bezier(otherCtrlPts.slice(j, j + 4).map(p => ({ x: p.X, y: p.Y })));
                    const c0 = otherCurve.get(0);
                    const c1 = otherCurve.get(1);
                    const apt = curve.project(c0);
                    const bpt = curve.project(c1);
                    if (apt.d !== undefined && apt.d < 1 && apt.t !== undefined && !tVals.includes(apt.t)) {
                        tVals.push(apt.t);
                    }
                    this.bintersects(curve, otherCurve).forEach((val: string | number, i: number) => {
                        // Converting the Bezier.js Split type to a t-value number.
                        const t = +val.toString().split('/')[0];
                        if (i % 2 === 0 && !tVals.includes(t)) tVals.push(t); // bcz: Hack!  don't know why but intersection points are doubled from bezier.js (but not identical).
                    });
                    if (bpt.d !== undefined && bpt.d < 1 && bpt.t !== undefined && !tVals.includes(bpt.t)) {
                        tVals.push(bpt.t);
                    }
                }
            });
        return tVals;
    };

    cleanUpInteractions = () => {
        this.removeMoveListeners();
        this.removeEndListeners();
    };

    @action
    zoom = (pointX: number, pointY: number, deltaY: number): void => {
        if (this.Document._isGroup || this.Document._freeform_noZoom) return;
        let deltaScale = deltaY > 0 ? 1 / 1.05 : 1.05;
        if (deltaScale < 0) deltaScale = -deltaScale;
        const [x, y] = this.getTransform().transformPoint(pointX, pointY);
        const invTransform = this.getLocalTransform().inverse();
        if (deltaScale * invTransform.Scale > 20) {
            deltaScale = 20 / invTransform.Scale;
        }
        if (deltaScale < 1 && invTransform.Scale <= NumCast(this.rootDoc._freeform_scale_min, 1) && this.isAnnotationOverlay) {
            this.setPan(0, 0);
            return;
        }
        if (deltaScale * invTransform.Scale < NumCast(this.rootDoc._freeform_scale_min, 1) && this.isAnnotationOverlay) {
            deltaScale = NumCast(this.rootDoc._freeform_scale_min, 1) / invTransform.Scale;
        }

        const localTransform = invTransform.scaleAbout(deltaScale, x, y);
        if (localTransform.Scale >= 0.05 || localTransform.Scale > this.zoomScaling()) {
            const safeScale = Math.min(Math.max(0.05, localTransform.Scale), 20);
            this.props.Document[this.scaleFieldKey] = Math.abs(safeScale);
            this.setPan(-localTransform.TranslateX / safeScale, (this.props.originTopLeft ? undefined : NumCast(this.props.Document.layout_scrollTop) * safeScale) || -localTransform.TranslateY / safeScale);
        }
    };

    @action
    onPointerWheel = (e: React.WheelEvent): void => {
        if (this.Document._isGroup || !this.isContentActive()) return; // group style collections neither pan nor zoom
        PresBox.Instance?.pauseAutoPres();
        if (this.layoutDoc._Transform || this.props.Document.treeView_OutlineMode === TreeViewType.outline) return;
        e.stopPropagation();
        const docHeight = NumCast(this.rootDoc[Doc.LayoutFieldKey(this.rootDoc) + '_nativeHeight'], this.nativeHeight);
        const scrollable = NumCast(this.layoutDoc[this.scaleFieldKey], 1) === 1 && docHeight > this.props.PanelHeight() / this.nativeDimScaling + 1e-4;
        switch (!e.ctrlKey ? Doc.UserDoc().freeformScrollMode : freeformScrollMode.Pan) {
            case freeformScrollMode.Pan:
                // if ctrl is selected then zoom
                if (!e.ctrlKey && this.props.isContentActive(true)) {
                    this.scrollPan({ deltaX: -e.deltaX, deltaY: e.shiftKey ? 0 : -Math.max(-1, Math.min(1, e.deltaY)) });
                    break;
                }
            default:
            case freeformScrollMode.Zoom:
                if ((e.ctrlKey || !scrollable) && this.props.isContentActive(true)) {
                    this.zoom(e.clientX, e.clientY, Math.max(-1, Math.min(1, e.deltaY))); // if (!this.props.isAnnotationOverlay) // bcz: do we want to zoom in on images/videos/etc?
                    e.preventDefault();
                }
                break;
        }
    };

    @action
    setPan(panX: number, panY: number, panTime: number = 0, clamp: boolean = false) {
        // this is the easiest way to do this -> will talk with Bob about using mobx to do this to remove this line of code.
        if (Doc.UserDoc()?.presentationMode === 'watching') ReplayMovements.Instance.pauseFromInteraction();

        if (!this.isAnnotationOverlay && clamp) {
            // this section wraps the pan position, horizontally and/or vertically whenever the content is panned out of the viewing bounds
            const docs = this.childLayoutPairs.map(pair => pair.layout).filter(doc => doc instanceof Doc);
            const measuredDocs = docs
                .map(doc => ({ pos: this.childPositionProviderUnmemoized(doc, ''), size: this.childSizeProviderUnmemoized(doc, '') }))
                .filter(({ pos, size }) => pos && size)
                .map(({ pos, size }) => ({ pos: pos!, size: size! }));
            if (measuredDocs.length) {
                const ranges = measuredDocs.reduce(
                    (
                        { xrange, yrange },
                        { pos, size } // computes range of content
                    ) => ({
                        xrange: { min: Math.min(xrange.min, pos.x), max: Math.max(xrange.max, pos.x + (size.width || 0)) },
                        yrange: { min: Math.min(yrange.min, pos.y), max: Math.max(yrange.max, pos.y + (size.height || 0)) },
                    }),
                    {
                        xrange: { min: this.props.originTopLeft ? 0 : Number.MAX_VALUE, max: -Number.MAX_VALUE },
                        yrange: { min: this.props.originTopLeft ? 0 : Number.MAX_VALUE, max: -Number.MAX_VALUE },
                    }
                );

                const panelWidMax = (this.props.PanelWidth() / this.zoomScaling()) * (this.props.originTopLeft ? 2 / this.nativeDimScaling : 1);
                const panelWidMin = (this.props.PanelWidth() / this.zoomScaling()) * (this.props.originTopLeft ? 0 : 1);
                const panelHgtMax = (this.props.PanelHeight() / this.zoomScaling()) * (this.props.originTopLeft ? 2 / this.nativeDimScaling : 1);
                const panelHgtMin = (this.props.PanelHeight() / this.zoomScaling()) * (this.props.originTopLeft ? 0 : 1);
                if (ranges.xrange.min >= panX + panelWidMax / 2) panX = ranges.xrange.max + (this.props.originTopLeft ? 0 : panelWidMax / 2);
                else if (ranges.xrange.max <= panX - panelWidMin / 2) panX = ranges.xrange.min - (this.props.originTopLeft ? panelWidMax / 2 : panelWidMin / 2);
                if (ranges.yrange.min >= panY + panelHgtMax / 2) panY = ranges.yrange.max + (this.props.originTopLeft ? 0 : panelHgtMax / 2);
                else if (ranges.yrange.max <= panY - panelHgtMin / 2) panY = ranges.yrange.min - (this.props.originTopLeft ? panelHgtMax / 2 : panelHgtMin / 2);
            }
        }
        if (!this.layoutDoc._lockedTransform || LightboxView.LightboxDoc) {
            this.setPanZoomTransition(panTime);
            const minScale = NumCast(this.rootDoc._freeform_scale_min, 1);
            const scale = 1 - minScale / this.getLocalTransform().inverse().Scale;
            const minPanX = NumCast(this.rootDoc._freeform_panX_min, 0);
            const minPanY = NumCast(this.rootDoc._freeform_panY_min, 0);
            const maxPanX = NumCast(this.rootDoc._freeform_panX_max, this.nativeWidth);
            const newPanX = Math.min(minPanX + scale * maxPanX, Math.max(minPanX, panX));
            const fitYscroll = (((this.nativeHeight / this.nativeWidth) * this.props.PanelWidth() - this.props.PanelHeight()) * this.props.ScreenToLocalTransform().Scale) / minScale;
            const nativeHeight = (this.props.PanelHeight() / this.props.PanelWidth() / (this.nativeHeight / this.nativeWidth)) * this.nativeHeight;
            const maxScrollTop = this.nativeHeight / this.props.ScreenToLocalTransform().Scale - this.props.PanelHeight();
            const maxPanY =
                minPanY + // minPanY + scrolling introduced by view scaling + scrolling introduced by layout_fitWidth
                scale * NumCast(this.rootDoc._panY_max, nativeHeight) +
                (!this.props.getScrollHeight?.() ? fitYscroll : 0); // when not zoomed, scrolling is handled via a scrollbar, not panning
            let newPanY = Math.max(minPanY, Math.min(maxPanY, panY));
            if (false && NumCast(this.rootDoc.layout_scrollTop) && NumCast(this.rootDoc._freeform_scale, minScale) !== minScale) {
                const relTop = NumCast(this.rootDoc.layout_scrollTop) / maxScrollTop;
                this.rootDoc.layout_scrollTop = undefined;
                newPanY = minPanY + relTop * (maxPanY - minPanY);
            } else if (fitYscroll > 2 && this.rootDoc.layout_scrollTop === undefined && NumCast(this.rootDoc._freeform_scale, minScale) === minScale) {
                const maxPanY = minPanY + fitYscroll;
                const relTop = (panY - minPanY) / (maxPanY - minPanY);
                setTimeout(() => (this.rootDoc.layout_scrollTop = relTop * maxScrollTop), 10);
                newPanY = minPanY;
            }
            !this.Document._verticalScroll && (this.Document[this.panXFieldKey] = this.isAnnotationOverlay ? newPanX : panX);
            !this.Document._horizontalScroll && (this.Document[this.panYFieldKey] = this.isAnnotationOverlay ? newPanY : panY);
        }
    }

    @action
    nudge = (x: number, y: number, nudgeTime: number = 500) => {
        const collectionDoc = this.props.docViewPath().lastElement().rootDoc;
        if (collectionDoc?._type_collection !== CollectionViewType.Freeform || collectionDoc._freeform_ !== undefined) {
            this.setPan(
                NumCast(this.layoutDoc[this.panXFieldKey]) + ((this.props.PanelWidth() / 2) * x) / this.zoomScaling(), // nudge x,y as a function of panel dimension and scale
                NumCast(this.layoutDoc[this.panYFieldKey]) + ((this.props.PanelHeight() / 2) * -y) / this.zoomScaling(),
                nudgeTime,
                true
            );
            return true;
        }
        return false;
    };

    @action
    bringToFront = (doc: Doc, sendToBack?: boolean) => {
        if (sendToBack) {
            const docs = this.childLayoutPairs.map(pair => pair.layout).slice();
            docs.sort((doc1, doc2) => NumCast(doc1.zIndex) - NumCast(doc2.zIndex));
            let zfirst = docs.length ? NumCast(docs[0].zIndex) : 0;
            doc.zIndex = zfirst - 1;
        } else if (doc.stroke_isInkMask) {
            doc.zIndex = 5000;
        } else {
            const docs = this.childLayoutPairs.map(pair => pair.layout).slice();
            docs.sort((doc1, doc2) => NumCast(doc1.zIndex) - NumCast(doc2.zIndex));
            let zlast = docs.length ? Math.max(docs.length, NumCast(docs.lastElement().zIndex)) : 1;
            if (docs.lastElement() !== doc) {
                if (zlast - docs.length > 100) {
                    for (let i = 0; i < docs.length; i++) doc.zIndex = i + 1;
                    zlast = docs.length + 1;
                }
                doc.zIndex = zlast + 1;
            }
        }
    };

    @action
    setPanZoomTransition = (transitionTime: number) => {
        this._panZoomTransition = transitionTime;
        this._panZoomTransitionTimer && clearTimeout(this._panZoomTransitionTimer);
        this._panZoomTransitionTimer = setTimeout(
            action(() => (this._panZoomTransition = 0)),
            transitionTime
        );
    };

    @action
    zoomSmoothlyAboutPt(docpt: number[], scale: number, transitionTime = 500) {
        if (this.Document._isGroup) return;
        this.setPanZoomTransition(transitionTime);
        const screenXY = this.getTransform().inverse().transformPoint(docpt[0], docpt[1]);
        this.layoutDoc[this.scaleFieldKey] = scale;
        const newScreenXY = this.getTransform().inverse().transformPoint(docpt[0], docpt[1]);
        const scrDelta = { x: screenXY[0] - newScreenXY[0], y: screenXY[1] - newScreenXY[1] };
        const newpan = this.getTransform().transformDirection(scrDelta.x, scrDelta.y);
        this.layoutDoc[this.panXFieldKey] = NumCast(this.layoutDoc[this.panXFieldKey]) - newpan[0];
        this.layoutDoc[this.panYFieldKey] = NumCast(this.layoutDoc[this.panYFieldKey]) - newpan[1];
    }

    calculatePanIntoView = (doc: Doc, xf: Transform, scale?: number) => {
        const layoutdoc = Doc.Layout(doc);
        const pt = xf.transformPoint(NumCast(doc.x), NumCast(doc.y));
        const pt2 = xf.transformPoint(NumCast(doc.x) + layoutdoc[Width](), NumCast(doc.y) + layoutdoc[Height]());
        const bounds = { left: pt[0], right: pt2[0], top: pt[1], bot: pt2[1], width: pt2[0] - pt[0], height: pt2[1] - pt[1] };

        if (scale !== undefined) {
            const maxZoom = 5; // sets the limit for how far we will zoom. this is useful for preventing small text boxes from filling the screen. So probably needs to be more sophisticated to consider more about the target and context
            const newScale =
                scale === 0
                    ? NumCast(this.layoutDoc[this.scaleFieldKey])
                    : Math.min(maxZoom, (1 / (this.nativeDimScaling || 1)) * scale * Math.min(this.props.PanelWidth() / Math.abs(bounds.width), this.props.PanelHeight() / Math.abs(bounds.height)));
            return {
                panX: this.props.isAnnotationOverlay ? bounds.left - (Doc.NativeWidth(this.layoutDoc) / newScale - bounds.width) / 2 : (bounds.left + bounds.right) / 2,
                panY: this.props.isAnnotationOverlay ? bounds.top - (Doc.NativeHeight(this.layoutDoc) / newScale - bounds.height) / 2 : (bounds.top + bounds.bot) / 2,
                scale: newScale,
            };
        }

        const panelWidth = this.props.isAnnotationOverlay ? this.nativeWidth : this.props.PanelWidth();
        const panelHeight = this.props.isAnnotationOverlay ? this.nativeHeight : this.props.PanelHeight();
        const pw = panelWidth / NumCast(this.layoutDoc._freeform_scale, 1);
        const ph = panelHeight / NumCast(this.layoutDoc._freeform_scale, 1);
        const cx = NumCast(this.layoutDoc[this.panXFieldKey]) + (this.props.isAnnotationOverlay ? pw / 2 : 0);
        const cy = NumCast(this.layoutDoc[this.panYFieldKey]) + (this.props.isAnnotationOverlay ? ph / 2 : 0);
        const screen = { left: cx - pw / 2, right: cx + pw / 2, top: cy - ph / 2, bot: cy + ph / 2 };
        const maxYShift = Math.max(0, screen.bot - screen.top - (bounds.bot - bounds.top));
        const phborder = bounds.top < screen.top || bounds.bot > screen.bot ? Math.min(ph / 10, maxYShift / 2) : 0;
        if (screen.right - screen.left < bounds.right - bounds.left || screen.bot - screen.top < bounds.bot - bounds.top) {
            return {
                panX: (bounds.left + bounds.right) / 2,
                panY: (bounds.top + bounds.bot) / 2,
                scale: Math.min(this.props.PanelHeight() / (bounds.bot - bounds.top), this.props.PanelWidth() / (bounds.right - bounds.left)) / 1.1,
            };
        }
        return {
            panX: (this.props.isAnnotationOverlay ? NumCast(this.layoutDoc[this.panXFieldKey]) : cx) + Math.min(0, bounds.left - pw / 10 - screen.left) + Math.max(0, bounds.right + pw / 10 - screen.right),
            panY: (this.props.isAnnotationOverlay ? NumCast(this.layoutDoc[this.panYFieldKey]) : cy) + Math.min(0, bounds.top - phborder - screen.top) + Math.max(0, bounds.bot + phborder - screen.bot),
        };
    };

    isContentActive = () => this.props.isContentActive();

    @undoBatch
    @action
    onKeyDown = (e: React.KeyboardEvent, fieldProps: FieldViewProps) => {
        const docView = fieldProps.DocumentView?.();
        if (docView && (e.metaKey || e.ctrlKey || e.altKey || docView.rootDoc._createDocOnCR) && ['Tab', 'Enter'].includes(e.key)) {
            e.stopPropagation?.();
            const below = !e.altKey && e.key !== 'Tab';
            const layout_fieldKey = StrCast(docView.LayoutFieldKey);
            const newDoc = Doc.MakeCopy(docView.rootDoc, true);
            const dataField = docView.rootDoc[Doc.LayoutFieldKey(newDoc)];
            newDoc[DocData][Doc.LayoutFieldKey(newDoc)] = dataField === undefined || Cast(dataField, listSpec(Doc), null)?.length !== undefined ? new List<Doc>([]) : undefined;
            if (below) newDoc.y = NumCast(docView.rootDoc.y) + NumCast(docView.rootDoc._height) + 10;
            else newDoc.x = NumCast(docView.rootDoc.x) + NumCast(docView.rootDoc._width) + 10;
            if (layout_fieldKey !== 'layout' && docView.rootDoc[layout_fieldKey] instanceof Doc) {
                newDoc[layout_fieldKey] = docView.rootDoc[layout_fieldKey];
            }
            Doc.GetProto(newDoc).text = undefined;
            FormattedTextBox.SelectOnLoad = newDoc[Id];
            return this.addDocument?.(newDoc);
        }
    };
    @computed get _pointerEvents() {
        const engine = this.props.layoutEngine?.() || StrCast(this.props.Document._layoutEngine);
        const pointerEvents = DocumentDecorations.Instance.Interacting
            ? 'none'
            : this.props.childPointerEvents ?? (this.props.viewDefDivClick || (engine === computePassLayout.name && !this.props.isSelected(true)) || this.isContentActive() === false ? 'none' : this.props.pointerEvents?.());
        return pointerEvents;
    }
    pointerEvents = () => this._pointerEvents;
    childContentsActive = () => (this.props.childContentsActive ?? this.isContentActive() === false ? returnFalse : emptyFunction)();
    getChildDocView(entry: PoolData) {
        const childLayout = entry.pair.layout;
        const childData = entry.pair.data;
        return (
            <CollectionFreeFormDocumentView
                key={childLayout[Id] + (entry.replica || '')}
                DataDoc={childData}
                Document={childLayout}
                renderDepth={this.props.renderDepth + 1}
                replica={entry.replica}
                suppressSetHeight={this.layoutEngine ? true : false}
                renderCutoffProvider={this.renderCutoffProvider}
                CollectionFreeFormView={this}
                LayoutTemplate={childLayout.z ? undefined : this.props.childLayoutTemplate}
                LayoutTemplateString={childLayout.z ? undefined : this.props.childLayoutString}
                rootSelected={childData ? this.rootSelected : returnFalse}
                waitForDoubleClickToClick={this.props.waitForDoubleClickToClick}
                onClick={this.onChildClickHandler}
                onKey={this.onKeyDown}
                onDoubleClick={this.onChildDoubleClickHandler}
                onBrowseClick={this.onBrowseClickHandler}
                ScreenToLocalTransform={childLayout.z ? this.getContainerTransform : this.getTransform}
                PanelWidth={childLayout[Width]}
                PanelHeight={childLayout[Height]}
                childFilters={this.childDocFilters}
                childFiltersByRanges={this.childDocRangeFilters}
                searchFilterDocs={this.searchFilterDocs}
                isDocumentActive={this.props.childDocumentsActive?.() || this.rootDoc._isGroup ? this.props.isDocumentActive : this.isContentActive}
                isContentActive={this.childContentsActive}
                focus={this.Document._isGroup ? this.groupFocus : this.isAnnotationOverlay ? this.props.focus : this.focus}
                addDocTab={this.addDocTab}
                addDocument={this.props.addDocument}
                removeDocument={this.props.removeDocument}
                moveDocument={this.props.moveDocument}
                pinToPres={this.props.pinToPres}
                whenChildContentsActiveChanged={this.props.whenChildContentsActiveChanged}
                docViewPath={this.props.docViewPath}
                styleProvider={this.getClusterColor}
                dragAction={(this.rootDoc.childDragAction ?? this.props.childDragAction) as dropActionType}
                dataProvider={this.childDataProvider}
                sizeProvider={this.childSizeProvider}
                bringToFront={this.bringToFront}
                layout_showTitle={this.props.childlayout_showTitle}
                dontRegisterView={this.props.dontRenderDocuments || this.props.dontRegisterView}
                pointerEvents={this.pointerEvents}
                //fitContentsToBox={this.props.fitContentsToBox || BoolCast(this.props.treeView_FreezeChildDimensions)} // bcz: check this
            />
        );
    }
    addDocTab = action((doc: Doc, where: OpenWhere) => {
        if (this.props.isAnnotationOverlay) return this.props.addDocTab(doc, where);
        switch (where) {
            case OpenWhere.inParent:
                return this.props.addDocument?.(doc) || false;
            case OpenWhere.inParentFromScreen:
                const docContext = DocCast((doc instanceof Doc ? doc : doc?.[0])?.embedContainer);
                return (
                    (this.addDocument?.(
                        (doc instanceof Doc ? [doc] : doc).map(doc => {
                            const pt = this.getTransform().transformPoint(NumCast(doc.x), NumCast(doc.y));
                            doc.x = pt[0];
                            doc.y = pt[1];
                            return doc;
                        })
                    ) &&
                        (!docContext || this.props.removeDocument?.(docContext))) ||
                    false
                );
            case undefined:
            case OpenWhere.lightbox:
                if (this.layoutDoc._isLightbox) {
                    this._lightboxDoc = doc;
                    return true;
                }
                if (this.childDocList?.includes(doc)) {
                    if (doc.hidden) doc.hidden = false;
                    return true;
                }
        }
        return this.props.addDocTab(doc, where);
    });
    @observable _lightboxDoc: Opt<Doc>;

    getCalculatedPositions(params: { pair: { layout: Doc; data?: Doc }; index: number; collection: Doc }): PoolData {
        const random = (min: number, max: number, x: number, y: number) => /* min should not be equal to max */ min + (((Math.abs(x * y) * 9301 + 49297) % 233280) / 233280) * (max - min);
        const childDoc = params.pair.layout;
        const childDocLayout = Doc.Layout(childDoc);
        const layoutFrameNumber = Cast(this.Document._currentFrame, 'number'); // frame number that container is at which determines layout frame values
        const contentFrameNumber = Cast(childDocLayout._currentFrame, 'number', layoutFrameNumber ?? null); // frame number that content is at which determines what content is displayed
        const { z, zIndex } = childDoc;
        const { backgroundColor, color } = contentFrameNumber === undefined ? { backgroundColor: undefined, color: undefined } : CollectionFreeFormDocumentView.getStringValues(childDoc, contentFrameNumber);
        const { x, y, _width, _height, opacity, _rotation } =
            layoutFrameNumber === undefined
                ? { _width: Cast(childDocLayout._width, 'number'), _height: Cast(childDocLayout._height, 'number'), _rotation: Cast(childDocLayout._rotation, 'number'), x: childDoc.x, y: childDoc.y, opacity: this.props.childOpacity?.() }
                : CollectionFreeFormDocumentView.getValues(childDoc, layoutFrameNumber);
        // prettier-ignore
        const rotation = Cast(_rotation,'number',
            !this.layoutDoc._rotation_jitter ? null
                : NumCast(this.layoutDoc._rotation_jitter) * random(-1, 1, NumCast(x), NumCast(y)) );
        return {
            x: Number.isNaN(NumCast(x)) ? 0 : NumCast(x),
            y: Number.isNaN(NumCast(y)) ? 0 : NumCast(y),
            z: Cast(z, 'number'),
            rotation: rotation,
            color: Cast(color, 'string') ? StrCast(color) : this.props.styleProvider?.(childDoc, this.props, StyleProp.Color),
            backgroundColor: Cast(backgroundColor, 'string') ? StrCast(backgroundColor) : this.getClusterColor(childDoc, this.props, StyleProp.BackgroundColor),
            opacity: !_width ? 0 : this._keyframeEditing ? 1 : Cast(opacity, 'number') ?? this.props.styleProvider?.(childDoc, this.props, StyleProp.Opacity),
            zIndex: Cast(zIndex, 'number'),
            width: _width,
            height: _height,
            transition: StrCast(childDocLayout.dataTransition),
            pair: params.pair,
            replica: '',
        };
    }

    onViewDefDivClick = (e: React.MouseEvent, payload: any) => {
        (this.props.viewDefDivClick || ScriptCast(this.props.Document.onViewDefDivClick))?.script.run({ this: this.props.Document, payload });
        e.stopPropagation();
    };

    viewDefsToJSX = (views: ViewDefBounds[]) => {
        return !Array.isArray(views) ? [] : views.filter(ele => this.viewDefToJSX(ele)).map(ele => this.viewDefToJSX(ele)!);
    };

    viewDefToJSX(viewDef: ViewDefBounds): Opt<ViewDefResult> {
        const { x, y, z } = viewDef;
        const color = StrCast(viewDef.color);
        const width = Cast(viewDef.width, 'number');
        const height = Cast(viewDef.height, 'number');
        const transform = `translate(${x}px, ${y}px)`;
        if (viewDef.type === 'text') {
            const text = Cast(viewDef.text, 'string'); // don't use NumCast, StrCast, etc since we want to test for undefined below
            const fontSize = Cast(viewDef.fontSize, 'string');
            return [text, x, y].some(val => val === undefined)
                ? undefined
                : {
                      ele: (
                          <div className="collectionFreeform-customText" key={(text || '') + x + y + z + color} style={{ width, height, color, fontSize, transform }}>
                              {text}
                          </div>
                      ),
                      bounds: viewDef,
                  };
        } else if (viewDef.type === 'div') {
            return [x, y].some(val => val === undefined)
                ? undefined
                : {
                      ele: (
                          <div
                              className="collectionFreeform-customDiv"
                              title={viewDef.payload?.join(' ')}
                              key={'div' + x + y + z + viewDef.payload}
                              onClick={e => this.onViewDefDivClick(e, viewDef)}
                              style={{ width, height, backgroundColor: color, transform }}
                          />
                      ),
                      bounds: viewDef,
                  };
        }
    }

    renderCutoffProvider = computedFn(
        function renderCutoffProvider(this: any, doc: Doc) {
            return !this._renderCutoffData.get(doc[Id] + '');
        }.bind(this)
    );

    childPositionProviderUnmemoized = (doc: Doc, replica: string) => this._layoutPoolData.get(doc[Id] + (replica || ''));
    childDataProvider = computedFn(
        function childDataProvider(this: any, doc: Doc, replica: string) {
            return this.childPositionProviderUnmemoized(doc, replica);
        }.bind(this)
    );

    childSizeProviderUnmemoized = (doc: Doc, replica: string) => this._layoutSizeData.get(doc[Id] + (replica || ''));
    childSizeProvider = computedFn(
        function childSizeProvider(this: any, doc: Doc, replica: string) {
            return this.childSizeProviderUnmemoized(doc, replica);
        }.bind(this)
    );

    doEngineLayout(
        poolData: Map<string, PoolData>,
        engine: (poolData: Map<string, PoolData>, pivotDoc: Doc, childPairs: { layout: Doc; data?: Doc }[], panelDim: number[], viewDefsToJSX: (views: ViewDefBounds[]) => ViewDefResult[], engineProps: any) => ViewDefResult[]
    ) {
        return engine(poolData, this.props.Document, this.childLayoutPairs, [this.props.PanelWidth(), this.props.PanelHeight()], this.viewDefsToJSX, this.props.engineProps);
    }

    doFreeformLayout(poolData: Map<string, PoolData>) {
        this.childLayoutPairs.filter(pair => this.isCurrent(pair.layout)).map((pair, i) => poolData.set(pair.layout[Id], this.getCalculatedPositions({ pair, index: i, collection: this.Document })));
        return [] as ViewDefResult[];
    }

    @computed get layoutEngine() {
        return this.props.layoutEngine?.() || StrCast(this.layoutDoc._layoutEngine);
    }
    @computed get doInternalLayoutComputation() {
        TraceMobx();
        const newPool = new Map<string, PoolData>();
        // prettier-ignore
        switch (this.layoutEngine) {
            case computePassLayout.name :     return { newPool, computedElementData: this.doEngineLayout(newPool, computePassLayout) };
            case computeTimelineLayout.name:  return { newPool, computedElementData: this.doEngineLayout(newPool, computeTimelineLayout) };
            case computePivotLayout.name:     return { newPool, computedElementData: this.doEngineLayout(newPool, computePivotLayout) };
            case computeStarburstLayout.name: return { newPool, computedElementData: this.doEngineLayout(newPool, computeStarburstLayout) };
        }
        return { newPool, computedElementData: this.doFreeformLayout(newPool) };
    }

    @observable _numLoaded = 1;
    get doLayoutComputation() {
        const { newPool, computedElementData } = this.doInternalLayoutComputation;
        const array = Array.from(newPool.entries());
        runInAction(() => {
            for (const entry of array) {
                const lastPos = this._cachedPool.get(entry[0]); // last computed pos
                const newPos = entry[1];
                if (
                    !lastPos ||
                    newPos.color !== lastPos.color ||
                    newPos.backgroundColor !== lastPos.backgroundColor ||
                    newPos.opacity !== lastPos.opacity ||
                    newPos.x !== lastPos.x ||
                    newPos.y !== lastPos.y ||
                    newPos.z !== lastPos.z ||
                    newPos.rotation !== lastPos.rotation ||
                    newPos.zIndex !== lastPos.zIndex ||
                    newPos.transition !== lastPos.transition
                ) {
                    this._layoutPoolData.set(entry[0], newPos);
                }
                if (!lastPos || newPos.height !== lastPos.height || newPos.width !== lastPos.width) {
                    this._layoutSizeData.set(entry[0], { width: newPos.width, height: newPos.height });
                }
            }
        });
        this._cachedPool.clear();
        Array.from(newPool.entries()).forEach(k => this._cachedPool.set(k[0], k[1]));
        const elements = computedElementData.slice();
        Array.from(newPool.entries())
            .filter(entry => this.isCurrent(entry[1].pair.layout))
            .forEach((entry, i) => {
                const childData: ViewDefBounds = this.childDataProvider(entry[1].pair.layout, entry[1].replica);
                const childSize = this.childSizeProvider(entry[1].pair.layout, entry[1].replica);
                elements.push({
                    ele: this.getChildDocView(entry[1]),
                    bounds: childData.opacity === 0 ? { ...childData, width: 0, height: 0 } : { ...childData, width: childSize.width, height: childSize.height },
                    inkMask: BoolCast(entry[1].pair.layout.stroke_isInkMask) ? NumCast(entry[1].pair.layout.opacity, 1) : -1,
                });
            });

        if (this.props.isAnnotationOverlay && this.props.Document[this.scaleFieldKey]) {
            // don't zoom out farther than 1-1 if it's a bounded item (image, video, pdf), otherwise don't allow zooming in closer than 1-1 if it's a text sidebar
            if (this.props.viewField) this.props.Document[this.scaleFieldKey] = Math.min(1, this.zoomScaling());
            else this.props.Document[this.scaleFieldKey] = Math.max(1, this.zoomScaling()); // NumCast(this.props.Document[this.scaleFieldKey]));
        }

        this.Document._freeform_useClusters && !this._clusterSets.length && this.childDocs.length && this.updateClusters(true);
        return elements;
    }

    getAnchor = (addAsAnnotation: boolean, pinProps?: PinProps) => {
        // create an anchor that saves information about the current state of the freeform view (pan, zoom, view type)
        const anchor = Docs.Create.ConfigDocument({ title: 'ViewSpec - ' + StrCast(this.layoutDoc._type_collection), layout_unrendered: true, presentation_transition: 500, annotationOn: this.rootDoc });
        PresBox.pinDocView(anchor, { pinDocLayout: pinProps?.pinDocLayout, pinData: { ...(pinProps?.pinData ?? {}), pannable: !this.Document._isGroup, type_collection: true, filters: true } }, this.rootDoc);

        if (addAsAnnotation) {
            if (Cast(this.dataDoc[this.props.fieldKey + '_annotations'], listSpec(Doc), null) !== undefined) {
                Cast(this.dataDoc[this.props.fieldKey + '_annotations'], listSpec(Doc), []).push(anchor);
            } else {
                this.dataDoc[this.props.fieldKey + '_annotations'] = new List<Doc>([anchor]);
            }
        }
        return anchor;
    };

    @action
    componentDidMount() {
        this.props.setContentView?.(this);
        super.componentDidMount?.();
        this.props.setBrushViewer?.(this.brushView);
        setTimeout(
            action(() => {
                this._firstRender = false;
                this._disposers.groupBounds = reaction(
                    () => {
                        if (this.Document._isGroup && this.childDocs.length === this.childDocList?.length) {
                            const clist = this.childDocs.map(cd => ({ x: NumCast(cd.x), y: NumCast(cd.y), width: cd[Width](), height: cd[Height]() }));
                            return aggregateBounds(clist, NumCast(this.layoutDoc._xPadding), NumCast(this.layoutDoc._yPadding));
                        }
                        return undefined;
                    },
                    cbounds => {
                        if (cbounds) {
                            const c = [NumCast(this.layoutDoc.x) + this.layoutDoc[Width]() / 2, NumCast(this.layoutDoc.y) + this.layoutDoc[Height]() / 2];
                            const p = [NumCast(this.layoutDoc[this.panXFieldKey]), NumCast(this.layoutDoc[this.panYFieldKey])];
                            const pbounds = {
                                x: cbounds.x - p[0] + c[0],
                                y: cbounds.y - p[1] + c[1],
                                r: cbounds.r - p[0] + c[0],
                                b: cbounds.b - p[1] + c[1],
                            };
                            if (Number.isFinite(pbounds.r - pbounds.x) && Number.isFinite(pbounds.b - pbounds.y)) {
                                this.layoutDoc._width = pbounds.r - pbounds.x;
                                this.layoutDoc._height = pbounds.b - pbounds.y;
                                this.layoutDoc[this.panXFieldKey] = (cbounds.r + cbounds.x) / 2;
                                this.layoutDoc[this.panYFieldKey] = (cbounds.b + cbounds.y) / 2;
                                this.layoutDoc.x = pbounds.x;
                                this.layoutDoc.y = pbounds.y;
                            }
                        }
                    },
                    { fireImmediately: true }
                );

                this._disposers.layoutComputation = reaction(
                    () => this.doLayoutComputation,
                    elements => (this._layoutElements = elements || []),
                    { fireImmediately: true, name: 'doLayout' }
                );

                this._disposers.fitContent = reaction(
                    () => this.rootDoc.fitContentOnce,
                    fitContentOnce => {
                        if (fitContentOnce) this.fitContentOnce();
                        this.rootDoc.fitContentOnce = false;
                    },
                    { fireImmediately: true, name: 'fitContent' }
                );
            })
        );
    }

    static replaceCanvases(oldDiv: HTMLElement, newDiv: HTMLElement) {
        if (oldDiv.childNodes && newDiv) {
            for (let i = 0; i < oldDiv.childNodes.length; i++) {
                this.replaceCanvases(oldDiv.childNodes[i] as HTMLElement, newDiv.childNodes[i] as HTMLElement);
            }
        }
        if (oldDiv instanceof HTMLCanvasElement) {
            if (oldDiv.className === 'collectionFreeFormView-grid') {
                const newCan = newDiv as HTMLCanvasElement;
                const parEle = newCan.parentElement as HTMLElement;
                parEle.removeChild(newCan);
                parEle.appendChild(document.createElement('div'));
            } else {
                const canvas = oldDiv;
                const img = document.createElement('img'); // create a Image Element
                try {
                    img.src = canvas.toDataURL(); //image source
                } catch (e) {
                    console.log(e);
                }
                img.style.width = canvas.style.width;
                img.style.height = canvas.style.height;
                const newCan = newDiv as HTMLCanvasElement;
                if (newCan) {
                    const parEle = newCan.parentElement as HTMLElement;
                    parEle.removeChild(newCan);
                    parEle.appendChild(img);
                }
            }
        }
    }

    updateIcon = () =>
        CollectionFreeFormView.UpdateIcon(
            this.layoutDoc[Id] + '-icon' + new Date().getTime(),
            this.props.docViewPath().lastElement().ContentDiv!,
            this.layoutDoc[Width](),
            this.layoutDoc[Height](),
            this.props.PanelWidth(),
            this.props.PanelHeight(),
            0,
            1,
            false,
            '',
            (iconFile, nativeWidth, nativeHeight) => {
                this.dataDoc.icon = new ImageField(iconFile);
                this.dataDoc['icon_nativeWidth'] = nativeWidth;
                this.dataDoc['icon_nativeHeight'] = nativeHeight;
            }
        );

    public static UpdateIcon(
        filename: string,
        docViewContent: HTMLElement,
        width: number,
        height: number,
        panelWidth: number,
        panelHeight: number,
        scrollTop: number,
        realNativeHeight: number,
        noSuffix: boolean,
        replaceRootFilename: string | undefined,
        cb: (iconFile: string, nativeWidth: number, nativeHeight: number) => any
    ) {
        const newDiv = docViewContent.cloneNode(true) as HTMLDivElement;
        newDiv.style.width = width.toString();
        newDiv.style.height = height.toString();
        this.replaceCanvases(docViewContent, newDiv);
        const htmlString = new XMLSerializer().serializeToString(newDiv);
        const nativeWidth = width;
        const nativeHeight = height;
        return CreateImage(Utils.prepend(''), document.styleSheets, htmlString, nativeWidth, (nativeWidth * panelHeight) / panelWidth, (scrollTop * panelHeight) / realNativeHeight)
            .then(async (data_url: any) => {
                const returnedFilename = await Utils.convertDataUri(data_url, filename, noSuffix, replaceRootFilename);
                cb(returnedFilename as string, nativeWidth, nativeHeight);
            })
            .catch(function (error: any) {
                console.error('oops, something went wrong!', error);
            });
    }

    componentWillUnmount() {
        Object.values(this._disposers).forEach(disposer => disposer?.());
        this._marqueeRef?.removeEventListener('dashDragAutoScroll', this.onDragAutoScroll as any);
    }

    @action
    onCursorMove = (e: React.PointerEvent) => {
        //  super.setCursorPosition(this.getTransform().transformPoint(e.clientX, e.clientY));
    };

    @action
    onDragAutoScroll = (e: CustomEvent<React.DragEvent>) => {
        if ((e as any).handlePan || this.props.isAnnotationOverlay) return;
        (e as any).handlePan = true;

        if (!this.layoutDoc._freeform_noAutoPan && !this.props.renderDepth && this._marqueeRef) {
            const dragX = e.detail.clientX;
            const dragY = e.detail.clientY;
            const bounds = this._marqueeRef?.getBoundingClientRect();

            const deltaX = dragX - bounds.left < 25 ? -(25 + (bounds.left - dragX)) : bounds.right - dragX < 25 ? 25 - (bounds.right - dragX) : 0;
            const deltaY = dragY - bounds.top < 25 ? -(25 + (bounds.top - dragY)) : bounds.bottom - dragY < 25 ? 25 - (bounds.bottom - dragY) : 0;
            if (deltaX !== 0 || deltaY !== 0) {
                this.Document[this.panYFieldKey] = NumCast(this.Document[this.panYFieldKey]) + deltaY / 2;
                this.Document[this.panXFieldKey] = NumCast(this.Document[this.panXFieldKey]) + deltaX / 2;
            }
        }
        e.stopPropagation();
    };

    @undoBatch
    promoteCollection = () => {
        const childDocs = this.childDocs.slice();
        childDocs.forEach(doc => {
            const scr = this.getTransform().inverse().transformPoint(NumCast(doc.x), NumCast(doc.y));
            doc.x = scr?.[0];
            doc.y = scr?.[1];
        });
        this.props.addDocTab(childDocs as any as Doc, OpenWhere.inParentFromScreen);
    };

    @undoBatch
    layoutDocsInGrid = () => {
        const docs = this.childLayoutPairs.map(pair => pair.layout);
        const width = Math.max(...docs.map(doc => NumCast(doc._width))) + 20;
        const height = Math.max(...docs.map(doc => NumCast(doc._height))) + 20;
        const dim = Math.ceil(Math.sqrt(docs.length));
        docs.forEach((doc, i) => {
            doc.x = NumCast(this.Document[this.panXFieldKey]) + (i % dim) * width - (width * dim) / 2;
            doc.y = NumCast(this.Document[this.panYFieldKey]) + Math.floor(i / dim) * height - (height * dim) / 2;
        });
    };

    @undoBatch
    toggleNativeDimensions = () => Doc.toggleNativeDimensions(this.layoutDoc, 1, this.nativeWidth, this.nativeHeight);

    onContextMenu = (e: React.MouseEvent) => {
        if (this.props.isAnnotationOverlay || !ContextMenu.Instance) return;

        const appearance = ContextMenu.Instance.findByDescription('Appearance...');
        const appearanceItems = appearance && 'subitems' in appearance ? appearance.subitems : [];
        appearanceItems.push({
            description: 'Reset View',
            event: () => {
                this.props.Document[this.panXFieldKey] = this.props.Document[this.panYFieldKey] = 0;
                this.props.Document[this.scaleFieldKey] = 1;
            },
            icon: 'compress-arrows-alt',
        });
        !Doc.noviceMode &&
            appearanceItems.push({
                description: 'Toggle auto arrange',
                event: () => (this.layoutDoc._autoArrange = !this.layoutDoc._autoArrange),
                icon: 'compress-arrows-alt',
            });
        if (this.props.setContentView === emptyFunction) {
            !appearance && ContextMenu.Instance.addItem({ description: 'Appearance...', subitems: appearanceItems, icon: 'eye' });
            return;
        }
        !Doc.noviceMode && Doc.UserDoc().defaultTextLayout && appearanceItems.push({ description: 'Reset default note style', event: () => (Doc.UserDoc().defaultTextLayout = undefined), icon: 'eye' });
        appearanceItems.push({ description: `Pin View`, event: () => TabDocView.PinDoc(this.rootDoc, { pinViewport: MarqueeView.CurViewBounds(this.rootDoc, this.props.PanelWidth(), this.props.PanelHeight()) }), icon: 'map-pin' });
        !Doc.noviceMode && appearanceItems.push({ description: `update icon`, event: this.updateIcon, icon: 'compress-arrows-alt' });
        this.props.renderDepth && appearanceItems.push({ description: 'Ungroup collection', event: this.promoteCollection, icon: 'table' });

        this.props.Document._isGroup && this.Document.transcription && appearanceItems.push({ description: 'Ink to text', event: () => this.transcribeStrokes(false), icon: 'font' });

        // this.props.Document._isGroup && this.childDocs.filter(s => s.type === DocumentType.INK).length > 0 && appearanceItems.push({ description: "Ink to math", event: () => this.transcribeStrokes(true), icon: "square-root-alt" });

        !Doc.noviceMode ? appearanceItems.push({ description: 'Arrange contents in grid', event: this.layoutDocsInGrid, icon: 'table' }) : null;
        !appearance && ContextMenu.Instance.addItem({ description: 'Appearance...', subitems: appearanceItems, icon: 'eye' });

        const viewctrls = ContextMenu.Instance.findByDescription('UI Controls...');
        const viewCtrlItems = viewctrls && 'subitems' in viewctrls ? viewctrls.subitems : [];
        !Doc.noviceMode
            ? viewCtrlItems.push({ description: (SnappingManager.GetShowSnapLines() ? 'Hide' : 'Show') + ' Snap Lines', event: () => SnappingManager.SetShowSnapLines(!SnappingManager.GetShowSnapLines()), icon: 'compress-arrows-alt' })
            : null;
        !Doc.noviceMode ? viewCtrlItems.push({ description: (this.Document._freeform_useClusters ? 'Hide' : 'Show') + ' Clusters', event: () => this.updateClusters(!this.Document._freeform_useClusters), icon: 'braille' }) : null;
        !viewctrls && ContextMenu.Instance.addItem({ description: 'UI Controls...', subitems: viewCtrlItems, icon: 'eye' });

        const options = ContextMenu.Instance.findByDescription('Options...');
        const optionItems = options && 'subitems' in options ? options.subitems : [];
        !this.props.isAnnotationOverlay &&
            !Doc.noviceMode &&
            optionItems.push({ description: (this._showAnimTimeline ? 'Close' : 'Open') + ' Animation Timeline', event: action(() => (this._showAnimTimeline = !this._showAnimTimeline)), icon: 'eye' });
        this.props.renderDepth && optionItems.push({ description: 'Use Background Color as Default', event: () => (Cast(Doc.UserDoc().emptyCollection, Doc, null)._backgroundColor = StrCast(this.layoutDoc._backgroundColor)), icon: 'palette' });
        this.props.renderDepth &&
            optionItems.push({
                description: 'Fit Content Once',
                event: () => {
                    this.fitContentOnce();
                },
                icon: 'object-group',
            });
        if (!Doc.noviceMode) {
            optionItems.push({ description: (!Doc.NativeWidth(this.layoutDoc) || !Doc.NativeHeight(this.layoutDoc) ? 'Freeze' : 'Unfreeze') + ' Aspect', event: this.toggleNativeDimensions, icon: 'snowflake' });
        }
        !options && ContextMenu.Instance.addItem({ description: 'Options...', subitems: optionItems, icon: 'eye' });
        const mores = ContextMenu.Instance.findByDescription('More...');
        const moreItems = mores && 'subitems' in mores ? mores.subitems : [];
        !mores && ContextMenu.Instance.addItem({ description: 'More...', subitems: moreItems, icon: 'eye' });
    };

    @undoBatch
    @action
    transcribeStrokes = (math: boolean) => {
        if (this.props.Document._isGroup && this.props.Document.transcription) {
            if (!math) {
                const text = StrCast(this.props.Document.transcription);

                const lines = text.split('\n');
                const height = 30 + 15 * lines.length;

                this.addDocument(Docs.Create.TextDocument(text, { title: lines[0], x: NumCast(this.layoutDoc.x) + NumCast(this.layoutDoc._width) + 20, y: NumCast(this.layoutDoc.y), _width: 200, _height: height }));
            }
        }
    };

    @action
    setupDragLines = (snapToDraggedDoc: boolean = false) => {
        const activeDocs = this.getActiveDocuments();
        const size = this.getTransform().transformDirection(this.props.PanelWidth(), this.props.PanelHeight());
        const selRect = { left: this.panX() - size[0] / 2, top: this.panY() - size[1] / 2, width: size[0], height: size[1] };
        const docDims = (doc: Doc) => ({ left: NumCast(doc.x), top: NumCast(doc.y), width: NumCast(doc._width), height: NumCast(doc._height) });
        const isDocInView = (doc: Doc, rect: { left: number; top: number; width: number; height: number }) => intersectRect(docDims(doc), rect);

        const otherBounds = { left: this.panX(), top: this.panY(), width: Math.abs(size[0]), height: Math.abs(size[1]) };
        let snappableDocs = activeDocs.filter(doc => doc.z === undefined && isDocInView(doc, selRect)); // first see if there are any foreground docs to snap to
        !snappableDocs.length && (snappableDocs = activeDocs.filter(doc => doc.z === undefined && isDocInView(doc, selRect))); // if not, see if there are background docs to snap to
        !snappableDocs.length && (snappableDocs = activeDocs.filter(doc => doc.z !== undefined && isDocInView(doc, otherBounds))); // if not, then why not snap to floating docs

        const horizLines: number[] = [];
        const vertLines: number[] = [];
        const invXf = this.getTransform().inverse();
        snappableDocs
            .filter(doc => snapToDraggedDoc || !DragManager.docsBeingDragged.includes(Cast(doc.rootDocument, Doc, null) || doc))
            .forEach(doc => {
                const { left, top, width, height } = docDims(doc);
                const topLeftInScreen = invXf.transformPoint(left, top);
                const docSize = invXf.transformDirection(width, height);

                horizLines.push(topLeftInScreen[1], topLeftInScreen[1] + docSize[1] / 2, topLeftInScreen[1] + docSize[1]); // horiz center line
                vertLines.push(topLeftInScreen[0], topLeftInScreen[0] + docSize[0] / 2, topLeftInScreen[0] + docSize[0]); // right line
            });
        DragManager.SetSnapLines(horizLines, vertLines);
    };

    incrementalRendering = () => this.childDocs.filter(doc => !this._renderCutoffData.get(doc[Id])).length !== 0;

    incrementalRender = action(() => {
        if (!LightboxView.LightboxDoc || LightboxView.IsLightboxDocView(this.props.docViewPath())) {
            const layout_unrendered = this.childDocs.filter(doc => !this._renderCutoffData.get(doc[Id]));
            const loadIncrement = 5;
            for (var i = 0; i < Math.min(layout_unrendered.length, loadIncrement); i++) {
                this._renderCutoffData.set(layout_unrendered[i][Id] + '', true);
            }
        }
        this.childDocs.some(doc => !this._renderCutoffData.get(doc[Id])) && setTimeout(this.incrementalRender, 1);
    });

    get children() {
        this.incrementalRender();
        const children = typeof this.props.children === 'function' ? ((this.props.children as any)() as JSX.Element[]) : this.props.children ? [this.props.children] : [];
        return [...children, ...this.views, <CollectionFreeFormRemoteCursors {...this.props} key="remoteCursors" />];
    }

    @computed get placeholder() {
        return (
            <div className="collectionfreeformview-placeholder" style={{ background: StrCast(this.Document.backgroundColor) }}>
                <span className="collectionfreeformview-placeholderSpan">{this.props.Document.annotationOn ? '' : this.props.Document.title?.toString()}</span>
            </div>
        );
    }

    showPresPaths = () => (CollectionFreeFormView.ShowPresPaths ? PresBox.Instance.getPaths(this.rootDoc) : null);

    brushedView = () => this._brushedView;
    @computed get marqueeView() {
        TraceMobx();
        return (
            <MarqueeView
                {...this.props}
                ref={this._marqueeViewRef}
                ungroup={this.props.Document._isGroup ? this.promoteCollection : undefined}
                nudge={this.isAnnotationOverlay || this.props.renderDepth > 0 ? undefined : this.nudge}
                addDocTab={this.addDocTab}
                slowLoadDocuments={this.slowLoadDocuments}
                trySelectCluster={this.trySelectCluster}
                activeDocuments={this.getActiveDocuments}
                selectDocuments={this.selectDocuments}
                addDocument={this.addDocument}
                addLiveTextDocument={this.addLiveTextBox}
                getContainerTransform={this.getContainerTransform}
                getTransform={this.getTransform}
                isAnnotationOverlay={this.isAnnotationOverlay}>
                <div
                    className="marqueeView-div"
                    ref={r => {
                        this._marqueeRef = r;
                        r?.addEventListener('dashDragAutoScroll', this.onDragAutoScroll as any);
                    }}
                    style={{ opacity: this.props.dontRenderDocuments ? 0.7 : undefined }}>
                    {this.layoutDoc._freeform_backgroundGrid ? (
                        <div>
                            <CollectionFreeFormBackgroundGrid // bcz : UGHH  don't know why, but if we don't wrap in a div, then PDF's don't render whenn taking snapshot of a dashboard and the background grid is on!!?
                                PanelWidth={this.props.PanelWidth}
                                PanelHeight={this.props.PanelHeight}
                                panX={this.panX}
                                panY={this.panY}
                                nativeDimScaling={this.nativeDim}
                                zoomScaling={this.zoomScaling}
                                layoutDoc={this.layoutDoc}
                                isAnnotationOverlay={this.isAnnotationOverlay}
                                cachedCenteringShiftX={this.cachedCenteringShiftX}
                                cachedCenteringShiftY={this.cachedCenteringShiftY}
                            />
                        </div>
                    ) : null}
                    <CollectionFreeFormViewPannableContents
                        brushedView={this.brushedView}
                        isAnnotationOverlay={this.isAnnotationOverlay}
                        isAnnotationOverlayScrollable={this.props.isAnnotationOverlayScrollable}
                        transform={this.contentTransform}
                        zoomScaling={this.zoomScaling}
                        presPaths={this.showPresPaths}
                        presPinView={BoolCast(this.Document.config_pinView)}
                        transition={this._panZoomTransition ? `transform ${this._panZoomTransition}ms` : Cast(this.layoutDoc._viewTransition, 'string', Cast(this.props.DocumentView?.()?.rootDoc._viewTransition, 'string', null))}
                        viewDefDivClick={this.props.viewDefDivClick}>
                        {this.children}
                    </CollectionFreeFormViewPannableContents>
                </div>
                {this._showAnimTimeline ? <Timeline ref={this._timelineRef} {...this.props} /> : null}
            </MarqueeView>
        );
    }

    @computed get nativeDimScaling() {
        if (this._firstRender || (this.props.isAnnotationOverlay && !this.props.annotationLayerHostsContent)) return 0;
        const nw = this.nativeWidth;
        const nh = this.nativeHeight;
        const hscale = nh ? this.props.PanelHeight() / nh : 1;
        const wscale = nw ? this.props.PanelWidth() / nw : 1;
        return wscale < hscale || this.layoutDoc.layout_fitWidth ? wscale : hscale;
    }
    nativeDim = () => this.nativeDimScaling;

    private groupDropDisposer?: DragManager.DragDropDisposer;
    protected createGroupEventsTarget = (ele: HTMLDivElement) => {
        //used for stacking and masonry view
        this.groupDropDisposer?.();
        if (ele) {
            this.groupDropDisposer = DragManager.MakeDropTarget(ele, this.onInternalDrop.bind(this), this.layoutDoc, this.onInternalPreDrop.bind(this));
        }
    };

    @action
    brushView = (viewport: { width: number; height: number; panX: number; panY: number }, transTime: number) => {
        this._brushtimer1 && clearTimeout(this._brushtimer1);
        this._brushtimer && clearTimeout(this._brushtimer);
        this._brushedView = { width: 0, height: 0, panX: 0, panY: 0, opacity: 0 };
        this._brushtimer1 = setTimeout(
            action(() => {
                this._brushedView = { ...viewport, panX: viewport.panX - viewport.width / 2, panY: viewport.panY - viewport.height / 2, opacity: 1 };
                this._brushtimer = setTimeout(
                    action(() => (this._brushedView.opacity = 0)),
                    2500
                );
            }),
            transTime + 1
        );
    };
    lightboxPanelWidth = () => Math.max(0, this.props.PanelWidth() - 30);
    lightboxPanelHeight = () => Math.max(0, this.props.PanelHeight() - 30);
    lightboxScreenToLocal = () => this.props.ScreenToLocalTransform().translate(-15, -15);
    onPassiveWheel = (e: WheelEvent) => {
        const docHeight = NumCast(this.rootDoc[Doc.LayoutFieldKey(this.rootDoc) + '_nativeHeight'], this.nativeHeight);
        const scrollable = NumCast(this.layoutDoc[this.scaleFieldKey], 1) === 1 && docHeight > this.props.PanelHeight() / this.nativeDimScaling;
        this.props.isSelected() && !scrollable && e.preventDefault();
    };
    _oldWheel: any;
    render() {
        TraceMobx();
        return (
            <div
                className="collectionfreeformview-container"
                ref={r => {
                    this.createDashEventsTarget(r);
                    this._oldWheel?.removeEventListener('wheel', this.onPassiveWheel);
                    this._oldWheel = r;
                    // prevent wheel events from passivly propagating up through containers
                    r?.addEventListener('wheel', this.onPassiveWheel, { passive: false });
                }}
                onWheel={this.onPointerWheel}
                onClick={this.onClick}
                onPointerDown={this.onPointerDown}
                onPointerMove={this.onCursorMove}
                onDrop={this.onExternalDrop.bind(this)}
                onDragOver={e => e.preventDefault()}
                onContextMenu={this.onContextMenu}
                style={{
                    pointerEvents: this.props.isContentActive() && SnappingManager.GetIsDragging() ? 'all' : (this.props.pointerEvents?.() as any),
                    textAlign: this.isAnnotationOverlay ? 'initial' : undefined,
                    transform: `scale(${this.nativeDimScaling || 1})`,
                    width: `${100 / (this.nativeDimScaling || 1)}%`,
                    height: this.props.getScrollHeight?.() ?? `${100 / (this.nativeDimScaling || 1)}%`,
                }}>
                {this._lightboxDoc ? (
                    <div style={{ padding: 15, width: '100%', height: '100%' }}>
                        <DocumentView
                            {...this.props}
                            Document={this._lightboxDoc}
                            DataDoc={undefined}
                            PanelWidth={this.lightboxPanelWidth}
                            PanelHeight={this.lightboxPanelHeight}
                            NativeWidth={returnZero}
                            NativeHeight={returnZero}
                            onClick={this.onChildClickHandler}
                            onKey={this.onKeyDown}
                            onDoubleClick={this.onChildDoubleClickHandler}
                            onBrowseClick={this.onBrowseClickHandler}
                            childFilters={this.childDocFilters}
                            childFiltersByRanges={this.childDocRangeFilters}
                            searchFilterDocs={this.searchFilterDocs}
                            isDocumentActive={this.props.childDocumentsActive?.() ? this.props.isDocumentActive : this.isContentActive}
                            isContentActive={this.props.childContentsActive ?? emptyFunction}
                            addDocTab={this.addDocTab}
                            ScreenToLocalTransform={this.lightboxScreenToLocal}
                            fitContentsToBox={undefined}
                            focus={this.focus}
                        />
                    </div>
                ) : (
                    <>
                        {this._firstRender ? this.placeholder : this.marqueeView}
                        {this.props.noOverlay ? null : <CollectionFreeFormOverlayView elements={this.elementFunc} />}

                        {/* // uncomment to show snap lines */}
                        <div className="snapLines" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', pointerEvents: 'none' }}>
                            <svg style={{ width: '100%', height: '100%' }}>
                                {this._hLines?.map(l => (
                                    <line x1="0" y1={l} x2="1000" y2={l} stroke="black" />
                                ))}
                                {this._vLines?.map(l => (
                                    <line y1="0" x1={l} y2="1000" x2={l} stroke="black" />
                                ))}
                            </svg>
                        </div>

                        {this.props.Document._isGroup && SnappingManager.GetIsDragging() && this.ChildDrag ? (
                            <div
                                className="collectionFreeForm-groupDropper"
                                ref={this.createGroupEventsTarget}
                                style={{
                                    width: this.ChildDrag ? '10000' : '100%',
                                    height: this.ChildDrag ? '10000' : '100%',
                                    left: this.ChildDrag ? '-5000' : 0,
                                    top: this.ChildDrag ? '-5000' : 0,
                                    position: 'absolute',
                                    background: '#0009930',
                                    pointerEvents: 'all',
                                }}
                            />
                        ) : null}
                    </>
                )}
            </div>
        );
    }
}

interface CollectionFreeFormOverlayViewProps {
    elements: () => ViewDefResult[];
}

@observer
class CollectionFreeFormOverlayView extends React.Component<CollectionFreeFormOverlayViewProps> {
    render() {
        return this.props
            .elements()
            .filter(ele => ele.bounds?.z)
            .map(ele => ele.ele);
    }
}

interface CollectionFreeFormViewPannableContentsProps {
    transform: () => string;
    zoomScaling: () => number;
    viewDefDivClick?: ScriptField;
    children?: React.ReactNode | undefined;
    //children: () => JSX.Element[];
    transition?: string;
    presPaths: () => JSX.Element | null;
    presPinView?: boolean;
    isAnnotationOverlay: boolean | undefined;
    isAnnotationOverlayScrollable: boolean | undefined;
    brushedView: () => { panX: number; panY: number; width: number; height: number; opacity: number };
}

@observer
class CollectionFreeFormViewPannableContents extends React.Component<CollectionFreeFormViewPannableContentsProps> {
    @observable _drag: string = '';

    //Adds event listener so knows pointer is down and moving
    onPointerDown = (e: React.PointerEvent): void => {
        e.stopPropagation();
        e.preventDefault();
        this._drag = (e.target as any)?.id ?? '';
        document.getElementById(this._drag) && setupMoveUpEvents(e.target, e, this.onPointerMove, emptyFunction, emptyFunction);
    };

    //Adjusts the value in NodeStore
    @action
    onPointerMove = (e: PointerEvent) => {
        const doc = document.getElementById('resizable');
        const toNumber = (original: number, delta: number) => original + delta * this.props.zoomScaling();
        if (doc) {
            switch (this._drag) {
                case 'resizer-br':
                    doc.style.width = toNumber(doc.offsetWidth, e.movementX) + 'px';
                    doc.style.height = toNumber(doc.offsetHeight, e.movementY) + 'px';
                    break;
                case 'resizer-bl':
                    doc.style.width = toNumber(doc.offsetWidth, -e.movementX) + 'px';
                    doc.style.height = toNumber(doc.offsetHeight, e.movementY) + 'px';
                    doc.style.left = toNumber(doc.offsetLeft, e.movementX) + 'px';
                    break;
                case 'resizer-tr':
                    doc.style.width = toNumber(doc.offsetWidth, -e.movementX) + 'px';
                    doc.style.height = toNumber(doc.offsetHeight, -e.movementY) + 'px';
                    doc.style.top = toNumber(doc.offsetTop, e.movementY) + 'px';
                case 'resizer-tl':
                    doc.style.width = toNumber(doc.offsetWidth, -e.movementX) + 'px';
                    doc.style.height = toNumber(doc.offsetHeight, -e.movementY) + 'px';
                    doc.style.top = toNumber(doc.offsetTop, e.movementY) + 'px';
                    doc.style.left = toNumber(doc.offsetLeft, e.movementX) + 'px';
                case 'resizable':
                    doc.style.top = toNumber(doc.offsetTop, e.movementY) + 'px';
                    doc.style.left = toNumber(doc.offsetLeft, e.movementX) + 'px';
            }
            return false;
        }
        return true;
    };

    @computed get presPaths() {
        return !this.props.presPaths() ? null : (
            <>
                <div key="presorder">{PresBox.Instance?.order}</div>
                <svg key="svg" className="presPaths">
                    <defs>
                        <marker id="markerSquare" markerWidth="3" markerHeight="3" refX="1.5" refY="1.5" orient="auto" overflow="visible">
                            <rect x="0" y="0" width="3" height="3" stroke="#69a6db" strokeWidth="1" fill="white" fillOpacity="0.8" />
                        </marker>
                        <marker id="markerSquareFilled" markerWidth="3" markerHeight="3" refX="1.5" refY="1.5" orient="auto" overflow="visible">
                            <rect x="0" y="0" width="3" height="3" stroke="#69a6db" strokeWidth="1" fill="#69a6db" />
                        </marker>
                        <marker id="markerArrow" markerWidth="3" markerHeight="3" refX="2" refY="4" orient="auto" overflow="visible">
                            <path d="M2,2 L2,6 L6,4 L2,2 Z" stroke="#69a6db" strokeLinejoin="round" strokeWidth="1" fill="white" fillOpacity="0.8" />
                        </marker>
                    </defs>
                    {this.props.presPaths()}
                </svg>
            </>
        );
    }

    render() {
        const brushedView = this.props.brushedView();
        return (
            <div
                className={'collectionfreeformview' + (this.props.viewDefDivClick ? '-viewDef' : '-none')}
                onScroll={e => {
                    const target = e.target as any;
                    if (getComputedStyle(target)?.overflow === 'visible') {
                        // if collection is visible, then scrolling will mess things up since there are no scroll bars
                        target.scrollTop = target.scrollLeft = 0;
                    }
                }}
                style={{
                    transform: this.props.transform(),
                    transition: this.props.transition,
                    width: this.props.isAnnotationOverlay ? undefined : 0, // if not an overlay, then this will be the size of the collection, but panning and zooming will move it outside the visible border of the collection and make it selectable.  This problem shows up after zooming/panning on a background collection -- you can drag the collection by clicking on apparently empty space outside the collection
                    //willChange: "transform"
                }}>
                {this.props.children}
                {
                    <div
                        className="collectionFreeFormView-brushView"
                        style={{
                            opacity: brushedView.opacity,
                            transform: `translate(${brushedView.panX}px, ${brushedView.panY}px)`,
                            width: brushedView.width,
                            height: brushedView.height,
                            border: `orange solid ${brushedView.width * 0.005}px`,
                        }}
                    />
                }
                {this.presPaths}
            </div>
        );
    }
}

interface CollectionFreeFormViewBackgroundGridProps {
    panX: () => number;
    panY: () => number;
    PanelWidth: () => number;
    PanelHeight: () => number;
    isAnnotationOverlay?: boolean;
    nativeDimScaling: () => number;
    zoomScaling: () => number;
    layoutDoc: Doc;
    cachedCenteringShiftX: number;
    cachedCenteringShiftY: number;
}
@observer
class CollectionFreeFormBackgroundGrid extends React.Component<CollectionFreeFormViewBackgroundGridProps> {
    chooseGridSpace = (gridSpace: number): number => {
        if (!this.props.zoomScaling()) return 50;
        const divisions = this.props.PanelWidth() / this.props.zoomScaling() / gridSpace + 3;
        return divisions < 60 ? gridSpace : this.chooseGridSpace(gridSpace * 10);
    };
    render() {
        const gridSpace = this.chooseGridSpace(NumCast(this.props.layoutDoc['_backgroundGrid-spacing'], 50));
        const shiftX = (this.props.isAnnotationOverlay ? 0 : (-this.props.panX() % gridSpace) - gridSpace) * this.props.zoomScaling();
        const shiftY = (this.props.isAnnotationOverlay ? 0 : (-this.props.panY() % gridSpace) - gridSpace) * this.props.zoomScaling();
        const renderGridSpace = gridSpace * this.props.zoomScaling();
        const w = this.props.PanelWidth() / this.props.nativeDimScaling() + 2 * renderGridSpace;
        const h = this.props.PanelHeight() / this.props.nativeDimScaling() + 2 * renderGridSpace;
        const strokeStyle = Doc.ActiveDashboard?.colorScheme === ColorScheme.Dark ? 'rgba(255,255,255,0.5)' : 'rgba(0, 0,0,0.5)';
        return !this.props.nativeDimScaling() ? null : (
            <canvas
                className="collectionFreeFormView-grid"
                width={w}
                height={h}
                style={{ transform: `translate(${shiftX}px, ${shiftY}px)` }}
                ref={el => {
                    const ctx = el?.getContext('2d');
                    if (ctx) {
                        const Cx = this.props.cachedCenteringShiftX % renderGridSpace;
                        const Cy = this.props.cachedCenteringShiftY % renderGridSpace;
                        ctx.lineWidth = Math.min(1, Math.max(0.5, this.props.zoomScaling()));
                        ctx.setLineDash(gridSpace > 50 ? [3, 3] : [1, 5]);
                        ctx.clearRect(0, 0, w, h);
                        if (ctx) {
                            ctx.strokeStyle = strokeStyle;
                            ctx.beginPath();
                            for (let x = Cx - renderGridSpace; x <= w - Cx; x += renderGridSpace) {
                                ctx.moveTo(x, Cy - h);
                                ctx.lineTo(x, Cy + h);
                            }
                            for (let y = Cy - renderGridSpace; y <= h - Cy; y += renderGridSpace) {
                                ctx.moveTo(Cx - w, y);
                                ctx.lineTo(Cx + w, y);
                            }
                            ctx.stroke();
                        }
                    }
                }}
            />
        );
    }
}

export function CollectionBrowseClick(dv: DocumentView, clientX: number, clientY: number) {
    const browseTransitionTime = 500;
    SelectionManager.DeselectAll();
    DocumentManager.Instance.showDocument(dv.rootDoc, { zoomScale: 0.8, willZoomCentered: true }, (focused: boolean) => {
        if (!focused) {
            const selfFfview = !dv.rootDoc._isGroup && dv.ComponentView instanceof CollectionFreeFormView ? dv.ComponentView : undefined;
            let containers = dv.props.docViewPath();
            let parFfview = dv.props.CollectionFreeFormDocumentView?.().props.CollectionFreeFormView;
            for (var cont of containers) {
                parFfview = parFfview ?? cont.props.CollectionFreeFormDocumentView?.().props.CollectionFreeFormView;
            }
            while (parFfview?.rootDoc._isGroup) parFfview = parFfview.props.CollectionFreeFormDocumentView?.().props.CollectionFreeFormView;
            const ffview = selfFfview && selfFfview.rootDoc[selfFfview.scaleFieldKey] !== 0.5 ? selfFfview : parFfview; // if focus doc is a freeform that is not at it's default 0.5 scale, then zoom out on it.  Otherwise, zoom out on the parent ffview
            ffview?.zoomSmoothlyAboutPt(ffview.getTransform().transformPoint(clientX, clientY), 0.5, browseTransitionTime);
            Doc.linkFollowHighlight(dv?.props.Document, false);
        }
    });
}
ScriptingGlobals.add(CollectionBrowseClick);
ScriptingGlobals.add(function nextKeyFrame(readOnly: boolean) {
    !readOnly && (SelectionManager.Views()[0].ComponentView as CollectionFreeFormView)?.changeKeyFrame();
});
ScriptingGlobals.add(function prevKeyFrame(readOnly: boolean) {
    !readOnly && (SelectionManager.Views()[0].ComponentView as CollectionFreeFormView)?.changeKeyFrame(true);
});
ScriptingGlobals.add(function curKeyFrame(readOnly: boolean) {
    const selView = SelectionManager.Views();
    if (readOnly) return selView[0].ComponentView?.getKeyFrameEditing?.() ? Colors.MEDIUM_BLUE : 'transparent';
    runInAction(() => selView[0].ComponentView?.setKeyFrameEditing?.(!selView[0].ComponentView?.getKeyFrameEditing?.()));
});
ScriptingGlobals.add(function pinWithView(pinContent: boolean) {
    SelectionManager.Views().forEach(view =>
        view.props.pinToPres(view.rootDoc, {
            currentFrame: Cast(view.rootDoc.currentFrame, 'number', null),
            pinData: {
                poslayoutview: pinContent,
                dataview: pinContent,
            },
            pinViewport: MarqueeView.CurViewBounds(view.rootDoc, view.props.PanelWidth(), view.props.PanelHeight()),
        })
    );
});
ScriptingGlobals.add(function bringToFront() {
    SelectionManager.Views().forEach(view => view.props.CollectionFreeFormDocumentView?.().props.CollectionFreeFormView.bringToFront(view.rootDoc));
});
ScriptingGlobals.add(function sendToBack(doc: Doc) {
    SelectionManager.Views().forEach(view => view.props.CollectionFreeFormDocumentView?.().props.CollectionFreeFormView.bringToFront(view.rootDoc, true));
});
ScriptingGlobals.add(function resetView() {
    SelectionManager.Docs().forEach(doc => {
        doc._freeform_panX = doc._freeform_panY = 0;
        doc._freeform_scale = 1;
    });
});
