Alexandru-Ștefan Gârleanu
diff --git a/src/content/docs/ja/internals/versioning.mdx b/src/content/docs/ja/internals/versioning.mdx
index c1ad7629f..54c267fa5 100644
--- a/src/content/docs/ja/internals/versioning.mdx
+++ b/src/content/docs/ja/internals/versioning.mdx
@@ -41,3 +41,7 @@ Biomeは[セマンティックバージョニング](https://semver.org/)に従
Visual Studio Codeは、拡張機能について[プレリリースタグをサポートしていません](https://code.visualstudio.com/api/working-with-extensions/publishing-extension#prerelease-extensions)。そのため、Biomeは以下のバージョンスキーマを使用して安定版とプレビュー版を区別します：
* 安定版リリースは偶数のバージョン番号を使用します：10, 12, 14, 16, ...
* プレビュー版は奇数のバージョン番号を使用します：11, 13, 15, 17, ...
+
+## バージョンの固定が重要な理由
+
+すべてのチームメンバーとCI環境で同じバージョンのBiomeを使用することを保証するために、 `package.json` でBiomeのバージョンを固定することが重要です。パッチリリースであっても、フォーマットやリントの結果がわずかに変わることがあります。
diff --git a/src/content/docs/ja/recipes/continuous-integration.mdx b/src/content/docs/ja/recipes/continuous-integration.mdx
index 6aca41e43..5ba3b3816 100644
--- a/src/content/docs/ja/recipes/continuous-integration.mdx
+++ b/src/content/docs/ja/recipes/continuous-integration.mdx
@@ -5,6 +5,18 @@ description: CI環境でのBiomeの使用
CI環境でBiomeを動作させることは簡単です。以下の例を参考にしてください。
+### `biome check` VS `biome ci`
+
+Biomeは、すべてのチェックを実行するための2つのCLIコマンドを提供しています： `biome check` と `biome ci` です。ただし、CI（継続的インテグレーション）環境では後者を使用する必要があります。
+
+`check` コマンドと比較して、 `ci` コマンドは：
+- `--write` / `--fix` オプションを提供しません。
+- 特定のランナーとより良く統合します。たとえば、GitHubで実行すると、診断はGitHubアノテーションを使用して出力されます。
+- スレッド数を制御できます。
+- VCS統合が有効な場合、リモートリポジトリには「ステージされたファイル」の概念がないため、 `--staged` の代わりに `--changed` フラグを使用します。
+
+時間の経過とともに、 `ci` コマンドはさらに多くの機能を受け取ります。
+
## GitHub Actions
Biomeをランナーにセットアップするためのファーストパーティ[GitHub Action](https://github.com/marketplace/actions/setup-biome)を提供します。
@@ -35,6 +47,18 @@ jobs:
run: biome ci .
```
+Biome設定に外部の依存関係がある場合（例：パッケージから設定を拡張している場合）、Biomeを実行する前にNode.jsをセットアップし、好みのパッケージマネージャーを使用して依存関係をインストールする必要があります：
+
+```yaml
+- name: Setup Node.js
+ uses: actions/setup-node@v4
+ with:
+ node-version: 22 # または好みのバージョン
+ cache: "npm" # または 'yarn', 'pnpm'
+- name: Install dependencies
+ run: npm ci # または yarn install --frozen-lockfile, pnpm install --frozen-lockfile
+```
+
### サードパーティーアクション
他のコミュニティによって維持されているアクションも使用できます：
@@ -58,3 +82,30 @@ jobs:
github_token: ${{ secrets.github_token }}
reporter: github-pr-review
```
+
+## GitLab CI
+
+以下は設定例です：
+
+```yaml title=".gitlab-ci.yml"
+# パイプラインステージの定義
+stages:
+ - quality
+
+# Lintジョブの設定：Biomeを使用してコード品質チェックを実行
+lint:
+ image:
+ name: ghcr.io/biomejs/biome:latest # 最新のBiome Dockerイメージを使用
+ entrypoint: [""] # GitLab CIでイメージを動作させるために必要
+ stage: quality # qualityステージで実行
+ script:
+ - biome ci --reporter=gitlab --colors=off > /tmp/code-quality.json
+ - cp /tmp/code-quality.json code-quality.json
+ artifacts:
+ reports:
+ codequality:
+ - code-quality.json # コード品質レポートのアーティファクトを収集
+ rules:
+ - if: $CI_COMMIT_BRANCH # ブランチへのコミットに対してジョブを実行
+ - if: $CI_MERGE_REQUEST_ID # マージリクエストに対してジョブを実行
+```
diff --git a/src/content/docs/ja/reference/configuration.mdx b/src/content/docs/ja/reference/configuration.mdx
index 9be1e8e75..67f3da536 100644
--- a/src/content/docs/ja/reference/configuration.mdx
+++ b/src/content/docs/ja/reference/configuration.mdx
@@ -97,7 +97,7 @@ Biomeは、これらのパターンに一致するファイルやフォルダの
#### スキャナーとの相互作用
-Biomeには[スキャナー](/internals/architecture/#scanner)があり、ネストされた設定ファイルや `.gitignore` ファイルを検出します。また、
+Biomeには[スキャナー](/ja/internals/architecture/#スキャナー)があり、ネストされた設定ファイルや `.gitignore` ファイルを検出します。また、
[プロジェクトドメイン](/linter/domains/#project)の1つ以上のルールが有効になっている場合、ソースファイルをインデックス化することもできます。
スキャナーは `files.includes` と `.gitignore` ファイルからの無視パターンの両方を尊重しますが、注意すべき2つの例外があります：
diff --git a/src/content/docs/ja/reference/gritql.mdx b/src/content/docs/ja/reference/gritql.mdx
index 3f730f253..bcff1f475 100644
--- a/src/content/docs/ja/reference/gritql.mdx
+++ b/src/content/docs/ja/reference/gritql.mdx
@@ -1,5 +1,5 @@
---
-title: GritQL [実験的機能]
+title: GritQL
description: BiomeにおけるGritQLの基本的な使い方
---
@@ -9,10 +9,18 @@ GritQLは、ソースコードの構造検索を実行するためのクエリ
GritQLは[オープンソース](https://github.com/getgrit/gritql/)であり、[Grit.io](https://grit.io/)によって作成されました。
-BiomeはGritQLを2つの目的で統合しています：
+## サポートされている言語
-- IDE拡張機能にも拡張したいと考えている、[`biome search`](/reference/cli/#biome-search) コマンド
-- 現在進行中の、プラグインへの取り組み
+BiomeのGritQLは現在、以下のターゲット言語をサポートしています：
+
+- **JavaScript/TypeScript**: `language js`（オプションのフレーバー：`typescript`、`jsx`）
+- **CSS**: `language css`
+- **JSON**: `language json`
+
+BiomeはGritQLを2つの目的で使用しています：
+
+- [アナライザープラグイン](/ja/linter/plugins)
+- [`biome search`](/reference/cli/#biome-search)コマンド。これはIDE拡張機能にも拡張したいと考えています
## パターン
@@ -90,6 +98,58 @@ GritQLクエリでは変数も使用できます。
}
```
+## Biomeの構文ノードとのマッチング
+
+より正確なクエリを行うために、Biome内部の構文ノードに直接マッチさせることができます。各ノードは一意の `PascalCase` 名で識別されます。
+
+たとえば、すべてのJavaScript `if` 文を見つけるには、 `JsIfStatement` ノードとマッチさせることができます：
+
+```grit
+engine biome(1.0)
+language js(typescript,jsx)
+
+JsIfStatement() as $stmt where {
+ register_diagnostic(
+ span=$stmt,
+ message="Found an if statement"
+ )
+}
+```
+
+コードのノード名を調べるには、[Biome Playground](https://biomejs.dev/playground/)で構文ツリーを探索できます。利用可能なすべてのノードの完全なリストは、Biomeリポジトリの [`xtask/codegen`](https://github.com/biomejs/biome/tree/main/xtask/codegen) ディレクトリにある `.ungram` ファイルでも確認できます。
+
+:::caution
+Biomeの文法はバージョン間で変更される可能性があり、特に新しい言語では変更が多いです。これにより、ノード名が変更される可能性があり、パターンが壊れる可能性があります。Biomeをアップグレードする際は、クエリを更新する準備をしてください。
+:::
+
+## JSONパターン
+
+GritQLはJSONファイル内のパターンをマッチさせることができ、設定ファイルの検索と変換に役立ちます：
+
+```grit
+language json
+
+`"foo": $value`
+```
+
+このパターンは、キー `"foo"` を持つ任意のJSONメンバーにマッチします。
+
+より正確なマッチングには、BiomeのJSON構文ノードを直接使用できます：
+
+```grit
+language json
+
+JsonMember(name = JsonMemberName(value = `"version"`))
+```
+
+JSON GritQLは、既存のGritパターンとの互換性のために、TreeSitter互換のノードエイリアスもサポートしています：
+
+| Biome AST | TreeSitterエイリアス |
+|-----------|------------------|
+| `JsonMember` | `pair` |
+| `JsonObjectValue` | `object` |
+| `JsonArrayValue` | `array` |
+
## 言語ドキュメント
GritQLとその構文については、公式の [GritQL 言語ドキュメント](https://docs.grit.io/language/overview)を参照してください。
diff --git a/src/content/docs/ja/reference/vscode.mdx b/src/content/docs/ja/reference/vscode.mdx
index 420355dfe..16a46a6c8 100644
--- a/src/content/docs/ja/reference/vscode.mdx
+++ b/src/content/docs/ja/reference/vscode.mdx
@@ -139,6 +139,40 @@ Biome拡張機能は、[サポートされているファイルタイプ](/ja/in
この設定を有効にするには、`biome.enabled`設定を同じスコープで`true`（デフォルト）に設定する必要があります。
:::
+### `biome.inlineConfig`
+
+Biome設定のインラインバージョン。この設定のオプションは、ディスクから読み取られた `biome.json` ファイル（またはデフォルト値）のオプションを上書きします。
+
+例えば、プロジェクトで `noConsole` ルールを `error` の重大度で有効にしているとします：
+
+```json title="biome.json"
+{
+ "linter": {
+ "rules": {
+ "suspicious": {
+ "noConsole": "error"
+ }
+ }
+ }
+}
+```
+
+しかし、ローカル開発中は、このルールが便利で赤い波線を見たくないため、このルールを無効にしたいとします。 `inlineConfig` には、次のように記述します：
+
+```json title=".vscode/settings.json"
+{
+ "biome.inlineConfig": {
+ "linter": {
+ "rules": {
+ "suspicious": {
+ "noConsole": "off"
+ }
+ }
+ }
+ }
+}
+```
+
### `biome.lsp.bin`
**デフォルト:** `undefined` | **スコープ:** `global`, `workspace`, `workspace folder`
diff --git a/src/content/docs/ja/reference/zed.mdx b/src/content/docs/ja/reference/zed.mdx
index 832bc7294..ff57ed9a9 100644
--- a/src/content/docs/ja/reference/zed.mdx
+++ b/src/content/docs/ja/reference/zed.mdx
@@ -7,17 +7,37 @@ description: BiomeのZed拡張機能
Zed >= **v0.131.0** が必要です。
-この拡張機能は、Zedエディタで利用できます。 `zed: extensions` を開き、 _Biome_ と検索してください。
+この拡張機能は、Zedエディタの拡張機能ビューで利用できます。 `zed: extensions` を開き、 _Biome_ を検索してください。内部でBiomeバイナリを実行し、以下の順序でBiomeのインストールを確認します：
+
+1. Zedの設定で指定されたパス、例えば：
+ ```json title='.zed/settings.json'
+ {
+ "lsp": {
+ "biome": {
+ "binary": {
+ "path": "/var/biome-2.2.3/bin/biome",
+ "arguments": [
+ "lsp-proxy"
+ ]
+ }
+ }
+ }
+ }
+ ```
+2. `package.json` 経由でローカルにインストールされたBiome
+3. `PATH` にシステム全体にインストールされたBiome
+
+いずれも存在しない場合、Biomeを `npm` でインストールして使用するようZedに依頼します。
## 設定
-デフォルトでは、biome.jsonファイルは **ワークスペースのルート** に配置する必要があります。
+### `config_path`
-それ以外の場合は、LSP設定を通じて構成できます。
+デフォルトでは、設定ファイルは**ワークスペースのルート**に配置する必要があります。
+それ以外の場合は、LSP設定を通じて構成できます：
-```jsonc
-// settings.json
+```json5 title=".zed/settings.json"
{
"lsp": {
"biome": {
@@ -29,68 +49,156 @@ Zed >= **v0.131.0** が必要です。
}
```
-### フォーマット
+### `require_config_file`
-言語サーバーをフォーマッタとして使用するには、設定でbiomeをフォーマッタとして指定してください。
+プロジェクトに設定ファイルが含まれている場合にのみBiomeを有効にします：
-```jsonc
-// settings.json
+> デフォルト: `false`
+
+```json5 title=".zed/settings.json"
{
- "formatter": {
- "language_server": {
- "name": "biome"
+ "lsp": {
+ "biome": {
+ "settings": {
+ "require_config_file": true
+ }
}
}
}
```
-### biome.jsonが存在する場合にのみbiomeを有効にする
+### `inline_config`
-```jsonc
-// settings.json
+Biome設定のインラインバージョン。この設定のオプションは、ディスクから読み取られた `biome.json` ファイル（またはデフォルト値）のオプションを上書きします。
+
+例えば、プロジェクトで `noConsole` ルールを `error` の重大度で有効にしているとします：
+
+```json title="biome.json"
+{
+ "linter": {
+ "rules": {
+ "suspicious": {
+ "noConsole": "error"
+ }
+ }
+ }
+}
+```
+
+しかし、ローカル開発中は、このルールが便利で赤い波線を見たくないため、このルールを無効にしたいとします。 `inline_config` には、次のように記述します：
+
+```json title=".zed/settings.json"
{
"lsp": {
"biome": {
"settings": {
- "require_config_file": true
+ "inline_config": {
+ "linter": {
+ "rules": {
+ "suspicious": {
+ "noConsole": "off"
+ }
+ }
+ }
+ }
}
}
}
}
```
-### プロジェクトベースの設定
-すべてのプロジェクトでbiomeの実行を除外したい場合は、次の手順に従ってください。
+## フォーマット
-1. ユーザー設定でbiome言語サーバーを無効にする。
+言語サーバーをフォーマッタとして使用するには、設定で `biome` をフォーマッタとして指定してください：
-```jsonc
-// settings.json
+```json5 title=".zed/settings.json"
{
- "language_servers": [ "!biome", "..." ]
+ "languages": {
+ "Astro": { "formatter": { "language_server": { "name": "biome" } } },
+ "CSS": { "formatter": { "language_server": { "name": "biome" } } },
+ "GraphQL": { "formatter": { "language_server": { "name": "biome" } } },
+ "HTML": { "formatter": { "language_server": { "name": "biome" } } },
+ "JSON": { "formatter": { "language_server": { "name": "biome" } } },
+ "JSONC": { "formatter": { "language_server": { "name": "biome" } } },
+ "JSX": { "formatter": { "language_server": { "name": "biome" } } },
+ "JavaScript": { "formatter": { "language_server": { "name": "biome" } } },
+ "Svelte": { "formatter": { "language_server": { "name": "biome" } } },
+ "TSX": { "formatter": { "language_server": { "name": "biome" } } },
+ "TypeScript": { "formatter": { "language_server": { "name": "biome" } } },
+ "Vue.js": { "formatter": { "language_server": { "name": "biome" } } },
+ }
}
```
-2. そして、プロジェクトのローカル設定で有効にします。
+詳細については、[言語サポート](/ja/internals/language-support)を参照してください。
+
+### biome.jsonが存在する場合にのみBiomeを有効にする
-```jsonc
-//
/.zed/settings.json
+```json5 title=".zed/settings.json"
{
- "language_servers": [ "biome", "..." ]
+ "lsp": {
+ "biome": {
+ "settings": {
+ "require_config_file": true
+ }
+ }
+ }
+}
+```
+
+### フォーマット時にコードアクションを実行する：
+
+```json5 title=".zed/settings.json"
+{
+ "languages": {
+ "JavaScript": {
+ "formatter": { "language_server": { "name": "biome" } },
+ "code_actions_on_format": {
+ "source.fixAll.biome": true,
+ "source.organizeImports.biome": true
+ }
+ },
+ "TypeScript": {
+ "formatter": { "language_server": { "name": "biome" } },
+ "code_actions_on_format": {
+ "source.fixAll.biome": true,
+ "source.organizeImports.biome": true
+ }
+ },
+ "TSX": {
+ "formatter": { "language_server": { "name": "biome" } },
+ "code_actions_on_format": {
+ "source.fixAll.biome": true,
+ "source.organizeImports.biome": true
+ }
+ }
+ }
}
```
-また、[`languages`](https://zed.dev/docs/configuring-zed#languages)キーを使用して言語ごとに設定することもできます。
+[安全でない修正](/ja/linter/#安全でない修正-unsafe-fixes)を保存時に適用したい場合は、[ルールのコード修正を安全にする](/ja/linter/#コード修正を設定する)必要があります。
+
+### プロジェクトベースの設定
+
+これらの設定は、プロジェクトフォルダのルートにあるZedプロジェクト設定（`.zed/settings.json`）に含めるか、すべてのプロジェクトにデフォルトで適用されるZedユーザー設定（`~/.config/zed/settings.json`）に含めることができます。
+
+#### 特定のプロジェクトでBiomeを無効にする
-### フォーマット時にコードアクションを実行する
+プロジェクトで特定の言語（例：GraphQL）のBiomeを除外できます：
-```jsonc
-// settings.json
+```json5 title=".zed/settings.json"
{
- "code_actions_on_format": {
- "source.fixAll.biome": true,
- "source.organizeImports.biome": true
+ "languages": {
+ "GraphQL": {
+ "language_servers": [ "!biome", "..." ]
+ }
}
}
```
+
+### グローバル設定
+
+Zed settings.jsonのトップレベルの `language_servers`、`formatter`、または `code_actions_on_format` キーに `biome` を追加することは推奨されません。`language_server` または `formatter` として `biome` をグローバルに指定すると、Biomeがサポートしていない言語（Rust、Pythonなど）の機能が壊れる可能性があります。サポートされている言語の完全なリストについては、[言語サポート](/ja/internals/language-support)を参照してください。
+
+このドキュメントでは以前、グローバル設定を推奨していました。Zedの設定を言語ごとにBiomeを明示的に設定するように切り替えてください。