workdesktop-ai 1.2.1 → 1.2.3

package/dist/types/src/entries/tips-button.d.ts

@@ -0,0 +1,9 @@
+/**
+ * WdTipsButton 单独入口
+ * 用法：import WdTipsButton from 'workdesktop-ai/tips-button'
+ *       import 'workdesktop-ai/tips-button/style.css'
+ */
+import '../styles/index.css';
+import WdTipsButton from '../components/buttons/TipsButton.vue';
+export { WdTipsButton };
+export default WdTipsButton;

package/dist/types/src/entries/tips.d.ts

@@ -0,0 +1,9 @@
+/**
+ * WdTips 单独入口
+ * 用法：import WdTips from 'workdesktop-ai/tips'
+ *       import 'workdesktop-ai/tips/style.css'
+ */
+import '../styles/index.css';
+import WdTips from '../components/styles/Tips.vue';
+export { WdTips };
+export default WdTips;

package/dist/types/src/entries/upload.d.ts

@@ -0,0 +1,9 @@
+/**
+ * WdUpload 单独入口
+ * 用法：import WdUpload from 'workdesktop-ai/upload'
+ *       import 'workdesktop-ai/upload/style.css'
+ */
+import '../styles/index.css';
+import WdUpload from '../components/upload/Upload.vue';
+export { WdUpload };
+export default WdUpload;

package/dist/types/src/entries/viewer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * WdViewer 单独入口
+ * 用法：import WdViewer from 'workdesktop-ai/viewer'
+ *       import 'workdesktop-ai/viewer/style.css'
+ */
+import '../styles/index.css';
+import WdViewer from '../components/data/viewer/Viewer.vue';
+export { WdViewer };
+export default WdViewer;

package/dist/types/src/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * WorkDesktop 组件库主入口
+ *
+ * ESM：import WorkDesktop from 'workdesktop-ai'
+ * UMD：window.WorkDesktop（script 标签，配合 window.workDesktopConfig）
+ */
+import './styles/index.css';
+export { default as WorkDesktop, default } from './lib/install';
+export * from './components';
+export { initConfig, setGlobalConfig, getGlobalConfig, resetConfig, mergeConfig, getComponentDefault } from './lib/core/config';
+export { SKIN_PRESETS, getSkinPreset, listSkins } from './lib/core/skins';
+export type { SkinPreset } from './lib/core/skins';
+export { RequestAPI, request, default as http } from './lib/core/http';
+export type { ApiResult, ApiEventPayload, ApiEventType, ApiEventHandler } from './lib/core/http';
+export { registerDataGrid, refreshDataGrid, searchDataGrid, resetSearchDataGrid, getDataGrids, clearLinkageRegistry } from './lib/core/linkage';
+export { registerStation, setStationFooter, refreshStationView, getStationMenuChain, subscribeStationChange, notifyStationChange } from './lib/core/station-linkage';
+export type { StationInstance, MenuChainItem } from './lib/core/station-linkage';
+export { useRequest } from './lib/composables/useRequest';
+export { useDataGrid } from './lib/composables/useDataGrid';
+export { useConfig, useGlobalConfig } from './lib/composables/useConfig';
+export { useEventBus } from './lib/composables/useEventBus';
+export { useGlobalState } from './lib/composables/useGlobalState';
+export { deepMerge } from './lib/core/utils';
+export type * from './types';

package/dist/types/src/lib/composables/useConfig.d.ts

@@ -0,0 +1,19 @@
+import type { WorkDesktopConfig } from '../../types/config';
+/**
+ * useConfig（PRD 5.3 / 5.2）
+ *
+ * 组件内合并三级配置：全局 componentDefault[组件名] → 本地 props。
+ * 全局配置在组件 onMounted 时读取一次并缓存（运行中改配置只影响新挂载组件）。
+ *
+ * 返回一个响应式 ref，merge 后的组件配置对象：
+ *   componentDefault 的值作为默认，props 中非 undefined 的值覆盖。
+ *
+ * @example
+ * const cfg = useConfig('WdDataGrid', props)
+ * cfg.value.withPager
+ */
+export declare function useConfig<T extends Record<string, any> = Record<string, any>>(componentName?: string, props?: T): import("vue").Ref<any, any> extends T ? T extends T & import("vue").Ref<any, any> ? import("@vue/shared").IfAny<T, import("vue").ShallowRef<T, T>, T> : import("vue").ShallowRef<T, T> : import("vue").ShallowRef<T, T>;
+/**
+ * 非响应式：直接取当前全局 WorkDesktopConfig
+ */
+export declare function useGlobalConfig(): WorkDesktopConfig;

