Triggers on push to main and repository_dispatch el-sdk-updated.
Installs El SDK from foundation-prod Artifact Registry (Gitea fallback),
builds el-platform vessel, publishes to Gitea latest release and
foundation-prod Artifact Registry, then dispatches ui-updated to el-ide.
Bumps spec version to 1.2.0.
Documents:
- SSR engine in runtime/src/ssr.js (Node.js, fully implemented)
- Hydration markers (data-el-component, data-el-id, data-el-state)
- hydrate() vs mount() and when to use each
- Full SSR + hydration lifecycle with code examples
- elc-ui CLI --target=server and --target=web flags
- Section 11: complete SSR + hydration walkthrough
- Section 12: versioning roadmap updated to reflect v0.1 actual state
- Section 9: clarifies that SSR is JS-implemented, Rust PlatformBackend is planned
Counter.el defines Counter, CounterPair, and App components with {#if}
conditionals, event handlers, and child component composition.
render.js (generated by elc-ui --target=server) is the Node.js render
script the server calls. app.js (generated by elc-ui --target=web) is the
compiled browser module. hydrate.js attaches the runtime to the
server-rendered DOM without replacing it.
index.html shows the integration point with instructions for injecting
server output and the two CLI commands needed to regenerate both targets.
elc-ui is a Node.js compiler CLI that reads .el component files and emits
either a browser ES2022 module (web target) or a Node.js CJS render script
(server target).
The server target embeds the component source at compile time and exports
renderToString(componentName, props) -> HTML string, which any El web server
can require() and call. CLI mode (node render.js ComponentName propsJson)
lets the web server invoke it via exec() as a subprocess.
The web target emits class-per-component JS matching the hand-compiled
format, so compiler output and hand-written components are interchangeable.
Adds runtime/src/ssr.js: a Node.js SSR engine that parses .el component
source and renders to HTML strings without a DOM. Covers the full template
AST -- elements, text, interpolations, {#if}, {#each}, {#activate}, and
child component recursion.
Every component root element receives hydration markers:
data-el-component, data-el-id, data-el-state
Event bindings (on:click etc.) are preserved as data-el-* attributes so
the client hydration pass can bind them without re-rendering.
Updates Component base class with:
- initialState constructor param for SSR state recovery
- _hydrate(root): binds events on existing DOM, no re-render
- onHydrate() lifecycle hook
Updates dist/el-ui.js bundle to match.
Belated rename commit for foundation/el-ui — was missed in the
workspace-wide crates→vessels pass earlier today. Same structural
intent as the rename in the other repos: 'crates' is the Rust word,
'vessel' is El's, and the directory rename is the marker that this
slot holds an El buildable unit even if its current contents are
still Rust pending port.
Plus the El ports themselves — manifest.el + src/main.el per sub-
vessel (el-aop, el-auth, el-config, el-i18n, el-identity, el-layout,
el-platform, el-publish, el-secrets, el-services, el-style, el-ui-
compiler). The ui-compiler is a stub: elc only emits C right now;
generating browser-target JS/Wasm is the biggest open language gap
and gets its own project. Until then, el-ui-compiler emits a JS
module that throws elc.backend_missing so callers fail loudly.
Cross-repo path dependencies in Cargo.toml updated to vessels/.
Will Anderson