@danxbot/ui 18.2.0 → 18.3.0

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

@@ -127,14 +127,15 @@ interface TooltipBaseProps {
      * question about the popup ("can this be entered?"), never about a flag
      * named after its own negation.
      *
-     * DEFAULT TRUE — unchanged behaviour for every tooltip that already
-     * exists. Content plain enough to live in a tooltip (see `content`'s own
-     * doc: "anything interactive belongs in a Popover") is rarely worth
-     * entering anyway, so this defaults to permissive and call sites opt OUT
-     * where entering would be actively wrong — a short label sitting directly
-     * over other interactive controls, where the extra hoverable margin just
-     * steals hover/click targets from whatever is underneath it.
-     * @default true
+     * DEFAULT FALSE (DX-4349). A tooltip is a label, not a surface (see
+     * `content`: "anything interactive belongs in a Popover"), and a label
+     * that holds itself open under the pointer is a trap wherever marks sit
+     * side by side: the popup is drawn right over the neighbouring marks, so
+     * moving toward the next one lands on the popup, keeps it open and blocks
+     * the mark underneath. Opt IN only for a tooltip whose text a reader must
+     * be able to point into and keep reading (WCAG 1.4.13 "hoverable") and that
+     * sits clear of other controls.
+     * @default false
      */
     enterable?: boolean;
 }

package/dist/types/components/chart/TimeSeriesChart.d.ts

@@ -0,0 +1,62 @@
+import { type Ref } from "react";
+export type TimeSeriesRole = "member" | "other";
+export interface TimeSeriesSeries {
+    /** Unique within the chart. */
+    key: string;
+    label: string;
+    /** `other` is the neutral remainder: drawn last, in a neutral tone, never selectable. @default "member" */
+    role?: TimeSeriesRole;
+    /** One value per bucket, same order. Finite and >= 0 — anything else throws. */
+    points: readonly number[];
+}
+/** A named kind of unmeasured span: its label is its legend entry. At most two (45 and 135 degree hatching). */
+export interface TimeSeriesBlockKind {
+    key: string;
+    label: string;
+}
+/** A span the chart cannot place in time, drawn hatched in the bucket that holds `at`. */
+export interface TimeSeriesBlock {
+    /** Unique within the chart. */
+    id: string;
+    /** Epoch ms; must fall inside one of the buckets. */
+    at: number;
+    /** Finite and >= 0. Counts toward the bucket total. */
+    value: number;
+    /** What this span is, for its tooltip line and the table. */
+    label: string;
+    /** A `TimeSeriesBlockKind.key`. */
+    kind: string;
+}
+export interface TimeSeriesChartProps {
+    /** Each bucket's start, epoch ms, strictly ascending. */
+    buckets: readonly number[];
+    /** The width of one bucket in ms; null only when there are no buckets. */
+    bucketMs: number | null;
+    /** In stacking order, bottom first; also the palette order. */
+    series: readonly TimeSeriesSeries[];
+    blocks?: readonly TimeSeriesBlock[];
+    blockKinds?: readonly TimeSeriesBlockKind[];
+    /** What the chart measures, e.g. "Tokens over time". Names the group and captions the table. */
+    label: string;
+    /** @default "bar" */
+    variant?: "bar" | "area";
+    /** How a raw value reads in the tooltip and the table. @default locale-formatted number */
+    formatValue?: (value: number) => string;
+    /** How a value reads on the y axis; use a compact form here. @default `formatValue` */
+    formatAxis?: (value: number) => string;
+    /** Locale of the time labels. @default the viewer's */
+    locale?: string;
+    /** IANA zone the buckets are labelled in, e.g. "UTC". @default the viewer's */
+    timeZone?: string;
+    /** Called with a member series' key when its band or its legend name is clicked. */
+    onSelectSeries?: (key: string) => void;
+    /** Plot height in px. @default 240 */
+    height?: number;
+    /** Said when there is nothing to draw. @default "No data" */
+    emptyLabel?: string;
+    /** Said over the axis when every value is zero. @default "All values are zero" */
+    zeroLabel?: string;
+    className?: string;
+    ref?: Ref<HTMLDivElement>;
+}
+export declare function TimeSeriesChart(props: TimeSeriesChartProps): import("react").JSX.Element;

