@webority/ui-react 0.107.0 → 0.108.0

package/dist/types/components/AppLogoPicker.d.ts

@@ -1,125 +0,0 @@
-import "@webority/ui-elements/elements/image-crop";
-/**
- * Circular (or rounded or square) logo or avatar picker with an update overlay.
- * Click or drag-and-drop a file onto the ring; a freshly picked file previews immediately
- * (optimistic) while the caller uploads and reflects it back via `value`.
- *
- * @param {object} props
- * @param {string|null} [props.value]
- * @param {import('react').ReactNode} [props.fallback]
- * @param {string} [props.name]
- * @param {(file: File) => void} props.onPick Receives a validated File, the cropped one when `crop` is set.
- * @param {() => void} [props.onRemove] Called when the × clears the logo. A just-picked image always shows the ×; an existing `value` needs onRemove for its × to appear, because the parent owns it.
- * @param {boolean} [props.loading]
- * @param {boolean} [props.disabled]
- * @param {string} [props.accept]
- * @param {number} [props.maxSizeMb]
- * @param {number|'free'} [props.crop]
- * @param {string} [props.overlayIcon]
- * @param {string} [props.overlayLabel]
- * @param {string} [props.ariaLabel]
- * @param {string} [props.removeLabel]
- * @param {string} [props.label]
- * @param {string} [props.hint]
- * @param {string} [props.error]
- * @param {'stacked'|'inline'|'profile'} [props.layout]
- * @param {import('react').ReactNode} [props.title]
- * @param {import('react').ReactNode} [props.subtitle]
- * @param {boolean} [props.required]
- * @param {'initials'|'avatar'} [props.variant]
- * @param {'sm'|'md'|'lg'|number} [props.size]
- * @param {'circle'|'rounded'|'square'} [props.shape]
- * @param {string} [props.className]
- */
-export default function AppLogoPicker(props: {
-    /** The current image URL. Null and absent both mean no image. */
-    value?: string | null;
-    /** Shown when there is no image, for example initials. */
-    fallback?: import('react').ReactNode;
-    /** The form field name, so an uncontrolled form can post the file. */
-    name?: string;
-    onPick: (file: File) => void;
-    onRemove?: () => void;
-    /**
-     * Shows a spinner and blocks interaction while the picked file uploads.
-     * @default false
-     */
-    loading?: boolean;
-    /**
-     * A non-busy, non-interactive state.
-     * @default false
-     */
-    disabled?: boolean;
-    /**
-     * The file types the picker accepts.
-     * @default "image/png,image/jpeg,image/webp"
-     */
-    accept?: string;
-    /**
-     * The largest accepted file in megabytes. 0 means no size limit.
-     * @default 5
-     */
-    maxSizeMb?: number;
-    /** Adds a crop step before upload: a dialog lets the person drag and zoom a frame, and the picked file is the cropped one. A number is the frame's width divided by its height, such as 1 for an avatar; free lets them resize the frame. */
-    crop?: number | 'free';
-    /**
-     * The icon name for the hover overlay.
-     * @default "image"
-     */
-    overlayIcon?: string;
-    /**
-     * The text of the hover overlay.
-     * @default "Update photo"
-     */
-    overlayLabel?: string;
-    /**
-     * The accessible name of the upload button.
-     * @default "Upload photo"
-     */
-    ariaLabel?: string;
-    /**
-     * The accessible name and tooltip of the remove control. Use Remove logo on a logo picker.
-     * @default "Remove photo"
-     */
-    removeLabel?: string;
-    /** An optional field label above the ring. */
-    label?: string;
-    /** Optional helper text: below the ring when stacked, in the side column when inline or profile. */
-    hint?: string;
-    /** An inline error from the caller. It wins over an automatic rejection reason. */
-    error?: string;
-    /**
-     * Stacked is the ring with the hint below. Inline is a profile row with the ring on the left and a title, subtitle and hint column beside it. Profile stacks the same identity block, centred, beneath the ring.
-     * @default "stacked"
-     */
-    layout?: 'stacked' | 'inline' | 'profile';
-    /** Bold primary text beside the ring. Inline and profile layouts only. */
-    title?: import('react').ReactNode;
-    /** Muted secondary text beside the ring. Inline and profile layouts only. */
-    subtitle?: import('react').ReactNode;
-    /**
-     * Marks the field as required.
-     * @default false
-     */
-    required?: boolean;
-    /**
-     * The placeholder style: initials text, or a standard avatar with a muted disc and a person icon when there are no initials.
-     * @default "initials"
-     */
-    variant?: 'initials' | 'avatar';
-    /**
-     * A preset (sm 72, md 120, lg 160 pixels) or an exact ring diameter in pixels. The whole control scales from it.
-     * @default "md"
-     */
-    size?: 'sm' | 'md' | 'lg' | number;
-    /**
-     * The ring shape.
-     * @default "circle"
-     */
-    shape?: 'circle' | 'rounded' | 'square';
-    /**
-     * Extra classes on the field wrapper.
-     * @default ""
-     */
-    className?: string;
-}): import("react").JSX.Element;