package/dist/types/src/lib/composables/useDataGrid.d.ts

@@ -0,0 +1,69 @@
+/**
+ * useDataGrid（PRD 5.3）
+ * DataGrid 状态管理：分页 / 搜索 / 选中 / 请求
+ *
+ * @example
+ * const grid = useDataGrid({ pageSize: 20 })
+ * grid.fetchData()
+ */
+export interface SortState {
+    prop: string;
+    order: 'ascending' | 'descending';
+}
+export interface UseDataGridOptions {
+    /** 数据接口地址 */
+    api?: string;
+    /** 请求方法，默认 post */
+    apiMethod?: 'get' | 'post' | 'put' | 'delete';
+    /** 固定请求参数 */
+    apiParam?: Record<string, any>;
+    /** 初始每页条数 */
+    pageSize?: number;
+    /** 是否自动请求 */
+    immediate?: boolean;
+    /** 请求级覆盖 */
+    reqOptions?: import('../../types/config').ReqOptions;
+    /** 请求成功回调（解封后的列表结果） */
+    onLoaded?: (result: {
+        list: any[];
+        total: number;
+    }) => void;
+}
+export interface ListData {
+    list: any[];
+    total: number;
+    pageSize: number;
+    currentPage: number;
+}
+export declare function useDataGrid(options?: UseDataGridOptions): {
+    currentPage: import("vue").Ref<number, number>;
+    page: import("vue").Ref<number, number>;
+    pageSize: import("vue").Ref<number, number>;
+    total: import("vue").Ref<number, number>;
+    list: import("vue").ShallowRef<any[], any[]>;
+    loading: import("vue").Ref<boolean, boolean>;
+    searchParams: Record<string, any>;
+    selection: import("vue").Ref<any[], any[]>;
+    sortState: import("vue").Ref<{
+        prop: string;
+        order: "ascending" | "descending";
+    } | null, SortState | {
+        prop: string;
+        order: "ascending" | "descending";
+    } | null>;
+    fetchData: (extra?: Record<string, any>) => Promise<ListData>;
+    refresh: () => Promise<ListData>;
+    reset: () => Promise<ListData>;
+    search: (params?: Record<string, any>) => Promise<ListData>;
+    changeSort: ({ prop, order }: {
+        prop: string;
+        order: "ascending" | "descending" | null;
+    }) => Promise<ListData>;
+    onChangeCurrentpage: (value: number) => Promise<ListData>;
+    onChangePagesize: (value: number) => Promise<ListData>;
+    setSelection: (rows: any[]) => void;
+    getSelection: () => any[];
+    clearSelection: () => void;
+    buildParams: (extra?: Record<string, any>) => Record<string, any>;
+};
+export type DataGridController = ReturnType<typeof useDataGrid>;

package/dist/types/src/lib/composables/useEventBus.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 轻量事件总线（PRD 5.3 / 6.3）
+ * 跨组件事件联动。组件卸载自动 off。
+ */
+type Handler = (payload?: any) => void;
+declare function emit(event: string, payload?: any): void;
+declare function off(event: string, handler: Handler): void;
+declare function clear(event?: string): void;
+export declare function useEventBus(): {
+    emit: typeof emit;
+    on: (event: string, handler: Handler) => () => void;
+    off: typeof off;
+    clear: typeof clear;
+};
+export type EventBus = ReturnType<typeof useEventBus>;
+export {};

package/dist/types/src/lib/composables/useGlobalState.d.ts

@@ -0,0 +1,5 @@
+export declare function useGlobalState<T extends object = Record<string, any>>(key: string, initial?: T): {
+    state: T;
+    set: (partial: Partial<T> | ((prev: T) => Partial<T>)) => void;
+    reset: () => void;
+};

package/dist/types/src/lib/composables/useRequest.d.ts

