startx 0.0.1

package/biome.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "vcs": {
+    "clientKind": "git",
+    "enabled": true,
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "ignore": [
+      "**/.turbo",
+      "**/components.d.ts",
+      "**/coverage",
+      "**/dist",
+      "**/build",
+      "**/node_modules",
+      "**/pnpm-lock.yaml",
+      "**/package-lock.json",
+      "**/yarn.lock",
+      "**/CHANGELOG.md",
+      "**/cl100k_base.json",
+      "**/o200k_base.json"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "formatWithErrors": false,
+    "indentStyle": "tab",
+    "indentWidth": 2,
+    "lineEnding": "lf",
+    "lineWidth": 100,
+    "attributePosition": "auto"
+  },
+  "organizeImports": {
+    "enabled": true
+  },
+  "linter": {
+    "enabled": false
+  },
+  "javascript": {
+    "parser": {
+      "unsafeParameterDecoratorsEnabled": true
+    },
+    "formatter": {
+      "jsxQuoteStyle": "double",
+      "quoteProperties": "preserve",
+      "trailingCommas": "es5",
+      "semicolons": "always",
+      "arrowParentheses": "asNeeded",
+      "bracketSpacing": true,
+      "bracketSameLine": false,
+      "quoteStyle": "double",
+      "attributePosition": "auto"
+    }
+  },
+  "json": {
+    "parser": {
+      "allowComments": true,
+      "allowTrailingCommas": false
+    }
+  }
+}

package/configs/eslint-config/package.json

@@ -0,0 +1,60 @@
+{
+	"name": "eslint-config",
+	"version": "1.0.0",
+	"private": true,
+	"type": "module",
+	"exports": {
+		"./base": {
+			"types": "./src/configs/base.ts",
+			"import": "./dist/configs/base.mjs",
+			"require": "./dist/configs/base.mjs"
+		},
+		"./frontend": {
+			"types": "./src/configs/frontend.ts",
+			"import": "./dist/configs/frontend.mjs",
+			"require": "./dist/configs/frontend.mjs"
+		},
+		"./node": {
+			"types": "./src/configs/node.ts",
+			"import": "./dist/configs/node.mjs",
+			"require": "./dist/configs/node.mjs"
+		}
+	},
+	"scripts": {
+		"config:build": "tsdown",
+		"clean": "rimraf dist .turbo",
+		"deep:clean": "rimraf node_modules dist .turbo",
+		"typecheck": "tsc --noEmit",
+		"format": "biome format --write .",
+		"format:check": "biome ci .",
+		"test": "vitest run",
+		"test:dev": "vitest"
+	},
+	"dependencies": {
+		"@eslint/compat": "^2.0.2",
+		"@eslint/js": "^9.0.0",
+		"@stylistic/eslint-plugin": "^2.0.0",
+		"eslint-config-prettier": "^9.1.0",
+		"eslint-import-resolver-typescript": "^3.6.1",
+		"eslint-plugin-import-x": "^4.0.0",
+		"eslint-plugin-jsx-a11y": "^6.9.0",
+		"eslint-plugin-lodash": "^8.0.0",
+		"eslint-plugin-react": "^7.35.0",
+		"eslint-plugin-react-hooks": "^5.0.0",
+		"eslint-plugin-unicorn": "^55.0.0",
+		"eslint-plugin-unused-imports": "^4.0.0",
+		"globals": "^15.9.0",
+		"typescript-eslint": "^8.54.0"
+	},
+	"devDependencies": {
+		"@types/eslint-config-prettier": "^6.11.3",
+		"@types/eslint-plugin-jsx-a11y": "^6.10.1",
+		"@typescript-eslint/eslint-plugin": "^8.0.0",
+		"@typescript-eslint/rule-tester": "^8.54.0",
+		"@typescript-eslint/utils": "^8.0.0",
+		"eslint": "catalog:",
+		"tsdown-config": "workspace:*",
+		"typescript-config": "workspace:*",
+		"vitest-config": "workspace:*"
+	}
+}

package/configs/eslint-config/plugins.d.ts

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

package/configs/eslint-config/src/configs/base.ts

