@genome-spy/core 0.77.0 → 0.79.0

package/dist/src/debug/viewDebugSnapshot.js

@@ -0,0 +1,390 @@
+import ContainerView from "../view/containerView.js";
+import { getViewSelector, isChromeView } from "../view/viewSelectors.js";
+
+/**
+ * @typedef {object} ViewDebugSnapshotOptions
+ * @prop {boolean} [includeChrome=false]
+ * @prop {(object: object) => string} getDebugId
+ */
+
+/**
+ * @typedef {object} ViewDebugNode
+ * @prop {string} id
+ * @prop {string | undefined} parentId
+ * @prop {string[]} childIds
+ * @prop {string} name
+ * @prop {string | undefined} explicitName
+ * @prop {string | undefined} defaultName
+ * @prop {string} path
+ * @prop {string} className
+ * @prop {string} type
+ * @prop {string | undefined} markType
+ * @prop {boolean} chrome
+ * @prop {boolean} visible
+ * @prop {boolean} configuredVisible
+ * @prop {boolean} visibleInSpec
+ * @prop {"none" | "pending" | "ready"} dataInitializationState
+ * @prop {import("../view/viewUtilTypes.d.ts").ViewSelector | undefined} selector
+ * @prop {{ x: number, y: number, width: number, height: number } | undefined} bounds
+ * @prop {{ width: any, height: any } | undefined} size
+ * @prop {{ width: any, height: any } | undefined} viewportSize
+ * @prop {Record<string, string>} scaleResolutionIds
+ * @prop {Record<string, string>} axisResolutionIds
+ * @prop {Record<string, string>} legendResolutionIds
+ * @prop {Record<string, EncodingDebugNode>} encodings
+ * @prop {string[]} paramNames
+ * @prop {Record<string, any>} spec
+ * @prop {DebugSnapshotError[]} debugErrors
+ */
+
+/**
+ * @typedef {object} DebugSnapshotError
+ * @prop {string} field
+ * @prop {string} message
+ */
+
+/**
+ * @typedef {object} EncodingDebugNode
+ * @prop {string} channel
+ * @prop {string | undefined} field
+ * @prop {string | undefined} expr
+ * @prop {any} value
+ * @prop {string | undefined} type
+ * @prop {string | undefined} scaleResolutionId
+ * @prop {string | undefined} axisResolutionId
+ * @prop {string | undefined} legendResolutionId
+ * @prop {Record<string, any>} channelDef
+ */
+
+/**
+ * @typedef {object} ViewDebugSnapshot
+ * @prop {string | undefined} rootId
+ * @prop {ViewDebugNode[]} nodes
+ */
+
+/**
+ * Creates a plain, read-only debug snapshot of the live view hierarchy.
+ *
+ * This module is intended for dynamic import by optional development tools.
+ * Keep the returned shape serializable and avoid exposing mutable runtime
+ * collections directly.
+ *
+ * @param {import("../view/view.js").default | undefined} root
+ * @param {ViewDebugSnapshotOptions} options
+ * @returns {ViewDebugSnapshot}
+ */
+export function createViewDebugSnapshot(root, options) {
+    if (!root) {
+        return {
+            rootId: undefined,
+            nodes: [],
+        };
+    }
+
+    const includeChrome = options.includeChrome ?? false;
+    /** @type {ViewDebugNode[]} */
+    const nodes = [];
+
+    /**
+     * @param {import("../view/view.js").default} view
+     * @param {string | undefined} parentId
+     * @returns {ViewDebugNode | undefined}
+     */
+    const visit = (view, parentId) => {
+        const chrome = isChromeView(view);
+        if (chrome && !includeChrome) {
+            return undefined;
+        }
+
+        const id = options.getDebugId(view);
+        const node = createViewDebugNode(view, id, parentId, chrome, options);
+        nodes.push(node);
+
+        if (view instanceof ContainerView) {
+            for (const child of view) {
+                const childNode = visit(child, id);
+                if (childNode) {
+                    node.childIds.push(childNode.id);
+                }
+            }
+        }
+
+        return node;
+    };
+
+    const rootNode = visit(root, undefined);
+
+    return {
+        rootId: rootNode?.id,
+        nodes,
+    };
+}
+
+/**
+ * @param {import("../view/view.js").default} view
+ * @param {string} id
+ * @param {string | undefined} parentId
+ * @param {boolean} chrome
+ * @param {ViewDebugSnapshotOptions} options
+ * @returns {ViewDebugNode}
+ */
+function createViewDebugNode(view, id, parentId, chrome, options) {
+    /** @type {DebugSnapshotError[]} */
+    const debugErrors = [];
+    return {
+        id,
+        parentId,
+        childIds: [],
+        name: view.name,
+        explicitName: view.explicitName,
+        defaultName: view.defaultName,
+        path: captureDebugValue(debugErrors, "path", view.name, () =>
+            view.getPathString()
+        ),
+        className: view.constructor.name,
+        type: captureDebugValue(debugErrors, "type", "unknown", () =>
+            getViewType(view)
+        ),
+        markType: captureDebugValue(debugErrors, "markType", undefined, () =>
+            getMarkType(view)
+        ),
+        chrome,
+        visible: captureDebugValue(debugErrors, "visible", false, () =>
+            view.isVisible()
+        ),
+        configuredVisible: captureDebugValue(
+            debugErrors,
+            "configuredVisible",
+            false,
+            () => view.isConfiguredVisible()
+        ),
+        visibleInSpec: captureDebugValue(
+            debugErrors,
+            "visibleInSpec",
+            false,
+            () => view.isVisibleInSpec()
+        ),
+        dataInitializationState: captureDebugValue(
+            debugErrors,
+            "dataInitializationState",
+            "none",
+            () => view.getDataInitializationState()
+        ),
+        selector: captureDebugValue(debugErrors, "selector", undefined, () =>
+            getSelector(view)
+        ),
+        bounds: captureDebugValue(debugErrors, "bounds", undefined, () =>
+            getBounds(view)
+        ),
+        size: captureDebugValue(debugErrors, "size", undefined, () =>
+            summarizeFlexDimensions(view.getSize())
+        ),
+        viewportSize: captureDebugValue(
+            debugErrors,
+            "viewportSize",
+            undefined,
+            () => summarizeFlexDimensions(view.getViewportSize())
+        ),
+        scaleResolutionIds: captureDebugValue(
+            debugErrors,
+            "scaleResolutionIds",
+            {},
+            () => getResolutionIds(view.resolutions.scale, options)
+        ),
+        axisResolutionIds: captureDebugValue(
+            debugErrors,
+            "axisResolutionIds",
+            {},
+            () => getResolutionIds(view.resolutions.axis, options)
+        ),
+        legendResolutionIds: captureDebugValue(
+            debugErrors,
+            "legendResolutionIds",
+            {},
+            () => getResolutionIds(view.resolutions.legend, options)
+        ),
+        encodings: captureDebugValue(debugErrors, "encodings", {}, () =>
+            getEncodings(view, options)
+        ),
+        paramNames: captureDebugValue(debugErrors, "paramNames", [], () =>
+            Array.from(view.paramRuntime.paramConfigs.keys())
+        ),
+        spec: captureDebugValue(
+            debugErrors,
+            "spec",
+            /** @type {import("../spec/view.js").ViewSpec} */ ({}),
+            () => structuredClone(view.spec)
+        ),
+        debugErrors,
+    };
+}
+
+/**
+ * @template T
+ * @param {DebugSnapshotError[]} debugErrors
+ * @param {string} field
+ * @param {T} fallback
+ * @param {() => T} getter
+ * @returns {T}
+ */
+function captureDebugValue(debugErrors, field, fallback, getter) {
+    try {
+        return getter();
+    } catch (error) {
+        console.warn(`Failed to collect view debug field "${field}".`, error);
+        debugErrors.push({
+            field,
+            message: error instanceof Error ? error.message : String(error),
+        });
+        return fallback;
+    }
+}
+
+/**
+ * @param {import("../view/view.js").default} view
+ * @returns {string}
+ */
+function getViewType(view) {
+    if (typeof (/** @type {any} */ (view).getMarkType) === "function") {
+        return "unit";
+    }
+
+    const className = view.constructor.name;
+    return className.endsWith("View")
+        ? className.slice(0, -4).toLowerCase()
+        : className.toLowerCase();
+}
+
+/**
+ * @param {import("../view/view.js").default} view
+ * @returns {string | undefined}
+ */
+function getMarkType(view) {
+    const unitView = /** @type {{ getMarkType?: () => string }} */ (
+        /** @type {unknown} */ (view)
+    );
+    if (typeof unitView.getMarkType === "function") {
+        return unitView.getMarkType();
+    }
+}
+
+/**
+ * @param {import("../view/view.js").default} view
+ * @returns {import("../view/viewUtilTypes.d.ts").ViewSelector | undefined}
+ */
+function getSelector(view) {
+    if (!view.explicitName) {
+        return undefined;
+    }
+
+    return getViewSelector(view);
+}
+
+/**
+ * @param {import("../view/view.js").default} view
+ * @returns {{ x: number, y: number, width: number, height: number } | undefined}
+ */
+function getBounds(view) {
+    const coords = view.coords;
+    if (!coords) {
+        return undefined;
+    }
+
+    return {
+        x: coords.x,
+        y: coords.y,
+        width: coords.width,
+        height: coords.height,
+    };
+}
+
+/**
+ * @param {import("../view/layout/flexLayout.js").FlexDimensions} dimensions
+ * @returns {{ width: any, height: any }}
+ */
+function summarizeFlexDimensions(dimensions) {
+    return {
+        width: dimensions.width,
+        height: dimensions.height,
+    };
+}
+
+/**
+ * @param {Record<string, any>} resolutions
+ * @param {ViewDebugSnapshotOptions} options
+ * @returns {Record<string, string>}
+ */
+function getResolutionIds(resolutions, options) {
+    /** @type {Record<string, string>} */
+    const ids = {};
+
+    for (const [channel, resolution] of Object.entries(resolutions)) {
+        if (resolution) {
+            ids[channel] = options.getDebugId(
+                /** @type {object} */ (resolution)
+            );
+        }
+    }
+
+    return ids;
+}
+
+/**
+ * @param {import("../view/view.js").default} view
+ * @param {ViewDebugSnapshotOptions} options
+ * @returns {Record<string, EncodingDebugNode>}
+ */
+function getEncodings(view, options) {
+    const encodingProvider =
+        /** @type {{ mark?: { encoding?: Record<string, any> } }} */ (
+            /** @type {unknown} */ (view)
+        );
+    const encoding = encodingProvider.mark?.encoding ?? view.getEncoding();
+    /** @type {Record<string, EncodingDebugNode>} */
+    const encodings = {};
+
+    for (const [channel, channelDef] of Object.entries(encoding)) {
+        if (!channelDef) {
+            continue;
+        }
+
+        encodings[channel] = {
+            channel,
+            field: "field" in channelDef ? channelDef.field : undefined,
+            expr: "expr" in channelDef ? channelDef.expr : undefined,
+            value: "value" in channelDef ? channelDef.value : undefined,
+            type: "type" in channelDef ? channelDef.type : undefined,
+            scaleResolutionId: getChannelResolutionId(
+                view.resolutions.scale,
+                channel,
+                options
+            ),
+            axisResolutionId: getChannelResolutionId(
+                view.resolutions.axis,
+                channel,
+                options
+            ),
+            legendResolutionId: getChannelResolutionId(
+                view.resolutions.legend,
+                channel,
+                options
+            ),
+            channelDef: structuredClone(channelDef),
+        };
+    }
+
+    return encodings;
+}
+
+/**
+ * @param {Record<string, any>} resolutions
+ * @param {string} channel
+ * @param {ViewDebugSnapshotOptions} options
+ * @returns {string | undefined}
+ */
+function getChannelResolutionId(resolutions, channel, options) {
+    const resolution = resolutions[channel];
+    return resolution
+        ? options.getDebugId(/** @type {object} */ (resolution))
+        : undefined;
+}

