v0.21

フロントエンドパイプライン

はじめに

webpackやviteのような外部ツールに依存する従来のフレームワークとは異なり、dframeworkには独自の高度に特化した設定不要のビルドパイプラインとフロントエンドランタイムが含まれています。ビルドパイプラインは未使用のCSSを削除し、クラス名を難読化し、ビューやルートを高速な内部表現にコンパイルします。同時に、フロントエンドのクライアントランタイム(dstrn.js)はブラウザー内で透過的な最適化を実行し、ネットワーク使用を合理化し、画面外リソースをスロットリングし、メモリリークを防止します。

ビルドパイプライン

パイプラインはアプリケーションがproduction環境で起動したときに自動的に実行されます。viewsディレクトリとroutesディレクトリのフィンガープリントを計算します。前回のビルド以降フィンガープリントに変更がない場合(storage/framework/pipeline.jsonで追跡)、パイプラインはキャッシュされた生成物を即座に読み込み、起動時間を数ミリ秒に短縮します。

変更が検出された場合、パイプラインは3つの主要フェーズ(ビューコンパイル、CSS最適化、ルートコンパイル)を実行します。

ビューのコンパイル

第1フェーズではすべての.dビューテンプレートを生のjavascript関数(.dcファイル)にコンパイルします。これらのコンパイル済みファイルはstorage/framework/viewsに保存されます。

NOTE

コンパイルされた`.dc`ビューは`manifest.json`内の暗号論的HMACで署名されます。実行時にフレームワークはこれらの署名を検証し、コンパイル済みビューが改ざんされていないことを保証します。

cssの最適化と難読化

ビューのコンパイルが完了すると、パイプラインは.dcファイルと公開javascriptファイルをスキャンしてプロジェクト内で使用されているすべてのCSSクラス名を抽出します。

その後CSSオプティマイザーはフレームワークのユーティリティCSSを以下のステップで処理します:

  1. ツリーシェイキング: ビューやjavascript内で見つからないユーティリティクラスは完全に削除されます。
  2. 難読化: 保持されたすべてのユーティリティクラスは短くランダムな文字列シーケンスに名前が変更されます(例: mt-4はabになります)。
  3. 書き換え: オプティマイザーはコンパイル済みの.dcビューおよび公開javascriptファイルを直接編集し、元のクラス名を難読化されたクラス名に置き換えます。
  4. 整合性更新: 変更された.dcファイルの新しい暗号署名によってmanifest.jsonが自動更新されます。
  5. 最小化: 基本CSS、難読化されたユーティリティ、アイコン、コンポーネント、およびカスタムCSSがバンドルされstorage/framework/public/css/dstrn.cssに最小化されます。

オプティマイザーは標準のclass=""属性、:class、x-bind:class、v-bind:classなどの動的バインディング、およびjavascriptのclassList操作内のクラスを正常に識別して書き換えます。

デバッグ目的で元のクラス名と難読化されたクラス名の対応関係をマッピングしたcss-map.jsonファイルがstorage/frameworkディレクトリに書き出されます。

動的クラスのセーフリスト登録

OPTIMIZE_CSSまたはcss.optimizeがtrueの場合、ユーティリティクラスは.dビューおよび公開javascript内の静的な使用状況に基づいてツリーシェイクおよび難読化されます。クラスを動的に構築したり実行時に生成したりする場合は、バンドル内で保持され難読化されないようにセーフリストに登録できます:

config/app.jsのcss.safelist配列に正確なクラス名、末尾が*のワイルドカード文字列、または正規表現を指定します:

1export default {
2 css: {
3 optimize: Env.value('OPTIMIZE_CSS', true),
4 safelist: ['card', 'badge-*', /^nav-/],
5 },
6};

css最適化のオプトアウト

CSSの最小化、ツリーシェイキング、難読化を完全にスキップしたい場合は、config/app.jsの設定を更新してオプトアウトできます。

1export default {
2 css: {
3 optimize: Env.value('OPTIMIZE_CSS', true),
4 },
5};

最適化が無効になっている場合でもパイプラインはコアCSSとユーザーCSSファイルを単一のdstrn.cssペイロードに結合しますが、クラス名の難読化や書き換えは行いません。

ルートのコンパイル

最後にRouteCompilerがルート定義と対応するコントローラーハンドラーをスキャンします。ソースコードを解析して各ルートに必要なミドルウェア、依存関係、ペイロードタイプを正確に特定します。

このデータは高度に最適化されたルートキャッシュ(storage/framework/routes)にコンパイルされ、受信HTTPリクエストに対する実行時のリフレクションや依存関係の解決を完全にスキップします。

ランタイムパフォーマンスの最適化

ビルド時の最適化に加えて、dstrn.jsのフレームワークランタイムはブラウザー内で複数のパフォーマンス最適化を透過的に適用します。これらの最適化は手動設定や開発者の介入を必要とせず自動的に実行されます。

画面外リソースのスロットリング

ランタイムは120pxのバッファを持つインターセクションオブザーバーを初期化し、主要なレイアウトセクション(header、section、article、main、footer、aside、.section-frame、[d-section]、[data-section])、SVGアニメーション(animate、animateMotion、animateTransform)、およびd-pause-offscreenが付与された要素を監視します。

