@space-arch/nx-plugin-std 1.7.0

package/dist/generators/cfg/files/cursor-rules/typescript-rules.mdc.template

@@ -0,0 +1,73 @@
+---
+description:
+globs: 
+alwaysApply: true
+---
+# TypeScript Rules
+
+USE WHEN editing/creating/writing/engineering/architecting any TypeScript (.ts or .tsx) Code
+These rules relevant to any typescript-related work and should be applied on top of the @core.mdc rules
+
+## MCP Context & Documentation Lookup
+- **Context First:** Always query MCP documentation tools (e.g. `context7`) for the latest official docs, examples, and type definitions.
+- **Fallback:** If MCP yields incomplete info, perform a web search against authoritative sources (TypeScript Handbook, official library sites).
+- **Integrate Findings:** Merge examples or code snippets from MCP/web search into your solution—adapt, do not copy verbatim.
+
+## Monorepo & Nx Awareness
+- Detect an Nx workspace by presence of `nx.json`
+- Run `cd` to the monorepo root **in a separate command** before issuing any `nx` CLI calls.
+- Use Nx commands (`nx build`, `nx test`, `nx g`) rather than ad-hoc scripts, so project boundaries and dependencies are respected.
+- If an Nx MCP tool is available (e.g. `nx_workspace`, `nx_docs`), leverage it for workspace graph queries and code generation.
+
+## Package Manager
+- Always check what package manager is being used in the project.
+- Use the correct package manager to call scripts (eg `pnpm dlx` instead of `npx` and `pnpm start` instead of `npm start` and so on)
+
+## TypeScript Code Standards
+- **Self-Documenting Code:** Favor clear, descriptive names and types over comments.  
+- **Pure & Composable:** Write small, pure functions and modules. Prefer functional patterns (`map`, `filter`, pipelines) over imperative loops.  
+- **No Clever Tricks:** Avoid deeply nested logic and complex `.reduce()` chains; extract helpers if needed.  
+- **ES Modules Only:** Use `import`/`export`; do not use `namespace` syntax.  
+- **No Native Enums:**  
+  - If `@space-arch/util-enum` is installed, use its API.  
+  - Otherwise, define “enum objects” with `as const` and string-literal unions:  
+    ```ts
+    export const FOO = { A: 'A', B: 'B' } as const;
+    export type Foo = (typeof FOO)[keyof typeof FOO];
+    ```
+
+## Error Handling
+- Check if the project uses `neverthrow` npm package.
+- if project uses `neverthrow`, Wrap risky code in utils from the `neverthrow` library. 
+  - Avoid manually typing the return type - let TS infer the type.
+  - Define error codes as enum objects (using `@space-arch/util-enum` utilities like `enumPrefixed`).
+- If project DOES NOT use `neverthrow` follow standard error handling best-practices
+
+## Modern Language & Compiler Features
+- Read `lib` and `target` from the project's `tsconfig.json`/`tsconfig.base.json`.
+- If `lib` and `target` are set to ESNext you should use all the latest cutting edge language features and specs
+- If `lib` and `target` are set to `ES20xx` you should use corresponding latest ECMAScript language features and specs
+- Use all latest supported ES/TS features (optional chaining, nullish coalescing, top-level await, `replaceAll`, etc.).
+- Avoid down-leveling unless required for compatibility.
+
+## Testing & Verification
+- Write or update unit tests for new code or bug fixes using the project's test framework.
+- Run the TypeScript compiler (`tsc`), ESLint, and test runner via MCP or CLI—do not finalize until all pass.
+- In an Nx monorepo, prefer nx commands like `nx test`, `nx lint`, `nx build` over direct tool calls.
+- Make sure the tests pass.
+
+## Documentation & Comments
+- Only add comments to explain *why* a non-obvious decision exists; avoid “what” comments.
+- Use JSDoc/TSDoc for public APIs; keep descriptions brief and to-the-point.
+- Do not document self-explanatory code: strive for code clarity instead.
+- Update README or project docs only if usage or setup has changed.
+
+## Output Formatting & Code Style
+- Adhere to the project's Prettier and ESLint configurations.
+- Follow best practices
+
+## Communication & Proactive Suggestions
+- Present only relevant diffs or code snippets; avoid full-file dumps.
+- If requirements are ambiguous, ask a concise clarification question.
+- After fulfilling the user's request, you may offer up to **two** brief, optional improvement suggestions—clearly label them as “Optional: …”.
+

package/dist/generators/cfg/files/lint/.prettierignore.template

@@ -0,0 +1,7 @@
+# Add files here to ignore them from prettier formatting
+/dist
+/coverage
+/.nx/cache
+/.nx/workspace-data
+/local
+/tmp

