assets: document Docker development and the Vite plugin host option (#1079)

Incorporates the docs from #1079, verified against the plugin's
"added host option and normalized dev server URL" change: host option,
0.0.0.0/true normalization to localhost, CORS/allowedHosts handling.

Author: jeremy-step

assets/cs/vite.texy

@@ -326,6 +326,52 @@ export default defineConfig({
 Všimněte si, že pokud používáte konfiguraci CORS (možnost 1 výše), musíte aktualizovat URL původu tak, aby používala `https://` namísto `http://`.
 
 
+Vývoj s Dockerem
+----------------
+
+Když spouštíte Vite uvnitř Docker kontejneru, je potřeba ohlídat dvě věci: prohlížeč na vašem počítači musí být schopen dosáhnout na vývojový server a Vite musí rozpoznat změny souborů přes hranici kontejneru.
+
+Nejprve z kontejneru [zpřístupněte |https://docs.docker.com/get-started/docker-concepts/running-containers/publishing-ports/] port Vite a navažte vývojový server na všechna rozhraní, aby byl dostupný zvenčí kontejneru:
+
+```js
+export default defineConfig({
+	// ... další konfigurace ...
+
+	plugins: [
+		nette(),
+	],
+	server: {
+		host: '0.0.0.0',      // naslouchá na všech rozhraních (v kontejneru nutné)
+		port: 5173,           // musí odpovídat zpřístupněnému portu
+		strictPort: true,     // raději selže, než by zvolil jiný port
+		watch: {
+			usePolling: true, // zapněte, pokud se změny souborů na připojených svazcích nedetekují
+		},
+	},
+});
+```
+
+Plugin zapíše URL vývojového serveru do `nette.json` pro PHP stranu. Protože `host: '0.0.0.0'` není použitelný v prohlížeči (u každého assetu přesměruje na `localhost`), plugin ho v této URL automaticky přepíše na `localhost`, takže se assety načtou správně.
+
+Pokud aplikaci otevíráte na vlastní doméně místo `localhost`, nastavte `host` option pluginu na tuto doménu:
+
+```js
+	plugins: [
+		nette({ host: 'myapp.local' }),  // stejná doména jako vaše PHP aplikace
+	],
+```
+
+Plugin pak tento host použije pro URL vývojového serveru, přidá ho mezi CORS origins a povolí ho ve Vite `allowedHosts` - takže to funguje bez ruční konfigurace CORS.
+
+U složitějších nasazení - například když Vite běží za reverzní proxy, kde se veřejný host, port i protokol liší od interní adresy - nastavte ve Vite `server.origin` na úplnou veřejnou URL. Plugin ji respektuje a zapíše do `nette.json` tak, jak je, místo aby URL odvozoval z lokálního socketu:
+
+```js
+	server: {
+		origin: 'https://myapp.local:8443',  // veřejná URL, na které prohlížeč dosáhne na Vite
+	},
+```
+
+
 Produkční buildy
 ================
 

assets/en/vite.texy

@@ -326,6 +326,52 @@ export default defineConfig({
 Note that if you're using the CORS configuration (Option 1 from above), you need to update the origin URL to use `https://` instead of `http://`.
 
 
+Docker Development
+------------------
+
+When you run Vite inside a Docker container, two things need attention: the browser on your machine must be able to reach the dev server, and Vite must detect file changes across the container boundary.
+
+First, [publish |https://docs.docker.com/get-started/docker-concepts/running-containers/publishing-ports/] the Vite port from the container and bind the dev server to all interfaces, so it is reachable from outside the container:
+
+```js
+export default defineConfig({
+	// ... other config ...
+
+	plugins: [
+		nette(),
+	],
+	server: {
+		host: '0.0.0.0',      // listen on all interfaces (required in a container)
+		port: 5173,           // must match the published port
+		strictPort: true,     // fail rather than pick another port
+		watch: {
+			usePolling: true, // enable if file changes aren't detected on mounted volumes
+		},
+	},
+});
+```
+
+The plugin writes the dev server URL into `nette.json` for the PHP side. Because `host: '0.0.0.0'` is not usable by a browser (it redirects to `localhost` for every asset), the plugin automatically rewrites it to `localhost` in that URL, so assets load correctly.
+
+If you open the application on a custom domain instead of `localhost`, set the plugin's `host` option to that domain:
+
+```js
+	plugins: [
+		nette({ host: 'myapp.local' }),  // the same domain as your PHP app
+	],
+```
+
+The plugin then uses this host for the dev server URL, adds it to the CORS origins, and whitelists it in Vite's `allowedHosts` - so it works without any manual CORS setup.
+
+For more complex setups - for example when Vite runs behind a reverse proxy where the public host, port, and protocol all differ from the internal address - set Vite's `server.origin` to the full public URL. The plugin respects it and writes it into `nette.json` as-is, instead of deriving the URL from the local socket:
+
+```js
+	server: {
+		origin: 'https://myapp.local:8443',  // the public URL where the browser reaches Vite
+	},
+```
+
+
 Production Builds
 =================