datavis-glide 4.0.0-PRE.0

package/LICENSE

@@ -0,0 +1,45 @@
+Source Available License
+
+Copyright (c) 2017-2026 Medical Informatics Engineering, LLC. All rights reserved.
+
+This software and associated documentation files (the "Software") are the
+proprietary property of Medical Informatics Engineering, LLC. ("MIE").
+
+OPEN SOURCE / NON-COMMERCIAL USE
+
+Permission is hereby granted, free of charge, to any person or organization
+obtaining a copy of this Software, to use, copy, modify, merge, and distribute
+the Software for non-commercial purposes, subject to the following conditions:
+
+1. Attribution Required: The above copyright notice, this permission notice,
+	and clear attribution to Medical Informatics Engineering, LLC. shall be
+	included in all copies or substantial portions of the Software.
+
+2. Open Source Requirement: If you distribute the Software or any derivative
+	works, you must do so under an open source license approved by the Open
+	Source Initiative (OSI) and make the source code publicly available.
+
+3. Non-Commercial Use Only: This license does not grant permission to use the
+	Software for commercial purposes. "Commercial purposes" means any use
+	intended for or directed toward commercial advantage or monetary
+	compensation.
+
+COMMERCIAL USE
+
+For commercial use, including but not limited to:
+- Use in proprietary/closed-source products
+- Use in products or services sold for profit
+- Use by for-profit organizations for internal business operations
+
+You must obtain a separate commercial license from Medical Informatics
+Engineering, LLC. Contact: https://www.mieweb.com or helpdesk@mieweb.com
+
+NO WARRANTY
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+MEDICAL INFORMATICS ENGINEERING, LLC. OR ITS AFFILIATES BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,129 @@
+![DataVis GLIDE Logo](logo.png)
+
+# DataVis GLIDE
+
+DataVis is a system for exploring, manipulating, and visualizing data. It consists of multiple components in multiple layers, each responsible for different elements of a complete system. This layer, DataVis GLIDE, provides user interfaces for exploring data. This includes:
+
+- Complete interactive controls to filter, group, pivot, aggregate, sort, and export data.
+- “Grids” to display tabular data, including a “tree mode” details view for grouped data.
+- “Graphs” to display aggregate results.
+- View saving, column resizing, row selection, floating headers, pagination, and much more.
+
+**GLIDE = Graphical Layer for Interactive Data Exploration**
+
+## How to Use
+
+### Vite
+
+Stick this in your `package.json` obviously.
+
+```
+"dependencies": {
+  "wcdatavis": "git+ssh://git@github.com:mieweb/wcdatavis.git",
+  "vite": "=7.3.1"
+}
+```
+
+#### Building a Page
+
+Inside a module script tag, import the CSS for DataVis and its dependents. This is necessary when using Vite in this configuration, but not if using a version of DataVis built via Rollup (which uses the PostCSS plugin to automatically extract and bundle all CSS files imported from JS).
+
+```
+import 'jquery-ui/dist/themes/base/jquery-ui.min.css';
+import 'sumoselect/sumoselect.min.css';
+import 'wcdatavis/wcdatavis.css';
+```
+
+Then just use DataVis like normal:
+
+```
+import { Source, ComputedView, Grid } from 'wcdatavis/index.js';
+
+document.addEventListener('DOMContentLoaded', () => {
+  const source = new Source({
+    type: 'http',
+    url: 'fruit.csv'
+  });
+  const computedView = new ComputedView(source);
+  new Grid({
+    id: 'grid',
+    computedView: computedView
+  }, {
+    title: 'DataVis NPM Example (Using Vite)'
+  });
+});
+```
+
+Make sure you also have a div to contain the grid on the page.
+
+```
+<div id=”grid”></div>
+```
+
+#### Available Exports
+
+| Export         | Description                                                  |
+| -------------- | ------------------------------------------------------------ |
+| `Source`       | Fetches and decodes data from HTTP, files, or local JavaScript |
+| `ComputedView` | Implements filtering, grouping, pivoting, and aggregation    |
+| `Grid`         | Renders data in a table with interactive controls            |
+| `Graph`        | Renders data as charts using Chart.js                        |
+| `Prefs`        | User preferences management                                  |
+| `Perspective`  | Save and restore view configurations                         |
+| `ParamInput`   | Parameter input handling for sources                         |
+
+### Traditional Website
+
+1. Run `make setup` to get dependencies.
+2. Run `make datavis` to build the JS file.
+3. Copy `dist/wcdatavis.js` and `dist/wcdatavis.css` to your server.
+4. Include them like any other JS and CSS files.
+
+## How to Develop
+
+See the [Development section of the Manual](doc/md/development/index.md) for a full explanation.  What follows is a synopsis.
+
+### Quickstart
+
+We use GNU Make to provide a simple interface to the various tools to build and test DataVis.
+
+* `make setup` — Installs all dependencies.
+* `make datavis` — Build the compressed DataVis JS and CSS files.
+* `make tests` — Same as `make`, then copy to tests directory, and build test data.
+* `make [PORT=] serve` — Start local server for interactive testing.
+* `make test` — Same as `make tests`, then run automated tests using Mocha & Selenium.
+* `make doc` — Build all documentation.
+  * `make jsdoc` — Build JS API documentation from comments in the source.
+  * `make manual` — Build the Manual from Markdown files.
+* `make clean` — Remove all build products and generated test data.
+* `make teardown` — Resets the development environment.
+
+## Tree Structure
+
+* `bin` — Contains programs used to build other stuff, e.g. a JSON generator.
+* `dist` — After compiling with `make`, contains the JS and CSS files for DataVis.
+* `doc` — The user & developer manual.
+  * `md` — Manual Markdown source files.
+  * `html` — Manual HTML output files.
+* `src` — Contains all the source JS files.
+  * `renderers` — Classes for DataVis output.
+  * `ui` — Classes for user interface components.
+    * `filters` — Filter widget implementation.
+    * `windows` — Modal dialogs.
+  * `util` — Classes and modules for utilities.
+  * `reg` — Registry files.
+  * `lang` — Compiled language packs.
+* `tests`
+  * `data` — Data files for testing and examples.
+    * `*.json5` — Input for generating JSON files.
+    * `*.in.json` — Input for generating JSON files.
+  * `lib` — Auxiliary JS files to help make writing test cases easier.
+  * `pages` — HTML pages used for running Selenium tests.
+    * `grid` — Tests specifically for the grid.
+    * `graph` — Tests specifically for the graph.
+    * `qunit` — Unit tests, mostly for the view.
+  * `selenium` — Selenium test case files.
+
+## History
+
+The original DataVis project consisted of both the data processing and interactive UI functions. It has now been split into two projects: DataVis ACE (this project) and DataVis GLIDE (an intuitive but complete user interface to explore the data).

