import { type CSSResultGroup, LitElement, type PropertyValues } from 'lit';
/**
 * Shared base for every data-driven Roxy component. Consolidates the things every component used to repeat by hand and adds the self-contained, drop-in behavior: controlled-mode hydration, an opt-in self-fetch (form, request, loading, error, empty), the typed `data` slot, and the render switch. A subclass implements one method, {@link RoxyDataElement.renderData}.
 *
 * @remarks
 * Two render modes, one component, which is the whole drop-in contract:
 *
 * - Controlled: a server (WordPress, JSX SSR, static HTML) fetches the response and injects it as a direct-child `<script type="application/json" class="roxy-data">`. {@link MarkupDataController} hydrates `data` from it on connect. No key reaches the browser. This is the path the WordPress plugin drives, and it is unchanged by the base class.
 * - Uncontrolled: no data is injected, but a `data-endpoint` and a `pk_` `publishable-key` are set. The component renders its own `<roxy-endpoint-form>` (an internal detail, never placed by the consumer), and on submit fetches through {@link FetchController}, which refuses any non-publishable key. The result populates `data` and the component renders it.
 *
 * The JavaScript `data` property always wins over markup, so a host that assigns `el.data = …` after upgrade is authoritative.
 *
 * Self-fetch needs `<roxy-endpoint-form>` (and `<roxy-location-search>`) registered. The CDN bundle and the full `@roxyapi/ui` entry register everything; per-component ESM consumers that want self-fetch import the form component too.
 *
 * @example
 * ```ts
 * @customElement('roxy-dream-card')
 * export class RoxyDreamCard extends RoxyDataElement<GetDreamSymbolResponse> {
 *   static styles = [baseStyles, css`.card { … }`];
 *   protected renderData(d: GetDreamSymbolResponse) {
 *     return html`<article class="card">…</article>`;
 *   }
 *   protected renderEmpty() {
 *     return html`<div class="roxy-empty" role="status">No dream symbol</div>`;
 *   }
 * }
 * ```
 */
export declare abstract class RoxyDataElement<T = unknown> extends LitElement {
    static styles: CSSResultGroup;
    /** Typed RoxyAPI response. Assigned in JavaScript, hydrated from the roxy-data island, or set by a self-fetch. */
    data: T | null;
    /** Endpoint path for self-fetch, e.g. "astrology/natal-chart" or "dreams/symbols/{id}". Empty disables self-fetch (controlled mode only). */
    endpoint: string;
    /** HTTP method for self-fetch. */
    method: 'GET' | 'POST';
    /** Browser-safe publishable key (pk_) for self-fetch. A secret key is refused client-side. */
    publishableKey?: string;
    /** Override the API origin for self-hosted or proxied deployments. */
    baseUrl?: string;
    /** Override the OpenAPI spec URL the self-fetch form introspects. */
    specUrl?: string;
    /** Consumer backend route that proxies the request (holds the secret key). When set, self-fetch POSTs the request here instead of calling RoxyAPI directly, so no key reaches the browser. The server-rendered (WordPress) path. */
    submitUrl?: string;
    /** Persist the last self-fetch form values in sessionStorage (keyed by endpoint) and prefill the form on reload. */
    remember: boolean;
    /** True while an uncontrolled self-fetch is in flight. Public so {@link FetchController} can drive it. */
    loading: boolean;
    /** Message from a failed self-fetch, or null. Public so {@link FetchController} can drive it. */
    error: string | null;
    private fetcher;
    constructor();
    protected willUpdate(changed: PropertyValues): void;
    render(): unknown;
    /** Render the populated response. The single method every component implements. */
    protected abstract renderData(data: T): unknown;
    /** The data-absent branch: the self-fetch form when an endpoint is set, otherwise the empty state. */
    protected renderNoData(): unknown;
    /** Internal self-fetch form. Reuses the introspecting `<roxy-endpoint-form>`; the consumer never places it. */
    protected renderForm(): unknown;
    private onFormSubmit;
    /** sessionStorage key for this component's remembered form values, scoped by endpoint. */
    private rememberKey;
    private readRemembered;
    private writeRemembered;
    /** Terminal empty state. Subclasses override for a domain-specific message. */
    protected renderEmpty(): unknown;
    /** Loading placeholder shown during a self-fetch. */
    protected renderLoading(): unknown;
    /** Error state shown when a self-fetch fails. Keeps the form in view so the request can be retried. */
    protected renderError(message: string): unknown;
}
//# sourceMappingURL=base-element.d.ts.map