mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-17 15:42:24 +00:00
Dose bank
- DRUG_UNIT learns мг / мкг / мл / ЕД / МЕ, so "2,4 мг" anchors a dose again.
- The bank matches verb-first Russian word order too ("принимайте 2 таблетки",
"пропустите дозу метформина", "начните с 5 мг"), and the Cyrillic drug names
people actually see on the box; the deferral words ("спросите врача",
"как назначено") stand those shapes down.
Cyrillic-safe regexes
- \w and \b are ASCII in JavaScript: every stem in the ru bank and in
population-norms/ru.ts is [а-яё]*, and the word edges are lookarounds
(?<![а-яёa-z]), so «высокий риск» and «нормальный диапазон» match again.
- coach-prose-grounding: Russian month names in the genitive, a space as the
thousands separator in parseLocaleNumber and numFrag, and Cyrillic-safe
edges around the written-date pattern.
Registered everywhere a locale has to be
- targetLanguageName() returns "Russian", so the coach, the period narrative
and the document descriptions stop saying "write in English".
- i18n-key-tool.mjs, split-description.mjs, LOINC name normalisation (it
stripped Cyrillic, so no Russian lab name resolved), HOST_TLDS (ru/by/kz/ua),
no-key-fallbacks (32 tables), country-label, the AUDIT-C standard drink.
- docs/api/openapi.yaml regenerated.
Questionnaires
- The PHQ-9 / GAD-7 source comments no longer claim no validated Russian
version exists (Zolotareva 2023; Pfizer's official screeners).
- WHO-5 items are gender-neutral: «чувствовал(а)».
- "body fat" and "fat mass" both read «Жировая масса»; body fat is now
«Процент жировой массы», which is what the two metrics measure.
Tests
- ru in the 13 locale tables, plus mood, onboarding, instruments, clinician
view, status summary, describe screen, citation coverage and LOINC.
- i18n-no-dot-separator: the ru bundle is exempt from the dash rule (a spaced
dash is Russian punctuation, not a fragment join); the middle dot still
fails there.
- Two 800-line baselines raised by the 12 and 5 lines this change adds.
pnpm typecheck, pnpm openapi:check and the full suite (36 316 tests) pass.
168 lines
8.0 KiB
TypeScript
168 lines
8.0 KiB
TypeScript
/**
|
||
* What every locale's outbound-screen bank is built from: the dose units, the
|
||
* target-dose shape, the object slot, the generic-name stems, and the shape of
|
||
* a bank. The screen itself is `../outbound-screen.ts`; each language's bank
|
||
* is one module in `./locales/`.
|
||
*/
|
||
|
||
/**
|
||
* Count units — a dose expressed as a number of dosage forms ("2 tablets",
|
||
* "zwei Hübe" written as "2 Hübe", "1 comprimé"). The same forms the
|
||
* medication wizard offers (`src/lib/medications/dose-units.ts`), in every
|
||
* locale the banks cover. Without them "take 3 tablets a day" carried no unit
|
||
* the screen recognised and passed every pattern.
|
||
*/
|
||
export const COUNT_UNIT =
|
||
"(?:tablets?|pills?|capsules?|drops?|puffs?|sprays?|tabletten?|kapseln?|tropfen|hübe|hub|sprühstöße|comprimés?|gélules?|gouttes?|bouffées?|comprimidos?|pastillas?|c[áa]psulas?|gotas?|compress[ae]|pastigli[ae]|gocce|goccia|tabletk[aęiy]|tabletek|kapsułk[aęiy]|kapsułek|krople|kropli|druppels?|pillen|pufjes?|pastilhas?|dr[áa]geas?|jatos?|borrifadas?)";
|
||
|
||
/**
|
||
* Dose units for a target dose a model must never name. Mass and insulin
|
||
* units plus the count forms; `ml` is left out on purpose because
|
||
* "increase your water intake to 2000 ml" is ordinary hydration advice.
|
||
*/
|
||
export const DRUG_UNIT = `(?:mg|mcg|µg|iu|ui|i\\.u\\.|units?|unidades?|unità|unités?|jednostek|jednostki|eenheden|eenheid|ie|i\\.e\\.|einheiten|мкг|мг|мл|ед|ме|${COUNT_UNIT})`;
|
||
|
||
/**
|
||
* Dose units, shared across every locale. The GLP-1 + general oral-dose
|
||
* vocabulary; `ie` / `i.e.` / `einheiten` / `unità` / `jednostk` cover the
|
||
* insulin-unit spellings the locales use (`eenheden` is the Dutch one, `ui`
|
||
* the Portuguese abbreviation of "unidades internacionais").
|
||
*/
|
||
export const DOSE_UNIT = `(?:ml|${DRUG_UNIT})`;
|
||
|
||
/**
|
||
* What may follow a dose unit. A concentration is a lab value, not a dose:
|
||
* "keep your glucose under 140 mg/dL" and "eGFR above 60 ml/min" name no
|
||
* medication, and a bare `\b` let both trip the "try … N mg" pattern. A
|
||
* per-day or per-kilogram rate ("2000 mg/day", "10 mg/kg") IS a dose and still
|
||
* matches. The lookahead also ends a unit that closes on a non-word letter
|
||
* ("unità", "i.e.") where `\b` cannot.
|
||
*/
|
||
export const UNIT_END = "(?!\\w|\\s*\\/\\s*(?:dl|l|min|mmol)\\b)";
|
||
|
||
/**
|
||
* One to four words of object between a change verb and its target — "your
|
||
* metformin", "the evening insulin dose", "votre metformine". The original
|
||
* English pattern accepted only "it" or "your dose" in that slot, so naming the
|
||
* drug ("increase your metformin to 2000 mg") walked past the screen.
|
||
*
|
||
* A word may not be a digit run, a sentence break, a negation (a negated
|
||
* imperative is a warning, not an instruction), a clause joiner, or a
|
||
* dietary noun: "lower your sodium to 1500 mg" and "cut caffeine to 200 mg"
|
||
* are nutrition guidance, not a dose change.
|
||
*/
|
||
export function objectSlot(stopWords: string, maxWords = 4): string {
|
||
return `(?:(?!(?:${stopWords})(?=\\s))[^\\s\\d.?!,;:]+\\s+){0,${maxWords}}?`;
|
||
}
|
||
|
||
/**
|
||
* A count written as a word: "take two tablets", "nimm zwei Tabletten",
|
||
* "prenez deux comprimés", "weź dwie tabletki". The union of every covered
|
||
* locale, because a provider mixes languages. Articles ("a", "un", "eine")
|
||
* are left out on purpose: "take a tablet with food" is an article, not a
|
||
* count, and the "eine Tablette mehr" shape is its own pattern below.
|
||
*/
|
||
export const SPELLED_COUNT =
|
||
"(?:one|two|three|four|five|six|half\\s+an?|zwei|drei|vier|fünf|sechs|eine?n?\\s+halbe|halbe|deux|trois|quatre|cinq|demi|dos|tres|cuatro|cinco|media|due|tre|quattro|cinque|mezza|dwie|dwa|trzy|cztery|pięć|jedn[ąa]|pół|één|twee|drie|vier|vijf|zes|halve|dois|duas|três|quatro|meia|meio)";
|
||
|
||
/** A target dose: a number, a drug unit, and an honest unit end. */
|
||
export const TARGET = `(?:[\\d.,]+\\s*${DRUG_UNIT}${UNIT_END}|(?<![\\w])${SPELLED_COUNT}\\s+${COUNT_UNIT}${UNIT_END})`;
|
||
|
||
/**
|
||
* Word edges for a word that starts or ends in an accented letter. JavaScript's
|
||
* `\b` is defined over ASCII `\w`, so `santé\b` never matches before a space
|
||
* and `\bépisode` never matches after one. These treat the Latin letters with
|
||
* diacritics (U+00C0 to U+024F) as word letters, which is what `\b` was meant
|
||
* to mean.
|
||
*/
|
||
export const WORD_START = "(?<![\\w\\u00C0-\\u024F])";
|
||
export const WORD_END = "(?![\\w\\u00C0-\\u024F])";
|
||
|
||
/** The letters a drug name is spelled with in the Latin-script locales. */
|
||
export const LETTER = "a-zà-ÿąćęłńóśźż";
|
||
|
||
/**
|
||
* Common generic-name stems (INN): ramipril, losartan, bisoprolol,
|
||
* atorvastatin, amlodipine, metformin, semaglutide, apixaban, omeprazole,
|
||
* furosemide, with the Polish spellings ("ramipryl", "atorwastatyna",
|
||
* "semaglutyd") beside the Latin ones. A surface that passes no schedule (a nudge, the document chat)
|
||
* still recognises "skip the amlodipine". Two letters must precede the stem,
|
||
* so "April" is not a drug; the stems are chosen so no everyday word ends in
|
||
* one ("comparing" is why heparin is spelled out rather than stemmed).
|
||
*/
|
||
export const INN_STEM = `(?<![${LETTER}])[${LETTER}]{2,}(?:pril|pryl|sartan|olol|statin|statyn|dipin|dypin|formin|glutid|glutyd|gliflozin|gliptin|xaban|ksaban|prazol|semid)[${LETTER}]{0,4}(?![${LETTER}])|(?<![${LETTER}])(?:enoxa|dalte)?heparin[${LETTER}]{0,4}`;
|
||
|
||
export const ENGINE = "(?:framingham|ascvd|score2|qrisk)";
|
||
|
||
/*
|
||
* Each bank also builds a tighter slot for the shapes that carry no number: an
|
||
* extra / one more / stop imperative. At most two words, and a preposition ends
|
||
* it, so "take an extra minute to log your medication" and "stop worrying about
|
||
* your medication" never reach the medication noun.
|
||
*/
|
||
|
||
/**
|
||
* An elided article ("l'amlodipine", "dell'insulina") may sit in front of a
|
||
* French or Italian medication noun.
|
||
*/
|
||
export const ELIDED = "(?:[a-z]{1,4}['’])?";
|
||
|
||
/**
|
||
* What a locale's medication noun accepts beside its dosage-form words: its
|
||
* drug-class words, the generic-name stems (not for Korean, whose script the
|
||
* stems are not written in), and the person's own medication names when the
|
||
* caller passes them.
|
||
*/
|
||
export function medicationExtras(
|
||
medClass: string,
|
||
names: string | null,
|
||
withStems = true,
|
||
): string {
|
||
return [medClass, withStems ? INN_STEM : null, names]
|
||
.filter((part): part is string => part !== null)
|
||
.join("|");
|
||
}
|
||
|
||
/** One language's banks, composed by the screen. */
|
||
export interface LocaleBank {
|
||
/**
|
||
* The medication-noun alternation the dose-change class uses: the
|
||
* dosage-form and treatment words, the generic drug-class words ("Stop your
|
||
* blood thinner" names no dosage form and no drug, and it is the most
|
||
* dangerous stop of all), the generic-name stems, and the person's own
|
||
* medication names when the caller passes them.
|
||
*/
|
||
vocabulary(names: string | null): string;
|
||
/** The dose-change class over that medication noun. */
|
||
doseChangeClass(med: string): readonly RegExp[];
|
||
/** Target-dose prescriptions. */
|
||
dose: readonly RegExp[];
|
||
/** Risk-score fabrication. */
|
||
risk: readonly RegExp[];
|
||
/** Asserted causation (GROUND RULE 12). */
|
||
causal: readonly RegExp[];
|
||
/** A maintenance anchor that may exempt a dose sentence. */
|
||
continuation: RegExp;
|
||
/** A change stem that cancels that exemption. */
|
||
changeStem: RegExp;
|
||
}
|
||
|
||
/**
|
||
* The number-free change shapes (halve it, take half, a bare "reduce your
|
||
* dose") have no unit to anchor them, so they stand down in a sentence that
|
||
* defers or declines: a question, a negation anywhere in it (a trailing
|
||
* "heute nicht" or "vandaag niet" came after the time word the pattern
|
||
* stops at), a restrictive condition ("only if", "nur wenn"), or a
|
||
* clinician named in it ("if your doctor agrees", "ask your pharmacist").
|
||
* `deferral` is the locale's alternation of those signals; it is checked
|
||
* over the whole sentence, which the screen hands in one at a time. The
|
||
* shapes with a stated amount do not stand down: a target dose stays
|
||
* blocked whatever surrounds it.
|
||
*/
|
||
export function unlessDeferred(deferral: string, pattern: RegExp): RegExp {
|
||
return new RegExp(
|
||
`^(?![\\s\\S]*(?:${deferral}))[\\s\\S]*?(?:${pattern.source})`,
|
||
pattern.flags,
|
||
);
|
||
}
|