@scalar/code-highlight 0.3.5 → 0.3.6

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @scalar/code-highlight
 
+## 0.3.6
+
+### Patch Changes
+
+- [#9508](https://github.com/scalar/scalar/pull/9508): Fix Python code samples appearing mostly unstyled by highlighting function and method call sites
+- [#9506](https://github.com/scalar/scalar/pull/9506): Add Scalar scrollbar styling to highlighted Markdown code blocks.
+
 ## 0.3.5
 
 ### Patch Changes

package/dist/chunks/languages.js

@@ -8191,7 +8191,7 @@ function plaintext(hljs) {
 }
 //#endregion
 //#region ../../node_modules/.pnpm/highlight.js@11.11.1/node_modules/highlight.js/es/languages/python.js
-function python(hljs) {
+function python$1(hljs) {
 	const regex = hljs.regex;
 	const IDENT_RE = /[\p{XID_Start}_]\p{XID_Continue}*/u;
 	const RESERVED_WORDS = [
@@ -12540,6 +12540,48 @@ function yaml(hljs) {
 	};
 }
 //#endregion
+//#region src/languages/python.ts
+/**
+* Python grammar that extends highlight.js' bundled grammar with call-site
+* highlighting.
+*
+* The grammar shipped with highlight.js only scopes function and class
+* *definitions* (`def name`, `class Name`) plus a fixed list of built-ins. It
+* never scopes *call sites*, unlike the JavaScript, Go, and Ruby grammars which
+* colour every `.method()` as a function title. Because real-world API snippets
+* are almost entirely method calls (for example `conn.request(...)` or
+* `response.json()`), Python code rendered as a wall of unstyled grey text and
+* looked far less highlighted than other languages (DOC-5618).
+*
+* We add a single rule that colours any identifier immediately followed by `(`
+* as a function title, mirroring how highlight.js' own JavaScript grammar
+* handles this. Reserved words and the grammar's known built-ins, literals, and
+* types are excluded so they keep their existing scopes, and the leading word
+* boundary prevents the rule from matching the tail end of an excluded word.
+*/
+var python = (hljs) => {
+	const language = python$1(hljs);
+	const { regex } = hljs;
+	const IDENT_RE = /[\p{XID_Start}_]\p{XID_Continue}*/u;
+	const keywords = language.keywords;
+	const reserved = [
+		...keywords.keyword ?? [],
+		...keywords.built_in ?? [],
+		...keywords.literal ?? [],
+		...keywords.type ?? []
+	].map((word) => word.replace(/\|\d+$/, ""));
+	const notReserved = regex.concat("(?!(?:", reserved.join("|"), ")\\b)");
+	const functionCall = {
+		scope: "title.function",
+		relevance: 0,
+		match: regex.concat(/\b/, notReserved, IDENT_RE, regex.lookahead(/\s*\(/))
+	};
+	return {
+		...language,
+		contains: [...language.contains ?? [], functionCall]
+	};
+};
+//#endregion
 //#region src/languages/basic.ts
 var basicLanguages = {
 	bash,