@simplysm/solid 13.0.31 → 13.0.33

package/dist/providers/PwaUpdateProvider.js

@@ -0,0 +1,56 @@
+import { memo as _$memo } from "solid-js/web";
+import { onCleanup } from "solid-js";
+import { useNotification } from "../components/feedback/notification/NotificationContext.js";
+const UPDATE_INTERVAL = 5 * 60 * 1e3;
+const PwaUpdateProvider = (props) => {
+  if (typeof navigator !== "undefined" && "serviceWorker" in navigator) {
+    let promptUpdate2 = function(waitingSW) {
+      notification.info("\uC571\uC774 \uC5C5\uB370\uC774\uD2B8\uB418\uC5C8\uC2B5\uB2C8\uB2E4", "\uC0C8\uB85C\uACE0\uCE68\uD558\uBA74 \uCD5C\uC2E0 \uBC84\uC804\uC744 \uC0AC\uC6A9\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4", {
+        action: {
+          label: "\uC0C8\uB85C\uACE0\uCE68",
+          onClick: () => {
+            waitingSW.postMessage({
+              type: "SKIP_WAITING"
+            });
+          }
+        }
+      });
+    };
+    var promptUpdate = promptUpdate2;
+    const notification = useNotification();
+    let intervalId;
+    void navigator.serviceWorker.getRegistration().then((registration) => {
+      if (registration == null) return;
+      intervalId = setInterval(() => {
+        void registration.update();
+      }, UPDATE_INTERVAL);
+      if (registration.waiting != null) {
+        promptUpdate2(registration.waiting);
+      }
+      registration.addEventListener("updatefound", () => {
+        const newSW = registration.installing;
+        if (newSW == null) return;
+        newSW.addEventListener("statechange", () => {
+          if (newSW.state === "installed" && navigator.serviceWorker.controller != null) {
+            promptUpdate2(newSW);
+          }
+        });
+      });
+    });
+    const onControllerChange = () => {
+      window.location.reload();
+    };
+    navigator.serviceWorker.addEventListener("controllerchange", onControllerChange);
+    onCleanup(() => {
+      if (intervalId != null) {
+        clearInterval(intervalId);
+      }
+      navigator.serviceWorker.removeEventListener("controllerchange", onControllerChange);
+    });
+  }
+  return _$memo(() => props.children);
+};
+export {
+  PwaUpdateProvider
+};
+//# sourceMappingURL=PwaUpdateProvider.js.map

package/dist/providers/PwaUpdateProvider.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/providers/PwaUpdateProvider.tsx"],
+  "mappings": ";AAAA,SAASA,iBAAuC;AAChD,SAASC,uBAAuB;AAEhC,MAAMC,kBAAkB,IAAI,KAAK;AAW1B,MAAMC,oBAAsCC,WAAU;AAC3D,MAAI,OAAOC,cAAc,eAAe,mBAAmBA,WAAW;AAuCpE,QAASC,gBAAT,SAAsBC,WAAgC;AACpDC,mBAAaC,KAAK,uEAAgB,2HAA4B;QAC5DC,QAAQ;UACNC,OAAO;UACPC,SAASA,MAAM;AACbL,sBAAUM,YAAY;cAAEC,MAAM;YAAe,CAAC;UAChD;QACF;MACF,CAAC;IACH;AATSR,uBAAAA;AAtCT,UAAME,eAAeP,gBAAgB;AACrC,QAAIc;AAEJ,SAAKV,UAAUW,cAAcC,gBAAgB,EAAEC,KAAMC,kBAAiB;AACpE,UAAIA,gBAAgB,KAAM;AAE1BJ,mBAAaK,YAAY,MAAM;AAC7B,aAAKD,aAAaE,OAAO;MAC3B,GAAGnB,eAAe;AAElB,UAAIiB,aAAaG,WAAW,MAAM;AAChChB,QAAAA,cAAaa,aAAaG,OAAO;MACnC;AAEAH,mBAAaI,iBAAiB,eAAe,MAAM;AACjD,cAAMC,QAAQL,aAAaM;AAC3B,YAAID,SAAS,KAAM;AAEnBA,cAAMD,iBAAiB,eAAe,MAAM;AAC1C,cAAIC,MAAME,UAAU,eAAerB,UAAUW,cAAcW,cAAc,MAAM;AAC7ErB,YAAAA,cAAakB,KAAK;UACpB;QACF,CAAC;MACH,CAAC;IACH,CAAC;AAED,UAAMI,qBAAqBA,MAAM;AAC/BC,aAAOC,SAASC,OAAO;IACzB;AACA1B,cAAUW,cAAcO,iBAAiB,oBAAoBK,kBAAkB;AAE/E5B,cAAU,MAAM;AACd,UAAIe,cAAc,MAAM;AACtBiB,sBAAcjB,UAAU;MAC1B;AACAV,gBAAUW,cAAciB,oBAAoB,oBAAoBL,kBAAkB;IACpF,CAAC;EAYH;AAEA,SAAAM,OAAA,MAAU9B,MAAM+B,QAAQ;AAC1B;",
+  "names": ["onCleanup", "useNotification", "UPDATE_INTERVAL", "PwaUpdateProvider", "props", "navigator", "promptUpdate", "waitingSW", "notification", "info", "action", "label", "onClick", "postMessage", "type", "intervalId", "serviceWorker", "getRegistration", "then", "registration", "setInterval", "update", "waiting", "addEventListener", "newSW", "installing", "state", "controller", "onControllerChange", "window", "location", "reload", "clearInterval", "removeEventListener", "_$memo", "children"]
+}

