@devrune/cli 1.0.0

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO```
+MIT License
+
+Copyright (c) 2026
+
+You are allowed to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of this software and its documentation, free of charge, provided that the copyright notice and this permission notice are included in all copies or significant portions of the software.
+
+This software is provided "as is", without any warranty of any kind, either express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.

package/README.md

@@ -0,0 +1,20 @@
+# Introduction 
+TODO: Give a short introduction of your project. Let this section explain the objectives or the motivation behind this project. 
+
+# Getting Started
+TODO: Guide users through getting your code up and running on their own system. In this section you can talk about:
+1.	Installation process
+2.	Software dependencies
+3.	Latest releases
+4.	API references
+
+# Build and Test
+TODO: Describe and show how to build your code and run the tests. 
+
+# Contribute
+TODO: Explain how other users and developers can contribute to make your code better. 
+
+If you want to learn more about creating good readme files then refer the following [guidelines](https://docs.microsoft.com/en-us/azure/devops/repos/git/create-a-readme?view=azure-devops). You can also seek inspiration from the below readme files:
+- [ASP.NET Core](https://github.com/aspnet/Home)
+- [Visual Studio Code](https://github.com/Microsoft/vscode)
+- [Chakra Core](https://github.com/Microsoft/ChakraCore)

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@devrune/cli",
+  "version": "1.0.0",
+  "scripts": {
+    "generate-feature": "ts-node ./scripts/generate-feature.ts",
+    "check-file-name": "ts-node ./scripts/check-file-name-style-guide.ts"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.3.0",
+    "@inquirer/select": "^5.1.0"
+  },
+  "description": "CLI tool for DevRune project. Provides commands to generate features and check file name style guide.",
+  "repository": {
+    "type": "git",
+    "url": "https://devrune@dev.azure.com/devrune/DevRune/_git/devrune-cli"
+  },
+  "author": "DevRune Team",
+  "license": "MIT",
+  "main": "index.js"
+}

package/scripts/check-file-name-style-guide.ts

@@ -0,0 +1,115 @@
+import fs from "fs";
+import path from "path";
+
+const SRC_DIR = path.join(process.cwd(), "src");
+
+const RESERVED_NEXT_FILES = new Set([
+  "page.tsx",
+  "layout.tsx",
+  "template.tsx",
+  "loading.tsx",
+  "error.tsx",
+  "global-error.tsx",
+  "not-found.tsx",
+  "default.tsx",
+  "route.ts",
+  "middleware.ts",
+  "instrumentation.ts",
+  "sitemap.ts",
+  "robots.ts",
+  "icon.tsx",
+  "apple-icon.tsx",
+  "opengraph-image.tsx",
+  "twitter-image.tsx",
+]);
+
+const IGNORED_DIRS = new Set([
+  ".husky",
+  ".next",
+  ".vscode",
+  "node_modules",
+  "public",
+  "scripts",
+  "dist",
+  "build",
+]);
+
+let hasErrors = false;
+
+const walk = (dir:string) => {
+  const files = fs.readdirSync(dir);
+
+  for (const file of files) {
+    const fullPath = path.join(dir, file);
+    const stat = fs.statSync(fullPath);
+
+    if (stat.isDirectory()) {
+      if (!IGNORED_DIRS.has(file)) {
+        walk(fullPath);
+      }
+    } else {
+      checkFile(fullPath);
+    }
+  }
+}
+
+const reportError = (filePath: string, message: string) => {
+  hasErrors = true;
+  console.log(`❌ ${filePath}`);
+  console.log(`   → ${message}\n`);
+}
+
+const checkFile = (filePath: string) => {
+  const fileName = path.basename(filePath);
+
+  //Skip non TS/TSX files, reserved Next.js files, and declaration files
+  if (!fileName.endsWith(".ts") && !fileName.endsWith(".tsx")) return;
+  if (RESERVED_NEXT_FILES.has(fileName)) return;
+  if (fileName.endsWith(".d.ts")) return;
+
+  // Check for uppercase letters
+  if (/[A-Z]/.test(fileName)) {
+    reportError(filePath, "File name should be lowercase");
+    return;
+  }
+
+  // Hooks (check hooks before UI components since hooks can also be in TSX files)
+  if (fileName.startsWith("use-") && (fileName.endsWith(".hook.ts") || fileName.endsWith(".hook.tsx"))) return;
+
+  // UI components
+  if (fileName.endsWith(".ui.tsx")) return;
+
+  // Types
+  if (fileName.endsWith(".type.ts")) return;
+
+  // Classes
+  if (fileName.endsWith(".class.ts")) return;
+
+  // Utils
+  if (fileName.endsWith(".util.ts")) return;
+
+  //Constants
+  if (fileName.endsWith(".const.ts")) return;
+
+  // API
+  if (fileName.endsWith(".api.ts")) return;
+
+  // Modals
+  if (fileName.endsWith(".modal.tsx")) return;
+
+  reportError(filePath, "File name does not follow naming convention.");
+}
+
+if (!fs.existsSync(SRC_DIR)) {
+  console.error("❌ src folder not found in the project root");
+  process.exit(1);
+}
+
+walk(SRC_DIR);
+
+if (hasErrors) {
+  console.log("⛔ Found files that do not follow the naming convention. Please fix the above issues.");
+  process.exit(1);
+} else {
+  console.log("✅ All files follow the naming convention!");
+}

package/scripts/constants.ts

@@ -0,0 +1,10 @@
+export const FEATURE_DIR = "features";
+export const SHARED_DIR = "shared";
+export const ROOT_DIR = "src";
+export const API_DIR = "api";
+export const UI_DIR = "ui";
+export const HOOKS_DIR = "hooks";
+export const UTILS_DIR = "utils";
+export const TYPES_DIR = "types";
+export const MODALS_DIR = "modals";
+// CLI api - name.api.ts, ui - name.ui.ts, hooks - name.hook.ts, utils - name.util.ts, types name.type.ts, classes - name.class.ts

package/scripts/generate-feature.ts

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { API_DIR, HOOKS_DIR, MODALS_DIR, FEATURE_DIR, ROOT_DIR, SHARED_DIR, TYPES_DIR, UI_DIR, UTILS_DIR } from "./constants";
+import select from "@inquirer/select";
+import {input} from '@inquirer/prompts';
+
+
+function toPascalCase(str: string) {
+  return str
+    .split("-")
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join("");
+}
+
+function toCamelCase(str: string) {
+  const pascalCase = toPascalCase(str);
+  return pascalCase.charAt(0).toLowerCase() + pascalCase.slice(1);
+}
+
+
+function ensureDir(dirPath: string) {
+  fs.mkdirSync(dirPath, { recursive: true });
+}
+
+
+async function main() {
+  const type = await select(
+    {
+      message: 'What do you want to create?',
+      choices: [{name: 'Feature', value: 'feature', description: 'Create feature if it should be private and nothing should be imported outside'}, {name: 'Shared', value: 'shared', description: 'Create shared feature that can be imported anywhere'}],
+    },
+  );
+
+  const name = await input(
+    {
+      message: `Enter ${type} name:`,
+      validate: (input: string) =>
+        input ? true : 'Name cannot be empty',
+    },
+  );
+
+  const ROOT_DIR_PATH = type === 'feature' ? path.join(ROOT_DIR, FEATURE_DIR) : path.join(ROOT_DIR, SHARED_DIR); 
+  ensureDir(path.join(ROOT_DIR_PATH, name));
+  fs.writeFileSync(path.join(ROOT_DIR_PATH, name, `${name}.class.ts`), `// export class ${toPascalCase(name)} = {}`);
+  ensureDir(path.join(ROOT_DIR_PATH, name, API_DIR));
+  fs.writeFileSync(path.join(ROOT_DIR_PATH, name, API_DIR, `${name}.api.ts`), `// export const ${toCamelCase(`${name}Api`)} = {}`);
+  ensureDir(path.join(ROOT_DIR_PATH, name, UI_DIR));
+  fs.writeFileSync(path.join(ROOT_DIR_PATH, name, UI_DIR, `${name}.ui.ts`), `import { ${toPascalCase(name)}Props } from '../types/${name}.type';\n\nexport const ${toPascalCase(name)} = ({}: ${toPascalCase(name)}Props) => { \n  return null;\n};`);
+  ensureDir(path.join(ROOT_DIR_PATH, name, HOOKS_DIR));
+  fs.writeFileSync(path.join(ROOT_DIR_PATH, name, HOOKS_DIR, `use-${name}.hook.ts`), `// export const ${toCamelCase(`use${toPascalCase(name)}`)} = () => {}`);
+  ensureDir(path.join(ROOT_DIR_PATH, name, UTILS_DIR));
+  fs.writeFileSync(path.join(ROOT_DIR_PATH, name, UTILS_DIR, `${name}.util.ts`), `// utils for ${name} feature`);
+  ensureDir(path.join(ROOT_DIR_PATH, name, TYPES_DIR));
+  fs.writeFileSync(path.join(ROOT_DIR_PATH, name, TYPES_DIR, `${name}.type.ts`), `// export type ${toPascalCase(name)}ModalProps = {};\nexport type ${toPascalCase(name)}Props = {};`);
+  ensureDir(path.join(ROOT_DIR_PATH, name, MODALS_DIR));
+  fs.writeFileSync(path.join(ROOT_DIR_PATH, name, MODALS_DIR, `${name}.modal.ts`), `// import { ${toPascalCase(name)}ModalProps } from '../types/${name}.type';\n\n// export const ${toPascalCase(name)}Modal = ({}: ${toPascalCase(name)}ModalProps) => {\n//   return null;\n// };`);
+
+}
+
+main()
+  .catch((e) => {
+    console.error(e);
+    process.exit(1);
+  });

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "esModuleInterop": true,
+    "strict": true
+  }
+}