package/dist/types/components/chart/time-series-scale.d.ts

@@ -0,0 +1,29 @@
+export declare const MINUTE_MS = 60000;
+export declare const DAY_MS = 86400000;
+/**
+ * A value axis that starts at zero and ends on a round number at or above
+ * `max`, with about `count` intervals: steps of 1, 2 or 5 times a power of ten.
+ * No data (`max <= 0`) is a 0-to-1 axis, never a zero-height one.
+ */
+export declare function niceTicks(max: number, count?: number): {
+    ticks: number[];
+    max: number;
+};
+export interface TimeFormatters {
+    /** The label under a tick: a primary line, and a secondary line when the day (or year) changed since the last tick. */
+    tick: (ms: number, previousMs: number | null) => {
+        primary: string;
+        secondary: string | null;
+    };
+    /** The whole instant, for the tooltip and the table. */
+    full: (ms: number) => string;
+}
+/**
+ * How a bucket start reads for a bucket this wide. Under a day the time is the
+ * label and the date appears where it changes; a day or wider is labelled by
+ * its date; a month or wider by month and year. `timeZone` is passed straight
+ * to `Intl` (an unknown zone throws, loudly); undefined is the viewer's own.
+ */
+export declare function timeFormatters(bucketMs: number, locale: string | undefined, timeZone: string | undefined): TimeFormatters;
+/** The index of the bucket whose span `[start, start + bucketMs)` holds `at`, or -1. */
+export declare function bucketIndexAt(buckets: readonly number[], bucketMs: number, at: number): number;

package/dist/types/components/rbac/AccessRequestPanel.d.ts

@@ -0,0 +1,35 @@
+import type { Permission, Role } from "./types";
+export type AccessRequestKind = "session" | "worker";
+export type AccessRequestState = "pending" | "approved" | "denied" | "expired" | "claimed";
+export interface AccessRequest {
+    kind: AccessRequestKind;
+    /** The session title or the worker id: what the requester calls itself. */
+    label: string;
+    repo?: string;
+    machine?: string;
+    /** The address the request came from. */
+    requesterIp?: string;
+    clientVersion?: string;
+    /** ISO instant. */
+    requestedAt: string;
+    /** ISO instant. Shown while the request is pending. */
+    expiresAt?: string;
+    /** The short code the requester also displays. Compared by eye, never entered. */
+    confirmCode: string;
+    /** The label of the role granted. Shown once the request is approved or claimed. */
+    roleLabel?: string;
+}
+export interface AccessRequestPanelProps {
+    request: AccessRequest;
+    state: AccessRequestState;
+    /** The roles the approver may grant. */
+    roles: Role[];
+    /** The permission catalog, used to name the permissions that make a role unavailable. */
+    permissions: Permission[];
+    /** What the approver holds. A role holding anything outside this set cannot be chosen. */
+    ownPermissionKeys: string[];
+    onApprove: (roleId: string) => Promise<void>;
+    onDeny: () => Promise<void>;
+    className?: string;
+}
+export declare function AccessRequestPanel({ request, state, roles, permissions, ownPermissionKeys, onApprove, onDeny, className, }: AccessRequestPanelProps): import("react").JSX.Element;

package/dist/types/components/rbac/RoleKeyPicker.d.ts

