@k2b/ui 0.1.0-rc.0 → 0.1.1

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

@@ -0,0 +1,89 @@
+import { type JSX } from "solid-js";
+import { type ButtonLinkProps, type ButtonProps } from "../actions/Button";
+import { type DropdownItem } from "../actions/Dropdown";
+export type DetailPanelProps = {
+    children: JSX.Element;
+    class?: string;
+};
+type DetailPanelHeaderBaseProps = {
+    title: JSX.Element;
+    subtitle?: JSX.Element;
+    meta?: JSX.Element;
+    actions?: JSX.Element;
+    primaryActions?: JSX.Element;
+    class?: string;
+};
+export type DetailPanelHeaderProps = DetailPanelHeaderBaseProps & ({
+    leading?: JSX.Element;
+    icon?: never;
+} | {
+    leading?: never;
+    icon?: string;
+});
+export type DetailPanelBodyProps = {
+    children: JSX.Element;
+    scrollPreserveKey?: string;
+    class?: string;
+};
+export type DetailPanelSummaryProps = {
+    title: JSX.Element;
+    children: JSX.Element;
+    actions?: JSX.Element;
+    class?: string;
+};
+export type DetailPanelGroupProps = {
+    children: JSX.Element;
+    label?: string;
+    class?: string;
+};
+export type DetailPanelTone = "accent" | "neutral" | "success" | "warning" | "danger";
+type DetailPanelSectionBaseProps = {
+    title: JSX.Element;
+    icon?: string;
+    tone?: DetailPanelTone;
+    description?: JSX.Element;
+    meta?: JSX.Element;
+    class?: string;
+};
+type DetailPanelActionBaseProps = {
+    title: JSX.Element;
+    description?: JSX.Element;
+    leading?: JSX.Element;
+    trailing?: JSX.Element;
+    class?: string;
+};
+type DetailPanelActionMenuProps = {
+    menuItems?: never;
+    menuLabel?: never;
+} | {
+    menuItems: readonly DropdownItem[];
+    menuLabel: string;
+};
+export type DetailPanelActionLinkProps = DetailPanelActionBaseProps & DetailPanelActionMenuProps & Omit<ButtonLinkProps, "children" | "class" | "size" | "title" | "variant"> & {
+    href: string;
+};
+export type DetailPanelActionButtonProps = DetailPanelActionBaseProps & DetailPanelActionMenuProps & Omit<ButtonProps, "children" | "class" | "size" | "title" | "variant"> & {
+    href?: never;
+};
+export type DetailPanelActionProps = DetailPanelActionLinkProps | DetailPanelActionButtonProps;
+export type DetailPanelSectionProps = DetailPanelSectionBaseProps & ({
+    children?: JSX.Element;
+    actions?: JSX.Element;
+    collapsible?: false;
+    defaultOpen?: never;
+} | {
+    children: JSX.Element;
+    actions?: never;
+    collapsible: true;
+    defaultOpen?: boolean;
+});
+type DetailPanelComponent = ((props: DetailPanelProps) => JSX.Element) & {
+    Header: (props: DetailPanelHeaderProps) => JSX.Element;
+    Body: (props: DetailPanelBodyProps) => JSX.Element;
+    Summary: (props: DetailPanelSummaryProps) => JSX.Element;
+    Group: (props: DetailPanelGroupProps) => JSX.Element;
+    Section: (props: DetailPanelSectionProps) => JSX.Element;
+    Action: (props: DetailPanelActionProps) => JSX.Element;
+};
+declare const DetailPanel: DetailPanelComponent;
+export default DetailPanel;

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

