@webority/ui-react 0.80.2 → 0.80.4

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

@@ -1,50 +1,34 @@
 import "@webority/ui-elements/elements/autocomplete";
-/**
- * Searchable autocomplete over the shared `<wui-autocomplete>` element.
- *
- * Two modes:
- *   - **static** — pass `options` (`[{ value, label }]`); filtering is client-side.
- *   - **remote** — pass an async `loadOptions(query) => Promise<options>`; the field
- *     debounces typing, shows a spinner while your promise is in flight, then lists the
- *     results. You own the fetch; the component owns the UX. `options` given alongside it
- *     are the list shown until the first load result arrives, which replaces them.
- *
- * @param {object} props
- * @param {string} [props.value] Selected option value.
- * @param {(value: string, meta?: { isCustom: boolean }) => void} [props.onChange] The second
- *   argument reports whether the commit was a freeform entry (`allowCustom`) rather than a
- *   listed option — existing callers reading only the first argument are unaffected.
- * @param {Array<{ value: string, label: import('react').ReactNode }>} [props.options] Static options,
- *   or with `loadOptions` the initial list: shown before any load result arrives (and resolving a
- *   pre-filled value's label), then replaced by the first result; later changes are ignored.
- *   A label may be a node (`<>CO<sub>2</sub></>`): it renders as static markup in the menu, the
- *   input shows its text once chosen, and filtering and the option's accessible name use that
- *   text. Remote results from `loadOptions` take string labels only.
- * @param {string} [props.valueLabel] Text shown for `value` when `options` does not contain it, such as a
- *   selection loaded from the server. Omit it to keep the default: the field shows the value's option
- *   label, or nothing. Shown only while `value` is missing from the options.
- * @param {(query: string, opts?: { signal?: AbortSignal }) => Promise<{value: string, label: string}[]>} [props.loadOptions]
- *   Remote loader; receives an AbortSignal for the superseded request (optional to use).
- * @param {string} [props.placeholder]
- * @param {number} [props.minChars] Min chars before a remote search fires (default 1 in remote mode).
- *   0 is allowed: opening the field with an empty box calls `loadOptions("")` for the first page.
- * @param {number} [props.debounce] Debounce ms for remote search (default 250).
- * @param {boolean} [props.disabled]
- * @param {'sm'|'lg'} [props.size] Control size around the default.
- * @param {boolean} [props.allowCustom] When the typed text matches no option and the user
- *   commits (Enter, or blur with text), offers it as its own selectable "Add "…"" row and,
- *   once picked, commits that raw text as the value with `onChange`'s second argument
- *   reporting `{ isCustom: true }`.
- * @param {string} [props.name]
- * @param {string} [props.id] DOM id for the control and the label's `for` target.
- * @param {import('react').ReactNode} [props.label]
- * @param {string} [props.error]
- * @param {string} [props.hint]
- * @param {boolean} [props.required]
- * @param {import('react').ReactNode} [props.help] Help content shown in an info tip beside the label.
- * @param {string} [props.helpLabel="More information"] Accessible name for that info tip.
- * @param {string} [props.fieldClassName]
- * @param {import('react').Ref<HTMLElement>} [ref]
- */
-declare const AppAutocomplete: import("react").ForwardRefExoticComponent<import("react").RefAttributes<any>>;
+declare const AppAutocomplete: import("react").ForwardRefExoticComponent<{
+    value?: string;
+    onChange?: (value: string, meta?: {
+        isCustom: boolean;
+    }) => void;
+    options?: Array<{
+        value: string;
+        label: import('react').ReactNode;
+    }>;
+    valueLabel?: string;
+    loadOptions?: (query: string, opts?: {
+        signal?: AbortSignal;
+    }) => Promise<{
+        value: string;
+        label: string;
+    }[]>;
+    placeholder?: string;
+    minChars?: number;
+    debounce?: number;
+    disabled?: boolean;
+    size?: 'sm' | 'lg';
+    allowCustom?: boolean;
+    name?: string;
+    id?: string;
+    label?: import('react').ReactNode;
+    error?: string;
+    hint?: string;
+    required?: boolean;
+    help?: import('react').ReactNode;
+    helpLabel?: string;
+    fieldClassName?: string;
+} & import("react").RefAttributes<HTMLElement>>;
 export default AppAutocomplete;

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

