@k2b/ui 0.1.0-rc.0 → 0.1.1

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

@@ -0,0 +1,375 @@
+declare const uiMessages: import("@k2b/stdlib").Catalog<{
+    actions: string;
+    add: string;
+    addTag: string;
+    addImage: string;
+    attachments: string;
+    assistant: string;
+    avatarLabel: ({ name }: {
+        name: string;
+    }) => string;
+    all: string;
+    calendar: string;
+    clear: string;
+    clearDate: string;
+    clearSelection: string;
+    chooseOption: string;
+    close: string;
+    closeDialog: string;
+    copied: string;
+    copy: string;
+    closeLightbox: string;
+    couldNotLoadData: string;
+    datePicker: string;
+    dataTable: string;
+    datePresets: string;
+    decreaseValue: string;
+    download: string;
+    downloadAsZip: string;
+    downloadImage: string;
+    dropFiles: string;
+    dropToUpload: string;
+    dropdownMenu: string;
+    durationPresets: string;
+    filterOptions: string;
+    fileTypeNotAccepted: string;
+    imageLightbox: string;
+    imageNavigation: string;
+    increaseValue: string;
+    loading: string;
+    hidePassword: string;
+    noColumns: string;
+    noData: string;
+    noRecords: string;
+    noTagsYet: string;
+    noResultsFound: string;
+    nextImage: string;
+    noOptions: string;
+    optionsCouldNotLoad: string;
+    noResults: string;
+    nothingHere: string;
+    nothingToShow: string;
+    no: string;
+    options: string;
+    pagination: string;
+    pageOf: ({ page, total }: {
+        page: number;
+        total: number;
+    }) => string;
+    pickDate: string;
+    previousImage: string;
+    previousMonth: string;
+    previousPage: string;
+    previousYear: string;
+    nextMonth: string;
+    nextPage: string;
+    nextYear: string;
+    goToPage: ({ page }: {
+        page: number;
+    }) => string;
+    retry: string;
+    reset: string;
+    required: string;
+    rename: string;
+    delete: string;
+    remove: string;
+    removeTag: string;
+    search: string;
+    searchLabel: string;
+    spotlightNoResults: string;
+    searchFailed: string;
+    searchResults: string;
+    save: string;
+    saveShortcut: string;
+    sectionsLabel: ({ title }: {
+        title: string;
+    }) => string;
+    searchOptions: string;
+    select: string;
+    selectMatchingOption: string;
+    selectOption: string;
+    suggestions: string;
+    suggestionsCouldNotLoad: string;
+    showPassword: string;
+    time: string;
+    timeLabel: ({ label }: {
+        label: string;
+    }) => string;
+    completionSuggestions: string;
+    contextMenu: string;
+    unknownUser: string;
+    uploading: string;
+    chooseFile: string;
+    chooseFiles: string;
+    chooseMatchingFile: string;
+    checkingOptions: string;
+    checkingOptionsLoading: string;
+    noMatchingOption: string;
+    noOptionsFound: string;
+    typeToSearch: string;
+    showGridView: string;
+    showListView: string;
+    start: string;
+    end: string;
+    addFileFolderUpload: string;
+    addPane: string;
+    addToChat: string;
+    attachFiles: string;
+    addGuidance: string;
+    calendarView: string;
+    openDate: ({ label }: {
+        label: string;
+    }) => string;
+    createEventOn: ({ label }: {
+        label: string;
+    }) => string;
+    hiddenOverlappingEvents: ({ count }: {
+        count: number;
+    }) => string;
+    today: string;
+    day: string;
+    week: string;
+    weekShort: string;
+    month: string;
+    year: string;
+    allDay: string;
+    noEvents: string;
+    previous: string;
+    next: string;
+    moveEvent: string;
+    resizeEvent: string;
+    cancel: string;
+    chat: string;
+    chooseModel: string;
+    closeWindow: string;
+    code: string;
+    codeLabel: ({ title }: {
+        title: string;
+    }) => string;
+    column: ({ number }: {
+        number: number;
+    }) => string;
+    commands: string;
+    dropFilesToAttach: string;
+    conversation: string;
+    conversationMessages: ({ label }: {
+        label: string;
+    }) => string;
+    dialogTabs: string;
+    files: string;
+    chooseFileToPreview: string;
+    change: string;
+    changeImage: string;
+    cropArea: string;
+    cropPreview: string;
+    discardChanges: string;
+    discardUnsavedFile: string;
+    downloadFailed: string;
+    failedLoadFiles: string;
+    failedLoadImage: string;
+    folderEmpty: string;
+    folderSelected: string;
+    newFile: string;
+    newFileName: string;
+    newFolder: string;
+    newFolderName: string;
+    fileActions: string;
+    actionsFor: ({ name }: {
+        name: string;
+    }) => string;
+    fileSaved: string;
+    pickFileFromTree: string;
+    imageProcessingFailed: string;
+    preparingImage: string;
+    processingImage: string;
+    removeImage: string;
+    rotateRight: string;
+    selectedImage: string;
+    selectFile: string;
+    spaceEmpty: string;
+    uploadFiles: string;
+    filterIcons: string;
+    loadEarlier: string;
+    loadingConversation: string;
+    loadingFiles: string;
+    loadingMessages: string;
+    failed: string;
+    generating: string;
+    loadOlderMessages: string;
+    loadingOlderMessages: string;
+    couldNotLoadOlderMessages: string;
+    couldNotLoadEarlierMessages: string;
+    couldNotPostMessage: string;
+    message: string;
+    messageActions: string;
+    messageComposer: string;
+    messageInput: string;
+    confirmation: string;
+    confirm: string;
+    dialog: string;
+    discard: string;
+    error: string;
+    form: string;
+    filterActions: string;
+    info: string;
+    interactiveLineChart: string;
+    interactiveMap: string;
+    interactiveTimeline: string;
+    ok: string;
+    success: string;
+    model: string;
+    input: string;
+    output: string;
+    loopTotal: string;
+    remaining: string;
+    notConfigured: string;
+    unknown: string;
+    system: string;
+    tool: string;
+    user: string;
+    useColor: string;
+    useTransparent: string;
+    series: string;
+    waiting: string;
+    templateEditorPlaceholder: string;
+    templatePreview: string;
+    lastRequestContext: string;
+    contextWindowUsed: string;
+    contextUsageUnavailable: string;
+    contextUsageUnavailableWithWindow: ({ window }: {
+        window: string;
+    }) => string;
+    tokensUsed: ({ total }: {
+        total: string;
+    }) => string;
+    tokensUsedPercent: ({ total, percent }: {
+        total: string;
+        percent: number;
+    }) => string;
+    moveDown: string;
+    moveUp: string;
+    moveNamedDown: ({ label }: {
+        label: string;
+    }) => string;
+    moveNamedUp: ({ label }: {
+        label: string;
+    }) => string;
+    rowAction: string;
+    addToNamed: ({ name }: {
+        name: string;
+    }) => string;
+    insertBeforeNamed: ({ name }: {
+        name: string;
+    }) => string;
+    insertAtEnd: string;
+    addPaneSide: ({ side, name }: {
+        side: "left" | "right" | "top" | "bottom";
+        name: string;
+    }) => string;
+    discardUnsavedChanges: string;
+    unsavedChangesTitle: string;
+    tagName: string;
+    name: string;
+    color: string;
+    tagCouldNotBeSaved: string;
+    tagActionFailed: string;
+    tagsPlaceholder: string;
+    tagsAdded: ({ tags }: {
+        tags: string;
+    }) => string;
+    tagsRemoved: ({ tags }: {
+        tags: string;
+    }) => string;
+    noFiles: string;
+    noLogEntries: string;
+    noPreview: string;
+    openPreview: string;
+    paneTabs: string;
+    paneWorkspace: string;
+    pdfPreview: string;
+    pdfPreviewHttpError: ({ status }: {
+        status: number;
+    }) => string;
+    pickIcon: string;
+    postMessage: string;
+    preview: string;
+    previewPdf: string;
+    renderPdfPreview: string;
+    queueMessage: string;
+    queueing: string;
+    sending: string;
+    steering: string;
+    writeMessage: string;
+    openInNewTab: ({ name }: {
+        name: string;
+    }) => string;
+    closeNamed: ({ name }: {
+        name: string;
+    }) => string;
+    goToImage: ({ index }: {
+        index: number;
+    }) => string;
+    pinDigit: ({ index, total }: {
+        index: number;
+        total: number;
+    }) => string;
+    removeNamed: ({ name }: {
+        name: string;
+    }) => string;
+    resizeCrop: ({ handle }: {
+        handle: string;
+    }) => string;
+    range: string;
+    resizePanes: string;
+    resetMapView: string;
+    resetTimelineView: string;
+    retryOlderMessages: string;
+    saveChanges: string;
+    saving: string;
+    sendMessage: string;
+    startConversation: string;
+    steerResponse: string;
+    stopResponse: string;
+    stopping: string;
+    unsaved: string;
+    unsavedChangeLabel: ({ count }: {
+        count: number;
+    }) => string;
+    noUnsavedChanges: string;
+    moveWindow: ({ title }: {
+        title: string;
+    }) => string;
+    resizeWindow: string;
+    window: string;
+    zoomIn: string;
+    zoomOut: string;
+    binaryFile: string;
+    boldShortcut: string;
+    bulletListShortcut: string;
+    heading1Shortcut: string;
+    heading2Shortcut: string;
+    heading3Shortcut: string;
+    inlineCodeShortcut: string;
+    italicShortcut: string;
+    linkShortcut: string;
+    markdownFormatting: string;
+    numberedListShortcut: string;
+    quote: string;
+    delimitedFileEmpty: string;
+    edit: string;
+    emptyFile: string;
+    failedLoadFile: string;
+    noInlinePreview: string;
+    previewLimited: string;
+    textEditor: string;
+    audioUnsupported: string;
+    videoUnsupported: string;
+    yes: string;
+}>;
+export type UiMessages = ReturnType<(typeof uiMessages)["resolve"]>["t"];
+/** Generic component chrome owned by @k2b/ui, resolved from the inherited render locale. */
+export declare const useUiMessages: () => (() => UiMessages);
+/** Browser-only imperative UI (for example prompts) inherits the document locale. */
+export declare const resolveUiMessages: (locale?: string) => UiMessages;
+export declare const checkUiMessages: () => import("@k2b/stdlib").CatalogIssue[];
+export {};

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

