@k2b/ui 0.29.0 → 0.30.0

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

@@ -14,6 +14,8 @@ export type DropdownActionBase = {
      */
     ariaLabel?: string;
     description?: string;
+    /** Quiet trailing information, such as a count. */
+    trailing?: JSX.Element;
     variant?: "danger";
 };
 export type DropdownAction = (DropdownActionBase & {
@@ -107,6 +109,8 @@ export type DropdownItemProps = {
     icon?: string;
     image?: string;
     description?: string;
+    /** Quiet trailing information, such as a count. */
+    trailing?: JSX.Element;
     disabled?: boolean;
     danger?: boolean;
     variant?: "danger";

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

@@ -28,9 +28,31 @@ export type FilterChipProps = {
     iconOnly?: boolean;
     /** Use a standard button appearance instead of the default filter field. */
     variant?: ButtonVariant;
+    /**
+     * An active chip names its first value instead of a count: "Tags: Customer", "Tags: Customer +2". Use it for the
+     * chips of `AppWorkspace.Head`; pass only the filter's name as `label`. The chip then grows with its value.
+     */
+    showValue?: boolean;
     disabled?: boolean;
     class?: string;
 };
 /** Section-aware controlled filter with immediate single- and multi-select commits. */
 export declare function FilterChip(props: FilterChipProps): JSX.Element;
 export default FilterChip;
+export type FilterToggleProps = {
+    label: JSX.Element;
+    icon: string;
+    /** Whether the filter is on. An active toggle carries the same tint as an active `FilterChip`. */
+    active: boolean;
+    /** Link to the URL with the filter switched. The link keeps working without JavaScript. */
+    href?: string;
+    onClick?: (event: MouseEvent) => void;
+    title?: string;
+    disabled?: boolean;
+    class?: string;
+};
+/**
+ * One on/off filter in the chip look: a link marked `aria-current="true"` while active, or a button with
+ * `aria-pressed`. Selection changes only colour and background, so neighbouring chips never move.
+ */
+export declare function FilterToggle(props: FilterToggleProps): JSX.Element;

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

@@ -0,0 +1,30 @@
+import { type JSX } from "solid-js";
+export type ViewTab = {
+    id: string;
+    label: string;
+    href: string;
+    icon?: string;
+    count?: number | string;
+};
+export type ViewTabsProps = {
+    /** Accessible name of the navigation landmark, e.g. "Views". */
+    label: string;
+    items: readonly ViewTab[];
+    /** Id of the open view; the server reads it from `?view=`. Unknown ids select nothing. */
+    current: string | undefined;
+    /** Tabs shown before More (default 5). */
+    max?: number;
+    class?: string;
+};
+/** Two deterministic strip levels; only opening the menu reads CSS visibility. */
+export declare function viewTabsLayout(items: readonly ViewTab[], current: string | undefined, max?: number): {
+    wide: number[];
+    compact: number[];
+    wideHidden: number;
+    compactHidden: number;
+};
+/**
+ * URL-backed object views. Every view is an ordinary document link, in the strip and under More, so reload, back,
+ * and forward keep the view the URL names.
+ */
+export declare function ViewTabs(props: ViewTabsProps): JSX.Element;

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

@@ -1,5 +1,7 @@
 declare const filterMessages: import("@k2b/stdlib").Catalog<{
     filterActions: string;
+    filters: string;
+    reset: string;
 }>;
 export type FilterMessages = ReturnType<(typeof filterMessages)["resolve"]>["t"];
 /** Resolved from the inherited render locale. */

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

@@ -10,8 +10,8 @@ export type { DragPayload, DragSourceProps, DropTargetProps } from "./DragAndDro
 export { activeDrag, DragSource, DropTarget, useKeyboardDrag } from "./DragAndDrop";
 export type { DropdownAction, DropdownActionBase, DropdownChoice, DropdownItemProps, DropdownPosition, DropdownProps, DropdownSection, DropdownTriggerProps, } from "./Dropdown";
 export { Dropdown, DropdownItem, dropdownPosition } from "./Dropdown";
-export type { FilterChipOption, FilterChipProps, FilterChipSection } from "./FilterChip";
-export { FilterChip } from "./FilterChip";
+export type { FilterChipOption, FilterChipProps, FilterChipSection, FilterToggleProps } from "./FilterChip";
+export { FilterChip, FilterToggle } from "./FilterChip";
 export type { GestureKind, GestureMenuAction, GestureMenuItem, GestureMenuProps, GestureMenuSection } from "./GestureMenu";
 export { GestureMenu } from "./GestureMenu";
 export type { RemoveButtonProps } from "./RemoveButton";
@@ -26,3 +26,5 @@ export type { TabOption, TabsItemProps, TabsProps } from "./Tabs";
 export { Tabs } from "./Tabs";
 export type { ToolbarActionProps, ToolbarGroupProps, ToolbarLabelProps, ToolbarProps, ToolbarSeparatorProps } from "./Toolbar";
 export { Toolbar } from "./Toolbar";
+export type { ViewTab, ViewTabsProps } from "./ViewTabs";
+export { ViewTabs } from "./ViewTabs";

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

@@ -15,6 +15,18 @@ export type ChatCommandResult = void | "cancelled" | {
 } | {
     mention: ChatAttachment;
 };
+/** The draft as a successful `open` leaves it: without the `/…` token, with its references moved along. Save this one. */
+export type ChatCommandDraft = {
+    value: string;
+    mentions: readonly ChatMention[];
+};
+/**
+ * How an `open` row ends: on success (`void`) the token leaves as for an action; `"cancelled"` changes nothing; `failed`
+ * keeps the list open and the draft unchanged, and its text replaces the row's description until the row runs again.
+ */
+export type ChatCommandOpenResult = void | "cancelled" | {
+    failed: string;
+};
 /** A fixed place in the slash list. Sections keep the given order, also while searching. */
 export type ChatCommandSection = {
     id: string;
@@ -23,6 +35,20 @@ export type ChatCommandSection = {
     searched?: boolean;
     /** Only while searching or narrowed: absent from the overview (empty query), including its loading placeholder. */
     searchOnly?: boolean;
+    /** Only in the overview (empty query, no scope): absent while searching or narrowed, such as recently used rows. */
+    overviewOnly?: boolean;
+    /**
+     * Its local rows are fixed when the list opens: a row that arrives while the list is open waits for the next opening,
+     * so a section above others whose rows load in the background never pushes a visible row down. Rows that go away
+     * still leave at once.
+     */
+    fixedWhileOpen?: boolean;
+    /**
+     * Local rows still on their way, such as Commands from a catalog: the section ends with placeholder rows, three in
+     * the overview and one while searching, and its heading shows a spinner. Make it the last section, so rows that
+     * arrive only fill the end of the list and no visible row moves.
+     */
+    pending?: boolean;
 };
 /** First-word narrowing; Tab writes `words[0]` followed by a space. */
 export type ChatCommandScope = {
@@ -47,8 +73,15 @@ export type ChatCommand = {
     selected?: boolean;
     /** Retry discovery in a new opening, retaining the token and currently displayed rows. */
     searchAgain?: boolean;
+    /** Stays in every search of its section, after the matches, such as a row that retries loading the section. */
+    persistent?: boolean;
     /** Application name, searchable but not displayed. */
     app?: string;
+    /**
+     * Used recently by this person. While searching, a matching row moves one step up the ranking ladder of its section
+     * and comes before rows of equal rank. The overview keeps consumer order.
+     */
+    recent?: boolean;
     /** Stable row key for option ids, marking and de-duplication. Defaults to `name`. */
     id?: string;
     name: string;
@@ -62,6 +95,16 @@ export type ChatCommand = {
     busyLabel?: string;
     /** Failures restore an unchanged draft and appear once in the status line, without calling `onError`. */
     action?: (context: ChatCommandContext) => ChatCommandResult | Promise<ChatCommandResult>;
+    /**
+     * Leaves the composer, such as opening another app. Runs with the token and the list in place: the row shows
+     * `busyLabel` (default "Opening …") with a spinner instead of its description, and editing waits. A rejection ends like
+     * an action's: the token stays, the list closes and the status line names the reason. Closing the list, such as with
+     * Escape, cancels: `signal` aborts and the row ends at once. `signal` also aborts when the opening ends any other way
+     * than by success, so the opener can save the draft with its token again. A new `draftKey` cancels too, unless the
+     * opener calls `follow()` right before changing it itself: that next change keeps the opening, moves its busy line
+     * to the status line, and Escape still cancels. See `ChatCommandOpenResult`.
+     */
+    open?: (draft: ChatCommandDraft, signal: AbortSignal, follow: () => void) => Promise<ChatCommandOpenResult>;
     /** Selecting a reference inserts its display name and retains its opaque payload. */
     mention?: ChatAttachment;
     /**
@@ -104,7 +147,16 @@ export type ChatComposerProps = {
     fileSelection?: ChatFileSelection;
     /** Handle non-file clipboard content. Pasted files already use `fileSelection`. */
     onPaste?: ChatPasteHandler;
+    /** The add menu's entries after "Attach files". Not shown with `addOpensCommands`. */
     menuActions?: readonly ChatAction[];
+    /**
+     * "+" opens the slash list with a search field on top instead of the add menu, for keyboards where "/" is hard to
+     * reach, such as a phone's. The search field filters, narrows and chooses as typing after "/" does, and a reference
+     * lands where the field's caret was when "+" was pressed. Escape, "+" again, Back on a phone or a press outside
+     * closes the list without acting on what lies below, and the field gets its focus and selection back. `menuActions`
+     * do not show then: offer them as `commands`, and file selection as a row with `attachFiles`.
+     */
+    addOpensCommands?: boolean;
     models?: readonly ChatModelOption[];
     selectedModelId?: string | null;
     onModelChange?: (modelId: string) => void;

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

@@ -72,10 +72,25 @@ declare function ChatPreviewTitle(props: ChatPreviewTitleProps): JSX.Element;
 declare function ChatPreviewSentence(props: {
     children: JSX.Element;
 }): JSX.Element;
+export type ChatPreviewExcerptProps = {
+    children: JSX.Element;
+    /** Shows the whole text in place instead of the first lines, such as after `Chat.Preview.ShowAll`. */
+    expanded?: boolean;
+    id?: string;
+};
 /** The first lines of a longer text. It keeps its line breaks, shows about three lines, and fades out. */
-declare function ChatPreviewExcerpt(props: {
+declare function ChatPreviewExcerpt(props: ChatPreviewExcerptProps): JSX.Element;
+export type ChatPreviewShowAllProps = {
+    /** The id of the `Chat.Preview.Excerpt` this button opens. */
+    controls: string;
+    onShow: () => void;
     children: JSX.Element;
-}): JSX.Element;
+};
+/**
+ * Shows the rest of an excerpt in place, for a text with no page of its own to open. It looks like `ReadMore`; the
+ * caller removes it once the text is shown, and the focus moves to the text, so reading goes on where it was.
+ */
+declare function ChatPreviewShowAll(props: ChatPreviewShowAllProps): JSX.Element;
 export type ChatPreviewReadMoreProps = {
     href: string;
     children: JSX.Element;
@@ -120,6 +135,7 @@ export declare const ChatPreview: typeof ChatPreviewRoot & {
     Sentence: typeof ChatPreviewSentence;
     Excerpt: typeof ChatPreviewExcerpt;
     ReadMore: typeof ChatPreviewReadMore;
+    ShowAll: typeof ChatPreviewShowAll;
     Lines: typeof ChatPreviewLines;
     Line: typeof ChatPreviewLine;
     People: typeof ChatPreviewPeople;

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

@@ -53,5 +53,15 @@ export type ChatContextUsageProps = ChatContextUsageData & {
 };
 export declare const formatChatTokens: (tokens: number) => string;
 export declare function ChatMessage(props: ChatMessageProps): JSX.Element;
+export type ChatActivityToggleProps = {
+    /** The words that open the body, usually the count, such as "3 of 4 tasks". */
+    children: JSX.Element;
+};
+/**
+ * The words of an activity label that open its body, with the chevron right after them. With a toggle in its label,
+ * only these words are the disclosure, and the rest of the row, chips with links included, stays ordinary content.
+ * Outside an activity with a body it renders its words as plain text.
+ */
+export declare function ChatActivityToggle(props: ChatActivityToggleProps): JSX.Element;
 export declare function ChatActivity(props: ChatActivityProps): JSX.Element;
 export declare function ChatContextUsage(props: ChatContextUsageProps): JSX.Element;

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

@@ -3,10 +3,14 @@ export declare const chatMessages: import("@k2b/stdlib").Catalog<{
     commandDraftChanged: string;
     markAdded: string;
     markRemoved: string;
+    commandOpening: string;
     commandSelected: string;
     attachments: string;
     assistant: string;
     addToChat: string;
+    addMenu: string;
+    commandSearch: string;
+    commandSearchLabel: string;
     attachFiles: string;
     addGuidance: string;
     chat: string;

package/dist/types/chat/command-search.d.ts

@@ -20,6 +20,8 @@ type Group = {
     rows: ChatCommandRow[];
     loading: boolean;
     placeholder: boolean;
+    /** Placeholder rows of a `pending` section, after its rows: three in the overview, one while searching. */
+    pendingRows: number;
 };
 export declare function chatCommandListModel(input: {
     query: string;

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

@@ -4,12 +4,12 @@ import { ChatTasks } from "./ChatTasks";
 export type { ChatTask, ChatTasksProps } from "./ChatTasks";
 import { ChatComposer } from "./ChatComposer";
 import { ChatDecision, ChatMark, ChatOutcome } from "./ChatDecision";
-import { ChatActivity, ChatContextUsage, ChatMessage } from "./ChatPrimitives";
+import { ChatActivity, ChatActivityToggle, ChatContextUsage, ChatMessage } from "./ChatPrimitives";
 import { ChatRoot } from "./ChatRoot";
 import { ChatTimeline } from "./ChatTimeline";
-export type { ChatCommand, ChatCommandContext, ChatCommandResult, ChatCommandScope, ChatCommandSearch, ChatCommandSection, ChatComposerProps, ChatFileSelection, ChatPasteHandler, } from "./ChatComposer";
-export type { ChatDecisionProps, ChatMarkProps, ChatOutcomeProps, ChatPreviewHeaderProps, ChatPreviewLineProps, ChatPreviewPeopleProps, ChatPreviewProps, ChatPreviewReadMoreProps, ChatPreviewTitleProps, } from "./ChatDecision";
-export type { ChatActivityProps, ChatContextUsageProps, ChatMessageProps } from "./ChatPrimitives";
+export type { ChatCommand, ChatCommandContext, ChatCommandDraft, ChatCommandOpenResult, ChatCommandResult, ChatCommandScope, ChatCommandSearch, ChatCommandSection, ChatComposerProps, ChatFileSelection, ChatPasteHandler, } 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";
 export type { ChatRootProps } from "./ChatRoot";
 export type { ChatActivityItem, ChatMessageItem, ChatTimelineItem, ChatTimelineProps } from "./ChatTimeline";
@@ -22,7 +22,9 @@ export declare const Chat: typeof ChatRoot & {
     Tasks: typeof ChatTasks;
     Timeline: typeof ChatTimeline;
     Message: typeof ChatMessage;
-    Activity: typeof ChatActivity;
+    Activity: typeof ChatActivity & {
+        Toggle: typeof ChatActivityToggle;
+    };
     Composer: typeof ChatComposer;
     ContextUsage: typeof ChatContextUsage;
     ContextPopup: typeof ChatContextPopup;
@@ -35,10 +37,9 @@ export declare const Chat: typeof ChatRoot & {
         Sentence: (props: {
             children: import("solid-js").JSX.Element;
         }) => import("solid-js").JSX.Element;
-        Excerpt: (props: {
-            children: import("solid-js").JSX.Element;
-        }) => import("solid-js").JSX.Element;
+        Excerpt: (props: import("./ChatDecision").ChatPreviewExcerptProps) => import("solid-js").JSX.Element;
         ReadMore: (props: import("./ChatDecision").ChatPreviewReadMoreProps) => import("solid-js").JSX.Element;
+        ShowAll: (props: import("./ChatDecision").ChatPreviewShowAllProps) => import("solid-js").JSX.Element;
         Lines: (props: {
             label?: string;
             children: import("solid-js").JSX.Element;

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

@@ -85,6 +85,9 @@ export type DataTableProps<T> = {
     footer?: DataTableFooter<T>;
     hasMore?: boolean;
     loadingMore?: boolean;
+    loading?: boolean;
+    /** Initial placeholder count, clamped to an integer from 1 to 50. Defaults to 5. */
+    loadingRows?: number;
     onLoadMore?: () => void;
     empty?: JSX.Element;
     density?: "compact" | "normal";

package/dist/types/content/data-table-messages.d.ts

@@ -2,6 +2,7 @@ declare const dataTableMessages: import("@k2b/stdlib").Catalog<{
     dataTable: string;
     noColumns: string;
     noRecords: string;
+    loadingRows: string;
 }>;
 export type DataTableMessages = ReturnType<(typeof dataTableMessages)["resolve"]>["t"];
 /** Resolved from the inherited render locale. */

package/dist/types/feedback/MovedHint.d.ts

@@ -0,0 +1,25 @@
+import { type JSX } from "solid-js";
+import { type TooltipPlacement } from "./tooltip-position";
+export type MovedHintAction = {
+    label: string;
+    href: string;
+    onClick?: never;
+} | {
+    label: string;
+    onClick: () => void;
+    href?: never;
+};
+export type MovedHintProps = {
+    /** The owner decides this on the server, so a dismissed hint never renders again. */
+    open: boolean;
+    /** Called once per open period when the person closes the hint or uses its action. */
+    onDismiss: () => void;
+    /** Render the hint directly after this element to preserve keyboard order. */
+    target: () => HTMLElement | undefined;
+    /** Short text naming the new place. */
+    children: JSX.Element;
+    action: MovedHintAction;
+    placement?: TooltipPlacement;
+    class?: string;
+};
+export declare function MovedHint(props: MovedHintProps): JSX.Element;

package/dist/types/feedback/dialog-core.d.ts

@@ -10,9 +10,11 @@ export type OpenDialogOptions = {
     ariaLabel?: string;
     /**
      * Add a same-URL history entry while the dialog is open, so the browser's or the phone's Back closes the dialog
-     * instead of leaving the page. Closing the dialog removes the entry again; the returned promise settles after that.
+     * instead of leaving the page. Normally closing the dialog removes the entry again; the returned promise settles after that.
      * With the Navigation API, same-URL traversals between this core's entries and the page do not reach application popstate listeners.
      * Without it, only the synthetic Back on close is suppressed.
+     * Island disposal closes every open dialog immediately and forgets its marker without traversing history.
+     * The same-URL entry remains for the router to replace and counts as a page entry for later dialogs.
      */
     history?: boolean;
 };
@@ -46,7 +48,8 @@ export declare const dialogCore: DialogCore;
 /**
  * Internal: transient UI shares dialogs' Back handling without exposing another public dialog capability.
  * Same-URL traversals are suppressed with the Navigation API; without it, only the synthetic Back on release is suppressed.
+ * Release during island disposal forgets the marker without traversing; the router may replace the remaining entry.
  */
 export declare const holdDialogHistory: (onBack: () => void) => (() => void);
-/** Internal: waits until entries released through `holdDialogHistory` have left the history. */
+/** Internal: waits until released holders have left history or were forgotten during island disposal. */
 export declare const dialogHistorySettled: () => Promise<void>;

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

@@ -10,6 +10,8 @@ export type { InstallGuideProps } from "./InstallGuide";
 export { default as InstallGuide } from "./InstallGuide";
 export type { InstallationPlatform, InstallPrompt } from "./install";
 export { createInstallPrompt, installationPlatform } from "./install";
+export type { MovedHintAction, MovedHintProps } from "./MovedHint";
+export { MovedHint } from "./MovedHint";
 export type { ConfirmOptions, DialogOptions, FieldSchema, PromptFieldBase, PromptSearchInput, PromptSearchItem, PromptSearchOptions, } from "./prompts";
 export { createFormState, DialogHeader, prompts } from "./prompts";
 export type { TooltipAnchorProps, TooltipPlacement, TooltipProps, TooltipTriggerProps } from "./Tooltip";

package/dist/types/feedback/prompts.d.ts

@@ -94,6 +94,8 @@ export type FieldSchema = (PromptFieldBase<string> & {
 }) | (PromptFieldBase<string> & {
     type: "datetime";
     dateOnly?: boolean;
+    /** A date whose time is optional, as `DateTimePicker`'s `optionalTime`. */
+    optionalTime?: boolean;
 }) | {
     type: "info";
     content: string | JSX.Element | (() => JSX.Element);

package/dist/types/inputs/DatePicker.d.ts

@@ -28,6 +28,13 @@ export type DatePickerProps = DatePickerBaseProps<string | null> & {
 export type DateTimePickerProps = DatePickerBaseProps<string | null> & {
     /** Trigger content for a set value, for example the date and time with a relative hint. */
     renderValue?: (value: string) => JSX.Element;
+    /**
+     * The time is optional: the value is a date key such as `2026-10-24` until **Add time** adds one, then a date-time
+     * like without this option. Removing the time returns to the date key.
+     */
+    optionalTime?: boolean;
+    /** The time a new value starts with, `09:00` by default. */
+    defaultTime?: string;
 };
 export type DateRangePickerProps = DatePickerBaseProps<DateRangeValue> & {
     withTime?: boolean;

package/dist/types/inputs/date-picker.d.ts

@@ -30,7 +30,10 @@ export declare const monthDate: (year: number, month: number, context?: DateCont
  * or repeats midnight, the day starts at its first existing instant.
  */
 export declare const msUntilNextDay: (now: Date, context?: DateContext) => number;
+/** Whether `value` is a date key such as `2026-10-24`, a date without a time. */
+export declare const isDateKey: (value: string) => boolean;
 export declare const parseDateValue: (value: string | null | undefined, context?: DateContext) => Date;
+/** A date key names a calendar day, so it is formatted at noon UTC in UTC: no runtime or picker zone can move it. */
 export declare const displayDate: (value: string | null | undefined, context?: DateContext) => string;
 export declare const dateTimeInput: (value: string | null | undefined, context?: DateContext) => string;
 export declare const splitDateTime: (value: string | null | undefined, context?: DateContext) => {
@@ -43,7 +46,28 @@ export declare const formatDateTimeValue: (value: string | null | undefined, con
 export declare const normalizeTimeInput: (value: string) => string;
 export declare const filterTimeInput: (value: string) => string;
 export declare const orderedRange: (start: string, end: string) => DateRangeValue;
-export declare const previewRange: (range: DateRangeValue, preview: string | null) => DateRangeValue;
+/**
+ * The range a click picks. A click starts a complete one-day range on its day, and it becomes the anchor; the next
+ * click on another day extends the range from the anchor, whichever side it lies on. A click on the anchor keeps the
+ * one-day range. After an extension, the next click starts a new one-day range.
+ */
+export declare const pickRangeDay: (range: DateRangeValue, anchor: string | null, day: string) => {
+    range: DateRangeValue;
+    anchor: string | null;
+};
+/** The anchor that the next click extends from: only while the range is still the one-day range of its click. */
+export declare const rangeAnchor: (range: DateRangeValue, anchor: string | null) => string | null;
+/** The range shown while the pointer or focus rests on `preview`: the extension that a click there would pick. */
+export declare const previewRange: (range: DateRangeValue, anchor: string | null, preview: string | null) => DateRangeValue;
 export declare const inRange: (day: string, range: DateRangeValue) => boolean;
 export declare const isRangeEdge: (day: string, range: DateRangeValue) => boolean;
 export declare const formatDateOnlyRangeDuration: (range: DateRangeValue, context?: DateContext) => string;
+/**
+ * The weekend bands of a week row: one band per run of adjacent weekend columns, as a zero-based start column and a
+ * number of columns. Saturday and Sunday in a week from Monday are one band of two; in a week from Sunday they are
+ * two bands at both ends.
+ */
+export declare const weekendBands: (weekend: readonly boolean[]) => {
+    start: number;
+    span: number;
+}[];

package/dist/types/intl/messages.d.ts

@@ -25,12 +25,16 @@ declare const uiMessages: import("@k2b/stdlib").Catalog<{
     nothingToShow: string;
     no: string;
     options: string;
+    more: string;
+    moreViews: string;
     pickDate: string;
     previousMonth: string;
     previousYear: string;
     nextMonth: string;
     nextYear: string;
     retry: string;
+    tryAgain: string;
+    movedHintDismiss: string;
     reset: string;
     required: string;
     delete: string;
@@ -56,6 +60,8 @@ declare const uiMessages: import("@k2b/stdlib").Catalog<{
     month: string;
     year: string;
     allDay: string;
+    addTime: string;
+    removeTime: string;
     previous: string;
     next: string;
     cancel: string;

package/dist/types/intl/weekend.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The weekend days of `locale` as JavaScript day numbers (0 for Sunday): Saturday and Sunday in Germany, Friday and
+ * Saturday in Israel. The days come from the engine's Intl week data where it has them, otherwise Saturday and Sunday.
+ * Without a locale the answer is Saturday and Sunday too, so a server render and the browser agree.
+ */
+export declare const weekendDays: (locale: string | undefined) => ReadonlySet<number>;
+/** The day of the week of a date key such as `2026-10-24`, as a JavaScript day number (0 for Sunday). */
+export declare const dayOfWeekOfKey: (key: string) => number;
+/** Whether the day of `key` is a weekend day of `locale`. */
+export declare const isWeekendKey: (key: string, locale: string | undefined) => boolean;
+/** Whether column `index` of a week that starts on `firstDayOfWeek` (0 for Sunday, 1 for Monday) is a weekend day. */
+export declare const isWeekendColumn: (index: number, firstDayOfWeek: number, locale: string | undefined) => boolean;

package/dist/types/layout/AppWorkspace.d.ts

@@ -3,6 +3,28 @@ import { type JSX } from "solid-js";
 import { type AppWorkspaceLayoutState } from "./app-workspace-state";
 import type { ScrollAreaProps } from "./ScrollArea";
 import { type AppWorkspaceSidebarSwitcherProps } from "./SidebarSwitcher";
+export type AppWorkspaceHeadProps = {
+    /** View tabs, usually a ViewTabs. */
+    views?: JSX.Element;
+    /** Filter chips, usually FilterChip elements. */
+    filters?: JSX.Element;
+    /** Any filter is active: shows Reset and the quiet result count. */
+    filtered?: boolean;
+    /** Reset target while filtered: a URL (works without JavaScript) and/or a callback. */
+    resetHref?: string;
+    onReset?: () => void;
+    /** Quiet result count shown only while filtered; CSS drops it first when space is short. */
+    count?: JSX.Element;
+    /** Secondary actions at the end of the row. Never a filled button. */
+    actions?: JSX.Element;
+    /** The one filled primary action. Below 48rem it becomes a round icon button beside the host's bottom bar. */
+    primary?: {
+        label: string;
+        icon: string;
+        href?: string;
+        onClick?: (event: MouseEvent) => void;
+    };
+};
 export type AppWorkspaceProps = {
     children: JSX.Element;
     class?: string;
@@ -40,6 +62,14 @@ export type AppWorkspaceMainProps = {
     class?: string;
     /** `"content"` centers the children as one reading column with the shared page width on large screens. */
     width?: "full" | "content";
+    /**
+     * The width in px that Main keeps beside the sidebar and an open Detail,
+     * from 48rem (768 px); at least the default 320. A Detail that does not fit
+     * beside it waits behind the head's Details button, and from 64rem of host
+     * width a sidebar that does not fit becomes the overlay. CSS decides, so
+     * the server renders the first frame.
+     */
+    minWidth?: number;
     mobilePane?: string;
     /** Levels in DOM order, shallowest first. The URL selects the deepest level by id. */
     level?: string;
@@ -75,6 +105,12 @@ export type AppWorkspaceDetailWidth = "sm" | "md" | "lg" | "xl";
 export type AppWorkspaceDetailProps = {
     children: JSX.Element;
     open: boolean;
+    /**
+     * Whether choosing an item in Main opens this Detail as the drawer while it waits.
+     * Set false when Main itself shows the chosen item, such as a reader beside a list:
+     * the drawer then opens only from Details or from a toggle in Main.
+     */
+    openOnChoice?: boolean;
     id: string;
     class?: string;
     width?: AppWorkspaceDetailWidth;
@@ -85,12 +121,11 @@ export type AppWorkspaceDetailProps = {
     minWidth?: number;
     maxWidth?: number;
     /**
-     * Closes the panel: Escape, a swipe on a touch screen, and dragging the
-     * phone sheet down call it. A panel rendered on the server only marks its
-     * own close button or link with `data-workspace-detail-close` instead, and
-     * those gestures click it. Without either, they leave the panel open, and on
-     * a touch tablet in portrait the panel makes room beside `Main` instead of
-     * overlaying it as a drawer.
+     * Closes the column with Escape, or the phone sheet with a downward drag.
+     * Server-rendered panels mark their close control with
+     * `data-workspace-detail-close` instead; those gestures click it.
+     * Escape and a rightward touch swipe park an open waiting drawer without
+     * calling onClose, so its Details button can open it again.
      */
     onClose?: () => void;
     /**
@@ -249,7 +284,7 @@ export type AppWorkspaceSidebarItemIconProps = {
 };
 export type AppWorkspaceSidebarItemLabelProps = {
     children: JSX.Element;
-    /** False keeps one line with an ellipsis; rows wrap long labels onto a second line by default. */
+    /** False keeps one line that fades out; rows wrap long labels onto a second line by default. */
     marquee?: boolean;
 };
 export type AppWorkspaceSidebarItemMetaProps = {
@@ -362,6 +397,7 @@ type AppWorkspaceNavTreeComponent = ((props: AppWorkspaceNavTreeProps) => JSX.El
 };
 type AppWorkspaceComponent = ((props: AppWorkspaceProps) => JSX.Element) & {
     LayoutStateProvider: (props: AppWorkspaceLayoutStateProviderProps) => JSX.Element;
+    Head: (props: AppWorkspaceHeadProps) => JSX.Element;
     Content: (props: AppWorkspaceContentProps) => JSX.Element;
     Main: (props: AppWorkspaceMainProps) => JSX.Element;
     MainPane: (props: AppWorkspaceMainPaneProps) => JSX.Element;

package/dist/types/layout/app-host-width.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Watches whether workspace chrome has at least `minRem` of app host width.
+ * CSS for the same chrome uses `@container k2b-app-area (min-width: …)`.
+ * Call with a mounted element; the returned function stops all observation.
+ */
+export declare function watchAppHostWidth(element: Element, minRem: number, update: (matches: boolean) => void): () => void;

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

@@ -1,7 +1,8 @@
 export type { AppOverviewCardsProps, AppOverviewEmptyStateProps, AppOverviewPanelProps, AppOverviewProps, } from "./AppOverview";
 export { default as AppOverview } from "./AppOverview";
-export type { AppWorkspaceBottomDrawerHeight, AppWorkspaceBottomDrawerProps, AppWorkspaceContentProps, AppWorkspaceDetailProps, AppWorkspaceDetailWidth, AppWorkspaceMainPaneProps, AppWorkspaceMainProps, AppWorkspaceNavTreeItemProps, AppWorkspaceNavTreeMove, AppWorkspaceNavTreeProps, AppWorkspaceProps, AppWorkspaceSidebarAccessoryVisibility, AppWorkspaceSidebarBodyProps, AppWorkspaceSidebarIconActionProps, AppWorkspaceSidebarIconActionTone, AppWorkspaceSidebarIconGridProps, AppWorkspaceSidebarItemActionProps, AppWorkspaceSidebarItemActionsProps, AppWorkspaceSidebarItemIconProps, AppWorkspaceSidebarItemLabelProps, AppWorkspaceSidebarItemMetaProps, AppWorkspaceSidebarItemProps, AppWorkspaceSidebarItemStatusProps, AppWorkspaceSidebarItemTone, AppWorkspaceSidebarProps, AppWorkspaceSidebarSectionProps, AppWorkspaceSidebarVisibility, } from "./AppWorkspace";
+export type { AppWorkspaceBottomDrawerHeight, AppWorkspaceBottomDrawerProps, AppWorkspaceContentProps, AppWorkspaceDetailProps, AppWorkspaceDetailWidth, AppWorkspaceHeadProps, AppWorkspaceMainPaneProps, AppWorkspaceMainProps, AppWorkspaceNavTreeItemProps, AppWorkspaceNavTreeMove, AppWorkspaceNavTreeProps, AppWorkspaceProps, AppWorkspaceSidebarAccessoryVisibility, AppWorkspaceSidebarBodyProps, AppWorkspaceSidebarIconActionProps, AppWorkspaceSidebarIconActionTone, AppWorkspaceSidebarIconGridProps, AppWorkspaceSidebarItemActionProps, AppWorkspaceSidebarItemActionsProps, AppWorkspaceSidebarItemIconProps, AppWorkspaceSidebarItemLabelProps, AppWorkspaceSidebarItemMetaProps, AppWorkspaceSidebarItemProps, AppWorkspaceSidebarItemStatusProps, AppWorkspaceSidebarItemTone, AppWorkspaceSidebarProps, AppWorkspaceSidebarSectionProps, AppWorkspaceSidebarVisibility, } from "./AppWorkspace";
 export { default as AppWorkspace } from "./AppWorkspace";
+export { watchAppHostWidth } from "./app-host-width";
 export type { AppWorkspaceControllerOptions } from "./app-workspace-controller";
 export { installAppWorkspaceController, parkWorkspaceDetailDrawers } from "./app-workspace-controller";
 export type { AppWorkspaceLayoutState, AppWorkspaceResizeKind, } from "./app-workspace-state";

package/dist/types/surfaces/Placeholder.d.ts

@@ -1,7 +1,7 @@
 import { type JSX } from "solid-js";
 export type PlaceholderAlign = "center" | "left";
 export type PlaceholderSurface = "none" | "paper";
-export type PlaceholderState = "empty" | "loading" | "error";
+export type PlaceholderState = "empty" | "no-results" | "no-access" | "loading" | "error";
 /** `compact` stacks inside a section, `inline` is one row in a list or sidebar, `panel` fills a work area. */
 export type PlaceholderVariant = "compact" | "inline" | "panel";
 export type PlaceholderProps = {
@@ -9,6 +9,7 @@ export type PlaceholderProps = {
     description?: JSX.Element;
     icon?: string;
     action?: JSX.Element;
+    onRetry?: () => void;
     align?: PlaceholderAlign;
     surface?: PlaceholderSurface;
     state?: PlaceholderState;