Troubleshooting

`tdsl` が見つからない

インストール後に tdsl --help が実行できない場合は、インストール先が PATH に含まれているか確認します。

which tdsl
tdsl --help

インストールスクリプトを使った場合、既定の配置先は ~/.local/bin/tdsl です。

export PATH="${HOME}/.local/bin:${PATH}"

まず check で構文・意味チェックを実行します。パース結果を確認したい場合は ast を使います。

tdsl check sample.tdsl
tdsl ast sample.tdsl

lint は未定義lane参照、重複id、start > end、空label、タグの空要素・重複などを検出します。安全に直せる項目は --fix で修正できます。

tdsl lint sample.tdsl
tdsl lint sample.tdsl --fix

CIや別ツールで扱う場合はJSON形式にします。

tdsl lint sample.tdsl --format json

Wikidata import を含むファイルでネットワークやキャッシュの影響を避けたい場合は、--offline で静的項目だけを処理します。

tdsl build sample.tdsl --offline --pretty
tdsl render sample.tdsl --offline --output sample.html

最新データを取り直したい場合は --no-cache、キャッシュTTLを変えたい場合は --cache-ttl <秒> を指定します。

tdsl build sample.tdsl --no-cache --pretty
tdsl build sample.tdsl --cache-ttl 0 --pretty

render の表示オプションを調整します。

tdsl render sample.tdsl \
  --output sample.html \
  --scale 5 \
  --lane-height 80 \
  --theme dark

独自CSSを追加する場合は --custom-css を使います。

Playground はブラウザ内で WASM を実行します。「Loading…」のまま動かない、または描画されない場合は、まずブラウザの開発者ツールの Console / Network タブを開きます。

WASM ファイルのリクエストが 200 で返り、レスポンスの Content-Type が application/wasm になっているか確認します。application/octet-stream などで配信されているとブラウザが streaming compile に失敗します。
社内プロキシや広告ブロッカーが .wasm のリクエストを遮断していないか確認します。
Console に出ているエラーメッセージ（CompileError / LinkError など）をそのまま確認し、ネットワーク要因か実行時要因かを切り分けます。

デプロイ直後に古い結果が表示される場合は、キャッシュが原因です。

ハードリロード（macOS: Cmd+Shift+R / Windows: Ctrl+Shift+R）でブラウザキャッシュを無視して再取得します。
それでも直らない場合は、開発者ツールの Application タブから当該サイトの Cache Storage / Service Worker をクリアします。
新しい DSL 構文を試していて parse エラーになる場合は、Playground が読み込む WASM が古い可能性があります。最新のデプロイが反映されているかを確認してください。

Playground は WebAssembly を必須とします。モダンな Chrome / Edge / Firefox / Safari では動作しますが、WebAssembly を無効化した環境や、極端に古いブラウザでは動きません。