@hominis/fireforge 0.31.0 → 0.33.0

package/dist/src/types/config.d.ts

@@ -129,6 +129,19 @@ export interface TypecheckConfig {
      * built-in shim first, extraShim second — augment, don't redeclare.
      */
     extraShim?: string;
+    /**
+     * Per-project override of {@link extraShim}, keyed by the project's path
+     * exactly as it appears in {@link projects}. A string value points the
+     * project at a different `.d.ts`; `null` opts the project out of the shared
+     * extra shim entirely (it absorbs only the built-in Firefox globals shim).
+     *
+     * Needed because the shared shim is injected into every project: a shim hub
+     * that references Gecko declaration libs (`lib.gecko.dom.d.ts`, …) is wanted
+     * by projects that include it but collides with a project that narrows
+     * `lib: ["ES2024", "DOM"]` (Element/Node identity splits, nsIPrincipal
+     * mismatch). A narrowed project sets `null` here to stay clean.
+     */
+    projectOverrides?: Record<string, string | null>;
 }
 /**
  * Wire command configuration.
@@ -145,8 +158,15 @@ export type PatchLintSeverityGate = 'off' | 'warning' | 'error';
 /**
  * Allowlisted TypeScript `compilerOptions` overrides for the patch
  * `checkJs` pass when {@link PatchLintConfig.checkJsStrict} is true.
- * Merged after the strict preset; only boolean flags — no `paths`,
- * `rootDir`, or other options that would fight the synthetic program.
+ * Merged after the strict preset.
+ *
+ * Boolean flags tighten the strict preset. The optional `paths` mapping
+ * (each pattern may carry a single `*`) lets patch-owned modules be typed
+ * from their real sources — e.g. `"resource:///modules/foo/*": ["./*"]` —
+ * resolved host-side against the engine directory, so no `baseUrl` is set
+ * (TS5090-safe) and no hand-generated ambient stub shim is needed. Other
+ * options (`rootDir`, etc.) stay disallowed: they would fight the
+ * synthetic program.
  */
 export interface PatchLintCheckJsCompilerOptions {
     strictNullChecks?: boolean;
@@ -157,6 +177,8 @@ export interface PatchLintCheckJsCompilerOptions {
     strictPropertyInitialization?: boolean;
     noUnusedLocals?: boolean;
     noUnusedParameters?: boolean;
+    /** Module-resolution `paths` mapping (pattern → targets, engine-relative). */
+    paths?: Record<string, string[]>;
 }
 /**
  * Configuration for patch lint rules.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hominis/fireforge",
-  "version": "0.31.0",
+  "version": "0.33.0",
   "description": "FireForge — a build tool for customizing Firefox",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -63,7 +63,7 @@
   "devDependencies": {
     "@eslint/js": "^10.0.0",
     "@types/estree": "^1.0.8",
-    "@types/node": "^25.5.2",
+    "@types/node": "^26.0.0",
     "@vitest/coverage-v8": "^4.1.2",
     "dpdm": "4.2.0",
     "eslint": "^10.0.0",
@@ -72,7 +72,7 @@
     "eslint-plugin-simple-import-sort": "^13.0.0",
     "fast-check": "^4.6.0",
     "husky": "^9.1.7",
-    "knip": "6.16.1",
+    "knip": "6.17.1",
     "lint-staged": "^17.0.4",
     "prettier": "^3.7.4",
     "tsx": "^4.7.0",