@aithe/aithe-ui 26.2.2 → 26.3.1

package/dist/core/datahub/utils/is-query.js

@@ -0,0 +1,53 @@
+/**
+ * @file URL 查询动作识别 / URL Query Action Detection
+ * @description 根据 URL 最后一段路径判断请求是否为查询类动作。
+ *              识别关键词可配置，默认：query、list、get。
+ *              用于策略自动选择：查询类走缓存+去重，提交类走幂等防护。
+ *              Determines whether a request is a query action based on the last URL path segment.
+ *              Recognized keywords are configurable, defaulting to: query, list, get.
+ *              Used for automatic strategy selection: query → cache + dedup, submit → idempotent guard.
+ */
+/** 默认查询类动作关键词列表 / Default query action keyword list */
+const DEFAULT_QUERY_KEYWORDS = ['query', 'list', 'get'];
+/** 当前生效的查询关键词列表 / Currently active query keyword list */
+let queryKeywords = [...DEFAULT_QUERY_KEYWORDS];
+/**
+ * 设置查询类动作关键词 / Set query action keywords
+ * @param keywords - 自定义关键词列表，将替换默认列表 / Custom keyword list, replaces the default list
+ * @description 允许外部扩展或覆盖默认的查询关键词，
+ *              例如添加 "search"、"fetch" 等自定义查询动作。
+ *              Allows external extension or override of default query keywords,
+ *              e.g. adding "search", "fetch" as custom query actions.
+ *
+ * @example
+ * setQueryKeywords(['query', 'list', 'get', 'search', 'fetch']);
+ */
+export function setQueryKeywords(keywords) {
+    queryKeywords = keywords;
+}
+/**
+ * 获取当前查询关键词列表 / Get current query keyword list
+ * @returns 当前生效的关键词列表副本 / Copy of currently active keyword list
+ */
+export function getQueryKeywords() {
+    return [...queryKeywords];
+}
+/**
+ * 判断 URL 是否为查询类动作 / Determine if the URL represents a query action
+ * @param url - 请求地址，如 "/order/query"、"/user/list" / Request URL, e.g. "/order/query", "/user/list"
+ * @returns true 表示查询类动作，false 表示提交类动作 / true for query action, false for submit action
+ *
+ * @example
+ * isQueryAction('/order/query')   // true
+ * isQueryAction('/order/submit')  // false
+ * isQueryAction('/user/list')     // true
+ * isQueryAction('/order/pay')     // false
+ */
+export function isQueryAction(url) {
+    let cleaned = url;
+    while (cleaned.endsWith('/')) {
+        cleaned = cleaned.slice(0, -1);
+    }
+    const segment = cleaned.split('/').pop()?.toLowerCase() ?? '';
+    return queryKeywords.some((kw) => segment === kw || segment.startsWith(kw + '/'));
+}

package/dist/core/datahub/utils/loading.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @file 全局 Loading 状态管理 / Global Loading State Management
+ * @description 提供请求级别的 loading 状态追踪与订阅机制。
+ *              业务层可监听 loading 变化来控制 UI 中的加载指示器。
+ *              基于 URL 粒度管理，使用计数模式支持同一 URL 的多次并发请求叠加，
+ *              只有计数归零时才触发 loading=false 回调。
+ *              Provides request-level loading state tracking and subscription mechanism.
+ *              The business layer can listen for loading changes to control UI loading indicators.
+ *              Managed at URL granularity, using a counter model to support overlapping requests
+ *              for the same URL. Only triggers loading=false callback when the count reaches zero.
+ */
+/** Loading 状态变更监听器 / Loading state change listener */
+type LoadingListener = (url: string, loading: boolean) => void;
+/**
+ * 标记请求开始 / Mark request as started
+ * @param url - 请求地址 / Request URL
+ * @description 计数 +1，首次从 0→1 时通知监听器 loading=true
+ *              Counter +1, notifies listeners loading=true on first transition 0→1
+ */
+export declare function loadingStart(url: string): void;
+/**
+ * 标记请求结束 / Mark request as ended
+ * @param url - 请求地址 / Request URL
+ * @description 计数 -1，归零时通知监听器 loading=false
+ *              Counter -1, notifies listeners loading=false when count reaches zero
+ */
+export declare function loadingEnd(url: string): void;
+/**
+ * 查询指定 URL 是否正在加载 / Check if the specified URL is currently loading
+ * @param url - 请求地址 / Request URL
+ * @returns 是否正在加载 / Whether it is currently loading
+ */
+export declare function isLoading(url: string): boolean;
+/**
+ * 订阅 loading 状态变更 / Subscribe to loading state changes
+ * @param fn - 状态变更回调 / State change callback
+ * @returns 取消订阅函数 / Unsubscribe function
+ *
+ * @example
+ * const unsubscribe = onLoadingChange((url, loading) => {
+ *   if (url === '/order/query') {
+ *     setSpinnerVisible(loading);
+ *   }
+ * });
+ * // 组件卸载时取消订阅 / Unsubscribe on component unmount
+ * unsubscribe();
+ */
+export declare function onLoadingChange(fn: LoadingListener): () => void;
+export {};
+//# sourceMappingURL=loading.d.ts.map

