refactor: reorganize shell modules and lifecycle management

.gitignore

@@ -16,3 +16,5 @@ oneshot/style.css
 oneshot/**/build/
 
 debug/results/
+
+JSX*

README.md

@@ -120,12 +120,23 @@ pnpm check
 pnpm build
 ```
 
-Running `pnpm run tsc` will throw errors in the following 2 files:
+The minimum checks to run before creating a commit are:
+
+```sh
+pnpm check
+pnpm build
+git diff --check
+```
+
+`pnpm check` runs Prettier's check mode, ESLint, Knip, and the project type check.
+Use `pnpm format` to apply formatting before running the checks again.
+
+`pnpm check` ignores the following 2 known upstream type errors:
 
 > `../../../usr/share/ags/js/lib/gtk4/app.ts:288`
 > `../../../usr/share/ags/js/node_modules/gnim/dist/jsx/state.ts:715`
 
-You can safely ignore these errors.
+Use `pnpm run tsc` when you need the raw TypeScript output, including those upstream errors.
 
 ## Why AGS was chosen and its memory consumption
 

knip.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://unpkg.com/knip@6/schema.json",
   "tags": ["-lintignore"],
-  "entry": ["src/app.ts"],
-  "ignoreDependencies": ["gi", "system"],
+  "entry": ["src/app.ts", "scripts/build-js.mjs"],
+  "ignoreDependencies": ["cairo", "gi", "system"],
   "ignoreBinaries": ["ags"]
 }

package.json

@@ -7,6 +7,7 @@
     "@eslint/js": "^10.0.1",
     "@trivago/prettier-plugin-sort-imports": "^6.0.2",
     "@types/node": "^26.2.0",
+    "esbuild": "0.25.10",
     "eslint": "^10.5.0",
     "eslint-config-prettier": "^10.1.8",
     "knip": "^6.32.0",
@@ -18,14 +19,17 @@
     "generate-type": "ags types -d .",
     "lint": "eslint .",
     "format": "prettier --write \"./**/*.{js,ts,tsx,json,css,scss,md,html}\" \"./*.{js,ts,tsx,json}\"",
+    "format:check": "prettier --check \"./**/*.{js,ts,tsx,json,css,scss,md,html}\" \"./*.{js,ts,tsx,json}\"",
     "tsc": "tsc --noEmit",
+    "typecheck": "bash scripts/typecheck.sh",
     "knip": "knip",
-    "check": "pnpm lint && pnpm knip && pnpm tsc",
+    "check": "pnpm format:check && pnpm lint && pnpm knip && pnpm typecheck",
     "build": "./scripts/build.sh",
     "dev": "./scripts/dev.sh",
     "deploy:user": "./scripts/deploy-user.sh"
   },
   "name": "rystal-shell",
+  "packageManager": "pnpm@11.9.0",
   "license": "GPL-3.0-or-later",
   "private": true
 }

pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+allowBuilds:
+  esbuild: true

scripts/build-js.mjs

@@ -0,0 +1,15 @@
+import { build } from 'esbuild';
+
+await build({
+  entryPoints: ['src/app.ts'],
+  outfile: 'dist/app.js',
+  bundle: true,
+  external: ['gi://*', 'resource://*', 'cairo', 'console', 'system'],
+  format: 'esm',
+  keepNames: false,
+  minify: true,
+  platform: 'neutral',
+  sourcemap: false,
+  target: 'es2022',
+  tsconfig: 'tsconfig.json',
+});