@validation-os/dashboard 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { Collection, AnyRecord, Result, Relation, BarLine } from '@validation-os/core';
+import { Collection, AnyRecord, Result, Rung, MagnitudeBand, Relation, BarLine } from '@validation-os/core';
 import { PortfolioProgress, StageExperimentInput, MoveKind, NextMoveInput, BeliefStage, JourneyEvent, NextMove, JourneyEventKind, ConfSign, StageKey, Progress, MoverKind, TrajectoryPoint } from '@validation-os/core/derivation';
 export { StageKey } from '@validation-os/core/derivation';
 
@@ -243,7 +243,9 @@ interface GroupBucket {
  * risk band by severity, everything else first-appearance.
  */
 declare function groupRecords(records: AnyRecord[], axis: GroupByAxis): GroupBucket[];
-/** Case-insensitive substring filter over Title + Description. */
+/** Case-insensitive substring filter over Title + Description + Source. Source
+ * (a reading's generator — person / dataset / cohort) is searchable so a
+ * teammate can pull every reading from one source by typing its name. */
 declare function filterRecords(records: AnyRecord[], query: string): AnyRecord[];
 /** A stable sort by one key; numbers compare numerically, everything else by
  * locale string. Missing values sort last regardless of direction. */
@@ -1040,6 +1042,9 @@ interface RegisterTableProps {
     onRowClick?: (id: string) => void;
     /** The id of the currently-open record, highlighted in the list. */
     selectedId?: string | null;
+    /** Assumption id → title, so a reading row's belief chips read as titles
+     * rather than ids (OPS-1305). Omitted → chips fall back to the bare ids. */
+    assumptionTitles?: Map<string, string>;
 }
 /**
  * A list table for one register — a row per record, the register's key fields
@@ -1049,7 +1054,7 @@ interface RegisterTableProps {
  * the treatment stays testable at the columns seam and this component stays a
  * dumb renderer. Presentational: the caller supplies the rows.
  */
-declare function RegisterTable({ register, records, onRowClick, selectedId, }: RegisterTableProps): react.JSX.Element;
+declare function RegisterTable({ register, records, onRowClick, selectedId, assumptionTitles, }: RegisterTableProps): react.JSX.Element;
 
 /**
  * The record-page view-model (OPS-1286) — the pure join behind the canonical
@@ -1119,6 +1124,27 @@ interface HumanText {
 }
 /** The human-input fields a register carries text for (empty ones dropped). */
 declare function humanInputFields(register: Collection, record: AnyRecord): HumanText[];
+/** One belief a reading grades, prepared for the reading detail's verdict list
+ * (OPS-1305). Modelled on the experiment bar-line view: the assumption resolved
+ * to a title + navigable id, plus this belief's own Rung / Result / derived
+ * Strength / magnitude band and the grading justification. */
+interface BeliefVerdict {
+    assumptionId: string;
+    /** The belief's title if it's in the loaded set, else its bare id. */
+    title: string;
+    /** True when the assumption resolved — drives whether the title links. */
+    linked: boolean;
+    rung: Rung | null;
+    result: Result | null;
+    /** Derived per-belief strength (signed −100…100). */
+    strength: number | null;
+    magnitudeBand: MagnitudeBand | null;
+    justification: string;
+}
+/** The per-belief verdicts a reading carries, in stored order — the reading
+ * detail's answer to "what did this artifact say about each belief?". Pure:
+ * resolves each belief-score against the loaded assumptions for its title. */
+declare function readingBeliefVerdicts(reading: AnyRecord, assumptions?: AnyRecord[]): BeliefVerdict[];
 /** A glance-readable score chip for a linked record (story 9). */
 interface ScoreChip {
     label: string;
@@ -1263,7 +1289,10 @@ declare function UnderstandingPanel({ assumption, basePath, }: {
  * also moves the number, and the Confidence-over-time trajectory.
  *
  * The record → derivation-input mapping is `@validation-os/core`'s shared
- * `toReadingInput`, so a reading is read here exactly as it is server-side.
+ * `readingBeliefInputs`, which fans a reading row out into one input per belief;
+ * we keep this belief's inputs, so a reading is read here exactly as it is
+ * server-side. Archived experiments never surface here (OPS-1305) — the "Why?"
+ * only ever shows a live plan or direct evidence.
  */
 
 /** An experiment testing this assumption: how hard it moves Confidence, and
@@ -1537,6 +1566,14 @@ interface ColumnDef {
 }
 /** The columns to render for a register. */
 declare function columnsFor(register: Collection): ColumnDef[];
+/** A one-line, length-capped preview of a reading's free-text `body` (its
+ * quote), for the readings table. Collapses whitespace and ellipsises; a
+ * missing/empty body reads as the empty string (formatted to an em dash). */
+declare function bodyPreview(value: unknown, max?: number): string;
+/** The belief chips for a reading row — the assumptions it grades, resolved to
+ * titles when a lookup is given, else their bare ids. Disambiguates readings
+ * that share a Title by showing which belief(s) each one actually scored. */
+declare function readingAssumptionChips(record: AnyRecord, titleById?: Map<string, string>): string[];
 /** Read a column's raw value from a record (accessor, else `record[key]`). */
 declare function cellValue(column: ColumnDef, record: AnyRecord): unknown;
 /** Format any stored value for display; empty/missing reads as an em dash. */
@@ -1544,6 +1581,17 @@ declare function formatValue(value: unknown): string;
 /** The record's headline for a row/drawer: Title, else Name, else its id. */
 declare function primaryLabel(record: AnyRecord): string;
 
+/** Render Markdown `text` into the package's prose styling. Empty → nothing. */
+declare function Markdown({ text }: {
+    text: string;
+}): react.JSX.Element | null;
+
+declare function BeliefVerdicts({ reading, assumptions, onOpenRecord, }: {
+    reading: AnyRecord;
+    assumptions: AnyRecord[];
+    onOpenRecord?: (id: string) => void;
+}): react.JSX.Element;
+
 /**
  * The editable-field spec for the "new record" form, per register — kept as
  * pure data + functions (like `columns.ts`) so the create form is unit-testable
@@ -1755,4 +1803,4 @@ declare const REGISTER_GROUPS: {
     registers: Collection[];
 }[];
 
-export { type BacklinkItem, BeliefJourney, type BeliefJourneyProps, CONFLICT_MESSAGE, type CellKind, type ColdStart, type ColumnDef, ConfidenceCell, ConnectClaudeCode, type ConnectClaudeCodeProps, type ConnectCommandInput, type Counts, type CycleReadingView, type CycleView, DEFAULT_TOKEN_ENV, DIRECT_CYCLE_KEY, type DashboardConfig, type DetailRelationItem, type DetailRow, type DetailRowKind, type Draft, EditBeliefForm, type EditBeliefFormProps, EditFields, type ExperimentView, FIRST_RUN_LINE, type FieldEditor, FieldInput, type FieldKind, type FormField, type GlossaryTerm, GlossaryText, type GlossaryTextProps, type GroupBucket, type GroupByAxis, type HumanText, type JourneyColdState, type JourneyEventView, type JourneyView, type LinkArgs, type LinkChoice, type LinkifyNode, type LinkifyOptions, type Meter, type MeterKind, type MovePresentation, type NeedsHumanByRegister, type NeedsHumanCounts, type NeighbourChip, type NestedGroup, type NextColdStart, type NextMoveRecords, NextMoveSurface, type NextMoveSurfaceProps, type OtherMover, type Pill, type PipelineColdStart, type PipelineRow, PipelineSurface, type PipelineView, REGISTER_GROUPS, REGISTER_ICON, REGISTER_LABEL, REGISTER_ORDER, REGISTER_SINGULAR, REGISTER_SUBTITLE, RISK_CRIT, RISK_WARN, RecordDrawer, type RecordDrawerProps, RecordForm, type RecordFormProps, RecordPage, type RecordPageModel, type RecordPageProps, type RecordTabId, RegisterBrowser, type RegisterBrowserProps, type RegisterContext, RegisterCounts, type RegisterCountsProps, RegisterTable, type RegisterTableProps, type RelatedSet, RelationEditor, type RelationEditorProps, type RelationPanel, type ResolvedBarLine, type ResolvedRow, type RiskBand, RiskBar, type Route, type SaveResult, type SavedView, type ScoreChip, ScoreImpactForm, type ScoreImpactFormProps, type ShapedRegister, SidebarNav, type SidebarNavProps, type SortSpec, Sparkline, type StageMeterInput, type StageMeterView, StatTile, StatusPill, type StepInForm, type StoryStepIn, SurfacePlaceholder, type SurfacePlaceholderProps, type TabDef, type TermPreview, type Tone, type Understanding, UnderstandingPanel, type UseCountsResult, type UseCreateResult, type UseLinkResult, type UseListResult, type UseNeedsHumanResult, type UseRecordResult, type UseSavedViewsResult, type UseUpdateResult, ValidationOSDashboard, type ValidationOSDashboardProps, type ViewDescriptor, WriteDecisionForm, type WriteDecisionFormProps, backlinkPanels, buildCycles, buildJourney, buildPatch, buildPipeline, buildRecordPage, buildUnderstanding, cellValue, coldStartFor, columnsFor, composeConnectCommand, confidenceTone, configureRiskBands, defaultTabId, detailRows, dontConfuseWith, draftFrom, editableFields, emptyDraft, eventStepIn, eventTone, filterRecords, formFieldsFor, formatCount, formatRoute, formatSigned, formatValue, groupByAxesFor, groupRecords, hasEdits, headerPills, humanInputFields, interpretSave, journeyColdState, leadingMeters, linkChoicesFrom, linkify, missingRequired, movePresentation, needsHumanCounts, nestReadingsByPlan, ownerNames, parseRoute, primaryLabel, resolveBarLines, riskBand, riskFraction, riskLevel, scoreChip, shapeRegister, sortRecords, sparklinePath, stageMeters, statusTone, tabsFor, toCreatePayload, toGlossaryTerms, toNextMoveInput, toStageExperimentInput, useCounts, useCreate, useLink, useList, useNeedsHuman, useRecord, useSavedViews, useUpdate, weekOverWeekDelta };
+export { type BacklinkItem, BeliefJourney, type BeliefJourneyProps, type BeliefVerdict, BeliefVerdicts, CONFLICT_MESSAGE, type CellKind, type ColdStart, type ColumnDef, ConfidenceCell, ConnectClaudeCode, type ConnectClaudeCodeProps, type ConnectCommandInput, type Counts, type CycleReadingView, type CycleView, DEFAULT_TOKEN_ENV, DIRECT_CYCLE_KEY, type DashboardConfig, type DetailRelationItem, type DetailRow, type DetailRowKind, type Draft, EditBeliefForm, type EditBeliefFormProps, EditFields, type ExperimentView, FIRST_RUN_LINE, type FieldEditor, FieldInput, type FieldKind, type FormField, type GlossaryTerm, GlossaryText, type GlossaryTextProps, type GroupBucket, type GroupByAxis, type HumanText, type JourneyColdState, type JourneyEventView, type JourneyView, type LinkArgs, type LinkChoice, type LinkifyNode, type LinkifyOptions, Markdown, type Meter, type MeterKind, type MovePresentation, type NeedsHumanByRegister, type NeedsHumanCounts, type NeighbourChip, type NestedGroup, type NextColdStart, type NextMoveRecords, NextMoveSurface, type NextMoveSurfaceProps, type OtherMover, type Pill, type PipelineColdStart, type PipelineRow, PipelineSurface, type PipelineView, REGISTER_GROUPS, REGISTER_ICON, REGISTER_LABEL, REGISTER_ORDER, REGISTER_SINGULAR, REGISTER_SUBTITLE, RISK_CRIT, RISK_WARN, RecordDrawer, type RecordDrawerProps, RecordForm, type RecordFormProps, RecordPage, type RecordPageModel, type RecordPageProps, type RecordTabId, RegisterBrowser, type RegisterBrowserProps, type RegisterContext, RegisterCounts, type RegisterCountsProps, RegisterTable, type RegisterTableProps, type RelatedSet, RelationEditor, type RelationEditorProps, type RelationPanel, type ResolvedBarLine, type ResolvedRow, type RiskBand, RiskBar, type Route, type SaveResult, type SavedView, type ScoreChip, ScoreImpactForm, type ScoreImpactFormProps, type ShapedRegister, SidebarNav, type SidebarNavProps, type SortSpec, Sparkline, type StageMeterInput, type StageMeterView, StatTile, StatusPill, type StepInForm, type StoryStepIn, SurfacePlaceholder, type SurfacePlaceholderProps, type TabDef, type TermPreview, type Tone, type Understanding, UnderstandingPanel, type UseCountsResult, type UseCreateResult, type UseLinkResult, type UseListResult, type UseNeedsHumanResult, type UseRecordResult, type UseSavedViewsResult, type UseUpdateResult, ValidationOSDashboard, type ValidationOSDashboardProps, type ViewDescriptor, WriteDecisionForm, type WriteDecisionFormProps, backlinkPanels, bodyPreview, buildCycles, buildJourney, buildPatch, buildPipeline, buildRecordPage, buildUnderstanding, cellValue, coldStartFor, columnsFor, composeConnectCommand, confidenceTone, configureRiskBands, defaultTabId, detailRows, dontConfuseWith, draftFrom, editableFields, emptyDraft, eventStepIn, eventTone, filterRecords, formFieldsFor, formatCount, formatRoute, formatSigned, formatValue, groupByAxesFor, groupRecords, hasEdits, headerPills, humanInputFields, interpretSave, journeyColdState, leadingMeters, linkChoicesFrom, linkify, missingRequired, movePresentation, needsHumanCounts, nestReadingsByPlan, ownerNames, parseRoute, primaryLabel, readingAssumptionChips, readingBeliefVerdicts, resolveBarLines, riskBand, riskFraction, riskLevel, scoreChip, shapeRegister, sortRecords, sparklinePath, stageMeters, statusTone, tabsFor, toCreatePayload, toGlossaryTerms, toNextMoveInput, toStageExperimentInput, useCounts, useCreate, useLink, useList, useNeedsHuman, useRecord, useSavedViews, useUpdate, weekOverWeekDelta };