@flighthq/font 0.3.0-next.906.07cea63 → 0.3.0

package/dist/_fontFaceLoad.d.ts

@@ -0,0 +1,6 @@
+import type { FontUrl } from '@flighthq/types/contract';
+export declare function _loadFontFaceFromBytes(family: string, bytes: Uint8Array): Promise<FontFace>;
+export declare function _loadFontFaceFromUrl(family: string, url: string): Promise<FontFace>;
+export declare function _loadFontFaceFromUrls(family: string, sources: readonly FontUrl[]): Promise<FontFace>;
+export declare function _loadFontFacesFromName(family: string): Promise<FontFace[]>;
+//# sourceMappingURL=_fontFaceLoad.d.ts.map

package/dist/_fontFaceLoad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_fontFaceLoad.d.ts","sourceRoot":"","sources":["../src/_fontFaceLoad.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAKxD,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAGjG;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEnF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQpG;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAE1E"}

package/dist/_fontFaceLoad.js

@@ -0,0 +1,28 @@
+import { inferFontFormatFromUrl } from './fontFormat';
+import { getFontShorthand } from './fontShorthand';
+export async function _loadFontFaceFromBytes(family, bytes) {
+    const source = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+    return loadAndRegisterFontFace(family, source);
+}
+export function _loadFontFaceFromUrl(family, url) {
+    return loadAndRegisterFontFace(family, `url(${url})`);
+}
+export function _loadFontFaceFromUrls(family, sources) {
+    const source = sources
+        .map(({ url, format }) => {
+        const resolvedFormat = format ?? inferFontFormatFromUrl(url);
+        return resolvedFormat !== null ? `url(${url}) format('${resolvedFormat}')` : `url(${url})`;
+    })
+        .join(', ');
+    return loadAndRegisterFontFace(family, source);
+}
+export function _loadFontFacesFromName(family) {
+    return document.fonts.load(getFontShorthand(family));
+}
+async function loadAndRegisterFontFace(family, source) {
+    const face = new FontFace(family, source);
+    await face.load();
+    document.fonts.add(face);
+    return face;
+}
+//# sourceMappingURL=_fontFaceLoad.js.map

package/dist/_fontFaceLoad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_fontFaceLoad.js","sourceRoot":"","sources":["../src/_fontFaceLoad.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAc,EAAE,KAAiB;IAC5E,MAAM,MAAM,GAAI,KAAK,CAAC,MAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1G,OAAO,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,GAAW;IAC9D,OAAO,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,OAA2B;IAC/E,MAAM,MAAM,GAAG,OAAO;SACnB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QACvB,MAAM,cAAc,GAAG,MAAM,IAAI,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,GAAG,aAAa,cAAc,IAAI,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC;IAC7F,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,MAAc,EAAE,MAA4B;IACjF,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAClB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/contract.d.ts

@@ -5,4 +5,5 @@ export * from './fontResource';
 export * from './fontResourceFrom';
 export * from './fontShorthand';
 export * from './fontStatus';
+export * from './glyphOutlineSource';
 //# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}

package/dist/contract.js

@@ -5,4 +5,5 @@ export * from './fontResource';
 export * from './fontResourceFrom';
 export * from './fontShorthand';
 export * from './fontStatus';
+export * from './glyphOutlineSource';
 //# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC"}

package/dist/fontFrom.d.ts

@@ -1,6 +1,19 @@
 import type { Font, FontUrl } from '@flighthq/types/contract';
+/**
+ * Loads a font face from bytes and returns its family handle. If loading rejects, the face is not
+ * registered and no `Font` is returned.
+ */
 export declare function loadFontFromBytes(bytes: Uint8Array, family: string): Promise<Font>;
+/** Looks up a registered family and returns its handle. If the lookup rejects, no `Font` is returned. */
 export declare function loadFontFromName(name: string): Promise<Font>;
+/**
+ * Loads a font face from one URL and returns its family handle. If loading rejects, the face is not
+ * registered and no `Font` is returned.
+ */
 export declare function loadFontFromUrl(url: string, family: string): Promise<Font>;
+/**
+ * Loads a font face from fallback URLs and returns its family handle. If loading rejects, the face is
+ * not registered and no `Font` is returned.
+ */
 export declare function loadFontFromUrls(sources: FontUrl[], family: string): Promise<Font>;
 //# sourceMappingURL=fontFrom.d.ts.map

package/dist/fontFrom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fontFrom.d.ts","sourceRoot":"","sources":["../src/fontFrom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAM9D,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxF;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhF;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWxF"}
+{"version":3,"file":"fontFrom.d.ts","sourceRoot":"","sources":["../src/fontFrom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAU9D;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxF;AAED,yGAAyG;AACzG,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxF"}

package/dist/fontFrom.js

@@ -1,32 +1,32 @@
+import { _loadFontFaceFromBytes, _loadFontFaceFromUrl, _loadFontFaceFromUrls, _loadFontFacesFromName, } from './_fontFaceLoad';
 import { createFont } from './font';
-import { inferFontFormatFromUrl } from './fontFormat';
-import { getFontShorthand } from './fontShorthand';
+/**
+ * Loads a font face from bytes and returns its family handle. If loading rejects, the face is not
+ * registered and no `Font` is returned.
+ */
 export async function loadFontFromBytes(bytes, family) {
-    const face = new FontFace(family, bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength));
-    await face.load();
-    document.fonts.add(face);
+    await _loadFontFaceFromBytes(family, bytes);
     return createFont(family);
 }
