@thatopen/services 0.0.4 → 0.0.5

package/README.md

@@ -1,285 +1,46 @@
 # @thatopen/services
 
-Client library and CLI for building BIM apps and cloud components on the [That Open Platform](https://platform.thatopen.com).
+Client library and CLI for building BIM apps and cloud components on [That Open Platform](https://platform.thatopen.com). Apps run inside the platform's browser environment; cloud components run server-side and can be triggered from any app.
 
 ## Quick Start
 
-### Create a BIM app
+### 1. Install the CLI
 
 ```bash
-# Install the services package globally
-npm i @thatopen/services -g
+npm install -g @thatopen/services@latest
 ```
 
-Then, create a brand new app repository:
+### 2. Choose a project type
 
-```bash
-npx thatopen create my-app
-cd my-app
-npm run dev
-
-# Open your project on platform.thatopen.com and click the debug button
-```
-
-You can also scaffold in the current directory:
-
-```bash
-mkdir my-app && cd my-app
-npx thatopen create .
-npm run dev
-```
-
-### Create a cloud component
-
-```bash
-npx thatopen create my-component --template cloud
-cd my-component
-npm run run   # Build and test locally
-```
-
-### Templates
-
-| Template | Command | What you get |
-|----------|---------|--------------|
-| `bim` (default) | `npx thatopen create my-app` | Three.js + BIM viewer + platform UI components |
-| `default` | `npx thatopen create my-app --template default` | Minimal app showing platform context |
-| `cloud` | `npx thatopen create my-component --template cloud` | Server-side Node.js component |
-| `test` | `npx thatopen create my-tests --template test` | Browser test app that exercises every API endpoint |
-| `cloud-test` | `npx thatopen create my-tests --template cloud-test` | Cloud component test suite for server-side API testing |
-
-Use `npx thatopen create .` to scaffold in the current directory instead of creating a new one.
-
-## What's in this package
-
-- **Library** — `EngineServicesClient` for interacting with the That Open API (files, folders, apps, cloud components, executions, permissions)
-- **CLI** — `thatopen` command for scaffolding and publishing
-- **Built-in component types** — TypeScript stubs for platform-hosted UI components (AppManager, ViewportManager, etc.)
-
-## Library usage
-
-```typescript
-import { EngineServicesClient } from '@thatopen/services';
-
-const client = new EngineServicesClient(accessToken, apiUrl);
-
-// Files
-const files = await client.listFiles();
-await client.createFile({ file: blob, name: "model.ifc", versionTag: "v1" });
-const response = await client.downloadFile(fileId);
-
-// Folders
-const folders = await client.listFolders();
-await client.createFolder("My Folder");
-
-// Cloud component execution
-const { executionId } = await client.executeComponent(componentId, { param: "value" });
-client.onExecutionProgress(executionId, (data) => {
-  console.log(data.progressUpdate, data.messageUpdate);
-});
-```
-
-Inside platform apps, use the Auth0 JWT from the platform context:
-
-```typescript
-const ctx = window.__THATOPEN_CONTEXT__; // { appId, projectId, accessToken, apiUrl }
-const client = new EngineServicesClient(ctx.accessToken, ctx.apiUrl, { useBearer: true });
-```
-
-## CLI commands
-
-| Command | Description |
-|---------|-------------|
-| `thatopen create <name> [--template bim\|default\|cloud\|test\|cloud-test]` | Scaffold a new project (use `.` for current directory) |
-| `thatopen serve [--port N]` | Dev server (esbuild watch + serve bundle) |
-| `thatopen login [--token T] [--local]` | Authenticate with the platform |
-| `thatopen publish` | Build and publish to the platform |
-| `thatopen run [--params '{}']` | Build and test a cloud component locally |
-| `thatopen create-tests [directory]` | Scaffold both a test app and test cloud component |
-| `thatopen serve-tests [directory]` | Serve both the test app and test component in parallel |
-
-## App workflow
-
-Apps run inside the That Open Platform (platform.thatopen.com) within a project. They are served inside the platform's iframe — not as standalone websites.
-
-```bash
-# 1. Create project (dependencies are installed automatically)
-npx thatopen create my-app
-cd my-app
-
-# 2. Develop locally
-npm run dev
-# Open your project on the platform and click the debug button.
-# Live reload is enabled — save a file to rebuild.
-
-# 3. Authenticate
-npm run login -- --token <your-token>
-
-# 4. Publish
-npm run publish
-```
-
-## Cloud component workflow
-
-```bash
-# 1. Create project (dependencies are installed automatically)
-npx thatopen create my-component --template cloud
-cd my-component
-
-# 2. Run locally
-npm run run
-
-# 3. Pass parameters
-npx thatopen run --params '{"inputFile": "model.ifc"}'
-
-# 4. Authenticate and publish
-npm run login -- --token <your-token>
-npm run publish
-```
-
-Cloud components export an `async function main()` that runs on the server. The execution engine provides globals:
-
-| Global | Purpose |
-|--------|---------|
-| `thatOpenServices` | Authenticated `EngineServicesClient` |
-| `executionParams` | Parameters passed by the caller |
-| `executionReporter` | `{ message(msg), progress(pct) }` for live feedback |
-| `OBC` | `@thatopen/components` — BIM engine |
-| `THREE` | `three` — 3D math and geometry |
-| `fs` | Node.js filesystem |
-
-## Built-in components
-
-Platform-hosted UI components loaded at runtime:
-
-```typescript
-import { AppManager, ViewportManager } from "@thatopen/services";
-
-// Register all library globals once
-client.setBuiltInGlobals({ OBC, OBF, BUI, CUI, THREE, FRAGS });
-
-// Load built-in components — globals are automatically applied
-await client.initBuiltInComponent(AppManager, components);
-await client.initBuiltInComponent(ViewportManager, components);
-
-const app = components.get(AppManager);
-const viewports = components.get(ViewportManager);
-const { element, world } = await viewports.create();
-```
-
-| Component | Purpose |
-|-----------|---------|
-| `AppManager` | App shell — CSS grid layout with sidebar for switching layouts |
-| `ViewportManager` | Factory for 3D viewports with pre-configured world |
-| `LoadModelButton` | Button + dropdown for loading IFC / Fragments files |
-| `ViewerToolbar` | Toolbar with Show/Hide/Focus/Isolate and color palette |
-| `ModelsPanel` | Panel listing loaded models with search and load button |
-| `ModelsDropdown` | Dropdown selector listing loaded models |
-| `ClassificationsList` | Hierarchical table of IFC classification data |
-| `ClashesList` | Interactive clash detection results with highlighting |
-| `ClippingsList` | Panel listing clipping planes with controls |
-| `LengthMeasuringsList` | Panel listing length measurements with totals |
-| `AreaMeasuringsList` | Panel listing area measurements with totals |
-| `ColorsPalette` | Color picker with Highlighter style swatches |
-| `HighlightersList` | Panel listing Highlighter styles with manage actions |
-| `QtoComparisonList` | Side-by-side quantity comparison for two elements |
-| `QueriesHierarchy` | Recursive multi-level query browser |
-| `CustomViewLegend` | Color legend overlay |
-| `ScreenshotAnnotator` | Modal for annotating screenshots via MarkerJS |
-
-See `src/built-in/index.ts` for full API reference with config interfaces and `@example` blocks.
-
-## Config files
-
-| File | Scope | Contains |
-|------|-------|----------|
-| `~/.thatopen/config.json` | Global | `accessToken`, `apiUrl` |
-| `.thatopen` (project root) | Per-project (gitignored) | `accessToken`, `apiUrl`, `appId` or `componentId` |
-
-The CLI checks the local `.thatopen` first, then falls back to the global config.
-
----
-
-## Development (working on this repo)
-
-### Setup
-
-```bash
-npm install
-npm run build        # Builds both library and CLI
-```
+| Type | Template | Use when |
+|------|----------|----------|
+| **App** | `app` | You're building a BIM app that runs in the platform's browser UI |
+| **Cloud component** | `cloud-component` | You're building server-side logic triggered by an app |
 
-### Build commands
+### 3. Scaffold
 
-```bash
-npm run build          # Full build (library + CLI)
-npm run build:lib      # Library only
-npm run build:cli      # CLI only
-```
-
-### Testing the CLI locally
+See the full command reference here:
+→ [`docs/cli/create.md`](https://raw.githubusercontent.com/ThatOpen/engine_services/main/docs/cli/create.md)
 
-```bash
-# Link the CLI globally so `thatopen` points to this repo
-npm link
-
-# Build CLI and scaffold a test app
-npm run test:cli-build-app
+To use beta engine libraries instead of the stable ones, see:
+→ [`docs/cli/swap.md`](https://raw.githubusercontent.com/ThatOpen/engine_services/main/docs/cli/swap.md)
 
-# Build and scaffold a test cloud component
-npm run test:cli-build-component
+### 4. Next steps
 
-# Run the test cloud component locally
-npm run test:cli-run-component
-```
+Once scaffolded, open `AGENTS.md` in the scaffolded project root — it has everything needed to start building.
 
-### Running the platform API test suite
-
-The test suite consists of two projects scaffolded together: a **test app** (browser-based, template `test`) and a **test cloud component** (server-side, template `cloud-test`). Both exercise every `EngineServicesClient` endpoint.
-
-```bash
-# 1. Build the CLI and scaffold both test projects into a temp/ directory
-#    (deletes temp/ first if it already exists)
-yarn test:cli-build-tests
-
-# 2. Serve both the test app and the test component's local server
-yarn test:cli-serve-tests
-```
+## What's in this repository
 
-Then open your project on [platform.thatopen.com](https://platform.thatopen.com) and click the debug button. The test app will show a panel with:
+- **Library** — `EngineServicesClient` and `PlatformClient` for interacting with the That Open API (files, folders, apps, cloud components, executions, permissions).
+- **CLI** — `thatopen` command for scaffolding and publishing.
+- **Built-in component types** — TypeScript stubs for platform-hosted components.
 
-- **Context** — current app/project/API info
-- **Execution Config** — input fields for a deployed Component ID and the local server URL (defaults to `http://localhost:4001`)
-- **Controls** — "Run All Tests" button
-- **Results** — test results grouped by API area (Context & Auth, Folders, Files, Hidden Files, Icons, Components, Apps, Execution, Built-in Components)
+## Docs
 
-When execution tests run, the cloud component's output appears in the same Results section as additional groups prefixed with "Local Component:" or "Deployed Component:".
+Full reference for all CLI commands and flags:
+→ [`docs/cli/paths.json`](https://raw.githubusercontent.com/ThatOpen/engine_services/main/docs/cli/paths.json)
 
-### Publishing a new version
+## Contributing
 
-Publishing is handled automatically by CI when a PR with changesets is merged to `main`.
-
-**1. Create a changeset (developer does this with their changes):**
-
-```bash
-yarn changeset
-# Pick the bump type (patch / minor / major) and write a summary
-# This creates a .changeset/<random-name>.md file — commit it with your PR
-```
-
-**2. Merge the PR to `main`:**
-
-CI will automatically:
-- Consume the changeset files
-- Bump `package.json` version and update `CHANGELOG.md`
-- Commit the version bump back to `main`
-- Build and publish to npm
-
-**Manual publishing (if CI is not available):**
-
-```bash
-yarn version           # Consume changesets, bump version
-yarn build
-yarn changeset publish
-```
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup, build commands, and publishing workflow.
 
-Keep in mind the importance of semver — don't release a major for non-breaking changes.

package/dist/cli/commands/swap.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+
+export declare const swapCommand: Command;

package/dist/cli/lib/beta.d.ts

@@ -0,0 +1,2 @@
+/** Public → beta package name mapping. Source of truth for all beta-related logic. */
+export declare const BETA_ALIASES: Record<string, string>;

package/dist/cli/lib/config.d.ts

@@ -15,6 +15,8 @@ export interface ThatOpenLocalConfig {
     itemType?: ProjectType;
     /** Path to an icon file (PNG, WebP, or ICO) uploaded on publish. */
     iconPath?: string;
+    /** Whether this project uses beta engine libraries (@thatopen-platform/*-beta). */
+    beta?: boolean;
 }
 export declare function readLocalConfig(cwd?: string): ThatOpenLocalConfig | null;
 export declare function writeLocalConfig(config: ThatOpenLocalConfig, cwd?: string): void;

package/dist/cli.js

@@ -7980,7 +7980,12 @@ const loginCommand = new Command2("login").description("Authenticate with the Th
     );
   }
 });
-const TEMPLATES = ["default", "bim", "bim-beta", "cloud", "test", "cloud-test"];
+const BETA_ALIASES = {
+  "@thatopen/components": "@thatopen-platform/components-beta",
+  "@thatopen/components-front": "@thatopen-platform/components-front-beta",
+  "@thatopen/fragments": "@thatopen-platform/fragments-beta"
+};
+const TEMPLATES = ["app", "cloud-component"];
 const libVersion = (() => {
   try {
     const pkg2 = JSON.parse(require$$3.readFileSync(require$$2.join(__dirname, "..", "package.json"), "utf-8"));
@@ -7990,13 +7995,13 @@ const libVersion = (() => {
   }
 })();
 const templatesDir = require$$2.join(__dirname, "..", "src", "cli", "templates");
-const createCommand = new Command2("create").argument("<project-name>", 'Name of the project to create (use "." for current directory)').option("-t, --template <template>", `Template (${TEMPLATES.join(", ")})`, "bim").description("Scaffold a new ThatOpen app or cloud component project").action(async (projectName, opts) => {
+const createCommand = new Command2("create").argument("<project-name>", 'Name of the project to create (use "." for current directory)').option("-t, --template <template>", `Template (${TEMPLATES.join(", ")})`, "app").option("--beta", "Use beta engine libraries (@thatopen-platform/*-beta)").description("Scaffold a new ThatOpen app or cloud component project").action(async (projectName, opts) => {
   const template = opts.template;
   if (!TEMPLATES.includes(template)) {
     console.error(`Unknown template "${opts.template}". Available: ${TEMPLATES.join(", ")}`);
     process.exit(1);
   }
-  const isCloud = template === "cloud" || template === "cloud-test";
+  const isCloud = template === "cloud-component";
   const projectKind = isCloud ? "cloud component" : "app";
   const useCurrentDir = projectName === ".";
   const targetDir = useCurrentDir ? process.cwd() : require$$2.resolve(process.cwd(), projectName);
@@ -8005,44 +8010,43 @@ const createCommand = new Command2("create").argument("<project-name>", 'Name of
     console.error(`Directory "${projectName}" already exists.`);
     process.exit(1);
   }
-  console.log(`Creating ThatOpen ${projectKind} "${packageName}" (template: ${template})...`);
+  console.log(`Creating ThatOpen ${projectKind} "${packageName}" (template: ${template}${opts.beta ? ", beta" : ""})...`);
   if (!useCurrentDir) {
     require$$3.mkdirSync(targetDir, { recursive: true });
   }
   require$$3.mkdirSync(require$$2.join(targetDir, "src"), { recursive: true });
   const sharedDir = require$$2.join(templatesDir, "shared");
-  const sharedVariantDir = require$$2.join(sharedDir, isCloud ? "cloud" : "app");
   require$$3.copyFileSync(require$$2.join(sharedDir, "_gitignore"), require$$2.join(targetDir, ".gitignore"));
   require$$3.copyFileSync(require$$2.join(sharedDir, "AGENTS.md"), require$$2.join(targetDir, "AGENTS.md"));
   require$$3.copyFileSync(require$$2.join(sharedDir, "CLAUDE.md"), require$$2.join(targetDir, "CLAUDE.md"));
-  require$$3.copyFileSync(require$$2.join(sharedVariantDir, "tsconfig.json"), require$$2.join(targetDir, "tsconfig.json"));
-  require$$3.copyFileSync(require$$2.join(sharedVariantDir, "vite.config.js"), require$$2.join(targetDir, "vite.config.js"));
-  if (!isCloud) {
-    require$$3.copyFileSync(require$$2.join(sharedVariantDir, "index.html"), require$$2.join(targetDir, "index.html"));
-  }
   const templateDir = require$$2.join(templatesDir, template);
   require$$3.cpSync(templateDir, targetDir, { recursive: true });
   if (isCloud) {
     require$$3.renameSync(require$$2.join(targetDir, "_thatopen"), require$$2.join(targetDir, ".thatopen"));
   }
   const pkgPath = require$$2.join(targetDir, "package.json");
-  const pkg2 = require$$3.readFileSync(pkgPath, "utf-8").replace(/\{\{PROJECT_NAME\}\}/g, packageName).replace(/\{\{VERSION\}\}/g, libVersion).replace(/"@thatopen\/services": "file:[^"]*"/, `"@thatopen/services": "^${libVersion}"`);
-  require$$3.writeFileSync(pkgPath, pkg2);
-  const isBeta = template === "bim-beta";
-  if (isBeta) {
-    console.log("");
-    console.log("This template uses the private BETA engine libraries (@thatopen-platform/*-beta).");
-    console.log("If install fails with a 401/403, configure your beta access token in npm first.");
+  const pkgContent = require$$3.readFileSync(pkgPath, "utf-8").replace(/\{\{PROJECT_NAME\}\}/g, packageName).replace(/\{\{VERSION\}\}/g, libVersion).replace(/"@thatopen\/services": "file:[^"]*"/, `"@thatopen/services": "^${libVersion}"`);
+  require$$3.writeFileSync(pkgPath, pkgContent);
+  if (opts.beta) {
+    const pkg2 = JSON.parse(require$$3.readFileSync(pkgPath, "utf-8"));
+    for (const [stable, beta] of Object.entries(BETA_ALIASES)) {
+      if (pkg2.dependencies?.[stable] !== void 0) {
+        delete pkg2.dependencies[stable];
+        pkg2.dependencies[beta] = "latest";
+      }
+    }
+    require$$3.writeFileSync(pkgPath, JSON.stringify(pkg2, null, 2));
+    updateLocalConfig({ beta: true }, targetDir);
   }
   console.log("");
   console.log("Installing dependencies...");
+  if (opts.beta) {
+    console.log("(Beta packages are private — if this fails with 401/403, configure your beta npm token.)");
+  }
   try {
     require$$1.execSync("npm install", { cwd: targetDir, stdio: "inherit" });
   } catch {
     console.error("Failed to install dependencies. Run `npm install` manually.");
-    if (isBeta) {
-      console.error("Beta packages are private — if this is an auth error, your beta token may not be configured.");
-    }
   }
   console.log("");
   console.log(useCurrentDir ? "  Project ready!" : `  Created ./${projectName}`);
@@ -10719,6 +10723,7 @@ const serveCommand = new Command2("serve").description(
     );
     process.exit(1);
   }
+  const isBeta = readLocalConfig(cwd)?.beta === true;
   const globalName = detectGlobalName(cwd);
   const bundlePath = require$$2.join(cwd, "dist", "bundle.js");
   const mapPath = require$$2.join(cwd, "dist", "bundle.js.map");
@@ -10746,6 +10751,7 @@ const serveCommand = new Command2("serve").description(
     outfile: bundlePath,
     sourcemap: true,
     logLevel: "info",
+    alias: isBeta ? BETA_ALIASES : void 0,
     logOverride: {
       // IIFE format leaves import.meta empty. The only consumer of import.meta
       // in our ecosystem today is @thatopen/fragments' worker URL fallback,
@@ -10836,7 +10842,7 @@ const serveCommand = new Command2("serve").description(
     res.end("Not found");
   });
   server.listen(port, () => {
-    console.log(`Bundle server running at http://localhost:${port}`);
+    console.log(`Bundle server running at http://localhost:${port}${isBeta ? " (beta mode)" : ""}`);
     console.log("");
     console.log(
       "Open your project on the platform and click the debug button."
@@ -11254,8 +11260,11 @@ const localServerCommand = new Command2("local-server").description(
 ).option("--port <port>", "Port for the local server", "4001").option("--skip-build", "Skip the initial build step").action(async (opts) => {
   const cwd = process.cwd();
   const config = requireResolvedConfig(cwd);
+  const isBeta = readLocalConfig(cwd)?.beta === true;
   const port = parseInt(opts.port);
   const bundlePath = require$$2.join(cwd, "dist", "bundle.js");
+  const stableExternals = ["@thatopen/components", "@thatopen/fragments"];
+  const externalPackages = isBeta ? stableExternals.map((p) => BETA_ALIASES[p] ?? p) : stableExternals;
   let esbuild;
   try {
     esbuild = await import("esbuild");
@@ -11275,6 +11284,7 @@ const localServerCommand = new Command2("local-server").description(
       footer: { js: "var main = ThatOpenComponent.main;" },
       outfile: bundlePath,
       logLevel: "info",
+      alias: isBeta ? BETA_ALIASES : void 0,
       logOverride: {
         // Same upstream @nodable/entities duplicate `euro:` key noise
         // silenced in the `serve` command. Cosmetic, no runtime impact.
@@ -11292,7 +11302,7 @@ const localServerCommand = new Command2("local-server").description(
       },
       external: [
         "@thatopen/services",
-        "@thatopen/components",
+        ...externalPackages,
         "three",
         "web-ifc",
         "fs",
@@ -11417,7 +11427,7 @@ const localServerCommand = new Command2("local-server").description(
   });
   server.listen(port, () => {
     console.log("");
-    console.log(`[local-server] Running at http://localhost:${port}`);
+    console.log(`[local-server] Running at http://localhost:${port}${isBeta ? " (beta mode)" : ""}`);
     console.log("");
     console.log("Usage with EngineServicesClient:");
     console.log("");
@@ -11438,114 +11448,64 @@ const localServerCommand = new Command2("local-server").description(
     process.exit(0);
   });
 });
-const createTestsCommand = new Command2("create-tests").argument(
-  "<directory>",
-  "Parent directory for both projects (required to prevent accidental deletion)"
-).option("--app-name <name>", "Name of the test app project", "test-app").option(
-  "--component-name <name>",
-  "Name of the test component project",
-  "test-component"
-).description(
-  "Scaffold both a test app (--template test) and a test cloud component (--template cloud-test)"
-).action(
-  async (directory, opts) => {
-    const parentDir = require$$2.resolve(process.cwd(), directory);
-    const bin = process.argv[1];
-    if (require$$3.existsSync(parentDir)) {
-      console.log(`Removing existing directory "${directory}"...`);
-      require$$3.rmSync(parentDir, { recursive: true, force: true });
-    }
-    require$$3.mkdirSync(parentDir, { recursive: true });
-    console.log("Creating test suite...");
-    console.log("");
-    console.log(`── Creating test app "${opts.appName}" ──`);
-    const appResult = require$$1.spawnSync(
-      process.execPath,
-      [bin, "create", opts.appName, "-t", "test"],
-      { cwd: parentDir, stdio: "inherit" }
-    );
-    if (appResult.status !== 0) {
-      process.exit(appResult.status ?? 1);
+const swapCommand = new Command2("swap").description("Toggle between stable public and beta engine libraries").option("--beta", "Switch to beta libraries").option("--stable", "Switch to stable public libraries").action(async (opts) => {
+  const cwd = process.cwd();
+  const pkgPath = require$$2.join(cwd, "package.json");
+  if (!require$$3.existsSync(pkgPath)) {
+    console.error("No package.json found. Run this from a ThatOpen project.");
+    process.exit(1);
+  }
+  const currentlyBeta = readLocalConfig(cwd)?.beta === true;
+  let targetBeta;
+  if (opts.beta && opts.stable) {
+    console.error("Cannot use --beta and --stable together.");
+    process.exit(1);
+  } else if (opts.beta) {
+    targetBeta = true;
+  } else if (opts.stable) {
+    targetBeta = false;
+  } else {
+    targetBeta = !currentlyBeta;
+  }
+  if (targetBeta === currentlyBeta) {
+    console.log(`Already using ${currentlyBeta ? "beta" : "stable"} libraries. Nothing to do.`);
+    return;
+  }
+  const pkg2 = JSON.parse(require$$3.readFileSync(pkgPath, "utf-8"));
+  if (targetBeta) {
+    for (const [stable, beta] of Object.entries(BETA_ALIASES)) {
+      if (pkg2.dependencies?.[stable] !== void 0) {
+        delete pkg2.dependencies[stable];
+        pkg2.dependencies[beta] = "latest";
+      }
     }
-    console.log("");
-    console.log(`── Creating test component "${opts.componentName}" ──`);
-    const compResult = require$$1.spawnSync(
-      process.execPath,
-      [bin, "create", opts.componentName, "-t", "cloud-test"],
-      { cwd: parentDir, stdio: "inherit" }
+  } else {
+    const cliPkg = JSON.parse(
+      require$$3.readFileSync(require$$2.join(__dirname, "..", "package.json"), "utf-8")
     );
-    if (compResult.status !== 0) {
-      process.exit(compResult.status ?? 1);
+    for (const [stable, beta] of Object.entries(BETA_ALIASES)) {
+      if (pkg2.dependencies?.[beta] !== void 0) {
+        delete pkg2.dependencies[beta];
+        pkg2.dependencies[stable] = cliPkg.devDependencies?.[stable] ?? "latest";
+      }
     }
-    console.log("");
-    console.log("Test suite ready!");
-    console.log("");
-    console.log("Quick start:");
-    console.log(
-      `  1. cd ${opts.componentName} && npm run run   # Run the test component locally`
-    );
+  }
+  require$$3.writeFileSync(pkgPath, JSON.stringify(pkg2, null, 2));
+  updateLocalConfig({ beta: targetBeta }, cwd);
+  console.log(`Switched to ${targetBeta ? "beta" : "stable"} libraries.`);
+  if (targetBeta) {
     console.log(
-      `  2. cd ${opts.appName} && npm run dev          # Start the test app`
+      "Beta packages are private — make sure your beta npm token is configured."
     );
-    console.log("");
   }
-);
-const serveTestsCommand = new Command2("serve-tests").argument(
-  "<directory>",
-  "Parent directory containing both projects"
-).option("--app-name <name>", "Name of the test app project", "test-app").option(
-  "--component-name <name>",
-  "Name of the test component project",
-  "test-component"
-).option("--app-port <port>", "Port for the app bundle server", "4000").option("--component-port <port>", "Port for the component local server", "4001").description(
-  "Serve both the test app (thatopen serve) and the test component (thatopen local-server) in parallel"
-).action(
-  async (directory, opts) => {
-    const parentDir = require$$2.resolve(process.cwd(), directory);
-    const bin = process.argv[1];
-    const appDir = require$$2.resolve(parentDir, opts.appName);
-    const componentDir = require$$2.resolve(parentDir, opts.componentName);
-    console.log("Starting test suite servers...");
-    console.log("");
-    const children = [];
-    function startProcess(label, cwd, args) {
-      const child = require$$1.spawn(process.execPath, [bin, ...args], {
-        cwd,
-        stdio: ["ignore", "pipe", "pipe"]
-      });
-      const prefix = `[${label}]`;
-      child.stdout.on("data", (data) => {
-        for (const line of data.toString().split("\n")) {
-          if (line) console.log(`${prefix} ${line}`);
-        }
-      });
-      child.stderr.on("data", (data) => {
-        for (const line of data.toString().split("\n")) {
-          if (line) console.error(`${prefix} ${line}`);
-        }
-      });
-      child.on("exit", (code) => {
-        console.log(`${prefix} exited with code ${code}`);
-      });
-      children.push(child);
-    }
-    startProcess("component", componentDir, [
-      "local-server",
-      "--port",
-      opts.componentPort
-    ]);
-    startProcess("app", appDir, ["serve", "--port", opts.appPort]);
-    console.log(`[component] ${componentDir} → http://localhost:${opts.componentPort}`);
-    console.log(`[app]       ${appDir} → http://localhost:${opts.appPort}`);
-    console.log("");
-    process.on("SIGINT", () => {
-      for (const child of children) {
-        child.kill("SIGINT");
-      }
-      setTimeout(() => process.exit(0), 500);
-    });
+  console.log("");
+  console.log("Installing dependencies...");
+  try {
+    require$$1.execSync("npm install", { cwd, stdio: "inherit" });
+  } catch {
+    console.error("Failed to install dependencies. Run `npm install` manually.");
   }
-);
+});
 const pkg = JSON.parse(
   require$$3.readFileSync(require$$2.join(__dirname, "..", "package.json"), "utf-8")
 );
@@ -11572,6 +11532,5 @@ program.addCommand(publishCommand);
 program.addCommand(serveCommand);
 program.addCommand(runCommand);
 program.addCommand(localServerCommand);
-program.addCommand(createTestsCommand);
-program.addCommand(serveTestsCommand);
+program.addCommand(swapCommand);
 program.parse(process.argv);

package/dist/core/examples/apps.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/examples/components.d.ts

@@ -0,0 +1 @@
+export {};