@datagrok/bio 2.27.7 → 2.27.9

package/CLAUDE.md

@@ -46,17 +46,18 @@ Other packages depend on these implementations: **Helm**, **Peptides**, **Biostr
 | `Bio \| Analyze \| Activity Cliffs...` | `activityCliffs` | Detects sequence pairs with similar structure but significant activity difference |
 | `Bio \| Analyze \| Sequence Space...` | `sequenceSpaceTopMenu` | UMAP/tSNE 2D projection of sequences by pairwise distance |
 | `Bio \| Analyze \| MSA...` | `multipleSequenceAlignmentDialog` | Multiple sequence alignment via kalign (WASM) for canonical sequences, or dynamically discovered engines (e.g. PepSeA Docker) for non-canonical |
+| `Bio \| Analyze \| Compare sequences...` | `compareSequencesTopMenu` | Pairs two macromolecule columns and produces an alignment-difference column |
 | `Bio \| Analyze \| Composition` | `compositionAnalysis` | Docks a WebLogo viewer for sequence composition |
 | `Bio \| Transform \| Convert Sequence Notation...` | `convertDialog` | FASTA ↔ SEPARATOR ↔ HELM ↔ BILN conversion |
 | `Bio \| Transform \| To Atomic Level...` | `toAtomicLevel` | Converts sequences to V3000 molfiles |
 | `Bio \| Transform \| Split to Monomers...` | `splitToMonomersTopMenu` | Splits aligned sequences into per-position columns |
 | `Bio \| Transform \| Molecules to HELM...` | `moleculesToHelmTopMenu` | Converts peptide molecules to HELM via Python script |
-| `Bio \| Calculate \| Get Region...` | `getRegionTopMenu` | Extracts sub-region from macromolecule column |
+| `Bio \| Calculate \| Extract Region...` | `getRegionTopMenu` | Extracts sub-region from macromolecule column |
 | `Bio \| Calculate \| Identity...` | `sequenceIdentityScoring` | Fraction of matching monomers vs reference |
 | `Bio \| Calculate \| Similarity...` | `sequenceSimilarityScoring` | Sum of monomer fingerprint similarities vs reference |
 | `Bio \| Search \| Similarity Search` | `similaritySearchTopMenu` | K-nearest neighbor sequence search |
 | `Bio \| Search \| Diversity Search` | `diversitySearchTopMenu` | Maximally diverse subset selection |
-| `Bio \| Search \| Subsequence Search...` | `SubsequenceSearchTopMenu` | Substructure filter (regex or RDKit) |
+| `Bio \| Search \| Subsequence Search ...` | `SubsequenceSearchTopMenu` | Substructure filter (regex or RDKit) |
 | `Bio \| Manage \| Monomer Libraries` | `manageLibrariesView` | Full monomer library management UI |
 | `Bio \| Manage \| Monomers` | `manageMonomersView` | Individual monomer CRUD editor |
 | `Bio \| Manage \| Match with Monomer Library...` | `matchWithMonomerLibrary` | Matches molecules to library monomers |
@@ -88,6 +89,21 @@ Other packages depend on these implementations: **Helm**, **Peptides**, **Biostr
 - `importFasta` — opens `.fasta`, `.fna`, `.fa`, etc. files
 - `importBam` — stub for BAM files
 
+**Property Panels (additional, undocumented above):**
+- `Monomer` info panel — `getMonomerInfoWidget()` from `src/widgets/monomer-info-widget.ts` (renders monomer details for `Monomer` semtype cells)
+- `Bioinformatics | Manage Monomer Libraries` — link/widget pair surfaced as a column-level panel and as `Manage Monomer Libraries` (panel) for in-place library management
+
+**Apps & extra registrations:**
+- `Monomer Manager Tree Browser` — tree-grouped monomer browser app
+- `Monomer Collections` — application for managing curated monomer-set collections (backed by `src/utils/monomer-lib/monomer-collections-view.ts` + `monomer-collection-handler.ts`)
+- `Molecule to HELM Single` — single-molecule peptide → HELM converter (single-row companion to `Molecules to HELM...`)
+- `SDF to JSON Library` — converts an SDF table into a HELM JSON monomer library
+- `seqIdentity` — column-vs-reference identity score function
+
+**Transforms (DG.Func internal API for analysis pipelines):**
+- `seqActivityCliffsTransform`, `seqActivityCliffsInitFunction` — replay-friendly wrappers around Activity Cliffs
+- `sequenceSpaceTransform` — replay wrapper around Sequence Space
+
 **Other:**
 - `bioSubstructureFilter` — macromolecule substructure filter
 - `saveAsFasta` — file exporter (As FASTA...)
