@k2b/ui 0.35.0 → 0.37.0

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

@@ -27,5 +27,5 @@ export declare function MapFootRow(props: {
     scale?: MapScale;
     children?: JSX.Element;
 }): JSX.Element;
-/** Geometry without a browser, a canvas, or a network dependency; suitable for server rendering and PDF output. */
+/** Geometry fallback without a browser, canvas, or network. Does not contain a geographic basemap image. */
 export declare function MapViewFrame(props: MapViewFrameProps): JSX.Element;

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

@@ -113,7 +113,7 @@ export type MessageRowProps = {
      * the author and time. Defaults to true; `startsMessageGroup` decides it from the previous message.
      */
     groupStart?: boolean;
-    /** Shown next to the name at the start of a group, for example the kind of account. */
+    /** Shown next to the name (or own-message time) at the start of a group, for example the kind of account. */
     badge?: JSX.Element;
     /** Send state. Sets a line of fixed height below the message: a clock, a check, or "Not sent" with "Retry". */
     status?: MessageRowStatus;

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

@@ -45,7 +45,8 @@ export type { MessageEventGroupProps, MessageEventRowProps, MessageGroupEntry, M
 export { MessageEventGroup, MessageEventRow, MessageRow, MessageSystemRow, startsMessageGroup } from "./MessageRow";
 export { type MapPaletteColors, type MapTheme, mapPalette } from "./map-palette";
 export { type MapStyleOptions, mapAttribution, mapStyle } from "./map-style";
-export type { MapViewArea, MapViewFit, MapViewFrameProps, MapViewLine, MapViewLineTone, MapViewMarker, MapViewOwnLocation, MapViewPoint, MapViewProps, MapViewStyle, MapViewStyleSource, MapViewTone, } from "./map-view-types";
+export { MAP_SNAPSHOT_MAX_PIXELS, MapSnapshotError, type MapSnapshotErrorCode } from "./map-view-snapshot";
+export type { MapViewArea, MapViewFit, MapViewFrameProps, MapViewHandle, MapViewLine, MapViewLineTone, MapViewMarker, MapViewOwnLocation, MapViewPoint, MapViewProps, MapViewSnapshot, MapViewSnapshotOptions, MapViewStyle, MapViewStyleSource, MapViewTone, } from "./map-view-types";
 export { MARKDOWN_CALLOUT_CLASSES, MARKDOWN_CALLOUT_ICON_ATTRIBUTES, type MarkdownInfoBlock, type MarkdownInfoBlockRenderInput, type MarkdownInfoBlockType, markdownInfoBlocks, renderMarkdownInfoBlock, scanMarkdownInfoBlock, } from "./markdown-info-blocks";
 export { type MarkdownLinkInput, type MarkdownReference, type MarkdownReferenceKind, type MarkdownReferenceType, markdownLinkReference, markdownReferenceIcon, markdownReferenceType, markdownReferenceTypeLabel, markStandaloneLinks, renderMarkdownLink, } from "./markdown-links";
 export { Pagination, type PaginationProps } from "./Pagination";

package/dist/types/content/map-view-glyphs.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Validate the glyphs MapLibre will decode before it can silently substitute local fonts.
+ * Uses the same PBF reader and 3px bitmap border as MapLibre 6, without allocating glyph images.
+ */
+export declare function validateMapGlyphs(data: ArrayBuffer): void;

package/dist/types/content/map-view-live.d.ts

@@ -1,2 +1,2 @@
 import { Map, type MapOptions } from "maplibre-gl";
-export declare function createMap(options: MapOptions, onResourceError: () => void): Map;
+export declare function createMap(options: MapOptions, resourceFailed: () => void): Map;

package/dist/types/content/map-view-snapshot.d.ts

@@ -0,0 +1,13 @@
+import type { MapViewSnapshot } from "./map-view-types";
+/** Same decoded RGBA budget as Cloud's isolated print-image worker (64 MiB). */
+export declare const MAP_SNAPSHOT_MAX_PIXELS: number;
+export type MapSnapshotErrorCode = "not_ready" | "resource_failed" | "changed" | "disposed" | "busy" | "too_large" | "timed_out" | "aborted" | "capture_failed";
+export declare class MapSnapshotError extends Error {
+    readonly code: MapSnapshotErrorCode;
+    constructor(code: MapSnapshotErrorCode);
+}
+export declare function snapshotAborted(signal: AbortSignal): MapSnapshotError;
+/** Also observes late rejection; a cancelled image/font/encoding operation never becomes unhandled. */
+export declare function snapshotWait<T>(promise: Promise<T>, signal: AbortSignal): Promise<T>;
+/** Called synchronously in MapLibre's render event, before WebGL clears its drawing buffer. */
+export declare function rasterizeMapView(root: HTMLElement, base: HTMLCanvasElement, signal: AbortSignal): Promise<MapViewSnapshot>;

package/dist/types/content/map-view-types.d.ts

@@ -50,8 +50,23 @@ export type MapViewFrameProps = {
     attribution?: JSX.Element;
     class?: string;
 };
+export type MapViewSnapshot = {
+    data: Blob;
+    width: number;
+    height: number;
+};
+export type MapViewSnapshotOptions = {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+};
+export type MapViewHandle = {
+    /** Capture the current complete view; never loads, pans, refits, or retries provider resources. */
+    snapshot: (options?: MapViewSnapshotOptions) => Promise<MapViewSnapshot>;
+};
 export type MapViewProps = Omit<MapViewFrameProps, "attribution"> & {
     style: MapViewStyleSource;
+    /** Browser-only handle; remains safely callable after disposal (rejects disposed). */
+    ref?: (handle: MapViewHandle) => void;
     attribution: JSX.Element;
     onSelect?: (id: string) => void;
     infoTile?: (marker: MapViewMarker) => JSX.Element;

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

@@ -21,6 +21,11 @@ export interface ConfirmOptions extends DialogOptions {
 }
 type PromptContent = string | HTMLElement | JSX.Element;
 export type PromptSearchItem<T = unknown> = {
+    /**
+     * Stable identity of the result, such as its record ID. With it, a newer answer that contains the same result keeps
+     * its row, so a click in progress still lands. Without it, each answer replaces the rows.
+     */
+    id?: string;
     label: string;
     desc?: string;
     icon?: string;

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

@@ -14,6 +14,18 @@ export type ComboboxProps = FieldProps & {
     fetchData: (query: string, signal: AbortSignal) => Promise<ComboboxOption[]>;
     onSelect: (option: ComboboxOption) => void;
     debounceMs?: number;
+    /** The query is the field's own value: picking or closing keeps the typed text, and Enter without an active option only closes the list. */
+    freeText?: boolean;
+    /** Below this many characters nothing loads and the list stays closed. */
+    minQueryLength?: number;
+    /** This result (by position) is active as soon as results arrive, so Enter takes it. */
+    autoHighlight?: number;
+    /** Replaces the results with a host-owned notice, such as an exhausted quota; nothing loads while it is set. */
+    status?: JSX.Element;
+    /** Shown instead of the default text when a search finds nothing. */
+    empty?: JSX.Element;
+    /** One line under the results, such as their source. */
+    footer?: JSX.Element;
 };
 export declare function Combobox(props: ComboboxProps): JSX.Element;
 export default Combobox;

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

@@ -1,7 +1,7 @@
 import { type JSX } from "solid-js";
 import type { Completion } from "./completion";
 import type { ValueFieldProps } from "./field-contract";
-export type TextInputProps = Omit<JSX.InputHTMLAttributes<HTMLInputElement>, "onChange" | "onInput" | "prefix" | "suffix" | "type" | "value" | keyof ValueFieldProps<string>> & ValueFieldProps<string> & {
+export type TextInputProps = Omit<JSX.InputHTMLAttributes<HTMLInputElement>, "onChange" | "onInput" | "onKeyDown" | "prefix" | "suffix" | "type" | "value" | keyof ValueFieldProps<string>> & ValueFieldProps<string> & {
     minLength?: number;
     maxLength?: number;
     type?: "text" | "search" | "email" | "url" | "tel";
@@ -21,6 +21,7 @@ export type TextInputProps = Omit<JSX.InputHTMLAttributes<HTMLInputElement>, "on
     password?: boolean;
     markdown?: boolean;
     onSubmit?: () => void;
+    onKeyDown?: JSX.EventHandlerUnion<HTMLInputElement | HTMLTextAreaElement, KeyboardEvent>;
     lines?: number;
     abbreviations?: Record<string, string>;
     completions?: readonly Completion[];

package/dist/types/internal/keyed-for.d.ts

@@ -0,0 +1,13 @@
+import { type JSX } from "solid-js";
+/**
+ * `<For>` that keeps a row's element while its item stays the same: the same object, also when its getters change, or
+ * a new object with the same identity (`by`). Hosts rebuild equal items whenever their inputs change; `<For>` would
+ * then replace each row, and a row replaced between press and release swallows the click (#2140).
+ * Each row reads its current item.
+ */
+export declare function KeyedFor<T>(props: {
+    each: readonly T[];
+    by: (item: T) => string;
+    fallback?: JSX.Element;
+    children: (item: () => T, index: () => number) => JSX.Element;
+}): JSX.Element;

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

@@ -335,7 +335,10 @@ export type AppWorkspaceSidebarItemStatusProps = {
     unread?: number | boolean;
     /** Marks unread items that mention the person with "@". */
     mention?: boolean;
-    /** Shows a muted bell. */
+    /**
+     * Shows a muted bell, and the item reads as set aside: its label in the muted ink without unread weight, and a
+     * mention count without its fill.
+     */
     muted?: boolean;
     /**
      * Items that wait for the person, such as requests to approve, in the unread slot instead of `unread`. `label` is

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

@@ -6,6 +6,8 @@ export type ScrollAreaProps = Omit<JSX.HTMLAttributes<HTMLDivElement>, "children
     viewportSize?: "compact";
     orientation?: "vertical" | "horizontal";
     scrollPreserveKey?: string | false;
+    /** Keep 0.5 rem inside both side edges, like a workspace column; with a mouse the end one is a fixed scroll track. */
+    inset?: boolean;
     class?: string;
 };
 export declare function ScrollArea(props: ScrollAreaProps): JSX.Element;

package/dist/types/text-editor/engine.d.ts

@@ -27,7 +27,7 @@ export declare function createTextEditor(options: TextEditorOptions): {
     view: EditorView;
     /** Also re-reads `presentation`, so a host can refresh it, e.g. after a theme change. */
     setMode: (mode: TextEditorMode) => void;
-    setLabel: (label: string) => void;
+    setLabel: (next: string) => void;
     setReadOnly: (readOnly: boolean) => void;
     destroy: () => void;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2b/ui",
-  "version": "0.35.0",
+  "version": "0.37.0",
   "description": "Production-ready components for SolidJS applications.",
   "repository": {
     "type": "git",
@@ -73,11 +73,13 @@
     "@fontsource/ibm-plex-mono": "5.3.0",
     "@fontsource/ibm-plex-sans": "5.3.0",
     "@k2b/stdlib": "0.30.0",
+    "@lezer/highlight": "1.2.4",
     "@lezer/markdown": "1.7.2",
     "@tabler/icons-webfont": "3.48.0",
     "dompurify": "3.4.17",
     "maplibre-gl": "6.14.0",
     "marked": "18.0.14",
+    "pbf": "5.1.2",
     "qr-scanner": "1.4.2"
   },
   "peerDependencies": {
@@ -87,7 +89,7 @@
   "devDependencies": {
     "@babel/core": "8.0.6",
     "@babel/preset-typescript": "8.0.1",
-    "@k2b/ssr": "0.20.1",
+    "@k2b/ssr": "0.20.2",
     "@types/babel__core": "7.20.5",
     "@types/bun": "1.4.2",
     "axe-core": "4.11.0",