@k2b/ui 0.2.0 → 0.4.0

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

@@ -1,6 +1,10 @@
 import { type JSX } from "solid-js";
 export type ScrollAreaProps = Omit<JSX.HTMLAttributes<HTMLDivElement>, "children" | "class"> & {
     children: JSX.Element;
+    scrollFade?: boolean;
+    /** Stable compact catalog height, clamped to 60% of the dynamic viewport. */
+    viewportSize?: "compact";
+    orientation?: "vertical" | "horizontal";
     scrollPreserveKey?: string | false;
     class?: string;
 };

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

@@ -40,7 +40,7 @@ type SettingsGroupComponent = ((props: SettingsGroupProps) => JSX.Element) & {
 };
 export declare const SettingsGroup: SettingsGroupComponent;
 export declare const sameSettingValue: (left: unknown, right: unknown) => boolean;
-export declare const readSettingsError: (response: Response, fallback: string) => Promise<{
+export declare const readSettingsError: (response: Pick<Response, "json">, fallback: string) => Promise<{
     message: string;
     fields: Record<string, string>;
 }>;

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

@@ -0,0 +1,11 @@
+import { type JSX } from "solid-js";
+import { type ScrollAreaProps } from "./ScrollArea";
+/** A non-modal, interactive row preview. Native popover owns light dismissal. */
+export declare function SidebarItemPreview(props: {
+    label: string;
+    children: JSX.Element | ((close: () => void) => JSX.Element);
+    trigger?: "action" | "row";
+    align?: "center" | "end";
+    viewportSize?: ScrollAreaProps["viewportSize"];
+    onOpenChange?: (open: boolean) => void;
+}): JSX.Element;

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

@@ -1,11 +1,12 @@
 export type { AppOverviewEmptyStateProps, AppOverviewPanelProps, AppOverviewProps, } from "./AppOverview";
 export { default as AppOverview } from "./AppOverview";
-export type { AppWorkspaceBottomDrawerHeight, AppWorkspaceBottomDrawerProps, AppWorkspaceContentProps, AppWorkspaceDetailProps, AppWorkspaceDetailWidth, AppWorkspaceMainPaneProps, AppWorkspaceMainProps, AppWorkspaceNavTreeItemProps, AppWorkspaceNavTreeProps, AppWorkspaceProps, AppWorkspaceSidebarAccessoryVisibility, AppWorkspaceSidebarBodyProps, AppWorkspaceSidebarIconActionProps, AppWorkspaceSidebarIconActionTone, AppWorkspaceSidebarIconGridProps, AppWorkspaceSidebarItemActionProps, AppWorkspaceSidebarItemActionsProps, AppWorkspaceSidebarItemIconProps, AppWorkspaceSidebarItemLabelProps, AppWorkspaceSidebarItemMetaProps, AppWorkspaceSidebarItemProps, AppWorkspaceSidebarItemTone, AppWorkspaceSidebarMobileItemsProps, AppWorkspaceSidebarMobileProps, AppWorkspaceSidebarMobileTriggerProps, AppWorkspaceSidebarProps, AppWorkspaceSidebarSectionProps, AppWorkspaceSidebarVisibility, } from "./AppWorkspace";
+export type { AppWorkspaceBottomDrawerHeight, AppWorkspaceBottomDrawerProps, AppWorkspaceContentProps, AppWorkspaceDetailProps, AppWorkspaceDetailWidth, AppWorkspaceMainPaneProps, AppWorkspaceMainProps, AppWorkspaceNavTreeItemProps, AppWorkspaceNavTreeProps, AppWorkspaceProps, AppWorkspaceSidebarAccessoryVisibility, AppWorkspaceSidebarBodyProps, AppWorkspaceSidebarIconActionProps, AppWorkspaceSidebarIconActionTone, AppWorkspaceSidebarIconGridProps, AppWorkspaceSidebarItemActionProps, AppWorkspaceSidebarItemActionsProps, AppWorkspaceSidebarItemIconProps, AppWorkspaceSidebarItemLabelProps, AppWorkspaceSidebarItemMetaProps, AppWorkspaceSidebarItemProps, 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 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, bottomSheetOptions, default as BottomSheet } from "./BottomSheet";
 export type { DataPanelProps } from "./DataPanel";
 export { DataPanel } from "./DataPanel";
 export type { DetailPanelActionButtonProps, DetailPanelActionLinkProps, DetailPanelActionProps, DetailPanelBodyProps, DetailPanelGroupProps, DetailPanelHeaderProps, DetailPanelProps, DetailPanelSectionProps, DetailPanelSummaryProps, DetailPanelTone, } from "./DetailPanel";
@@ -14,6 +15,8 @@ export type { DiscussionComposerProps, DiscussionItemProps, DiscussionListProps,
 export { default as Discussion } from "./Discussion";
 export type { FloatingWindowClose, FloatingWindowProps, OpenFloatingWindowOptions, } from "./FloatingWindow";
 export { default as FloatingWindow, type FloatingWindowRect, fitFloatingWindowRect, openFloatingWindow, } from "./FloatingWindow";
+export { default as Navigation, type NavigationProps } from "./Navigation";
+export { createNavigation, findNavigationItem, type NavigationController, type NavigationItem, type NavigationOptions, } from "./navigation-model";
 export type { PanelDialogBodyProps, PanelDialogFooterProps, PanelDialogHeaderProps, PanelDialogProps, PanelDialogSectionProps, PanelDialogSurface, PanelDialogTabOption, PanelDialogTabsProps, } from "./PanelDialog";
 export { confirmDiscardIfDirty, default as PanelDialog, panelDialogFixedOptions, panelDialogFixedPanelClass, panelDialogOptions, panelDialogPanelClass, panelDialogWideOptions, panelDialogWidePanelClass, panelDialogWorkspaceOptions, panelDialogWorkspacePanelClass, } from "./PanelDialog";
 export type { PanelHeaderProps } from "./PanelHeader";

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

@@ -0,0 +1,48 @@
+import type { LinkNavigateEvent, NavigationScrollMode } from "@k2b/ssr/nav";
+import type { Accessor } from "solid-js";
+type NavigationEntry = {
+    id: string;
+    label: string;
+    icon?: string;
+    badge?: string | number;
+    description?: string;
+    active?: boolean;
+    disabled?: boolean;
+    color?: string;
+    children?: readonly NavigationItem[];
+    /** Initial disclosure state; subsequent toggles remain local to the renderer. */
+    defaultExpanded?: boolean;
+    actions?: readonly NavigationItem[];
+};
+/** Serializable presentation. Functions stay with the controller's owning island. */
+export type NavigationItem = NavigationEntry & ({
+    href: string;
+    action?: string;
+    navigation?: "document" | "enhanced";
+    scroll?: NavigationScrollMode;
+} | {
+    action: string;
+    href?: never;
+    navigation?: never;
+    scroll?: never;
+} | {
+    href?: never;
+    action?: never;
+    navigation?: never;
+    scroll?: never;
+    children: readonly NavigationItem[];
+});
+export type NavigationOptions = {
+    items: Accessor<readonly NavigationItem[]>;
+    onAction?: (action: string) => void | Promise<void>;
+    onNavigate?: (event: LinkNavigateEvent) => void | Promise<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;
+    activate(id: string): Promise<void>;
+};
+export type NavigationController = ReturnType<typeof createNavigation>;
+export {};

package/dist/types/layout/scroll-fade.d.ts

@@ -0,0 +1,3 @@
+export declare function createScrollFade(element: () => HTMLElement | undefined, enabled: () => boolean): void;
+/** Enrich only explicitly marked UI scrollports, including SSR and later navigation. */
+export declare function installScrollFades(root: Document | HTMLElement): () => void;

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

@@ -7,7 +7,7 @@ export type DescriptionListItem = {
 export type DescriptionListProps = {
     items: readonly DescriptionListItem[];
     columns?: 1 | 2 | 3;
-    layout?: "grid" | "rows";
+    layout?: "grid" | "rows" | "compact";
     size?: "sm" | "md";
     actionVisibility?: "always" | "progressive";
     class?: string;

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

@@ -1,5 +1,5 @@
 import { type JSX } from "solid-js";
-export type StatusTone = "ok" | "warning" | "error" | "degraded" | "running" | "neutral";
+export type StatusTone = "info" | "ok" | "warning" | "error" | "degraded" | "running" | "neutral";
 export type StatusBadgeProps = {
     tone: StatusTone;
     label: JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2b/ui",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Production-ready components for SolidJS applications.",
   "repository": {
     "type": "git",
@@ -34,9 +34,7 @@
   "scripts": {
     "build": "bun run scripts/build.ts",
     "check:declarations": "bun run scripts/check-declarations.ts",
-    "check:packed-consumer": "bun run build && bun run scripts/check-packed-consumer.ts",
     "fixture:build": "bun run build && NODE_ENV=production bun run fixture/scripts/build.ts",
-    "fixture:dev": "NODE_ENV=development bun --preload ./fixture/src/preload.ts ./fixture/src/server.ts",
     "fixture:typecheck": "tsc -p fixture/tsconfig.json --noEmit --pretty false",
     "test": "bun run build && bun test src scripts && bun run test:dom && bun run scripts/check-packed-consumer.ts",
     "test:dom": "bun test --isolate --conditions=browser --preload ./test/solid-dom-preload.ts ./test",
@@ -47,20 +45,20 @@
   "dependencies": {
     "@fontsource/ibm-plex-mono": "5.3.0",
     "@fontsource/ibm-plex-sans": "5.3.0",
-    "@k2b/stdlib": "0.22.0",
+    "@k2b/stdlib": "0.25.0",
     "@tabler/icons-webfont": "3.46.0",
     "marked": "17.0.6"
   },
   "peerDependencies": {
-    "@k2b/ssr": "^0.12.0",
+    "@k2b/ssr": "^0.12.0 || ^0.13.0 || ^0.14.0",
     "solid-js": "^1.9.10"
   },
   "devDependencies": {
     "@babel/core": "7.29.7",
     "@babel/preset-typescript": "7.29.7",
-    "@k2b/ssr": "0.12.0",
+    "@k2b/ssr": "0.14.0",
     "@types/babel__core": "7.20.5",
-    "@types/bun": "1.3.14",
+    "@types/bun": "1.4.2",
     "babel-preset-solid": "1.9.12",
     "bun-plugin-tailwind": "0.1.2",
     "happy-dom": "20.11.1",