feature: plugma test command

Signed-off-by: Saulo Vallory <me@saulo.engineer>

Author: svallory

packages/plugma/.vscode/settings.json

@@ -1,68 +1,67 @@
 {
-  "editor.formatOnSave": trueŹ
-  "editor.defaultFormatter": "gplane.dprint2",
-  "[javascript]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[typescript]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[json]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[svelte]": {
-    "editor.defaultFormatter": "svelte.svelte-vscode"
-  },
-  "explorer.fileNesting.enabled": true,
-  "explorer.fileNesting.patterns": {
-    "Config Files.md": "biome.*, dprint.*, .env*, *.cjs, *.config.ts, *.setup.ts, .git*, *.config, *.config.json, *config.js, *config.mjs, *config.cjs, *config.ts, *config.toml, *config.yaml, *config.yml, *rc, *rc.json, *rc.js, *rc.mjs, *rc.cjs, *rc.ts, *rc.toml, *rc.yaml, *rc.yml, *ignore, Dockerfile*, docker-*, *.toml, package-lock.json, yarn.lock, pnpm-lock.yaml, .prototools, rollup.*, renovate.json, .size-limit.*, vitest*",
-    "*.json": "${capture}.lock",
-    "*.ts": "${capture}.test.ts"
-  },
-  "search.exclude": {
-    "**/coverage": true,
-    "**/dist": true,
-    "**/node_modules": true
-  },
-  "typescript.enablePromptUseWorkspaceTsdk": true,
-  "typescript.preferences.autoImportFileExcludePatterns": ["dist/**"],
-  "typescript.tsdk": "node_modules/typescript/lib",
-  "cSpell.words": [
-    "@endindex",
-    "antfu",
-    "Automator",
-    "biomejs",
-    "clickoutside",
-    "commitlint",
-    "conventionalcommits",
-    "dprint",
-    "endindex",
-    "Fong",
-    "plugma",
-    "stylelint",
-    "texthighlight",
-    "tokilabs",
-    "typecheck"
-  ],
-  "gutterpreview.enableReferenceLookup": true,
-  "gutterpreview.currentColorForSVG": "#CCC",
-  "svelte.enable-ts-plugin": true,
-  "svelte-autoimport.doubleQuotes": false,
-  "svelte.plugin.svelte.format.config.singleQuote": true,
-  "prettier.jsxSingleQuote": true,
-  "prettier.singleQuote": true,
-  "yaml.format.singleQuote": true,
-  "[jsonc]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "editor.codeActionsOnSave": {
-    "source.addMissingImports.ts": "always",
-    "source.organizeImports": "always",
-    "source.fixAll": "always",
-    "source.fixAll.biome": "always",
-    "source.organizeImports.biome": "always",
-    "source.removeUnusedImports": "always",
-    "source.sortImports": "always"
-  },
-  "vitest.rootConfig": "vitest.config.ts"
+	"editor.formatOnSave": true,
+	"editor.defaultFormatter": "gplane.dprint2",
+	"[javascript]": {
+		"editor.defaultFormatter": "biomejs.biome"
+	},
+	"[typescript]": {
+		"editor.defaultFormatter": "biomejs.biome"
+	},
+	"[json]": {
+		"editor.defaultFormatter": "biomejs.biome"
+	},
+	"[svelte]": {
+		"editor.defaultFormatter": "svelte.svelte-vscode"
+	},
+	"explorer.fileNesting.enabled": true,
+	"explorer.fileNesting.patterns": {
+		"Config Files.md": "biome.*, dprint.*, .env*, *.cjs, *.config.ts, *.setup.ts, .git*, *.config, *.config.json, *config.js, *config.mjs, *config.cjs, *config.ts, *config.toml, *config.yaml, *config.yml, *rc, *rc.json, *rc.js, *rc.mjs, *rc.cjs, *rc.ts, *rc.toml, *rc.yaml, *rc.yml, *ignore, Dockerfile*, docker-*, *.toml, package-lock.json, yarn.lock, pnpm-lock.yaml, .prototools, rollup.*, renovate.json, .size-limit.*, vitest*",
+		"*.json": "${capture}.lock",
+		"*.ts": "${capture}.test.ts"
+	},
+	"search.exclude": {
+		"**/coverage": true,
+		"**/dist": true,
+		"**/node_modules": true
+	},
+	"typescript.enablePromptUseWorkspaceTsdk": true,
+	"typescript.preferences.autoImportFileExcludePatterns": ["dist/**"],
+	"typescript.tsdk": "node_modules/typescript/lib",
+	"cSpell.words": [
+		"@endindex",
+		"antfu",
+		"Automator",
+		"biomejs",
+		"clickoutside",
+		"commitlint",
+		"conventionalcommits",
+		"dprint",
+		"endindex",
+		"Fong",
+		"plugma",
+		"stylelint",
+		"texthighlight",
+		"tokilabs",
+		"typecheck"
+	],
+	"gutterpreview.enableReferenceLookup": true,
+	"gutterpreview.currentColorForSVG": "#CCC",
+	"svelte.enable-ts-plugin": true,
+	"svelte-autoimport.doubleQuotes": false,
+	"svelte.plugin.svelte.format.config.singleQuote": true,
+	"prettier.jsxSingleQuote": true,
+	"prettier.singleQuote": true,
+	"yaml.format.singleQuote": true,
+	"[jsonc]": {
+		"editor.defaultFormatter": "biomejs.biome"
+	},
+	"editor.codeActionsOnSave": {
+		// "source.organizeImports": "always",
+		// "source.fixAll": "always",
+		// "source.fixAll.biome": "always",
+		// "source.organizeImports.biome": "always",
+		// "source.removeUnusedImports": "always",
+		// "source.sortImports": "always"
+	},
+	"vitest.rootConfig": "vitest.config.ts"
 }