package/dist/types/components/AppMenubar.d.ts

@@ -1,50 +0,0 @@
-import "@webority/ui-elements/elements/menubar";
-/**
- * An application menubar (File, Edit, View) whose menus open on click and on the arrow keys. The
- * bar is one tab stop: Left and Right move across the menus, Down and Up open one, Right opens a
- * submenu, Escape closes a level and Tab leaves; a letter jumps to the next row starting with it.
- * Once a menu is open, pointing at another menu opens it instead. A row can carry a `shortcut`
- * hint, drawn as a key chip at its end; like `AppDropdown` it only shows and announces the key, the
- * page binds it. The behaviour is the shared `<wui-menubar>` element, the same one the Razor
- * `<app-menubar>` uses. For a site's top navigation with dropdown panels use `AppNavigationMenu`.
- *
- * NOTE: the exported component must stay the FIRST destructured function in this file —
- * the parity check reads the first signature it finds as the component's public props.
- *
- * @param {object} props
- * @param {{ key: string, label: string, disabled?: boolean, items: { key: string, label?: string, icon?: string|import('react').ReactNode, to?: string, onClick?: () => void, shortcut?: string, danger?: boolean, disabled?: boolean, divider?: boolean, items?: object[] }[] }[]} props.menus
- * @param {string} [props.ariaLabel]
- * @param {import('react').ElementType} [props.linkComponent] Component for `to` rows (e.g. Link).
- * @param {string} [props.className]
- */
-export default function AppMenubar(props: {
-    /** The menus, left to right. A row is an action or a link; a row with items opens a submenu; a divider row is a separator. */
-    menus: {
-        key: string;
-        label: string;
-        disabled?: boolean;
-        items: {
-            key: string;
-            label?: string;
-            icon?: string | import('react').ReactNode;
-            to?: string;
-            onClick?: () => void;
-            shortcut?: string;
-            danger?: boolean;
-            disabled?: boolean;
-            divider?: boolean;
-            items?: object[];
-        }[];
-    }[];
-    /**
-     * The accessible name of the bar.
-     * @default "Application menu"
-     */
-    ariaLabel?: string;
-    linkComponent?: import('react').ElementType;
-    /**
-     * Extra classes on the bar.
-     * @default ""
-     */
-    className?: string;
-}): import("react").JSX.Element;

package/dist/types/components/AppPagination.d.ts

