mp 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ff079cf7563dddd6684f0a4b88d59adba0e0a7290c505f45687566c5bc13af9a
+  data.tar.gz: 8178770f3b19a573736ffc24e20534221170dfe7d7429c65edd5bc619bac3b1d
+SHA512:
+  metadata.gz: 50c91001bcbd108799a7e752910e5b7bab6badcd530a8357b07860bf22f5484a190c509cafc05ebc2b243a0755a9a329e8bf9f1d7d4986902cbfe8269d59448c
+  data.tar.gz: e252cc2177716ade059b52fd4846228c41c1f3b1598db1683005a6d3f580946012514deac78d3dbdfd3bbcc2890d14638949475b1a95f881bdcae59ce5f705e9

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 takkanm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,206 @@
+# mp
+
+Markdown を全画面プレゼンテーションにする Ruby 製ツールです。スライドに本物のターミナルと Web ページを埋め込めます。
+
+## 必要なもの
+
+- Ruby 3.3 以上
+- Chrome 系ブラウザ(Chrome / Chromium / Edge / Brave。別の場所にある場合は `MP_BROWSER` でパスを指定)
+
+## 使い方
+
+```bash
+bundle install
+bundle exec exe/mp examples/demo.md
+```
+
+| オプション | 説明 |
+| --- | --- |
+| `-w`, `--window` | 全画面にせずウィンドウで開く |
+| `-P`, `--presenter` | 発表者ビューも開く |
+| `-p`, `--port PORT` | ローカルサーバのポート(既定は空きポート) |
+| `--profile DIR` | Chrome のプロファイルを保存する(埋め込みページのログインを保持) |
+| `--no-watch` | ファイル変更時に再読み込みしない |
+
+Markdown や CSS を保存すると自動で再読み込みします。このときターミナルのセッションはリセットされます。
+
+## スライドの書き方
+
+| 記法 | 結果 |
+| --- | --- |
+| `# 見出し` | 表紙スライド。次の H2 までの本文も表紙に入る |
+| `## 見出し` | 通常のスライド 1 枚。見出しがページタイトルになる |
+| `---` | タイトルなしの続きスライド |
+
+## ターミナルの埋め込み
+
+````markdown
+```terminal cwd=./demo height=60% font=20
+npm test
+git status
+```
+````
+
+本文に書いたコマンドは 1 行ずつ入力欄に打ち込まれますが、**Enter を押すまで実行されません**。実行すると次の行が打ち込まれます。本文は空でも構いません。
+
+| 属性 | 説明 |
+| --- | --- |
+| `cwd` | 作業ディレクトリ(デッキからの相対パス) |
+| `height` / `width` | 大きさ(`60%`、`400px`)。省略すると残りの領域を埋める |
+| `font` | 文字サイズ(既定 18) |
+
+## Web ページの埋め込み
+
+````markdown
+```web zoom=0.8 height=70%
+https://example.com
+```
+````
+
+本文には `http(s)` の URL か、デッキからの相対パス(`./page.html`)を書きます。`X-Frame-Options` などで埋め込みを拒否するサイトも表示できます。
+
+| 属性 | 説明 |
+| --- | --- |
+| `zoom` | 表示倍率 |
+| `height` / `width` | ターミナルと同じ |
+
+クリックするとページを操作でき、マウスが外に出るとスライドのキー操作に戻ります。
+
+ターミナルとページを横に並べるには `<!-- _class: columns -->` を使います。
+
+## Marp 互換の記法
+
+**フロントマター / ディレクティブ**
+
+```markdown
+---
+theme: default        # default / dark / ./my-theme.css
+size: 16:9            # 16:9 / 4:3
+title: タイトル
+paginate: true
+header: ヘッダー
+footer: フッター
+style: |
+  section { font-size: 28px; }
+---
+
+<!-- class: lead -->             以降のスライドに適用
+<!-- _backgroundColor: black --> このスライドだけに適用(先頭に _)
+```
+
+使えるディレクティブは `paginate` `header` `footer` `class` `color` `backgroundColor` `backgroundImage` `backgroundPosition` `backgroundRepeat` `backgroundSize` です。クラスには `lead`(中央寄せ)、`invert`(配色反転)、`columns`(2 列)があります。
+
+**画像**
+
+```markdown
+![w:300 h:200](a.png)            サイズ指定
+![blur:5px grayscale](a.png)     フィルタ
+![bg](a.png)                     背景(複数並べると分割)
+![bg contain](a.png)             cover / contain / fit / auto / 50%
+![bg right:40%](a.png)           画面を分割して片側に配置
+```
+
+**その他**
+
+- 上記以外の `<!-- コメント -->` は発表者ノートになる(`n` で表示)
+- `*` のリストは 1 項目ずつ表示し、`-` のリストは一度に表示する
+- `# <!-- fit --> 見出し` は見出しを横幅いっぱいに拡大する
+- `<style scoped>` はそのスライドだけに効く
+- 数式は `$...$` と `$$...$$`(KaTeX)
+- コードはシンタックスハイライトされる(Rouge)
+
+## 発表者ビュー
+
+```bash
+bundle exec exe/mp --presenter examples/demo.md
+```
+
+発表中に `p` を押しても開けます。現在のスライド、次のスライド、発表者ノート、経過時間、現在時刻を表示します。
+
+- **操作:** 発表者ビューのキー操作は聴衆画面に反映されます。聴衆画面を操作した場合も発表者ビューが追従します
+- **次の枠:** `*` リストの未表示項目が残っていれば、次に表示される項目を先に見せます
+- **ターミナルと Web:** 現在の枠には聴衆画面をそのまま映します(1 秒に数回更新)。次の枠にはコマンドや URL を表示します
+- **台本の実行:** ターミナルのスライドでは次のコマンドを表示し、発表者ビューの `Enter` で聴衆画面のターミナルを実行します
+- **ディスプレイ:** 外部ディスプレイがあれば、聴衆画面をそちらの全画面に移し、発表者ビューを手元の画面に置きます
+- **閉じる:** 発表者ビューだけを閉じても発表は続きます。`q` を押すと全体が終了します
+
+| キー | 動作 |
+| --- | --- |
+| `→` `↓` `Space` `PageDown` | 次へ |
+| `←` `↑` `PageUp` | 前へ |
+| `Home` / `End` | 最初 / 最後 |
+| 数字 + `Enter` | そのページへ |
+| `Enter` | 台本のコマンドを実行 |
+| `r` | 経過時間をリセット |
+| `+` / `-` | ノートの文字サイズ |
+| `q` | 終了 |
+
+1 画面で使うと、発表者ビューが聴衆画面の全画面の裏に隠れます。macOS ではスペースを切り替えて表示してください。
+
+## キー操作
+
+| キー | 動作 |
+| --- | --- |
+| `→` `↓` `Space` `PageDown` | 次へ |
+| `←` `↑` `PageUp` | 前へ |
+| `Home` / `End` | 最初 / 最後 |
+| 数字 + `Enter` | そのページへ |
+| `t` またはクリック | ターミナルを操作 |
+| `⌘.` | ターミナルから抜ける |
+| `⌘←` / `⌘→` | ターミナル操作中でもページ移動 |
+| `f` | 全画面の切り替え |
+| `n` | 発表者ノート |
+| `p` | 発表者ビュー |
+| `?` | ヘルプ |
+| `q` | 終了 |
+
+## しくみと安全性
+
+Ruby のローカルサーバ(puma)がスライドを配信し、Chrome をアプリモードで開きます。ターミナルは Ruby の `PTY` と WebSocket で xterm.js につなぎます。Web 埋め込みでは、Chrome DevTools Protocol でフレームのレスポンスから `X-Frame-Options` と CSP の `frame-ancestors` を取り除きます。
+
+ターミナルはコマンドを実行できるので、次のように保護しています。
+
+- サーバは `127.0.0.1` のみで待ち受け、全パスにランダムトークンを要求する
+- WebSocket は Origin を検証する
+- CSP により、デッキ内の HTML に書いたスクリプトは実行されない
+- デッキ配下の HTML は sandbox で配信し、ターミナルへ接続できない
+- コマンドは Enter を押すまで実行されない
+
+それでも、Enter を押せば書かれたコマンドは実行されます。**他人が作ったデッキは内容を確認してから発表してください。**
+
+埋め込みを拒否するヘッダを外すのは、mp が起動する Chrome の中だけです。この Chrome は既定で一時プロファイルを使い、普段のプロファイルには影響しません。
+
+## 制限
+
+- 埋め込みページは iframe なので、サードパーティ Cookie の制限によりログイン状態を維持できないサイトがあります
+- `:smile:` 形式の絵文字ショートコードは未対応です(Unicode の絵文字は使えます)
+- 発表者ビューから入力できるのは `Enter` だけです。台本にないコマンドを打つときは、聴衆画面のターミナルをクリックしてください
+
+## 開発
+
+```bash
+bundle exec rake test
+bundle exec ruby test/e2e.rb
+bundle exec ruby test/presenter_e2e.rb
+```
+
+`test/e2e.rb` と `test/presenter_e2e.rb` はヘッドレス Chrome で実際に動かして確認します。Web 埋め込みの確認にはネットワーク接続が必要です。
+
+`vendor/assets` には xterm.js と KaTeX を同梱しています。実行に Node.js は不要です。
+
+## リリース
+
+| コマンド | 説明 |
+| --- | --- |
+| `bundle exec rake build` | テストを実行し、`pkg/` に gem を作る |
+| `bundle exec rake install` | gem を作ってローカルにインストールする |
+| `bundle exec rake release` | テスト、ビルド、タグ付け、push、RubyGems への公開を行う |
+
+手順は次のとおりです。
+
+1. `lib/mp/version.rb` のバージョンを上げる
+2. `bundle install` で `Gemfile.lock` を更新する
+3. 変更をコミットする
+4. `bundle exec rake release` を実行する
+
+`rake release` にはコミット済みの git リポジトリと `origin` リモート、RubyGems の認証情報が必要です。未コミットの変更があると公開前に中断します。

