@antelopejs/tooling-configs 0.0.3 → 0.0.5

package/dist/oxc/fmt.mjs

@@ -1,4 +1,4 @@
-import { n as IGNORE_PATTERNS, t as AGENT_IGNORE_PATTERNS } from "../shared-DYvliWWW.mjs";
+import { n as IGNORE_PATTERNS, t as AGENT_IGNORE_PATTERNS } from "../shared-COc6SJpd.mjs";
 import { defineConfig } from "oxfmt";
 //#region src/oxc/fmt.ts
 /**

package/dist/oxc/lint.d.mts

@@ -53,15 +53,30 @@ interface AntelopePresetOptions {
   });
   /**
    * Import sorting through `eslint-plugin-perfectionist`, autofixed by
-   * `oxlint --fix`. Repositories that still let Biome organize imports must
-   * leave this off until they drop that assist, or the two tools fight.
+   * `oxlint --fix`.
+   *
+   * Off by default, because the sort moves value imports across side-effect
+   * imports and module evaluation order is load-bearing in an AntelopeJS
+   * module: `import "./components"` is what puts the decorated classes in the
+   * registry. Running it over the cms/dms repositories moved
+   * `import { CORE_SCHEMA_NAME } from ".../constants"` from before
+   * `import "./db"` to after `import "./routes"` -- in a file whose comment
+   * says the position is deliberate -- and broke the package at require time.
+   * Nothing in a typecheck or a build catches it.
+   *
+   * `sortSideEffects: false` is not enough: it keeps side-effect imports in
+   * place (verified across 1402 files, none moved) but lets everything else
+   * cross them. `partitionByNewLine`, which would fix that, is refused by
+   * perfectionist 5.11 -- it conflicts with both `newlinesBetween` and
+   * `newlinesInside`. Turn this back on when the rule can guarantee that no
+   * import crosses a side-effect import.
    *
    * The plugin is an optional peer dependency: it pulls ESLint and
-   * typescript-eslint in with it, which a repository that turns this off has no
+   * typescript-eslint in with it, which a repository leaving this off has no
    * reason to install. Add `eslint-plugin-perfectionist` alongside this package
-   * when leaving it on.
+   * when turning it on.
    *
-   * @default true
+   * @default false
    */
   importSorting?: boolean;
   /**
@@ -82,6 +97,40 @@ interface AntelopePresetOptions {
   typeAware?: boolean;
 }
 /** Every generic anti-slop rule, exported so this package can lint itself. */