@@ -0,0 +1,29 @@
+import { type JSX } from "solid-js";
+export type AppOverviewProps = {
+    title: string;
+    subtitle?: string;
+    icon: string;
+    class?: string;
+    children: JSX.Element;
+};
+export type AppOverviewPanelProps = {
+    title: string;
+    description?: JSX.Element;
+    toolbar?: JSX.Element;
+    class?: string;
+    children: JSX.Element;
+};
+export type AppOverviewEmptyStateProps = {
+    title: string;
+    description?: JSX.Element;
+    icon?: string;
+    class?: string;
+    children?: JSX.Element;
+};
+type AppOverviewComponent = ((props: AppOverviewProps) => JSX.Element) & {
+    Main: (props: AppOverviewPanelProps) => JSX.Element;
+    Aside: (props: AppOverviewPanelProps) => JSX.Element;
+    EmptyState: (props: AppOverviewEmptyStateProps) => JSX.Element;
+};
+declare const AppOverview: AppOverviewComponent;
+export default AppOverview;

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

@@ -0,0 +1,254 @@
+import { type LinkNavigateEvent, type NavigationScrollMode } from "@k2b/ssr/nav";
+import { type JSX } from "solid-js";
+import { type AppWorkspaceLayoutState } from "./app-workspace-state";
+export type AppWorkspaceProps = {
+    children: JSX.Element;
+    class?: string;
+    resizable?: boolean;
+    /**
+     * Restores a persisted layout when the workspace mounts. Persistence itself
+     * stays app-owned — the package reads and writes nothing on its own — but
+     * the resize handles work without it.
+     */
+    layoutState?: () => AppWorkspaceLayoutState | null | undefined;
+    /** Called with the full layout whenever a resize settles. Persist it here. */
+    onLayoutChange?: (state: AppWorkspaceLayoutState) => void;
+    /**
+     * Opt out of the built-in controller. Only needed when the application calls
+     * `installAppWorkspaceController` itself — installing twice would double up
+     * every listener.
+     */
+    controller?: false;
+};
+export type AppWorkspaceLayoutStateProviderProps = {
+    children: JSX.Element;
+    state: AppWorkspaceLayoutState | null | undefined;
+};
+export type AppWorkspaceContentProps = {
+    children: JSX.Element;
+    class?: string;
+};
+export type AppWorkspaceMainProps = {
+    children: JSX.Element;
+    class?: string;
+    mobilePane?: string;
+    scroll?: boolean;
+    scrollPreserveKey?: string | false;
+    "aria-busy"?: boolean | "true" | "false";
+};
+export type AppWorkspaceMainPaneProps = {
+    id: string;
+    label: string;
+    surface?: "default" | "navigation";
+    open?: boolean;
+    resizable?: boolean;
+    resizeShadow?: boolean;
+    defaultSize?: number;
+    minSize?: number;
+    maxSize?: number;
+    class?: string;
+    scroll?: boolean;
+    children: JSX.Element;
+};
+export type AppWorkspaceDetailWidth = "sm" | "md" | "lg" | "xl";
+export type AppWorkspaceDetailProps = {
+    children: JSX.Element;
+    open: boolean;
+    id: string;
+    class?: string;
+    width?: AppWorkspaceDetailWidth;
+    viewTransitionName?: string;
+    resizable?: boolean;
+    minWidth?: number;
+    maxWidth?: number;
+};
+export type AppWorkspaceBottomDrawerHeight = "sm" | "md" | "lg";
+export type AppWorkspaceBottomDrawerProps = {
+    children: JSX.Element;
+    open: boolean;
+    id: string;
+    class?: string;
+    height?: AppWorkspaceBottomDrawerHeight;
+    minHeight?: number;
+    maxHeight?: number;
+    viewTransitionName?: string;
+    resizable?: boolean;
+};
+export type AppWorkspaceSidebarProps = {
+    children: JSX.Element;
+    class?: string;
+    resizable?: boolean;
+    resizeShadow?: boolean;
+    collapsible?: boolean;
+    defaultSize?: number;
+    minSize?: number;
+    maxSize?: number;
+};
+export type AppWorkspaceSidebarMobileTriggerProps = {
+    label: string;
+};
+export type AppWorkspaceSidebarMobileProps = {
+    children: JSX.Element;
+};
+export type AppWorkspaceSidebarMobileItemsProps = {
+    children: JSX.Element;
+    scrollPreserveKey?: string | false;
+};
+export type AppWorkspaceSidebarVisibility = "always" | "expanded" | "collapsed";
+export type AppWorkspaceSidebarAccessoryVisibility = "always" | "hover";
+export type AppWorkspaceSidebarBodyProps = {
+    children: JSX.Element;
+    class?: string;
+    scrollPreserveKey?: string | false;
+    sidebarMode?: AppWorkspaceSidebarVisibility;
+};
+export type AppWorkspaceSidebarSectionProps = AppWorkspaceSidebarBodyProps & {
+    title?: string;
+    actions?: JSX.Element;
+};
+export type AppWorkspaceSidebarItemTone = "default" | "success" | "danger";
+export type AppWorkspaceSidebarIconActionTone = "default" | "success" | "danger";
+export type AppWorkspaceSidebarItemProps = {
+    children: JSX.Element;
+    href?: string;
+    /** Document navigation by default; opt into enhanced navigation only when the owning island applies the target state. */
+    navigation?: "enhanced" | "document";
+    replace?: boolean;
+    scroll?: NavigationScrollMode;
+    onNavigate?: (event: LinkNavigateEvent) => void | Promise<void>;
+    onClick?: (event: MouseEvent) => void;
+    active?: boolean;
+    activeClass?: string;
+    disabled?: boolean;
+    icon?: string;
+    meta?: JSX.Element;
+    metaVisibility?: AppWorkspaceSidebarAccessoryVisibility;
+    actions?: JSX.Element;
+    tone?: AppWorkspaceSidebarItemTone;
+    title?: string;
+    viewTransitionName?: string;
+    class?: string;
+    depth?: number;
+    actionIcon?: string;
+    actionLabel?: string;
+    onActionClick?: (event: MouseEvent) => void;
+    data?: Record<string, string | number | boolean | null | undefined>;
+    sidebarMode?: AppWorkspaceSidebarVisibility;
+};
+export type AppWorkspaceSidebarIconGridProps = AppWorkspaceSidebarBodyProps & {
+    title?: string;
+    columns?: 2 | 3;
+};
+export type AppWorkspaceSidebarIconActionProps = {
+    href?: string | null;
+    /** Document navigation by default; opt into enhanced navigation only when the owning island applies the target state. */
+    navigation?: "enhanced" | "document";
+    replace?: boolean;
+    scroll?: NavigationScrollMode;
+    onNavigate?: (event: LinkNavigateEvent) => void | Promise<void>;
+    icon: string;
+    label: string;
+    active?: boolean;
+    disabled?: boolean;
+    tone?: AppWorkspaceSidebarIconActionTone;
+    viewTransitionName?: string;
+    onClick?: (event: MouseEvent) => void;
+    sidebarMode?: AppWorkspaceSidebarVisibility;
+};
+export type AppWorkspaceSidebarItemIconProps = {
+    icon?: string;
+    children?: JSX.Element;
+};
+export type AppWorkspaceSidebarItemLabelProps = {
+    children: JSX.Element;
+    marquee?: boolean;
+};
+export type AppWorkspaceSidebarItemMetaProps = {
+    children: JSX.Element;
+    visibility?: AppWorkspaceSidebarAccessoryVisibility;
+};
+export type AppWorkspaceSidebarItemActionProps = {
+    icon?: string;
+    label: string;
+    /** Hide the action on fine pointers until the row is hovered or keyboard-focused. */
+    visibility?: AppWorkspaceSidebarAccessoryVisibility;
+    href?: string;
+    navigation?: "enhanced" | "document";
+    onSelect?: (event: MouseEvent) => void;
+    children?: JSX.Element;
+};
+export type AppWorkspaceSidebarItemActionsProps = {
+    children: JSX.Element;
+    visibility?: AppWorkspaceSidebarAccessoryVisibility;
+};
+export type AppWorkspaceNavTreeProps = {
+    children: JSX.Element;
+    ariaLabel: string;
+    selectedId?: string | null;
+    expandedIds?: readonly string[];
+    defaultExpandedIds?: readonly string[];
+    onSelectedIdChange?: (id: string) => void;
+    onExpandedIdsChange?: (ids: readonly string[]) => void;
+    indented?: boolean;
+    class?: string;
+};
+export type AppWorkspaceNavTreeItemProps = {
+    id: string;
+    label: JSX.Element;
+    children?: JSX.Element;
+    href?: string;
+    /** Document navigation by default; opt into enhanced navigation only when the owning island applies the target state. */
+    navigation?: "enhanced" | "document";
+    replace?: boolean;
+    scroll?: NavigationScrollMode;
+    onNavigate?: (event: LinkNavigateEvent) => void | Promise<void>;
+    onSelect?: (event: MouseEvent) => void;
+    disabled?: boolean;
+    icon?: string;
+    /** Replaces `icon` while this branch is expanded and makes the icon the disclosure target. */
+    expandedIcon?: string;
+    meta?: JSX.Element;
+    metaVisibility?: AppWorkspaceSidebarAccessoryVisibility;
+    actions?: JSX.Element;
+    tone?: AppWorkspaceSidebarItemTone;
+    title?: string;
+    viewTransitionName?: string;
+    class?: string;
+    onDragEnter?: JSX.EventHandlerUnion<HTMLDivElement, DragEvent>;
+    onDragOver?: JSX.EventHandlerUnion<HTMLDivElement, DragEvent>;
+    onDragLeave?: JSX.EventHandlerUnion<HTMLDivElement, DragEvent>;
+    onDrop?: JSX.EventHandlerUnion<HTMLDivElement, DragEvent>;
+};
+type AppWorkspaceNavTreeComponent = ((props: AppWorkspaceNavTreeProps) => JSX.Element) & {
+    Item: (props: AppWorkspaceNavTreeItemProps) => JSX.Element;
+};
+type AppWorkspaceComponent = ((props: AppWorkspaceProps) => JSX.Element) & {
+    LayoutStateProvider: (props: AppWorkspaceLayoutStateProviderProps) => JSX.Element;
+    Content: (props: AppWorkspaceContentProps) => JSX.Element;
+    Main: (props: AppWorkspaceMainProps) => JSX.Element;
+    MainPane: (props: AppWorkspaceMainPaneProps) => JSX.Element;
+    Detail: (props: AppWorkspaceDetailProps) => JSX.Element;
+    BottomDrawer: (props: AppWorkspaceBottomDrawerProps) => JSX.Element;
+    Sidebar: (props: AppWorkspaceSidebarProps) => JSX.Element;
+    SidebarMobileTrigger: (props: AppWorkspaceSidebarMobileTriggerProps) => JSX.Element;
+    SidebarMobile: (props: AppWorkspaceSidebarMobileProps) => JSX.Element;
+    SidebarMobileItems: (props: AppWorkspaceSidebarMobileItemsProps) => JSX.Element;
+    SidebarMobileBody: (props: AppWorkspaceSidebarBodyProps) => JSX.Element;
+    SidebarDesktop: (props: {
+        children: JSX.Element;
+    }) => JSX.Element;
+    SidebarSection: (props: AppWorkspaceSidebarSectionProps) => JSX.Element;
+    SidebarBody: (props: AppWorkspaceSidebarBodyProps) => JSX.Element;
+    SidebarFooter: (props: AppWorkspaceSidebarBodyProps) => JSX.Element;
+    SidebarItem: (props: AppWorkspaceSidebarItemProps) => JSX.Element;
+    SidebarItemIcon: (props: AppWorkspaceSidebarItemIconProps) => JSX.Element;
+    SidebarItemLabel: (props: AppWorkspaceSidebarItemLabelProps) => JSX.Element;
+    SidebarItemMeta: (props: AppWorkspaceSidebarItemMetaProps) => JSX.Element;
+    SidebarItemAction: (props: AppWorkspaceSidebarItemActionProps) => JSX.Element;
+    SidebarItemActions: (props: AppWorkspaceSidebarItemActionsProps) => JSX.Element;
+    NavTree: AppWorkspaceNavTreeComponent;
+    SidebarIconGrid: (props: AppWorkspaceSidebarIconGridProps) => JSX.Element;
+    SidebarIconAction: (props: AppWorkspaceSidebarIconActionProps) => JSX.Element;
+};
+declare const AppWorkspace: AppWorkspaceComponent;
+export default AppWorkspace;

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

@@ -0,0 +1,16 @@
+import { type JSX } from "solid-js";
+export type DataPanelProps = {
+    title: JSX.Element;
+    subtitle?: JSX.Element;
+    actions?: JSX.Element;
+    search?: JSX.Element;
+    filters?: JSX.Element;
+    children?: JSX.Element;
+    error?: string | null;
+    empty?: JSX.Element;
+    isEmpty?: boolean;
+    footer?: JSX.Element;
+    as?: "h1" | "h2";
+    class?: string;
+};
+export declare function DataPanel(props: DataPanelProps): JSX.Element;