ezmedicationinput 0.1.45 → 0.1.47

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

@@ -0,0 +1,97 @@
+import { EventTiming, FhirCoding } from "../types";
+type MealRelation = "before" | "after" | "with";
+type MealTimingByRelation = Map<MealRelation, Map<EventTiming, EventTiming>>;
+type BodySiteFeatureKind = "nominal" | "partitive" | "locative";
+type CompoundDoseUnit = {
+    head: string;
+    tails: string[];
+    tailSequences?: string[][];
+    unit: string;
+};
+export declare const SITE_ANCHORS: Set<string>;
+export declare const SITE_SELF_DISPLAY_ANCHORS: Set<string>;
+export declare const SITE_FILLERS: Set<string>;
+export declare const BODY_SITE_LOCATIVE_RELATIONS: Set<string>;
+export declare const BODY_SITE_LOCATIVE_RENDER_PREPOSITIONS: Map<string, string>;
+export declare const BODY_SITE_SPATIAL_RELATION_CODINGS: Map<string, FhirCoding>;
+export declare const BODY_SITE_PARTITIVE_HEADS: Set<string>;
+export declare const BODY_SITE_PARTITIVE_MODIFIERS: Set<string>;
+export declare const BODY_SITE_PARTITIVE_CONNECTORS: Set<string>;
+export declare const BODY_SITE_BARE_NOMINAL_PREFIXES: Set<string>;
+export declare const OTIC_SITE_WORDS: Set<string>;
+export declare const OPHTHALMIC_SITE_WORDS: Set<string>;
+export declare const NASAL_SITE_WORDS: Set<string>;
+export declare const BODY_SITE_ADJECTIVE_SUFFIXES: readonly string[];
+export declare const BODY_SITE_DISPLAY_PENALTY_WORDS: Set<string>;
+export declare const BODY_SITE_FEATURE_SCORE_BONUS: Map<BodySiteFeatureKind, number>;
+export declare const CONNECTORS: Set<string>;
+export declare const ROUTE_SITE_PREPOSITIONS: Set<string>;
+export declare const SITE_DISPLAY_FILLERS: Set<string>;
+export declare const NON_SITE_ANCHORED_PHRASES: Set<string>;
+export declare const EXTERNAL_SITE_LOCATIVE_PREFIXES: Set<string>;
+export declare const ROUTE_BLOCKED_BY_FOLLOWING_PARTITIVE_HEADS: Set<string>;
+export declare const PRN_LEADS: Set<string>;
+export declare const PRN_REASON_LEAD_INS: Set<string>;
+export declare const PRN_STANDALONE_REASON_LEADS: Set<string>;
+export declare const PRN_REASON_MULTIWORD_LEAD_INS: Set<string>;
+export declare const PRN_REASON_SITE_CONNECTORS: Set<string>;
+export declare const PRN_REASON_COORDINATORS: Set<string>;
+export declare const PRN_CONDITIONAL_SITE_BOUNDARY_ANCHORS: Set<string>;
+export declare const PRN_PREDICATE_REASON_NORMALIZATIONS: Map<string, string>;
+export declare const PRN_GENERIC_LOCATED_HEADS: Map<string, string>;
+export declare const PRN_DEFAULT_SITE_CONNECTOR: string;
+export declare const PRN_COMPACT_REASON_SEPARATORS: Set<string>;
+export declare const SITE_ROUTE_HINTS_ALLOWED_IN_GRAMMAR: Set<import("../types").SNOMEDCTRouteCodes>;
+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>;
+export declare const EVERY_INTERVAL_TOKENS_DATA: Set<string>;
+export declare const COUNT_MARKER_TOKENS_DATA: Set<string>;
+export declare const COUNT_CONNECTOR_WORDS_DATA: Set<string>;
+export declare const FREQUENCY_SIMPLE_WORDS_DATA: Record<string, number>;
+export declare const FREQUENCY_NUMBER_WORDS_DATA: Record<string, number>;
+export declare const FREQUENCY_TIMES_WORDS_DATA: Set<string>;
+export declare const FREQUENCY_CONNECTOR_WORDS_DATA: Set<string>;
+export declare const FREQUENCY_ADVERB_UNITS_DATA: Map<string, string>;
+export declare const INTERVAL_UNIT_TOKENS_DATA: Map<string, string>;
+export declare const WORKFLOW_START_WORDS: Set<string>;
+export declare const WORKFLOW_NOUNS: Set<string>;
+export declare const ANTE_MERIDIEM_TOKENS: Set<string>;
+export declare const POST_MERIDIEM_TOKENS: Set<string>;
+export declare const MERIDIEM_TOKENS: Set<string>;
+export declare const LIST_SEPARATORS: Set<string>;
+export declare const MEDICATION_OBJECT_FILLERS: Set<string>;
+export declare const CLOCK_LEAD_TOKENS: Set<string>;
+export declare const EVENT_PREPOSITIONS: Set<string>;
+export declare const EVENT_ARTICLE_TOKENS: Set<string>;
+export declare const FIXED_EVENT_PHRASES: Map<string, EventTiming>;
+export declare const MEAL_RELATION_BY_TOKEN: Map<string, MealRelation>;
+export declare const MEAL_TIMING_BY_RELATION: MealTimingByRelation;
+export declare const SLEEP_EVENT_ALIASES: Set<string>;
+export declare const WAKE_EVENT_ALIASES: Set<string>;
+export declare const FOOD_EVENT_ALIASES: Set<string>;
+export declare const DAY_RANGE_CONNECTORS: Set<string>;
+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>;
+export declare const EYE_SITE_ABBREVIATIONS: Set<string>;
+export declare const NON_OCULAR_DOSE_UNITS: Set<string>;
+export declare const OCULAR_ROUTE_CODES: Set<import("../types").SNOMEDCTRouteCodes>;
+export declare const HARD_SEGMENT_BOUNDARY_TOKENS: Set<string>;
+export declare const CLAUSE_LEAD_WORDS: Set<string>;
+export declare const LATERAL_MODIFIER_WORDS: Set<string>;
+export {};

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

