@k2b/ui 0.7.0 → 0.9.0

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

@@ -7,6 +7,14 @@ export type PdfPreviewProps = {
     title?: string;
     buttonLabel?: string;
     openButtonLabel?: string;
+    /**
+     * Opens the document at this address in a new tab instead of a local copy. Pass a stable same-origin URL that
+     * serves the PDF inline, so reloading and the viewer's file name keep working. Without it, the open action shows
+     * a temporary copy of the requested document.
+     */
+    openHref?: string;
+    /** Adds a Download action. The host owns the download, for example a fresh attachment URL. */
+    onDownload?: () => void;
     emptyText?: string;
     class?: string;
     children?: (parts: {

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

@@ -12,6 +12,18 @@ export type ChoiceOption<T extends string = string> = {
 export type ChoiceOptionsLoader<T extends string = string> = (query: string, signal: AbortSignal) => Promise<readonly ChoiceOption<T>[]>;
 export declare const filterChoiceOptions: <T extends string>(options: readonly ChoiceOption<T>[], query: string) => readonly ChoiceOption<T>[];
 export declare const nextEnabledChoiceIndex: <T extends string>(options: readonly ChoiceOption<T>[], current: number, direction: 1 | -1) => number;
+/**
+ * Counts the leading pills that fit into `available` pixels and measures the
+ * whole row. When not all of them fit, the rest collapse into a summary pill
+ * of width `more`; the first pill always stays and truncates when even it does
+ * not fit. Without a measured width (no layout yet) every pill stays. Half a
+ * pixel of slack absorbs layout rounding, so a row given exactly its own
+ * `rowWidth` always fits.
+ */
+export declare const fitChoicePills: (available: number, widths: readonly number[], gap: number, more: number) => {
+    visible: number;
+    rowWidth: number;
+};
 export declare function createChoiceLoader<T extends string>(loader: () => ChoiceOptionsLoader<T> | undefined, debounceMs: () => number): {
     options: () => readonly ChoiceOption<T>[];
     loading: () => boolean;

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

@@ -86,6 +86,18 @@ declare const uiMessages: import("@k2b/stdlib").Catalog<{
     refreshing: string;
     reset: string;
     required: string;
+    minCharacters: ({ count }: {
+        count: number;
+    }) => string;
+    maxCharacters: ({ count }: {
+        count: number;
+    }) => string;
+    minTags: ({ count }: {
+        count: number;
+    }) => string;
+    maxTags: ({ count }: {
+        count: number;
+    }) => string;
     rename: string;
     delete: string;
     remove: string;
@@ -142,6 +154,11 @@ declare const uiMessages: import("@k2b/stdlib").Catalog<{
     hiddenOverlappingEvents: ({ count }: {
         count: number;
     }) => string;
+    calendarEventTime: ({ title, start, end }: {
+        title: string;
+        start: string;
+        end: string;
+    }) => string;
     today: string;
     day: string;
     week: string;
@@ -222,6 +239,9 @@ declare const uiMessages: import("@k2b/stdlib").Catalog<{
     messageComposer: string;
     messageInput: string;
     confirmation: string;
+    typeToConfirm: ({ phrase }: {
+        phrase: string;
+    }) => string;
     confirm: string;
     dialog: string;
     discard: string;
@@ -229,6 +249,7 @@ declare const uiMessages: import("@k2b/stdlib").Catalog<{
     form: string;
     filterActions: string;
     info: string;
+    dismissNotification: string;
     interactiveLineChart: string;
     interactiveChart: string;
     chartFields: ({ key }: {
@@ -311,6 +332,8 @@ declare const uiMessages: import("@k2b/stdlib").Catalog<{
     pdfPreviewHttpError: ({ status }: {
         status: number;
     }) => string;
+    pdfPreviewTabBlocked: string;
+    pdfPreviewRendering: string;
     pickIcon: string;
     postMessage: string;
     preview: string;
@@ -334,6 +357,9 @@ declare const uiMessages: import("@k2b/stdlib").Catalog<{
         index: number;
         total: number;
     }) => string;
+    moreSelected: ({ count }: {
+        count: number;
+    }) => string;
     removeNamed: ({ name }: {
         name: string;
     }) => string;

package/dist/types/layout/navigation-model.d.ts

@@ -12,6 +12,8 @@ type NavigationEntry = {
     children?: readonly NavigationItem[];
     /** Initial disclosure state; subsequent toggles remain local to the renderer. */
     defaultExpanded?: boolean;
+    /** Owner-held disclosure state. The renderer shows it and reports toggles through `onExpandedChange`. */
+    expanded?: boolean;
     actions?: readonly NavigationItem[];
 };
 /** Serializable presentation. Functions stay with the controller's owning island. */
@@ -36,12 +38,15 @@ export type NavigationOptions = {
     items: Accessor<readonly NavigationItem[]>;
     onAction?: (action: string) => void | Promise<void>;
     onNavigate?: (event: LinkNavigateEvent) => void | Promise<void>;
+    /** Receives disclosure toggles of items that carry `expanded`; the owner decides the next state. */
+    onExpandedChange?: (id: string, expanded: boolean) => void;
 };
 export declare function findNavigationItem(items: readonly NavigationItem[], id: string): NavigationItem | undefined;
 /** One live source for renderers; no router, registry, fetching or persisted state. */
 export declare function createNavigation(options: NavigationOptions): {
     items: Accessor<readonly NavigationItem[]>;
     onNavigate: ((event: LinkNavigateEvent) => void | Promise<void>) | undefined;
+    onExpandedChange: ((id: string, expanded: boolean) => void) | undefined;
     activate(id: string): Promise<void>;
 };
 export type NavigationController = ReturnType<typeof createNavigation>;

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

@@ -2,7 +2,8 @@ import { type JSX } from "solid-js";
 export type PlaceholderAlign = "center" | "left";
 export type PlaceholderSurface = "none" | "paper";
 export type PlaceholderState = "empty" | "loading" | "error";
-export type PlaceholderVariant = "compact" | "panel";
+/** `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 = {
     title?: JSX.Element;
     description?: JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2b/ui",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Production-ready components for SolidJS applications.",
   "repository": {
     "type": "git",
@@ -62,6 +62,7 @@
     "bun-plugin-tailwind": "0.1.2",
     "happy-dom": "20.11.2",
     "hono": "4.13.8",
+    "playwright": "1.62.0",
     "seroval": "1.6.7",
     "solid-js": "1.9.15",
     "tailwindcss": "4.3.3",