@aithe/aithe-ui 26.2.3 → 26.3.2

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}`;
+    }
+}

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

@@ -0,0 +1,54 @@
+/**
+ * @file 过滤器注册工厂 / Filter Factory
+ * @description 提供过滤器注册、获取、直接格式化值等功能
+ *              所有 Filter 为无状态单例，参数通过 apply 传入
+ */
+import type { Filter, FilterConfig, FilterExpression } from './types';
+/**
+ * 过滤器注册工厂
+ */
+export declare class FilterFactory {
+    private readonly registry;
+    constructor();
+    private registerDefaults;
+    /**
+     * 注册过滤器
+     * 内部会实例化一次并缓存，后续复用同一实例
+     */
+    register<T extends Filter>(name: string, ctor: new () => T): void;
+    /**
+     * 获取过滤器实例（无状态可复用）
+     */
+    get<T extends Filter = Filter>(name: string): T | null;
+    /**
+     * 检查过滤器是否已注册
+     */
+    has(name: string): boolean;
+    /**
+     * 获取所有已注册的过滤器名称
+     */
+    names(): string[];
+    /**
+     * 解析过滤器表达式字符串
+     * 支持格式：
+     *   - "phone"                    → { name: 'phone', args: [] }
+     *   - "date yyyy/MM/dd"          → { name: 'date', args: ['yyyy/MM/dd'] }
+     *   - "phone | empty"            → [{ name: 'phone', args: [] }, { name: 'empty', args: [] }]
+     *   - "date yyyy/MM/dd | empty"  → [{ name: 'date', args: ['yyyy/MM/dd'] }, { name: 'empty', args: [] }]
+     */
+    parse(config: FilterConfig): FilterExpression[];
+    /**
+     * 将过滤器表达式列表序列化为字符串
+     */
+    stringify(expressions: FilterExpression[]): string;
+    /**
+     * 使用过滤器表达式直接格式化值
+     * 支持链式过滤：value → filter1 → filter2 → result
+     *
+     * @param value - 待格式化值
+     * @param config - 过滤器配置（字符串表达式或配置对象）
+     * @returns 格式化后的值，过滤器不存在时返回原始值
+     */
+    format<T = unknown>(value: T, config: FilterConfig): unknown;
+}
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/core/filter/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGtE;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;;IAMtD,OAAO,CAAC,gBAAgB;IAQxB;;;OAGG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,GAAG,IAAI;IAIjE;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAItD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,KAAK,IAAI,MAAM,EAAE;IAIjB;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,EAAE;IAe/C;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,MAAM;IAMlD;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO;CAiB7D"}

package/dist/core/filter/factory.js

@@ -0,0 +1,96 @@
+/**
+ * @file 过滤器注册工厂 / Filter Factory
+ * @description 提供过滤器注册、获取、直接格式化值等功能
+ *              所有 Filter 为无状态单例，参数通过 apply 传入
+ */
+import { AmountFilter, DateFilter, EmptyFilter, BytesFilter, TimeAgoFilter } from './builtins';
+/**
+ * 过滤器注册工厂
+ */
+export class FilterFactory {
+    constructor() {
+        this.registry = new Map();
+        this.registerDefaults();
+    }
+    registerDefaults() {
+        this.register('amount', AmountFilter);
+        this.register('date', DateFilter);
+        this.register('empty', EmptyFilter);
+        this.register('bytes', BytesFilter);
+        this.register('timeAgo', TimeAgoFilter);
+    }
+    /**
+     * 注册过滤器
+     * 内部会实例化一次并缓存，后续复用同一实例
+     */
+    register(name, ctor) {
+        this.registry.set(name, new ctor());
+    }
+    /**
+     * 获取过滤器实例（无状态可复用）
+     */
+    get(name) {
+        return this.registry.get(name) ?? null;
+    }
+    /**
+     * 检查过滤器是否已注册
+     */
+    has(name) {
+        return this.registry.has(name);
+    }
+    /**
+     * 获取所有已注册的过滤器名称
+     */
+    names() {
+        return Array.from(this.registry.keys());
+    }
+    /**
+     * 解析过滤器表达式字符串
+     * 支持格式：
+     *   - "phone"                    → { name: 'phone', args: [] }
+     *   - "date yyyy/MM/dd"          → { name: 'date', args: ['yyyy/MM/dd'] }
+     *   - "phone | empty"            → [{ name: 'phone', args: [] }, { name: 'empty', args: [] }]
+     *   - "date yyyy/MM/dd | empty"  → [{ name: 'date', args: ['yyyy/MM/dd'] }, { name: 'empty', args: [] }]
+     */
+    parse(config) {
+        if (typeof config !== 'string') {
+            return [config];
+        }
+        const parts = config.split('|').map(s => s.trim()).filter(Boolean);
+        return parts.map(part => {
+            const segments = part.split(/\s+/).filter(Boolean);
+            const name = segments[0] ?? '';
+            const args = segments.slice(1);
+            return { name, args };
+        });
+    }
+    /**
+     * 将过滤器表达式列表序列化为字符串
+     */
+    stringify(expressions) {
+        return expressions.map(exp => {
+            return exp.args.length > 0 ? `${exp.name} ${exp.args.join(' ')}` : exp.name;
+        }).join(' | ');
+    }
+    /**
+     * 使用过滤器表达式直接格式化值
+     * 支持链式过滤：value → filter1 → filter2 → result
+     *
+     * @param value - 待格式化值
+     * @param config - 过滤器配置（字符串表达式或配置对象）
+     * @returns 格式化后的值，过滤器不存在时返回原始值
+     */
+    format(value, config) {
+        const expressions = this.parse(config);
+        let result = value;
+        for (const exp of expressions) {
+            const filter = this.get(exp.name);
+            if (!filter) {
+                console.warn(`[FilterFactory] 未注册的过滤器: "${exp.name}"，可用过滤器: ${this.names().join(', ')}`);
+                return value;
+            }
+            result = filter.apply(result, ...exp.args);
+        }
+        return result;
+    }
+}

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

@@ -0,0 +1,11 @@
+/**
+ * @file Filter 模块入口 / Filter Module Entry
+ * @description 统一导出 Filter 模块所有类型和工具
+ */
+export type { Filter, FilterExpression, FilterConfig, } from './types';
+export { AmountFilter, DateFilter, EmptyFilter, BytesFilter, TimeAgoFilter, } from './builtins';
+export { FilterFactory } from './factory';
+import { FilterFactory } from './factory';
+/** 全局默认过滤器工厂实例 */
+export declare const filterFactory: FilterFactory;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/filter/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,MAAM,EACN,gBAAgB,EAChB,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,kBAAkB;AAClB,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/core/filter/index.js

@@ -0,0 +1,9 @@
+/**
+ * @file Filter 模块入口 / Filter Module Entry
+ * @description 统一导出 Filter 模块所有类型和工具
+ */
+export { AmountFilter, DateFilter, EmptyFilter, BytesFilter, TimeAgoFilter, } from './builtins';
+export { FilterFactory } from './factory';
+import { FilterFactory } from './factory';
+/** 全局默认过滤器工厂实例 */
+export const filterFactory = new FilterFactory();

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

@@ -0,0 +1,12 @@
+/** 过滤器接口，所有过滤器必须实现此接口 */
+export interface Filter<T = unknown, R = unknown> {
+    apply(value: T, ...args: string[]): R;
+}
+/** 过滤器表达式解析结果 */
+export interface FilterExpression {
+    name: string;
+    args: string[];
+}
+/** 过滤器链配置，支持单个过滤器名或表达式字符串 */
+export type FilterConfig = string | FilterExpression;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/filter/types.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IAC9C,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;CACvC;AAED,iBAAiB;AACjB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,6BAA6B;AAC7B,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,gBAAgB,CAAC"}

package/dist/core/filter/types.js

@@ -0,0 +1 @@
+export {};

package/dist/core/floating.js

@@ -0,0 +1,132 @@
+import { clamp } from '../utils/utils';
+/** Fallback placement order when the preferred position overflows the viewport. 当首选位置溢出视口时的备选放置顺序。 */
+const fallbackMap = {
+    top: ['bottom', 'right', 'left'],
+    'top-start': ['bottom-start', 'right-start', 'left-start'],
+    'top-end': ['bottom-end', 'right-start', 'left-start'],
+    right: ['left', 'bottom', 'top'],
+    'right-start': ['left-start', 'bottom-start', 'top-start'],
+    bottom: ['top', 'right', 'left'],
+    'bottom-start': ['top-start', 'right-start', 'left-start'],
+    'bottom-end': ['top-end', 'right-start', 'left-start'],
+    left: ['right', 'bottom', 'top'],
+    'left-start': ['right-start', 'bottom-start', 'top-start'],
+};
+/**
+ * Compute pixel coordinates for a given placement relative to an anchor rect.
+ * 计算给定放置位置相对于锚点矩形的像素坐标。
+ *
+ * @param anchorRect  - Bounding rect of the anchor element. 锚点元素的边界矩形。
+ * @param overlayRect - Bounding rect of the overlay element. 叠加层元素的边界矩形。
+ * @param placement   - Desired placement position. 期望的放置位置。
+ * @param offset      - Gap between anchor and overlay. 锚点与叠加层之间的间距。
+ * @returns Pixel coordinates `{ left, top }`. 像素坐标 `{ left, top }`。
+ */
+function coordsForPlacement(anchorRect, overlayRect, placement, offset) {
+    switch (placement) {
+        case 'top':
+            return {
+                left: anchorRect.left + anchorRect.width / 2 - overlayRect.width / 2,
+                top: anchorRect.top - overlayRect.height - offset,
+            };
+        case 'top-start':
+            return {
+                left: anchorRect.left,
+                top: anchorRect.top - overlayRect.height - offset,
+            };
+        case 'top-end':
+            return {
+                left: anchorRect.right - overlayRect.width,
+                top: anchorRect.top - overlayRect.height - offset,
+            };
+        case 'right':
+            return {
+                left: anchorRect.right + offset,
+                top: anchorRect.top + anchorRect.height / 2 - overlayRect.height / 2,
+            };
+        case 'right-start':
+            return {
+                left: anchorRect.right + offset,
+                top: anchorRect.top,
+            };
+        case 'bottom':
+            return {
+                left: anchorRect.left + anchorRect.width / 2 - overlayRect.width / 2,
+                top: anchorRect.bottom + offset,
+            };
+        case 'bottom-start':
+            return {
+                left: anchorRect.left,
+                top: anchorRect.bottom + offset,
+            };
+        case 'bottom-end':
+            return {
+                left: anchorRect.right - overlayRect.width,
+                top: anchorRect.bottom + offset,
+            };
+        case 'left':
+            return {
+                left: anchorRect.left - overlayRect.width - offset,
+                top: anchorRect.top + anchorRect.height / 2 - overlayRect.height / 2,
+            };
+        case 'left-start':
+            return {
+                left: anchorRect.left - overlayRect.width - offset,
+                top: anchorRect.top,
+            };
+        default:
+            return { left: 0, top: 0 };
+    }
+}
+/**
+ * Check whether an overlay rect fits inside the viewport with the given padding.
+ * 检查叠加层矩形是否在给定内边距下适合视口。
+ *
+ * @param left        - Left offset. 左偏移量。
+ * @param top         - Top offset. 顶部偏移量。
+ * @param overlayRect - Bounding rect of the overlay. 叠加层的边界矩形。
+ * @param padding     - Minimum viewport padding. 最小视口内边距。
+ * @returns `true` if the overlay is fully inside the viewport. 若叠加层完全在视口内则返回 `true`。
+ */
+function fitsViewport(left, top, overlayRect, padding) {
+    const viewportWidth = window.innerWidth;
+    const viewportHeight = window.innerHeight;
+    return (left >= padding &&
+        top >= padding &&
+        left + overlayRect.width <= viewportWidth - padding &&
+        top + overlayRect.height <= viewportHeight - padding);
+}
+/**
+ * Compute the best position for a floating overlay anchored to an element.
+ * 计算锚定到元素的浮动叠加层的最佳位置。
+ *
+ * Tries the preferred placement first, then falls back to alternative
+ * positions that fit within the viewport. If none fit, clamps to the viewport.
+ * 首先尝试首选放置位置，然后回退到适合视口的备选位置。若无适合位置，则限制在视口内。
+ *
+ * @param anchorRect         - Bounding rect of the anchor. 锚点的边界矩形。
+ * @param overlayRect        - Bounding rect of the overlay. 叠加层的边界矩形。
+ * @param preferredPlacement - Desired placement. 期望的放置位置。
+ * @param options            - Offset and padding options. 偏移和内边距选项。
+ * @returns The computed position with resolved placement. 计算后的位置及解析后的放置位置。
+ */
+export function computeFloatingPosition(anchorRect, overlayRect, preferredPlacement, options = {}) {
+    const offset = options.offset ?? 8;
+    const padding = options.padding ?? 12;
+    const candidates = [preferredPlacement, ...fallbackMap[preferredPlacement]];
+    for (const placement of candidates) {
+        const coords = coordsForPlacement(anchorRect, overlayRect, placement, offset);
+        if (fitsViewport(coords.left, coords.top, overlayRect, padding)) {
+            return {
+                ...coords,
+                placement,
+            };
+        }
+    }
+    const fallback = coordsForPlacement(anchorRect, overlayRect, preferredPlacement, offset);
+    return {
+        left: clamp(fallback.left, padding, window.innerWidth - overlayRect.width - padding),
+        top: clamp(fallback.top, padding, window.innerHeight - overlayRect.height - padding),
+        placement: preferredPlacement,
+    };
+}

package/dist/core/highlight/index.js

@@ -0,0 +1,43 @@
+/**
+ * @file Syntax highlighting engine / 语法高亮引擎
+ * @description 自研语法高亮引擎，支持多语言注册和自定义规则。
+ *              Self-developed syntax highlighting engine with language registration.
+ */
+export { SyntaxRegistry } from './registry';
+import './lang-javascript';
+import './lang-typescript';
+import './lang-c';
+import './lang-cpp';
+import './lang-java';
+import './lang-html';
+import './lang-json';
+import './lang-jsonline';
+import './lang-yaml';
+import './lang-xml';
+import './lang-markdown';
+import './lang-python';
+import './lang-ruby';
+import './lang-bash';
+import './lang-css';
+import './lang-sql';
+import './lang-rust';
+import './lang-go';
+import './lang-kotlin';
+import './lang-swift';
+import './lang-jsx';
+import './lang-tsx';
+import './lang-vue';
+import './lang-svelte';
+import './lang-wasm';
+import './lang-dockerfile';
+import './lang-makefile';
+import './lang-cmake';
+import './lang-latex';
+import './lang-fsharp';
+import './lang-powershell';
+import './lang-perl';
+import './lang-lua';
+import './lang-scala';
+import './lang-dart';
+import './lang-r';
+import './lang-objectivec';

package/dist/core/highlight/lang-bash.js

@@ -0,0 +1,27 @@
+import { SyntaxRegistry } from './registry';
+const rules = [
+    { pattern: /(#.*$)/gm, className: 'hl-comment', order: 1 },
+    { pattern: /(: '[\s\S]*?'\n)/g, className: 'hl-comment', order: 1 },
+    {
+        pattern: /\b(case|do|done|elif|else|esac|exit|fi|for|function|if|in|select|then|until|while|time|return|local|declare|typeset|export|readonly|unset|set|shopt|trap|source|\.)\b/g,
+        className: 'hl-keyword',
+        order: 2,
+    },
+    { pattern: /\b(true|false)\b/g, className: 'hl-boolean', order: 3 },
+    {
+        pattern: /\b(echo|printf|read|cd|pwd|ls|mkdir|rmdir|rm|cp|mv|cat|grep|sed|awk|cut|sort|uniq|wc|find|xargs|chmod|chown|ps|kill|top|df|du|tar|gzip|gunzip|make|eval|exec|shift|let|test|expr)\b/g,
+        className: 'hl-builtin',
+        order: 4,
+    },
+    { pattern: /\b(\d+\.?\d*)\b/g, className: 'hl-number', order: 5 },
+    {
+        pattern: /("(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|`(?:[^`\\]|\\.)*`)/g,
+        className: 'hl-string',
+        order: 6,
+    },
+    { pattern: /\b([a-zA-Z_][\\w]*)\s*(?=\()/g, className: 'hl-function', order: 7 },
+    { pattern: /(\$\{?[a-zA-Z_][\\w]*\\}?)/g, className: 'hl-keyword', order: 8 },
+    { pattern: /([{}[\](),;|&<>])/g, className: 'hl-punctuation', order: 9 },
+];
+const definition = { langId: 'bash', name: 'Bash', rules };
+SyntaxRegistry.register(definition);