data/exe/mp

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/mp/cli"
+
+exit Mp::Cli.run(ARGV)

data/lib/mp/app.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+require "json"
+require "listen"
+require_relative "browser"
+require_relative "frame_unblocker"
+require_relative "server"
+
+module Mp
+  # サーバとブラウザを起動し、ウィンドウが閉じるまで待つ。
+  class App
+    attr_reader :server, :browser, :page_session
+
+    MIRROR_WIDTH = 1280
+
+    def initialize(path, fullscreen: true, port: 0, profile: nil, watch: true, headless: false, size: [1280, 720],
+                   presenter: false)
+      @path = path
+      @fullscreen = fullscreen
+      @port = port
+      @profile = profile
+      @watch = watch
+      @headless = headless
+      @size = size
+      @presenter = presenter
+      @done = Queue.new
+    end
+
+    def start
+      @server = Server.new(@path, port: @port, on_quit: -> { @done << :quit }).start
+      @server.on_open_presenter = -> { open_presenter }
+      @server.on_frame_request = -> { send_frame }
+      @browser = Browser.new(@server.boot_url, fullscreen: @fullscreen, profile: @profile,
+                                               headless: @headless, size: @size).launch
+      @page_session = @browser.attach_page
+      cdp = @browser.cdp
+      @target_id = cdp.call("Target.getTargetInfo", {}, session_id: @page_session)["targetInfo"]["targetId"]
+      cdp.on("Target.targetDestroyed") { |params, _| @done << :closed if params["targetId"] == @target_id }
+      cdp.on_close { @done << :closed }
+      cdp.call("Target.setDiscoverTargets", { discover: true })
+
+      # 埋め込み用の設定が終わってから本番ページへ遷移する
+      FrameUnblocker.new(cdp).attach(@page_session)
+      cdp.call("Page.navigate", { url: @server.app_url }, session_id: @page_session)
+      start_watcher if @watch
+      open_presenter if @presenter
+      self
+    rescue StandardError
+      stop # 起動途中で失敗しても Chrome を残さない
+      raise
+    end
+
+    def wait
+      @done.pop
+    end
+
+    # シグナルハンドラからも呼べるよう、Queue への追加だけにしている
+    def request_stop
+      @done << :signal
+    end
+
+    def stop
+      @listener&.stop
+      @browser&.close
+      @server&.stop
+    end
+
+    private
+
+    def open_presenter
+      now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      return if @server.presenter_connected? || (@opened_at && now - @opened_at < 5) # キーの連打対策
+
+      @opened_at = now
+      @browser.open_window(@server.presenter_url)
+      Thread.new { arrange_displays } unless @headless
+    end
+
+    # 聴衆画面の見た目を発表者ビューへ送る。screencast と違い、ウィンドウが
+    # 他のウィンドウの裏にあっても最新の画面を取れる
+    def send_frame
+      cdp = @browser.cdp
+      view = cdp.call("Page.getLayoutMetrics", {}, session_id: @page_session)["cssLayoutViewport"]
+      clip = { x: 0, y: 0, width: view["clientWidth"], height: view["clientHeight"],
+               scale: [MIRROR_WIDTH.to_f / view["clientWidth"], 1].min }
+      frame = cdp.call("Page.captureScreenshot", { format: "jpeg", quality: 75, clip: clip, optimizeForSpeed: true },
+                       session_id: @page_session)
+      @server.send_frame(frame["data"])
+    rescue Cdp::Error => e
+      warn "[mp] #{e.message}" if ENV["MP_DEBUG"]
+    end
+
+    # 外部ディスプレイがあれば聴衆画面をそちらの全画面に、発表者ビューを手元に置く
+    def arrange_displays
+      screens = detect_screens
+      external = screens.find { !_1["isPrimary"] }
+      return warn("[mp] 外部ディスプレイが見つかりません。発表者ビューが全画面の裏に隠れたら、スペースを切り替えてください") unless external
+
+      primary = screens.find { _1["isPrimary"] } || screens.first
+      cdp = @browser.cdp
+      presenter = wait_for_presenter_target
+      audience = cdp.call("Browser.getWindowForTarget", { targetId: @target_id })
+      unless inside_screen?(audience["bounds"], external)
+        set_bounds(audience["windowId"], windowState: "normal")
+        sleep 1 # macOS の全画面解除アニメーションの間は移動できない
+        set_bounds(audience["windowId"], **screen_bounds(external))
+        sleep 0.3
+        set_bounds(audience["windowId"], windowState: "fullscreen") if @fullscreen
+      end
+      return unless presenter
+
+      window = cdp.call("Browser.getWindowForTarget", { targetId: presenter["targetId"] })["windowId"]
+      set_bounds(window, **screen_bounds(primary))
+    rescue Cdp::Error => e
+      warn "[mp] ウィンドウを配置できませんでした: #{e.message}"
+    end
+
+    def detect_screens
+      cdp = @browser.cdp
+      cdp.call("Browser.grantPermissions", { permissions: ["windowManagement"], origin: @server.origin })
+      expression = <<~JS
+        getScreenDetails().then((details) => JSON.stringify(details.screens.map((s) => ({
+          left: s.availLeft, top: s.availTop, width: s.availWidth, height: s.availHeight, isPrimary: s.isPrimary,
+        }))))
+      JS
+      reply = cdp.call("Runtime.evaluate", { expression: expression, awaitPromise: true, returnByValue: true, userGesture: true },
+                       session_id: @page_session)
+      JSON.parse(reply.dig("result", "value") || "[]")
+    end
+
+    def wait_for_presenter_target
+      50.times do
+        target = @browser.cdp.call("Target.getTargets")["targetInfos"].find { _1["url"] == @server.presenter_url }
+        return target if target
+
+        sleep 0.1
+      end
+      nil
+    end
+
+    def inside_screen?(bounds, screen)
+      bounds["left"].between?(screen["left"], screen["left"] + screen["width"] - 1) &&
+        bounds["top"].between?(screen["top"], screen["top"] + screen["height"] - 1)
+    end
+
+    def screen_bounds(screen) = screen.slice("left", "top", "width", "height").transform_keys(&:to_sym)
+
+    def set_bounds(window_id, **bounds)
+      @browser.cdp.call("Browser.setWindowBounds", { windowId: window_id, bounds: bounds })
+    end
+
+    def start_watcher
+      dir = File.dirname(File.expand_path(@path))
+      @listener = Listen.to(dir, only: /\.(md|markdown|css)\z/) { @server.reload }
+      @listener.start
+    end
+  end
+end