@@ -0,0 +1,42 @@
+import { type ApiResult } from '../core/http';
+import type { ReqOptions } from '../../types/config';
+/**
+ * useRequest（PRD 5.3）
+ * 封装请求逻辑，返回 data/loading/error + 请求方法。
+ *
+ * @example
+ * const { data, loading, run } = useRequest<User[]>('/api/users', {
+ *   method: 'post',
+ *   immediate: false,
+ *   reqConfig: { showTips: false }
+ * })
+ * run({ page: 1 })
+ */
+export interface UseRequestOptions {
+    /** 请求方法，默认 post */
+    method?: 'get' | 'post' | 'put' | 'delete';
+    /** 是否立即自动请求，默认 true */
+    immediate?: boolean;
+    /** 自动请求时的初始参数 */
+    initialParams?: any;
+    /** 请求级覆盖项（透传给 http） */
+    reqOptions?: ReqOptions;
+    /** 成功回调（data 为解封后的业务数据） */
+    onSuccess?: (data: any, result: ApiResult) => void;
+    /** 业务失败回调 */
+    onFail?: (result: ApiResult) => void;
+    /** 异常回调 */
+    onError?: (error: any) => void;
+}
+export declare function useRequest<T = any>(api: string | (() => string), options?: UseRequestOptions): {
+    data: import("vue").Ref<any, any> extends T | null ? import("vue").ShallowRef<null, null> | (T extends T & import("vue").Ref<any, any> ? import("@vue/shared").IfAny<T, import("vue").ShallowRef<T, T>, T> : import("vue").ShallowRef<T, T>) : import("vue").ShallowRef<T | null, T | null>;
+    loading: import("vue").Ref<boolean, boolean>;
+    error: import("vue").ShallowRef<Error | null, Error | null>;
+    run: (params?: any) => Promise<ApiResult<T> | null>;
+    refresh: () => Promise<ApiResult<T> | null>;
+    abort: () => void;
+};
+/** 工具：解包可能为 ref 的值 */
+export declare function unrefValue<T>(v: T | {
+    value: T;
+}): T;

package/dist/types/src/lib/configs/default-config.d.ts

@@ -0,0 +1,6 @@
+import type { WorkDesktopConfig } from '../../types/config';
+/**
+ * 默认配置层（库内置，不可改）
+ * PRD 5.2 / 第 7 章
+ */
+export declare const defaultConfig: WorkDesktopConfig;

package/dist/types/src/lib/core/config.d.ts

@@ -0,0 +1,28 @@
+import type { DeepPartial, WorkDesktopConfig } from '../../types/config';
+/**
+ * 增量合并到全局层。库 install 时与运行时 setGlobalConfig 共用。
+ * 返回 merge 后的有效配置。
+ */
+export declare function setGlobalConfig(partial?: DeepPartial<WorkDesktopConfig>): WorkDesktopConfig;
+/**
+ * 读取当前全局层（含默认层 merge 结果）
+ */
+export declare function getGlobalConfig(): WorkDesktopConfig;
+/**
+ * 恢复默认层
+ */
+export declare function resetConfig(): WorkDesktopConfig;
+/**
+ * 合并本地层（组件 props / 组件级配置），产出最终配置。
+ * 优先级：localProps > globalConfig > defaultConfig
+ */
+export declare function mergeConfig(local?: DeepPartial<WorkDesktopConfig> | Record<string, any>): WorkDesktopConfig;
+/**
+ * 取某组件类型的全局默认配置（page.componentDefault[PascalName]）
+ */
+export declare function getComponentDefault(componentName: string): Record<string, any>;
+/**
+ * 库初始化：合并双入口配置（npm app.use 参数 + window.workDesktopConfig）
+ * 两条入口汇入同一套 merge 逻辑，行为一致（PRD 8.2）
+ */
+export declare function initConfig(useConfig?: DeepPartial<WorkDesktopConfig>): WorkDesktopConfig;

package/dist/types/src/lib/core/http.d.ts

