@nextnode-solutions/standards 1.0.1

package/package.json

@@ -0,0 +1,100 @@
+{
+	"name": "@nextnode-solutions/standards",
+	"version": "1.0.1",
+	"description": "Centralized development standards for NextNode projects: oxlint, oxfmt, TypeScript, Tailwind, Vitest, commitlint",
+	"keywords": [
+		"commitlint",
+		"formatting",
+		"linting",
+		"nextnode",
+		"oxfmt",
+		"oxlint",
+		"standards"
+	],
+	"homepage": "https://github.com/NextNodeSolutions/standards#readme",
+	"bugs": {
+		"url": "https://github.com/NextNodeSolutions/standards/issues"
+	},
+	"license": "MIT",
+	"author": "NextNode Solutions",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/NextNodeSolutions/standards.git"
+	},
+	"files": [
+		"README.md",
+		"src"
+	],
+	"type": "module",
+	"exports": {
+		"./oxlint": "./src/oxlint/base.json",
+		"./oxfmt": "./src/oxfmt/base.json",
+		"./typescript/library": "./src/typescript/tsconfig.library.json",
+		"./typescript/nextjs": "./src/typescript/tsconfig.nextjs.json",
+		"./typescript/astro": "./src/typescript/tsconfig.astro.json",
+		"./tailwind": "./src/tailwind/preset.js",
+		"./vitest/frontend": {
+			"types": "./src/vitest/vitest.frontend.d.ts",
+			"default": "./src/vitest/vitest.frontend.js"
+		},
+		"./vitest/backend": {
+			"types": "./src/vitest/vitest.backend.d.ts",
+			"default": "./src/vitest/vitest.backend.js"
+		},
+		"./commitlint": "./src/commitlint/base.js",
+		"./lint-staged": "./src/lint-staged/base.js"
+	},
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	},
+	"scripts": {
+		"build": "echo 'No build step needed for config package'",
+		"format": "oxfmt --write .",
+		"format:check": "oxfmt --check .",
+		"lint": "oxlint",
+		"prepare": "husky",
+		"test": "echo 'Configuration package — no tests needed'"
+	},
+	"devDependencies": {
+		"@commitlint/cli": "^19.8.1",
+		"@commitlint/config-conventional": "^19.8.1",
+		"better-sort-package-json": "^1.1.1",
+		"husky": "^9.0.11",
+		"lint-staged": "^15.2.2",
+		"oxfmt": "^0.28.0",
+		"oxlint": "^1.43.0"
+	},
+	"peerDependencies": {
+		"@commitlint/cli": "^19.0.0",
+		"@commitlint/config-conventional": "^19.0.0",
+		"oxfmt": ">=0.7.0",
+		"oxlint": ">=0.16.0",
+		"tailwindcss": "^4.0.0",
+		"vitest": "^3.0.0 || ^4.0.0"
+	},
+	"peerDependenciesMeta": {
+		"@commitlint/cli": {
+			"optional": true
+		},
+		"@commitlint/config-conventional": {
+			"optional": true
+		},
+		"oxfmt": {
+			"optional": false
+		},
+		"oxlint": {
+			"optional": false
+		},
+		"tailwindcss": {
+			"optional": true
+		},
+		"vitest": {
+			"optional": true
+		}
+	},
+	"engines": {
+		"node": ">=24.0.0"
+	},
+	"packageManager": "pnpm@10.11.0"
+}

package/src/commitlint/base.js

@@ -0,0 +1,37 @@
+export default {
+	extends: ['@commitlint/config-conventional'],
+	rules: {
+		'type-enum': [
+			2,
+			'always',
+			[
+				'feat',
+				'fix',
+				'docs',
+				'style',
+				'refactor',
+				'perf',
+				'test',
+				'build',
+				'ci',
+				'chore',
+				'revert',
+			],
+		],
+		'type-case': [2, 'always', 'lower-case'],
+		'type-empty': [2, 'never'],
+		'scope-case': [2, 'always', 'lower-case'],
+		'subject-case': [
+			2,
+			'never',
+			['sentence-case', 'start-case', 'pascal-case', 'upper-case'],
+		],
+		'subject-empty': [2, 'never'],
+		'subject-full-stop': [2, 'never', '.'],
+		'header-max-length': [2, 'always', 100],
+		'body-leading-blank': [1, 'always'],
+		'body-max-line-length': [2, 'always', 100],
+		'footer-leading-blank': [1, 'always'],
+		'footer-max-line-length': [2, 'always', 100],
+	},
+}

package/src/lint-staged/base.js

