@shikijs/core 1.18.0 → 1.20.0

package/dist/index.d.mts

@@ -1,10 +1,9 @@
-import { CreatedBundledHighlighterOptions, CreateHighlighterFactory, LanguageInput, ThemeInput, HighlighterCoreOptions, CodeToHastOptions, CodeToTokensOptions, TokensResult, RequireKeys, CodeToTokensBaseOptions, ThemedToken, CodeToTokensWithThemesOptions, ThemedTokenWithVariants, BundledHighlighterOptions, HighlighterGeneric, GrammarState, HighlighterCore, ShikiInternal, LoadWasmOptions, ShikiTransformerContextCommon, CodeToHastRenderOptions, ShikiTransformerContextSource, ThemeRegistrationResolved, TokenizeWithThemeOptions, ThemeRegistrationAny, ShikiTransformer, MaybeArray, PlainTextLanguage, SpecialLanguage, SpecialTheme, MaybeGetter, TokenStyles, Position } from '@shikijs/types';
+import { CreatedBundledHighlighterOptions, CreateHighlighterFactory, LanguageInput, ThemeInput, HighlighterCoreOptions, CodeToHastOptions, CodeToTokensOptions, TokensResult, RequireKeys, CodeToTokensBaseOptions, ThemedToken, CodeToTokensWithThemesOptions, ThemedTokenWithVariants, BundledHighlighterOptions, HighlighterGeneric, GrammarState, HighlighterCore, ShikiInternal, RegexEngine, LoadWasmOptions, ShikiTransformerContextCommon, CodeToHastRenderOptions, ShikiTransformerContextSource, ThemeRegistrationResolved, TokenizeWithThemeOptions, ThemeRegistrationAny, ThemeRegistration, ShikiTransformer, MaybeArray, PlainTextLanguage, SpecialLanguage, SpecialTheme, MaybeGetter, TokenStyles, Position } from '@shikijs/types';
 export * from '@shikijs/types';
 import { Root, Element } from 'hast';
-export { createJavaScriptRegexEngine, defaultJavaScriptRegexConstructor } from '@shikijs/engine-javascript';
+import { JavaScriptRegexEngineOptions } from '@shikijs/engine-javascript';
 import { IGrammar } from '@shikijs/vscode-textmate';
 export { FontStyle, EncodedTokenMetadata as StackElementMetadata } from '@shikijs/vscode-textmate';
-export { createWasmOnigEngine, loadWasm } from '@shikijs/engine-oniguruma';
 export { toHtml as hastToHtml } from 'hast-util-to-html';
 
 /**
@@ -21,7 +20,7 @@ export { toHtml as hastToHtml } from 'hast-util-to-html';
  *     nord: () => import('shiki/themes/nord.mjs'),
  *     // ...
  *   },
- *   engine: () => createWasmOnigEngine(), // or createJavaScriptRegexEngine()
+ *   engine: () => createOnigurumaEngine(), // or createJavaScriptRegexEngine()
  * })
  * ```
  *
@@ -123,10 +122,26 @@ declare function getShikiInternal(options?: HighlighterCoreOptions): Promise<Shi
 declare function createShikiInternalSync(options: HighlighterCoreOptions<true>): ShikiInternal;
 
 /**
- * Set the default wasm loader for `loadWasm`.
- * @internal
+ * @deprecated Import `createJavaScriptRegexEngine` from `@shikijs/engine-javascript` or `shiki/engine/javascript` instead.
+ */
+declare function createJavaScriptRegexEngine(options?: JavaScriptRegexEngineOptions): RegexEngine;
+/**
+ * @deprecated Import `defaultJavaScriptRegexConstructor` from `@shikijs/engine-javascript` or `shiki/engine/javascript` instead.
+ */
+declare function defaultJavaScriptRegexConstructor(pattern: string): RegExp;
+
+/**
+ * @deprecated Import `createOnigurumaEngine` from `@shikijs/engine-oniguruma` or `shiki/engine/oniguruma` instead.
+ */
+declare function createOnigurumaEngine(options?: LoadWasmOptions | null): Promise<RegexEngine>;
+/**
+ * @deprecated Import `createOnigurumaEngine` from `@shikijs/engine-oniguruma` or `shiki/engine/oniguruma` instead.
+ */
+declare function createWasmOnigEngine(options?: LoadWasmOptions | null): Promise<RegexEngine>;
+/**
+ * @deprecated Import `loadWasm` from `@shikijs/engine-oniguruma` or `shiki/engine/oniguruma` instead.
  */
