@ncds/ui-admin 1.8.25 → 1.8.26-alpha.0

package/dist/temp/src/utils/index.d.ts

@@ -1,2 +1,3 @@
 export * from './date-picker';
 export * from './dropdown';
+export * from './url';

package/dist/temp/src/utils/index.js

@@ -2,3 +2,5 @@
 export * from './date-picker';
 // 드롭다운 관련 utils
 export * from './dropdown';
+// URL 관련 utils
+export * from './url';

package/dist/temp/src/utils/url/__tests__/isSafeUrl.test.js

@@ -0,0 +1,61 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { isSafeUrl } from '../isSafeUrl';
+/**
+ * 알림 텍스트 링크(`supportTextLink`)의 href 허용 여부.
+ * React·Vanilla 가 이 함수 하나를 공유한다 (#538 리뷰 H2).
+ *
+ * 이 파일은 vitest 기본 환경(node)에서 돈다 — `window` 가 없는 SSR 상황 자체가 검증 대상이다.
+ */
+const SAFE = [
+    'https://example.com/notice/1',
+    'http://example.com',
+    'HTTPS://EXAMPLE.COM',
+    '/notice/1',
+    'notice/1',
+    '../notice',
+    '?page=2',
+    '#section',
+    '  https://example.com  ',
+];
+const UNSAFE = [
+    'javascript:alert(1)',
+    'JavaScript:alert(1)',
+    ' JavaScript:alert(1)',
+    '\tjavascript:alert(1)',
+    'java\nscript:alert(1)',
+    'data:text/html,<script>alert(1)</script>',
+    'DATA:text/html;base64,PHNjcmlwdD4=',
+    'vbscript:msgbox(1)',
+    'file:///etc/passwd',
+    'mailto:a@example.com',
+    'http://',
+];
+describe('isSafeUrl — window 없음(SSR)', () => {
+    it('window 가 정의되지 않은 환경이다', () => {
+        expect(typeof window).toBe('undefined');
+    });
+    it.each(SAFE)('허용: %j', (url) => {
+        expect(isSafeUrl(url)).toBe(true);
+    });
+    it.each(UNSAFE)('차단: %j', (url) => {
+        expect(isSafeUrl(url)).toBe(false);
+    });
+    it('빈 문자열은 차단한다', () => {
+        expect(isSafeUrl('')).toBe(false);
+    });
+});
+describe('isSafeUrl — window 존재', () => {
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    it('현재 origin 기준으로 상대경로를 해석해 허용한다', () => {
+        vi.stubGlobal('window', { location: { origin: 'https://admin.example.com' } });
+        expect(isSafeUrl('/notice/1')).toBe(true);
+        expect(isSafeUrl('javascript:alert(1)')).toBe(false);
+    });
+    it('origin 이 "null"(about:blank·sandbox iframe)이어도 상대경로를 허용한다', () => {
+        vi.stubGlobal('window', { location: { origin: 'null' } });
+        expect(isSafeUrl('/notice/1')).toBe(true);
+        expect(isSafeUrl(' JavaScript:alert(1)')).toBe(false);
+    });
+});

package/dist/temp/src/utils/url/index.d.ts

@@ -0,0 +1 @@
+export * from './isSafeUrl';

package/dist/temp/src/utils/url/index.js

@@ -0,0 +1 @@
+export * from './isSafeUrl';

package/dist/temp/src/utils/url/isSafeUrl.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 링크 href 로 넣어도 안전한 URL 인지 판정한다. http/https 및 상대경로만 허용한다.
+ * javascript:, data:, file: 등 위험 프로토콜로 인한 XSS / 외부 페이로드 로딩을 차단.
+ *
+ * URL 파서가 앞뒤 공백·탭·개행 제거와 scheme 소문자화를 하므로 ` JavaScript:` 같은 우회도 막힌다.
+ * React(`MessageNotificationParts`·`FullWidthNotification`)와 Vanilla(`renderSupportingText`)가 공유한다.
+ */
+export declare function isSafeUrl(url: string): boolean;

package/dist/temp/src/utils/url/isSafeUrl.js

