akanjs 3.0.0-beta.2 → 3.0.0-beta.20

package/types/ui/Reference/index.d.ts

@@ -1,7 +1,3 @@
-export { Collapse } from "./Collapse.d.ts";
-export { dictText } from "./dictText.d.ts";
-export { Code, Panel } from "./Panel.d.ts";
-export { Segmented, type SegmentedItem, segmentItemClass, segmentTrackClass } from "./Segmented.d.ts";
-export { SummaryCard, SummaryGrid } from "./Summary.d.ts";
-export { docDash, docPill, docUi, type Tone } from "./style.d.ts";
-export { Section, Toolbar, ToolbarField } from "./Toolbar.d.ts";
+export { dictText, docDash, docPill, docUi, type Tone } from "./docUi.d.ts";
+export { Code, Collapse, DocTable, Panel, Section, SummaryCard, SummaryGrid, Toolbar, ToolbarField } from "./Panel.d.ts";
+export { Segmented, type SegmentedItem } from "./Segmented.d.ts";

package/types/ui/Refresh.d.ts

@@ -1,4 +1,4 @@
-import type { ReactElement } from "react";
+import { type ReactElement } from "react";
 interface RefreshProps {
     children: ReactElement;
     onRefresh: () => Promise<void>;

package/types/ui/ScreenNavigator.d.ts

@@ -3,11 +3,11 @@ interface ScreenNavigatorProps {
     children: React.ReactNode;
     setMenu?: (menu: string) => void;
     menus: string[];
-    /** Names this navigator for the in-page agent. Without it it publishes nothing — two on one screen would share a name. */
+    /** Names this navigator for the in-page agent; without it it publishes nothing. */
     namespace?: string;
 }
 export declare const ScreenNavigator: {
-    ({ children, setMenu, menus, namespace, }: ScreenNavigatorProps): import("react/jsx-runtime").JSX.Element;
+    ({ children, setMenu, menus, namespace }: ScreenNavigatorProps): import("react/jsx-runtime").JSX.Element;
     NavbarItem: ({ menu, children, className }: {
         menu: string;
         children: ReactNode;

package/types/ui/Select.d.ts

@@ -6,45 +6,30 @@ interface LabelOption<T> {
 }
 type Options<T> = T[] | LabelOption<T>[] | EnumInstance<string, T>;
 export interface SelectProps<T extends string | number | boolean | null | undefined, Multiple extends boolean = false, Searchable extends boolean = false, Option extends Options<T> = Options<T>> {
-    /** Optional label shown above the selector. */
     label?: ReactNode;
-    /** Optional tooltip/help description next to the label. */
     desc?: ReactNode;
     labelClassName?: string;
     className?: string;
-    /** Controlled selected value, or selected values when multiple is true. */
     value: Multiple extends true ? T[] : T;
-    /** Option values, label/value pairs, or an Akan enum instance. */
     options: Searchable extends true ? (T extends string ? Option : LabelOption<T>[]) : Option;
-    /** Enable selecting multiple values. */
     multiple?: Multiple;
-    /** Enable search input inside the selector. */
     searchable?: Searchable;
     placeholder?: string;
     selectClassName?: string;
     selectorClassName?: string;
     selectedClassName?: string;
-    /** Allow no value to be selected: offers a clear row and the clear button. */
+    /** Offers a clear row and a clear button. */
     nullable?: boolean;
-    /** Disable open and selection behavior. */
     disabled?: boolean;
-    /** Called when the dropdown opens. */
+    /** Shows a spinner in place of the empty placeholder. */
+    loading?: boolean;
     onOpen?: () => void;
-    /** Controlled change callback. Receives next and previous value. */
     onChange: Multiple extends true ? (value: T[], prev: T[]) => void : (value: T, prev: T) => void;
-    /** Optional remote/local search callback. */
+    /** Replaces local filtering; debounced 300ms and never called with empty text. */
     onSearch?: (text: string) => void;
-    /** Placeholder for a selector with no options to offer. */
     empty?: ReactNode;
-    /** Custom option renderer. */
     renderOption?: (value: T) => ReactNode;
-    /** Custom selected value renderer. */
     renderSelected?: (value: T) => ReactNode;
 }
-/**
- * Select. Resolves to a route-scoped override when a `page/**\/_overrides.tsx` in the route's
- * ancestry declares one, otherwise renders {@link DefaultSelect}. The public generic signature is
- * preserved, so `<Select<MyEnum, true> …/>` still infers the value/onChange shape.
- */
 export declare const Select: <T extends string | number | boolean | null | undefined, Multiple extends boolean = false, Searchable extends boolean = false, Option extends Options<T> = Options<T>>(props: SelectProps<T, Multiple, Searchable, Option>) => import("react").ReactElement<SelectProps<T, Multiple, Searchable, Option>, string | import("react").JSXElementConstructor<any>>;
 export {};

package/types/ui/Signal/Endpoint.d.ts

@@ -0,0 +1,43 @@
+import type { SerializedEndpoint } from "akanjs/signal";
+import { type ReactNode } from "react";
+interface ArgSectionProps {
+    label: string;
+    children: ReactNode;
+}
+export declare const ArgSection: ({ label, children }: ArgSectionProps) => import("react/jsx-runtime").JSX.Element;
+interface EndpointCollapseProps {
+    refName: string;
+    endpointKey: string;
+    endpoint: SerializedEndpoint;
+    open?: boolean;
+    badge: ReactNode;
+    title: string;
+    extraBadge?: ReactNode;
+    children: ReactNode;
+}
+export declare const EndpointCollapse: ({ refName, endpointKey, endpoint, open, badge, title, extraBadge, children, }: EndpointCollapseProps) => import("react/jsx-runtime").JSX.Element;
+interface EndpointInterfaceProps {
+    className?: string;
+    refName: string;
+    endpointKey: string;
+    endpoint: SerializedEndpoint;
+    argSections: {
+        label: string;
+        args: SerializedEndpoint["args"];
+    }[];
+    returnsLabel: string;
+}
+export declare const EndpointInterface: ({ className, refName, endpointKey, endpoint, argSections, returnsLabel, }: EndpointInterfaceProps) => import("react/jsx-runtime").JSX.Element;
+export interface WsEndpointProps {
+    refName: string;
+    endpointKey: string;
+    endpoint: SerializedEndpoint;
+    open?: boolean;
+}
+export declare const WsEndpoint: ({ doc, test, ...props }: WsEndpointProps & {
+    doc: ReactNode;
+    test: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+export type Messages = string | boolean | object[] | null;
+export declare const appendMessage: (prev: Messages, data: unknown) => Messages;
+export {};

package/types/ui/Signal/WebSocket.d.ts

@@ -1,12 +1,35 @@
 import type { FetchProxy } from "akanjs/fetch";
+import type { SerializedEndpoint } from "akanjs/signal";
+import { type WsEndpointProps } from "./Endpoint.d.ts";
 declare function WebSocket(): import("react/jsx-runtime").JSX.Element;
 declare namespace WebSocket {
     var Endpoints: ({ refName, fetch, openAll, search }: WebSocketEndpointsProps) => import("react/jsx-runtime").JSX.Element;
 }
 export default WebSocket;
+export declare function Message(): import("react/jsx-runtime").JSX.Element;
+export declare namespace Message {
+    var Endpoint: ({ refName, endpointKey, endpoint, open }: WsEndpointProps) => import("react/jsx-runtime").JSX.Element;
+    var Interface: ({ refName, endpointKey, endpoint }: WsInterfaceProps) => import("react/jsx-runtime").JSX.Element;
+    var Try: ({ endpointKey, endpoint }: MessageTryProps) => import("react/jsx-runtime").JSX.Element;
+}
+export declare function PubSub(): import("react/jsx-runtime").JSX.Element;
+export declare namespace PubSub {
+    var Endpoint: ({ refName, endpointKey, endpoint, open }: WsEndpointProps) => import("react/jsx-runtime").JSX.Element;
+    var Interface: ({ refName, endpointKey, endpoint }: WsInterfaceProps) => import("react/jsx-runtime").JSX.Element;
+    var Try: ({ refName, endpointKey, endpoint }: WsInterfaceProps) => import("react/jsx-runtime").JSX.Element;
+}
 interface WebSocketEndpointsProps {
     refName: string;
     fetch: FetchProxy;
     openAll?: boolean;
     search?: string;
 }
+interface WsInterfaceProps {
+    refName: string;
+    endpointKey: string;
+    endpoint: SerializedEndpoint;
+}
+interface MessageTryProps {
+    endpointKey: string;
+    endpoint: SerializedEndpoint;
+}

package/types/ui/Signal/endpointEntries.d.ts

@@ -10,11 +10,9 @@ export declare const endpointEntriesOf: (refName: string, fetch: FetchProxy) =>
 export declare const matchesSearch: (key: string, path: string, search: string) => boolean;
 /** `None` refuses every caller and is never badged, so it is not a name anyone filters by either. */
 export declare const guardsOf: (endpoint: SerializedEndpoint) => string[];
-/** Naming no guard is `Public` spelled by omission — both are reachable by every caller, so the filter reads them
- *  as the same thing even though only the explicit one carries a badge. */
+/** No guard is `Public` by omission, so the filter reads both alike though only the explicit one is badged. */
 export declare const isPublicEndpoint: (endpoint: SerializedEndpoint) => boolean;
 /** Every guard name the serialized signals declare — the app's own authorization vocabulary, not a fixed role list. */
 export declare const guardNamesOf: (fetch: FetchProxy) => string[];
-/** No selection is no filter, and a selection is a claim about the guard list — so a public endpoint answers to
- *  `Public` alone rather than surviving every other filter. */
+/** No selection is no filter; a public endpoint answers to `Public` alone rather than surviving every filter. */
 export declare const matchesGuards: (endpoint: SerializedEndpoint, selected: string[]) => boolean;

package/types/ui/Signal/index.d.ts

@@ -1,11 +1,9 @@
 import Arg from "./Arg.d.ts";
 import Doc from "./Doc.d.ts";
 import Listener from "./Listener.d.ts";
-import Message from "./Message.d.ts";
 import Object from "./Object.d.ts";
-import PubSub from "./PubSub.d.ts";
 import RestApi from "./RestApi.d.ts";
-import WebSocket from "./WebSocket.d.ts";
+import WebSocket, { Message, PubSub } from "./WebSocket.d.ts";
 export declare const Signal: {
     Doc: typeof Doc;
     Object: typeof Object;

package/types/ui/Signal/style.d.ts

@@ -3,8 +3,7 @@ export declare const signalUi: {
     inputRow: string;
     inputLabel: string;
 };
-/** Only a mutation is a POST — enumerating that side leaves a `prompt` a GET beside the queries, and lets a
- *  read-shaped type added later inherit the right verb rather than be mislabelled. */
+/** Only a mutation is a POST, so `prompt` and any read-shaped type added later stay GETs. */
 export declare const getMethodLabel: (type: string) => string;
 export declare const getMethodBadgeClassName: (type: string) => string;
 export declare const getWsBadgeClassName: (type: string) => string;

package/types/ui/Switch.d.ts

@@ -4,11 +4,7 @@ export interface SwitchProps {
     disabled?: boolean;
     onChange?: (checked: boolean) => void;
     className?: string;
-    /** 켜짐 상태 색. daisyui `toggle-accent/toggle-primary` 대체. */
+    /** The checked-state fill. */
     variant?: "primary" | "accent" | "success";
 }
-/**
- * 순수 Tailwind 스위치 (`<button role="switch">`). daisyui `toggle`/`swap` 대체.
- * `<button>` 이라 포커스·Space/Enter 토글이 네이티브로 제공된다. controlled/uncontrolled 모두 지원.
- */
 export declare const Switch: ({ checked, defaultChecked, disabled, onChange, className, variant, }: SwitchProps) => import("react/jsx-runtime").JSX.Element;

package/types/ui/System/CSR.d.ts

@@ -5,7 +5,7 @@ export declare const CSR: {
     ({ children }: {
         children: ReactNode;
     }): import("react/jsx-runtime").JSX.Element;
-    Provider: ({ className, appName, params, head, manifest, env, theme, prefix, children, gaTrackingId, fonts, layoutStyle, reconnect, wsConnect, of, }: CSRProviderProps) => import("react/jsx-runtime").JSX.Element;
+    Provider: ({ className, appName, params, head, manifest, env, theme, prefix, children, fonts, layoutStyle, reconnect, wsConnect, of, }: CSRProviderProps) => import("react/jsx-runtime").JSX.Element;
     Wrapper: ({ children, lang, head, manifest, fonts, appName, className, prefix, layoutStyle, }: CSRWrapperProps) => import("react/jsx-runtime").JSX.Element;
     Inner: () => import("react/jsx-runtime").JSX.Element;
     Bridge: ({ lang, prefix }: CSRBridgeProps) => null;
@@ -13,7 +13,7 @@ export declare const CSR: {
 export type CSRProviderProps = ProviderProps & {
     fonts: ReactFont[];
 };
-declare const CSRProvider: ({ className, appName, params, head, manifest, env, theme, prefix, children, gaTrackingId, fonts, layoutStyle, reconnect, wsConnect, of, }: CSRProviderProps) => import("react/jsx-runtime").JSX.Element;
+declare const CSRProvider: ({ className, appName, params, head, manifest, env, theme, prefix, children, fonts, layoutStyle, reconnect, wsConnect, of, }: CSRProviderProps) => import("react/jsx-runtime").JSX.Element;
 interface CSRWrapperProps {
     className?: string;
     appName: string;

package/types/ui/System/Client.d.ts

@@ -2,13 +2,10 @@ import { type Location, type PageState, type TransitionStyle } from "akanjs/clie
 import type { AkanTheme } from "akanjs/fetch";
 import type { SerializedSignal } from "akanjs/signal";
 import { type HTMLAttributes, type ReactNode, type RefObject } from "react";
-declare global {
-    var __AKAN_GET_SYNC_ROUTE_HREF__: ((href: string) => string) | undefined;
-}
 export declare const Client: {
     (): import("react/jsx-runtime").JSX.Element;
     Wrapper: ({ children, theme, lang, path, dictionary, signals, reconnect, }: ClientWrapperProps) => import("react/jsx-runtime").JSX.Element;
-    Bridge: ({ env, lang, theme, prefix, gaTrackingId, wsConnect }: ClientBridgeProps) => "" | import("react/jsx-runtime").JSX.Element | undefined;
+    Bridge: ({ env, lang, theme, prefix, wsConnect }: ClientBridgeProps) => null;
     Inner: () => import("react/jsx-runtime").JSX.Element;
     SsrBridge: ({ lang, prefix, initialPageState }: ClientSsrBridgeProps) => null;
 };
@@ -46,10 +43,9 @@ interface ClientBridgeProps {
     lang?: string;
     theme?: AkanTheme;
     prefix?: string;
-    gaTrackingId?: string;
     wsConnect?: boolean;
 }
-export declare const ClientBridge: ({ env, lang, theme, prefix, gaTrackingId, wsConnect }: ClientBridgeProps) => "" | import("react/jsx-runtime").JSX.Element | undefined;
+export declare const ClientBridge: ({ env, lang, theme, prefix, wsConnect }: ClientBridgeProps) => null;
 export declare const ClientInner: () => import("react/jsx-runtime").JSX.Element;
 interface ClientSsrBridgeProps {
     lang: string;

package/types/ui/System/Common.d.ts

@@ -1,43 +1,29 @@
 import "dayjs/locale/ko";
-import type { RootLayoutProps, WebAppManifest } from "akanjs/client";
+import type { PageState, RootLayoutProps, WebAppManifest } from "akanjs/client";
 import type { AkanTheme } from "akanjs/fetch";
-import type { ReactNode } from "react";
+import type { CSSProperties, ReactNode } from "react";
 export interface ProviderProps {
-    /** Additional classes for the app frame/root wrapper. */
     className?: string;
-    /** Public application name used by client routing and metadata. */
     appName: string;
-    /** Route params passed from the app root layout. */
     params: RootLayoutProps["params"];
-    /** Additional head content rendered by the app shell. */
     head?: ReactNode;
-    /** Web app manifest emitted as a data URL. */
+    /** Emitted as a data URL. */
     manifest?: WebAppManifest;
     /** App-specific public client config (`env/env.client.ts`) merged over the framework's own `getEnv()`. */
     env?: object;
-    /** Initial Akan theme configuration. */
     theme?: AkanTheme;
-    /** Optional route prefix/base path. */
     prefix?: string;
-    /** App content rendered inside the system provider. */
     children: ReactNode | ReactNode[];
-    /** Optional Google Analytics tracking id. */
-    gaTrackingId?: string;
-    /** Select mobile-style frame behavior or normal web layout. */
     layoutStyle?: "mobile" | "web";
-    /** Enable reconnect helper. Defaults to local operation mode in CSR. */
+    /** Defaults to local operation mode in CSR. */
     reconnect?: boolean;
-    /** Connect the client WebSocket runtime after the browser loads. */
+    /** Connects the client WebSocket runtime once the browser loads. */
     wsConnect?: boolean;
-    /** Active-locale dictionary injected by the server (SSR only) to seed the client Translator. */
+    /** SSR only: the active-locale dictionary that seeds the client Translator. */
     dictionary?: Record<string, Record<string, unknown>>;
-    /**
-     * Full lang-keyed dictionary snapshot (SSR server-only). The provider seeds every locale into
-     * the RSC-worker Translator (free on the server, never shipped to the browser) and serializes only
-     * the request's active locale to the client, so translations resolve regardless of locale routing.
-     */
+    /** SSR server only: every locale seeds the RSC-worker Translator, and only the active one reaches the client. */
     allDictionary?: Record<string, Record<string, Record<string, unknown>>>;
-    /** Root route component used by CSR page loading. */
+    /** Root route component for CSR page loading. */
     of: (props: unknown) => ReactNode | null;
 }
 export declare const Common: () => null;
@@ -46,3 +32,6 @@ export declare function ManifestLink({ manifest }: {
 }): import("react/jsx-runtime").JSX.Element | null;
 export declare function createManifestDataUrl(manifest: WebAppManifest): string;
 export declare function toManifestJson(value: unknown): unknown;
+export type AkanFrameCssVarName = "--akan-top-safe-area" | "--akan-bottom-safe-area" | "--akan-top-inset" | "--akan-bottom-inset" | "--akan-page-padding-top" | "--akan-page-padding-bottom";
+export type AkanFrameCssVars = CSSProperties & Record<AkanFrameCssVarName, string>;
+export declare function getFrameCssVars(pageState: PageState): AkanFrameCssVars;

package/types/ui/System/Root.d.ts

@@ -1,10 +1,7 @@
 import type { ReactNode } from "react";
-/**
- * @deprecated Renders `children` and ignores `st`. It predates the generated client, which wires the store
- * without a wrapper — render the children directly.
- */
 export interface RootProps {
     children: ReactNode;
     st: unknown;
 }
+/** @deprecated Renders `children` and ignores `st`; the generated client wires the store without a wrapper. */
 export declare const Root: ({ children, st }: RootProps) => import("react/jsx-runtime").JSX.Element;

package/types/ui/System/SSR.d.ts

@@ -3,13 +3,13 @@ import { type ReactNode } from "react";
 import { type ProviderProps } from "./Common.d.ts";
 export declare const SSR: {
     (): import("react/jsx-runtime").JSX.Element;
-    Provider: ({ className, appName, params, head, manifest, env, gaTrackingId, children, theme, prefix, fonts, layoutStyle, reconnect, wsConnect, dictionary, allDictionary, of, }: SSRProviderProps) => import("react/jsx-runtime").JSX.Element;
+    Provider: ({ className, appName, params, head, manifest, env, children, theme, prefix, fonts, layoutStyle, reconnect, wsConnect, dictionary, allDictionary, of, }: SSRProviderProps) => import("react/jsx-runtime").JSX.Element;
     Wrapper: ({ children, head, manifest, fonts, className, lang, path, prefix, layoutStyle, pageState, }: SSRWrapperProps) => import("react/jsx-runtime").JSX.Element;
 };
 export type SSRProviderProps = ProviderProps & {
     fonts?: ReactFont[];
 };
-declare const SSRProvider: ({ className, appName, params, head, manifest, env, gaTrackingId, children, theme, prefix, fonts, layoutStyle, reconnect, wsConnect, dictionary, allDictionary, of, }: SSRProviderProps) => import("react/jsx-runtime").JSX.Element;
+declare const SSRProvider: ({ className, appName, params, head, manifest, env, children, theme, prefix, fonts, layoutStyle, reconnect, wsConnect, dictionary, allDictionary, of, }: SSRProviderProps) => import("react/jsx-runtime").JSX.Element;
 interface SSRWrapperProps {
     className?: string;
     appName: string;

package/types/ui/System/ThemeToggle.d.ts

@@ -1,3 +1,4 @@
+export declare const DevModeToggle: () => import("react/jsx-runtime").JSX.Element;
 export interface ThemeToggleProps {
     themes?: string[];
 }

package/types/ui/System/index.d.ts

@@ -5,6 +5,7 @@ export declare const Provider: (props: CSRProviderProps | SSRProviderProps) => i
 export declare const System: {
     Provider: (props: CSRProviderProps | SSRProviderProps) => import("react/jsx-runtime").JSX.Element;
     ThemeToggle: ({ themes }: import("./ThemeToggle.d.ts").ThemeToggleProps) => import("react/jsx-runtime").JSX.Element | null;
+    /** @deprecated Renders `children` and ignores `st`; render the children directly. */
     Root: ({ children, st }: import("./Root.d.ts").RootProps) => import("react/jsx-runtime").JSX.Element;
     SelectLanguage: ({ className, languages }: import("./SelectLanguage.d.ts").SelectLanguageProps) => import("react/jsx-runtime").JSX.Element;
     Reconnect: () => import("react/jsx-runtime").JSX.Element | null;

package/types/ui/Tab/Provider.d.ts

@@ -1,12 +1,32 @@
 import { type ReactNode } from "react";
 export interface ProviderProps {
-    /** Additional classes for the tab state wrapper. */
     className?: string;
-    /** Initial active menu key. */
     defaultMenu?: string | null;
-    /** Names this tab for the in-page agent. Without it the tab publishes nothing — two tabs on one screen would otherwise share a name. */
+    /** Names the tab for the in-page agent; omitted, it publishes nothing (two tabs would share a name). */
     namespace?: string;
-    /** Tab.Menus and Tab.Panel children. */
     children?: ReactNode;
 }
 export declare const Provider: ({ className, defaultMenu, namespace, children }: ProviderProps) => import("react/jsx-runtime").JSX.Element;
+export interface MenuProps {
+    className?: string;
+    activeClassName?: string;
+    disabledClassName?: string;
+    disabled?: boolean;
+    menu: string;
+    children: ReactNode;
+    scrollToTop?: boolean;
+    tooltip?: ReactNode;
+}
+export declare const Menu: ({ className, activeClassName, disabledClassName, disabled, menu, children, scrollToTop, tooltip, }: MenuProps) => import("react/jsx-runtime").JSX.Element;
+export interface MenusProps {
+    className?: string;
+    children: ReactNode;
+}
+export declare const Menus: ({ className, children }: MenusProps) => import("react/jsx-runtime").JSX.Element;
+export interface PanelProps {
+    className?: string;
+    menu: string;
+    children?: ReactNode;
+    loading?: "eager" | "lazy" | "every";
+}
+export declare const Panel: ({ className, menu, children, loading }: PanelProps) => import("react/jsx-runtime").JSX.Element | null;

package/types/ui/Tab/index.d.ts

@@ -1,7 +1,7 @@
 import { type ProviderProps } from "./Provider.d.ts";
 export declare const Tab: {
     (props: ProviderProps): import("react/jsx-runtime").JSX.Element;
-    Menu: ({ className, activeClassName, disabledClassName, disabled, menu, children, scrollToTop, tooltip, }: import("./Menu.d.ts").MenuProps) => import("react/jsx-runtime").JSX.Element;
-    Menus: ({ className, children }: import("./Menus.d.ts").MenusProps) => import("react/jsx-runtime").JSX.Element;
-    Panel: ({ className, menu, children, loading }: import("./Panel.d.ts").PanelProps) => import("react/jsx-runtime").JSX.Element | null;
+    Menu: ({ className, activeClassName, disabledClassName, disabled, menu, children, scrollToTop, tooltip, }: import("./Provider.d.ts").MenuProps) => import("react/jsx-runtime").JSX.Element;
+    Menus: ({ className, children }: import("./Provider.d.ts").MenusProps) => import("react/jsx-runtime").JSX.Element;
+    Panel: ({ className, menu, children, loading }: import("./Provider.d.ts").PanelProps) => import("react/jsx-runtime").JSX.Element | null;
 };

package/types/ui/Table.d.ts

@@ -3,52 +3,36 @@ import type React from "react";
 import { type ReactNode } from "react";
 import { type PaginationProps } from "./Pagination.d.ts";
 export interface Column {
-    /** Stable column key. Defaults to index when omitted. */
+    /** Defaults to the index. */
     key?: string;
-    /** Header label. */
     title: ReactNode;
-    /** Field name read from each row object. */
+    /** The field read from each row. */
     dataIndex: string;
-    /** Custom cell renderer. */
     render?: (text: any, record: any, idx: number) => React.ReactNode;
-    /** Responsive breakpoints where this column should be visible. */
+    /** Breakpoints the column shows at. */
     responsive?: Responsive["value"][];
 }
 export interface TableProps {
-    /** Column definitions. */
     columns: Column[];
-    /** Rows rendered by the table. */
     dataSource: any[];
-    /** Show a centered loading spinner and dim rows. */
+    /** Dims the rows under a centered spinner. */
     loading?: boolean;
-    /** Table density. */
     size?: "small" | "middle";
-    /** Add a border around the table wrapper. */
     bordered?: boolean;
-    /** Pagination config, or false to hide pagination. */
+    /** `false` hides the pager. */
     pagination?: PaginationProps | false;
-    /** Show header always, never, or only at selected responsive breakpoints. */
+    /** An array shows the header only at those breakpoints. */
     showHeader?: boolean | Responsive["value"][];
-    /** Row event factory. */
     onRow?: (record: any, index: number) => {
         onClick: (() => void) | (() => Promise<boolean>);
     };
-    /** Row class or class factory. */
     rowClassName?: string | ((record: any, index: number) => string) | undefined;
-    /** Custom row key resolver. */
     rowKey?: (model: any) => string;
-    /** Content drawn above the table. */
     header?: ReactNode;
-    /** Content drawn below the table, under the pager. */
+    /** Drawn under the pager. */
     footer?: ReactNode;
-    /** Placeholder for a table with no rows. */
     empty?: ReactNode;
-    /** The mark shown over the rows while `loading`. */
     loadingIndicator?: ReactNode;
 }
 export declare const DefaultTable: ({ columns, dataSource, loading, size, bordered, pagination, showHeader, onRow, rowClassName, rowKey, header, footer, empty, loadingIndicator, }: TableProps) => import("react/jsx-runtime").JSX.Element;
-/**
- * Data table. Resolves to a route-scoped override when a `page/**\/_overrides.tsx`
- * in the route's ancestry declares one, otherwise renders {@link DefaultTable}.
- */
 export declare const Table: React.ComponentType<TableProps>;

package/types/ui/Toast.d.ts

@@ -4,40 +4,33 @@ export interface ToastMessage {
     key: string;
     type: ToastType;
     content: ReactNode;
-    /** Seconds the message is shown before the shell starts its exit. */
+    /** Seconds shown before the exit starts. */
     duration: number;
-    /** The shell started this message's exit: play the leave animation, then call `onClosed`. */
+    /** The exit started: play the leave animation, then call `onClosed`. */
     leaving: boolean;
 }
 export interface ToastItemProps {
     className?: string;
     message: ToastMessage;
-    /** Dismisses early — starts the same exit the timer would. */
+    /** Starts the same exit the timer would. */
     onClose: () => void;
-    /** Takes the message off the screen. Call it when the exit animation has finished. */
+    /** Call when the exit animation has finished. */
     onClosed: () => void;
 }
 export declare const DefaultToastItem: ({ className, message, onClose, onClosed }: ToastItemProps) => import("react/jsx-runtime").JSX.Element;
 export interface ToastProps {
     className?: string;
-    /** Oldest first, already capped by the store. A replacement showing fewer slices the list itself. */
+    /** Oldest first, already capped by the store. */
     messages: ToastMessage[];
-    /** The device's top safe area in pixels — the stack starts below it. */
+    /** In pixels; the stack starts below it. */
     topSafeArea: number;
-    /** Starts a message's exit, as the dismiss button and the elapsed timer both do. */
+    /** Starts a message's exit. */
     onClose: (key: string) => void;
-    /** Takes a message off the screen once its exit animation has finished. */
+    /** Call once a message's exit animation has finished. */
     onClosed: (key: string) => void;
 }
 export declare const DefaultToast: ({ className, messages, topSafeArea, onClose, onClosed }: ToastProps) => import("react/jsx-runtime").JSX.Element;
-/**
- * The toast surface. `Toast` (the stack) and `Toast.Item` (one card) each resolve to a route-scoped override
- * when a `page/**\/_overrides.tsx` in the route's ancestry declares one (slots `Toast`, `ToastItem`).
- *
- * `System`'s `Messages` renders this and is not a slot: it keeps the `msg.*` wiring, the store read, the
- * body-level portal and the dismiss timers, so a replacement re-skins the surface without re-implementing
- * when a toast appears and goes away.
- */
+/** `System`'s `Messages` keeps the timers, portal and store wiring, so a replacement only re-skins the surface. */
 export declare const Toast: import("react").ComponentType<ToastProps> & {
     Item: import("react").ComponentType<ToastItemProps>;
 };

package/types/ui/ToggleSelect.d.ts

@@ -38,11 +38,6 @@ export interface MultiProps {
     onChange: (value: string[] | number[]) => void;
     disabled?: boolean;
 }
-/**
- * Toggle-select. `ToggleSelect` keeps its generic signature (so `<ToggleSelect<Status> …/>` still
- * infers), and both it and `ToggleSelect.Multi` resolve to a route-scoped override when a
- * `page/**\/_overrides.tsx` in the route's ancestry declares one (slots `ToggleSelect`, `ToggleSelectMulti`).
- */
 export declare const ToggleSelect: (<I extends string | number | boolean | null>(props: ToggleSelectProps<I>) => import("react").ReactElement<ToggleSelectProps<I>, string | import("react").JSXElementConstructor<any>>) & {
     Multi: ComponentType<MultiProps>;
 };

package/types/ui/Tooltip.d.ts

@@ -1,11 +1,10 @@
 import type { ReactNode } from "react";
 export interface TooltipProps {
-    /** 툴팁에 표시할 내용. 비어 있으면 트리거만 그대로 렌더한다. */
+    /** Empty renders the trigger alone. */
     content?: ReactNode;
     children: ReactNode;
     side?: "top" | "right" | "bottom" | "left";
     className?: string;
-    /** 색상 변형. daisyui `tooltip-primary/info` 대체. */
     variant?: "default" | "primary" | "info";
 }
 export declare const Tooltip: import("react").ComponentType<TooltipProps>;