@antelopejs/tooling-configs 0.0.1

package/dist/oxc/fmt.d.mts

@@ -0,0 +1,108 @@
+import { defineConfig } from "oxfmt";
+//#region src/oxc/fmt.d.ts
+type OxfmtOptions = Parameters<typeof defineConfig>[0];
+/**
+ * The house style. Every field is set explicitly, including the ones that match
+ * oxfmt's own defaults: repositories carry `.editorconfig` files that disagree
+ * with each other (five declare tabs, two declare spaces), and oxfmt falls back
+ * to `.editorconfig` for any field a config leaves unset. Stating all of them
+ * is what makes the style the same everywhere.
+ */
+declare const ANTELOPE_STYLE: {
+  readonly printWidth: 80;
+  readonly tabWidth: 2;
+  readonly useTabs: false;
+  readonly semi: true;
+  readonly singleQuote: false;
+  readonly trailingComma: "all";
+};
+interface AntelopeFmtOptions extends Partial<OxfmtOptions> {
+  /**
+   * Sort Tailwind classes, replacing `prettier-plugin-tailwindcss`. Pass the
+   * path to the stylesheet that declares the theme, as the Nuxt layers do.
+   */
+  tailwindStylesheet?: string;
+  /**
+   * Extra paths to leave alone. These are **added** to the shared ignores, not
+   * substituted for them: a repository adopting oxfmt in stages needs to park
+   * `nuxt-layer/**` for a while without also un-ignoring its own build output.
+   */
+  ignorePatterns?: string[];
+}
+/**
+ * The shared AntelopeJS oxfmt preset.
+ *
+ * Import order is deliberately absent: `perfectionist/sort-imports` owns it on
+ * the lint side, and two tools sorting the same imports differently would each
+ * undo the other's work on every save.
+ *
+ * @example
+ * ```ts
+ * // oxfmt.config.ts
+ * import { antelopeFmtPreset } from "@antelopejs/tooling-configs/oxc/fmt";
+ *
+ * export default antelopeFmtPreset();
+ * ```
+ */
+declare function antelopeFmtPreset(options?: AntelopeFmtOptions): {
+  ignorePatterns: string[];
+  arrowParens?: import("oxfmt").ArrowParensConfig | undefined;
+  bracketSameLine?: boolean | undefined;
+  bracketSpacing?: boolean | undefined;
+  embeddedLanguageFormatting?: import("oxfmt").EmbeddedLanguageFormattingConfig | undefined;
+  endOfLine?: import("oxfmt").EndOfLineConfig | undefined;
+  experimentalOperatorPosition?: import("oxfmt").OperatorPositionConfig | undefined;
+  htmlWhitespaceSensitivity?: import("oxfmt").HtmlWhitespaceSensitivityConfig | undefined;
+  insertFinalNewline?: boolean | undefined;
+  jsdoc?: import("oxfmt").JsdocUserConfig | undefined;
+  jsxSingleQuote?: boolean | undefined;
+  objectWrap?: import("oxfmt").ObjectWrapConfig | undefined;
+  overrides?: import("oxfmt").OxfmtOverrideConfig[] | undefined;
+  printWidth: number;
+  proseWrap?: import("oxfmt").ProseWrapConfig | undefined;
+  quoteProps?: import("oxfmt").QuotePropsConfig | undefined;
+  semi: boolean;
+  singleAttributePerLine?: boolean | undefined;
+  singleQuote: boolean;
+  sortImports?: import("oxfmt").SortImportsUserConfig | undefined;
+  sortPackageJson?: import("oxfmt").SortPackageJsonUserConfig | undefined;
+  sortTailwindcss?: import("oxfmt").SortTailwindcssUserConfig;
+  svelte?: import("oxfmt").SvelteUserConfig | undefined;
+  tabWidth: number;
+  trailingComma: import("oxfmt").TrailingCommaConfig;
+  useTabs: boolean;
+  vueIndentScriptAndStyle?: boolean | undefined;
+} | {
+  ignorePatterns: string[];
+  arrowParens?: import("oxfmt").ArrowParensConfig | undefined;
+  bracketSameLine?: boolean | undefined;
+  bracketSpacing?: boolean | undefined;
+  embeddedLanguageFormatting?: import("oxfmt").EmbeddedLanguageFormattingConfig | undefined;
+  endOfLine?: import("oxfmt").EndOfLineConfig | undefined;
+  experimentalOperatorPosition?: import("oxfmt").OperatorPositionConfig | undefined;
+  htmlWhitespaceSensitivity?: import("oxfmt").HtmlWhitespaceSensitivityConfig | undefined;
+  insertFinalNewline?: boolean | undefined;
+  jsdoc?: import("oxfmt").JsdocUserConfig | undefined;
+  jsxSingleQuote?: boolean | undefined;
+  objectWrap?: import("oxfmt").ObjectWrapConfig | undefined;
+  overrides?: import("oxfmt").OxfmtOverrideConfig[] | undefined;
+  printWidth: number;
+  proseWrap?: import("oxfmt").ProseWrapConfig | undefined;
+  quoteProps?: import("oxfmt").QuotePropsConfig | undefined;
+  semi: boolean;
+  singleAttributePerLine?: boolean | undefined;
+  singleQuote: boolean;
+  sortImports?: import("oxfmt").SortImportsUserConfig | undefined;
+  sortPackageJson?: import("oxfmt").SortPackageJsonUserConfig | undefined;
+  sortTailwindcss: {
+    stylesheet: string;
+    functions: string[];
+  } | import("oxfmt").SortTailwindcssUserConfig;
+  svelte?: import("oxfmt").SvelteUserConfig | undefined;
+  tabWidth: number;
+  trailingComma: import("oxfmt").TrailingCommaConfig;
+  useTabs: boolean;
+  vueIndentScriptAndStyle?: boolean | undefined;
+};
+//#endregion
+export { ANTELOPE_STYLE, AntelopeFmtOptions, antelopeFmtPreset };