package/dist/src/embedFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedFactory.d.ts","sourceRoot":"","sources":["../../src/embedFactory.js"],"names":[],"mappings":"AAKA;;;GAGG;AACH,uCAHW,KAAK,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,gBAAgB,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,YAAY,KAAK,OAAO,gBAAgB,EAAE,OAAO,GAC7J,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,gBAAgB,EAAE,QAAQ,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,qBAAqB,EAAE,WAAW,CAAC,CAqFpM;AAaD;;;;;GAKG;AACH,8BAFW,MAAM,gBAmBhB"}
+{"version":3,"file":"embedFactory.d.ts","sourceRoot":"","sources":["../../src/embedFactory.js"],"names":[],"mappings":"AAMA;;;GAGG;AACH,uCAHW,KAAK,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,gBAAgB,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,YAAY,KAAK,OAAO,gBAAgB,EAAE,OAAO,GAC7J,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,gBAAgB,EAAE,QAAQ,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,qBAAqB,EAAE,WAAW,CAAC,CAyFpM;AAaD;;;;;GAKG;AACH,8BAFW,MAAM,gBAmBhB"}

package/dist/src/embedFactory.js

@@ -1,5 +1,6 @@
 import { isObject, isString } from "vega-util";
 
+import { createViewMutationApi } from "./view/viewMutationApi.js";
 import { fetchJson } from "./utils/fetchUtils.js";
 import inferSpecBaseUrl from "./utils/inferSpecBaseUrl.js";
 
