npm - @g1cloud/open-bluesea-core - Versions diffs - 1.0.0-alpha.1 - Mend

@g1cloud/open-bluesea-core 1.0.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

package/css/bluesea.css +95 -0
package/dist/blueseaPlugin.d.ts +36 -0
package/dist/component/basic/PageNavigation.model.d.ts +5 -0
package/dist/contextmenu/contextMenuPlugin.d.ts +36 -0
package/dist/directive/vClickOutside.d.ts +20 -0
package/dist/directive/vFocusOnLoad.d.ts +3 -0
package/dist/directive/vTooltip.d.ts +7 -0
package/dist/index.d.ts +35 -0
package/dist/model/CommonTypes.d.ts +29 -0
package/dist/model/DefaultImpl.d.ts +7 -0
package/dist/model/FieldContext.d.ts +14 -0
package/dist/notification/notificationPlugin.d.ts +31 -0
package/dist/open-bluesea-core.css +1 -0
package/dist/open-bluesea-core.es.js +2371 -0
package/dist/open-bluesea-core.umd.js +1 -0
package/dist/savepoint/SavePoint.d.ts +46 -0
package/dist/util/componentUtil.d.ts +11 -0
package/dist/util/debounceUtil.d.ts +16 -0
package/dist/util/formatUtil.d.ts +67 -0
package/dist/util/typeUtil.d.ts +18 -0
package/dist/util/waitUtil.d.ts +19 -0
package/dist/validator/FieldValidator.d.ts +43 -0
package/package.json +44 -0

package/dist/open-bluesea-core.umd.js ADDED Viewed

@@ -0,0 +1 @@

package/dist/savepoint/SavePoint.d.ts ADDED Viewed

@@ -0,0 +1,46 @@
+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 ADDED Viewed

@@ -0,0 +1,11 @@
+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 ADDED Viewed

@@ -0,0 +1,16 @@
+/**
+ * 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 ADDED Viewed

@@ -0,0 +1,67 @@
+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
+     */
+    /**
+     * 숫자에 구분점을 넣는다. 소수점 이하가 있는 경우도 처리한다.
+     * * 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 ADDED Viewed

@@ -0,0 +1,18 @@
+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 ADDED Viewed

@@ -0,0 +1,19 @@
+/**
+ * 특정 조건이 완료될 때까지 여러 번 계속 시도한다.
+ * @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 ADDED Viewed

@@ -0,0 +1,43 @@
+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;

package/package.json ADDED Viewed

@@ -0,0 +1,44 @@
+{
+  "name": "@g1cloud/open-bluesea-core",
+  "description": "Vue UI Library for Management Console.",
+  "license": "Proprietary",
+  "private": false,
+  "version": "1.0.0-alpha.1",
+  "type": "module",
+  "engines": {
+    "node": ">= 24.3.0"
+  },
+  "author": "kimos@g1project.net",
+  "main": "./dist/open-bluesea-core.umd.js",
+  "module": "./dist/open-bluesea-core.es.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "css",
+    "!dist/tests"
+  ],
+  "devDependencies": {
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/node": "^24.3.0",
+    "@vitejs/plugin-vue": "^6.0.1",
+    "typescript": "~5.9.3",
+    "vite": "^7.1.12",
+    "vue-tsc": "^3.1.3"
+  },
+  "dependencies": {
+    "dayjs": "^1.11.19",
+    "tslib": "^2.8.1",
+    "vue": "^3.5.22"
+  },
+  "peerDependencies": {
+    "dayjs": "^1.11.19",
+    "tslib": "^2.8.1",
+    "vue": "^3.5.22"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vue-tsc && vite build",
+    "preview": "vite preview",
+    "test": "vitest"
+  }
+}