@ncds/ui-admin 1.6.4-alpha.1 → 1.7.0

package/dist/types/assets/scripts/imageFileInput/ImageFileInput.d.ts

@@ -0,0 +1,63 @@
+import { BaseImageFileInputOptions, UploadedFile } from './const/types';
+export declare class ImageFileInput {
+    private model;
+    private view;
+    constructor(options: BaseImageFileInputOptions);
+    /**
+     * 컨테이너에 요소 추가
+     */
+    private appendToContainer;
+    /**
+     * 이벤트 리스너 설정
+     */
+    private setupEventListeners;
+    /**
+     * 파일 선택 버튼 클릭 핸들러
+     */
+    private handleBrowseClick;
+    /**
+     * 파일 변경 핸들러
+     */
+    private handleFileChange;
+    /**
+     * 파일 제거 핸들러
+     */
+    private handleRemoveFile;
+    /**
+     * 변경 알림 (onChange/onFileSelect 호출)
+     */
+    private notifyChange;
+    /**
+     * 뷰 렌더링 (내부용)
+     */
+    private render;
+    /**
+     * 이미지 프리뷰를 수동으로 렌더링
+     * 사용자가 콜백에서 직접 호출하여 프리뷰를 렌더링할 수 있음
+     */
+    renderImagePreviews(): void;
+    /**
+     * DOM 요소 반환
+     */
+    getElement(): HTMLDivElement;
+    /**
+     * 현재 파일 목록 반환
+     */
+    getFiles(): File[];
+    /**
+     * 초기 업로드된 파일 목록 설정
+     */
+    setFiles(uploadedFiles: UploadedFile[]): void;
+    /**
+     * 모든 파일 제거
+     */
+    clearFiles(): void;
+    /**
+     * disabled 상태 설정
+     */
+    setDisabled(disabled: boolean): void;
+    /**
+     * 리소스 정리
+     */
+    destroy(): void;
+}

package/dist/types/assets/scripts/imageFileInput/ImageFileInputModel.d.ts

@@ -0,0 +1,73 @@
+import { BaseImageFileInputOptions, InvalidFile, RequiredImageFileInputProps, UploadedFile } from './const/types';
+export declare class ImageFileInputModel {
+    private options;
+    private internalFiles;
+    private initialFiles;
+    private newlyAddedFiles;
+    private deletedInitialFiles;
+    constructor(options: BaseImageFileInputOptions);
+    /**
+     * 옵션 반환
+     */
+    getOptions(): RequiredImageFileInputProps;
+    /**
+     * 현재 파일 목록 반환 (초기 파일 + 새로 추가된 파일, 삭제 표시된 파일 제외)
+     */
+    getFiles(): File[];
+    /**
+     * 파일명에서 MIME 타입 추론
+     */
+    private getMimeTypeFromFileName;
+    /**
+     * 초기 업로드된 파일 목록 설정 (UploadedFile[] 타입만 허용)
+     */
+    setFiles(uploadedFiles: UploadedFile[]): void;
+    /**
+     * 파일 추가
+     */
+    addFiles(files: File[]): void;
+    /**
+     * 특정 인덱스의 파일 제거
+     */
+    removeFile(index: number): void;
+    /**
+     * 모든 파일 제거
+     */
+    clearFiles(): void;
+    /**
+     * 파일 유효성 검사
+     */
+    validateFiles(fileList: File[]): {
+        validFiles: File[];
+        invalidFiles: InvalidFile[];
+    };
+    /**
+     * disabled 상태 설정
+     */
+    setDisabled(disabled: boolean): void;
+    /**
+     * disabled 상태 반환
+     */
+    isDisabled(): boolean;
+    /**
+     * Controlled mode 여부 확인
+     * onChange가 있으면 Controlled mode로 판단
+     */
+    isControlled(): boolean;
+    /**
+     * 파일이 초기 파일인지 확인 (UploadedFile로 설정된 기존 파일)
+     */
+    isInitialFile(file: File): boolean;
+    /**
+     * 파일이 새로 추가된 파일인지 확인
+     */
+    isNewlyAddedFile(file: File): boolean;
+    /**
+     * 파일이 삭제 표시된 초기 파일인지 확인
+     */
+    isDeletedInitialFile(file: File): boolean;
+    /**
+     * 초기 파일의 이미지 URL 반환
+     */
+    getInitialFileImageUrl(file: File): string | undefined;
+}