@@ -0,0 +1,237 @@
+import js from "@eslint/js";
+import { fixupPluginRules } from "@eslint/compat";
+import { createTypeScriptImportResolver } from "eslint-import-resolver-typescript";
+import importPlugin from "eslint-plugin-import-x";
+import lodashPlugin from "eslint-plugin-lodash";
+import reactPlugin from "eslint-plugin-react";
+import reactHooksPlugin from "eslint-plugin-react-hooks";
+import unicornPlugin from "eslint-plugin-unicorn";
+import unusedImportsPlugin from "eslint-plugin-unused-imports";
+import globals from "globals";
+import tseslint from "typescript-eslint";
+import stylisticPlugin from "@stylistic/eslint-plugin";
+import eslintConfigPrettier from "eslint-config-prettier";
+import { localRulesPlugin } from "../plugin.js"; // Assuming this exists
+
+export const baseConfig = tseslint.config(
+  {
+    ignores: [
+      "**/node_modules/**",
+      "**/dist/**",
+      "**/build/**",
+      "**/.next/**",
+      "eslint.config.mjs",
+      "tsup.config.ts",
+      "jest.config.js",
+      "cypress.config.js",
+      "vite.config.ts",
+      "vitest.config.ts",
+			"tsdown.config.ts",
+    ],
+  },
+
+  // 2. Base Configurations (Order matters)
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+  importPlugin.flatConfigs.recommended,
+  importPlugin.flatConfigs.typescript,
+
+  // 3. Main Configuration (Node, Express, Shared Logic)
+  {
+    plugins: {
+      // Compatibility fixups for plugins not yet strictly flat-config ready
+      "unused-imports": fixupPluginRules(unusedImportsPlugin),
+      "react-hooks": fixupPluginRules(reactHooksPlugin as any),
+      lodash: fixupPluginRules(lodashPlugin),
+
+      "@stylistic": stylisticPlugin as any,
+      unicorn: unicornPlugin,
+      react: reactPlugin,
+    },
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: "module",
+      // Combine globals for Monorepo (Node + Browser)
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        ...globals.es2021,
+      },
+      parserOptions: {
+        projectService: true, // Faster than 'project: true' for monorepos
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    settings: {
+      "import-x/resolver-next": [createTypeScriptImportResolver()],
+      react: {
+        version: "detect",
+      },
+    },
+    rules: {
+      // ******************************************************************
+      //                     Core Rules
+      // ******************************************************************
+      "no-void": ["error", { allowAsStatement: true }],
+      "no-constant-binary-expression": "error",
+      "no-console": ["warn", { allow: ["warn", "error"] }],
+      eqeqeq: "error",
+      "object-shorthand": "error",
+      "prefer-const": "error",
+
+      // ID Denylist
+      "id-denylist": [
+        "error",
+        "err",
+        "cb",
+        "callback",
+        "any",
+        "Number",
+        "number",
+        "String",
+        "string",
+        "Boolean",
+        "boolean",
+        "Undefined",
+        "undefined",
+      ],
+
+      // ******************************************************************
+      //                     TypeScript
+      // ******************************************************************
+      "@typescript-eslint/array-type": ["error", { default: "array-simple" }],
+      "@typescript-eslint/await-thenable": "error",
+      "@typescript-eslint/consistent-type-assertions": "error",
+      "@typescript-eslint/consistent-type-imports": "error",
+      "@typescript-eslint/consistent-type-exports": "error",
+      "@typescript-eslint/no-floating-promises": [
+        "error",
+        { ignoreVoid: true },
+      ],
+      "@typescript-eslint/no-misused-promises": [
+        "error",
+        { checksVoidReturn: false },
+      ],
+      "@typescript-eslint/only-throw-error": "error",
+      "@typescript-eslint/return-await": ["error", "always"],
+      "@typescript-eslint/explicit-member-accessibility": [
+        "error",
+        { accessibility: "no-public" },
+      ],
+      "@typescript-eslint/naming-convention": [
+        "error",
+        {
+          selector: "default",
+          format: ["camelCase"],
+        },
+        {
+          selector: "import",
+          format: ["camelCase", "PascalCase"],
+        },
+        {
+          selector: "variable",
+          format: ["camelCase", "snake_case", "UPPER_CASE", "PascalCase"],
+          leadingUnderscore: "allowSingleOrDouble",
+          trailingUnderscore: "allowSingleOrDouble",
+        },
+        {
+          selector: "typeLike",
+          format: ["PascalCase"],
+        },
+        {
+          selector: "enumMember",
+          format: ["UPPER_CASE", "PascalCase"],
+        },
+      ],
+      "@typescript-eslint/no-restricted-types": [
+        "error",
+        {
+          types: {
+            Object: { message: "Use object instead", fixWith: "object" },
+            String: { message: "Use string instead", fixWith: "string" },
+            Boolean: { message: "Use boolean instead", fixWith: "boolean" },
+            Number: { message: "Use number instead", fixWith: "number" },
+            Symbol: { message: "Use symbol instead", fixWith: "symbol" },
+            Function: {
+              message:
+                "The `Function` type accepts any function-like value. Define the explicit function shape.",
+            },
+          },
+        },
+      ],
+
+      // ******************************************************************
+      //                     Stylistic
+      // ******************************************************************
+      "@stylistic/member-delimiter-style": [
+        "error",
+        {
+          multiline: { delimiter: "semi", requireLast: true },
+          singleline: { delimiter: "semi", requireLast: false },
+        },
+      ],
+
+      // ******************************************************************
+      //                     Import X
+      // ******************************************************************
+      "import-x/no-cycle": ["error", { ignoreExternal: false, maxDepth: 3 }],
+      "import-x/no-default-export": "warn",
+      "import-x/no-duplicates": "error",
+      "import-x/order": [
+        "error",
+        {
+          alphabetize: { order: "asc", caseInsensitive: true },
+          groups: [
+            ["builtin", "external"],
+            "internal",
+            ["parent", "index", "sibling"],
+            "object",
+          ],
+          "newlines-between": "always",
+        },
+      ],
+
+      // ******************************************************************
+      //                     Plugins
+      // ******************************************************************
+      "unused-imports/no-unused-imports":
+        process.env.NODE_ENV === "development" ? "warn" : "error",
+
+      "unicorn/no-unnecessary-await": "error",
+      "unicorn/no-useless-promise-resolve-reject": "error",
+
+      "lodash/path-style": ["error", "as-needed"],
+      "lodash/import-scope": ["error", "method"],
+    },
+  },
+
+  // 4. React Specific Overrides (Only for .tsx / .jsx files)
+  {
+    files: ["**/*.tsx", "**/*.jsx"],
+    ...reactPlugin.configs.flat.recommended,
+    ...reactPlugin.configs.flat["jsx-runtime"],
+    rules: {
+      ...reactHooksPlugin.configs.recommended.rules,
+      "react/prop-types": "off", // Not needed with TypeScript
+      "react/react-in-jsx-scope": "off", // Not needed in modern React
+      "react/jsx-no-leaked-render": "error", // Security/Perf rule
+    },
+  },
+
+  // 5. Test Overrides
+  {
+    files: ["test/**/*.ts", "**/__tests__/*.ts", "**/*.test.ts", "**/*.cy.ts"],
+    rules: {
+      "local-rules/no-plain-errors": "off",
+      "@typescript-eslint/unbound-method": "off",
+      "import-x/no-default-export": "off", // Tests often need default export for config or simply don't care
+    },
+  },
+
+  // 6. Local Rules
+  localRulesPlugin.configs.recommended,
+
+  // 7. Prettier (Must be last to override stylistic rules)
+  eslintConfigPrettier
+);