-declare function setDefaultWasmLoader(_loader: LoadWasmOptions): void;
+declare function loadWasm(options: LoadWasmOptions): Promise<void>;
 
 declare function codeToHast(internal: ShikiInternal, code: string, options: CodeToHastOptions, transformerContext?: ShikiTransformerContextCommon): Root;
 declare function tokensToHast(tokens: ThemedToken[][], options: CodeToHastRenderOptions, transformerContext: ShikiTransformerContextSource): Root;
@@ -161,6 +176,39 @@ declare function codeToTokensWithThemes(internal: ShikiInternal, code: string, o
  */
 declare function normalizeTheme(rawTheme: ThemeRegistrationAny): ThemeRegistrationResolved;
 
+interface CssVariablesThemeOptions {
+    /**
+     * Theme name. Need to unique if multiple css variables themes are created
+     *
+     * @default 'css-variables'
+     */
+    name?: string;
+    /**
+     * Prefix for css variables
+     *
+     * @default '--shiki-'
+     */
+    variablePrefix?: string;
+    /**
+     * Default value for css variables, the key is without the prefix
+     *
+     * @example `{ 'token-comment': '#888' }` will generate `var(--shiki-token-comment, #888)` for comments
+     */
+    variableDefaults?: Record<string, string>;
+    /**
+     * Enable font style
+     *
+     * @default true
+     */
+    fontStyle?: boolean;
+}
+/**
+ * A factory function to create a css-variable-based theme
+ *
+ * @see https://shiki.style/guide/theme-colors#css-variables-theme
+ */
+declare function createCssVariablesTheme(options?: CssVariablesThemeOptions): ThemeRegistration;
+
 /**
  * A built-in transformer to add decorations to the highlighted code.
  */
@@ -219,7 +267,7 @@ declare function resolveColorReplacements(theme: ThemeRegistrationAny | string,
 declare function applyColorReplacements(color: string, replacements?: Record<string, string | undefined>): string;
 declare function applyColorReplacements(color?: string | undefined, replacements?: Record<string, string | undefined>): string | undefined;
 declare function getTokenStyleObject(token: TokenStyles): Record<string, string>;
-declare function stringifyTokenStyle(token: Record<string, string>): string;
+declare function stringifyTokenStyle(token: string | Record<string, string>): string;
 /**
  * Creates a converter between index and position in a code block.
  *
@@ -231,4 +279,17 @@ declare function createPositionConverter(code: string): {
     posToIndex: (line: number, character: number) => number;
 };
 
-export { type ShorthandsBundle, addClassToHast, applyColorReplacements, codeToHast, codeToHtml, codeToTokens, codeToTokensBase, codeToTokensWithThemes, createHighlighterCore, createHighlighterCoreSync, createPositionConverter, createShikiInternal, createShikiInternalSync, createSingletonShorthands, createdBundledHighlighter, getHighlighterCore, getShikiInternal, getSingletonHighlighterCore, getTokenStyleObject, isNoneTheme, isPlainLang, isSpecialLang, isSpecialTheme, makeSingletonHighlighter, makeSingletonHighlighterCore, normalizeGetter, normalizeTheme, resolveColorReplacements, setDefaultWasmLoader, splitLines, splitToken, splitTokens, stringifyTokenStyle, toArray, tokenizeAnsiWithTheme, tokenizeWithTheme, tokensToHast, transformerDecorations };
+/**
+ * Enable runtime warning for deprecated APIs, for the future versions of Shiki.
+ *
+ * Disabled by default, will be enabled in Shiki v2.
+ *
+ * @experimental The accuracy of the warning messages is not yet guaranteed.
+ */
+declare function enableDeprecationWarnings(value?: boolean): void;
+/**
+ * @internal
+ */
+declare function warnDeprecated(message: string): void;
+
+export { type CssVariablesThemeOptions, type ShorthandsBundle, addClassToHast, applyColorReplacements, codeToHast, codeToHtml, codeToTokens, codeToTokensBase, codeToTokensWithThemes, createCssVariablesTheme, createHighlighterCore, createHighlighterCoreSync, createJavaScriptRegexEngine, createOnigurumaEngine, createPositionConverter, createShikiInternal, createShikiInternalSync, createSingletonShorthands, createWasmOnigEngine, createdBundledHighlighter, defaultJavaScriptRegexConstructor, enableDeprecationWarnings, getHighlighterCore, getShikiInternal, getSingletonHighlighterCore, getTokenStyleObject, isNoneTheme, isPlainLang, isSpecialLang, isSpecialTheme, loadWasm, makeSingletonHighlighter, makeSingletonHighlighterCore, normalizeGetter, normalizeTheme, resolveColorReplacements, splitLines, splitToken, splitTokens, stringifyTokenStyle, toArray, tokenizeAnsiWithTheme, tokenizeWithTheme, tokensToHast, transformerDecorations, warnDeprecated };

package/dist/index.d.ts

@@ -1,10 +1,9 @@
-import { CreatedBundledHighlighterOptions, CreateHighlighterFactory, LanguageInput, ThemeInput, HighlighterCoreOptions, CodeToHastOptions, CodeToTokensOptions, TokensResult, RequireKeys, CodeToTokensBaseOptions, ThemedToken, CodeToTokensWithThemesOptions, ThemedTokenWithVariants, BundledHighlighterOptions, HighlighterGeneric, GrammarState, HighlighterCore, ShikiInternal, LoadWasmOptions, ShikiTransformerContextCommon, CodeToHastRenderOptions, ShikiTransformerContextSource, ThemeRegistrationResolved, TokenizeWithThemeOptions, ThemeRegistrationAny, ShikiTransformer, MaybeArray, PlainTextLanguage, SpecialLanguage, SpecialTheme, MaybeGetter, TokenStyles, Position } from '@shikijs/types';
+import { CreatedBundledHighlighterOptions, CreateHighlighterFactory, LanguageInput, ThemeInput, HighlighterCoreOptions, CodeToHastOptions, CodeToTokensOptions, TokensResult, RequireKeys, CodeToTokensBaseOptions, ThemedToken, CodeToTokensWithThemesOptions, ThemedTokenWithVariants, BundledHighlighterOptions, HighlighterGeneric, GrammarState, HighlighterCore, ShikiInternal, RegexEngine, LoadWasmOptions, ShikiTransformerContextCommon, CodeToHastRenderOptions, ShikiTransformerContextSource, ThemeRegistrationResolved, TokenizeWithThemeOptions, ThemeRegistrationAny, ThemeRegistration, ShikiTransformer, MaybeArray, PlainTextLanguage, SpecialLanguage, SpecialTheme, MaybeGetter, TokenStyles, Position } from '@shikijs/types';
 export * from '@shikijs/types';
 import { Root, Element } from 'hast';
-export { createJavaScriptRegexEngine, defaultJavaScriptRegexConstructor } from '@shikijs/engine-javascript';
+import { JavaScriptRegexEngineOptions } from '@shikijs/engine-javascript';
 import { IGrammar } from '@shikijs/vscode-textmate';
 export { FontStyle, EncodedTokenMetadata as StackElementMetadata } from '@shikijs/vscode-textmate';
-export { createWasmOnigEngine, loadWasm } from '@shikijs/engine-oniguruma';
 export { toHtml as hastToHtml } from 'hast-util-to-html';
 
 /**
@@ -21,7 +20,7 @@ export { toHtml as hastToHtml } from 'hast-util-to-html';
  *     nord: () => import('shiki/themes/nord.mjs'),
  *     // ...
  *   },
- *   engine: () => createWasmOnigEngine(), // or createJavaScriptRegexEngine()
+ *   engine: () => createOnigurumaEngine(), // or createJavaScriptRegexEngine()
  * })
  * ```
  *
@@ -123,10 +122,26 @@ declare function getShikiInternal(options?: HighlighterCoreOptions): Promise<Shi
 declare function createShikiInternalSync(options: HighlighterCoreOptions<true>): ShikiInternal;
 
 /**
- * Set the default wasm loader for `loadWasm`.
- * @internal
+ * @deprecated Import `createJavaScriptRegexEngine` from `@shikijs/engine-javascript` or `shiki/engine/javascript` instead.
+ */
+declare function createJavaScriptRegexEngine(options?: JavaScriptRegexEngineOptions): RegexEngine;
+/**
+ * @deprecated Import `defaultJavaScriptRegexConstructor` from `@shikijs/engine-javascript` or `shiki/engine/javascript` instead.
+ */
+declare function defaultJavaScriptRegexConstructor(pattern: string): RegExp;
+
+/**
+ * @deprecated Import `createOnigurumaEngine` from `@shikijs/engine-oniguruma` or `shiki/engine/oniguruma` instead.
+ */
+declare function createOnigurumaEngine(options?: LoadWasmOptions | null): Promise<RegexEngine>;
+/**
+ * @deprecated Import `createOnigurumaEngine` from `@shikijs/engine-oniguruma` or `shiki/engine/oniguruma` instead.
+ */
+declare function createWasmOnigEngine(options?: LoadWasmOptions | null): Promise<RegexEngine>;
+/**
+ * @deprecated Import `loadWasm` from `@shikijs/engine-oniguruma` or `shiki/engine/oniguruma` instead.
  */
-declare function setDefaultWasmLoader(_loader: LoadWasmOptions): void;
+declare function loadWasm(options: LoadWasmOptions): Promise<void>;
 
 declare function codeToHast(internal: ShikiInternal, code: string, options: CodeToHastOptions, transformerContext?: ShikiTransformerContextCommon): Root;
 declare function tokensToHast(tokens: ThemedToken[][], options: CodeToHastRenderOptions, transformerContext: ShikiTransformerContextSource): Root;
@@ -161,6 +176,39 @@ declare function codeToTokensWithThemes(internal: ShikiInternal, code: string, o
  */
 declare function normalizeTheme(rawTheme: ThemeRegistrationAny): ThemeRegistrationResolved;
 
+interface CssVariablesThemeOptions {
+    /**
+     * Theme name. Need to unique if multiple css variables themes are created
+     *
+     * @default 'css-variables'
+     */
+    name?: string;
+    /**
+     * Prefix for css variables
+     *
+     * @default '--shiki-'
+     */
+    variablePrefix?: string;
+    /**
+     * Default value for css variables, the key is without the prefix
+     *
+     * @example `{ 'token-comment': '#888' }` will generate `var(--shiki-token-comment, #888)` for comments
+     */
+    variableDefaults?: Record<string, string>;
+    /**
+     * Enable font style
+     *
+     * @default true
+     */
+    fontStyle?: boolean;
+}
+/**
+ * A factory function to create a css-variable-based theme
+ *
+ * @see https://shiki.style/guide/theme-colors#css-variables-theme
+ */
+declare function createCssVariablesTheme(options?: CssVariablesThemeOptions): ThemeRegistration;
+
 /**
  * A built-in transformer to add decorations to the highlighted code.
  */
@@ -219,7 +267,7 @@ declare function resolveColorReplacements(theme: ThemeRegistrationAny | string,
 declare function applyColorReplacements(color: string, replacements?: Record<string, string | undefined>): string;
 declare function applyColorReplacements(color?: string | undefined, replacements?: Record<string, string | undefined>): string | undefined;
 declare function getTokenStyleObject(token: TokenStyles): Record<string, string>;
-declare function stringifyTokenStyle(token: Record<string, string>): string;
+declare function stringifyTokenStyle(token: string | Record<string, string>): string;
 /**
  * Creates a converter between index and position in a code block.
  *
@@ -231,4 +279,17 @@ declare function createPositionConverter(code: string): {
     posToIndex: (line: number, character: number) => number;
 };
 
-export { type ShorthandsBundle, addClassToHast, applyColorReplacements, codeToHast, codeToHtml, codeToTokens, codeToTokensBase, codeToTokensWithThemes, createHighlighterCore, createHighlighterCoreSync, createPositionConverter, createShikiInternal, createShikiInternalSync, createSingletonShorthands, createdBundledHighlighter, getHighlighterCore, getShikiInternal, getSingletonHighlighterCore, getTokenStyleObject, isNoneTheme, isPlainLang, isSpecialLang, isSpecialTheme, makeSingletonHighlighter, makeSingletonHighlighterCore, normalizeGetter, normalizeTheme, resolveColorReplacements, setDefaultWasmLoader, splitLines, splitToken, splitTokens, stringifyTokenStyle, toArray, tokenizeAnsiWithTheme, tokenizeWithTheme, tokensToHast, transformerDecorations };
+/**
+ * Enable runtime warning for deprecated APIs, for the future versions of Shiki.
+ *
+ * Disabled by default, will be enabled in Shiki v2.
+ *
+ * @experimental The accuracy of the warning messages is not yet guaranteed.
+ */
+declare function enableDeprecationWarnings(value?: boolean): void;
+/**
+ * @internal
+ */
+declare function warnDeprecated(message: string): void;
+
+export { type CssVariablesThemeOptions, type ShorthandsBundle, addClassToHast, applyColorReplacements, codeToHast, codeToHtml, codeToTokens, codeToTokensBase, codeToTokensWithThemes, createCssVariablesTheme, createHighlighterCore, createHighlighterCoreSync, createJavaScriptRegexEngine, createOnigurumaEngine, createPositionConverter, createShikiInternal, createShikiInternalSync, createSingletonShorthands, createWasmOnigEngine, createdBundledHighlighter, defaultJavaScriptRegexConstructor, enableDeprecationWarnings, getHighlighterCore, getShikiInternal, getSingletonHighlighterCore, getTokenStyleObject, isNoneTheme, isPlainLang, isSpecialLang, isSpecialTheme, loadWasm, makeSingletonHighlighter, makeSingletonHighlighterCore, normalizeGetter, normalizeTheme, resolveColorReplacements, splitLines, splitToken, splitTokens, stringifyTokenStyle, toArray, tokenizeAnsiWithTheme, tokenizeWithTheme, tokensToHast, transformerDecorations, warnDeprecated };

package/dist/index.mjs

@@ -1,19 +1,25 @@
 import { ShikiError as ShikiError$1 } from '@shikijs/types';
 export * from '@shikijs/types';
+import { createOnigurumaEngine as createOnigurumaEngine$1, loadWasm as loadWasm$1, getDefaultWasmLoader } from '@shikijs/engine-oniguruma';
+import { w as warnDeprecated } from './shared/core.afb6276c.mjs';
+export { e as enableDeprecationWarnings } from './shared/core.afb6276c.mjs';
 import { FontStyle, INITIAL, EncodedTokenMetadata, Registry as Registry$1, Theme } from '@shikijs/vscode-textmate';
 export { FontStyle, EncodedTokenMetadata as StackElementMetadata } from '@shikijs/vscode-textmate';
 import { toHtml } from 'hast-util-to-html';
 export { toHtml as hastToHtml } from 'hast-util-to-html';
-import { createWasmOnigEngine } from '@shikijs/engine-oniguruma';
-export { createWasmOnigEngine, loadWasm } from '@shikijs/engine-oniguruma';
-export { createJavaScriptRegexEngine, defaultJavaScriptRegexConstructor } from '@shikijs/engine-javascript';
+import { createJavaScriptRegexEngine as createJavaScriptRegexEngine$1, defaultJavaScriptRegexConstructor as defaultJavaScriptRegexConstructor$1 } from '@shikijs/engine-javascript';
 
-let _defaultWasmLoader;
-function setDefaultWasmLoader(_loader) {
-  _defaultWasmLoader = _loader;
+function createOnigurumaEngine(options) {
+  warnDeprecated("import `createOnigurumaEngine` from `@shikijs/engine-oniguruma` or `shiki/engine/oniguruma` instead");
+  return createOnigurumaEngine$1(options);
 }
-function getDefaultWasmLoader() {
-  return _defaultWasmLoader;
+function createWasmOnigEngine(options) {
+  warnDeprecated("import `createOnigurumaEngine` from `@shikijs/engine-oniguruma` or `shiki/engine/oniguruma` instead");
+  return createOnigurumaEngine$1(options);
+}
+function loadWasm(options) {
+  warnDeprecated("import `loadWasm` from `@shikijs/engine-oniguruma` or `shiki/engine/oniguruma` instead");
+  return loadWasm$1(options);
 }
 
 function toArray(x) {
@@ -131,6 +137,8 @@ function getTokenStyleObject(token) {
   return styles;
 }
 function stringifyTokenStyle(token) {
+  if (typeof token === "string")
+    return token;
   return Object.entries(token).map(([key, value]) => `${key}:${value}`).join(";");
 }
 function createPositionConverter(code) {
@@ -1039,23 +1047,20 @@ function mergeToken(merged, variantsOrder, cssVariablePrefix, defaultColor) {
   };
   const styles = variantsOrder.map((t) => getTokenStyleObject(merged.variants[t]));
   const styleKeys = new Set(styles.flatMap((t) => Object.keys(t)));
-  const mergedStyles = styles.reduce((acc, cur, idx) => {
+  const mergedStyles = {};
+  styles.forEach((cur, idx) => {
     for (const key of styleKeys) {
       const value = cur[key] || "inherit";
       if (idx === 0 && defaultColor) {
-        acc[key] = value;
+        mergedStyles[key] = value;
       } else {
         const keyName = key === "color" ? "" : key === "background-color" ? "-bg" : `-${key}`;
         const varKey = cssVariablePrefix + variantsOrder[idx] + (key === "color" ? "" : keyName);
-        if (acc[key])
-          acc[key] += `;${varKey}:${value}`;
-        else
-          acc[key] = `${varKey}:${value}`;
+        mergedStyles[varKey] = value;
       }
     }
-    return acc;
-  }, {});
-  token.htmlStyle = defaultColor ? stringifyTokenStyle(mergedStyles) : Object.values(mergedStyles).join(";");
+  });
+  token.htmlStyle = mergedStyles;
   return token;
 }
 
@@ -1181,14 +1186,18 @@ function tokensToHast(tokens, options, transformerContext) {
       let tokenNode = {
         type: "element",
         tagName: "span",
-        properties: {},
+        properties: {
+          ...token.htmlAttrs
+        },
         children: [{ type: "text", value: token.content }]
       };
-      const style = token.htmlStyle || stringifyTokenStyle(getTokenStyleObject(token));
+      if (typeof token.htmlStyle === "string")
+        warnDeprecated("`htmlStyle` as a string is deprecated. Use an object instead.");
+      const style = stringifyTokenStyle(token.htmlStyle || getTokenStyleObject(token));
       if (style)
         tokenNode.properties.style = style;
       for (const transformer of transformers)
-        tokenNode = transformer?.span?.call(context, tokenNode, idx + 1, col, lineNode) || tokenNode;
+        tokenNode = transformer?.span?.call(context, tokenNode, idx + 1, col, lineNode, token) || tokenNode;
       if (structure === "inline")
         root.children.push(tokenNode);
       else if (structure === "classic")
@@ -1694,6 +1703,9 @@ function createShikiInternalSync(options) {
 }
 
 async function createShikiInternal(options = {}) {
+  if (options.loadWasm) {
+    warnDeprecated("`loadWasm` option is deprecated. Use `engine: createOnigurumaEngine(loadWasm)` instead.");
+  }
   const [
     themes,
     langs,
@@ -1701,7 +1713,7 @@ async function createShikiInternal(options = {}) {
   ] = await Promise.all([
     resolveThemes(options.themes || []),
     resolveLangs(options.langs || []),
-    options.engine || createWasmOnigEngine(options.loadWasm || getDefaultWasmLoader())
+    options.engine || createOnigurumaEngine$1(options.loadWasm || getDefaultWasmLoader())
   ]);
   return createShikiInternalSync({
     ...options,
@@ -1712,6 +1724,7 @@ async function createShikiInternal(options = {}) {
   });
 }
 function getShikiInternal(options = {}) {
+  warnDeprecated("`getShikiInternal` is deprecated. Use `createShikiInternal` instead.");
   return createShikiInternal(options);
 }
 
@@ -1764,6 +1777,7 @@ function makeSingletonHighlighterCore(createHighlighter) {
 }
 const getSingletonHighlighterCore = /* @__PURE__ */ makeSingletonHighlighterCore(createHighlighterCore);
 function getHighlighterCore(options = {}) {
+  warnDeprecated("`getHighlighterCore` is deprecated. Use `createHighlighterCore` or `getSingletonHighlighterCore` instead.");
   return createHighlighterCore(options);
 }
 
@@ -1772,9 +1786,10 @@ function createdBundledHighlighter(arg1, arg2, arg3) {
   let bundledThemes;
   let engine;
   if (arg2) {
+    warnDeprecated("`createdBundledHighlighter` signature with `bundledLanguages` and `bundledThemes` is deprecated. Use the options object signature instead.");
     bundledLanguages = arg1;
     bundledThemes = arg2;
-    engine = () => createWasmOnigEngine(arg3);
+    engine = () => createOnigurumaEngine(arg3);
   } else {
     const options = arg1;
     bundledLanguages = options.langs;
@@ -1896,4 +1911,248 @@ function createSingletonShorthands(createHighlighter) {
   };
 }
 
-export { addClassToHast, applyColorReplacements, codeToHast, codeToHtml, codeToTokens, codeToTokensBase, codeToTokensWithThemes, createHighlighterCore, createHighlighterCoreSync, createPositionConverter, createShikiInternal, createShikiInternalSync, createSingletonShorthands, createdBundledHighlighter, getHighlighterCore, getShikiInternal, getSingletonHighlighterCore, getTokenStyleObject, isNoneTheme, isPlainLang, isSpecialLang, isSpecialTheme, makeSingletonHighlighter, makeSingletonHighlighterCore, normalizeGetter, normalizeTheme, resolveColorReplacements, setDefaultWasmLoader, splitLines, splitToken, splitTokens, stringifyTokenStyle, toArray, tokenizeAnsiWithTheme, tokenizeWithTheme, tokensToHast, transformerDecorations };
+function createJavaScriptRegexEngine(options) {
+  warnDeprecated("import `createJavaScriptRegexEngine` from `@shikijs/engine-javascript` or `shiki/engine/javascript` instead");
+  return createJavaScriptRegexEngine$1(options);
+}
+function defaultJavaScriptRegexConstructor(pattern) {
+  warnDeprecated("import `defaultJavaScriptRegexConstructor` from `@shikijs/engine-javascript` or `shiki/engine/javascript` instead");
+  return defaultJavaScriptRegexConstructor$1(pattern);
+}
+
+function createCssVariablesTheme(options = {}) {
+  const {
+    name = "css-variables",
+    variablePrefix = "--shiki-",
+    fontStyle = true
+  } = options;
+  const variable = (name2) => {
+    if (options.variableDefaults?.[name2])
+      return `var(${variablePrefix}${name2}, ${options.variableDefaults[name2]})`;
+    return `var(${variablePrefix}${name2})`;
+  };
+  const theme = {
+    name,
+    type: "dark",
+    colors: {
+      "editor.foreground": variable("foreground"),
+      "editor.background": variable("background"),
+      "terminal.ansiBlack": variable("ansi-black"),
+      "terminal.ansiRed": variable("ansi-red"),
+      "terminal.ansiGreen": variable("ansi-green"),
+      "terminal.ansiYellow": variable("ansi-yellow"),
+      "terminal.ansiBlue": variable("ansi-blue"),
+      "terminal.ansiMagenta": variable("ansi-magenta"),
+      "terminal.ansiCyan": variable("ansi-cyan"),
+      "terminal.ansiWhite": variable("ansi-white"),
+      "terminal.ansiBrightBlack": variable("ansi-bright-black"),
+      "terminal.ansiBrightRed": variable("ansi-bright-red"),
+      "terminal.ansiBrightGreen": variable("ansi-bright-green"),
+      "terminal.ansiBrightYellow": variable("ansi-bright-yellow"),
+      "terminal.ansiBrightBlue": variable("ansi-bright-blue"),
+      "terminal.ansiBrightMagenta": variable("ansi-bright-magenta"),
+      "terminal.ansiBrightCyan": variable("ansi-bright-cyan"),
+      "terminal.ansiBrightWhite": variable("ansi-bright-white")
+    },
+    tokenColors: [
+      {
+        scope: [
+          "keyword.operator.accessor",
+          "meta.group.braces.round.function.arguments",
+          "meta.template.expression",
+          "markup.fenced_code meta.embedded.block"
+        ],
+        settings: {
+          foreground: variable("foreground")
+        }
+      },
+      {
+        scope: "emphasis",
+        settings: {
+          fontStyle: "italic"
+        }
+      },
+      {
+        scope: ["strong", "markup.heading.markdown", "markup.bold.markdown"],
+        settings: {
+          fontStyle: "bold"
+        }
+      },
+      {
+        scope: ["markup.italic.markdown"],
+        settings: {
+          fontStyle: "italic"
+        }
+      },
+      {
+        scope: "meta.link.inline.markdown",
+        settings: {
+          fontStyle: "underline",
+          foreground: variable("token-link")
+        }
+      },
+      {
+        scope: ["string", "markup.fenced_code", "markup.inline"],
+        settings: {
+          foreground: variable("token-string")
+        }
+      },
+      {
+        scope: ["comment", "string.quoted.docstring.multi"],
+        settings: {
+          foreground: variable("token-comment")
+        }
+      },
+      {
+        scope: [
+          "constant.numeric",
+          "constant.language",
+          "constant.other.placeholder",
+          "constant.character.format.placeholder",
+          "variable.language.this",
+          "variable.other.object",
+          "variable.other.class",
+          "variable.other.constant",
+          "meta.property-name",
+          "meta.property-value",
+          "support"
+        ],
+        settings: {
+          foreground: variable("token-constant")
+        }
+      },
+      {
+        scope: [
+          "keyword",
+          "storage.modifier",
+          "storage.type",
+          "storage.control.clojure",
+          "entity.name.function.clojure",
+          "entity.name.tag.yaml",
+          "support.function.node",
+          "support.type.property-name.json",
+          "punctuation.separator.key-value",
+          "punctuation.definition.template-expression"
+        ],
+        settings: {
+          foreground: variable("token-keyword")
+        }
+      },
+      {
+        scope: "variable.parameter.function",
+        settings: {
+          foreground: variable("token-parameter")
+        }
+      },
+      {
+        scope: [
+          "support.function",
+          "entity.name.type",
+          "entity.other.inherited-class",
+          "meta.function-call",
+          "meta.instance.constructor",
+          "entity.other.attribute-name",
+          "entity.name.function",
+          "constant.keyword.clojure"
+        ],
+        settings: {
+          foreground: variable("token-function")
+        }
+      },
+      {
+        scope: [
+          "entity.name.tag",
+          "string.quoted",
+          "string.regexp",
+          "string.interpolated",
+          "string.template",
+          "string.unquoted.plain.out.yaml",
+          "keyword.other.template"
+        ],
+        settings: {
+          foreground: variable("token-string-expression")
+        }
+      },
+      {
+        scope: [
+          "punctuation.definition.arguments",
+          "punctuation.definition.dict",
+          "punctuation.separator",
+          "meta.function-call.arguments"
+        ],
+        settings: {
+          foreground: variable("token-punctuation")
+        }
+      },
+      {
+        // [Custom] Markdown links
+        scope: [
+          "markup.underline.link",
+          "punctuation.definition.metadata.markdown"
+        ],
+        settings: {
+          foreground: variable("token-link")
+        }
+      },
+      {
+        // [Custom] Markdown list
+        scope: ["beginning.punctuation.definition.list.markdown"],
+        settings: {
+          foreground: variable("token-string")
+        }
+      },
+      {
+        // [Custom] Markdown punctuation definition brackets
+        scope: [
+          "punctuation.definition.string.begin.markdown",
+          "punctuation.definition.string.end.markdown",
+          "string.other.link.title.markdown",
+          "string.other.link.description.markdown"
+        ],
+        settings: {
+          foreground: variable("token-keyword")
+        }
+      },
+      {
+        // [Custom] Diff
+        scope: [
+          "markup.inserted",
+          "meta.diff.header.to-file",
+          "punctuation.definition.inserted"
+        ],
+        settings: {
+          foreground: variable("token-inserted")
+        }
+      },
+      {
+        scope: [
+          "markup.deleted",
+          "meta.diff.header.from-file",
+          "punctuation.definition.deleted"
+        ],
+        settings: {
+          foreground: variable("token-deleted")
+        }
+      },
+      {
+        scope: [
+          "markup.changed",
+          "punctuation.definition.changed"
+        ],
+        settings: {
+          foreground: variable("token-changed")
+        }
+      }
+    ]
+  };
+  if (!fontStyle) {
+    theme.tokenColors = theme.tokenColors?.map((tokenColor) => {
+      if (tokenColor.settings?.fontStyle)
+        delete tokenColor.settings.fontStyle;
+      return tokenColor;
+    });
+  }
+  return theme;
+}
+
+export { addClassToHast, applyColorReplacements, codeToHast, codeToHtml, codeToTokens, codeToTokensBase, codeToTokensWithThemes, createCssVariablesTheme, createHighlighterCore, createHighlighterCoreSync, createJavaScriptRegexEngine, createOnigurumaEngine, createPositionConverter, createShikiInternal, createShikiInternalSync, createSingletonShorthands, createWasmOnigEngine, createdBundledHighlighter, defaultJavaScriptRegexConstructor, getHighlighterCore, getShikiInternal, getSingletonHighlighterCore, getTokenStyleObject, isNoneTheme, isPlainLang, isSpecialLang, isSpecialTheme, loadWasm, makeSingletonHighlighter, makeSingletonHighlighterCore, normalizeGetter, normalizeTheme, resolveColorReplacements, splitLines, splitToken, splitTokens, stringifyTokenStyle, toArray, tokenizeAnsiWithTheme, tokenizeWithTheme, tokensToHast, transformerDecorations, warnDeprecated };

package/dist/shared/core.afb6276c.mjs

@@ -0,0 +1,10 @@
+let emitDeprecation = false;
+function enableDeprecationWarnings(value = true) {
+  emitDeprecation = value;
+}
+function warnDeprecated(message) {
+  if (emitDeprecation)
+    console.trace(`[SHIKI DEPRECATE]: ${message}`);
+}
+
+export { enableDeprecationWarnings as e, warnDeprecated as w };

package/dist/wasm-inlined.mjs

@@ -1,2 +1,5 @@
+import { w as warnDeprecated } from './shared/core.afb6276c.mjs';
 export * from '@shikijs/engine-oniguruma/wasm-inlined';
 export { default } from '@shikijs/engine-oniguruma/wasm-inlined';
+
+warnDeprecated("Import from `@shikijs/engine-oniguruma/wasm-inlined` instead");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shikijs/core",
   "type": "module",
-  "version": "1.18.0",
+  "version": "1.20.0",
   "description": "Core of Shiki",
   "author": "Pine Wu <octref@gmail.com>; Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -63,9 +63,9 @@
     "@shikijs/vscode-textmate": "^9.2.2",
     "@types/hast": "^3.0.4",
     "hast-util-to-html": "^9.0.3",
-    "@shikijs/engine-oniguruma": "1.18.0",
-    "@shikijs/types": "1.18.0",
-    "@shikijs/engine-javascript": "1.18.0"
+    "@shikijs/engine-javascript": "1.20.0",
+    "@shikijs/engine-oniguruma": "1.20.0",
+    "@shikijs/types": "1.20.0"
   },
   "scripts": {
     "build": "unbuild",