+/** Looks up a registered family and returns its handle. If the lookup rejects, no `Font` is returned. */
 export async function loadFontFromName(name) {
-    await document.fonts.load(getFontShorthand(name));
+    await _loadFontFacesFromName(name);
     return createFont(name);
 }
+/**
+ * Loads a font face from one URL and returns its family handle. If loading rejects, the face is not
+ * registered and no `Font` is returned.
+ */
 export async function loadFontFromUrl(url, family) {
-    const face = new FontFace(family, `url(${url})`);
-    await face.load();
-    document.fonts.add(face);
+    await _loadFontFaceFromUrl(family, url);
     return createFont(family);
 }
+/**
+ * Loads a font face from fallback URLs and returns its family handle. If loading rejects, the face is
+ * not registered and no `Font` is returned.
+ */
 export async function loadFontFromUrls(sources, family) {
-    const src = sources
-        .map(({ url, format }) => {
-        const fmt = format ?? inferFontFormatFromUrl(url);
-        return fmt !== null ? `url(${url}) format('${fmt}')` : `url(${url})`;
-    })
-        .join(', ');
-    const face = new FontFace(family, src);
-    await face.load();
-    document.fonts.add(face);
+    await _loadFontFaceFromUrls(family, sources);
     return createFont(family);
 }
 //# sourceMappingURL=fontFrom.js.map

package/dist/fontFrom.js.map

