@simplysm/solid 13.0.34 → 13.0.35

package/dist/providers/shared-data/SharedDataContext.d.ts

@@ -1,22 +1,61 @@
 import { type Accessor } from "solid-js";
+/**
+ * 공유 데이터 정의
+ *
+ * @remarks
+ * SharedDataProvider에 전달하여 서버 데이터 구독을 설정한다.
+ */
 export interface SharedDataDefinition<TData> {
+    /** 서비스 연결 key (useServiceClient의 connect key와 동일) */
     serviceKey: string;
+    /** 데이터 조회 함수 (changeKeys가 있으면 해당 항목만 부분 갱신) */
     fetch: (changeKeys?: Array<string | number>) => Promise<TData[]>;
+    /** 항목의 고유 key 추출 함수 */
     getKey: (item: TData) => string | number;
+    /** 정렬 기준 배열 (여러 기준 적용 가능) */
     orderBy: [(item: TData) => unknown, "asc" | "desc"][];
+    /** 서버 이벤트 필터 (같은 name의 이벤트 중 filter가 일치하는 것만 수신) */
     filter?: unknown;
 }
+/**
+ * 공유 데이터 접근자
+ *
+ * @remarks
+ * 각 데이터 key에 대한 반응형 접근 및 변경 알림을 제공한다.
+ */
 export interface SharedDataAccessor<TData> {
+    /** 반응형 항목 배열 */
     items: Accessor<TData[]>;
+    /** key로 단일 항목 조회 */
     get: (key: string | number | undefined) => TData | undefined;
+    /** 서버에 변경 이벤트 전파 (모든 구독자에게 refetch 트리거) */
     emit: (changeKeys?: Array<string | number>) => Promise<void>;
 }
+/**
+ * 공유 데이터 Context 값
+ *
+ * @remarks
+ * - configure 호출 전: wait, busy, configure만 접근 가능. 데이터 접근 시 throw
+ * - configure 호출 후: 각 데이터 key별 SharedDataAccessor와 전체 상태 관리 메서드 포함
+ */
 export type SharedDataValue<TSharedData extends Record<string, unknown>> = {
     [K in keyof TSharedData]: SharedDataAccessor<TSharedData[K]>;
 } & {
+    /** 모든 초기 fetch 완료까지 대기 */
     wait: () => Promise<void>;
+    /** fetch 진행 중 여부 */
     busy: Accessor<boolean>;
+    /** definitions를 설정하여 데이터 구독 시작 */
+    configure: (definitions: {
+        [K in keyof TSharedData]: SharedDataDefinition<TSharedData[K]>;
+    }) => void;
 };
+/** 공유 데이터 Context */
 export declare const SharedDataContext: import("solid-js").Context<SharedDataValue<Record<string, unknown>> | undefined>;
+/**
+ * 공유 데이터에 접근하는 훅
+ *
+ * @throws SharedDataProvider가 없으면 에러 발생
+ */
 export declare function useSharedData<TSharedData extends Record<string, unknown> = Record<string, unknown>>(): SharedDataValue<TSharedData>;
 //# sourceMappingURL=SharedDataContext.d.ts.map

