@trebco/treb 23.6.5 → 25.0.0-rc2

package/treb-embed/style/treb-spreadsheet-element.scss

@@ -0,0 +1,20 @@
+
+@import 'layout.scss';
+
+/**
+ * default styles for custom element. we basically want 
+ * it to act like a div.
+ */
+treb-spreadsheet {
+  display: block;
+  position: relative;
+}
+
+/**
+ * if we don't find a height/width on the element when it's 
+ * created, we will add this class to set a default size.
+ */
+.treb-default-size {
+  width: 800px;
+  height: 550px;
+}

package/treb-embed/style/z-index.scss

@@ -0,0 +1,43 @@
+/*
+ * 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
+ * 
+ */
+
+/* z-index stacking */
+
+$z-index-contents:                    8;
+$z-index-grid-selection:             10;
+$z-index-frozen-selection:           12;
+$z-index-tile-cover:                 14;
+$z-index-annotations:                16;
+$z-index-headers:                    18;
+$z-index-corner:                     20;
+$z-index-header-tile-cover:          22;
+$z-index-cell-editor:                24;
+$z-index-scroller:                   26; /* legacy only */
+$z-index-autocomplete:               39;
+$z-index-tooltip:                    39;
+$z-index-dropdown-caret:             39;
+$z-index-note:                       39;
+$z-index-sort-button:                39;
+$z-index-scale-popup:                40;
+$z-index-error-highlight:            40;
+$z-index-mask:                     9999;
+
+

package/treb-export/docs/charts.md

@@ -0,0 +1,68 @@
+
+
+doughnut chart
+--------------
+
+(1) add files: 
+
+```
+charts/chartX.xml
+charts/colorsX.xml
+charts/styleX.xml
+charts/_rels/chartX.xml.rels [number matches chartX.xml]
+
+drawings/drawingX.xml
+drawings/_rels/drawingX.xml.rels [number matches drawingX.xml]
+```
+
+(2) add types to [Content_Types].xml
+
+```
+<Override PartName="/xl/drawings/drawing1.xml" ContentType="application/vnd.openxmlformats-officedocument.drawing+xml"/>
+<Override PartName="/xl/charts/chart1.xml" ContentType="application/vnd.openxmlformats-officedocument.drawingml.chart+xml"/>
+<Override PartName="/xl/charts/style1.xml" ContentType="application/vnd.ms-office.chartstyle+xml"/>
+<Override PartName="/xl/charts/colors1.xml" ContentType="application/vnd.ms-office.chartcolorstyle+xml"/>
+```
+
+(3) worksheet xml has reference to drawing
+
+```
+<drawing r:id="rId1"/>
+```
+
+(4) worksheet rels points to drawing file
+
+```
+<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing" Target="../drawings/drawing1.xml"/>
+```
+
+(5) drawing file has reference to chart
+
+```
+<c:chart
+	xmlns:c="http://schemas.openxmlformats.org/drawingml/2006/chart"
+	xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" r:id="rId1"/>
+```
+
+(6) drawing rels points to chart
+
+```
+<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart" Target="../charts/chart1.xml"/>
+```
+
+(7) chart has no reference to colors, style? (...)
+
+(8) chart rels has rels to colors, style
+
+```
+<Relationship Id="rId2" Type="http://schemas.microsoft.com/office/2011/relationships/chartColorStyle" Target="colors1.xml"/>
+<Relationship Id="rId1" Type="http://schemas.microsoft.com/office/2011/relationships/chartStyle" Target="style1.xml"/>
+```
+
+given that there's no reference in chart, not clear that we need these (although knowing Excel...)
+
+
+
+
+
+

package/treb-export/modern.tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "extends": "../tsproject.json",
+  "include": [
+    "../package.json",
+    "src/**/*.ts",
+    "../treb-utils/**/*.ts",
+    "../treb-grid/**/*.ts",
+    "../treb-embed/**/*.ts",
+    "../treb-charts/**/*.ts",
+    "../treb-format/**/*.ts",
+    "../treb-parser/**/*.ts",
+    "../treb-calculator/**/*.ts",
+    "../treb-base-types/**/*.ts"
+  ],
+  "exclude": [
+    "src/export-worker/index-legacy.ts"
+  ]
+}
+

package/treb-export/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "treb-export",
+  "main": "src/index.ts"
+}

package/treb-export/src/address-type.ts