@@ -0,0 +1,15 @@
+import { FhirCoding } from "../types";
+export declare enum MethodAction {
+    Administer = "administer",
+    Apply = "apply",
+    Inhale = "inhale",
+    Inject = "inject",
+    Insert = "insert",
+    Instill = "instill",
+    Spray = "spray",
+    Swallow = "swallow",
+    Wash = "wash"
+}
+export declare const METHOD_ACTION_BY_VERB: Record<string, MethodAction>;
+export declare const METHOD_CODING_BY_ACTION: Record<MethodAction, FhirCoding>;
+export declare function cloneMethodCoding(coding: FhirCoding | undefined): FhirCoding | undefined;

package/dist/hpsg/projection.d.ts

@@ -0,0 +1,12 @@
+import { ParserState, Token } from "../parser-state";
+import { EventTiming, FhirDayOfWeek, RouteCode } from "../types";
+import { HpsgSign } from "./signature";
+export interface HpsgProjectionDeps {
+    addDayOfWeekList: (state: ParserState, days: FhirDayOfWeek[]) => void;
+    addWhen: (target: EventTiming[], whenCode: EventTiming) => void;
+    markToken: (state: ParserState, token: Token) => void;
+    recordEvidence: (state: ParserState, rule: string, startIndex: number, endIndex: number) => void;
+    refreshMethodSurface: (state: ParserState) => void;
+    setRoute: (state: ParserState, code: RouteCode, text?: string) => void;
+}
+export declare function projectHpsgSignToState(sign: HpsgSign, state: ParserState, tokens: Token[], deps: HpsgProjectionDeps): void;

package/dist/hpsg/rule-context.d.ts

@@ -0,0 +1,32 @@
+import { Token, ParserState } from "../parser-state";
+import { ParseOptions } from "../types";
+import { HpsgLexicalRule } from "./signature";
+import { HpsgProjectionDeps } from "./projection";
+import { HpsgUnificationContext } from "./unification";
+export interface HpsgClauseContext {
+    state: ParserState;
+    tokens: Token[];
+    options?: ParseOptions;
+    limit: number;
+    deps: HpsgProjectionDeps & HpsgUnificationContext;
+    project?: boolean;
+}
+export declare function normalizeTokenLower(token: Token): string;
+export declare function isPunctuation(lower: string): boolean;
+export declare function isClockLikeLower(lower: string): boolean;
+export declare function isAmPmLower(lower: string): boolean;
+export declare function isAnteMeridiemLower(lower: string): boolean;
+export declare function isPostMeridiemLower(lower: string): boolean;
+export declare function parseClockToken(token: Token | undefined, meridiemToken?: Token | undefined): {
+    value: string;
+    tokens: Token[];
+} | undefined;
+export declare function tokensAvailable(context: HpsgClauseContext, start: number, span: number): Token[] | undefined;
+export declare function rangeFromTokens(tokens: Token[]): {
+    start: number;
+    end: number;
+} | undefined;
+export declare function splitByLexicalSeparators(text: string, separators: ReadonlySet<string>): string[];
+export declare function hasLexicalSeparator(text: string, separators: ReadonlySet<string>): boolean;
+export declare function joinTokenText(tokens: Token[]): string;
+export declare function lexicalRule(id: string, match: HpsgLexicalRule<HpsgClauseContext>["match"]): HpsgLexicalRule<HpsgClauseContext>;

package/dist/hpsg/rules/core-rules.d.ts

