@tita-agent/dsh-data-table 0.0.0-stage → 0.2.0

package/lib/types/univer/fonts.d.ts

@@ -0,0 +1,202 @@
+export interface DataSheetFontConfig {
+    value: string;
+    label: string;
+    category: 'sans-serif' | 'serif';
+}
+/**
+ * Additional font families exposed by the Datasheet Univer residency.
+ *
+ * This is intentionally a candidate list, not a bundled-font list. The
+ * browser-side probe below removes entries that are not installed on the
+ * current machine, while keeping the dropdown useful across macOS, Windows,
+ * Linux and common Chinese-font setups.
+ */
+export declare const DATA_SHEET_CUSTOM_FONT_CONFIGS: readonly [{
+    readonly value: "PingFang SC";
+    readonly label: "苹方（简体中文）";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "PingFang TC";
+    readonly label: "苹方（繁体中文）";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "JingDongLangZhengTi";
+    readonly label: "京东朗正体";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Helvetica";
+    readonly label: "Helvetica";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Helvetica Neue";
+    readonly label: "Helvetica Neue";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Segoe UI";
+    readonly label: "Segoe UI";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Calibri";
+    readonly label: "Calibri";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Cambria";
+    readonly label: "Cambria";
+    readonly category: "serif";
+}, {
+    readonly value: "Georgia";
+    readonly label: "Georgia";
+    readonly category: "serif";
+}, {
+    readonly value: "Consolas";
+    readonly label: "Consolas";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Courier New";
+    readonly label: "Courier New";
+    readonly category: "serif";
+}, {
+    readonly value: "Trebuchet MS";
+    readonly label: "Trebuchet MS";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Gill Sans";
+    readonly label: "Gill Sans";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Avenir Next";
+    readonly label: "Avenir Next";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Menlo";
+    readonly label: "Menlo";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Roboto";
+    readonly label: "Roboto";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Noto Sans";
+    readonly label: "Noto Sans";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Noto Sans CJK SC";
+    readonly label: "Noto Sans CJK SC";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Noto Sans CJK TC";
+    readonly label: "Noto Sans CJK TC";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Noto Serif CJK SC";
+    readonly label: "Noto Serif CJK SC";
+    readonly category: "serif";
+}, {
+    readonly value: "Noto Serif CJK TC";
+    readonly label: "Noto Serif CJK TC";
+    readonly category: "serif";
+}, {
+    readonly value: "Source Han Sans SC";
+    readonly label: "思源黑体（简体中文）";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Source Han Sans TC";
+    readonly label: "思源黑体（繁体中文）";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Source Han Serif SC";
+    readonly label: "思源宋体（简体中文）";
+    readonly category: "serif";
+}, {
+    readonly value: "Source Han Serif TC";
+    readonly label: "思源宋体（繁体中文）";
+    readonly category: "serif";
+}, {
+    readonly value: "WenQuanYi Zen Hei";
+    readonly label: "文泉驿正黑";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Microsoft JhengHei";
+    readonly label: "微软正黑";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Microsoft JhengHei UI";
+    readonly label: "微软正黑 UI";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "DengXian";
+    readonly label: "等线";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "STHeiti";
+    readonly label: "华文黑体";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "STSong";
+    readonly label: "华文宋体";
+    readonly category: "serif";
+}, {
+    readonly value: "STKaiti";
+    readonly label: "华文楷体";
+    readonly category: "serif";
+}, {
+    readonly value: "STFangsong";
+    readonly label: "华文仿宋";
+    readonly category: "serif";
+}, {
+    readonly value: "Songti SC";
+    readonly label: "宋体 SC";
+    readonly category: "serif";
+}, {
+    readonly value: "Songti TC";
+    readonly label: "宋体 TC";
+    readonly category: "serif";
+}, {
+    readonly value: "Heiti SC";
+    readonly label: "黑体 SC";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Hiragino Sans GB";
+    readonly label: "冬青黑体简";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Hiragino Mincho ProN";
+    readonly label: "冬青明朝体";
+    readonly category: "serif";
+}, {
+    readonly value: "MingLiU";
+    readonly label: "细明体";
+    readonly category: "serif";
+}, {
+    readonly value: "PMingLiU";
+    readonly label: "新细明体";
+    readonly category: "serif";
+}, {
+    readonly value: "Alibaba PuHuiTi 3.0";
+    readonly label: "阿里巴巴普惠体 3.0";
+    readonly category: "sans-serif";
+}, {
+    readonly value: "Alibaba PuHuiTi 2.0";
+    readonly label: "阿里巴巴普惠体 2.0";
+    readonly category: "sans-serif";
+}];
+/**
+ * Univer's built-in list is repeated here so it can be filtered before
+ * Univer creates its FontService. Browsers cannot enumerate every system
+ * font, so this is a candidate list rather than a system-font API.
+ */
+export declare const DATA_SHEET_FONT_CANDIDATE_CONFIGS: readonly DataSheetFontConfig[];
+/**
+ * Filter candidates using the same canvas-metrics check Univer uses for its
+ * unsupported-font indicator. This runs before createUniver(), because
+ * Univer snapshots the configured list while constructing FontService.
+ */
+export declare function getInstalledFontConfigs(): DataSheetFontConfig[];
+/**
+ * Give every sheet the shared default font family.
+ *
+ * The sheet default is a migration target: this fixes workbooks created before
+ * Datasheet switched from Arial to PingFang SC. Cell-level styles stay untouched,
+ * so an explicit font choice is still respected.
+ */
+export declare function withDefaultSheetFont(workbookData: object): object;

