@verifyhash/psychrometrics 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 @@
 # psychrometrics
 
-<!-- publish-prep -->
-> **TODO (owner): pick the final npm name/scope before publishing.**
-> The npm package name is **not** finalized by this project. Convention used here:
-> `package.json` keeps the working slug `psychrometrics` as a placeholder — replace it
-> (and the `npm install` line below) with the real published name/scope before
-> running `npm publish`.
-
 A tiny, **zero-dependency** Node library for humidity and moist-air math:
 saturation vapour pressure, dew point, relative and absolute humidity, the NOAA
 heat index, and Stull's wet-bulb temperature.
@@ -169,15 +162,12 @@ MIT.
 
 ## Install
 
-> Placeholder name: the `psychrometrics` below is the working slug, not a finalized
-> npm name — see the owner TODO near the top of this README.
-
 ```sh
-npm install psychrometrics
+npm install @verifyhash/psychrometrics
 ```
 
 ```js
-const psy = require('psychrometrics');
+const psy = require('@verifyhash/psychrometrics');
 
 psy.dewPoint(30, 50);  // 18.45  (°C)
 psy.heatIndex(32, 70); // 40.4   (°C, "feels like")

package/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Type declarations for @verifyhash/psychrometrics — zero-dependency humidity
+ * & moist-air math (Magnus/Alduchov-Eskridge, NOAA Rothfusz, Stull 2011).
+ *
+ * Units: temperatures in °C, relative humidity in percent (0..100 — NOT a
+ * 0..1 fraction; out-of-range rhPct throws RangeError), pressures in hPa,
+ * absolute humidity in g/m³. All inputs must be finite numbers or a
+ * TypeError is thrown.
+ */
+
+/**
+ * Saturation vapour pressure of water in air, hPa. Magnus formula with
+ * Alduchov & Eskridge (1996) coefficients; < 0.4 % error over ~ -40..+50 °C.
+ */
+export function saturationVaporPressure(tempC: number): number;
+
+/**
+ * Dew-point temperature, °C (Magnus inverse). Returns -Infinity for
+ * rhPct === 0 (dry air never saturates on cooling).
+ */
+export function dewPoint(tempC: number, rhPct: number): number;
+
+/**
+ * Relative humidity, percent, from air temperature and dew point. May exceed
+ * 100 if dewPointC > tempC.
+ */
+export function relativeHumidity(tempC: number, dewPointC: number): number;
+
+/** Absolute humidity: mass of water vapour per cubic metre of air, g/m³. */
+export function absoluteHumidity(tempC: number, rhPct: number): number;
+
+/**
+ * Heat index (apparent temperature), °C, via the NOAA/NWS Rothfusz
+ * regression. Meaningful mainly for T ≳ 27 °C and RH ≳ 40 %; below that it
+ * returns the simple Steadman value (≈ air temperature).
+ */
+export function heatIndex(tempC: number, rhPct: number): number;
+
+/**
+ * Wet-bulb temperature, °C, via Stull's (2011) empirical fit. Valid at
+ * standard sea-level pressure for roughly -20..+50 °C and 5..99 % RH
+ * (±1 °C); not corrected for altitude.
+ */
+export function wetBulb(tempC: number, rhPct: number): number;

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@verifyhash/psychrometrics",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Zero-dependency humidity & moist-air math: saturation vapour pressure, dew point, relative & absolute humidity, NOAA heat index, and Stull wet-bulb temperature.",
   "main": "index.js",
+  "types": "index.d.ts",
   "type": "commonjs",
   "scripts": {
     "test": "node test/psychrometrics.test.js"
@@ -24,7 +25,8 @@
   "license": "MIT",
   "files": [
     "index.js",
-    "README.md"
+    "README.md",
+    "index.d.ts"
   ],
   "publishConfig": {
     "access": "public"