package/datavis.js

@@ -0,0 +1,101 @@
+import './ie-fixes.js';
+import 'core-js/es/number/is-integer';
+
+import jQuery from 'jquery';
+
+// Don't try to inline this code, it won't work. Imports are lifted,
+// and this code needs to run before we import jQuery UI. Yes, this
+// is an unhinged workaround.
+
+import original_jQuery from './global-jquery.js';
+
+import 'block-ui';
+import 'flatpickr';
+import 'jquery-ui/dist/jquery-ui.min.js';
+import 'sumoselect';
+
+import 'jquery-ui/dist/themes/base/jquery-ui.min.css';
+import 'sumoselect/sumoselect.min.css';
+import './wcdatavis.css';
+import './src/ui/popup_menu.css';
+import './src/ui/popup_window.css';
+import './src/ui/tabs.css';
+import './src/ui/collapsible.css';
+
+import * as Util from './src/util/misc.js';
+import {
+	OrdMap,
+	Lock,
+	Aggregate,
+	AGGREGATE_REGISTRY,
+	ParamInput,
+	Source,
+	ComputedView,
+	MirageView,
+	GroupFunction,
+	GROUP_FUNCTION_REGISTRY,
+	Prefs,
+	Perspective,
+	PrefsBackend,
+	PREFS_BACKEND_REGISTRY,
+	PrefsModule,
+	PREFS_MODULE_REGISTRY,
+} from 'datavis-ace';
+import { Grid } from './src/grid.js';
+import { Graph } from './src/graph.js';
+import { trans } from './src/trans.js';
+
+// So we only import Svelte-Gantt when we're building an IIFE via Rollup.  This is mainly because
+// Meteor + Svelte 4 + Typescript isn't working, so it had to be removed from the main code.
+
+import GraphRendererSvelteGantt from './src/renderers/graph/svelte-gantt.js';
+import GRAPH_RENDERER_REGISTRY from './src/reg/graph_renderer.js';
+
+GRAPH_RENDERER_REGISTRY.set('svelte-gantt', GraphRendererSvelteGantt);
+
+// Set some global variables for <script> tag usage.
+
+window.MIE              = window.MIE || {};
+window.MIE.OrdMap       = OrdMap;
+window.MIE.Lock         = Lock;
+window.MIE.trans        = trans;
+window.MIE.makeSubclass = Util.makeSubclass;
+
+window.MIE.WC_DataVis                 = window.MIE.WC_DataVis || {};
+window.MIE.WC_DataVis.Aggregate       = Aggregate;
+window.MIE.WC_DataVis.ParamInput      = ParamInput;
+window.MIE.WC_DataVis.Source          = Source;
+window.MIE.WC_DataVis.GroupFunction   = GroupFunction;
+window.MIE.WC_DataVis.ComputedView    = ComputedView;
+window.MIE.WC_DataVis.MirageView      = MirageView;
+window.MIE.WC_DataVis.Grid            = Grid;
+window.MIE.WC_DataVis.grids           = {};
+window.MIE.WC_DataVis.Graph           = Graph;
+window.MIE.WC_DataVis.graphs          = {};
+window.MIE.WC_DataVis.Perspective     = Perspective;
+window.MIE.WC_DataVis.Prefs           = Prefs;
+window.MIE.WC_DataVis.PrefsBackend    = PrefsBackend;
+window.MIE.WC_DataVis.PrefsModule     = PrefsModule;
+window.MIE.WC_DataVis.EXPORT_URL      = 'export.php';
+
+// Expose "registry" extension points
+
+window.MIE.WC_DataVis.AGGREGATE_REGISTRY      = AGGREGATE_REGISTRY;
+window.MIE.WC_DataVis.GROUP_FUNCTION_REGISTRY = GROUP_FUNCTION_REGISTRY;
+window.MIE.WC_DataVis.PREFS_BACKEND_REGISTRY  = PREFS_BACKEND_REGISTRY;
+window.MIE.WC_DataVis.PREFS_MODULE_REGISTRY   = PREFS_MODULE_REGISTRY;
+
+window.MIE.WC_DataVis.Util                    = Util;
+
+// We left the global jQuery around long enough for jQuery UI to install itself, and that same
+// jQuery object has been used by all other plugins and DataVis code.  Now that we're all done,
+// make it so nobody can access our jQuery, to avoid conflicts.
+
+window.MIE.WC_DataVis.jQuery = jQuery;
+
+if (original_jQuery != null) {
+	window.jQuery = original_jQuery;
+}
+else {
+	delete window.jQuery;
+}