@@ -0,0 +1,52 @@
+import { type JSX } from "solid-js";
+export type DiscussionProps = Omit<JSX.HTMLAttributes<HTMLElement>, "children" | "class"> & {
+    label: JSX.Element;
+    children: JSX.Element;
+    icon?: string | false;
+    count?: number;
+    actions?: JSX.Element;
+    as?: "h2" | "h3";
+    surface?: "default" | "bare";
+    class?: string;
+};
+export type DiscussionComposerProps = Omit<JSX.FormHTMLAttributes<HTMLFormElement>, "children" | "class" | "onSubmit"> & {
+    label: string;
+    onSubmit: (message: string) => boolean | void | Promise<boolean | void>;
+    initialValue?: string;
+    placeholder?: string;
+    submitLabel?: string;
+    cancelLabel?: string;
+    onCancel?: () => void;
+    lines?: number;
+    class?: string;
+};
+export type DiscussionListProps = {
+    children?: JSX.Element;
+    loading?: boolean;
+    loadingLabel?: string;
+    error?: string | null;
+    onRetry?: () => void | Promise<void>;
+    hasMore?: boolean;
+    loadingMore?: boolean;
+    loadMoreLabel?: string;
+    onLoadMore?: () => boolean | void | Promise<boolean | void>;
+    class?: string;
+};
+export type DiscussionItemProps = Omit<JSX.LiHTMLAttributes<HTMLLIElement>, "children" | "class"> & {
+    author: JSX.Element;
+    children: JSX.Element;
+    avatar?: JSX.Element;
+    timestamp?: JSX.Element;
+    meta?: JSX.Element;
+    replyContext?: JSX.Element;
+    actions?: JSX.Element;
+    actionVisibility?: "always" | "progressive";
+    class?: string;
+};
+type DiscussionComponent = ((props: DiscussionProps) => JSX.Element) & {
+    Composer: (props: DiscussionComposerProps) => JSX.Element;
+    List: (props: DiscussionListProps) => JSX.Element;
+    Item: (props: DiscussionItemProps) => JSX.Element;
+};
+declare const Discussion: DiscussionComponent;
+export default Discussion;

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

@@ -0,0 +1,19 @@
+import { type JSX } from "solid-js";
+export { type FloatingWindowRect, fitFloatingWindowRect } from "./floating-window-geometry";
+export type FloatingWindowProps = {
+    title: string;
+    icon?: string;
+    children: JSX.Element;
+    onClose: () => void;
+    initialWidth?: number;
+    initialHeight?: number;
+    minWidth?: number;
+    minHeight?: number;
+    accent?: string;
+    class?: string;
+    resolveScope?: () => HTMLElement | null | undefined;
+};
+export type OpenFloatingWindowOptions = Omit<FloatingWindowProps, "children" | "onClose">;
+export type FloatingWindowClose = () => void;
+export default function FloatingWindow(props: FloatingWindowProps): JSX.Element;
+export declare const openFloatingWindow: (view: (close: FloatingWindowClose) => JSX.Element, options: OpenFloatingWindowOptions) => FloatingWindowClose;

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

@@ -0,0 +1,72 @@
+import { type JSX } from "solid-js";
+export type PanelDialogSurface = "contained" | "floating";
+export type PanelDialogProps = {
+    children: JSX.Element;
+    surface?: PanelDialogSurface;
+};
+export type PanelDialogHeaderProps = {
+    title: JSX.Element;
+    subtitle?: JSX.Element;
+    icon?: string;
+    actions?: JSX.Element;
+    close?: () => void;
+    closeDisabled?: boolean;
+    closeLabel?: string;
+};
+export type PanelDialogBodyProps = {
+    children: JSX.Element;
+    scrollPreserveKey?: string;
+};
+export type PanelDialogFooterProps = {
+    children: JSX.Element;
+};
+export type PanelDialogSectionProps = {
+    title: JSX.Element;
+    subtitle?: JSX.Element;
+    icon?: string;
+    actions?: JSX.Element;
+    children: JSX.Element;
+};
+export type PanelDialogTabOption<T extends string = string> = {
+    value: T;
+    label: JSX.Element;
+    icon?: string;
+    disabled?: boolean;
+};
+export type PanelDialogTabsProps<T extends string = string> = {
+    options: readonly PanelDialogTabOption<T>[];
+    value: T | (() => T);
+    onValueChange: (value: T) => void;
+    ariaLabel?: string;
+    label?: string;
+};
+type PanelDialogComponent = ((props: PanelDialogProps) => JSX.Element) & {
+    Header: (props: PanelDialogHeaderProps) => JSX.Element;
+    Body: (props: PanelDialogBodyProps) => JSX.Element;
+    Footer: (props: PanelDialogFooterProps) => JSX.Element;
+    Section: (props: PanelDialogSectionProps) => JSX.Element;
+    Tabs: <T extends string>(props: PanelDialogTabsProps<T>) => JSX.Element;
+};
+export declare const panelDialogPanelClass = "k2b-dialog k2b-panel-dialog-frame is-standard";
+export declare const panelDialogOptions: {
+    panelClassName: string;
+    contentClassName: string;
+};
+export declare const panelDialogWidePanelClass = "k2b-dialog k2b-panel-dialog-frame is-wide";
+export declare const panelDialogWideOptions: {
+    panelClassName: string;
+    contentClassName: string;
+};
+export declare const panelDialogFixedPanelClass = "k2b-dialog k2b-panel-dialog-frame is-fixed";
+export declare const panelDialogFixedOptions: {
+    panelClassName: string;
+    contentClassName: string;
+};
+export declare const panelDialogWorkspacePanelClass = "k2b-dialog k2b-panel-dialog-frame is-workspace";
+export declare const panelDialogWorkspaceOptions: {
+    panelClassName: string;
+    contentClassName: string;
+};
+export declare const confirmDiscardIfDirty: (dirty: boolean | (() => boolean)) => Promise<boolean>;
+declare const PanelDialog: PanelDialogComponent;
+export default PanelDialog;

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