@@ -0,0 +1,4 @@
+export default {
+	'package.json': ['better-sort-package-json'],
+	'*': ['oxlint', 'oxfmt --write'],
+}

package/src/oxfmt/base.json

@@ -0,0 +1,34 @@
+{
+	"useTabs": true,
+	"tabWidth": 4,
+	"endOfLine": "lf",
+	"printWidth": 80,
+	"trailingComma": "all",
+	"semi": false,
+	"arrowParens": "avoid",
+	"bracketSpacing": true,
+	"singleQuote": true,
+	"jsxSingleQuote": false,
+	"bracketSameLine": false,
+	"experimentalTailwindcss": {},
+	"experimentalSortImports": {
+		"groups": [
+			["side-effect"],
+			["builtin"],
+			["external", "type-external"],
+			["internal", "type-internal"],
+			["parent", "type-parent"],
+			["sibling", "type-sibling"],
+			["index", "type-index"]
+		],
+		"newlinesBetween": "always"
+	},
+	"overrides": [
+		{
+			"files": ["*.json"],
+			"options": {
+				"trailingComma": "none"
+			}
+		}
+	]
+}

package/src/oxlint/base.json

@@ -0,0 +1,70 @@
+{
+	"$schema": "https://raw.githubusercontent.com/oxc-project/oxc/main/npm/oxlint/configuration_schema.json",
+	"categories": {
+		"correctness": "error",
+		"suspicious": "warn",
+		"perf": "warn"
+	},
+	"plugins": ["typescript", "react", "unicorn", "import"],
+	"rules": {
+		"eslint/no-unused-vars": ["error", { "ignoreRestSiblings": true }],
+		"eslint/prefer-const": "error",
+		"eslint/no-var": "error",
+		"eslint/no-debugger": "error",
+		"eslint/no-console": "warn",
+		"eslint/eqeqeq": "error",
+		"eslint/prefer-template": "error",
+		"eslint/arrow-body-style": "error",
+		"eslint/complexity": ["error", { "max": 15 }],
+		"eslint/no-magic-numbers": [
+			"error",
+			{
+				"ignore": [0, 1, -1],
+				"ignoreEnums": true,
+				"ignoreReadonlyClassProperties": true
+			}
+		],
+		"typescript/no-explicit-any": "error",
+		"typescript/consistent-type-imports": [
+			"error",
+			{ "prefer": "type-imports", "fixStyle": "separate-type-imports" }
+		],
+		"typescript/no-dynamic-delete": "error",
+		"typescript/explicit-function-return-type": [
+			"error",
+			{
+				"allowExpressions": true,
+				"allowTypedFunctionExpressions": true,
+				"allowHigherOrderFunctions": true,
+				"allowDirectConstAssertionInArrowFunctions": true
+			}
+		],
+		"react/exhaustive-deps": "warn",
+		"react/rules-of-hooks": "error",
+		"import/consistent-type-specifier-style": ["error", "prefer-top-level"]
+	},
+	"overrides": [
+		{
+			"files": ["**/*.config.*", "**/*.test.*", "**/*.spec.*"],
+			"rules": {
+				"eslint/no-console": "off",
+				"typescript/no-explicit-any": "warn",
+				"eslint/no-magic-numbers": "off"
+			}
+		},
+		{
+			"files": ["**/tsconfig*.json"],
+			"rules": {}
+		}
+	],
+	"env": {
+		"browser": true,
+		"es2024": true,
+		"node": true
+	},
+	"globals": {
+		"React": "readonly",
+		"JSX": "readonly",
+		"NodeJS": "readonly"
+	}
+}

package/src/tailwind/preset.js

@@ -0,0 +1,23 @@
+/**
+ * NextNode Tailwind CSS Preset
+ * Brand-agnostic defaults for all NextNode projects
+ */
+export default {
+	theme: {
+		container: {
+			center: true,
+			padding: {
+				DEFAULT: '1rem',
+				sm: '2rem',
+				lg: '4rem',
+				xl: '5rem',
+				'2xl': '6rem',
+			},
+		},
+		extend: {
+			screens: {
+				xs: '475px',
+			},
+		},
+	},
+}

package/src/typescript/tsconfig.astro.json

