@ponchia/ui 0.6.3 → 0.6.5

package/llms.txt

@@ -9,7 +9,9 @@
 > This file orients an LLM/agent. The authoritative, always-correct API
 > is the TypeScript declarations shipped in this package (paths below):
 > they are generated from the runtime sources and CI-drift-checked, so
-> they never lie. Read them before guessing class or token names.
+> they never lie. Read them before guessing class or token names. For the
+> manifest-level inventory, use `docs/package-contract.md`: it is generated
+> from package.json and lists every export, shipped path, and provenance gate.
 
 ## Use the framework
 
@@ -42,7 +44,7 @@ the path changes from source `css/` to built `dist/css/`:
 <!-- installed locally -->
 <link rel="stylesheet" href="./node_modules/@ponchia/ui/dist/css/<leaf>.css" />
 <!-- or from a CDN; pin the version (pre-1.0, breaking changes ship in the minor) -->
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.3/dist/css/<leaf>.css" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@ponchia/ui@0.6.5/dist/css/<leaf>.css" />
 ```
 
 The flattened default bundle is `dist/bronto.css` (bundler shorthand
@@ -76,6 +78,11 @@ role/aria-modal); `initDisabledGuard()` makes every `aria-disabled` control
 keyboard-inert (CSS alone is only pointer-inert). For the value-bearing fills,
 `attrs.meter(value)` / `attrs.progress(value)` from `@ponchia/ui/classes` return
 `role`+`aria-valuenow/min/max`+the `--value` style to spread onto the host.
+`initSources()` wires `[data-bronto-sources]` citation/source islands:
+`.ui-citation[href^="#"]` and `[data-bronto-source-ref]` focus/highlight the
+matching `.ui-source-card`, seed lightweight preview metadata, and emit
+`bronto:source:focus`; the host still owns numbering, fetching, trust decisions,
+and any rich preview popover.
 
 For React/Solid/Qwik, optional thin hook bindings over those behaviors (peer
 deps `react` / `solid-js` / `@builder.io/qwik`, optional — core stays zero-dep):
@@ -87,13 +94,21 @@ import { useDialog, useToast } from '@ponchia/ui/react'; // or '@ponchia/ui/soli
 ```
 
 Optional display glyphs — dot-matrix bitmaps on the `.ui-dotmatrix` primitive
-(decorative by default; `renderGlyph` is SSR-safe, `initDotGlyph` is the DOM form):
+(decorative by default; `renderGlyph` is SSR-safe, `initDotGlyph` is the DOM form).
+`findGlyphs('delete')` resolves an intent word to real names; `renderReadout`
+composes digits into a big Nothing-style numeric. Details: `docs/glyphs.md`.
 
 ```js
-import { renderGlyph, GLYPH_NAMES } from '@ponchia/ui/glyphs';
+import { renderGlyph, findGlyphs, renderReadout, GLYPH_NAMES } from '@ponchia/ui/glyphs';
 el.innerHTML = renderGlyph('check', { label: 'Done' });
+el.innerHTML = renderReadout('73%', { label: '73 percent of quota' });
 ```
 
+The dot family also has data-bound reporting surfaces — `.ui-waffle` (unit
+chart), `.ui-activity` (contribution grid), `.ui-level` (LED meter),
+`.ui-dotgauge` (radial gauge), `.ui-halftone`, `.ui-readout` — same host-sets-
+the-data / leaf-paints boundary as `ui-spark`/`ui-meter`. Details: `docs/dots.md`.
+
 Layout primitives (core bundle, no media queries — intrinsic Every-Layout
 composition that responds to content + available space): `ui-stack` (vertical
 rhythm), `ui-cluster` (wrapping inline row), `ui-grid` (auto-fit columns),
@@ -554,6 +569,7 @@ specifiers only work after a bundler rewrites them:
 <link rel="stylesheet" href="./node_modules/@ponchia/ui/dist/bronto.css" />
 <link rel="stylesheet" href="./node_modules/@ponchia/ui/dist/css/report.css" />
 <link rel="stylesheet" href="./node_modules/@ponchia/ui/dist/css/dataviz.css" />
