@verifyhash/semver-lite 0.1.0 → 0.1.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 <OWNER-NAME PLACEHOLDER>
+Copyright (c) 2026 verifyhash
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,12 +1,5 @@
 # semver-lite
 
-<!-- publish-prep -->
-> **TODO (owner): pick the final npm name/scope before publishing.**
-> The npm name is **not** finalized. `package.json` uses the placeholder
-> `PLACEHOLDER-semver-lite` — replace it with the real published name/scope
-> before any `npm publish`. Graduation to a package registry is a
-> **needs-human** decision, not something this project does on its own.
-
 A tiny, **zero-dependency, zero-network** Node.js library for **Semantic
 Versioning 2.0.0**: parse a version string, compare two versions by the exact
 SemVer precedence rules (including the fiddly pre-release ordering), and test
@@ -18,6 +11,16 @@ and no I/O. Drop it into any project.
 
 Spec reference: <https://semver.org/spec/v2.0.0.html>
 
+## Install
+
+```bash
+npm install @verifyhash/semver-lite
+```
+
+Published as [`@verifyhash/semver-lite`](https://www.npmjs.com/package/@verifyhash/semver-lite);
+source lives in the [verifyhash/libs](https://github.com/verifyhash/libs) monorepo.
+Zero runtime dependencies — you can also vendor the folder directly.
+
 ## Who it's for
 
 JavaScript/Node developers who need dependency- or version-logic — "is `1.4.2`
@@ -173,5 +176,4 @@ every supported range form (exact, `^`, `~`, x-range, comparators, hyphen, and
 
 ## License
 
-MIT — see `LICENSE`. (Owner: replace the copyright placeholder before
-publishing.)
+MIT — see `LICENSE`.

package/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Type declarations for @verifyhash/semver-lite — zero-dependency SemVer
+ * 2.0.0 parse, precedence compare, and a documented practical subset of
+ * npm-style range matching (exact, =, comparators, ^, ~, x-ranges, hyphen
+ * ranges, || unions, whitespace AND; npm-style prerelease gating).
+ *
+ * Pure functions over strings; no network, no I/O.
+ */
+
+/** A parsed SemVer 2.0.0 version. */
+export interface ParsedVersion {
+  major: number;
+  minor: number;
+  patch: number;
+  /**
+   * Prerelease identifiers ('1.2.3-alpha.1' -> ['alpha', 1]); purely numeric
+   * identifiers are converted to numbers. Empty when there is no prerelease.
+   */
+  prerelease: Array<string | number>;
+  /** Build-metadata identifiers ('1.2.3+build.5' -> ['build', '5']); empty when absent. */
+  build: string[];
+  /** Canonical version string WITHOUT build metadata, e.g. '1.2.3-alpha.1'. */
+  version: string;
+}
+
+/**
+ * Parse a SemVer 2.0.0 string (leading/trailing whitespace tolerated).
+ * Returns null on invalid input — it does NOT throw.
+ */
+export function parse(v: string): ParsedVersion | null;
+
+/** Whether a string is a valid SemVer 2.0.0 version. */
+export function valid(v: string): boolean;
+
+/**
+ * Compare two versions by SemVer precedence (§11). Build metadata is IGNORED.
+ * Throws TypeError on an invalid version.
+ * @returns -1 if a < b, 0 if equal precedence, 1 if a > b
+ */
+export function compare(a: string, b: string): -1 | 0 | 1;
+
+/** a > b by precedence. Throws TypeError on an invalid version. */
+export function gt(a: string, b: string): boolean;
+
+/** a < b by precedence. Throws TypeError on an invalid version. */
+export function lt(a: string, b: string): boolean;
+
+/** a >= b by precedence. Throws TypeError on an invalid version. */
+export function gte(a: string, b: string): boolean;
+
+/** a <= b by precedence. Throws TypeError on an invalid version. */
+export function lte(a: string, b: string): boolean;
+
+/** Equal precedence (build metadata ignored). Throws TypeError on an invalid version. */
+export function eq(a: string, b: string): boolean;
+
+/** Different precedence. Throws TypeError on an invalid version. */
+export function neq(a: string, b: string): boolean;
+
+/**
+ * Sort a list of versions ascending by precedence. Returns a NEW array; the
+ * input is not mutated. Throws TypeError if any entry is invalid.
+ */
+export function sort(list: readonly string[]): string[];
+
+/**
+ * Does `version` satisfy `range`? Supports the documented subset: exact,
+ * =, >/>=/</<= comparators, caret (^), tilde (~ and ~>), x-ranges (1.2.x,
+ * 1.x, *), hyphen ranges (1.2.3 - 2.3.4), || unions, and whitespace-joined
+ * AND. A prerelease version only matches when some comparator in the set
+ * names the same major.minor.patch WITH a prerelease (npm semantics).
+ * Returns false (does not throw) for an invalid version or non-string range;
+ * throws TypeError on a malformed range token.
+ */
+export function satisfies(version: string, range: string): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verifyhash/semver-lite",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Zero-dependency SemVer 2.0.0 parse, precedence compare, and a documented practical subset of npm-style range matching for Node.js.",
   "keywords": [
     "semver",
@@ -15,13 +15,15 @@
     "tilde"
   ],
   "main": "index.js",
+  "types": "index.d.ts",
   "scripts": {
     "test": "node test/index.test.js"
   },
   "license": "MIT",
   "files": [
     "index.js",
-    "README.md"
+    "README.md",
+    "index.d.ts"
   ],
   "publishConfig": {
     "access": "public"