@@ -152,6 +168,7 @@ Key methods: `detectSeparator()`, `detectAlphabet()`, `getAlphabetSimilarity()`,
 | `representations.ts` | `getMacromoleculeColumnPropertyPanel()` — UI for renderer settings: font size, max monomer length, gap length, color coding scheme, reference sequence, multiline mode |
 | `to-atomic-level-widget.ts` | `toAtomicLevelSingle()` (seq→molfile), `toAtomicLevelWidget()` (2D molecule drawing), `molecular3DStructureWidget()` (3D NGL viewer) |
 | `sequence-scrolling-widget.ts` | `handleSequenceHeaderRendering()` — MSA column header with WebLogo + conservation tracks, viewport-aware lazy caching (50-position chunks), click to dock position statistics viewer |
+| `monomer-info-widget.ts` | `getMonomerInfoWidget()` — info-panel widget for `Monomer` semtype cells; renders the monomer card with structure, library origin and R-group info |
 | `package-settings-editor-widget.ts` | `PackageSettingsEditorWidget` — Bio package global settings form |
 
 ### Utilities (`src/utils/`)
@@ -165,13 +182,18 @@ Key methods: `detectSeparator()`, `detectAlphabet()`, `getAlphabetSimilarity()`,
 | `monomer-cell-renderer-base.ts` | `MonomerCellRendererBase` — abstract base that async-loads monomer library, invalidates grid on lib change |
 | `convert.ts` | `convert()` — dialog for notation conversion (FASTA ↔ SEPARATOR ↔ HELM ↔ BILN). `convertDo()` performs actual conversion via `ISeqHandler`. |
 | `get-region.ts` | `getRegionDo()` — extracts positional sub-region from macromolecule column via `ISeqHandler.getRegion()` |
-| `split-to-monomers.ts` | `splitToMonomersUI()` — splits aligned sequences into per-position `Monomer` columns using `joinDataFrames` |
+| `get-region-func-editor.ts` | Custom function-editor UI for the `getRegion` DG function (allows interactive position-range selection) |
+| `split-to-monomers.ts` | `splitToMonomersUI()` — splits aligned sequences into per-position `Monomer` columns using `splitAlignedSequences` |
 | `sequence-to-mol.ts` | `sequenceToMolfile()` — converts macromolecule column to atomic-level molfile column (linear via `_toAtomicLevel`, nonlinear via HELM converter) |
 | `calculate-scores.ts` | `calculateScoresWithEmptyValues()` — wraps `calculateIdentityScoring`/`calculateChemSimilarityScoring` from bio lib, handles empty values |
 | `save-as-fasta.ts` | `saveAsFastaUI()` — dialog + download for FASTA export. `buildFasta()` builds the string. |
 | `biln.ts` | `BilnNotationProvider` — notation provider for BILN sequences with splitter, HELM converter, cell renderer back-end |
+| `compare-sequences.ts` | Backs `Bio | Analyze | Compare sequences...` — pairs two macromolecule columns (column picker + reference column), produces an alignment-difference column rendered with `MacromoleculeDifferenceCellRenderer` |
 | `context-menu.ts` | `addCopyMenuUI()` — adds "Copy as FASTA/SEPARATOR/HELM/BILN" to cell context menu |
 | `check-input-column.ts` | `checkInputColumnUI()` / `checkInputColumn()` — validates column has `Macromolecule` semtype |
+| `detect-macromolecule-probe.ts` | Adjustable detector probe — exposes the macromolecule detector under a tunable threshold for development/testing |
+| `macromolecule-column-widget.ts` | Column-level widget (panel) summarising a macromolecule column (notation, alphabet, monomer histogram, etc.) |
+| `sequence-column-input.ts` | Wraps `createSequenceColumnInput()` from the bio library into a Bio-package-friendly DG input variant |
 | `ui-utils.ts` | `getMacromoleculeColumns()`, `safeReplace()`, `setGridColWidth()` |
 | `types.ts` | Shared types: `DfPair`, `ActivityCliffsData`, `MsaOptions` (kalign/pepsea params), `AARDict` |
 | `constants.ts` | Constants: `SEM_TYPES`, `PEPSEA_VERSION`, `DEFAULT_MSA_PARAMETERS`, amino acid groupings |