@@ -1,47 +1,34 @@
-/**
- * Shows events on a month, week, day or list view, in India Standard Time, with weeks starting on
- * `firstDay` (Monday unless the theme or the prop says otherwise). The calendar is the shared
- * `<wui-calendar>` element, the same one the Razor `<app-calendar>` uses, with its calendar engine
- * loaded the first time a calendar mounts: a page without a calendar never downloads it.
- *
- * Give it events as data (`events`), or an address (`eventsUrl`) it calls whenever the visible
- * period changes, with `start` and `end` query parameters: IST `YYYY-MM-DD` days, `end` being the
- * first day not shown. The address answers with a JSON list of events. An event is
- * `{ id, title, start, end, allDay, tone, url }`: `start` and `end` are a `YYYY-MM-DD` day or an ISO
- * date-time (an offset or Z is shifted to IST, no offset is already IST); `end` is the first moment
- * after the event, so an all-day event on the 4th ends on the 5th; `tone` colours it from the theme
- * (neutral, primary, success, warning, danger, info); `url` makes it a link.
- *
- * Every day can be reached by keyboard: one tab stop among the days, the arrow keys move between
- * them, Home and End go to the first and last day of the week, Page Up and Page Down to the
- * previous and next month, Enter opens the day. A calendar given no `view` opens as a list when it
- * is narrower than a phone.
- *
- * ```jsx
- * <AppCalendar
- *     label="Team leave"
- *     eventsUrl="/api/leave"
- *     onEventClick={(event) => openLeave(event.id)}
- *     onDateClick={({ date }) => startRequest(date)}
- * />
- * ```
- *
- * @param {object} props
- * @param {string} [props.label='Calendar'] The name a screen reader hears for the calendar.
- * @param {{ id?: string|number, title: string, start: string, end?: string, allDay?: boolean, tone?: 'neutral'|'primary'|'success'|'warning'|'danger'|'info', url?: string }[]} [props.events] The events, instead of `eventsUrl`. Extra keys are kept and come back in `onEventClick`.
- * @param {string} [props.eventsUrl] Called with `start` and `end` (IST days) whenever the visible period changes; answers a JSON list of events.
- * @param {'month'|'week'|'day'|'list'} [props.view] The view to show. Without it a calendar opens on the month, or on the list when it is narrower than a phone.
- * @param {string} [props.date] The IST day (`YYYY-MM-DD`) to show; today when omitted. Changing it moves the calendar.
- * @param {string} [props.emptyText] What a list with no events says.
- * @param {0|1|2|3|4|5|6} [props.firstDay] First weekday of the calendar, 0 Sunday to 6 Saturday. Unset, it
- *   follows the theme's `--wui-first-day` token, which is 1 (Monday) unless the product sets it.
- * @param {string} [props.errorText] What is said when `eventsUrl` could not be loaded, and when the calendar's code could not.
- * @param {(event: object) => (void|false)} [props.onEventClick] An event was clicked, or Enter was pressed on it. Gets the event as it was given. Return `false` to stop an event's own link.
- * @param {(detail: { date: string, time: string|null, allDay: boolean }) => void} [props.onDateClick] A day was clicked, or Enter was pressed on it; `time` is set for a click on a time slot.
- * @param {(detail: { view: string, date: string, start: string, end: string, title: string }) => void} [props.onRangeChange] The view or the visible period changed.
- * @param {string} [props.className] Extra classes on the element.
- * @param {import('react').CSSProperties} [props.style] Inline style on the element.
- * @param {import('react').Ref<HTMLElement>} [ref] The `<wui-calendar>` element, which has `refetch()`.
- */
-declare const AppCalendar: import("react").ForwardRefExoticComponent<import("react").RefAttributes<any>>;
+declare const AppCalendar: import("react").ForwardRefExoticComponent<{
+    label?: string;
+    events?: {
+        id?: string | number;
+        title: string;
+        start: string;
+        end?: string;
+        allDay?: boolean;
+        tone?: 'neutral' | 'primary' | 'success' | 'warning' | 'danger' | 'info';
+        url?: string;
+    }[];
+    eventsUrl?: string;
+    view?: 'month' | 'week' | 'day' | 'list';
+    date?: string;
+    emptyText?: string;
+    firstDay?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    errorText?: string;
+    onEventClick?: (event: object) => (void | false);
+    onDateClick?: (detail: {
+        date: string;
+        time: string | null;
+        allDay: boolean;
+    }) => void;
+    onRangeChange?: (detail: {
+        view: string;
+        date: string;
+        start: string;
+        end: string;
+        title: string;
+    }) => void;
+    className?: string;
+    style?: import('react').CSSProperties;
+} & import("react").RefAttributes<HTMLElement>>;
 export default AppCalendar;

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

