@nextnode-solutions/standards 1.0.0

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@nextnode-solutions/standards",
+  "version": "1.0.0",
+  "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/core#readme",
+  "bugs": {
+    "url": "https://github.com/NextNodeSolutions/core/issues"
+  },
+  "license": "MIT",
+  "author": "NextNode Solutions",
+  "files": [
+    "README.md",
+    "src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NextNodeSolutions/core.git"
+  },
+  "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"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "packageManager": "pnpm@10.11.0",
+  "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/theme.css",
+    "./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",
+    "./editorconfig": "./src/editorconfig/base.editorconfig",
+    "./npmrc": "./src/npmrc/base.npmrc",
+    "./lint-staged": "./src/lint-staged/base.js",
+    "./semantic-release": "./src/semantic-release/base.js"
+  }
+}

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/editorconfig/base.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+indent_style = tab
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

package/src/lint-staged/base.js

@@ -0,0 +1,8 @@
+export default {
+	'package.json': ['better-sort-package-json'],
+	'*.{js,mjs,cjs,jsx,ts,mts,cts,tsx,vue,svelte,astro}': [
+		'oxlint',
+		'oxfmt --write',
+	],
+	'*.json': ['oxfmt --write'],
+}

package/src/npmrc/base.npmrc

@@ -0,0 +1,3 @@
+strict-peer-dependencies=false
+auto-install-peers=true
+shamefully-hoist=false

package/src/oxfmt/base.json

@@ -0,0 +1,33 @@
+{
+	"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": [
+			["builtin"],
+			["external", "type-external"],
+			["internal", "type-internal"],
+			["parent", "type-parent"],
+			["sibling", "type-sibling"],
+			["index", "type-index"]
+		],
+		"newlinesBetween": true
+	},
+	"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/semantic-release/base.js

@@ -0,0 +1,21 @@
+export default {
+	plugins: [
+		'@semantic-release/commit-analyzer',
+		'@semantic-release/release-notes-generator',
+		'@semantic-release/npm',
+		[
+			'@semantic-release/git',
+			{
+				assets: ['package.json'],
+				message: 'chore(release): ${nextRelease.gitTag} [skip ci]',
+			},
+		],
+		[
+			'@semantic-release/github',
+			{
+				successComment: false,
+				failTitle: false,
+			},
+		],
+	],
+}

package/src/tailwind/theme.css

@@ -0,0 +1,13 @@
+/*
+ * NextNode Tailwind CSS v4 Theme
+ * Brand-agnostic defaults for all NextNode projects
+ *
+ * Usage in consuming project's CSS:
+ *
+ *   @import "tailwindcss";
+ *   @import "@nextnode-solutions/standards/tailwind";
+ */
+
+@theme {
+	--breakpoint-xs: 30rem;
+}

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,31 @@
+{
+	"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,
+		"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/**',
+			],
+		},
+	},
+})