@foxglove/extension 2.44.0 → 2.46.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxglove/extension",
-  "version": "2.44.0",
+  "version": "2.46.0",
   "license": "MIT",
   "author": {
     "name": "Foxglove Technologies",
@@ -15,7 +15,7 @@
     "prepack": "tsc -b tsconfig.json"
   },
   "devDependencies": {
-    "@foxglove/tsconfig": "3.1.0",
-    "typescript": "5.9.2"
+    "@foxglove/tsconfig": "3.2.0",
+    "typescript": "5.9.3"
   }
-}
+}

package/src/experimental.ts

@@ -1,5 +1,5 @@
 /* eslint-disable @typescript-eslint/no-namespace */
-import type { Immutable } from "./immutable";
+import type { Immutable } from "./immutable.ts";
 import type {
   ExtensionContext as BaseExtensionContext,
   MessageEvent,
@@ -8,7 +8,7 @@ import type {
   SettingsTreeFields,
   SettingsTreeNode,
   Topic,
-} from "./stable";
+} from "./stable.ts";
 
 /**
  * The experimental namespace contains experimental APIs that are not yet stable and WILL change or
@@ -210,11 +210,15 @@ export namespace Experimental {
     /**
      * This function will be called when your extension is loaded. In this function, you can register
      * your custom panels or other types of extension features.
+     *
+     * The function may return a Promise if async initialization is needed before registering
+     * extension features. The extension will not be considered fully activated until the Promise
+     * resolves.
      */
     activate: ExtensionActivate;
   }
 
-  export type ExtensionActivate = (extensionContext: ExtensionContext) => void;
+  export type ExtensionActivate = (extensionContext: ExtensionContext) => void | Promise<void>;
 
   /**
    * A button in the panel toolbar.
@@ -291,7 +295,7 @@ export namespace Experimental {
     /** Queue of messages to be handled since last frame. Will be reassigned to new empty array each frame. */
     queue?: MessageEvent<T>[] | undefined;
     /** Optional callback to be called on `queue` to filter. Returns new queue. */
-    filterQueue?: (queue: MessageEvent<T>[]) => MessageEvent<T>[];
+    filterQueue?: (queue: ReadonlyArray<MessageEvent<T>>) => ReadonlyArray<MessageEvent<T>>;
   };
 
   export type AnyPanelOverlaySubscription = Immutable<

package/src/index.ts

@@ -1,3 +1,3 @@
 export * from "./stable";
-export type { Immutable } from "./immutable";
-export type { Experimental } from "./experimental";
+export type { Immutable } from "./immutable.ts";
+export type { Experimental } from "./experimental.ts";

package/src/stable.ts

@@ -1,4 +1,4 @@
-import type { Immutable } from "./immutable";
+import type { Immutable } from "./immutable.ts";
 
 /** Valid types for parameter data (such as rosparams) */
 export type ParameterValue =
@@ -1214,7 +1214,7 @@ export interface ExtensionContext {
  * @inline
  * @hidden
  */
-export type ExtensionActivate = (extensionContext: ExtensionContext) => void;
+export type ExtensionActivate = (extensionContext: ExtensionContext) => void | Promise<void>;
 
 /**
  * ExtensionModule describes the interface your extension module must export. This typically corresponds to your `index.ts` file.
@@ -1234,12 +1234,29 @@ export type ExtensionActivate = (extensionContext: ExtensionContext) => void;
  * export default { activate };
  * ```
  *
+ * The `activate` function can also return a Promise to perform async initialization before
+ * registering panels or converters:
+ *
+ * ```typescript
+ * export async function activate(context: ExtensionContext) {
+ *   // Initialize WASM or other async resources
+ *   await initializeWasm();
+ *
+ *   // Now register panels/converters that depend on the initialized resources
+ *   context.registerPanel({ ... });
+ * }
+ * ```
+ *
  * @category Entry point
  */
 export interface ExtensionModule {
   /**
    * This function will be called when your extension is loaded. In this function, you can register
    * your custom panels or other types of extension features.
+   *
+   * The function may return a Promise if async initialization is needed before registering
+   * extension features. The extension will not be considered fully activated until the Promise
+   * resolves.
    */
   activate: ExtensionActivate;
 }
@@ -1578,6 +1595,13 @@ export type SettingsTreeNode = {
    */
   icon?: SettingsIcon;
 
+  /**
+   * Optional color for this node. When an icon is specified, the icon will be
+   * rendered in this color. Otherwise, a small color swatch is displayed before
+   * the label. Expects a valid CSS color string (e.g., "#ff0000", "rgb(255, 0, 0)", "red").
+   */
+  color?: string;
+
   /**
    * An optional label shown at the top of this node.
    */