@@ -0,0 +1,100 @@
+import { type AxiosRequestConfig } from 'axios';
+import type { ReqOptions } from '../../types/config';
+/**
+ * HTTP 请求模块（PRD 5.1 / 第 7 章）
+ *
+ * RequestAPI 是本库的请求核心（PRD 5.1）：所有请求类组件（DataGrid/DataForm/
+ * 按钮组/输入选择/上传等）都基于它开发；同时对外公开，允许开发者在组件外
+ * 手动调用 API 请求代码。库内置全局单例 `request`，也可 `new RequestAPI()` 自建实例。
+ *
+ * 响应处理流程：
+ * 1. 请求前显示 loading（可配置）
+ * 2. 响应到达，按 resConfig 解封：取 code/message/data
+ * 3. code 匹配成功码 → apiSuccess + 成功提示
+ * 4. code 不匹配 → apiFail + 失败提示（业务失败 resolve，不 reject）
+ * 5. 网络异常 → apiException + 异常提示（reject）
+ * 6. 请求完成 → apiAfter + 关闭 loading
+ */
+export type ApiEventType = 'apiBefore' | 'apiSuccess' | 'apiFail' | 'apiException' | 'apiAfter';
+export interface ApiEventPayload {
+    type: ApiEventType;
+    url?: string;
+    method?: string;
+    params?: any;
+    /** 解封后的业务数据 */
+    data?: any;
+    code?: number | string;
+    message?: string;
+    error?: any;
+    /** 原始响应 */
+    raw?: any;
+}
+export type ApiEventHandler = (payload: ApiEventPayload) => void;
+/** 业务失败时 resolve 的结果（PRD 7.4：不抛异常，组件据此感知） */
+export interface ApiResult<T = any> {
+    success: boolean;
+    data: T | null;
+    code?: number | string;
+    message?: string;
+    raw?: any;
+}
+type Listener = ApiEventHandler;
+/**
+ * RequestAPI 请求客户端（公开类）
+ *
+ * 所有组件基于它开发；开发者也可手动 new 实例并调用 get/post/put/delete/request。
+ * 默认单例见文件底部 `export const request`。
+ */
+export declare class RequestAPI {
+    private axiosInstance;
+    private listeners;
+    /** 组件/实例级配置覆盖（request.create 使用） */
+    private instanceConfig;
+    private loadingInstance;
+    private loadingCount;
+    /** 进行中的请求（in-flight dedup）：key = method:url:序列化params，并发相同请求合并为一次网络调用 */
+    private inFlightRequests;
+    constructor(axiosConfig?: AxiosRequestConfig);
+    /**
+     * 创建绑定组件级配置的实例（PRD 5.1）
+     * 子实例复用父级监听器与去重表：同族实例（全局单例 + 各组件 create 出来的子实例）
+     * 之间并发相同请求同样合并，保证表列内多行组件发起的相同请求只打一次网络。
+     */
+    create(componentReqConfig?: DeepPartialConfig): RequestAPI;
+    on(handler: Listener): () => void;
+    off(handler: Listener): void;
+    private emit;
+    /**
+     * 取有效配置：全局配置 + 实例级覆盖
+     */
+    private resolveConfig;
+    private openLoading;
+    private closeLoading;
+    /**
+     * 核心请求方法
+     * 返回 Promise<ApiResult<T>>：业务失败也 resolve（success=false），仅网络异常 reject
+     */
+    request<T = any>(config: AxiosRequestConfig, reqOptions?: ReqOptions): Promise<ApiResult<T>>;
+    /** 去重 key：method + 解析后 url + 序列化请求体；请求体不可序列化时退化为固定后缀（该场景不合并） */
+    private buildDedupKey;
+    /** 真实请求执行体（含事件/loading/封解封），被 request() 去重包装后调用 */
+    private executeRequest;
+    /**
+     * 解封响应体：按 resConfig 取 code/message/data
+     */
+    private unpack;
+    private checkSuccess;
+    private buildUrl;
+    get<T = any>(url: string, params?: any, reqOptions?: ReqOptions): Promise<ApiResult<T>>;
+    post<T = any>(url: string, data?: any, reqOptions?: ReqOptions): Promise<ApiResult<T>>;
+    put<T = any>(url: string, data?: any, reqOptions?: ReqOptions): Promise<ApiResult<T>>;
+    delete<T = any>(url: string, params?: any, reqOptions?: ReqOptions): Promise<ApiResult<T>>;
+}
+type DeepPartialConfig = Record<string, any>;
+/**
+ * 全局单例（脱离组件直接调用，PRD 5.1）
+ *
+ * 所有组件共享该实例；开发者也可直接手动调用，或 `new RequestAPI()` 自建独立实例。
+ */
+export declare const request: RequestAPI;
+export default request;