@@ -0,0 +1,10 @@
+import { type JSX } from "solid-js";
+export type PanelHeaderProps = {
+    title: JSX.Element;
+    subtitle?: JSX.Element;
+    actions?: JSX.Element;
+    as?: "h1" | "h2" | "h3";
+    size?: "sm" | "md";
+    class?: string;
+};
+export declare function PanelHeader(props: PanelHeaderProps): JSX.Element;

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

@@ -0,0 +1,48 @@
+import { type DndDroppableSnapshot } from "@k2b/stdlib/solid";
+import { type JSX } from "solid-js";
+import { type PanesDropTarget, type PanesLayout } from "./panes-layout";
+export type PanesItem = {
+    id: string;
+    title: string;
+    icon?: string;
+    render: () => JSX.Element;
+    onClose?: () => void;
+};
+export type PanesProps = {
+    layout: PanesLayout;
+    onLayoutChange: (layout: PanesLayout) => void;
+    items: readonly PanesItem[];
+    movable?: boolean;
+    resizable?: boolean;
+    split?: false | "horizontal" | "vertical" | "both";
+    onAddItem?: (targetItemId: string | null) => void;
+    ariaLabel?: string;
+    class?: string;
+};
+type DropMeta = {
+    target: PanesDropTarget;
+    label: string;
+};
+type IndexedPanesDropTargets = {
+    tabs: ReadonlyMap<string | null, PanesDropTarget>;
+    body: readonly PanesDropTarget[];
+};
+type PanesSeparatorGeometry = {
+    coordinate: number;
+    crossStart: number;
+    crossEnd: number;
+};
+export declare const resolvePanesResizeSnap: (coordinate: number, source: PanesSeparatorGeometry, candidates: readonly PanesSeparatorGeometry[], options?: {
+    activeCoordinate?: number | null;
+    previousCoordinate?: number;
+}) => {
+    coordinate: number;
+    snappedTo: number | null;
+};
+export declare const indexPanesDropTargets: (targets: readonly PanesDropTarget[]) => ReadonlyMap<string, IndexedPanesDropTargets>;
+export declare const pointerHitsPanesDropTarget: (entry: Pick<DndDroppableSnapshot<DropMeta>, "containsPointer" | "meta" | "rect"> & Partial<Pick<DndDroppableSnapshot<DropMeta>, "element">>, pointer: {
+    x: number;
+    y: number;
+}, hitElement?: Element | null) => boolean;
+export default function Panes(props: PanesProps): JSX.Element;
+export {};

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

@@ -0,0 +1,8 @@
+import { type JSX } from "solid-js";
+export type ScrollAreaProps = Omit<JSX.HTMLAttributes<HTMLDivElement>, "children" | "class"> & {
+    children: JSX.Element;
+    scrollPreserveKey?: string | false;
+    class?: string;
+};
+export declare function ScrollArea(props: ScrollAreaProps): JSX.Element;
+export default ScrollArea;

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

