@gakim-digital/dexter-bridge 0.11.24 → 0.12.0

package/src/googleFontsFallback.js

@@ -1,196 +0,0 @@
-// Framer's style-based font search ("font-search" with a `query`) is matched
-// by Framer's AI and billed to the workspace's AI credit; when that fails, the
-// run still needs typography candidates. Google Fonts publishes its full
-// catalog (category, weights, italics, variable axes, popularity) without a
-// key, and every Google Fonts family is in Framer's font library, so the
-// bridge answers those searches from it in Framer's own result shape.
-
-const GOOGLE_FONTS_METADATA_URL = 'https://fonts.google.com/metadata/fonts';
-const CATALOG_TTL_MS = 24 * 60 * 60_000;
-const CATALOG_TIMEOUT_MS = 20_000;
-const MAX_RESULTS = 20;
-
-const WEIGHT_DESCRIPTORS = {
-  thin: 100,
-  'extra-light': 200,
-  light: 300,
-  regular: 400,
-  medium: 500,
-  semibold: 600,
-  bold: 700,
-  'extra-bold': 800,
-  black: 900,
-};
-
-// Words in a style query that point at a category.
-const CATEGORY_WORDS = {
-  serif: 'serif',
-  serifs: 'serif',
-  sans: 'sans-serif',
-  'sans-serif': 'sans-serif',
-  grotesque: 'sans-serif',
-  grotesk: 'sans-serif',
-  geometric: 'sans-serif',
-  slab: 'slab',
-  mono: 'monospace',
-  monospace: 'monospace',
-  monospaced: 'monospace',
-  code: 'monospace',
-  script: 'handwriting',
-  handwriting: 'handwriting',
-  handwritten: 'handwriting',
-  calligraphy: 'handwriting',
-  display: 'display',
-  poster: 'display',
-};
-const NARROW_WORDS = new Set(['condensed', 'narrow', 'compressed']);
-
-let cachedCatalog = null;
-let cachedAt = 0;
-let pendingCatalog = null;
-
-export async function loadGoogleFontsCatalog(fetchImpl = fetch) {
-  if (cachedCatalog && Date.now() - cachedAt < CATALOG_TTL_MS) return cachedCatalog;
-  pendingCatalog ||= (async () => {
-    const response = await fetchImpl(GOOGLE_FONTS_METADATA_URL, {
-      signal: AbortSignal.timeout(CATALOG_TIMEOUT_MS),
-    });
-    if (!response.ok) throw new Error(`Google Fonts catalog returned HTTP ${response.status}.`);
-    const text = await response.text();
-    // The feed starts with an anti-JSON-hijacking prefix before the object.
-    const families = JSON.parse(text.slice(text.indexOf('{'))).familyMetadataList;
-    if (!Array.isArray(families) || families.length === 0) {
-      throw new Error('Google Fonts catalog is empty.');
-    }
-    cachedCatalog = families;
-    cachedAt = Date.now();
-    return families;
-  })().finally(() => {
-    pendingCatalog = null;
-  });
-  return pendingCatalog;
-}
-
-function categoryOf(family) {
-  if (family.category === 'Monospace') return 'monospace';
-  if (family.category === 'Handwriting') return 'handwriting';
-  if (family.category === 'Display') return 'display';
-  if (family.category === 'Serif') return 'serif';
-  return 'sans-serif';
-}
-
-function fontFacts(family) {
-  const keys = Object.keys(family.fonts || {});
-  const weights = [...new Set(keys.map((key) => Number.parseInt(key, 10)))]
-    .filter(Number.isFinite)
-    .sort((a, b) => a - b);
-  const styles = [
-    ...(keys.some((key) => !key.endsWith('i')) ? ['normal'] : []),
-    ...(keys.some((key) => key.endsWith('i')) ? ['italic'] : []),
-  ];
-  const axes = (family.axes || []).map((axis) => ({
-    tag: axis.tag,
-    minValue: axis.min,
-    maxValue: axis.max,
-    defaultValue: axis.defaultValue,
-  }));
-  return { weights, styles, axes };
-}
-
-function hasDescriptor(family, facts, descriptor) {
-  const classifications = family.classifications || [];
-  if (descriptor in WEIGHT_DESCRIPTORS) {
-    const weight = WEIGHT_DESCRIPTORS[descriptor];
-    const wght = facts.axes.find((axis) => axis.tag === 'wght');
-    return facts.weights.includes(weight)
-      || Boolean(wght && wght.minValue <= weight && wght.maxValue >= weight);
-  }
-  if (descriptor.startsWith('variation-axis/')) {
-    const tag = descriptor.slice('variation-axis/'.length);
-    return facts.axes.some((axis) => axis.tag === tag);
-  }
-  switch (descriptor) {
-    case 'serif':
-      return family.category === 'Serif' || family.stroke === 'Serif';
-    case 'sans-serif':
-      return family.category === 'Sans Serif' || family.stroke === 'Sans Serif';
-    case 'slab':
-      return family.stroke === 'Slab Serif';
-    case 'monospace':
-      return family.category === 'Monospace' || classifications.includes('Monospace');
-    case 'display':
-      return family.category === 'Display' || classifications.includes('Display');
-    case 'handwriting':
-      return family.category === 'Handwriting' || classifications.includes('Handwriting');
-    case 'normal':
-    case 'italic':
-      return facts.styles.includes(descriptor);
-    default:
-      // Descriptors the catalog cannot judge do not exclude a family.
-      return true;
-  }
-}
-
-function queryScore(family, facts, words) {
-  const nameWords = family.family.toLowerCase().split(/\s+/);
-  let score = 0;
-  for (const word of words) {
-    const category = CATEGORY_WORDS[word];
-    if (category && hasDescriptor(family, facts, category)) score += 2;
-    if (NARROW_WORDS.has(word)) {
-      const width = facts.axes.find((axis) => axis.tag === 'wdth');
-      if (nameWords.some((part) => NARROW_WORDS.has(part)) || (width && width.minValue < 100)) {
-        score += 2;
-      }
-    }
-    if (
-      !category
-      && word.length >= 4
-      && nameWords.some((part) => part.slice(0, 5) === word.slice(0, 5))
-    ) {
-      score += 3;
-    }
-  }
-  return score;
-}
-
-// Ranks catalog families for one font-search query: every `mustHave`
-// descriptor is required, query words raise matching families, and Google
-// Fonts popularity breaks ties. More candidates than `limit` are returned
-// because keyword matching is coarse; the model chooses by how they look.
-export function searchGoogleFonts(catalog, query = {}) {
-  const mustHave = (Array.isArray(query.mustHave) ? query.mustHave : [])
-    .map((descriptor) => String(descriptor).trim().toLowerCase())
-    .filter(Boolean);
-  const words = String(query.query || '')
-    .toLowerCase()
-    .split(/[^a-z0-9-]+/)
-    .filter(Boolean);
-  const limit = Math.min(
-    MAX_RESULTS,
-    Math.max(10, (Number.parseInt(query.limit, 10) || 5) * 2),
-  );
-  return catalog
-    .filter((family) =>
-      typeof family?.family === 'string'
-      && !family.isNoto
-      && !family.isBrandFont
-      && (family.subsets || []).includes('latin'))
-    .map((family) => ({ family, facts: fontFacts(family) }))
-    .filter(({ family, facts }) =>
-      facts.weights.length > 0
-      && mustHave.every((descriptor) => hasDescriptor(family, facts, descriptor)))
-    .map((entry) => ({ ...entry, score: queryScore(entry.family, entry.facts, words) }))
-    .sort((a, b) =>
-      b.score - a.score
-      || (a.family.popularity ?? Infinity) - (b.family.popularity ?? Infinity))
-    .slice(0, limit)
-    .map(({ family, facts }) => ({
-      name: family.family,
-      weights: facts.weights,
-      styles: facts.styles,
-      category: categoryOf(family),
-      variationAxes: facts.axes,
-      reason: 'Google Fonts catalog match',
-    }));
-}