package/dist/oxc/fmt.mjs

@@ -0,0 +1,52 @@
+import { n as IGNORE_PATTERNS, t as AGENT_IGNORE_PATTERNS } from "../shared-DYvliWWW.mjs";
+import { defineConfig } from "oxfmt";
+//#region src/oxc/fmt.ts
+/**
+* The house style. Every field is set explicitly, including the ones that match
+* oxfmt's own defaults: repositories carry `.editorconfig` files that disagree
+* with each other (five declare tabs, two declare spaces), and oxfmt falls back
+* to `.editorconfig` for any field a config leaves unset. Stating all of them
+* is what makes the style the same everywhere.
+*/
+const ANTELOPE_STYLE = {
+	printWidth: 80,
+	tabWidth: 2,
+	useTabs: false,
+	semi: true,
+	singleQuote: false,
+	trailingComma: "all"
+};
+/**
+* The shared AntelopeJS oxfmt preset.
+*
+* Import order is deliberately absent: `perfectionist/sort-imports` owns it on
+* the lint side, and two tools sorting the same imports differently would each
+* undo the other's work on every save.
+*
+* @example
+* ```ts
+* // oxfmt.config.ts
+* import { antelopeFmtPreset } from "@antelopejs/tooling-configs/oxc/fmt";
+*
+* export default antelopeFmtPreset();
+* ```
+*/
+function antelopeFmtPreset(options = {}) {
+	const { tailwindStylesheet, ignorePatterns = [], ...overrides } = options;
+	const tailwind = tailwindStylesheet === void 0 ? {} : { sortTailwindcss: {
+		stylesheet: tailwindStylesheet,
+		functions: ["clsx", "cn"]
+	} };
+	return defineConfig({
+		...ANTELOPE_STYLE,
+		...tailwind,
+		...overrides,
+		ignorePatterns: [
+			...IGNORE_PATTERNS,
+			...AGENT_IGNORE_PATTERNS,
+			...ignorePatterns
+		]
+	});
+}
+//#endregion
+export { ANTELOPE_STYLE, antelopeFmtPreset };

