create-moost 0.5.32 → 0.6.0

package/README.md

@@ -21,7 +21,7 @@ To create a Moost HTTP app, use the following command in your terminal:
 npm create moost -- --http
 ```
 
-This command will initiate the creation of a new Moost HTTP app. It will prompt you with a series of questions to configure your app, such as enabling eslint and prettier, and choosing between the esbuild and rollup bundlers.
+This command will initiate the creation of a new Moost HTTP app. It will prompt you to configure the project name, whether to include a Moost Workflows example, and whether to add do-me-lint (smart eslint installer).
 
 ### Creating a CLI App
 
@@ -31,6 +31,6 @@ To create a Moost CLI app, use the following command in your terminal:
 npm create moost -- --cli
 ```
 
-This command will start the creation process for a new Moost CLI app. It will ask you questions to customize your app, including eslint and prettier preferences, as well as the choice between the esbuild and rollup bundlers.
+This command will start the creation process for a new Moost CLI app. It will prompt you to configure the project name and whether to add do-me-lint (smart eslint installer).
 
 ## [Official Documentation](https://moost.org/)

package/dist/index.cjs

@@ -63,24 +63,35 @@ async function getPrompts(inputs) {
 			{
 				name: "type",
 				type: () => {
-					if (inputs.cli && !inputs.http) {
+					if (inputs.ws && !inputs.cli && !inputs.http) {
+						predefined.type = "ws";
+						return null;
+					}
+					if (inputs.cli && !inputs.http && !inputs.ws) {
 						predefined.type = "cli";
 						return null;
 					}
-					if (!inputs.cli && inputs.http) {
+					if (inputs.http && !inputs.cli && !inputs.ws) {
 						predefined.type = "http";
 						return null;
 					}
 					return "select";
 				},
 				message: "Moost Adapter:",
-				choices: [{
-					title: "HTTP (Web) Application",
-					value: "http"
-				}, {
-					title: "CLI Application",
-					value: "cli"
-				}]
+				choices: [
+					{
+						title: "HTTP (Web) Application",
+						value: "http"
+					},
+					{
+						title: "WebSocket Application",
+						value: "ws"
+					},
+					{
+						title: "CLI Application",
+						value: "cli"
+					}
+				]
 			},
 			{
 				name: "packageName",
@@ -89,18 +100,34 @@ async function getPrompts(inputs) {
 				initial: () => toValidPackageName(predefined.targetDir),
 				validate: (dir) => isValidPackageName(dir) || "Invalid package.json name"
 			},
+			{
+				name: "ws",
+				type: (prev, values) => {
+					const type = values.type || predefined.type;
+					if (type !== "http" || inputs.ws) return null;
+					return "toggle";
+				},
+				message: "Add WebSockets?",
+				initial: false,
+				active: "Yes",
+				inactive: "No"
+			},
 			{
 				name: "wf",
-				type: (prev, values) => inputs.wf || values.type === "cli" || inputs.cli ? null : "toggle",
+				type: (prev, values) => {
+					const type = values.type || predefined.type;
+					if (inputs.wf || type === "cli" || type === "ws") return null;
+					return "toggle";
+				},
 				message: "Add Moost Workflows Example?",
 				initial: false,
 				active: "Yes",
 				inactive: "No"
 			},
 			{
-				name: "domelint",
-				type: () => inputs.domelint ? null : "toggle",
-				message: "Add do-me-lint (smart eslint installer)?",
+				name: "oxc",
+				type: () => inputs.oxc ? null : "toggle",
+				message: "Add OXC lint and formatter (oxlint + oxfmt)?",
 				initial: false,
 				active: "Yes",
 				inactive: "No"
@@ -129,7 +156,7 @@ function isValidPackageName(projectName) {
 	return /^(?:@[\d*a-z~-][\d*._a-z~-]*\/)?[\da-z~-][\d._a-z~-]*$/.test(projectName);
 }
 function toValidPackageName(projectName) {
-	return projectName.trim().toLowerCase().replace(/\s+/g, "-").replace(/^[._]/, "").replace(/[^\da-z~-]+/g, "-");
+	return projectName.trim().toLowerCase().replaceAll(/\s+/g, "-").replace(/^[._]/, "").replaceAll(/[^\da-z~-]+/g, "-");
 }
 
 //#endregion
@@ -139,9 +166,8 @@ const rw = new __prostojs_rewrite.ProstoRewrite({ textPattern: [
 	"Dockerfile",
 	"*config",
 	".gitignore",
-	".eslintrc.json",
-	".prettierignore",
-	".prettierrc"
+	".oxlintrc.json",
+	".oxfmtrc.json"
 ] });
 const root = process.cwd();
 const { version } = JSON.parse((0, fs.readFileSync)((0, path.join)(__dirname, "../package.json")).toString());
@@ -150,39 +176,43 @@ async function scaffold(data) {
 	if ((0, fs.existsSync)(projectDir)) {
 		if (data.overwrite) emptyDirectorySync(projectDir);
 	} else (0, fs.mkdirSync)(projectDir);
-	const templatePath = (0, path.join)(__dirname, "../templates", data.type);
+	const templatePath = (0, path.join)(__dirname, "../templates", data.type === "ws" ? "ws" : data.type);
 	const commonPath = (0, path.join)(__dirname, "../templates/common");
 	const wfPath = (0, path.join)(__dirname, "../templates/wf");
+	const wsAddonPath = (0, path.join)(__dirname, "../templates/ws-addon");
 	const context = {
 		...data,
 		version
 	};
 	const excludeCommon = [];
-	if (!data.domelint) excludeCommon.push(".domelintrc.yml");
+	if (!data.oxc) {
+		excludeCommon.push(".oxlintrc.json");
+		excludeCommon.push(".oxfmtrc.json");
+	}
+	const renameFile = (filename) => {
+		if (filename.endsWith(".jsonc")) return filename.replace(/c$/, "");
+		return filename;
+	};
 	await rw.rewriteDir({
 		baseDir: templatePath,
 		output: projectDir,
-		renameFile(filename) {
-			if (filename.endsWith(".jsonc")) return filename.replace(/c$/, "");
-			return filename;
-		}
+		renameFile
 	}, context);
 	await rw.rewriteDir({
 		baseDir: commonPath,
 		output: projectDir,
 		exclude: excludeCommon,
-		renameFile(filename) {
-			if (filename.endsWith(".jsonc")) return filename.replace(/c$/, "");
-			return filename;
-		}
+		renameFile
 	}, context);
-	if (data.wf) await rw.rewriteDir({
+	if (data.wf && data.type === "http") await rw.rewriteDir({
 		baseDir: wfPath,
 		output: projectDir,
-		renameFile(filename) {
-			if (filename.endsWith(".jsonc")) return filename.replace(/c$/, "");
-			return filename;
-		}
+		renameFile
+	}, context);
+	if (data.ws && data.type === "http") await rw.rewriteDir({
+		baseDir: wsAddonPath,
+		output: projectDir,
+		renameFile
 	}, context);
 }
 function emptyDirectorySync(directory) {
@@ -219,18 +249,20 @@ let Commands = class Commands$1 extends __moostjs_event_cli.CliApp {
 		return this.execute(name);
 	}
 	async execute(name) {
-		(0, __wooksjs_event_cli.useAutoHelp)() && process.exit(0);
+		if ((0, __wooksjs_event_cli.useAutoHelp)()) process.exit(0);
 		const prompts$2 = await getPrompts({
 			name,
 			http: !!(0, __wooksjs_event_cli.useCliOption)("http"),
 			cli: !!(0, __wooksjs_event_cli.useCliOption)("cli"),
+			ws: !!(0, __wooksjs_event_cli.useCliOption)("ws"),
 			wf: !!(0, __wooksjs_event_cli.useCliOption)("wf"),
-			domelint: !!(0, __wooksjs_event_cli.useCliOption)("domelint"),
+			oxc: !!(0, __wooksjs_event_cli.useCliOption)("oxc"),
 			force: !!(0, __wooksjs_event_cli.useCliOption)("force")
 		});
 		console.log("\nScaffolding a new project...");
 		await scaffold(prompts$2);
 		const cli = prompts$2.type === "cli";
+		const ws = prompts$2.type === "ws";
 		return `
 Success! Your new "${prompts$2.projectName}" project has been created successfully. 
 
@@ -245,10 +277,10 @@ ${cli ? `
 3. Make bin.js executable:
    chmod +x ./bin.js 
 ` : ""}
-${cli ? "4" : "3"}. Start the development server:
+${cli ? "4" : "3"}. ${ws ? "Build and start" : "Start the development server"}:
    npm run dev${cli ? " -- hello World" : ""}
 
-You're all set! The development server will help you in building your application.
+You're all set!${ws ? "" : " The development server will help you in building your application."}
 Enjoy coding, and build something amazing!
 `;
 	}
@@ -278,14 +310,19 @@ function run() {
 			description: "Use Moost CLI",
 			type: Boolean
 		},
+		{
+			keys: ["ws"],
+			description: "Use Moost WebSocket",
+			type: Boolean
+		},
 		{
 			keys: ["wf"],
 			description: "Add Workflow Adapter",
 			type: Boolean
 		},
 		{
-			keys: ["domelint"],
-			description: "Add do-me-lint (smart eslint installer)",
+			keys: ["oxc"],
+			description: "Add OXC lint and formatter (oxlint + oxfmt)",
 			type: Boolean
 		},
 		{

package/dist/index.mjs

@@ -40,24 +40,35 @@ async function getPrompts(inputs) {
 			{
 				name: "type",
 				type: () => {
-					if (inputs.cli && !inputs.http) {
+					if (inputs.ws && !inputs.cli && !inputs.http) {
+						predefined.type = "ws";
+						return null;
+					}
+					if (inputs.cli && !inputs.http && !inputs.ws) {
 						predefined.type = "cli";
 						return null;
 					}
-					if (!inputs.cli && inputs.http) {
+					if (inputs.http && !inputs.cli && !inputs.ws) {
 						predefined.type = "http";
 						return null;
 					}
 					return "select";
 				},
 				message: "Moost Adapter:",
-				choices: [{
-					title: "HTTP (Web) Application",
-					value: "http"
-				}, {
-					title: "CLI Application",
-					value: "cli"
-				}]
+				choices: [
+					{
+						title: "HTTP (Web) Application",
+						value: "http"
+					},
+					{
+						title: "WebSocket Application",
+						value: "ws"
+					},
+					{
+						title: "CLI Application",
+						value: "cli"
+					}
+				]
 			},
 			{
 				name: "packageName",
@@ -66,18 +77,34 @@ async function getPrompts(inputs) {
 				initial: () => toValidPackageName(predefined.targetDir),
 				validate: (dir) => isValidPackageName(dir) || "Invalid package.json name"
 			},
+			{
+				name: "ws",
+				type: (prev, values) => {
+					const type = values.type || predefined.type;
+					if (type !== "http" || inputs.ws) return null;
+					return "toggle";
+				},
+				message: "Add WebSockets?",
+				initial: false,
+				active: "Yes",
+				inactive: "No"
+			},
 			{
 				name: "wf",
-				type: (prev, values) => inputs.wf || values.type === "cli" || inputs.cli ? null : "toggle",
+				type: (prev, values) => {
+					const type = values.type || predefined.type;
+					if (inputs.wf || type === "cli" || type === "ws") return null;
+					return "toggle";
+				},
 				message: "Add Moost Workflows Example?",
 				initial: false,
 				active: "Yes",
 				inactive: "No"
 			},
 			{
-				name: "domelint",
-				type: () => inputs.domelint ? null : "toggle",
-				message: "Add do-me-lint (smart eslint installer)?",
+				name: "oxc",
+				type: () => inputs.oxc ? null : "toggle",
+				message: "Add OXC lint and formatter (oxlint + oxfmt)?",
 				initial: false,
 				active: "Yes",
 				inactive: "No"
@@ -106,7 +133,7 @@ function isValidPackageName(projectName) {
 	return /^(?:@[\d*a-z~-][\d*._a-z~-]*\/)?[\da-z~-][\d._a-z~-]*$/.test(projectName);
 }
 function toValidPackageName(projectName) {
-	return projectName.trim().toLowerCase().replace(/\s+/g, "-").replace(/^[._]/, "").replace(/[^\da-z~-]+/g, "-");
+	return projectName.trim().toLowerCase().replaceAll(/\s+/g, "-").replace(/^[._]/, "").replaceAll(/[^\da-z~-]+/g, "-");
 }
 
 //#endregion
@@ -116,9 +143,8 @@ const rw = new ProstoRewrite({ textPattern: [
 	"Dockerfile",
 	"*config",
 	".gitignore",
-	".eslintrc.json",
-	".prettierignore",
-	".prettierrc"
+	".oxlintrc.json",
+	".oxfmtrc.json"
 ] });
 const root = process.cwd();
 const { version } = JSON.parse(readFileSync(join(__dirname, "../package.json")).toString());
@@ -127,39 +153,43 @@ async function scaffold(data) {
 	if (existsSync(projectDir)) {
 		if (data.overwrite) emptyDirectorySync(projectDir);
 	} else mkdirSync(projectDir);
-	const templatePath = join(__dirname, "../templates", data.type);
+	const templatePath = join(__dirname, "../templates", data.type === "ws" ? "ws" : data.type);
 	const commonPath = join(__dirname, "../templates/common");
 	const wfPath = join(__dirname, "../templates/wf");
+	const wsAddonPath = join(__dirname, "../templates/ws-addon");
 	const context = {
 		...data,
 		version
 	};
 	const excludeCommon = [];
-	if (!data.domelint) excludeCommon.push(".domelintrc.yml");
+	if (!data.oxc) {
+		excludeCommon.push(".oxlintrc.json");
+		excludeCommon.push(".oxfmtrc.json");
+	}
+	const renameFile = (filename) => {
+		if (filename.endsWith(".jsonc")) return filename.replace(/c$/, "");
+		return filename;
+	};
 	await rw.rewriteDir({
 		baseDir: templatePath,
 		output: projectDir,
-		renameFile(filename) {
-			if (filename.endsWith(".jsonc")) return filename.replace(/c$/, "");
-			return filename;
-		}
+		renameFile
 	}, context);
 	await rw.rewriteDir({
 		baseDir: commonPath,
 		output: projectDir,
 		exclude: excludeCommon,
-		renameFile(filename) {
-			if (filename.endsWith(".jsonc")) return filename.replace(/c$/, "");
-			return filename;
-		}
+		renameFile
 	}, context);
-	if (data.wf) await rw.rewriteDir({
+	if (data.wf && data.type === "http") await rw.rewriteDir({
 		baseDir: wfPath,
 		output: projectDir,
-		renameFile(filename) {
-			if (filename.endsWith(".jsonc")) return filename.replace(/c$/, "");
-			return filename;
-		}
+		renameFile
+	}, context);
+	if (data.ws && data.type === "http") await rw.rewriteDir({
+		baseDir: wsAddonPath,
+		output: projectDir,
+		renameFile
 	}, context);
 }
 function emptyDirectorySync(directory) {
@@ -196,18 +226,20 @@ let Commands = class Commands$1 extends CliApp {
 		return this.execute(name);
 	}
 	async execute(name) {
-		useAutoHelp() && process.exit(0);
+		if (useAutoHelp()) process.exit(0);
 		const prompts$1 = await getPrompts({
 			name,
 			http: !!useCliOption("http"),
 			cli: !!useCliOption("cli"),
+			ws: !!useCliOption("ws"),
 			wf: !!useCliOption("wf"),
-			domelint: !!useCliOption("domelint"),
+			oxc: !!useCliOption("oxc"),
 			force: !!useCliOption("force")
 		});
 		console.log("\nScaffolding a new project...");
 		await scaffold(prompts$1);
 		const cli = prompts$1.type === "cli";
+		const ws = prompts$1.type === "ws";
 		return `
 Success! Your new "${prompts$1.projectName}" project has been created successfully. 
 
@@ -222,10 +254,10 @@ ${cli ? `
 3. Make bin.js executable:
    chmod +x ./bin.js 
 ` : ""}
-${cli ? "4" : "3"}. Start the development server:
+${cli ? "4" : "3"}. ${ws ? "Build and start" : "Start the development server"}:
    npm run dev${cli ? " -- hello World" : ""}
 
-You're all set! The development server will help you in building your application.
+You're all set!${ws ? "" : " The development server will help you in building your application."}
 Enjoy coding, and build something amazing!
 `;
 	}
@@ -255,14 +287,19 @@ function run() {
 			description: "Use Moost CLI",
 			type: Boolean
 		},
+		{
+			keys: ["ws"],
+			description: "Use Moost WebSocket",
+			type: Boolean
+		},
 		{
 			keys: ["wf"],
 			description: "Add Workflow Adapter",
 			type: Boolean
 		},
 		{
-			keys: ["domelint"],
-			description: "Add do-me-lint (smart eslint installer)",
+			keys: ["oxc"],
+			description: "Add OXC lint and formatter (oxlint + oxfmt)",
 			type: Boolean
 		},
 		{

package/package.json

@@ -1,12 +1,39 @@
 {
   "name": "create-moost",
-  "version": "0.5.32",
+  "version": "0.6.0",
   "description": "create-moost",
+  "keywords": [
+    "composables",
+    "framework",
+    "moost",
+    "moostjs",
+    "prostojs",
+    "wooksjs"
+  ],
+  "homepage": "https://github.com/moostjs/moostjs/tree/main/packages/create-moost#readme",
+  "bugs": {
+    "url": "https://github.com/moostjs/moostjs/issues"
+  },
+  "license": "MIT",
+  "author": "Artem Maltsev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moostjs/moostjs.git",
+    "directory": "packages/create-moost"
+  },
+  "bin": {
+    "create-moost": "./bin.cjs"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "bin.js"
+  ],
+  "type": "module",
+  "sideEffects": false,
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
-  "sideEffects": false,
-  "type": "module",
   "exports": {
     "./package.json": "./package.json",
     ".": {
@@ -15,47 +42,20 @@
       "require": "./dist/index.cjs"
     }
   },
-  "bin": {
-    "create-moost": "./bin.cjs"
-  },
-  "files": [
-    "dist",
-    "templates",
-    "bin.js"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/moostjs/moostjs.git",
-    "directory": "packages/create-moost"
-  },
-  "keywords": [
-    "moost",
-    "moostjs",
-    "composables",
-    "framework",
-    "wooksjs",
-    "prostojs"
-  ],
-  "author": "Artem Maltsev",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/moostjs/moostjs/issues"
-  },
-  "homepage": "https://github.com/moostjs/moostjs/tree/main/packages/create-moost#readme",
   "dependencies": {
     "@prostojs/rewrite": "^0.1.1",
-    "@wooksjs/event-cli": "^0.6.2",
+    "@wooksjs/event-cli": "^0.7.3",
     "prompts": "^2.4.2",
-    "@moostjs/event-cli": "^0.5.32",
-    "moost": "^0.5.32"
+    "@moostjs/event-cli": "^0.6.0",
+    "moost": "^0.6.0"
   },
   "devDependencies": {
     "@types/prompts": "^2.4.9",
     "rolldown": "1.0.0-beta.19",
-    "unplugin-swc": "^1.5.5",
-    "vite": "^6.1.0",
+    "unplugin-swc": "^1.5.9",
+    "vite": "^6.4.1",
     "vitest": "3.2.4",
-    "@moostjs/vite": "^0.5.32"
+    "@moostjs/vite": "^0.6.0"
   },
   "scripts": {
     "pub": "pnpm publish --access public",

package/templates/cli/package.jsonc

@@ -12,11 +12,13 @@
     "bin.js"
   ],
   "scripts": {
-//=IF (domelint)
-    "postinstall": "npx do-me-lint",
-//=END IF
     "dev": "pnpm build && node ./dist/main.js",
     "build": "rolldown build -c rolldown.config.ts",
+//=IF (oxc)
+    "lint": "oxlint",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check .",
+//=END IF
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "keywords": [],
@@ -26,8 +28,12 @@
     "@moostjs/event-cli": "^{{ version }}"
   },
   "devDependencies": {
+//=IF (oxc)
+    "oxlint": "^1.49.0",
+    "oxfmt": "^0.34.0",
+//=END IF
     "typescript": "^5.7.2",
-    "unplugin-swc": "^1.5.1",
-    "rolldown": "1.0.0-beta.3"
+    "unplugin-swc": "^1.5.9",
+    "rolldown": "1.0.0-beta.19"
   }
 }

package/templates/common/.oxfmtrc.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": false,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "insertFinalNewline": true
+}

package/templates/common/.oxlintrc.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["import", "typescript"],
+  "env": {
+    "es2021": true,
+    "node": true
+  },
+  "categories": {
+    "correctness": "error",
+    "suspicious": "warn"
+  },
+  "ignorePatterns": ["node_modules", "dist"],
+  "rules": {
+    "no-unused-vars": "off",
+    "no-use-before-define": "off",
+    "no-inline-comments": "off",
+    "no-warning-comments": "off",
+    "no-negated-condition": "off",
+    "no-shadow": "off",
+
+    "eqeqeq": "error",
+    "prefer-const": "error",
+    "prefer-template": "error",
+    "no-var": "error",
+    "curly": "error",
+    "no-self-compare": "error",
+    "no-template-curly-in-string": "error",
+    "array-callback-return": "error",
+
+    "import/first": "error",
+    "import/no-duplicates": "error",
+    "import/no-self-import": "error",
+    "import/no-default-export": "error",
+    "import/consistent-type-specifier-style": ["error", "prefer-top-level"],
+
+    "typescript/consistent-type-imports": "error",
+    "typescript/no-extraneous-class": "off",
+    "typescript/no-explicit-any": "warn",
+    "typescript/no-non-null-assertion": "warn",
+
+    "max-params": ["warn", { "max": 4 }],
+    "complexity": "off",
+    "max-lines-per-function": "off",
+    "max-statements": "off"
+  },
+  "overrides": [
+    {
+      "files": ["**/*.config.*"],
+      "rules": {
+        "import/no-default-export": "off"
+      }
+    }
+  ]
+}

package/templates/http/package.jsonc

@@ -5,31 +5,38 @@
   "main": "dist/main.js",
   "type": "module",
   "scripts": {
-//=IF (domelint)
-    "postinstall": "npx do-me-lint",
-//=END IF
     "dev": "vite dev",
     "build": "vite build",
+//=IF (oxc)
+    "lint": "oxlint",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check .",
+//=END IF
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
   "dependencies": {
-//=IF (type === 'http')
     "@moostjs/event-http": "^{{ version }}",
+//=IF (ws)
+    "@moostjs/event-ws": "^{{ version }}",
 //=END IF
 //=IF (wf)
     "@moostjs/event-wf": "^{{ version }}",
-    "@wooksjs/http-static": "^0.6.0",
+    "@wooksjs/http-static": "^0.7.3",
 //=END IF
     "moost": "^{{ version }}"
   },
   "devDependencies": {
     "@moostjs/vite": "^{{ version }}",
     "@types/node": "^22.10.2",
+//=IF (oxc)
+    "oxlint": "^1.49.0",
+    "oxfmt": "^0.34.0",
+//=END IF
     "typescript": "^5.7.2",
-    "unplugin-swc": "^1.5.1",
-    "vite": "^6.1.0"
+    "unplugin-swc": "^1.5.9",
+    "vite": "^7.0.0"
   }
 }

package/templates/http/src/main.ts

@@ -1,49 +1,48 @@
-/**
- * @file Main Entry Point for Moost Application Template
- *
- * This file serves as the primary entry point for the Moost application.
- *
- * For more details on Moost Webapp and Moost Workflows, visit:
- * - Moost Webapp: https://moost.org/webapp/
- * - Moost Workflows: https://moost.org/wf/
- */
-
 import { MoostHttp } from "@moostjs/event-http";
+//=IF (ws)
+import { MoostWs } from "@moostjs/event-ws";
+//=END IF
 //=IF (wf)
 import { MoostWf } from "@moostjs/event-wf";
 //=END IF
 import { Moost } from "moost";
 
 import { AppController } from "./controllers/app.controller";
+//=IF (ws)
+import { WsController } from "./controllers/ws.controller";
+//=END IF
 //=IF (wf)
 import { WfController } from "./workflow/wf.controller";
 //=END IF
 
-/**
- * Initializes and configures the Moost application.
- *
- * The application performs the following steps:
- * 1. Creates a new instance of the Moost application.
- * 2. Sets up the moost adapters.
- * 3. Registers controllers.
- * 4. Initializes the application to start handling incoming events.
- */
 const app = new Moost();
 
 // Configure the HTTP adapter and start listening on port 3000
-app.adapter(new MoostHttp()).listen(3000, () => {
+const http = new MoostHttp();
+app.adapter(http).listen(3000, () => {
   app.getLogger("[{{ projectName }}]").info("Server started on port 3000");
 });
 
+//=IF (ws)
+// Configure the WebSocket adapter integrated with the HTTP server
+app.adapter(new MoostWs({ httpApp: http }));
+//=END IF
+
 //=IF (wf)
 // Configure the Workflow adapter to handle workflow-related events
 app.adapter(new MoostWf());
 //=END IF
 
 // Register application controllers
-//=IF (wf)
+//=IF (wf && ws)
+app.registerControllers(AppController, WsController, WfController).init();
+//=END IF
+//=IF (wf && !ws)
 app.registerControllers(AppController, WfController).init();
 //=END IF
-//=IF (!wf)
+//=IF (!wf && ws)
+app.registerControllers(AppController, WsController).init();
+//=END IF
+//=IF (!wf && !ws)
 app.registerControllers(AppController).init();
 //=END IF

package/templates/wf/src/workflow/wf2html.interceptor.ts

@@ -20,8 +20,8 @@
 
 import { Body } from "@moostjs/event-http";
 import type { TFlowOutput } from "@moostjs/event-wf";
-import type { TInterceptorClass, TInterceptorFn } from "moost";
-import { Injectable, Intercept } from "moost";
+import type { TOvertakeFn } from "moost";
+import { After, Before, Intercept, Interceptor, Overtake, Response } from "moost";
 
 import { decryptState, encryptState } from "./wf.encrypt";
 import type {
@@ -38,65 +38,45 @@ import type {
  * This interceptor handles the encryption and decryption of the workflow state to ensure
  * secure transmission between the backend and frontend.
  */
-@Injectable("FOR_EVENT")
-class Wf2HtmlPageInterceptor implements TInterceptorClass {
-  /**
-   * The input payload containing user inputs and the workflow state.
-   *
-   * @type {TWfExampleInput & { wfState: string | TWfState | undefined }}
-   */
+@Interceptor(undefined, "FOR_EVENT")
+class Wf2HtmlPageInterceptor {
   @Body()
   input?: TWfExampleInput & { wfState: string | TWfState | undefined };
 
   /**
-   * The interceptor handler function that processes workflow events.
-   *
-   * @type {TInterceptorFn}
+   * Pre-processing: decrypts the workflow state if it is a string,
+   * or clears it if it is not.
    */
-  handler: TInterceptorFn = (before, after) => {
-    /**
-     * Pre-processing step executed before the main workflow logic.
-     *
-     * - Decrypts the workflow state if it is a string.
-     * - Clears the workflow state if it is not a string.
-     *
-     * @function before
-     */
-    before(() => {
-      if (typeof this.input?.wfState === "string") {
-        this.input.wfState = decryptState(this.input.wfState);
-      } else if (this.input) {
-        this.input.wfState = undefined;
-      }
-    });
+  @Before()
+  decryptState() {
+    if (typeof this.input?.wfState === "string") {
+      this.input.wfState = decryptState(this.input.wfState);
+    } else if (this.input) {
+      this.input.wfState = undefined;
+    }
+  }
 
-    /**
-     * Post-processing step executed after the main workflow logic.
-     *
-     * - Renders an input form if additional inputs are required.
-     * - Renders the final output page if the workflow has finished.
-     *
-     * @function after
-     * @param {TFlowOutput<TWfExampleContext, TWfExampleInput, TWfExampleInputSchema>} response - The workflow response.
-     * @param {Function} reply - The function to send the HTTP response.
-     */
-    after((response, reply) => {
-      const wfOutput = response as TFlowOutput<
-        TWfExampleContext,
-        TWfExampleInput,
-        TWfExampleInputSchema
-      >;
+  /**
+   * Post-processing: renders an HTML input form or final output page
+   * based on the workflow response.
+   */
+  @After()
+  renderOutput(@Response() response: unknown, @Overtake() reply: TOvertakeFn) {
+    const wfOutput = response as TFlowOutput<
+      TWfExampleContext,
+      TWfExampleInput,
+      TWfExampleInputSchema
+    >;
 
-      if (wfOutput.inputRequired) {
-        reply(
-          renderInputPage(wfOutput.inputRequired, encryptState(wfOutput.state))
-        );
-      }
-      if (wfOutput.finished) {
-        reply(renderOutputPage(wfOutput.state.context));
-      }
-    });
-  };
+    if (wfOutput.inputRequired) {
+      reply(
+        renderInputPage(wfOutput.inputRequired, encryptState(wfOutput.state))
+      );
+    }
+    if (wfOutput.finished) {
+      reply(renderOutputPage(wfOutput.state.context));
+    }
+  }
 }
 
 /**

package/templates/ws/README.md

@@ -0,0 +1,74 @@
+# {{ projectName }}
+
+## Moost WebSocket Template
+
+This template provides a standalone WebSocket application using Moost WS. It demonstrates how to handle WebSocket connections and messages with decorators.
+
+## Prerequisites
+
+- Node.js (v18 or later)
+- A package manager like [npm](https://www.npmjs.com/)
+
+## Installation
+
+This template is installed via:
+
+```bash
+npm create moost@latest -- --ws
+```
+
+After the setup, navigate into the project folder and install dependencies:
+
+```bash
+cd {{ packageName }}
+npm install
+```
+
+## Running Locally
+
+### Development Mode
+
+```bash
+npm run dev
+```
+
+This command builds the project and starts the WebSocket server on port 3000.
+
+### Build for Production
+
+```bash
+npm run build
+node ./dist/main.js
+```
+
+## WebSocket Protocol
+
+The server uses a JSON-based message protocol. Send messages in this format:
+
+```json
+{
+  "event": "message",
+  "data": { "text": "Hello!" }
+}
+```
+
+The server will reply with:
+
+```json
+{
+  "event": "message",
+  "data": { "echo": { "text": "Hello!" } }
+}
+```
+
+## Files Overview
+
+- **`src/main.ts`** - Defines WebSocket handlers using decorators.
+- **`rolldown.config.ts`** - Build configuration (including SWC for decorators).
+- **`package.json`** - Contains scripts, dependencies, and configuration.
+
+## Customization
+
+- **Add New Message Handlers:** Use `@Message(event, path?)` to handle different event types.
+- **Access Connection Info:** Use `@ConnectionId()` to get the connection UUID.
+- **Use Rooms:** Import `useWsRooms()` from `@moostjs/event-ws` for room-based messaging.

package/templates/ws/package.jsonc

@@ -0,0 +1,33 @@
+{
+  "name": "{{ packageName }}",
+  "version": "1.0.0",
+  "description": "",
+  "main": "dist/main.js",
+  "type": "module",
+  "scripts": {
+    "dev": "npm run build && node ./dist/main.js",
+    "build": "rolldown build -c rolldown.config.ts",
+//=IF (oxc)
+    "lint": "oxlint",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check .",
+//=END IF
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@moostjs/event-ws": "^{{ version }}",
+    "moost": "^{{ version }}"
+  },
+  "devDependencies": {
+//=IF (oxc)
+    "oxlint": "^1.49.0",
+    "oxfmt": "^0.34.0",
+//=END IF
+    "typescript": "^5.7.2",
+    "unplugin-swc": "^1.5.9",
+    "rolldown": "1.0.0-beta.19"
+  }
+}

package/templates/ws/rolldown.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from 'rolldown'
+import swc from 'unplugin-swc';
+
+export default defineConfig({
+    input: 'src/main.ts',
+    output: {
+        format: 'esm',
+        file: 'dist/main.js',
+    },
+    external: ['@moostjs/event-ws', 'moost'],
+    plugins: [
+        swc.rolldown(),
+    ]
+})

package/templates/ws/src/main.ts

@@ -0,0 +1,34 @@
+import {
+  WsApp,
+  Connect,
+  Disconnect,
+  Message,
+  MessageData,
+  ConnectionId,
+  Controller,
+} from '@moostjs/event-ws'
+
+@Controller()
+class ChatController {
+  @Connect()
+  onConnect(@ConnectionId() id: string) {
+    console.log(`Client connected: ${id}`)
+  }
+
+  @Message('message')
+  onMessage(@MessageData() data: unknown) {
+    return { echo: data }
+  }
+
+  @Disconnect()
+  onDisconnect(@ConnectionId() id: string) {
+    console.log(`Client disconnected: ${id}`)
+  }
+}
+
+new WsApp()
+  .controllers(ChatController)
+  .start(3000)
+  .then(() => {
+    console.log('WebSocket server started on port 3000')
+  })

package/templates/ws-addon/src/controllers/ws.controller.ts

@@ -0,0 +1,43 @@
+import { Upgrade } from "@moostjs/event-http";
+import {
+  Connect,
+  ConnectionId,
+  Disconnect,
+  Message,
+  MessageData,
+  WooksWs,
+} from "@moostjs/event-ws";
+import { Controller, Param } from "moost";
+
+/**
+ * `WsController` handles the WebSocket upgrade route
+ * and WebSocket message/connection events.
+ *
+ * The @Upgrade decorator registers an HTTP route that upgrades
+ * the connection to WebSocket. Message handlers use the
+ * @Message decorator to handle incoming WebSocket messages.
+ */
+@Controller()
+export class WsController {
+  constructor(private ws: WooksWs) {}
+
+  @Upgrade("ws")
+  handleUpgrade() {
+    return this.ws.upgrade();
+  }
+
+  @Connect()
+  onConnect(@ConnectionId() id: string) {
+    console.log(`WS client connected: ${id}`);
+  }
+
+  @Message("message")
+  onMessage(@MessageData() data: unknown) {
+    return { echo: data };
+  }
+
+  @Disconnect()
+  onDisconnect(@ConnectionId() id: string) {
+    console.log(`WS client disconnected: ${id}`);
+  }
+}

package/templates/common/.domelintrc.yml

@@ -1,14 +0,0 @@
-ignoredRules:
-  # for Moost controllers: they don't typically use 'this'
-  - '@typescript-eslint/class-methods-use-this'
-
-  # For Moost decorators: it's common to pull url route params from the url
-  - max-params
-
-  # Too strict, hinders readability
-  - '@typescript-eslint/strict-boolean-expressions'
-
-  # Empty class is a valid use case for Moost's controller composition
-  - '@typescript-eslint/no-extraneous-class'
-
-  - '@typescript-eslint/consistent-type-imports'