fix(docs): pin the generator's sort locale to en-US

localeCompare with no locale argument uses the runtime default, which
varies with LANG and the ICU build. Against the real 254 catalog names,
tr-TR reorders 141 positions, et-EE 45, cs-CZ 2 and lt-LT diverges at
index 40 — so a contributor on any of those regenerates a different
integrations.json and fails CI with no obvious cause.

Pins en-US at all four sort sites. The committed artifacts are unchanged:
regenerating before and after leaves the tree byte-identical.

Adds a guard test asserting the committed catalog matches an explicit
en-US ordering, plus one that fails if an unpinned localeCompare returns.

Author: waleedlatif1

scripts/generate-docs.test.ts

@@ -697,3 +697,27 @@ describe('mapper param shapes', () => {
     expect(ids).not.toContain('ghostString')
   })
 })
+
+describe('the generated catalog ordering is locale-independent', () => {
+  /**
+   * `localeCompare` with no locale argument uses the runtime default, which varies with `LANG`
+   * and the ICU build. Against the real catalog names, `tr-TR` (dotted/dotless I), `lt-LT`,
+   * `cs-CZ` (the `ch` digraph) and `et-EE` each reorder the array, so a contributor on one of
+   * those locales would regenerate a different `integrations.json` and fail CI with no obvious
+   * cause. The generator pins `en-US`; this asserts the committed artifact matches that order.
+   */
+  it('sorts integrations.json the way an explicit en-US comparator would', () => {
+    const catalogPath = path.join(__dirname, '../packages/deployment-config/src/integrations.json')
+    const names = (
+      JSON.parse(fs.readFileSync(catalogPath, 'utf-8')).integrations as Array<{ name: string }>
+    ).map(({ name }) => name)
+
+    expect(names).toEqual([...names].sort((a, b) => a.localeCompare(b, 'en-US')))
+  })
+
+  it('leaves no unpinned localeCompare in the generator', () => {
+    const source = fs.readFileSync(path.join(__dirname, 'generate-docs.ts'), 'utf-8')
+
+    expect(source).not.toMatch(/localeCompare\(\s*[A-Za-z_$][\w$.]*\s*\)/)
+  })
+})

scripts/generate-docs.ts

@@ -652,7 +652,7 @@ function writeIconMapping(iconMapping: Record<string, IconRef>): void {
 
     // Generate mapping with direct references (no dynamic access for tree shaking)
     const mappingEntries = Object.entries(withAliases)
-      .sort(([a], [b]) => a.localeCompare(b))
+      .sort(([a], [b]) => a.localeCompare(b, 'en-US'))
       .map(([blockType, iconRef]) => `  ${formatIconMapKey(blockType)}: ${iconRef.name},`)
       .join('\n')
 
@@ -1433,7 +1433,7 @@ function writeIntegrationsIconMapping(iconMapping: Record<string, IconRef>): voi
 
     const imports = renderIconImports(Object.values(iconMapping))
     const mappingEntries = Object.entries(iconMapping)
-      .sort(([a], [b]) => a.localeCompare(b))
+      .sort(([a], [b]) => a.localeCompare(b, 'en-US'))
       .map(([blockType, iconRef]) => `  ${formatIconMapKey(blockType)}: ${iconRef.name},`)
       .join('\n')
 
@@ -1608,7 +1608,7 @@ async function writeIntegrationsJson(iconMapping: Record<string, IconRef>): Prom
       }
     }
 
-    integrations.sort((a, b) => a.name.localeCompare(b.name))
+    integrations.sort((a, b) => a.name.localeCompare(b.name, 'en-US'))
 
     const jsonPath = path.join(INTEGRATIONS_CATALOG_PATH, 'integrations.json')
     // `JSON.stringify` always expands every array across multiple lines, but Biome's
@@ -4322,7 +4322,7 @@ function groupTriggersByProvider(
     }
     groups.set(
       provider,
-      [...byName.values()].sort((a, b) => a.name.localeCompare(b.name))
+      [...byName.values()].sort((a, b) => a.name.localeCompare(b.name, 'en-US'))
     )
   }
   return groups