package/dist/oxc/lint.d.mts

@@ -0,0 +1,175 @@
+//#region src/oxc/lint.d.ts
+/**
+ * The paths the preset ignores. oxlint does not merge `ignorePatterns` across
+ * `extends`: a root config that declares its own **replaces** these, so spread
+ * them when a repository adds patterns of its own.
+ *
+ * @example
+ * ```ts
+ * export default defineConfig({
+ *   extends: [antelopePreset()],
+ *   ignorePatterns: [...ANTELOPE_IGNORE_PATTERNS, "playground/**"],
+ * });
+ * ```
+ */
+declare const ANTELOPE_IGNORE_PATTERNS: string[];
+type Severity = "off" | "warn" | "error";
+/**
+ * Thresholds for the complexity rules. The defaults are deliberately looser than
+ * oxlint's own (3 parameters, 50 lines per function): AntelopeJS handlers take a
+ * request context plus its dependencies, and interface files declare long types.
+ * They are meant to catch the outliers, not to redesign every signature.
+ */
+interface ComplexityThresholds {
+  /** `eslint/max-params` (oxlint default: 3). */
+  maxParams: number;
+  /** `eslint/max-lines-per-function` (oxlint default: 50). */
+  maxLinesPerFunction: number;
+  /** `eslint/max-lines` (oxlint default: 300). */
+  maxLines: number;
+  /** `eslint/max-depth` (oxlint default: 4). */
+  maxDepth: number;
+  /** `eslint/complexity`, cyclomatic (oxlint default: 20). */
+  complexity: number;
+}
+declare const DEFAULT_COMPLEXITY_THRESHOLDS: ComplexityThresholds;
+interface AntelopePresetOptions {
+  /**
+   * Vendored anti-slop rules, which reject low-evidence TypeScript (`unknown`
+   * parameters, unjustified `as` assertions, open dictionaries...).
+   * `true` maps to `"warn"`: a repository adopting them has findings to work
+   * through before the gate can be raised to `"error"`.
+   *
+   * @default "warn"
+   */
+  antiSlop?: boolean | Severity;
+  /**
+   * Complexity ceilings. Pass an object to override individual thresholds.
+   *
+   * @default "warn" with {@link DEFAULT_COMPLEXITY_THRESHOLDS}
+   */
+  complexity?: boolean | (Partial<ComplexityThresholds> & {
+    severity?: Severity;
+  });
+  /**
+   * 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.
+   *
+   * 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
+   * reason to install. Add `eslint-plugin-perfectionist` alongside this package
+   * when leaving it on.
+   *
+   * @default true
+   */
+  importSorting?: boolean;
+  /**
+   * Severity of `import/no-cycle`. A cycle only shows up at runtime, in a
+   * consumer's process, so it ships as an error — but a repository that already
+   * has cycles needs to see them without a red pipeline while it untangles them.
+   *
+   * @default "error"
+   */
+  importCycles?: boolean | Severity;
+  /**
+   * `typescript/no-floating-promises`, which needs type information. The
+   * consuming repository must also set `options.typeAware` in its own root
+   * config: oxlint only reads that field there, never from an extended preset.
+   *
+   * @default true
+   */
+  typeAware?: boolean;
+}
+/**
+ * The shared AntelopeJS oxlint preset: oxc's own defaults (the `correctness`
+ * category), plus import hygiene, complexity ceilings, import sorting, and the
+ * vendored anti-slop rules.
+ *
+ * @example
+ * ```ts
+ * // oxlint.config.ts
+ * import { defineConfig } from "oxlint";
+ * import { antelopePreset } from "@antelopejs/tooling-configs/oxc/lint";
+ *
+ * export default defineConfig({
+ *   extends: [antelopePreset()],
+ *   options: { typeAware: true },
+ * });
+ * ```
+ */
+declare function antelopePreset(options?: AntelopePresetOptions): {
+  extends: ({
+    categories: {
+      correctness: "error";
+    };
+    ignorePatterns: string[];
+    plugins: ("eslint" | "typescript" | "oxc" | "import" | "promise" | "node")[];
+    rules: {
+      "eslint/no-unused-vars": ["error", {
+        argsIgnorePattern: "^_";
+        varsIgnorePattern: "^_";
+        caughtErrorsIgnorePattern: "^_";
+      }];
+      "import/no-cycle": Severity;
+      "import/no-self-import": "error";
+      "import/no-duplicates": "error";
+    };
+  } | {
+    rules: {
+      "typescript/no-floating-promises": "error";
+      "typescript/await-thenable": "warn";
+      "typescript/unbound-method": "warn";
+      "typescript/no-meaningless-void-operator": "warn";
+      "typescript/no-misused-spread": "warn";
+      "typescript/no-redundant-type-constituents": "warn";
+      "typescript/restrict-template-expressions": "warn";
+      "typescript/require-array-sort-compare": "warn";
+    };
+  } | {
+    jsPlugins: {
+      name: string;
+      specifier: string;
+    }[];
+    rules: {
+      [k: string]: Severity;
+    };
+  } | {
+    rules: {
+      "eslint/max-params": [Severity, {
+        max: number;
+      }];
+      "eslint/max-lines-per-function": [Severity, {
+        max: number;
+        skipBlankLines: true;
+        skipComments: true;
+      }];
+      "eslint/max-lines": [Severity, {
+        max: number;
+        skipBlankLines: true;
+        skipComments: true;
+      }];
+      "eslint/max-depth": [Severity, {
+        max: number;
+      }];
+      "eslint/complexity": [Severity, {
+        max: number;
+      }];
+    };
+  } | {
+    jsPlugins: string[];
+    rules: {
+      "perfectionist/sort-imports": ["error", {
+        type: "line-length";
+        order: "asc";
+        internalPattern: string[];
+        groups: string[][];
+      }];
+    };
+  })[];
+  rules: {
+    "typescript/no-floating-promises": "off" | "error";
+  };
+};
+//#endregion
+export { ANTELOPE_IGNORE_PATTERNS, AntelopePresetOptions, ComplexityThresholds, DEFAULT_COMPLEXITY_THRESHOLDS, antelopePreset };