@@ -225,7 +247,20 @@ See `pepseaMsa()` in `package.ts` and `alignWithPepsea()` in `pepsea.ts` for a c
 | `utils/antibody-numbering/immunum-glue.js` | Browser/worker-safe port of `node_modules/immunum/immunum.js`. Byte-identical wasm-bindgen glue — only the Node-only `require('fs').readFileSync` top-level loader is replaced with an explicit `initImmunum(bytes)` entry point. |
 | `utils/antibody-numbering/types.ts` | `ImmunumNumberingRow`, `ImmunumWorkerRequest`/`ImmunumWorkerResponse`, `IMMUNUM_SCHEMES`. |
 
-**Expected output shape (matches antpack reference script `scripts/number_antibody.py`):**
+#### Sequence Annotations & Liabilities (`utils/annotations/`)
+
+| File | Purpose |
+|---|---|
+| `annotation-manager.ts` | `AnnotationManager` — model layer. Owns the per-column annotation list, persists to/from the column's `.annotations` tag (JSON `SeqAnnotation[]`), exposes add/update/remove + change observable for UI re-renders |
+| `annotation-manager-ui.ts` | `showAnnotationManagerDialog()` — UI for viewing/editing the annotations on a macromolecule column (region, motif, liability entries) |
+| `annotation-actions.ts` | Toolbar/context-menu actions that hook annotation creation off cell selection or position ranges |
+| `liability-scanner.ts` | `scanLiabilitiesOnColumn()` — scans macromolecule sequences for sequence-liability motifs (deamidation, oxidation, glycosylation, etc.); records hits as `SeqAnnotation`s with `LiabilitySeverity` |
+| `liability-scanner-ui.ts` | `showLiabilityScannerDialog()` — backs `Bio | Annotate | Scan Liabilities...`. Picks rule sets and writes results back via `AnnotationManager` |
+| `numbering-ui.ts` | (described above under Antibody Numbering) |
+
+Annotations rendered in the grid are drawn by `AnnotationRenderer` (`@datagrok-libraries/bio/src/utils/cell-renderer-annotations.ts`) on top of the standard macromolecule renderer; in the MSA scrolling header they appear via `AnnotationTrack` (`@datagrok-libraries/bio/src/utils/annotation-track.ts`).
+
+**Expected output shape (per antpack/AntPack convention, see `utils/antibody-numbering/number-antibody.ts`):**
 
 A `DG.DataFrame` with 5 string columns, one row per input sequence:
 