@@ -1,56 +1,70 @@
-/**
- * Draws a line, area, column, horizontal bar, donut, heatmap, calendar heatmap, funnel, gauge,
- * waterfall, treemap, sankey, scatter, bubble or small-multiples chart from rows of data. The chart is the
- * shared `<wui-chart>` element, the same one the Razor `<app-chart>` uses, with its drawing engine
- * loaded the first time a chart mounts: a page without a chart never downloads it.
- *
- * You describe the chart; you never touch the engine. Every chart comes with a legend that shows
- * and hides series, tooltips, arrow-key movement between points (each value read aloud), a real
- * data table behind the picture, a screen-reader summary, light and dark colours from the theme,
- * resize, and PNG and CSV export through the element (see AppChartCard for the buttons).
- *
- * Money is rupees, or paise when `format.unit` says so. Dates show in IST. A `percent` value is a
- * ratio: 0.125 shows as 12.5%.
- *
- * ```jsx
- * <AppChart
- *     type="column"
- *     title="Revenue by month"
- *     data={[{ month: "Aug", revenue: 4120000 }, { month: "Sep", revenue: 4630000 }]}
- *     x={{ key: "month" }}
- *     series={[{ key: "revenue", label: "Revenue", format: { style: "currency" } }]}
- *     onSelect={(detail) => console.log(detail.x, detail.value)}
- * />
- * ```
- *
- * @param {object} props
- * @param {'line'|'area'|'column'|'bar'|'donut'|'heatmap'|'calendar'|'funnel'|'gauge'|'waterfall'|'treemap'|'sankey'|'scatter'|'bubble'|'multiples'} props.type `column` is vertical bars, `bar` horizontal. `multiples` draws each series as its own small chart under one shared x axis.
- * @param {string} props.title Required. Names the chart for assistive tech and names exported files. An empty string counts as not given.
- * @param {string} [props.description] One sentence a screen reader hears before the automatic summary.
- * @param {Record<string, string|number|null>[]} props.data One row per x position, slice, cell, stage, flow or point: what a row is depends on the type.
- * @param {{ key: string, kind?: 'category'|'time'|'value', format?: object, label?: string }} props.x The column holding the x value. `time` takes epoch ms, an ISO instant or a "YYYY-MM-DD" day; `value` (scatter and bubble) is a number. A calendar is always `time`, a scatter and a bubble always `value`.
- * @param {{ key: string, label: string, format?: object }[]} props.series The value columns, in the order they take colours: at most 8. Every type but line, area, column, bar and multiples takes one.
- * @param {{ key: string, label?: string }} [props.group] The second dimension: a heatmap's rows, a treemap's parents, a scatter or bubble's colour groups (at most 3). Required for a heatmap and a treemap.
- * @param {{ key: string, label?: string }} [props.to] Where each sankey flow ends; `x` is where it starts. Required for a sankey.
- * @param {{ key: string, label?: string, format?: object }} [props.size] A bubble's area. Required for a bubble.
- * @param {boolean} [props.trend] A scatter or bubble's straight trend line through the visible points.
- * @param {boolean} [props.zoom] A zoom slider under a line or area. On by default above 5,000 rows.
- * @param {{ upTo: number, label: string }[]} [props.bands] A gauge's named stretches of its scale, each up to a value.
- * @param {'none'|'stacked'|'percent'} [props.stack='none'] For area, column and bar.
- * @param {{ label?: string, format?: object, min?: number, max?: number }} [props.y] The one value axis. There is no second axis: show another measure as its own chart.
- * @param {{ value: number, label: string }} [props.target] A dashed reference line.
- * @param {number} [props.height=320] In px, the axis labels included. A value that is not above 0 draws at the default.
- * @param {'ready'|'loading'|'empty'|'error'} [props.state='ready'] `loading` after a first draw keeps that picture on screen, dimmed.
- * @param {string} [props.emptyText] Replaces the default empty message.
- * @param {string} [props.errorText] Replaces the default error message. Say what the person can do.
- * @param {'auto'|'svg'|'canvas'} [props.renderer='auto'] `auto` draws SVG, and canvas above 5,000 points.
- * @param {'chart'|'table'} [props.view='chart'] `table` shows the data table in the chart's place.
- * @param {(detail: { series: string, label: string, x: unknown, value: number|null, row: object, index: number }) => void} [props.onSelect] A mark was clicked, or Enter was pressed on the focused point.
- * @param {(detail: { visible: Record<string, boolean> }) => void} [props.onLegendChange] A legend button was pressed.
- * @param {(detail: { renderer: string }) => void} [props.onReady] The first picture has finished drawing.
- * @param {string} [props.className] Extra classes on the element.
- * @param {import('react').CSSProperties} [props.style] Inline style on the element.
- * @param {import('react').Ref<HTMLElement>} [ref] The `<wui-chart>` element, which has `toCsv()`, `toPng()`, `exportCsv()` and `exportPng()`.
- */
-declare const AppChart: import("react").ForwardRefExoticComponent<import("react").RefAttributes<any>>;
+declare const AppChart: import("react").ForwardRefExoticComponent<{
+    type: 'line' | 'area' | 'column' | 'bar' | 'donut' | 'heatmap' | 'calendar' | 'funnel' | 'gauge' | 'waterfall' | 'treemap' | 'sankey' | 'scatter' | 'bubble' | 'multiples';
+    title: string;
+    description?: string;
+    data: Record<string, string | number | null>[];
+    x: {
+        key: string;
+        kind?: 'category' | 'time' | 'value';
+        format?: object;
+        label?: string;
+    };
+    series: {
+        key: string;
+        label: string;
+        format?: object;
+    }[];
+    group?: {
+        key: string;
+        label?: string;
+    };
+    to?: {
+        key: string;
+        label?: string;
+    };
+    size?: {
+        key: string;
+        label?: string;
+        format?: object;
+    };
+    trend?: boolean;
+    zoom?: boolean;
+    bands?: {
+        upTo: number;
+        label: string;
+    }[];
+    stack?: 'none' | 'stacked' | 'percent';
+    y?: {
+        label?: string;
+        format?: object;
+        min?: number;
+        max?: number;
+    };
+    target?: {
+        value: number;
+        label: string;
+    };
+    height?: number;
+    state?: 'ready' | 'loading' | 'empty' | 'error';
+    emptyText?: string;
+    errorText?: string;
+    renderer?: 'auto' | 'svg' | 'canvas';
+    view?: 'chart' | 'table';
+    onSelect?: (detail: {
+        series: string;
+        label: string;
+        x: unknown;
+        value: number | null;
+        row: object;
+        index: number;
+    }) => void;
+    onLegendChange?: (detail: {
+        visible: Record<string, boolean>;
+    }) => void;
+    onReady?: (detail: {
+        renderer: string;
+    }) => void;
+    className?: string;
+    style?: import('react').CSSProperties;
+} & import("react").RefAttributes<HTMLElement>>;
 export default AppChart;

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

