@trebco/treb 23.6.2 → 25.0.0-rc1

package/treb-base-types/src/table.ts

@@ -0,0 +1,109 @@
+/*
+ * This file is part of TREB.
+ *
+ * TREB is free software: you can redistribute it and/or modify it under the 
+ * terms of the GNU General Public License as published by the Free Software 
+ * Foundation, either version 3 of the License, or (at your option) any 
+ * later version.
+ *
+ * TREB is distributed in the hope that it will be useful, but WITHOUT ANY 
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 
+ * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more 
+ * details.
+ *
+ * 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-2023 trebco, llc. 
+ * info@treb.app
+ * 
+ */
+
+
+import type { IArea } from './area';
+import type { TableTheme } from './theme';
+
+export type TableSortType = 'text'|'numeric'|'auto';
+
+export interface TableSortOptions {
+
+  /** 
+   * when sorting, column is relative to the table (and 0-based). so the 
+   * first column in the table is 0, regardless of where the table is in 
+   * the spreadsheet. defaults to 0, if not specified.
+   */
+  column: number; 
+
+  /** 
+   * sort type. defaults to 'auto'. 'auto' looks at the values in the column,
+   * and uses text sort if there are more strings, or numeric if there are 
+   * more numbers. if it's even, sorts as text.
+   */
+  type: TableSortType;
+
+  /** ascending sort. defaults to true. */
+  asc: boolean;
+
+}
+
+/** @internal */
+export const DefaultTableSortOptions: TableSortOptions = {
+  column: 0,
+  type: 'auto',
+  asc: true,
+};
+
+/**
+ * struct representing a table
+ */
+export interface Table {
+
+  /** 
+   * table must have a name
+   */
+  name: string;
+
+  /**
+   * column names. these are the same (icase) as text in the first row
+   */
+
+  /** table area */
+  area: IArea;
+
+  /** 
+   * table column headers. normalize case before inserting.
+   */
+  columns?: string[];
+
+  /**
+   * table has a totals row. this impacts layout and what's included
+   * in the range when you refer to a column. also on import/export, the
+   * AutoFilter element should exclude the totals row.
+   * 
+   * NOTE: xlsx actually uses an integer for this -- can it be > 1?
+   */
+  totals_row?: boolean;
+
+  /** 
+   * table is sortable. defaults to true. if false, disables UI sorting. 
+   */
+  sortable?: boolean;
+
+  /**
+   * theme for table. we have a default, but you can set explicitly.
+   */
+  theme?: TableTheme;
+
+  /** 
+   * sort data. sorts are hard, meaning we actually move data around. 
+   * (not meaning difficult). we may keep track of the last sort so we 
+   * can toggle asc/desc, for example. atm this will not survive serialization.
+   */
+  sort?: {
+    column: number;
+    type: TableSortType;
+    asc: boolean;
+  }
+
+}
+

package/treb-base-types/src/text_part.ts

@@ -0,0 +1,54 @@
+/*
+ * This file is part of TREB.
+ *
+ * TREB is free software: you can redistribute it and/or modify it under the 
+ * terms of the GNU General Public License as published by the Free Software 
+ * Foundation, either version 3 of the License, or (at your option) any 
+ * later version.
+ *
+ * TREB is distributed in the hope that it will be useful, but WITHOUT ANY 
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 
+ * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more 
+ * details.
+ *
+ * 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-2023 trebco, llc. 
+ * info@treb.app
+ * 
+ */
+
+export enum TextPartFlag {
+
+  /** just render */
+  default = 0,
+
+  /** not rendered, but included in layout (spacing) */
+  hidden = 1,
+
+  /** takes up all available space */
+  padded = 2,
+
+  /** date component, needs to be filled */
+  date_component = 3,
+
+  /** special flag for minutes (instead of months), which is contextual */
+  date_component_minutes = 4,
+
+  /** literal (@): reflect the original */
+  literal = 5,
+
+  /** formatting (e.g. [red]) */
+  formatting = 6,
+
+  /* * testing, for complex 
+  italic = 7,
+  */
+
+}
+
+export interface TextPart {
+  text: string;
+  flag?: TextPartFlag;
+}