package/dist/providers/ServiceClientContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceClientContext.d.ts","sourceRoot":"","sources":["../../src/providers/ServiceClientContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEvF,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;IACpC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC;AAED,eAAO,MAAM,oBAAoB,mEAA6C,CAAC;AAE/E,wBAAgB,gBAAgB,IAAI,yBAAyB,CAQ5D"}
+{"version":3,"file":"ServiceClientContext.d.ts","sourceRoot":"","sources":["../../src/providers/ServiceClientContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEvF,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;IACpC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC;AAED,eAAO,MAAM,oBAAoB,mEAA6C,CAAC;AAE/E,wBAAgB,gBAAgB,IAAI,yBAAyB,CAM5D"}

package/dist/providers/ServiceClientContext.js

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

package/dist/providers/ServiceClientContext.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/providers/ServiceClientContext.ts"],
-  "mappings": "AAAA,SAAS,eAAe,kBAAkB;AAUnC,MAAM,uBAAuB,cAAyC;AAEtE,SAAS,mBAA8C;AAC5D,QAAM,UAAU,WAAW,oBAAoB;AAC/C,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;",
+  "mappings": "AAAA,SAAS,eAAe,kBAAkB;AAUnC,MAAM,uBAAuB,cAAyC;AAEtE,SAAS,mBAA8C;AAC5D,QAAM,UAAU,WAAW,oBAAoB;AAC/C,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,gIAA0D;AAAA,EAC5E;AACA,SAAO;AACT;",
   "names": []
 }

package/dist/providers/SyncStorageContext.d.ts

@@ -0,0 +1,42 @@
+import { type ParentComponent } from "solid-js";
+/**
+ * 커스텀 동기화 저장소 어댑터 인터페이스
+ *
+ * @remarks
+ * - 동기 저장소: `localStorage`, `sessionStorage` 등 그대로 전달 가능
+ * - 비동기 저장소: `getItem`이 `Promise`를 반환하는 구현체 전달
+ */
+export interface StorageAdapter {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<unknown>;
+    removeItem(key: string): void | Promise<void>;
+}
+/**
+ * 동기화 저장소 Context
+ *
+ * @remarks
+ * Provider가 없으면 `undefined` (useSyncConfig에서 localStorage로 fallback)
+ */
+export declare const SyncStorageContext: import("solid-js").Context<StorageAdapter | undefined>;
+/**
+ * 동기화 저장소 Context에 접근하는 훅
+ *
+ * @returns StorageAdapter 또는 undefined (Provider가 없으면)
+ */
+export declare function useSyncStorage(): StorageAdapter | undefined;
+/**
+ * 동기화 저장소 Provider
+ *
+ * @example
+ * ```tsx
+ * <SyncStorageProvider storage={myStorageAdapter}>
+ *   <ThemeProvider>
+ *     <App />
+ *   </ThemeProvider>
+ * </SyncStorageProvider>
+ * ```
+ */
+export declare const SyncStorageProvider: ParentComponent<{
+    storage: StorageAdapter;
+}>;
+//# sourceMappingURL=SyncStorageContext.d.ts.map

