scratch-l10n 6.1.133 → 6.1.135

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scratch-l10n",
-  "version": "6.1.133",
+  "version": "6.1.135",
   "description": "Localization for the Scratch 3.0 components",
   "main": "./dist/l10n.js",
   "browser": "./src/index.mjs",
@@ -81,7 +81,7 @@
     "jshint": "2.13.6",
     "json": "9.0.6",
     "jsonlint": "1.6.3",
-    "prettier": "3.9.9",
+    "prettier": "3.9.10",
     "rimraf": "2.7.1",
     "scratch-semantic-release-config": "4.0.1",
     "semantic-release": "25.0.9",

package/scripts/lib/errors.mts

@@ -11,6 +11,14 @@
  */
 export const messageOf = (err: unknown): string => (err instanceof Error ? err.message : String(err))
 
+/** Where a JSON parse error falls, as named by a shape-aware locator for {@link describeJsonParseError}. */
+export interface JsonEntryLocation {
+  /** Human-readable name of the entry, for the message (for example `key "123.description"`). */
+  label: string
+  /** The string key, when the locator could pin one, for linking straight to it. */
+  key?: string
+}
+
 /**
  * Describe where a `JSON.parse` failed, for a diagnostic message. V8 reports the byte offset (and, on
  * newer Node, the line and column) in the error message; combined with the original text this pins the
@@ -19,9 +27,18 @@ export const messageOf = (err: unknown): string => (err instanceof Error ? err.m
  * be read, so callers fall back to the plain message.
  * @param error - the caught value (expected to be a `SyntaxError` from `JSON.parse`)
  * @param text - the exact string that was parsed
- * @returns a one-line description (location, nearby key, snippet), or undefined
+ * @param locate - optional, for a caller that knows the file's shape: given the text before the error
+ *   position, name the entry it falls in (a `label` for the message, and the string `key` when known).
+ *   Used in place of the flat-file "near key" guess, which nested files with escaped quotes in their
+ *   values easily fool.
+ * @returns a one-line `message` (location, entry or nearby key, snippet) plus the located string `key`
+ *   if any, or undefined
  */
-export const describeJsonParseError = (error: unknown, text: string): string | undefined => {
+export const describeJsonParseError = (
+  error: unknown,
+  text: string,
+  locate?: (before: string) => JsonEntryLocation | undefined,
+): { message: string; key?: string } | undefined => {
   if (!(error instanceof SyntaxError) || typeof text !== 'string') {
     return undefined
   }
@@ -35,6 +52,15 @@ export const describeJsonParseError = (error: unknown, text: string): string | u
   }
   const lineColMatch = /\(line (\d+) column (\d+)\)/.exec(error.message)
   const where = lineColMatch ? `line ${lineColMatch[1]}, column ${lineColMatch[2]}` : `position ${pos}`
+  // A short, whitespace-collapsed window around the failure so the operator can eyeball the bad text.
+  const snippet = text
+    .slice(Math.max(0, pos - 30), pos + 30)
+    .replace(/\s+/g, ' ')
+    .trim()
+  const entry = locate?.(text.slice(0, pos))
+  if (entry) {
+    return { message: `malformed JSON in ${entry.label} (${where}): …${snippet}…`, key: entry.key }
+  }
   // Recover the enclosing key of a flat KEYVALUEJSON object: the value that failed to parse is
   // preceded by `"<key>":`, so scan back from the error position to that key. Heuristic (a colon or
   // quote inside an earlier string can fool it), so it is reported as "near key", not an exact locator.
@@ -50,11 +76,6 @@ export const describeJsonParseError = (error: unknown, text: string): string | u
       }
     }
   }
-  // A short, whitespace-collapsed window around the failure so the operator can eyeball the bad text.
-  const snippet = text
-    .slice(Math.max(0, pos - 30), pos + 30)
-    .replace(/\s+/g, ' ')
-    .trim()
   const keyPart = nearKey ? ` near key "${nearKey}"` : ''
-  return `malformed JSON at ${where}${keyPart}: …${snippet}…`
+  return { message: `malformed JSON at ${where}${keyPart}: …${snippet}…` }
 }

package/scripts/lib/help-utils.mts

@@ -5,7 +5,7 @@
 import { promises as fsPromises } from 'fs'
 import { mkdirp } from 'mkdirp'
 import { emitAnnotation } from './annotations.mts'
