@danxbot/ui 2.0.2 → 2.1.1

package/dist/types/components/Popover.d.ts

@@ -18,8 +18,19 @@ export interface PopoverProps {
      * documentation surface cannot dispatch a click.
      */
     defaultOpen?: boolean;
+    /**
+     * Names the popup for assistive technology.
+     *
+     * Base UI gives the popup `role="dialog"`, and an unlabelled dialog
+     * announces itself as nothing. Declared here rather than left to a caller
+     * passing `aria-labelledby` through: an undeclared prop on a component that
+     * destructures its props is silently DROPPED — it type-checks, renders, and
+     * does nothing, which is how this was shipped once already.
+     */
+    "aria-labelledby"?: string;
+    "aria-label"?: string;
 }
-export declare function Popover({ trigger, side, align, arrow, className, children, ref, defaultOpen, }: PopoverProps): import("react").JSX.Element;
+export declare function Popover({ trigger, side, align, arrow, className, children, ref, defaultOpen, "aria-labelledby": ariaLabelledBy, "aria-label": ariaLabel, }: PopoverProps): import("react").JSX.Element;
 /** Closes the nearest Popover. */
 export declare function PopoverClose({ children }: {
     children: ReactNode;

package/dist/types/components/provenance/ConfidenceMeter.d.ts

@@ -0,0 +1,15 @@
+export interface ConfidenceMeterProps {
+    /** 0..1, or null when nothing scored it. */
+    confidence: number | null;
+    /**
+     * What to say when there is no score.
+     *
+     * Rendered as text rather than an empty bar, because a bar at zero and a bar
+     * with nothing to show look identical and mean opposite things.
+     */
+    unscoredLabel?: string;
+    /** Hides the band name, for dense rows where the bar is enough. */
+    compact?: boolean;
+    className?: string;
+}
+export declare function ConfidenceMeter({ confidence, unscoredLabel, compact, className, }: ConfidenceMeterProps): import("react").JSX.Element;

package/dist/types/components/provenance/ProvenanceBadge.d.ts

@@ -0,0 +1,12 @@
+import type { ProvenanceState } from "./types";
+export interface ProvenanceBadgeProps {
+    state: ProvenanceState;
+    /** Render the badge even for states that are quiet by default. */
+    alwaysShow?: boolean;
+    size?: "sm" | "md";
+    className?: string;
+}
+export declare function ProvenanceBadge({ state, alwaysShow, size, className, }: ProvenanceBadgeProps): import("react").JSX.Element | null;
+/** The words this library uses for each state. Exported so a consumer's own
+    filters and legends read the same as its badges. */
+export declare function provenanceStateLabel(state: ProvenanceState): string;

package/dist/types/components/provenance/ProvenanceDisclosure.d.ts

@@ -0,0 +1,19 @@
+import { type ReactNode } from "react";
+import type { ProvenanceRecord } from "./types";
+export interface ProvenanceDisclosureProps {
+    record: ProvenanceRecord;
+    /**
+     * Rendered at the foot of the panel — sign-off, correction, "open the source".
+     *
+     * A slot rather than props, because the actions a consumer offers over an
+     * extracted value are theirs: this library has no idea who is allowed to sign
+     * one, or what correcting it should do.
+     */
+    actions?: ReactNode;
+    /** Shown in place of the value when there is none and it did not fail. */
+    emptyLabel?: string;
+    /** Shown in place of the value when the viewer may not see it. */
+    redactedLabel?: string;
+    className?: string;
+}
+export declare function ProvenanceDisclosure({ record, actions, emptyLabel, redactedLabel, className, }: ProvenanceDisclosureProps): import("react").JSX.Element;

package/dist/types/components/provenance/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types";
+export * from "./ConfidenceMeter";
+export * from "./ProvenanceBadge";
+export * from "./ProvenanceDisclosure";

package/dist/types/components/provenance/types.d.ts

@@ -0,0 +1,78 @@
+import type { ReactNode } from "react";
+export type ProvenanceState = 
+/** Machine-extracted, and the check passed. */
+"verified"
+/** A person signed it — on top of the machine's verdict, never instead. */
+ | "human"
+/** Extracted, but nothing confirmed it. The value stands, flagged. */
+ | "unverified"
+/** The check actively failed. There is no value. */
+ | "failed";
+/** Where a value came from, precisely enough to go and look. */
+export interface ProvenanceSource {
+    /** The thing it came from — a document title, a URL, a table name. */
+    label: string;
+    /** Where inside it: "page 4", "line 82", "§3.1". Null when there is no locus. */
+    locus: string | null;
+    /** The exact text at that locus. */
+    quote: string | null;
+}
+/**
+ * The verdict of whatever check the consumer ran.
+ *
+ * `passed` is a tri-state on purpose: `true`, `false`, and `null` for "no check
+ * was run" — which is a different claim from "a check ran and failed", and
+ * collapsing the two would let an unchecked value read as a passing one.
+ */
+export interface ProvenanceCheck {
+    passed: boolean | null;
+    /** How it was checked, or why it could not be. */
+    detail: string;
+}
+/** The model call that produced the value. */
+export interface ProvenanceCall {
+    model: string;
+    tokensIn: number;
+    tokensOut: number;
+    latencyMs: number;
+}
+/** A person's signature over the value. */
+export interface ProvenanceSignoff {
+    by: string;
+    at: string;
+    note: string | null;
+    /**
+     * What the value was before they changed it.
+     *
+     * Null when they signed without correcting. Present means the value was
+     * replaced — and the original is kept, because a correction whose previous
+     * value is gone is an assertion rather than a record.
+     */
+    replaced: string | null;
+}
+export interface ProvenanceRecord {
+    /** What this value IS. Always shown, even when the value is hidden. */
+    label: string;
+    /** Null when it failed, or when the viewer may not see it. */
+    value: ReactNode | null;
+    state: ProvenanceState;
+    /** 0..1. Null when nothing scored it. */
+    confidence: number | null;
+    source: ProvenanceSource | null;
+    reasoning: string | null;
+    check: ProvenanceCheck | null;
+    call: ProvenanceCall | null;
+    signoff: ProvenanceSignoff | null;
+    /**
+     * Withheld from this viewer.
+     *
+     * Distinct from a null value: the label and the verification state still
+     * render, so a reader can see that a value EXISTS and was checked without
+     * seeing it. Hiding the row entirely would make the record look thinner than
+     * it is to the person least able to tell.
+     */
+    redacted?: boolean;
+}
+/** 0..1 to a band. A bare percentage invites false precision. */
+export type ConfidenceBand = "high" | "moderate" | "low";
+export declare function confidenceBand(confidence: number): ConfidenceBand;

package/dist/types/index.d.ts

@@ -94,4 +94,5 @@ export { AmbiguousTimeError, addDays, addDuration, addMonths, atMidnight, atTime
 export { allDayBandSegment, dayKey, daySlots, isAllDay, packBand, packLanes, snapFractionToInstant, timeSegments, timedBandSegment, type AllDayEvent, type BandInput, type BandOptions, type BandPlacement, type BandResult, type BandSegment, type CalendarEvent, type CalendarEventId, type CalendarView, type DaySlot, type DragKind, type EventDraft, type EventPalette, type LaneInput, type LaneOptions, type LanePlacement, type PaletteEntry, type TimeSegment, type TimedEvent, type VisibleRange, } from "./lib/calendar";
 export { RBACProvider, useRBAC, AccountMenu, DevToolsPopover, RolePermissionMatrix, ProfilePage, RolesPermissionsPage, type RBACProviderProps, type RBACHookResult, type AccountMenuProps, type DevToolsPopoverProps, type RolePermissionMatrixProps, type Permission, type Role, type User, type Team, type TeamMembership, } from "./components/rbac";
 export { UseCaseCard, RoadmapItemCard, RoadmapSwimlaneBoard, UseCaseLedgerPage, RoadmapPage, PhaseManager, TrackManager, deriveRoadmapItemStatus, isFullyBuilt, isUnbuilt, trackIds, trackProgress, toneForIndex, CATEGORY_TONES, type Domain, type Phase, type Track, type RoadmapItem, type RoadmapItemStatus, type UseCase, type UseCaseStatus, type UseCaseDecision, type UseCaseCardProps, type RoadmapItemCardProps, type RoadmapSwimlaneBoardProps, type UseCaseLedgerPageProps, type RoadmapPageProps, type PhaseManagerProps, type TrackManagerProps, } from "./components/roadmap";
+export { ProvenanceDisclosure, ProvenanceBadge, ConfidenceMeter, provenanceStateLabel, confidenceBand, type ProvenanceRecord, type ProvenanceState, type ProvenanceSource, type ProvenanceCheck, type ProvenanceCall, type ProvenanceSignoff, type ConfidenceBand, type ProvenanceDisclosureProps, type ProvenanceBadgeProps, type ConfidenceMeterProps, } from "./components/provenance";
 export { createSimStore, resetSimStores, useSimSettings, setSimSettings, getNetworkSpeed, getDataSource, simulateLatency, SimNetworkError, type SimStore, type SimStoreOptions, type SimSettings, type NetworkSpeed, type DataSource, type SimNamespace, } from "./lib/sim";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/ui",
-  "version": "2.0.2",
+  "version": "2.1.1",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",