@trebco/treb 26.0.6 → 27.0.1

package/treb-embed/style/mouse-mask.scss

@@ -19,7 +19,7 @@
  * 
  */
 
-.treb-main {
+.treb-main.treb-main {
 
   /**
    * event mask for mouse drag. currently this is added _within_ node 

package/treb-embed/style/note.scss

@@ -19,7 +19,7 @@
  * 
  */
 
-.treb-main {
+.treb-main.treb-main {
 
   // are these exactly the same? clearly we copied-and-pasted
   // at first. seems like we could consolidate.

package/treb-embed/style/overlay-editor.scss

@@ -19,7 +19,7 @@
  * 
  */
 
-.treb-main {
+.treb-main.treb-main {
 
   .treb-grid {
 

package/treb-embed/style/spinner.scss

@@ -19,7 +19,7 @@
  * 
  */
 
-.treb-main {
+.treb-main.treb-main {
 
   .treb-spinner {
 

package/treb-embed/style/tab-bar.scss

@@ -19,7 +19,7 @@
  * 
  */
 
-.treb-main {
+.treb-main.treb-main {
 
   .treb-mouse-mask .ghost-tab {
     position: fixed;

package/treb-embed/style/table.scss

@@ -19,7 +19,7 @@
  * 
  */
 
-.treb-main {
+.treb-main.treb-main {
 
   .treb-sort-button {
 

package/treb-embed/style/theme-defaults.scss

@@ -50,7 +50,7 @@ $text-reference-color-3: rgb(182, 109, 13);
 $text-reference-color-4: rgb(33, 118, 174);
 $text-reference-color-5: rgb(254, 47, 1);
 
-.treb-main {
+.treb-main.treb-main {
 
   /** 
    * move primary selection focus color to focus-within on the top-level 

package/treb-embed/style/toolbar.scss

@@ -18,7 +18,7 @@ $border-radius: 3px;
 $split-font-size: 10px;
 $swatch-size: 18px;
 
-.treb-main {
+.treb-main.treb-main {
 
   .treb-layout-header {
     

package/treb-embed/style/tooltip.scss

@@ -19,7 +19,7 @@
  * 
  */
 
-.treb-main {
+.treb-main.treb-main {
 
   .treb-tooltip {
 

package/treb-embed/style/treb-icons.scss

@@ -3,7 +3,7 @@
  * scope these to the node and we can use shorter names
  */
  
-.treb-main {
+.treb-main.treb-main {
 
   // --- other -----------------------------------------------------------------
 

package/treb-export/src/export2.ts

@@ -34,7 +34,7 @@ const XMLDeclaration = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\
 import { template } from './template-2';
 import type { SerializedSheet } from 'treb-grid';
 
-import type { IArea, ICellAddress, CellValue, DataValidation,
+import type { IArea, ICellAddress, CellValue, DataValidation, CellStyle,
          AnnotationLayout, Corner as LayoutCorner, Cell, Rectangle } from 'treb-base-types';
 import { Area, Cells, ValueType, Style, ValidationType } from 'treb-base-types';
 
@@ -527,7 +527,7 @@ export class Exporter {
   public RowStyle(sheet: SerializedSheet, style_cache: StyleCache, row: number) {
 
     const cell_style_refs = sheet.styles || sheet.cell_style_refs || [];
-    const list: Style.Properties[] = [sheet.sheet_style];
+    const list: CellStyle[] = [sheet.sheet_style];
 
     if (sheet.row_style) {
       let style = sheet.row_style[row];
@@ -550,7 +550,7 @@ export class Exporter {
   public ColumnStyle(sheet: SerializedSheet, style_cache: StyleCache, column: number) {
 
     const cell_style_refs = sheet.styles || sheet.cell_style_refs || [];
-    const list: Style.Properties[] = [sheet.sheet_style];
+    const list: CellStyle[] = [sheet.sheet_style];
 
     if (sheet.column_style) {
       let style = sheet.column_style[column];
@@ -570,14 +570,14 @@ export class Exporter {
 
   }
 
-  public StyleFromCell(sheet: SerializedSheet, style_cache: StyleCache, row: number, column: number, style: Style.Properties = {}) {
+  public StyleFromCell(sheet: SerializedSheet, style_cache: StyleCache, row: number, column: number, style: CellStyle = {}) {
 
     //if (row === 2 && column === 5)
     //  console.info("SFC", JSON.stringify(style, undefined, 2));
 
     const cell_style_refs = sheet.styles || sheet.cell_style_refs || [];
 
-    const list: Style.Properties[] = [sheet.sheet_style];
+    const list: CellStyle[] = [sheet.sheet_style];
 
     if (sheet.row_pattern && sheet.row_pattern.length) {
       list.push(sheet.row_pattern[row % sheet.row_pattern.length]);
@@ -1298,7 +1298,7 @@ export class Exporter {
       const sparklines: Array<{
         address: ICellAddress,
         formula: string,
-        style?: Style.Properties,
+        style?: CellStyle,
       }> = [];
 
       const merges: Area[] = [];

package/treb-export/src/workbook-style2.ts

@@ -22,7 +22,7 @@
 // import * as ElementTree from 'elementtree';
 // import { Element, ElementTree as Tree } from 'elementtree';
 
-import { Style } from 'treb-base-types';
+import { type CompositeBorderEdge, Style, type CellStyle, type PropertyKeys } from 'treb-base-types';
 import { Theme } from './workbook-theme2';
 import { NumberFormatCache } from 'treb-format';
 import { XMLUtils } from './xml-utils';
@@ -237,12 +237,12 @@ export class StyleCache {
 
   /// 
 
-  public StyleOptionsFromProperties(source: Style.Properties): StyleOptions {
+  public StyleOptionsFromProperties(source: CellStyle): StyleOptions {
 
-    const composite: Style.Properties = // Style.Composite(list);
+    const composite: CellStyle = // Style.Composite(list);
       JSON.parse(JSON.stringify(source));
 
-    for (const key of Object.keys(composite) as Style.PropertyKeys[]) {
+    for (const key of Object.keys(composite) as PropertyKeys[]) {
       if (composite[key] === 'none') {
         delete composite[key];
       }
@@ -297,7 +297,7 @@ export class StyleCache {
       }
     }
 
-    const TranslateBorder = (src: Style.CompositeBorderEdge, dest: BorderEdge) => {
+    const TranslateBorder = (src: CompositeBorderEdge, dest: BorderEdge) => {
       if (src.width) {
         dest.style = 'thin';
         if (src.color.text) {
@@ -399,22 +399,22 @@ export class StyleCache {
     // leave blank for bottom, default
 
     switch (composite.vertical_align) {
-      case Style.VerticalAlign.Top:
+      case 'top': // Style.VerticalAlign.Top:
         options.vertical_alignment = 'top';
         break;
-      case Style.VerticalAlign.Middle:
+      case 'middle': // Style.VerticalAlign.Middle:
         options.vertical_alignment = 'center';
         break;
     }
 
     switch (composite.horizontal_align) {
-      case Style.HorizontalAlign.Center:
+      case 'center': // Style.HorizontalAlign.Center:
         options.horizontal_alignment = 'center';
         break;
-      case Style.HorizontalAlign.Left:
+      case 'left': // Style.HorizontalAlign.Left:
         options.horizontal_alignment = 'left';
         break;
-      case Style.HorizontalAlign.Right:
+      case 'right': // Style.HorizontalAlign.Right:
         options.horizontal_alignment = 'right';
         break;
     }
@@ -446,9 +446,9 @@ export class StyleCache {
 
   ///
 
-  public CellXfToStyle(xf: CellXf): Style.Properties {
+  public CellXfToStyle(xf: CellXf): CellStyle {
 
-    const props: Style.Properties = {};
+    const props: CellStyle = {};
 
     // number format
 
@@ -625,25 +625,25 @@ export class StyleCache {
 
     switch (xf.horizontal_alignment) {
       case 'center':
-        props.horizontal_align = Style.HorizontalAlign.Center;
+        props.horizontal_align = 'center'; // Style.HorizontalAlign.Center;
         break;
       case 'right':
-        props.horizontal_align = Style.HorizontalAlign.Right;
+        props.horizontal_align = 'right'; // Style.HorizontalAlign.Right;
         break;
       case 'left':
-        props.horizontal_align = Style.HorizontalAlign.Left;
+        props.horizontal_align = 'left'; // Style.HorizontalAlign.Left;
         break;
     }
 
     switch (xf.vertical_alignment) {
       case 'center':
-        props.vertical_align = Style.VerticalAlign.Middle;
+        props.vertical_align = 'middle'; // Style.VerticalAlign.Middle;
         break;
       case 'top':
-        props.vertical_align = Style.VerticalAlign.Top;
+        props.vertical_align = 'top'; // Style.VerticalAlign.Top;
         break;
       case 'bottom':
-        props.vertical_align = Style.VerticalAlign.Bottom;
+        props.vertical_align = 'bottom'; // Style.VerticalAlign.Bottom;
         break;
     }
 
@@ -674,7 +674,7 @@ export class StyleCache {
   }
 
   /** map all cell xfs to styles; retain order */
-  public CellXfToStyles(): Style.Properties[] {
+  public CellXfToStyles(): CellStyle[] {
     return this.cell_xfs.map((xf) => this.CellXfToStyle(xf));
   }
 

package/treb-grid/src/editors/overlay_editor.ts

@@ -29,7 +29,7 @@
  */
 
 import type { Theme, CellValue, Rectangle, Cell } from 'treb-base-types';
-import { Style, ThemeColor2 } from 'treb-base-types';
+import { Style, ThemeColor2, type CellStyle } from 'treb-base-types';
 import { Yield } from 'treb-utils';
 import type { Parser } from 'treb-parser';
 import type { GridSelection } from '../types/grid_selection';
@@ -288,7 +288,7 @@ export class OverlayEditor extends FormulaEditorBase {
     this.active_cell = cell;
     this.target_address = {...gridselection.target};
 
-    const style: Style.Properties = cell.style || {};
+    const style: CellStyle = cell.style || {};
 
     this.edit_node.style.font = Style.Font(style, this.scale);
     this.edit_node.style.color = ThemeColor2(this.theme, style.text, 1);
@@ -303,11 +303,11 @@ export class OverlayEditor extends FormulaEditorBase {
     //  until v[x]? I think that may have been years ago...)
 
     switch (style.horizontal_align) {
-      case Style.HorizontalAlign.Right:
+      case 'right': // Style.HorizontalAlign.Right:
         this.edit_container.classList.remove('align-center', 'align-left');
         this.edit_container.classList.add('align-right');
         break;
-      case Style.HorizontalAlign.Center:
+      case 'center': // Style.HorizontalAlign.Center:
         this.edit_container.classList.remove('align-right', 'align-left');
         this.edit_container.classList.add('align-center');
         break;

package/treb-grid/src/render/tile_renderer.ts

@@ -22,6 +22,7 @@
 import type { ICellAddress, 
          PreparedText, RenderTextPart,
          Cell, Size, 
+         CellStyle,
          Theme} from 'treb-base-types';
 import { TextPartFlag, Style, ValueType, Area, Rectangle, ThemeColor, ThemeColor2 } from 'treb-base-types';
 
@@ -711,7 +712,7 @@ export class TileRenderer {
                      cell_width: number /*, override_text?: string*/ ): PreparedText {
 
     const strings: RenderTextPart[] = [];
-    const style: Style.Properties = cell.style || {};
+    const style: CellStyle = cell.style || {};
 
     let pad_entry: RenderTextPart | undefined;
     let composite_width = 0;
@@ -982,7 +983,7 @@ export class TileRenderer {
 
   }
 
-  protected ResolveColors(style: Style.Properties): Style.Properties {
+  protected ResolveColors(style: CellStyle): CellStyle {
 
     const resolved = {...style};
     resolved.text = { text: ThemeColor2(this.theme, style.text, 1) };
@@ -996,7 +997,7 @@ export class TileRenderer {
   protected RenderCellBorders(
     address: ICellAddress,
     context: CanvasRenderingContext2D,
-    style: Style.Properties,
+    style: CellStyle,
     left = 0, top = 0, width = 0, height = 0): void {
 
     // cell borders is one of those things that seems simple, even trivial, 
@@ -1312,7 +1313,7 @@ export class TileRenderer {
     note: boolean,
     address: ICellAddress,
     context: CanvasRenderingContext2D,
-    style: Style.Properties,
+    style: CellStyle,
     width: number, height: number, cell_left = 0, cell_top = 0): void {
 
     // so here we draw the background and the bottom and right grid edges.
@@ -1405,7 +1406,7 @@ export class TileRenderer {
       return {};
     }
 
-    let style: Style.Properties = cell.style ? {...cell.style} : {};
+    let style: CellStyle = cell.style ? {...cell.style} : {};
 
     if (cell.table) {
       style = this.view.active_sheet.CellStyleData(address, cell.table.theme || this.theme.table) || {};
@@ -1616,7 +1617,7 @@ export class TileRenderer {
 
     let horizontal_align = style.horizontal_align;
     if (!horizontal_align) {
-      horizontal_align = is_number ? Style.HorizontalAlign.Right : Style.HorizontalAlign.Left;
+      horizontal_align = is_number ? 'right' : 'left'; // Style.HorizontalAlign.Right : Style.HorizontalAlign.Left;
     }
 
     // NOTE: text rendering options (align, baseline) are set globally
@@ -1649,10 +1650,10 @@ export class TileRenderer {
         let overflow_pixels_left = 0;
         let overflow_pixels_right = 0;
 
-        if (horizontal_align === Style.HorizontalAlign.Center) {
+        if (horizontal_align === 'center' /* Style.HorizontalAlign.Center */ ) {
           overflow_pixels_left = overflow_pixels_right = delta / 2;
         }
-        else if (horizontal_align === Style.HorizontalAlign.Right) {
+        else if (horizontal_align === 'right' /* Style.HorizontalAlign.Right */ ) {
           overflow_pixels_left = delta;
         }
         else {
@@ -1884,10 +1885,10 @@ export class TileRenderer {
     let original_baseline = Math.round(height - 2 - (m2.block * line_height * (line_count - 1)) + WK); // switched baseline to "bottom"
 
     switch (style.vertical_align) {
-      case Style.VerticalAlign.Top:
+      case 'top': // Style.VerticalAlign.Top:
         original_baseline = Math.round(m2.block * line_height) + 1;
         break;
-      case Style.VerticalAlign.Middle:
+      case 'middle': // Style.VerticalAlign.Middle:
         original_baseline = Math.round((height - text_height) / 2 + m2.block * line_height);
         break;
     }
@@ -1905,10 +1906,10 @@ export class TileRenderer {
       for (let i = 0; i < count; i++) { text += '#'; }
       const text_width = context.measureText(text).width;
 
-      if (horizontal_align === Style.HorizontalAlign.Center) {
+      if (horizontal_align === 'center' /* Style.HorizontalAlign.Center */ ) {
         left = Math.round((width - text_width) / 2);
       }
-      else if (horizontal_align === Style.HorizontalAlign.Right) {
+      else if (horizontal_align === 'right' /* Style.HorizontalAlign.Right */ ) {
         left = width - this.cell_edge_buffer - text_width;
       }
 
@@ -1931,10 +1932,10 @@ export class TileRenderer {
         let line_width = 0;
         for (const part of line) { line_width += part.width; }
 
-        if (horizontal_align === Style.HorizontalAlign.Center) {
+        if (horizontal_align === 'center' /* Style.HorizontalAlign.Center */ ) {
           left = Math.round((width - line_width) / 2);
         }
-        else if (horizontal_align === Style.HorizontalAlign.Right) {
+        else if (horizontal_align === 'right' /* Style.HorizontalAlign.Right */ ) {
           left = width - this.cell_edge_buffer - line_width;
         }
 

package/treb-grid/src/types/annotation.ts

@@ -19,7 +19,7 @@
  * 
  */
 
-import type { ICellAddress, AnnotationLayout } from 'treb-base-types';
+import type { ICellAddress, AnnotationLayout, IRectangle } from 'treb-base-types';
 import { Rectangle } from 'treb-base-types';
 
 /**
@@ -79,6 +79,11 @@ export interface ViewData {
 
 }
 
+export interface ImageSize {
+  width: number; 
+  height: number;
+}
+
 export interface ImageAnnotationData {
   src: string;
 
@@ -88,10 +93,8 @@ export interface ImageAnnotationData {
    */
   scale: string; 
   
-  original_size: { 
-    width: number; 
-    height: number;
-  };
+  original_size: ImageSize;
+  
 }
 
 export type AnnotationType = 'treb-chart'|'image'|'external';
@@ -120,7 +123,7 @@ export interface AnnotationDataBase {
    * for serialization/deserialization. the actual rectangle is maintained
    * in the Annotation class.
    */
-  rect?: Partial<Rectangle>;
+  rect?: Partial<IRectangle>;
 
   /** annotation can be resized. this is advisory, for UI */
   resizable: boolean;

package/treb-grid/src/types/clipboard_data.ts

@@ -20,12 +20,12 @@
  */
 
 
-import type { ICellAddress, CellValue, ValueType, Style } from 'treb-base-types';
+import type { ICellAddress, CellValue, ValueType, CellStyle } from 'treb-base-types';
 
 export interface ClipboardCellData {
   address: ICellAddress;
   data: CellValue;
   type: ValueType;
-  style?: Style.Properties;
+  style?: CellStyle;
   array?: {rows: number, columns: number};
 }

package/treb-grid/src/types/data_model.ts

@@ -20,7 +20,7 @@
  */
 
 import type { Sheet } from './sheet';
-import type { IArea, ICellAddress, Table } from 'treb-base-types';
+import type { IArea, ICellAddress, Table, CellStyle } from 'treb-base-types';
 import type { SerializedSheet } from './sheet_types';
 import { NamedRangeCollection } from './named_range';
 import type { ExpressionUnit, UnitAddress, UnitStructuredReference, UnitRange } from 'treb-parser';
@@ -200,7 +200,7 @@ export class DataModel {
    * base style properties moved to model, so we can have a single
    * and consistent reference.
    */
-  public theme_style_properties: Style.Properties = JSON.parse(JSON.stringify(Style.DefaultProperties));
+  public theme_style_properties: CellStyle = JSON.parse(JSON.stringify(Style.DefaultProperties));
 
   /**
    * tables are global, because we need to reference them by name; and they

package/treb-grid/src/types/grid.ts

@@ -28,6 +28,8 @@ import type {
   ICellAddress,
   ImportedSheetData,
   Complex,
+  Color,
+  CellStyle,
   IRectangle} from 'treb-base-types';
   
 import {
@@ -1670,7 +1672,7 @@ export class Grid extends GridBase {
    * @param range 
    * @returns 
    */
-  public GetRangeStyle(range: ICellAddress|IArea, apply_theme = false): Style.Properties|Style.Properties[][]|undefined {
+  public GetRangeStyle(range: ICellAddress|IArea, apply_theme = false): CellStyle|CellStyle[][]|undefined {
 
     let sheet_id = 0;
 
@@ -1879,7 +1881,7 @@ export class Grid extends GridBase {
    *
    * API method
    */
-  public ApplyStyle(area?: Area, properties: Style.Properties = {}, delta = true): void {
+  public ApplyStyle(area?: Area, properties: CellStyle = {}, delta = true): void {
 
     if (!area) {
       if (this.primary_selection.empty) {
@@ -1949,7 +1951,7 @@ export class Grid extends GridBase {
   */
 
   /** updated API method, probably change the name */
-  public ApplyBorders2(area?: Area, borders: BorderConstants = BorderConstants.None, color?: Style.Color, width = 1): void {
+  public ApplyBorders2(area?: Area, borders: BorderConstants = BorderConstants.None, color?: Color, width = 1): void {
 
     if (!area) {
       if (this.primary_selection.empty) { return; }
@@ -4086,7 +4088,7 @@ export class Grid extends GridBase {
     }
 
     const data: CellValue[][] = [];
-    let style: Style.Properties[][] = [];
+    let style: CellStyle[][] = [];
 
     let source_columns = source_area.columns;
     let target_rows = target_area.rows;
@@ -4453,8 +4455,8 @@ export class Grid extends GridBase {
       }
       else {
 
-        const applied_style: Style.Properties = {};
-        const selected_style: Style.Properties =
+        const applied_style: CellStyle = {};
+        const selected_style: CellStyle =
           this.primary_selection.empty ? {} :
             this.active_sheet.CellData(this.primary_selection.target).style || {};
 
@@ -4932,7 +4934,7 @@ export class Grid extends GridBase {
               if (this.active_sheet.HasCellStyle({ ...address })) {
                 const test = this.active_sheet.CellData({ ...address });
                 if (test.style && test.style.number_format) {
-                  const style: Style.Properties = {
+                  const style: CellStyle = {
                     number_format: test.style.number_format,
                   };
                   // if (array) this.model.sheet.UpdateAreaStyle(selection.area, style, true, true);

package/treb-grid/src/types/grid_base.ts

@@ -40,7 +40,7 @@ import type { DataModel, MacroFunction, SerializedModel, SerializedNamedExpressi
 import type { Parser, UnitAddress} from 'treb-parser';
 import { type ExpressionUnit, IllegalSheetNameRegex, ParseCSV, ArgumentSeparatorType, DecimalMarkType } from 'treb-parser';
 import { Area, IsCellAddress, ValidationType, ValueType, DefaultTableSortOptions } from 'treb-base-types';
-import type { ICellAddress, IArea, Cell, CellValue , Style, Table, TableSortOptions, TableTheme, Complex } from 'treb-base-types';
+import type { ICellAddress, IArea, Cell, CellValue , Style, CellStyle, Table, TableSortOptions, TableTheme, Complex } from 'treb-base-types';
 import { Sheet } from './sheet';
 import type { FunctionDescriptor} from '../editors/autocomplete_matcher';
 import { AutocompleteMatcher, DescriptorType } from '../editors/autocomplete_matcher';
@@ -2254,15 +2254,15 @@ export class GridBase {
     }
     */
 
-    const top: Style.Properties = { border_top: width };
-    const bottom: Style.Properties = { border_bottom: width };
-    const left: Style.Properties = { border_left: width };
-    const right: Style.Properties = { border_right: width };
+    const top: CellStyle = { border_top: width };
+    const bottom: CellStyle = { border_bottom: width };
+    const left: CellStyle = { border_left: width };
+    const right: CellStyle = { border_right: width };
 
-    const clear_top: Style.Properties = { border_top: 0, border_top_fill: {} };
-    const clear_bottom: Style.Properties = { border_bottom: 0, border_bottom_fill: {} };
-    const clear_left: Style.Properties = { border_left: 0, border_left_fill: {} };
-    const clear_right: Style.Properties = { border_right: 0, border_right_fill: {} };
+    const clear_top: CellStyle = { border_top: 0, border_top_fill: {} };
+    const clear_bottom: CellStyle = { border_bottom: 0, border_bottom_fill: {} };
+    const clear_left: CellStyle = { border_left: 0, border_left_fill: {} };
+    const clear_right: CellStyle = { border_right: 0, border_right_fill: {} };
 
     // default to "none", which means "default"
 

package/treb-grid/src/types/grid_command.ts

@@ -19,7 +19,7 @@
  * 
  */
 
-import type { ICellAddress, IArea, Style, CellValue, Table, TableSortType, TableTheme } from 'treb-base-types';
+import type { ICellAddress, IArea, Style, CellStyle, Color, CellValue, Table, TableSortType, TableTheme } from 'treb-base-types';
 import type { ExpressionUnit } from 'treb-parser';
 import type { BorderConstants } from './border_constants';
 
@@ -268,7 +268,7 @@ export interface UpdateBordersCommand {
   area: IArea;
   borders: BorderConstants;
   // color?: string; // pending
-  color?: Style.Color;
+  color?: Color;
 
   /** defaults to one. optional for the case of "none" (remove borders) */
   width?: number;
@@ -278,7 +278,7 @@ export interface UpdateBordersCommand {
 export interface UpdateStyleCommand {
   key: CommandKey.UpdateStyle;
   area: IArea|ICellAddress;
-  style: Style.Properties;
+  style: CellStyle;
   delta?: boolean;
 }
 

package/treb-grid/src/types/grid_selection.ts

@@ -19,7 +19,7 @@
  * 
  */
 
-import { Area, type ICellAddress } from 'treb-base-types';
+import { Area, type IArea, type ICellAddress } from 'treb-base-types';
 
 /**
  * FIXME: this is broken. we treat this as a simple javascript object,
@@ -44,8 +44,30 @@ export interface GridSelection {
 
 }
 
+/**
+ * temporarily splitting into a serialized version that uses IArea instead
+ * of Area. we should do this for the actual selection type, but it breaks
+ * too many things atm to do that immediately. TODO/FIXME.
+ */
+export interface SerializedGridSelection {
+
+  /** target or main cell in the selection */
+  target: ICellAddress;
+
+  /** selection area */
+  area: IArea;
+
+  /** there is nothing selected, even though this object exists */
+  empty?: boolean;
+
+  /** for cacheing addtional selections. optimally don't serialize */
+  rendered?: boolean;
+
+}
+
 /**
  * create an empty selection
+ * @internal
  */
 export const CreateSelection = (): GridSelection => {
   return {
@@ -55,6 +77,9 @@ export const CreateSelection = (): GridSelection => {
   };
 };
 
+/**
+ * @internal
+ */
 export const CloneSelection = (rhs: GridSelection): GridSelection => {
   return JSON.parse(JSON.stringify(rhs));
 };