@@ -0,0 +1,72 @@
+import { type JSX } from "solid-js";
+import { type ButtonVariant } from "../actions/Button";
+import type { MaybeAccessor } from "../inputs/field-contract";
+export type SettingsPageProps = {
+    title: JSX.Element;
+    subtitle?: JSX.Element;
+    icon?: string;
+    actions?: JSX.Element;
+    children: JSX.Element;
+    footer?: JSX.Element;
+    scrollPreserveKey?: string;
+    class?: string;
+    style?: JSX.CSSProperties | string;
+};
+export declare function SettingsPage(props: SettingsPageProps): JSX.Element;
+export type SettingsSectionProps = {
+    title: JSX.Element;
+    subtitle?: JSX.Element;
+    icon?: string;
+    actions?: JSX.Element;
+    children: JSX.Element;
+    class?: string;
+};
+/**
+ * A full-page settings group. Dialogs keep using PanelDialog.Section; this
+ * component owns the quieter, observability-style paper used on admin pages.
+ */
+export declare function SettingsSection(props: SettingsSectionProps): JSX.Element;
+export type SettingsGroupProps = {
+    title: JSX.Element;
+    description?: JSX.Element;
+    children: JSX.Element;
+    class?: string;
+};
+export type SettingsGroupActionProps = {
+    children: JSX.Element;
+};
+type SettingsGroupComponent = ((props: SettingsGroupProps) => JSX.Element) & {
+    Action: (props: SettingsGroupActionProps) => 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<{
+    message: string;
+    fields: Record<string, string>;
+}>;
+export type SettingsFieldProps = {
+    label: string;
+    description: string;
+    error: MaybeAccessor<string | undefined>;
+    changed?: MaybeAccessor<boolean>;
+    children: JSX.Element | ((control: SettingsFieldControlProps) => JSX.Element);
+    class?: string;
+};
+export type SettingsFieldControlProps = {
+    describedBy: () => string;
+};
+export declare function SettingsField(props: SettingsFieldProps): JSX.Element;
+export type SettingsSaveBarProps = {
+    changeCount: MaybeAccessor<number>;
+    loading: MaybeAccessor<boolean>;
+    saveDisabled?: MaybeAccessor<boolean>;
+    onDiscard: () => void;
+    onSave: () => void;
+    saveLabel?: string;
+    saveVariant?: ButtonVariant;
+    class?: string;
+};
+export declare function SettingsSaveBar(props: SettingsSaveBarProps): JSX.Element;
+export type SettingsPanelFooterProps = SettingsSaveBarProps;
+export declare function SettingsPanelFooter(props: SettingsPanelFooterProps): JSX.Element;
+export {};

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

@@ -0,0 +1,41 @@
+import { type JSX } from "solid-js";
+export type SettingsCollectionProps = {
+    title: JSX.Element;
+    description?: JSX.Element;
+    empty?: JSX.Element;
+    children?: JSX.Element;
+    class?: string;
+};
+export type SettingsCollectionActionProps = {
+    children: JSX.Element;
+};
+export type SettingsCollectionItemProps = {
+    title: JSX.Element;
+    description?: JSX.Element;
+    icon?: JSX.Element;
+    children?: JSX.Element;
+};
+export type SettingsCollectionItemStatusProps = {
+    children: JSX.Element;
+};
+export type SettingsCollectionItemActionsProps = {
+    children: JSX.Element;
+};
+export type SettingsCollectionItemReorderProps = {
+    label: string;
+    index: number;
+    count: number;
+    disabled?: boolean;
+    onMove: (direction: -1 | 1) => void;
+};
+type SettingsCollectionItemComponent = ((props: SettingsCollectionItemProps) => JSX.Element) & {
+    Status: (props: SettingsCollectionItemStatusProps) => JSX.Element;
+    Actions: (props: SettingsCollectionItemActionsProps) => JSX.Element;
+    Reorder: (props: SettingsCollectionItemReorderProps) => JSX.Element;
+};
+type SettingsCollectionComponent = ((props: SettingsCollectionProps) => JSX.Element) & {
+    Action: (props: SettingsCollectionActionProps) => JSX.Element;
+    Item: SettingsCollectionItemComponent;
+};
+declare const SettingsCollection: SettingsCollectionComponent;
+export default SettingsCollection;

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

@@ -0,0 +1,39 @@
+import { type JSX } from "solid-js";
+export type SettingsModalTabTone = "default" | "danger";
+export type SettingsModalTabProps = {
+    id: string;
+    title: string;
+    description?: string;
+    icon?: string;
+    tone?: SettingsModalTabTone;
+    children: JSX.Element;
+};
+export type SettingsModalGroupProps = {
+    title: string;
+    children: JSX.Element;
+};
+export type SettingsModalFooterProps = {
+    children: JSX.Element;
+};
+export type SettingsModalProps = {
+    /** Accessible name for the settings surface. */
+    title: string;
+    /** @deprecated Retained for source compatibility; tab descriptions carry the visible context. */
+    subtitle?: string;
+    /** @deprecated Retained for source compatibility; tab icons identify the rail entries. */
+    icon?: string;
+    defaultTab?: string;
+    activeTab?: string;
+    onTabChange?: (id: string) => void;
+    onClose?: () => void;
+    closeLabel?: string;
+    class?: string;
+    children: JSX.Element;
+};
+type SettingsModalComponent = ((props: SettingsModalProps) => JSX.Element) & {
+    Tab: (props: SettingsModalTabProps) => JSX.Element;
+    Group: (props: SettingsModalGroupProps) => JSX.Element;
+    Footer: (props: SettingsModalFooterProps) => JSX.Element;
+};
+declare const SettingsModal: SettingsModalComponent;
+export default SettingsModal;

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

@@ -0,0 +1,7 @@
+import { type AppWorkspaceLayoutState } from "./app-workspace-state";
+export type AppWorkspaceControllerOptions = {
+    root?: Document | HTMLElement;
+    readState?: () => AppWorkspaceLayoutState | null | undefined;
+    writeState?: (state: AppWorkspaceLayoutState) => void;
+};
+export declare const installAppWorkspaceController: (options?: AppWorkspaceControllerOptions) => (() => void);

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

@@ -0,0 +1,57 @@
+export type AppWorkspaceLayoutState = {
+    version: 2;
+    sidebarWidth?: number;
+    sidebarCollapsed?: boolean;
+    paneWidths?: Record<string, number>;
+    detailWidths?: Record<string, number>;
+    drawerHeights?: Record<string, number>;
+};
+export declare const APP_WORKSPACE_SIDEBAR_DEFAULT = 208;
+export declare const APP_WORKSPACE_SIDEBAR_COLLAPSED = 64;
+export declare const APP_WORKSPACE_SIDEBAR_COLLAPSE_THRESHOLD = 128;
+export declare const APP_WORKSPACE_SIDEBAR_MIN = 176;
+export declare const APP_WORKSPACE_SIDEBAR_MAX = 360;
+export declare const APP_WORKSPACE_DETAIL_DEFAULT = 384;
+export declare const APP_WORKSPACE_DETAIL_MIN = 288;
+export declare const APP_WORKSPACE_DETAIL_MAX = 640;
+export declare const APP_WORKSPACE_DRAWER_DEFAULT = 240;
+export declare const APP_WORKSPACE_DRAWER_MIN = 160;
+export declare const APP_WORKSPACE_DRAWER_MAX = 560;
+/** Space `appWorkspaceResizeLimits` always reserves for the main region. */
+export declare const APP_WORKSPACE_MAIN_MIN = 320;
+export declare const APP_WORKSPACE_MAIN_MIN_HEIGHT = 240;
+export declare const APP_WORKSPACE_PANE_DEFAULT = 320;
+export declare const APP_WORKSPACE_PANE_MIN = 240;
+export declare const APP_WORKSPACE_PANE_MAX = 640;
+export type AppWorkspaceResizeKind = "sidebar" | "pane" | "detail" | "drawer";
+export declare const appWorkspaceResizeLimits: (options: {
+    kind: AppWorkspaceResizeKind;
+    workspaceSize: number;
+    reservedSize: number;
+    min?: number;
+    max?: number;
+    sidebarCollapsible?: boolean;
+}) => {
+    min: number;
+    max: number;
+};
+/**
+ * Fits preferred auxiliary pane widths into a shared budget without giving
+ * DOM order priority. Minimums are reserved first; remaining space is shared
+ * in proportion to how much each pane still needs to reach its preference.
+ */
+export declare const fitAppWorkspacePaneSizes: (panes: ReadonlyArray<{
+    desired: number;
+    min: number;
+}>, availableSize: number) => number[];
+export declare const shouldCollapseAppWorkspaceSidebar: (width: number, collapsible: boolean) => boolean;
+export declare const resolveAppWorkspaceSidebarWidth: (width: number, maxWidth: number, collapsible: boolean) => {
+    width: number;
+    collapsed: boolean;
+};
+export declare const safeAppWorkspacePanelId: (panelId: string) => string;
+export declare const appWorkspacePanelVariable: (kind: "pane" | "detail" | "drawer", panelId: string) => string;
+export declare const normalizeAppWorkspaceLayoutState: (value: unknown) => AppWorkspaceLayoutState | null;
+export declare const parseAppWorkspaceLayoutState: (value: string | null | undefined) => AppWorkspaceLayoutState | null;
+export declare const serializeAppWorkspaceLayoutState: (state: AppWorkspaceLayoutState) => string;
+export declare const appWorkspaceLayoutStyle: (state: AppWorkspaceLayoutState | null | undefined) => string | undefined;

package/dist/types/layout/floating-window-geometry.d.ts

@@ -0,0 +1,11 @@
+export type FloatingWindowRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export declare const FLOATING_WINDOW_VIEWPORT_GAP = 16;
+export declare const fitFloatingWindowRect: (rect: FloatingWindowRect, minWidth: number, minHeight: number, viewport: {
+    width: number;
+    height: number;
+}) => FloatingWindowRect;

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

@@ -0,0 +1,32 @@
+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 { 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 { DataPanelProps } from "./DataPanel";
+export { DataPanel } from "./DataPanel";
+export type { DetailPanelActionButtonProps, DetailPanelActionLinkProps, DetailPanelActionProps, DetailPanelBodyProps, DetailPanelGroupProps, DetailPanelHeaderProps, DetailPanelProps, DetailPanelSectionProps, DetailPanelSummaryProps, DetailPanelTone, } from "./DetailPanel";
+export { default as DetailPanel } from "./DetailPanel";
+export type { DiscussionComposerProps, DiscussionItemProps, DiscussionListProps, DiscussionProps } from "./Discussion";
+export { default as Discussion } from "./Discussion";
+export type { FloatingWindowClose, FloatingWindowProps, OpenFloatingWindowOptions, } from "./FloatingWindow";
+export { default as FloatingWindow, type FloatingWindowRect, fitFloatingWindowRect, openFloatingWindow, } from "./FloatingWindow";
+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";
+export { PanelHeader } from "./PanelHeader";
+export type { PanesItem, PanesProps } from "./Panes";
+export { default as Panes } from "./Panes";
+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 type { ScrollAreaProps } from "./ScrollArea";
+export { default as ScrollArea } from "./ScrollArea";
+export type { SettingsFieldControlProps, SettingsFieldProps, SettingsGroupActionProps, SettingsGroupProps, SettingsPageProps, SettingsPanelFooterProps, SettingsSaveBarProps, SettingsSectionProps, } from "./Settings";
+export { readSettingsError, SettingsField, SettingsGroup, SettingsPage, SettingsPanelFooter, SettingsSaveBar, SettingsSection, sameSettingValue, } from "./Settings";
+export type { SettingsCollectionActionProps, SettingsCollectionItemActionsProps, SettingsCollectionItemProps, SettingsCollectionItemReorderProps, SettingsCollectionItemStatusProps, SettingsCollectionProps, } from "./SettingsCollection";
+export { default as SettingsCollection } from "./SettingsCollection";
+export type { SettingsModalFooterProps, SettingsModalGroupProps, SettingsModalProps, SettingsModalTabProps, SettingsModalTabTone, } from "./SettingsModal";
+export { default as SettingsModal } from "./SettingsModal";

package/dist/types/layout/panes-layout.d.ts

@@ -0,0 +1,63 @@
+export declare const PANES_LAYOUT_VERSION: 2;
+export declare const PANES_MIN_RATIO = 0.08;
+export declare const PANES_MAX_ID_LENGTH = 160;
+export type PanesDirection = "horizontal" | "vertical";
+export type PanesSide = "left" | "right" | "top" | "bottom";
+export type PanesPathSegment = "first" | "second";
+export type PanesPath = readonly PanesPathSegment[];
+export type PanesGroup = {
+    type: "group";
+    items: string[];
+    active: string;
+};
+export type PanesSplit = {
+    type: "split";
+    direction: PanesDirection;
+    ratio: number;
+    first: PanesNode;
+    second: PanesNode;
+};
+export type PanesNode = PanesGroup | PanesSplit;
+export type PanesLayout = {
+    version: typeof PANES_LAYOUT_VERSION;
+    root: PanesNode | null;
+};
+export type PanesIntent = {
+    type: "tab";
+    itemId: string;
+    targetItemId: string;
+    beforeItemId: string | null;
+} | {
+    type: "split";
+    itemId: string;
+    targetItemId: string;
+    side: PanesSide;
+};
+export type PanesDropTarget = {
+    id: string;
+    kind: "tab" | "group" | "split";
+    targetItemId: string;
+    beforeItemId?: string | null;
+    side?: PanesSide;
+    intent: PanesIntent;
+};
+export type PanesDropTargetOptions = {
+    movable: boolean;
+    split: false | PanesDirection | "both";
+};
+export declare const parsePanesLayout: (value: unknown) => PanesLayout | null;
+export declare const createPanesLayout: (itemIds: readonly string[]) => PanesLayout;
+export declare const activatePanesItem: (layout: PanesLayout, itemId: string) => PanesLayout;
+export declare const isPanesItemVisible: (layout: PanesLayout, itemId: string) => boolean;
+export declare const removePanesItem: (layout: PanesLayout, itemId: string) => PanesLayout;
+export type AddPanesItemOptions = {
+    itemId: string;
+    targetItemId: string | null;
+    beforeItemId?: string | null;
+};
+export declare const addPanesItem: (layout: PanesLayout, options: AddPanesItemOptions) => PanesLayout;
+export declare const applyPanesIntent: (layout: PanesLayout, intent: PanesIntent) => PanesLayout;
+export declare const reconcilePanesLayout: (layout: PanesLayout, desiredOpenItemIds: readonly string[]) => PanesLayout;
+export declare const resizePanesSplit: (layout: PanesLayout, path: PanesPath, ratio: number) => PanesLayout;
+export declare const samePanesIntent: (left: PanesIntent | null, right: PanesIntent | null) => boolean;
+export declare const getPanesDropTargets: (layout: PanesLayout, itemId: string, options: PanesDropTargetOptions) => PanesDropTarget[];

package/dist/types/layout/stable-id.d.ts

@@ -0,0 +1,3 @@
+export declare const isStableUiId: (value: unknown, maxLength?: number) => value is string;
+export declare const assertStableUiId: (value: string, label: string, maxLength?: number) => string;
+export declare const assertUniqueStableUiIds: (values: readonly string[], label: string, maxLength?: number) => void;

package/dist/types/semantics.d.ts

@@ -0,0 +1,4 @@
+/** Semantic intent for user-facing feedback and actions. */
+export type IntentTone = "neutral" | "info" | "success" | "warning" | "danger";
+/** Deliberately small accent palette for data and identity presentation. */
+export type AccentColor = "zinc" | "blue" | "emerald" | "amber" | "red";

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

@@ -0,0 +1,14 @@
+import { type JSX } from "solid-js";
+export type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl";
+export type AvatarProps = {
+    name: string;
+    src?: string | null;
+    icon?: string;
+    alt?: string;
+    fallback?: string;
+    size?: AvatarSize;
+    loading?: "eager" | "lazy";
+    class?: string;
+    style?: JSX.CSSProperties | string;
+};
+export declare function Avatar(props: AvatarProps): JSX.Element;