@remotion/fonts 4.0.450 → 4.0.452

package/dist/cjs/get-font-format.js

@@ -3,6 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getFontFormat = void 0;
 const getFontFormat = (url) => {
     var _a;
+    if (typeof url !== 'string') {
+        throw new TypeError(`Expected a URL string but received ${url === undefined ? 'undefined' : typeof url}. Make sure to pass a "url" field in the options object of loadFont().`);
+    }
     const ext = (_a = url.split('.').pop()) === null || _a === void 0 ? void 0 : _a.toLowerCase();
     switch (ext) {
         case 'woff2':

package/dist/cjs/load-font.d.ts

@@ -14,4 +14,4 @@ export type LoadFontOptions = {
     weight?: string;
     format?: FontFormat;
 };
-export declare const loadFont: ({ family, url, ascentOverride, descentOverride, display, featureSettings, lineGapOverride, stretch, style, unicodeRange, weight, format, variant, }: LoadFontOptions) => Promise<void>;
+export declare const loadFont: (options: LoadFontOptions) => Promise<void>;

package/dist/cjs/load-font.js

@@ -3,7 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadFont = void 0;
 const remotion_1 = require("remotion");
 const get_font_format_1 = require("./get-font-format");
-const loadFont = async ({ family, url, ascentOverride, descentOverride, display, featureSettings, lineGapOverride, stretch, style, unicodeRange, weight, format, variant, }) => {
+const loadFont = async (options) => {
+    if (typeof options !== 'object' || options === null) {
+        throw new TypeError(`loadFont() requires an object as its argument, but received ${typeof options === 'string' ? `"${options}"` : typeof options}. If you want to load a Google Font, use the @remotion/google-fonts package instead. See: https://www.remotion.dev/docs/google-fonts/load-font`);
+    }
+    const { family, url, ascentOverride, descentOverride, display, featureSettings, lineGapOverride, stretch, style, unicodeRange, weight, format, variant, } = options;
+    if (typeof url !== 'string') {
+        throw new TypeError(`loadFont() requires a "url" field in the options object, but received ${url === undefined ? 'undefined' : JSON.stringify(url)}. If you want to load a Google Font, use the @remotion/google-fonts package instead. See: https://www.remotion.dev/docs/google-fonts/load-font`);
+    }
     const waitForFont = (0, remotion_1.delayRender)(`Loading font ${family} (url: ${url}, format: ${format}, weight: ${weight}, style: ${style}, variant: ${variant}, ascentOverride: ${ascentOverride}, descentOverride: ${descentOverride}, display: ${display}, featureSettings: ${featureSettings}, lineGapOverride: ${lineGapOverride}, stretch: ${stretch}, unicodeRange: ${unicodeRange})`);
     try {
         const fontFormat = format !== null && format !== void 0 ? format : (0, get_font_format_1.getFontFormat)(url);

package/dist/esm/index.mjs

@@ -1,5 +1,8 @@
 // src/get-font-format.ts
 var getFontFormat = (url) => {
+  if (typeof url !== "string") {
+    throw new TypeError(`Expected a URL string but received ${url === undefined ? "undefined" : typeof url}. Make sure to pass a "url" field in the options object of loadFont().`);
+  }
   const ext = url.split(".").pop()?.toLowerCase();
   switch (ext) {
     case "woff2":
@@ -17,21 +20,28 @@ var getFontFormat = (url) => {
 
 // src/load-font.ts
 import { cancelRender, continueRender, delayRender } from "remotion";
-var loadFont = async ({
-  family,
-  url,
-  ascentOverride,
-  descentOverride,
-  display,
-  featureSettings,
-  lineGapOverride,
-  stretch,
-  style,
-  unicodeRange,
-  weight,
-  format,
-  variant
-}) => {
+var loadFont = async (options) => {
+  if (typeof options !== "object" || options === null) {
+    throw new TypeError(`loadFont() requires an object as its argument, but received ${typeof options === "string" ? `"${options}"` : typeof options}. If you want to load a Google Font, use the @remotion/google-fonts package instead. See: https://www.remotion.dev/docs/google-fonts/load-font`);
+  }
+  const {
+    family,
+    url,
+    ascentOverride,
+    descentOverride,
+    display,
+    featureSettings,
+    lineGapOverride,
+    stretch,
+    style,
+    unicodeRange,
+    weight,
+    format,
+    variant
+  } = options;
+  if (typeof url !== "string") {
+    throw new TypeError(`loadFont() requires a "url" field in the options object, but received ${url === undefined ? "undefined" : JSON.stringify(url)}. If you want to load a Google Font, use the @remotion/google-fonts package instead. See: https://www.remotion.dev/docs/google-fonts/load-font`);
+  }
   const waitForFont = delayRender(`Loading font ${family} (url: ${url}, format: ${format}, weight: ${weight}, style: ${style}, variant: ${variant}, ascentOverride: ${ascentOverride}, descentOverride: ${descentOverride}, display: ${display}, featureSettings: ${featureSettings}, lineGapOverride: ${lineGapOverride}, stretch: ${stretch}, unicodeRange: ${unicodeRange})`);
   try {
     const fontFormat = format ?? getFontFormat(url);

package/package.json

@@ -3,7 +3,7 @@
 		"url": "https://github.com/remotion-dev/remotion/tree/main/packages/fonts"
 	},
 	"name": "@remotion/fonts",
-	"version": "4.0.450",
+	"version": "4.0.452",
 	"description": "Helpers for loading local fonts into Remotion",
 	"main": "dist/cjs/index.js",
 	"types": "dist/cjs/index.d.ts",
@@ -25,10 +25,10 @@
 		"url": "https://github.com/remotion-dev/remotion/issues"
 	},
 	"dependencies": {
-		"remotion": "4.0.449"
+		"remotion": "4.0.452"
 	},
 	"devDependencies": {
-		"@remotion/eslint-config-internal": "4.0.449",
+		"@remotion/eslint-config-internal": "4.0.452",
 		"eslint": "9.19.0",
 		"@typescript/native-preview": "7.0.0-dev.20260217.1"
 	},