package/configs/eslint-config/src/configs/frontend.ts

@@ -0,0 +1,62 @@
+import { fixupPluginRules } from "@eslint/compat";
+import { baseConfig } from "./base.js";
+import jsxA11yPlugin from "eslint-plugin-jsx-a11y";
+import reactPlugin from "eslint-plugin-react";
+import reactHooksPlugin from "eslint-plugin-react-hooks";
+import globals from "globals";
+import tseslint from "typescript-eslint";
+
+export const frontendConfig = tseslint.config(
+  ...baseConfig,
+
+  {
+    ignores: [
+      "**/dist/**",
+      "**/coverage/**",
+      "**/storybook-static/**",
+      "**/*.snap",
+      "**/*.d.ts",
+      "vite.config.ts",
+    ],
+  },
+
+  {
+    files: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"],
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+        ...globals.serviceworker,
+      },
+    },
+    settings: {
+      react: {
+        version: "detect",
+      },
+    },
+  },
+  reactPlugin.configs.flat.recommended,
+  reactPlugin.configs.flat["jsx-runtime"],
+
+  {
+    files: ["**/*.tsx", "**/*.jsx"],
+    plugins: {
+      "react-hooks": fixupPluginRules(reactHooksPlugin as any),
+      "jsx-a11y": fixupPluginRules(jsxA11yPlugin),
+    },
+    rules: {
+      ...reactHooksPlugin.configs.recommended.rules,
+      ...jsxA11yPlugin.configs.recommended.rules,
+
+      // --- React Hooks Specifics ---
+      "react-hooks/rules-of-hooks": "error",
+      "react-hooks/exhaustive-deps": "warn",
+
+      // --- Accessibility Specifics ---
+      "jsx-a11y/no-autofocus": "warn",
+      "jsx-a11y/click-events-have-key-events": "warn",
+      "jsx-a11y/no-static-element-interactions": "warn",
+      // Disable legacy rule that conflicts with modern HTML5
+      "jsx-a11y/no-onchange": "off",
+    },
+  }
+);

