@precisa-saude/fhir 0.32.0 → 0.33.0

package/dist/cli.js

@@ -124,6 +124,10 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "coracao",
     code: "LDL_Medium",
+    // 96735-6 é "in Serum" só, enquanto as vizinhas LDL_Small (43727-7),
+    // LDL_ParticleNumber (54434-6) e HDL_Large (43729-3) são Ser/Plas. É o
+    // único código para a subfração média, e o perfil por RMN roda em soro.
+    // Material registrado de propósito.
     loinc: "96735-6",
     names: {
       en: ["LDL Medium", "Medium LDL Particles"],
@@ -1091,14 +1095,16 @@ var BIOMARKER_DEFINITIONS = [
   },
   {
     // LOINC 99620-7 = "Omega 3 fatty acids (w3) [Moles/volume] in RBC.lysate".
-    // Alinha à matriz das entradas irmãs Omega3_EPA (75097-6) e Omega3_DHA
-    // (75095-0), ambas em hemácias. Anteriormente 35178-3 (mesmo analito em
-    // Ser/Plas), incompatível com o uso clínico do Índice Ômega-3 (Harris &
-    // von Schacky 2004), que é definido em membranas de hemácias.
-    // Ressalva: LOINC declara moles/volume; o biomarcador armazena %.
-    // Não há LOINC vigente para "Omega 3 total em % em RBC" — o `Omega3_Index`
-    // (88998-0) cobre apenas EPA+DHA. Mantemos `unit: '%'` por consistência
-    // com EPA/DHA (75095-0/75097-6 são [Entitic substance], também não-%).
+    // Anteriormente 35178-3 (mesmo analito em Ser/Plas), incompatível com o
+    // uso clínico do Índice Ômega-3 (Harris & von Schacky 2004), que é
+    // definido em membranas de hemácias.
+    //
+    // Compromisso declarado, e não erro: o LOINC 2.82 não tem código de fração
+    // ("ômega-3 total / ácidos graxos totais") para o total, só para os ácidos
+    // individuais e para EPA+DPA+DHA (90911-9). O componente confere; a
+    // propriedade é moles/volume enquanto o laudo imprime %. O teste de eixos
+    // (`loinc-axes.test.ts`) lista esta entrada como exceção com este motivo.
+    // Mesmo compromisso em `Omega6_Total` (99621-5).
     category: "nutrientes",
     code: "Omega3_Total",
     loinc: "99620-7",
@@ -1112,7 +1118,18 @@ var BIOMARKER_DEFINITIONS = [
     category: "nutrientes",
     code: "Omega3_DHA",
     codeAliases: ["DHA"],
-    loinc: "75095-0",
+    // Ácidos graxos individuais: fração do total (% dos ácidos graxos C14-C22),
+    // que é o que o perfil de ácidos graxos e o Índice Ômega-3 imprimem. Os
+    // códigos vêm do painel 90918-4 ("Fatty acid omega-3 and omega-6 panel -
+    // Blood"), o mesmo de onde já saem as razões AA/EPA (90909-3) e ω6/ω3
+    // (90910-1). Até out/2026 apontavam para os códigos [Entitic substance]
+    // em hemácias (75095-0, 75097-6, 75110-7, 75117-2), que são quantidade por
+    // célula, e para 48371-9, que é moles/volume em soro: componente certo,
+    // propriedade errada nos cinco, desde mar/2026. Ficam como alias porque o
+    // analito é o mesmo. Material: o painel em soro/plasma (88884-2, C14-C24)
+    // existe, e é a troca a fazer se um laboratório imprimir o perfil em soro.
+    loinc: "90914-3",
+    loincAliases: ["75095-0"],
     names: {
       en: ["Omega-3 DHA", "DHA", "Docosahexaenoic Acid"],
       pt: ["\xD4mega-3: DHA", "DHA", "\xC1cido Docosahexaenoico"]
@@ -1123,7 +1140,9 @@ var BIOMARKER_DEFINITIONS = [
     category: "nutrientes",
     code: "Omega3_DPA",
     codeAliases: ["DPA"],
-    loinc: "48371-9",
+    // Fração em sangue, painel 90918-4. Ver `Omega3_DHA`.
+    loinc: "90913-5",
+    loincAliases: ["48371-9"],
     names: {
       en: ["Omega-3 DPA", "DPA", "Docosapentaenoic Acid"],
       pt: ["\xD4mega-3: DPA", "DPA", "\xC1cido Docosapentaenoico"]
@@ -1134,7 +1153,9 @@ var BIOMARKER_DEFINITIONS = [
     category: "nutrientes",
     code: "Omega3_EPA",
     codeAliases: ["EPA"],
-    loinc: "75097-6",
+    // Fração em sangue, painel 90918-4. Ver `Omega3_DHA`.
+    loinc: "90912-7",
+    loincAliases: ["75097-6"],
     names: {
       en: ["Omega-3 EPA", "EPA", "Eicosapentaenoic Acid"],
       pt: ["\xD4mega-3: EPA", "EPA", "\xC1cido Eicosapentaenoico"]
@@ -1144,7 +1165,12 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "nutrientes",
     code: "EPADPADHA",
-    loinc: "90908-5",
+    // 90911-9 é a fração EPA+DPA+DHA / ácidos graxos C14-C22 em sangue, o
+    // valor em %. Até out/2026 apontava para 90908-5, que é a *interpretação*
+    // desse mesmo valor (ordinal: risco alto, moderado, baixo), e não o
+    // número. Sem alias: código ordinal carregando valor numérico é o erro
+    // que se quer parar de aceitar.
+    loinc: "90911-9",
     names: {
       en: ["Omega-3 EPA+DPA+DHA", "EPA+DPA+DHA"],
       pt: ["\xD4mega-3: EPA+DPA+DHA"]
@@ -1165,7 +1191,12 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "nutrientes",
     code: "Omega6_Total",
-    loinc: "35177-5",
+    // 99621-5 é "Omega 6 fatty acids (w6) [Moles/volume] in RBC.lysate", o
+    // par exato do 99620-7 de `Omega3_Total`, com o mesmo compromisso de
+    // propriedade documentado lá. Até out/2026 apontava para 35177-5, que é
+    // ácidos graxos poli-insaturados totais em soro: ômega-3 e ômega-6
+    // somados, outro componente. Sem alias.
+    loinc: "99621-5",
     names: {
       en: ["Omega-6 Total", "Total Omega-6"],
       pt: ["\xD4mega-6 Total"]
@@ -1176,7 +1207,9 @@ var BIOMARKER_DEFINITIONS = [
     category: "nutrientes",
     code: "Omega6_AA",
     codeAliases: ["Arachidonic_Acid"],
-    loinc: "75110-7",
+    // Fração em sangue, painel 90918-4. Ver `Omega3_DHA`.
+    loinc: "90916-8",
+    loincAliases: ["75110-7"],
     names: {
       en: ["Omega-6 Arachidonic Acid", "Arachidonic Acid", "AA"],
       pt: ["\xD4mega-6: \xC1cido Araquid\xF4nico", "\xC1cido Araquid\xF4nico", "AA"]
@@ -1187,7 +1220,9 @@ var BIOMARKER_DEFINITIONS = [
     category: "nutrientes",
     code: "Omega6_LA",
     codeAliases: ["Linoleic_Acid"],
-    loinc: "75117-2",
+    // Fração em sangue, painel 90918-4. Ver `Omega3_DHA`.
+    loinc: "90917-6",
+    loincAliases: ["75117-2"],
     names: {
       en: ["Omega-6 Linoleic Acid", "Linoleic Acid", "LA"],
       pt: ["\xD4mega-6: \xC1cido Linoleico", "\xC1cido Linoleico", "LA"]
@@ -1268,7 +1303,11 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "nutrientes",
     code: "Zinc",
-    loinc: "8245-3",
+    // 5763-8 é "Zinc [Mass/volume] in Serum or Plasma", o zinco sérico da
+    // rotina brasileira (o nome em inglês já dizia "Serum Zinc"). Até out/2026
+    // apontava para 8245-3, o mesmo analito em sangue total, que tem faixa de
+    // referência própria. Sem alias: sangue total é outro material.
+    loinc: "5763-8",
     names: {
       en: ["Zinc", "Serum Zinc"],
       pt: ["Zinco"]
@@ -1369,6 +1408,9 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "figado",
     code: "Globulin",
+    // 2336-6 é "Globulin [Mass/volume] in Serum", soro só: o LOINC 2.82 não
+    // tem a versão Ser/Plas da globulina total (as frações alfa, beta e gama
+    // têm). Material registrado de propósito.
     loinc: "2336-6",
     names: {
       en: ["Globulin", "Serum Globulin"],
@@ -1648,6 +1690,13 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "rins",
     code: "BUN_Creatinine_Ratio",
+    // 3097-3 é "Urea nitrogen/Creatinine [Mass Ratio]", a razão BUN/creatinina,
+    // e a faixa de referência (10-20, Tietz) é a dessa convenção. O laudo
+    // brasileiro imprime "Relação Ureia/Creatinina", cuja faixa é outra (cerca
+    // de 21-43) e cujo código é 56997-0 ("Urea/Creatinine [Mass Ratio] in
+    // Serum or Plasma"). Trocar só o código deixaria a faixa errada do outro
+    // lado; a separação em duas grandezas, como em `Glucose_Fasting`, é
+    // decisão à parte, registrada em `reference-ranges.ts`.
     loinc: "3097-3",
     names: {
       en: ["BUN/Creatinine Ratio", "Urea/Creatinine Ratio"],
@@ -1815,7 +1864,12 @@ var BIOMARKER_DEFINITIONS = [
     category: "urina",
     code: "Bacteria_Urine",
     codeAliases: ["UrineBacteria"],
-    loinc: "630-4",
+    // 5769-5 é "Bacteria [#/area] in Urine sediment by Microscopy high power
+    // field", a contagem do sedimento que a unidade /HPF declara. Até out/2026
+    // apontava para 630-4, "Bacteria identified in Urine by Culture": outro
+    // exame, nominal, que identifica a espécie em cultura. Sem alias:
+    // urocultura não é sedimento.
+    loinc: "5769-5",
     names: {
       en: ["Urine Bacteria", "Bacteria Urine", "Bacteria, Urine", "Bacteria"],
       pt: ["Bact\xE9rias na Urina", "Bact\xE9rias"]
@@ -1934,7 +1988,14 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "urina",
     code: "RBC_Urine",
-    loinc: "5808-1",
+    // 13945-1 é "Erythrocytes [#/area] in Urine sediment by Microscopy high
+    // power field", o /HPF que o laudo imprime e que `Leukocytes_Urine` já usa
+    // em 5821-4. Até out/2026 apontava para 5808-1, o mesmo exame em #/volume
+    // (por mL): analito e material certos, propriedade errada. Fica como alias
+    // porque o analito é o mesmo, e laudo de analisador automático que conte
+    // por mL continua resolvendo em RBC_Urine.
+    loinc: "13945-1",
+    loincAliases: ["5808-1"],
     names: {
       en: ["Urine RBC", "Red Blood Cells in Urine", "RBC Urine", "RBC, Urine"],
       pt: ["Hem\xE1cias na Urina"]
@@ -2029,6 +2090,10 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "autoimunidade",
     code: "Gliadin_Deamidated_IgA",
+    // 63453-5 e 63459-2 (IgG) afirmam método, "by Immunoassay", e material,
+    // "Serum". É o que os kits de DGP usam. A propriedade é unidades
+    // arbitrárias por volume, e o laudo imprime U/mL; até out/2026 a unidade
+    // declarada era "U", sem o volume.
     loinc: "63453-5",
     names: {
       en: [
@@ -2042,7 +2107,7 @@ var BIOMARKER_DEFINITIONS = [
       ],
       pt: ["Anticorpos Anti-Gliadina Deamidada IgA", "DGP IgA"]
     },
-    unit: "U"
+    unit: "U/mL"
   },
   {
     category: "autoimunidade",
@@ -2060,7 +2125,7 @@ var BIOMARKER_DEFINITIONS = [
       ],
       pt: ["Anticorpos Anti-Gliadina Deamidada IgG", "DGP IgG"]
     },
-    unit: "U"
+    unit: "U/mL"
   },
   {
     category: "autoimunidade",
@@ -2451,6 +2516,10 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "composicao-corporal",
     code: "TotalBodyWater",
+    // 101683-1 é "Body water mass", em kg; o aparelho de bioimpedância imprime
+    // litros. É o único código de água corporal total no LOINC 2.82 (o outro,
+    // 101684-9, é o percentual), e para água 1 L pesa 1 kg, então o número não
+    // muda. O teste de eixos lista a entrada como exceção com este motivo.
     loinc: "101683-1",
     names: {
       en: ["Total Body Water", "Body Water", "TBW", "Total Water"],
@@ -2516,6 +2585,10 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "composicao-corporal",
     code: "PhaseAngle",
+    // 107160-4 é "Phase angle Xc/R [Ratio] Bioelectrical impedance analysis",
+    // único código de ângulo de fase. O aparelho imprime graus (arctan Xc/R)
+    // e o LOINC declara razão com unidade-exemplo %. Fica em graus, que é o
+    // que o laudo traz, e o teste de eixos lista a entrada como exceção.
     loinc: "107160-4",
     names: {
       en: ["Phase Angle", "Whole Body Phase Angle", "PhA", "AnglePhase"],
@@ -2606,9 +2679,9 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "composicao-corporal",
     code: "WaistCircumference",
-    // 8280-0 é a medida em si. 56086-2, que parecia o óbvio pela busca, é
-    // "Adult Waist Circumference Protocol", um protocolo PhenX e não um
-    // resultado.
+    // 8280-0 é a medida em si, e afirma sítio e método: "at umbilicus by Tape
+    // measure". 56086-2, que parecia o óbvio pela busca, é "Adult Waist
+    // Circumference Protocol", um protocolo PhenX e não um resultado.
     loinc: "8280-0",
     names: {
       en: ["Waist Circumference", "Abdominal Circumference", "Waist"],
@@ -3018,6 +3091,10 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "coracao",
     code: "TroponinI",
+    // 49563-0 afirma método: limite de detecção ≤ 0,01 ng/mL, o ensaio de alta
+    // sensibilidade. Um resultado de troponina I convencional pede o código
+    // sem método, 10839-9. Assimétrico com `TroponinT`, que fica no 6598-7 sem
+    // método de propósito: a hs-cTnT em ng/L é a convenção dos laudos.
     loinc: "49563-0",
     names: {
       en: ["Troponin I", "cTnI", "Cardiac Troponin I", "hs-TnI", "High-Sensitivity Troponin I"],
@@ -3028,6 +3105,9 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "coracao",
     code: "TroponinT",
+    // 6598-7 não afirma método. A unidade ng/L é a convenção do ensaio de alta
+    // sensibilidade (hs-cTnT), e o ensaio convencional em ng/mL converte por
+    // fator exato (ver `units.ts`). Ver `TroponinI` para a assimetria.
     loinc: "6598-7",
     names: {
       en: ["Troponin T", "cTnT", "Cardiac Troponin T", "hs-TnT", "High-Sensitivity Troponin T"],
@@ -3064,6 +3144,11 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "figado",
     code: "LDH",
+    // 14804-9 afirma método: reação lactato → piruvato (L→P). O código sem
+    // método, 2532-0, está DISCOURAGED, então um método tem que ser escolhido,
+    // e L→P é o do procedimento de referência IFCC que os laboratórios
+    // brasileiros usam, ainda que o laudo raramente imprima a direção. Se um
+    // laudo declarar P→L, o código é outro (14805-6).
     loinc: "14804-9",
     // 2532-0 é o código genérico anterior, que o LOINC marca como DISCOURAGED.
     // Fica como alias para que laudo antigo e dado já armazenado continuem
@@ -3194,7 +3279,13 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "pancreas",
     code: "BetaHydroxybutyrate",
-    loinc: "53060-0",
+    // 6873-4 é "Beta hydroxybutyrate [Moles/volume] in Serum or Plasma", o
+    // que o laudo dosa em mmol/L. Até out/2026 apontava para 53060-0, que é
+    // butirilcarnitina (C4) em líquido amniótico: analito e material errados
+    // desde abr/2026, e nenhum check pegou porque o código existe e está
+    // ACTIVE. Sem alias para o código antigo: ele nunca significou BHB, e
+    // aceitá-lo na importação faria um laudo de carnitina virar cetona.
+    loinc: "6873-4",
     names: {
       en: ["Beta-Hydroxybutyrate", "\u03B2-Hydroxybutyrate", "BHB", "Ketone Bodies"],
       pt: ["Beta-Hidroxibutirato", "\u03B2-Hidroxibutirato", "BHB", "Corpos Cet\xF4nicos"]
@@ -3325,97 +3416,99 @@ var BIOMARKER_CODE_SYSTEM = "http://fhir-brasil.dev/biomarker-codes";
 var UNIT_TO_UCUM = {
   // Dimensionless / special measurements
   "[pH]": "[pH]",
+  "{index}": "{index}",
   "{ratio}": "{ratio}",
+  "{score}": "{score}",
   "{specific gravity}": "{specific gravity}",
+  "/HPF": "/[HPF]",
+  "/LPF": "/[LPF]",
   "/\xB5L": "/uL",
   // Percentage
   "%": "%",
   // Count units
   "10\xB3/\xB5L": "10*3/uL",
   "10\u2076/\xB5L": "10*6/uL",
+  Angstrom: "Ao",
+  AU: "{score}",
+  cm: "cm",
+  "cm\xB3": "cm3",
+  deg: "deg",
   // Volume
   fL: "fL",
   g: "g",
+  "g/cm\xB2": "g/cm2",
   // Mass concentration
   "g/dL": "g/dL",
+  "g/L": "g/L",
+  "IU/L": "[IU]/L",
+  "IU/mL": "[IU]/mL",
+  "K/uL": "10*3/uL",
+  "kcal/d": "kcal/d",
+  kg: "kg",
+  "kg/m2": "kg/m2",
+  "kg/m\xB2": "kg/m2",
+  "kU/L": "k[IU]/L",
   L: "L",
+  "M/uL": "10*6/uL",
+  "mcg/dL": "ug/dL",
+  "mcg/L": "ug/L",
+  "mcg/mL": "ug/mL",
   // Molar concentration
   "mEq/L": "meq/L",
   mg: "mg",
   "mg/dL": "mg/dL",
+  "mg/g": "mg/g",
+  "mg/L": "mg/L",
+  "mIU/L": "m[IU]/L",
+  "mIU/mL": "m[IU]/mL",
   mL: "mL",
+  "mL/min/1.73m\xB2": "mL/min/{1.73_m2}",
+  mm: "mm",
+  "mm/h": "mm/h",
+  "mm/hr": "mm/h",
   "mmol/L": "mmol/L",
+  "mUI/L": "m[IU]/L",
   "mUI/mL": "m[IU]/mL",
   ng: "ng",
   "ng/dL": "ng/dL",
+  "ng/L": "ng/L",
   "ng/mL": "ng/mL",
   "nmol/L": "nmol/L",
   // Mass
   pg: "pg",
   "pg/mL": "pg/mL",
   pH: "[pH]",
+  "pmol/L": "pmol/L",
+  raz\u00E3o: "{ratio}",
+  score: "{score}",
+  segundos: "s",
   // Enzyme activity
+  U: "U",
   "U/L": "U/L",
   // Special units
   "U/mL": "U/mL",
+  "ug/dL": "ug/dL",
+  "ug/L": "ug/L",
   "UI/L": "[IU]/L",
   "UI/mL": "[IU]/mL",
+  "uIU/mL": "u[IU]/mL",
+  "umol/L": "umol/L",
   \u00B5g: "ug",
   "\xB5g/dL": "ug/dL",
+  "\xB5g/L": "ug/L",
   "\xB5mol/L": "umol/L",
-  "\xB5UI/mL": "u[IU]/mL"
+  "\xB5UI/mL": "u[IU]/mL",
+  \u00EDndice: "{index}"
 };
-var BIOMARKER_DEFAULT_UNIT = {
-  // Proteins
-  Albumin: "g/dL",
-  AlkalinePhosphatase: "U/L",
-  // Liver
-  ALT: "U/L",
-  AST: "U/L",
-  Calcium: "mg/dL",
-  Chloride: "mEq/L",
-  // Lipids
-  Cholesterol: "mg/dL",
-  // Kidney
-  Creatinine: "mg/dL",
-  eAG: "mg/dL",
-  Ferritin: "ng/mL",
-  FolicAcid: "ng/mL",
-  GGT: "U/L",
-  // Glucose/Diabetes
-  Glucose: "mg/dL",
-  HbA1c: "%",
-  Hct: "%",
-  HDL: "mg/dL",
-  // Hematology
-  Hgb: "g/dL",
-  Insulin: "\xB5UI/mL",
-  // Iron studies
-  Iron: "\xB5g/dL",
-  LDL: "mg/dL",
-  Magnesium: "mg/dL",
-  NonHDL_Cholesterol: "mg/dL",
-  // Urinalysis - dimensionless
+var DIMENSIONLESS_DEFAULTS = {
   pH_Urine: "[pH]",
-  Potassium: "mEq/L",
-  RDW: "%",
-  // Electrolytes
-  Sodium: "mEq/L",
-  SpecificGravity_Urine: "{specific gravity}",
-  T3Free: "pg/mL",
-  T4Free: "ng/dL",
-  TIBC: "\xB5g/dL",
-  TotalProtein: "g/dL",
-  TransferrinSaturation: "%",
-  Triglycerides: "mg/dL",
-  // Thyroid
-  TSH: "\xB5UI/mL",
-  Urea: "mg/dL",
-  UricAcid: "mg/dL",
-  // Vitamins
-  VitaminB12: "pg/mL",
-  VitaminD: "ng/mL",
-  VLDL: "mg/dL"
+  SpecificGravity_Urine: "{specific gravity}"
+};
+var BIOMARKER_DEFAULT_UNIT = {
+  ...Object.fromEntries(
+    BIOMARKER_DEFINITIONS.filter((b) => b.unit).map((b) => [b.code, b.unit])
+  ),
+  ...DIMENSIONLESS_DEFAULTS
 };
 function unitToUCUM(unit) {
   return UNIT_TO_UCUM[unit] || unit;
@@ -3423,6 +3516,128 @@ function unitToUCUM(unit) {
 function getDefaultUnit(biomarkerCode) {
   return BIOMARKER_DEFAULT_UNIT[biomarkerCode] || "";
 }
+var UCUM_ATOMS = /* @__PURE__ */ new Set([
+  "m",
+  "g",
+  "s",
+  "L",
+  "l",
+  "mol",
+  "eq",
+  "U",
+  "cal",
+  "h",
+  "d",
+  "min",
+  "wk",
+  "mo",
+  "a",
+  "Ao",
+  "deg",
+  "K",
+  "A",
+  "N",
+  "Pa",
+  "J",
+  "W",
+  "Hz",
+  "V",
+  "C",
+  "osm",
+  "t",
+  "u",
+  "bar",
+  "atm",
+  "rad",
+  "sr",
+  "cd",
+  "Bq",
+  "Gy",
+  "Sv",
+  "lm",
+  "lx",
+  "Cel",
+  "B",
+  "Np"
+]);
+var UCUM_PREFIXES = /* @__PURE__ */ new Set([
+  "Y",
+  "Z",
+  "E",
+  "P",
+  "T",
+  "G",
+  "M",
+  "k",
+  "h",
+  "da",
+  "d",
+  "c",
+  "m",
+  "u",
+  "n",
+  "p",
+  "f",
+  "a",
+  "z",
+  "y"
+]);
+function isUcumAtom(token) {
+  if (token === "%" || /^10\*-?\d+$/.test(token) || /^\d+$/.test(token)) return true;
+  const bracket = /^([A-Za-z]{0,2})\[[^[\]{}\s]+\]$/.exec(token);
+  if (bracket) return bracket[1] === "" || UCUM_PREFIXES.has(bracket[1]);
+  if (UCUM_ATOMS.has(token)) return true;
+  for (const prefix of UCUM_PREFIXES) {
+    if (token.startsWith(prefix) && UCUM_ATOMS.has(token.slice(prefix.length))) return true;
+  }
+  return false;
+}
+function isUcumComponent(token) {
+  const m = /^(.*?)(\{[^{}]*\})?$/.exec(token);
+  if (!m) return false;
+  const [, body, annotation] = m;
+  if (!body) return annotation !== void 0;
+  const exp = /^(.+?)([+-]?\d+)?$/.exec(body);
+  if (!exp) return false;
+  const [, atom, exponent] = exp;
+  if (isUcumAtom(body)) return true;
+  if (exponent === void 0) return false;
+  return isUcumAtom(atom);
+}
+function isUcumCode(code) {
+  if (!code || /[^\x21-\x7E ]/.test(code)) return false;
+  const terms = [];
+  let current = "";
+  let braces = 0;
+  let inBracket = false;
+  for (const ch of code) {
+    if (ch === "{") braces++;
+    else if (ch === "}") {
+      if (braces === 0) return false;
+      braces--;
+    } else if (ch === "[") inBracket = true;
+    else if (ch === "]") inBracket = false;
+    if ((ch === "." || ch === "/") && braces === 0 && !inBracket) {
+      terms.push(current, ch);
+      current = "";
+      continue;
+    }
+    current += ch;
+  }
+  if (braces !== 0 || inBracket) return false;
+  terms.push(current);
+  if (terms[0] === "" && terms[1] === "/") terms[0] = "1";
+  let expectOperand = true;
+  for (const t of terms) {
+    if (expectOperand) {
+      if (!isUcumComponent(t)) return false;
+    } else if (t !== "." && t !== "/") {
+      return false;
+    }
+    expectOperand = !expectOperand;
+  }
+  return !expectOperand;
+}
 var CBC_DIFF_ALIASES = {
   "/ul": "/uL",
   "/\xB5l": "/uL",
@@ -3724,7 +3939,7 @@ var BIOMARKER_UNITS = {
       "miu/ml": "mIU/mL",
       "ui/l": "mIU/mL"
     },
-    canonicalUcum: "mIU/mL",
+    canonicalUcum: "m[iU]/mL",
     canonicalUnit: "mIU/mL",
     siUcum: "[iU]/L",
     siUnit: "IU/L"
@@ -3859,7 +4074,7 @@ var BIOMARKER_UNITS = {
       "miu/ml": "mIU/mL",
       "ui/l": "mIU/mL"
     },
-    canonicalUcum: "mIU/mL",
+    canonicalUcum: "m[iU]/mL",
     canonicalUnit: "mIU/mL",
     siUcum: "[iU]/L",
     siUnit: "IU/L"
@@ -4126,7 +4341,7 @@ var BIOMARKER_UNITS = {
     },
     canonicalUcum: "u[iU]/mL",
     canonicalUnit: "uIU/mL",
-    siUcum: "mIU/L",
+    siUcum: "m[iU]/L",
     siUnit: "mIU/L"
   },
   Urea: {
@@ -4181,6 +4396,21 @@ var BIOMARKER_UNITS = {
 function getCanonicalUnit(code) {
   return BIOMARKER_UNITS[code]?.canonicalUnit ?? null;
 }
+function normalizeUnit(unit, config) {
+  return config.aliases[unit.toLowerCase()] ?? config.aliases[unit] ?? unit;
+}
+function resolveUcum(unit, biomarkerCode) {
+  if (!unit) return void 0;
+  const config = biomarkerCode ? BIOMARKER_UNITS[biomarkerCode] : void 0;
+  if (config) {
+    const normalized = normalizeUnit(unit, config);
+    if (normalized === config.canonicalUnit) return config.canonicalUcum;
+    if (normalized === config.siUnit) return config.siUcum;
+  }
+  const mapped = UNIT_TO_UCUM[unit];
+  if (mapped) return mapped;
+  return isUcumCode(unit) ? unit : void 0;
+}
 
 // src/converter.ts
 function interpretationCode(flag) {
@@ -4213,13 +4443,7 @@ var SEX_CODING = {
   },
   male: { code: "male", display: "Male", system: "http://hl7.org/fhir/administrative-gender" }
 };
-var buildReferenceRanges = (observation, sourceUnit, ucumUnit) => {
-  const quantity = (value) => ({
-    code: ucumUnit,
-    system: "http://unitsofmeasure.org",
-    unit: sourceUnit,
-    value
-  });
+var buildReferenceRanges = (observation, quantity) => {
   const toRanges = (low, high, sex) => {
     if (low === void 0 && high === void 0) return [];
     return [
@@ -4238,7 +4462,12 @@ var buildReferenceRanges = (observation, sourceUnit, ucumUnit) => {
 function labObservationToFHIR(observation, patientId, laboratoryName) {
   const loincCode = codeToLoinc(observation.biomarkerCode);
   const sourceUnit = observation.unit || getDefaultUnit(observation.biomarkerCode) || observation.unit;
-  const ucumUnit = unitToUCUM(sourceUnit);
+  const ucumUnit = resolveUcum(sourceUnit, observation.biomarkerCode);
+  const quantity = (value) => ({
+    ...ucumUnit ? { code: ucumUnit, system: "http://unitsofmeasure.org" } : {},
+    ...sourceUnit ? { unit: sourceUnit } : {},
+    value
+  });
   const isQualitative = observation.isQualitative || typeof observation.value === "string";
   const fhirObs = {
     category: [
@@ -4297,13 +4526,8 @@ function labObservationToFHIR(observation, patientId, laboratoryName) {
   if (isQualitative) {
     fhirObs.valueString = String(observation.value);
   } else {
-    fhirObs.valueQuantity = {
-      code: ucumUnit,
-      system: "http://unitsofmeasure.org",
-      unit: sourceUnit,
-      value: observation.value
-    };
-    const referenceRange = buildReferenceRanges(observation, sourceUnit, ucumUnit);
+    fhirObs.valueQuantity = quantity(observation.value);
+    const referenceRange = buildReferenceRanges(observation, quantity);
     if (referenceRange.length > 0) fhirObs.referenceRange = referenceRange;
   }
   return fhirObs;
@@ -7263,7 +7487,7 @@ var COMMANDS = {
 async function main() {
   const { command, help, json, resto, version } = dividirArgv(process.argv.slice(2));
   if (version) {
-    process.stdout.write(`${"0.32.0"}
+    process.stdout.write(`${"0.33.0"}
 `);
     return;
   }