@bagelink/workspace 1.7.4 → 1.7.8

package/README.md

@@ -161,7 +161,9 @@ export default defineWorkspace({
 
 ## CLI
 
-### `npx bgl init`
+### Single Project Setup
+
+#### `npx bgl init`
 
 Interactively generate project configuration files:
 - `bgl.config.ts` - Workspace configuration
@@ -180,6 +182,227 @@ npx bgl init
 - Generates netlify.toml with production proxy configuration
 - Safe: prompts before each step
 
+### Workspace (Multi-Project) Setup
+
+#### `npx bgl init --workspace`
+
+Create a workspace with flat structure for multiple projects:
+
+```bash
+npx bgl init --workspace
+
+? Workspace name: › my-workspace
+? Bagel project ID: › my-project
+? Create first project? › Yes
+? First project name: › web
+
+✅ Workspace created successfully!
+```
+
+**Creates structure:**
+```
+my-workspace/
+├── package.json          # Workspace root
+├── bgl.config.ts         # Shared config
+├── tsconfig.json
+├── shared/               # Shared code
+│   ├── package.json
+│   ├── utils/
+│   └── types/
+└── web/                  # First project
+    ├── bgl.config.ts
+    ├── package.json
+    ├── vite.config.ts
+    └── src/
+```
+
+#### `bgl add <project-name>`
+
+Add a new project to workspace:
+
+```bash
+bgl add admin
+bgl add customer
+bgl add mobile
+```
+
+Each project:
+- Gets its own directory at root level
+- Inherits shared config from workspace root
+- Can import from `shared/utils`, `shared/types`, etc.
+- Auto-configures with Vite proxy
+
+#### `bgl list`
+
+List all projects in workspace:
+
+```bash
+bgl list
+
+Projects:
+  - web
+  - admin
+  - customer
+```
+
+### Running Workspace Projects
+
+```bash
+# Run all projects concurrently
+bun run dev
+
+# Run specific project
+bun run dev:admin
+bun run dev:customer
+
+# Build specific project
+bun run build:admin
+
+# Build all projects
+bun run build
+```
+
+**Vite automatically assigns ports:**
+- First project: `http://localhost:5173`
+- Second project: `http://localhost:5174`
+- Third project: `http://localhost:5175`
+- etc.
+
+### Linting Setup
+
+#### `bgl lint init`
+
+Set up linting and formatting in your project:
+
+```bash
+bgl lint init
+
+? Select configurations to set up:
+  ✔ ESLint
+  ✔ Prettier
+  ✔ EditorConfig
+  ○ Git Hooks
+? Install dependencies? › Yes
+
+✅ Created eslint.config.js
+✅ Created .prettierrc
+✅ Created .prettierignore
+✅ Created .editorconfig
+✅ Updated package.json with lint scripts
+```
+
+**Creates:**
+- `eslint.config.js` - ESLint configuration (Vue 3 + TypeScript)
+- `.prettierrc` - Prettier configuration
+- `.prettierignore` - Prettier ignore patterns
+- `.editorconfig` - Editor configuration
+- `.lintstagedrc` - Lint-staged configuration (if git hooks selected)
+
+**Adds scripts:**
+- `bun run lint` - Run linter
+- `bun run lint:fix` - Fix linting issues
+- `bun run format` - Format code
+- `bun run format:check` - Check formatting
+
+**Auto-detects workspace:**
+```bash
+# In workspace root (auto-detected)
+bgl lint init
+✓ Detected workspace mode
+# Sets up at workspace root
+
+# In single project (auto-detected)
+bgl lint init
+# Sets up in current project
+
+# Force modes:
+bgl lint init --workspace  # Force workspace mode
+bgl lint init --project    # Force single project mode
+```
+
+**Workspace detection:**
+- Checks for `workspaces` field in package.json
+- Checks for multiple project directories
+- Auto-applies best mode
+
+### SDK Generation
+
+#### `bgl sdk generate`
+
+Generate TypeScript SDK from OpenAPI specification:
+
+```bash
+bgl sdk generate
+
+? OpenAPI spec URL: › http://localhost:8000/openapi.json
+? Output directory: › ./src/api
+? Split into organized files? › Yes
+
+📡 Fetching OpenAPI spec from: http://localhost:8000/openapi.json
+📁 Output directory: ./src/api
+
+✅ Generated types.d.ts
+✅ Generated api.ts
+✅ Generated index.ts
+🔀 Splitting into organized files...
+✅ Files organized into directories
+
+✅ SDK generated successfully!
+
+Import it in your code:
+  import { api } from './api'
+```
+
+**Features:**
+- Auto-reads `openapi_url` from `bgl.config.ts`
+- Generates TypeScript types from OpenAPI schema
+- Creates type-safe API client
+- Optional file organization (split by endpoints)
+- Works with both local and remote OpenAPI specs
+
+**Auto-detects workspace:**
+```bash
+# In workspace root (auto-detected)
+bgl sdk generate
+✓ Detected workspace mode - will generate for multiple projects
+
+? Select projects to generate SDK for:
+  ✔ admin
+  ✔ customer
+  ✔ mobile
+
+# In single project (auto-detected)
+bgl sdk generate
+# Generates SDK for current project only
+
+# Force modes:
+bgl sdk generate --workspace  # Force workspace mode
+bgl sdk generate --project    # Force single project mode
+```
+
+**Smart behavior:**
+- Auto-detects workspace structure
+- Prompts for project selection in workspace mode
+- Reads `openapi_url` from each project's `bgl.config.ts`
+
+**Generated structure:**
+```
+src/api/
+├── index.ts          # Main export
+├── types.d.ts        # TypeScript types
+└── api.ts            # API client
+
+# Or with --split:
+src/api/
+├── endpoints/
+│   ├── users.ts
+│   ├── auth.ts
+│   └── data.ts
+├── types/
+│   └── index.ts
+└── index.ts
+```
+
 ### `npx bgl --help`
 
 Show CLI help.

package/bin/bgl.ts

@@ -1,22 +1,120 @@
 #!/usr/bin/env node
 import process from 'node:process'
+import { isWorkspace } from '../src/detect.js'
 import { generateWorkspaceConfig } from '../src/init.js'
+import { setupLint } from '../src/lint.js'
+import { generateSDK, generateSDKForWorkspace } from '../src/sdk.js'
+import { addProject, initWorkspace, listProjects } from '../src/workspace.js'
 
-const [,, command] = process.argv
+const [,, command, subcommand, ...args] = process.argv
 
 async function main() {
 	if (command === 'init') {
-		await generateWorkspaceConfig()
+		// Check both subcommand and args for --workspace flag
+		const createWorkspace
+			= subcommand === '--workspace'
+				|| subcommand === '-w'
+				|| args.includes('--workspace')
+				|| args.includes('-w')
+		if (createWorkspace) {
+			await initWorkspace()
+		}
+		else {
+			await generateWorkspaceConfig()
+		}
+	}
+	else if (command === 'add') {
+		const projectName = subcommand // 'bgl add admin' -> subcommand is 'admin'
+		if (!projectName) {
+			console.error('Error: Project name is required')
+			console.log('Usage: bgl add <project-name>')
+			process.exit(1)
+		}
+		await addProject(projectName)
+	}
+	else if (command === 'list') {
+		const projects = listProjects()
+		if (projects.length === 0) {
+			console.log('No projects found')
+		}
+		else {
+			console.log('\nProjects:')
+			projects.forEach((p) => { console.log(`  - ${p}`) })
+			console.log('')
+		}
+	}
+	else if (command === 'lint') {
+		if (subcommand === 'init') {
+			// Auto-detect workspace or allow override
+			const forceWorkspace = args.includes('--workspace') || args.includes('-w')
+			const forceProject = args.includes('--project') || args.includes('-p')
+
+			let workspaceMode = isWorkspace(process.cwd())
+			if (forceWorkspace) workspaceMode = true
+			if (forceProject) workspaceMode = false
+
+			if (workspaceMode) {
+				console.log('✓ Detected workspace mode')
+			}
+
+			await setupLint(process.cwd(), workspaceMode)
+		}
+		else {
+			console.log(`
+Lint Commands:
+  bgl lint init              Set up linting (auto-detects workspace)
+  bgl lint init --workspace  Force workspace mode
+  bgl lint init --project    Force single project mode
+`)
+			process.exit(1)
+		}
+	}
+	else if (command === 'sdk') {
+		if (subcommand === 'generate') {
+			// Auto-detect workspace or allow override
+			const forceWorkspace = args.includes('--workspace') || args.includes('-w')
+			const forceProject = args.includes('--project') || args.includes('-p')
+
+			let workspaceMode = isWorkspace(process.cwd())
+			if (forceWorkspace) workspaceMode = true
+			if (forceProject) workspaceMode = false
+
+			if (workspaceMode) {
+				console.log('✓ Detected workspace mode - will generate for multiple projects')
+				await generateSDKForWorkspace()
+			}
+			else {
+				await generateSDK(process.cwd())
+			}
+		}
+		else {
+			console.log(`
+SDK Commands:
+  bgl sdk generate             Generate SDK (auto-detects workspace)
+  bgl sdk generate --workspace Force workspace mode
+  bgl sdk generate --project   Force single project mode
+`)
+			process.exit(1)
+		}
 	}
 	else {
 		console.log(`
 Bagel Workspace CLI
 
 Usage:
-  bgl init          Generate bgl.config.ts interactively
+  bgl init                  Generate bgl.config.ts for single project
+  bgl init --workspace      Create a new workspace with multiple projects
+  bgl add <name>            Add a new project to workspace
+  bgl list                  List all projects in workspace
+  bgl lint init             Set up linting (auto-detects workspace)
+  bgl sdk generate          Generate SDK (auto-detects workspace)
 
 Options:
-  --help, -h        Show this help message
+  --workspace, -w           Force workspace mode
+  --project, -p             Force single project mode
+  --help, -h                Show this help message
+
+Note: Commands auto-detect workspace mode based on directory structure
 `)
 		process.exit(command === '--help' || command === '-h' ? 0 : 1)
 	}

package/dist/bin/bgl.cjs

@@ -2,7 +2,7 @@
 'use strict';
 
 const process = require('node:process');
-const init = require('../shared/workspace.hk0HFYa9.cjs');
+const detect = require('../shared/workspace.BMTTo3s8.cjs');
 require('node:fs');
 require('node:path');
 require('prompts');
@@ -11,19 +11,94 @@ function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'defau
 
 const process__default = /*#__PURE__*/_interopDefaultCompat(process);
 
-const [, , command] = process__default.argv;
+const [, , command, subcommand, ...args] = process__default.argv;
 async function main() {
   if (command === "init") {
-    await init.generateWorkspaceConfig();
+    const createWorkspace = subcommand === "--workspace" || subcommand === "-w" || args.includes("--workspace") || args.includes("-w");
+    if (createWorkspace) {
+      await detect.initWorkspace();
+    } else {
+      await detect.generateWorkspaceConfig();
+    }
+  } else if (command === "add") {
+    const projectName = subcommand;
+    if (!projectName) {
+      console.error("Error: Project name is required");
+      console.log("Usage: bgl add <project-name>");
+      process__default.exit(1);
+    }
+    await detect.addProject(projectName);
+  } else if (command === "list") {
+    const projects = detect.listProjects();
+    if (projects.length === 0) {
+      console.log("No projects found");
+    } else {
+      console.log("\nProjects:");
+      projects.forEach((p) => {
+        console.log(`  - ${p}`);
+      });
+      console.log("");
+    }
+  } else if (command === "lint") {
+    if (subcommand === "init") {
+      const forceWorkspace = args.includes("--workspace") || args.includes("-w");
+      const forceProject = args.includes("--project") || args.includes("-p");
+      let workspaceMode = detect.isWorkspace(process__default.cwd());
+      if (forceWorkspace) workspaceMode = true;
+      if (forceProject) workspaceMode = false;
+      if (workspaceMode) {
+        console.log("\u2713 Detected workspace mode");
+      }
+      await detect.setupLint(process__default.cwd(), workspaceMode);
+    } else {
+      console.log(`
+Lint Commands:
+  bgl lint init              Set up linting (auto-detects workspace)
+  bgl lint init --workspace  Force workspace mode
+  bgl lint init --project    Force single project mode
+`);
+      process__default.exit(1);
+    }
+  } else if (command === "sdk") {
+    if (subcommand === "generate") {
+      const forceWorkspace = args.includes("--workspace") || args.includes("-w");
+      const forceProject = args.includes("--project") || args.includes("-p");
+      let workspaceMode = detect.isWorkspace(process__default.cwd());
+      if (forceWorkspace) workspaceMode = true;
+      if (forceProject) workspaceMode = false;
+      if (workspaceMode) {
+        console.log("\u2713 Detected workspace mode - will generate for multiple projects");
+        await detect.generateSDKForWorkspace();
+      } else {
+        await detect.generateSDK(process__default.cwd());
+      }
+    } else {
+      console.log(`
+SDK Commands:
+  bgl sdk generate             Generate SDK (auto-detects workspace)
+  bgl sdk generate --workspace Force workspace mode
+  bgl sdk generate --project   Force single project mode
+`);
+      process__default.exit(1);
+    }
   } else {
     console.log(`
 Bagel Workspace CLI
 
 Usage:
-  bgl init          Generate bgl.config.ts interactively
+  bgl init                  Generate bgl.config.ts for single project
+  bgl init --workspace      Create a new workspace with multiple projects
+  bgl add <name>            Add a new project to workspace
+  bgl list                  List all projects in workspace
+  bgl lint init             Set up linting (auto-detects workspace)
+  bgl sdk generate          Generate SDK (auto-detects workspace)
 
 Options:
-  --help, -h        Show this help message
+  --workspace, -w           Force workspace mode
+  --project, -p             Force single project mode
+  --help, -h                Show this help message
+
+Note: Commands auto-detect workspace mode based on directory structure
 `);
     process__default.exit(command === "--help" || command === "-h" ? 0 : 1);
   }

package/dist/bin/bgl.mjs

@@ -1,23 +1,98 @@
 #!/usr/bin/env node
 import process from 'node:process';
-import { g as generateWorkspaceConfig } from '../shared/workspace.R3ocIOTb.mjs';
+import { i as initWorkspace, g as generateWorkspaceConfig, h as addProject, l as listProjects, k as isWorkspace, d as setupLint, f as generateSDKForWorkspace, e as generateSDK } from '../shared/workspace.COhZ__uF.mjs';
 import 'node:fs';
 import 'node:path';
 import 'prompts';
 
-const [, , command] = process.argv;
+const [, , command, subcommand, ...args] = process.argv;
 async function main() {
   if (command === "init") {
-    await generateWorkspaceConfig();
+    const createWorkspace = subcommand === "--workspace" || subcommand === "-w" || args.includes("--workspace") || args.includes("-w");
+    if (createWorkspace) {
+      await initWorkspace();
+    } else {
+      await generateWorkspaceConfig();
+    }
+  } else if (command === "add") {
+    const projectName = subcommand;
+    if (!projectName) {
+      console.error("Error: Project name is required");
+      console.log("Usage: bgl add <project-name>");
+      process.exit(1);
+    }
+    await addProject(projectName);
+  } else if (command === "list") {
+    const projects = listProjects();
+    if (projects.length === 0) {
+      console.log("No projects found");
+    } else {
+      console.log("\nProjects:");
+      projects.forEach((p) => {
+        console.log(`  - ${p}`);
+      });
+      console.log("");
+    }
+  } else if (command === "lint") {
+    if (subcommand === "init") {
+      const forceWorkspace = args.includes("--workspace") || args.includes("-w");
+      const forceProject = args.includes("--project") || args.includes("-p");
+      let workspaceMode = isWorkspace(process.cwd());
+      if (forceWorkspace) workspaceMode = true;
+      if (forceProject) workspaceMode = false;
+      if (workspaceMode) {
+        console.log("\u2713 Detected workspace mode");
+      }
+      await setupLint(process.cwd(), workspaceMode);
+    } else {
+      console.log(`
+Lint Commands:
+  bgl lint init              Set up linting (auto-detects workspace)
+  bgl lint init --workspace  Force workspace mode
+  bgl lint init --project    Force single project mode
+`);
+      process.exit(1);
+    }
+  } else if (command === "sdk") {
+    if (subcommand === "generate") {
+      const forceWorkspace = args.includes("--workspace") || args.includes("-w");
+      const forceProject = args.includes("--project") || args.includes("-p");
+      let workspaceMode = isWorkspace(process.cwd());
+      if (forceWorkspace) workspaceMode = true;
+      if (forceProject) workspaceMode = false;
+      if (workspaceMode) {
+        console.log("\u2713 Detected workspace mode - will generate for multiple projects");
+        await generateSDKForWorkspace();
+      } else {
+        await generateSDK(process.cwd());
+      }
+    } else {
+      console.log(`
+SDK Commands:
+  bgl sdk generate             Generate SDK (auto-detects workspace)
+  bgl sdk generate --workspace Force workspace mode
+  bgl sdk generate --project   Force single project mode
+`);
+      process.exit(1);
+    }
   } else {
     console.log(`
 Bagel Workspace CLI
 
 Usage:
-  bgl init          Generate bgl.config.ts interactively
+  bgl init                  Generate bgl.config.ts for single project
+  bgl init --workspace      Create a new workspace with multiple projects
+  bgl add <name>            Add a new project to workspace
+  bgl list                  List all projects in workspace
+  bgl lint init             Set up linting (auto-detects workspace)
+  bgl sdk generate          Generate SDK (auto-detects workspace)
 
 Options:
-  --help, -h        Show this help message
+  --workspace, -w           Force workspace mode
+  --project, -p             Force single project mode
+  --help, -h                Show this help message
+
+Note: Commands auto-detect workspace mode based on directory structure
 `);
     process.exit(command === "--help" || command === "-h" ? 0 : 1);
   }

package/dist/index.cjs

@@ -3,7 +3,7 @@
 const node_fs = require('node:fs');
 const node_path = require('node:path');
 const process = require('node:process');
-const init = require('./shared/workspace.hk0HFYa9.cjs');
+const detect = require('./shared/workspace.BMTTo3s8.cjs');
 require('prompts');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
@@ -32,7 +32,7 @@ async function resolveConfig(mode = "development", options = {}) {
     currentDir = parentDir;
   }
   if (options.interactive !== false) {
-    await init.generateWorkspaceConfig(root, configFile);
+    await detect.generateWorkspaceConfig(root, configFile);
     const newConfig = await loadConfig(localConfigPath, mode);
     if (newConfig) {
       return newConfig;
@@ -131,13 +131,13 @@ function createWorkspace(options = {}) {
      * Generate Netlify configuration file
      */
     generateNetlify(config, outPath = "./netlify.toml", additionalConfig) {
-      init.writeNetlifyConfig(config, outPath, additionalConfig);
+      detect.writeNetlifyConfig(config, outPath, additionalConfig);
     },
     /**
      * Set build environment variables
      */
     setBuildEnv(config) {
-      init.setBuildEnvVars(config);
+      detect.setBuildEnvVars(config);
     },
     /**
      * Clear cached configuration
@@ -148,12 +148,20 @@ function createWorkspace(options = {}) {
   };
 }
 
-exports.generateNetlifyConfig = init.generateNetlifyConfig;
-exports.generateNetlifyRedirect = init.generateNetlifyRedirect;
-exports.generateWorkspaceConfig = init.generateWorkspaceConfig;
-exports.generateWorkspaceConfigSync = init.generateWorkspaceConfigSync;
-exports.setBuildEnvVars = init.setBuildEnvVars;
-exports.writeNetlifyConfig = init.writeNetlifyConfig;
+exports.addProject = detect.addProject;
+exports.generateNetlifyConfig = detect.generateNetlifyConfig;
+exports.generateNetlifyRedirect = detect.generateNetlifyRedirect;
+exports.generateSDK = detect.generateSDK;
+exports.generateSDKForWorkspace = detect.generateSDKForWorkspace;
+exports.generateWorkspaceConfig = detect.generateWorkspaceConfig;
+exports.generateWorkspaceConfigSync = detect.generateWorkspaceConfigSync;
+exports.getWorkspaceInfo = detect.getWorkspaceInfo;
+exports.initWorkspace = detect.initWorkspace;
+exports.isWorkspace = detect.isWorkspace;
+exports.listProjects = detect.listProjects;
+exports.setBuildEnvVars = detect.setBuildEnvVars;
+exports.setupLint = detect.setupLint;
+exports.writeNetlifyConfig = detect.writeNetlifyConfig;
 exports.createCustomProxy = createCustomProxy;
 exports.createViteProxy = createViteProxy;
 exports.createWorkspace = createWorkspace;

package/dist/index.d.cts

@@ -91,6 +91,46 @@ declare function createCustomProxy(paths: string[], target: string, options?: {
     secure?: boolean;
 }): ProxyConfig;
 
+/**
+ * Set up linting in a project
+ */
+declare function setupLint(root?: string, isWorkspace?: boolean): Promise<void>;
+
+/**
+ * Generate SDK from OpenAPI spec
+ */
+declare function generateSDK(root?: string): Promise<void>;
+/**
+ * Generate SDK for all projects in workspace
+ */
+declare function generateSDKForWorkspace(root?: string): Promise<void>;
+
+/**
+ * Initialize a new workspace with flat structure
+ */
+declare function initWorkspace(root?: string): Promise<void>;
+/**
+ * Add a new project to the workspace
+ */
+declare function addProject(name: string, root?: string): Promise<void>;
+/**
+ * List all projects in workspace
+ */
+declare function listProjects(root?: string): string[];
+
+/**
+ * Detect if current directory is a workspace root
+ */
+declare function isWorkspace(root?: string): boolean;
+/**
+ * Get workspace info
+ */
+declare function getWorkspaceInfo(root?: string): {
+    isWorkspace: boolean;
+    projects: string[];
+    hasShared: boolean;
+};
+
 /**
  * Define workspace configuration
  * Simple helper to get config from a config map
@@ -123,5 +163,5 @@ declare function createWorkspace(options?: WorkspaceOptions): {
     clearCache(): void;
 };
 
-export { createCustomProxy, createViteProxy, createWorkspace, defineWorkspace, generateNetlifyConfig, generateNetlifyRedirect, generateWorkspaceConfig, generateWorkspaceConfigSync, mergeConfigs, resolveConfig, setBuildEnvVars, writeNetlifyConfig };
+export { addProject, createCustomProxy, createViteProxy, createWorkspace, defineWorkspace, generateNetlifyConfig, generateNetlifyRedirect, generateSDK, generateSDKForWorkspace, generateWorkspaceConfig, generateWorkspaceConfigSync, getWorkspaceInfo, initWorkspace, isWorkspace, listProjects, mergeConfigs, resolveConfig, setBuildEnvVars, setupLint, writeNetlifyConfig };
 export type { ProxyConfig, WorkspaceConfig, WorkspaceEnvironment, WorkspaceOptions };