emoemu 0.1.0

package/eslint.config.js

@@ -0,0 +1,111 @@
+import eslint from '@eslint/js';
+import tseslint from '@typescript-eslint/eslint-plugin';
+import tsparser from '@typescript-eslint/parser';
+import preferArrowFunctions from 'eslint-plugin-prefer-arrow-functions';
+
+export default [
+  {
+    ignores: ['dist/**', 'node_modules/**'],
+  },
+  {
+    files: ['src/**/*.ts', 'src/**/*.tsx'],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+        project: './tsconfig.json',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint,
+      'prefer-arrow-functions': preferArrowFunctions,
+    },
+    rules: {
+      // Enforce arrow function style
+      'prefer-arrow-functions/prefer-arrow-functions': [
+        'error',
+        {
+          allowNamedFunctions: false,
+          classPropertiesAllowed: false,
+          disallowPrototype: false,
+          returnStyle: 'unchanged',
+          singleReturnOnly: false,
+        },
+      ],
+      // Also enforce arrow functions for callbacks
+      'prefer-arrow-callback': 'error',
+      // Enforce const for variables that are never reassigned
+      'prefer-const': 'error',
+      // Disallow var declarations, use let or const instead
+      'no-var': 'error',
+      // Require === and !== instead of == and !=
+      'eqeqeq': 'error',
+      // Require braces around all blocks
+      'curly': 'error',
+      // Ensure promises are awaited or handled
+      '@typescript-eslint/no-floating-promises': 'error',
+      // Catch common promise mistakes
+      '@typescript-eslint/no-misused-promises': 'error',
+      // Only await things that are actually promises
+      '@typescript-eslint/await-thenable': 'error',
+      // Catch conditions that are always true/false
+      '@typescript-eslint/no-unnecessary-condition': 'error',
+      // Catch unnecessary type conversions
+      '@typescript-eslint/no-unnecessary-type-conversion': 'error',
+      // Disallow unsafe operations with `any` types
+      '@typescript-eslint/no-unsafe-argument': 'error',
+      '@typescript-eslint/no-unsafe-assignment': 'error',
+      '@typescript-eslint/no-unsafe-call': 'error',
+      '@typescript-eslint/no-unsafe-member-access': 'error',
+      '@typescript-eslint/no-unsafe-return': 'error',
+      // Only throw Error objects, not strings or literals
+      'no-throw-literal': 'error',
+      // Enforce using interface instead of type for object type definitions
+      '@typescript-eslint/consistent-type-definitions': ['error', 'interface'],
+      // Prevent importing from /index paths directly and .js extensions
+      'no-restricted-imports': [
+        'error',
+        {
+          patterns: [
+            {
+              group: ['**/index', '**/index.*'],
+              message:
+                'Import the module root ("module") instead of "module/index".',
+            },
+            {
+              group: ['**/*.js'],
+              message:
+                'Do not include .js in import paths; use the bare path instead.',
+            },
+          ],
+        },
+      ],
+      // Disallow magic numbers - use named constants instead
+      '@typescript-eslint/no-magic-numbers': [
+        'error',
+        {
+          ignore: [-1, 0, 1, 2],
+          ignoreArrayIndexes: true,
+          ignoreDefaultValues: true,
+          ignoreEnums: true,
+          ignoreNumericLiteralTypes: true,
+          ignoreReadonlyClassProperties: true,
+          ignoreTypeIndexes: true,
+        },
+      ],
+    },
+  },
+  {
+    files: ['src/**/tests.ts'],
+    rules: {
+      '@typescript-eslint/no-magic-numbers': 'off',
+      '@typescript-eslint/no-unsafe-argument': 'off',
+      '@typescript-eslint/no-unsafe-assignment': 'off',
+      '@typescript-eslint/no-unsafe-call': 'off',
+      '@typescript-eslint/no-unsafe-member-access': 'off',
+      '@typescript-eslint/no-unsafe-return': 'off',
+      '@typescript-eslint/no-unnecessary-condition': 'off',
+    },
+  },
+];

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "emoemu",
+  "version": "0.1.0",
+  "description": "A terminal-based multi-core emulator written in TypeScript",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "emoemu": "dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsup src/index.ts --watch --onSuccess 'node dist/index.js'",
+    "build": "tsc --noEmit && tsup src/index.ts --format esm --dts --define.__APP_VERSION__=\\\"$npm_package_version\\\" --define.__BUILD_DATE__=\\\"$(date +%Y%m%d)\\\" --define.__APP_ICON_BASE64__=\\\"$(base64 -i icon/icon.png | tr -d '\\n')\\\"",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "check": "pnpm run typecheck && pnpm run lint && pnpm run test:run"
+  },
+  "keywords": [
+    "nes",
+    "emulator",
+    "terminal",
+    "tui",
+    "6502"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@inkjs/ui": "^2.0.0",
+    "audify": "^1.10.1",
+    "chalk": "^5.3.0",
+    "fzstd": "^0.1.1",
+    "ink": "^6.6.0",
+    "ink-native": "^0.4.0",
+    "koffi": "^2.15.0",
+    "node-hid": "^3.1.0",
+    "node-notifier": "^10.0.1",
+    "react": "^19.2.3",
+    "remeda": "^2.33.1",
+    "sharp": "^0.34.5"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^22.10.2",
+    "@types/node-hid": "^1.3.4",
+    "@types/node-notifier": "^8.0.5",
+    "@types/react": "^19.2.7",
+    "@typescript-eslint/eslint-plugin": "^8.52.0",
+    "@typescript-eslint/parser": "^8.52.0",
+    "eslint": "^9.39.2",
+    "eslint-plugin-prefer-arrow-functions": "^3.9.1",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "packageManager": "pnpm@11.10.0"
+}

package/pnpm-workspace.yaml

@@ -0,0 +1,10 @@
+minimumReleaseAge: 10080
+minimumReleaseAgeExclude:
+  - ink-sdl
+
+allowBuilds:
+  audify: true
+  esbuild: true
+  koffi: true
+  node-hid: true
+  sharp: true

package/src/Emulator/consts.ts

@@ -0,0 +1,14 @@
+// Periodic bounds re-detection intervals
+export const BOUNDS_CHECK_INTERVAL_INITIAL = 60;
+export const BOUNDS_CHECK_INTERVAL_LATER = 300;
+export const BOUNDS_CHECK_MAX_COUNT = 10;
+export const BOUNDS_CHECK_INITIAL_COUNT = 3;  // Use initial interval for first N checks
+
+/** Auto-save interval in ms (only saves if SRAM was modified) */
+export const AUTO_SAVE_INTERVAL_MS = 30000;
+
+/** Status bar update interval in frames (~10 FPS at 60 FPS) */
+export const STATUS_BAR_UPDATE_INTERVAL = 6;
+
+/** Default duration for core messages in ms */
+export const DEFAULT_MESSAGE_DURATION_MS = 3000;