@the-inclusionist/engine 9.0.0 → 11.0.0

package/scripts/licences/third-party.mjs

@@ -0,0 +1,301 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+//
+// WHAT A DELIVERY OWES THE PEOPLE WHOSE HEAVY FILES IT CARRIES (ADR-0177 delivery of heavy files, ADR-0203 mirror).
+//
+// `inclusionist-heavy` copies third-party runtimes and models into a delivery's `heavy/` folder, and a copy handed to a school is
+// a distribution: Apache-2.0 §4(a) asks for the licence text to travel with it and §4(d) for the NOTICE attributions, MIT for its
+// copyright and permission notice, GPL-3.0 for its text and the Corresponding Source (§6). So every folder of `heavy/` that
+// receives a file also receives the `LICENSE` and `NOTICE` of the project it belongs to (and eSpeak NG's a `SOURCE`), and
+// `heavy/THIRD-PARTY-NOTICES.md` lists each project written, with where its texts sit.
+//
+// 📌 THE TEXTS LIVE HERE, beside this module, and ship in the npm package (`files`): the command runs from `node_modules` on a
+// school's build machine, which has neither the engine's `node_modules` nor the mirror. Each was COPIED from a local file, never
+// written from memory — `LICENCE_TEXTS` names the file and pins its sha256, and `tests/heavy-licences.node.test.js` holds both.
+//
+// 📌 A CATALOGUE ENTRY WITH NO GROUP HERE IS NOT WRITTEN: the delivery refuses a file whose licence nobody recorded, the same way
+// it refuses a file whose sha256 differs. Adding an entry to `app/js/platform/heavy-catalogue.ts` means adding its group here.
+//
+// ⚠️ UNVERIFIED is written where the project holds no evidence: most upstream copyright lines are not held locally (the mirror's
+// `LICENSE.md` files are statements the project wrote, not the upstream text; see `docs/CREDITS.md`).
+
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+
+const HERE = new URL('./', import.meta.url);
+
+// The eSpeak NG build the catalogue pins (`voz:runtime:fonemas`), made by `scripts/models/build-espeak-ng.ps1` (issue #192). The
+// catalogue's address names the same folder, and `tests/heavy-licences.node.test.js` holds the two together.
+const ESPEAK_NG_COMMIT = '530bf0abf4174dc9ca28dbacc11bd5e9ae6152cd';
+const ESPEAK_NG_FOLDER = 'espeak-ng-530bf0a';
+const ESPEAK_NG_MIRROR = `https://lfs-oinclusionista.jrocha.dev.br/${ESPEAK_NG_FOLDER}`;
+
+/**
+ * The licence texts, each copied byte for byte from a local file (sha256 of the copy, with CRLF read as LF).
+ * · Apache-2.0: the vosk-browser upstream text as the mirror holds it; its terms match, word for word, the Apache-2.0 text of
+ *   `node_modules/detect-libc/LICENSE` up to «END OF TERMS AND CONDITIONS» (the appendix, a how-to, is not in it).
+ * · MIT: the permission notice and disclaimer only — from «Permission is hereby granted» to the end — of
+ *   `node_modules/pixi.js/LICENSE`. The copyright line above it is each project's own, written per group below.
+ * · GPL-3.0: the licence file of the `espeak-ng` 1.0.2 npm package, the build the engine used before its own (the FSF's current
+ *   text; eSpeak NG's `COPYING` is the same licence in the FSF's earlier wording, with `http://` addresses).
+ */
+export const LICENCE_TEXTS = Object.freeze({
+  'Apache-2.0': { file: 'Apache-2.0.txt', sha256: 'bb618af833c817ab01c1564bd3ec75ba4b4f9cf30910a4a2168e30a674ee8cc6',
+    from: 'the-inclusionist-lfs/vosk-browser-dynamic-execution-0/LICENSE' },
+  MIT: { file: 'MIT.txt', sha256: '89807acf2309bd285f033404ee78581602f3cd9b819a16ac2f0e5f60ff4a473e',
+    from: 'node_modules/pixi.js/LICENSE (from «Permission is hereby granted» to the end)' },
+  'GPL-3.0': { file: 'GPL-3.0.txt', sha256: '3972dc9744f6499f0f9b2dbf76696f2ae7ad8af9b23dde66d6af86c9dfb36986',
+    from: 'node_modules/espeak-ng/LICENSE (npm espeak-ng 1.0.2)' },
+});
+
+/** Upstream NOTICE files, copied unchanged. */
+export const NOTICE_TEXTS = Object.freeze({
+  'vosk-browser': { file: 'vosk-browser.NOTICE.txt', sha256: '31dac6be41950e1c649686f51a1fe1b47c9cdcd993def80bd104f85df2badd5c',
+    from: 'the-inclusionist-lfs/vosk-browser-dynamic-execution-0/NOTICE' },
+});
+
+/**
+ * One group per upstream project. `ids` are catalogue id prefixes: an id belongs to a group when it equals one or continues it
+ * after a colon. `copyright` holds lines as a local file states them; `copyrightUnverified` says why there is none.
+ */
+export const THIRD_PARTY = Object.freeze([
+  {
+    key: 'mediapipe-tasks-vision',
+    ids: ['visao'],
+    project: 'MediaPipe tasks-vision (Google): the runtime and the Face Landmarker, Gesture Recognizer and Hand Landmarker models',
+    version: '@mediapipe/tasks-vision 1.0.1; models float16, version 1',
+    spdx: 'Apache-2.0',
+    licence: 'Apache-2.0',
+    copyright: [],
+    copyrightUnverified: 'the runtime files carry no licence header, the .task bundles carry no licence file, and the package is not installed where this was written',
+    notice: [
+      'Obtained unchanged from https://cdn.jsdelivr.net/npm/@mediapipe/tasks-vision@1.0.1 (runtime) and https://storage.googleapis.com/mediapipe-models (models).',
+      'Licence as stated by the project\'s mirror (the-inclusionist-lfs/mediapipe-tasks-vision-1.0.1/LICENSE.md) and ADR-0203\'s erratum.',
+      'UNVERIFIED: the hand and gesture model cards were not read (engine issue #192), and whether upstream publishes a NOTICE file.',
+    ],
+  },
+  {
+    key: 'espeak-ng',
+    ids: ['voz:runtime:fonemas'],
+    project: 'eSpeak NG, built for the browser (WebAssembly) by The Inclusionist',
+    version: `eSpeak NG commit ${ESPEAK_NG_COMMIT} (master of 2023-09-27, between the releases 1.51 and 1.52.0), Emscripten 3.1.49`,
+    spdx: 'GPL-3.0-or-later',
+    licence: 'GPL-3.0',
+    copyright: [
+      'Copyright (C) 2005 to 2007 by Jonathan Duddington', 'Copyright (C) 2005 to 2011 by Jonathan Duddington',
+      'Copyright (C) 2005 to 2013 by Jonathan Duddington', 'Copyright (C) 2005 to 2014 by Jonathan Duddington',
+      'Copyright (C) 2005 to 2015 by Jonathan Duddington', 'Copyright (C) 2006 to 2013 by Jonathan Duddington',
+      'Copyright (C) 2012-2018 Reece H. Dunn', 'Copyright (C) 2012-2018, 2021 Reece H. Dunn', 'Copyright (C) 2013-2016 Reece H. Dunn',
+      'Copyright (C) 2013-2017 Reece H. Dunn', 'Copyright (C) 2015-2016 Reece H. Dunn', 'Copyright (C) 2015-2016, 2020 Reece H. Dunn',
+      'Copyright (C) 2015-2017 Reece H. Dunn', 'Copyright (C) 2016 Reece H. Dunn', 'Copyright (C) 2017 Reece H. Dunn',
+      'Copyright (C) 2017-2018 Reece H. Dunn', 'Copyright (C) 2018 Juho Hiltunen', 'Copyright (C) 2021 Juho Hiltunen',
+      'Copyright (C) 2022 Juho Hiltunen', 'Copyright (C) 2022 Ulrich Müller <ulm@gentoo.org>',
+    ],
+    copyrightFrom: 'the headers of the C files compiled into the binary at that commit — src/espeak-ng.c, the libespeak-ng files the build compiles and src/ucd-tools/src/*.c — each distinct line as written',
+    notice: [
+      `CHANGED by The Inclusionist: the eSpeak NG command-line program compiled to WebAssembly from commit ${ESPEAK_NG_COMMIT} of https://github.com/espeak-ng/espeak-ng.git, unchanged, with the phoneme data and the pt, es, en, de and fr dictionaries embedded, and linked so that it never evaluates text as code (-s DYNAMIC_EXECUTION=0). Recipe: the engine's scripts/models/build-espeak-ng.ps1.`,
+      'The binary also contains ucd-tools (GPL-3.0-or-later) with tables generated from the Unicode Character Database (the Unicode licence, COPYING.UCD in the source), and the Emscripten runtime and musl (MIT).',
+      'Where its Corresponding Source is: SOURCE, beside this file.',
+    ],
+    source: [
+      'eSpeak NG in WebAssembly: where the Corresponding Source of the files in this folder is',
+      '',
+      'The files here, espeak-ng.js and espeak-ng.wasm, are eSpeak NG built for the browser by The Inclusionist. They are licensed',
+      'under the GNU General Public License, version 3 or later: the full text is LICENSE, beside this file.',
+      '',
+      'Their Corresponding Source (GPL-3.0, section 6) is:',
+      `- eSpeak NG at commit ${ESPEAK_NG_COMMIT}, unchanged: https://github.com/espeak-ng/espeak-ng.git;`,
+      '- the build recipe, scripts/models/build-espeak-ng.ps1 in The Inclusionist engine, which pins that commit, the Emscripten',
+      '  toolchain (the emscripten/emsdk 3.1.49 image, by digest), the data it embeds and every flag. Run as it is, it writes these',
+      '  two files byte for byte: the build checks each against the sha256 in the engine\'s heavy-file catalogue before writing it.',
+      '',
+      'A copy of both is published beside the build, in',
+      `${ESPEAK_NG_MIRROR}/corresponding-source/ :`,
+      `the source at that commit (${ESPEAK_NG_FOLDER}.tar.gz, made with git archive) and the recipe (build-espeak-ng.ps1).`,
+    ],
+  },
+  {
+    key: 'onnxruntime-web',
+    ids: ['voz:runtime:onnx'],
+    project: 'ONNX Runtime Web (Microsoft)',
+    version: 'onnxruntime-web 1.27.0',
+    spdx: 'MIT',
+    licence: 'MIT',
+    copyright: ['Copyright (c) Microsoft Corporation. All rights reserved.'],
+    copyrightFrom: 'the header of dist/ort.webgpu.bundle.min.mjs',
+    notice: [
+      'Three files of the npm package onnxruntime-web 1.27.0, unchanged (https://cdn.jsdelivr.net/npm/onnxruntime-web@1.27.0).',
+      'The package declares MIT (package.json "license") and ships no licence file; the copyright line is the bundle\'s own header.',
+      'UNVERIFIED: the third-party notices of the libraries compiled into the .wasm are not held locally.',
+    ],
+  },
+  {
+    key: 'kokoro',
+    ids: ['voz:kokoro'],
+    project: 'Kokoro-82M (hexgrad), ONNX export by onnx-community',
+    version: 'v1.0 (onnx-community/Kokoro-82M-v1.0-ONNX)',
+    spdx: 'Apache-2.0',
+    licence: 'Apache-2.0',
+    copyright: [],
+    copyrightUnverified: 'no copyright line of hexgrad or onnx-community is held locally',
+    notice: [
+      'Obtained unchanged from https://huggingface.co/onnx-community/Kokoro-82M-v1.0-ONNX: the fp32 model, the tokenizer and one style table per voice.',
+      'Kokoro-82M (hexgrad), Apache-2.0. Its model card credits training audio under CC BY licences: Koniwa (CC BY 3.0) and SIWIS (CC BY 4.0).',
+    ],
+  },
+  {
+    key: 'whisper-small',
+    ids: ['reading:pt'],
+    project: 'Whisper small (OpenAI), exported to ONNX by The Inclusionist',
+    version: 'openai/whisper-small',
+    spdx: 'Apache-2.0',
+    licence: 'Apache-2.0',
+    copyright: [],
+    copyrightUnverified: 'no copyright line of OpenAI for this model is held locally',
+    notice: [
+      'Weights: https://huggingface.co/openai/whisper-small, Apache-2.0.',
+      'CHANGED by The Inclusionist: exported to ONNX and quantized to 8 bits (encoder, decoder, decoder with past); the tokenizer, configuration and mel filterbank are copied unchanged. Recipe: the engine\'s scripts/models/export-whisper-small.py.',
+    ],
+  },
+  {
+    key: 'moonshine-streaming-small-en',
+    ids: ['reading:en'],
+    project: 'Moonshine streaming small (Useful Sensors / Moonshine AI), ONNX export by Workmind',
+    version: 'Workmind/moonshine-streaming-small-ONNX (base model UsefulSensors/moonshine-streaming-small)',
+    spdx: 'MIT',
+    licence: 'MIT',
+    copyright: [],
+    copyrightUnverified: 'the export declares `license: mit`, but no copyright line of Useful Sensors, Moonshine AI or Workmind is held locally',
+    notice: [
+      'Obtained unchanged from https://huggingface.co/Workmind/moonshine-streaming-small-ONNX.',
+    ],
+  },
+  {
+    key: 'moonshine-streaming-small-es',
+    ids: ['reading:es'],
+    project: 'Moonshine streaming small es (Moonshine AI / Useful Sensors), exported to ONNX by The Inclusionist',
+    version: 'moonshine-ai/moonshine-streaming-small-es, revision 8cb0974f29ca24d6b645518c430efc8c57cd0073',
+    spdx: 'MIT',
+    licence: 'MIT',
+    copyright: [],
+    copyrightUnverified: 'the model declares `license: mit`, but no copyright line of Moonshine AI or Useful Sensors is held locally',
+    notice: [
+      'Weights: https://huggingface.co/moonshine-ai/moonshine-streaming-small-es at the revision above.',
+      'CHANGED by The Inclusionist: exported to ONNX (encoder fp32, decoders quantized to 8 bits); the tokenizer and configuration are copied unchanged. Recipe: the engine\'s scripts/models/export-moonshine-streaming-es.py.',
+    ],
+  },
+  {
+    key: 'vosk-browser',
+    ids: ['commands:runtime'],
+    project: 'Vosk for the browser: vosk-browser, vosk-api and Kaldi, built by The Inclusionist',
+    version: 'lichess-org/vosk-browser 50a6347 with alphacep/vosk-api d714dff',
+    spdx: 'Apache-2.0',
+    licence: 'Apache-2.0',
+    copyright: ['Copyright 2020-2022 Ciaran O\'Reilly', 'Copyright 2020, Denis Treskunov', 'Copyright 2019-2022 Alpha Cephei Inc. All Rights Reserved.'],
+    copyrightFrom: 'the upstream vosk-browser NOTICE',
+    upstreamNotice: 'vosk-browser',
+    notice: [
+      'CHANGED by The Inclusionist: built from the sources above with one added link flag, -s DYNAMIC_EXECUTION=0, so the runtime runs under a Content-Security-Policy without \'unsafe-eval\'. Recipe and patch: the engine\'s scripts/models/build-vosk-browser.ps1 and scripts/models/vosk-browser-dynamic-execution.patch.',
+      'The binary also contains Kaldi, OpenFst, CLAPACK (BSD-3-Clause), clapack-wasm, zlib (Zlib), libarchive (BSD-2-Clause) and Emscripten and musl (MIT); each one\'s notice is in the upstream NOTICE above.',
+    ],
+  },
+  {
+    key: 'vosk-models',
+    ids: ['commands:model'],
+    project: 'Vosk small models (Alpha Cephei)',
+    version: 'vosk-model-small-pt-0.3, vosk-model-small-en-us-0.15, vosk-model-small-es-0.42',
+    spdx: 'Apache-2.0',
+    licence: 'Apache-2.0',
+    copyright: ['Copyright 2020 Alpha Cephei Inc (vosk-model-small-en-us-0.15)', 'Copyright 2022-2050 AC Technologies LLC (vosk-model-small-es-0.42)'],
+    copyrightFrom: 'each archive\'s README; vosk-model-small-pt-0.3\'s states none',
+    notice: [
+      'From https://alphacephei.com/vosk/models, which states Apache-2.0; the archives themselves state no licence.',
+      'CHANGED by The Inclusionist: repacked unchanged from the upstream zips into the .tar.gz vosk-browser loads (the engine\'s scripts/models/repack-vosk-models.py).',
+    ],
+  },
+]);
+
+/** The group an id belongs to, or `null`. */
+export function groupOf(id, groups = THIRD_PARTY) {
+  return groups.find((g) => g.ids.some((p) => id === p || id.startsWith(`${p}:`))) ?? null;
+}
+
+const readStored = (file) => readFileSync(new URL(file, HERE), 'utf8');
+
+/** The files that sit beside a group's heavy files: `LICENSE`, `NOTICE`, and `SOURCE` where the group has one. */
+export function licenceFilesFor(group, read = readStored) {
+  const text = read(LICENCE_TEXTS[group.licence].file);
+  const copyright = group.copyright.length ? group.copyright : [`Copyright: UNVERIFIED — ${group.copyrightUnverified}.`];
+  const licence = group.licence === 'MIT' ? `MIT License\n\n${copyright.join('\n')}\n\n${text}` : text;
+  const own = [
+    `${group.project}`,
+    `${group.version}`,
+    `Licence: ${group.spdx}. The full text is LICENSE, beside this file.`,
+    ...(group.copyright.length ? [`Copyright (source: ${group.copyrightFrom}):`, ...group.copyright.map((c) => `  ${c}`)] : copyright),
+    '',
+    ...group.notice,
+  ].join('\n');
+  const notice = group.upstreamNotice
+    ? `${read(NOTICE_TEXTS[group.upstreamNotice].file).trimEnd()}\n\n---\n\nAddendum by The Inclusionist, which distributes this build:\n\n${own}\n`
+    : `${own}\n`;
+  const files = { LICENSE: licence, NOTICE: notice };
+  if (group.source) files.SOURCE = `${group.source.join('\n')}\n`;
+  return files;
+}
+
+/** `heavy/THIRD-PARTY-NOTICES.md`: each project in this delivery, its licence, its copyright, and where its texts sit. */
+export function thirdPartyNotices(written) {
+  const lines = [
+    '# Third-party notices',
+    '',
+    'The files under `heavy/` are not The Inclusionist\'s: each belongs to the project listed below and is distributed under that',
+    'project\'s licence. Every folder that holds one of them also holds the project\'s `LICENSE` and `NOTICE`.',
+    '',
+  ];
+  for (const { group, folders } of written) {
+    lines.push(`## ${group.project}`, '');
+    lines.push(`- **Version:** ${group.version}`);
+    lines.push(`- **Licence (SPDX):** \`${group.spdx}\``);
+    if (group.copyright.length) lines.push(`- **Copyright** (source: ${group.copyrightFrom}): ${group.copyright.join(' · ')}`);
+    else lines.push(`- **Copyright:** UNVERIFIED — ${group.copyrightUnverified}.`);
+    lines.push('- **Licence text and notices in this delivery:**');
+    for (const f of folders) {
+      const names = ['LICENSE', 'NOTICE', ...(group.source ? ['SOURCE'] : [])];
+      lines.push(`  - ${names.map((n) => `\`${f}/${n}\``).join(', ')}`);
+    }
+    lines.push('');
+  }
+  return `${lines.join('\n').trimEnd()}\n`;
+}
+
+/**
+ * Writes the licence files beside every heavy file present in the delivery, and `heavy/THIRD-PARTY-NOTICES.md`.
+ * `present` is `[{ id, path }]`, `path` being the delivery path (`heavy/<host><path>`). Throws when a file has no group, or when
+ * two groups would write the same folder — one `LICENSE` cannot speak for two projects.
+ */
+export function writeLicences({ destination, present, groups = THIRD_PARTY, read = readStored }) {
+  const byGroup = new Map();
+  const owner = new Map();
+  for (const { id, path } of present) {
+    const group = groupOf(id, groups);
+    if (!group) throw new Error(`no licence recorded for ${id} in scripts/licences/third-party.mjs`);
+    const folder = dirname(path).replaceAll('\\', '/');
+    const other = owner.get(folder);
+    if (other && other !== group) throw new Error(`${folder} would hold the licence of both ${other.key} and ${group.key}`);
+    owner.set(folder, group);
+    if (!byGroup.has(group)) byGroup.set(group, new Set());
+    byGroup.get(group).add(folder);
+  }
+  const written = [];
+  for (const group of groups) {
+    if (!byGroup.has(group)) continue;
+    const files = licenceFilesFor(group, read);
+    const folders = [...byGroup.get(group)].sort();
+    for (const folder of folders) {
+      mkdirSync(join(destination, folder), { recursive: true });
+      for (const [name, text] of Object.entries(files)) writeFileSync(join(destination, folder, name), text);
+    }
+    written.push({ group, folders: folders.map((f) => f.replace(/^heavy\//, '')) });
+  }
+  if (written.length) writeFileSync(join(destination, 'heavy', 'THIRD-PARTY-NOTICES.md'), thirdPartyNotices(written));
+  return written.map(({ group, folders }) => ({ key: group.key, folders }));
+}

package/scripts/licences/vosk-browser.NOTICE.txt

@@ -0,0 +1,268 @@
+Vosk-Browser
+Copyright 2020-2022 Ciaran O'Reilly
+
+The Initial Developer of the the WASM bindings
+(https://github.com/dtreskunov/tiny-kaldi) for the VOSK API is Denis
+Treskunov (https://github.com/dtreskunov).
+Copyright 2020, Denis Treskunov
+
+The Developer of the VOSK API (https://github.com/alphacep/vosk-api) is
+Alpha Cephei Inc (https://alphacephei.com/en/).
+Copyright 2019-2022 Alpha Cephei Inc. All Rights Reserved.
+
+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
+
+THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
+WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
+MERCHANTABLITY OR NON-INFRINGEMENT.
+See the Apache 2 License for the specific language governing permissions and
+limitations under the License.
+
+---
+
+kaldi:
+
+Each of the files comprising Kaldi v1.0 have been separately licensed by
+their respective author(s) under the terms of the Apache License v 2.0 (set
+forth below).  The source code headers for each file specifies the individual
+authors and source material for that file as well the corresponding copyright
+notice.  For reference purposes only: A cumulative list of all individual
+contributors and original source material as well as the full text of the Apache
+License v 2.0 are set forth below.
+
+Individual Contributors (in alphabetical order)
+
+      Mohit Agarwal
+      Tanel Alumae
+      Gilles Boulianne
+      Lukas Burget
+      Dogan Can
+      Guoguo Chen
+      Gaofeng Cheng
+      Cisco Corporation
+      Pavel Denisov
+      Ilya Edrenkin
+      Ewald Enzinger
+      Joachim Fainberg
+      Daniel Galvez
+      Pegah Ghahremani
+      Arnab Ghoshal
+      Ondrej Glembek
+      Go Vivace Inc.
+      Allen Guo
+      Hossein Hadian
+      Lv Hang
+      Mirko Hannemann
+      Hendy Irawan
+      Navdeep Jaitly
+      Johns Hopkins University
+      Shiyin Kang
+      Kirill Katsnelson
+      Tom Ko
+      Danijel Korzinek
+      Gaurav Kumar
+      Ke Li
+      Matthew Maciejewski
+      Vimal Manohar
+      Yajie Miao
+      Microsoft Corporation
+      Petr Motlicek
+      Xingyu Na
+      Vincent Nguyen
+      Lucas Ondel
+      Vassil Panayotov
+      Vijayaditya Peddinti
+      Phonexia s.r.o.
+      Ondrej Platek
+      Daniel Povey
+      Yanmin Qian
+      Ariya Rastrow
+      Saarland University
+      Omid Sadjadi
+      Petr Schwarz
+      Yiwen Shao
+      Nickolay V. Shmyrev
+      Jan Silovsky
+      Eduardo Silva
+      Peter Smit
+      David Snyder
+      Alexander Solovets
+      Georg Stemmer
+      Pawel Swietojanski
+      Jan "Yenda" Trmal
+      Albert Vernon
+      Karel Vesely
+      Yiming Wang
+      Shinji Watanabe
+      Minhua Wu
+      Haihua Xu
+      Hainan Xu
+      Xiaohui Zhang
+
+Other Source Material
+
+    This project includes a port and modification of materials from JAMA: A Java
+  Matrix Package under the following notice: "This software is a cooperative
+  product of The MathWorks and the National Institute of Standards and Technology
+  (NIST) which has been released to the public domain." This notice and the
+  original code is available at http://math.nist.gov/javanumerics/jama/
+
+   This project includes a modified version of code published in Malvar, H.,
+  "Signal processing with lapped transforms," Artech House, Inc., 1992.  The
+  current copyright holder, Henrique S. Malvar, has given his permission for the
+  release of this modified version under the Apache License 2.0.
+
+  This project includes material from the OpenFST Library v1.2.7 available at
+  http://www.openfst.org and released under the Apache License v. 2.0.
+
+  [OpenFst COPYING file begins here]
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use these files 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.
+
+    Copyright 2005-2010 Google, Inc.
+
+  [OpenFst COPYING file ends here]
+
+---
+
+CLAPACK:
+
+Copyright (c) 1992-2008 The University of Tennessee.  All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+- Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer. 
+
+- Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer listed
+  in this license in the documentation and/or other materials
+  provided with the distribution.
+
+- Neither the name of the copyright holders nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT  
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 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
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
+
+---
+
+clapack-wasm:
+
+Copyright [2020] Mathieu Hu, Laurent Pierron, Emmanuel Vincent, Denis Jouvet (INRIA)
+
+   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.
+
+---
+
+zlib:
+
+Copyright (C) 1995-2017 Jean-loup Gailly and Mark Adler
+
+This software is provided 'as-is', without any express or implied
+warranty.  In no event will the authors be held liable for any damages
+arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose,
+including commercial applications, and to alter it and redistribute it
+freely, subject to the following restrictions:
+
+1. The origin of this software must not be misrepresented; you must not
+   claim that you wrote the original software. If you use this software
+   in a product, an acknowledgment in the product documentation would be
+   appreciated but is not required.
+2. Altered source versions must be plainly marked as such, and must not be
+   misrepresented as being the original software.
+3. This notice may not be removed or altered from any source distribution.
+
+---
+
+libarchive:
+
+Copyright (c) 2003-2020 Tim Kientzle et al.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer
+   in this position and unchanged.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 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 OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---
+
+emscripten and musl:
+
+Copyright (c) 2010-2014 Emscripten authors, see AUTHORS file.
+Copyright © 2005-2014 Rich Felker, et al.
+
+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/dist-pkg/core/anel.d.ts

@@ -1,17 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-/**
- * ANDA UM PASSO NUM ANEL — passar do último volta ao primeiro, e antes do primeiro está o último.
- *
- * Era `clampIndex`, que prendia nas pontas "porque o original nunca faz wrap em lista de itens". O ADR-0044
- * derrubou isso, e o motivo é de uso, não de gosto: com UM MENU POR TELA, toda lista pode ser um anel, e o
- * item mais indesejado (`quit`) fica a UMA tecla do mais urgente (`resume`) sem estar perto dele. Quem não
- * enxerga não varre a lista à procura do fim — ela pergunta "e antes do primeiro?" e recebe uma resposta.
- *
- * A XAG 106 permite o anel exatamente para menu LINEAR, e o proíbe para grade 2-D de blocos: ali "voltar ao
- * primeiro" não tem significado espacial.
- *
- * ⚠️ NAVEGAR LISTA É ANEL; AJUSTAR VALOR É LIMITE. `selectStep` e `rangeStep` (em ui/menu-nav) continuam
- * presos nas pontas, e a diferença é real: passar do volume máximo para o mínimo com uma tecla é um susto,
- * não uma conveniência — e num jogo com pistas de áudio para cegueira, um susto de volume é dano.
- */
-export declare function passoNoAnel(len: number, idx: number, delta: number): number;