chore: initial monorepo scaffold

Setup pnpm workspaces with apps/{web,api} placeholders and shared
packages: tsconfig, eslint-config, shared, ui, db. Includes Prettier,
ESLint, Husky pre-commit, lint-staged, EditorConfig, VSCode settings.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

packages/db/.eslintrc.cjs

@@ -0,0 +1,5 @@
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+  root: true,
+  extends: ['@ketopath/eslint-config/node.cjs'],
+};

packages/db/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@ketopath/db",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --max-warnings=0"
+  },
+  "devDependencies": {
+    "@ketopath/eslint-config": "workspace:*",
+    "@ketopath/tsconfig": "workspace:*"
+  }
+}

packages/db/src/index.ts

@@ -0,0 +1 @@
+export {};

packages/db/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "@ketopath/tsconfig/node.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "composite": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

packages/eslint-config/index.cjs

@@ -0,0 +1,65 @@
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+  root: false,
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: 'module',
+  },
+  plugins: ['@typescript-eslint', 'import'],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:import/recommended',
+    'plugin:import/typescript',
+    'prettier',
+  ],
+  settings: {
+    'import/resolver': {
+      typescript: {
+        alwaysTryTypes: true,
+      },
+      node: true,
+    },
+  },
+  rules: {
+    '@typescript-eslint/no-explicit-any': 'error',
+    '@typescript-eslint/no-unused-vars': [
+      'error',
+      { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
+    ],
+    '@typescript-eslint/consistent-type-imports': [
+      'error',
+      { prefer: 'type-imports', fixStyle: 'inline-type-imports' },
+    ],
+    'import/order': [
+      'error',
+      {
+        groups: ['builtin', 'external', 'internal', 'parent', 'sibling', 'index'],
+        'newlines-between': 'always',
+        alphabetize: { order: 'asc', caseInsensitive: true },
+      },
+    ],
+    'import/no-default-export': 'off',
+  },
+  overrides: [
+    {
+      files: ['*.cjs', '*.config.js', '*.config.mjs'],
+      env: { node: true },
+      rules: {
+        '@typescript-eslint/no-var-requires': 'off',
+      },
+    },
+  ],
+  ignorePatterns: [
+    'node_modules/',
+    'dist/',
+    'build/',
+    '.next/',
+    'out/',
+    'coverage/',
+    '*.config.js',
+    '*.config.cjs',
+    '*.config.mjs',
+  ],
+};

packages/eslint-config/nextjs.cjs

@@ -0,0 +1,8 @@
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+  extends: [require.resolve('./index.cjs'), 'next/core-web-vitals'],
+  rules: {
+    'react/no-unescaped-entities': 'off',
+    '@next/next/no-html-link-for-pages': 'off',
+  },
+};

packages/eslint-config/node.cjs

@@ -0,0 +1,11 @@
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+  extends: [require.resolve('./index.cjs')],
+  env: {
+    node: true,
+    es2022: true,
+  },
+  rules: {
+    'no-console': ['warn', { allow: ['warn', 'error', 'info'] }],
+  },
+};

packages/eslint-config/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@ketopath/eslint-config",
+  "version": "0.0.0",
+  "private": true,
+  "main": "index.cjs",
+  "files": [
+    "index.cjs",
+    "nextjs.cjs",
+    "node.cjs"
+  ],
+  "peerDependencies": {
+    "eslint": "^8.57.0"
+  }
+}

packages/shared/.eslintrc.cjs

@@ -0,0 +1,5 @@
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+  root: true,
+  extends: ['@ketopath/eslint-config'],
+};

packages/shared/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@ketopath/shared",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --max-warnings=0"
+  },
+  "devDependencies": {
+    "@ketopath/eslint-config": "workspace:*",
+    "@ketopath/tsconfig": "workspace:*"
+  }
+}

packages/shared/src/index.ts

@@ -0,0 +1 @@
+export {};

packages/shared/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "@ketopath/tsconfig/base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "composite": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

packages/tsconfig/base.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Base",
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noImplicitOverride": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "incremental": true
+  }
+}

packages/tsconfig/nextjs.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Next.js",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "lib": ["DOM", "DOM.Iterable", "ES2022"],
+    "jsx": "preserve",
+    "allowJs": true,
+    "noEmit": true,
+    "plugins": [{ "name": "next" }]
+  }
+}

packages/tsconfig/node.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Node.js 20",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "types": ["node"]
+  }
+}

packages/tsconfig/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@ketopath/tsconfig",
+  "version": "0.0.0",
+  "private": true,
+  "files": [
+    "base.json",
+    "nextjs.json",
+    "node.json"
+  ]
+}

packages/ui/.eslintrc.cjs

@@ -0,0 +1,5 @@
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+  root: true,
+  extends: ['@ketopath/eslint-config'],
+};

packages/ui/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@ketopath/ui",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --max-warnings=0"
+  },
+  "devDependencies": {
+    "@ketopath/eslint-config": "workspace:*",
+    "@ketopath/tsconfig": "workspace:*"
+  }
+}

packages/ui/src/index.ts

@@ -0,0 +1 @@
+export {};

packages/ui/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "extends": "@ketopath/tsconfig/base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "composite": true,
+    "lib": ["DOM", "DOM.Iterable", "ES2022"],
+    "jsx": "preserve"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}