@@ -38,7 +39,6 @@ export function createEmbed(GenomeSpy) {
             const specObject = isObject(spec) ? spec : await loadSpec(spec);
 
             specObject.baseUrl ??= "";
-            specObject.width ??= "container";
             specObject.padding ??= 10;
 
             if (element == document.body) {
@@ -60,6 +60,8 @@ export function createEmbed(GenomeSpy) {
         }
 
         return {
+            views: createViewMutationApi(genomeSpy),
+
             finalize() {
                 genomeSpy.destroy();
                 while (element.firstChild) {
@@ -88,6 +90,9 @@ export function createEmbed(GenomeSpy) {
             getLogicalCanvasSize:
                 genomeSpy.getLogicalCanvasSize.bind(genomeSpy),
             exportCanvas: genomeSpy.exportCanvas.bind(genomeSpy),
+            getDebugViewRoot() {
+                return genomeSpy ? genomeSpy.viewRoot : undefined;
+            },
         };
     };
 }

package/dist/src/encoder/encoder.d.ts

@@ -97,12 +97,12 @@ export function isChannelDefWithScale(channelDef: import("../spec/channel.js").C
 /**
  * @param {import("../spec/channel.js").ChannelDef} channelDef
  */
-export function findChannelDefWithScale(channelDef: import("../spec/channel.js").ChannelDef): import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>, number> | import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>, string> | import("../spec/channel.js").PositionFieldDef | import("../spec/channel.js").ChromPosDef | import("../spec/channel.js").PositionDatumDef | import("../spec/channel.js").MarkPropExprDef<import("../spec/channel.js").Type> | import("../spec/channel.js").Conditional<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>>;
+export function findChannelDefWithScale(channelDef: import("../spec/channel.js").ChannelDef): import("../spec/channel.js").ChannelDefWithScale;
 /**
  * @param {import("../view/unitView.js").default} view
  * @param {import("../spec/channel.js").Channel} channel
  */
-export function getChannelDefWithScale(view: import("../view/unitView.js").default, channel: import("../spec/channel.js").Channel): import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>, number> | import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>, string> | import("../spec/channel.js").PositionFieldDef | import("../spec/channel.js").ChromPosDef | import("../spec/channel.js").PositionDatumDef | import("../spec/channel.js").MarkPropExprDef<import("../spec/channel.js").Type> | import("../spec/channel.js").Conditional<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>>;
+export function getChannelDefWithScale(view: import("../view/unitView.js").default, channel: import("../spec/channel.js").Channel): import("../spec/channel.js").ChannelDefWithScale;
 /**
  * @param {import("../spec/channel.js").ChannelDef} channelDef
  * @returns {channelDef is import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type>}

package/dist/src/encoder/encoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../src/encoder/encoder.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../src/encoder/encoder.js"],"names":[],"mappings":"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"}

package/dist/src/encoder/encoder.js

@@ -362,11 +362,12 @@ export function isChannelDefWithScale(channelDef) {
 export function findChannelDefWithScale(channelDef) {
     if (isValueDefWithCondition(channelDef)) {
         const condition = channelDef.condition;
-        if (!Array.isArray(condition) && isChannelDefWithScale(condition)) {
-            return condition;
+        const conditions = Array.isArray(condition) ? condition : [condition];
+        return conditions.find((condition) => isChannelDefWithScale(condition));
+    } else {
+        if (isChannelDefWithScale(channelDef)) {
+            return channelDef;
         }
-    } else if (isChannelDefWithScale(channelDef)) {
-        return channelDef;
     }
 }
 

package/dist/src/fonts/bmFontManager.d.ts

@@ -51,7 +51,7 @@ export default class BmFontManager {
      * @param {FontWeight | keyof WEIGHTS} weight
      * @returns {FontEntry}
      */
-    getFont(family: string, style?: FontStyle, weight?: FontWeight | ("bold" | "normal" | "thin" | "light" | "regular" | "medium" | "black")): FontEntry;
+    getFont(family?: string, style?: FontStyle, weight?: FontWeight | ("bold" | "black" | "normal" | "thin" | "light" | "regular" | "medium")): FontEntry;
     /**
      *
      * @param {FontEntry} fontEntry An uninitialized font entry

package/dist/src/fonts/bmFontManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bmFontManager.d.ts","sourceRoot":"","sources":["../../../src/fonts/bmFontManager.js"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IACI;;OAEG;IACH,0BAFW,OAAO,sBAAsB,EAAE,OAAO,EAgChD;IA7BG,qDAA+B;IAE/B,uBACiF;IAEjF;;OAEG;IACH,QAFU,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAEc;IAE/C,8DAA8D;IAC9D,mBADW,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC,CACxB;IAElC,kDAAkD;IAClD,eADW,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAChB;IAE9B,uEAAuE;IACvE,WADW,OAAO,CAAC,IAAI,CAAC,EAAE,CACP;IAEnB;;;OAGG;IACH,mBAFU,SAAS,CAOlB;IAGL,gCAEC;IAED;;;;;;OAMG;IACH,gBALW,MAAM,UACN,SAAS,WACT,UAAU,0EAAgB,GACxB,SAAS,CAyBrB;IAED;;;;OAIG;IACH,0BAHW,SAAS,OACT,OAAO,iBA0BjB;IAED;;OAEG;IACH,eAFW,MAAM,uDAoBhB;IAED;;;OAGG;IACH,sBAFW,MAAM,sCA+BhB;IAED,4BAEC;IAED;;;;OAIG;IACH,0BAHW,MAAM,GACJ,OAAO,CAAC,YAAY,CAAC,CAqBjC;IAED;;;;OAIG;IACH,6BAHW,MAAM,GACJ,YAAY,CA0BxB;CACJ;;;;;;;;;;UAgBS,MAAM;;;;WACN,MAAM;;;;YACN,MAAM;;;;cACN,MAAM;;;;sBACN,MAAM;;;;eACN,MAAM;;;;eACN,MAAM;;;;;;;;;qBAlQH,OAAO,oBAAoB,EAAE,MAAM;;;;;;;;4BACnC,OAAO,oBAAoB,EAAE,aAAa;;;;;;;;wBAE1C,QAAQ,GAAG,QAAQ;;;;;;;;yBACnB,MAAM;;;;;;;;;YAGT,MAAM;WACN,SAAS;YACT,UAAU;;;;;;;;;;aAGV,aAAa;aACb,YAAY"}
+{"version":3,"file":"bmFontManager.d.ts","sourceRoot":"","sources":["../../../src/fonts/bmFontManager.js"],"names":[],"mappings":"AAwBA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IACI;;OAEG;IACH,0BAFW,OAAO,sBAAsB,EAAE,OAAO,EAiChD;IA9BG,qDAA+B;IAE/B,uBACiF;IAEjF;;OAEG;IACH,QAFU,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAEc;IAE/C,8DAA8D;IAC9D,mBADW,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC,CACxB;IAElC,kDAAkD;IAClD,eADW,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAChB;IAE9B,uEAAuE;IACvE,WADW,OAAO,CAAC,IAAI,CAAC,EAAE,CACP;IAEnB;;;OAGG;IACH,mBAFU,SAAS,CAOlB;IAIL,gCAEC;IAED;;;;;;OAMG;IACH,iBALW,MAAM,UACN,SAAS,WACT,UAAU,0EAAgB,GACxB,SAAS,CAiBrB;IAED;;;;OAIG;IACH,0BAHW,SAAS,OACT,OAAO,iBA0BjB;IAED;;OAEG;IACH,eAFW,MAAM,uDAoBhB;IAED;;;OAGG;IACH,sBAFW,MAAM,sCA+BhB;IAED,4BAEC;IAED;;;;OAIG;IACH,0BAHW,MAAM,GACJ,OAAO,CAAC,YAAY,CAAC,CAqBjC;IAED;;;;OAIG;IACH,6BAHW,MAAM,GACJ,YAAY,CA0BxB;CACJ;;;;;;;;;;UAmDS,MAAM;;;;WACN,MAAM;;;;YACN,MAAM;;;;cACN,MAAM;;;;sBACN,MAAM;;;;eACN,MAAM;;;;eACN,MAAM;;;;;;;;;qBA9RH,OAAO,oBAAoB,EAAE,MAAM;;;;;;;;4BACnC,OAAO,oBAAoB,EAAE,aAAa;;;;;;;;wBAE1C,QAAQ,GAAG,QAAQ;;;;;;;;yBACnB,MAAM;;;;;;;;;YAGT,MAAM;WACN,SAAS;YACT,UAAU;;;;;;;;;;aAGV,aAAa;aACb,YAAY"}

package/dist/src/fonts/bmFontManager.js

@@ -15,6 +15,13 @@ const WEIGHTS = {
     black: 900,
 };
 
+/** @type {FontKey} */
+const DEFAULT_FONT_KEY = {
+    family: "Lato",
+    style: "normal",
+    weight: 400,
+};
+
 /**
  * Loader for A-Frame fonts.
  *
@@ -72,6 +79,7 @@ export default class BmFontManager {
                 ? this._createTextureNow(latoRegularBitmap)
                 : undefined,
         };
+        this._fonts.set(DEFAULT_FONT_KEY, this._defaultFontEntry);
     }
 
     async waitUntilReady() {
@@ -85,16 +93,8 @@ export default class BmFontManager {
      * @param {FontWeight | keyof WEIGHTS} weight
      * @returns {FontEntry}
      */
-    getFont(family, style = "normal", weight = "regular") {
-        if (isString(weight)) {
-            weight =
-                WEIGHTS[/** @type {keyof WEIGHTS} */ (weight.toLowerCase())];
-            if (!weight) {
-                throw new Error("Unknown font weight: " + weight);
-            }
-        }
-
-        const key = { family, style, weight };
+    getFont(family = DEFAULT_FONT_KEY.family, style = "normal", weight = 400) {
+        const key = normalizeFontKey(family, style, weight);
         let fontEntry = this._fonts.get(key);
         if (!fontEntry) {
             // Return and empty entry, load it asynchronously
@@ -261,6 +261,41 @@ export default class BmFontManager {
     }
 }
 
+/**
+ * @param {string} family
+ * @param {FontStyle} style
+ * @param {FontWeight | keyof WEIGHTS} weight
+ * @returns {FontKey}
+ */
+function normalizeFontKey(family, style, weight) {
+    return {
+        family:
+            family.toLowerCase() == "sans-serif"
+                ? DEFAULT_FONT_KEY.family
+                : family,
+        style,
+        weight: normalizeFontWeight(weight),
+    };
+}
+
+/**
+ * @param {FontWeight | keyof WEIGHTS} weight
+ * @returns {FontWeight}
+ */
+function normalizeFontWeight(weight) {
+    if (isString(weight)) {
+        const numericWeight =
+            WEIGHTS[/** @type {keyof WEIGHTS} */ (weight.toLowerCase())];
+        if (!numericWeight) {
+            throw new Error("Unknown font weight: " + weight);
+        }
+
+        return numericWeight;
+    }
+
+    return weight;
+}
+
 /**
  *
  * @param {string} family

package/dist/src/fonts/textMetrics.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @typedef {import("./bmFontManager.js").BMFontMetrics} BMFontMetrics
+ * @typedef {import("../spec/font.js").FontStyle} FontStyle
+ * @typedef {import("../spec/font.js").FontWeight} FontWeight
+ * @typedef {{ metrics?: BMFontMetrics, texture?: WebGLTexture }} FontEntryLike
+ * @typedef {{
+ *     font?: string,
+ *     fontStyle?: FontStyle,
+ *     fontWeight?: FontWeight,
+ * }} FontConfig
+ * @typedef {{
+ *     getDefaultFont: () => FontEntryLike,
+ *     getFont: (
+ *         family?: string,
+ *         style?: FontStyle,
+ *         weight?: FontWeight
+ *     ) => FontEntryLike,
+ * }} FontManagerLike
+ */
+/**
+ * Requests a font entry and registers asynchronous loading for custom fonts.
+ *
+ * @param {FontManagerLike} fontManager
+ * @param {FontConfig} config
+ * @returns {FontEntryLike}
+ */
+export function requestFont(fontManager: FontManagerLike, config: FontConfig): FontEntryLike;
+/**
+ * @param {BMFontMetrics} metrics
+ * @param {number} fontSize
+ */
+export function getTextHeight(metrics: BMFontMetrics, fontSize: number): number;
+/**
+ * @param {BMFontMetrics} metrics
+ * @param {string} text
+ * @param {number} fontSize
+ */
+export function measureText(metrics: BMFontMetrics, text: string, fontSize: number): {
+    width: number;
+    height: number;
+};
+/**
+ * Returns the projected text extent along a layout direction after rotation.
+ *
+ * @param {{ width: number, height: number }} size
+ * @param {number} angle
+ * @param {"horizontal" | "vertical"} direction
+ */
+export function getProjectedTextExtent(size: {
+    width: number;
+    height: number;
+}, angle: number, direction: "horizontal" | "vertical"): number;
+export type BMFontMetrics = import("./bmFontManager.js").BMFontMetrics;
+export type FontStyle = import("../spec/font.js").FontStyle;
+export type FontWeight = import("../spec/font.js").FontWeight;
+export type FontEntryLike = {
+    metrics?: BMFontMetrics;
+    texture?: WebGLTexture;
+};
+export type FontConfig = {
+    font?: string;
+    fontStyle?: FontStyle;
+    fontWeight?: FontWeight;
+};
+export type FontManagerLike = {
+    getDefaultFont: () => FontEntryLike;
+    getFont: (family?: string, style?: FontStyle, weight?: FontWeight) => FontEntryLike;
+};
+//# sourceMappingURL=textMetrics.d.ts.map

package/dist/src/fonts/textMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textMetrics.d.ts","sourceRoot":"","sources":["../../../src/fonts/textMetrics.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;GAMG;AACH,yCAJW,eAAe,UACf,UAAU,GACR,aAAa,CAQzB;AAED;;;GAGG;AACH,uCAHW,aAAa,YACb,MAAM,UAMhB;AAED;;;;GAIG;AACH,qCAJW,aAAa,QACb,MAAM,YACN,MAAM;;;EAOhB;AAED;;;;;;GAMG;AACH,6CAJW;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,SACjC,MAAM,aACN,YAAY,GAAG,UAAU,UAUnC;4BAvEY,OAAO,oBAAoB,EAAE,aAAa;wBAC1C,OAAO,iBAAiB,EAAE,SAAS;yBACnC,OAAO,iBAAiB,EAAE,UAAU;4BACpC;IAAE,OAAO,CAAC,EAAE,aAAa,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE;yBACnD;IACN,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,UAAU,CAAC;CAC3B;8BACS;IACN,cAAc,EAAE,MAAM,aAAa,CAAC;IACpC,OAAO,EAAE,CACL,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,SAAS,EACjB,MAAM,CAAC,EAAE,UAAU,KAClB,aAAa,CAAC;CACtB"}