flexdataset 0.4.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including the
+      original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and do
+          not modify the License. You may add Your own attribution notices
+          within Derivative Works that You distribute, alongside or as an
+          addendum to the NOTICE text from the Work, provided that such
+          additional attribution notices cannot be construed as modifying
+          the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or agreed
+      to in writing, Licensor provides the Work (and each Contributor
+      provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES
+      OR CONDITIONS OF ANY KIND, either express or implied, including,
+      without limitation, any warranties or conditions of TITLE,
+      NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+      PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor has
+      been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing the
+      Work or Derivative Works thereof, You may choose to offer, and charge
+      a fee for, acceptance of support, warranty, indemnity, or other
+      liability obligations and/or rights consistent with this License.
+      However, in accepting such obligations, You may act only on Your own
+      behalf and on Your sole responsibility, not on behalf of any other
+      Contributor, and only if You agree to indemnify, defend, and hold
+      each Contributor harmless for any liability incurred by, or claims
+      asserted against, such Contributor by reason of your accepting any
+      such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Rodrigo Carvajal
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,30 @@
+# flexdataset
+
+The reference validator and CLI for the **Flexible Dataset Definition (FDD)** standard — a JSON format
+for describing datasets (tables) as files, validated structurally (JSON Schema) and semantically
+(cross-field and cross-file rules). See the [project repository](https://github.com/ksco92/eevee).
+
+## Install
+
+```bash
+npm install -g flexdataset
+```
+
+Or download a standalone binary (no Node required) from
+[Releases](https://github.com/ksco92/eevee/releases).
+
+## Use
+
+```bash
+flexdataset validate <root>                 # structural + semantic checks
+flexdataset validate <root> --format json   # machine-readable violations
+flexdataset graph <root> --out dag.svg      # dependency DAG
+flexdataset er <root> --out er.svg          # entity-relationship diagram
+```
+
+`validate` exits non-zero when there are error-level violations. The `graph` and `er` commands render
+SVG via WASM Graphviz (no system Graphviz needed).
+
+## License
+
+Apache-2.0. See [LICENSE](LICENSE).

package/dist/src/cli.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * `flexdataset` command-line interface.
+ *
+ * Commands: `validate` (structural + semantic checks), `graph` (dependency DAG
+ * as SVG), and `er` (entity-relationship diagram as SVG). The CLI is a thin
+ * shell over the library; all logic and tests live in the modules it calls.
+ */
+export {};

package/dist/src/cli.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * `flexdataset` command-line interface.
+ *
+ * Commands: `validate` (structural + semantic checks), `graph` (dependency DAG
+ * as SVG), and `er` (entity-relationship diagram as SVG). The CLI is a thin
+ * shell over the library; all logic and tests live in the modules it calls.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const validate_1 = require("./validate");
+const loader_1 = require("./loader");
+const dag_1 = require("./diagram/dag");
+const er_1 = require("./diagram/er");
+const render_1 = require("./diagram/render");
+const USAGE = `flexdataset — Flexible Dataset Definition validator
+
+Usage:
+  flexdataset validate <root> [--format json|human]
+  flexdataset graph <root> [--out <file.svg>]
+  flexdataset er <root> [--out <file.svg>]
+  flexdataset help
+
+Options:
+  --format   Output format for "validate" (default: human).
+  --out      Write SVG to a file instead of stdout (graph / er).`;
+function formatViolation(violation) {
+    const location = [
+        violation.schema,
+        violation.table,
+    ].filter(Boolean).join('.');
+    const where = location ? ` ${location}` : '';
+    const field = violation.field ? ` (${violation.field})` : '';
+    return `  ${violation.level.toUpperCase()} [${violation.code}]${where}${field}: ${violation.message}`;
+}
+function printHuman(result) {
+    const errors = result.violations.filter((violation) => violation.level === 'error');
+    const warnings = result.violations.filter((violation) => violation.level === 'warning');
+    for (const violation of result.violations) {
+        const line = formatViolation(violation);
+        if (violation.level === 'error') {
+            console.error(line);
+        }
+        else {
+            console.warn(line);
+        }
+    }
+    if (result.ok) {
+        console.log(`OK — ${warnings.length} warning(s), 0 error(s).`);
+    }
+    else {
+        console.error(`FAILED — ${errors.length} error(s), ${warnings.length} warning(s).`);
+    }
+}
+function parseOptions(rest, flag) {
+    let value;
+    const positional = [];
+    for (let i = 0; i < rest.length; i += 1) {
+        if (rest[i] === flag) {
+            i += 1;
+            value = rest[i];
+        }
+        else {
+            positional.push(rest[i]);
+        }
+    }
+    return {
+        value,
+        positional,
+    };
+}
+function runValidate(rest) {
+    const { value, positional, } = parseOptions(rest, '--format');
+    const format = value ?? 'human';
+    const root = positional[0];
+    if (!root) {
+        console.error('usage: flexdataset validate <root> [--format json|human]');
+        return 1;
+    }
+    if (format !== 'human' && format !== 'json') {
+        console.error(`unknown format "${format}" (expected "human" or "json")`);
+        return 1;
+    }
+    let result;
+    try {
+        result = (0, validate_1.validateRoot)(root);
+    }
+    catch (error) {
+        console.error(error.message);
+        return 1;
+    }
+    if (format === 'json') {
+        console.log(JSON.stringify({
+            ok: result.ok,
+            violations: result.violations,
+        }, null, 2));
+    }
+    else {
+        printHuman(result);
+    }
+    return result.ok ? 0 : 1;
+}
+async function runDiagram(command, rest) {
+    const { value: out, positional, } = parseOptions(rest, '--out');
+    const root = positional[0];
+    if (!root) {
+        console.error(`usage: flexdataset ${command} <root> [--out <file.svg>]`);
+        return 1;
+    }
+    try {
+        const world = (0, loader_1.loadRoot)(root).world;
+        const dot = command === 'graph' ? (0, dag_1.buildDagDot)(world) : (0, er_1.buildErDot)(world);
+        const svg = await (0, render_1.renderDot)(dot);
+        if (out) {
+            fs.writeFileSync(out, svg, 'utf-8');
+            console.error(`wrote ${out}`);
+        }
+        else {
+            console.log(svg);
+        }
+        return 0;
+    }
+    catch (error) {
+        console.error(error.message);
+        return 1;
+    }
+}
+async function main(argv) {
+    const args = argv.slice(2);
+    const command = args[0];
+    if (!command) {
+        console.error(USAGE);
+        return 1;
+    }
+    if (command === 'help' || command === '--help' || command === '-h') {
+        console.log(USAGE);
+        return 0;
+    }
+    if (command === 'validate') {
+        return runValidate(args.slice(1));
+    }
+    if (command === 'graph' || command === 'er') {
+        return runDiagram(command, args.slice(1));
+    }
+    console.error(`unknown command: ${command}`);
+    console.error(USAGE);
+    return 1;
+}
+main(process.argv).then((code) => {
+    process.exit(code);
+}).catch((error) => {
+    console.error(error.message);
+    process.exit(1);
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUNBOzs7Ozs7R0FNRzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUVILHVDQUF5QjtBQUV6Qix5Q0FFb0I7QUFDcEIscUNBRWtCO0FBQ2xCLHVDQUV1QjtBQUN2QixxQ0FFc0I7QUFDdEIsNkNBRTBCO0FBSzFCLE1BQU0sS0FBSyxHQUFHOzs7Ozs7Ozs7O2lFQVVtRCxDQUFDO0FBRWxFLFNBQVMsZUFBZSxDQUFDLFNBQW9CO0lBQ3pDLE1BQU0sUUFBUSxHQUFHO1FBQ2IsU0FBUyxDQUFDLE1BQU07UUFDaEIsU0FBUyxDQUFDLEtBQUs7S0FDbEIsQ0FBQyxNQUFNLENBQUMsT0FBTyxDQUFDLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQzVCLE1BQU0sS0FBSyxHQUFHLFFBQVEsQ0FBQyxDQUFDLENBQUMsSUFBSSxRQUFRLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO0lBQzdDLE1BQU0sS0FBSyxHQUFHLFNBQVMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLEtBQUssU0FBUyxDQUFDLEtBQUssR0FBRyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7SUFDN0QsT0FBTyxLQUFLLFNBQVMsQ0FBQyxLQUFLLENBQUMsV0FBVyxFQUFFLEtBQUssU0FBUyxDQUFDLElBQUksSUFBSSxLQUFLLEdBQUcsS0FBSyxLQUFLLFNBQVMsQ0FBQyxPQUFPLEVBQUUsQ0FBQztBQUMxRyxDQUFDO0FBRUQsU0FBUyxVQUFVLENBQUMsTUFBd0I7SUFDeEMsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLENBQUMsQ0FBQyxTQUFTLEVBQUUsRUFBRSxDQUFDLFNBQVMsQ0FBQyxLQUFLLEtBQUssT0FBTyxDQUFDLENBQUM7SUFDcEYsTUFBTSxRQUFRLEdBQUcsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFN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QUM7QUFFRCxJQUFJLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLElBQUksRUFBRSxFQUFFO0lBQzdCLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7QUFDdkIsQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsS0FBSyxFQUFFLEVBQUU7SUFDZixPQUFPLENBQUMsS0FBSyxDQUFFLEtBQWUsQ0FBQyxPQUFPLENBQUMsQ0FBQztJQUN4QyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQUFDO0FBQ3BCLENBQUMsQ0FBQyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiIyEvdXNyL2Jpbi9lbnYgbm9kZVxuLyoqXG4gKiBgZmxleGRhdGFzZXRgIGNvbW1hbmQtbGluZSBpbnRlcmZhY2UuXG4gKlxuICogQ29tbWFuZHM6IGB2YWxpZGF0ZWAgKHN0cnVjdHVyYWwgKyBzZW1hbnRpYyBjaGVja3MpLCBgZ3JhcGhgIChkZXBlbmRlbmN5IERBR1xuICogYXMgU1ZHKSwgYW5kIGBlcmAgKGVudGl0eS1yZWxhdGlvbnNoaXAgZGlhZ3JhbSBhcyBTVkcpLiBUaGUgQ0xJIGlzIGEgdGhpblxuICogc2hlbGwgb3ZlciB0aGUgbGlicmFyeTsgYWxsIGxvZ2ljIGFuZCB0ZXN0cyBsaXZlIGluIHRoZSBtb2R1bGVzIGl0IGNhbGxzLlxuICovXG5cbmltcG9ydCAqIGFzIGZzIGZyb20gJ2ZzJztcblxuaW1wb3J0IHtcbiAgICB2YWxpZGF0ZVJvb3QsIFxufSBmcm9tICcuL3ZhbGlkYXRlJztcbmltcG9ydCB7XG4gICAgbG9hZFJvb3QsIFxufSBmcm9tICcuL2xvYWRlcic7XG5pbXBvcnQge1xuICAgIGJ1aWxkRGFnRG90LCBcbn0gZnJvbSAnLi9kaWFncmFtL2RhZyc7XG5pbXBvcnQge1xuICAgIGJ1aWxkRXJEb3QsIFxufSBmcm9tICcuL2RpYWdyYW0vZXInO1xuaW1wb3J0IHtcbiAgICByZW5kZXJEb3QsIFxufSBmcm9tICcuL2RpYWdyYW0vcmVuZGVyJztcbmltcG9ydCB7XG4gICAgVmFsaWRhdGlvblJlc3VsdCwgVmlvbGF0aW9uLFxufSBmcm9tICcuL21vZGVsJztcblxuY29uc3QgVVNBR0UgPSBgZmxleGRhdGFzZXQg4oCUIEZsZXhpYmxlIERhdGFzZXQgRGVmaW5pdGlvbiB2YWxpZGF0b3JcblxuVXNhZ2U6XG4gIGZsZXhkYXRhc2V0IHZhbGlkYXRlIDxyb290PiBbLS1mb3JtYXQganNvbnxodW1hbl1cbiAgZmxleGRhdGFzZXQgZ3JhcGggPHJvb3Q+IFstLW91dCA8ZmlsZS5zdmc+XVxuICBmbGV4ZGF0YXNldCBlciA8cm9vdD4gWy0tb3V0IDxmaWxlLnN2Zz5dXG4gIGZsZXhkYXRhc2V0IGhlbHBcblxuT3B0aW9uczpcbiAgLS1mb3JtYXQgICBPdXRwdXQgZm9ybWF0IGZvciBcInZhbGlkYXRlXCIgKGRlZmF1bHQ6IGh1bWFuKS5cbiAgLS1vdXQgICAgICBXcml0ZSBTVkcgdG8gYSBmaWxlIGluc3RlYWQgb2Ygc3Rkb3V0IChncmFwaCAvIGVyKS5gO1xuXG5mdW5jdGlvbiBmb3JtYXRWaW9sYXRpb24odmlvbGF0aW9uOiBWaW9sYXRpb24pOiBzdHJpbmcge1xuICAgIGNvbnN0IGxvY2F0aW9uID0gW1xuICAgICAgICB2aW9sYXRpb24uc2NoZW1hLFxuICAgICAgICB2aW9sYXRpb24udGFibGUsXG4gICAgXS5maWx0ZXIoQm9vbGVhbikuam9pbignLicpO1xuICAgIGNvbnN0IHdoZXJlID0gbG9jYXRpb24gPyBgICR7bG9jYXRpb259YCA6ICcnO1xuICAgIGNvbnN0IGZpZWxkID0gdmlvbGF0aW9uLmZpZWxkID8gYCAoJHt2aW9sYXRpb24uZmllbGR9KWAgOiAnJztcbiAgICByZXR1cm4gYCAgJHt2aW9sYXRpb24ubGV2ZWwudG9VcHBlckNhc2UoKX0gWyR7dmlvbGF0aW9uLmNvZGV9XSR7d2hlcmV9JHtmaWVsZH06ICR7dmlvbGF0aW9uLm1lc3NhZ2V9YDtcbn1cblxuZnVuY3Rpb24gcHJpbnRIdW1hbihyZXN1bHQ6IFZhbGlkYXRpb25SZXN1bHQpOiB2b2lkIHtcbiAgICBjb25zdCBlcnJvcnMgPSByZXN1bHQudmlvbGF0aW9ucy5maWx0ZXIoKHZpb2xhdGlvbikgPT4gdmlvbGF0aW9uLmxldmVsID09PSAnZXJyb3InKTtcbiAgICBjb25zdCB3YXJuaW5ncyA9IHJlc3VsdC52aW9sYXRpb25zLmZpbHRlcigodmlvbGF0aW9uKSA9PiB2aW9sYXRpb24ubGV2ZWwgPT09ICd3YXJuaW5nJyk7XG5cbiAgICBmb3IgKGNvbnN0IHZpb2xhdGlvbiBvZiByZXN1bHQudmlvbGF0aW9ucykge1xuICAgICAgICBjb25zdCBsaW5lID0gZm9ybWF0VmlvbGF0aW9uKHZpb2xhdGlvbik7XG4gICAgICAgIGlmICh2aW9sYXRpb24ubGV2ZWwgPT09ICdlcnJvcicpIHtcbiAgICAgICAgICAgIGNvbnNvbGUuZXJyb3IobGluZSk7XG4gICAgICAgIH0gZWxzZSB7XG4gICAgICAgICAgICBjb25zb2xlLndhcm4obGluZSk7XG4gICAgICAgIH1cbiAgICB9XG5cbiAgICBpZiAocmVzdWx0Lm9rKSB7XG4gICAgICAgIGNvbnNvbGUubG9nKGBPSyDigJQgJHt3YXJuaW5ncy5sZW5ndGh9IHdhcm5pbmcocyksIDAgZXJyb3IocykuYCk7XG4gICAgfSBlbHNlIHtcbiAgICAgICAgY29uc29sZS5lcnJvcihgRkFJTEVEIOKAlCAke2Vycm9ycy5sZW5ndGh9IGVycm9yKHMpLCAke3dhcm5pbmdzLmxlbmd0aH0gd2FybmluZyhzKS5gKTtcbiAgICB9XG59XG5cbmZ1bmN0aW9uIHBhcnNlT3B0aW9ucyhyZXN0OiBzdHJpbmdbXSwgZmxhZzogc3RyaW5nKTogeyB2YWx1ZTogc3RyaW5nIHwgdW5kZWZpbmVkOyBwb3NpdGlvbmFsOiBzdHJpbmdbXSB9IHtcbiAgICBsZXQgdmFsdWU6IHN0cmluZyB8IHVuZGVmaW5lZDtcbiAgICBjb25zdCBwb3NpdGlvbmFsOiBzdHJpbmdbXSA9IFtdO1xuICAgIGZvciAobGV0IGkgPSAwOyBpIDwgcmVzdC5sZW5ndGg7IGkgKz0gMSkge1xuICAgICAgICBpZiAocmVzdFtpXSA9PT0gZmxhZykge1xuICAgICAgICAgICAgaSArPSAxO1xuICAgICAgICAgICAgdmFsdWUgPSByZXN0W2ldO1xuICAgICAgICB9IGVsc2Uge1xuICAgICAgICAgICAgcG9zaXRpb25hbC5wdXNoKHJlc3RbaV0pO1xuICAgICAgICB9XG4gICAgfVxuICAgIHJldHVybiB7XG4gICAgICAgIHZhbHVlLFxuICAgICAgICBwb3NpdGlvbmFsLFxuICAgIH07XG59XG5cbmZ1bmN0aW9uIHJ1blZhbGlkYXRlKHJlc3Q6IHN0cmluZ1tdKTogbnVtYmVyIHtcbiAgICBjb25zdCB7XG4gICAgICAgIHZhbHVlLCBwb3NpdGlvbmFsLCBcbiAgICB9ID0gcGFyc2VPcHRpb25zKHJlc3QsICctLWZvcm1hdCcpO1xuICAgIGNvbnN0IGZvcm1hdCA9IHZhbHVlID8/ICdodW1hbic7XG5cbiAgICBjb25zdCByb290ID0gcG9zaXRpb25hbFswXTtcbiAgICBpZiAoIXJvb3QpIHtcbiAgICAgICAgY29uc29sZS5lcnJvcigndXNhZ2U6IGZsZXhkYXRhc2V0IHZhbGlkYXRlIDxyb290PiBbLS1mb3JtYXQganNvbnxodW1hbl0nKTtcbiAgICAgICAgcmV0dXJuIDE7XG4gICAgfVxuXG4gICAgaWYgKGZvcm1hdCAhPT0gJ2h1bWFuJyAmJiBmb3JtYXQgIT09ICdqc29uJykge1xuICAgICAgICBjb25zb2xlLmVycm9yKGB1bmtub3duIGZvcm1hdCBcIiR7Zm9ybWF0fVwiIChleHBlY3RlZCBcImh1bWFuXCIgb3IgXCJqc29uXCIpYCk7XG4gICAgICAgIHJldHVybiAxO1xuICAgIH1cblxuICAgIGxldCByZXN1bHQ6IFZhbGlkYXRpb25SZXN1bHQ7XG4gICAgdHJ5IHtcbiAgICAgICAgcmVzdWx0ID0gdmFsaWRhdGVSb290KHJvb3QpO1xuICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICAgIGNvbnNvbGUuZXJyb3IoKGVycm9yIGFzIEVycm9yKS5tZXNzYWdlKTtcbiAgICAgICAgcmV0dXJuIDE7XG4gICAgfVxuXG4gICAgaWYgKGZvcm1hdCA9PT0gJ2pzb24nKSB7XG4gICAgICAgIGNvbnNvbGUubG9nKEpTT04uc3RyaW5naWZ5KHtcbiAgICAgICAgICAgIG9rOiByZXN1bHQub2ssXG4gICAgICAgICAgICB2aW9sYXRpb25zOiByZXN1bHQudmlvbGF0aW9ucyxcbiAgICAgICAgfSwgbnVsbCwgMikpO1xuICAgIH0gZWxzZSB7XG4gICAgICAgIHByaW50SHVtYW4ocmVzdWx0KTtcbiAgICB9XG5cbiAgICByZXR1cm4gcmVzdWx0Lm9rID8gMCA6IDE7XG59XG5cbmFzeW5jIGZ1bmN0aW9uIHJ1bkRpYWdyYW0oY29tbWFuZDogJ2dyYXBoJyB8ICdlcicsIHJlc3Q6IHN0cmluZ1tdKTogUHJvbWlzZTxudW1iZXI+IHtcbiAgICBjb25zdCB7XG4gICAgICAgIHZhbHVlOiBvdXQsIHBvc2l0aW9uYWwsIFxuICAgIH0gPSBwYXJzZU9wdGlvbnMocmVzdCwgJy0tb3V0Jyk7XG5cbiAgICBjb25zdCByb290ID0gcG9zaXRpb25hbFswXTtcbiAgICBpZiAoIXJvb3QpIHtcbiAgICAgICAgY29uc29sZS5lcnJvcihgdXNhZ2U6IGZsZXhkYXRhc2V0ICR7Y29tbWFuZH0gPHJvb3Q+IFstLW91dCA8ZmlsZS5zdmc+XWApO1xuICAgICAgICByZXR1cm4gMTtcbiAgICB9XG5cbiAgICB0cnkge1xuICAgICAgICBjb25zdCB3b3JsZCA9IGxvYWRSb290KHJvb3QpLndvcmxkO1xuICAgICAgICBjb25zdCBkb3QgPSBjb21tYW5kID09PSAnZ3JhcGgnID8gYnVpbGREYWdEb3Qod29ybGQpIDogYnVpbGRFckRvdCh3b3JsZCk7XG4gICAgICAgIGNvbnN0IHN2ZyA9IGF3YWl0IHJlbmRlckRvdChkb3QpO1xuICAgICAgICBpZiAob3V0KSB7XG4gICAgICAgICAgICBmcy53cml0ZUZpbGVTeW5jKG91dCwgc3ZnLCAndXRmLTgnKTtcbiAgICAgICAgICAgIGNvbnNvbGUuZXJyb3IoYHdyb3RlICR7b3V0fWApO1xuICAgICAgICB9IGVsc2Uge1xuICAgICAgICAgICAgY29uc29sZS5sb2coc3ZnKTtcbiAgICAgICAgfVxuICAgICAgICByZXR1cm4gMDtcbiAgICB9IGNhdGNoIChlcnJvcikge1xuICAgICAgICBjb25zb2xlLmVycm9yKChlcnJvciBhcyBFcnJvcikubWVzc2FnZSk7XG4gICAgICAgIHJldHVybiAxO1xuICAgIH1cbn1cblxuYXN5bmMgZnVuY3Rpb24gbWFpbihhcmd2OiBzdHJpbmdbXSk6IFByb21pc2U8bnVtYmVyPiB7XG4gICAgY29uc3QgYXJncyA9IGFyZ3Yuc2xpY2UoMik7XG4gICAgY29uc3QgY29tbWFuZCA9IGFyZ3NbMF07XG5cbiAgICBpZiAoIWNvbW1hbmQpIHtcbiAgICAgICAgY29uc29sZS5lcnJvcihVU0FHRSk7XG4gICAgICAgIHJldHVybiAxO1xuICAgIH1cbiAgICBpZiAoY29tbWFuZCA9PT0gJ2hlbHAnIHx8IGNvbW1hbmQgPT09ICctLWhlbHAnIHx8IGNvbW1hbmQgPT09ICctaCcpIHtcbiAgICAgICAgY29uc29sZS5sb2coVVNBR0UpO1xuICAgICAgICByZXR1cm4gMDtcbiAgICB9XG4gICAgaWYgKGNvbW1hbmQgPT09ICd2YWxpZGF0ZScpIHtcbiAgICAgICAgcmV0dXJuIHJ1blZhbGlkYXRlKGFyZ3Muc2xpY2UoMSkpO1xuICAgIH1cbiAgICBpZiAoY29tbWFuZCA9PT0gJ2dyYXBoJyB8fCBjb21tYW5kID09PSAnZXInKSB7XG4gICAgICAgIHJldHVybiBydW5EaWFncmFtKGNvbW1hbmQsIGFyZ3Muc2xpY2UoMSkpO1xuICAgIH1cblxuICAgIGNvbnNvbGUuZXJyb3IoYHVua25vd24gY29tbWFuZDogJHtjb21tYW5kfWApO1xuICAgIGNvbnNvbGUuZXJyb3IoVVNBR0UpO1xuICAgIHJldHVybiAxO1xufVxuXG5tYWluKHByb2Nlc3MuYXJndikudGhlbigoY29kZSkgPT4ge1xuICAgIHByb2Nlc3MuZXhpdChjb2RlKTtcbn0pLmNhdGNoKChlcnJvcikgPT4ge1xuICAgIGNvbnNvbGUuZXJyb3IoKGVycm9yIGFzIEVycm9yKS5tZXNzYWdlKTtcbiAgICBwcm9jZXNzLmV4aXQoMSk7XG59KTtcbiJdfQ==

package/dist/src/diagram/dag.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Dependency-graph (DAG) rendering. Produces Graphviz DOT for the `dependsOn`
+ * graph: one node per table (labelled with the table name only), clustered by
+ * schema, with an edge from each upstream table to each downstream table.
+ *
+ * The DOT is built deterministically (schemas, tables, and edges are sorted) so
+ * the rendered SVG is stable and diff-friendly.
+ */
+import { World } from '../world';
+/**
+ * Build Graphviz DOT for the dependency DAG of a loaded root.
+ *
+ * @param world The loaded dataset root.
+ * @returns A DOT `digraph` document.
+ */
+export declare function buildDagDot(world: World): string;

package/dist/src/diagram/dag.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Dependency-graph (DAG) rendering. Produces Graphviz DOT for the `dependsOn`
+ * graph: one node per table (labelled with the table name only), clustered by
+ * schema, with an edge from each upstream table to each downstream table.
+ *
+ * The DOT is built deterministically (schemas, tables, and edges are sorted) so
+ * the rendered SVG is stable and diff-friendly.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDagDot = buildDagDot;
+/** Escape a string for use inside a double-quoted DOT identifier or label. */
+function escapeDot(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+/**
+ * Build Graphviz DOT for the dependency DAG of a loaded root.
+ *
+ * @param world The loaded dataset root.
+ * @returns A DOT `digraph` document.
+ */
+function buildDagDot(world) {
+    const lines = [
+        'digraph dependencies {',
+        '    rankdir=LR;',
+        '    node [shape=box, style=rounded];',
+    ];
+    const schemas = [
+        ...world.schemas.values(),
+    ].sort((a, b) => a.name.localeCompare(b.name));
+    for (const schema of schemas) {
+        lines.push(`    subgraph "cluster_${escapeDot(schema.name)}" {`);
+        lines.push(`        label="${escapeDot(schema.name)}";`);
+        const tables = [
+            ...schema.tables,
+        ].sort((a, b) => a.name.localeCompare(b.name));
+        for (const table of tables) {
+            lines.push(`        "${escapeDot(table.qualifiedName)}" [label="${escapeDot(table.name)}"];`);
+        }
+        lines.push('    }');
+    }
+    const tables = [
+        ...world.tables.values(),
+    ].sort((a, b) => a.qualifiedName.localeCompare(b.qualifiedName));
+    for (const table of tables) {
+        const dependencies = [
+            ...table.definition.dependsOn,
+        ].sort((a, b) => a.localeCompare(b));
+        for (const dependency of dependencies) {
+            if (world.tables.has(dependency)) {
+                lines.push(`    "${escapeDot(dependency)}" -> "${escapeDot(table.qualifiedName)}";`);
+            }
+        }
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGFnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2RpYWdyYW0vZGFnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7Ozs7OztHQU9HOztBQWlCSCxrQ0FzQ0M7QUFqREQsOEVBQThFO0FBQzlFLFNBQVMsU0FBUyxDQUFDLEtBQWE7SUFDNUIsT0FBTyxLQUFLLENBQUMsT0FBTyxDQUFDLEtBQUssRUFBRSxNQUFNLENBQUMsQ0FBQyxPQUFPLENBQUMsSUFBSSxFQUFFLEtBQUssQ0FBQyxDQUFDO0FBQzdELENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILFNBQWdCLFdBQVcsQ0FBQyxLQUFZO0lBQ3BDLE1BQU0sS0FBSyxHQUFhO1FBQ3BCLHdCQUF3QjtRQUN4QixpQkFBaUI7UUFDakIsc0NBQXNDO0tBQ3pDLENBQUM7SUFFRixNQUFNLE9BQU8sR0FBRztRQUNaLEdBQUcsS0FBSyxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUU7S0FDNUIsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQztJQUMvQyxLQUFLLE1BQU0sTUFBTSxJQUFJLE9BQU8sRUFBRSxDQUFDO1FBQzNCLEtBQUssQ0FBQyxJQUFJLENBQUMseUJBQXlCLFNBQVMsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQ2pFLEtBQUssQ0FBQyxJQUFJLENBQUMsa0JBQWtCLFNBQVMsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ3pELE1BQU0sTUFBTSxHQUFHO1lBQ1gsR0FBRyxNQUFNLENBQUMsTUFBTTtTQUNuQixDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsYUFBYSxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDO1FBQy9DLEtBQUssTUFBTSxLQUFLLElBQUksTUFBTSxFQUFFLENBQUM7WUFDekIsS0FBSyxDQUFDLElBQUksQ0FBQyxZQUFZLFNBQVMsQ0FBQyxLQUFLLENBQUMsYUFBYSxDQUFDLGFBQWEsU0FBUyxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDbEcsQ0FBQztRQUNELEtBQUssQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDeEIsQ0FBQztJQUVELE1BQU0sTUFBTSxHQUFHO1FBQ1gsR0FBRyxLQUFLLENBQUMsTUFBTSxDQUFDLE1BQU0sRUFBRTtLQUMzQixDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxhQUFhLENBQUMsYUFBYSxDQUFDLENBQUMsQ0FBQyxhQUFhLENBQUMsQ0FBQyxDQUFDO0lBQ2pFLEtBQUssTUFBTSxLQUFLLElBQUksTUFBTSxFQUFFLENBQUM7UUFDekIsTUFBTSxZQUFZLEdBQUc7WUFDakIsR0FBRyxLQUFLLENBQUMsVUFBVSxDQUFDLFNBQVM7U0FDaEMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsYUFBYSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDckMsS0FBSyxNQUFNLFVBQVUsSUFBSSxZQUFZLEVBQUUsQ0FBQztZQUNwQyxJQUFJLEtBQUssQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLFVBQVUsQ0FBQyxFQUFFLENBQUM7Z0JBQy9CLEtBQUssQ0FBQyxJQUFJLENBQUMsUUFBUSxTQUFTLENBQUMsVUFBVSxDQUFDLFNBQVMsU0FBUyxDQUFDLEtBQUssQ0FBQyxhQUFhLENBQUMsSUFBSSxDQUFDLENBQUM7WUFDekYsQ0FBQztRQUNMLENBQUM7SUFDTCxDQUFDO0lBRUQsS0FBSyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUNoQixPQUFPLEtBQUssQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7QUFDNUIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogRGVwZW5kZW5jeS1ncmFwaCAoREFHKSByZW5kZXJpbmcuIFByb2R1Y2VzIEdyYXBodml6IERPVCBmb3IgdGhlIGBkZXBlbmRzT25gXG4gKiBncmFwaDogb25lIG5vZGUgcGVyIHRhYmxlIChsYWJlbGxlZCB3aXRoIHRoZSB0YWJsZSBuYW1lIG9ubHkpLCBjbHVzdGVyZWQgYnlcbiAqIHNjaGVtYSwgd2l0aCBhbiBlZGdlIGZyb20gZWFjaCB1cHN0cmVhbSB0YWJsZSB0byBlYWNoIGRvd25zdHJlYW0gdGFibGUuXG4gKlxuICogVGhlIERPVCBpcyBidWlsdCBkZXRlcm1pbmlzdGljYWxseSAoc2NoZW1hcywgdGFibGVzLCBhbmQgZWRnZXMgYXJlIHNvcnRlZCkgc29cbiAqIHRoZSByZW5kZXJlZCBTVkcgaXMgc3RhYmxlIGFuZCBkaWZmLWZyaWVuZGx5LlxuICovXG5cbmltcG9ydCB7XG4gICAgV29ybGQsXG59IGZyb20gJy4uL3dvcmxkJztcblxuLyoqIEVzY2FwZSBhIHN0cmluZyBmb3IgdXNlIGluc2lkZSBhIGRvdWJsZS1xdW90ZWQgRE9UIGlkZW50aWZpZXIgb3IgbGFiZWwuICovXG5mdW5jdGlvbiBlc2NhcGVEb3QodmFsdWU6IHN0cmluZyk6IHN0cmluZyB7XG4gICAgcmV0dXJuIHZhbHVlLnJlcGxhY2UoL1xcXFwvZywgJ1xcXFxcXFxcJykucmVwbGFjZSgvXCIvZywgJ1xcXFxcIicpO1xufVxuXG4vKipcbiAqIEJ1aWxkIEdyYXBodml6IERPVCBmb3IgdGhlIGRlcGVuZGVuY3kgREFHIG9mIGEgbG9hZGVkIHJvb3QuXG4gKlxuICogQHBhcmFtIHdvcmxkIFRoZSBsb2FkZWQgZGF0YXNldCByb290LlxuICogQHJldHVybnMgQSBET1QgYGRpZ3JhcGhgIGRvY3VtZW50LlxuICovXG5leHBvcnQgZnVuY3Rpb24gYnVpbGREYWdEb3Qod29ybGQ6IFdvcmxkKTogc3RyaW5nIHtcbiAgICBjb25zdCBsaW5lczogc3RyaW5nW10gPSBbXG4gICAgICAgICdkaWdyYXBoIGRlcGVuZGVuY2llcyB7JyxcbiAgICAgICAgJyAgICByYW5rZGlyPUxSOycsXG4gICAgICAgICcgICAgbm9kZSBbc2hhcGU9Ym94LCBzdHlsZT1yb3VuZGVkXTsnLFxuICAgIF07XG5cbiAgICBjb25zdCBzY2hlbWFzID0gW1xuICAgICAgICAuLi53b3JsZC5zY2hlbWFzLnZhbHVlcygpLFxuICAgIF0uc29ydCgoYSwgYikgPT4gYS5uYW1lLmxvY2FsZUNvbXBhcmUoYi5uYW1lKSk7XG4gICAgZm9yIChjb25zdCBzY2hlbWEgb2Ygc2NoZW1hcykge1xuICAgICAgICBsaW5lcy5wdXNoKGAgICAgc3ViZ3JhcGggXCJjbHVzdGVyXyR7ZXNjYXBlRG90KHNjaGVtYS5uYW1lKX1cIiB7YCk7XG4gICAgICAgIGxpbmVzLnB1c2goYCAgICAgICAgbGFiZWw9XCIke2VzY2FwZURvdChzY2hlbWEubmFtZSl9XCI7YCk7XG4gICAgICAgIGNvbnN0IHRhYmxlcyA9IFtcbiAgICAgICAgICAgIC4uLnNjaGVtYS50YWJsZXMsXG4gICAgICAgIF0uc29ydCgoYSwgYikgPT4gYS5uYW1lLmxvY2FsZUNvbXBhcmUoYi5uYW1lKSk7XG4gICAgICAgIGZvciAoY29uc3QgdGFibGUgb2YgdGFibGVzKSB7XG4gICAgICAgICAgICBsaW5lcy5wdXNoKGAgICAgICAgIFwiJHtlc2NhcGVEb3QodGFibGUucXVhbGlmaWVkTmFtZSl9XCIgW2xhYmVsPVwiJHtlc2NhcGVEb3QodGFibGUubmFtZSl9XCJdO2ApO1xuICAgICAgICB9XG4gICAgICAgIGxpbmVzLnB1c2goJyAgICB9Jyk7XG4gICAgfVxuXG4gICAgY29uc3QgdGFibGVzID0gW1xuICAgICAgICAuLi53b3JsZC50YWJsZXMudmFsdWVzKCksXG4gICAgXS5zb3J0KChhLCBiKSA9PiBhLnF1YWxpZmllZE5hbWUubG9jYWxlQ29tcGFyZShiLnF1YWxpZmllZE5hbWUpKTtcbiAgICBmb3IgKGNvbnN0IHRhYmxlIG9mIHRhYmxlcykge1xuICAgICAgICBjb25zdCBkZXBlbmRlbmNpZXMgPSBbXG4gICAgICAgICAgICAuLi50YWJsZS5kZWZpbml0aW9uLmRlcGVuZHNPbixcbiAgICAgICAgXS5zb3J0KChhLCBiKSA9PiBhLmxvY2FsZUNvbXBhcmUoYikpO1xuICAgICAgICBmb3IgKGNvbnN0IGRlcGVuZGVuY3kgb2YgZGVwZW5kZW5jaWVzKSB7XG4gICAgICAgICAgICBpZiAod29ybGQudGFibGVzLmhhcyhkZXBlbmRlbmN5KSkge1xuICAgICAgICAgICAgICAgIGxpbmVzLnB1c2goYCAgICBcIiR7ZXNjYXBlRG90KGRlcGVuZGVuY3kpfVwiIC0+IFwiJHtlc2NhcGVEb3QodGFibGUucXVhbGlmaWVkTmFtZSl9XCI7YCk7XG4gICAgICAgICAgICB9XG4gICAgICAgIH1cbiAgICB9XG5cbiAgICBsaW5lcy5wdXNoKCd9Jyk7XG4gICAgcmV0dXJuIGxpbmVzLmpvaW4oJ1xcbicpO1xufVxuIl19

package/dist/src/diagram/er.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Entity-relationship (ER) rendering. Produces Graphviz DOT where each table is
+ * an HTML-label node listing its columns (primary-key columns marked `PK`), with
+ * a foreign-key edge from each table to the table it references.
+ *
+ * Built deterministically (tables and foreign keys sorted; columns kept in
+ * declared order) for stable, diff-friendly SVG output.
+ */
+import { World } from '../world';
+/**
+ * Build Graphviz DOT for the entity-relationship diagram of a loaded root.
+ *
+ * @param world The loaded dataset root.
+ * @returns A DOT `digraph` document.
+ */
+export declare function buildErDot(world: World): string;

package/dist/src/diagram/er.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Entity-relationship (ER) rendering. Produces Graphviz DOT where each table is
+ * an HTML-label node listing its columns (primary-key columns marked `PK`), with
+ * a foreign-key edge from each table to the table it references.
+ *
+ * Built deterministically (tables and foreign keys sorted; columns kept in
+ * declared order) for stable, diff-friendly SVG output.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildErDot = buildErDot;
+/** Escape text for inclusion in a Graphviz HTML-like label. */
+function htmlEscape(value) {
+    return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+/** Escape a string for a double-quoted DOT identifier or attribute value. */
+function escapeDot(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+/**
+ * Build Graphviz DOT for the entity-relationship diagram of a loaded root.
+ *
+ * @param world The loaded dataset root.
+ * @returns A DOT `digraph` document.
+ */
+function buildErDot(world) {
+    const lines = [
+        'digraph er {',
+        '    rankdir=LR;',
+        '    node [shape=plaintext];',
+    ];
+    const tables = [
+        ...world.tables.values(),
+    ].sort((a, b) => a.qualifiedName.localeCompare(b.qualifiedName));
+    for (const table of tables) {
+        const primaryKey = new Set(table.definition.primaryKey);
+        lines.push(`    "${escapeDot(table.qualifiedName)}" [label=<`);
+        lines.push('        <table border="0" cellborder="1" cellspacing="0">');
+        lines.push(`        <tr><td bgcolor="lightgrey"><b>${htmlEscape(table.qualifiedName)}</b></td></tr>`);
+        for (const column of table.definition.columns) {
+            const marker = primaryKey.has(column.name) ? 'PK ' : '';
+            const cell = `${htmlEscape(marker + column.name)} : ${htmlEscape(column.type)}`;
+            lines.push(`        <tr><td align="left">${cell}</td></tr>`);
+        }
+        lines.push('        </table>');
+        lines.push('    >];');
+    }
+    for (const table of tables) {
+        const foreignKeys = [
+            ...table.definition.foreignKeys,
+        ].sort((a, b) => `${a.sourceTable} ${a.localColumn}`.localeCompare(`${b.sourceTable} ${b.localColumn}`));
+        for (const foreignKey of foreignKeys) {
+            if (world.tables.has(foreignKey.sourceTable)) {
+                lines.push(`    "${escapeDot(table.qualifiedName)}" -> "${escapeDot(foreignKey.sourceTable)}" `
+                    + `[label="${escapeDot(foreignKey.localColumn)}"];`);
+            }
+        }
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvZGlhZ3JhbS9lci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7R0FPRzs7QUFzQkgsZ0NBMkNDO0FBM0RELCtEQUErRDtBQUMvRCxTQUFTLFVBQVUsQ0FBQyxLQUFhO0lBQzdCLE9BQU8sS0FBSyxDQUFDLE9BQU8sQ0FBQyxJQUFJLEVBQUUsT0FBTyxDQUFDLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxNQUFNLENBQUMsQ0FBQyxPQUFPLENBQUMsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO0FBQ3BGLENBQUM7QUFFRCw2RUFBNkU7QUFDN0UsU0FBUyxTQUFTLENBQUMsS0FBYTtJQUM1QixPQUFPLEtBQUssQ0FBQyxPQUFPLENBQUMsS0FBSyxFQUFFLE1BQU0sQ0FBQyxDQUFDLE9BQU8sQ0FBQyxJQUFJLEVBQUUsS0FBSyxDQUFDLENBQUM7QUFDN0QsQ0FBQztBQUVEOzs7OztHQUtHO0FBQ0gsU0FBZ0IsVUFBVSxDQUFDLEtBQVk7SUFDbkMsTUFBTSxLQUFLLEdBQWE7UUFDcEIsY0FBYztRQUNkLGlCQUFpQjtRQUNqQiw2QkFBNkI7S0FDaEMsQ0FBQztJQUVGLE1BQU0sTUFBTSxHQUFHO1FBQ1gsR0FBRyxLQUFLLENBQUMsTUFBTSxDQUFDLE1BQU0sRUFBRTtLQUMzQixDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxhQUFhLENBQUMsYUFBYSxDQUFDLENBQUMsQ0FBQyxhQUFhLENBQUMsQ0FBQyxDQUFDO0lBRWpFLEtBQUssTUFBTSxLQUFLLElBQUksTUFBTSxFQUFFLENBQUM7UUFDekIsTUFBTSxVQUFVLEdBQUcsSUFBSSxHQUFHLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQyxVQUFVLENBQUMsQ0FBQztRQUN4RCxLQUFLLENBQUMsSUFBSSxDQUFDLFFBQVEsU0FBUyxDQUFDLEtBQUssQ0FBQyxhQUFhLENBQUMsWUFBWSxDQUFDLENBQUM7UUFDL0QsS0FBSyxDQUFDLElBQUksQ0FBQywyREFBMkQsQ0FBQyxDQUFDO1FBQ3hFLEtBQUssQ0FBQyxJQUFJLENBQUMsMENBQTBDLFVBQVUsQ0FBQyxLQUFLLENBQUMsYUFBYSxDQUFDLGdCQUFnQixDQUFDLENBQUM7UUFDdEcsS0FBSyxNQUFNLE1BQU0sSUFBSSxLQUFLLENBQUMsVUFBVSxDQUFDLE9BQU8sRUFBRSxDQUFDO1lBQzVDLE1BQU0sTUFBTSxHQUFHLFVBQVUsQ0FBQyxHQUFHLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztZQUN4RCxNQUFNLElBQUksR0FBRyxHQUFHLFVBQVUsQ0FBQyxNQUFNLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FBQyxNQUFNLFVBQVUsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztZQUNoRixLQUFLLENBQUMsSUFBSSxDQUFDLGdDQUFnQyxJQUFJLFlBQVksQ0FBQyxDQUFDO1FBQ2pFLENBQUM7UUFDRCxLQUFLLENBQUMsSUFBSSxDQUFDLGtCQUFrQixDQUFDLENBQUM7UUFDL0IsS0FBSyxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQztJQUMxQixDQUFDO0lBRUQsS0FBSyxNQUFNLEtBQUssSUFBSSxNQUFNLEVBQUUsQ0FBQztRQUN6QixNQUFNLFdBQVcsR0FBRztZQUNoQixHQUFHLEtBQUssQ0FBQyxVQUFVLENBQUMsV0FBVztTQUNsQyxDQUFDLElBQUksQ0FDRixDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUFDLEdBQUcsQ0FBQyxDQUFDLFdBQVcsSUFBSSxDQUFDLENBQUMsV0FBVyxFQUFFLENBQUMsYUFBYSxDQUFDLEdBQUcsQ0FBQyxDQUFDLFdBQVcsSUFBSSxDQUFDLENBQUMsV0FBVyxFQUFFLENBQUMsQ0FDbkcsQ0FBQztRQUNGLEtBQUssTUFBTSxVQUFVLElBQUksV0FBVyxFQUFFLENBQUM7WUFDbkMsSUFBSSxLQUFLLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsV0FBVyxDQUFDLEVBQUUsQ0FBQztnQkFDM0MsS0FBSyxDQUFDLElBQUksQ0FDTixRQUFRLFNBQVMsQ0FBQyxLQUFLLENBQUMsYUFBYSxDQUFDLFNBQVMsU0FBUyxDQUFDLFVBQVUsQ0FBQyxXQUFXLENBQUMsSUFBSTtzQkFDbEYsV0FBVyxTQUFTLENBQUMsVUFBVSxDQUFDLFdBQVcsQ0FBQyxLQUFLLENBQ3RELENBQUM7WUFDTixDQUFDO1FBQ0wsQ0FBQztJQUNMLENBQUM7SUFFRCxLQUFLLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQ2hCLE9BQU8sS0FBSyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztBQUM1QixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBFbnRpdHktcmVsYXRpb25zaGlwIChFUikgcmVuZGVyaW5nLiBQcm9kdWNlcyBHcmFwaHZpeiBET1Qgd2hlcmUgZWFjaCB0YWJsZSBpc1xuICogYW4gSFRNTC1sYWJlbCBub2RlIGxpc3RpbmcgaXRzIGNvbHVtbnMgKHByaW1hcnkta2V5IGNvbHVtbnMgbWFya2VkIGBQS2ApLCB3aXRoXG4gKiBhIGZvcmVpZ24ta2V5IGVkZ2UgZnJvbSBlYWNoIHRhYmxlIHRvIHRoZSB0YWJsZSBpdCByZWZlcmVuY2VzLlxuICpcbiAqIEJ1aWx0IGRldGVybWluaXN0aWNhbGx5ICh0YWJsZXMgYW5kIGZvcmVpZ24ga2V5cyBzb3J0ZWQ7IGNvbHVtbnMga2VwdCBpblxuICogZGVjbGFyZWQgb3JkZXIpIGZvciBzdGFibGUsIGRpZmYtZnJpZW5kbHkgU1ZHIG91dHB1dC5cbiAqL1xuXG5pbXBvcnQge1xuICAgIFdvcmxkLFxufSBmcm9tICcuLi93b3JsZCc7XG5cbi8qKiBFc2NhcGUgdGV4dCBmb3IgaW5jbHVzaW9uIGluIGEgR3JhcGh2aXogSFRNTC1saWtlIGxhYmVsLiAqL1xuZnVuY3Rpb24gaHRtbEVzY2FwZSh2YWx1ZTogc3RyaW5nKTogc3RyaW5nIHtcbiAgICByZXR1cm4gdmFsdWUucmVwbGFjZSgvJi9nLCAnJmFtcDsnKS5yZXBsYWNlKC88L2csICcmbHQ7JykucmVwbGFjZSgvPi9nLCAnJmd0OycpO1xufVxuXG4vKiogRXNjYXBlIGEgc3RyaW5nIGZvciBhIGRvdWJsZS1xdW90ZWQgRE9UIGlkZW50aWZpZXIgb3IgYXR0cmlidXRlIHZhbHVlLiAqL1xuZnVuY3Rpb24gZXNjYXBlRG90KHZhbHVlOiBzdHJpbmcpOiBzdHJpbmcge1xuICAgIHJldHVybiB2YWx1ZS5yZXBsYWNlKC9cXFxcL2csICdcXFxcXFxcXCcpLnJlcGxhY2UoL1wiL2csICdcXFxcXCInKTtcbn1cblxuLyoqXG4gKiBCdWlsZCBHcmFwaHZpeiBET1QgZm9yIHRoZSBlbnRpdHktcmVsYXRpb25zaGlwIGRpYWdyYW0gb2YgYSBsb2FkZWQgcm9vdC5cbiAqXG4gKiBAcGFyYW0gd29ybGQgVGhlIGxvYWRlZCBkYXRhc2V0IHJvb3QuXG4gKiBAcmV0dXJucyBBIERPVCBgZGlncmFwaGAgZG9jdW1lbnQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBidWlsZEVyRG90KHdvcmxkOiBXb3JsZCk6IHN0cmluZyB7XG4gICAgY29uc3QgbGluZXM6IHN0cmluZ1tdID0gW1xuICAgICAgICAnZGlncmFwaCBlciB7JyxcbiAgICAgICAgJyAgICByYW5rZGlyPUxSOycsXG4gICAgICAgICcgICAgbm9kZSBbc2hhcGU9cGxhaW50ZXh0XTsnLFxuICAgIF07XG5cbiAgICBjb25zdCB0YWJsZXMgPSBbXG4gICAgICAgIC4uLndvcmxkLnRhYmxlcy52YWx1ZXMoKSxcbiAgICBdLnNvcnQoKGEsIGIpID0+IGEucXVhbGlmaWVkTmFtZS5sb2NhbGVDb21wYXJlKGIucXVhbGlmaWVkTmFtZSkpO1xuXG4gICAgZm9yIChjb25zdCB0YWJsZSBvZiB0YWJsZXMpIHtcbiAgICAgICAgY29uc3QgcHJpbWFyeUtleSA9IG5ldyBTZXQodGFibGUuZGVmaW5pdGlvbi5wcmltYXJ5S2V5KTtcbiAgICAgICAgbGluZXMucHVzaChgICAgIFwiJHtlc2NhcGVEb3QodGFibGUucXVhbGlmaWVkTmFtZSl9XCIgW2xhYmVsPTxgKTtcbiAgICAgICAgbGluZXMucHVzaCgnICAgICAgICA8dGFibGUgYm9yZGVyPVwiMFwiIGNlbGxib3JkZXI9XCIxXCIgY2VsbHNwYWNpbmc9XCIwXCI+Jyk7XG4gICAgICAgIGxpbmVzLnB1c2goYCAgICAgICAgPHRyPjx0ZCBiZ2NvbG9yPVwibGlnaHRncmV5XCI+PGI+JHtodG1sRXNjYXBlKHRhYmxlLnF1YWxpZmllZE5hbWUpfTwvYj48L3RkPjwvdHI+YCk7XG4gICAgICAgIGZvciAoY29uc3QgY29sdW1uIG9mIHRhYmxlLmRlZmluaXRpb24uY29sdW1ucykge1xuICAgICAgICAgICAgY29uc3QgbWFya2VyID0gcHJpbWFyeUtleS5oYXMoY29sdW1uLm5hbWUpID8gJ1BLICcgOiAnJztcbiAgICAgICAgICAgIGNvbnN0IGNlbGwgPSBgJHtodG1sRXNjYXBlKG1hcmtlciArIGNvbHVtbi5uYW1lKX0gOiAke2h0bWxFc2NhcGUoY29sdW1uLnR5cGUpfWA7XG4gICAgICAgICAgICBsaW5lcy5wdXNoKGAgICAgICAgIDx0cj48dGQgYWxpZ249XCJsZWZ0XCI+JHtjZWxsfTwvdGQ+PC90cj5gKTtcbiAgICAgICAgfVxuICAgICAgICBsaW5lcy5wdXNoKCcgICAgICAgIDwvdGFibGU+Jyk7XG4gICAgICAgIGxpbmVzLnB1c2goJyAgICA+XTsnKTtcbiAgICB9XG5cbiAgICBmb3IgKGNvbnN0IHRhYmxlIG9mIHRhYmxlcykge1xuICAgICAgICBjb25zdCBmb3JlaWduS2V5cyA9IFtcbiAgICAgICAgICAgIC4uLnRhYmxlLmRlZmluaXRpb24uZm9yZWlnbktleXMsXG4gICAgICAgIF0uc29ydChcbiAgICAgICAgICAgIChhLCBiKSA9PiBgJHthLnNvdXJjZVRhYmxlfSAke2EubG9jYWxDb2x1bW59YC5sb2NhbGVDb21wYXJlKGAke2Iuc291cmNlVGFibGV9ICR7Yi5sb2NhbENvbHVtbn1gKSxcbiAgICAgICAgKTtcbiAgICAgICAgZm9yIChjb25zdCBmb3JlaWduS2V5IG9mIGZvcmVpZ25LZXlzKSB7XG4gICAgICAgICAgICBpZiAod29ybGQudGFibGVzLmhhcyhmb3JlaWduS2V5LnNvdXJjZVRhYmxlKSkge1xuICAgICAgICAgICAgICAgIGxpbmVzLnB1c2goXG4gICAgICAgICAgICAgICAgICAgIGAgICAgXCIke2VzY2FwZURvdCh0YWJsZS5xdWFsaWZpZWROYW1lKX1cIiAtPiBcIiR7ZXNjYXBlRG90KGZvcmVpZ25LZXkuc291cmNlVGFibGUpfVwiIGBcbiAgICAgICAgICAgICAgICAgICAgKyBgW2xhYmVsPVwiJHtlc2NhcGVEb3QoZm9yZWlnbktleS5sb2NhbENvbHVtbil9XCJdO2AsXG4gICAgICAgICAgICAgICAgKTtcbiAgICAgICAgICAgIH1cbiAgICAgICAgfVxuICAgIH1cblxuICAgIGxpbmVzLnB1c2goJ30nKTtcbiAgICByZXR1cm4gbGluZXMuam9pbignXFxuJyk7XG59XG4iXX0=

package/dist/src/diagram/render.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Thin wrapper over the WASM Graphviz engine. Kept separate from the DOT
+ * builders so the (pure, deterministic) DOT generation can be unit-tested
+ * without loading WASM.
+ */
+/**
+ * Render a Graphviz DOT document to SVG.
+ *
+ * `@hpcc-js/wasm-graphviz` is ESM-only, so it is pulled in via a dynamic import
+ * (preserved by the NodeNext target and resolvable from this CommonJS module at
+ * runtime) rather than a static import.
+ *
+ * @param dot A DOT document.
+ * @returns The rendered SVG markup.
+ */
+export declare function renderDot(dot: string): Promise<string>;