@stealthscale/vite-plugin-product 0.1.0 → 0.3.1

package/README.md

@@ -5,6 +5,10 @@ checks every installed plugin against the others, serves the resolved product as
 builds each plugin's lazy modules into a chunk of its own, and writes the catalogues the product's
 services read.
 
+For a product whose page loads plugins at run time, `provided()` provides the product's shared
+modules to those plugins. `release()` builds a plugin's web package as a release that such a page
+loads.
+
 ## Install
 
 ```bash
@@ -20,9 +24,10 @@ beside the layers of `@stealthscale/vite-config-i18n`.
 The product states its plugins in `src/product.ts`, whose default export is the definition:
 
 ```ts
-import { defineProduct, installed } from "@stealthscale/sdk-core";
 import { manifest as timeOff } from "@acme/plugin-time-off";
 
+import { defineProduct, installed } from "@stealthscale/sdk-core";
+
 export default defineProduct({
   name: "product.name",
   plugins: [installed(timeOff)],
@@ -37,15 +42,22 @@ The application reads the resolved product from `virtual:product`:
 import { product } from "virtual:product";
 ```
 
+The module writes the resolved data as a literal. It reads two members from the definition module.
+`manifests` contains each installed plugin's manifest, and `code` contains the importers of the
+product's own frame and of its sources. The module also exports `definition`, which a page that
+loads releases resolves again with them.
+
 Add the module's type with a triple-slash directive from a file the project compiles:
 
 ```ts
 /// <reference types="@stealthscale/vite-plugin-product/client" />
 ```
 
-`product({ definition })` names another module. `src/product.ts` is the default.
+`product({ definition })` names another module. `src/product.ts` is the default. `product({ app })`
+serves the product's page, described in [The product's page](#the-products-page).
 `product({ standalone })` serves the standalone page of a plugin, described in
-[The standalone page](#the-standalone-page).
+[The standalone page](#the-standalone-page). `product({ runtime: true })` marks a product whose page
+loads releases, described in [Releases at run time](#releases-at-run-time).
 
 ## The composition
 
@@ -65,7 +77,7 @@ When a build or a dev server starts, the plugin composes the product:
    namespace, and the packages that publish each one. The plugin's contract package and the
    application's own catalogues are left out of the publishers.
 5. It calls `resolveProduct` with the definition, the web packages, the words and the
-   `validateHotkey` of `@tanstack/hotkeys` 0.10.0, the version `@tanstack/react-hotkeys` binds keys
+   `validateHotkey` of `@tanstack/hotkeys` 0.11.0, the version `@tanstack/react-hotkeys` binds keys
    with.
 
 A configuration without the `stealth:i18n` plugin fails the build and names
@@ -86,11 +98,32 @@ object as its default export fails and names the file.
 
 ## Chunks
 
-The plugin adds one code-splitting group, at priority 4: above the shared group and below the vendor
-group of `@stealthscale/vite-config`. The group assigns every module of an installed plugin's web
-package to the chunk `plugin-<id>`, so each plugin's pages, extensions, commands and settings
-sections build into one chunk. A module that an entry imports statically is left out of the group.
-The web package's main entry and its manifest load with the entry chunk.
+The plugin adds two code-splitting groups to a build, and the first of them to a dev server.
+
+The plugins' group, at priority 4, is above the shared group and below the vendor group of
+`@stealthscale/vite-config`. It builds each plugin's pages, extensions, commands and settings
+sections into one chunk, `plugin-<id>`:
+
+- Every module of an installed plugin's web package goes into the plugin's chunk, unless an entry or
+  `virtual:product` imports it statically. The web package's main entry and its manifest load with
+  the product.
+- A module outside every web package that only one plugin's modules import goes into that plugin's
+  chunk too.
+- A module that an entry or `virtual:product` imports statically, or that the modules of two plugins
+  import, goes to the other groups.
+
+The dependencies' group, at priority 1, is below every other group. It builds each module outside
+the application that the other groups leave into the chunk `dependencies`, where the module's static
+importers lead to an entry, to `virtual:product` or to an installed plugin's web package. A module
+of the application is a file under the project root and outside its `node_modules`, and the group
+leaves out virtual modules. A module that only another `import()` loads, such as a page the
+application loads on demand, keeps its own chunk, so it does not load with the startup.
+
+Groups that place a module by its path alone make rolldown 1.2 build a module the groups leave into
+the chunk of a lazy module that imports it, and export the module from there. `import()` of the lazy
+module then returns the other module's exports as well, and the host refuses a module that exports
+more than one function. Under a dev server `import()` returns the module's own exports, so the
+dependencies' group applies to a build alone.
 
 ## Catalogues
 
@@ -115,7 +148,8 @@ again:
 - Under a dev server that bundles, `watchChange` reloads the page. `virtual:product` lists every
   composition file as a watched file, so the rebuild loads it again.
 - A composition with problems shows them in the error overlay and keeps the last product that
-  resolved.
+  resolved. A page that connects while the product does not resolve, such as the page a bundling
+  server reloads after the change, receives the problems too.
 - One composition runs at a time, in the order of the changes. The changes reported during a
   composition compose the product once more after it ends.
 - Every composition imports the definition through one environment, which the plugin closes when the
@@ -124,6 +158,30 @@ again:
 
 A watching build composes the product again at its next build start.
 
+## The product's page
+
+`product({ app })` serves the page of a product that renders with the host's frame. A product adds
+it through `product.app()` of `@stealthscale/vite-config-product`, which adds the stylesheet
+compiler beside it.
+
+- The plugin serves the page's document as `index.html` at the project root, and its entry as
+  `virtual:product-app`. The document's language is the product's first locale, `en-US` without one.
+  Its title is the product's id, which `HostProvider` replaces with the product's name.
+- The entry imports `@stealthscale/theme/styles.css`. It loads `@stealthscale/sdk-host/app`,
+  `virtual:i18n`, `virtual:product`, `virtual:stealth-themes` and the module `glyphs` names through
+  `import()`, then calls `renderProduct`. The stylesheet compiler of
+  `@stealthscale/vite-plugin-theme` serves `virtual:stealth-themes`.
+- Under `runtime`, the entry loads `@stealthscale/sdk-host/releases` in place of
+  `@stealthscale/sdk-host/app`, and calls `renderDeployed` with the definition beside the product.
+- The configuration's `base` becomes the router's base path where it is a path other than `/`, such
+  as `/docs/`. A relative base and a URL give none.
+- A server that bundles serves the document from its bundle at every address without a file. Under a
+  server that serves one module per file, a middleware of the plugin serves the document after the
+  server's fallback rewrites such an address to `/index.html`.
+- The document and the entry watch every file the composition read, so the document follows a change
+  to the definition's locales.
+- `product({ app, standalone })` throws, because both pages serve `index.html`.
+
 ## The standalone page
 
 `product({ standalone })` serves a plugin's standalone page from the plugin's own web package. The
@@ -152,6 +210,66 @@ it under a dev server alone.
 - A server that bundles serves the document at every address without a file on disk. A server that
   serves one module per file reads `index.html` from disk, so it does not serve the page.
 
+## Releases at run time
+
+`provided()` provides a product's shared modules to the releases its page loads. A product adds it
+through `product.app({ runtime: true })` or `product.layers({ runtime: true })` of
+`@stealthscale/vite-config-product`. It applies to a build alone, so a dev server's page loads no
+release.
+
+- The provided packages are `react` with `react/jsx-runtime` and `react/compiler-runtime`,
+  `react-dom`, the SDK, the providers, `settings`, `hooks`, `theme`, every component package, the
+  TanStack libraries that the providers wrap, `i18next`, `react-i18next`, and five Zag modules:
+  `@zag-js/dismissable`, `@zag-js/focus-visible`, `@zag-js/focus-trap`, `@zag-js/aria-hidden` and
+  `@zag-js/remove-scroll`. A product provides each of them that is on its dependency graph.
+- An `@stealthscale` package's specifiers are the subpaths of its `exports`, except `./testing`,
+  `./theme`, `./package.json` and the stylesheets.
+- The client build emits one entry per provided specifier under `assets/provided/`, which re-exports
+  the package. The entry of an ES module exports `*` and its default export. The entry of a CommonJS
+  module exports the names that Node's `require` returns.
+- The client build runs a first build of the same configuration without the entries, and records the
+  chunk of each module. The first build keeps every export of each module of a provided package that
+  states its side effects, because the entries make the second build keep them. It also records the
+  modules that those exports import. The second build places each recorded module in the chunk of
+  the same name, and each recorded CommonJS module in a chunk beside it, named with `-cjs`. Rolldown
+  builds the code that only the entries need into chunks that only the entries import.
+- The build writes `.product/provided.json`. The file contains the URL of each provided entry and
+  the URLs of the chunks that the entry imports, without the chunks of the page's startup. It also
+  contains the installed version of each provided package and the page's fallback `language`. The
+  build writes the import map of the provided specifiers before the page's module scripts.
+- The configuration needs the `stealth:i18n` plugin, because the build reads the page's fallback
+  language from it.
+
+## A plugin's release
+
+`release()` builds a plugin's web package as a release that a page loads at run time. A plugin adds
+it through `product.release()` of `@stealthscale/vite-config-product`, and `vite build` writes the
+release into `dist-release` (`RELEASE_DIRECTORY`).
+
+| File                      | Contains                                                                                                             |
+| ------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `manifest.js`             | The manifest module with its export names, and the modules it shares with its lazy modules                           |
+| `assets/*.js`             | The modules the manifest imports lazily and the modules they share, each with a hash in its name                     |
+| `locales/<language>.json` | The plugin's catalogue in each language                                                                              |
+| `plugin.json`             | The plugin's id and version, its languages, its requirements, each file's integrity and each module's static imports |
+
+- The release is a library build whose one entry is the manifest module, `src/manifest.ts` unless
+  `manifest` names another. The build defines `process.env.NODE_ENV` from its mode and minifies.
+- Rolldown builds a module that the manifest shares with a lazy module into `manifest.js`, which
+  exports it beside `manifest`. The page then imports the manifest with one request.
+- The build calls each lazy import in the release through `preloaded` of `@stealthscale/sdk-core`.
+  It rewrites `import("./x.js")` as `preloaded(import.meta.url, "./x.js", () => import("./x.js"))`.
+  The page then preloads the static imports of the module while the module loads. The build imports
+  `preloaded` under the name `__stealth_preloaded__`, and it fails on a module that already uses
+  that name.
+- The build keeps every import of a provided specifier as an import by name. `requires` lists the
+  package of each such import, at the caret range of the installed version: `^0.2.0` for 0.2.3.
+- The build reads the plugin's id from the manifest module's `manifest` export, which it evaluates
+  in Node.
+- The build fails on an import of a provided package through a specifier that the page does not map,
+  on a stylesheet or any other file that is not a module, and on a preset that declares a recipe.
+- The configuration needs the `stealth:i18n` plugin, whose catalogues the release contains.
+
 ## Licence
 
 MIT. See [LICENSE](LICENSE).

package/client.d.ts

@@ -8,7 +8,13 @@
  */
 
 declare module "virtual:product" {
-  import { type Product } from "@stealthscale/sdk-core";
+  import { type Product, type ProductDefinition } from "@stealthscale/sdk-core";
+
+  /**
+   * The product's definition, which a page that loads releases resolves again with the releases'
+   * plugins.
+   */
+  export const definition: ProductDefinition;
 
   /**
    * The product as the build resolved it, with each installed plugin's manifest.

package/dist/cyclonedx/bom.json

@@ -1 +1 @@
-{"$schema":"http://cyclonedx.org/schema/bom-1.7.schema.json","bomFormat":"CycloneDX","specVersion":"1.7","version":1,"metadata":{"lifecycles":[{"phase":"build"}],"tools":{"components":[{"type":"application","name":"rolldown","version":"1.2.11"},{"type":"application","name":"vite","version":"8.3.1"},{"type":"library","name":"core","group":"@arethetypeswrong","version":"0.18.5","bom-ref":"pkg:npm/%40arethetypeswrong/core@0.18.5","author":"Andrew Branch","description":"The API behind arethetypeswrong.github.io","hashes":[{"alg":"SHA-512","content":"f72b63cc6c318e6f54cfb23d6af7dbb79be542deae93db914444b3263aabce797a58abc8e9dc184e8faf277534d96aeafe64778aa97f3f386f1e129d2480230d"}],"licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40arethetypeswrong/core@0.18.5","externalReferences":[{"url":"https://github.com/arethetypeswrong/arethetypeswrong.github.io.git#packages/core","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=20"}]},{"type":"library","name":"sdk-core","group":"@stealthscale","version":"0.1.0","bom-ref":"pkg:npm/%40stealthscale/sdk-core@0.1.0","description":"Declares the contracts and manifests of plugins, evaluates their conditions, and resolves a product from them, without loading another package at run time.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/sdk-core@0.1.0","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#sdk/core","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/sdk/core#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"testing-config","group":"@stealthscale","version":"0.5.0","bom-ref":"pkg:npm/%40stealthscale/testing-config@0.5.0","description":"Lists every part of the house contract a config, plugin or library package breaks.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/testing-config@0.5.0","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#packages/testing-config","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/packages/testing-config#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"testing","group":"@stealthscale","version":"0.3.0","bom-ref":"pkg:npm/%40stealthscale/testing@0.3.0","description":"Supplies the scratch workspaces, manifests, element measurements and plugin drivers a specification needs.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/testing@0.3.0","externalReferences":[{"url":"git+https://github.com/stealth-scale/scale.git#packages/testing","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"vite-config-typescript","group":"@stealthscale","version":"0.3.0","bom-ref":"pkg:npm/%40stealthscale/vite-config-typescript@0.3.0","description":"Sets the TypeScript options every stealthscale package compiles with.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/vite-config-typescript@0.3.0","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#packages/vite-config-typescript","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/packages/vite-config-typescript#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"vite-config","group":"@stealthscale","version":"0.6.0","bom-ref":"pkg:npm/%40stealthscale/vite-config@0.6.0","description":"Configures a package from five Vite+ tiers and a named layer for every block.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/vite-config@0.6.0","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#packages/vite-config","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/packages/vite-config#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"vite-plugin-base","group":"@stealthscale","version":"0.2.0","bom-ref":"pkg:npm/%40stealthscale/vite-plugin-base@0.2.0","description":"Turns a name and one write step into a bundler plugin that reads the module graph.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/vite-plugin-base@0.2.0","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#packages/vite-plugin-base","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/packages/vite-plugin-base#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"vite-plugin-i18n","group":"@stealthscale","version":"0.1.0","bom-ref":"pkg:npm/%40stealthscale/vite-plugin-i18n@0.1.0","description":"Finds every catalogue an application can reach, types their keys, and answers the module it loads them from.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/vite-plugin-i18n@0.1.0","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#packages/vite-plugin-i18n","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/packages/vite-plugin-i18n#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"node","group":"@types","version":"26.6.3","bom-ref":"pkg:npm/%40types/node@26.6.3","description":"TypeScript definitions for node","hashes":[{"alg":"SHA-512","content":"76ca8c410a1e4cbaaef70ca70c3d34ab9ef798dceca3721d40e01f1d126a2c27260853e81a8f40d5b0e951cbfff6d9caa44ad05aff6e29e19f977ec4212d3662"}],"licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40types/node@26.6.3","externalReferences":[{"url":"https://github.com/DefinitelyTyped/DefinitelyTyped.git#types/node","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node","type":"website","comment":"as detected from PackageJson property \"homepage\""}]},{"type":"library","name":"coverage-v8","group":"@vitest","version":"5.0.1","bom-ref":"pkg:npm/%40vitest/coverage-v8@5.0.1","author":"Anthony Fu <anthonyfu117@hotmail.com>","description":"V8 coverage provider for Vitest","hashes":[{"alg":"SHA-512","content":"1510bc0028ae742ddd23a313a65cd14985870d19c8bf620f7dbcece0576824db0c6a5ff7e6c595f21c087d5f1972acd23f2fae5c778c54e36df4212ab4e535ef"}],"licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40vitest/coverage-v8@5.0.1","externalReferences":[{"url":"https://github.com/vitest-dev/vitest/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs.url\""},{"url":"git+https://github.com/vitest-dev/vitest.git#packages/coverage-v8","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://vitest.dev/guide/coverage","type":"website","comment":"as detected from PackageJson property \"homepage\""}]},{"type":"library","name":"vite-plus-core","group":"@voidzero-dev","version":"1.0.0","bom-ref":"pkg:npm/%40voidzero-dev/vite-plus-core@1.0.0","author":"VoidZero Inc.","description":"The Unified Toolchain for the Web","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40voidzero-dev/vite-plus-core@1.0.0","externalReferences":[{"url":"https://github.com/voidzero-dev/vite-plus/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs.url\""},{"url":"git+https://github.com/voidzero-dev/vite-plus.git#packages/core","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://viteplus.dev/guide","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":"^20.19.0 || ^22.18.0 || >=24.11.0"}]},{"type":"library","name":"typescript","version":"7.0.2","bom-ref":"pkg:npm/typescript@7.0.2","author":"Microsoft Corp.","description":"TypeScript is a language for application scale JavaScript development","hashes":[{"alg":"SHA-512","content":"f0561abbdea8dcd28e85b8ca8bfa8dbc6fd6e63873c646dd9b9b23f406d9ff94f9b16aa7de12602df1b1dbbb11299593bf2cc23fc74b4414dfe6d05349155434"}],"licenses":[{"license":{"id":"Apache-2.0"}}],"purl":"pkg:npm/typescript@7.0.2","externalReferences":[{"url":"https://github.com/microsoft/TypeScript/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs.url\""},{"url":"https://github.com/microsoft/TypeScript.git","type":"vcs","comment":"as detected from PackageJson property \"repository.url\""},{"url":"https://www.typescriptlang.org/","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=16.20.0"}]},{"type":"library","name":"vitest","version":"5.0.1","bom-ref":"pkg:npm/vitest@5.0.1","author":"Anthony Fu <anthonyfu117@hotmail.com>","description":"Next generation testing framework powered by Vite","hashes":[{"alg":"SHA-512","content":"880f799506ca124bebb5391d0209d66d77db8a95a28967bf8439763f9b4c8ba585c03efa1b43715c01a9fccf4439c62ea5e18946beb0a6931cec2a00e354d08e"}],"licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/vitest@5.0.1","externalReferences":[{"url":"https://github.com/vitest-dev/vitest/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs.url\""},{"url":"git+https://github.com/vitest-dev/vitest.git#packages/vitest","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://vitest.dev","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":"^22.12.0 || ^24.0.0 || >=26.0.0"}]}]},"component":{"type":"library","name":"vite-plugin-product","group":"@stealthscale","version":"0.1.0","bom-ref":"pkg:npm/%40stealthscale/vite-plugin-product@0.1.0","description":"Composes a product from its plugins while it builds: checks every plugin against the others, resolves the product, and serves it as virtual:product.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/vite-plugin-product@0.1.0","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#packages/vite-plugin-product","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/packages/vite-plugin-product#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}],"evidence":{"licenses":[{"license":{"name":"file: LICENSE","text":{"content":"TUlUIExpY2Vuc2UKCkNvcHlyaWdodCAoYykgMjAyNiBTdGVhbHRoIFNjYWxlIEIuVi4KClBlcm1pc3Npb24gaXMgaGVyZWJ5IGdyYW50ZWQsIGZyZWUgb2YgY2hhcmdlLCB0byBhbnkgcGVyc29uIG9idGFpbmluZyBhIGNvcHkKb2YgdGhpcyBzb2Z0d2FyZSBhbmQgYXNzb2NpYXRlZCBkb2N1bWVudGF0aW9uIGZpbGVzICh0aGUgIlNvZnR3YXJlIiksIHRvIGRlYWwKaW4gdGhlIFNvZnR3YXJlIHdpdGhvdXQgcmVzdHJpY3Rpb24sIGluY2x1ZGluZyB3aXRob3V0IGxpbWl0YXRpb24gdGhlIHJpZ2h0cwp0byB1c2UsIGNvcHksIG1vZGlmeSwgbWVyZ2UsIHB1Ymxpc2gsIGRpc3RyaWJ1dGUsIHN1YmxpY2Vuc2UsIGFuZC9vciBzZWxsCmNvcGllcyBvZiB0aGUgU29mdHdhcmUsIGFuZCB0byBwZXJtaXQgcGVyc29ucyB0byB3aG9tIHRoZSBTb2Z0d2FyZSBpcwpmdXJuaXNoZWQgdG8gZG8gc28sIHN1YmplY3QgdG8gdGhlIGZvbGxvd2luZyBjb25kaXRpb25zOgoKVGhlIGFib3ZlIGNvcHlyaWdodCBub3RpY2UgYW5kIHRoaXMgcGVybWlzc2lvbiBub3RpY2Ugc2hhbGwgYmUgaW5jbHVkZWQgaW4gYWxsCmNvcGllcyBvciBzdWJzdGFudGlhbCBwb3J0aW9ucyBvZiB0aGUgU29mdHdhcmUuCgpUSEUgU09GVFdBUkUgSVMgUFJPVklERUQgIkFTIElTIiwgV0lUSE9VVCBXQVJSQU5UWSBPRiBBTlkgS0lORCwgRVhQUkVTUyBPUgpJTVBMSUVELCBJTkNMVURJTkcgQlVUIE5PVCBMSU1JVEVEIFRPIFRIRSBXQVJSQU5USUVTIE9GIE1FUkNIQU5UQUJJTElUWSwKRklUTkVTUyBGT1IgQSBQQVJUSUNVTEFSIFBVUlBPU0UgQU5EIE5PTklORlJJTkdFTUVOVC4gSU4gTk8gRVZFTlQgU0hBTEwgVEhFCkFVVEhPUlMgT1IgQ09QWVJJR0hUIEhPTERFUlMgQkUgTElBQkxFIEZPUiBBTlkgQ0xBSU0sIERBTUFHRVMgT1IgT1RIRVIKTElBQklMSVRZLCBXSEVUSEVSIElOIEFOIEFDVElPTiBPRiBDT05UUkFDVCwgVE9SVCBPUiBPVEhFUldJU0UsIEFSSVNJTkcgRlJPTSwKT1VUIE9GIE9SIElOIENPTk5FQ1RJT04gV0lUSCBUSEUgU09GVFdBUkUgT1IgVEhFIFVTRSBPUiBPVEhFUiBERUFMSU5HUyBJTiBUSEUKU09GVFdBUkUuCg==","contentType":"text/plain","encoding":"base64"}}}]}},"supplier":{"name":"Stealth Scale B.V.","url":["https://stealthscale.io"]}},"components":[],"dependencies":[{"ref":"pkg:npm/%40stealthscale/vite-plugin-product@0.1.0"}]}
+{"$schema":"http://cyclonedx.org/schema/bom-1.7.schema.json","bomFormat":"CycloneDX","specVersion":"1.7","version":1,"metadata":{"lifecycles":[{"phase":"build"}],"tools":{"components":[{"type":"application","name":"rolldown","version":"1.2.12"},{"type":"application","name":"vite","version":"8.3.3"},{"type":"library","name":"core","group":"@arethetypeswrong","version":"0.18.5","bom-ref":"pkg:npm/%40arethetypeswrong/core@0.18.5","author":"Andrew Branch","description":"The API behind arethetypeswrong.github.io","hashes":[{"alg":"SHA-512","content":"f72b63cc6c318e6f54cfb23d6af7dbb79be542deae93db914444b3263aabce797a58abc8e9dc184e8faf277534d96aeafe64778aa97f3f386f1e129d2480230d"}],"licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40arethetypeswrong/core@0.18.5","externalReferences":[{"url":"https://github.com/arethetypeswrong/arethetypeswrong.github.io.git#packages/core","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=20"}]},{"type":"library","name":"sdk-core","group":"@stealthscale","version":"0.3.0","bom-ref":"pkg:npm/%40stealthscale/sdk-core@0.3.0","description":"Declares the contracts and manifests of plugins, evaluates their conditions, and resolves a product from them, without loading another package at run time.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/sdk-core@0.3.0","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#sdk/core","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/sdk/core#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"testing-config","group":"@stealthscale","version":"0.6.0","bom-ref":"pkg:npm/%40stealthscale/testing-config@0.6.0","description":"Lists every part of the house contract a config, plugin or library package breaks.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/testing-config@0.6.0","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#packages/testing-config","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/packages/testing-config#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"testing","group":"@stealthscale","version":"0.4.0","bom-ref":"pkg:npm/%40stealthscale/testing@0.4.0","description":"Supplies the scratch workspaces, manifests, element measurements and plugin drivers a specification needs.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/testing@0.4.0","externalReferences":[{"url":"git+https://github.com/stealth-scale/scale.git#packages/testing","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"vite-config-typescript","group":"@stealthscale","version":"0.3.0","bom-ref":"pkg:npm/%40stealthscale/vite-config-typescript@0.3.0","description":"Sets the TypeScript options every stealthscale package compiles with.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/vite-config-typescript@0.3.0","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#packages/vite-config-typescript","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/packages/vite-config-typescript#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"vite-config","group":"@stealthscale","version":"0.8.0","bom-ref":"pkg:npm/%40stealthscale/vite-config@0.8.0","description":"Configures a package from five Vite+ tiers and a named layer for every block.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/vite-config@0.8.0","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#packages/vite-config","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/packages/vite-config#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"vite-plugin-base","group":"@stealthscale","version":"0.5.0","bom-ref":"pkg:npm/%40stealthscale/vite-plugin-base@0.5.0","description":"Turns a name and one write step into a bundler plugin that reads the module graph.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/vite-plugin-base@0.5.0","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#packages/vite-plugin-base","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/packages/vite-plugin-base#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"vite-plugin-i18n","group":"@stealthscale","version":"0.3.2","bom-ref":"pkg:npm/%40stealthscale/vite-plugin-i18n@0.3.2","description":"Finds every catalogue an application can reach, types their keys, and answers the module it loads them from.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/vite-plugin-i18n@0.3.2","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#packages/vite-plugin-i18n","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/packages/vite-plugin-i18n#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}]},{"type":"library","name":"node","group":"@types","version":"26.6.4","bom-ref":"pkg:npm/%40types/node@26.6.4","description":"TypeScript definitions for node","hashes":[{"alg":"SHA-512","content":"95d54f0c2ce3edfb1a199acb07436e1ee4ef25cb0d6accac040a8ca25aff720c6b2ddd716eac48af75c988f9c71c9502c63e6c345d6f9d18fd6969eb561e4972"}],"licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40types/node@26.6.4","externalReferences":[{"url":"https://github.com/DefinitelyTyped/DefinitelyTyped.git#types/node","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node","type":"website","comment":"as detected from PackageJson property \"homepage\""}]},{"type":"library","name":"coverage-v8","group":"@vitest","version":"5.0.3","bom-ref":"pkg:npm/%40vitest/coverage-v8@5.0.3","author":"Anthony Fu <anthonyfu117@hotmail.com>","description":"V8 coverage provider for Vitest","hashes":[{"alg":"SHA-512","content":"fa496ccb3ec1bd3d6f094dbc6647f39acd486bbf170f4578d54dc552d45a6b74bebceaff117bcad4ee81bd50fb9754731239ba48e351d9ac9b3af0c37fdbb499"}],"licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40vitest/coverage-v8@5.0.3","externalReferences":[{"url":"https://github.com/vitest-dev/vitest/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs.url\""},{"url":"git+https://github.com/vitest-dev/vitest.git#packages/coverage-v8","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://vitest.dev/guide/coverage","type":"website","comment":"as detected from PackageJson property \"homepage\""}]},{"type":"library","name":"vite-plus-core","group":"@voidzero-dev","version":"1.1.0","bom-ref":"pkg:npm/%40voidzero-dev/vite-plus-core@1.1.0","author":"VoidZero Inc.","description":"The Unified Toolchain for the Web","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40voidzero-dev/vite-plus-core@1.1.0","externalReferences":[{"url":"https://github.com/voidzero-dev/vite-plus/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs.url\""},{"url":"git+https://github.com/voidzero-dev/vite-plus.git#packages/core","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://viteplus.dev/guide","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":"^20.19.0 || ^22.18.0 || >=24.11.0"}]},{"type":"library","name":"typescript","version":"7.0.2","bom-ref":"pkg:npm/typescript@7.0.2","author":"Microsoft Corp.","description":"TypeScript is a language for application scale JavaScript development","hashes":[{"alg":"SHA-512","content":"f0561abbdea8dcd28e85b8ca8bfa8dbc6fd6e63873c646dd9b9b23f406d9ff94f9b16aa7de12602df1b1dbbb11299593bf2cc23fc74b4414dfe6d05349155434"}],"licenses":[{"license":{"id":"Apache-2.0"}}],"purl":"pkg:npm/typescript@7.0.2","externalReferences":[{"url":"https://github.com/microsoft/TypeScript/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs.url\""},{"url":"https://github.com/microsoft/TypeScript.git","type":"vcs","comment":"as detected from PackageJson property \"repository.url\""},{"url":"https://www.typescriptlang.org/","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=16.20.0"}]},{"type":"library","name":"vitest","version":"5.0.3","bom-ref":"pkg:npm/vitest@5.0.3","author":"Anthony Fu <anthonyfu117@hotmail.com>","description":"Next generation testing framework powered by Vite","hashes":[{"alg":"SHA-512","content":"c4cc3ded2deb8ddb63e5d9156adee30aca96069bdc86cdd196941cb54ab0243d0a904464e34bf3d9f27bee50f05bf57387fa64d7c788b5803392876149eb378d"}],"licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/vitest@5.0.3","externalReferences":[{"url":"https://github.com/vitest-dev/vitest/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs.url\""},{"url":"git+https://github.com/vitest-dev/vitest.git#packages/vitest","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://vitest.dev","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":"^22.12.0 || ^24.0.0 || >=26.0.0"}]}]},"component":{"type":"library","name":"vite-plugin-product","group":"@stealthscale","version":"0.3.1","bom-ref":"pkg:npm/%40stealthscale/vite-plugin-product@0.3.1","description":"Composes a product from its plugins while it builds: checks every plugin against the others, resolves the product, and serves it as virtual:product.","licenses":[{"license":{"id":"MIT"}}],"purl":"pkg:npm/%40stealthscale/vite-plugin-product@0.3.1","externalReferences":[{"url":"https://github.com/stealth-scale/scale/issues","type":"issue-tracker","comment":"as detected from PackageJson property \"bugs\""},{"url":"git+https://github.com/stealth-scale/scale.git#packages/vite-plugin-product","type":"vcs","comment":"as detected from PackageJson property \"repository.url\" and \"repository.directory\""},{"url":"https://github.com/stealth-scale/scale/tree/main/packages/vite-plugin-product#readme","type":"website","comment":"as detected from PackageJson property \"homepage\""}],"properties":[{"name":"cdx:npm:package:constraint:engine:node","value":">=26.0.0"}],"evidence":{"licenses":[{"license":{"name":"file: LICENSE","text":{"content":"TUlUIExpY2Vuc2UKCkNvcHlyaWdodCAoYykgMjAyNiBTdGVhbHRoIFNjYWxlIEIuVi4KClBlcm1pc3Npb24gaXMgaGVyZWJ5IGdyYW50ZWQsIGZyZWUgb2YgY2hhcmdlLCB0byBhbnkgcGVyc29uIG9idGFpbmluZyBhIGNvcHkKb2YgdGhpcyBzb2Z0d2FyZSBhbmQgYXNzb2NpYXRlZCBkb2N1bWVudGF0aW9uIGZpbGVzICh0aGUgIlNvZnR3YXJlIiksIHRvIGRlYWwKaW4gdGhlIFNvZnR3YXJlIHdpdGhvdXQgcmVzdHJpY3Rpb24sIGluY2x1ZGluZyB3aXRob3V0IGxpbWl0YXRpb24gdGhlIHJpZ2h0cwp0byB1c2UsIGNvcHksIG1vZGlmeSwgbWVyZ2UsIHB1Ymxpc2gsIGRpc3RyaWJ1dGUsIHN1YmxpY2Vuc2UsIGFuZC9vciBzZWxsCmNvcGllcyBvZiB0aGUgU29mdHdhcmUsIGFuZCB0byBwZXJtaXQgcGVyc29ucyB0byB3aG9tIHRoZSBTb2Z0d2FyZSBpcwpmdXJuaXNoZWQgdG8gZG8gc28sIHN1YmplY3QgdG8gdGhlIGZvbGxvd2luZyBjb25kaXRpb25zOgoKVGhlIGFib3ZlIGNvcHlyaWdodCBub3RpY2UgYW5kIHRoaXMgcGVybWlzc2lvbiBub3RpY2Ugc2hhbGwgYmUgaW5jbHVkZWQgaW4gYWxsCmNvcGllcyBvciBzdWJzdGFudGlhbCBwb3J0aW9ucyBvZiB0aGUgU29mdHdhcmUuCgpUSEUgU09GVFdBUkUgSVMgUFJPVklERUQgIkFTIElTIiwgV0lUSE9VVCBXQVJSQU5UWSBPRiBBTlkgS0lORCwgRVhQUkVTUyBPUgpJTVBMSUVELCBJTkNMVURJTkcgQlVUIE5PVCBMSU1JVEVEIFRPIFRIRSBXQVJSQU5USUVTIE9GIE1FUkNIQU5UQUJJTElUWSwKRklUTkVTUyBGT1IgQSBQQVJUSUNVTEFSIFBVUlBPU0UgQU5EIE5PTklORlJJTkdFTUVOVC4gSU4gTk8gRVZFTlQgU0hBTEwgVEhFCkFVVEhPUlMgT1IgQ09QWVJJR0hUIEhPTERFUlMgQkUgTElBQkxFIEZPUiBBTlkgQ0xBSU0sIERBTUFHRVMgT1IgT1RIRVIKTElBQklMSVRZLCBXSEVUSEVSIElOIEFOIEFDVElPTiBPRiBDT05UUkFDVCwgVE9SVCBPUiBPVEhFUldJU0UsIEFSSVNJTkcgRlJPTSwKT1VUIE9GIE9SIElOIENPTk5FQ1RJT04gV0lUSCBUSEUgU09GVFdBUkUgT1IgVEhFIFVTRSBPUiBPVEhFUiBERUFMSU5HUyBJTiBUSEUKU09GVFdBUkUuCg==","contentType":"text/plain","encoding":"base64"}}}]}},"supplier":{"name":"Stealth Scale B.V.","url":["https://stealthscale.io"]}},"components":[],"dependencies":[{"ref":"pkg:npm/%40stealthscale/vite-plugin-product@0.3.1"}]}

package/dist/index.d.mts

@@ -1,5 +1,17 @@
 import { Plugin } from "vite";
 import "@stealthscale/sdk-core";
+//#region src/app.d.ts
+/**
+ * Lists what a product's page renders with beside the product, its words and its themes.
+ */
+interface AppPage {
+  /**
+   * Path of a module, from the project root, whose `glyphs` export the forms of the product's
+   * settings render with. Lucide's glyphs where left out.
+   */
+  readonly glyphs?: string | undefined;
+}
+//#endregion
 //#region src/module.d.ts
 /**
  * The specifier an application imports the product from.
@@ -45,11 +57,22 @@ interface StandalonePage {
  * Lists the options of the product plugin.
  */
 export interface ProductOptions {
+  /**
+   * The product's page, which the plugin serves as `index.html` with an entry that renders the
+   * product with the host's frame. No page where left out.
+   */
+  readonly app?: AppPage | undefined;
   /**
    * Path of the module whose default export is the product's definition, from the project root.
    * `src/product.ts` by default, and the generated definition under `standalone`.
    */
   readonly definition?: string | undefined;
+  /**
+   * True for a product whose page loads plugin releases at run time. The page's entry then renders
+   * with `renderDeployed` and passes the definition, and the product's layers add `provided()`
+   * beside this plugin. False where left out.
+   */
+  readonly runtime?: boolean | undefined;
   /**
    * The standalone page of a plugin, which the plugin serves at every address without a file. No
    * page where left out.
@@ -67,12 +90,70 @@ export interface ProductOptions {
  *   resolves, and `virtual:product` then fails with the problems. A change to a file the
  *   composition read composes the product again: the page reloads, or shows the problems in the
  *   error overlay and keeps the last product. The client build writes the catalogues under
- *   `.product` in its output. Under `standalone`, the plugin writes the definition of the product
- *   that runs the plugin at `node_modules/.stealth/standalone/product.ts` once the configuration
- *   resolves, unless `definition` names one. It serves the page's document as `index.html`, its
- *   entry as `virtual:standalone`, and the generated definition as `virtual:standalone-product`.
- * @param options - The definition's path, and the standalone page.
+ *   `.product` in its output. Under `app`, the plugin serves the product's document as
+ *   `index.html` and its entry as `virtual:product-app`, which renders the product with
+ *   `renderProduct`. A dev server that serves one module per file receives the document from a
+ *   middleware. Under `standalone`, the plugin writes the definition of the product that runs the
+ *   plugin at `node_modules/.stealth/standalone/product.ts` once the configuration resolves,
+ *   unless `definition` names one. It serves the page's document as `index.html`, its entry as
+ *   `virtual:standalone`, and the generated definition as `virtual:standalone-product`.
+ * @param options - The definition's path, and the product's page or the standalone page.
+ * @throws {@link Error} When the options name both pages, which both serve `index.html`.
  */
 export declare function product(options?: ProductOptions): Plugin;
 //#endregion
-export type { StandalonePage };
+//#region src/provided/plugin.d.ts
+/**
+ * Creates the plugin that provides the product's shared modules to the releases its page loads.
+ *
+ * @remarks
+ *   The client build first runs a build of the same configuration without the facades. The first
+ *   build keeps every export of each module of a provided package that it includes, as the facades
+ *   make the client build keep them. A package qualifies where it states which of its files have
+ *   side effects. The client build then builds each module of the first build into the chunk of the
+ *   same name, and each CommonJS module into a chunk beside it. It emits each facade as an entry
+ *   chunk that keeps its exports.
+ *   A facade imports its specifier, and the plugin resolves the specifier from the package that
+ *   depends on it, so the facade and the product share one module. Rolldown builds the code that
+ *   only the facades need into chunks that only the facades import. The plugin writes
+ *   `.product/provided.json` beside the page. The file contains the chunks that each facade imports
+ *   and the page's fallback language. The plugin writes the import map before the module scripts of
+ *   every document that the build writes.
+ */
+export declare function provided(): Plugin;
+//#endregion
+//#region src/release/plugin.d.ts
+/**
+ * Lists the options of the release plugin.
+ */
+export interface ReleaseOptions {
+  /**
+   * Path from the package's directory to the module that exports the plugin's manifest. The plugin
+   * reads `src/manifest.ts` when the option is left out.
+   */
+  readonly manifest?: string | undefined;
+}
+/**
+ * Path from the package's directory to the directory that the build writes a release to. The
+ * directory is beside `dist`, because a pack empties `dist` before it writes.
+ */
+export declare const RELEASE_DIRECTORY = "dist-release";
+/**
+ * Creates the plugin that builds a plugin's web package as a release.
+ *
+ * @remarks
+ *   The build is a library build whose one entry is the module that exports the manifest. The build
+ *   keeps every import of a provided specifier as an import by name, and the page's import map
+ *   resolves it. It calls each lazy import of a module of the release through `preloaded` of
+ *   `@stealthscale/sdk-core`. `preloaded` passes the module's URL to the page's preloader before
+ *   the import. The build fails on an import of a provided package that the page does not map. It
+ *   also fails on a stylesheet or any other file that is not a module. The plugin writes the
+ *   catalogue of the plugin's namespace in each language as `locales/<language>.json`. It writes
+ *   `plugin.json` with the plugin's id and version, its languages, each module's static imports,
+ *   the caret range of each provided package it imports, and the integrity of every other file. It
+ *   fails a package whose preset declares a recipe.
+ * @param options - The manifest module's path.
+ */
+export declare function release(options?: ReleaseOptions): Plugin;
+//#endregion
+export type { AppPage, StandalonePage };