prettier-config-nick2bad4u 1.0.10 → 1.0.12

package/README.md

@@ -1,5 +1,7 @@
 # prettier-config-nick2bad4u
 
+[![npm license.](https://flat.badgen.net/npm/license/prettier-config-nick2bad4u?color=purple)](https://github.com/Nick2bad4u/prettier-config-nick2bad4u/blob/main/LICENSE) [![npm total downloads.](https://flat.badgen.net/npm/dt/prettier-config-nick2bad4u?color=pink)](https://www.npmjs.com/package/prettier-config-nick2bad4u) [![latest GitHub release.](https://flat.badgen.net/github/release/Nick2bad4u/prettier-config-nick2bad4u?color=cyan)](https://github.com/Nick2bad4u/prettier-config-nick2bad4u/releases) [![GitHub stars.](https://flat.badgen.net/github/stars/Nick2bad4u/prettier-config-nick2bad4u?color=yellow)](https://github.com/Nick2bad4u/prettier-config-nick2bad4u/stargazers) [![GitHub forks.](https://flat.badgen.net/github/forks/Nick2bad4u/prettier-config-nick2bad4u?color=green)](https://github.com/Nick2bad4u/prettier-config-nick2bad4u/forks) [![GitHub open issues.](https://flat.badgen.net/github/open-issues/Nick2bad4u/prettier-config-nick2bad4u?color=red)](https://github.com/Nick2bad4u/prettier-config-nick2bad4u/issues) [![codecov.](https://codecov.io/gh/Nick2bad4u/prettier-config-nick2bad4u/branch/main/graph/badge.svg)](https://codecov.io/gh/Nick2bad4u/prettier-config-nick2bad4u)
+
 Shared Prettier config for Nick2bad4u projects.
 
 ## Install
@@ -108,6 +110,165 @@ void extensionlessJsonOptions;
 > `.browserlistrc` is **not** INI/properties syntax, so it is not included in
 > the extensionless INI defaults.
 
+### Option 5: inherit existing override options for specific files
+
+Use `inheritedOverrides` when you want one file (or file group) to keep the
+same plugin/options behavior from a base override and only change a small delta
+(for example `printWidth`).
+
+```js
+import { createConfig } from "prettier-config-nick2bad4u";
+
+export default createConfig({
+    inheritedOverrides: [
+        {
+            inheritFrom: "*.ts",
+            files: "src/shared-config.ts",
+            options: {
+                printWidth: 140,
+            },
+        },
+    ],
+});
+```
+
+This keeps TypeScript override behavior (plugins and related options) and only
+overrides `printWidth` for `src/shared-config.ts`.
+
+### Option 6: use exported common override option presets
+
+For advanced local configs, you can directly use option presets exported by the
+package.
+
+```js
+import prettierConfig, {
+    jsonOverrideOptions,
+    typescriptOverrideOptions,
+} from "prettier-config-nick2bad4u";
+
+export default {
+    ...prettierConfig,
+    overrides: [
+        ...(prettierConfig.overrides ?? []),
+        {
+            files: "src/shared-config.ts",
+            options: {
+                ...typescriptOverrideOptions,
+                printWidth: 140,
+            },
+        },
+        {
+            files: "config/custom.json",
+            options: {
+                ...jsonOverrideOptions,
+                printWidth: 120,
+            },
+        },
+    ],
+};
+```
+
+Available named override option presets:
+
+- `typescriptOverrideOptions`
+- `jsonOverrideOptions`
+- `packageJsonOverrideOptions`
+- `htmlOverrideOptions`
+- `userJavaScriptOverrideOptions`
+- `markdownOverrideOptions`
+- `mdxOverrideOptions`
+- `tomlOverrideOptions`
+- `xmlOverrideOptions`
+- `phpOverrideOptions`
+- `sqlOverrideOptions`
+- `powershellOverrideOptions`
+- `codeownersOverrideOptions`
+- `shellOverrideOptions`
+- `propertiesOverrideOptions`
+- `iniOverrideOptions`
+- `extensionlessJsonOptions`
+- `extensionlessIniOptions`
+
+### Option 7: full manual options block (most explicit, zero magic)
+
+The simplest and most robust approach when `inheritedOverrides` doesn't behave
+as expected: just paste the full options block directly. Every plugin and option
+is explicitly present, so there is nothing implicit to break.
+
+```js
+import prettierConfig from "prettier-config-nick2bad4u";
+
+export default {
+    ...prettierConfig,
+    overrides: [
+        ...(prettierConfig.overrides ?? []),
+        {
+            files: "src/shared-config.ts",
+            options: {
+                endOfLine: "lf",
+                jsdocBracketSpacing: false,
+                jsdocCapitalizeDescription: true,
+                jsdocCommentLineStrategy: "keep",
+                jsdocDescriptionTag: false,
+                jsdocDescriptionWithDot: false,
+                jsdocEmptyCommentStrategy: "keep",
+                jsdocKeepUnParseAbleExampleIndent: false,
+                jsdocLineWrappingStyle: "greedy",
+                jsdocPreferCodeFences: true,
+                jsdocPrintWidth: 80,
+                jsdocSeparateReturnsFromParam: true,
+                jsdocSeparateTagGroups: true,
+                jsdocSpaces: 1,
+                jsdocVerticalAlignment: false,
+                multilineArraysWrapThreshold: 2,
+                plugins: [
+                    "@softonus/prettier-plugin-duplicate-remover",
+                    "prettier-plugin-multiline-arrays",
+                    "prettier-plugin-jsdoc",
+                    "prettier-plugin-interpolated-html-tags",
+                    "prettier-plugin-merge",
+                ],
+                printWidth: 140, // your override
+                tsdoc: true,
+                useTabs: false,
+            },
+        },
+    ],
+};
+```
+
+This is the recommended fallback if you ever find plugin behavior not applying
+correctly: copy the relevant options block from the named presets above and
+paste it in verbatim.
+
+### Option 8: legacy/manual override inheritance (kept for compatibility)
+
+If you prefer the original manual discovery approach, this still works:
+
+```js
+import prettierConfig from "prettier-config-nick2bad4u";
+
+const tsOverride = (prettierConfig.overrides ?? []).find(
+    (override) =>
+        Array.isArray(override.files) &&
+        override.files.includes("*.ts")
+);
+
+export default {
+    ...prettierConfig,
+    overrides: [
+        ...(prettierConfig.overrides ?? []),
+        {
+            files: "src/shared-config.ts",
+            options: {
+                ...(tsOverride?.options ?? {}),
+                printWidth: 140,
+            },
+        },
+    ],
+};
+```
+
 ## What this config includes
 
 - Base formatting options (quotes, semicolons, trailing commas, tab width, etc.)
@@ -118,7 +279,7 @@ void extensionlessJsonOptions;
 
 - Default export: the shared Prettier config object
 - Named export: `config`
-- Named exports: `createConfig`, `defaultExtensionlessJsonFiles`, `defaultExtensionlessIniFiles`, `extensionlessJsonOptions`, `extensionlessIniOptions`
+- Named exports: `createConfig`, `defaultExtensionlessJsonFiles`, `defaultExtensionlessIniFiles`, `extensionlessJsonOptions`, `extensionlessIniOptions`, `typescriptOverrideOptions`, `jsonOverrideOptions`, `packageJsonOverrideOptions`, `htmlOverrideOptions`, `userJavaScriptOverrideOptions`, `markdownOverrideOptions`, `mdxOverrideOptions`, `tomlOverrideOptions`, `xmlOverrideOptions`, `phpOverrideOptions`, `sqlOverrideOptions`, `powershellOverrideOptions`, `codeownersOverrideOptions`, `shellOverrideOptions`, `propertiesOverrideOptions`, `iniOverrideOptions`
 - Published files: `prettier.config.mjs`, `preset.mjs`, and `index.d.ts`
 
 ## Development checks

package/index.d.ts

@@ -6,12 +6,38 @@ export interface CreateConfigOptions {
     extensionlessIniFiles?: readonly string[];
     /** Additional extensionless JSON-like file globs to include. */
     extensionlessJsonFiles?: readonly string[];
+    /**
+     * Additional file-targeted overrides that inherit options from existing
+     * base overrides.
+     */
+    inheritedOverrides?: readonly InheritedOverrideConfig[];
     /** Replace default INI-like globs instead of merging with them. */
     replaceDefaultExtensionlessIniFiles?: boolean;
     /** Replace default JSON-like globs instead of merging with them. */
     replaceDefaultExtensionlessJsonFiles?: boolean;
 }
 
+/**
+ * Configuration for appending an override that inherits from an existing base
+ * override.
+ */
+export interface InheritedOverrideConfig {
+    /** Optional file pattern(s) to exclude from the inherited override. */
+    excludeFiles?: string | string[];
+    /** File pattern(s) for the new inherited override to target. */
+    files: string | string[];
+    /**
+     * Existing base override file pattern(s) to inherit options from (for
+     * example "*.ts").
+     */
+    inheritFrom: string | string[];
+    /**
+     * Additional override options merged on top of the inherited source
+     * options.
+     */
+    options?: Readonly<Partial<Config>>;
+}
+
 /** Named export — use when you want to spread or inspect individual options. */
 export declare const config: Readonly<Config>;
 
@@ -23,6 +49,38 @@ export declare const defaultExtensionlessJsonFiles: readonly string[];
 export declare const extensionlessIniOptions: Readonly<Partial<Config>>;
 /** Shared option preset used for extensionless JSON-like override blocks. */
 export declare const extensionlessJsonOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by the primary JS/TS override block. */
+export declare const typescriptOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by the generic JSON override block. */
+export declare const jsonOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by the package.json/package-lock override block. */
+export declare const packageJsonOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by HTML override blocks. */
+export declare const htmlOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by *.user.js override blocks. */
+export declare const userJavaScriptOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by Markdown override blocks. */
+export declare const markdownOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by MDX override blocks. */
+export declare const mdxOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by TOML override blocks. */
+export declare const tomlOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by XML-family override blocks. */
+export declare const xmlOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by PHP override blocks. */
+export declare const phpOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by SQL override blocks. */
+export declare const sqlOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by PowerShell override blocks. */
+export declare const powershellOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by CODEOWNERS override blocks. */
+export declare const codeownersOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by shell script override blocks. */
+export declare const shellOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by .properties override blocks. */
+export declare const propertiesOverrideOptions: Readonly<Partial<Config>>;
+/** Shared option preset used by .ini override blocks. */
+export declare const iniOverrideOptions: Readonly<Partial<Config>>;
 
 /** Build a shared config with merged or replaced extensionless override globs. */
 export declare function createConfig(

package/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://www.schemastore.org/package.json",
     "name": "prettier-config-nick2bad4u",
-    "version": "1.0.10",
+    "version": "1.0.12",
     "private": false,
     "description": "Shared Prettier config for Nick2bad4u projects.",
     "keywords": [
@@ -85,7 +85,6 @@
         "@prettier/plugin-php": "^0.25.0",
         "@prettier/plugin-xml": "^3.4.2",
         "@softonus/prettier-plugin-duplicate-remover": "^1.1.2",
-        "npm-check-updates": "^22.1.0",
         "prettier-plugin-codeowners": "^0.1.1",
         "prettier-plugin-ini": "^1.3.0",
         "prettier-plugin-interpolated-html-tags": "^2.0.1",
@@ -102,27 +101,29 @@
     },
     "devDependencies": {
         "@arethetypeswrong/cli": "^0.18.2",
-        "@types/node": "^25.6.0",
+        "@codecov/bundle-analyzer": "^2.0.1",
+        "@types/node": "^25.6.2",
         "@vitest/coverage-v8": "^4.1.5",
         "cross-env": "^10.1.0",
         "eslint": "^10.3.0",
-        "eslint-config-nick2bad4u": "^1.0.11",
+        "eslint-config-nick2bad4u": "^1.0.12",
         "git-cliff": "^2.13.1",
+        "npm-check-updates": "^22.1.1",
         "npm-package-json-lint": "^10.4.0",
         "picocolors": "^1.1.1",
         "prettier": "^3.8.3",
-        "publint": "^0.3.19",
+        "publint": "^0.3.20",
         "secretlint": "^13.0.0",
         "secretlint-config-nick2bad4u": "^1.0.4",
         "sort-package-json": "^3.6.1",
         "typescript": "^6.0.3",
-        "vite": "^8.0.10",
+        "vite": "^8.0.11",
         "vitest": "^4.1.5"
     },
     "peerDependencies": {
         "prettier": "^3.0.0 || ^3.8.3"
     },
-    "packageManager": "npm@11.14.0",
+    "packageManager": "npm@11.14.1",
     "engines": {
         "node": ">=22.0.0"
     },

package/preset.mjs

@@ -1,9 +1,25 @@
 import sharedPrettierConfig, {
+    codeownersOverrideOptions as codeownersOverrideOptionsInternal,
     createConfig as createConfigInternal,
     defaultExtensionlessIniFiles as defaultExtensionlessIniFilesInternal,
     defaultExtensionlessJsonFiles as defaultExtensionlessJsonFilesInternal,
     extensionlessIniOptions as extensionlessIniOptionsInternal,
     extensionlessJsonOptions as extensionlessJsonOptionsInternal,
+    htmlOverrideOptions as htmlOverrideOptionsInternal,
+    iniOverrideOptions as iniOverrideOptionsInternal,
+    jsonOverrideOptions as jsonOverrideOptionsInternal,
+    markdownOverrideOptions as markdownOverrideOptionsInternal,
+    mdxOverrideOptions as mdxOverrideOptionsInternal,
+    packageJsonOverrideOptions as packageJsonOverrideOptionsInternal,
+    phpOverrideOptions as phpOverrideOptionsInternal,
+    powershellOverrideOptions as powershellOverrideOptionsInternal,
+    propertiesOverrideOptions as propertiesOverrideOptionsInternal,
+    shellOverrideOptions as shellOverrideOptionsInternal,
+    sqlOverrideOptions as sqlOverrideOptionsInternal,
+    tomlOverrideOptions as tomlOverrideOptionsInternal,
+    typescriptOverrideOptions as typescriptOverrideOptionsInternal,
+    userJavaScriptOverrideOptions as userJavaScriptOverrideOptionsInternal,
+    xmlOverrideOptions as xmlOverrideOptionsInternal,
 } from "./prettier.config.mjs";
 
 /** Named export — use when you want to spread or inspect individual options. */
@@ -16,6 +32,12 @@ export const config = Object.freeze(sharedPrettierConfig);
  *     options?: Readonly<{
  *         extensionlessIniFiles?: readonly string[];
  *         extensionlessJsonFiles?: readonly string[];
+ *         inheritedOverrides?: ReadonlyArray<{
+ *             files: string | string[];
+ *             inheritFrom: string | string[];
+ *             excludeFiles?: string | string[];
+ *             options?: Readonly<Partial<import("prettier").Config>>;
+ *         }>;
  *         replaceDefaultExtensionlessIniFiles?: boolean;
  *         replaceDefaultExtensionlessJsonFiles?: boolean;
  *     }>
@@ -44,6 +66,86 @@ export const extensionlessJsonOptions = Object.freeze({
     ...extensionlessJsonOptionsInternal,
 });
 
+/** Shared option preset used by the primary JS/TS override block. */
+export const typescriptOverrideOptions = Object.freeze({
+    ...typescriptOverrideOptionsInternal,
+});
+
+/** Shared option preset used by the generic JSON override block. */
+export const jsonOverrideOptions = Object.freeze({
+    ...jsonOverrideOptionsInternal,
+});
+
+/** Shared option preset used by the package.json/package-lock override block. */
+export const packageJsonOverrideOptions = Object.freeze({
+    ...packageJsonOverrideOptionsInternal,
+});
+
+/** Shared option preset used by HTML override blocks. */
+export const htmlOverrideOptions = Object.freeze({
+    ...htmlOverrideOptionsInternal,
+});
+
+/** Shared option preset used by *.user.js override blocks. */
+export const userJavaScriptOverrideOptions = Object.freeze({
+    ...userJavaScriptOverrideOptionsInternal,
+});
+
+/** Shared option preset used by Markdown override blocks. */
+export const markdownOverrideOptions = Object.freeze({
+    ...markdownOverrideOptionsInternal,
+});
+
+/** Shared option preset used by MDX override blocks. */
+export const mdxOverrideOptions = Object.freeze({
+    ...mdxOverrideOptionsInternal,
+});
+
+/** Shared option preset used by TOML override blocks. */
+export const tomlOverrideOptions = Object.freeze({
+    ...tomlOverrideOptionsInternal,
+});
+
+/** Shared option preset used by XML-family override blocks. */
+export const xmlOverrideOptions = Object.freeze({
+    ...xmlOverrideOptionsInternal,
+});
+
+/** Shared option preset used by PHP override blocks. */
+export const phpOverrideOptions = Object.freeze({
+    ...phpOverrideOptionsInternal,
+});
+
+/** Shared option preset used by SQL override blocks. */
+export const sqlOverrideOptions = Object.freeze({
+    ...sqlOverrideOptionsInternal,
+});
+
+/** Shared option preset used by PowerShell override blocks. */
+export const powershellOverrideOptions = Object.freeze({
+    ...powershellOverrideOptionsInternal,
+});
+
+/** Shared option preset used by CODEOWNERS override blocks. */
+export const codeownersOverrideOptions = Object.freeze({
+    ...codeownersOverrideOptionsInternal,
+});
+
+/** Shared option preset used by shell script override blocks. */
+export const shellOverrideOptions = Object.freeze({
+    ...shellOverrideOptionsInternal,
+});
+
+/** Shared option preset used by .properties override blocks. */
+export const propertiesOverrideOptions = Object.freeze({
+    ...propertiesOverrideOptionsInternal,
+});
+
+/** Shared option preset used by .ini override blocks. */
+export const iniOverrideOptions = Object.freeze({
+    ...iniOverrideOptionsInternal,
+});
+
 /**
  * Default export — distinct binding so consuming projects don't trigger
  * `import-x/no-named-as-default` when they write `import prettierConfig from

package/prettier.config.mjs

@@ -5,10 +5,20 @@
  * @see https://www.schemastore.org/prettierrc/
  */
 
+/**
+ * @typedef {{
+ *     files: string | string[];
+ *     inheritFrom: string | string[];
+ *     excludeFiles?: string | string[];
+ *     options?: Readonly<Partial<import("prettier").Config>>;
+ * }} InheritedOverrideConfig
+ */
+
 /**
  * @typedef {{
  *     extensionlessIniFiles?: readonly string[];
  *     extensionlessJsonFiles?: readonly string[];
+ *     inheritedOverrides?: readonly InheritedOverrideConfig[];
  *     replaceDefaultExtensionlessIniFiles?: boolean;
  *     replaceDefaultExtensionlessJsonFiles?: boolean;
  * }} CreateConfigOptions
@@ -49,6 +59,188 @@ export const extensionlessIniOptions = Object.freeze({
     useTabs: false,
 });
 
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const typescriptOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    jsdocBracketSpacing: false,
+    jsdocCapitalizeDescription: true,
+    jsdocCommentLineStrategy: "keep",
+    jsdocDescriptionTag: false,
+    jsdocDescriptionWithDot: false,
+    jsdocEmptyCommentStrategy: "keep",
+    jsdocKeepUnParseAbleExampleIndent: false,
+    jsdocLineWrappingStyle: "greedy",
+    jsdocPreferCodeFences: true,
+    jsdocPrintWidth: 80,
+    jsdocSeparateReturnsFromParam: true,
+    jsdocSeparateTagGroups: true,
+    jsdocSpaces: 1,
+    jsdocVerticalAlignment: false,
+    multilineArraysWrapThreshold: 2,
+    plugins: [
+        "@softonus/prettier-plugin-duplicate-remover",
+        "prettier-plugin-multiline-arrays",
+        "prettier-plugin-jsdoc",
+        "prettier-plugin-interpolated-html-tags",
+        "prettier-plugin-merge",
+    ],
+    tsdoc: true,
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const jsonOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    jsonRecursiveSort: false,
+    jsonSortOrder: '{"*": "numeric"}',
+    multilineArraysWrapThreshold: 2,
+    plugins: ["prettier-plugin-sort-json", "prettier-plugin-multiline-arrays"],
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const packageJsonOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    multilineArraysWrapThreshold: 2,
+    plugins: [
+        "prettier-plugin-packagejson",
+        "prettier-plugin-multiline-arrays",
+    ],
+    tabWidth: 4,
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const htmlOverrideOptions = Object.freeze({
+    htmlWhitespaceSensitivity: "strict",
+    plugins: ["@softonus/prettier-plugin-duplicate-remover"],
+    printWidth: 80,
+    singleAttributePerLine: true,
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const userJavaScriptOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    printWidth: 80,
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const markdownOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    jsdocBracketSpacing: false,
+    jsdocCapitalizeDescription: true,
+    jsdocCommentLineStrategy: "keep",
+    jsdocDescriptionTag: false,
+    jsdocDescriptionWithDot: false,
+    jsdocEmptyCommentStrategy: "keep",
+    jsdocKeepUnParseAbleExampleIndent: false,
+    jsdocLineWrappingStyle: "greedy",
+    jsdocPreferCodeFences: true,
+    jsdocPrintWidth: 80,
+    jsdocSeparateReturnsFromParam: true,
+    jsdocSeparateTagGroups: true,
+    jsdocSpaces: 1,
+    jsdocVerticalAlignment: false,
+    plugins: ["prettier-plugin-jsdoc"],
+    tabWidth: 1,
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const mdxOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    jsdocBracketSpacing: false,
+    jsdocCapitalizeDescription: true,
+    jsdocCommentLineStrategy: "keep",
+    jsdocDescriptionTag: false,
+    jsdocDescriptionWithDot: false,
+    jsdocEmptyCommentStrategy: "keep",
+    jsdocKeepUnParseAbleExampleIndent: false,
+    jsdocLineWrappingStyle: "greedy",
+    jsdocPreferCodeFences: true,
+    jsdocPrintWidth: 80,
+    jsdocSeparateReturnsFromParam: true,
+    jsdocSeparateTagGroups: true,
+    jsdocSpaces: 1,
+    jsdocVerticalAlignment: false,
+    plugins: ["prettier-plugin-jsdoc"],
+    printWidth: 100,
+    tabWidth: 2,
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const tomlOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    plugins: ["prettier-plugin-toml"],
+    printWidth: 120,
+    tabWidth: 4,
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const xmlOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    plugins: ["@prettier/plugin-xml"],
+    tabWidth: 2,
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const phpOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    phpVersion: "auto",
+    plugins: ["@prettier/plugin-php"],
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const sqlOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    language: "sqlite",
+    plugins: ["prettier-plugin-sql"],
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const powershellOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    plugins: ["prettier-plugin-powershell"],
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const codeownersOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    plugins: ["prettier-plugin-codeowners"],
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const shellOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    plugins: ["prettier-plugin-sh"],
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const propertiesOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    escapeNonLatin1: false,
+    plugins: ["prettier-plugin-properties"],
+    useTabs: false,
+});
+
+/** @type {Readonly<Partial<import("prettier").Config>>} */
+export const iniOverrideOptions = Object.freeze({
+    endOfLine: "lf",
+    iniSpaceAroundEquals: true,
+    plugins: ["prettier-plugin-ini"],
+    useTabs: false,
+});
+
 /**
  * Build a Prettier config with optional extensionless JSON and INI file
  * overrides.
@@ -62,6 +254,7 @@ export const createConfig = (options = {}) => {
     const {
         extensionlessIniFiles = [],
         extensionlessJsonFiles = [],
+        inheritedOverrides = [],
         replaceDefaultExtensionlessIniFiles = false,
         replaceDefaultExtensionlessJsonFiles = false,
     } = options;
@@ -81,6 +274,147 @@ export const createConfig = (options = {}) => {
         ),
     ];
 
+    /** @type {NonNullable<import("prettier").Config["overrides"]>} */
+    const baseOverrides = [
+        {
+            files: [
+                "*.js",
+                "*.jsx",
+                "*.ts",
+                "*.tsx",
+                "*.mjs",
+                "*.cjs",
+            ],
+            options: typescriptOverrideOptions,
+        },
+        {
+            files: "tsconfig.*",
+            options: jsonOverrideOptions,
+        },
+        {
+            files: "*.html",
+            options: htmlOverrideOptions,
+        },
+        {
+            files: "*.user.js",
+            options: userJavaScriptOverrideOptions,
+        },
+        {
+            files: "*.md",
+            options: markdownOverrideOptions,
+        },
+        {
+            files: "*.mdx",
+            options: mdxOverrideOptions,
+        },
+        {
+            files: "*.toml",
+            options: tomlOverrideOptions,
+        },
+        {
+            files: [
+                "*.xml",
+                "*.xsd",
+                "*.xsl",
+                "*.xaml",
+            ],
+            options: xmlOverrideOptions,
+        },
+        {
+            files: "*.php",
+            options: phpOverrideOptions,
+        },
+        {
+            files: mergedExtensionlessJsonFiles,
+            options: extensionlessJsonOptions,
+        },
+        {
+            excludeFiles: ["**/package.json", "**/package-lock.json"],
+            files: "*.json",
+            options: jsonOverrideOptions,
+        },
+        {
+            files: "*.sql",
+            options: sqlOverrideOptions,
+        },
+        {
+            files: [
+                "*.ps1",
+                "*.psm1",
+                "*.psd1",
+            ],
+            options: powershellOverrideOptions,
+        },
+        {
+            files: ["CODEOWNERS", "**/CODEOWNERS"],
+            options: codeownersOverrideOptions,
+        },
+        {
+            files: "*.sh",
+            options: shellOverrideOptions,
+        },
+        {
+            files: "*.properties",
+            options: propertiesOverrideOptions,
+        },
+        {
+            files: mergedExtensionlessIniFiles,
+            options: extensionlessIniOptions,
+        },
+        {
+            files: "*.ini",
+            options: iniOverrideOptions,
+        },
+        {
+            files: ["**/package.json", "**/package-lock.json"],
+            options: packageJsonOverrideOptions,
+        },
+    ];
+
+    /** @type {NonNullable<import("prettier").Config["overrides"]>} */
+    const inheritedOverridesExpanded = inheritedOverrides.map((override) => {
+        const inheritFromValues = Array.isArray(override.inheritFrom)
+            ? override.inheritFrom
+            : [override.inheritFrom];
+        const inheritedSourceOverride = baseOverrides.find((baseOverride) => {
+            const baseFiles = Array.isArray(baseOverride.files)
+                ? baseOverride.files
+                : [baseOverride.files];
+
+            return inheritFromValues.every((inheritFromValue) =>
+                baseFiles.includes(inheritFromValue)
+            );
+        });
+
+        if (inheritedSourceOverride === undefined) {
+            throw new Error(
+                `Unable to inherit override options: no base override found for ${JSON.stringify(override.inheritFrom)}.`
+            );
+        }
+
+        const normalizedExcludeFiles = Array.isArray(override.excludeFiles)
+            ? [...override.excludeFiles]
+            : override.excludeFiles;
+        const normalizedFiles = Array.isArray(override.files)
+            ? [...override.files]
+            : override.files;
+        const mergedOptions =
+            override.options === undefined
+                ? inheritedSourceOverride.options
+                : {
+                      ...inheritedSourceOverride.options,
+                      ...override.options,
+                  };
+
+        return {
+            files: normalizedFiles,
+            ...(normalizedExcludeFiles === undefined
+                ? {}
+                : { excludeFiles: normalizedExcludeFiles }),
+            ...(mergedOptions === undefined ? {} : { options: mergedOptions }),
+        };
+    });
+
     return {
         $schema: "https://www.schemastore.org/prettierrc.json",
         arrowParens: "always",
@@ -96,248 +430,7 @@ export const createConfig = (options = {}) => {
         insertPragma: false,
         jsxSingleQuote: false,
         objectWrap: "preserve",
-        overrides: [
-            {
-                files: [
-                    "*.js",
-                    "*.jsx",
-                    "*.ts",
-                    "*.tsx",
-                    "*.mjs",
-                    "*.cjs",
-                ],
-                options: {
-                    endOfLine: "lf",
-                    jsdocBracketSpacing: false,
-                    jsdocCapitalizeDescription: true,
-                    jsdocCommentLineStrategy: "keep",
-                    jsdocDescriptionTag: false,
-                    jsdocDescriptionWithDot: false,
-                    jsdocEmptyCommentStrategy: "keep",
-                    jsdocKeepUnParseAbleExampleIndent: false,
-                    jsdocLineWrappingStyle: "greedy",
-                    jsdocPreferCodeFences: true,
-                    jsdocPrintWidth: 80,
-                    jsdocSeparateReturnsFromParam: true,
-                    jsdocSeparateTagGroups: true,
-                    jsdocSpaces: 1,
-                    jsdocVerticalAlignment: false,
-                    multilineArraysWrapThreshold: 2,
-                    plugins: [
-                        "@softonus/prettier-plugin-duplicate-remover",
-                        "prettier-plugin-multiline-arrays",
-                        "prettier-plugin-jsdoc",
-                        "prettier-plugin-interpolated-html-tags",
-                        "prettier-plugin-merge",
-                    ],
-                    tsdoc: true,
-                    useTabs: false,
-                },
-            },
-            {
-                files: "tsconfig.*",
-                options: {
-                    endOfLine: "lf",
-                    jsonRecursiveSort: false,
-                    jsonSortOrder: '{"*": "numeric"}',
-                    multilineArraysWrapThreshold: 2,
-                    plugins: [
-                        "prettier-plugin-sort-json",
-                        "prettier-plugin-multiline-arrays",
-                    ],
-                    useTabs: false,
-                },
-            },
-            {
-                files: "*.html",
-                options: {
-                    htmlWhitespaceSensitivity: "strict",
-                    plugins: ["@softonus/prettier-plugin-duplicate-remover"],
-                    printWidth: 80,
-                    singleAttributePerLine: true,
-                    useTabs: false,
-                },
-            },
-            {
-                files: "*.user.js",
-                options: {
-                    endOfLine: "lf",
-                    printWidth: 80,
-                    useTabs: false,
-                },
-            },
-            {
-                files: "*.md",
-                options: {
-                    endOfLine: "lf",
-                    jsdocBracketSpacing: false,
-                    jsdocCapitalizeDescription: true,
-                    jsdocCommentLineStrategy: "keep",
-                    jsdocDescriptionTag: false,
-                    jsdocDescriptionWithDot: false,
-                    jsdocEmptyCommentStrategy: "keep",
-                    jsdocKeepUnParseAbleExampleIndent: false,
-                    jsdocLineWrappingStyle: "greedy",
-                    jsdocPreferCodeFences: true,
-                    jsdocPrintWidth: 80,
-                    jsdocSeparateReturnsFromParam: true,
-                    jsdocSeparateTagGroups: true,
-                    jsdocSpaces: 1,
-                    jsdocVerticalAlignment: false,
-                    plugins: ["prettier-plugin-jsdoc"],
-                    tabWidth: 1,
-                    useTabs: false,
-                },
-            },
-            {
-                files: "*.mdx",
-                options: {
-                    endOfLine: "lf",
-                    jsdocBracketSpacing: false,
-                    jsdocCapitalizeDescription: true,
-                    jsdocCommentLineStrategy: "keep",
-                    jsdocDescriptionTag: false,
-                    jsdocDescriptionWithDot: false,
-                    jsdocEmptyCommentStrategy: "keep",
-                    jsdocKeepUnParseAbleExampleIndent: false,
-                    jsdocLineWrappingStyle: "greedy",
-                    jsdocPreferCodeFences: true,
-                    jsdocPrintWidth: 80,
-                    jsdocSeparateReturnsFromParam: true,
-                    jsdocSeparateTagGroups: true,
-                    jsdocSpaces: 1,
-                    jsdocVerticalAlignment: false,
-                    plugins: ["prettier-plugin-jsdoc"],
-                    printWidth: 100,
-                    tabWidth: 2,
-                    useTabs: false,
-                },
-            },
-            {
-                files: "*.toml",
-                options: {
-                    endOfLine: "lf",
-                    plugins: ["prettier-plugin-toml"],
-                    printWidth: 120,
-                    tabWidth: 4,
-                    useTabs: false,
-                },
-            },
-            {
-                files: [
-                    "*.xml",
-                    "*.xsd",
-                    "*.xsl",
-                    "*.xaml",
-                ],
-                options: {
-                    endOfLine: "lf",
-                    plugins: ["@prettier/plugin-xml"],
-                    tabWidth: 2,
-                    useTabs: false,
-                },
-            },
-            {
-                files: "*.php",
-                options: {
-                    endOfLine: "lf",
-                    phpVersion: "auto",
-                    plugins: ["@prettier/plugin-php"],
-                    useTabs: false,
-                },
-            },
-            {
-                files: mergedExtensionlessJsonFiles,
-                options: extensionlessJsonOptions,
-            },
-            {
-                excludeFiles: ["**/package.json", "**/package-lock.json"],
-                files: "*.json",
-                options: {
-                    endOfLine: "lf",
-                    jsonRecursiveSort: false,
-                    jsonSortOrder: '{"*": "numeric"}',
-                    multilineArraysWrapThreshold: 2,
-                    plugins: [
-                        "prettier-plugin-sort-json",
-                        "prettier-plugin-multiline-arrays",
-                    ],
-                    useTabs: false,
-                },
-            },
-            {
-                files: "*.sql",
-                options: {
-                    endOfLine: "lf",
-                    language: "sqlite",
-                    plugins: ["prettier-plugin-sql"],
-                    useTabs: false,
-                },
-            },
-            {
-                files: [
-                    "*.ps1",
-                    "*.psm1",
-                    "*.psd1",
-                ],
-                options: {
-                    endOfLine: "lf",
-                    plugins: ["prettier-plugin-powershell"],
-                    useTabs: false,
-                },
-            },
-            {
-                files: ["CODEOWNERS", "**/CODEOWNERS"],
-                options: {
-                    endOfLine: "lf",
-                    plugins: ["prettier-plugin-codeowners"],
-                    useTabs: false,
-                },
-            },
-            {
-                files: "*.sh",
-                options: {
-                    endOfLine: "lf",
-                    plugins: ["prettier-plugin-sh"],
-                    useTabs: false,
-                },
-            },
-            {
-                files: "*.properties",
-                options: {
-                    endOfLine: "lf",
-                    escapeNonLatin1: false,
-                    plugins: ["prettier-plugin-properties"],
-                    useTabs: false,
-                },
-            },
-            {
-                files: mergedExtensionlessIniFiles,
-                options: extensionlessIniOptions,
-            },
-            {
-                files: "*.ini",
-                options: {
-                    endOfLine: "lf",
-                    iniSpaceAroundEquals: true,
-                    plugins: ["prettier-plugin-ini"],
-                    useTabs: false,
-                },
-            },
-            {
-                files: ["**/package.json", "**/package-lock.json"],
-                options: {
-                    endOfLine: "lf",
-                    multilineArraysWrapThreshold: 2,
-                    plugins: [
-                        "prettier-plugin-packagejson",
-                        "prettier-plugin-multiline-arrays",
-                    ],
-                    tabWidth: 4,
-                    useTabs: false,
-                },
-            },
-        ],
+        overrides: [...baseOverrides, ...inheritedOverridesExpanded],
         printWidth: 80,
         proseWrap: "preserve",
         quoteProps: "as-needed",