package/dist/types/assets/scripts/imageFileInput/ImageFileInputView.d.ts

@@ -0,0 +1,79 @@
+import { RequiredImageFileInputProps } from './const/types';
+import { ImageFileInputModel } from './ImageFileInputModel';
+export declare class ImageFileInputView {
+    private element;
+    private fileInputElement;
+    private buttonElement;
+    private previewsContainer;
+    private options;
+    private model;
+    private renderedFiles;
+    private previewUrls;
+    constructor(options: RequiredImageFileInputProps, model: ImageFileInputModel);
+    /**
+     * 메인 DOM 요소 생성
+     */
+    private createElement;
+    /**
+     * Hidden file input 생성
+     */
+    private createFileInput;
+    /**
+     * Input container 생성
+     */
+    private createInputContainer;
+    /**
+     * Label container 생성
+     */
+    private createLabelContainer;
+    /**
+     * Help icon 생성
+     */
+    private createHelpIcon;
+    /**
+     * Button 생성 (파일 찾기)
+     */
+    private createButton;
+    /**
+     * Share icon (업로드 아이콘) 생성
+     */
+    private createShareIcon;
+    /**
+     * Trash icon (삭제 아이콘) 생성
+     */
+    private createTrashIcon;
+    /**
+     * Hint text 생성
+     */
+    private createHintText;
+    /**
+     * Hint list 생성
+     * Note: 힌트 리스트는 컴포넌트 size와 관계없이 항상 xs 사이즈로 고정됨
+     */
+    private createHintList;
+    /**
+     * 이미지 프리뷰 렌더링
+     */
+    renderImagePreviews(files: File[], onRemove: (index: number) => void, onBrowseClick: () => void): void;
+    /**
+     * 이미지 프리뷰 생성
+     */
+    private createImagePreview;
+    /**
+     * 빈 슬롯 생성 (파일 찾기 버튼)
+     */
+    private createEmptySlot;
+    /**
+     * Tooltip 생성
+     */
+    private createTooltip;
+    /**
+     * 기존 프리뷰 정리
+     */
+    private cleanupPreviews;
+    setButtonDisabled(disabled: boolean): void;
+    getElement(): HTMLDivElement;
+    getFileInputElement(): HTMLInputElement;
+    getButtonElement(): HTMLButtonElement;
+    destroy(): void;
+}

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

@@ -0,0 +1,19 @@
+export declare const IMAGE_FILE_INPUT_CLASS_NAMES: {
+    imageFileInput: string;
+    previews: string;
+    previewContainer: string;
+    previewImage: string;
+    previewRemoveButton: string;
+    fileInput: string;
+    inputContainer: string;
+    label: string;
+    helpIcon: string;
+    hintText: string;
+    hintList: string;
+    hintItem: string;
+};
+export declare const getImageFileInputSizeClassName: (size: string) => string;
+export declare const getFileInputSizeClassName: (size: string) => string;
+export declare const getButtonSizeClassName: (size: string) => string;
+export declare const getLabelClassName: (isRequired?: boolean) => "ncua-label" | "ncua-label ncua-label--required";
+export declare const getHintTextClassName: (destructive?: boolean) => "ncua-input__hint-text" | "ncua-input__hint-text ncua-input__hint-text--destructive";

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

@@ -0,0 +1,2 @@
+export * from './classNames';
+export * from './types';

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

