@mojir/dvala 0.0.17 → 0.0.19

package/dist/cli/cli.js

@@ -478,7 +478,7 @@ function findAllOccurrences(input, pattern) {
 }
 //#endregion
 //#region package.json
-var version = "0.0.17";
+var version = "0.0.19";
 //#endregion
 //#region src/typeGuards/string.ts
 function isString(value, options = {}) {
@@ -5232,7 +5232,7 @@ function generateDocString(reference) {
       ${argStrings(reference).join("\n      ")}
 
     Examples:
-${reference.examples.map((example) => smartTrim(example, 4)).join("\n\n")}`);
+${reference.examples.map((example) => smartTrim(typeof example === "string" ? example : example.code, 4)).join("\n\n")}`);
 }
 function isEffectRef(ref) {
 	return "effect" in ref;
@@ -24391,7 +24391,13 @@ const standardEffects = {
 				description: "Value to print."
 			} },
 			variants: [{ argumentNames: ["value"] }],
-			examples: ["perform(effect(dvala.io.print), \"hello\")", "perform(effect(dvala.io.print), 42)"],
+			examples: [{
+				code: "perform(effect(dvala.io.print), \"hello\")",
+				noRun: true
+			}, {
+				code: "perform(effect(dvala.io.print), 42)",
+				noRun: true
+			}],
 			seeAlso: [
 				"-effect-dvala.io.println",
 				"-effect-dvala.io.error",
@@ -24413,7 +24419,13 @@ const standardEffects = {
 				description: "Value to print."
 			} },
 			variants: [{ argumentNames: ["value"] }],
-			examples: ["perform(effect(dvala.io.println), \"hello\")", "perform(effect(dvala.io.println), [1, 2, 3])"],
+			examples: [{
+				code: "perform(effect(dvala.io.println), \"hello\")",
+				noRun: true
+			}, {
+				code: "perform(effect(dvala.io.println), [1, 2, 3])",
+				noRun: true
+			}],
 			seeAlso: [
 				"-effect-dvala.io.print",
 				"-effect-dvala.io.error",
@@ -24445,7 +24457,10 @@ const standardEffects = {
 				description: "Value to write to stderr."
 			} },
 			variants: [{ argumentNames: ["value"] }],
