@livx.cc/bare-v3 0.1.0-alpha.10

package/README.md

@@ -0,0 +1,39 @@
+# bare-v3
+
+Experimental semantic styling and a standalone design evaluation lab for Composer. **No strategy winner has been established.** An opt-in, source-pinned Blank integration experiment is underway; release readiness and default-strategy selection still require qualification.
+
+```sh
+bun install --frozen-lockfile
+bun run build
+bun test
+bun run typecheck
+bun run check:package
+bun lab serve       # authored fixtures on localhost:4313
+bun lab compare     # comparison UI on localhost:4314
+bun lab replay <run-id> # verifies saved app hashes, then serves its isolated preview
+```
+
+The comparison UI needs the fixture server for example links. Model outputs replay on separate local origins. Replay refuses missing or mismatched artifact hashes. `bun lab verify-evidence evidence.json protocol.json` checks recorded measurements against the protocol viewport and verifies the referenced PNG file, size, and hash. For matched captures, declare `viewport.expectedPresentation` with `theme`, `rootFontSize` and `direction`; the browser probe records these values and missing or mismatched values fail validation. The theme measurement uses the explicit bare-v3 root attribute; other strategy adapters must map their own theme mechanism rather than guess. It does not judge visual quality or declare release qualification. Run artifacts and judgments live under ignored `artifacts/`; retain that directory when sharing evidence. Browser/model tooling is development-only and excluded from the packed consumer.
+
+Install the published alpha with `bun add @livx.cc/bare-v3@alpha`; use `bun pm pack` for an unpublished local build. Import CSS from `@livx.cc/bare-v3/css` or `/css/min`. Put `class="b3-root"` on html and set `data-b3-theme="dark"` explicitly for dark mode. Component references are exported under `/references/*.md`; start with `/references/start.md`. Place generic link defaults in `@layer bare.reset` so they do not override button/navigation colors. Unlayered consumer CSS overrides library layers: scope custom palette colors to each theme rather than applying light-only colors unconditionally to `:root`.
+
+`bun lab plan config.json` creates a seeded, capped development job plan. `bun lab prepare run.json` prepares one isolated workspace and manifest without invoking a model. The [visual playground](http://127.0.0.1:4313/fixtures/playground.html) demonstrates the current component contracts and shows the bare-v2 coverage audit. Composed apps include Signal (system performance), Elsewhere (local discovery/booking), Daylight (iOS/Android web studies), Relay, Gather setup and sign-in, Counter, Margin, Still, Fieldnotes, Interval, and the Forma project workspace. New components are an implemented subset, not full bare-v2 parity or a qualified release. Optional interactions are exported from `@livx.cc/bare-v3/ui`; call `mount(document)` once and use its returned cleanup on teardown.
+
+Playground previews accept shareable app/width links, for example [Signal at 390px](http://127.0.0.1:4313/fixtures/playground.html?demo=metrics&width=390#demos). The controls keep these query parameters in sync; unknown values fall back to the authored defaults. This is an iframe layout preview, not mobile-device qualification.
+
+Source organization: `src/bare.css` is the ordered CSS entry; `src/styles/` groups foundations, layouts, and component families. Base rules and later state rules stay separate to preserve cascade order. `src/ui.js` mounts the focused modules in `src/interactions/`. Each app lives in `fixtures/demos/<name>/{index.html,styles.css,app.js}`. The playground shell and behavior live in `fixtures/playground/`, with individual HTML specimens in `specimens/`. Edit those sources, then run `bun run build`; the build assembles the ignored `fixtures/*.html` pages at their existing URLs. Package consumers still receive bundled CSS and one optional ESM interaction entry. This organization supports focused reads and changes; model context-efficiency gains remain to be measured.
+
+External TypeScript entrypoints use `<script type="module" src="app.ts">`. Assembly bundles local imports into a separate rendered artifact, preserves the original source, and rejects imports outside the workspace. Replay serves the rendered artifact. Inline TypeScript and package imports are not supported.
+
+Standalone matched app generation remains pending: the worker now invokes the pinned agentx CLI; verify configuration isolation and its complete bounded execution path live before qualification. Composer use is authorized through agentx, with app generation sequenced after the requested visual review. Browser verification already uses Composer through agentx. No live app-generation batch has run.
+
+The 24 briefs are provisional. Authored fixtures are implementation probes, not blind model evidence. Browser checks cover selected journeys across the authored apps, including themes, persistence, forms, command keyboard behavior, outlines, and narrow viewport emulation. The current evidence and remaining gaps are tracked in the implementation plan. A dedicated mobile-app track now requires matched iOS/Android routines flows, discovery/booking and mobile conversation, with separate native-look and actual-device gates. Actual iOS/Android, full accessibility, populated comparisons in the browser, and held-out qualification remain pending.
+
+See the [working task board](tasks.md), [implementation plan](docs/plan.md) and [experiment ledger](lab/experiments/ledger.json). The source repository is private. Public npm alpha.5 is published and installed in the [production Offscript experiment](https://blank.bodify.bod.ee/a/a-offscript-v3). See tasks.md for qualification status; source may advance to the next unpublished prerelease.
+
+Playground work: edit one specimen in `fixtures/playground/specimens/`, its focused controller in `controllers/`, or a demo’s own folder. `app.js` only assembles controllers. Code/model guidance opens beside the relevant specimen. The expanded reference-page experiment is archived in `archive/reference-2026-09-08/` and excluded from normal builds.
+
+
+[Icon explorer](http://127.0.0.1:4313/fixtures/playground.html#icons): full pinned Lucide family, semantic search, paged results, SVG preview/copy and attribution. Generated from the dev-only lucide-static package by scripts/icons.ts; no sibling checkout or CDN is required. Blank has a smaller supported host catalog: copied SVG remains portable, but host calls must use names Blank actually supplies.
+
+[Motion & delight](http://127.0.0.1:4313/fixtures/playground.html#motion): six composed motion studies plus collapsed functional feedback recipes, reduced-motion preview and contextual usage. The optional UI export includes semantic motion intents, `layout`, `sequence` and `settle`; update real state first and use motion to explain it. Dialog entry/exit/drag remains owned by the mounted overlay helper. These examples do not replace full app, device, accessibility or quality evaluation.