@trebco/treb 32.13.2 → 36.1.2

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

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */
@@ -79,7 +79,7 @@ import { GridLayout } from '../layout/grid_layout';
 import { OverlayEditor } from '../editors/overlay_editor';
 
 import { TileRenderer } from '../render/tile_renderer';
-import type { GridEvent } from './grid_events';
+import type { GridEvent, GridSelectionEvent } from './grid_events';
 import { ErrorCode } from './grid_events';
 
 import type { 
@@ -278,7 +278,7 @@ export class Grid extends GridBase {
   private autocomplete?: Autocomplete;
 
   /** formula bar editor (optional) */
-  private formula_bar?: FormulaBar;
+  protected formula_bar?: FormulaBar;
 
   private RESIZE_PIXEL_BUFFER = 5;
 
@@ -318,14 +318,14 @@ export class Grid extends GridBase {
   /**
    * the main selection for interacting with the spreadsheet
    */
-  private readonly primary_selection: GridSelection = {
+  protected readonly primary_selection: GridSelection = {
     target: { row: 0, column: 0 },
     area: new Area({ row: 0, column: 0 }),
     empty: true,
   };
 
   /** reusing type. FIXME? we don't need a target */
-  private readonly spill_selection: GridSelection = {
+  protected readonly spill_selection: GridSelection = {
     target: { row: 0, column: 0 },
     area: new Area({ row: 0, column: 0 }),
     empty: true,
@@ -334,7 +334,7 @@ export class Grid extends GridBase {
   /**
    * active selection when selecting arguments (while editing)
    */
-  private readonly active_selection: GridSelection = {
+  protected readonly active_selection: GridSelection = {
     target: { row: 0, column: 0 },
     area: new Area({ row: 0, column: 0 }),
     empty: true,
@@ -476,6 +476,7 @@ export class Grid extends GridBase {
       let value = cell.value;
 
       // seems like we're using a loop function unecessarily
+      
       if (r1c1 && value && cell.type === ValueType.formula) {
         value = this.FormatR1C1(value, { row, column })[0][0];
       }
@@ -1293,7 +1294,9 @@ export class Grid extends GridBase {
     // should already be added, right?
 
     for (const element of this.active_sheet.annotations) {
-      this.AddAnnotation(element, true);
+      if (!this.headless) {
+        this.AddAnnotation(element, true);
+      }
     }
 
     // handle any necessary activation tasks
@@ -2082,7 +2085,16 @@ export class Grid extends GridBase {
         }
 
         this.external_editor.AttachNodes(config.nodes, config.assume_formula ?? true);
- 
+        this.external_editor.key_event_callback = (event: KeyboardEvent) => {
+          
+          event.stopPropagation();
+          event.preventDefault();
+
+          // ??
+          this.OverlayKeyDown(event);
+
+        };
+
       }
       else {
         if (this.external_editor) {
@@ -2205,6 +2217,8 @@ export class Grid extends GridBase {
                 row: source.row + r,
                 column: source.column + c,
               },
+              r1c1_force_relative: true,
+              r1c1_proper_semantics: true,
             });
           }
         }
@@ -2836,12 +2850,14 @@ export class Grid extends GridBase {
     // effects of clearing the formula bar and so on
 
     if (!selecting_argument) {
-      this.ClearSelection(this.primary_selection);
 
       if (candidate.selection && !candidate.selection.empty) {
         this.Select(this.primary_selection,
           new Area(candidate.selection.area.start, candidate.selection.area.end),
-          candidate.selection.target);
+          candidate.selection.target, undefined, 'sheet-change');
+      }
+      else {
+        this.ClearSelection(this.primary_selection, 'sheet-change');
       }
 
     }
@@ -3090,6 +3106,12 @@ export class Grid extends GridBase {
           this.HandleAddressLabelEvent(event.text)
           break;
 
+        case 'toggle-reference':
+          if (this.SelectingArgument() && !this.active_selection?.empty) {
+            this.UpdateSelectedArgument(this.active_selection, true);
+          }
+          break;
+
         case 'stop-editing':
 
           if (this.pending_reset_selection) {
@@ -3326,7 +3348,7 @@ export class Grid extends GridBase {
 
   }
 
-  private Repaint(force = false, full_tile = false, force_headers = false) {
+  protected Repaint(force = false, full_tile = false, force_headers = false) {
 
     if (this.headless || !this.tile_renderer) { return; }
 
@@ -4079,7 +4101,7 @@ export class Grid extends GridBase {
 
   }
 
-  private HideHoverInfo() {
+  protected HideHoverInfo() {
 
     this.layout.HideTitle();
     this.layout.HideTooltip();
@@ -4838,9 +4860,80 @@ export class Grid extends GridBase {
     
   }
 
-  private UpdateSelectedArgument(selection: GridSelection) {
+  protected CreateTypedReferences(start: ICellAddress, end?: ICellAddress) {
+    const references: string[] = [];
+
+    // five cases: (1) one cell; (2) range: (3) rows; (4) columns; (5) all 
+
+    let single = false;
+
+    if (end) {
+      single = (start.row === end.row && start.column === end.column);
+    }
+
+    if (start.row === Infinity) {
+
+      // case 3/5
+
+      // ...
+    }
+    else if (start.column === Infinity) {
+
+      // case 4
+
+      // ...
+    }
+    else if (!end || single) {
 
-    // console.info("USA", selection);
+      // case 1
+
+      start.absolute_column = false;
+      start.absolute_row = false;
+      references.push(Area.CellAddressToLabel(start));
+      
+      start.absolute_column = true;
+      start.absolute_row = true;
+      references.push(Area.CellAddressToLabel(start));
+
+      start.absolute_column = true;
+      start.absolute_row = false;
+      references.push(Area.CellAddressToLabel(start));
+
+      start.absolute_column = false;
+      start.absolute_row = true;
+      references.push(Area.CellAddressToLabel(start));
+      
+    }
+    else {
+
+      // case 2
+
+      start.absolute_column = end.absolute_column = false;
+      start.absolute_row = end.absolute_row = false;
+      references.push(Area.CellAddressToLabel(start) + ':' + Area.CellAddressToLabel(end));
+      
+      start.absolute_column = end.absolute_column = true;
+      start.absolute_row = end.absolute_row = true;
+      references.push(Area.CellAddressToLabel(start) + ':' + Area.CellAddressToLabel(end));
+
+      start.absolute_column = end.absolute_column = true;
+      start.absolute_row = end.absolute_row = false;
+      references.push(Area.CellAddressToLabel(start) + ':' + Area.CellAddressToLabel(end));
+
+      start.absolute_column = end.absolute_column = false;
+      start.absolute_row = end.absolute_row = true;
+      references.push(Area.CellAddressToLabel(start) + ':' + Area.CellAddressToLabel(end));
+      
+    }
+
+    // ...other cases TODO...
+
+    return references;
+  }
+
+  private UpdateSelectedArgument(selection: GridSelection, toggle_reference_type = false) {
+
+    // console.info("USA", selection, toggle_reference_type);
 
     // if this is a single merged block, we want to insert it as the
     // root cell and not the range.
@@ -4850,34 +4943,55 @@ export class Grid extends GridBase {
 
     let label = this.model.named.MatchSelection(selection.area, target);
 
+    // this seems like a clumsy way to do it, but for now...
+
+    let typed_reference_list: string[] = [];
+
     if (!label) {
 
       label = selection.area.spreadsheet_label;
       if (data.merge_area && data.merge_area.Equals(selection.area)) {
         label = Area.CellAddressToLabel(data.merge_area.start);
+        typed_reference_list = this.CreateTypedReferences({...data.merge_area.start});
+      }
+      else {
+        typed_reference_list = this.CreateTypedReferences({
+          ...selection.area.start
+        }, {
+          ...selection.area.end
+        });
       }
 
       if (this.external_editor_config || this.active_sheet.id !== this.editing_cell.sheet_id) {
-        const name = this.active_sheet.name;
+        let name = this.active_sheet.name;
+        if (QuotedSheetNameRegex.test(name)) {
+          name = `'${name}'`;
+        }
+        label = name + `!${label}`;
+        typed_reference_list = typed_reference_list.map(entry => name + entry);
 
+        /*
         if (QuotedSheetNameRegex.test(name)) {
           label = `'${name}'!${label}`;
         }
         else {
           label = `${name}!${label}`;
         }
+        */
       }
 
+      // console.info(typed_reference_list);
+
     }
 
     // the external editor should just handle normal select events
     // for now, we might update that in the future.
 
     if (this.overlay_editor?.editing && this.overlay_editor.selecting) {
-      this.overlay_editor.InsertReference(label);
+      this.overlay_editor.InsertReference(label, toggle_reference_type, typed_reference_list);
     }
     else if (this.formula_bar && this.formula_bar.selecting) {
-      this.formula_bar.InsertReference(label);
+      this.formula_bar.InsertReference(label, toggle_reference_type, typed_reference_list);
     }
     else if (this.external_editor_config) {
 
@@ -4911,7 +5025,7 @@ export class Grid extends GridBase {
    *
    * FIXME: why is this not an accessor?
    */
-  private SelectingArgument(): boolean {
+  protected SelectingArgument(): boolean {
     return (this.overlay_editor?.editing && this.overlay_editor?.selecting)
       || (this.formula_bar && this.formula_bar.selecting)
       || (!!this.external_editor_config);
@@ -5081,7 +5195,7 @@ export class Grid extends GridBase {
         case '/':
           event.stopPropagation();
           event.preventDefault();
-          this.SelectArrayOrTable();
+          this.SelectArrayOrTable(selection);
           break;
 
         default:
@@ -5184,6 +5298,23 @@ export class Grid extends GridBase {
     }
     else {
 
+      if (event.key === 'F4') {
+
+        // we're always intercepting f4, although we only actual handle it
+        // if you are selecting a cell.
+        
+        event.stopPropagation();
+        event.preventDefault();
+
+        if (selecting_argument && !selection.empty) {
+          this.UpdateSelectedArgument(selection, true);
+        }
+
+        return;
+
+      }
+      
+      
       // ignore function keys 
       
       if (/^F\d+$/.test(event.key)) {
@@ -5283,30 +5414,35 @@ export class Grid extends GridBase {
    * select the array containing the current cell, if any. if there's no
    * array, do nothing. updated to support selecting tables as well as arrays.
    */
-  private SelectArrayOrTable() {
+  protected SelectArrayOrTable(target_selection: GridSelection) {
 
-    if (this.primary_selection.empty) {
+    if (target_selection.empty) {
       return;
     }
 
-    const cell = this.active_sheet.CellData(this.primary_selection.target);
+    const cell = this.active_sheet.CellData(target_selection.target);
 
     if (!cell || (!cell.area && !cell.table && !cell.spill)) {
       return;
     }
 
     if (cell.area) {
-      this.Select(this.primary_selection, cell.area, cell.area.start);
+      this.Select(target_selection, cell.area, cell.area.start);
     }
     if (cell.spill) {
-      this.Select(this.primary_selection, cell.spill, cell.spill.start);
+      this.Select(target_selection, cell.spill, cell.spill.start);
     }
     if (cell.table) {
       const area = new Area(cell.table.area.start, cell.table.area.end);
-      this.Select(this.primary_selection, area, area.start);
+      this.Select(target_selection, area, area.start);
     }
 
-    this.RenderSelections();
+    if (this.SelectingArgument()) {
+      this.UpdateSelectedArgument(target_selection);
+    }
+    else {
+      this.RenderSelections();
+    }
 
   }
 
@@ -5314,7 +5450,7 @@ export class Grid extends GridBase {
    * render selections. we are wrapping this up in a method so we can
    * hide the primary selection in some cases (one case).
    */
-  private RenderSelections(rerender = true) {
+  protected RenderSelections(rerender = true) {
 
     const show_primary_selection = this.hide_selection ? false :
       (!this.editing_state) || (this.editing_cell.sheet_id === this.active_sheet.id);
@@ -5335,7 +5471,7 @@ export class Grid extends GridBase {
    * using ctrl+arrow. selection jumps across all populated cells in
    * a given direction for a given row/column).
    */
-  private BlockSelection(selection: GridSelection, expand_selection: boolean,
+  protected BlockSelection(selection: GridSelection, expand_selection: boolean,
     columns: number, rows: number, render = true): boolean {
 
     // select the containing block. note that we do not handle
@@ -5503,7 +5639,7 @@ export class Grid extends GridBase {
    * of commands. the former is the default for editor commits; the latter
    * is used for paste.
    */
-  private SetInferredType(selection: GridSelection, value: string|undefined, array = false, exec = true, apply_style?: CellStyle) {
+  protected SetInferredType(selection: GridSelection, value: string|undefined, array = false, exec = true, apply_style?: CellStyle) {
 
     // console.info("SIT", {apply_style});
 
@@ -5524,7 +5660,7 @@ export class Grid extends GridBase {
     else if (array) {
 
       for (const cell of this.active_sheet.cells.Iterate(selection.area, false)) {
-        if (cell.area) {
+        if (cell?.area) {
           this.Error(ErrorCode.array);
           return;
         }
@@ -6289,7 +6425,7 @@ export class Grid extends GridBase {
   /** 
    * if the address is outside of current extent, expand 
    */
-  private EnsureAddress(address: ICellAddress, step = 8, toll_layout = false): boolean {
+  protected EnsureAddress(address: ICellAddress, step = 8, toll_layout = false): boolean {
 
     let expanded = false;
 
@@ -6334,7 +6470,7 @@ export class Grid extends GridBase {
    * behavior, at least for now, we'll make a parameter to disable. but it
    * should probably not render.
    */
-  private AdvanceSelection(
+  protected AdvanceSelection(
     delta: Extent,
     selection: GridSelection,
     within_selection = false,
@@ -6703,8 +6839,8 @@ export class Grid extends GridBase {
   /**
    * utility method, internally calls Select with an undefined area
    */
-  private ClearSelection(selection: GridSelection) {
-    this.Select(selection);
+  protected ClearSelection(selection: GridSelection, reason?: GridSelectionEvent['reason']) {
+    this.Select(selection, undefined, undefined, undefined, reason);
   }
 
   private HideGridSelection() {
@@ -6738,7 +6874,7 @@ export class Grid extends GridBase {
    * cell of the selection area
    * @param preserve_target preserve existing selection target
    */
-  private Select(selection: GridSelection, area?: Area, target?: ICellAddress, preserve_target = false) {
+  protected Select(selection: GridSelection, area?: Area, target?: ICellAddress, preserve_target = false, reason?: GridSelectionEvent['reason']) {
 
     if (!selection.empty) {
       if (preserve_target) target = selection.target;
@@ -6826,6 +6962,7 @@ export class Grid extends GridBase {
       this.grid_events.Publish({
         type: 'selection',
         selection: this.primary_selection,
+        reason,
       });
 
       this.UpdateAddressLabel();
@@ -6846,7 +6983,7 @@ export class Grid extends GridBase {
   /**
    *
    */
-  private UpdateFormulaBarFormula(override?: string) {
+  protected UpdateFormulaBarFormula(override?: string) {
 
     this.layout.HideDropdownCaret();
 
@@ -6944,7 +7081,7 @@ export class Grid extends GridBase {
    * default will show count/sum/average of numbers, either real 
    * or complex.
    */
-  private RenderStats(values: CellValue|CellValue[][]): StatsEntry[] {
+  protected RenderStats(values: CellValue|CellValue[][]): StatsEntry[] {
 
     // we don't handle single values
 
@@ -7052,7 +7189,7 @@ export class Grid extends GridBase {
     }
   }
 
-  private UpdateAddressLabelArea(selection: GridSelection) {
+  protected UpdateAddressLabelArea(selection: GridSelection) {
     if (!selection.empty && !selection.area.entire_sheet) {
       if (selection.area.entire_column) {
         this.UpdateAddressLabel(undefined, selection.area.columns + 'C');
@@ -7070,7 +7207,7 @@ export class Grid extends GridBase {
     }
   }
 
-  private UpdateAddressLabel(selection = this.primary_selection, text?: string) {
+  protected UpdateAddressLabel(selection = this.primary_selection, text?: string) {
 
     if (!this.formula_bar) { return; }
 
@@ -7908,8 +8045,12 @@ export class Grid extends GridBase {
     const width = Math.round((command.width || 0) / this.scale);
 
     if (auto) {
+
+      // defaults to true if not provided
+      const allow_shrinking = !(command.allow_shrinking === false);
+
       for (const entry of column) {
-        this.AutoSizeColumn(sheet, entry, true);
+        this.AutoSizeColumn(sheet, entry, allow_shrinking);
       }
     }
     else {

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

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */
@@ -603,14 +603,17 @@ export class GridBase {
   /**
    * API method
    *
-   * @param column column, columns, or undefined means all columns
-   * @param width target width, or undefined means auto-size
+   * @param column - column, columns, or undefined means all columns
+   * @param width - target width, or undefined means auto-size
+   * @param allow_shrinking - for auto-size, allow shrinking. defaults to true. 
+   * set false to disallow shrinking.
    */
-  public SetColumnWidth(column?: number | number[], width?: number): void {
+  public SetColumnWidth(column?: number | number[], width?: number, allow_shrinking?: boolean): void {
     this.ExecCommand({
       key: CommandKey.ResizeColumns,
       column,
       width,
+      allow_shrinking,
     });
   }
 

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

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */
@@ -198,6 +198,12 @@ export interface ResizeColumnsCommand {
   key: CommandKey.ResizeColumns;
   column?: number|number[];
   width?: number;
+
+  /** 
+   * for auto-resized columns, allow shrinking. defaults to true for 
+   * back-compat, so you must explicitly set it to false to disable shrinking.
+   */
+  allow_shrinking?: boolean;
   sheet_id?: number;
 }
 

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

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */
@@ -53,6 +53,7 @@ export interface SheetChangeEvent {
 export interface GridSelectionEvent {
   type: 'selection';
   selection: GridSelection;
+  reason?: 'sheet-change';
 }
 
 export interface GridAlternateSelectionEvent {

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

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

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

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

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

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

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

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

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

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

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

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-grid/src/util/fontmetrics.ts

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-grid/src/util/ua.ts

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-parser/src/csv-parser.ts

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-parser/src/index.ts

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-parser/src/md-parser.ts

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

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

@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License along 
  * with TREB. If not, see <https://www.gnu.org/licenses/>. 
  *
- * Copyright 2022-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */