@wipco/sdui 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1012 @@
+import * as React from 'react';
+import React__default, { ComponentType } from 'react';
+import { D as DatePicker, a as DateRangePicker } from './DatePicker-CTDcFR7V.js';
+export { b as DatePickerProps, c as DateRangePickerProps, d as DateRangeValue } from './DatePicker-CTDcFR7V.js';
+import { S as SduiAction, a as SduiPropValue, b as SduiRule, c as SduiPage } from './types-D5Tkrynd.js';
+export { d as SduiCalcRef, e as SduiChild, f as SduiIndexRef, g as SduiItemRef, h as SduiNode, i as SduiScalar, j as SduiStateRef } from './types-D5Tkrynd.js';
+
+/**
+ * 호스트 앱 연결점 — ERP에서는 라우터·erpFetch·SSE가 하던 일을
+ * 어댑터로 주입받는다. 전부 선택 사항이며, 기본 구현은 브라우저
+ * 표준 API(fetch, location)로 동작한다.
+ */
+interface SduiAdapter {
+    /** navigate 액션 처리. 기본: window.location.assign */
+    navigate?: (to: string) => void;
+    /**
+     * submitForm 등 JSON API 호출. 성공 시 응답 JSON을, 실패 시
+     * Error(사용자에게 보여줄 메시지)를 던진다.
+     */
+    fetch?: (path: string, init: {
+        method: string;
+        body?: unknown;
+    }) => Promise<unknown>;
+    /** download 액션용 원시 fetch. 기본: fetch(path, { credentials: 'include' }) */
+    rawFetch?: (path: string) => Promise<Response>;
+    /** invalidate 액션 — 클라이언트 조회 캐시 무효화 (TanStack Query 등) */
+    invalidate?: (prefix: string, exact: boolean) => void;
+    /** refresh 액션 — 페이지 스펙 재조회 */
+    refresh?: () => void;
+    /**
+     * 페이지 스펙의 subscribe 채널 구독(SSE 등).
+     * onEvent 호출 시 렌더러가 조용한 재조회(invalidate+refresh)를 수행한다.
+     * 반환값은 구독 해제 함수.
+     */
+    subscribe?: (channels: string[], onEvent: () => void) => () => void;
+    /**
+     * urlState 반영 시 URL 쿼리 교체를 위임한다 — react-router 호스트라면
+     * setSearchParams(params, { replace: true })를 연결해 라우터 구독자와
+     * 어긋나지 않게 한다. 기본: window.history.replaceState.
+     */
+    replaceQuery?: (params: URLSearchParams) => void;
+}
+declare const defaultAdapter: Required<Pick<SduiAdapter, 'navigate' | 'fetch' | 'rawFetch'>> & SduiAdapter;
+
+/**
+ * 권한 게이트 — 통과하면 children, 실패하면 fallback 슬롯(없으면 아무 것도)을 렌더한다.
+ * 판정 자체는 하지 않는다. 호스트가 주입한 콜백(permission.tsx)에 질의만 위임한다.
+ *
+ * 스펙 예 (ERP 85개 페이지 중 56개가 쓰는 형태 그대로):
+ *   { "component": "Can",
+ *     "props": { "entity": "asset", "action": "create" },
+ *     "children": [ { "component": "Button", ... } ] }
+ */
+
+interface CanProps {
+    /** 대상 엔티티 식별자 */
+    entity: string;
+    /** 수행 동작 — 생략 시 'read'(ERP Can과 같은 기본값) */
+    action?: string;
+    /** 최소 적용 범위 — 생략 시 호스트 판정기의 기본값을 따른다 */
+    scope?: string;
+    /** 차단 시 대신 보여줄 내용 (JSON에서는 slots.fallback) */
+    fallback?: React__default.ReactNode;
+    children?: React__default.ReactNode;
+}
+declare function Can({ entity, action, scope, fallback, children }: CanProps): React__default.JSX.Element;
+
+/**
+ * 내장 기본 컴포넌트 세트 — WIPCO 디자인 시스템(wp-* 토큰)을 따르는
+ * 독립 구현. ERP 디자인 시스템과 같은 프롭 규약을 쓰므로 스펙이 호환된다.
+ * 스타일은 styles.css 한 파일이 담당한다.
+ */
+
+interface IconProps extends React__default.SVGAttributes<SVGSVGElement> {
+    name: string;
+    size?: number;
+    strokeWidth?: number;
+}
+/** 스트로크 아이콘. 등록되지 않은 이름은 점으로 대체된다. */
+declare function Icon({ name, size, strokeWidth, ...rest }: IconProps): React__default.JSX.Element;
+interface ButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** primary = WIPCO Blue, secondary = 외곽선(기본), ghost = 투명, danger = WIPCO Red, link = 인라인 */
+    variant?: 'primary' | 'secondary' | 'ghost' | 'danger' | 'link';
+    /** xs 24 · sm 28 · md 32(기본) · lg 40 · xl 48 px */
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /** 선행 아이콘 이름 */
+    icon?: string;
+    /** 후행 아이콘 이름 */
+    iconEnd?: string;
+    /** 라벨을 스피너로 바꾸고 입력을 막는다 */
+    loading?: boolean;
+    block?: boolean;
+    disabled?: boolean;
+    children?: React__default.ReactNode;
+}
+declare function Button({ variant, size, icon, iconEnd, loading, block, disabled, children, className, type, ...rest }: ButtonProps): React__default.JSX.Element;
+interface IconButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
+    icon: string;
+    /** 접근성 라벨(필수 권장) */
+    label?: string;
+    size?: 'xs' | 'sm' | 'md';
+    /**
+     * 예전 이름. `variant`를 주지 않았을 때만 쓰인다 — `variant` 주석 참고.
+     * @deprecated `variant`로 옮겨라. `tone="danger"`는 `variant="danger"`와 같다.
+     */
+    tone?: 'default' | 'danger';
+    /**
+     * 디자인 시스템 어휘. ghost = 투명(기본) · outlined = 하드라인 테두리 · danger = 빨강.
+     *
+     * 같은 자리를 가리키는 프롭이 `tone`과 둘로 갈라져 있는데 **variant가 이긴다** —
+     * 스펙과 디자인 시스템 문서가 쓰는 이름이 이쪽이고, 값 어휘도 넓다(outlined는 tone에 없다).
+     * variant를 주지 않으면 tone이 그대로 먹으므로 tone만 쓰던 코드는 그대로 돈다.
+     */
+    variant?: 'ghost' | 'outlined' | 'danger';
+}
+declare function IconButton({ icon, label, size, tone, variant, className, type, ...rest }: IconButtonProps): React__default.JSX.Element;
+interface InputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'size'> {
+    /** sm 28 · md 32(기본) · lg 40 px */
+    size?: 'sm' | 'md' | 'lg';
+    /** 선행 아이콘 이름 (예: "search") */
+    icon?: string;
+    /** 빨간 테두리 — Field error와 함께 사용 */
+    invalid?: boolean;
+    /** 고정폭 글꼴 — ID, 좌표, 해시 */
+    mono?: boolean;
+    /**
+     * 입력 오른쪽 끝에 겹쳐 그리는 후행 표시 — "원", "위", "mm" 같은 단위가 대부분이다.
+     *
+     * 단위를 값 안에 섞어 넣지 않는다는 규칙을 지키려면 값이 아니라 입력 위에 얹어야 해서,
+     * 선행 `icon`과 같은 래퍼를 쓴다.
+     *
+     * 문자열은 **ICON_PATHS에 있는 이름이면 아이콘, 아니면 그대로 단위 글자**로 그린다.
+     * 디자인 시스템 쪽 용례는 `trailing="eye"`(비밀번호 보기)처럼 아이콘 이름인데
+     * 실제 스펙 9곳은 전부 "원"·"위" 같은 단위 글자라, 둘 중 하나만 고르면 나머지가 깨진다.
+     * 단위가 아이콘 이름과 겹치는 일은 없으므로 이름으로 갈라도 안전하다.
+     */
+    trailing?: React__default.ReactNode;
+}
+declare function Input({ size, icon, invalid, mono, trailing, className, style, ...rest }: InputProps): React__default.JSX.Element;
+interface TextareaProps extends React__default.TextareaHTMLAttributes<HTMLTextAreaElement> {
+    invalid?: boolean;
+    rows?: number;
+}
+declare function Textarea({ invalid, rows, className, ...rest }: TextareaProps): React__default.JSX.Element;
+interface SelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+interface SelectProps extends Omit<React__default.SelectHTMLAttributes<HTMLSelectElement>, 'size'> {
+    options: SelectOption[];
+    size?: 'sm' | 'md' | 'lg';
+    invalid?: boolean;
+    /** 비어 있는 첫 옵션 */
+    placeholder?: string;
+}
+declare function Select({ options, size, invalid, placeholder, className, ...rest }: SelectProps): React__default.JSX.Element;
+interface CheckboxProps extends React__default.InputHTMLAttributes<HTMLInputElement> {
+    label?: React__default.ReactNode;
+    description?: React__default.ReactNode;
+    disabled?: boolean;
+}
+declare function Checkbox({ label, description, disabled, className, ...rest }: CheckboxProps): React__default.JSX.Element;
+interface SwitchProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'size'> {
+    label?: React__default.ReactNode;
+    size?: 'sm' | 'md';
+    disabled?: boolean;
+}
+declare function Switch({ label, size, disabled, className, ...rest }: SwitchProps): React__default.JSX.Element;
+interface FieldProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    label?: React__default.ReactNode;
+    /** 에러가 없을 때 보여줄 안내 한 줄 */
+    hint?: React__default.ReactNode;
+    /** hint를 대체하고 빨간색으로 표시 */
+    error?: React__default.ReactNode;
+    required?: boolean;
+    htmlFor?: string;
+    /** stacked(기본) 또는 horizontal(132px 라벨 컬럼) */
+    layout?: 'stacked' | 'horizontal';
+    children?: React__default.ReactNode;
+}
+declare function Field({ label, hint, error, required, htmlFor, layout, children, className, ...rest }: FieldProps): React__default.JSX.Element;
+interface CardProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'title'> {
+    title?: React__default.ReactNode;
+    subtitle?: React__default.ReactNode;
+    /** 헤더 우측 — 버튼, Select 등 */
+    actions?: React__default.ReactNode;
+    /** 우측 정렬 푸터 행 */
+    footer?: React__default.ReactNode;
+    variant?: 'default' | 'raised' | 'flat' | 'sunken';
+    selected?: boolean;
+    interactive?: boolean;
+    /** default 20px · tight 14px · none(테이블, 리스트) */
+    padding?: 'default' | 'tight' | 'none';
+    children?: React__default.ReactNode;
+}
+declare function Card({ title, subtitle, actions, footer, variant, selected, interactive, padding, children, className, ...rest }: CardProps): React__default.JSX.Element;
+interface BadgeProps extends React__default.HTMLAttributes<HTMLSpanElement> {
+    tone?: 'neutral' | 'info' | 'success' | 'warning' | 'danger' | 'brand';
+    /** 선행 5px 점 — 라이브/진행 상태 */
+    dot?: boolean;
+    size?: 'md' | 'lg';
+    children?: React__default.ReactNode;
+}
+declare function Badge({ tone, dot, size, children, className, ...rest }: BadgeProps): React__default.JSX.Element;
+interface TagProps extends React__default.HTMLAttributes<HTMLSpanElement> {
+    /** 선행 점의 CSS 색상 */
+    color?: string;
+    filled?: boolean;
+    onRemove?: (e: React__default.MouseEvent) => void;
+    children?: React__default.ReactNode;
+}
+declare function Tag({ color, filled, onRemove, children, className, ...rest }: TagProps): React__default.JSX.Element;
+interface AlertProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'title'> {
+    tone?: 'info' | 'success' | 'warning' | 'danger' | 'neutral';
+    title?: React__default.ReactNode;
+    children?: React__default.ReactNode;
+    actions?: React__default.ReactNode;
+    onClose?: () => void;
+    /**
+     * 테두리를 왼쪽 색 막대 하나로 바꾼다(모서리도 각지게 편다).
+     *
+     * 화면 맨 위에 놓여 먼저 읽혀야 하는 공지 — 개인정보 보호 안내, 업로드 절차 안내처럼
+     * 카드 안의 알림이 아니라 화면 폭을 가르는 배너로 보여야 하는 자리에 쓴다.
+     */
+    bar?: boolean;
+}
+declare function Alert({ tone, title, children, actions, onClose, bar, className, ...rest }: AlertProps): React__default.JSX.Element;
+interface ToastProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'title'> {
+    tone?: 'info' | 'success' | 'warning' | 'danger';
+    title?: React__default.ReactNode;
+    children?: React__default.ReactNode;
+    onClose?: () => void;
+}
+/** 우하단 일시 알림. .wp-toast-region 안에 렌더링된다. */
+declare function Toast({ tone, title, children, onClose, className, ...rest }: ToastProps): React__default.JSX.Element;
+interface TabItem {
+    value: string;
+    label: React__default.ReactNode;
+    icon?: string;
+    count?: number;
+}
+interface TabsProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    items: TabItem[];
+    value: string;
+    onChange?: (value: string) => void;
+    size?: 'md' | 'lg';
+}
+declare function Tabs({ items, value, onChange, size, className, ...rest }: TabsProps): React__default.JSX.Element;
+interface TableColumn {
+    key: string;
+    header: React__default.ReactNode;
+    /** CSS 폭 — "180px", "22%" */
+    width?: string;
+    align?: 'left' | 'right';
+    mono?: boolean;
+    strong?: boolean;
+    /**
+     * 셀 값을 Badge로 렌더링 — JSON 스펙에서 쓸 수 있는 선언적 지정.
+     * toneMap: 값 → tone, labelMap: 값 → 표시 텍스트(생략 시 값 그대로)
+     */
+    badge?: {
+        toneMap?: Record<string, string>;
+        labelMap?: Record<string, string>;
+    };
+    /** 프로그래매틱 사용 전용 — JSON 스펙에서는 쓸 수 없다 */
+    render?: (row: any, index: number) => React__default.ReactNode;
+}
+interface TableProps extends React__default.TableHTMLAttributes<HTMLTableElement> {
+    columns: TableColumn[];
+    rows: any[];
+    /** 40px 대신 32px 행 */
+    dense?: boolean;
+    hover?: boolean;
+    /** 행 key와 선택에 쓸 필드. 기본 "id" */
+    rowKey?: string;
+    onRowClick?: (row: any) => void;
+    /** rows가 비었을 때 대신 렌더링 — EmptyState 권장 */
+    empty?: React__default.ReactNode;
+}
+declare function Table({ columns, rows, dense, hover, rowKey, onRowClick, empty, className, ...rest }: TableProps): React__default.JSX.Element;
+interface StatCardProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    label: React__default.ReactNode;
+    value: React__default.ReactNode;
+    /** 단위 접미사 — "GB", "건", "%" */
+    unit?: string;
+    /** 비교 텍스트 — "+12.4%" */
+    delta?: React__default.ReactNode;
+    trend?: 'up' | 'down' | 'flat';
+    icon?: string;
+    footer?: React__default.ReactNode;
+    size?: 'md' | 'sm';
+}
+declare function StatCard({ label, value, unit, delta, trend, icon, footer, size, className, ...rest }: StatCardProps): React__default.JSX.Element;
+interface EmptyStateProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'title'> {
+    icon?: string;
+    title?: React__default.ReactNode;
+    children?: React__default.ReactNode;
+    actions?: React__default.ReactNode;
+    tight?: boolean;
+}
+declare function EmptyState({ icon, title, children, actions, tight, className, ...rest }: EmptyStateProps): React__default.JSX.Element;
+interface SpinnerProps extends React__default.HTMLAttributes<HTMLSpanElement> {
+    size?: 'sm' | 'md' | 'lg';
+    label?: string;
+}
+declare function Spinner({ size, label, className, ...rest }: SpinnerProps): React__default.JSX.Element;
+interface ProgressBarProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** 0~100 */
+    value: number;
+    /** danger 임계 강조 등 */
+    tone?: 'brand' | 'success' | 'warning' | 'danger' | 'info';
+    label?: React__default.ReactNode;
+    /**
+     * 라벨 줄 오른쪽 끝에 현재 값을 퍼센트로 적는다.
+     *
+     * 막대만으로는 82%와 91%를 구분할 수 없어서, 여러 개를 세로로 쌓아 비교하는
+     * 자리(공정별 진척 목록 등)에서 필요하다. 라벨 없이 켜도 값은 오른쪽에 붙는다.
+     */
+    showValue?: boolean;
+}
+declare function ProgressBar({ value, tone, label, showValue, className, ...rest }: ProgressBarProps): React__default.JSX.Element;
+interface PaginationProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    page: number;
+    pageCount: number;
+    total?: number;
+    pageSize?: number;
+    onChange?: (page: number) => void;
+}
+declare function Pagination({ page, pageCount, total, pageSize, onChange, className, ...rest }: PaginationProps): React__default.JSX.Element;
+interface DialogProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'title'> {
+    title?: React__default.ReactNode;
+    subtitle?: React__default.ReactNode;
+    /** 타이틀 좌측 마크 안의 아이콘 이름 */
+    icon?: string;
+    tone?: 'brand' | 'danger';
+    /** sm 380 · md 480(기본) · lg 680 · xl 880 px */
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    /** 우측 정렬 액션 행 — 보조 버튼 다음 주 버튼 */
+    footer?: React__default.ReactNode;
+    onClose?: () => void;
+    children?: React__default.ReactNode;
+}
+/** 모달 본체. 오버레이가 가장 가까운 포지셔닝 조상을 채운다 — SDUI에서는 SduiDialog 래퍼가 뷰포트에 고정한다. */
+declare function Dialog({ title, subtitle, icon, tone, size, footer, onClose, children, className, ...rest }: DialogProps): React__default.JSX.Element;
+
+interface GridProps {
+    /** wp-grid--N 프리셋 */
+    columns?: 2 | 3 | 4;
+    /** 커스텀 트랙 — grid-template-columns 값. columns보다 우선 */
+    template?: string;
+    className?: string;
+    style?: React__default.CSSProperties;
+    children?: React__default.ReactNode;
+}
+declare function Grid({ columns, template, className, style, children }: GridProps): React__default.JSX.Element;
+type Justify = 'start' | 'center' | 'end' | 'between';
+interface RowProps {
+    /** 가로 정렬 (기본 start) */
+    justify?: Justify;
+    className?: string;
+    style?: React__default.CSSProperties;
+    children?: React__default.ReactNode;
+}
+declare function Row({ justify, className, style, children }: RowProps): React__default.JSX.Element;
+interface ActionsProps {
+    /** 가로 정렬 — 기본 end(우측) */
+    justify?: Justify;
+    className?: string;
+    style?: React__default.CSSProperties;
+    children?: React__default.ReactNode;
+}
+/** 액션 버튼 묶음 — 슬롯 안에서 정렬을 제어한다(flex:1로 슬롯 폭 차지). */
+declare function Actions({ justify, className, style, children }: ActionsProps): React__default.JSX.Element;
+declare function Col({ className, style, children }: {
+    className?: string;
+    style?: React__default.CSSProperties;
+    children?: React__default.ReactNode;
+}): React__default.JSX.Element;
+interface SpacerProps {
+    /**
+     * 간격 토큰 단계(`--wp-space-N`). 주면 "남는 공간 밀어내기"가 아니라
+     * 그만큼의 **고정 간격**이 된다 — Card 본문처럼 gap이 이미 걸린 세로 묶음 안에서
+     * 한 덩어리를 다음 덩어리와 더 떼어 놓을 때 쓴다.
+     * 토큰에 없는 단계를 주면 무시하고 기존 flex 채움으로 돌아간다.
+     */
+    size?: 1 | 2 | 3 | 4 | 5 | 6 | 8;
+}
+declare function Spacer({ size }: SpacerProps): React__default.JSX.Element;
+interface SectionProps {
+    title?: React__default.ReactNode;
+    className?: string;
+    style?: React__default.CSSProperties;
+    children?: React__default.ReactNode;
+}
+declare function Section({ title, className, style, children }: SectionProps): React__default.JSX.Element;
+type TextPreset = 'display-1' | 'display-2' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'body-lg' | 'body' | 'body-sm' | 'caption' | 'label' | 'overline' | 'micro' | 'metric' | 'metric-sm' | 'mono' | 'mono-xs';
+interface TextProps {
+    /** styles.css의 .wp-* 타입 프리셋 이름 */
+    preset?: TextPreset;
+    as?: 'p' | 'span' | 'div' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+    className?: string;
+    style?: React__default.CSSProperties;
+    /** children 대신 쓸 수 있는 내용 — 상태 바인딩({ "$state": ... })에 유용 */
+    value?: React__default.ReactNode;
+    children?: React__default.ReactNode;
+}
+declare function Text({ preset, as: Tag, className, style, value, children }: TextProps): React__default.JSX.Element;
+interface KeyValueItem {
+    label: React__default.ReactNode;
+    /** source에서 꺼낼 필드 키. 생략하면 value를 그대로 출력 */
+    key?: string;
+    value?: React__default.ReactNode;
+    mono?: boolean;
+}
+interface KeyValueListProps {
+    /** 값의 원천 객체 — 보통 상태 바인딩({ "$state": "selectedOrder" })을 넣는다 */
+    source?: Record<string, unknown> | null;
+    items: KeyValueItem[];
+    className?: string;
+    style?: React__default.CSSProperties;
+}
+/** 키-값 요약 목록 (.wp-kv) — 상세 다이얼로그·패널의 표준 표현. */
+declare function KeyValueList({ source, items, className, style }: KeyValueListProps): React__default.JSX.Element;
+interface PageHeadProps {
+    title?: React__default.ReactNode;
+    subtitle?: React__default.ReactNode;
+    /** 우측 액션 영역 (JSON에서는 slots.actions로 전달) */
+    actions?: React__default.ReactNode;
+}
+declare function PageHead({ title, subtitle, actions }: PageHeadProps): React__default.JSX.Element;
+interface ShowProps {
+    /** 보통 상태 참조({ "$state": ... })를 바인딩한다. truthy면 children을 렌더링. */
+    when?: unknown;
+    children?: React__default.ReactNode;
+}
+/** 조건부 렌더링 — Dialog 등을 상태로 열고 닫을 때 사용. */
+declare function Show({ when, children }: ShowProps): React__default.JSX.Element | null;
+/** 가로 구분선 */
+declare function Divider({ style }: {
+    style?: React__default.CSSProperties;
+}): React__default.JSX.Element;
+
+/**
+ * 목록 원격 조회 어댑터.
+ *
+ * core는 특정 HTTP 클라이언트에 묶이지 않는다 — ERP는 SWR(useErpQuery)로 조회했지만
+ * 라이브러리는 "endpoint + 파라미터 → { data, total }" 한 줄짜리 계약만 요구하고,
+ * 호스트가 자기 클라이언트(TanStack Query, SWR, 사내 fetch 래퍼…)를 끼워 넣는다.
+ * 주입이 없으면 브라우저 fetch로 동작한다(어댑터를 안 준 SduiRenderer와 같은 정책).
+ */
+
+interface SearchRow {
+    id: string;
+    [key: string]: unknown;
+}
+interface SearchPage {
+    data: SearchRow[];
+    total: number;
+}
+/**
+ * 목록 한 페이지를 가져온다. 실패하면 Error(사용자에게 보여줄 메시지)를 던진다.
+ * signal은 파라미터가 바뀌거나 언마운트될 때 중단 신호로 넘어온다.
+ */
+type SearchFetcher = (endpoint: string, params: URLSearchParams, signal: AbortSignal) => Promise<SearchPage>;
+declare function SduiSearchDataProvider({ fetcher, children, }: {
+    fetcher: SearchFetcher;
+    children?: React__default.ReactNode;
+}): React__default.JSX.Element;
+declare function useSearchFetcher(): SearchFetcher;
+interface RemotePageState {
+    page: SearchPage;
+    isLoading: boolean;
+    error: Error | null;
+    reload: () => void;
+}
+/**
+ * endpoint+params 조회 훅. 라이브러리 안에 캐시를 두지 않는다(호스트 클라이언트의 몫) —
+ * 대신 직전 페이지를 유지해(keepPreviousData 상당) 페이지 이동 중 목록이 깜빡이지 않게 한다.
+ */
+declare function useRemoteSearchPage(endpoint: string, params: URLSearchParams): RemotePageState;
+
+/**
+ * 검색 툴바 — ERP `app/components/search/SearchToolbar.tsx`의 계약(타입·헬퍼·동작)을
+ * 그대로 옮긴 것. 스펙 호환이 목적이므로 값 규칙(쉼표 다중값, 느슨한 검색, 범위 키 이름)은
+ * 한 글자도 바꾸지 않았다.
+ *
+ * - 검색 버튼은 두지 않는다(Enter로 검색) — 시안 규칙 유지
+ * - 상세검색은 아이콘 버튼 → 드롭다운 패널(초기화/적용)
+ * - 적용된 조건은 칩(Tag)으로 나열되고, 다중 선택 칩은 값 하나씩 제거된다
+ */
+
+interface SearchOption {
+    label: string;
+    value: string;
+}
+interface CascadingSearchOption extends SearchOption {
+    children?: CascadingSearchOption[];
+}
+type SearchField = {
+    type?: 'text';
+    key: string;
+    label: string;
+    placeholder?: string;
+} | {
+    /** 다중 선택 — 값은 쉼표로 합쳐 저장한다 */
+    type: 'select';
+    key: string;
+    label: string;
+    options: SearchOption[];
+    allLabel?: string;
+} | {
+    type: 'dateRange';
+    key: string;
+    label: string;
+    fromKey?: string;
+    toKey?: string;
+} | {
+    type: 'numberRange';
+    key: string;
+    label: string;
+    fromKey?: string;
+    toKey?: string;
+    minPlaceholder?: string;
+    maxPlaceholder?: string;
+} | {
+    /**
+     * 계층 다중 선택 — 단계별 체크박스 목록 체인. 선택된 값들을 쉼표로 합쳐 저장하며,
+     * 부모를 선택하면 그 자손 선택은 제거되고 자손을 선택하면 그 조상 선택이 제거된다.
+     */
+    type: 'cascading';
+    key: string;
+    label: string;
+    options: CascadingSearchOption[];
+    allLabel?: string;
+};
+type SearchValues = Record<string, string>;
+declare function splitMultiValue(value: string): string[];
+declare function joinMultiValue(values: string[]): string;
+declare function normalizeSearchText(value: string): string;
+declare function includesLooseSearch(text: string, keyword: string): boolean;
+/** 필드가 점유하는 파라미터 키 전체 — 범위 필드는 From/To(Min/Max) 두 개다 */
+declare function searchFieldKeys(fields: SearchField[]): string[];
+declare function searchValuesFromParams(fields: SearchField[], params: URLSearchParams): SearchValues;
+declare function cleanSearchValues(fields: SearchField[], values: SearchValues): SearchValues;
+/**
+ * 값 → 자기 자신을 포함한 조상 값 목록(루트→자신 순).
+ * SearchResults의 클라이언트 필터링에서 "부모 선택 = 자손 값 매칭"을 구현할 때 쓴다.
+ */
+declare function cascadingValuePaths(options: CascadingSearchOption[]): Map<string, string[]>;
+interface SearchToolbarProps {
+    search: string;
+    onSearchChange: (value: string) => void;
+    onSearch: (search: string, advancedValues: SearchValues) => void;
+    advancedFields?: SearchField[];
+    advancedValues?: SearchValues;
+    placeholder?: string;
+    className?: string;
+    /** 필터 전용 모드: 검색 입력창 없이 상세검색 버튼+칩만 보여준다 */
+    hideSearchInput?: boolean;
+}
+declare function SearchToolbar({ search, onSearchChange, onSearch, advancedFields, advancedValues, placeholder, className, hideSearchInput, }: SearchToolbarProps): React__default.JSX.Element;
+
+/**
+ * 검색 결과 목록 — ERP `app/components/search/SearchResults.tsx`의 계약을 그대로 가져온 포팅.
+ * - 목록(Table)/카드 그리드(Card) 전환, 정렬, 좌/우 필터, 선택 후 일괄 액션, 페이지네이션
+ * - 데이터 가공(검색·필터·정렬·페이지 슬라이스)은 로컬 데이터 기준 클라이언트에서 수행하며,
+ *   서버 페이징으로 넘어가면 params를 그대로 백엔드 질의로 옮기면 된다
+ *
+ * ERP와 다른 점은 하나뿐이다: 검색/필터/페이지 파라미터를 URL에 직접 쓰지 않고
+ * `searchParams` + `onParamsChange`로만 다룬다(controlled). core는 라우터를 알지 않으며,
+ * 한 페이지에 목록이 여러 개 있어도 서로의 URL을 오염시키지 않는다.
+ */
+
+/** DS Badge 톤 */
+type BadgeTone = 'neutral' | 'info' | 'success' | 'warning' | 'danger' | 'brand';
+interface SearchAction<T> {
+    label: string;
+    onClick: (selectedItems: T[]) => void | Promise<void>;
+    icon?: string;
+    variant?: 'default' | 'destructive' | 'outline';
+}
+interface SearchColumn<T> {
+    key: string;
+    title: string;
+    sortable?: boolean;
+    /** DS Table은 left/right만 지원한다 */
+    textAlign?: 'left' | 'right';
+    /** 상대 폭 — 전체 ratio 합 대비 % 폭으로 환산된다 */
+    ratio?: number;
+    mono?: boolean;
+    strong?: boolean;
+    accessor?: (item: T) => string | number | Date | null | undefined;
+    render?: (item: T) => React__default.ReactNode;
+}
+interface SearchFilter {
+    key: string;
+    label: string;
+    options: {
+        key: string;
+        label: string;
+        value: string;
+    }[];
+}
+interface GridCardRow<T> {
+    icon?: React__default.ReactNode | ((item: T) => React__default.ReactNode);
+    label?: React__default.ReactNode | ((item: T) => React__default.ReactNode);
+    value?: React__default.ReactNode | ((item: T) => React__default.ReactNode);
+    show?: (item: T) => boolean;
+}
+interface GridCardConfig<T> {
+    title: (item: T) => React__default.ReactNode;
+    subtitle?: (item: T) => React__default.ReactNode;
+    badge?: (item: T) => {
+        text: React__default.ReactNode;
+        variant?: BadgeTone;
+    } | null;
+    actions?: (item: T) => React__default.ReactNode;
+    rows?: GridCardRow<T>[];
+    leftRows?: GridCardRow<T>[];
+    rightRows?: GridCardRow<T>[];
+    note?: (item: T) => React__default.ReactNode | null;
+}
+interface SearchResultsProps<T> {
+    item: {
+        data: T[];
+        total: number;
+    };
+    columns: SearchColumn<T>[];
+    gridConfig?: GridCardConfig<T>;
+    leftFilters?: SearchFilter[];
+    rightFilters?: SearchFilter[];
+    initialView?: 'grid' | 'list';
+    className?: string;
+    /** 검색/필터/페이지 파라미터 (controlled) */
+    searchParams: URLSearchParams;
+    onParamsChange: (next: URLSearchParams) => void;
+    /** 선택 액션 — 있으면 체크박스 선택이 활성화된다 */
+    actions?: SearchAction<T>[];
+    disableGrid?: boolean;
+    disableList?: boolean;
+    onRowClick?: (item: T) => void;
+    /** 화면에는 카운트만 표시 — 접근성 레이블·빈 상태 문구에 사용 */
+    title: string;
+    headerActions?: React__default.ReactNode;
+    isLoading?: boolean;
+    hideHeader?: boolean;
+    advancedSearchFields?: SearchField[];
+    searchPlaceholder?: string;
+    /**
+     * 가상 스크롤(대용량 목록) — true면 기본 임계값 150행, 숫자면 그 값이 임계값.
+     * 목록 뷰에서 행 수가 임계값을 넘으면 페이지 슬라이스 대신 전체 목록을 창 렌더한다
+     * (서버 페이징 모드에서는 현재 응답 분량만 가상화).
+     */
+    virtual?: boolean | number;
+}
+declare function SearchResults<T extends {
+    id: string;
+}>({ item, columns, gridConfig, leftFilters, rightFilters, initialView, className, searchParams, onParamsChange, actions, disableGrid, disableList, onRowClick, title, headerActions, isLoading, hideHeader, advancedSearchFields, searchPlaceholder, virtual, }: SearchResultsProps<T>): React__default.JSX.Element;
+
+/**
+ * SearchResults의 SDUI 어댑터 — 함수 프롭 없이 JSON만으로 검색+목록 화면을 구성한다.
+ * 백엔드는 이 프롭 형태(전부 직렬화 가능)를 그대로 내려주면 된다.
+ * 레지스트리에는 "SearchResults" / "RemoteSearchResults"로 등록된다.
+ *
+ * 선언적 스펙 → 함수 프롭 변환(cell.badge → render, run → onClick)은 전부 여기서 일어난다.
+ * 액션 실행은 useSduiDispatch로 렌더러에 되돌려 준다.
+ */
+
+/** JSON 컬럼 정의 — render 함수 대신 선언적 cell 스펙을 쓴다 */
+interface SduiSearchColumn {
+    key: string;
+    title: string;
+    sortable?: boolean;
+    /** DS Table은 left/right만 지원 */
+    textAlign?: 'left' | 'right';
+    ratio?: number;
+    mono?: boolean;
+    strong?: boolean;
+    /** 셀 표현. 생략하면 row[key]를 그대로 출력한다 */
+    cell?: {
+        type: 'badge';
+        /** 값 → Badge 톤 매핑 (없는 값은 neutral) */
+        toneMap?: Record<string, BadgeTone>;
+    };
+}
+interface SduiGridCard {
+    titleKey: string;
+    subtitleKey?: string;
+    badge?: {
+        key: string;
+        toneMap?: Record<string, BadgeTone>;
+    };
+    rows?: Array<{
+        label?: string;
+        valueKey: string;
+    }>;
+}
+interface SduiSearchAction {
+    label: string;
+    icon?: string;
+    variant?: 'default' | 'destructive' | 'outline';
+    /** 실행할 선언적 액션 — 이벤트 값으로 선택된 행 id 배열이 전달된다 */
+    run: SduiAction | SduiAction[];
+}
+/** 두 어댑터가 공유하는 선언적 프롭 */
+interface SduiSearchCommonProps {
+    title: string;
+    columns: SduiSearchColumn[];
+    fields?: SearchField[];
+    leftFilters?: SearchFilter[];
+    rightFilters?: SearchFilter[];
+    gridCard?: SduiGridCard;
+    actions?: SduiSearchAction[];
+    initialView?: 'grid' | 'list';
+    disableGrid?: boolean;
+    disableList?: boolean;
+    searchPlaceholder?: string;
+    /** 행 클릭 시 실행할 액션 — 이벤트 값으로 행 객체 전체가 전달된다 */
+    rowClick?: SduiAction | SduiAction[];
+    /** 렌더러의 slots.headerActions가 이 프롭으로 들어온다 */
+    headerActions?: React__default.ReactNode;
+    /** 가상 스크롤 — true면 기본 임계값 150행, 숫자면 그 값이 임계값 (JSON 직렬화 가능) */
+    virtual?: boolean | number;
+}
+interface SduiSearchResultsProps extends SduiSearchCommonProps {
+    data: SearchRow[];
+}
+declare function SduiSearchResults({ title, data, columns, fields, leftFilters, rightFilters, gridCard, actions, initialView, disableGrid, disableList, searchPlaceholder, rowClick, headerActions, virtual, }: SduiSearchResultsProps): React__default.JSX.Element;
+interface RemoteSearchResultsProps extends SduiSearchCommonProps {
+    /**
+     * 목록 endpoint — page/limit/search/필드키 쿼리를 붙여 조회하고
+     * `{ data: Row[]; total: number }`를 기대한다. 조회 자체는 어댑터(SearchFetcher)가 한다.
+     */
+    endpoint: string;
+    /** 페이지당 행 수 (기본 10) — limit 파라미터의 초기값 */
+    pageSize?: number;
+}
+declare function RemoteSearchResults({ title, endpoint, columns, fields, leftFilters, rightFilters, gridCard, actions, initialView, disableGrid, disableList, searchPlaceholder, rowClick, headerActions, virtual, pageSize, }: RemoteSearchResultsProps): React__default.JSX.Element;
+
+/**
+ * 목록 표 — SearchResults 전용. 내장 `Table`은 정렬 헤더·선택 표시·가상 스크롤을
+ * 다루지 않으므로, 같은 wp-table 마크업/클래스를 유지한 채 그 세 가지를 더한 변형이다.
+ *
+ * 가상 스크롤은 **의존성 없이** 직접 구현한다(core는 무거운 외부 의존성을 갖지 않는다).
+ * ERP는 @tanstack/react-virtual을 썼지만, 여기서 필요한 건 "고정 행 높이 목록의 창"뿐이라
+ * scrollTop → 인덱스 범위 계산으로 충분하다. 렌더 범위 밖은 상/하단 스페이서 행으로 대체한다
+ * (<table> 마크업에서 transform 대신 안전하게 동작하는 방식).
+ */
+
+interface ResultTableColumn<T> {
+    key: string;
+    header: React__default.ReactNode;
+    sortable?: boolean;
+    /** right → 우측 정렬 + tabular numerals (wp-table__num) */
+    align?: 'left' | 'right';
+    /** 고정폭 글꼴 셀 (wp-table__mono) */
+    mono?: boolean;
+    /** 강조 셀 (wp-table__strong) */
+    strong?: boolean;
+    /** CSS width — "180px", "22%" */
+    width?: string;
+    render?: (row: T, index: number) => React__default.ReactNode;
+}
+type SortDir = 'asc' | 'desc';
+interface ResultTableProps<T extends {
+    id: string;
+}> {
+    columns: ResultTableColumn<T>[];
+    rows: T[];
+    sort?: {
+        key: string;
+        dir: SortDir;
+    };
+    onSort?: (key: string) => void;
+    onRowClick?: (row: T) => void;
+    selectedIds?: string[];
+    /** rows가 비었을 때 표 대신 렌더 */
+    empty?: React__default.ReactNode;
+    /** true면 스크롤 창 안에서 보이는 행만 렌더한다 */
+    virtual?: boolean;
+    /** 가상 스크롤 컨테이너 높이(px). 기본 560 */
+    height?: number;
+    /** 가상 스크롤 행 높이(px) 초기 추정치. 첫 렌더 후 실측값으로 대체된다 — 기본 41(wp-table 기본 행) */
+    rowHeight?: number;
+}
+declare function ResultTable<T extends {
+    id: string;
+}>({ columns, rows, sort, onSort, onRowClick, selectedIds, empty, virtual, height, rowHeight, }: ResultTableProps<T>): React__default.JSX.Element;
+
+/**
+ * Dialog + 표준 닫기 UX(Escape·배경 클릭). 레지스트리의 "Dialog"는 이 래퍼다.
+ */
+declare function SduiDialog(props: DialogProps): React.JSX.Element;
+
+/**
+ * SDUI 폼 컨테이너. 필드 값은 페이지 상태의 `{id}.{field}` 키에 산다:
+ *   value:    { "$state": "orderForm.partner", "default": "" }
+ *   onChange: { "action": "setState", "key": "orderForm.partner", "fromEvent": true }
+ * 제출은 onSubmit에 submitForm 액션을 배선한다(Enter 제출 포함). 렌더러가 규칙 검증 후
+ * `{id}.$errors`(필드별 메시지) · `{id}.$submitting` · `{id}.$dirty`를 관리한다.
+ */
+interface SduiFormProps {
+    id: string;
+    /** 최초 마운트 시 시드할 필드 기본값 */
+    initial?: Record<string, SduiPropValue>;
+    /**
+     * URL 쿼리에서 프리필할 필드 — { 필드명: 쿼리파라미터명 }.
+     * initial보다 우선하며, 파라미터가 없거나 이미 값이 있으면 건드리지 않는다.
+     */
+    initialFromUrl?: Record<string, string>;
+    /** 필드별 검증 규칙 */
+    rules?: Record<string, SduiRule[]>;
+    /** 에러 메시지용 필드 라벨 */
+    labels?: Record<string, string>;
+    /** true면 작성 중(dirty) 창 닫기/새로고침 시 확인을 띄운다 */
+    guard?: boolean;
+    onSubmit?: (event: React__default.FormEvent) => void;
+    className?: string;
+    style?: React__default.CSSProperties;
+    children?: React__default.ReactNode;
+}
+declare function SduiForm({ id, initial, initialFromUrl, rules, labels, guard, onSubmit, className, style, children, }: SduiFormProps): React__default.JSX.Element;
+
+/**
+ * JSON 스펙의 `component` 이름 → 실제 컴포넌트.
+ * 이 키 목록이 곧 스펙에서 사용할 수 있는 컴포넌트 어휘 전체다.
+ * (ForEach는 렌더러 내장이라 등록하지 않는다.)
+ *
+ * 스펙의 props는 런타임에 오는 JSON이라 정적으로 검증할 수 없으므로 any를 쓴다.
+ */
+type SduiRegistry = Record<string, ComponentType<any>>;
+/**
+ * 기본 어휘.
+ *
+ * **여기 들어오는 조건은 "외부 의존성이 없을 것" 하나다.** 기본 레지스트리는 모듈
+ * 최상단에서 정적으로 import하므로, 여기 이름을 하나 올리면 그 컴포넌트가 끌고 오는
+ * 의존성이 core 번들에 그대로 붙는다 — 그 컴포넌트를 안 쓰는 스펙만 렌더하는
+ * 소비자도 예외 없이 내려받게 되고 트리셰이킹으로도 떼어낼 수 없다.
+ * 그래서 recharts가 필요한 `Chart`와 ol이 필요한 `MapPreview`는 여기 없다.
+ * `@wipco/sdui/rich`의 `richComponents`로 나가 있고, 필요한 소비자가
+ * `createRegistry(richComponents)`로 직접 얹는다(사용법은 그 파일 주석 참고).
+ */
+declare const defaultRegistry: {
+    Alert: typeof Alert;
+    Badge: typeof Badge;
+    Button: typeof Button;
+    Card: typeof Card;
+    Checkbox: typeof Checkbox;
+    DatePicker: typeof DatePicker;
+    DateRangePicker: typeof DateRangePicker;
+    Dialog: typeof SduiDialog;
+    EmptyState: typeof EmptyState;
+    Field: typeof Field;
+    Icon: typeof Icon;
+    IconButton: typeof IconButton;
+    Input: typeof Input;
+    Pagination: typeof Pagination;
+    ProgressBar: typeof ProgressBar;
+    Select: typeof Select;
+    Spinner: typeof Spinner;
+    StatCard: typeof StatCard;
+    Switch: typeof Switch;
+    Table: typeof Table;
+    Tabs: typeof Tabs;
+    Tag: typeof Tag;
+    Textarea: typeof Textarea;
+    Toast: typeof Toast;
+    Actions: typeof Actions;
+    Col: typeof Col;
+    Divider: typeof Divider;
+    Grid: typeof Grid;
+    KeyValueList: typeof KeyValueList;
+    PageHead: typeof PageHead;
+    Row: typeof Row;
+    Section: typeof Section;
+    Show: typeof Show;
+    Spacer: typeof Spacer;
+    Text: typeof Text;
+    Form: typeof SduiForm;
+    Can: typeof Can;
+    SearchResults: typeof SduiSearchResults;
+    RemoteSearchResults: typeof RemoteSearchResults;
+};
+/**
+ * 기본 어휘에 앱 고유 컴포넌트를 더한 레지스트리를 만든다.
+ * 같은 이름을 주면 기본 컴포넌트를 덮어쓴다.
+ *
+ * `@wipco/sdui/rich`의 무거운 위젯도 이 함수로 얹는다 —
+ * `createRegistry(richComponents)`가 곧 Chart/MapPreview를 켜는 스위치다.
+ */
+declare function createRegistry(extensions: SduiRegistry): SduiRegistry;
+
+/** custom 액션을 앱 코드로 위임하는 확장 지점. */
+type CustomActionHandler = (name: string, payload?: SduiPropValue, value?: unknown) => void;
+/** custom 검증 규칙 구현 — 에러 메시지 또는 null 반환 */
+type CustomValidator = (fieldValue: SduiPropValue | undefined, values: Record<string, SduiPropValue>) => string | null;
+interface SduiRendererProps {
+    page: SduiPage;
+    /** 컴포넌트 어휘 — 생략 시 내장 기본 레지스트리 */
+    registry?: SduiRegistry;
+    /** 내비게이션·API·실시간 연결점 — 생략 시 브라우저 기본 구현 */
+    adapter?: SduiAdapter;
+    /**
+     * page.urlState ↔ URL 쿼리 동기화 여부 (기본 true).
+     * 편집기 미리보기처럼 실제 페이지 라우트가 아닌 곳에 마운트할 때 false로 끈다 —
+     * 안 그러면 미리보기의 상태가 호스트 앱 URL을 오염시킨다.
+     */
+    syncUrlState?: boolean;
+    onCustomAction?: CustomActionHandler;
+    customValidators?: Record<string, CustomValidator>;
+}
+/**
+ * 서버(JSON 스펙) 주도 페이지 렌더러.
+ * 스펙은 직렬화 가능한 데이터만 담고, 상태·이벤트·폼·내비게이션은 여기서 해석한다.
+ */
+declare function SduiRenderer({ page, registry, adapter, syncUrlState, onCustomAction, customValidators, }: SduiRendererProps): React__default.JSX.Element;
+
+/**
+ * 스펙 구조 검증기 — 서버(또는 편집기)가 만든 스펙의 형태 오류를 렌더 전에 찾아낸다.
+ * 렌더러는 개발 모드에서 이 결과를 콘솔에 경고하고, 관리자 편집기는
+ * 저장 전에 같은 검사를 돌려 문제 목록을 보여준다.
+ */
+interface SpecIssue {
+    path: string;
+    message: string;
+}
+declare function validateSpec(page: unknown, knownComponents?: Set<string>): SpecIssue[];
+
+/**
+ * 권한 판정 주입 지점.
+ *
+ * 라이브러리는 **특정 권한 모델을 알지 않는다**. ERP는 권한을
+ * `{ entity, actions: CRUD[], scope }`로 두고 scope 서열(team<group<division<all)로
+ * 판정하지만, SDUI는 다른 프로젝트에도 쓰이므로 그 규칙을 core에 박아 넣을 수 없다.
+ * 그래서 "질의 형태"만 계약으로 정하고 판정은 호스트 앱이 주입한다.
+ */
+
+/** `Can`이 호스트에 던지는 질의. entity/action은 문자열이면 무엇이든 된다(도메인 어휘는 호스트 소유). */
+interface SduiCanQuery {
+    /** 대상 엔티티 식별자 (예: "asset", "contract") */
+    entity: string;
+    /** 수행 동작 (ERP 기준 create/read/update/delete) */
+    action: string;
+    /** 최소 적용 범위 — 생략 시 호스트가 자기 기본값(ERP라면 'team')으로 판단한다 */
+    scope?: string;
+}
+type SduiCanFn = (query: SduiCanQuery) => boolean;
+/**
+ * 권한 판정 설정.
+ * - 함수: 호스트 앱의 실제 판정
+ * - `'allow-all'`/`'deny-all'`: 판정 없이 전부 통과/차단하겠다는 **명시적** 선언
+ *   (편집기 미리보기·스토리북·테스트처럼 세션이 없는 자리에서 쓴다)
+ */
+type SduiCanSetting = SduiCanFn | 'allow-all' | 'deny-all';
+interface SduiPermissionProviderProps {
+    can?: SduiCanSetting;
+    children?: React__default.ReactNode;
+}
+/**
+ * 권한 판정을 하위 트리에 공급한다. SduiRenderer가 자기 `can` 프롭을 이 provider로 흘려보낸다.
+ * 렌더러 밖에서 직접 감싸도 동작한다(테스트·스토리북).
+ */
+declare function SduiPermissionProvider({ can, children }: SduiPermissionProviderProps): React__default.JSX.Element;
+/**
+ * 권한 판정기. 주입되지 않았으면 {@link MISSING}(경고 후 통과)을 돌려준다 —
+ * useSduiDispatch처럼 던지지 않는다. 권한 게이트 하나 때문에 페이지가 죽으면 안 된다.
+ */
+declare function useSduiCan(): SduiCanFn;
+
+/** SduiRenderer가 제공하는 액션 디스패처. 레지스트리의 복합 컴포넌트가 선언적 액션을 실행할 때 쓴다. */
+type SduiDispatch = (action: SduiAction, eventValue?: unknown) => void;
+declare function useSduiDispatch(): SduiDispatch;
+
+/** Form이 렌더러에 등록하는 검증 설정 */
+interface SduiFormConfig {
+    rules: Record<string, SduiRule[]>;
+    /** 에러 메시지에 쓸 필드 라벨 (없으면 필드 키) */
+    labels: Record<string, string>;
+}
+/**
+ * 렌더러 런타임 — 페이지 상태와 폼 레지스트리에 대한 접근.
+ * SduiForm 등 상태와 직접 상호작용해야 하는 스마트 컴포넌트가 쓴다.
+ */
+interface SduiRuntime {
+    state: Record<string, SduiPropValue | undefined>;
+    setEntries: (entries: Record<string, SduiPropValue | undefined>) => void;
+    registerForm: (id: string, config: SduiFormConfig) => void;
+    unregisterForm: (id: string) => void;
+}
+declare function useSduiRuntime(): SduiRuntime;
+
+interface Props {
+    name: string;
+    children: React__default.ReactNode;
+}
+interface State {
+    error: Error | null;
+}
+/**
+ * 노드 단위 에러 바운더리 — 스펙의 한 노드가 렌더 중 던져도
+ * 그 노드 자리에만 오류 카드를 남기고 페이지 나머지는 살린다.
+ */
+declare class NodeErrorBoundary extends React__default.Component<Props, State> {
+    state: State;
+    static getDerivedStateFromError(error: Error): State;
+    componentDidCatch(error: Error): void;
+    componentDidUpdate(prevProps: Props): void;
+    render(): string | number | bigint | boolean | React__default.JSX.Element | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | null | undefined;
+}
+
+export { Actions, type ActionsProps, Alert, type AlertProps, Badge, type BadgeProps, type BadgeTone, Button, type ButtonProps, Can, type CanProps, Card, type CardProps, type CascadingSearchOption, Checkbox, type CheckboxProps, Col, type CustomActionHandler, type CustomValidator, DatePicker, DateRangePicker, Dialog, type DialogProps, Divider, EmptyState, type EmptyStateProps, Field, type FieldProps, Grid, type GridCardConfig, type GridCardRow, type GridProps, Icon, IconButton, type IconButtonProps, type IconProps, Input, type InputProps, type Justify, type KeyValueItem, KeyValueList, type KeyValueListProps, NodeErrorBoundary, PageHead, type PageHeadProps, Pagination, type PaginationProps, ProgressBar, type ProgressBarProps, RemoteSearchResults, type RemoteSearchResultsProps, ResultTable, type ResultTableColumn, type ResultTableProps, Row, type RowProps, SduiAction, type SduiAdapter, type SduiCanFn, type SduiCanQuery, type SduiCanSetting, SduiDialog, type SduiDispatch, SduiForm, type SduiFormConfig, type SduiFormProps, type SduiGridCard, SduiPage, SduiPermissionProvider, SduiPropValue, type SduiRegistry, SduiRenderer, type SduiRendererProps, SduiRule, type SduiRuntime, type SduiSearchAction, type SduiSearchColumn, SduiSearchDataProvider, SduiSearchResults, type SduiSearchResultsProps, type SearchAction, type SearchColumn, type SearchFetcher, type SearchField, type SearchFilter, type SearchOption, type SearchPage, SearchResults, type SearchResultsProps, type SearchRow, SearchToolbar, type SearchValues, Section, type SectionProps, Select, type SelectOption, type SelectProps, Show, type ShowProps, type SortDir, Spacer, type SpacerProps, type SpecIssue, Spinner, type SpinnerProps, StatCard, type StatCardProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TableProps, Tabs, type TabsProps, Tag, type TagProps, Text, type TextPreset, type TextProps, Textarea, type TextareaProps, Toast, type ToastProps, cascadingValuePaths, cleanSearchValues, createRegistry, defaultAdapter, defaultRegistry, includesLooseSearch, joinMultiValue, normalizeSearchText, searchFieldKeys, searchValuesFromParams, splitMultiValue, useRemoteSearchPage, useSduiCan, useSduiDispatch, useSduiRuntime, useSearchFetcher, validateSpec };