@openfin/core 45.100.59 → 45.100.60

package/out/mock-alpha.d.ts

@@ -16446,6 +16446,13 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
 declare class SystemContentTracing extends Base {
     /**
      * Gets the currently known tracing category groups.
+     *
+     * @example
+     * ```ts
+     * const categories = await fin.System.ContentTracing.getCategories();
+     * const sorted = [...new Set(categories)].sort((a, b) => a.localeCompare(b));
+     * console.log(`Loaded ${sorted.length} tracing categories`);
+     * ```
      */
     getCategories(): Promise<string[]>;
     /**
@@ -16453,6 +16460,29 @@ declare class SystemContentTracing extends Base {
      *
      * Only one content tracing session may be active across the runtime at a time.
      * This method rejects if another identity already owns the active session.
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     recording_mode: 'record-as-much-as-possible',
+     *     included_categories: [
+     *         '*',
+     *         'disabled-by-default-blink.invalidation',
+     *         'disabled-by-default-cc.debug',
+     *         'disabled-by-default-viz.surface_id_flow'
+     *     ]
+     * });
+     *
+     * console.log('Content tracing started. Call stopRecording() when ready to collect the trace.');
+     * ```
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     categoryFilter: 'electron,blink,cc',
+     *     traceOptions: 'record-until-full,enable-sampling'
+     * });
+     * ```
      */
     startRecording(options: OpenFin_2.TraceConfig | OpenFin_2.TraceCategoriesAndOptions): Promise<void>;
     /**
@@ -16460,12 +16490,29 @@ declare class SystemContentTracing extends Base {
      *
      * The calling identity must match the identity that started the active tracing session.
      * This method rejects if tracing is not active or is owned by another identity.
+     *
+     * @example
+     * ```ts
+     * const tracePath = await fin.System.ContentTracing.stopRecording();
+     * console.log('Trace written to:', tracePath);
+     * // Load the file in chrome://tracing or https://ui.perfetto.dev/
+     * ```
      */
     stopRecording(): Promise<string>;
     /**
      * Returns the current maximum trace buffer usage across processes.
      *
      * This method is not supported on macOS and rejects on that platform.
+     *
+     * @example
+     * ```ts
+     * try {
+     *     const usage = await fin.System.ContentTracing.getTraceBufferUsage();
+     *     console.log(`Buffer usage: ${usage.percentage}% (${usage.value})`);
+     * } catch (error) {
+     *     console.warn('Trace buffer usage is not available on this platform.', error);
+     * }
+     * ```
      */
     getTraceBufferUsage(): Promise<OpenFin_2.TraceBufferUsage>;
 }

package/out/mock-beta.d.ts

@@ -16446,6 +16446,13 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
 declare class SystemContentTracing extends Base {
     /**
      * Gets the currently known tracing category groups.
+     *
+     * @example
+     * ```ts
+     * const categories = await fin.System.ContentTracing.getCategories();
+     * const sorted = [...new Set(categories)].sort((a, b) => a.localeCompare(b));
+     * console.log(`Loaded ${sorted.length} tracing categories`);
+     * ```
      */
     getCategories(): Promise<string[]>;
     /**
@@ -16453,6 +16460,29 @@ declare class SystemContentTracing extends Base {
      *
      * Only one content tracing session may be active across the runtime at a time.
      * This method rejects if another identity already owns the active session.
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     recording_mode: 'record-as-much-as-possible',
+     *     included_categories: [
+     *         '*',
+     *         'disabled-by-default-blink.invalidation',
+     *         'disabled-by-default-cc.debug',
+     *         'disabled-by-default-viz.surface_id_flow'
+     *     ]
+     * });
+     *
+     * console.log('Content tracing started. Call stopRecording() when ready to collect the trace.');
+     * ```
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     categoryFilter: 'electron,blink,cc',
+     *     traceOptions: 'record-until-full,enable-sampling'
+     * });
+     * ```
      */
     startRecording(options: OpenFin_2.TraceConfig | OpenFin_2.TraceCategoriesAndOptions): Promise<void>;
     /**
@@ -16460,12 +16490,29 @@ declare class SystemContentTracing extends Base {
      *
      * The calling identity must match the identity that started the active tracing session.
      * This method rejects if tracing is not active or is owned by another identity.
+     *
+     * @example
+     * ```ts
+     * const tracePath = await fin.System.ContentTracing.stopRecording();
+     * console.log('Trace written to:', tracePath);
+     * // Load the file in chrome://tracing or https://ui.perfetto.dev/
+     * ```
      */
     stopRecording(): Promise<string>;
     /**
      * Returns the current maximum trace buffer usage across processes.
      *
      * This method is not supported on macOS and rejects on that platform.
+     *
+     * @example
+     * ```ts
+     * try {
+     *     const usage = await fin.System.ContentTracing.getTraceBufferUsage();
+     *     console.log(`Buffer usage: ${usage.percentage}% (${usage.value})`);
+     * } catch (error) {
+     *     console.warn('Trace buffer usage is not available on this platform.', error);
+     * }
+     * ```
      */
     getTraceBufferUsage(): Promise<OpenFin_2.TraceBufferUsage>;
 }

