@trebco/treb 36.1.4 → 37.0.1

package/build/treb-base-types/src/style.js

@@ -0,0 +1,373 @@
+/*
+ * 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-2026 trebco, llc.
+ * info@treb.app
+ *
+ */
+const empty_json = JSON.stringify({}); // we could probably hard-code this
+const ThemeColorMap = {
+    'Background': 0,
+    'Text': 1,
+    'Background2': 2,
+    'Text2': 3,
+    'Accent': 4,
+    'Accent2': 5,
+    'Accent3': 6,
+    'Accent4': 7,
+    'Accent5': 8,
+    'Accent6': 9,
+};
+/*
+for (const [index, entry] of ThemeColorList.entries()) {
+  ThemeColorMap[entry] = index;
+}
+*/
+export const ThemeColorIndex = (color) => {
+    if (typeof color.theme === 'number') {
+        return color.theme;
+    }
+    return ThemeColorMap[color.theme] || 0;
+};
+export const IsHTMLColor = (color) => {
+    return !!color && (typeof color.text === 'string');
+};
+export const IsThemeColor = (color) => {
+    return !!color && (typeof color.theme !== 'undefined');
+};
+export const IsDefinedColor = (color) => {
+    return !!color && ((typeof color.text === 'string') ||
+        (typeof color.theme !== 'undefined'));
+};
+/**
+ * (finally) removing the old namespace. we keep this object around for
+ * some internal methods, but all the types have moved to the top-level
+ * of this module and need to be imported separately.
+ *
+ * we could theoretically build a backcompat module that re-exports all
+ * the types, but it's probably not necessary -- most updates will just
+ * require a find-and-replace (plus adding some imports).
+ *
+ * @internal
+ */
+export const Style = {
+    /**
+     * note that there are no default colors; those should be set
+     * in grid when style is applied. that way the default colors for
+     * border, text and background colors will be theme-dependent and
+     * can change.
+     *
+     * @internal
+     */
+    DefaultProperties: {
+        horizontal_align: '',
+        vertical_align: '',
+        number_format: 'General', // '0.######',   // use symbolic, e.g. "general"
+        nan: 'NaN',
+        font_size: { unit: 'em', value: 1 },
+        // font_size: { unit: 'pt', value: 10.5 },
+        // font_face: 'sans-serif',
+        bold: false, // drop "font_"
+        italic: false, // ...
+        underline: false, // ...
+        strike: false, // 
+        text: { theme: 1 },
+        border_top: 0, // adding defaults so these prune propery
+        border_left: 0,
+        border_right: 0,
+        border_bottom: 0,
+    },
+    /**
+     * this is a utility function for callers that use borders, to
+     * reduce testing and facilitate reusable methods
+     *
+     * @internal
+     */
+    CompositeBorders: (style) => {
+        return {
+            top: {
+                width: style.border_top || 0,
+                color: style.border_top_fill || {},
+            },
+            left: {
+                width: style.border_left || 0,
+                color: style.border_left_fill || {},
+            },
+            right: {
+                width: style.border_right || 0,
+                color: style.border_right_fill || {},
+            },
+            bottom: {
+                width: style.border_bottom || 0,
+                color: style.border_bottom_fill || {},
+            },
+        };
+    },
+    Serialize: (style) => {
+        const clone = JSON.parse(JSON.stringify(style));
+        // scrub border colors without widths
+        if (clone.border_bottom_fill && !clone.border_bottom) {
+            clone.border_bottom_fill = undefined;
+        }
+        if (clone.border_top_fill && !clone.border_top) {
+            clone.border_top_fill = undefined;
+        }
+        if (clone.border_left_fill && !clone.border_left) {
+            clone.border_left_fill = undefined;
+        }
+        if (clone.border_right_fill && !clone.border_right) {
+            clone.border_right_fill = undefined;
+        }
+        return JSON.stringify(clone);
+    },
+    /**
+     * merge. returns a new object, does not update dest in place.
+     * NOTE: if it does not update dest in place, then what would be
+     * the use case for a non-delta merge? (...)
+     *
+     * @internal
+     */
+    Merge: (dest, src, delta = true) => {
+        const properties = delta ? { ...dest, ...src } : { ...src };
+        return JSON.parse(JSON.stringify(properties));
+    },
+    /** @internal */
+    Composite: (list) => {
+        return JSON.parse(JSON.stringify(list.reduce((composite, item) => ({ ...composite, ...item }), {})));
+    },
+    /** @internal */
+    Empty: (style) => {
+        return JSON.stringify(style) === empty_json;
+    },
+    /* *
+     * this looks like a type guard, we should switch to a union
+     * type and then add real type guards
+     *
+     * @internal
+     * /
+    ValidColor: (color?: Color): boolean => {
+      return !!(color && (!color.none) && (color.text || color.theme || color.theme === 0));
+    },
+    */
+    /** @internal */
+    ParseFontSize: (text = '', default_unit = 'em') => {
+        const match = text.match(/(-*[\d.]+)\s*(\S*)/);
+        if (match) {
+            const value = Number(match[1]);
+            if (!value || isNaN(value) || value < 0) {
+                return {}; // invalid
+            }
+            const unit = match[2].toLowerCase() || default_unit;
+            if (unit === 'pt' || unit === 'em' || unit === '%' || unit === 'px') {
+                // return { font_size_unit: unit, font_size_value: value };
+                return {
+                    font_size: { unit, value },
+                };
+            }
+        }
+        return {};
+    },
+    /**
+     * returns the font size of the properties argument as a ratio of the
+     * base argument. this is intended to show the relative font size of
+     * a spreadsheet cell; so anything with no value should be "1", and
+     * everything else is relative to that.
+     *
+     * we prefer relative sizes (em, essentially) to fixed sizes because
+     * we may have different base font sizes on different platforms (we do,
+     * in fact, on windows because calibri is too small).
+     *
+     * using relative sizes helps ensure that it looks similar, if not
+     * identical, on different platforms.
+     *
+     * @internal
+     */
+    RelativeFontSize: (properties, base) => {
+        // we can assume (I think) that base will be either points or px; 
+        // there's no case where it should be relative. in fact, let's treat
+        // that as an error and return 1.
+        // note that if properties is relative (em or %) we don't have to 
+        // calculate, it's implicit
+        let base_pt = 12;
+        let props_pt = 12;
+        switch (properties.font_size?.unit) {
+            case 'pt':
+                if (!properties.font_size.value) {
+                    return 1;
+                } // also error
+                props_pt = properties.font_size.value;
+                break;
+            case 'px':
+                if (!properties.font_size.value) {
+                    return 1;
+                } // also error
+                props_pt = Math.round(properties.font_size.value * 300 / 4) / 100;
+                break;
+            case 'em':
+                return (properties.font_size.value || 1); // short circuit
+            case '%':
+                return (properties.font_size.value || 100) / 100; // short circuit
+            default:
+                return 1; // error
+        }
+        switch (base.font_size?.unit) {
+            case 'pt':
+                if (!base.font_size.value) {
+                    return 1;
+                } // also error
+                base_pt = base.font_size.value;
+                break;
+            case 'px':
+                if (!base.font_size.value) {
+                    return 1;
+                } // also error
+                base_pt = Math.round(base.font_size.value * 300 / 4) / 100;
+                break;
+            default:
+                return 1; // error
+        }
+        return props_pt / base_pt;
+    },
+    /**
+     * @internal
+     */
+    FontSize: (properties, prefer_points = true) => {
+        const value = properties.font_size?.value;
+        switch (properties.font_size?.unit) {
+            case 'pt':
+                return (value || 12) + 'pt';
+            case 'px':
+                if (prefer_points) {
+                    const points = Math.round((value || 16) * 300 / 4) / 100;
+                    return (points) + 'pt';
+                }
+                return (value || 16) + 'px';
+            case 'em':
+                return (value || 1) + 'em';
+            case '%':
+                return (value || 100) + '%';
+        }
+        return '';
+    },
+    /**
+     * @internal
+     *
+     * generate a font size based on a base size (hopefully in actual units)
+     * and a relative size (em, %, or possibly a static unit). also optionally
+     * apply a scale.
+     *
+     */
+    CompositeFontSize: (base, relative, scale = 1, prefer_points = false) => {
+        let composite = { ...base };
+        // maybe it's actually not relative
+        if (relative.unit === 'pt' || relative.unit === 'px') {
+            composite = { ...relative };
+        }
+        else {
+            composite.value = relative.value * base.value;
+            if (relative.unit === '%') {
+                composite.value /= 100;
+            }
+        }
+        if (composite.unit === 'px' && prefer_points) {
+            composite.value = Math.round((composite.value || 16) * 300 / 4) / 100;
+        }
+        composite.value *= scale;
+        return composite;
+    },
+    /**
+     * return a font string suitable for canvas. because our font sizes are
+     * (probably) in ems, we need a base size to bounce off.
+     */
+    CompositeFont: (base, properties, scale, theme) => {
+        let variants;
+        let stack_size; // for reporting only
+        let font_size;
+        const parts = [];
+        if (properties.bold) {
+            parts.push('bold');
+        }
+        if (properties.italic) {
+            parts.push('italic');
+        }
+        const font_face = properties.font_face || 'stack:default';
+        // let stack_scale = 1;
+        // check if this is a stack
+        if (font_face.startsWith('stack:')) {
+            let stack = theme.font_stacks[font_face.substring(6) || 'default'];
+            // default to default (not just a clever name). the rationale is we
+            // want to support environments that don't have fonts turned on. in
+            // that case, we just don't create the mappings, so everything shows
+            // as the default font.
+            if (!stack) {
+                stack = theme.font_stacks.default;
+            }
+            if (stack) {
+                stack_size = properties.font_size;
+                font_size = Style.CompositeFontSize(stack.size, properties.font_size || { unit: 'pt', value: 10 }, scale);
+                parts.push(font_size.value.toFixed(2) + font_size.unit);
+                parts.push(stack.font || '');
+                variants = stack.variants;
+            }
+        }
+        else {
+            font_size = Style.CompositeFontSize(base, properties.font_size || { unit: 'pt', value: 10 }, scale);
+            parts.push(font_size.value.toFixed(2) + font_size.unit);
+            parts.push(font_face || '');
+        }
+        return { font: parts.join(' '), variants, base, size: properties.font_size, scale, stack_size, font_size };
+    },
+    /*
+    Font2: (properties: CellStyle, scale: number, theme: Theme) => {
+  
+      let features = false;
+  
+      const parts: string[] = [];
+  
+      if (properties.bold) {
+        parts.push('bold');
+      }
+  
+      if (properties.italic) {
+        parts.push('italic');
+      }
+  
+      const font_face = properties.font_face || 'stack:default';
+      let stack_scale = 1;
+  
+      // check if this is a stack
+      if (font_face.startsWith('stack:')) {
+        const stack = theme.font_stacks[font_face.substring(6) || 'default'];
+        if (stack) {
+          stack_scale = stack.scale;
+          parts.push(((properties.font_size?.value || 0) * (scale || 1) * (stack.scale || 1)).toFixed(2) +
+            (properties.font_size?.unit || 'pt'));
+          parts.push(stack.font || '');
+          features = !!stack.apply_num_features;
+        }
+      }
+      else {
+        parts.push(((properties.font_size?.value || 0) * (scale || 1)).toFixed(2) +
+          (properties.font_size?.unit || 'pt'));
+        parts.push(font_face || '');
+      }
+  
+      return { font: parts.join(' '), features, base_size: properties.font_size, scale, stack_scale };
+      
+    },
+    */
+};
+//# sourceMappingURL=style.js.map