package/dist/generators/cfg/files/lint/.prettierrc.template

@@ -0,0 +1,32 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "tabWidth": 2,
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "printWidth": 80,
+  "proseWrap": "always",
+  "plugins": [
+    "@trivago/prettier-plugin-sort-imports",
+    "prettier-plugin-tailwindcss",
+    "prettier-plugin-classnames",
+    "prettier-plugin-merge"
+  ],
+  "importOrder": [
+    "^server-only$",
+    "<THIRD_PARTY_MODULES>",
+    "^@com\\/web-ui\\/(shadcn|lib|hooks)\\/",
+    "^@com\\/web-ui\\/components\\/",
+    "^@com\\/",
+    "^.+\\/shadcn\\/",
+    "^\\.\\./",
+    "^\\./"
+  ],
+  "importOrderSeparation": true,
+  "importOrderSortSpecifiers": true,
+  "tailwindStylesheet": "./com/web/app/src/app/global.css",
+  "tailwindConfig": "./com/web/app/tailwind.config.js",
+  "tailwindFunctions": ["clsx", "cn", "cva"],
+  "customFunctions": ["clsx", "cn", "cva"]
+}

package/dist/generators/cfg/files/lint/eslint.config.mjs.template

@@ -0,0 +1,91 @@
+import nx from '@nx/eslint-plugin';
+import prettierRecommended from 'eslint-plugin-prettier/recommended';
+
+export default [
+  {
+    files: ['**/*.json'],
+    // Override or add rules here
+    rules: {},
+    languageOptions: {
+      parser: await import('jsonc-eslint-parser'),
+    },
+  },
+  
+  ...nx.configs['flat/base'],
+  ...nx.configs['flat/typescript'],
+  ...nx.configs['flat/javascript'],
+  
+  prettierRecommended,
+  
+  {
+    ignores: [
+      'local/**',
+      'tmp/**',
+      '**/generated',
+      '**/dist',
+      '**/vite.config.*.timestamp*',
+      '**/vitest.config.*.timestamp*',
+    ],
+  },
+  {
+    files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
+    rules: {
+      '@nx/enforce-module-boundaries': [
+        'error',
+        {
+          enforceBuildableLibDependency: true,
+          allow: ['^.*/eslint(\\.base)?\\.config\\.[cm]?js$'],
+          depConstraints: [
+            {
+              sourceTag: '*',
+              onlyDependOnLibsWithTags: ['*'],
+            },
+          ],
+        },
+      ],
+    },
+  },
+  {
+    files: [
+      '**/*.ts',
+      '**/*.tsx',
+      '**/*.cts',
+      '**/*.mts',
+      '**/*.js',
+      '**/*.jsx',
+      '**/*.cjs',
+      '**/*.mjs',
+    ],
+    rules: {
+      'no-multiple-empty-lines': ['error', { max: 1, maxEOF: 1 }],
+    },
+  },
+  {
+    files: ['**/*.js', '**/*.jsx'],
+    rules: {
+      'no-unused-vars': [
+        'error',
+        {
+          varsIgnorePattern: '^_',
+          argsIgnorePattern: '^_',
+        },
+      ],
+    },
+  },
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    rules: {
+      'no-multiple-empty-lines': ['error', { max: 1, maxEOF: 1 }],
+      'tailwindcss/no-custom-classname': 'off',
+      'no-unused-vars': 'off',
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          varsIgnorePattern: '^_',
+          argsIgnorePattern: '^_',
+        },
+      ],
+    },
+  },
+];

package/dist/generators/cfg/lib/initCursorRules.d.ts

@@ -0,0 +1,3 @@
+import { type Tree } from '@nx/devkit';
+export declare function initCursorRules(tree: Tree, namespace: string): void;
+//# sourceMappingURL=initCursorRules.d.ts.map

package/dist/generators/cfg/lib/initCursorRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initCursorRules.d.ts","sourceRoot":"","sources":["../../../../src/generators/cfg/lib/initCursorRules.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,IAAI,EAGV,MAAM,YAAY,CAAC;AAEpB,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,QAQ5D"}

package/dist/generators/cfg/lib/initCursorRules.js

@@ -0,0 +1,4 @@
+import { OverwriteStrategy, generateFiles, joinPathFragments, } from '@nx/devkit';
+export function initCursorRules(tree, namespace) {
+    generateFiles(tree, joinPathFragments(__dirname, '../files/cursor-rules'), '.cursor/rules', { namespace }, { overwriteStrategy: OverwriteStrategy.Overwrite });
+}