@@ -1,19 +1,9 @@
-/**
- * Shared checkbox on Bootstrap `.form-check` markup (Razor <app-checkbox> matches).
- * Theme restyles `.form-check-input` as the one selection glyph; table row-select
- * uses the `.wui-check` alias of the same skin.
- *
- * The label is bound with id/htmlFor rather than react-bootstrap's `label` prop:
- * that rendered a <label> with no `for`, so clicking the text did nothing.
- *
- * @param {object} props
- * @param {import('react').ReactNode} [props.label]
- * @param {string} [props.id]
- * @param {string} [props.name]
- * @param {string} [props.error] Error message, rendered below the control. Replaces the hint.
- * @param {string} [props.hint] Helper text below the control. Hidden while an error is shown.
- * @param {string} [props.className]
- * @param {import('react').Ref<HTMLInputElement>} [ref]
- */
-declare const AppCheckbox: import("react").ForwardRefExoticComponent<import("react").RefAttributes<any>>;
+declare const AppCheckbox: import("react").ForwardRefExoticComponent<{
+    label?: import('react').ReactNode;
+    id?: string;
+    name?: string;
+    error?: string;
+    hint?: string;
+    className?: string;
+} & import("react").RefAttributes<HTMLInputElement>>;
 export default AppCheckbox;

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

