chore: Refactor code structure for improved readability and maintainability

Author: leandromqrs

.yarnrc.yml

@@ -0,0 +1,2 @@
+yarnPath: .yarn/releases/yarn-4.12.0.cjs
+nodeLinker: node-modules

Makefile

@@ -29,6 +29,10 @@ build({
   // firefox102 // Since GJS 1.73.2
   target: 'firefox102',
   format: 'esm',
+  alias: {
+    // Not exported in @girs/gnome-shell v49; map directly to runtime resource
+    '@girs/gnome-shell/ui/dash': 'resource:///org/gnome/shell/ui/dash.js',
+  },
   external: ['gi://*', 'resource://*', 'system', 'gettext', 'cairo'],
 })
   .then(() => {

esbuild.ts

@@ -0,0 +1,73 @@
+uuid := "aurora-shell@luminusos.com"
+ext_dir := env("HOME") / ".local/share/gnome-shell/extensions" / uuid
+
+# List available commands
+default:
+    @just --list
+
+# Install dependencies
+deps:
+    yarn install
+
+# Build everything (CSS + TypeScript + zip)
+build: deps
+    yarn build
+
+# Type-check without emitting
+validate:
+    yarn validate
+
+# Lint the codebase
+lint:
+    yarn lint
+
+# Watch SCSS files for changes
+watch:
+    yarn watch:css
+
+# Install extension to GNOME Shell
+install: build
+    mkdir -p {{ ext_dir }}
+    cp dist/extension.js {{ ext_dir }}/
+    cp dist/prefs.js {{ ext_dir }}/ 2>/dev/null || true
+    cp dist/stylesheet.css {{ ext_dir }}/
+    cp dist/stylesheet-light.css {{ ext_dir }}/
+    cp dist/stylesheet-dark.css {{ ext_dir }}/
+    cp dist/metadata.json {{ ext_dir }}/
+    cp -r schemas {{ ext_dir }}/ 2>/dev/null || true
+    glib-compile-schemas {{ ext_dir }}/schemas/ 2>/dev/null || true
+    @echo "Installed at: {{ ext_dir }}"
+
+# Uninstall extension
+uninstall:
+    gnome-extensions disable {{ uuid }} 2>/dev/null || true
+    rm -rf {{ ext_dir }}
+    @echo "Uninstalled."
+
+# Quick update (rebuild + copy files, no full install)
+quick: build
+    cp dist/extension.js {{ ext_dir }}/
+    cp dist/prefs.js {{ ext_dir }}/ 2>/dev/null || true
+    cp dist/stylesheet.css {{ ext_dir }}/
+    cp dist/stylesheet-light.css {{ ext_dir }}/
+    cp dist/stylesheet-dark.css {{ ext_dir }}/
+    cp dist/metadata.json {{ ext_dir }}/
+    cp -r schemas {{ ext_dir }}/ 2>/dev/null || true
+    glib-compile-schemas {{ ext_dir }}/schemas/ 2>/dev/null || true
+    @echo "Files updated. Log out and back in to apply."
+
+# Show recent extension logs
+logs:
+    journalctl -b 0 /usr/bin/gnome-shell | grep "Aurora Shell" | tail -n 20
+
+# Clean build artifacts
+clean:
+    rm -rf dist
+
+# Full clean (artifacts + dependencies)
+distclean: clean
+    rm -rf node_modules
+
+# Clean build + install
+all: clean build install
+    @echo "Complete installation finished."

justfile

@@ -10,19 +10,19 @@
     "clear": "rm -rf dist",
     "build:ts": "tsx esbuild.ts",
     "build:css": "tsx sass.config.ts",
-    "build": "npm run clear && npm run build:css && npm run build:ts",
+    "build": "yarn clear && yarn build:css && yarn build:ts",
     "lint": "cross-env NODE_OPTIONS=--import=tsx/esm eslint .",
     "validate": "tsc --noEmit",
     "watch:css": "tsx sass.config.ts --watch"
   },
   "devDependencies": {
-    "chokidar": "^3.6.0",
     "@eslint/js": "^9.39.1",
     "@stylistic/eslint-plugin": "^2.6.4",
     "@tsconfig/strictest": "^2.0.6",
     "@types/adm-zip": "^0.5.7",
     "@types/node": "^24.10.1",
     "adm-zip": "^0.5.16",
+    "chokidar": "^3.6.0",
     "cross-env": "^10.1.0",
     "esbuild": "^0.25.11",
     "eslint": "^9.39.1",
@@ -35,9 +35,10 @@
   "dependencies": {
     "@girs/adw-1": "1.9.0-4.0.0-beta.38",
     "@girs/gjs": "^4.0.0-beta.38",
-    "@girs/gnome-shell": "^49.0.3",
+    "@girs/gnome-shell": "^49.1.0",
     "@girs/gobject-2.0": "^2.86.0-4.0.0-beta.38",
     "@girs/shell-17": "^17.0.0-4.0.0-beta.38",
     "@girs/st-17": "^17.0.0-4.0.0-beta.38"
-  }
+  },
+  "packageManager": "yarn@4.12.0"
 }

package.json

@@ -0,0 +1,59 @@
+import { ThemeChanger } from "./themeChanger.ts";
+import { Dock } from "./dock.ts";
+import { NoOverview } from "./noOverview.ts";
+import { PipOnTop } from "./pipOnTop.ts";
+import type { Module } from "./module.ts";
+
+/**
+ * Module definition that includes both runtime and UI metadata
+ */
+export type ModuleDefinition = {
+  /** Internal key used in the modules Map */
+  key: string;
+  /** GSettings schema key */
+  settingsKey: string;
+  /** Factory function to create module instance */
+  create: () => Module;
+  /** User-facing title for preferences UI */
+  title: string;
+  /** User-facing subtitle/description for preferences UI */
+  subtitle: string;
+};
+
+/**
+ * Single source of truth for all available modules.
+ * To add a new module:
+ * 1. Import its class at the top
+ * 2. Add one entry to this array
+ * 3. Add corresponding key to gschema.xml
+ */
+export const MODULE_REGISTRY: ModuleDefinition[] = [
+  {
+    key: 'themeChanger',
+    settingsKey: 'module-theme-changer',
+    create: () => new ThemeChanger(),
+    title: 'Theme Changer',
+    subtitle: 'Monitors and synchronizes GNOME color scheme',
+  },
+  {
+    key: 'dock',
+    settingsKey: 'module-dock',
+    create: () => new Dock(),
+    title: 'Dock',
+    subtitle: 'Custom dock with auto-hide and intellihide features',
+  },
+  {
+    key: 'noOverview',
+    settingsKey: 'module-no-overview',
+    create: () => new NoOverview(),
+    title: 'No Overview',
+    subtitle: 'Disables the overview at startup',
+  },
+  {
+    key: 'pipOnTop',
+    settingsKey: 'module-pip-on-top',
+    create: () => new PipOnTop(),
+    title: 'Pip On Top',
+    subtitle: 'Keeps Picture-in-Picture windows always on top',
+  },
+];