Skip to content

0.22.0: dist-web's page is the one distributable, a runner named web serves it, and the engine is told the program it wraps - #54

Merged
Sunrisepeak merged 4 commits into
mainfrom
fix/0.21.1-web
Nov 15, 2026
Merged

Sunrisepeak merged 4 commits into
mainfrom
fix/0.21.1-web

Conversation

@Sunrisepeak

Copy link
Copy Markdown
Member

The page's step takes every copied file as an input, so the page is the
format's one distributable and `mcpp run --pkg-format web' is handed it; 0.21.0
declared each copied file a distributable, and the engine refused to choose.
The page's source is written to <out_dir>/.dist-web/-.in, not
beside the build's outputs as -index.html, where it was opened as the
product and loaded nothing. When the directory is declared, a note names it
and says how it is opened: a browser loads the module only over HTTP.

options::runner' (default true) declares a long-lived runner named web':
emrun from the resolved Emscripten toolchain (emrun.bat on Windows), given
--hostname localhost' and the page. mcpp run --pkg-format web' serves the
directory on this machine with the types a browser requires, opens the page,
and serves until the operator ends it. Another browser, port or address is a
machine's choice, made by replacing the runner in its config.toml.

docs/dist.md states that link arguments are not a function of the package
format: `mcpp pack' stages the program the build linked; a link difference is
a profile's. tests/web-consumer asserts the one distributable, the note, the
runner and what it serves.

…web serves it

The page's step takes every copied file as an input, so the page is the
format's one distributable and `mcpp run --pkg-format web' is handed it; 0.21.0
declared each copied file a distributable, and the engine refused to choose.
The page's source is written to <out_dir>/.dist-web/<target>-<page>.in, not
beside the build's outputs as <target>-index.html, where it was opened as the
product and loaded nothing. When the directory is declared, a note names it
and says how it is opened: a browser loads the module only over HTTP.

`options::runner' (default true) declares a long-lived runner named `web':
emrun from the resolved Emscripten toolchain (emrun.bat on Windows), given
`--hostname localhost' and the page. `mcpp run --pkg-format web' serves the
directory on this machine with the types a browser requires, opens the page,
and serves until the operator ends it. Another browser, port or address is a
machine's choice, made by replacing the runner in its config.toml.

docs/dist.md states that link arguments are not a function of the package
format: `mcpp pack' stages the program the build linked; a link difference is
a profile's. tests/web-consumer asserts the one distributable, the note, the
runner and what it serves.
@Sunrisepeak Sunrisepeak changed the title 0.22.0: dist-web's page is the one distributable, and a runner named web serves it 0.22.0: dist-web's page is the one distributable, a runner named web serves it, and the engine is told the program it wraps Nov 15, 2026
@Sunrisepeak
Sunrisepeak merged commit 0f1fa1a into main Nov 15, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant