akanjs 3.0.0-beta.9 → 3.0.1

package/ui/Menu.tsx

@@ -51,12 +51,11 @@ export const DefaultMenu = ({
   onMouseLeave,
   renderItem,
 }: MenuProps) => {
-  const [expandedKey, setExpandedKey] = useState<string>(); 
-  const [currentKey, setCurrentKey] = useState<string | null>(defaultSelectedKeys?.[0] ?? null); 
+  const [expandedKey, setExpandedKey] = useState<string>();
+  const [currentKey, setCurrentKey] = useState<string | null>(defaultSelectedKeys?.[0] ?? null);
   const modeClassName = mode === "horizontal" ? "flex-row " : "bg-muted";
   const menuRef = useRef<HTMLDivElement | null>(null);
   const LiRefs = useRef<HTMLLIElement[]>([]);
-  const overflowLiRef = useRef<HTMLLIElement | null>(null);
   const itemWidthsRef = useRef<number[]>([]);
   const innerWidth = st.use.innerWidth({ agent: false });
 
@@ -94,7 +93,6 @@ export const DefaultMenu = ({
     if (mode !== "horizontal" || !itemWidthsRef.current.length) return;
     const menu = menuRef.current;
     if (!menu) return;
-    
     const totalWidth = menu.getBoundingClientRect().width;
     const widths = itemWidthsRef.current;
     const overflowItems: MenuItem[] = [];
@@ -169,16 +167,6 @@ export const DefaultMenu = ({
                       {item.icon}
 
                       {!inlineCollapsed && <div className="whitespace-nowrap text-foreground">{item.label}</div>}
-                      {/* <div
-                      className={cn(
-                        "whitespace-nowrap  truncate ",
-                        mode === "horizontal" && !isOverflowItem && item.children
-                          ? "flex justify-start animate-menuOpen"
-                          : "flex justify-start animate-menuClose"
-                      )}
-                    >
-                      {item.label}
-                    </div> */}
                     </div>
                     {item.children && mode === "inline" && (
                       <AiFillCaretDown
@@ -190,7 +178,6 @@ export const DefaultMenu = ({
                     )}
                   </div>
                 )}
-                {/* 서브메뉴 */}
                 {item.children && expandedKey === item.key && (
                   <div className={subMenuClassName}>
                     {item.children.map((child) => (
@@ -226,7 +213,7 @@ interface OverflowMenuProps {
 
 const OverflowMenu = ({ overflowItems, onClick }: OverflowMenuProps) => {
   const [isOpen, setIsOpen] = useState(false);
-  const [expandedKey, setExpandedKey] = useState<string>(); 
+  const [expandedKey, setExpandedKey] = useState<string>();
   const recipe = useUiRecipe("button") ?? buttonRecipe;
   const handleMouseEnter = () => {
     setIsOpen(true);
@@ -282,9 +269,4 @@ const OverflowMenu = ({ overflowItems, onClick }: OverflowMenuProps) => {
   );
 };
 
-/**
- * Navigation menu. Resolves to a route-scoped override when a
- * `page/**\/_overrides.tsx` in the route's ancestry declares one, otherwise
- * renders {@link DefaultMenu}.
- */
 export const Menu = createOverridable("Menu", DefaultMenu);

package/ui/Modal.tsx

@@ -6,31 +6,19 @@ import { Dialog } from "./Dialog";
 import { createOverridable } from "./UiOverride";
 
 export interface ModalProps {
-  /** Additional classes for the modal surface. */
   className?: string;
-  /** Optional trigger element to open the modal. */
   trigger?: ReactNode;
-  /** Optional modal title. */
   title?: string | ReactNode;
-  /** Optional action area, usually footer buttons. */
   action?: ReactNode;
   /** The dismiss control. `false` draws none. */
   closeButton?: ReactNode | false;
-  /** Controlled open state. */
   open?: boolean;
-  /** Called when the modal requests closing. */
   onCancel?: () => void;
-  /** Additional classes for the content body. */
   bodyClassName?: string;
   children?: ReactNode;
-  /** Ask for close confirmation before dismissing. */
   confirmClose?: boolean;
 }
 
-/**
- * Default akanjs modal skin. Kept as the fallback implementation; apps replace
- * it per-route through a `page/**\/_overrides.tsx` manifest.
- */
 export const DefaultModal = ({
   className,
   trigger,
@@ -61,9 +49,4 @@ export const DefaultModal = ({
   );
 };
 
-/**
- * Public Modal. Resolves to a route-scoped override when a `_overrides.tsx` in
- * the route's ancestry declares one, otherwise renders {@link DefaultModal}.
- * The proxy is transparent to every existing `<Modal … />` call site.
- */
 export const Modal = createOverridable("Modal", DefaultModal);

package/ui/Model/AdminPanel.tsx

@@ -17,10 +17,7 @@ interface AdminPanelProps<T extends string, State, Input, Full extends { id: str
   template?: any;
   unit?: any;
   view?: any;
-  /**
-   * Overrides the filter a summary column applies. A column left out still narrows the listing when its own
-   * field declares one with `.meta(...)`.
-   */
+  /** Overrides a summary column's filter; a column left out still filters through its field's `.meta(...)`. */
   queryMap?: { [column: string]: QuerySetting };
   /** Model whose fields `summaryColumns` name. Defaults to the `summary` model the state key already implies. */
   summaryRefName?: string;
@@ -49,7 +46,7 @@ export default function AdminPanel<
   renderInsight = ({ insight }) => (
     <Data.Insight insight={insight} slice={slice} columns={insightColumns as (keyof BaseInsight)[]} />
   ),
-
+  
   renderDashboard = summaryColumns?.length
     ? ({ summary, hidePresents, onSelect, queryKey }) => (
         <Data.Dashboard

package/ui/Model/DraftBar.tsx

@@ -13,15 +13,10 @@ import { createOverridable } from "../UiOverride";
 
 export interface DraftBarViewProps {
   className?: string;
-  /** The model the recovered form belongs to. */
   refName: string;
-  /**
-   * `conflict` is a decision the user has to settle — the record moved since the draft was taken, so the form
-   * shows the server's value and the bar offers the older one. `applied` is a notice: the draft is what is on
-   * screen, and the bar is the way back.
-   */
+  /** `conflict`: the record moved, the form shows the server's value and the bar offers the draft. `applied`: the
+   *  draft is on screen and the bar is the way back. */
   state: "conflict" | "applied";
-  /** When the draft was taken. */
   savedAt: Date;
   /** Puts the offered draft into the form. Passed in the `conflict` state only. */
   onRestore?: () => void;
@@ -64,12 +59,6 @@ const DefaultDraftBar = ({ className, state, savedAt, onRestore, onDiscard }: Dr
   );
 };
 
-/**
- * The banner itself, route-overridable through `page/**\/_overrides.tsx` (slot `DraftBar`).
- *
- * The shell below keeps the draft state and publishes the two agent tools, so a replacement re-skins the notice
- * without reaching into the store under string keys or re-declaring what an agent may pull.
- */
 const DraftBarView = createOverridable("DraftBar", DefaultDraftBar);
 
 interface DraftBarProps {
@@ -90,7 +79,7 @@ export default function DraftBar({ className, slice }: DraftBarProps) {
   );
   const storeUse = st.use as { [key: string]: (option?: { agent?: boolean }) => unknown };
   const storeDo = st.do as unknown as { [key: string]: () => void };
-
+  
   const draft = storeUse[names.modelDraft]({ agent: false }) as DraftState | null;
 
   const restoreDraft = st

package/ui/Model/EditModal.tsx

@@ -21,27 +21,19 @@ const modalResetKey = (modelName: string, modalName: string, modalId?: string) =
   `${modelName}|${modalName}|${modalId ?? ""}`;
 
 interface EditModelProps<Full> {
-  /** Rendering mode for the edit shell. */
   type?: "modal" | "form" | "empty";
-  /** Slice metadata generated for the model store/fetch contract. */
   slice: SliceMeta;
-  /** Additional classes for the wrapper. */
   className?: string;
-  /** Additional classes for the recovered-form banner this shell draws above the form. */
   draftBarClassName?: string;
-  /** Re-check submit eligibility when form state changes. */
+  /** Re-checks submit eligibility when the form changes. */
   checkSubmit?: boolean;
-  /** Client edit promise or partial form seed. */
   edit?: ClientEdit<string, Full> | Partial<Full>;
-  /** Store modal name that should activate this editor. */
+  /** The store modal name that opens this editor. */
   modal?: string;
   children: ReactNode;
-  /** Custom loading overlay wrapper, or false to disable the default overlay. */
+  /** `false` disables the default loading overlay. */
   loadingWrapper?: boolean | ((props: { children?: any; className?: string }) => ReactNode);
-  /**
-   * Draft recovery for this form. `false` turns it off; a string names the scope explicitly, for the rare
-   * screen whose context is not in the record id or in the seed the editor was given.
-   */
+  /** Draft recovery for this form. `false` turns it off; a string names the scope explicitly. */
   draft?: DraftProp;
 }
 
@@ -64,7 +56,7 @@ const EditModel = <Full,>({
 }: OpenEditorProps<Full>) => {
   const storeUse = st.use as { [key: string]: () => unknown };
   const storeDo = st.do as unknown as { [key: string]: (...args: any[]) => void };
-  const { refName, sliceName } = slice;
+  const { refName } = slice;
   const [modelName, ModelName] = useMemo(() => [lowerlize(refName), capitalize(refName)], []);
   const names = useMemo(
     () => ({
@@ -117,26 +109,19 @@ const EditModel = <Full,>({
 };
 
 interface EditModalProps<Full extends { id: string }> extends EditModelProps<Full> {
-  /** Model id used to scope edit modal state. */
   id?: string;
-  /** Disable modal trigger and submit behavior. */
   disabled?: boolean;
   checkSubmit?: boolean;
-  /** Additional classes for the modal window. */
   modalClassName?: string;
-  /** Modal title or title renderer receiving the current model. */
   renderTitle?: ((model: Full) => string | ReactNode) | string;
-  /** Submit button label. */
   submitText?: ReactNode;
-  /** Additional classes for the submit button. */
   submitClassName?: string;
-  /** Store submit options passed to the generated submit action. */
   submitOption?: CreateOption<Full>;
-  /** Custom submit renderer, or false to hide the default submit button. */
+  /** `false` hides the default submit button. */
   renderSubmit?: boolean | ((arg: any) => ReactNode);
-  /** Action name or callback invoked after submit. */
+  /** A callback, `"back"`, `"reset"`, or a path to replace to (`[<model>Id]` is filled in). */
   onSubmit?: string | ((model: Full) => void);
-  /** Action name or callback invoked on cancel. */
+  /** A callback, `"back"`, `"reset"`, or a path to replace to. */
   onCancel?: string | ((form?: any) => any);
 }
 
@@ -234,7 +219,6 @@ export default function EditModal<Full extends { id: string }>({
         });
       else void storeDo[names.loadModelDraft](draftScope);
     } else {
-      
       const crystal = new modelRef().set(modelEdit as Full) as unknown as Full;
       const draftScope = newDraftScope(draft, {
         seed: modelEdit as object,
@@ -282,7 +266,6 @@ export default function EditModal<Full extends { id: string }>({
   const handleCancel = useCallback(() => {
     const modelForm = (st.get() as DynamicRecord)[names.modelForm] as Full;
     const form = deepObjectify(modelForm);
-    
     void storeDo[names.setModelModal](null);
     if (typeof onCancel === "function") onCancel(form);
     else if (onCancel === "back") router.back();
@@ -343,8 +326,6 @@ export default function EditModal<Full extends { id: string }>({
                   onClick={async (e, { onError }) => {
                     await handleSubmit({ onError });
                   }}
-                  onSuccess={() => {
-                  }}
                 >
                   {modelFormId ? <AiOutlineSave /> : <AiOutlinePlus />}
                   {submitText ??
@@ -356,6 +337,7 @@ export default function EditModal<Full extends { id: string }>({
             },
     [disabled, modelFormId],
   );
+  const editProps = { type, slice, className, draftBarClassName, checkSubmit, edit, modal, loadingWrapper };
   if (type === "modal")
     return (
       <Modal
@@ -368,17 +350,7 @@ export default function EditModal<Full extends { id: string }>({
         action={<Submit />}
       >
         {isModalOpen ? (
-          <EditModel
-            type={type}
-            slice={slice}
-            className={className}
-            draftBarClassName={draftBarClassName}
-            checkSubmit={checkSubmit}
-            edit={edit}
-            modal={modal}
-            loadingWrapper={loadingWrapper}
-            cancelEdit={handleCancel}
-          >
+          <EditModel {...editProps} cancelEdit={handleCancel}>
             {children}
           </EditModel>
         ) : null}
@@ -386,16 +358,7 @@ export default function EditModal<Full extends { id: string }>({
     );
   else if (isModalOpen)
     return (
-      <EditModel
-        type={type}
-        slice={slice}
-        className={className}
-        draftBarClassName={draftBarClassName}
-        checkSubmit={checkSubmit}
-        edit={edit}
-        modal={modal}
-        loadingWrapper={loadingWrapper}
-      >
+      <EditModel {...editProps}>
         <Title />
         {children}
         {type === "form" ? <Submit /> : null}

package/ui/Model/EditWrapper.tsx

@@ -31,13 +31,12 @@ export default function EditWrapper({
   resets,
   draft,
 }: EditWrapperProps) {
-  const { refName, sliceName } = slice;
-  const modelName = refName;
+  const { refName: modelName } = slice;
   const names = {
     editModel: `edit${capitalize(modelName)}`,
   };
   const storeDo = st.do as unknown as { [key: string]: (...args: any[]) => Promise<void> };
-
+  
   const editModel = st
     .tool(disabled ? null : names.editModel)
     .desc(`Open one ${modelName} in the edit form.`)

package/ui/Model/LoadStore.tsx

@@ -0,0 +1,18 @@
+"use client";
+import type { ClientInit, ClientView } from "akanjs/fetch";
+
+import { Load } from "../Load";
+
+interface LoadInitProps<T extends string, Light extends { id: string }> {
+  init: ClientInit<T, Light>;
+}
+export function LoadInit<T extends string, Light extends { id: string }>({ init }: LoadInitProps<T, Light>) {
+  return <Load.Units init={init} renderList={() => null} loading={null} renderEmpty={null} />;
+}
+
+interface LoadViewProps<T extends string, Model extends { id: string }> {
+  view: ClientView<T, Model>;
+}
+export function LoadView<T extends string, Light extends { id: string }>({ view }: LoadViewProps<T, Light>) {
+  return <Load.View view={view} renderView={() => null} loading={null} />;
+}

package/ui/Model/NewWrapper_Client.tsx

@@ -45,7 +45,7 @@ export const NewWrapper_Client = <Full,>({
   const storeUse = st.use as { [key: string]: () => unknown };
   const modelModal = storeUse[names.modelModal]() as string | null;
   const disabled = modelModal === "edit";
-
+  
   const newModel = st
     .tool(`${sliceName.replace(modelName, names.newModel)}${namespace ? `In${capitalize(namespace)}` : ""}`, {
       guard: () => (disabled ? `A ${modelName} form is already open.` : true),

package/ui/Model/Remove.tsx

@@ -4,7 +4,7 @@ import { cn, msg, router, usePage } from "akanjs/client";
 import { capitalize } from "akanjs/common";
 import type { SliceMeta } from "akanjs/fetch";
 import { st } from "akanjs/store";
-import { type ReactNode, useMemo, useState } from "react";
+import { type ReactNode, useState } from "react";
 
 import { agentAttrs } from "../agentAttrs";
 import { Button } from "../Button";
@@ -17,9 +17,7 @@ interface RemoveProps {
   slice: SliceMeta;
   modal?: string | null;
   redirect?: string;
-  /** Confirmation heading. */
   title?: ReactNode;
-  /** Confirmation body. */
   description?: ReactNode;
   /** Confirmation footer. Replacing it takes over the removal — call nothing else and the record stays. */
   action?: ReactNode;
@@ -40,14 +38,8 @@ export default function Remove({
   const { l } = usePage();
   const [modalOpen, setModalOpen] = useState(false);
   const storeDo = st.do as unknown as { [key: string]: (...args: any[]) => Promise<void> };
-  const { refName, sliceName } = slice;
-  const modelName = refName;
-  const names = useMemo(
-    () => ({
-      removeModel: `remove${capitalize(modelName)}`,
-    }),
-    [],
-  );
+  const { refName: modelName } = slice;
+  const names = { removeModel: `remove${capitalize(modelName)}` };
   const removeModel = async (id: string, { onError }: { onError?: (e: string) => void } = {}) => {
     await storeDo[names.removeModel](id, { onError, modal });
     msg.success("base.removeSuccess", { data: { model: l(`${modelName}.modelName` as "base.new") } });
@@ -56,7 +48,7 @@ export default function Remove({
     if (redirect === "back") router.back();
     else router.push(redirect);
   };
-
+  
   const removeTool = st
     .tool(names.removeModel)
     .desc(`Remove one ${modelName}.`)

package/ui/Model/RemoveWrapper.tsx

@@ -20,13 +20,12 @@ interface RemoveWrapperProps {
 
 export default function RemoveWrapper({ children, slice, name, modelId, className, modal }: RemoveWrapperProps) {
   const { l } = usePage();
-  const { refName, sliceName } = slice;
-  const modelName = refName;
+  const { refName: modelName } = slice;
   const names = {
     removeModel: `remove${capitalize(modelName)}`,
   };
   const storeDo = st.do as unknown as { [key: string]: (...args: any[]) => Promise<void> };
-
+  
   const removeModel = st
     .tool(names.removeModel)
     .desc(`Remove one ${modelName}.`)

package/ui/Model/SureToRemove.tsx

@@ -4,7 +4,7 @@ import { cn, msg, router, usePage } from "akanjs/client";
 import { capitalize } from "akanjs/common";
 import type { SliceMeta } from "akanjs/fetch";
 import { st } from "akanjs/store";
-import { type ReactNode, useMemo, useState } from "react";
+import { type ReactNode, useState } from "react";
 import { AiOutlineDelete } from "react-icons/ai";
 
 import { agentAttrs } from "../agentAttrs";
@@ -21,11 +21,8 @@ interface SureToRemoveProps {
   typeNameToRemove?: boolean;
   /** Element that opens the confirmation. Defaults to the framework's delete label. */
   trigger?: ReactNode;
-  /** Confirmation heading. */
   title?: ReactNode;
-  /** Confirmation body above the name field. */
   description?: ReactNode;
-  /** Label of the button that performs the removal. */
   confirmLabel?: ReactNode;
 }
 export default function SureToRemove({
@@ -44,14 +41,8 @@ export default function SureToRemove({
   const [repeatName, setRepeatName] = useState("");
   const [modalOpen, setModalOpen] = useState(false);
   const storeDo = st.do as unknown as { [key: string]: (...args: any[]) => Promise<void> };
-  const { refName, sliceName } = slice;
-  const modelName = refName;
-  const names = useMemo(
-    () => ({
-      removeModel: `remove${capitalize(modelName)}`,
-    }),
-    [],
-  );
+  const { refName: modelName } = slice;
+  const names = { removeModel: `remove${capitalize(modelName)}` };
 
   const removeModel = async (id: string) => {
     await storeDo[names.removeModel](id);
@@ -61,7 +52,7 @@ export default function SureToRemove({
     if (redirect === "back") router.back();
     else router.push(redirect);
   };
-
+  
   const removeTool = st
     .tool(typeNameToRemove ? null : names.removeModel)
     .desc(`Remove one ${modelName}.`)

package/ui/Model/ViewEditModal.tsx

@@ -14,10 +14,6 @@ import { Modal } from "../Modal";
 import Remove from "./Remove";
 import View from "./View";
 
-/**
- * Closing is the one verb both faces of this modal share, and exactly one face is mounted while it is open —
- * so declaring it from whichever face is up publishes it once, and withdraws it when the modal closes.
- */
 const useCloseViewTool = (modelName: string, closeView: () => void) =>
   st
     .tool(`closeViewOf${capitalize(modelName)}`)
@@ -70,9 +66,7 @@ interface ViewEditModalProps {
   renderTemplate: () => ReactNode | null;
   /** The kebab menu beside the title. `false` draws none, which also takes the remove entry off the modal. */
   menu?: ReactNode | false;
-  /** Label of the button that turns the detail view into the form. */
   editLabel?: ReactNode;
-  /** Label of the button that saves the form. */
   saveLabel?: ReactNode;
 }
 export default function ViewEditModal({

package/ui/Model/ViewModal.tsx

@@ -12,10 +12,6 @@ interface ViewToolsProps {
   closeView: () => void;
 }
 
-/**
- * Mounted only by the modal that is actually open. A list renders one `ViewModal` per row, and only the row
- * whose id matches opens, so the close verb reaches the surface once instead of once per row.
- */
 const ViewTools = ({ modelName, closeView }: ViewToolsProps) => {
   st.tool(`closeViewOf${capitalize(modelName)}`)
     .desc(`Close the ${modelName} detail view.`)
@@ -45,7 +41,7 @@ export default function ViewModal({
 }: ViewModalProps) {
   const storeUse = st.use as unknown as { [key: string]: () => unknown };
   const storeDo = st.do as unknown as { [key: string]: (...args: any[]) => void };
-  const { refName, sliceName } = slice;
+  const { refName } = slice;
   const [modelName, ModelName] = [refName, capitalize(refName)];
   const names = {
     model: modelName,

package/ui/Model/ViewWrapper.tsx

@@ -18,8 +18,7 @@ interface ViewWrapperProps {
 }
 
 export default function ViewWrapper({ children, slice, modelId, className, modal, resets }: ViewWrapperProps) {
-  const { refName, sliceName } = slice;
-  const modelName = refName;
+  const { refName: modelName } = slice;
   const names = {
     viewModel: `view${capitalize(modelName)}`,
   };

package/ui/Model/draftScope.ts

@@ -1,12 +1,5 @@
 import { DraftStore } from "akanjs/store";
 
-/**
- * How an edit shell's `draft` prop becomes a scope, or nothing.
- *
- * The scope is built here rather than in the store action because this is where the *raw* seed is: `new<Model>`
- * merges its argument into `default<Model>` first, and a `default: () => dayjs()` in that merge would give the
- * same form a different key every time it opened.
- */
 export type DraftProp = boolean | string;
 
 export const editDraftScope = (draft: DraftProp | undefined, modelId: string | undefined): string | undefined => {

package/ui/Model/index_.tsx

@@ -1,27 +1,7 @@
 import { lazy } from "akanjs/webkit";
 
-/**
- * Every Model export carries its own Suspense boundary.
- *
- * These mount on interaction — a modal body, a dropdown item, a confirm shell — long after the page is
- * painted, and a chunk that resolves then would otherwise suspend all the way to the route and repaint
- * the page as its loading fallback, once per fresh load.
- */
 const withSuspense = { suspense: true } as const;
 
-/**
- * A fallback here may only be a host element. This module has no `"use client"`, so a client component
- * referenced from it — `Loading.Skeleton` was the one tried — resolves to `undefined` inside the thunk
- * and the render throws "Element type is invalid", taking the whole page segment under the layout with
- * it. Marking the barrel `"use client"` is worse: `Model.*` becomes a real server→client boundary and
- * apps passing crystalized model instances as props fail serialization at boot. Plain markup crosses
- * neither line.
- *
- * Only the two exports that occupy space of their own get it. The triggers wrap the caller's own
- * children, so a fixed block would put a slab where a small button belongs, and the modals render `null`
- * until opened, so a block would appear where nothing ever shows. For those the collapse is a blink the
- * size of a button; here it is the page body dropping to zero height and snapping back.
- */
 const bodyFallback = {
   suspense: true,
   loading: () => <div className="min-h-40 w-full animate-pulse rounded-box bg-muted" />,
@@ -35,8 +15,8 @@ export const Remove = lazy(() => import("./Remove"), withSuspense);
 export const NewWrapper = lazy(() => import("./NewWrapper"), withSuspense);
 export const EditWrapper = lazy(() => import("./EditWrapper"), withSuspense);
 export const RemoveWrapper = lazy(() => import("./RemoveWrapper"), withSuspense);
-export const LoadInit = lazy(() => import("./LoadInit"), withSuspense);
-export const LoadView = lazy(() => import("./LoadView"), withSuspense);
+export const LoadInit = lazy(() => import("./LoadStore").then((m) => m.LoadInit), withSuspense);
+export const LoadView = lazy(() => import("./LoadStore").then((m) => m.LoadView), withSuspense);
 export const ViewWrapper = lazy(() => import("./ViewWrapper"), withSuspense);
 export const ViewEditModal = lazy(() => import("./ViewEditModal"), withSuspense);
 export const Edit = lazy(() => import("./Edit"), withSuspense);

package/ui/Pagination.tsx

@@ -7,25 +7,21 @@ import { buttonRecipe } from "./Button";
 import { createOverridable, useUiRecipe } from "./UiOverride";
 
 export interface PaginationProps {
-  /** Current 1-based page number. */
+  /** 1-based. */
   currentPage: number;
-  /** Total number of items. */
   total: number;
-  /** Called with the selected 1-based page number. */
+  /** Called with the 1-based page. */
   onPageSelect: (page: number) => void;
-  /** Number of items per page. Used to calculate total pages. */
   itemsPerPage: number;
   /** Placeholder for a pager with no pages. */
   empty?: ReactNode;
   /** @deprecated Renamed to `empty` — it is a node, not a render function. */
   renderEmpty?: ReactNode;
-  /** The mark inside the step-back control. The button, its disabled state and its label stay the framework's. */
+  /** The mark inside the step-back control; the button itself stays the framework's. */
   prev?: ReactNode;
-  /** The mark inside the step-forward control. */
   next?: ReactNode;
-  /** The mark standing in for the pages a long pager skips. */
+  /** Stands in for the pages a long pager skips. */
   ellipsis?: ReactNode;
-  /** Class overrides for wrapper and page buttons. */
   classNames?: {
     className?: string;
     activePageNumClassName?: string;
@@ -121,8 +117,4 @@ export const DefaultPagination = ({
   );
 };
 
-/**
- * Pager. Resolves to a route-scoped override when a `page/**\/_overrides.tsx` in
- * the route's ancestry declares one, otherwise renders {@link DefaultPagination}.
- */
 export const Pagination = createOverridable("Pagination", DefaultPagination);

package/ui/Popconfirm.tsx

@@ -17,29 +17,20 @@ type ButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {
 };
 
 export interface PopconfirmProps {
-  /** Confirmation title. */
   title: ReactNode;
-  /** Optional detailed confirmation message. */
   description?: ReactNode;
-  /** The mark beside the message. `false` draws none. */
+  /** `false` draws none. */
   icon?: ReactNode | false;
-  /** The whole footer, replacing both buttons. A replacement owns the confirm and the dismiss. */
+  /** Replaces both buttons; a replacement owns the confirm and the dismiss. */
   actions?: ReactNode;
-  /** Called when the user confirms. */
   onConfirm?: () => void;
-  /** Props forwarded to the OK button. */
   okButtonProps?: ButtonProps;
-  /** Props forwarded to the cancel button. */
   cancelButtonProps?: ButtonProps;
-  /** Custom OK button text. */
   okText?: ReactNode;
-  /** Custom cancel button text. */
   cancelText?: ReactNode;
-  /** Trigger content. */
   children?: ReactNode;
-  /** Additional classes for the trigger wrapper. */
   triggerClassName?: string;
-  /** Additional classes for the popover arrow/decorator. */
+  /** Classes for the pointer; setting it drops the pointer's computed offset. */
   decoClassName?: string;
 }
 
@@ -64,7 +55,6 @@ export const DefaultPopconfirm = ({
   const [portal, setPortal] = useState<HTMLElement | null>(null);
   const triggerRef = useRef<HTMLDivElement>(null);
   const panelRef = useRef<HTMLDivElement>(null);
-  
   const overlayLayerProps = useOverlayLayerProps();
   const position = useOverlayPosition({
     opened: isConfirming,
@@ -165,9 +155,4 @@ export const DefaultPopconfirm = ({
   );
 };
 
-/**
- * Confirmation popover. Resolves to a route-scoped override when a
- * `page/**\/_overrides.tsx` in the route's ancestry declares one, otherwise
- * renders {@link DefaultPopconfirm}.
- */
 export const Popconfirm = createOverridable("Popconfirm", DefaultPopconfirm);