@aeroswarm/weather 0.1.5 → 0.3.0

package/README.md

@@ -46,3 +46,69 @@ temperature) for any model source. `parseWeatherGridSeries`, `serializeWeatherGr
 `seriesFieldsAt`, and the Open-Meteo adapter (`latticePoints`, `weatherGridFromOpenMeteo`) are in the
 package; the network call stays in the app.
 
+## Tokens that are understood
+
+Checked against 2,400 real METAR/SPECI and 212 real TAF from 100+ airports (see `test/fixtures/README.md`).
+Every token of that corpus is either read or recognised as a group the model does not use; the one
+exception is a typo in the source (`VEB03KT`), which stays visible in `unparsed`.
+
+| Group | Read into the model | Recognised, not modelled |
+|---|---|---|
+| Wind | `dddffKT`, `dddffGggKT`, `dddffMPS`, `VRB`, variable range `dddVddd` (also glued to the wind group) | |
+| Visibility | metres (`9999`, `0750`), statute miles (`10SM`, `1/2SM`, `1 1/2SM`, `P6SM`), `CAVOK` | directional lowest visibility (`0500NE`) |
+| RVR | `R06R/0600N`, `R28/P2000`, `R35L/1200V1400FT` (metres or feet, trend, variable) in `conditions.rvr` | runway state (`R06C/CLRD62`, `R88/090065`) |
+| Weather | intensity, descriptor and phenomena (`+TSRA`, `VCTS`, `FZFG`, `BCFG`...), `NSW` | recent weather (`RERA`, `RETS`) |
+| Cloud | `FEW/SCT/BKN/OVC` with `CB/TCU`, `VV`, `SKC/CLR/NSC/NCD` | |
+| Temperature, pressure | `tt/dd` (also `M`), `Qpppp`, `Appp` (inHg to hPa) | |
+| Flags, trend | `AUTO`, `COR`, `NOSIG`, `BECMG`, `TEMPO`; everything after `RMK` is ignored | `//` (missing group), wind shear (`WS020/14030KT`, `WS R10`, `WS ALL RWY`) |
+| TAF | `AMD`, `COR`, `CNL`, `FMddhhmm`, `BECMG`, `TEMPO`, `PROBnn [TEMPO]`, `TX/TN` | remarks |
+
+A token that is none of these ends up in `Metar.unparsed` / `TafPeriod.unparsed` instead of silently
+disappearing. A report with an impossible date (for example `0000/0000`) is rejected (`null`), not
+guessed. A fuzz test mutates real reports (truncated, tokens removed, inserted, swapped) and requires
+that the parser never throws and never returns invalid numbers or dates.
+
+Not supported: the US domestic SIGMET formats (convective SIGMET, `AREA EMBD TS ...` with VOR-radial
+points), graphical G-AIRMET, and ICAO Annex 3 trend groups with `FM`/`TL`/`AT` times inside a METAR
+trend.
+
+
+
+## Warnings and special messages
+
+`decodeWeatherMessage` and `extractReports` also recognise these, and tell them apart by `kind`:
+
+| Kind | Reader | What is read | Verified against |
+|---|---|---|---|
+| `NIL` | `parseNil` | `METAR/SPECI/TAF [COR/AMD] ICAO [ddhhmmZ] NIL` | ICAO template only (no real NIL in the corpus) |
+| `SIGMET`, `AIRMET` | `parseSigmet` | FIR, series, validity, MWO, hazard (thunderstorm, turbulence, icing, mountain wave, volcanic ash, tropical cyclone, dust/sand storm, radioactive cloud, surface wind/visibility/cloud, cancellation), observed or forecast time, area (polygon, line with side, circle, latitude/longitude line, corridor, entire FIR, several areas), levels, movement, trend, volcano and cyclone names with positions, forecast position | 124 real SIGMET (aviationweather.gov); AIRMET only against the Annex 3 template |
+| `VAA` | `parseVaa` | VAAC, issue time, volcano and number, position, summit elevation, advisory number, colour code, eruption details, observed/estimated ash cloud, +6/+12/+18 h forecasts (layers with boundary points, movement, wind at the vent level), remarks, next advisory | 60 real advisories (Tokyo VAAC, JMA) |
+| `SNOWTAM` | `parseSnowtam` | lettered format A) to T): aerodrome, assessment time, every runway (cleared length and width, deposits and depth per third, friction), next observation, remarks. The global reporting format: head only (aerodrome, time), the rest in `unparsed` | Annex 15 items only (no real message) |
+
+Anything in these messages that is not understood is returned in `unparsed`, not dropped.
+A message whose header cannot be read returns `null`. The store counts these messages as `other`
+and does not keep them (they are not weather conditions at a station).
+
+Honest limits: AIRMET, NIL and SNOWTAM were written from the ICAO specification because no real
+messages could be collected (aviationweather.gov does not publish them; the Bureau of Meteorology
+blocks automated access, so Darwin VAAC advisories were not collected). Treat those three as
+specification-checked, not field-proven, until real samples are added to `test/fixtures`.
+
+## Operational information
+
+Pure functions that turn conditions into what an aerodrome operation needs. Decisions never rely on
+a guessed threshold: limits, minima and LVP values are passed in by the caller.
+
+| Function | Gives |
+|---|---|
+| `flightCategory(conditions, thresholds?)` | VFR / MVFR / IFR / LIFR from visibility and ceiling (lowest BKN/OVC/VV), what decided it, and whether the ceiling is unknown. Defaults follow the FAA definition (ICAO has no categories); replace with `thresholds` |
+| `windComponents(wind, runwayHeadingTrue)` | headwind, tailwind, crosswind and the side it comes from. A variable wind gives only the upper bound |
+| `runwayAdvice(wind, runways, limits?)` | per runway and direction: steady and gust components, the more favourable direction, `exceeds` flags only for limits you give |
+| `runwayFromHeading`, `runwayFromPolygon`, `headingFromPolygon`, `magneticToTrue` | build runways. METAR wind is **true**; runway headings are usually magnetic, so pass the magnetic variation |
+| `evaluateMinima(conditions, minima)` | below/above, with every reason, and `unknown` for data that is missing or cannot decide (`P2000`, `M0050`). Missing data is never treated as safe. The same function serves LVP thresholds |
+| `upcomingChanges(taf, from, hours, options?)` | category changes, thunderstorm/CB start and end, heavy precipitation, and (when you give the threshold) low visibility and wind changes, each with the TAF group that causes it. What is already happening at `from` is marked `ongoing` |
+| `qnhTrend(previous, current, options?)` | change, rate and direction; `rapid` only against a rate you give |
+| `stationOperations(store, station, at, config?)` | all of the above for one station from a `WeatherStore` |
+
+Decision aid, not an official source.
+