package/dist/types/src/lib/core/linkage.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 声明式联动注册中心（PRD 6.2）
+ *
+ * filter 分组机制：所有参与联动的组件有通用 prop `filter`（默认 ''）。
+ * 联动只在 filter 相同的组件之间发生。
+ *
+ * DataGrid 挂载时按 filter 注册到注册中心；
+ * DataForm / ApiButton / Dialog / Drawer 等动作完成后，
+ * 调用 refreshDataGrid(headRefreshDatagrid, selfFilter) 刷新目标。
+ */
+export interface DataGridInstance {
+    /** 组件 filter 分组标识 */
+    filter: string;
+    /** 刷新当前页数据 */
+    refresh: () => any;
+    /** 带搜索参数查询（重置到第一页，合并搜索条件） */
+    search?: (params?: Record<string, any>) => any;
+    /** 清空搜索条件并刷新 */
+    resetSearch?: () => any;
+}
+/**
+ * 注册 DataGrid 实例，返回注销函数（组件 onUnmounted 调用）
+ */
+export declare function registerDataGrid(instance: DataGridInstance): () => void;
+/**
+ * 刷新目标 DataGrid
+ * @param headRefreshDatagrid true=刷同 filter 组；字符串=定向刷该 filter 组
+ * @param selfFilter 发起组件自身 filter
+ * @returns 被刷新的实例数量
+ */
+export declare function refreshDataGrid(headRefreshDatagrid: boolean | string | undefined, selfFilter?: string): number;
+/**
+ * 获取某 filter 组的 DataGrid 实例（事件联动 / 自定义逻辑用）
+ */
+export declare function getDataGrids(filter?: string): DataGridInstance[];
+/**
+ * SearchPanel 联动：带搜索参数刷新目标 DataGrid（重置到第一页）
+ * @param params 搜索表单值
+ */
+export declare function searchDataGrid(params: Record<string, any> | undefined, headRefreshDatagrid: boolean | string | undefined, selfFilter?: string): number;
+/**
+ * SearchPanel 重置联动：清空目标 DataGrid 搜索条件并刷新
+ */
+export declare function resetSearchDataGrid(headRefreshDatagrid: boolean | string | undefined, selfFilter?: string): number;
+/**
+ * 仅供测试 / 调试：清空注册中心
+ */
+export declare function clearLinkageRegistry(): void;

package/dist/types/src/lib/core/skins/apple.d.ts

@@ -0,0 +1,3 @@
+import type { SkinPreset } from './types';
+/** 苹果：iOS/macOS 浅色风（主色 #006ee6 为 iOS 蓝 #007aff 加深版，白字对比度 ≈4.8 达 WCAG AA） */
+export declare const appleSkin: SkinPreset;

package/dist/types/src/lib/core/skins/business.d.ts

@@ -0,0 +1,3 @@
+import type { SkinPreset } from './types';
+/** 商务：藏青边栏框架 + 白卡浅灰内容区 + 商务金点缀，克制的企业级管理后台（参考商务组件总览台） */
+export declare const businessSkin: SkinPreset;

package/dist/types/src/lib/core/skins/chinese.d.ts

@@ -0,0 +1,3 @@
+import type { SkinPreset } from './types';
+/** 中式：墨绿山水 + 金箔描边，暗夜国风（深色皮肤，含 El 深色联动；金底按钮配深绿字对比度 ≈8:1 达 WCAG AAA） */
+export declare const chineseSkin: SkinPreset;

package/dist/types/src/lib/core/skins/cool.d.ts

@@ -0,0 +1,3 @@
+import type { SkinPreset } from './types';
+/** 酷炫：石墨深底 + 电光紫，深色但不霓虹（深色皮肤，含 El 深色联动；主色加深至 #6847f0，按钮字对比度 ≈5.1:1 达 WCAG AA） */
+export declare const coolSkin: SkinPreset;

package/dist/types/src/lib/core/skins/cyberpunk.d.ts

@@ -0,0 +1,3 @@
+import type { SkinPreset } from './types';
+/** 赛博朋克：暗夜紫霓，品红主色 + 青光辅色 + 2px 硬边纯直角（深色皮肤，含 El 深色联动） */
+export declare const cyberpunkSkin: SkinPreset;

package/dist/types/src/lib/core/skins/default.d.ts

@@ -0,0 +1,3 @@
+import type { SkinPreset } from './types';
+/** 默认：品牌蓝（不注入任何覆盖，回落 tokens.css / theme.css 出厂值） */
+export declare const defaultSkin: SkinPreset;

package/dist/types/src/lib/core/skins/fashion.d.ts

@@ -0,0 +1,3 @@
+import type { SkinPreset } from './types';
+/** 时尚：珊瑚橙主色 + 奶油暖底柔光斑，白卡片大圆角 + 深墨导航胶囊，温暖杂志风 SaaS */
+export declare const fashionSkin: SkinPreset;