@@ -0,0 +1,28 @@
+{
+	"extends": "astro/tsconfigs/strict",
+	"compilerOptions": {
+		// Target & Module Configuration
+		"target": "es2022",
+		"module": "preserve",
+		"moduleDetection": "force",
+		"lib": ["es2022", "dom", "dom.iterable"],
+
+		// JavaScript & JSON Support
+		"allowJs": true,
+		"resolveJsonModule": true,
+		"skipLibCheck": true,
+
+		// Module System
+		"esModuleInterop": true,
+		"isolatedModules": true,
+		"verbatimModuleSyntax": true,
+
+		// Type Safety
+		"strict": true,
+		"noUncheckedIndexedAccess": true,
+		"noImplicitOverride": true,
+
+		// Output Configuration
+		"noEmit": true
+	}
+}

package/src/typescript/tsconfig.library.json

@@ -0,0 +1,33 @@
+{
+	"compilerOptions": {
+		// Target & Module Configuration
+		"target": "ES2023",
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"lib": ["ES2023"],
+
+		// Type Safety — Maximum Strictness
+		"strict": true,
+		"noUncheckedIndexedAccess": true,
+		"exactOptionalPropertyTypes": true,
+		"noImplicitOverride": true,
+		"noImplicitReturns": true,
+		"noFallthroughCasesInSwitch": true,
+		"noUncheckedSideEffectImports": true,
+
+		// ESM — Library Ready
+		"isolatedModules": true,
+		"verbatimModuleSyntax": true,
+
+		// Compatibility
+		"forceConsistentCasingInFileNames": true,
+		"allowSyntheticDefaultImports": true,
+		"esModuleInterop": true,
+		"resolveJsonModule": true,
+		"skipLibCheck": true,
+		"allowJs": true,
+
+		// Development Mode — No Emit
+		"noEmit": true
+	}
+}

package/src/typescript/tsconfig.nextjs.json

@@ -0,0 +1,33 @@
+{
+	"compilerOptions": {
+		// Target & Module Configuration
+		"target": "ES2023",
+		"lib": ["dom", "dom.iterable", "esnext"],
+		"module": "esnext",
+		"moduleResolution": "bundler",
+
+		// JavaScript & JSON Support
+		"allowJs": true,
+		"resolveJsonModule": true,
+		"skipLibCheck": true,
+
+		// Type Safety
+		"strict": true,
+		"noUncheckedIndexedAccess": true,
+		"forceConsistentCasingInFileNames": true,
+		"noImplicitOverride": true,
+		"noImplicitReturns": true,
+		"noFallthroughCasesInSwitch": true,
+
+		// Module System
+		"esModuleInterop": true,
+		"isolatedModules": true,
+
+		// JSX Configuration
+		"jsx": "preserve",
+
+		// Build Configuration
+		"incremental": true,
+		"noEmit": true
+	}
+}

package/src/vitest/vitest.backend.d.ts

@@ -0,0 +1,4 @@
+import type { UserConfig } from 'vitest/config'
+
+declare const config: UserConfig
+export default config

package/src/vitest/vitest.backend.js

@@ -0,0 +1,33 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+	test: {
+		// Environment Configuration
+		globals: true,
+		environment: 'node',
+		env: {
+			NODE_ENV: 'test',
+		},
+
+		// Mock Cleanup Configuration
+		restoreMocks: true,
+		clearMocks: true,
+		unstubGlobals: true,
+		mockReset: false,
+
+		// Coverage Configuration
+		coverage: {
+			provider: 'v8',
+			reporter: ['text', 'json', 'html'],
+			exclude: [
+				'node_modules/**',
+				'dist/**',
+				'**/*.d.ts',
+				'**/*.test.ts',
+				'**/*.spec.ts',
+				'**/*.config.ts',
+				'**/types.ts',
+			],
+		},
+	},
+})

package/src/vitest/vitest.frontend.d.ts

@@ -0,0 +1,4 @@
+import type { UserConfig } from 'vitest/config'
+
+declare const config: UserConfig
+export default config

package/src/vitest/vitest.frontend.js

@@ -0,0 +1,35 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+	test: {
+		// Environment Configuration
+		environment: 'jsdom',
+		globals: true,
+
+		// Mock Cleanup Configuration
+		restoreMocks: true,
+		clearMocks: true,
+		unstubGlobals: true,
+		mockReset: false,
+
+		// Coverage Configuration
+		coverage: {
+			provider: 'v8',
+			reporter: ['json', 'html', 'text'],
+			enabled: true,
+			exclude: [
+				'**/*.test.ts',
+				'**/*.test.tsx',
+				'**/*.spec.ts',
+				'**/*.spec.tsx',
+				'**/node_modules/**',
+				'**/dist/**',
+				'**/.astro/**',
+				'**/coverage/**',
+				'**/tests/**',
+				'**/config/**',
+				'**/types/**',
+			],
+		},
+	},
+})