package/lib/types/univer/fonts.js

@@ -0,0 +1,140 @@
+import { DEFAULT_SHEET_FONT_FAMILY } from "../contract/snapshots.js";
+/**
+ * Additional font families exposed by the Datasheet Univer residency.
+ *
+ * This is intentionally a candidate list, not a bundled-font list. The
+ * browser-side probe below removes entries that are not installed on the
+ * current machine, while keeping the dropdown useful across macOS, Windows,
+ * Linux and common Chinese-font setups.
+ */
+export const DATA_SHEET_CUSTOM_FONT_CONFIGS = [
+    {
+        // macOS family name for Simplified Chinese PingFang.
+        value: 'PingFang SC',
+        label: '苹方（简体中文）',
+        category: 'sans-serif',
+    },
+    {
+        // Keep the Traditional Chinese family available on macOS as well.
+        value: 'PingFang TC',
+        label: '苹方（繁体中文）',
+        category: 'sans-serif',
+    },
+    {
+        // The CSS family name used by the JD Lang Zhengti font files.
+        value: 'JingDongLangZhengTi',
+        label: '京东朗正体',
+        category: 'sans-serif',
+    },
+    { value: 'Helvetica', label: 'Helvetica', category: 'sans-serif' },
+    { value: 'Helvetica Neue', label: 'Helvetica Neue', category: 'sans-serif' },
+    { value: 'Segoe UI', label: 'Segoe UI', category: 'sans-serif' },
+    { value: 'Calibri', label: 'Calibri', category: 'sans-serif' },
+    { value: 'Cambria', label: 'Cambria', category: 'serif' },
+    { value: 'Georgia', label: 'Georgia', category: 'serif' },
+    { value: 'Consolas', label: 'Consolas', category: 'sans-serif' },
+    { value: 'Courier New', label: 'Courier New', category: 'serif' },
+    { value: 'Trebuchet MS', label: 'Trebuchet MS', category: 'sans-serif' },
+    { value: 'Gill Sans', label: 'Gill Sans', category: 'sans-serif' },
+    { value: 'Avenir Next', label: 'Avenir Next', category: 'sans-serif' },
+    { value: 'Menlo', label: 'Menlo', category: 'sans-serif' },
+    { value: 'Roboto', label: 'Roboto', category: 'sans-serif' },
+    { value: 'Noto Sans', label: 'Noto Sans', category: 'sans-serif' },
+    { value: 'Noto Sans CJK SC', label: 'Noto Sans CJK SC', category: 'sans-serif' },
+    { value: 'Noto Sans CJK TC', label: 'Noto Sans CJK TC', category: 'sans-serif' },
+    { value: 'Noto Serif CJK SC', label: 'Noto Serif CJK SC', category: 'serif' },
+    { value: 'Noto Serif CJK TC', label: 'Noto Serif CJK TC', category: 'serif' },
+    { value: 'Source Han Sans SC', label: '思源黑体（简体中文）', category: 'sans-serif' },
+    { value: 'Source Han Sans TC', label: '思源黑体（繁体中文）', category: 'sans-serif' },
+    { value: 'Source Han Serif SC', label: '思源宋体（简体中文）', category: 'serif' },
+    { value: 'Source Han Serif TC', label: '思源宋体（繁体中文）', category: 'serif' },
+    { value: 'WenQuanYi Zen Hei', label: '文泉驿正黑', category: 'sans-serif' },
+    { value: 'Microsoft JhengHei', label: '微软正黑', category: 'sans-serif' },
+    { value: 'Microsoft JhengHei UI', label: '微软正黑 UI', category: 'sans-serif' },
+    { value: 'DengXian', label: '等线', category: 'sans-serif' },
+    { value: 'STHeiti', label: '华文黑体', category: 'sans-serif' },
+    { value: 'STSong', label: '华文宋体', category: 'serif' },
+    { value: 'STKaiti', label: '华文楷体', category: 'serif' },
+    { value: 'STFangsong', label: '华文仿宋', category: 'serif' },
+    { value: 'Songti SC', label: '宋体 SC', category: 'serif' },
+    { value: 'Songti TC', label: '宋体 TC', category: 'serif' },
+    { value: 'Heiti SC', label: '黑体 SC', category: 'sans-serif' },
+    { value: 'Hiragino Sans GB', label: '冬青黑体简', category: 'sans-serif' },
+    { value: 'Hiragino Mincho ProN', label: '冬青明朝体', category: 'serif' },
+    { value: 'MingLiU', label: '细明体', category: 'serif' },
+    { value: 'PMingLiU', label: '新细明体', category: 'serif' },
+    { value: 'Alibaba PuHuiTi 3.0', label: '阿里巴巴普惠体 3.0', category: 'sans-serif' },
+    { value: 'Alibaba PuHuiTi 2.0', label: '阿里巴巴普惠体 2.0', category: 'sans-serif' },
+];
+/**
+ * Univer's built-in list is repeated here so it can be filtered before
+ * Univer creates its FontService. Browsers cannot enumerate every system
+ * font, so this is a candidate list rather than a system-font API.
+ */
+export const DATA_SHEET_FONT_CANDIDATE_CONFIGS = [
+    { value: 'Arial', label: 'ui.fontFamily.arial', category: 'sans-serif' },
+    { value: 'Times New Roman', label: 'ui.fontFamily.times-new-roman', category: 'serif' },
+    { value: 'Tahoma', label: 'ui.fontFamily.tahoma', category: 'sans-serif' },
+    { value: 'Verdana', label: 'ui.fontFamily.verdana', category: 'sans-serif' },
+    { value: 'Microsoft YaHei', label: 'ui.fontFamily.microsoft-yahei', category: 'sans-serif' },
+    { value: 'SimSun', label: 'ui.fontFamily.simsun', category: 'serif' },
+    { value: 'SimHei', label: 'ui.fontFamily.simhei', category: 'sans-serif' },
+    { value: 'Kaiti', label: 'ui.fontFamily.kaiti', category: 'serif' },
+    { value: 'FangSong', label: 'ui.fontFamily.fangsong', category: 'serif' },
+    { value: 'NSimSun', label: 'ui.fontFamily.nsimsun', category: 'serif' },
+    { value: 'STXinwei', label: 'ui.fontFamily.stxinwei', category: 'serif' },
+    { value: 'STXingkai', label: 'ui.fontFamily.stxingkai', category: 'serif' },
+    { value: 'STLiti', label: 'ui.fontFamily.stliti', category: 'serif' },
+    ...DATA_SHEET_CUSTOM_FONT_CONFIGS,
+];
+/**
+ * Filter candidates using the same canvas-metrics check Univer uses for its
+ * unsupported-font indicator. This runs before createUniver(), because
+ * Univer snapshots the configured list while constructing FontService.
+ */
+export function getInstalledFontConfigs() {
+    if (typeof document === 'undefined')
+        return [...DATA_SHEET_FONT_CANDIDATE_CONFIGS];
+    const context = document.createElement('canvas').getContext('2d');
+    if (context === null)
+        return [];
+    // Include CJK glyphs as well as Latin glyphs. Many Chinese fonts share
+    // nearly identical Latin metrics, so a Latin-only probe incorrectly hides
+    // installed CJK families from the dropdown.
+    const sample = 'AaBbMmWw0123456789中文汉字测试東京한글';
+    const size = '72px';
+    const baseFonts = ['monospace', 'serif', 'sans-serif'];
+    const defaultWidths = new Map();
+    for (const base of baseFonts) {
+        context.font = `${size} ${base}`;
+        defaultWidths.set(base, context.measureText(sample).width);
+    }
+    return DATA_SHEET_FONT_CANDIDATE_CONFIGS.filter(font => baseFonts.some(base => {
+        context.font = `${size} "${font.value}", ${base}`;
+        return context.measureText(sample).width !== defaultWidths.get(base);
+    }));
+}
+/**
+ * Give every sheet the shared default font family.
+ *
+ * The sheet default is a migration target: this fixes workbooks created before
+ * Datasheet switched from Arial to PingFang SC. Cell-level styles stay untouched,
+ * so an explicit font choice is still respected.
+ */
+export function withDefaultSheetFont(workbookData) {
+    const root = workbookData;
+    if (root.sheets === undefined || typeof root.sheets !== 'object')
+        return workbookData;
+    let changed = false;
+    const sheets = Object.fromEntries(Object.entries(root.sheets).map(([id, sheet]) => {
+        const currentStyle = sheet.defaultStyle;
+        const defaultStyle = currentStyle !== null && typeof currentStyle === 'object' && !Array.isArray(currentStyle)
+            ? currentStyle
+            : {};
+        if (defaultStyle.ff === DEFAULT_SHEET_FONT_FAMILY)
+            return [id, sheet];
+        changed = true;
+        return [id, { ...sheet, defaultStyle: { ...defaultStyle, ff: DEFAULT_SHEET_FONT_FAMILY } }];
+    }));
+    return changed ? { ...root, sheets } : workbookData;
+}