@@ -0,0 +1,8 @@
+import { HpsgClauseContext } from "../rule-context";
+import { HpsgLexicalRule } from "../signature";
+export declare function methodLexicalRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function routeLexicalRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function fillerLexicalRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function productLexicalRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function doseLexicalRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function connectorLexicalRule(): HpsgLexicalRule<HpsgClauseContext>;

package/dist/hpsg/rules/instruction-rules.d.ts

@@ -0,0 +1,4 @@
+import { HpsgClauseContext } from "../rule-context";
+import { HpsgLexicalRule } from "../signature";
+export declare function workflowLexicalRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function instructionLexicalRule(): HpsgLexicalRule<HpsgClauseContext>;

package/dist/hpsg/rules/prn-rules.d.ts

@@ -0,0 +1,3 @@
+import { HpsgClauseContext } from "../rule-context";
+import { HpsgLexicalRule } from "../signature";
+export declare function prnLexicalRule(): HpsgLexicalRule<HpsgClauseContext>;

package/dist/hpsg/rules/product-route.d.ts

@@ -0,0 +1,2 @@
+import { RouteCode } from "../../types";
+export declare function productRouteHint(phrase: string | undefined): RouteCode | undefined;

package/dist/hpsg/rules/site-rules.d.ts

@@ -0,0 +1,4 @@
+import { HpsgClauseContext } from "../rule-context";
+import { HpsgLexicalRule } from "../signature";
+export declare function siteLexicalRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function bareSiteLexicalRule(): HpsgLexicalRule<HpsgClauseContext>;

package/dist/hpsg/rules/timing-rules.d.ts

@@ -0,0 +1,12 @@
+import { HpsgClauseContext } from "../rule-context";
+import { HpsgLexicalRule } from "../signature";
+export declare function multiplicativeDoseFrequencyRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function compactIntervalRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function separatedIntervalRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function countFrequencyRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function timingLexicalRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function eventTimingPhraseRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function dayRangeLexicalRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function countAndDurationRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function timeOfDayRule(): HpsgLexicalRule<HpsgClauseContext>;
+export declare function isScheduleLead(context: HpsgClauseContext, index: number): boolean;

package/dist/hpsg/segmenter.d.ts

@@ -0,0 +1,6 @@
+export interface HpsgSigSegment {
+    text: string;
+    start: number;
+    end: number;
+}
+export declare function parseSigSegments(input: string): HpsgSigSegment[];

package/dist/hpsg/signature.d.ts

@@ -0,0 +1,116 @@
+import { CanonicalDoseRange, CanonicalAdditionalInstructionExpr, BodySiteSpatialRelation, EventTiming, FhirCoding, FhirDayOfWeek, FhirPeriodUnit, FhirPrimitiveElement, RouteCode, PrnReasonLookupRequest, SiteCodeLookupRequest } from "../types";
+import { Token } from "../parser-state";
+export type HpsgType = "sign" | "word-sign" | "phrase-sign" | "clause-sign" | "method-sign" | "route-sign" | "site-sign" | "dose-sign" | "schedule-sign" | "prn-sign" | "instruction-sign" | "connector-sign";
+export interface HpsgEvidence {
+    rule: string;
+    tokenIndices: number[];
+}
+export interface HpsgMethodFeature {
+    verb: string;
+    text?: string;
+    textElement?: FhirPrimitiveElement;
+    coding?: FhirCoding;
+}
+export interface HpsgRouteFeature {
+    code: RouteCode;
+    text?: string;
+}
+export interface HpsgSiteFeature {
+    text?: string;
+    source?: "abbreviation" | "text" | "selection" | "resolver";
+    coding?: FhirCoding;
+    spatialRelation?: BodySiteSpatialRelation;
+    lookupRequest?: SiteCodeLookupRequest;
+}
+export interface HpsgPrnFeature {
+    enabled: true;
+    reasonText?: string;
+    lookupRequest?: PrnReasonLookupRequest;
+    reasons?: Array<{
+        text: string;
+        lookupRequest?: PrnReasonLookupRequest;
+    }>;
+    lookupRequests?: PrnReasonLookupRequest[];
+}
+export interface HpsgInstructionFeature extends CanonicalAdditionalInstructionExpr {
+}
+export interface HpsgPatientInstructionFeature {
+    text: string;
+}
+export interface HpsgDoseFeature {
+    value?: number;
+    range?: CanonicalDoseRange;
+    unit?: string;
+}
+export interface HpsgScheduleFeature {
+    timingCode?: string;
+    count?: number;
+    duration?: number;
+    durationMax?: number;
+    durationUnit?: FhirPeriodUnit;
+    frequency?: number;
+    frequencyMax?: number;
+    period?: number;
+    periodMax?: number;
+    periodUnit?: FhirPeriodUnit;
+    when?: EventTiming[];
+    dayOfWeek?: FhirDayOfWeek[];
+    timeOfDay?: string[];
+}
+export interface HpsgSynsem {
+    head: {
+        method?: HpsgMethodFeature;
+        route?: HpsgRouteFeature;
+        dose?: HpsgDoseFeature;
+        schedule?: HpsgScheduleFeature;
+    };
+    valence: {
+        site?: HpsgSiteFeature;
+        prn?: HpsgPrnFeature;
+        instructions?: HpsgInstructionFeature[];
+        patientInstruction?: HpsgPatientInstructionFeature;
+    };
+    cont: {
+        clauseKind?: "administration";
+    };
+}
+export interface HpsgSign {
+    type: HpsgType;
+    span: {
+        start: number;
+        end: number;
+    };
+    tokens: Token[];
+    synsem: HpsgSynsem;
+    consumedTokenIndices: number[];
+    siteTokenIndices?: number[];
+    warnings?: string[];
+    evidence: HpsgEvidence[];
+    score: number;
+}
+export interface HpsgLexicalRule<TContext> {
+    id: string;
+    type: HpsgType;
+    match(context: TContext, start: number): HpsgSign[];
+}
+export interface HpsgPhraseRule<TContext> {
+    id: string;
+    left?: HpsgType;
+    right?: HpsgType;
+    combine(context: TContext, left: HpsgSign, right: HpsgSign): HpsgSign | undefined;
+}
+export interface HpsgGrammar<TContext> {
+    lexicalRules: HpsgLexicalRule<TContext>[];
+    phraseRules: HpsgPhraseRule<TContext>[];
+}
+export declare function emptySynsem(): HpsgSynsem;
+export declare function lexicalSign(args: {
+    type: HpsgType;
+    rule: string;
+    tokens: Token[];
+    synsem: HpsgSynsem;
+    consumedTokenIndices?: number[];
+    siteTokenIndices?: number[];
+    warnings?: string[];
+    score?: number;
+}): HpsgSign;

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