-			examples: ["perform(effect(dvala.io.error), \"something went wrong\")"],
+			examples: [{
+				code: "perform(effect(dvala.io.error), \"something went wrong\")",
+				noRun: true
+			}],
 			seeAlso: [
 				"-effect-dvala.io.print",
 				"-effect-dvala.io.println",
@@ -24999,8 +25014,13 @@ const datatype = {
 		datatype: true,
 		title: "string",
 		category: "datatype",
-		description: "A `string`",
-		examples: ["\"hello\"", "\"\""]
+		description: "A `string`. Strings are written with double quotes. Template strings use backticks and support `${...}` interpolation — any expression can appear inside the braces.",
+		examples: [
+			"\"hello\"",
+			"\"\"",
+			"`Hello, World!`",
+			"`${2} * ${3} = ${2 * 3}`"
+		]
 	},
 	"-type-object": {
 		datatype: true,
@@ -25326,14 +25346,11 @@ function deriveEffectReference() {
 	return result;
 }
 const effectReference = deriveEffectReference();
-const allReference = sortByCategory({
+sortByCategory({
 	...apiReference,
 	...moduleReference,
 	...effectReference
 });
-Object.values(allReference).forEach((ref) => {
-	ref.title = ref.title.replace(/"/g, """);
-});
 function sortByCategory(ref) {
 	return Object.fromEntries(Object.entries(ref).sort(([keyA, refA], [keyB, refB]) => {
 		const catA = refA.category === "special-expression" ? "" : refA.category;
@@ -26828,6 +26845,9 @@ function isStringToken(token) {
 function isA_BinaryOperatorToken(token) {
 	return token?.[0] === "Operator" && isBinaryOperator(token[1]);
 }
+function isTemplateStringToken(token) {
+	return token?.[0] === "TemplateString";
+}
 function throwUnexpectedToken(expected, expectedValue, actual) {
 	throw new DvalaError(`Unexpected token: ${actual ? `${actual[0]} '${actual[1]}'` : "end of input"}, expected ${expected}${expectedValue ? ` '${expectedValue}'` : ""}`, actual?.[2]);
 }
@@ -27122,6 +27142,176 @@ function parseNumber(ctx) {
 	return withSourceCodeInfo([NodeTypes.Number, negative ? -Number(numberString) : Number(numberString)], token[2]);
 }
 //#endregion
+//#region src/tokenizer/minifyTokenStream.ts
+function minifyTokenStream(tokenStream, { removeWhiteSpace }) {
+	const tokens = tokenStream.tokens.filter((token) => {
+		if (isSingleLineCommentToken(token) || isMultiLineCommentToken(token) || isShebangToken(token) || removeWhiteSpace && isWhitespaceToken(token)) return false;
+		return true;
+	});
+	return {
+		...tokenStream,
+		tokens
+	};
+}
+//#endregion
+//#region src/parser/subParsers/parseTemplateString.ts
+/**
+* Scan from `start` inside a `${...}` interpolation until the matching `}`.
+* Returns the expression source text (without the outer `${` and `}`) and
+* the number of characters consumed (including the closing `}`).
+*/
+function scanExpression(raw, start) {
+	let i = start;
+	let expr = "";
+	let depth = 1;
+	while (i < raw.length && depth > 0) {
+		const c = raw[i];
+		if (c === "{") {
+			depth++;
+			expr += c;
+			i++;
+		} else if (c === "}") {
+			depth--;
+			if (depth > 0) expr += c;
+			i++;
+		} else if (c === "\"") {
+			const { str, consumed } = scanString(raw, i);
+			expr += str;
+			i += consumed;
+		} else if (c === "'") {
+			const { str, consumed } = scanQuotedSymbol(raw, i);
+			expr += str;
+			i += consumed;
+		} else if (c === "`") {
+			const { str, consumed } = scanNestedTemplate(raw, i);
+			expr += str;
+			i += consumed;
+		} else {
+			expr += c;
+			i++;
+		}
+	}
+	return {
+		expr,
+		consumed: i - start
+	};
+}
+function scanString(raw, start) {
+	let i = start + 1;
+	let str = "\"";
+	let escaping = false;
+	while (i < raw.length) {
+		const c = raw[i];
+		str += c;
+		i++;
+		if (escaping) escaping = false;
+		else if (c === "\\") escaping = true;
+		else if (c === "\"") break;
+	}
+	return {
+		str,
+		consumed: i - start
+	};
+}
+function scanQuotedSymbol(raw, start) {
+	let i = start + 1;
+	let str = "'";
+	let escaping = false;
+	while (i < raw.length) {
+		const c = raw[i];
+		str += c;
+		i++;
+		if (escaping) escaping = false;
+		else if (c === "\\") escaping = true;
+		else if (c === "'") break;
+	}
+	return {
+		str,
+		consumed: i - start
+	};
+}
+/**
+* Scan a full nested template string starting at `start` (pointing at the opening backtick).
+* Handles ${...} spans inside the template recursively.
+*/
+function scanNestedTemplate(raw, start) {
+	let i = start + 1;
+	let str = "`";
+	while (i < raw.length) {
+		const c = raw[i];
+		if (c === "`") {
+			str += c;
+			i++;
+			break;
+		} else if (c === "$" && raw[i + 1] === "{") {
+			str += "${";
+			i += 2;
+			const { expr, consumed } = scanExpression(raw, i);
+			str += `${expr}}`;
+			i += consumed;
+		} else {
+			str += c;
+			i++;
+		}
+	}
+	return {
+		str,
+		consumed: i - start
+	};
+}
+/**
+* Split the raw content of a template string (between the surrounding backticks)
+* into alternating literal and expression segments.
+*/
+function splitSegments(raw) {
+	const segments = [];
+	let i = 0;
+	let literal = "";
+	while (i < raw.length) if (raw[i] === "$" && raw[i + 1] === "{") {
+		if (literal.length > 0) {
+			segments.push({
+				type: "literal",
+				value: literal
+			});
+			literal = "";
+		}
+		i += 2;
+		const { expr, consumed } = scanExpression(raw, i);
+		i += consumed;
+		segments.push({
+			type: "expression",
+			value: expr
+		});
+	} else {
+		literal += raw[i];
+		i++;
+	}
+	if (literal.length > 0) segments.push({
+		type: "literal",
+		value: literal
+	});
+	return segments;
+}
+function parseTemplateString(ctx, token) {
+	ctx.advance();
+	const sourceCodeInfo = token[2];
+	const segments = splitSegments(token[1].slice(1, -1));
+	if (segments.length === 0) return withSourceCodeInfo([NodeTypes.String, ""], sourceCodeInfo);
+	if (segments.length === 1 && segments[0].type === "literal") return withSourceCodeInfo([NodeTypes.String, segments[0].value], sourceCodeInfo);
+	const segmentNodes = [];
+	for (const segment of segments) if (segment.type === "literal") {
+		if (segment.value.length === 0) continue;
+		segmentNodes.push(withSourceCodeInfo([NodeTypes.String, segment.value], sourceCodeInfo));
+	} else {
+		if (segment.value.trim().length === 0) throw new DvalaError("Empty interpolation in template string", sourceCodeInfo);
+		const minified = minifyTokenStream(tokenize(segment.value, false, sourceCodeInfo?.filePath), { removeWhiteSpace: true });
+		for (const t of minified.tokens) if (t[0] === "Error") throw new DvalaError(`Template string interpolation error: ${t[3]}`, sourceCodeInfo);
+		const expr = parseExpression(createParserContext(minified), 0);
+		segmentNodes.push(expr);
+	}
+	return withSourceCodeInfo([NodeTypes.TemplateString, segmentNodes], sourceCodeInfo);
+}
+//#endregion
 //#region src/parser/subParsers/parseBindingTarget.ts
 function parseBindingTarget(ctx, { requireDefaultValue, noRest, allowLiteralPatterns } = {}) {
 	const firstToken = ctx.tryPeek();
@@ -27134,6 +27324,10 @@ function parseBindingTarget(ctx, { requireDefaultValue, noRest, allowLiteralPatt
 			const node = parseNumber(ctx);
 			return withSourceCodeInfo([bindingTargetTypes.literal, [node]], firstToken[2]);
 		}
+		if (isTemplateStringToken(firstToken)) {
+			const node = parseTemplateString(ctx, firstToken);
+			return withSourceCodeInfo([bindingTargetTypes.literal, [node]], firstToken[2]);
+		}
 		if (isStringToken(firstToken)) {
 			const node = parseString(ctx, firstToken);
 			return withSourceCodeInfo([bindingTargetTypes.literal, [node]], firstToken[2]);
@@ -27251,7 +27445,7 @@ function parseOptionalDefaulValue(ctx) {
 	}
 }
 function isLiteralToken(token) {
-	return isNumberToken(token) || isBasePrefixedNumberToken(token) || isStringToken(token) || isReservedSymbolToken(token, "true") || isReservedSymbolToken(token, "false") || isReservedSymbolToken(token, "null");
+	return isNumberToken(token) || isBasePrefixedNumberToken(token) || isStringToken(token) || isTemplateStringToken(token) || isReservedSymbolToken(token, "true") || isReservedSymbolToken(token, "false") || isReservedSymbolToken(token, "null");
 }
 //#endregion
 //#region src/parser/subParsers/parseLet.ts
@@ -27631,7 +27825,8 @@ function parseObject(ctx) {
 			params.push(withSourceCodeInfo([NodeTypes.Spread, ctx.parseExpression()], ctx.peekSourceCodeInfo()));
 		} else {
 			const token = ctx.tryPeek();
-			if (isStringToken(token)) {
+			if (isTemplateStringToken(token)) params.push(parseTemplateString(ctx, token));
+			else if (isStringToken(token)) {
 				const stringNode = parseString(ctx, token);
 				params.push(withSourceCodeInfo([NodeTypes.String, stringNode[1]], token[2]));
 			} else if (isSymbolToken(token)) {
@@ -27657,176 +27852,6 @@ function parseObject(ctx) {
 	return withSourceCodeInfo([NodeTypes.SpecialExpression, [specialExpressionTypes.object, params]], firstToken[2]);
 }
 //#endregion
-//#region src/tokenizer/minifyTokenStream.ts
-function minifyTokenStream(tokenStream, { removeWhiteSpace }) {
-	const tokens = tokenStream.tokens.filter((token) => {
-		if (isSingleLineCommentToken(token) || isMultiLineCommentToken(token) || isShebangToken(token) || removeWhiteSpace && isWhitespaceToken(token)) return false;
-		return true;
-	});
-	return {
-		...tokenStream,
-		tokens
-	};
-}
-//#endregion
-//#region src/parser/subParsers/parseTemplateString.ts
-/**
-* Scan from `start` inside a `${...}` interpolation until the matching `}`.
-* Returns the expression source text (without the outer `${` and `}`) and
-* the number of characters consumed (including the closing `}`).
-*/
-function scanExpression(raw, start) {
-	let i = start;
-	let expr = "";
-	let depth = 1;
-	while (i < raw.length && depth > 0) {
-		const c = raw[i];
-		if (c === "{") {
-			depth++;
-			expr += c;
-			i++;
-		} else if (c === "}") {
-			depth--;
-			if (depth > 0) expr += c;
-			i++;
-		} else if (c === "\"") {
-			const { str, consumed } = scanString(raw, i);
-			expr += str;
-			i += consumed;
-		} else if (c === "'") {
-			const { str, consumed } = scanQuotedSymbol(raw, i);
-			expr += str;
-			i += consumed;
-		} else if (c === "`") {
-			const { str, consumed } = scanNestedTemplate(raw, i);
-			expr += str;
-			i += consumed;
-		} else {
-			expr += c;
-			i++;
-		}
-	}
-	return {
-		expr,
-		consumed: i - start
-	};
-}
-function scanString(raw, start) {
-	let i = start + 1;
-	let str = "\"";
-	let escaping = false;
-	while (i < raw.length) {
-		const c = raw[i];
-		str += c;
-		i++;
-		if (escaping) escaping = false;
-		else if (c === "\\") escaping = true;
-		else if (c === "\"") break;
-	}
-	return {
-		str,
-		consumed: i - start
-	};
-}
-function scanQuotedSymbol(raw, start) {
-	let i = start + 1;
-	let str = "'";
-	let escaping = false;
-	while (i < raw.length) {
-		const c = raw[i];
-		str += c;
-		i++;
-		if (escaping) escaping = false;
-		else if (c === "\\") escaping = true;
-		else if (c === "'") break;
-	}
-	return {
-		str,
-		consumed: i - start
-	};
-}
-/**
-* Scan a full nested template string starting at `start` (pointing at the opening backtick).
-* Handles ${...} spans inside the template recursively.
-*/
-function scanNestedTemplate(raw, start) {
-	let i = start + 1;
-	let str = "`";
-	while (i < raw.length) {
-		const c = raw[i];
-		if (c === "`") {
-			str += c;
-			i++;
-			break;
-		} else if (c === "$" && raw[i + 1] === "{") {
-			str += "${";
-			i += 2;
-			const { expr, consumed } = scanExpression(raw, i);
-			str += `${expr}}`;
-			i += consumed;
-		} else {
-			str += c;
-			i++;
-		}
-	}
-	return {
-		str,
-		consumed: i - start
-	};
-}
-/**
-* Split the raw content of a template string (between the surrounding backticks)
-* into alternating literal and expression segments.
-*/
-function splitSegments(raw) {
-	const segments = [];
-	let i = 0;
-	let literal = "";
-	while (i < raw.length) if (raw[i] === "$" && raw[i + 1] === "{") {
-		if (literal.length > 0) {
-			segments.push({
-				type: "literal",
-				value: literal
-			});
-			literal = "";
-		}
-		i += 2;
-		const { expr, consumed } = scanExpression(raw, i);
-		i += consumed;
-		segments.push({
-			type: "expression",
-			value: expr
-		});
-	} else {
-		literal += raw[i];
-		i++;
-	}
-	if (literal.length > 0) segments.push({
-		type: "literal",
-		value: literal
-	});
-	return segments;
-}
-function parseTemplateString(ctx, token) {
-	ctx.advance();
-	const sourceCodeInfo = token[2];
-	const segments = splitSegments(token[1].slice(1, -1));
-	if (segments.length === 0) return withSourceCodeInfo([NodeTypes.String, ""], sourceCodeInfo);
-	if (segments.length === 1 && segments[0].type === "literal") return withSourceCodeInfo([NodeTypes.String, segments[0].value], sourceCodeInfo);
-	const segmentNodes = [];
-	for (const segment of segments) if (segment.type === "literal") {
-		if (segment.value.length === 0) continue;
-		segmentNodes.push(withSourceCodeInfo([NodeTypes.String, segment.value], sourceCodeInfo));
-	} else {
-		if (segment.value.trim().length === 0) throw new DvalaError("Empty interpolation in template string", sourceCodeInfo);
-		const minified = minifyTokenStream(tokenize(segment.value, false, sourceCodeInfo?.filePath), { removeWhiteSpace: true });
-		for (const t of minified.tokens) if (t[0] === "Error") throw new DvalaError(`Template string interpolation error: ${t[3]}`, sourceCodeInfo);
-		const expr = parseExpression(createParserContext(minified), 0);
-		segmentNodes.push(expr);
-	}
-	return withSourceCodeInfo([NodeTypes.TemplateString, segmentNodes], sourceCodeInfo);
-}
-//#endregion
 //#region src/parser/subParsers/parseOperand.ts
 function parseOperand(ctx) {
 	let operand = parseOperandPart(ctx);
@@ -28097,6 +28122,22 @@ var ResumeFromSignal = class {
 function isResumeFromSignal(value) {
 	return value instanceof ResumeFromSignal;
 }
+/**
+* Thrown (as a promise rejection) by `halt()` inside a host handler.
+* Caught by the effect trampoline loop — NOT by Dvala-level try/catch.
+* Terminates execution immediately and returns a halted result.
+*/
+var HaltSignal = class {
+	_brand = "HaltSignal";
+	constructor(value, snapshots, nextSnapshotIndex) {
+		this.value = value;
+		this.snapshots = snapshots;
+		this.nextSnapshotIndex = nextSnapshotIndex;
+	}
+};
+function isHaltSignal(value) {
+	return value instanceof HaltSignal;
+}
 //#endregion
 //#region src/evaluator/effectRef.ts
 const internMap = /* @__PURE__ */ new Map();
@@ -30658,6 +30699,8 @@ function dispatchHostHandler(effectName, matchingHandlers, args, k, signal, sour
 	}
 	function tryHandler(index) {
 		if (index >= matchingHandlers.length) {
+			const standardHandler = getStandardEffectHandler(effectName);
+			if (standardHandler) return standardHandler(args, k, sourceCodeInfo);
 			if (effectName === "dvala.error") throw new UserDefinedError(typeof argsArray[0] === "string" ? argsArray[0] : String(argsArray[0] ?? "Unknown error"), sourceCodeInfo);
 			if (effectName === "dvala.checkpoint") return {
 				type: "Value",
@@ -30666,11 +30709,7 @@ function dispatchHostHandler(effectName, matchingHandlers, args, k, signal, sour
 			};
 			throw new DvalaError(`Unhandled effect: '${effectName}'`, sourceCodeInfo);
 		}
-		const [pattern, handler] = matchingHandlers[index];
-		if (pattern === "*") {
-			const standardHandler = getStandardEffectHandler(effectName);
-			if (standardHandler) return standardHandler(args, k, sourceCodeInfo);
-		}
+		const [_pattern, handler] = matchingHandlers[index];
 		let outcome;
 		let settled = false;
 		function assertNotSettled(operation) {
@@ -30745,10 +30784,17 @@ function dispatchHostHandler(effectName, matchingHandlers, args, k, signal, sour
 					kind: "throw",
 					error: new ResumeFromSignal(found.continuation, value, found.index)
 				};
+			},
+			halt: (value = null) => {
+				assertNotSettled("halt");
+				outcome = {
+					kind: "throw",
+					error: new HaltSignal(value, snapshotState ? snapshotState.snapshots : [], snapshotState ? snapshotState.nextSnapshotIndex : 0)
+				};
 			}
 		});
 		if (!(handlerResult instanceof Promise)) {
-			if (!outcome) throw new DvalaError(`Effect handler for '${effectName}' did not call resume(), fail(), suspend(), or next()`, sourceCodeInfo);
+			if (!outcome) throw new DvalaError(`Effect handler for '${effectName}' did not call resume(), fail(), suspend(), halt(), or next()`, sourceCodeInfo);
 			return resolveOutcome(outcome, index + 1);
 		}
 		if (outcome) {
@@ -30756,11 +30802,11 @@ function dispatchHostHandler(effectName, matchingHandlers, args, k, signal, sour
 			return resolveOutcome(outcome, index + 1);
 		}
 		return handlerResult.then(() => {
-			if (!outcome) throw new DvalaError(`Effect handler for '${effectName}' did not call resume(), fail(), suspend(), or next()`, sourceCodeInfo);
+			if (!outcome) throw new DvalaError(`Effect handler for '${effectName}' did not call resume(), fail(), suspend(), halt(), or next()`, sourceCodeInfo);
 			return resolveOutcome(outcome, index + 1);
 		}, (e) => {
 			if (outcome) return resolveOutcome(outcome, index + 1);
-			if (isSuspensionSignal(e) || isResumeFromSignal(e)) throw e;
+			if (isSuspensionSignal(e) || isResumeFromSignal(e) || isHaltSignal(e)) throw e;
 			return {
 				type: "Error",
 				error: e instanceof DvalaError ? e : new DvalaError(e instanceof Error ? e : `${e}`, sourceCodeInfo),
@@ -31684,7 +31730,7 @@ function tick(step, handlers, signal, snapshotState) {
 			}
 		}
 	} catch (error) {
-		if (isSuspensionSignal(error)) throw error;
+		if (isSuspensionSignal(error) || isHaltSignal(error)) throw error;
 		if (error instanceof DvalaError) {
 			const effectStep = tryDispatchDvalaError(error, step.type === "Value" ? step.k.slice(1) : step.k, handlers, signal, snapshotState);
 			if (effectStep !== null) return effectStep;
@@ -31820,8 +31866,9 @@ async function runEffectLoop(initial, handlers, signal, initialSnapshotState, ma
 		const continuation = serializeTerminalSnapshot(snapshotState.snapshots, snapshotState.nextSnapshotIndex);
 		const meta = {};
 		if (options?.error) meta.error = options.error.toJSON();
+		if (options?.halted) meta.halted = true;
 		if (options?.result !== void 0) meta.result = options.result;
-		const message = options?.error ? "Run failed with error" : "Run completed successfully";
+		const message = options?.error ? "Run failed with error" : options?.halted ? "Program halted" : "Run completed successfully";
 		return createSnapshot({
 			continuation,
 			timestamp: Date.now(),
@@ -31888,6 +31935,20 @@ async function runEffectLoop(initial, handlers, signal, initialSnapshotState, ma
 				effectArgs: error.effectArgs
 			})
 		};
+		if (isHaltSignal(error)) {
+			const snapshot = createTerminalSnapshot({
+				result: error.value,
+				halted: true
+			});
+			return snapshot ? {
+				type: "halted",
+				value: error.value,
+				snapshot
+			} : {
+				type: "halted",
+				value: error.value
+			};
+		}
 		if (error instanceof DvalaError) {
 			const snapshot = createTerminalSnapshot({ error });
 			return snapshot ? {
@@ -32002,6 +32063,13 @@ var Cache = class {
 * a Dvala instance.
 */
 /**
+* Tokenize a Dvala source string into a token stream.
+* Pass `debug: true` to capture source positions (needed for the debugger).
+*/
+function tokenizeSource(source, debug = false, filePath) {
+	return tokenize(source, debug, filePath);
+}
+/**
 * Get all undefined symbols in a Dvala program.
 *
 * @param source - Dvala source code
@@ -33741,11 +33809,38 @@ const getInlineCodeRule = (fmt) => (text, index) => {
 		formattedText: ""
 	};
 };
+function getTemplateStringRule(fmt) {
+	return (text, index) => {
+		if (text[index] !== "`") return noMatch;
+		try {
+			const { tokens } = tokenizeSource(text.slice(index));
+			const first = tokens[0];
+			if (!first || first[0] !== "TemplateString") return noMatch;
+			const count = first[1].length;
+			const segments = splitSegments(first[1].slice(1, -1));
+			let formattedText = `${Colors.FgRed}\`${Colors.Reset}`;
+			for (const seg of segments) if (seg.type === "literal") formattedText += Colors.FgRed + seg.value + Colors.Reset;
+			else {
+				formattedText += `${Colors.Bright}${Colors.FgWhite}\${${Colors.Reset}`;
+				formattedText += getDvalaFormatter(fmt)(seg.value);
+				formattedText += `${Colors.Bright}${Colors.FgWhite}}${Colors.Reset}`;
+			}
+			formattedText += `${Colors.FgRed}\`${Colors.Reset}`;
+			return {
+				count,
+				formattedText
+			};
+		} catch {
+			return noMatch;
+		}
+	};
+}
 function getDvalaExpressionRules(cli) {
 	return [
 		commentRule,
 		stringRule,
 		shortcutStringRule,
+		getTemplateStringRule(cli),
 		functionNameRule,
 		getNumberRule(cli),
 		dvalaKeywordRule,
@@ -33863,7 +33958,7 @@ function getArgumentInfo(fmt, reference) {
 const dvala = createDvala({ debug: false });
 function getCliFunctionExamples(fmt, reference) {
 	const { examples } = reference;
-	return examples.map((example) => example.trim()).map((example) => {
+	return examples.map((example) => (typeof example === "string" ? example : example.code).trim()).map((example) => {
 		const oldLog = console.log;
 		console.log = function() {};
 		let result;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mojir/dvala",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "description": "dvala",
   "author": "Albert Mojir",
   "license": "MIT",
@@ -136,7 +136,7 @@
     "build-playground": "wireit",
     "build-vscode-ext": "wireit",
     "dvala": "node ./dist/cli/cli.js",
-    "dev": "npx serve docs -p 9901",
+    "dev": "npx serve docs -p 9901 --single",
     "test:e2e": "npx playwright test",
     "test:e2e:prod": "E2E_BASE_URL=https://mojir.github.io/dvala npx playwright test",
     "test:e2e:headed": "npx playwright test --headed",
@@ -157,7 +157,7 @@
     "@vscode/vsce": "^3.7.1",
     "esbuild": "^0.27.3",
     "eslint": "^10.0.3",
-    "open-cli": "8.0.0",
+    "open-cli": "^5.0.0",
     "rolldown": "^1.0.0-rc.8",
     "serve": "^14.2.6",
     "tslib": "^2.8.1",
@@ -298,6 +298,7 @@
         "src/**",
         "common/**",
         "reference/**/*.ts",
+        "tutorials/**",
         "rolldown.config.playground-builder.mjs",
         "rolldown.config.playground-www.mjs",
         "rolldown.plugins.mjs",
@@ -326,5 +327,8 @@
       ],
       "clean": "if-file-deleted"
     }
+  },
+  "dependencies": {
+    "marked": "^17.0.4"
   }
 }