@rchemist/listgrid 0.2.6

package/dist/listgrid/ui/UIProvider.d.ts

@@ -0,0 +1,151 @@
+import { ReactNode, ComponentType } from 'react';
+export interface UIComponents {
+    Alert: ComponentType<any>;
+    Badge: ComponentType<any>;
+    BooleanRadio: ComponentType<any>;
+    Box: ComponentType<any>;
+    Breadcrumb: ComponentType<any>;
+    /** Optional — library never renders it, type alias kept for host contracts. */
+    BreadcrumbItem?: ComponentType<any>;
+    Button: ComponentType<any>;
+    CheckBox: ComponentType<any>;
+    CheckBoxChip: ComponentType<any>;
+    CheckButtonValidationInput: ComponentType<any>;
+    ColorInput: ComponentType<any>;
+    Dropdown: ComponentType<any>;
+    EmailDomainCheckButtonInput: ComponentType<any>;
+    EmailDomainInput: ComponentType<any>;
+    FileUploadInput: ComponentType<any>;
+    Flex: ComponentType<any>;
+    FlatPickrDateField: ComponentType<any>;
+    Grid: ComponentType<any>;
+    Group: ComponentType<any>;
+    Indicator: ComponentType<any>;
+    InlineMap: ComponentType<any>;
+    LazyFileUploadInput: ComponentType<any>;
+    LinearIndicator: ComponentType<any>;
+    LoadingOverlay: ComponentType<any>;
+    MarkdownEditor: ComponentType<any>;
+    Modal: ComponentType<any>;
+    MultiSelectBox: ComponentType<any>;
+    NumberInput: ComponentType<any>;
+    Pagination: ComponentType<any>;
+    Paper: ComponentType<any>;
+    /** Optional — the host kit exposes only PasswordStrengthView; type alias below. */
+    PasswordStrength?: ComponentType<any>;
+    PasswordStrengthView: ComponentType<any>;
+    Popover: ComponentType<any>;
+    RadioChip: ComponentType<any>;
+    RadioInput: ComponentType<any>;
+    SafePerfectScrollbar: ComponentType<any>;
+    SelectBox: ComponentType<any>;
+    SimpleGrid: ComponentType<any>;
+    Skeleton: ComponentType<any>;
+    Stack: ComponentType<any>;
+    Stepper: ComponentType<any>;
+    Table: ComponentType<any>;
+    TagsInput: ComponentType<any>;
+    Textarea: ComponentType<any>;
+    TextInput: ComponentType<any>;
+    Tooltip: ComponentType<any>;
+    TooltipCard: ComponentType<any>;
+    Tree: ComponentType<any>;
+    UserView: ComponentType<any>;
+}
+export interface UIProviderProps {
+    components: UIComponents;
+    children: ReactNode;
+}
+export declare function UIProvider({ components, children }: UIProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useUI(): UIComponents;
+export declare const Alert: any;
+export declare const Badge: any;
+export declare const BooleanRadio: any;
+export declare const Box: any;
+export declare const Breadcrumb: any;
+export declare const BreadcrumbItem: any;
+export declare const Button: any;
+export declare const CheckBox: any;
+export declare const CheckBoxChip: any;
+export declare const CheckButtonValidationInput: any;
+export declare const ColorInput: any;
+export declare const Dropdown: any;
+export declare const EmailDomainCheckButtonInput: any;
+export declare const EmailDomainInput: any;
+export declare const FileUploadInput: any;
+export declare const Flex: any;
+export declare const FlatPickrDateField: any;
+export declare const Grid: any;
+export declare const Group: any;
+export declare const Indicator: any;
+export declare const InlineMap: any;
+export declare const LazyFileUploadInput: any;
+export declare const LinearIndicator: any;
+export declare const LoadingOverlay: any;
+export declare const MarkdownEditor: any;
+export declare const Modal: any;
+export declare const MultiSelectBox: any;
+export declare const NumberInput: any;
+export declare const Pagination: any;
+export declare const Paper: any;
+export declare const PasswordStrength: any;
+export declare const PasswordStrengthView: any;
+export declare const Popover: any;
+export declare const RadioChip: any;
+export declare const RadioInput: any;
+export declare const SafePerfectScrollbar: any;
+export declare const SelectBox: any;
+export declare const SimpleGrid: any;
+export declare const Skeleton: any;
+export declare const Stack: any;
+export declare const Stepper: any;
+export declare const Table: any;
+export declare const TagsInput: any;
+export declare const Textarea: any;
+export declare const TextInput: any;
+export declare const Tooltip: any;
+export declare const TooltipCard: any;
+export declare const Tree: any;
+export declare const UserView: any;
+export type TooltipColor = any;
+export type TreeNodeData = any;
+export type InlineMapPendingRef = any;
+export type KeyValue = any;
+export type BreadcrumbItem = any;
+export type Tree = any;
+export type Currency = any;
+export type Double = any;
+export type PasswordStrength = any;
+export interface FileInfo {
+    url: string;
+    id: string;
+    deleteType?: 'new' | 'exist' | 'none';
+    fileSize?: number;
+    fileName?: string;
+}
+export interface IFileField {
+    existFiles?: FileInfo[];
+    newFiles?: FileInfo[];
+    deleteFiles?: FileInfo[];
+}
+export declare class FileFieldValue implements IFileField {
+    existFiles: FileInfo[];
+    newFiles: FileInfo[];
+    deleteFiles: FileInfo[];
+    static create(data?: any): FileFieldValue;
+    addNewValue(fileInfo: FileInfo): boolean;
+    addExistValue(fileInfo: FileInfo): boolean;
+    addDeleteValue(fileInfo: FileInfo): FileInfo | undefined;
+    getValue(): string;
+    getCurrentFileList(): FileInfo[];
+    isDirty(): boolean;
+    hasValue(): boolean;
+    rollbackDeleteFile(file: FileInfo): void;
+    getRenderKey(): string;
+    clone(): FileFieldValue;
+}
+export declare const DEFAULT_EMAIL_DOMAINS: string[];
+export declare function readonlyClass(readonly: boolean | undefined, extra?: string): string;
+export declare const Currency: any;
+export declare const Double: any;
+export declare function getPlainText(html: string | null | undefined): string;

package/dist/listgrid/ui/UIProvider.js

@@ -0,0 +1,292 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+const UIContext = createContext(null);
+export function UIProvider({ components, children }) {
+    return _jsx(UIContext.Provider, { value: components, children: children });
+}
+export function useUI() {
+    const ctx = useContext(UIContext);
+    if (ctx === null) {
+        throw new Error('[@rchemist/listgrid] useUI must be called within a <UIProvider>. ' +
+            'Wrap your app with <UIProvider components={...}> imported from @rchemist/listgrid.');
+    }
+    return ctx;
+}
+// Thin wrapper factory — each wrapper defers to the host-provided component
+// at render time via Context lookup. Typed as `any` so wrappers can carry
+// compound sub-components (e.g. Table.Th) as static properties without TS
+// complaining, matching the original the legacy UI kit API surface.
+// React inspects components for these properties during rendering. If our
+// Proxy intercepts them and returns wrapper components, React mistakes the
+// function component for a class component and emits noisy warnings. Only
+// PascalCase names (conventional compound children like Table.Th) are
+// forwarded through the compound mechanism; everything else falls through
+// to the real wrapper function's own properties.
+const REACT_INTROSPECTION_PROPS = new Set([
+    'childContextTypes',
+    'contextTypes',
+    'contextType',
+    'getDerivedStateFromProps',
+    'defaultProps',
+    'propTypes',
+    'displayName',
+    'render',
+    'type',
+    '$$typeof',
+    'compare',
+    'name',
+    'length',
+    'prototype',
+    'call',
+    'apply',
+    'bind',
+    'toString',
+]);
+function makeWrapper(name) {
+    const Wrapper = (props) => {
+        const comps = useUI();
+        const Component = comps[name];
+        if (!Component) {
+            throw new Error(`[@rchemist/listgrid] UI component "${String(name)}" missing from UIProvider.`);
+        }
+        return _jsx(Component, { ...props });
+    };
+    Wrapper.displayName = `rcm.${String(name)}`;
+    return new Proxy(Wrapper, {
+        get(target, prop, receiver) {
+            if (prop in target)
+                return Reflect.get(target, prop, receiver);
+            if (typeof prop === 'symbol')
+                return Reflect.get(target, prop, receiver);
+            if (REACT_INTROSPECTION_PROPS.has(prop))
+                return undefined;
+            // Only treat PascalCase names as compound children. Lowercase access
+            // (React internal checks, stray property access) returns undefined.
+            const key = prop;
+            if (!/^[A-Z]/.test(key))
+                return undefined;
+            const SubWrapper = (subProps) => {
+                const comps = useUI();
+                const Parent = comps[name];
+                if (!Parent) {
+                    throw new Error(`[@rchemist/listgrid] UI component "${String(name)}" missing from UIProvider.`);
+                }
+                const Sub = Parent[key];
+                if (!Sub) {
+                    throw new Error(`[@rchemist/listgrid] Compound "${String(name)}.${key}" missing on host component.`);
+                }
+                return _jsx(Sub, { ...subProps });
+            };
+            SubWrapper.displayName = `rcm.${String(name)}.${key}`;
+            return SubWrapper;
+        },
+    });
+}
+export const Alert = makeWrapper('Alert');
+export const Badge = makeWrapper('Badge');
+export const BooleanRadio = makeWrapper('BooleanRadio');
+export const Box = makeWrapper('Box');
+export const Breadcrumb = makeWrapper('Breadcrumb');
+export const BreadcrumbItem = makeWrapper('BreadcrumbItem');
+export const Button = makeWrapper('Button');
+export const CheckBox = makeWrapper('CheckBox');
+export const CheckBoxChip = makeWrapper('CheckBoxChip');
+export const CheckButtonValidationInput = makeWrapper('CheckButtonValidationInput');
+export const ColorInput = makeWrapper('ColorInput');
+export const Dropdown = makeWrapper('Dropdown');
+export const EmailDomainCheckButtonInput = makeWrapper('EmailDomainCheckButtonInput');
+export const EmailDomainInput = makeWrapper('EmailDomainInput');
+export const FileUploadInput = makeWrapper('FileUploadInput');
+export const Flex = makeWrapper('Flex');
+export const FlatPickrDateField = makeWrapper('FlatPickrDateField');
+export const Grid = makeWrapper('Grid');
+export const Group = makeWrapper('Group');
+export const Indicator = makeWrapper('Indicator');
+export const InlineMap = makeWrapper('InlineMap');
+export const LazyFileUploadInput = makeWrapper('LazyFileUploadInput');
+export const LinearIndicator = makeWrapper('LinearIndicator');
+export const LoadingOverlay = makeWrapper('LoadingOverlay');
+export const MarkdownEditor = makeWrapper('MarkdownEditor');
+export const Modal = makeWrapper('Modal');
+export const MultiSelectBox = makeWrapper('MultiSelectBox');
+export const NumberInput = makeWrapper('NumberInput');
+export const Pagination = makeWrapper('Pagination');
+export const Paper = makeWrapper('Paper');
+export const PasswordStrength = makeWrapper('PasswordStrength');
+export const PasswordStrengthView = makeWrapper('PasswordStrengthView');
+export const Popover = makeWrapper('Popover');
+export const RadioChip = makeWrapper('RadioChip');
+export const RadioInput = makeWrapper('RadioInput');
+export const SafePerfectScrollbar = makeWrapper('SafePerfectScrollbar');
+export const SelectBox = makeWrapper('SelectBox');
+export const SimpleGrid = makeWrapper('SimpleGrid');
+export const Skeleton = makeWrapper('Skeleton');
+export const Stack = makeWrapper('Stack');
+export const Stepper = makeWrapper('Stepper');
+export const Table = makeWrapper('Table');
+export const TagsInput = makeWrapper('TagsInput');
+export const Textarea = makeWrapper('Textarea');
+export const TextInput = makeWrapper('TextInput');
+export const Tooltip = makeWrapper('Tooltip');
+export const TooltipCard = makeWrapper('TooltipCard');
+export const Tree = makeWrapper('Tree');
+export const UserView = makeWrapper('UserView');
+export class FileFieldValue {
+    constructor() {
+        this.existFiles = [];
+        this.newFiles = [];
+        this.deleteFiles = [];
+    }
+    static create(data) {
+        const value = new FileFieldValue();
+        if (!data)
+            return value;
+        if (data instanceof FileFieldValue) {
+            value.newFiles = [...(data.newFiles || [])];
+            value.existFiles = [...(data.existFiles || [])];
+            value.deleteFiles = [...(data.deleteFiles || [])];
+            return value;
+        }
+        value.newFiles = data.newFiles ?? [];
+        value.existFiles = data.existFiles ?? [];
+        value.deleteFiles = data.deleteFiles ?? [];
+        return value;
+    }
+    addNewValue(fileInfo) {
+        if (fileInfo.id === undefined || fileInfo.id === null || fileInfo.id === '')
+            return false;
+        const exist = this.newFiles.some((v) => v.url === fileInfo.url);
+        if (!exist) {
+            this.newFiles.push(fileInfo);
+            return true;
+        }
+        return false;
+    }
+    addExistValue(fileInfo) {
+        if (fileInfo.id === undefined || fileInfo.id === null || fileInfo.id === '')
+            return false;
+        const inNew = this.newFiles.some((v) => v.url === fileInfo.url);
+        if (inNew)
+            return false;
+        const inExist = this.existFiles.some((v) => v.url === fileInfo.url);
+        if (inExist)
+            return false;
+        this.existFiles.push(fileInfo);
+        return true;
+    }
+    addDeleteValue(fileInfo) {
+        const already = this.deleteFiles.some((v) => v.url === fileInfo.url);
+        if (already)
+            return undefined;
+        let exist = false;
+        let result = 'none';
+        for (let i = 0; i < this.existFiles.length; i++) {
+            if (this.existFiles[i].url === fileInfo.url) {
+                fileInfo.id = this.existFiles[i].id;
+                this.existFiles.splice(i, 1);
+                exist = true;
+                result = 'exist';
+                break;
+            }
+        }
+        for (let i = 0; i < this.newFiles.length; i++) {
+            if (this.newFiles[i].url === fileInfo.url) {
+                fileInfo.id = this.newFiles[i].id;
+                this.newFiles.splice(i, 1);
+                exist = true;
+                result = 'new';
+                break;
+            }
+        }
+        if (exist) {
+            this.deleteFiles.push({ ...fileInfo, deleteType: result });
+        }
+        return { ...fileInfo, deleteType: result };
+    }
+    getValue() {
+        try {
+            return JSON.stringify(this);
+        }
+        catch {
+            return '';
+        }
+    }
+    getCurrentFileList() {
+        const all = [...this.existFiles, ...this.newFiles];
+        return all.filter((file) => !this.deleteFiles.some((d) => d.url === file.url));
+    }
+    isDirty() {
+        return this.newFiles.length > 0 || (this.deleteFiles.length > 0 && this.existFiles.length > 0);
+    }
+    hasValue() {
+        return this.existFiles.length > 0 || this.newFiles.length > 0 || this.deleteFiles.length > 0;
+    }
+    rollbackDeleteFile(file) {
+        for (let i = 0; i < this.deleteFiles.length; i++) {
+            if (this.deleteFiles[i].url === file.url) {
+                this.deleteFiles.splice(i, 1);
+                {
+                    const { deleteType: _dt, ...rest } = file;
+                    void _dt;
+                    if (file.deleteType === 'new') {
+                        this.newFiles.push(rest);
+                    }
+                    else if (file.deleteType === 'exist') {
+                        this.existFiles.push(rest);
+                    }
+                }
+                break;
+            }
+        }
+    }
+    getRenderKey() {
+        let key = '';
+        this.existFiles.forEach((v) => {
+            key += 'exist_' + v.id;
+        });
+        this.newFiles.forEach((v) => {
+            key += 'new_' + v.id;
+        });
+        this.deleteFiles.forEach((v) => {
+            key += 'delete_' + v.id;
+        });
+        let hash = 0;
+        for (let i = 0; i < key.length; i++) {
+            hash = (hash << 5) - hash + key.charCodeAt(i);
+            hash = hash & hash;
+        }
+        return String(hash);
+    }
+    clone() {
+        const c = new FileFieldValue();
+        c.deleteFiles = [...this.deleteFiles];
+        c.existFiles = [...this.existFiles];
+        c.newFiles = [...this.newFiles];
+        return c;
+    }
+}
+// Constants whose concrete values host apps may override through other means.
+export const DEFAULT_EMAIL_DOMAINS = [
+    'gmail.com',
+    'naver.com',
+    'daum.net',
+    'kakao.com',
+    'hanmail.net',
+    'nate.com',
+];
+// Previously returned the Tailwind string "bg-gray-100 opacity-60 cursor-not-allowed".
+// Now returns the library's scoped class so hosts without Tailwind still get
+// the readonly visual via @rchemist/listgrid/styles.css.
+export function readonlyClass(readonly, extra = '') {
+    return readonly ? `rcm-readonly ${extra}`.trim() : extra;
+}
+// NumberInput-adjacent value helpers. Kept as any wrappers.
+export const Currency = {};
+export const Double = {};
+// Tiptap-adjacent helper used in validations.
+export function getPlainText(html) {
+    if (!html)
+        return '';
+    return String(html).replace(/<[^>]*>/g, '');
+}

package/dist/listgrid/ui/index.d.ts

@@ -0,0 +1,2 @@
+export * from './UIProvider';
+export * from './GlobalModalManager';

package/dist/listgrid/ui/index.js

@@ -0,0 +1,2 @@
+export * from './UIProvider';
+export * from './GlobalModalManager';

package/dist/listgrid/urlState/UrlStateProvider.d.ts

@@ -0,0 +1,8 @@
+import { ReactNode } from 'react';
+import type { QueryStatesSetter, UrlParser, UrlStateServices, UrlStateSetOptions } from './types';
+export interface UrlStateProviderProps {
+    value: UrlStateServices;
+    children: ReactNode;
+}
+export declare function UrlStateProvider({ value, children }: UrlStateProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useQueryStates(parsers: Record<string, UrlParser<any>>, options?: UrlStateSetOptions): [Record<string, any>, QueryStatesSetter];

package/dist/listgrid/urlState/UrlStateProvider.js

@@ -0,0 +1,20 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+const UrlStateContext = createContext(null);
+export function UrlStateProvider({ value, children }) {
+    return _jsx(UrlStateContext.Provider, { value: value, children: children });
+}
+function mustUrlState() {
+    // eslint-disable-next-line react-hooks/rules-of-hooks -- assertion helper always invoked from within hooks/components below
+    const ctx = useContext(UrlStateContext);
+    if (!ctx) {
+        throw new Error('[@rchemist/listgrid] useQueryStates must be called within a <UrlStateProvider>. ' +
+            'Wrap your app with <UrlStateProvider value={...}> imported from @rchemist/listgrid. ' +
+            'See @rchemist/listgrid-next for a Next.js (nuqs) adapter.');
+    }
+    return ctx;
+}
+export function useQueryStates(parsers, options) {
+    return mustUrlState().useQueryStates(parsers, options);
+}

package/dist/listgrid/urlState/index.d.ts

@@ -0,0 +1,4 @@
+export type { UrlParser, UrlStateSetOptions, QueryStatesSetter, UrlStateServices } from './types';
+export { createParser, parseAsString } from './types';
+export { UrlStateProvider, useQueryStates } from './UrlStateProvider';
+export type { UrlStateProviderProps } from './UrlStateProvider';

package/dist/listgrid/urlState/index.js

@@ -0,0 +1,2 @@
+export { createParser, parseAsString } from './types';
+export { UrlStateProvider, useQueryStates } from './UrlStateProvider';

package/dist/listgrid/urlState/types.d.ts

@@ -0,0 +1,21 @@
+export interface UrlParser<T> {
+    parse: (value: string) => T | null;
+    serialize: (value: T) => string;
+    eq?: (a: T, b: T) => boolean;
+}
+export interface UrlStateSetOptions {
+    history?: 'push' | 'replace';
+    shallow?: boolean;
+}
+export type QueryStatesSetter = (values: Record<string, any> | null | ((prev: Record<string, any>) => Record<string, any>), options?: UrlStateSetOptions) => any;
+export interface UrlStateServices {
+    /**
+     * Hook reading and writing URL query parameters via host-supplied parsers.
+     * Intentionally typed loosely; the Next.js adapter bridges to `nuqs.useQueryStates`.
+     */
+    useQueryStates: (parsers: Record<string, UrlParser<any>>, options?: UrlStateSetOptions) => [Record<string, any>, QueryStatesSetter];
+}
+/** Framework-agnostic factory mirroring nuqs's `createParser`. */
+export declare function createParser<T>(config: UrlParser<T>): UrlParser<T>;
+/** Simple pass-through string parser matching nuqs's `parseAsString`. */
+export declare const parseAsString: UrlParser<string>;

package/dist/listgrid/urlState/types.js

@@ -0,0 +1,14 @@
+// Stage 7d — Framework-agnostic URL state contract.
+//
+// Host adapters (e.g. @rchemist/listgrid-next using nuqs) implement the
+// `useQueryStates` hook. Listgrid code defines its parsers via
+// `createParser` and consumes them through the adapter-provided hook.
+/** Framework-agnostic factory mirroring nuqs's `createParser`. */
+export function createParser(config) {
+    return { ...config };
+}
+/** Simple pass-through string parser matching nuqs's `parseAsString`. */
+export const parseAsString = {
+    parse: (v) => v,
+    serialize: (v) => v,
+};

package/dist/listgrid/utils/BooleanUtil.d.ts

@@ -0,0 +1 @@
+export declare function isTrue(value: boolean | string | undefined | unknown, defaultValue?: boolean): boolean;

package/dist/listgrid/utils/BooleanUtil.js

@@ -0,0 +1,9 @@
+export function isTrue(value, defaultValue) {
+    if (value === undefined || value === null || value === '') {
+        return defaultValue ?? false;
+    }
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    return value === 'true' || value === '1' || value === 'on' || value === 'yes' || value === '예';
+}

package/dist/listgrid/utils/CompareUtil.d.ts

@@ -0,0 +1,7 @@
+export declare function isNulls(value: unknown, other: unknown): boolean;
+export declare function isEquals(value: unknown, other: unknown): boolean;
+export declare function isEqualsIgnoreCase(value: string | null | undefined, other: string | null | undefined): boolean;
+export declare function isEqualCollection(value: unknown[], other: unknown[], ignoreOrder?: boolean): boolean;
+export declare function isEmpty(collection: Map<unknown, unknown> | unknown[] | undefined | null): boolean;
+export declare function isPositive(value?: number): boolean;
+export declare function isNegative(value?: number): boolean;

package/dist/listgrid/utils/CompareUtil.js

@@ -0,0 +1,87 @@
+import { isTrue } from './BooleanUtil';
+export function isNulls(value, other) {
+    if (value === undefined && other === undefined) {
+        return true;
+    }
+    if (value === undefined) {
+        if (other === null) {
+            return true;
+        }
+        else if (other === '') {
+            return true;
+        }
+    }
+    else {
+        if (other === undefined) {
+            if (value === null) {
+                return true;
+            }
+            else if (value === '') {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+export function isEquals(value, other) {
+    const isNull = isNulls(value, other);
+    if (isNull) {
+        return true;
+    }
+    if (value === other) {
+        return true;
+    }
+    // plain object deep comparison
+    if (typeof value === 'object' &&
+        typeof other === 'object' &&
+        value !== null &&
+        other !== null &&
+        !Array.isArray(value) &&
+        !Array.isArray(other)) {
+        const a = value;
+        const b = other;
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length)
+            return false;
+        return keysA.every((key) => keysB.includes(key) && isEquals(a[key], b[key]));
+    }
+    return false;
+}
+export function isEqualsIgnoreCase(value, other) {
+    const isNull = isNulls(value, other);
+    if (isNull) {
+        return true;
+    }
+    return value.toLowerCase() === other.toLowerCase();
+}
+export function isEqualCollection(value, other, ignoreOrder = false) {
+    if (value.length !== other.length) {
+        return false;
+    }
+    if (isTrue(ignoreOrder)) {
+        return value.every((v) => other.includes(v));
+    }
+    return value.every((v, i) => isEquals(v, other[i]));
+}
+export function isEmpty(collection) {
+    if (collection === undefined || collection === null) {
+        return true;
+    }
+    if (collection instanceof Map) {
+        return collection.size === 0;
+    }
+    return collection.length === 0;
+}
+export function isPositive(value) {
+    if (value === undefined || value === null) {
+        return false;
+    }
+    return value > 0;
+}
+export function isNegative(value) {
+    if (value === undefined || value === null) {
+        return false;
+    }
+    return value < 0;
+}

package/dist/listgrid/utils/PhoneUtil.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 전화번호에서 하이픈을 제거합니다.
+ * @param phoneNumber 전화번호 문자열 (하이픈 포함 가능)
+ * @returns 하이픈이 제거된 숫자만 있는 문자열
+ * @example removePhoneNumberHyphens("010-1234-5678") => "01012345678"
+ * @example removePhoneNumberHyphens("01012345678") => "01012345678"
+ */
+export declare function removePhoneNumberHyphens(phoneNumber: string | null | undefined): string;
+/**
+ * 전화번호를 하이픈이 포함된 형식으로 포맷팅합니다.
+ * 10자리: 000-0000-0000 (예: 02-1234-5678)
+ * 11자리: 000-0000-0000 (예: 010-1234-5678)
+ * @param phoneNumber 전화번호 문자열 (숫자만)
+ * @returns 하이픈이 포함된 전화번호 문자열
+ * @example formatPhoneNumber("01012345678") => "010-1234-5678"
+ * @example formatPhoneNumber("0212345678") => "02-1234-5678"
+ * @example formatPhoneNumber("010-1234-5678") => "010-1234-5678" (이미 포맷팅된 경우)
+ */
+export declare function formatPhoneNumber(phoneNumber: string | null | undefined): string;