package/dist/providers/SyncStorageContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncStorageContext.d.ts","sourceRoot":"","sources":["../../src/providers/SyncStorageContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,wDAAuD,CAAC;AAEvF;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,cAAc,GAAG,SAAS,CAE3D;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAAe,CAAC;IAAE,OAAO,EAAE,cAAc,CAAA;CAAE,CAO5E,CAAC"}

package/dist/providers/SyncStorageContext.js

@@ -0,0 +1,25 @@
+import { createComponent as _$createComponent } from "solid-js/web";
+import { createContext, useContext } from "solid-js";
+const SyncStorageContext = createContext(void 0);
+function useSyncStorage() {
+  return useContext(SyncStorageContext);
+}
+const SyncStorageProvider = (props) => {
+  return (
+    // eslint-disable-next-line solid/reactivity -- storage는 초기 설정값으로 변경되지 않음
+    _$createComponent(SyncStorageContext.Provider, {
+      get value() {
+        return props.storage;
+      },
+      get children() {
+        return props.children;
+      }
+    })
+  );
+};
+export {
+  SyncStorageContext,
+  SyncStorageProvider,
+  useSyncStorage
+};
+//# sourceMappingURL=SyncStorageContext.js.map

package/dist/providers/SyncStorageContext.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/providers/SyncStorageContext.tsx"],
+  "mappings": ";AAAA,SAASA,eAAeC,kBAAwC;AAqBzD,MAAMC,qBAAqBF,cAA0CG,MAAS;AAO9E,SAASC,iBAA6C;AAC3D,SAAOH,WAAWC,kBAAkB;AACtC;AAcO,MAAMG,sBAAqEC,WAAU;AAC1F;;IACEC,kBACCL,mBAAmBM,UAAQ;MAAA,IAACC,QAAK;AAAA,eAAEH,MAAMI;MAAO;MAAA,IAAAC,WAAA;AAAA,eAC9CL,MAAMK;MAAQ;IAAA,CAAA;;AAGrB;",
+  "names": ["createContext", "useContext", "SyncStorageContext", "undefined", "useSyncStorage", "SyncStorageProvider", "props", "_$createComponent", "Provider", "value", "storage", "children"]
+}