package/dist/generators/cfg/lib/initEslintAndPrettierConfigs.d.ts

@@ -0,0 +1,3 @@
+import { type Tree } from '@nx/devkit';
+export declare function initEslintAndPrettierConfigs(tree: Tree, namespace: string): Promise<void>;
+//# sourceMappingURL=initEslintAndPrettierConfigs.d.ts.map

package/dist/generators/cfg/lib/initEslintAndPrettierConfigs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initEslintAndPrettierConfigs.d.ts","sourceRoot":"","sources":["../../../../src/generators/cfg/lib/initEslintAndPrettierConfigs.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,IAAI,EAIV,MAAM,YAAY,CAAC;AAIpB,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,iBA2BlB"}

package/dist/generators/cfg/lib/initEslintAndPrettierConfigs.js

@@ -0,0 +1,21 @@
+import { OverwriteStrategy, addDependenciesToPackageJson, generateFiles, joinPathFragments, } from '@nx/devkit';
+import { versionResolve } from "./versionResolve.js";
+export async function initEslintAndPrettierConfigs(tree, namespace) {
+    const devDependencies = await versionResolve({
+        prettier: 'latest',
+        '@trivago/prettier-plugin-sort-imports': 'latest',
+        'prettier-plugin-tailwindcss': 'latest',
+        'prettier-plugin-classnames': 'latest',
+        'prettier-plugin-merge': 'latest',
+        eslint: 'latest',
+        'eslint-config-prettier': 'latest',
+        'eslint-plugin-prettier': 'latest',
+        '@eslint/js': 'latest',
+        'jsonc-eslint-parser': 'latest',
+        typescript: 'latest',
+        'typescript-eslint': 'latest',
+        '@types/node': 'latest',
+    });
+    addDependenciesToPackageJson(tree, {}, devDependencies);
+    generateFiles(tree, joinPathFragments(__dirname, '../files/lint'), '.', { namespace }, { overwriteStrategy: OverwriteStrategy.Overwrite });
+}

package/dist/generators/cfg/lib/versionMatch.d.ts

@@ -0,0 +1,3 @@
+export declare function versionMatchLatest(versions: string[], constraint: string): string | null;
+export declare function compareVersions(a: string, b: string): number;
+//# sourceMappingURL=versionMatch.d.ts.map

package/dist/generators/cfg/lib/versionMatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionMatch.d.ts","sourceRoot":"","sources":["../../../../src/generators/cfg/lib/versionMatch.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAcf;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAa5D"}

package/dist/generators/cfg/lib/versionMatch.js

@@ -0,0 +1,25 @@
+export function versionMatchLatest(versions, constraint) {
+    // Convert constraint like "2.3.*" to regex pattern
+    const pattern = constraint.replace(/\*/g, '\\d+');
+    const regex = new RegExp(`^${pattern}$`);
+    // Filter versions that match the constraint
+    const matchingVersions = versions.filter(version => regex.test(version));
+    if (matchingVersions.length === 0) {
+        return null;
+    }
+    // Sort versions using semver-like comparison and return the latest
+    return matchingVersions.sort((a, b) => compareVersions(a, b)).pop() || null;
+}
+export function compareVersions(a, b) {
+    const aParts = a.split('.').map(Number);
+    const bParts = b.split('.').map(Number);
+    for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
+        const aPart = aParts[i] || 0;
+        const bPart = bParts[i] || 0;
+        if (aPart > bPart)
+            return 1;
+        if (aPart < bPart)
+            return -1;
+    }
+    return 0;
+}

package/dist/generators/cfg/lib/versionResolve.d.ts

@@ -0,0 +1,10 @@
+type VersionConstraintSegment = `${number | '*'}`;
+export type VersionConstraint = 'latest' | 'canary' | `${'^' | '~' | '>' | '<' | '>=' | '<=' | '=' | '!='}${string}` | `${VersionConstraintSegment}.${VersionConstraintSegment}.${VersionConstraintSegment}`;
+/**
+ * Resolves versions matching constraints from npm registry.
+ * @param packages - A record of package names and their version constraints
+ * @returns A record of package names and their resolved versions
+ */
+export declare function versionResolve(packages: Record<string, VersionConstraint>): Promise<Record<string, string>>;
+export {};
+//# sourceMappingURL=versionResolve.d.ts.map

package/dist/generators/cfg/lib/versionResolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionResolve.d.ts","sourceRoot":"","sources":["../../../../src/generators/cfg/lib/versionResolve.ts"],"names":[],"mappings":"AAIA,KAAK,wBAAwB,GAAG,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;AAClD,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,QAAQ,GACR,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,MAAM,EAAE,GAC9D,GAAG,wBAAwB,IAAI,wBAAwB,IAAI,wBAAwB,EAAE,CAAC;AAE1F;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC1C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAOjC"}