package/dist/providers/shared-data/SharedDataContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SharedDataContext.d.ts","sourceRoot":"","sources":["../../../src/providers/shared-data/SharedDataContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAA6B,MAAM,UAAU,CAAC;AAEpE,MAAM,WAAW,oBAAoB,CAAC,KAAK;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACjE,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,EAAE,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB,CAAC,KAAK;IACvC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IACzB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,KAAK,KAAK,GAAG,SAAS,CAAC;IAC7D,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AAED,MAAM,MAAM,eAAe,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;KACxE,CAAC,IAAI,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAC7D,GAAG;IACF,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,iBAAiB,kFAA4D,CAAC;AAE3F,wBAAgB,aAAa,CAC3B,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAClE,eAAe,CAAC,WAAW,CAAC,CAQhC"}
+{"version":3,"file":"SharedDataContext.d.ts","sourceRoot":"","sources":["../../../src/providers/shared-data/SharedDataContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAA6B,MAAM,UAAU,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB,CAAC,KAAK;IACzC,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,KAAK,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACjE,uBAAuB;IACvB,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,MAAM,CAAC;IACzC,6BAA6B;IAC7B,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,EAAE,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC;IACtD,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK;IACvC,gBAAgB;IAChB,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IACzB,oBAAoB;IACpB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,KAAK,KAAK,GAAG,SAAS,CAAC;IAC7D,2CAA2C;IAC3C,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;KACxE,CAAC,IAAI,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAC7D,GAAG;IACF,0BAA0B;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,oBAAoB;IACpB,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxB,kCAAkC;IAClC,SAAS,EAAE,CAAC,WAAW,EAAE;SACtB,CAAC,IAAI,MAAM,WAAW,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;KAC/D,KAAK,IAAI,CAAC;CACZ,CAAC;AAEF,qBAAqB;AACrB,eAAO,MAAM,iBAAiB,kFAA4D,CAAC;AAE3F;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAClE,eAAe,CAAC,WAAW,CAAC,CAMhC"}

package/dist/providers/shared-data/SharedDataContext.js

@@ -3,9 +3,7 @@ const SharedDataContext = createContext();
 function useSharedData() {
   const context = useContext(SharedDataContext);
   if (!context) {
-    throw new Error(
-      "useSharedData\uB294 SharedDataProvider \uB0B4\uBD80\uC5D0\uC11C\uB9CC \uC0AC\uC6A9\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4. SharedDataProvider\uB294 ServiceClientProvider \uC544\uB798\uC5D0 \uC704\uCE58\uD574\uC57C \uD569\uB2C8\uB2E4"
-    );
+    throw new Error("useSharedData\uB294 SharedDataProvider \uB0B4\uBD80\uC5D0\uC11C\uB9CC \uC0AC\uC6A9\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4");
   }
   return context;
 }

package/dist/providers/shared-data/SharedDataContext.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/providers/shared-data/SharedDataContext.ts"],
-  "mappings": "AAAA,SAAwB,eAAe,kBAAkB;AAuBlD,MAAM,oBAAoB,cAAwD;AAElF,SAAS,gBAEkB;AAChC,QAAM,UAAU,WAAW,iBAAiB;AAC5C,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;",
+  "mappings": "AAAA,SAAwB,eAAe,kBAAkB;AAyDlD,MAAM,oBAAoB,cAAwD;AAOlF,SAAS,gBAEkB;AAChC,QAAM,UAAU,WAAW,iBAAiB;AAC5C,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,0HAAoD;AAAA,EACtE;AACA,SAAO;AACT;",
   "names": []
 }

package/dist/providers/shared-data/SharedDataProvider.d.ts

@@ -1,9 +1,34 @@
 import { type JSX } from "solid-js";
