import { CSSResult } from 'lit';
import { EventName } from '@lit/react';
import { LitElement } from 'lit';
import { nothing } from 'lit';
import { ReactWebComponent } from '@lit/react';
import { TemplateResult } from 'lit-html';

/** Supported input field types for form widgets. */
declare type FieldType = 'text' | 'email' | 'password' | 'tel' | 'url' | 'textarea' | 'number' | 'select' | 'multiselect' | 'date' | 'datetime' | 'time' | 'toggle' | 'range' | 'radio' | 'checkbox';

export declare const UWidget: ReactWebComponent<UWidget_2, {
onWidgetEvent: EventName<CustomEvent>;
}>;

/**
 * <u-widget> — Entry point router element.
 * Reads spec.widget and delegates to the appropriate sub-component.
 *
 * Supports theme attribute: theme="dark" | theme="light" | (auto via color-scheme inheritance)
 */
declare class UWidget_2 extends LitElement {
    static styles: CSSResult[];
    spec: UWidgetSpec | null;
    /** Theme override: "dark" | "light" | null (auto via color-scheme inheritance). */
    theme: string | null;
    /** Locale tag (e.g. 'ko', 'en-US'). Propagated to sub-components via spec.options.locale. */
    locale: string | null;
    connectedCallback(): void;
    disconnectedCallback(): void;
    private _handleInternalEvent;
    render(): typeof nothing | TemplateResult<1>;
    private renderWidget;
    /** Render standalone "actions" widget — a group of action buttons. */
    private renderActionsWidget;
    /** Render inline divider widget. */
    private renderDivider;
    /** Render inline header widget. */
    private renderHeader;
    /** Dispatch an action event from the global action bar or actions widget. */
    private _dispatchAction;
    private renderFallback;
    private renderError;
}

/**
 * Action button definition.
 *
 * Reserved actions: `"submit"`, `"cancel"`, `"navigate"`.
 * Custom action strings are forwarded to the host via the `u-widget-event`.
 *
 * @example
 * ```json
 * { "label": "Submit", "action": "submit", "style": "primary" }
 * ```
 */
export declare interface UWidgetAction {
    /** Button display text. */
    label: string;
    /** Action identifier emitted in the widget event. */
    action: string;
    /** Visual style hint. */
    style?: 'primary' | 'danger' | 'default';
    /** Whether the button is disabled. */
    disabled?: boolean;
    /** URL for `"navigate"` actions. */
    url?: string;
}

/**
 * Child widget spec inside a compose widget.
 * Inherits `type` and `version` from the parent — no need to repeat them.
 */
declare interface UWidgetChildSpec extends Omit<UWidgetSpec, 'type' | 'version'> {
    /** Grid column span within the parent compose layout. */
    span?: number;
    /** When true, the child is initially collapsed (uses native `<details>`). */
    collapsed?: boolean;
}

/**
 * Column definition for table widgets.
 *
 * @example
 * ```json
 * { "field": "price", "label": "Price", "format": "currency", "align": "right" }
 * ```
 */
declare interface UWidgetColumnDefinition {
    /** Data field name to display in this column. */
    field: string;
    /** Display header label. Defaults to the field name. */
    label?: string;
    /** Value formatting hint (e.g., `"currency"`, `"currency:EUR"`, `"percent"`). */
    format?: 'number' | 'currency' | 'percent' | 'date' | 'datetime' | 'bytes';
    /** Text alignment within the column. */
    align?: 'left' | 'center' | 'right';
}

/**
 * Event payload emitted by `<u-widget>` via the `u-widget-event` custom event.
 *
 * | type | trigger | payload |
 * |---|---|---|
 * | `submit` | Form submit button | Form field values |
 * | `action` | Custom action button | Action data |
 * | `change` | Input value change | Changed field and value |
 * | `select` | Chart element click | Selected data point |
 */
export declare interface UWidgetEvent {
    /** Event category. */
    type: 'submit' | 'action' | 'change' | 'select';
    /** The widget type that emitted this event. */
    widget: string;
    /** Widget instance `id` (if set in the spec). */
    id?: string;
    /** Action identifier (for `"action"` type events). */
    action?: string;
    /** Event payload data. */
    data?: Record<string, unknown>;
}

/**
 * Field definition for form/confirm input widgets.
 *
 * @example
 * ```json
 * { "field": "email", "label": "Email", "type": "email", "required": true }
 * ```
 */
