iframe から、丸型の共有ボタンと「いいね」へ。Promari SNS Share を公開しました。

PROMARI JOURNAL · SERIES

連載の目次 全16章 / 62回の予定

1. 第1章丸いボタンから責務を切る――変更理由と設計判断
   1. 1.1共有・保存・計測は、なぜ同じ責務にしないのか
   2. 1.2共有先が増えても触らないコードを決める
   3. 1.3ADRに残すのは結論より、捨てた案と制約
2. 第2章SOLIDは変更に耐えるか――サービス追加で契約を試す
   1. 2.1SRPとOCP――サービスを一つ足したときの差分を追う
   2. 2.2LSP――Copyに「開くURL」を要求すると何が壊れるか
   3. 2.3ISPとDIP――必要な能力だけをポートにする
   4. 2.4ServiceRegistry――明示登録と自動探索を比較する
3. 第3章ブラウザ抜きで動かす――Ports and Adaptersの境界
   1. 3.1値オブジェクト――共有URLを状態変更から守る
   2. 3.2ユースケース――操作の判断と副作用を引き離す
   3. 3.3ポートの契約――APIの形だけでなく失敗を揃える
   4. 3.4Composition Root――具体実装をどこで選ぶか
4. 第4章型が通るのに壊れる――TypeScriptの境界を詰める
   1. 4.1strictとnull――状態が未確定の時間を型へ持ち込む
   2. 4.2Discriminated Unionとnever――分岐漏れを検出する
   3. 4.3Mapped Types――設定キーと値の対応を崩さない
   4. 4.4unknownから検証する――JSONにasだけでは足りない
5. 第5章PHPの契約を磨く――不変性とURLエンコードの落とし穴
   1. 5.1final・readonly・Enum――変更を許す範囲を決める
   2. 5.2RFC 3986――二重エンコードとHTMLエスケープを分ける
   3. 5.3PHPからTypeScriptへ――サービス定義の二重管理をやめる
6. 第6章生成したのに古い――TOMLから配布物までの整合性
   1. 6.1設定の正本――サービス定義とサイト設定を分担する
   2. 6.2スキーマ検証――未知キーを黙って通さない
   3. 6.3Deep Merge――配列の上書き順で表示が変わる理由
   4. 6.4決定的な生成――再生成差分でドリフトを捕まえる
7. 第7章タグ一つで持ち運ぶ――Web Componentsの公開契約
   1. 7.1whenDefined――要素の登録とデータの準備を分ける
   2. 7.2属性・メソッド・イベント――何を互換性の対象にするか
   3. 7.3Shadow DOM――retargetingとcomposedの経路を追う
   4. 7.4再接続と再描画――イベントリスナーを増殖させない
8. 第8章awaitの先は成功とは限らない――共有APIの非同期処理
   1. 8.1Promiseの拒否――エラーを握り潰すと何が観測できないか
   2. 8.2Clipboard API――成功表示と手動コピーの境界
   3. 8.3Web Share――ユーザー操作・キャンセル・フォールバック
   4. 8.4requestAnimationFrame――スクロール監視と描画を分ける
9. 第9章見えているだけでは使えない――操作と描画の契約
   1. 9.1aria-pressedとaria-live――状態同期と通知の重複を分ける
   2. 9.2フォーカス管理――Escapeの後、どこへ戻すか
   3. 9.3SVGと動的描画――信頼できる定義と外部入力を分ける
10. 第10章いいねはカウンターではない――非同期UIを状態機械にする
    1. 10.1未取得・保存中・失敗――booleanの組み合わせを減らす
    2. 10.2setLikeState――希望状態と確定状態の境界
    3. 10.3冒頭と末尾の同期――連打と遅延応答をどう扱うか
    4. 10.4楽観的更新か確定後更新か――失敗時の戻し方を比べる
11. 第11章WordPressへ閉じ込めない――テーマと部品の接続設計
    1. 11.1actionとfilter――フックが呼ばれる文脈を追う
    2. 11.2共有欄の二重表示――配置の所有者を一つにする
    3. 11.3会員・記事・ページ――接続側へ残すデータと責任
    4. 11.4分割記事のコメント――ページ別表示と最終ページの集約
12. 第12章二重に増えないAPIへ――会員・匿名識別と冪等性
    1. 12.1GETとPOST――取得で票を移さないHTTP契約
    2. 12.2会員IDと署名Cookie――ログイン前後の票をどう扱うか
    3. 12.3nonceは認可ではない――Origin・公開範囲・要求の検証
    4. 12.4GET_LOCKとトランザクション――票と操作履歴を揃える
    5. 12.5レート制限と集計――現在の票・操作回数・実人数の違い
13. 第13章そのクリック、何の数字？――イベントと同意管理
    1. 13.1操作・成功・投稿完了――計測できる事実を限定する
    2. 13.2CustomEvent――DOMの構造を計測APIにしない
    3. 13.3同意前の保留と拒否時の破棄――GA4送信の境界
    4. 13.4UTMとイベント――流入数と共有操作数が一致しない理由
14. 第14章緑のテストを疑う――契約・競合・ブラウザを検証する
    1. 14.1URL生成と保存API――失敗を切り分けるテストの層
    2. 14.2テストダブル――本番アダプターとの契約ずれを防ぐ
    3. 14.3DockerとPlaywright――会員操作とページ間集約を通す
    4. 14.4再送・失敗・後始末――状態を残さず再現する
15. 第15章同じ版を本当に配れるか――モノレポからCDNまで
    1. 15.1pnpm workspace――開発の共有とリリース単位を分ける
    2. 15.2型検査とバンドル――build成功が保証しないこと
    3. 15.3SemVerとタグ――属性やイベントの変更も公開APIとして扱う
    4. 15.4バージョン固定・SRI・CORS――URLと内容をセットで検証する
16. 第16章配備成功の、その先へ――本番との差分を閉じる
    1. 16.1GitHub Actions――テスト失敗と未実行を区別する
    2. 16.2set -eだけに頼らない――シェルの終了状態を検証する
    3. 16.3SSHとハッシュ照合――送る差分と戻せる範囲を決める
    4. 16.4DB・画像・キャッシュ――HTTP 200の先を読み戻す

一つの問いを、一回ずつ。回数は内容に合わせて調整します。