@@ -0,0 +1,125 @@
+export declare enum ImageFileInputErrorType {
+    ALREADY_UPLOADED = "ALREADY_UPLOADED",
+    EXCEED_MAX_FILE_SIZE = "EXCEED_MAX_FILE_SIZE",
+    EXCEED_MAX_FILE_COUNT = "EXCEED_MAX_FILE_COUNT"
+}
+export interface InvalidFile extends Omit<File, 'constructor'> {
+    errorType: ImageFileInputErrorType;
+}
+export type ImageFileInputSize = 'xs' | 'sm' | 'md' | 'lg';
+export type UploadedFile = {
+    fileName: string;
+    fileImageUrl?: string;
+};
+export interface BaseImageFileInputOptions {
+    /**
+     * Size of the input
+     */
+    size?: ImageFileInputSize;
+    /**
+     * Accepted file types
+     * e.g. '.jpg,.png,.pdf' or 'image/*'
+     */
+    accept?: string;
+    /**
+     * Allow multiple file selection
+     */
+    multiple?: boolean;
+    /**
+     * Maximum number of files
+     */
+    maxFileCount?: number;
+    /**
+     * Maximum file size in bytes
+     */
+    maxFileSize?: number;
+    /**
+     * Initial files (controlled mode)
+     */
+    value?: File[];
+    /**
+     * Callback when files change (controlled mode)
+     */
+    onChange?: (files: File[]) => void;
+    /**
+     * Callback when files are selected (uncontrolled mode)
+     */
+    onFileSelect?: (files: File[]) => void;
+    /**
+     * Callback when file selection fails
+     */
+    onFail?: (files: InvalidFile[]) => void;
+    /**
+     * Label shown on the button
+     */
+    buttonLabel?: string;
+    /**
+     * Label shown on the image preview
+     */
+    imagePreviewTooltipLabel?: string;
+    /**
+     * Whether the input is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Label text
+     */
+    label?: string;
+    /**
+     * Hint text items to display as a list
+     */
+    hintItems?: string[];
+    /**
+     * Whether the input is required
+     */
+    isRequired?: boolean;
+    /**
+     * Whether to show the help icon
+     */
+    showHelpIcon?: boolean;
+    /**
+     * Hint text to display
+     */
+    hintText?: string;
+    /**
+     * Validation state
+     */
+    validation?: boolean;
+    /**
+     * Destructive state
+     */
+    destructive?: boolean;
+    /**
+     * Name attribute for file input (for PHP form submission)
+     */
+    fileInputName?: string;
+    /**
+     * Container element or selector to automatically append the image file input
+     * Can be a DOM element, element ID, or CSS selector
+     */
+    container?: HTMLElement | string;
+    /**
+     * Additional CSS class names to add to the main image file input element
+     */
+    className?: string;
+}
+export interface RequiredImageFileInputProps extends Required<Pick<BaseImageFileInputOptions, 'size' | 'buttonLabel' | 'imagePreviewTooltipLabel'>> {
+    accept?: string;
+    multiple: boolean;
+    maxFileCount?: number;
+    maxFileSize?: number;
+    value?: File[];
+    onChange?: (files: File[]) => void;
+    onFileSelect?: (files: File[]) => void;
+    onFail?: (files: InvalidFile[]) => void;
+    disabled: boolean;
+    label?: string;
+    hintItems?: string[];
+    isRequired?: boolean;
+    showHelpIcon?: boolean;
+    hintText?: string;
+    validation?: boolean;
+    destructive?: boolean;
+    fileInputName?: string;
+    className?: string;
+}

package/dist/types/assets/scripts/imageFileInput/index.d.ts

@@ -0,0 +1,3 @@
+export * from './const/classNames';
+export * from './const/types';
+export { ImageFileInput } from './ImageFileInput';

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

