@intlayer/engine 9.5.10 → 9.5.11

package/dist/esm/scan/analyzeBundleContent.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"analyzeBundleContent.mjs","names":[],"sources":["../../../src/scan/analyzeBundleContent.ts"],"sourcesContent":["import { ALL_LOCALES } from '@intlayer/types/allLocales';\nimport { byteLength, extractVisibleTextStrings } from './parseHtml';\nimport type {\n  BundleChunkInput,\n  BundleContentAnalysis,\n  ChunkAnalysis,\n} from './types';\n\n/**\n * Detect and measure localized (i18n) content embedded in JavaScript bundles.\n *\n * This is a dependency-free port of the hosted backend bundle analyzer: it\n * estimates how many translation strings ship in each chunk and, of those, how\n * many belong to locales other than the one currently rendered (i.e. dead\n * weight that a build-time optimization could strip).\n */\n\nconst allLocaleValues = new Set(Object.values(ALL_LOCALES) as string[]);\n\nconst isLocaleCode = (key: string): boolean =>\n  allLocaleValues.has(key) || /^[a-z]{2}(-[A-Z]{2,4})?$/.test(key);\n\n/** Find the end index of the value following a `locale:` key. */\nconst extractValueEnd = (text: string, valueStart: number): number => {\n  let cursor = valueStart;\n  while (cursor < text.length && ' \\t\\n\\r'.includes(text[cursor])) cursor++;\n  if (cursor >= text.length) return valueStart;\n\n  const char = text[cursor];\n  if (char === '{' || char === '[') {\n    const endChar = char === '{' ? '}' : ']';\n    let depth = 1;\n    cursor++;\n    while (cursor < text.length && depth > 0) {\n      if (text[cursor] === char) depth++;\n      else if (text[cursor] === endChar) depth--;\n      else if (text[cursor] === '\"' || text[cursor] === '`') {\n        const quote = text[cursor];\n        cursor++;\n        while (cursor < text.length) {\n          if (text[cursor] === '\\\\') {\n            cursor += 2;\n            continue;\n          }\n          if (text[cursor] === quote) break;\n          cursor++;\n        }\n      }\n      cursor++;\n    }\n    return cursor;\n  }\n  if (char === '\"' || char === '`') {\n    const quote = char;\n    cursor++;\n    while (cursor < text.length) {\n      if (text[cursor] === '\\\\') {\n        cursor += 2;\n        continue;\n      }\n      if (text[cursor] === quote) {\n        cursor++;\n        break;\n      }\n      cursor++;\n    }\n    return cursor;\n  }\n  const endMatch = text.slice(cursor).search(/[,}\\]\\s]/);\n  return endMatch === -1 ? text.length : cursor + endMatch;\n};\n\n// Matches both quoted (\"en\":) and unquoted (en:) locale keys followed by {\n// Works for any i18n solution — intlayer, i18next, vue-i18n, FormatJS, etc.\nconst LOCALE_KEY_PATTERN =\n  /(?:\"([a-z]{2}(?:-[A-Z]{2,4})?)\"|\\b([a-z]{2}(?:-[A-Z]{2,4})?)\\b)\\s*:\\s*(?=\\{)/g;\n\n// Maximum character gap between two locale key positions to consider them\n// part of the same i18n object. Large enough for big translation objects.\nconst LOCALE_CLUSTER_WINDOW = 10_000;\n\n// Returns false when a candidate value is clearly not i18n text:\n// - contains hex/control escape sequences (ANSI codes, binary data)\nconst looksLikeI18nContent = (valueText: string): boolean => {\n  if (/\\\\x[0-9a-fA-F]{2}/.test(valueText)) return false;\n  if (/\\\\u00[01][0-9a-fA-F]/.test(valueText)) return false;\n  return true;\n};\n\ntype LocaleMatch = {\n  locale: string;\n  position: number;\n  valueStart: number;\n  valueEnd: number;\n  valueSize: number;\n};\n\nconst analyzeChunkLocaleContent = (\n  text: string,\n  baseCurrent: string\n): {\n  unusedLocaleSize: number;\n  usedLocaleSize: number;\n  dictionariesFound: number;\n} => {\n  // Step 1: collect all candidate locale key matches\n  const candidates: LocaleMatch[] = [];\n  const regex = new RegExp(LOCALE_KEY_PATTERN.source, 'g');\n  let match = regex.exec(text);\n\n  while (match !== null) {\n    const locale = match[1] ?? match[2];\n    if (isLocaleCode(locale)) {\n      const valueStart = match.index + match[0].length;\n      const valueEnd = extractValueEnd(text, valueStart);\n      const valueSize = valueEnd - valueStart;\n      const valueText = text.slice(valueStart, valueEnd);\n      if (valueSize >= 5 && looksLikeI18nContent(valueText)) {\n        candidates.push({\n          locale,\n          position: match.index,\n          valueStart,\n          valueEnd,\n          valueSize,\n        });\n      }\n    }\n    match = regex.exec(text);\n  }\n\n  // Step 2: a locale key is i18n content only if another locale key with a\n  // DIFFERENT locale code exists within LOCALE_CLUSTER_WINDOW chars.\n  const isI18nMatch = (idx: number): boolean => {\n    const base = candidates[idx].locale.split('-')[0].toLowerCase();\n    for (let j = 0; j < candidates.length; j++) {\n      if (j === idx) continue;\n      const dist = Math.abs(candidates[j].position - candidates[idx].position);\n      if (dist > LOCALE_CLUSTER_WINDOW) continue;\n      if (candidates[j].locale.split('-')[0].toLowerCase() !== base)\n        return true;\n    }\n    return false;\n  };\n\n  let unusedLocaleSize = 0;\n  let usedLocaleSize = 0;\n  let dictionariesFound = 0;\n\n  for (let i = 0; i < candidates.length; i++) {\n    if (!isI18nMatch(i)) continue;\n\n    const { locale, valueSize } = candidates[i];\n    dictionariesFound++;\n\n    if (locale.split('-')[0].toLowerCase() === baseCurrent) {\n      usedLocaleSize += valueSize;\n    } else {\n      unusedLocaleSize += valueSize;\n    }\n  }\n\n  return { unusedLocaleSize, usedLocaleSize, dictionariesFound };\n};\n\n/**\n * Analyze the locale weight of a page's JavaScript bundles.\n *\n * @param chunks - The fetched JavaScript chunks (main + lazy).\n * @param htmlContent - The page HTML, used to estimate rendered content size.\n * @param currentLocale - The locale currently rendered by the page.\n * @param totalPageSize - The total transferred bytes measured for the page.\n * @returns The aggregated {@link BundleContentAnalysis}.\n */\nexport const analyzeBundleContent = (\n  chunks: BundleChunkInput[],\n  htmlContent: string,\n  currentLocale: string,\n  totalPageSize: number\n): BundleContentAnalysis => {\n  const empty: BundleContentAnalysis = {\n    currentLocale,\n    totalPageSize,\n    renderedContentSize: 0,\n    contentSize: 0,\n    totalLocaleSize: 0,\n    totalUnusedLocaleSize: 0,\n    unusedPercentOfLocale: 0,\n    mainBundleChunks: [],\n    lazyBundleChunks: [],\n  };\n\n  if (!chunks.length && !htmlContent) return empty;\n\n  // Rendered content size from HTML visible text (deduplicated).\n  const pageStrings = new Set(extractVisibleTextStrings(htmlContent));\n\n  let renderedContentSize = 0;\n  pageStrings.forEach((text) => {\n    renderedContentSize += byteLength(text);\n  });\n\n  const baseCurrent = currentLocale.split('-')[0].toLowerCase();\n\n  const mainBundleChunks: ChunkAnalysis[] = [];\n  const lazyBundleChunks: ChunkAnalysis[] = [];\n\n  for (const chunk of chunks) {\n    const { unusedLocaleSize, usedLocaleSize, dictionariesFound } =\n      analyzeChunkLocaleContent(chunk.content, baseCurrent);\n\n    const totalLocaleSize = unusedLocaleSize + usedLocaleSize;\n    const analysis: ChunkAnalysis = {\n      url: chunk.url,\n      fileSize: byteLength(chunk.content),\n      totalLocaleSize,\n      unusedLocaleSize,\n      usedLocaleSize,\n      dictionariesFound,\n      unusedPercent:\n        totalLocaleSize > 0\n          ? Math.round((unusedLocaleSize / totalLocaleSize) * 100)\n          : 0,\n    };\n\n    if (chunk.isMainBundle) {\n      mainBundleChunks.push(analysis);\n    } else if (dictionariesFound > 0) {\n      lazyBundleChunks.push(analysis);\n    }\n  }\n\n  const totalUnusedLocaleSize =\n    mainBundleChunks.reduce((sum, c) => sum + c.unusedLocaleSize, 0) +\n    lazyBundleChunks.reduce((sum, c) => sum + c.unusedLocaleSize, 0);\n  const totalLocaleSize =\n    mainBundleChunks.reduce((sum, c) => sum + c.totalLocaleSize, 0) +\n    lazyBundleChunks.reduce((sum, c) => sum + c.totalLocaleSize, 0);\n  const contentSize = renderedContentSize + totalLocaleSize;\n\n  const unusedPercentOfLocale =\n    totalLocaleSize > 0\n      ? Math.round((totalUnusedLocaleSize / totalLocaleSize) * 100)\n      : 0;\n\n  return {\n    currentLocale,\n    totalPageSize,\n    renderedContentSize,\n    contentSize,\n    totalLocaleSize,\n    totalUnusedLocaleSize,\n    unusedPercentOfLocale,\n    mainBundleChunks,\n    lazyBundleChunks,\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"analyzeBundleContent.mjs","names":[],"sources":["../../../src/scan/analyzeBundleContent.ts"],"sourcesContent":["import { ALL_LOCALES } from '@intlayer/types/allLocales';\nimport { byteLength, extractVisibleTextStrings } from './parseHtml';\nimport type {\n  BundleChunkInput,\n  BundleContentAnalysis,\n  ChunkAnalysis,\n} from './types';\n\n/**\n * Detect and measure localized (i18n) content embedded in JavaScript bundles.\n *\n * This is a dependency-free port of the hosted backend bundle analyzer: it\n * estimates how many translation strings ship in each chunk and, of those, how\n * many belong to locales other than the one currently rendered (i.e. dead\n * weight that a build-time optimization could strip).\n */\n\nconst allLocaleValues = new Set(Object.values(ALL_LOCALES) as string[]);\n\nconst isLocaleCode = (key: string): boolean =>\n  allLocaleValues.has(key) || /^[a-z]{2}(-[A-Z]{2,4})?$/.test(key);\n\n/** Find the end index of the value following a `locale:` key. */\nconst extractValueEnd = (text: string, valueStart: number): number => {\n  let cursor = valueStart;\n\n  while (cursor < text.length && ' \\t\\n\\r'.includes(text[cursor] ?? ''))\n    cursor++;\n\n  if (cursor >= text.length) return valueStart;\n\n  const char = text[cursor];\n\n  if (!char) return valueStart;\n\n  if (char === '{' || char === '[') {\n    const endChar = char === '{' ? '}' : ']';\n    let depth = 1;\n    cursor++;\n    while (cursor < text.length && depth > 0) {\n      const c = text[cursor];\n\n      if (c === char) depth++;\n      else if (c === endChar) depth--;\n      else if (c === '\"' || c === '`') {\n        const quote = c;\n        cursor++;\n        while (cursor < text.length) {\n          if (text[cursor] === '\\\\') {\n            cursor += 2;\n            continue;\n          }\n\n          if (text[cursor] === quote) break;\n          cursor++;\n        }\n      }\n      cursor++;\n    }\n    return cursor;\n  }\n\n  if (char === '\"' || char === '`') {\n    const quote = char;\n    cursor++;\n    while (cursor < text.length) {\n      if (text[cursor] === '\\\\') {\n        cursor += 2;\n        continue;\n      }\n\n      if (text[cursor] === quote) {\n        cursor++;\n        break;\n      }\n      cursor++;\n    }\n    return cursor;\n  }\n  const endMatch = text.slice(cursor).search(/[,}\\]\\s]/);\n  return endMatch === -1 ? text.length : cursor + endMatch;\n};\n\n// Matches both quoted (\"en\":) and unquoted (en:) locale keys followed by {\n// Works for any i18n solution — intlayer, i18next, vue-i18n, FormatJS, etc.\nconst LOCALE_KEY_PATTERN =\n  /(?:\"([a-z]{2}(?:-[A-Z]{2,4})?)\"|\\b([a-z]{2}(?:-[A-Z]{2,4})?)\\b)\\s*:\\s*(?=\\{)/g;\n\n// Maximum character gap between two locale key positions to consider them\n// part of the same i18n object. Large enough for big translation objects.\nconst LOCALE_CLUSTER_WINDOW = 10_000;\n\n// Returns false when a candidate value is clearly not i18n text:\n// - contains hex/control escape sequences (ANSI codes, binary data)\nconst looksLikeI18nContent = (valueText: string): boolean => {\n  if (/\\\\x[0-9a-fA-F]{2}/.test(valueText)) return false;\n\n  if (/\\\\u00[01][0-9a-fA-F]/.test(valueText)) return false;\n  return true;\n};\n\ntype LocaleMatch = {\n  locale: string;\n  position: number;\n  valueStart: number;\n  valueEnd: number;\n  valueSize: number;\n};\n\nconst analyzeChunkLocaleContent = (\n  text: string,\n  baseCurrent: string\n): {\n  unusedLocaleSize: number;\n  usedLocaleSize: number;\n  dictionariesFound: number;\n} => {\n  // Step 1: collect all candidate locale key matches\n  const candidates: LocaleMatch[] = [];\n  const regex = new RegExp(LOCALE_KEY_PATTERN.source, 'g');\n  let match = regex.exec(text);\n\n  while (match !== null) {\n    const locale = match[1] ?? match[2];\n\n    if (locale && isLocaleCode(locale)) {\n      const valueStart = match.index + match[0].length;\n      const valueEnd = extractValueEnd(text, valueStart);\n      const valueSize = valueEnd - valueStart;\n      const valueText = text.slice(valueStart, valueEnd);\n\n      if (valueSize >= 5 && looksLikeI18nContent(valueText)) {\n        candidates.push({\n          locale,\n          position: match.index,\n          valueStart,\n          valueEnd,\n          valueSize,\n        });\n      }\n    }\n    match = regex.exec(text);\n  }\n\n  // Step 2: a locale key is i18n content only if, within\n  // LOCALE_CLUSTER_WINDOW chars, another locale key with a DIFFERENT language\n  // exists AND the rendered locale is part of the cluster. The second rule\n  // discards minified object keys that happen to be locale codes (`id:{`,\n  // `as:{`, `to:{`…), which never come with the page locale next to them.\n  const languageOf = (candidate: LocaleMatch): string =>\n    (candidate.locale.split('-')[0] ?? '').toLowerCase();\n\n  const isI18nMatch = (idx: number): boolean => {\n    const currentCandidate = candidates[idx];\n\n    if (!currentCandidate) return false;\n    const base = languageOf(currentCandidate);\n    let hasOtherLanguage = false;\n    let hasCurrentLanguage = base === baseCurrent;\n    for (let j = 0; j < candidates.length; j++) {\n      if (j === idx) continue;\n      const neighbor = candidates[j];\n\n      if (!neighbor) continue;\n      const dist = Math.abs(neighbor.position - currentCandidate.position);\n\n      if (dist > LOCALE_CLUSTER_WINDOW) continue;\n      const neighborLanguage = languageOf(neighbor);\n\n      if (neighborLanguage !== base) hasOtherLanguage = true;\n\n      if (neighborLanguage === baseCurrent) hasCurrentLanguage = true;\n\n      if (hasOtherLanguage && hasCurrentLanguage) return true;\n    }\n    return false;\n  };\n\n  let unusedLocaleSize = 0;\n  let usedLocaleSize = 0;\n  let dictionariesFound = 0;\n\n  for (let i = 0; i < candidates.length; i++) {\n    if (!isI18nMatch(i)) continue;\n\n    const candidate = candidates[i];\n\n    if (!candidate) continue;\n    const { locale, valueSize } = candidate;\n    dictionariesFound++;\n\n    if ((locale.split('-')[0] ?? '').toLowerCase() === baseCurrent) {\n      usedLocaleSize += valueSize;\n    } else {\n      unusedLocaleSize += valueSize;\n    }\n  }\n\n  return { unusedLocaleSize, usedLocaleSize, dictionariesFound };\n};\n\n/**\n * Analyze the locale weight of a page's JavaScript bundles.\n *\n * @param chunks - The fetched JavaScript chunks (main + lazy).\n * @param htmlContent - The page HTML, used to estimate rendered content size.\n * @param currentLocale - The locale currently rendered by the page.\n * @param totalPageSize - The total transferred bytes measured for the page.\n * @returns The aggregated {@link BundleContentAnalysis}.\n */\nexport const analyzeBundleContent = (\n  chunks: BundleChunkInput[],\n  htmlContent: string,\n  currentLocale: string,\n  totalPageSize: number\n): BundleContentAnalysis => {\n  const empty: BundleContentAnalysis = {\n    currentLocale,\n    totalPageSize,\n    renderedContentSize: 0,\n    contentSize: 0,\n    totalLocaleSize: 0,\n    totalUnusedLocaleSize: 0,\n    unusedPercentOfLocale: 0,\n    mainBundleChunks: [],\n    lazyBundleChunks: [],\n  };\n\n  if (!chunks.length && !htmlContent) return empty;\n\n  // Rendered content size from HTML visible text (deduplicated).\n  const pageStrings = new Set(extractVisibleTextStrings(htmlContent));\n\n  let renderedContentSize = 0;\n  pageStrings.forEach((text) => {\n    renderedContentSize += byteLength(text);\n  });\n\n  const baseCurrent = (currentLocale.split('-')[0] ?? '').toLowerCase();\n\n  const mainBundleChunks: ChunkAnalysis[] = [];\n  const lazyBundleChunks: ChunkAnalysis[] = [];\n\n  for (const chunk of chunks) {\n    const { unusedLocaleSize, usedLocaleSize, dictionariesFound } =\n      analyzeChunkLocaleContent(chunk.content, baseCurrent);\n\n    const totalLocaleSize = unusedLocaleSize + usedLocaleSize;\n    const analysis: ChunkAnalysis = {\n      url: chunk.url,\n      fileSize: byteLength(chunk.content),\n      totalLocaleSize,\n      unusedLocaleSize,\n      usedLocaleSize,\n      dictionariesFound,\n      unusedPercent:\n        totalLocaleSize > 0\n          ? Math.round((unusedLocaleSize / totalLocaleSize) * 100)\n          : 0,\n    };\n\n    if (chunk.isMainBundle) {\n      mainBundleChunks.push(analysis);\n    } else if (dictionariesFound > 0) {\n      lazyBundleChunks.push(analysis);\n    }\n  }\n\n  const totalUnusedLocaleSize =\n    mainBundleChunks.reduce((sum, c) => sum + c.unusedLocaleSize, 0) +\n    lazyBundleChunks.reduce((sum, c) => sum + c.unusedLocaleSize, 0);\n  const totalLocaleSize =\n    mainBundleChunks.reduce((sum, c) => sum + c.totalLocaleSize, 0) +\n    lazyBundleChunks.reduce((sum, c) => sum + c.totalLocaleSize, 0);\n  const contentSize = renderedContentSize + totalLocaleSize;\n\n  const unusedPercentOfLocale =\n    totalLocaleSize > 0\n      ? Math.round((totalUnusedLocaleSize / totalLocaleSize) * 100)\n      : 0;\n\n  return {\n    currentLocale,\n    totalPageSize,\n    renderedContentSize,\n    contentSize,\n    totalLocaleSize,\n    totalUnusedLocaleSize,\n    unusedPercentOfLocale,\n    mainBundleChunks,\n    lazyBundleChunks,\n  };\n};\n"],"mappings":"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"}