-import { describeJsonParseError, messageOf } from './errors.mts'
+import { describeJsonParseError, JsonEntryLocation, messageOf } from './errors.mts'
 import FreshdeskApi, {
   FreshdeskArticleCreate,
   FreshdeskArticleStatus,
@@ -28,6 +28,8 @@ import { emitWarning } from './warnings.mts'
 
 const FD = new FreshdeskApi('https://mitscratch.freshdesk.com', process.env.FRESHDESK_TOKEN ?? '')
 const TX_PROJECT = 'scratch-help'
+/** The Transifex resources that hold category and folder names; every other JSON resource holds articles. */
+const NAMES_RESOURCES = ['categoryNames_json', 'folderNames_json']
 
 // Collect per-item failures instead of aborting on the first one, so one bad translation or a single
 // item the token cannot write still lets every other item sync. Freshdesk rate limiting is handled
@@ -35,20 +37,31 @@ const TX_PROJECT = 'scratch-help'
 // here is a genuine problem worth a human's attention. `reportFailures` prints a consolidated summary
 // and fails the run at the end, so real errors are surfaced rather than lost in the log.
 const failures: { context: string; message: string; link?: string }[] = []
-const recordFailure = (context: string, error: unknown, link?: string): void => {
+const recordFailure = (
+  context: string,
+  error: unknown,
+  link?: string,
+  locate?: (before: string) => JsonEntryLocation | undefined,
+): void => {
   const message = messageOf(error)
   // A txPull error carries the failing (resource, locale) — and, for a parse failure, the raw text —
   // on its `cause`, so we can build a Transifex link and describe malformed JSON without the call site
-  // passing anything. An explicit link still wins: some callers know the fix lives on the source (`en`)
+  // passing anything. When the parse error can be pinned to one string, the link filters the editor to
+  // that string's key. An explicit link still wins: some callers know the fix lives on the source (`en`)
   // rather than the translation locale the pull used.
   const cause = txPullErrorCause(error)
+  const detail = cause?.buffer != null ? describeJsonParseError(error, cause.buffer, locate) : undefined
   const resolvedLink =
     link ??
     (cause
-      ? transifexEditorLink({ project: cause.project, resource: cause.resource, lang: cause.locale })
+      ? transifexEditorLink({
+          project: cause.project,
+          resource: cause.resource,
+          lang: cause.locale,
+          query: detail?.key && `key:${detail.key}`,
+        })
       : undefined)
-  const detail = cause?.buffer != null ? describeJsonParseError(error, cause.buffer) : undefined
-  const fullMessage = detail ? `${message} — ${detail}` : message
+  const fullMessage = detail ? `${message} — ${detail.message}` : message
   // Genuine failures go to stderr (like the consolidated summary), so they stand apart from normal output.
   process.stderr.write(`Error: ${context}: ${fullMessage}${resolvedLink ? ` (${resolvedLink})` : ''}\n`)
   failures.push({ context, message: fullMessage, link: resolvedLink })
@@ -345,13 +358,16 @@ export const getInputs = async () => {
   const resourcesPromise = txResourcesObjects(TX_PROJECT)
   const languagesPromise = txAvailableLanguages(TX_PROJECT)
 
-  // there are three types of resources differentiated by the file type
+  // Category and folder names live in two fixed KEYVALUEJSON resources; every other JSON resource holds a
+  // folder's articles. Classify by name rather than type: some article resources were created as
+  // KEYVALUEJSON by mistake, and they download in the same nested shape as the STRUCTURED_JSON ones.
+  const isNames = (resource: TransifexResourceObject) => NAMES_RESOURCES.includes(resource.attributes.slug)
+  const isJson = (resource: TransifexResourceObject) =>
+    resource.attributes.i18n_type === 'STRUCTURED_JSON' || resource.attributes.i18n_type === 'KEYVALUEJSON'
   const foldersPromise = resourcesPromise.then(resources =>
-    resources.filter(resource => resource.attributes.i18n_type === 'STRUCTURED_JSON'),
-  )
-  const namesPromise = resourcesPromise.then(resources =>
-    resources.filter(resource => resource.attributes.i18n_type === 'KEYVALUEJSON'),
+    resources.filter(resource => isJson(resource) && !isNames(resource)),
   )
+  const namesPromise = resourcesPromise.then(resources => resources.filter(isNames))
   // ignore the yaml type because it's not possible to update via API
 
   const [languages, folders, names] = await Promise.all([languagesPromise, foldersPromise, namesPromise])
@@ -383,6 +399,46 @@ export const getValidFreshdeskIds = async () => {
   return { validCategoryIds, validFolderIds }
 }
 
+/**
+ * Freshdesk folders whose article translations are deliberately not written to Freshdesk, even when they're
+ * translated in Transifex. Their articles are still pushed to Transifex as source.
+ *
+ * - 4000040867 "Legal Documents" (Terms of Service, Privacy Policy, and the like): we don't publish
+ *   translations of legal documents for now. This decision may be revisited.
+ */
+const UNSYNCED_FOLDER_IDS = new Set([4000040867])
+
+/**
+ * Keep only the article resources whose translations should be written to Freshdesk: the folder must still
+ * exist, and must not be in {@link UNSYNCED_FOLDER_IDS}. The push only updates resources for current
+ * folders, so a resource left behind by a deleted folder keeps its old English source forever. Its articles
+ * may have moved to another folder, so pulling it would overwrite their live translations with translations
+ * of outdated content. Each such resource is reported once so someone can remove it.
+ * @param folders - article resources from {@link getInputs}, named `<folder name>_<folder id>_json`
+ * @param validFolderIds - set of Freshdesk folder IDs that currently exist
+ * @returns the resources whose translations should sync to Freshdesk
+ */
+export const foldersToSync = (folders: TransifexResourceObject[], validFolderIds: Set<number>) =>
+  folders.filter(resource => {
+    const slug = resource.attributes.slug
+    const match = /_(\d+)_json$/.exec(slug)
+    if (match && UNSYNCED_FOLDER_IDS.has(Number(match[1]))) {
+      // Intentional, so log it rather than raising a warning on every run.
+      console.log(`Not syncing Transifex resource "${slug}": its translations are excluded from Freshdesk.`)
+      return false
+    }
+    if (match && validFolderIds.has(Number(match[1]))) {
+      return true
+    }
+    emitWarning(
+      match
+        ? `Skipping Transifex resource "${slug}": Freshdesk folder ${match[1]} no longer exists. Remove this resource from Transifex.`
+        : `Skipping Transifex resource "${slug}": its name doesn't end in a Freshdesk folder ID.`,
+      transifexEditorLink({ project: TX_PROJECT, resource: slug, lang: SOURCE_LOCALE }),
+    )
+    return false
+  })
+
 /**
  * internal function to serialize saving category and folder name translations to avoid Freshdesk rate limit
  * @param strings - the string data pulled from Transifex
@@ -414,7 +470,12 @@ const serializeNameSave = async (
           emitWarning(
             `Warning: key "${key}" in Transifex resource "${resource.attributes.name}" refers to Freshdesk id ${id} which no longer exists. Remove this key from the Transifex resource.`,
             // The key is removed from the source, so point at the source language, not a translation.
-            transifexEditorLink({ project: TX_PROJECT, resource: resource.attributes.slug, lang: SOURCE_LOCALE }),
+            transifexEditorLink({
+              project: TX_PROJECT,
+              resource: resource.attributes.slug,
+              lang: SOURCE_LOCALE,
+              query: `key:${key}`,
+            }),
           )
         }
         continue
@@ -441,7 +502,12 @@ const serializeNameSave = async (
       recordFailure(
         `${resource.attributes.name} entry "${key}" for ${locale}`,
         error,
-        transifexEditorLink({ project: TX_PROJECT, resource: resource.attributes.slug, lang: locale }),
+        transifexEditorLink({
+          project: TX_PROJECT,
+          resource: resource.attributes.slug,
+          lang: locale,
+          query: `key:${key}`,
+        }),
       )
       allOk = false
     }
@@ -459,6 +525,53 @@ interface FreshdeskFolderInTransifex {
   tags: { string: string }
 }
 
+/**
+ * Name the article (and field) that a position in a folder resource's raw JSON falls in, for a parse
+ * error. Matches only the structural `"<id>":{"title"…` and `"<field>":{"string":` openers, which don't
+ * occur inside the HTML values, so escaped or stray quotes in the content can't throw it off.
+ * @param before - the raw text up to the parse error position
+ * @returns the article's string key (e.g. `4000123456.description`) and a label for it, or undefined if no
+ *   article opener precedes the position
+ */
+const locateArticle = (before: string): JsonEntryLocation | undefined => {
+  const article = [...before.matchAll(/"(\d+)"\s*:\s*\{\s*"(?:title|description|tags)"/g)].pop()
+  if (article?.index == null) {
+    return undefined
+  }
+  const field = [
+    ...before.slice(article.index).matchAll(/[{,]\s*"(title|description|tags)"\s*:\s*\{\s*"string"\s*:/g),
+  ].pop()
+  if (!field) {
+    return { label: `article ${article[1]}` }
+  }
+  // The Transifex string key is `<id>.<field>`, which the editor shows and can filter to.
+  const key = `${article[1]}.${field[1]}`
+  return { label: `key "${key}"`, key }
+}
+
+/**
+ * Split a translated tags string into Freshdesk tags. The push joins each article's tags with ASCII commas,
+ * but translators often use their own language's comma, so also split on the Arabic (،), ideographic (、),
+ * and full-width (，) commas. Tags are trimmed, empty ones dropped, and duplicates that differ only in case
+ * removed, since Freshdesk rejects those.
+ * @param tags - the translated tags string
+ * @returns the tags to send to Freshdesk, in their original order
+ */
+export const splitTags = (tags: string): string[] => {
+  const seen = new Set<string>()
+  return tags
+    .split(/[,،、，]/)
+    .map(tag => tag.trim())
+    .filter(tag => {
+      const folded = tag.toLowerCase()
+      if (!tag || seen.has(folded)) {
+        return false
+      }
+      seen.add(folded)
+      return true
+    })
+}
+
 /**
  * Internal function serialize Freshdesk requests to avoid getting rate limited
  * @param  json   object with keys corresponding to article ids
@@ -482,7 +595,7 @@ const serializeFolderSave = async (
         status: FreshdeskArticleStatus.published,
       }
       if (Object.prototype.hasOwnProperty.call(value, 'tags')) {
-        const tags = value.tags.string.split(',')
+        const tags = splitTags(value.tags.string)
         // Freshdesk rejects tags longer than 32 characters, so drop them rather than fail the write.
         const validTags = tags.filter(tag => tag.length < 33)
         const droppedTags = tags.filter(tag => tag.length >= 33)
@@ -492,7 +605,12 @@ const serializeFolderSave = async (
               `(${locale}); shorten them in Transifex: ${droppedTags
                 .map(tag => `"${tag}" (${tag.length} chars)`)
                 .join(', ')}.`,
-            transifexEditorLink({ project: TX_PROJECT, resource: resourceSlug, lang: locale }),
+            transifexEditorLink({
+              project: TX_PROJECT,
+              resource: resourceSlug,
+              lang: locale,
+              query: `key:${id}.tags`,
+            }),
           )
         }
         body.tags = validTags
@@ -505,12 +623,19 @@ const serializeFolderSave = async (
       }
     } catch (error) {
       // Record the failure so the job still reports a non-zero exit at the end, then move on to the
-      // next article.
-      recordFailure(
-        `article ${idString} for ${locale}`,
-        error,
-        transifexEditorLink({ project: TX_PROJECT, resource: resourceSlug, lang: locale }),
-      )
+      // next article. Freshdesk won't accept an article translation until its folder's name is
+      // translated too, so for that error point at the folder's entry in the names resource (keyed by
+      // this resource's slug without `_json`) instead of the article. Otherwise filter the editor to
+      // the article's strings (a `key:<id>` search matches its title, description, and tags).
+      const link = /"field"\s*:\s*"folder_name"/.test(messageOf(error))
+        ? transifexEditorLink({
+            project: TX_PROJECT,
+            resource: 'folderNames_json',
+            lang: locale,
+            query: `key:${resourceSlug.replace(/_json$/, '')}`,
+          })
+        : transifexEditorLink({ project: TX_PROJECT, resource: resourceSlug, lang: locale, query: `key:${idString}` })
+      recordFailure(`article ${idString} for ${locale}`, error, link)
       allOk = false
     }
   }
@@ -533,7 +658,7 @@ export const localizeFolder = async (folderAttributes: TransifexResourceObject,
     )
     return await serializeFolderSave(data, locale, folderAttributes.attributes.slug)
   } catch (e) {
-    recordFailure(`${folderAttributes.attributes.slug} for ${locale}`, e)
+    recordFailure(`${folderAttributes.attributes.slug} for ${locale}`, e, undefined, locateArticle)
     return false
   }
 }
@@ -561,8 +686,8 @@ export const debugFolder = async (folderAttributes: TransifexResourceObject, loc
 }
 
 /**
- * Process KEYVALUEJSON resources from scratch-help on transifex
- * Category and Folder names are stored as plain json
+ * Process the category and folder names resources from scratch-help on transifex
+ * Category and Folder names are stored as plain json (KEYVALUEJSON)
  * @param resource Transifex resource json for either CategoryNames or FolderNames
  * @param locale   locale to pull and submit to Freshdesk
  * @param validCategoryIds - set of Freshdesk category IDs that currently exist

package/scripts/lib/transifex.mts

@@ -16,7 +16,8 @@ export const SOURCE_LOCALE = 'en'
 
 /**
  * Build a deep link to the Transifex online editor for a resource in one language, matching the URL
- * the web app uses: `app.transifex.com/<org>/<project>/translate/#<lang>/<resource>[/<stringId>]`.
+ * the web app uses: `app.transifex.com/<org>/<project>/translate/#<lang>/<resource>[/<stringId>]`, or
+ * `…/<resource>?q=<query>` to open the editor with a search applied.
  * @param params - link target
  * @param params.project - project slug (for example, `scratch-help`)
  * @param params.resource - resource slug (for example, `Accessibility_4000040849_json`)
@@ -24,6 +25,8 @@ export const SOURCE_LOCALE = 'en'
  *   translation locale for a bad translation
  * @param params.stringId - optional Transifex numeric string id to focus a single string; omitted, the
  *   link lands on the resource (with its first string shown)
+ * @param params.query - optional editor search, as typed into its search box (for example,
+ *   `key:4000156778.description` to filter to one string by its key); takes precedence over `stringId`
  * @returns the editor URL
  */
 export const transifexEditorLink = (params: {
@@ -31,9 +34,15 @@ export const transifexEditorLink = (params: {
   resource: string
   lang: string
   stringId?: string | number
+  query?: string
 }): string => {
-  const { project, resource, lang, stringId } = params
+  const { project, resource, lang, stringId, query } = params
   const base = `https://app.transifex.com/${ORG_NAME}/${project}/translate/#${lang}/${resource}`
+  if (query != null) {
+    // No slash before `?q=`. The editor rewrites its address bar to `<resource>/?q=…`, but that form
+    // lands on the project overview (query ignored) when opened fresh.
+    return `${base}?q=${encodeURIComponent(query)}`
+  }
   return stringId == null ? base : `${base}/${stringId}`
 }
 

package/scripts/tx-pull-help-articles.mts

@@ -5,6 +5,8 @@
  */
 import {
   getInputs,
+  getValidFreshdeskIds,
+  foldersToSync,
   saveItem,
   localizeFolder,
   initChangeDetection,
@@ -29,7 +31,11 @@ if (!process.env.TX_TOKEN || !process.env.FRESHDESK_TOKEN || args.length > 0) {
 }
 
 await initChangeDetection()
-const { languages, folders } = await getInputs()
+const [{ languages, folders: allFolders }, { validFolderIds }] = await Promise.all([
+  getInputs(),
+  getValidFreshdeskIds(),
+])
+const folders = foldersToSync(allFolders, validFolderIds)
 reportSkippedLocales(languages)
 console.log('Processing articles pulled from Transifex')
 await Promise.all(folders.map(item => saveItem(item, languages, localizeFolder)))

package/scripts/tx-pull-locale-articles.mts

@@ -3,7 +3,14 @@
  * @file
  * Script to pull scratch-help translations from transifex and push to FreshDesk.
  */
-import { getInputs, saveItem, localizeFolder, debugFolder } from './lib/help-utils.mts'
+import {
+  getInputs,
+  getValidFreshdeskIds,
+  foldersToSync,
+  saveItem,
+  localizeFolder,
+  debugFolder,
+} from './lib/help-utils.mts'
 
 const args = process.argv.slice(2)
 const usage = `
@@ -29,6 +36,7 @@ if (locale === '-d') {
 }
 const saveFn = debug ? debugFolder : localizeFolder
 
-const { folders } = await getInputs()
+const [{ folders: allFolders }, { validFolderIds }] = await Promise.all([getInputs(), getValidFreshdeskIds()])
+const folders = foldersToSync(allFolders, validFolderIds)
 console.log('Processing articles pulled from Transifex')
 await Promise.all(folders.map(item => saveItem(item, [locale], saveFn)))

package/www/scratch-website.cookies-l10njson/ab.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Used to save the user’s current search preference.",
     "cookies.functional.scratchLanguage": "Used to save information about the user’s preferred language.",
     "cookies.functional.scratchTheme": "Used to save information about the user’s preferred color mode.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Used to track if the user has seen a privacy policy update notification",
     "cookies.functional.wistia": "Contains a timestamp for the Scratch Website’s video-content. This allows the user to resume watching without having to start over, if the user leaves the video or Scratch Website.",
     "cookies.functional.minilogSettings": "Unclassified",

package/www/scratch-website.cookies-l10njson/af.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Used to save the user’s current search preference.",
     "cookies.functional.scratchLanguage": "Used to save information about the user’s preferred language.",
     "cookies.functional.scratchTheme": "Used to save information about the user’s preferred color mode.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Used to track if the user has seen a privacy policy update notification",
     "cookies.functional.wistia": "Contains a timestamp for the Scratch Website’s video-content. This allows the user to resume watching without having to start over, if the user leaves the video or Scratch Website.",
     "cookies.functional.minilogSettings": "Unclassified",

package/www/scratch-website.cookies-l10njson/am.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Used to save the user’s current search preference.",
     "cookies.functional.scratchLanguage": "Used to save information about the user’s preferred language.",
     "cookies.functional.scratchTheme": "Used to save information about the user’s preferred color mode.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Used to track if the user has seen a privacy policy update notification",
     "cookies.functional.wistia": "Contains a timestamp for the Scratch Website’s video-content. This allows the user to resume watching without having to start over, if the user leaves the video or Scratch Website.",
     "cookies.functional.minilogSettings": "Unclassified",

package/www/scratch-website.cookies-l10njson/an.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Used to save the user’s current search preference.",
     "cookies.functional.scratchLanguage": "Used to save information about the user’s preferred language.",
     "cookies.functional.scratchTheme": "Used to save information about the user’s preferred color mode.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Used to track if the user has seen a privacy policy update notification",
     "cookies.functional.wistia": "Contains a timestamp for the Scratch Website’s video-content. This allows the user to resume watching without having to start over, if the user leaves the video or Scratch Website.",
     "cookies.functional.minilogSettings": "Unclassified",

package/www/scratch-website.cookies-l10njson/ar.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "تُستخدم لحفظ تفضيلات البحث الحالية للمستخدم.",
     "cookies.functional.scratchLanguage": "تُستخدم لحفظ معلومات حول اللغة المفضلة للمستخدم.",
     "cookies.functional.scratchTheme": "يُستخدم لحفظ معلومات حول وضع الألوان المفضل للمستخدم.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "يُستخدم لتتبع ما إذا كان المستخدم قد شاهد إشعار تحديث سياسة الخصوصية",
     "cookies.functional.wistia": "يحتوي على طابع زمني لمحتوى الفيديو الخاص بموقع Scratch. يتيح ذلك للمستخدم استئناف المشاهدة دون الحاجة إلى البدء من جديد، إذا غادر المستخدم الفيديو أو موقع Scratch.",
     "cookies.functional.minilogSettings": "غير مصنف",

package/www/scratch-website.cookies-l10njson/ast.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Used to save the user’s current search preference.",
     "cookies.functional.scratchLanguage": "Used to save information about the user’s preferred language.",
     "cookies.functional.scratchTheme": "Used to save information about the user’s preferred color mode.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Used to track if the user has seen a privacy policy update notification",
     "cookies.functional.wistia": "Contains a timestamp for the Scratch Website’s video-content. This allows the user to resume watching without having to start over, if the user leaves the video or Scratch Website.",
     "cookies.functional.minilogSettings": "Unclassified",

package/www/scratch-website.cookies-l10njson/az.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Used to save the user’s current search preference.",
     "cookies.functional.scratchLanguage": "Used to save information about the user’s preferred language.",
     "cookies.functional.scratchTheme": "Used to save information about the user’s preferred color mode.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Used to track if the user has seen a privacy policy update notification",
     "cookies.functional.wistia": "Contains a timestamp for the Scratch Website’s video-content. This allows the user to resume watching without having to start over, if the user leaves the video or Scratch Website.",
     "cookies.functional.minilogSettings": "Unclassified",

package/www/scratch-website.cookies-l10njson/be.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Выкарыстоўваецца для захавання бягучых параметраў пошуку карыстальніка.",
     "cookies.functional.scratchLanguage": "Выкарыстоўваецца для захавання інфармацыі аб мове, якую карыстальнік аддае перавагу.",
     "cookies.functional.scratchTheme": "Выкарыстоўваецца для захавання інфармацыі аб абраным каляровым рэжыме карыстальніка.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Выкарыстоўваецца для адсочвання таго, ці бачыў карыстальнік апавяшчэнне аб абнаўленні палітыкі прыватнасці",
     "cookies.functional.wistia": "Змяшчае пазнаку часу для відэакантэнту сайта Scratch. Гэта дазваляе карыстальніку аднавіць прагляд без неабходнасці пачынаць спачатку, калі карыстальнік пакідае відэа ці вэб-сайт Scratch.",
     "cookies.functional.minilogSettings": "Некласіфікаваны",

package/www/scratch-website.cookies-l10njson/bg.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Used to save the user’s current search preference.",
     "cookies.functional.scratchLanguage": "Used to save information about the user’s preferred language.",
     "cookies.functional.scratchTheme": "Used to save information about the user’s preferred color mode.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Used to track if the user has seen a privacy policy update notification",
     "cookies.functional.wistia": "Contains a timestamp for the Scratch Website’s video-content. This allows the user to resume watching without having to start over, if the user leaves the video or Scratch Website.",
     "cookies.functional.minilogSettings": "Unclassified",

package/www/scratch-website.cookies-l10njson/bn.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "ব্যবহারকারীর বর্তমান সার্চ পছন্দ সংরক্ষণ করতে ব্যবহৃত হয়।",
     "cookies.functional.scratchLanguage": "ব্যবহারকারীর পছন্দের ভাষা সম্পর্কে তথ্য সংরক্ষণ করতে ব্যবহৃত হয়।",
     "cookies.functional.scratchTheme": "ব্যবহারকারীর পছন্দের রঙের মোড সম্পর্কে তথ্য সংরক্ষণ করতে ব্যবহৃত হয়।",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "ব্যবহারকারী একটি প্রাইভেসি নীতি আপডেট নোটিফিকেশন দেখেছে কিনা তা ট্র্যাক করতে ব্যবহৃত হয়",
     "cookies.functional.wistia": "Scratch ওয়েবসাইটের ভিডিও-বিষয়বস্তুর জন্য একটি টাইমস্ট্যাম্প ধারণ করে। এটি ব্যবহারকারীকে ভিডিও বা Scratch ওয়েবসাইট ছেড়ে গেলে আবার প্রথম থেকে শুরু না করে দেখা চালিয়ে যেতে দেয়।",
     "cookies.functional.minilogSettings": "শ্রেণীবিভক্ত করা হয়নি এমন",

package/www/scratch-website.cookies-l10njson/ca.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Used to save the user’s current search preference.",
     "cookies.functional.scratchLanguage": "Used to save information about the user’s preferred language.",
     "cookies.functional.scratchTheme": "Used to save information about the user’s preferred color mode.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Used to track if the user has seen a privacy policy update notification",
     "cookies.functional.wistia": "Contains a timestamp for the Scratch Website’s video-content. This allows the user to resume watching without having to start over, if the user leaves the video or Scratch Website.",
     "cookies.functional.minilogSettings": "Unclassified",

package/www/scratch-website.cookies-l10njson/ckb.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Used to save the user’s current search preference.",
     "cookies.functional.scratchLanguage": "Used to save information about the user’s preferred language.",
     "cookies.functional.scratchTheme": "Used to save information about the user’s preferred color mode.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Used to track if the user has seen a privacy policy update notification",
     "cookies.functional.wistia": "Contains a timestamp for the Scratch Website’s video-content. This allows the user to resume watching without having to start over, if the user leaves the video or Scratch Website.",
     "cookies.functional.minilogSettings": "Unclassified",

package/www/scratch-website.cookies-l10njson/cs.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Slouží k uložení uživatelových aktuálních vyhledávacích preferencí.",
     "cookies.functional.scratchLanguage": "Slouží k ukládání informací o preferovaném jazyce uživatele.",
     "cookies.functional.scratchTheme": "Slouží k uložení informací o uživatelem preferovaném barevném režimu.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Používá se ke sledování, zda se uživateli zobrazilo oznámení o aktualizaci zásad ochrany osobních údajů",
     "cookies.functional.wistia": "Obsahuje časové razítko pro videoobsah webových stránek Scratch. To umožňuje uživateli pokračovat ve sledování, aniž by musel začínat znovu, pokud uživatel opustí video nebo Scratch web.",
     "cookies.functional.minilogSettings": "Neklasifikováno",

package/www/scratch-website.cookies-l10njson/cy.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Fe'i defnyddir i gadw dewis chwilio cyfredol y defnyddiwr.",
     "cookies.functional.scratchLanguage": "Fe'i defnyddir i gadw gwybodaeth am ddewis iaith y defnyddiwr.",
     "cookies.functional.scratchTheme": "Mae'n cael ei ddefnyddio i gadw gwybodaeth am ddewis iaith y defnyddiwr.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Fe'i defnyddir i olrhain a yw'r defnyddiwr wedi gweld hysbysiad diweddaru polisi preifatrwydd",
     "cookies.functional.wistia": "Yn cynnwys stamp amser ar gyfer cynnwys fideo Gwefan Scratch. Mae hyn yn caniatáu i'r defnyddiwr ailddechrau gwylio heb orfod dechrau drosodd, os yw'r defnyddiwr yn gadael y fideo neu Scratch Gwefan.",
     "cookies.functional.minilogSettings": "Annosbarthedig",

package/www/scratch-website.cookies-l10njson/da.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Used to save the user’s current search preference.",
     "cookies.functional.scratchLanguage": "Used to save information about the user’s preferred language.",
     "cookies.functional.scratchTheme": "Used to save information about the user’s preferred color mode.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Used to track if the user has seen a privacy policy update notification",
     "cookies.functional.wistia": "Contains a timestamp for the Scratch Website’s video-content. This allows the user to resume watching without having to start over, if the user leaves the video or Scratch Website.",
     "cookies.functional.minilogSettings": "Unclassified",

package/www/scratch-website.cookies-l10njson/de.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Wird verwendet, um die aktuellen Sucheinstellungen des Benutzers zu speichern.",
     "cookies.functional.scratchLanguage": "Wird verwendet, um Informationen über die bevorzugte Sprache des Benutzers zu speichern.",
     "cookies.functional.scratchTheme": "Wird zum Speichern von Informationen über den bevorzugten Farbmodus des Benutzers verwendet.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Wird verwendet, um zu verfolgen, ob der Benutzer eine Benachrichtigung über eine Aktualisierung der Datenschutzrichtlinie gesehen hat",
     "cookies.functional.wistia": "Enthält einen Zeitstempel für den Videoinhalt der Scratch-Website. Dadurch kann der Benutzer die Wiedergabe fortsetzen, ohne von vorne beginnen zu müssen, wenn er das Video oder die Scratch-Website verlässt.",
     "cookies.functional.minilogSettings": "Nicht klassifiziert",

package/www/scratch-website.cookies-l10njson/el.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Used to save the user’s current search preference.",
     "cookies.functional.scratchLanguage": "Used to save information about the user’s preferred language.",
     "cookies.functional.scratchTheme": "Used to save information about the user’s preferred color mode.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Used to track if the user has seen a privacy policy update notification",
     "cookies.functional.wistia": "Contains a timestamp for the Scratch Website’s video-content. This allows the user to resume watching without having to start over, if the user leaves the video or Scratch Website.",
     "cookies.functional.minilogSettings": "Unclassified",

package/www/scratch-website.cookies-l10njson/en.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Used to save the user’s current search preference.",
     "cookies.functional.scratchLanguage": "Used to save information about the user’s preferred language.",
     "cookies.functional.scratchTheme": "Used to save information about the user’s preferred color mode.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Used to track if the user has seen a privacy policy update notification",
     "cookies.functional.wistia": "Contains a timestamp for the Scratch Website’s video-content. This allows the user to resume watching without having to start over, if the user leaves the video or Scratch Website.",
     "cookies.functional.minilogSettings": "Unclassified",

package/www/scratch-website.cookies-l10njson/eo.json

@@ -30,6 +30,7 @@
     "cookies.functional.exploreBy": "Used to save the user’s current search preference.",
     "cookies.functional.scratchLanguage": "Used to save information about the user’s preferred language.",
     "cookies.functional.scratchTheme": "Used to save information about the user’s preferred color mode.",
+    "cookies.functional.donateBannerAb": "Used to remember which homepage donate banner to show while we compare banner versions.",
     "cookies.functional.scratchPolicySeen": "Used to track if the user has seen a privacy policy update notification",
     "cookies.functional.wistia": "Contains a timestamp for the Scratch Website’s video-content. This allows the user to resume watching without having to start over, if the user leaves the video or Scratch Website.",
     "cookies.functional.minilogSettings": "Unclassified",