@flighthq/font 0.1.0

package/dist/font.d.ts

@@ -0,0 +1,3 @@
+import type { Font } from '@flighthq/types';
+export declare function createFont(name: string): Font;
+//# sourceMappingURL=font.d.ts.map

package/dist/font.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"font.d.ts","sourceRoot":"","sources":["../src/font.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7C"}

package/dist/font.js

@@ -0,0 +1,5 @@
+import { createEntity } from '@flighthq/entity';
+export function createFont(name) {
+    return createEntity({ name });
+}
+//# sourceMappingURL=font.js.map

package/dist/font.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"font.js","sourceRoot":"","sources":["../src/font.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/dist/fontFormat.d.ts

@@ -0,0 +1,2 @@
+export declare function inferFontFormat(url: string): string | null;
+//# sourceMappingURL=fontFormat.d.ts.map

package/dist/fontFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontFormat.d.ts","sourceRoot":"","sources":["../src/fontFormat.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkB1D"}

package/dist/fontFormat.js

@@ -0,0 +1,20 @@
+export function inferFontFormat(url) {
+    const ext = url.split('?')[0].split('.').pop()?.toLowerCase();
+    switch (ext) {
+        case 'woff':
+            return 'woff';
+        case 'woff2':
+            return 'woff2';
+        case 'ttf':
+            return 'truetype';
+        case 'otf':
+            return 'opentype';
+        case 'eot':
+            return 'embedded-opentype';
+        case 'svg':
+            return 'svg';
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=fontFormat.js.map

package/dist/fontFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontFormat.js","sourceRoot":"","sources":["../src/fontFormat.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;IAC9D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,KAAK;YACR,OAAO,UAAU,CAAC;QACpB,KAAK,KAAK;YACR,OAAO,UAAU,CAAC;QACpB,KAAK,KAAK;YACR,OAAO,mBAAmB,CAAC;QAC7B,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/fontFrom.d.ts

@@ -0,0 +1,6 @@
+import type { Font, FontUrl } from '@flighthq/types';
+export declare function loadFontFromBytes(bytes: Uint8Array, family: string): Promise<Font>;
+export declare function loadFontFromName(name: string): Promise<Font>;
+export declare function loadFontFromUrl(url: string, family: string): Promise<Font>;
+export declare function loadFontFromUrls(sources: FontUrl[], family: string): Promise<Font>;
+//# sourceMappingURL=fontFrom.d.ts.map

package/dist/fontFrom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontFrom.d.ts","sourceRoot":"","sources":["../src/fontFrom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAKrD,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"}

package/dist/fontFrom.js

@@ -0,0 +1,31 @@
+import { createFont } from './font';
+import { inferFontFormat } from './fontFormat';
+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);
+    return createFont(family);
+}
+export async function loadFontFromName(name) {
+    await document.fonts.load(`1em '${name}'`);
+    return createFont(name);
+}
+export async function loadFontFromUrl(url, family) {
+    const face = new FontFace(family, `url(${url})`);
+    await face.load();
+    document.fonts.add(face);
+    return createFont(family);
+}
+export async function loadFontFromUrls(sources, family) {
+    const src = sources
+        .map(({ url, format }) => {
+        const fmt = format ?? inferFontFormat(url);
+        return fmt !== null ? `url(${url}) format('${fmt}')` : `url(${url})`;
+    })
+        .join(', ');
+    const face = new FontFace(family, src);
+    await face.load();
+    document.fonts.add(face);
+    return createFont(family);
+}
+//# sourceMappingURL=fontFrom.js.map

package/dist/fontFrom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontFrom.js","sourceRoot":"","sources":["../src/fontFrom.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,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,QAAQ,IAAI,GAAG,CAAC,CAAC;IAC3C,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,eAAe,CAAC,GAAG,CAAC,CAAC;QAC3C,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"}

package/dist/fontResource.d.ts

@@ -0,0 +1,3 @@
+import type { FontResource } from '@flighthq/types';
+export declare function createFontResource(family: string): FontResource;
+//# sourceMappingURL=fontResource.d.ts.map

package/dist/fontResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontResource.d.ts","sourceRoot":"","sources":["../src/fontResource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAE/D"}

package/dist/fontResource.js

@@ -0,0 +1,4 @@
+export function createFontResource(family) {
+    return { family, face: null };
+}
+//# sourceMappingURL=fontResource.js.map

package/dist/fontResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontResource.js","sourceRoot":"","sources":["../src/fontResource.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/fontResourceFrom.d.ts

@@ -0,0 +1,6 @@
+import type { FontResource, FontUrl } from '@flighthq/types';
+export declare function loadFontResourceFromBytes(out: FontResource, bytes: Uint8Array): Promise<FontResource>;
+export declare function loadFontResourceFromName(out: FontResource): Promise<FontResource>;
+export declare function loadFontResourceFromUrl(out: FontResource, url: string): Promise<FontResource>;
+export declare function loadFontResourceFromUrls(out: FontResource, sources: FontUrl[]): Promise<FontResource>;
+//# sourceMappingURL=fontResourceFrom.d.ts.map

package/dist/fontResourceFrom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontResourceFrom.d.ts","sourceRoot":"","sources":["../src/fontResourceFrom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI7D,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"}

package/dist/fontResourceFrom.js

@@ -0,0 +1,35 @@
+import { inferFontFormat } from './fontFormat';
+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);
+    out.face = face;
+    return out;
+}
+export async function loadFontResourceFromName(out) {
+    const faces = await document.fonts.load(`1em '${out.family}'`);
+    if (faces.length > 0)
+        out.face = faces[0];
+    return out;
+}
+export async function loadFontResourceFromUrl(out, url) {
+    const face = new FontFace(out.family, `url(${url})`);
+    await face.load();
+    document.fonts.add(face);
+    out.face = face;
+    return out;
+}
+export async function loadFontResourceFromUrls(out, sources) {
+    const src = sources
+        .map(({ url, format }) => {
+        const fmt = format ?? inferFontFormat(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);
+    out.face = face;
+    return out;
+}
+//# sourceMappingURL=fontResourceFrom.js.map

package/dist/fontResourceFrom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontResourceFrom.js","sourceRoot":"","sources":["../src/fontResourceFrom.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,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,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/D,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,eAAe,CAAC,GAAG,CAAC,CAAC;QAC3C,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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './font';
+export * from './fontFormat';
+export * from './fontFrom';
+export * from './fontResource';
+export * from './fontResourceFrom';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './font';
+export * from './fontFormat';
+export * from './fontFrom';
+export * from './fontResource';
+export * from './fontResourceFrom';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@flighthq/font",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/entity": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Font and font-resource types and constructors",
+  "sideEffects": false
+}

package/src/font.test.ts

@@ -0,0 +1,12 @@
+import { createFont } from './font';
+
+describe('createFont', () => {
+  it('returns a font with the given name', () => {
+    const font = createFont('Arial');
+    expect(font.name).toBe('Arial');
+  });
+
+  it('returns a new object each call', () => {
+    expect(createFont('Arial')).not.toBe(createFont('Arial'));
+  });
+});

package/src/fontFormat.test.ts

@@ -0,0 +1,43 @@
+import { inferFontFormat } from './fontFormat';
+
+describe('inferFontFormat', () => {
+  it('returns "woff" for .woff files', () => {
+    expect(inferFontFormat('font.woff')).toBe('woff');
+  });
+
+  it('returns "woff2" for .woff2 files', () => {
+    expect(inferFontFormat('font.woff2')).toBe('woff2');
+  });
+
+  it('returns "truetype" for .ttf files', () => {
+    expect(inferFontFormat('font.ttf')).toBe('truetype');
+  });
+
+  it('returns "opentype" for .otf files', () => {
+    expect(inferFontFormat('font.otf')).toBe('opentype');
+  });
+
+  it('returns "embedded-opentype" for .eot files', () => {
+    expect(inferFontFormat('font.eot')).toBe('embedded-opentype');
+  });
+
+  it('returns "svg" for .svg files', () => {
+    expect(inferFontFormat('font.svg')).toBe('svg');
+  });
+
+  it('returns null for unrecognized extensions', () => {
+    expect(inferFontFormat('font.bin')).toBeNull();
+  });
+
+  it('strips query parameters before matching', () => {
+    expect(inferFontFormat('font.woff2?v=123')).toBe('woff2');
+  });
+
+  it('is case-insensitive', () => {
+    expect(inferFontFormat('font.WOFF2')).toBe('woff2');
+  });
+
+  it('returns null for a URL with no extension', () => {
+    expect(inferFontFormat('font')).toBeNull();
+  });
+});

package/src/fontFrom.test.ts

@@ -0,0 +1,53 @@
+import { loadFontFromBytes, loadFontFromName, loadFontFromUrl, loadFontFromUrls } from './fontFrom';
+
+class MockFontFace {
+  load = vi.fn().mockResolvedValue(undefined);
+}
+
+// Re-applied per test (not once) and torn down, so under a shared (isolate:false) worker with
+// unstubGlobals the FontFace stub survives every test and the document.fonts patch never leaks out.
+let originalFonts: PropertyDescriptor | undefined;
+beforeEach(() => {
+  vi.stubGlobal('FontFace', MockFontFace);
+  originalFonts = Object.getOwnPropertyDescriptor(document, 'fonts');
+  Object.defineProperty(document, 'fonts', {
+    value: { add: vi.fn(), load: vi.fn().mockResolvedValue([]) },
+    configurable: true,
+  });
+});
+
+afterEach(() => {
+  if (originalFonts) {
+    Object.defineProperty(document, 'fonts', originalFonts);
+  } else {
+    delete (document as unknown as { fonts?: unknown }).fonts;
+  }
+});
+
+describe('loadFontFromBytes', () => {
+  it('returns a font with the given family name', async () => {
+    const font = await loadFontFromBytes(new Uint8Array(0), 'TestFont');
+    expect(font.name).toBe('TestFont');
+  });
+});
+
+describe('loadFontFromName', () => {
+  it('returns a font with the given name', async () => {
+    const font = await loadFontFromName('MyFont');
+    expect(font.name).toBe('MyFont');
+  });
+});
+
+describe('loadFontFromUrl', () => {
+  it('returns a font with the given family name', async () => {
+    const font = await loadFontFromUrl('font.woff2', 'MyFont');
+    expect(font.name).toBe('MyFont');
+  });
+});
+
+describe('loadFontFromUrls', () => {
+  it('returns a font with the given family name from multiple sources', async () => {
+    const font = await loadFontFromUrls([{ url: 'font.woff2', format: 'woff2' }], 'MyFont');
+    expect(font.name).toBe('MyFont');
+  });
+});

package/src/fontResource.test.ts

@@ -0,0 +1,17 @@
+import { createFontResource } from './fontResource';
+
+describe('createFontResource', () => {
+  it('creates a FontResource with the given family name', () => {
+    const resource = createFontResource('Arial');
+    expect(resource.family).toBe('Arial');
+  });
+
+  it('initializes face to null', () => {
+    const resource = createFontResource('serif');
+    expect(resource.face).toBeNull();
+  });
+
+  it('returns a new object each call', () => {
+    expect(createFontResource('Arial')).not.toBe(createFontResource('Arial'));
+  });
+});

package/src/fontResourceFrom.test.ts

@@ -0,0 +1,91 @@
+import { createFontResource } from './fontResource';
+import {
+  loadFontResourceFromBytes,
+  loadFontResourceFromName,
+  loadFontResourceFromUrl,
+  loadFontResourceFromUrls,
+} from './fontResourceFrom';
+
+let mockFace: { load: ReturnType<typeof vi.fn> };
+
+beforeEach(() => {
+  mockFace = { load: vi.fn().mockResolvedValue(undefined) };
+  vi.stubGlobal(
+    'FontFace',
+    vi.fn(function () {
+      return mockFace;
+    }),
+  );
+  Object.defineProperty(document, 'fonts', {
+    value: { add: vi.fn(), load: vi.fn() },
+    configurable: true,
+    writable: true,
+  });
+  vi.spyOn(document.fonts, 'add').mockImplementation(() => document.fonts);
+  vi.spyOn(document.fonts, 'load').mockResolvedValue([mockFace as unknown as FontFace]);
+});
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+  vi.restoreAllMocks();
+});
+
+describe('loadFontResourceFromBytes', () => {
+  it('loads the face and attaches it to the resource', 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);
+  });
+});
+
+describe('loadFontResourceFromName', () => {
+  it('resolves a face already registered with the document', async () => {
+    const resource = createFontResource('TestFont');
+    const result = await loadFontResourceFromName(resource);
+    expect(result).toBe(resource);
+    expect(resource.face).toBe(mockFace);
+  });
+
+  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();
+  });
+});
+
+describe('loadFontResourceFromUrl', () => {
+  it('loads the face from a URL and attaches it to the resource', async () => {
+    const resource = createFontResource('TestFont');
+    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);
+  });
+});
+
+describe('loadFontResourceFromUrls', () => {
+  it('builds a multi-source src string and loads the face', async () => {
+    const resource = createFontResource('TestFont');
+    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);
+  });
+
+  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')"));
+  });
+});