@@ -0,0 +1,32 @@
+import { ComboBox } from './comboBox';
+import { DatePicker } from './datePicker';
+import { FeaturedIcon } from './featuredIcon';
+import { FileInput } from './fileInput';
+import { ImageFileInput } from './imageFileInput';
+import { Modal } from './modal';
+import { Notification } from './notification';
+import { ProgressBar } from './progress-bar';
+import { SelectBox } from './selectBox';
+import { Slider } from './slider';
+import { Tab } from './tab';
+import { Tag } from './tag';
+import { Tooltip } from './tooltip';
+declare global {
+    interface Window {
+        ncua: {
+            Slider?: typeof Slider;
+            Tab?: typeof Tab;
+            Tag?: typeof Tag;
+            DatePicker?: typeof DatePicker;
+            FeaturedIcon?: typeof FeaturedIcon;
+            FileInput?: typeof FileInput;
+            Modal?: typeof Modal;
+            Notification?: typeof Notification;
+            ProgressBar?: typeof ProgressBar;
+            Tooltip?: typeof Tooltip;
+            SelectBox?: typeof SelectBox;
+            ComboBox?: typeof ComboBox;
+            ImageFileInput?: typeof ImageFileInput;
+        };
+    }
+}

package/dist/types/assets/scripts/modal/Modal.d.ts

@@ -0,0 +1,27 @@
+import { BaseModalOptions } from './const/types';
+import { ModalHeader } from './ModalHeader';
+import { ModalContent } from './ModalContent';
+import { ModalActions } from './ModalActions';
+export declare class Modal {
+    private element;
+    private modalElement;
+    private isOpen;
+    private options;
+    constructor(options?: BaseModalOptions);
+    private createElement;
+    private getBackdropClasses;
+    private getModalClasses;
+    private handleBackdropClick;
+    private handleKeyDown;
+    open(): void;
+    close(): void;
+    destroy(): void;
+    setContent(content: string | HTMLElement): void;
+    getElement(): HTMLDivElement;
+    getModalElement(): HTMLDivElement;
+    isModalOpen(): boolean;
+    static create(options?: BaseModalOptions): Modal;
+    static Header: typeof ModalHeader;
+    static Content: typeof ModalContent;
+    static Actions: typeof ModalActions;
+}

package/dist/types/assets/scripts/modal/ModalActions.d.ts

@@ -0,0 +1,18 @@
+import { ModalActionsProps } from './const/types';
+export declare class ModalActions {
+    private wrapperElement;
+    private actionsElement;
+    private options;
+    constructor(content?: string | HTMLElement, options?: ModalActionsProps);
+    private createElement;
+    getElement(): HTMLDivElement;
+    getActionsElement(): HTMLDivElement;
+    getHTML(): string;
+    appendTo(parent: HTMLElement): void;
+    setContent(content: string | HTMLElement | HTMLElement[]): void;
+    addAction(action: string | HTMLElement): void;
+    clear(): void;
+    setCheckboxContent(content: string | HTMLElement): void;
+    addDivider(): HTMLElement;
+    static create(content?: string | HTMLElement, options?: ModalActionsProps): ModalActions;
+}

package/dist/types/assets/scripts/modal/ModalContent.d.ts

@@ -0,0 +1,13 @@
+export declare class ModalContent {
+    private element;
+    constructor(content?: string | HTMLElement);
+    private createElement;
+    getElement(): HTMLDivElement;
+    getHTML(): string;
+    appendTo(parent: HTMLElement): void;
+    setContent(content: string | HTMLElement): void;
+    clear(): void;
+    getText(): string;
+    getInnerHTML(): string;
+    static create(content?: string | HTMLElement): ModalContent;
+}

package/dist/types/assets/scripts/modal/ModalHeader.d.ts

@@ -0,0 +1,15 @@
+import { ModalHeaderProps } from './const/types';
+export declare class ModalHeader {
+    private element;
+    private options;
+    constructor(options?: ModalHeaderProps);
+    private createElement;
+    getElement(): HTMLElement;
+    getHTML(): string;
+    appendTo(parent: HTMLElement): void;
+    setTitle(title: string): void;
+    setSubtitle(subtitle: string): void;
+    setCloseHandler(handler: () => void): void;
+    addDivider(): HTMLElement;
+    static create(options?: ModalHeaderProps): ModalHeader;
+}

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

