ezmedicationinput 0.1.42 → 0.1.44

package/dist/parser-state.d.ts

@@ -0,0 +1,101 @@
+import { AnnotatedLexToken } from "./lexer/meaning";
+import { CanonicalAdditionalInstructionExpr, CanonicalDoseRange, CanonicalPrnReasonExpr, CanonicalSigClause, EventTiming, FhirCoding, FhirDayOfWeek, FhirPrimitiveElement, FhirPeriodUnit, PrnReasonLookupRequest, PrnReasonSuggestion, RouteCode, SiteCodeLookupRequest, SiteCodeSuggestion } from "./types";
+export interface SiteLookupDetail {
+    request: SiteCodeLookupRequest;
+    suggestions: SiteCodeSuggestion[];
+}
+export interface PrnReasonLookupDetail {
+    request: PrnReasonLookupRequest;
+    suggestions: PrnReasonSuggestion[];
+}
+export interface Token extends AnnotatedLexToken {
+}
+type LocalizedCoding = FhirCoding & {
+    i18n?: Record<string, string>;
+};
+export declare class ParserState {
+    input: string;
+    tokens: Token[];
+    consumed: Set<number>;
+    warnings: string[];
+    siteTokenIndices: Set<number>;
+    siteLookupRequest?: SiteCodeLookupRequest;
+    siteLookups: SiteLookupDetail[];
+    customSiteHints?: Set<string>;
+    prnReasonLookupRequest?: PrnReasonLookupRequest;
+    prnReasonLookups: PrnReasonLookupDetail[];
+    methodVerb?: string;
+    productFormKey?: string;
+    clauses: CanonicalSigClause[];
+    private clause;
+    constructor(input: string, tokens: Token[], customSiteHints?: Set<string>);
+    get primaryClause(): CanonicalSigClause;
+    get dose(): number | undefined;
+    set dose(value: number | undefined);
+    get doseRange(): CanonicalDoseRange | undefined;
+    set doseRange(value: CanonicalDoseRange | undefined);
+    get unit(): string | undefined;
+    set unit(value: string | undefined);
+    get routeCode(): RouteCode | undefined;
+    set routeCode(value: RouteCode | undefined);
+    get routeText(): string | undefined;
+    set routeText(value: string | undefined);
+    get methodText(): string | undefined;
+    set methodText(value: string | undefined);
+    get methodTextElement(): FhirPrimitiveElement | undefined;
+    set methodTextElement(value: FhirPrimitiveElement | undefined);
+    get methodCoding(): LocalizedCoding | undefined;
+    set methodCoding(value: LocalizedCoding | undefined);
+    get count(): number | undefined;
+    set count(value: number | undefined);
+    get duration(): number | undefined;
+    set duration(value: number | undefined);
+    get durationMax(): number | undefined;
+    set durationMax(value: number | undefined);
+    get durationUnit(): FhirPeriodUnit | undefined;
+    set durationUnit(value: FhirPeriodUnit | undefined);
+    get frequency(): number | undefined;
+    set frequency(value: number | undefined);
+    get frequencyMax(): number | undefined;
+    set frequencyMax(value: number | undefined);
+    get period(): number | undefined;
+    set period(value: number | undefined);
+    get periodMax(): number | undefined;
+    set periodMax(value: number | undefined);
+    get periodUnit(): FhirPeriodUnit | undefined;
+    set periodUnit(value: FhirPeriodUnit | undefined);
+    get dayOfWeek(): FhirDayOfWeek[];
+    get when(): EventTiming[];
+    get timeOfDay(): string[] | undefined;
+    set timeOfDay(value: string[] | undefined);
+    get timingCode(): string | undefined;
+    set timingCode(value: string | undefined);
+    get asNeeded(): boolean | undefined;
+    set asNeeded(value: boolean | undefined);
+    get asNeededReason(): string | undefined;
+    set asNeededReason(value: string | undefined);
+    get asNeededReasons(): CanonicalPrnReasonExpr[] | undefined;
+    set asNeededReasons(value: CanonicalPrnReasonExpr[] | undefined);
+    get asNeededReasonCoding(): LocalizedCoding | undefined;
+    set asNeededReasonCoding(value: LocalizedCoding | undefined);
+    get siteText(): string | undefined;
+    set siteText(value: string | undefined);
+    get siteSource(): "abbreviation" | "text" | "selection" | "resolver" | undefined;
+    set siteSource(value: "abbreviation" | "text" | "selection" | "resolver" | undefined);
+    get siteCoding(): LocalizedCoding | undefined;
+    set siteCoding(value: LocalizedCoding | undefined);
+    get additionalInstructions(): CanonicalAdditionalInstructionExpr[];
+    set additionalInstructions(value: CanonicalAdditionalInstructionExpr[]);
+    get patientInstruction(): string | undefined;
+    set patientInstruction(value: string | undefined);
+    private ensureDose;
+    private ensureRoute;
+    private ensureSite;
+    private ensureMethod;
+    private ensureSchedule;
+    private ensurePrn;
+    private cleanupPrn;
+    private cleanupSite;
+    private cleanupMethod;
+}
+export {};

