jh-presentation

ローカルの画像・動画ファイルをデッキに埋め込む (png / jpg / gif / webp / svg / mp4 / webm)。スライドからは <img data-asset="返された名前" alt="..."> で参照する (src は書かない)。

ヘッドレスブラウザでプレゼンテーション資料 (スライド・デッキ) を開き、次の項目を検査する: はみ出し・切れ・余白への食い込み (overflow。area: margin は本文がスライドの余白に入り込んでいる)、文字の重なり・ページ番号との重なり (overlap)、タイトルの 2 行への折り返し (wrap)、コントラスト不足 (contrast)、画像の欠落・読み込み失敗 (images)、小さすぎる文字 (smallText)、JS エラー (errors)、エンジンの警告 (warnings)、外部への通信 (externalRequests。オフラインで動かなくなるので不可)。ok: true は「検査した項目で問題が見つからなかった」という意味で、見た目の良し悪しは screenshot_deck で確認すること。意図的な重なり・はみ出し・折り返しは .allow-overlap / .allow-overflow / .allow-wrap で除外できる。write_deck / replace_slide は書き込み後に同じ検査を自動で行うので、これは書き込まずに検査し直したいときに使う。マップ文書も検査できる (データの誤り data・1 階層のノード数 density・全階層の文字の重なり overlap・JS エラーなど)。

プレゼンテーション資料 (スライド・発表資料・LT・報告資料) を新しく作る。1 ファイルの HTML (デッキ) で、名前は YYYY-MM-DD-<name>。表紙 1 枚だけの状態で作られるので、続けて write_deck で中身を書く。

マップ文書を新しく作る: スライドではなく、大きなシステムの関連図・説明書を「全体 → 細部」とたどって読む 1 ファイルの HTML 資料 (目次・検索・データでの絞り込み・URL での共有・階層ごとの印刷付き)。名前は YYYY-MM-DD-<name>。map を省略すると、書き方の見本を兼ねた最初のマップが入るので、続けて write_map で中身を書く。

自作テーマを保存する (同名の自作テーマは上書き)。css は default テーマに重ねる CSS (:root の変数上書き + 必要な装飾)。保存後は preview_themes で全見本スライドを確認して調整すること。get_theme_guide を先に読む。

デッキを 16:9 の PDF に出力する (アニメーションなし、全ステップ表示)。ユーザーが PDF を求めたときだけ使う (HTML のデッキファイル自体がそのまま配布・発表できるので、頼まれていなければ作らない)。マップ文書は階層ごとに 1 ページ (図 + その階層の部品の説明。A4 横)。

プレゼンテーション資料 (スライド・発表資料) の書き方・部品カタログ・良い例・デザイン原則・作業手順。スライドを書く前に必ず読むこと。

新しいテーマを作るためのガイド (変数の一覧・装飾の上書き方法・確認手順)。create_theme の前に読む。

作成済みのプレゼンテーション資料 (スライド・デッキ) とマップ文書の一覧 (新しい順)。保存先のフォルダも返す。

デッキ・マップ文書の保存履歴 (書き込み前の版。新しい順、最大 20 件)。

用意されている依頼文テンプレート (技術解説・LT・進捗報告など) の一覧と本文。クライアントのプロンプトメニューを使えない場合や、ユーザーが「どんな型がある?」と聞いたときに使い、選ばれたテンプレートの本文に沿って作成を進める。

利用できるデザインテーマ (同梱 + 自作。名前・表示名・雰囲気の説明・タグ)。内容や聞き手に合うテーマを選ぶときに使う。

ユーザーの既定のブラウザでプレゼンテーション資料 (スライド・デッキ) を開く (発表・確認用。完成したら開いて見せる)。ローカルサーバー経由で開くので、ユーザーは E キーで文字を直して Ctrl+S で元のファイルに直接保存できる。fullscreen: true にすると Chrome / Edge を全画面 (タブ・アドレスバーなし) で起動する。ユーザーが「発表する」「全画面で開いて」と言ったときに使う。マップ文書も開ける (level にノード id を渡すと、その階層を開く)。

