@fses/workbench-app 0.1.0

package/dist/internal/personal-workbench/lib/echartsTemplateMaterializer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview ECharts 模板物化 - 将系统模板注册项转换为画布 ECharts protocol 数据。
+ * @author seadon
+ * @created 2026-06-22
+ */
+import type { EChartsSystemCardTemplateEntry } from '@fses/workbench-app/types';
+import type { MaterializedBlock, ProtocolRenderData } from '@fses/workbench-app/types';
+export type EChartsTemplateMaterializeResult = {
+    ok: true;
+    data: ProtocolRenderData & {
+        sourceLabel: string;
+        template: Record<string, unknown>;
+    };
+    renderer: MaterializedBlock['renderer'];
+    meta: Record<string, unknown>;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * 物化 ECharts 模板运行时数据。
+ * @param entry - ECharts 系统模板注册项。
+ * @returns 物化结果。
+ */
+export declare function materializeEChartsTemplate(entry: EChartsSystemCardTemplateEntry): Promise<EChartsTemplateMaterializeResult>;
+/**
+ * 判断注册项是否为 ECharts 模板。
+ * @param value - 候选注册项。
+ * @returns 是 ECharts 模板返回 true。
+ */
+export declare function isEChartsTemplateEntry(value: unknown): value is EChartsSystemCardTemplateEntry;

package/dist/internal/personal-workbench/lib/fdeWorkbenchAssetPackage.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview FDE workbench asset package adapter - converts snapshots to external asset packages.
+ * @author seadon
+ * @created 2026-05-20
+ */
+import type { BlockLayout, LayoutConfig, MaterializedBlock, WorkbenchSnapshot } from '@fses/workbench-app/types';
+export declare const FDE_WORKBENCH_ASSET_SCHEMA_VERSION = "workbench.asset.v1";
+export interface FdeWorkbenchWorkspaceDocument {
+    workspaceId: string;
+    userId: string;
+    roleId: WorkbenchSnapshot['roleId'];
+    resourceId?: string;
+    path?: string;
+    name?: string;
+    tag?: string;
+    description?: string;
+    source?: 'fde_preset' | 'user_saved' | string;
+    renameable?: boolean;
+    ownerUserId?: string;
+    createdAt?: string;
+    version: number;
+    layoutVersion: number;
+    layoutConfig: LayoutConfig;
+    cardOrder: string[];
+    visualConfig?: WorkbenchSnapshot['visualConfig'];
+    globalStyle: Record<string, unknown>;
+    updatedAt: string;
+}
+export interface FdeWorkbenchCardDocument {
+    cardId: string;
+    workspaceId: string;
+    userId: string;
+    title: string;
+    subtitle?: string;
+    layout: BlockLayout;
+    renderer: NonNullable<MaterializedBlock['renderer']>;
+    state: MaterializedBlock['state'];
+    style: Record<string, unknown>;
+    commonMeta: Record<string, unknown>;
+    bodyJson: Record<string, unknown>;
+    version: number;
+    updatedAt: string;
+    rendererType?: string;
+    protocolConfig?: Record<string, unknown>;
+    protocolData?: Record<string, unknown>;
+    dataBindingId?: string;
+}
+export interface FdeWorkbenchQueryPlanDocument {
+    bindingId: string;
+    workspaceId: string;
+    userId: string;
+    cardId: string;
+    question: string;
+    validatedSql: string;
+    sqlDialect: string;
+    externalSqlApi: string;
+    fieldMapping: Record<string, unknown>;
+    paramsSchema: Record<string, unknown>;
+    permissionContext: {
+        tenantId: string;
+        appId: string;
+        [key: string]: unknown;
+    };
+    createdBy: 'ai' | 'system' | 'user';
+    version: number;
+    updatedAt: string;
+}
+export interface FdeWorkbenchAssetPackage {
+    schemaVersion: typeof FDE_WORKBENCH_ASSET_SCHEMA_VERSION;
+    workspace: FdeWorkbenchWorkspaceDocument;
+    cards: FdeWorkbenchCardDocument[];
+    queryPlans: FdeWorkbenchQueryPlanDocument[];
+    layout: BlockLayout[];
+    visualConfig: WorkbenchSnapshot['visualConfig'] | Record<string, unknown>;
+}
+export interface FdeWorkbenchAssetPackageMetadata {
+    resourceId?: string;
+    path?: string;
+    name?: string;
+    tag?: string;
+    description?: string;
+    source?: FdeWorkbenchWorkspaceDocument['source'];
+    renameable?: boolean;
+    ownerUserId?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/**
+ * Converts a FDE asset package into a frontend workbench snapshot.
+ * @param assetPackage - External FDE asset package.
+ * @returns Workbench snapshot used by the canvas runtime.
+ */
+export declare function snapshotFromFdeAssetPackage(assetPackage: FdeWorkbenchAssetPackage): WorkbenchSnapshot;
+/**
+ * Converts a frontend snapshot into a persistable FDE asset package.
+ * @param snapshot - Current canvas snapshot.
+ * @param previousPackage - Previously loaded package, used to preserve metadata and query plans.
+ * @param metadata - External scope metadata supplied by the FDE host.
+ * @returns Asset package suitable for saving through the external API.
+ */
+export declare function snapshotToFdeAssetPackage(snapshot: WorkbenchSnapshot, previousPackage?: FdeWorkbenchAssetPackage | null, metadata?: FdeWorkbenchAssetPackageMetadata): FdeWorkbenchAssetPackage;
+/**
+ * Collects all active data binding ids referenced by snapshot blocks.
+ * @param snapshot - Snapshot to inspect.
+ * @returns Set of non-empty binding ids.
+ */
+export declare function collectSnapshotDataBindingIds(snapshot: WorkbenchSnapshot): Set<string>;

package/dist/internal/personal-workbench/lib/fdeWorkbenchConfigClient.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview FDE 个人工作台配置客户端 - 负责预置模板草稿包接口、上下文和 config_json 编解码
+ * @author seadon
+ * @created 2026-05-25
+ */
+import type { FdeWorkbenchAssetPackage } from './fdeWorkbenchAssetPackage';
+export declare const FDE_WORKBENCH_CONTEXT_TYPE = "bt-workbench:fde-context";
+export interface FdeWorkbenchContext {
+    resourceId: string;
+    appId: string;
+    tenantId: string;
+    userId: string;
+    egoUserinfo: string;
+    resourceName: string;
+}
+export interface FdeWorkbenchConfigRecord {
+    app_id?: string;
+    resource_id?: string;
+    current_version_no?: number | string;
+    published_version_no?: number | string;
+    config_json?: string;
+    config_hash?: string;
+    published_config_hash?: string;
+    dirty?: boolean;
+    publish_time?: string;
+    update_time?: string;
+}
+export interface FdeWorkbenchVersionRecord {
+    version_no?: number | string;
+    version_name?: string;
+    description?: string;
+    remark?: string;
+    current?: boolean;
+    is_current?: boolean;
+}
+export interface FdeWorkbenchRestoreResult extends FdeWorkbenchConfigRecord {
+    version_no?: number | string;
+}
+/**
+ * 将草稿包对象或 JSON 字符串编码为接口要求的 base64 字符串。
+ * @param config - 草稿包对象或 JSON 字符串
+ * @returns UTF-8 安全的 base64 字符串
+ */
+export declare function encodeConfigJson(config: unknown): string;
+/**
+ * 解码接口返回的 config_json。
+ * @param configJson - base64 配置字符串
+ * @returns 草稿包对象，空值返回 null
+ */
+export declare function decodeConfigJson(configJson?: string | null): FdeWorkbenchAssetPackage | null;
+/**
+ * 规范化宿主通过 postMessage 传入的 FDE 上下文。
+ * @param value - 原始 message 数据
+ * @returns 可用于接口调用的上下文，非 context 消息返回 null
+ */
+export declare function normalizeFdeContextMessage(value: unknown): FdeWorkbenchContext | null;
+/**
+ * 生成 FDE 配置接口统一 header。
+ * @param context - FDE 上下文
+ * @returns 只包含非空字段的 header map
+ */
+export declare function makeFdeConfigHeaders(context: FdeWorkbenchContext): Record<string, string>;
+/**
+ * 查询当前预置模板配置。
+ * @param context - FDE 上下文
+ * @returns 当前配置记录
+ */
+export declare function getFdeWorkbenchConfig(context: FdeWorkbenchContext): Promise<FdeWorkbenchConfigRecord | null>;
+/**
+ * 保存当前预置模板草稿。
+ * @param context - FDE 上下文
+ * @param assetPackage - 草稿包对象
+ * @returns 接口保存结果
+ */
+export declare function saveFdeWorkbenchConfig(context: FdeWorkbenchContext, assetPackage: FdeWorkbenchAssetPackage): Promise<unknown>;
+/**
+ * 保存当前草稿为新版本。
+ * @param context - FDE 上下文
+ * @param versionName - 新版本名称
+ * @param assetPackage - 草稿包对象
+ * @returns 接口保存结果
+ */
+export declare function saveFdeWorkbenchConfigVersion(context: FdeWorkbenchContext, versionName: string, assetPackage: FdeWorkbenchAssetPackage): Promise<unknown>;
+/**
+ * 查询预置模板版本列表。
+ * @param context - FDE 上下文
+ * @returns 版本列表
+ */
+export declare function listFdeWorkbenchConfigVersions(context: FdeWorkbenchContext): Promise<FdeWorkbenchVersionRecord[]>;
+/**
+ * 恢复指定预置模板版本。
+ * @param context - FDE 上下文
+ * @param versionNo - 版本号
+ * @returns 接口恢复结果
+ */
+export declare function restoreFdeWorkbenchConfigVersion(context: FdeWorkbenchContext, versionNo: number | string): Promise<FdeWorkbenchRestoreResult>;

package/dist/internal/personal-workbench/lib/formatters.d.ts

@@ -0,0 +1,5 @@
+export declare function formatNumber(value: number, options?: Intl.NumberFormatOptions, fallback?: string): string;
+export declare function formatDate(date: Date | string, options?: Intl.DateTimeFormatOptions, fallback?: string): string;
+export declare function formatDateTime(value?: string, options?: Intl.DateTimeFormatOptions): string;
+export declare function formatMetricValue(value: number, format?: string): string;
+export declare function formatAmount(value: number, options?: Intl.NumberFormatOptions): string;

package/dist/internal/personal-workbench/lib/historyCardBindingRestore.fixture.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview 历史推荐绑定恢复测试 fixture - 保存受影响 transcript 的脱敏真实结构
+ * @author seadon
+ * @created 2026-08-03
+ */
+/**
+ * 构造真实缺少任何允许位置绑定的旧历史 transcript。
+ * @returns 无绑定旧历史 transcript items。
+ */
+export declare function buildAffectedUnboundHistoryTranscriptItems(): Array<Record<string, unknown>>;
+/**
+ * 构造真实携带对象绑定位置的同类历史 transcript。
+ * @returns 带绑定历史 transcript items。
+ */
+export declare function buildBoundHistoryTranscriptItems(): Array<Record<string, unknown>>;

package/dist/internal/personal-workbench/lib/platformFetchClient.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @fileoverview 平台 getFetch 请求适配层 - 统一非流式后端接口的安全签名请求。
+ * @author seadon
+ * @created 2026-07-07
+ */
+import type { FetchConfig, FetchService, Method } from '@byteluck-fe/global-shared';
+export interface PlatformRequestConfig {
+    method?: Method | string;
+    url: string;
+    params?: Record<string, unknown>;
+    payload?: unknown;
+    headers?: Record<string, string>;
+    responseType?: FetchConfig['responseType'];
+    signal?: AbortSignal;
+}
+export interface PlatformUploadFileConfig {
+    url: string;
+    file: File | Blob;
+    name?: string;
+    filename?: string;
+    data?: Record<string, unknown>;
+    headers?: Record<string, string>;
+}
+export interface PlatformEnvelope<T> {
+    code?: string | number;
+    state?: string;
+    message?: string;
+    data?: T;
+}
+type PlatformHeaderSource = HeadersInit | Record<string, string | number | boolean | null | undefined>;
+/**
+ * 动态服务返回非 JSON 内容时的可识别错误。
+ */
+export declare class NonJsonDynamicResponseError extends Error {
+    /**
+     * 标记动态服务返回了非 JSON 响应。
+     */
+    constructor();
+}
+/**
+ * 注入测试用 getFetch client。
+ * @param client - 测试 client。
+ * @returns void
+ */
+export declare function __setPlatformFetchClientForTest(client: FetchService): void;
+/**
+ * 清理测试注入 client。
+ * @returns void
+ */
+export declare function __resetPlatformFetchClientForTest(): void;
+/**
+ * 应用入口显式初始化平台用户 session，写入 sessionStorage.userInfoData（含 ut）。
+ * 应在首个私有接口前调用，便于女娲沙箱等隔离环境下尽早暴露引导失败。
+ * @returns 是否已具备可用于 post-auth 的 ut。
+ */
+export declare function ensurePlatformUserSessionReady(): Promise<boolean>;
+/**
+ * 将 RequestInit headers 归一化为 getFetch 支持的普通对象。
+ * @param sources - 待合并的 headers。
+ * @returns 普通 header map。
+ */
+export declare function createPlatformHeaders(...sources: Array<PlatformHeaderSource | null | undefined>): Record<string, string>;
+/**
+ * 将 RequestInit signal 归一化为 getFetch 配置可接受的值。
+ * @param signal - fetch signal。
+ * @returns 非空 AbortSignal。
+ */
+export declare function normalizePlatformSignal(signal: AbortSignal | null | undefined): AbortSignal | undefined;
+/**
+ * 发起原始 payload 请求。
+ * @param config - 请求配置。
+ * @returns 原始响应 payload。
+ */
+export declare function requestRawPayload<T = unknown>(config: PlatformRequestConfig): Promise<T>;
+/**
+ * 请求 run-agent 风格接口并解包 data。
+ * @param config - 请求配置。
+ * @returns data 字段。
+ */
+export declare function requestRunAgentJson<T>(config: PlatformRequestConfig): Promise<T>;
+/**
+ * 请求平台接口并保留 envelope。
+ * @param config - 请求配置。
+ * @returns 平台 envelope。
+ */
+export declare function requestPlatformEnvelope<T>(config: PlatformRequestConfig): Promise<PlatformEnvelope<T>>;
+/**
+ * 使用 getFetch uploadFile 上传文件。
+ * @param config - 上传配置。
+ * @returns 上传响应 payload。
+ */
+export declare function uploadPlatformFile<T = unknown>(config: PlatformUploadFileConfig): Promise<T>;
+/**
+ * 判断 URL 是否可交给平台 getFetch 签名请求。
+ * @param url - 请求 URL。
+ * @returns 相对路径或同源 URL 返回 true。
+ */
+export declare function shouldUsePlatformFetch(url: string): boolean;
+/**
+ * 请求动态服务 JSON。外部绝对 URL 暂时保留原生 fetch，避免签名外部地址。
+ * @param config - 请求配置。
+ * @returns JSON payload。
+ */
+export declare function requestDynamicJsonPayload<T = unknown>(config: PlatformRequestConfig): Promise<T>;
+export {};

package/dist/internal/personal-workbench/lib/queryTraceDisplay.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview 问数追溯展示工具 - 将结构化追溯事件格式化为右侧聊天可读文本。
+ * @author seadon
+ * @created 2026-05-13
+ */
+import type { ConversationReturnItem, QueryTraceRelationDiagnostic } from '@fses/workbench-app/types';
+/**
+ * 将关系诊断严重级别转为用户可读标签。
+ * @param severity - 后端结构化严重级别。
+ * @returns 用户可读严重级别。
+ */
+export declare function formatRelationDiagnosticSeverity(severity?: string): string;
+/**
+ * 将关系/字段诊断动作格式化为可复制的治理请求文本。
+ * @param diagnostic - 后端返回的关系/字段诊断。
+ * @returns 没有治理动作时返回空字符串。
+ */
+export declare function formatRelationDiagnosticGovernanceRequest(diagnostic: QueryTraceRelationDiagnostic): string;
+/**
+ * 将问数追溯项格式化为右侧聊天状态行标题。
+ * @param item - 追溯返回项。
+ * @returns 状态行内容。
+ */
+export declare function formatQueryTraceContent(item: ConversationReturnItem): string;
+/**
+ * 将问数追溯项格式化为右侧聊天展开详情。
+ * @param item - 追溯返回项。
+ * @returns 展开详情文本。
+ */
+export declare function formatQueryTraceDetail(item: ConversationReturnItem): string;

package/dist/internal/personal-workbench/lib/runtimeCapabilities.d.ts

@@ -0,0 +1,8 @@
+import type { MaterializedBlock, RuntimeCapabilityMount } from '@fses/workbench-app/types';
+import { ROUTE_TARGETS, missingRuntimePrimitivesForCapability } from './runtimePrimitiveRegistry';
+type CapabilitySlot = RuntimeCapabilityMount['slot'];
+export { ROUTE_TARGETS, missingRuntimePrimitivesForCapability };
+export declare function sanitizeRuntimeCapabilityMount(value: unknown): RuntimeCapabilityMount | null;
+export declare function runtimeCapabilitiesForSlot(block: MaterializedBlock, slot: CapabilitySlot): RuntimeCapabilityMount[];
+export declare function searchableTextForBlock(block: MaterializedBlock, fields: string[]): string;
+export declare function searchBlocks(blocks: MaterializedBlock[], capability: RuntimeCapabilityMount, query: string): MaterializedBlock[];

package/dist/internal/personal-workbench/lib/runtimeIdentity.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview 工作台运行态身份头工具 - 为 run-agent HTTP 请求透传用户与租户上下文。
+ * @author seadon
+ * @created 2026-06-02
+ */
+export interface RuntimeIdentityContext {
+    userId?: string;
+    tenantId?: string;
+    appId?: string;
+}
+export interface RuntimeSemanticAppScope {
+    semanticAppId?: string;
+}
+/**
+ * 从当前 URL 读取问数语义应用范围，兼容 search 与 hash query。
+ * @returns URL 中显式确认的数据应用 ID，缺失时返回 undefined。
+ */
+export declare function readRuntimeSemanticAppIdFromUrl(): string | undefined;
+/**
+ * 解析运行态租户 ID，优先使用上下文，其次 URL，最后使用本地默认租户。
+ * @param context - 当前运行态身份上下文。
+ * @returns 规范化后的租户 ID。
+ */
+export declare function resolveRuntimeTenantId(context: RuntimeIdentityContext): string | undefined;
+/**
+ * 解析运行态应用 ID，优先使用上下文，其次 URL，最后使用 web-workbench。
+ * @param context - 当前运行态身份上下文。
+ * @returns 规范化后的应用 ID。
+ */
+export declare function resolveRuntimeAppId(context: RuntimeIdentityContext): string;
+/**
+ * 构建 run-agent 运行态身份请求头。
+ * @param context - 当前运行态用户上下文。
+ * @returns 包含 ego-userinfo、tenant-id、tenant_id 和 x-tenant-id 的请求头。
+ */
+export declare function runtimeIdentityHeaders(context: RuntimeIdentityContext): Record<string, string>;

package/dist/internal/personal-workbench/lib/runtimePrimitiveRegistry.d.ts

@@ -0,0 +1,51 @@
+import type { RuntimeCapabilityMount } from '@fses/workbench-app/types';
+export type RuntimePrimitiveKind = 'slot' | 'ui' | 'data' | 'action' | 'trigger' | 'routeTarget';
+export type RuntimePrimitiveStatus = 'active' | 'planned' | 'disabled';
+export type RuntimePrimitiveRisk = 'low' | 'medium' | 'high' | 'forbidden';
+export interface RuntimePrimitiveDefinition {
+    id: string;
+    kind: RuntimePrimitiveKind;
+    status: RuntimePrimitiveStatus;
+    displayName: string;
+    userFacingName: string;
+    description: string;
+    riskLevel: RuntimePrimitiveRisk;
+    sideEffects: string[];
+}
+export interface RuntimePrimitiveGapDetail {
+    id: string;
+    userFacingName: string;
+    description: string;
+    status: 'planned' | 'unknown' | 'disabled';
+}
+export declare const RUNTIME_PRIMITIVE_DEFINITIONS: RuntimePrimitiveDefinition[];
+export declare const ROUTE_TARGETS: {
+    readonly processCenter: {
+        readonly id: "processCenter";
+        readonly name: "流程中心";
+        readonly route: "/process-center";
+        readonly acceptedParams: readonly ["keyword", "source"];
+    };
+};
+export declare function primitiveDefinition(id: string, kind?: RuntimePrimitiveKind): RuntimePrimitiveDefinition;
+export declare function activePrimitiveIds(kind: RuntimePrimitiveKind): string[];
+export declare function isActivePrimitive(id: string, kind: RuntimePrimitiveKind): boolean;
+export declare function runtimeCapabilityPrimitiveIds(capability: RuntimeCapabilityMount): {
+    slot: import("@fses/workbench-card").RuntimeCapabilitySlot;
+    ui: import("@fses/workbench-card").RuntimeCapabilityUiKind;
+    icon: string;
+    data: import("@fses/workbench-card").RuntimeCapabilityDataSource;
+    actions: import("@fses/workbench-card").RuntimeCapabilityActionType[];
+    triggers: ("onSelectResult" | "onSubmit" | "onClick" | "onChange")[];
+    routeTargets: string[];
+};
+export declare function missingRuntimePrimitivesForCapability(capability: RuntimeCapabilityMount): string[];
+export declare function primitiveGapDetails(ids: string[]): RuntimePrimitiveGapDetail[];
+export declare function humanizePrimitiveId(id: string): string;
+export declare function userFacingPrimitiveGapMessage(ids: string[], requestedAction?: string): string[];
+export declare function primitiveGapTechnicalDetails(ids: string[], requestedAction?: string): {
+    missingPrimitives: string[];
+    gapType: string;
+    userNeed: string;
+    missingCapabilities: RuntimePrimitiveGapDetail[];
+};

package/dist/internal/personal-workbench/lib/summaryPreview.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview 对话记录摘要预览工具 - 控制长过程详情的默认展示长度。
+ * @author seadon
+ * @created 2026-05-14
+ */
+export declare const SUMMARY_PREVIEW_LINE_LIMIT = 3;
+export declare const SUMMARY_PREVIEW_CHAR_LIMIT = 360;
+export interface SummaryPreview {
+    text: string;
+    hasMore: boolean;
+}
+/**
+ * 生成对话记录摘要的预览文本，默认保留前三行，长单行按字符数兜底截断。
+ * @param text - 原始摘要或详情文本。
+ * @param expanded - 是否已经展开完整内容。
+ * @returns 可展示的预览文本和是否存在更多内容。
+ */
+export declare function createSummaryPreview(text: string, expanded: boolean): SummaryPreview;

package/dist/internal/personal-workbench/lib/systemCardPreviewProfile.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview 系统卡片预览画像 - 为系统卡片默认样例和 hover 预览提供 capability 级差异化描述。
+ * @author seadon
+ * @created 2026-06-18
+ */
+import type { CardRegistryEntry } from '@fses/workbench-app/types';
+export type SystemCardPreviewTone = 'neutral' | 'success' | 'warning' | 'danger' | 'info';
+export type SystemCardPreviewLayoutHint = 'metric' | 'table' | 'matrix' | 'timeline' | 'narrative' | 'network' | 'profile' | 'workflow' | 'map' | 'customCanvas' | 'embed';
+export interface SystemCardPreviewProfile {
+    capabilityId: string;
+    previewKind: string;
+    layoutHint: SystemCardPreviewLayoutHint;
+    sampleTone: SystemCardPreviewTone;
+    sampleTitle: string;
+    explicit: boolean;
+}
+export declare const EXPLICIT_SYSTEM_CARD_PREVIEW_PROFILE_IDS: string[];
+/**
+ * 根据系统卡片注册项解析默认预览画像。
+ * @param entry - 系统卡片注册项。
+ * @returns capability 级预览画像。
+ */
+export declare function resolveSystemCardPreviewProfile(entry: CardRegistryEntry): SystemCardPreviewProfile;

package/dist/internal/personal-workbench/lib/userVisibleTextGuard.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview 用户可见文本安全过滤 - 防止规划和问数追溯向业务用户暴露 code、ID、表字段名。
+ * @author seadon
+ * @created 2026-06-13
+ */
+/**
+ * 判断文本是否包含技术标识。
+ * @param value - 待检查文本。
+ * @returns 包含技术标识时返回 true。
+ */
+export declare function userVisibleTextHasTechnicalIdentifier(value: string): boolean;
+/**
+ * 清理用户可见文本。
+ * @param value - 待清理文本。
+ * @returns 安全文本；不安全时返回空字符串。
+ */
+export declare function sanitizeUserVisibleText(value: unknown): string;
+/**
+ * 清理并保序去重用户可见文本列表。
+ * @param values - 候选文本列表。
+ * @returns 安全文本列表。
+ */
+export declare function sanitizeUserVisibleTextList(values: unknown[]): string[];

package/dist/internal/personal-workbench/lib/utils.d.ts

@@ -0,0 +1,46 @@
+import { type ClassValue } from 'clsx';
+export { formatDate, formatNumber } from './formatters';
+/**
+ * 合并 Tailwind CSS 类名的工具函数
+ * @param inputs - 类名数组或对象
+ * @returns 合并后的类名字符串
+ */
+export declare function cn(...inputs: ClassValue[]): string;
+/**
+ * 生成随机 ID
+ * @param length - ID 长度
+ * @returns 随机 ID 字符串
+ */
+export declare function generateId(length?: number): string;
+/**
+ * 防抖函数
+ * @param func - 要防抖的函数
+ * @param wait - 等待时间（毫秒）
+ * @returns 防抖后的函数
+ */
+export declare function debounce<T extends (...args: any[]) => any>(func: T, wait: number): (...args: Parameters<T>) => void;
+/**
+ * 节流函数
+ * @param func - 要节流的函数
+ * @param limit - 时间限制（毫秒）
+ * @returns 节流后的函数
+ */
+export declare function throttle<T extends (...args: any[]) => any>(func: T, limit: number): (...args: Parameters<T>) => void;
+/**
+ * 检查是否为移动设备
+ * @returns 是否为移动设备
+ */
+export declare function isMobile(): boolean;
+/**
+ * 检查是否为暗色模式
+ * @returns 是否为暗色模式
+ */
+export declare function isDarkMode(): boolean;
+/**
+ * 切换暗色模式
+ */
+export declare function toggleDarkMode(): void;
+/**
+ * 初始化暗色模式
+ */
+export declare function initDarkMode(): void;