@@ -0,0 +1,22 @@
+import type { Permission, Role } from "./types";
+export interface RoleKeyPickerProps {
+    roles: Role[];
+    /** The permission catalog, used to name the permissions that make a role unavailable. */
+    permissions: Permission[];
+    /** What the issuer holds. A role holding anything outside this set cannot be chosen. */
+    ownPermissionKeys: string[];
+    /** The chosen role id, or `""` for none. */
+    value: string;
+    onValueChange: (roleId: string) => void;
+    /** The group's visible heading. */
+    label?: string;
+    /** One line under the heading. */
+    description?: string;
+    disabled?: boolean;
+    className?: string;
+}
+/** Whether `roleId` names a role in `roles` that the issuer may choose. */
+export declare function isRoleSelectable(roleId: string, roles: Role[], own: ReadonlySet<string>): boolean;
+/** The id of the selectable role holding the fewest permissions (the first of any tie), or `""` when none is selectable. */
+export declare function leastPrivilegeRoleId(roles: Role[], own: ReadonlySet<string>): string;
+export declare function RoleKeyPicker({ roles, permissions, ownPermissionKeys, value, onValueChange, label, description, disabled, className, }: RoleKeyPickerProps): import("react").JSX.Element;

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

@@ -12,7 +12,9 @@ export * from "./RolesPermissionsPage";
 export * from "./MembersPanel";
 export * from "./ChangePasswordForm";
 export * from "./SessionsList";
+export * from "./RoleKeyPicker";
 export * from "./ApiKeysPanel";
+export * from "./AccessRequestPanel";
 export * from "./InvitationsList";
 export * from "./InviteMembersDialog";
 export * from "./Brand";

package/dist/types/index.d.ts

@@ -75,6 +75,7 @@ export { ConcentricRing, type ConcentricRingProps, type ConcentricRingLevel, } f
 export { Stat, StatRow, Sparkline, type StatProps, type StatRowProps, type SparklineProps, type StatSize, type StatTrend, type StatSentiment, } from "./components/Stat";
 export { ShareBar, type ShareBarProps, type ShareBarSegment, } from "./components/chart/ShareBar";
 export { BarList, type BarListProps, type BarListItem, } from "./components/chart/BarList";
+export { TimeSeriesChart, type TimeSeriesChartProps, type TimeSeriesSeries, type TimeSeriesRole, type TimeSeriesBlock, type TimeSeriesBlockKind, } from "./components/chart/TimeSeriesChart";
 export { CHART_SERIES_COUNT, CHART_SERIES_TOKENS, CHART_SEQUENTIAL_TOKEN, CHART_SEQUENTIAL_COLOR, chartSeriesColor, } from "./lib/chart-palette";
 export { DataTable, TableEmptyState, CellStack, type DataTableProps, type TableDensity, } from "./components/Table";
 export { CodeEditor, CodeEditorToolbar, CodeEditorCaption, CodeEditorCopyButton, CodeEditorWrapToggle, CodeEditorViewSwitch, type CodeEditorProps, type CodeEditorToolbarProps, type CodeEditorView, } from "./components/CodeEditor";
@@ -147,7 +148,7 @@ export { cellLabel, eventLabel, formatDateRange, longDate, monthTitle, timeOfDay
 export { initialFocusDay, isInMonth, nextDayForKey, useGridNavigation, type GridNavigation, type GridNavigationOptions, } from "./components/calendar/use-grid-navigation";
 export { AmbiguousTimeError, addDays, addDuration, addMonths, atMidnight, atTime, comparePlainDate, dayFraction, dayLengthMs, dayOfWeek, daysBetween, daysInMonth, endOfMonth, hoursInDay, instantAtFraction, instantToPlainDate, instantToPlainDateTime, isSameDate, isoDateString, isoDateTimeString, monthGridDays, nextDay, offsetAt, parsePlainDate, plainDateTimeToInstant, relativeAge, startOfDay, startOfMonth, startOfWeek, weekDays, type CalendarDuration, type Disambiguation, type Instant, type PlainDate, type PlainDateTime, type TimeZone, } from "./lib/time";
 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, Can, useHasPermission, AccountMenu, AccountMenuSection, TeamSwitcher, DevToolsPopover, RolePermissionMatrix, RoleEditorDialog, ProfileForm, ProfilePage, RolesPermissionsPage, MembersPanel, ChangePasswordForm, SessionsList, ApiKeysPanel, InvitationsList, InviteMembersDialog, Brand, TeamSettingsForm, DangerZone, type RBACProviderProps, type RBACHookResult, type CanProps, type AccountMenuProps, type TeamSwitcherProps, type DevToolsPopoverProps, type RolePermissionMatrixProps, type RoleEditorDialogProps, type RoleEditorDialogSubmitInput, type ProfileFormProps, type ProfileFormAccount, type ProfileFormSaveInput, type ProfilePageProps, type RolesPermissionsPageProps, type MembersPanelProps, type MembersPanelMember, type ChangePasswordFormProps, type SessionsListProps, type Session, type ApiKeysPanelProps, type ApiKey, type InvitationsListProps, type InvitationsListItem, type InvitationStatus, type InviteMembersDialogProps, type Permission, type Role, type User, type Team, type TeamMembership, type BrandProps, type TeamSettingsFormProps, type TeamSettingsFormTeam, type TeamSettingsFormSaveInput, type DangerZoneProps, } from "./components/rbac";