packages/plugma/apps/plugma-runtime/index.ts

@@ -12,12 +12,12 @@
  */
 
 import {
-	handleDeleteClientStorage,
-	handleDeleteRootPluginData,
-	handleHideToolbar,
-	handleMaximizeWindow,
-	handleMinimizeWindow,
-	handleSaveWindowSettings
+  handleDeleteClientStorage,
+  handleDeleteRootPluginData,
+  handleHideToolbar,
+  handleMaximizeWindow,
+  handleMinimizeWindow,
+  handleSaveWindowSettings,
 } from './handlers/index.js';
 
 import type { PlugmaRuntimeData } from './types.js';

packages/plugma/apps/tsconfig.json

@@ -21,8 +21,15 @@
       "#utils": ["../src/utils/index.ts"],
       "#utils/*": ["../src/utils/*"],
       "#vite-plugins": ["../src/vite-plugins/index.ts"],
-      "#vite-plugins/*": ["../src/vite-plugins/*"]
+      "#vite-plugins/*": ["../src/vite-plugins/*"],
+      "#testing": ["../src/testing/index.ts"],
+      "#testing/*": ["../src/testing/*"]
     }
   },
-  "include": ["./**/*.js", "./**/*.ts", "./**/*.svelte"]
+  "include": [
+    "./**/*.js",
+    "./**/*.ts",
+    "./**/*.svelte",
+    "../src/testing/execute-assertions.ts"
+  ]
 }

sandbox-bkp/src/testing/README.md packages/plugma/archive/testing-poc/README.md

@@ -0,0 +1,27 @@
+// Core testing functions
+export const test = undefined;
+export const it = undefined;
+export const describe = undefined;
+export const suite = undefined;
+export const expect = undefined;
+export const assert = undefined;
+export const vitest = undefined;
+export const vi = undefined;
+
+// Lifecycle hooks
+export const beforeAll = undefined;
+export const beforeEach = undefined;
+export const afterAll = undefined;
+export const afterEach = undefined;
+
+// Mocking utilities
+export const mocked = undefined;
+export const fn = undefined;
+export const spyOn = undefined;
+
+// Advanced features
+export const waitFor = undefined;
+export const waitUntil = undefined;
+export const isFakeTimers = undefined;
+export const useFakeTimers = undefined;
+export const useRealTimers = undefined;

