npm - @thatopen/services - Versions diffs - 0.7.0 → 0.9.0 - Mend

@thatopen/services 0.7.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (77) hide show

package/README.md +62 -62
package/dist/built-in/index.d.ts +66 -41
package/dist/cli/lib/revit-addin.d.ts +8 -0
package/dist/cli.js +154 -13
package/dist/core/client.d.ts +6 -0
package/dist/core/platform-client.d.ts +139 -0
package/dist/core/platform-client.live.test.d.ts +1 -0
package/dist/core/platform-client.notifications.test.d.ts +1 -0
package/dist/index.cjs.js +2 -2
package/dist/index.d.ts +1 -0
package/dist/index.es.js +635 -445
package/dist/types/notifications.d.ts +54 -0
package/dist/vite-env.d.ts +1 -1
package/docs/ai-quickstart.md +120 -1
package/docs/cli/create.md +29 -29
package/docs/cli/local-server.md +38 -38
package/docs/cli/login.md +32 -32
package/docs/cli/publish.md +31 -31
package/docs/cli/run.md +26 -26
package/docs/cli/serve.md +43 -43
package/docs/cli/swap.md +30 -30
package/docs/flow-plugin-guide.md +26 -0
package/docs/revit-collab-quickstart.md +26 -17
package/docs/rhino-interop-quickstart.md +74 -7
package/package.json +1 -1
package/resources/AGENTS.md +40 -40
package/src/built-in/CDEManager/example.ts +214 -214
package/src/built-in/CDEManager/examples/FileEditing/example.ts +226 -226
package/src/built-in/CDEManager/examples/FileMoves/example.ts +186 -186
package/src/built-in/CDEManager/examples/FileOperations/example.ts +295 -295
package/src/built-in/CDEManager/examples/FileTransfers/example.ts +210 -210
package/src/built-in/CDEManager/examples/FolderManagement/example.ts +230 -230
package/src/built-in/CDEManager/examples/MetadataSchema/example.ts +230 -230
package/src/built-in/CDEManager/examples/MetadataViews/example.ts +166 -166
package/src/built-in/CDEManager/examples/ProjectConfig/example.ts +177 -177
package/src/built-in/UIManager/src/app/example.ts +97 -97
package/src/built-in/UIManager/src/app/examples/AppState/example.ts +140 -140
package/src/built-in/UIManager/src/app/examples/Banner/example.ts +159 -159
package/src/built-in/UIManager/src/app/examples/Contexts/example.ts +123 -123
package/src/built-in/UIManager/src/app/examples/FileDrop/example.ts +124 -124
package/src/built-in/UIManager/src/app/examples/FloatingLayout/example.ts +90 -90
package/src/built-in/UIManager/src/app/examples/Modal/example.ts +163 -163
package/src/built-in/UIManager/src/app/examples/Notifications/example.ts +133 -133
package/src/built-in/UIManager/src/app/examples/ProjectFileStorage/example.ts +150 -150
package/src/built-in/UIManager/src/app/examples/Sidebar/example.ts +102 -102
package/src/built-in/UIManager/src/clashes-panel/example.ts +183 -183
package/src/built-in/UIManager/src/git-history-panel/example.ts +70 -70
package/src/built-in/UIManager/src/models-list/example.ts +122 -122
package/src/built-in/UIManager/src/topics-panel/example.ts +170 -170
package/src/built-in/index.ts +66 -41
package/src/cli/templates/app/index.html +35 -35
package/src/cli/templates/app/package.json +32 -32
package/src/cli/templates/app/src/bim-components/CloudRunner/index.ts +95 -95
package/src/cli/templates/app/src/bim-components/CloudRunner/src/index.ts +1 -1
package/src/cli/templates/app/src/bim-components/CloudRunner/src/types.ts +5 -5
package/src/cli/templates/app/src/bim-components/index.ts +1 -1
package/src/cli/templates/app/src/globals.ts +1 -1
package/src/cli/templates/app/src/main.history.ts +191 -0
package/src/cli/templates/app/src/ui-components/app-info-section/index.ts +26 -26
package/src/cli/templates/app/src/ui-components/app-info-section/src/index.ts +1 -1
package/src/cli/templates/app/src/ui-components/app-info-section/src/types.ts +15 -15
package/src/cli/templates/app/src/ui-components/cloud-runner-section/index.ts +37 -37
package/src/cli/templates/app/src/ui-components/cloud-runner-section/src/index.ts +1 -1
package/src/cli/templates/app/src/ui-components/cloud-runner-section/src/types.ts +14 -14
package/src/cli/templates/app/src/ui-components/index.ts +2 -2
package/src/cli/templates/app/tsconfig.json +16 -16
package/src/cli/templates/app/vite.config.js +57 -57
package/src/cli/templates/cloud-component/README.md +205 -205
package/src/cli/templates/cloud-component/_thatopen +5 -5
package/src/cli/templates/cloud-component/declarations.json +4 -4
package/src/cli/templates/cloud-component/package.json +21 -21
package/src/cli/templates/cloud-component/src/main.ts +70 -70
package/src/cli/templates/cloud-component/tsconfig.json +16 -16
package/src/cli/templates/cloud-component/vite.config.js +46 -46
package/src/cli/templates/shared/AGENTS.md +8 -8
package/src/cli/templates/shared/CLAUDE.md +1 -1
package/src/cli/templates/shared/_gitignore +5 -5