@@ -1,14 +1,11 @@
 import "@webority/ui-elements/elements/country-select";
-/**
- * @param {object} props
- * @param {string} [props.value] Selected ISO 3166-1 alpha-2 code, e.g. "IN".
- * @param {(value: string) => void} [props.onChange] Called with the chosen ISO code.
- * @param {string[]} [props.countries] Limit the list to these ISO codes (alphabetical by name).
- *   Omitted, every country is listed.
- * @param {boolean} [props.searchable=true] Show the search box in the menu.
- * @param {'sm'|'md'|'lg'} [props.size='md'] Control size, same as AppInput.
- * @param {string} [props.className] Class to apply to the control element.
- * @param {string} [props.fieldClassName] Class to apply to the wrapper field div.
- */
-declare const AppCountrySelect: import("react").ForwardRefExoticComponent<import("react").RefAttributes<any>>;
+declare const AppCountrySelect: import("react").ForwardRefExoticComponent<{
+    value?: string;
+    onChange?: (value: string) => void;
+    countries?: string[];
+    searchable?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    className?: string;
+    fieldClassName?: string;
+} & import("react").RefAttributes<any>>;
 export default AppCountrySelect;

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

@@ -1,36 +1,22 @@
 import "@webority/ui-elements/elements/datepicker";
-/**
- * Thin React wrapper over the shared `<wui-datepicker>` element (single
- * implementation, so React and Razor render the same control).
- *
- * Wraps it in the standard `.field` shell — label / required mark / hint /
- * error — the same as `<app-date-picker>` and every other field primitive.
- * Without that a caller had to hand-roll the label, which is exactly the
- * per-screen divergence this library exists to prevent. The shell is omitted
- * entirely when there is nothing to render around the control.
- *
- * @param {object} props
- * @param {string} [props.value]              ISO date string
- * @param {(value: string) => void} [props.onChange]
- * @param {string} [props.label]
- * @param {boolean} [props.required]
- * @param {string} [props.hint]
- * @param {string} [props.error]
- * @param {string} [props.name]
- * @param {string} [props.min]
- * @param {string} [props.max]
- * @param {string} [props.placeholder="Choose a date"]
- * @param {boolean} [props.disabled]
- * @param {'sm'|'md'|'lg'} [props.size] Control height tier, matching AppInput.
- * @param {0|1|2|3|4|5|6} [props.firstDay] First weekday of the calendar, 0 Sunday to 6 Saturday. Unset, it
- *   follows the theme's `--wui-first-day` token, which is 1 (Monday) unless the product sets it.
- * @param {string} [props.displayFormat="dd-MMM-yyyy"] How the chosen date reads in the field, from the tokens
- *   yyyy, MMMM, MMM, MM, dd and d (for example `dd/MM/yyyy`). The `onChange` value stays ISO.
- * @param {string} [props.id]
- * @param {string} [props.ariaLabel]
- * @param {string} [props.className] Classes for the `<wui-datepicker>` control itself.
- * @param {string} [props.fieldClassName] Classes for the `.field` wrapper (label/hint/error shell).
- * @param {import('react').Ref<HTMLElement>} [ref]
- */
-declare const AppDatePicker: import("react").ForwardRefExoticComponent<import("react").RefAttributes<any>>;
+declare const AppDatePicker: import("react").ForwardRefExoticComponent<{
+    value?: string;
+    onChange?: (value: string) => void;
+    label?: string;
+    required?: boolean;
+    hint?: string;
+    error?: string;
+    name?: string;
+    min?: string;
+    max?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    firstDay?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    displayFormat?: string;
+    id?: string;
+    ariaLabel?: string;
+    className?: string;
+    fieldClassName?: string;
+} & import("react").RefAttributes<HTMLElement>>;
 export default AppDatePicker;

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

@@ -1,40 +1,31 @@
 import "@webority/ui-elements/elements/date-range";