package/lib/types/univer/plugins/collaboration.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Univer-side collaboration seam used by Datasheet.
+ *
+ * Univer exposes `onMutationExecutedForCollab` specifically for collaboration
+ * implementations.  We use that native seam, but keep the transport and
+ * persistence outside Univer so the plugin does not depend on Univer Pro.
+ */
+import { IUniverInstanceService, ICommandService, Injector, Plugin, UniverInstanceType, type ICommandInfo, type IExecutionOptions } from '@univerjs/presets';
+export interface DataSheetCollaborationConfig {
+    onMutation?: (commandInfo: Readonly<ICommandInfo>, options?: IExecutionOptions) => void;
+}
+/** Connects Univer's native mutation stream to the Datasheet session. */
+export declare class DataSheetCollaborationPlugin extends Plugin {
+    private readonly _config;
+    protected readonly _injector: Injector;
+    private readonly _commandService;
+    static pluginName: string;
+    static packageName: string;
+    static version: string;
+    static type: UniverInstanceType;
+    constructor(_config: DataSheetCollaborationConfig | undefined, _injector: Injector, _commandService: ICommandService, _univerInstanceService: IUniverInstanceService);
+    onStarting(): void;
+}

package/lib/types/univer/plugins/collaboration.js

@@ -0,0 +1,47 @@
+/**
+ * Univer-side collaboration seam used by Datasheet.
+ *
+ * Univer exposes `onMutationExecutedForCollab` specifically for collaboration
+ * implementations.  We use that native seam, but keep the transport and
+ * persistence outside Univer so the plugin does not depend on Univer Pro.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { IUniverInstanceService, Inject, ICommandService, Injector, Plugin, UniverInstanceType, } from '@univerjs/presets';
+import { UNIVER_PLUGIN_VERSION } from "./version.js";
+/** Connects Univer's native mutation stream to the Datasheet session. */
+let DataSheetCollaborationPlugin = class DataSheetCollaborationPlugin extends Plugin {
+    _config;
+    _injector;
+    _commandService;
+    static pluginName = 'dsh.data-sheet.collaboration';
+    static packageName = 'dsh-data-table';
+    static version = UNIVER_PLUGIN_VERSION;
+    static type = UniverInstanceType.UNIVER_SHEET;
+    constructor(_config, _injector, _commandService, _univerInstanceService) {
+        super();
+        this._config = _config;
+        this._injector = _injector;
+        this._commandService = _commandService;
+    }
+    onStarting() {
+        this.disposeWithMe(this._commandService.onMutationExecutedForCollab((commandInfo, options) => {
+            if (options?.onlyLocal || options?.fromChangeset || options?.fromCollab)
+                return;
+            this._config?.onMutation?.(commandInfo, options);
+        }));
+    }
+};
+DataSheetCollaborationPlugin = __decorate([
+    __param(1, Inject(Injector)),
+    __param(2, ICommandService),
+    __param(3, IUniverInstanceService)
+], DataSheetCollaborationPlugin);
+export { DataSheetCollaborationPlugin };

