feat(template): sync app template to current viewer (A2/UIManager) + gate app to --beta

- Re-sync the app template from the canonical bim-viewer (post-A2: top-app/
  top-viewer/UIManager), replacing the stale pre-A2 port.
- Strip the local-dev :4100 builtin-override block from the template main.ts.
- Gate the 'app' template to --beta: it depends on beta-only engine APIs
  (deferred postproduction, adaptive resolution, Outliner extras, fragments
  Table API, components-front NearPlaneLineMaterial, nested-relations props
  spec). Without --beta, error clearly — public engine support lands in Oct.
  cloud-component template is unaffected.

Author: agviegas

src/cli/commands/create.ts

@@ -34,6 +34,19 @@ export const createCommand = new Command('create')
       process.exit(1);
     }
 
+    // The app template (the full BIM viewer) currently depends on engine APIs
+    // that only exist in the beta libraries. Until the public engine catches up
+    // (October release), scaffolding the app without --beta would produce a
+    // project that doesn't type-check or run — so require --beta explicitly.
+    if (template === 'app' && !opts.beta) {
+      console.error(
+        'The "app" template currently requires the beta engine libraries.\n\n' +
+        `  thatopen create ${projectName} --beta\n\n` +
+        'Public (non-beta) engine support is coming with the October release.',
+      );
+      process.exit(1);
+    }
+
     const isCloud = template === 'cloud-component';
     const projectKind = isCloud ? 'cloud component' : 'app';
     const useCurrentDir = projectName === '.';

src/cli/templates/app/src/app.ts

@@ -1,15 +1,37 @@
-import * as OBC from "@thatopen/components";
-import * as BUI from "@thatopen/ui";
-import { AppManager } from "@thatopen/services";
-import { icons } from "./globals";
-
-export type App = {
-  icons: (keyof typeof icons)[];
-  grid: BUI.Grid<
-    ["Explorer", "Files", "Graphics"],
-    ["viewer", "explorer", "files", "graphics"]
-  >;
+import { PlatformClient, ProjectData } from "@thatopen/services";
+
+// ─── A2 migration shim ───────────────────────────────────────────────────────
+// Pre-A2 the platform `AppManager` built-in held the platform `client` +
+// `projectData`, reached via `components.get(AppManager)`. Juan removed
+// AppManager (consolidated into UIManager / top-app). top-app now owns that
+// state and exposes it via lit contexts — but a few non-lit call sites
+// (CloudRunner, data-table-panel, app-info-section) just need `.client` /
+// `.projectData` synchronously. This tiny module holds them, set once from
+// main.ts, and keeps `getAppManager(...)` returning the same `{ client,
+// projectData }` shape those call sites expect.
+
+let _client: PlatformClient | undefined;
+let _projectData: ProjectData | undefined;
+
+/** Called once from main.ts after the platform client (and projectData) exist. */
+export const setAppContext = (
+  client: PlatformClient,
+  projectData?: ProjectData,
+) => {
+  _client = client;
+  _projectData = projectData;
 };
 
-export const getAppManager = (components: OBC.Components) =>
-  components.get(AppManager<App>);
+/**
+ * Back-compat accessor mirroring the old `components.get(AppManager)` surface
+ * the remaining call sites use (`.client` / `.projectData`). The `components`
+ * arg is ignored — kept only for signature compatibility with existing callers.
+ */
+export const getAppManager = (_components?: unknown) => ({
+  get client() {
+    return _client;
+  },
+  get projectData() {
+    return _projectData;
+  },
+});

src/cli/templates/app/src/bim-components/CloudRunner/index.ts

@@ -1,5 +1,5 @@
 import * as OBC from "@thatopen/components";
-import { AppManager } from "@thatopen/services";
+import { getAppManager } from "../../app";
 import { CloudRunnerStatus } from "./src";
 
 export class CloudRunner extends OBC.Component {
@@ -24,9 +24,13 @@ export class CloudRunner extends OBC.Component {
   }
 
   async run(useLocal: boolean) {
-    // Resolve client at call time via AppManager — never store it as a field.
-    const app = this.components.get(AppManager);
-    const client = app.client;
+    // Resolve client at call time via the app shim — never store it as a field.
+    const client = getAppManager(this.components).client;
+    if (!client) {
+      this.status = "No platform client available.";
+      this._trigger();
+      return;
+    }
 
     client.localServerUrl = useLocal ? this.localServerUrl : null;