@@ -0,0 +1,22 @@
+export declare const MODAL_CLASS_NAMES: {
+    backdrop: string;
+    modal: string;
+    modalOpen: string;
+    header: string;
+    title: string;
+    titleText: string;
+    titleSubtitle: string;
+    closeButton: string;
+    headerDivider: string;
+    content: string;
+    actionsWrapper: string;
+    actionsWrapperCheckbox: string;
+    actions: string;
+    actionsDivider: string;
+    actionsCheckbox: string;
+    actionsCheckboxContent: string;
+};
+export declare const getModalSizeClassNames: (size: string) => string;
+export declare const getModalHeaderAlignClassNames: (align: string) => string;
+export declare const getModalActionsLayoutClassNames: (layout: string) => string;
+export declare const getModalActionsAlignClassNames: (align: string) => string;

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

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './classNames';

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

@@ -0,0 +1,61 @@
+import { ModalSize, ModalHeaderAlign, ModalActionsLayout } from '../../../../src/components/modal/Modal';
+import { FeaturedIconOptions } from '../../featuredIcon';
+export type { ModalSize, ModalHeaderAlign, ModalActionsAlign, ModalActionsLayout, ModalProps as ReactModalProps, ModalHeaderProps as ReactModalHeaderProps, ModalContentProps as ReactModalContentProps, ModalActionsProps as ReactModalActionsProps, } from '../../../../src/components/modal/Modal';
+export type { FeaturedIconOptions } from '../../featuredIcon';
+export interface ModalProps {
+    isOpen?: boolean;
+    size?: ModalSize;
+    closeOnBackdropClick?: boolean;
+    closeOnEsc?: boolean;
+    className?: string;
+    zIndex?: number;
+    onClose?: () => void;
+}
+export interface RequiredModalProps extends ModalProps {
+    size: ModalSize;
+    closeOnBackdropClick: boolean;
+    closeOnEsc: boolean;
+    className: string;
+    onClose: () => void;
+}
+export interface BaseModalOptions extends ModalProps {
+}
+export interface ModalHeaderProps {
+    children?: string | HTMLElement;
+    onClose?: () => void;
+    featuredIcon?: FeaturedIconOptions;
+    align?: ModalHeaderAlign;
+    title?: string;
+    subtitle?: string;
+    showDivider?: boolean;
+    hideCloseButton?: boolean;
+}
+export interface ModalContentProps {
+    children: string | HTMLElement;
+}
+export interface RequiredModalHeaderProps extends ModalHeaderProps {
+    children?: string | HTMLElement;
+    onClose?: () => void;
+    featuredIcon?: FeaturedIconOptions;
+    align: ModalHeaderAlign;
+    title: string;
+    subtitle: string;
+    showDivider: boolean;
+    hideCloseButton: boolean;
+}
+export interface ModalActionsProps {
+    children?: string | HTMLElement | HTMLElement[];
+    layout?: ModalActionsLayout;
+    showDivider?: boolean;
+    align?: 'left' | 'center' | 'right' | 'stretch';
+    fullWidth?: boolean;
+    checkboxContent?: string | HTMLElement;
+}
+export interface RequiredModalActionsProps extends ModalActionsProps {
+    children?: string | HTMLElement | HTMLElement[];
+    layout: ModalActionsLayout;
+    showDivider: boolean;
+    align: 'left' | 'center' | 'right' | 'stretch';
+    fullWidth: boolean;
+    checkboxContent: string | HTMLElement | undefined;
+}

package/dist/types/assets/scripts/modal/index.d.ts

@@ -0,0 +1,7 @@
+import { Modal } from './Modal';
+import { ModalHeader } from './ModalHeader';
+import { ModalContent } from './ModalContent';
+import { ModalActions } from './ModalActions';
+export { Modal, ModalHeader, ModalContent, ModalActions };
+export type { ModalProps, ModalHeaderProps, ModalContentProps, ModalActionsProps, ModalSize, ModalHeaderAlign, ModalActionsLayout, FeaturedIconOptions, } from './const/types';
+export * from './const';

