import { UElement } from '@iyulab/components/dist/components/UElement.js';
/**
 * `UDataElement`는 light DOM 내 `<script type="application/json">` 태그에서
 * JSON 데이터를 읽어 컴포넌트 프로퍼티에 자동으로 매핑하는 기반 클래스입니다.
 *
 * 사용 예시:
 * ```html
 * <my-component>
 *   <script type="application/json">{ "items": [1, 2, 3] }</script>
 * </my-component>
 * ```
 *
 * JSON 최상위 키가 컴포넌트의 프로퍼티 이름과 일치하면 자동으로 할당됩니다.
 *
 * script 페이로드 없이 property 바인딩만으로도 사용되는 서브클래스는
 * `load()`를 오버라이드해 script 부재 시 조용히 건너뛰어야 합니다.
 * (예: `URefCard` — URefBlock의 property 구동과 UMarkedBlock의 script 주입을 모두 지원)
 */
export declare class UDataElement extends UElement {
    static styles: import('lit').CSSResultGroup;
    connectedCallback(): void;
    /**
     * 지정한 태그와 데이터로 커스텀 엘리먼트 HTML 문자열을 생성합니다.
     * 데이터는 `<script type="application/json">` 태그로 주입됩니다.
     * 태그이름이 등록되지 않은 경우 빈 문자열을 반환합니다.
     *
     * @param json  - JSON 데이터 객체 또는 문자열
     * @param attrs - 추가 속성 객체 (선택적, `HtmlBuilder.build` 규칙 적용)
     * @returns 생성된 HTML 문자열
     */
    static buildHTML(json: object | string, attrs?: Record<string, string | boolean | object | null | undefined>): string;
    /**
     * `data` 객체를 컴포넌트 프로퍼티에 할당합니다.
     * `data`가 제공되지 않은 경우 light DOM 내 `<script type="application/json">` 태그에서 JSON 데이터를 읽어 프로퍼티에 자동으로 할당합니다.
     * 오류가 발생할 경우 `error()`를 호출하여 콘솔에 조용히 기록합니다.
     *
     * @param data - JSON 데이터 객체 (선택적)
     */
    protected load(data?: object): Promise<void>;
    /**
     * 오류 발생 시 콘솔에만 조용히 기록합니다. 에러 UI를 띄우지 않으므로 채팅 화면이
     * 갑작스러운 에러 카드로 어수선해지지 않습니다.
     * 일반적으로 JSON 파싱 오류의 경우 `data`가 객체가 아닌 문자열이거나 JSON 형식이 잘못된 경우입니다.
     *
     * @param error - 발생한 오류 객체
     */
    protected error(error: unknown): Promise<void>;
}