package/src/cli/templates/app/index.html CHANGED Viewed

@@ -1,35 +1,35 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>ThatOpen App</title>
-  <style>
-    *, *::before, *::after { margin: 0; padding: 0; box-sizing: border-box; }
-    html, body { width: 100%; height: 100%; overflow: hidden; font-family: system-ui, -apple-system, sans-serif; }
-    #that-open-app { width: 100%; height: 100%; }
-    /* Scrollbar rail = the panel surface (#262629). Every panel (app .xxx-vp
-       tracks) and every bim-* shadow-DOM scrollbar reads var(--bim-scrollbar--bgc,
-       …), so defining it once here makes all rails match the surface instead of
-       falling back to the lighter bg-contrast-40 (#5F5F64).
-       NOTE: must use --bim-ui_gray-1 (defined UNCONDITIONALLY at :root = #262629),
-       not --bim-ui_bg-contrast-* (only defined under @media/theme-class scopes, so
-       it doesn't resolve at <html>:root and left --bim-scrollbar--bgc unset). */
-    :root { --bim-scrollbar--bgc: var(--bim-ui_gray-1, #262629); }
-  </style>
-</head>
-<body>
-  <div id="that-open-app"></div>
-  <script>
-    // Simulates the context that the platform provides in production.
-    // When running inside the platform iframe, these values come from query params.
-    window.__THATOPEN_CONTEXT__ = {
-      appId: 'local-dev',
-      projectId: 'local-project',
-      accessToken: '',
-      apiUrl: 'http://localhost:3000',
-    };
-  </script>
-  <script type="module" src="/src/main.ts"></script>
-</body>
-</html>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>ThatOpen App</title>
+  <style>
+    *, *::before, *::after { margin: 0; padding: 0; box-sizing: border-box; }
+    html, body { width: 100%; height: 100%; overflow: hidden; font-family: system-ui, -apple-system, sans-serif; }
+    #that-open-app { width: 100%; height: 100%; }
+    /* Scrollbar rail = the panel surface (#262629). Every panel (app .xxx-vp
+       tracks) and every bim-* shadow-DOM scrollbar reads var(--bim-scrollbar--bgc,
+       …), so defining it once here makes all rails match the surface instead of
+       falling back to the lighter bg-contrast-40 (#5F5F64).
+       NOTE: must use --bim-ui_gray-1 (defined UNCONDITIONALLY at :root = #262629),
+       not --bim-ui_bg-contrast-* (only defined under @media/theme-class scopes, so
+       it doesn't resolve at <html>:root and left --bim-scrollbar--bgc unset). */
+    :root { --bim-scrollbar--bgc: var(--bim-ui_gray-1, #262629); }
+  </style>
+</head>
+<body>
+  <div id="that-open-app"></div>
+  <script>
+    // Simulates the context that the platform provides in production.
+    // When running inside the platform iframe, these values come from query params.
+    window.__THATOPEN_CONTEXT__ = {
+      appId: 'local-dev',
+      projectId: 'local-project',
+      accessToken: '',
+      apiUrl: 'http://localhost:3000',
+    };
+  </script>
+  <script type="module" src="/src/main.ts"></script>
+</body>
+</html>

package/src/cli/templates/app/package.json CHANGED Viewed

@@ -1,33 +1,33 @@
-{
-  "name": "{{PROJECT_NAME}}",
-  "version": "1.0.0",
-  "private": true,
-  "scripts": {
-    "dev": "thatopen serve",
-    "build": "vite build",
-    "login": "thatopen login --local",
-    "publish": "thatopen publish"
-  },
-  "dependencies": {
-    "@lit/context": "^1.1.6",
-    "lit": "^3.0.0",
-    "@markerjs/markerjs3": "^3.9.0",
-    "@thatopen/components": "~3.4.0",
-    "@thatopen/components-front": "~3.4.0",
-    "@thatopen/fragments": "~3.4.0",
-    "@thatopen/services": "file:../../../..",
-    "@thatopen/ui": "~3.4.0",
-    "three": "0.185.0",
-    "@sparkjsdev/spark": "^0.1.10",
-    "3d-tiles-renderer": "^0.4.28",
-    "camera-controls": "^3.1.2",
-    "opentype.js": "1.3.4",
-    "potree-core": "^2.0.15",
-    "web-ifc": "^0.0.77"
-  },
-  "devDependencies": {
-    "@types/three": "^0.182.0",
-    "typescript": "^5.2.0",
-    "vite": "^5.2.0"
-  }
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "thatopen serve",
+    "build": "vite build",
+    "login": "thatopen login --local",
+    "publish": "thatopen publish"
+  },
+  "dependencies": {
+    "@lit/context": "^1.1.6",
+    "lit": "^3.0.0",
+    "@markerjs/markerjs3": "^3.9.0",
+    "@thatopen/components": "~3.4.0",
+    "@thatopen/components-front": "~3.4.0",
+    "@thatopen/fragments": "~3.4.0",
+    "@thatopen/services": "file:../../../..",
+    "@thatopen/ui": "~3.4.0",
+    "three": "0.185.0",
+    "@sparkjsdev/spark": "^0.1.10",
+    "3d-tiles-renderer": "^0.4.28",
+    "camera-controls": "^3.1.2",
+    "opentype.js": "1.3.4",
+    "potree-core": "^2.0.15",
+    "web-ifc": "^0.0.77"
+  },
+  "devDependencies": {
+    "@types/three": "^0.182.0",
+    "typescript": "^5.2.0",
+    "vite": "^5.2.0"
+  }
 }

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

@@ -1,95 +1,95 @@
-import * as OBC from "@thatopen/components";
-import { getAppManager } from "../../app";
-import { CloudRunnerStatus } from "./src";
-export class CloudRunner extends OBC.Component {
-  static readonly uuid = "7c4e5d3b-2a1f-4e8d-9b6c-0a3f7e2c5d1b" as const;
-  enabled = true;
-  readonly onExecutionUpdated = new OBC.Event<CloudRunnerStatus>();
-  // TODO: Replace with your actual component ID after publishing.
-  componentId = "your-component-id";
-  localServerUrl = "http://localhost:4001";
-  // Reactive state — read by the UI template on each render.
-  status = "Idle";
-  progress = 0;
-  messages: string[] = [];
-  constructor(components: OBC.Components) {
-    super(components);
-    components.add(CloudRunner.uuid, this);
-  }
-  async run(useLocal: boolean) {
-    // 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;
-    this.status = useLocal ? "Starting (local)..." : "Starting (deployed)...";
-    this.progress = 0;
-    this.messages = [];
-    this._trigger();
-    try {
-      const { executionId } = await client.executeComponent(this.componentId, {
-        greeting: "Hello from the BIM app!",
-      });
-      this.status = `Running (${executionId.slice(0, 8)}...)`;
-      this._trigger();
-      // Subscribe to real-time progress updates via WebSocket.
-      client.onExecutionProgress(executionId, (data) => {
-        if (data.progressUpdate) {
-          this.progress = data.progressUpdate.progress;
-          if (data.progressUpdate.result) {
-            this.status = `${data.progressUpdate.result}: ${data.progressUpdate.resultMessage ?? "Done"}`;
-          }
-        }
-        if (data.messageUpdate) {
-          this.messages.push(data.messageUpdate.content);
-        }
-        this._trigger();
-      });
-      // Poll once after a short delay to catch fast executions that complete
-      // before the WebSocket subscription is established.
-      setTimeout(async () => {
-        try {
-          const exec = await client.getExecution(executionId);
-          if (exec.result) {
-            this.progress = exec.progress;
-            this.status = `${exec.result}: ${exec.resultMessage ?? "Done"}`;
-            this._trigger();
-          }
-        } catch {
-          /* WebSocket handles it */
-        }
-      }, 2000);
-    } catch (err) {
-      this.status = `Error: ${err}`;
-      this._trigger();
-    } finally {
-      client.localServerUrl = null;
-    }
-  }
-  private _trigger() {
-    this.onExecutionUpdated.trigger({
-      status: this.status,
-      progress: this.progress,
-      messages: [...this.messages],
-    });
-  }
-}
-export * from "./src";
+import * as OBC from "@thatopen/components";
+import { getAppManager } from "../../app";
+import { CloudRunnerStatus } from "./src";
+export class CloudRunner extends OBC.Component {
+  static readonly uuid = "7c4e5d3b-2a1f-4e8d-9b6c-0a3f7e2c5d1b" as const;
+  enabled = true;
+  readonly onExecutionUpdated = new OBC.Event<CloudRunnerStatus>();
+  // TODO: Replace with your actual component ID after publishing.
+  componentId = "your-component-id";
+  localServerUrl = "http://localhost:4001";
+  // Reactive state — read by the UI template on each render.
+  status = "Idle";
+  progress = 0;
+  messages: string[] = [];
+  constructor(components: OBC.Components) {
+    super(components);
+    components.add(CloudRunner.uuid, this);
+  }
+  async run(useLocal: boolean) {
+    // 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;
+    this.status = useLocal ? "Starting (local)..." : "Starting (deployed)...";
+    this.progress = 0;
+    this.messages = [];
+    this._trigger();
+    try {
+      const { executionId } = await client.executeComponent(this.componentId, {
+        greeting: "Hello from the BIM app!",
+      });
+      this.status = `Running (${executionId.slice(0, 8)}...)`;
+      this._trigger();
+      // Subscribe to real-time progress updates via WebSocket.
+      client.onExecutionProgress(executionId, (data) => {
+        if (data.progressUpdate) {
+          this.progress = data.progressUpdate.progress;
+          if (data.progressUpdate.result) {
+            this.status = `${data.progressUpdate.result}: ${data.progressUpdate.resultMessage ?? "Done"}`;
+          }
+        }
+        if (data.messageUpdate) {
+          this.messages.push(data.messageUpdate.content);
+        }
+        this._trigger();
+      });
+      // Poll once after a short delay to catch fast executions that complete
+      // before the WebSocket subscription is established.
+      setTimeout(async () => {
+        try {
+          const exec = await client.getExecution(executionId);
+          if (exec.result) {
+            this.progress = exec.progress;
+            this.status = `${exec.result}: ${exec.resultMessage ?? "Done"}`;
+            this._trigger();
+          }
+        } catch {
+          /* WebSocket handles it */
+        }
+      }, 2000);
+    } catch (err) {
+      this.status = `Error: ${err}`;
+      this._trigger();
+    } finally {
+      client.localServerUrl = null;
+    }
+  }
+  private _trigger() {
+    this.onExecutionUpdated.trigger({
+      status: this.status,
+      progress: this.progress,
+      messages: [...this.messages],
+    });
+  }
+}
+export * from "./src";

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

	@@ -1 +1 @@
1	- export * from "./types";
1	+ export * from "./types";

package/src/cli/templates/app/src/bim-components/CloudRunner/src/types.ts CHANGED Viewed

@@ -1,5 +1,5 @@
-export interface CloudRunnerStatus {
-  status: string;
-  progress: number;
-  messages: string[];
-}
+export interface CloudRunnerStatus {
+  status: string;
+  progress: number;
+  messages: string[];
+}

package/src/cli/templates/app/src/bim-components/index.ts CHANGED Viewed

	@@ -1 +1 @@
1	- export * from "./CloudRunner";
1	+ export * from "./CloudRunner";

package/src/cli/templates/app/src/globals.ts CHANGED Viewed

	@@ -1 +1 @@
1	- export const icons = {};
1	+ export const icons = {};

package/src/cli/templates/app/src/main.history.ts ADDED Viewed

@@ -0,0 +1,191 @@
+import * as THREE from "three";
+import * as OBC from "@thatopen/components";
+import * as OBF from "@thatopen/components-front";
+import * as FRAGS from "@thatopen/fragments";
+// Inlines the fragments worker so it runs inside the platform's sandboxed iframe.
+import "@thatopen/fragments/inline";
+import * as BUI from "@thatopen/ui";
+import * as MARKERJS from "@markerjs/markerjs3";
+import {
+  PlatformClient,
+  UIManager,
+  GitHistoryManager,
+} from "@thatopen/services";
+import { setAppContext } from "./app";
+// The standard app, plus the revit-flow commit history: a History layout with the
+// timeline beside the viewer. Scaffolded by `thatopen create <name> --beta --history`.
+//
+// THE BOOT ORDER IS THE WHOLE TRICK, and it is why this ships as a file rather than
+// as instructions. GitHistoryManager reads the commit .frag files and colours the
+// elements of a commit, so it reaches for FragmentsManager and for the 3D world the
+// moment it starts. FragmentsManager is initialised inside top-app's own `setup`
+// below, and the world does not exist until <top-app> is in the DOM and top-viewer
+// has built it. Call `init(client)` where it reads naturally, right after
+// `client.setup`, and you get "FragmentsManager not initialized" plus a pair of
+// undefined `onHighlight` / `onClear` errors, none of which say "too early".
+async function main() {
+  const client = PlatformClient.fromPlatformContext();
+  // Brand accent (purple) — drives layout-selector active state, dividers, etc.
+  document.documentElement.style.setProperty("--bim-ui_accent-base", "#6528d7");
+  // The dev `thatopen serve` wrapper HTML doesn't zero the UA body margin (8px),
+  // which insets the whole app inside the platform iframe. Kill it here so it's
+  // fixed in both dev and production regardless of the host page.
+  document.body.style.margin = "0";
+  // 1 ── UIManager registers the platform web components (top-app, top-viewer, …)
+  // before the DOM renders. GitHistoryManager is the headless half of the history
+  // panel: <top-git-history> is intent-only and asks the registry for it by uuid,
+  // so without this registration the panel mounts and stays inert.
+  const { components } = await client.setup<OBC.Components>(
+    { OBC, OBF, BUI, THREE, FRAGS, MARKERJS },
+    { uuid: UIManager.uuid },
+    { uuid: GitHistoryManager.uuid },
+  );
+  components.get(UIManager).init();
+  // One STABLE top-viewer node, returned by reference so re-rendering top-app
+  // reuses it instead of disposing and recreating its world.
+  const viewerEl = document.createElement("top-viewer");
+  viewerEl.style.border = "1px solid var(--bim-ui_bg-contrast-20)";
+  viewerEl.style.borderRadius = "0.75rem";
+  viewerEl.style.boxSizing = "border-box";
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const app = document.createElement("top-app") as any;
+  // 2 ── this callback is what initialises FragmentsManager. Nothing that needs
+  // fragments may run before it has resolved.
+  app.setup = (waitUntil: (p: Promise<void>, label?: string) => void) => {
+    waitUntil(
+      (async () => {
+        const fragments = components.get(OBC.FragmentsManager);
+        const workerUrl = await FRAGS.FragmentsModels.getWorker();
+        fragments.init(await FRAGS.toClassicWorker(workerUrl), {
+          classicWorker: true,
+        });
+      })(),
+      "Fragments Core",
+    );
+    return { components, client };
+  };
+  // Mount minimally first (viewer only) so top-viewer creates the world.
+  app.elements = { viewer: () => BUI.html`${viewerEl}` };
+  app.layouts = {
+    Main: {
+      label: "Main",
+      icon: "solar:3d-square-bold",
+      template: `"viewer" 1fr / 1fr`,
+    },
+  };
+  app.layout = "Main";
+  const container = document.getElementById("that-open-app") ?? document.body;
+  container.appendChild(app);
+  // 3 ── the world is created asynchronously by top-viewer. Wait for it.
+  await firstWorld(components.get(OBC.Worlds));
+  // Platform client + project data for the AppManager-shim consumers.
+  const projectId: string | undefined = client?.context?.projectId;
+  let projectData;
+  try {
+    if (projectId) projectData = await client.getProjectData(projectId);
+  } catch {
+    /* dev/no-project → consumers degrade gracefully */
+  }
+  setAppContext(client, projectData);
+  // 4 ── ONLY NOW. Everything above had to have happened first. Read the comment
+  // at the top of this file before moving this line.
+  await components.get(GitHistoryManager).init(client);
+  // Pluggable loaders for <top-models-list>. Heavy, app-specific loaders are
+  // registered here so they stay OUT of the built-in's bundle.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  let rcViewer: any = null;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const modelLoaders: Record<string, any> = {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    "3tz": async (fileId: string, ctx: any) => {
+      if (!rcViewer) {
+        const { realityCaptureViewer } = await import(
+          "./setups/reality-capture-viewer"
+        );
+        rcViewer = realityCaptureViewer(ctx.components, client);
+      }
+      const saved = ctx.getAlignment(fileId) as number[] | undefined;
+      await rcViewer.loadIntoWorld(fileId, {
+        keepPostproduction: true,
+        transform: saved ? new THREE.Matrix4().fromArray(saved) : undefined,
+        onTransformChange: (m: THREE.Matrix4) =>
+          ctx.setAlignment(fileId, m.toArray()),
+      });
+    },
+  };
+  // The stable viewer + the panels, under named layouts with the activity-bar
+  // sidebar. All panels are built-ins that self-wire from top-app's contexts.
+  app.elements = {
+    viewer: () => BUI.html`${viewerEl}`,
+    tree: () => BUI.html`<top-model-tree></top-model-tree>`,
+    properties: () => BUI.html`<top-properties-panel></top-properties-panel>`,
+    files: () =>
+      BUI.html`<top-models-list .loaders=${modelLoaders}></top-models-list>`,
+    dataTable: () => BUI.html`<top-data-table-panel></top-data-table-panel>`,
+    objects: () => BUI.html`<top-objects-panel></top-objects-panel>`,
+    settings: () => BUI.html`<top-settings-panel></top-settings-panel>`,
+    history: () => BUI.html`<top-git-history></top-git-history>`,
+  };
+  app.layouts = {
+    Explorer: {
+      icon: "mdi:file-tree",
+      template: `"tree viewer" 1fr "properties viewer" 1fr / 22rem 1fr`,
+    },
+    Assets: {
+      icon: "mdi:folder-multiple-outline",
+      template: `"files viewer" 1fr "objects viewer" 1fr / 22rem 1fr`,
+    },
+    Data: {
+      icon: "mdi:table",
+      template: `"dataTable viewer" 1fr / 22rem 1fr`,
+    },
+    Settings: {
+      icon: "mdi:cog",
+      template: `"settings viewer" 1fr / 22rem 1fr`,
+    },
+    // Same side, same width and same shape as the others: this only swaps the panel.
+    History: {
+      icon: "at-icons:git-branch",
+      template: `"history viewer" 1fr / 22rem 1fr`,
+    },
+  };
+  // Opens on History, because that is what this app was scaffolded for.
+  app.layout = "History";
+  app.sidebar = true;
+  viewerEl.appendChild(document.createElement("top-viewer-toolbar"));
+  // The history panel lights up once a revit-flow model is loaded. Load it from the
+  // Assets panel, or auto-load it here if this app only ever shows one model.
+}
+/** Resolves with the first world once it exists (top-viewer creates it async). */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function firstWorld(worlds: any): Promise<any> {
+  const existing = [...worlds.list.values()][0];
+  if (existing) return Promise.resolve(existing);
+  return new Promise((resolve) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const handler = ({ value }: any) => {
+      worlds.list.onItemSet.remove(handler);
+      resolve(value);
+    };
+    worlds.list.onItemSet.add(handler);
+  });
+}
+main().catch(console.error);

