@hamster-note/types 0.1.0 → 0.5.1

package/dist/index.d.ts

@@ -0,0 +1,243 @@
+//#region src/math/Number2.d.ts
+type Number2 = {
+  x: number;
+  y: number;
+};
+//#endregion
+//#region src/HamsterDocument/IntermediateText.d.ts
+declare enum TextDir {
+  TTB = "ttb",
+  LTR = "ltr",
+  RTL = "rtl",
+}
+interface IntermediateTextSerialized {
+  id: string;
+  content: string;
+  fontSize: number;
+  fontFamily: string;
+  fontWeight: number;
+  italic: boolean;
+  color: string;
+  width: number;
+  height: number;
+  lineHeight: number;
+  x: number;
+  y: number;
+  ascent: number;
+  descent: number;
+  vertical?: boolean;
+  dir: TextDir;
+  rotate: number;
+  skew: number;
+  isEOL: boolean;
+}
+declare class IntermediateText implements IntermediateTextSerialized {
+  id: string;
+  content: string;
+  fontSize: number;
+  fontFamily: string;
+  fontWeight: number;
+  italic: boolean;
+  color: string;
+  width: number;
+  height: number;
+  lineHeight: number;
+  x: number;
+  y: number;
+  ascent: number;
+  descent: number;
+  vertical?: boolean;
+  dir: TextDir;
+  rotate: number;
+  skew: number;
+  isEOL: boolean;
+  static serialize(text: IntermediateText): IntermediateTextSerialized;
+  static parse(data: IntermediateTextSerialized): IntermediateText;
+  constructor({
+    id,
+    content,
+    fontSize,
+    fontFamily,
+    fontWeight,
+    italic,
+    color,
+    width,
+    height,
+    lineHeight,
+    x,
+    y,
+    ascent,
+    descent,
+    vertical,
+    dir,
+    rotate,
+    skew,
+    isEOL
+  }: IntermediateTextSerialized);
+}
+declare enum TextMarkedContentType {
+  BEGIN_MARKED_CONTENT = "beginMarkedContent",
+  BEGIN_MARKED_CONTENT_PROPS = "beginMarkedContentProps",
+  END_MARKED_CONTENT = "endMarkedContent",
+}
+declare class IntermediateTextMarkedContent extends IntermediateText {
+  protected type: TextMarkedContentType;
+  protected markedContentId: string;
+  constructor(data: IntermediateTextSerialized, type: TextMarkedContentType, markedContentId: string);
+}
+//#endregion
+//#region src/HamsterDocument/IntermediatePage.d.ts
+interface IntermediatePageSerialized {
+  id: string;
+  texts: IntermediateTextSerialized[];
+  width: number;
+  height: number;
+  number: number;
+  thumbnail: string | undefined;
+}
+type TextsGetterReturnType = Promise<IntermediateText[] | IntermediateTextSerialized[]> | IntermediateText[] | IntermediateTextSerialized[];
+declare class IntermediatePage {
+  id: string;
+  texts: IntermediateText[];
+  width: number;
+  height: number;
+  number: number;
+  private _thumbnail?;
+  private _getThumbnailFn?;
+  private _getTextsFn?;
+  private textsLoaded;
+  static serialize(page: IntermediatePage): IntermediatePageSerialized;
+  static parse(data: IntermediatePageSerialized): IntermediatePage;
+  constructor({
+    texts,
+    width,
+    height,
+    number,
+    id,
+    thumbnail,
+    getThumbnailFn,
+    getTextsFn
+  }: Omit<IntermediatePageSerialized, 'texts'> & {
+    texts: IntermediateText[] | IntermediateTextSerialized[];
+  } & {
+    getThumbnailFn?: (scale: number) => Promise<string | undefined>;
+    getTextsFn?: () => TextsGetterReturnType;
+  });
+  getThumbnail(scale?: number): Promise<string | undefined>;
+  getTexts(): Promise<IntermediateText[]>;
+  get hasLoadedTexts(): boolean;
+  setGetThumbnail(fn: (scale: number) => Promise<string | undefined>): void;
+  setGetTexts(fn: () => TextsGetterReturnType): void;
+}
+//#endregion
+//#region src/HamsterDocument/IntermediateOutline.d.ts
+declare enum IntermediateOutlineDestType {
+  TEXT = "text",
+  PAGE = "page",
+  POSITION = "position",
+  URL = "url",
+}
+type IntermediateOutlineDest = IntermediateOutlineDestPage | IntermediateOutlineDestText | IntermediateOutlineDestPosition | IntermediateOutlineDestUrl;
+interface IntermediateOutlineDestUrl {
+  targetType: IntermediateOutlineDestType.URL;
+  url: string;
+  unsafeUrl: string | undefined;
+  newWindow: boolean;
+  items?: IntermediateOutlineDest[];
+}
+interface IntermediateOutlineDestPage {
+  targetType: IntermediateOutlineDestType.PAGE;
+  pageId: string;
+  items?: IntermediateOutlineDest[];
+}
+interface IntermediateOutlineDestText {
+  targetType: IntermediateOutlineDestType.TEXT;
+  textId: string;
+  items?: IntermediateOutlineDest[];
+}
+interface IntermediateOutlineDestPosition {
+  targetType: IntermediateOutlineDestType.POSITION;
+  items?: IntermediateOutlineDest[];
+}
+interface IntermediateOutlineSerialized extends IntermediateTextSerialized {
+  dest: IntermediateOutlineDest;
+}
+declare class IntermediateOutline extends IntermediateText implements IntermediateOutlineSerialized {
+  dest: IntermediateOutlineDest;
+  static serialize(outline: IntermediateOutline): IntermediateOutlineSerialized;
+  static parse(data: IntermediateOutlineSerialized): IntermediateOutline;
+  constructor(data: IntermediateOutlineSerialized);
+}
+//#endregion
+//#region src/HamsterDocument/IntermediateDocument.d.ts
+interface IntermediateDocumentSerialized {
+  id: string;
+  pages: IntermediatePageSerialized[];
+  title: string;
+  outline?: IntermediateOutlineSerialized[];
+}
+type PageLoader = () => Promise<IntermediatePage>;
+interface IntermediatePageEntry {
+  id: string;
+  pageNumber: number;
+  size: Number2;
+  loader: PageLoader;
+  cache?: Promise<IntermediatePage>;
+}
+declare class IntermediatePageMap {
+  private entryById;
+  private entryByPageNumber;
+  constructor(entries?: IntermediatePageEntry[]);
+  private registerEntry;
+  private resolve;
+  getPages(): Promise<IntermediatePage[]>;
+  updatePage(page: IntermediatePage): void;
+  get pageCount(): number;
+  get pageNumbers(): number[];
+  static fromSerialized(pages: IntermediatePageSerialized[]): IntermediatePageMap;
+  static fromInfoList(infoList: {
+    id: string;
+    pageNumber: number;
+    size: Number2;
+    getData: PageLoader;
+  }[]): IntermediatePageMap;
+  static makeBySerializedData(pages: IntermediatePageSerialized[]): IntermediatePageMap;
+  static makeByInfoList(infoList: {
+    id: string;
+    pageNumber: number;
+    size: Number2;
+    getData: PageLoader;
+  }[]): IntermediatePageMap;
+  getPageById(id: string): Promise<IntermediatePage> | undefined;
+  getPageByPageNumber(pageNumber: number): Promise<IntermediatePage> | undefined;
+  getPageSizeByPageNumber(pageNumber: number): Number2 | undefined;
+}
+declare class IntermediateDocument {
+  readonly id: string;
+  title: string;
+  outline?: IntermediateOutline[];
+  get pages(): Promise<IntermediatePage[]>;
+  set pages(pages: IntermediatePage[]);
+  private pagesMap;
+  static serialize(doc: IntermediateDocument): Promise<IntermediateDocumentSerialized>;
+  static parse(data: IntermediateDocumentSerialized): IntermediateDocument;
+  constructor({
+    pagesMap,
+    id,
+    title,
+    outline
+  }: Omit<IntermediateDocumentSerialized, 'pages'> & {
+    pagesMap: IntermediatePageMap;
+    outline?: IntermediateOutline[];
+  });
+  get pageCount(): number;
+  get pageNumbers(): number[];
+  getCover(scale?: number): Promise<string | undefined>;
+  getPageById(id: string): Promise<IntermediatePage> | undefined;
+  getPageByPageNumber(pageNumber: number): Promise<IntermediatePage> | undefined;
+  getPageSizeByPageNumber(pageNumber: number): Number2 | undefined;
+  getOutline(): IntermediateOutline[] | undefined;
+}
+//#endregion
+export { IntermediateDocument, IntermediateDocumentSerialized, IntermediateOutline, IntermediateOutlineDest, IntermediateOutlineDestPage, IntermediateOutlineDestPosition, IntermediateOutlineDestText, IntermediateOutlineDestType, IntermediateOutlineDestUrl, IntermediateOutlineSerialized, IntermediatePage, IntermediatePageMap, IntermediatePageSerialized, IntermediateText, IntermediateTextMarkedContent, IntermediateTextSerialized, Number2, TextDir, TextMarkedContentType };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,311 @@
+//#region src/HamsterDocument/IntermediateText.ts
+let TextDir = /* @__PURE__ */ function(TextDir$1) {
+	TextDir$1["TTB"] = "ttb";
+	TextDir$1["LTR"] = "ltr";
+	TextDir$1["RTL"] = "rtl";
+	return TextDir$1;
+}({});
+var IntermediateText = class IntermediateText {
+	id;
+	content;
+	fontSize;
+	fontFamily;
+	fontWeight;
+	italic;
+	color;
+	width;
+	height;
+	lineHeight;
+	x;
+	y;
+	ascent;
+	descent;
+	vertical;
+	dir;
+	rotate;
+	skew;
+	isEOL;
+	static serialize(text) {
+		return { ...text };
+	}
+	static parse(data) {
+		return new IntermediateText(data);
+	}
+	constructor({ id, content, fontSize, fontFamily, fontWeight, italic, color, width, height, lineHeight, x, y, ascent, descent, vertical, dir, rotate, skew, isEOL }) {
+		this.id = id;
+		this.content = content;
+		this.fontSize = fontSize;
+		this.fontFamily = fontFamily;
+		this.fontWeight = fontWeight;
+		this.italic = italic;
+		this.color = color;
+		this.width = width;
+		this.height = height;
+		this.lineHeight = lineHeight;
+		this.x = x;
+		this.y = y;
+		this.ascent = ascent;
+		this.descent = descent;
+		this.vertical = vertical;
+		this.dir = dir;
+		this.rotate = rotate;
+		this.skew = skew;
+		this.isEOL = isEOL;
+	}
+};
+let TextMarkedContentType = /* @__PURE__ */ function(TextMarkedContentType$1) {
+	TextMarkedContentType$1["BEGIN_MARKED_CONTENT"] = "beginMarkedContent";
+	TextMarkedContentType$1["BEGIN_MARKED_CONTENT_PROPS"] = "beginMarkedContentProps";
+	TextMarkedContentType$1["END_MARKED_CONTENT"] = "endMarkedContent";
+	return TextMarkedContentType$1;
+}({});
+var IntermediateTextMarkedContent = class extends IntermediateText {
+	constructor(data, type, markedContentId) {
+		super(data);
+		this.type = type;
+		this.markedContentId = markedContentId;
+	}
+};
+
+//#endregion
+//#region src/HamsterDocument/IntermediatePage.ts
+var IntermediatePage = class IntermediatePage {
+	id;
+	texts;
+	width;
+	height;
+	number;
+	_thumbnail;
+	_getThumbnailFn;
+	_getTextsFn;
+	textsLoaded;
+	static serialize(page) {
+		return {
+			id: page.id,
+			texts: page.texts.map(IntermediateText.serialize),
+			width: page.width,
+			height: page.height,
+			number: page.number,
+			thumbnail: page._thumbnail
+		};
+	}
+	static parse(data) {
+		return new IntermediatePage(data);
+	}
+	constructor({ texts, width, height, number, id, thumbnail, getThumbnailFn, getTextsFn }) {
+		this.id = id;
+		this.texts = texts.map((t) => t instanceof IntermediateText ? t : new IntermediateText(t));
+		this.width = width;
+		this.height = height;
+		this.number = number;
+		this._thumbnail = thumbnail;
+		if (getThumbnailFn) this._getThumbnailFn = getThumbnailFn;
+		if (getTextsFn) this._getTextsFn = getTextsFn;
+		this.textsLoaded = !getTextsFn;
+	}
+	async getThumbnail(scale = 1) {
+		if (this._getThumbnailFn) return this._getThumbnailFn(scale);
+		return this._thumbnail;
+	}
+	async getTexts() {
+		if (this._getTextsFn) {
+			this.texts = (await this._getTextsFn()).map((t) => t instanceof IntermediateText ? t : new IntermediateText(t));
+			this.textsLoaded = true;
+			this._getTextsFn = void 0;
+		}
+		return this.texts;
+	}
+	get hasLoadedTexts() {
+		return this.textsLoaded;
+	}
+	setGetThumbnail(fn) {
+		this._getThumbnailFn = fn;
+	}
+	setGetTexts(fn) {
+		this._getTextsFn = fn;
+	}
+};
+
+//#endregion
+//#region src/HamsterDocument/IntermediateOutline.ts
+let IntermediateOutlineDestType = /* @__PURE__ */ function(IntermediateOutlineDestType$1) {
+	IntermediateOutlineDestType$1["TEXT"] = "text";
+	IntermediateOutlineDestType$1["PAGE"] = "page";
+	IntermediateOutlineDestType$1["POSITION"] = "position";
+	IntermediateOutlineDestType$1["URL"] = "url";
+	return IntermediateOutlineDestType$1;
+}({});
+var IntermediateOutline = class IntermediateOutline extends IntermediateText {
+	dest;
+	static serialize(outline) {
+		return {
+			...IntermediateText.serialize(outline),
+			dest: outline.dest
+		};
+	}
+	static parse(data) {
+		return new IntermediateOutline(data);
+	}
+	constructor(data) {
+		const { dest, ...textData } = data;
+		super(textData);
+		this.dest = dest;
+	}
+};
+
+//#endregion
+//#region src/HamsterDocument/IntermediateDocument.ts
+var IntermediatePageMap = class IntermediatePageMap {
+	entryById = /* @__PURE__ */ new Map();
+	entryByPageNumber = /* @__PURE__ */ new Map();
+	constructor(entries = []) {
+		entries.forEach((entry) => this.registerEntry(entry));
+	}
+	registerEntry(entry) {
+		this.entryById.set(entry.id, entry);
+		this.entryByPageNumber.set(entry.pageNumber, entry);
+	}
+	async resolve(entry) {
+		if (!entry.cache) entry.cache = entry.loader();
+		return entry.cache;
+	}
+	async getPages() {
+		const orderedEntries = this.pageNumbers.map((pageNumber) => this.entryByPageNumber.get(pageNumber)).filter((entry) => Boolean(entry));
+		return Promise.all(orderedEntries.map((entry) => this.resolve(entry)));
+	}
+	updatePage(page) {
+		const oldById = this.entryById.get(page.id);
+		if (oldById) {
+			this.entryByPageNumber.delete(oldById.pageNumber);
+			this.entryById.delete(oldById.id);
+		}
+		const oldByNumber = this.entryByPageNumber.get(page.number);
+		if (oldByNumber && oldByNumber.id !== page.id) {
+			this.entryById.delete(oldByNumber.id);
+			this.entryByPageNumber.delete(oldByNumber.pageNumber);
+		}
+		const newPromise = Promise.resolve(page);
+		const entry = {
+			id: page.id,
+			pageNumber: page.number,
+			size: {
+				x: page.width,
+				y: page.height
+			},
+			loader: () => newPromise,
+			cache: newPromise
+		};
+		this.registerEntry(entry);
+	}
+	get pageCount() {
+		return this.entryByPageNumber.size;
+	}
+	get pageNumbers() {
+		return [...this.entryByPageNumber.keys()].sort((a, b) => a - b);
+	}
+	static fromSerialized(pages) {
+		return new IntermediatePageMap(pages.map((page) => ({
+			id: page.id,
+			pageNumber: page.number,
+			loader: () => Promise.resolve(new IntermediatePage(page)),
+			size: {
+				x: page.width,
+				y: page.height
+			}
+		})));
+	}
+	static fromInfoList(infoList) {
+		return new IntermediatePageMap(infoList.map((info) => ({
+			id: info.id,
+			pageNumber: info.pageNumber,
+			size: info.size,
+			loader: info.getData
+		})));
+	}
+	static makeBySerializedData(pages) {
+		return IntermediatePageMap.fromSerialized(pages);
+	}
+	static makeByInfoList(infoList) {
+		return IntermediatePageMap.fromInfoList(infoList);
+	}
+	getPageById(id) {
+		const entry = this.entryById.get(id);
+		if (!entry) return void 0;
+		return this.resolve(entry);
+	}
+	getPageByPageNumber(pageNumber) {
+		const entry = this.entryByPageNumber.get(pageNumber);
+		if (!entry) return void 0;
+		return this.resolve(entry);
+	}
+	getPageSizeByPageNumber(pageNumber) {
+		return this.entryByPageNumber.get(pageNumber)?.size;
+	}
+};
+var IntermediateDocument = class IntermediateDocument {
+	id;
+	title;
+	outline;
+	get pages() {
+		return this.pagesMap.getPages();
+	}
+	set pages(pages) {
+		pages.forEach((page) => {
+			this.pagesMap.updatePage(page);
+		});
+	}
+	pagesMap;
+	static async serialize(doc) {
+		const pages = await doc.pagesMap.getPages();
+		return {
+			pages: await Promise.all(pages.map(async (page) => {
+				if (!page.hasLoadedTexts) await page.getTexts();
+				return IntermediatePage.serialize(page);
+			})),
+			id: doc.id,
+			title: doc.title,
+			outline: doc.outline?.map(IntermediateOutline.serialize)
+		};
+	}
+	static parse(data) {
+		return new IntermediateDocument({
+			...data,
+			pagesMap: IntermediatePageMap.fromSerialized(data.pages),
+			outline: data.outline?.map(IntermediateOutline.parse)
+		});
+	}
+	constructor({ pagesMap, id, title, outline }) {
+		this.pagesMap = pagesMap;
+		this.id = id;
+		this.title = title;
+		this.outline = outline;
+	}
+	get pageCount() {
+		return this.pagesMap.pageCount;
+	}
+	get pageNumbers() {
+		return this.pagesMap.pageNumbers;
+	}
+	async getCover(scale = .3) {
+		const firstPagePromise = this.pagesMap.getPageByPageNumber(1);
+		const page = firstPagePromise ? await firstPagePromise : void 0;
+		if (!page) return void 0;
+		return page.getThumbnail(scale);
+	}
+	getPageById(id) {
+		return this.pagesMap.getPageById(id);
+	}
+	getPageByPageNumber(pageNumber) {
+		return this.pagesMap.getPageByPageNumber(pageNumber);
+	}
+	getPageSizeByPageNumber(pageNumber) {
+		return this.pagesMap.getPageSizeByPageNumber(pageNumber);
+	}
+	getOutline() {
+		return this.outline;
+	}
+};
+
+//#endregion
+export { IntermediateDocument, IntermediateOutline, IntermediateOutlineDestType, IntermediatePage, IntermediatePageMap, IntermediateText, IntermediateTextMarkedContent, TextDir, TextMarkedContentType };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/HamsterDocument/IntermediateText.ts","../src/HamsterDocument/IntermediatePage.ts","../src/HamsterDocument/IntermediateOutline.ts","../src/HamsterDocument/IntermediateDocument.ts"],"sourcesContent":["export enum TextDir {\n  TTB = 'ttb',\n  LTR = 'ltr',\n  RTL = 'rtl'\n}\n\nexport interface IntermediateTextSerialized {\n  id: string\n  // 文字内容\n  content: string\n  // 字体大小，大于等于 1 的按 px 计算，小于 1 的按 em  计算\n  fontSize: number\n  // 字体，字体具体需要用户下载，这里只定义字体名称\n  fontFamily: string\n  // 字重，默认 500\n  fontWeight: number\n  // 是否斜体\n  italic: boolean\n  // 字体颜色\n  color: string\n  // 整体宽度\n  width: number\n  // 整体高度\n  height: number\n  // 行高\n  lineHeight: number\n  // x 坐标, 大于等于 1 的按 px，小于 1 的按 百分比\n  x: number\n  // y 坐标, 大于等于 1 的按 px，小于 1 的按 百分比\n  y: number\n  // 字体 baseline\n  ascent: number\n  // 字体 descent\n  descent: number\n  // 垂直文字\n  vertical?: boolean\n  // 文字方向\n  dir: TextDir\n  // 旋转\n  rotate: number\n  // 倾斜\n  skew: number\n  // 是否是行末\n  isEOL: boolean\n}\n\nexport class IntermediateText implements IntermediateTextSerialized {\n  public id: string\n  public content: string\n  public fontSize: number\n  public fontFamily: string\n  public fontWeight: number\n  public italic: boolean\n  public color: string\n  public width: number\n  public height: number\n  public lineHeight: number\n  public x: number\n  public y: number\n  public ascent: number\n  public descent: number\n  public vertical?: boolean\n  public dir: TextDir\n  public rotate: number\n  public skew: number\n  public isEOL: boolean\n  static serialize(text: IntermediateText): IntermediateTextSerialized {\n    return {\n      ...text\n    }\n  }\n  static parse(data: IntermediateTextSerialized): IntermediateText {\n    return new IntermediateText(data)\n  }\n  constructor({\n    id,\n    content,\n    fontSize,\n    fontFamily,\n    fontWeight,\n    italic,\n    color,\n    width,\n    height,\n    lineHeight,\n    x,\n    y,\n    ascent,\n    descent,\n    vertical,\n    dir,\n    rotate,\n    skew,\n    isEOL\n  }: IntermediateTextSerialized) {\n    this.id = id\n    this.content = content\n    this.fontSize = fontSize\n    this.fontFamily = fontFamily\n    this.fontWeight = fontWeight\n    this.italic = italic\n    this.color = color\n    this.width = width\n    this.height = height\n    this.lineHeight = lineHeight\n    this.x = x\n    this.y = y\n    this.ascent = ascent\n    this.descent = descent\n    this.vertical = vertical\n    this.dir = dir\n    this.rotate = rotate\n    this.skew = skew\n    this.isEOL = isEOL\n  }\n}\n\nexport enum TextMarkedContentType {\n  BEGIN_MARKED_CONTENT = 'beginMarkedContent',\n  BEGIN_MARKED_CONTENT_PROPS = 'beginMarkedContentProps',\n  END_MARKED_CONTENT = 'endMarkedContent'\n}\n\nexport class IntermediateTextMarkedContent extends IntermediateText {\n  // 这两个值参见 pdfjs 的 TextMarkedContent 类型\n  constructor(\n    data: IntermediateTextSerialized,\n    protected type: TextMarkedContentType,\n    protected markedContentId: string\n  ) {\n    super(data)\n  }\n}\n","import {\n  IntermediateText,\n  IntermediateTextSerialized\n} from './IntermediateText'\n\nexport interface IntermediatePageSerialized {\n  id: string\n  texts: IntermediateTextSerialized[]\n  width: number\n  height: number\n  number: number\n  // 缩略图，背景图\n  thumbnail: string | undefined\n}\n\n// 定义文本获取函数的返回类型别名\ntype TextsGetterReturnType =\n  | Promise<IntermediateText[] | IntermediateTextSerialized[]>\n  | IntermediateText[]\n  | IntermediateTextSerialized[]\n\nexport class IntermediatePage {\n  public id: string\n  public texts: IntermediateText[]\n  public width: number\n  public height: number\n  public number: number\n  private _thumbnail?: string\n  private _getThumbnailFn?: (scale: number) => Promise<string | undefined>\n  private _getTextsFn?: () => TextsGetterReturnType\n  // 标记文本是否已经完成加载，便于上层做懒加载策略\n  private textsLoaded: boolean\n  static serialize(page: IntermediatePage): IntermediatePageSerialized {\n    return {\n      id: page.id,\n      texts: page.texts.map(IntermediateText.serialize),\n      width: page.width,\n      height: page.height,\n      number: page.number,\n      // 序列化时仅保留已有的静态缩略图（如果存在）\n      thumbnail: page._thumbnail\n    }\n  }\n  static parse(data: IntermediatePageSerialized): IntermediatePage {\n    return new IntermediatePage(data)\n  }\n  constructor({\n    texts,\n    width,\n    height,\n    number,\n    id,\n    thumbnail,\n    getThumbnailFn,\n    getTextsFn\n  }: Omit<IntermediatePageSerialized, 'texts'> & {\n    texts: IntermediateText[] | IntermediateTextSerialized[]\n  } & {\n    getThumbnailFn?: (scale: number) => Promise<string | undefined>\n    getTextsFn?: () => TextsGetterReturnType\n  }) {\n    this.id = id\n    this.texts = (\n      texts as (IntermediateText | IntermediateTextSerialized)[]\n    ).map((t) => (t instanceof IntermediateText ? t : new IntermediateText(t)))\n    this.width = width\n    this.height = height\n    this.number = number\n    this._thumbnail = thumbnail\n    if (getThumbnailFn) this._getThumbnailFn = getThumbnailFn\n    if (getTextsFn) this._getTextsFn = getTextsFn\n    this.textsLoaded = !getTextsFn\n  }\n  // 获取缩略图，按需渲染\n  async getThumbnail(scale = 1): Promise<string | undefined> {\n    if (this._getThumbnailFn) return this._getThumbnailFn(scale)\n    return this._thumbnail\n  }\n  // 获取文本，按需获取\n  async getTexts(): Promise<IntermediateText[]> {\n    if (this._getTextsFn) {\n      const data = await this._getTextsFn()\n      const mapped = (\n        data as (IntermediateText | IntermediateTextSerialized)[]\n      ).map((t) =>\n        t instanceof IntermediateText ? t : new IntermediateText(t)\n      )\n      this.texts = mapped\n      this.textsLoaded = true\n      // 懒加载完成后去掉取数函数，避免重复请求\n      this._getTextsFn = undefined\n    }\n    return this.texts\n  }\n  // 判断文本是否已加载（便于调用方做缓存判断）\n  get hasLoadedTexts(): boolean {\n    return this.textsLoaded\n  }\n  // 提供一个方法以注入按需生成缩略图的函数\n  setGetThumbnail(fn: (scale: number) => Promise<string | undefined>) {\n    this._getThumbnailFn = fn\n  }\n  // 提供一个方法以注入按需获取文本的函数\n  setGetTexts(fn: () => TextsGetterReturnType) {\n    this._getTextsFn = fn\n  }\n}\n","import {\n  IntermediateText,\n  IntermediateTextSerialized\n} from './IntermediateText'\n\nexport enum IntermediateOutlineDestType {\n  TEXT = 'text',\n  PAGE = 'page',\n  POSITION = 'position',\n  URL = 'url'\n}\n\nexport type IntermediateOutlineDest =\n  | IntermediateOutlineDestPage\n  | IntermediateOutlineDestText\n  | IntermediateOutlineDestPosition\n  | IntermediateOutlineDestUrl\n\nexport interface IntermediateOutlineDestUrl {\n  targetType: IntermediateOutlineDestType.URL\n  url: string\n  unsafeUrl: string | undefined\n  newWindow: boolean\n  items?: IntermediateOutlineDest[]\n}\n\nexport interface IntermediateOutlineDestPage {\n  targetType: IntermediateOutlineDestType.PAGE\n  pageId: string\n  items?: IntermediateOutlineDest[]\n}\n\nexport interface IntermediateOutlineDestText {\n  targetType: IntermediateOutlineDestType.TEXT\n  textId: string\n  items?: IntermediateOutlineDest[]\n}\n\nexport interface IntermediateOutlineDestPosition {\n  targetType: IntermediateOutlineDestType.POSITION\n  items?: IntermediateOutlineDest[]\n}\n\nexport interface IntermediateOutlineSerialized extends IntermediateTextSerialized {\n  dest: IntermediateOutlineDest\n}\n\nexport class IntermediateOutline\n  extends IntermediateText\n  implements IntermediateOutlineSerialized\n{\n  public dest: IntermediateOutlineDest\n  static serialize(\n    outline: IntermediateOutline\n  ): IntermediateOutlineSerialized {\n    return {\n      ...IntermediateText.serialize(outline),\n      dest: outline.dest\n    }\n  }\n  static parse(data: IntermediateOutlineSerialized): IntermediateOutline {\n    return new IntermediateOutline(data)\n  }\n  constructor(data: IntermediateOutlineSerialized) {\n    const { dest, ...textData } = data\n    super(textData as IntermediateTextSerialized)\n    this.dest = dest\n  }\n}\n","import {\n  IntermediatePage,\n  IntermediatePageSerialized\n} from './IntermediatePage'\nimport {\n  IntermediateOutline,\n  IntermediateOutlineSerialized\n} from './IntermediateOutline'\nimport { Number2 } from '../math/index'\n\nexport interface IntermediateDocumentSerialized {\n  id: string\n  pages: IntermediatePageSerialized[]\n  title: string\n  // 文档大纲（可选）\n  outline?: IntermediateOutlineSerialized[]\n}\n\ntype PageLoader = () => Promise<IntermediatePage>\n\ninterface IntermediatePageEntry {\n  id: string\n  pageNumber: number\n  size: Number2\n  loader: PageLoader\n  cache?: Promise<IntermediatePage>\n}\n\n// ! 用来懒加载 Pages\nexport class IntermediatePageMap {\n  // ! 以 id、页码分别索引，方便不同场景快速查找\n  private entryById: Map<string, IntermediatePageEntry> = new Map()\n  private entryByPageNumber: Map<number, IntermediatePageEntry> = new Map()\n\n  constructor(entries: IntermediatePageEntry[] = []) {\n    entries.forEach((entry) => this.registerEntry(entry))\n  }\n\n  private registerEntry(entry: IntermediatePageEntry) {\n    this.entryById.set(entry.id, entry)\n    this.entryByPageNumber.set(entry.pageNumber, entry)\n  }\n\n  private async resolve(\n    entry: IntermediatePageEntry\n  ): Promise<IntermediatePage> {\n    if (!entry.cache) entry.cache = entry.loader()\n    return entry.cache\n  }\n\n  // 按页码顺序批量获取，内部并发取数避免串行等待\n  async getPages(): Promise<IntermediatePage[]> {\n    const orderedEntries = this.pageNumbers\n      .map((pageNumber) => this.entryByPageNumber.get(pageNumber))\n      .filter((entry): entry is IntermediatePageEntry => Boolean(entry))\n    return Promise.all(orderedEntries.map((entry) => this.resolve(entry)))\n  }\n\n  // 直接用完整实例覆盖缓存，便于外部更新\n  updatePage(page: IntermediatePage) {\n    // 先清理旧索引，避免相同 id 或页码残留造成脏数据\n    const oldById = this.entryById.get(page.id)\n    if (oldById) {\n      this.entryByPageNumber.delete(oldById.pageNumber)\n      this.entryById.delete(oldById.id)\n    }\n    const oldByNumber = this.entryByPageNumber.get(page.number)\n    if (oldByNumber && oldByNumber.id !== page.id) {\n      this.entryById.delete(oldByNumber.id)\n      this.entryByPageNumber.delete(oldByNumber.pageNumber)\n    }\n    const newPromise = Promise.resolve(page)\n    const entry: IntermediatePageEntry = {\n      id: page.id,\n      pageNumber: page.number,\n      size: { x: page.width, y: page.height },\n      loader: () => newPromise,\n      cache: newPromise\n    }\n    this.registerEntry(entry)\n  }\n\n  get pageCount() {\n    return this.entryByPageNumber.size\n  }\n\n  get pageNumbers(): number[] {\n    return [...this.entryByPageNumber.keys()].sort((a, b) => a - b)\n  }\n\n  // & 从序列化的数据生成类\n  static fromSerialized(pages: IntermediatePageSerialized[]) {\n    const entries: IntermediatePageEntry[] = pages.map((page) => ({\n      id: page.id,\n      pageNumber: page.number,\n      loader: () => Promise.resolve(new IntermediatePage(page)),\n      size: { x: page.width, y: page.height }\n    }))\n    return new IntermediatePageMap(entries)\n  }\n\n  // & 从列表数据生成类\n  static fromInfoList(\n    infoList: {\n      id: string\n      pageNumber: number\n      size: Number2\n      getData: PageLoader\n    }[]\n  ) {\n    const entries: IntermediatePageEntry[] = infoList.map((info) => ({\n      id: info.id,\n      pageNumber: info.pageNumber,\n      size: info.size,\n      loader: info.getData\n    }))\n    return new IntermediatePageMap(entries)\n  }\n\n  // 兼容旧命名（Deprecated），方便平滑过渡\n  static makeBySerializedData(pages: IntermediatePageSerialized[]) {\n    return IntermediatePageMap.fromSerialized(pages)\n  }\n  static makeByInfoList(\n    infoList: {\n      id: string\n      pageNumber: number\n      size: Number2\n      getData: PageLoader\n    }[]\n  ) {\n    return IntermediatePageMap.fromInfoList(infoList)\n  }\n\n  getPageById(id: string) {\n    const entry = this.entryById.get(id)\n    if (!entry) return undefined\n    return this.resolve(entry)\n  }\n\n  getPageByPageNumber(pageNumber: number) {\n    const entry = this.entryByPageNumber.get(pageNumber)\n    if (!entry) return undefined\n    return this.resolve(entry)\n  }\n\n  getPageSizeByPageNumber(pageNumber: number) {\n    return this.entryByPageNumber.get(pageNumber)?.size\n  }\n}\n\nexport class IntermediateDocument {\n  public readonly id: string\n  public title: string\n  public outline?: IntermediateOutline[]\n\n  get pages(): Promise<IntermediatePage[]> {\n    return this.pagesMap.getPages()\n  }\n\n  set pages(pages: IntermediatePage[]) {\n    pages.forEach((page) => {\n      this.pagesMap.updatePage(page)\n    })\n  }\n\n  private pagesMap: IntermediatePageMap\n\n  static async serialize(\n    doc: IntermediateDocument\n  ): Promise<IntermediateDocumentSerialized> {\n    const pages = await doc.pagesMap.getPages()\n    const serializedPages = await Promise.all(\n      pages.map(async (page) => {\n        if (!page.hasLoadedTexts) await page.getTexts()\n        return IntermediatePage.serialize(page)\n      })\n    )\n    return {\n      pages: serializedPages,\n      id: doc.id,\n      title: doc.title,\n      outline: doc.outline?.map(IntermediateOutline.serialize)\n    }\n  }\n\n  static parse(data: IntermediateDocumentSerialized): IntermediateDocument {\n    return new IntermediateDocument({\n      ...data,\n      pagesMap: IntermediatePageMap.fromSerialized(data.pages),\n      outline: data.outline?.map(IntermediateOutline.parse)\n    })\n  }\n\n  constructor({\n    pagesMap,\n    id,\n    title,\n    outline\n  }: Omit<IntermediateDocumentSerialized, 'pages'> & {\n    pagesMap: IntermediatePageMap\n    outline?: IntermediateOutline[]\n  }) {\n    this.pagesMap = pagesMap\n    this.id = id\n    this.title = title\n    this.outline = outline\n  }\n\n  get pageCount() {\n    return this.pagesMap.pageCount\n  }\n\n  get pageNumbers() {\n    return this.pagesMap.pageNumbers\n  }\n\n  async getCover(scale = 0.3) {\n    const firstPagePromise = this.pagesMap.getPageByPageNumber(1)\n    const page = firstPagePromise ? await firstPagePromise : undefined\n    if (!page) return undefined\n    return page.getThumbnail(scale)\n  }\n\n  getPageById(id: string) {\n    return this.pagesMap.getPageById(id)\n  }\n\n  getPageByPageNumber(pageNumber: number) {\n    return this.pagesMap.getPageByPageNumber(pageNumber)\n  }\n\n  getPageSizeByPageNumber(pageNumber: number) {\n    return this.pagesMap.getPageSizeByPageNumber(pageNumber)\n  }\n\n  // 获取文档大纲\n  getOutline() {\n    return this.outline\n  }\n}\n"],"mappings":";AAAA,IAAY,8CAAL;AACL;AACA;AACA;;;AA2CF,IAAa,mBAAb,MAAa,iBAAuD;CAClE,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,OAAO,UAAU,MAAoD;AACnE,SAAO,EACL,GAAG,MACJ;;CAEH,OAAO,MAAM,MAAoD;AAC/D,SAAO,IAAI,iBAAiB,KAAK;;CAEnC,YAAY,EACV,IACA,SACA,UACA,YACA,YACA,QACA,OACA,OACA,QACA,YACA,GACA,GACA,QACA,SACA,UACA,KACA,QACA,MACA,SAC6B;AAC7B,OAAK,KAAK;AACV,OAAK,UAAU;AACf,OAAK,WAAW;AAChB,OAAK,aAAa;AAClB,OAAK,aAAa;AAClB,OAAK,SAAS;AACd,OAAK,QAAQ;AACb,OAAK,QAAQ;AACb,OAAK,SAAS;AACd,OAAK,aAAa;AAClB,OAAK,IAAI;AACT,OAAK,IAAI;AACT,OAAK,SAAS;AACd,OAAK,UAAU;AACf,OAAK,WAAW;AAChB,OAAK,MAAM;AACX,OAAK,SAAS;AACd,OAAK,OAAO;AACZ,OAAK,QAAQ;;;AAIjB,IAAY,0EAAL;AACL;AACA;AACA;;;AAGF,IAAa,gCAAb,cAAmD,iBAAiB;CAElE,YACE,MACA,AAAU,MACV,AAAU,iBACV;AACA,QAAM,KAAK;EAHD;EACA;;;;;;AC3Gd,IAAa,mBAAb,MAAa,iBAAiB;CAC5B,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,AAAQ;CACR,OAAO,UAAU,MAAoD;AACnE,SAAO;GACL,IAAI,KAAK;GACT,OAAO,KAAK,MAAM,IAAI,iBAAiB,UAAU;GACjD,OAAO,KAAK;GACZ,QAAQ,KAAK;GACb,QAAQ,KAAK;GAEb,WAAW,KAAK;GACjB;;CAEH,OAAO,MAAM,MAAoD;AAC/D,SAAO,IAAI,iBAAiB,KAAK;;CAEnC,YAAY,EACV,OACA,OACA,QACA,QACA,IACA,WACA,gBACA,cAMC;AACD,OAAK,KAAK;AACV,OAAK,QACH,MACA,KAAK,MAAO,aAAa,mBAAmB,IAAI,IAAI,iBAAiB,EAAE,CAAE;AAC3E,OAAK,QAAQ;AACb,OAAK,SAAS;AACd,OAAK,SAAS;AACd,OAAK,aAAa;AAClB,MAAI,eAAgB,MAAK,kBAAkB;AAC3C,MAAI,WAAY,MAAK,cAAc;AACnC,OAAK,cAAc,CAAC;;CAGtB,MAAM,aAAa,QAAQ,GAAgC;AACzD,MAAI,KAAK,gBAAiB,QAAO,KAAK,gBAAgB,MAAM;AAC5D,SAAO,KAAK;;CAGd,MAAM,WAAwC;AAC5C,MAAI,KAAK,aAAa;AAOpB,QAAK,SANQ,MAAM,KAAK,aAAa,EAGnC,KAAK,MACL,aAAa,mBAAmB,IAAI,IAAI,iBAAiB,EAAE,CAC5D;AAED,QAAK,cAAc;AAEnB,QAAK,cAAc;;AAErB,SAAO,KAAK;;CAGd,IAAI,iBAA0B;AAC5B,SAAO,KAAK;;CAGd,gBAAgB,IAAoD;AAClE,OAAK,kBAAkB;;CAGzB,YAAY,IAAiC;AAC3C,OAAK,cAAc;;;;;;ACnGvB,IAAY,sFAAL;AACL;AACA;AACA;AACA;;;AAsCF,IAAa,sBAAb,MAAa,4BACH,iBAEV;CACE,AAAO;CACP,OAAO,UACL,SAC+B;AAC/B,SAAO;GACL,GAAG,iBAAiB,UAAU,QAAQ;GACtC,MAAM,QAAQ;GACf;;CAEH,OAAO,MAAM,MAA0D;AACrE,SAAO,IAAI,oBAAoB,KAAK;;CAEtC,YAAY,MAAqC;EAC/C,MAAM,EAAE,MAAM,GAAG,aAAa;AAC9B,QAAM,SAAuC;AAC7C,OAAK,OAAO;;;;;;ACrChB,IAAa,sBAAb,MAAa,oBAAoB;CAE/B,AAAQ,4BAAgD,IAAI,KAAK;CACjE,AAAQ,oCAAwD,IAAI,KAAK;CAEzE,YAAY,UAAmC,EAAE,EAAE;AACjD,UAAQ,SAAS,UAAU,KAAK,cAAc,MAAM,CAAC;;CAGvD,AAAQ,cAAc,OAA8B;AAClD,OAAK,UAAU,IAAI,MAAM,IAAI,MAAM;AACnC,OAAK,kBAAkB,IAAI,MAAM,YAAY,MAAM;;CAGrD,MAAc,QACZ,OAC2B;AAC3B,MAAI,CAAC,MAAM,MAAO,OAAM,QAAQ,MAAM,QAAQ;AAC9C,SAAO,MAAM;;CAIf,MAAM,WAAwC;EAC5C,MAAM,iBAAiB,KAAK,YACzB,KAAK,eAAe,KAAK,kBAAkB,IAAI,WAAW,CAAC,CAC3D,QAAQ,UAA0C,QAAQ,MAAM,CAAC;AACpE,SAAO,QAAQ,IAAI,eAAe,KAAK,UAAU,KAAK,QAAQ,MAAM,CAAC,CAAC;;CAIxE,WAAW,MAAwB;EAEjC,MAAM,UAAU,KAAK,UAAU,IAAI,KAAK,GAAG;AAC3C,MAAI,SAAS;AACX,QAAK,kBAAkB,OAAO,QAAQ,WAAW;AACjD,QAAK,UAAU,OAAO,QAAQ,GAAG;;EAEnC,MAAM,cAAc,KAAK,kBAAkB,IAAI,KAAK,OAAO;AAC3D,MAAI,eAAe,YAAY,OAAO,KAAK,IAAI;AAC7C,QAAK,UAAU,OAAO,YAAY,GAAG;AACrC,QAAK,kBAAkB,OAAO,YAAY,WAAW;;EAEvD,MAAM,aAAa,QAAQ,QAAQ,KAAK;EACxC,MAAM,QAA+B;GACnC,IAAI,KAAK;GACT,YAAY,KAAK;GACjB,MAAM;IAAE,GAAG,KAAK;IAAO,GAAG,KAAK;IAAQ;GACvC,cAAc;GACd,OAAO;GACR;AACD,OAAK,cAAc,MAAM;;CAG3B,IAAI,YAAY;AACd,SAAO,KAAK,kBAAkB;;CAGhC,IAAI,cAAwB;AAC1B,SAAO,CAAC,GAAG,KAAK,kBAAkB,MAAM,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE;;CAIjE,OAAO,eAAe,OAAqC;AAOzD,SAAO,IAAI,oBAN8B,MAAM,KAAK,UAAU;GAC5D,IAAI,KAAK;GACT,YAAY,KAAK;GACjB,cAAc,QAAQ,QAAQ,IAAI,iBAAiB,KAAK,CAAC;GACzD,MAAM;IAAE,GAAG,KAAK;IAAO,GAAG,KAAK;IAAQ;GACxC,EAAE,CACoC;;CAIzC,OAAO,aACL,UAMA;AAOA,SAAO,IAAI,oBAN8B,SAAS,KAAK,UAAU;GAC/D,IAAI,KAAK;GACT,YAAY,KAAK;GACjB,MAAM,KAAK;GACX,QAAQ,KAAK;GACd,EAAE,CACoC;;CAIzC,OAAO,qBAAqB,OAAqC;AAC/D,SAAO,oBAAoB,eAAe,MAAM;;CAElD,OAAO,eACL,UAMA;AACA,SAAO,oBAAoB,aAAa,SAAS;;CAGnD,YAAY,IAAY;EACtB,MAAM,QAAQ,KAAK,UAAU,IAAI,GAAG;AACpC,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,KAAK,QAAQ,MAAM;;CAG5B,oBAAoB,YAAoB;EACtC,MAAM,QAAQ,KAAK,kBAAkB,IAAI,WAAW;AACpD,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,KAAK,QAAQ,MAAM;;CAG5B,wBAAwB,YAAoB;AAC1C,SAAO,KAAK,kBAAkB,IAAI,WAAW,EAAE;;;AAInD,IAAa,uBAAb,MAAa,qBAAqB;CAChC,AAAgB;CAChB,AAAO;CACP,AAAO;CAEP,IAAI,QAAqC;AACvC,SAAO,KAAK,SAAS,UAAU;;CAGjC,IAAI,MAAM,OAA2B;AACnC,QAAM,SAAS,SAAS;AACtB,QAAK,SAAS,WAAW,KAAK;IAC9B;;CAGJ,AAAQ;CAER,aAAa,UACX,KACyC;EACzC,MAAM,QAAQ,MAAM,IAAI,SAAS,UAAU;AAO3C,SAAO;GACL,OAPsB,MAAM,QAAQ,IACpC,MAAM,IAAI,OAAO,SAAS;AACxB,QAAI,CAAC,KAAK,eAAgB,OAAM,KAAK,UAAU;AAC/C,WAAO,iBAAiB,UAAU,KAAK;KACvC,CACH;GAGC,IAAI,IAAI;GACR,OAAO,IAAI;GACX,SAAS,IAAI,SAAS,IAAI,oBAAoB,UAAU;GACzD;;CAGH,OAAO,MAAM,MAA4D;AACvE,SAAO,IAAI,qBAAqB;GAC9B,GAAG;GACH,UAAU,oBAAoB,eAAe,KAAK,MAAM;GACxD,SAAS,KAAK,SAAS,IAAI,oBAAoB,MAAM;GACtD,CAAC;;CAGJ,YAAY,EACV,UACA,IACA,OACA,WAIC;AACD,OAAK,WAAW;AAChB,OAAK,KAAK;AACV,OAAK,QAAQ;AACb,OAAK,UAAU;;CAGjB,IAAI,YAAY;AACd,SAAO,KAAK,SAAS;;CAGvB,IAAI,cAAc;AAChB,SAAO,KAAK,SAAS;;CAGvB,MAAM,SAAS,QAAQ,IAAK;EAC1B,MAAM,mBAAmB,KAAK,SAAS,oBAAoB,EAAE;EAC7D,MAAM,OAAO,mBAAmB,MAAM,mBAAmB;AACzD,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,KAAK,aAAa,MAAM;;CAGjC,YAAY,IAAY;AACtB,SAAO,KAAK,SAAS,YAAY,GAAG;;CAGtC,oBAAoB,YAAoB;AACtC,SAAO,KAAK,SAAS,oBAAoB,WAAW;;CAGtD,wBAAwB,YAAoB;AAC1C,SAAO,KAAK,SAAS,wBAAwB,WAAW;;CAI1D,aAAa;AACX,SAAO,KAAK"}

package/package.json

@@ -1,9 +1,11 @@
 {
   "name": "@hamster-note/types",
-  "version": "0.1.0",
+  "version": "0.5.1",
   "description": "",
   "scripts": {
-    "build:all": "echo no-build",
+    "build:all": "rolldown --config rolldown.config.ts",
+    "prepublishOnly": "yarn build:all",
+    "lint": "echo 'no-lint'",
     "test": "echo 'no-test'"
   },
   "dependencies": {},
@@ -22,14 +24,23 @@
     "globals": "^15.14.0",
     "prettier": "^3.7.4",
     "prettier-config-standard": "^7.0.0",
+    "rolldown": "^1.0.0-beta.58",
+    "rolldown-plugin-dts": "^0.20.0",
     "typescript": "^5.0.2",
     "typescript-eslint": "^8.50.0"
   },
-  "main": "src/index.ts",
-  "module": "src/index.ts",
-  "types": "src/index.ts",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
   "files": [
-    "src"
+    "dist"
   ],
   "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
-}
+}