package/dist/parser-state.js

@@ -0,0 +1,441 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParserState = void 0;
+const fhir_translations_1 = require("./fhir-translations");
+class ParserState {
+    constructor(input, tokens, customSiteHints) {
+        const dayOfWeek = [];
+        const when = [];
+        this.clause = {
+            kind: "administration",
+            rawText: input,
+            raw: {
+                start: 0,
+                end: input.length,
+                text: input
+            },
+            schedule: {
+                dayOfWeek,
+                when
+            },
+            leftovers: [],
+            evidence: [],
+            confidence: 1
+        };
+        this.input = input;
+        this.tokens = tokens;
+        this.consumed = new Set();
+        this.warnings = [];
+        this.siteTokenIndices = new Set();
+        this.siteLookups = [];
+        this.customSiteHints = customSiteHints;
+        this.prnReasonLookups = [];
+        this.clauses = [this.clause];
+    }
+    get primaryClause() {
+        return this.clause;
+    }
+    get dose() {
+        var _a;
+        return (_a = this.clause.dose) === null || _a === void 0 ? void 0 : _a.value;
+    }
+    set dose(value) {
+        this.ensureDose().value = value;
+    }
+    get doseRange() {
+        var _a;
+        return (_a = this.clause.dose) === null || _a === void 0 ? void 0 : _a.range;
+    }
+    set doseRange(value) {
+        this.ensureDose().range = value;
+    }
+    get unit() {
+        var _a;
+        return (_a = this.clause.dose) === null || _a === void 0 ? void 0 : _a.unit;
+    }
+    set unit(value) {
+        this.ensureDose().unit = value;
+    }
+    get routeCode() {
+        var _a;
+        return (_a = this.clause.route) === null || _a === void 0 ? void 0 : _a.code;
+    }
+    set routeCode(value) {
+        this.ensureRoute().code = value;
+    }
+    get routeText() {
+        var _a;
+        return (_a = this.clause.route) === null || _a === void 0 ? void 0 : _a.text;
+    }
+    set routeText(value) {
+        this.ensureRoute().text = value;
+    }
+    get methodText() {
+        var _a;
+        return (_a = this.clause.method) === null || _a === void 0 ? void 0 : _a.text;
+    }
+    set methodText(value) {
+        if (value === undefined) {
+            if (this.clause.method) {
+                delete this.clause.method.text;
+                this.cleanupMethod();
+            }
+            return;
+        }
+        this.ensureMethod().text = value;
+    }
+    get methodTextElement() {
+        var _a;
+        return (_a = this.clause.method) === null || _a === void 0 ? void 0 : _a._text;
+    }
+    set methodTextElement(value) {
+        if (value === undefined) {
+            if (this.clause.method) {
+                delete this.clause.method._text;
+                this.cleanupMethod();
+            }
+            return;
+        }
+        this.ensureMethod()._text = (0, fhir_translations_1.clonePrimitiveElement)(value);
+    }
+    get methodCoding() {
+        var _a;
+        return (_a = this.clause.method) === null || _a === void 0 ? void 0 : _a.coding;
+    }
+    set methodCoding(value) {
+        if (value === undefined) {
+            if (this.clause.method) {
+                delete this.clause.method.coding;
+                this.cleanupMethod();
+            }
+            return;
+        }
+        this.ensureMethod().coding = (value === null || value === void 0 ? void 0 : value.code)
+            ? {
+                code: value.code,
+                display: value.display,
+                system: value.system,
+                _display: (0, fhir_translations_1.clonePrimitiveElement)(value._display),
+                i18n: value.i18n
+            }
+            : undefined;
+    }
+    get count() {
+        var _a;
+        return (_a = this.clause.schedule) === null || _a === void 0 ? void 0 : _a.count;
+    }
+    set count(value) {
+        this.ensureSchedule().count = value;
+    }
+    get duration() {
+        var _a;
+        return (_a = this.clause.schedule) === null || _a === void 0 ? void 0 : _a.duration;
+    }
+    set duration(value) {
+        this.ensureSchedule().duration = value;
+    }
+    get durationMax() {
+        var _a;
+        return (_a = this.clause.schedule) === null || _a === void 0 ? void 0 : _a.durationMax;
+    }
+    set durationMax(value) {
+        this.ensureSchedule().durationMax = value;
+    }
+    get durationUnit() {
+        var _a;
+        return (_a = this.clause.schedule) === null || _a === void 0 ? void 0 : _a.durationUnit;
+    }
+    set durationUnit(value) {
+        this.ensureSchedule().durationUnit = value;
+    }
+    get frequency() {
+        var _a;
+        return (_a = this.clause.schedule) === null || _a === void 0 ? void 0 : _a.frequency;
+    }
+    set frequency(value) {
+        this.ensureSchedule().frequency = value;
+    }
+    get frequencyMax() {
+        var _a;
+        return (_a = this.clause.schedule) === null || _a === void 0 ? void 0 : _a.frequencyMax;
+    }
+    set frequencyMax(value) {
+        this.ensureSchedule().frequencyMax = value;
+    }
+    get period() {
+        var _a;
+        return (_a = this.clause.schedule) === null || _a === void 0 ? void 0 : _a.period;
+    }
+    set period(value) {
+        this.ensureSchedule().period = value;
+    }
+    get periodMax() {
+        var _a;
+        return (_a = this.clause.schedule) === null || _a === void 0 ? void 0 : _a.periodMax;
+    }
+    set periodMax(value) {
+        this.ensureSchedule().periodMax = value;
+    }
+    get periodUnit() {
+        var _a;
+        return (_a = this.clause.schedule) === null || _a === void 0 ? void 0 : _a.periodUnit;
+    }
+    set periodUnit(value) {
+        this.ensureSchedule().periodUnit = value;
+    }
+    get dayOfWeek() {
+        const schedule = this.ensureSchedule();
+        if (!schedule.dayOfWeek) {
+            schedule.dayOfWeek = [];
+        }
+        return schedule.dayOfWeek;
+    }
+    get when() {
+        const schedule = this.ensureSchedule();
+        if (!schedule.when) {
+            schedule.when = [];
+        }
+        return schedule.when;
+    }
+    get timeOfDay() {
+        var _a;
+        return (_a = this.clause.schedule) === null || _a === void 0 ? void 0 : _a.timeOfDay;
+    }
+    set timeOfDay(value) {
+        this.ensureSchedule().timeOfDay = value;
+    }
+    get timingCode() {
+        var _a;
+        return (_a = this.clause.schedule) === null || _a === void 0 ? void 0 : _a.timingCode;
+    }
+    set timingCode(value) {
+        this.ensureSchedule().timingCode = value;
+    }
+    get asNeeded() {
+        var _a;
+        return (_a = this.clause.prn) === null || _a === void 0 ? void 0 : _a.enabled;
+    }
+    set asNeeded(value) {
+        if (value === undefined) {
+            delete this.clause.prn;
+            return;
+        }
+        this.ensurePrn().enabled = value;
+    }
+    get asNeededReason() {
+        var _a, _b;
+        return (_b = (_a = this.clause.prn) === null || _a === void 0 ? void 0 : _a.reason) === null || _b === void 0 ? void 0 : _b.text;
+    }
+    set asNeededReason(value) {
+        var _a, _b;
+        if (value === undefined) {
+            if ((_a = this.clause.prn) === null || _a === void 0 ? void 0 : _a.reason) {
+                delete this.clause.prn.reason.text;
+                this.cleanupPrn();
+            }
+            return;
+        }
+        const prn = (_b = this.clause.prn) !== null && _b !== void 0 ? _b : (this.clause.prn = { enabled: true });
+        if (prn.enabled === undefined) {
+            prn.enabled = true;
+        }
+        if (!prn.reason) {
+            prn.reason = {};
+        }
+        prn.reason.text = value;
+    }
+    get asNeededReasons() {
+        var _a;
+        return (_a = this.clause.prn) === null || _a === void 0 ? void 0 : _a.reasons;
+    }
+    set asNeededReasons(value) {
+        var _a, _b;
+        if (!value || !value.length) {
+            if ((_a = this.clause.prn) === null || _a === void 0 ? void 0 : _a.reasons) {
+                delete this.clause.prn.reasons;
+                this.cleanupPrn();
+            }
+            return;
+        }
+        const prn = (_b = this.clause.prn) !== null && _b !== void 0 ? _b : (this.clause.prn = { enabled: true });
+        if (prn.enabled === undefined) {
+            prn.enabled = true;
+        }
+        const reasons = [];
+        for (const reason of value) {
+            reasons.push({
+                text: reason.text,
+                coding: reason.coding
+                    ? {
+                        code: reason.coding.code,
+                        display: reason.coding.display,
+                        system: reason.coding.system,
+                        _display: (0, fhir_translations_1.clonePrimitiveElement)(reason.coding._display),
+                        i18n: reason.coding.i18n
+                    }
+                    : undefined
+            });
+        }
+        prn.reasons = reasons;
+    }
+    get asNeededReasonCoding() {
+        var _a, _b;
+        return (_b = (_a = this.clause.prn) === null || _a === void 0 ? void 0 : _a.reason) === null || _b === void 0 ? void 0 : _b.coding;
+    }
+    set asNeededReasonCoding(value) {
+        var _a, _b;
+        if (value === undefined) {
+            if ((_a = this.clause.prn) === null || _a === void 0 ? void 0 : _a.reason) {
+                delete this.clause.prn.reason.coding;
+                this.cleanupPrn();
+            }
+            return;
+        }
+        const prn = (_b = this.clause.prn) !== null && _b !== void 0 ? _b : (this.clause.prn = { enabled: true });
+        if (prn.enabled === undefined) {
+            prn.enabled = true;
+        }
+        if (!prn.reason) {
+            prn.reason = {};
+        }
+        prn.reason.coding = (value === null || value === void 0 ? void 0 : value.code)
+            ? {
+                code: value.code,
+                display: value.display,
+                system: value.system,
+                _display: (0, fhir_translations_1.clonePrimitiveElement)(value._display),
+                i18n: value.i18n
+            }
+            : undefined;
+    }
+    get siteText() {
+        var _a;
+        return (_a = this.clause.site) === null || _a === void 0 ? void 0 : _a.text;
+    }
+    set siteText(value) {
+        this.ensureSite().text = value;
+    }
+    get siteSource() {
+        var _a;
+        return (_a = this.clause.site) === null || _a === void 0 ? void 0 : _a.source;
+    }
+    set siteSource(value) {
+        this.ensureSite().source = value;
+    }
+    get siteCoding() {
+        var _a;
+        return (_a = this.clause.site) === null || _a === void 0 ? void 0 : _a.coding;
+    }
+    set siteCoding(value) {
+        if (value === undefined) {
+            if (this.clause.site) {
+                delete this.clause.site.coding;
+                this.cleanupSite();
+            }
+            return;
+        }
+        this.ensureSite().coding = (value === null || value === void 0 ? void 0 : value.code)
+            ? {
+                code: value.code,
+                display: value.display,
+                system: value.system,
+                i18n: value.i18n
+            }
+            : undefined;
+    }
+    get additionalInstructions() {
+        if (!this.clause.additionalInstructions) {
+            this.clause.additionalInstructions = [];
+        }
+        return this.clause.additionalInstructions;
+    }
+    set additionalInstructions(value) {
+        this.clause.additionalInstructions = value;
+    }
+    get patientInstruction() {
+        return this.clause.patientInstruction;
+    }
+    set patientInstruction(value) {
+        this.clause.patientInstruction = value;
+    }
+    ensureDose() {
+        if (!this.clause.dose) {
+            this.clause.dose = {};
+        }
+        return this.clause.dose;
+    }
+    ensureRoute() {
+        if (!this.clause.route) {
+            this.clause.route = {};
+        }
+        return this.clause.route;
+    }
+    ensureSite() {
+        if (!this.clause.site) {
+            this.clause.site = {};
+        }
+        return this.clause.site;
+    }
+    ensureMethod() {
+        if (!this.clause.method) {
+            this.clause.method = {};
+        }
+        return this.clause.method;
+    }
+    ensureSchedule() {
+        if (!this.clause.schedule) {
+            this.clause.schedule = {};
+        }
+        return this.clause.schedule;
+    }
+    ensurePrn() {
+        if (!this.clause.prn) {
+            this.clause.prn = { enabled: false };
+        }
+        return this.clause.prn;
+    }
+    cleanupPrn() {
+        var _a;
+        const prn = this.clause.prn;
+        if (!prn) {
+            return;
+        }
+        if (prn.reason &&
+            prn.reason.text === undefined &&
+            prn.reason.coding === undefined) {
+            delete prn.reason;
+        }
+        if (((_a = prn.reasons) === null || _a === void 0 ? void 0 : _a.length) === 0) {
+            delete prn.reasons;
+        }
+        if (prn.enabled === undefined && prn.reason === undefined && prn.reasons === undefined) {
+            delete this.clause.prn;
+        }
+    }
+    cleanupSite() {
+        const site = this.clause.site;
+        if (!site) {
+            return;
+        }
+        if (site.text === undefined &&
+            site.coding === undefined &&
+            site.source === undefined &&
+            site.inferred === undefined &&
+            site.evidence === undefined) {
+            delete this.clause.site;
+        }
+    }
+    cleanupMethod() {
+        const method = this.clause.method;
+        if (!method) {
+            return;
+        }
+        if (method.text === undefined &&
+            method._text === undefined &&
+            method.coding === undefined &&
+            method.evidence === undefined) {
+            delete this.clause.method;
+        }
+    }
+}
+exports.ParserState = ParserState;

