@atri-editor/core 0.1.0

package/dist/media/InsertPanel.d.ts

@@ -0,0 +1,59 @@
+/**
+ * InsertPanel - 工具栏下方的插入浮层
+ *
+ * 挂在 document.body 上并用 fixed 定位：工具栏那一层链路上任何一处 overflow 都会把浮层裁掉。
+ */
+import type { Editor } from '@tiptap/core';
+import type { I18nManager } from '../core/I18nManager';
+import type { MediaRuntime } from './MediaRuntime';
+export type InsertPanelMode = 'image' | 'attachment';
+export interface InsertPanelOptions {
+    editor: Editor;
+    runtime: MediaRuntime;
+    i18n?: I18nManager;
+    /** 开合时把控制权交回工具栏：按钮的 active 与 aria-expanded 由它维护 */
+    onOpenChange?: (mode: InsertPanelMode | null) => void;
+}
+export declare class InsertPanel {
+    private editor;
+    private runtime;
+    private i18n?;
+    private onOpenChange?;
+    private unsubscribeLanguage?;
+    private element;
+    private mode;
+    private stopAutoUpdate;
+    private detachDismiss;
+    private labelled;
+    constructor(options: InsertPanelOptions);
+    get openMode(): InsertPanelMode | null;
+    /**
+     * 同一个按钮再点一次是关闭；换按钮则直接把浮层挪过去
+     */
+    toggle(anchor: HTMLElement, mode: InsertPanelMode): void;
+    close(): void;
+    destroy(): void;
+    private t;
+    /**
+     * 登记一处随语言重画的文案：input 画到 placeholder，其他画成文字
+     */
+    private label;
+    private applyLabels;
+    private applyLabel;
+    private build;
+    /**
+     * 主题变量写在 .atri-editor 上，浮层挂在 body 上够不着，只能把主题类复制一份
+     */
+    private applyTheme;
+    /**
+     * 外链图片当场就插，不进上传队列：地址本来就是可用的
+     */
+    private insertFromUrl;
+    private upload;
+    private position;
+    /**
+     * 点外面与 Escape 关闭；锚点按钮交给 toggle，否则关了又立刻被这次点击重开
+     */
+    private listenForDismiss;
+}
+//# sourceMappingURL=InsertPanel.d.ts.map

package/dist/media/InsertPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InsertPanel.d.ts","sourceRoot":"","sources":["../../src/media/InsertPanel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,YAAY,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,mDAAmD;IACnD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;CACvD;AAmBD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,IAAI,CAAC,CAAc;IAC3B,OAAO,CAAC,YAAY,CAAC,CAAyC;IAC9D,OAAO,CAAC,mBAAmB,CAAC,CAAa;IAEzC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAyB;IAEzC,YAAY,OAAO,EAAE,kBAAkB,EAOtC;IAED,IAAI,QAAQ,IAAI,eAAe,GAAG,IAAI,CAErC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI,CAYvD;IAED,KAAK,IAAI,IAAI,CAYZ;IAED,OAAO,IAAI,IAAI,CAId;IAED,OAAO,CAAC,CAAC;IAMT;;OAEG;IACH,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,KAAK;IAqFb;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,MAAM;YAOA,QAAQ;IA2BtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqBzB"}

package/dist/media/MediaRuntime.d.ts

