Files
pplus-web/THIRD_PARTY.md
T
alexm e092cb029c
Build, test, deploy / site (push) Failing after 15m13s
Initial commit
2026-11-12 22:24:02 -05:00

83 lines
6.8 KiB
Markdown

# Third-party material in pplus-web
Everything in this repository is ours, under the Apache License 2.0 ([LICENSE.md](LICENSE.md)), except what this file lists. `tests/third-party.test.mjs` holds it to the CodeMirror bundle's own banner, `styles/course/`, the Quarto extension's copies, the fonts `index.html` loads, `pixi.lock` and `package-lock.json`, so a change there fails the tests until this file says so. The submodule `core/` (pplus-core, and through it pplus-library) has its own THIRD_PARTY.md.
## Shipped with the site
### CodeMirror 6 (`src/vendor/`)
`src/vendor/codemirror.js` is one ES module that `scripts/vendor/codemirror.sh` builds with esbuild from these packages' sources on GitHub; `src/vendor/cm-types/` and `codemirror.d.ts` are their type declarations. Every package is under the MIT license, by Marijn Haverbeke and others. `src/vendor/CODEMIRROR-LICENSE` (a copy of @codemirror/state's LICENSE) carries the first notice below; the others are here.
| Package | Version | Repository | Copyright notice |
|---|---|---|---|
| @codemirror/state | 6.6.0 | codemirror/state | Copyright (C) 2018-2021 by Marijn Haverbeke <marijn@haverbeke.berlin> and others |
| @codemirror/view | 6.41.0 | codemirror/view | Copyright (C) 2018-2021 by Marijn Haverbeke <marijn@haverbeke.berlin> and others |
| @codemirror/language | 6.12.3 | codemirror/language | Copyright (C) 2018-2021 by Marijn Haverbeke <marijn@haverbeke.berlin> and others |
| @codemirror/commands | 6.10.3 | codemirror/commands | Copyright (C) 2018-2021 by Marijn Haverbeke <marijn@haverbeke.berlin> and others |
| @codemirror/search | 6.6.0 | codemirror/search | Copyright (C) 2018-2021 by Marijn Haverbeke <marijn@haverbeke.berlin> and others |
| @lezer/common | 1.5.2 | lezer-parser/common | Copyright (C) 2018 by Marijn Haverbeke <marijn@haverbeke.berlin> and others |
| @lezer/highlight | 1.2.3 | lezer-parser/highlight | Copyright (C) 2018 by Marijn Haverbeke <marijn@haverbeke.berlin> and others |
| @lezer/lr | 1.4.8 | lezer-parser/lr | Copyright (C) 2018 by Marijn Haverbeke <marijn@haverbeke.berlin> and others |
| style-mod | 4.1.3 | marijnh/style-mod | Copyright (C) 2018 by Marijn Haverbeke <marijn@haverbeke.berlin> and others |
| w3c-keyname | 2.2.8 | marijnh/w3c-keyname | Copyright (C) 2016 by Marijn Haverbeke <marijn@haverbeke.berlin> and others |
| crelt | 1.0.6 | marijnh/crelt | Copyright (C) 2020 by Marijn Haverbeke <marijn@haverbeke.berlin> |
| @marijn/find-cluster-break | 1.0.2 | marijnh/find-cluster-break | Copyright (C) 2024 by Marijn Haverbeke <marijn@haverbeke.berlin> |
Each notice above goes with this permission notice, which every package's LICENSE file carries word for word:
```
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.
```
### The course's widget stylesheets (`styles/course/`, `quarto/_extensions/pplus/course/`)
`tokens.css`, `kit.css` and `asm86.css` are the course site's own stylesheets (`static/css/` in its repository), copied unchanged; [styles/course/README.md](styles/course/README.md) records each one's course path and sha256, and `tests/course-css.test.mjs` holds the copies to those hashes. `pixi run quarto-css` copies the same three into `quarto/_extensions/pplus/course/`. `bridge.css` was written for this repository. All four are ours: Copyright Scientific Computing Studio, LLC, under the Apache License 2.0. The three are listed here because they are copies held to the course's own files, not because they are someone else's.
### The Quarto extension's syntax definitions (`quarto/_extensions/pplus/syntax/`)
`pseudo.xml` and `lingo.xml` are KDE syntax definitions that came from the course; their headers say `author="BIOSC 1540"` (the course) and `license="Apache-2.0"`. They are ours, like the stylesheets above. `mojo.xml` is pplus-core's `library/syntax/mojo.xml`, copied by `pixi run quarto-css` (its header says `author="Programming+"` and `license="Apache-2.0"`).
### Fonts
| Font | License | How the site gets it |
|---|---|---|
| IBM Plex Sans, IBM Plex Mono | SIL Open Font License 1.1, Copyright 2017 IBM Corp. with Reserved Font Name "Plex" | Seven `.woff2` files in `fonts/`, copied unchanged from npm `@ibm/plex-sans@1.1.0` and `@ibm/plex-mono@1.1.0` and served by the site (`fonts/plex.css`); the OFL text is `fonts/LICENSE.txt`, and `fonts/README.md` gives each file's source and sha256. No font host is asked for anything. |
## Installed to build and test, not redistributed
pixi installs these into `.pixi/` and npm into `node_modules/`; git ignores both, and `scripts/assemble.sh` copies none of them into `site/`.
| Tool | Version | From | License | In what we ship |
|---|---|---|---|---|
| Mojo | 1.2.0 | conda.modular.com, by pixi | LicenseRef-Modular-Proprietary (Modular's license, as `pixi.lock` records it) | Nothing. The Quarto views can run a page's Mojo on the compiler a site's author installs. |
| Node.js | 26.10.0 | conda-forge, by pixi | MIT | Nothing. |
| Python | 3.14.7 | conda-forge, by pixi | Python-2.0 | Nothing. The dev server and the package script. |
| pandoc | 3.14 | conda-forge, by pixi | GPL-2.0-or-later | Nothing. The Quarto extension's tests run its Lua filter in pandoc. |
| TypeScript | 6.0.3 | npm (`package-lock.json`) | Apache-2.0 | Nothing. `tsc` compiles `src/`; the output is our code. |
Dafny, the other pinned tool, is pplus-core's (`core/scripts/dafny.py` downloads its release zip into `core/.tools/`, ignored by git); the site neither downloads nor serves it.
## Services the site uses
- [Compiler Explorer](https://godbolt.org) (godbolt.org): **Compile & run** sends the program, its input and the build options there; its [privacy policy](https://github.com/compiler-explorer/compiler-explorer/blob/main/static/generated/privacy.pug) says what it keeps.
## Names
"Mojo" and "Modular" are trademarks of Modular Inc. Programming+ is not affiliated with or endorsed by Modular. "Compiler Explorer" and "godbolt.org" name the service by Matt Godbolt that the app asks.