package/dist/types/src/lib/core/skins/flat.d.ts

@@ -0,0 +1,3 @@
+import type { SkinPreset } from './types';
+/** 扁平：经典扁平配色，零圆角零层次（主色加深至 #2470a8，白字按钮对比度 ≈5.3:1 达 WCAG AA） */
+export declare const flatSkin: SkinPreset;

package/dist/types/src/lib/core/skins/governance.d.ts

@@ -0,0 +1,3 @@
+import type { SkinPreset } from './types';
+/** 党政风：中国红 + 暖米白 + 金色点缀，2px 描边庄重温暖 */
+export declare const governanceSkin: SkinPreset;

package/dist/types/src/lib/core/skins/index.d.ts

@@ -0,0 +1,15 @@
+import type { SkinName } from '../../../types/config';
+import type { SkinPreset } from './types';
+/**
+ * 预设皮肤库（接入全局配置能力）
+ * 每套皮肤一个文件（本目录下 <key>.ts），新增皮肤在此聚合注册
+ * 使用：app.use(WorkDesktop, { theme: { skin: 'tech' } })
+ *      或 setGlobalConfig({ theme: { skin: 'cyberpunk' } })
+ * 覆盖优先级：theme.cssVars > theme.colors > 皮肤预设
+ */
+export type { SkinPreset } from './types';
+export declare const SKIN_PRESETS: Record<SkinName, SkinPreset>;
+/** 查询皮肤预设；未传 key 或未知 key 返回 undefined（由调用方回退默认行为） */
+export declare function getSkinPreset(key?: string): SkinPreset | undefined;
+/** 列出全部预设皮肤（供设置面板 / 文档展示遍历） */
+export declare function listSkins(): SkinPreset[];

package/dist/types/src/lib/core/skins/tech.d.ts

@@ -0,0 +1,3 @@
+import type { SkinPreset } from './types';
+/** 科技：深空霓虹青 + 非连续边框（L 角码 + 断续虚线段），参考科技大屏（深色皮肤，含 El 深色联动；青色主按钮配压深文字对比度 ≈9:1 达 WCAG AAA） */
+export declare const techSkin: SkinPreset;

package/dist/types/src/lib/core/skins/types.d.ts

@@ -0,0 +1,19 @@
+import type { SkinName, ThemeConfig } from '../../../types/config';
+/** 预设皮肤结构：每套皮肤一个文件（skins/ 目录），由 skins/index.ts 聚合注册 */
+export interface SkinPreset {
+    /** 皮肤唯一标识（theme.skin 取值） */
+    key: SkinName;
+    /** 中文名 */
+    label: string;
+    /** 风格描述 */
+    desc: string;
+    /** 皮肤携带的主题配置（colors/cssVars，结构与 ThemeConfig 一致） */
+    theme: ThemeConfig;
+    /**
+     * 皮肤专属 CSS 规则（可选）：applyTheme 时原样追加在 :root 变量块之后。
+     * 用于 EP 变量做不到的 rule 级定制（如渐变背景、外发光）；仅当 theme.skin
+     * 命中该预设时注入，切换皮肤随 styleEl 重建自动移除。规则内引用 var(--el-x/--wd-x)
+     * 可保持与用户 colors/cssVars 覆盖联动。
+     */
+    cssRules?: string;
+}

package/dist/types/src/lib/core/station-linkage.d.ts