package/src/HamsterDocument/IntermediateDocument.ts

@@ -1,199 +0,0 @@
-import {
-  IntermediatePage,
-  IntermediatePageSerialized
-} from './IntermediatePage'
-import {
-  IntermediateOutline,
-  IntermediateOutlineSerialized
-} from './IntermediateOutline'
-import { Number2 } from 'src/math'
-
-export interface IntermediateDocumentSerialized {
-  id: string
-  pages: IntermediatePageSerialized[]
-  title: string
-  // 文档大纲（可选）
-  outline?: IntermediateOutlineSerialized[]
-}
-
-type getPage = () => Promise<IntermediatePage>
-
-// ! 用来懒加载 Pages
-export class IntermediatePageMap {
-  // ! 缓存 Promise
-  private cacheMapById: Map<string, ReturnType<getPage>> = new Map()
-  // ! 缓存 Promise
-  private cacheMapByPageNumber: Map<number, ReturnType<getPage>> = new Map()
-  constructor(
-    private mapById: Map<string, getPage>,
-    private mapByPageNumber: Map<number, getPage>,
-    private sizeMapByPageNumber: Map<number, Number2>
-  ) {
-    return
-  }
-  // 按顺序从第一页开始
-  async getPages(): Promise<IntermediatePage[]> {
-    const result: IntermediatePage[] = []
-    for (const pageId of this.mapById.keys()) {
-      // ? 从 this.getPageById 拿是因为会过一遍缓存
-      const getPage = this.getPageById(pageId)
-      if (getPage) {
-        const page = await getPage()
-        result[page.number - 1] = page
-      }
-    }
-    return result
-  }
-  updatePage(page: IntermediatePage) {
-    const newPromise = Promise.resolve(page)
-    const newGetPage = () => newPromise
-    this.cacheMapById.set(page.id, newPromise)
-    this.cacheMapByPageNumber.set(page.number, newPromise)
-    this.mapById.set(page.id, newGetPage)
-    this.mapByPageNumber.set(page.number, newGetPage)
-    this.sizeMapByPageNumber.set(page.number, {
-      x: page.width,
-      y: page.height
-    })
-  }
-  // & 从序列化的数据生成类
-  static makeBySerializedData(pages: IntermediatePageSerialized[]) {
-    const mapById: IntermediatePageMap['mapById'] = new Map()
-    const mapByPageNumber: IntermediatePageMap['mapByPageNumber'] = new Map()
-    const sizeMapByPageNumber: IntermediatePageMap['sizeMapByPageNumber'] =
-      new Map()
-    pages.forEach((page) => {
-      mapById.set(page.id, () => Promise.resolve(new IntermediatePage(page)))
-      mapByPageNumber.set(page.number, () =>
-        Promise.resolve(new IntermediatePage(page))
-      )
-      sizeMapByPageNumber.set(page.number, { x: page.width, y: page.height })
-    })
-    return new IntermediatePageMap(
-      mapById,
-      mapByPageNumber,
-      sizeMapByPageNumber
-    )
-  }
-  // & 从列表数据生成类
-  static makeByInfoList(
-    infoList: {
-      id: string
-      pageNumber: number
-      size: Number2
-      getData: getPage
-    }[]
-  ) {
-    const mapById: IntermediatePageMap['mapById'] = new Map()
-    const mapByPageNumber: IntermediatePageMap['mapByPageNumber'] = new Map()
-    const sizeMapByPageNumber: IntermediatePageMap['sizeMapByPageNumber'] =
-      new Map()
-    infoList.forEach((info) => {
-      mapById.set(info.id, info.getData)
-      mapByPageNumber.set(info.pageNumber, info.getData)
-      sizeMapByPageNumber.set(info.pageNumber, info.size)
-    })
-    return new IntermediatePageMap(
-      mapById,
-      mapByPageNumber,
-      sizeMapByPageNumber
-    )
-  }
-  getPageById(id: string) {
-    const cache = this.cacheMapById.get(id)
-    if (!cache) {
-      const result = this.mapById.get(id)
-      if (result) {
-        const promise = result()
-        this.cacheMapById.set(id, promise)
-        return () => promise
-      }
-    } else {
-      return () => cache
-    }
-    return undefined
-  }
-  getPageByPageNumber(pageNumber: number) {
-    const cache = this.cacheMapByPageNumber.get(pageNumber)
-    if (!cache) {
-      const result = this.mapByPageNumber.get(pageNumber)
-      if (result) {
-        const promise = result()
-        this.cacheMapByPageNumber.set(pageNumber, promise)
-        return () => promise
-      }
-    } else {
-      return () => cache
-    }
-    return undefined
-  }
-  getPageSizeByPageNumber(pageNumber: number) {
-    return this.sizeMapByPageNumber.get(pageNumber)
-  }
-}
-
-export class IntermediateDocument {
-  public id: string
-  public title: string
-  public outline?: IntermediateOutline[]
-  get pages(): Promise<IntermediatePage[]> {
-    // 按顺序从 pagesMap 获取pages
-    return this.pagesMap.getPages()
-  }
-  set pages(pages: IntermediatePage[]) {
-    pages.forEach((page) => {
-      this.pagesMap.updatePage(page)
-    })
-  }
-  private pagesMap: IntermediatePageMap
-  static async serialize(
-    doc: IntermediateDocument
-  ): Promise<IntermediateDocumentSerialized> {
-    const pages = await doc.pages
-    return {
-      pages: pages.map(IntermediatePage.serialize),
-      id: doc.id,
-      title: doc.title,
-      outline: doc.outline?.map(IntermediateOutline.serialize)
-    }
-  }
-  static parse(data: IntermediateDocumentSerialized): IntermediateDocument {
-    return new IntermediateDocument({
-      ...data,
-      pagesMap: IntermediatePageMap.makeBySerializedData(data.pages),
-      outline: data.outline?.map(IntermediateOutline.parse)
-    })
-  }
-  constructor({
-    pagesMap,
-    id,
-    title,
-    outline
-  }: Omit<IntermediateDocumentSerialized, 'pages'> & {
-    pagesMap: IntermediatePageMap
-    outline?: IntermediateOutline[]
-  }) {
-    this.pagesMap = pagesMap
-    this.id = id
-    this.title = title
-    this.outline = outline
-  }
-  async getCover() {
-    const page = await this.pagesMap.getPageByPageNumber(1)?.()
-    if (!page) return undefined
-    return page.getThumbnail(0.3)
-  }
-  getPageById(id: string) {
-    return this.pagesMap.getPageById(id)
-  }
-  getPageByPageNumber(pageNumber: number) {
-    return this.pagesMap.getPageByPageNumber(pageNumber)
-  }
-  getPageSizeByPageNumber(pageNumber: number) {
-    return this.pagesMap.getPageSizeByPageNumber(pageNumber)
-  }
-  // 获取文档大纲
-  getOutline() {
-    return this.outline
-  }
-}