package/dist/core/datahub/utils/loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading.d.ts","sourceRoot":"","sources":["../../../../src/core/datahub/utils/loading.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,sDAAsD;AACtD,KAAK,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAQ/D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQ9C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAY5C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,eAAe,GAAG,MAAM,IAAI,CAK/D"}

package/dist/core/datahub/utils/loading.js

@@ -0,0 +1,78 @@
+/**
+ * @file 全局 Loading 状态管理 / Global Loading State Management
+ * @description 提供请求级别的 loading 状态追踪与订阅机制。
+ *              业务层可监听 loading 变化来控制 UI 中的加载指示器。
+ *              基于 URL 粒度管理，使用计数模式支持同一 URL 的多次并发请求叠加，
+ *              只有计数归零时才触发 loading=false 回调。
+ *              Provides request-level loading state tracking and subscription mechanism.
+ *              The business layer can listen for loading changes to control UI loading indicators.
+ *              Managed at URL granularity, using a counter model to support overlapping requests
+ *              for the same URL. Only triggers loading=false callback when the count reaches zero.
+ */
+/** 已注册的监听器集合 / Registered listener set */
+const listeners = new Set();
+/** 每个 URL 的并发请求计数 / Concurrent request count per URL */
+const counterMap = new Map();
+/**
+ * 标记请求开始 / Mark request as started
+ * @param url - 请求地址 / Request URL
+ * @description 计数 +1，首次从 0→1 时通知监听器 loading=true
+ *              Counter +1, notifies listeners loading=true on first transition 0→1
+ */
+export function loadingStart(url) {
+    const prev = counterMap.get(url) ?? 0;
+    counterMap.set(url, prev + 1);
+    if (prev === 0) {
+        for (const fn of listeners) {
+            fn(url, true);
+        }
+    }
+}
+/**
+ * 标记请求结束 / Mark request as ended
+ * @param url - 请求地址 / Request URL
+ * @description 计数 -1，归零时通知监听器 loading=false
+ *              Counter -1, notifies listeners loading=false when count reaches zero
+ */
+export function loadingEnd(url) {
+    const prev = counterMap.get(url) ?? 0;
+    if (prev <= 1) {
+        counterMap.delete(url);
+        if (prev === 1) {
+            for (const fn of listeners) {
+                fn(url, false);
+            }
+        }
+    }
+    else {
+        counterMap.set(url, prev - 1);
+    }
+}
+/**
+ * 查询指定 URL 是否正在加载 / Check if the specified URL is currently loading
+ * @param url - 请求地址 / Request URL
+ * @returns 是否正在加载 / Whether it is currently loading
+ */
+export function isLoading(url) {
+    return (counterMap.get(url) ?? 0) > 0;
+}
+/**
+ * 订阅 loading 状态变更 / Subscribe to loading state changes
+ * @param fn - 状态变更回调 / State change callback
+ * @returns 取消订阅函数 / Unsubscribe function
+ *
+ * @example
+ * const unsubscribe = onLoadingChange((url, loading) => {
+ *   if (url === '/order/query') {
+ *     setSpinnerVisible(loading);
+ *   }
+ * });
+ * // 组件卸载时取消订阅 / Unsubscribe on component unmount
+ * unsubscribe();
+ */
+export function onLoadingChange(fn) {
+    listeners.add(fn);
+    return () => {
+        listeners.delete(fn);
+    };
+}