@@ -1 +1 @@
-{"version":3,"file":"fontFrom.js","sourceRoot":"","sources":["../src/fontFrom.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAiB,EAAE,MAAc;IACvE,MAAM,IAAI,GAAG,IAAI,QAAQ,CACvB,MAAM,EACL,KAAK,CAAC,MAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAC3F,CAAC;IACF,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAClB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY;IACjD,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,MAAc;IAC/D,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,GAAG,CAAC,CAAC;IACjD,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAClB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAkB,EAAE,MAAc;IACvE,MAAM,GAAG,GAAG,OAAO;SAChB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QACvB,MAAM,GAAG,GAAG,MAAM,IAAI,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAClD,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,GAAG,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC;IACvE,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAClB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"fontFrom.js","sourceRoot":"","sources":["../src/fontFrom.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAiB,EAAE,MAAc;IACvE,MAAM,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,yGAAyG;AACzG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY;IACjD,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,MAAc;IAC/D,MAAM,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAkB,EAAE,MAAc;IACvE,MAAM,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/fontResourceFrom.d.ts

@@ -1,6 +1,22 @@
 import type { FontResource, FontUrl } from '@flighthq/types/contract';
+/**
+ * Loads a face from bytes into `out`. If loading rejects, no face is registered and `out.face` retains
+ * its previous value, so a failed reload does not blank a working resource.
+ */
 export declare function loadFontResourceFromBytes(out: FontResource, bytes: Uint8Array): Promise<FontResource>;
+/**
+ * Looks up an existing family and attaches its first face to `out`. If the lookup rejects or returns no
+ * faces, `out.face` retains its previous value.
+ */
 export declare function loadFontResourceFromName(out: FontResource): Promise<FontResource>;
+/**
+ * Loads a face from one URL into `out`. If loading rejects, no face is registered and `out.face`
+ * retains its previous value, so a failed reload does not blank a working resource.
+ */
 export declare function loadFontResourceFromUrl(out: FontResource, url: string): Promise<FontResource>;
+/**
+ * Loads a face from fallback URLs into `out`. If loading rejects, no face is registered and `out.face`
+ * retains its previous value, so a failed reload does not blank a working resource.
+ */
 export declare function loadFontResourceFromUrls(out: FontResource, sources: FontUrl[]): Promise<FontResource>;
 //# sourceMappingURL=fontResourceFrom.d.ts.map

package/dist/fontResourceFrom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fontResourceFrom.d.ts","sourceRoot":"","sources":["../src/fontResourceFrom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAKtE,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAS3G;AAED,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAIvF;AAED,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAMnG;AAED,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAY3G"}
+{"version":3,"file":"fontResourceFrom.d.ts","sourceRoot":"","sources":["../src/fontResourceFrom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAStE;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAI3G;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAIvF;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAInG;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAI3G"}

package/dist/fontResourceFrom.js

@@ -1,35 +1,38 @@
-import { inferFontFormatFromUrl } from './fontFormat';
-import { getFontShorthand } from './fontShorthand';
+import { _loadFontFaceFromBytes, _loadFontFaceFromUrl, _loadFontFaceFromUrls, _loadFontFacesFromName, } from './_fontFaceLoad';
+/**
+ * Loads a face from bytes into `out`. If loading rejects, no face is registered and `out.face` retains
+ * its previous value, so a failed reload does not blank a working resource.
+ */
 export async function loadFontResourceFromBytes(out, bytes) {
-    const face = new FontFace(out.family, bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength));
-    await face.load();
-    document.fonts.add(face);
+    const face = await _loadFontFaceFromBytes(out.family, bytes);
     out.face = face;
     return out;
 }
+/**
+ * Looks up an existing family and attaches its first face to `out`. If the lookup rejects or returns no
+ * faces, `out.face` retains its previous value.
+ */
 export async function loadFontResourceFromName(out) {
-    const faces = await document.fonts.load(getFontShorthand(out.family));
+    const faces = await _loadFontFacesFromName(out.family);
     if (faces.length > 0)
         out.face = faces[0];
     return out;
 }
+/**
+ * Loads a face from one URL into `out`. If loading rejects, no face is registered and `out.face`
+ * retains its previous value, so a failed reload does not blank a working resource.
+ */
 export async function loadFontResourceFromUrl(out, url) {
-    const face = new FontFace(out.family, `url(${url})`);
-    await face.load();
-    document.fonts.add(face);
+    const face = await _loadFontFaceFromUrl(out.family, url);
     out.face = face;
     return out;
 }
+/**
+ * Loads a face from fallback URLs into `out`. If loading rejects, no face is registered and `out.face`
+ * retains its previous value, so a failed reload does not blank a working resource.
+ */
 export async function loadFontResourceFromUrls(out, sources) {
-    const src = sources
-        .map(({ url, format }) => {
-        const fmt = format ?? inferFontFormatFromUrl(url);
-        return fmt !== null ? `url(${url}) format('${fmt}')` : `url(${url})`;
-    })
-        .join(', ');
-    const face = new FontFace(out.family, src);
-    await face.load();
-    document.fonts.add(face);
+    const face = await _loadFontFaceFromUrls(out.family, sources);
     out.face = face;
     return out;
 }

package/dist/fontResourceFrom.js.map

@@ -1 +1 @@
-{"version":3,"file":"fontResourceFrom.js","sourceRoot":"","sources":["../src/fontResourceFrom.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,GAAiB,EAAE,KAAiB;IAClF,MAAM,IAAI,GAAG,IAAI,QAAQ,CACvB,GAAG,CAAC,MAAM,EACT,KAAK,CAAC,MAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAC3F,CAAC;IACF,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAClB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,GAAiB;IAC9D,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,GAAiB,EAAE,GAAW;IAC1E,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,GAAG,CAAC,CAAC;IACrD,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAClB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,GAAiB,EAAE,OAAkB;IAClF,MAAM,GAAG,GAAG,OAAO;SAChB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QACvB,MAAM,GAAG,GAAG,MAAM,IAAI,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAClD,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,GAAG,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC;IACvE,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3C,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAClB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"fontResourceFrom.js","sourceRoot":"","sources":["../src/fontResourceFrom.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,GAAiB,EAAE,KAAiB;IAClF,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7D,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,GAAiB;IAC9D,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1C,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,GAAiB,EAAE,GAAW;IAC1E,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzD,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,GAAiB,EAAE,OAAkB;IAClF,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/glyphOutlineSource.d.ts

@@ -0,0 +1,3 @@
+import type { GlyphOutlineSource, GlyphRasterizerBackend } from '@flighthq/types/contract';
+export declare function createGlyphRasterizerBackendFromGlyphOutlineSource(source: GlyphOutlineSource): GlyphRasterizerBackend;
+//# sourceMappingURL=glyphOutlineSource.d.ts.map

package/dist/glyphOutlineSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glyphOutlineSource.d.ts","sourceRoot":"","sources":["../src/glyphOutlineSource.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,kBAAkB,EAGlB,sBAAsB,EAEvB,MAAM,0BAA0B,CAAC;AAOlC,wBAAgB,kDAAkD,CAAC,MAAM,EAAE,kBAAkB,GAAG,sBAAsB,CAgBrH"}

package/dist/glyphOutlineSource.js

@@ -0,0 +1,107 @@
+import { createPath, flattenPath, getPathBounds } from '@flighthq/path/contract';
+// Adapts an index-keyed vector font into the codepoint-keyed rasterizer consumed by glyphatlas. The
+// adapter is bound to one source, so callers can install it on one GlyphAtlas through
+// `GlyphAtlasOptions.rasterizerBackend` without changing the process-wide backend. Rasterization is a
+// portable 4x4 coverage scan over flattened contours: it needs no DOM/canvas and therefore works for
+// imported fonts in browser, worker, native-host, and headless environments alike.
+export function createGlyphRasterizerBackendFromGlyphOutlineSource(source) {
+    return {
+        measureMetrics(options) {
+            const metrics = source.getGlyphOutlineMetrics();
+            const scale = resolveGlyphOutlineScale(metrics.unitsPerEm, options.fontSize);
+            if (scale === null)
+                return null;
+            return {
+                ascent: metrics.ascent * scale,
+                descent: metrics.descent * scale,
+                lineGap: metrics.lineGap * scale,
+            };
+        },
+        rasterize(codePoint, options) {
+            return rasterizeGlyphOutlineSource(source, codePoint, options);
+        },
+    };
+}
+function rasterizeGlyphOutlineSource(source, codePoint, options) {
+    const glyphIndex = source.getGlyphOutlineIndexForCodePoint(codePoint);
+    if (glyphIndex < 0)
+        return null;
+    const metrics = source.getGlyphOutlineMetrics();
+    const scale = resolveGlyphOutlineScale(metrics.unitsPerEm, options.fontSize);
+    if (scale === null)
+        return null;
+    const path = createPath();
+    if (!source.getGlyphOutline(path, glyphIndex))
+        return null;
+    const advance = source.getGlyphOutlineAdvance(glyphIndex) * scale;
+    if (!Number.isFinite(advance))
+        return null;
+    const bounds = { height: 0, width: 0, x: 0, y: 0 };
+    if (!getPathBounds(path, bounds) || bounds.width === 0 || bounds.height === 0) {
+        return { advance, bearingX: 0, bearingY: 0, height: 0, pixels: new Uint8ClampedArray(), width: 0 };
+    }
+    const left = Math.floor(bounds.x * scale) - RASTER_GUARD;
+    const top = Math.floor(bounds.y * scale) - RASTER_GUARD;
+    const right = Math.ceil((bounds.x + bounds.width) * scale) + RASTER_GUARD;
+    const bottom = Math.ceil((bounds.y + bounds.height) * scale) + RASTER_GUARD;
+    const width = right - left;
+    const height = bottom - top;
+    if (width <= 0 || height <= 0)
+        return null;
+    // Flatten once at quarter-pixel precision in design units. Sampling the Path helper directly would
+    // flatten every curve again for every subpixel and turn raster cost into pixels × path decoding.
+    const contours = flattenPath(path, 0.25 / scale);
+    const pixels = new Uint8ClampedArray(width * height * 4);
+    for (let pixelY = 0; pixelY < height; pixelY++) {
+        for (let pixelX = 0; pixelX < width; pixelX++) {
+            let covered = 0;
+            for (let sampleY = 0; sampleY < RASTER_SAMPLE_AXIS; sampleY++) {
+                const y = (top + pixelY + (sampleY + 0.5) / RASTER_SAMPLE_AXIS) / scale;
+                for (let sampleX = 0; sampleX < RASTER_SAMPLE_AXIS; sampleX++) {
+                    const x = (left + pixelX + (sampleX + 0.5) / RASTER_SAMPLE_AXIS) / scale;
+                    if (containsFlattenedGlyphOutlinePoint(contours, path.winding, x, y))
+                        covered++;
+                }
+            }
+            if (covered === 0)
+                continue;
+            const offset = (pixelY * width + pixelX) * 4;
+            pixels[offset] = 0xff;
+            pixels[offset + 1] = 0xff;
+            pixels[offset + 2] = 0xff;
+            pixels[offset + 3] = Math.round((covered * 0xff) / RASTER_SAMPLE_COUNT);
+        }
+    }
+    return { advance, bearingX: left, bearingY: -top, height, pixels, width };
+}
+function containsFlattenedGlyphOutlinePoint(contours, winding, x, y) {
+    let crossings = 0;
+    for (const contour of contours) {
+        const pointCount = (contour.length / 2) | 0;
+        if (pointCount < 2)
+            continue;
+        let fromX = contour[(pointCount - 1) * 2];
+        let fromY = contour[(pointCount - 1) * 2 + 1];
+        for (let pointIndex = 0; pointIndex < pointCount; pointIndex++) {
+            const toX = contour[pointIndex * 2];
+            const toY = contour[pointIndex * 2 + 1];
+            if ((fromY <= y && toY > y) || (toY <= y && fromY > y)) {
+                const crossingX = fromX + ((y - fromY) * (toX - fromX)) / (toY - fromY);
+                if (x < crossingX)
+                    crossings += toY > fromY ? 1 : -1;
+            }
+            fromX = toX;
+            fromY = toY;
+        }
+    }
+    return winding === 'evenOdd' ? (Math.abs(crossings) & 1) !== 0 : crossings !== 0;
+}
+function resolveGlyphOutlineScale(unitsPerEm, fontSize) {
+    if (!(unitsPerEm > 0) || !(fontSize > 0) || !Number.isFinite(unitsPerEm) || !Number.isFinite(fontSize))
+        return null;
+    return fontSize / unitsPerEm;
+}
+const RASTER_GUARD = 1;
+const RASTER_SAMPLE_AXIS = 4;
+const RASTER_SAMPLE_COUNT = RASTER_SAMPLE_AXIS * RASTER_SAMPLE_AXIS;
+//# sourceMappingURL=glyphOutlineSource.js.map

package/dist/glyphOutlineSource.js.map

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

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { createFont, createFontResource, detectFontFormat, getFontShorthand, inferFontFormatFromUrl, isFontLoaded, loadFontFromBytes, loadFontFromName, loadFontFromUrl, loadFontFromUrls, loadFontResourceFromBytes, loadFontResourceFromName, loadFontResourceFromUrl, loadFontResourceFromUrls, whenFontsReady, } from './contract';
+export { createFont, createFontResource, createGlyphRasterizerBackendFromGlyphOutlineSource, detectFontFormat, getFontShorthand, inferFontFormatFromUrl, isFontLoaded, loadFontFromBytes, loadFontFromName, loadFontFromUrl, loadFontFromUrls, loadFontResourceFromBytes, loadFontResourceFromName, loadFontResourceFromUrl, loadFontResourceFromUrls, whenFontsReady, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,kDAAkD,EAClD,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { createFont, createFontResource, detectFontFormat, getFontShorthand, inferFontFormatFromUrl, isFontLoaded, loadFontFromBytes, loadFontFromName, loadFontFromUrl, loadFontFromUrls, loadFontResourceFromBytes, loadFontResourceFromName, loadFontResourceFromUrl, loadFontResourceFromUrls, whenFontsReady, } from './contract';
+export { createFont, createFontResource, createGlyphRasterizerBackendFromGlyphOutlineSource, detectFontFormat, getFontShorthand, inferFontFormatFromUrl, isFontLoaded, loadFontFromBytes, loadFontFromName, loadFontFromUrl, loadFontFromUrls, loadFontResourceFromBytes, loadFontResourceFromName, loadFontResourceFromUrl, loadFontResourceFromUrls, whenFontsReady, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,kDAAkD,EAClD,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,8 @@
 {
   "name": "@flighthq/font",
-  "version": "0.3.0-next.906.07cea63",
+  "version": "0.3.0",
+  "author": "Joshua Granick and other contributors",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -36,8 +38,9 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/entity": "0.3.0-next.906.07cea63",
-    "@flighthq/types": "0.3.0-next.906.07cea63"
+    "@flighthq/entity": "0.3.0",
+    "@flighthq/path": "0.3.0",
+    "@flighthq/types": "0.3.0"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/_fontFaceLoad.test.ts

@@ -0,0 +1,98 @@
+import {
+  _loadFontFaceFromBytes,
+  _loadFontFaceFromUrl,
+  _loadFontFaceFromUrls,
+  _loadFontFacesFromName,
+} from './_fontFaceLoad';
+
+interface FontFaceConstruction {
+  family: string;
+  source: string | ArrayBuffer;
+  instance: MockFontFace;
+}
+
+let constructions: FontFaceConstruction[];
+let addMock: ReturnType<typeof vi.fn>;
+let loadMock: ReturnType<typeof vi.fn>;
+
+class MockFontFace {
+  load = vi.fn().mockResolvedValue(undefined);
+  constructor(family: string, source: string | ArrayBuffer) {
+    constructions.push({ family, source, instance: this });
+  }
+}
+
+let originalFonts: PropertyDescriptor | undefined;
+beforeEach(() => {
+  constructions = [];
+  addMock = vi.fn();
+  loadMock = vi.fn().mockResolvedValue([]);
+  vi.stubGlobal('FontFace', MockFontFace);
+  originalFonts = Object.getOwnPropertyDescriptor(document, 'fonts');
+  Object.defineProperty(document, 'fonts', {
+    value: { add: addMock, load: loadMock },
+    configurable: true,
+  });
+});
+
+afterEach(() => {
+  if (originalFonts) {
+    Object.defineProperty(document, 'fonts', originalFonts);
+  } else {
+    delete (document as unknown as { fonts?: unknown }).fonts;
+  }
+  vi.unstubAllGlobals();
+  vi.restoreAllMocks();
+});
+
+describe('_loadFontFaceFromBytes', () => {
+  it('loads and registers a face using only the bytes inside the supplied view', async () => {
+    const backing = new Uint8Array([1, 2, 3, 4, 5, 6]);
+    const face = await _loadFontFaceFromBytes('Family', backing.subarray(1, 5));
+
+    expect(face).toBe(constructions[0].instance);
+    expect(new Uint8Array(constructions[0].source as ArrayBuffer)).toEqual(new Uint8Array([2, 3, 4, 5]));
+    expect(constructions[0].instance.load).toHaveBeenCalledOnce();
+    expect(addMock).toHaveBeenCalledWith(face);
+  });
+});
+
+describe('_loadFontFaceFromUrl', () => {
+  it('loads and registers the single URL source', async () => {
+    await _loadFontFaceFromUrl('Family', 'font.woff2');
+    expect(constructions[0].source).toBe('url(font.woff2)');
+    expect(addMock).toHaveBeenCalledWith(constructions[0].instance);
+  });
+});
+
+describe('_loadFontFaceFromUrls', () => {
+  it('composes explicit, inferred, and absent format hints once for both public loader families', async () => {
+    await _loadFontFaceFromUrls('Family', [{ url: 'a.woff2', format: 'woff2' }, { url: 'b.ttf' }, { url: 'c.bin' }]);
+
+    expect(constructions[0].source).toBe("url(a.woff2) format('woff2'), url(b.ttf) format('truetype'), url(c.bin)");
+  });
+
+  it('does not register a face when loading rejects', async () => {
+    const failing = new MockFontFace('Family', '');
+    failing.load.mockRejectedValue(new Error('bad font'));
+    vi.stubGlobal(
+      'FontFace',
+      vi.fn(function () {
+        return failing;
+      }),
+    );
+
+    await expect(_loadFontFaceFromUrls('Family', [{ url: 'font.woff2' }])).rejects.toThrow('bad font');
+    expect(addMock).not.toHaveBeenCalled();
+  });
+});
+
+describe('_loadFontFacesFromName', () => {
+  it('uses the escaped shorthand and returns the document faces', async () => {
+    const faces = [{ family: 'Family' } as unknown as FontFace];
+    loadMock.mockResolvedValue(faces);
+
+    await expect(_loadFontFacesFromName("Family's Name")).resolves.toBe(faces);
+    expect(loadMock).toHaveBeenCalledWith("1em 'Family\\'s Name'");
+  });
+});

package/src/fontResourceFrom.test.ts

@@ -6,86 +6,231 @@ import {
   loadFontResourceFromUrls,
 } from './fontResourceFrom';
 
-let mockFace: { load: ReturnType<typeof vi.fn> };
+interface FontFaceConstruction {
+  family: string;
+  source: string | ArrayBuffer;
+  instance: MockFontFace;
+}
 
+let constructions: FontFaceConstruction[];
+let addMock: ReturnType<typeof vi.fn>;
+let loadMock: ReturnType<typeof vi.fn>;
+
+class MockFontFace {
+  load = vi.fn().mockResolvedValue(undefined);
+  constructor(family: string, source: string | ArrayBuffer) {
+    constructions.push({ family, source, instance: this });
+  }
+}
+
+// Mirrors the harness in fontFrom.test.ts, including its restore discipline: the document.fonts
+// descriptor is saved and put back per test rather than left overwritten, so under a shared
+// (isolate:false) worker the patch cannot leak into a sibling file.
+let originalFonts: PropertyDescriptor | undefined;
 beforeEach(() => {
-  mockFace = { load: vi.fn().mockResolvedValue(undefined) };
-  vi.stubGlobal(
-    'FontFace',
-    vi.fn(function () {
-      return mockFace;
-    }),
-  );
+  constructions = [];
+  addMock = vi.fn();
+  loadMock = vi.fn().mockResolvedValue([]);
+  vi.stubGlobal('FontFace', MockFontFace);
+  originalFonts = Object.getOwnPropertyDescriptor(document, 'fonts');
   Object.defineProperty(document, 'fonts', {
-    value: { add: vi.fn(), load: vi.fn() },
+    value: { add: addMock, load: loadMock },
     configurable: true,
-    writable: true,
   });
-  vi.spyOn(document.fonts, 'add').mockImplementation(() => document.fonts);
-  vi.spyOn(document.fonts, 'load').mockResolvedValue([mockFace as unknown as FontFace]);
 });
 
 afterEach(() => {
+  if (originalFonts) {
+    Object.defineProperty(document, 'fonts', originalFonts);
+  } else {
+    delete (document as unknown as { fonts?: unknown }).fonts;
+  }
   vi.unstubAllGlobals();
   vi.restoreAllMocks();
 });
 
 describe('loadFontResourceFromBytes', () => {
-  it('loads the face and attaches it to the resource', async () => {
+  it('constructs the face under the resource family, loads it, and registers it', async () => {
     const resource = createFontResource('TestFont');
     const result = await loadFontResourceFromBytes(resource, new Uint8Array(8));
     expect(result).toBe(resource);
-    expect(resource.face).toBe(mockFace);
-    expect(mockFace.load).toHaveBeenCalledOnce();
-    expect(document.fonts.add).toHaveBeenCalledWith(mockFace);
+    expect(constructions).toHaveLength(1);
+    expect(constructions[0].family).toBe('TestFont');
+    expect(constructions[0].instance.load).toHaveBeenCalledOnce();
+    expect(addMock).toHaveBeenCalledWith(constructions[0].instance);
+    expect(resource.face).toBe(constructions[0].instance);
+  });
+
+  it('slices only the view bytes out of a larger backing buffer', async () => {
+    // This integration assertion pins that the resource wrapper forwards its view to the canonical
+    // byte loader rather than widening it back to the whole buffer.
+    const backing = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]);
+    await loadFontResourceFromBytes(createFontResource('TestFont'), backing.subarray(2, 6));
+    expect(new Uint8Array(constructions[0].source as ArrayBuffer)).toEqual(new Uint8Array([3, 4, 5, 6]));
+  });
+
+  it('propagates a load failure and does not register the face', async () => {
+    const resource = createFontResource('TestFont');
+    const failing = new MockFontFace('TestFont', new ArrayBuffer(0));
+    failing.load.mockRejectedValue(new Error('bad font'));
+    vi.stubGlobal(
+      'FontFace',
+      vi.fn(function () {
+        return failing;
+      }),
+    );
+    await expect(loadFontResourceFromBytes(resource, new Uint8Array(4))).rejects.toThrow('bad font');
+    expect(addMock).not.toHaveBeenCalled();
+    expect(resource.face).toBeNull();
+  });
+
+  it('leaves a previously loaded face attached when a reload fails', async () => {
+    // The contract this pins: `face` is assigned only after the load resolves, so a failed reload
+    // rejects and leaves the resource on the font it already had rather than blanking it. A caller
+    // that ignores the rejection keeps rendering with a working font instead of losing one.
+    const resource = createFontResource('TestFont');
+    await loadFontResourceFromBytes(resource, new Uint8Array(4));
+    const loaded = resource.face;
+    expect(loaded).not.toBeNull();
+
+    const failing = new MockFontFace('TestFont', new ArrayBuffer(0));
+    failing.load.mockRejectedValue(new Error('boom'));
+    vi.stubGlobal(
+      'FontFace',
+      vi.fn(function () {
+        return failing;
+      }),
+    );
+    await expect(loadFontResourceFromBytes(resource, new Uint8Array(4))).rejects.toThrow('boom');
+    expect(resource.face).toBe(loaded);
+    expect(addMock).toHaveBeenCalledTimes(1);
   });
 });
 
 describe('loadFontResourceFromName', () => {
-  it('resolves a face already registered with the document', async () => {
+  it('queries the family via the escaped font shorthand', async () => {
+    await loadFontResourceFromName(createFontResource('MyFont'));
+    expect(loadMock).toHaveBeenCalledWith("1em 'MyFont'");
+  });
+
+  it('escapes a single quote in the family name so the shorthand stays valid', async () => {
+    await loadFontResourceFromName(createFontResource("Josh's Font"));
+    expect(loadMock).toHaveBeenCalledWith("1em 'Josh\\'s Font'");
+  });
+
+  it('attaches the first face when the document returns several', async () => {
+    const first = { family: 'first' } as unknown as FontFace;
+    const second = { family: 'second' } as unknown as FontFace;
+    loadMock.mockResolvedValue([first, second]);
     const resource = createFontResource('TestFont');
     const result = await loadFontResourceFromName(resource);
     expect(result).toBe(resource);
-    expect(resource.face).toBe(mockFace);
+    expect(resource.face).toBe(first);
   });
 
   it('leaves face null when no registered faces are found', async () => {
-    vi.spyOn(document.fonts, 'load').mockResolvedValue([]);
     const resource = createFontResource('UnknownFont');
     await loadFontResourceFromName(resource);
     expect(resource.face).toBeNull();
   });
+
+  it('registers nothing — a name lookup finds an existing face rather than adding one', async () => {
+    loadMock.mockResolvedValue([{ family: 'x' } as unknown as FontFace]);
+    await loadFontResourceFromName(createFontResource('TestFont'));
+    expect(addMock).not.toHaveBeenCalled();
+    expect(constructions).toHaveLength(0);
+  });
+
+  it('propagates a lookup failure', async () => {
+    loadMock.mockRejectedValue(new Error('no such font'));
+    await expect(loadFontResourceFromName(createFontResource('MyFont'))).rejects.toThrow('no such font');
+  });
 });
 
 describe('loadFontResourceFromUrl', () => {
-  it('loads the face from a URL and attaches it to the resource', async () => {
-    const resource = createFontResource('TestFont');
+  it('builds a url() source under the resource family and registers the face', async () => {
+    const resource = createFontResource('MyFont');
     const result = await loadFontResourceFromUrl(resource, 'https://example.com/font.woff2');
     expect(result).toBe(resource);
-    expect(resource.face).toBe(mockFace);
-    expect(document.fonts.add).toHaveBeenCalledWith(mockFace);
+    expect(constructions[0].family).toBe('MyFont');
+    expect(constructions[0].source).toBe('url(https://example.com/font.woff2)');
+    expect(addMock).toHaveBeenCalledWith(constructions[0].instance);
+    expect(resource.face).toBe(constructions[0].instance);
+  });
+
+  it('adds no format() hint — a single url carries none, unlike the multi-source form', async () => {
+    await loadFontResourceFromUrl(createFontResource('MyFont'), 'font.woff2');
+    expect(constructions[0].source).toBe('url(font.woff2)');
+  });
+
+  it('propagates a load failure and does not register the face', async () => {
+    const resource = createFontResource('MyFont');
+    const failing = new MockFontFace('MyFont', '');
+    failing.load.mockRejectedValue(new Error('bad url'));
+    vi.stubGlobal(
+      'FontFace',
+      vi.fn(function () {
+        return failing;
+      }),
+    );
+    await expect(loadFontResourceFromUrl(resource, 'font.woff2')).rejects.toThrow('bad url');
+    expect(addMock).not.toHaveBeenCalled();
+    expect(resource.face).toBeNull();
   });
 });
 
 describe('loadFontResourceFromUrls', () => {
-  it('builds a multi-source src string and loads the face', async () => {
-    const resource = createFontResource('TestFont');
+  it('composes a comma-joined src with explicit and inferred format() hints', async () => {
+    // The block this replaces was titled "builds a multi-source src string" and asserted nothing
+    // about the string — only that a face was attached. The composed src is the whole point of this
+    // function, and it was the one thing not checked.
+    const resource = createFontResource('MyFont');
     const result = await loadFontResourceFromUrls(resource, [
       { url: 'font.woff2', format: 'woff2' },
       { url: 'font.ttf' },
     ]);
     expect(result).toBe(resource);
-    expect(resource.face).toBe(mockFace);
-    expect(document.fonts.add).toHaveBeenCalledWith(mockFace);
+    expect(constructions[0].family).toBe('MyFont');
+    expect(constructions[0].source).toBe("url(font.woff2) format('woff2'), url(font.ttf) format('truetype')");
+    expect(addMock).toHaveBeenCalledWith(constructions[0].instance);
   });
 
-  it('infers format from file extension when no format is provided', async () => {
-    const MockFontFace = vi.fn(function () {
-      return mockFace;
-    });
-    vi.stubGlobal('FontFace', MockFontFace);
-    const resource = createFontResource('TestFont');
-    await loadFontResourceFromUrls(resource, [{ url: 'font.otf' }]);
-    expect(MockFontFace).toHaveBeenCalledWith('TestFont', expect.stringContaining("format('opentype')"));
+  it('infers the format from the file extension when none is given', async () => {
+    await loadFontResourceFromUrls(createFontResource('MyFont'), [{ url: 'font.otf' }]);
+    expect(constructions[0].source).toBe("url(font.otf) format('opentype')");
+  });
+
+  it('omits the format() hint when it cannot be inferred and none is given', async () => {
+    await loadFontResourceFromUrls(createFontResource('MyFont'), [{ url: 'font.bin' }]);
+    expect(constructions[0].source).toBe('url(font.bin)');
+  });
+
+  it('mixes inferred, explicit, and absent hints across one src list', async () => {
+    await loadFontResourceFromUrls(createFontResource('MyFont'), [
+      { url: 'a.woff2', format: 'woff2' },
+      { url: 'b.ttf' },
+      { url: 'c.bin' },
+    ]);
+    expect(constructions[0].source).toBe("url(a.woff2) format('woff2'), url(b.ttf) format('truetype'), url(c.bin)");
+  });
+
+  it('builds an empty src for an empty source list rather than throwing', async () => {
+    await loadFontResourceFromUrls(createFontResource('MyFont'), []);
+    expect(constructions[0].source).toBe('');
+  });
+
+  it('propagates a load failure and does not register the face', async () => {
+    const resource = createFontResource('MyFont');
+    const failing = new MockFontFace('MyFont', '');
+    failing.load.mockRejectedValue(new Error('bad url'));
+    vi.stubGlobal(
+      'FontFace',
+      vi.fn(function () {
+        return failing;
+      }),
+    );
+    await expect(loadFontResourceFromUrls(resource, [{ url: 'font.woff2' }])).rejects.toThrow('bad url');
+    expect(addMock).not.toHaveBeenCalled();
+    expect(resource.face).toBeNull();
   });
 });

package/src/glyphOutlineSource.test.ts

@@ -0,0 +1,80 @@
+import { appendPathClose, appendPathLineTo, appendPathMoveTo } from '@flighthq/path/contract';
+import type { GlyphOutlineSource, Path } from '@flighthq/types/contract';
+import { describe, expect, it } from 'vitest';
+
+import { createGlyphRasterizerBackendFromGlyphOutlineSource } from './glyphOutlineSource';
+
+describe('createGlyphRasterizerBackendFromGlyphOutlineSource', () => {
+  it('maps codepoints to glyph indices and rasterizes design-unit outlines at the requested em size', () => {
+    const backend = createGlyphRasterizerBackendFromGlyphOutlineSource(createTestGlyphOutlineSource());
+    const raster = backend.rasterize(0x41, { fontFamily: 'embedded', fontSize: 20 });
+
+    expect(raster).not.toBeNull();
+    expect(raster!.advance).toBe(12);
+    expect(raster!.bearingX).toBe(-3);
+    expect(raster!.bearingY).toBe(17);
+    expect(raster!.width).toBe(14);
+    expect(raster!.height).toBe(22);
+    expect(raster!.pixels.some((value, index) => index % 4 === 3 && value === 0xff)).toBe(true);
+    expect(raster!.pixels[3]).toBe(0);
+  });
+
+  it('returns scaled outline metrics to glyphatlas', () => {
+    const backend = createGlyphRasterizerBackendFromGlyphOutlineSource(createTestGlyphOutlineSource());
+
+    expect(backend.measureMetrics?.({ fontFamily: 'embedded', fontSize: 20 })).toEqual({
+      ascent: 16,
+      descent: 4,
+      lineGap: 2,
+    });
+  });
+
+  it('returns a zero-area raster with an advance for an empty glyph', () => {
+    const backend = createGlyphRasterizerBackendFromGlyphOutlineSource(createTestGlyphOutlineSource());
+
+    expect(backend.rasterize(0x20, { fontFamily: 'embedded', fontSize: 20 })).toEqual({
+      advance: 5,
+      bearingX: 0,
+      bearingY: 0,
+      height: 0,
+      pixels: new Uint8ClampedArray(),
+      width: 0,
+    });
+  });
+
+  it('sentinels for an unmapped codepoint or invalid em scale', () => {
+    const backend = createGlyphRasterizerBackendFromGlyphOutlineSource(createTestGlyphOutlineSource());
+
+    expect(backend.rasterize(0x42, { fontFamily: 'embedded', fontSize: 20 })).toBeNull();
+    expect(backend.rasterize(0x41, { fontFamily: 'embedded', fontSize: 0 })).toBeNull();
+  });
+});
+
+function createTestGlyphOutlineSource(): GlyphOutlineSource {
+  return {
+    getGlyphOutline(out: Path, glyphIndex: number): boolean {
+      out.commands.length = 0;
+      out.data.length = 0;
+      out.winding = 'nonZero';
+      if (glyphIndex === 1) return true;
+      if (glyphIndex !== 0) return false;
+      appendPathMoveTo(out, -100, -800);
+      appendPathLineTo(out, 500, -800);
+      appendPathLineTo(out, 500, 200);
+      appendPathLineTo(out, -100, 200);
+      appendPathClose(out);
+      return true;
+    },
+    getGlyphOutlineAdvance(glyphIndex: number): number {
+      return glyphIndex === 1 ? 250 : 600;
+    },
+    getGlyphOutlineIndexForCodePoint(codePoint: number): number {
+      if (codePoint === 0x41) return 0;
+      if (codePoint === 0x20) return 1;
+      return -1;
+    },
+    getGlyphOutlineMetrics() {
+      return { ascent: 800, descent: 200, lineGap: 100, unitsPerEm: 1000 };
+    },
+  };
+}