+/**
+ * The anti-slop rules left off by default.
+ *
+ * Measured across the sixteen cms/dms repositories: these seven produced 3038
+ * of the 3429 anti-slop findings, and every sample we read was either the
+ * correct idiom or a design change well beyond a lint pass.
+ *
+ * - `require-safety-comment-for-type-assertion` (1283) is satisfied by writing
+ *   a comment, so at that volume it manufactures the noise it exists to fight.
+ *   Removing assertions is the goal; annotating them is not.
+ * - `no-unknown-parameters` (566) and `no-unknown-returns` (104) fire on catch
+ *   handlers, where `unknown` is the only correct type, and on the parsers
+ *   whose whole job is to take unknown in and hand typed values out.
+ * - `no-runtime-typeof` (460) assumes a validation layer above the check. In a
+ *   CMS reading Vault responses, WebSocket frames and user-defined rows, the
+ *   `typeof` *is* that layer.
+ * - `no-unsafe-dictionary-type` (442) is right in a business application and
+ *   wrong here: tables and columns defined at run time have no compile-time
+ *   schema, which is the product, not a typing gap.
+ * - `no-shape-in-symbol-names` (104) matches a substring in identifiers and
+ *   catches domain words such as `BlueGreenShape`.
+ * - `no-module-mocking` (79) is a test-architecture position, not cleanup.
+ * - `no-known-value-widening` (201) is the near miss. Of 174 sampled, 96 are
+ *   `return accumulator` where the object was filled in a loop from run-time
+ *   keys, so the open dictionary is the honest type and there is no evidence to
+ *   preserve; the rule reads them as stable consts because assigning a property
+ *   is not a write to the binding. The 53 real ones -- annotated object
+ *   literals that should use `satisfies` -- are worth fixing by hand, and are,
+ *   but not at the price of 96 suppressions. Narrowing the rule to literals
+ *   would make it worth turning back on.
+ *
+ * A repository that wants one back enables it in its own `rules` block.
+ */
+declare const ANTI_SLOP_RULES_OFF_BY_DEFAULT: readonly ["no-known-value-widening", "no-module-mocking", "no-runtime-typeof", "no-shape-in-symbol-names", "no-unknown-parameters", "no-unknown-returns", "no-unsafe-dictionary-type", "require-safety-comment-for-type-assertion"];
 declare const ANTI_SLOP_RULES: readonly ["no-chained-type-assertions", "no-conditional-empty-object-spread", "no-known-value-widening", "no-module-mocking", "no-object-parameters", "no-reflect-apply", "no-reflect-get", "no-runtime-typeof", "no-shape-in-symbol-names", "no-unknown-parameters", "no-unknown-returns", "no-unknown-type-aliases", "no-unsafe-dictionary-type", "no-widen-then-assert", "require-safety-comment-for-type-assertion"];
 /**
  * The anti-slop rules at one severity. Exported for this repository's own config:
@@ -118,6 +167,7 @@ declare function antelopePreset(options?: AntelopePresetOptions): {
         argsIgnorePattern: "^_";
         varsIgnorePattern: "^_";
         caughtErrorsIgnorePattern: "^_";
+        ignoreRestSiblings: true;
       }];
       "eslint/eqeqeq": ["error", "always", {
         null: "ignore";
@@ -145,9 +195,7 @@ declare function antelopePreset(options?: AntelopePresetOptions): {
       name: string;
       specifier: string;
     }[];
-    rules: {
-      [k: string]: Severity;
-    };
+    rules: Record<string, Severity>;
   } | {
     rules: {
       "eslint/max-params": [Severity, {
@@ -176,6 +224,7 @@ declare function antelopePreset(options?: AntelopePresetOptions): {
       "perfectionist/sort-imports": ["error", {
         type: "line-length";
         order: "asc";
+        sortSideEffects: boolean;
         internalPattern: string[];
         groups: string[][];
       }];
@@ -186,4 +235,4 @@ declare function antelopePreset(options?: AntelopePresetOptions): {
   };
 };
 //#endregion
-export { ANTELOPE_IGNORE_PATTERNS, ANTI_SLOP_RULES, AntelopePresetOptions, ComplexityThresholds, DEFAULT_COMPLEXITY_THRESHOLDS, antelopePreset, antiSlopRules };
+export { ANTELOPE_IGNORE_PATTERNS, ANTI_SLOP_RULES, ANTI_SLOP_RULES_OFF_BY_DEFAULT, AntelopePresetOptions, ComplexityThresholds, DEFAULT_COMPLEXITY_THRESHOLDS, antelopePreset, antiSlopRules };

package/dist/oxc/lint.mjs

@@ -1,4 +1,4 @@
-import { n as IGNORE_PATTERNS, t as AGENT_IGNORE_PATTERNS } from "../shared-DYvliWWW.mjs";
+import { n as IGNORE_PATTERNS, t as AGENT_IGNORE_PATTERNS } from "../shared-COc6SJpd.mjs";
 import { defineConfig } from "oxlint";
 //#region src/oxc/lint.ts
 /**
@@ -23,6 +23,49 @@ const DEFAULT_COMPLEXITY_THRESHOLDS = {
 	complexity: 20
 };
 /** Every generic anti-slop rule, exported so this package can lint itself. */