sandbox-bkp/src/testing/docs/how-it-works.md packages/plugma/archive/testing-poc/docs/how-it-works.md

@@ -1,9 +1,9 @@
 import { test as vitestTest } from "vitest";
+import { executeAssertions } from "./expect";
 import { disableLoggger as logger } from "./logger";
+import { registry } from "./registry";
 import type { TestFn } from "./types";
-import { executeAssertions } from "./expect";
 import { testClient } from "./ws-client";
-import { registry } from "./registry";
 
 /**
  * Configuration for test execution
@@ -84,23 +84,22 @@ export const test: TestFn = async (name, fn) => {
 	}
 
 	if (!vitestTest) {
-		throw new Error("Vitest is not available in this environment");
+		throw new Error("Vitest is not available");
 	}
 
 	// In Node: Create a Vitest test that sends a message to Figma
 	return vitestTest(name, TEST_CONFIG, async () => {
 		logger.debug("Running test:", name);
 		const testRunId = `${name}-${Date.now()}`;
-		let assertionCode: string | null = null;
+		const assertionCode: string | null = null;
 
 		try {
 			// Setup handler before sending the message
-			const assertionsPromise = new Promise<void>((resolve, reject) => {
+			const assertionsPromise = new Promise<string>((resolve, reject) => {
 				testClient.waitForTestResult(testRunId).then(
 					(response) => {
 						if (response.type === "TEST_ASSERTIONS") {
-							assertionCode = response.assertionCode;
-							resolve();
+							resolve(response.assertionCode);
 						} else {
 							reject(
 								new TestExecutionError(
@@ -125,12 +124,13 @@ export const test: TestFn = async (name, fn) => {
 			logger.debug("[test-runner] 📮 RUN_TEST:", runTestMessage);
 
 			// Send the message and wait for assertions
-			await testClient.send(runTestMessage);
-			await withTimeout(assertionsPromise, TEST_CONFIG.timeout, name);
+			const assertionCodeResult = await withTimeout(
+				assertionsPromise,
+				TEST_CONFIG.timeout,
+				name,
+			);
 
-			if (assertionCode) {
-				executeAssertions(assertionCode.split(";\n").filter(Boolean));
-			}
+			executeAssertions(assertionCodeResult.split(";\n").filter(Boolean));
 		} catch (error) {
 			if (error instanceof TestTimeoutError) {
 				logger.error("Test timed out:", error.message);

sandbox-bkp/src/testing/docs/test-module-diagnostics.md packages/plugma/archive/testing-poc/docs/test-module-diagnostics.md

@@ -1,5 +1,5 @@
-import type { TestMessage } from "./types";
 import { disableLoggger as logger } from "./logger";
+import type { TestMessage } from "./types";
 
 declare global {
 	var testWs: WebSocket | undefined;
@@ -158,15 +158,17 @@ export class TestClient {
 					}
 				}
 
-				// Also resolve the original send promise
-				const index = this.messageQueue.findIndex(
-					(item) => item.testRunId === message.testRunId,
-				);
-				if (index !== -1) {
-					const { resolve, timeoutId } = this.messageQueue[index];
-					clearTimeout(timeoutId);
-					this.messageQueue.splice(index, 1);
-					resolve();
+				if ("testRunId" in message) {
+					// Also resolve the original send promise
+					const index = this.messageQueue.findIndex(
+						(item) => item.testRunId === message.testRunId,
+					);
+					if (index !== -1) {
+						const { resolve, timeoutId } = this.messageQueue[index];
+						clearTimeout(timeoutId);
+						this.messageQueue.splice(index, 1);
+						resolve();
+					}
 				}
 			} catch (error) {
 				logger.error("[ws-client] Error handling message:", error);