+<link rel="stylesheet" href="./node_modules/@ponchia/ui/dist/css/sources.css" />
 ```
 
 In Vite/webpack/etc., import `@ponchia/ui`, `@ponchia/ui/css/report.css`, and
@@ -577,25 +593,59 @@ Canonical report skeleton:
     <div class="ui-report__summary">
       <div class="ui-prose"><p>Use prose only for narrative body content.</p></div>
     </div>
+    <aside class="ui-report__decision" aria-labelledby="decision-title">
+      <p class="ui-report__decision-kicker">Decision</p>
+      <h3 class="ui-report__decision-title" id="decision-title">Ship the low-risk path</h3>
+      <p class="ui-report__decision-body">State the operator-facing call before the evidence.</p>
+      <dl class="ui-report__decision-grid">
+        <div class="ui-report__decision-item">
+          <dt class="ui-report__decision-label">Basis</dt>
+          <dd class="ui-report__decision-value">Two verified sources support the call.</dd>
+        </div>
+      </dl>
+      <p class="ui-report__decision-meta">Evidence state: supported · Sources: 4 verified</p>
+    </aside>
   </section>
 </main>
 ```
 
-Report rules for agents: static output by default; do not initialize behaviors
-over untrusted generated content; sanitize arbitrary LLM/CMS/user HTML before
-rendering; use semantic headings; give tables captions and header cells; give
-charts captions, legends/direct labels, and fallback data; for a chart, theme
-Vega-Lite with `@ponchia/ui/vega` (or hand-author a token-themed inline `<svg>`)
-inside a `ui-report__figure` — bronto ships no chart component; use
-`ui-delta` (`--up`/`--down`/`--flat`, `--invert` when up is bad) for a
-trend figure and `ui-compare` (`--2up`) for an A/B / before-after section; use
-`ui-report__section--unnumbered` for appendices in numbered reports; never
-use raw chromatic inline colors. Format numbers/dates yourself (the framework
-aligns figures, it does not format them) — see the reporting cookbook. To make
-a PDF, render with `chrome-headless-shell` (or any Chromium) using
-`printBackground: true` so figure fills survive — reports are static/zero-JS, so
-it is just load → print; see "Print and PDF" in `docs/reporting.md`. Full
-cookbook: `docs/reporting.md`.
+Report rules for agents:
+
+- Static output by default; do not initialize behaviors over untrusted generated
+  content; sanitize arbitrary LLM/CMS/user HTML before rendering.
+- Use semantic headings; give tables captions and header cells; give charts
+  captions, legends/direct labels, and fallback data.
+- For a chart, theme Vega-Lite with `@ponchia/ui/vega` or hand-author a
+  token-themed inline `<svg>` inside a `ui-report__figure`. Bronto ships no
+  chart component.
+- Put the above-the-fold call in `ui-report__decision`; use
+  `ui-report__finding--critical|--major|--minor|--resolved` only when the
+  written finding label also states the severity/status.
+- Use `ui-claim` (`--supported|--partial|--disputed|--unsupported|--unknown`)
+  for auditable claims. Pair it with written `ui-claim__status`, source links,
+  scope, basis, limits, and caveats; tone is only a scanning aid.
+- Use `ui-evidence-grid` / `ui-evidence-item` for compact evidence packets and
+  `ui-evidence-ledger` + `ui-table` for claim/evidence/source matrices.
+- Use `ui-report__actions` for follow-up rows. Real workflow actions should
+  include title, owner, due/recheck date, status, criteria, and source/claim
+  link when available.
+- Use `ui-source-card` + `ui-provenance` for source-backed claims; stale,
+  conflicting, unverified, or generated inputs should be surfaced near affected
+  claims, not only in the source appendix.
+- For important reports, emit a sidecar `claims.json` / source archive manifest
+  with stable claim IDs, source IDs, status, risk, retrieval time, and
+  claim-source relations. The visible HTML remains the primary artifact, but the
+  sidecar lets tools prove IDs and high-risk evidence still resolve.
+- Use `ui-delta` (`--up`/`--down`/`--flat`, `--invert` when up is bad) for a
+  trend figure and `ui-compare` (`--2up`) for an A/B / before-after section.
+- Use `ui-report__section--unnumbered` for appendices in numbered reports.
+  Never use raw chromatic inline colors. Format numbers/dates yourself (the
+  framework aligns figures, it does not format them).
+- To make a PDF, render with `chrome-headless-shell` (or any Chromium) using
+  `printBackground: true` so figure fills survive. Reports are static/zero-JS,
+  so it is just load → print; see "Print and PDF" in `docs/reporting.md`.
+
+Full cookbook: `docs/reporting.md`.
 
 ## Authoritative offline references (shipped in this package)
 
