@fuzdev/fuz_code 0.41.1 → 0.43.0

package/README.md

@@ -175,7 +175,7 @@ Experimental modules:
 
 ## License [🐦](https://wikipedia.org/wiki/Free_and_open-source_software)
 
-based on [Prism](https://github.com/PrismJS/prism)
+based on [Prism](https://github.com/PrismJS/prism) ([prismjs.com](https://prismjs.com/))
 by [Lea Verou](https://lea.verou.me/)
 
 the [Svelte grammar](src/lib/grammar_svelte.ts)

package/dist/Code.svelte

@@ -27,7 +27,7 @@
 			| {
 					content?: undefined;
 					/**
-					 * Pre-highlighted HTML from the `svelte_preprocess_code_static` preprocessor.
+					 * Pre-highlighted HTML from the `svelte_preprocess_fuz_code` preprocessor.
 					 * When provided, skips runtime syntax highlighting entirely.
 					 *
 					 * Named `dangerous_raw_html` to signal that it bypasses sanitization,

package/dist/Code.svelte.d.ts

@@ -8,7 +8,7 @@ type $$ComponentProps = SvelteHTMLElements['code'] & ({
 } | {
     content?: undefined;
     /**
-     * Pre-highlighted HTML from the `svelte_preprocess_code_static` preprocessor.
+     * Pre-highlighted HTML from the `svelte_preprocess_fuz_code` preprocessor.
      * When provided, skips runtime syntax highlighting entirely.
      *
      * Named `dangerous_raw_html` to signal that it bypasses sanitization,

package/dist/{svelte_preprocess_code_static.d.ts → svelte_preprocess_fuz_code.d.ts}

@@ -1,6 +1,6 @@
 import { type PreprocessorGroup } from 'svelte/compiler';
 import type { SyntaxStyler } from './syntax_styler.js';
-export interface PreprocessCodeStaticOptions {
+export interface PreprocessFuzCodeOptions {
     /** File patterns to exclude. */
     exclude?: Array<string | RegExp>;
     /** Custom syntax styler. @default syntax_styler_global */
@@ -20,5 +20,5 @@ export interface PreprocessCodeStaticOptions {
      */
     on_error?: 'log' | 'throw';
 }
-export declare const svelte_preprocess_code_static: (options?: PreprocessCodeStaticOptions) => PreprocessorGroup;
-//# sourceMappingURL=svelte_preprocess_code_static.d.ts.map
+export declare const svelte_preprocess_fuz_code: (options?: PreprocessFuzCodeOptions) => PreprocessorGroup;
+//# sourceMappingURL=svelte_preprocess_fuz_code.d.ts.map

package/dist/svelte_preprocess_fuz_code.d.ts.map

@@ -0,0 +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;AAcxE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAErD,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,eAAO,MAAM,0BAA0B,GACtC,UAAS,wBAA6B,KACpC,iBA0DF,CAAC"}

package/dist/{svelte_preprocess_code_static.js → svelte_preprocess_fuz_code.js}

@@ -1,16 +1,19 @@
 import { parse } from 'svelte/compiler';
 import MagicString from 'magic-string';
 import { walk } from 'zimmerframe';
+import { should_exclude_path } from '@fuzdev/fuz_util/path.js';
+import { escape_js_string } from '@fuzdev/fuz_util/string.js';
+import { find_attribute, evaluate_static_expr, extract_static_string, resolve_component_names, } from '@fuzdev/fuz_util/svelte_preprocess_helpers.js';
 import { syntax_styler_global } from './syntax_styler_global.js';
-export const svelte_preprocess_code_static = (options = {}) => {
+export const svelte_preprocess_fuz_code = (options = {}) => {
     const { exclude = [], syntax_styler = syntax_styler_global, cache = true, component_imports = ['@fuzdev/fuz_code/Code.svelte'], on_error = process.env.CI ? 'throw' : 'log', } = options;
     // In-memory cache: content+lang hash → highlighted HTML
     const highlight_cache = new Map();
     return {
-        name: 'code-static',
+        name: 'fuz-code',
         markup: ({ content, filename }) => {
             // Skip excluded files
-            if (should_exclude(filename, exclude)) {
+            if (should_exclude_path(filename, exclude)) {
                 return { code: content };
             }
             // Quick check: does file import from a known Code component source?
@@ -20,7 +23,7 @@ export const svelte_preprocess_code_static = (options = {}) => {
             const s = new MagicString(content);
             const ast = parse(content, { filename, modern: true });
             // Resolve which local names map to the Code component
-            const code_names = resolve_code_names(ast, component_imports);
+            const code_names = resolve_component_names(ast, component_imports);
             if (code_names.size === 0) {
                 return { code: content };
             }
@@ -45,39 +48,6 @@ export const svelte_preprocess_code_static = (options = {}) => {
         },
     };
 };
-/**
- * Check if a filename matches any exclusion pattern.
- */
-const should_exclude = (filename, exclude) => {
-    if (!filename || exclude.length === 0)
-        return false;
-    return exclude.some((pattern) => typeof pattern === 'string' ? filename.includes(pattern) : pattern.test(filename));
-};
-/**
- * Scans import declarations to find local names that import from known Code component sources.
- * Handles default imports, named imports, and aliased imports.
- * Checks both instance (`<script>`) and module (`<script module>`) scripts.
- */
-const resolve_code_names = (ast, component_imports) => {
-    const names = new Set();
-    for (const script of [ast.instance, ast.module]) {
-        if (!script)
-            continue;
-        for (const node of script.content.body) {
-            if (node.type !== 'ImportDeclaration')
-                continue;
-            if (!component_imports.includes(node.source.value))
-                continue;
-            for (const specifier of node.specifiers) {
-                // default import: `import Code from '...'`
-                // aliased: `import Highlighter from '...'`
-                // named: `import { default as Code } from '...'`
-                names.add(specifier.local.name);
-            }
-        }
-    }
-    return names;
-};
 /**
  * Attempt to highlight content, using cache if available.
  * Returns the highlighted HTML, or `null` on error.
@@ -111,6 +81,9 @@ const find_code_usages = (ast, syntax_styler, code_names, options) => {
             context.next();
             if (!code_names.has(node.name))
                 return;
+            // Skip if spread attributes present — can't determine content statically
+            if (node.attributes.some((attr) => attr.type === 'SpreadAttribute'))
+                return;
             const content_attr = find_attribute(node, 'content');
             if (!content_attr)
                 return;
@@ -159,62 +132,6 @@ const find_code_usages = (ast, syntax_styler, code_names, options) => {
     });
     return transformations;
 };
-/**
- * Find an attribute by name on a component node.
- */
-const find_attribute = (node, name) => {
-    for (const attr of node.attributes) {
-        if (attr.type === 'Attribute' && attr.name === name) {
-            return attr;
-        }
-    }
-    return undefined;
-};
-/**
- * Recursively evaluate an expression AST node to a static string value.
- * Handles string literals, template literals (no interpolation), and string concatenation.
- * Returns `null` for dynamic or non-string expressions.
- */
-const evaluate_static_expr = (expr) => {
-    if (expr.type === 'Literal' && typeof expr.value === 'string')
-        return expr.value;
-    if (expr.type === 'TemplateLiteral' && expr.expressions.length === 0) {
-        return expr.quasis.map((q) => q.value.cooked ?? q.value.raw).join('');
-    }
-    if (expr.type === 'BinaryExpression' && expr.operator === '+') {
-        const left = evaluate_static_expr(expr.left);
-        if (left === null)
-            return null;
-        const right = evaluate_static_expr(expr.right);
-        if (right === null)
-            return null;
-        return left + right;
-    }
-    return null;
-};
-/**
- * Extract the string value from a static attribute value.
- * Returns `null` for dynamic, non-string, or null literal values.
- */
-const extract_static_string = (value) => {
-    // Boolean attribute
-    if (value === true)
-        return null;
-    // Plain attribute: content="text"
-    if (Array.isArray(value)) {
-        const first = value[0];
-        if (value.length === 1 && first?.type === 'Text') {
-            return first.data;
-        }
-        return null;
-    }
-    // ExpressionTag
-    const expr = value.expression;
-    // Null literal
-    if (expr.type === 'Literal' && expr.value === null)
-        return null;
-    return evaluate_static_expr(expr);
-};
 /**
  * Try to extract a conditional expression where both branches are static strings.
  * Returns the condition source text and both branch values, or `null` if not applicable.
@@ -235,23 +152,11 @@ const try_extract_conditional = (value, source) => {
     const test_source = source.slice(test.start, test.end);
     return { test_source, consequent, alternate };
 };
-/**
- * Escapes a string for use inside a single-quoted JS string literal.
- * Single quotes are used because `stylize()` output contains double quotes
- * on every token span, so wrapping with single quotes avoids escaping those.
- */
-const escape_js_string = (html) => {
-    return html
-        .replace(/\\/g, '\\\\') // backslashes first
-        .replace(/'/g, "\\'") // single quotes
-        .replace(/\n/g, '\\n') // newlines
-        .replace(/\r/g, '\\r'); // carriage returns
-};
 /**
  * Handle errors during highlighting.
  */
 const handle_error = (error, options) => {
-    const message = `[code-static] Highlighting failed${options.filename ? ` in ${options.filename}` : ''}: ${error instanceof Error ? error.message : String(error)}`;
+    const message = `[fuz-code] Highlighting failed${options.filename ? ` in ${options.filename}` : ''}: ${error instanceof Error ? error.message : String(error)}`;
     if (options.on_error === 'throw') {
         throw new Error(message);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_code",
-  "version": "0.41.1",
+  "version": "0.43.0",
   "description": "syntax styling utilities and components for TypeScript, Svelte, and Markdown",
   "glyph": "🎨",
   "logo": "logo.svg",
@@ -33,6 +33,8 @@
   },
   "peerDependencies": {
     "@fuzdev/fuz_css": ">=0.44.1",
+    "@fuzdev/fuz_util": ">=0.49.0",
+    "esm-env": "^1",
     "magic-string": "^0.30",
     "svelte": "^5",
     "zimmerframe": "^1"
@@ -41,6 +43,9 @@
     "@fuzdev/fuz_css": {
       "optional": true
     },
+    "@fuzdev/fuz_util": {
+      "optional": true
+    },
     "magic-string": {
       "optional": true
     },
@@ -55,7 +60,7 @@
     "@changesets/changelog-git": "^0.2.1",
     "@fuzdev/fuz_css": "^0.47.0",
     "@fuzdev/fuz_ui": "^0.181.1",
-    "@fuzdev/fuz_util": "^0.48.3",
+    "@fuzdev/fuz_util": "^0.49.0",
     "@ryanatkn/eslint-config": "^0.9.0",
     "@ryanatkn/gro": "^0.190.0",
     "@sveltejs/adapter-static": "^3.0.10",

package/src/lib/{svelte_preprocess_code_static.ts → svelte_preprocess_fuz_code.ts}

@@ -1,11 +1,20 @@
 import {parse, type PreprocessorGroup, type AST} from 'svelte/compiler';
 import MagicString from 'magic-string';
 import {walk} from 'zimmerframe';
+import {should_exclude_path} from '@fuzdev/fuz_util/path.js';
+import {escape_js_string} from '@fuzdev/fuz_util/string.js';
+import {
+	find_attribute,
+	evaluate_static_expr,
+	extract_static_string,
+	resolve_component_names,
+	type ResolvedComponentImport,
+} from '@fuzdev/fuz_util/svelte_preprocess_helpers.js';
 
 import {syntax_styler_global} from './syntax_styler_global.js';
 import type {SyntaxStyler} from './syntax_styler.js';
 
-export interface PreprocessCodeStaticOptions {
+export interface PreprocessFuzCodeOptions {
 	/** File patterns to exclude. */
 	exclude?: Array<string | RegExp>;
 
@@ -30,8 +39,8 @@ export interface PreprocessCodeStaticOptions {
 	on_error?: 'log' | 'throw';
 }
 
-export const svelte_preprocess_code_static = (
-	options: PreprocessCodeStaticOptions = {},
+export const svelte_preprocess_fuz_code = (
+	options: PreprocessFuzCodeOptions = {},
 ): PreprocessorGroup => {
 	const {
 		exclude = [],
@@ -45,11 +54,11 @@ export const svelte_preprocess_code_static = (
 	const highlight_cache: Map<string, string> = new Map();
 
 	return {
-		name: 'code-static',
+		name: 'fuz-code',
 
 		markup: ({content, filename}) => {
 			// Skip excluded files
-			if (should_exclude(filename, exclude)) {
+			if (should_exclude_path(filename, exclude)) {
 				return {code: content};
 			}
 
@@ -62,7 +71,7 @@ export const svelte_preprocess_code_static = (
 			const ast = parse(content, {filename, modern: true});
 
 			// Resolve which local names map to the Code component
-			const code_names = resolve_code_names(ast, component_imports);
+			const code_names = resolve_component_names(ast, component_imports);
 			if (code_names.size === 0) {
 				return {code: content};
 			}
@@ -92,43 +101,6 @@ export const svelte_preprocess_code_static = (
 	};
 };
 
-/**
- * Check if a filename matches any exclusion pattern.
- */
-const should_exclude = (filename: string | undefined, exclude: Array<string | RegExp>): boolean => {
-	if (!filename || exclude.length === 0) return false;
-	return exclude.some((pattern) =>
-		typeof pattern === 'string' ? filename.includes(pattern) : pattern.test(filename),
-	);
-};
-
-/**
- * Scans import declarations to find local names that import from known Code component sources.
- * Handles default imports, named imports, and aliased imports.
- * Checks both instance (`<script>`) and module (`<script module>`) scripts.
- */
-const resolve_code_names = (ast: AST.Root, component_imports: Array<string>): Set<string> => {
-	const names: Set<string> = new Set();
-
-	for (const script of [ast.instance, ast.module]) {
-		if (!script) continue;
-
-		for (const node of script.content.body) {
-			if (node.type !== 'ImportDeclaration') continue;
-			if (!component_imports.includes(node.source.value as string)) continue;
-
-			for (const specifier of node.specifiers) {
-				// default import: `import Code from '...'`
-				// aliased: `import Highlighter from '...'`
-				// named: `import { default as Code } from '...'`
-				names.add(specifier.local.name);
-			}
-		}
-	}
-
-	return names;
-};
-
 interface Transformation {
 	start: number;
 	end: number;
@@ -173,7 +145,7 @@ const try_highlight = (
 const find_code_usages = (
 	ast: AST.Root,
 	syntax_styler: SyntaxStyler,
-	code_names: Set<string>,
+	code_names: Map<string, ResolvedComponentImport>,
 	options: FindCodeUsagesOptions,
 ): Array<Transformation> => {
 	const transformations: Array<Transformation> = [];
@@ -187,6 +159,9 @@ const find_code_usages = (
 
 			if (!code_names.has(node.name)) return;
 
+			// Skip if spread attributes present — can't determine content statically
+			if (node.attributes.some((attr: any) => attr.type === 'SpreadAttribute')) return;
+
 			const content_attr = find_attribute(node, 'content');
 			if (!content_attr) return;
 
@@ -237,64 +212,8 @@ const find_code_usages = (
 	return transformations;
 };
 
-/**
- * Find an attribute by name on a component node.
- */
-const find_attribute = (node: AST.Component, name: string): AST.Attribute | undefined => {
-	for (const attr of node.attributes) {
-		if (attr.type === 'Attribute' && attr.name === name) {
-			return attr;
-		}
-	}
-	return undefined;
-};
-
 type Attribute_Value = AST.Attribute['value'];
 
-/**
- * Recursively evaluate an expression AST node to a static string value.
- * Handles string literals, template literals (no interpolation), and string concatenation.
- * Returns `null` for dynamic or non-string expressions.
- */
-const evaluate_static_expr = (expr: any): string | null => {
-	if (expr.type === 'Literal' && typeof expr.value === 'string') return expr.value;
-	if (expr.type === 'TemplateLiteral' && expr.expressions.length === 0) {
-		return expr.quasis.map((q: any) => q.value.cooked ?? q.value.raw).join('');
-	}
-	if (expr.type === 'BinaryExpression' && expr.operator === '+') {
-		const left = evaluate_static_expr(expr.left);
-		if (left === null) return null;
-		const right = evaluate_static_expr(expr.right);
-		if (right === null) return null;
-		return left + right;
-	}
-	return null;
-};
-
-/**
- * Extract the string value from a static attribute value.
- * Returns `null` for dynamic, non-string, or null literal values.
- */
-const extract_static_string = (value: Attribute_Value): string | null => {
-	// Boolean attribute
-	if (value === true) return null;
-
-	// Plain attribute: content="text"
-	if (Array.isArray(value)) {
-		const first = value[0];
-		if (value.length === 1 && first?.type === 'Text') {
-			return first.data;
-		}
-		return null;
-	}
-
-	// ExpressionTag
-	const expr = value.expression;
-	// Null literal
-	if (expr.type === 'Literal' && expr.value === null) return null;
-	return evaluate_static_expr(expr);
-};
-
 interface ConditionalStaticStrings {
 	test_source: string;
 	consequent: string;
@@ -323,24 +242,11 @@ const try_extract_conditional = (
 	return {test_source, consequent, alternate};
 };
 
-/**
- * Escapes a string for use inside a single-quoted JS string literal.
- * Single quotes are used because `stylize()` output contains double quotes
- * on every token span, so wrapping with single quotes avoids escaping those.
- */
-const escape_js_string = (html: string): string => {
-	return html
-		.replace(/\\/g, '\\\\') // backslashes first
-		.replace(/'/g, "\\'") // single quotes
-		.replace(/\n/g, '\\n') // newlines
-		.replace(/\r/g, '\\r'); // carriage returns
-};
-
 /**
  * Handle errors during highlighting.
  */
 const handle_error = (error: unknown, options: FindCodeUsagesOptions): void => {
-	const message = `[code-static] Highlighting failed${options.filename ? ` in ${options.filename}` : ''}: ${error instanceof Error ? error.message : String(error)}`;
+	const message = `[fuz-code] Highlighting failed${options.filename ? ` in ${options.filename}` : ''}: ${error instanceof Error ? error.message : String(error)}`;
 
 	if (options.on_error === 'throw') {
 		throw new Error(message);

package/dist/svelte_preprocess_code_static.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"svelte_preprocess_code_static.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/svelte_preprocess_code_static.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,iBAAiB,EAAW,MAAM,iBAAiB,CAAC;AAKxE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,2BAA2B;IAC3C,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,eAAO,MAAM,6BAA6B,GACzC,UAAS,2BAAgC,KACvC,iBA0DF,CAAC"}