package/src/cli/templates/app/src/ui-components/app-info-section/index.ts CHANGED Viewed

@@ -1,26 +1,26 @@
-import * as BUI from "@thatopen/ui";
-import { AppInfoSectionComponent } from "./src";
-import { getAppManager } from "../../app";
-export const appInfoSectionTemplate: AppInfoSectionComponent = ({
-  components,
-}) => {
-  const app = getAppManager(components);
-  const fileItems =
-    app.projectData?.files.map(
-      (f: { name: string }) => BUI.html`<bim-label>${f.name}</bim-label>`,
-    ) ?? [];
-  return BUI.html`
-    <bim-panel-section label="App Info" icon="solar:info-circle-bold">
-      <bim-label>App ID: ${app.client?.context.appId}</bim-label>
-      <bim-label>Project ID: ${app.client?.context.projectId}</bim-label>
-      <bim-label>API URL: ${app.client?.context.apiUrl}</bim-label>
-      <bim-label>Files: ${fileItems.length}</bim-label>
-      ${fileItems}
-    </bim-panel-section>
-  `;
-};
-export * from "./src";
+import * as BUI from "@thatopen/ui";
+import { AppInfoSectionComponent } from "./src";
+import { getAppManager } from "../../app";
+export const appInfoSectionTemplate: AppInfoSectionComponent = ({
+  components,
+}) => {
+  const app = getAppManager(components);
+  const fileItems =
+    app.projectData?.files.map(
+      (f: { name: string }) => BUI.html`<bim-label>${f.name}</bim-label>`,
+    ) ?? [];
+  return BUI.html`
+    <bim-panel-section label="App Info" icon="solar:info-circle-bold">
+      <bim-label>App ID: ${app.client?.context.appId}</bim-label>
+      <bim-label>Project ID: ${app.client?.context.projectId}</bim-label>
+      <bim-label>API URL: ${app.client?.context.apiUrl}</bim-label>
+      <bim-label>Files: ${fileItems.length}</bim-label>
+      ${fileItems}
+    </bim-panel-section>
+  `;
+};
+export * from "./src";

package/src/cli/templates/app/src/ui-components/app-info-section/src/index.ts CHANGED Viewed

	@@ -1 +1 @@
1	- export * from "./types";
1	+ export * from "./types";

package/src/cli/templates/app/src/ui-components/app-info-section/src/types.ts CHANGED Viewed

@@ -1,15 +1,15 @@
-import * as BUI from "@thatopen/ui";
-import * as OBC from "@thatopen/components";
-export interface AppInfoSectionState {
-  components: OBC.Components;
-}
-export type AppInfoSectionComponent =
-  BUI.StatefullComponent<AppInfoSectionState>;
-// Used in App type (app.ts) to type this element slot in the grid.
-export type AppInfoSectionGridElement = {
-  name: "appInfoSection";
-  state: AppInfoSectionState;
-};
+import * as BUI from "@thatopen/ui";
+import * as OBC from "@thatopen/components";
+export interface AppInfoSectionState {
+  components: OBC.Components;
+}
+export type AppInfoSectionComponent =
+  BUI.StatefullComponent<AppInfoSectionState>;
+// Used in App type (app.ts) to type this element slot in the grid.
+export type AppInfoSectionGridElement = {
+  name: "appInfoSection";
+  state: AppInfoSectionState;
+};