@@ -0,0 +1,77 @@
+/*
+ * 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
+ * 
+ */
+
+/** represents address in a sheet */
+export interface AddressType {
+  row: number;
+  col: number;
+  sheet?: string;
+}
+
+/** typeguard for address */
+export const is_address = (candidate: any): candidate is AddressType => {
+  return 'row' in candidate &&
+    'col' in candidate;
+};
+
+/** represents range in a sheet (e.g. A1:B2) */
+export interface RangeType {
+  from: AddressType;
+  to: AddressType;
+  sheet?: string;
+}
+
+export interface HyperlinkType {
+  address: AddressType;
+  reference: string;
+  text: string;
+}
+
+/** typeguard for range */
+export const is_range = (candidate: any): candidate is RangeType => {
+  return 'from' in candidate &&
+    'to' in candidate &&
+    is_address(candidate.from) &&
+    is_address(candidate.to);
+};
+
+export const InRange = (range: RangeType, address: AddressType) => {
+  return address.sheet === range.sheet &&
+    address.row >= range.from.row &&
+    address.row <= range.to.row &&
+    address.col >= range.from.col &&
+    address.col <= range.to.col;
+};
+
+export const ShiftRange = (range: RangeType, rows = 0, columns = 0) => {
+  return {
+    from: {
+      row: range.from.row + rows,
+      col: range.from.col + columns,
+      sheet: range.from.sheet,
+    }, to: {
+      row: range.to.row + rows,
+      col: range.to.col + columns,
+      sheet: range.to.sheet,
+    },
+  };
+};
+

package/treb-export/src/base-template.ts

