@langpkg/mcs_gen 0.0.2 → 0.0.4

package/eslint.config.mjs

@@ -1,89 +0,0 @@
-// 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/src/common/index.ts

@@ -1,112 +0,0 @@
-// 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

@@ -1,69 +0,0 @@
-// 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

@@ -1,13 +0,0 @@
-// 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

@@ -1,97 +0,0 @@
-// 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

@@ -1,59 +0,0 @@
-// 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

@@ -1,67 +0,0 @@
-// 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

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

package/src/gen/md/readme.ts

@@ -1,84 +0,0 @@
-// src/gen/md/readme.ts
-//
-// Made with ❤️ by Maysara.
-
-
-
-// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗
-
-    import type { ProjectType, ProjectMeta } from '../../common';
-
-    import      { formatMD  } from '@langpkg/mcs_fmt';
-
-// ╚══════════════════════════════════════════════════════════════════════════════════════╝
-
-
-
-// ╔════════════════════════════════════════ MAIN ════════════════════════════════════════╗
-
-    export function generateReadme(projectType: ProjectType, meta: ProjectMeta): string {
-        // const repoUrl = meta.org && meta.repoName
-        //     ? `https://github.com/${meta.org}/${meta.repoName}`
-        //     : '';
-        // const badge = repoUrl
-        //     ? `[![npm](https://img.shields.io/npm/v/${meta.name})](https://www.npmjs.com/package/${meta.name})\n\n`
-        //     : '';
-
-        const readmeContent = projectType === 'cli' ? generateCLIReadme(meta) : generateLibReadme(meta);
-        const result = formatMD(readmeContent, 'README.md');
-
-        if(result.errors?.length) {
-            console.error('Error formatting readme:', JSON.stringify(result.errors, null, 2));
-            throw new Error('Failed to generate readme due to formatting errors.');
-        }
-
-        return result.formatted + '\n';
-    }
-
-// ╚══════════════════════════════════════════════════════════════════════════════════════╝
-
-
-
-// ╔════════════════════════════════════════ HELP ════════════════════════════════════════╗
-
-    function generateCLIReadme(meta: ProjectMeta): string {
-        return (
-            `# ${meta.name}\n\n` +
-            // badge +
-            `${meta.description || 'A TypeScript command-line tool.'}\n\n` +
-            '## Installation\n\n```bash\n' +
-            `pkg install -g ${meta.name}\n` +
-            '```\n\n## Usage\n\n```bash\n' +
-            `${meta.name} --help\n` +
-            '```\n\n## Development\n\n```bash\npkg install\n' +
-            'pkg dev       # Build in watch mode (TODO)\n' +
-            'pkg lint      # Lint code\n' +
-            'pkg build     # Build for production\n' +
-            '```\n\n## License\n\n' +
-            `${meta.license}` +
-            (meta.author.name ? ` © ${new Date().getFullYear()} ${meta.author.name}` : '') +
-            '\n'
-        );
-    }
-
-    function generateLibReadme(meta: ProjectMeta): string {
-        return (
-            `# ${meta.name}\n\n` +
-            // badge +
-            `${meta.description || 'A TypeScript library.'}\n\n` +
-            '## Installation\n\n```bash\n' +
-            `pkg install ${meta.name}\n` +
-            '```\n\n## Usage\n\n```typescript\n' +
-            `import { example } from '${meta.name}'\n\nexample()\n` +
-            '```\n\n## Development\n\n```bash\npkg install\n' +
-            'pkg build     # Build distribution files\n' +
-            'pkg lint      # Lint code\n' +
-            'pkg test      # Run tests\n' +
-            '```\n\n## License\n\n' +
-            `${meta.license}` +
-            (meta.author.name ? ` © ${new Date().getFullYear()} ${meta.author.name}` : '') +
-            '\n'
-        );
-    }
-
-// ╚══════════════════════════════════════════════════════════════════════════════════════╝

package/src/gen/text/gitignore.ts

@@ -1,43 +0,0 @@
-// src/gen/text/gitignore.ts
-//
-// Made with ❤️ by Maysara.
-
-
-
-// ╔════════════════════════════════════════ MAIN ════════════════════════════════════════╗
-
-    export function generateGitignore(): string {
-
-        return (
-            '# Dependencies\n' +
-            'node_modules/\n' +
-            'package-lock.json\n' +
-            'yarn.lock\n' +
-            'pnpm-lock.yaml\n' +
-            'bun.lockb\n\n' +
-            '# Build outputs\n' +
-            'dist/\n' +
-            'build/\n' +
-            '*.tsbuildinfo\n\n' +
-            '# Environment variables\n' +
-            '.env\n' +
-            '.env.local\n' +
-            '.env.*.local\n\n' +
-            '# PKG\n' +
-            '.pkg/\n' +
-            '# IDE\n' +
-            '.vscode/\n' +
-            '.idea/\n' +
-            '*.swp\n' +
-            '*.swo\n\n' +
-            '# OS\n' +
-            '.DS_Store\n' +
-            'Thumbs.db\n\n' +
-            '# Test coverage\n' +
-            'coverage/\n' +
-            '.nyc_output/\n'
-        );
-
-    }
-
-// ╚══════════════════════════════════════════════════════════════════════════════════════╝