UNFOLD

UNFOLD のソースには、非公開の本体リポジトリ（作業用）と、それを写した公開用リポジトリがあります。文書や記録に出てくるコミット番号（780034d など）は本体の番号で、公開用リポジトリでは番号が違います（docs/公開用リポジトリへの反映.md）。

ライセンス：MIT（LICENSE）。改変や、ほかのアプリへの組み込みも自由ですが、無保証です。app/vendor/ の同梱ライブラリとフォント（three.js・troika・GSAP・Rapier・p5.js・Mediabunny・各書体など）と、それらを束ねた app/vendor/*-worker.js は、それぞれのライセンス（同じフォルダの *-LICENSE.txt・*-NOTICE.txt）に従います。

現在の公開版：STUDIO（2026-10-10）

STUDIOを開く。曲・歌詞を固定した共通時間軸に、画像・短動画・文字・p5演出・UNFOLDを重ね、横MVと別配置の縦ショートを作れます。旧シーケンスの「05 STUDIO」からも入れます。

公開ソース 0bc28e5。本番407配信ファイル一致、保存往復・曲歌詞ロック・横縦の実H.264/AAC出力・旧工房8連携を確認済み。使い方 / 検証・公開・復旧記録。GitHub pushなし。

2026-10-17（続き）：カット割りの軸の名前（公開済み・8751dcc、公開記録）

• 軸の名前を IN・STAY・OUT・STYLE・DECO・BG・CAM・FX・TRANS・STAGE に（STUDIO の画面にも。日本語を小さく添える）。参考にしたツールの名前は、コードと文書から外した。

2026-10-17（続き）：カット割りの部品20個と「装飾」の軸（公開済み・a2cfe86、公開記録）

• STUDIO のカット割りに、少ない軸の部品20個と、新しい軸「装飾」（手描きの丸囲み・キラキラ・矢印・効果線…12種、app/studio/cuts/decos.js）。設定に「装飾」。毎日のルーティンでも装飾を足せる。

2026-10-17（続き）：書き出しで画像メソッドの絵が固まる不具合（公開済み・5d72de8、公開記録）

• 画像メソッドの層は、絵の大きさが変わると GPU のテクスチャを作り直す（image-method-layer.js）。これまでは画面で再生したあとに大きく書き出すと、画像メソッドの区間が最後に見ていた絵のまま固まっていた。

2026-10-17（続き）：画像メソッドの「表示する文字」（公開済み・6627798、公開記録）

• 文字が出る画像メソッド（爆砕と再誕など、コードが params.label を使うもの）に「表示する文字」欄。工房（物理の設定の並び）、1枚モード（02 の崩れ方の一覧の下）、シーケンス（◆の設定、tr.label）。空なら、メソッドの元の文字（UNFOLD など）。欄は、そのメソッドが文字を使うときだけ出ます（app/image-label.js の usesImageLabel）。
• 描画側は、使う場所ごとの設定（input.params）を、メソッドの設定の上に重ねます（image-method-layer.js）。保存したメソッドは書き換えません。

2026-10-17（続き）：GLBのテクスチャをそのまま貼る・なめらかな陰影（公開済み・3c6be08、公開記録）

• GLBのベースカラーテクスチャを、シェーダーがUVで直接読むように（これまでは頂点ごとの色に置き換えていたので、面の少ないモデルでは模様がにじんでいた）。テクスチャが1枚ならそのまま（最大4096px、GLBの繰り返し設定どおり）、複数枚なら1枚の画像（4096px）に並べてUVを移します。頂点ごとには基本色×頂点カラーだけを持ちます（model-import.js の modelPaint・splitExtras、motion.js の uModelTex・modelUv）。
• GLBのなめらかな法線で陰影をつけます（立体にまとまるにつれて、三角形ごとのカクカクした陰影から切り替わる。modelNormal・modelNormalAt）。
• model-layout.js は、追加の値（色・UV・法線）を opts.extras で運ぶ形に。三角形を配列の配列ではなく平らな配列で持つので、100万面でも速く（約3倍）軽くなりました。拡張なしの結果は前と完全に同じです（model-layout-ordered.test.mjs）。
• まだ使っていないもの：ツヤ・金属っぽさ・スペキュラ・法線マップ・発光・AO・透明度。

2026-10-17（続き）：1枚モードにも「ぐちゃぐちゃの長さ」（公開済み・58968a7、公開記録）

• 1枚モードの「02 ぐちゃぐちゃにする」に「ぐちゃぐちゃの長さ」スライダー（シーケンスと同じ考え方、motion.js の motionAt(t, hold)・warpTime・chaosTime）。立体化の始まりが、0%で今までどおり（変化の32%）、100%で66%まで後ろへ。電撃で消失・焦げ穴と炎などの表面の効果（変化の約64%まで進む）が、最後まで進んでから立体になります。初期値は50%（立体化は約40%から）。チャプターのボタン・書き出しの「ぐちゃぐちゃから」「立体化から」も、この設定に合わせた位置になります。
• 画像メソッドの描画器（vendor/image-method-worker.js、約5MB）の読み込み：通信エラー（Failed to fetch）なら2回まで自動で読み直し、それでもだめなら「通信エラー」と分かる言葉で知らせます（image-method-runtime.js）。

2026-10-17：GLBを100 MBまで、テクスチャの色も取り込み、色つきの標準の形（公開済み・009e487、公開記録）

• GLBの上限を50 MB → 100 MB（1枚モード・シーケンス・GLB置き場）。三角形100万枚までは変わりません。
• GLBの色を取り込む：基本色（baseColorFactor）×ベースカラーテクスチャ×頂点カラーを、角（頂点）ごとの色として読みます（app/model-import.js の modelPaint、importModel(buf,{colors:true})）。テクスチャはGLBに埋め込まれた画像だけを読み、外部URLは今までどおり読みません。色は頂点ごとなので、面の少ないモデルではテクスチャの細かい模様はぼけます。KTX2（basisu）だけのテクスチャは読めず、基本色だけになります。
• 「GLBの色（写真と混ぜる）」スライダー：1枚モードは「粒の細かさ」の下、シーケンスは見た目の設定（seq.modelColor、保存されます）。立体になるにつれて写真とGLBの色を混ぜます（平らな写真は染めない）。新しい作品は100%、この設定を保存していない前の作品は0%（写真だけ）で開きます。色のないGLB・組み込みの形・立体文字には効きません。
• 色つきの標準の形 17種（1枚モードの「03 立体にする」の形ボタン、シーケンスの形メニュー、STUDIO）：カラー見本・スイカ・ドーナツ・土星・アイス・雪だるま・太陽系・積み木・星くず・ルービック・風船・宝石・DNA・マカロン・ドミノ・紙吹雪・ハート吹雪。名前と記号がその形の色で表示されます（青枠なし）。一覧と読み込みは app/colour-shapes.js（id は c-…、GLB は app/assets/models/、最初に選んだときに読む）。GLBは tools/make_colour_samples.py（カラー見本だけ tools/make_colour_sample_glb.py）で作り直せます。使わなかった案（地球・きのこ・桜吹雪・シャボン玉・星空）も同じスクリプトにあります。
• 画面いっぱいのGLB：GLBの asset.extras.unfold.fit = "frame" があると、いつもの大きさ（長い辺3.5）ではなく16:9の画面（5.25×2.95）に合わせます（model-import.js の fitFrame）。紙吹雪・ハート吹雪はこれで、立体化中の引きもかけません（fillsFrame）。
• しくみ：model-layout.js が分割しても色を運び color（rgba、a=2が「色あり」）を返す → modelColor 属性 → motion.js で uModelColor 分だけ混ぜる。

2026-10-15：シーケンスの操作まわり（拡大・移動／見た目の変形／GLB追加欄）

• タイムラインに「拡大」「移動」スライダー（シーケンス）：STUDIOのタイムラインと同じ2本。拡大は「全体」を×1として×8まで、移動は横スクロール位置（拡大しているときだけ動かせます）。「－」「＋」「全体」ボタンやスクロールとも連動します。
• 04 見た目の一番下に「変形」パネル：再生位置にある◆（変形）の「崩れ方・戻り方・立体化する・形（GLBのタブと絞り込み付き）・向き・長さ・演出」を、見た目タブのままで変えられます（「03 選択中」で◆を選んだときと同じ内容）。ぐちゃぐちゃ／立体化の区間で出ます。止まっている画像の上では、「すべて」にしたときだけ◆の設定が出ます。
• 「追加した立体の形（GLB）」を、動画保存タブへ移動し、タブ名を「動画保存・GLB追加」に変更。GLBの追加・グループ分け・削除はそこで行い、選ぶのは見た目タブ（または選択中タブ）の変形パネルの「形」です。

2026-10-15：シーケンスの「ぐちゃぐちゃの長さ」

• 04 見た目に「ぐちゃぐちゃの長さ」スライダーを追加（シーケンス）：立体化が始まるまでの、ぐちゃぐちゃの時間を長くします。これまでは、崩れの途中（崩れの強さが最大になる前）で立体化が始まっていました。右に動かすほど、崩れきってから立体になります。変化全体の長さ（拍数）は変わらず、立体の部分（立体化・絵の入れ替わり・回転・戻り）が後ろに寄ります。
• 50%を超えると、立体化の始まりをさらに後ろへ（100%で変化の65%あたりから）。焦げ穴と炎のように、画面全体を燃やしきるのに時間がかかる崩れも、燃えきってから立体になります。
• 新しいシーケンスの初期値は 50%。0% は今までと同じ動き。この設定を保存していない前の作品は、これまでの動き（0%）のまま開きます。書き出した動画にも反映されます。立体化なし（通り抜け・吹き飛ばし・行って戻る）には関係しません。

2026-10-14（続き）：言葉の大きさボタン、カラフルなサンプル画像、保存した動きもおまかせへ

• 「選んだ言葉の大きさ」ボタン（STUDIO、歌詞を選んで「色」タブ）：言葉を選んで「大きく」「小さく」（押すたびに1.25倍・0.8倍、0.4〜2.5倍の範囲）「ふつう」。色や縁取りを変えても大きさは残ります。
• おまかせの候補が広がりました：雰囲気ごとの動きに加えて、あとから足された標準の文字モーション（雰囲気に入っていないもの）と、「モーション集」で保存した動き（コードでも一文字ずつ等でも。エフェクトは除く）も使います。「保存した動き・新しい動きも使う」で切れます。保存した動きのコードは、STUDIOがまだ実行を許可していないものがあれば、おまかせで使う前に一度だけ確認します（「キャンセル」なら使わず、勝手に許可はしません）。保存した動きの大きさは測っていないので、位置は控えめに（真ん中寄りに）なります。
• シーケンスの最初のサンプル画像（ONE〜FOUR）を、単色の格子から、夕焼け・タータンチェック・海と魚・ポップな図形のカラフルな絵に差し替えました（毎回同じ絵）。

2026-10-14 の追加：おまかせの配置と語の大小、装飾つき文字モーション16種、画像系の標準メソッド18種

• おまかせが、文字を真ん中だけに置かなくなりました（STUDIO、右の「おまかせ」）：歌詞1行ごとに、左上・右下・上・下・端などへ置き、少し傾け、短い行は横向きにも。置いても画面の外へ出ないよう、動きごとに実測した大きさ（app/studio/omakase-extents.js）で収めます。「文字の配置」で「真ん中に揃える」に戻せ、「ここだけ変える」に「配置・大小」を足しました。
• 語ごとの大きさ：「私」大きい「は」小さい「元気」大きい「です」小さい、のように内容語を大きく、助詞を小さく（Intl.Segmenter で語に分け、平均の大きさは変えないので行の幅は同じ）。run の scale として保存され、色・縁取り・中抜きを変えても残ります。文字モーション側は語ごとのメッシュ（textStart）にもそのまま効きます（コードモーションの描画器を作り直し、?v=7）。
• 文字モーション16種：切り貼り文字の系統（装飾が付く）＝付箋に書く・ラベルライターで打つ・スタンプでドン・蛍光ペンで線を引く・チケットの半券・ぺたっと貼るステッカー・ぽこぽこ膨らむ吹き出し・手描きの丸囲みと下線・黒板にチョークで書く・くるっと回るワッペン。配置の系統＝縦書きが右から並ぶ・左上から階段に並ぶ語・四隅に語を置く・縦と横が交差する・大小が拍で跳ねる・斜めに流れる行。どれもおまかせの雰囲気に入っています（配置の6種は自分で位置と大小を決めるので、おまかせは動かしません）。
• 画像系の標準メソッド18種（63 METHODS）：タイルが落ちて跳ねる・爆発して元へ戻る・画像片と文字がぶつかる・渦に巻かれるタイル・爆砕と再誕・波紋で傾くタイル・ドミノのように倒れる・とろけて垂れるタイル、金継ぎ陶片・水滴レンズ・織り写真・銀箔うねり、立体ポップ・砂になって落ちる・ストライプスライド・斜めに掃き飛ばす・カーテンが開く・針のように掃く。1枚モードとシーケンスの最初から選べます（工房で「追加」する必要はありません）。

2026-10-12 の追加：切り貼り文字と表面の崩れ方8種（本体の標準）

• 切り貼り文字（文字モーション3種：ゆっくり／ふつう／連打）：1文字ごとに書体・紙の色・大きさ・傾きが違う切り抜き文字を、拍に合わせて1文字ずつ貼っていき、貼るたびに画面が拍で揺れます。貼る速さは「ゆっくり／ふつう／連打」の3種と、歌詞の「動きの速さ」スライダーで変えられます。書体は同梱の6書体から、その字を持っているものだけが使われます。モーションのコードの先頭に // @fonts と書くと、api.fonts / api.fontsFor(文字) が使えます（app/code-motion-runtime.js）。
• 焦げ穴と炎・インクのにじみ・水彩の溶け出し・凍結と霜・電撃で消失・酸の侵食・絵の具の滴り・紙が風化する：メソッド工房のサンプルだった画像コードの8種が、1枚モードとシーケンスのメソッド一覧に最初から入るようになりました（app/bundled-image-methods.js。保存はされず、使うとプロジェクトにコードが入ります）。

以前の公開：工房11作品と取り込み改善（2026-10-10）

メソッド工房 に画像4作品・文字7作品を追加。カードと既知の .js から名前・種類・設定が入り、共有ファイルでも設定を復元できます。工房から表面作品を適用すると、1枚モード・シーケンスとも「立体化なし」を引き継ぎます。保存済みカードの編集中の内容を保護し、文字5作品の日本語折り返しも改善しました。

公開ソース dca149d。365配信ファイルの一致、11カード、画像4作品×両モード、文字7作品の長文・部分色・逆シーク・MV適用を確認済み。使い方とローカル検証 / 公開・復旧記録。GitHubへのpushなし。

以前の公開：画像の質感エフェクト8種（2026-10-06）

メソッド工房 に、焦げ穴と炎、インク、水彩、霜、電撃、酸、絵の具、風化を追加して公開しました。従来のJavaScriptサンプルでも選べます。実描画の見本から選択し、コード編集・共有ができます。使い方と検証。1枚モードは「立体化する」をオフ、シーケンスは「形にしない」で使用します。

302配信ファイルの一致と、8種類×両モードの16通りを公開URLで確認済み。公開・復旧記録。

前の公開：メソッド工房（2026-10-06）

メソッド工房 を公開しました。GLSL・画像JavaScript／物理・文字JavaScriptのブロック選択、実動プレビュー、コード編集、参照画像・配色、下書き復元、UNFOLD本体への追加に対応。変更前のメソッドは残し、既存作品の別ブロックを書き換えません。公開ソース 4ac4af5、全292配信ファイルの一致と3方式・保存・本体連携・390px表示を確認済み。個人の画像・曲・下書きは非公開です。使い方 / 公開・復旧記録。GitHubへのpushなし。

前の公開：JavaScriptメソッドの立体化（2026-10-05）

JavaScript＋物理演算でも、画像片が選んだ立体・GLBへ集まって画像に戻れるように拡張。1枚モードは「03 立体」、シーケンスは◆変形の「立体化する」で選択します。コードエディタにも立体プレビューを追加。操作と対応範囲は 画像コードメソッド、確認結果は 立体化の検証記録。https://unfold.saisuiwa.com/ へ公開済み。配信285ファイルと公開画面での両モードの動作を確認しました。公開記録。

前の公開：JavaScript・物理演算の初期版（2026-10-05）

https://unfold.saisuiwa.com/ に 864801b を公開済み。画像メソッドのJavaScript＋物理演算（Three.js／Troika Text／GSAP／Rapier）を含みます。配信282ファイルの一致と公開サイトでの動作を確認しました。公開物・バージョン・検証証跡は 公開記録。以下の古い更新記録にある「未公開」は、その記録時点の状態です。

現在のアプリ本体、公開用ZIP、デモ動画、読み込んで使うGLB、以前の版と作業記録をこのフォルダにまとめています。

• app/ — 現在の公開版（Cloudflare、2026-10-06・質感エフェクト8種入り）のソース。index.html が1枚モード、sequence.html がシーケンスです。
• releases/UNFOLD-Test-custom-methods-glb-2026-10-04.zip — 旧Netlify版の最後のZIP（2026-10-04。Netlifyはもう使っていません）。自作メソッド・画像ごとのカメラ・新しい形（龍・クジラ…）・位置どおり貼るGLB・GLB100個まで、など2026-10-02〜04の更新が全部入り。公開前の確認結果は docs/公開前チェックリスト_自作メソッド.md の §7。
• releases/UNFOLD-Test-glb-dashboard-mp4-2026-09-30.zip — 1つ前の公開版（2026-09-30 22:07）。戻すときはこれ（Netlifyの Deploys 一覧から前のデプロイを選んで Publish deploy でもOK）。引きスライダー・追加した形のダッシュボード・粒の細かさ・MP4書き出し入り。
• releases/UNFOLD-Test-effects-camera-2026-09-29.zip — 1つ前の公開版（2026-09-29 22:24）。演出・カメラ入り。
• releases/UNFOLD-Test-particles-timeline-2026-09-29.zip — 以前の公開版（2026-09-29 21:28）。崩れ方29種・タイムライン編集・3カラムのシーケンス・保存機能入り。
• releases/UNFOLD-Test-confetti-glitch-2026-09-28.zip — 1つ前の公開版ZIP。星とハートのメソッド（1枚・シーケンス）と、色収差・グリッチ演出（1枚モード）を追加した版です。
• releases/UNFOLD-Test-stronger-push-2026-09-28.zip — 以前のGLB 100万面・プッシュイン約2.1倍版ZIP。
• releases/UNFOLD-Test-million-GLB-2026-09-28.zip — 以前のGLB 100万面・色差シルエット説明版ZIP。
• releases/UNFOLD-Test-three-column-2026-09-28.zip — 以前の3カラム版ZIP。
• releases/UNFOLD-Test-model-library-2026-09-28.zip — 以前のGLB保存・シーケンス共有版ZIP。
• releases/unfold_seq_deploy.zip — 以前のシーケンス版ZIP。
• releases/UNFOLD-Test-update.zip — 以前のNetlify更新用ZIP。
• releases/UNFOLD-cloudflare.zip — 初期Cloudflare版のZIP。
• releases/UNFOLD-app.zip — 初期ローカル版のZIP。
• demos/ — 動画見本。
• demos/sequence-glb-heart-2026-09-28.webm — 公開版シーケンスで保存済みGLBを使って書き出した2秒の動作確認動画。同名PNGは立体化中のフレームです。
• models/ — GLB置き場からコピーした作例モデル。元のGLB置き場はそのまま残しています。
• models/星屑のハート.glb — 星とドット186個を離して配置したUNFOLD用の作例。星屑のハート.blend はBlenderで編集できる元データ、同名のPNGは見本画像です。
• models/星屑のハート_大きめ.glb — 外側のアクセント星を省き、UNFOLDでハート本体が約28%大きく見える版。元の版は残しています。同名の .blend と .png もあります。
• demos/genso_silent_unfold_mv.mp4（と .webm・_phone.mp4）— 歌詞MV機能で自動で組んだ「幻想サイレント」のMV（曲入り）。
• demos/genso_silent_outro_seq.webm — 幻想サイレント歌詞動画のアウトロー用に書き出したシーケンス（原本は Opus５.5/punk_lyric/outro_seq.webm。render.py が使うのでそちらも残しています）。
• demos/particles_demo_2026-09-29.mp4 — 2026-09-29に追加したパーティクル系15メソッドの見本。

2026-09-29 の更新（2026-09-29 21:28 に Netlify へ公開済み）

崩れ方（METHODS）を12種→29種に。パーティクル系（塵になる・きらめき・爆発・群れ・雨・雪・泡・網点・銀河・竜巻・風で飛ぶ・花びらが舞う）と、モーショングラフィックス定番（波紋・ブラインド・タイル反転・グリッチ・線で描かれる）。画像を6400個の小さな粒（GLB・文字はその三角形ごと）として動かせるように、ジオメトリに part 属性を追加しています。

シーケンスにタイムライン編集を追加（app/timeline.js・app/project.js）。画像クリップ／◆変形／曲の波形／歌詞が下に並び、ドラッグで並べ替え・長さ変更・切り替え位置の移動、画像ファイルをブロックにドロップで差し替え、歌詞と画像の連動ON/OFF、⌘/Ctrl+Z で元に戻す。編集内容はブラウザに自動保存され、「書き出し」で .unfold ファイル（画像と曲も入った1ファイル）に保存・「読み込み」で開けます。

2026-09-29 夜の更新（22:24 に Netlify へ公開済み・ZIP は releases/UNFOLD-Test-effects-camera-2026-09-29.zip）

演出を追加：光のにじみ（ブルーム）・ネオン（輪郭が光る／色指定可）・ガラス・走査線（ブラウン管）・ノイズ・周辺減光・ボケ（奥行きで変わる被写界深度）。後処理は app/effects.js の SceneBlur、ガラスは app/motion.js の glassLook。シーケンスにはカメラ（遠近感・ゆっくりズーム・手持ち揺れ・傾き・回り込み）と「◆ごとの演出の上書き」も。1枚モードは「04–05 演出」タブに同じ演出スライダー。見本は demos/effects_camera_demo_2026-09-29.mp4。

2026-09-30 の更新（22:08 に Netlify へ公開済み・ZIP は releases/UNFOLD-Test-glb-dashboard-mp4-2026-09-30.zip）

• ぐちゃぐちゃ中の引き／立体化中の引き（1枚モード・シーケンス）：崩れている間・立体の間にカメラがどれだけ引くか。0%で画面いっぱい、100%で従来どおり。シーケンスでは「画面いっぱいに表示」がオフでも効きます。
• 追加した形のダッシュボード（1枚モード）：GLB・立体文字・輪郭の形を、プリセットと同じタイルで表示。モデルのサムネ付き、水色の枠で区別。シーケンスの形メニューのGLBも同様（app/model-thumb.js）。
• 粒の細かさ（追加した形）：銀河・塵・雪など粒で崩すとき、面の多いGLBの粒をプリセットと同じ大きさまでまとめられる（particleParts in app/model-layout.js）。
• シーケンスの区間表示：タイムラインの◆変形の下に色帯（オレンジ＝ぐちゃぐちゃ、紫＝立体化）、プレビュー下に現在の区間ラベル。
• 書き出し（シーケンス）：画質（標準／高画質＝2倍で描いて縮小／最高）と形式（MP4＝H.264＋AAC、WebM）を選択。書き出した動画は右パネルの「動画保存」に表示（app/mp4-writer.js）。
• 各変更前の app/ は archive/app-before-*-2026-09-30/ に保存。

2026-10-02 の更新（2026-10-04 に公開）

• シーケンスの「04 見た目」が、プレイヘッドの位置（ぐちゃぐちゃ／立体化／画像）で効く設定だけを表示するように。橙の丸＝ぐちゃぐちゃ、紫の丸＝立体化、丸なし＝いつでも。一番上の「自動／すべて」で全部出せます。判定は phaseOf()、文言は app/look-view.js。変更前の app/ は archive/app-before-phase-filter-2026-10-02/。設計書は docs/superpowers/specs/2026-10-02-phase-filtered-look-tab-design.md、実装計画は docs/superpowers/plans/2026-10-02-phase-filtered-look-tab.md。

• 単体テスト: node --test tools/test/look-view.test.mjs

• 自作メソッドの土台（2026-10-04 に公開）：崩れ方の一覧を app/method-registry.js に統合。ブラウザのコンソールから unfoldMethods.registerCustom({ id: 'cm-…', name, symbol, vertex }) で GLSL の自作メソッドを登録すると、1枚モードとシーケンスの一覧に水色の枠で出て使えます（エディタ・保存・見張りは次の計画）。仕組みは app/custom-method.js、簡易チェックは app/method-guard.js。変更前の app/ は archive/app-before-custom-engine-2026-10-02/。設計書は docs/superpowers/specs/2026-10-02-custom-methods-design.md、実装計画は docs/superpowers/plans/2026-10-02-custom-methods-1-engine.md。

• 単体テスト: node --test "tools/test/*.test.mjs"（ディレクトリ指定だと動きません）

• 自作メソッドのエディタ（2026-10-04 に公開）：メソッド一覧の最後の「＋自作メソッド」でエディタが開きます（1枚モード・シーケンス共通）。左にコード、右にプレビュー、下に「書き方のチェック」と「GPUでのコンパイル」の結果。サンプルから始める／AIに頼むひな形をコピー／下書きの自動保存つき。自作タイルは水色の枠で、⚙から編集・複製・削除・もう一度試す。壊れたメソッドは登録した瞬間に自動で「停止中」になります。保存先はこのブラウザ（IndexedDB）。仕組みは app/method-editor.js・app/method-library.js ほか。変更前の app/ は archive/app-before-custom-editor-2026-10-03/。実装計画は docs/superpowers/plans/2026-10-03-custom-methods-2-editor.md。

• 自作メソッドの安全装置（2026-10-04 に公開）：エディタに「試し描画」を追加（標準の一番重いメソッドと同じ場で測って4倍まで、ただし速いGPUでは床の4msが実際の線／何も映らない・変わらないは警告）。再生中にコマ間隔が基準の4倍かつ50ms以上のまま30コマ続くと、その自作メソッドを自動で止めます（「停止中」）。使い始める前に localStorage へ「試用中」の印を書き、30コマ描けたら消します。ブラウザごと落ちたときは、次の起動で印が残っているメソッドを「落ちた」にして止め、エディタの下書きは自動でチェックしません（「チェックする」を押すまで）。GPUのコンテキストが失われたときも、使っていた自作メソッドを止めます。書き出しの前に、自作メソッドのコンパイル完了を待ちます。仕組みは app/method-safety.js・method-watchdog.js・method-crashflag.js・method-trial.js。変更前の app/ は archive/app-before-custom-safety-2026-10-03/。実装計画は docs/superpowers/plans/2026-10-03-custom-methods-3a-safety.md。

• 自作メソッドの .unfold への同梱と、取り込み時の隔離（2026-10-04 に公開）：プロジェクトを書き出すと、◆が使っている自作メソッドだけがコードごと入ります（version 2。使っていなければ今までどおり version 1）。ブラウザの自動保存には入れず、ファイルへの書き出し（と保存先ファイル）だけです。他の人のファイルを開くと、手元に無いコードは「未確認」で入り、確認が終わるまでコンパイルも描画もされません（同じコードが手元にあれば、それを使います）。シーケンスの方法一覧の下のバナーか、タイルの⚙から「有効にする」を押すと、書き方チェック・GPUのコンパイル・試し描画を通ったものだけが使えるようになります。「コードを見る」は自動チェックなしでエディタを開きます（読んで、「チェックする」を通して保存すると有効）。ファイルの や状態は信用せず、id・名前・コードの大きさも検査します（50個まで・1つ8000文字まで・新しい形式のファイルは取り込まない）。確認の途中でブラウザが落ちたときは、次の起動で未確認のまま理由を残します。仕組みは ・・。変更前の は 。実装計画は 。

公開サイト: https://unfold.saisuiwa.com/ （説明 /guide/、メソッド集 /guide/methods.html、GLB置き場 /guide/glb.html）
Cloudflare管理画面: Workers & Pages → unfold（手順と注意は docs/公開手順_Cloudflare.md）
公開先は Cloudflare だけです。 Netlify（unfold-test）はもう使っていません（2026-10-17 作者。サイトを消すときは Netlify の管理画面 https://app.netlify.com/projects/unfold-test から）。

Mac内の移動は公開中のサイトや管理画面に影響しません。現時点では手動デプロイなので、今後更新する場合は docs/公開手順_Cloudflare.md の手順で、app/ のフォルダを Cloudflare の unfold にアップロードしてください。ローカルの編集だけでは公開サイトは更新されません。

追加したGLBはサイトごと・ブラウザごとのIndexedDBに保存され、1枚モードとシーケンスで共有されます。従来版で一時的に読み込んだGLBは一度追加し直す必要があります。ブラウザのサイトデータを削除すると保存したGLBも消えるので、元のGLBファイルは保管してください。

以前のフォルダ位置にはこのフォルダへのリンクを残しています。外付けORICOを外すと、それらのローカルリンクは開けなくなりますが、公開中のサイトには影響しません。

2026-10-04 自作エディタのローカル改良

花びら・渦・立体ポップのプリセット、エディタ内の画像変更、userMethodコピー、実amount 0.00〜0.80表示を追加。公開はしていません。起動・検証・変更範囲・画面写真は 検証記録。

2026-10-04 カメラ・光・半透明のローカル比較

元に戻せる表示比較をエディター・1枚モード・シーケンスへ追加。初期値OFF、網点透過は任意の実験機能。操作、同条件の性能、原画保持、動画出力と制約は 検証記録。公開サイトは未更新。

2026-10-04 回転方向・カメラ移動のローカル改良

1枚モードとシーケンスに共通の「回転方向・カメラの移動」を追加。入り・戻りそれぞれ右／左／上／下／斜め4方向／回転なしと0〜3回転を指定。画像パッドでカメラの開始点・終了点を選び、ズーム・秒数・速さの変化を設定できます。初期OFFで従来の動きを保持。自動追跡ではなく指定軌道です。242件の単体テスト、5件のChrome描画検証、両モードのMP4出力を確認。公開はしていません。検証記録と見本動画。

かんたん歌詞・曲（2026-10-04）

シーケンスの「05 歌詞・曲」で、既存の画像・立体映像の前面にテキストモーションを重ねられます。

1. 曲を選ぶかドロップ。MP3（ID3 USLT/SYLT、v2.2 ULT/SLT）とM4A/MP4（©lyr）の埋め込み歌詞をローカルで読みます。入力済みの歌詞は候補ボタンを押すまで置き換えません。
2. 歌詞を貼り付けるかLRC/JSON/TXTを選択。[Chorus]・【サビ】などは演出の区分になり、見出し自体は動画に出ません。未知の見出しや間奏に続く文章は、歌詞か指示かを選べます。/ は画面内改行、言葉 は強調。
3. 「読みやすく」「元気に」「やわらかく」を選び再生。各行を開いて色・書体・位置・動き・時刻を変更できます。「この動きを固定」で、おまかせの変更からその行を守れます。
4. 時刻のない歌詞は仮配置です。「タップで合わせる」で歌い出しと間奏開始を記録し、途中停止・再開できます。文字入力中のSpaceはタップを発火しません。音声認識による自動文字起こしや歌唱位置の自動推定は行いません。
5. 動画保存タブでMP4（H.264/AAC）またはWebMを保存。曲尺が基本で、背景が短い場合は最後の画像を保ちます。音楽の開始位置は既存のoffsetと共通です。

文字のタイミングを変えても、背景の画像・変形・回転・カメラは組み直しません。現在の文字は前面の2Dレイヤーです。立体の背後への回り込みは含みません。

新しい歌詞を含む .unfold はversion 3です。旧版UNFOLDでは新歌詞を再現できないため、この版以降で開いてください。version 1/2の旧作品は従来の見た目で開きます。旧歌詞MVは「テキストモーション版を作る」で変換でき、元の保存先を解除して別名保存を案内します。Undoにも対応。

音楽・歌詞・画像を外部サービスへ送信しません。FLAC/Vorbis等の歌詞タグ抽出は対象外です。フォントは既存のWebフォント設定を使用し、オフラインではシステムフォントへフォールバックします。

検証と見本動画：歌詞MV検証記録。起動は従来どおり python3 tools/serve.py、ローカルシーケンス。

モーション集・自作（2026-10-04）

「歌詞・曲 → モーション集・自作」で6つの文字構成を選び、登場・表示中・退場を組み合わせられます。揺れ・明滅・グリッチ・波ワープ・残像は最大3種類まで重ねられ、名前付き保存、.unfoldmotionファイルの受け渡し、AI依頼文とJSON編集に対応。各行へ個別適用、または固定していない行へ一括適用できます。

モーション集は同じ描画器による動く見本です。編集済みの歌詞時刻・固定・Undo/Redo・プロジェクト保存を保持します。文字間の本格モーフィングは未実装。公開サイトは未更新。検証記録。

歌詞のその場編集・PCフォント（2026-10-04）

タイムラインで歌詞を選び、右側の「動き・色・書体」から直接編集できます。言葉をタップして単語だけの色、行・全歌詞の配色、PCインストール済みフォントやフォントファイルに対応。色・書体を変えずにモーションを試せます。使い方と検証。

Custom text motions

In the lyric inline editor, choose 動き → ＋追加・コードで作る. The editor combines Three.js, Troika Text and GSAP using an isolated, seekable JavaScript API. Preview before adding a reusable block; export/import .unfoldmotion files to share motions. Existing recipe files still work. See author guide and verification report. Standard fonts and runtime dependencies are bundled locally.

毎日のサンプル追加（2026-10-07〜）

メソッド工房のサンプルと同じ3種類を、毎日1つずつ足して検証し、通ったものだけ main に入れるルーティンです。手順は docs/daily-samples-routine.md、追加の記録は docs/daily-samples-log.md。

• 足す場所（3種類を1つずつ）：メソッド＝GLSL は app/method-samples.js の SAMPLES、グラフィックモーション＝JavaScriptの画像メソッドは app/image-method-daily.js、テキストモーション＝文字のコードモーションは app/code-motion-daily.js。後ろの2つは、Macで作られたプリセット（image-method-presets.js code-motion-presets.js）の末尾につながって、工房とエディタのサンプルに出ます。以前の GLSL の graphic と、かんたん設定の文字の動き（TEXT_MOTIONS、歌詞パネルの「動き」の選択肢）は残してあり、新しくは足しません。
• 見本のページ：/guide/samples.html（マウスを載せると動く。ソースは app/guide/samples.html、node tools/build_guide_samples.mjs で作る。プレビューのJPG/MP4は app/guide/samples/、node tools/make_sample_previews.mjs が、GLSLはエディタのプレビュー、画像メソッドと文字コードはアプリ本物の実行環境、かんたん設定の文字は歌詞の描画器で描いて作る）。
• 足したあとの検証：node tools/verify_daily.mjs --expect-new=<日付>（単体テスト・GLSLのGPU検査・画像メソッドと文字コードの実行（効果が出る／画面に収まる／終わりで消える）・プレビューの形式・全ページの表示・?v= の上げ忘れ・ログまで）。GLSLを変えたときの ?v= は node tools/bump_module_version.mjs app/<ファイル>.js で、HTMLまで玉突きで上がります。
• 公開サイトは自動では変わりません。更新するときは、これまでどおり app/ を Cloudflare にアップロードしてください（docs/公開手順_Cloudflare.md）。