-/**
- * Thin React wrapper over the shared `<wui-date-range>` element — a start/end date range
- * field with a two-month popover calendar (single implementation, so React and Razor render
- * the same control). Wrapped in the standard `.field` shell — label / required mark / hint /
- * error — the same as `<app-date-range-picker>` and every other field primitive.
- *
- * Controlled through two ISO strings; `onChange` fires with `{ start, end }` when the range
- * completes or is cleared.
- *
- * @param {object} props
- * @param {string} [props.start]  Range start as an ISO date string (YYYY-MM-DD).
- * @param {string} [props.end]    Range end as an ISO date string (YYYY-MM-DD).
- * @param {(range: { start: string, end: string }) => void} [props.onChange]
- * @param {string} [props.label]
- * @param {boolean} [props.required]
- * @param {string} [props.hint]
- * @param {string} [props.error]
- * @param {string} [props.startName] Form field name the start date posts under.
- * @param {string} [props.endName]   Form field name the end date posts under.
- * @param {string} [props.min]
- * @param {string} [props.max]
- * @param {string} [props.placeholder="Start to End"]
- * @param {boolean} [props.disabled]
- * @param {'sm'|'md'|'lg'} [props.size] Control height tier, matching AppInput.
- * @param {0|1|2|3|4|5|6} [props.firstDay] First weekday of the calendar, 0 Sunday to 6 Saturday. Unset, it
- *   follows the theme's `--wui-first-day` token, which is 1 (Monday) unless the product sets it.
- * @param {(('today'|'yesterday'|'last7Days'|'last30Days'|'thisMonth'|'lastMonth'|'thisFinancialYear')|{ label: string, start: string, end: string })[]} [props.presets]
- *   Quick ranges, listed beside the calendar (above it on a phone); picking one fills the range and
- *   closes the calendar. An item is a name, resolved against today in IST (`thisFinancialYear` runs
- *   1 April to 31 March; `thisMonth` and `lastMonth` span the whole month), or `{ label, start, end }`
- *   with ISO dates. A preset outside `min`/`max` is disabled.
- * @param {string} [props.id]
- * @param {string} [props.ariaLabel]
- * @param {string} [props.className] Class to apply to the control element.
- * @param {string} [props.fieldClassName] Class to apply to the wrapper field div.
- * @param {import('react').Ref<HTMLElement>} [ref]
- */
-declare const AppDateRangePicker: import("react").ForwardRefExoticComponent<import("react").RefAttributes<any>>;
+declare const AppDateRangePicker: import("react").ForwardRefExoticComponent<{
+    start?: string;
+    end?: string;
+    onChange?: (range: {
+        start: string;
+        end: string;
+    }) => void;
+    label?: string;
+    required?: boolean;
+    hint?: string;
+    error?: string;
+    startName?: string;
+    endName?: string;
+    min?: string;
+    max?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    firstDay?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    presets?: (('today' | 'yesterday' | 'last7Days' | 'last30Days' | 'thisMonth' | 'lastMonth' | 'thisFinancialYear') | {
+        label: string;
+        start: string;
+        end: string;
+    })[];
+    id?: string;
+    ariaLabel?: string;
+    className?: string;
+    fieldClassName?: string;
+} & import("react").RefAttributes<HTMLElement>>;
 export default AppDateRangePicker;

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

@@ -10,7 +10,8 @@
  * the tighter widget/tile variant (smaller title + text).
  *
  * @param {object} props
- * @param {string|import('react').ReactNode} props.icon  Semantic icon name for the bubble, or a custom node
+ * @param {string|import('react').ReactNode} [props.icon]  Semantic icon name for the bubble, or a custom node.
+ *   Needed unless `illustration` is set, which replaces the bubble.
  * @param {string|import('react').ReactNode} [props.illustration] A named drawing ("no-results" | "no-data" | "empty-inbox" | "no-notifications" | "no-files" | "no-access" | "offline" | "error"), or your own decorative SVG node drawn unboxed at up to 120 px. Replaces the icon bubble when set.
  * @param {number} [props.iconSize=24]
  * @param {"md"|"sm"} [props.size="md"]