package/out/mock-public.d.ts

@@ -16446,6 +16446,13 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
 declare class SystemContentTracing extends Base {
     /**
      * Gets the currently known tracing category groups.
+     *
+     * @example
+     * ```ts
+     * const categories = await fin.System.ContentTracing.getCategories();
+     * const sorted = [...new Set(categories)].sort((a, b) => a.localeCompare(b));
+     * console.log(`Loaded ${sorted.length} tracing categories`);
+     * ```
      */
     getCategories(): Promise<string[]>;
     /**
@@ -16453,6 +16460,29 @@ declare class SystemContentTracing extends Base {
      *
      * Only one content tracing session may be active across the runtime at a time.
      * This method rejects if another identity already owns the active session.
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     recording_mode: 'record-as-much-as-possible',
+     *     included_categories: [
+     *         '*',
+     *         'disabled-by-default-blink.invalidation',
+     *         'disabled-by-default-cc.debug',
+     *         'disabled-by-default-viz.surface_id_flow'
+     *     ]
+     * });
+     *
+     * console.log('Content tracing started. Call stopRecording() when ready to collect the trace.');
+     * ```
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     categoryFilter: 'electron,blink,cc',
+     *     traceOptions: 'record-until-full,enable-sampling'
+     * });
+     * ```
      */
     startRecording(options: OpenFin_2.TraceConfig | OpenFin_2.TraceCategoriesAndOptions): Promise<void>;
     /**
@@ -16460,12 +16490,29 @@ declare class SystemContentTracing extends Base {
      *
      * The calling identity must match the identity that started the active tracing session.
      * This method rejects if tracing is not active or is owned by another identity.
+     *
+     * @example
+     * ```ts
+     * const tracePath = await fin.System.ContentTracing.stopRecording();
+     * console.log('Trace written to:', tracePath);
+     * // Load the file in chrome://tracing or https://ui.perfetto.dev/
+     * ```
      */
     stopRecording(): Promise<string>;
     /**
      * Returns the current maximum trace buffer usage across processes.
      *
      * This method is not supported on macOS and rejects on that platform.
+     *
+     * @example
+     * ```ts
+     * try {
+     *     const usage = await fin.System.ContentTracing.getTraceBufferUsage();
+     *     console.log(`Buffer usage: ${usage.percentage}% (${usage.value})`);
+     * } catch (error) {
+     *     console.warn('Trace buffer usage is not available on this platform.', error);
+     * }
+     * ```
      */
     getTraceBufferUsage(): Promise<OpenFin_2.TraceBufferUsage>;
 }

package/out/stub.d.ts

@@ -16869,6 +16869,13 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
 declare class SystemContentTracing extends Base {
     /**
      * Gets the currently known tracing category groups.
+     *
+     * @example
+     * ```ts
+     * const categories = await fin.System.ContentTracing.getCategories();
+     * const sorted = [...new Set(categories)].sort((a, b) => a.localeCompare(b));
+     * console.log(`Loaded ${sorted.length} tracing categories`);
+     * ```
      */
     getCategories(): Promise<string[]>;
     /**
@@ -16876,6 +16883,29 @@ declare class SystemContentTracing extends Base {
      *
      * Only one content tracing session may be active across the runtime at a time.
      * This method rejects if another identity already owns the active session.
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     recording_mode: 'record-as-much-as-possible',
+     *     included_categories: [
+     *         '*',
+     *         'disabled-by-default-blink.invalidation',
+     *         'disabled-by-default-cc.debug',
+     *         'disabled-by-default-viz.surface_id_flow'
+     *     ]
+     * });
+     *
+     * console.log('Content tracing started. Call stopRecording() when ready to collect the trace.');
+     * ```
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     categoryFilter: 'electron,blink,cc',
+     *     traceOptions: 'record-until-full,enable-sampling'
+     * });
+     * ```
      */
     startRecording(options: OpenFin_2.TraceConfig | OpenFin_2.TraceCategoriesAndOptions): Promise<void>;
     /**
@@ -16883,12 +16913,29 @@ declare class SystemContentTracing extends Base {
      *
      * The calling identity must match the identity that started the active tracing session.
      * This method rejects if tracing is not active or is owned by another identity.
+     *
+     * @example
+     * ```ts
+     * const tracePath = await fin.System.ContentTracing.stopRecording();
+     * console.log('Trace written to:', tracePath);
+     * // Load the file in chrome://tracing or https://ui.perfetto.dev/
+     * ```
      */
     stopRecording(): Promise<string>;
     /**
      * Returns the current maximum trace buffer usage across processes.
      *
      * This method is not supported on macOS and rejects on that platform.
+     *
+     * @example
+     * ```ts
+     * try {
+     *     const usage = await fin.System.ContentTracing.getTraceBufferUsage();
+     *     console.log(`Buffer usage: ${usage.percentage}% (${usage.value})`);
+     * } catch (error) {
+     *     console.warn('Trace buffer usage is not available on this platform.', error);
+     * }
+     * ```
      */
     getTraceBufferUsage(): Promise<OpenFin_2.TraceBufferUsage>;
 }

