@50arms/ui 0.0.0-stage → 35.2.0

package/dist/types/index.d.ts

@@ -0,0 +1,209 @@
+/**
+ * 50 Arms — public library surface.
+ *
+ * This single entry is the contract for BOTH build targets: the ESM package
+ * that applications import, and the compiled global bundle that Claude Design
+ * loads. A component that is not exported here exists in neither.
+ *
+ * Every props interface is named `<Name>Props` — the design agent reads those
+ * type names directly, and consumers get predictable imports.
+ */
+import "./styles/lib.css";
+export { Icon, type IconProps, type IconSize, type IconName } from "./components/Icon";
+export { getIcon, hasIcon, iconNames, type IconNode, type IconNodeChild, } from "./lib/icons";
+export { coreIcons, type CoreIconName } from "./icons/data";
+export { Button, type ButtonProps } from "./components/Button";
+export { ListItemButton, type ListItemButtonProps } from "./components/Button";
+export { IconButton, type IconButtonProps, type IconButtonVariant, type IconButtonTone, type IconButtonBadge, type IconButtonBadgeTone, } from "./components/IconButton";
+export { CountBadge, type CountBadgeTone } from "./components/CountBadge";
+export { Badge, BADGE_NEUTRAL_TONE, BADGE_TONE_TEXT, type BadgeProps, type BadgeDismiss, } from "./components/Badge";
+export { Attention, type AttentionProps, type AttentionShape, type AttentionTone, type AttentionEffect, type AttentionEffects, type AttentionSpeed, type AttentionIntensity, } from "./components/Attention";
+export { Callout, type CalloutProps } from "./components/Callout";
+export { Spinner, type SpinnerProps } from "./components/Spinner";
+export { AgentWorkingSpinner, type AgentWorkingSpinnerProps, } from "./components/AgentWorkingSpinner";
+export { Skeleton, SkeletonText, LoadingOverlay, LoadRegion, type SkeletonProps, type SkeletonTextProps, type LoadingOverlayProps, type LoadRegionProps, } from "./components/Loading";
+export { ErrorBoundary, type ErrorBoundaryProps } from "./components/ErrorBoundary";
+export { Field, FieldSet, type FieldProps, type FieldSetProps } from "./components/Field";
+export { Input, Textarea, type InputProps, type TextareaProps } from "./components/Input";
+export { InlineEdit, type InlineEditProps } from "./components/InlineEdit";
+export { EditGutter, type EditGutterProps } from "./components/EditGutter";
+export { InlineMarkdownEdit, type InlineMarkdownEditProps } from "./components/InlineMarkdownEdit";
+export type { EditActivation } from "./components/edit/activation";
+export type { EditCommit, EditOutcome, EditRefusal } from "./components/edit/outcome";
+export type { CommitMode } from "./components/edit/use-edit-session";
+export { SecretField, type SecretClearMode, type SecretFieldProps, type SecretStatus, type SecretValue } from "./components/SecretField";
+export { SearchInput, type SearchInputProps } from "./components/SearchInput";
+export { PasswordInput, type PasswordInputProps } from "./components/PasswordInput";
+export { PasswordRequirements, type PasswordRequirementsProps, type PasswordRequirementRule, } from "./components/PasswordRequirements";
+export { SettingRow, SettingGroup, type SettingRowProps, type SettingGroupProps, type SettingRowControlRenderProps, } from "./components/SettingRow";
+export { DescriptionList, DescriptionListItem, type DescriptionListProps, type DescriptionListItemProps, type DescriptionListEntry, } from "./components/DescriptionList";
+export { ConnectionCard, type ConnectionCardProps, type ConnectionHealth, } from "./components/ConnectionCard";
+export { Checkbox, Switch, Radio, RadioGroup, CheckboxField, SwitchField, RadioField, RadioCard, type CheckboxProps, type SwitchProps, type RadioProps, type RadioGroupProps, type CheckboxFieldProps, type SwitchFieldProps, type RadioFieldProps, type RadioCardProps, } from "./components/Choice";
+export { TriStateSwitch, type TriStateSwitchProps, type TriStateSwitchSize, } from "./components/TriStateSwitch";
+export { RatingScale, RatingFace, type RatingScaleProps, type RatingFaceProps, type RatingScaleSize, type RatingValue, } from "./components/RatingScale";
+export { ToggleMatrix, type ToggleMatrixProps, type ToggleMatrixRow, type ToggleMatrixColumn, type ToggleMatrixCell, } from "./components/ToggleMatrix";
+export { Dialog, DialogClose, AlertDialog, type DialogProps, type AlertDialogProps, } from "./components/Dialog";
+export { Drawer, type DrawerProps } from "./components/Drawer";
+export { useMediaQuery, useBelow, BREAKPOINTS, type Breakpoint } from "./lib/use-media-query";
+export { Popover, PopoverClose, Tooltip, TooltipProvider, type PopoverProps, type TooltipProps, } from "./components/Popover";
+export { Toaster, ToastProvider, useToast, type ToasterProps, type ToastProviderProps, type ToastOptions, type ToastTone, } from "./components/Toast";
+export { Menu, MenuItem, MenuGroup, MenuRadioGroup, MenuRadioItem, MenuCheckboxItem, MenuSeparator, type MenuProps, type MenuItemProps, type MenuItemTone, type MenuGroupProps, type MenuRadioGroupProps, type MenuRadioItemProps, type MenuCheckboxItemProps, } from "./components/Menu";
+export { ThemeMenu, ThemePanel, themeIcon, type ThemeMenuProps } from "./components/ThemeMenu";
+export { useHeaderFold } from "./lib/header-fold";
+export { AppShell, type AppShellProps, type NavItem, type NavSection, } from "./components/AppShell";
+export { SectionNav, type SectionNavProps } from "./components/SectionNav";
+export { LegalDocument, type LegalDocumentProps } from "./components/LegalDocument";
+export { countUnconfirmed, legalSectionAnchor, splitUnconfirmed, type LegalBlock, type LegalDocumentValue, type LegalSection, type LegalTextRun, } from "./lib/legal-document";
+export { FileUpload, type FileUploadProps, type UploadFile } from "./components/FileUpload";
+export { ImageUploadField, type ImageUploadFieldProps, type ImageUploadFieldShape, type ImageUploadFieldSize, } from "./components/ImageUploadField";
+export { DatePicker, type DatePickerProps, type DateRange } from "./components/DatePicker";
+export { ColorPicker, type ColorPickerProps } from "./components/ColorPicker";
+export { hexToHsv, hsvToHex, isHexColor, type Hsv } from "./lib/color";
+export { DateCalendar, type DateCalendarProps } from "./components/DateCalendar";
+export { DateField, DateTimeField, type DateFieldProps, type DateTimeFieldProps, } from "./components/DateField";
+export { Tree, type TreeProps, type TreeNode } from "./components/Tree";
+export { CommandPalette, useCommandPalette, type CommandPaletteProps, type CommandItem, } from "./components/CommandPalette";
+export { Slider, type SliderProps, type SliderMark } from "./components/Slider";
+export { NumberInput, type NumberInputProps } from "./components/NumberInput";
+export { OTPInput, type OTPInputProps } from "./components/OTPInput";
+export { Combobox, ComboboxItem, ComboboxGroup, MultiCombobox, type ComboboxProps, type ComboboxItemProps, type ComboboxGroupProps, type MultiComboboxProps, } from "./components/Combobox";
+export { Select, SelectItem, SelectGroup, SelectSeparator, type SelectProps, type SelectItemProps, type SelectGroupProps, } from "./components/Select";
+export { StatusSelect, type StatusSelectProps, type StatusOption } from "./components/StatusSelect";
+export { FilterMenu, FilterChips, activeFilterCount, singleFilter, multipleFilter, type FilterMenuProps, type FilterChipsProps, type FilterField, type FilterSingleField, type FilterMultipleField, type FilterBooleanField, type FilterDateRange, type FilterDateRangeField, type FilterTextField, type FilterOption, type FilterTone, } from "./components/FilterMenu";
+export { SortMenu, type SortMenuProps, type SortOption, type SortValue, type SortDirection } from "./components/SortMenu";
+export { ListHeader, type ListHeaderProps, type ListFilters } from "./components/ListHeader";
+export { Card, CardHeader, CardFooter, type CardProps, type CardHeaderProps, } from "./components/Card";
+export { RecordCard, RecordCardHandle, RecordCardEyebrow, RecordCardTitle, RecordCardBadges, RecordCardMedia, RecordCardMeta, type RecordCardProps, type RecordCardMetric, type RecordCardHandleProps, type RecordCardEyebrowProps, type RecordCardTitleProps, type RecordCardBadgesProps, type RecordCardMediaProps, type RecordCardMetaProps, } from "./components/RecordCard";
+export { Tabs, TabList, Tab, TabPanel, type TabsProps, type TabListProps, type TabProps, type TabPanelProps, } from "./components/Tabs";
+export { Accordion, AccordionItem, type AccordionProps, type AccordionItemProps, } from "./components/Accordion";
+export { Breadcrumb, Pagination, type BreadcrumbProps, type PaginationProps, type Crumb, } from "./components/Navigation";
+export { PaginationBar, type PaginationBarProps, type PaginationBarMode, } from "./components/PaginationBar";
+export { Stepper, stepStatus, stepperProgress, advanceBlockReason, assertSteps, type StepperProps, type Step, type StepStatus, type StepperProgress, } from "./components/stepper";
+export { StatusChecklist, tallyChecklist, type StatusChecklistProps, type ChecklistItem, type ChecklistState, type ChecklistTally, } from "./components/checklist";
+export { Toggle, ToggleGroup, Toolbar, ToolbarButton, ToolbarGroup, ToolbarInput, ToolbarSeparator, type ToggleProps, type ToggleGroupProps, type ToolbarProps, type ToolbarButtonProps, type ToolbarGroupProps, type ToolbarInputProps, } from "./components/Toggle";
+export { Separator, ScrollArea, Collapsible, CollapsibleRoot, CollapsibleTrigger, CollapsiblePanel, EmptyState, Timeline, type SeparatorProps, type ScrollAreaProps, type CollapsibleProps, type CollapsibleRootProps, type CollapsibleTriggerProps, type CollapsiblePanelProps, type EmptyStateProps, type TimelineProps, type TimelineItem, } from "./components/Surface";
+export { PanelGroup, Panel, PanelResizer, type PanelGroupProps, type PanelProps, type PanelResizerProps, type PanelDirection, type PanelNarrowMode, } from "./components/Panel";
+export { Avatar, AvatarGroup, type AvatarProps, type AvatarGroupProps, type AvatarStatus, } from "./components/Avatar";
+export { Progress, Meter, ProgressRing, type ProgressProps, type MeterProps, type MeterMarkerProps, type ProgressRingProps, type ProgressRingValueProps, type ProgressRingSegmentsProps, type ProgressRingSegment, type ProgressTone, } from "./components/Progress";
+export { ConcentricRing, type ConcentricRingProps, type ConcentricRingLevel, } from "./components/ConcentricRing";
+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 { LineChart, type LineChartProps, type LineSeries, type LinePoint, type LineReference, type LineMarker, } from "./components/chart/LineChart";
+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";
+export { Markdown, CodeBlock, type MarkdownProps, type CodeBlockProps } from "./components/Markdown";
+export { LineDiff, type LineDiffProps } from "./components/LineDiff";
+export { PatchDiff, type PatchDiffProps, type PatchDiffStatus } from "./components/PatchDiff";
+export { IconStack, type IconStackProps, type IconStackItem, type IconStackBadge, type IconStackTone, type IconStackSize, } from "./components/IconStack";
+export { MarkdownEditor, type MarkdownEditorProps, type MarkdownEditorHandle, } from "./components/MarkdownEditor";
+export type { SubmitAction } from "./lib/submit-shortcut";
+export { ReadMore, type ReadMoreProps } from "./components/ReadMore";
+export { SandboxedFrame, type SandboxedFrameFit, type SandboxedFrameProps, } from "./components/SandboxedFrame";
+export { DESIGN_FRAME_APPEARANCE, DESIGN_FRAME_READY, DESIGN_FRAME_ERROR, DESIGN_FRAME_ERROR_MAX_LENGTH, DESIGN_FRAME_HEIGHT, DESIGN_FRAME_HEIGHT_MAX, type DesignFrameAppearance, type DesignFrameAppearanceMessage, type DesignFrameReadyMessage, type DesignFrameErrorMessage, type DesignFrameHeightMessage, type DesignFrameInboundMessage, } from "./lib/design-frame/protocol";
+export { DANX_MINI_APP_METHODS, type DanxMiniApp } from "./lib/design-frame/mini-app";
+export { MarkdownSurface, type SurfaceOptions, type Splice } from "./lib/markdown/surface";
+export { project, projectedText, ProjectionError } from "./lib/markdown/project";
+export type { Projection, PNode, PText, PElement } from "./lib/markdown/project";
+export { attachInput, type InputOptions } from "./lib/markdown/input";
+export { HOTKEYS, hotkeyFor, chordsOf, type Hotkey, type HotkeyGroup, type EditorRequest, type HotkeyId } from "./lib/markdown/hotkeys";
+export { MarkdownImageUploadProvider, type MarkdownImageUploadProviderProps, } from "./components/markdown/ImageUpload";
+export type { ImageUploader, ImageUploadState } from "./lib/markdown/image-pipeline";
+export { findUnstoredImages, isUnstoredImageSrc, type UnstoredImage } from "./lib/markdown/images";
+export { htmlFragmentToMarkdown } from "./lib/markdown/paste";
+export { lineAt, stepOffset } from "./lib/markdown/caret";
+export { caretMap, nearestStop, stepStop, graphemeBefore, graphemeAfter, lineStartStop, type CaretMap, } from "./lib/markdown/caret-map";
+export { deleteVisible, deleteVisibleBefore, deleteVisibleAfter } from "./lib/markdown/edit";
+export { resolveKey, type KeyIntent, type KeyContext } from "./lib/markdown/keys";
+export { blockAt, convertBlock, setFenceLanguage, constructAt, editConstruct, unwrapConstruct, type BlockKind, type BlockInfo, type ConstructInfo, } from "./lib/markdown/convert";
+export { readSelection, writeSelection, sourceOffsetAt, domPointAt, type SourceSelection, type DomPoint, type Association, } from "./lib/markdown/position";
+export type { Command, Edit } from "./lib/markdown/commands";
+export { toggleBold, toggleItalic, toggleCode, toggleStrike, toggleInline, setHeading, adjustHeading, headingLevel, toggleList, toggleTask, indentLines, outdentLines, toggleQuote, toggleCodeBlock, fenceAround, insertRule, insertImage, insertLink, insertTable, insertRow, insertColumn, deleteRow, deleteColumn, deleteTable, alignColumn, tableAround, cellsOf, cellAt, tableTab, smartEnter, smartTab, smartShiftTab, } from "./lib/markdown/commands";
+export { tokenize, listLanguages, resolveLanguage, defineGrammar, registerGrammar, checkCoverage, type Token, type TokenType, type Grammar, type Rule, } from "./lib/syntax";
+export { parseMarkdown, MarkdownNodes, sanitizeHref, type MdNode, type MdInline, type MdCodeRenderer, MarkdownRefProvider, RefText, type MarkdownRefProviderProps, } from "./lib/syntax/markdown";
+export { DragDrop, DragDropContainer, DragDropGroup, DragDropItem, DragDropHandle, DragDropSurface, type DragDropProps, type DragDropContainerProps, type DragDropGroupProps, type DragDropItemProps, type DragDropHandleProps, type DragDropSurfaceProps, } from "./components/DragDrop";
+export { KanbanBoard, type KanbanBoardProps, type KanbanLane, type KanbanMove, type KanbanRefusal, } from "./components/kanban/KanbanBoard";
+export { DRAG_INSTRUCTIONS_ID, DragInstructions, DragLiveRegion, DragSession, DragSessionProvider, applyMove, attachAutoScroll, attachKeyboardSensor, attachPointerSensor, attachSessionWindowListeners, isNoOp, resolveTarget, sameTarget, scrollVelocity, useCreateDragSession, useDragAnnouncements, useDragSession, useDragState, useDragLive, useDraggable, useDropContainer, type ContainerId, type CrossDrop, type DragAxis, type DragCancelEvent, type DragEndEvent, type DragId, type DragMode, type DragPhase, type DragSessionCallbacks, type DragStartEvent, type DragState, type AutoScrollOptions, type DragAnnouncementContext, type DragAnnouncementOptions, type DragAnnouncements, type DragInstructionsProps, type DragLiveRegionProps, type DropTarget, type KeyboardSensorOptions, type PointerActivation, } from "./lib/dnd";
+export { Board, BoardColumn, BoardCard, BoardCardGroup, BoardCardSurface, type BoardProps, type BoardColumnProps, type BoardCardProps, type BoardCardGroupProps, type BoardCardSurfaceProps, } from "./components/Board";
+export { buildBoardModel, resolveMove, applyBoardMoves, describeMoveRejection, useBoard, moveAnchor, columnLength, positionInColumn, type BoardModel, type MoveAnchor, type UseBoardResult, } from "./lib/board";
+export type { BoardAccessors, BoardColumnDef, BoardEdge, BoardColumnId, BoardColumnModel, BoardItemId, BoardMove, BoardMoveTarget, BoardMoveRequest, BoardMoveSource, BoardMoveOutcome, BoardMoveRejection, BoardMoveVerdict, BoardReorderLabels, UseBoardOptions, } from "./lib/board";
+export { CardFace, CommentCountMark, type CardFaceProps, type CardFaceModel, type CardFaceMark, type CardFaceCount, type CardFaceComments, type CardFaceHold, type CardFaceSlot } from "./components/card-face/CardFace";
+export { GateRingGlyph, type GateRingGlyphProps, type GateRingEntry, type GatePhase } from "./components/card-face/GateRingGlyph";
+export { AcRingGlyph, type AcRingGlyphProps, type AcRingItem } from "./components/card-face/AcRingGlyph";
+export { EffortBadge, type EffortBadgeProps } from "./components/card-face/EffortBadge";
+export { CardTypeBadge, CardTypeChip, type CardTypeBadgeProps, type CardFaceType } from "./components/card-face/CardTypeBadge";
+export { BoardCardAgentSlot, type BoardCardAgent } from "./components/card-face/BoardCardAgentSlot";
+export { TapTip, TAP_TIP_SELECTOR, type TapTipProps } from "./components/card-face/TapTip";
+export { OverflowRow, hiddenKeys, type OverflowItem, type OverflowRowProps } from "./components/card-face/OverflowRow";
+export { COARSE_HIT_AREA, ROW_RING_SIZE } from "./components/card-face/hit-area";
+export { CARD_FACE_ICONS, PRIORITY_TIERS, PRIORITY_TIER_VISUALS, GATE_VERDICTS, GATE_VERDICT_VISUALS, CRITERION_STATES, CRITERION_STATE_VISUALS, EFFORT_RUNGS, effortColors, paletteBadgeClassName, paletteBoxClassName, paletteTextClassName, type CardFaceTone, type PriorityTier, type GateVerdict, type CriterionState, type EffortRung, } from "./components/card-face/vocabulary";
+export { ContextItemRow, ContextSummary, CONTEXT_SOURCE_TONE, type ContextItemRowProps, type ContextSummaryProps, type ContextSource, } from "./components/ContextItemRow";
+export { SignOffRings, SIGN_OFF_TONE, SIGN_OFF_TEXT_CLASS, signOffFill, type SignOffRingsProps, type SignOffActor, } from "./components/SignOffRings";
+export { GatesSection, SectionHeading, type GatesSectionProps, type GatesSectionPhase, type GatesSectionGate, type GatesSectionCarriedGate, type GatesSectionInactiveGate, type GatesSectionFinding, } from "./components/GatesSection";
+export { SolutionChoice, type SolutionChoiceProps, type SolutionChoiceActions, type SolutionChoiceAction, type SolutionChoiceProCon, } from "./components/SolutionChoice";
+export { PagedWindowList, type PagedWindowItemPosition, type PagedWindowListProps, } from "./components/PagedWindowList";
+export { PAGED_WINDOW_SETTLE_MS, PagedWindowStore, usePagedWindow, windowPageNumbers, type LoadCount, type LoadPage, type LoadPageContext, type PageResponse, type PageSnapshot, type PageStatus, type PagedWindow, type PagedWindowMode, type PagedWindowOptions, type PagedWindowRecordsOptions, type PlacementEdges, type PagedWindowSnapshot, type UsePagedWindowOptions, } from "./lib/paged-window";
+export type { MessageRole, MessagePart, TextPart, CodePart, ReasoningPart, ToolPart, ToolStatus, FilePart, ComponentPart, ChatFile, ChatMessage, RenderContext, PartRenderer, PartRenderers, ChatComponentRenderer, ChatComponents, } from "./components/chat/types";
+export { Chat, ChatPopover, type ChatProps, type ChatPopoverProps, type ChatSurface, } from "./components/chat/Chat";
+export { Message, MessagePartView, ToolCall, type MessageProps, type MessageAction, type MessagePartViewProps, type ToolCallProps, } from "./components/chat/Message";
+export { MessageScroller, type MessageScrollerProps, } from "./components/chat/MessageScroller";
+export { Composer, type ComposerProps } from "./components/chat/Composer";
+export { StreamingMarkdown, type StreamingMarkdownProps, } from "./components/chat/StreamingMarkdown";
+export { Attachment, AttachmentAction, AttachmentList, type AttachmentProps, type AttachmentActionProps, type AttachmentListProps, type AttachmentLayout, } from "./components/chat/Attachment";
+export { FileCover, type FileCoverProps } from "./components/chat/FileCover";
+export { FileViewer, PageNumberJumpField, type FileViewerProps, type PageNumberJumpFieldProps, type ViewerFile, type ViewerFrame, type ViewerPage, } from "./components/file-viewer";
+export { fileIconFor, type FileIdentity, type ReferenceKind } from "./components/chat/file-icon";
+export { VideoPlayer, type VideoPlayerProps, type VideoTrack } from "./components/VideoPlayer";
+export { ModelSelector, type ModelSelectorProps, type ChatModel, } from "./components/chat/ModelSelector";
+export { EffortControl, type EffortControlProps, type EffortLevel, } from "./components/chat/EffortControl";
+export { ContextMeter, ChatStatus, type ContextMeterProps, type ContextSegment, type UsageLimit, type ChatStatusProps, } from "./components/chat/ContextMeter";
+export { cn } from "./lib/cn";
+export { formatBytes, formatTokens, formatCompactNumber } from "./lib/format";
+export { copyText } from "./lib/clipboard";
+export { DateTimeText, useDateTimeText, type DateTimeTextProps } from "./components/DateTimeText";
+export { RelativeTime, useRelativeText, type RelativeTimeProps } from "./components/RelativeTime";
+export type { RelativeFormat } from "./lib/time/relativeClock";
+export { toEpochMs } from "./lib/time/instant";
+export { CopyValue, type CopyValueProps } from "./components/CopyValue";
+export { formatDate, parseDate, formatDateTime, parseDateTime, type FormatDateTimeOptions, type ParseDateTimeOptions, formatCurrency, parseCurrency, formatNumber, parseNumber, type FormatNumberOptions, formatBoolean, parseBoolean, type FormatBooleanOptions, } from "./lib/values";
+export { COMPONENT_GUIDANCE, type ComponentGuidanceRule } from "./lib/component-guidance";
+export { useFillHeight } from "./lib/use-fill-height";
+export { useTheme, ThemeDefaultProvider, useUiScale, useContrast, useMotionPreference } from "./lib/preferences";
+export { useHydrated } from "./lib/use-hydrated";
+export { useReducedMotion } from "./lib/motion";
+export type { Theme, UiScale, ContrastPreference, MotionPreference } from "./lib/preference-values";
+export { usePersistedState, readStored, writeStored, clearStored, storageKey, type PersistedStateOptions, } from "./lib/persist";
+export { CalendarMonth, type CalendarMonthProps } from "./components/calendar/CalendarMonth";
+export { CalendarTimeGrid, type CalendarTimeGridProps, } from "./components/calendar/CalendarTimeGrid";
+export { useNow, type UseNowOptions } from "./components/calendar/use-now";
+export { EventActions, type EventActionsProps } from "./components/calendar/EventActions";
+export { useCalendarDrag, type CalendarDragOptions, type CalendarDragState, } from "./components/calendar/use-calendar-drag";
+export { useEventKeyboard, type EventKeyboardOptions, type EventKeyboardState, } from "./components/calendar/use-event-keyboard";
+export { applyCalendarDelta, calendarDragResult, createdEvent, describeTarget, resolveCalendarTarget, snapInstant, MIN_DURATION_MINUTES, type CalendarDragOrigin, type CalendarDragResult, type CalendarTarget, type ColumnRect, } from "./lib/calendar/drag";
+export { EVENT_PALETTE, DEFAULT_PALETTE_KEY, isPaletteKey, paletteFor, } from "./components/calendar/palette";
+export { cellLabel, eventLabel, formatDateRange, longDate, monthTitle, timeOfDay, weekdayName, zoneLabel, } from "./components/calendar/format";
+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 PaletteKey, type TimeSegment, type TimedEvent, type VisibleRange, } from "./lib/calendar";
+export { RBACProvider, useRBAC, Can, useHasPermission, AccountMenu, AccountMenuSection, TeamSwitcher, DevToolsPopover, DevToolsPanel, DEV_TOOLS_ICON, RolePermissionMatrix, RoleEditorDialog, ProfileForm, ProfilePage, RolesPermissionsPage, MembersPanel, ChangePasswordForm, SessionsList, ApiKeysPanel, AgentKeysList, AccessRequestPanel, PermissionRequestPanel, RoleKeyPicker, isRoleSelectable, leastPrivilegeRoleId, InvitationsList, InviteMembersDialog, Brand, TeamSettingsForm, DangerZone, type RBACProviderProps, type RBACHookResult, type CanProps, type AccountMenuProps, type AccountMenuAction, type TeamSwitcherProps, type DevToolsPopoverProps, type DevToolsPanelProps, 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 AgentKeysListProps, type ApiKey, type KeyGrant, type KeyRoleEditor, type AccessRequestPanelProps, type RoleAccessRequestPanelProps, type MachineAccessRequestPanelProps, type AccessRequest, type AccessRequestKind, type IssuedKey, type AccessRequestState, type ExpiredNote, type PermissionRequestPanelProps, type PermissionRequest, 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, SignInProviders, TermsAcceptance, LoginForm, ForgotPasswordForm, ResetPasswordForm, type AuthLayoutProps, type AcceptInvitationCardProps, type SignupCardProps, type SignupInitialValues, type AcceptInvitationInitialValues, type SignInProvidersProps, type ProviderSelection, type SignInProvider, type SignInProviderId, type VerifiedIdentity, type ProviderContinuation, 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 { OrderedEntityManager, type OrderedEntity, type OrderedEntityManagerProps, type OrderedEntityRowStatus, } from "./components/OrderedEntityManager";
+export { EmojiPicker, type EmojiPickerProps, type EmojiOption, } from "./components/EmojiPicker";
+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";
+export { confidenceLevel, CONFIDENCE_LEVEL_LABELS, type ConfidenceLevel } from "./lib/confidence";
+export { createSimStore, resetSimStores, useSimSettings, setSimSettings, getNetworkSpeed, getDataSource, simulateLatency, SimNetworkError, type SimStore, type SimStoreOptions, type SimSettings, type NetworkSpeed, type DataSource, type SimNamespace, } from "./lib/sim";
+export { NodeCanvas, LAYOUT_DEFAULTS, edgePath, layoutGraph, neighbourhood, type NodeCanvasProps, type CanvasCycleScope, type CanvasEdge, type CanvasGraph, type CanvasGroup, type CanvasLayout, type CanvasNode, type CanvasOrientation, type CanvasPlacedEdge, type CanvasScope, type LayoutOptions, type NodeRenderContext, type NodeRenderer, type PlacedNode, } from "./components/node-canvas";
+export { GraphExplorer, frameBoxFor, layoutExplorerTree, neighbourhoodTree, CAMERA_DEFAULTS, centerOn, clampScale, fitBox, fitBoxWithFloor, fitWidth, toContentPoint, toScreenPoint, unionBox, zoomAtPoint, type GraphExplorerProps, type Box, type CameraState, type FitOptions, type FitWithFloorOptions, type FitWithFloorResult, type FrameOverflow, type Point, type ScaleBounds, type Size, type CrossLink, type ExplorerLayout, type ExplorerNodeRenderContext, type ExplorerNodeRenderer, type ExplorerTree, type GraphExplorerVariant, type TreeNode as ExplorerTreeNode, } from "./components/graph-explorer";
+export { FocusWeb, CENTER_POSITION, PARENT_POSITION, WIDE_RING_THRESHOLD, layoutRing, type FocusNodeRenderContext, type FocusNodeRenderer, type FocusNodeRole, type FocusWebNode, type FocusWebNodeLook, type FocusWebProps, type PlacedRingNode, } from "./components/focus-web";
+export { SequenceDiagram, type SequenceDiagramProps, type SequenceStep, } from "./components/SequenceDiagram";
+export { OpenApiViewer, type OpenApiViewerProps, OperationCard, type OperationCardProps, OperationHeader, type OperationHeaderProps, OperationDetail, type OperationDetailProps, SchemaView, type SchemaViewProps, groupOperations, isHttpMethod, mergedParameters, operationAnchorId, resolveSchema, resolveWebhooks, schemaToExample, type SchemaResolution, HTTP_METHODS, type HttpMethod, type OpenApiDocument, type OpenApiMediaType, type OpenApiOperation, type OpenApiParameter, type OpenApiParameterLocation, type OpenApiPathItem, type OpenApiRequestBody, type OpenApiResponse, type OpenApiSchema, type OpenApiSecurityRequirement, type OpenApiSecurityScheme, type OpenApiTag, type OperationGroup, type ResolvedOperation, } from "./components/openapi";
+export { defineRecordType, resetRecordTypes, useRecord, useRecords, useStaleness, write, writeAll, peekRecord, readState, readStaleness, subscribeToKey, subscribeToStaleness, retainKeys, sweepRecords, subscribeToLayers, layeredKeys, setRecordStoreTenant, getRecordStoreTenant, flushRecordNotifications, resetRecordStore, recordStoreStats, UNKNOWN_STATE, normalizeTypeName, normalizeTimestamp, recordKey, isRecordRef, type RecordRef, type ReadOptions, type RecordPayload, type RecordState, type RecordTypeOptions, type RecordTypeToken, type StalenessEntry, type WriteAllResult, type WriteOptions, type WriteResult, type WriteSource, type WriteVerdict, } from "./lib/records";
+export { RealtimeProvider, useRealtime, useRealtimeEpoch, useRealtimeHealth, useRealtimeRegistry, SubscriptionRegistry, normalizeScope, scopeKey, subscriptionKey, readRealtimeEpoch, subscribeToRealtimeEpoch, subscribeToRealtimeEvents, resetRealtimeSignals, type RealtimeChannel, type RealtimeConnectionState, type RealtimeDiagnostic, type RealtimeEvent, type RealtimeHealth, type RealtimeProviderProps, type RealtimeScope, type RealtimeScopeInput, type RealtimeStatus, type RealtimeTransport, type RegistryOptions, type SubscriptionHealth, type SubscriptionLease, type SubscriptionRequest, } from "./lib/realtime";
+export { useRecordRead, useRecordListRead, useRecordStoreSweep, applyMutationResult, optimisticWrite, beginOptimisticWrite, resetOptimisticWrites, type OptimisticHandle, type OptimisticWriteOptions, type OptimisticWriteSpec, type SlotDescriptor, acquireSlot, appendCreated, emptySlotSnapshot, readSlot, resetSlots, slotKeys, subscribeToSlot, writeSlot, RefetchRunner, reissueMountedReads, registerActiveRead, resetActiveReads, type ActiveRead, type ListFetch, type ListFetchResult, type ListReadOptions, type ListReadResult, type ReadError, type RecordFetch, type RecordReadOptions, type RecordReadResult, type RunnerOptions, type SlotSnapshot, } from "./lib/reads";
+export { chordLabel, ENGLISH_UI_STRINGS, UiLocaleProvider, useUiLocale, useUiStrings, type KeyId, type UiLocaleProviderProps, type UiLocaleValue, type UiStrings, } from "./lib/i18n";
+export type { BooleanStrings, FormatsStrings, ReadErrorStrings, RelativeAgeStrings } from "./lib/i18n/areas/formats";
+export { DateTimeline, type DateTimelineProps, type DateTimelineItem, type DateTimelineTone, type DateTimelineMarker, type DateTimelineMarkerPlacement, type DateTimelineMarkerLineStyle, } from "./components/date-timeline/DateTimeline";
+export { DEFAULT_PX_PER_DAY, MAX_PX_PER_DAY, MIN_PX_PER_DAY } from "./lib/date-timeline/scale";

package/dist/types/lib/attention.d.ts

@@ -0,0 +1,62 @@
+export type AttentionEffect = "ripple" | "pulse" | "glow" | "ring" | "beacon" | "shimmer" | "bounce" | "wiggle";
+export type AttentionSpeed = "slow" | "normal" | "fast" | number;
+export type AttentionIntensity = "subtle" | "medium" | "strong";
+/** Bottom to top. The two that move the control come last: they are not layers, so they have no place in the stack. */
+export declare const EFFECT_ORDER: readonly AttentionEffect[];
+/** The effects that move the control itself, of which a wrapper can run one. */
+export declare const MOTION_EFFECTS: readonly AttentionEffect[];
+/** One effect, or several to combine. */
+export type AttentionEffects = AttentionEffect | readonly AttentionEffect[];
+/** What a literal list naming both `bounce` and `wiggle` becomes: an object whose one key is the reason, so the type error says it. */
+export type AttentionEffectConflict = {
+    "Attention: bounce and wiggle both move the control itself, so they cannot be combined; pick one": never;
+};
+/**
+ * `E` itself, unless it is a literal list naming both `bounce` and `wiggle`. A list whose contents are only known
+ * at runtime (`AttentionEffect[]`) passes here and is checked by `resolveEffects`.
+ */
+export type ValidAttentionEffects<E> = E extends readonly AttentionEffect[] ? number extends E["length"] ? E : "bounce" extends E[number] ? "wiggle" extends E[number] ? AttentionEffectConflict : E : E : E;
+export interface ResolvedEffects {
+    /** The effects to draw, de-duplicated, in stacking order. */
+    effects: AttentionEffect[];
+    /** The motion effects that were asked for together and so are not drawn; `null` when there is no conflict. */
+    conflict: AttentionEffect[] | null;
+}
+export declare function resolveEffects(effect: AttentionEffects): ResolvedEffects;
+/** Effects that rest between bursts. Their cycle is the gap between two bursts. */
+export declare const PERIODIC_EFFECTS: readonly AttentionEffect[];
+export declare function isPeriodic(effect: AttentionEffect): boolean;
+export interface AttentionTiming {
+    /** The effect's own cycle, in ms: one wave for `ripple`, one breath for `pulse`/`glow`, one turn for `ring`, the whole period for the periodic effects. */
+    cycleMs: number;
+}
+/**
+ * How long one cycle of `effect` takes.
+ *
+ * `interval` only means something to the periodic effects (it IS their cycle);
+ * a continuous effect has no rest to size, so it ignores it, and `Attention`
+ * warns once in development rather than ignoring it in silence.
+ */
+export declare function resolveTiming(effect: AttentionEffect, speed: AttentionSpeed, interval?: number): AttentionTiming;
+export interface AttentionReach {
+    /** How far past the box's edge a wave that is not contained reaches, in px (`ripple` with `contain={false}`). */
+    reachPx: number;
+    /** The box's diagonal in px: the diameter a contained ripple circle needs to cover every corner. */
+    diagonal: number;
+    /** Scale the `beacon` ping grows to, across and down. */
+    reachX: number;
+    reachY: number;
+    /** Scale the `pulse` breath swells to, across and down. */
+    swellX: number;
+    swellY: number;
+    /** How far `wiggle` turns, in degrees. */
+    tilt: number;
+}
+/**
+ * The scale factors for a box of the given size. The shorter side decides how
+ * far a wave spreads, so a long thin control does not send a wave across the page.
+ */
+export declare function resolveReach(width: number, height: number, intensity: AttentionIntensity): AttentionReach | null;
+export declare const WAVE_REACH: readonly (readonly [number, number, number])[];
+export declare const MAX_RINGS: number;
+export declare function clampRings(rings: number): number;

package/dist/types/lib/board/anchor.d.ts

@@ -0,0 +1,69 @@
+/**
+ * ==== MOVE ANCHOR ====
+ *
+ * What a server needs to place a card the board moved, when the board holds
+ * only a window of the column (DX-4540). A drop knows exactly one thing about
+ * where it landed: which LOADED neighbours it is between. It never knows the
+ * card's position in the whole column, and a client that tries to compute one
+ * from `to.index` is wrong the moment the window does not start at the top.
+ * So the request names the neighbours, and the server finds the place.
+ *
+ * `to.index` counts the destination's LOADED cards with the moved card already
+ * removed (the board's one index rule), so the card lands before
+ * `rest[to.index]`, where `rest` is the destination's loaded cards without the
+ * moved one. ONE neighbour is named, because a server places a card relative to
+ * one: the card it lands directly above (`beforeId`) whenever there is one, and
+ * only at the end of the loaded run, where nothing is below, the card it lands
+ * directly below (`afterId`). An empty destination names nothing.
+ *
+ * A LANE MOVE IS ITS OWN ANSWER (DX-4583). It carries no position, so there is
+ * no neighbour to anchor to, and `{ lane: true }` says so: the server changes
+ * the card's lane and keeps its own rank. That is not the empty anchor, which
+ * says "the destination has no cards, so this is the first".
+ *
+ * AN EDGE INTENT TRUMPS THE NEIGHBOURS. "Move to top" in a window that starts
+ * at card 221 means the top of the column, which no loaded neighbour can say,
+ * so the anchor carries the edge and no ids.
+ */
+import type { BoardEdge, BoardItemId, BoardMove } from "./types";
+/**
+ * EXACTLY ONE field is set — a server's lane-move takes one — or none for an
+ * empty destination:
+ *   beforeId  the moved card lands directly above this loaded card
+ *   afterId   it lands directly below this one: only when it lands after the last
+ *             loaded card, where nothing is below to name
+ *   edge      it goes to the very top or bottom of the whole column
+ *   lane      a lane move: no position at all, the card keeps its rank
+ * None is set for an empty destination.
+ */
+export type MoveAnchor = {
+    beforeId: BoardItemId;
+    afterId?: never;
+    edge?: never;
+    lane?: never;
+} | {
+    afterId: BoardItemId;
+    beforeId?: never;
+    edge?: never;
+    lane?: never;
+} | {
+    edge: BoardEdge;
+    beforeId?: never;
+    afterId?: never;
+    lane?: never;
+} | {
+    lane: true;
+    beforeId?: never;
+    afterId?: never;
+    edge?: never;
+} | {
+    beforeId?: never;
+    afterId?: never;
+    edge?: never;
+    lane?: never;
+};
+/**
+ * @param destinationItems the destination column's LOADED cards (the moved card
+ *   may be among them, for a same-column move).
+ */
+export declare function moveAnchor<T>(destinationItems: readonly T[], move: BoardMove, getId: (item: T) => BoardItemId): MoveAnchor;

package/dist/types/lib/board/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The `lib/board` module's own barrel — model.ts, move.ts and use-board.ts
+ * (this agent's three files) plus a re-export of the sibling `types.ts` this
+ * module is built against. Mirrors `lib/dnd/index.ts`'s own shape for the
+ * same reason: a consumer reaching for anything board-related should have
+ * one import path, not one per file.
+ *
+ * NOT wired into the package's top-level `src/index.ts` — that barrel is
+ * owned by the contract's author, not this agent (see this round's brief).
+ */
+export type { BoardAccessors, BoardColumnDef, BoardEdge, BoardColumnId, BoardColumnModel, BoardItemId, BoardMove, BoardMoveTarget, BoardMoveRequest, BoardMoveSource, BoardMoveOutcome, BoardMoveRejection, BoardMoveVerdict, BoardReorderLabels, UseBoardOptions, } from "./types";
+export { buildBoardModel, type BoardModel } from "./model";
+export { describeMoveRejection } from "./rejection";
+export { moveAnchor, type MoveAnchor } from "./anchor";
+export { columnLength, positionInColumn } from "./position";
+export { applyBoardMoves, resolveMove, type ResolveMoveContext, type ResolvedMove, } from "./move";
+export { useBoard, type UseBoardResult } from "./use-board";

package/dist/types/lib/board/model.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ==== BOARD MODEL ====
+ *
+ * Pure derivation: `items` + column defs + accessors -> one `BoardColumnModel`
+ * per declared column, ready to render. No React, no mutation, no I/O other
+ * than the diagnostic `console.warn` below — the same inputs always produce
+ * the same output, which is what makes this testable without a browser and
+ * safe to call on every render (`use-board.ts` wraps it in a `useMemo`, it
+ * does not need to defend itself).
+ *
+ * WHY AN ITEM THAT MATCHES NO COLUMN IS NEVER DROPPED. GitHub Projects has a
+ * live, cited bug (RES-GAME / tracker) where grouping by parent silently
+ * drops sub-issues that carry a valid link — the item is real, the grouping
+ * key is merely stale, and the user has no way to discover the card still
+ * exists. A board built the same way inherits the identical bug the moment a
+ * column is renamed or retired out from under live data, which is routine
+ * here (a status gets retired, a card's derived status hasn't caught up to a
+ * board's `columns` prop yet, a consumer passes a filtered `columns` list).
+ * So an item whose `getColumnId` names no declared column is never
+ * discarded — it is routed into `unassigned`, a structurally present field
+ * of the model rather than a side channel a caller has to remember to check.
+ * Every item that goes in comes out somewhere: either inside exactly one
+ * `columns[].items`, or inside `unassigned`. That invariant is asserted by
+ * the "floor" test in board-core.test.ts, so a future edit that starts
+ * quietly filtering can't pass silently either.
+ *
+ * A single summarising `console.warn` also fires when any item orphans,
+ * matching the `[danxbot] …` prefix `ErrorBoundary.tsx` already uses (and
+ * unguarded, as that one is — this library has no dev-only convention). It is
+ * a diagnostic ONLY, never the sole signal, since a console message is easy to
+ * miss and impossible to act on from inside a pure function. The `data` itself
+ * is what must never be lost; the warning just makes the gap visible before a
+ * consumer has built an "Unsorted" affordance for `unassigned`.
+ */
+import type { BoardAccessors, BoardColumnDef, BoardColumnModel } from "./types";
+/** The full derivation result. See the file header for why `unassigned` exists. */
+export interface BoardModel<T> {
+    /** One entry per declared column, in the SAME order as the `columns` input. */
+    columns: readonly BoardColumnModel<T>[];
+    /** Items whose `getColumnId` matched no entry in `columns`. Never dropped. */
+    unassigned: readonly T[];
+}
+export declare function buildBoardModel<T>(items: readonly T[], columns: readonly BoardColumnDef[], accessors: BoardAccessors<T>): BoardModel<T>;

package/dist/types/lib/board/move.d.ts

@@ -0,0 +1,181 @@
+/**
+ * ==== MOVE ====
+ *
+ * The one validated pipeline every `BoardMoveRequest` passes through, no
+ * matter which of the four `BoardMoveSource` values produced it. `types.ts`
+ * names this the load-bearing rule: pointer drag, keyboard, the mandatory
+ * "Move to…" menu (WCAG 2.5.7) and bulk selection all construct a request
+ * and call the SAME function here. A per-source branch that skips a step is
+ * exactly how the accessible paths rot — the drag path gets exercised daily
+ * and the menu path silently stops agreeing with it, taking the 2.5.7
+ * alternative down with it and nobody notices until an audit.
+ *
+ * TWO RESPONSIBILITIES, DELIBERATELY SEPARATE FUNCTIONS:
+ *
+ *   `resolveMove` decides WHETHER a request may commit. It is the only thing
+ *   `use-board.ts`'s `requestMove` calls, and it never touches `T[]` — it
+ *   returns a verdict plus the subset of moves worth writing.
+ *
+ *   `applyBoardMoves` decides WHAT the resulting `items` array looks like,
+ *   given moves already known to be valid (typically `resolveMove(...).commit`).
+ *   It does no validation of its own — that would duplicate `resolveMove` — and
+ *   it is exported separately because `onMove` on `UseBoardOptions` returns
+ *   `void`: this module hands the consumer a verdict, not a next state, so a
+ *   consumer's own `onMove` needs a correct way to turn "these moves are real"
+ *   into "here is my next `items` array." Without it, every consumer either
+ *   re-derives the exact index arithmetic `applyMove` exists to remove, or
+ *   worse, folds it over a bulk request and gets the trap below.
+ *
+ * WHY `resolveMove` DOES ITS OWN STRUCTURAL CHECKS BEFORE EVER CALLING THE
+ * CALLER'S `validateMove`. `validateMove` is optional and, per `types.ts`,
+ * "Absent means every move is allowed" — so nothing upstream is guaranteed to
+ * have checked that `itemId` names a real item or that a `columnId` names a
+ * declared column. A malformed request must never reach a consumer's domain
+ * rule carrying numbers that don't correspond to reality, and a consumer's
+ * `validateMove` should never have to re-derive checks this module can prove
+ * from its own inputs for free. So structural validity runs FIRST, always on,
+ * not configurable — before `validateMove`, before no-op filtering.
+ *
+ * WHY NO-OP FILTERING IS PER-MOVE BUT VALIDITY IS ALL-OR-NOTHING. These are
+ * different questions. Atomicity ("did the batch survive as one unit")
+ * governs whether the request is safe to commit AT ALL — RES-GAME names this
+ * exactly: "moving five selected cards should not accept the first two and
+ * reject the remaining three." One bad move rejects the whole batch, full
+ * stop. But once a batch is known-good, a card that happens to already be
+ * exactly where it is going is not an error — it is nothing to write.
+ * Dropping that ONE entry from the committed set changes nothing about the
+ * other four having moved correctly, and `onMove`'s own doc on
+ * `UseBoardOptions` names the cost of not doing this: "the previous board
+ * wrote its ordering field on every release that landed where it started."
+ *
+ * NO-OP IS A PER-MOVE, SYNTACTIC CHECK — REUSING `isNoOp` FROM `lib/dnd`,
+ * NOT A FULL SIMULATION OF FINAL POSITION. `isNoOp(from, to)` says "same
+ * column, same index" for exactly one move, taken at face value. For a bulk
+ * request whose moves interact (two items landing in the same column), a
+ * move's own `{column, index}` pair can be untouched while its ABSOLUTE final
+ * position shifts because a sibling move inserted ahead of it. This module
+ * does not attempt to detect that: `to.index` is the caller's stated INTENT,
+ * so a move that literally says "column A index 2 to column A index 2" is
+ * declaring no intended change regardless of what its bulk-mates do, and
+ * that is the same per-item promise the drag engine's own `DragEndEvent.moved`
+ * makes — it never reasoned about siblings either, because a single drag
+ * gesture never has any.
+ *
+ * THE BULK INDEX CONVENTION, AND WHY IT HAS TO BE STATED EXPLICITLY. The
+ * engine's single-item convention — `to.index` counts the destination list
+ * WITH THE DRAGGED ITEM ALREADY REMOVED — has no obvious generalisation to N
+ * items removed from possibly-different columns at once, and `types.ts`
+ * does not pick one; that is this module's decision to make and document.
+ * THE RULE: every positional move's `to.index`, bulk or not, counts its destination
+ * column's items with EVERY item named ANYWHERE in the same request already
+ * removed — not just itself. For a single-move request that is identical to
+ * the engine's own rule (nothing else is being removed). For a bulk request
+ * it means a UI constructing the request reasons about one shared reference
+ * frame per target column ("insert these three selected cards starting at
+ * position two among the cards that are staying put"), not about where its
+ * OTHER selected cards will land — which is the only version of "bulk move
+ * to a position" an operator selecting five cards can sensibly form an
+ * intention about in the first place.
+ *
+ * THE TRAP THIS CONVENTION EXISTS TO AVOID: SEQUENTIAL applyMove FOLDING
+ * SILENTLY CORRUPTS A BULK REORDER. Applying move 1 then move 2 via
+ * `applyMove` one at a time is NOT equivalent to applying them together,
+ * because move 1's splice shifts every index move 2 was computed against —
+ * and worse, if move 2's stored index is blindly reused against the
+ * ALREADY-SHIFTED array (rather than re-resolved), it can silently pick up
+ * the wrong item's position entirely. `applyBoardMoves` never folds moves
+ * sequentially over a mutating array for this reason. Instead it resolves
+ * every move against ONE shared snapshot — the residual list per column with
+ * every moved item already removed — and inserts all of a column's incoming
+ * items in a single deterministic pass: sorted by `to.index` ascending
+ * (ties broken by the item's original position in `moves`, i.e. request
+ * order), each inserted at `to.index + (insertions already made into this
+ * column)`. That running offset is exactly what accounts for earlier
+ * insertions shifting the positions later ones land at, computed once
+ * instead of re-derived per move. A LANE MOVE (`to.lane`, DX-4583) has no
+ * index, so it takes no part in this pass: it neither leaves the residual nor
+ * is inserted, and the card stays where the consumer's order already holds it
+ * once the consumer has written its lane. board-core.test.ts pins a concrete bulk
+ * case where the naive sequential-splice answer and this one visibly differ,
+ * so the property is proven rather than incidentally true.
+ *
+ * WHY `applyBoardMoves` CALLS THE SHARED `applyMove` FOR THE ONE CASE WHERE
+ * IT APPLIES, AND HAND-SPLICES EVERYWHERE ELSE. `applyMove(list, from, to)`
+ * splices ONE array — it has no way to express "remove from list A, insert
+ * into list B," because a cross-column move is inherently a two-list
+ * operation. The design system's own `DragDropPage` demo shows this exact
+ * split already: `applyMove` for the same-container branch, a manual
+ * remove-then-insert for the cross-container one. This module follows the
+ * identical rule for the single-move, same-column case (delegates to
+ * `applyMove` outright — see the equivalence test, which proves the general
+ * residual-based path used for every other case produces byte-identical
+ * output to `applyMove` when it degenerates to N=1, same column). Every
+ * other shape — cross-column, or any bulk request — has no single shared
+ * array to splice, so it goes through the residual-and-insert pass above.
+ */
+import type { BoardAccessors, BoardColumnDef, BoardMove, BoardMoveRequest, BoardMoveOutcome, BoardMoveVerdict } from "./types";
+/** Everything `resolveMove` reads to prove a request is structurally real. */
+export interface ResolveMoveContext<T> {
+    items: readonly T[];
+    columns: readonly BoardColumnDef[];
+    accessors: BoardAccessors<T>;
+    /** Consulted after structural validity holds. See the file header for order. */
+    validateMove?: (request: BoardMoveRequest) => BoardMoveVerdict;
+}
+export interface ResolvedMove {
+    verdict: BoardMoveOutcome;
+    /**
+     * The subset of the request's moves worth committing, in original order.
+     * Empty whenever there is nothing to write — either every move was a
+     * no-op, or `verdict.ok` is false. Only ever meaningful when `verdict.ok`.
+     */
+    commit: readonly BoardMove[];
+}
+export declare function resolveMove<T>(context: ResolveMoveContext<T>, request: BoardMoveRequest): ResolvedMove;
+/**
+ * Turn a set of already-valid moves into the consumer's next `items` array.
+ * Call this with moves already proven valid — typically `resolveMove(...).commit`
+ * — never with raw, unvalidated input: this function does no checking of its
+ * own, on purpose, so it stays a pure array transform with no notion of
+ * "reject." Handles N=1 and N>1 (same-column or cross-column, mixed) with the
+ * one algorithm described in the file header.
+ *
+ * Reorders which COLUMN each item's block appears in within the returned
+ * flat array (columns are emitted in first-seen order, any brand-new target
+ * column appended after); WITHIN a column, order is always exactly what the
+ * moves + original relative order produce. Between-column interleaving in
+ * the input `items` array is not preserved because nothing in this module's
+ * contract depends on it — `BoardAccessors.getColumnId` is what determines
+ * column membership on every subsequent `buildBoardModel` call, and
+ * `buildBoardModel` only ever reads WITHIN-column order.
+ *
+ * A LANE MOVE (`to.lane`, DX-4583) CHANGES MEMBERSHIP AND NOTHING ELSE. The
+ * card stays at its place in `items`, so it lands among the destination's cards
+ * where the consumer's own order puts it (its priority, its sort key). The
+ * consumer's lane write must already be made, because this function cannot make
+ * it: a lane move whose item still reports another lane throws, since the card
+ * would otherwise stay in its old lane without a sound.
+ *
+ * `to.edge` IS NOT APPLIED HERE. This arranges the cards it was given, and in a
+ * windowed column an edge move lands OUTSIDE the cards that are loaded — at the
+ * top or bottom of a list this function cannot see — so the index it would
+ * splice at is only the nearest loaded position, not the place the card is
+ * going. A consumer of a windowed column sends the move to its server (see
+ * `moveAnchor`) and re-reads the affected pages (`invalidateAll`); it does not
+ * apply an edge move locally. In a column with every card loaded the edge IS
+ * the index, and this function is exactly right.
+ *
+ * NEVER WRITES A FIELD ON ANY ITEM — ONLY REPOSITIONS. `BoardAccessors` has
+ * no setter, on purpose (the file header on `types.ts` — items are opaque),
+ * so this function CANNOT change what `getColumnId` reports for a moved
+ * item; every returned item is the exact same reference it was given, just
+ * possibly in a different slot. For a CROSS-column move this means the
+ * repositioning alone does nothing observable until the caller ALSO updates
+ * the moved item's own underlying field (a `status`, a `columnId`, whatever
+ * the consumer's domain calls it) — that write is the consumer's, entirely
+ * outside this module, because only the consumer's own accessor knows how to
+ * produce it. The usual order is: update the field(s) first, THEN call this
+ * to fix array position — see board-core.test.ts's "what it does and does
+ * not mutate" tests, which pin both halves of this split.
+ */
+export declare function applyBoardMoves<T>(items: readonly T[], accessors: BoardAccessors<T>, moves: readonly BoardMove[]): T[];