@k2b/ui 0.1.1 → 0.3.0

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

@@ -4,6 +4,8 @@ import { type TooltipPlacement } from "../feedback/Tooltip";
 export type ButtonVariant = "primary" | "secondary" | "ghost" | "text" | "subtle" | "input" | "warning" | "danger" | "success" | "ai";
 export type ButtonSize = "xs" | "sm" | "md" | "lg";
 export type ButtonProps = JSX.ButtonHTMLAttributes<HTMLButtonElement> & {
+    /** Allow a deliberately long or rich label to wrap. Defaults to false. */
+    wrap?: boolean;
     loading?: boolean;
     loadingLabel?: string;
     size?: ButtonSize;
@@ -13,6 +15,8 @@ export type ButtonProps = JSX.ButtonHTMLAttributes<HTMLButtonElement> & {
     tooltipPlacement?: TooltipPlacement;
 };
 export type ButtonLinkProps = Omit<JSX.AnchorHTMLAttributes<HTMLAnchorElement>, "onClick"> & {
+    /** Allow a deliberately long or rich label to wrap. Defaults to false. */
+    wrap?: boolean;
     navigation?: "document" | "enhanced";
     onClick?: JSX.EventHandlerUnion<HTMLAnchorElement, MouseEvent>;
     onNavigate?: (event: LinkNavigateEvent) => void | Promise<void>;

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

@@ -2,6 +2,7 @@ import { type JSX } from "solid-js";
 import type { MaybeAccessor } from "../inputs/field-contract";
 export type DisclosureProps = {
     summary: JSX.Element;
+    surface?: "paper" | "plain";
     children: JSX.Element;
     value?: MaybeAccessor<boolean>;
     defaultValue?: boolean;

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

@@ -42,7 +42,9 @@ export type DropdownProps = {
     items: readonly DropdownItem[];
     children: JSX.Element;
     position?: DropdownPosition | (() => DropdownPosition);
-    /** Menu width as a CSS length. Defaults to `12rem`. */
+    /** Larger menu rows and typography for touch. Defaults to `default`. */
+    variant?: "default" | "touch";
+    /** Menu width as a CSS length. Defaults to `12rem`, or `18rem` for touch. */
     width?: string;
     class?: string;
     menuClass?: string;

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

@@ -1,4 +1,5 @@
 import { type JSX } from "solid-js";
+import type { ButtonVariant } from "./Button";
 export type FilterChipOption = {
     value: string;
     label: string;
@@ -20,6 +21,9 @@ export type FilterChipProps = {
     position?: "bottom-left" | "bottom-right";
     defaultValue?: readonly string[];
     iconOnly?: boolean;
+    /** Use a standard button appearance instead of the default filter field. */
+    variant?: ButtonVariant;
+    disabled?: boolean;
     class?: string;
 };
 /** Section-aware controlled filter with immediate single- and multi-select commits. */

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

@@ -4,6 +4,12 @@ import { type DropdownItem, type DropdownPosition } from "./Dropdown";
 export type SplitButtonProps = ButtonProps & {
     /** Actions shown from the secondary menu trigger. */
     items: readonly DropdownItem[];
+    /** Optional selection menu in place of the primary immediate action. */
+    primaryItems?: readonly DropdownItem[];
+    /** Accessible name for the primary selection menu. */
+    primaryMenuLabel?: string;
+    /** Secondary menu glyph; defaults to a chevron. */
+    menuIcon?: JSX.Element;
     /** Accessible name and title for the icon-only menu trigger. */
     menuLabel: string;
     menuPosition?: DropdownPosition | (() => DropdownPosition);

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

@@ -1,8 +1,5 @@
 import type { JSX } from "solid-js";
 import type { PromptSearchInput, PromptSearchItem, PromptSearchOptions } from "../feedback/prompts";
-export declare const SPOTLIGHT_SHORTCUT = "mod+shift+k";
-export declare const SPOTLIGHT_SHORTCUT_LABEL = "\u21E7\u2318K";
-export declare const SPOTLIGHT_SHORTCUT_TITLE = "Mod+Shift+K";
 export type SpotlightSearchResolver<T = unknown> = (input: PromptSearchInput) => Promise<PromptSearchItem<T>[]> | PromptSearchItem<T>[];
 export type SpotlightSearchOptions<T = unknown> = PromptSearchOptions & {
     resolve: SpotlightSearchResolver<T>;
@@ -19,7 +16,6 @@ export type SpotlightButtonProps = {
     class?: string;
     onClick: () => void | Promise<void>;
 };
-export declare const isSpotlightShortcut: (event: KeyboardEvent) => boolean;
 export declare const openSpotlightSearch: <T = unknown>(options: SpotlightSearchOptions<T>) => Promise<PromptSearchItem<T> | undefined>;
 export declare function SpotlightButton(props: SpotlightButtonProps): JSX.Element;
 export default SpotlightButton;

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

@@ -6,6 +6,8 @@ export type TabOption<T extends string = string> = {
     icon?: string;
     disabled?: boolean;
     panel?: JSX.Element;
+    onClose?: () => void;
+    closeLabel?: string;
 };
 export type TabsItemProps<T extends string = string> = Omit<TabOption<T>, "panel"> & {
     children?: JSX.Element;
@@ -16,6 +18,8 @@ export type TabsProps<T extends string = string> = {
     ariaLabel: string;
     orientation?: "horizontal" | "vertical";
     class?: string;
+    variant?: "line" | "pill";
+    trailing?: JSX.Element;
     /** Data-driven alternative to colocated `Tabs.Item` children. */
     options?: readonly TabOption<T>[];
     children?: JSX.Element;

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

@@ -13,7 +13,7 @@ export { ContextMenu } from "./ContextMenu";
 export type { RemoveButtonProps } from "./RemoveButton";
 export { RemoveButton } from "./RemoveButton";
 export type { SpotlightButtonProps, SpotlightButtonVariant, SpotlightSearchOptions, SpotlightSearchResolver, } from "./SpotlightSearch";
-export { isSpotlightShortcut, openSpotlightSearch, SPOTLIGHT_SHORTCUT, SPOTLIGHT_SHORTCUT_LABEL, SPOTLIGHT_SHORTCUT_TITLE, SpotlightButton, } from "./SpotlightSearch";
+export { openSpotlightSearch, SpotlightButton, } from "./SpotlightSearch";
 export type { SegmentedControlProps, SegmentOption } from "./SegmentedControl";
 export { SegmentedControl } from "./SegmentedControl";
 export type { SplitButtonProps } from "./SplitButton";

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

@@ -1,5 +1,5 @@
 import { type JSX } from "solid-js";
-import type { ChatAction, ChatAttachment, ChatComposerState, ChatContextUsageData, ChatModelOption, ChatSubmitInput } from "./types";
+import type { ChatAction, ChatAttachment, ChatMention, ChatComposerState, ChatContextUsageData, ChatModelOption, ChatSubmitInput } from "./types";
 export type ChatCommandContext = {
     setValue: (value: string) => void;
     submit: () => void;
@@ -9,7 +9,11 @@ export type ChatCommand = {
     name: string;
     description: string;
     icon?: string;
-    action: (context: ChatCommandContext) => void | Promise<void>;
+    action?: (context: ChatCommandContext) => void | Promise<void>;
+    /** Selecting a reference inserts its display name and retains its opaque payload. */
+    mention?: ChatAttachment;
+    label?: string;
+    disabled?: boolean;
 };
 export type ChatFileSelection = {
     onSelect: (files: readonly File[]) => void | Promise<void>;
@@ -41,17 +45,31 @@ export type ChatComposerProps = {
     models?: readonly ChatModelOption[];
     selectedModelId?: string | null;
     onModelChange?: (modelId: string) => void;
+    /** Compact application-owned details immediately after the model selector. */
+    modelDetails?: JSX.Element;
     commands?: readonly ChatCommand[];
+    searchCommands?: (query: string, signal: AbortSignal) => Promise<readonly ChatCommand[]>;
+    mentions?: readonly ChatMention[];
+    onMentionsChange?: (mentions: readonly ChatMention[]) => void;
+    /** Shared surface above the editor; suggestions temporarily replace this content. */
+    accessory?: JSX.Element;
     contextUsage?: ChatContextUsageData;
     contextActions?: readonly ChatAction[];
+    /** Optional action inside the context details popup. */
+    contextPopupAction?: ChatAction;
     /** Additional compact controls rendered with the add/model controls. */
     footerTools?: JSX.Element;
+    /** Compact application controls immediately before the send/stop button. */
+    submitTools?: JSX.Element;
+    /** Replaces footer controls during an application-owned interaction, preserving the editor. */
+    footerContent?: JSX.Element;
     placeholder?: string;
     label?: string;
     inputLabel?: string;
     disabled?: boolean;
     error?: string;
     focusToken?: unknown;
+    draftKey?: unknown;
     class?: string;
 };
 export declare function ChatComposer(props: ChatComposerProps): JSX.Element;

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

@@ -0,0 +1,6 @@
+import { type JSX } from "solid-js";
+export type ChatContextPopupProps = Omit<JSX.ButtonHTMLAttributes<HTMLButtonElement>, "content" | "ref" | "onClick" | "onPointerEnter" | "onPointerLeave"> & {
+    content: JSX.Element;
+};
+/** Context details support hover preview and deliberate click-to-pin without changing tooltip behavior. */
+export declare function ChatContextPopup(props: ChatContextPopupProps): JSX.Element;

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

@@ -35,9 +35,13 @@ export type ChatActivityProps = {
     bodyInset?: boolean;
     anchorId?: string | number;
     children?: JSX.Element;
+    /** Mount expensive details only while expanded. */
+    renderBody?: () => JSX.Element;
     class?: string;
 };
 export type ChatContextUsageProps = ChatContextUsageData & {
+    action?: ChatAction;
+    onActionError?: (error: unknown) => void;
     /** Host-owned number formatting. The default is locale-independent and SSR-stable. */
     formatNumber?: (value: number) => string;
     class?: string;

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

@@ -0,0 +1,15 @@
+export type ChatTask = {
+    id: string;
+    content: string;
+    status: "pending" | "in_progress" | "completed" | "cancelled";
+};
+export type ChatTasksProps = {
+    items: readonly ChatTask[];
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    label: string;
+    progressLabel: string;
+    statusLabels: Record<ChatTask["status"], string>;
+};
+/** Presentation only. The host owns the plan and execution state. */
+export declare function ChatTasks(props: ChatTasksProps): import("solid-js").JSX.Element;

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

@@ -33,6 +33,7 @@ export type ChatActivityItem = {
 };
 export type ChatTimelineItem = ChatMessageItem | ChatActivityItem;
 export type ChatTimelineProps = {
+    scrollFade?: boolean;
     items: readonly ChatTimelineItem[];
     conversationKey?: string | null;
     loading?: boolean;
@@ -45,6 +46,7 @@ export type ChatTimelineProps = {
     onActionError?: (error: unknown) => void;
     viewportRef?: (element: HTMLDivElement) => void;
     contentRef?: (element: HTMLDivElement) => void;
+    scrollToAnchorRef?: (scrollToAnchor: (anchorId: string | number) => boolean) => void;
     label?: string;
     followThreshold?: number;
     class?: string;

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

@@ -1,7 +1,4 @@
 import type { ChatAction } from "./types";
-export declare const filterChatCommands: <T extends {
-    name: string;
-}>(value: string, commands: readonly T[]) => T[];
 export declare const nextChatCommandIndex: (index: number, length: number, direction: 1 | -1) => number;
 export declare const isChatNearBottom: (scrollHeight: number, scrollTop: number, clientHeight: number, threshold?: number) => boolean;
 export declare const restoredChatScrollTop: (previousScrollTop: number, previousScrollHeight: number, nextScrollHeight: number) => number;

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

@@ -0,0 +1,14 @@
+import type { ChatMention } from "./types";
+export type ChatCommandQuery = {
+    start: number;
+    end: number;
+    query: string;
+};
+/** 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;
+/** 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[]): {
+    text: string;
+    mention?: ChatMention;
+}[];

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

@@ -1,3 +1,7 @@
+export type { ChatContextPopupProps } from "./ChatContextPopup";
+import { ChatContextPopup } from "./ChatContextPopup";
+import { ChatTasks } from "./ChatTasks";
+export type { ChatTask, ChatTasksProps } from "./ChatTasks";
 import { ChatComposer } from "./ChatComposer";
 import { ChatActivity, ChatContextUsage, ChatMessage } from "./ChatPrimitives";
 import { ChatRoot } from "./ChatRoot";
@@ -7,15 +11,18 @@ export type { ChatActivityProps, ChatContextUsageProps, ChatMessageProps } from
 export { formatChatTokens } from "./ChatPrimitives";
 export type { ChatRootProps } from "./ChatRoot";
 export type { ChatActivityItem, ChatMessageItem, ChatTimelineItem, ChatTimelineProps } from "./ChatTimeline";
-export type { ChatAction, ChatActivityTone, ChatAttachment, ChatComposerState, ChatContextUsageData, ChatMessageStatus, ChatModelOption, ChatRole, ChatSubmitInput, ChatSubmitIntent, ChatUsage, } from "./types";
+export type { ChatAction, ChatActivityTone, ChatAttachment, ChatMention, ChatComposerState, ChatContextUsageData, ChatMessageStatus, ChatModelOption, ChatRole, ChatSubmitInput, ChatSubmitIntent, ChatUsage, } from "./types";
 /**
  * Portable, controlled chat surface. Applications own storage, streaming,
  * authorization, rich message rendering, and domain actions.
  */
 export declare const Chat: typeof ChatRoot & {
+    Tasks: typeof ChatTasks;
     Timeline: typeof ChatTimeline;
     Message: typeof ChatMessage;
     Activity: typeof ChatActivity;
     Composer: typeof ChatComposer;
     ContextUsage: typeof ChatContextUsage;
+    ContextPopup: typeof ChatContextPopup;
 };
+export { reconcileChatMentions } from "./composer-document";

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

@@ -9,6 +9,8 @@ type ChatActionBase = {
     disabled?: boolean;
     /** Toggle state for persistent message actions such as feedback. */
     pressed?: boolean;
+    /** Semantic foreground for selected feedback actions, without a persistent background. */
+    pressedTone?: "success" | "danger";
 };
 /** Exactly one executable behavior for every chat action. */
 export type ChatAction = ChatActionBase & ({
@@ -58,5 +60,12 @@ export type ChatSubmitInput = {
     intent: ChatSubmitIntent;
     text: string;
     attachments: readonly ChatAttachment[];
+    mentions?: readonly ChatMention[];
+};
+/** Ranges use UTF-16 offsets into the untrimmed composer text. Payloads stay application-owned. */
+export type ChatMention = {
+    start: number;
+    end: number;
+    attachment: ChatAttachment;
 };
 export {};

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

@@ -1,6 +1,9 @@
+import type { ChartCursor } from "./chart-cursor";
+import type { MapViewport } from "@k2b/stdlib";
 import { charts } from "@k2b/stdlib";
 import type { JSX } from "solid-js";
-import { type StateTimelineChartOptions } from "./chart-state-timeline";
+import { type ChartSelection, type ChartTooltipFormatter, type ChartDatumRef } from "./chart-inspection";
+import { type StateTimelineChartOptions, type StateTimelineDomain } from "./chart-state-timeline";
 /**
  * Chart — minimal Solid wrapper around `stdlib.charts`.
  *
@@ -11,31 +14,20 @@ import { type StateTimelineChartOptions } from "./chart-state-timeline";
  * is a full SVG re-build, not a diff — fine for dashboard cadences
  * (poll, websocket, store updates). Don't use this for 60fps streaming.
  *
- * **Sizing.** stdlib emits `<svg viewBox="0 0 W H">` with no width/
- * height attributes, so the SVG would otherwise fall back to the
- * browser's replaced-element default (300×150) and either overflow
- * or look squished. We measure the wrapping `<div>` with a
- * ResizeObserver and pass the actual pixel dimensions to stdlib —
- * the viewBox matches the container, no aspect distortion, no
- * letterboxing. Sizing the wrapper itself is the caller's job
- * (`style={{ height: "14rem" }}`, an app class, a flex child, …).
- * On SSR (no observer)
- * the chart renders at stdlib's default size; the first client-side
- * frame re-measures and re-renders.
- *
- * One documented exception: `kind: "stateTimeline"` derives its own
- * initial height from the row count and legend via
- * `stateTimelineHeight()`, because a timeline's height is a function of
- * how many rows it has rather than of the layout around it. Every other
- * kind starts at 280px until the observer reports the real box. Layout
- * code that sizes charts uniformly must account for this.
+ * **Sizing.** The server and browser render the same logical viewBox. CSS
+ * fits Cartesian plots to the container and preserves text/marker sizes;
+ * maps fit the whole world and zoom uniformly across the full plot; pies, donuts and gauges retain
+ * their aspect ratio. No measurement
+ * or hydration redraw is needed. The caller sizes the wrapper, for example
+ * `style={{ height: "14rem" }}`. State timelines derive their default height
+ * from the row count and legend via `stateTimelineHeight()`.
  *
  * **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
- * nearest-point hover and keyboard inspection for line charts.
+ * renderer-owned inspection, tooltips and optional selection for all chart kinds.
  * If stdlib gains a new option, it's automatically available at every
  * callsite.
  *
@@ -64,6 +56,7 @@ export type ChartLabels = Partial<{
     interactiveMap: string;
     interactiveTimeline: string;
     interactiveLine: string;
+    interactiveChart: string;
     zoomIn: string;
     zoomOut: string;
     resetMap: string;
@@ -72,7 +65,7 @@ export type ChartLabels = Partial<{
 /**
  * Per-kind props: `kind` discriminator + the exact options that
  * `charts.<kind>` accepts, **minus** `width` / `height` (the wrapper
- * owns those — they're derived from container measurement). Solid's
+ * owns those — CSS fits a stable coordinate space to the box). Solid's
  * component model handles discriminated unions natively, so callsites
  * get full type safety.
  */
@@ -82,9 +75,35 @@ export type ChartProps = {
         class?: string;
         style?: JSX.CSSProperties | string;
         labels?: ChartLabels;
-    } & (K extends "stateTimeline" ? StateTimelineChartOptions : Omit<Parameters<(typeof charts)[K]>[0], "width" | "height"> & (K extends "map" | "line" ? {
         interactive?: boolean;
-    } : {}));
+        onSelect?: (selection: ChartSelection) => void;
+        /** Controlled highlight; indices belong to this exact input snapshot. */
+        selected?: ChartDatumRef | null;
+        tooltip?: ChartTooltipFormatter;
+        /** Optional shared X cursor for line charts. */
+        cursor?: ChartCursor;
+    } & (K extends "map" ? {
+        /** Target when zooming in from the world view. Defaults to Europe (50, 10). */
+        zoomFocus?: Pick<MapViewport, "latitude" | "longitude">;
+    } : {}) & (K extends "line" ? {
+        maxGap?: number;
+    } : {}) & (K extends "stateTimeline" ? StateTimelineChartOptions : Omit<Parameters<(typeof charts)[K]>[0], "width" | "height" | "inspect">);
+}[ChartKind];
+/** Pure renderer options: component layout, events and inspection are configured elsewhere. */
+export type ChartRenderOptions = {
+    [K in ChartKind]: Omit<Extract<ChartProps, {
+        kind: K;
+    }>, "class" | "style" | "labels" | "interactive" | "onSelect" | "selected" | "tooltip" | "cursor">;
 }[ChartKind];
+/** Keep the fixed 28-unit bar-gauge rows inside the shared SSR/browser coordinate space. */
+export declare const chartRenderHeight: (props: ChartRenderOptions) => number;
+/**
+ * Internal — strips wrapper-only keys from props and forwards the
+ * rest (plus logical size) to `charts[kind]`. The `any` is the
+ * price for dispatching one function call across 14 different option
+ * types; an explicit per-kind switch would type it but balloon the
+ * component for no runtime benefit.
+ */
+export declare const renderChartSvg: (props: ChartProps, width: number, height: number, mapViewport?: MapViewport, timelineViewport?: StateTimelineDomain) => string;
 declare const Chart: (props: ChartProps) => JSX.Element;
 export default Chart;

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

@@ -0,0 +1,34 @@
+import type { ChartCursor } from "./chart-cursor";
+import { type JSX } from "solid-js";
+import { type DataTableSort } from "./DataTable";
+import { type ChartExplorerData, type ChartExplorerRow } from "./chart-explorer";
+export type ChartExplorerColumn<T> = {
+    id: string;
+    label: string;
+    value: (row: T) => string;
+    /** Optional table cell presentation; value remains the plain text used for copy/details. */
+    render?: (row: T) => JSX.Element;
+    /** Explicit comparable value. Omit to leave the column unsortable. */
+    sortValue?: (row: T) => string | number | null;
+    align?: "left" | "center" | "right";
+};
+export type ChartExplorerProps<T extends ChartExplorerRow> = {
+    cursor?: ChartCursor;
+    title: string;
+    description?: JSX.Element;
+    data: ChartExplorerData<T>;
+    columns: readonly ChartExplorerColumn<T>[];
+    view?: "chart" | "table";
+    defaultView?: "chart" | "table";
+    onViewChange?: (view: "chart" | "table") => void;
+    sort?: DataTableSort | null;
+    defaultSort?: DataTableSort | null;
+    onSortChange?: (sort: DataTableSort | null) => void;
+    selectedKey?: string | null;
+    onSelectedKeyChange?: (key: string | null) => void;
+    /** false hides the complete local detail area for a shared selection panel. */
+    renderDetails?: false | ((row: T) => JSX.Element);
+    height?: string;
+    class?: string;
+};
+export declare function ChartExplorer<T extends ChartExplorerRow>(props: ChartExplorerProps<T>): JSX.Element;

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

@@ -0,0 +1,10 @@
+import { type ChartFilterControlsProps } from "./ChartFilterControls";
+import type { ChartExplorerController, ChartExplorerCharts } from "./chart-explorer";
+export type ChartExplorerControlsProps<C extends ChartExplorerCharts> = {
+    explorer: ChartExplorerController<C>;
+    title: string;
+    steps?: ChartFilterControlsProps["steps"];
+    series?: ChartFilterControlsProps["series"];
+    dimensionLabel?: string;
+};
+export declare function ChartExplorerControls<C extends ChartExplorerCharts>(props: ChartExplorerControlsProps<C>): import("solid-js").JSX.Element;

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

@@ -0,0 +1,21 @@
+import type { ChartExplorerRequest } from "./chart-explorer";
+export type ChartFilterControlsProps = {
+    request: ChartExplorerRequest;
+    displayedRequest: ChartExplorerRequest;
+    steps?: readonly {
+        key: string;
+        label: string;
+    }[];
+    series?: readonly {
+        key: string;
+        label: string;
+        color: string;
+    }[];
+    dimensionLabel?: string;
+    disabled?: boolean;
+    failed?: boolean;
+    onRequest: (request: ChartExplorerRequest) => void;
+    onRetry?: () => void;
+};
+/** Shared controls for a standalone explorer or an atomic group of charts. */
+export declare function ChartFilterControls(props: ChartFilterControlsProps): import("solid-js").JSX.Element;

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

@@ -0,0 +1,11 @@
+import type { ChartCursor } from "./chart-cursor";
+import { type JSX } from "solid-js";
+import type { ChartSnapshot } from "./chart-snapshot";
+/** Internal display for server-prepared geometry. Viewports are snapshot-owned. */
+export declare function ChartSnapshotView(props: {
+    snapshot: ChartSnapshot;
+    cursor?: ChartCursor;
+    selectedKey: string | null;
+    onSelect: (key: string) => void;
+    style?: JSX.CSSProperties;
+}): JSX.Element;

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

@@ -1,4 +1,5 @@
 import { type JSX } from "solid-js";
+import type { CollectionSelection } from "./collection-selection";
 export type DataTableColumn<T> = {
     id: string;
     header: JSX.Element | ((ctx: {
@@ -58,10 +59,13 @@ export type DataTableProps<T> = {
      */
     sortHref?: (next: DataTableSort) => string;
     selectedRowId?: string | null;
+    /** Optional multi-selection shared with another collection view. Requires getRowId. */
+    selection?: CollectionSelection;
     rowClass?: string | ((row: T) => string | undefined);
     hoverRows?: boolean;
     onRowClick?: (row: T) => void;
     onRowDoubleClick?: (row: T) => void;
+    onRowContextMenu?: (row: T) => void;
     renderCell?: DataTableRenderCell<T>;
     renderHeader?: DataTableRenderHeader<T>;
     footer?: DataTableFooter<T>;

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

@@ -1,6 +1,7 @@
 import { type FileTreeEntry } from "./FileTree";
 import { type FileViewContent, type FileViewRenderer } from "./FileView";
 export type FileSource = {
+    previewPreferencesKey?: string;
     list(): Promise<FileTreeEntry[]>;
     read(path: string): Promise<FileViewContent>;
     write?(path: string, content: string, encoding?: "utf8" | "base64"): Promise<void>;

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

@@ -0,0 +1,21 @@
+import { type JSX } from "solid-js";
+import type { CollectionSelection } from "./collection-selection";
+export type FileGridProps<T> = {
+    rows: readonly T[];
+    getRowId: (row: T) => string;
+    selection: CollectionSelection;
+    label: string;
+    size?: "sm" | "md" | "lg";
+    renderPreview: (row: T) => JSX.Element;
+    renderLabel: (row: T) => JSX.Element;
+    renderMeta?: (row: T) => JSX.Element;
+    renderActions?: (row: T) => JSX.Element;
+    onRowClick?: (row: T) => void;
+    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;
+};
+/** File presentation only; the host owns data, menus, leases and permissions. */
+export declare function FileGrid<T>(props: FileGridProps<T>): JSX.Element;

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

@@ -17,6 +17,14 @@ export type FileViewContent = {
     mediaType: string;
 };
 export type FileViewProps = {
+    /** Plain previews inherit the surrounding surface without a frame or inset padding. */
+    variant?: "default" | "plain";
+    /** Read-only excerpt limit; omitted renders the complete preview. */
+    previewLines?: number;
+    onExpandPreview?: () => void;
+    headingScale?: "compact" | "normal" | "large";
+    /** Optional browser-local preference scope, owned by the host. */
+    previewPreferencesKey?: string;
     file: FileViewFile;
     load: () => Promise<FileViewContent>;
     /** Refetch the current path when this host-owned revision changes. */
@@ -27,6 +35,10 @@ export type FileViewProps = {
     save?: (content: string) => Promise<void>;
     /** Authenticated inline URL used by browser-native image, PDF, audio, and video previews. */
     previewHref?: string | null;
+    /** CORS mode for native image/audio/video previews. Omit to preserve browser defaults. */
+    crossOrigin?: "anonymous" | "use-credentials";
+    /** Native media failed to load; the host can renew a signed URL and offer retry. */
+    onPreviewError?: () => void;
     downloadHref?: string | null;
     /** App-specific renderers matched before the built-ins for this instance. */
     renderers?: readonly FileViewRenderer[];
@@ -35,9 +47,17 @@ export type FileViewProps = {
     class?: string;
 };
 export type FileViewRendererProps = {
+    /** Read-only excerpt limit; omitted renders the complete preview. */
+    previewLines?: number;
+    onExpandPreview?: () => void;
+    headingScale?: "compact" | "normal" | "large";
+    /** Optional browser-local preference scope, owned by the host. */
+    previewPreferencesKey?: string;
     file: FileViewFile;
     content: FileViewContent;
     previewHref: string | null;
+    crossOrigin?: "anonymous" | "use-credentials";
+    onPreviewError?: () => void;
     downloadHref: string | null;
     /** Null when the file is read-only. */
     editor: {

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

@@ -1,4 +1,4 @@
-type CommonProps = {
+type CommonProps = MarkdownRenderOptions & {
     /** Optional additional CSS classes */
     class?: string;
     /**
@@ -21,6 +21,11 @@ export type MarkdownViewProps = CommonProps & ({
 });
 export type MarkdownRenderOptions = {
     inlineTokens?: readonly string[];
+    /** Whether to render images. False renders alt text without resource requests. Defaults to true. */
+    allowImages?: boolean;
+    /** Optional protocol allowlist, including trailing colons. Relative URLs resolve as HTTPS. */
+    linkProtocols?: readonly string[];
+    linkTarget?: "_blank";
 };
 export declare const renderSafeMarkdown: (markdown: string, options?: MarkdownRenderOptions) => string;
 /**

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

@@ -1,11 +1,18 @@
+import { type JSX } from "solid-js";
 export type PdfPreviewRequest = () => Promise<Response | Blob>;
 export type PdfPreviewProps = {
     request: PdfPreviewRequest;
+    autoLoad?: boolean;
     disabled?: () => boolean;
     title?: string;
     buttonLabel?: string;
     openButtonLabel?: string;
     emptyText?: string;
     class?: string;
+    children?: (parts: {
+        actions: JSX.Element;
+        content: JSX.Element;
+    }) => JSX.Element;
+    renderError?: (message: string) => JSX.Element;
 };
-export default function PdfPreview(props: PdfPreviewProps): import("solid-js").JSX.Element;
+export default function PdfPreview(props: PdfPreviewProps): JSX.Element;

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

@@ -0,0 +1,15 @@
+export type ChartCursorState = {
+    source: symbol;
+    x: number;
+} | null;
+/** Share one numeric X value between line charts. Create one instance per group. */
+export declare function createChartCursor(options?: {
+    formatX?: (x: number) => string;
+}): {
+    formatX: ((x: number) => string) | undefined;
+    read: () => ChartCursorState;
+    subscribe(listener: (state: ChartCursorState) => void): () => void;
+    move(source: symbol, x: number): void;
+    clear(source: symbol): void;
+};
+export type ChartCursor = ReturnType<typeof createChartCursor>;