cry-vetzdravila 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,17 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(curl:*)",
+      "Bash(bun install)",
+      "Bash(bun -e:*)",
+      "Bash(bun run:*)",
+      "Bash(bun test:*)",
+      "Bash(ls:*)",
+      "Bash(npm view:*)",
+      "Bash(bun update:*)",
+      "Bash(bun build:*)",
+      "Bash(bun --eval:*)",
+      "Bash(bun:*)"
+    ]
+  }
+}

package/CLAUDE.md

@@ -0,0 +1,82 @@
+# Namen projekta
+
+1. Podpora za seznam vseh zdravil, registriranih za veterinarsko rabo v Sloveniji.
+   1. Bazo vseh teh zdravil imenujemo register.
+   2. Register vsebuje seznam zdravil in funkcijo, ki za neko ime zdravila poišče najverjetnejše zadetke iz registra.
+2. Podpora za šifrant ATC Vet (Anatomical Therapeutic Chemical classification system for Veterinarians)
+
+## Struktura datotek
+
+1. mapa **data** vsebuje
+   1. datoteke, ki jih strojno prenesemo s spleta
+      1. register.xlsx - register zdravil
+      2. atcvet.pdf - ATCVet klasifikacija
+   2. in jih sparsamo v rezultat
+      1. register.json
+      2. atcvet.json
+2. direktorij **src** vsebuje
+   1. index.ts - glavni izvoz knjižnice
+   2. importParseAndBuildAll.ts
+      1. prenese register in atcvet s spleta
+      2. sparsa register in atcvet v json datoteki v data
+   3. generate.ts
+      1. generira ts skripti v direktoriju src/generated
+      2. prepiše vsebino iz json datotek v ts datoteke
+   4. poddirektorij **atcvet** - ATCVet klasifikacija
+      1. downloadLatestAtcvetPdf.ts - naloži atcvet.pdf s spleta
+      2. parseAtcvetPdf.ts - sparsa atcvet.pdf v data/atcvet.json
+      3. types/AtcvetFile.ts - tipi za ATCVet datoteko
+   5. poddirektorij **register** - register zdravil
+      1. downloadRegister.ts - naloži register.xlsx s spleta
+      2. parseRegister.ts - sparsa register.xlsx v data/register.json
+      3. uganiZdravilo.ts - iskanje zdravil po imenu
+      4. stats.ts - statistika registra
+      5. helper/ - pomožne funkcije
+         1. normalizirajNaziv.ts - normalizacija imen zdravil
+         2. poisciZivalskoVrsto.ts - iskanje živalskih vrst
+         3. testNormalizacije.ts - testiranje normalizacije
+         4. analizaVakcin.ts - analiza vakcin
+         5. checkVrste.ts - preverjanje živalskih vrst
+      6. types/ - tipi
+         1. Register.ts - tip registra
+         2. Zdravilo.ts - tip zdravila
+         3. ZivalskeVrste.ts - seznam živalskih vrst
+         4. KarencaZdravila.ts - tip karence
+         5. PotUporabeZdravila.ts - tip poti uporabe
+         6. UcinkovinaZdravila.ts - tip učinkovine
+   6. poddirektorij **test** - testi
+      1. uganiZdravilo.test.ts - test iskanja zdravil
+      2. uganiZdraviloFull.test.ts - polni test iskanja
+      3. zdravila.json - testni podatki
+3. mapa **dist** vsebuje datoteke za izvoz v npm
+4. mapa **docs** vsebuje dokumentacijo
+   1. vakcine.md - dokumentacija o vakcinah
+5. mapa **generated** vsebuje datoteki
+   1. registerZdravil.ts: export const registerZdravil : RegisterZdravil = ...
+   2. seznamZdravil.ts: export const seznamZdravil: Zdravilo[] = ...
+   3. ActVet.ts: export const AtcVet : AtcvetRow[] = ...
+
+## Način dela
+
+1. Kodo izvajamo preko bun interpreterja.
+2. Koda je v typescriptu.
+3. Pred objavo kodo prevedemo v jscript v mapo dist.
+
+
+## Izvoz - zunanji API
+
+Zunanji API je izvožen v src/index.ts in vsebuje
+1. uganiZdravilo
+2. uganiZdraviloInUtemelji
+3. normalizirajNaziv
+4. razcleniNaziv
+5. oceniPodobnost
+6. zdraviloJeVakcinaZa
+7. podobnaZdravilaPoUcinkovinah
+8. podobnaZdravilaPoATC
+9. podatkiATCvetKode
+10. opisATCvetKode
+11. pomeniNivojevATCvet
+12. AtcVet
+13. registerZdravil
+14. seznamZdravil

