@wipco/sdui 0.6.0 → 0.8.0

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import * as React from 'react';
 import React__default, { CSSProperties, ReactNode, 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 SduiContainerLayoutProps, a as SduiColumnsScale, b as SduiWeightScale, c as SduiTextAlignScale } from './layout-BnYUuWC2.js';
-export { C as CHILD_LAYOUT_PROPS, L as LAYOUT_CSS, d as SduiAlignScale, e as SduiChildLayoutProps, f as SduiGapScale, g as SduiSpanScale, h as childLayoutFrom, i as columnsClass, j as containerLayoutStyle, t as typographyStyle } from './layout-BnYUuWC2.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';
+import { S as SduiBoxProps, a as SduiContainerLayoutProps, b as SduiColumnsScale, c as SduiGapScale, d as SduiWeightScale, e as SduiTextAlignScale } from './layout-B1QrIBm6.js';
+export { C as CHILD_LAYOUT_PROPS, L as LAYOUT_CSS, f as SduiAlignScale, g as SduiChildLayoutProps, h as SduiSizeScale, i as SduiSpanScale, j as childLayoutFrom, k as columnsClass, l as containerLayoutStyle, m as joinClass, n as mergeStyle, t as typographyStyle } from './layout-B1QrIBm6.js';
+import { D as DatePickerProps, a as DateRangePickerProps } from './DatePicker-BndreCPl.js';
+export { b as DatePicker, c as DateRangePicker, d as DateRangeValue } from './DatePicker-BndreCPl.js';
 
 /**
  * 호스트 앱 연결점 — ERP에서는 라우터·erpFetch·SSE가 하던 일을
@@ -141,1085 +141,1121 @@ declare function useSduiAssetResolver(): SduiAssetResolver;
  */
 declare function useSduiSandbox(): boolean;
 
+/** SduiRenderer가 제공하는 액션 디스패처. 레지스트리의 복합 컴포넌트가 선언적 액션을 실행할 때 쓴다. */
+type SduiDispatch = (action: SduiAction, eventValue?: unknown) => void;
+declare function useSduiDispatch(): SduiDispatch;
+
 /**
- * 권한 게이트 — 통과하면 children, 실패하면 fallback 슬롯(없으면 아무 것도)을 렌더한다.
- * 판정 자체는 하지 않는다. 호스트가 주입한 콜백(permission.tsx)에 질의만 위임한다.
+ * 목록 원격 조회 어댑터.
  *
- * 스펙 예 (ERP 85개 페이지 중 56개가 쓰는 형태 그대로):
- *   { "component": "Can",
- *     "props": { "entity": "asset", "action": "create" },
- *     "children": [ { "component": "Button", ... } ] }
+ * core는 특정 HTTP 클라이언트에 묶이지 않는다 — ERP는 SWR(useErpQuery)로 조회했지만
+ * 라이브러리는 "endpoint + 파라미터 → { data, total }" 한 줄짜리 계약만 요구하고,
+ * 호스트가 자기 클라이언트(TanStack Query, SWR, 사내 fetch 래퍼…)를 끼워 넣는다.
+ *
+ * 조회 함수를 고르는 순서는 셋이다:
+ *
+ *  1. `SduiSearchDataProvider`로 **명시 주입**한 fetcher — 가장 세다. 조회를 통째로 소유하는
+ *     소비자(ERP RemoteSearchResults 등)의 뜻을 다른 무엇도 덮지 않는다.
+ *  2. 렌더러 어댑터의 `fetch` — 호스트가 자기 인증·에러 처리를 꽂아 둔 자리다. 여기를 거치면
+ *     소비 앱은 세션 규약을 그대로 태우고, 편집기 캔버스처럼 어댑터로 바깥을 막아 둔
+ *     자리에서는 목록 조회도 **함께 막힌다**. 예전에는 이 경로만 잠금 밖이라, 캔버스가
+ *     뜨는 것만으로 저장하지도 않은 스펙이 운영 API를 세션 쿠키와 함께 때렸다.
+ *  3. 둘 다 없으면 브라우저 fetch(어댑터를 안 준 SduiRenderer와 같은 정책) — 감싸지 않은
+ *     드롭인 소비자의 동작을 바꾸지 않기 위한 폴백이다.
  */
 
-interface CanProps {
-    /** 대상 엔티티 식별자 */
-    entity: string;
-    /** 수행 동작 — 생략 시 'read'(ERP Can과 같은 기본값) */
-    action?: string;
-    /** 최소 적용 범위 — 생략 시 호스트 판정기의 기본값을 따른다 */
-    scope?: string;
-    /** 차단 시 대신 보여줄 내용 (JSON에서는 slots.fallback) */
-    fallback?: React__default.ReactNode;
+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;
 }
-declare function Can({ entity, action, scope, fallback, children }: CanProps): React__default.JSX.Element;
-
 /**
- * 내장 기본 컴포넌트 세트 — WIPCO 디자인 시스템(wp-* 토큰)을 따르는
- * 독립 구현. ERP 디자인 시스템과 같은 프롭 규약을 쓰므로 스펙이 호환된다.
- * 스타일은 styles.css 한 파일이 담당한다.
+ * endpoint+params 조회 훅. 라이브러리 안에 캐시를 두지 않는다(호스트 클라이언트의 몫) —
+ * 대신 직전 페이지를 유지해(keepPreviousData 상당) 페이지 이동 중 목록이 깜빡이지 않게 한다.
+ *
+ * 중단 신호는 fetcher에 넘기지만 호스트가 무시할 수도 있다(어댑터 계약상 선택 사항) —
+ * 그래서 늦게 도착한 응답은 아래 `alive` 검사로 한 번 더 버린다.
  */
+declare function useRemoteSearchPage(endpoint: string, params: URLSearchParams): RemotePageState;
 
-interface IconProps extends React__default.SVGAttributes<SVGSVGElement> {
-    /** kebab-case Lucide 이름 — "scan-line", "layers", "circle-alert". */
-    name: string;
-    /** 픽셀 박스. 기본 18. */
-    size?: number;
-    /** 기본 1.5. 32px 위에서만 2를 쓴다. */
-    strokeWidth?: number;
-    /** 주면 role="img" + aria-label. 장식 아이콘은 생략한다. */
-    title?: string;
-}
 /**
- * 스트로크 아이콘. 130종을 24px 그리드 위에 그린다.
+ * 검색 툴바 — ERP `app/components/search/SearchToolbar.tsx`의 계약(타입·헬퍼·동작)을
+ * 그대로 옮긴 것. 스펙 호환이 목적이므로 값 규칙(쉼표 다중값, 느슨한 검색, 범위 키 이름)은
+ * 한 글자도 바꾸지 않았다.
  *
- * **등록되지 않은 이름은 `null`이다** — 예전엔 점(●)으로 대체했는데, 그러면 스펙 오타나
- * 아직 안 넣은 이름이 "없던 자국"으로 화면에 남는다. 빠진 아이콘은 비어 보이는 편이
- * 낫고, 어차피 잘못된 이름은 check-meta가 팔레트 쪽에서 잡는다.
+ * - 검색 버튼은 두지 않는다(Enter로 검색) — 시안 규칙 유지
+ * - 상세검색은 아이콘 버튼 → 드롭다운 패널(초기화/적용)
+ * - 적용된 조건은 칩(Tag)으로 나열되고, 다중 선택 칩은 값 하나씩 제거된다
  */
