@flighthq/font 0.3.0-next.1315.1d4eb64 → 0.3.0-next.1392.f0bd0cc

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/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;AAWtE,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,40 +1,38 @@
-import { inferFontFormatFromUrl } from './fontFormat';
-import { getFontShorthand } from './fontShorthand';
-// These loaders fill a caller-owned FontResource. Each assigns `out.face` only after its load
-// resolves, which is the contract on failure: a rejected load leaves the resource on whatever face it
-// already had rather than blanking it, so a caller that swallows the rejection keeps rendering with a
-// working font instead of losing one. Assigning before the await would silently turn a failed reload
-// into a broken resource.
+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,8FAA8F;AAC9F,sGAAsG;AACtG,sGAAsG;AACtG,qGAAqG;AACrG,0BAA0B;AAE1B,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/font",
-  "version": "0.3.0-next.1315.1d4eb64",
+  "version": "0.3.0-next.1392.f0bd0cc",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -36,8 +36,8 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/entity": "0.3.0-next.1315.1d4eb64",
-    "@flighthq/types": "0.3.0-next.1315.1d4eb64"
+    "@flighthq/entity": "0.3.0-next.1392.f0bd0cc",
+    "@flighthq/types": "0.3.0-next.1392.f0bd0cc"
   },
   "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

@@ -62,8 +62,8 @@ describe('loadFontResourceFromBytes', () => {
   });
 
   it('slices only the view bytes out of a larger backing buffer', async () => {
-    // Same slice arithmetic as loadFontFromBytes. Tested on both because they are separate
-    // implementations: without this, a regression in one of the two would go unnoticed.
+    // 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]));