vocs 2.0.8 → 2.0.10

package/dist/internal/twoslash/inline-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inline-cache.d.ts","sourceRoot":"","sources":["../../../src/internal/twoslash/inline-cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAGhF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED,OAAO,QAAQ,gBAAgB,CAAC;IAC9B,UAAU,2BAA2B;QACnC,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;QAC5B,OAAO,CAAC,EAAE,mBAAmB,CAAA;QAC7B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;KACrC;CACF;AAUD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,CAElF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;CAC5B,CAWA;AAaD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAO,GAChF;IAAE,UAAU,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAyJ1D;AA+BD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAIjE;AAWD,qEAAqE;AACrE,wBAAgB,WAAW,IAAI;IAAE,UAAU,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAGtF;AAED,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExC;AAED,iDAAiD;AACjD,wBAAgB,KAAK,IAAI,IAAI,CAE5B"}
+{"version":3,"file":"inline-cache.d.ts","sourceRoot":"","sources":["../../../src/internal/twoslash/inline-cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEhF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED,OAAO,QAAQ,gBAAgB,CAAC;IAC9B,UAAU,2BAA2B;QACnC,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;QAC5B,OAAO,CAAC,EAAE,mBAAmB,CAAA;QAC7B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;KACrC;CACF;AAUD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,CAElF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;CAC5B,CAWA;AAuBD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAO,GAChF;IAAE,UAAU,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAkJ1D;AA+BD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAIjE;AAWD,qEAAqE;AACrE,wBAAgB,WAAW,IAAI;IAAE,UAAU,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAGtF;AAED,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExC;AAED,iDAAiD;AACjD,wBAAgB,KAAK,IAAI,IAAI,CAE5B"}

package/dist/internal/twoslash/inline-cache.js

@@ -1,6 +1,5 @@
 import * as crypto from 'node:crypto';
 import LZString from 'lz-string';
-import { getObjectHash } from 'twoslash/core';
 import { FilePatcher } from './file-patcher.js';
 /**
  * Tag used for the ephemeral source-map comment. This comment is injected into
@@ -25,6 +24,15 @@ export function extractSourceMapComment(code) {
     }
     return { code, sourceMap };
 }
+/**
+ * Cache payload format version. Kept at `1` even though the cache key changed
+ * from `optionsHash:lang:code` to `lang:code` (see `cacheHash`): stale
+ * payloads from the old key naturally fail the hash check on `preprocess` and
+ * are transparently re-seeded on the next write, so a version bump (which
+ * would force a one-shot invalidation of every committed cache comment) is
+ * unnecessary.
+ */
+const CACHE_VERSION = 1;
 const CODE_INLINE_CACHE_KEY = '@twoslash-cache';
 const CODE_INLINE_CACHE_REGEX = new RegExp(`// ${CODE_INLINE_CACHE_KEY}: (.*)(?:\n|$)`, 'g');
 /** Matches a cache comment anchored to the start of a code block body. */
@@ -44,25 +52,24 @@ export function stripInlineCacheComments(code) {
 export function createInlineTypesCache(options = {}) {
     const { remove, ignoreCache } = options;
     const patcher = new FilePatcher();
-    const optionsHashCache = new WeakMap();
-    function getOptionsHash(options = {}) {
-        let hash = optionsHashCache.get(options);
-        if (!hash) {
-            hash = getObjectHash(options);
-            optionsHashCache.set(options, hash);
-        }
-        return hash;
-    }
-    function cacheHash(code, lang, options) {
+    // Key the cache on the (already fully-composed) snippet code and language
+    // only — deliberately NOT on the twoslash options. The whole point of the
+    // inline cache is to travel with the repo across machines and CI, but
+    // `twoslashOptions` frequently contain environment-specific or volatile
+    // values (absolute paths, config that branches on whether built `.d.ts`
+    // files exist, etc). Hashing them in makes the committed cache miss on any
+    // machine other than the one that seeded it. This matches the filesystem
+    // types cache, which also keys on code alone.
+    function cacheHash(code, lang) {
         return crypto
             .createHash('sha256')
-            .update(`${getOptionsHash(options)}:${lang ?? ''}:${code}`)
+            .update(`${lang ?? ''}:${code}`)
             .digest('hex');
     }
-    function stringifyCachePayload(data, code, lang, options) {
+    function stringifyCachePayload(data, code, lang) {
         const payload = {
-            v: 1,
-            hash: cacheHash(code, lang, options),
+            v: CACHE_VERSION,
+            hash: cacheHash(code, lang),
             data: LZString.compressToBase64(JSON.stringify(data)),
         };
         return JSON.stringify(payload);
@@ -72,7 +79,7 @@ export function createInlineTypesCache(options = {}) {
             return null;
         try {
             const payload = JSON.parse(cache);
-            if (payload.v === 1) {
+            if (payload.v === CACHE_VERSION) {
                 return {
                     payload,
                     twoslash: () => {
@@ -132,7 +139,7 @@ export function createInlineTypesCache(options = {}) {
         };
     }
     const typesCache = {
-        preprocess(code, lang, options, meta) {
+        preprocess(code, lang, _options, meta) {
             if (!meta)
                 return;
             let rawCache = '';
@@ -148,7 +155,7 @@ export function createInlineTypesCache(options = {}) {
             const shouldLoadCache = !ignoreCache && !remove;
             if (shouldLoadCache) {
                 const cache = resolveCachePayload(cacheString);
-                if (cache?.payload.hash === cacheHash(code, lang, options)) {
+                if (cache?.payload.hash === cacheHash(code, lang)) {
                     const twoslash = cache.twoslash();
                     if (twoslash)
                         meta.__cache = twoslash;
@@ -164,13 +171,13 @@ export function createInlineTypesCache(options = {}) {
         read(_code, _lang, _options, meta) {
             return meta?.__cache ?? null;
         },
-        write(code, data, lang, options, meta) {
+        write(code, data, lang, _options, meta) {
             if (remove) {
                 meta?.__patch?.('');
                 return;
             }
             const twoslashShiki = simplifyTwoslashReturn(data);
-            const cacheStr = `// ${CODE_INLINE_CACHE_KEY}: ${stringifyCachePayload(twoslashShiki, code, lang, options)}`;
+            const cacheStr = `// ${CODE_INLINE_CACHE_KEY}: ${stringifyCachePayload(twoslashShiki, code, lang)}`;
             meta?.__patch?.(cacheStr);
         },
     };

package/dist/internal/twoslash/inline-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"inline-cache.js","sourceRoot":"","sources":["../../../src/internal/twoslash/inline-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC,OAAO,QAAQ,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAA+B,MAAM,eAAe,CAAA;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAqC/C;;;;GAIG;AACH,MAAM,cAAc,GAAG,uBAAuB,CAAA;AAC9C,MAAM,gBAAgB,GAAG,IAAI,MAAM,CAAC,MAAM,cAAc,eAAe,CAAC,CAAA;AAExE,MAAM,UAAU,sBAAsB,CAAC,KAAa,EAAE,SAAoB;IACxE,OAAO,MAAM,cAAc,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,KAAK,EAAE,CAAA;AACtE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAIlD,IAAI,SAAS,GAAqB,IAAI,CAAA;IACtC,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAU,EAAE,EAAE;YACtD,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAc,CAAA;YACvC,OAAO,EAAE,CAAA;QACX,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;AAC5B,CAAC;AAQD,MAAM,qBAAqB,GAAG,iBAAiB,CAAA;AAC/C,MAAM,uBAAuB,GAAG,IAAI,MAAM,CAAC,MAAM,qBAAqB,gBAAgB,EAAE,GAAG,CAAC,CAAA;AAC5F,0EAA0E;AAC1E,MAAM,4BAA4B,GAAG,IAAI,MAAM,CAAC,OAAO,qBAAqB,cAAc,CAAC,CAAA;AAE3F;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,UAA+E,EAAE;IAEjF,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAA;IACvC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IAEjC,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAkC,CAAA;IACtE,SAAS,cAAc,CAAC,UAAkC,EAAE;QAC1D,IAAI,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;YAC7B,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QACrC,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,SAAS,SAAS,CAAC,IAAY,EAAE,IAAa,EAAE,OAAgC;QAC9E,OAAO,MAAM;aACV,UAAU,CAAC,QAAQ,CAAC;aACpB,MAAM,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;aAC1D,MAAM,CAAC,KAAK,CAAC,CAAA;IAClB,CAAC;IAED,SAAS,qBAAqB,CAC5B,IAAyB,EACzB,IAAY,EACZ,IAAa,EACb,OAAgC;QAEhC,MAAM,OAAO,GAAiB;YAC5B,CAAC,EAAE,CAAC;YACJ,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;YACpC,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;SACtD,CAAA;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;IAChC,CAAC;IAED,SAAS,mBAAmB,CAAC,KAAa;QAIxC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAA;QACvB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAiB,CAAA;YACjD,IAAI,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO;oBACP,QAAQ,EAAE,GAAG,EAAE;wBACb,IAAI,CAAC;4BACH,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;wBAChE,CAAC;wBAAC,MAAM,CAAC;4BACP,OAAO,IAAI,CAAA;wBACb,CAAC;oBACH,CAAC;iBACF,CAAA;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,SAAS,oBAAoB,CAC3B,MAAiB,EACjB,MAAe;QAEf,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACtC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,SAAS,CAAA;QAEnC,MAAM,KAAK,GAAkC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;QAClE,IAAI,SAAS,GAAG,IAAI,CAAA;QAEpB,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;YAC1D,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,QAAQ,GAAG,MAAM,CAAC,EAAE,EAAE,CAAC;gBAC5C,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAA;gBACrB,KAAK,CAAC,EAAE,GAAG,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAA;gBACnC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;gBACjC,OAAO,GAAG,IAAI,CAAA;YAChB,CAAC;QACH,CAAC;QAED,4EAA4E;QAC5E,0EAA0E;QAC1E,4EAA4E;QAC5E,8CAA8C;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;YACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAA;YACtD,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;gBACxB,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;gBACxC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;QACtD,OAAO,CAAC,QAAgB,EAAE,EAAE;YAC1B,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;gBACpB,qDAAqD;gBACrD,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS;oBAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;gBAC1D,OAAM;YACR,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAChE,CAAC,CAAA;IACH,CAAC;IAED,MAAM,UAAU,GAAuB;QACrC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI;YAClC,IAAI,CAAC,IAAI;gBAAE,OAAM;YAEjB,IAAI,QAAQ,GAAG,EAAE,CAAA;YACjB,IAAI,WAAW,GAAG,EAAE,CAAA;YAEpB,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,IAAI,EAAE,EAAU,EAAE,EAAE;gBACnE,sEAAsE;gBACtE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACrB,WAAW,GAAG,EAAE,CAAA;oBAChB,QAAQ,GAAG,IAAI,CAAA;gBACjB,CAAC;gBACD,OAAO,EAAE,CAAA;YACX,CAAC,CAAC,CAAA;YAEF,MAAM,eAAe,GAAG,CAAC,WAAW,IAAI,CAAC,MAAM,CAAA;YAC/C,IAAI,eAAe,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAA;gBAC9C,IAAI,KAAK,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;oBAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;oBACjC,IAAI,QAAQ;wBAAE,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAA;gBACvC,CAAC;YACH,CAAC;YAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;gBAC5D,IAAI,KAAK;oBAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;YACjC,CAAC;YAED,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI;YAC/B,OAAO,IAAI,EAAE,OAAO,IAAI,IAAI,CAAA;QAC9B,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI;YACnC,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;gBACnB,OAAM;YACR,CAAC;YACD,MAAM,aAAa,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;YAClD,MAAM,QAAQ,GAAG,MAAM,qBAAqB,KAAK,qBAAqB,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,CAAA;YAC5G,IAAI,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAA;QAC3B,CAAC;KACF,CAAA;IAED,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAA;AAChC,CAAC;AAED,2EAA2E;AAC3E,SAAS,sBAAsB,CAAC,GAAwB;IACtD,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1F,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,CAAA;IAC7C,IAAI,GAAG;QACL,OAAO,CAEH;YACE,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,KAAK;YACZ,CAAC,EAAE,IAAI;YACP,CAAC,EAAE,KAAK;YACR,GAAG,EAAE,IAAI;YACT,EAAE,EAAE,KAAK;YACT,CAAC,EAAE,IAAI;YACP,CAAC,EAAE,KAAK;SAEX,CAAC,GAAG,CAAC,IAAI,IAAI,CACf,CAAA;IACH,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,UAAgC;IACtD,MAAM,GAAG,GAAG,YAAY,CAAC,uBAAuB,CAAC,CAAA;IACjD,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,GAAG,CAAA;IAC5B,OAAO,OAAO,CAAC,UAAU,CAAC,CAAA;AAC5B,CAAC;AAED,SAAS,UAAU;IACjB,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,8BAA8B,CAAC,KAAK,IAAI;QAC7D,WAAW,EAAE,YAAY,CAAC,8BAA8B,CAAC,KAAK,IAAI;KACnE,CAAA;AACH,CAAC;AAED,IAAI,OAA6E,CAAA;AAEjF,qEAAqE;AACrE,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,OAAO;QAAE,OAAO,GAAG,sBAAsB,CAAC,UAAU,EAAE,CAAC,CAAA;IAC5D,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,KAAK;IACnB,OAAO,GAAG,SAAS,CAAA;AACrB,CAAC"}
+{"version":3,"file":"inline-cache.js","sourceRoot":"","sources":["../../../src/internal/twoslash/inline-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC,OAAO,QAAQ,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAqC/C;;;;GAIG;AACH,MAAM,cAAc,GAAG,uBAAuB,CAAA;AAC9C,MAAM,gBAAgB,GAAG,IAAI,MAAM,CAAC,MAAM,cAAc,eAAe,CAAC,CAAA;AAExE,MAAM,UAAU,sBAAsB,CAAC,KAAa,EAAE,SAAoB;IACxE,OAAO,MAAM,cAAc,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,KAAK,EAAE,CAAA;AACtE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAIlD,IAAI,SAAS,GAAqB,IAAI,CAAA;IACtC,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAU,EAAE,EAAE;YACtD,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAc,CAAA;YACvC,OAAO,EAAE,CAAA;QACX,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;AAC5B,CAAC;AAQD;;;;;;;GAOG;AACH,MAAM,aAAa,GAAG,CAAC,CAAA;AAEvB,MAAM,qBAAqB,GAAG,iBAAiB,CAAA;AAC/C,MAAM,uBAAuB,GAAG,IAAI,MAAM,CAAC,MAAM,qBAAqB,gBAAgB,EAAE,GAAG,CAAC,CAAA;AAC5F,0EAA0E;AAC1E,MAAM,4BAA4B,GAAG,IAAI,MAAM,CAAC,OAAO,qBAAqB,cAAc,CAAC,CAAA;AAE3F;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,UAA+E,EAAE;IAEjF,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAA;IACvC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IAEjC,0EAA0E;IAC1E,0EAA0E;IAC1E,sEAAsE;IACtE,wEAAwE;IACxE,wEAAwE;IACxE,2EAA2E;IAC3E,yEAAyE;IACzE,8CAA8C;IAC9C,SAAS,SAAS,CAAC,IAAY,EAAE,IAAa;QAC5C,OAAO,MAAM;aACV,UAAU,CAAC,QAAQ,CAAC;aACpB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;aAC/B,MAAM,CAAC,KAAK,CAAC,CAAA;IAClB,CAAC;IAED,SAAS,qBAAqB,CAAC,IAAyB,EAAE,IAAY,EAAE,IAAa;QACnF,MAAM,OAAO,GAAiB;YAC5B,CAAC,EAAE,aAAa;YAChB,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;YAC3B,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;SACtD,CAAA;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;IAChC,CAAC;IAED,SAAS,mBAAmB,CAAC,KAAa;QAIxC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAA;QACvB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAiB,CAAA;YACjD,IAAI,OAAO,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC;gBAChC,OAAO;oBACL,OAAO;oBACP,QAAQ,EAAE,GAAG,EAAE;wBACb,IAAI,CAAC;4BACH,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;wBAChE,CAAC;wBAAC,MAAM,CAAC;4BACP,OAAO,IAAI,CAAA;wBACb,CAAC;oBACH,CAAC;iBACF,CAAA;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,SAAS,oBAAoB,CAC3B,MAAiB,EACjB,MAAe;QAEf,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACtC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,SAAS,CAAA;QAEnC,MAAM,KAAK,GAAkC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;QAClE,IAAI,SAAS,GAAG,IAAI,CAAA;QAEpB,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;YAC1D,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,QAAQ,GAAG,MAAM,CAAC,EAAE,EAAE,CAAC;gBAC5C,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAA;gBACrB,KAAK,CAAC,EAAE,GAAG,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAA;gBACnC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;gBACjC,OAAO,GAAG,IAAI,CAAA;YAChB,CAAC;QACH,CAAC;QAED,4EAA4E;QAC5E,0EAA0E;QAC1E,4EAA4E;QAC5E,8CAA8C;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;YACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAA;YACtD,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;gBACxB,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;gBACxC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;QACtD,OAAO,CAAC,QAAgB,EAAE,EAAE;YAC1B,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;gBACpB,qDAAqD;gBACrD,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS;oBAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;gBAC1D,OAAM;YACR,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAChE,CAAC,CAAA;IACH,CAAC;IAED,MAAM,UAAU,GAAuB;QACrC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI;YACnC,IAAI,CAAC,IAAI;gBAAE,OAAM;YAEjB,IAAI,QAAQ,GAAG,EAAE,CAAA;YACjB,IAAI,WAAW,GAAG,EAAE,CAAA;YAEpB,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,IAAI,EAAE,EAAU,EAAE,EAAE;gBACnE,sEAAsE;gBACtE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACrB,WAAW,GAAG,EAAE,CAAA;oBAChB,QAAQ,GAAG,IAAI,CAAA;gBACjB,CAAC;gBACD,OAAO,EAAE,CAAA;YACX,CAAC,CAAC,CAAA;YAEF,MAAM,eAAe,GAAG,CAAC,WAAW,IAAI,CAAC,MAAM,CAAA;YAC/C,IAAI,eAAe,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAA;gBAC9C,IAAI,KAAK,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;oBAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;oBACjC,IAAI,QAAQ;wBAAE,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAA;gBACvC,CAAC;YACH,CAAC;YAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;gBAC5D,IAAI,KAAK;oBAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;YACjC,CAAC;YAED,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI;YAC/B,OAAO,IAAI,EAAE,OAAO,IAAI,IAAI,CAAA;QAC9B,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI;YACpC,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;gBACnB,OAAM;YACR,CAAC;YACD,MAAM,aAAa,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;YAClD,MAAM,QAAQ,GAAG,MAAM,qBAAqB,KAAK,qBAAqB,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAA;YACnG,IAAI,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAA;QAC3B,CAAC;KACF,CAAA;IAED,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAA;AAChC,CAAC;AAED,2EAA2E;AAC3E,SAAS,sBAAsB,CAAC,GAAwB;IACtD,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1F,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,CAAA;IAC7C,IAAI,GAAG;QACL,OAAO,CAEH;YACE,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,KAAK;YACZ,CAAC,EAAE,IAAI;YACP,CAAC,EAAE,KAAK;YACR,GAAG,EAAE,IAAI;YACT,EAAE,EAAE,KAAK;YACT,CAAC,EAAE,IAAI;YACP,CAAC,EAAE,KAAK;SAEX,CAAC,GAAG,CAAC,IAAI,IAAI,CACf,CAAA;IACH,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,UAAgC;IACtD,MAAM,GAAG,GAAG,YAAY,CAAC,uBAAuB,CAAC,CAAA;IACjD,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,GAAG,CAAA;IAC5B,OAAO,OAAO,CAAC,UAAU,CAAC,CAAA;AAC5B,CAAC;AAED,SAAS,UAAU;IACjB,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,8BAA8B,CAAC,KAAK,IAAI;QAC7D,WAAW,EAAE,YAAY,CAAC,8BAA8B,CAAC,KAAK,IAAI;KACnE,CAAA;AACH,CAAC;AAED,IAAI,OAA6E,CAAA;AAEjF,qEAAqE;AACrE,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,OAAO;QAAE,OAAO,GAAG,sBAAsB,CAAC,UAAU,EAAE,CAAC,CAAA;IAC5D,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,KAAK;IACnB,OAAO,GAAG,SAAS,CAAA;AACrB,CAAC"}

package/dist/react/internal/CodeToHtml.client.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Lazily highlights code on the client.
+ *
+ * Twoslash hover popups embed a code snippet (the resolved type) for every
+ * hoverable token. Highlighting these with Shiki on the server forces RSC to
+ * render and serialize a fully highlighted snippet for every token across every
+ * page at build time — which dominates build memory and time even though the
+ * popups are only ever seen on hover.
+ *
+ * Instead we render the snippet as plain text in the RSC payload and highlight
+ * it on the client. Because the popup only mounts when it opens, the Shiki
+ * bundle is dynamically imported and the snippet highlighted on demand.
+ */
+export declare function CodeToHtml(props: CodeToHtml.Props): import("react/jsx-runtime").JSX.Element;
+export declare namespace CodeToHtml {
+    type Props = {
+        code: string;
+        lang: string;
+    };
+}
+/** Returns the highlighted HTML for a snippet if it has already been computed. */
+export declare function getCached(code: string, lang: string): string | undefined;
+/** Highlights a snippet (memoized), loading the Shiki bundle on first use. */
+export declare function highlight(code: string, lang: string): Promise<string>;
+/** Eagerly loads the Shiki bundle so the first real highlight is fast. */
+export declare function prewarm(): void;
+//# sourceMappingURL=CodeToHtml.client.d.ts.map

package/dist/react/internal/CodeToHtml.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeToHtml.client.d.ts","sourceRoot":"","sources":["../../../src/react/internal/CodeToHtml.client.tsx"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,2CA2BjD;AAmCD,yBAAiB,UAAU,CAAC;IAC1B,KAAY,KAAK,GAAG;QAClB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;CACF;AA0DD,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,sBAEnD;AAED,8EAA8E;AAC9E,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,mBAQzD;AAED,0EAA0E;AAC1E,wBAAgB,OAAO,SAEtB"}

package/dist/react/internal/CodeToHtml.client.js

@@ -0,0 +1,138 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { config } from 'virtual:vocs/config';
+import { useEffect, useState } from 'react';
+/**
+ * Lazily highlights code on the client.
+ *
+ * Twoslash hover popups embed a code snippet (the resolved type) for every
+ * hoverable token. Highlighting these with Shiki on the server forces RSC to
+ * render and serialize a fully highlighted snippet for every token across every
+ * page at build time — which dominates build memory and time even though the
+ * popups are only ever seen on hover.
+ *
+ * Instead we render the snippet as plain text in the RSC payload and highlight
+ * it on the client. Because the popup only mounts when it opens, the Shiki
+ * bundle is dynamically imported and the snippet highlighted on demand.
+ */
+export function CodeToHtml(props) {
+    const { code, lang } = props;
+    // Initialize from the cache so a snippet that was already highlighted (e.g.
+    // pre-highlighted by the popover before opening, or shown previously) renders
+    // highlighted immediately without a plain-text flash.
+    const [html, setHtml] = useState(() => getCached(code, lang) ?? null);
+    useEffect(() => {
+        if (html)
+            return;
+        let cancelled = false;
+        highlight(code, lang)
+            .then((result) => {
+            if (!cancelled)
+                setHtml(result);
+        })
+            .catch(() => { });
+        return () => {
+            cancelled = true;
+        };
+    }, [code, lang, html]);
+    if (html)
+        // biome-ignore lint/security/noDangerouslySetInnerHtml: highlighted by Shiki
+        return _jsx("div", { dangerouslySetInnerHTML: { __html: html } });
+    // While highlighting, render a skeleton that mirrors the snippet's line
+    // structure so the popup is shown immediately without a layout shift.
+    return _jsx(Skeleton, { code: code });
+}
+function Skeleton(props) {
+    const lines = props.code.split('\n');
+    return (_jsx("div", { "data-v-code-skeleton": true, "aria-hidden": "true", children: _jsxs("pre", { className: "shiki", "data-v-overflow-fade": true, children: [_jsx("code", { children: lines.map((line, index) => {
+                        const indent = line.length - line.trimStart().length;
+                        const length = line.trim().length;
+                        return (_jsx("span", { className: "line", children: length > 0 && (_jsx("span", { "data-v-skeleton-bar": true, style: {
+                                    marginLeft: `${indent}ch`,
+                                    width: `${Math.min(length, 48)}ch`,
+                                } })) }, index));
+                    }) }), _jsx("div", { "data-v-overflow-sentinel": true })] }) }));
+}
+let highlighterPromise;
+function getHighlighter() {
+    if (!highlighterPromise)
+        highlighterPromise = (async () => {
+            const { bundledLanguages, createHighlighter, hastToHtml } = await import('shiki/bundle/web');
+            const { codeHighlight } = config;
+            const { langAlias = {}, themes } = codeHighlight;
+            // Note: `langAlias` is intentionally not passed to the highlighter.
+            // Passing a custom `langAlias` registers languages under their alias name
+            // when lazily loaded (e.g. `loadLanguage('ts')` registers as `ts` instead
+            // of `typescript`), which then makes `codeToHast({ lang })` fail to resolve
+            // the grammar. We resolve aliases to their base language ourselves below.
+            const highlighter = await createHighlighter({
+                themes: Object.values(themes),
+                langs: [],
+            });
+            return {
+                async codeToHtml(code, lang) {
+                    const base = langAlias[lang] ?? lang;
+                    const resolvedLang = base in bundledLanguages ? base : 'txt';
+                    if (!highlighter.getLoadedLanguages().includes(resolvedLang))
+                        await highlighter.loadLanguage(resolvedLang);
+                    const hast = highlighter.codeToHast(code, {
+                        defaultColor: 'light-dark()',
+                        lang: resolvedLang,
+                        rootStyle: false,
+                        meta: { 'data-v-overflow-fade': true },
+                        themes,
+                        transformers: [transformerShrinkIndent()],
+                    });
+                    const pre = hast.children[0];
+                    if (pre && pre.type === 'element' && pre.tagName === 'pre')
+                        pre.children.push({
+                            type: 'element',
+                            tagName: 'div',
+                            properties: { 'data-v-overflow-sentinel': true },
+                            children: [],
+                        });
+                    return hastToHtml(hast);
+                },
+            };
+        })();
+    return highlighterPromise;
+}
+const cache = new Map();
+function cacheKey(code, lang) {
+    return `${lang}\n${code}`;
+}
+/** Returns the highlighted HTML for a snippet if it has already been computed. */
+export function getCached(code, lang) {
+    return cache.get(cacheKey(code, lang));
+}
+/** Highlights a snippet (memoized), loading the Shiki bundle on first use. */
+export async function highlight(code, lang) {
+    const key = cacheKey(code, lang);
+    const cached = cache.get(key);
+    if (cached !== undefined)
+        return cached;
+    const highlighter = await getHighlighter();
+    const html = await highlighter.codeToHtml(code, lang);
+    cache.set(key, html);
+    return html;
+}
+/** Eagerly loads the Shiki bundle so the first real highlight is fast. */
+export function prewarm() {
+    void getHighlighter();
+}
+function transformerShrinkIndent() {
+    return {
+        name: 'indent',
+        span(hast) {
+            const child = hast.children[0];
+            if (!child)
+                return;
+            if (child.type !== 'text')
+                return;
+            if (!child.value)
+                return;
+            hast.children[0] = { type: 'text', value: child.value.replace(/\s\s/g, ' ') };
+        },
+    };
+}
+//# sourceMappingURL=CodeToHtml.client.js.map

package/dist/react/internal/CodeToHtml.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeToHtml.client.js","sourceRoot":"","sources":["../../../src/react/internal/CodeToHtml.client.tsx"],"names":[],"mappings":"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"}

package/dist/react/internal/CodeToHtml.d.ts

@@ -1,8 +1,2 @@
-export declare function CodeToHtml(props: CodeToHtml.Props): Promise<import("react/jsx-runtime").JSX.Element>;
-export declare namespace CodeToHtml {
-    type Props = {
-        code: string;
-        lang: string;
-    };
-}
+export { CodeToHtml } from './CodeToHtml.client.js';
 //# sourceMappingURL=CodeToHtml.d.ts.map

package/dist/react/internal/CodeToHtml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CodeToHtml.d.ts","sourceRoot":"","sources":["../../../src/react/internal/CodeToHtml.tsx"],"names":[],"mappings":"AAYA,wBAAsB,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,oDAyCvD;AAED,yBAAiB,UAAU,CAAC;IAC1B,KAAY,KAAK,GAAG;QAClB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;CACF"}
+{"version":3,"file":"CodeToHtml.d.ts","sourceRoot":"","sources":["../../../src/react/internal/CodeToHtml.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/react/internal/CodeToHtml.js

@@ -1,57 +1,2 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { config } from 'virtual:vocs/config';
-import { langs as virtualLangs } from 'virtual:vocs/langs';
-import { bundledLanguages, createHighlighter, hastToHtml, makeSingletonHighlighter, } from 'shiki/bundle/web';
-const getHighlighter = makeSingletonHighlighter(createHighlighter);
-export async function CodeToHtml(props) {
-    const { code, lang } = props;
-    const { codeHighlight } = config;
-    const { langAlias = {}, themes } = codeHighlight;
-    const highlighter = await getHighlighter({
-        themes: import.meta.env.DEV ? ['none'] : Object.values(themes),
-        langs: import.meta.env.DEV
-            ? ['txt']
-            : [...Object.keys(bundledLanguages), ...virtualLangs],
-        langAlias,
-    });
-    const loadedLangs = highlighter.getLoadedLanguages();
-    const resolvedLang = loadedLangs.includes(lang) ? lang : 'txt';
-    const hast = highlighter.codeToHast(code, {
-        defaultColor: 'light-dark()',
-        lang: import.meta.env.DEV ? 'txt' : resolvedLang,
-        rootStyle: false,
-        meta: {
-            'data-v-overflow-fade': true,
-        },
-        ...(import.meta.env.DEV ? { theme: 'none' } : { themes }),
-        transformers: [transformerShrinkIndent()],
-    });
-    // Add overflow sentinel
-    const pre = hast.children[0];
-    if (pre && pre.type === 'element' && pre.tagName === 'pre')
-        pre.children.push({
-            type: 'element',
-            tagName: 'div',
-            properties: { 'data-v-overflow-sentinel': true },
-            children: [],
-        });
-    const html = hastToHtml(hast);
-    // biome-ignore lint/security/noDangerouslySetInnerHtml: _
-    return _jsx("div", { dangerouslySetInnerHTML: { __html: html } });
-}
-function transformerShrinkIndent() {
-    return {
-        name: 'indent',
-        span(hast) {
-            const child = hast.children[0];
-            if (!child)
-                return;
-            if (child.type !== 'text')
-                return;
-            if (!child.value)
-                return;
-            hast.children[0] = { type: 'text', value: child.value.replace(/\s\s/g, ' ') };
-        },
-    };
-}
+export { CodeToHtml } from './CodeToHtml.client.js';
 //# sourceMappingURL=CodeToHtml.js.map

package/dist/react/internal/CodeToHtml.js.map

@@ -1 +1 @@
-{"version":3,"file":"CodeToHtml.js","sourceRoot":"","sources":["../../../src/react/internal/CodeToHtml.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"CodeToHtml.js","sourceRoot":"","sources":["../../../src/react/internal/CodeToHtml.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/react/internal/TwoslashHover.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TwoslashHover.client.d.ts","sourceRoot":"","sources":["../../../src/react/internal/TwoslashHover.client.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAGnC,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,KAAK,2CA+BvD;AAED,yBAAiB,aAAa,CAAC;IAC7B,KAAY,KAAK,GAAG;QAClB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;QACzB,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC1B,OAAO,EAAE,KAAK,CAAC,SAAS,CAAA;KACzB,CAAA;IAED,SAAgB,eAAe;uBACK,cAAc,GAAG,IAAI;MAwBxD;CACF"}
+{"version":3,"file":"TwoslashHover.client.d.ts","sourceRoot":"","sources":["../../../src/react/internal/TwoslashHover.client.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAInC,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,KAAK,2CAqCvD;AAED,yBAAiB,aAAa,CAAC;IAC7B,KAAY,KAAK,GAAG;QAClB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;QACzB,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC1B,OAAO,EAAE,KAAK,CAAC,SAAS,CAAA;KACzB,CAAA;IAED,SAAgB,eAAe;uBACK,cAAc,GAAG,IAAI;MAwBxD;CACF"}

package/dist/react/internal/TwoslashHover.client.js

@@ -1,11 +1,17 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Popover } from '@base-ui/react/popover';
-import { useCallback } from 'react';
+import { useCallback, useEffect } from 'react';
+import { prewarm } from './CodeToHtml.client.js';
 export function TwoslashHover(props) {
     const { className = '', children, trigger } = props;
     const { ref } = TwoslashHover.useOverflowFade();
     const open = className?.includes('twoslash-query-persisted');
+    // Warm the highlighter so the code inside the popup highlights as quickly as
+    // possible (the popup shows a skeleton placeholder until then).
+    useEffect(() => {
+        prewarm();
+    }, []);
     return (_jsxs(Popover.Root, { ...(open ? { open } : {}), children: [_jsx(Popover.Trigger, { "data-v-twoslash-trigger": true, openOnHover: true, delay: 0, children: _jsx("span", { children: trigger }) }), _jsx(Popover.Portal, { children: _jsx(Popover.Positioner, { align: "start", side: "bottom", sideOffset: 4, collisionAvoidance: { side: 'none' }, children: _jsxs(Popover.Popup, { className: className, initialFocus: false, children: [_jsx(Popover.Arrow, { className: "vocs:data-[side=bottom]:top-[-8px] vocs:data-[side=left]:right-[-13px] vocs:data-[side=left]:rotate-90 vocs:data-[side=right]:left-[-13px] vocs:data-[side=right]:-rotate-90 vocs:data-[side=top]:bottom-[-8px] vocs:data-[side=top]:rotate-180", children: _jsx(ArrowSvg, {}) }), _jsx("div", { "data-v-content": true, ref: ref, children: children })] }) }) })] }));
 }
 (function (TwoslashHover) {

package/dist/react/internal/TwoslashHover.client.js.map

@@ -1 +1 @@
-{"version":3,"file":"TwoslashHover.client.js","sourceRoot":"","sources":["../../../src/react/internal/TwoslashHover.client.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"TwoslashHover.client.js","sourceRoot":"","sources":["../../../src/react/internal/TwoslashHover.client.tsx"],"names":[],"mappings":"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"}

package/dist/styles/twoslash.css

@@ -63,6 +63,38 @@
   }
 }
 
+[data-v-code-skeleton] [data-v-skeleton-bar] {
+  display: inline-block;
+  height: 0.72em;
+  vertical-align: middle;
+  border-radius: 0.1875rem;
+  background-color: var(--vocs-background-color-surfaceTint);
+  background-image: linear-gradient(
+    90deg,
+    transparent 0%,
+    color-mix(in srgb, var(--vocs-color-gray10) 22%, transparent) 50%,
+    transparent 100%
+  );
+  background-repeat: no-repeat;
+  background-size: 200% 100%;
+  animation: vocs-skeleton-shimmer 1.25s ease-in-out infinite;
+}
+
+@keyframes vocs-skeleton-shimmer {
+  from {
+    background-position: 180% 0;
+  }
+  to {
+    background-position: -80% 0;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  [data-v-code-skeleton] [data-v-skeleton-bar] {
+    animation: none;
+  }
+}
+
 .twoslash-popup-docs {
   @apply vocs:max-h-40 vocs:overflow-y-scroll;
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vocs",
   "type": "module",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "main": "./dist/index.js",
   "license": "MIT",
   "repository": {

package/src/internal/twoslash/inline-cache.test.ts

@@ -141,6 +141,32 @@ describe('inline types cache', () => {
     expect(cacheLines()).toHaveLength(1)
   })
 
+  it('hits regardless of twoslash options (portable across environments)', () => {
+    const code = 'const a: string = "x"'
+    const { file, from, to } = createMarkdown(code)
+    const data = { nodes: [], code: 'compiled-output' }
+
+    // Seed with one set of options (e.g. machine A, with `paths`).
+    {
+      const { typesCache, patcher } = createInlineTypesCache()
+      const meta = { sourceMap: { path: file, from, to } } as never
+      const options = { compilerOptions: { paths: { foo: ['/abs/a'] } } }
+      typesCache.preprocess?.(code, 'ts', options as never, meta)
+      typesCache.write(code, data as never, 'ts', options as never, meta)
+      patcher.patch(file)
+    }
+
+    // Read with different options (e.g. machine B / Vercel, without `paths`).
+    {
+      const { typesCache } = createInlineTypesCache()
+      const body = readBody(file, from)
+      const meta = { sourceMap: { path: file, from, to } } as never
+      const otherOptions = { compilerOptions: {} }
+      typesCache.preprocess?.(body, 'ts', otherOptions as never, meta)
+      expect(typesCache.read(body, 'ts', otherOptions as never, meta)).toEqual(data)
+    }
+  })
+
   it('invalidates the cache when the hash no longer matches', () => {
     const code = 'const a: string = "x"'
     const { file, from, to } = createMarkdown(code)

package/src/internal/twoslash/inline-cache.ts

@@ -1,7 +1,6 @@
 import * as crypto from 'node:crypto'
 import type { TwoslashShikiReturn, TwoslashTypesCache } from '@shikijs/twoslash'
 import LZString from 'lz-string'
-import { getObjectHash, type TwoslashExecuteOptions } from 'twoslash/core'
 import { FilePatcher } from './file-patcher.js'
 
 /**
@@ -73,6 +72,16 @@ type CachePayload = {
   data: string
 }
 
+/**
+ * Cache payload format version. Kept at `1` even though the cache key changed
+ * from `optionsHash:lang:code` to `lang:code` (see `cacheHash`): stale
+ * payloads from the old key naturally fail the hash check on `preprocess` and
+ * are transparently re-seeded on the next write, so a version bump (which
+ * would force a one-shot invalidation of every committed cache comment) is
+ * unnecessary.
+ */
+const CACHE_VERSION = 1
+
 const CODE_INLINE_CACHE_KEY = '@twoslash-cache'
 const CODE_INLINE_CACHE_REGEX = new RegExp(`// ${CODE_INLINE_CACHE_KEY}: (.*)(?:\n|$)`, 'g')
 /** Matches a cache comment anchored to the start of a code block body. */
@@ -97,32 +106,25 @@ export function createInlineTypesCache(
   const { remove, ignoreCache } = options
   const patcher = new FilePatcher()
 
-  const optionsHashCache = new WeakMap<TwoslashExecuteOptions, string>()
-  function getOptionsHash(options: TwoslashExecuteOptions = {}): string {
-    let hash = optionsHashCache.get(options)
-    if (!hash) {
-      hash = getObjectHash(options)
-      optionsHashCache.set(options, hash)
-    }
-    return hash
-  }
-
-  function cacheHash(code: string, lang?: string, options?: TwoslashExecuteOptions): string {
+  // Key the cache on the (already fully-composed) snippet code and language
+  // only — deliberately NOT on the twoslash options. The whole point of the
+  // inline cache is to travel with the repo across machines and CI, but
+  // `twoslashOptions` frequently contain environment-specific or volatile
+  // values (absolute paths, config that branches on whether built `.d.ts`
+  // files exist, etc). Hashing them in makes the committed cache miss on any
+  // machine other than the one that seeded it. This matches the filesystem
+  // types cache, which also keys on code alone.
+  function cacheHash(code: string, lang?: string): string {
     return crypto
       .createHash('sha256')
-      .update(`${getOptionsHash(options)}:${lang ?? ''}:${code}`)
+      .update(`${lang ?? ''}:${code}`)
       .digest('hex')
   }
 
-  function stringifyCachePayload(
-    data: TwoslashShikiReturn,
-    code: string,
-    lang?: string,
-    options?: TwoslashExecuteOptions,
-  ): string {
+  function stringifyCachePayload(data: TwoslashShikiReturn, code: string, lang?: string): string {
     const payload: CachePayload = {
-      v: 1,
-      hash: cacheHash(code, lang, options),
+      v: CACHE_VERSION,
+      hash: cacheHash(code, lang),
       data: LZString.compressToBase64(JSON.stringify(data)),
     }
     return JSON.stringify(payload)
@@ -135,7 +137,7 @@ export function createInlineTypesCache(
     if (!cache) return null
     try {
       const payload = JSON.parse(cache) as CachePayload
-      if (payload.v === 1) {
+      if (payload.v === CACHE_VERSION) {
         return {
           payload,
           twoslash: () => {
@@ -200,7 +202,7 @@ export function createInlineTypesCache(
   }
 
   const typesCache: TwoslashTypesCache = {
-    preprocess(code, lang, options, meta) {
+    preprocess(code, lang, _options, meta) {
       if (!meta) return
 
       let rawCache = ''
@@ -218,7 +220,7 @@ export function createInlineTypesCache(
       const shouldLoadCache = !ignoreCache && !remove
       if (shouldLoadCache) {
         const cache = resolveCachePayload(cacheString)
-        if (cache?.payload.hash === cacheHash(code, lang, options)) {
+        if (cache?.payload.hash === cacheHash(code, lang)) {
           const twoslash = cache.twoslash()
           if (twoslash) meta.__cache = twoslash
         }
@@ -234,13 +236,13 @@ export function createInlineTypesCache(
     read(_code, _lang, _options, meta) {
       return meta?.__cache ?? null
     },
-    write(code, data, lang, options, meta) {
+    write(code, data, lang, _options, meta) {
       if (remove) {
         meta?.__patch?.('')
         return
       }
       const twoslashShiki = simplifyTwoslashReturn(data)
-      const cacheStr = `// ${CODE_INLINE_CACHE_KEY}: ${stringifyCachePayload(twoslashShiki, code, lang, options)}`
+      const cacheStr = `// ${CODE_INLINE_CACHE_KEY}: ${stringifyCachePayload(twoslashShiki, code, lang)}`
       meta?.__patch?.(cacheStr)
     },
   }

package/src/react/internal/CodeToHtml.client.tsx

@@ -0,0 +1,176 @@
+'use client'
+
+import { config } from 'virtual:vocs/config'
+import { useEffect, useState } from 'react'
+
+/**
+ * Lazily highlights code on the client.
+ *
+ * Twoslash hover popups embed a code snippet (the resolved type) for every
+ * hoverable token. Highlighting these with Shiki on the server forces RSC to
+ * render and serialize a fully highlighted snippet for every token across every
+ * page at build time — which dominates build memory and time even though the
+ * popups are only ever seen on hover.
+ *
+ * Instead we render the snippet as plain text in the RSC payload and highlight
+ * it on the client. Because the popup only mounts when it opens, the Shiki
+ * bundle is dynamically imported and the snippet highlighted on demand.
+ */
+export function CodeToHtml(props: CodeToHtml.Props) {
+  const { code, lang } = props
+  // Initialize from the cache so a snippet that was already highlighted (e.g.
+  // pre-highlighted by the popover before opening, or shown previously) renders
+  // highlighted immediately without a plain-text flash.
+  const [html, setHtml] = useState<string | null>(() => getCached(code, lang) ?? null)
+
+  useEffect(() => {
+    if (html) return
+    let cancelled = false
+    highlight(code, lang)
+      .then((result) => {
+        if (!cancelled) setHtml(result)
+      })
+      .catch(() => {})
+    return () => {
+      cancelled = true
+    }
+  }, [code, lang, html])
+
+  if (html)
+    // biome-ignore lint/security/noDangerouslySetInnerHtml: highlighted by Shiki
+    return <div dangerouslySetInnerHTML={{ __html: html }} />
+
+  // While highlighting, render a skeleton that mirrors the snippet's line
+  // structure so the popup is shown immediately without a layout shift.
+  return <Skeleton code={code} />
+}
+
+function Skeleton(props: { code: string }) {
+  const lines = props.code.split('\n')
+  return (
+    <div data-v-code-skeleton aria-hidden="true">
+      {/* `shiki` class mirrors the real highlighted markup so shared styles
+          (e.g. code padding) apply identically and there is no layout shift. */}
+      <pre className="shiki" data-v-overflow-fade>
+        <code>
+          {lines.map((line, index) => {
+            const indent = line.length - line.trimStart().length
+            const length = line.trim().length
+            return (
+              // biome-ignore lint/suspicious/noArrayIndexKey: static, never reordered
+              <span className="line" key={index}>
+                {length > 0 && (
+                  <span
+                    data-v-skeleton-bar
+                    style={{
+                      marginLeft: `${indent}ch`,
+                      width: `${Math.min(length, 48)}ch`,
+                    }}
+                  />
+                )}
+              </span>
+            )
+          })}
+        </code>
+        <div data-v-overflow-sentinel />
+      </pre>
+    </div>
+  )
+}
+
+export namespace CodeToHtml {
+  export type Props = {
+    code: string
+    lang: string
+  }
+}
+
+let highlighterPromise:
+  | Promise<{
+      codeToHtml: (code: string, lang: string) => Promise<string>
+    }>
+  | undefined
+
+function getHighlighter() {
+  if (!highlighterPromise)
+    highlighterPromise = (async () => {
+      const { bundledLanguages, createHighlighter, hastToHtml } = await import('shiki/bundle/web')
+      const { codeHighlight } = config
+      const { langAlias = {}, themes } = codeHighlight
+      // Note: `langAlias` is intentionally not passed to the highlighter.
+      // Passing a custom `langAlias` registers languages under their alias name
+      // when lazily loaded (e.g. `loadLanguage('ts')` registers as `ts` instead
+      // of `typescript`), which then makes `codeToHast({ lang })` fail to resolve
+      // the grammar. We resolve aliases to their base language ourselves below.
+      const highlighter = await createHighlighter({
+        themes: Object.values(themes) as never,
+        langs: [],
+      })
+      return {
+        async codeToHtml(code: string, lang: string) {
+          const base = langAlias[lang] ?? lang
+          const resolvedLang = base in bundledLanguages ? base : 'txt'
+          if (!highlighter.getLoadedLanguages().includes(resolvedLang))
+            await highlighter.loadLanguage(resolvedLang as never)
+          const hast = highlighter.codeToHast(code, {
+            defaultColor: 'light-dark()',
+            lang: resolvedLang,
+            rootStyle: false,
+            meta: { 'data-v-overflow-fade': true },
+            themes,
+            transformers: [transformerShrinkIndent()],
+          })
+          const pre = hast.children[0]
+          if (pre && pre.type === 'element' && pre.tagName === 'pre')
+            pre.children.push({
+              type: 'element',
+              tagName: 'div',
+              properties: { 'data-v-overflow-sentinel': true },
+              children: [],
+            })
+          return hastToHtml(hast)
+        },
+      }
+    })()
+  return highlighterPromise
+}
+
+const cache = new Map<string, string>()
+
+function cacheKey(code: string, lang: string) {
+  return `${lang}\n${code}`
+}
+
+/** Returns the highlighted HTML for a snippet if it has already been computed. */
+export function getCached(code: string, lang: string) {
+  return cache.get(cacheKey(code, lang))
+}
+
+/** Highlights a snippet (memoized), loading the Shiki bundle on first use. */
+export async function highlight(code: string, lang: string) {
+  const key = cacheKey(code, lang)
+  const cached = cache.get(key)
+  if (cached !== undefined) return cached
+  const highlighter = await getHighlighter()
+  const html = await highlighter.codeToHtml(code, lang)
+  cache.set(key, html)
+  return html
+}
+
+/** Eagerly loads the Shiki bundle so the first real highlight is fast. */
+export function prewarm() {
+  void getHighlighter()
+}
+
+function transformerShrinkIndent() {
+  return {
+    name: 'indent',
+    span(hast: { children: { type: string; value?: string }[] }) {
+      const child = hast.children[0]
+      if (!child) return
+      if (child.type !== 'text') return
+      if (!child.value) return
+      hast.children[0] = { type: 'text', value: child.value.replace(/\s\s/g, ' ') }
+    },
+  }
+}

package/src/react/internal/CodeToHtml.tsx

@@ -1,74 +1 @@
-import { config } from 'virtual:vocs/config'
-import { langs as virtualLangs } from 'virtual:vocs/langs'
-import {
-  bundledLanguages,
-  createHighlighter,
-  hastToHtml,
-  makeSingletonHighlighter,
-  type ShikiTransformer,
-} from 'shiki/bundle/web'
-
-const getHighlighter = makeSingletonHighlighter(createHighlighter)
-
-export async function CodeToHtml(props: CodeToHtml.Props) {
-  const { code, lang } = props
-  const { codeHighlight } = config
-  const { langAlias = {}, themes } = codeHighlight
-
-  const highlighter = await getHighlighter({
-    themes: import.meta.env.DEV ? ['none'] : (Object.values(themes) as never),
-    langs: import.meta.env.DEV
-      ? ['txt']
-      : ([...Object.keys(bundledLanguages), ...virtualLangs] as never),
-    langAlias,
-  })
-
-  const loadedLangs = highlighter.getLoadedLanguages()
-  const resolvedLang = loadedLangs.includes(lang) ? lang : 'txt'
-
-  const hast = highlighter.codeToHast(code, {
-    defaultColor: 'light-dark()',
-    lang: import.meta.env.DEV ? 'txt' : resolvedLang,
-    rootStyle: false,
-    meta: {
-      'data-v-overflow-fade': true,
-    },
-    ...(import.meta.env.DEV ? { theme: 'none' } : { themes }),
-    transformers: [transformerShrinkIndent()],
-  })
-
-  // Add overflow sentinel
-  const pre = hast.children[0]
-  if (pre && pre.type === 'element' && pre.tagName === 'pre')
-    pre.children.push({
-      type: 'element',
-      tagName: 'div',
-      properties: { 'data-v-overflow-sentinel': true },
-      children: [],
-    })
-
-  const html = hastToHtml(hast)
-
-  // biome-ignore lint/security/noDangerouslySetInnerHtml: _
-  return <div dangerouslySetInnerHTML={{ __html: html }} />
-}
-
-export namespace CodeToHtml {
-  export type Props = {
-    code: string
-    lang: string
-  }
-}
-
-function transformerShrinkIndent(): ShikiTransformer {
-  return {
-    name: 'indent',
-    span(hast) {
-      const child = hast.children[0]
-      if (!child) return
-      if (child.type !== 'text') return
-      if (!child.value) return
-      hast.children[0] = { type: 'text', value: child.value.replace(/\s\s/g, ' ') }
-    },
-  }
-}
+export { CodeToHtml } from './CodeToHtml.client.js'

package/src/react/internal/TwoslashHover.client.tsx

@@ -2,7 +2,8 @@
 
 import { Popover } from '@base-ui/react/popover'
 import type * as React from 'react'
-import { useCallback } from 'react'
+import { useCallback, useEffect } from 'react'
+import { prewarm } from './CodeToHtml.client.js'
 
 export function TwoslashHover(props: TwoslashHover.Props) {
   const { className = '', children, trigger } = props
@@ -11,6 +12,12 @@ export function TwoslashHover(props: TwoslashHover.Props) {
 
   const open = className?.includes('twoslash-query-persisted')
 
+  // Warm the highlighter so the code inside the popup highlights as quickly as
+  // possible (the popup shows a skeleton placeholder until then).
+  useEffect(() => {
+    prewarm()
+  }, [])
+
   return (
     <Popover.Root {...(open ? { open } : {})}>
       <Popover.Trigger data-v-twoslash-trigger openOnHover delay={0}>

package/src/styles/twoslash.css

@@ -63,6 +63,38 @@
   }
 }
 
+[data-v-code-skeleton] [data-v-skeleton-bar] {
+  display: inline-block;
+  height: 0.72em;
+  vertical-align: middle;
+  border-radius: 0.1875rem;
+  background-color: var(--vocs-background-color-surfaceTint);
+  background-image: linear-gradient(
+    90deg,
+    transparent 0%,
+    color-mix(in srgb, var(--vocs-color-gray10) 22%, transparent) 50%,
+    transparent 100%
+  );
+  background-repeat: no-repeat;
+  background-size: 200% 100%;
+  animation: vocs-skeleton-shimmer 1.25s ease-in-out infinite;
+}
+
+@keyframes vocs-skeleton-shimmer {
+  from {
+    background-position: 180% 0;
+  }
+  to {
+    background-position: -80% 0;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  [data-v-code-skeleton] [data-v-skeleton-bar] {
+    animation: none;
+  }
+}
+
 .twoslash-popup-docs {
   @apply vocs:max-h-40 vocs:overflow-y-scroll;