@wipco/sdui 1.5.0 → 1.6.1

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import * as React from 'react';
 import React__default, { CSSProperties, ReactNode, ComponentType } from 'react';
-import { S as SduiPage, a as SduiAction, b as SduiPropValue, c as SduiRule } from './types-COjGKgmd.js';
-export { d as SduiArgRef, e as SduiCalcRef, f as SduiChild, g as SduiIndexRef, h as SduiItemRef, i as SduiNode, j as SduiPageQuery, k as SduiScalar, l as SduiStateRef } from './types-COjGKgmd.js';
-import { S as SduiBoxProps, a as SduiContainerLayoutProps, b as SduiColumnsScale, c as SduiGapScale, d as SduiWeightScale, e as SduiTextAlignScale } from './layout-C3nRXMwb.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-C3nRXMwb.js';
-import { D as DatePickerProps, a as DateRangePickerProps, T as TimePickerProps } from './DatePicker-C_TT_SOw.js';
-export { b as DatePicker, c as DateRangePicker, d as DateRangeValue, e as TimePicker } from './DatePicker-C_TT_SOw.js';
+import { S as SduiPage, a as SduiAction, b as SduiPropValue, c as SduiRule } from './types-CMikpoN5.js';
+export { d as SduiArgRef, e as SduiCalcRef, f as SduiChild, g as SduiIndexRef, h as SduiItemRef, i as SduiNode, j as SduiPageQuery, k as SduiScalar, l as SduiStateRef } from './types-CMikpoN5.js';
+import { S as SduiBoxProps, a as SduiContainerLayoutProps, b as SduiColumnsScale, c as SduiGapScale, d as SduiWeightScale, e as SduiTextAlignScale } from './layout-DmRikwZb.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-DmRikwZb.js';
+import { D as DatePickerProps, a as DateRangePickerProps, T as TimePickerProps } from './DatePicker-DX9juElE.js';
+export { b as DatePicker, c as DateRangePicker, d as DateRangeValue, e as TimePicker } from './DatePicker-DX9juElE.js';
 
 /**
  * 호스트 앱 연결점 — ERP에서는 라우터·erpFetch·SSE가 하던 일을
@@ -96,6 +96,24 @@ interface SduiAdapter {
      * 어긋나지 않게 한다. 기본: window.history.replaceState.
      */
     replaceQuery?: (params: URLSearchParams) => void;
+    /**
+     * 이탈 가드 통지 — 페이지의 `leaveGuard` 식이나 작성 중인 `Form.guard` 폼이 있어
+     * "떠나면 잃는다"가 참이 될 때 문구를, 풀리면 `null` 을 준다(값이 바뀔 때만, 언마운트에
+     * `null`). 렌더러는 beforeunload 는 스스로 걸지만 **앱 안 이동은 호스트 라우터만 막을 수
+     * 있다** — 셸 메뉴·브레드크럼·브라우저 뒤로 가기는 렌더러를 거치지 않는다.
+     *
+     * 이 콜백을 주면 렌더러는 자기 `navigate` 액션도 묻지 않고 그대로 보낸다(두 번 묻지
+     * 않게) — 호스트가 라우터 차단(react-router `useBlocker` 등)으로 한 곳에서 묻는다.
+     * 안 주면 렌더러가 `navigate` 액션 앞에서만 확인 창을 띄운다.
+     */
+    setLeaveGuard?: (message: string | null) => void;
+    /**
+     * 페이지 제목 통지 — `page.titleFrom` 이 있는 화면에서, 풀린 제목(비어 있으면
+     * `page.title`)이 바뀔 때마다, 언마운트에 `null`. 문서 <title>·브레드크럼 마지막 단계를
+     * 레코드 이름으로 바꾸는 자리다. `titleFrom` 이 없는 화면은 부르지 않는다 — 기존 화면의
+     * 제목 경로(스펙 JSON 의 `title`)는 그대로다.
+     */
+    setTitle?: (title: string | null) => void;
     /**
      * 스펙이 준 **자산 URL**을 브라우저가 자동으로 받아 오기 직전에 가로채는 자리.
      *
@@ -197,6 +215,54 @@ declare function useSduiSandbox(): boolean;
 type SduiDispatch = (action: SduiAction, eventValue?: unknown) => void;
 declare function useSduiDispatch(): SduiDispatch;
 
+/**
+ * 어휘 전체. **렌더러와 편집기 검증기가 같은 이 집합을 본다** — 목록이 두 벌이면
+ * 한쪽에만 연산을 더했을 때 "렌더는 되는데 저장이 거부되는" 스펙이 생긴다.
+ */
+declare const CALC_OPS: ReadonlySet<string>;
+/** 일시 서식 — `date` YYYY-MM-DD · `datetime` YYYY-MM-DD HH:mm · `time` HH:mm */
+type SduiDateFormat = 'date' | 'datetime' | 'time';
+/**
+ * 시간대가 붙은 **완전한** ISO 8601 일시 문자열인가.
+ *
+ * 형식을 지정하지 않은 값을 자동으로 서식할지 가르는 판정이라 일부러 좁다 — 날짜만 있는 값,
+ * 시간대 없는 일시, 숫자, 그 밖의 글자는 전부 아니다(그것들은 원문 그대로 둔다).
+ * 시간대가 붙은 일시는 사람이 쓴 글이 아니라 서버가 찍은 타임스탬프라, 원문을 보여 줄 까닭이 없다.
+ */
+declare function isZonedIsoDateTime(value: unknown): value is string;
+/**
+ * 일시 → 한국 시각 글자. 빈 값(null·undefined·'')은 `''`.
+ *
+ * - 시간대가 붙은 일시는 KST 로 옮긴다.
+ * - 날짜만 있는 값은 어느 서식이든 YYYY-MM-DD 다 — 모르는 시각을 "00:00" 으로 지어내지 않는다.
+ * - 날짜로 읽을 수 없는 문자열은 **원문 그대로**(서버가 이미 서식한 "2026-07-31 ~ 08-02" 같은 값).
+ */
+declare function formatDateValue(value: unknown, format?: SduiDateFormat): string;
+/**
+ * 값 → 숫자. 숫자, 또는 숫자로 읽히는 문자열("12400", "12,400", "-3.5")만 받는다. 아니면 null.
+ * 위의 `toNumber` 와 다르다 — 저쪽은 산술용이라 못 읽으면 0 이고, 이쪽은 "숫자가 아니면
+ * 원문을 지킨다"를 가르는 판정이다.
+ */
+declare function parseNumeric(value: unknown): number | null;
+/**
+ * 숫자 → ko-KR 천 단위 글자. 빈 값은 `''`, 숫자가 아닌 값은 원문 그대로.
+ *
+ * `digits` 를 주면 소수 자리를 그만큼 **고정**한다(0~6, 표의 number 셀과 같은 범위).
+ * 주지 않으면 값이 가진 소수를 그대로 둔다.
+ */
+declare function formatNumberValue(value: unknown, digits?: unknown): string;
+/** 표시 서식 — KeyValueList 항목·Table 열의 `format`. */
+type SduiDisplayFormat = SduiDateFormat | 'number' | 'currency';
+/**
+ * 표시할 값에 서식을 입힌다 — KeyValueList·Table 이 공유한다.
+ *
+ * - `format` 을 주면 그 서식이다. `currency` 는 원 단위(`11,200원`)이고, 숫자가 아니면 원문이다.
+ * - 주지 않으면 **시간대가 붙은 완전한 ISO 일시만** KST `YYYY-MM-DD HH:mm` 으로 바꾼다.
+ *   날짜만 있는 값·숫자·그 밖의 글자는 그대로 — 스펙이 뜻을 말하지 않은 값을 추측하지 않는다.
+ * - 문자열·숫자가 아닌 값(노드·배열·객체)은 건드리지 않는다.
+ */
+declare function formatDisplayValue(value: unknown, format?: unknown): unknown;
+
 /**
  * 내장 기본 컴포넌트 세트 — WIPCO 디자인 시스템(wp-* 토큰)을 따르는
  * 독립 구현. ERP 디자인 시스템과 같은 프롭 규약을 쓰므로 스펙이 호환된다.
@@ -337,7 +403,7 @@ interface SelectProps extends Omit<React__default.SelectHTMLAttributes<HTMLSelec
     /** 비어 있는 첫 옵션 */
     placeholder?: string;
 }
