Merge branch 'trunk' into do-max-1-php-instance-per-cli-worker

Author: adamziel

package-lock.json

@@ -0,0 +1,92 @@
+---
+title: アーキテクチャ
+slug: /developers/architecture
+---
+
+# アーキテクチャの概要
+
+<!--
+# Architecture overview
+ -->
+
+WordPress Playground は、次の高レベル コンポーネントで構成されています。
+
+<!--
+WordPress Playground consists of the following high-level components:
+ -->
+
+- [WordPress](/developers/architecture/wordpress)
+- [WebAssembly PHP](/developers/architecture/wasm-php-overview)
+- [Browser bindings](/developers/architecture/browser-concepts)
+- [@php-wasm/node](https://npmjs.com/package/@php-wasm/node) 経由の Node.js バインディング
+- [Public API](/developers/apis/)
+
+<!--
+-   [WordPress](/developers/architecture/wordpress)
+-   [WebAssembly PHP](/developers/architecture/wasm-php-overview)
+-   [Browser bindings](/developers/architecture/browser-concepts)
+-   Node.js bindings via [@php-wasm/node](https://npmjs.com/package/@php-wasm/node)
+-   [Public API](/developers/apis/)
+ -->
+
+アーキテクチャの特定の部分について詳しく知るには、各セクションにアクセスしてください。
+
+<!--
+Visit each section to learn more about the specific parts of the architecture.
+ -->
+
+## ツーリング
+
+<!--
+## Tooling
+ -->
+
+### NX: パッケージとプロジェクトの構築
+
+<!--
+### NX: building packages and projects
+ -->
+
+WordPress Playground は、モノレポ用に設計されたビルド システムである [NX](https://nx.dev/) を使用します。
+
+<!--
+WordPress Playground uses [NX](https://nx.dev/), a build system designed for monorepos.
+ -->
+
+Playground パッケージとプロジェクト間の依存関係は、Webpack のようなバンドラーにとっては [複雑すぎる](https://github.com/WordPress/wordpress-playground/pull/151) ですが、NX はこの複雑さをはるかに適切に処理します。
+![Dependency graph](@site/static/img/dependencies.png)
+
+<!--
+The dependencies between Playground packages and projects [are too complex](https://github.com/WordPress/wordpress-playground/pull/151) for a bundler like Webpack, and NX handles this complexity much better:
+![Dependency graph](@site/static/img/dependencies.png)
+ -->
+
+詳細については、[NX 開発者ドキュメント](https://nx.dev/getting-started/intro)をご覧ください。
+
+<!--
+To learn more, head over to the [NX developer docs](https://nx.dev/getting-started/intro).
+ -->
+
+### Lerna: パッケージとプロジェクトの公開
+
+<!--
+### Lerna: publishing packages and projects
+ -->
+
+WordPress Playground には、いくつかの NPM パッケージ、VS Code 拡張機能、WordPress プラグイン、Web アプリ、その他の GitHub リリースが含まれており、すべてメインの [wordpress-playground](https://github.com/WordPress/wordpress-playground) と [Playground Tools](https://github.com/WordPress/playground-tools/) の 2 つのモノレポで管理されています。
+
+<!--
+WordPress Playground includes several NPM packages, a VS Code extension, WordPress plugins, a web app, and other GitHub releases, all managed across two monorepos: the main [wordpress-playground](https://github.com/WordPress/wordpress-playground) and [Playground Tools](https://github.com/WordPress/playground-tools/).
+ -->
+
+すべての JavaScript/TypeScript パッケージのビルド、管理、公開には[Lerna](https://lerna.js.org)を使用しています。Lerna はすべての処理を同時に行います。バージョン番号のインクリメント、新しいタグの設定、そして変更されたパッケージの`npm`への公開まで行います。
+
+<!--
+We use [Lerna](https://lerna.js.org) to build, manage, and publish all JavaScript/TypeScript packages. Lerna handles everything simultaneously: it increments the version number, sets a new tag, and publishes the modified packages to `npm`.
+ -->
+
+公開されたパッケージは同じバージョン番号を共有するため、1 つのパッケージを更新すると、Lerna は依存するすべてのパッケージのバージョン番号を上げます。
+
+<!--
+The published packages share the same version number, so when updating a single package, Lerna bumps the version number of all dependent packages.
+ -->

packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/developers/23-architecture/01-index.md

@@ -0,0 +1,3 @@
+{
+	"label": "アーキテクチャ"
+}

packages/docs/site/i18n/ja/docusaurus-plugin-content-docs/current/developers/23-architecture/_category_.json

@@ -0,0 +1,78 @@
+---
+slug: /contributing/table-lead-guide
+title: Como liderar o dia do contribuidor
+description: Como liderar a mesa do WordPress Playground no dia do contribuidor do WordCamp.
+---
+
+# Guia de liderença para o dia do contribuidor
+
+Este guia ajuda os contribuidores a se prepararem e gerenciarem uma mesa de contribuição do WordPress Playground em eventos WordCamp.
+
+## Antes do dia do contribuidor
+
+### Lista prévia
+
+-   **Organizar "Good First Issues"**: Revise e atualize a [good first issues list](https://github.com/WordPress/wordpress-playground/labels/good%20first%20issue) no GitHub. Devem ser tarefas diretas que novos contribuidores possam completar de forma independente. Se encontrar um erro que não está na lista, mas que poderia fazer parte dela, entre em contato com a equipe do Playground no canal do Slack.
+-   **Coordenar com a Equipe do Playground**: Confirme se os membros da equipe do Playground estão disponíveis online para fornecer suporte remoto durante o evento, especialmente para WordCamps de grande porte. Devido a diferenças de fuso horário, alinhe-se com antecedência no canal #playground para verificar a disponibilidade.
+-   **Conecte com contribuidores locais**: Identifique contribuidores regulares na região que estão participando do evento. Verifique no Canal Slack #playground se um membro ativo da comunidade está participando do dia do contribuidor. Esta é uma oportunidade para coletar feedback e fortalecer as conexões comunitárias.
+-   **Confira o repositorio do Playground**: Se você nunca contribuiu com o repositório do WordPress Playground, você deve primeiro se familiarizar com ele. Uma seção na documentação que pode guiá-lo a entender o projeto é a [Desenvolvedores > Arquitetura](/developers/architecture). Ela conterá informações sobre como o projeto está organizado. Se tiver alguma dúvida, entre em contato com a equipe no canal Slack do Playground.
+
+## Iniciando o dia
+
+### Configuração e Integração
+
+1. **Crie sua agenda**: Prepare uma lista de verificação das principais atividades, ao mesmo tempo que permite a colaboração orgânica. Compartilhe-a na documentação do projeto, se for útil.
+
+2. **Oriente os contribuidores ao Slack**: Direcione todos para o [canal `#playground` no Slack do WordPress](https://wordpress.slack.com/archives/C04EWKGDJ0K). Isso centraliza a comunicação e permite a colaboração assíncrona com os recém-chegados.
+
+3. **Publique uma mensagem de boas-vindas**: Compartilhe uma mensagem inicial no canal Slack anunciando sua presença (pessoalmente ou online) e dando as boas-vindas às contribuições de todos.
+
+4. **Compartilhe links essenciais**: Publique estes recursos no canal `#playground`:
+
+    - [Instância Web do WordPress Playground](https://playground.wordpress.net/)
+    - [Documentação do Playground](https://wordpress.github.io/wordpress-playground/)
+    - [Biblioteca de etapas](https://akirk.github.io/playground-step-library/)
+    - [Repositório do GitHub](https://github.com/WordPress/wordpress-playground)
+    - [Guia do dia do contribuidor](/contributing/contributor-day/)
+
+5. **Apresente o Repositório GitHub**: Forneça uma breve visão geral da estrutura do repositório, destacando diferentes pacotes e seus propósitos para os contribuidores de primeira viagem.
+
+## Durante o dia
+
+### Gerenciando Contribuições
+
+**Incentive diferentes tipos de contribuição:**:
+
+Verifique os níveis dos contribuidores, tente entender com base no nível deles como podem contribuir para o projeto no curto período de tempo de um dia do contribuidor. Pergunte se os participantes precisam de ajuda e os redirecione para a página de documentação relacionada. Além disso, incentive-os a fazer perguntas no [Canal #playground do Slack](https://wordpress.slack.com/archives/C04EWKGDJ0K). Aqui estão algumas sugestões de formas de contribuir:
+
+-   Melhorias e traduções de documentação.
+-   Tíquetes cuidadosamente elaborados, descrevendo problemas com soluções acionáveis.
+-   Criação de Blueprints e demos de plugins no repositório de plugins do WordPress.
+-   Testes e feedback do produto.
+
+**Fomentar a Colaboração**: Procure por oportunidades entre mesas. Por exemplo, contribuidores da [mesa de Traduções/Poliglotas ](https://make.wordpress.org/polyglots/) podem traduzir a documentação do Playground, ou a mesa do [time de testes do núcleo](https://make.wordpress.org/test/) pode fornecer feedback valioso sobre o Playground.
+
+**Coletar Feedback**: Pergunte aos contribuidores sobre sua experiência e anote sugestões de melhoria. Relate isso no [canal #playground do Slack](https://wordpress.slack.com/archives/C04EWKGDJ0K) se possível.
+
+## Depois do evento
+
+### Acompanhamento e Suporte
+
+1. **Revisar Pull Requests (PRs)**: Liste as PRs criadas durante o dia e avalie a probabilidade de serem concluídas. A maioria das contribuições tem uma janela de momentum curta, e o engajamento dentro das primeiras duas semanas é crítico.
+
+2. **Definir expectativas claras**: Para PRs incompletas, siga esta abordagem:
+
+    - Após um mês de inatividade, deixe um comentário perguntando se o autor planeja completar o trabalho.
+    - Se não houver resposta após mais duas semanas, informe que a PR poderá ser assumida por outro contribuidor ou fechada.
+
+3. **Mantenha-se ativo no Slack**: Continue a apoiar novos contribuidores através do canal #playground, respondendo a perguntas e ajudando-os a se tornarem contribuidores regulares.
+
+4. **Refletir e melhorar**: Revise o feedback coletado e sua experiência para refinar este guia para eventos futuros. Sinta-se à vontade para enviar um Pull Request para este guia!
+
+## Obtendo ajuda
+
+-   **Durante o evento**: Conecte-se com contribuidores na mesa do Playground.
+-   **Suporte contínuo**: Use o [canal `#playground` do Slack](https://wordpress.slack.com/archives/C04EWKGDJ0K).
+-   **Report Issues**: Envie para o [Repositorio do WordPress Playground no GitHub](https://github.com/WordPress/wordpress-playground/issues/new).
+
+Para mais informações sobre como contribuir para o WordPress Playground, consulte o [Guia do dia do contribuidor](/contributing/contributor-day).

packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/contributor-day-table-lead.md

@@ -0,0 +1,18 @@
+{
+	"extends": ["../../../.eslintrc.json"],
+	"ignorePatterns": ["!**/*"],
+	"overrides": [
+		{
+			"files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+			"rules": {}
+		},
+		{
+			"files": ["*.ts", "*.tsx"],
+			"rules": {}
+		},
+		{
+			"files": ["*.js", "*.jsx"],
+			"rules": {}
+		}
+	]
+}

packages/php-wasm/cli-util/.eslintrc.json

@@ -0,0 +1,11 @@
+# php-wasm-cli-util
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build php-wasm-cli-util` to build the library.
+
+## Running unit tests
+
+Run `nx test php-wasm-cli-util` to execute the unit tests via [Vitest](https://vitest.dev).

packages/php-wasm/cli-util/README.md

@@ -0,0 +1,39 @@
+{
+	"name": "@php-wasm/cli-util",
+	"version": "3.0.22",
+	"description": "Utilities for PHP.wasm related CLIs",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/WordPress/wordpress-playground"
+	},
+	"homepage": "https://developer.wordpress.org/playground",
+	"author": "The WordPress contributors",
+	"exports": {
+		".": {
+			"import": "./index.js",
+			"require": "./index.cjs"
+		},
+		"./package.json": "./package.json",
+		"./README.md": "./README.md"
+	},
+	"main": "./index.cjs",
+	"module": "./index.js",
+	"type": "module",
+	"types": "index.d.ts",
+	"typedoc": {
+		"entryPoint": "./src/index.ts",
+		"readmeFile": "./README.md",
+		"displayName": "@php-wasm/cli-util",
+		"tsconfig": "./tsconfig.lib.json"
+	},
+	"publishConfig": {
+		"access": "public",
+		"directory": "../../../dist/packages/php-wasm/cli-util"
+	},
+	"license": "GPL-2.0-or-later",
+	"gitHead": "2f8d8f3cea548fbd75111e8659a92f601cddc593",
+	"engines": {
+		"node": ">=20.18.3",
+		"npm": ">=10.1.0"
+	}
+}

packages/php-wasm/cli-util/package.json

@@ -0,0 +1,81 @@
+{
+	"name": "php-wasm-cli-util",
+	"$schema": "../../../node_modules/nx/schemas/project-schema.json",
+	"sourceRoot": "packages/php-wasm/cli-util/src",
+	"projectType": "library",
+	"targets": {
+		"build": {
+			"executor": "nx:noop",
+			"dependsOn": ["build:README"]
+		},
+		"build:README": {
+			"executor": "nx:run-commands",
+			"options": {
+				"commands": [
+					"cp packages/php-wasm/cli-util/README.md dist/packages/php-wasm/cli-util"
+				]
+			},
+			"dependsOn": ["build:package-json"]
+		},
+		"build:package-json": {
+			"executor": "@wp-playground/nx-extensions:package-json",
+			"options": {
+				"tsConfig": "packages/php-wasm/cli-util/tsconfig.lib.json",
+				"outputPath": "dist/packages/php-wasm/cli-util",
+				"buildTarget": "php-wasm-cli-util:build:bundle:production"
+			}
+		},
+		"build:bundle": {
+			"executor": "@nx/vite:build",
+			"outputs": ["{options.outputPath}"],
+			"options": {
+				"emptyOutDir": false,
+				"outputPath": "dist/packages/php-wasm/cli-util"
+			}
+		},
+		"publish": {
+			"executor": "nx:run-commands",
+			"options": {
+				"command": "node tools/scripts/publish.mjs php-wasm-cli-util {args.ver} {args.tag}"
+			},
+			"dependsOn": ["build"]
+		},
+		"package-for-self-hosting": {
+			"executor": "@wp-playground/nx-extensions:package-for-self-hosting",
+			"dependsOn": ["build"]
+		},
+		"lint": {
+			"executor": "@nx/linter:eslint",
+			"outputs": ["{options.outputFile}"],
+			"options": {
+				"useFlatConfig": false,
+				"lintFilePatterns": ["packages/php-wasm/cli-util/**/*.ts"],
+				"maxWarnings": 0
+			}
+		},
+		"test": {
+			"executor": "@nx/vite:test",
+			"outputs": ["{workspaceRoot}/coverage/packages/php-wasm/cli-util"],
+			"options": {
+				"reportsDirectory": "../../../coverage/packages/php-wasm/cli-util"
+			}
+		},
+		"test:esmcjs": {
+			"executor": "@wp-playground/nx-extensions:assert-built-esm-and-cjs",
+			"options": {
+				"outputPath": "dist/packages/php-wasm/cli-util"
+			},
+			"dependsOn": ["build"]
+		},
+		"typecheck": {
+			"executor": "nx:run-commands",
+			"options": {
+				"commands": [
+					"tsc -p packages/php-wasm/cli-util/tsconfig.lib.json --noEmit",
+					"tsc -p packages/php-wasm/cli-util/tsconfig.spec.json --noEmit"
+				]
+			}
+		}
+	},
+	"tags": ["scope:independent-from-php-binaries"]
+}

packages/php-wasm/cli-util/project.json

@@ -0,0 +1 @@
+export * from './lib';

packages/php-wasm/cli-util/src/index.ts

@@ -0,0 +1,2 @@
+export * from './mounts';
+export * from './xdebug-path-mappings';