@g1cloud/open-bluesea-core 1.0.0-alpha.4 → 1.0.0-alpha.6

package/package.json

@@ -3,7 +3,7 @@
   "description": "Vue UI Library for Management Console.",
   "license": "Proprietary",
   "private": false,
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.6",
   "type": "module",
   "engines": {
     "node": ">= 24.3.0"
@@ -34,6 +34,7 @@
     "tailwindcss": "^4.1.16",
     "typescript": "~5.9.3",
     "vite": "^7.1.12",
+    "vite-plugin-dts": "^4.5.4",
     "vue-tsc": "^3.1.3"
   },
   "dependencies": {

package/dist/blueseaPlugin.d.ts

@@ -1,43 +0,0 @@
-import { type InjectionKey, type Plugin } from "vue";
-import type { DisplayDateResolution } from "./model/CommonTypes";
-export type PopupComponentConfig = {
-    container?: string | HTMLElement;
-    hideOnScroll?: boolean;
-};
-export type CalendarComponentConfig = {
-    startYear?: string;
-    endYear?: string;
-};
-export type ComponentConfig = {
-    popup?: PopupComponentConfig;
-    calendar?: CalendarComponentConfig;
-};
-export declare class BlueseaConfig {
-    dateFormat: string;
-    dateFormatDay: string;
-    dateFormatMinute: string;
-    dateFormatSecond: string;
-    minDateValue: string;
-    maxDateValue: string;
-    timeZone: string;
-    componentConfig: ComponentConfig;
-    constructor(config?: BlueseaConfigRaw);
-    resolveDisplayDateFormat(format?: string | DisplayDateResolution): string;
-}
-export type BlueseaConfigRaw = {
-    dateFormat?: string;
-    dateFormatDay?: string;
-    dateFormatMinute?: string;
-    dateFormatSecond?: string;
-    minDateValue?: string;
-    maxDateValue?: string;
-    timeZone?: string;
-    componentConfig?: ComponentConfig;
-};
-export declare const BlueseaConfigKey: InjectionKey<BlueseaConfig>;
-/**
- * App 에 provide 된 BlueseaConfig 를 리턴한다.
- * @returns BlueseaConfig
- */
-export declare const useBlueseaConfig: () => BlueseaConfig;
-export declare const BlueseaPlugin: Plugin;

package/dist/component/basic/PageNavigation.model.d.ts

@@ -1,5 +0,0 @@
-export type PageInfo = {
-    offset?: number;
-    limit?: number;
-    totalCount?: number;
-};

package/dist/component/input/DateInputLib.d.ts

@@ -1,26 +0,0 @@
-import type { DateResolution, TimeZone } from "@/model/CommonTypes";
-/**
- * Resolution 에 해당하는 날짜 입력 포맷.
- * 예를 들어 'YYYYMMDD', 'YYYYMMDDHH', 'YYYYMMDDHHmm'
- * @param resolution
- */
-export declare const dateInputFormatByResolution: (resolution: DateResolution) => string;
-/**
- * 입력받은 YYYYMMDDHHmm 형식의 input string 을 ISO8601 형식의 string 으로 변환한다.
- *
- * 입력값(str) 은 blueseaConfig.minDateValue 와 blueseaConfig.maxDateValue 사이 값이어야 한다.
- * 그렇지 않으면 이 사이 값으로 변경되어 처리된다.
- *
- * @param str 변환할 입력 값. (ex: YYYYMMDDHHmm 형식)
- * @param inputFormat
- * @param endTime
- * @param resolution
- * @param inputTimeZone
- * @param minDateValue 최소시각. 없으면 blueseaConfig.minDateValue 사용.
- * @param maxDateValue 최대시각. 없으면 blueseaConfig.maxDateValue 사용.
- * @return ISO8601 형식의 값. (ex: 2024-04-01T12:30:00.000+09:00)
- */
-export declare const convertInputToDateString: (str: string | undefined, inputFormat: string, endTime: boolean, resolution: DateResolution, inputTimeZone: TimeZone, minDateValue: string, maxDateValue: string) => string;
-export declare const convertDateToInputString: (date: string, inputFormat: string, inputTimeZone: string) => string;
-export declare const checkDateMinMaxValue: (value: string | undefined, inputFormat: string, endTime: boolean, resolution: DateResolution, inputTimeZone: TimeZone, minDateValue: string, maxDateValue: string) => string | undefined;
-export declare const normalizeDateInput: (value: string) => string;

package/dist/contextmenu/contextMenuPlugin.d.ts

@@ -1,36 +0,0 @@
-import { type Component } from "vue";
-export declare const ContextMenuPluginKey: unique symbol;
-export type MenuItem = {
-    type?: 'menu' | 'link' | 'route' | 'separator' | 'custom';
-    menuId?: string;
-    caption?: string;
-    component?: Component;
-    disabled?: boolean;
-    handler?: () => void;
-    href?: string;
-    target?: string;
-    children?: MenuItem[];
-};
-export type MenuPosition = {
-    x: number;
-    y: number;
-};
-export type ContextMenuOptions = {
-    zIndex?: number;
-    onHideContextMenu?: () => void;
-};
-export type MousePosition = {
-    clientX: number;
-    clientY: number;
-};
-export declare class BSContextMenuPlugin {
-    contextMenuItems: import("vue").Ref<MenuItem[] | undefined, MenuItem[] | undefined>;
-    position: import("vue").Ref<MenuPosition | undefined, MenuPosition | undefined>;
-    options: import("vue").Ref<ContextMenuOptions | undefined, ContextMenuOptions | undefined>;
-    showContextMenu(event: MousePosition, menus: MenuItem[], options?: ContextMenuOptions): void;
-    hideContextMenu(): void;
-    private markComponentRaw;
-}
-export declare const useContextMenu: () => BSContextMenuPlugin;
-export declare const useContextMenuOptional: () => BSContextMenuPlugin | undefined;
-export declare const createContextMenuPlugin: () => BSContextMenuPlugin;

package/dist/directive/vClickOutside.d.ts

@@ -1,20 +0,0 @@
-import type { ObjectDirective } from "vue";
-type ClickOutsideContext = {
-    enabled: boolean;
-    handler: () => void;
-    insideElements?: (HTMLElement | string | undefined)[];
-};
-declare global {
-    interface HTMLElement {
-        vClickOutsideListener?: (event: MouseEvent) => void;
-        vClickOutsideContext?: ClickOutsideContext;
-    }
-}
-/**
- * ```
- * v-click-outside="() => someFunction()"
- * v-click-outside="{enabled: true, handler: () => someFunction()}"
- * ```
- */
-declare const vClickOutside: ObjectDirective;
-export default vClickOutside;

package/dist/directive/vFocusOnLoad.d.ts

@@ -1,3 +0,0 @@
-import type { ObjectDirective } from "vue";
-declare const vFocusOnLoad: ObjectDirective;
-export default vFocusOnLoad;

package/dist/directive/vTooltip.d.ts

@@ -1,7 +0,0 @@
-import type { ObjectDirective } from "vue";
-export type TooltipParam = {
-    content?: string;
-    delay?: number;
-};
-declare const vTooltip: ObjectDirective;
-export default vTooltip;

package/dist/model/CommonTypes.d.ts

@@ -1,29 +0,0 @@
-export type LabelProvider<T> = (item: T) => string | undefined;
-export type KeyProvider<T> = (item: T) => string | undefined;
-export type EnabledItemProvider<T> = (item: T) => boolean;
-export type IconProvider<T> = (item: T) => string | undefined;
-export type TooltipProvider<T> = (item: T) => string | undefined;
-export type LocaleName = string;
-export type TimeZone = string;
-export type DateResolution = 'DAY' | 'HOUR' | 'MINUTE_30' | 'MINUTE_10' | 'MINUTE' | 'SECOND';
-export type DisplayDateResolution = 'DAY' | 'MINUTE' | 'SECOND';
-/**
- * BSTextInput 등의 prefix, suffix 타입
- */
-export type PrefixSuffix = {
-    type: 'text' | 'font-icon' | 'image-url';
-    value: string;
-};
-export type StoredFile = {
-    fileUrl?: string;
-    mediaType?: 'Image' | 'Video' | 'Youtube' | 'Unknown';
-    thumbnailUrl?: string;
-    altText?: string;
-    width?: number;
-    height?: number;
-    imageNo?: number;
-    file?: File;
-    thumbnailFile?: File;
-};
-export declare class IllegalAccessError {
-}

package/dist/model/DefaultImpl.d.ts

@@ -1,7 +0,0 @@
-import type { KeyProvider, LabelProvider } from "@/model/CommonTypes";
-export declare const defaultLabelProvider: <T>(item: T) => string;
-export declare const emptyLabelProvider: <T>(_item: T) => undefined;
-export declare const executeLabelProviderOrDefault: <T>(item: T, labelProvider: LabelProvider<T> | undefined, defaultLabel: (item: T) => string) => string;
-export declare const defaultKeyProvider: <T>(item: T) => string;
-export declare const emptyKeyProvider: <T>(_item: T) => undefined;
-export declare const executeKeyProviderOrDefault: <T>(item: T, keyProvider: KeyProvider<T> | undefined, defaultKey: (item: T) => string) => string;

package/dist/model/FieldContext.d.ts

@@ -1,14 +0,0 @@
-import type { LocaleName } from "@/model/CommonTypes";
-export type IterationContext<T> = {
-    componentName: string;
-    record: T;
-    recordKey?: string;
-    recordIndex?: number;
-    data: T[];
-};
-export type FieldContext<T> = {
-    iteration?: IterationContext<T>;
-    locale?: LocaleName;
-};
-export declare const provideFieldContext: <T>(fieldContext: FieldContext<T>) => void;
-export declare const useFieldContext: () => FieldContext<any> | undefined;

package/dist/notification/notificationPlugin.d.ts

@@ -1,31 +0,0 @@
-import type { Component, Raw } from "vue";
-export type NotificationStyle = 'error' | 'info';
-export type NotificationEntry = {
-    entryId: number;
-    message: string;
-    style: NotificationStyle;
-    duration: number;
-};
-export declare const notificationEntries: import("vue").Reactive<NotificationEntry[]>;
-export declare const showNotification: (message: string, style?: NotificationStyle, durationInMilliSeconds?: number) => void;
-export type AlarmEntry = {
-    entryId: number;
-    component: Raw<Component>;
-    duration: number;
-};
-export declare const alarmEntries: import("vue").Reactive<AlarmEntry[]>;
-export declare const showAlarm: (component: Component, durationInMilliSeconds?: number) => void;
-export declare const closeAlarm: (entryId: number | AlarmEntry) => void;
-export type TooltipEntry = {
-    content: string;
-    target: HTMLElement;
-    cursorInTooltip: boolean;
-};
-export declare const tooltipEntry: import("vue").Ref<TooltipEntry | undefined, TooltipEntry | undefined>;
-export declare const showTooltip: (content: string, target: HTMLElement) => void;
-export declare const hideTooltip: () => void;
-export declare const isTooltipDisplayed: () => boolean;
-export declare const showLoadingIcon: import("vue").Ref<boolean, boolean>;
-export declare const showLoading: () => void;
-export declare const hideLoading: () => void;
-export declare const withLoading: <T>(func: () => Promise<T>) => Promise<T>;

package/dist/savepoint/SavePoint.d.ts

@@ -1,46 +0,0 @@
-import type { Ref } from "vue";
-export type SavePointValueProvider<T> = {
-    getCurrentValue: () => T;
-    setCurrentValue: (value: T) => void;
-    compare?: (savedValue: T, currentValue: T) => boolean;
-};
-export type SavePointHandlerRegisterOption<T> = {
-    field: Ref<HTMLElement | undefined>;
-} & SavePointValueProvider<T>;
-export interface ChildSavePoint {
-    set(): void;
-    rollback(): void;
-    isModified(): boolean;
-}
-export interface SavePoint {
-    registerField<T>(option: SavePointHandlerRegisterOption<T>): SavePointHandler<T>;
-    unregisterField(field: Ref<HTMLElement | undefined>): void;
-    addChild(child: ChildSavePoint): void;
-    removeChild(child: ChildSavePoint): void;
-    set(): void;
-    setNextTick(): Promise<void>;
-    rollback(): void;
-    isModified(): boolean;
-}
-export declare class SavePointImpl implements SavePoint {
-    private fields;
-    private children?;
-    registerField<T>(option: SavePointHandlerRegisterOption<T>): SavePointHandler<T>;
-    unregisterField(field: Ref<HTMLElement | undefined>): void;
-    addChild(child: ChildSavePoint): void;
-    removeChild(child: ChildSavePoint): void;
-    set(): void;
-    setNextTick(): Promise<void>;
-    rollback(): void;
-    isModified(): boolean;
-}
-export declare const provideSavePoint: () => SavePoint;
-export declare const useSavePoint: () => SavePoint | undefined;
-export declare const cancelProvidedSavePoint: () => void;
-export interface SavePointHandler<T> {
-    saveValue(): void;
-    getSavedValue(): T | undefined;
-    rollbackValue(): void;
-    isModified(currentValue: T): boolean;
-    isFieldModified(): boolean;
-}

package/dist/util/componentUtil.d.ts

@@ -1,11 +0,0 @@
-import type { PrefixSuffix } from "@/model/CommonTypes";
-declare const componentUtil: {
-    handleExternalErrorMessage(showErrorMessage: boolean, errorMessage?: string, elementId?: string): void;
-    generateNextId(prefix: string): string;
-    generateNextName(prefix: string): string;
-    isRelativeSize(size?: string): boolean;
-    delayed<T>(func: () => T, millis?: number): void;
-    trimStringValue(value?: string, trim?: boolean): string | undefined;
-    getPrefixSuffixList(param: string | string[] | PrefixSuffix | PrefixSuffix[] | undefined): PrefixSuffix[];
-};
-export default componentUtil;

package/dist/util/debounceUtil.d.ts

@@ -1,16 +0,0 @@
-/**
- * debounce 함수를 생성한다.
- *
- * ```ts
- * // 함수를 만들 때 debounce 로 감싼다.
- * const debouncedFunc = debounce(() => {
- *   ...
- * }, 500)()
- *
- * // 여러 번 호출하더라도, 마지막 호출만 실행된다.
- * debouncedFunc()
- * ```
- * @param func
- * @param wait
- */
-export declare const debounce: <T>(func: (...args: any[]) => T, wait: number) => ((...args: any[]) => Promise<T>);

package/dist/util/formatUtil.d.ts

@@ -1,69 +0,0 @@
-import type { DisplayDateResolution, TimeZone } from "@/model/CommonTypes";
-export declare const formatUtil: {
-    /**
-     * 개행 문자('\r', '\n')를 '<br/>' 태그로 변경한다.
-     * @param str 변경할 String
-     * @return 개행문자가 '<br/>'로 변경된 String
-     */
-    escapeNewLine(str?: string): string;
-    /**
-     * `str` 안의 `&<>"'` 문자를 escape 처리한다.
-     * @param str 변경할 String
-     */
-    escapeHtml(str?: string): string;
-    /**
-     * String 을 개행 문자('\r', '\n') 기준으로 나눈다.
-     * @param str
-     * @return 개행문자로 나누어진 string 의 array
-     */
-    splitNewLine(str?: string): Array<string>;
-    /**
-     * ISO8601 형식의 string 을 주어진 format 으로 변환한다.
-     * @param utcDate
-     * @param format
-     * @param displayTimeZone
-     */
-    formatDateString(utcDate?: string, format?: string | DisplayDateResolution, displayTimeZone?: TimeZone): string;
-    /**
-     * 숫자에 구분점을 넣는다. 소수점 이하가 있는 경우도 처리한다.
-     * * 12345 -> '12,345'
-     * * 12345.12345 -> '12,345.12345'
-     * * 0 -> '0'
-     * * undefined -> null
-     * * null -> null
-     *
-     * @param value
-     * @return
-     */
-    formatNumber(value?: number | string | null): string | null;
-    formatNumberByCode(value?: number | string | null, locale?: string | "ko-KR"): string | null;
-    /**
-     * 통화단위와 표시위치를 받아 출력한다
-     * @param value 값
-     * @param currencyUnit 통화단위
-     * @param prefix true 이면 withUnit을 앞에 붙이고, false 이면 뒤에 붙인다.
-     */
-    formatPrice(value?: number | string | null, currencyUnit?: string | "", prefix?: boolean): string | null;
-    /**
-     * rate 를 받아 percent 를 출력한다.
-     * * 0.1 -> 10%
-     * * 0.55 -> 55%
-     * * 0.551 -> 55.1%
-     * @param value 비율 값
-     * @param withUnit true 이면 % 를 붙이고, false 이면 붙이지 않는다.
-     * @param decimalPlace 소숫점 n번째에서 반올림한다.
-     */
-    formatPercent(value?: number | string | null, withUnit?: boolean, decimalPlace?: number): string | null;
-    /**
-     * 신용카드번호를 4자리 단위로 나누어 구분자를 넣는다.
-     * @param value
-     * @param separator 구분자
-     */
-    formatCreditCardNo(value: string, separator?: string): string | undefined;
-    /**
-     *  `HTML`태그가 포함된 문자열에서 text 만 남긴다.
-     *  @param textIncludedHTMLElement HTML 태그를 포함하는 문자열
-     *  @return HTML 태그가 제거된 문자열
-     */
-    toPlainText(textIncludedHTMLElement?: string): string;
-};

package/dist/util/typeUtil.d.ts

@@ -1,18 +0,0 @@
-export type FunctionPropertyNames<T> = {
-    [K in keyof T]: T[K] extends Function ? K : never;
-}[keyof T];
-export type FunctionProperties<T> = Pick<T, FunctionPropertyNames<T>>;
-export type NonFunctionPropertyNames<T> = {
-    [K in keyof T]: T[K] extends Function ? never : K;
-}[keyof T];
-export type NonFunctionProperties<T> = Pick<T, NonFunctionPropertyNames<T>>;
-export type PartialNonFunctionProperties<T> = Partial<NonFunctionProperties<T>>;
-export type RawData<T> = PartialNonFunctionProperties<T>;
-/**
- * Array 의 filter 로 null/undefined 가 아닌 것을 걸러낼 때 사용한다.
- * ```ts
- * const array: (string | null)[] = ['test', null, 'sample', undefined]
- * const filtered: string[] = array.filter(notNull)
- * ```
- */
-export declare function notNull<T>(value: T | null | undefined): value is T;

package/dist/util/waitUtil.d.ts

@@ -1,19 +0,0 @@
-/**
- * 특정 조건이 완료될 때까지 여러 번 계속 시도한다.
- * @param condition 조건
- * @param intervalMilliseconds 시도 간격
- * @param maxTrial 최대 시도 수
- */
-export declare const waitUntil: (condition: () => boolean, intervalMilliseconds?: number, maxTrial?: number) => Promise<void>;
-/**
- * 일정 시간동안 기다린다.
- * @param milliSec 기다리는 시간
- */
-export declare const waitDuring: (milliSec?: number) => Promise<void>;
-export declare const tryUntil: (until: () => boolean | undefined, tryCall: () => void, intervalMilliseconds?: number, maxTrial?: number) => void;
-declare const _default: {
-    waitUntil: (condition: () => boolean, intervalMilliseconds?: number, maxTrial?: number) => Promise<void>;
-    waitDuring: (milliSec?: number) => Promise<void>;
-    tryUntil: (until: () => boolean | undefined, tryCall: () => void, intervalMilliseconds?: number, maxTrial?: number) => void;
-};
-export default _default;

package/dist/validator/FieldValidator.d.ts

@@ -1,43 +0,0 @@
-import type { ComputedRef, Ref, UnwrapRef } from "vue";
-import type { FieldContext } from "@/model/FieldContext";
-export type ValidationError = {
-    code: string;
-    message: string | undefined;
-};
-export type ValidationPhase = 'input' | 'change' | 'blur' | 'form';
-export type FieldValidationRule<T> = (value: T, phase: ValidationPhase, fieldContext?: FieldContext<any>) => Promise<ValidationError[] | undefined> | ValidationError[] | undefined;
-export type FieldValidatorOption<T> = {
-    field?: Ref<HTMLElement | undefined>;
-    disabled: Ref<boolean> | ComputedRef<boolean>;
-    initialValue?: T;
-    isValid?: (value: UnwrapRef<T> | undefined, phase: ValidationPhase) => undefined | ValidationError[] | Promise<ValidationError[]>;
-    convertToValue?: (value: string | undefined) => UnwrapRef<T>;
-    convertFromValue?: (value: UnwrapRef<T | undefined>) => string;
-};
-export type FieldValidator<T> = {
-    stringValue: Ref<string | undefined>;
-    value: Ref<UnwrapRef<T> | undefined>;
-    valid: Ref<boolean>;
-    errors: Ref<ValidationError[]>;
-    touched: Ref<boolean>;
-    handleInput: (event: Event) => Promise<void>;
-    handleChange: (event: Event) => Promise<void>;
-    handleFocus: (event: Event) => void;
-    handleBlur: (event: Event) => void;
-    validateValue: (value: UnwrapRef<T>, phase: ValidationPhase) => Promise<void>;
-    validate: (phase?: ValidationPhase) => Promise<void>;
-    clearErrors: () => void;
-    getName: () => string;
-};
-export declare const storeFieldValidator: <T>(field: HTMLElement, validator: FieldValidator<T>) => void;
-export declare const loadFieldValidator: <T>(field: HTMLElement) => FieldValidator<T> | undefined;
-export declare const findFieldValidatorElements: (element?: HTMLElement) => NodeListOf<HTMLElement> | undefined;
-export declare const validateField: (field: HTMLElement | string, phase?: ValidationPhase) => Promise<void>;
-export declare const validateFields: (fields: (HTMLElement | string)[], phase?: ValidationPhase) => Promise<void>;
-export declare const fieldValidator: <T>(option: FieldValidatorOption<T>) => FieldValidator<T>;
-export declare const executeFieldValidationRule: <T>(value: T, rules: FieldValidationRule<T>[] | undefined, errors: ValidationError[], phase: ValidationPhase, fieldContext?: FieldContext<any>) => Promise<boolean>;
-export declare const executeRequiredValidation: (value: string | number | undefined, checkRequired: boolean, requiredMessage: string | undefined, errors: ValidationError[]) => boolean;
-export declare const executeRegExpValidation: (value: string, regexp: string | undefined, message: string | undefined, errors: ValidationError[]) => boolean;
-export declare const executeBetweenLengthValidation: (text: string, minLength: number | undefined, minLengthMessage: string | undefined, maxLength: number | undefined, maxLengthMessage: string | undefined, betweenLengthMessage: string | undefined, errors: ValidationError[]) => boolean;
-export declare const executeBetweenValueValidation: (value: number, minValue: number | undefined, minValueMessage: string | undefined, maxValue: number | undefined, maxValueMessage: string | undefined, betweenValueMessage: string | undefined, errors: ValidationError[]) => boolean;
-export declare const executeDateRangeValidation: (fromValue: string | undefined, toValue: string | undefined, validationMessage: string | undefined, erros: ValidationError[]) => boolean;