@hyperframes/lint 0.9.13 → 0.9.15

package/dist/browser.js

@@ -6486,7 +6486,11 @@ var textureRules = [
 
 // src/rules/fonts.ts
 import postcss3 from "postcss";
-import { FONT_ALIAS_KEYS, resolveAliasDisplayName } from "@hyperframes/parsers/composition";
+import {
+  FONT_ALIAS_KEYS,
+  parseFontShorthand,
+  resolveAliasDisplayName
+} from "@hyperframes/parsers/composition";
 var GENERIC_FAMILIES = /* @__PURE__ */ new Set([
   "serif",
   "sans-serif",
@@ -6569,14 +6573,20 @@ function resolveUsedFontNames(value, properties, resolving = /* @__PURE__ */ new
     return resolveUsedFontNames(referenced, properties, new Set(resolving).add(property));
   });
 }
+function usedFamilyList(decl) {
+  if (isFontFaceDeclaration(decl)) return "";
+  if (decl.prop.toLowerCase() !== "font") return decl.value;
+  const shorthand = parseFontShorthand(decl.value);
+  return shorthand.certain ? shorthand.families : "";
+}
+var FONT_FAMILY_PROPS = /^font(?:-family)?$/i;
 function extractUsedFontFamilies(styles) {
   const used = [];
   const seen = /* @__PURE__ */ new Set();
   const properties = collectFontCustomProperties(styles);
   for (const style of styles) {
-    parseFontCss(style.content)?.walkDecls(/^font-family$/i, (decl) => {
-      if (isFontFaceDeclaration(decl)) return;
-      for (const name of resolveUsedFontNames(decl.value, properties)) {
+    parseFontCss(style.content)?.walkDecls(FONT_FAMILY_PROPS, (decl) => {
+      for (const name of resolveUsedFontNames(usedFamilyList(decl), properties)) {
         if (!GENERIC_FAMILIES.has(name) && !seen.has(name)) {
           seen.add(name);
           used.push(name);
@@ -6678,9 +6688,33 @@ var fontRules = [
       code: "font_family_without_font_face",
       severity: "error",
       message: `Font ${undeclared.length === 1 ? "family" : "families"} used without @font-face declaration: ${undeclared.join(", ")}. These are not in the auto-resolved font list, so the renderer cannot supply them automatically. Text will fall back to a generic font, producing incorrect typography in the video.`,
-      fixHint: "Add @font-face { font-family: '...'; src: url('capture/assets/fonts/...woff2'); } for each font family, pointing to the captured .woff2 files. For an OS-bundled system font (e.g. Hiragino Sans, Microsoft YaHei) that has no downloadable file, use src: local('Exact Font Name') instead. The declaration alone satisfies this check without needing a font file."
+      fixHint: "Add @font-face { font-family: '...'; src: url('capture/assets/fonts/...woff2'); } for each font family, pointing to the captured .woff2 files, or switch to a Google Fonts family. An OS font such as PingFang SC or Hiragino Sans renders locally from the installed copy, but a cloud render has no copy and refuses it."
     });
     return findings;
+  },
+  ({ styles, rawSource, options, locate }) => {
+    if (isRegistrySourceFile(options.filePath) || isRegistryInstalledFile(rawSource)) return [];
+    const findings = [];
+    for (const style of styles) {
+      parseFontCss(style.content)?.walkAtRules(/^font-face$/i, (rule) => {
+        let family = null;
+        let sources = "";
+        rule.walkDecls((decl) => {
+          const prop = decl.prop.toLowerCase();
+          if (prop === "font-family") family = normalizeUsedFontName(decl.value);
+          else if (prop === "src") sources += ` ${decl.value}`;
+        });
+        if (!family || !/\blocal\s*\(/i.test(sources) || /\burl\s*\(/i.test(sources)) return;
+        findings.push({
+          ...locate(style, rule.source?.start?.offset),
+          code: "font_face_local_only",
+          severity: "warning",
+          message: `@font-face '${family}' only names a font installed on this machine (src: local()). A local render uses the installed copy; a cloud render or another machine has none and falls back to a different font.`,
+          fixHint: "Add a url() source to the font file (.woff2) inside the project, or use a Google Fonts family, so every render draws the same glyphs."
+        });
+      });
+    }
+    return findings;
   }
 ];
 function uniqueFontLocation(styles, families, locate) {
@@ -6688,10 +6722,9 @@ function uniqueFontLocation(styles, families, locate) {
   const properties = collectFontCustomProperties(styles);
   for (const style of styles) {
     try {
-      postcss3.parse(style.content).walkDecls(/^font-family$/i, (decl) => {
-        if (isFontFaceDeclaration(decl)) return;
-        if (!resolveUsedFontNames(decl.value, properties).some((name) => families.includes(name)))
-          return;
+      postcss3.parse(style.content).walkDecls(FONT_FAMILY_PROPS, (decl) => {
+        const named = resolveUsedFontNames(usedFamilyList(decl), properties);
+        if (!named.some((name) => families.includes(name))) return;
         locations.push(locate(style, decl.source?.start?.offset));
       });
     } catch {

package/dist/index.js

@@ -6492,7 +6492,11 @@ var textureRules = [
 
 // src/rules/fonts.ts
 import postcss3 from "postcss";
-import { FONT_ALIAS_KEYS, resolveAliasDisplayName } from "@hyperframes/parsers/composition";
+import {
+  FONT_ALIAS_KEYS,
+  parseFontShorthand,
+  resolveAliasDisplayName
+} from "@hyperframes/parsers/composition";
 var GENERIC_FAMILIES = /* @__PURE__ */ new Set([
   "serif",
   "sans-serif",
@@ -6575,14 +6579,20 @@ function resolveUsedFontNames(value, properties, resolving = /* @__PURE__ */ new
     return resolveUsedFontNames(referenced, properties, new Set(resolving).add(property));
   });
 }
+function usedFamilyList(decl) {
+  if (isFontFaceDeclaration(decl)) return "";
+  if (decl.prop.toLowerCase() !== "font") return decl.value;
+  const shorthand = parseFontShorthand(decl.value);
+  return shorthand.certain ? shorthand.families : "";
+}
+var FONT_FAMILY_PROPS = /^font(?:-family)?$/i;
 function extractUsedFontFamilies(styles) {
   const used = [];
   const seen = /* @__PURE__ */ new Set();
   const properties = collectFontCustomProperties(styles);
   for (const style of styles) {
-    parseFontCss(style.content)?.walkDecls(/^font-family$/i, (decl) => {
-      if (isFontFaceDeclaration(decl)) return;
-      for (const name of resolveUsedFontNames(decl.value, properties)) {
+    parseFontCss(style.content)?.walkDecls(FONT_FAMILY_PROPS, (decl) => {
+      for (const name of resolveUsedFontNames(usedFamilyList(decl), properties)) {
         if (!GENERIC_FAMILIES.has(name) && !seen.has(name)) {
           seen.add(name);
           used.push(name);
@@ -6684,9 +6694,33 @@ var fontRules = [
       code: "font_family_without_font_face",
       severity: "error",
       message: `Font ${undeclared.length === 1 ? "family" : "families"} used without @font-face declaration: ${undeclared.join(", ")}. These are not in the auto-resolved font list, so the renderer cannot supply them automatically. Text will fall back to a generic font, producing incorrect typography in the video.`,
-      fixHint: "Add @font-face { font-family: '...'; src: url('capture/assets/fonts/...woff2'); } for each font family, pointing to the captured .woff2 files. For an OS-bundled system font (e.g. Hiragino Sans, Microsoft YaHei) that has no downloadable file, use src: local('Exact Font Name') instead. The declaration alone satisfies this check without needing a font file."
+      fixHint: "Add @font-face { font-family: '...'; src: url('capture/assets/fonts/...woff2'); } for each font family, pointing to the captured .woff2 files, or switch to a Google Fonts family. An OS font such as PingFang SC or Hiragino Sans renders locally from the installed copy, but a cloud render has no copy and refuses it."
     });
     return findings;
+  },
+  ({ styles, rawSource, options, locate }) => {
+    if (isRegistrySourceFile(options.filePath) || isRegistryInstalledFile(rawSource)) return [];
+    const findings = [];
+    for (const style of styles) {
+      parseFontCss(style.content)?.walkAtRules(/^font-face$/i, (rule) => {
+        let family = null;
+        let sources = "";
+        rule.walkDecls((decl) => {
+          const prop = decl.prop.toLowerCase();
+          if (prop === "font-family") family = normalizeUsedFontName(decl.value);
+          else if (prop === "src") sources += ` ${decl.value}`;
+        });
+        if (!family || !/\blocal\s*\(/i.test(sources) || /\burl\s*\(/i.test(sources)) return;
+        findings.push({
+          ...locate(style, rule.source?.start?.offset),
+          code: "font_face_local_only",
+          severity: "warning",
+          message: `@font-face '${family}' only names a font installed on this machine (src: local()). A local render uses the installed copy; a cloud render or another machine has none and falls back to a different font.`,
+          fixHint: "Add a url() source to the font file (.woff2) inside the project, or use a Google Fonts family, so every render draws the same glyphs."
+        });
+      });
+    }
+    return findings;
   }
 ];
 function uniqueFontLocation(styles, families, locate) {
@@ -6694,10 +6728,9 @@ function uniqueFontLocation(styles, families, locate) {
   const properties = collectFontCustomProperties(styles);
   for (const style of styles) {
     try {
-      postcss3.parse(style.content).walkDecls(/^font-family$/i, (decl) => {
-        if (isFontFaceDeclaration(decl)) return;
-        if (!resolveUsedFontNames(decl.value, properties).some((name) => families.includes(name)))
-          return;
+      postcss3.parse(style.content).walkDecls(FONT_FAMILY_PROPS, (decl) => {
+        const named = resolveUsedFontNames(usedFamilyList(decl), properties);
+        if (!named.some((name) => families.includes(name))) return;
         locations.push(locate(style, decl.source?.start?.offset));
       });
     } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/lint",
-  "version": "0.9.13",
+  "version": "0.9.15",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -35,7 +35,7 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "postcss-selector-parser": "^7.1.4",
-    "@hyperframes/parsers": "0.9.13"
+    "@hyperframes/parsers": "0.9.15"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",