@@ -624,8 +674,8 @@ Read these from `node_modules/@ponchia/ui/` — no network needed:
   density, prose-in-card, when to add a behavior. Read this before
   re-implementing UI the framework already has an opinion about.
 - `docs/reporting.md` — static/PDF-first report cookbook for LLM-authored
-  reports, including report skeletons, chart rules, print utilities, and safety
-  boundaries.
+  reports, including report skeletons, decision/finding/evidence patterns,
+  chart rules, print utilities, and safety boundaries.
 - `docs/annotations.md` — SVG annotation recipes and helper guidance for
   analytical figures.
 - `docs/mermaid.md` — theme Mermaid diagrams from bronto tokens (resolved
@@ -673,10 +723,14 @@ Read these from `node_modules/@ponchia/ui/` — no network needed:
   (§"Table-local state classes" / §"Composition & state") and emitted by the
   `ui.*()` recipes, but deliberately NOT in `cls`. Do not strip them.
 - Prefer the `ui.*()` recipes over hand-concatenating modifier strings.
-  Report/layout classes added in 0.4.1 are the exception: use `cls.report*`,
-  `cls.chart*`, `cls.printOnly`, or literal documented class names because
-  there are no `ui.report()` / `ui.chart()` recipes yet. Annotations do have a
-  `ui.annotation()` recipe for variant/tone selection.
+  Report/layout classes are mostly literal (`cls.report*`, `cls.printOnly`,
+  `ui-evidence-grid`, `ui-evidence-ledger`, `ui-evidence-item`,
+  `ui-evidence-item__title`, `ui-evidence-item__meta`, and
+  `ui-evidence-item__body`); use `ui.reportFinding({ severity })` for finding
+  severity, `ui.claim({ status })` for claim status, and
+  `ui.compare({ cols: 2 })` for hard A/B layouts. Bronto still has no chart
+  recipe or component. Annotations do have a `ui.annotation()` recipe for
+  variant/tone selection.
 - For a standalone HTML report, never `<link>` a `@ponchia/ui/css/*.css`
   package specifier (it does not resolve in a browser) and never assume
   `dist/bronto.css` carries the report/chart/legend/annotation layers — it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ponchia/ui",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "type": "module",
   "description": "CSS-first design system for interfaces that explain themselves — works in HTML, every framework, and PDF, no component runtime. A standard component set plus an opt-in analytical & report layer (annotations, legends, connectors, data-viz, report grammar). Monochrome with one rationed accent, re-skinnable from one --accent knob. Zero runtime dependencies.",
   "keywords": [
@@ -63,8 +63,12 @@
     "docs/theming.md",
     "docs/contrast.md",
     "docs/stability.md",
+    "docs/package-contract.md",
     "docs/usage.md",
+    "docs/frontier-primitives.md",
     "docs/reporting.md",
+    "docs/dots.md",
+    "docs/glyphs.md",
     "docs/mermaid.md",
     "docs/d2.md",
     "docs/vega.md",
@@ -118,6 +122,7 @@
     "d2:build": "node scripts/gen-d2.mjs",
     "vega:build": "node scripts/gen-vega.mjs",
     "reference:build": "node scripts/gen-reference.mjs",
+    "package-contract:build": "node scripts/gen-package-contract.mjs",
     "classes:json:build": "node scripts/gen-classes-json.mjs",
     "contrast:build": "node scripts/gen-contrast.mjs",
     "vscode:build": "node scripts/gen-vscode-data.mjs",
@@ -143,14 +148,15 @@
     "check:pack": "node scripts/check-pack.mjs",
     "check:release": "node scripts/check-release.mjs",
     "check:versions": "node scripts/check-versions.mjs",
+    "check:public-metadata": "node scripts/check-public-metadata.mjs",
     "check:doc-recipes": "node scripts/check-doc-recipes.mjs",
     "check:contract": "node scripts/check-contract.mjs",
     "check:contrast": "node scripts/check-contrast.mjs",
     "check:publint": "publint --strict",
     "check:attw": "attw --pack --ignore-rules no-resolution cjs-resolves-to-esm",
-    "check": "npm run lint && npm run check:format && npm run check:exports && npm run check:fresh && npm run check:classes && npm run check:recipe-types && npm run check:types && npm run check:shiki && npm run check:dist && npm run check:pack && npm run check:publint && npm run check:attw && npm run check:release && npm run check:versions && npm run check:doc-recipes && npm run check:contract && npm run check:contrast && npm run check:dts-emit && npm run check:glyphs && npm run check:color-policy && npm run check:skins && npm run check:charts && npm run check:mermaid && npm run check:d2 && npm run check:vega && npm run check:report && npm run check:legend && npm run check:chain",
+    "check": "npm run lint && npm run check:format && npm run check:exports && npm run check:fresh && npm run check:classes && npm run check:recipe-types && npm run check:types && npm run check:shiki && npm run check:dist && npm run check:pack && npm run check:publint && npm run check:attw && npm run check:release && npm run check:versions && npm run check:public-metadata && npm run check:doc-recipes && npm run check:contract && npm run check:contrast && npm run check:dts-emit && npm run check:glyphs && npm run check:color-policy && npm run check:skins && npm run check:charts && npm run check:mermaid && npm run check:d2 && npm run check:vega && npm run check:report && npm run check:legend && npm run check:chain",
     "test": "node --test \"test/*.test.mjs\"",
-    "prepack": "npm run tokens:css:build && npm run tokens:build && npm run dtcg:build && npm run resolved:build && npm run dts:build && npm run dts:emit && npm run reference:build && npm run classes:json:build && npm run contrast:build && npm run vscode:build && npm run skins:build && npm run charts:build && npm run mermaid:build && npm run d2:build && npm run vega:build && npm run dist:build && npm run glyphs:build",
+    "prepack": "npm run tokens:css:build && npm run tokens:build && npm run dtcg:build && npm run resolved:build && npm run dts:build && npm run dts:emit && npm run reference:build && npm run package-contract:build && npm run classes:json:build && npm run contrast:build && npm run vscode:build && npm run skins:build && npm run charts:build && npm run mermaid:build && npm run d2:build && npm run vega:build && npm run dist:build && npm run glyphs:build",
     "prepublishOnly": "npm run check && npm test"
   },
   "devDependencies": {
@@ -289,8 +295,12 @@
     "./docs/theming.md": "./docs/theming.md",
     "./docs/contrast.md": "./docs/contrast.md",
     "./docs/stability.md": "./docs/stability.md",
+    "./docs/package-contract.md": "./docs/package-contract.md",
     "./docs/usage.md": "./docs/usage.md",
+    "./docs/frontier-primitives.md": "./docs/frontier-primitives.md",
     "./docs/reporting.md": "./docs/reporting.md",
+    "./docs/dots.md": "./docs/dots.md",
+    "./docs/glyphs.md": "./docs/glyphs.md",
     "./docs/mermaid.md": "./docs/mermaid.md",
     "./docs/d2.md": "./docs/d2.md",
     "./docs/vega.md": "./docs/vega.md",

package/qwik/index.d.ts

@@ -25,6 +25,7 @@ export function useConnectors(opts?: BrontoBindingOptsResolver): void;
 export function useSpotlight(opts?: BrontoBindingOptsResolver): void;
 export function useCrosshair(opts?: BrontoBindingOptsResolver): void;
 export function useCommand(opts?: BrontoBindingOptsResolver): void;
+export function useSources(opts?: BrontoBindingOptsResolver): void;
 export function useToast(): (message: string, opts?: ToastOpts) => Cleanup;
 export { applyStoredTheme };
 export type Cleanup = import("../behaviors/index.js").Cleanup;

package/qwik/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":"AAgHA;;;;;;sBAMsB;AACtB,wCAHY,CAAC,IAAI,CAAC,EAAE,YAAY,KAAK,OAAO,GAAG,IAAI,SACvC,yBAAyB,GACvB,IAAI,CAIjB;AAGM,sCADK,yBAAyB,CAAC,gBAAgB,GAAG,YAAY,CAAC,GAAmB,IAAI,CAGhC;AAEtD,sCADK,yBAAyB,GAAmB,IAAI,CAGH;AAElD,wCADK,yBAAyB,GAAmB,IAAI,CAGG;AAExD,qCADK,yBAAyB,GAAmB,IAAI,CAGA;AAErD,+BADK,yBAAyB,GAAmB,IAAI,CAGN;AAE/C,yCADK,yBAAyB,GAAmB,IAAI,CAGI;AAEzD,mCADK,yBAAyB,GAAmB,IAAI,CAGF;AAEnD,kCADK,yBAAyB,GAAmB,IAAI,CAGH;AAElD,oCADK,yBAAyB,GAAmB,IAAI,CAGD;AAEpD,+BADK,yBAAyB,GAAmB,IAAI,CAGN;AAE/C,iCADK,yBAAyB,GAAmB,IAAI,CAGJ;AAEjD,gCADK,yBAAyB,GAAmB,IAAI,CAGL;AAEhD,mCADK,yBAAyB,GAAmB,IAAI,CAGF;AAEnD,mCADK,yBAAyB,GAAmB,IAAI,CAGF;AAEnD,iCADK,yBAAyB,GAAmB,IAAI,CAGJ;AAEjD,qCADK,yBAAyB,GAAmB,IAAI,CAGA;AAErD,oCADK,yBAAyB,GAAmB,IAAI,CAGD;AAEpD,oCADK,yBAAyB,GAAmB,IAAI,CAGD;AAEpD,kCADK,yBAAyB,GAAmB,IAAI,CAGH;AAIlD,4BADO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,KAAK,OAAO,CACzB;;sBAhLtB,OAAO,uBAAuB,EAAE,OAAO;2BACvC,OAAO,uBAAuB,EAAE,YAAY;+BAC5C,OAAO,uBAAuB,EAAE,gBAAgB;wBAChD,OAAO,uBAAuB,EAAE,SAAS;gCAEzC,QAAQ,GACd,OAAO,GACP;IAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,GAChD;IAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,GAClD,CAAC,MAAM,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GAC7C,IAAI,GACJ,SAAS;8BAIa,CAAC,SAAhB,YAAa,sDACd,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,iBAAiB,CAAA;CAAE;sCAI9B,CAAC,SAAhB,YAAa,sDACd,iBAAiB,CAAC,CAAC,CAAC,GAC1B,CAAC,MAAM,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAC/C,IAAI,GACJ,SAAS;iCAyBT,uBAAuB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":"AAiHA;;;;;;sBAMsB;AACtB,wCAHY,CAAC,IAAI,CAAC,EAAE,YAAY,KAAK,OAAO,GAAG,IAAI,SACvC,yBAAyB,GACvB,IAAI,CAIjB;AAGM,sCADK,yBAAyB,CAAC,gBAAgB,GAAG,YAAY,CAAC,GAAmB,IAAI,CAGhC;AAEtD,sCADK,yBAAyB,GAAmB,IAAI,CAGH;AAElD,wCADK,yBAAyB,GAAmB,IAAI,CAGG;AAExD,qCADK,yBAAyB,GAAmB,IAAI,CAGA;AAErD,+BADK,yBAAyB,GAAmB,IAAI,CAGN;AAE/C,yCADK,yBAAyB,GAAmB,IAAI,CAGI;AAEzD,mCADK,yBAAyB,GAAmB,IAAI,CAGF;AAEnD,kCADK,yBAAyB,GAAmB,IAAI,CAGH;AAElD,oCADK,yBAAyB,GAAmB,IAAI,CAGD;AAEpD,+BADK,yBAAyB,GAAmB,IAAI,CAGN;AAE/C,iCADK,yBAAyB,GAAmB,IAAI,CAGJ;AAEjD,gCADK,yBAAyB,GAAmB,IAAI,CAGL;AAEhD,mCADK,yBAAyB,GAAmB,IAAI,CAGF;AAEnD,mCADK,yBAAyB,GAAmB,IAAI,CAGF;AAEnD,iCADK,yBAAyB,GAAmB,IAAI,CAGJ;AAEjD,qCADK,yBAAyB,GAAmB,IAAI,CAGA;AAErD,oCADK,yBAAyB,GAAmB,IAAI,CAGD;AAEpD,oCADK,yBAAyB,GAAmB,IAAI,CAGD;AAEpD,kCADK,yBAAyB,GAAmB,IAAI,CAGH;AAElD,kCADK,yBAAyB,GAAmB,IAAI,CAGH;AAIlD,4BADO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,KAAK,OAAO,CACzB;;sBArLtB,OAAO,uBAAuB,EAAE,OAAO;2BACvC,OAAO,uBAAuB,EAAE,YAAY;+BAC5C,OAAO,uBAAuB,EAAE,gBAAgB;wBAChD,OAAO,uBAAuB,EAAE,SAAS;gCAEzC,QAAQ,GACd,OAAO,GACP;IAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,GAChD;IAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,GAClD,CAAC,MAAM,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GAC7C,IAAI,GACJ,SAAS;8BAIa,CAAC,SAAhB,YAAa,sDACd,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,iBAAiB,CAAA;CAAE;sCAI9B,CAAC,SAAhB,YAAa,sDACd,iBAAiB,CAAC,CAAC,CAAC,GAC1B,CAAC,MAAM,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAC/C,IAAI,GACJ,SAAS;iCA0BT,uBAAuB"}

package/qwik/index.js

@@ -73,6 +73,7 @@ import {
   initSpotlight,
   initCrosshair,
   initCommand,
+  initSources,
   toast,
 } from '../behaviors/index.js';
 
@@ -198,6 +199,10 @@ export const useCrosshair = (opts) =>
 export const useCommand = (opts) =>
   // eslint-disable-next-line qwik/no-use-visible-task -- delegated DOM glue + cleanup
   useVisibleTask$((ctx) => start(initCommand, opts, ctx));
+/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
+export const useSources = (opts) =>
+  // eslint-disable-next-line qwik/no-use-visible-task -- delegated DOM glue + cleanup
+  useVisibleTask$((ctx) => start(initSources, opts, ctx));
 
 /** The `toast()` imperative (no lifecycle of its own).
  *  @returns {(message: string, opts?: ToastOpts) => Cleanup} */

package/react/index.d.ts

@@ -24,6 +24,7 @@ export function useConnectors(opts?: BrontoBindingOptsResolver): void;
 export function useSpotlight(opts?: BrontoBindingOptsResolver): void;
 export function useCrosshair(opts?: BrontoBindingOptsResolver): void;
 export function useCommand(opts?: BrontoBindingOptsResolver): void;
+export function useSources(opts?: BrontoBindingOptsResolver): void;
 export function useToast(): (message: string, opts?: ToastOpts) => Cleanup;
 export { applyStoredTheme };
 export type Cleanup = import("../behaviors/index.js").Cleanup;

package/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":"AA8FA;;;;;sBAKsB;AACtB,wCAHY,CAAC,IAAI,CAAC,EAAE,YAAY,KAAK,OAAO,GAAG,IAAI,SACvC,yBAAyB,GACvB,IAAI,CAGjB;AAGM,sCADK,yBAAyB,CAAC,gBAAgB,GAAG,YAAY,CAAC,GAAmB,IAAI,CACb;AAEzE,sCADK,yBAAyB,GAAmB,IAAI,CACgB;AAErE,wCADK,yBAAyB,GAAmB,IAAI,CACwB;AAE7E,qCADK,yBAAyB,GAAmB,IAAI,CACkB;AAEvE,+BADK,yBAAyB,GAAmB,IAAI,CACM;AAE3D,yCADK,yBAAyB,GAAmB,IAAI,CAC0B;AAE/E,mCADK,yBAAyB,GAAmB,IAAI,CACc;AAEnE,kCADK,yBAAyB,GAAmB,IAAI,CACY;AAEjE,oCADK,yBAAyB,GAAmB,IAAI,CACgB;AAErE,+BADK,yBAAyB,GAAmB,IAAI,CACM;AAE3D,iCADK,yBAAyB,GAAmB,IAAI,CACU;AAE/D,gCADK,yBAAyB,GAAmB,IAAI,CACQ;AAE7D,mCADK,yBAAyB,GAAmB,IAAI,CACc;AAEnE,mCADK,yBAAyB,GAAmB,IAAI,CACc;AAEnE,iCADK,yBAAyB,GAAmB,IAAI,CACU;AAE/D,qCADK,yBAAyB,GAAmB,IAAI,CACkB;AAEvE,oCADK,yBAAyB,GAAmB,IAAI,CACgB;AAErE,oCADK,yBAAyB,GAAmB,IAAI,CACgB;AAErE,kCADK,yBAAyB,GAAmB,IAAI,CACY;AAIjE,4BADO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,KAAK,OAAO,CACzB;;sBA3HtB,OAAO,uBAAuB,EAAE,OAAO;2BACvC,OAAO,uBAAuB,EAAE,YAAY;+BAC5C,OAAO,uBAAuB,EAAE,gBAAgB;wBAChD,OAAO,uBAAuB,EAAE,SAAS;gCAEzC,QAAQ,GACd,OAAO,GACP;IAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,GAClD,CAAC,MAAM,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GAC7C,IAAI,GACJ,SAAS;8BAIa,CAAC,SAAhB,YAAa,sDACd,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,iBAAiB,CAAA;CAAE;sCAI9B,CAAC,SAAhB,YAAa,sDACd,iBAAiB,CAAC,CAAC,CAAC,GAC1B,CAAC,MAAM,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAC/C,IAAI,GACJ,SAAS;iCAyBT,uBAAuB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":"AA+FA;;;;;sBAKsB;AACtB,wCAHY,CAAC,IAAI,CAAC,EAAE,YAAY,KAAK,OAAO,GAAG,IAAI,SACvC,yBAAyB,GACvB,IAAI,CAGjB;AAGM,sCADK,yBAAyB,CAAC,gBAAgB,GAAG,YAAY,CAAC,GAAmB,IAAI,CACb;AAEzE,sCADK,yBAAyB,GAAmB,IAAI,CACgB;AAErE,wCADK,yBAAyB,GAAmB,IAAI,CACwB;AAE7E,qCADK,yBAAyB,GAAmB,IAAI,CACkB;AAEvE,+BADK,yBAAyB,GAAmB,IAAI,CACM;AAE3D,yCADK,yBAAyB,GAAmB,IAAI,CAC0B;AAE/E,mCADK,yBAAyB,GAAmB,IAAI,CACc;AAEnE,kCADK,yBAAyB,GAAmB,IAAI,CACY;AAEjE,oCADK,yBAAyB,GAAmB,IAAI,CACgB;AAErE,+BADK,yBAAyB,GAAmB,IAAI,CACM;AAE3D,iCADK,yBAAyB,GAAmB,IAAI,CACU;AAE/D,gCADK,yBAAyB,GAAmB,IAAI,CACQ;AAE7D,mCADK,yBAAyB,GAAmB,IAAI,CACc;AAEnE,mCADK,yBAAyB,GAAmB,IAAI,CACc;AAEnE,iCADK,yBAAyB,GAAmB,IAAI,CACU;AAE/D,qCADK,yBAAyB,GAAmB,IAAI,CACkB;AAEvE,oCADK,yBAAyB,GAAmB,IAAI,CACgB;AAErE,oCADK,yBAAyB,GAAmB,IAAI,CACgB;AAErE,kCADK,yBAAyB,GAAmB,IAAI,CACY;AAEjE,kCADK,yBAAyB,GAAmB,IAAI,CACY;AAIjE,4BADO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,KAAK,OAAO,CACzB;;sBA9HtB,OAAO,uBAAuB,EAAE,OAAO;2BACvC,OAAO,uBAAuB,EAAE,YAAY;+BAC5C,OAAO,uBAAuB,EAAE,gBAAgB;wBAChD,OAAO,uBAAuB,EAAE,SAAS;gCAEzC,QAAQ,GACd,OAAO,GACP;IAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,GAClD,CAAC,MAAM,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GAC7C,IAAI,GACJ,SAAS;8BAIa,CAAC,SAAhB,YAAa,sDACd,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,iBAAiB,CAAA;CAAE;sCAI9B,CAAC,SAAhB,YAAa,sDACd,iBAAiB,CAAC,CAAC,CAAC,GAC1B,CAAC,MAAM,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAC/C,IAAI,GACJ,SAAS;iCA0BT,uBAAuB"}

package/react/index.js

@@ -67,6 +67,7 @@ import {
   initSpotlight,
   initCrosshair,
   initCommand,
+  initSources,
   toast,
 } from '../behaviors/index.js';
 
@@ -140,6 +141,8 @@ export const useSpotlight = (opts) => useBrontoBehavior(initSpotlight, opts);
 export const useCrosshair = (opts) => useBrontoBehavior(initCrosshair, opts);
 /** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
 export const useCommand = (opts) => useBrontoBehavior(initCommand, opts);
+/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
+export const useSources = (opts) => useBrontoBehavior(initSources, opts);
 
 /** The `toast()` imperative (no lifecycle of its own).
  *  @returns {(message: string, opts?: ToastOpts) => Cleanup} */

package/solid/index.d.ts

@@ -43,6 +43,8 @@ export const useSpotlight: (opts?: BrontoBindingOptsResolver) => void;
 export const useCrosshair: (opts?: BrontoBindingOptsResolver) => void;
 /** @type {(opts?: BrontoBindingOptsResolver) => void} */
 export const useCommand: (opts?: BrontoBindingOptsResolver) => void;
+/** @type {(opts?: BrontoBindingOptsResolver) => void} */
+export const useSources: (opts?: BrontoBindingOptsResolver) => void;
 /** The `toast()` imperative (no lifecycle of its own).
  * @type {() => (message: string, opts?: ToastOpts) => Cleanup} */
 export const useToast: () => (message: string, opts?: ToastOpts) => Cleanup;

package/solid/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":"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"}

package/solid/index.js

@@ -69,6 +69,7 @@ import {
   initSpotlight,
   initCrosshair,
   initCommand,
+  initSources,
   toast,
 } from '../behaviors/index.js';
 
@@ -145,6 +146,8 @@ export const useSpotlight = (opts) => useBrontoBehavior(initSpotlight, opts);
 export const useCrosshair = (opts) => useBrontoBehavior(initCrosshair, opts);
 /** @type {(opts?: BrontoBindingOptsResolver) => void} */
 export const useCommand = (opts) => useBrontoBehavior(initCommand, opts);
+/** @type {(opts?: BrontoBindingOptsResolver) => void} */
+export const useSources = (opts) => useBrontoBehavior(initSources, opts);
 
 /** The `toast()` imperative (no lifecycle of its own).
  * @type {() => (message: string, opts?: ToastOpts) => Cleanup} */

package/tokens/skins.js

@@ -38,22 +38,35 @@ export const skins = {
   'amber-crt': {
     label: 'Amber CRT',
     // Phosphor amber. Dark+saturated in light theme (AA under a white label),
-    // bright with a warm bloom in dark theme (the classic CRT glow).
-    light: { '--accent': 'oklch(52% 0.11 67deg)' },
-    dark: { '--accent': 'oklch(82% 0.15 82deg)', '--dotmatrix-glow': '0.4em' },
+    // bright with a warm bloom in dark theme (the classic CRT glow). The glow
+    // and a deeper --pulse breath (`--dotmatrix-pulse-min`) are the Tier-3
+    // "display expression" knobs the colorway is allowed to re-point.
+    light: { '--accent': 'oklch(52% 0.11 67deg)', '--dotmatrix-pulse-min': '0.35' },
+    dark: {
+      '--accent': 'oklch(82% 0.15 82deg)',
+      '--dotmatrix-glow': '0.4em',
+      '--dotmatrix-pulse-min': '0.3',
+    },
   },
   'phosphor-green': {
     label: 'Phosphor Green',
-    // P1-phosphor green. Same light=dark-ink / dark=bright-glow split.
-    light: { '--accent': 'oklch(52% 0.13 150deg)' },
-    dark: { '--accent': 'oklch(84% 0.19 150deg)', '--dotmatrix-glow': '0.4em' },
+    // P1-phosphor green. Same light=dark-ink / dark=bright-glow split, with the
+    // same deeper phosphor breath as Amber CRT.
+    light: { '--accent': 'oklch(52% 0.13 150deg)', '--dotmatrix-pulse-min': '0.35' },
+    dark: {
+      '--accent': 'oklch(84% 0.19 150deg)',
+      '--dotmatrix-glow': '0.4em',
+      '--dotmatrix-pulse-min': '0.3',
+    },
   },
   'e-ink': {
     label: 'E-ink',
     // The opposite move: drop the hue almost entirely → a near-monochrome
-    // ink/paper accent, no glow. The most restrained look in the set.
-    light: { '--accent': 'oklch(34% 0.012 250deg)' },
-    dark: { '--accent': 'oklch(84% 0.008 250deg)' },
+    // ink/paper accent, no glow. The most restrained look in the set — and the
+    // --reveal scan snaps on instantly (`--dotmatrix-reveal-step: 0ms`), since
+    // e-ink panels don't sweep, they flip.
+    light: { '--accent': 'oklch(34% 0.012 250deg)', '--dotmatrix-reveal-step': '0ms' },
+    dark: { '--accent': 'oklch(84% 0.008 250deg)', '--dotmatrix-reveal-step': '0ms' },
   },
 };