@peerigon/configs 14.0.7 → 14.1.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [14.1.0](https://github.com/peerigon/configs/compare/v14.0.8...v14.1.0) (2026-02-13)
+
+### Features
+
+- Add file and class structure to coding style guidelines ([265c438](https://github.com/peerigon/configs/commit/265c4383d95cd4748d9c94fd6266cf3b3b54cad7))
+
+## [14.0.8](https://github.com/peerigon/configs/compare/v14.0.7...v14.0.8) (2026-02-12)
+
+### Bug Fixes
+
+- Do not try to publish unscoped packages on Github ([99c5846](https://github.com/peerigon/configs/commit/99c5846a7b130e6e8355781a82bc4f1cc1b4daca))
+- Remove [@ts-self-types](https://github.com/ts-self-types) annotation ([9590c6f](https://github.com/peerigon/configs/commit/9590c6f12a434f17eb9c71d9096a7698e83b0212))
+- Restore original jsr.json config ([7c3e1d5](https://github.com/peerigon/configs/commit/7c3e1d568b8f783ed8afad8d4894a64aa30a9f27))
+
 ## [14.0.7](https://github.com/peerigon/configs/compare/v14.0.6...v14.0.7) (2026-02-10)
 
 ### Bug Fixes

package/ai/coding-styleguide-js-ts.mdc

@@ -20,6 +20,15 @@ globs: **/*.js, **/*.ts, **/*.mjs, **/*.cjs, **/*.mts, **/*.cts
 - Avoid default imports and default exports
 - Avoid barrel files (index files that only re-export) unless its a package entry file
 
+## File structure
+
+- Begin with a `@file` overview JSDoc comment (**not** for test or config files)
+- Then imports
+- Then important top-level constants or variables
+- Then order by importance (in relation to the file purpose): the most important classes/functions of the file should be at the beginning
+- Unimportant helper functions and variables should be at the bottom of the file
+- Exception: when module execution requires a function to be defined before it is used, define it earlier
+
 ## Naming Conventions
 
 - `camelCase` for variables, functions, methods
@@ -63,6 +72,12 @@ globs: **/*.js, **/*.ts, **/*.mjs, **/*.cjs, **/*.mts, **/*.cts
 - Write pure functions when possible
 - Optimize function names for readability on the call side
 
+## Class structure
+
+- Constructor **must** be at the top of the class
+- Then properties: public first, then private; order by importance in relation to the class purpose
+- Then methods: public first, then private; order by importance in relation to the class purpose
+
 ## Types
 
 - Use strict mode
@@ -81,7 +96,6 @@ globs: **/*.js, **/*.ts, **/*.mjs, **/*.cjs, **/*.mts, **/*.cts
 ## Comments
 
 - Use JSDoc comments and its tags where appropriate
-- When generating new files, include a `@file` overview at the top of the file (**not** for test files or config files)
 
 ## Testing
 

package/dist/eslint/presets/javascript-browser.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./javascript-browser.d.ts"
 import eslintConfigPrettier from "eslint-config-prettier";
 import { base } from "../rules/base.js";
 import { browser } from "../rules/browser.js";

package/dist/eslint/presets/javascript-node.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./javascript-node.d.ts"
 import eslintConfigPrettier from "eslint-config-prettier";
 import { base } from "../rules/base.js";
 import { javascript } from "../rules/javascript.js";

package/dist/eslint/presets/typescript-node.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./typescript-node.d.ts"
 import eslintConfigPrettier from "eslint-config-prettier";
 import { base } from "../rules/base.js";
 import { javascript } from "../rules/javascript.js";

package/dist/eslint/presets/typescript-react.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./typescript-react.d.ts"
 import eslintConfigPrettier from "eslint-config-prettier";
 import { base } from "../rules/base.js";
 import { browser } from "../rules/browser.js";

package/dist/eslint/presets/typescript.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./typescript.d.ts"
 import eslintConfigPrettier from "eslint-config-prettier";
 import { base } from "../rules/base.js";
 import { javascript } from "../rules/javascript.js";

package/dist/eslint/rules/base.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./base.d.ts"
 import fs from "node:fs";
 import path from "node:path";
 import { includeIgnoreFile } from "@eslint/compat";

package/dist/eslint/rules/browser.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./browser.d.ts"
 import globals from "globals";
 /** @type {import("eslint").Linter.Config[]} */
 export const browser = [

package/dist/eslint/rules/javascript.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./javascript.d.ts"
 import js from "@eslint/js";
 import noOnlyTests from "eslint-plugin-no-only-tests";
 import unicornPlugin from "eslint-plugin-unicorn";

package/dist/eslint/rules/node.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./node.d.ts"
 import globals from "globals";
 /** @type {import("eslint").Linter.Config[]} */
 export const node = [

package/dist/eslint/rules/playwright.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./playwright.d.ts"
 import pluginPlaywright from "eslint-plugin-playwright";
 import { globPatterns } from "../lib/glob-patterns.js";
 const files = globPatterns.tests;

package/dist/eslint/rules/react.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./react.d.ts"
 import reactPlugin2 from "@eslint-react/eslint-plugin";
 import jsxA11yPlugin from "eslint-plugin-jsx-a11y";
 import reactPlugin from "eslint-plugin-react";

package/dist/eslint/rules/tanstack-query.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./tanstack-query.d.ts"
 import pluginQuery from "@tanstack/eslint-plugin-query";
 import { globPatterns } from "../lib/glob-patterns.js";
 const files = [

package/dist/eslint/rules/typescript.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./typescript.d.ts"
 import preferArrow from "eslint-plugin-prefer-arrow";
 import tsEslint from "typescript-eslint";
 import { globPatterns } from "../lib/glob-patterns.js";

package/dist/eslint/rules/vitest.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./vitest.d.ts"
 import vitestPlugin from "@vitest/eslint-plugin";
 import { globPatterns } from "../lib/glob-patterns.js";
 const files = globPatterns.tests;

package/dist/eslint/styles/jsx-no-literals.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./jsx-no-literals.d.ts"
 import { globPatterns } from "../lib/glob-patterns.js";
 /** @type {import("eslint").Linter.Config[]} */
 export const jsxNoLiterals = [

package/dist/eslint/styles/no-default-export.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./no-default-export.d.ts"
 import { globPatterns } from "../lib/glob-patterns.js";
 /** @type {import("eslint").Linter.Config[]} */
 export const noDefaultExport = [

package/dist/eslint/styles/no-null.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./no-null.d.ts"
 /** @type {import("eslint").Linter.Config[]} */
 export const noNull = [
     {

package/dist/eslint/styles/prefer-array-shorthand.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./prefer-array-shorthand.d.ts"
 /** @type {import("eslint").Linter.Config[]} */
 export const preferArrayShorthand = [
     {

package/dist/eslint/styles/prefer-interface.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./prefer-interface.d.ts"
 /** @type {import("eslint").Linter.Config[]} */
 export const preferInterface = [
     {

package/dist/prettier/base.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./base.d.ts"
 /**
  * ## Base config for Prettier.
  *

package/dist/semantic-release/base.js

@@ -1,3 +1,4 @@
+// @ts-self-types="./base.d.ts"
 /**
  * Generic semantic-release config shape for portable declaration output.
  *

package/dist/semantic-release/cross-publish.js

@@ -1,3 +1,6 @@
+// @ts-self-types="./cross-publish.d.ts"
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
 import { config as baseConfig } from "./base.js";
 /**
  * Generic semantic-release config shape for portable declaration output.
@@ -11,7 +14,10 @@ import { config as baseConfig } from "./base.js";
  * @param {{ github: boolean; jsr: boolean }} options?
  * @returns {SemanticReleaseConfig}
  */
-export function config({ github = false, jsr = false } = { github: true, jsr: true }) {
+export function config({ github = defaultGithub, jsr = false } = {
+    github: defaultGithub,
+    jsr: true,
+}) {
     /** @type {unknown[]} */
     const plugins = [];
     if (baseConfig.plugins) {
@@ -40,4 +46,20 @@ export function config({ github = false, jsr = false } = { github: true, jsr: tr
         plugins,
     };
 }
+const defaultGithub = (() => {
+    try {
+        const packageJsonPath = resolve(process.cwd(), "package.json");
+        const packageJsonContent = readFileSync(packageJsonPath, "utf8");
+        const packageJson = JSON.parse(packageJsonContent);
+        if (typeof packageJson !== "object" || packageJson === null) {
+            return false;
+        }
+        const typedPackageJson = /** @type {{ name?: unknown }} */ (packageJson);
+        const name = typedPackageJson.name;
+        return typeof name === "string" && name.startsWith("@");
+    }
+    catch {
+        return false;
+    }
+})();
 export default config();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peerigon/configs",
-  "version": "14.0.7",
+  "version": "14.1.0",
   "description": "Configs for ESLint, Prettier, TypeScript & friends",
   "keywords": [
     "eslint",