@shikijs/core 1.28.0 → 1.29.1

package/dist/index.d.mts

@@ -278,17 +278,18 @@ declare function createPositionConverter(code: string): {
     posToIndex: (line: number, character: number) => number;
 };
 
+type DeprecationTarget = 3;
 /**
  * Enable runtime warning for deprecated APIs, for the future versions of Shiki.
  *
- * Disabled by default, will be enabled in Shiki v2.
+ * You can pass a major version to only warn for deprecations that will be removed in that version.
  *
- * @experimental The accuracy of the warning messages is not yet guaranteed.
+ * By default, deprecation warning is set to 3 since Shiki v2.0.0
  */
-declare function enableDeprecationWarnings(value?: boolean): void;
+declare function enableDeprecationWarnings(emitDeprecation?: DeprecationTarget | boolean, emitError?: boolean): void;
 /**
  * @internal
  */
-declare function warnDeprecated(message: string): void;
+declare function warnDeprecated(message: string, version?: DeprecationTarget): 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

@@ -278,17 +278,18 @@ declare function createPositionConverter(code: string): {
     posToIndex: (line: number, character: number) => number;
 };
 
+type DeprecationTarget = 3;
 /**
  * Enable runtime warning for deprecated APIs, for the future versions of Shiki.
  *
- * Disabled by default, will be enabled in Shiki v2.
+ * You can pass a major version to only warn for deprecations that will be removed in that version.
  *
- * @experimental The accuracy of the warning messages is not yet guaranteed.
+ * By default, deprecation warning is set to 3 since Shiki v2.0.0
  */
-declare function enableDeprecationWarnings(value?: boolean): void;
+declare function enableDeprecationWarnings(emitDeprecation?: DeprecationTarget | boolean, emitError?: boolean): void;
 /**
  * @internal
  */
-declare function warnDeprecated(message: string): void;
+declare function warnDeprecated(message: string, version?: DeprecationTarget): 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,8 +1,8 @@
 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.DVV8c4RZ.mjs';
-export { e as enableDeprecationWarnings } from './shared/core.DVV8c4RZ.mjs';
+import { w as warnDeprecated } from './shared/core.Bn_XU0Iv.mjs';
+export { e as enableDeprecationWarnings } from './shared/core.Bn_XU0Iv.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';
@@ -233,6 +233,7 @@ class GrammarState {
    * @deprecated use `getScopes` instead
    */
   get scopes() {
+    warnDeprecated("GrammarState.scopes is deprecated, use GrammarState.getScopes() instead");
     return getScopes(this._stacks[this.theme]);
   }
   getScopes(theme = this.theme) {

package/dist/shared/core.Bn_XU0Iv.mjs

@@ -0,0 +1,19 @@
+let _emitDeprecation = false;
+let _emitError = false;
+function enableDeprecationWarnings(emitDeprecation = true, emitError = false) {
+  _emitDeprecation = emitDeprecation;
+  _emitError = emitError;
+}
+function warnDeprecated(message, version = 3) {
+  if (!_emitDeprecation)
+    return;
+  if (typeof _emitDeprecation === "number" && version > _emitDeprecation)
+    return;
+  if (_emitError) {
+    throw new Error(`[SHIKI DEPRECATE]: ${message}`);
+  } else {
+    console.trace(`[SHIKI DEPRECATE]: ${message}`);
+  }
+}
+
+export { enableDeprecationWarnings as e, warnDeprecated as w };

package/dist/wasm-inlined.mjs

@@ -1,4 +1,4 @@
-import { w as warnDeprecated } from './shared/core.DVV8c4RZ.mjs';
+import { w as warnDeprecated } from './shared/core.Bn_XU0Iv.mjs';
 export * from '@shikijs/engine-oniguruma/wasm-inlined';
 export { default } from '@shikijs/engine-oniguruma/wasm-inlined';
 

package/package.json

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

package/dist/shared/core.DVV8c4RZ.mjs

@@ -1,10 +0,0 @@
-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 };