@@ -0,0 +1,29 @@
+/**
+ * 상대경로 해석용 기본 origin. `window` 가 없거나(SSR) origin 이 불투명(`"null"` — about:blank,
+ * sandbox iframe)일 때 쓴다. 판정은 프로토콜만 보므로 실제 호스트와 무관하다.
+ */
+const FALLBACK_ORIGIN = 'http://localhost';
+function resolveBaseOrigin() {
+    if (typeof window === 'undefined')
+        return FALLBACK_ORIGIN;
+    const origin = window.location?.origin;
+    return origin && origin !== 'null' ? origin : FALLBACK_ORIGIN;
+}
+/**
+ * 링크 href 로 넣어도 안전한 URL 인지 판정한다. http/https 및 상대경로만 허용한다.
+ * javascript:, data:, file: 등 위험 프로토콜로 인한 XSS / 외부 페이로드 로딩을 차단.
+ *
+ * URL 파서가 앞뒤 공백·탭·개행 제거와 scheme 소문자화를 하므로 ` JavaScript:` 같은 우회도 막힌다.
+ * React(`MessageNotificationParts`·`FullWidthNotification`)와 Vanilla(`renderSupportingText`)가 공유한다.
+ */
+export function isSafeUrl(url) {
+    if (!url.trim())
+        return false;
+    try {
+        const parsed = new URL(url, resolveBaseOrigin());
+        return parsed.protocol === 'http:' || parsed.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}

package/dist/types/assets/scripts/notification/MessageNotification.d.ts

@@ -9,6 +9,8 @@ export declare class MessageNotification {
     private featuredIcon?;
     constructor(options: MessageNotificationOptions);
     private createElement;
+    /** 색상별 FeaturedIcon. default 는 md(40/20), block 은 sm(32/16). */
+    private createFeaturedIcon;
     private bindEvents;
     private setupAutoClose;
     getElement(): HTMLElement;

package/dist/types/assets/scripts/notification/const/classNames.d.ts

@@ -8,6 +8,7 @@ export declare const CLASS_NAMES: {
         readonly TEXT_CONTAINER: "ncua-full-width-notification__text-container";
         readonly TITLE: "ncua-full-width-notification__title";
         readonly SUPPORTING_TEXT: "ncua-full-width-notification__supporting-text";
+        readonly LINK: "ncua-full-width-notification__link";
         readonly ACTIONS_CONTAINER: "ncua-full-width-notification__actions-container";
         readonly ACTIONS: "ncua-full-width-notification__actions";
         readonly CLOSE_BUTTON: "ncua-full-width-notification__close-button";
@@ -25,6 +26,7 @@ export declare const CLASS_NAMES: {
     };
     readonly MESSAGE: {
         readonly BASE: "ncua-message-notification";
+        readonly BLOCK: "ncua-message-notification--block";
         readonly CONTAINER: "ncua-message-notification__container";
         readonly CONTENT: "ncua-message-notification__content";
         readonly CONTENT_WRAPPER: "ncua-message-notification__content-wrapper";
@@ -32,6 +34,7 @@ export declare const CLASS_NAMES: {
         readonly TEXT_CONTAINER: "ncua-message-notification__text-container";
         readonly TITLE: "ncua-message-notification__title";
         readonly SUPPORTING_TEXT: "ncua-message-notification__supporting-text";
+        readonly LINK: "ncua-message-notification__link";
         readonly ACTIONS_CONTAINER: "ncua-message-notification__actions-container";
         readonly ACTIONS: "ncua-message-notification__actions";
         readonly FOOTER_CONTAINER: "ncua-message-notification__footer-container";

package/dist/types/assets/scripts/notification/const/icons.d.ts

@@ -23,3 +23,9 @@ export declare const ICON_MAP: {
     readonly success: (size: string) => string;
     readonly info: (size: string) => string;
 };
+/**
+ * message 타입 아이콘. floating 과 같은 4색에 block 변형 전용 info 를 더한다.
+ * `SVG_ICONS['info-circle']`은 full-width 전용 class·color 가 박혀 있어 쓰지 않는다
+ * (`.ncua-full-width-notification__icon`은 모바일에서 숨겨진다).
+ */
+export declare const MESSAGE_ICON_MAP: Partial<Record<NotificationColor, (size: string) => string>>;

package/dist/types/assets/scripts/notification/const/index.d.ts

@@ -1,5 +1,4 @@
 export { CLASS_NAMES } from './classNames';
-export { FLOATING_ICON_MAP, FULL_WIDTH_ICON_MAP, ICON_MAP, SVG_ICONS } from './icons';
-export { CLOSE_BUTTON_SIZES, CLOSE_BUTTON_SVG_SIZES, FEATURED_ICON_SIZES, FULL_WIDTH_SIZES, getSizes, ICON_PIXEL_SIZES, MESSAGE_SIZES, } from './sizes';
-export type { BaseNotificationOptions, LegacyNotificationHierarchy, NotificationAction, NotificationActionButtonSize, NotificationColor, NotificationHierarchy, } from './types';
-export { MESSAGE_CLOSE_ICON_COLORS } from './types';
+export { FLOATING_ICON_MAP, FULL_WIDTH_ICON_MAP, ICON_MAP, MESSAGE_ICON_MAP, SVG_ICONS } from './icons';
+export { CLOSE_BUTTON_SIZES, CLOSE_BUTTON_SVG_SIZES, FEATURED_ICON_SIZES, FULL_WIDTH_SIZES, getSizes, ICON_PIXEL_SIZES, MESSAGE_BLOCK_SIZES, MESSAGE_SIZES, } from './sizes';
+export type { BaseNotificationOptions, LegacyNotificationHierarchy, NotificationAction, NotificationActionButtonSize, NotificationColor, NotificationHierarchy, NotificationLinkTarget, NotificationVariant, } from './types';

package/dist/types/assets/scripts/notification/const/sizes.d.ts

@@ -24,6 +24,10 @@ export declare const MESSAGE_SIZES: {
     readonly ICON_PIXEL: "20";
     readonly CLOSE_BUTTON: "20";
 };
+export declare const MESSAGE_BLOCK_SIZES: {
+    readonly FEATURED_ICON: "sm";
+    readonly ICON_PIXEL: "16";
+};
 export declare const getSizes: {
     readonly featuredIcon: (isMobile: boolean) => "sm" | "md";
     readonly iconPixel: (isMobile: boolean) => "20" | "16";

package/dist/types/assets/scripts/notification/const/types.d.ts

@@ -1,4 +1,16 @@
 export type NotificationColor = 'neutral' | 'error' | 'warning' | 'success' | 'info';
+/**
+ * message 타입의 표시 변형. React `NotificationVariant`와 같은 어휘다.
+ * - `'default'`: 기존 message
+ * - `'block'`: 서브 페이지 공지용 (흰 배경, FeaturedIcon sm, 제목 + 텍스트 링크 1행, info 유지)
+ */
+export type NotificationVariant = 'default' | 'block';
+/**
+ * 텍스트 링크(`supportTextLink`)를 여는 대상. React `NotificationLinkTarget`과 같은 어휘다.
+ * - `'_self'`: 같은 탭 (target·rel 미부여)
+ * - `'_blank'`: 새 탭 (`target="_blank"` + `rel="noopener noreferrer"`)
+ */
+export type NotificationLinkTarget = '_self' | '_blank';
 /**
  * 알림 액션 버튼(`ncua-btn`)의 색상 수식자.
  * React `NotificationAction.hierarchy`와 동일한 어휘를 쓴다 — `ButtonTheme`의 부분집합이다.
@@ -31,7 +43,23 @@ export interface BaseNotificationOptions {
     className?: string;
     actions?: NotificationAction[];
     autoClose?: number;
+    /**
+     * supportingText에 대한 링크 URL. full-width 타입, message 타입의 `variant: 'block'`에서 사용 가능.
+     * http/https 만 허용되며 그 외 프로토콜은 링크 없이 텍스트만 렌더된다.
+     */
     supportTextLink?: string;
+    /**
+     * 텍스트 링크를 여는 대상. `supportTextLink`가 렌더될 때만 동작한다.
+     * `'_blank'`이면 새 탭으로 열고 `rel="noopener noreferrer"`를 함께 붙인다.
+     * `'_blank'`가 아닌 값은 모두 `'_self'`(같은 탭)로 취급한다.
+     * @default '_self'
+     */
+    supportTextLinkTarget?: NotificationLinkTarget;
+    /**
+     * message 타입의 표시 변형. message 타입에서만 동작한다.
+     * @default 'default'
+     */
+    variant?: NotificationVariant;
     onHidePermanently?: () => void;
     /**
      * 다시보지 않기 버튼의 라벨. full-width, message 타입에서 사용 가능하며
@@ -44,4 +72,3 @@ export interface BaseNotificationOptions {
      */
     hidePermanentlyLabel?: string;
 }
-export declare const MESSAGE_CLOSE_ICON_COLORS: Record<NotificationColor, string>;

package/dist/types/assets/scripts/notification/messageTemplate.d.ts

@@ -1,7 +1,11 @@
-import type { NotificationAction } from './const';
+import type { NotificationAction, NotificationColor } from './const';
 export interface MessageTemplateParams {
     title: string;
     supportingText?: string;
+    /** 지정 시 `supportingText`를 텍스트 링크로 렌더한다 (block 변형 전용, http/https 만 허용). */
+    supportTextLink?: string;
+    /** 닫기 아이콘 색 결정용. 미지정 시 neutral. */
+    color?: NotificationColor;
     actions?: NotificationAction[];
     onClose?: () => void;
     onHidePermanently?: () => void;

package/dist/types/assets/scripts/notification/utils.d.ts

@@ -1,7 +1,15 @@
 import type { LegacyNotificationHierarchy, NotificationAction, NotificationActionButtonSize, NotificationColor, NotificationHierarchy } from './const';
 export declare function createWrapperElement(baseClass: string, color: NotificationColor, className?: string): HTMLElement;
 export declare function buildClassName(baseClass: string, color: NotificationColor, className?: string): string;
-export declare function renderSupportingText(supportingText?: string, className?: string, supportTextLink?: string): string;
+export declare function renderSupportingText(supportingText?: string, className?: string, supportTextLink?: string, linkClassName?: string): string;
+/**
+ * `supportTextLinkTarget`이 `'_blank'`이면 `renderSupportingText`가 만든 링크를 새 탭으로 연다.
+ *
+ * target 은 sanitize **이후** 우리가 만든 링크(텍스트 컨테이너의 직계 `<a>`)에만 지정한다.
+ * DOMPurify 에 target 을 전역 허용하면 사용자 입력 HTML 의 `<a target>`까지 rel 없이 통과하기 때문이다.
+ * 런타임 입력이므로 `'_blank'`가 아닌 값은 전부 `'_self'`(속성 미부여)로 취급한다.
+ */
+export declare function applySupportTextLinkTarget(root: HTMLElement, textContainerClassName: string, linkClassName: string, target: unknown): void;
 /**
  * 액션 버튼의 색상 수식자를 현행 어휘로 정규화한다.
  *
@@ -16,8 +24,7 @@ export declare function resolveActionHierarchy(hierarchy?: NotificationHierarchy
 /**
  * 액션 버튼 그룹 HTML을 만든다.
  *
- * `size` 기본값 'sm'은 floating / full-width 타입의 기존 렌더링을 그대로 보존하기 위한 것이다.
- * message 타입만 TO-BE 규격(28px)에 맞춰 'xs'를 넘긴다 — React `<Button size="xs">`와 동일.
+ * `size` 기본값 'xs'는 디자인 기준(#535 — 모든 type 액션 버튼 xs)이며 React `<Button size="xs">`와 같다.
  */
 export declare function renderActions(actions: NotificationAction[], wrapperClass: string, size?: NotificationActionButtonSize): string;
 export declare function bindNotificationEvents(element: HTMLElement, actions: NotificationAction[], onClose?: () => void, onRemove?: () => void): void;

package/dist/types/constant/notification.d.ts

@@ -13,3 +13,16 @@ export declare const HIDE_PERMANENTLY_LABEL: {
     readonly message: "다시 보지 않기";
     readonly fullWidth: "다시보지 않기";
 };
+/**
+ * message 타입 닫기(X) 아이콘의 color 별 색.
+ *
+ * React(`MessageNotification.tsx`)와 Vanilla(`messageTemplate.ts`)가 함께 참조하는 단일 출처다.
+ * `info`는 `variant: 'block'`에서만 렌더된다(default 는 neutral 로 폴백).
+ */
+export declare const MESSAGE_CLOSE_ICON_COLOR: {
+    readonly neutral: string;
+    readonly error: string;
+    readonly warning: string;
+    readonly success: string;
+    readonly info: string;
+};

package/dist/types/src/components/feedback-and-status/badge/Badge.d.ts

@@ -16,4 +16,4 @@ type BadgeProps = {
 };
 declare const Badge: ({ label, type, color, className, leadingIcon, trailingIcon, size, }: BadgeProps) => import("react/jsx-runtime").JSX.Element;
 export { Badge };
-export type { BadgeType, BadgeColor, BadgeSize, BadgeProps };
+export type { BadgeColor, BadgeProps, BadgeSize, BadgeType };

package/dist/types/src/components/forms-and-input/combo-box/ComboBox.d.ts

@@ -10,7 +10,7 @@ interface ComboBoxProps extends Omit<ComponentPropsWithRef<'div'>, 'size' | 'onC
     destructive?: boolean;
     size?: Extract<Size, 'xs' | 'sm'>;
     optionItems?: OptionType[];
-    value?: OptionValue | null;
+    value?: OptionValue;
     onChange?: OptionChangeHandler;
     onSearch?: (searchValue: string) => void;
     disabled?: boolean;

package/dist/types/src/components/overlays/notification/FullWidthNotification.d.ts

@@ -1,5 +1,5 @@
 import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
-import type { NotificationAction, NotificationColor } from './Notification';
+import type { NotificationAction, NotificationColor, NotificationLinkTarget } from './Notification';
 interface FullWidthNotificationProps extends Omit<ComponentPropsWithoutRef<'div'>, 'title'> {
     /**
      * 알림 제목 텍스트
@@ -36,6 +36,11 @@ interface FullWidthNotificationProps extends Omit<ComponentPropsWithoutRef<'div'
      * info 링크 영역 (선택사항)
      */
     supportTextLink?: string;
+    /**
+     * 텍스트 링크를 여는 대상 (선택사항). `'_blank'`이면 새 탭 + `rel="noopener noreferrer"`
+     * @default '_self'
+     */
+    supportTextLinkTarget?: NotificationLinkTarget;
     /**
      * 다시보지 않기 이벤트 핸들러 (선택사항)
      */

package/dist/types/src/components/overlays/notification/MessageNotification.d.ts

@@ -1,6 +1,6 @@
 import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
 import type { SlotIconComponent } from '../../../types/side-slot';
-import type { NotificationAction, NotificationColor } from './Notification';
+import type { NotificationAction, NotificationColor, NotificationLinkTarget, NotificationVariant } from './Notification';
 interface MessageNotificationProps extends Omit<ComponentPropsWithoutRef<'div'>, 'title'> {
     /**
      * 알림 제목 텍스트
@@ -41,6 +41,20 @@ interface MessageNotificationProps extends Omit<ComponentPropsWithoutRef<'div'>,
      * @default '다시 보지 않기'
      */
     hidePermanentlyLabel?: ReactNode;
+    /**
+     * 표시 변형. `'block'`은 서브 페이지 공지용(흰 배경, FeaturedIcon sm, 제목 + 텍스트 링크 1행, info 유지)
+     * @default 'default'
+     */
+    variant?: NotificationVariant;
+    /**
+     * 텍스트 링크 URL. `variant="block"`에서만 동작하며 `supportingText`가 링크 텍스트가 된다.
+     */
+    supportTextLink?: string;
+    /**
+     * 텍스트 링크를 여는 대상. `'_blank'`이면 새 탭 + `rel="noopener noreferrer"`
+     * @default '_self'
+     */
+    supportTextLinkTarget?: NotificationLinkTarget;
 }
 declare const MessageNotification: import("react").ForwardRefExoticComponent<MessageNotificationProps & import("react").RefAttributes<HTMLDivElement>>;
 export type { MessageNotificationProps };

package/dist/types/src/components/overlays/notification/MessageNotificationParts.d.ts

@@ -1,16 +1,21 @@
 import type { ReactNode } from 'react';
 import type { SlotIconComponent } from '../../../types/side-slot';
-import { type FeaturedIconColor } from '../../image-and-icons/featured-icon/FeaturedIcon';
-import type { NotificationAction } from './Notification';
+import { type FeaturedIconColor, type FeaturedIconSize } from '../../image-and-icons/featured-icon/FeaturedIcon';
+import type { NotificationAction, NotificationLinkTarget } from './Notification';
 interface MessageNotificationContentProps {
     title: ReactNode;
     supportingText?: ReactNode;
+    /** 지정 시 `supportingText`를 이 URL 의 텍스트 링크로 렌더한다 (block 변형 전용). http/https·상대경로가 아니면 텍스트만 렌더. */
+    supportTextLink?: string;
+    /** 텍스트 링크를 여는 대상. `'_blank'`이면 새 탭 + `rel="noopener noreferrer"`. */
+    supportTextLinkTarget?: NotificationLinkTarget;
     icon?: SlotIconComponent;
     iconColor: FeaturedIconColor;
-    showIcon: boolean;
+    /** default 는 md(40/20), block 은 sm(32/16). */
+    iconSize: FeaturedIconSize;
 }
-/** 아이콘 + 제목/서포팅 텍스트 영역. */
-declare const MessageNotificationContent: ({ title, supportingText, icon, iconColor, showIcon, }: MessageNotificationContentProps) => import("react/jsx-runtime").JSX.Element;
+/** 아이콘 + 제목/서포팅 텍스트(또는 텍스트 링크) 영역. */
+declare const MessageNotificationContent: ({ title, supportingText, supportTextLink, supportTextLinkTarget, icon, iconColor, iconSize, }: MessageNotificationContentProps) => import("react/jsx-runtime").JSX.Element;
 interface MessageNotificationActionsProps {
     actions?: NotificationAction[];
     onClose?: () => void;

package/dist/types/src/components/overlays/notification/Notification.d.ts

@@ -6,6 +6,9 @@ import { type CalloutNotificationProps, type CalloutNotificationWidth } from './
 type NotificationType = 'floating' | 'full-width' | 'message' | 'callout';
 type NotificationColor = Extract<ColorTone, 'neutral' | 'error' | 'warning' | 'success' | 'info'>;
 type NotificationSize = 'desktop' | 'mobile';
+type NotificationVariant = 'default' | 'block';
+/** 텍스트 링크(`supportTextLink`)를 여는 대상. `'_blank'`이면 새 탭 + `rel="noopener noreferrer"`. */
+type NotificationLinkTarget = '_self' | '_blank';
 interface NotificationAction {
     /**
      * 액션 버튼 텍스트
@@ -78,9 +81,27 @@ interface NotificationProps extends Omit<ComponentPropsWithoutRef<'div'>, 'title
     hidePermanentlyLabel?: ReactNode;
     /**
      * supportingText 에 연결할 링크 URL (선택사항)
-     * full-width 타입에서 사용 가능
+     * full-width 타입, message 타입의 `variant="block"`에서 사용 가능
      */
     supportTextLink?: string;
+    /**
+     * 텍스트 링크를 여는 대상 (선택사항). `supportTextLink`가 렌더될 때만 동작한다.
+     * `'_blank'`이면 새 탭으로 열고 `rel="noopener noreferrer"`를 함께 붙인다.
+     * full-width 타입, message 타입의 `variant="block"`에서 사용 가능
+     * @default '_self'
+     */
+    supportTextLinkTarget?: NotificationLinkTarget;
+    /**
+     * message 타입의 표시 변형 (선택사항). message 타입에서만 동작한다.
+     *
+     * - `'default'`: 기존 message (color 별 배경·테두리, 제목 + 본문 2행, info → neutral 폴백)
+     * - `'block'`: 서브 페이지 공지용. 흰 배경·gray-100 테두리·shadow-sm, FeaturedIcon sm,
+     *   제목 + 텍스트 링크 1행(`supportingText` 가 링크 텍스트, `supportTextLink` 가 href).
+     *   `color="info"` 를 그대로 렌더한다.
+     *
+     * @default 'default'
+     */
+    variant?: NotificationVariant;
     /**
      * 너비 동작 (선택사항)
      * callout 타입에서만 사용 가능. 미지정 시 부모 너비를 채운다(100%). 'fit' 은 콘텐츠 너비에 맞춘다
@@ -101,6 +122,6 @@ interface NotificationProps extends Omit<ComponentPropsWithoutRef<'div'>, 'title
     portal?: boolean;
 }
 declare const Notification: import("react").ForwardRefExoticComponent<NotificationProps & import("react").RefAttributes<HTMLDivElement>>;
-export type { NotificationType, NotificationColor, NotificationSize, NotificationAction, NotificationProps };
+export type { NotificationType, NotificationColor, NotificationSize, NotificationVariant, NotificationLinkTarget, NotificationAction, NotificationProps, };
 export type { CalloutNotificationProps, CalloutNotificationWidth };
 export { Notification };

package/dist/types/src/components/overlays/notification/NotificationActionButtons.d.ts

@@ -0,0 +1,12 @@
+import type { NotificationAction } from './Notification';
+interface NotificationActionButtonsProps {
+    actions: NotificationAction[];
+}
+/**
+ * 알림 액션 버튼 목록. 모든 type 이 같은 규격(`ncua-btn--xs` + hierarchy, 기본 `text`)을 쓴다(#535).
+ * Vanilla `renderActions`(assets/scripts/notification/utils.ts)와 같은 클래스를 산출해야 한다.
+ * 감싸는 래퍼(`__actions`)는 type 마다 클래스가 달라 호출부가 담당한다.
+ */
+declare const NotificationActionButtons: ({ actions }: NotificationActionButtonsProps) => import("react/jsx-runtime").JSX.Element;
+export type { NotificationActionButtonsProps };
+export { NotificationActionButtons };

package/dist/types/src/components/overlays/notification/__tests__/supportTextLink.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/overlays/notification/linkTarget.d.ts

@@ -0,0 +1,11 @@
+import type { NotificationLinkTarget } from './Notification';
+/**
+ * 텍스트 링크(`supportTextLink`)의 `<a>`에 붙일 target·rel 속성.
+ *
+ * `'_blank'`일 때만 새 탭 + `rel="noopener noreferrer"`를 반환하고, `'_self'`(기본)는 아무 속성도 붙이지 않는다.
+ * Vanilla `applySupportTextLinkTarget`과 같은 마크업을 산출해야 한다.
+ */
+export declare function getLinkTargetAttributes(target?: NotificationLinkTarget): {
+    readonly target: "_blank";
+    readonly rel: "noopener noreferrer";
+} | undefined;

package/dist/types/src/utils/index.d.ts

@@ -1,2 +1,3 @@
 export * from './date-picker';
 export * from './dropdown';
+export * from './url';

package/dist/types/src/utils/url/__tests__/isSafeUrl.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/utils/url/index.d.ts

@@ -0,0 +1 @@
+export * from './isSafeUrl';

package/dist/types/src/utils/url/isSafeUrl.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 링크 href 로 넣어도 안전한 URL 인지 판정한다. http/https 및 상대경로만 허용한다.
+ * javascript:, data:, file: 등 위험 프로토콜로 인한 XSS / 외부 페이로드 로딩을 차단.
+ *
+ * URL 파서가 앞뒤 공백·탭·개행 제거와 scheme 소문자화를 하므로 ` JavaScript:` 같은 우회도 막힌다.
+ * React(`MessageNotificationParts`·`FullWidthNotification`)와 Vanilla(`renderSupportingText`)가 공유한다.
+ */
+export declare function isSafeUrl(url: string): boolean;