create-flow-os 0.0.1-dev.1771777625 → 0.0.1-dev.1771778985

package/bin/index.js

@@ -820,11 +820,14 @@ function transformPackageJson(pkg, projectName, extraPackages = {}, useWorkspace
 function transformScriptsForCreatedProject(scripts) {
   if (!scripts)
     return scripts;
+  const drop = new Set(["release", "version"]);
   const out = {};
   for (const [key, value] of Object.entries(scripts)) {
-    if (key === "release")
+    if (drop.has(key))
       continue;
-    let s = value.replace(/bun\s+packages\/client\/start-dev\.ts\b/, "flow-os-dev").replace(/bun\s+packages\/client\/build\.ts\b/g, "flow-os-build").replace(/bun\s+packages\/client\/preview\.ts\b/, "flow-os-preview").replace(/bun\s+(\.\/)?node_modules\/@flow\.os\/client\/start-dev\.ts\b/, "flow-os-dev").replace(/bun\s+(\.\/)?node_modules\/@flow\.os\/client\/build\.ts\b/g, "flow-os-build").replace(/bun\s+(\.\/)?node_modules\/@flow\.os\/client\/preview\.ts\b/, "flow-os-preview").replace(/bun\s+(\.\/)?node_modules\/@flow\.os\/server\/start\.ts\b/, "server");
+    let s = value;
+    if (key === "start" && /@flow\.os\/server\/start\.ts/.test(s))
+      s = "server";
     out[key] = s;
   }
   return Object.keys(out).length ? out : undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-flow-os",
-  "version": "0.0.1-dev.1771777625",
+  "version": "0.0.1-dev.1771778985",
   "type": "module",
   "bin": {
     "create-flow-os": "bin/index.js"

package/profiles/client/README.md

@@ -1,28 +1,34 @@
 # Flow OS
 
-## Comandi
+Tutti i comandi dalla **root** del repo.
+
+---
+
+## Dev (sviluppo e canale dev)
 
 | Comando | Cosa fa |
-|--------|---------|
-| **dev** | Avvia il server di sviluppo (client + eventuale server). |
-| **build** | Build di produzione del client. |
-| **gen** | Rigenera `profiles/` e `packages/` da `config.json` e dai tag `// @flow: <id>` nei file. |
-| **version** | Aggiorna la versione (patch/minor/major o valore esatto) nei package. Solo i package indicati, altrimenti tutti. |
-| **release** | Pubblica su npm (tag `latest`). Solo i package indicati, altrimenti tutti. |
-| **publish:dev** | Pubblica su npm con tag `dev` (versione `0.0.1-dev.<timestamp>`). |
+|---------|---------|
+| `bun run dev` | Avvia il server di sviluppo (client + server). |
+| `bun run gen` | Rigenera i template (profiles + packages in create-flow). Di solito non serve: lo fa già `publish:dev`. |
+| `bun run publish:dev` | Esegue **gen** + **build** create-flow e pubblica tutto su npm con tag **dev**. |
 
-**Esecuzione**
+**Pubblicare solo un package** (più veloce):
 
 ```bash
-bun run dev
-bun run build
-bun run gen
+bun run publish:dev -- --client
+```
 
-bun run version -- patch
-bun run version -- patch @flow.os/client create-flow-os
+(Stesso comando con `--style`, `--core`, `--router`, `--server` al posto di `--client`.)
 
-bun run release
-bun run release -- @flow.os/client create-flow-os
+---
 
-bun run publish:dev
-```
+## Prod (release su latest)
+
+| Comando | Cosa fa |
+|---------|---------|
+| `bun run version -- <patch|minor|major|X.Y.Z>` | Aggiorna la versione nei package. Es.: `patch` per tutti, oppure `bun run version -- 1.0.0` per impostare tutti a 1.0.0. |
+| `bun run version -- patch @flow.os/client create-flow-os` | Aggiorna solo i package indicati. |
+| `bun run release` | Pubblica su npm con tag **latest**. Va usato **dopo** aver lanciato `version`. |
+| `bun run release -- @flow.os/client create-flow-os` | Pubblica solo i package indicati. |
+
+**Ordine per una release prod:** prima `bun run version -- patch` (o minor/major), poi `bun run release`.

package/profiles/client/package.json

@@ -4,9 +4,9 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "dev": "bun packages/client/start-dev.ts",
-    "build": "tsc -b && bun packages/client/build.ts",
-    "preview": "bun packages/client/preview.ts",
+    "dev": "bun scripts/dev.ts",
+    "build": "tsc -b && bun scripts/build.ts",
+    "preview": "bun scripts/preview.ts",
     "start": "bun node_modules/@flow.os/server/start.ts",
     "lint": "oxlint .",
     "fmt": "oxfmt",

package/profiles/client/packages/client/config.ts

@@ -109,8 +109,11 @@ function flowServerUrlPlugin(hostEnabled: boolean): Plugin {
 export default function config(
   options: FlowConfigOptions = {}
 ): () => Promise<ReturnType<typeof import('vite').defineConfig>> {
-  const { port = DEFAULTS.port, host = DEFAULTS.host, server = DEFAULTS.server, plugins = DEFAULTS.plugins } = options;
+  const { port: optPort = DEFAULTS.port, host = DEFAULTS.host, server = DEFAULTS.server, plugins = DEFAULTS.plugins } = options;
   return async () => {
+    const envPort = process.env.FLOW_DEV_PORT;
+    const port = envPort ? parseInt(envPort, 10) : optPort;
+    const strictPort = !!envPort;
     const { flow } = await import('./vite.js');
     const allPlugins = [
       flowServerUrlPlugin(host === true),
@@ -122,13 +125,13 @@ export default function config(
       ...baseLogger,
       info: (msg: string, opts?: { clear?: boolean }) => {
         const t = msg.replace(/\s+/g, ' ');
-        if (/VITE\s+v?\d|ready\s+in|Local:\s*http|Network:\s*http|press\s+h\s+enter/i.test(t)) return;
+        if (/VITE\s+v?\d|ready\s+in|Local:\s*http|Network:\s*http|press\s+h\s+enter|Port\s+\d+\s+is\s+in\s+use/i.test(t)) return;
         baseLogger.info(msg, opts);
       },
     };
     return {
       resolve: Object.keys(alias).length ? { alias } : {},
-      server: { port, host, strictPort: false },
+      server: { port, host, strictPort },
       customLogger,
       build: {
         rollupOptions: {

package/profiles/client/packages/client/package.json

@@ -5,6 +5,11 @@
   "type": "module",
   "main": "./index.ts",
   "types": "./index.ts",
+  "bin": {
+    "flow-os-dev": "./start-dev.ts",
+    "flow-os-build": "./build.ts",
+    "flow-os-preview": "./preview.ts"
+  },
   "dependencies": {
     "@flow.os/core": "workspace:*",
     "@flow.os/router": "workspace:*",

package/profiles/client/packages/client/start-dev.ts

@@ -1,17 +1,39 @@
 #!/usr/bin/env bun
 /**
  * Flow OS dev server runner. Loads flow.config.ts and starts the dev server.
- * Usage: bun node_modules/@flow.os/client/start-dev.ts  (or bun packages/client/start-dev.ts in monorepo)
+ * Trova una porta libera (3000, 3001, …) prima di avviare, così Vite non si blocca su "trying another one".
  */
 
 import { pathToFileURL } from 'node:url';
 import { join } from 'node:path';
 import { createServer } from 'vite';
+import net from 'node:net';
 
 const cwd = process.cwd();
 const configPath = join(cwd, 'flow.config.ts');
 const configUrl = pathToFileURL(configPath).href;
 
+function isPortFree(port: number): Promise<boolean> {
+  return new Promise((resolve) => {
+    const s = net.createServer();
+    s.once('error', () => resolve(false));
+    s.once('listening', () => {
+      s.close(() => resolve(true));
+    });
+    s.listen(port, '127.0.0.1');
+  });
+}
+
+async function findFreePort(from: number, to: number): Promise<number> {
+  for (let p = from; p <= to; p++) {
+    if (await isPortFree(p)) return p;
+  }
+  throw new Error(`Nessuna porta libera tra ${from} e ${to}`);
+}
+
+const port = await findFreePort(3000, 3020);
+process.env.FLOW_DEV_PORT = String(port);
+
 const mod = await import(configUrl).catch((e: Error) => {
   console.error('Flow: could not load flow.config.ts:', e.message);
   process.exit(1);

package/profiles/client/scripts/build.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env bun
+import { pathToFileURL } from 'node:url';
+import { join } from 'node:path';
+import { build } from 'vite';
+
+const cwd = process.cwd();
+const configPath = join(cwd, 'flow.config.ts');
+const mod = await import(pathToFileURL(configPath).href).catch((e: Error) => {
+  console.error('Flow: could not load flow.config.ts:', e.message);
+  process.exit(1);
+});
+const getConfig = mod.default;
+const config = typeof getConfig === 'function' ? await getConfig() : getConfig;
+await build(config);

package/profiles/client/scripts/dev.ts

@@ -0,0 +1,45 @@
+#!/usr/bin/env bun
+/**
+ * Flow OS dev server runner. Loads flow.config.ts and starts the dev server.
+ * Trova una porta libera (3000, 3001, …) prima di avviare, così Vite non si blocca su "trying another one".
+ */
+
+import { pathToFileURL } from 'node:url';
+import { join } from 'node:path';
+import { createServer } from 'vite';
+import net from 'node:net';
+
+const cwd = process.cwd();
+const configPath = join(cwd, 'flow.config.ts');
+const configUrl = pathToFileURL(configPath).href;
+
+function isPortFree(port: number): Promise<boolean> {
+  return new Promise((resolve) => {
+    const s = net.createServer();
+    s.once('error', () => resolve(false));
+    s.once('listening', () => {
+      s.close(() => resolve(true));
+    });
+    s.listen(port, '127.0.0.1');
+  });
+}
+
+async function findFreePort(from: number, to: number): Promise<number> {
+  for (let p = from; p <= to; p++) {
+    if (await isPortFree(p)) return p;
+  }
+  throw new Error(`Nessuna porta libera tra ${from} e ${to}`);
+}
+
+const port = await findFreePort(3000, 3020);
+process.env.FLOW_DEV_PORT = String(port);
+
+const mod = await import(configUrl).catch((e: Error) => {
+  console.error('Flow: could not load flow.config.ts:', e.message);
+  process.exit(1);
+});
+const getConfig = mod.default;
+const config = typeof getConfig === 'function' ? await getConfig() : getConfig;
+const server = await createServer(config);
+await server.listen();
+server.watcher.on('change', () => {});

package/profiles/client/scripts/preview.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env bun
+import { pathToFileURL } from 'node:url';
+import { join } from 'node:path';
+import { preview } from 'vite';
+
+const cwd = process.cwd();
+const configPath = join(cwd, 'flow.config.ts');
+const mod = await import(pathToFileURL(configPath).href).catch((e: Error) => {
+  console.error('Flow: could not load flow.config.ts:', e.message);
+  process.exit(1);
+});
+const getConfig = mod.default;
+const config = typeof getConfig === 'function' ? await getConfig() : getConfig;
+await preview(config);

package/profiles/full/README.md

@@ -1,28 +1,34 @@
 # Flow OS
 
-## Comandi
+Tutti i comandi dalla **root** del repo.
+
+---
+
+## Dev (sviluppo e canale dev)
 
 | Comando | Cosa fa |
-|--------|---------|
-| **dev** | Avvia il server di sviluppo (client + eventuale server). |
-| **build** | Build di produzione del client. |
-| **gen** | Rigenera `profiles/` e `packages/` da `config.json` e dai tag `// @flow: <id>` nei file. |
-| **version** | Aggiorna la versione (patch/minor/major o valore esatto) nei package. Solo i package indicati, altrimenti tutti. |
-| **release** | Pubblica su npm (tag `latest`). Solo i package indicati, altrimenti tutti. |
-| **publish:dev** | Pubblica su npm con tag `dev` (versione `0.0.1-dev.<timestamp>`). |
+|---------|---------|
+| `bun run dev` | Avvia il server di sviluppo (client + server). |
+| `bun run gen` | Rigenera i template (profiles + packages in create-flow). Di solito non serve: lo fa già `publish:dev`. |
+| `bun run publish:dev` | Esegue **gen** + **build** create-flow e pubblica tutto su npm con tag **dev**. |
 
-**Esecuzione**
+**Pubblicare solo un package** (più veloce):
 
 ```bash
-bun run dev
-bun run build
-bun run gen
+bun run publish:dev -- --client
+```
 
-bun run version -- patch
-bun run version -- patch @flow.os/client create-flow-os
+(Stesso comando con `--style`, `--core`, `--router`, `--server` al posto di `--client`.)
 
-bun run release
-bun run release -- @flow.os/client create-flow-os
+---
 
-bun run publish:dev
-```
+## Prod (release su latest)
+
+| Comando | Cosa fa |
+|---------|---------|
+| `bun run version -- <patch|minor|major|X.Y.Z>` | Aggiorna la versione nei package. Es.: `patch` per tutti, oppure `bun run version -- 1.0.0` per impostare tutti a 1.0.0. |
+| `bun run version -- patch @flow.os/client create-flow-os` | Aggiorna solo i package indicati. |
+| `bun run release` | Pubblica su npm con tag **latest**. Va usato **dopo** aver lanciato `version`. |
+| `bun run release -- @flow.os/client create-flow-os` | Pubblica solo i package indicati. |
+
+**Ordine per una release prod:** prima `bun run version -- patch` (o minor/major), poi `bun run release`.

package/profiles/full/package.json

@@ -4,9 +4,9 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "dev": "bun packages/client/start-dev.ts",
-    "build": "tsc -b && bun packages/client/build.ts",
-    "preview": "bun packages/client/preview.ts",
+    "dev": "bun scripts/dev.ts",
+    "build": "tsc -b && bun scripts/build.ts",
+    "preview": "bun scripts/preview.ts",
     "start": "bun node_modules/@flow.os/server/start.ts",
     "lint": "oxlint .",
     "fmt": "oxfmt",

package/profiles/full/packages/client/config.ts

@@ -109,8 +109,11 @@ function flowServerUrlPlugin(hostEnabled: boolean): Plugin {
 export default function config(
   options: FlowConfigOptions = {}
 ): () => Promise<ReturnType<typeof import('vite').defineConfig>> {
-  const { port = DEFAULTS.port, host = DEFAULTS.host, server = DEFAULTS.server, plugins = DEFAULTS.plugins } = options;
+  const { port: optPort = DEFAULTS.port, host = DEFAULTS.host, server = DEFAULTS.server, plugins = DEFAULTS.plugins } = options;
   return async () => {
+    const envPort = process.env.FLOW_DEV_PORT;
+    const port = envPort ? parseInt(envPort, 10) : optPort;
+    const strictPort = !!envPort;
     const { flow } = await import('./vite.js');
     const allPlugins = [
       flowServerUrlPlugin(host === true),
@@ -122,13 +125,13 @@ export default function config(
       ...baseLogger,
       info: (msg: string, opts?: { clear?: boolean }) => {
         const t = msg.replace(/\s+/g, ' ');
-        if (/VITE\s+v?\d|ready\s+in|Local:\s*http|Network:\s*http|press\s+h\s+enter/i.test(t)) return;
+        if (/VITE\s+v?\d|ready\s+in|Local:\s*http|Network:\s*http|press\s+h\s+enter|Port\s+\d+\s+is\s+in\s+use/i.test(t)) return;
         baseLogger.info(msg, opts);
       },
     };
     return {
       resolve: Object.keys(alias).length ? { alias } : {},
-      server: { port, host, strictPort: false },
+      server: { port, host, strictPort },
       customLogger,
       build: {
         rollupOptions: {

package/profiles/full/packages/client/package.json

@@ -5,6 +5,11 @@
   "type": "module",
   "main": "./index.ts",
   "types": "./index.ts",
+  "bin": {
+    "flow-os-dev": "./start-dev.ts",
+    "flow-os-build": "./build.ts",
+    "flow-os-preview": "./preview.ts"
+  },
   "dependencies": {
     "@flow.os/core": "workspace:*",
     "@flow.os/router": "workspace:*",

package/profiles/full/packages/client/start-dev.ts

@@ -1,17 +1,39 @@
 #!/usr/bin/env bun
 /**
  * Flow OS dev server runner. Loads flow.config.ts and starts the dev server.
- * Usage: bun node_modules/@flow.os/client/start-dev.ts  (or bun packages/client/start-dev.ts in monorepo)
+ * Trova una porta libera (3000, 3001, …) prima di avviare, così Vite non si blocca su "trying another one".
  */
 
 import { pathToFileURL } from 'node:url';
 import { join } from 'node:path';
 import { createServer } from 'vite';
+import net from 'node:net';
 
 const cwd = process.cwd();
 const configPath = join(cwd, 'flow.config.ts');
 const configUrl = pathToFileURL(configPath).href;
 
+function isPortFree(port: number): Promise<boolean> {
+  return new Promise((resolve) => {
+    const s = net.createServer();
+    s.once('error', () => resolve(false));
+    s.once('listening', () => {
+      s.close(() => resolve(true));
+    });
+    s.listen(port, '127.0.0.1');
+  });
+}
+
+async function findFreePort(from: number, to: number): Promise<number> {
+  for (let p = from; p <= to; p++) {
+    if (await isPortFree(p)) return p;
+  }
+  throw new Error(`Nessuna porta libera tra ${from} e ${to}`);
+}
+
+const port = await findFreePort(3000, 3020);
+process.env.FLOW_DEV_PORT = String(port);
+
 const mod = await import(configUrl).catch((e: Error) => {
   console.error('Flow: could not load flow.config.ts:', e.message);
   process.exit(1);

package/profiles/full/scripts/build.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env bun
+import { pathToFileURL } from 'node:url';
+import { join } from 'node:path';
+import { build } from 'vite';
+
+const cwd = process.cwd();
+const configPath = join(cwd, 'flow.config.ts');
+const mod = await import(pathToFileURL(configPath).href).catch((e: Error) => {
+  console.error('Flow: could not load flow.config.ts:', e.message);
+  process.exit(1);
+});
+const getConfig = mod.default;
+const config = typeof getConfig === 'function' ? await getConfig() : getConfig;
+await build(config);

package/profiles/full/scripts/dev.ts

@@ -0,0 +1,45 @@
+#!/usr/bin/env bun
+/**
+ * Flow OS dev server runner. Loads flow.config.ts and starts the dev server.
+ * Trova una porta libera (3000, 3001, …) prima di avviare, così Vite non si blocca su "trying another one".
+ */
+
+import { pathToFileURL } from 'node:url';
+import { join } from 'node:path';
+import { createServer } from 'vite';
+import net from 'node:net';
+
+const cwd = process.cwd();
+const configPath = join(cwd, 'flow.config.ts');
+const configUrl = pathToFileURL(configPath).href;
+
+function isPortFree(port: number): Promise<boolean> {
+  return new Promise((resolve) => {
+    const s = net.createServer();
+    s.once('error', () => resolve(false));
+    s.once('listening', () => {
+      s.close(() => resolve(true));
+    });
+    s.listen(port, '127.0.0.1');
+  });
+}
+
+async function findFreePort(from: number, to: number): Promise<number> {
+  for (let p = from; p <= to; p++) {
+    if (await isPortFree(p)) return p;
+  }
+  throw new Error(`Nessuna porta libera tra ${from} e ${to}`);
+}
+
+const port = await findFreePort(3000, 3020);
+process.env.FLOW_DEV_PORT = String(port);
+
+const mod = await import(configUrl).catch((e: Error) => {
+  console.error('Flow: could not load flow.config.ts:', e.message);
+  process.exit(1);
+});
+const getConfig = mod.default;
+const config = typeof getConfig === 'function' ? await getConfig() : getConfig;
+const server = await createServer(config);
+await server.listen();
+server.watcher.on('change', () => {});

package/profiles/full/scripts/preview.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env bun
+import { pathToFileURL } from 'node:url';
+import { join } from 'node:path';
+import { preview } from 'vite';
+
+const cwd = process.cwd();
+const configPath = join(cwd, 'flow.config.ts');
+const mod = await import(pathToFileURL(configPath).href).catch((e: Error) => {
+  console.error('Flow: could not load flow.config.ts:', e.message);
+  process.exit(1);
+});
+const getConfig = mod.default;
+const config = typeof getConfig === 'function' ? await getConfig() : getConfig;
+await preview(config);

package/profiles/server/README.md

@@ -1,28 +1,34 @@
 # Flow OS
 
-## Comandi
+Tutti i comandi dalla **root** del repo.
+
+---
+
+## Dev (sviluppo e canale dev)
 
 | Comando | Cosa fa |
-|--------|---------|
-| **dev** | Avvia il server di sviluppo (client + eventuale server). |
-| **build** | Build di produzione del client. |
-| **gen** | Rigenera `profiles/` e `packages/` da `config.json` e dai tag `// @flow: <id>` nei file. |
-| **version** | Aggiorna la versione (patch/minor/major o valore esatto) nei package. Solo i package indicati, altrimenti tutti. |
-| **release** | Pubblica su npm (tag `latest`). Solo i package indicati, altrimenti tutti. |
-| **publish:dev** | Pubblica su npm con tag `dev` (versione `0.0.1-dev.<timestamp>`). |
+|---------|---------|
+| `bun run dev` | Avvia il server di sviluppo (client + server). |
+| `bun run gen` | Rigenera i template (profiles + packages in create-flow). Di solito non serve: lo fa già `publish:dev`. |
+| `bun run publish:dev` | Esegue **gen** + **build** create-flow e pubblica tutto su npm con tag **dev**. |
 
-**Esecuzione**
+**Pubblicare solo un package** (più veloce):
 
 ```bash
-bun run dev
-bun run build
-bun run gen
+bun run publish:dev -- --client
+```
 
-bun run version -- patch
-bun run version -- patch @flow.os/client create-flow-os
+(Stesso comando con `--style`, `--core`, `--router`, `--server` al posto di `--client`.)
 
-bun run release
-bun run release -- @flow.os/client create-flow-os
+---
 
-bun run publish:dev
-```
+## Prod (release su latest)
+
+| Comando | Cosa fa |
+|---------|---------|
+| `bun run version -- <patch|minor|major|X.Y.Z>` | Aggiorna la versione nei package. Es.: `patch` per tutti, oppure `bun run version -- 1.0.0` per impostare tutti a 1.0.0. |
+| `bun run version -- patch @flow.os/client create-flow-os` | Aggiorna solo i package indicati. |
+| `bun run release` | Pubblica su npm con tag **latest**. Va usato **dopo** aver lanciato `version`. |
+| `bun run release -- @flow.os/client create-flow-os` | Pubblica solo i package indicati. |
+
+**Ordine per una release prod:** prima `bun run version -- patch` (o minor/major), poi `bun run release`.