@k2b/ui 0.27.0 → 0.29.0

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

@@ -1,7 +1,60 @@
+import type { JSX } from "solid-js";
 import type { EmojiSkinTone } from "../inputs/emoji/emoji-index";
 export type ChatRole = "user" | "assistant" | "system" | "tool";
 export type ChatMessageStatus = "pending" | "streaming" | "complete" | "error";
-export type ChatActivityTone = "neutral" | "ai" | "success" | "danger";
+/** `warning` marks a partial result or an outcome that is not yet known. */
+export type ChatActivityTone = "neutral" | "ai" | "success" | "warning" | "danger";
+/** `open` asks; `sending` while the answer is on its way; `decided` once answered; `expired` when it ran out. */
+export type ChatDecisionState = "open" | "sending" | "decided" | "expired";
+/** One answer of a question. Set the question's state in `onSelect` before awaiting anything, so it collapses at once. */
+export type ChatDecisionAnswer = {
+    label: string;
+    /** Icon class, for example `ti ti-send`. */
+    icon?: string;
+    onSelect: () => void | Promise<void>;
+};
+/** Why a question is asked, or why its main answer is off. */
+export type ChatDecisionReason = {
+    text: JSX.Element;
+    /** Icon class; the text after it starts 1.5rem from the edge. */
+    icon?: string;
+    /** `danger` for deletions, `warning` for outside content and limits. */
+    tone?: "neutral" | "danger" | "warning";
+};
+export type ChatOutcomeTone = "running" | "done" | "off" | "waiting" | "warning" | "error";
+/** One text of an outcome flow. */
+export type ChatOutcomeLine = {
+    tone: ChatOutcomeTone;
+    /** What happened, as one sentence, usually with `ReferenceChip`s. */
+    text: JSX.Element;
+    /** A quiet second sentence, such as "You declined." */
+    detail?: JSX.Element;
+    /** A formatted time after the text. */
+    time?: string;
+    /** Replaces the tone's icon, for example `ti ti-clock-x` for an expired question. */
+    icon?: string;
+    /** One text link after the line, such as "Ask again". */
+    action?: {
+        label: string;
+        onSelect: () => void | Promise<void>;
+    };
+    /** Small buttons under the line. Shown while this line is current; otherwise hidden but still reserving their row. */
+    actions?: JSX.Element;
+};
+/** A person in a preview header: the name in the text colour, then the address the message really uses. */
+export type ChatPreviewPerson = {
+    name?: string;
+    address?: string;
+};
+/** One header row, such as "To Lea Berg lea.berg@example.com". */
+export type ChatPreviewHeaderRow = {
+    label: string;
+    people?: readonly ChatPreviewPerson[];
+    /** Further content after the people, such as "and 2 more". */
+    value?: JSX.Element;
+    /** Draws the label stronger, for recipients others cannot see. */
+    emphasis?: boolean;
+};
 type ChatActionBase = {
     id: string;
     label: string;

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

@@ -2,7 +2,7 @@ import type { MapViewport } from "@k2b/stdlib";
 import { charts } from "@k2b/stdlib";
 import type { JSX } from "solid-js";
 import type { ChartCursor } from "./chart-cursor";
-import { type ChartDatumRef, type ChartSelection, type ChartTooltipFormatter } from "./chart-inspection";
+import { type ChartDatumRef, type ChartKind, type ChartSelection, type ChartTooltipFormatter } from "./chart-inspection-core";
 import { type StateTimelineChartOptions, type StateTimelineDomain } from "./chart-state-timeline";
 /**
  * Chart — minimal Solid wrapper around `stdlib.charts`.
@@ -25,9 +25,9 @@ import { type StateTimelineChartOptions, type StateTimelineDomain } from "./char
  * **Why so thin.** The props are a discriminated union over each
  * stdlib chart function — `kind: "line"` brings in exactly the params
  * `charts.line` expects, `kind: "bar"` brings in `charts.bar`'s, etc.
- * Options stay aligned with stdlib without renaming. Shared interactive
- * layers add bounded pan / zoom controls to maps and state timelines, plus
- * renderer-owned inspection, tooltips and optional selection for all chart kinds.
+ * Options stay aligned with stdlib without renaming. Every chart provides
+ * renderer-owned inspection, tooltips and optional selection by default.
+ * `interactive` adds bounded pan / zoom and reset controls to maps and state timelines.
  * If stdlib gains a new option, it's automatically available at every
  * callsite.
  *
@@ -49,7 +49,7 @@ import { type StateTimelineChartOptions, type StateTimelineDomain } from "./char
  * ```
  */
 /** All chart kinds shipped by `stdlib.charts`. */
-export type ChartKind = keyof typeof charts;
+export type { ChartKind } from "./chart-inspection-core";
 export type ChartLabels = Partial<{
     empty: string;
     series: string;
@@ -75,10 +75,16 @@ export type ChartProps = {
         class?: string;
         style?: JSX.CSSProperties | string;
         labels?: ChartLabels;
+        /**
+         * Navigation for maps and state timelines: pan, zoom and reset controls.
+         * Arrows pan; Alt+arrows inspect. Every chart shows tooltips and keyboard
+         * inspection without this prop.
+         */
         interactive?: boolean;
         onSelect?: (selection: ChartSelection) => void;
         /** Controlled highlight; indices belong to this exact input snapshot. */
         selected?: ChartDatumRef | null;
+        /** Customize the always-on tooltip with a title and labeled text rows. */
         tooltip?: ChartTooltipFormatter;
         /** Optional shared X cursor for line charts. */
         cursor?: ChartCursor;

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

@@ -0,0 +1,27 @@
+import type { JSX } from "solid-js";
+/** The colour family a file's icon tile uses. `other` covers code, text, and unknown files. */
+export type FileType = "folder" | "pdf" | "image" | "sheet" | "document" | "slides" | "video" | "audio" | "archive" | "other";
+export type FileTypeIconProps = {
+    /** The file or folder name; its extension picks the glyph and the type colour. */
+    name: string;
+    mediaType?: string;
+    folder?: boolean;
+    /** Shows an open folder, for example the folder a list is showing. */
+    open?: boolean;
+    /** A Tabler icon class that replaces the glyph the name picks; the type colour still follows the name. */
+    icon?: string;
+    /** `sm` for tree rows, `md` for list rows, `lg` for grid previews. Defaults to `md`. */
+    size?: "sm" | "md" | "lg";
+    class?: string;
+};
+/** Resolve the colour family for a file or folder from its name and media type. */
+export declare const fileTypeOf: (file: {
+    name: string;
+    mediaType?: string;
+    folder?: boolean;
+}) => FileType;
+/**
+ * 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`.
+ */
+export declare function FileTypeIcon(props: FileTypeIconProps): JSX.Element;

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

@@ -1,4 +1,5 @@
 import { type JSX } from "solid-js";
+import { type ReactionBarItem } from "./ReactionBar";
 export type MessageRowAuthor = {
     /** Display name, shown at the start of a group and read before every message. */
     name: string;
@@ -25,16 +26,8 @@ export type MessageRowQuote = {
     /** Opens the quoted message, for example by scrolling to it. Without it, the quote is not a control. */
     onSelect?: () => void;
 };
-export type MessageRowReaction = {
-    /** Stable identity of the reaction, passed to `onToggleReaction`. */
-    key: string;
-    emoji: string;
-    count: number;
-    /** The reader reacted this way; the chip shows pressed. */
-    own?: boolean;
-    /** Who reacted, for example "Nora, Tobias". Read by screen readers and shown as a tooltip. */
-    label?: string;
-};
+/** Reaction labels are read by screen readers and shown in the names hint. */
+export type MessageRowReaction = ReactionBarItem;
 export type MessageRowThread = {
     /** Number of replies. */
     count: number;

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

@@ -0,0 +1,32 @@
+import { type JSX } from "solid-js";
+export type ReactionBarItem = {
+    /** Stable identity of the reaction, passed to `onToggle`. */
+    key: string;
+    emoji: string;
+    count: number;
+    /** The reader reacted this way; the chip shows pressed. */
+    own?: boolean;
+    /** Who reacted, for example from `reactionPeople`. Read by screen readers and shown in the names hint. */
+    label?: string;
+    /** A change of the reader's own reaction is still being saved; the chip carries `aria-busy`. */
+    busy?: boolean;
+};
+export type ReactionBarProps = {
+    reactions: readonly ReactionBarItem[];
+    /** Called with a reaction's key when the reader presses its chip. Without it, the chips are not controls. */
+    onToggle?: (key: string) => void;
+    /** Called by "Add reaction" with the button to anchor a picker to, such as `EmojiPicker.Popover`. Without it there is no button. */
+    onAdd?: (anchor: HTMLElement) => void;
+    /** "default": 26 px chips (chat, item detail). "compact": 24 px chips (cards). */
+    density?: "default" | "compact";
+    /** "scroll" (default): one line of fixed height that scrolls sideways. "wrap": every chip shows, lines wrap. */
+    overflow?: "scroll" | "wrap";
+    /** Shows at most this many chips and then "+n", n being the number of further emoji. The shown chips do not scroll. */
+    max?: number;
+    /** Screen-reader text of "+n"; defaults to "{n} more reactions". */
+    moreLabel?: (count: number) => string;
+    /** "always" (default) or "progressive": shown on hover and focus with a mouse or trackpad (k2b-progressive-action, inside the caller's k2b-progressive-row), kept while its picker is open, hidden on touch. Its place stays reserved. */
+    add?: "always" | "progressive";
+    class?: string;
+};
+export declare function ReactionBar(props: ReactionBarProps): JSX.Element;

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

@@ -0,0 +1,49 @@
+import { type JSX } from "solid-js";
+/** The visible length of a chip; longer titles are cut in the middle. */
+export declare const REFERENCE_CHIP_MAX_CHARACTERS = 40;
+/**
+ * Shortens `text` to at most `max` visible characters by cutting its middle, so the start and an ending such as
+ * ".pdf" stay readable. Counts user-perceived characters, so an emoji is never split.
+ * @example truncateMiddle("Quarterly report for the operations team 2026.pdf", 24) // "Quarterly re…m 2026.pdf"
+ */
+export declare const truncateMiddle: (text: string, max?: number) => string;
+type ReferenceChipCommon = {
+    class?: string;
+};
+/** A thing or a place: an icon in its application colour and its title, a link while it exists. */
+export type ReferenceChipObjectProps = ReferenceChipCommon & {
+    kind: "object" | "place";
+    title: string;
+    /** Destination of the chip. Omit it, or set `gone`, when there is nothing to open. */
+    href?: string;
+    /** Icon class, for example `ti ti-mail`. */
+    icon?: string;
+    /** Icon colour, usually the owning application's accent. Sets `--k2b-reference-icon`. */
+    accent?: string;
+    /** The thing no longer exists: struck through and never a link. */
+    gone?: boolean;
+};
+/** A person: avatar and display name. The address belongs in the preview, never in the chip. */
+export type ReferenceChipPersonProps = ReferenceChipCommon & {
+    kind: "person";
+    name: string;
+    /** Avatar image; initials on a tint from the name otherwise. */
+    src?: string | null;
+    href?: string;
+};
+/** A date or time the host already formatted for the reader. */
+export type ReferenceChipTimeProps = ReferenceChipCommon & {
+    kind: "time";
+    label: string;
+    /** Machine-readable value for `<time datetime>`. */
+    dateTime?: string;
+};
+export type ReferenceChipProps = ReferenceChipObjectProps | ReferenceChipPersonProps | ReferenceChipTimeProps;
+/**
+ * A typed reference inside a sentence: a thing, a place, a person, or a time, in the calm `.k2b-reference` pill.
+ * A chip shows at most 40 characters and cuts longer titles in the middle; the full title stays its accessible name
+ * and tooltip.
+ * @example <ReferenceChip kind="object" title="Maintenance window" icon="ti ti-mail" accent="var(--app-mail)" href="/mail/…" />
+ */
+export declare function ReferenceChip(props: ReferenceChipProps): JSX.Element;
+export default ReferenceChip;

package/dist/types/content/calendar-pointer.d.ts

@@ -22,6 +22,12 @@ type CalendarPointerSessionOptions<T> = {
     /** Called on every move once the gesture is active, such as to move a token with the pointer. */
     onMove?: (clientX: number, clientY: number) => void;
 };
+/**
+ * Runs `open` once the browser has handled the pointer release that ends a drag. The browser light-dismisses an
+ * `auto` popover that opens while it dispatches that `pointerup`, as the HTML popover rules ask and Chromium 156
+ * does, so a popover that a drag opens must open after the release.
+ */
+export declare const afterPointerRelease: (open: () => void) => void;
 /**
  * Owns one pointer gesture from threshold crossing through commit or cancel.
  * Views provide geometry through `resolve`; this helper owns global cleanup,

package/dist/types/content/chart-inspection-core.d.ts

@@ -0,0 +1,61 @@
+import type { ChartDatum, charts } from "@k2b/stdlib";
+import type { ChartCursor } from "./chart-cursor";
+export type ChartKind = keyof typeof charts;
+export type ChartDatumRef = Pick<ChartDatum, "role" | "index" | "seriesIndex">;
+export declare const sameChartDatum: (a: ChartDatumRef, b: ChartDatumRef) => boolean;
+export type ChartSelection = {
+    kind: ChartKind;
+    datum: ChartDatum;
+};
+export type ChartTooltip = {
+    title?: string;
+    rows: readonly {
+        label: string;
+        value: string;
+    }[];
+};
+export type ChartTooltipFormatter = (selection: ChartSelection) => ChartTooltip;
+export declare function isChartDatum(value: unknown): value is ChartDatum;
+/** Enhances existing SVG nodes. Pointer/focus changes never rebuild the chart. */
+export declare function createChartInspector(options: {
+    container: () => HTMLElement | undefined;
+    cursor?: () => ChartCursor | undefined;
+    tooltip: () => HTMLSpanElement | undefined;
+    anchor: () => HTMLSpanElement | undefined;
+    kind: () => ChartKind;
+    enabled: () => boolean;
+    format: ChartTooltipFormatter;
+    select: (selection: ChartSelection) => void;
+}): {
+    selectDatum: (selected: ChartDatumRef | null | undefined) => void;
+    selectData: (selected: readonly ChartDatumRef[]) => void;
+    linkCursor: (cursor: ChartCursor | undefined) => (() => void);
+    destroy: () => void;
+    move: (event: PointerEvent) => void;
+    down: (event: PointerEvent) => void;
+    click: (event: MouseEvent) => void;
+    focus: (event: FocusEvent) => void;
+    key: (event: KeyboardEvent) => boolean;
+    close: () => void;
+    invalidate: () => void;
+    leave: () => void;
+};
+/** Dismiss inspection on outside interaction, but allow the tooltip itself to scroll. */
+export declare function closeChartInspectionOnOutside(options: {
+    container: () => HTMLElement | undefined;
+    tooltip: () => HTMLElement | undefined;
+    close: () => void;
+}): () => void;
+export type InspectChartOptions = {
+    kind: ChartKind;
+    format: ChartTooltipFormatter;
+    select?: (selection: ChartSelection) => void;
+    cursor?: ChartCursor;
+};
+export type ChartInspection = {
+    invalidate(): void;
+    close(): void;
+    destroy(): void;
+};
+/** Attach inspection to stdlib SVG rendered with inspect: true, without a framework. */
+export declare function inspectChart(container: HTMLElement, options: InspectChartOptions): ChartInspection;

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

@@ -1,22 +1,6 @@
-import type { ChartDatum } from "@k2b/stdlib";
-import type { ChartKind } from "./Chart";
 import type { ChartCursor } from "./chart-cursor";
-export type ChartDatumRef = Pick<ChartDatum, "role" | "index" | "seriesIndex">;
-export declare const sameChartDatum: (a: ChartDatumRef, b: ChartDatumRef) => boolean;
-export type ChartSelection = {
-    kind: ChartKind;
-    datum: ChartDatum;
-};
-export type ChartTooltip = {
-    title?: string;
-    rows: readonly {
-        label: string;
-        value: string;
-    }[];
-};
-export type ChartTooltipFormatter = (selection: ChartSelection) => ChartTooltip;
-export declare function isChartDatum(value: unknown): value is ChartDatum;
-/** Enhances existing SVG nodes. Pointer/focus changes never rebuild the chart. */
+import { type ChartKind, type ChartSelection, type ChartTooltipFormatter } from "./chart-inspection-core";
+export type { ChartSelection } from "./chart-inspection-core";
 export declare function createChartInspection(options: {
     container: () => HTMLDivElement | undefined;
     cursor?: () => ChartCursor | undefined;
@@ -27,8 +11,8 @@ export declare function createChartInspection(options: {
     format: ChartTooltipFormatter;
     select: (selection: ChartSelection) => void;
 }): {
-    selectDatum: (selected: ChartDatumRef | null | undefined) => void;
-    selectData: (selected: readonly ChartDatumRef[]) => void;
+    selectDatum: (selected: import("./chart-inspection-core").ChartDatumRef | null | undefined) => void;
+    selectData: (selected: readonly import("./chart-inspection-core").ChartDatumRef[]) => void;
     move: (event: PointerEvent) => void;
     down: (event: PointerEvent) => void;
     click: (event: MouseEvent) => void;

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

@@ -1,6 +1,6 @@
 import { type ChartDatum } from "@k2b/stdlib";
 import { type ChartKind, type ChartRenderOptions } from "./Chart";
-import { type ChartSelection, type ChartTooltip, type ChartTooltipFormatter } from "./chart-inspection";
+import { type ChartSelection, type ChartTooltip, type ChartTooltipFormatter } from "./chart-inspection-core";
 /** Trusted output of prepareChartSnapshot; never accept arbitrary user SVG. */
 export type ChartSnapshot = {
     kind: ChartKind;

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

@@ -13,7 +13,7 @@ export { default as CodeDisplay } from "./CodeDisplay";
 export { type ChartCursor, createChartCursor } from "./chart-cursor";
 export type { ChartExplorerCharts, ChartExplorerController, ChartExplorerData, ChartExplorerOptions, ChartExplorerRequest, ChartExplorerRow, ChartExplorerSnapshot, } from "./chart-explorer";
 export { createChartExplorer } from "./chart-explorer";
-export type { ChartDatumRef, ChartSelection, ChartTooltip, ChartTooltipFormatter } from "./chart-inspection";
+export type { ChartDatumRef, ChartSelection, ChartTooltip, ChartTooltipFormatter } from "./chart-inspection-core";
 export type { ChartSnapshot } from "./chart-snapshot";
 export { prepareChartSnapshot } from "./chart-snapshot";
 export type { StateTimelineChartOptions, StateTimelineDomain, StateTimelineInterval, StateTimelineRow, StateTimelineState, } from "./chart-state-timeline";
@@ -25,6 +25,7 @@ export { DocCode, DocConceptGrid, DocInlineCode, DocLead, DocNote, DocPage, DocR
 export { FileBrowserPanel, type FileBrowserPanelProps, type FileSource, openFileBrowser } from "./FileBrowser";
 export { FileGrid, type FileGridProps } from "./FileGrid";
 export { default as FileTree, type FileTreeActions, type FileTreeEntry, type FileTreeProps } from "./FileTree";
+export { type FileType, FileTypeIcon, type FileTypeIconProps, fileTypeOf } from "./FileTypeIcon";
 export { canPreviewFile, default as FileView, type FileViewContent, type FileViewFile, type FileViewPreviewKind, type FileViewProps, type FileViewRenderer, type FileViewRendererProps, formatFileViewSize, getFileViewPreviewKind, } from "./FileView";
 export type { KbdProps } from "./Kbd";
 export { Kbd } from "./Kbd";
@@ -44,6 +45,9 @@ export type { PdfPreviewProps, PdfPreviewRequest } from "./PdfPreview";
 export { default as PdfPreview } from "./PdfPreview";
 export type { RangeOption, RangePickerProps } from "./RangePicker";
 export { default as RangePicker } from "./RangePicker";
+export { ReactionBar, type ReactionBarItem, type ReactionBarProps } from "./ReactionBar";
+export type { ReferenceChipObjectProps, ReferenceChipPersonProps, ReferenceChipProps, ReferenceChipTimeProps, } from "./ReferenceChip";
+export { REFERENCE_CHIP_MAX_CHARACTERS, ReferenceChip, truncateMiddle } from "./ReferenceChip";
 export type { StepsProps } from "./Steps";
 export { Steps } from "./Steps";
 export type { StructuredDataPreviewMode, StructuredDataPreviewProps, StructuredDataValue } from "./StructuredDataPreview";

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

@@ -11,6 +11,8 @@ export type OpenDialogOptions = {
     /**
      * 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.
+     * 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.
      */
     history?: boolean;
 };
@@ -33,5 +35,18 @@ export type DialogCore = {
     close: (result?: unknown) => void;
     isOpen: () => boolean;
 };
-export declare const createDialogCore: () => DialogCore;
+export declare const createDialogCore: () => {
+    open: <T>(view: DialogRender<T>, options?: OpenDialogOptions) => Promise<T | undefined>;
+    close: (result?: unknown) => void;
+    isOpen: () => boolean;
+    holdHistory: (onBack: () => void) => (() => void);
+    historySettled: () => Promise<void>;
+};
 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.
+ */
+export declare const holdDialogHistory: (onBack: () => void) => (() => void);
+/** Internal: waits until entries released through `holdDialogHistory` have left the history. */
+export declare const dialogHistorySettled: () => Promise<void>;

package/dist/types/index.d.ts

@@ -2,6 +2,7 @@ export * from "./actions";
 export * from "./chat";
 export * from "./content";
 export * from "./feedback";
+export { installInputModeController } from "./input-mode";
 export * from "./inputs";
 export { suppressTextSelection } from "./internal/text-selection";
 export * from "./intl";

package/dist/types/input-mode.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Records `data-k2b-input="touch" | "trackpad"` and the sticky
+ * `data-k2b-kbd="on"` on `<html>` of root after qualifying input events.
+ * Returns a function that removes listeners but keeps the attributes.
+ * No-op on the server; installing does not change the initial HTML.
+ */
+export declare const installInputModeController: (root?: Document | undefined) => (() => void);

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

@@ -9,9 +9,10 @@ export type FileDropTargetProps = FileDropOptions & {
     for?: Element;
 };
 /**
- * Turns an area into a drop target while files from outside the page are dragged over the window. A calm overlay
- * covers the area without moving anything and says what dropping does; a more specific target inside it, such as a
- * folder row or a `FileDropzone`, takes the drop and its sentence while the pointer is over it. Text, links, and
+ * Turns an area into a drop target while files from outside the page are dragged over the window. A calm tint covers
+ * the area without moving anything, and while the pointer is over it a chip at its bottom says what dropping does; a
+ * more specific target inside it, such as a folder row or a `FileDropzone`, takes the drop and its sentence while the
+ * pointer is over it. Text, links, and
  * elements dragged within the page never show it. Keep a visible upload button for keyboard and touch users.
  */
 export declare function FileDropTarget(props: FileDropTargetProps): JSX.Element;
@@ -21,3 +22,5 @@ export declare function FileDropTarget(props: FileDropTargetProps): JSX.Element;
  * sentence. Calling the ref again with new options replaces them.
  */
 export declare function fileDropTarget(options: FileDropOptions): (element: Element) => void;
+/** @internal A specific target that shows its drop sentence itself, as `FileDropzone` does; the area's chip then stays hidden. */
+export declare function labelledFileDropTarget(options: FileDropOptions): (element: Element) => void;

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

@@ -25,6 +25,8 @@ export type SelectChipProps<T extends string | number = string> = ValueFieldProp
      *  its size, cannot be opened, is marked busy, and shows a spinner where its
      *  chevron (or, icon-only, its icon) is. */
     loading?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
 };
 export declare function SelectChip<T extends string | number = string>(props: SelectChipProps<T>): JSX.Element;
 export default SelectChip;

package/dist/types/inputs/file-drop.d.ts

@@ -37,6 +37,8 @@ export type FileDropTargetEntry = {
     region?: () => Element | undefined;
     /** Set for regions: where the target itself is rendered; a region whose host is hidden takes no drops. */
     host?: () => Element | undefined;
+    /** Set for specific targets that show the drop sentence themselves, so the area's overlay does not repeat it. */
+    labelled?: boolean;
 };
 export type FileDropHover = {
     entry: FileDropTargetEntry;

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

@@ -123,9 +123,11 @@ export type AppWorkspaceSidebarProps = {
     /**
      * Below 48rem (768 px) the sidebar is hidden and the host's mobile
      * navigation takes over; from 48 to 64rem it is an overlay that a button in
-     * the workspace's head opens. `"stacked"` keeps it as a block above the
-     * content below 64rem instead, for overviews whose sidebar is the primary
-     * object list.
+     * the workspace's head opens. `"stacked"` is for overviews whose sidebar is
+     * the primary object list: below 64rem its items become one row of chips
+     * above the content, and "All" at the end of the row opens the complete
+     * sidebar in a sheet (a centered dialog from 48rem). From 64rem it is the
+     * regular sidebar column; the element is a `nav` landmark either way.
      */
     mobile?: "hidden" | "stacked";
     resizable?: boolean;

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

@@ -43,6 +43,9 @@ type DetailPanelSectionBaseProps = {
     icon?: string;
     tone?: DetailPanelTone;
     description?: JSX.Element;
+    /** How many things the section lists, as a chip after the title; `0` reads "None yet". */
+    count?: number;
+    /** Short state after the title, such as "2 of 4 done". */
     meta?: JSX.Element;
     class?: string;
 };
@@ -61,6 +64,10 @@ type DetailPanelActionBaseProps = {
     leading?: JSX.Element;
     trailing?: JSX.Element;
     secondaryAction?: DetailPanelActionSecondary;
+    /** Marks the row of the current place, such as the section in view, in the panel's accent. */
+    current?: boolean;
+    /** Lets the title wrap to two lines instead of ending with an ellipsis. */
+    wrap?: boolean;
     class?: string;
 };
 type DetailPanelActionMenuProps = {
@@ -102,5 +109,9 @@ type DetailPanelComponent = ((props: DetailPanelProps) => JSX.Element) & {
     Section: (props: DetailPanelSectionProps) => JSX.Element;
     Action: (props: DetailPanelActionProps) => JSX.Element;
 };
+/** A count chip, or "None yet" for zero; shared by sections and discussions. */
+export declare const DetailPanelCount: (props: {
+    count: number;
+}) => JSX.Element;
 declare const DetailPanel: DetailPanelComponent;
 export default DetailPanel;

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

@@ -30,6 +30,14 @@ export type DiscussionListProps = {
     loadingMore?: boolean;
     loadMoreLabel?: string;
     onLoadMore?: () => boolean | void | Promise<boolean | void>;
+    /**
+     * Shows only the newest `fold` entries and a "Show n older" toggle above them. Expanded, the toggle reads "Show less"
+     * and earlier pages load as usual. Omit it to show every loaded entry.
+     */
+    fold?: number;
+    /** Controls the fold, for example to reveal an older entry; `onExpandedChange` requests a change. */
+    expanded?: boolean;
+    onExpandedChange?: (expanded: boolean) => void;
     class?: string;
 };
 export type DiscussionItemProps = Omit<JSX.LiHTMLAttributes<HTMLLIElement>, "children" | "class"> & {

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

@@ -0,0 +1,9 @@
+import { type ResizeSeparatorOptions } from "./resize-separator";
+export type ResizeSeparatorProps = Omit<ResizeSeparatorOptions, "value"> & {
+    label: string;
+    orientation: "vertical" | "horizontal";
+    value: number;
+    controls?: string;
+    class?: string;
+};
+export default function ResizeSeparator(props: ResizeSeparatorProps): import("solid-js").JSX.Element;

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

@@ -15,6 +15,13 @@ export type TabBarProps = {
     label: string;
     /** Up to five destinations; further items are not rendered. Put the rest behind a "More" destination. */
     items: readonly TabBarItem[];
+    /**
+     * `bar` (the default) is flat on the page canvas and pads the bottom safe area. `floating` is a rounded bar that the
+     * host places above the content, away from the safe areas; its open item is a raised chip. The host may paint it
+     * with `--k2b-tab-bar-background`, color its items with `--k2b-tab-bar-color`, and color the open item with
+     * `--k2b-tab-bar-selected-background` and `--k2b-tab-bar-selected-color`.
+     */
+    variant?: "bar" | "floating";
     class?: string;
 };
 /**

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

@@ -10,6 +10,8 @@ export type TableOfContentsProps = {
     title?: string;
     /** Element whose scrolling decides the active section. Defaults to the window. */
     scrollRoot?: MaybeAccessor<HTMLElement | undefined>;
+    /** Element that contains the section headings. Defaults to the document. */
+    contentRoot?: MaybeAccessor<HTMLElement | undefined>;
     /** Stay in view inside the caller's layout. */
     sticky?: boolean;
     /** Called when another section becomes active. */

package/dist/types/layout/app-workspace-controller.d.ts

@@ -4,6 +4,8 @@ export type AppWorkspaceControllerOptions = {
     readState?: () => AppWorkspaceLayoutState | null | undefined;
     writeState?: (state: AppWorkspaceLayoutState) => void;
 };
+/** Parks open waiting-detail drawers; focus follows only when it was inside one. */
+export declare const parkWorkspaceDetailDrawers: (root?: ParentNode) => void;
 /**
  * Asks the owning `AppWorkspace.Sidebar` to hide. The sidebar's `hidden` prop
  * stays application state, so the controller only requests the change.

package/dist/types/layout/detail-panel-messages.d.ts

@@ -0,0 +1,15 @@
+/** Counts and list folding shared by detail panel sections and discussions. */
+declare const detailPanelMessages: import("@k2b/stdlib").Catalog<{
+    noneYet: string;
+    showOlder: ({ count }: {
+        count: number;
+    }) => string;
+    showMore: ({ count }: {
+        count: number;
+    }) => string;
+    showLess: string;
+}>;
+export type DetailPanelMessages = ReturnType<(typeof detailPanelMessages)["resolve"]>["t"];
+export declare const useDetailPanelMessages: () => (() => DetailPanelMessages);
+export declare const checkDetailPanelMessages: () => import("@k2b/stdlib").CatalogIssue[];
+export {};

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

@@ -3,7 +3,7 @@ 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 { default as AppWorkspace } from "./AppWorkspace";
 export type { AppWorkspaceControllerOptions } from "./app-workspace-controller";
-export { installAppWorkspaceController } from "./app-workspace-controller";
+export { installAppWorkspaceController, parkWorkspaceDetailDrawers } from "./app-workspace-controller";
 export type { AppWorkspaceLayoutState, AppWorkspaceResizeKind, } from "./app-workspace-state";
 export { APP_WORKSPACE_DETAIL_DEFAULT, APP_WORKSPACE_DETAIL_MAX, APP_WORKSPACE_DETAIL_MIN, APP_WORKSPACE_DRAWER_DEFAULT, APP_WORKSPACE_DRAWER_MAX, APP_WORKSPACE_DRAWER_MIN, APP_WORKSPACE_MAIN_MIN, APP_WORKSPACE_MAIN_MIN_HEIGHT, APP_WORKSPACE_PANE_DEFAULT, APP_WORKSPACE_PANE_MAX, APP_WORKSPACE_PANE_MIN, APP_WORKSPACE_SIDEBAR_COLLAPSE_THRESHOLD, APP_WORKSPACE_SIDEBAR_COLLAPSED, APP_WORKSPACE_SIDEBAR_DEFAULT, APP_WORKSPACE_SIDEBAR_MAX, APP_WORKSPACE_SIDEBAR_MIN, appWorkspaceLayoutStyle, appWorkspacePanelVariable, appWorkspaceResizeLimits, normalizeAppWorkspaceLayoutState, parseAppWorkspaceLayoutState, resolveAppWorkspaceSidebarWidth, safeAppWorkspacePanelId, serializeAppWorkspaceLayoutState, shouldCollapseAppWorkspaceSidebar, } from "./app-workspace-state";
 export { type BottomSheetProps, bottomSheetAdaptiveOptions, bottomSheetOptions, default as BottomSheet } from "./BottomSheet";
@@ -32,6 +32,8 @@ export { default as PullToRefresh } from "./PullToRefresh";
 export { installPageTitleController } from "./page-title-controller";
 export type { AddPanesItemOptions, PanesDirection, PanesGroup, PanesIntent, PanesLayout, PanesNode, PanesPath, PanesPathSegment, PanesSide, PanesSplit, } from "./panes-layout";
 export { activatePanesItem, addPanesItem, applyPanesIntent, createPanesLayout, isPanesItemVisible, PANES_LAYOUT_VERSION, parsePanesLayout, reconcilePanesLayout, removePanesItem, resizePanesSplit, } from "./panes-layout";
+export { default as ResizeSeparator, type ResizeSeparatorProps } from "./ResizeSeparator";
+export { attachResizeSeparator, type ResizeSeparatorOptions } from "./resize-separator";
 export type { ScrollAreaProps } from "./ScrollArea";
 export { default as ScrollArea } from "./ScrollArea";
 export type { SettingsFieldControlProps, SettingsFieldProps, SettingsGroupActionProps, SettingsGroupProps, SettingsPageProps, SettingsPanelFooterProps, SettingsSaveBarProps, SettingsSectionProps, } from "./Settings";