package/dist/types/assets/scripts/modal/utils/contentUtils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 문자열이 HTML 태그를 포함하는지 확인
+ */
+export declare function isHTMLString(str: string): boolean;
+/**
+ * 요소에 콘텐츠를 안전하게 설정
+ * HTML 구조면 innerHTML, 일반 텍스트면 textContent 사용
+ * HTMLElement인 경우 outerHTML을 사용하여 string으로 변환
+ */
+export declare function setElementContent(element: HTMLElement, content: string | HTMLElement): void;

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

@@ -0,0 +1,24 @@
+import type { BaseNotificationOptions } from './const';
+export interface FloatingNotificationOptions extends BaseNotificationOptions {
+    type?: 'floating';
+}
+export declare class FloatingNotification {
+    private element;
+    private options;
+    private autoCloseTimer?;
+    private featuredIcon?;
+    private mobileCleanup?;
+    constructor(options: FloatingNotificationOptions);
+    private createElement;
+    private buildTemplate;
+    private renderCloseButton;
+    private setupMobileListener;
+    private updateMobileStyles;
+    private bindEvents;
+    private setupAutoClose;
+    getElement(): HTMLElement;
+    appendTo(parent: HTMLElement): void;
+    remove(): void;
+    destroy(): void;
+    static create(options: FloatingNotificationOptions): FloatingNotification;
+}

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

@@ -0,0 +1,21 @@
+import type { BaseNotificationOptions } from './const';
+export interface FullWidthNotificationOptions extends BaseNotificationOptions {
+    type?: 'full-width';
+}
+export declare class FullWidthNotification {
+    private element;
+    private options;
+    private autoCloseTimer?;
+    constructor(options: FullWidthNotificationOptions);
+    private createElement;
+    private buildTemplate;
+    private renderHidePermanentlyButton;
+    private renderCloseButton;
+    private bindEvents;
+    private setupAutoClose;
+    getElement(): HTMLElement;
+    appendTo(parent: HTMLElement): void;
+    remove(): void;
+    destroy(): void;
+    static create(options: FullWidthNotificationOptions): FullWidthNotification;
+}

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

@@ -0,0 +1,22 @@
+import type { BaseNotificationOptions } from './const';
+export interface MessageNotificationOptions extends BaseNotificationOptions {
+    type?: 'message';
+}
+export declare class MessageNotification {
+    private element;
+    private options;
+    private autoCloseTimer?;
+    private featuredIcon?;
+    constructor(options: MessageNotificationOptions);
+    private createElement;
+    private buildTemplate;
+    private renderHidePermanentlyButton;
+    private renderCloseButton;
+    private bindEvents;
+    private setupAutoClose;
+    getElement(): HTMLElement;
+    appendTo(parent: HTMLElement): void;
+    remove(): void;
+    destroy(): void;
+    static create(options: MessageNotificationOptions): MessageNotification;
+}

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

@@ -0,0 +1,21 @@
+import type { NotificationColor, BaseNotificationOptions } from './const';
+export interface NotificationOptions extends BaseNotificationOptions {
+    type?: 'full-width' | 'floating' | 'message';
+}
+export declare class Notification {
+    private instance;
+    constructor(options: NotificationOptions);
+    getElement(): HTMLElement;
+    appendTo(parent: HTMLElement): void;
+    remove(): void;
+    destroy(): void;
+    show(parent?: HTMLElement): void;
+    static create(options: NotificationOptions): Notification;
+    static createWithColor(color: NotificationColor, title: string, supportingText?: string, options?: Partial<NotificationOptions>): Notification;
+    static success(title: string, supportingText?: string, options?: Partial<NotificationOptions>): Notification;
+    static error(title: string, supportingText?: string, options?: Partial<NotificationOptions>): Notification;
+    static warning(title: string, supportingText?: string, options?: Partial<NotificationOptions>): Notification;
+    static info(title: string, supportingText?: string, options?: Partial<NotificationOptions>): Notification;
+    static neutral(title: string, supportingText?: string, options?: Partial<NotificationOptions>): Notification;
+    static showFullWidth(options: Omit<NotificationOptions, 'type'>): Notification;
+}