data/lib/mp/browser.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "json"
+require "net/http"
+require "tmpdir"
+require_relative "cdp"
+
+module Mp
+  # Chrome をアプリモードで起動し、CDP で接続する。
+  class Browser
+    class NotFound < StandardError; end
+
+    CANDIDATES = [
+      "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+      "/Applications/Chromium.app/Contents/MacOS/Chromium",
+      "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+      "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
+    ].freeze
+    COMMANDS = %w[google-chrome google-chrome-stable chromium chromium-browser microsoft-edge].freeze
+
+    attr_reader :cdp, :pid
+
+    def self.find_executable
+      return ENV["MP_BROWSER"] if ENV["MP_BROWSER"]
+
+      found = CANDIDATES.find { |path| File.executable?(path) }
+      found ||= COMMANDS.filter_map { |cmd|
+        ENV.fetch("PATH", "").split(File::PATH_SEPARATOR).map { |dir| File.join(dir, cmd) }
+           .find { |path| File.executable?(path) }
+      }.first
+      found or raise NotFound, "Chrome 系ブラウザが見つかりません。MP_BROWSER でパスを指定してください"
+    end
+
+    def initialize(url, fullscreen: true, profile: nil, headless: false, size: [1280, 720])
+      @url = url
+      @fullscreen = fullscreen
+      @headless = headless
+      @size = size
+      @temp_profile = profile.nil?
+      @profile = profile || Dir.mktmpdir("mp-chrome-")
+      FileUtils.mkdir_p(@profile)
+    end
+
+    def launch
+      args = [
+        "--user-data-dir=#{@profile}",
+        "--remote-debugging-port=0",
+        "--no-first-run",
+        "--no-default-browser-check",
+        "--disable-features=Translate",
+        "--window-size=#{@size.join(",")}"
+      ]
+      args << "--start-fullscreen" if @fullscreen && !@headless
+      args << "--headless=new" if @headless
+      args << (@headless ? @url : "--app=#{@url}") # ヘッドレスは --app を無視する
+
+      @pid = Process.spawn(self.class.find_executable, *args, out: File::NULL, err: File::NULL)
+      @cdp = Cdp.new(wait_for_debugger_url)
+      self
+    end
+
+    # 表示用ページに接続して session id を返す。起動直後はターゲットが無いことがあるので待つ
+    def attach_page
+      deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) + 15
+      loop do
+        target = @cdp.call("Target.getTargets")["targetInfos"].find do |info|
+          %w[page app].include?(info["type"]) && info["url"].start_with?(@url)
+        end
+        return @cdp.call("Target.attachToTarget", { targetId: target["targetId"], flatten: true })["sessionId"] if target
+        raise Cdp::Error, "ページを取得できません" if Process.clock_gettime(Process::CLOCK_MONOTONIC) > deadline
+
+        sleep 0.05
+      end
+    end
+
+    # 同じプロファイルで --app を起動すると、動いている Chrome にアプリウィンドウが増える
+    def open_window(url)
+      return @cdp.call("Target.createTarget", { url: url }) if @headless
+
+      Process.detach(Process.spawn(self.class.find_executable, "--user-data-dir=#{@profile}", "--app=#{url}",
+                                   out: File::NULL, err: File::NULL))
+    end
+
+    def wait
+      Process.wait(@pid)
+      @pid = nil
+    rescue Errno::ECHILD
+      @pid = nil
+    end
+
+    def close
+      @cdp&.close
+      if @pid
+        Process.kill("TERM", @pid)
+        Process.wait(@pid)
+      end
+    rescue Errno::ESRCH, Errno::ECHILD
+      nil
+    ensure
+      @pid = nil
+      FileUtils.rm_rf(@profile) if @temp_profile
+    end
+
+    private
+
+    def wait_for_debugger_url
+      port_file = File.join(@profile, "DevToolsActivePort")
+      deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) + 15
+      until File.size?(port_file)
+        raise Cdp::Error, "ブラウザの起動を確認できません" if Process.clock_gettime(Process::CLOCK_MONOTONIC) > deadline
+
+        sleep 0.05
+      end
+      port, path = File.read(port_file).lines.map(&:strip)
+      "ws://127.0.0.1:#{port}#{path}"
+    end
+  end
+end