package/src/HamsterDocument/IntermediateOutline.ts

@@ -1,69 +0,0 @@
-import {
-  IntermediateText,
-  IntermediateTextSerialized
-} from './IntermediateText'
-
-export enum IntermediateOutlineDestType {
-  TEXT = 'text',
-  PAGE = 'page',
-  POSITION = 'position',
-  URL = 'url'
-}
-
-export type IntermediateOutlineDest =
-  | IntermediateOutlineDestPage
-  | IntermediateOutlineDestText
-  | IntermediateOutlineDestPosition
-  | IntermediateOutlineDestUrl
-
-export interface IntermediateOutlineDestUrl {
-  targetType: IntermediateOutlineDestType.URL
-  url: string
-  unsafeUrl: string | undefined
-  newWindow: boolean
-  items?: IntermediateOutlineDest[]
-}
-
-export interface IntermediateOutlineDestPage {
-  targetType: IntermediateOutlineDestType.PAGE
-  pageId: string
-  items?: IntermediateOutlineDest[]
-}
-
-export interface IntermediateOutlineDestText {
-  targetType: IntermediateOutlineDestType.TEXT
-  textId: string
-  items?: IntermediateOutlineDest[]
-}
-
-export interface IntermediateOutlineDestPosition {
-  targetType: IntermediateOutlineDestType.POSITION
-  items?: IntermediateOutlineDest[]
-}
-
-export interface IntermediateOutlineSerialized extends IntermediateTextSerialized {
-  dest: IntermediateOutlineDest
-}
-
-export class IntermediateOutline
-  extends IntermediateText
-  implements IntermediateOutlineSerialized
-{
-  public dest: IntermediateOutlineDest
-  static serialize(
-    outline: IntermediateOutline
-  ): IntermediateOutlineSerialized {
-    return {
-      ...IntermediateText.serialize(outline),
-      dest: outline.dest
-    }
-  }
-  static parse(data: IntermediateOutlineSerialized): IntermediateOutline {
-    return new IntermediateOutline(data)
-  }
-  constructor(data: IntermediateOutlineSerialized) {
-    const { dest, ...textData } = data
-    super(textData as IntermediateTextSerialized)
-    this.dest = dest
-  }
-}