@@ -1,39 +0,0 @@
-/**
- * Standalone numbered pagination for lists, cards, or search results.
- *
- * `page` is ONE-BASED, matching the shared 1-based pagination contract.
- * Renders nothing (null) when totalPages <= 1.
- *
- * @param {object} props
- * @param {number} props.page
- * @param {number} props.totalPages
- * @param {(page: number) => void} props.onChange Callback fired when a page is clicked.
- * @param {number} [props.siblings]
- * @param {'sm'|'md'} [props.size]
- * @param {string} [props.ariaLabel]
- * @param {string} [props.className]
- */
-export default function AppPagination(props: {
-    /** Current page, 1-based. The page button for this page carries aria-current set to page. */
-    page: number;
-    /** Total page count. The component renders nothing when it is 1 or less. */
-    totalPages: number;
-    onChange: (page: number) => void;
-    /**
-     * Window radius: how many page buttons sit either side of the current page before an ellipsis appears. The default of 1 shows the current page plus or minus one.
-     * @default 1
-     */
-    siblings?: number;
-    /**
-     * Control size: compact ('sm') or standard ('md').
-     * @default "md"
-     */
-    size?: 'sm' | 'md';
-    /**
-     * Accessible label for the nav element.
-     * @default "Pagination"
-     */
-    ariaLabel?: string;
-    /** Extra CSS class to add to the nav wrapper. */
-    className?: string;
-}): import("react").JSX.Element | null;

package/dist/types/components/AppSelectMini.d.ts

@@ -1,53 +0,0 @@
-import "@webority/ui-elements/elements/select";
-/**
- * A compact select for toolbars and filters, drawn by the shared `<wui-select>` element in compact mode.
- *
- * @param {object} props
- * @param {string} [props.value]
- * @param {(value: string) => void} [props.onChange] Called with the new value when the user picks an option.
- * @param {Array<{ value: string, label?: import('react').ReactNode, icon?: string }>} [props.options]
- * @param {string} [props.placeholder]
- * @param {string} [props.name]
- * @param {string} [props.ariaLabel]
- * @param {string} [props.id]
- * @param {boolean} [props.disabled]
- * @param {"sm"|"lg"} [props.size]
- * @param {string} [props.icon]
- * @param {string} [props.prefix]
- * @param {string} [props.className]
- */
-export default function AppSelectMini(props: {
-    /** The selected option's value. Unset, the control is cleared. */
-    value?: string;
-    onChange?: (value: string) => void;
-    /**
-     * The options. Omitted, the select has no options.
-     * @default []
-     */
-    options?: Array<{
-        value: string;
-        label?: import('react').ReactNode;
-        icon?: string;
-    }>;
-    /**
-     * Text shown while no value is selected.
-     * @default "Select..."
-     */
-    placeholder?: string;
-    /** Form field name of the select. */
-    name?: string;
-    /** Accessible name of the select. */
-    ariaLabel?: string;
-    /** Element id of the select. */
-    id?: string;
-    /** Disables the select so its value cannot change. */
-    disabled?: boolean;
-    /** Compact size around the default 32px picker. */
-    size?: "sm" | "lg";
-    /** A leading library icon, such as funnel or sort-down. */
-    icon?: string;
-    /** Static text before the value, such as Sort:. */
-    prefix?: string;
-    /** Extra classes on the select, so a caller can position or space it. */
-    className?: string;
-}): import("react").JSX.Element;

package/dist/types/components/AppSidebarMenu.d.ts