-import { type SharedDataDefinition } from "./SharedDataContext";
-export declare function SharedDataProvider<TSharedData extends Record<string, unknown>>(props: {
-    definitions: {
-        [K in keyof TSharedData]: SharedDataDefinition<TSharedData[K]>;
-    };
+/**
+ * 공유 데이터 Provider
+ *
+ * @remarks
+ * - ServiceClientProvider와 NotificationProvider 내부에서 사용해야 함
+ * - LoggerProvider가 있으면 fetch 실패를 로거에도 기록
+ * - configure() 호출 전: wait, busy, configure만 접근 가능. 데이터 접근 시 throw
+ * - configure() 호출 후: definitions의 각 key마다 서버 이벤트 리스너를 등록하여 실시간 동기화
+ * - 동시 fetch 호출 시 version counter로 데이터 역전 방지
+ * - fetch 실패 시 사용자에게 danger 알림 표시
+ * - cleanup 시 모든 이벤트 리스너 자동 해제
+ *
+ * @example
+ * ```tsx
+ * <SharedDataProvider>
+ *   <App />
+ * </SharedDataProvider>
+ *
+ * // 자식 컴포넌트에서 나중에 설정:
+ * useSharedData().configure({
+ *   users: {
+ *     serviceKey: "main",
+ *     fetch: async (changeKeys) => fetchUsers(changeKeys),
+ *     getKey: (item) => item.id,
+ *     orderBy: [[(item) => item.name, "asc"]],
+ *   },
+ * });
+ * ```
+ */
+export declare function SharedDataProvider(props: {
     children: JSX.Element;
 }): JSX.Element;
 //# sourceMappingURL=SharedDataProvider.d.ts.map

package/dist/providers/shared-data/SharedDataProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SharedDataProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/shared-data/SharedDataProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,GAAG,EAAuC,MAAM,UAAU,CAAC;AAExF,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,qBAAqB,CAAC;AAM7B,wBAAgB,kBAAkB,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE;IACrF,WAAW,EAAE;SAAG,CAAC,IAAI,MAAM,WAAW,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IAChF,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;CACvB,GAAG,GAAG,CAAC,OAAO,CA4Id"}
+{"version":3,"file":"SharedDataProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/shared-data/SharedDataProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,GAAG,EAAuC,MAAM,UAAU,CAAC;AAaxF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAA;CAAE,GAAG,GAAG,CAAC,OAAO,CAkKhF"}

package/dist/providers/shared-data/SharedDataProvider.js

@@ -10,12 +10,15 @@ function SharedDataProvider(props) {
   const serviceClient = useServiceClient();
   const notification = useNotification();
   const logger = useLogger();
+  let configured = false;
   const [busyCount, setBusyCount] = createSignal(0);
   const busy = () => busyCount() > 0;
   const signalMap = /* @__PURE__ */ new Map();
   const memoMap = /* @__PURE__ */ new Map();
   const listenerKeyMap = /* @__PURE__ */ new Map();
   const versionMap = /* @__PURE__ */ new Map();
+  const accessors = {};
+  let currentDefinitions;
   function ordering(data, orderByList) {
     let result = [...data];
     for (const orderBy of [...orderByList].reverse()) {
@@ -57,54 +60,72 @@ function SharedDataProvider(props) {
   async function wait() {
     await waitUntil(() => busyCount() <= 0);
   }
-  const accessors = {};
-  for (const [name, def] of Object.entries(props.definitions)) {
-    const [items, setItems] = createSignal([]);
-    signalMap.set(name, [items, setItems]);
-    const itemMap = createMemo(() => {
-      const map = /* @__PURE__ */ new Map();
-      for (const item of items()) {
-        map.set(def.getKey(item), item);
-      }
-      return map;
-    });
-    memoMap.set(name, itemMap);
-    const client = serviceClient.get(def.serviceKey);
-    void client.addEventListener(SharedDataChangeEvent, {
-      name,
-      filter: def.filter
-    }, async (changeKeys) => {
-      await loadData(name, def, changeKeys);
-    }).then((key) => {
-      listenerKeyMap.set(name, key);
-    });
-    void loadData(name, def);
-    accessors[name] = {
-      items,
-      get: (key) => {
-        if (key === void 0) return void 0;
-        return itemMap().get(key);
-      },
-      emit: async (changeKeys) => {
-        await client.emitToServer(SharedDataChangeEvent, (info) => info.name === name && objEqual(info.filter, def.filter), changeKeys);
-      }
-    };
+  function configure(definitions) {
+    if (configured) {
+      throw new Error("SharedDataProvider: configure()\uB294 1\uD68C\uB9CC \uD638\uCD9C\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4");
+    }
+    configured = true;
+    currentDefinitions = definitions;
+    for (const [name, def] of Object.entries(definitions)) {
+      const [items, setItems] = createSignal([]);
+      signalMap.set(name, [items, setItems]);
+      const itemMap = createMemo(() => {
+        const map = /* @__PURE__ */ new Map();
+        for (const item of items()) {
+          map.set(def.getKey(item), item);
+        }
+        return map;
+      });
+      memoMap.set(name, itemMap);
+      const client = serviceClient.get(def.serviceKey);
+      void client.addEventListener(SharedDataChangeEvent, {
+        name,
+        filter: def.filter
+      }, async (changeKeys) => {
+        await loadData(name, def, changeKeys);
+      }).then((key) => {
+        listenerKeyMap.set(name, key);
+      });
+      void loadData(name, def);
+      accessors[name] = {
+        items,
+        get: (key) => {
+          if (key === void 0) return void 0;
+          return itemMap().get(key);
+        },
+        emit: async (changeKeys) => {
+          await client.emitToServer(SharedDataChangeEvent, (info) => info.name === name && objEqual(info.filter, def.filter), changeKeys);
+        }
+      };
+    }
   }
   onCleanup(() => {
-    for (const [name] of Object.entries(props.definitions)) {
+    if (!currentDefinitions) return;
+    for (const [name] of Object.entries(currentDefinitions)) {
       const listenerKey = listenerKeyMap.get(name);
       if (listenerKey != null) {
-        const def = props.definitions[name];
+        const def = currentDefinitions[name];
         const client = serviceClient.get(def.serviceKey);
         void client.removeEventListener(listenerKey);
       }
     }
   });
-  const contextValue = {
-    ...accessors,
+  const KNOWN_KEYS = /* @__PURE__ */ new Set(["wait", "busy", "configure"]);
+  const contextValue = new Proxy({
     wait,
-    busy
-  };
+    busy,
+    configure
+  }, {
+    get(target, prop) {
+      if (KNOWN_KEYS.has(prop)) {
+        return target[prop];
+      }
+      if (!configured) {
+        throw new Error("SharedDataProvider: configure()\uB97C \uBA3C\uC800 \uD638\uCD9C\uD574\uC57C \uD569\uB2C8\uB2E4");
+      }
+      return accessors[prop];
+    }
+  });
   return _$createComponent(SharedDataContext.Provider, {
     value: contextValue,
     get children() {

package/dist/providers/shared-data/SharedDataProvider.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/providers/shared-data/SharedDataProvider.tsx"],
-  "mappings": "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",
-  "names": ["createMemo", "createSignal", "onCleanup", "objEqual", "waitUntil", "SharedDataContext", "SharedDataChangeEvent", "useServiceClient", "useNotification", "useLogger", "SharedDataProvider", "props", "serviceClient", "notification", "logger", "busyCount", "setBusyCount", "busy", "signalMap", "Map", "memoMap", "listenerKeyMap", "versionMap", "ordering", "data", "orderByList", "result", "orderBy", "reverse", "selector", "item", "orderByDesc", "loadData", "name", "def", "changeKeys", "currentVersion", "get", "set", "c", "signal", "Error", "setItems", "resData", "fetch", "prev", "filtered", "filter", "includes", "getKey", "push", "err", "error", "danger", "message", "wait", "accessors", "Object", "entries", "definitions", "items", "itemMap", "map", "client", "serviceKey", "addEventListener", "then", "key", "undefined", "emit", "emitToServer", "info", "listenerKey", "removeEventListener", "contextValue", "_$createComponent", "Provider", "value", "children"]
+  "mappings": ";AAAA,SAAkCA,YAAYC,cAAcC,iBAAiB;AAC7E,SAASC,UAAUC,iBAAiB;AACpC,SACEC,yBAIK;AACP,SAASC,6BAA6B;AACtC,SAASC,wBAAwB;AACjC,SAASC,uBAAuB;AAChC,SAASC,iBAAiB;AA+BnB,SAASC,mBAAmBC,OAA+C;AAChF,QAAMC,gBAAgBL,iBAAiB;AACvC,QAAMM,eAAeL,gBAAgB;AACrC,QAAMM,SAASL,UAAU;AAEzB,MAAIM,aAAa;AACjB,QAAM,CAACC,WAAWC,YAAY,IAAIhB,aAAa,CAAC;AAChD,QAAMiB,OAA0BA,MAAMF,UAAU,IAAI;AAEpD,QAAMG,YAAY,oBAAIC,IAAwD;AAC9E,QAAMC,UAAU,oBAAID,IAAqD;AACzE,QAAME,iBAAiB,oBAAIF,IAAoB;AAC/C,QAAMG,aAAa,oBAAIH,IAAoB;AAC3C,QAAMI,YAAyD,CAAC;AAChE,MAAIC;AAEJ,WAASC,SAAaC,MAAYC,aAA8D;AAC9F,QAAIC,SAAS,CAAC,GAAGF,IAAI;AACrB,eAAWG,WAAW,CAAC,GAAGF,WAAW,EAAEG,QAAQ,GAAG;AAChD,YAAMC,WAAYC,UAAaH,QAAQ,CAAC,EAAEG,IAAI;AAC9C,UAAIH,QAAQ,CAAC,MAAM,QAAQ;AACzBD,iBAASA,OAAOK,YAAYF,QAAQ;MACtC,OAAO;AACLH,iBAASA,OAAOC,QAAQE,QAAQ;MAClC;IACF;AACA,WAAOH;EACT;AAEA,iBAAeM,SACbC,MACAC,KACAC,YACe;AAEf,UAAMC,kBAAkBhB,WAAWiB,IAAIJ,IAAI,KAAK,KAAK;AACrDb,eAAWkB,IAAIL,MAAMG,cAAc;AAEnCtB,iBAAcyB,OAAMA,IAAI,CAAC;AACzB,QAAI;AACF,YAAMC,SAASxB,UAAUqB,IAAIJ,IAAI;AACjC,UAAI,CAACO,OAAQ,OAAM,IAAIC,MAAM,IAAIR,IAAI,wGAAwB;AAE7D,YAAM,CAAA,EAAGS,QAAQ,IAAIF;AACrB,YAAMG,UAAU,MAAMT,IAAIU,MAAMT,UAAU;AAG1C,UAAIf,WAAWiB,IAAIJ,IAAI,MAAMG,eAAgB;AAE7C,UAAI,CAACD,YAAY;AACfO,iBAASnB,SAASoB,SAAST,IAAIP,OAAO,CAAC;MACzC,OAAO;AACLe,iBAAUG,UAAS;AACjB,gBAAMC,WAAWD,KAAKE,OAAQjB,UAAS,CAACK,WAAWa,SAASd,IAAIe,OAAOnB,IAAa,CAAC,CAAC;AACtFgB,mBAASI,KAAK,GAAGP,OAAO;AACxB,iBAAOpB,SAASuB,UAAUZ,IAAIP,OAAO;QACvC,CAAC;MACH;IACF,SAASwB,KAAK;AAEZxC,aAAOyC,MAAM,eAAenB,IAAI,mBAAmBkB,GAAG;AACtDzC,mBAAa2C,OACX,6DACAF,eAAeV,QAAQU,IAAIG,UAAU,IAAIrB,IAAI,qHAC/C;IACF,UAAC;AACCnB,mBAAcyB,OAAMA,IAAI,CAAC;IAC3B;EACF;AAEA,iBAAegB,OAAsB;AAEnC,UAAMtD,UAAU,MAAMY,UAAU,KAAK,CAAC;EACxC;AAEA,WAAS2C,UAAUC,aAAkE;AACnF,QAAI7C,YAAY;AACd,YAAM,IAAI6B,MAAM,wGAAiD;IACnE;AACA7B,iBAAa;AACbU,yBAAqBmC;AAErB,eAAW,CAACxB,MAAMC,GAAG,KAAKwB,OAAOC,QAAQF,WAAW,GAAG;AACrD,YAAM,CAACG,OAAOlB,QAAQ,IAAI5C,aAAwB,CAAA,CAAE;AAEpDkB,gBAAUsB,IAAIL,MAAM,CAAC2B,OAAOlB,QAAQ,CAAC;AAErC,YAAMmB,UAAUhE,WAAW,MAAM;AAC/B,cAAMiE,MAAM,oBAAI7C,IAA8B;AAC9C,mBAAWa,QAAQ8B,MAAM,GAAG;AAC1BE,cAAIxB,IAAIJ,IAAIe,OAAOnB,IAAa,GAAGA,IAAI;QACzC;AACA,eAAOgC;MACT,CAAC;AAED5C,cAAQoB,IAAIL,MAAM4B,OAAO;AAEzB,YAAME,SAAStD,cAAc4B,IAAIH,IAAI8B,UAAU;AAC/C,WAAKD,OACFE,iBACC9D,uBACA;QAAE8B;QAAMc,QAAQb,IAAIa;MAAO,GAC3B,OAAOZ,eAAe;AACpB,cAAMH,SAASC,MAAMC,KAAKC,UAAU;MACtC,CACF,EACC+B,KAAMC,SAAQ;AACbhD,uBAAemB,IAAIL,MAAMkC,GAAG;MAC9B,CAAC;AAEH,WAAKnC,SAASC,MAAMC,GAAG;AAEvBb,gBAAUY,IAAI,IAAI;QAChB2B;QACAvB,KAAM8B,SAAqC;AACzC,cAAIA,QAAQC,OAAW,QAAOA;AAC9B,iBAAOP,QAAQ,EAAExB,IAAI8B,GAAG;QAC1B;QACAE,MAAM,OAAOlC,eAAwC;AACnD,gBAAM4B,OAAOO,aACXnE,uBACCoE,UAASA,KAAKtC,SAASA,QAAQjC,SAASuE,KAAKxB,QAAQb,IAAIa,MAAM,GAChEZ,UACF;QACF;MACF;IACF;EACF;AAEApC,YAAU,MAAM;AACd,QAAI,CAACuB,mBAAoB;AACzB,eAAW,CAACW,IAAI,KAAKyB,OAAOC,QAAQrC,kBAAkB,GAAG;AACvD,YAAMkD,cAAcrD,eAAekB,IAAIJ,IAAI;AAC3C,UAAIuC,eAAe,MAAM;AACvB,cAAMtC,MAAMZ,mBAAmBW,IAAI;AACnC,cAAM8B,SAAStD,cAAc4B,IAAIH,IAAI8B,UAAU;AAC/C,aAAKD,OAAOU,oBAAoBD,WAAW;MAC7C;IACF;EACF,CAAC;AAED,QAAME,aAAa,oBAAIC,IAAI,CAAC,QAAQ,QAAQ,WAAW,CAAC;AAGxD,QAAMC,eAAe,IAAIC,MACvB;IAAEtB;IAAMxC;IAAMyC;EAAU,GACxB;IACEnB,IAAIyC,QAAQC,MAAc;AACxB,UAAIL,WAAWM,IAAID,IAAI,GAAG;AACxB,eAAOD,OAAOC,IAAI;MACpB;AACA,UAAI,CAACnE,YAAY;AACf,cAAM,IAAI6B,MAAM,gGAA8C;MAChE;AACA,aAAOpB,UAAU0D,IAAI;IACvB;EACF,CACF;AAEA,SAAAE,kBACG/E,kBAAkBgF,UAAQ;IAACC,OAAOP;IAAY,IAAAQ,WAAA;AAAA,aAAG5E,MAAM4E;IAAQ;EAAA,CAAA;AAEpE;",
+  "names": ["createMemo", "createSignal", "onCleanup", "objEqual", "waitUntil", "SharedDataContext", "SharedDataChangeEvent", "useServiceClient", "useNotification", "useLogger", "SharedDataProvider", "props", "serviceClient", "notification", "logger", "configured", "busyCount", "setBusyCount", "busy", "signalMap", "Map", "memoMap", "listenerKeyMap", "versionMap", "accessors", "currentDefinitions", "ordering", "data", "orderByList", "result", "orderBy", "reverse", "selector", "item", "orderByDesc", "loadData", "name", "def", "changeKeys", "currentVersion", "get", "set", "c", "signal", "Error", "setItems", "resData", "fetch", "prev", "filtered", "filter", "includes", "getKey", "push", "err", "error", "danger", "message", "wait", "configure", "definitions", "Object", "entries", "items", "itemMap", "map", "client", "serviceKey", "addEventListener", "then", "key", "undefined", "emit", "emitToServer", "info", "listenerKey", "removeEventListener", "KNOWN_KEYS", "Set", "contextValue", "Proxy", "target", "prop", "has", "_$createComponent", "Provider", "value", "children"]
 }

package/docs/providers.md

@@ -1,212 +1,103 @@
 # Providers
 
-Providers are composable and independent. Compose them at your app root in the recommended order:
+## InitializeProvider
 
-```tsx
-<ConfigProvider clientName="my-app">
-  <SyncStorageProvider storage={...}>     {/* optional */}
-    <LoggerProvider adapter={...}>        {/* optional */}
-      <NotificationProvider>
-        <NotificationBanner />
-        <ErrorLoggerProvider>
-          <PwaUpdateProvider>
-            <ClipboardProvider>
-              <ThemeProvider>
-                <BusyProvider>{/* app content */}</BusyProvider>
-              </ThemeProvider>
-            </ClipboardProvider>
-          </PwaUpdateProvider>
-        </ErrorLoggerProvider>
-      </NotificationProvider>
-    </LoggerProvider>
-  </SyncStorageProvider>
-</ConfigProvider>
-```
-
-## ConfigProvider
-
-Required root provider. Provides `clientName` used as storage key prefix.
+The only exported provider component. Wraps all internal providers in the correct dependency order. Use this to set up your app.
 
 ```tsx
-<ConfigProvider clientName="my-app">
-  {/* app content */}
-</ConfigProvider>
-```
-
-| Prop | Type | Description |
-|------|------|-------------|
-| `clientName` | `string` | Client identifier (used as storage key prefix) |
+import { InitializeProvider } from "@simplysm/solid";
 
----
-
-## SyncStorageProvider
-
-Optional provider for custom sync storage (cross-device sync). When present, `useSyncConfig` uses this storage instead of `localStorage`.
-
-```tsx
-<SyncStorageProvider storage={myStorageAdapter}>
-  {/* children */}
-</SyncStorageProvider>
+<InitializeProvider clientName="my-app">
+  <AppRoot />
+</InitializeProvider>
 ```
 
-| Prop | Type | Description |
-|------|------|-------------|
-| `storage` | `StorageAdapter` | Storage adapter implementation |
-
----
-
-## LoggerProvider
-
-Optional provider for remote logging. When present, `useLogger` sends logs to the adapter instead of `consola`.
+Configuration is done via hooks inside child components:
 
 ```tsx
-<LoggerProvider adapter={myLogAdapter}>
-  {/* children */}
-</LoggerProvider>
-```
-
-| Prop | Type | Description |
-|------|------|-------------|
-| `adapter` | `LogAdapter` | Log adapter implementation |
+function AppRoot() {
+  const serviceClient = useServiceClient();
 
----
-
-## ErrorLoggerProvider
-
-Captures uncaught errors (`window.onerror`) and unhandled promise rejections (`unhandledrejection`) and logs them via `useLogger`.
-
-```tsx
-<ErrorLoggerProvider>
-  {/* children */}
-</ErrorLoggerProvider>
+  onMount(async () => {
+    await serviceClient.connect("main", { port: 3000 });
+    useSyncStorage()!.configure(myStorageAdapter);
+    useLogger().configure(myLogAdapter);
+    useSharedData().configure(definitions);
+  });
+}
 ```
 
----
-
-## PwaUpdateProvider
-
-PWA Service Worker update detection. Polls for SW updates every 5 minutes. When a new version is detected, shows a notification with a reload action. Must be inside `NotificationProvider`.
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `clientName` | `string` | (required) | Client identifier (used as storage key prefix) |
+| `busyVariant` | `BusyVariant` | `"spinner"` | Busy overlay display variant (`"spinner"` or `"bar"`) |
 
-Graceful no-op when `navigator.serviceWorker` is unavailable (HTTP, unsupported browser, dev mode).
+**Internal nesting order:**
 
-```tsx
-<PwaUpdateProvider>
-  {/* children */}
-</PwaUpdateProvider>
 ```
-
----
-
-## ClipboardProvider
-
-Intercepts `Ctrl+C` to copy form control values (input, textarea, select, checkbox) as plain text. Handles table structures as TSV format.
-
-```tsx
-<ClipboardProvider>
-  {/* children */}
-</ClipboardProvider>
+ConfigProvider → SyncStorageProvider → LoggerProvider →
+  NotificationProvider + NotificationBanner →
+    ErrorLoggerProvider → PwaUpdateProvider →
+      ClipboardProvider → ThemeProvider →
+        ServiceClientProvider → SharedDataProvider →
+          BusyProvider → DialogProvider → {children}
 ```
 
----
-
-## ThemeProvider
-
-Dark/light/system theme provider. Toggles the `dark` class on `<html>` and manages theme persistence via `useSyncConfig`.
-
-```tsx
-<ThemeProvider>
-  {/* children */}
-</ThemeProvider>
-```
+Individual providers are not exported. All provider setup goes through `InitializeProvider`.
 
 ---
 
-## ServiceClientProvider
+## Exported Types & Hooks
+
+The following types, context objects, and hooks are exported for use with `InitializeProvider`:
+
+| Export | Kind | Description |
+|--------|------|-------------|
+| `useConfig` | hook | App configuration access |
+| `useTheme` | hook | Theme mode access and toggle |
+| `useSyncStorage` | hook | Sync storage adapter access |
+| `useServiceClient` | hook | WebSocket RPC client access |
+| `useSharedData` | hook | Shared data subscription access |
+| `useNotification` | hook | Notification system access |
+| `useBusy` | hook | Busy overlay control |
+| `useDialog` | hook | Programmatic dialog opening |
+| `ConfigContext` | context | For mock injection in tests |
+| `SyncStorageContext` | context | For mock injection in tests |
+| `ServiceClientContext` | context | For mock injection in tests |
+| `SharedDataContext` | context | For mock injection in tests |
+| `AppConfig` | type | Config context value type |
+| `StorageAdapter` | type | Sync storage adapter interface |
+| `SyncStorageContextValue` | type | Sync storage context value type |
+| `LogAdapter` | type | Log adapter interface |
+| `LoggerContextValue` | type | Logger context value type |
+| `ThemeMode` | type | `"light" \| "dark" \| "system"` |
+| `ResolvedTheme` | type | `"light" \| "dark"` |
+| `ServiceClientContextValue` | type | Service client context value type |
+| `SharedDataDefinition` | type | Data subscription definition |
+| `SharedDataAccessor` | type | Per-key data accessor |
+| `SharedDataValue` | type | Full shared data context value |
+| `BusyVariant` | type | `"spinner" \| "bar"` |
+| `SharedDataChangeEvent` | class | Server-side change event definition |
 
-WebSocket client provider for RPC communication with `@simplysm/service-server`. Wraps `ServiceClient` from `@simplysm/service-client`. Provides `useServiceClient` hook to components.
+---
 
-`ServiceClientProvider` takes no props. After mounting, use `useServiceClient()` to connect, close, and access client instances by key.
+## SharedData Usage
 
 ```tsx
-import { ServiceClientProvider, useServiceClient } from "@simplysm/solid";
-
-// Wrap your app
-<ServiceClientProvider>
-  <App />
-</ServiceClientProvider>
-
-// In a component
-function App() {
-  const client = useServiceClient();
+import { useSharedData } from "@simplysm/solid";
 
-  onMount(async () => {
-    await client.connect("main", { host: "localhost", port: 3000, ssl: false });
-  });
+function MyComponent() {
+  const sharedData = useSharedData<MySharedData>();
 
-  onCleanup(async () => {
-    await client.close("main");
-  });
+  const users = () => sharedData.users.items();           // Accessor<TData[]>
+  const user = () => sharedData.users.get(userId());      // TData | undefined
 
-  const handleCall = async () => {
-    const svc = client.get("main");
-    const result = await svc.call("MyService", "myMethod", [arg1, arg2]);
+  const handleUpdate = async () => {
+    await sharedData.users.emit([updatedUserId]);          // trigger refetch for keys
   };
 }
 ```
 
-**useServiceClient API:**
-
-| Method | Signature | Description |
-|--------|-----------|-------------|
-| `connect` | `(key: string, options?: Partial<ServiceConnectionConfig>) => Promise<void>` | Open WebSocket connection |
-| `close` | `(key: string) => Promise<void>` | Close connection by key |
-| `get` | `(key: string) => ServiceClient` | Get connected client by key (throws if not connected) |
-| `isConnected` | `(key: string) => boolean` | Check connection state |
-
-`ServiceConnectionConfig`: `{ host: string; port: number; ssl: boolean }`
-
-Defaults for `host`, `port`, and `ssl` are derived from `window.location` when omitted.
-
----
-
-## SharedDataProvider
-
-Shared data provider for managing server-side data subscriptions. Works with `ServiceClientProvider` to provide reactive shared data across components via `useSharedData`.
-
-```tsx
-import { SharedDataProvider, type SharedDataDefinition } from "@simplysm/solid";
-
-interface MySharedData {
-  users: UserRecord;
-  products: ProductRecord;
-}
-
-const definitions: { [K in keyof MySharedData]: SharedDataDefinition<MySharedData[K]> } = {
-  users: {
-    serviceKey: "main",
-    fetch: async (changeKeys) => fetchUsers(changeKeys),
-    getKey: (item) => item.id,
-    orderBy: [(item) => item.name, "asc"],
-  },
-  products: {
-    serviceKey: "main",
-    fetch: async (changeKeys) => fetchProducts(changeKeys),
-    getKey: (item) => item.id,
-    orderBy: [(item) => item.name, "asc"],
-  },
-};
-
-<SharedDataProvider definitions={definitions}>
-  <App />
-</SharedDataProvider>
-```
-
-**SharedDataProvider Props:**
-
-| Prop | Type | Description |
-|------|------|-------------|
-| `definitions` | `{ [K in keyof TSharedData]: SharedDataDefinition<TSharedData[K]> }` | Map of data key to fetch definition |
-
 **SharedDataDefinition type:**
 
 ```typescript
@@ -219,23 +110,6 @@ interface SharedDataDefinition<TData> {
 }
 ```
 
-**useSharedData API:**
-
-```tsx
-import { useSharedData } from "@simplysm/solid";
-
-function MyComponent() {
-  const sharedData = useSharedData<MySharedData>();
-
-  const users = () => sharedData.users.items();           // Accessor<TData[]>
-  const user = () => sharedData.users.get(userId());      // TData | undefined
-
-  const handleUpdate = async () => {
-    await sharedData.users.emit([updatedUserId]);          // trigger refetch for keys
-  };
-}
-```
-
 **SharedDataAccessor API:**
 
 | Property/Method | Type | Description |
@@ -250,10 +124,11 @@ function MyComponent() {
 |-----------------|------|-------------|
 | `wait` | `() => Promise<void>` | Wait until all initial fetches complete |
 | `busy` | `Accessor<boolean>` | True while any fetch is in progress |
+| `configure` | `(definitions) => void` | Set up data subscriptions (call once after service client connects) |
 
 **SharedDataChangeEvent:**
 
-`SharedDataChangeEvent` is the event definition used internally by `SharedDataProvider` to communicate data changes between server and clients. Export it if you need to emit changes from the server side.
+`SharedDataChangeEvent` is the event definition used internally to communicate data changes between server and clients. Export it if you need to emit changes from the server side.
 
 ```typescript
 import { SharedDataChangeEvent } from "@simplysm/solid";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/solid",
-  "version": "13.0.34",
+  "version": "13.0.35",
   "description": "심플리즘 패키지 - SolidJS 라이브러리",
   "author": "김석래",
   "license": "Apache-2.0",
@@ -49,8 +49,8 @@
     "solid-tiptap": "^0.8.0",
     "tailwind-merge": "^3.5.0",
     "tailwindcss": "^3.4.19",
-    "@simplysm/core-browser": "13.0.34",
-    "@simplysm/core-common": "13.0.34"
+    "@simplysm/core-browser": "13.0.35",
+    "@simplysm/core-common": "13.0.35"
   },
   "devDependencies": {
     "@solidjs/testing-library": "^0.8.10"