-declare function Select({ options, valueKey, labelKey, size, invalid, placeholder, className, ...rest }: SelectProps): React__default.JSX.Element;
+declare function Select({ options, valueKey, labelKey, size, invalid, placeholder, className, style, ...rest }: SelectProps): React__default.JSX.Element;
 interface CheckboxProps extends React__default.InputHTMLAttributes<HTMLInputElement> {
     label?: React__default.ReactNode;
     description?: React__default.ReactNode;
@@ -350,13 +416,13 @@ interface CheckboxProps extends React__default.InputHTMLAttributes<HTMLInputElem
     indeterminate?: boolean;
     disabled?: boolean;
 }
-declare function Checkbox({ label, description, indeterminate, disabled, className, ...rest }: CheckboxProps): React__default.JSX.Element;
+declare function Checkbox({ label, description, indeterminate, disabled, className, style, ...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;
+declare function Switch({ label, size, disabled, className, style, ...rest }: SwitchProps): React__default.JSX.Element;
 interface FieldProps extends React__default.HTMLAttributes<HTMLDivElement> {
     label?: React__default.ReactNode;
     /** 에러가 없을 때 보여줄 안내 한 줄 */
@@ -395,9 +461,14 @@ interface BadgeProps extends React__default.HTMLAttributes<HTMLSpanElement> {
     /** 선행 5px 점 — 라이브/진행 상태 */
     dot?: boolean;
     size?: 'md' | 'lg';
+    /**
+     * 긴 문구를 칸 폭 안에서 여러 줄로 감싼다(`wp-badge--wrap`, 1.6.1). 기본은 한 줄 고정 높이다.
+     * 예전에는 스펙이 style 로 height:auto·white-space:normal 등을 박아 흉내 냈다.
+     */
+    wrap?: boolean;
     children?: React__default.ReactNode;
 }
-declare function Badge({ tone, dot, size, children, className, ...rest }: BadgeProps): React__default.JSX.Element;
+declare function Badge({ tone, dot, size, wrap, children, className, ...rest }: BadgeProps): React__default.JSX.Element;
 interface TagProps extends React__default.HTMLAttributes<HTMLSpanElement> {
     /** 선행 점의 CSS 색상 */
     color?: string;
@@ -464,6 +535,12 @@ interface TableColumn {
         toneMap?: Record<string, string>;
         labelMap?: Record<string, string>;
     };
+    /**
+     * 셀 값의 표시 서식 — KeyValueList 항목의 `format` 과 같다
+     * (`date`·`datetime`·`time` 은 한국 시각, `number` 천 단위, `currency` 천 단위 + 원).
+     * 주지 않아도 시간대가 붙은 완전한 ISO 일시는 KST `YYYY-MM-DD HH:mm` 으로 바뀐다.
+     */
+    format?: SduiDisplayFormat;
     /** 프로그래매틱 사용 전용 — JSON 스펙에서는 쓸 수 없다 */
     render?: (row: any, index: number) => React__default.ReactNode;
 }
@@ -487,10 +564,23 @@ interface TableProps extends React__default.TableHTMLAttributes<HTMLTableElement
     /** 행 key와 선택에 쓸 필드. 기본 "id" */
     rowKey?: string;
     onRowClick?: (row: any) => void;
-    /** rows가 비었을 때 대신 렌더링 — EmptyState 권장 */
+    /** rows가 비었을 때 대신 렌더링 — EmptyState 권장. 없으면 머리글 아래 `emptyText` 한 줄이 선다. */
     empty?: React__default.ReactNode;
+    /**
+     * `empty` 슬롯 없이 비었을 때 표 안에 놓는 안내 한 줄(기본 "표시할 항목이 없습니다").
+     * 예전에는 머리글만 남아 "비어 있는지, 아직 안 온 건지" 알 수 없었다(카테고리 상세의 하위 카테고리 표).
+     */
+    emptyText?: string;
+    /**
+     * 좁은 화면(≤767.98px)에서 행을 카드로 쌓아도 되는 표인가 — `wp-table--stackable` + `td[data-label]`
+     * (목록 표 ResultTable 과 같은 계약). 기본은 **sticky 가 아니면 켜짐** — 고정 머리글 표는 ResultTable 의
+     * 가상 표처럼 쌓지 않는다(행 카드는 머리글을 숨기므로 "고정 머리글"과 어긋난다; 엑셀 미리보기처럼 열이 많은
+     * 표는 옆으로 미는 쪽이 읽힌다). 쌓는 모양은 소비자 CSS 가 모바일 미디어 쿼리 안에서만 그리므로 데스크톱은
+     * 그대로다. 열이 많은 집계표를 옆으로 미는 표로 두려면 false, 고정 머리글 표를 그래도 쌓으려면 true.
+     */
+    stackable?: boolean;
 }
-declare function Table({ columns, rows, dense, hover, sticky, sort, onSort, selectedIds, rowKey, onRowClick, empty, className, ...rest }: TableProps): React__default.JSX.Element;
+declare function Table({ columns, rows, dense, hover, sticky, sort, onSort, selectedIds, rowKey, onRowClick, empty, emptyText, stackable: stackableProp, className, style, ...rest }: TableProps): React__default.JSX.Element;
 interface StatCardProps extends React__default.HTMLAttributes<HTMLDivElement> {
     label: React__default.ReactNode;
     value: React__default.ReactNode;
@@ -518,7 +608,7 @@ interface SpinnerProps extends React__default.HTMLAttributes<HTMLSpanElement> {
     inverse?: boolean;
     label?: string;
 }
-declare function Spinner({ size, inverse, label, className, ...rest }: SpinnerProps): React__default.JSX.Element;
+declare function Spinner({ size, inverse, label, className, style, ...rest }: SpinnerProps): React__default.JSX.Element;
 interface ProgressBarProps extends React__default.HTMLAttributes<HTMLDivElement> {
     /** 0~`max` */
     value: number;
@@ -661,6 +751,172 @@ interface TooltipProps extends React__default.HTMLAttributes<HTMLSpanElement> {
 /** hover 힌트. 트리거를 감싸며 위치는 CSS가 잡는다 — 포털을 쓰지 않는다. */
 declare function Tooltip({ label, shortcut, placement, wrap, children, className, ...rest }: TooltipProps): React__default.JSX.Element;
 
+/**
+ * 목록 표 — SearchResults 전용. 내장 `Table`은 정렬 헤더·선택 표시·가상 스크롤을
+ * 다루지 않으므로, 같은 wp-table 마크업/클래스를 유지한 채 그 세 가지를 더한 변형이다.
+ *
+ * 가상 스크롤은 **의존성 없이** 직접 구현한다(core는 무거운 외부 의존성을 갖지 않는다).
+ * ERP는 @tanstack/react-virtual을 썼지만, 여기서 필요한 건 "고정 행 높이 목록의 창"뿐이라
+ * scrollTop → 인덱스 범위 계산으로 충분하다. 렌더 범위 밖은 상/하단 스페이서 행으로 대체한다
+ * (<table> 마크업에서 transform 대신 안전하게 동작하는 방식).
+ */
+
+interface ResultTableColumn<T> {
+    key: string;
+    header: React__default.ReactNode;
+    sortable?: boolean;
+    /** right → 우측 정렬 + tabular numerals (wp-table__num) */
+    align?: 'left' | 'right';
+    /** 고정폭 글꼴 셀 (wp-table__mono) */
+    mono?: boolean;
+    /** 강조 셀 (wp-table__strong) */
+    strong?: boolean;
+    /** CSS width — "180px", "22%" */
+    width?: string;
+    /**
+     * 칸 이름(문자열) — 각 `<td data-label>` 로 나간다. 좁은 화면에서 표를 행 카드로 쌓을 때
+     * 칸마다 "무슨 값인지"를 CSS(`attr(data-label)`)가 붙인다. 생략하면 `header` 가 문자열일
+     * 때 그것을 쓰고, 아니면 빈 값(선택 칸처럼 라벨이 없는 칸)이다.
+     */
+    label?: string;
+    /**
+     * 모바일 행 카드에서의 역할 — `data-mobile` 속성으로 나간다(모양은 소비자 CSS).
+     * `title`: 카드 머리(라벨 없이 굵게), `hide`: 모바일 카드에서 숨김.
+     */
+    mobile?: 'title' | 'hide';
+    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;
+    /** 체크박스로 고른 행 — `aria-selected="true"`(선택 바탕)만 붙는다. SearchResults 의 일괄 선택이 여기로 온다. */
+    selectedIds?: string[];
+    /**
+     * 표시 전용 강조 행(1.6.1) — `aria-current="true"` + `wp-row--selected` 클래스. 체크박스 선택과 별개다:
+     * 옆 창에 열어 둔 행처럼 "지금 보고 있는 것"을 가리킬 뿐, 일괄 액션의 대상이 되지 않는다.
+     * 그래서 체크 선택의 `aria-selected` 를 빌리지 않는다 — 같은 속성이면 스크린리더가 둘을 "선택됨"으로
+     * 똑같이 읽는다. 바탕·막대는 클래스가 칠한다(aria-selected 규칙에 기대지 않는다).
+     * SearchResults 의 `selectedIds` 가 이리로 온다. id 비교는 문자열로 한다(행 id 가 숫자인 JSON 도 맞게).
+     */
+    pickedIds?: readonly string[];
+    /** rows가 비었을 때 표 대신 렌더 */
+    empty?: React__default.ReactNode;
+    /** true면 스크롤 창 안에서 보이는 행만 렌더한다 */
+    virtual?: boolean;
+    /** 가상 스크롤 컨테이너 높이(px). 기본 560 */
+    height?: number;
+    /** 가상 스크롤 행 높이(px) 초기 추정치. 첫 렌더 후 실측값으로 대체된다 — 기본 41(wp-table 기본 행) */
+    rowHeight?: number;
+    /**
+     * 좁은 화면에서 행을 카드로 쌓아도 되는 표인가 — `wp-table--stackable` 클래스(기본 true).
+     * 쌓는 모양은 소비자 CSS 가 모바일 미디어 쿼리 안에서만 그린다(데스크톱은 그대로다).
+     * 가상 모드는 "모든 행의 높이가 같다"는 가정 위에 서 있어 쌓지 않는다.
+     */
+    stackable?: boolean;
+}
+declare function ResultTable<T extends {
+    id: string;
+}>({ columns, rows, sort, onSort, onRowClick, selectedIds, pickedIds, empty, virtual, height, rowHeight, stackable, }: ResultTableProps<T>): React__default.JSX.Element;
+interface ResultEmptyStateProps {
+    /** 목록 이름 — 기본 문구에 들어간다("대여 이력이 없습니다") */
+    title: string;
+    /** 검색어·상세검색·필터 칩 중 하나라도 걸려 있는가 — 문구와 초기화 버튼이 갈린다 */
+    filtered?: boolean;
+    /** 조건 없이 비었을 때의 제목 — 생략 시 "아직 {title}이/가 없습니다" */
+    emptyTitle?: string;
+    /** 조건 없이 비었을 때의 보조 문구 */
+    emptyText?: string;
+    /** 구분 탭이 골라져 있는가 — "아직"을 빼서 다른 탭에는 있을 수 있음을 남긴다 */
+    scoped?: boolean;
+    /** 조건 초기화 — 주면 filtered 일 때 버튼이 선다 */
+    onReset?: () => void;
+}
+/**
+ * 목록이 비었을 때의 표준 표현 — 목록/카드 뷰가 같은 문구를 쓴다.
+ *
+ * 예전 문구는 한 가지뿐이었다: "{title}이(가) 없습니다 — 검색 조건을 바꾸거나 초기화해 보세요."
+ * 검색한 적도 없는 빈 목록(첫 대여 이력, 0건 위임)에도 검색을 탓했고, 초기화 버튼은 없었고,
+ * 조사는 "이(가)"로 남았다. 이제 조건이 걸렸을 때만 조건을 말한다.
+ */
+declare function ResultEmptyState({ title, filtered, emptyTitle, emptyText, scoped, onReset }: ResultEmptyStateProps): React__default.JSX.Element;
+
+/**
+ * 목록 정렬 파라미터와 서버 정렬 메아리.
+ *
+ * ## 왜 정렬이 파라미터가 되었나
+ *
+ * 예전 정렬은 SearchResults 안의 useState 였고, 받은 행만 다시 늘어놓았다. 서버 페이징 목록
+ * (462건 중 10건만 받은 장비 목록, 42쪽짜리 휴지통)에서 '장비명' 머리를 두 번 누르면 전체의
+ * 마지막 이름이 아니라 **1쪽 10건의 역순**이 나왔다 — 사용자는 전체가 정렬됐다고 믿는다.
+ * 그래서 정렬도 page·search 처럼 `searchParams` 의 한 축(`sort`·`order`)이 되었다:
+ *
+ *  - 전 행이 로드된 목록은 예전처럼 로컬에서 정렬한다(파라미터만 읽는다).
+ *  - 부분 데이터(서버 페이징)는 **로컬에서 정렬하지 않는다.** 파라미터가 조회 쿼리에 실려
+ *    서버가 전체를 정렬한 1쪽을 다시 준다.
+ *  - 서버는 정렬을 적용했으면 응답에 `sort: { field, order }` 를 메아리한다. 부분 데이터
+ *    응답에 메아리가 없으면 그 목록(또는 그 열)은 서버가 정렬하지 못한다 — 정렬 표시를 끈다.
+ *
+ * 파라미터라서 주소창 동기화(ERP)·뒤로 가기·공유 링크에 정렬이 같이 실린다.
+ */
+
+declare const SORT_PARAM = "sort";
+declare const ORDER_PARAM = "order";
+interface SortState {
+    key: string;
+    dir: SortDir;
+}
+/** 서버가 적용했다고 알린 정렬 — 목록 응답의 `sort` 필드 */
+interface SortEcho {
+    field: string;
+    order: SortDir;
+}
+/** `sort`·`order` 파라미터 → 정렬 상태. `order` 가 없거나 모르는 값이면 오름차순이다. */
+declare function sortFromParams(params: URLSearchParams): SortState | null;
+/** 머리를 누를 때의 순환 — 새 열은 오름차순, 오름차순 → 내림차순 → 해제 */
+declare function nextSort(current: SortState | null, key: string): SortState | null;
+/** 목록 응답 본문에서 정렬 메아리를 꺼낸다. 모양이 다르면 null — 메아리 없음으로 본다. */
+declare function sortEchoOf(body: unknown): SortEcho | null;
+/**
+ * 서버가 정렬하지 못하는 열 — SearchResults `serverUnsortable` 에 그대로 꽂는다.
+ * `'all'` 은 목록 전체(서버가 한 번도 메아리하지 않았다).
+ */
+type ServerUnsortable = 'all' | readonly string[];
+/**
+ * endpoint 별 서버 정렬 지원 기억.
+ *
+ * 메아리는 "적용했을 때만" 오므로 누르기 전에는 지원 여부를 모른다. 부분 데이터 응답을
+ * 볼 때마다 기록해 두고, 판정은 둘로 나눈다:
+ *  - 그 endpoint 가 **한 번도** 메아리하지 않았는데 메아리가 없다 → 목록 전체 정렬 불가('all').
+ *    정렬을 아예 모르는 서버(전용 핸들러 등)에서 열마다 한 번씩 헛누르게 하지 않는다.
+ *  - 다른 열에서 메아리한 적이 있다 → 그 **열만** 불가. 파생 열(조인한 이름 등)만 화이트리스트
+ *    밖인 목록에서 정렬 전체를 잃지 않는다.
+ *
+ * 키는 endpoint 의 경로(쿼리 앞)다 — `/approvals?entity_type=borrow` 와 `…=leave` 는 같은
+ * 자원이라 지원 여부도 같다.
+ */
+interface ServerSortMemory {
+    /** 부분 데이터 응답 한 건을 기록한다. 요청한 정렬이 적용되지 않았으면 false. */
+    record(endpoint: string, requested: SortState, echo: SortEcho | null): boolean;
+    /** 지금까지의 판정 — 같은 판정이면 같은 참조를 돌려준다(메모 의존성에 안전) */
+    unsortable(endpoint: string): ServerUnsortable;
+    /** 이 열의 정렬을 서버에 청해도 되는가 */
+    allows(endpoint: string, key: string): boolean;
+}
+declare function createServerSortMemory(): ServerSortMemory;
+/** 앱 전역 기억 — 라이브러리 원격 목록과 호스트 원격 목록(ERP)이 같은 판정을 공유한다. */
+declare const serverSortMemory: ServerSortMemory;
+/** 정렬 파라미터를 뗀 사본 — 서버가 정렬하지 못하는 열을 청했을 때 되돌리는 데 쓴다 */
+declare function withoutSort(params: URLSearchParams): URLSearchParams;
+
 /**
  * 목록 원격 조회 어댑터.
  *
@@ -688,6 +944,11 @@ interface SearchRow {
 interface SearchPage {
     data: SearchRow[];
     total: number;
+    /**
+     * 서버가 적용했다고 메아리한 정렬(`sort: { field, order }`). 없으면 null/생략 —
+     * 부분 데이터에서 정렬을 청했는데 없으면 서버가 그 정렬을 못 한다는 뜻이다(sort.ts).
+     */
+    sort?: SortEcho | null;
 }
 /**
  * 목록 한 페이지를 가져온다. 실패하면 Error(사용자에게 보여줄 메시지)를 던진다.
@@ -726,6 +987,11 @@ declare function SduiSearchInvalidationProvider({ invalidator, children, }: {
 declare function useSearchFetcher(): SearchFetcher;
 interface RemotePageState {
     page: SearchPage;
+    /**
+     * `page` 가 어느 쿼리(`URLSearchParams.toString()`)의 응답인가 — 첫 응답 전에는 null.
+     * 쿼리가 바뀐 직후에는 직전 쪽을 유지하므로(깜빡임 방지) 지금 쿼리의 응답인지 가를 때 쓴다.
+     */
+    pageQuery: string | null;
     isLoading: boolean;
     error: Error | null;
     reload: () => void;
@@ -882,6 +1148,11 @@ interface SearchColumn<T> {
     ratio?: number;
     mono?: boolean;
     strong?: boolean;
+    /**
+     * 모바일 행 카드에서의 역할 — `title` 은 카드 머리(라벨 없이 굵게), `hide` 는 모바일에서 숨김.
+     * 아무 열도 `title` 이 아니면 `primaryKey` 열, 그다음 첫 `strong` 열이 머리가 된다.
+     */
+    mobile?: 'title' | 'hide';
     accessor?: (item: T) => string | number | Date | null | undefined;
     render?: (item: T) => React__default.ReactNode;
 }
@@ -991,6 +1262,46 @@ interface SearchResultsProps<T> {
      * (서버 페이징 모드에서는 현재 응답 분량만 가상화).
      */
     virtual?: boolean | number;
+    /**
+     * 부분 데이터(서버 페이징)에서 정렬 머리를 끌 열 — `'all'` 이면 전부.
+     *
+     * 정렬은 `searchParams` 의 `sort`·`order` 다. 전 행이 로드된 목록은 로컬에서 정렬하고,
+     * 부분 데이터는 **로컬에서 정렬하지 않는다**(현재 쪽만 뒤섞으면 전체가 정렬된 줄 안다) —
+     * 조회 측이 그 파라미터로 다시 가져온다. 서버가 정렬하지 못한다고 판정된 열(응답에 정렬
+     * 메아리가 없었다)은 조회 측이 여기로 넘겨 머리를 끈다(`serverSortMemory`).
+     */
+    serverUnsortable?: ServerUnsortable;
+    /**
+     * 행을 대표하는 필드(카드 제목과 같은 것) — 선택 칸의 접근성 이름("○○ 선택")과
+     * 모바일 행 카드의 머리 열을 고르는 데 쓴다. 생략하면 첫 strong 열.
+     */
+    primaryKey?: string;
+    /** 조건 없이 비었을 때의 제목 — 생략 시 "아직 {title}이/가 없습니다" */
+    emptyTitle?: string;
+    /** 조건 없이 비었을 때의 보조 문구 */
+    emptyText?: string;
+    /**
+     * 검색어·필터·상세검색을 **조회 측(서버)이 이미 적용한** 목록 — 전 행이 한 쪽에 다 들어와도
+     * 여기서 다시 거르지 않는다(정렬·쪽 나누기는 그대로 로컬).
+     *
+     * 로컬 재필터는 데모 배열처럼 아무도 거르지 않은 데이터를 위한 것인데, 원격 목록에 그대로
+     * 적용되면 서버와 조금이라도 다른 조건이 행을 먹어 치운다. 실측 셋: 접미사 키(`issuerNameContains`)가
+     * 행에 없어 0건, dateRange 의 to-경계를 문자열로 비교해 당일 행 누락, 그리고 필터 값은 코드
+     * (`maintenance_started`)인데 행에는 라벨('수리 시작')이 실려 있어 1건이 전부 걸러진 장비 이력
+     * (asset-18). endpoint 목록(RemoteSearchResults)은 이 값을 켠다.
+     */
+    serverFiltered?: boolean;
+    /**
+     * 표시 전용 강조(1.6.1) — 이 id 의 행(목록 보기)·카드(카드 보기)를 강조한다. 체크박스 선택(`actions`)과
+     * **별개**다: 일괄 액션의 대상이 되지 않고, 선택 바도 세우지 않는다. 옆 창·상세에 열어 둔 행을 목록에서
+     * 가리키는 자리다 — 스펙은 `"selectedIds": [{"$state":"rt.$picked.id"}]` 처럼 준다.
+     *
+     * 행은 `aria-current="true"` + `wp-row--selected`, 카드는 `wp-card--selected` + `is-selected` +
+     * `aria-current="true"` 다. 체크 선택의 `aria-selected` 는 쓰지 않는다 — 스크린리더가 강조와 체크 선택을
+     * 똑같이 "선택됨"으로 읽게 되고, 카드(버튼·일반 상자 역할)는 aria-selected 를 가질 수도 없다. 비교는
+     * 문자열로 하고, 바인딩이 아직 비어 `null`·`undefined` 인 원소는 버린다.
+     */
+    selectedIds?: string[];
 }
 /**
  * 스펙이 준 페이지 크기 목록을 다듬는다 — 양의 정수만, 중복 제거, 오름차순.
@@ -999,7 +1310,7 @@ interface SearchResultsProps<T> {
 declare function normalizePageSizes(sizes: number[] | undefined): number[] | undefined;
 declare function SearchResults<T extends {
     id: string;
-}>({ item, columns, gridConfig, leftFilters, rightFilters, tabs, summary, initialView, views, pageSizes, className, style, searchParams, onParamsChange, actions, disableGrid, disableList, onRowClick, title, headerActions, isLoading, hideHeader, advancedSearchFields: rawAdvancedSearchFields, searchPlaceholder, virtual, }: SearchResultsProps<T>): React__default.JSX.Element;
+}>({ item, columns, gridConfig, leftFilters, rightFilters, tabs, summary, initialView, views, pageSizes, className, style, searchParams, onParamsChange, actions, disableGrid, disableList, onRowClick, title, headerActions, isLoading, hideHeader, advancedSearchFields: rawAdvancedSearchFields, searchPlaceholder, virtual, serverUnsortable, primaryKey, emptyTitle, emptyText, serverFiltered, selectedIds, }: SearchResultsProps<T>): React__default.JSX.Element;
 
 /**
  * 셀 표현 어휘 — 목록 컬럼의 셀과 카드 행의 값이 **같은 규칙**을 쓴다.
@@ -1159,7 +1470,10 @@ interface SduiSearchSummary {
     endpoint: string;
     items: SduiSearchSummaryItem[];
 }
-/** 합계 조회에 넘길 쿼리 — 목록 쿼리에서 페이지 축(page/limit)만 뺀다. */
+/**
+ * 합계 조회에 넘길 쿼리 — 목록 쿼리에서 페이지 축(page/limit)과 정렬 축(sort/order)을 뺀다.
+ * 정렬은 합을 바꾸지 않는다 — 남겨 두면 머리를 누를 때마다 합계가 헛되이 다시 조회된다.
+ */
 declare function summaryParams(params: URLSearchParams): URLSearchParams;
 interface SearchSummaryCardsProps {
     items: SduiSearchSummaryItem[];
@@ -1179,6 +1493,11 @@ interface SduiSearchColumn {
     ratio?: number;
     mono?: boolean;
     strong?: boolean;
+    /**
+     * 모바일(≤767.98px) 행 카드에서의 역할 — `title`: 카드 머리(라벨 없이 굵게),
+     * `hide`: 모바일에서 숨김(식별자·보조 열). 생략하면 보통 칸(라벨 + 값).
+     */
+    mobile?: 'title' | 'hide';
     /** 셀 표현. 생략하면 row[key]를 그대로 출력한다 — 어휘는 `cells.tsx` 참고 */
     cell?: SduiCell;
 }
@@ -1272,10 +1591,28 @@ interface SduiSearchCommonProps {
     headerActions?: React__default.ReactNode;
     /** 가상 스크롤 — true면 기본 임계값 150행, 숫자면 그 값이 임계값 (JSON 직렬화 가능) */
     virtual?: boolean | number;
+    /** 조건 없이 비었을 때의 제목 — 생략 시 "아직 {title}이/가 없습니다" */
+    emptyTitle?: string;
+    /** 조건 없이 비었을 때의 보조 문구 */
+    emptyText?: string;
+    /**
+     * 목록의 **현재 조회 조건**(검색어·상세검색·필터 칩·구분 탭·정렬 — page/limit 제외)을 쿼리 문자열로
+     * 이 상태 키에 적어 둔다(`setState`). 스펙이 같은 조건으로 다른 화면을 여는 자리 — 인쇄 보기
+     * (`/print/asset/assets?` + 조건)처럼 "지금 보이는 목록 그대로"가 필요한 링크 — 가 읽는다.
+     * 조건이 없으면 빈 문자열. 생략하면 아무것도 적지 않는다.
+     */
+    queryStateKey?: string;
+    /**
+     * 표시 전용 강조 — 이 id 의 행·카드를 강조한다(체크박스 선택과 별개, 일괄 액션 대상 아님).
+     * 옆 창에 열어 둔 행을 가리키는 자리: `"selectedIds": [{"$state":"rt.$picked.id"}]`. 계약은 SearchResultsProps.selectedIds.
+     */
+    selectedIds?: string[];
 }
 interface SduiSearchResultsProps extends SduiSearchCommonProps {
     data: SearchRow[];
 }
+/** page·limit 을 뺀 조회 조건 — `queryStateKey` 에 적는 값. 인쇄·내보내기는 쪽과 무관하게 전체가 대상이다. */
+declare function conditionParams(params: URLSearchParams): string;
 /** JSON 컬럼 정의 → SearchResults 컬럼. 셀 해석은 cellRenderer 한 벌이다. */
 declare function mapColumns(columns: SduiSearchColumn[], dispatch: SduiDispatch): SearchColumn<SearchRow>[];
 /** 카드 행 표시 조건 판정 — 조건이 아예 없으면 항상 표시한다 */
@@ -1318,56 +1655,6 @@ declare const SduiSearchResults: React__default.FC<SduiSearchResultsProps & Sdui
 /** 바깥에서 온 `style`·`className`을 뿌리에 얹어 내보낸다. 까닭은 {@link ../boxed.tsx}에 있다. */
 declare const RemoteSearchResults: React__default.FC<RemoteSearchResultsProps & SduiBoxProps>;
 
-/**
- * 목록 표 — SearchResults 전용. 내장 `Table`은 정렬 헤더·선택 표시·가상 스크롤을
- * 다루지 않으므로, 같은 wp-table 마크업/클래스를 유지한 채 그 세 가지를 더한 변형이다.
- *
- * 가상 스크롤은 **의존성 없이** 직접 구현한다(core는 무거운 외부 의존성을 갖지 않는다).
- * ERP는 @tanstack/react-virtual을 썼지만, 여기서 필요한 건 "고정 행 높이 목록의 창"뿐이라
- * scrollTop → 인덱스 범위 계산으로 충분하다. 렌더 범위 밖은 상/하단 스페이서 행으로 대체한다
- * (<table> 마크업에서 transform 대신 안전하게 동작하는 방식).
- */
-
-interface ResultTableColumn<T> {
-    key: string;
-    header: React__default.ReactNode;
-    sortable?: boolean;
-    /** right → 우측 정렬 + tabular numerals (wp-table__num) */
-    align?: 'left' | 'right';
-    /** 고정폭 글꼴 셀 (wp-table__mono) */
-    mono?: boolean;
-    /** 강조 셀 (wp-table__strong) */
-    strong?: boolean;
-    /** CSS width — "180px", "22%" */
-    width?: string;
-    render?: (row: T, index: number) => React__default.ReactNode;
-}
-type SortDir = 'asc' | 'desc';
-interface ResultTableProps<T extends {
-    id: string;
-}> {
-    columns: ResultTableColumn<T>[];
-    rows: T[];
-    sort?: {
-        key: string;
-        dir: SortDir;
-    };
-    onSort?: (key: string) => void;
-    onRowClick?: (row: T) => void;
-    selectedIds?: string[];
-    /** rows가 비었을 때 표 대신 렌더 */
-    empty?: React__default.ReactNode;
-    /** true면 스크롤 창 안에서 보이는 행만 렌더한다 */
-    virtual?: boolean;
-    /** 가상 스크롤 컨테이너 높이(px). 기본 560 */
-    height?: number;
-    /** 가상 스크롤 행 높이(px) 초기 추정치. 첫 렌더 후 실측값으로 대체된다 — 기본 41(wp-table 기본 행) */
-    rowHeight?: number;
-}
-declare function ResultTable<T extends {
-    id: string;
-}>({ columns, rows, sort, onSort, onRowClick, selectedIds, empty, virtual, height, rowHeight, }: ResultTableProps<T>): React__default.JSX.Element;
-
 /**
  * 권한 게이트 — 통과하면 children, 실패하면 fallback 슬롯(없으면 아무 것도)을 렌더한다.
  * 판정 자체는 하지 않는다. 호스트가 주입한 콜백(permission.tsx)에 질의만 위임한다.
@@ -1394,8 +1681,22 @@ declare function Can({ entity, action, scope, fallback, children }: CanProps): R
 interface GridProps extends SduiContainerLayoutProps {
     /** wp-grid--N 프리셋 (1~6) */
     columns?: SduiColumnsScale;
-    /** 커스텀 트랙 — grid-template-columns 값. columns보다 우선 */
+    /**
+     * 커스텀 트랙 — grid-template-columns 값. columns보다 우선.
+     *
+     * 인라인 `grid-template-columns` 가 아니라 **CSS 변수**(`--wp-grid-template`)와 클래스
+     * (`wp-grid--custom`)로 낸다. 인라인 선언은 미디어 쿼리가 이길 수 없어서, 좁은 화면에서도
+     * 트랙이 그대로 남아 두 칸이 150px 로 찌그러지고 한글이 낱글자로 세로로 쌓였다(실측 390px:
+     * 일괄 대여·카테고리 관리·팀 관리). 데스크톱의 계산 결과는 예전과 같다.
+     * 모바일(≤767.98px)에서는 한 칸으로 접힌다 — 접으면 안 되는 줄은 `collapse={false}`.
+     */
     template?: string;
+    /**
+     * 모바일에서 한 칸으로 접을지(기본 true). `false` 면 좁은 화면에서도 트랙을 지킨다 —
+     * "A → B [x]" 처럼 칸 사이 관계가 곧 뜻인 줄(화살표·삭제 버튼 칸)이 그 자리다.
+     * 5·6열 프리셋의 태블릿 2열 접힘도 함께 끈다.
+     */
+    collapse?: boolean;
     /**
      * 안쪽 여백(`padding`). `Card`가 이미 갖고 있던 것을 여기에도 연다 —
      * 실측: 스펙이 `style.padding`으로 두 번 손으로 쓰고 있었고, 둘 다 그리드 자체의
@@ -1406,7 +1707,7 @@ interface GridProps extends SduiContainerLayoutProps {
     style?: React__default.CSSProperties;
     children?: React__default.ReactNode;
 }
-declare function Grid({ columns, template, gap, rowGap, columnGap, align, justify, wrap, padding, className, style, children, }: GridProps): React__default.JSX.Element;
+declare function Grid({ columns, template, collapse, gap, rowGap, columnGap, align, justify, wrap, padding, className, style, children, }: GridProps): React__default.JSX.Element;
 type Justify = 'start' | 'center' | 'end' | 'between';
 interface SduiContainerRoleProps {
     /**
@@ -1521,6 +1822,26 @@ interface KeyValueItem {
      * 배열을 그냥 노드로 흘리면 React 가 원소를 구분자 없이 이어 붙여 "ab" 처럼 보인다.
      */
     prefix?: string;
+    /**
+     * 값의 표시 서식.
+     *
+     * - `date` YYYY-MM-DD · `datetime` YYYY-MM-DD HH:mm · `time` HH:mm — 한국 시각(KST)
+     * - `number` 천 단위 쉼표 · `currency` 천 단위 + `원`
+     *
+     * 주지 않아도 **시간대가 붙은 완전한 ISO 일시**("2026-08-07T01:27:23.968677+00:00")는
+     * KST `YYYY-MM-DD HH:mm` 으로 바뀐다 — 서버 타임스탬프를 원문으로 보여 줄 까닭이 없고,
+     * UTC 원문은 한국 시각보다 9시간 이르게 읽힌다. 날짜만 있는 값·숫자·그 밖의 글자는
+     * 서식을 주지 않으면 그대로다.
+     */
+    format?: SduiDisplayFormat;
+    /**
+     * 값을 라벨 **아래 전체 폭**에 왼쪽 정렬로 둔다(원문 줄바꿈 유지).
+     *
+     * 값 칸은 오른쪽 정렬이라, 여러 줄로 넘어가는 서술(요건·비고·사유)이 톱니 모양 문단이 되어
+     * 읽기 어려웠다. 주지 않으면 **줄바꿈이 있거나 80자를 넘는 글**일 때 자동으로 켜진다.
+     * `false` 를 주면 길어도 끈다.
+     */
+    block?: boolean;
 }
 interface KeyValueListProps {
     /** 값의 원천 객체 — 보통 상태 바인딩({ "$state": "selectedOrder" })을 넣는다 */
@@ -1548,13 +1869,28 @@ declare function Show({ when, children }: ShowProps): React__default.JSX.Element
 /** 가로 구분선 */
 declare function Divider({ style, className }: SduiBoxProps): React__default.JSX.Element;
 
+interface SduiDialogProps extends DialogProps {
+    /**
+     * Escape·바깥 클릭(모바일은 뒤로 가기까지)으로 닫기 전에 "작성 중인 내용을 버릴까요?"를 묻는다.
+     *
+     *  - 생략: 창 안의 Form 이 작성 중(`$dirty`)이고 사용자가 창 안을 조작했을 때만 묻는다.
+     *  - `true` 또는 문구: 언제나 묻는다(문구를 주면 그 문구로). Form 없이 상태로 입력을 모으는
+     *    창(평가 작성 등)은 `$calc` 로 "입력이 있으면 문구, 없으면 false" 를 묶는다.
+     *  - `false`: 묻지 않는다.
+     *
+     * 닫기(X)·스펙의 '취소' 버튼은 사용자가 고른 닫기라 묻지 않는다 — 실수로 닫히는 길은
+     * Escape 와 어두운 바깥 영역이다(ERP 실측: 10문항 평가 작성이 바깥 클릭 한 번에 사라졌다).
+     */
+    confirmClose?: boolean | string;
+}
 /**
  * Dialog + 표준 닫기 UX(Escape·배경 클릭). 레지스트리의 "Dialog"는 이 래퍼다.
  *
  * 겹침 처리는 전부 OverlayLayer가 맡는다 — 단일 오버레이 루트로 포털해 조상
  * CSS에 휘둘리지 않고, Escape는 맨 위 한 겹만 닫는다(overlay.tsx 주석 참고).
+ * 포커스(열 때 창으로, Tab 가두기, 닫으면 연 버튼으로)와 모바일 뒤로 가기 닫기도 거기 있다.
  */
-declare function SduiDialog(props: DialogProps): React.JSX.Element;
+declare function SduiDialog({ confirmClose, ...props }: SduiDialogProps): React__default.JSX.Element;
 
 /**
  * SDUI 폼 컨테이너. 필드 값은 페이지 상태의 `{id}.{field}` 키에 산다:
@@ -1577,7 +1913,12 @@ interface SduiFormProps {
     rules?: Record<string, SduiRule[]>;
     /** 에러 메시지용 필드 라벨 */
     labels?: Record<string, string>;
-    /** true면 작성 중(dirty) 창 닫기/새로고침 시 확인을 띄운다 */
+    /**
+     * true면 작성 중(dirty)일 때 새로고침·창 닫기와 **앱 안 이동** 전에 확인을 띄운다.
+     * 앱 안 이동은 렌더러의 이탈 가드(`page.leaveGuard` 와 같은 통로)로 올라간다 —
+     * 호스트가 `adapter.setLeaveGuard` 를 받으면 셸 메뉴·뒤로 가기까지 막고, 안 받으면
+     * 스펙의 `navigate` 액션 앞에서만 묻는다. 저장 직후(`$resetDirty` 대기 중)의 이동은 묻지 않는다.
+     */
     guard?: boolean;
     onSubmit?: (event: React__default.FormEvent) => void;
     className?: string;
@@ -1855,6 +2196,24 @@ declare function SduiPermissionProvider({ can, children }: SduiPermissionProvide
  */
 declare function useSduiCan(): SduiCanFn;
 
+/** Form이 렌더러에 등록하는 검증 설정 */
+interface SduiFormConfig {
+    rules: Record<string, SduiRule[]>;
+    /** 에러 메시지에 쓸 필드 라벨 (없으면 필드 키) */
+    labels: Record<string, string>;
+}
+/**
+ * 렌더러 런타임 — 페이지 상태와 폼 레지스트리에 대한 접근.
+ * SduiForm 등 상태와 직접 상호작용해야 하는 스마트 컴포넌트가 쓴다.
+ */
+interface SduiRuntime {
+    state: Record<string, SduiPropValue | undefined>;
+    setEntries: (entries: Record<string, SduiPropValue | undefined>) => void;
+    registerForm: (id: string, config: SduiFormConfig) => void;
+    unregisterForm: (id: string) => void;
+}
+declare function useSduiRuntime(): SduiRuntime;
+
 /** custom 액션을 앱 코드로 위임하는 확장 지점. */
 type CustomActionHandler = (name: string, payload?: SduiPropValue, value?: unknown) => void;
 /** custom 검증 규칙 구현 — 에러 메시지 또는 null 반환 */
@@ -1974,12 +2333,6 @@ declare function patternSpecCandidates(id: string): SpecIdCandidate[];
  */
 declare function resolvePatternSpec<T>(id: string, load: (specId: string) => Promise<T | null | undefined>): Promise<ResolvedPatternSpec<T> | null>;
 
-/**
- * 어휘 전체. **렌더러와 편집기 검증기가 같은 이 집합을 본다** — 목록이 두 벌이면
- * 한쪽에만 연산을 더했을 때 "렌더는 되는데 저장이 거부되는" 스펙이 생긴다.
- */
-declare const CALC_OPS: ReadonlySet<string>;
-
 declare const ICON_NAMES: readonly string[];
 
 /**
@@ -2013,23 +2366,23 @@ interface SpecIssue {
 type SlotNamesOf = (component: string) => Set<string> | null;
 declare function validateSpec(page: unknown, knownComponents?: Set<string>, slotNamesOf?: SlotNamesOf): SpecIssue[];
 
-/** Form이 렌더러에 등록하는 검증 설정 */
-interface SduiFormConfig {
-    rules: Record<string, SduiRule[]>;
-    /** 에러 메시지에 쓸 필드 라벨 (없으면 필드 키) */
-    labels: Record<string, string>;
-}
 /**
- * 렌더러 런타임 — 페이지 상태와 폼 레지스트리에 대한 접근.
- * SduiForm 등 상태와 직접 상호작용해야 하는 스마트 컴포넌트가 쓴다.
+ * 모바일 폭 판정 — **CSS 와 같은 경계 하나**를 쓴다.
+ *
+ * 브레이크포인트 계약: mobile ≤767.98px · tablet 768–1023.98px · desktop ≥1024px.
+ * `.98` 은 소수 픽셀 뷰포트(확대·고해상도)에서 767px 과 768px 사이가 비지 않게 하는 관례다.
+ * `screen and` 이 붙는 이유: 인쇄 용지 폭(A4 ≈ 720px)이 `max-width` 쿼리에 걸려 인쇄물이
+ * 모바일 배치로 나오는 것을 막는다. LAYOUT_CSS 의 미디어 쿼리도 같은 문자열을 쓴다.
  */
-interface SduiRuntime {
-    state: Record<string, SduiPropValue | undefined>;
-    setEntries: (entries: Record<string, SduiPropValue | undefined>) => void;
-    registerForm: (id: string, config: SduiFormConfig) => void;
-    unregisterForm: (id: string) => void;
-}
-declare function useSduiRuntime(): SduiRuntime;
+declare const MOBILE_MEDIA_QUERY = "screen and (max-width: 767.98px)";
+/**
+ * 지금 뷰포트가 모바일 폭(≤767.98px)인가.
+ *
+ * JS 로 폭을 판정하는 곳은 **이 훅 하나**다 — 컴포넌트마다 `innerWidth` 를 재거나 자기 경계를
+ * 두면 CSS 가 접는 폭과 JS 가 보기를 바꾸는 폭이 갈라진다. 배치만 바꾸는 일은 CSS 로 하고,
+ * 이 훅은 **CSS 로는 못 하는 것**(기본 보기 전환, 초기 뷰 계산 등)에만 쓴다.
+ */
+declare function useIsMobile(): boolean;
 
 /**
  * `boxed()` — 어떤 컴포넌트든 바깥에서 온 `style`·`className`을 자기 뿌리에 얹게 만든다.
@@ -2088,6 +2441,11 @@ declare function useOverlayLayer(active: boolean, onEscape?: () => void, nodeRef
     isTop: boolean;
     holdsTop: boolean;
 };
+/**
+ * 모달 겹이 하나라도 떠 있는가 — 창 밖에서 그려지는 것(토스트)이 자리를 비켜 줄 때 쓴다.
+ * 스택 구독이라 창이 열리고 닫힐 때만 다시 그린다.
+ */
+declare function useAnyModalOpen(): boolean;
 /**
  * 겹을 담을 곳을 바꾼다. 기본은 body 밑 단일 루트지만, **화면 일부에 페이지를
  * 그려 보이는 곳**(편집기 미리보기·뷰어)은 자기 상자를 지정해야 한다 — 안 그러면
@@ -2162,4 +2520,4 @@ interface ImageViewerProps {
  */
 declare function ImageViewer({ src, alt, open, onClose }: ImageViewerProps): React__default.ReactPortal | null;
 
-export { Actions, type ActionsProps, Alert, type AlertProps, Avatar, type AvatarProps, Badge, type BadgeProps, type BadgeTone, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonProps, CALC_OPS, 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_NAMES, Icon, IconButton, type IconButtonProps, type IconProps, ImageViewer, type ImageViewerProps, Input, type InputProps, type Justify, type KeyValueItem, KeyValueList, type KeyValueListProps, type MeterTone, NodeErrorBoundary, OverlayContainerContext, OverlayLayer, PageHead, type PageHeadProps, Pagination, type PaginationProps, ProgressBar, type ProgressBarProps, Radio, type RadioProps, type RemotePageState, RemoteSearchResults, type RemoteSearchResultsProps, type RemoteSummaryState, type ResolvedPatternSpec, 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 SduiContainerRoleProps, type SduiDateCell, SduiDialog, type SduiDispatch, SduiForm, type SduiFormConfig, type SduiFormProps, SduiGapScale, type SduiGridCard, type SduiGridCardAction, type SduiGridCardRow, type SduiIconCell, type SduiImageCell, type SduiLinkCell, type SduiNumberCell, SduiPage, SduiPermissionProvider, type SduiProgressCell, SduiPropValue, type SduiRegistry, SduiRenderer, type SduiRendererProps, type SduiRowCondition, SduiRule, type SduiRuntime, type SduiSearchAction, type SduiSearchColumn, SduiSearchDataProvider, SduiSearchInvalidationProvider, SduiSearchResults, type SduiSearchResultsProps, type SduiSearchSummary, type SduiSearchSummaryItem, type SduiTagCell, SduiTextAlignScale, type SduiTextCell, type SduiUseSpec, SduiWeightScale, type SearchAction, type SearchColumn, type SearchFetcher, type SearchField, type SearchFilter, type SearchInvalidator, type SearchOption, type SearchPage, SearchResults, type SearchResultsProps, type SearchRow, SearchSummaryCards, type SearchSummaryCardsProps, type SearchTabs, 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 SpecIdCandidate, 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, TimePickerProps, Toast, type ToastProps, Tooltip, type TooltipProps, boxed, cascadingValuePaths, cellRenderer, cleanSearchValues, createRegistry, createSearchInvalidator, defaultAdapter, defaultRegistry, getOverlayRoot, imageRenderer, includesLooseSearch, isValidSpecId, joinMultiValue, loadOptionalModule, mapActions, mapCardRows, mapColumns, mapGridCard, mapViews, matchesCondition, normalizePageSizes, normalizeSearchText, patternSpecCandidates, resolvePatternSpec, searchFieldKeys, searchValuesFromParams, sortableDropIndex, sortableMove, splitMultiValue, summaryParams, useOverlayLayer, useRemoteSearchPage, useRemoteSearchSummary, useSduiAssetResolver, useSduiCan, useSduiDispatch, useSduiRuntime, useSduiSandbox, useSearchFetcher, validateSpec, withProps };
+export { Actions, type ActionsProps, Alert, type AlertProps, Avatar, type AvatarProps, Badge, type BadgeProps, type BadgeTone, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonProps, CALC_OPS, 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_NAMES, Icon, IconButton, type IconButtonProps, type IconProps, ImageViewer, type ImageViewerProps, Input, type InputProps, type Justify, type KeyValueItem, KeyValueList, type KeyValueListProps, MOBILE_MEDIA_QUERY, type MeterTone, NodeErrorBoundary, ORDER_PARAM, OverlayContainerContext, OverlayLayer, PageHead, type PageHeadProps, Pagination, type PaginationProps, ProgressBar, type ProgressBarProps, Radio, type RadioProps, type RemotePageState, RemoteSearchResults, type RemoteSearchResultsProps, type RemoteSummaryState, type ResolvedPatternSpec, ResultEmptyState, type ResultEmptyStateProps, ResultTable, type ResultTableColumn, type ResultTableProps, Row, type RowProps, SORT_PARAM, SduiAction, type SduiAdapter, type SduiAssetContext, type SduiAssetResolver, type SduiBadgeCell, SduiBoxProps, type SduiCanFn, type SduiCanQuery, type SduiCanSetting, type SduiCell, SduiColumnsScale, SduiContainerLayoutProps, type SduiContainerRoleProps, type SduiDateCell, type SduiDateFormat, SduiDialog, type SduiDispatch, type SduiDisplayFormat, SduiForm, type SduiFormConfig, type SduiFormProps, SduiGapScale, type SduiGridCard, type SduiGridCardAction, type SduiGridCardRow, type SduiIconCell, type SduiImageCell, type SduiLinkCell, type SduiNumberCell, SduiPage, SduiPermissionProvider, type SduiProgressCell, SduiPropValue, type SduiRegistry, SduiRenderer, type SduiRendererProps, type SduiRowCondition, SduiRule, type SduiRuntime, type SduiSearchAction, type SduiSearchColumn, SduiSearchDataProvider, SduiSearchInvalidationProvider, SduiSearchResults, type SduiSearchResultsProps, type SduiSearchSummary, type SduiSearchSummaryItem, type SduiTagCell, SduiTextAlignScale, type SduiTextCell, type SduiUseSpec, SduiWeightScale, type SearchAction, type SearchColumn, type SearchFetcher, type SearchField, type SearchFilter, type SearchInvalidator, type SearchOption, type SearchPage, SearchResults, type SearchResultsProps, type SearchRow, SearchSummaryCards, type SearchSummaryCardsProps, type SearchTabs, SearchToolbar, type SearchValues, type SearchViewItem, Section, type SectionProps, SegmentedControl, type SegmentedControlProps, type SegmentedItem, Select, type SelectOption, type SelectOptionRecord, type SelectProps, type ServerSortMemory, type ServerUnsortable, Show, type ShowProps, SidebarNav, type SidebarNavItem, type SidebarNavProps, type SidebarNavSection, type SortDir, type SortEcho, SortHandle, type SortHandleProps, type SortState, SortableList, type SortableListProps, Spacer, type SpacerProps, type SpecIdCandidate, 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, TimePickerProps, Toast, type ToastProps, Tooltip, type TooltipProps, boxed, cascadingValuePaths, cellRenderer, cleanSearchValues, conditionParams, createRegistry, createSearchInvalidator, createServerSortMemory, defaultAdapter, defaultRegistry, formatDateValue, formatDisplayValue, formatNumberValue, getOverlayRoot, imageRenderer, includesLooseSearch, isValidSpecId, isZonedIsoDateTime, joinMultiValue, loadOptionalModule, mapActions, mapCardRows, mapColumns, mapGridCard, mapViews, matchesCondition, nextSort, normalizePageSizes, normalizeSearchText, parseNumeric, patternSpecCandidates, resolvePatternSpec, searchFieldKeys, searchValuesFromParams, serverSortMemory, sortEchoOf, sortFromParams, sortableDropIndex, sortableMove, splitMultiValue, summaryParams, useAnyModalOpen, useIsMobile, useOverlayLayer, useRemoteSearchPage, useRemoteSearchSummary, useSduiAssetResolver, useSduiCan, useSduiDispatch, useSduiRuntime, useSduiSandbox, useSearchFetcher, validateSpec, withProps, withoutSort };