startx 0.1.5 → 0.1.6

package/.editorconfig

@@ -1,20 +1,20 @@
-root = true
-
-[*]
-charset = utf-8
-indent_style = tab
-indent_size = 2
-end_of_line = lf
-insert_final_newline = true
-trim_trailing_whitespace = true
-
-[package.json]
-indent_style = space
-indent_size = 2
-
-[*.yml]
-indent_style = space
-indent_size = 2
-
-[*.ts]
-quote_type = double
+root = true
+
+[*]
+charset = utf-8
+indent_style = tab
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[package.json]
+indent_style = space
+indent_size = 2
+
+[*.yml]
+indent_style = space
+indent_size = 2
+
+[*.ts]
+quote_type = double

package/.github/workflows/publish.yml

@@ -0,0 +1,48 @@
+name: Publish to npm
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org/
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Install CLI
+        run: pnpm install --filter ./packages/cli... --frozen-lockfile
+
+      - name: Build only CLI
+        run: pnpm --filter ./packages/cli... build
+
+      - name: Clean root package.json
+        run: |
+          node -e "
+          const fs = require('fs');
+          const pkg = JSON.parse(fs.readFileSync('package.json', 'utf-8'));
+          delete pkg.dependencies;
+          delete pkg.devDependencies;
+          fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2));
+          "
+
+      - name: Publish to npm
+        run: pnpm publish --no-git-checks
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Avinash Kumar
-
-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.
+MIT License
+
+Copyright (c) 2025 Avinash Kumar
+
+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/configs/eslint-config/plugins.d.ts

@@ -1 +1 @@
-declare module "eslint-plugin-lodash";
+declare module "eslint-plugin-lodash";

package/configs/eslint-config/src/rules/no-argument-spread.ts

