@wipco/sdui 0.12.1 → 0.13.1

package/dist/index.d.ts

@@ -1551,6 +1551,18 @@ interface SduiRendererProps {
     registry?: SduiRegistry;
     /** 내비게이션·API·실시간 연결점 — 생략 시 브라우저 기본 구현 */
     adapter?: SduiAdapter;
+    /**
+     * 마운트 시 한 번 심는 초기 상태 — **경로 파라미터가 들어오는 자리**다.
+     *
+     * 동적 상세 라우트(`asset/asset/:id`)를 열 때 호스트 라우터가
+     * `{ 'route.id': '<실제 id>' }` 를 심으면, 스펙은 `page.data` 의 endpoint 에서
+     * `{"$state":"route.id"}` 로 그 값을 읽어 **그 행의** 데이터를 조회한다.
+     * 이 자리가 없던 동안 목록의 행 클릭이 전부 고정 샘플 상세로 갔다(실사용 지적).
+     *
+     * 마운트 시 1회다 — 라우트가 바뀌면 호스트가 `key` 로 렌더러를 갈아 끼워야 한다
+     * (같은 인스턴스를 재사용하면 이전 화면의 상태가 새 화면으로 샌다).
+     */
+    initialState?: Record<string, SduiPropValue>;
     /**
      * page.urlState ↔ URL 쿼리 동기화 여부 (기본 true).
      * 편집기 미리보기처럼 실제 페이지 라우트가 아닌 곳에 마운트할 때 false로 끈다 —
@@ -1577,7 +1589,7 @@ interface SduiRendererProps {
  * 서버(JSON 스펙) 주도 페이지 렌더러.
  * 스펙은 직렬화 가능한 데이터만 담고, 상태·이벤트·폼·내비게이션은 여기서 해석한다.
  */
-declare function SduiRenderer({ page, registry, adapter, syncUrlState, can, onCustomAction, customValidators, }: SduiRendererProps): React__default.JSX.Element;
+declare function SduiRenderer({ page, registry, adapter, syncUrlState, initialState, can, onCustomAction, customValidators, }: SduiRendererProps): React__default.JSX.Element;
 
 /**
  * 스펙 구조 검증기 — 서버(또는 편집기)가 만든 스펙의 형태 오류를 렌더 전에 찾아낸다.

package/dist/index.js

@@ -2247,6 +2247,7 @@ function SduiRenderer({
   registry = defaultRegistry,
   adapter,
   syncUrlState = true,
+  initialState,
   can,
   onCustomAction,
   customValidators
@@ -2254,7 +2255,7 @@ function SduiRenderer({
   const host = useMemo(() => resolveAdapter(adapter), [adapter]);
   const hostRef = useRef(host);
   hostRef.current = host;
-  const [state, setState] = useState({});
+  const [state, setState] = useState(() => ({ ...initialState ?? {} }));
   const urlSeeded = useRef(false);
   const [toasts, setToasts] = useState([]);
   const toastSeq = useRef(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipco/sdui",
-  "version": "0.12.1",
+  "version": "0.13.1",
   "description": "WIPCO 서버 주도 UI(SDUI) 렌더러 — JSON 페이지 스펙을 React 컴포넌트로 렌더링",
   "keywords": [
     "sdui",