「みほん」にフラクタルの木を足す（じぶんのブロックの見本）

[temoki]

背景

#14 で じぶんのブロック（＝再帰）が入った。いまの みほん 3 つ（しかくをぬる / ほしをかく / うずまきをかく）は はこ も もし も じぶんのブロック も使っていないので、この機能に触れる入口が「自分で組み立てる」しかない。

再帰は言葉で説明しても伝わらないぶん、動くものが 1 つ置いてあることの効きが大きい。#14 の実装中も、仕様の妥当性（パラメータなし・グローバルなはこ 1 個で足りるか）を判断できたのは木が描けたからだった。

提案するプログラム（#14 の検証でそのまま使ったもの）

はこにいれる 🌟 70
ペンのいろ みどり
ペンのふとさ 2
ブロックをよぶ き
ブロックをつくる き
    もし 🌟 > 6 なら
        まえへ 🌟
        はこにかける 🌟 0.6
        みぎへまわる 28
        ブロックをよぶ き
        ひだりへまわる 56
        ブロックをよぶ き
        みぎへまわる 28
        はこをわる 🌟 0.6
        うしろへ 🌟

• 155 コマンド / 枝 31 本 — ステップ上限 10,000 に対して十分小さい
• ネストの深さ 約 11 — BlockExpander.defaultNestingLimit（30）に対して余裕がある
• はこは ×0.6 … ÷0.6 で呼び出しを挟んで元に戻るので、グローバルなはこ 1 個で成立する。第一弾がパラメータなしでよかったことの実例にもなる

やること

• Kit: SampleBlocks.fractalTree()
• Kit: SampleBlocksTests に決定的な期待値（既存 3 つと同じ形式）
• App: WorkspaceView の空状態に 4 つ目のボタン
• App: Localizable.xcstrings（en 原文 + ja）

決めたいこと

• **空状態のボタンが 3 → 4 に増える。**縦積みのままでよいか（ContentUnavailableView の actions:）
• 起動画面に出すか。 起動画面に「みほん」からはじめる導線を足す #35 は closed だが、LaunchScene は現状「あたらしく つくる」1 つだけで、みほんの導線は WorkspaceView の空状態にしかない。みほんを起動画面に出す話を蒸し返すなら、この木がいちばん「絵で分かる」候補
• **ブロックの名前を「き」にするか。**ひらがな 1 文字で、生成コードでも識別子として合法。プリセット絵文字（🌸🌈🎈）を使う手もあるが、見本としては意味のある名前のほうが「名前をつける」という概念が伝わる
• ペンのいろ（みどり）とふとさ（2）を見本に含めるか。無くても描けるが、木が緑だと一目で何か分かる

注意

このみほんを差し込んだドキュメントは requiredSchemaVersion が 3 になる（保存すると v3 未満のアプリでは開けない）。既存 3 つは 1 または 2 のままなので、みほん経由で初めて v3 のファイルが配られることになる。

関連

• 関数ブロック（マイブロック） #14 じぶんのブロック（この見本が使う機能）
• 起動画面に「みほん」からはじめる導線を足す #35 起動画面に「みほん」からはじめる導線を足す（closed）
• 新規ドキュメントのテンプレート（サンプルから選んで開始） #5 新規ドキュメントのテンプレート（closed）

[temoki]

設計（2026-08-11）

プロトタイプを作って、決めることのうち 1 つは実物で潰しました。残りは判断をお願いします。

みほんの中身（実測済み）

ペンのいろ みどり
ペンのふとさ 2
はこにいれる 🌟 70
ブロックをよぶ き
ブロックをつくる き
    もし 🌟 > 6 なら
        まえへ 🌟
        はこにかける 🌟 0.6
        みぎへまわる 28
        ブロックをよぶ き
        ひだりへまわる 56
        ブロックをよぶ き
        みぎへまわる 28
        はこをわる 🌟 0.6
        うしろへ 🌟

SampleBlocks.fractalTree() として組んで展開した実測値:

• 157 コマンド（うち まえへ/うしろへ が 62 ＝ 枝 31 本）、5 段
• ネストの深さ 11（上限 30）、ステップ 10,000 に対しても十分小さい
• 最後のコマンドが forward(-70) ＝ いちばん外側の呼び出しが自分の幹を戻りきる。はこが ×0.6 … ÷0.6 で完全に戻る証拠で、「グローバルなはこ 1 個で足りる」＝第一弾がパラメータなしでよかったことの実例になります

決まったこと（プロトタイプで確認）

空状態のボタン 3 → 4 は問題なし。 iPad ポートレートの実機ビルドで確認したところ、縦積みのまま収まり、下に余白も残ります。ContentUnavailableView の actions: はそのまま、レイアウト変更は不要でした。

判断してほしいこと

1. 起動画面に出すか。 LaunchScene は現状「あたらしく つくる」だけで、みほんの導線は空状態にしかありません。起動画面に「みほん」からはじめる導線を足す #35 は closed ですが、実際にはボタンは足されていない（＝見送られた？）ように見えます。この issue のスコープは空状態だけに留めるのが私の推奨です。起動画面はカードの中身の設計が別途必要で、起動画面に「みほん」からはじめる導線を足す #35 を開け直す話になるため
2. 名前は「き」でよいか。 ひらがな 1 文字、生成コードでも識別子として合法。プリセット絵文字（🌸🌈🎈）より「名前をつける」という概念が伝わると考えて「き」にしています
3. いろ（みどり）とふとさ（2）を含めるか。 含める案です。木が緑だと一目で何か分かり、既存 3 つも先頭でペンを設定しているので形が揃います

やること

• Kit: SampleBlocks.fractalTree()
• Kit: SampleBlocksTests に決定的な期待値（157 コマンド / 最後が forward(-70)）
• App: WorkspaceView の空状態に 4 つ目のボタン（＋各みほんに絵文字 🟦 ⭐️ 🌀 🌳）
• App: Localizable.xcstrings（Sample: Tree / サンプル: きをかく）

受け入れ条件

• swift test（119 tests）+ 両プラットフォームビルド green
• iPad / macOS でボタンが 4 つ並び、押すと木が描ける（@temoki 目視確認済み）
• このみほんを入れたドキュメントの requiredSchemaVersion が 3 になる

注意

**みほん経由で初めて schema 3 のファイルが配られます。**既存 3 つは 1 または 2 のままなので、「みほんから始めて保存したら、古いバージョンのアプリで開けなくなる」が起きるのはこれが最初です。避けようがない（機能を使う以上 v3）ので、記録として。

---

上の 3 点を決めてもらえれば実装に入ります（プロトタイプはローカルブランチ feature/45-fractal-sample に置いてあります）。

---

実装は PR #47。判断 3 点はいただいたとおり（起動画面には出さない / 名前は「き」/ いろとふとさを含む）、加えて各みほんに絵文字を付けました。