data/lib/mp/cdp.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require "json"
+require "monitor"
+require "socket"
+require "uri"
+require "websocket/driver"
+
+module Mp
+  # Chrome DevTools Protocol の最小クライアント(flatten セッション前提)。
+  class Cdp
+    class Error < StandardError; end
+
+    attr_reader :url
+
+    def initialize(ws_url, timeout: 10)
+      @url = ws_url
+      @timeout = timeout
+      uri = URI(ws_url)
+      @socket = TCPSocket.new(uri.host, uri.port)
+      @write_lock = Monitor.new
+      @pending = {}
+      @pending_lock = Mutex.new
+      @next_id = 0
+      @handlers = Hash.new { |h, k| h[k] = [] }
+      @events = Queue.new
+
+      @driver = WebSocket::Driver.client(self, max_length: 256 * 1024 * 1024)
+      opened = Queue.new
+      @driver.on(:open) { opened << true }
+      @driver.on(:message) { |e| dispatch(JSON.parse(e.data)) }
+      @driver.on(:close) { @events.close }
+      @driver.start
+
+      @reader = Thread.new { read_loop }
+      # ハンドラ内から call しても reader を塞がないよう、イベントは別スレッドで処理する
+      @worker = Thread.new { event_loop }
+      opened.pop(timeout: @timeout) or raise Error, "CDP に接続できません: #{ws_url}"
+    end
+
+    # websocket-driver が呼ぶ
+    def write(data)
+      @write_lock.synchronize { @socket.write(data) }
+    end
+
+    def on(method, &block)
+      @handlers[method] << block
+    end
+
+    def on_close(&block)
+      @on_close = block
+    end
+
+    def call(method, params = {}, session_id: nil)
+      reply = Queue.new
+      id = @pending_lock.synchronize do
+        @next_id += 1
+        @pending[@next_id] = reply
+        @next_id
+      end
+      message = { id: id, method: method, params: params }
+      message[:sessionId] = session_id if session_id
+      @write_lock.synchronize { @driver.text(JSON.generate(message)) }
+
+      response = reply.pop(timeout: @timeout)
+      raise Error, "CDP タイムアウト: #{method}" unless response
+      raise Error, "#{method}: #{response["error"]["message"]}" if response["error"]
+
+      response["result"]
+    ensure
+      @pending_lock.synchronize { @pending.delete(id) }
+    end
+
+    # 応答を待たない呼び出し。ターゲットが消えた後の失敗は無視してよい場面で使う
+    def cast(method, params = {}, session_id: nil)
+      message = { id: 0, method: method, params: params }
+      message[:sessionId] = session_id if session_id
+      @write_lock.synchronize { @driver.text(JSON.generate(message)) }
+    rescue IOError, SystemCallError
+      nil
+    end
+
+    def close
+      @socket.close
+    rescue IOError, SystemCallError
+      nil
+    end
+
+    private
+
+    def read_loop
+      loop { @driver.parse(@socket.readpartial(65_536)) }
+    rescue IOError, SystemCallError
+      @events.close
+    end
+
+    def dispatch(message)
+      if message.key?("id")
+        reply = @pending_lock.synchronize { @pending[message["id"]] }
+        reply&.push(message)
+      else
+        @events << message
+      end
+    rescue ClosedQueueError
+      nil
+    end
+
+    def event_loop
+      while (event = @events.pop)
+        @handlers[event["method"]].each do |handler|
+          handler.call(event["params"], event["sessionId"])
+        rescue Error, IOError, SystemCallError => e
+          warn "[mp] CDP: #{e.message}" if ENV["MP_DEBUG"]
+        end
+      end
+      @on_close&.call
+    end
+  end
+end

