ezmedicationinput 0.1.46 → 0.1.47

package/README.md

@@ -725,6 +725,35 @@ const result = calculateTotalUnits({
 
 It can also handle strength-based conversions (e.g. calculating how many 100mL bottles are needed for a 500mg TID dose of a 250mg/5mL suspension).
 
+Natural SIG units are classified from `unit-terminology.json` instead of being treated as one physics-style unit enum. Parsed results expose `meta.normalized.unitKind` / `unitSemantics`, and callers can inspect the same vocabulary with `listDoseUnitTerminology()` or `getDoseUnitSemantics(unit)`.
+
+```ts
+const parsed = parseSig("apply 2 FTU to face twice daily");
+
+calculateTotalUnits({
+  dosage: parsed.fhir,
+  from: "2024-01-01T08:00:00Z",
+  durationValue: 7,
+  durationUnit: "d",
+  timeZone: "Asia/Bangkok"
+});
+
+// → { totalUnits: 28, totalApproximateQuantity: { value: 14, unit: "g", ... } }
+```
+
+Built-in approximations are intentionally conservative and overridable. Current defaults include `FTU -> 0.5 g`, `drop -> 0.05 mL`, `pea-sized amount -> 0.25 mL`, and `shot glass -> 29.5735 mL`; product/device-specific labels should pass `context.unitApproximationMap` when a better value is known. Package-level phrases such as `half bottle` can also be bridged to the inner amount by setting `context.packageUnit`, `containerValue`, and `containerUnit`.
+
+The terminology layer also classifies non-metric SIG units that should not be blindly converted:
+
+- `body_area_proxy`: `palm`, `handprint`, `% BSA`
+- `product_specific_amount`: `pea-sized amount`, `shot glass`, `finger length`, `dropperful`, `applicatorful`, `capful`, `scoop`
+- `device_actuation`: `puff`, `spray`, `pump`, `actuation`, `click`
+- `length_of_product`: `cm ribbon`, `inch ribbon`, `cm strip`, `cm line`, `inch line`
+- `counted_presentation`: `patch`, `ring`, `vial`, `ampule`, `nebule`, `respule`, `packet`, `sachet`, `stick-pack`, and similar package/presentation units
+- `infusion_rate`: `drop/min` / `gtt/min`, exposed as terminology but not parsed as `doseQuantity` until rate parsing and drop-factor conversion are modeled
+
+`calculateTotalUnits` counts presentation units such as patches and rings as discrete administrations. It does not invent gram/mL conversions for puffs, pumps, applicatorfuls, capfuls, ribbons, body-area proxies, clicks, or release-rate products unless the caller supplies product-specific context.
+
 ### Strength parsing
 
 Use `parseStrength` to normalize medication strength strings into FHIR-compliant **Quantity** or **Ratio** structures. It understands percentages, ratios, and composite strengths.

package/dist/advice.d.ts

@@ -13,4 +13,13 @@ export interface AdviceParseContext {
 }
 export declare function parseAdditionalInstructions(sourceText: string, span: TextRange, context?: AdviceParseContext): ParsedAdditionalInstruction[];
 export declare function findAdditionalInstructionDefinitionByCoding(system: string, code: string): AdditionalInstructionDefinition | undefined;
+export declare const __test__: {
+    createDefinitionFromSource(source: {
+        system?: string;
+        code: string;
+        display: string;
+        text: string;
+        thai: string;
+    }): AdditionalInstructionDefinition;
+};
 export declare function buildAdditionalInstructionFramesFromCoding(system: string, code: string, sourceText?: string, span?: TextRange): AdviceFrame[] | undefined;

package/dist/hpsg/lexical-classes.d.ts

@@ -5,6 +5,7 @@ type BodySiteFeatureKind = "nominal" | "partitive" | "locative";
 type CompoundDoseUnit = {
     head: string;
     tails: string[];
+    tailSequences?: string[][];
     unit: string;
 };
 export declare const SITE_ANCHORS: Set<string>;
@@ -44,6 +45,12 @@ export declare const SITE_ROUTE_HINTS_ALLOWED_IN_GRAMMAR: Set<import("../types")
 export declare const PRODUCT_METHOD_TEXT: Record<string, Partial<Record<string, string>>>;
 export declare const PRODUCT_METHOD_THAI: Record<string, string>;
 export declare const COMPOUND_DOSE_UNITS: CompoundDoseUnit[];
+export declare const IMPLICIT_SINGLE_DOSE_UNITS: Set<string>;
+export declare const PERCENT_BODY_AREA_UNITS: Map<string, string>;
+export declare const DOSE_FRACTION_WORDS: Map<string, number>;
+export declare const DOSE_FRACTION_DENOMINATOR_WORDS: Map<string, number>;
+export declare const DOSE_NUMBER_WORDS: Map<string, number>;
+export declare const DOSE_UNIT_CONNECTORS: Set<string>;
 export declare const MILLION_DOSE_MULTIPLIER_TOKENS: Set<string>;
 export declare const SCHEDULE_UNIT_SEPARATOR_TOKENS: Set<string>;
 export declare const COMPACT_LIST_SEPARATORS: Set<string>;
@@ -77,6 +84,7 @@ export declare const RANGE_CONNECTORS: Set<string>;
 export declare const DURATION_LEAD_TOKENS: Set<string>;
 export declare const INSTRUCTION_LEADING_SEPARATORS: Set<string>;
 export declare const INSTRUCTION_START_WORDS: Set<string>;
+export declare const SITE_TRAILING_INSTRUCTION_WORDS: Set<string>;
 export declare const WORKFLOW_CONTINUATION_LICENSES: Set<string>;
 export declare const AS_NEEDED_LEAD_PHRASES: Set<string>;
 export declare const PRN_BREAKING_COORDINATORS: Set<string>;

package/dist/hpsg/method-lexicon.d.ts

@@ -2,6 +2,8 @@ import { FhirCoding } from "../types";
 export declare enum MethodAction {
     Administer = "administer",
     Apply = "apply",
+    Inhale = "inhale",
+    Inject = "inject",
     Insert = "insert",
     Instill = "instill",
     Spray = "spray",