declare interface UWidgetFieldDefinition {
    /** Data field name (maps to `data[field]` for defaults and output). */
    field: string;
    /** Display label. Defaults to the field name. */
    label?: string;
    /** Input type. Defaults to `"text"`. */
    type?: FieldType;
    /** Whether the field must be filled before submit. */
    required?: boolean;
    /** Placeholder text shown when the field is empty. */
    placeholder?: string;
    /** Options for select, multiselect, radio, and checkbox types. */
    options?: string[];
    /** Minimum character length for text inputs. */
    minLength?: number;
    /** Maximum character length for text inputs. */
    maxLength?: number;
    /** Custom regex pattern for validation (e.g. `"^[A-Z]{3}$"`). */
    pattern?: string;
    /** Number of visible rows for textarea type. */
    rows?: number;
    /** Minimum value (number) or date string. */
    min?: number | string;
    /** Maximum value (number) or date string. */
    max?: number | string;
    /** Step increment for number and range inputs. */
    step?: number;
    /** Custom validation error message (overrides locale default). */
    message?: string;
}

/**
 * Mapping connects data fields to visual channels.
 *
 * Which keys are relevant depends on the widget type:
 * - **chart.bar/line/area:** `x`, `y`
 * - **chart.pie/funnel:** `label`, `value`
 * - **chart.scatter:** `x`, `y`, `color`, `size`
 * - **chart.radar:** `axis`, `value`
 * - **table:** `columns`
 * - **list:** `primary`, `secondary`, `avatar`, `icon`, `trailing`
 *
 * When omitted, mapping is auto-inferred from the data shape.
 */
declare interface UWidgetMapping {
    /** Category axis field (chart x-axis). */
    x?: string;
    /** Value axis field(s). A string for single series, string[] for multi-series. */
    y?: string | string[];
    /** Label field (pie/funnel charts). */
    label?: string;
    /** Value field (pie/funnel/heatmap). */
    value?: string;
    /** Color grouping field (scatter). */
    color?: string;
    /** Size encoding field (scatter bubble). */
    size?: string;
    /** Opacity encoding field (scatter). Maps data values to point opacity (0.1–1.0). */
    opacity?: string;
    /** Axis field (radar chart indicators). */
    axis?: string;
    /** Explicit column definitions for table widgets. */
    columns?: UWidgetColumnDefinition[];
    /** Primary text field (list widget). */
    primary?: string;
    /** Secondary/subtitle text field (list widget). */
    secondary?: string;
    /** Icon letter field (list widget fallback when no avatar). */
    icon?: string;
    /** Avatar image URL field (list widget). */
    avatar?: string;
    /** Trailing value field displayed on the right (list widget). */
    trailing?: string;
    /** Badge/tag field (list widget). */
    badge?: string;
}

/**
 * The u-widget spec envelope — a single, consistent structure for all widgets.
 *
 * Only `widget` is required. All other fields are optional or auto-inferred.
 *
 * @example
 * ```ts
 * const spec: UWidgetSpec = {
 *   widget: 'chart.bar',
 *   data: [{ name: 'A', value: 30 }, { name: 'B', value: 70 }],
 *   mapping: { x: 'name', y: 'value' },
 * };
 * ```
 */
export declare interface UWidgetSpec {
    /** Widget type identifier (e.g., `"chart.bar"`, `"metric"`, `"form"`). */
    widget: string;
    /** Unique identifier for event correlation and compose children. */
    id?: string;
    /** Optional display title rendered above the widget. */
    title?: string;
    /** Optional description text rendered below the title. */
    description?: string;
    /** Inline data — an object (metric/gauge) or array of records (chart/table). */
    data?: Record<string, unknown> | Record<string, unknown>[];
    /** Maps data fields to visual channels. Auto-inferred when omitted. */
    mapping?: UWidgetMapping;
    /** Field definitions for form/confirm widgets. */
    fields?: UWidgetFieldDefinition[];
    /** Formdown shorthand syntax for form fields (mutually exclusive with `fields`). */
    formdown?: string;
    /**
     * Widget-specific rendering options.
     *
     * Chart widgets support an `echarts` sub-key for native ECharts option passthrough:
     * ```json
     * { "options": { "echarts": { "tooltip": { "trigger": "axis" } } } }
     * ```
     * All keys in `options.echarts` are deep-merged into the generated ECharts option.
     * @see https://echarts.apache.org/en/option.html
     */
    options?: Record<string, unknown>;
    /** Action buttons displayed below the widget. */
    actions?: UWidgetAction[];
    /** Interchange format type marker. Always `"u-widget"` if present. */
    type?: 'u-widget';
    /** Interchange format version string. */
    version?: string;
    /** Layout mode for compose widget: `"stack"` (default), `"row"`, or `"grid"`. */
    layout?: 'stack' | 'row' | 'grid';
    /** Number of grid columns for compose `"grid"` layout. Default: 2. */
    columns?: number;
    /** Child widget specs for compose widget. */
    children?: UWidgetChildSpec[];
    /** Grid column span for children inside a compose `"grid"` layout. */
    span?: number;
}

export { }