data/lib/mp/cli.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "optparse"
+require_relative "../mp"
+
+module Mp
+  module Cli
+    def self.run(argv)
+      options = { fullscreen: true, watch: true }
+      parser = OptionParser.new do |o|
+        o.banner = "使い方: mp [オプション] deck.md"
+        o.on("-w", "--window", "全画面にせずウィンドウで開く") { options[:fullscreen] = false }
+        o.on("-P", "--presenter", "発表者ビューも開く(外部ディスプレイがあれば聴衆画面をそちらへ移す)") { options[:presenter] = true }
+        o.on("-p", "--port PORT", Integer, "ローカルサーバのポート(既定: 空きポート)") { options[:port] = _1 }
+        o.on("--profile DIR", "Chrome のプロファイルを保存する(埋め込みページのログインを保持)") { options[:profile] = _1 }
+        o.on("--no-watch", "ファイル変更時に再読み込みしない") { options[:watch] = false }
+        o.on("-v", "--version") { puts VERSION; return 0 }
+      end
+      path = parser.parse(argv).first
+      unless path && File.file?(path)
+        warn(path ? "ファイルが見つかりません: #{path}" : parser.help)
+        return 1
+      end
+
+      app = App.new(path, **options)
+      %w[INT TERM].each { |signal| trap(signal) { app.request_stop } }
+      app.start
+      app.wait
+      app.stop
+      0
+    rescue Browser::NotFound, OptionParser::ParseError, Cdp::Error => e
+      warn e.message
+      1
+    end
+  end
+end