@@ -1,96 +1,96 @@
-import { ESLintUtils } from "@typescript-eslint/utils";
-
-export const NoArgumentSpreadRule = ESLintUtils.RuleCreator.withoutDocs({
-  name: "no-argument-spread",
-  meta: {
-    type: "problem",
-    docs: {
-      description:
-        "Avoid spreading potentially large arrays in function or constructor calls — can cause stack overflows. Use `.apply` or `Reflect.construct` instead.",
-    },
-    fixable: "code",
-    messages: {
-      noUnboundedSpread:
-        "Avoid spreading an array in function or constructor calls unless known to be small.",
-      replaceWithApply:
-        "Replace `array.push(...largeArray)` with `array.push.apply(array, largeArray)` to avoid potential stack overflows.",
-      replaceWithReflect:
-        "Replace `new Constructor(...args)` with `Reflect.construct(Constructor, args)` to avoid potential stack overflows.",
-    },
-    schema: [],
-  },
-  defaultOptions: [],
-  create(context) {
-    return {
-      CallExpression(node) {
-        for (const arg of node.arguments) {
-          if (arg.type !== "SpreadElement") continue;
-
-          const spreadArg = arg.argument;
-
-          // Allow spread of inline arrays
-          if (spreadArg.type === "ArrayExpression") return;
-
-          // Only autofix if it's the sole argument
-          const canFix = node.arguments.length === 1;
-
-          context.report({
-            node,
-            messageId: "replaceWithApply",
-            fix: canFix
-              ? (fixer) => {
-                  const source = context.sourceCode;
-
-                  if (node.callee.type === "MemberExpression") {
-                    // Preserve `this`
-                    const thisText = source.getText(node.callee.object);
-                    const calleeText = source.getText(node.callee);
-                    const argText = source.getText(spreadArg);
-                    return fixer.replaceText(
-                      node,
-                      `${calleeText}.apply(${thisText}, ${argText})`
-                    );
-                  }
-                  // Not a memberexpression, use undefined as thisArg
-                  const calleeText = source.getText(node.callee);
-                  const argText = source.getText(spreadArg);
-                  return fixer.replaceText(
-                    node,
-                    `${calleeText}.apply(undefined, ${argText})`
-                  );
-                }
-              : null,
-          });
-        }
-      },
-
-      NewExpression(node) {
-        for (const arg of node.arguments || []) {
-          if (arg.type !== "SpreadElement") continue;
-
-          const spreadArg = arg.argument;
-
-          if (spreadArg.type === "ArrayExpression") return;
-
-          const canFix = node.arguments.length === 1;
-
-          context.report({
-            node,
-            messageId: "replaceWithReflect",
-            fix: canFix
-              ? (fixer) => {
-                  const source = context.sourceCode;
-                  const ctorText = source.getText(node.callee);
-                  const argText = source.getText(spreadArg);
-                  return fixer.replaceText(
-                    node,
-                    `Reflect.construct(${ctorText}, ${argText})`
-                  );
-                }
-              : null,
-          });
-        }
-      },
-    };
-  },
-});
+import { ESLintUtils } from "@typescript-eslint/utils";
+
+export const NoArgumentSpreadRule = ESLintUtils.RuleCreator.withoutDocs({
+  name: "no-argument-spread",
+  meta: {
+    type: "problem",
+    docs: {
+      description:
+        "Avoid spreading potentially large arrays in function or constructor calls — can cause stack overflows. Use `.apply` or `Reflect.construct` instead.",
+    },
+    fixable: "code",
+    messages: {
+      noUnboundedSpread:
+        "Avoid spreading an array in function or constructor calls unless known to be small.",
+      replaceWithApply:
+        "Replace `array.push(...largeArray)` with `array.push.apply(array, largeArray)` to avoid potential stack overflows.",
+      replaceWithReflect:
+        "Replace `new Constructor(...args)` with `Reflect.construct(Constructor, args)` to avoid potential stack overflows.",
+    },
+    schema: [],
+  },
+  defaultOptions: [],
+  create(context) {
+    return {
+      CallExpression(node) {
+        for (const arg of node.arguments) {
+          if (arg.type !== "SpreadElement") continue;
+
+          const spreadArg = arg.argument;
+
+          // Allow spread of inline arrays
+          if (spreadArg.type === "ArrayExpression") return;
+
+          // Only autofix if it's the sole argument
+          const canFix = node.arguments.length === 1;
+
+          context.report({
+            node,
+            messageId: "replaceWithApply",
+            fix: canFix
+              ? (fixer) => {
+                  const source = context.sourceCode;
+
+                  if (node.callee.type === "MemberExpression") {
+                    // Preserve `this`
+                    const thisText = source.getText(node.callee.object);
+                    const calleeText = source.getText(node.callee);
+                    const argText = source.getText(spreadArg);
+                    return fixer.replaceText(
+                      node,
+                      `${calleeText}.apply(${thisText}, ${argText})`
+                    );
+                  }
+                  // Not a memberexpression, use undefined as thisArg
+                  const calleeText = source.getText(node.callee);
+                  const argText = source.getText(spreadArg);
+                  return fixer.replaceText(
+                    node,
+                    `${calleeText}.apply(undefined, ${argText})`
+                  );
+                }
+              : null,
+          });
+        }
+      },
+
+      NewExpression(node) {
+        for (const arg of node.arguments || []) {
+          if (arg.type !== "SpreadElement") continue;
+
+          const spreadArg = arg.argument;
+
+          if (spreadArg.type === "ArrayExpression") return;
+
+          const canFix = node.arguments.length === 1;
+
+          context.report({
+            node,
+            messageId: "replaceWithReflect",
+            fix: canFix
+              ? (fixer) => {
+                  const source = context.sourceCode;
+                  const ctorText = source.getText(node.callee);
+                  const argText = source.getText(spreadArg);
+                  return fixer.replaceText(
+                    node,
+                    `Reflect.construct(${ctorText}, ${argText})`
+                  );
+                }
+              : null,
+          });
+        }
+      },
+    };
+  },
+});

package/configs/eslint-config/src/rules/no-internal-package-import.ts

@@ -1,40 +1,40 @@
-import { ESLintUtils } from '@typescript-eslint/utils';
-
-export const NoInternalPackageImportRule = ESLintUtils.RuleCreator.withoutDocs({
-	name: "no-internal-package-import",
-	meta: {
-		type: 'problem',
-		docs: {
-			description: 'Disallow imports from internal package paths (e.g. `/pkg/src/...`).',
-		},
-		messages: {
-			noInternalPackageImport:
-				'Import from "{{ packageRoot }}", not from the internal `/src/` path.',
-		},
-		fixable: 'code',
-		schema: [],
-	},
-	defaultOptions: [],
-	create(context) {
-		const INTERNAL_IMPORT_REGEX = /^(?<packageRoot>\/[^/]+)\/src\//;
-
-		return {
-			ImportDeclaration(node) {
-				if (typeof node.source.type !== 'string') return;
-
-				const match = node.source.value.match(INTERNAL_IMPORT_REGEX);
-
-				if (!match?.groups) return;
-
-				const { packageRoot } = match.groups;
-
-				context.report({
-					node: node.source,
-					messageId: 'noInternalPackageImport',
-					fix: (fixer) => fixer.replaceText(node.source, `"${packageRoot}"`),
-					data: { packageRoot },
-				});
-			},
-		};
-	},
-});
+import { ESLintUtils } from '@typescript-eslint/utils';
+
+export const NoInternalPackageImportRule = ESLintUtils.RuleCreator.withoutDocs({
+	name: "no-internal-package-import",
+	meta: {
+		type: 'problem',
+		docs: {
+			description: 'Disallow imports from internal package paths (e.g. `/pkg/src/...`).',
+		},
+		messages: {
+			noInternalPackageImport:
+				'Import from "{{ packageRoot }}", not from the internal `/src/` path.',
+		},
+		fixable: 'code',
+		schema: [],
+	},
+	defaultOptions: [],
+	create(context) {
+		const INTERNAL_IMPORT_REGEX = /^(?<packageRoot>\/[^/]+)\/src\//;
+
+		return {
+			ImportDeclaration(node) {
+				if (typeof node.source.type !== 'string') return;
+
+				const match = node.source.value.match(INTERNAL_IMPORT_REGEX);
+
+				if (!match?.groups) return;
+
+				const { packageRoot } = match.groups;
+
+				context.report({
+					node: node.source,
+					messageId: 'noInternalPackageImport',
+					fix: (fixer) => fixer.replaceText(node.source, `"${packageRoot}"`),
+					data: { packageRoot },
+				});
+			},
+		};
+	},
+});