@@ -254,13 +289,24 @@ Reference implementation: `immunumAntibodyNumbering()` in `package.ts` and `numb
 
 Existing engines:
 - **Bio** — `immunumAntibodyNumbering` (WASM, in-worker, IMGT/Kabat only — advertised via the `scheme` param's `choices`)
-- **scripts/number_antibody.py** — Python/AntPack reference (non-commercial license, not shipped in production; kept for correctness cross-checks only)
+- **AntPack reference** — historical Python reference for the expected DataFrame shape (5 columns: `position_names`, `chain_type`, `annotations_json`, `numbering_detail`, `numbering_map`). Not currently shipped in `scripts/`; the same shape is asserted by `utils/antibody-numbering/number-antibody.ts` and the `antibody-numbering-tests.ts` test suite
+
+#### Annotations — `src/utils/annotations/`
+
+| File | Purpose |
+|---|---|
+| `numbering-ui.ts` | `showNumberingSchemeDialog()` — generic dialog that discovers `meta.role: 'antibodyNumbering'` engines, populates the scheme dropdown from the chosen engine's `scheme` param `choices`, runs the engine, and applies its result (annotations + aligned column). See "Adding a New Antibody Numbering Engine" |
+| `annotation-manager.ts` | `AnnotationManager` — owns the per-column `RowAnnotationData[]`, persists to a column tag, fires events when annotations change. Backbone for the `manageAnnotations` UI |
+| `annotation-manager-ui.ts` | UI for `Bio | Annotate | Manage Annotations...` — table + buttons for creating / editing / removing per-row annotations |
+| `annotation-actions.ts` | Annotation actions registry — bulk operations (clear, copy from another column, etc.) and the right-click action set wired into the cell renderer |
+| `liability-scanner.ts` | Liability rules engine — scans macromolecule sequences for chemistry liabilities (deamidation `NG`, oxidation `M`, …) and emits `SeqAnnotationHit[]` keyed by `LiabilitySeverity` |
+| `liability-scanner-ui.ts` | `Bio | Annotate | Scan Liabilities...` dialog — selects target column, runs the scanner, writes results into the `AnnotationManager` |
 
 #### Seq Helper — `src/utils/seq-helper/`
 
 | File | Purpose |
 |---|---|
-| `seq-helper.ts` | `SeqHelper` (implements `ISeqHelper`) — central facade for sequence operations: `getSeqHandler()`, `getSeqMonomers()`, `helmToMolfileV3K()`, `helmToSmiles()`, column tag management |
+| `seq-helper.ts` | `SeqHelper` (implements `ISeqHelper`) — central facade for sequence operations: `helmToAtomicLevel()` / `helmToAtomicLevelSingle()` (HELM column / single-row → V3K molfile), `getSeqHandler()`, `getSeqMonomers()`, `setUnitsToFastaColumn()` / `setUnitsToSeparatorColumn()` / `setUnitsToHelmColumn()`, `getHelmToMolfileConverter()` |
 | `seq-handler.ts` | `SeqHandler` (implements `ISeqHandler`) — per-column handler for splitting, notation conversion (FASTA/SEP/HELM/BILN), region extraction, stats, alphabet detection. Contains joiner functions. |
 | `index.ts` | Barrel re-export of `SeqHelper` |
 
@@ -272,6 +318,8 @@ Existing engines:
 | `monomer-lib.ts` | `MonomerLib` (extends `MonomerLibBase`, implements `IMonomerLib`) — merged library from multiple sources. Handles duplicate tracking, user duplicate preferences, summary stats. |
 | `monomer-lib-base.ts` | `MonomerLibBase` — base implementation: monomer lookup, symbol listing, missing monomer creation, R-group extraction from SMILES, tooltip rendering, color computation with contrast logic |
 | `monomer-colors.ts` | Static color mappings for natural monomers (nucleotide chromatogram palette, amino acid GrokGroups palette) |
+| `monomer-collection-handler.ts` | Backs the `Monomer Collections` app — manages curated subsets of monomers (collection CRUD, persistence to AppData) |
+| `monomer-collections-view.ts` | View for browsing / editing monomer collections; loads from `files/monomer-collections/` JSON files |
 | `consts.ts` | Test constants: `LIB_SETTINGS_FOR_TESTS`, `LIB_MONOMER_COUNTS` |
 | `smiles2Monomer.ts` | `smiles2Monomer()` — converts inline SMILES (CX-SMILES with R-group labels) to `Monomer` objects with auto-derived R-groups |
 | `web-editor-monomer-dummy.ts` | Placeholder `WebEditorMonomer` implementations (inline SMILES, gap, ambiguous, missing, broken) |
@@ -282,16 +330,18 @@ Existing engines:
 | File | Purpose |
 |---|---|
 | `ui.ts` | UI for library management: `showManageLibrariesDialog()` (checkbox per library with edit/delete), `showManageLibrariesView()` (full view with duplicate manager), `getMonomerLibraryManagerLink()` (panel widget) |
-| `MonomerLibFromFilesProvider` | Reads/writes monomer library JSON files from `System:AppData/Bio/` file shares. CRUD operations, HELM JSON schema validation. |
-| `validator` | AJV-based JSON schema validation for monomer library files |
+| `monomers-lib-provider.ts` | `MonomerLibFromFilesProvider` — reads/writes monomer library JSON files from `System:AppData/Bio/` file shares. CRUD operations, HELM JSON schema validation |
+| `file-validator.ts` | AJV-based JSON schema validation for monomer library files |
+| `style.css` | Library manager styles |
 
 ##### Monomer Manager — `src/utils/monomer-lib/monomer-manager/`
 
 | File | Purpose |
 |---|---|
-| `monomer-manager.ts` | `MonomerManager` — full CRUD UI for monomers within a library. Grid view with context menus, create/edit dialog with SMILES↔molfile standardization. `matchMoleculesWithMonomers()` — matches molecules against library by canonical SMILES. `standardizeMonomerLibrary()` — normalizes a library JSON. |
-| `duplicate-manager.ts` | `DuplicateManager` — UI for resolving duplicate monomer conflicts across libraries. Monomer cards grouped by symbol, user picks preferred source. |
-| `default-r-groups.ts` | Default R-group definitions (R1-R6 with cap group SMILES) |
+| `monomer-manager.ts` | `MonomerManager` — full CRUD UI for monomers within a library. Grid view with context menus, create/edit dialog with SMILES↔molfile standardization, `standardizeMonomerLibrary()` library JSON normaliser |
+| `duplicate-monomer-manager.ts` | `DuplicateMonomerManager` — UI for resolving duplicate monomer conflicts across libraries. Monomer cards grouped by symbol, user picks preferred source |
+| `match-molecules.ts` | `matchMoleculesWithMonomers()` — matches molecules in a column against monomers from the selected libraries by canonical SMILES (used by `Bio | Manage | Match with Monomer Library...`) |
+| `const.ts` | Constants used by the monomer manager UI (column-name conventions, default R-group definitions) |
 
 #### HELM to Molfile — `src/utils/helm-to-molfile/`
 
@@ -374,6 +424,11 @@ Test entry point: `src/package-test.ts` — imports all test files, exports `tes
 | `biln-tests.ts` | BILN notation |
 | `mm-distance-tests.ts` | Macromolecule distance functions |
 | `checkInputColumn-tests.ts` | Input validation |