@@ -0,0 +1,113 @@
+/**
+ * MediaRuntime - 上传队列与节点瞬时态
+ *
+ * 生命周期比 CoreEditor 长：registerNodeView 会重建编辑器，进行中的上传不能跟着丢，
+ * 所以它由 AtriEditor 持有一个实例，每次重建通过 bind() 换绑到新的 Editor。
+ */
+import type { Editor } from '@tiptap/core';
+import type { AtriMediaConfig, MediaKind } from '../types';
+/** 节点瞬时态，写进 data-atri-upload-status */
+export type MediaStatus = 'uploading' | 'error';
+/** 队列快照，供状态条这类外部展示消费 */
+export interface MediaState {
+    uploading: number;
+    /** 失败且内容还只存在于本地预览里的，丢了就是真丢了 */
+    failed: number;
+    /** 失败后已按配置内联成 data URL 的图片：不必再传也不该丢 */
+    inline: number;
+    /** 按文件体积加权的整体进度，无进行中任务时为 0 */
+    percent: number;
+}
+export interface HandleFilesOptions {
+    /** 缺省时按 MIME 分流到图片与附件 */
+    kind?: MediaKind;
+    /** 落点位置（拖放用）；省略时插在当前选区 */
+    pos?: number;
+}
+export declare class MediaRuntime {
+    private config;
+    private uploader;
+    private editor;
+    private tasks;
+    private listeners;
+    private sequence;
+    constructor(config?: AtriMediaConfig);
+    /**
+     * 换绑到新的 Editor 实例，并把瞬时态补回重建后的文档
+     */
+    bind(editor: Editor): void;
+    /**
+     * 处理一批文件：校验 → 插节点 → 上传 → 回写
+     * kind 缺省时按 MIME 分流；MediaKind 与节点名一一对应，直接当 type 用
+     */
+    handleFiles(files: File[] | FileList, options?: HandleFilesOptions): Promise<void>;
+    /**
+     * 该类型的文件白名单，已归一成 <input accept> 能用的写法
+     * 面板与校验共用同一份配置，免得选得到却传不了
+     */
+    acceptFor(kind: MediaKind): string | undefined;
+    /**
+     * 重试所有失败的上传，卡片原地回到上传中
+     * 失败后已内联成 data URL 的图片也在其中：换到服务端地址前它一直算"失败"
+     */
+    retryFailed(): Promise<void>;
+    /**
+     * 文档里是否还有"现在就保存会丢内容"的文件：上传中与失败都算，
+     * 因为它们的 src 还指着本地预览地址（blob:），刷新即失效
+     *
+     * 失败后已按配置内联成 data URL 的图片不计入——内容已经安全落进文档，
+     * 服务端地址只是可选的优化，别让一个一直失败的上传把保存永久卡住
+     */
+    hasPendingUploads(): boolean;
+    getState(): MediaState;
+    subscribe(listener: (state: MediaState) => void): () => void;
+    destroy(): void;
+    /**
+     * 无上传通道：图片按配置退化成 base64 内联，附件没有合理退路
+     * 先把文件都读完再一起插，顺序才与选文件时一致
+     */
+    private inlineImages;
+    private createTask;
+    /**
+     * 带本地预览的节点内容；上传完这些地址就被服务端地址换掉
+     */
+    private nodeSpec;
+    /**
+     * 一批节点走一次事务：逐个插的话每插一个"那个位置"的含义就变一次，顺序会乱；
+     * 顺带让一次多文件拖放只需撤销一步
+     * pos 为拖放落点，省略时落在当前选区（选中的媒体节点不被顶掉）
+     */
+    private insertContents;
+    private startUpload;
+    /**
+     * 上传失败后把图片读成 data URL，原位换掉 src
+     *
+     * 是 patch 而不是插新节点：位置与"撤销一步回到插入前"这两条语义都靠它才不碎。
+     * error 态留着——重试按钮还在，网络恢复后能把 data URL 换成服务端地址
+     */
+    private inlineAfterFailure;
+    private applyResult;
+    private updateProgress;
+    /**
+     * 写进节点的那份状态；附件卡片额外带百分比
+     */
+    private stateAttrs;
+    private patch;
+    /**
+     * 编辑器重建后 uploadId 不在 HTML 里，靠本地预览地址把瞬时态补回文档
+     */
+    private restoreTransientState;
+    /**
+     * 丢掉文档里已经没有对应节点的任务，中止其请求
+     */
+    private prune;
+    private findPosition;
+    private taskByPreviewUrl;
+    /**
+     * 摘掉任务并回收预览地址；是否 abort 由调用方决定
+     */
+    private dropTask;
+    private reject;
+    private emit;
+}
+//# sourceMappingURL=MediaRuntime.d.ts.map

package/dist/media/MediaRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaRuntime.d.ts","sourceRoot":"","sources":["../../src/media/MediaRuntime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAW,MAAM,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EAIV,MAAM,UAAU,CAAC;AAKlB,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAEhD,wBAAwB;AACxB,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAgCD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,QAAQ,CAAK;IAErB,YAAY,MAAM,GAAE,eAAoB,EAGvC;IAED;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CASzB;IAED;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsC3F;IAED;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAI7C;IAED;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3B;IAED;;;;;;OAMG;IACH,iBAAiB,IAAI,OAAO,CAE3B;IAED,QAAQ,IAAI,UAAU,CAerB;IAED,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAM3D;IAED,OAAO,IAAI,IAAI,CAQd;IAED;;;OAGG;YACW,YAAY;IAoB1B,OAAO,CAAC,UAAU;IAelB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAyBhB;;;;OAIG;IACH,OAAO,CAAC,cAAc;YAWR,WAAW;IA4CzB;;;;;OAKG;YACW,kBAAkB;IAsBhC,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,KAAK;IAiCb;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;OAEG;IACH,OAAO,CAAC,KAAK;IAmBb,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,IAAI;CAKb"}

package/dist/media/MediaStatusStrip.d.ts