package/lib/types/univer/plugins/export.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Univer-side export plugin for dsh-data-table.
+ *
+ * This follows Univer's normal plugin shape: commands are registered with
+ * ICommandService. The browser-facing exporter stays a small adapter over
+ * the live Workbook model, so menu actions always export the current
+ * in-memory edits.
+ * @module dsh-data-table/univer-export-plugin
+ */
+import { ICommandService, IUniverInstanceService, Injector, Plugin, UniverInstanceType } from '@univerjs/presets';
+export declare const EXPORT_CSV_COMMAND_ID = "dsh.data-sheet.export-csv";
+export declare const EXPORT_XLSX_COMMAND_ID = "dsh.data-sheet.export-xlsx";
+export declare const IMPORT_XLSX_COMMAND_ID = "dsh.data-sheet.import-xlsx";
+/** Univer plugin that owns the datasheet export commands and DSH menu bridge. */
+export declare class DataSheetExportPlugin extends Plugin {
+    protected readonly _injector: Injector;
+    private readonly _commandService;
+    private readonly _univerInstanceService;
+    static pluginName: string;
+    static packageName: string;
+    static version: string;
+    static type: UniverInstanceType;
+    constructor(_config: undefined, _injector: Injector, _commandService: ICommandService, _univerInstanceService: IUniverInstanceService);
+    onStarting(): void;
+    private export;
+    private importFile;
+    /**
+     * Parse one buffer and hand the workbook to the panel.
+     *
+     * Shared by both ways in — the OS file dialog and the project chooser, which
+     * reads the bytes over HTTP because a browser cannot open a path. Everything
+     * after the bytes arrive is one pipeline, so the two entry points cannot drift
+     * into two imports.
+     *
+     * @param data - The file's bytes.
+     * @param name - The name the panel reports and the worker partly decides from.
+     */
+    private importBuffer;
+}