@configg/bases 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Crutches&Bicycles
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,78 @@
+# configg ⚙️
+
+[![CI](https://github.com/crutchcrew/configg/actions/workflows/ci.yml/badge.svg)](https://github.com/crutchcrew/configg/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@configg/bases)](https://www.npmjs.com/package/@configg/bases)
+[![provenance](https://img.shields.io/badge/provenance-verified-brightgreen)](https://www.npmjs.com/package/@configg/bases)
+[![license](https://img.shields.io/github/license/crutchcrew/configg)](./LICENSE)
+
+Shared configuration presets for code tooling. One package per tool, or all of them in a single install.
+
+The presets ship as TypeScript and JSON source. There is no build step, so use them from a runtime or tool that can load `.ts` files from `node_modules` (Bun, or the tool's own loader).
+
+## Packages
+
+| Package                                    | Version                                                                                                   | What it configures                                          |
+| ------------------------------------------ | --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
+| [`@configg/oxc`](./packages/oxc)           | [![npm](https://img.shields.io/npm/v/@configg/oxc)](https://www.npmjs.com/package/@configg/oxc)           | `oxfmt` (`/fmt`) and `oxlint` (`/lint`) presets             |
+| [`@configg/tsconfig`](./packages/tsconfig) | [![npm](https://img.shields.io/npm/v/@configg/tsconfig)](https://www.npmjs.com/package/@configg/tsconfig) | Strictest `tsconfig` presets for Bun and Vite               |
+| `@configg/bases` (this repo's root)        | [![npm](https://img.shields.io/npm/v/@configg/bases)](https://www.npmjs.com/package/@configg/bases)       | All of the above under one name, straight from `packages/*` |
+
+Install only what you use, or install `@configg/bases` and import everything from it:
+
+| `@configg/bases/…`           | Same as                               |
+| ---------------------------- | ------------------------------------- |
+| `oxfmt`                      | `@configg/oxc/fmt`                    |
+| `oxlint`                     | `@configg/oxc/lint`                   |
+| `tsconfig/{bun,client,vite}` | `@configg/tsconfig/{bun,client,vite}` |
+
+## Usage
+
+Tools are `peerDependencies`: you install `oxfmt`, `oxlint` and `typescript` yourself and pin the versions you want. The packages only supply the presets.
+
+```sh
+bun add -d @configg/bases oxfmt oxlint oxlint-tsgolint typescript
+```
+
+```ts
+// oxfmt.config.ts
+import { defineConfig } from 'oxfmt'
+import { configs } from '@configg/bases/oxfmt'
+
+export default defineConfig(configs.client)
+```
+
+```ts
+// oxlint.config.ts
+import { defineConfig } from 'oxlint'
+import { configs } from '@configg/bases/oxlint'
+
+export default defineConfig(configs.client)
+```
+
+```jsonc
+// tsconfig.json
+{ "extends": "@configg/bases/tsconfig/client" }
+```
+
+Installing a single package works the same way, for example `@configg/oxc/fmt` and `@configg/oxc/lint`.
+
+### Presets
+
+- `oxfmt` exports `configs`: `client` (Tailwind class sorting, import grouping), `scripts` (shared base for tooling and config files) and `server` (shared base).
+- `oxlint` exports `configs`: `client` (browser env, React, and a `**/*.spec.{ts,tsx}` override with Vitest and Testing Library rules) and `scripts` (Node env).
+- `tsconfig/bun` (`strictest` + Bun), `tsconfig/vite` (`strictest` + Vite/React) and `tsconfig/client` (`vite` with ambient `types` cleared, so a package only picks up the `@types/*` it asks for).
+
+`eslint-plugin-testing-library` is only needed for `configs.client` in the oxlint preset.
+
+## Development
+
+The repo uses its own packages through the workspace, so there is nothing to build.
+
+```sh
+bun install
+bun run check      # fmt + lint (with type-check) + lockfile, in parallel
+```
+
+## License
+
+[MIT](./LICENSE)

package/package.json

@@ -0,0 +1,89 @@
+{
+	"name": "@configg/bases",
+	"version": "0.1.0",
+	"description": "All @configg presets in one package: oxc and tsconfig",
+	"keywords": [
+		"config",
+		"oxc",
+		"oxfmt",
+		"oxlint",
+		"tsconfig"
+	],
+	"homepage": "https://github.com/crutchcrew/configg#readme",
+	"bugs": {
+		"url": "https://github.com/crutchcrew/configg/issues"
+	},
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/crutchcrew/configg.git"
+	},
+	"workspaces": [
+		"packages/*"
+	],
+	"files": [
+		"packages/*/src/**"
+	],
+	"type": "module",
+	"sideEffects": false,
+	"exports": {
+		"./oxfmt": "./packages/oxc/src/fmt.ts",
+		"./oxlint": "./packages/oxc/src/lint.ts",
+		"./tsconfig/bun": "./packages/tsconfig/src/bun.json",
+		"./tsconfig/client": "./packages/tsconfig/src/client.json",
+		"./tsconfig/vite": "./packages/tsconfig/src/vite.json",
+		"./package.json": "./package.json"
+	},
+	"publishConfig": {
+		"access": "public",
+		"provenance": true
+	},
+	"scripts": {
+		"check": "bun run --parallel fmt:check lint lockfile:check",
+		"fmt": "oxfmt --write .",
+		"fmt:check": "oxfmt --check .",
+		"lint": "oxlint",
+		"lint:fix": "oxlint --fix",
+		"lockfile:check": "bun install --frozen-lockfile",
+		"prepare": "lefthook install",
+		"publish:packages": "bun scripts/publish.ts",
+		"version:check": "bun scripts/versions.ts check",
+		"version:set": "bun scripts/versions.ts set"
+	},
+	"dependencies": {
+		"@tsconfig/bases": "^1.0.28"
+	},
+	"devDependencies": {
+		"@configg/oxc": "workspace:*",
+		"@configg/tsconfig": "workspace:*",
+		"@types/bun": "^1.4.2",
+		"eslint-plugin-testing-library": "^7.16.2",
+		"lefthook": "^2.1.14",
+		"oxfmt": "^0.68.0",
+		"oxlint": "^1.83.0",
+		"oxlint-tsgolint": "^7.0.2002",
+		"typescript": "7"
+	},
+	"peerDependencies": {
+		"eslint-plugin-testing-library": "^7.16",
+		"oxfmt": ">=0.65.0",
+		"oxlint": "^1",
+		"oxlint-tsgolint": "^7",
+		"typescript": "^7"
+	},
+	"peerDependenciesMeta": {
+		"eslint-plugin-testing-library": {
+			"optional": true
+		},
+		"oxfmt": {
+			"optional": true
+		},
+		"oxlint": {
+			"optional": true
+		},
+		"oxlint-tsgolint": {
+			"optional": true
+		}
+	},
+	"packageManager": "bun@1.4.2"
+}

package/packages/oxc/src/fmt.ts

@@ -0,0 +1,46 @@
+import type { OxfmtConfig } from 'oxfmt'
+
+const base = {
+	arrowParens: 'always',
+	bracketSameLine: false,
+	bracketSpacing: true,
+	embeddedLanguageFormatting: 'auto',
+	endOfLine: 'lf',
+	experimentalOperatorPosition: 'end',
+	insertFinalNewline: true,
+	objectWrap: 'preserve',
+	printWidth: 100,
+	proseWrap: 'preserve',
+	quoteProps: 'as-needed',
+	semi: false,
+	singleAttributePerLine: false,
+	singleQuote: true,
+	sortPackageJson: true,
+	tabWidth: 2,
+	trailingComma: 'all',
+	useTabs: true,
+} satisfies OxfmtConfig
+
+export const configs = {
+	client: {
+		...base,
+		endOfLine: 'lf',
+		htmlWhitespaceSensitivity: 'css',
+		insertFinalNewline: true,
+		jsxSingleQuote: false,
+		sortImports: {
+			customGroups: [
+				{ elementNamePattern: ['react', 'react/**', 'react-*', 'react-*/**'], groupName: 'react' },
+				{ elementNamePattern: ['**/components/**', '**/components'], groupName: 'components' },
+				{ elementNamePattern: ['**/utils/**', '**/utils'], groupName: 'utils' },
+			],
+			groups: ['react', 'external', 'components', 'utils', ['parent', 'sibling', 'index']],
+		},
+		sortTailwindcss: {
+			attributes: ['class', 'className'],
+			functions: ['cx', 'createVariants'],
+		},
+	},
+	scripts: base,
+	server: base,
+} satisfies Record<string, OxfmtConfig>

package/packages/oxc/src/lint.ts

@@ -0,0 +1,137 @@
+import type { OxlintConfig } from 'oxlint'
+
+export const configs = {
+	client: {
+		categories: {
+			correctness: 'error',
+			nursery: 'warn',
+			pedantic: 'warn',
+			perf: 'error',
+			restriction: 'error',
+			style: 'warn',
+			suspicious: 'warn',
+		},
+		env: {
+			browser: true,
+			builtin: true,
+		},
+		options: {
+			typeAware: true,
+			typeCheck: true,
+		},
+		overrides: [
+			{
+				env: {
+					vitest: true,
+				},
+				files: ['**/*.spec.{ts,tsx}'],
+				jsPlugins: ['eslint-plugin-testing-library'],
+				plugins: ['eslint', 'oxc', 'react', 'typescript', 'unicorn', 'vitest'],
+				rules: {
+					'max-lines-per-function': 'off',
+					'no-async-await': 'off',
+					'no-restricted-imports': [
+						'error',
+						{
+							paths: [
+								{
+									importNames: ['fireEvent'],
+									message:
+										'Use `@testing-library/user-event` instead — it dispatches the full sequence of events a real user triggers, where `fireEvent` only dispatches a single DOM event.',
+									name: '@testing-library/react',
+								},
+							],
+						},
+					],
+					'testing-library/await-async-events': ['error', { eventModule: 'userEvent' }],
+					'testing-library/await-async-queries': 'error',
+					'testing-library/await-async-utils': 'error',
+					'testing-library/no-await-sync-events': ['error', { eventModules: ['fire-event'] }],
+					'testing-library/no-await-sync-queries': 'error',
+					'testing-library/no-container': 'error',
+					'testing-library/no-debugging-utils': 'warn',
+					'testing-library/no-dom-import': ['error', 'react'],
+					'testing-library/no-global-regexp-flag-in-query': 'error',
+					'testing-library/no-node-access': 'error',
+					'testing-library/no-promise-in-fire-event': 'error',
+					'testing-library/no-render-in-lifecycle': 'error',
+					'testing-library/no-unnecessary-act': 'error',
+					'testing-library/no-wait-for-multiple-assertions': 'error',
+					'testing-library/no-wait-for-side-effects': 'error',
+					'testing-library/no-wait-for-snapshot': 'error',
+					'testing-library/prefer-find-by': 'error',
+					'testing-library/prefer-presence-queries': 'error',
+					'testing-library/prefer-query-by-disappearance': 'error',
+					'testing-library/prefer-screen-queries': 'error',
+					'testing-library/render-result-naming-convention': 'error',
+					'vitest/no-importing-vitest-globals': 'off',
+					'vitest/no-standalone-expect': 'error',
+					'vitest/prefer-expect-assertions': 'off',
+					'vitest/require-test-timeout': 'off',
+					'vitest/require-top-level-describe': 'off',
+					'vitest/valid-title': 'off',
+				},
+			},
+			{
+				files: ['**/*.tsx'],
+				rules: {
+					'react/only-export-components': 'error',
+					'typescript/explicit-module-boundary-types': 'off',
+				},
+			},
+		],
+		plugins: ['eslint', 'oxc', 'react', 'typescript', 'unicorn'],
+		rules: {
+			'func-style': ['error', 'declaration'],
+			'no-magic-numbers': 'off',
+			'no-rest-spread-properties': 'off',
+			'no-ternary': 'off',
+			'no-undefined': 'off',
+			'no-use-before-define': 'off',
+			'one-var': 'off',
+			'oxc/no-optional-chaining': 'off',
+			'react/jsx-filename-extension': 'off',
+			'react/jsx-max-depth': 'off',
+			'react/jsx-no-literals': 'off',
+			'react/no-multi-comp': 'off',
+			'react/react-in-jsx-scope': 'off',
+			'sort-imports': 'off',
+			'sort-keys': 'off',
+			'sort-vars': 'off',
+			'typescript/consistent-type-imports': ['error', { fixStyle: 'inline-type-imports' }],
+			'typescript/explicit-function-return-type': 'off',
+			'typescript/no-import-type-side-effects': 'off',
+			'typescript/prefer-readonly-parameter-types': 'off',
+			'unicorn/no-null': 'off',
+			'vitest/consistent-test-filename': ['error', { pattern: '.*\\.spec\\.tsx?$' }],
+			'vitest/no-hooks': 'off',
+		},
+	},
+	scripts: {
+		categories: {
+			correctness: 'error',
+			nursery: 'warn',
+			pedantic: 'warn',
+			perf: 'error',
+			restriction: 'error',
+			style: 'warn',
+			suspicious: 'warn',
+		},
+		env: {
+			builtin: true,
+			node: true,
+		},
+		options: {
+			typeAware: true,
+			typeCheck: true,
+		},
+		rules: {
+			'func-style': ['error', 'declaration'],
+			'no-magic-numbers': 'off',
+			'no-rest-spread-properties': 'off',
+			'one-var': 'off',
+			'sort-imports': 'off',
+			'typescript/prefer-readonly-parameter-types': 'off',
+		},
+	},
+} as const satisfies Record<string, OxlintConfig>

package/packages/tsconfig/src/bun.json

@@ -0,0 +1,4 @@
+{
+	"$schema": "https://www.schemastore.org/tsconfig",
+	"extends": ["@tsconfig/bases/strictest", "@tsconfig/bases/bun"]
+}

package/packages/tsconfig/src/client.json

@@ -0,0 +1,7 @@
+{
+	"$schema": "https://www.schemastore.org/tsconfig",
+	"extends": ["./vite.json"],
+	"compilerOptions": {
+		"types": []
+	}
+}

package/packages/tsconfig/src/vite.json

@@ -0,0 +1,4 @@
+{
+	"$schema": "https://www.schemastore.org/tsconfig",
+	"extends": ["@tsconfig/bases/strictest", "@tsconfig/bases/vite-react"]
+}