# kcode-web-libs
`kcode-web-libs` is a compact synchronous Rust library for creating, opening,
completely replacing, validating, and publishing small buildless Web libraries.
Alongside UTF-8 HTML, CSS, JavaScript, JSON, and Markdown, a library can retain
opaque assets such as fonts and images without base64 conversion.
Filename extensions distinguish text from opaque assets; generations need no
private asset index. The crate does not impose project-policy file-count or
byte-size ceilings.
Each managed library contains `Documentation.md`, an entry module, a test module, and `kcode-web.json`:
```json
{
"name": "example",
"version": "0.1.0",
"entry": "index.js",
"tests": "tests.js"
}
```
A check materializes exactly the current in-memory source, starts a temporary
loopback server, imports the entry in headless Chromium, imports the test module,
and awaits its exported `runTests()` function. The module owns its assertions,
test setup, and any test-mode API substitutes.
A successful publication installs the exact checked tree once at:
```text
<publications_root>/module/<name>/v<version>/
```
Published name/version pairs are immutable. The caller supplies separate
managed-source and publication roots and ensures a Chromium-compatible
executable is available as `chromium` on `PATH`. The crate never stores
publication artifacts beneath the source root. The caller also owns Ktool
adaptation, production HTTP routing, floating version aliases, application
selection, deployment, and rollback.
Each publication rechecks the current in-memory text and asset tree, then writes
and synchronizes another independent complete copy with exact asset bytes.
Publication does not deduplicate files or replace a previously published exact
version.
See `Documentation.md` for the complete Rust API.