ezmedicationinput 0.1.46 → 0.1.47

package/dist/types.d.ts

@@ -30,6 +30,38 @@ export interface FhirQuantity {
     system?: string;
     code?: string;
 }
+export type DoseUnitKind = "metric" | "biologic_unit" | "counted_presentation" | "device_actuation" | "infusion_rate" | "product_specific_amount" | "length_of_product" | "body_area_proxy" | "qualitative_amount";
+export type DoseUnitApproximationConfidence = "exact" | "approximate" | "product_specific";
+export interface DoseUnitApproximation {
+    value: number;
+    unit: string;
+    confidence: DoseUnitApproximationConfidence;
+    basis: string;
+    source?: string;
+}
+export interface DoseUnitTerminologyEntry {
+    unit: string;
+    kind: DoseUnitKind;
+    aliases?: string[];
+    /**
+     * Defaults to true. Use false for terminology entries such as infusion-rate
+     * units that should be exposed to consumers but must not be accepted as a
+     * doseQuantity unit until rateQuantity parsing is implemented.
+     */
+    parseAsDose?: boolean;
+    approximateQuantity?: DoseUnitApproximation;
+}
+export interface DoseUnitSemantics {
+    unit: string;
+    kind: DoseUnitKind;
+    parseAsDose?: boolean;
+    approximateQuantity?: DoseUnitApproximation;
+}
+export interface EstimatedQuantity extends FhirQuantity {
+    confidence?: DoseUnitApproximationConfidence;
+    basis?: string;
+    source?: string;
+}
 export interface FhirRange {
     low?: FhirQuantity;
     high?: FhirQuantity;
@@ -316,6 +348,18 @@ export interface MedicationContext {
     strengthQuantity?: FhirQuantity;
     strengthRatio?: FhirRatio;
     strengthCodeableConcept?: FhirCodeableConcept;
+    /**
+     * Canonical presentation/package unit for fractional package instructions
+     * such as "1/2 bottle". When the parsed dose unit matches this value,
+     * containerValue/containerUnit describe the inner amount held by one package.
+     */
+    packageUnit?: string;
+    /**
+     * Optional per-unit approximation overrides keyed by normalized dose unit
+     * (for example FTU, drop, pump, applicatorful). These are used only for
+     * estimated amount reporting; they do not rewrite the parsed dose unit.
+     */
+    unitApproximationMap?: Record<string, DoseUnitApproximation>;
     containerValue?: number;
     containerUnit?: string;
     defaultUnit?: string;
@@ -799,6 +843,8 @@ export interface ParseResult {
 export interface ParseNormalizedMeta {
     route?: RouteCode;
     unit?: string;
+    unitKind?: DoseUnitKind;
+    unitSemantics?: DoseUnitSemantics;
     site?: BodySiteDetail;
     method?: {
         text?: string;
@@ -939,6 +985,9 @@ export interface NextDueDoseOptions {
 export interface TotalUnitsResult {
     totalUnits: number;
     totalContainers?: number;
+    totalContainerQuantity?: FhirQuantity;
+    totalApproximateQuantity?: EstimatedQuantity;
+    totalApproximateIngredientQuantity?: EstimatedQuantity;
 }
 export interface TotalUnitsOptions extends NextDueDoseOptions {
     dosage: FhirDosage | FhirDosage[];

package/dist/unit-lexicon.d.ts

@@ -1,4 +1,8 @@
-import { ParseOptions } from "./types";
+import type { DoseUnitApproximation, DoseUnitKind, DoseUnitSemantics, DoseUnitTerminologyEntry, MedicationContext, ParseOptions } from "./types";
 export declare function normalizeUnit(token: string, options?: ParseOptions): string | undefined;
+export declare function getDoseUnitKind(unit: string | undefined): DoseUnitKind | undefined;
+export declare function getDoseUnitApproximation(unit: string | undefined, context?: MedicationContext | null): DoseUnitApproximation | undefined;
+export declare function getDoseUnitSemantics(unit: string | undefined, context?: MedicationContext | null): DoseUnitSemantics | undefined;
+export declare function listDoseUnitTerminology(): DoseUnitTerminologyEntry[];
 export declare function enforceHouseholdUnitPolicy(unit: string | undefined, options?: ParseOptions): string | undefined;
 export declare function isDiscreteUnit(unit: string): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ezmedicationinput",
-  "version": "0.1.46",
+  "version": "0.1.47",
   "description": "Parse concise medication sigs into FHIR R5 Dosage JSON",
   "type": "module",
   "main": "./dist/index.cjs",