package/out/stub.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var events = require('events');
-var isEqual = require('lodash/isEqual');
+var esToolkit = require('es-toolkit');
 
 /**
  * Namespace for events that can be emitted by an {@link OpenFin.Application}.  Includes events
@@ -4999,6 +4999,13 @@ class _WindowModule extends Base {
 class SystemContentTracing extends Base {
     /**
      * Gets the currently known tracing category groups.
+     *
+     * @example
+     * ```ts
+     * const categories = await fin.System.ContentTracing.getCategories();
+     * const sorted = [...new Set(categories)].sort((a, b) => a.localeCompare(b));
+     * console.log(`Loaded ${sorted.length} tracing categories`);
+     * ```
      */
     async getCategories() {
         const { payload } = await this.wire.sendAction('content-tracing-get-categories');
@@ -5009,6 +5016,29 @@ class SystemContentTracing extends Base {
      *
      * Only one content tracing session may be active across the runtime at a time.
      * This method rejects if another identity already owns the active session.
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     recording_mode: 'record-as-much-as-possible',
+     *     included_categories: [
+     *         '*',
+     *         'disabled-by-default-blink.invalidation',
+     *         'disabled-by-default-cc.debug',
+     *         'disabled-by-default-viz.surface_id_flow'
+     *     ]
+     * });
+     *
+     * console.log('Content tracing started. Call stopRecording() when ready to collect the trace.');
+     * ```
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     categoryFilter: 'electron,blink,cc',
+     *     traceOptions: 'record-until-full,enable-sampling'
+     * });
+     * ```
      */
     async startRecording(options) {
         await this.wire.sendAction('content-tracing-start-recording', { options });
@@ -5018,6 +5048,13 @@ class SystemContentTracing extends Base {
      *
      * The calling identity must match the identity that started the active tracing session.
      * This method rejects if tracing is not active or is owned by another identity.
+     *
+     * @example
+     * ```ts
+     * const tracePath = await fin.System.ContentTracing.stopRecording();
+     * console.log('Trace written to:', tracePath);
+     * // Load the file in chrome://tracing or https://ui.perfetto.dev/
+     * ```
      */
     async stopRecording() {
         const { payload } = await this.wire.sendAction('content-tracing-stop-recording');
@@ -5027,6 +5064,16 @@ class SystemContentTracing extends Base {
      * Returns the current maximum trace buffer usage across processes.
      *
      * This method is not supported on macOS and rejects on that platform.
+     *
+     * @example
+     * ```ts
+     * try {
+     *     const usage = await fin.System.ContentTracing.getTraceBufferUsage();
+     *     console.log(`Buffer usage: ${usage.percentage}% (${usage.value})`);
+     * } catch (error) {
+     *     console.warn('Trace buffer usage is not available on this platform.', error);
+     * }
+     * ```
      */
     async getTraceBufferUsage() {
         const { payload } = await this.wire.sendAction('content-tracing-get-trace-buffer-usage');
@@ -13052,7 +13099,7 @@ class InteropBroker extends Base {
             constructor(...unused) {
                 if (unused.length) {
                     const [_ignore1, ignore2, opts] = unused;
-                    if (opts && typeof opts === 'object' && !isEqual(opts, args[2])) {
+                    if (opts && typeof opts === 'object' && !esToolkit.isEqual(opts, args[2])) {
                         // eslint-disable-next-line no-console
                         console.warn('You have modified the parameters of the InteropOverride constructor. This behavior is deprecated and will be removed in a future version. You can modify these options in your manifest. Please consult our Interop docs for guidance on migrating to the new override scheme.');
                         super(args[0], args[1], opts);
@@ -15088,7 +15135,7 @@ const createV1Channel = (sessionContextGroup) => {
                 const wrappedHandler = (context, contextMetadata) => {
                     if (first) {
                         first = false;
-                        if (isEqual(currentContext, context)) {
+                        if (esToolkit.isEqual(currentContext, context)) {
                             return;
                         }
                     }
@@ -15496,7 +15543,7 @@ class FDC3ModuleBase {
                     const wrappedHandler = (context, contextMetadata) => {
                         if (first) {
                             first = false;
-                            if (isEqual(currentContext, context)) {
+                            if (esToolkit.isEqual(currentContext, context)) {
                                 return;
                             }
                         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfin/core",
-  "version": "45.100.59",
+  "version": "45.100.60",
   "description": "The core renderer entry point of OpenFin",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "out/stub.js",
@@ -18,7 +18,7 @@
   "dependencies": {
     "@types/node": "^20.14.2",
     "events": "^3.0.0",
-    "lodash": "^4.17.21",
+    "es-toolkit": "^1.39.3",
     "ws": "^7.5.10",
     "tslib": "2.8.1"
   },