package/configs/eslint-config/src/configs/node.ts

@@ -0,0 +1,10 @@
+import globals from "globals";
+import tseslint from "typescript-eslint";
+import { baseConfig } from "./base.js";
+
+export const nodeConfig = tseslint.config(baseConfig, {
+  languageOptions: {
+    ecmaVersion: 2024,
+    globals: globals.node,
+  },
+});

package/configs/eslint-config/src/plugin.ts

@@ -0,0 +1,25 @@
+import type { ESLint } from "eslint";
+import { rules } from "./rules/index.js";
+const plugin = {
+	configs: {},
+	// @ts-expect-error Rules type does not match for typescript-eslint and eslint
+	rules: rules as ESLint.Plugin["rules"],
+} satisfies ESLint.Plugin;
+export const localRulesPlugin = {
+	...plugin,
+	configs: {
+		recommended: {
+			plugins: {
+				"local-rules": plugin,
+			},
+			rules: {
+				"local-rules/no-uncaught-json-parse": "error",
+				"local-rules/no-json-parse-json-stringify": "error",
+				"local-rules/no-interpolation-in-regular-string": "error",
+				"local-rules/no-unused-param-in-catch-clause": "error",
+				"local-rules/no-useless-catch-throw": "error",
+				"local-rules/no-internal-package-import": "error",
+			},
+		},
+	},
+} satisfies ESLint.Plugin;

package/configs/eslint-config/src/rules/index.ts

@@ -0,0 +1,30 @@
+import { NoJsonParseJsonStringifyRule } from "./no-json-parse-json-stringify.js";
+import { NoUncaughtJsonParseRule } from "./no-uncaught-json-parse.js";
+import { NoUnusedParamInCatchClauseRule } from "./no-unused-param-catch-clause.js";
+import { NoUselessCatchThrowRule } from "./no-useless-catch-throw.js";
+import { NoSkippedTestsRule } from "./no-skipped-tests.js";
+import { NoInterpolationInRegularStringRule } from "./no-interpolation-in-regular-string.js";
+import { NoPlainErrorsRule } from "./no-plain-errors.js";
+import { NoDynamicImportTemplateRule } from "./no-dynamic-import-template.js";
+import { NoTypeUnsafeEventEmitterRule } from "./no-type-unsafe-event-emitter.js";
+import { NoUntypedConfigClassFieldRule } from "./no-untyped-config-class-field.js";
+import { NoTopLevelRelativeImportsInBackendModuleRule } from "./no-top-level-relative-imports-in-backend-module.js";
+import type { AnyRuleModule } from "@typescript-eslint/utils/ts-eslint";
+import { NoArgumentSpreadRule } from "./no-argument-spread.js";
+import { NoInternalPackageImportRule } from "./no-internal-package-import.js";
+
+export const rules = {
+	"no-uncaught-json-parse": NoUncaughtJsonParseRule,
+	"no-json-parse-json-stringify": NoJsonParseJsonStringifyRule,
+	"no-unused-param-in-catch-clause": NoUnusedParamInCatchClauseRule,
+	"no-useless-catch-throw": NoUselessCatchThrowRule,
+	"no-skipped-tests": NoSkippedTestsRule,
+	"no-interpolation-in-regular-string": NoInterpolationInRegularStringRule,
+	"no-plain-errors": NoPlainErrorsRule,
+	"no-dynamic-import-template": NoDynamicImportTemplateRule,
+	"no-type-unsafe-event-emitter": NoTypeUnsafeEventEmitterRule,
+	"no-untyped-config-class-field": NoUntypedConfigClassFieldRule,
+	"no-top-level-relative-imports-in-backend-module": NoTopLevelRelativeImportsInBackendModuleRule,
+	"no-argument-spread": NoArgumentSpreadRule,
+	"no-internal-package-import": NoInternalPackageImportRule,
+} satisfies Record<string, AnyRuleModule>;

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