@@ -0,0 +1,72 @@
+/**
+ * WdStation 联动注册中心
+ *
+ * 复用 DataGrid linkage 的 filter 分组心智：
+ * - Station 挂载时按 filter 注册；
+ * - 业务代码调用 setStationFooter(target, info, selfFilter) 更新底部动态信息；
+ * - refreshStationView(target, selfFilter) 触发内容区强制刷新（重新挂载）。
+ *
+ * target：true = 与发起方同 filter 组；字符串 = 定向该 filter 组。
+ */
+export interface StationInstance {
+    /** 组件 filter 分组标识 */
+    filter: string;
+    /** 设置底部动态信息 */
+    setFooterInfo: (info: string) => void;
+    /** 刷新内容区（强制重挂载） */
+    refresh: () => void;
+    /** 当前激活菜单的路径链（分组标题 → 菜单 → 子菜单），供 WdPath 自动模式读取 */
+    getActiveMenuChain?: () => MenuChainItem[];
+}
+/** 菜单链节点（面包屑自动模式的菜单段） */
+export interface MenuChainItem {
+    /** 标题 */
+    title: string;
+    /** 路由路径 */
+    path?: string;
+    /** 图标（ElementPlus 图标名字符串或组件） */
+    icon?: string | object;
+}
+/**
+ * 注册 Station 实例，返回注销函数（组件 onUnmounted 调用）
+ */
+export declare function registerStation(instance: StationInstance): () => void;
+/**
+ * 设置目标 Station 底部动态信息
+ * @param target true=同 filter 组；字符串=定向该 filter 组
+ * @param info 展示内容（文本）
+ * @param selfFilter 发起方自身 filter
+ * @returns 被更新的实例数量
+ */
+export declare function setStationFooter(target: boolean | string, info: string, selfFilter?: string): number;
+/**
+ * 刷新目标 Station 内容区（强制重新挂载）
+ * @param target true=同 filter 组（默认）；字符串=定向该 filter 组
+ * @param selfFilter 发起方自身 filter
+ * @returns 被刷新的实例数量
+ */
+export declare function refreshStationView(target?: boolean | string, selfFilter?: string): number;
+/**
+ * 读取目标 Station 当前激活菜单的路径链（供 WdPath 自动模式使用）
+ * @param target true=同 filter 组；字符串=定向该 filter 组
+ * @param selfFilter 发起方自身 filter
+ * @returns 菜单链节点数组（无匹配实例时为空数组）
+ */
+export declare function getStationMenuChain(target: boolean | string | undefined, selfFilter?: string): MenuChainItem[];
+/**
+ * 订阅某 filter 组的 Station 变化（菜单/分组切换），返回取消订阅函数
+ */
+export declare function subscribeStationChange(filter: string, cb: () => void): () => void;
+/**
+ * 通知某 filter 组的订阅者：Station 的激活菜单/分组发生了变化
+ * （Station 内部在菜单选中、分组切换、路由反查、挂载时调用）
+ */
+export declare function notifyStationChange(filter: string): void;
+/**
+ * 仅供测试 / 调试：清空路径组件订阅者
+ */
+export declare function clearPathListeners(): void;
+/**
+ * 仅供测试 / 调试：清空注册中心
+ */
+export declare function clearStationRegistry(): void;

package/dist/types/src/lib/core/theme.d.ts

@@ -0,0 +1,11 @@
+import type { ThemeConfig } from '../../types/config';
+/**
+ * 解析最终生效的主题：皮肤预设打底，用户 colors/cssVars 继续覆盖
+ * 优先级：cssVars > colors > 皮肤预设；未知皮肤告警并回退默认
+ */
+export declare function resolveTheme(theme?: ThemeConfig): ThemeConfig | undefined;
+/**
+ * 将 theme 配置写入 :root CSS 变量（PRD 9.2 方式二）
+ * 输出顺序：colors 语义键 → 语义色 El 派生色阶 → cssVars 精细覆盖（后者覆盖前者）
+ */
+export declare function applyTheme(input?: ThemeConfig): void;

package/dist/types/src/lib/core/utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 通用工具函数
+ */
+/**
+ * 判断是否为普通对象（用于 deep merge）
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, any>;
+/**
+ * deep merge：对象深合并；数组覆盖；基本类型后者覆盖前者
+ * 与 lodash.merge 语义一致：从左到右，后者优先级高
+ */
+export declare function deepMerge<T = any>(...sources: any[]): T;
+/**
+ * 按路径取对象值，如 getValue(obj, 'a.b.c')
+ */
+export declare function getValueByPath(obj: any, path: string): any;
+export declare function uniqueId(prefix?: string): string;
+/**
+ * 安全 JSON parse（localStorage 用）
+ */
+export declare function safeJsonParse<T>(text: string | null, fallback: T): T;
+/**
+ * 防抖
+ */
+export declare function debounce<F extends (...args: any[]) => any>(fn: F, wait?: number): {
+    (this: unknown, ...args: Parameters<F>): void;
+    cancel(): void;
+};

package/dist/types/src/lib/install.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Vue 插件入口（PRD 8.2 双入口）
+ *
+ * npm：app.use(WorkDesktop, config)
+ * script：window.workDesktopConfig 配置 + window.WorkDesktop 自动安装
+ */
+import type { Plugin } from 'vue';
+declare const install: Plugin['install'];
+declare const WorkDesktop: Plugin;
+export default WorkDesktop;
+export { install };