監視対象の要素がビューポート外に移動したとき:

  1. 要素にd-paused属性が付与されます。
  2. 要素上でd-pauseカスタムイベントが送出されます。
  3. 要素内のアクティブなSVGアニメーションがpauseAnimations()によって一時停止されます。
  4. 再生中のHTML5 <video>または<audio>要素が一時停止され、自動再開の対象としてマークされます。

要素がビューポートに再び入ったとき:

  1. d-paused属性が削除されます。
  2. 要素上でd-resumeカスタムイベントが送出されます。
  3. SVGアニメーションがunpauseAnimations()によって自動的に再開されます。
  4. オプティマイザーによって一時停止されていたメディア要素の再生が自動的に再開されます。

<canvas>または<d-drawer>要素を含む要素は画面外スロットリングから自動的に除外されます。またd-no-optimize属性を追加することで任意の要素またはサブツリーをオプトアウトできます。

透過的なcsrf管理

ランタイムは同一オリジンの変更系HTTPリクエスト(POST、PUT、PATCH、DELETE)をインターセプトするためにwindow.fetchをラップします。リクエストにX-CSRF-TOKENヘッダーがまだ含まれていない場合、ランタイムはドキュメントhead内の<meta name="csrf-token">タグからトークンを抽出し自動的に添付します。

シングルページアプリケーションのナビゲーション時、ランタイムはサーバーレスポンスから最新のcsrf-tokenおよびshield-challengeメタタグを抽出し手動のステート管理なしで現在のドキュメントheadと同期します。

二重送信のロック

<d-form>を利用したフォームは偶発的な重複送信や競合状態を自動的に防止します。submitイベントの送出時にフォームは内部的な送信ロックを設定しネストされたすべてのインタラクティブコントロール(input、textarea、select、button)を無効化します。

コントロールはバリデーションおよびネットワーク転送の間無効化されたままとなり、レスポンスが処理されるかバリデーションエラーが表示された後にのみ再度有効化されます。

ナビゲーションのファストパスとリクエストのキャンセル

ナビゲーションランタイムはシングルページアプリケーションの遷移中におけるネットワークアクティビティを最適化します:

  1. リクエストの重複排除: 同じ遷移先URLへの同時ナビゲーションリクエストは重複したネットワークリクエストを発行するのではなく実行中のアクティブなプロミスを再利用します。
  2. リクエストのキャンセル: 新しいナビゲーションを開始するとAbortControllerを使用して先行する処理中のナビゲーションフェッチが自動的に中止され、古いレスポンスが新しいページコンテンツを上書きするのを防ぎます。
  3. 同一ページハッシュのファストパス: 現在のページ上のハッシュを指すアンカー(例: /にいるときの/#features)をクリックするとネットワークフェッチを完全にスキップし対象要素をビューまでスクロールしてブラウザー履歴を同期します。

domモーフィングとペイロードハッシュ化

ページコンテンツの更新時、ランタイムはインプレースDOMモーフィングアルゴリズムを使用することで破壊的な内部HTML置換を回避します。モーフィング処理は変更された属性、テキストノード、フォームコントロール状態(input、textarea、select、option)のみを更新し、アクティブ要素のフォーカス、テキスト選択、スクロール位置を保持します。

リアルタイムのリアクティブ更新向け:

  1. ペイロードのハッシュ化: 受信したd-wire:render更新はレンダリングされたHTML文字列の32ビットハッシュ(__wire_last_hash)を計算します。ペイロードが現在のハッシュと一致する場合、DOMモーフィングは完全にスキップされます。
  2. 局所更新のデバウンス: 冗長な再フェッチを防ぐためd-liveモデルの更新は100ミリ秒デバウンスされ、フォーム送信の成功後250ミリ秒間は抑制されます。

自動スコープライフサイクルとクリーンアップ

差し替えられた各ビューコンテナーは分離されたライフサイクル認識スコープ内でスクリプトを実行します。常駐するMutationObserverが要素の削除をドキュメントツリーで監視します。

コンテナー要素がDOMから削除されると、そのスコープは自動的に破棄されます。ランタイムはすべてのアクティブなタイムアウト(clearTimeout)、インターバル(clearInterval)、アニメーションフレーム(cancelAnimationFrame)をクリアし、AbortControllerを通じて保留中のスコープ付きfetchリクエストを中止し、アタッチされたすべてのイベントリスナーとソケット購読を解除します。

ローカル開発環境ではランタイムがナビゲーションをまたいだスコープの存続を監視し、有効なDOMノードに紐づかない孤立したスコープが存続している場合に警告を発します。

誤操作によるナビゲーション防止ガード

ランタイムはBackspaceキーのグローバルキーボードハンドラーを登録します。編集可能なフォームコントロール(テキスト入力、textarea、またはisContentEditable要素など)にフォーカスがない状態でユーザーがBackspaceキーを押した場合、意図しないデータ損失を防ぐためブラウザーのデフォルトの履歴バックナビゲーションが防止されます。