+/**
+* The anti-slop rules left off by default.
+*
+* Measured across the sixteen cms/dms repositories: these seven produced 3038
+* of the 3429 anti-slop findings, and every sample we read was either the
+* correct idiom or a design change well beyond a lint pass.
+*
+* - `require-safety-comment-for-type-assertion` (1283) is satisfied by writing
+*   a comment, so at that volume it manufactures the noise it exists to fight.
+*   Removing assertions is the goal; annotating them is not.
+* - `no-unknown-parameters` (566) and `no-unknown-returns` (104) fire on catch
+*   handlers, where `unknown` is the only correct type, and on the parsers
+*   whose whole job is to take unknown in and hand typed values out.
+* - `no-runtime-typeof` (460) assumes a validation layer above the check. In a
+*   CMS reading Vault responses, WebSocket frames and user-defined rows, the
+*   `typeof` *is* that layer.
+* - `no-unsafe-dictionary-type` (442) is right in a business application and
+*   wrong here: tables and columns defined at run time have no compile-time
+*   schema, which is the product, not a typing gap.
+* - `no-shape-in-symbol-names` (104) matches a substring in identifiers and
+*   catches domain words such as `BlueGreenShape`.
+* - `no-module-mocking` (79) is a test-architecture position, not cleanup.
+* - `no-known-value-widening` (201) is the near miss. Of 174 sampled, 96 are
+*   `return accumulator` where the object was filled in a loop from run-time
+*   keys, so the open dictionary is the honest type and there is no evidence to
+*   preserve; the rule reads them as stable consts because assigning a property
+*   is not a write to the binding. The 53 real ones -- annotated object
+*   literals that should use `satisfies` -- are worth fixing by hand, and are,
+*   but not at the price of 96 suppressions. Narrowing the rule to literals
+*   would make it worth turning back on.
+*
+* A repository that wants one back enables it in its own `rules` block.
+*/
+const ANTI_SLOP_RULES_OFF_BY_DEFAULT = [
+	"no-known-value-widening",
+	"no-module-mocking",
+	"no-runtime-typeof",
+	"no-shape-in-symbol-names",
+	"no-unknown-parameters",
+	"no-unknown-returns",
+	"no-unsafe-dictionary-type",
+	"require-safety-comment-for-type-assertion"
+];
 const ANTI_SLOP_RULES = [
 	"no-chained-type-assertions",
 	"no-conditional-empty-object-spread",
@@ -63,7 +106,8 @@ function basePreset(cycleSeverity) {
 			"eslint/no-unused-vars": ["error", {
 				argsIgnorePattern: "^_",
 				varsIgnorePattern: "^_",
-				caughtErrorsIgnorePattern: "^_"
+				caughtErrorsIgnorePattern: "^_",
+				ignoreRestSiblings: true
 			}],
 			"eslint/eqeqeq": [
 				"error",
@@ -84,7 +128,8 @@ function basePreset(cycleSeverity) {
 * so linting never waits on a build.
 */
 function antiSlopRules(severity) {
-	return Object.fromEntries(ANTI_SLOP_RULES.map((rule) => [`anti-slop/${rule}`, severity]));
+	const off = new Set(ANTI_SLOP_RULES_OFF_BY_DEFAULT);
+	return Object.fromEntries(ANTI_SLOP_RULES.map((rule) => [`anti-slop/${rule}`, off.has(rule) ? "off" : severity]));
 }
 function antiSlopPreset(severity) {
 	return defineConfig({
@@ -92,7 +137,7 @@ function antiSlopPreset(severity) {
 			name: "anti-slop",
 			specifier: "@antelopejs/tooling-configs/oxc/anti-slop"
 		}],
-		rules: Object.fromEntries(ANTI_SLOP_RULES.map((rule) => [`anti-slop/${rule}`, severity]))
+		rules: antiSlopRules(severity)
 	});
 }
 function complexityPreset(thresholds, severity) {
@@ -137,20 +182,17 @@ function importSortingPreset() {
 		rules: { "perfectionist/sort-imports": ["error", {
 			type: "line-length",
 			order: "asc",
+			sortSideEffects: false,
 			internalPattern: ["^@/.*", "^~/.*"],
-			groups: [
-				["side-effect", "side-effect-style"],
-				["builtin", "external"],
-				[
-					"internal",
-					"subpath",
-					"parent",
-					"sibling",
-					"index",
-					"style",
-					"unknown"
-				]
-			]
+			groups: [["builtin", "external"], [
+				"internal",
+				"subpath",
+				"parent",
+				"sibling",
+				"index",
+				"style",
+				"unknown"
+			]]
 		}] }
 	});
 }
@@ -187,10 +229,10 @@ function antelopePreset(options = {}) {
 			options.typeAware === false ? null : typeAwarePreset(),
 			antiSlopSeverity === "off" ? null : antiSlopPreset(antiSlopSeverity),
 			complexitySeverity === "off" ? null : complexityPreset(complexityThresholds, complexitySeverity),
-			options.importSorting === false ? null : importSortingPreset()
+			options.importSorting === true ? importSortingPreset() : null
 		].filter((config) => config !== null),
 		rules: { "typescript/no-floating-promises": options.typeAware === false ? "off" : "error" }
 	});
 }
 //#endregion
-export { ANTELOPE_IGNORE_PATTERNS, ANTI_SLOP_RULES, DEFAULT_COMPLEXITY_THRESHOLDS, antelopePreset, antiSlopRules };
+export { ANTELOPE_IGNORE_PATTERNS, ANTI_SLOP_RULES, ANTI_SLOP_RULES_OFF_BY_DEFAULT, DEFAULT_COMPLEXITY_THRESHOLDS, antelopePreset, antiSlopRules };

package/dist/{shared-DYvliWWW.mjs → shared-COc6SJpd.mjs}

@@ -10,7 +10,8 @@ const IGNORE_PATTERNS = [
 	"**/.output/**",
 	"**/output/**",
 	"**/generated-layers.json",
-	"**/i18n-registry.generated.ts"
+	"**/i18n-registry.generated.ts",
+	".github/ISSUE_TEMPLATE/**"
 ];
 /** Agent tooling directories: assets we install, not source we own. */
 const AGENT_IGNORE_PATTERNS = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/tooling-configs",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Shared tooling presets for AntelopeJS projects: oxlint (incl. vendored anti-slop) and Knip",
   "keywords": [
     "antelopejs",