package/dist/providers/ThemeContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeContext.d.ts","sourceRoot":"","sources":["../../src/providers/ThemeContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EAIrB,MAAM,UAAU,CAAC;AAIlB;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C,UAAU,iBAAiB;IACzB,yBAAyB;IACzB,IAAI,EAAE,MAAM,SAAS,CAAC;IACtB,eAAe;IACf,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACnC,sCAAsC;IACtC,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,gDAAgD;IAChD,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,IAAI,iBAAiB,CAQ5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,EAAE,eA2C3B,CAAC"}
+{"version":3,"file":"ThemeContext.d.ts","sourceRoot":"","sources":["../../src/providers/ThemeContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EAIrB,MAAM,UAAU,CAAC;AAIlB;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C,UAAU,iBAAiB;IACzB,yBAAyB;IACzB,IAAI,EAAE,MAAM,SAAS,CAAC;IACtB,eAAe;IACf,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACnC,sCAAsC;IACtC,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,gDAAgD;IAChD,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,IAAI,iBAAiB,CAM5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,EAAE,eA2C3B,CAAC"}

package/dist/providers/ThemeContext.js

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

package/dist/providers/ThemeContext.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/providers/ThemeContext.tsx"],
-  "mappings": ";AAAA,SACEA,eACAC,YAEAC,YACAC,cACAC,iBACK;AACP,SAASC,wBAAwB;AACjC,SAASC,qBAAqB;AA0B9B,MAAMC,eAAeP,cAAiC;AAwB/C,SAASQ,WAA8B;AAC5C,QAAMC,UAAUR,WAAWM,YAAY;AACvC,MAAI,CAACE,SAAS;AACZ,UAAM,IAAIC,MACR,uNACF;EACF;AACA,SAAOD;AACT;AAmBO,MAAME,gBAAkCC,WAAU;AACvD,QAAM,CAACC,MAAMC,SAASC,KAAK,IAAIT,cAAyB,SAAS,QAAQ;AAGzE,QAAMU,cAAcX,iBAAiB,8BAA8B;AAGnE,QAAMY,gBAAgBf,WAA0B,MAAM;AACpD,UAAMgB,cAAcL,KAAK;AACzB,QAAIK,gBAAgB,UAAU;AAC5B,aAAOF,YAAY,IAAI,SAAS;IAClC;AACA,WAAOE;EACT,CAAC;AAGD,QAAMC,YAAYA,MAAM;AACtB,UAAMC,UAAUP,KAAK;AACrB,UAAMQ,OACJD,YAAY,UAAU,WAAWA,YAAY,WAAW,SAAS;AACnEN,YAAQO,IAAI;EACd;AAGAlB,eAAa,MAAM;AACjB,QAAI,CAACY,MAAM,EAAG;AACd,UAAMO,SAASL,cAAc,MAAM;AACnCM,aAASC,gBAAgBC,UAAUC,OAAO,QAAQJ,MAAM;EAC1D,CAAC;AAGDlB,YAAU,MAAM;AACdmB,aAASC,gBAAgBC,UAAUE,OAAO,MAAM;EAClD,CAAC;AAED,QAAMC,eAAkC;IACtCf;IACAC;IACAG;IACAE;EACF;AAEA,SAAAU,kBAAQtB,aAAauB,UAAQ;IAACC,OAAOH;IAAY,IAAAI,WAAA;AAAA,aAAGpB,MAAMoB;IAAQ;EAAA,CAAA;AACpE;",
+  "mappings": ";AAAA,SACEA,eACAC,YAEAC,YACAC,cACAC,iBACK;AACP,SAASC,wBAAwB;AACjC,SAASC,qBAAqB;AA0B9B,MAAMC,eAAeP,cAAiC;AAwB/C,SAASQ,WAA8B;AAC5C,QAAMC,UAAUR,WAAWM,YAAY;AACvC,MAAI,CAACE,SAAS;AACZ,UAAM,IAAIC,MAAM,gHAA0C;EAC5D;AACA,SAAOD;AACT;AAmBO,MAAME,gBAAkCC,WAAU;AACvD,QAAM,CAACC,MAAMC,SAASC,KAAK,IAAIT,cAAyB,SAAS,QAAQ;AAGzE,QAAMU,cAAcX,iBAAiB,8BAA8B;AAGnE,QAAMY,gBAAgBf,WAA0B,MAAM;AACpD,UAAMgB,cAAcL,KAAK;AACzB,QAAIK,gBAAgB,UAAU;AAC5B,aAAOF,YAAY,IAAI,SAAS;IAClC;AACA,WAAOE;EACT,CAAC;AAGD,QAAMC,YAAYA,MAAM;AACtB,UAAMC,UAAUP,KAAK;AACrB,UAAMQ,OACJD,YAAY,UAAU,WAAWA,YAAY,WAAW,SAAS;AACnEN,YAAQO,IAAI;EACd;AAGAlB,eAAa,MAAM;AACjB,QAAI,CAACY,MAAM,EAAG;AACd,UAAMO,SAASL,cAAc,MAAM;AACnCM,aAASC,gBAAgBC,UAAUC,OAAO,QAAQJ,MAAM;EAC1D,CAAC;AAGDlB,YAAU,MAAM;AACdmB,aAASC,gBAAgBC,UAAUE,OAAO,MAAM;EAClD,CAAC;AAED,QAAMC,eAAkC;IACtCf;IACAC;IACAG;IACAE;EACF;AAEA,SAAAU,kBAAQtB,aAAauB,UAAQ;IAACC,OAAOH;IAAY,IAAAI,WAAA;AAAA,aAAGpB,MAAMoB;IAAQ;EAAA,CAAA;AACpE;",
   "names": ["createContext", "useContext", "createMemo", "createEffect", "onCleanup", "createMediaQuery", "useSyncConfig", "ThemeContext", "useTheme", "context", "Error", "ThemeProvider", "props", "mode", "setMode", "ready", "prefersDark", "resolvedTheme", "currentMode", "cycleMode", "current", "next", "isDark", "document", "documentElement", "classList", "toggle", "remove", "contextValue", "_$createComponent", "Provider", "value", "children"]
 }