-declare function Icon({ name, size, strokeWidth, className, style, title, ...rest }: IconProps): React__default.JSX.Element | null;
-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;
-    /**
-     * 라벨을 감추고 스피너를 돌린다.
-     *
-     * 스피너는 **CSS가 그린다**(`.wp-btn--loading::after`) — 엘리먼트를 따로 넣지 않는다.
-     * 예전엔 `<span class="wp-spinner">`를 렌더했는데, 같은 클래스에 ::after 규칙을 가진
-     * 디자인 시스템 스타일시트와 겹치면 원이 두 개 돈다. 그릴 주체를 CSS 한쪽으로 모은다.
-     */
-    loading?: boolean;
-    block?: boolean;
-    disabled?: boolean;
-    /**
-     * 다른 태그로 렌더한다. 링크로 보내야 하는 자리(SSO 이동 등)는 `as="a"` + `href`다 —
-     * `<button>`에 href를 달면 아무 데도 가지 않는다.
-     *
-     * button이 아닐 때는 `disabled` 속성이 없으므로 비활성은 `aria-disabled`로만 알린다
-     * (그래서 button일 때도 둘 다 붙인다 — 표기가 태그에 따라 달라지지 않게).
-     */
-    as?: 'button' | 'a' | 'span';
-    children?: React__default.ReactNode;
-}
-declare function Button({ variant, size, icon, iconEnd, loading, block, disabled, as, children, className, ...rest }: ButtonProps): React__default.JSX.Element;
-interface IconButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
-    icon: string;
-    /** 접근성 라벨(필수 권장) — title이자 aria-label이 된다. */
-    label?: string;
-    /** xs 24 · sm 28 · md 32(기본) · lg 40 px 정사각 */
-    size?: 'xs' | 'sm' | 'md' | 'lg';
-    /**
-     * 예전 이름. `variant`를 주지 않았을 때만 쓰인다 — `variant` 주석 참고.
-     * @deprecated `variant`로 옮겨라. `tone="danger"`는 `variant="danger"`와 같다.
-     */
-    tone?: 'default' | 'danger';
-    /**
-     * 디자인 시스템 어휘. ghost = 투명(기본) · outlined = 하드라인 테두리 ·
-     * solid = 채움 · danger = 빨강 · onchrome = 네이비 사이드바/탑바 위.
-     *
-     * 같은 자리를 가리키는 프롭이 `tone`과 둘로 갈라져 있는데 **variant가 이긴다** —
-     * 스펙과 디자인 시스템 문서가 쓰는 이름이 이쪽이고, 값 어휘도 넓다(outlined는 tone에 없다).
-     * variant를 주지 않으면 tone이 그대로 먹으므로 tone만 쓰던 코드는 그대로 돈다.
-     */
-    variant?: 'ghost' | 'outlined' | 'solid' | 'danger' | 'onchrome';
-    /** 토글 상태 — aria-pressed로 나가고 선택 틴트를 입는다. */
-    pressed?: boolean;
-    disabled?: boolean;
-}
-declare function IconButton({ icon, label, size, tone, variant, pressed, disabled, 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;
-    /**
-     * 입력 오른쪽 끝에 겹쳐 그리는 후행 표시.
-     *
-     * **문자열은 아이콘 이름으로 읽는다** — `trailing="eye"`(비밀번호 보기)가 원래 용례다.
-     * 등록되지 않은 이름이면 Icon이 null을 내므로 자리만 남는다. 단위 글자("원", "mm")를
-     * 넣고 싶으면 문자열이 아니라 노드로 줘라: `trailing={<span>원</span>}`.
-     */
-    trailing?: React__default.ReactNode;
+
+interface SearchOption {
+    label: string;
+    value: string;
 }
-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;
+interface CascadingSearchOption extends SearchOption {
+    children?: CascadingSearchOption[];
 }
-declare function Textarea({ invalid, rows, className, ...rest }: TextareaProps): React__default.JSX.Element;
-interface SelectOption {
-    value: string;
+type SearchField = {
+    type?: 'text';
+    key: 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;
+} | {
+    /** 다중 선택 — 값은 쉼표로 합쳐 저장한다 */
+    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;
+} | {
     /**
-     * 부분 선택 — 전체선택 체크박스의 "일부만 골랐다" 상태.
-     *
-     * HTML 속성이 아니라 DOM 프로퍼티라 ref로 직접 넣어야 한다(마크업에 남지 않는다).
-     * 글리프도 체크가 아니라 빼기로 바뀐다.
+     * 계층 다중 선택 — 단계별 체크박스 목록 체인. 선택된 값들을 쉼표로 합쳐 저장하며,
+     * 부모를 선택하면 그 자손 선택은 제거되고 자손을 선택하면 그 조상 선택이 제거된다.
      */
-    indeterminate?: boolean;
-    disabled?: boolean;
-}
-declare function Checkbox({ label, description, indeterminate, 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;
+    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 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;
-    /** 인라인 액션 하나 — 되돌리기 같은 것. Button variant="link"를 넣는다. */
-    action?: React__default.ReactNode;
-    onClose?: () => void;
-}
-/** 우하단 일시 알림. .wp-toast-region 안에 렌더링된다. */
-declare function Toast({ tone, title, children, action, onClose, className, ...rest }: ToastProps): React__default.JSX.Element;
-interface TabItem {
-    value: string;
-    label: React__default.ReactNode;
+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;
-    count?: number;
-}
-interface TabsProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'onChange'> {
-    items: TabItem[];
-    value: string;
-    onChange?: (value: string) => void;
-    size?: 'md' | 'lg';
-    /** 네이비 탑바 위 — 밝은 글자, 빨간 인디케이터. */
-    onChrome?: boolean;
+    variant?: 'default' | 'destructive' | 'outline';
 }
-declare function Tabs({ items, value, onChange, size, onChrome, className, ...rest }: TabsProps): React__default.JSX.Element;
-interface TableColumn {
+interface SearchColumn<T> {
     key: string;
-    header: React__default.ReactNode;
-    /** CSS 폭 — "180px", "22%" */
-    width?: string;
-    align?: 'left' | 'right';
+    title: string;
+    sortable?: boolean;
+    /** DS Table은 left/right만 지원한다 */
+    textAlign?: 'left' | 'right';
+    /** 상대 폭 — 전체 ratio 합 대비 % 폭으로 환산된다 */
+    ratio?: number;
     mono?: boolean;
     strong?: boolean;
-    /** 헤더를 정렬 버튼으로 만든다. 실제 정렬은 `sort`·`onSort`가 담당한다. */
-    sortable?: boolean;
-    /**
-     * 셀 값을 Badge로 렌더링 — JSON 스펙에서 쓸 수 있는 선언적 지정.
-     * toneMap: 값 → tone, labelMap: 값 → 표시 텍스트(생략 시 값 그대로)
-     */
-    badge?: {
-        toneMap?: Record<string, string>;
-        labelMap?: Record<string, string>;
-    };
-    /** 프로그래매틱 사용 전용 — JSON 스펙에서는 쓸 수 없다 */
-    render?: (row: any, index: number) => React__default.ReactNode;
+    accessor?: (item: T) => string | number | Date | null | undefined;
+    render?: (item: T) => React__default.ReactNode;
 }
-interface TableProps extends React__default.TableHTMLAttributes<HTMLTableElement> {
-    columns: TableColumn[];
-    rows: any[];
-    /** 40px 대신 32px 행 */
-    dense?: boolean;
-    hover?: boolean;
-    /** 스크롤 본문용 고정 헤더 */
-    sticky?: boolean;
-    /** 현재 정렬 상태 — 해당 컬럼 헤더의 화살표 방향을 정한다 */
-    sort?: {
+interface SearchFilter {
+    key: string;
+    label: string;
+    options: {
         key: string;
-        dir: 'asc' | 'desc';
-    };
-    /** 정렬 헤더를 눌렀을 때. 주지 않으면 sortable 컬럼도 버튼이 되지 않는다 */
-    onSort?: (key: string) => void;
-    /** 선택된 행의 rowKey 값 — 해당 행에 aria-selected가 붙고 하이라이트된다 */
-    selectedIds?: any[];
-    /** 행 key와 선택에 쓸 필드. 기본 "id" */
-    rowKey?: string;
-    onRowClick?: (row: any) => void;
-    /** rows가 비었을 때 대신 렌더링 — EmptyState 권장 */
-    empty?: React__default.ReactNode;
+        label: string;
+        value: string;
+    }[];
 }
-declare function Table({ columns, rows, dense, hover, sticky, sort, onSort, selectedIds, 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';
+/**
+ * 목록/카드 전환 버튼 한 칸.
+ *
+ * 예전에는 이 두 칸(`목록`/`카드`)이 코드에 박혀 있어 스펙이 라벨·아이콘·순서를
+ * 바꿀 수 없었고, `disableGrid`/`disableList`로 **끄는 것만** 가능했다.
+ * 이제 `views`로 목록 자체를 정할 수 있고, 두 disable 프롭은 그 축약형으로 남는다.
+ */
+interface SearchViewItem {
+    value: 'grid' | 'list';
+    /** 생략 시 기본 아이콘 — list=list, grid=layout-grid */
     icon?: string;
-    footer?: React__default.ReactNode;
-    size?: 'md' | 'sm';
+    /** 생략 시 기본 라벨 — list=목록, grid=카드 */
+    label?: string;
 }
-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;
+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;
 }
-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';
-    /** 네이비/뷰어 표면 위 — 밝은 테두리로 뒤집는다. */
-    inverse?: boolean;
-    label?: string;
+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;
 }
-declare function Spinner({ size, inverse, label, className, ...rest }: SpinnerProps): React__default.JSX.Element;
-interface ProgressBarProps extends React__default.HTMLAttributes<HTMLDivElement> {
-    /** 0~`max` */
-    value: number;
-    /** 기본 100. 용량 게이지처럼 분모가 100이 아닌 자리에 쓴다 */
-    max?: number;
-    /** danger 임계 강조 등 */
-    tone?: 'brand' | 'success' | 'warning' | 'danger' | 'info';
-    /** sm 4 · md 6(기본) · lg 8 px */
-    size?: 'sm' | 'md' | 'lg';
-    /** 사선 해치 애니메이션 — 진행 중인 작업에만 */
-    striped?: boolean;
-    label?: React__default.ReactNode;
+interface SearchResultsProps<T> {
+    item: {
+        data: T[];
+        total: number;
+    };
+    columns: SearchColumn<T>[];
+    gridConfig?: GridCardConfig<T>;
+    leftFilters?: SearchFilter[];
+    rightFilters?: SearchFilter[];
+    initialView?: 'grid' | 'list';
     /**
-     * 현재 값을 퍼센트로 적는다.
-     *
-     * 막대만으로는 82%와 91%를 구분할 수 없어서, 여러 개를 세로로 쌓아 비교하는
-     * 자리(공정별 진척 목록 등)에서 필요하다. 라벨이 있으면 라벨 줄 오른쪽 끝에,
-     * 라벨이 없으면 막대 오른쪽 옆(.wp-meter-row)에 붙는다.
+     * 노출할 보기 목록. 생략하면 목록/카드 두 칸이 기본값이고,
+     * 그때만 `disableGrid`/`disableList`가 목록을 깎는다(둘 다 오면 views가 이긴다).
+     * 한 칸만 남으면 전환 버튼 자체를 그리지 않는다.
      */
-    showValue?: boolean;
-}
-declare function ProgressBar({ value, max, tone, size, striped, showValue, label, 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;
-/** 배타 뷰 전환 스위치. 항목 2~4개까지, 그보다 많으면 Select다. */
-interface SegmentedItem {
-    value: string;
-    label?: string;
-    /** 앞에 붙일 아이콘 이름 */
-    icon?: string;
-}
-interface SegmentedControlProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'onChange'> {
-    items: SegmentedItem[];
-    value: string;
-    onChange?: (value: string) => void;
-    /** md(24px 항목, 기본) · lg(30px) */
-    size?: 'md' | 'lg';
+    views?: SearchViewItem[];
+    /** 페이지당 건수 선택지. 생략 시 [10, 20, 50, 100]. 첫 값이 기본 페이지 크기다. */
+    pageSizes?: number[];
     className?: string;
+    /** 바깥에서 온 인라인 style — 자기 축(폭·여백)이 이 컴포넌트에도 닿게 하는 통로다. */
+    style?: React__default.CSSProperties;
+    /** 검색/필터/페이지 파라미터 (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;
 }
 /**
- * 목록/카드, 2D/3D, 일/주/월처럼 하나만 고르는 뷰 전환.
+ * 스펙이 준 페이지 크기 목록을 다듬는다 — 양의 정수만, 중복 제거, 오름차순.
+ * 쓸 값이 하나도 없으면 undefined를 돌려 기본 선택지를 쓰게 한다.
+ */
+declare function normalizePageSizes(sizes: number[] | undefined): number[] | undefined;
+declare function SearchResults<T extends {
+    id: string;
+}>({ item, columns, gridConfig, leftFilters, rightFilters, initialView, views, pageSizes, className, style, searchParams, onParamsChange, actions, disableGrid, disableList, onRowClick, title, headerActions, isLoading, hideHeader, advancedSearchFields, searchPlaceholder, virtual, }: SearchResultsProps<T>): React__default.JSX.Element;
+
+/**
+ * 셀 표현 어휘 — 목록 컬럼의 셀과 카드 행의 값이 **같은 규칙**을 쓴다.
  *
- * `search/SearchResults.tsx`가 "라이브러리에 SegmentedControl이 없다"는 이유로
- * 안에 `ViewToggle` 사본을 들고 있었다. 이 컴포넌트가 그 사본의 원본이다.
+ * 예전에는 스펙이 고를 수 있는 표현이 `badge` 하나뿐이었고 나머지는 `row[key]` 원문
+ * 출력이었다. 밑에 깔린 `SearchColumn.render`는 임의의 노드를 그릴 수 있는데 스펙에는
+ * 그 역량이 두 종류(원문/배지)로만 열려 있었다는 뜻이다. 여기서 그 구멍을 메운다.
+ *
+ * 규약 두 가지:
+ * - **모르는 type은 원문으로 강등한다.** 스펙은 신뢰할 수 없는 입력이고, 컬럼 하나 때문에
+ *   목록 전체가 비면 안 된다. 판별 유니언이라 새 type을 더해도 옛 스펙은 그대로 돈다.
+ * - **값을 해석하지 못하면 원문을 그대로 낸다.** ERP는 이미 서식된 문자열(`"12,400,000"`,
+ *   `"2026-07-31 09:00"`)을 내려주는 자리가 많아, 파싱 실패를 빈칸으로 만들면 퇴행이다.
  */
-declare function SegmentedControl({ items, value, onChange, size, className, ...rest }: SegmentedControlProps): React__default.JSX.Element;
-/** 사람·팀·자산의 신원 표식. */
-interface AvatarProps extends React__default.HTMLAttributes<HTMLSpanElement> {
-    /** 이니셜과 title에 쓰인다 */
-    name?: string;
-    /** 이미지 URL — 있으면 이니셜을 대신한다 */
-    src?: string;
-    /** hex(기본, 심볼 실루엣) · round(사람) · square(자산) */
-    shape?: 'hex' | 'round' | 'square';
-    /** xs 20 · sm 24 · md 28(기본) · lg 36 · xl 48 px */
-    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-    /** brand 네이비(기본) · muted 회색 · accent 레드 */
-    tone?: 'brand' | 'muted' | 'accent';
-    className?: string;
-}
-/** 사람/자산 표식. 기본은 육각형 — 심볼의 실루엣이다. */
-declare function Avatar({ name, src, shape, size, tone, className, ...rest }: AvatarProps): React__default.JSX.Element;
-/** 프로젝트에서 개별 객체까지의 위치. 4단계를 넘으면 가운데를 접는다. */
-interface BreadcrumbItem {
-    label: React__default.ReactNode;
-    href?: string;
-    icon?: string;
-    onClick?: () => void;
+
+/** ProgressBar가 받는 톤 */
+type MeterTone = 'brand' | 'success' | 'warning' | 'danger' | 'info';
+/** 값을 그대로 출력한다. cell을 생략한 것과 같으며, 명시하고 싶을 때 쓴다. */
+interface SduiTextCell {
+    type: 'text';
 }
-interface BreadcrumbProps extends React__default.HTMLAttributes<HTMLElement> {
-    items: BreadcrumbItem[];
-    className?: string;
+/** 값을 배지로. 톤은 값별 매핑(없는 값은 neutral). */
+interface SduiBadgeCell {
+    type: 'badge';
+    toneMap?: Record<string, BadgeTone>;
 }
-/** 계보 표시. 마지막 항목은 현재 객체이므로 링크가 아니다. */
-declare function Breadcrumb({ items, className, ...rest }: BreadcrumbProps): React__default.JSX.Element;
-/** 후보가 전부 보이는 배타 선택. 5개 이상이면 Select다. */
-interface RadioProps extends React__default.InputHTMLAttributes<HTMLInputElement> {
-    label?: React__default.ReactNode;
-    description?: React__default.ReactNode;
-    disabled?: boolean;
+/** 값을 태그로. 선행 점 색은 값별 매핑(CSS 색상 문자열). */
+interface SduiTagCell {
+    type: 'tag';
+    colorMap?: Record<string, string>;
+    filled?: boolean;
 }
-/** 2~4개 후보를 다 보여 주는 라디오. Checkbox와 마크업을 공유한다(.wp-check). */
-declare function Radio({ label, description, disabled, className, ...rest }: RadioProps): React__default.JSX.Element;
-/** 주 내비게이션 목록. 활성 항목에 빨간 에지 마커가 붙는다. */
-interface SidebarNavItem {
-    value: string;
-    label: React__default.ReactNode;
+/**
+ * 값을 링크로. `to`는 `/assets/{id}` 처럼 행의 필드를 `{키}`로 끼워 넣는 경로 템플릿이고,
+ * 클릭하면 navigate 액션이 나간다(렌더러가 대상 안전성을 다시 검사한다).
+ */
+interface SduiLinkCell {
+    type: 'link';
+    to: string;
+    /** 링크 문구로 쓸 필드 — 생략하면 컬럼 자신의 값 */
+    labelKey?: string;
     icon?: string;
-    meta?: React__default.ReactNode;
-    href?: string;
-}
-interface SidebarNavSection {
-    label?: React__default.ReactNode;
-    items: SidebarNavItem[];
-}
-interface SidebarNavProps extends Omit<React__default.HTMLAttributes<HTMLElement>, 'onSelect'> {
-    sections: SidebarNavSection[];
-    value?: string;
-    onSelect?: (value: string) => void;
-    /** 아이콘만 남기는 56px 레일 */
-    collapsed?: boolean;
-    /** 흰 표면(설정 하위 내비) 위에 쓰는 밝은 변형 */
-    light?: boolean;
-    className?: string;
 }
-/** 네이비 사이드바의 주 내비게이션. 섹션 + 항목. */
-declare function SidebarNav({ sections, value, onSelect, collapsed, light, className, ...rest }: SidebarNavProps): React__default.JSX.Element;
-/** 아이콘 전용 컨트롤·잘린 값에 붙이는 hover/focus 힌트. */
-interface TooltipProps extends React__default.HTMLAttributes<HTMLSpanElement> {
-    label: React__default.ReactNode;
-    /** 단축키 칩, 예: "⌘K" */
-    shortcut?: string;
-    placement?: 'top' | 'bottom' | 'left' | 'right';
-    /** 여러 줄 허용(최대 240px) */
-    wrap?: boolean;
-    children?: React__default.ReactNode;
-    className?: string;
+/** 값을 진행 막대로. 분모는 maxKey(행의 필드) → max → 100 순으로 정한다. */
+interface SduiProgressCell {
+    type: 'progress';
+    max?: number;
+    maxKey?: string;
+    tone?: MeterTone;
+    showValue?: boolean;
 }
-/** hover 힌트. 트리거를 감싸며 위치는 CSS가 잡는다 — 포털을 쓰지 않는다. */
-declare function Tooltip({ label, shortcut, placement, wrap, children, className, ...rest }: TooltipProps): React__default.JSX.Element;
-
-interface GridProps extends SduiContainerLayoutProps {
-    /** wp-grid--N 프리셋 (1~6) */
-    columns?: SduiColumnsScale;
-    /** 커스텀 트랙 — grid-template-columns 값. columns보다 우선 */
-    template?: string;
-    className?: string;
-    style?: React__default.CSSProperties;
-    children?: React__default.ReactNode;
+/** 값을 아이콘으로. iconMap에 없는 값은 icon(공통 기본)으로, 그것도 없으면 원문으로. */
+interface SduiIconCell {
+    type: 'icon';
+    iconMap?: Record<string, string>;
+    icon?: string;
+    /** 아이콘 뒤에 값도 적는다 */
+    withLabel?: boolean;
 }
-declare function Grid({ columns, template, gap, align, justify, wrap, className, style, children }: GridProps): React__default.JSX.Element;
-type Justify = 'start' | 'center' | 'end' | 'between';
-interface RowProps extends SduiContainerLayoutProps {
-    /** 가로 정렬 (기본 start) */
-    justify?: Justify;
-    className?: string;
-    style?: React__default.CSSProperties;
-    children?: React__default.ReactNode;
+/**
+ * 숫자 서식(ko-KR 천단위) + 접두/접미. 통화는 `{ type:'number', suffix:'원' }`이다 —
+ * `currency` 타입을 따로 두지 않은 이유는 ERP가 원화 단일이고, 그 자리에 필요한 것이
+ * 통화 기호가 아니라 "단위 문자열"이기 때문이다(원·건·개·%·kg).
+ */
+interface SduiNumberCell {
+    type: 'number';
+    /** 소수 자릿수 (기본 0) */
+    digits?: number;
+    prefix?: string;
+    suffix?: string;
 }
-declare function Row({ justify, gap, align, wrap, className, style, children }: RowProps): React__default.JSX.Element;
-interface ActionsProps extends SduiContainerLayoutProps {
-    /** 가로 정렬 — 기본 end(우측) */
-    justify?: Justify;
-    className?: string;
-    style?: React__default.CSSProperties;
-    children?: React__default.ReactNode;
+/** 날짜 서식(ko-KR). 파싱되지 않는 값은 원문 그대로. */
+interface SduiDateCell {
+    type: 'date';
+    format?: 'date' | 'datetime' | 'time';
 }
+type SduiCell = SduiTextCell | SduiBadgeCell | SduiTagCell | SduiLinkCell | SduiProgressCell | SduiIconCell | SduiNumberCell | SduiDateCell;
 /**
- * 액션 버튼 묶음 — 슬롯 안에서 정렬을 제어한다(flex:1로 슬롯 폭 차지).
- *
- * `justify = 'end'`가 **2단(타입별 기본)의 실제 사례**다. 전역 기본은 `.wp-row`의
- * `flex-start`인데 이 타입만 `end`로 시작하고, 스펙이 `justify`를 주면 그것이 이긴다.
+ * 셀 스펙 → 렌더 함수. `undefined`를 돌려주면 호출자가 원문을 그대로 출력한다
+ * (표에서는 `<td>{row[key]}</td>`, 카드에서는 값 문자열).
  */
-declare function Actions({ justify, gap, align, wrap, className, style, children }: ActionsProps): React__default.JSX.Element;
-interface ColProps extends SduiContainerLayoutProps {
-    className?: string;
-    style?: React__default.CSSProperties;
-    children?: React__default.ReactNode;
+declare function cellRenderer(cell: SduiCell | undefined, key: string, dispatch: SduiDispatch): ((row: SearchRow) => React__default.ReactNode) | undefined;
+
+/** 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]를 그대로 출력한다 — 어휘는 `cells.tsx` 참고 */
+    cell?: SduiCell;
 }
-declare function Col({ gap, align, justify, wrap, className, style, children }: ColProps): React__default.JSX.Element;
-interface SpacerProps {
-    /**
-     * 간격 토큰 단계(`--wp-space-N`). 주면 "남는 공간 밀어내기"가 아니라
-     * 그만큼의 **고정 간격**이 된다 — Card 본문처럼 gap이 이미 걸린 세로 묶음 안에서
-     * 한 덩어리를 다음 덩어리와 더 떼어 놓을 때 쓴다.
-     * 토큰에 없는 단계를 주면 무시하고 기존 flex 채움으로 돌아간다.
-     */
-    size?: 1 | 2 | 3 | 4 | 5 | 6 | 8;
+/**
+ * 카드 행 표시 조건.
+ * `key`만 주면 "그 값이 비어 있지 않을 때"다. 값이 없는 행을 감춰 카드 높이가
+ * 들쭉날쭉해지지 않게 하는 것이 주 용도라 그것이 기본 의미다.
+ */
+interface SduiRowCondition {
+    key: string;
+    equals?: string | number | boolean;
+    in?: Array<string | number>;
+    notEmpty?: boolean;
 }
-declare function Spacer({ size }: SpacerProps): React__default.JSX.Element;
-interface SectionProps extends SduiContainerLayoutProps {
-    title?: React__default.ReactNode;
-    className?: string;
-    style?: React__default.CSSProperties;
-    children?: React__default.ReactNode;
+interface SduiGridCardRow {
+    label?: string;
+    valueKey: string;
+    /** 라벨 앞 아이콘 */
+    icon?: string;
+    /** 값 표현 — 컬럼 셀과 같은 어휘 */
+    cell?: SduiCell;
+    /** 조건부 행 */
+    showWhen?: SduiRowCondition;
 }
-declare function Section({ title, gap, align, justify, wrap, 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';
-    /**
-     * 글자 굵기 — `preset`이 정한 굵기를 이 자리에서만 뒤집는다.
-     * 프리셋 19종이 크기·굵기·정렬을 묶어 놔 "본문 크기인데 굵게"를 만들 수 없던 것을 푼다.
-     */
-    weight?: SduiWeightScale;
-    /** 글자 정렬. */
-    textAlign?: SduiTextAlignScale;
-    className?: string;
-    style?: React__default.CSSProperties;
-    /** children 대신 쓸 수 있는 내용 — 상태 바인딩({ "$state": ... })에 유용 */
-    value?: React__default.ReactNode;
-    children?: React__default.ReactNode;
+/** 카드 우상단 버튼 — 이벤트 값으로 행 객체 전체가 전달된다 */
+interface SduiGridCardAction {
+    label: string;
+    icon?: string;
+    variant?: 'default' | 'destructive' | 'outline';
+    run: SduiAction | SduiAction[];
 }
-/**
- * `weight`·`textAlign`은 **이 요소에만** 붙는다. 자손에게 내려보내는 코드는 없다 —
- * 그 일은 CSS 상속이 이미 하고 있고, JS로 다시 하면 `Show`/`Can` 같은 fragment 노드
- * 때문에 스펙 트리의 부모와 실제 DOM 부모가 어긋나 조용히 틀린 값이 내려간다(layout.ts 주석).
- */
-declare function Text({ preset, as: Tag, weight, textAlign, 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 SduiGridCard {
+    titleKey: string;
+    subtitleKey?: string;
+    badge?: {
+        key: string;
+        toneMap?: Record<string, BadgeTone>;
+    };
+    /** 한 열로 쌓는 행 */
+    rows?: SduiGridCardRow[];
+    /** 두 열 배치 — 좌/우 각각의 행 목록. rows와 함께 쓰면 두 열이 위, rows가 아래다 */
+    leftRows?: SduiGridCardRow[];
+    rightRows?: SduiGridCardRow[];
+    /** 카드 맨 아래 보조 문구로 쓸 필드 */
+    noteKey?: string;
+    actions?: SduiGridCardAction[];
 }
-interface KeyValueListProps {
-    /** 값의 원천 객체 — 보통 상태 바인딩({ "$state": "selectedOrder" })을 넣는다 */
-    source?: Record<string, unknown> | null;
-    items: KeyValueItem[];
-    className?: string;
-    style?: React__default.CSSProperties;
+interface SduiSearchAction {
+    label: string;
+    icon?: string;
+    variant?: 'default' | 'destructive' | 'outline';
+    /** 실행할 선언적 액션 — 이벤트 값으로 선택된 행 id 배열이 전달된다 */
+    run: SduiAction | SduiAction[];
 }
-/** 키-값 요약 목록 (.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;
+/** 두 어댑터가 공유하는 선언적 프롭 */
+interface SduiSearchCommonProps {
+    title: string;
+    columns: SduiSearchColumn[];
+    fields?: SearchField[];
+    leftFilters?: SearchFilter[];
+    rightFilters?: SearchFilter[];
+    gridCard?: SduiGridCard;
+    actions?: SduiSearchAction[];
+    initialView?: 'grid' | 'list';
+    /**
+     * 노출할 보기 목록(라벨·아이콘·순서). 생략하면 목록/카드 두 칸이 기본이다.
+     * gridCard 없이 카드 보기를 넣으면 빈 카드가 나오므로 여기서 걸러낸다.
+     */
+    views?: SearchViewItem[];
+    /** 페이지당 건수 선택지. 생략 시 [10, 20, 50, 100] */
+    pageSizes?: number[];
+    disableGrid?: boolean;
+    disableList?: boolean;
+    searchPlaceholder?: string;
+    /** 행 클릭 시 실행할 액션 — 이벤트 값으로 행 객체 전체가 전달된다 */
+    rowClick?: SduiAction | SduiAction[];
+    /** 렌더러의 slots.headerActions가 이 프롭으로 들어온다 */
+    headerActions?: React__default.ReactNode;
+    /** 가상 스크롤 — true면 기본 임계값 150행, 숫자면 그 값이 임계값 (JSON 직렬화 가능) */
+    virtual?: boolean | number;
 }
-declare function PageHead({ title, subtitle, actions }: PageHeadProps): React__default.JSX.Element;
-interface ShowProps {
-    /** 보통 상태 참조({ "$state": ... })를 바인딩한다. truthy면 children을 렌더링. */
-    when?: unknown;
-    children?: React__default.ReactNode;
+interface SduiSearchResultsProps extends SduiSearchCommonProps {
+    data: SearchRow[];
 }
-/** 조건부 렌더링 — Dialog 등을 상태로 열고 닫을 때 사용. */
-declare function Show({ when, children }: ShowProps): React__default.JSX.Element | null;
-/** 가로 구분선 */
-declare function Divider({ style }: {
-    style?: React__default.CSSProperties;
-}): React__default.JSX.Element;
-
-/** SduiRenderer가 제공하는 액션 디스패처. 레지스트리의 복합 컴포넌트가 선언적 액션을 실행할 때 쓴다. */
-type SduiDispatch = (action: SduiAction, eventValue?: unknown) => void;
-declare function useSduiDispatch(): SduiDispatch;
+interface RemoteSearchResultsProps extends SduiSearchCommonProps {
+    /**
+     * 목록 endpoint — page/limit/search/필드키 쿼리를 붙여 조회하고
+     * `{ data: Row[]; total: number }`를 기대한다. 조회 자체는 어댑터(SearchFetcher)가 한다.
+     */
+    endpoint: string;
+    /** 페이지당 행 수 (기본 10) — limit 파라미터의 초기값 */
+    pageSize?: number;
+}
+/** 바깥에서 온 `style`·`className`을 뿌리에 얹어 내보낸다. 까닭은 {@link ../boxed.tsx}에 있다. */
+declare const SduiSearchResults: React__default.FC<SduiSearchResultsProps & SduiBoxProps>;
+/** 바깥에서 온 `style`·`className`을 뿌리에 얹어 내보낸다. 까닭은 {@link ../boxed.tsx}에 있다. */
+declare const RemoteSearchResults: React__default.FC<RemoteSearchResultsProps & SduiBoxProps>;
 
 /**
- * 목록 원격 조회 어댑터.
- *
- * core는 특정 HTTP 클라이언트에 묶이지 않는다 — ERP는 SWR(useErpQuery)로 조회했지만
- * 라이브러리는 "endpoint + 파라미터 → { data, total }" 한 줄짜리 계약만 요구하고,
- * 호스트가 자기 클라이언트(TanStack Query, SWR, 사내 fetch 래퍼…)를 끼워 넣는다.
- *
- * 조회 함수를 고르는 순서는 셋이다:
+ * 목록 표 — SearchResults 전용. 내장 `Table`은 정렬 헤더·선택 표시·가상 스크롤을
+ * 다루지 않으므로, 같은 wp-table 마크업/클래스를 유지한 채 그 세 가지를 더한 변형이다.
  *
- *  1. `SduiSearchDataProvider`로 **명시 주입**한 fetcher — 가장 세다. 조회를 통째로 소유하는
- *     소비자(ERP RemoteSearchResults 등)의 뜻을 다른 무엇도 덮지 않는다.
- *  2. 렌더러 어댑터의 `fetch` — 호스트가 자기 인증·에러 처리를 꽂아 둔 자리다. 여기를 거치면
- *     소비 앱은 세션 규약을 그대로 태우고, 편집기 캔버스처럼 어댑터로 바깥을 막아 둔
- *     자리에서는 목록 조회도 **함께 막힌다**. 예전에는 이 경로만 잠금 밖이라, 캔버스가
- *     뜨는 것만으로 저장하지도 않은 스펙이 운영 API를 세션 쿠키와 함께 때렸다.
- *  3. 둘 다 없으면 브라우저 fetch(어댑터를 안 준 SduiRenderer와 같은 정책) — 감싸지 않은
- *     드롭인 소비자의 동작을 바꾸지 않기 위한 폴백이다.
+ * 가상 스크롤은 **의존성 없이** 직접 구현한다(core는 무거운 외부 의존성을 갖지 않는다).
+ * ERP는 @tanstack/react-virtual을 썼지만, 여기서 필요한 건 "고정 행 높이 목록의 창"뿐이라
+ * scrollTop → 인덱스 범위 계산으로 충분하다. 렌더 범위 밖은 상/하단 스페이서 행으로 대체한다
+ * (<table> 마크업에서 transform 대신 안전하게 동작하는 방식).
  */
 
-interface SearchRow {
-    id: string;
-    [key: string]: unknown;
+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;
 }
-interface SearchPage {
-    data: SearchRow[];
-    total: number;
+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;
+
 /**
- * 목록 한 페이지를 가져온다. 실패하면 Error(사용자에게 보여줄 메시지)를 던진다.
- * signal은 파라미터가 바뀌거나 언마운트될 때 중단 신호로 넘어온다.
+ * 권한 게이트 — 통과하면 children, 실패하면 fallback 슬롯(없으면 아무 것도)을 렌더한다.
+ * 판정 자체는 하지 않는다. 호스트가 주입한 콜백(permission.tsx)에 질의만 위임한다.
+ *
+ * 스펙 예 (ERP 85개 페이지 중 56개가 쓰는 형태 그대로):
+ *   { "component": "Can",
+ *     "props": { "entity": "asset", "action": "create" },
+ *     "children": [ { "component": "Button", ... } ] }
  */
-type SearchFetcher = (endpoint: string, params: URLSearchParams, signal: AbortSignal) => Promise<SearchPage>;
-declare function SduiSearchDataProvider({ fetcher, children, }: {
-    fetcher: SearchFetcher;
+
+interface CanProps {
+    /** 대상 엔티티 식별자 */
+    entity: string;
+    /** 수행 동작 — 생략 시 'read'(ERP Can과 같은 기본값) */
+    action?: string;
+    /** 최소 적용 범위 — 생략 시 호스트 판정기의 기본값을 따른다 */
+    scope?: string;
+    /** 차단 시 대신 보여줄 내용 (JSON에서는 slots.fallback) */
+    fallback?: React__default.ReactNode;
     children?: React__default.ReactNode;
-}): React__default.JSX.Element;
-declare function useSearchFetcher(): SearchFetcher;
-interface RemotePageState {
-    page: SearchPage;
-    isLoading: boolean;
-    error: Error | null;
-    reload: () => void;
 }
+declare function Can({ entity, action, scope, fallback, children }: CanProps): React__default.JSX.Element;
+
 /**
- * endpoint+params 조회 훅. 라이브러리 안에 캐시를 두지 않는다(호스트 클라이언트의 몫) —
- * 대신 직전 페이지를 유지해(keepPreviousData 상당) 페이지 이동 중 목록이 깜빡이지 않게 한다.
- *
- * 중단 신호는 fetcher에 넘기지만 호스트가 무시할 수도 있다(어댑터 계약상 선택 사항) —
- * 그래서 늦게 도착한 응답은 아래 `alive` 검사로 한 번 더 버린다.
+ * 내장 기본 컴포넌트 세트 — WIPCO 디자인 시스템(wp-* 토큰)을 따르는
+ * 독립 구현. ERP 디자인 시스템과 같은 프롭 규약을 쓰므로 스펙이 호환된다.
+ * 스타일은 styles.css 한 파일이 담당한다.
  */
-declare function useRemoteSearchPage(endpoint: string, params: URLSearchParams): RemotePageState;
 
+interface IconProps extends React__default.SVGAttributes<SVGSVGElement> {
+    /** kebab-case Lucide 이름 — "scan-line", "layers", "circle-alert". */
+    name: string;
+    /** 픽셀 박스. 기본 18. */
+    size?: number;
+    /** 기본 1.5. 32px 위에서만 2를 쓴다. */
+    strokeWidth?: number;
+    /** 주면 role="img" + aria-label. 장식 아이콘은 생략한다. */
+    title?: string;
+}
 /**
- * 검색 툴바 — ERP `app/components/search/SearchToolbar.tsx`의 계약(타입·헬퍼·동작)을
- * 그대로 옮긴 것. 스펙 호환이 목적이므로 값 규칙(쉼표 다중값, 느슨한 검색, 범위 키 이름)은
- * 한 글자도 바꾸지 않았다.
+ * 스트로크 아이콘. 130종을 24px 그리드 위에 그린다.
  *
- * - 검색 버튼은 두지 않는다(Enter로 검색) — 시안 규칙 유지
- * - 상세검색은 아이콘 버튼 → 드롭다운 패널(초기화/적용)
- * - 적용된 조건은 칩(Tag)으로 나열되고, 다중 선택 칩은 값 하나씩 제거된다
+ * **등록되지 않은 이름은 `null`이다** — 예전엔 점(●)으로 대체했는데, 그러면 스펙 오타나
+ * 아직 안 넣은 이름이 "없던 자국"으로 화면에 남는다. 빠진 아이콘은 비어 보이는 편이
+ * 낫고, 어차피 잘못된 이름은 check-meta가 팔레트 쪽에서 잡는다.
  */
-
-interface SearchOption {
-    label: string;
-    value: string;
+declare function Icon({ name, size, strokeWidth, className, style, title, ...rest }: IconProps): React__default.JSX.Element | null;
+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;
+    /**
+     * 라벨을 감추고 스피너를 돌린다.
+     *
+     * 스피너는 **CSS가 그린다**(`.wp-btn--loading::after`) — 엘리먼트를 따로 넣지 않는다.
+     * 예전엔 `<span class="wp-spinner">`를 렌더했는데, 같은 클래스에 ::after 규칙을 가진
+     * 디자인 시스템 스타일시트와 겹치면 원이 두 개 돈다. 그릴 주체를 CSS 한쪽으로 모은다.
+     */
+    loading?: boolean;
+    block?: boolean;
+    disabled?: boolean;
+    /**
+     * 다른 태그로 렌더한다. 링크로 보내야 하는 자리(SSO 이동 등)는 `as="a"` + `href`다 —
+     * `<button>`에 href를 달면 아무 데도 가지 않는다.
+     *
+     * button이 아닐 때는 `disabled` 속성이 없으므로 비활성은 `aria-disabled`로만 알린다
+     * (그래서 button일 때도 둘 다 붙인다 — 표기가 태그에 따라 달라지지 않게).
+     */
+    as?: 'button' | 'a' | 'span';
+    /**
+     * 버튼 **안쪽** 내용(아이콘·글자)의 가로 정렬. 기본은 가운데다.
+     *
+     * `block`으로 폭을 늘리거나 `width`를 준 버튼에서만 뜻이 있다 — 그전에는 버튼이
+     * 내용만큼만 넓어 정렬할 여백이 없다. 실측: 스펙 85개가 `style.justifyContent:
+     * 'flex-start'`로 4번 손으로 쓰고 있었고, 전부 폭을 늘린 버튼이었다.
+     */
+    justify?: 'start' | 'center' | 'end' | 'between';
+    children?: React__default.ReactNode;
 }
-interface CascadingSearchOption extends SearchOption {
-    children?: CascadingSearchOption[];
+declare function Button({ variant, size, icon, iconEnd, loading, block, disabled, as, justify, children, className, style, ...rest }: ButtonProps): React__default.JSX.Element;
+interface IconButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
+    icon: string;
+    /** 접근성 라벨(필수 권장) — title이자 aria-label이 된다. */
+    label?: string;
+    /** xs 24 · sm 28 · md 32(기본) · lg 40 px 정사각 */
+    size?: 'xs' | 'sm' | 'md' | 'lg';
+    /**
+     * 예전 이름. `variant`를 주지 않았을 때만 쓰인다 — `variant` 주석 참고.
+     * @deprecated `variant`로 옮겨라. `tone="danger"`는 `variant="danger"`와 같다.
+     */
+    tone?: 'default' | 'danger';
+    /**
+     * 디자인 시스템 어휘. ghost = 투명(기본) · outlined = 하드라인 테두리 ·
+     * solid = 채움 · danger = 빨강 · onchrome = 네이비 사이드바/탑바 위.
+     *
+     * 같은 자리를 가리키는 프롭이 `tone`과 둘로 갈라져 있는데 **variant가 이긴다** —
+     * 스펙과 디자인 시스템 문서가 쓰는 이름이 이쪽이고, 값 어휘도 넓다(outlined는 tone에 없다).
+     * variant를 주지 않으면 tone이 그대로 먹으므로 tone만 쓰던 코드는 그대로 돈다.
+     */
+    variant?: 'ghost' | 'outlined' | 'solid' | 'danger' | 'onchrome';
+    /** 토글 상태 — aria-pressed로 나가고 선택 틴트를 입는다. */
+    pressed?: boolean;
+    disabled?: boolean;
 }
-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;
-} | {
+declare function IconButton({ icon, label, size, tone, variant, pressed, disabled, 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;
     /**
-     * 계층 다중 선택 — 단계별 체크박스 목록 체인. 선택된 값들을 쉼표로 합쳐 저장하며,
-     * 부모를 선택하면 그 자손 선택은 제거되고 자손을 선택하면 그 조상 선택이 제거된다.
+     * 입력 오른쪽 끝에 겹쳐 그리는 후행 표시.
+     *
+     * **문자열은 아이콘 이름으로 읽는다** — `trailing="eye"`(비밀번호 보기)가 원래 용례다.
+     * 등록되지 않은 이름이면 Icon이 null을 내므로 자리만 남는다. 단위 글자("원", "mm")를
+     * 넣고 싶으면 문자열이 아니라 노드로 줘라: `trailing={<span>원</span>}`.
      */
-    type: 'cascading';
-    key: string;
+    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;
-    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;
+    disabled?: 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를 그대로 백엔드 질의로 옮기면 된다
+ * 자유 형식 옵션 — `valueKey`/`labelKey`가 가리키는 키로 읽는다.
  *
- * ERP와 다른 점은 하나뿐이다: 검색/필터/페이지 파라미터를 URL에 직접 쓰지 않고
- * `searchParams` + `onParamsChange`로만 다룬다(controlled). core는 라우터를 알지 않으며,
- * 한 페이지에 목록이 여러 개 있어도 서로의 URL을 오염시키지 않는다.
+ * `AutocompleteOption`과 같은 모양(`Record<string, unknown>`)으로 맞췄다. 두 어휘가
+ * 같은 자리에서 같은 프롭 이름을 쓰는데 옵션 타입만 다르면 스펙 작성자가 둘 사이를
+ * 옮길 때마다 다시 배워야 한다.
  */
-
-/** DS Badge 톤 */
-type BadgeTone = 'neutral' | 'info' | 'success' | 'warning' | 'danger' | 'brand';
-interface SearchAction<T> {
-    label: string;
-    onClick: (selectedItems: T[]) => void | Promise<void>;
+type SelectOptionRecord = Record<string, unknown>;
+interface SelectProps extends Omit<React__default.SelectHTMLAttributes<HTMLSelectElement>, 'size'> {
+    /**
+     * 옵션 목록. 기본은 `{value, label}`이고, 도메인 객체(`{id, title, …}`)를 그대로
+     * 넘길 거면 `valueKey`/`labelKey`로 읽을 키를 알려 준다.
+     */
+    options: (SelectOption | SelectOptionRecord)[];
+    /** 옵션에서 값을 읽을 키. 기본 'value'. */
+    valueKey?: string;
+    /** 옵션에서 표시 라벨을 읽을 키. 기본 'label'. */
+    labelKey?: string;
+    size?: 'sm' | 'md' | 'lg';
+    invalid?: boolean;
+    /** 비어 있는 첫 옵션 */
+    placeholder?: string;
+}
+declare function Select({ options, valueKey, labelKey, 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;
+    /**
+     * 부분 선택 — 전체선택 체크박스의 "일부만 골랐다" 상태.
+     *
+     * HTML 속성이 아니라 DOM 프로퍼티라 ref로 직접 넣어야 한다(마크업에 남지 않는다).
+     * 글리프도 체크가 아니라 빼기로 바뀐다.
+     */
+    indeterminate?: boolean;
+    disabled?: boolean;
+}
+declare function Checkbox({ label, description, indeterminate, 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;
+    /** 인라인 액션 하나 — 되돌리기 같은 것. Button variant="link"를 넣는다. */
+    action?: React__default.ReactNode;
+    onClose?: () => void;
+}
+/** 우하단 일시 알림. .wp-toast-region 안에 렌더링된다. */
+declare function Toast({ tone, title, children, action, onClose, className, ...rest }: ToastProps): React__default.JSX.Element;
+interface TabItem {
+    value: string;
+    label: React__default.ReactNode;
     icon?: string;
-    variant?: 'default' | 'destructive' | 'outline';
+    count?: number;
 }
-interface SearchColumn<T> {
+interface TabsProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    items: TabItem[];
+    value: string;
+    onChange?: (value: string) => void;
+    size?: 'md' | 'lg';
+    /** 네이비 탑바 위 — 밝은 글자, 빨간 인디케이터. */
+    onChrome?: boolean;
+}
+declare function Tabs({ items, value, onChange, size, onChrome, className, ...rest }: TabsProps): React__default.JSX.Element;
+interface TableColumn {
     key: string;
-    title: string;
-    sortable?: boolean;
-    /** DS Table은 left/right만 지원한다 */
-    textAlign?: 'left' | 'right';
-    /** 상대 폭 — 전체 ratio 합 대비 % 폭으로 환산된다 */
-    ratio?: number;
+    header: React__default.ReactNode;
+    /** CSS 폭 — "180px", "22%" */
+    width?: string;
+    align?: 'left' | 'right';
     mono?: boolean;
     strong?: boolean;
-    accessor?: (item: T) => string | number | Date | null | undefined;
-    render?: (item: T) => React__default.ReactNode;
+    /** 헤더를 정렬 버튼으로 만든다. 실제 정렬은 `sort`·`onSort`가 담당한다. */
+    sortable?: 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;
+    /** 스크롤 본문용 고정 헤더 */
+    sticky?: boolean;
+    /** 현재 정렬 상태 — 해당 컬럼 헤더의 화살표 방향을 정한다 */
+    sort?: {
+        key: string;
+        dir: 'asc' | 'desc';
+    };
+    /** 정렬 헤더를 눌렀을 때. 주지 않으면 sortable 컬럼도 버튼이 되지 않는다 */
+    onSort?: (key: string) => void;
+    /** 선택된 행의 rowKey 값 — 해당 행에 aria-selected가 붙고 하이라이트된다 */
+    selectedIds?: any[];
+    /** 행 key와 선택에 쓸 필드. 기본 "id" */
+    rowKey?: string;
+    onRowClick?: (row: any) => void;
+    /** rows가 비었을 때 대신 렌더링 — EmptyState 권장 */
+    empty?: React__default.ReactNode;
+}
+declare function Table({ columns, rows, dense, hover, sticky, sort, onSort, selectedIds, 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';
+    /** 네이비/뷰어 표면 위 — 밝은 테두리로 뒤집는다. */
+    inverse?: boolean;
+    label?: string;
+}
+declare function Spinner({ size, inverse, label, className, ...rest }: SpinnerProps): React__default.JSX.Element;
+interface ProgressBarProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** 0~`max` */
+    value: number;
+    /** 기본 100. 용량 게이지처럼 분모가 100이 아닌 자리에 쓴다 */
+    max?: number;
+    /** danger 임계 강조 등 */
+    tone?: 'brand' | 'success' | 'warning' | 'danger' | 'info';
+    /** sm 4 · md 6(기본) · lg 8 px */
+    size?: 'sm' | 'md' | 'lg';
+    /** 사선 해치 애니메이션 — 진행 중인 작업에만 */
+    striped?: boolean;
+    label?: React__default.ReactNode;
+    /**
+     * 현재 값을 퍼센트로 적는다.
+     *
+     * 막대만으로는 82%와 91%를 구분할 수 없어서, 여러 개를 세로로 쌓아 비교하는
+     * 자리(공정별 진척 목록 등)에서 필요하다. 라벨이 있으면 라벨 줄 오른쪽 끝에,
+     * 라벨이 없으면 막대 오른쪽 옆(.wp-meter-row)에 붙는다.
+     */
+    showValue?: boolean;
 }
-interface SearchFilter {
-    key: string;
-    label: string;
-    options: {
-        key: string;
-        label: string;
-        value: string;
-    }[];
+declare function ProgressBar({ value, max, tone, size, striped, showValue, label, 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;
 }
-/**
- * 목록/카드 전환 버튼 한 칸.
- *
- * 예전에는 이 두 칸(`목록`/`카드`)이 코드에 박혀 있어 스펙이 라벨·아이콘·순서를
- * 바꿀 수 없었고, `disableGrid`/`disableList`로 **끄는 것만** 가능했다.
- * 이제 `views`로 목록 자체를 정할 수 있고, 두 disable 프롭은 그 축약형으로 남는다.
- */
-interface SearchViewItem {
-    value: 'grid' | 'list';
-    /** 생략 시 기본 아이콘 — list=list, grid=layout-grid */
+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;
-    /** 생략 시 기본 라벨 — list=목록, grid=카드 */
-    label?: 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;
+    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;
 }
-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;
+/** 모달 본체. 오버레이가 가장 가까운 포지셔닝 조상을 채운다 — SDUI에서는 SduiDialog 래퍼가 뷰포트에 고정한다. */
+declare function Dialog({ title, subtitle, icon, tone, size, footer, onClose, children, className, ...rest }: DialogProps): React__default.JSX.Element;
+/** 배타 뷰 전환 스위치. 항목 2~4개까지, 그보다 많으면 Select다. */
+interface SegmentedItem {
+    value: string;
+    label?: string;
+    /** 앞에 붙일 아이콘 이름 */
+    icon?: string;
 }
-interface SearchResultsProps<T> {
-    item: {
-        data: T[];
-        total: number;
-    };
-    columns: SearchColumn<T>[];
-    gridConfig?: GridCardConfig<T>;
-    leftFilters?: SearchFilter[];
-    rightFilters?: SearchFilter[];
-    initialView?: 'grid' | 'list';
-    /**
-     * 노출할 보기 목록. 생략하면 목록/카드 두 칸이 기본값이고,
-     * 그때만 `disableGrid`/`disableList`가 목록을 깎는다(둘 다 오면 views가 이긴다).
-     * 한 칸만 남으면 전환 버튼 자체를 그리지 않는다.
-     */
-    views?: SearchViewItem[];
-    /** 페이지당 건수 선택지. 생략 시 [10, 20, 50, 100]. 첫 값이 기본 페이지 크기다. */
-    pageSizes?: number[];
+interface SegmentedControlProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    items: SegmentedItem[];
+    value: string;
+    onChange?: (value: string) => void;
+    /** md(24px 항목, 기본) · lg(30px) */
+    size?: 'md' | 'lg';
     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;
 }
 /**
- * 스펙이 준 페이지 크기 목록을 다듬는다 — 양의 정수만, 중복 제거, 오름차순.
- * 쓸 값이 하나도 없으면 undefined를 돌려 기본 선택지를 쓰게 한다.
- */
-declare function normalizePageSizes(sizes: number[] | undefined): number[] | undefined;
-declare function SearchResults<T extends {
-    id: string;
-}>({ item, columns, gridConfig, leftFilters, rightFilters, initialView, views, pageSizes, className, searchParams, onParamsChange, actions, disableGrid, disableList, onRowClick, title, headerActions, isLoading, hideHeader, advancedSearchFields, searchPlaceholder, virtual, }: SearchResultsProps<T>): React__default.JSX.Element;
-
-/**
- * 셀 표현 어휘 — 목록 컬럼의 셀과 카드 행의 값이 **같은 규칙**을 쓴다.
- *
- * 예전에는 스펙이 고를 수 있는 표현이 `badge` 하나뿐이었고 나머지는 `row[key]` 원문
- * 출력이었다. 밑에 깔린 `SearchColumn.render`는 임의의 노드를 그릴 수 있는데 스펙에는
- * 그 역량이 두 종류(원문/배지)로만 열려 있었다는 뜻이다. 여기서 그 구멍을 메운다.
+ * 목록/카드, 2D/3D, 일/주/월처럼 하나만 고르는 뷰 전환.
  *
- * 규약 두 가지:
- * - **모르는 type은 원문으로 강등한다.** 스펙은 신뢰할 수 없는 입력이고, 컬럼 하나 때문에
- *   목록 전체가 비면 안 된다. 판별 유니언이라 새 type을 더해도 옛 스펙은 그대로 돈다.
- * - **값을 해석하지 못하면 원문을 그대로 낸다.** ERP는 이미 서식된 문자열(`"12,400,000"`,
- *   `"2026-07-31 09:00"`)을 내려주는 자리가 많아, 파싱 실패를 빈칸으로 만들면 퇴행이다.
+ * `search/SearchResults.tsx`가 "라이브러리에 SegmentedControl이 없다"는 이유로
+ * 안에 `ViewToggle` 사본을 들고 있었다. 이 컴포넌트가 그 사본의 원본이다.
  */
-
-/** ProgressBar가 받는 톤 */
-type MeterTone = 'brand' | 'success' | 'warning' | 'danger' | 'info';
-/** 값을 그대로 출력한다. cell을 생략한 것과 같으며, 명시하고 싶을 때 쓴다. */
-interface SduiTextCell {
-    type: 'text';
-}
-/** 값을 배지로. 톤은 값별 매핑(없는 값은 neutral). */
-interface SduiBadgeCell {
-    type: 'badge';
-    toneMap?: Record<string, BadgeTone>;
-}
-/** 값을 태그로. 선행 점 색은 값별 매핑(CSS 색상 문자열). */
-interface SduiTagCell {
-    type: 'tag';
-    colorMap?: Record<string, string>;
-    filled?: boolean;
+declare function SegmentedControl({ items, value, onChange, size, className, ...rest }: SegmentedControlProps): React__default.JSX.Element;
+/** 사람·팀·자산의 신원 표식. */
+interface AvatarProps extends React__default.HTMLAttributes<HTMLSpanElement> {
+    /** 이니셜과 title에 쓰인다 */
+    name?: string;
+    /** 이미지 URL — 있으면 이니셜을 대신한다 */
+    src?: string;
+    /** hex(기본, 심볼 실루엣) · round(사람) · square(자산) */
+    shape?: 'hex' | 'round' | 'square';
+    /** xs 20 · sm 24 · md 28(기본) · lg 36 · xl 48 px */
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /** brand 네이비(기본) · muted 회색 · accent 레드 */
+    tone?: 'brand' | 'muted' | 'accent';
+    className?: string;
 }
-/**
- * 값을 링크로. `to`는 `/assets/{id}` 처럼 행의 필드를 `{키}`로 끼워 넣는 경로 템플릿이고,
- * 클릭하면 navigate 액션이 나간다(렌더러가 대상 안전성을 다시 검사한다).
- */
-interface SduiLinkCell {
-    type: 'link';
-    to: string;
-    /** 링크 문구로 쓸 필드 — 생략하면 컬럼 자신의 값 */
-    labelKey?: string;
+/** 사람/자산 표식. 기본은 육각형 — 심볼의 실루엣이다. */
+declare function Avatar({ name, src, shape, size, tone, className, ...rest }: AvatarProps): React__default.JSX.Element;
+/** 프로젝트에서 개별 객체까지의 위치. 4단계를 넘으면 가운데를 접는다. */
+interface BreadcrumbItem {
+    label: React__default.ReactNode;
+    href?: string;
     icon?: string;
+    onClick?: () => void;
 }
-/** 값을 진행 막대로. 분모는 maxKey(행의 필드) → max → 100 순으로 정한다. */
-interface SduiProgressCell {
-    type: 'progress';
-    max?: number;
-    maxKey?: string;
-    tone?: MeterTone;
-    showValue?: boolean;
+interface BreadcrumbProps extends React__default.HTMLAttributes<HTMLElement> {
+    items: BreadcrumbItem[];
+    className?: string;
 }
-/** 값을 아이콘으로. iconMap에 없는 값은 icon(공통 기본)으로, 그것도 없으면 원문으로. */
-interface SduiIconCell {
-    type: 'icon';
-    iconMap?: Record<string, string>;
-    icon?: string;
-    /** 아이콘 뒤에 값도 적는다 */
-    withLabel?: boolean;
+/** 계보 표시. 마지막 항목은 현재 객체이므로 링크가 아니다. */
+declare function Breadcrumb({ items, className, ...rest }: BreadcrumbProps): React__default.JSX.Element;
+/** 후보가 전부 보이는 배타 선택. 5개 이상이면 Select다. */
+interface RadioProps extends React__default.InputHTMLAttributes<HTMLInputElement> {
+    label?: React__default.ReactNode;
+    description?: React__default.ReactNode;
+    disabled?: boolean;
 }
-/**
- * 숫자 서식(ko-KR 천단위) + 접두/접미. 통화는 `{ type:'number', suffix:'원' }`이다 —
- * `currency` 타입을 따로 두지 않은 이유는 ERP가 원화 단일이고, 그 자리에 필요한 것이
- * 통화 기호가 아니라 "단위 문자열"이기 때문이다(원·건·개·%·kg).
- */
-interface SduiNumberCell {
-    type: 'number';
-    /** 소수 자릿수 (기본 0) */
-    digits?: number;
-    prefix?: string;
-    suffix?: string;
+/** 2~4개 후보를 다 보여 주는 라디오. Checkbox와 마크업을 공유한다(.wp-check). */
+declare function Radio({ label, description, disabled, className, ...rest }: RadioProps): React__default.JSX.Element;
+/** 주 내비게이션 목록. 활성 항목에 빨간 에지 마커가 붙는다. */
+interface SidebarNavItem {
+    value: string;
+    label: React__default.ReactNode;
+    icon?: string;
+    meta?: React__default.ReactNode;
+    href?: string;
 }
-/** 날짜 서식(ko-KR). 파싱되지 않는 값은 원문 그대로. */
-interface SduiDateCell {
-    type: 'date';
-    format?: 'date' | 'datetime' | 'time';
+interface SidebarNavSection {
+    label?: React__default.ReactNode;
+    items: SidebarNavItem[];
 }
-type SduiCell = SduiTextCell | SduiBadgeCell | SduiTagCell | SduiLinkCell | SduiProgressCell | SduiIconCell | SduiNumberCell | SduiDateCell;
-/**
- * 셀 스펙 → 렌더 함수. `undefined`를 돌려주면 호출자가 원문을 그대로 출력한다
- * (표에서는 `<td>{row[key]}</td>`, 카드에서는 값 문자열).
- */
-declare function cellRenderer(cell: SduiCell | undefined, key: string, dispatch: SduiDispatch): ((row: SearchRow) => React__default.ReactNode) | undefined;
-
-/**
- * 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]를 그대로 출력한다 — 어휘는 `cells.tsx` 참고 */
-    cell?: SduiCell;
+interface SidebarNavProps extends Omit<React__default.HTMLAttributes<HTMLElement>, 'onSelect'> {
+    sections: SidebarNavSection[];
+    value?: string;
+    onSelect?: (value: string) => void;
+    /** 아이콘만 남기는 56px 레일 */
+    collapsed?: boolean;
+    /** 흰 표면(설정 하위 내비) 위에 쓰는 밝은 변형 */
+    light?: boolean;
+    className?: string;
 }
-/**
- * 카드 행 표시 조건.
- * `key`만 주면 "그 값이 비어 있지 않을 때"다. 값이 없는 행을 감춰 카드 높이가
- * 들쭉날쭉해지지 않게 하는 것이 주 용도라 그것이 기본 의미다.
- */
-interface SduiRowCondition {
-    key: string;
-    equals?: string | number | boolean;
-    in?: Array<string | number>;
-    notEmpty?: boolean;
+/** 네이비 사이드바의 주 내비게이션. 섹션 + 항목. */
+declare function SidebarNav({ sections, value, onSelect, collapsed, light, className, ...rest }: SidebarNavProps): React__default.JSX.Element;
+/** 아이콘 전용 컨트롤·잘린 값에 붙이는 hover/focus 힌트. */
+interface TooltipProps extends React__default.HTMLAttributes<HTMLSpanElement> {
+    label: React__default.ReactNode;
+    /** 단축키 칩, 예: "⌘K" */
+    shortcut?: string;
+    placement?: 'top' | 'bottom' | 'left' | 'right';
+    /** 여러 줄 허용(최대 240px) */
+    wrap?: boolean;
+    children?: React__default.ReactNode;
+    className?: string;
 }
-interface SduiGridCardRow {
-    label?: string;
-    valueKey: string;
-    /** 라벨 앞 아이콘 */
-    icon?: string;
-    /** 값 표현 — 컬럼 셀과 같은 어휘 */
-    cell?: SduiCell;
-    /** 조건부 행 */
-    showWhen?: SduiRowCondition;
+/** hover 힌트. 트리거를 감싸며 위치는 CSS가 잡는다 — 포털을 쓰지 않는다. */
+declare function Tooltip({ label, shortcut, placement, wrap, children, className, ...rest }: TooltipProps): React__default.JSX.Element;
+
+interface GridProps extends SduiContainerLayoutProps {
+    /** wp-grid--N 프리셋 (1~6) */
+    columns?: SduiColumnsScale;
+    /** 커스텀 트랙 — grid-template-columns 값. columns보다 우선 */
+    template?: string;
+    /**
+     * 안쪽 여백(`padding`). `Card`가 이미 갖고 있던 것을 여기에도 연다 —
+     * 실측: 스펙이 `style.padding`으로 두 번 손으로 쓰고 있었고, 둘 다 그리드 자체의
+     * 안쪽 여백이었다. `gap`은 자식 **사이**라 이 자리를 대신하지 못한다.
+     */
+    padding?: SduiGapScale;
+    className?: string;
+    style?: React__default.CSSProperties;
+    children?: React__default.ReactNode;
 }
-/** 카드 우상단 버튼 — 이벤트 값으로 행 객체 전체가 전달된다 */
-interface SduiGridCardAction {
-    label: string;
-    icon?: string;
-    variant?: 'default' | 'destructive' | 'outline';
-    run: SduiAction | SduiAction[];
+declare function Grid({ columns, template, gap, align, justify, wrap, padding, className, style, children, }: GridProps): React__default.JSX.Element;
+type Justify = 'start' | 'center' | 'end' | 'between';
+interface RowProps extends SduiContainerLayoutProps {
+    /** 가로 정렬 (기본 start) */
+    justify?: Justify;
+    className?: string;
+    style?: React__default.CSSProperties;
+    children?: React__default.ReactNode;
 }
-interface SduiGridCard {
-    titleKey: string;
-    subtitleKey?: string;
-    badge?: {
-        key: string;
-        toneMap?: Record<string, BadgeTone>;
-    };
-    /** 한 열로 쌓는 행 */
-    rows?: SduiGridCardRow[];
-    /** 두 열 배치 — 좌/우 각각의 행 목록. rows와 함께 쓰면 두 열이 위, rows가 아래다 */
-    leftRows?: SduiGridCardRow[];
-    rightRows?: SduiGridCardRow[];
-    /** 카드 맨 아래 보조 문구로 쓸 필드 */
-    noteKey?: string;
-    actions?: SduiGridCardAction[];
+declare function Row({ justify, gap, align, wrap, className, style, children }: RowProps): React__default.JSX.Element;
+interface ActionsProps extends SduiContainerLayoutProps {
+    /** 가로 정렬 — 기본 end(우측) */
+    justify?: Justify;
+    className?: string;
+    style?: React__default.CSSProperties;
+    children?: React__default.ReactNode;
 }
-interface SduiSearchAction {
-    label: string;
-    icon?: string;
-    variant?: 'default' | 'destructive' | 'outline';
-    /** 실행할 선언적 액션 — 이벤트 값으로 선택된 행 id 배열이 전달된다 */
-    run: SduiAction | SduiAction[];
+/**
+ * 액션 버튼 묶음 — 슬롯 안에서 정렬을 제어한다(flex:1로 슬롯 폭 차지).
+ *
+ * `justify = 'end'`가 **2단(타입별 기본)의 실제 사례**다. 전역 기본은 `.wp-row`의
+ * `flex-start`인데 이 타입만 `end`로 시작하고, 스펙이 `justify`를 주면 그것이 이긴다.
+ */
+declare function Actions({ justify, gap, align, wrap, className, style, children }: ActionsProps): React__default.JSX.Element;
+interface ColProps extends SduiContainerLayoutProps {
+    className?: string;
+    style?: React__default.CSSProperties;
+    children?: React__default.ReactNode;
 }
-/** 두 어댑터가 공유하는 선언적 프롭 */
-interface SduiSearchCommonProps {
-    title: string;
-    columns: SduiSearchColumn[];
-    fields?: SearchField[];
-    leftFilters?: SearchFilter[];
-    rightFilters?: SearchFilter[];
-    gridCard?: SduiGridCard;
-    actions?: SduiSearchAction[];
-    initialView?: 'grid' | 'list';
+declare function Col({ gap, align, justify, wrap, className, style, children }: ColProps): React__default.JSX.Element;
+interface SpacerProps {
     /**
-     * 노출할 보기 목록(라벨·아이콘·순서). 생략하면 목록/카드 두 칸이 기본이다.
-     * gridCard 없이 카드 보기를 넣으면 빈 카드가 나오므로 여기서 걸러낸다.
+     * 간격 토큰 단계(`--wp-space-N`). 주면 "남는 공간 밀어내기"가 아니라
+     * 그만큼의 **고정 간격**이 된다 — Card 본문처럼 gap이 이미 걸린 세로 묶음 안에서
+     * 한 덩어리를 다음 덩어리와 더 떼어 놓을 때 쓴다.
+     * 토큰에 없는 단계를 주면 무시하고 기존 flex 채움으로 돌아간다.
      */
-    views?: SearchViewItem[];
-    /** 페이지당 건수 선택지. 생략 시 [10, 20, 50, 100] */
-    pageSizes?: number[];
-    disableGrid?: boolean;
-    disableList?: boolean;
-    searchPlaceholder?: string;
-    /** 행 클릭 시 실행할 액션 — 이벤트 값으로 행 객체 전체가 전달된다 */
-    rowClick?: SduiAction | SduiAction[];
-    /** 렌더러의 slots.headerActions가 이 프롭으로 들어온다 */
-    headerActions?: React__default.ReactNode;
-    /** 가상 스크롤 — true면 기본 임계값 150행, 숫자면 그 값이 임계값 (JSON 직렬화 가능) */
-    virtual?: boolean | number;
+    size?: 1 | 2 | 3 | 4 | 5 | 6 | 8;
 }
-interface SduiSearchResultsProps extends SduiSearchCommonProps {
-    data: SearchRow[];
+declare function Spacer({ size, className, style }: SpacerProps & SduiBoxProps): React__default.JSX.Element;
+interface SectionProps extends SduiContainerLayoutProps {
+    title?: React__default.ReactNode;
+    className?: string;
+    style?: React__default.CSSProperties;
+    children?: React__default.ReactNode;
 }
-declare function SduiSearchResults({ title, data, columns, fields, leftFilters, rightFilters, gridCard, actions, initialView, views, pageSizes, disableGrid, disableList, searchPlaceholder, rowClick, headerActions, virtual, }: SduiSearchResultsProps): React__default.JSX.Element;
-interface RemoteSearchResultsProps extends SduiSearchCommonProps {
+declare function Section({ title, gap, align, justify, wrap, 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';
     /**
-     * 목록 endpoint — page/limit/search/필드키 쿼리를 붙여 조회하고
-     * `{ data: Row[]; total: number }`를 기대한다. 조회 자체는 어댑터(SearchFetcher)가 한다.
+     * 글자 굵기 — `preset`이 정한 굵기를 이 자리에서만 뒤집는다.
+     * 프리셋 19종이 크기·굵기·정렬을 묶어 놔 "본문 크기인데 굵게"를 만들 수 없던 것을 푼다.
      */
-    endpoint: string;
-    /** 페이지당 행 수 (기본 10) — limit 파라미터의 초기값 */
-    pageSize?: number;
+    weight?: SduiWeightScale;
+    /** 글자 정렬. */
+    textAlign?: SduiTextAlignScale;
+    /**
+     * 줄바꿈 규칙.
+     *
+     * - `normal`(기본) — 브라우저 기본. 원문의 줄바꿈은 공백 하나로 접힌다.
+     * - `preserve` — 원문의 줄바꿈·연속 공백을 그대로 둔다(`white-space: pre-wrap`).
+     *   서버가 준 사유·비고처럼 사람이 줄을 나눠 쓴 글에 쓴다.
+     * - `anywhere` — `preserve`에 더해 **긴 토큰을 글자 단위로 끊는다**(`word-break: break-all`).
+     *   공백 없는 ID·URL·해시가 묶음 밖으로 삐져나가는 것을 막는다.
+     *
+     * 실측: 스펙 85개가 `style`로 `pre-wrap` 2번, `break-all` 2번을 손으로 쓰고 있었고
+     * 넷이 같은 두 자리(감사 로그·JSON 미리보기)였다.
+     */
+    wrap?: 'normal' | 'preserve' | 'anywhere';
+    className?: string;
+    style?: React__default.CSSProperties;
+    /** children 대신 쓸 수 있는 내용 — 상태 바인딩({ "$state": ... })에 유용 */
+    value?: React__default.ReactNode;
+    children?: React__default.ReactNode;
 }
-declare function RemoteSearchResults({ title, endpoint, columns, fields, leftFilters, rightFilters, gridCard, actions, initialView, views, pageSizes, disableGrid, disableList, searchPlaceholder, rowClick, headerActions, virtual, pageSize, }: RemoteSearchResultsProps): React__default.JSX.Element;
-
 /**
- * 목록 표 — SearchResults 전용. 내장 `Table`은 정렬 헤더·선택 표시·가상 스크롤을
- * 다루지 않으므로, 같은 wp-table 마크업/클래스를 유지한 채 그 세 가지를 더한 변형이다.
- *
- * 가상 스크롤은 **의존성 없이** 직접 구현한다(core는 무거운 외부 의존성을 갖지 않는다).
- * ERP는 @tanstack/react-virtual을 썼지만, 여기서 필요한 건 "고정 행 높이 목록의 창"뿐이라
- * scrollTop → 인덱스 범위 계산으로 충분하다. 렌더 범위 밖은 상/하단 스페이서 행으로 대체한다
- * (<table> 마크업에서 transform 대신 안전하게 동작하는 방식).
+ * `weight`·`textAlign`은 **이 요소에만** 붙는다. 자손에게 내려보내는 코드는 없다 —
+ * 그 일은 CSS 상속이 이미 하고 있고, JS로 다시 하면 `Show`/`Can` 같은 fragment 노드
+ * 때문에 스펙 트리의 부모와 실제 DOM 부모가 어긋나 조용히 틀린 값이 내려간다(layout.ts 주석).
  */
-
-interface ResultTableColumn<T> {
-    key: string;
-    header: React__default.ReactNode;
-    sortable?: boolean;
-    /** right → 우측 정렬 + tabular numerals (wp-table__num) */
-    align?: 'left' | 'right';
-    /** 고정폭 글꼴 셀 (wp-table__mono) */
+declare function Text({ preset, as: Tag, weight, textAlign, wrap, 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;
-    /** 강조 셀 (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;
+interface KeyValueListProps {
+    /** 값의 원천 객체 — 보통 상태 바인딩({ "$state": "selectedOrder" })을 넣는다 */
+    source?: Record<string, unknown> | null;
+    items: KeyValueItem[];
+    className?: string;
+    style?: React__default.CSSProperties;
 }
-declare function ResultTable<T extends {
-    id: string;
-}>({ columns, rows, sort, onSort, onRowClick, selectedIds, empty, virtual, height, rowHeight, }: ResultTableProps<T>): React__default.JSX.Element;
+/** 키-값 요약 목록 (.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, className, style }: PageHeadProps & SduiBoxProps): 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, className }: SduiBoxProps): React__default.JSX.Element;
 
 /**
  * Dialog + 표준 닫기 UX(Escape·배경 클릭). 레지스트리의 "Dialog"는 이 래퍼다.
@@ -1398,8 +1434,8 @@ declare const defaultRegistry: {
     Button: typeof Button;
     Card: typeof Card;
     Checkbox: typeof Checkbox;
-    DatePicker: typeof DatePicker;
-    DateRangePicker: typeof DateRangePicker;
+    DatePicker: React.FC<DatePickerProps & SduiBoxProps>;
+    DateRangePicker: React.FC<DateRangePickerProps & SduiBoxProps>;
     Dialog: typeof SduiDialog;
     EmptyState: typeof EmptyState;
     Field: typeof Field;
@@ -1432,8 +1468,8 @@ declare const defaultRegistry: {
     Can: typeof Can;
     SortableList: typeof SortableList;
     SortHandle: typeof SortHandle;
-    SearchResults: typeof SduiSearchResults;
-    RemoteSearchResults: typeof RemoteSearchResults;
+    SearchResults: React.FC<SduiSearchResultsProps & SduiBoxProps>;
+    RemoteSearchResults: React.FC<RemoteSearchResultsProps & SduiBoxProps>;
 };
 /**
  * 기본 어휘에 앱 고유 컴포넌트를 더한 레지스트리를 만든다.
@@ -1552,6 +1588,50 @@ interface SduiRuntime {
 }
 declare function useSduiRuntime(): SduiRuntime;
 
+/**
+ * `boxed()` — 어떤 컴포넌트든 바깥에서 온 `style`·`className`을 자기 뿌리에 얹게 만든다.
+ *
+ * ## 왜 필요한가 (실측)
+ *
+ * 렌더러는 자식 축(`grow`·`selfAlign`·`width`·`marginTop` …)을 **모든 컴포넌트에서**
+ * 가로채 `props.style`·`props.className`으로 접는다({@link ./layout.ts}). 그런데 받는 쪽이
+ * 그 둘을 자기 뿌리 DOM에 얹지 않으면 값은 그대로 버려진다.
+ *
+ * ERP 카탈로그 78종을 프리셋 그대로 그려 본 결과 **38종이 그랬다.** 편집기 속성 패널은
+ * 프롭을 정상적으로 보여 주므로, 쓰는 사람에게는 "설정은 했는데 화면이 안 변하는" 모양이 된다.
+ * 절반이 그 상태였다.
+ *
+ * ## 왜 파일마다 뿌리를 고치지 않았나
+ *
+ * 위젯 21종의 뿌리는 제각각이고 **조기 반환이 흔하다** — `Timeline`은 항목이 없을 때 다른
+ * 뿌리를 내고, `Disclosure`·`SecureScreen`은 상태에 따라 갈린다. 손으로 고치면 그중 하나를
+ * 빠뜨렸을 때 "어떤 상태에서만 안 먹는" 형태로 남고, 그건 지금 상태보다 찾기 어렵다.
+ * 여기서 한 번 감싸면 **반환된 것이 무엇이든** 같은 규칙으로 얹힌다.
+ *
+ * ## 규칙
+ *
+ * - 바깥에서 온 값이 **이긴다**(`style`은 뒤에 펼치고, `className`은 뒤에 붙는다).
+ *   자식 축은 "이 자리에서만 예외로 이렇게" 하려는 지정이므로 컴포넌트 기본값을 눌러야 한다.
+ * - 뿌리가 `null`이면 아무것도 하지 않는다(조건부로 아무것도 안 그리는 컴포넌트).
+ * - 뿌리가 Fragment면 **첫 엘리먼트 자식**에 얹는다. 부모의 배치 흐름에 실제로 놓이는 것이
+ *   그것이기 때문이다 — `ImageLightbox`·`SearchableMultiPicker`가 `<>{트리거}{오버레이}</>`
+ *   모양이고, 오버레이는 `position: fixed`라 폭·여백을 줘도 뜻이 없다.
+ * - 그마저 없으면(전부 텍스트거나 비었으면) 조용히 지나간다 — 감싸기 **전과 같은** 결과다.
+ *   `Show`·`Can`·`ForEach`가 그런 컴포넌트이고, 그쪽은 애초에 감싸지 않는다.
+ *
+ * ## 안쪽 컴포넌트를 함수로 직접 부르는 것에 대하여
+ *
+ * 뿌리 엘리먼트에 손을 대려면 그것을 **손에 쥐어야** 한다. `<Inner …/>`로 엘리먼트를 만들면
+ * 타입이 `Inner`인 엘리먼트가 나올 뿐이라 복제해 봐야 지금과 똑같이 무시된다. 그래서
+ * `Inner(props)`로 부른다.
+ *
+ * 이 호출이 안전한 조건은 **평범한 함수 컴포넌트**라는 것이다. 훅은 조건 없이 한 번만 부르므로
+ * 순서가 어긋나지 않고, 상태는 `Wrapped`에 붙어 그대로 동작한다. `memo`·`forwardRef`·클래스는
+ * 이렇게 부를 수 없으므로 그때는 **감싸지 않고 그대로 돌려준다** — 잘못 감싸느니 예전 동작이 낫다.
+ */
+
+declare function boxed<P extends object>(Inner: React__default.ComponentType<P>, displayName?: string): React__default.FC<P & SduiBoxProps>;
+
 interface Props {
     name: string;
     children: React__default.ReactNode;
@@ -1571,4 +1651,4 @@ declare class NodeErrorBoundary extends React__default.Component<Props, State> {
     render(): string | number | bigint | boolean | 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> | React__default.JSX.Element | null | undefined;
 }
 
-export { Actions, type ActionsProps, Alert, type AlertProps, Avatar, type AvatarProps, Badge, type BadgeProps, type BadgeTone, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonProps, Can, type CanProps, Card, type CardProps, type CascadingSearchOption, Checkbox, type CheckboxProps, Col, type ColProps, 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, type MeterTone, NodeErrorBoundary, PageHead, type PageHeadProps, Pagination, type PaginationProps, ProgressBar, type ProgressBarProps, Radio, type RadioProps, RemoteSearchResults, type RemoteSearchResultsProps, ResultTable, type ResultTableColumn, type ResultTableProps, Row, type RowProps, SduiAction, type SduiAdapter, type SduiAssetContext, type SduiAssetResolver, type SduiBadgeCell, type SduiCanFn, type SduiCanQuery, type SduiCanSetting, type SduiCell, SduiColumnsScale, SduiContainerLayoutProps, type SduiDateCell, SduiDialog, type SduiDispatch, SduiForm, type SduiFormConfig, type SduiFormProps, type SduiGridCard, type SduiGridCardAction, type SduiGridCardRow, type SduiIconCell, type SduiLinkCell, type SduiNumberCell, SduiPage, SduiPermissionProvider, type SduiProgressCell, SduiPropValue, type SduiRegistry, SduiRenderer, type SduiRendererProps, type SduiRowCondition, SduiRule, type SduiRuntime, type SduiSearchAction, type SduiSearchColumn, SduiSearchDataProvider, SduiSearchResults, type SduiSearchResultsProps, type SduiTagCell, SduiTextAlignScale, type SduiTextCell, SduiWeightScale, type SearchAction, type SearchColumn, type SearchFetcher, type SearchField, type SearchFilter, type SearchOption, type SearchPage, SearchResults, type SearchResultsProps, type SearchRow, SearchToolbar, type SearchValues, type SearchViewItem, Section, type SectionProps, SegmentedControl, type SegmentedControlProps, type SegmentedItem, Select, type SelectOption, type SelectProps, Show, type ShowProps, SidebarNav, type SidebarNavItem, type SidebarNavProps, type SidebarNavSection, type SortDir, SortHandle, type SortHandleProps, SortableList, type SortableListProps, 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, Tooltip, type TooltipProps, cascadingValuePaths, cellRenderer, cleanSearchValues, createRegistry, defaultAdapter, defaultRegistry, includesLooseSearch, joinMultiValue, normalizePageSizes, normalizeSearchText, searchFieldKeys, searchValuesFromParams, sortableDropIndex, sortableMove, splitMultiValue, useRemoteSearchPage, useSduiAssetResolver, useSduiCan, useSduiDispatch, useSduiRuntime, useSduiSandbox, useSearchFetcher, validateSpec };
+export { Actions, type ActionsProps, Alert, type AlertProps, Avatar, type AvatarProps, Badge, type BadgeProps, type BadgeTone, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonProps, Can, type CanProps, Card, type CardProps, type CascadingSearchOption, Checkbox, type CheckboxProps, Col, type ColProps, type CustomActionHandler, type CustomValidator, DatePickerProps, DateRangePickerProps, 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, type MeterTone, NodeErrorBoundary, PageHead, type PageHeadProps, Pagination, type PaginationProps, ProgressBar, type ProgressBarProps, Radio, type RadioProps, RemoteSearchResults, type RemoteSearchResultsProps, ResultTable, type ResultTableColumn, type ResultTableProps, Row, type RowProps, SduiAction, type SduiAdapter, type SduiAssetContext, type SduiAssetResolver, type SduiBadgeCell, SduiBoxProps, type SduiCanFn, type SduiCanQuery, type SduiCanSetting, type SduiCell, SduiColumnsScale, SduiContainerLayoutProps, type SduiDateCell, SduiDialog, type SduiDispatch, SduiForm, type SduiFormConfig, type SduiFormProps, SduiGapScale, type SduiGridCard, type SduiGridCardAction, type SduiGridCardRow, type SduiIconCell, type SduiLinkCell, type SduiNumberCell, SduiPage, SduiPermissionProvider, type SduiProgressCell, SduiPropValue, type SduiRegistry, SduiRenderer, type SduiRendererProps, type SduiRowCondition, SduiRule, type SduiRuntime, type SduiSearchAction, type SduiSearchColumn, SduiSearchDataProvider, SduiSearchResults, type SduiSearchResultsProps, type SduiTagCell, SduiTextAlignScale, type SduiTextCell, SduiWeightScale, type SearchAction, type SearchColumn, type SearchFetcher, type SearchField, type SearchFilter, type SearchOption, type SearchPage, SearchResults, type SearchResultsProps, type SearchRow, SearchToolbar, type SearchValues, type SearchViewItem, Section, type SectionProps, SegmentedControl, type SegmentedControlProps, type SegmentedItem, Select, type SelectOption, type SelectOptionRecord, type SelectProps, Show, type ShowProps, SidebarNav, type SidebarNavItem, type SidebarNavProps, type SidebarNavSection, type SortDir, SortHandle, type SortHandleProps, SortableList, type SortableListProps, 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, Tooltip, type TooltipProps, boxed, cascadingValuePaths, cellRenderer, cleanSearchValues, createRegistry, defaultAdapter, defaultRegistry, includesLooseSearch, joinMultiValue, normalizePageSizes, normalizeSearchText, searchFieldKeys, searchValuesFromParams, sortableDropIndex, sortableMove, splitMultiValue, useRemoteSearchPage, useSduiAssetResolver, useSduiCan, useSduiDispatch, useSduiRuntime, useSduiSandbox, useSearchFetcher, validateSpec };