@glissade/core 0.12.0 → 0.12.1

package/dist/font-ingest.d.ts

@@ -16,8 +16,14 @@ type AxisTuple = Record<string, number>;
 interface RegisterFontInit {
   /** The CSS family name to register under (the §3.6 asset-id convention). */
   family: string;
-  /** Raw font bytes (a path is read to bytes by the caller before this point). */
-  src: FontSource;
+  /**
+   * The font source: raw bytes (`Uint8Array | ArrayBuffer`) OR — node-side only —
+   * a string filesystem path, which this subpath fs-reads to bytes for you. The
+   * string form is a `registerFont`/`ingestFont` convenience; it lives on the
+   * export/prepare-only `@glissade/core/font-ingest` subpath (`node:fs` is fine
+   * here, it never reaches the embed bundle).
+   */
+  src: FontSource | string;
   weight?: number | undefined;
   style?: 'normal' | 'italic' | undefined;
   /**

package/dist/font-ingest.js

@@ -37,6 +37,28 @@ const MAGIC = {
 function asUint8(src) {
 	return src instanceof Uint8Array ? src : new Uint8Array(src);
 }
+/**
+* Resolve a `registerFont`/`ingestFont` `src` to raw bytes. A string is treated
+* as a node-side filesystem PATH and read here via a dynamic `node:fs/promises`
+* import — this subpath is export/prepare-only, so `node:fs` never reaches the
+* embed bundle (the §4.4 leak-guard whitelists this). A `Uint8Array|ArrayBuffer`
+* passes straight through unchanged. An unreadable path throws a clear
+* FontIngestError naming the path (never the downstream "too short" sniff error).
+*/
+async function resolveSource(src) {
+	if (typeof src !== "string") return asUint8(src);
+	let readFile;
+	try {
+		({readFile} = await import("node:fs/promises"));
+	} catch (err) {
+		throw new FontIngestError(`registerFont received a string path ('${src}') but the filesystem is not available here (node-only) — pass Uint8Array bytes instead. (${String(err?.message ?? err)})`);
+	}
+	try {
+		return await readFile(src);
+	} catch (err) {
+		throw new FontIngestError(`could not read font file '${src}': ${String(err?.message ?? err)}`);
+	}
+}
 /** Sniff the leading 4 bytes; throws on input that is not a recognized font. */
 function sniffFontFormat(src) {
 	const u8 = asUint8(src);
@@ -100,8 +122,8 @@ function retainAllText(coverage) {
 * path), keeping the common case off the wasm boundary.
 */
 async function ingestFont(init) {
-	const sourceFormat = sniffFontFormat(init.src);
-	const input = asUint8(init.src);
+	const input = await resolveSource(init.src);
+	const sourceFormat = sniffFontFormat(input);
 	const weight = init.weight ?? 400;
 	const style = init.style ?? "normal";
 	const fallback = init.fallback ? [...init.fallback] : [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/core",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "glissade core: signals, tracks, timeline document, evaluation, easing, springs, seeded RNG. Zero DOM/Node dependencies.",
   "license": "Apache-2.0",
   "engines": {