package/dist/oxc/lint.mjs

@@ -0,0 +1,179 @@
+import { n as IGNORE_PATTERNS, t as AGENT_IGNORE_PATTERNS } from "../shared-DYvliWWW.mjs";
+import { defineConfig } from "oxlint";
+//#region src/oxc/lint.ts
+/**
+* The paths the preset ignores. oxlint does not merge `ignorePatterns` across
+* `extends`: a root config that declares its own **replaces** these, so spread
+* them when a repository adds patterns of its own.
+*
+* @example
+* ```ts
+* export default defineConfig({
+*   extends: [antelopePreset()],
+*   ignorePatterns: [...ANTELOPE_IGNORE_PATTERNS, "playground/**"],
+* });
+* ```
+*/
+const ANTELOPE_IGNORE_PATTERNS = [...IGNORE_PATTERNS, ...AGENT_IGNORE_PATTERNS];
+const DEFAULT_COMPLEXITY_THRESHOLDS = {
+	maxParams: 5,
+	maxLinesPerFunction: 120,
+	maxLines: 500,
+	maxDepth: 4,
+	complexity: 20
+};
+const ANTI_SLOP_RULES = [
+	"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"
+];
+/** Shared empty override set, so the threshold spread is never conditional. */
+const EMPTY_THRESHOLDS = {};
+function severityOf(option, fallback) {
+	if (option === void 0 || option === true) return fallback;
+	if (option === false) return "off";
+	return option;
+}
+function basePreset(cycleSeverity) {
+	return defineConfig({
+		categories: { correctness: "error" },
+		ignorePatterns: ANTELOPE_IGNORE_PATTERNS,
+		plugins: [
+			"eslint",
+			"typescript",
+			"node",
+			"oxc",
+			"import",
+			"promise"
+		],
+		rules: {
+			"eslint/no-unused-vars": ["error", {
+				argsIgnorePattern: "^_",
+				varsIgnorePattern: "^_",
+				caughtErrorsIgnorePattern: "^_"
+			}],
+			"import/no-cycle": cycleSeverity,
+			"import/no-self-import": "error",
+			"import/no-duplicates": "error"
+		}
+	});
+}
+function antiSlopPreset(severity) {
+	return defineConfig({
+		jsPlugins: [{
+			name: "anti-slop",
+			specifier: "@antelopejs/tooling-configs/oxc/anti-slop"
+		}],
+		rules: Object.fromEntries(ANTI_SLOP_RULES.map((rule) => [`anti-slop/${rule}`, severity]))
+	});
+}
+function complexityPreset(thresholds, severity) {
+	return defineConfig({ rules: {
+		"eslint/max-params": [severity, { max: thresholds.maxParams }],
+		"eslint/max-lines-per-function": [severity, {
+			max: thresholds.maxLinesPerFunction,
+			skipBlankLines: true,
+			skipComments: true
+		}],
+		"eslint/max-lines": [severity, {
+			max: thresholds.maxLines,
+			skipBlankLines: true,
+			skipComments: true
+		}],
+		"eslint/max-depth": [severity, { max: thresholds.maxDepth }],
+		"eslint/complexity": [severity, { max: thresholds.complexity }]
+	} });
+}
+/**
+* Turning on type information enables a whole family of rules, not just the one
+* worth the setup. `no-floating-promises` catches a promise whose rejection is
+* lost, which is why type-aware linting is worth running at all; the rest report
+* until a repository has worked through them, like every other backlog here.
+*/
+function typeAwarePreset() {
+	return defineConfig({ rules: {
+		"typescript/no-floating-promises": "error",
+		"typescript/await-thenable": "warn",
+		"typescript/unbound-method": "warn",
+		"typescript/no-meaningless-void-operator": "warn",
+		"typescript/no-misused-spread": "warn",
+		"typescript/no-redundant-type-constituents": "warn",
+		"typescript/restrict-template-expressions": "warn",
+		"typescript/require-array-sort-compare": "warn"
+	} });
+}
+function importSortingPreset() {
+	return defineConfig({
+		jsPlugins: ["eslint-plugin-perfectionist"],
+		rules: { "perfectionist/sort-imports": ["error", {
+			type: "line-length",
+			order: "asc",
+			internalPattern: ["^@/.*", "^~/.*"],
+			groups: [
+				["side-effect", "side-effect-style"],
+				["builtin", "external"],
+				[
+					"internal",
+					"subpath",
+					"parent",
+					"sibling",
+					"index",
+					"style",
+					"unknown"
+				]
+			]
+		}] }
+	});
+}
+/**
+* The shared AntelopeJS oxlint preset: oxc's own defaults (the `correctness`
+* category), plus import hygiene, complexity ceilings, import sorting, and the
+* vendored anti-slop rules.
+*
+* @example
+* ```ts
+* // oxlint.config.ts
+* import { defineConfig } from "oxlint";
+* import { antelopePreset } from "@antelopejs/tooling-configs/oxc/lint";
+*
+* export default defineConfig({
+*   extends: [antelopePreset()],
+*   options: { typeAware: true },
+* });
+* ```
+*/
+function antelopePreset(options = {}) {
+	const complexity = options.complexity ?? true;
+	const isToggle = complexity === true || complexity === false;
+	const overrides = isToggle ? EMPTY_THRESHOLDS : complexity;
+	const complexityThresholds = {
+		...DEFAULT_COMPLEXITY_THRESHOLDS,
+		...overrides
+	};
+	const complexitySeverity = severityOf(isToggle ? complexity : overrides.severity ?? true, "warn");
+	const antiSlopSeverity = severityOf(options.antiSlop, "warn");
+	return defineConfig({
+		extends: [
+			basePreset(severityOf(options.importCycles, "error")),
+			options.typeAware === false ? null : typeAwarePreset(),
+			antiSlopSeverity === "off" ? null : antiSlopPreset(antiSlopSeverity),
+			complexitySeverity === "off" ? null : complexityPreset(complexityThresholds, complexitySeverity),
+			options.importSorting === false ? null : importSortingPreset()
+		].filter((config) => config !== null),
+		rules: { "typescript/no-floating-promises": options.typeAware === false ? "off" : "error" }
+	});
+}
+//#endregion
+export { ANTELOPE_IGNORE_PATTERNS, DEFAULT_COMPLEXITY_THRESHOLDS, antelopePreset };