@@ -0,0 +1,22 @@
+/*
+ * 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 const template = 'UEsDBBQABgAIAAAAIQBiw67CnWheAQAAwpAEAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCDCogQCKMKgAAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMKswpTDi07DgzAQRcO3SMO8Q8OkLUrDnMKyQAg1w63CgsOHEipRPsOAw4TCk8OGwqpjW8KeaWnDv8KewonDuxBCwqEVajfCsRLDj8OcezLDscONaMKybm3CtsKCwojDhsK7UgzCi8KBw4jDgFVeGzcvw4XDh8OsJcK/FxnCknJaWcOvwqAUG0AxGV9fwo1mwpsAwphxwrfDg1I0RMOhQUrCrBpoFRY+woDDo8Kdw5rDh1YRw5/DhsK5DMKqWsKoOcOIw5vDgcOgTlbDnhE4w4rCqcOTEMOjw5ETw5RqaSl7XsOzw6MtSQTCiyJ7w5wWdl7CpVAhWFMpYlLCuXLDusKXS8K+cyjCuDPDlWBjAsOeMMKGwpDCvQ7DncOOw58GwrvCvjceTTQawrLCqcKKw7TCqlrDhsKQayvCv3xcfHrCvyjCjsKLw7RQw7rCujYVaF8tW8KeQMKBIcKCw5LDmABQa8KLwrQWwq0ybsOPfcOEPxXCo0zDi8Oww4Igw53DuyXDoRMcw4TDnxtkwrrCnsKPwpBkThgibSzDoMKlw4fCnkRPOTcqwoJ+wqfDiMOJwrg4w4BPw61jHHxuwqbDkQfDpARFw7jDvxTDthHDqcK6w7PDgEIQw4nDgCEkfcKHw63DoMOIw6k7e8Osw5DDpVvCg8Ouw7HClsOpfzLDvgYAAMO/w78DAFBLAwQUAAYACAAAACEAwrVVMCPDtAAAAEwCAAALAAgCX3JlbHMvLnJlbHMgwqIEAijCoAACAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADCrMKSTU/DgzAMwobDr0jDvMKHw4jDt8OVw53CkBBCS3dBSMK7IVR+woBJw5wPwrXCjcKjJBvDncK/JxwQVBrCgwNHf8K9fsO8w4rDm8OdPMKNw6rDiCHDtsOiNMKswosSFDsjwrZ3wq3ChsKXw7pxdQcqJnLClkZxwqzDocOEEXbDlcO1w5XDtsKZR0p5KHbCvcKPKsKrwrjCqMKhS8OJw58jRsOTw7FEwrEQw48uVxoJE8KlHMKGFj3CmcKBWsOGTVnDnmLDuMKuAcOVQlPDrcKtwobCsMK3N8Kgw6rCk8OPwpt/w5fClsKmw6kNP8KIOUzDrMOSwpkVw4hzYmfDmcKufMOIbCHDtcO5GlVTaDlpwrBiwp5yOiJ5X2Rsw4DDs0TCm8K/E8O9fC1OwpzDiFIiNBLDuDLDj0fDhyXCoMO1f1rCtDTDscOLwp15w4Q3CcODwqvDiMOww4nCgsKLH8Kow54BAADDv8O/AwBQSwMEFAAGAAgAAAAhAMK6cMKeZsO0AgAAw4oGAAAPAAAAeGwvd29ya2Jvb2sueG1swqxVw5tuwqMwEH1facO/AcOxTsOBwoTCu0rCqiQQNVJ3VcK1w5nDtiXDksOKASdYAcOMGsOTUFXDvcO3HUNIL3nDqcK2GxHDn8OGHMKfwpk5HsOOL8OaIlceCMKvKStDFcKdGcKqQsOKwoTCpcK0w5zChsOqwq/DpVzDs1TCpRbCuExxw45KEsKqwo/CpFYvw4bDn8K/wp3DrxnDn8KtGcObKQBQw5bCocKaCVEFwrpeJxkpcH3DhipSwoJlw4N4woEFTMO5VsKvK05wWmfChMKIIsOXTcODcMO0AsOTUsOtEQLDvhEMwrbDmcOQwoRELGkKUsKKHsKEwpMcC8KgX2fCtMKqB8K0IsO5CFzCgcO5wq7CqcK0woQVFUDCrGlOw4VjB8KqKkUSLMK2JcOjeMKdwoPDmy3CssKVwpbDg8Ojw4AfGcOQwpjDg0lgOjnCqsKgCWc1w5vCiDPCgMOWe8OSJ8O+I0NHw6hNCMOaw5MYfAzDicOSOXnCoDLCh0dWw5zDuSQrw6fCiMOlwrzCgCHDo8OLaAjCpMOVaSXCgMOgfRLDjT5yM8OVw7HDucKGw6bDpMKuwpfCrsKCwqvDqicuZMKmclXDiXEtw6LClArCksKGwqoLU8K2J28WeFNNG8KawoPDlUTDiHRUfXzClMOzNVdSwrLDgU0uwpYgw6QBHm7ChsOjw7jCpi13woIwJsK5IMK8w4TCgsOMWClAwocHwr/CvsKqwrkOe8KWMVDCuHJDw740wpQTwrhYwqAvw7AVWsKcBHhdX2PCkSkNw49Dw7UyWC1vw6LDqUpwwrLDlkhbMS5WwoIUFcOcBsKyesKlTnx6FcO+QcKfOMKRTsOrw6B1w4/CrB/Cv8KPABDDpMOBwqDDgWvDgRUYL8KiK8OIw4MtfsKAwqxAw67Dk8ODwqVdQMOYwr3Dn0/CkWd7c3/DrmpGw6TCm8KaNcKJLcONwptYMMOywozDmXRkw7tTw4fCjMKew4ELw64ECcODwo3DiA7CmcKWwpjCoWpJMcK9N8O9w4DDrWBBRsOQw5DDtMOlw7wnw6PDsMOTZMO/wq4ZbMOPw5JTWcOTw64ow5nDly/CmsKQU8Klwr3Cp2XDisO2wp0rwo/Cr8OGw7tuw7nCnsKmIgM5WcK2C8OMw7rCtUtCwrcZcEUIwo06wrrCpsOkFMKqT1Fsw4VuNMKyNcOLNyPDjTIiV8OzQVzCmsOlWMOuw5zDtsOcGEVxw4dFf0XCpsKrwptAwqrDq8KVwrLDk8O6wq3CrMKlCArCtMOsZVxhw4wDeQZfwqTCqMOLw5vDsFrCgsOzBMK0LcK7bsKjwo8Mw5PClztIK8KuasORw7UgKwrDtMKQZUxcw4PCtzQjwpYcPUjCj2fCjUxtZkVmbMK7cRRPbcKZGVnDt8KDw79Rw706dQfDgwdFwrLDjDAXS8KOwpMdfMKGbsOIZsKKa8OQUMOvEMOwBQkOwqzDtcOhwq3DsV8AAADDv8O/AwBQSwMEFAAGAAgAAAAhAMKBPsKUwpfDswAAAMK6AgAAGgAIAXhsL19yZWxzL3dvcmtib29rLnhtbC5yZWxzIMKiBAEowqAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADCrFJNS8OEMBDCvQvDvsKHMHfCm3YVEcOZdC8iw6xVw6sPCMOJwrQpw5smITN+w7TDnxsqwrpdWMOWSy8Db8KGecOvw43Dh3bDtzUOw6IDE8O1w4ErwqjCihIEehNsw687BW/DjcOzw40DCGLDrcKtHsKCRwUTEsOsw6rDq8Krw60LDsKacxPCuT7CksOILMKeFDjDpsO4KCUZwofCo8KmIkTDtMK5w5LChjRqw44wdTJqc8OQHcOKTVnDnsOLwrTDpMKAw7rChFPDrMKtwoLCtMK3wrcgwpopZsOlw7/CuUPDm8O2BsKfwoJ5H8ORw7MZCUk8DXkAw5HDqMOUISvDuMOBRcO2CMOywrzDvGZNecOOa8OBwqPDugzDpRzCq0sewqo1PXzChnQgwofDiEcffynCknPDpcKiwpnCu1XDr8OhdELDu8OKKcK/w5vDsizDi8O0w69mw6TDicOHw5XDnwAAAMO/w78DAFBLAwQUAAYACAAAACEAAsKtRHPDgQEAAMKkAwAAGAAAAHhsL3dvcmtzaGVldHMvc2hlZXQxLnhtbMKcwpNNa8OjMBDChsOvC8O7H8KEw67CtmzDh24bE8KnwrRxw4PDtsKwwrDDrMOXXcKWw4fCtsKIJRlJaRLClsO9w687dsKIwrvCkEsoSMKgwpE0w4/CvMKjGcKtHsKPwqonb2DCnTTCusKgcRhRAlrCmFrDqsK2wqDCv35uwoMHSsKcw6fCusOmwr3DkVDDkBM4w7rCuMO+w7xpdTB2w6c6AE/CkMKgXUE7w6/Ch8KcMSc6UMOcwoVmAMKNJ8KNwrHCins0bcOLw5xgwoHDl8KTwpPDqlkSRXdMccKpw6nCmcKQw5tbGMKmacKkwoDDksKIwr0Cw63DjxALPcO3wqjDn3VycBfCmhLCt8OgFMK3wrvDvRAIwqMGRFTCssKXw740QSlRIn9twrXCscK8w6oxw69jwpxyQcKOFkfCgnNxCTPDrV9FUlJYw6NMw6NDJMKzwrPDpsOrw7TCl2zDicK4wphJw5fDucOfwoTCiVNmw6FNwo4FfEclH8KTFGczK3nChy0+CMK7wpthw6Nzw5l8L8OrwoLDvsKJw4rCh8KXbMOzwpQEw5lmw7kSwqRlw7ocLMOTTRZsF8OZJkrDo8OtYsO5XMO+wqXDq1UtwrHDgmNWw4RCU8OQwqfCmMKyw7VqasKew58SDsOuwr81w7HCvMO6AT0IDxggwqZkw6zDjcOKwpjDnXjDsRXCt8Kiw5HClV3DuW7Cp8Oew7xmSQ0Nw5/Dt8O+wrs5fAHDmXYeIRkqHkvCnsOXwqcSwpzDgF5DTMKYZMKzwojCknvCjsOUwoHCt8OwwpXDm1ZqR3powqZbw7fClMOYMyYKccOtw40ww7rDniPCsjLDnht1wrE6w7wNwoBVwo9CfMKfw4YYfzFGwrXDs8O/WsO/AwAAw7/DvwMAUEsDBBQABgAIAAAAIQDDgRcQwr5OBwAAw4YgAAATAAAAeGwvdGhlbWUvdGhlbWUxLnhtbMOsWcONwosbNxTCvxfDuj8Mc3fDvDXDo8KPJcOew6DDj2zCk8OdJGTCncKUHMK1wrbDrFFWMzLCksK8GxMCJTnDtVIowqTCpcKXQm89wpTDkkADDcK9w7TCjwkkwrTDqR/DkSfDjcOYI8Ktw6UkwptsSlp2DcKLR8O+wr3Cp8Knw7fCnn56w7N0w7HDksK9wph6R8KYC8OCwpLCll/CvlDDsj3CnMKMw5jCmCTDk8KWf2s4KDR8T0jClMKMEWUJbsO5CyzDvEvDm8KffnIRbcOJCMOHw5gDw7lEbMKhwpYfSTnDmyoWw4UIwobCkcK4w4BmOMKBw58mwozDh0jDgiPCnxbDhxwdwoPDnsKYFivCpVLCrRgjwpLDuF7CgmJQe30yISPDrA3ClUp/e8KpwrxPw6ExwpFCDcKMKMOfV8KqwrElwqHCscOjw4PCskLCiMKFw6hSw64dIcOaw7Jhwp4xOx7DonvDksO3KBISfmjDuSXDvcOnF8K3LxbDkVYmRMOlBllDbsKgw78ywrlMYHxYw5Fzw7LDqcOBasOSIAjCg1p7wqVfA8KoXMOHw7XDq8O9WsK/wrbDksKnAWg0woLClcKmwrbDmDrDq8KVbsKQYQ1Qw7rDlcKhwrtXw69Vw4sWw57DkF9dwrPCuR3CqsKPwoXDl8KgVH/CsMKGHwzCusOgRQvCr0EpPlzDg8KHwp1mwqdnw6vDl8KgFF9bw4PDl0vDrV5QwrfDtGtQRElywrjChi7ChcK1anfCucOaFWTDgsOowo4Tw54MwoNBwr3CkinDj1HCkA3Cq8OsUlNMWCI3w6VawozDrjI+AMKAAlIkScOiw4nDhQxPw5AIwrLCuMKLKDnDoMOEw5slw5MIEm/ChhImYMK4VCkNSlXDuMKvPsKBw77CpiPCisK2MDLCpMKVXWDCiVgbUsO2eGLDhMOJTMK2w7wrwqDDlTcgL8KePXvDvsOww6nDs8KHwr89f8O0w6jDucODX8KywrnCtSpLbgclU1PDrsOVwo9fw7/DvcO9F8OeX8K/w77DsMOqw7E3w6nDlCfDscOCw4TCv8O8w7nDi8KXwr/Dv8OxOsO1wrDDosOcFS/Cvn3DssOyw6nCkxfDn33DtcOnT8KPHcOaw5scHcKYw7AhwonCscOwwq7DoWPDrybCi2HCgQ7Du8OxAT/CncOEMELDhMKSQBHDqHbCqMOuw4vDiAJeWyDDqsOCdcKww63DgsObHFjDhgXCvDzCv2vDmcK6H8Oxwrkkwo7CmcKvRsKxBcOcY8KMdhh3OsOgwqrCmsOLw7DDsHDCnkzDncKTw7PCucKJwrvCicOQwpFrw64uSsKsAMO3w6czwqBXw6JSw5nCjcKwZcOmDcKKEsKJwqY4w4HDklPCv8KxQ8KMHcKrwrtDwojDpcOXPTLDokzCsMKJw7TDrhDCr8KDwojDkyVDcmAlUi7CtENiwojDi8OCZSDChMOaw7LDjcOebcKvw4PCqGvDlT18ZCNhWyDDqjB+wojCqcOlw4bDi2guUcOsUjlEMTUdwr7Ci2TDpDJyf8OBRybCri8kRHrCiinDs8O6YyzChEvDpjrCh8O1GkHCvwoMw6MOw7seXcOENsKSS3LDqMOSwrnCixgzwpE9dsOYwo1QPHPDmkzCksOIw4R+Jg4hRcKRd8KDSRd8wo/DmTtEPUMcUMKyMcOcwrcJwrbDgsO9ZiLCuAXDpGrCmsKUJ8KIw7plw44dwrHCvMKMwpnCvR8XdMKCwrDCi2XDmjzCtsOYwrXDjcKJMzs6w7PCqcKVw5rCuxhTdMKMw4YYe8K3PnNYw5BhM8OLw6fCucORVyJgwpUdw6xKwqwrw4jDjlXDtcKcYAFlwpLCqmvDlilywpcIK2XDt8OxwpRtwrBnb3HCgngWKMKJEcOfwqTDuRpEw51KXTjDpcKcVHrCncKODk3DoDUCw6Ufw6TCi8OTKcOXBcOoMMKSwrvCv0nDq8KNCFlnwpd6FsOufF1wK35vwrPDh2Bfw549w63CvgQZfGoZIMO2wrfDtsONEFFrwoI8YcKGCAoMF8OdwoLCiBXDvlxEwp3Cq1psw67ClMKbw5jCmzYPAxRGVsK9E8KTw6TCjcOFw4/CicKyJ8O8d8OKHncBcwYFwo9bw7HDu8KUOsKbKGXDp0TCgcKzCcO3HyxremjCnsOcw4BwwpLCrHPDlnlVc17DlcO4w7/Du8KqZsOTXj7Cr2XDjmvCmcOzWsOGw7XDtsO1QWrCmcK8fMKBw4omw6/DssOowp5PwrzCscOlMyHClMOuw4sFw4XCu0J3fQTCvMORwowHMMKow5tRwronwrlqAcOOIsO4wpo1wpgsw5zClCMtw6NxJj8nMsOawo/DkAxaQ2XDncOAwpzCikzDtVR4MybCoGPCpMKHdSsVwp/DkMKtw7tOw7N4wo/CjcOTTmfCucKswrrCmsKpCwXCksO5eClcwo1DwpdKwqbDqFo9w6/DnsKtw5TDq37DqFR3WcKXBijDmcOTGGFMZhtRdRhRXw5CFF5nwoRew5nCmVjDkXRYw5FQw6rCl8KhWkZxw6UKMG0VFXjDpcO2w6BFwr3DpcKHQcOaQcKGZhzClMOnYxXCp8K0wpnCvMKMwq4Kw47CmUZ6wpMzwqnCmQFQYi8zIMKPdFPDmcK6cXlqdWnCqsK9RcKkLSPCjHTCs8KNMMOSMMKCF8OhLDvDjcKWw7tZw4bCusKZwofDlDJPwrliwrkbcjPDqsKNDxFrRSInwrjCgSYmU8OQw4Q7bsO5wrVqCMK3KiM0a8O5E8OoGMODw5d4BsK5I8OUWxfColPCuHYZScKebsO4d2HClhkXwrLCh0TClDpcwpNOw4oGMcKRwph7wpTDhC1fLX/ClQ00w5EcwqJtK1fCgBA+WsOjwppAKx/Cm3EQdDvDiHgyw4EjacKGw50YUcKeTh/CgcOhU8KucMO+wqrDhcOfHcKsJMOZHMOCwr0fwo3Cj8K9AzrDpzcRwqRYWC8rB8KOwonCgMKLwoNyw6rDjTHCgcKbwrAVwpHDpcO5d8OiYMOKaMOXwrzCisOSOcKUwo4jOsKLUHbCosKYZMKew4I1wonCrsOMw5FPKx8YT8OZwprDgcKhw6suPMKYwqoDw7bCvU/DnTcfw5XDinMGacOmZ8Kmw4Uqw6rDlHTCk8Opwoc7w6QNwqvDskPDlMKyKsKlbsO9Ti1ywq5rLsK5DhLDlXlKwrzDocOUfcKLA8OBMC3Cn8OMMk1ZwrxOw4PCisKzwrNRw5vCtDMsCAxPw5Q2w7htdUY4PcOxwq4nP8OIwp3DjFp1QCzDq0rCncO4w7rDisOcwrzDlWYHd8KBPHpwfzjCp1LDqFBCb8KXIyjDusOSG8OIwpQ2YMKLw5zCk1nCjQjDn8K8OSctw79+KWwHw51Kw5gtwpQaYcK/EFTCg1LCoRHCtsKrwoV2GFbDi8O9wrBcw6p1Kg/DoGDCkVFcDsOTw6vDugFcYcOQRXZpwq/Dh8OXLsOuw6PDpS3DjcKFEcKLwotMX8OMF8K1w6HDusOiwr5cw5l8ccOvESDCncO7wrXDisKgWW12asKFZsK1PSgEwr1OwqPDkMOsw5Y6woVewq1bw68NesOdwrDDkRw8w7DCvSMNDsOaw5VuUMOrNwrCtXLCt1sIaiVlfsKjWcKoB8KVSjvCqMK3G8O9wqDDvSArY2DDpSl9ZMK+AMO3asK7wrbDvwEAAMO/w78DAFBLAwQUAAYACAAAACEAecKhwoBswqQCAABSBgAADQAAAHhsL3N0eWxlcy54bWzCpFVta8ObMBDDvj7DmH8Qw7rDrsOKdsOjLAnCtsOLw5LDlFDDqMOGwqAdw6zCq2LDi8KJwqhewowkZ8OOw4bDvsO7TnZeHDrCtsORfsKJTsOnw5Nzw4/DnXNSw5LCm04KwrRjw4Zywq0yHF3ChRgxVcOqworCq03ChsK/PhXDgQwjw6vCqMKqwqjDkMKKZXjDjyzCvsOJw5/Cv0vCrcObC8O2wrhlw4whwoBQNsODW8OnwpoFIcK2w5wyScOtwpVuwpjCgi/CtTbCkjrDmMKaDcKxwo1hwrTCssO+wpAUJA7DgynCkcKUKzwgLGTDuT8gwpLCmsOnwrYJSi0bw6rDuMKaC8Ouw7Y9FkbCslzDnG/ClDZ0LcKAahdNaMKJwrpoamLDlMKZY8KSw57DuyLCj8OkwqXDkVbDl8OuCnDCicKua17CssKXdMOnZE5oeUYCw6TDlyFFCQnDo8KLw5o7w7NKwqQJMWzDh8K9fDhPa8KtwpxFwqVuwpUDMcKBwqhvw4HDolnDqcOvwqrDsMKfwrxzwojDilPDuwPDrcKoAE/ChEnCnsKWWmjCgxxIB8Kdw6s9wopKNkTDnFLDgcOXwobDu8KwwppKLsO2woM7w7bCjl7DrUPCnMOkw5B7w68kwp7Dh2HCsXDCiAtxYhV7AsOgw4hTwpDDjzHCowrDmMKgwoPDvcK0byDCvcKCSRtgw7rCuH9EbwzDnUdxMjpAw7rChHnCusOWwqbCgsOJPsO3w6PDqMOKU8OBagdEDcOfbMO9w6p0A8K/a8OtHMKowp/CpxXCpxvCrcKow7DCpQwgJwPDiinCmRDCj37DusK/w5UXw5hdwo1UKwvDqcOuwqsMw4M9w7JNOMKaUMOIw4Ecw7DChsKNw4cfwqMNw5hvwoZFXX3CiQ/CiCPDmhfCpE/DqcKRw5c7w4PCn8O9dRUwOQcIwrRuwrlwXMO9woEwYFbDncK5BcKhV8OAw7nCq8OXN8OnwpQFOlHCscKawrbDgj3CnT5mw7hsf2IVb2V8worDusOCd8Oaw7UQGT7Dmw9ewqlow6pzwrDDjj1YGC9YUWt4woZ/w54tP8OMV3dFHMOMw4LDpSzCmFzCsyTCmCfDi1XCkExuwpfCq1UxD8Ojw7DDtsOXw6gBeMODw7XDr8Ofwqs8woXCi8K1wrACHglzKMO2UMOiw6PDmcKXw6HDkWbCoMOfw48ow5Aec8Kfw4fDk8OwYxLChUFxHUbDgWRKZ8OBbHrCnQRFEsOFwqvDqWR5wpcUw4nCiHvDssOKZyIkUTQ8OMKefMKycFwyw4HDlVHCq8KjQmMvwogEw5vCvxRBwo5KwpDDs8KfQcO+GwAAw7/DvwMAUEsDBBQABgAIAAAAIQDDkMKMwrALfAAAAMKBAAAAFAAAAHhsL3NoYXJlZFN0cmluZ3MueG1sDMOLQQrDgjAQQMORwr3DoB3DgsOsbcKiCxFpw5rCnSfDkAMMw43DmATCkknDiAzCosK3N8OLw4/Do8OPw6vCt2TDs8KhLsKpwrLCh8Ozw6TDgBBvNSTDnj3CvMKewo/Dkw3CjChyw4Bcwpk8w7xIYF3CjsKHWUTDjXhZPETDlXbCt1bCtkgFZcKqwo14w4jCu8O2woI6wrLDr1ZaJwwSwonCtGR7ccOuagsmBsK7w7wBAADDv8O/AwBQSwMEFAAGAAgAAAAhAMOcCx83PQEAAF0CAAARAAgBZG9jUHJvcHMvY29yZS54bWwgwqIEASjCoAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMKUwpJfS8ODMBTDhcOfBcK/Q8OJe8KbZsKVMUPDm8KBw4rCnhwIThTDn0JywrcFwps/JMKZw53CvsK9aTtrZcK+w7jCmHvDjsO9w51zLynCl0fDlSTCn8Ogwrw0wrpCJMOLUQLCmhshw7XCrkIvwptVwrpAwokPTAvDlhgNFTrCgUfDi8O6w7rCqsOkwpZyw6PDoMOJGQsuSMOwSSRpT8K5wq3DkD4ESzHDtnwPworDuSw6dBTCt8OGKRbDosOTw63CsGXDvMKDw60Aw4/DsnzCjhUEJlhgwrgDwqZ2JMKiM1LDsBFpD8Kuw6kBwoJjaEDCgQ4ewpPCjMOgH28AwqfDvMKfDcK9MnEqGU42w650wo47ZQs+wojCo8O7w6jDpWhsw5s2a8KLPkbDjE/DsMObw7rDscK5XzXClcK6wrsVB1TCl8KCU8OuwoAFw6NqccOQwpzDqRJPSsOdw7kaw6bDgzpeeitBw5zCnUbDl8KlEll9w7QBCCLCiWHDqBDDvVt5LcOuHzYrVMOPcnLCm8OmJC3DiMKGw4zDqcONwoLDpsOFezfDuFd/F24owqjDs8O4w78QZ8KLCcOxG1DCl8O4w6JDw5RfAAAAw7/DvwMAUEsDBBQABgAIAAAAIQBhSQkQwokBAAARAwAAEAAIAWRvY1Byb3BzL2FwcC54bWwgwqIEASjCoAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMKcwpJBb8ObMAzChcOvA8O6HwzDnRs5w51QDMKBwqxiSFfDtMKwYQHCksK2Z03CpmPCocKyJMKIwqzCkcOsw5fCj8K2w5HDlMOZesOqwo3DpHt4w7pEScOdHDpfw7TCkMORw4VQwonDpcKiFAUEG2sXw7bClXjDmMOdXX4VBcKSCcK1w7ExQCXCjsKAw6JGX3xSwpscE2RywoAFRwTCrERLwpRWUsKibcKhM8K4YDnCsMOSw4TDnBnDojbDr2VsGmfDoTbDmsKXDgLDicKrwrLCvMKWcCAINcOUwpfDqRQowqbDhFVPHw3CrcKjHcO4w7Bxd0wMwqzDlcK3wpTCvMKzwobDuMKWw7rCp8KzOWJswqjDuH7CsMOgwpXCnMKLworDqcK2YF/CssKjwqMuwpXCnMK3amvCjcKHNQfDq8OGeAQlw58Gw6oew4zCsMK0wo1xGcK1w6ppw5XCg8KlwpgLdH94bVfCosO4bRAGwpxKw7QmOxPCiMKxBsObw5TCjMK1T0hZP8OFw7zCjC0AwqHCkmzCmMKGYznDt8OOa8O3RS9HAxfDp8OGIWACYcOhHHHDp8OIA8O+ajYmw5M7w4TDiznDscOIMMOxTjjDm8KBbzpzw443XsKZT8O6J3sdwrtkw4LCkcKFU8O1w4PChWd8SMK7eGsIXsOXeT5Uw5vDlmTCqMO5BU7Dqz4Nw5Q9bzLDuyFkw53CmsKwwofDusOVw7PCvzA8w77Do8O0w4PDtcOyelF+LsO5XWczJcOfw77CssO+CwAAw7/DvwMAUEsBAi0AFAAGAAgAAAAhAGLDrsKdaF4BAADCkAQAABMAAAAAAAAAAAAAAAAAAAAAAFtDb250ZW50X1R5cGVzXS54bWxQSwECLQAUAAYACAAAACEAwrVVMCPDtAAAAEwCAAALAAAAAAAAAAAAAAAAAMKXAwAAX3JlbHMvLnJlbHNQSwECLQAUAAYACAAAACEAwrpwwp5mw7QCAADDigYAAA8AAAAAAAAAAAAAAAAAwrwGAAB4bC93b3JrYm9vay54bWxQSwECLQAUAAYACAAAACEAwoE+wpTCl8OzAAAAwroCAAAaAAAAAAAAAAAAAAAAAMOdCQAAeGwvX3JlbHMvd29ya2Jvb2sueG1sLnJlbHNQSwECLQAUAAYACAAAACEAAsKtRHPDgQEAAMKkAwAAGAAAAAAAAAAAAAAAAAAQDAAAeGwvd29ya3NoZWV0cy9zaGVldDEueG1sUEsBAi0AFAAGAAgAAAAhAMOBFxDCvk4HAADDhiAAABMAAAAAAAAAAAAAAAAABw4AAHhsL3RoZW1lL3RoZW1lMS54bWxQSwECLQAUAAYACAAAACEAecKhwoBswqQCAABSBgAADQAAAAAAAAAAAAAAAADChhUAAHhsL3N0eWxlcy54bWxQSwECLQAUAAYACAAAACEAw5DCjMKwC3wAAADCgQAAABQAAAAAAAAAAAAAAAAAVRgAAHhsL3NoYXJlZFN0cmluZ3MueG1sUEsBAi0AFAAGAAgAAAAhAMOcCx83PQEAAF0CAAARAAAAAAAAAAAAAAAAAAMZAABkb2NQcm9wcy9jb3JlLnhtbFBLAQItABQABgAIAAAAIQBhSQkQwokBAAARAwAAEAAAAAAAAAAAAAAAAAB3GwAAZG9jUHJvcHMvYXBwLnhtbFBLBQYAAAAACgAKAMKAAgAANh4AAAAA';

package/treb-export/src/column-width.ts

@@ -0,0 +1,85 @@
+/*
+ * 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
+ * 
+ */
+
+/**
+ * So here is how Excel column widths work:
+ * 
+ * Column width, as used in the <col/> elements, is
+ * 
+ * "
+ * ...measured as the number of characters of the maximum digit width of the 
+ * numbers 0, 1, 2, ..., 9 as rendered in the normal style's font. There are 
+ * 4 pixels of margin padding (two on each side), plus 1 pixel padding for the 
+ * gridlines.
+ * "
+ * 
+ * https://c-rex.net/projects/samples/ooxml/e1/Part4/OOXML_P4_DOCX_col_topic_ID0ELFQ4.html
+ * 
+ * (good resource, btw)
+ * 
+ * 
+ * ==== THIS IS COMPLETELY FUCKING INSANE ======================================
+ * 
+ * Using the Calibri font as an example, the maximum digit width of 11 point 
+ * font size is 7 pixels (at 96 dpi). In fact, each digit is the same width for 
+ * this font. Therefore if the cell width is 8 characters wide, the value of 
+ * this attribute shall be Truncate([8*7+5]/7*256)/256 = 8.7109375.
+ *
+ * To translate the value of width in the file into the column width value at 
+ * runtime (expressed in terms of pixels), use this calculation:
+ *
+ * =Truncate(((256 * {width} + Truncate(128/{Maximum Digit Width}))/256)*{Maximum Digit Width})
+ * 
+ * Using the same example as above, the calculation would be 
+ * Truncate(((256*8.7109375+Truncate(128/7))/256)*7) = 61 pixels
+ *
+ * To translate from pixels to character width, use this calculation:
+ *
+ * =Truncate(({pixels}-5)/{Maximum Digit Width} * 100+0.5)/100
+ * 
+ * Using the example above, the calculation would be 
+ * Truncate((61-5)/7*100+0.5)/100 = 8 characters.
+ * 
+ * =============================================================================
+ * 
+ * Reading the above, if you want the cell to be *8 characters wide* the value
+ * of the attribute shall be *8.7109375*. 
+ * 
+ * Step 3: Profit!
+ * 
+ */
+
+const MaximumDigitWidth = 7; // @ calibri 11
+
+export const PixelsToColumnWidth = (pixels: number): number => {
+  const characters = Math.floor((pixels - 5) / MaximumDigitWidth * 100 + 0.5) / 100;
+  const column_width = Math.floor((characters * MaximumDigitWidth + 5) / MaximumDigitWidth * 256) / 256;
+
+  // console.info('pixels', pixels, 'characters', characters, 'width', column_width);
+
+  return column_width;
+};
+
+export const ColumnWidthToPixels = (width: number): number => {
+  const pixels = Math.floor(((256 * width + Math.floor(128 / MaximumDigitWidth)) / 256) * MaximumDigitWidth);
+  // console.info('width', width, 'pixels', pixels);
+  return pixels;
+};