@validation-os/dashboard 0.14.1 → 0.15.0

package/dist/index.d.ts

@@ -39,20 +39,19 @@ interface ValidationOSDashboardProps {
     config?: DashboardConfig;
 }
 /**
- * The entire styled dashboard as one mountable app (spec OPS-1280): the frame —
- * sidebar composing the workflow + register nav with live counts, topbar with
- * the backend indicator and user — and the surfaces it routes between across
- * the three altitudes (front door → pipeline → per-belief drill-in) plus the
- * kept register tables. Navigation is owned here, not the host router: the
- * active route lives in client state, synced to the URL hash (OPS-1298), so the
- * instance mounts this at one route and wires no routing. Styled by the
- * package's own token sheet — the instance imports `styles.css` once and builds
- * no UI.
+ * The entire styled dashboard as one mountable app (spec OPS-1280 / DEV-5879
+ * redesign): the frame — a 3-item sidebar (Assumptions / Experiments /
+ * Readings) plus a small Registers group for decisions + glossary, topbar with
+ * the backend indicator and user — and the surfaces it routes between. The
+ * Assumptions nav lands on the Lens × Stage grid; a "Grid / View all" toggle
+ * switches to the pipeline board. Both drill into the same AssumptionDetail.
+ * Experiments shows the live evidence plans; Readings shows the evidence log.
+ * Each detail view is evidence-first: readings lead, bar lines are context.
  *
- * The front-door (`#next`) and pipeline (`#pipeline`) surfaces are now live;
- * OPS-1282's record page (`#record/<id>`) still fills its pane as it ships.
- * Records is the browse-everything / manual-override surface — the register
- * browser, kept from the original scheme.
+ * Navigation is owned here, not the host router: the active route lives in
+ * client state, synced to the URL hash (OPS-1298), so the instance mounts this
+ * at one route and wires no routing. Styled by the package's own token sheet —
+ * the instance imports `styles.css` once and builds no UI.
  */
 declare function ValidationOSDashboard({ config }: ValidationOSDashboardProps): react.JSX.Element;
 