+| `projects-tests.ts` | DG project save/restore round-trip for macromolecule columns |
+| `activity-cliffs-utils.ts` | Shared helpers used by `activity-cliffs-tests.ts` (no `test()` blocks) |
+| `sequence-space-utils.ts` | Shared helpers used by `sequence-space-test.ts` |
+| `types.ts`, `utils.ts` | Test-suite shared types and helpers (fixture loading, dataframe builders, expectation utilities) |
+| `utils/detectors-utils.ts`, `utils/sequences-generators.ts`, `utils/test-logger.ts` | Detector probe + synthetic-sequence generators + structured test logging |
 
 ## Initialization Flow
 
@@ -400,10 +455,12 @@ Test entry point: `src/package-test.ts` — imports all test files, exports `tes
 
 - `files/monomer-libraries/` — HELM monomer library JSON files (HELMCoreLibrary, polytool-lib, sample-lib)
 - `files/monomer-sets/` — Monomer set definitions (PEPTIDE, RNA)
+- `files/monomer-collections/` — Curated monomer collection JSON files (consumed by `Monomer Collections` app via `monomer-collection-handler.ts`)
 - `files/samples/` — Sample data files for all notation types (FASTA, SEPARATOR, HELM, BILN, MSA)
 - `files/tests/` — Test data files
 - `files/schemas/` — JSON schemas for monomer sets
 - `files/icons/` — Viewer icons
+- `files/cache_config.json` — Per-function cache TTL/size configuration for the package
 
 ## Quick Lookups
 
@@ -432,7 +489,9 @@ Test entry point: `src/package-test.ts` — imports all test files, exports `tes
 | Antibody numbering dialog | `src/utils/annotations/numbering-ui.ts` (`showNumberingSchemeDialog`) |
 | Antibody numbering (immunum WASM in worker) | `src/utils/antibody-numbering/` (`immunum.worker.ts`, `immunum-client.ts`, `number-antibody.ts`, `immunum-glue.js`) |
 | Adding antibody numbering engines | See "Adding a New Antibody Numbering Engine" in Antibody Numbering section |
+| Annotation manager + liability scanner | `src/utils/annotations/` (`annotation-manager.ts`, `annotation-manager-ui.ts`, `liability-scanner.ts`, `liability-scanner-ui.ts`) |
 | Notation conversion | `src/utils/convert.ts` |
+| Compare two macromolecule columns | `src/utils/compare-sequences.ts` |
 | Seq → molfile conversion | `src/utils/sequence-to-mol.ts` |
 | HELM → molfile pipeline | `src/utils/helm-to-molfile/converter/` |
 | FASTA import/export | `src/utils/save-as-fasta.ts` + bio lib `FastaFileHandler` |