package/src/HamsterDocument/IntermediatePage.ts

@@ -1,97 +0,0 @@
-import {
-  IntermediateText,
-  IntermediateTextSerialized
-} from './IntermediateText'
-
-export interface IntermediatePageSerialized {
-  id: string
-  texts: IntermediateTextSerialized[]
-  width: number
-  height: number
-  number: number
-  // 缩略图，背景图
-  thumbnail: string | undefined
-}
-
-// 定义文本获取函数的返回类型别名
-type TextsGetterReturnType =
-  | Promise<IntermediateText[] | IntermediateTextSerialized[]>
-  | IntermediateText[]
-  | IntermediateTextSerialized[]
-
-export class IntermediatePage {
-  public id: string
-  public texts: IntermediateText[]
-  public width: number
-  public height: number
-  public number: number
-  private _thumbnail?: string
-  private _getThumbnailFn?: (scale: number) => Promise<string | undefined>
-  private _getTextsFn?: () => TextsGetterReturnType
-  static serialize(page: IntermediatePage): IntermediatePageSerialized {
-    return {
-      id: page.id,
-      texts: page.texts.map(IntermediateText.serialize),
-      width: page.width,
-      height: page.height,
-      number: page.number,
-      // 序列化时仅保留已有的静态缩略图（如果存在）
-      thumbnail: page._thumbnail
-    }
-  }
-  static parse(data: IntermediatePageSerialized): IntermediatePage {
-    return new IntermediatePage(data)
-  }
-  constructor({
-    texts,
-    width,
-    height,
-    number,
-    id,
-    thumbnail,
-    getThumbnailFn,
-    getTextsFn
-  }: Omit<IntermediatePageSerialized, 'texts'> & {
-    texts: IntermediateText[] | IntermediateTextSerialized[]
-  } & {
-    getThumbnailFn?: (scale: number) => Promise<string | undefined>
-    getTextsFn?: () => TextsGetterReturnType
-  }) {
-    this.id = id
-    this.texts = (
-      texts as (IntermediateText | IntermediateTextSerialized)[]
-    ).map((t) => (t instanceof IntermediateText ? t : new IntermediateText(t)))
-    this.width = width
-    this.height = height
-    this.number = number
-    this._thumbnail = thumbnail
-    if (getThumbnailFn) this._getThumbnailFn = getThumbnailFn
-    if (getTextsFn) this._getTextsFn = getTextsFn
-  }
-  // 获取缩略图，按需渲染
-  async getThumbnail(scale = 1): Promise<string | undefined> {
-    if (this._getThumbnailFn) return this._getThumbnailFn(scale)
-    return this._thumbnail
-  }
-  // 获取文本，按需获取
-  async getTexts(): Promise<IntermediateText[]> {
-    if (this._getTextsFn) {
-      const data = await this._getTextsFn()
-      const mapped = (
-        data as (IntermediateText | IntermediateTextSerialized)[]
-      ).map((t) =>
-        t instanceof IntermediateText ? t : new IntermediateText(t)
-      )
-      this.texts = mapped
-    }
-    return this.texts
-  }
-  // 提供一个方法以注入按需生成缩略图的函数
-  setGetThumbnail(fn: (scale: number) => Promise<string | undefined>) {
-    this._getThumbnailFn = fn
-  }
-  // 提供一个方法以注入按需获取文本的函数
-  setGetTexts(fn: () => TextsGetterReturnType) {
-    this._getTextsFn = fn
-  }
-}