package/dist/aftn.d.ts

@@ -1,13 +1,13 @@
 import type { ReportKind } from "./types.js";
 export interface RawReport {
     kind: ReportKind;
-    /** Teks laporan dari kata kunci (METAR/SPECI/TAF) sampai sebelum `=`, spasi dirapikan. */
+    /** Teks laporan dari kata kunci sampai sebelum laporan berikutnya, spasi dirapikan. */
     text: string;
 }
 /**
- * Ambil laporan cuaca dari teks mentah: boleh berupa laporan polos, buletin dengan header
- * (`SAID31 WARR 021030`), atau pesan AFTN lengkap (`ZCZC ... NNNN` dengan baris alamat). Satu pesan
- * bisa memuat beberapa laporan yang masing-masing diakhiri `=`.
+ * Ambil laporan dari teks mentah: boleh berupa laporan polos, buletin dengan header
+ * (`SAID31 WARR 021030`), atau pesan AFTN lengkap (`ZCZC ... NNNN` dengan baris alamat). Banyak laporan
+ * dalam satu pesan dipisah per kata kunci, dengan atau tanpa tanda `=`.
  */
 export declare function extractReports(message: string): RawReport[];
 //# sourceMappingURL=aftn.d.ts.map

package/dist/aftn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aftn.d.ts","sourceRoot":"","sources":["../src/aftn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAe3D"}
+{"version":3,"file":"aftn.d.ts","sourceRoot":"","sources":["../src/aftn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;CACd;AAYD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAwB3D"}

package/dist/animation.d.ts

@@ -78,9 +78,25 @@ export interface SnapshotInput {
     maxObservationAgeMs?: number;
     includeProbable?: boolean;
 }
+/** Kondisi yang berlaku di satu stasiun pada satu waktu, dan dari mana asalnya. */
+export interface SelectedConditions {
+    conditions: Conditions;
+    source: AnimationSource;
+    station: string;
+    /** Waktu yang diwakili data ini. */
+    validAt: Date;
+    /** Pengamatan lebih tua dari batas, dan tidak ada TAF yang berlaku sebagai gantinya. */
+    stale: boolean;
+    /** Dari TAF: kondisi sementara (TEMPO) sedang berlaku. */
+    temporary: boolean;
+    /** Dari TAF: 0-1 selama transisi BECMG berjalan. */
+    transition: number | null;
+}
 /**
  * Pilih sumber terbaik untuk waktu `at`: pengamatan (METAR/SPECI) yang masih segar, lalu TAF yang
  * berlaku, lalu pengamatan lama (ditandai stale). Null bila tidak ada data sama sekali.
  */
+export declare function selectConditions(input: SnapshotInput): SelectedConditions | null;
+/** Seperti `selectConditions`, tetapi sudah diubah menjadi parameter animasi. */
 export declare function animationSnapshot(input: SnapshotInput): AnimationSnapshot | null;
 //# sourceMappingURL=animation.d.ts.map

package/dist/animation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../src/animation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,UAAU,EAAE,KAAK,EAAkB,GAAG,EAAE,MAAM,YAAY,CAAC;AAErF,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAC7E,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE1F,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uDAAuD;IACvD,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC7B,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE;QACJ,yDAAyD;QACzD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,wEAAwE;QACxE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,mFAAmF;QACnF,SAAS,EAAE,MAAM,CAAC;QAClB,+EAA+E;QAC/E,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,MAAM,EAAE;QACN,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,iDAAiD;QACjD,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,6DAA6D;QAC7D,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,WAAW,EAAE;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/D,aAAa,EAAE;QACb,IAAI,EAAE,iBAAiB,CAAC;QACxB,+CAA+C;QAC/C,SAAS,EAAE,MAAM,CAAC;QAClB,kEAAkE;QAClE,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;KACnB,GAAG,IAAI,CAAC;IACT,YAAY,EAAE;QACZ,oCAAoC;QACpC,QAAQ,EAAE,OAAO,CAAC;QAClB,uCAAuC;QACvC,QAAQ,EAAE,OAAO,CAAC;QAClB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,GAAG,IAAI,CAAC;CACV;AAuED,kFAAkF;AAClF,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,CA+D9E;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,OAAO,EAAE,IAAI,CAAC;IACd,wFAAwF;IACxF,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IACtB,yFAAyF;IACzF,EAAE,CAAC,EAAE,IAAI,CAAC;IACV,iGAAiG;IACjG,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB,GAAG,IAAI,CA6ChF"}
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../src/animation.ts"],"names":[],"mappings":"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"}

package/dist/conditions.d.ts

@@ -1,4 +1,4 @@
-import type { CloudLayer, Conditions, PresentWeather, Wind } from "./types.js";
+import type { CloudLayer, Conditions, PresentWeather, Rvr, Wind } from "./types.js";
 export declare function emptyConditions(): Conditions;
 export interface ConditionTokens {
     wind?: Wind;
@@ -6,6 +6,7 @@ export interface ConditionTokens {
     cavok?: boolean;
     clouds?: CloudLayer[];
     weather?: PresentWeather[];
+    rvr?: Rvr[];
     noSignificantWeather?: boolean;
     /** Token yang tidak dikenali (diteruskan ke pemanggil, mis. suhu atau QNH). */
     rest: string[];

package/dist/conditions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../src/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,UAAU,EACV,UAAU,EACV,cAAc,EACd,IAAI,EAEL,MAAM,YAAY,CAAC;AAYpB,wBAAgB,eAAe,IAAI,UAAU,CAa5C;AAgCD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,CAkFtE;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7D,UAAU,CAqBZ"}
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../src/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,UAAU,EACV,UAAU,EACV,cAAc,EACd,GAAG,EACH,IAAI,EAEL,MAAM,YAAY,CAAC;AAgCpB,wBAAgB,eAAe,IAAI,UAAU,CAa5C;AAgCD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;IACZ,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,CA+JtE;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7D,UAAU,CAsBZ"}

package/dist/geo.d.ts

@@ -0,0 +1,54 @@
+/** Posisi dan ketinggian pada pesan peringatan (SIGMET, AIRMET, VAA): murni, tanpa jaringan. */
+export interface GeoPosition {
+    lat: number;
+    lon: number;
+}
+export type Compass = "N" | "NNE" | "NE" | "ENE" | "E" | "ESE" | "SE" | "SSE" | "S" | "SSW" | "SW" | "WSW" | "W" | "WNW" | "NW" | "NNW";
+export declare const isCompass: (value: string) => value is Compass;
+/** Derajat dari utara untuk arah mata angin 16 titik. */
+export declare const compassDegrees: (direction: Compass) => number;
+/**
+ * Satu titik seperti `N1034 W07726` atau `S0200W07820`. Lintang `ddmm` (atau `dd`), bujur `dddmm` (atau
+ * `ddd`). Bujur empat angka (`W5815`, salah ketik yang ada pada laporan nyata) dibaca `ddmm`.
+ */
+export declare const POINT: string;
+export declare function parsePosition(text: string): GeoPosition | null;
+/** Semua titik dalam teks, berurutan. */
+export declare function parsePositions(text: string): GeoPosition[];
+/** Rentang ketinggian dalam kaki; `null` = tidak disebut, `0` = permukaan (SFC). */
+export interface AltitudeRange {
+    baseFt: number | null;
+    topFt: number | null;
+    /** `TOP ABV FL450`: puncaknya di atas nilai itu. */
+    topAbove?: boolean;
+}
+export declare const ALTITUDE_PATTERNS: {
+    /** `TOP FL490`, `TOP ABV FL450`, `TOP FL250/390`. */
+    readonly top: RegExp;
+    /** `FL240/300`, `SFC/FL100`, `SFC/6000FT`, `2000/4000FT`. */
+    readonly range: RegExp;
+    /** `ABV FL250` sendirian. */
+    readonly above: RegExp;
+};
+/**
+ * Cari satu petunjuk ketinggian dalam `text`. Mengembalikan rentangnya dan bagian teks yang dipakai,
+ * atau null.
+ */
+export declare function findAltitude(text: string): {
+    range: AltitudeRange;
+    matched: string;
+} | null;
+export interface Movement {
+    stationary: boolean;
+    direction?: Compass;
+    /** Kecepatan (kt); untuk rentang (`10-15KT`) nilai terbesar. */
+    speedKt?: number;
+    /** Batas bawah bila kecepatan dilaporkan sebagai rentang. */
+    speedMinKt?: number;
+}
+/** `MOV NW 10KT`, `MOV ENE`, `MOV E 25KMH`, `STNR`. */
+export declare function findMovement(text: string): {
+    movement: Movement;
+    matched: string;
+} | null;
+//# sourceMappingURL=geo.d.ts.map

package/dist/geo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo.d.ts","sourceRoot":"","sources":["../src/geo.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,OAAO,GACf,GAAG,GACH,KAAK,GACL,IAAI,GACJ,KAAK,GACL,GAAG,GACH,KAAK,GACL,IAAI,GACJ,KAAK,GACL,GAAG,GACH,KAAK,GACL,IAAI,GACJ,KAAK,GACL,GAAG,GACH,KAAK,GACL,IAAI,GACJ,KAAK,CAAC;AAqBV,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,KAAK,IAAI,OAAmC,CAAC;AAEvF,yDAAyD;AACzD,eAAO,MAAM,cAAc,GAAI,WAAW,OAAO,KAAG,MAAoC,CAAC;AAEzF;;;GAGG;AACH,eAAO,MAAM,KAAK,QAAwC,CAAC;AAW3D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAU9D;AAED,yCAAyC;AACzC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAO1D;AAED,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAeD,eAAO,MAAM,iBAAiB;IAC5B,qDAAqD;;IAErD,6DAA6D;;IAE7D,6BAA6B;;CAErB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsC3F;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmBzF"}

package/dist/index.d.ts

@@ -2,16 +2,25 @@ import type { Report } from "./types.js";
 export * from "./aftn.js";
 export * from "./animation.js";
 export * from "./conditions.js";
+export * from "./geo.js";
 export * from "./grid.js";
 export * from "./gridSeries.js";
 export * from "./openMeteo.js";
 export * from "./metar.js";
+export * from "./nil.js";
+export * from "./operations.js";
+export * from "./ops.js";
+export * from "./runway.js";
+export * from "./sigmet.js";
+export * from "./snowtam.js";
 export * from "./taf.js";
 export * from "./store.js";
 export * from "./time.js";
 export * from "./types.js";
+export * from "./vaa.js";
 /**
- * Baca semua laporan cuaca (METAR, SPECI, TAF) dari satu pesan mentah, termasuk bungkus AFTN.
+ * Baca semua laporan cuaca dari satu pesan mentah, termasuk bungkus AFTN: METAR, SPECI, TAF, NIL,
+ * SIGMET, AIRMET, pemberitahuan abu vulkanik (VAA), dan SNOWTAM.
  * Laporan yang tidak terbaca dilewati. `reference` = waktu pesan diterima (menentukan bulan/tahun).
  */
 export declare function decodeWeatherMessage(message: string, reference?: Date): Report[];

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAE3B;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,IAAiB,GAC3B,MAAM,EAAE,CAUV"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AAEzB;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,IAAiB,GAC3B,MAAM,EAAE,CA0BV"}