package/dist/generators/cfg/lib/versionResolve.js

@@ -0,0 +1,49 @@
+import { logger } from '@nx/devkit';
+import { versionMatchLatest } from "./versionMatch.js";
+/**
+ * Resolves versions matching constraints from npm registry.
+ * @param packages - A record of package names and their version constraints
+ * @returns A record of package names and their resolved versions
+ */
+export async function versionResolve(packages) {
+    const promises = Object.entries(packages).map(([name, constraint]) => resolveOne(name, constraint));
+    const results = await Promise.all(promises);
+    return Object.fromEntries(results);
+}
+//-------------------------------------
+function shouldFetch(constraint) {
+    return (constraint === 'latest' ||
+        constraint === 'canary' ||
+        constraint.includes('*'));
+}
+async function packageFetch(packageName) {
+    const response = await fetch(`https://registry.npmjs.org/${packageName}`);
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status}`);
+    }
+    return response.json();
+}
+function constraintApply(constraint, packageData) {
+    if (constraint === 'latest') {
+        return packageData['dist-tags'].latest;
+    }
+    if (constraint === 'canary') {
+        return packageData['dist-tags'].canary || packageData['dist-tags'].latest;
+    }
+    // Handle version constraints like "2.3.*", "1.*.*"
+    const matchingVersion = versionMatchLatest(Object.keys(packageData.versions), constraint);
+    return matchingVersion || constraint;
+}
+async function resolveOne(packageName, constraint) {
+    if (!shouldFetch(constraint))
+        return [packageName, constraint];
+    try {
+        const packageData = await packageFetch(packageName);
+        const resolvedVersion = constraintApply(constraint, packageData);
+        return [packageName, resolvedVersion];
+    }
+    catch (error) {
+        logger.warn(`Failed to fetch version for ${packageName}: ${error.message}, using fallback`);
+        return [packageName, constraint];
+    }
+}

package/dist/generators/cfg/schema.d.ts

@@ -0,0 +1,5 @@
+type CfgOption = 'cursor-rules' | 'lint';
+
+export type CfgGeneratorSchema = {
+  options: CfgOption[];
+};

package/dist/generators/cfg/schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "Init",
+  "title": "",
+  "type": "object",
+  "properties": {
+    "options": {
+      "description": "The options to apply",
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["cursor-rules", "lint"]
+      },
+      "default": ["cursor-rules", "lint"],
+      "x-prompt": {
+        "type": "list",
+        "message": "Select the options you want to apply",
+        "multiselect": true,
+        "items": [
+          {
+            "label": "cursor-rules",
+            "value": "cursor-rules"
+          },
+          {
+            "label": "lint",
+            "value": "lint"
+          }
+        ]
+      }
+    }
+  },
+  "required": ["options"]
+}

package/dist/generators/mv/mv-generator.d.ts

@@ -0,0 +1,5 @@
+import type { Tree } from '@nx/devkit';
+import type { MvGeneratorSchema } from './schema.d.ts';
+export declare function mvGenerator(tree: Tree, options: MvGeneratorSchema): Promise<void>;
+export default mvGenerator;
+//# sourceMappingURL=mv-generator.d.ts.map

package/dist/generators/mv/mv-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mv-generator.d.ts","sourceRoot":"","sources":["../../../src/generators/mv/mv-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,iBASvE;AAED,eAAe,WAAW,CAAC"}

package/dist/generators/mv/mv-generator.js

@@ -0,0 +1,11 @@
+import { moveGenerator } from '@nx/workspace';
+export async function mvGenerator(tree, options) {
+    const { packageName, newPath } = options;
+    await moveGenerator(tree, {
+        projectName: packageName,
+        destination: newPath,
+        updateImportPath: true,
+        newProjectName: newPath.split('/').slice(1).join('-'),
+    });
+}
+export default mvGenerator;

package/dist/generators/mv/schema.d.ts

@@ -0,0 +1,4 @@
+export interface MvGeneratorSchema {
+  packageName: string;
+  newPath: string;
+}

package/dist/generators/mv/schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "Mv",
+  "title": "",
+  "type": "object",
+  "properties": {
+    "packageName": {
+      "type": "string",
+      "description": "The name of the package to move",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What package name would you like to move?",
+      "x-dropdown": "projects"
+    },
+    "newPath": {
+      "type": "string",
+      "description": "The new path of the package",
+      "x-prompt": "What is the new path of the package?"
+    }
+  },
+  "required": ["packageName", "newPath"]
+}