@scalar/code-highlight 0.3.5 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @scalar/code-highlight
 
+## 0.4.0
+
+### Minor Changes
+
+- [#9590](https://github.com/scalar/scalar/pull/9590): Add syntax highlighting for the Mojo programming language
+
+## 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,
@@ -12644,6 +12686,104 @@ var curlLanguage = (hljs) => {
 	};
 };
 //#endregion
+//#region src/languages/mojo.ts
+/**
+* Mojo grammar.
+*
+* highlight.js does not ship a Mojo grammar and there is no community package
+* for it (the only upstream "mojo" grammar is the unrelated Perl Mojolicious
+* framework). We build one here. Mojo is a superset of Python, so we start from
+* the bundled Python grammar and layer on the extra keywords, argument-convention
+* modifiers, and standard-library types that Mojo adds. The keyword and type
+* lists mirror Modular's official TextMate grammar (github.com/modular/mojo-syntax).
+*
+* As with our custom Python grammar, we also colour call sites as function
+* titles so that API snippets, which are mostly method calls, do not render as a
+* wall of unstyled grey text.
+*/
+var mojo = (hljs) => {
+	const language = python$1(hljs);
+	const { regex } = hljs;
+	const IDENT_RE = /[\p{XID_Start}_]\p{XID_Continue}*/u;
+	const keywords = language.keywords;
+	const mojoKeywords = [
+		"fn",
+		"struct",
+		"trait",
+		"var",
+		"let",
+		"alias",
+		"comptime",
+		"owned",
+		"borrowed",
+		"inout",
+		"ref",
+		"mut",
+		"read",
+		"out",
+		"raises",
+		"capturing"
+	];
+	const mojoTypes = [
+		"Int",
+		"UInt",
+		"Int8",
+		"Int16",
+		"Int32",
+		"Int64",
+		"UInt8",
+		"UInt16",
+		"UInt32",
+		"UInt64",
+		"Float16",
+		"Float32",
+		"Float64",
+		"Bool",
+		"String",
+		"StringLiteral",
+		"StringSlice",
+		"SIMD",
+		"DType",
+		"Scalar",
+		"List",
+		"Dict",
+		"Set",
+		"Tuple",
+		"Optional",
+		"Variant",
+		"Span",
+		"Pointer",
+		"UnsafePointer",
+		"Reference",
+		"Error"
+	];
+	const dedupe = (...lists) => Array.from(new Set(lists.flat()));
+	const mergedKeywords = {
+		...keywords,
+		keyword: dedupe(keywords.keyword ?? [], mojoKeywords),
+		type: dedupe(keywords.type ?? [], mojoTypes)
+	};
+	const reserved = [
+		...mergedKeywords.keyword ?? [],
+		...keywords.built_in ?? [],
+		...keywords.literal ?? [],
+		...mergedKeywords.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(/\(/))
+	};
+	return {
+		...language,
+		name: "Mojo",
+		aliases: ["mojo", "🔥"],
+		keywords: mergedKeywords,
+		contains: [...language.contains ?? [], functionCall]
+	};
+};
+//#endregion
 //#region src/languages/standard.ts
 /**
 * We group languages into three categories based on their popularity and usage.
@@ -12692,6 +12832,7 @@ var standardLanguages = {
 	makefile,
 	markdown,
 	matlab,
+	mojo,
 	nginx,
 	objectivec,
 	ocaml,