Add private Style.getBOMObject method for tests

GitOrigin-RevId: 1a57b2e805cbd17868975c917e4b9dc983e96eb4

Author: underoot

build/rollup_plugins.js

@@ -39,7 +39,7 @@ export const plugins = ({mode, format, minified, production, test, bench, keepCl
     }),
     (production && !bench) ? strip({
         sourceMap: true,
-        functions: ['PerformanceUtils.*', 'WorkerPerformanceUtils.*', 'Debug.*', 'DevTools.*'],
+        functions: ['PerformanceUtils.*', 'WorkerPerformanceUtils.*', 'Debug.*', 'DevTools.*', 'StyleBOMUtils.*'],
         include: ['**/*.ts']
     }) : false,
     // eslint-disable-next-line @typescript-eslint/no-unsafe-call

src/style/style.ts

@@ -68,6 +68,7 @@ import {loadIconset} from './load_iconset';
 import {ImageId} from '../style-spec/expression/types/image_id';
 import {ImageProvider} from '../render/image_provider';
 import IndoorManager from './indoor_manager';
+import {StyleBOMUtils} from './style_bom_utils';
 
 import type {PropertyValidatorOptions} from '../style-spec/validate/validate_property';
 import type Tile from '../source/tile';
@@ -128,6 +129,9 @@ import type {StyleModelMap} from './style_mode';
 import type {TypedStyleLayer} from './style_layer/typed_style_layer';
 import type {LngLatLike} from '../geo/lng_lat';
 import type {RasterQueryParameters, RasterQueryResult} from '../source/raster_array_tile_source';
+import type {StyleBOM} from './style_bom_utils';
+
+export type {StyleBOMEntry, StyleBOM} from './style_bom_utils';
 
 export type QueryRenderedFeaturesParams = {
     layers?: string[];
@@ -4630,6 +4634,17 @@ class Style extends Evented<MapEvents> {
         this.dispatcher.broadcast('clearCaches');
     }
 
+    /**
+     * Returns the Bill of Materials (BOM) for this style, containing information
+     * about all styles and tilesets used by this style and its imports.
+     *
+     * @private
+     * @returns {StyleBOM} Array of BOM entries with style URLs, tileset URLs, and modified dates.
+     */
+    getBOMObject(): StyleBOM {
+        return StyleBOMUtils.getBOMObject(this);
+    }
+
     destroy() {
         this._clearWorkerCaches();
         this.fragments.forEach(fragment => {

src/style/style_bom_utils.ts

@@ -0,0 +1,67 @@
+import type Style from './style';
+
+/**
+ * A single entry in the Style BOM (Bill of Materials).
+ * Either contains a style URL or a tileset URL, along with an optional modified timestamp.
+ * @private
+ */
+export type StyleBOMEntry = {
+    style?: string;
+    modified?: string | number;
+    tileset?: string;
+};
+
+/**
+ * The Bill of Materials for a style, containing all styles and tilesets used.
+ * @private
+ */
+export type StyleBOM = Array<StyleBOMEntry>;
+
+/**
+ * Utility namespace for Style BOM operations.
+ * Calls to StyleBOMUtils.* are stripped from production builds.
+ * @private
+ */
+export const StyleBOMUtils = {
+    /**
+     * Returns the Bill of Materials (BOM) for a style.
+     * @private
+     */
+    getBOMObject(style: Style): StyleBOM {
+        const bom: StyleBOM = [];
+        const visited = new Set<string>();
+        const rootStyleGlobalId = style.globalId;
+
+        const processStyle = (s: Style) => {
+            const globalId = s.globalId ? s.globalId : rootStyleGlobalId;
+            const modified = s.stylesheet ? (s.stylesheet as {modified?: string}).modified : undefined;
+            if (globalId && modified && !visited.has(globalId)) {
+                visited.add(globalId);
+                bom.push({
+                    style: globalId,
+                    modified: modified ? modified : null
+                });
+            }
+
+            for (const fragment of s.fragments) {
+                processStyle(fragment.style);
+            }
+
+            if (s.stylesheet && s.stylesheet.sources) {
+                for (const sourceId in s.stylesheet.sources) {
+                    const source = s.stylesheet.sources[sourceId];
+                    if (source && 'url' in source && source.url) {
+                        const data = (source as unknown as {data?: {modified?: number, created: number}}).data;
+                        bom.push({
+                            tileset: source.url,
+                            modified: data ? data.modified || data.created : null
+                        });
+                    }
+                }
+            }
+        };
+
+        processStyle(style);
+        return bom;
+    }
+};