=0;--t){var r=this.tryEntries[t];if(r.finallyLoc===e)return this.complete(r.completion,r.afterLoc),k(r),l}},catch:function(e){for(var t=this.tryEntries.length-1;t>=0;--t){var r=this.tryEntries[t];if(r.tryLoc===e){var n=r.completion;if("throw"===n.type){var o=n.arg;k(r)}return o}}throw new Error("illegal catch attempt")},delegateYield:function(e,t,r){return this.delegate={iterator:L(e),resultName:t,nextLoc:r},"next"===this.method&&(this.arg=void 0),l}},e}(e.exports);try{regeneratorRuntime=t}catch(e){Function("r","regeneratorRuntime = r")(t)}}));function f(e){return e.replace(//g,">")}var p=function(e,r,n){var o="undefined"!=typeof self&&void 0!==self.WorkerGlobalScope||"undefined"!=typeof window&&void 0!==window.document&&"undefined"!=typeof fetch,i="undefined"!=typeof jest,a=o||i?function(e){}:console.error,s=""+n+"
";"object"!=typeof n?(s=String(n),a("### Unexpected error:"),a(n)):n instanceof t.TwoslashError?(s=function(e){return"\n"+f(e.title)+"
\n"+f(e.description).replace(/(?:\r\n|\r|\n)/g,"
")+"
\n"+f(e.recommendation).replace(/(?:\r\n|\r|\n)/g,"
")+"\n"}(n),a("### Twoslash error: "+n.title),a(n.description),a(n.recommendation),a("\n### Code Sample"),a(e)):n instanceof Error&&(s=function(e){return""+e.message.split("## Code")[0]+"
"}(n),a("### Unexpected error:"),a(n));var c="\n Twoslash failure
\n "+s+"
Raising Code:
"+f(e)+"
'+c+"
",r.children=[]},h=new Map;function d(e,t,r,n,o){var a,s={json5:"json"};if(s[t.lang]&&(t.lang=s[t.lang]),"twoslash"===t.lang){if(!t.meta.include||"string"!=typeof t.meta.include)throw new Error("A twoslash code block needs a pragma like 'twoslash include [name]'");!function(e,t,r){var n=[];r.split("\n").forEach((function(r,o){var i=r.trim();if(i.startsWith("// - ")){var a=i.split("// - ")[1].split(" ")[0];e.set(t+"-"+a,n.join("\n"))}else n.push(r)})),e.set(t,n.join("\n"))}(h,t.meta.include,e),a=o.wrapFragments?'':""}else a=r.map((function(r){var a=r.customName.split("/").pop().replace(".json","");return i.renderCodeToHTML(e,t.lang,t.meta,c({themeName:a},o),r,n)})).join("\n"),r.length>1&&o.wrapFragments&&(a=''+a+"
");return a}var v=function(e,t,r){var n=t.lang;if(void 0===r&&(r={}),("undefined"==typeof process||!process.env||!process.env.TWOSLASH_DISABLE)&&t.meta.twoslash)return function(e,t,r){if("undefined"!=typeof self&&void 0!==self.WorkerGlobalScope||"undefined"!=typeof window&&void 0!==window.document&&"undefined"!=typeof fetch)return i.runTwoSlash(e,t,r);return require("./twoslash-cache.js")(e, t, r, i.runTwoSlash);
++}(function(e,t){for(var r,n=/\/\/ @include: (.*)$/gm,o=[];null!==(r=n.exec(t));){r.index===n.lastIndex&&n.lastIndex++;var i=r[1],a=e.get(i);if(!a){var s="Could not find an include with the key: '"+i+"'.\nThere is: "+Array.from(e.keys())+".";throw new Error(s)}o.push([r.index,r[0].length,a])}var c=t.toString();return o.reverse().forEach((function(e){c=c.substring(0,e[0])+e[2]+c.substring(e[0]+e[1])})),c}(h,e),n,r)},m=new Map,g=function(e){return Promise.all((e.themes||(e.theme?[e.theme]:["light-plus"])).map(function(){var t=s(l.mark((function t(r){var n,i;return l.wrap((function(t){for(;;)switch(t.prev=t.next){case 0:return n=r.name||r,t.next=3,o.getHighlighter(c({},e,{theme:r,themes:void 0}));case 3:return(i=t.sent).customName=n,t.abrupt("return",i);case 6:case"end":return t.stop()}}),t)})));return function(e){return t.apply(this,arguments)}}()))},y=function(){return h.clear()},w=function(e){var t,r=n.lex(e),o=r[0],i=r.slice(1);if("twoslash"===o){var a=i.indexOf("include");-1!==a&&i.splice(a+1,0,"=")}var s=null!=(t=n.parse(i))?t:{};return{lang:(o||"").toString(),meta:s}},x=function(e,r){return void 0===r&&(r={}),function(n){var o=n.value,i=void 0;try{i=w([n.lang,n.meta].filter(Boolean).join(" "))}catch(e){var a=new t.TwoslashError("Codefence error","Could not parse the codefence for this code sample","It's usually an unclosed string",o);return p(o,n,a)}if(!(Object.keys(i.meta).filter((function(e){return(r.ignoreCodeblocksWithCodefenceMeta||[]).includes(e)})).length>0)){var s;try{s=n.twoslash||v(o,i,r)}catch(e){var c=process&&process.env&&!!process.env.CI,u="undefined"==typeof jest;if(c&&u||r.alwayRaiseForTwoslashExceptions)throw e;return p(o,n,e)}s&&(n.value=s.code,n.lang=s.extension,n.twoslash=s);var l=d(n.value,i,e,s,r);n.type="html",n.value=l,n.children=[]}}},b=function(){var e=s(l.mark((function e(t){return l.wrap((function(e){for(;;)switch(e.prev=e.next){case 0:return void 0===t&&(t={}),y(),m.has(t)||m.set(t,g(t)),e.next=5,m.get(t);case 5:return e.abrupt("return",{settings:t,highlighters:e.sent});case 7:case"end":return e.stop()}}),e)})));return function(t){return e.apply(this,arguments)}}();exports.default=function(e){return void 0===e&&(e={}),m.has(e)||m.set(e,g(e)),function(){var t=s(l.mark((function t(n){var o;return l.wrap((function(t){for(;;)switch(t.prev=t.next){case 0:return t.next=2,m.get(e);case 2:o=t.sent,y(),r(n,"code",x(o,e));case 5:case"end":return t.stop()}}),t)})));return function(e){return t.apply(this,arguments)}}()},exports.highlightersFromSettings=g,exports.remarkVisitor=x,exports.runTwoSlashOnNode=v,exports.setupForFile=b,exports.transformAttributesToHTML=function(e,t,r,n){var o=w(t),i=v(e,o,n);return d(i&&i.code||e,o,r,i,n)};
//# sourceMappingURL=remark-shiki-twoslash.cjs.production.min.js.map
diff --git a/dist/remark-shiki-twoslash.esm.js b/dist/remark-shiki-twoslash.esm.js
-index 7d005c0ae14fff368e1808ffae3ecef5dab756b9..fa645ebd99f6020b5eab3bc50e25762335d44054 100644
+index 7d005c0ae14fff368e1808ffae3ecef5dab756b9..cabf08a27259ac62316f3459c95ecd5bf9ae0082 100644
--- a/dist/remark-shiki-twoslash.esm.js
+++ b/dist/remark-shiki-twoslash.esm.js
-@@ -819,7 +819,7 @@ var cachedTwoslashCall = function cachedTwoslashCall(code, lang, settings) {
- var tsVersion = require('typescript/package.json').version;
+@@ -802,57 +802,7 @@ var cachedTwoslashCall = function cachedTwoslashCall(code, lang, settings) {
+ return runTwoSlash(code, lang, settings);
+ }
- var shasum = createHash("sha1");
+- var _require = require("crypto"),
+- createHash = _require.createHash;
+-
+- var _require2 = require("fs"),
+- readFileSync = _require2.readFileSync,
+- existsSync = _require2.existsSync,
+- mkdirSync = _require2.mkdirSync,
+- writeFileSync = _require2.writeFileSync;
+-
+- var _require3 = require("path"),
+- join = _require3.join;
+-
+- var shikiVersion = require('@typescript/twoslash/package.json').version;
+-
+- var tsVersion = require('typescript/package.json').version;
+-
+- var shasum = createHash("sha1");
- var codeSha = shasum.update(code + "-" + shikiVersion + "-" + tsVersion).digest("hex");
-+ var codeSha = shasum.update(JSON.stringify([code, lang, settings, shikiVersion, tsVersion, require('@typescript/vfs/package.json').version])).digest("hex");
-
- var getNmCache = function getNmCache() {
- if (__dirname.includes("node_modules")) {
-@@ -844,7 +844,10 @@ var cachedTwoslashCall = function cachedTwoslashCall(code, lang, settings) {
-
- if (existsSync(cachePath)) {
- if (process.env.debug) console.log("Using cached twoslash results from " + cachePath);
+-
+- var getNmCache = function getNmCache() {
+- if (__dirname.includes("node_modules")) {
+- return join(__dirname.split("node_modules")[0], "node_modules", ".cache", "twoslash");
+- } else {
+- return join(__dirname, "..", "..", ".cache", "twoslash");
+- }
+- };
+-
+- var getPnpCache = function getPnpCache() {
+- try {
+- var pnp = require("pnpapi");
+-
+- return join(pnp.getPackageInformation(pnp.topLevel).packageLocation, "node_modules", ".cache", "twoslash");
+- } catch (error) {
+- return getNmCache();
+- }
+- };
+-
+- var cacheRoot = process.versions.pnp ? getPnpCache() : getNmCache();
+- var cachePath = join(cacheRoot, codeSha + ".json");
+-
+- if (existsSync(cachePath)) {
+- if (process.env.debug) console.log("Using cached twoslash results from " + cachePath);
- return JSON.parse(readFileSync(cachePath, "utf8"));
-+ var results = JSON.parse(readFileSync(cachePath, "utf8"));
-+ var now = new Date();
-+ require("fs").utimesSync(cachePath, now, now);
-+ return results;
- } else {
- var results = runTwoSlash(code, lang, settings);
- if (!existsSync(cacheRoot)) mkdirSync(cacheRoot, {
+- } else {
+- var results = runTwoSlash(code, lang, settings);
+- if (!existsSync(cacheRoot)) mkdirSync(cacheRoot, {
+- recursive: true
+- });
+- writeFileSync(cachePath, JSON.stringify(results), "utf8");
+- return results;
+- }
++ return require("./twoslash-cache.js")(code, lang, settings, runTwoSlash);
+ };
+
+ var addIncludes = function addIncludes(map, name, code) {
+diff --git a/dist/twoslash-cache.js b/dist/twoslash-cache.js
+new file mode 100644
+index 0000000000000000000000000000000000000000..7ae5d5ad41e6284ba9eefcfbfb86235800c94a9d
+--- /dev/null
++++ b/dist/twoslash-cache.js
+@@ -0,0 +1,149 @@
++const fs = require("fs")
++const path = require("path")
++const { createHash } = require("crypto")
++const { createRequire } = require("module")
++
++const shikiRequire = createRequire(require.resolve("shiki-twoslash"))
++const twoslashRequire = createRequire(shikiRequire.resolve("@typescript/twoslash"))
++const ts = twoslashRequire("typescript")
++const readTokens = new Map()
++let implementation
++
++const digest = value => createHash("sha1").update(value).digest("hex")
++const portable = filename =>
++ path.isAbsolute(filename) ? path.relative(process.cwd(), filename) : filename
++
++function compilerImplementation() {
++ if (implementation) return implementation
++ const hash = createHash("sha1")
++ hash.update(fs.readFileSync(__filename))
++ for (const [name, resolver] of [
++ ["shiki-twoslash", require],
++ ["@typescript/twoslash", shikiRequire],
++ ["@typescript/vfs", twoslashRequire],
++ ]) {
++ hash.update(name).update(fs.readFileSync(resolver.resolve(name + "/package.json")))
++ const directory = path.join(
++ path.dirname(resolver.resolve(name + "/package.json")),
++ "dist"
++ )
++ for (const filename of fs.readdirSync(directory).filter(f => f.endsWith(".js")).sort()) {
++ hash.update(filename).update(fs.readFileSync(path.join(directory, filename)))
++ }
++ }
++ for (const name of ["typescript", "lz-string"]) {
++ hash.update(name).update(fs.readFileSync(twoslashRequire.resolve(name)))
++ }
++ implementation = hash.digest("hex")
++ return implementation
++}
++
++function rememberRead(filename, contents, stat) {
++ filename = path.resolve(filename)
++ const token = contents === undefined ? null : digest(contents)
++ if (stat) {
++ const signature = [stat.size, stat.mtimeMs, stat.ctimeMs, stat.ino].join(":")
++ readTokens.delete(filename)
++ readTokens.set(filename, { signature, token })
++ if (readTokens.size > 256) readTokens.delete(readTokens.keys().next().value)
++ }
++ return token
++}
++
++function readToken(filename) {
++ filename = path.resolve(filename)
++ const stat = fs.statSync(filename, { throwIfNoEntry: false })
++ if (!stat) return null
++ const signature = [stat.size, stat.mtimeMs, stat.ctimeMs, stat.ino].join(":")
++ const cached = readTokens.get(filename)
++ if (cached && cached.signature === signature) {
++ readTokens.delete(filename)
++ readTokens.set(filename, cached)
++ return cached.token
++ }
++ return rememberRead(filename, ts.sys.readFile(filename), stat)
++}
++
++function inputToken(value) {
++ if (Array.isArray(value)) return JSON.stringify(value.map(portable))
++ if (typeof value === "string") return portable(value)
++ return value
++}
++
++function inputsMatch(inputs) {
++ return inputs.every(input => {
++ const args = input.args.map((arg, i) =>
++ input.undefinedArgs.includes(i) ? undefined : arg
++ )
++ args[0] = path.resolve(args[0])
++ const token = input.method === "readFile"
++ ? readToken(args[0])
++ : inputToken(ts.sys[input.method](...args))
++ return token === input.token
++ })
++}
++
++function compile(code, lang, settings, runTwoSlash) {
++ const inputs = new Map()
++ const sys = { ...ts.sys }
++ // Misses and directory probes matter when new typings become available.
++ for (const method of [
++ "readFile", "fileExists", "directoryExists", "getDirectories",
++ "readDirectory", "realpath", "resolvePath",
++ ]) {
++ if (!ts.sys[method]) continue
++ sys[method] = (...args) => {
++ const value = ts.sys[method](...args)
++ const input = {
++ method,
++ args: args.map((arg, i) => i === 0 ? portable(path.resolve(arg)) : arg),
++ undefinedArgs: args.flatMap((arg, i) => arg === undefined ? [i] : []),
++ }
++ const key = JSON.stringify(input)
++ input.token = method === "readFile"
++ ? rememberRead(args[0], value, fs.statSync(args[0], { throwIfNoEntry: false }))
++ : inputToken(value)
++ inputs.set(key, input)
++ return value
++ }
++ }
++ const options = { ...settings, tsModule: { ...ts, sys } }
++ const results = runTwoSlash(code, lang, options)
++ return { results, inputs: [...inputs.values()] }
++}
++
++function cacheDirectory() {
++ if (process.versions.pnp) {
++ const pnp = require("pnpapi")
++ return path.join(
++ pnp.getPackageInformation(pnp.topLevel).packageLocation,
++ "node_modules", ".cache", "twoslash"
++ )
++ }
++ return __dirname.includes("node_modules")
++ ? path.join(__dirname.split("node_modules")[0], "node_modules", ".cache", "twoslash")
++ : path.join(__dirname, "..", "..", ".cache", "twoslash")
++}
++
++module.exports = function cachedTwoslash(code, lang, settings, runTwoSlash) {
++ if (settings.tsModule || settings.fsMap || settings.customTransformers || settings.lzstringModule) {
++ if (process.env.debug) console.log("Skipping Twoslash cache for custom compiler inputs")
++ return runTwoSlash(code, lang, settings)
++ }
++ const key = digest(JSON.stringify([code, lang, settings, compilerImplementation()]))
++ const directory = cacheDirectory()
++ const filename = path.join(directory, key + ".json")
++ if (fs.existsSync(filename)) {
++ const cached = JSON.parse(fs.readFileSync(filename, "utf8"))
++ if (inputsMatch(cached.inputs)) {
++ if (process.env.debug) console.log("Using cached twoslash results from " + filename)
++ const now = new Date()
++ fs.utimesSync(filename, now, now)
++ return cached.results
++ }
++ }
++ const cached = compile(code, lang, settings, runTwoSlash)
++ fs.mkdirSync(directory, { recursive: true })
++ fs.writeFileSync(filename, JSON.stringify(cached), "utf8")
++ return cached.results
++}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index caa4de3cd806..fa0560b58e97 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -24,7 +24,7 @@ patchedDependencies:
hash: 3aa0dc2d9c0fd3921986acbadfef7a10df948fb30d02590f86cecab9b91800bf
path: patches/gatsby-remark-shiki-twoslash@3.0.38.patch
remark-shiki-twoslash@3.1.3:
- hash: 6a88dcbef5f4a7db6aa5d7a1fbaf9a293d04068303b7400ccb46fbae51d3e8b7
+ hash: 5bd6570cdb97b323924ced9d2e68aae4b5f7bea40b13ee9a3ca712e774883c30
path: patches/remark-shiki-twoslash@3.1.3.patch
importers:
@@ -84,7 +84,7 @@ importers:
version: 13.0.2
remark-shiki-twoslash:
specifier: ^3.1.3
- version: 3.1.3(patch_hash=6a88dcbef5f4a7db6aa5d7a1fbaf9a293d04068303b7400ccb46fbae51d3e8b7)(typescript@6.0.2)
+ version: 3.1.3(patch_hash=5bd6570cdb97b323924ced9d2e68aae4b5f7bea40b13ee9a3ca712e774883c30)(typescript@6.0.2)
packages/ata:
dependencies:
@@ -16343,7 +16343,7 @@ snapshots:
gatsby-remark-shiki-twoslash@3.0.38(patch_hash=3aa0dc2d9c0fd3921986acbadfef7a10df948fb30d02590f86cecab9b91800bf):
dependencies:
- remark-shiki-twoslash: 3.1.3(patch_hash=6a88dcbef5f4a7db6aa5d7a1fbaf9a293d04068303b7400ccb46fbae51d3e8b7)(typescript@6.0.2)
+ remark-shiki-twoslash: 3.1.3(patch_hash=5bd6570cdb97b323924ced9d2e68aae4b5f7bea40b13ee9a3ca712e774883c30)(typescript@6.0.2)
typescript: 6.0.2
unist-util-visit: 2.0.3
@@ -20184,7 +20184,7 @@ snapshots:
dependencies:
mdast-util-to-nlcst: 4.0.1
- remark-shiki-twoslash@3.1.3(patch_hash=6a88dcbef5f4a7db6aa5d7a1fbaf9a293d04068303b7400ccb46fbae51d3e8b7)(typescript@6.0.2):
+ remark-shiki-twoslash@3.1.3(patch_hash=5bd6570cdb97b323924ced9d2e68aae4b5f7bea40b13ee9a3ca712e774883c30)(typescript@6.0.2):
dependencies:
'@types/unist': 2.0.11
'@typescript/twoslash': link:packages/ts-twoslasher
@@ -21436,7 +21436,7 @@ snapshots:
hast-util-to-html: 7.1.3
mdast-util-to-hast: 10.2.0
remark: 13.0.0
- remark-shiki-twoslash: 3.1.3(patch_hash=6a88dcbef5f4a7db6aa5d7a1fbaf9a293d04068303b7400ccb46fbae51d3e8b7)(typescript@6.0.2)
+ remark-shiki-twoslash: 3.1.3(patch_hash=5bd6570cdb97b323924ced9d2e68aae4b5f7bea40b13ee9a3ca712e774883c30)(typescript@6.0.2)
unist-util-visit: 3.1.0
transitivePeerDependencies:
- supports-color
From 988d0aab0b64b3c06baab88c4ac3b4853d9af020 Mon Sep 17 00:00:00 2001
From: Jake Bailey <5341706+jakebailey@users.noreply.github.com>
Date: Thu, 1 Oct 2026 07:54:16 -0700
Subject: [PATCH 10/14] Exercise restored website build caches
From 2ed2488ed1e8fba79f1f2a661273ebc27c0e9c7b Mon Sep 17 00:00:00 2001
From: Jake Bailey <5341706+jakebailey@users.noreply.github.com>
Date: Thu, 1 Oct 2026 08:16:42 -0700
Subject: [PATCH 11/14] Generate the TSConfig reference just once per build
Regenerating the same reference after the CLI documentation adds eight
seconds to package preparation on CI without changing its output.
---
packages/tsconfig-reference/package.json | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/packages/tsconfig-reference/package.json b/packages/tsconfig-reference/package.json
index cc54552f67a8..7447712e62ee 100644
--- a/packages/tsconfig-reference/package.json
+++ b/packages/tsconfig-reference/package.json
@@ -12,7 +12,7 @@
"generate:md:tsconfig": "tsc --build && node scripts/tsconfig/generateMarkdown",
"generate:md:cli": "tsc --build && node scripts/cli/generateMarkdown",
"generate:md:msbuild": "tsc --build && node scripts/msbuild/generateMarkdown",
- "generate:md": "pnpm generate:md:tsconfig && pnpm generate:md:cli && pnpm generate:md:tsconfig",
+ "generate:md": "pnpm generate:md:tsconfig && pnpm generate:md:cli",
"download": "node scripts/schema/downloadSchemaBase.js",
"bootstrap": "pnpm generate:json",
"build": "pnpm generate:json && pnpm generate:md",
From 40a711ad2ec946a0f5090778f88229816a38a357 Mon Sep 17 00:00:00 2001
From: Jake Bailey <5341706+jakebailey@users.noreply.github.com>
Date: Thu, 1 Oct 2026 08:22:13 -0700
Subject: [PATCH 12/14] Reuse prepared packages when running CI tests
CI already builds every package before building the site. Repeating the
generators during tests adds 42-54 seconds without providing another check.
Keep standalone tests unchanged. Validate generated documentation before
running independent package tests with bounded concurrency, avoiding the
unrelated dependency barriers in the test phase.
---
.github/workflows/CI.yml | 2 +-
package.json | 1 +
2 files changed, 2 insertions(+), 1 deletion(-)
diff --git a/.github/workflows/CI.yml b/.github/workflows/CI.yml
index 133168abb8ff..eaba1385e152 100644
--- a/.github/workflows/CI.yml
+++ b/.github/workflows/CI.yml
@@ -57,7 +57,7 @@ jobs:
path: packages/typescriptlang-org/public
# Run all the package's tests
- - run: pnpm test
+ - run: pnpm test:ci
- run: |
git add .
diff --git a/package.json b/package.json
index c89c97ea466b..352b35b1ec80 100644
--- a/package.json
+++ b/package.json
@@ -77,6 +77,7 @@
"clean": "pnpm run --filter=typescriptlang-org gatsby clean",
"clean-twoslash": "rm -rf packages/.cache/twoslash",
"test": "CI=true pnpm -r run test",
+ "test:ci": "CI=true pnpm -r --filter=glossary --filter=tsconfig-reference run lint && CI=true pnpm -r --filter=!root --filter=!glossary --filter=!tsconfig-reference --no-sort run test",
"update-test-snapshots": "CI=true pnpm run --filter=@typescript/twoslash --filter=@typescript/vfs test -u"
},
"repository": "microsoft/TypeScript-Website",
From 905cbf2ceabb5be4b06d4db06593a6f53927e8f0 Mon Sep 17 00:00:00 2001
From: Jake Bailey <5341706+jakebailey@users.noreply.github.com>
Date: Thu, 1 Oct 2026 08:24:20 -0700
Subject: [PATCH 13/14] Checkpoint compiled examples after validation
Documentation linting compiles examples with different settings from the
site build. Saving only before tests discards that work, costing 65-76
seconds on each CI run.
Save a second bounded snapshot after successful tests with a distinct
immutable key. Keep the earlier checkpoint so failed tests still preserve
the completed site build.
---
.github/workflows/CI.yml | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/.github/workflows/CI.yml b/.github/workflows/CI.yml
index eaba1385e152..b27bd2b73546 100644
--- a/.github/workflows/CI.yml
+++ b/.github/workflows/CI.yml
@@ -59,6 +59,11 @@ jobs:
# Run all the package's tests
- run: pnpm test:ci
+ - name: Save website validation caches
+ uses: ./.github/actions/website-cache/save
+ with:
+ key: ${{ steps.website-cache.outputs.key }}-tests
+
- run: |
git add .
if ! git diff --staged --exit-code --quiet; then
From 43ade33597ff1b3f5420ff43400df5d9bac6721d Mon Sep 17 00:00:00 2001
From: Jake Bailey <5341706+jakebailey@users.noreply.github.com>
Date: Thu, 1 Oct 2026 12:57:00 -0700
Subject: [PATCH 14/14] Run package validation independently of website builds
The website and package tests do not need to share a runner or wait for
each other. Run both operating-system matrices independently so package
validation no longer extends the site build critical path.
Keep Gatsby-dependent checks and documentation validation with the site,
retain every required check, and preserve the CI workflow and site artifact
consumed by preview deployment. No additional interbuild caches are needed.
---
.github/workflows/CI.yml | 53 +++++++++++++++++++++++++++++++++++++---
package.json | 4 ++-
2 files changed, 52 insertions(+), 5 deletions(-)
diff --git a/.github/workflows/CI.yml b/.github/workflows/CI.yml
index b27bd2b73546..81ab2f87ba44 100644
--- a/.github/workflows/CI.yml
+++ b/.github/workflows/CI.yml
@@ -11,7 +11,7 @@ defaults:
shell: bash
jobs:
- tests:
+ site:
strategy:
fail-fast: false
matrix:
@@ -56,8 +56,8 @@ jobs:
name: site
path: packages/typescriptlang-org/public
- # Run all the package's tests
- - run: pnpm test:ci
+ # Validate documentation and types generated by Gatsby
+ - run: pnpm test:ci:site
- name: Save website validation caches
uses: ./.github/actions/website-cache/save
@@ -81,7 +81,51 @@ jobs:
if: ${{ failure() && steps.check-diff.conclusion == 'failure' }}
uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
with:
- name: missing.patch
+ name: missing.patch-site-${{ matrix.os }}
+ path: missing.patch
+
+ tests:
+ strategy:
+ fail-fast: false
+ matrix:
+ os:
+ - ubuntu-latest
+ - windows-latest
+ - macos-latest
+
+ runs-on: ${{ matrix.os }}
+
+ steps:
+ - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+ - uses: pnpm/action-setup@ea17c68df8912ef543352723c149a84f56e3d413 # v6.1.0
+ - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+ with:
+ node-version: "20.x"
+ cache: pnpm
+
+ - run: pnpm install --frozen-lockfile
+ - run: pnpm docs-sync pull microsoft/TypeScript-Website-localizations#main 1
+ - run: pnpm bootstrap
+ - run: pnpm test:ci:packages
+
+ - run: |
+ git add .
+ if ! git diff --staged --exit-code --quiet; then
+ echo "This PR is missing some generated changes. Please update locally or merge the patch artifact."
+ echo ""
+ git diff --staged
+ git diff --staged > missing.patch
+ exit 1
+ fi
+ name: Check for uncommitted changes
+ id: check-diff
+ if: github.event_name == 'pull_request'
+
+ - name: Upload diff artifact
+ if: ${{ failure() && steps.check-diff.conclusion == 'failure' }}
+ uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+ with:
+ name: missing.patch-packages-${{ matrix.os }}
path: missing.patch
changesets:
@@ -117,6 +161,7 @@ jobs:
runs-on: ubuntu-latest
if: ${{ always() }}
needs:
+ - site
- tests
- changesets
diff --git a/package.json b/package.json
index 352b35b1ec80..e3cc29de9812 100644
--- a/package.json
+++ b/package.json
@@ -77,7 +77,9 @@
"clean": "pnpm run --filter=typescriptlang-org gatsby clean",
"clean-twoslash": "rm -rf packages/.cache/twoslash",
"test": "CI=true pnpm -r run test",
- "test:ci": "CI=true pnpm -r --filter=glossary --filter=tsconfig-reference run lint && CI=true pnpm -r --filter=!root --filter=!glossary --filter=!tsconfig-reference --no-sort run test",
+ "test:ci": "pnpm test:ci:site && pnpm test:ci:packages",
+ "test:ci:site": "CI=true pnpm -r --filter=glossary --filter=tsconfig-reference run lint && CI=true pnpm --filter=typescriptlang-org test",
+ "test:ci:packages": "CI=true pnpm -r --filter=!root --filter=!typescriptlang-org --filter=!glossary --filter=!tsconfig-reference --no-sort run test",
"update-test-snapshots": "CI=true pnpm run --filter=@typescript/twoslash --filter=@typescript/vfs test -u"
},
"repository": "microsoft/TypeScript-Website",