+export { RBACProvider, useRBAC, Can, useHasPermission, AccountMenu, AccountMenuSection, TeamSwitcher, DevToolsPopover, RolePermissionMatrix, RoleEditorDialog, ProfileForm, ProfilePage, RolesPermissionsPage, MembersPanel, ChangePasswordForm, SessionsList, ApiKeysPanel, AccessRequestPanel, RoleKeyPicker, isRoleSelectable, leastPrivilegeRoleId, InvitationsList, InviteMembersDialog, Brand, TeamSettingsForm, DangerZone, type RBACProviderProps, type RBACHookResult, type CanProps, type AccountMenuProps, type TeamSwitcherProps, type DevToolsPopoverProps, type RolePermissionMatrixProps, type RoleEditorDialogProps, type RoleEditorDialogSubmitInput, type ProfileFormProps, type ProfileFormAccount, type ProfileFormSaveInput, type ProfilePageProps, type RolesPermissionsPageProps, type MembersPanelProps, type MembersPanelMember, type ChangePasswordFormProps, type SessionsListProps, type Session, type ApiKeysPanelProps, type ApiKey, type AccessRequestPanelProps, type AccessRequest, type AccessRequestKind, type AccessRequestState, type RoleKeyPickerProps, type InvitationsListProps, type InvitationsListItem, type InvitationStatus, type InviteMembersDialogProps, type Permission, type Role, type User, type Team, type TeamMembership, type BrandProps, type TeamSettingsFormProps, type TeamSettingsFormTeam, type TeamSettingsFormSaveInput, type DangerZoneProps, } from "./components/rbac";
 export { AuthLayout, AcceptInvitationCard, SignupCard, TermsAcceptance, LoginForm, ForgotPasswordForm, ResetPasswordForm, type AuthLayoutProps, type AcceptInvitationCardProps, type SignupCardProps, type TermsAcceptanceProps, type LoginFormProps, type ForgotPasswordFormProps, type ResetPasswordFormProps, } from "./components/auth";
 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, ProvenanceDetail, ProvenanceBadge, ConfidenceReadout, ConfidenceMeter, ConfidenceBar, provenanceStateLabel, confidenceBand, confidenceScore, scoredConfidence, ratedConfidence, type ProvenanceRecord, type ProvenanceState, type ProvenanceSource, type ProvenanceCheck, type ProvenanceCall, type ProvenanceSignoff, type ConfidenceBand, type ConfidenceScore, type ProvenanceConfidence, type ConfidenceReadoutProps, type ConfidenceBarProps, type ConfidenceBarSize, type ProvenanceDisclosureProps, type ProvenanceDetailProps, type ProvenanceDetailTitleAs, type ProvenanceTriggerBadge, type ProvenanceBadgeProps, type ProvenanceBadgeAppearance, type ConfidenceMeterProps, } from "./components/provenance";

package/package.json

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