@trebco/treb 23.6.2 → 25.0.0-rc1

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

@@ -0,0 +1,44 @@
+/*
+ * 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 class DOMUtilities {
+
+  /** creates a div and assigns class name/names */
+  public static CreateDiv(classes = '', parent?: HTMLElement, scope?: string){
+    return this.Create<HTMLDivElement>('div', classes, parent, scope);
+  }
+
+  /** generic element constructor. shame we need the tag AND the type. */
+  public static Create<E extends HTMLElement>(tag = '', classes = '', parent?: HTMLElement, scope?: string, attrs?: Record<string, string>){
+    const element = document.createElement(tag) as E;
+    if (classes) element.setAttribute('class', classes);
+    if (scope) element.setAttribute(scope, '');
+    if (attrs) {
+      const keys = Object.keys(attrs);
+      for (const key of keys) {
+        element.setAttribute(key, attrs[key]);
+      }
+    }
+    if (parent) parent.appendChild(element);
+    return element;
+  }
+
+}

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

@@ -0,0 +1,179 @@
+/*
+ * 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 interface FontMetrics2 {
+  ascender: number;
+  descender: number;
+  block: number;
+  paren: number;
+  hash: number;
+}
+
+export class FontMetricsFactory {
+
+  private canvas!: HTMLCanvasElement;
+
+  private cache: Record<string, FontMetrics2> = {};
+
+  // public base_size_px = 10;
+
+  constructor() {
+
+    // you don't have to attach this canvas to the document
+    // in order to use it to measure. however, if the font size
+    // is relative it needs to be relative to the canvas size;
+    // and if the canvas is not attached to the document, size
+    // doesn't work.
+
+    // FIXME: test with a containing node? 
+    //        (NOTE: that doesn't help)
+
+    if (typeof document !== 'undefined') {
+      this.canvas = document.createElement('canvas');
+    }
+
+    // FIXME: since this is prelude to drawing, couldn't we use
+    // our drawing canvas to render? then we don't need to attach
+    // garbage to the DOM
+
+    // alternatively, we could munge the font description...
+
+    // this.canvas.style.position = 'absolute';
+    // this.canvas.style.top = '-1000px';
+    // document.body.appendChild(this.canvas);
+
+    // what we're doing now is calculating -- we get the base size
+    // from theme and if we see em or % we scale manually.
+
+  }
+
+  /* *
+   * set base font size. the idea here is to have a base in case font sizes 
+   * are relative (% or em), they need to be relative to something. HOWEVER,
+   * canvas doesn't inherit -- 
+   * 
+   * (moved to base_size_points)
+   * 
+   * /
+  public BaseSize(size: string): void {
+    this.canvas.style.fontSize = size || '';
+  }
+  */
+
+  public Flush(): void {
+    this.cache = {};
+  }
+
+  public Get(font: string, base = 10): FontMetrics2 {
+    const key = font + ';' + base;
+    let metrics = this.cache[key];
+    if (metrics) {
+      return metrics;
+    }
+    metrics = this.Measure(font, base);
+    this.cache[key] = metrics;
+    return metrics;
+  }
+
+  public Measure(font: string, base: number): FontMetrics2 {
+
+    const match = font.match(/([\d.]+)((?:%|em))/);
+
+    if (match) {
+      const target = match[1] + match[2];
+      let value = Number(match[1]) * base;
+      if (match[2] === '%') { value /= 100; }
+      font = font.replace(target, value + 'px');
+    }
+
+    // what's up with the double-access on context?
+
+    let context = this.canvas.getContext('2d', {
+      willReadFrequently: true,
+    });
+
+    if (!context) {
+      throw new Error('invalid context');
+    }
+
+    context.font = font;
+    const metrics = context.measureText('MMM');
+
+    const size = Math.ceil(metrics.width);
+
+    this.canvas.setAttribute('width', size.toString());
+    this.canvas.setAttribute('height', size.toString());
+    
+    context = this.canvas.getContext('2d', {
+      willReadFrequently: true,
+    });
+
+    if (!context) {
+      throw new Error('invalid context');
+    }
+
+    context.font = font;
+
+    context.textAlign = 'center';
+    context.textBaseline = 'alphabetic';
+    context.fillStyle = '#000';
+
+    const y = Math.round(size * 2 / 3);
+    const x = Math.round(size / 2);
+
+    context.clearRect(0, 0, size, size);
+    for (let i = 0x20; i <= 0x7e; i++) {
+      const s = String.fromCharCode(i);
+      context.fillText(s, x, y);
+    }
+
+    const data = context.getImageData(0, 0, this.canvas.width, this.canvas.height).data;
+
+    const top = Math.floor(this.GetFirstIndex(data)/size);
+    const bottom = Math.floor(this.GetLastIndex(data)/size);
+
+    return {
+      ascender: y - top,
+      descender: bottom - y,
+      block: bottom - top + 1,
+      paren: context.measureText('(').width,
+      hash: context.measureText('##').width - context.measureText('#').width,
+    };
+
+  }
+
+  private GetFirstIndex(pixels: Uint8ClampedArray) {
+    for (let i = 3, n = pixels.length; i < n; i += 4) {
+      if (pixels[i] > 0) return (i - 3) / 4;
+    }
+    return pixels.length;
+  }
+
+  private GetLastIndex(pixels: Uint8ClampedArray) {
+    for (let i = pixels.length - 1; i >= 3; i -= 4) {
+      if (pixels[i] > 0) return i / 4;
+    }
+    return 0;
+  }
+
+}
+
+export const FontMetricsCache = new FontMetricsFactory();

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