package/dist/core/filter/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/core/filter/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../../src/core/filter/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/core/filter/__tests__/index.test.js

@@ -0,0 +1,230 @@
+import { describe, it, expect, vi, beforeEach, afterEach, beforeAll } from 'vitest';
+import { AmountFilter, DateFilter, EmptyFilter, BytesFilter, TimeAgoFilter } from '../../filter/builtins';
+import { FilterFactory } from '../../filter/factory';
+import { filterFactory } from '../../filter/index';
+import { registerAitheLocale } from '../../../styles/i18n';
+import { en as enLocale } from '../../../styles/i18n/locales/en-US';
+beforeAll(() => {
+    registerAitheLocale('en-US', enLocale);
+});
+// --- AmountFilter ---
+describe('AmountFilter', () => {
+    const filter = new AmountFilter();
+    it('formats number to 2 decimal places', () => {
+        expect(filter.apply(123.4)).toBe('123.40');
+        expect(filter.apply(0)).toBe('0.00');
+        expect(filter.apply(100)).toBe('100.00');
+    });
+    it('parses numeric string', () => {
+        expect(filter.apply('123.456')).toBe('123.46');
+        expect(filter.apply('0')).toBe('0.00');
+    });
+    it('returns -- for null/undefined', () => {
+        expect(filter.apply(null)).toBe('--');
+        expect(filter.apply(undefined)).toBe('--');
+    });
+    it('returns -- for non-numeric string', () => {
+        expect(filter.apply('abc')).toBe('--');
+        expect(filter.apply('')).toBe('--');
+    });
+});
+// --- DateFilter ---
+describe('DateFilter', () => {
+    const filter = new DateFilter();
+    it('formats Date object with default format', () => {
+        const d = new Date(2024, 0, 15, 14, 30, 45);
+        expect(filter.apply(d)).toBe('2024-01-15 14:30:45');
+    });
+    it('formats with custom format', () => {
+        const d = new Date(2024, 0, 15);
+        expect(filter.apply(d, 'yyyy/MM/dd')).toBe('2024/01/15');
+        expect(filter.apply(d, 'MM-dd')).toBe('01-15');
+    });
+    it('parses timestamp (ms)', () => {
+        const ts = new Date(2024, 5, 1).getTime();
+        expect(filter.apply(ts, 'yyyy-MM-dd')).toBe('2024-06-01');
+    });
+    it('parses date string', () => {
+        expect(filter.apply('2024-01-15', 'yyyy/MM/dd')).toBe('2024/01/15');
+    });
+    it('returns -- for null/undefined/empty', () => {
+        expect(filter.apply(null)).toBe('--');
+        expect(filter.apply(undefined)).toBe('--');
+        expect(filter.apply('')).toBe('--');
+    });
+    it('returns -- for invalid date string', () => {
+        expect(filter.apply('not-a-date')).toBe('--');
+    });
+});
+// --- EmptyFilter ---
+describe('EmptyFilter', () => {
+    const filter = new EmptyFilter();
+    it('returns value as string for non-empty', () => {
+        expect(filter.apply('hello')).toBe('hello');
+        expect(filter.apply(0)).toBe('0');
+        expect(filter.apply(false)).toBe('false');
+    });
+    it('returns placeholder for null/undefined', () => {
+        expect(filter.apply(null)).toBe('--');
+        expect(filter.apply(undefined)).toBe('--');
+    });
+    it('returns placeholder for empty string', () => {
+        expect(filter.apply('')).toBe('--');
+    });
+    it('returns placeholder for NaN', () => {
+        expect(filter.apply(NaN)).toBe('--');
+    });
+    it('supports custom placeholder', () => {
+        expect(filter.apply(null, '-')).toBe('-');
+        expect(filter.apply('', 'N/A')).toBe('N/A');
+    });
+});
+// --- BytesFilter ---
+describe('BytesFilter', () => {
+    const filter = new BytesFilter();
+    it('formats bytes in IEC (1024) by default', () => {
+        expect(filter.apply(0)).toBe('0 B');
+        expect(filter.apply(500)).toBe('500 B');
+        expect(filter.apply(1024)).toBe('1.00 KiB');
+        expect(filter.apply(1536)).toBe('1.50 KiB');
+        expect(filter.apply(1048576)).toBe('1.00 MiB');
+        expect(filter.apply(1073741824)).toBe('1.00 GiB');
+    });
+    it('formats bytes in SI (1000)', () => {
+        expect(filter.apply(1000, '1000')).toBe('1.00 KB');
+        expect(filter.apply(1000000, '1000')).toBe('1.00 MB');
+        expect(filter.apply(1000000000, '1000')).toBe('1.00 GB');
+    });
+    it('returns -- for null/undefined', () => {
+        expect(filter.apply(null)).toBe('--');
+        expect(filter.apply(undefined)).toBe('--');
+    });
+    it('returns -- for negative values', () => {
+        expect(filter.apply(-1)).toBe('--');
+    });
+    it('returns -- for non-numeric string', () => {
+        expect(filter.apply('abc')).toBe('--');
+    });
+});
+// --- TimeAgoFilter ---
+describe('TimeAgoFilter', () => {
+    const filter = new TimeAgoFilter();
+    const now = Date.now();
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(now);
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('returns just now for < 60s', () => {
+        expect(filter.apply(now)).toBe('just now');
+        expect(filter.apply(now - 30_000)).toBe('just now');
+    });
+    it('returns minutes ago', () => {
+        expect(filter.apply(now - 120_000)).toBe('2 minutes ago');
+        expect(filter.apply(now - 3_600_000 + 1)).toBe('59 minutes ago');
+    });
+    it('returns hours ago', () => {
+        expect(filter.apply(now - 7_200_000)).toBe('2 hours ago');
+        expect(filter.apply(now - 86_400_000 + 1)).toBe('23 hours ago');
+    });
+    it('returns days ago', () => {
+        expect(filter.apply(now - 172_800_000)).toBe('2 days ago');
+        expect(filter.apply(now - 2_592_000_000 + 1)).toBe('29 days ago');
+    });
+    it('returns months ago', () => {
+        expect(filter.apply(now - 5_184_000_000)).toBe('2 months ago');
+        expect(filter.apply(now - 25_920_000_000)).toBe('10 months ago');
+    });
+    it('returns date for > 1 year', () => {
+        const past = new Date(now - 31_104_000_000 - 86_400_000);
+        const y = past.getFullYear();
+        const m = String(past.getMonth() + 1).padStart(2, '0');
+        const d = String(past.getDate()).padStart(2, '0');
+        expect(filter.apply(past.getTime())).toBe(`${y}-${m}-${d}`);
+    });
+    it('handles future times', () => {
+        expect(filter.apply(now + 120_000)).toBe('in 2 minutes');
+        expect(filter.apply(now + 7_200_000)).toBe('in 2 hours');
+        expect(filter.apply(now + 172_800_000)).toBe('in 2 days');
+        expect(filter.apply(now + 5_184_000_000)).toBe('in 2 months');
+    });
+    it('returns -- for null/undefined/empty', () => {
+        expect(filter.apply(null)).toBe('--');
+        expect(filter.apply(undefined)).toBe('--');
+        expect(filter.apply('')).toBe('--');
+    });
+    it('returns -- for invalid date string', () => {
+        expect(filter.apply('not-a-date')).toBe('--');
+    });
+});
+// --- FilterFactory ---
+describe('FilterFactory', () => {
+    it('registers built-in filters', () => {
+        const factory = new FilterFactory();
+        expect(factory.has('amount')).toBe(true);
+        expect(factory.has('date')).toBe(true);
+        expect(factory.has('empty')).toBe(true);
+        expect(factory.has('bytes')).toBe(true);
+        expect(factory.has('timeAgo')).toBe(true);
+    });
+    it('registers custom filter', () => {
+        const factory = new FilterFactory();
+        class UpperFilter {
+            apply(value) {
+                return value.toUpperCase();
+            }
+        }
+        factory.register('upper', UpperFilter);
+        expect(factory.has('upper')).toBe(true);
+        expect(factory.get('upper')?.apply('hello')).toBe('HELLO');
+    });
+    it('formats value with expression string', () => {
+        const factory = new FilterFactory();
+        expect(factory.format(123.4, 'amount')).toBe('123.40');
+        expect(factory.format(null, 'empty')).toBe('--');
+    });
+    it('formats value with chained expression', () => {
+        const factory = new FilterFactory();
+        expect(factory.format(null, 'empty | empty -')).toBe('--');
+    });
+    it('returns original value for unknown filter', () => {
+        const factory = new FilterFactory();
+        const warn = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        expect(factory.format('test', 'unknown')).toBe('test');
+        expect(warn).toHaveBeenCalled();
+        warn.mockRestore();
+    });
+    it('parses expression string', () => {
+        const factory = new FilterFactory();
+        expect(factory.parse('amount')).toEqual([{ name: 'amount', args: [] }]);
+        expect(factory.parse('date yyyy/MM/dd')).toEqual([{ name: 'date', args: ['yyyy/MM/dd'] }]);
+        expect(factory.parse('amount | empty')).toEqual([
+            { name: 'amount', args: [] },
+            { name: 'empty', args: [] },
+        ]);
+    });
+    it('stringifies expressions', () => {
+        const factory = new FilterFactory();
+        expect(factory.stringify([{ name: 'amount', args: [] }])).toBe('amount');
+        expect(factory.stringify([{ name: 'date', args: ['yyyy/MM/dd'] }])).toBe('date yyyy/MM/dd');
+        expect(factory.stringify([
+            { name: 'amount', args: [] },
+            { name: 'empty', args: [] },
+        ])).toBe('amount | empty');
+    });
+    it('names() returns registered filter names', () => {
+        const factory = new FilterFactory();
+        const names = factory.names();
+        expect(names).toContain('amount');
+        expect(names).toContain('date');
+    });
+});
+// --- filterFactory instance ---
+describe('filterFactory instance', () => {
+    it('is a FilterFactory instance with built-in filters', () => {
+        expect(filterFactory).toBeInstanceOf(FilterFactory);
+        expect(filterFactory.has('amount')).toBe(true);
+    });
+});

