@k2b/ui 0.46.0 → 0.47.0

package/dist/types/chat/ChatDecision.d.ts

@@ -19,6 +19,11 @@ export type ChatDecisionProps = {
     remember?: ChatDecisionAnswer;
     /** Turns `confirm` and `remember` off; this reason replaces `reason` in the same place. */
     unavailable?: ChatDecisionReason;
+    /**
+     * Turns every answer off until the reason clears, such as no connection, so no answer is lost on the way; this
+     * reason replaces `reason` and `unavailable` in the same place.
+     */
+    waiting?: ChatDecisionReason;
     /** The result line shown in every state but `open`, usually `Chat.Outcome`. */
     outcome?: JSX.Element;
     /** Receives a rejected promise from an answer's `onSelect`. */

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

@@ -5,6 +5,8 @@ export type ComboboxOption = {
     label: string;
     description?: string;
     icon?: string;
+    /** Shown but cannot be picked, such as someone who is already on the list; say why in `description`. */
+    disabled?: boolean;
 };
 export type ComboboxProps = FieldProps & {
     readOnly?: boolean;

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

@@ -1,3 +1,5 @@
+import { type AppWorkspaceSidebarItemStatusProps } from "./AppWorkspaceSidebarItemStatus";
+export type { AppWorkspaceSidebarItemStatusProps } from "./AppWorkspaceSidebarItemStatus";
 import { type LinkNavigateEvent, type NavigationScrollMode } from "@k2b/ssr/nav";
 import { type JSX } from "solid-js";
 import { type AppWorkspaceLayoutState } from "./app-workspace-state";
@@ -361,34 +363,6 @@ export type AppWorkspaceSidebarItemActionsProps = {
     children: JSX.Element;
     visibility?: AppWorkspaceSidebarAccessoryVisibility;
 };
-/**
- * Unread state for the trailing `meta` slot. Every mark keeps a fixed width,
- * so the row keeps its height and the label its start in every state.
- */
-export type AppWorkspaceSidebarItemStatusProps = {
-    /**
-     * A positive number shows a count (above 99 as "99+") and sets the label in
-     * a stronger weight; `true` shows a quiet dot for new activity that should
-     * not draw attention, such as in a muted conversation.
-     */
-    unread?: number | boolean;
-    /** Marks unread items that mention the person with "@". */
-    mention?: boolean;
-    /**
-     * 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
-     * the phrase a screen reader hears, for example "3 waiting". `0` stays as a muted count, for a count that dropped
-     * to zero while the row is still shown; leave the prop out when nothing waits.
-     */
-    waiting?: {
-        count: number;
-        label: string;
-    };
-};
 export type AppWorkspaceNavTreeProps = {
     children: JSX.Element;
     ariaLabel: string;

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

@@ -0,0 +1,30 @@
+import { type JSX } from "solid-js";
+/**
+ * Unread state for the trailing `meta` slot. Every mark keeps a fixed width,
+ * so the row keeps its height and the label its start in every state.
+ */
+export type AppWorkspaceSidebarItemStatusProps = {
+    /**
+     * A positive number shows a count (above 99 as "99+") and sets the label in
+     * a stronger weight; `true` shows a quiet dot for new activity that should
+     * not draw attention, such as in a muted conversation.
+     */
+    unread?: number | boolean;
+    /** Marks unread items that mention the person with "@". */
+    mention?: boolean;
+    /**
+     * 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
+     * the phrase a screen reader hears, for example "3 waiting". `0` stays as a muted count, for a count that dropped
+     * to zero while the row is still shown; leave the prop out when nothing waits.
+     */
+    waiting?: {
+        count: number;
+        label: string;
+    };
+};
+export declare const AppWorkspaceSidebarItemStatus: (props: AppWorkspaceSidebarItemStatusProps) => JSX.Element;

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

@@ -1,4 +1,5 @@
 import { type JSX } from "solid-js";
+import type { DropdownItem } from "../actions/Dropdown";
 import { type AvatarShape } from "../surfaces/Avatar";
 export type DetailPresencePerson = {
     /** Stable key, such as the account id. */
@@ -99,9 +100,25 @@ export type DetailLinkItem = {
     onClick?: (event: MouseEvent) => void;
     /** Defaults to a document. */
     icon?: string;
+    /** Replaces the icon, such as a site's favicon. */
+    leading?: JSX.Element;
+    /** One quiet line below the title, such as where the item lives. */
+    description?: JSX.Element;
     /** Quiet text at the end, such as the other notebook's name. */
     trailing?: JSX.Element;
-};
+    /** For a link to another site, such as `_blank` with `rel="noreferrer"`. */
+    target?: string;
+    rel?: string;
+    /** An item that cannot be opened right now, such as one the person may no longer read. */
+    disabled?: boolean;
+} & ({
+    menuItems?: never;
+    menuLabel?: never;
+} | {
+    /** Further commands on the item, such as "Unlink", only for people who may run them. */
+    menuItems: readonly DropdownItem[];
+    menuLabel: string;
+});
 export type DetailLinksProps = {
     /** What links here. */
     incoming: readonly DetailLinkItem[];
@@ -112,9 +129,20 @@ export type DetailLinksProps = {
     /** Defaults to "Links". */
     title?: string;
     defaultOpen?: boolean;
+    /**
+     * `loading` while links still load after the first paint: a placeholder row keeps their place. `error` keeps the
+     * loaded rows and says that the rest failed, with `onRetry`.
+     */
+    state?: "ready" | "loading" | "error";
+    onRetry?: () => void;
+    /** Rows after the links, such as "Add link" or "Load more", only for people who may use them. */
+    footer?: JSX.Element;
     class?: string;
 };
-/** "Linked from" and "Links to" in one section. Without links it is one row: the title and "None yet". */
+/**
+ * "Linked from" and "Links to" in one section. Without links it is one row: the title and "None yet", followed by the
+ * `footer` when there is one.
+ */
 export declare function DetailLinks(props: DetailLinksProps): JSX.Element;
 export type DetailProperty = {
     id: string;
@@ -134,6 +162,8 @@ export type DetailPropertiesProps = {
     summary?: JSX.Element;
     /** Open by default only when the properties are the object's main content. */
     defaultOpen?: boolean;
+    /** Rows after the facts, such as a command that copies the object's ID. */
+    children?: JSX.Element;
     class?: string;
 };
 /** Facts about the object as label and value rows, such as created, edited, size, and the way to its history. */

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

@@ -18,6 +18,12 @@ export type MobileShellProps = {
      * tab's page loads.
      */
     scroll?: boolean;
+    /**
+     * The content is a screen of its own, such as an open chat on a phone: the footer steps aside, so the content
+     * reaches the bottom edge and pads its safe area itself. Content that opens or leaves such a screen in place calls
+     * `MobileShell.setScreen`.
+     */
+    screen?: boolean;
     class?: string;
 };
 export type MobileShellHeaderProps = {
@@ -37,6 +43,11 @@ export type MobileShellHeaderProps = {
     /** Controls after the title, such as a menu. */
     actions?: JSX.Element;
 };
+/**
+ * Marks the shell around `from` as showing a screen of its own, or not, after the first paint; the server renders
+ * the first state with the `screen` prop. Does nothing outside a shell.
+ */
+declare const setMobileShellScreen: (from: Element, screen: boolean) => void;
 /**
  * Keeps a mounted shell working: the footer height on the body, which the portalled toast rail reads, the room a
  * persistent toast takes from the scroll area, the scroll area's edge fade, and immediate feedback for link taps.
@@ -86,5 +97,6 @@ declare function MobileShellSidebar(props: MobileShellSidebarProps): JSX.Element
 export declare const MobileShell: typeof MobileShellRoot & {
     Header: typeof MobileShellHeader;
     Sidebar: typeof MobileShellSidebar;
+    setScreen: typeof setMobileShellScreen;
 };
 export default MobileShell;

package/dist/types/layout/detail-sections-messages.d.ts

@@ -50,6 +50,8 @@ declare const detailSectionMessages: import("@k2b/stdlib").Catalog<{
         names: string;
         more: number;
     }) => string;
+    linksLoading: string;
+    linksFailed: string;
     properties: string;
     tags: string;
 }>;

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

@@ -3,6 +3,7 @@ export type { AppOverviewCardsProps, AppOverviewEmptyStateProps, AppOverviewPane
 export { default as AppOverview } from "./AppOverview";
 export type { AppWorkspaceBottomDrawerHeight, AppWorkspaceBottomDrawerProps, AppWorkspaceContentProps, AppWorkspaceDetailProps, AppWorkspaceDetailWidth, AppWorkspaceHeadProps, AppWorkspaceMainPaneProps, AppWorkspaceMainProps, AppWorkspaceNavTreeItemProps, AppWorkspaceNavTreeMove, AppWorkspaceNavTreeProps, AppWorkspaceProps, AppWorkspaceSidebarAccessoryVisibility, AppWorkspaceSidebarBodyProps, AppWorkspaceSidebarIconActionProps, AppWorkspaceSidebarIconActionTone, AppWorkspaceSidebarIconGridProps, AppWorkspaceSidebarItemActionProps, AppWorkspaceSidebarItemActionsProps, AppWorkspaceSidebarItemIconProps, AppWorkspaceSidebarItemLabelProps, AppWorkspaceSidebarItemMetaProps, AppWorkspaceSidebarItemProps, AppWorkspaceSidebarItemStatusProps, AppWorkspaceSidebarItemTone, AppWorkspaceSidebarProps, AppWorkspaceSidebarSectionProps, AppWorkspaceSidebarVisibility, AppWorkspaceWidthShare, } from "./AppWorkspace";
 export { appWorkspaceDetailElementId, default as AppWorkspace } from "./AppWorkspace";
+export { AppWorkspaceSidebarItemStatus } from "./AppWorkspaceSidebarItemStatus";
 export { watchAppHostWidth } from "./app-host-width";
 export type { AppWorkspaceControllerOptions } from "./app-workspace-controller";
 export { installAppWorkspaceController, parkWorkspaceDetailDrawers } from "./app-workspace-controller";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2b/ui",
-  "version": "0.46.0",
+  "version": "0.47.0",
   "description": "Production-ready components for SolidJS applications.",
   "repository": {
     "type": "git",