package/dist/shared-DYvliWWW.mjs

@@ -0,0 +1,28 @@
+//#region src/oxc/shared.ts
+/** Paths every AntelopeJS project generates or vendors, and that no linter should read. */
+const IGNORE_PATTERNS = [
+	"**/node_modules/**",
+	"**/dist/**",
+	"**/build/**",
+	"**/coverage/**",
+	"**/.antelope/**",
+	"**/.nuxt/**",
+	"**/.output/**",
+	"**/output/**",
+	"**/generated-layers.json",
+	"**/i18n-registry.generated.ts"
+];
+/** Agent tooling directories: assets we install, not source we own. */
+const AGENT_IGNORE_PATTERNS = [
+	".agent/**",
+	".agents/**",
+	".amp/**",
+	".claude/**",
+	".codex/**",
+	".cursor/**",
+	".gemini/**",
+	".opencode/**",
+	".windsurf/**"
+];
+//#endregion
+export { IGNORE_PATTERNS as n, AGENT_IGNORE_PATTERNS as t };

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@antelopejs/tooling-configs",
+  "version": "0.0.1",
+  "description": "Shared tooling presets for AntelopeJS projects: oxlint (incl. vendored anti-slop) and Knip",
+  "keywords": [
+    "antelopejs",
+    "anti-slop",
+    "knip",
+    "oxc",
+    "oxlint"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AntelopeJS/tooling-configs.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    "./oxc/lint": "./dist/oxc/lint.mjs",
+    "./oxc/fmt": "./dist/oxc/fmt.mjs",
+    "./oxc/anti-slop": "./dist/oxc/anti-slop/index.mjs",
+    "./knip": "./dist/knip.mjs",
+    "./eslint": "./dist/eslint.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
+    "format": "oxfmt .",
+    "prepack": "pnpm run build",
+    "release": "pnpm run lint && pnpm run prepack && release-it",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test \"src/oxc/anti-slop/rules/*.test.ts\"",
+    "checks": "pnpm run typecheck && pnpm run lint && pnpm run format:check && pnpm run test",
+    "check:dist": "pnpm run build && git diff --exit-code dist",
+    "format:check": "oxfmt --check ."
+  },
+  "dependencies": {
+    "@oxlint/plugins": "1.81.0"
+  },
+  "devDependencies": {
+    "@nuxt/eslint-config": "^1.17.0",
+    "@types/node": "^24.13.3",
+    "eslint-plugin-perfectionist": "^5.11.0",
+    "oxfmt": "^0.66.0",
+    "oxlint": "1.81.0",
+    "release-it": "^19.2.4",
+    "release-it-changelogen": "^0.1.0",
+    "tsdown": "^0.22.14",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@nuxt/eslint-config": ">=1.2.0",
+    "eslint-plugin-perfectionist": ">=5.0.0",
+    "knip": ">=6.0.0",
+    "oxfmt": "^0.66.0",
+    "oxlint": "1.81.0"
+  },
+  "peerDependenciesMeta": {
+    "knip": {
+      "optional": true
+    },
+    "oxlint": {
+      "optional": true
+    },
+    "oxfmt": {
+      "optional": true
+    },
+    "@nuxt/eslint-config": {
+      "optional": true
+    },
+    "eslint-plugin-perfectionist": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "packageManager": "pnpm@10.2.0"
+}