@mojir/dvala 0.0.12 → 0.0.13

package/dist/cli/cli.js

@@ -466,7 +466,7 @@ function findAllOccurrences(input, pattern) {
 }
 //#endregion
 //#region package.json
-var version = "0.0.12";
+var version = "0.0.13";
 //#endregion
 //#region src/typeGuards/string.ts
 function isString(value, options = {}) {
@@ -27788,6 +27788,7 @@ function minifyTokenStream(tokenStream, { removeWhiteSpace }) {
 }
 //#endregion
 //#region src/evaluator/effectTypes.ts
+const SUSPENDED_MESSAGE = "Program suspended";
 /**
 * Generate a UUID for identifying a run() or resume() call.
 * Uses crypto.randomUUID() when available, falls back to a simple generator.
@@ -27821,9 +27822,9 @@ function effectNameMatchesPattern(effectName, pattern) {
 * Returns an array of `[pattern, handler]` pairs.
 */
 function findMatchingHandlers(effectName, handlers) {
-	if (!handlers) return [];
+	if (!handlers || handlers.length === 0) return [];
 	const result = [];
-	for (const [pattern, handler] of Object.entries(handlers)) if (effectNameMatchesPattern(effectName, pattern)) result.push([pattern, handler]);
+	for (const { pattern, handler } of handlers) if (effectNameMatchesPattern(effectName, pattern)) result.push([pattern, handler]);
 	return result;
 }
 /**
@@ -29543,6 +29544,7 @@ function applyFrame(frame, value, k) {
 				k
 			};
 		}
+		case "AutoCheckpoint": return applyAutoCheckpoint(frame, k);
 		default: throw new DvalaError(`Unhandled frame type: ${frame.type}`, void 0);
 	}
 }
@@ -30347,6 +30349,27 @@ function dispatchPerform(effect, args, k, sourceCodeInfo, handlers, signal, snap
 		snapshotState.snapshots.push(snapshot);
 		if (snapshotState.maxSnapshots !== void 0 && snapshotState.snapshots.length > snapshotState.maxSnapshots) snapshotState.snapshots.shift();
 	}
+	if (snapshotState?.autoCheckpoint && effect.name !== "dvala.checkpoint") {
+		const topFrame = k[0];
+		if (topFrame?.type === "AutoCheckpoint" && topFrame.phase === "awaitEffect") k = k.slice(1);
+		else {
+			const autoCheckpointFrame = {
+				type: "AutoCheckpoint",
+				phase: "awaitCheckpoint",
+				effect,
+				args,
+				sourceCodeInfo
+			};
+			const checkpointMessage = `Auto checkpoint before ${effect.name}`;
+			return {
+				type: "Perform",
+				effect: getEffectRef("dvala.checkpoint"),
+				args: [checkpointMessage],
+				k: [autoCheckpointFrame, ...k],
+				sourceCodeInfo
+			};
+		}
+	}
 	for (let i = 0; i < k.length; i++) {
 		const frame = k[i];
 		if (frame.type === "TryWith") {
@@ -30873,6 +30896,22 @@ function applyDebugStep(frame, value, k) {
 		k
 	};
 }
+function applyAutoCheckpoint(frame, k) {
+	const markerFrame = {
+		type: "AutoCheckpoint",
+		phase: "awaitEffect",
+		effect: frame.effect,
+		args: frame.args,
+		sourceCodeInfo: frame.sourceCodeInfo
+	};
+	return {
+		type: "Perform",
+		effect: frame.effect,
+		args: frame.args,
+		k: [markerFrame, ...k],
+		sourceCodeInfo: frame.sourceCodeInfo
+	};
+}
 /**
 * Wrap a MaybePromise<Any> result into a Step or Promise<Step>.
 * If the result is a value, return a ValueStep immediately.
@@ -31054,9 +31093,9 @@ function evaluateNode(node, contextStack) {
 * is passed to every host handler. Used for `race()` cancellation (Phase 6)
 * and host-side timeouts.
 */
-async function evaluateWithEffects(ast, contextStack, handlers, maxSnapshots, deserializeOptions) {
+async function evaluateWithEffects(ast, contextStack, handlers, maxSnapshots, deserializeOptions, autoCheckpoint) {
 	const signal = new AbortController().signal;
-	return runEffectLoop(buildInitialStep(ast.body, contextStack), handlers, signal, void 0, maxSnapshots, deserializeOptions);
+	return runEffectLoop(buildInitialStep(ast.body, contextStack), handlers, signal, void 0, maxSnapshots, deserializeOptions, autoCheckpoint);
 }
 /**
 * Evaluate an AST synchronously with effect handler support.
@@ -31086,13 +31125,14 @@ function evaluateWithSyncEffects(ast, contextStack, effectHandlers) {
 * to fire a `perform(dvala.debug.step, stepInfo)` after evaluation,
 * enabling the time-travel debugger.
 */
-async function runEffectLoop(initial, handlers, signal, initialSnapshotState, maxSnapshots, deserializeOptions) {
-	const debugMode = handlers !== null && handlers !== void 0 && "dvala.debug.step" in handlers;
+async function runEffectLoop(initial, handlers, signal, initialSnapshotState, maxSnapshots, deserializeOptions, autoCheckpoint) {
+	const debugMode = Array.isArray(handlers) && handlers.some((h) => h.pattern === "dvala.debug.step");
 	const snapshotState = {
 		snapshots: initialSnapshotState ? initialSnapshotState.snapshots : [],
 		nextSnapshotIndex: initialSnapshotState ? initialSnapshotState.nextSnapshotIndex : 0,
 		runId: generateRunId(),
-		...maxSnapshots !== void 0 ? { maxSnapshots } : {}
+		...maxSnapshots !== void 0 ? { maxSnapshots } : {},
+		...autoCheckpoint ? { autoCheckpoint } : {}
 	};
 	let step = initial;
 	for (;;) try {
@@ -31138,7 +31178,7 @@ async function runEffectLoop(initial, handlers, signal, initialSnapshotState, ma
 				timestamp: Date.now(),
 				index: snapshotState.nextSnapshotIndex++,
 				runId: snapshotState.runId,
-				message: "suspended",
+				message: SUSPENDED_MESSAGE,
 				meta: error.meta,
 				effectName: error.effectName,
 				effectArgs: error.effectArgs
@@ -31314,15 +31354,11 @@ function createDvala(options) {
 	}
 	function mergeEffectHandlers(runEffectHandlers) {
 		if (!factoryEffectHandlers && !runEffectHandlers) return void 0;
-		const result = { ...runEffectHandlers };
-		if (factoryEffectHandlers) {
-			for (const [k, v] of Object.entries(factoryEffectHandlers)) if (!(k in result)) result[k] = v;
-		}
-		return result;
+		return [...runEffectHandlers ?? [], ...factoryEffectHandlers ?? []];
 	}
 	function assertNotPureWithHandlers(pure, effectHandlers) {
 		if (!pure) return;
-		if (effectHandlers && Object.keys(effectHandlers).length > 0) throw new TypeError("Cannot use pure mode with effect handlers");
+		if (effectHandlers && effectHandlers.length > 0) throw new TypeError("Cannot use pure mode with effect handlers");
 	}
 	return {
 		run(source, runOptions) {
@@ -31373,7 +31409,7 @@ function createDvala(options) {
 				const result = await evaluateWithEffects(buildAst(isDvalaBundle(source) ? source.program : source), contextStack, effectHandlers, runOptions?.maxSnapshots, {
 					values: bindings,
 					modules
-				});
+				}, runOptions?.autoCheckpoint);
 				if (result.type === "completed") return {
 					...result,
 					definedBindings: contextStack.getModuleScopeBindings()
@@ -33878,9 +33914,12 @@ async function execute(expression, bindings, readLine) {
 	try {
 		const runResult = await _dvala.runAsync(expression, {
 			bindings,
-			effectHandlers: { "dvala.io.read-line": async ({ args, resume }) => {
-				resume(await readLine(typeof args[0] === "string" ? args[0] : ""));
-			} }
+			effectHandlers: [{
+				pattern: "dvala.io.read-line",
+				handler: async ({ args, resume }) => {
+					resume(await readLine(typeof args[0] === "string" ? args[0] : ""));
+				}
+			}]
 		});
 		if (runResult.type === "error") throw runResult.error;
 		const result = runResult.type === "completed" ? runResult.value : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mojir/dvala",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "dvala",
   "author": "Albert Mojir",
   "license": "MIT",
@@ -137,7 +137,6 @@
     "build-vscode-ext": "wireit",
     "dvala": "node ./dist/cli/cli.js",
     "dev": "npx serve docs -p 9901",
-    "release": "npm version",
     "test:e2e": "npx playwright test",
     "lcov": "open-cli ./coverage/index.html",
     "mcp:inspect": "npx @modelcontextprotocol/inspector node ./dist/mcp-server/server.js"
@@ -305,9 +304,7 @@
       "output": [
         "playground-builder/build/**",
         "playground-www/build/**",
-        "docs/playground.js",
-        "docs/index.html",
-        "docs/styles.css"
+        "docs/**"
       ],
       "clean": "if-file-deleted"
     },