@sister.software/oxlint-config 9.0.0 → 9.1.0

package/out/headers-plugin.d.ts

@@ -6,50 +6,14 @@
  *   API). It reports files missing the `@copyright`/`@license`/`@author` header and autofixes them
  *   while preserving any other JSDoc tags already present in the leading comment block.
  */
-interface Comment {
-    type: string;
-    value: string;
-    range: [number, number];
-}
-interface SourceCode {
-    getText(): string;
-    getAllComments(): Comment[];
-}
-interface Fixer {
-    insertTextBeforeRange(range: [number, number], text: string): unknown;
-    replaceTextRange(range: [number, number], text: string): unknown;
-}
-interface RuleContext {
-    options: unknown[];
-    sourceCode?: SourceCode;
-    getSourceCode?(): SourceCode;
-    report(descriptor: {
-        node: unknown;
-        message: string;
-        fix?(fixer: Fixer): unknown;
-    }): void;
-}
-interface Rule {
-    meta: {
-        name: string;
-        type: string;
-        fixable: "code";
-        schema: unknown[];
-    };
-    create(context: RuleContext): Record<string, (node: unknown) => void>;
-}
-interface Plugin {
-    meta: {
-        name: string;
-    };
-    rules: Record<string, Rule>;
-}
+import type { Plugin, Rule } from "./plugin-types.js";
 /** Options accepted by the header rule. */
 export interface HeaderRuleOptions {
     copyrightHolder?: string;
     spdxLicenseIdentifier?: string;
     author?: string;
 }
+export declare const headerRule: Rule;
 /** The Sister Software oxlint header plugin. Registers the `sister-software/require-file-header` rule. */
 declare const headerPlugin: Plugin;
 export default headerPlugin;