@@ -440,7 +499,13 @@ Test entry point: `src/package-test.ts` — imports all test files, exports `tes
 | BILN notation support | `src/utils/biln.ts` |
 | MSA header with WebLogo | `src/widgets/sequence-scrolling-widget.ts` |
 | Atomic level widgets | `src/widgets/to-atomic-level-widget.ts` |
+| Monomer info panel | `src/widgets/monomer-info-widget.ts` |
+| Macromolecule column property panel | `src/utils/macromolecule-column-widget.ts` |
+| Detector probe (tunable) | `src/utils/detect-macromolecule-probe.ts` |
+| Monomer Collections app | `src/utils/monomer-lib/monomer-collections-view.ts` + `monomer-collection-handler.ts` |
+| Library file provider + validator | `src/utils/monomer-lib/library-file-manager/` (`monomers-lib-provider.ts`, `file-validator.ts`, `ui.ts`) |
+| Match molecules → monomers | `src/utils/monomer-lib/monomer-manager/match-molecules.ts` |
 | Demo scripts | `src/demo/` |
 | Test entry point | `src/package-test.ts` |
 | Auto-generated wrappers | `src/package.g.ts` / `src/package-api.ts` |
-| Python scripts | `scripts/` (mol-to-helm.py, sequence_generator.py, embed.py) |
+| Python/R scripts | `scripts/` — `mol-to-helm.py`, `sequence_generator.py` (+ `sequence_generator.md`), `embed.py`, `read-tree-pkl.py`, `generate_fasta_csv_for_alphabets.R` |

package/CREDITS.md

@@ -0,0 +1,246 @@
+# Bio — Third-Party Libraries
+
+The `@datagrok/bio` package is distributed under the MIT license that covers the
+rest of the `public/` repository (see [`../../LICENSE.md`](../../LICENSE.md)). It
+incorporates the open-source components listed below; this file reproduces the
+attribution and notices required by their respective licenses.
+
+All runtime JavaScript dependencies bundled into the published artifact are
+under permissive licenses (MIT, Apache-2.0, BSD-3-Clause). No copyleft
+(GPL/LGPL/MPL) component is bundled into the published Bio plugin.
+
+---
+
+## 1. Bundled in the published artifact (`dist/`)
+
+### immunum (1.1.0)
+
+ENPICOM's antibody/TCR numbering library, compiled to WebAssembly. The
+WASM binary is bundled into `dist/`; the wasm-bindgen JS glue is reused from
+[`src/utils/antibody-numbering/immunum-glue.js`](src/utils/antibody-numbering/immunum-glue.js),
+which is a port of the upstream `node_modules/immunum/immunum.js` modified
+only to replace the Node-only `require('fs').readFileSync` top-level loader
+with an explicit `initImmunum(bytes)` entry point so it works in browsers and
+web workers. The modification is noted in the file header per MIT terms.
+
+- Upstream: https://github.com/ENPICOM/immunum — https://immunum.enpicom.com
+- License: **MIT**
+
+```
+MIT License
+
+Copyright (c) 2026 ENPICOM
+
+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.
+```
+
+### @biowasm/aioli (3.x)
+
+WebAssembly runtime that drives multiple sequence alignment (kalign). The
+aioli library itself is bundled; the kalign tool it loads is fetched at
+runtime — see Section 3 below.
+
+- Upstream: https://github.com/biowasm/aioli
+- License: **MIT**
+
+```
+MIT License
+
+Copyright (c) 2018 Robert Aboukhalil
+
+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.
+```
+
+### Ajv (8.x) and ajv-errors (3.x)
+
+JSON-schema validator used for monomer-library JSON validation.
+
+- Upstream: https://ajv.js.org/ — https://github.com/ajv-validator/ajv-errors
+- License: **MIT**
+
+```
+The MIT License (MIT)
+
+Copyright (c) 2015-2021 Evgeny Poberezkin
+
+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.
+```
+
+(`ajv-errors` carries an analogous MIT notice — *Copyright (c) 2017 Evgeny
+Poberezkin*.)
+
+### fastest-levenshtein (1.0.x)
+
+Levenshtein-distance implementation used in sequence comparison code paths.
+
+- Upstream: https://github.com/ka-weihe/fastest-levenshtein
+- License: **MIT**
+
+```
+MIT License
+
+Copyright (c) 2020 Kasper Unn Weihe
+
+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.
+```
+
+### umap-js (1.4.x)
+
+UMAP dimensionality reduction used by sequence-space and similarity viewers.
+The npm package metadata declares MIT but the LICENSE file shipped in the
+tarball is **Apache-2.0**, so we comply with the more conservative Apache-2.0
+terms (preserve copyright/attribution; mark modifications, of which there are
+none).
+
+- Upstream: https://github.com/PAIR-code/umap-js
+- Author: Andy Coenen (Google PAIR)
+- License: **Apache-2.0**
+
+> 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.
+
+The full Apache-2.0 license text is available at the URL above and in
+`node_modules/umap-js/LICENSE`.
+
+---
+
+## 2. Linked at runtime via the Datagrok platform (webpack externals)
+
+These libraries are not bundled into Bio's `dist/` — they are provided once
+by the platform host and shared across all packages.
+
+| Component                        | Version | License      | Upstream                                          |
+|----------------------------------|---------|--------------|---------------------------------------------------|
+| OpenChemLib JS                   | 7.x     | BSD-3-Clause | https://github.com/cheminfo/openchemlib-js        |
+| RxJS                             | 6.x     | Apache-2.0   | https://github.com/ReactiveX/rxjs                 |
+| cash-dom                         | 8.x     | MIT          | https://github.com/fabiospampinato/cash           |
+| Day.js                           | 1.x     | MIT          | https://github.com/iamkun/dayjs                   |
+| wu.js                            | 2.x     | MIT          | https://github.com/fitzgen/wu.js                  |
+
+OpenChemLib JS is also referenced by Bio's `package.json` `sources`. The
+upstream `openchemlib-js` npm package is distributed under BSD-3-Clause:
+*Copyright (c) 2015-2017, cheminfo.*
+
+---
+
+## 3. Fetched at runtime from third-party CDNs (not bundled)
+
+### kalign (via @biowasm/aioli)
+
+`@biowasm/aioli` loads the **kalign** multiple-sequence-alignment tool from
+the public biowasm CDN (`https://biowasm.com/cdn/v3/...`) on demand. kalign
+itself is **not** bundled into Bio's `dist/` and is **not** redistributed by
+the Datagrok platform. Users that load it transitively are subject to
+kalign's upstream license (GPLv3).
+
+- Upstream: https://github.com/TimoLassmann/kalign
+- License: GPLv3 (used as a runtime-fetched, non-bundled dependency)
+
+---
+
+## 4. Docker container (`dockerfiles/`) — PepSeA service
+
+The Bio package ships a single Docker image (`dockerfiles/Dockerfile`) that
+provides a PepSeA-based MSA service for HELM peptide sequences. The image is
+built from `datagrok/python` and pulls third-party software at build time:
+
+| Component     | Source                                          | License                |
+|---------------|-------------------------------------------------|------------------------|
+| PepSeA        | https://github.com/Merck/PepSeA (main branch)   | MIT (Merck & Co.)      |
+| MAFFT         | https://mafft.cbrc.jp/ (`mafft_7.520-1` .deb)   | MAFFT license (BSD-style, free for any use with attribution) |
+| FastAPI       | https://github.com/tiangolo/fastapi             | MIT                    |
+| uvicorn       | https://www.uvicorn.org/                        | BSD-3-Clause           |
+| ujson         | https://github.com/ultrajson/ultrajson          | BSD-3-Clause           |
+| Python stdlib | https://www.python.org/                         | PSF License            |
+
+The `Dockerfile` patches a few lines of PepSeA's `api.py` at build time to
+add a `/distout` endpoint and JSON error-handling middleware; per MIT terms
+those modifications are noted here.
+
+---
+
+## 5. Development-only dependencies
+
+Tools used during the build/test cycle (not in the runtime tree, not bundled):
+the `datagrok-tools` CLI transitively pulls in `puppeteer-screen-recorder`,
+which references `@ffmpeg-installer/ffmpeg` (LGPL-2.1) and
+`@ffmpeg-installer/win32-x64` (GPLv3). These binaries are **not**
+redistributed as part of the published Bio plugin and impose no obligation on
+users of the plugin.
+
+The peer/devDependencies on other Datagrok plugins (`@datagrok/chem`,
+`@datagrok/dendrogram`, `@datagrok/eda`, `@datagrok/helm`,
+`@datagrok/peptides`) are MIT — covered by the repo-wide `LICENSE.md`. Each
+of those plugins maintains its own `CREDITS.md` (or will) for its own
+third-party content.