package/dist/core/filter/builtins.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @file 内置过滤器实现 / Built-in Filter Implementations
+ * @description 无状态过滤器，参数通过 apply 的变参传入
+ */
+import type { Filter } from './types';
+/**
+ * 金额保留两位小数过滤器
+ * 支持数字或数字字符串，非数字返回 --
+ * 例: 123.4 → 123.40
+ */
+export declare class AmountFilter implements Filter<string | number, string> {
+    apply(value: string | number): string;
+}
+/** 日期过滤器支持的输入类型 */
+type DateFilterValue = string | number | Date;
+/**
+ * 日期格式化过滤器
+ * 支持 Date 对象、时间戳(毫秒)、日期字符串
+ * 默认格式: yyyy-MM-dd HH:mm:ss
+ * 支持自定义格式参数: yyyy 年份, MM 月份, dd 日, HH 时, mm 分, ss 秒
+ * 例: apply(new Date('2024-01-15'), 'yyyy/MM/dd') → 2024/01/15
+ */
+export declare class DateFilter implements Filter<DateFilterValue, string> {
+    apply(value: DateFilterValue, format?: string): string;
+}
+/**
+ * 空值替换过滤器
+ * 将 null / undefined / 空字符串 替换为指定字符串（默认 --）
+ * 支持自定义替换文本
+ */
+export declare class EmptyFilter implements Filter<unknown, string> {
+    apply(value: unknown, placeholder?: string): string;
+}
+/**
+ * 字节数格式化过滤器
+ * 将字节数转换为可读的大小字符串
+ * 参数: base (可选) - '1024' (IEC标准，默认) 或 '1000' (SI标准)
+ * 例: apply(1024) → 1.00 KiB
+ *     apply(1000, '1000') → 1.00 KB
+ *     apply(1536, '1024') → 1.50 KiB
+ *     apply(1048576) → 1.00 MiB
+ *     apply(1073741824) → 1.00 GiB
+ */
+export declare class BytesFilter implements Filter<number | string, string> {
+    private readonly iecUnits;
+    private readonly siUnits;
+    apply(value: number | string, base?: string): string;
+}
+/**
+ * 时间友好显示过滤器
+ * 根据输入的时间戳/日期字符串，计算与当前时间的差值，按规则格式化输出
+ * 例: apply('2026-06-18 12:00:00') → just now / 5 minutes ago / 3 hours ago / 2 days ago / 1 month ago / 2025-03-15
+ */
+export declare class TimeAgoFilter implements Filter<string | number | Date, string> {
+    apply(value: string | number | Date): string;
+    private parseDate;
+    private format;
+}
+export {};
+//# sourceMappingURL=builtins.d.ts.map