package/src/HamsterDocument/IntermediateText.ts

@@ -1,133 +0,0 @@
-export enum TextDir {
-  TTB = 'ttb',
-  LTR = 'ltr',
-  RTL = 'rtl'
-}
-
-export interface IntermediateTextSerialized {
-  id: string
-  // 文字内容
-  content: string
-  // 字体大小，大于等于 1 的按 px 计算，小于 1 的按 em  计算
-  fontSize: number
-  // 字体，字体具体需要用户下载，这里只定义字体名称
-  fontFamily: string
-  // 字重，默认 500
-  fontWeight: number
-  // 是否斜体
-  italic: boolean
-  // 字体颜色
-  color: string
-  // 整体宽度
-  width: number
-  // 整体高度
-  height: number
-  // 行高
-  lineHeight: number
-  // x 坐标, 大于等于 1 的按 px，小于 1 的按 百分比
-  x: number
-  // y 坐标, 大于等于 1 的按 px，小于 1 的按 百分比
-  y: number
-  // 字体 baseline
-  ascent: number
-  // 字体 descent
-  descent: number
-  // 垂直文字
-  vertical?: boolean
-  // 文字方向
-  dir: TextDir
-  // 旋转
-  rotate: number
-  // 倾斜
-  skew: number
-  // 是否是行末
-  isEOL: boolean
-}
-
-export class IntermediateText implements IntermediateTextSerialized {
-  public id: string
-  public content: string
-  public fontSize: number
-  public fontFamily: string
-  public fontWeight: number
-  public italic: boolean
-  public color: string
-  public width: number
-  public height: number
-  public lineHeight: number
-  public x: number
-  public y: number
-  public ascent: number
-  public descent: number
-  public vertical?: boolean
-  public dir: TextDir
-  public rotate: number
-  public skew: number
-  public isEOL: boolean
-  static serialize(text: IntermediateText): IntermediateTextSerialized {
-    return {
-      ...text
-    }
-  }
-  static parse(data: IntermediateTextSerialized): IntermediateText {
-    return new IntermediateText(data)
-  }
-  constructor({
-    id,
-    content,
-    fontSize,
-    fontFamily,
-    fontWeight,
-    italic,
-    color,
-    width,
-    height,
-    lineHeight,
-    x,
-    y,
-    ascent,
-    descent,
-    vertical,
-    dir,
-    rotate,
-    skew,
-    isEOL
-  }: IntermediateTextSerialized) {
-    this.id = id
-    this.content = content
-    this.fontSize = fontSize
-    this.fontFamily = fontFamily
-    this.fontWeight = fontWeight
-    this.italic = italic
-    this.color = color
-    this.width = width
-    this.height = height
-    this.lineHeight = lineHeight
-    this.x = x
-    this.y = y
-    this.ascent = ascent
-    this.descent = descent
-    this.vertical = vertical
-    this.dir = dir
-    this.rotate = rotate
-    this.skew = skew
-    this.isEOL = isEOL
-  }
-}
-
-export enum TextMarkedContentType {
-  BEGIN_MARKED_CONTENT = 'beginMarkedContent',
-  BEGIN_MARKED_CONTENT_PROPS = 'beginMarkedContentProps',
-  END_MARKED_CONTENT = 'endMarkedContent'
-}
-
-export class IntermediateTextMarkedContent extends IntermediateText {
-  // 这两个值参见 pdfjs 的 TextMarkedContent 类型
-  constructor(
-    data: IntermediateTextSerialized,
-    protected type: TextMarkedContentType,
-    protected markedContentId: string
-  ) {
-    super(data)
-  }
-}