@@ -0,0 +1,104 @@
+/*
+ * 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
+ * 
+ */
+
+const app_version = typeof navigator === 'undefined' ? '' : navigator.appVersion;
+const user_agent = typeof navigator === 'undefined' ? '' : navigator.userAgent;
+
+// console.warn('using fake UA: ' + user_agent);
+
+/**
+ * some basic user-agent sniffing. we use less than we used to, except
+ * for making the determination of modern (grid)/legacy layout.
+ * 
+ * FIXME: move to base_types, we need it in toolbar
+ * 
+ */
+class UAType {
+
+  /** we need this for some edge-specific weirdness */
+  public readonly is_edge = /Edge/.test(app_version);
+
+  /** more testing. ios safari doesn't support grid+sticky (apparently) */
+  public readonly is_ipad = /iPad|iPhone/.test(user_agent);
+
+  /** more testing. firefox android doesn't support grid+sticky (apparently) */
+  public readonly is_android = /android|samsung/i.test(user_agent);
+
+  /** mobile we want slightly different keyboard behavior */
+  public readonly is_mobile = this.is_ipad || this.is_android;
+ 
+  /** more testing. firefox android doesn't support grid+sticky (apparently) */
+  public readonly is_firefox = /firefox/i.test(user_agent);
+
+  /** ... */
+  public readonly is_safari = /safari/i.test(user_agent) && !/edg/i.test(user_agent);
+
+  /** ... */
+  public readonly is_mac = /macintosh/i.test(user_agent);
+
+  /** ... */
+  public readonly is_chrome = /Chrome/i.test(user_agent);
+
+  /* * this is for events (IE11 does't support event constructor) * /
+  public trident = ((typeof navigator !== 'undefined') &&
+    user_agent && /trident/i.test(user_agent));
+  */
+
+  /** ... */
+  public is_windows = /win64|win32|windows\s+nt/i.test(user_agent);
+
+  // safari doesn't seem to hold the sticky elements in place. not
+  // sure why not, though, need to do some more testing. legacy
+  // renderer on safari has no scrollbars...
+
+  // position: -webkit-sticky fixes the sticky issue, behavior seems
+  // consistent with cr/ffx. also fixes on ios, but we lost the scrollbars.
+
+  // blinking on safari handled with -webkit-tap-highlight-color: transparent;
+  // but we still have no scrollbars. it may be that we never have them...
+
+  /** temp only: need a more robust check */
+  public readonly is_modern =
+    (!this.is_edge) &&
+    // (!this.is_ipad) &&
+    // (!this.is_mac || (this.is_chrome || this.is_firefox)) &&
+    (!(this.is_firefox && this.is_android)) &&
+    /webkit|firefox/i.test(user_agent);
+}
+
+const null_ua = {
+
+    is_edge: false,
+    is_ipad: false,
+    is_android: false,
+    is_firefox: false,
+    is_safari: false,
+    is_mac: false,
+    is_chrome: false,
+    trident: false,
+    is_windows: false,
+    is_modern: true,
+    is_node: true,
+    is_mobile: false,
+
+};
+
+export const UA = (typeof navigator === 'undefined') ? null_ua : new UAType();