全テーマの見本スライドを並べたページを生成し、ユーザーのブラウザで開く。ユーザーが「テーマを見たい」「どんなデザインがある?」と言ったときに使う (実際に動く見本を見て選べる)。

各テーマの見本スライドを画像で返す (AI がテーマを見比べる用。テーマ作成後の確認にも使う)。slide: 1=表紙 2=セクション扉 3=カード 4=数値 5=コード 6=結び

プレゼンテーション資料 (スライド・デッキ) の編集可能な部分 (スライド HTML・デッキ専用 CSS / JS・設定・埋め込み画像名) と revision を返す。修正前に必ず読むこと。write_deck / replace_slide に revision を渡すと、読んだ後に他で変更されていた場合に上書きを防げる。

マップ文書の編集可能な部分 (マップのデータ (JSON)・専用 CSS / JS・設定) と revision を返す。修正前に必ず読むこと。write_map に revision を渡すと、読んだ後に他で変更されていた場合に上書きを防げる。大きなマップ (ノードが数十を超える) は、outline: true で目次 (id・名前・種類・中の数) だけを読み、node に箱の id を渡してその箱 (children ごと) と、外からつながる矢印・関連・流れ (context) だけを読む。

ブラウザの「名前を付けて保存」で表示中の状態のまま保存されて壊れたデッキを、元の形式に復旧する (list_decks で broken と出るもの)。壊れたファイルは履歴に残る。復旧後は audit_deck と screenshot_deck で確認する。

プレゼンテーション資料 (デッキ) のスライドを 1 枚だけ置き換える。target は 1 始まりの番号、またはスライドの id (id での指定を推奨)。書き込み後に自動でレイアウトを検査し、結果を audit に返す。

保存履歴の版にデッキ・マップ文書を戻す (戻す前の内容も履歴に残るので、やり直しできる)。

プレゼンテーション資料のスライドの見た目を画像で返す。slides 省略時は全スライド (枚数が多い場合は数枚ずつ指定するとよい)。step 省略時は全ステップ表示・アニメーション完了後の最終状態。数値を指定するとそのステップ数まで表示した状態。マップ文書は階層ごとに撮る (levels にノード id の配列。'' は全体。省略時は全階層 (最大 12)。select でその部品を選んで詳細パネルを開いた状態)。

デッキ・マップ文書に埋め込まれたエンジン・テーマ・ブランド設定を最新にする (内容は変わらないが、見た目が変わる場合がある)。ユーザーが最新化を求めたとき、またはブランド設定 (brand.json) を変えたときだけ使う。name 省略時は全デッキ・全マップ文書。

プレゼンテーション資料 (デッキ) のスライドを書き込む。指定した項目だけ置き換え、省略した項目はそのまま残る。slides は <section class="slide">...</section> の並び (全スライド分。id の重複やスライド外の要素はエラー)。埋め込まれたエンジン・テーマ・ブランドは変わらない (theme を変えた場合はテーマだけ入れ替わる。最新化は upgrade_deck)。保存前の内容は履歴に残る (list_history / restore_history)。書き込み後に自動でレイアウトを検査し、結果を audit に返す (ok: false なら issues を直して書き込み直す)。

マップ文書のデータを書き込む。指定した項目だけ置き換え、省略した項目はそのまま残る。map は全体を渡す。大きなマップの一部だけを直すときは、map の代わりに node (箱の id) と part (その箱の JSON 全体。children ごと。id は同じ) を渡す。埋め込まれたビューア・テーマ・ブランドは変わらない (最新化は upgrade_deck)。保存前の内容は履歴に残る (list_history / restore_history)。書き込み後に自動で検査し、結果を audit に返す (ok: false なら issues を直して書き込み直す)。