package/configs/eslint-config/src/rules/no-interpolation-in-regular-string.ts

@@ -1,32 +1,32 @@
-import { ESLintUtils } from '@typescript-eslint/utils';
-
-export const NoInterpolationInRegularStringRule = ESLintUtils.RuleCreator.withoutDocs({
-	name: 'no-interpolation-in-regular-string',
-	meta: {
-		type: 'problem',
-		docs: {
-			description: 'String interpolation `${...}` requires backticks, not single or double quotes.',
-		},
-		messages: {
-			useBackticks: 'Use backticks to interpolate',
-		},
-		fixable: 'code',
-		schema: [],
-	},
-	defaultOptions: [],
-	create(context) {
-		return {
-			Literal(node) {
-				if (typeof node.value !== 'string') return;
-
-				if (/\$\{/.test(node.value)) {
-					context.report({
-						messageId: 'useBackticks',
-						node,
-						fix: (fixer) => fixer.replaceText(node, `\`${node.value}\``),
-					});
-				}
-			},
-		};
-	},
-});
+import { ESLintUtils } from '@typescript-eslint/utils';
+
+export const NoInterpolationInRegularStringRule = ESLintUtils.RuleCreator.withoutDocs({
+	name: 'no-interpolation-in-regular-string',
+	meta: {
+		type: 'problem',
+		docs: {
+			description: 'String interpolation `${...}` requires backticks, not single or double quotes.',
+		},
+		messages: {
+			useBackticks: 'Use backticks to interpolate',
+		},
+		fixable: 'code',
+		schema: [],
+	},
+	defaultOptions: [],
+	create(context) {
+		return {
+			Literal(node) {
+				if (typeof node.value !== 'string') return;
+
+				if (/\$\{/.test(node.value)) {
+					context.report({
+						messageId: 'useBackticks',
+						node,
+						fix: (fixer) => fixer.replaceText(node, `\`${node.value}\``),
+					});
+				}
+			},
+		};
+	},
+});

package/configs/eslint-config/src/rules/no-skipped-tests.ts

@@ -1,61 +1,61 @@
-import { ESLintUtils } from "@typescript-eslint/utils";
-
-export const NoSkippedTestsRule = ESLintUtils.RuleCreator.withoutDocs({
-  name: "no-skipped-tests",
-  meta: {
-    type: "problem",
-    docs: {
-      description: "Tests must not be skipped.",
-    },
-    messages: {
-      removeSkip: "Remove `.skip()` call",
-      removeOnly: "Remove `.only()` call",
-      removeXPrefix: "Remove `x` prefix",
-    },
-    fixable: "code",
-    schema: [],
-  },
-  defaultOptions: [],
-  create(context) {
-    const TESTING_FUNCTIONS = new Set(["test", "it", "describe"]);
-    const SKIPPING_METHODS = new Set(["skip", "only"]);
-    const PREFIXED_TESTING_FUNCTIONS = new Set(["xtest", "xit", "xdescribe"]);
-    const toMessageId = (s: string) =>
-      `remove${s.charAt(0).toUpperCase()}${s.slice(1)}` as
-        | "removeSkip"
-        | "removeOnly"
-        | "removeXPrefix";
-
-    return {
-      MemberExpression(node) {
-        if (
-          node.object.type === "Identifier" &&
-          TESTING_FUNCTIONS.has(node.object.name) &&
-          node.property.type === "Identifier" &&
-          SKIPPING_METHODS.has(node.property.name)
-        ) {
-          context.report({
-            messageId: toMessageId(node.property.name),
-            node,
-            fix: (fixer) => {
-              const [start, end] = node.property.range;
-              return fixer.removeRange([start - ".".length, end]);
-            },
-          });
-        }
-      },
-      CallExpression(node) {
-        if (
-          node.callee.type === "Identifier" &&
-          PREFIXED_TESTING_FUNCTIONS.has(node.callee.name)
-        ) {
-          context.report({
-            messageId: "removeXPrefix",
-            node,
-            fix: (fixer) => fixer.replaceText(node.callee, "test"),
-          });
-        }
-      },
-    };
-  },
-});
+import { ESLintUtils } from "@typescript-eslint/utils";
+
+export const NoSkippedTestsRule = ESLintUtils.RuleCreator.withoutDocs({
+  name: "no-skipped-tests",
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Tests must not be skipped.",
+    },
+    messages: {
+      removeSkip: "Remove `.skip()` call",
+      removeOnly: "Remove `.only()` call",
+      removeXPrefix: "Remove `x` prefix",
+    },
+    fixable: "code",
+    schema: [],
+  },
+  defaultOptions: [],
+  create(context) {
+    const TESTING_FUNCTIONS = new Set(["test", "it", "describe"]);
+    const SKIPPING_METHODS = new Set(["skip", "only"]);
+    const PREFIXED_TESTING_FUNCTIONS = new Set(["xtest", "xit", "xdescribe"]);
+    const toMessageId = (s: string) =>
+      `remove${s.charAt(0).toUpperCase()}${s.slice(1)}` as
+        | "removeSkip"
+        | "removeOnly"
+        | "removeXPrefix";
+
+    return {
+      MemberExpression(node) {
+        if (
+          node.object.type === "Identifier" &&
+          TESTING_FUNCTIONS.has(node.object.name) &&
+          node.property.type === "Identifier" &&
+          SKIPPING_METHODS.has(node.property.name)
+        ) {
+          context.report({
+            messageId: toMessageId(node.property.name),
+            node,
+            fix: (fixer) => {
+              const [start, end] = node.property.range;
+              return fixer.removeRange([start - ".".length, end]);
+            },
+          });
+        }
+      },
+      CallExpression(node) {
+        if (
+          node.callee.type === "Identifier" &&
+          PREFIXED_TESTING_FUNCTIONS.has(node.callee.name)
+        ) {
+          context.report({
+            messageId: "removeXPrefix",
+            node,
+            fix: (fixer) => fixer.replaceText(node.callee, "test"),
+          });
+        }
+      },
+    };
+  },
+});