@@ -0,0 +1,31 @@
+import { ParserState } from "../parser-state";
+import { FhirPeriodUnit } from "../types";
+import { HpsgScheduleFeature } from "./signature";
+export declare const EVERY_INTERVAL_TOKENS: Set<string>;
+export declare const COUNT_MARKER_TOKENS: Set<string>;
+export declare const COUNT_CONNECTOR_WORDS: Set<string>;
+export declare const FREQUENCY_SIMPLE_WORDS: Record<string, number>;
+export declare const FREQUENCY_NUMBER_WORDS: Record<string, number>;
+export declare const FREQUENCY_TIMES_WORDS: Set<string>;
+export declare const FREQUENCY_CONNECTOR_WORDS: Set<string>;
+export declare function normalizePeriodValue(value: number, unit: FhirPeriodUnit): {
+    value: number;
+    unit: FhirPeriodUnit;
+};
+export declare function normalizePeriodRange(low: number, high: number, unit: FhirPeriodUnit): {
+    low: number;
+    high: number;
+    unit: FhirPeriodUnit;
+};
+export declare function periodUnitSuffix(unit: FhirPeriodUnit): string | undefined;
+export declare function applyPeriod(internal: ParserState, period: number, unit: FhirPeriodUnit): void;
+export declare function buildPeriodScheduleFeature(period: number, unit: FhirPeriodUnit): HpsgScheduleFeature;
+export declare function mapIntervalUnit(token: string): FhirPeriodUnit.Minute | FhirPeriodUnit.Hour | FhirPeriodUnit.Day | FhirPeriodUnit.Week | FhirPeriodUnit.Month | undefined;
+export declare function mapFrequencyAdverb(token: string): FhirPeriodUnit | undefined;
+export declare function parseNumericRange(token: string): {
+    low: number;
+    high: number;
+} | undefined;
+export declare function normalizeCountLimitValue(value: number | undefined): number | undefined;
+export declare function applyDurationLimit(internal: ParserState, value: number | undefined, unit: FhirPeriodUnit | undefined, max?: number): boolean;
+export declare function buildDurationScheduleFeature(value: number | undefined, unit: FhirPeriodUnit | undefined, max?: number): HpsgScheduleFeature | undefined;

package/dist/hpsg/unification.d.ts

@@ -0,0 +1,8 @@
+import { HpsgSign, HpsgSynsem } from "./signature";
+import { RouteCode } from "../types";
+export interface HpsgUnificationContext {
+    normalizeSiteText(text: string): string;
+    isCompatibleRouteRefinement(current: RouteCode | undefined, next: RouteCode): boolean;
+}
+export declare function unifySynsem(left: HpsgSynsem, right: HpsgSynsem, context: HpsgUnificationContext): HpsgSynsem | undefined;
+export declare function combineSigns(left: HpsgSign, right: HpsgSign, context: HpsgUnificationContext, rule: string): HpsgSign | undefined;