@simplysm/angular 14.0.95 → 14.0.97

package/dist/controls/list/sd-list.js

@@ -9,7 +9,7 @@ export class SdList {
         } }, inputs: { inset: [1, "inset"] }, ngContentSelectors: _c0, decls: 1, vars: 0, template: function SdList_Template(rf, ctx) { if (rf & 1) {
             i0.ɵɵprojectionDef();
             i0.ɵɵprojection(0);
-        } }, styles: ["sd-list {\n  display: flex;\n  flex-direction: column;\n  user-select: none;\n  background: var(--control-color);\n  border: 1px solid var(--border-color-default);\n  border-radius: var(--border-radius-default);\n  padding: var(--gap-sm);\n  gap: var(--gap-xs);\n}\nsd-list[data-sd-inset=true] {\n  background: transparent;\n  border: none;\n}\nsd-list[data-sd-inset=true] sd-list {\n  background: transparent;\n}\nsd-list sd-list-item sd-list {\n  border-color: transparent;\n  border-radius: 0;\n  padding: var(--gap-xs);\n  background: transparent;\n}"], encapsulation: 2, changeDetection: 0 });
+        } }, styles: ["sd-list {\n  display: flex;\n  flex-direction: column;\n  user-select: none;\n  background: var(--control-color);\n  border: 1px solid var(--border-color-default);\n  border-radius: var(--border-radius-default);\n  padding: var(--gap-sm);\n  gap: var(--gap-xs);\n}\nsd-list[data-sd-inset=true] {\n  background: transparent;\n  border: none;\n}\nsd-list[data-sd-inset=true] sd-list {\n  background: transparent;\n}\nsd-list sd-list-item sd-list {\n  border-color: transparent;\n  border-radius: 0;\n  padding: 0;\n  background: transparent;\n}"], encapsulation: 2, changeDetection: 0 });
 }
 (() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(SdList, [{
         type: Component,
@@ -17,6 +17,6 @@ export class SdList {
     <ng-content />
   `, host: {
                     "[attr.data-sd-inset]": "inset()",
-                }, styles: ["sd-list {\n  display: flex;\n  flex-direction: column;\n  user-select: none;\n  background: var(--control-color);\n  border: 1px solid var(--border-color-default);\n  border-radius: var(--border-radius-default);\n  padding: var(--gap-sm);\n  gap: var(--gap-xs);\n}\nsd-list[data-sd-inset=true] {\n  background: transparent;\n  border: none;\n}\nsd-list[data-sd-inset=true] sd-list {\n  background: transparent;\n}\nsd-list sd-list-item sd-list {\n  border-color: transparent;\n  border-radius: 0;\n  padding: var(--gap-xs);\n  background: transparent;\n}"] }]
+                }, styles: ["sd-list {\n  display: flex;\n  flex-direction: column;\n  user-select: none;\n  background: var(--control-color);\n  border: 1px solid var(--border-color-default);\n  border-radius: var(--border-radius-default);\n  padding: var(--gap-sm);\n  gap: var(--gap-xs);\n}\nsd-list[data-sd-inset=true] {\n  background: transparent;\n  border: none;\n}\nsd-list[data-sd-inset=true] sd-list {\n  background: transparent;\n}\nsd-list sd-list-item sd-list {\n  border-color: transparent;\n  border-radius: 0;\n  padding: 0;\n  background: transparent;\n}"] }]
     }], null, { inset: [{ type: i0.Input, args: [{ isSignal: true, alias: "inset", required: false }] }] }); })();
 (() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(SdList, { className: "SdList", filePath: "packages/angular/src/controls/list/sd-list.ts", lineNumber: 53 }); })();

package/dist/core/busy/sd-busy.provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sd-busy.provider.d.ts","sourceRoot":"","sources":["../../../src/core/busy/sd-busy.provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;;AAEtD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD,qBACa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAE5D,IAAI,qDAA6B;IACjC,eAAe,iDAAa;IAE5B,OAAO,CAAC,aAAa,CAA4C;IAEjE,IAAI,YAAY,IAAI,YAAY,CAAC,eAAe,CAAC,CAiBhD;;yCA1BU,cAAc;6CAAd,cAAc;CA2C1B"}
+{"version":3,"file":"sd-busy.provider.d.ts","sourceRoot":"","sources":["../../../src/core/busy/sd-busy.provider.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;;AAEtD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD,qBACa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAE5D,IAAI,qDAA6B;IACjC,eAAe,iDAAa;IAE5B,OAAO,CAAC,aAAa,CAA4C;IAEjE,IAAI,YAAY,IAAI,YAAY,CAAC,eAAe,CAAC,CAiBhD;;yCA1BU,cAAc;6CAAd,cAAc;CA8C1B"}

package/dist/core/busy/sd-busy.provider.js

@@ -1,4 +1,5 @@
-import { ApplicationRef, createComponent, effect, EnvironmentInjector, inject, Injectable, signal, } from "@angular/core";
+import { ApplicationRef, createComponent, effect, EnvironmentInjector, inject, Injectable, PLATFORM_ID, signal, } from "@angular/core";
+import { isPlatformBrowser } from "@angular/common";
 import { SdBusyContainer } from "./sd-busy-container";
 import * as i0 from "@angular/core";
 export class SdBusyProvider {
@@ -25,6 +26,9 @@ export class SdBusyProvider {
         return this._containerRef;
     }
     constructor() {
+        // SSR(프리렌더) 가드: busy 오버레이는 document 직접 조작 — 브라우저 전용
+        if (!isPlatformBrowser(inject(PLATFORM_ID)))
+            return;
         effect(() => {
             const busy = this.globalBusyCount() > 0;
             // busy 가 처음 true 가 되기 전엔 컨테이너를 생성하지 않음 (lazy)

package/dist/core/config/sd-local-storage.provider.d.ts

@@ -1,6 +1,8 @@
 import * as i0 from "@angular/core";
 export declare class SdLocalStorageProvider<T> {
     private readonly _sdAngularConfig;
+    /** SSR(프리렌더) 가드: 서버에는 localStorage가 없음 — set/remove는 무동작, get은 "값 없음" */
+    private readonly _isBrowser;
     set<K extends keyof T & string>(key: K, value: T[K]): void;
     get<K extends keyof T & string>(key: K): T[K] | undefined;
     remove(key: keyof T & string): void;

package/dist/core/config/sd-local-storage.provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sd-local-storage.provider.d.ts","sourceRoot":"","sources":["../../../src/core/config/sd-local-storage.provider.ts"],"names":[],"mappings":";AAGA,qBACa,sBAAsB,CAAC,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmC;IAEpE,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAInD,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;IAUzD,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM;yCAjBjB,sBAAsB;6CAAtB,sBAAsB;CAoBlC"}
+{"version":3,"file":"sd-local-storage.provider.d.ts","sourceRoot":"","sources":["../../../src/core/config/sd-local-storage.provider.ts"],"names":[],"mappings":";AAIA,qBACa,sBAAsB,CAAC,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmC;IAEpE,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0C;IAErE,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAKnD,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;IAWzD,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM;yCAtBjB,sBAAsB;6CAAtB,sBAAsB;CA0BlC"}

package/dist/core/config/sd-local-storage.provider.js

@@ -1,12 +1,19 @@
-import { inject, Injectable } from "@angular/core";
+import { inject, Injectable, PLATFORM_ID } from "@angular/core";
+import { isPlatformBrowser } from "@angular/common";
 import { SdAngularConfigProvider } from "./sd-angular-config.provider";
 import * as i0 from "@angular/core";
 export class SdLocalStorageProvider {
     _sdAngularConfig = inject(SdAngularConfigProvider);
+    /** SSR(프리렌더) 가드: 서버에는 localStorage가 없음 — set/remove는 무동작, get은 "값 없음" */
+    _isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
     set(key, value) {
+        if (!this._isBrowser)
+            return;
         localStorage.setItem(`${this._sdAngularConfig.clientName}.${key}`, JSON.stringify(value));
     }
     get(key) {
+        if (!this._isBrowser)
+            return undefined;
         const json = localStorage.getItem(`${this._sdAngularConfig.clientName}.${key}`);
         if (json == null)
             return undefined;
@@ -18,6 +25,8 @@ export class SdLocalStorageProvider {
         }
     }
     remove(key) {
+        if (!this._isBrowser)
+            return;
         localStorage.removeItem(`${this._sdAngularConfig.clientName}.${key}`);
     }
     static ɵfac = function SdLocalStorageProvider_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || SdLocalStorageProvider)(); };

package/dist/core/error-handler/sd-global-error-handler.plugin.d.ts

@@ -3,6 +3,7 @@ import * as i0 from "@angular/core";
 export declare class SdGlobalErrorHandlerPlugin implements ErrorHandler {
     private readonly _envInjector;
     private readonly _sdSystemLog;
+    private readonly _isBrowser;
     private _hasDisplayedError;
     handleError(event: unknown): false | undefined;
     private _displayErrorMessage;

package/dist/core/error-handler/sd-global-error-handler.plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sd-global-error-handler.plugin.d.ts","sourceRoot":"","sources":["../../../src/core/error-handler/sd-global-error-handler.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,EAIb,MAAM,eAAe,CAAC;;AAMvB,qBACa,0BAA2B,YAAW,YAAY;IAC7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAC5D,OAAO,CAAC,kBAAkB,CAAS;IAEnC,WAAW,CAAC,KAAK,EAAE,OAAO;IA0E1B,OAAO,CAAC,oBAAoB;yCA/EjB,0BAA0B;6CAA1B,0BAA0B;CAuHtC"}
+{"version":3,"file":"sd-global-error-handler.plugin.d.ts","sourceRoot":"","sources":["../../../src/core/error-handler/sd-global-error-handler.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,EAKb,MAAM,eAAe,CAAC;;AAOvB,qBACa,0BAA2B,YAAW,YAAY;IAC7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0C;IACrE,OAAO,CAAC,kBAAkB,CAAS;IAEnC,WAAW,CAAC,KAAK,EAAE,OAAO;IAgF1B,OAAO,CAAC,oBAAoB;yCAtFjB,0BAA0B;6CAA1B,0BAA0B;CA8HtC"}

package/dist/core/error-handler/sd-global-error-handler.plugin.js

@@ -1,4 +1,5 @@
-import { ApplicationRef, EnvironmentInjector, ErrorHandler, inject, Injectable, isDevMode, } from "@angular/core";
+import { ApplicationRef, EnvironmentInjector, ErrorHandler, inject, Injectable, isDevMode, PLATFORM_ID, } from "@angular/core";
+import { isPlatformBrowser } from "@angular/common";
 import { createLogger } from "@simplysm/core-common";
 import { SdSystemLogProvider } from "../config/sd-system-log.provider";
 import * as i0 from "@angular/core";
@@ -6,8 +7,14 @@ const logger = createLogger("angular:error-handler");
 export class SdGlobalErrorHandlerPlugin {
     _envInjector = inject(EnvironmentInjector);
     _sdSystemLog = inject(SdSystemLogProvider);
+    _isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
     _hasDisplayedError = false;
     handleError(event) {
+        // SSR(프리렌더) 가드: 서버에는 화면 오버레이·브라우저 전역 이벤트 타입이 없음 — 로그만 남김
+        if (!this._isBrowser) {
+            logger.error(event);
+            return false;
+        }
         try {
             if (event instanceof PromiseRejectionEvent) {
                 const reason = event.reason;

package/dist/core/provideSdAngular.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provideSdAngular.d.ts","sourceRoot":"","sources":["../../src/core/provideSdAngular.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAkC1D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CA4IlF"}
+{"version":3,"file":"provideSdAngular.d.ts","sourceRoot":"","sources":["../../src/core/provideSdAngular.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAmC1D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CAqJlF"}

package/dist/core/provideSdAngular.js

@@ -1,5 +1,5 @@
-import { DestroyRef, effect, EnvironmentInjector, ErrorHandler, inject, makeEnvironmentProviders, provideAppInitializer, provideEnvironmentInitializer, provideZonelessChangeDetection, } from "@angular/core";
-import { IMAGE_CONFIG } from "@angular/common";
+import { DestroyRef, effect, EnvironmentInjector, ErrorHandler, inject, makeEnvironmentProviders, PLATFORM_ID, provideAppInitializer, provideEnvironmentInitializer, provideZonelessChangeDetection, } from "@angular/core";
+import { IMAGE_CONFIG, isPlatformBrowser } from "@angular/common";
 import { EVENT_MANAGER_PLUGINS } from "@angular/platform-browser";
 import { toSignal } from "@angular/core/rxjs-interop";
 import { NavigationCancel, NavigationEnd, NavigationError, NavigationStart, Router, } from "@angular/router";
@@ -27,6 +27,9 @@ export function provideSdAngular(opt) {
             size: "1.33em",
         }),
         provideEnvironmentInitializer(() => {
+            // SSR(프리렌더) 가드: 테마 저장·복원은 브라우저 전용
+            if (!isPlatformBrowser(inject(PLATFORM_ID)))
+                return;
             const sdTheme = inject(SdThemeProvider);
             const sdLocalStorage = inject(SdLocalStorageProvider);
             const savedDark = sdLocalStorage.get("sd-theme-dark");
@@ -55,6 +58,9 @@ export function provideSdAngular(opt) {
             });
         }),
         provideEnvironmentInitializer(() => {
+            // SSR(프리렌더) 가드: window 전역 에러 리스너는 브라우저 전용
+            if (!isPlatformBrowser(inject(PLATFORM_ID)))
+                return;
             const envInjector = inject(EnvironmentInjector);
             const rejectionListener = (event) => {
                 event.preventDefault();
@@ -85,6 +91,9 @@ export function provideSdAngular(opt) {
         { provide: ErrorHandler, useClass: SdGlobalErrorHandlerPlugin },
         provideZonelessChangeDetection(),
         provideAppInitializer(() => {
+            // SSR(프리렌더) 가드: 서비스워커 업데이트 확인은 브라우저 전용
+            if (!isPlatformBrowser(inject(PLATFORM_ID)))
+                return;
             const swUpdate = inject(SwUpdate, { optional: true });
             const destroyRef = inject(DestroyRef);
             let timerId;

package/dist/core/ripple/setupRipple.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setupRipple.d.ts","sourceRoot":"","sources":["../../../src/core/ripple/setupRipple.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CA4E1D"}
+{"version":3,"file":"setupRipple.d.ts","sourceRoot":"","sources":["../../../src/core/ripple/setupRipple.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CA+E1D"}

package/dist/core/ripple/setupRipple.js

@@ -1,5 +1,9 @@
-import { effect, ElementRef, inject } from "@angular/core";
+import { effect, ElementRef, inject, PLATFORM_ID } from "@angular/core";
+import { isPlatformBrowser } from "@angular/common";
 export function setupRipple(enableFn) {
+    // SSR(프리렌더) 가드: 포인터 인터랙션은 브라우저 전용
+    if (!isPlatformBrowser(inject(PLATFORM_ID)))
+        return;
     const elRef = inject(ElementRef);
     effect((onCleanup) => {
         const el = elRef.nativeElement;

package/dist/core/setupBgTheme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setupBgTheme.d.ts","sourceRoot":"","sources":["../../src/core/setupBgTheme.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE;IACrC,KAAK,CAAC,EACF,SAAS,GACT,WAAW,GACX,MAAM,GACN,SAAS,GACT,SAAS,GACT,QAAQ,GACR,MAAM,GACN,WAAW,CAAC;IAChB,SAAS,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACpC,GAAG,IAAI,CAaP"}
+{"version":3,"file":"setupBgTheme.d.ts","sourceRoot":"","sources":["../../src/core/setupBgTheme.ts"],"names":[],"mappings":"AAGA,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE;IACrC,KAAK,CAAC,EACF,SAAS,GACT,WAAW,GACX,MAAM,GACN,SAAS,GACT,SAAS,GACT,QAAQ,GACR,MAAM,GACN,WAAW,CAAC;IAChB,SAAS,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACpC,GAAG,IAAI,CAgBP"}

package/dist/core/setupBgTheme.js

@@ -1,5 +1,9 @@
-import { effect } from "@angular/core";
+import { effect, inject, PLATFORM_ID } from "@angular/core";
+import { isPlatformBrowser } from "@angular/common";
 export function setupBgTheme(options) {
+    // SSR(프리렌더) 가드: document 반영은 브라우저 전용
+    if (!isPlatformBrowser(inject(PLATFORM_ID)))
+        return;
     effect((onCleanup) => {
         document.body.style.setProperty("--background-color", options?.theme
             ? `var(--theme-${options.theme}-${options.lightness ?? "lightest"})`

package/dist/features/theme/sd-theme-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sd-theme-provider.d.ts","sourceRoot":"","sources":["../../../src/features/theme/sd-theme-provider.ts"],"names":[],"mappings":";AAEA,qBACa,eAAe;IAC1B,IAAI,kDAA0B;IAE9B,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAA4B;IAEvE,QAAQ,iDAAsB;;IAY9B,gBAAgB,IAAI,IAAI;IAOxB,gBAAgB,IAAI,IAAI;yCAxBb,eAAe;6CAAf,eAAe;CAoC3B"}
+{"version":3,"file":"sd-theme-provider.d.ts","sourceRoot":"","sources":["../../../src/features/theme/sd-theme-provider.ts"],"names":[],"mappings":";AAGA,qBACa,eAAe;IAC1B,IAAI,kDAA0B;IAE9B,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAA4B;IAEvE,QAAQ,iDAAsB;;IAe9B,gBAAgB,IAAI,IAAI;IAOxB,gBAAgB,IAAI,IAAI;yCA3Bb,eAAe;6CAAf,eAAe;CAuC3B"}

package/dist/features/theme/sd-theme-provider.js

@@ -1,10 +1,14 @@
-import { effect, Injectable, signal } from "@angular/core";
+import { effect, inject, Injectable, PLATFORM_ID, signal } from "@angular/core";
+import { isPlatformBrowser } from "@angular/common";
 import * as i0 from "@angular/core";
 export class SdThemeProvider {
     dark = signal(false, ...(ngDevMode ? [{ debugName: "dark" }] : /* istanbul ignore next */ []));
     fontSizePresets = [12, 14, 16, 20, 24, 28];
     fontSize = signal(12, ...(ngDevMode ? [{ debugName: "fontSize" }] : /* istanbul ignore next */ []));
     constructor() {
+        // SSR(프리렌더) 가드: document 반영은 브라우저 전용
+        if (!isPlatformBrowser(inject(PLATFORM_ID)))
+            return;
         effect(() => {
             document.body.classList.toggle("sd-theme-dark", this.dark());
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/angular",
-  "version": "14.0.95",
+  "version": "14.0.97",
   "description": "심플리즘 패키지 - Angular",
   "author": "심플리즘",
   "license": "Apache-2.0",
@@ -25,12 +25,12 @@
     "./styles.css"
   ],
   "dependencies": {
-    "@angular/animations": "^21.2.16",
-    "@angular/common": "^21.2.16",
-    "@angular/core": "^21.2.16",
-    "@angular/platform-browser": "^21.2.16",
-    "@angular/router": "^21.2.16",
-    "@angular/service-worker": "^21.2.16",
+    "@angular/animations": "^21.2.17",
+    "@angular/common": "^21.2.17",
+    "@angular/core": "^21.2.17",
+    "@angular/platform-browser": "^21.2.17",
+    "@angular/router": "^21.2.17",
+    "@angular/service-worker": "^21.2.17",
     "@ng-icons/core": "^33.2.3",
     "@ng-icons/tabler-icons": "^33.2.3",
     "@tiptap/core": "^3.26.0",
@@ -51,14 +51,14 @@
     "jspdf": "^4.2.1",
     "rxjs": "^7.8.2",
     "tabbable": "^6.4.0",
-    "@simplysm/core-common": "14.0.95",
-    "@simplysm/service-common": "14.0.95",
-    "@simplysm/core-browser": "14.0.95",
-    "@simplysm/service-client": "14.0.95"
+    "@simplysm/core-browser": "14.0.97",
+    "@simplysm/core-common": "14.0.97",
+    "@simplysm/service-client": "14.0.97",
+    "@simplysm/service-common": "14.0.97"
   },
   "devDependencies": {
-    "@angular/compiler": "^21.2.16",
-    "@angular/platform-browser-dynamic": "^21.2.16"
+    "@angular/compiler": "^21.2.17",
+    "@angular/platform-browser-dynamic": "^21.2.17"
   },
   "scripts": {}
 }

package/scss/commons/_variables.scss

@@ -108,12 +108,12 @@ $vars: (
   ),
   border-color: color-map(map.get($colors, gray), 5%),
   border-radius: (
-    xs: var(--gap-xxs),
-    sm: var(--gap-xs),
-    default: var(--gap-sm),
-    lg: var(--gap-default),
-    xl: var(--gap-lg),
-    xxl: var(--gap-xl),
+    xs: var(--gap-xs),
+    sm: var(--gap-sm),
+    default: var(--gap-default),
+    lg: var(--gap-lg),
+    xl: var(--gap-xl),
+    xxl: var(--gap-xxl),
   ),
   z-index: (
     toast: 9999,

package/src/controls/list/sd-list.ts

@@ -40,7 +40,7 @@ import {
         sd-list-item sd-list {
           border-color: transparent;
           border-radius: 0;
-          padding: var(--gap-xs);
+          padding: 0;
           background: transparent;
         }
       }

package/src/core/busy/sd-busy.provider.ts

@@ -5,9 +5,11 @@ import {
   EnvironmentInjector,
   inject,
   Injectable,
+  PLATFORM_ID,
   signal,
   type ComponentRef,
 } from "@angular/core";
+import { isPlatformBrowser } from "@angular/common";
 import { SdBusyContainer } from "./sd-busy-container";
 
 export type SdBusyType = "spinner" | "bar" | "cube";
@@ -42,6 +44,9 @@ export class SdBusyProvider {
   }
 
   constructor() {
+    // SSR(프리렌더) 가드: busy 오버레이는 document 직접 조작 — 브라우저 전용
+    if (!isPlatformBrowser(inject(PLATFORM_ID))) return;
+
     effect(() => {
       const busy = this.globalBusyCount() > 0;
 

package/src/core/config/sd-local-storage.provider.ts

@@ -1,15 +1,21 @@
-import { inject, Injectable } from "@angular/core";
+import { inject, Injectable, PLATFORM_ID } from "@angular/core";
+import { isPlatformBrowser } from "@angular/common";
 import { SdAngularConfigProvider } from "./sd-angular-config.provider";
 
 @Injectable({ providedIn: "root" })
 export class SdLocalStorageProvider<T> {
   private readonly _sdAngularConfig = inject(SdAngularConfigProvider);
 
+  /** SSR(프리렌더) 가드: 서버에는 localStorage가 없음 — set/remove는 무동작, get은 "값 없음" */
+  private readonly _isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
+
   set<K extends keyof T & string>(key: K, value: T[K]) {
+    if (!this._isBrowser) return;
     localStorage.setItem(`${this._sdAngularConfig.clientName}.${key}`, JSON.stringify(value));
   }
 
   get<K extends keyof T & string>(key: K): T[K] | undefined {
+    if (!this._isBrowser) return undefined;
     const json = localStorage.getItem(`${this._sdAngularConfig.clientName}.${key}`);
     if (json == null) return undefined;
     try {
@@ -20,6 +26,7 @@ export class SdLocalStorageProvider<T> {
   }
 
   remove(key: keyof T & string) {
+    if (!this._isBrowser) return;
     localStorage.removeItem(`${this._sdAngularConfig.clientName}.${key}`);
   }
 }

package/src/core/error-handler/sd-global-error-handler.plugin.ts

@@ -5,7 +5,9 @@ import {
   inject,
   Injectable,
   isDevMode,
+  PLATFORM_ID,
 } from "@angular/core";
+import { isPlatformBrowser } from "@angular/common";
 import { createLogger } from "@simplysm/core-common";
 import { SdSystemLogProvider } from "../config/sd-system-log.provider";
 
@@ -15,9 +17,16 @@ const logger = createLogger("angular:error-handler");
 export class SdGlobalErrorHandlerPlugin implements ErrorHandler {
   private readonly _envInjector = inject(EnvironmentInjector);
   private readonly _sdSystemLog = inject(SdSystemLogProvider);
+  private readonly _isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
   private _hasDisplayedError = false;
 
   handleError(event: unknown) {
+    // SSR(프리렌더) 가드: 서버에는 화면 오버레이·브라우저 전역 이벤트 타입이 없음 — 로그만 남김
+    if (!this._isBrowser) {
+      logger.error(event);
+      return false;
+    }
+
     try {
       if (event instanceof PromiseRejectionEvent) {
         const reason = event.reason;

package/src/core/provideSdAngular.ts

@@ -6,11 +6,12 @@ import {
   ErrorHandler,
   inject,
   makeEnvironmentProviders,
+  PLATFORM_ID,
   provideAppInitializer,
   provideEnvironmentInitializer,
   provideZonelessChangeDetection,
 } from "@angular/core";
-import { IMAGE_CONFIG } from "@angular/common";
+import { IMAGE_CONFIG, isPlatformBrowser } from "@angular/common";
 import { EVENT_MANAGER_PLUGINS } from "@angular/platform-browser";
 import { toSignal } from "@angular/core/rxjs-interop";
 import {
@@ -46,6 +47,9 @@ export function provideSdAngular(opt: { clientName: string }): EnvironmentProvid
       size: "1.33em",
     }),
     provideEnvironmentInitializer(() => {
+      // SSR(프리렌더) 가드: 테마 저장·복원은 브라우저 전용
+      if (!isPlatformBrowser(inject(PLATFORM_ID))) return;
+
       const sdTheme = inject(SdThemeProvider);
       const sdLocalStorage = inject(SdLocalStorageProvider);
 
@@ -78,6 +82,9 @@ export function provideSdAngular(opt: { clientName: string }): EnvironmentProvid
       });
     }),
     provideEnvironmentInitializer(() => {
+      // SSR(프리렌더) 가드: window 전역 에러 리스너는 브라우저 전용
+      if (!isPlatformBrowser(inject(PLATFORM_ID))) return;
+
       const envInjector = inject(EnvironmentInjector);
 
       const rejectionListener = (event: PromiseRejectionEvent) => {
@@ -111,6 +118,9 @@ export function provideSdAngular(opt: { clientName: string }): EnvironmentProvid
     { provide: ErrorHandler, useClass: SdGlobalErrorHandlerPlugin },
     provideZonelessChangeDetection(),
     provideAppInitializer(() => {
+      // SSR(프리렌더) 가드: 서비스워커 업데이트 확인은 브라우저 전용
+      if (!isPlatformBrowser(inject(PLATFORM_ID))) return;
+
       const swUpdate = inject(SwUpdate, { optional: true });
       const destroyRef = inject(DestroyRef);
       let timerId: ReturnType<typeof setTimeout> | undefined;

package/src/core/ripple/setupRipple.ts

@@ -1,6 +1,10 @@
-import { effect, ElementRef, inject } from "@angular/core";
+import { effect, ElementRef, inject, PLATFORM_ID } from "@angular/core";
+import { isPlatformBrowser } from "@angular/common";
 
 export function setupRipple(enableFn?: () => boolean): void {
+  // SSR(프리렌더) 가드: 포인터 인터랙션은 브라우저 전용
+  if (!isPlatformBrowser(inject(PLATFORM_ID))) return;
+
   const elRef = inject<ElementRef<HTMLElement>>(ElementRef);
 
   effect((onCleanup) => {

package/src/core/setupBgTheme.ts

@@ -1,4 +1,5 @@
-import { effect } from "@angular/core";
+import { effect, inject, PLATFORM_ID } from "@angular/core";
+import { isPlatformBrowser } from "@angular/common";
 
 export function setupBgTheme(options?: {
   theme?:
@@ -12,6 +13,9 @@ export function setupBgTheme(options?: {
     | "blue-gray";
   lightness?: "lightest" | "lighter";
 }): void {
+  // SSR(프리렌더) 가드: document 반영은 브라우저 전용
+  if (!isPlatformBrowser(inject(PLATFORM_ID))) return;
+
   effect((onCleanup) => {
     document.body.style.setProperty(
       "--background-color",

package/src/features/theme/sd-theme-provider.ts

@@ -1,4 +1,5 @@
-import { effect, Injectable, signal } from "@angular/core";
+import { effect, inject, Injectable, PLATFORM_ID, signal } from "@angular/core";
+import { isPlatformBrowser } from "@angular/common";
 
 @Injectable({ providedIn: "root" })
 export class SdThemeProvider {
@@ -9,6 +10,9 @@ export class SdThemeProvider {
   fontSize = signal<number>(12);
 
   constructor() {
+    // SSR(프리렌더) 가드: document 반영은 브라우저 전용
+    if (!isPlatformBrowser(inject(PLATFORM_ID))) return;
+
     effect(() => {
       document.body.classList.toggle("sd-theme-dark", this.dark());
     });

package/styles.css

@@ -123,12 +123,12 @@
     --border-color-dark: rgb(143.832095864, 152.5551796582, 167.5152083098);
     --border-color-darker: rgb(116.3216443464, 127.2034085228, 145.8655591685);
     --border-color-darkest: rgb(93.8151462793, 103.169427936, 119.2119565765);
-    --border-radius-xs: var(--gap-xxs);
-    --border-radius-sm: var(--gap-xs);
-    --border-radius-default: var(--gap-sm);
-    --border-radius-lg: var(--gap-default);
-    --border-radius-xl: var(--gap-lg);
-    --border-radius-xxl: var(--gap-xl);
+    --border-radius-xs: var(--gap-xs);
+    --border-radius-sm: var(--gap-sm);
+    --border-radius-default: var(--gap-default);
+    --border-radius-lg: var(--gap-lg);
+    --border-radius-xl: var(--gap-xl);
+    --border-radius-xxl: var(--gap-xxl);
     --z-index-toast: 9999;
     --z-index-busy: 9998;
     --z-index-dropdown: 5000;