package/configs/eslint-config/src/rules/no-top-level-relative-imports-in-backend-module.ts

@@ -1,27 +1,27 @@
-import { ESLintUtils, type TSESTree } from '@typescript-eslint/utils';
-
-export const NoTopLevelRelativeImportsInBackendModuleRule = ESLintUtils.RuleCreator.withoutDocs({
-	name: 'no-top-level-relative-imports-in-backend-module',
-	meta: {
-		type: 'problem',
-		docs: {
-			description:
-				'Relative imports in `.module.ts` files must be placed inside the `init` method. This ensures that module imports are loaded only when the module is used.',
-		},
-		messages: {
-			placeInsideInit:
-				"Place this relative import inside the `init` method, using `await import('./path')` syntax.",
-		},
-		schema: [],
-	},
-	defaultOptions: [],
-	create(context) {
-		return {
-			'Program > ImportDeclaration'(node: TSESTree.ImportDeclaration) {
-				if (node.source.value.startsWith('.')) {
-					context.report({ node, messageId: 'placeInsideInit' });
-				}
-			},
-		};
-	},
-});
+import { ESLintUtils, type TSESTree } from '@typescript-eslint/utils';
+
+export const NoTopLevelRelativeImportsInBackendModuleRule = ESLintUtils.RuleCreator.withoutDocs({
+	name: 'no-top-level-relative-imports-in-backend-module',
+	meta: {
+		type: 'problem',
+		docs: {
+			description:
+				'Relative imports in `.module.ts` files must be placed inside the `init` method. This ensures that module imports are loaded only when the module is used.',
+		},
+		messages: {
+			placeInsideInit:
+				"Place this relative import inside the `init` method, using `await import('./path')` syntax.",
+		},
+		schema: [],
+	},
+	defaultOptions: [],
+	create(context) {
+		return {
+			'Program > ImportDeclaration'(node: TSESTree.ImportDeclaration) {
+				if (node.source.value.startsWith('.')) {
+					context.report({ node, messageId: 'placeInsideInit' });
+				}
+			},
+		};
+	},
+});