@foxglove/extension 2.58.0 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxglove/extension",
-  "version": "2.58.0",
+  "version": "3.0.0",
   "homepage": "https://foxglove.dev/",
   "license": "MIT",
   "author": {

package/src/experimental.ts

@@ -340,6 +340,12 @@ export namespace Experimental {
 
     /**
      * Map of compare data sources. Only present when multiple data sources are loaded in compare mode.
+     *
+     * When set, player times on this render state (`currentTime`, `startTime`, `endTime`) and
+     * remapped message `receiveTime` / `publishTime` values live on the shared compare clock
+     * (origin t=0), not wall-clock epoch. Prefer elapsed / seconds formatting for those values.
+     * Recover a source-local absolute time with `sourceTime = currentTime - timeOffset` using the
+     * matching entry's `timeOffset`.
      */
     comparisonSources?: ComparisonSources;
 

package/src/stable.ts

@@ -974,7 +974,7 @@ export type RegisterMessageConverterArgsTopic = {
    * Describes the structure of the output messages produced by this converter.
    *
    * This optional field allows Foxglove to understand the structure of your messages, enabling
-   * features like autocompletion for message path selection.
+   * features like autocompletion for expression selection.
    *
    * The schema can include:
    * - Primitive types: "string", "number", "bool", "byte"
@@ -1221,7 +1221,7 @@ export interface ExtensionContext {
    *
    * Your alias function runs whenever there are changes to the data source topics or variables. Any
    * aliases it returns are added to the data source topics (replacing any previously returned
-   * aliases) and available for subscribing or use within message paths as if they were real topics.
+   * aliases) and available for subscribing or use within expressions as if they were real topics.
    */
   registerTopicAliases(aliasFunction: TopicAliasFunction): void;
 }
@@ -1380,13 +1380,13 @@ export type SettingsTreeFieldValue =
       validTypes?: string[];
       /** Only include paths from these topics in autocomplete suggestions */
       validTopics?: string[];
-      /** True if the input should allow message path functions like "@abs" */
+      /** True if the input should allow functions like "@abs" */
       supportsMessagePathFunctions?: boolean;
       /** Whether the input should allow Plot-only time-series functions like "@delta". Defaults to true. */
       supportsTimeSeriesMessagePathFunctions?: boolean;
       /**
        * @deprecated Use `supportsMessagePathFunctions` instead.
-       * True if the input should allow message path functions like "@abs".
+       * True if the input should allow functions like "@abs".
        */
       supportsMathModifiers?: boolean;
     }
@@ -1571,7 +1571,7 @@ export type SettingsTreeNodeAction = SettingsTreeNodeActionItem | SettingsTreeNo
 
 /**
  * Drag-and-drop metadata for a settings tree node. Allows the node to be
- * dragged onto panels that accept topics or message paths.
+ * dragged onto panels that accept topics or expressions.
  *
  * @category Custom panels
  */
@@ -1583,7 +1583,7 @@ export type SettingsTreeNodeDrag =
     }
   | {
       type: "message-path";
-      /** Full message path, e.g. `/my_topic.field` or `"/topic with spaces".field`. */
+      /** Full expression, e.g. `/my_topic.field` or `"/topic with spaces".field`. */
       value: string;
       /** True if the path points to a primitive value. Required by panels like Plot. */
       isLeaf?: boolean;