lowkey-doc 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lorenzo Balboni
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 THE
+AUTHORS OR COPYRIGHT HOLDERS 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

@@ -1,3 +1,53 @@
-# Temporary Holding Version
+<h1 align="center">Lowkey Doc</h1>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<p align="center">
+  lowkey it's just docs<br>
+  A folder of Markdown, as <em>one page you can email</em>
+</p>
+
+Lowkey Doc turns a folder of Markdown into one self-contained HTML page. No server, no build step, no dependencies: double-click it and read.
+
+- **Draws diagrams that stay readable.** Mermaid still parses your flowcharts, ER and sequence diagrams; [ELK](https://eclipse.dev/elk/) lays them out so every label gets its own space and is tied to its own arrow.
+- **Lets you question a diagram.** Hover an arrow or a box and everything else fades. Click to pin it, **Esc** to let go.
+- **Keeps the docs easy to move around.** A sidebar ordered by the number in each filename, foldable sections, search, and links that work both here and on GitHub.
+
+| Mermaid's own layout | Lowkey Doc |
+| --- | --- |
+| ![The same flowchart in Mermaid's layout, labels piled on top of each other](assets/layout-mermaid.jpg) | ![The same flowchart in Lowkey Doc, every label beside its own arrow](assets/layout-lowkey-doc.jpg) |
+
+> [!NOTE]
+> The first build needs a connection to download Mermaid, ELK and the Inter font. Every build after that works offline.
+
+## Install
+
+Requires Node 22+. Run it without installing anything:
+
+```sh
+npx lowkey-doc ./docs
+```
+
+Or install it once, and test with `--help`:
+
+```sh
+npm install -g lowkey-doc
+lowkey-doc --help
+```
+
+## Use it
+
+| Run | To |
+| --- | --- |
+| `lowkey-doc ./docs` | Render a folder, no setup needed |
+| `lowkey-doc init` | Set a project up once, then just run `lowkey-doc` |
+| `lowkey-doc --watch` | Serve the page and update it on every save |
+
+The page is written to `.lowkey-doc/index.html`. `init` also adds a `/docs` command and skills for writing and auditing docs to the project's `.claude/` folder.
+
+See the [configuration docs](./docs/3.%20CONFIGURATION.md) for every setting and flag, and [docs/](./docs/0.%20ABOUT.md) for everything else.
+
+## Develop
+
+```sh
+node bin/lowkey-doc.mjs    # render this repo's own docs
+npm run check              # smoke test
+```

package/bin/lowkey-doc.mjs

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+// lowkey-doc
+// ------------------------------------------------------------------
+// Render a folder of Markdown into one static, self-contained
+// documentation dashboard and open it in the browser.
+//
+//   lowkey-doc                    build the folder in docs.config.json, else docs/
+//   lowkey-doc ./docs             build this folder instead
+//   lowkey-doc --no-open          build only
+//   lowkey-doc --out <dir>        write somewhere else
+//   lowkey-doc --refresh          re-download the vendored assets
+//   lowkey-doc --engine mermaid   default every diagram to mermaid's layout
+//   lowkey-doc --watch            serve it on localhost, update on every save
+//   lowkey-doc init [dir]         wire a project up
+//
+// Output: <out>/index.html plus a vendor/ folder. The page is plain file://
+// HTML - no server, no network, no npm dependencies. --watch serves the same
+// page while you write, and is the only mode that runs a server.
+// ------------------------------------------------------------------
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { loadConfig, CLI, VERSION } from '../src/config.mjs';
+import { build } from '../src/build.mjs';
+import { init } from '../src/init.mjs';
+import { watch, DEFAULT_PORT } from '../src/watch.mjs';
+
+// Every option each mode accepts, and whether it takes a value. Anything else
+// is an error: a typo that silently does something else is worse than a stop.
+const COMMON = { '--help': false, '-h': false, '--version': false, '-v': false };
+const BUILD = {
+  ...COMMON, '--out': true, '--config': true, '--title': true, '--engine': true,
+  '--watch': false, '-w': false, '--port': true, '--no-open': false, '--refresh': false,
+};
+const INIT = { ...COMMON, '--docs': true, '--title': true, '--force': false };
+const COMMANDS = ['init'];
+
+const HELP = `lowkey-doc ${VERSION} — render a folder of Markdown into one self-contained page
+
+  ${CLI} [folder] [options]
+  ${CLI} init [folder] [--docs <dir>] [--title <name>] [--force]
+
+Options
+  folder             render this folder instead of the configured one
+  --out <dir>        where to write the page          (default .lowkey-doc)
+  --config <file>    use this config file             (default docs.config.json, searched upwards)
+  --title <name>     override the dashboard title
+  --engine <name>    default diagram layout: clean | mermaid
+  -w, --watch        serve on localhost and update the open page on every save
+  --port <n>         port for --watch                 (default ${DEFAULT_PORT}, or the next free one)
+  --no-open          build without launching a browser
+  --refresh          re-download mermaid, ELK and the font
+  -v, --version      print the version
+  -h, --help         this
+
+init
+  folder             the project to set up             (default: here; created if missing)
+  --docs <dir>       the documents folder              (default docs)
+  --title <name>     the dashboard title
+  --force            replace the Claude command and skills with this version's.
+                     An existing config is never replaced: --docs and --title edit it.
+`;
+
+const usage = (msg) => { throw new Error(msg + '\nSee: ' + CLI + ' --help'); };
+
+// edit distance, for "did you mean"
+function distance(a, b) {
+  const row = Array.from({ length: b.length + 1 }, (_, j) => j);
+  for (let i = 1; i <= a.length; i++) {
+    let prev = row[0]++;
+    for (let j = 1; j <= b.length; j++) {
+      const cur = row[j];
+      row[j] = Math.min(row[j] + 1, row[j - 1] + 1, prev + (a[i - 1] === b[j - 1] ? 0 : 1));
+      prev = cur;
+    }
+  }
+  return row[b.length];
+}
+const closest = (word, list) => {
+  const best = list.map((w) => [w, distance(word, w)]).sort((x, y) => x[1] - y[1])[0];
+  return best && best[1] <= Math.max(1, Math.floor(word.length / 3)) ? best[0] : null;
+};
+
+function parse(argv) {
+  const takesValue = new Set(Object.entries({ ...BUILD, ...INIT }).filter(([, v]) => v).map(([k]) => k));
+  const opts = {};
+  const args = [];
+  for (let i = 0; i < argv.length; i++) {
+    let a = argv[i], value;
+    if (!a.startsWith('-') || a === '-') { args.push(a); continue; }
+    if (a.includes('=')) [a, value] = [a.slice(0, a.indexOf('=')), a.slice(a.indexOf('=') + 1)];
+    if (takesValue.has(a)) {
+      if (value === undefined) {
+        value = argv[i + 1];
+        if (value === undefined || value.startsWith('-')) usage(a + ' needs a value.');
+        i++;
+      }
+      opts[a] = value;
+    } else {
+      opts[a] = true;
+    }
+  }
+
+  const mode = args[0] === 'init' ? 'init' : 'build';
+  if (mode === 'init') args.shift();
+  const known = mode === 'init' ? INIT : BUILD;
+  for (const o of Object.keys(opts)) {
+    if (o in known) continue;
+    if (mode === 'init' && o in BUILD) usage(o + ' does not apply to init.');
+    if (mode === 'build' && o in INIT) usage(o + ' only works with init: ' + CLI + ' init ' + o);
+    const near = closest(o, Object.keys(known));
+    usage('Unknown option ' + o + '.' + (near ? ' Did you mean ' + near + '?' : ''));
+  }
+  if (args.length > 1) usage('Expected at most one folder, got: ' + args.join(' '));
+  return { mode, folder: args[0] || null, opts };
+}
+
+async function main() {
+  const { mode, folder, opts } = parse(process.argv.slice(2));
+  if (opts['-h'] || opts['--help']) { console.log(HELP); return; }
+  if (opts['-v'] || opts['--version']) { console.log(VERSION); return; }
+
+  if (mode === 'init') {
+    const r = init(folder, { docs: opts['--docs'], title: opts['--title'], force: !!opts['--force'] });
+    console.log('lowkey-doc init  ' + r.root);
+    r.done.forEach((d) => console.log('  + ' + d));
+    r.skipped.forEach((s) => console.log('  · ' + s));
+    if (r.kept) console.log('\n  To update the Claude command and skills: ' + CLI + ' init --force');
+    console.log('\nRender it with:  ' + CLI);
+    return;
+  }
+
+  // a folder named here is checked here: "No such folder" is the clearest
+  // thing to say, and a mistyped command lands here too
+  let docsFolder = null;
+  if (folder) {
+    docsFolder = path.resolve(folder);
+    if (!fs.existsSync(docsFolder)) {
+      const near = closest(folder, COMMANDS);
+      throw new Error('No such folder: ' + folder + (near ? '\nDid you mean: ' + CLI + ' ' + near + '?' : ''));
+    }
+    if (!fs.statSync(docsFolder).isDirectory()) throw new Error('Not a folder: ' + folder);
+  }
+
+  const cfgArgs = {
+    folder: docsFolder,
+    out: opts['--out'] || null,
+    title: opts['--title'] || null,
+    configPath: opts['--config'] || null,
+    engine: opts['--engine'] || null,
+  };
+
+  if (opts['--watch'] || opts['-w']) {
+    const port = Number(opts['--port'] ?? DEFAULT_PORT);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+      usage('--port must be a port number, got: ' + opts['--port']);
+    }
+    await watch(cfgArgs, { port, open: !opts['--no-open'], refresh: !!opts['--refresh'] });
+    return;
+  }
+  if (opts['--port']) usage('--port only works with --watch.');
+
+  const cfg = loadConfig(cfgArgs);
+
+  await build(cfg, { open: !opts['--no-open'], refresh: !!opts['--refresh'] });
+}
+
+main().catch((err) => {
+  console.error(String(err && err.message || err));
+  process.exit(1);
+});

package/commands/docs.md

@@ -0,0 +1,38 @@
+---
+description: Render this project's documents into a dashboard and open it in the browser
+argument-hint: "[--watch] [--no-open] [--refresh] [--out <dir>] [--engine clean|mermaid]"
+allowed-tools: Bash(npx lowkey-doc:*)
+---
+
+Run the documentation dashboard builder:
+
+```bash
+npx lowkey-doc $ARGUMENTS
+```
+
+It reads the documents folder named in `docs.config.json` (or `docs/`) and writes a single
+self-contained page to `.lowkey-doc/index.html`, then opens it in the default browser.
+
+Report back briefly:
+
+- how many documents were rendered, and how many carry diagrams
+- the output path
+- anything the script printed that looks wrong: a document that failed to parse,
+  `mermaid: CDN fallback` (the diagram engine could not be cached locally, so the page will need a
+  network connection), `elk: unavailable` (flowcharts and ER diagrams will fall back to mermaid's
+  layout), or
+  `font: system fallback` (Inter could not be fetched, so the page falls back to a system typeface)
+- `checksum mismatch` anywhere: a download was not the exact file this version pins, so it was
+  refused. Say so plainly, and do not try to work around it by fetching the file another way
+
+Do not edit any document as part of this command — it only renders.
+
+Flags, if asked for:
+
+- `--no-open` build without launching the browser
+- `--refresh` re-download the pinned mermaid bundle, the ELK bundle and the Inter woff2
+- `--out <dir>` write the dashboard somewhere else
+- `--engine mermaid` fall back to mermaid's own layout everywhere
+- `--watch` serve the dashboard on localhost and update the open page on every save. It keeps
+  running until stopped, so start it in the background and report the address it prints
+- `--port <n>` the port for `--watch` (default 4747)

package/licenses/elkjs.txt

@@ -0,0 +1,263 @@
+# Eclipse Public License - v 2.0
+
+THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+PUBLIC LICENSE (“AGREEMENT”). ANY USE, REPRODUCTION OR DISTRIBUTION OF
+THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.
+
+## 1. DEFINITIONS
+
+“Contribution” means:
+
+-   a\) in the case of the initial Contributor, the initial content
+    Distributed under this Agreement, and
+-   b\) in the case of each subsequent Contributor:
+    -   i\) changes to the Program, and
+    -   ii\) additions to the Program;
+
+    where such changes and/or additions to the Program originate from
+    and are Distributed by that particular Contributor. A Contribution
+    “originates” from a Contributor if it was added to the Program by
+    such Contributor itself or anyone acting on such Contributor's
+    behalf. Contributions do not include changes or additions to the
+    Program that are not Modified Works.
+
+“Contributor” means any person or entity that Distributes the Program.
+
+“Licensed Patents” mean patent claims licensable by a Contributor which
+are necessarily infringed by the use or sale of its Contribution alone
+or when combined with the Program.
+
+“Program” means the Contributions Distributed in accordance with this
+Agreement.
+
+“Recipient” means anyone who receives the Program under this Agreement
+or any Secondary License (as applicable), including Contributors.
+
+“Derivative Works” shall mean any work, whether in Source Code or other
+form, that is based on (or derived from) the Program and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship.
+
+“Modified Works” shall mean any work in Source Code or other form that
+results from an addition to, deletion from, or modification of the
+contents of the Program, including, for purposes of clarity any new file
+in Source Code form that contains any contents of the Program. Modified
+Works shall not include works that contain only declarations,
+interfaces, types, classes, structures, or files of the Program solely
+in each case in order to link to, bind by name, or subclass the Program
+or Modified Works thereof.
+
+“Distribute” means the acts of a) distributing or b) making available in
+any manner that enables the transfer of a copy.
+
+“Source Code” means the form of a Program preferred for making
+modifications, including but not limited to software source code,
+documentation source, and configuration files.
+
+“Secondary License” means either the GNU General Public License, Version
+2.0, or any later versions of that license, including any exceptions or
+additional permissions as identified by the initial Contributor.
+
+## 2. GRANT OF RIGHTS
+
+-   a\) Subject to the terms of this Agreement, each Contributor hereby
+    grants Recipient a non-exclusive, worldwide, royalty-free copyright
+    license to reproduce, prepare Derivative Works of, publicly display,
+    publicly perform, Distribute and sublicense the Contribution of such
+    Contributor, if any, and such Derivative Works.
+-   b\) Subject to the terms of this Agreement, each Contributor hereby
+    grants Recipient a non-exclusive, worldwide, royalty-free patent license
+    under Licensed Patents to make, use, sell, offer to sell, import and
+    otherwise transfer the Contribution of such Contributor, if any, in
+    Source Code or other form. This patent license shall apply to the
+    combination of the Contribution and the Program if, at the time the
+    Contribution is added by the Contributor, such addition of the
+    Contribution causes such combination to be covered by the
+    Licensed Patents. The patent license shall not apply to any other
+    combinations which include the Contribution. No hardware per se is
+    licensed hereunder.
+-   c\) Recipient understands that although each Contributor grants the
+    licenses to its Contributions set forth herein, no assurances are
+    provided by any Contributor that the Program does not infringe the
+    patent or other intellectual property rights of any other entity. Each
+    Contributor disclaims any liability to Recipient for claims brought by
+    any other entity based on infringement of intellectual property rights
+    or otherwise. As a condition to exercising the rights and licenses
+    granted hereunder, each Recipient hereby assumes sole responsibility to
+    secure any other intellectual property rights needed, if any. For
+    example, if a third party patent license is required to allow Recipient
+    to Distribute the Program, it is Recipient's responsibility to acquire
+    that license before distributing the Program.
+-   d\) Each Contributor represents that to its knowledge it has sufficient
+    copyright rights in its Contribution, if any, to grant the copyright
+    license set forth in this Agreement.
+-   e\) Notwithstanding the terms of any Secondary License, no Contributor
+    makes additional grants to any Recipient (other than those set forth in
+    this Agreement) as a result of such Recipient's receipt of the Program
+    under the terms of a Secondary License (if permitted under the terms of
+    Section 3).
+
+## 3. REQUIREMENTS
+
+3.1 If a Contributor Distributes the Program in any form, then:
+
+-   a\) the Program must also be made available as Source Code, in accordance
+    with section 3.2, and the Contributor must accompany the Program with a
+    statement that the Source Code for the Program is available under this
+    Agreement, and informs Recipients how to obtain it in a reasonable
+    manner on or through a medium customarily used for software exchange;
+    and
+-   b\) the Contributor may Distribute the Program under a license different
+    than this Agreement, provided that such license:
+    -   i\) effectively disclaims on behalf of all other Contributors all
+        warranties and conditions, express and implied, including warranties or
+        conditions of title and non-infringement, and implied warranties or
+        conditions of merchantability and fitness for a particular purpose;
+    -   ii\) effectively excludes on behalf of all other Contributors all
+        liability for damages, including direct, indirect, special, incidental
+        and consequential damages, such as lost profits;
+    -   iii\) does not attempt to limit or alter the recipients' rights in the
+        Source Code under section 3.2; and
+    -   iv\) requires any subsequent distribution of the Program by any party to
+        be under a license that satisfies the requirements of this section 3.
+
+3.2 When the Program is Distributed as Source Code:
+
+-   a\) it must be made available under this Agreement, or if the Program (i)
+    is combined with other material in a separate file or files made
+    available under a Secondary License, and (ii) the initial Contributor
+    attached to the Source Code the notice described in Exhibit A of this
+    Agreement, then the Program may be made available under the terms of
+    such Secondary Licenses, and
+-   b\) a copy of this Agreement must be included with each copy of
+    the Program.
+
+3.3 Contributors may not remove or alter any copyright, patent,
+trademark, attribution notices, disclaimers of warranty, or limitations
+of liability (‘notices’) contained within the Program from any copy of
+the Program which they Distribute, provided that Contributors may add
+their own appropriate notices.
+
+## 4. COMMERCIAL DISTRIBUTION
+
+Commercial distributors of software may accept certain responsibilities
+with respect to end users, business partners and the like. While this
+license is intended to facilitate the commercial use of the Program, the
+Contributor who includes the Program in a commercial product offering
+should do so in a manner which does not create potential liability for
+other Contributors. Therefore, if a Contributor includes the Program in
+a commercial product offering, such Contributor (“Commercial
+Contributor”) hereby agrees to defend and indemnify every other
+Contributor (“Indemnified Contributor”) against any losses, damages and
+costs (collectively “Losses”) arising from claims, lawsuits and other
+legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such
+Commercial Contributor in connection with its distribution of the
+Program in a commercial product offering. The obligations in this
+section do not apply to any claims or Losses relating to any actual or
+alleged intellectual property infringement. In order to qualify, an
+Indemnified Contributor must: a) promptly notify the Commercial
+Contributor in writing of such claim, and b) allow the Commercial
+Contributor to control, and cooperate with the Commercial Contributor
+in, the defense and any related settlement negotiations. The Indemnified
+Contributor may participate in any such claim at its own expense.
+
+For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor's responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those
+performance claims and warranties, and if a court requires any other
+Contributor to pay any damages as a result, the Commercial Contributor
+must pay those damages.
+
+## 5. NO WARRANTY {#warranty}
+
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT
+PERMITTED BY APPLICABLE LAW, THE PROGRAM IS PROVIDED 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. Each Recipient is solely responsible for determining the
+appropriateness of using and distributing the Program and assumes all
+risks associated with its exercise of rights under this Agreement,
+including but not limited to the risks and costs of program errors,
+compliance with applicable laws, damage to or loss of data, programs or
+equipment, and unavailability or interruption of operations.
+
+## 6. DISCLAIMER OF LIABILITY {#disclaimer}
+
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT
+PERMITTED BY APPLICABLE LAW, NEITHER RECIPIENT NOR ANY CONTRIBUTORS
+SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST
+PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE
+EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+## 7. GENERAL
+
+If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further action
+by the parties hereto, such provision shall be reformed to the minimum
+extent necessary to make such provision valid and enforceable.
+
+If Recipient institutes patent litigation against any entity (including
+a cross-claim or counterclaim in a lawsuit) alleging that the Program
+itself (excluding combinations of the Program with other software or
+hardware) infringes such Recipient's patent(s), then such Recipient's
+rights granted under Section 2(b) shall terminate as of the date such
+litigation is filed.
+
+All Recipient's rights under this Agreement shall terminate if it fails
+to comply with any of the material terms or conditions of this Agreement
+and does not cure such failure in a reasonable period of time after
+becoming aware of such noncompliance. If all Recipient's rights under
+this Agreement terminate, Recipient agrees to cease use and distribution
+of the Program as soon as reasonably practicable. However, Recipient's
+obligations under this Agreement and any licenses granted by Recipient
+relating to the Program shall continue and survive.
+
+Everyone is permitted to copy and distribute copies of this Agreement,
+but in order to avoid inconsistency the Agreement is copyrighted and may
+only be modified in the following manner. The Agreement Steward reserves
+the right to publish new versions (including revisions) of this
+Agreement from time to time. No one other than the Agreement Steward has
+the right to modify this Agreement. The Eclipse Foundation is the
+initial Agreement Steward. The Eclipse Foundation may assign the
+responsibility to serve as the Agreement Steward to a suitable separate
+entity. Each new version of the Agreement will be given a distinguishing
+version number. The Program (including Contributions) may always be
+Distributed subject to the version of the Agreement under which it was
+received. In addition, after a new version of the Agreement is
+published, Contributor may elect to Distribute the Program (including
+its Contributions) under the new version.
+
+Except as expressly stated in Sections 2(a) and 2(b) above, Recipient
+receives no rights or licenses to the intellectual property of any
+Contributor under this Agreement, whether expressly, by implication,
+estoppel or otherwise. All rights in the Program not expressly granted
+under this Agreement are reserved. Nothing in this Agreement is intended
+to be enforceable by any entity that is not a Contributor or Recipient.
+No third-party beneficiary rights are created under this Agreement.
+
+## Exhibit A – Form of Secondary Licenses Notice {#exhibit-a}
+
+“This Source Code may also be made available under the following
+Secondary Licenses when the conditions for such availability set forth
+in the Eclipse Public License, v. 2.0 are satisfied: GNU General Public License v3.0 or later”
+
+> Simply including a copy of this Agreement, including this Exhibit A is
+> not sufficient to license the Source Code under Secondary Licenses.
+>
+> If it is not possible or desirable to put the notice in a particular
+> file, then You may include the notice in a location (such as a LICENSE
+> file in a relevant directory) where a recipient would be likely to
+> look for such a notice.
+>
+> You may add additional accurate notices of copyright ownership.

package/licenses/inter.txt

@@ -0,0 +1,93 @@
+Copyright 2016 The Inter Project Authors (https://github.com/rsms/inter) Inter-Italic[opsz,wght].ttf: Copyright 2016 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/licenses/mermaid.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 - 2022 Knut Sveidqvist
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 THE
+AUTHORS OR COPYRIGHT HOLDERS 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.