minecraft-version-validator 1.0.0 → 1.0.1

package/CLAUDE.md

@@ -0,0 +1,80 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Development Commands
+
+### Essential Commands
+- `npm run build` - Compile TypeScript to JavaScript in `dist/`
+- `npm test` - Run all tests using Vitest
+- `npm run dev` - Run tests in watch mode for development
+- `npm run generate-versions` - Regenerate the version Set from Minecraft manifest data
+- `npm run prepack` - Build before packaging (runs automatically)
+
+### Testing
+- Run all tests: `npm test`
+- Watch mode: `npm run dev`
+- Test specific patterns: `npm test -- --run "pattern"`
+
+## Architecture Overview
+
+This is a TypeScript library that validates Minecraft version strings using a **hybrid validation strategy**:
+
+1. **Pre-computed Set Lookup** - O(1) validation for known versions stored in `src/version-set.ts`
+2. **Regex Pattern Matching** - Future-proof validation for upcoming version formats
+
+### Core Components
+
+**`src/index.ts`** - Main entry point exposing `isValidMinecraftVersion(version: string): boolean`
+- First checks if version exists in the pre-computed Set (fast path)
+- Falls back to regex patterns for unknown versions
+- Handles input validation and edge cases
+
+**`src/version-set.ts`** - Auto-generated Set containing all known Minecraft versions
+- Contains ~860 versions from classic (`c0.30_01c`) to modern (`1.21.11-pre5`)
+- Generated from official Minecraft version manifest
+- DO NOT edit manually - use `npm run generate-versions`
+
+**`scripts/generate-version-set.ts`** - Utility to refresh version data
+- Fetches from `test/version_manifest_copy.json`
+- Creates TypeScript Set with all version IDs
+- Updates timestamp in generated code
+
+### Version Format Support
+
+The library validates comprehensive Minecraft version formats:
+- Modern releases: `1.21.10`, `1.21.9`
+- Pre-releases: `1.21.11-pre5`, `1.21.9-pre4`
+- Release candidates: `1.21.10-rc1`
+- Snapshots: `25w46a`, `25w14craftmine`
+- Legacy formats: `a1.2.6`, `b1.8.1`, `rd-20090515`
+- Future year-based: `26.1`, `26.1-snapshot-1`, `26.1-pre-1`
+
+### Key Patterns
+
+**Future-proof regex**: `/^[2-5]\d\.\d{1,2}(?:\.\d{1,2})?(?:-(?:snapshot|pre|rc)-[1-9]\d{0,2})?$/`
+- Supports year-based formats through 59xx
+- Handles optional hotfix versions and pre-release suffixes
+
+**Performance optimization**: Set lookup provides O(1) validation for known versions, ensuring fast validation for the common case.
+
+## Build and CI/CD
+
+**TypeScript Configuration**: Targets ES2022 with strict mode enabled, using modern module resolution.
+
+**Testing**: Uses Vitest with comprehensive coverage including:
+- All supported version formats with real examples
+- 200+ invalid version formats for proper rejection
+- Type safety validation for non-string inputs
+
+**CI/CD**:
+- Tests on Node.js 18.x, 20.x, 22.x, and 24.x
+- Automated npm publishing with manual workflow trigger
+- Version bumping and Git tagging in publish pipeline
+
+## Development Notes
+
+- The version Set is auto-generated - never edit `src/version-set.ts` manually
+- When adding new version support, update the regex patterns in `src/index.ts`
+- Test coverage is comprehensive - new formats should include both valid and invalid test cases
+- The library has zero runtime dependencies for minimal bundle size

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAkBhE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAqBhE"}

package/dist/index.js

@@ -16,7 +16,10 @@ export function isValidMinecraftVersion(version) {
     }
     // Fallback to patterns for future versions not in the manifest
     const futurePatterns = [
-        // New year-based format (future compatibility)
+        // Standard semantic versioning format (future compatibility)
+        // Examples: 1.21.11, 1.22.0, 1.22.1, 1.21.11-pre1, 1.21.11-rc1
+        /^1\.\d{1,2}\.\d{1,2}(?:-(?:pre|rc)[1-9]\d{0,2})?$/,
+        // New year-based format (future compatibility that started in 2026)
         // Examples: 26.1, 26.1.1, 26.1-snapshot-1, 26.1-pre-1, 26.1-rc-1
         /^[2-5]\d\.\d{1,2}(?:\.\d{1,2})?(?:-(?:snapshot|pre|rc)-[1-9]\d{0,2})?$/
     ];

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2DAA2D;IAC3D,IAAI,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+DAA+D;IAC/D,MAAM,cAAc,GAAG;QACrB,+CAA+C;QAC/C,iEAAiE;QACjE,wEAAwE;KACzE,CAAC;IAEF,OAAO,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2DAA2D;IAC3D,IAAI,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+DAA+D;IAC/D,MAAM,cAAc,GAAG;QACrB,6DAA6D;QAC7D,+DAA+D;QAC/D,mDAAmD;QACnD,oEAAoE;QACpE,iEAAiE;QACjE,wEAAwE;KACzE,CAAC;IAEF,OAAO,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecraft-version-validator",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "A TypeScript library to validate Minecraft version strings",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,12 @@
     "generate-versions": "npx tsx scripts/generate-version-set.ts",
     "prepack": "npm run build"
   },
-  "keywords": ["minecraft", "version", "validator", "typescript"],
+  "keywords": [
+    "minecraft",
+    "version",
+    "validator",
+    "typescript"
+  ],
   "author": "Kaf",
   "license": "MIT",
   "type": "module",