package/dist/esm/scan/calculateScore.mjs

@@ -22,10 +22,13 @@ const scoreRecord = {
 	url_htmlDir: 3,
 	url_hasCanonical: 10,
 	url_hreflang: 9,
+	url_hreflangReciprocal: 8,
 	url_hasLocalizedLinks: 8,
 	url_hasXDefault: 7,
 	url_allAnchorsLocalized: 6,
-	url_currentLocale: 3,
+	url_hasLangSelector: 6,
+	url_currentLocale: 5,
+	url_ogLocale: 3,
 	url_unusedBundleContent: 8
 };
 /**

package/dist/esm/scan/calculateScore.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"calculateScore.mjs","names":[],"sources":["../../../src/scan/calculateScore.ts"],"sourcesContent":["/**\n * Mutualized SEO/i18n scoring logic.\n *\n * This module is the single source of truth for turning audit/scan events into\n * a weighted score. It is consumed both by the hosted backend SEO audit\n * (`apps/backend`) and by the `intlayer scan` CLI command, so it must stay free\n * of any server-only dependency (no Fastify, no Cheerio, no logger coupling).\n */\n\n/** Accumulated score across all checks that ran. */\nexport type Score = {\n  /** Sum of points obtained (success = full, warning = half, error = none). */\n  score: number;\n  /** Maximum achievable points for the checks that ran. */\n  totalScore: number;\n};\n\n/**\n * Minimal shape of an event needed to contribute to the score.\n *\n * The `type` is the check identifier. URL-scoped checks are suffixed with the\n * URL using a backslash separator (e.g. `url_htmlLang\\https://example.com`), so\n * only the part before the first backslash is used to look up the weight.\n */\nexport type ScorableEvent = {\n  type?: string;\n  status?: string;\n};\n\n/**\n * Resolve how many points an event contributes based on its status.\n * - `warning` → half of the weight\n * - `error` → none\n * - anything else (`success`, `started`, `done`, …) → full weight\n */\nconst scoreCheck = (score: number, event: ScorableEvent): number => {\n  if (event.status === 'warning') return score / 2;\n  if (event.status === 'error') return 0;\n  return score;\n};\n\n/** Weight (in points) of every scorable check. */\nexport const scoreRecord = {\n  robots_robotsPresent: 10,\n  robots_noLocalizedUrlsForgotten: 8,\n  sitemap_sitemapPresent: 10,\n  sitemap_noLocalizedUrlsForgotten: 9,\n  sitemap_hasAlternates: 8,\n  sitemap_hasXDefault: 7,\n  url_htmlLang: 9,\n  url_htmlDir: 3,\n  url_hasCanonical: 10,\n  url_hreflang: 9,\n  url_hasLocalizedLinks: 8,\n  url_hasXDefault: 7,\n  url_allAnchorsLocalized: 6,\n  url_currentLocale: 3,\n  url_unusedBundleContent: 8,\n} as const;\n\n/** Identifier of a scorable check (without the URL suffix). */\nexport type ScoreCheckType = keyof typeof scoreRecord;\n\n/**\n * Apply a single event to the running score, returning a new {@link Score}.\n * Unknown check types are ignored so the function is safe to call on every\n * emitted event.\n *\n * @param score - The current accumulated score.\n * @param event - The event to fold into the score.\n * @returns A new score with the event applied.\n */\nexport const mutateScore = (score: Score, event: ScorableEvent): Score => {\n  const newScore: Score = { ...score };\n\n  const typeWithoutUrl = event.type?.split('\\\\')[0];\n\n  if (!typeWithoutUrl) {\n    return newScore;\n  }\n\n  const scoreValue = scoreRecord[typeWithoutUrl as ScoreCheckType];\n\n  if (typeof scoreValue === 'number') {\n    newScore.score += scoreCheck(scoreValue, event);\n    newScore.totalScore += scoreValue;\n  }\n\n  return newScore;\n};\n\n/**\n * Convert a raw {@link Score} into a 0–100 percentage.\n *\n * @param score - The accumulated score.\n * @returns The rounded percentage, or 0 when no check ran.\n */\nexport const toScorePercent = (score: Score): number =>\n  Math.round(score.totalScore > 0 ? (score.score / score.totalScore) * 100 : 0);\n"],"mappings":";;;;;;;AAmCA,MAAM,cAAc,OAAe,UAAiC;CAClE,IAAI,MAAM,WAAW,WAAW,OAAO,QAAQ;CAC/C,IAAI,MAAM,WAAW,SAAS,OAAO;CACrC,OAAO;AACT;;AAGA,MAAa,cAAc;CACzB,sBAAsB;CACtB,iCAAiC;CACjC,wBAAwB;CACxB,kCAAkC;CAClC,uBAAuB;CACvB,qBAAqB;CACrB,cAAc;CACd,aAAa;CACb,kBAAkB;CAClB,cAAc;CACd,uBAAuB;CACvB,iBAAiB;CACjB,yBAAyB;CACzB,mBAAmB;CACnB,yBAAyB;AAC3B;;;;;;;;;;AAcA,MAAa,eAAe,OAAc,UAAgC;CACxE,MAAM,WAAkB,EAAE,GAAG,MAAM;CAEnC,MAAM,iBAAiB,MAAM,MAAM,MAAM,IAAI,CAAC,CAAC;CAE/C,IAAI,CAAC,gBACH,OAAO;CAGT,MAAM,aAAa,YAAY;CAE/B,IAAI,OAAO,eAAe,UAAU;EAClC,SAAS,SAAS,WAAW,YAAY,KAAK;EAC9C,SAAS,cAAc;CACzB;CAEA,OAAO;AACT;;;;;;;AAQA,MAAa,kBAAkB,UAC7B,KAAK,MAAM,MAAM,aAAa,IAAK,MAAM,QAAQ,MAAM,aAAc,MAAM,CAAC"}
+{"version":3,"file":"calculateScore.mjs","names":[],"sources":["../../../src/scan/calculateScore.ts"],"sourcesContent":["/**\n * Mutualized SEO/i18n scoring logic.\n *\n * This module is the single source of truth for turning audit/scan events into\n * a weighted score. It is consumed both by the hosted backend SEO audit\n * (`apps/backend`) and by the `intlayer scan` CLI command, so it must stay free\n * of any server-only dependency (no Fastify, no Cheerio, no logger coupling).\n */\n\n/** Accumulated score across all checks that ran. */\nexport type Score = {\n  /** Sum of points obtained (success = full, warning = half, error = none). */\n  score: number;\n  /** Maximum achievable points for the checks that ran. */\n  totalScore: number;\n};\n\n/**\n * Minimal shape of an event needed to contribute to the score.\n *\n * The `type` is the check identifier. URL-scoped checks are suffixed with the\n * URL using a backslash separator (e.g. `url_htmlLang\\https://example.com`), so\n * only the part before the first backslash is used to look up the weight.\n */\nexport type ScorableEvent = {\n  type?: string;\n  status?: string;\n};\n\n/**\n * Resolve how many points an event contributes based on its status.\n * - `warning` → half of the weight\n * - `error` → none\n * - anything else (`success`, `started`, `done`, …) → full weight\n */\nconst scoreCheck = (score: number, event: ScorableEvent): number => {\n  if (event.status === 'warning') return score / 2;\n  if (event.status === 'error') return 0;\n  return score;\n};\n\n/** Weight (in points) of every scorable check. */\nexport const scoreRecord = {\n  robots_robotsPresent: 10,\n  robots_noLocalizedUrlsForgotten: 8,\n  sitemap_sitemapPresent: 10,\n  sitemap_noLocalizedUrlsForgotten: 9,\n  sitemap_hasAlternates: 8,\n  sitemap_hasXDefault: 7,\n  url_htmlLang: 9,\n  url_htmlDir: 3,\n  url_hasCanonical: 10,\n  url_hreflang: 9,\n  url_hreflangReciprocal: 8,\n  url_hasLocalizedLinks: 8,\n  url_hasXDefault: 7,\n  url_allAnchorsLocalized: 6,\n  url_hasLangSelector: 6,\n  url_currentLocale: 5,\n  url_ogLocale: 3,\n  url_unusedBundleContent: 8,\n} as const;\n\n/** Identifier of a scorable check (without the URL suffix). */\nexport type ScoreCheckType = keyof typeof scoreRecord;\n\n/**\n * Apply a single event to the running score, returning a new {@link Score}.\n * Unknown check types are ignored so the function is safe to call on every\n * emitted event.\n *\n * @param score - The current accumulated score.\n * @param event - The event to fold into the score.\n * @returns A new score with the event applied.\n */\nexport const mutateScore = (score: Score, event: ScorableEvent): Score => {\n  const newScore: Score = { ...score };\n\n  const typeWithoutUrl = event.type?.split('\\\\')[0];\n\n  if (!typeWithoutUrl) {\n    return newScore;\n  }\n\n  const scoreValue = scoreRecord[typeWithoutUrl as ScoreCheckType];\n\n  if (typeof scoreValue === 'number') {\n    newScore.score += scoreCheck(scoreValue, event);\n    newScore.totalScore += scoreValue;\n  }\n\n  return newScore;\n};\n\n/**\n * Convert a raw {@link Score} into a 0–100 percentage.\n *\n * @param score - The accumulated score.\n * @returns The rounded percentage, or 0 when no check ran.\n */\nexport const toScorePercent = (score: Score): number =>\n  Math.round(score.totalScore > 0 ? (score.score / score.totalScore) * 100 : 0);\n"],"mappings":";;;;;;;AAmCA,MAAM,cAAc,OAAe,UAAiC;CAClE,IAAI,MAAM,WAAW,WAAW,OAAO,QAAQ;CAC/C,IAAI,MAAM,WAAW,SAAS,OAAO;CACrC,OAAO;AACT;;AAGA,MAAa,cAAc;CACzB,sBAAsB;CACtB,iCAAiC;CACjC,wBAAwB;CACxB,kCAAkC;CAClC,uBAAuB;CACvB,qBAAqB;CACrB,cAAc;CACd,aAAa;CACb,kBAAkB;CAClB,cAAc;CACd,wBAAwB;CACxB,uBAAuB;CACvB,iBAAiB;CACjB,yBAAyB;CACzB,qBAAqB;CACrB,mBAAmB;CACnB,cAAc;CACd,yBAAyB;AAC3B;;;;;;;;;;AAcA,MAAa,eAAe,OAAc,UAAgC;CACxE,MAAM,WAAkB,EAAE,GAAG,MAAM;CAEnC,MAAM,iBAAiB,MAAM,MAAM,MAAM,IAAI,CAAC,CAAC;CAE/C,IAAI,CAAC,gBACH,OAAO;CAGT,MAAM,aAAa,YAAY;CAE/B,IAAI,OAAO,eAAe,UAAU;EAClC,SAAS,SAAS,WAAW,YAAY,KAAK;EAC9C,SAAS,cAAc;CACzB;CAEA,OAAO;AACT;;;;;;;AAQA,MAAa,kBAAkB,UAC7B,KAAK,MAAM,MAAM,aAAa,IAAK,MAAM,QAAQ,MAAM,aAAc,MAAM,CAAC"}