@@ -295,24 +294,48 @@ interface NeedsHumanCounts {
 declare function needsHumanCounts(ctx: RegisterContext): NeedsHumanCounts;
 
 /**
- * The dashboard's client-owned navigation state, across the workflow
- * altitudes plus the kept register tables (OPS-1298). One `<ValidationOSDashboard/>`
- * mounts at a single host route and drives everything off the URL hash — there
- * is no second entry point (OPS-1280).
+ * The dashboard's client-owned navigation state (OPS-1298 / DEV-5879 redesign).
+ * One `<ValidationOSDashboard/>` mounts at a single host route and drives
+ * everything off the URL hash — there is no second entry point (OPS-1280).
  *
- *  - `next`       — the front door ("what's my next move"); the default landing.
- *  - `pipeline`   — the step-back portfolio pipeline.
- *  - `stage-grid` — the Lens × Stage heatmap (docs/stage-policy.md).
- *  - `records`    — one register's browse table (the manual-override surface,
- *                   kept from the original scheme).
- *  - `record`     — the per-belief drill-in (full record page).
+ *  - `assumptions` — the Assumptions nav item. The grid (Lens × Stage) is the
+ *    default landing; `view: "all"` switches to the pipeline board; `lens` +
+ *    `stage` drill into a single cell's assumptions (pipeline view filtered).
+ *  - `experiments` — the Experiments nav item (the live evidence plans list).
+ *  - `readings` — the Readings nav item (the evidence log list).
+ *  - `assumption` — the assumption detail (next-move, relations, glossary,
+ *    evidence-first readings). The id is the assumption id.
+ *  - `experiment` — the evidence-first experiment detail (readings lead, bar
+ *    lines as context, unstarted bars separate). The id is the experiment id.
+ *  - `reading` — the per-belief reading detail (Context + per-belief verdicts
+ *    with excerpts). The id is the reading id.
+ *  - `records` — one register's browse table (the manual-override surface,
+ *    kept from the original scheme). Backward-compatible with `#<register>`.
+ *  - `record` — the legacy unified record page (still mounted for decisions +
+ *    glossary, which keep the tabbed layout). The id is the record id.
+ *
+ * The legacy `next`, `pipeline`, and `stage-grid` routes still parse (they
+ * map onto the new nav: `next`→`assumptions`, `pipeline`→`assumptions` with
+ * `view: "all"`, `stage-grid`→`assumptions`) so old deep links keep working.
  */
 type Route = {
-    name: "next";
+    name: "assumptions";
+    lens?: string;
+    stage?: string;
+    view?: "all";
+} | {
+    name: "experiments";
 } | {
-    name: "pipeline";
+    name: "readings";
 } | {
-    name: "stage-grid";
+    name: "assumption";
+    id: string;
+} | {
+    name: "experiment";
+    id: string;
+} | {
+    name: "reading";
+    id: string;
 } | {
     name: "records";
     register: Collection;
@@ -325,10 +348,14 @@ type Route = {
 };
 /**
  * Parse a URL hash into a Route. The empty hash and anything unrecognised fall
- * back to the front door. A bare register name (`#assumptions`) stays
- * backward-compatible with the original `#<register>` scheme, so it resolves to
- * that register's Records table; `registers` is the set the instance allows, so
- * an unknown or disallowed register name falls through to the default.
+ * back to the Assumptions grid (the default landing). A bare register name
+ * (`#assumptions`) stays backward-compatible with the original `#<register>`
+ * scheme, so it resolves to that register's Records table; `registers` is the
+ * set the instance allows, so an unknown or disallowed register name falls
+ * through to the default.
+ *
+ * Legacy routes `#next`, `#pipeline`, and `#stage-grid` still parse — they map
+ * onto the new nav so old deep links keep working.
  */
 declare function parseRoute(hash: string, registers: Collection[]): Route;
 /**
@@ -376,8 +403,9 @@ interface UseNeedsHumanResult {
 declare function useNeedsHuman(basePath?: string): UseNeedsHumanResult;
 
 interface SidebarNavProps {
-    /** The active route — drives which item is highlighted. A `record` route
-     * highlights nothing (the drill-in has no nav item; OPS-1298). */
+    /** The active route — drives which item is highlighted. A detail route
+     * (`assumption` / `experiment` / `reading` / `record`) highlights its
+     * parent nav item. */
     route: Route;
     /** Called when a nav item is chosen, with the route it selects. */
     onNavigate: (route: Route) => void;
@@ -386,17 +414,20 @@ interface SidebarNavProps {
     /** Per-register needs-a-human counts — a persistent alert badge on the
      * register that needs attention (kill lane, overdue plans, tensions; story 20). */
     needsHuman?: Partial<Record<Collection, number>>;
-    /** The registers shown under Records, in order. */
+    /** The registers shown under a "Registers" group (decisions + glossary keep
+     * the legacy records-table surface). The three nav-owned registers
+     * (assumptions / experiments / readings) are not duplicated here. */
     registers: Collection[];
 }
 /**
- * The sidebar nav across the two groups (OPS-1298): a **Workflow** group — Next
- * move (the default landing, badged `home`) and Pipeline — above the **Records**
- * group of register tables (kept, not subsumed; the browse-everything /
- * manual-override surface). A presentational brick: the caller owns the active
- * route and supplies the counts. The assembled `<ValidationOSDashboard/>`
- * composes this; it's also exported for anyone building their own surface.
- * Styled with the package's own token sheet — no host Tailwind.
+ * The sidebar nav (DEV-5879 redesign): three top-level items — Assumptions
+ * (the default landing, Lens × Stage grid with a "View all" toggle to the
+ * pipeline board), Experiments (the live evidence plans), Readings (the
+ * evidence log) — above a small "Registers" group for decisions + glossary,
+ * which keep the legacy records-table surface. A presentational brick: the
+ * caller owns the active route and supplies the counts. The assembled
+ * `<ValidationOSDashboard/>` composes this; it's also exported for anyone
+ * building their own surface. Styled with the package's own token sheet.
  */
 declare function SidebarNav({ route, onNavigate, counts, needsHuman, registers, }: SidebarNavProps): react.JSX.Element;