WORK-293
Setting up your dashboard 0 entities found · 9/32 branches scanned
ID:WORK-293Status:ready

Ship the client behaviors bundle in the html scaffold

The @refrakt-md/html scaffold (create-refrakt template-html) emits static HTML with no client JS — build.ts never bundles or references initPage() from @refrakt-md/html/client. So no interactive behavior runs in a scaffolded html site: tabs, accordion, search, and (since SPEC-073) the theme-toggle button are all inert. The adapter ships the client runtime (@refrakt-md/html/client + @refrakt-md/behaviors); the scaffold just never bundles and includes it.

Discovered while finishing WORK-292: the html adapter now injects the no-flash pre-paint script (which works without JS), but the toggle can't cycle until the behaviors bundle loads. This is broader than the toggle — it's the html scaffold's general interactivity gap.

Priority:mediumComplexity:moderateMilestone:v0.18.0Source:SPEC-073
claude/spec-079-implementation View source

Criteria completion

Criteria completion: 0 of 4 (0%) checked; tracking started on Jun 2, no incremental history yet0%25%50%75%100%Jun 2Jun 15

Tracking started Jun 2 — check back for trends.

Relationships

Related 5
Branches 7
claude/spec-079-implementation current ready
changeset-release/main reviewclaude/v0.21-registry-sandbox-milestone readyclaude/work-293-html-scaffold-client reviewmain reviewclaude/v0.20.1-docs-showcase-plan readyclaude/rune-contract-hardening readyclaude/v0.16.0 ready
History 1
  1. 2d85b5f
    Created (ready)by bjornolofandersson

Acceptance Criteria

  • template-html's build produces a client bundle that calls initPage() from @refrakt-md/html/client (e.g. an esbuild/rollup step over a small entry, output to build/).
  • build.ts references the bundle via renderFullPage's scripts option so every page loads it.
  • A scaffolded html site has working interactive runes — verified with at least the theme-toggle (cycles auto→light→dark) and one other behavior (e.g. tabs or search) in a browser.
  • Layout chrome CSS (header/search/theme-toggle) is shipped by the scaffold so the controls are styled, not just present.

Approach

Add a tiny client entry (import { initPage } from '@refrakt-md/html/client'; initPage();) and a bundling step to template-html (esbuild is lightest), emit to build/client.js, and pass scripts: ['/client.js'] to renderFullPage. Confirm the tree-shaken CSS includes the layout chrome stylesheets (or ship the theme barrel) so .rf-theme-toggle / .rf-search-trigger are styled.

References

  • SPEC-073
  • WORK-292 surfaced this gap (plain reference, not a dependency) — the no-flash injection landed there, but interactive cycling needs this bundle.