@antelopejs/tooling-configs 0.0.2 → 0.0.4

package/dist/eslint.mjs

@@ -16,6 +16,7 @@ const ANTELOPE_NUXT_RULES = {
 	"vue/require-default-prop": "off",
 	"@typescript-eslint/no-explicit-any": "off",
 	"@typescript-eslint/no-empty-object-type": "off",
+	"@typescript-eslint/unified-signatures": "off",
 	"@typescript-eslint/no-unused-vars": ["error", {
 		argsIgnorePattern: "^_",
 		varsIgnorePattern: "^_",

package/dist/knip.mjs

@@ -12,17 +12,26 @@ const DEFAULT_IGNORE = [
 	".antelope/**"
 ];
 /**
-* Every layer's CI runs `cd nuxt-layer && pnpm typecheck`. Knip parses the
-* workflow, sees a binary it cannot resolve, and reports it: the script lives in
-* the layer's own package.json, outside the analysed project.
+* `typecheck` is a script in the Nuxt layer's own manifest, outside the analysed
+* project, and every layer's CI runs it.
+*
+* The AntelopeJS CLIs are deliberately absent: a repository that invokes `ajs`
+* or `acms` declares the package providing it, so Knip resolves them and an
+* ignore would only hide a missing dependency.
 */
 const DEFAULT_IGNORE_BINARIES = ["typecheck"];
+/**
+* The AntelopeJS runtime loads modules by name, from the antelope config rather
+* than through an import, so nothing in the source points at them and Knip reads
+* every one as dead weight.
+*/
+const DEFAULT_IGNORE_DEPENDENCIES = ["@antelopejs/.*"];
 function antelopeKnipConfig(options = {}) {
 	return {
 		entry: [...DEFAULT_ENTRY, ...options.entry ?? []],
 		project: [...DEFAULT_PROJECT, ...options.project ?? []],
 		ignore: [...DEFAULT_IGNORE, ...options.ignore ?? []],
-		ignoreDependencies: options.ignoreDependencies ?? [],
+		ignoreDependencies: [...DEFAULT_IGNORE_DEPENDENCIES, ...options.ignoreDependencies ?? []],
 		ignoreBinaries: [...DEFAULT_IGNORE_BINARIES, ...options.ignoreBinaries ?? []]
 	};
 }

package/dist/oxc/lint.d.mts

@@ -82,6 +82,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,7 +152,13 @@ declare function antelopePreset(options?: AntelopePresetOptions): {
         argsIgnorePattern: "^_";
         varsIgnorePattern: "^_";
         caughtErrorsIgnorePattern: "^_";
+        ignoreRestSiblings: true;
+      }];
+      "eslint/eqeqeq": ["error", "always", {
+        null: "ignore";
       }];
+      "eslint/radix": "error";
+      "eslint/prefer-regex-literals": "error";
       "import/no-cycle": Severity;
       "import/no-self-import": "error";
       "import/no-duplicates": "error";
@@ -130,6 +170,7 @@ declare function antelopePreset(options?: AntelopePresetOptions): {
       "typescript/unbound-method": "warn";
       "typescript/no-meaningless-void-operator": "warn";
       "typescript/no-misused-spread": "warn";
+      "typescript/no-base-to-string": "warn";
       "typescript/no-redundant-type-constituents": "warn";
       "typescript/restrict-template-expressions": "warn";
       "typescript/require-array-sort-compare": "warn";
@@ -139,9 +180,7 @@ declare function antelopePreset(options?: AntelopePresetOptions): {
       name: string;
       specifier: string;
     }[];
-    rules: {
-      [k: string]: Severity;
-    };
+    rules: Record<string, Severity>;
   } | {
     rules: {
       "eslint/max-params": [Severity, {
@@ -170,6 +209,7 @@ declare function antelopePreset(options?: AntelopePresetOptions): {
       "perfectionist/sort-imports": ["error", {
         type: "line-length";
         order: "asc";
+        sortSideEffects: boolean;
         internalPattern: string[];
         groups: string[][];
       }];
@@ -180,4 +220,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

@@ -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,8 +106,16 @@ function basePreset(cycleSeverity) {
 			"eslint/no-unused-vars": ["error", {
 				argsIgnorePattern: "^_",
 				varsIgnorePattern: "^_",
-				caughtErrorsIgnorePattern: "^_"
+				caughtErrorsIgnorePattern: "^_",
+				ignoreRestSiblings: true
 			}],
+			"eslint/eqeqeq": [
+				"error",
+				"always",
+				{ null: "ignore" }
+			],
+			"eslint/radix": "error",
+			"eslint/prefer-regex-literals": "error",
 			"import/no-cycle": cycleSeverity,
 			"import/no-self-import": "error",
 			"import/no-duplicates": "error"
@@ -77,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({
@@ -85,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) {
@@ -118,6 +170,7 @@ function typeAwarePreset() {
 		"typescript/unbound-method": "warn",
 		"typescript/no-meaningless-void-operator": "warn",
 		"typescript/no-misused-spread": "warn",
+		"typescript/no-base-to-string": "warn",
 		"typescript/no-redundant-type-constituents": "warn",
 		"typescript/restrict-template-expressions": "warn",
 		"typescript/require-array-sort-compare": "warn"
@@ -129,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"
+			]]
 		}] }
 	});
 }
@@ -185,4 +235,4 @@ function antelopePreset(options = {}) {
 	});
 }
 //#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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/tooling-configs",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Shared tooling presets for AntelopeJS projects: oxlint (incl. vendored anti-slop) and Knip",
   "keywords": [
     "antelopejs",
@@ -26,7 +26,8 @@
     "./eslint": "./dist/eslint.mjs"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "scripts": {
     "build": "tsdown",