package/dist/parser.d.ts

@@ -1,20 +1,20 @@
-import { ParsedSigInternal, Token } from "./internal-types";
+import { ParserState, Token } from "./parser-state";
 import { ParseOptions, TextRange } from "./types";
 export declare function tokenize(input: string): Token[];
-export declare function findUnparsedTokenGroups(internal: ParsedSigInternal): Array<{
+export declare function findUnparsedTokenGroups(internal: ParserState): Array<{
     tokens: Token[];
     range?: TextRange;
 }>;
-export declare function parseInternal(input: string, options?: ParseOptions): ParsedSigInternal;
+export declare function parseClauseState(input: string, options?: ParseOptions): ParserState;
 /**
  * Resolves parsed site text against SNOMED dictionaries and synchronous
  * callbacks, applying the best match to the in-progress parse result.
  */
-export declare function applyPrnReasonCoding(internal: ParsedSigInternal, options?: ParseOptions): void;
-export declare function applyPrnReasonCodingAsync(internal: ParsedSigInternal, options?: ParseOptions): Promise<void>;
-export declare function applySiteCoding(internal: ParsedSigInternal, options?: ParseOptions): void;
+export declare function applyPrnReasonCoding(internal: ParserState, options?: ParseOptions): void;
+export declare function applyPrnReasonCodingAsync(internal: ParserState, options?: ParseOptions): Promise<void>;
+export declare function applySiteCoding(internal: ParserState, options?: ParseOptions): void;
 /**
  * Asynchronous counterpart to {@link applySiteCoding} that awaits resolver and
  * suggestion callbacks so remote terminology services can be used.
  */
-export declare function applySiteCodingAsync(internal: ParsedSigInternal, options?: ParseOptions): Promise<void>;
+export declare function applySiteCodingAsync(internal: ParserState, options?: ParseOptions): Promise<void>;