iapws-if97 2.0.0 → 2.0.2

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project will be documented in this file.
 
+## 2.0.2
+
+- Consolidated Region 3 subregion coefficient tables into a single module.
+- Simplified Region 3 dispatcher data access through a single aggregate lookup table.
+- Added structural test coverage to ensure the full Region 3 subregion table remains intact.
+
+## 2.0.1
+
+- Added long-form aliases to `solve({ mode, ... })` inputs while keeping shorthand fields fully supported.
+- Normalized tiny floating-point residue at the public API boundary.
+
 ## 2.0.0
 
 - Narrowed the root export surface to the main solver API, core types, and error classes.

package/README.md

@@ -1,21 +1,21 @@
 # `iapws-if97`
 
-Industrial water and steam properties for Node.js and TypeScript, based on IAPWS-IF97 (The International Association for the Properties of Water and Steam - Industrial Formulation 1997).
+Calculate industrial water and steam properties in Node.js and TypeScript, based on the [IAPWS-IF97](https://www.iapws.org/) standard (International Association for the Properties of Water and Steam — Industrial Formulation 1997).
 
-`iapws-if97` provides forward and backward state solvers, saturation solvers, and transport-property helpers for engineering calculations involving water and steam. For the standards organization and official releases, see [IAPWS](https://www.iapws.org/).
+The library provides forward and backward state solvers, saturation solvers, and transport-property helpers for engineering calculations involving water and steam.
 
 ## Features
 
-- IF97 Regions 1 to 5, including Region 5 high-temperature support
-- Forward, backward, and saturation solvers from a consistent public API
-- Transport properties including viscosity, thermal conductivity, surface tension, dielectric constant, and ionization constant
-- Typed ESM package with bundled declarations
-- `2.0` export split: root import for main solvers, subpaths for advanced helpers
-- Verified against IAPWS tables and published engineering references
+- Covers IF97 Regions 1–5, including high-temperature Region 5
+- Forward, backward, and saturation solvers behind a consistent API
+- Transport properties: viscosity, thermal conductivity, surface tension, dielectric constant, and ionization constant
+- Typed ESM package with bundled TypeScript declarations
+- Clean export split in `2.0`: root import for main solvers, subpaths for advanced helpers
+- Verified against official IAPWS tables and published engineering references
 
 ## Project Origin
 
-> `iapws-if97` is the core calculation library behind the WeChat MiniProgram "汽水计算器" (`wxid: wx7201fd1713b524e5`). First launched in 2019, it has served nearly 20,000 users. With the help of AI, this edition has now been updated through `R11-24 (2024)`. I am open-sourcing it in the hope that it can help others with similar engineering needs.
+> `iapws-if97` is the core calculation engine behind the WeChat Mini Program "汽水计算器" (`wxid: wx7201fd1713b524e5`). Since its launch in 2019, it has served nearly 20,000 users. With the help of AI, this edition has been updated to incorporate `R11-24 (2024)`. I am open-sourcing it in the hope that it will help others with similar engineering needs.
 
 <p align="right">-- Retired Thermodynamic Engineer, Shuping</p>
 
@@ -51,7 +51,7 @@ console.log(c.quality);     // 0.5
 - `solveTx(T, x)` // `K`, quality `[0, 1]`
 - `solve(input)` // same units as the selected `mode`
 
-Use `solve({ mode, ... })` when the input pair varies at runtime:
+Use `solve({ mode, ... })` when the input pair is determined at runtime:
 
 ```ts
 import { solve } from 'iapws-if97';
@@ -59,7 +59,14 @@ import { solve } from 'iapws-if97';
 const state = solve({ mode: 'PT', p: 16, T: 823.15 });
 ```
 
-Supported `mode`:
+`solve` accepts both short-form and long-form property names:
+
+```ts
+const a = solve({ mode: 'PT', p: 16, T: 823.15 });
+const b = solve({ mode: 'PT', pressure: 16, temperature: 823.15 });
+```
+
+Supported modes:
 
 ```ts
 type SolveInput =
@@ -73,10 +80,11 @@ type SolveInput =
   | { mode: 'TS'; T: number; s: number };
 ```
 
+You can use either form for each property. If you provide both, their values must match.
+
 ## Solver Return Value
 
-All public solvers return a `SteamState` object with thermodynamic and transport properties already populated.
-For user-facing documentation, it is best understood as the solver return object. The exported TypeScript type name is `SteamState`.
+All solvers return a `SteamState` object containing both thermodynamic and transport properties:
 
 ```ts
 type SteamState = {
@@ -102,13 +110,15 @@ type SteamState = {
 };
 ```
 
-Notes:
+`SteamState` always uses canonical property names. Input aliases like `p`/`pressure` do not create duplicate fields.
+
+**Notes:**
 
-- `quality` is only defined for saturated states and is `null` elsewhere.
-- In two-phase mixture states (`0 < x < 1`), `cp`, `cv`, `speedOfSound`, `isobaricExpansion`, and `isothermalCompressibility` return `null`.
-- `surfaceTension` is only returned on Region 4 saturation states below the critical point. In bulk single-phase states it returns `null`.
-- `density` is included directly, so you do not need to invert `specificVolume` yourself.
-- `ionizationConstant` is returned as `null` outside the released IAPWS validity range for that correlation.
+- `quality` is `null` for single-phase states — it is only defined on the saturation line.
+- In two-phase mixtures (`0 < x < 1`), `cp`, `cv`, `speedOfSound`, `isobaricExpansion`, and `isothermalCompressibility` are `null`.
+- `surfaceTension` is only available for Region 4 saturation states below the critical point; otherwise `null`.
+- `density` is provided directly — no need to invert `specificVolume`.
+- `ionizationConstant` is `null` outside the IAPWS validity range for that correlation.
 
 ## Units
 
@@ -119,7 +129,7 @@ Notes:
 - Enthalpy, internal energy: `kJ/kg`
 - Entropy, heat capacities: `kJ/(kg·K)`
 - Speed of sound: `m/s`
-- Quality: dimensionless, `0` to `1` on the saturation line
+- Quality: dimensionless, `0`–`1` (saturation line only)
 - Viscosity: `Pa·s`
 - Thermal conductivity: `W/(m·K)`
 - Surface tension: `N/m`
@@ -128,12 +138,12 @@ Notes:
 - Isobaric expansion coefficient: `1/K`
 - Isothermal compressibility: `1/MPa`
 
-Fields documented as `number | null` return `null` when the property is not defined for the requested state.
+Any field typed as `number | null` returns `null` when the property is undefined for the given state.
 
 ## Advanced Imports
 
-The package root is intentionally limited to the main solver API, core types, and error classes.
-Lower-level helpers are available from dedicated subpaths:
+The package root exports only the main solver API, core types, and error classes.
+Lower-level helpers are available through dedicated subpaths:
 
 - `iapws-if97/transport`: `viscosity`, `thermalConductivity`, `surfaceTension`, `dielectricConstant`, `ionizationConstant`
 - `iapws-if97/regions`: `region1`, `region2`, `region3ByRhoT`, `region5`
@@ -152,8 +162,8 @@ import { detectRegionPT } from 'iapws-if97/detect';
 
 ## Migration to 2.0
 
-Version `2.0.0` narrows the root export surface to the main solver API.
-If you imported lower-level helpers from the package root in `1.x`, move them to subpath imports:
+Version `2.0` limits the root export to the main solver API.
+If you imported lower-level helpers from the package root in `1.x`, update them to use subpath imports:
 
 - `import { viscosity } from 'iapws-if97'` → `import { viscosity } from 'iapws-if97/transport'`
 - `import { region1 } from 'iapws-if97'` → `import { region1 } from 'iapws-if97/regions'`
@@ -162,54 +172,56 @@ If you imported lower-level helpers from the package root in `1.x`, move them to
 
 ## Advanced Usage Notes
 
-- `region1`, `region2`, `region3ByRhoT`, and `region5` return core thermodynamic properties without transport-property enrichment.
-- `detectRegion*` helpers return a `Region` enum value or `-1` when the input pair is outside IF97 validity.
-- `viscosity(T, rho)` and `dielectricConstant(T, rho)` require temperature and density, not a `SteamState`.
-- `ionizationConstant(T, rho)` also requires temperature and density, and returns `null` outside its released validity range.
-- `thermalConductivity(T, rho, cp?, cv?, drhodP_T?, mu?)` supports two levels:
-  - minimal call: base conductivity from `T` and `rho`
-  - full call: include `cp`, `cv`, `drhodP_T`, and `mu` to evaluate the IAPWS 2011 critical-enhancement term
-- `surfaceTension(T)` returns `null` outside its valid temperature range and should be interpreted as a saturation-line property.
-- `solveTH(T, h)` prefers the compressed-liquid branch when a subcritical liquid state and a two-phase state are both thermodynamically possible at the same `T` and `h`; exact saturation endpoints still return Region 4 metadata.
+- `region1`, `region2`, `region3ByRhoT`, and `region5` return core thermodynamic properties **without** transport-property enrichment.
+- `detectRegion*` helpers return a `Region` enum value, or `-1` if the input falls outside IF97 validity.
+- `viscosity(T, rho)` and `dielectricConstant(T, rho)` take temperature and density directly — not a `SteamState`.
+- `ionizationConstant(T, rho)` also takes temperature and density; returns `null` outside its validity range.
+- `thermalConductivity(T, rho, cp?, cv?, drhodP_T?, mu?)` supports two calling levels:
+  - **Minimal:** pass `T` and `rho` for base conductivity.
+  - **Full:** additionally pass `cp`, `cv`, `drhodP_T`, and `mu` to include the IAPWS 2011 critical-enhancement term.
+- `surfaceTension(T)` returns `null` outside its valid temperature range. It applies only along the saturation line.
+- `solveTH(T, h)` prefers the compressed-liquid branch when both a subcritical liquid state and a two-phase state are possible at the same `T` and `h`. Exact saturation endpoints still return Region 4 metadata.
 
 ## Errors and Limits
 
-The library throws typed errors from the public API:
+The library throws typed errors:
 
-- `OutOfRangeError`: an input is outside the supported IF97 range
-- `ConvergenceError`: an internal numerical solve failed to converge
-- `IF97Error`: base class for library-specific failures
+| Error | Meaning |
+| --- | --- |
+| `OutOfRangeError` | Input is outside the supported IF97 range |
+| `ConvergenceError` | An internal iterative solve failed to converge |
+| `IF97Error` | Base class for all library-specific errors |
 
-Typical boundary rules:
+**Boundary rules:**
 
-- `solvePT(p, T)` supports the IF97 industrial range up to `100 MPa` and `2273.15 K`, with Region 5 limited to `50 MPa`.
-- The exact critical point (`22.064 MPa`, `647.096 K`) is rejected with `IF97Error` because derivative properties are singular there.
-- `solvePx(p, x)` is only valid on the saturation line for `Pt <= p <= Pc`.
-- `solveTx(T, x)` is only valid on the saturation line for `273.15 K <= T <= Tc`.
-- `solveTH(T, h)` and `solveTS(T, s)` currently support Region 1 to Region 5. Inputs within `0.001 K` of the critical-point temperature are rejected conservatively with `IF97Error`.
+- `solvePT(p, T)` covers the IF97 industrial range up to `100 MPa` / `2273.15 K`. Region 5 is limited to `50 MPa`.
+- The exact critical point (`22.064 MPa`, `647.096 K`) is rejected because derivative properties are singular there.
+- `solvePx(p, x)` requires the saturation line: `Pt ≤ p ≤ Pc`.
+- `solveTx(T, x)` requires the saturation line: `273.15 K ≤ T ≤ Tc`.
+- `solveTH(T, h)` and `solveTS(T, s)` support Regions 1–5. Inputs within `0.001 K` of the critical temperature are rejected.
 - `x` must be in `[0, 1]` for two-phase calculations.
-- Properties that are not defined for the requested state are returned as `null`, not `NaN`.
+- Undefined properties are returned as `null`, never `NaN`.
 
-## Validity notes
+## Validity Notes
 
-- Thermodynamic core follows IF97 industrial validity ranges up to `100 MPa` and `2273.15 K`, including Region 5.
-- Surface tension is only meaningful on the saturation line below the critical point.
+- Thermodynamic properties follow IF97 validity ranges: up to `100 MPa` and `2273.15 K` (including Region 5).
+- Surface tension applies only along the saturation line below the critical point.
 - Thermal conductivity follows the IAPWS 2011 release.
-- Ionization constant uses the latest IAPWS 2024 revised release and is officially recommended for stable fluid states from `273.15 K` to `1273.15 K` and up to `1000 MPa`.
+- Ionization constant follows the IAPWS 2024 revised release, valid for stable fluid states from `273.15 K` to `1273.15 K` and up to `1000 MPa`.
 
 ## Verification
 
-The test suite includes:
+The test suite covers:
 
-- Official IF97 verification tables for Regions 1 to 5
-- Backward-equation round trips
-- Temperature-led backward round trips for `TH` and `TS`
-- High-pressure Region 4 regression tests
+- Official IF97 verification tables (Regions 1–5)
+- Backward-equation round-trip accuracy
+- Temperature-led backward round trips (`TH` and `TS`)
+- High-pressure Region 4 regressions
 - IAPWS R11-24 ionization-constant verification values
-- Coverage thresholds enforced in CI-style local runs
-- ASME and GB/T steam-table comparison reports for published standard values
+- Coverage thresholds enforced locally
+- ASME and GB/T steam-table comparisons against published values
 
-Run locally:
+To run locally:
 
 ```bash
 npm run build
@@ -220,8 +232,8 @@ npm run test:standards
 
 ### ASME Validation Snapshot
 
-`tests/standards-asme/asme-steam-table-report.test.ts` compares saturation states against ASME International Steam Tables for Industrial Use, 3rd ed., Table S-2 ("Properties of Saturated Water and Steam (Pressure)").
-Each pressure case checks 7 published values: saturation temperature, saturated-liquid/saturated-vapor specific volume, enthalpy, and entropy.
+Compares saturation states against *ASME International Steam Tables for Industrial Use*, 3rd ed., Table S-2 ("Properties of Saturated Water and Steam — Pressure").
+Each case checks 7 values: saturation temperature, liquid/vapor specific volume, enthalpy, and entropy.
 
 | ASME case | Pressure (MPa) | Points checked | Max relative error |
 | --- | ---: | ---: | ---: |
@@ -237,8 +249,8 @@ The current ASME regression threshold is `maxRelativeError < 5e-4` (less than `0
 
 ### GB/T Validation Snapshot
 
-`tests/standards-cn/gbt34060-report.test.ts` compares superheated-steam states against `GB/T 34060-2017`, Table A.3(续), page 55.
-Each temperature case checks 4 published values at `10 MPa`: specific volume, enthalpy, entropy, and speed of sound.
+Compares superheated-steam states against *GB/T 34060-2017*, Table A.3(续), page 55.
+Each case checks 4 values at `10 MPa`: specific volume, enthalpy, entropy, and speed of sound.
 
 | GB/T case | Pressure (MPa) | Temperature (°C) | Points checked | Max relative error |
 | --- | ---: | ---: | ---: | ---: |
@@ -254,7 +266,7 @@ The current GB/T regression threshold is `maxRelativeError < 5e-4` (less than `0
 
 ## TypeScript
 
-The package ships with bundled declarations and ESM exports.
+The package ships with bundled TypeScript declarations and ESM exports.
 
 ```ts
 import type { SolveInput, SteamState } from 'iapws-if97';
@@ -283,6 +295,4 @@ MIT
 
 ## Disclaimer
 
-This software is provided "as is", without warranty of any kind, express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, and noninfringement.
-
-In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use of the software.
+This software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability arising from the use of this software.

package/dist/core/public-normalization.d.ts

@@ -0,0 +1,5 @@
+import type { BasicProperties, SteamState } from '../types.js';
+type PublicState = BasicProperties | SteamState;
+export declare function normalizePublicState<T extends PublicState>(state: T): T;
+export {};
+//# sourceMappingURL=public-normalization.d.ts.map

package/dist/core/public-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-normalization.d.ts","sourceRoot":"","sources":["../../src/core/public-normalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM/D,KAAK,WAAW,GAAG,eAAe,GAAG,UAAU,CAAC;AAsBhD,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAYvE"}

package/dist/core/public-normalization.js

@@ -0,0 +1,31 @@
+// Only snap values that are effectively simple decimals plus machine-noise.
+const SIMPLE_DECIMAL_PLACES = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9];
+const SNAP_ULPS = 8;
+function snapSimpleDecimal(value) {
+    if (!Number.isFinite(value)) {
+        return value;
+    }
+    for (const decimals of SIMPLE_DECIMAL_PLACES) {
+        const factor = 10 ** decimals;
+        const candidate = Math.round(value * factor) / factor;
+        // Scale the acceptance window with magnitude so we only absorb
+        // binary floating-point residue, not meaningful engineering deltas.
+        const tolerance = SNAP_ULPS * Number.EPSILON * Math.max(1, Math.abs(value), Math.abs(candidate));
+        if (Math.abs(value - candidate) <= tolerance) {
+            return Object.is(candidate, -0) ? 0 : candidate;
+        }
+    }
+    return Object.is(value, -0) ? 0 : value;
+}
+export function normalizePublicState(state) {
+    const normalized = { ...state };
+    for (const [key, value] of Object.entries(state)) {
+        // Preserve enum/null fields exactly; only normalize exposed numeric outputs.
+        if (key === 'region' || value === null || typeof value !== 'number') {
+            continue;
+        }
+        normalized[key] = snapSimpleDecimal(value);
+    }
+    return normalized;
+}
+//# sourceMappingURL=public-normalization.js.map

package/dist/core/public-normalization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-normalization.js","sourceRoot":"","sources":["../../src/core/public-normalization.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,qBAAqB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,CAAC;AACtE,MAAM,SAAS,GAAG,CAAC,CAAC;AAIpB,SAAS,iBAAiB,CAAC,KAAa;IACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,qBAAqB,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,EAAE,IAAI,QAAQ,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;QACtD,+DAA+D;QAC/D,oEAAoE;QACpE,MAAM,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QAEjG,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,SAAS,EAAE,CAAC;YAC7C,OAAO,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAwB,KAAQ;IAClE,MAAM,UAAU,GAAG,EAAE,GAAG,KAAK,EAA8C,CAAC;IAE5E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,6EAA6E;QAC7E,IAAI,GAAG,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACpE,SAAS;QACX,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,UAA0B,CAAC;AACpC,CAAC"}

package/dist/core/solve-input-normalization.d.ts

@@ -0,0 +1,36 @@
+import type { SolveInput } from '../types.js';
+export type CanonicalSolveInput = {
+    mode: 'PT';
+    p: number;
+    T: number;
+} | {
+    mode: 'PH';
+    p: number;
+    h: number;
+} | {
+    mode: 'PS';
+    p: number;
+    s: number;
+} | {
+    mode: 'HS';
+    h: number;
+    s: number;
+} | {
+    mode: 'Px';
+    p: number;
+    x: number;
+} | {
+    mode: 'Tx';
+    T: number;
+    x: number;
+} | {
+    mode: 'TH';
+    T: number;
+    h: number;
+} | {
+    mode: 'TS';
+    T: number;
+    s: number;
+};
+export declare function normalizeSolveInput(input: SolveInput): CanonicalSolveInput;
+//# sourceMappingURL=solve-input-normalization.d.ts.map

package/dist/core/solve-input-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solve-input-normalization.d.ts","sourceRoot":"","sources":["../../src/core/solve-input-normalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AA6BzC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,CAuD1E"}

package/dist/core/solve-input-normalization.js

@@ -0,0 +1,71 @@
+import { IF97Error } from '../types.js';
+function pickNumericAlias(input, shortKey, longKey, label) {
+    const shortValue = input[shortKey];
+    const longValue = input[longKey];
+    if (shortValue === undefined && longValue === undefined) {
+        throw new IF97Error(`solve input requires '${shortKey}' or '${longKey}' for ${label}`);
+    }
+    if (shortValue !== undefined &&
+        longValue !== undefined &&
+        !Object.is(shortValue, longValue)) {
+        throw new IF97Error(`solve input received conflicting values for '${shortKey}' and '${longKey}'`);
+    }
+    return (shortValue ?? longValue);
+}
+// Normalize public solve() aliases to the canonical short-key form used internally.
+export function normalizeSolveInput(input) {
+    const raw = input;
+    switch (input.mode) {
+        case 'PT':
+            return {
+                mode: 'PT',
+                p: pickNumericAlias(raw, 'p', 'pressure', 'pressure'),
+                T: pickNumericAlias(raw, 'T', 'temperature', 'temperature'),
+            };
+        case 'PH':
+            return {
+                mode: 'PH',
+                p: pickNumericAlias(raw, 'p', 'pressure', 'pressure'),
+                h: pickNumericAlias(raw, 'h', 'enthalpy', 'enthalpy'),
+            };
+        case 'PS':
+            return {
+                mode: 'PS',
+                p: pickNumericAlias(raw, 'p', 'pressure', 'pressure'),
+                s: pickNumericAlias(raw, 's', 'entropy', 'entropy'),
+            };
+        case 'HS':
+            return {
+                mode: 'HS',
+                h: pickNumericAlias(raw, 'h', 'enthalpy', 'enthalpy'),
+                s: pickNumericAlias(raw, 's', 'entropy', 'entropy'),
+            };
+        case 'Px':
+            return {
+                mode: 'Px',
+                p: pickNumericAlias(raw, 'p', 'pressure', 'pressure'),
+                x: pickNumericAlias(raw, 'x', 'quality', 'quality'),
+            };
+        case 'Tx':
+            return {
+                mode: 'Tx',
+                T: pickNumericAlias(raw, 'T', 'temperature', 'temperature'),
+                x: pickNumericAlias(raw, 'x', 'quality', 'quality'),
+            };
+        case 'TH':
+            return {
+                mode: 'TH',
+                T: pickNumericAlias(raw, 'T', 'temperature', 'temperature'),
+                h: pickNumericAlias(raw, 'h', 'enthalpy', 'enthalpy'),
+            };
+        case 'TS':
+            return {
+                mode: 'TS',
+                T: pickNumericAlias(raw, 'T', 'temperature', 'temperature'),
+                s: pickNumericAlias(raw, 's', 'entropy', 'entropy'),
+            };
+        default:
+            throw new IF97Error(`Unsupported solve mode: ${input.mode ?? 'undefined'}`);
+    }
+}
+//# sourceMappingURL=solve-input-normalization.js.map

package/dist/core/solve-input-normalization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solve-input-normalization.js","sourceRoot":"","sources":["../../src/core/solve-input-normalization.ts"],"names":[],"mappings":"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"}

package/dist/core/solver.d.ts

@@ -13,7 +13,8 @@ import type { SteamState, SolveInput } from '../types.js';
 export declare function solvePT(p: number, T: number): SteamState;
 /**
  * Unified solver: compute full thermodynamic state from any supported input pair.
- * Routes to the correct solver based on input mode, enriches with transport properties.
+ * Routes to the correct solver based on input mode, enriches with transport properties,
+ * and accepts either shorthand or long-form input field names.
  */
 export declare function solve(input: SolveInput): SteamState;
 //# sourceMappingURL=solver.d.ts.map

package/dist/core/solver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"solver.d.ts","sourceRoot":"","sources":["../../src/core/solver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAmB,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA2C3E;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAqCxD;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAanD"}
+{"version":3,"file":"solver.d.ts","sourceRoot":"","sources":["../../src/core/solver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAmB,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA4C3E;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAqCxD;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAenD"}

package/dist/core/solver.js

@@ -5,6 +5,7 @@ import { region2 } from '../regions/region2.js';
 import { region5 } from '../regions/region5.js';
 import { detectRegionPT } from './region-detector.js';
 import { solveRegion3PTBasic } from './region3-pt.js';
+import { normalizeSolveInput } from './solve-input-normalization.js';
 import { viscosity, thermalConductivity, surfaceTension, dielectricConstant, ionizationConstant } from '../transport/properties.js';
 import { solvePH } from '../backward/ph.js';
 import { solvePS } from '../backward/ps.js';
@@ -77,18 +78,20 @@ export function solvePT(p, T) {
 }
 /**
  * Unified solver: compute full thermodynamic state from any supported input pair.
- * Routes to the correct solver based on input mode, enriches with transport properties.
+ * Routes to the correct solver based on input mode, enriches with transport properties,
+ * and accepts either shorthand or long-form input field names.
  */
 export function solve(input) {
-    switch (input.mode) {
-        case 'PT': return solvePT(input.p, input.T);
-        case 'PH': return enrichState(solvePH(input.p, input.h));
-        case 'PS': return enrichState(solvePS(input.p, input.s));
-        case 'HS': return enrichState(solveHS(input.h, input.s));
-        case 'Px': return enrichState(solvePx(input.p, input.x));
-        case 'Tx': return enrichState(solveTx(input.T, input.x));
-        case 'TH': return enrichState(solveTH(input.T, input.h));
-        case 'TS': return enrichState(solveTS(input.T, input.s));
+    const normalized = normalizeSolveInput(input);
+    switch (normalized.mode) {
+        case 'PT': return solvePT(normalized.p, normalized.T);
+        case 'PH': return enrichState(solvePH(normalized.p, normalized.h));
+        case 'PS': return enrichState(solvePS(normalized.p, normalized.s));
+        case 'HS': return enrichState(solveHS(normalized.h, normalized.s));
+        case 'Px': return enrichState(solvePx(normalized.p, normalized.x));
+        case 'Tx': return enrichState(solveTx(normalized.T, normalized.x));
+        case 'TH': return enrichState(solveTH(normalized.T, normalized.h));
+        case 'TS': return enrichState(solveTS(normalized.T, normalized.s));
         default:
             throw new IF97Error(`Unsupported solve mode: ${input.mode ?? 'undefined'}`);
     }

package/dist/core/solver.js.map

@@ -1 +1 @@
-{"version":3,"file":"solver.js","sourceRoot":"","sources":["../../src/core/solver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"solver.js","sourceRoot":"","sources":["../../src/core/solver.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,13 +3,16 @@
  *
  * Public API exports.
  */
-export { solvePT, solve } from './core/solver.js';
-export { solvePH } from './backward/ph.js';
-export { solvePS } from './backward/ps.js';
-export { solveHS } from './backward/hs.js';
-export { solveTH } from './backward/th.js';
-export { solveTS } from './backward/ts.js';
-export { solvePx, solveTx } from './saturation/two-phase.js';
+import type { BasicProperties, SteamState, SolveInput } from './types.js';
+export declare function solvePT(p: number, T: number): SteamState;
+export declare function solve(input: SolveInput): SteamState;
+export declare function solvePH(p: number, h: number): BasicProperties;
+export declare function solvePS(p: number, s: number): BasicProperties;
+export declare function solveHS(h: number, s: number): BasicProperties;
+export declare function solveTH(T: number, h: number): BasicProperties;
+export declare function solveTS(T: number, s: number): BasicProperties;
+export declare function solvePx(p: number, x: number): BasicProperties;
+export declare function solveTx(T: number, x: number): BasicProperties;
 export type { SteamState, SolveInput } from './types.js';
 export { Region, IF97Error, OutOfRangeError, ConvergenceError } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAG7D,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAqB1E,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAExD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAEnD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,eAAe,CAE7D;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,eAAe,CAE7D;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,eAAe,CAE7D;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,eAAe,CAE7D;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,eAAe,CAE7D;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,eAAe,CAE7D;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,eAAe,CAE7D;AAGD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,15 +1,46 @@
-/**
- * iapws-if97 — IAPWS-IF97 Steam/Water Properties Library
- *
- * Public API exports.
- */
+import { solve as solveAny, solvePT as solvePTInternal } from './core/solver.js';
+import { normalizePublicState } from './core/public-normalization.js';
+import { solvePH as solvePHInternal } from './backward/ph.js';
+import { solvePS as solvePSInternal } from './backward/ps.js';
+import { solveHS as solveHSInternal } from './backward/hs.js';
+import { solveTH as solveTHInternal } from './backward/th.js';
+import { solveTS as solveTSInternal } from './backward/ts.js';
+import { solvePx as solvePxInternal, solveTx as solveTxInternal } from './saturation/two-phase.js';
+function normalizeBasicState(state) {
+    return normalizePublicState(state);
+}
+function normalizeSteamState(state) {
+    return normalizePublicState(state);
+}
 // Core solvers
-export { solvePT, solve } from './core/solver.js';
-export { solvePH } from './backward/ph.js';
-export { solvePS } from './backward/ps.js';
-export { solveHS } from './backward/hs.js';
-export { solveTH } from './backward/th.js';
-export { solveTS } from './backward/ts.js';
-export { solvePx, solveTx } from './saturation/two-phase.js';
+// Normalize only at the public package boundary so internal solver math
+// keeps full raw precision during iteration and region transitions.
+export function solvePT(p, T) {
+    return normalizeSteamState(solvePTInternal(p, T));
+}
+export function solve(input) {
+    return normalizeSteamState(solveAny(input));
+}
+export function solvePH(p, h) {
+    return normalizeBasicState(solvePHInternal(p, h));
+}
+export function solvePS(p, s) {
+    return normalizeBasicState(solvePSInternal(p, s));
+}
+export function solveHS(h, s) {
+    return normalizeBasicState(solveHSInternal(h, s));
+}
+export function solveTH(T, h) {
+    return normalizeBasicState(solveTHInternal(T, h));
+}
+export function solveTS(T, s) {
+    return normalizeBasicState(solveTSInternal(T, s));
+}
+export function solvePx(p, x) {
+    return normalizeBasicState(solvePxInternal(p, x));
+}
+export function solveTx(T, x) {
+    return normalizeBasicState(solveTxInternal(T, x));
+}
 export { Region, IF97Error, OutOfRangeError, ConvergenceError } from './types.js';
 //# sourceMappingURL=index.js.map