package/docs/disclosure.md

@@ -212,7 +212,7 @@ function MyPage() {
 
 **DialogProvider:**
 
-`DialogProvider` is the provider component that enables `useDialog`. It is automatically included by `InitializeProvider`. Use `DialogProvider` directly only when building a custom provider tree.
+`DialogProvider` is the provider component that enables `useDialog`. Use it in your provider tree to enable programmatic dialogs.
 
 ```tsx
 import { DialogProvider } from "@simplysm/solid";

package/docs/feedback.md

@@ -2,7 +2,7 @@
 
 ## Notification
 
-Notification system. `InitializeProvider` automatically sets up `NotificationProvider` and `NotificationBanner`, so you only need to use the `useNotification` hook and optionally add `NotificationBell` in your layout.
+Notification system. Set up `NotificationProvider` and `NotificationBanner` in your provider tree. Use the `useNotification` hook to show notifications and optionally add `NotificationBell` in your layout.
 
 ```tsx
 import {
@@ -58,14 +58,14 @@ function MyComponent() {
 | `clear` | `() => void` | Clear all |
 
 **Components:**
-- `NotificationBanner` -- Top-of-screen notification banner (automatically included by `InitializeProvider`)
+- `NotificationBanner` -- Top-of-screen notification banner (add inside `NotificationProvider`)
 - `NotificationBell` -- Notification bell icon (shows unread count, add to your layout as needed)
 
 ---
 
 ## Busy
 
-Busy overlay system. `InitializeProvider` automatically sets up `BusyProvider` and `BusyContainer`. Use the `busyVariant` option in `AppConfig` to choose between `"spinner"` (default) and `"bar"` variants. Control the busy state using the `useBusy` hook.
+Busy overlay system. Set up `BusyProvider` in your provider tree. Pass `variant` prop to choose between `"spinner"` (default) and `"bar"` variants. Control the busy state using the `useBusy` hook.
 
 ```tsx
 import { useBusy } from "@simplysm/solid";
@@ -119,7 +119,7 @@ import { BusyContainer } from "@simplysm/solid";
 
 ## Print / usePrint
 
-Browser printing and PDF generation. Must be used inside `InitializeProvider`.
+Browser printing and PDF generation.
 
 ```tsx
 import { Print, usePrint } from "@simplysm/solid";

package/docs/form-controls.md

@@ -589,7 +589,7 @@ import { ColorPicker } from "@simplysm/solid";
 
 ## ThemeToggle
 
-Dark/light/system theme cycle toggle button. Must be used inside `InitializeProvider`.
+Dark/light/system theme cycle toggle button. Must be used inside `ThemeProvider`.
 
 ```tsx
 import { ThemeToggle } from "@simplysm/solid";

package/docs/hooks.md

@@ -1,42 +1,8 @@
 # Hooks
 
-## usePwaUpdate
-
-PWA Service Worker update detection hook. Automatically polls for Service Worker updates every 5 minutes. When a new version is detected, shows a notification with a reload action button.
-
-**Automatic Integration:** Already integrated into `InitializeProvider` -- no manual setup required for most applications. The hook runs automatically inside the notification system.
-
-**Manual Usage (Custom Provider Tree):**
-
-```tsx
-import { usePwaUpdate } from "@simplysm/solid";
-
-function MyProvider(props) {
-  // Must be called inside NotificationProvider
-  usePwaUpdate();
-
-  return (
-    <NotificationProvider>
-      {props.children}
-    </NotificationProvider>
-  );
-}
-```
-
-**Graceful No-ops:** Works safely in the following scenarios where Service Workers are unavailable:
-- HTTP protocol (non-HTTPS dev servers)
-- Browsers that don't support Service Workers
-- Development/test environments without SW registration
-
-**Requirements:**
-- Must be called inside `NotificationProvider` (to display the update notification)
-- `InitializeProvider` already includes both, so manual setup only needed for custom provider trees
-
----
-
 ## useTheme
 
-Hook to access theme (dark/light/system) state. Must be used inside `InitializeProvider`.
+Hook to access theme (dark/light/system) state. Must be used inside `ThemeProvider`.
 
 ```tsx
 import { useTheme } from "@simplysm/solid";
@@ -76,7 +42,7 @@ const [token, setToken] = useLocalStorage<string | undefined>("auth-token", unde
 
 ## useSyncConfig
 
-Syncable config hook. Uses `syncStorage` if configured, falls back to `localStorage` otherwise. Keys are automatically prefixed as `{clientName}.{key}`. Use for user preferences that should sync across devices (theme, DataSheet column configs, filter presets).
+Syncable config hook. Uses `SyncStorageProvider` storage if present, falls back to `localStorage` otherwise. Keys are automatically prefixed as `{clientName}.{key}`. Use for user preferences that should sync across devices (theme, DataSheet column configs, filter presets).
 
 ```tsx
 import { useSyncConfig } from "@simplysm/solid";
@@ -97,7 +63,7 @@ const [theme, setTheme, ready] = useSyncConfig("theme", "light");
 
 ## useLogger
 
-Logging hook. If `logger` adapter is configured in `AppConfig`, logs are sent to the adapter only. Otherwise, logs fall back to `consola`. Must be used inside `InitializeProvider`.
+Logging hook. If `LoggerProvider` is present, logs are sent to the adapter only. Otherwise, logs fall back to `consola`.
 
 ```tsx
 import { useLogger } from "@simplysm/solid";
@@ -116,31 +82,31 @@ logger.warn("deprecation notice");
 | `warn` | `(...args: unknown[]) => void` | Log message (warning) |
 | `error` | `(...args: unknown[]) => void` | Log message (error) |
 
-**Global error capturing:** `InitializeProvider` automatically captures uncaught errors (`window.onerror`) and unhandled promise rejections (`unhandledrejection`) and logs them via `useLogger`. No additional setup required.
+**Global error capturing:** `ErrorLoggerProvider` captures uncaught errors (`window.onerror`) and unhandled promise rejections (`unhandledrejection`) and logs them via `useLogger`.
 
 ---
 
 ## useNotification
 
-Hook to access notification system. Must be used inside `InitializeProvider`. See [Notification](feedback.md#notification) for detailed API.
+Hook to access notification system. Must be used inside `NotificationProvider`. See [Notification](feedback.md#notification) for detailed API.
 
 ---
 
 ## useBusy
 
-Hook to access busy overlay. Must be used inside `InitializeProvider`. See [Busy](feedback.md#busy) for detailed API.
+Hook to access busy overlay. Must be used inside `BusyProvider`. See [Busy](feedback.md#busy) for detailed API.
 
 ---
 
 ## usePrint
 
-Hook for printing and PDF generation. Must be used inside `InitializeProvider`. See [Print / usePrint](feedback.md#print--useprint) for detailed API.
+Hook for printing and PDF generation. See [Print / usePrint](feedback.md#print--useprint) for detailed API.
 
 ---
 
 ## useConfig
 
-Hook to access app-wide configuration. Must be used inside `InitializeProvider`.
+Hook to access app-wide configuration. Must be used inside `ConfigProvider`.
 
 ```tsx
 import { useConfig } from "@simplysm/solid";

package/docs/providers.md

@@ -1,10 +1,123 @@
 # Providers
 
-## InitializeProvider
+Providers are composable and independent. Compose them at your app root in the recommended order:
 
-Root provider that wraps the entire application. Automatically sets up all required providers: configuration context, theme (dark/light/system), notification system with banner, global error capturing (window.onerror, unhandledrejection), busy overlay, programmatic dialog support, and form control clipboard value copy.
+```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.
+
+```tsx
+<ConfigProvider clientName="my-app">
+  {/* app content */}
+</ConfigProvider>
+```
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `clientName` | `string` | Client identifier (used as storage key prefix) |
+
+---
+
+## 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>
+```
+
+| 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`.
+
+```tsx
+<LoggerProvider adapter={myLogAdapter}>
+  {/* children */}
+</LoggerProvider>
+```
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `adapter` | `LogAdapter` | Log adapter implementation |
+
+---
+
+## ErrorLoggerProvider
+
+Captures uncaught errors (`window.onerror`) and unhandled promise rejections (`unhandledrejection`) and logs them via `useLogger`.
+
+```tsx
+<ErrorLoggerProvider>
+  {/* children */}
+</ErrorLoggerProvider>
+```
 
-See the [Configuration](../README.md#configuration) section in the main README for setup instructions and `AppConfig` options.
+---
+
+## 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`.
+
+Graceful no-op when `navigator.serviceWorker` is unavailable (HTTP, unsupported browser, dev mode).
+
+```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>
+```
+
+---
+
+## ThemeProvider
+
+Dark/light/system theme provider. Toggles the `dark` class on `<html>` and manages theme persistence via `useSyncConfig`.
+
+```tsx
+<ThemeProvider>
+  {/* children */}
+</ThemeProvider>
+```
 
 ---
 

package/docs/styling.md

@@ -41,7 +41,7 @@
 
 ## Dark Mode
 
-Uses Tailwind's `class` strategy. `InitializeProvider` automatically toggles the `dark` class on the `<html>` element via the built-in theme provider.
+Uses Tailwind's `class` strategy. `ThemeProvider` automatically toggles the `dark` class on the `<html>` element.
 
 ```html
 <!-- Light mode -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/solid",
-  "version": "13.0.31",
+  "version": "13.0.33",
   "description": "심플리즘 패키지 - SolidJS 라이브러리",
   "author": "김석래",
   "license": "Apache-2.0",
@@ -28,18 +28,18 @@
     "@solid-primitives/storage": "^4.3.3",
     "@solidjs/router": "^0.15.4",
     "@tabler/icons-solidjs": "^3.36.1",
-    "@tiptap/core": "^3.19.0",
-    "@tiptap/extension-color": "^3.19.0",
-    "@tiptap/extension-highlight": "^3.19.0",
-    "@tiptap/extension-image": "^3.19.0",
-    "@tiptap/extension-table": "^3.19.0",
-    "@tiptap/extension-table-cell": "^3.19.0",
-    "@tiptap/extension-table-header": "^3.19.0",
-    "@tiptap/extension-table-row": "^3.19.0",
-    "@tiptap/extension-text-align": "^3.19.0",
-    "@tiptap/extension-text-style": "^3.19.0",
-    "@tiptap/pm": "^3.19.0",
-    "@tiptap/starter-kit": "^3.19.0",
+    "@tiptap/core": "^3.20.0",
+    "@tiptap/extension-color": "^3.20.0",
+    "@tiptap/extension-highlight": "^3.20.0",
+    "@tiptap/extension-image": "^3.20.0",
+    "@tiptap/extension-table": "^3.20.0",
+    "@tiptap/extension-table-cell": "^3.20.0",
+    "@tiptap/extension-table-header": "^3.20.0",
+    "@tiptap/extension-table-row": "^3.20.0",
+    "@tiptap/extension-text-align": "^3.20.0",
+    "@tiptap/extension-text-style": "^3.20.0",
+    "@tiptap/pm": "^3.20.0",
+    "@tiptap/starter-kit": "^3.20.0",
     "bwip-js": "^4.8.0",
     "clsx": "^2.1.1",
     "consola": "^3.4.2",
@@ -47,10 +47,10 @@
     "jspdf": "^4.1.0",
     "solid-js": "^1.9.11",
     "solid-tiptap": "^0.8.0",
-    "tailwind-merge": "^3.4.1",
+    "tailwind-merge": "^3.5.0",
     "tailwindcss": "^3.4.19",
-    "@simplysm/core-browser": "13.0.31",
-    "@simplysm/core-common": "13.0.31"
+    "@simplysm/core-browser": "13.0.33",
+    "@simplysm/core-common": "13.0.33"
   },
   "devDependencies": {
     "@solidjs/testing-library": "^0.8.10"

package/src/hooks/useLogger.ts

@@ -1,5 +1,5 @@
 import { consola } from "consola";
-import { useConfig, type LogAdapter } from "../providers/ConfigContext";
+import { useLogAdapter, type LogAdapter } from "../providers/LoggerContext";
 
 type LogLevel = Parameters<LogAdapter["write"]>[0];
 
@@ -11,12 +11,12 @@ interface Logger {
 }
 
 export function useLogger(): Logger {
-  const config = useConfig();
+  const logAdapter = useLogAdapter();
 
   const createLogFunction = (level: LogLevel) => {
     return (...args: unknown[]) => {
-      if (config.logger) {
-        void config.logger.write(level, ...args);
+      if (logAdapter) {
+        void logAdapter.write(level, ...args);
       } else {
         (consola as any)[level](...args);
       }

package/src/hooks/useSyncConfig.ts

@@ -1,10 +1,11 @@
 import { type Accessor, type Setter, createEffect, createSignal } from "solid-js";
 import { useConfig } from "../providers/ConfigContext";
+import { useSyncStorage } from "../providers/SyncStorageContext";
 
 /**
  * Creates a reactive signal that syncs configuration data to storage.
  *
- * Uses `syncStorage` from ConfigProvider if available, otherwise falls back to `localStorage`.
+ * Uses `SyncStorageProvider` storage if available, otherwise falls back to `localStorage`.
  * Designed for data that should persist and sync across devices (e.g., theme, user preferences, DataSheet configs).
  *
  * @param key - Storage key for the config value
@@ -27,13 +28,14 @@ export function useSyncConfig<TValue>(
   defaultValue: TValue,
 ): [Accessor<TValue>, Setter<TValue>, Accessor<boolean>] {
   const config = useConfig();
+  const syncStorage = useSyncStorage();
   const prefixedKey = `${config.clientName}.${key}`;
   const [value, setValue] = createSignal<TValue>(defaultValue);
   const [ready, setReady] = createSignal(false);
 
   // Initialize from storage
   const initializeFromStorage = async () => {
-    if (!config.syncStorage) {
+    if (!syncStorage) {
       // Use localStorage synchronously
       try {
         const stored = localStorage.getItem(prefixedKey);
@@ -49,7 +51,7 @@ export function useSyncConfig<TValue>(
 
     // Use syncStorage asynchronously
     try {
-      const stored = await config.syncStorage.getItem(prefixedKey);
+      const stored = await syncStorage.getItem(prefixedKey);
       if (stored !== null) {
         setValue(() => JSON.parse(stored) as TValue);
       }
@@ -77,7 +79,7 @@ export function useSyncConfig<TValue>(
     const currentValue = value();
     const serialized = JSON.stringify(currentValue);
 
-    if (!config.syncStorage) {
+    if (!syncStorage) {
       // Use localStorage synchronously
       localStorage.setItem(prefixedKey, serialized);
       return;
@@ -86,7 +88,7 @@ export function useSyncConfig<TValue>(
     // Use syncStorage asynchronously
     void (async () => {
       try {
-        await config.syncStorage!.setItem(prefixedKey, serialized);
+        await syncStorage.setItem(prefixedKey, serialized);
       } catch {
         // Fall back to localStorage on error
         localStorage.setItem(prefixedKey, serialized);

package/src/index.ts

@@ -110,8 +110,12 @@ export * from "./components/feedback/Progress";
 //#region ========== Providers ==========
 
 export * from "./providers/ConfigContext";
-export * from "./providers/InitializeProvider";
-export { useTheme } from "./providers/ThemeContext";
+export * from "./providers/SyncStorageContext";
+export * from "./providers/LoggerContext";
+export * from "./providers/ErrorLoggerProvider";
+export * from "./providers/PwaUpdateProvider";
+export * from "./providers/ClipboardProvider";
+export { useTheme, ThemeProvider } from "./providers/ThemeContext";
 export type { ThemeMode, ResolvedTheme } from "./providers/ThemeContext";
 export * from "./providers/ServiceClientContext";
 export * from "./providers/ServiceClientProvider";
@@ -130,7 +134,6 @@ export * from "./hooks/usePrint";
 export { createControllableSignal } from "./hooks/createControllableSignal";
 export { createIMEHandler } from "./hooks/createIMEHandler";
 export { createMountTransition } from "./hooks/createMountTransition";
-export { usePwaUpdate } from "./hooks/usePwaUpdate";
 export { useRouterLink } from "./hooks/useRouterLink";
 
 //#endregion