package/dist/core/filter/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../../src/core/filter/builtins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAItC;;;;GAIG;AACH,qBAAa,YAAa,YAAW,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;IAClE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;CAMtC;AAED,mBAAmB;AACnB,KAAK,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAE9C;;;;;;GAMG;AACH,qBAAa,UAAW,YAAW,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC;IAChE,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,SAAwB,GAAG,MAAM;CA+BtE;AAED;;;;GAIG;AACH,qBAAa,WAAY,YAAW,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;IACzD,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,SAAO,GAAG,MAAM;CAMlD;AAED;;;;;;;;;GASG;AACH,qBAAa,WAAY,YAAW,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IAEzD,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,SAAS,GAAG,MAAM;CAerD;AAED;;;;GAIG;AACH,qBAAa,aAAc,YAAW,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC;IAC1E,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM;IAW5C,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,MAAM;CAoCf"}

package/dist/core/filter/builtins.js

@@ -0,0 +1,172 @@
+/**
+ * @file 内置过滤器实现 / Built-in Filter Implementations
+ * @description 无状态过滤器，参数通过 apply 的变参传入
+ */
+import { t } from '../../styles/i18n';
+import { safeStringify } from '../../utils/utils';
+/**
+ * 金额保留两位小数过滤器
+ * 支持数字或数字字符串，非数字返回 --
+ * 例: 123.4 → 123.40
+ */
+export class AmountFilter {
+    apply(value) {
+        if (value == null)
+            return '--';
+        const num = typeof value === 'string' ? Number.parseFloat(value) : value;
+        if (Number.isNaN(num))
+            return '--';
+        return num.toFixed(2);
+    }
+}
+/**
+ * 日期格式化过滤器
+ * 支持 Date 对象、时间戳(毫秒)、日期字符串
+ * 默认格式: yyyy-MM-dd HH:mm:ss
+ * 支持自定义格式参数: yyyy 年份, MM 月份, dd 日, HH 时, mm 分, ss 秒
+ * 例: apply(new Date('2024-01-15'), 'yyyy/MM/dd') → 2024/01/15
+ */
+export class DateFilter {
+    apply(value, format = 'yyyy-MM-dd HH:mm:ss') {
+        if (value == null || value === '')
+            return '--';
+        let date;
+        if (value instanceof Date) {
+            date = value;
+        }
+        else if (typeof value === 'number') {
+            date = new Date(value);
+        }
+        else {
+            const parsed = Date.parse(value);
+            if (Number.isNaN(parsed))
+                return '--';
+            date = new Date(parsed);
+        }
+        if (Number.isNaN(date.getTime()))
+            return '--';
+        const map = {
+            'yyyy': String(date.getFullYear()),
+            'MM': String(date.getMonth() + 1).padStart(2, '0'),
+            'dd': String(date.getDate()).padStart(2, '0'),
+            'HH': String(date.getHours()).padStart(2, '0'),
+            'mm': String(date.getMinutes()).padStart(2, '0'),
+            'ss': String(date.getSeconds()).padStart(2, '0'),
+        };
+        let result = format;
+        for (const [key, val] of Object.entries(map)) {
+            result = result.replace(key, val);
+        }
+        return result;
+    }
+}
+/**
+ * 空值替换过滤器
+ * 将 null / undefined / 空字符串 替换为指定字符串（默认 --）
+ * 支持自定义替换文本
+ */
+export class EmptyFilter {
+    apply(value, placeholder = '--') {
+        if (value == null || value === '' || (typeof value === 'number' && Number.isNaN(value))) {
+            return placeholder;
+        }
+        return safeStringify(value);
+    }
+}
+/**
+ * 字节数格式化过滤器
+ * 将字节数转换为可读的大小字符串
+ * 参数: base (可选) - '1024' (IEC标准，默认) 或 '1000' (SI标准)
+ * 例: apply(1024) → 1.00 KiB
+ *     apply(1000, '1000') → 1.00 KB
+ *     apply(1536, '1024') → 1.50 KiB
+ *     apply(1048576) → 1.00 MiB
+ *     apply(1073741824) → 1.00 GiB
+ */
+export class BytesFilter {
+    constructor() {
+        this.iecUnits = ['B', 'KiB', 'MiB', 'GiB', 'TiB'];
+        this.siUnits = ['B', 'KB', 'MB', 'GB', 'TB'];
+    }
+    apply(value, base = '1024') {
+        if (value == null)
+            return '--';
+        const bytes = typeof value === 'string' ? Number.parseFloat(value) : value;
+        if (Number.isNaN(bytes) || bytes < 0)
+            return '--';
+        const isIec = base === '1024';
+        const divisor = isIec ? 1024 : 1000;
+        const units = isIec ? this.iecUnits : this.siUnits;
+        if (bytes < divisor)
+            return `${bytes} B`;
+        const exp = Math.min(Math.floor(Math.log(bytes) / Math.log(divisor)), units.length - 1);
+        const converted = bytes / Math.pow(divisor, exp);
+        return `${converted.toFixed(2)} ${units[exp]}`;
+    }
+}
+/**
+ * 时间友好显示过滤器
+ * 根据输入的时间戳/日期字符串，计算与当前时间的差值，按规则格式化输出
+ * 例: apply('2026-06-18 12:00:00') → just now / 5 minutes ago / 3 hours ago / 2 days ago / 1 month ago / 2025-03-15
+ */
+export class TimeAgoFilter {
+    apply(value) {
+        const date = this.parseDate(value);
+        if (!date)
+            return '--';
+        const diffMs = date.getTime() - Date.now();
+        const absSec = Math.floor(Math.abs(diffMs) / 1000);
+        const future = diffMs > 0;
+        return this.format(absSec, future, date);
+    }
+    parseDate(value) {
+        if (value == null || value === '')
+            return null;
+        let date;
+        if (value instanceof Date) {
+            date = value;
+        }
+        else if (typeof value === 'number') {
+            date = new Date(value);
+        }
+        else {
+            const parsed = Date.parse(value);
+            if (Number.isNaN(parsed))
+                return null;
+            date = new Date(parsed);
+        }
+        return Number.isNaN(date.getTime()) ? null : date;
+    }
+    format(absSec, future, date) {
+        if (absSec < 60)
+            return t('filter.timeAgo.justNow', 'just now');
+        if (absSec < 3600) {
+            const n = Math.floor(absSec / 60);
+            return future
+                ? t('filter.timeAgo.minutesLater', 'in {n} minutes', { n })
+                : t('filter.timeAgo.minutesAgo', '{n} minutes ago', { n });
+        }
+        if (absSec < 86400) {
+            const n = Math.floor(absSec / 3600);
+            return future
+                ? t('filter.timeAgo.hoursLater', 'in {n} hours', { n })
+                : t('filter.timeAgo.hoursAgo', '{n} hours ago', { n });
+        }
+        if (absSec < 2592000) {
+            const n = Math.floor(absSec / 86400);
+            return future
+                ? t('filter.timeAgo.daysLater', 'in {n} days', { n })
+                : t('filter.timeAgo.daysAgo', '{n} days ago', { n });
+        }
+        if (absSec < 31104000) {
+            const n = Math.floor(absSec / 2592000);
+            return future
+                ? t('filter.timeAgo.monthsLater', 'in {n} months', { n })
+                : t('filter.timeAgo.monthsAgo', '{n} months ago', { n });
+        }
+        const y = date.getFullYear();
+        const m = String(date.getMonth() + 1).padStart(2, '0');
+        const d = String(date.getDate()).padStart(2, '0');
+        return `${y}-${m}-${d}`;
+    }
+}