@wipco/sdui 0.50.0 → 0.50.2

package/dist/index.d.ts

@@ -1625,6 +1625,26 @@ declare const defaultRegistry: {
  *
  * `@wipco/sdui/rich`의 무거운 위젯도 이 함수로 얹는다 —
  * `createRegistry(richComponents)`가 곧 Chart/MapPreview를 켜는 스위치다.
+ *
+ * ## 여기 넣어야 하는 것 — 프로젝트 고유 어휘
+ *
+ * **브랜드가 대표적인 예다.** 로고는 프로젝트마다 다르고, 다른 것이 정상이다.
+ * 라이브러리에 `Logo` 를 두면 남의 회사 클래스 이름·상호·아트워크 경로를 **기본값으로
+ * 싣게 되는데, 그것은 라이브러리가 보증할 수 없는 값이다.** 그래서 어휘에 넣지 않았다 —
+ * 빠뜨린 것이 아니라 이 통로가 그 자리다.
+ *
+ * ```tsx
+ * const registry = createRegistry({ Logo: MyBrandLogo });
+ * ```
+ *
+ * 시각 빌더까지 쓰려면 메타데이터도 같이 얹는다 — `catalog` 프롭에
+ * `{ ...allComponentMeta, ...myComponentMeta }` 를 넘기면 팔레트·속성 패널·드롭 판정이
+ * 그 이름을 알게 된다(`@wipco/sdui/meta`).
+ *
+ * 반대로, **업무 로직이 든 위젯을 여기 얹기 전에 한 번 더 생각할 것.** 소비 프로젝트에서
+ * 위젯 25종을 이 통로로 얹었다가 그중 24종이 "어휘가 부족해서 만든 우회"였음이 드러나
+ * 전부 사라졌다. 막힌 자리가 값 계산(`$calc`)이나 상태 쓰기(액션)라면 그것은 어휘의
+ * 빈칸이지 컴포넌트가 필요하다는 뜻이 아니다.
  */
 declare function createRegistry(extensions: SduiRegistry): SduiRegistry;
 

package/dist/index.js

@@ -2845,6 +2845,7 @@ function SduiRenderer({
   hostRef.current = host;
   const [state, setState] = useState(() => ({ ...initialState ?? {} }));
   const urlSeeded = useRef(false);
+  const urlSeedPending = useRef(false);
   const [toasts, setToasts] = useState([]);
   const toastSeq = useRef(0);
   const toastTimers = useRef([]);
@@ -2879,10 +2880,17 @@ function SduiRenderer({
         }
       }
     }
-    if (Object.keys(seeded).length > 0) setEntries(seeded);
+    if (Object.keys(seeded).length > 0) {
+      urlSeedPending.current = true;
+      setEntries(seeded);
+    }
   }, [page.urlState, setEntries, syncUrlState]);
   useEffect(() => {
     if (!syncUrlState || !page.urlState?.length || !urlSeeded.current || typeof window === "undefined") return;
+    if (urlSeedPending.current) {
+      urlSeedPending.current = false;
+      return;
+    }
     const params = new URLSearchParams(window.location.search);
     let changed = false;
     for (const key of page.urlState) {

package/package.json

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