@@ -0,0 +1,47 @@
+import { RuleTester } from "@typescript-eslint/rule-tester";
+import { NoArgumentSpreadRule } from "./no-argument-spread.js";
+
+const ruleTester = new RuleTester();
+
+ruleTester.run("no-unbounded-argument-spread", NoArgumentSpreadRule, {
+  valid: [
+    { code: "fn(1, 2, 3)" },
+    { code: "fn(...[1, 2, 3])" },
+    { code: "new Foo(...[1, 2])" },
+    { code: "fn.apply(null, deps)" },
+    { code: "Reflect.construct(Foo, deps)" },
+  ],
+
+  invalid: [
+    {
+      code: "fn(...deps)",
+      output: "fn.apply(undefined, deps)",
+      errors: [{ messageId: "replaceWithApply" }],
+    },
+    {
+      code: "obj.fn(...deps)",
+      output: "obj.fn.apply(obj, deps)",
+      errors: [{ messageId: "replaceWithApply" }],
+    },
+    {
+      code: "instance = metadata.factory(...dependencies);",
+      output: "instance = metadata.factory.apply(metadata, dependencies);",
+      errors: [{ messageId: "replaceWithApply" }],
+    },
+    {
+      code: "new Foo(...deps)",
+      output: "Reflect.construct(Foo, deps)",
+      errors: [{ messageId: "replaceWithReflect" }],
+    },
+    {
+      code: "someFunction(a, ...deps)",
+      output: null, // multiple args — no fix
+      errors: [{ messageId: "replaceWithApply" }],
+    },
+    {
+      code: "new Bar(a, ...deps)",
+      output: null,
+      errors: [{ messageId: "replaceWithReflect" }],
+    },
+  ],
+});

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

@@ -0,0 +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,
+          });
+        }
+      },
+    };
+  },
+});

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

@@ -0,0 +1,32 @@
+import { ESLintUtils, type TSESTree } from '@typescript-eslint/utils';
+
+export const NoDynamicImportTemplateRule = ESLintUtils.RuleCreator.withoutDocs({
+	name: 'no-dynamic-import-template',
+	meta: {
+		type: 'problem',
+		docs: {
+			description:
+				'Disallow non-relative imports in template string argument to `await import()`, because `tsc-alias` as of 1.8.7 is unable to resolve aliased paths in this scenario.',
+		},
+		schema: [],
+		messages: {
+			noDynamicImportTemplate:
+				'Use relative imports in template string argument to `await import()`, because `tsc-alias` as of 1.8.7 is unable to resolve aliased paths in this scenario.',
+		},
+	},
+	defaultOptions: [],
+	create(context) {
+		return {
+			'AwaitExpression > ImportExpression TemplateLiteral'(node: TSESTree.TemplateLiteral) {
+				const templateValue = node.quasis[0].value.cooked;
+
+				if (!templateValue?.startsWith('@/')) return;
+
+				context.report({
+					node,
+					messageId: 'noDynamicImportTemplate',
+				});
+			},
+		};
+	},
+});