@langpkg/mcs_gen 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maysara Elshewehy (https://github.com/maysara-elshewehy)
+
+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 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,54 @@
+<!-- ╔═══════════════════════════ BEG ════════════════════════════╗ -->
+
+<br>
+<div align="center">
+    <p>
+        <img src="./assets/img/logo.png" alt="logo" style="" height="60" />
+    </p>
+</div>
+
+<div align="center">
+    <p align="center" style="font-style:italic; color:gray;">
+        ----------------<br>
+    </p>
+    <img data="version" src="https://img.shields.io/badge/v-0.0.1-black"/>
+    <a href="https://github.com/langpkg/pkg"><img src="https://img.shields.io/badge/part of-langpkg/pkg-black"/></a>
+    <br>
+    <img src="https://img.shields.io/badge/coverage-~%25-brightgreen" alt="Test Coverage" />
+    <img src="https://img.shields.io/github/issues/langpkg/mcs_gen?style=flat" alt="Github Repo Issues" />
+    <img src="https://img.shields.io/github/stars/langpkg/mcs_gen?style=social" alt="GitHub Repo stars" />
+</div>
+
+<br>
+
+<!-- ╚════════════════════════════════════════════════════════════╝ -->
+
+
+
+<!-- ╔═══════════════════════════ DOC ════════════════════════════╗ -->
+
+- ## Quick Start 🔥
+
+    ```bash
+    # install via bun
+    bun i @langpkg/mcs_gen
+    ```
+
+    > **This is not the final version (I’m not providing any guarantees here).**
+
+<!-- ╚════════════════════════════════════════════════════════════╝ -->
+
+
+
+<!-- ╔═══════════════════════════ END ════════════════════════════╗ -->
+
+<br>
+<br>
+
+---
+
+<div align="center">
+    <a href="https://github.com/maysara-elshewehy"><img src="https://img.shields.io/badge/by-Maysara-black"/></a>
+</div>
+
+<!-- ╚════════════════════════════════════════════════════════════╝ -->

package/eslint.config.mjs

@@ -0,0 +1,89 @@
+// eslint.config.mjs
+//
+// Made with ❤️ by Maysara.
+
+
+
+// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗
+
+    import { defineConfig }    from 'eslint/config';
+    import stylistic           from '@stylistic/eslint-plugin';
+    import tseslint            from 'typescript-eslint';
+    import js                  from '@eslint/js';
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝
+
+
+
+// ╔═══════════════════════════════════════ CONST ════════════════════════════════════════╗
+
+    const rules                                   = {
+        "curly"                                   : "off",
+        "@stylistic/semi"                         : ["warn", "always"],
+        "@typescript-eslint/no-empty-function"    : "off",
+        "@typescript-eslint/naming-convention"    : [
+            "warn",
+            {
+                "selector"                        : "variable",
+                "format"                          : ["snake_case", "camelCase"],
+                "filter"                          : {
+                    "match"                       : false,
+                    "regex"                       : "^_"
+                }
+            },
+            {
+                "selector"                        : "function",
+                "format"                          : ["camelCase"]
+            },
+            {
+                "selector"                        : "method",
+                "format"                          : ["camelCase"]
+            },
+            {
+                "selector"                        : "typeLike",
+                "format"                          : ["PascalCase"]
+            },
+            {
+                "selector"                        : "import",
+                "format"                          : ["camelCase", "PascalCase"]
+            },
+            {
+                "selector"                        : "variable",
+                "modifiers"                       : ["const"],
+                "format"                          : ["UPPER_CASE", "snake_case", "camelCase"],
+                "filter"                          : {
+                    "match"                       : false,
+                    "regex"                       : "^_"
+                }
+            },
+            {
+                "selector"                        : "enumMember",
+                "format"                          : ["PascalCase"]
+            }
+        ],
+        "@typescript-eslint/no-unused-vars"       : [
+            "error",
+            {
+                "argsIgnorePattern"               : "^_"
+            }
+        ]
+    };
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝
+
+
+
+// ╔════════════════════════════════════════ CONF ════════════════════════════════════════╗
+
+    export default defineConfig(
+
+        js.configs.recommended, ...tseslint.configs.recommended, ...tseslint.configs.stylistic,
+
+        {
+            ignores     : ['**/.vscode-test', '**/out', 'dist/', 'node_modules/', '.git/'],
+            plugins     : { '@stylistic': stylistic },
+            rules       : rules,
+        }
+    );
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@langpkg/mcs_gen",
+  "version": "0.0.1",
+  "description": "maysara code style generator",
+  "keywords": [],
+  "license": "MIT",
+  "author": "Maysara Elshewehy <maysara.elshewehy@gmail.com>",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/langpkg/mcs_gen.git"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "module": "./dist/index.js",
+  "pkg": {
+    "type": "lib"
+  },
+  "scripts": {},
+  "dependencies": {
+    "@langpkg/mcs_fmt": "^0.0.1",
+    "glob": "^13.0.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@stylistic/eslint-plugin": "^5.10.0",
+    "@types/bun": "^1.3.14",
+    "@types/node": "^25.8.0",
+    "bun-plugin-dts": "^0.4.0",
+    "bun-types": "^1.3.14",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.3"
+  }
+}