package/dist/core/highlight/lang-c.js

@@ -0,0 +1,27 @@
+import { SyntaxRegistry } from './registry';
+const rules = [
+    { pattern: /(\/\/.*$)/gm, className: 'hl-comment', order: 1 },
+    { pattern: /(\/\*[\s\S]*?\*\/)/g, className: 'hl-comment', order: 1 },
+    {
+        pattern: /\b(auto|break|case|char|const|continue|default|do|double|else|enum|extern|float|for|goto|if|int|long|register|return|short|signed|sizeof|static|struct|switch|typedef|union|unsigned|void|volatile|while)\b/g,
+        className: 'hl-keyword',
+        order: 2,
+    },
+    { pattern: /\b(NULL|true|false)\b/g, className: 'hl-boolean', order: 3 },
+    {
+        pattern: /\b(printf|scanf|malloc|free|sizeof|strlen|strcpy|strcmp|strcat| memcpy|memset|exit|fopen|fclose|fread|fwrite)\b/g,
+        className: 'hl-builtin',
+        order: 4,
+    },
+    { pattern: /\b(\d+\.?\d*[fFlL]?)\b/g, className: 'hl-number', order: 5 },
+    { pattern: /("(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*')/g, className: 'hl-string', order: 6 },
+    { pattern: /\b([a-zA-Z_][\\w]*)\s*(?=\()/g, className: 'hl-function', order: 7 },
+    {
+        pattern: /#\s*(include|define|ifdef|ifndef|endif|if|else|elif|pragma|undef|error|warning)\b.*/g,
+        className: 'hl-preprocessor',
+        order: 8,
+    },
+    { pattern: /([{}[\](),;])/g, className: 'hl-punctuation', order: 9 },
+];
+const definition = { langId: 'c', name: 'C', rules };
+SyntaxRegistry.register(definition);