package/out/headers-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"headers-plugin.d.ts","sourceRoot":"","sources":["../src/headers-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,UAAU,OAAO;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvB;AAED,UAAU,UAAU;IACnB,OAAO,IAAI,MAAM,CAAA;IACjB,cAAc,IAAI,OAAO,EAAE,CAAA;CAC3B;AAED,UAAU,KAAK;IACd,qBAAqB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACrE,gBAAgB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAChE;AAED,UAAU,WAAW;IACpB,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,aAAa,CAAC,IAAI,UAAU,CAAA;IAC5B,MAAM,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CACzF;AAED,UAAU,IAAI;IACb,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAA;IACxE,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,CAAA;CACrE;AAED,UAAU,MAAM;IACf,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;CAC3B;AAID,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IACjC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAiFD,0GAA0G;AAC1G,QAAA,MAAM,YAAY,EAAE,MAGnB,CAAA;AAED,eAAe,YAAY,CAAA"}
+{"version":3,"file":"headers-plugin.d.ts","sourceRoot":"","sources":["../src/headers-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAW,MAAM,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAE9D,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IACjC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAeD,eAAO,MAAM,UAAU,EAAE,IAiExB,CAAA;AAED,0GAA0G;AAC1G,QAAA,MAAM,YAAY,EAAE,MAGnB,CAAA;AAED,eAAe,YAAY,CAAA"}

package/out/headers-plugin.js

@@ -17,7 +17,7 @@ function parseInnerLines(comment) {
         .map((line) => line.replace(/^\s*\*?\s?/, "").replace(/\s+$/, ""))
         .filter((line) => line.length > 0);
 }
-const rule = {
+export const headerRule = {
     meta: {
         name: "require-file-header",
         type: "layout",
@@ -79,7 +79,7 @@ const rule = {
 /** The Sister Software oxlint header plugin. Registers the `sister-software/require-file-header` rule. */
 const headerPlugin = {
     meta: { name: "sister-software" },
-    rules: { "require-file-header": rule },
+    rules: { "require-file-header": headerRule },
 };
 export default headerPlugin;
 //# sourceMappingURL=headers-plugin.js.map

package/out/headers-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"headers-plugin.js","sourceRoot":"","sources":["../src/headers-plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"headers-plugin.js","sourceRoot":"","sources":["../src/headers-plugin.ts"],"names":[],"mappings":"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"}

package/out/index.d.ts

@@ -21,6 +21,8 @@ export interface OxlintConfigOptions {
     react?: boolean;
     /** Enforce file headers via the bundled JS plugin (on by default). */
     headers?: boolean;
+    /** Require a blank line before `return`/block-like statements (on by default). */
+    padding?: boolean;
     /** Override the default ignore patterns. */
     ignorePatterns?: string[];
     /** Extra config deep-merged last; an escape hatch for per-repo tweaks. */
@@ -39,6 +41,7 @@ export declare const DefaultIgnorePatterns: string[];
  * ```
  *
  * @param options Configuration options.
+ *
  * @returns A complete oxlint config object (no `extends` required).
  */
 export declare function createOxlintConfig(options?: OxlintConfigOptions): OxlintConfig;

package/out/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,cAAc,mBAAmB,CAAA;AAEjC,4FAA4F;AAC5F,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAElD,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IACnC,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,YAAY,CAAA;CACxB;AAED,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,UAOjC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CA8DlF;AAED,eAAe,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,cAAc,mBAAmB,CAAA;AAEjC,4FAA4F;AAC5F,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAElD,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IACnC,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,YAAY,CAAA;CACxB;AAED,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,UAOjC,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAoElF;AAED,eAAe,kBAAkB,CAAA"}

package/out/index.js

@@ -26,10 +26,11 @@ export const DefaultIgnorePatterns = [
  * ```
  *
  * @param options Configuration options.
+ *
  * @returns A complete oxlint config object (no `extends` required).
  */
 export function createOxlintConfig(options = {}) {
-    const { packageNamespace = "@sister.software", copyrightHolder = "Sister Software", spdxLicenseIdentifier = "UNLICENSED", author = "Teffen Ellis, et al.", react = false, headers = true, ignorePatterns = DefaultIgnorePatterns, overrides = {}, } = options;
+    const { packageNamespace = "@sister.software", copyrightHolder = "Sister Software", spdxLicenseIdentifier = "UNLICENSED", author = "Teffen Ellis, et al.", react = false, headers = true, padding = true, ignorePatterns = DefaultIgnorePatterns, overrides = {}, } = options;
     const plugins = ["typescript", "unicorn", "oxc", ...(react ? ["react"] : [])];
     const rules = {
         // JavaScript
@@ -67,9 +68,13 @@ export function createOxlintConfig(options = {}) {
         // editor error. The rule is auto-fixable, so `oxlint --fix` keeps the friction low.
         rules["sister-software/require-file-header"] = ["error", { copyrightHolder, spdxLicenseIdentifier, author }];
     }
+    if (padding) {
+        // Warning severity: a stylistic nudge (auto-fixable), not a hard CI gate.
+        rules["sister-software/padding-lines"] = "warn";
+    }
     return {
         plugins,
-        ...(headers ? { jsPlugins: ["@sister.software/oxlint-config/headers-plugin"] } : {}),
+        ...(headers || padding ? { jsPlugins: ["@sister.software/oxlint-config/plugin"] } : {}),
         categories: { correctness: "error" },
         ignorePatterns,
         rules,

package/out/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,cAAc,mBAAmB,CAAA;AAyBjC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,QAAQ;IACR,SAAS;IACT,mBAAmB;IACnB,iBAAiB;IACjB,aAAa;IACb,qBAAqB;CACrB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA+B,EAAE;IACnE,MAAM,EACL,gBAAgB,GAAG,kBAAkB,EACrC,eAAe,GAAG,iBAAiB,EACnC,qBAAqB,GAAG,YAAY,EACpC,MAAM,GAAG,sBAAsB,EAC/B,KAAK,GAAG,KAAK,EACb,OAAO,GAAG,IAAI,EACd,cAAc,GAAG,qBAAqB,EACtC,SAAS,GAAG,EAAE,GACd,GAAG,OAAO,CAAA;IAEX,MAAM,OAAO,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAE7E,MAAM,KAAK,GAA4B;QACtC,aAAa;QACb,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC/C,cAAc,EAAE,MAAM;QACtB,kBAAkB,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;QACtC,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,KAAK;QACjB,gBAAgB,EAAE;YACjB,MAAM;YACN;gBACC,IAAI,EAAE,KAAK;gBACX,iBAAiB,EAAE,IAAI;gBACvB,YAAY,EAAE,KAAK;gBACnB,yBAAyB,EAAE,IAAI;gBAC/B,8BAA8B,EAAE,IAAI;gBACpC,uFAAuF;gBACvF,gFAAgF;gBAChF,iBAAiB,EAAE,MAAM;gBACzB,kBAAkB,EAAE,IAAI;aACxB;SACD;QAED,2EAA2E;QAC3E,2BAA2B,EAAE,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;QAChF,sBAAsB,EAAE,KAAK;QAC7B,+BAA+B,EAAE,KAAK;QACtC,4BAA4B,EAAE,KAAK;QACnC,2BAA2B,EAAE,KAAK;QAClC,kCAAkC,EAAE,KAAK;QACzC,4BAA4B,EAAE,KAAK;QACnC,+BAA+B,EAAE,KAAK;KACtC,CAAA;IAED,IAAI,OAAO,EAAE,CAAC;QACb,0FAA0F;QAC1F,oFAAoF;QACpF,KAAK,CAAC,qCAAqC,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,EAAE,CAAC,CAAA;IAC7G,CAAC;IAED,OAAO;QACN,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,+CAA+C,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,UAAU,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE;QACpC,cAAc;QACd,KAAK;QACL,SAAS,EAAE,sBAAsB,CAAC,gBAAgB,CAAC;QACnD,GAAG,SAAS;KACZ,CAAA;AACF,CAAC;AAED,eAAe,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,cAAc,mBAAmB,CAAA;AA2BjC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,QAAQ;IACR,SAAS;IACT,mBAAmB;IACnB,iBAAiB;IACjB,aAAa;IACb,qBAAqB;CACrB,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA+B,EAAE;IACnE,MAAM,EACL,gBAAgB,GAAG,kBAAkB,EACrC,eAAe,GAAG,iBAAiB,EACnC,qBAAqB,GAAG,YAAY,EACpC,MAAM,GAAG,sBAAsB,EAC/B,KAAK,GAAG,KAAK,EACb,OAAO,GAAG,IAAI,EACd,OAAO,GAAG,IAAI,EACd,cAAc,GAAG,qBAAqB,EACtC,SAAS,GAAG,EAAE,GACd,GAAG,OAAO,CAAA;IAEX,MAAM,OAAO,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAE7E,MAAM,KAAK,GAA4B;QACtC,aAAa;QACb,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC/C,cAAc,EAAE,MAAM;QACtB,kBAAkB,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;QACtC,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,KAAK;QACjB,gBAAgB,EAAE;YACjB,MAAM;YACN;gBACC,IAAI,EAAE,KAAK;gBACX,iBAAiB,EAAE,IAAI;gBACvB,YAAY,EAAE,KAAK;gBACnB,yBAAyB,EAAE,IAAI;gBAC/B,8BAA8B,EAAE,IAAI;gBACpC,uFAAuF;gBACvF,gFAAgF;gBAChF,iBAAiB,EAAE,MAAM;gBACzB,kBAAkB,EAAE,IAAI;aACxB;SACD;QAED,2EAA2E;QAC3E,2BAA2B,EAAE,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;QAChF,sBAAsB,EAAE,KAAK;QAC7B,+BAA+B,EAAE,KAAK;QACtC,4BAA4B,EAAE,KAAK;QACnC,2BAA2B,EAAE,KAAK;QAClC,kCAAkC,EAAE,KAAK;QACzC,4BAA4B,EAAE,KAAK;QACnC,+BAA+B,EAAE,KAAK;KACtC,CAAA;IAED,IAAI,OAAO,EAAE,CAAC;QACb,0FAA0F;QAC1F,oFAAoF;QACpF,KAAK,CAAC,qCAAqC,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,EAAE,CAAC,CAAA;IAC7G,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACb,0EAA0E;QAC1E,KAAK,CAAC,+BAA+B,CAAC,GAAG,MAAM,CAAA;IAChD,CAAC;IAED,OAAO;QACN,OAAO;QACP,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,uCAAuC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,UAAU,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE;QACpC,cAAc;QACd,KAAK;QACL,SAAS,EAAE,sBAAsB,CAAC,gBAAgB,CAAC;QACnD,GAAG,SAAS;KACZ,CAAA;AACF,CAAC;AAED,eAAe,kBAAkB,CAAA"}

package/out/padding-plugin.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file A padding-lines rule, authored as an oxlint JS plugin (ESLint v9-compatible API). It
+ *   requires a blank line before `return` and block-like statements (the equivalent of ESLint's
+ *   `padding-line-between-statements` with `{ blankLine: "always", prev: "*", next: "return" | "block-like" }`),
+ *   and autofixes by inserting the missing blank line (before any leading comments).
+ */
+import type { Rule } from "./plugin-types.js";
+export declare const paddingRule: Rule;
+export default paddingRule;
+//# sourceMappingURL=padding-plugin.d.ts.map

package/out/padding-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"padding-plugin.d.ts","sourceRoot":"","sources":["../src/padding-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAmBtD,eAAO,MAAM,WAAW,EAAE,IAiDzB,CAAA;AAED,eAAe,WAAW,CAAA"}

package/out/padding-plugin.js

@@ -0,0 +1,70 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file A padding-lines rule, authored as an oxlint JS plugin (ESLint v9-compatible API). It
+ *   requires a blank line before `return` and block-like statements (the equivalent of ESLint's
+ *   `padding-line-between-statements` with `{ blankLine: "always", prev: "*", next: "return" | "block-like" }`),
+ *   and autofixes by inserting the missing blank line (before any leading comments).
+ */
+/**
+ * Statement node types that require a preceding blank line: `return` plus all "block-like" statements (matching
+ * ESLint's `block-like` selector).
+ */
+const PADDED_STATEMENT_TYPES = [
+    "ReturnStatement",
+    "BlockStatement",
+    "IfStatement",
+    "ForStatement",
+    "ForInStatement",
+    "ForOfStatement",
+    "WhileStatement",
+    "DoWhileStatement",
+    "SwitchStatement",
+    "TryStatement",
+];
+export const paddingRule = {
+    meta: {
+        name: "padding-lines",
+        type: "layout",
+        fixable: "whitespace",
+        schema: [{ type: "object", additionalProperties: true }],
+    },
+    create(context) {
+        const sourceCode = context.sourceCode ?? context.getSourceCode();
+        const text = sourceCode.getText();
+        const comments = sourceCode.getAllComments();
+        function check(node) {
+            const parent = node.parent;
+            // Only statements that are direct members of a statement list (a block/program body).
+            // This naturally skips e.g. an `if` consequent block or switch-case bodies.
+            if (!parent || !Array.isArray(parent.body))
+                return;
+            const index = parent.body.indexOf(node);
+            if (index <= 0)
+                return; // first statement in the block — nothing to pad against.
+            const previous = parent.body[index - 1];
+            // A blank line should sit before the statement's own leading comments, so measure the gap
+            // up to the earliest comment between the previous statement and this one.
+            let start = node.range[0];
+            for (const comment of comments) {
+                if (comment.range[0] >= previous.range[1] && comment.range[1] <= node.range[0]) {
+                    start = Math.min(start, comment.range[0]);
+                }
+            }
+            const gap = text.slice(previous.range[1], start);
+            if ((gap.match(/\n/g) ?? []).length >= 2)
+                return; // already a blank line.
+            context.report({
+                node,
+                message: "Expected a blank line before this statement.",
+                fix(fixer) {
+                    return fixer.insertTextAfterRange([previous.range[1], previous.range[1]], "\n");
+                },
+            });
+        }
+        return Object.fromEntries(PADDED_STATEMENT_TYPES.map((type) => [type, check]));
+    },
+};
+export default paddingRule;
+//# sourceMappingURL=padding-plugin.js.map

package/out/padding-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"padding-plugin.js","sourceRoot":"","sources":["../src/padding-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;GAGG;AACH,MAAM,sBAAsB,GAAG;IAC9B,iBAAiB;IACjB,gBAAgB;IAChB,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,kBAAkB;IAClB,iBAAiB;IACjB,cAAc;CACL,CAAA;AAEV,MAAM,CAAC,MAAM,WAAW,GAAS;IAChC,IAAI,EAAE;QACL,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;KACxD;IACD,MAAM,CAAC,OAAO;QACb,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,aAAc,EAAE,CAAA;QACjE,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,CAAA;QACjC,MAAM,QAAQ,GAAG,UAAU,CAAC,cAAc,EAAE,CAAA;QAE5C,SAAS,KAAK,CAAC,IAAa;YAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;YAE1B,sFAAsF;YACtF,4EAA4E;YAC5E,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;gBAAE,OAAM;YAElD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YAEvC,IAAI,KAAK,IAAI,CAAC;gBAAE,OAAM,CAAC,yDAAyD;YAChF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAE,CAAA;YAExC,0FAA0F;YAC1F,0EAA0E;YAC1E,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAEzB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAChC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChF,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC1C,CAAC;YACF,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;YAEhD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC;gBAAE,OAAM,CAAC,wBAAwB;YAEzE,OAAO,CAAC,MAAM,CAAC;gBACd,IAAI;gBACJ,OAAO,EAAE,8CAA8C;gBACvD,GAAG,CAAC,KAAK;oBACR,OAAO,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;gBAChF,CAAC;aACD,CAAC,CAAA;QACH,CAAC;QAED,OAAO,MAAM,CAAC,WAAW,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;IAC/E,CAAC;CACD,CAAA;AAED,eAAe,WAAW,CAAA"}

package/out/plugin-types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file Minimal ESLint-compatible plugin types shared by the bundled oxlint JS plugins. Kept local
+ *   to avoid coupling to oxlint's alpha internal type surface, which is not subject to semver.
+ */
+export interface Comment {
+    type: string;
+    value: string;
+    range: [number, number];
+}
+/** A loosely-typed AST node — only the fields the bundled rules read. */
+export interface AstNode {
+    type: string;
+    range: [number, number];
+    parent?: AstNode;
+    body?: AstNode[];
+}
+export interface SourceCode {
+    getText(): string;
+    getAllComments(): Comment[];
+}
+export interface Fixer {
+    insertTextBeforeRange(range: [number, number], text: string): unknown;
+    insertTextAfterRange(range: [number, number], text: string): unknown;
+    replaceTextRange(range: [number, number], text: string): unknown;
+}
+export interface RuleContext {
+    options: unknown[];
+    sourceCode?: SourceCode;
+    getSourceCode?(): SourceCode;
+    report(descriptor: {
+        node: unknown;
+        message: string;
+        fix?(fixer: Fixer): unknown;
+    }): void;
+}
+export interface Rule {
+    meta: {
+        name: string;
+        type: string;
+        fixable?: "code" | "whitespace";
+        schema: unknown[];
+    };
+    create(context: RuleContext): Record<string, (node: AstNode) => void>;
+}
+export interface Plugin {
+    meta: {
+        name: string;
+    };
+    rules: Record<string, Rule>;
+}
+//# sourceMappingURL=plugin-types.d.ts.map

package/out/plugin-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../src/plugin-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvB;AAED,yEAAyE;AACzE,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;CAChB;AAED,MAAM,WAAW,UAAU;IAC1B,OAAO,IAAI,MAAM,CAAA;IACjB,cAAc,IAAI,OAAO,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,KAAK;IACrB,qBAAqB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACrE,oBAAoB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACpE,gBAAgB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAChE;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,aAAa,CAAC,IAAI,UAAU,CAAA;IAC5B,MAAM,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CACzF;AAED,MAAM,WAAW,IAAI;IACpB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAA;IACxF,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,CAAA;CACrE;AAED,MAAM,WAAW,MAAM;IACtB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;CAC3B"}

package/out/plugin-types.js

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file Minimal ESLint-compatible plugin types shared by the bundled oxlint JS plugins. Kept local
+ *   to avoid coupling to oxlint's alpha internal type surface, which is not subject to semver.
+ */
+export {};
+//# sourceMappingURL=plugin-types.js.map

package/out/plugin-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.js","sourceRoot":"","sources":["../src/plugin-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/out/plugin.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file The bundled Sister Software oxlint JS plugin. A single plugin (oxlint requires unique plugin
+ *   names) exposing all of Sister Software's custom rules under the `sister-software/` namespace.
+ */
+import type { Plugin } from "./plugin-types.js";
+declare const sisterSoftwarePlugin: Plugin;
+export default sisterSoftwarePlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/out/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C,QAAA,MAAM,oBAAoB,EAAE,MAM3B,CAAA;AAED,eAAe,oBAAoB,CAAA"}

package/out/plugin.js

@@ -0,0 +1,18 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file The bundled Sister Software oxlint JS plugin. A single plugin (oxlint requires unique plugin
+ *   names) exposing all of Sister Software's custom rules under the `sister-software/` namespace.
+ */
+import { headerRule } from "./headers-plugin.js";
+import { paddingRule } from "./padding-plugin.js";
+const sisterSoftwarePlugin = {
+    meta: { name: "sister-software" },
+    rules: {
+        "require-file-header": headerRule,
+        "padding-lines": paddingRule,
+    },
+};
+export default sisterSoftwarePlugin;
+//# sourceMappingURL=plugin.js.map

package/out/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAGjD,MAAM,oBAAoB,GAAW;IACpC,IAAI,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE;IACjC,KAAK,EAAE;QACN,qBAAqB,EAAE,UAAU;QACjC,eAAe,EAAE,WAAW;KAC5B;CACD,CAAA;AAED,eAAe,oBAAoB,CAAA"}

package/out/restrictions.d.ts

@@ -23,6 +23,7 @@ export type RuntimeName = keyof RuntimePackageNamesRecord;
  * Given a package name, produces the glob matcher for files belonging to that package.
  *
  * @param packageName The final package-name segment, e.g. `client`.
+ *
  * @returns A single-element glob array, e.g. `["**\/client.{js,...}"]`.
  */
 export declare function createPackageFileMatcher(packageName: string): string[];
@@ -52,6 +53,7 @@ export interface OxlintOverride {
  * have no override of their own).
  *
  * @param packageNamespace The namespace whose packages are subject to the rules, e.g. `@sister.software`.
+ *
  * @returns An array of oxlint `overrides` entries.
  */
 export declare function createRuntimeOverrides(packageNamespace: string): OxlintOverride[];

package/out/restrictions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"restrictions.d.ts","sourceRoot":"","sources":["../src/restrictions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;CAK5B,CAAA;AAEV,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAA;AAExE,2BAA2B;AAC3B,MAAM,MAAM,WAAW,GAAG,MAAM,yBAAyB,CAAA;AAEzD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAEtE;AAiBD,kGAAkG;AAClG,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,cAAc,EAAE,CAK5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAErE;AA+ED,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AA6BD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,gBAAgB,EAAE,MAAM,GAAG,cAAc,EAAE,CAqDjF"}
+{"version":3,"file":"restrictions.d.ts","sourceRoot":"","sources":["../src/restrictions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;CAK5B,CAAA;AAEV,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAA;AAExE,2BAA2B;AAC3B,MAAM,MAAM,WAAW,GAAG,MAAM,yBAAyB,CAAA;AAEzD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAEtE;AAiBD,kGAAkG;AAClG,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,cAAc,EAAE,CAK5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAErE;AA+ED,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AA6BD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,gBAAgB,EAAE,MAAM,GAAG,cAAc,EAAE,CAqDjF"}

package/out/restrictions.js

@@ -22,6 +22,7 @@ export const RuntimePackageNamesRecord = {
  * Given a package name, produces the glob matcher for files belonging to that package.
  *
  * @param packageName The final package-name segment, e.g. `client`.
+ *
  * @returns A single-element glob array, e.g. `["**\/client.{js,...}"]`.
  */
 export function createPackageFileMatcher(packageName) {
@@ -140,6 +141,7 @@ function crossRuntimePatterns(packageNamespace, self, incompatible) {
  * have no override of their own).
  *
  * @param packageNamespace The namespace whose packages are subject to the rules, e.g. `@sister.software`.
+ *
  * @returns An array of oxlint `overrides` entries.
  */
 export function createRuntimeOverrides(packageNamespace) {

package/out/restrictions.js.map

@@ -1 +1 @@
-{"version":3,"file":"restrictions.js","sourceRoot":"","sources":["../src/restrictions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"restrictions.js","sourceRoot":"","sources":["../src/restrictions.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
  "name": "@sister.software/oxlint-config",
- "version": "9.0.0",
+ "version": "9.1.0",
  "description": "Sister Software's oxlint config",
  "license": "AGPL-3.0",
  "author": "teffen@sister.software",
@@ -21,6 +21,10 @@
   "./headers-plugin": {
    "import": "./out/headers-plugin.js",
    "types": "./out/headers-plugin.d.ts"
+  },
+  "./plugin": {
+   "import": "./out/plugin.js",
+   "types": "./out/plugin.d.ts"
   }
  },
  "publishConfig": {

package/src/headers-plugin.ts

@@ -7,43 +7,7 @@
  *   while preserving any other JSDoc tags already present in the leading comment block.
  */
 
-//#region Minimal ESLint-compatible plugin types (kept local to avoid coupling to oxlint's alpha
-// internal type surface, which is not subject to semver).
-
-interface Comment {
-	type: string
-	value: string
-	range: [number, number]
-}
-
-interface SourceCode {
-	getText(): string
-	getAllComments(): Comment[]
-}
-
-interface Fixer {
-	insertTextBeforeRange(range: [number, number], text: string): unknown
-	replaceTextRange(range: [number, number], text: string): unknown
-}
-
-interface RuleContext {
-	options: unknown[]
-	sourceCode?: SourceCode
-	getSourceCode?(): SourceCode
-	report(descriptor: { node: unknown; message: string; fix?(fixer: Fixer): unknown }): void
-}
-
-interface Rule {
-	meta: { name: string; type: string; fixable: "code"; schema: unknown[] }
-	create(context: RuleContext): Record<string, (node: unknown) => void>
-}
-
-interface Plugin {
-	meta: { name: string }
-	rules: Record<string, Rule>
-}
-
-//#endregion
+import type { Comment, Plugin, Rule } from "./plugin-types.js"
 
 /** Options accepted by the header rule. */
 export interface HeaderRuleOptions {
@@ -65,7 +29,7 @@ function parseInnerLines(comment: Comment): string[] {
 		.filter((line) => line.length > 0)
 }
 
-const rule: Rule = {
+export const headerRule: Rule = {
 	meta: {
 		name: "require-file-header",
 		type: "layout",
@@ -102,6 +66,7 @@ const rule: Rule = {
 				if (leading) {
 					const existing = parseInnerLines(leading)
 					const missing = headerLines.filter((line) => !existing.includes(line))
+
 					if (missing.length === 0) return
 
 					const preserved = existing.filter((line) => !HEADER_TAG_PATTERN.test(line))
@@ -134,7 +99,7 @@ const rule: Rule = {
 /** The Sister Software oxlint header plugin. Registers the `sister-software/require-file-header` rule. */
 const headerPlugin: Plugin = {
 	meta: { name: "sister-software" },
-	rules: { "require-file-header": rule },
+	rules: { "require-file-header": headerRule },
 }
 
 export default headerPlugin

package/src/index.ts

@@ -26,6 +26,8 @@ export interface OxlintConfigOptions {
 	react?: boolean
 	/** Enforce file headers via the bundled JS plugin (on by default). */
 	headers?: boolean
+	/** Require a blank line before `return`/block-like statements (on by default). */
+	padding?: boolean
 	/** Override the default ignore patterns. */
 	ignorePatterns?: string[]
 	/** Extra config deep-merged last; an escape hatch for per-repo tweaks. */
@@ -53,6 +55,7 @@ export const DefaultIgnorePatterns = [
  * ```
  *
  * @param options Configuration options.
+ *
  * @returns A complete oxlint config object (no `extends` required).
  */
 export function createOxlintConfig(options: OxlintConfigOptions = {}): OxlintConfig {
@@ -63,6 +66,7 @@ export function createOxlintConfig(options: OxlintConfigOptions = {}): OxlintCon
 		author = "Teffen Ellis, et al.",
 		react = false,
 		headers = true,
+		padding = true,
 		ignorePatterns = DefaultIgnorePatterns,
 		overrides = {},
 	} = options
@@ -108,9 +112,14 @@ export function createOxlintConfig(options: OxlintConfigOptions = {}): OxlintCon
 		rules["sister-software/require-file-header"] = ["error", { copyrightHolder, spdxLicenseIdentifier, author }]
 	}
 
+	if (padding) {
+		// Warning severity: a stylistic nudge (auto-fixable), not a hard CI gate.
+		rules["sister-software/padding-lines"] = "warn"
+	}
+
 	return {
 		plugins,
-		...(headers ? { jsPlugins: ["@sister.software/oxlint-config/headers-plugin"] } : {}),
+		...(headers || padding ? { jsPlugins: ["@sister.software/oxlint-config/plugin"] } : {}),
 		categories: { correctness: "error" },
 		ignorePatterns,
 		rules,

package/src/padding-plugin.ts

@@ -0,0 +1,81 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file A padding-lines rule, authored as an oxlint JS plugin (ESLint v9-compatible API). It
+ *   requires a blank line before `return` and block-like statements (the equivalent of ESLint's
+ *   `padding-line-between-statements` with `{ blankLine: "always", prev: "*", next: "return" | "block-like" }`),
+ *   and autofixes by inserting the missing blank line (before any leading comments).
+ */
+
+import type { AstNode, Rule } from "./plugin-types.js"
+
+/**
+ * Statement node types that require a preceding blank line: `return` plus all "block-like" statements (matching
+ * ESLint's `block-like` selector).
+ */
+const PADDED_STATEMENT_TYPES = [
+	"ReturnStatement",
+	"BlockStatement",
+	"IfStatement",
+	"ForStatement",
+	"ForInStatement",
+	"ForOfStatement",
+	"WhileStatement",
+	"DoWhileStatement",
+	"SwitchStatement",
+	"TryStatement",
+] as const
+
+export const paddingRule: Rule = {
+	meta: {
+		name: "padding-lines",
+		type: "layout",
+		fixable: "whitespace",
+		schema: [{ type: "object", additionalProperties: true }],
+	},
+	create(context) {
+		const sourceCode = context.sourceCode ?? context.getSourceCode!()
+		const text = sourceCode.getText()
+		const comments = sourceCode.getAllComments()
+
+		function check(node: AstNode) {
+			const parent = node.parent
+
+			// Only statements that are direct members of a statement list (a block/program body).
+			// This naturally skips e.g. an `if` consequent block or switch-case bodies.
+			if (!parent || !Array.isArray(parent.body)) return
+
+			const index = parent.body.indexOf(node)
+
+			if (index <= 0) return // first statement in the block — nothing to pad against.
+			const previous = parent.body[index - 1]!
+
+			// A blank line should sit before the statement's own leading comments, so measure the gap
+			// up to the earliest comment between the previous statement and this one.
+			let start = node.range[0]
+
+			for (const comment of comments) {
+				if (comment.range[0] >= previous.range[1] && comment.range[1] <= node.range[0]) {
+					start = Math.min(start, comment.range[0])
+				}
+			}
+
+			const gap = text.slice(previous.range[1], start)
+
+			if ((gap.match(/\n/g) ?? []).length >= 2) return // already a blank line.
+
+			context.report({
+				node,
+				message: "Expected a blank line before this statement.",
+				fix(fixer) {
+					return fixer.insertTextAfterRange([previous.range[1], previous.range[1]], "\n")
+				},
+			})
+		}
+
+		return Object.fromEntries(PADDED_STATEMENT_TYPES.map((type) => [type, check]))
+	},
+}
+
+export default paddingRule

package/src/plugin-types.ts

@@ -0,0 +1,49 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file Minimal ESLint-compatible plugin types shared by the bundled oxlint JS plugins. Kept local
+ *   to avoid coupling to oxlint's alpha internal type surface, which is not subject to semver.
+ */
+
+export interface Comment {
+	type: string
+	value: string
+	range: [number, number]
+}
+
+/** A loosely-typed AST node — only the fields the bundled rules read. */
+export interface AstNode {
+	type: string
+	range: [number, number]
+	parent?: AstNode
+	body?: AstNode[]
+}
+
+export interface SourceCode {
+	getText(): string
+	getAllComments(): Comment[]
+}
+
+export interface Fixer {
+	insertTextBeforeRange(range: [number, number], text: string): unknown
+	insertTextAfterRange(range: [number, number], text: string): unknown
+	replaceTextRange(range: [number, number], text: string): unknown
+}
+
+export interface RuleContext {
+	options: unknown[]
+	sourceCode?: SourceCode
+	getSourceCode?(): SourceCode
+	report(descriptor: { node: unknown; message: string; fix?(fixer: Fixer): unknown }): void
+}
+
+export interface Rule {
+	meta: { name: string; type: string; fixable?: "code" | "whitespace"; schema: unknown[] }
+	create(context: RuleContext): Record<string, (node: AstNode) => void>
+}
+
+export interface Plugin {
+	meta: { name: string }
+	rules: Record<string, Rule>
+}

package/src/plugin.ts

@@ -0,0 +1,21 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file The bundled Sister Software oxlint JS plugin. A single plugin (oxlint requires unique plugin
+ *   names) exposing all of Sister Software's custom rules under the `sister-software/` namespace.
+ */
+
+import { headerRule } from "./headers-plugin.js"
+import { paddingRule } from "./padding-plugin.js"
+import type { Plugin } from "./plugin-types.js"
+
+const sisterSoftwarePlugin: Plugin = {
+	meta: { name: "sister-software" },
+	rules: {
+		"require-file-header": headerRule,
+		"padding-lines": paddingRule,
+	},
+}
+
+export default sisterSoftwarePlugin

package/src/restrictions.ts

@@ -31,6 +31,7 @@ export type RuntimeName = keyof RuntimePackageNamesRecord
  * Given a package name, produces the glob matcher for files belonging to that package.
  *
  * @param packageName The final package-name segment, e.g. `client`.
+ *
  * @returns A single-element glob array, e.g. `["**\/client.{js,...}"]`.
  */
 export function createPackageFileMatcher(packageName: string): string[] {
@@ -193,6 +194,7 @@ function crossRuntimePatterns(
  * have no override of their own).
  *
  * @param packageNamespace The namespace whose packages are subject to the rules, e.g. `@sister.software`.
+ *
  * @returns An array of oxlint `overrides` entries.
  */
 export function createRuntimeOverrides(packageNamespace: string): OxlintOverride[] {