@@ -1,90 +0,0 @@
-/**
- * A slide-in sidebar or drawer panel on react-bootstrap `<Offcanvas>`.
- *
- * Offcanvas supplies the backdrop, slide animation, background scroll lock, Escape to close,
- * focus trap and ARIA dialog wiring. Opens from either side, or from the top or bottom. Themed
- * via the app tokens so it renders correctly in dark mode.
- *
- * @param {object} props
- * @param {boolean} props.show
- * @param {() => void} props.onHide Closes the panel: the header close button, the backdrop and Escape.
- * @param {"left"|"right"|"start"|"end"|"top"|"bottom"} [props.side]
- * @param {import('react').ReactNode} props.children The panel body.
- * @param {import('react').ReactNode} [props.title]
- * @param {string} [props.titleIcon]
- * @param {import('react').ReactNode} [props.header]
- * @param {import('react').ReactNode} [props.footer]
- * @param {string} [props.width]
- * @param {string} [props.maxWidth]
- * @param {"on"|"static"|"off"} [props.backdrop]
- * @param {boolean} [props.scroll]
- * @param {boolean} [props.keyboard]
- * @param {boolean} [props.closeButton]
- * @param {string} [props.closeLabel]
- * @param {string} [props.responsive]
- * @param {string} [props.className]
- * @param {string} [props.bodyClassName]
- * @param {string} [props.ariaLabel]
- */
-export default function AppSidebarMenu(props: {
-    /** Whether the panel is open. The caller owns this state. */
-    show: boolean;
-    onHide: () => void;
-    /**
-     * The edge it opens from. left and start open from the start edge, right and end from the end edge.
-     * @default "right"
-     */
-    side?: "left" | "right" | "start" | "end" | "top" | "bottom";
-    children: import('react').ReactNode;
-    /** Title of the default header bar. A text title also names the dialog, unless ariaLabel is set. */
-    title?: import('react').ReactNode;
-    /** Library icon beside the title in the default header bar. */
-    titleIcon?: string;
-    /** A custom header that replaces the default header bar entirely. */
-    header?: import('react').ReactNode;
-    /** A sticky footer for action buttons. */
-    footer?: import('react').ReactNode;
-    /** Panel width for a left or right panel, such as 480px. Unset, it is 420px. On a phone a left or right panel opens at the full screen width, and maxWidth still caps it there. */
-    width?: string;
-    /** Caps the panel width, such as 600px. Unset, the theme caps it at 92vw. */
-    maxWidth?: string;
-    /**
-     * The dimming backdrop: on shows it and a click outside closes the panel; static shows it and a click outside does not; off shows none.
-     * @default "on"
-     */
-    backdrop?: "on" | "static" | "off";
-    /**
-     * Allows the page behind the panel to scroll.
-     * @default false
-     */
-    scroll?: boolean;
-    /**
-     * Escape closes the panel.
-     * @default true
-     */
-    keyboard?: boolean;
-    /**
-     * Shows the header close button.
-     * @default true
-     */
-    closeButton?: boolean;
-    /**
-     * The close button's accessible name, for other languages.
-     * @default "Close"
-     */
-    closeLabel?: string;
-    /** Breakpoint, such as lg, below which the panel acts as an offcanvas and at or above which it renders inline. */
-    responsive?: string;
-    /**
-     * Extra classes on the panel.
-     * @default ""
-     */
-    className?: string;
-    /**
-     * Classes on the scrollable body region.
-     * @default ""
-     */
-    bodyClassName?: string;
-    /** Accessible name of the dialog. Unset, a text title names it. */
-    ariaLabel?: string;
-}): import("react").JSX.Element;

package/dist/types/components/AppTableEmptyState.d.ts

@@ -1,22 +0,0 @@
-/**
- * Empty ledger body for AppDataTable.
- *
- * @param {object} props
- * @param {string|import('react').ReactNode} [props.icon]
- * @param {string|import('react').ReactNode} [props.illustration]
- * @param {import('react').ReactNode} props.title
- * @param {import('react').ReactNode} [props.text]
- * @param {import('react').ReactNode} [props.action]
- */
-export default function AppTableEmptyState(props: {
-    /** An icon name or a custom node shown in a round bubble. Needed unless illustration is set, which replaces it. */
-    icon?: string | import('react').ReactNode;
-    /** A named drawing (no-results, no-data, empty-inbox, no-notifications, no-files, no-access, offline or error) or your own decorative SVG node, drawn unboxed at up to 120 px. It replaces the icon bubble when set. */
-    illustration?: string | import('react').ReactNode;
-    /** The heading: what would appear here. */
-    title: import('react').ReactNode;
-    /** A supporting line of guidance below the title. */
-    text?: import('react').ReactNode;
-    /** The next step, usually a small AppButton. */
-    action?: import('react').ReactNode;
-}): import("react").JSX.Element;