[jeany55]

Lets another plugin give TrigScript scripts a library to import, the way the standard library is imported.

For map makers. import { spawnWave } from "waves" imports a library a plugin provides ("waves/spawn" for one module, "waves" for its index). Applying the script copies each imported library into the map (trigscript\@libraries\<id>\), and the map builds with that copy from then on: it still builds where the plugin is not installed, or where a different version is. When the installed plugin has a different version, the editor offers Update / Keep the map's copy. It never updates by itself.

For plugin authors. trigscript.build is now service version 2, with provideLibrary({ id, label, version, modules }), documented in contract.d.ts and the README (Providing a library). examples/library is a complete library plugin to copy, installable as github:scm-js/plugin-trigscript/examples/library.

How

• Compiler (compiler/libraries.ts): CompileOptions.libraries. Only modules something imports join the files (__libraries__/<id>/…), so a program() in a library module runs only where that module is imported. TypeScript paths and the linker resolve bare ids. A missing library or module gets a message saying where libraries come from.
• Map copy (script.ts): readLibraries / withLibraries; pathOf keeps the copy out of the script's own files. The manifest hash covers the copies via hashSources; with no libraries it equals hashFiles, so existing maps still read as built.
• Service: a compile takes the map's copy first, then what a plugin provides. Apply writes exactly the libraries the compile used. New commands trigscript.libraries and trigscript.updateLibraries; state() lists the copies.
• Editor: library modules become Monaco extra libs (completion, hovers), refreshed when a provider comes or goes.

Tested

• New tests/libraries.test.ts (compiler, map copy, the example library) and service tests (copy on apply, building without the plugin, update, dropping an unused library, contributions, refusals). There is also a test that the compile worker's own source forwards libraries. Full suite: 1398 passed; tsc clean.
• Played in the editor: a dev server with this branch as the built-in TrigScript and the compiler bundle served locally. Import → 0 problems and the library's hover; Apply; Save As → the archive holds trigscript\@libraries\waves\…. Reopened with the example at 1.1.0 → the notice, then Update → "Changes not applied". Reopened with the example not installed → 0 problems, still built.

Left open (in docs/v4-plan.md, Libraries from other plugins): a Libraries view, cost per library, media in libraries, a template repository and a way to test a library in its own repo, libraries without a plugin, and the scm-js guide pages once a release pins this.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WdKDdRDTseBGCMyjhrAiNG