@kubohiroya/turbowarp-plus-editor-project-folder 0.14.0 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ja.md CHANGED
@@ -60,6 +60,20 @@ TurboWarp Plus Editor は、ブロックパレットの設定を画面状態(`
60
60
 
61
61
  読み取り専用です。ファイルの作成・削除・名前の変更はできません。文字入力による検索もありません。
62
62
 
63
+ ## ファイルの編集
64
+
65
+ 作品フォルダのテキストファイルは既存の作業タブで開き、その場で直接編集できます([Editor #532](https://github.com/kubohiroya/turbowarp-plus-editor/issues/532)、[表示と外部編集の改善 #673](https://github.com/kubohiroya/turbowarp-plus-editor/issues/673))。ファイル名はタブに表示し、本文上の重複するファイル名の行は表示しません。「通常表示/差分表示」は、選択中の状態が分かるカプセル型の切り替えです。矢印キーでも切り替えられます。「ファイルを保存」「VSCodeで編集」にはアイコンを付け、切り替えとともに右上に重ねて表示します。保存は、このタブのファイルに未保存の変更がある場合だけ有効です。未保存の通知・エラーは左下に表示し、編集領域の高さを減らしません。保存が成功すると「保存しました」のスナックバーを4秒間表示します。
66
+
67
+ ローカル連携から Editor を開くと、既存の文書エディターの補助プロセスを利用して「VSCodeで編集」を使えます。編集中の内容を作業コピーとして渡すため、実フォルダと OPFS のどちらでも同じ操作になります。外部編集中はこのタブの通常表示・差分表示・ミニマップ・すべての操作ボタンを無効にします。VSCode で保存した後、覆い表示の「終了して取り込む」で編集結果をタブに取り込み、「ファイルを保存」で元の保存先へ書き込みます。「取り込まずに終了」では外部編集の開始前のタブの内容を保持します。作業コピーは補助プロセスに保持されます。ローカル連携がない環境では外部編集ボタンは無効です。JSON・YAML は既存の補助プロセスで利用でき、それ以外のテキストには `config.formats` に `text` を返す版が必要です。
68
+
69
+ この OPFS 対応は、ローカル連携の URL から開いた Editor の保存領域が対象です。通常の配信サイトとローカル連携では OPFS の保存領域が異なるため、配信サイトで既に作業している OPFS を直接共有しません。通常の配信サイトを開いたまま外部編集するための別オリジン接続は、この実装には含みません。
70
+
71
+ 編集画面の右下には、ファイル全体と現在の表示範囲を示すミニマップを表示します。クリック・ドラッグで移動でき、ミニマップにフォーカスすると矢印・Page Up/Page Down・Home/End キーでもスクロールできます。編集、スクロール、パネルのサイズ変更、タブの再表示に追従します。差分表示では編集用のミニマップを隠します。
72
+
73
+ 切り戻す場合はこの UI 変更を revert し、パッケージと Editor を再ビルドします。ファイル形式の変更やデータ移行はありません。対象のヘッドレス検証は `node --test test/text-file.browser.js` で実行します。
74
+
75
+ 実際の補助プロセスと OPFS を使う結合検証は、`TWPF_COMPANION_HOST` に文書エディターの `node/host.ts` の絶対パスを指定して同じコマンドを実行します。VSCode の起動はテスト用の関数に差し替え、OS の画面を表示せず、JSON と Markdown の作業コピーの読み書き・タブの無効化・取り込み・OPFS への保存を確認します。
76
+
63
77
  ## 外部変更
64
78
 
65
79
  ホストが `host.blockReload` を渡すと、表示中は 2 秒ごと、ウィンドウにフォーカスが戻ったとき、ブラウザーが対応していれば `FileSystemObserver` の通知で、開いているフォルダを確認します。Editor の外でフォルダが変わると通知を表示します。
package/dist/explorer.js CHANGED
@@ -1463,7 +1463,7 @@ function createFilePreview(directory, documentId, { name, path }, locale, readBa
1463
1463
  status.textContent = message.large;
1464
1464
  return;
1465
1465
  }
1466
- const [bytes, { decodeText, mountTextFile }] = await Promise.all([file.arrayBuffer(), import("./shared-BYk-uDpM.js")]);
1466
+ const [bytes, { decodeText, mountTextFile }] = await Promise.all([file.arrayBuffer(), import("./shared-BlgxbepC.js")]);
1467
1467
  if (disposed) return;
1468
1468
  const content = decodeText(bytes);
1469
1469
  if (content === null) {
@@ -0,0 +1,7 @@
1
+ export declare function connectExternalFileEditor(browser: Window, filename: string, extension: string, limit: number): Promise<{
2
+ readonly active: boolean;
3
+ open(source: string): Promise<void>;
4
+ read(): Promise<string>;
5
+ end: () => void;
6
+ close(): void;
7
+ } | null>;