package/build/treb-base-types/src/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../../../treb-base-types/src/style.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,58 @@
+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 declare const DefaultTableSortOptions: TableSortOptions;
+/**
+ * struct representing a table
+ */
+export interface Table {
+    /**
+     * table must have a name
+     */
+    name: string;
+    /** 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?: TableSortOptions;
+}

package/build/treb-base-types/src/table.js

@@ -0,0 +1,27 @@
+/*
+ * 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-2026 trebco, llc.
+ * info@treb.app
+ *
+ */
+/** @internal */
+export const DefaultTableSortOptions = {
+    column: 0,
+    type: 'auto',
+    asc: true,
+};
+//# sourceMappingURL=table.js.map

package/build/treb-base-types/src/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../treb-base-types/src/table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA6BH,gBAAgB;AAChB,MAAM,CAAC,MAAM,uBAAuB,GAAqB;IACvD,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,IAAI;CACV,CAAC"}

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

@@ -0,0 +1,26 @@
+export declare 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,
+    /**
+     * this is an indent component. we want to keep track of this
+     * so we don't add it more than once if we're indenting dynamically.
+     * maybe this is not the way to indent.
+     */
+    indent = 8
+}
+export interface TextPart {
+    text: string;
+    flag?: TextPartFlag;
+}

package/build/treb-base-types/src/text_part.js