package/LICENSE.md

@@ -0,0 +1,16 @@
+Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International
+
+Copyright (c) 2026 Primož Krajnik
+
+This work is licensed under the Creative Commons
+Attribution-NonCommercial-NoDerivatives 4.0 International License.
+
+You may:
+- Share the unmodified material for non-commercial purposes only
+
+You may not:
+- Use the material for commercial purposes
+- Modify, adapt, translate, or create derivative works
+
+Full license text:
+https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode

package/README.md

@@ -0,0 +1,376 @@
+# cry-vetzdravila
+
+Knjižnica veterinarskih zdravil registriranih v Sloveniji in šifrant ATCvet.
+
+- [cry-vetzdravila](#cry-vetzdravila)
+  - [Namestitev](#namestitev)
+  - [Nadgradnja](#nadgradnja)
+  - [Interaktivno iskanje](#interaktivno-iskanje)
+  - [Uporaba](#uporaba)
+  - [API](#api)
+    - [Surovi podatki](#surovi-podatki)
+      - [`registerZdravil: Map<number, Zdravilo>`](#registerzdravil-mapnumber-zdravilo)
+      - [`AtcVet: AtcvetRow[]`](#atcvet-atcvetrow)
+    - [Iskanje zdravil](#iskanje-zdravil)
+      - [`uganiZdravilo(ime: string, opts?: UganiZdraviloOpts)`](#uganizdraviloime-string-opts-uganizdraviloopts)
+      - [`uganiZdraviloInUtemelji(ime: string, opts?: UganiZdraviloOpts)`](#uganizdraviloinutemeljiime-string-opts-uganizdraviloopts)
+      - [`oblikujRezultatIskanja(rezultati)`](#oblikujrezultatiskanjarezultati)
+      - [`zdravilaZaAtcVetKodo(atcVetKoda: string)`](#zdravilazaatcvetkodoatcvetkoda-string)
+    - [Normalizacija in analiza imen](#normalizacija-in-analiza-imen)
+      - [`normalizirajNaziv(naziv: string)`](#normalizirajnazivnaziv-string)
+      - [`razcleniNaziv(naziv: string)`](#razcleninazivnaziv-string)
+      - [`oceniPodobnost(razclembaVhoda, razclembaRegistra)`](#ocenipodobnostrazclembavhoda-razclembaregistra)
+    - [Vakcine](#vakcine)
+      - [`zdraviloJeVakcinaZa(zdravilo, zival)`](#zdravilojevakcinazazdravilo-zival)
+    - [Podobna zdravila](#podobna-zdravila)
+      - [`podobnaZdravilaPoATC(zdravilo, nivo?)`](#podobnazdravilapoatczdravilo-nivo)
+      - [`podobnaZdravilaPoUcinkovinah(zdravilo)`](#podobnazdravilapoucinkovinahzdravilo)
+    - [ATCvet klasifikacija](#atcvet-klasifikacija)
+      - [`podatkiATCvetKode(koda: string)`](#podatkiatcvetkodekoda-string)
+      - [`opisATCvetKode(koda: string)`](#opisatcvetkodekoda-string)
+      - [`pomeniNivojevATCvet`](#pomeninivojevatcvet)
+  - [Tipi](#tipi)
+  - [Licenca](#licenca)
+
+
+## Namestitev
+
+```bash
+npm install cry-vetzdravila
+# ali
+bun add cry-vetzdravila
+```
+
+## Nadgradnja
+
+```bash
+bun run src/importParseAndBuildAll.ts
+```
+
+## Interaktivno iskanje
+
+```bash
+bun run interactive
+```
+
+Ukazi:
+- **1-20**: nastavi limit rezultatov
+- **200-2000**: nastavi minimalno oceno
+- **u**: vklopi/izklopi prikaz utemeljitev
+- **r**: vklopi/izklopi prikaz razčlemb
+- **o**: izpiši opis ATCvet kode prvega zadetka
+- **p**: izpiši vse podatke ATCvet kode prvega zadetka
+- **=**: izpiši podobna zdravila (po ATCvet kodi)
+- **+/-**: dvigni/spusti ATCvet nivo in izpiši podobna
+- **f**: izpiši podobna zdravila (po učinkovinah)
+- **Qxxxx**: prikaži nivoje ATCvet kode (npr. QJ01CA04)
+- **Qxxxx...**: prikaži zdravila z ATCvet kodo (npr. QJ01...)
+- **Enter**: ponovi zadnje iskanje
+- **q**: izhod
+
+
+## Uporaba
+
+```typescript
+import {
+  // Podatki
+  registerZdravil,
+  AtcVet,
+  // Iskanje
+  uganiZdravilo,
+  uganiZdraviloInUtemelji,
+  oblikujRezultatIskanja,
+  zdravilaZaAtcVetKodo,
+  // Normalizacija
+  normalizirajNaziv,
+  razcleniNaziv,
+  oceniPodobnost,
+  // Vakcine
+  zdraviloJeVakcinaZa,
+  // Podobna zdravila
+  podobnaZdravilaPoATC,
+  podobnaZdravilaPoUcinkovinah,
+  // ATCvet
+  podatkiATCvetKode,
+  opisATCvetKode,
+  pomeniNivojevATCvet,
+} from "cry-vetzdravila";
+```
+
+## API
+
+### Surovi podatki
+
+#### `registerZdravil: Map<number, Zdravilo>`
+
+Register vseh veterinarskih zdravil. Ključ je numerični ID zdravila.
+
+```typescript
+// Pridobi zdravilo po ID-ju
+const zdravilo = registerZdravil.get(123456);
+
+// Iteriraj čez vsa zdravila
+for (const [id, zdravilo] of registerZdravil) {
+  console.log(zdravilo.ime);
+}
+```
+
+#### `AtcVet: AtcvetRow[]`
+
+Šifrant ATCvet klasifikacije.
+
+```typescript
+const atc = AtcVet.find(a => a.code === "QJ01CA04");
+// { code: "QJ01CA04", level: 5, desc_en: "amoxicillin", desc_si: "amoksicilin" }
+```
+
+### Iskanje zdravil
+
+#### `uganiZdravilo(ime: string, opts?: UganiZdraviloOpts)`
+
+Poišče zdravila po imenu. Vrne seznam zadetkov in najboljši zadetek (če je enolično določen).
+
+```typescript
+const { zadetki, najboljsi } = uganiZdravilo("citramox 500");
+// zadetki: { zdravilo: Zdravilo, ocena: number }[]
+// najboljsi: Zdravilo | undefined
+
+// Z opcijami
+const { zadetki } = uganiZdravilo("baytril", { limit: 10, minOcena: 600 });
+```
+
+Opcije (`UganiZdraviloOpts`):
+- `limit`: maksimalno število rezultatov (privzeto 10)
+- `minOcena`: minimalna ocena podobnosti (privzeto 500)
+- `isciMed`: išči samo med zdravili s temi ID-ji
+
+#### `uganiZdraviloInUtemelji(ime: string, opts?: UganiZdraviloOpts)`
+
+Enako kot `uganiZdravilo`, vendar vrne polne utemeljitve za vsak zadetek.
+
+```typescript
+const rezultati = uganiZdraviloInUtemelji("baytril 50", { limit: 5 });
+for (const r of rezultati) {
+  console.log(r.zdravilo.ime, r.utemeljitev.ocena);
+  // Delne ocene: ocenaPrvihBesed, ocenaDoze, ocenaZivalskihVrst, ...
+}
+```
+
+#### `oblikujRezultatIskanja(rezultati)`
+
+Pretvori rezultate iskanja v poenostavljeno obliko z določenim najboljšim zadetkom.
+
+```typescript
+const rezultati = uganiZdraviloInUtemelji("citramox");
+const { zadetki, najboljsi } = oblikujRezultatIskanja(rezultati);
+```
+
+#### `zdravilaZaAtcVetKodo(atcVetKoda: string)`
+
+Vrne seznam zdravil z dano ATCvet kodo ali prefiksom. Seznam je urejen po ATCvet kodah.
+
+```typescript
+// Vsa zdravila z amoksicilinom
+const zdravila = zdravilaZaAtcVetKodo("QJ01CA04");
+
+// Vsa zdravila za sistemsko zdravljenje bakterijskih infekcij
+const antibiotiki = zdravilaZaAtcVetKodo("QJ01");
+```
+
+### Normalizacija in analiza imen
+
+#### `normalizirajNaziv(naziv: string)`
+
+Normalizira ime zdravila za primerjavo (male črke, enote, teže, decimalne vejice...).
+
+```typescript
+normalizirajNaziv("AMOXICILLIN 50,5 mg/ml za pse");
+// "amoxicillin 50.5mg/ml pse"
+```
+
+#### `razcleniNaziv(naziv: string)`
+
+Razčleni ime zdravila na komponente.
+
+```typescript
+razcleniNaziv("BAYTRIL 50 mg/ml za pse in mačke 7tbl");
+// {
+//   izvorni_naziv: "BAYTRIL 50 mg/ml za pse in mačke 7tbl",
+//   normaliziran_naziv: "baytril 50mg/ml pse mačke 7tbl",
+//   besede: ["baytril"],
+//   doze: ["50mg/ml"],
+//   teza: null,
+//   kolicina: "7tbl",
+//   zivalskeVrste: ["pse", "mačke"]
+// }
+```
+
+#### `oceniPodobnost(razclembaVhoda, razclembaRegistra)`
+
+Oceni podobnost med dvema razčlenjenima nazivoma zdravil.
+
+```typescript
+const vhod = razcleniNaziv("baytril 50");
+const register = razcleniNaziv("BAYTRIL 50 mg/ml raztopina za injiciranje");
+const ocena = oceniPodobnost(vhod, register);
+// ocena.ocena = skupna ocena podobnosti
+// ocena.ocenaPrvihBesed, ocena.ocenaDoze, ocena.ocenaZivalskihVrst, ...
+```
+
+### Vakcine
+
+#### `zdraviloJeVakcinaZa(zdravilo, zival)`
+
+Preveri, ali je zdravilo vakcina za določeno živalsko vrsto. Vrne seznam bolezni ali `false`.
+
+```typescript
+const rabisin = registerZdravil.get(123);
+const bolezni = zdraviloJeVakcinaZa(rabisin, "psi");
+if (bolezni) {
+  console.log(bolezni); // ["steklina"]
+}
+```
+
+### Podobna zdravila
+
+#### `podobnaZdravilaPoATC(zdravilo, nivo?)`
+
+Vrne zdravila z enako ATCvet kodo na danem nivoju. Seznam je urejen po podobnosti z vhodnim zdravilom.
+
+Nivoji ATCvet:
+- 1: anatomska glavna skupina
+- 2: terapevtska podskupina
+- 3: farmakološka podskupina
+- 4: kemijska podskupina
+- 5: kemijska učinkovina (privzeto)
+
+```typescript
+const zdravilo = registerZdravil.get(123);
+const podobna = podobnaZdravilaPoATC(zdravilo, 4);
+// Vrne zdravila z enako kemijsko podskupino
+```
+
+#### `podobnaZdravilaPoUcinkovinah(zdravilo)`
+
+Vrne zdravila, ki imajo vsaj eno skupno učinkovino. Seznam je urejen po podobnosti.
+
+```typescript
+const baytril = registerZdravil.get(123);
+const podobna = podobnaZdravilaPoUcinkovinah(baytril);
+// Vrne zdravila z enrofloksacinom
+```
+
+### ATCvet klasifikacija
+
+#### `podatkiATCvetKode(koda: string)`
+
+Vrne opise vseh nivojev za dano ATCvet kodo.
+
+```typescript
+podatkiATCvetKode("QJ01CA04");
+// [
+//   { nivo: 0, pomenNivoja: "veterinarska uporaba", opisNivoja: "Veterinarska zdravila" },
+//   { nivo: 1, pomenNivoja: "anatomska glavna skupina", opisNivoja: "ZDRAVILA ZA SISTEMSKO ZDRAVLJENJE INFEKCIJ" },
+//   { nivo: 2, pomenNivoja: "terapevtska podskupina", opisNivoja: "ZDRAVILA ZA SISTEMSKO ZDRAVLJENJE BAKTERIJSKIH INFEKCIJ" },
+//   { nivo: 3, pomenNivoja: "farmakološka podskupina", opisNivoja: "Betalaktamski antibiotiki, penicilini" },
+//   { nivo: 4, pomenNivoja: "kemijska podskupina", opisNivoja: "Širokospektralni penicilini" },
+//   { nivo: 5, pomenNivoja: "kemijska učinkovina", opisNivoja: "amoksicilin" }
+// ]
+```
+
+#### `opisATCvetKode(koda: string)`
+
+Vrne opis posamezne ATCvet kode (najvišji nivo).
+
+```typescript
+opisATCvetKode("QJ01CA04");
+// { nivo: 5, pomenNivoja: "kemijska učinkovina", opisNivoja: "amoksicilin" }
+```
+
+#### `pomeniNivojevATCvet`
+
+Seznam pomenov nivojev ATCvet klasifikacije.
+
+```typescript
+// [
+//   [0, "veterinarska uporaba"],
+//   [1, "anatomska glavna skupina"],
+//   [2, "terapevtska podskupina"],
+//   [3, "farmakološka podskupina"],
+//   [4, "kemijska podskupina"],
+//   [5, "kemijska učinkovina"]
+// ]
+```
+
+## Tipi
+
+```typescript
+interface Zdravilo {
+  id: number;                              // ID zdravila (hash imena)
+  ime: string;                             // Ime zdravila
+  imetnikDovoljenja: string;               // Imetnik dovoljenja za promet
+  sproscanjeZdravila: string;              // Podatki o sproščanju
+  stevilkaDovoljenja: string;              // Številka dovoljenja za promet
+  datumVeljavnosti: string | null;         // Datum veljavnosti dovoljenja
+  rezimIzdaje: string;                     // Režim izdaje (npr. Rp)
+  atcKoda: string;                         // ATCvet koda
+  potiUporabe: PotUporabeZdravila[];       // Poti uporabe
+  farmacevtskaOblika: string;              // Farmacevtska oblika
+  pakiranja: string;                       // Opis pakiranj
+  enotaKolicine: string;                   // Enota količine za sestavo
+  ucinkovine: UcinkovinaZdravila[];        // Seznam učinkovin
+  pomocneSnovi: string[];                  // Pomožne snovi
+  ciljneVrste: string[];                   // Ciljne živalske vrste
+  karence: KarencaZdravila[];              // Karenca po vrstah
+  vakcinaZa?: string[];                    // Če je vakcina, proti čemu varuje
+}
+
+interface UganiZdraviloOpts {
+  limit?: number;      // Maksimalno število rezultatov (privzeto 10)
+  minOcena?: number;   // Minimalna ocena podobnosti (privzeto 500)
+  isciMed?: number[];  // Išči samo med temi ID-ji
+}
+
+interface RazclenjeniNaziv {
+  izvorni_naziv: string;
+  normaliziran_naziv: string;
+  besede: string[];
+  doze: string[];
+  teza: string | null;
+  kolicina: string | null;
+  zivalskeVrste: string[];
+}
+
+interface UtemeljitevOcene {
+  ocena: number;
+  ocenaPrvihBesed: number;
+  ocenaVelikosti: number;
+  ocenaDoze: number;
+  ocenaZivalskihVrst: number;
+  ocenaTeze: number;
+  ocenaKolicine: number;
+  ocenaBesed: number;
+  steviloBesed: number;
+  razclembaRegistra: RazclenjeniNaziv;
+}
+
+interface RazlagaATCvetKode {
+  nivo: number;
+  pomenNivoja: string;
+  opisNivoja: string;
+}
+
+interface AtcvetRow {
+  code: string;
+  level: number;
+  desc_en: string;
+  desc_si: string;
+}
+
+type RegisterZdravil = Map<number, Zdravilo>;
+```
+
+## Licenca
+
+[CC-BY-NC-ND-4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode)
+