@@ -0,0 +1,20 @@
+/**
+ * MediaStatusStrip - 上传队列状态条
+ *
+ * 卡片与图片上没有一处文字状态（那都由样式表靠 data 属性表达），
+ * "上传中 2 个""1 个失败""重试"这些要读得懂的话都集中在这里，本地化只发生在这一处。
+ */
+import type { I18nManager } from '../core/I18nManager';
+import type { MediaRuntime } from './MediaRuntime';
+export declare class MediaStatusStrip {
+    private labels;
+    private element;
+    private text;
+    private retry;
+    private unsubscribe?;
+    private unsubscribeLanguage?;
+    constructor(runtime: MediaRuntime, container: HTMLElement, i18n?: I18nManager);
+    destroy(): void;
+    private render;
+}
+//# sourceMappingURL=MediaStatusStrip.d.ts.map

package/dist/media/MediaStatusStrip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaStatusStrip.d.ts","sourceRoot":"","sources":["../../src/media/MediaStatusStrip.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,gBAAgB,CAAC;AAS/D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,mBAAmB,CAAC,CAAa;IAEzC,YAAY,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,WAAW,EAoC5E;IAED,OAAO,IAAI,IAAI,CAId;IAED,OAAO,CAAC,MAAM;CAwBf"}

package/dist/media/Uploader.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Uploader - 上传通道
+ *
+ * 两条路：用户给 handler 就完全接管；给 endpoint 就走内置 XHR。
+ * 选 XHR 而不是 fetch，是因为 fetch 没有可移植的上传进度事件（xhr.upload.onprogress）。
+ */
+import type { AtriUploadConfig, UploadContext, UploadHandler, UploadResult } from '../types';
+export interface Uploader {
+    upload(file: File, context: UploadContext): Promise<UploadResult>;
+}
+export declare function createUploader(upload?: AtriUploadConfig | UploadHandler): Uploader | null;
+//# sourceMappingURL=Uploader.d.ts.map

package/dist/media/Uploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Uploader.d.ts","sourceRoot":"","sources":["../../src/media/Uploader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7F,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACnE;AAkFD,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,aAAa,GAAG,QAAQ,GAAG,IAAI,CAUzF"}

package/dist/media/file-policy.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 文件策略：大小展示与类型白名单
+ */
+/**
+ * 字节数 → 人类可读标签，1024 进制
+ * B 之外的单位保留一位小数，整数值去掉多余的 .0
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * 人类可读标签 → 字节数
+ * 与 formatFileSize 成对使用；标签只有一位小数精度，因此还原值是近似值
+ */
+export declare function parseFileSize(label?: string | null): number | undefined;
+/** 单个文件默认上限：10MB */
+export declare const DEFAULT_MAX_FILE_SIZE: number;
+/** 一次投放/选择的默认文件数上限 */
+export declare const DEFAULT_MAX_FILES = 10;
+/** accept 支持的三种写法：`.pdf`、`image/*`、`image/png` */
+export declare function matchesAccept(file: File, accept?: string | string[]): boolean;
+/** 把配置的 accept 归一成 <input accept> 需要的逗号串：选择器与校验得是同一份白名单 */
+export declare function acceptAttribute(accept?: string | string[]): string | undefined;
+export type FileValidation = {
+    ok: true;
+} | {
+    ok: false;
+    reason: 'too-large' | 'unsupported-type';
+};
+export declare function validateFile(file: File, options: {
+    accept?: string | string[];
+    maxFileSize?: number;
+}): FileValidation;
+/** 拖放与粘贴进来的文件按 MIME 分流到图片还是附件 */
+export declare function isImageFile(file: File): boolean;
+//# sourceMappingURL=file-policy.d.ts.map

package/dist/media/file-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-policy.d.ts","sourceRoot":"","sources":["../../src/media/file-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAapD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAUvE;AAED,oBAAoB;AACpB,eAAO,MAAM,qBAAqB,QAAwB,CAAC;AAE3D,sBAAsB;AACtB,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAiB7E;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAO9E;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,kBAAkB,CAAA;CAAE,CAAC;AAEpG,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,cAAc,CAOhB;AAED,iCAAiC;AACjC,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE/C"}

package/dist/media/insert-position.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 媒体节点的插入落点
+ */
+import { type Selection } from '@tiptap/pm/state';
+/**
+ * 插完一个 atom 媒体节点，它会处于选中态；插入命令替换的是整个选区，
+ * 于是空文档里连插两张图只剩一张。选中的正是媒体节点时，把落点挪到它后面。
+ */
+export declare function mediaInsertTarget(selection: Selection): number | {
+    from: number;
+    to: number;
+};
+//# sourceMappingURL=insert-position.d.ts.map

package/dist/media/insert-position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-position.d.ts","sourceRoot":"","sources":["../../src/media/insert-position.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAW7F"}