@@ -0,0 +1,47 @@
+/*
+ * 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-2026 trebco, llc.
+ * info@treb.app
+ *
+ */
+export var TextPartFlag;
+(function (TextPartFlag) {
+    /** just render */
+    TextPartFlag[TextPartFlag["default"] = 0] = "default";
+    /** not rendered, but included in layout (spacing) */
+    TextPartFlag[TextPartFlag["hidden"] = 1] = "hidden";
+    /** takes up all available space */
+    TextPartFlag[TextPartFlag["padded"] = 2] = "padded";
+    /** date component, needs to be filled */
+    TextPartFlag[TextPartFlag["date_component"] = 3] = "date_component";
+    /** special flag for minutes (instead of months), which is contextual */
+    TextPartFlag[TextPartFlag["date_component_minutes"] = 4] = "date_component_minutes";
+    /** literal (@): reflect the original */
+    TextPartFlag[TextPartFlag["literal"] = 5] = "literal";
+    /** formatting (e.g. [red]) */
+    TextPartFlag[TextPartFlag["formatting"] = 6] = "formatting";
+    /* * testing, for complex
+    italic = 7,
+    */
+    /**
+     * this is an indent component. we want to keep track of this
+     * so we don't add it more than once if we're indenting dynamically.
+     * maybe this is not the way to indent.
+     */
+    TextPartFlag[TextPartFlag["indent"] = 8] = "indent";
+})(TextPartFlag || (TextPartFlag = {}));
+//# sourceMappingURL=text_part.js.map

