Add type stubs for generated modules

[jonathanKingston]

Asana Task/Github Issue:

Description

Testing Steps

Checklist

Please tick all that apply:

• I have tested this change locally
• I have tested this change locally in all supported browsers
• This change will be visible to users
• I have added automated tests that cover this change
• I have ensured the change is gated by config
• This change was covered by a ship review
• This change was covered by a tech design
• Any dependent config has been merged

---

Note

Low Risk
Adds TypeScript declaration stubs for build-generated modules and adjusts .gitignore to track only those .d.ts files; no runtime logic changes.

Overview
Adds TypeScript declaration stubs for build-generated artifacts (build/locales/*-locales.d.ts and injected/.../surrogates-generated.d.ts) so imports type-check without committing generated JS.

Updates .gitignore to ignore the build/ output while explicitly allowing build/locales/*.d.ts to be tracked.

^{Reviewed by Cursor Bugbot for commit a07a041. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

[Beta] Generated file diff

Time updated: Fri, 22 May 2026 10:13:38 GMT

New Files

    - locales/ctl-locales.d.ts

• locales/duckplayer-locales.d.ts

❌ File only exists in new changeset

Dismissing stale approval — new commits pushed, awaiting Cursor re-review.

[github-actions]

Build Branch

Branch	pr-releases/jkt/auto/bundler-generated-module-shims-f384
Commit	cbc0541a3c
Updated	May 22, 2026 at 10:12:56 AM UTC

Static preview entry points

• Docs: docs/index.html
• Static pages: build/integration/pages/index.html
• Integration pages: injected/integration-test/test-pages/index.html

QR codes (mobile preview)

Entry point	QR code
Docs
Static pages
Integration pages

Integration commands

npm (Android / Extension):

npm i github:duckduckgo/content-scope-scripts#pr-releases/jkt/auto/bundler-generated-module-shims-f384

Swift Package Manager (Apple):

.package(url: "https://github.com/duckduckgo/content-scope-scripts.git", branch: "pr-releases/jkt/auto/bundler-generated-module-shims-f384")

git submodule (Windows):

git -C submodules/content-scope-scripts fetch origin pr-releases/jkt/auto/bundler-generated-module-shims-f384
git -C submodules/content-scope-scripts checkout origin/pr-releases/jkt/auto/bundler-generated-module-shims-f384

Pin to exact commit

npm (Android / Extension):

npm i github:duckduckgo/content-scope-scripts#cbc0541a3c3c1e0fa04a86ad2c77e2de82d6388e

Swift Package Manager (Apple):

.package(url: "https://github.com/duckduckgo/content-scope-scripts.git", revision: "cbc0541a3c3c1e0fa04a86ad2c77e2de82d6388e")

git submodule (Windows):

git -C submodules/content-scope-scripts fetch origin pr-releases/jkt/auto/bundler-generated-module-shims-f384
git -C submodules/content-scope-scripts checkout cbc0541a3c3c1e0fa04a86ad2c77e2de82d6388e

[cursor]

Web Compatibility Assessment

No warning/error findings.

Info: .gitignore and the new declaration stubs in build/locales/*.d.ts and injected/src/features/tracker-protection/surrogates-generated.d.ts do not change injected runtime behavior, API wrapping, DOM interaction, platform entry points, or feature config gating.

Security Assessment

No warning/error/critical findings.

Info: The PR adds type-only module declarations and ignore-rule exceptions only. It does not introduce new global reads, messaging paths, origin handling, postMessage, network requests, iframe access, or changes to captured-globals.js, message-bridge, wrapper-utils.js, or DDGProxy.

Risk Level

Low Risk: type stubs and .gitignore changes only; the generated module shapes match the existing generators/import sites, and npm run tsc passes.

Recommendations

No blocking changes recommended. Keep the stubs synchronized with injected/scripts/buildLocales.js and injected/scripts/buildSurrogates.js if those generators change export shapes later.

  

_{Sent by Cursor Automation: Web compat and sec}

[github-actions]

⚠️ Cursor review was not successful.

This PR requires a manual review and approval from a member of one of the following teams:

• @duckduckgo/content-scope-scripts-owners
• @duckduckgo/apple-devs
• @duckduckgo/android-devs
• @duckduckgo/team-windows-development
• @duckduckgo/extension-owners
• @duckduckgo/config-aor
• @duckduckgo/breakage-aor
• @duckduckgo/breakage