@k2b/ui 0.32.0 → 0.34.0

package/dist/types/actions/ContextMenu.d.ts

@@ -11,6 +11,11 @@ export type ContextMenuProps = {
     onOpen?: () => void;
     id?: string;
     label?: string;
+    /**
+     * Links, form fields, editable text, and selected text inside the host keep the browser's own menu, with its Copy,
+     * Paste, and Open link. Use it where the host wraps readable content rather than one row.
+     */
+    keepNativeMenu?: boolean;
 };
 /** Right-click menu with keyboard invocation, one-open-at-a-time behavior, and viewport clamping. */
 export declare function ContextMenu(props: ContextMenuProps): JSX.Element;

package/dist/types/actions/Dropdown.d.ts

@@ -44,6 +44,13 @@ export type DropdownAction = (DropdownActionBase & {
     href?: never;
     external?: never;
 });
+/** A second, smaller action at the end of a row, such as "Only" beside a checkbox; it keeps the menu open. */
+export type DropdownSecondaryAction = {
+    label: string;
+    /** Accessible name when the visible label alone does not say what it acts on, such as "Only Team Logistik". */
+    ariaLabel?: string;
+    action: () => void;
+};
 /** Declarative radio or checkbox row for compact action menus. */
 export type DropdownChoice = DropdownActionBase & {
     action: () => void;
@@ -52,6 +59,11 @@ export type DropdownChoice = DropdownActionBase & {
     href?: string;
     closeOnSelect?: boolean;
     color?: string;
+    /**
+     * A second action at the end of the row. It shows while the row is hovered or focused, always on a touch screen,
+     * and keeps its place when hidden, so the row never changes width. Right and Left move between the two.
+     */
+    secondary?: DropdownSecondaryAction;
 };
 export type DropdownSection = {
     sectionLabel?: string;
@@ -60,6 +72,8 @@ export type DropdownSection = {
      * `sectionLabel`: the label names the choice above the row and for screen readers.
      */
     layout?: "row";
+    /** A quiet action at the end of the section label, such as "All"; it needs a `sectionLabel` and keeps the menu open. */
+    labelAction?: DropdownSecondaryAction;
     items: readonly (DropdownAction | DropdownChoice)[];
 };
 export type DropdownItem = DropdownAction | DropdownChoice | DropdownSection;
@@ -88,6 +102,11 @@ export type DropdownProps = {
      * Defaults to `menu`. A controlled menu (`open`) always stays a menu.
      */
     phone?: "menu" | "sheet";
+    /**
+     * Renders the entries only once the menu first opens, for a menu repeated on every row of a long list: the page
+     * then carries each row's trigger, not each row's entries. Fixed for the menu's lifetime.
+     */
+    lazy?: boolean;
 };
 export type DropdownTriggerProps = Omit<ButtonProps, "aria-controls" | "aria-expanded" | "aria-haspopup" | "children" | "disabled" | "onClick" | "onKeyDown"> & {
     children: JSX.Element;

package/dist/types/actions/FilterChip.d.ts

@@ -5,6 +5,8 @@ export type FilterChipOption = {
     label: string;
     icon?: string;
     color?: string;
+    /** Quiet trailing information about the option, such as a short note or a loading or warning icon with its own label. */
+    trailing?: JSX.Element;
 };
 export type FilterChipSection = {
     label?: string;
@@ -15,6 +17,8 @@ export type FilterChipSection = {
      * chosen option again keeps it; give the row a value in `defaultValue` so Reset keeps a choice too.
      */
     layout?: "row";
+    /** A labelled `multiple` section offers "All" or, once all its options are chosen, "None" beside its label. */
+    toggleAll?: boolean;
 };
 export type FilterChipProps = {
     label: string;
@@ -33,6 +37,13 @@ export type FilterChipProps = {
      * chips of `AppWorkspace.Head`; pass only the filter's name as `label`. The chip then grows with its value.
      */
     showValue?: boolean;
+    /**
+     * Each option of a `multiple` section offers "Only" at the end of its row: it chooses that option alone among the
+     * `multiple` sections and keeps the choices of single-select sections.
+     */
+    only?: boolean;
+    /** The trigger shows the colors of the first four chosen options before its label, as a quiet hint of what is in view. */
+    swatches?: boolean;
     disabled?: boolean;
     class?: string;
 };

package/dist/types/actions/SelectionToolbar.d.ts

@@ -0,0 +1,38 @@
+import { type JSX } from "solid-js";
+export type SelectionToolbarProps = {
+    /**
+     * The selection's box in viewport coordinates, or nothing while the toolbar is closed. It is read again on every
+     * scroll and resize while the toolbar is open, so a function that measures the selection keeps it attached.
+     */
+    anchor: () => DOMRect | null | undefined;
+    label: string;
+    /**
+     * `above` (default) places the toolbar over the selection and below it when the space above is too small. `below`
+     * always places it below, for touch, where the system's own selection menu sits above.
+     */
+    placement?: "above" | "below";
+    /** The area the toolbar stays in, such as the editor's scroll area under its toolbar: it goes below the selection when the space above inside this area is too small. */
+    boundary?: () => HTMLElement | null | undefined;
+    /** Escape inside the toolbar; the application closes it and returns focus to the text. */
+    onEscape?: () => void;
+    children: JSX.Element;
+    class?: string;
+};
+/** Where the toolbar goes for a selection box: centered on its first line, inside the viewport. */
+export declare const selectionToolbarPosition: (anchor: Pick<DOMRect, "top" | "bottom" | "left" | "width">, toolbar: {
+    width: number;
+    height: number;
+}, viewport: {
+    width: number;
+    height: number;
+    top?: number;
+}, placement?: "above" | "below") => {
+    left: number;
+    top: number;
+    side: "above" | "below";
+};
+/**
+ * A toolbar that floats at a text selection, such as formatting and comment actions over selected text. It lies in
+ * the top layer, so no scroll container clips it, and pressing its buttons keeps the selection.
+ */
+export declare function SelectionToolbar(props: SelectionToolbarProps): JSX.Element;

package/dist/types/actions/filter-messages.d.ts

@@ -2,6 +2,18 @@ declare const filterMessages: import("@k2b/stdlib").Catalog<{
     filterActions: string;
     filters: string;
     reset: string;
+    all: string;
+    none: string;
+    allOf: ({ label }: {
+        label: string;
+    }) => string;
+    noneOf: ({ label }: {
+        label: string;
+    }) => string;
+    only: string;
+    onlyOption: ({ label }: {
+        label: string;
+    }) => string;
 }>;
 export type FilterMessages = ReturnType<(typeof filterMessages)["resolve"]>["t"];
 /** Resolved from the inherited render locale. */

package/dist/types/actions/index.d.ts

@@ -18,6 +18,8 @@ export type { RemoveButtonProps } from "./RemoveButton";
 export { RemoveButton } from "./RemoveButton";
 export type { SegmentedControlProps, SegmentOption } from "./SegmentedControl";
 export { SegmentedControl } from "./SegmentedControl";
+export type { SelectionToolbarProps } from "./SelectionToolbar";
+export { SelectionToolbar } from "./SelectionToolbar";
 export type { SplitButtonProps } from "./SplitButton";
 export { SplitButton } from "./SplitButton";
 export type { SpotlightButtonProps, SpotlightButtonVariant, SpotlightSearchOptions, SpotlightSearchResolver, } from "./SpotlightSearch";

package/dist/types/actions/menu-rows.d.ts

@@ -1,5 +1,10 @@
 /**
- * Left and Right cycle through the segments of a row section; Up and Down leave it like any item. Returns whether
- * the key moved focus.
+ * Left and Right cycle through the segments of a row section, or between a row and its secondary action; Up and Down
+ * leave it like any item. Returns whether the key moved focus.
  */
 export declare const focusRowSegment: (items: HTMLElement[], key: string) => boolean;
+/**
+ * Moves Up, Down, Home, or End through the rows; a row's secondary action is no stop of its own there, so Down from
+ * it goes to the next row. Returns whether the key moved focus.
+ */
+export declare const focusMenuRow: (items: HTMLElement[], key: string) => boolean;

package/dist/types/charts.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Pure chart renderers that share the `Chart` component's drawing without its Solid wrapper, for hosts that draw
+ * SVG themselves, such as server previews and app frames.
+ */
+export { type BarChartLayout, type BarChartOptions, barChartLayout, renderBarChartSvg } from "./content/chart-bar";

package/dist/types/chat/ChatComposer.d.ts

@@ -129,10 +129,29 @@ export type ChatFileSelection = {
     disabled?: boolean;
     label?: string;
 };
+/** A person `@` can mention: a member of the conversation, a person or an agent. */
+export type ChatPersonSuggestion = {
+    id: string;
+    name: string;
+    agent?: boolean;
+};
+/** Suggests people for `@`; the composer inserts the chosen one as a mention named "@Name". */
+export type ChatComposerPeople = {
+    /** At most 8 matches are shown; a rejection only means no suggestions. */
+    search: (query: string, signal: AbortSignal) => Promise<readonly ChatPersonSuggestion[]>;
+};
 export type ChatPasteHandler = (event: ClipboardEvent & {
     currentTarget: HTMLTextAreaElement;
     target: Element;
 }) => void;
+export type ChatComposerReply = {
+    /** Name of the answered message's author. */
+    author: string;
+    /** Plain text of the answered message; it shows at most two lines. */
+    text: string;
+    onCancel: () => void;
+    onSelect?: () => void;
+};
 export type ChatComposerProps = {
     value: string;
     onValueChange: (value: string) => void;
@@ -176,6 +195,8 @@ export type ChatComposerProps = {
     }) => ChatCommand | undefined;
     mentions?: readonly ChatMention[];
     onMentionsChange?: (mentions: readonly ChatMention[]) => void;
+    /** Suggests people after `@`; needs `mentions` and `onMentionsChange`. */
+    people?: ChatComposerPeople;
     /** Shared surface above the editor; suggestions temporarily replace this content. */
     accessory?: JSX.Element;
     contextUsage?: ChatContextUsageData;
@@ -192,6 +213,8 @@ export type ChatComposerProps = {
     label?: string;
     inputLabel?: string;
     disabled?: boolean;
+    /** Keeps the draft editable but holds it back, such as while the chosen model cannot answer. */
+    submitDisabled?: boolean;
     error?: string;
     focusToken?: unknown;
     draftKey?: unknown;
@@ -216,5 +239,10 @@ export type ChatComposerProps = {
     microphone?: ChatComposerMicrophone;
     /** One line above the field. The conversation variant always keeps its height; the default shows it only with content. */
     hint?: JSX.Element;
+    /**
+     * The message this draft answers, shown above the field on the same quiet tint as a quote in a message, with a
+     * button that cancels the reply. `onSelect` makes the quote a button, for example to jump to the original.
+     */
+    reply?: ChatComposerReply;
 };
 export declare function ChatComposer(props: ChatComposerProps): JSX.Element;

package/dist/types/chat/chat-messages.d.ts

@@ -28,6 +28,7 @@ export declare const chatMessages: import("@k2b/stdlib").Catalog<{
     messageSent: string;
     messageNotSent: string;
     messageRetry: string;
+    messageDiscard: string;
     messageShowMore: string;
     messageShowLess: string;
     messageReplyTo: string;
@@ -75,6 +76,12 @@ export declare const chatMessages: import("@k2b/stdlib").Catalog<{
     couldNotLoadEarlierMessages: string;
     couldNotPostMessage: string;
     messageActions: string;
+    cancelReply: string;
+    replyingTo: string;
+    messageMenu: ({ author, time }: {
+        author: string;
+        time: string;
+    }) => string;
     messageComposer: string;
     messageInput: string;
     model: string;
@@ -111,6 +118,8 @@ export declare const chatMessages: import("@k2b/stdlib").Catalog<{
     composerFormatting: string;
     insertEmoji: string;
     emojiSuggestions: string;
+    peopleSuggestions: string;
+    agentLabel: string;
     dictate: string;
     dictateOrHold: string;
     stopDictation: string;

package/dist/types/chat/composer-document.d.ts

@@ -6,6 +6,11 @@ export type ChatCommandQuery = {
 };
 /** Only the token at the caret; URLs, paths and inline/fenced code are ordinary text. */
 export declare function chatCommandQuery(text: string, caret: number, selectionEnd?: number): ChatCommandQuery | null;
+/**
+ * The `@name` being typed at the caret, for person suggestions: after the start, a space or an opening parenthesis,
+ * outside code and outside an existing mention. The query stops at whitespace, so "@Mar" suggests "Mara Schulz".
+ */
+export declare function chatPeopleQuery(text: string, caret: number, selectionEnd?: number, mentions?: readonly ChatMention[]): ChatCommandQuery | null;
 /** An edit inside a mention removes its identity; edits around it shift the range. */
 export declare function reconcileChatMentions(before: string, after: string, mentions: readonly ChatMention[]): ChatMention[];
 export declare function chatMentionSegments(text: string, mentions: readonly ChatMention[]): {

package/dist/types/chat/index.d.ts

@@ -7,7 +7,7 @@ import { ChatDecision, ChatMark, ChatOutcome } from "./ChatDecision";
 import { ChatActivity, ChatActivityToggle, ChatContextUsage, ChatMessage } from "./ChatPrimitives";
 import { ChatRoot } from "./ChatRoot";
 import { ChatTimeline } from "./ChatTimeline";
-export type { ChatCommand, ChatCommandContext, ChatCommandDraft, ChatCommandOpenResult, ChatCommandResult, ChatCommandScope, ChatCommandSearch, ChatCommandSection, ChatComposerProps, ChatFileSelection, ChatPasteHandler, } from "./ChatComposer";
+export type { ChatCommand, ChatCommandContext, ChatCommandDraft, ChatCommandOpenResult, ChatCommandResult, ChatCommandScope, ChatCommandSearch, ChatCommandSection, ChatComposerPeople, ChatComposerProps, ChatComposerReply, ChatFileSelection, ChatPasteHandler, ChatPersonSuggestion, } from "./ChatComposer";
 export type { ChatDecisionProps, ChatMarkProps, ChatOutcomeProps, ChatPreviewExcerptProps, ChatPreviewHeaderProps, ChatPreviewLineProps, ChatPreviewPeopleProps, ChatPreviewProps, ChatPreviewReadMoreProps, ChatPreviewShowAllProps, ChatPreviewTitleProps, } from "./ChatDecision";
 export type { ChatActivityProps, ChatActivityToggleProps, ChatContextUsageProps, ChatMessageProps } from "./ChatPrimitives";
 export { formatChatTokens } from "./ChatPrimitives";

package/dist/types/content/Calendar.d.ts

@@ -129,12 +129,19 @@ export type CalendarController = {
 export type CalendarCustomView<V extends string = string> = {
     value: V;
     label: string;
+    /** Days the previous and next buttons and keys move, such as 14 for a two-week list. Defaults to one day. */
+    days?: number;
 };
 export type CalendarProps<V extends string = never> = {
     date: Date | string;
     events: CalendarEvent[];
     view?: CalendarView | V;
     views?: CalendarView[];
+    /**
+     * `false` leaves the view switcher out of the toolbar, for a host that shows the views elsewhere, such as tabs in
+     * its page head. The view commands stay.
+     */
+    viewSwitcher?: boolean;
     /** Views after the built-in ones. While one is active, `children` is the body and the header pages by day. */
     customViews?: CalendarCustomView<V>[];
     /** The body of the active custom view. */

package/dist/types/content/Chart.d.ts

@@ -1,6 +1,7 @@
 import type { MapViewport } from "@k2b/stdlib";
 import { charts } from "@k2b/stdlib";
 import type { JSX } from "solid-js";
+import { type BarChartOptions } from "./chart-bar";
 import type { ChartCursor } from "./chart-cursor";
 import { type ChartDatumRef, type ChartKind, type ChartSelection, type ChartTooltipFormatter } from "./chart-inspection-core";
 import { type StateTimelineChartOptions, type StateTimelineDomain } from "./chart-state-timeline";
@@ -95,7 +96,7 @@ export type ChartProps = {
         /** Largest connected X distance; positive, finite, without area/errorBand fills. */ maxGap?: number;
         /** Wrap the legend above the plot inside the caller's total chart height. Requires legend=true. */
         legendPlacement?: "top-start";
-    } : {}) & (K extends "stateTimeline" ? StateTimelineChartOptions : Omit<Parameters<(typeof charts)[K]>[0], "width" | "height" | "inspect">);
+    } : {}) & (K extends "stateTimeline" ? StateTimelineChartOptions : K extends "bar" ? BarChartOptions : Omit<Parameters<(typeof charts)[K]>[0], "width" | "height" | "inspect">);
 }[ChartKind];
 /** Pure renderer options: component layout, events and inspection are configured elsewhere. */
 export type ChartRenderOptions = {

package/dist/types/content/FileGrid.d.ts

@@ -1,9 +1,16 @@
 import { type JSX } from "solid-js";
 import type { CollectionSelection } from "./collection-selection";
-export type FileGridProps<T> = {
+/** One part of an open file list, such as its files as rows and its images as tiles. */
+export type FileGridGroup<T> = {
+    id: string;
+    label: JSX.Element;
+    rows: readonly T[];
+    /** `tiles` fills each item with its preview and lays the name over it. Defaults to `list`. */
+    layout?: "list" | "tiles";
+};
+type FileGridBaseProps<T> = {
     rows: readonly T[];
     getRowId: (row: T) => string;
-    selection: CollectionSelection;
     label: string;
     size?: "sm" | "md" | "lg";
     /** `list` shows one compact row per item: preview, name, and meta beside each other. Defaults to `grid`. */
@@ -12,15 +19,48 @@ export type FileGridProps<T> = {
     renderLabel: (row: T) => JSX.Element;
     renderMeta?: (row: T) => JSX.Element;
     renderActions?: (row: T) => JSX.Element;
-    onRowClick?: (row: T) => void;
+    /**
+     * `progressive` shows the actions on hover, keyboard focus, or an open menu with a mouse or trackpad, and always
+     * on touch. Their slot is reserved in both states, so nothing moves. Defaults to `always`.
+     */
+    actionVisibility?: "always" | "progressive";
     onOpen: (row: T) => void;
     onContextMenu?: (row: T) => void;
     /** Extra attributes for one tile, for example drag-and-drop handlers or data attributes the host styles. */
     itemProps?: (row: T) => JSX.HTMLAttributes<HTMLDivElement>;
     class?: string;
 };
+/** A browser or picker: items are selected, and Enter or a double click opens them. */
+export type FileGridSelectableProps<T> = FileGridBaseProps<T> & {
+    selection: CollectionSelection;
+    onRowClick?: (row: T) => void;
+    limit?: never;
+    expanded?: never;
+    onExpandedChange?: never;
+    moreMeta?: never;
+    toolbar?: never;
+    groups?: never;
+};
+/** A list without selection, as in a details panel: one click on an item opens it. */
+export type FileGridOpenProps<T> = FileGridBaseProps<T> & {
+    selection?: never;
+    onRowClick?: never;
+    /** Shows the first `limit` items, then "Show all N", which opens the full list in place. Without it, the list is always full. */
+    limit?: number;
+    /** Controls whether the full list is open. Without it, the list keeps its own state. */
+    expanded?: boolean;
+    onExpandedChange?: (expanded: boolean) => void;
+    /** A quiet note at the end of "Show all N", such as how many duplicates were merged. */
+    moreMeta?: JSX.Element;
+    /** Shown above the full list, such as a count, an arrangement switch, or "Download all"; not in the short list. */
+    toolbar?: JSX.Element;
+    /** How the full list arranges its items, such as files as rows, then images as tiles; the short list stays one list. */
+    groups?: (rows: readonly T[]) => readonly FileGridGroup<T>[];
+};
+export type FileGridProps<T> = FileGridSelectableProps<T> | FileGridOpenProps<T>;
 /**
  * File presentation only; the host owns data, menus, leases and permissions. Items the selection marks with
  * `isDisabled` stay reachable by keyboard but cannot be selected or opened; say why in `renderMeta`.
  */
 export declare function FileGrid<T>(props: FileGridProps<T>): JSX.Element;
+export {};

package/dist/types/content/FileTypeIcon.d.ts

@@ -20,6 +20,16 @@ export declare const fileTypeOf: (file: {
     mediaType?: string;
     folder?: boolean;
 }) => FileType;
+/**
+ * The readable kind of a file in `locale`, such as "PDF", "Image", or "Spreadsheet", for a meta line like
+ * "PDF · 4.2 MB" instead of a media type. An unknown kind names the file's extension ("ICC"), and a file without
+ * one reads "File".
+ */
+export declare const fileKindLabel: (file: {
+    name: string;
+    mediaType?: string;
+    folder?: boolean;
+}, locale: string) => string;
 /**
  * A file or folder glyph in a soft chip of its type colour. Folders take the app accent hook
  * `--k2b-app-workspace-active`; code, text, and unknown files a neutral ink. The box size is fixed per `size`.

package/dist/types/content/FileView.d.ts

@@ -76,5 +76,9 @@ export type FileViewRenderer = {
     /** Text renderers that support the edit affordance when `save` is present. */
     editable?: boolean;
 };
-export declare const formatFileViewSize: (bytes: number) => string;
+/**
+ * A file size such as "4.2 MB". With `locale`, the number follows that language ("4,2 MB") and drops a trailing
+ * zero ("64 KB"); without it, the output stays as before.
+ */
+export declare const formatFileViewSize: (bytes: number, locale?: string) => string;
 export default function FileView(props: FileViewProps): JSX.Element;

package/dist/types/content/MessageRow.d.ts

@@ -1,4 +1,5 @@
 import { type JSX } from "solid-js";
+import { type GestureKind } from "../actions/GestureMenu";
 import { type ReactionBarItem } from "./ReactionBar";
 export type MessageRowAuthor = {
     /** Display name, shown at the start of a group and read before every message. */
@@ -11,12 +12,26 @@ export type MessageRowAuthor = {
 export type MessageRowStatus = "pending" | "sent" | "failed";
 export type MessageRowAction = {
     id: string;
-    /** Accessible name and tooltip. */
+    /** Visible name of the menu entry. */
     label: string;
     /** Icon class, for example `ti ti-arrow-back-up`. */
     icon: string;
+    /** One quiet sentence below the label that says what the entry does. */
+    description?: string;
     onSelect: () => void;
     disabled?: boolean;
+    variant?: "danger";
+    /** A touch gesture that runs the entry too. Give each gesture to at most one entry. */
+    gesture?: GestureKind;
+    /**
+     * Alt+click (Option+click on Apple devices) on the message runs the entry directly, and the entry shows that
+     * shortcut. Give it to at most one entry.
+     */
+    altClick?: boolean;
+    /** A key the application handles for the focused message, such as "r"; the entry shows it at its end. */
+    shortcut?: string;
+    /** In the phone sheet, runs while the tap still counts as the person's gesture, as clipboard writes require. */
+    immediate?: boolean;
 };
 export type MessageRowQuote = {
     /** Name of the quoted message's author. */
@@ -67,6 +82,16 @@ export type MessageRowFile = MessageRowAttachmentTarget & {
     icon?: string;
 };
 export type MessageRowAttachment = MessageRowMedia | MessageRowFile;
+/** Where a message belongs, shown as a small chip under it, for example its thread in a timeline of several. */
+export type MessageRowOrigin = {
+    label: string;
+    /** Icon class, for example `ti ti-hash`. */
+    icon?: string;
+    /** Opens where the message belongs. Without it, the chip is not a control. */
+    onSelect?: () => void;
+    /** Accessible name of the control when it must say more than the label, such as "Open thread Updates". */
+    selectLabel?: string;
+};
 export type MessageRowProgress = {
     /** What is happening, for example "Writing" or "Searching the files". */
     status: string;
@@ -96,7 +121,12 @@ export type MessageRowProps = {
     receipt?: string;
     /** Called by "Retry" while `status` is `"failed"`. */
     onRetry?: () => void;
-    /** Shown as a toolbar over the message while it is hovered or focused. It never moves the layout. */
+    /** Called by "Discard" next to "Retry" while `status` is `"failed"`, so both answers to a failure sit where it shows. */
+    onDiscard?: () => void;
+    /**
+     * The message's menu. A quiet "…" beside the bubble opens it while the message is hovered or focused, also from the
+     * keyboard; right-click and a long press open the same menu. Showing "…" never moves the layout.
+     */
     actions?: readonly MessageRowAction[];
     /** The message this one answers, shown above it. */
     quote?: MessageRowQuote;
@@ -124,6 +154,8 @@ export type MessageRowProps = {
     onAddReaction?: (anchor: HTMLElement) => void;
     /** A bar of fixed height that opens the replies to this message. */
     thread?: MessageRowThread;
+    /** A chip of fixed height under the message that names where it belongs. */
+    origin?: MessageRowOrigin;
     /** The message is still being written, by a person or an automated author alike: a status line with "Stop". */
     progress?: MessageRowProgress;
     class?: string;
@@ -138,6 +170,31 @@ export type MessageSystemRowProps = {
     icon?: string;
     class?: string;
 };
+export type MessageEventRowProps = {
+    /** What changed, for example "Mara set the status to “In review”". */
+    children: JSX.Element;
+    /** Icon class of the kind of change; a dot by default. */
+    icon?: string;
+    /** Where the change belongs, such as its thread, where several threads mix. */
+    origin?: MessageRowOrigin;
+    /** Opens what the change is about, such as the commented passage; the sentence becomes the link. */
+    href?: string;
+    /** Visible time, formatted by the caller. */
+    time?: string;
+    dateTime?: string | Date;
+    class?: string;
+};
+export type MessageEventGroupProps = {
+    /** What the closed group stands for, for example "4 changes to Invitation and Light test". */
+    label: string;
+    expanded: boolean;
+    onToggle: () => void;
+    /** Visible time or range, formatted by the caller, for example "09:50–09:58". */
+    time?: string;
+    /** The first event's time. */
+    dateTime?: string | Date;
+    class?: string;
+};
 export type MessageGroupEntry = {
     /** Stable identity of the author. */
     author: string;
@@ -156,6 +213,13 @@ export declare const startsMessageGroup: (entry: MessageGroupEntry, previous?: M
  * as `VirtualFeed` keeps its positions.
  */
 export declare function MessageRow(props: MessageRowProps): JSX.Element;
+/**
+ * A quiet line for a change to something the conversation is about, such as a task's new status: no bubble, aligned
+ * with the messages' text, with its time at the end. It is no message: it never counts as unread.
+ */
+export declare function MessageEventRow(props: MessageEventRowProps): JSX.Element;
+/** Several event lines in a row as one line that opens them, such as "4 changes to Invitation and Light test". */
+export declare function MessageEventGroup(props: MessageEventGroupProps): JSX.Element;
 /** A quiet, centered line for something that happened in the conversation, such as a person joining. */
 export declare function MessageSystemRow(props: MessageSystemRowProps): JSX.Element;
 export {};

package/dist/types/content/calendar-day-scroll.d.ts

@@ -42,6 +42,7 @@ export declare const wheelDelta: (axis: WheelAxis, deltaX: number, deltaY: numbe
 /**
  * The day start nearest to `position` in a strip of equal columns, or with `room` the nearer day edge at either end of
  * the visible room; ties keep the start. A `heading` of 1 or -1 only looks ahead or back, for a scroll that brought
- * something into view and must not slide back over it.
+ * something into view and must not slide back over it. The result is a whole pixel: a drawer can leave a fractional
+ * room, and WebKit drops the fraction of a scroll position, which would leave the strip short of the edge (#1713).
  */
 export declare const snapToColumn: (position: number, width: number, room?: number, heading?: number) => number;

package/dist/types/content/chart-bar.d.ts

@@ -0,0 +1,60 @@
+import { type AxisOptions, type BarItem, type ReferenceLine } from "@k2b/stdlib";
+/**
+ * Bar chart options: stdlib's `charts.bar` options plus a title for the category axis and a separate value format.
+ * The wrapper owns size and inspection.
+ */
+export type BarChartOptions = {
+    data: BarItem[];
+    /** Value axis. `label` titles it, `format` writes its ticks and, without `valueFormat`, the printed values. */
+    yAxis?: AxisOptions;
+    /**
+     * Category axis. `label` titles it. `ordered` marks categories that follow each other, such as days or steps: they
+     * stay columns, and only every n-th label shows when they would not fit, as on a time axis. Unordered categories each
+     * keep their label and turn into rows instead.
+     */
+    xAxis?: {
+        label?: string;
+        ordered?: boolean;
+    };
+    /** Writes printed values and tooltip values. Defaults to `yAxis.format`. */
+    valueFormat?: (value: number) => string;
+    colorByBar?: boolean;
+    references?: ReferenceLine[];
+    /** Print every value at its bar. Default: whenever the values stay readable; rows always print them. */
+    showValues?: boolean;
+    /** A legend of the bar colors; used only with `colorByBar` in columns, where labels sit below the plot. */
+    legend?: boolean;
+    className?: string;
+    title?: string;
+    subtitle?: string;
+    /**
+     * The narrowest width in CSS pixels at which the drawing is shown; labels are laid out to fit it. Defaults to a
+     * 320px phone column. A host that draws at its measured width passes that width.
+     */
+    displayWidth?: number;
+    /** Logical insets of the column layout. Rows place their labels and values themselves. */
+    padding?: number | {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+};
+export type BarChartLayout = "columns" | "rows";
+/** Estimated width of `text` at `size` pixels in the UI sans font with tabular figures; a little wide on purpose. */
+export declare const chartTextWidth: (text: string, size?: number) => number;
+/** The layout a bar chart takes and its logical height, so server and browser reserve the same box. */
+export declare const barChartLayout: (opts: BarChartOptions, width?: number) => {
+    layout: BarChartLayout;
+    height: number;
+};
+/**
+ * Render a bar chart in which every category has its label. Few short labels stand below vertical columns; otherwise
+ * each category becomes a horizontal row with its label left of the bar and its value at the bar's end. Rows grow the
+ * drawing instead of dropping labels: use {@link barChartLayout} for its logical height.
+ */
+export declare const renderBarChartSvg: (opts: BarChartOptions & {
+    width: number;
+    height: number;
+    inspect?: boolean;
+}) => string;

package/dist/types/content/file-list-messages.d.ts

@@ -0,0 +1,24 @@
+/** File kinds and list folding shared by `FileGrid` and `fileKindLabel`. */
+declare const fileListMessages: import("@k2b/stdlib").Catalog<{
+    folder: string;
+    pdf: string;
+    image: string;
+    sheet: string;
+    document: string;
+    slides: string;
+    video: string;
+    audio: string;
+    archive: string;
+    file: string;
+    files: string;
+    images: string;
+    showAll: ({ count }: {
+        count: number;
+    }) => string;
+    showLess: string;
+}>;
+export type FileListMessages = ReturnType<(typeof fileListMessages)["resolve"]>["t"];
+export declare const resolveFileListMessages: (locale: string) => FileListMessages;
+export declare const useFileListMessages: () => (() => FileListMessages);
+export declare const checkFileListMessages: () => import("@k2b/stdlib").CatalogIssue[];
+export {};