@phin-tech/dottie 0.6.1 → 0.6.3

package/dist/fonts/OFL-architects-daughter.txt

@@ -0,0 +1,93 @@
+Copyright (c) 2010, Kimberly Geswein (kimberlygeswein.com)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/fonts/OFL-caveat.txt

@@ -0,0 +1,93 @@
+Copyright 2014 The Caveat Project Authors (https://github.com/googlefonts/caveat)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/fonts/OFL-patrick-hand.txt

@@ -0,0 +1,93 @@
+Copyright (c) 2010-2012 Patrick Wagesreiter (mail@patrickwagesreiter.at)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/types/compile.d.ts

@@ -1,5 +1,6 @@
+import type { Face } from "./metrics.ts";
 /** What follows the runtime; DOTTIE_DATA and DOTTIE_OPTIONS are replaced with JSON. Plain ES5, unminified. */
-export declare const LOADER = ";(function () {\n  var data = DOTTIE_DATA, options = DOTTIE_OPTIONS;\n  var script = document.currentScript;\n  function attr(el, name, value) { el.setAttribute(name.replace(/[A-Z]/g, function (c) { return \"-\" + c.toLowerCase(); }), value); }\n  function mount() {\n    var player = document.createElement(\"dottie-player\"), k;\n    for (k in options) attr(player, k, options[k]);\n    if (script) for (k in script.dataset) if (k !== \"target\") attr(player, k, script.dataset[k]);\n    var target = script && script.dataset.target ? document.querySelector(script.dataset.target) : null;\n    if (target) target.appendChild(player);\n    else if (script && script.parentNode && script.parentNode !== document.head) script.parentNode.insertBefore(player, script);\n    else document.body.appendChild(player);\n    player.setFile(window.Dottie.parseDottie(data));\n  }\n  if (document.readyState === \"loading\" && (!script || script.parentNode === document.head || script.dataset.target)) {\n    document.addEventListener(\"DOMContentLoaded\", mount);\n  } else {\n    mount();\n  }\n})();\n";
+export declare const LOADER = ";(function () {\n  var data = DOTTIE_DATA, options = DOTTIE_OPTIONS, fonts = DOTTIE_FONTS;\n  var script = document.currentScript;\n  if (window.Dottie.addFonts) window.Dottie.addFonts(Object.keys(fonts), fonts);\n  function attr(el, name, value) { el.setAttribute(name.replace(/[A-Z]/g, function (c) { return \"-\" + c.toLowerCase(); }), value); }\n  function mount() {\n    var player = document.createElement(\"dottie-player\"), k;\n    for (k in options) attr(player, k, options[k]);\n    if (script) for (k in script.dataset) if (k !== \"target\") attr(player, k, script.dataset[k]);\n    var target = script && script.dataset.target ? document.querySelector(script.dataset.target) : null;\n    if (target) target.appendChild(player);\n    else if (script && script.parentNode && script.parentNode !== document.head) script.parentNode.insertBefore(player, script);\n    else document.body.appendChild(player);\n    player.setFile(window.Dottie.parseDottie(data));\n  }\n  if (document.readyState === \"loading\" && (!script || script.parentNode === document.head || script.dataset.target)) {\n    document.addEventListener(\"DOMContentLoaded\", mount);\n  } else {\n    mount();\n  }\n})();\n";
 export interface CompileOptions {
     /** Page name or 1-based number; only that page goes in. The first page by default. */
     page?: string | number;
@@ -10,6 +11,9 @@ export interface CompileOptions {
     noAutoplay?: boolean;
     noLoop?: boolean;
     label?: string;
+    /** A bundled font's file (`fontFile`) as base64, so the drawing carries the fonts it uses; without it the
+     * player fetches them from beside itself. dottie-compile reads them from dist/fonts. */
+    fontData?: (family: string, face: Face) => string | undefined;
 }
 /** JSON safe inside a script: it can't close the tag or start a comment. */
 export declare function scriptJSON(value: unknown): string;

package/dist/types/connector.d.ts

@@ -6,18 +6,18 @@ export declare function portPoint(shape: Element, port: Port): Point;
 /** Where the line from the shape's center toward `target` crosses its outline. */
 export declare function edgePoint(shape: Element, toward: Point): Point;
 export declare function endpoints(e: Element, index: Index): [Point, Point];
+/** A curve is joined cubic Béziers: the start, then two controls and an end per segment. */
 export type Route = {
     kind: "polyline";
     points: Point[];
 } | {
-    kind: "cubic";
-    a: Point;
-    b: Point;
-    c: Point;
-    d: Point;
+    kind: "curve";
+    points: Point[];
 };
-/** A route's centerline as points; a cubic is sampled at 25 points. */
+/** A route's centerline as points; each cubic segment is sampled at 25 points. */
 export declare function routePoints(r: Route): Point[];
+/** Drops repeated points and the middle of three in a line, so dragged bends that fall into line disappear. */
+export declare function simplified(pts: Point[]): Point[];
 export declare function route(e: Element, index: Index): Route;
 /** Arrowhead wing points for a tip at `tip` arriving from `from`. */
 export declare function arrowhead(tip: Point, from: Point, size: number): [Point, Point];

package/dist/types/element.d.ts

@@ -11,6 +11,9 @@ export declare const unrotated: (e: Element, p: Point) => Point;
 export declare function rotatedBounds(e: Element): Rect;
 /** The element with automatic ink drawn as `ink`; a light ink is not used on a light, mostly opaque fill. */
 export declare function resolvingInk(e: Element, ink: RGBA): Element;
+/** What the element's text is drawn in: a text box's and a note's stroke, any other label's `textColor` or,
+ * without one, its stroke. */
+export declare function labelColor(e: Element): RGBA;
 export interface Contour {
     closed: boolean;
     points: Point[];

package/dist/types/fonts.d.ts

@@ -0,0 +1,13 @@
+import type { Page } from "./model.ts";
+import { type Face } from "./metrics.ts";
+/** A bundled font file's name in dist/fonts, e.g. "caveat-bold.woff2". */
+export declare function fontFile(family: string, face: Face): string;
+/** The faces bundled for `family`. */
+export declare function fontFaces(family: string): Face[];
+/** The bundled families text on `page` (and in its symbols) is set in. */
+export declare function usedFonts(page: Page): string[];
+/** Serves the font files from `url` (a folder) instead of the one beside dottie.js. */
+export declare function setFontBase(url: string): void;
+/** Adds `fonts` to the document, once each: from `data` (base64 WOFF2 by family and face) when it has them, else
+ * from the font files, which the browser fetches when text first needs them. */
+export declare function addFonts(fonts: string[], data?: Record<string, Partial<Record<Face, string>>>): void;

package/dist/types/index.d.ts

@@ -1,5 +1,7 @@
 import { type DottieFile, type RGBA } from "./model.ts";
 export * from "./model.ts";
+export { addFonts, fontFaces, fontFile, setFontBase, usedFonts } from "./fonts.ts";
+export { BUNDLED_FONTS } from "./text.ts";
 export { inspect, inspectFrame, inspectPage, sampleTimes } from "./inspect.ts";
 export { DottiePlayer, Playback, definePlayer, pageIndex, withRoughness } from "./player.ts";
 export { bounds, plan, svg, svgParts, type Plan, type Part } from "./svg.ts";
@@ -18,4 +20,4 @@ export interface RenderOptions {
 /** One page of a drawing as an SVG document, as Dottie's own SVG export draws it. */
 export declare function render(source: string | DottieFile | unknown, options?: RenderOptions): string;
 /** The library's version. */
-export declare const VERSION = "0.6.1";
+export declare const VERSION = "0.6.3";

package/dist/types/metrics.d.ts

@@ -1,11 +1,18 @@
-export declare const ascent = 0.951995849609375, descent = 0.2129974365234375, leading = 0.0279998779296875;
-export declare const boldAscent = 0.975006103515625, boldDescent = 0.2169952392578125, boldLeading = 0.0290069580078125;
-export declare const italicAscent = 0.957000732421875, italicDescent = 0.2129974365234375, italicLeading = 0.0279998779296875;
-export declare const boldItalicAscent = 0.975006103515625, boldItalicDescent = 0.2169952392578125, boldItalicLeading = 0.0290069580078125;
-export declare const monoAdvance = 0.60205078125, monoAscent = 0.92822265625, monoDescent = 0.23583984375;
-export declare const fonts: Record<"regular" | "bold" | "italic" | "boldItalic", {
+export type Face = "regular" | "bold" | "italic" | "boldItalic";
+export interface FaceMetrics {
+    ascent: number;
+    descent: number;
+    leading: number;
     w: Record<string, number>;
     k: Record<string, number>;
-}>;
-/** Ascent, descent and leading per em of the fallback font for characters Helvetica Neue lacks. */
-export declare const fallbackMetrics: Record<string, [number, number, number]>;
+}
+export interface FamilyMetrics {
+    /** The faces the font has; text in a face it lacks is set in its regular face. */
+    faces: {
+        regular: FaceMetrics;
+    } & Partial<Record<Face, FaceMetrics>>;
+    /** Ascent, descent and leading per em of the fallback font for characters the font lacks. */
+    fallback: Record<string, [number, number, number]>;
+}
+export declare const monoAdvance = 0.60205078125, monoAscent = 0.92822265625, monoDescent = 0.23583984375;
+export declare const families: Record<string, FamilyMetrics>;

package/dist/types/model.d.ts

@@ -21,10 +21,14 @@ export interface Style {
     roughness: number;
     bowing: number;
     fontSize: number;
+    /** The font text is set in: null is Helvetica Neue, else a bundled handwriting font or one of the viewer's own. */
+    font: string | null;
     gridSize: number | null;
     opacity: number | null;
     /** How far into its dash pattern a dashed or dotted line starts; marching ants set it on every frame. */
     dashOffset: number | null;
+    /** The color of a shape's or connector's label; null follows `stroke`. Text boxes and notes ignore it. */
+    textColor: RGBA | null;
 }
 /** `portIndex` pins the end to one of the bound element's `ports`, and wins over `port`. */
 export interface Endpoint {
@@ -47,6 +51,10 @@ export interface ConnectorData {
     routing: Routing;
     startHead: Arrowhead;
     endHead: Arrowhead;
+    /** Bends on the canvas the line passes through, start to end. */
+    waypoints: StrokePoint[] | null;
+    /** Hops where the line crosses a connector drawn beneath it. */
+    hops: boolean | null;
 }
 export interface PathSubpath {
     closed: boolean;

package/dist/types/shapes.d.ts

@@ -1,5 +1,5 @@
-import { type Index } from "./connector.ts";
-import type { DashStyle, Element } from "./model.ts";
+import { type Index, type Route } from "./connector.ts";
+import { type DashStyle, type Element, type Page } from "./model.ts";
 import { Path, type Point } from "./path.ts";
 /** The `.grid` cell size actually drawn. */
 export declare const cellSize: (e: Element) => number;
@@ -13,5 +13,18 @@ export declare function fillPath(e: Element): Path;
 export declare function hachurePath(e: Element): Path;
 /** Dash lengths for a stroke width; null for a solid line. */
 export declare function dashPattern(dash: DashStyle, width: number): number[] | null;
-/** A connector as the stroked line (with open arrowheads) and the closed heads filled in the stroke color. */
-export declare function connectorParts(e: Element, index: Index): [Path, Path];
+/**
+ * A connector as the stroked line (with open arrowheads) and the closed heads filled in the stroke color. `page`
+ * holds the connectors a hopping line hops over; without it a line draws no hops.
+ */
+export declare function connectorParts(e: Element, index: Index, page?: Page): [Path, Path];
+/** How big a hop is for a line `strokeWidth` wide: its radius. */
+export declare function hopRadius(strokeWidth: number): number;
+/** The points a route's segments are measured along: a straight segment's two ends, or a cubic sampled at 25. */
+export declare function hopSamples(r: Route): Point[][];
+/**
+ * Where a hopping connector's segments (straight, or each cubic of a curve) cross the connectors drawn beneath it
+ * (earlier on a visible layer): for each segment, the distances along it, ascending, leaving out crossings too close
+ * to its ends or the hop before.
+ */
+export declare function hopCrossings(e: Element, r: Route, page: Page, index: Index): number[][];

package/dist/types/text.d.ts

@@ -1,15 +1,29 @@
-export type Face = "regular" | "bold" | "italic" | "boldItalic";
+import { type Face, type FamilyMetrics } from "./metrics.ts";
+export type { Face };
+export declare const DEFAULT_FAMILY = "Helvetica Neue";
+/** The bundled handwriting fonts, by name. */
+export declare const BUNDLED_FONTS: readonly string[];
+/** The bundled family `font` (an element's `style.font`) names, matched without regard to case. */
+export declare function bundledFamily(font: string | null | undefined): string | null;
+/** The measurements text in `font` is laid out with: a bundled font's own, else Helvetica Neue's (a font of one's
+ * own isn't embedded, and dottie.js can't measure it, so it is laid out as Helvetica Neue). */
+export declare function familyMetrics(font: string | null | undefined): FamilyMetrics;
+/** The face text that is `bold` and `italic` is set in: that face, or regular when the font lacks it. */
+export declare function faceOf(fam: FamilyMetrics, bold: boolean, italic: boolean): Face;
+/** The SVG `font-family` for text in `font`: its name, then the fallbacks (Fonts.cssFamily). */
+export declare function cssFamily(font: string | null | undefined): string;
 /** Width of a run of text at `fontSize`, kerned. */
-export declare function measure(s: string, fontSize: number, face?: Face): number;
-/** First line's height, and each further line's, for the regular face (CoreText rounds each metric). */
-export declare function lineHeights(fontSize: number): [number, number];
+export declare function measure(s: string, fontSize: number, face?: Face, font?: string | null): number;
+/** Height of one line, and what each further line adds, for the regular face: CoreText puts baselines on
+ * rounded ascents, descents and leadings, and the frame ends below the last line's descent, rounded up. */
+export declare function lineHeights(fontSize: number, font?: string | null): [number, number];
 /** Whether a line may break after `ch` when `next` follows (Unicode line breaking as CoreText does it: after
  * a space, and after a slash or hyphen not followed by a digit, a space or another of itself). */
 export declare function breaksAfter(ch: string, next: string): boolean;
 /** Lines `s` wraps into within `maxWidth` (or inside a piece too long for a line). */
-export declare function wrap(s: string, fontSize: number, maxWidth: number, face?: Face): string[];
+export declare function wrap(s: string, fontSize: number, maxWidth: number, face?: Face, font?: string | null): string[];
 /** The size CoreText suggests for `s` wrapped at `maxWidth`, rounded up (Renderer.textSize). */
-export declare function textSize(s: string, fontSize: number, maxWidth: number): {
+export declare function textSize(s: string, fontSize: number, maxWidth: number, font?: string | null): {
     width: number;
     height: number;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phin-tech/dottie",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Render, play and compile Dottie (.dottie) drawings and animations in the browser",
   "type": "module",
   "license": "Apache-2.0",