package/src/common/index.ts

@@ -0,0 +1,112 @@
+// src/common/index.ts
+//
+// Made with ❤️ by Maysara.
+
+
+
+// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗
+
+    import { PkgError }    from './types';
+    import * as path       from 'path';
+    import * as fs         from 'fs';
+    import process         from 'process';
+    export *               from './types';
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝
+
+
+
+// ╔════════════════════════════════════════ FILE ════════════════════════════════════════╗
+
+    export function resolvePath(filePath: string): string {
+        return path.isAbsolute(filePath) ? filePath : path.join(process.cwd(), filePath);
+    }
+
+    export function isFileExists(filePath: string): boolean {
+        try {
+            return fs.existsSync(resolvePath(filePath));
+        } catch {
+            return false;
+        }
+    }
+
+    export function isDirExists(dirPath: string): boolean {
+        try {
+            const resolved = resolvePath(dirPath);
+            return fs.existsSync(resolved) && fs.statSync(resolved).isDirectory();
+        } catch {
+            return false;
+        }
+    }
+
+    export function readFile(filePath: string): string {
+        const targetPath = resolvePath(filePath);
+
+        if (!fs.existsSync(targetPath)) {
+            throw new PkgError(`File not found: ${targetPath}`, 'FILE_NOT_FOUND', {
+                path    : targetPath,
+            });
+        }
+
+        try {
+            return fs.readFileSync(targetPath, 'utf-8');
+        } catch (error) {
+            throw new PkgError(`Failed to read file: ${targetPath}`, 'FILE_READ_ERROR', {
+                path    : targetPath,
+                cause   : String(error),
+            });
+        }
+    }
+
+    export function writeFile(filePath: string, content: string): void {
+        const targetPath    = resolvePath(filePath);
+        const dir           = path.dirname(targetPath);
+
+        try {
+            if (!fs.existsSync(dir)) { fs.mkdirSync(dir, { recursive: true }); }
+            fs.writeFileSync(targetPath, content, 'utf-8');
+        } catch (error) {
+            throw new PkgError(`Failed to write file: ${targetPath}`, 'FILE_WRITE_ERROR', {
+                path    : targetPath,
+                cause   : String(error),
+            });
+        }
+    }
+
+    export function readJsonFile<T = unknown>(filePath: string): T {
+        const content = readFile(filePath);
+        try {
+            return JSON.parse(content) as T;
+        } catch (error) {
+            throw new PkgError(`Invalid JSON in file: ${filePath}`, 'JSON_PARSE_ERROR', {
+                path    : filePath,
+                cause   : String(error),
+            });
+        }
+    }
+
+    export function writeJsonFile(filePath: string, data: unknown, pretty = true): void {
+        const content = pretty ? JSON.stringify(data, null, 4) : JSON.stringify(data);
+        writeFile(filePath, content);
+    }
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝
+
+
+
+// ╔════════════════════════════════════════ PROC ════════════════════════════════════════╗
+
+    export function getCwd(): string {
+        return process.cwd();
+    }
+
+    export function sleep(ms: number): Promise<void> {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+
+    export function createDir(dirPath: string): void {
+        const fullPath = path.resolve(getCwd(), dirPath);
+        fs.mkdirSync(fullPath, { recursive: true });
+    }
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝

package/src/common/types.ts

@@ -0,0 +1,69 @@
+// src/common/types.ts
+//
+// Made with ❤️ by Maysara.
+
+
+
+// ╔════════════════════════════════════════ TYPE ════════════════════════════════════════╗
+
+    export type ProjectType = 'pkg' | 'cli';
+
+    export interface ProjectMeta {
+        name            : string;
+        version         : string;
+        description     : string;
+        license         : string;
+        author          : {
+            name        : string;
+            email       : string;
+            github      : string;
+        };
+        org             : string; // GitHub org or username
+        repoName        : string; // GitHub repo name
+    }
+
+    export interface FormatResult {
+        formatted       : string;
+        count           : number;
+        errors?         : FormatError[];
+    }
+
+    export interface FormatError {
+        message         : string;
+        line?           : number;
+        column?         : number;
+        [key: string]   : unknown;
+    }
+
+    export type IssueSeverity = 'error' | 'warning';
+
+    export type FormatFix =
+    | { type: 'reformat';           content: string                  }
+    | { type: 'replace_line';       line: number; content: string    }
+    | { type: 'insert_after_line';  line: number; content: string    }
+    | { type: 'insert_before_line'; line: number; content: string    }
+    | { type: 'remove_blank_lines'; line: number; count: number      }
+    | { type: 'append_lines';       content: string                  };
+
+    export interface FormatIssue {
+        file            : string;
+        line            : number;
+        code            : string;
+        message         : string;
+        severity        : IssueSeverity;
+        fixable         : boolean;
+        fix?            : FormatFix;
+    }
+
+    export class PkgError extends Error {
+        constructor(
+            msg         : string,
+            public code : string,
+            public ctx? : Record<string, unknown>
+        ) {
+            super(msg);
+            this.name   = 'PkgError';
+        }
+    }
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝

package/src/gen/json/index.ts

@@ -0,0 +1,13 @@
+// src/gen/json/index.ts
+//
+// Made with ❤️ by Maysara.
+
+
+
+// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗
+
+    export { generateVscodeSettings }    from './vscode_settings';
+    export { generatePackageJson }       from './package_json';
+    export { generateTsconfig }          from './tsconfig';
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝

package/src/gen/json/package_json.ts

@@ -0,0 +1,97 @@
+// src/gen/json/package_json.ts
+//
+// Made with ❤️ by Maysara.
+
+
+
+// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗
+
+    import type { ProjectType, ProjectMeta } from '../../common';
+
+    import      { formatJSON  } from '@langpkg/mcs_fmt';
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝
+
+
+
+// ╔════════════════════════════════════════ MAIN ════════════════════════════════════════╗
+
+    export function generatePackageJson(projectType: ProjectType, meta: ProjectMeta): string {
+        const repoUrl =
+        meta.org && meta.repoName ? `https://github.com/${meta.org}/${meta.repoName}` : '';
+
+        const authorStr = [meta.author.name, meta.author.email ? `<${meta.author.email}>` : '']
+        .filter(Boolean)
+        .join(' ');
+
+        // Keys ordered to match PACKAGE_JSON_ORDER in jsonFormat.ts so the
+        // generator output is identical to what the validator would produce -
+        // no false-positive JSON_FORMAT warning on a freshly initialised project.
+        // Order: name, version, description, keywords, license, author,
+        //        repository, type, [bin (cli only)], main, module, types,
+        //        exports, scripts, dependencies, devDependencies, [pkg (cli only)]
+        const pkgObj: Record<string, unknown> = {
+            name                            : meta.name,
+            version                         : meta.version,
+            description                     : meta.description,
+            keywords                        : [] as string[],
+            license                         : meta.license,
+            author                          : authorStr || '',
+            repository                      : repoUrl ? { type: 'git', url: `git+${repoUrl}.git` } : '',
+            type                            : 'module',
+            main                            : './dist/index.js',
+            module                          : './dist/index.js',
+            types                           : './dist/index.d.ts',
+            exports                         : {
+                '.': {
+                    import          : './dist/index.js',
+                    types           : './dist/index.d.ts',
+                },
+            },
+            scripts                         : {}, // use `pkg` cli instead.
+            dependencies                    : {},
+            devDependencies                 : {
+                // default devDependencies
+                '@eslint/js'                : '^9.39.4',
+                '@stylistic/eslint-plugin'  : '^5.10.0',
+                '@types/bun'                : '^1.3.13',
+                '@types/node'               : '^25.7.0',
+                'bun-plugin-dts'            : '^0.3.0',
+                'bun-types'                 : '^1.3.13',
+                'ts-node'                   : '^10.9.2',
+                'tsup'                      : '^8.5.1',
+                'typescript'                : '^5.9.3',
+                'typescript-eslint'         : '^8.59.3',
+            },
+        };
+
+        // For CLI mode, add bin field (inserted after 'type', before 'scripts')
+        if (projectType === 'cli') {
+            const binName = meta.name.replace(/^@[^/]+\//, '');
+            const ordered: Record<string, unknown> = {};
+            for (const [k, v] of Object.entries(pkgObj)) {
+                ordered[k] = v;
+                if (k === 'type') {
+                    ordered['bin'] = { [binName]: './dist/index.js' };
+                    // Add pkg field for CLI projects
+                    ordered['pkg'] = { type: 'cli', };
+                }
+            }
+            Object.keys(pkgObj).forEach((k) => delete pkgObj[k]);
+            Object.assign(pkgObj, ordered);
+        } else {
+            // For normal (library) projects, add pkg field at the end
+            pkgObj['pkg'] = { type: 'lib', };
+        }
+
+        const result = formatJSON(JSON.stringify(pkgObj), 'package.json');
+
+        if(result.errors?.length) {
+            console.error('Error formatting package.json:', JSON.stringify(result.errors, null, 2));
+            throw new Error('Failed to generate package.json due to formatting errors.');
+        }
+
+        return result.formatted + '\n';
+    }
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝

package/src/gen/json/tsconfig.ts

@@ -0,0 +1,59 @@
+// src/gen/json/tsconfig.ts
+//
+// Made with ❤️ by Maysara.
+
+
+
+// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗
+
+    import type { ProjectType } from '../../common';
+
+    import      { formatJSON  } from '@langpkg/mcs_fmt';
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝
+
+
+
+// ╔════════════════════════════════════════ MAIN ════════════════════════════════════════╗
+
+    export function generateTsconfig(projectType: ProjectType): string {
+
+        const tsConfig = {
+
+            compilerOptions                             : {
+                target                                  : 'ES2020',
+                module                                  : 'ESNext',
+                moduleResolution                        : 'bundler',
+                lib                                     : ['DOM', 'ES2020', 'ESNext'],
+                types                                   : ['node'],
+                declaration                             : projectType === 'pkg',
+                outDir                                  : './dist',
+                // rootDir                                 : './src',
+                strict                                  : true,
+                esModuleInterop                         : true,
+                skipLibCheck                            : true,
+                forceConsistentCasingInFileNames        : true,
+                resolveJsonModule                       : true,
+                isolatedModules                         : true,
+                allowImportingTsExtensions              : true,
+                noEmit                                  : true,
+                ignoreDeprecations                      : "6.0"
+            },
+
+            include                                     : ['src', 'test'],
+            exclude                                     : ['node_modules', 'dist']
+
+        };
+
+        const result = formatJSON(JSON.stringify(tsConfig), 'tsconfig.json');
+
+        if(result.errors?.length) {
+            console.error('Error formatting tsconfig.json:', JSON.stringify(result.errors, null, 2));
+            throw new Error('Failed to generate tsconfig.json due to formatting errors.');
+        }
+
+        return result.formatted + '\n';
+
+    }
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝

package/src/gen/json/vscode_settings.ts

@@ -0,0 +1,67 @@
+// src/gen/json/vscode_settings.ts
+//
+// Made with ❤️ by Maysara.
+
+
+
+// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗
+
+    import { formatJSON } from '@langpkg/mcs_fmt';
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝
+
+
+
+// ╔════════════════════════════════════════ MAIN ════════════════════════════════════════╗
+
+    export function generateVscodeSettings(): string {
+
+        const settings = {
+
+            'files.exclude'                 : {
+                '**/.git'                   : true,
+                '**/.svn'                   : true,
+                '**/.hg'                    : true,
+                '**/.DS_Store'              : true,
+                '**/Thumbs.db'              : true,
+                'eslint.config.mjs'         : true,
+                'bun.lock'                  : true,
+                'package-lock.json'         : true,
+                'LICENSE'                   : true,
+                '.gitignore'                : true,
+                '.gitattributes'            : true,
+                '.npmignore'                : true,
+                'node_modules'              : true,
+                'tsup.config.ts'            : true,
+                'tsconfig.json'             : true,
+            },
+
+            'hide-files.files': [
+                'eslint.config.mjs',
+                '.pkg',
+                '.vscode',
+                'bun.lock',
+                'package-lock.json',
+                'LICENSE',
+                '.gitignore',
+                '.gitattributes',
+                '.npmignore',
+                'node_modules',
+                'tsup.config.ts',
+                'tsconfig.json',
+            ],
+
+        };
+
+        const result = formatJSON(JSON.stringify(settings), '.vscode/settings.json');
+
+        if(result.errors?.length) {
+            console.error('Error formatting vscode settings:', JSON.stringify(result.errors, null, 2));
+            throw new Error('Failed to generate vscode settings due to formatting errors.');
+        }
+
+        return result.formatted + '\n';
+
+    }
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝

package/src/gen/md/index.ts

@@ -0,0 +1,11 @@
+// src/gen/md/index.ts
+//
+// Made with ❤️ by Maysara.
+
+
+
+// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗
+
+    export { generateReadme } from './readme';
+
+// ╚══════════════════════════════════════════════════════════════════════════════════════╝