package/build/treb-base-types/src/text_part.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text_part.js","sourceRoot":"","sources":["../../../treb-base-types/src/text_part.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,CAAN,IAAY,YAkCX;AAlCD,WAAY,YAAY;IAEtB,kBAAkB;IAClB,qDAAW,CAAA;IAEX,qDAAqD;IACrD,mDAAU,CAAA;IAEV,mCAAmC;IACnC,mDAAU,CAAA;IAEV,yCAAyC;IACzC,mEAAkB,CAAA;IAElB,wEAAwE;IACxE,mFAA0B,CAAA;IAE1B,wCAAwC;IACxC,qDAAW,CAAA;IAEX,8BAA8B;IAC9B,2DAAc,CAAA;IAEd;;MAEE;IAEF;;;;OAIG;IACH,mDAAU,CAAA;AAEZ,CAAC,EAlCW,YAAY,KAAZ,YAAY,QAkCvB"}

package/build/treb-base-types/src/theme.d.ts

@@ -0,0 +1,120 @@
+import { type Color, type CellStyle, type FontSize } from './style';
+import { type FontStack } from './font-stack';
+/**
+ * composite styling for tables.
+ *
+ * @privateRemarks
+ *
+ * we used to have a "footer", now removed. use borders on rows.
+ */
+export interface TableTheme {
+    /** the first row in a table, showing column titles. */
+    header?: CellStyle;
+    /**
+     * odd rows in the table. we count the title row as zero, so
+     * the first row in the table containing data is 1, hence odd.
+     */
+    odd?: CellStyle;
+    /**
+     * even rows in the table.
+     */
+    even?: CellStyle;
+    /**
+     * styling for the totals row, if included. this will be the last
+     * row in the table.
+     */
+    total?: CellStyle;
+}
+/** theme options - colors and fonts */
+export interface Theme {
+    /** grid headers (composite) */
+    headers?: CellStyle;
+    /** grid cell defaults (composite: size, font face, color, background) */
+    grid_cell?: CellStyle;
+    /**
+     * base font size for grid cell. we try to specify things in ems, but
+     * we do need to know this in order to measure
+     */
+    grid_cell_font_size: FontSize;
+    /** gridlines color */
+    grid_color: string;
+    /**
+     * new: gridlines color for headers. should default to the regular grid
+     * color unless it's explicitly set.
+     */
+    headers_grid_color?: string;
+    /** color of grid lines */
+    /** color of in-cell note marker */
+    note_marker_color: string;
+    /** theme colors */
+    theme_colors?: string[];
+    /** as RGB, so we can adjust them */
+    theme_colors_rgb?: [number, number, number][];
+    /**
+     * cache tinted colors. the way this works is we index by the
+     * theme color first, then by the tint value.
+     *
+     * TODO: we could reduce the tint space... the values look like
+     * they are fairly regular (todo)
+     *
+     * what we are doing now is rounding to 2 decimal places on import, that
+     * cleans up the super precise values we get from excel to more reasonable
+     * values for keys, and I don't think most people can tell the difference
+     * between tinting 25% vs 24.99999872%
+     */
+    tint_cache?: Record<number, string>[];
+    /**
+     * cache for offset colors
+     */
+    offset_cache?: Record<string, string>;
+    /**
+     * this is now default, but you can set explicitly per-table
+     */
+    table?: TableTheme;
+    /**
+     * this is for tinting. we're experimenting with tinting towards black
+     * or white, as opposed to lightening/darkening colors. this should improve
+     * swapping themed colors.
+     *
+     * how to derive this value? @see DeriveColorScheme
+     */
+    mode: 'light' | 'dark';
+    /** light color for offset (against dark background) */
+    offset_light: string;
+    /** dark color for offset (against light background) */
+    offset_dark: string;
+    /** precalculated font stacks */
+    font_stacks: Record<string, FontStack>;
+}
+/**
+ * @internal
+ */
+export declare const DefaultTheme: Theme;
+/**
+ * this includes an implicit check for valid color, if a color
+ * can't be resolved it returns ''. now supports offset colors.
+ * offset returns a light color against a dark background, and
+ * vice versa. what constitutes a dark background is not entirely
+ * clear; atm using lightness = .65.
+ *
+ * @internal
+ */
+export declare const ResolveThemeColor: (theme: Theme, color?: Color, default_index?: number) => string;
+/**
+ * this is a shortcut for creating table formats based on theme colors.
+ * TODO: we might want to swap styles based on light/dark mode?
+ *
+ * @internal
+ */
+export declare const ThemeColorTable: (theme_color: number, tint?: number) => TableTheme;
+/**
+ * for stuff that's painted, we wamt to get the corresponding CSS value.
+ * we now set everything via CSS variables, but using the node structure
+ * allows us to read calculated values, especially when there are cascades.
+ *
+ * I keep trying to change this to just read CSS variables, but that does
+ * not do the same thing.
+ *
+ * @internal
+ */
+export declare const LoadThemeProperties: (container: HTMLElement, use_font_stacks?: boolean) => Theme;