@fuzdev/fuz_code 0.45.0 → 0.46.0

package/README.md

@@ -2,7 +2,7 @@
 
 [<img src="static/logo.svg" alt="a friendly pink spider facing you" align="right" width="192" height="192">](https://code.fuz.dev/)
 
-> syntax styling utilities and components for TypeScript, Svelte, and Markdown 🎨
+> syntax styling utilities and components for TypeScript, Svelte, Markdown, and more 🎨
 
 **[code.fuz.dev](https://code.fuz.dev/)**
 
@@ -116,6 +116,7 @@ Enabled by default in `syntax_styler_global`:
 - [`js`](src/lib/grammar_js.ts)
 - [`json`](src/lib/grammar_json.ts)
 - [`clike`](src/lib/grammar_clike.ts)
+- [`bash`](src/lib/grammar_bash.ts)
 
 ### More
 

package/dist/Code.svelte

@@ -55,7 +55,7 @@
 			 */
 			lang?: string | null;
 			/**
-			 * Optional custom grammar object for syntax tokenization.
+			 * Optional custom `SyntaxGrammar` object for syntax tokenization.
 			 *
 			 * **When to use:**
 			 * - To provide a custom language definition not registered in `syntax_styler.langs`
@@ -100,7 +100,7 @@
 			 */
 			nomargin?: boolean;
 			/**
-			 * Custom SyntaxStyler instance to use for highlighting.
+			 * Custom `SyntaxStyler` instance to use for highlighting.
 			 * Allows using a different styler with custom grammars or configuration.
 			 *
 			 * @default syntax_styler_global

package/dist/Code.svelte.d.ts

@@ -35,7 +35,7 @@ type $$ComponentProps = SvelteHTMLElements['code'] & ({
      */
     lang?: string | null;
     /**
-     * Optional custom grammar object for syntax tokenization.
+     * Optional custom `SyntaxGrammar` object for syntax tokenization.
      *
      * **When to use:**
      * - To provide a custom language definition not registered in `syntax_styler.langs`
@@ -80,7 +80,7 @@ type $$ComponentProps = SvelteHTMLElements['code'] & ({
      */
     nomargin?: boolean;
     /**
-     * Custom SyntaxStyler instance to use for highlighting.
+     * Custom `SyntaxStyler` instance to use for highlighting.
      * Allows using a different styler with custom grammars or configuration.
      *
      * @default syntax_styler_global

package/dist/CodeHighlight.svelte

@@ -3,7 +3,7 @@
 	 * Uses the CSS Custom Highlight API when available --
 	 * https://developer.mozilla.org/en-US/docs/Web/API/CSS_Custom_Highlight_API
 	 *
-	 * Requires importing theme_highlight.css instead of theme.css.
+	 * Requires importing `theme_highlight.css` instead of `theme.css`.
 	 */
 
 	import {onDestroy, type Snippet} from 'svelte';
@@ -65,7 +65,7 @@
 		 */
 		mode?: HighlightMode;
 		/**
-		 * Optional custom grammar object for syntax tokenization.
+		 * Optional custom `SyntaxGrammar` object for syntax tokenization.
 		 *
 		 * **When to use:**
 		 * - To provide a custom language definition not registered in `syntax_styler.langs`
@@ -103,7 +103,7 @@
 		 */
 		wrap?: boolean;
 		/**
-		 * Custom SyntaxStyler instance to use for highlighting.
+		 * Custom `SyntaxStyler` instance to use for highlighting.
 		 * Allows using a different styler with custom grammars or configuration.
 		 *
 		 * @default syntax_styler_global
@@ -117,7 +117,7 @@
 		children?: Snippet<[markup: string]>;
 	} = $props();
 
-	let code_element: HTMLElement | undefined = $state();
+	let code_element: HTMLElement | undefined = $state.raw();
 
 	const supports_ranges = supports_css_highlight_api();
 

package/dist/CodeHighlight.svelte.d.ts

@@ -2,7 +2,7 @@
      * Uses the CSS Custom Highlight API when available --
      * https://developer.mozilla.org/en-US/docs/Web/API/CSS_Custom_Highlight_API
      *
-     * Requires importing theme_highlight.css instead of theme.css.
+     * Requires importing `theme_highlight.css` instead of `theme.css`.
      */
 import { type Snippet } from 'svelte';
 import type { SvelteHTMLElements } from 'svelte/elements';
@@ -44,7 +44,7 @@ type $$ComponentProps = SvelteHTMLElements['code'] & {
      */
     mode?: HighlightMode;
     /**
-     * Optional custom grammar object for syntax tokenization.
+     * Optional custom `SyntaxGrammar` object for syntax tokenization.
      *
      * **When to use:**
      * - To provide a custom language definition not registered in `syntax_styler.langs`
@@ -82,7 +82,7 @@ type $$ComponentProps = SvelteHTMLElements['code'] & {
      */
     wrap?: boolean;
     /**
-     * Custom SyntaxStyler instance to use for highlighting.
+     * Custom `SyntaxStyler` instance to use for highlighting.
      * Allows using a different styler with custom grammars or configuration.
      *
      * @default syntax_styler_global

package/dist/code_sample.d.ts

@@ -3,6 +3,6 @@ export interface CodeSample {
     lang: string;
     content: string;
 }
-export declare const sample_langs: readonly ["json", "css", "ts", "html", "svelte", "md"];
+export declare const sample_langs: readonly ["json", "css", "ts", "html", "svelte", "md", "bash"];
 export type SampleLang = (typeof sample_langs)[number];
 //# sourceMappingURL=code_sample.d.ts.map

package/dist/code_sample.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code_sample.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/code_sample.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAGD,eAAO,MAAM,YAAY,wDAAyD,CAAC;AAEnF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"code_sample.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/code_sample.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAGD,eAAO,MAAM,YAAY,gEAAiE,CAAC;AAE3F,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/code_sample.js

@@ -1,2 +1,2 @@
 // Languages ordered from simple to complex
-export const sample_langs = ['json', 'css', 'ts', 'html', 'svelte', 'md'];
+export const sample_langs = ['json', 'css', 'ts', 'html', 'svelte', 'md', 'bash'];

package/dist/grammar_bash.d.ts

@@ -0,0 +1,17 @@
+import type { AddSyntaxGrammar } from './syntax_styler.js';
+/**
+ * Bash/shell grammar for syntax highlighting.
+ *
+ * Standalone grammar (no base extension). Covers core bash syntax:
+ * comments, strings, variables, functions, keywords, builtins,
+ * operators, and redirections.
+ *
+ * Based on Prism (https://github.com/PrismJS/prism)
+ * by Lea Verou (https://lea.verou.me/)
+ *
+ * MIT license
+ *
+ * @see LICENSE
+ */
+export declare const add_grammar_bash: AddSyntaxGrammar;
+//# sourceMappingURL=grammar_bash.d.ts.map

package/dist/grammar_bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar_bash.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/grammar_bash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAmB,MAAM,oBAAoB,CAAC;AAE3E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,EAAE,gBA8J9B,CAAC"}

package/dist/grammar_bash.js

@@ -0,0 +1,153 @@
+/**
+ * Bash/shell grammar for syntax highlighting.
+ *
+ * Standalone grammar (no base extension). Covers core bash syntax:
+ * comments, strings, variables, functions, keywords, builtins,
+ * operators, and redirections.
+ *
+ * Based on Prism (https://github.com/PrismJS/prism)
+ * by Lea Verou (https://lea.verou.me/)
+ *
+ * MIT license
+ *
+ * @see LICENSE
+ */
+export const add_grammar_bash = (syntax_styler) => {
+    // Shared inside grammar for command substitution — `rest` wired after construction
+    const command_sub_inside = {
+        punctuation: /^\$\(|\)$/,
+    };
+    // Reusable balanced-paren pattern for $(...) — handles 2 levels of inner () nesting,
+    // which supports up to 3 levels of $() command substitution (4+ is vanishingly rare)
+    const command_sub_pattern = /\$\((?:[^()]*|\((?:[^()]*|\([^()]*\))*\))*\)/;
+    const grammar_bash = {
+        // Shebang at file start — matched before general comments
+        shebang: {
+            pattern: /^#!.*/,
+            alias: 'comment',
+        },
+        // Line comments — require whitespace or start-of-string before #
+        comment: {
+            pattern: /(^|\s)#.*/,
+            lookbehind: true,
+            greedy: true,
+        },
+        // Here-documents — must precede string to avoid delimiter consumption
+        heredoc: [
+            // Quoted delimiter (<<'DELIM' or <<"DELIM") — no expansion
+            {
+                pattern: /(^|[^<])<<-?\s*(?:['"])(\w+)(?:['"])[\t ]*\n[\s\S]*?\n[\t ]*\2(?=\s*$)/m,
+                lookbehind: true,
+                greedy: true,
+                alias: 'string',
+                inside: {
+                    // No `m` flag — `^` matches start-of-string (opening) and `$` matches
+                    // end-of-string (closing), so single-word content lines can't false-positive
+                    heredoc_delimiter: [
+                        {
+                            pattern: /^<<-?\s*(?:['"])\w+(?:['"])/,
+                            alias: 'punctuation',
+                        },
+                        {
+                            pattern: /\w+$/,
+                            alias: 'punctuation',
+                        },
+                    ],
+                },
+            },
+            // Unquoted delimiter (<<DELIM) — with variable/command expansion
+            {
+                pattern: /(^|[^<])<<-?\s*(\w+)[\t ]*\n[\s\S]*?\n[\t ]*\2(?=\s*$)/m,
+                lookbehind: true,
+                greedy: true,
+                alias: 'string',
+                inside: {
+                    heredoc_delimiter: [
+                        {
+                            pattern: /^<<-?\s*\w+/,
+                            alias: 'punctuation',
+                        },
+                        {
+                            pattern: /\w+$/,
+                            alias: 'punctuation',
+                        },
+                    ],
+                    command_substitution: {
+                        pattern: command_sub_pattern,
+                        greedy: true,
+                        inside: command_sub_inside,
+                    },
+                    variable: /\$\{[^}]+\}|\$(?:\w+|[!@#$*?\-0-9])/,
+                },
+            },
+        ],
+        // Strings — three variants
+        string: [
+            // Double-quoted: supports escape sequences, variable interpolation, command substitution
+            {
+                pattern: /(^|[^\\](?:\\\\)*)"(?:\\[\s\S]|\$\((?:[^()]*|\((?:[^()]*|\([^()]*\))*\))*\)|\$(?!\()|[^"\\$])*"/,
+                lookbehind: true,
+                greedy: true,
+                inside: {
+                    command_substitution: {
+                        pattern: command_sub_pattern,
+                        greedy: true,
+                        inside: command_sub_inside,
+                    },
+                    variable: /\$\{[^}]+\}|\$(?:\w+|[!@#$*?\-0-9])/,
+                },
+            },
+            // Single-quoted: completely literal
+            {
+                pattern: /(^|[^\\](?:\\\\)*)'[^']*'/,
+                lookbehind: true,
+                greedy: true,
+            },
+            // ANSI-C quoting: $'...' with C-style escapes
+            {
+                pattern: /\$'(?:[^'\\]|\\[\s\S])*'/,
+                greedy: true,
+            },
+        ],
+        // Command substitution $(...) — before variable since both start with $
+        command_substitution: {
+            pattern: command_sub_pattern,
+            greedy: true,
+            inside: command_sub_inside,
+        },
+        // Variables and parameter expansion
+        variable: /\$\{[^}]+\}|\$(?:\w+|[!@#$*?\-0-9])/,
+        // Function definitions — both styles
+        function: [
+            // function fname style
+            {
+                pattern: /(\bfunction\s+)\w+/,
+                lookbehind: true,
+            },
+            // fname() style
+            {
+                pattern: /\b\w+(?=\s*\(\s*\))/,
+            },
+        ],
+        // Shell keywords
+        keyword: /\b(?:if|then|else|elif|fi|for|while|until|do|done|case|esac|in|select|function|return|local|export|declare|typeset|readonly|unset|set|shift|trap|break|continue|coproc|time)\b/,
+        // Builtin commands
+        builtin: /\b(?:echo|printf|cd|pwd|read|test|source|eval|exec|exit|getopts|hash|type|ulimit|umask|wait|kill|jobs|bg|fg|disown|alias|unalias|command|shopt)\b/,
+        // Boolean commands
+        boolean: /\b(?:true|false)\b/,
+        // File descriptors before redirections — must precede number
+        file_descriptor: {
+            pattern: /\B&\d\b|\b\d(?=>>?|<)/,
+            alias: 'important',
+        },
+        // Numbers: hex, octal, base-N, decimal
+        number: /\b(?:0x[\da-fA-F]+|0[0-7]+|\d+#[\da-zA-Z]+|\d+)\b/,
+        // Operators — longest first
+        operator: /\|\||&&|;;|&>>?|<<<?|>>?|=~|[!=]=|[<>]|[|&!]/,
+        // Punctuation
+        punctuation: /[{}[\]();,]/,
+    };
+    // Wire circular reference so command substitutions get full bash highlighting
+    command_sub_inside.rest = grammar_bash;
+    syntax_styler.add_lang('bash', grammar_bash, ['sh', 'shell']);
+};

package/dist/grammar_markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grammar_markdown.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/grammar_markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAIhB,MAAM,oBAAoB,CAAC;AAsF5B;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,gBAgMlC,CAAC"}
+{"version":3,"file":"grammar_markdown.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/grammar_markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAIhB,MAAM,oBAAoB,CAAC;AAsF5B;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,gBAiMlC,CAAC"}

package/dist/grammar_markdown.js

@@ -1,5 +1,5 @@
 /**
- * Helper to create fenced code block pattern for a language
+ * Helper to create fenced code block pattern for a language.
  */
 const create_fence_pattern = (backticks, aliases, lang_id, syntax_styler) => {
     const aliases_pattern = aliases.join('|');
@@ -21,7 +21,7 @@ const create_fence_pattern = (backticks, aliases, lang_id, syntax_styler) => {
     };
 };
 /**
- * Helper to create catch-all fence pattern (unknown languages)
+ * Helper to create catch-all fence pattern (unknown languages).
  */
 const create_catchall_fence = (backticks) => {
     const pattern = new RegExp(`^${backticks}[^\\n\\r]*(?:\\r?\\n|\\r)[\\s\\S]*?^${backticks}$`, 'm');
@@ -38,7 +38,7 @@ const create_catchall_fence = (backticks) => {
     };
 };
 /**
- * Helper to create md self-reference placeholder pattern
+ * Helper to create md self-reference placeholder pattern.
  */
 const create_md_placeholder = (backticks) => {
     const pattern = new RegExp(`^${backticks}(?:md|markdown)[^\\n\\r]*(?:\\r?\\n|\\r)[\\s\\S]*?^${backticks}$`, 'm');
@@ -69,6 +69,7 @@ export const add_grammar_markdown = (syntax_styler) => {
         { aliases: ['html', 'markup'], id: 'markup' },
         { aliases: ['json'], id: 'json' },
         { aliases: ['svelte'], id: 'svelte' },
+        { aliases: ['bash', 'sh', 'shell'], id: 'bash' },
     ];
     // Fence types: higher counts first (for proper precedence in tokenization)
     const fence_types = [

package/dist/grammar_markup.d.ts

@@ -13,19 +13,20 @@ export declare const add_grammar_markup: AddSyntaxGrammar;
  *
  * An example of an inlined language is CSS with `<style>` tags.
  *
- * @param tag_name - The name of the tag that contains the inlined language. This name will be treated as
- * case insensitive.
- * @param lang - The language key.
+ * @param syntax_styler - the `SyntaxStyler` instance to modify
+ * @param tag_name - the name of the tag that contains the inlined language, treated as case insensitive
+ * @param lang - the language key
+ * @param inside_lang - the language to insert into, defaults to `'markup'`
  */
 export declare const grammar_markup_add_inlined: (syntax_styler: SyntaxStyler, tag_name: string, lang: string, inside_lang?: string) => void;
 /**
- * Adds an pattern to style languages embedded in HTML attributes.
+ * Adds a pattern to style languages embedded in HTML attributes.
  *
  * An example of an inlined language is CSS with `style` attributes.
  *
- * @param attr_name - The name of the tag that contains the inlined language. This name will be treated as
- * case insensitive.
- * @param lang - The language key.
+ * @param syntax_styler - the `SyntaxStyler` instance to modify
+ * @param attr_name - the name of the attribute that contains the inlined language, treated as case insensitive
+ * @param lang - the language key
  */
 export declare const grammar_markup_add_attribute: (syntax_styler: SyntaxStyler, attr_name: string, lang: string) => void;
 //# sourceMappingURL=grammar_markup.d.ts.map

package/dist/grammar_markup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grammar_markup.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/grammar_markup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EACZ,gBAAgB,EAIhB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBA6EhC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GACtC,eAAe,YAAY,EAC3B,UAAU,MAAM,EAChB,MAAM,MAAM,EACZ,oBAAsB,KACpB,IAmCF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,GACxC,eAAe,YAAY,EAC3B,WAAW,MAAM,EACjB,MAAM,MAAM,KACV,IAiEF,CAAC"}
+{"version":3,"file":"grammar_markup.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/grammar_markup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EACZ,gBAAgB,EAIhB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBA6EhC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,GACtC,eAAe,YAAY,EAC3B,UAAU,MAAM,EAChB,MAAM,MAAM,EACZ,oBAAsB,KACpB,IAmCF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,GACxC,eAAe,YAAY,EAC3B,WAAW,MAAM,EACjB,MAAM,MAAM,KACV,IAiEF,CAAC"}

package/dist/grammar_markup.js

@@ -86,9 +86,10 @@ export const add_grammar_markup = (syntax_styler) => {
  *
  * An example of an inlined language is CSS with `<style>` tags.
  *
- * @param tag_name - The name of the tag that contains the inlined language. This name will be treated as
- * case insensitive.
- * @param lang - The language key.
+ * @param syntax_styler - the `SyntaxStyler` instance to modify
+ * @param tag_name - the name of the tag that contains the inlined language, treated as case insensitive
+ * @param lang - the language key
+ * @param inside_lang - the language to insert into, defaults to `'markup'`
  */
 export const grammar_markup_add_inlined = (syntax_styler, tag_name, lang, inside_lang = 'markup') => {
     const lang_key = 'lang_' + lang;
@@ -120,13 +121,13 @@ export const grammar_markup_add_inlined = (syntax_styler, tag_name, lang, inside
     });
 };
 /**
- * Adds an pattern to style languages embedded in HTML attributes.
+ * Adds a pattern to style languages embedded in HTML attributes.
  *
  * An example of an inlined language is CSS with `style` attributes.
  *
- * @param attr_name - The name of the tag that contains the inlined language. This name will be treated as
- * case insensitive.
- * @param lang - The language key.
+ * @param syntax_styler - the `SyntaxStyler` instance to modify
+ * @param attr_name - the name of the attribute that contains the inlined language, treated as case insensitive
+ * @param lang - the language key
  */
 export const grammar_markup_add_attribute = (syntax_styler, attr_name, lang) => {
     // After normalization, grammar.tag is an array of SyntaxGrammarToken

package/dist/highlight_manager.d.ts

@@ -1,14 +1,14 @@
 import type { SyntaxTokenStream } from './syntax_token.js';
 export type HighlightMode = 'auto' | 'ranges' | 'html';
 /**
- * Check for CSS Highlights API support.
+ * Checks for CSS Highlights API support.
  */
 export declare const supports_css_highlight_api: () => boolean;
 /**
  * Manages CSS Custom Highlight API ranges for a single element.
  * Tracks ranges per element and only removes its own ranges when clearing.
  *
- * **Experimental** — limited browser support. Use `Code` for production.
+ * **Experimental** — limited browser support. Use `Code.svelte` for production.
  *
  * @example
  * ```ts
@@ -21,11 +21,11 @@ export declare class HighlightManager {
     element_ranges: Map<string, Array<Range>>;
     constructor();
     /**
-     * Highlight from syntax styler token stream.
+     * Highlights from a `SyntaxTokenStream` produced by `tokenize_syntax`.
      */
     highlight_from_syntax_tokens(element: Element, tokens: SyntaxTokenStream): void;
     /**
-     * Clear only this element's ranges from highlights.
+     * Clears only this element's ranges from highlights.
      */
     clear_element_ranges(): void;
     destroy(): void;

package/dist/highlight_manager.js

@@ -1,13 +1,13 @@
 import { highlight_priorities } from './highlight_priorities.js';
 /**
- * Check for CSS Highlights API support.
+ * Checks for CSS Highlights API support.
  */
-export const supports_css_highlight_api = () => !!(globalThis.CSS?.highlights && globalThis.Highlight); // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+export const supports_css_highlight_api = () => !!(globalThis.CSS?.highlights && globalThis.Highlight);
 /**
  * Manages CSS Custom Highlight API ranges for a single element.
  * Tracks ranges per element and only removes its own ranges when clearing.
  *
- * **Experimental** — limited browser support. Use `Code` for production.
+ * **Experimental** — limited browser support. Use `Code.svelte` for production.
  *
  * @example
  * ```ts
@@ -24,7 +24,7 @@ export class HighlightManager {
         this.element_ranges = new Map();
     }
     /**
-     * Highlight from syntax styler token stream.
+     * Highlights from a `SyntaxTokenStream` produced by `tokenize_syntax`.
      */
     highlight_from_syntax_tokens(element, tokens) {
         // Find the text node (it might not be firstChild due to Svelte comment nodes)
@@ -67,7 +67,7 @@ export class HighlightManager {
         }
     }
     /**
-     * Clear only this element's ranges from highlights.
+     * Clears only this element's ranges from highlights.
      */
     clear_element_ranges() {
         for (const [name, ranges] of this.element_ranges) {
@@ -88,7 +88,7 @@ export class HighlightManager {
         this.clear_element_ranges();
     }
     /**
-     * Create ranges for all tokens in the tree.
+     * Creates ranges for all tokens in the tree.
      */
     #create_all_ranges(tokens, text_node, ranges_by_type, offset) {
         const text_length = text_node.textContent?.length ?? 0;

package/dist/svelte_preprocess_fuz_code.d.ts

@@ -6,13 +6,13 @@ import type { SyntaxStyler } from './syntax_styler.js';
 export interface PreprocessFuzCodeOptions {
     /** File patterns to exclude. */
     exclude?: Array<string | RegExp>;
-    /** Custom syntax styler. @default syntax_styler_global */
+    /** Custom `SyntaxStyler` instance. @default syntax_styler_global */
     syntax_styler?: SyntaxStyler;
     /** Enable in-memory caching. @default true */
     cache?: boolean;
     /**
-     * Import sources that resolve to the Code component.
-     * Used to verify that `<Code>` in templates actually refers to fuz_code's Code.svelte.
+     * Import sources that resolve to the `Code` component.
+     * Used to verify that `<Code>` in templates actually refers to `Code.svelte`.
      *
      * @default ['@fuzdev/fuz_code/Code.svelte']
      */
@@ -27,7 +27,7 @@ export interface PreprocessFuzCodeOptions {
  * Svelte preprocessor that compiles static `Code` component content at build time,
  * replacing runtime syntax highlighting with pre-rendered HTML.
  *
- * @param options preprocessor configuration
+ * @param options - `PreprocessFuzCodeOptions` configuration
  * @returns a Svelte preprocessor group
  *
  * @example

package/dist/svelte_preprocess_fuz_code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"svelte_preprocess_fuz_code.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/svelte_preprocess_fuz_code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,iBAAiB,EAAW,MAAM,iBAAiB,CAAC;AAgBxE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC,gCAAgC;IAChC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAEjC,0DAA0D;IAC1D,aAAa,CAAC,EAAE,YAAY,CAAC;IAE7B,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,0BAA0B,GACtC,UAAS,wBAA6B,KACpC,iBA6DF,CAAC"}
+{"version":3,"file":"svelte_preprocess_fuz_code.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/svelte_preprocess_fuz_code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,iBAAiB,EAAW,MAAM,iBAAiB,CAAC;AAgBxE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC,gCAAgC;IAChC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAEjC,oEAAoE;IACpE,aAAa,CAAC,EAAE,YAAY,CAAC;IAE7B,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,0BAA0B,GACtC,UAAS,wBAA6B,KACpC,iBA6DF,CAAC"}

package/dist/svelte_preprocess_fuz_code.js

@@ -9,7 +9,7 @@ import { syntax_styler_global } from './syntax_styler_global.js';
  * Svelte preprocessor that compiles static `Code` component content at build time,
  * replacing runtime syntax highlighting with pre-rendered HTML.
  *
- * @param options preprocessor configuration
+ * @param options - `PreprocessFuzCodeOptions` configuration
  * @returns a Svelte preprocessor group
  *
  * @example
@@ -68,7 +68,7 @@ export const svelte_preprocess_fuz_code = (options = {}) => {
     };
 };
 /**
- * Attempt to highlight content, using cache if available.
+ * Attempts to highlight content, using cache if available.
  * Returns the highlighted HTML, or `null` on error.
  */
 const try_highlight = (text, lang, syntax_styler, options) => {
@@ -87,7 +87,7 @@ const try_highlight = (text, lang, syntax_styler, options) => {
     return html;
 };
 /**
- * Walks the AST to find Code component usages with static `content` props
+ * Walks the AST to find `Code` component usages with static `content` props
  * and generates transformations to replace them with `dangerous_raw_html`.
  */
 const find_code_usages = (ast, syntax_styler, code_names, options) => {