package/src/HamsterDocument/index.ts

@@ -1,4 +0,0 @@
-export * from './IntermediateDocument'
-export * from './IntermediatePage'
-export * from './IntermediateText'
-export * from './IntermediateOutline'

package/src/api/main/dto/.cursor/rules/base-rules.mdc

@@ -1,8 +0,0 @@
----
-globs: common/api/main/dto/*.ts
-alwaysApply: false
----
-1. 当前文件夹是用来放置接口传参类型的
-2. 这个文件夹前后端都会引用，在创作时要同时兼容浏览器和 NodeJs
-3. 所有字段必须有中文注释
-4. 在编辑这个文件夹里面的文件时，要注意对应的后端是 NestJs，如果是在 NestJs 中嵌入时，要注意对应格式符合 NestJs 要求

package/src/api/main/dto/batch-delete.dto.ts

@@ -1,3 +0,0 @@
-export interface BatchUpdateDto {
-  uuids: string[]
-}

package/src/api/main/dto/create-folder.dto.ts

@@ -1,17 +0,0 @@
-export interface CreateFolderDto {
-  name: string
-
-  // 父文件夹 uuid，可选；不传表示顶层
-  parentUuid?: string
-
-  // 预留：标签与颜色
-  tags?: string
-
-  color?: string
-
-  // 排序方式 JSON（预留）
-  sortOptions?: Record<string, object>
-
-  // 排序权重（默认 0）
-  order?: number
-}

package/src/api/main/dto/create-user.dto.ts

@@ -1,18 +0,0 @@
-export interface CreateUserDto {
-  // 用户名：仅展示用途，可选，可重复
-  username?: string
-
-  password: string
-
-  // 手机号：非必填
-  phone?: string
-
-  email: string
-
-  // 邮箱验证码（注册必填）
-  emailCode: string
-
-  avatar?: string
-
-  wechatId?: string
-}

package/src/api/main/dto/init-upload.dto.ts

@@ -1,5 +0,0 @@
-export interface InitUploadDto {
-  originalFilename: string
-
-  size: number // bytes, max 1GB
-}

package/src/api/main/dto/list-files.dto.ts

@@ -1,14 +0,0 @@
-export type UploadStatus = 'uploading' | 'completed' | 'failed'
-
-export interface ListFilesQueryDto {
-  // 父级文件夹 uuid；不传表示不按层级过滤，传空/"null"/空字符串表示顶层
-  parentUuid?: string
-
-  // 过滤上传状态（uploading/completed/failed）
-  status?: UploadStatus
-
-  // 分页参数
-  page?: number
-
-  pageSize?: number
-}

package/src/api/main/dto/update-folder.dto.ts

@@ -1,14 +0,0 @@
-export interface UpdateFolderDto {
-  name?: string
-
-  tags?: string
-
-  color?: string
-
-  sortOptions?: Record<string, object> | null
-
-  order?: number
-
-  // 允许移动到另一个父级
-  parentUuid?: string | null
-}

package/src/index.ts

@@ -1,2 +0,0 @@
-export * from './math'
-export * from './HamsterDocument'

package/src/math/Number2.ts

@@ -1 +0,0 @@
-export type Number2 = { x: number; y: number }

package/src/math/index.ts

@@ -1 +0,0 @@
-export * from './Number2'