package/treb-logo.svg

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 15.1.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 width="153.073px" height="133.742px" viewBox="0.673 4.629 153.073 133.742" enable-background="new 0.673 4.629 153.073 133.742"
+	 xml:space="preserve">
+<linearGradient id="SVGID_1_" gradientUnits="userSpaceOnUse" x1="0.6729" y1="71.5" x2="153.7461" y2="71.5">
+	<stop  offset="0" style="stop-color:#5CB5FF"/>
+	<stop  offset="1" style="stop-color:#0059B9"/>
+</linearGradient>
+<path fill="url(#SVGID_1_)" d="M91.656,28.313c-4.989,0-17.266,6.249-21.305,8.504c-2.344-2.473-2.603-6.162-3.036-10.933
+	c-2.344,2.429-0.824,9.806,0,12.496c-10.238,7.635-18.83,15.531-27.597,24.471c-2.992-4.729-5.031-8.593-5.726-17.183
+	c-3.038,6.509,0.867,15.057,3.121,19.784c-9.674,12.193-19.263,25.297-27.03,37.834C-25.405,28.313,82.936-16.248,153.746,14.431
+	C109.879,43.63,98.554,135.784,21.498,111.274c-5.423,7.809-9.069,18.006-13.538,27.072c-3.73,0.263-6.334-1.646-7.288-3.12
+	c7.506-18.181,17.183-34.192,27.075-49.984c10.718,0.306,21.346,0.478,30.198-1.04c-7.681-2.038-16.877-0.78-26.032-3.123
+	c5.597-10.718,13.754-18.876,21.867-27.075c8.808,0.782,17.746,3.21,27.074,1.041c-8.111-1.431-15.966-1.952-22.909-4.165
+	C65.539,42.502,80.722,33.389,91.656,28.313z"/>
+</svg>

package/treb-parser/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "treb-parser",
+  "version": "16.0.1",
+  "main": "src/index.ts"
+}

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

@@ -0,0 +1,122 @@
+/*
+ * 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
+ * 
+ */
+
+enum ParseState {
+  default = 0,
+  quoted = 1,
+}
+
+/**
+ * csv parser, following (largely) RFC4180 rules, with some extensions.
+ * specifically:
+ *
+ * - lines should end with CRLF, but we support CR
+ * - we do not support header (atm)
+ * - variable-length records are supported
+ * - any field may be quoted
+ * - quoted fields can contain newlines and commas
+ * - use two double-quotes to escape a double quote
+ *
+ */
+export const ParseCSV = (text: string, delimiter = ','): string[][] => {
+
+  let state: ParseState = ParseState.default;
+  let record: string[] = [];
+  let field = '';
+
+  const records: string[][] = [];
+  const length = text.length;
+
+  if (/[\r\n"]/.test(delimiter)) {
+    throw new Error('invalid delimiter');
+  }
+
+  for (let i = 0; i < length; i++ ){
+    const char = text[i];
+
+    if (i === 0 && char.charCodeAt(0) === 0xfeff) {
+      continue;
+    }
+
+    if (state === ParseState.default) {
+      switch (char) {
+        case delimiter:
+          record.push(field);
+          field = '';
+          break;
+
+        case '\r':
+          // naked (non-quoted) \r without immediate \n is illegal
+
+          // if (i + 1 < length && text[i + 1] === '\n') i++; // drop into next block
+          // else
+          break;
+
+        case '\n':
+          record.push(field);
+          field = '';
+          records.push(record);
+          record = [];
+          break;
+
+        case '"':
+          // we're allowing unescaped double-quotes in non-quoted fields
+
+          if (field.length === 0) {
+            state = ParseState.quoted;
+          }
+          else {
+            field += char;
+          }
+          break;
+
+        default:
+          field += char;
+          break;
+      }
+    }
+    else {
+      if (char === '"') {
+        if (i + 1 < length && text[i + 1] === '"') {
+          field += '"';
+          i++;
+        }
+        else {
+          state = ParseState.default;
+        }
+      }
+      else field += char;
+    }
+  }
+
+  // we're at the end. this might be a blank line at the end of the
+  // file, or it might be the end of the last record. let's make the
+  // simplifying assumption that we can drop a blank line, instead
+  // of treating it as a record with one zero-length field.
+
+  if (record.length || field.length) {
+    record.push(field);
+    records.push(record);
+  }
+
+  return records;
+
+};

package/treb-parser/src/index.ts

@@ -0,0 +1,25 @@
+/*
+ * 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 * from './parser-types';
+export * from './parser';
+export * from './csv-parser';
+export * from './md-parser';