♻️ Cursorの型定義を厳密にした

Author: takker99

browser/dom/cursor.d.ts

@@ -2,8 +2,9 @@
 /// <reference lib="esnext"/>
 /// <reference lib="dom" />
 
-import { BaseStore } from "../../deps/scrapbox.ts";
+import { BaseLine, BaseStore } from "../../deps/scrapbox.ts";
 import { Position } from "./position.ts";
+import { Page } from "./page.d.ts";
 
 export interface SetPositionOptions {
   /** カーソルが画面外に移動したとき、カーソルが見える位置までページをスクロールするかどうか
@@ -25,6 +26,8 @@ export declare class Cursor extends BaseStore<
 > {
   constructor();
 
+  public startedWithTouch: boolean;
+
   /** カーソルの位置を初期化し、editorからカーソルを外す */
   clear(): void;
 
@@ -52,6 +55,12 @@ export declare class Cursor extends BaseStore<
    */
   focus(): void;
 
+  /** #text-inputにfocusがあたっているか返す
+   *
+   * `this.focusTextarea`と同値
+   */
+  get hasFocus(): boolean;
+
   /** #text-inputからfocusを外す。カーソルの表示状態は変えない */
   blur(): void;
 
@@ -113,11 +122,11 @@ export declare class Cursor extends BaseStore<
       | "go-pageup",
   ): void;
 
-  /* `scrapbox.Page.lines`とほぼ同じ */
-  get lines(): unknown[];
+  /** 現在のページ本文を取得する */
+  get lines(): BaseLine[];
 
-  /* `scrapbox.Project.pages`とほぼ同じ */
-  get pages(): unknown;
+  /** 現在のページデータを取得する */
+  get page(): Page;
 
   private goUp(): void;
   private goPageUp(): void;

browser/dom/page.d.ts

@@ -0,0 +1,69 @@
+/// <reference no-default-lib="true"/>
+/// <reference lib="esnext"/>
+/// <reference lib="dom" />
+
+import { BaseStore } from "../../deps/scrapbox.ts";
+import { Page as PageData } from "../../deps/scrapbox-rest.ts";
+
+export interface SetPositionOptions {
+  /** カーソルが画面外に移動したとき、カーソルが見える位置までページをスクロールするかどうか
+   *
+   * @default true
+   */
+  scrollInView?: boolean;
+
+  /** カーソル移動イベントの発生箇所？
+   *
+   * コード内だと、"mouse"が指定されていた場合があった。詳細は不明
+   */
+  source?: "mouse";
+}
+
+export interface ApiUrlForFetch {
+  projectName: string;
+  title: string;
+  titleHint: string;
+  followRename: boolean;
+  search: string;
+}
+
+export interface ApplySnapshotInit {
+  page: Pick<PageData, "title" | "lines" | "created">;
+  prevPage?: Pick<PageData, "created">;
+  nextPage?: Pick<PageData, "lines">;
+}
+
+export type PageWithCache = PageData & { cachedAt: number | undefined };
+
+/** Scrapboxのページデータを管理する内部クラス
+ *
+ * 一部型定義は書きかけ
+ */
+export declare class Page extends BaseStore<
+  { source: "mouse" | undefined } | "focusTextInput" | "scroll" | undefined
+> {
+  public initialize(): void;
+
+  private data: PageWithCache;
+
+  public get(): PageWithCache;
+
+  public apiUrlForFetch(init: ApiUrlForFetch): string;
+  public apiUrlForUpdatePageAccessed(pageId: string): string;
+  public fetch(): Promise<PageWithCache>;
+
+  public set(page: PageWithCache): void;
+  public reset(): void;
+  public applySnapshot(init: ApplySnapshotInit): void;
+  setTitle(title: string, init?: { from: string }): void;
+  get fromCacheStorage(): boolean;
+  public setPin(pin: number): void;
+  public delete(): void;
+  public patch(t: unknown): void;
+  public patchChanges(
+    t: unknown,
+    init?: { from: string },
+  ): Promise<unknown>;
+  get hasSelfBackLink(): boolean;
+  public requestFetchApiCacheToServiceWorker(): unknown;
+}