@@ -21,7 +22,7 @@
  * @param {import('react').CSSProperties} [props.style]
  */
 export default function AppEmptyState({ icon, illustration, iconSize, size, title, text, action, className, style, ...rest }: {
-    icon: string | import('react').ReactNode;
+    icon?: string | import('react').ReactNode;
     illustration?: string | import('react').ReactNode;
     iconSize?: number;
     size?: "md" | "sm";

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

@@ -1,56 +1,24 @@
-/**
- * Shows a file inside the page: a toolbar with the file's name and the controls its kind
- * needs, and the file below it: a PDF (drawn with pdf.js), an image, a video or an audio file.
- * A file it cannot show gets a message and a download link instead.
- *
- * Wraps the shared `<wui-file-viewer>` element, the same one the Razor `<app-file-viewer>`
- * uses. The element lives in its own entry, `@webority/ui-elements/file-viewer`, because
- * pdf.js is large: this component loads it when it first mounts, so a page without a viewer
- * never downloads it.
- *
- * The viewer fills the box its parent gives it; the theme gives it a default height.
- *
- * ```jsx
- * const viewer = useRef(null);
- * <AppButton onClick={() => viewer.current.seekTo(30)}>Jump to 0:30</AppButton>
- * <AppFileViewer ref={viewer} src="/files/briefing.mp4" />
- *
- * <AppFileViewer
- *     src="/files/contract.pdf"
- *     name="Contract.pdf"
- *     download
- *     actions={<AppButton size="sm">Approve</AppButton>}
- *     onError={(detail) => console.warn(detail.message)}
- * />
- * ```
- *
- * @param {object} props
- * @param {string} props.src The file's URL. Changing it opens the new file.
- * @param {string} [props.name] The name shown in the toolbar and used for printing and download. Defaults to the last part of `src`.
- * @param {string} [props.type] The file's MIME type. Defaults to a guess from the extension of `name` or `src`.
- * @param {object} [props.prefs] The view settings to start from, when your app stores them itself (for example
- *   against the signed-in person). Read when a file opens. With it, the browser stores nothing; save what
- *   `onPrefsChange` hands you and pass it back next time.
- * @param {(prefs: object) => void} [props.onPrefsChange] Called with all the view settings whenever the reader
- *   changes one (zoom, two-page view, thumbnails, volume, speed).
- * @param {string} [props.viewKey] Remembers the view settings (zoom, two-page view, thumbnails)
- *   in this browser under this key. Without it they last for the viewer's life.
- * @param {boolean} [props.download=false] Shows a download button in the toolbar.
- * @param {boolean} [props.print=true] Shows the print button for a PDF or an image. Pass false to hide it.
- * @param {string} [props.workerSrc] URL of a hosted pdf.js worker, for a site whose content
- *   security policy refuses blob: workers. Defaults to the bundled copy.
- * @param {string} [props.captions] A WebVTT captions file for a video; adds a captions button to the player.
- * @param {string} [props.assetBase] Folder holding pdf.js's cmaps/, standard_fonts/ and wasm/,
- *   which unusual PDFs need (Asian text, fonts a file does not embed, some scanned images).
- * @param {import('react').ReactNode} [props.actions] Your own controls, shown at the end of the toolbar. Hidden in full screen.
- * @param {(detail: { kind: string, pages: number }) => void} [props.onLoad] Called once the file shows, with its kind and page count.
- * @param {(detail: { message: string }) => void} [props.onError] Called when the file cannot be opened.
- * @param {string} [props.className] Extra classes on the element.
- * @param {import('react').CSSProperties} [props.style] Inline style; lands on the element with `className`. Set a height here to size the viewer.
- * @param {import('react').Ref<HTMLElement>} [ref] The `<wui-file-viewer>` element. For a video or audio file,
- *   `ref.current.seekTo(seconds)` moves the player to that point, kept within the file's length, and returns
- *   true; with no video or audio open (another kind of file, or before `onLoad`) it does nothing and returns
- *   false. Anything but a finite number of seconds throws.
- */
-declare const AppFileViewer: import("react").ForwardRefExoticComponent<import("react").RefAttributes<any>>;
+declare const AppFileViewer: import("react").ForwardRefExoticComponent<{
+    src: string;
+    name?: string;
+    type?: string;
+    prefs?: object;
+    onPrefsChange?: (prefs: object) => void;
+    viewKey?: string;
+    download?: boolean;
+    print?: boolean;
+    workerSrc?: string;
+    captions?: string;
+    assetBase?: string;
+    actions?: import('react').ReactNode;
+    onLoad?: (detail: {
+        kind: string;
+        pages: number;
+    }) => void;
+    onError?: (detail: {
+        message: string;
+    }) => void;
+    className?: string;
+    style?: import('react').CSSProperties;
+} & import("react").RefAttributes<HTMLElement>>;
 export default AppFileViewer;