@cwellt_software/cwellt-reactjs-lib 1.6.2 → 1.7.0

package/dist/index.d.ts

@@ -793,8 +793,8 @@ interface CwCardProps {
 *   onDelete={confirmDeletion}
 *   footer="Last updated: 2 days ago"
 *   chips={[
-*     { label: 'Important', colorScheme: 'danger' },
-*     { label: 'Custom', colorScheme: 'custom', customColor: '#8a2be2' }
+*     { label: 'Important', color: 'danger' },
+*     { label: 'Custom', color: 'custom', customColor: '#8a2be2' }
 *   ]}
 * >
 *   <p>This is the main content of the card.</p>
@@ -3729,6 +3729,7 @@ interface SchedulerEventDm {
     width: number;
     order?: number;
     icons?: ReactElement;
+    /** Colour bars shown instead of `name` / `label`, one equal-width bar per entry. */
     rectangleColors?: string[];
     tooltip?: ReactNode;
     /** Optional content rendered in the strip above the (centered) event box, within the event's lane. */
@@ -3740,6 +3741,19 @@ interface SchedulerEventDm {
     alpha?: number;
     /** Extra inline styles applied to the event box. Merged last — overrides computed styles. */
     style?: React.CSSProperties;
+    /** Dot `CwBadge` sticking out of the top-right corner of the box, e.g. a warning on the event. */
+    cornerMarker?: SchedulerEventCornerMarker;
+    /** Content drawn inside the box behind the name and icons (e.g. segments, a hatch over part of the bar). Clipped to the box, never catches the mouse. The label gets a halo in the box colour so it stays readable over it. */
+    underlay?: ReactNode;
+    /** Replaces `name` inside the box with own content (e.g. a second line). It inherits the contrast text colour. `rectangleColors` replaces both, so the two are mutually exclusive. */
+    label?: ReactNode;
+}
+interface SchedulerEventCornerMarker {
+    color: BadgeColorScheme;
+    /** Without it the marker lets clicks and hover through to the event. */
+    tooltip?: ReactNode;
+    /** Pulses the dot to tell the most urgent markers apart. */
+    pulse?: boolean;
 }
 interface SchedulerEventState<T extends SchedulerEventDm> {
     value: T;
@@ -3763,6 +3777,8 @@ interface RowHeaderDm {
     subtitle?: string;
     subtitle2?: string;
     rowHeightRem?: number;
+    /** Background of the header cell, any CSS colour (tokens included). Text contrast is up to the caller. */
+    highlightColor?: string;
 }
 interface RowHeaderProps<T extends RowHeaderDm> {
     value: T;
@@ -3851,7 +3867,6 @@ interface PinRowHeaderProps extends RowHeaderDm {
     isPinned: boolean;
     contextMenuItems: MenuOption[];
     isLoading: boolean;
-    highlightColor?: string;
     tooltip?: ReactNode;
     indicators?: ReactNode;
 }
@@ -3890,6 +3905,683 @@ declare class OnClearPinned implements UiEvent {
     constructor();
 }
 
+/** Answer of the render, page and sort routes: one soft page of the processed report. */
+interface RdlRenderResult {
+    RenderId: string;
+    ReportId: string;
+    Name: string;
+    Culture: string;
+    /** Width of the report body. */
+    BodyWidth: number;
+    /** Interactive page height used to cut soft pages (0 = one page). */
+    PageHeight: number;
+    PageCount: number;
+    Page: RdlRenderPage;
+    /** A dataset query was refused by the database permissions (legacy "SQL ERROR" dialog). */
+    PermissionDenied: boolean;
+    Warnings: string[];
+}
+interface RdlRenderPage {
+    Number: number;
+    /** Height of the body content on this page. */
+    Height: number;
+    /** Width of the page content: the body width or the right edge of the widest item, whichever is larger. Missing in older payloads. */
+    Width?: number | null;
+    Items: RdlRenderItem[];
+    /** Null when the report has none or does not print it on this page. */
+    Header?: RdlRenderPageSection | null;
+    Footer?: RdlRenderPageSection | null;
+}
+interface RdlRenderPageSection {
+    Height: number;
+    Style?: RdlRenderStyle | null;
+    Items: RdlRenderItem[];
+}
+/** The item is hidden while `InitiallyHidden` XOR "toggle `Id` was flipped" is true. */
+interface RdlToggleRef {
+    Id: string;
+    InitiallyHidden: boolean;
+}
+interface RdlRenderItemBase {
+    Name: string;
+    Top: number;
+    Left: number;
+    Width: number;
+    Height: number;
+    Style?: RdlRenderStyle | null;
+    Toggles?: RdlToggleRef[] | null;
+}
+interface RdlRenderTextbox extends RdlRenderItemBase {
+    Kind: "textbox";
+    Paragraphs: RdlRenderParagraph[];
+    CanGrow: boolean;
+    /** Set when this textbox is a drilldown toggle: the id the toggled items refer to. */
+    ToggleId?: string | null;
+    /** Initial state of the +/- icon: true shows "-". */
+    ToggleExpanded?: boolean | null;
+    /** Set when the textbox carries an interactive sort. */
+    SortId?: string | null;
+    /** "Ascending" / "Descending" when this sort is active. */
+    SortDirection?: string | null;
+}
+interface RdlRenderParagraph {
+    Style?: RdlRenderStyle | null;
+    /** "Bulleted" / "Numbered", else none. */
+    ListStyle?: string | null;
+    ListLevel: number;
+    Runs: RdlRenderRun[];
+}
+/** Always plain text; a line break inside a run is "\n". */
+interface RdlRenderRun {
+    Text: string;
+    Style?: RdlRenderStyle | null;
+    /** http(s) / mailto link. */
+    Href?: string | null;
+}
+interface RdlRenderRectangle extends RdlRenderItemBase {
+    Kind: "rectangle";
+    Items: RdlRenderItem[];
+}
+interface RdlRenderLine extends RdlRenderItemBase {
+    Kind: "line";
+}
+interface RdlRenderImage extends RdlRenderItemBase {
+    Kind: "image";
+    /** External, Embedded or Database. */
+    Source: string;
+    /** External: the evaluated http(s) URL. */
+    Url?: string | null;
+    /** Embedded / Database: the id for the image route. */
+    ImageId?: string | null;
+    /** AutoSize, Fit, FitProportional or Clip. */
+    Sizing: string;
+}
+interface RdlRenderTable extends RdlRenderItemBase {
+    Kind: "table";
+    ColumnWidths: number[];
+    Rows: RdlRenderTableRow[];
+    NoRowsMessage?: string | null;
+    Error?: string | null;
+}
+interface RdlRenderTableRow {
+    Height: number;
+    Cells: RdlRenderTableCell[];
+    Toggles?: RdlToggleRef[] | null;
+    /** Pagination hints already applied by the server; the viewer ignores them. */
+    RepeatOnNewPage?: boolean | null;
+    PageBreakBefore?: boolean | null;
+    KeepWithNext?: boolean | null;
+    KeepWithPrevious?: boolean | null;
+}
+interface RdlRenderTableCell {
+    /** 0-based output column the cell starts in. */
+    Column: number;
+    ColSpan: number;
+    RowSpan: number;
+    Content?: RdlRenderItem | null;
+    Toggles?: RdlToggleRef[] | null;
+}
+/** A category axis label at a position in category units: 0 = the first category's point, fractions lie between two. */
+interface RdlRenderChartAxisLabel {
+    Position: number;
+    Text: string;
+}
+interface RdlRenderChart extends RdlRenderItemBase {
+    Kind: "chart";
+    Titles: string[];
+    CategoryAxisTitle?: string | null;
+    ValueAxisTitle?: string | null;
+    /** .NET format string of the primary value axis (<Format>, e.g. "N0", "0%", "#,##0.00"); null = none. */
+    ValueAxisFormat?: string | null;
+    /**
+     * Category axis labels the server laid out (dates): drawn instead of the viewer's own labels.
+     * Null unless the categories are dates.
+     */
+    CategoryAxisLabels?: RdlRenderChartAxisLabel[] | null;
+    /** Gridlines at the category labels. @default true */
+    CategoryAxisGridLines?: boolean;
+    /** Gridlines at the value axis ticks. @default true */
+    ValueAxisGridLines?: boolean;
+    LegendHidden: boolean;
+    /** RDL ChartLegend Position (TopLeft, TopCenter, RightTop, LeftCenter, BottomCenter, ...); missing = the RDL default, a column on the right. */
+    LegendPosition?: string | null;
+    /** RDL palette name for series without a color of their own. */
+    Palette?: string | null;
+    Categories: string[];
+    Series: RdlRenderChartSeries[];
+    NoRowsMessage?: string | null;
+    Error?: string | null;
+}
+interface RdlRenderChartSeries {
+    Name: string;
+    /** Line, Shape, Column, Bar, Area, ... */
+    Type: string;
+    /** Smooth, Stepped, Pie, ... */
+    Subtype?: string | null;
+    Color?: string | null;
+    ShowDataLabels: boolean;
+    /** One value per category; null = no data point. */
+    Values: (number | null)[];
+    /** None, Square, Circle, Diamond, Triangle, Cross (a "+"), Star4, Star5, Star6, Star10 (Auto resolved by the server); missing = no marker. */
+    MarkerType?: string | null;
+    /** Marker size as an RDL size ("10pt"); missing = 5pt. */
+    MarkerSize?: string | null;
+}
+interface RdlRenderGaugePanel extends RdlRenderItemBase {
+    Kind: "gauge";
+    Gauges: RdlRenderGauge[];
+    /** State indicators of the panel; missing in older payloads. */
+    StateIndicators?: RdlRenderStateIndicator[] | null;
+    Labels: string[];
+    Error?: string | null;
+}
+/** A state indicator in its active state. Left, Top, Width and Height are percent of the panel box. */
+interface RdlRenderStateIndicator {
+    Name: string;
+    Value?: number | null;
+    /** Color of the active state; null = nothing to draw. */
+    Color?: string | null;
+    /** RDL IndicatorStyle of the active state (Circle, TrafficLightUnrimmed, ...). */
+    Shape?: string | null;
+    Left: number;
+    Top: number;
+    Width: number;
+    Height: number;
+}
+interface RdlRenderGauge {
+    Name: string;
+    /** RadialGauge or LinearGauge. */
+    Kind: string;
+    Scales: RdlRenderGaugeScale[];
+}
+interface RdlRenderGaugeScale {
+    Minimum: number;
+    Maximum: number;
+    /** Major tick interval as computed by the server; missing = the viewer's nice step. */
+    Interval?: number | null;
+    /** Whether the scale shows its major tick marks and labels. @default true */
+    ShowLabels?: boolean;
+    Pointers: RdlRenderGaugePointer[];
+    Ranges: RdlRenderGaugeRange[];
+}
+interface RdlRenderGaugePointer {
+    Value?: number | null;
+    /** Needle, Marker or Bar. */
+    Type?: string | null;
+    Color?: string | null;
+    /** Thickness in percent of the gauge's own size (a horizontal linear gauge: its height). */
+    Width?: number | null;
+    /** Inside, Outside or Cross (relative to the scale). */
+    Placement?: string | null;
+}
+interface RdlRenderGaugeRange {
+    Start?: number | null;
+    End?: number | null;
+    /** The range background color of the RDL; missing = the palette. */
+    Color?: string | null;
+    /** Thickness in percent of the gauge's own size (a horizontal linear gauge: its height). */
+    Width?: number | null;
+    /** Inside, Outside or Cross (relative to the scale); missing = Cross. */
+    Placement?: string | null;
+}
+/** An element the viewer does not support, drawn as an empty box. */
+interface RdlRenderPlaceholder extends RdlRenderItemBase {
+    Kind: "placeholder";
+    Element: string;
+    Reason: string;
+}
+/** Discriminated by `Kind`. */
+type RdlRenderItem = RdlRenderTextbox | RdlRenderRectangle | RdlRenderLine | RdlRenderImage | RdlRenderTable | RdlRenderChart | RdlRenderGaugePanel | RdlRenderPlaceholder;
+type RdlRenderItemKind = RdlRenderItem["Kind"];
+/** A resolved style in the RDL vocabulary ("10pt", color names or #RRGGBB, BorderStyle Solid/Dotted/...). */
+interface RdlRenderStyle {
+    BackgroundColor?: string | null;
+    Color?: string | null;
+    FontFamily?: string | null;
+    FontSize?: string | null;
+    FontStyle?: string | null;
+    FontWeight?: string | null;
+    TextDecoration?: string | null;
+    TextAlign?: string | null;
+    VerticalAlign?: string | null;
+    LineHeight?: string | null;
+    PaddingLeft?: string | null;
+    PaddingRight?: string | null;
+    PaddingTop?: string | null;
+    PaddingBottom?: string | null;
+    BorderTop?: RdlRenderBorder | null;
+    BorderBottom?: RdlRenderBorder | null;
+    BorderLeft?: RdlRenderBorder | null;
+    BorderRight?: RdlRenderBorder | null;
+}
+interface RdlRenderBorder {
+    Color?: string | null;
+    Style?: string | null;
+    Width?: string | null;
+}
+/** Body of the sort route. */
+interface RdlSortRequest {
+    SortId: string;
+    /** "Ascending" or "Descending"; anything else toggles the current direction. */
+    Direction?: string | null;
+}
+/** A typed value as the API sends it: dates as ISO 8601 text, numbers, booleans or text. */
+type RdlParameterValue = string | number | boolean | null;
+/** The parameter form, in the order legacy showed it. */
+interface RdlReportParameters {
+    ReportId: string;
+    Culture: string;
+    Parameters: RdlReportParameter[];
+}
+interface RdlReportParameter {
+    Name: string;
+    Prompt?: string | null;
+    /** String, Boolean, DateTime, Integer or Float. */
+    DataType: string;
+    /** DropDownList, DateTime, Boolean, Float, Integer or TextBox. */
+    InputType: string;
+    Hidden: boolean;
+    MultiValue: boolean;
+    Nullable: boolean;
+    AllowBlank: boolean;
+    ValidValuesDataSet?: string | null;
+    DefaultValuesDataSet?: string | null;
+    ValidValues: RdlParameterOption[];
+    /** Set when the valid-values query failed; the dropdown is then empty. */
+    ValidValuesError?: string | null;
+    /** The values the form shows, typed: submitted, else the default. Empty = none. */
+    Values: RdlParameterValue[];
+    /** Set when a default expression failed or a submitted value does not fit the data type. */
+    ValueError?: string | null;
+    /** Earlier parameters whose change alters this one's options or default. */
+    DependsOn: string[];
+    /** "UserName" or "IDCardID" when the server fills the value. */
+    ServerValue?: string | null;
+}
+interface RdlParameterOption {
+    Value: RdlParameterValue;
+    Label: string;
+}
+/** Parameter name to its values as invariant text; null = NULL. Body of resolve and render. */
+type RdlParameterValues = Record<string, (string | null)[]>;
+/** Body of `parameters/resolve` (RdlParameterValuesRequest) and of `render` (RdlRenderRequest). */
+interface RdlParameterValuesRequest {
+    Values: RdlParameterValues;
+}
+interface RdlReportDefinition {
+    ReportId: string;
+    Name: string;
+    Description?: string | null;
+    /** "2008", "2010", "2016" or "unknown". */
+    SchemaVersion: string;
+    Language?: string | null;
+    Page: RdlPageSettings;
+    SectionCount: number;
+    ParameterCount: number;
+    VisibleParameterCount: number;
+    UnsupportedFeatures: RdlUnsupportedFeature[];
+}
+interface RdlPageSettings {
+    PageWidth?: number | null;
+    PageHeight?: number | null;
+    InteractiveWidth?: number | null;
+    InteractiveHeight?: number | null;
+    LeftMargin?: number | null;
+    RightMargin?: number | null;
+    TopMargin?: number | null;
+    BottomMargin?: number | null;
+}
+interface RdlUnsupportedFeature {
+    Element: string;
+    ItemName?: string | null;
+}
+/** Export formats of the viewer: PDF, Excel and Word. */
+type RdlExportFormat = "pdf" | "xlsx" | "docx";
+
+/** One editor value: text (TextBox, numbers as typed, dropdown option values), a boolean or a date-time. */
+type RdlEditorScalar = string | boolean | Temporal.PlainDateTime;
+/** The editor state of one parameter: its values, none (or only empty text) for an empty field. */
+interface RdlParameterEdit {
+    values: RdlEditorScalar[];
+}
+type RdlParameterEdits = Record<string, RdlParameterEdit>;
+/** The editor state of a whole form. */
+declare function initialParameterEdits(parameters: readonly RdlReportParameter[]): RdlParameterEdits;
+/**
+ * The values the API takes (RdlParameterValuesRequest.Values): every parameter, each as an array of
+ * invariant text. An empty field is [null] when the parameter is nullable, [""] for a single text,
+ * else []. A parameter without an edit sends the values the server gave it.
+ *
+ * A nullable boolean whose value is NULL shows neither True nor False and keeps sending NULL until
+ * the user picks one; from then on it sends "true" / "false" (a radio group cannot be emptied again).
+ */
+declare function toRdlParameterValues(parameters: readonly RdlReportParameter[], edits: RdlParameterEdits): RdlParameterValues;
+
+/** The host's requests the parameter form sends out. */
+interface ReportParameterFormOptions {
+    /** A parameter other parameters depend on changed: the host answers with a new `form`. */
+    onResolve: (values: RdlParameterValues) => void;
+    /** "View report" with valid values. */
+    onRender: (values: RdlParameterValues) => void;
+}
+/** What `useReportParameterForm` returns: `CwReportParameterForm` (and `CwReportViewer`) take it as a prop. */
+interface ReportParameterFormController {
+    /** The parameter form the editors belong to (the hook's `form` argument); null while it loads for the first time. */
+    form: RdlReportParameters | null;
+    edits: RdlParameterEdits;
+    /** Client-side errors, shown once the user tried to view the report. */
+    errors: Record<string, string>;
+    /** Sets a parameter's editor value; `commit` re-resolves the form at once when other parameters depend on it. */
+    setEdit: (name: string, edit: RdlParameterEdit, commit: boolean) => void;
+    /** Commits a typed value (on blur): re-resolves when it changed and other parameters depend on it. */
+    commit: (name: string) => void;
+    /** Validates and, when valid, hands the values to `onRender`. */
+    submit: () => void;
+}
+/**
+ * Editor state of the report parameter form, owned by the host and handed to `CwReportParameterForm`
+ * as `controller`. A new form object from the host (after a resolve) resets the editors to the values
+ * it carries; the server echoes the submitted values, so nothing is lost.
+ */
+declare function useReportParameterForm(form: RdlReportParameters | null, options: ReportParameterFormOptions): ReportParameterFormController;
+
+/** The ids of the drilldown toggles the user clicked an odd number of times, for one render. */
+type RdlFlippedToggles = ReadonlySet<string>;
+/** An item, row or cell is visible only when every toggle it depends on is in its visible state. */
+declare function isRdlVisible(toggles: readonly RdlToggleRef[] | null | undefined, flipped: RdlFlippedToggles): boolean;
+/** Returns a new set with `id` flipped (added when absent, removed when present). */
+declare function flipToggle(flipped: RdlFlippedToggles, id: string): Set<string>;
+
+interface RdlFindMatch {
+    /** Key of the run the match is in. */
+    key: string;
+    start: number;
+    length: number;
+}
+/** Find over the visible text of one page. */
+declare function findInPage(page: RdlRenderPage, query: string, flipped: RdlFlippedToggles): RdlFindMatch[];
+
+/** Zoom of the viewer: a factor (1 = 100%) or a fit mode measured against the visible area. */
+type CwReportZoom = number | "pageWidth" | "wholePage";
+/** The zoom steps of the toolbar, 50% to 200%. */
+declare const REPORT_ZOOM_STEPS: readonly number[];
+/** Margins around the body on the drawn sheet, in points. */
+interface RdlPageMargins {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+
+/** An export or a print the user asked for. */
+type ReportOutputAction = {
+    kind: "export";
+    format: RdlExportFormat;
+} | {
+    kind: "print";
+};
+
+/** The host's requests the viewer state sends out. */
+interface ReportViewerStateOptions {
+    /** Go to a page (1-based) of the current render. */
+    onPage: (pageNumber: number) => void;
+    /**
+     * Drilldown on the server, like the old ReportViewer: when given, a toggle click asks the host for
+     * page `pageNumber` of the current render drawn with `toggles` (the flipped toggle ids, see
+     * `flippedToggleIds`), and page changes go here too while any toggle is flipped. The host answers
+     * with a new `result` (same RenderId). Without it, toggles are flipped in the browser.
+     */
+    onView?: (toggles: readonly string[], pageNumber: number) => void;
+    /**
+     * Export of the current render. `toggles` are the drilldown toggle ids the user flipped relative to
+     * the initial state, so the file can show what the screen shows (`flippedToggleIds`).
+     */
+    onExport: (format: RdlExportFormat, toggles: readonly string[]) => void;
+    /** Print (a PDF export) of the current render with the flipped toggle ids, as for `onExport`. */
+    onPrint: (toggles: readonly string[]) => void;
+    /** Zoom the viewer opens with (default 100%). */
+    initialZoom?: CwReportZoom;
+}
+/** What `useReportViewerState` returns: `CwReportViewer` takes it as its `state` prop. */
+interface ReportViewerState {
+    /** The render result this state belongs to (the hook's `result` argument). */
+    result: RdlRenderResult | null;
+    /** Whether drilldown runs on the server (`onView` given). */
+    serverToggles: boolean;
+    zoom: CwReportZoom;
+    setZoom: (zoom: CwReportZoom) => void;
+    /** The toggles the user flipped in this render (sent with export, print and server views). */
+    flipped: RdlFlippedToggles;
+    /** The flips the page is drawn with: `flipped`, or none when the server already drew the page for them. */
+    drawnFlips: RdlFlippedToggles;
+    /** A toggle click: with `onView` flips it and asks the host for the page drawn that way, else flips it in the browser. */
+    toggle: (toggleId: string) => void;
+    /** Replaces the flipped toggles of the current render, e.g. to restore them after a failed `onView` (`[]` resets). */
+    setFlipped: (toggleIds: readonly string[]) => void;
+    /** A page change: through `onView` while toggles are flipped and `onView` is given, else `onPage`. */
+    goToPage: (pageNumber: number) => void;
+    findText: string;
+    setFindText: (text: string) => void;
+    findMatches: RdlFindMatch[];
+    findIndex: number;
+    findNext: () => void;
+    parametersVisible: boolean;
+    toggleParameters: () => void;
+    permissionDialogOpen: boolean;
+    closePermissionDialog: () => void;
+    /** An export or print waiting for the user to confirm it despite the render's warnings. */
+    pendingOutput: ReportOutputAction | null;
+    /** Export or print: a render with warnings asks first (`pendingOutput`), else it runs at once. */
+    requestOutput: (action: ReportOutputAction) => void;
+    /**
+     * Runs the pending export or print with the flipped toggle ids. Synchronous, so called inside a
+     * click it lets the host's print open its tab past the popup blocker.
+     */
+    confirmOutput: () => void;
+    cancelOutput: () => void;
+}
+/**
+ * Client-side state of the report viewer around one render result, owned by the host and handed to
+ * `CwReportViewer` as `state`. The drilldown toggles belong to a render: a new RenderId (new render,
+ * sort) starts with none flipped, paging and server views of the same render keep them. With
+ * `onView` the host re-renders the page for the flipped toggles, so the page and find use it as drawn
+ * (`drawnFlips` = none). The find position belongs to the query and the page shown. The permission
+ * dialog is dismissed per render, and a pending export / print question is dropped by a new render.
+ */
+declare function useReportViewerState(result: RdlRenderResult | null, options: ReportViewerStateOptions): ReportViewerState;
+
+interface CwReportViewerProps {
+    /** Report definition (name); optional. */
+    definition?: RdlReportDefinition | null;
+    /**
+     * The viewer state from `useReportViewerState(result, { onPage, onView, onExport, onPrint })`,
+     * called by the host: the current render (null before the first one), zoom, drilldown, find, the
+     * parameter panel and the export / print confirmation.
+     */
+    state: ReportViewerState;
+    /**
+     * The parameter form from `useReportParameterForm(parameters, { onResolve, onRender })`, called by
+     * the host. Drawn in the sidebar; without a sidebar its `submit` runs "View report" on the canvas.
+     */
+    parameterForm: ReportParameterFormController;
+    /** The parameter form is loading or being re-resolved. */
+    loadingParameters?: boolean;
+    /** A render, page or sort request is running. */
+    loadingRender?: boolean;
+    /** A failed request, shown in place of the page. */
+    error?: string | null;
+    /** An interactive sort was clicked. */
+    onSort: (sortId: string) => void;
+    onRefresh: () => void;
+    /** Shows a back button when given. */
+    onBack?: () => void;
+    /** URL of an embedded / database image of the current render. */
+    getImageUrl: (imageId: string) => string;
+    /** Initial width of the parameter sidebar in pixels. */
+    sidebarWidth?: number;
+    /** Minimum width of the parameter sidebar in pixels. */
+    minSidebarWidth?: number;
+    /** Maximum width of the parameter sidebar in pixels. */
+    maxSidebarWidth?: number;
+    /** Whether the parameter sidebar can be resized (drag or arrow keys on its edge). */
+    resizable?: boolean;
+    className?: string;
+}
+/**
+ * The RDL report viewer: a resizable, collapsible parameter sidebar on the left, the toolbar and
+ * the page on a neutral canvas on the right, like the old ReportViewer. The sidebar only exists
+ * when the user has a parameter to fill in. Presentational: it fetches nothing and owns no report
+ * state. The host calls `useReportViewerState` and `useReportParameterForm` and passes their results
+ * as `state` and `parameterForm`; every request goes out through the callbacks given to those hooks
+ * (or `onSort` / `onRefresh` / `onBack`) and comes back as their arguments.
+ */
+declare function CwReportViewer({ definition, state, parameterForm, loadingParameters, loadingRender, error, onSort, onRefresh, onBack, getImageUrl, sidebarWidth, minSidebarWidth, maxSidebarWidth, resizable, className }: CwReportViewerProps): React$1.JSX.Element;
+
+interface CwReportPageProps {
+    /** The page of the render result to draw. */
+    page: RdlRenderPage;
+    /** Width of the report body in points (`RdlRenderResult.BodyWidth`). */
+    bodyWidth: number;
+    /** Zoom factor, 1 = 100%. @default 1 */
+    zoom?: number;
+    /** Culture of the render (`RdlRenderResult.Culture`), used for chart value axis formats. */
+    culture?: string | null;
+    /** Margins around the body on the sheet, in points. @default 18pt on every side */
+    margins?: RdlPageMargins;
+    /** Drilldown toggles the user flipped in this render. @default none */
+    flippedToggles?: RdlFlippedToggles;
+    /** A drilldown +/- icon was clicked. */
+    onToggle?: (toggleId: string) => void;
+    /** An interactive sort indicator was clicked. */
+    onSort?: (sortId: string) => void;
+    /** URL of an embedded / database image (`RdlRenderImage.ImageId`). */
+    getImageUrl?: (imageId: string) => string;
+    /** Find matches on this page to highlight (from `findInPage`). */
+    findMatches?: readonly RdlFindMatch[];
+    /** Index of the current match in `findMatches`; it is highlighted strongly and scrolled into view. @default -1 */
+    activeMatchIndex?: number;
+    className?: string;
+}
+/**
+ * One page of a rendered RDL report drawn as a sheet of paper: page header, body and page footer,
+ * every item absolutely positioned in points scaled by the zoom. Presentational: toggle state,
+ * sorting, images and find matches come from the host.
+ */
+declare function CwReportPage({ page, bodyWidth, zoom, culture, margins, flippedToggles, onToggle, onSort, getImageUrl, findMatches, activeMatchIndex, className }: CwReportPageProps): React$1.JSX.Element;
+
+interface CwReportToolbarProps {
+    /** Current page, 1-based. */
+    pageNumber: number;
+    pageCount: number;
+    onPage: (pageNumber: number) => void;
+    /** Re-runs the report with the current parameters. Hidden when not given. */
+    onRefresh?: () => void;
+    /** Back to where the viewer was opened from. Hidden when not given. */
+    onBack?: () => void;
+    zoom: CwReportZoom;
+    onZoomChange: (zoom: CwReportZoom) => void;
+    /** Find text of the current page. */
+    findText: string;
+    onFindTextChange: (text: string) => void;
+    /** Goes to the next match (cycling). */
+    onFindNext: () => void;
+    findMatchCount: number;
+    /** Index of the current match, -1 for none. */
+    findMatchIndex: number;
+    onExport: (format: RdlExportFormat) => void;
+    onPrint: () => void;
+    /** Render warnings; nothing is shown while the list is empty. */
+    warnings?: readonly string[];
+    /** Shows the parameter panel toggle when given. */
+    onToggleParameters?: () => void;
+    parametersVisible?: boolean;
+    /** No report rendered yet: navigation, find, export and print are disabled. */
+    disabled?: boolean;
+    /** Name of the report, shown right after find (shortened with "...", full name as tooltip). */
+    reportName?: string | null;
+}
+/**
+ * The report viewer toolbar, like the old ReportViewer: page navigation, refresh, back, zoom,
+ * find on the current page, export (PDF / Excel / Word) and print. Warnings stay invisible until
+ * there are some (Dark Cockpit). Presentational: every action is a callback.
+ */
+declare function CwReportToolbar({ pageNumber, pageCount, onPage, onRefresh, onBack, zoom, onZoomChange, findText, onFindTextChange, onFindNext, findMatchCount, findMatchIndex, onExport, onPrint, warnings, onToggleParameters, parametersVisible, disabled, reportName }: CwReportToolbarProps): React$1.JSX.Element;
+
+interface CwReportParameterFormProps {
+    /**
+     * The editor state from `useReportParameterForm(form, { onResolve, onRender })`, called by the host:
+     * it carries the parameter form from the API (null while it loads for the first time).
+     */
+    controller: ReportParameterFormController;
+    /** The form is being loaded or re-resolved. */
+    loading?: boolean;
+    /** Disables "View report" (e.g. while a render runs). */
+    rendering?: boolean;
+}
+/**
+ * The report parameter form in the server's order: dropdowns (multi-value as tag selector with
+ * select-all), date-time pickers, True/False, numbers and text. There is no NULL control: an empty
+ * field of a nullable parameter is sent as NULL (see rdlParameterValues), as in the old WinOps
+ * report page. Hidden parameters are not drawn; server-filled ones are read-only. Presentational:
+ * the host owns the editor state (`useReportParameterForm`); a change to a parameter others depend
+ * on calls its `onResolve`, "View report" its `onRender` with the values as invariant text
+ * (`toRdlParameterValues`).
+ *
+ * The form fills its parent's height when the parent gives it one: the fields scroll and the
+ * "View report" footer stays pinned at the bottom. In an unbounded parent it simply grows.
+ */
+declare function CwReportParameterForm({ controller, loading, rendering }: CwReportParameterFormProps): React$1.JSX.Element;
+
+interface CwReportLineChartProps {
+    /** The chart as the render tree delivers it. */
+    chart: RdlRenderChart;
+    /** Drawing size in CSS pixels. */
+    width: number;
+    height: number;
+    /** Zoom factor of the page (scales the chart text). @default 1 */
+    zoom?: number;
+    /** Culture of the report (`RdlRenderResult.Culture`) for the value axis format. */
+    culture?: string | null;
+}
+/**
+ * A report chart over categories: Line (Smooth / Stepped), Area, Column and Scatter series share one
+ * value axis; a chart made only of Bar series is drawn horizontally. Scatter series draw only their
+ * markers, line series draw markers too when the report sets a marker type. Null values leave gaps.
+ * The legend sits where the RDL legend Position says. Own SVG, no chart library; hover shows
+ * category, series and value.
+ */
+declare function CwReportLineChart({ chart, width, height, zoom, culture }: CwReportLineChartProps): React$1.JSX.Element;
+
+interface CwReportPieChartProps {
+    /** The chart as the render tree delivers it; its first series is drawn over the categories. */
+    chart: RdlRenderChart;
+    /** Drawing size in CSS pixels. */
+    width: number;
+    height: number;
+    /** Zoom factor of the page (scales the chart text). @default 1 */
+    zoom?: number;
+}
+/** A pie of the chart's first series over its categories (RDL series Type "Shape"). Own SVG. */
+declare function CwReportPieChart({ chart, width, height, zoom }: CwReportPieChartProps): React$1.JSX.Element;
+
+interface CwReportGaugeProps {
+    /** The gauge panel as the render tree delivers it. */
+    panel: RdlRenderGaugePanel;
+    /** Drawing size in CSS pixels. */
+    width: number;
+    height: number;
+    /** Zoom factor of the page (scales the gauge text). @default 1 */
+    zoom?: number;
+}
+/**
+ * A gauge panel: its gauges side by side (RadialGauge = 270 degree dial with colored ranges and a
+ * needle or bar per pointer, LinearGauge = horizontal track with range bands, a bar or marker per
+ * pointer and the major ticks), the state indicators at their percent boxes and the panel labels
+ * below. The pointer value is not printed; only the report's own labels are. Only the first scale of
+ * a gauge is drawn.
+ */
+declare function CwReportGauge({ panel, width, height, zoom }: CwReportGaugeProps): React$1.JSX.Element;
+
 type DisplayMode = "default" | "icao-only" | "iata-only" | "full-text";
 /** Props for {@link CwFindAirport}. */
 interface CwFindAirportProps {
@@ -4061,5 +4753,5 @@ declare class OnClickContextMenu implements UiEvent {
     constructor(id: string, clickedMenu: string);
 }
 
-export { CwAccordionContainer, CwAlign, CwAnchoredMenu, CwBadge, CwBtnApprove, CwBtnCancel, CwBtnDelete, CwBtnEdit, CwBtnSave, CwButton, CwButtonSplit, CwButtonSwitch, CwCard, CwCardList, CwCheck, CwCheckbox, CwCheckboxGroup, CwChip, CwColorPicker, CwConfirmationPopup, CwContextMenu, CwDatePicker, CwDatePickerTemporal, CwDateRangePicker, CwDateRangePickerTemporal, CwDateTimePicker, CwDateTimePickerCompact, CwDateTimePickerTemporal, CwDialog, CwDigit, CwDisplayMessage, CwDropdown, CwDropdownFilter, CwExpandable, CwFileUploadMultiple, CwFindAirport, CwFindCrewmember, CwGenericTooltip, CwHeadingMain, CwHeadingSecond, CwIcon, CwImageArea, CwImageGallery, CwImageZoom, CwInput, CwInputColor, CwInputDateText, CwInputDatetime, CwInputImage, CwInputNumber, CwInputPhone, CwInputText, CwKeyValueList, CwLabel, CwLoading, CwMasterDetail, CwMessage, CwMessageManager, CwMessageType, CwModal, CwModalHover, CwModalReportFunctional, CwMultiFilter, CwMultiFilterTag, CwNavMenu, CwNote, CwOption, CwPopoverButton, CwProgress, CwRadioGroup, CwReportModal, CwSearchAsync, CwSearchInput, CwSelect, CwSelectList, CwSelectListItems, CwSkeleton, CwSortableList, CwSortableTable, CwTable, CwTableGrouped, CwTableServerSide, CwTabs, CwTagSelector, CwTextArea, CwTime, CwTimePicker, CwToggle, CwTooltipManager, CwTooltipNew, CwTreeView, CwWeekdaySelector, DefaultRowHeader, OnClearPinned, OnClickContextMenu, OnClickEvent, OnClickRowEvent, OnClickRowHeader, OnClickUtc, OnDoubleClickEvent, OnDoubleClickRowEvent, OnDragEvent, OnDropCtrlEvent, OnDropEvent, OnEndClickHeaderEvent, OnLeftDragStart, OnMultiClickEvent, OnPinRow, OnRangeClickEvent, OnRightClickEvent, OnRightClickRow, OnRightDragStart, OnStartClickHeaderEvent, OnUnpinRow, PRESET_LIBRARY_TEMPORAL, PinRowHeader, Scheduler, SchedulerEvent, SuperScheduler, TooltipConstraintContext, UiEvent, Weekdays, configureCwLoading, eventIsVisible, filterNavItems, filterVisibleEvents, getCwLoadingDefaults, getDefaultDivisions, getEventSizes, getPresetsByKeysTemporal, itemsToMultiFilterTags, sortNavItems, useCwMessage, useSortableList, useSortableTable, useTooltipConstraint };
-export type { BackgroundEventDm, BadgeColorScheme, BadgeSize, BadgeVariant, CardChip, ChipColorScheme, ChipVariant, Column$1 as Column, ConfirmationPopupProps, CwAlignProps, CwBadgeProps, CwButtonSplitAction, CwButtonSplitProps, CwButtonSwitchOption, CwButtonSwitchProps, CwCardListProps, CwCardProps, CwChipProps, CwDataAttributes, CwDialogProps, CwDropdownOption, CwDropdownProps, CwExpandableProps, CwGroupLayoutProps, CwImageAreaMethods, CwImageAreaProps, CwInputDateTextProps, CwInputDatetimeProps, CwInputImageProps, CwInputNumberProps, CwInputPhoneProps, CwInputTextProps, CwInputTimeProps, CwKeyValueListProps, CwLabelProps, CwLayoutProps, CwLoadingDefaults, CwMasterDetailItem, CwMasterDetailProps, CwMessageProps, CwModalHoverProps, CwMultiFilterProps, CwMultiFilterTagProps, CwNavItem, CwNavMenuProps, CwNoteProps, CwPopoverButtonProps, CwProgressColor, CwProgressProps, CwRadioGroupProps, CwReportModalFunctionalProps, CwSearchAsyncOption, CwSearchAsyncProps, CwSelectListProps, CwSkeletonProps, CwSortableListProps, CwSortableTableProps, CwTableGroupedData, CwTableGroupedData_Group, CwTableGroupedData_Row, CwTableGroupedProps, CwTagSelectorOption, CwTagSelectorProps, CwTextAreaProps, CwTreeNode, DataItem, DateRangePresetTemporal, DateRangeValue, DateRangeValueTemporal, ICwMultiFilterTag, ImageItem, IndicatorRowDm, MenuOption, OnEvent, PinRowHeaderProps, RowHeaderDm, RowHeaderProps, SchedulerEventDm, SchedulerEventState, SchedulerRowProps, SchedulerState, ServerSideTableState, SortableColumn, SortableTableDragState, SuperSchedulerProps, Tab, UseSortableTableReturn, Weekday, ZoomImageItem };
+export { CwAccordionContainer, CwAlign, CwAnchoredMenu, CwBadge, CwBtnApprove, CwBtnCancel, CwBtnDelete, CwBtnEdit, CwBtnSave, CwButton, CwButtonSplit, CwButtonSwitch, CwCard, CwCardList, CwCheck, CwCheckbox, CwCheckboxGroup, CwChip, CwColorPicker, CwConfirmationPopup, CwContextMenu, CwDatePicker, CwDatePickerTemporal, CwDateRangePicker, CwDateRangePickerTemporal, CwDateTimePicker, CwDateTimePickerCompact, CwDateTimePickerTemporal, CwDialog, CwDigit, CwDisplayMessage, CwDropdown, CwDropdownFilter, CwExpandable, CwFileUploadMultiple, CwFindAirport, CwFindCrewmember, CwGenericTooltip, CwHeadingMain, CwHeadingSecond, CwIcon, CwImageArea, CwImageGallery, CwImageZoom, CwInput, CwInputColor, CwInputDateText, CwInputDatetime, CwInputImage, CwInputNumber, CwInputPhone, CwInputText, CwKeyValueList, CwLabel, CwLoading, CwMasterDetail, CwMessage, CwMessageManager, CwMessageType, CwModal, CwModalHover, CwModalReportFunctional, CwMultiFilter, CwMultiFilterTag, CwNavMenu, CwNote, CwOption, CwPopoverButton, CwProgress, CwRadioGroup, CwReportGauge, CwReportLineChart, CwReportModal, CwReportPage, CwReportParameterForm, CwReportPieChart, CwReportToolbar, CwReportViewer, CwSearchAsync, CwSearchInput, CwSelect, CwSelectList, CwSelectListItems, CwSkeleton, CwSortableList, CwSortableTable, CwTable, CwTableGrouped, CwTableServerSide, CwTabs, CwTagSelector, CwTextArea, CwTime, CwTimePicker, CwToggle, CwTooltipManager, CwTooltipNew, CwTreeView, CwWeekdaySelector, DefaultRowHeader, OnClearPinned, OnClickContextMenu, OnClickEvent, OnClickRowEvent, OnClickRowHeader, OnClickUtc, OnDoubleClickEvent, OnDoubleClickRowEvent, OnDragEvent, OnDropCtrlEvent, OnDropEvent, OnEndClickHeaderEvent, OnLeftDragStart, OnMultiClickEvent, OnPinRow, OnRangeClickEvent, OnRightClickEvent, OnRightClickRow, OnRightDragStart, OnStartClickHeaderEvent, OnUnpinRow, PRESET_LIBRARY_TEMPORAL, PinRowHeader, REPORT_ZOOM_STEPS, Scheduler, SchedulerEvent, SuperScheduler, TooltipConstraintContext, UiEvent, Weekdays, configureCwLoading, eventIsVisible, filterNavItems, filterVisibleEvents, findInPage, flipToggle, getCwLoadingDefaults, getDefaultDivisions, getEventSizes, getPresetsByKeysTemporal, initialParameterEdits, isRdlVisible, itemsToMultiFilterTags, sortNavItems, toRdlParameterValues, useCwMessage, useReportParameterForm, useReportViewerState, useSortableList, useSortableTable, useTooltipConstraint };
+export type { BackgroundEventDm, BadgeColorScheme, BadgeSize, BadgeVariant, CardChip, ChipColorScheme, ChipVariant, Column$1 as Column, ConfirmationPopupProps, CwAlignProps, CwBadgeProps, CwButtonSplitAction, CwButtonSplitProps, CwButtonSwitchOption, CwButtonSwitchProps, CwCardListProps, CwCardProps, CwChipProps, CwDataAttributes, CwDialogProps, CwDropdownOption, CwDropdownProps, CwExpandableProps, CwGroupLayoutProps, CwImageAreaMethods, CwImageAreaProps, CwInputDateTextProps, CwInputDatetimeProps, CwInputImageProps, CwInputNumberProps, CwInputPhoneProps, CwInputTextProps, CwInputTimeProps, CwKeyValueListProps, CwLabelProps, CwLayoutProps, CwLoadingDefaults, CwMasterDetailItem, CwMasterDetailProps, CwMessageProps, CwModalHoverProps, CwMultiFilterProps, CwMultiFilterTagProps, CwNavItem, CwNavMenuProps, CwNoteProps, CwPopoverButtonProps, CwProgressColor, CwProgressProps, CwRadioGroupProps, CwReportGaugeProps, CwReportLineChartProps, CwReportModalFunctionalProps, CwReportPageProps, CwReportParameterFormProps, CwReportPieChartProps, CwReportToolbarProps, CwReportViewerProps, CwReportZoom, CwSearchAsyncOption, CwSearchAsyncProps, CwSelectListProps, CwSkeletonProps, CwSortableListProps, CwSortableTableProps, CwTableGroupedData, CwTableGroupedData_Group, CwTableGroupedData_Row, CwTableGroupedProps, CwTagSelectorOption, CwTagSelectorProps, CwTextAreaProps, CwTreeNode, DataItem, DateRangePresetTemporal, DateRangeValue, DateRangeValueTemporal, ICwMultiFilterTag, ImageItem, IndicatorRowDm, MenuOption, OnEvent, PinRowHeaderProps, RdlEditorScalar, RdlExportFormat, RdlFindMatch, RdlFlippedToggles, RdlPageMargins, RdlPageSettings, RdlParameterEdit, RdlParameterEdits, RdlParameterOption, RdlParameterValue, RdlParameterValues, RdlParameterValuesRequest, RdlRenderBorder, RdlRenderChart, RdlRenderChartSeries, RdlRenderGauge, RdlRenderGaugePanel, RdlRenderGaugePointer, RdlRenderGaugeRange, RdlRenderGaugeScale, RdlRenderImage, RdlRenderItem, RdlRenderItemBase, RdlRenderItemKind, RdlRenderLine, RdlRenderPage, RdlRenderPageSection, RdlRenderParagraph, RdlRenderPlaceholder, RdlRenderRectangle, RdlRenderResult, RdlRenderRun, RdlRenderStyle, RdlRenderTable, RdlRenderTableCell, RdlRenderTableRow, RdlRenderTextbox, RdlReportDefinition, RdlReportParameter, RdlReportParameters, RdlSortRequest, RdlToggleRef, RdlUnsupportedFeature, ReportOutputAction, ReportParameterFormController, ReportParameterFormOptions, ReportViewerState, ReportViewerStateOptions, RowHeaderDm, RowHeaderProps, SchedulerEventCornerMarker, SchedulerEventDm, SchedulerEventState, SchedulerRowProps, SchedulerState, ServerSideTableState, SortableColumn, SortableTableDragState, SuperSchedulerProps, Tab, UseSortableTableReturn, Weekday, ZoomImageItem };