kaax-mcp 0.1.5 → 0.1.7

package/dist/gis-io.d.ts

@@ -0,0 +1,57 @@
+/**
+ * GIS file I/O — read/write Shapefile, KML and GeoJSON locally.
+ *
+ * All in-memory representations use **GeoJSON** so every GIS operation
+ * downstream (turf, shp-write, KML serialisation) speaks the same dialect.
+ *
+ * Coordinate reference: everything stays in WGS84 / EPSG:4326. Kaax does
+ * not support other CRS, and turf operations assume lon/lat input. If a
+ * Shapefile carries a sibling .prj that is not WGS84 we log a warning
+ * but read the coordinates as-is — re-projecting in pure JS without a
+ * proj4 dependency would be a footgun.
+ */
+import type { FeatureCollection, Geometry } from "geojson";
+export type AnyFeatureCollection = FeatureCollection<Geometry, Record<string, unknown>>;
+/**
+ * Read every feature from a `.shp` (+ sibling `.dbf` for attributes) into
+ * an in-memory GeoJSON FeatureCollection. The `.shp` extension is added
+ * automatically if the caller passes the base name.
+ */
+export declare function readShapefile(shpPath: string): Promise<AnyFeatureCollection>;
+/**
+ * Write a FeatureCollection to disk as a Shapefile **bundle**.
+ *
+ * shp-write packages SHP + SHX + DBF + PRJ into one ZIP, which is the
+ * portable shape ESRI ships and what every QGIS / ArcGIS user expects.
+ * If you need the bare `.shp` next to other tools, unzip it after.
+ *
+ * The output path is treated as the base name — we append `.zip` ourselves
+ * so callers can't accidentally clobber a SHP alongside the archive.
+ */
+export declare function writeShapefileZip(fc: AnyFeatureCollection, outputBasePath: string): Promise<string>;
+/** Read a `.geojson` / `.json` file into a FeatureCollection. */
+export declare function readGeoJSON(path: string): Promise<AnyFeatureCollection>;
+/** Write a FeatureCollection to a `.geojson` file (pretty-printed). */
+export declare function writeGeoJSON(fc: AnyFeatureCollection, outputPath: string): Promise<string>;
+/**
+ * Write a FeatureCollection as KML 2.2. Supports Point, MultiPoint,
+ * LineString, MultiLineString, Polygon and MultiPolygon. Any feature
+ * properties become `<ExtendedData>` so the data round-trips through
+ * QGIS / Google Earth without loss.
+ */
+export declare function writeKML(fc: AnyFeatureCollection, outputPath: string, options?: {
+    documentName?: string;
+}): Promise<string>;
+/** Detect format from extension. Returns `"unknown"` if we don't handle it. */
+export declare function detectFormat(path: string): "shp" | "kml" | "geojson" | "unknown";
+/**
+ * Read any supported GIS file into a FeatureCollection. Used by tools so
+ * the user can pass `.shp`, `.kml` or `.geojson` interchangeably.
+ */
+export declare function readAny(path: string): Promise<AnyFeatureCollection>;
+/**
+ * Resolve an output path, defaulting to alongside the input file with a
+ * suffix and the requested extension. Keeps the tool surface tidy when
+ * the caller didn't specify an explicit destination.
+ */
+export declare function defaultOutputPath(inputPath: string, suffix: string, ext: string): string;

package/dist/gis-io.js

@@ -0,0 +1,270 @@
+/**
+ * GIS file I/O — read/write Shapefile, KML and GeoJSON locally.
+ *
+ * All in-memory representations use **GeoJSON** so every GIS operation
+ * downstream (turf, shp-write, KML serialisation) speaks the same dialect.
+ *
+ * Coordinate reference: everything stays in WGS84 / EPSG:4326. Kaax does
+ * not support other CRS, and turf operations assume lon/lat input. If a
+ * Shapefile carries a sibling .prj that is not WGS84 we log a warning
+ * but read the coordinates as-is — re-projecting in pure JS without a
+ * proj4 dependency would be a footgun.
+ */
+import { open as openShapefile } from "shapefile";
+import shpwrite from "@mapbox/shp-write";
+import { create as xmlCreate } from "xmlbuilder2";
+import { existsSync } from "fs";
+import { readFile, writeFile } from "fs/promises";
+import { basename, dirname, extname, join } from "path";
+// ─────────────────────────────────────────────────────────────────────────
+// Shapefile (read)
+// ─────────────────────────────────────────────────────────────────────────
+/**
+ * Read every feature from a `.shp` (+ sibling `.dbf` for attributes) into
+ * an in-memory GeoJSON FeatureCollection. The `.shp` extension is added
+ * automatically if the caller passes the base name.
+ */
+export async function readShapefile(shpPath) {
+    const finalPath = shpPath.toLowerCase().endsWith(".shp")
+        ? shpPath
+        : `${shpPath}.shp`;
+    if (!existsSync(finalPath)) {
+        throw new Error(`Shapefile not found: ${finalPath}`);
+    }
+    const dbfPath = finalPath.replace(/\.shp$/i, ".dbf");
+    const features = [];
+    // The shapefile package exposes an iterator on the returned source
+    // (`source.read()`), not a top-level `read(source)`. Different versions
+    // of @types/shapefile typed this differently; we cast to keep the call
+    // site portable.
+    const source = (await openShapefile(finalPath, existsSync(dbfPath) ? dbfPath : undefined, { encoding: "utf8" }));
+    try {
+        while (true) {
+            const next = await source.read();
+            if (next.done)
+                break;
+            const feat = next.value;
+            if (feat?.geometry)
+                features.push(feat);
+        }
+    }
+    finally {
+        if (typeof source.close === "function")
+            await source.close();
+    }
+    return {
+        type: "FeatureCollection",
+        features,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────
+// Shapefile (write)
+// ─────────────────────────────────────────────────────────────────────────
+/**
+ * Write a FeatureCollection to disk as a Shapefile **bundle**.
+ *
+ * shp-write packages SHP + SHX + DBF + PRJ into one ZIP, which is the
+ * portable shape ESRI ships and what every QGIS / ArcGIS user expects.
+ * If you need the bare `.shp` next to other tools, unzip it after.
+ *
+ * The output path is treated as the base name — we append `.zip` ourselves
+ * so callers can't accidentally clobber a SHP alongside the archive.
+ */
+export async function writeShapefileZip(fc, outputBasePath) {
+    const out = outputBasePath.toLowerCase().endsWith(".zip")
+        ? outputBasePath
+        : `${outputBasePath}.zip`;
+    // shp-write returns the ZIP as an ArrayBuffer / Uint8Array. Force Buffer
+    // for Node fs.
+    const ab = (await shpwrite.zip(fc));
+    const buf = Buffer.isBuffer(ab)
+        ? ab
+        : Buffer.from(ab instanceof ArrayBuffer ? ab : ab.buffer);
+    await writeFile(out, buf);
+    return out;
+}
+// ─────────────────────────────────────────────────────────────────────────
+// GeoJSON
+// ─────────────────────────────────────────────────────────────────────────
+/** Read a `.geojson` / `.json` file into a FeatureCollection. */
+export async function readGeoJSON(path) {
+    if (!existsSync(path))
+        throw new Error(`GeoJSON not found: ${path}`);
+    const raw = await readFile(path, "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed.type === "FeatureCollection") {
+        return parsed;
+    }
+    if (parsed.type === "Feature") {
+        return {
+            type: "FeatureCollection",
+            features: [parsed],
+        };
+    }
+    throw new Error(`Unexpected GeoJSON shape at ${path}: must be FeatureCollection or Feature`);
+}
+/** Write a FeatureCollection to a `.geojson` file (pretty-printed). */
+export async function writeGeoJSON(fc, outputPath) {
+    await writeFile(outputPath, JSON.stringify(fc, null, 2), "utf8");
+    return outputPath;
+}
+// ─────────────────────────────────────────────────────────────────────────
+// KML
+// ─────────────────────────────────────────────────────────────────────────
+/**
+ * Write a FeatureCollection as KML 2.2. Supports Point, MultiPoint,
+ * LineString, MultiLineString, Polygon and MultiPolygon. Any feature
+ * properties become `<ExtendedData>` so the data round-trips through
+ * QGIS / Google Earth without loss.
+ */
+export async function writeKML(fc, outputPath, options = {}) {
+    const docName = options.documentName ?? basename(outputPath, ".kml");
+    const root = xmlCreate({ version: "1.0", encoding: "UTF-8" })
+        .ele("kml", { xmlns: "http://www.opengis.net/kml/2.2" })
+        .ele("Document")
+        .ele("name")
+        .txt(docName)
+        .up();
+    for (const f of fc.features) {
+        const placemark = root.ele("Placemark");
+        const nameProp = (f.properties?.name ?? f.properties?.Name ?? "");
+        if (nameProp)
+            placemark.ele("name").txt(String(nameProp)).up();
+        // Attributes — preserve everything.
+        if (f.properties && Object.keys(f.properties).length > 0) {
+            const ext = placemark.ele("ExtendedData");
+            for (const [k, v] of Object.entries(f.properties)) {
+                if (v === undefined || v === null)
+                    continue;
+                ext.ele("Data", { name: k }).ele("value").txt(String(v)).up().up();
+            }
+        }
+        appendKmlGeometry(placemark, f.geometry);
+    }
+    const xml = root.end({ prettyPrint: true });
+    await writeFile(outputPath, xml, "utf8");
+    return outputPath;
+}
+function appendKmlGeometry(parent, geom) {
+    switch (geom.type) {
+        case "Point":
+            parent
+                .ele("Point")
+                .ele("coordinates")
+                .txt(geom.coordinates.slice(0, 2).join(","))
+                .up()
+                .up();
+            break;
+        case "MultiPoint": {
+            const multi = parent.ele("MultiGeometry");
+            for (const c of geom.coordinates) {
+                multi
+                    .ele("Point")
+                    .ele("coordinates")
+                    .txt(c.slice(0, 2).join(","))
+                    .up()
+                    .up();
+            }
+            break;
+        }
+        case "LineString":
+            parent
+                .ele("LineString")
+                .ele("coordinates")
+                .txt(geom.coordinates.map((c) => c.slice(0, 2).join(",")).join(" "))
+                .up()
+                .up();
+            break;
+        case "MultiLineString": {
+            const multi = parent.ele("MultiGeometry");
+            for (const ls of geom.coordinates) {
+                multi
+                    .ele("LineString")
+                    .ele("coordinates")
+                    .txt(ls.map((c) => c.slice(0, 2).join(",")).join(" "))
+                    .up()
+                    .up();
+            }
+            break;
+        }
+        case "Polygon":
+            appendPolygonKml(parent, geom.coordinates);
+            break;
+        case "MultiPolygon": {
+            const multi = parent.ele("MultiGeometry");
+            for (const poly of geom.coordinates) {
+                appendPolygonKml(multi, poly);
+            }
+            break;
+        }
+        default:
+            // Other geometry types (GeometryCollection) — skipped intentionally.
+            break;
+    }
+}
+function appendPolygonKml(parent, rings) {
+    const polyEl = parent.ele("Polygon");
+    const [outer, ...inner] = rings;
+    if (outer) {
+        polyEl
+            .ele("outerBoundaryIs")
+            .ele("LinearRing")
+            .ele("coordinates")
+            .txt(outer.map((c) => c.slice(0, 2).join(",")).join(" "))
+            .up()
+            .up()
+            .up();
+    }
+    for (const ring of inner) {
+        polyEl
+            .ele("innerBoundaryIs")
+            .ele("LinearRing")
+            .ele("coordinates")
+            .txt(ring.map((c) => c.slice(0, 2).join(",")).join(" "))
+            .up()
+            .up()
+            .up();
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────
+// Format dispatch
+// ─────────────────────────────────────────────────────────────────────────
+/** Detect format from extension. Returns `"unknown"` if we don't handle it. */
+export function detectFormat(path) {
+    const ext = extname(path).toLowerCase();
+    if (ext === ".shp" || ext === ".zip")
+        return "shp";
+    if (ext === ".kml")
+        return "kml";
+    if (ext === ".geojson" || ext === ".json")
+        return "geojson";
+    return "unknown";
+}
+/**
+ * Read any supported GIS file into a FeatureCollection. Used by tools so
+ * the user can pass `.shp`, `.kml` or `.geojson` interchangeably.
+ */
+export async function readAny(path) {
+    const fmt = detectFormat(path);
+    switch (fmt) {
+        case "shp":
+            return readShapefile(path);
+        case "kml":
+            throw new Error("KML read is not yet implemented in gis-io. For now, convert KML to GeoJSON externally or pass a shapefile / geojson.");
+        case "geojson":
+            return readGeoJSON(path);
+        default:
+            throw new Error(`Unsupported GIS format for ${path}. Supported: .shp, .geojson, .json.`);
+    }
+}
+/**
+ * Resolve an output path, defaulting to alongside the input file with a
+ * suffix and the requested extension. Keeps the tool surface tidy when
+ * the caller didn't specify an explicit destination.
+ */
+export function defaultOutputPath(inputPath, suffix, ext) {
+    const dir = dirname(inputPath);
+    const base = basename(inputPath, extname(inputPath));
+    return join(dir, `${base}${suffix}${ext.startsWith(".") ? ext : `.${ext}`}`);
+}
+//# sourceMappingURL=gis-io.js.map

package/dist/gis-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gis-io.js","sourceRoot":"","sources":["../src/gis-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,QAAQ,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAIxD,4EAA4E;AAC5E,mBAAmB;AACnB,4EAA4E;AAE5E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe;IAEf,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtD,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC;IACrB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,SAAS,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAiD,EAAE,CAAC;IAElE,mEAAmE;IACnE,wEAAwE;IACxE,uEAAuE;IACvE,iBAAiB;IACjB,MAAM,MAAM,GAAG,CAAC,MAAM,aAAa,CACjC,SAAS,EACT,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EACzC,EAAE,QAAQ,EAAE,MAAM,EAAE,CACrB,CAGA,CAAC;IAEF,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAmD,CAAC;YACtE,IAAI,IAAI,EAAE,QAAQ;gBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU;YAAE,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,oBAAoB;AACpB,4EAA4E;AAE5E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,EAAwB,EACxB,cAAsB;IAEtB,MAAM,GAAG,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QACvD,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,GAAG,cAAc,MAAM,CAAC;IAE5B,yEAAyE;IACzE,eAAe;IACf,MAAM,EAAE,GAAG,CAAC,MAAO,QAKjB,CAAC,GAAG,CAAC,EAAE,CAAC,CAA6B,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,EAAiB,CAAC,MAAM,CAAC,CAAC;IAE5E,MAAM,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,4EAA4E;AAC5E,UAAU;AACV,4EAA4E;AAE5E,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY;IAEZ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAEiB,CAAC;IAC/C,IAAK,MAA+B,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QAClE,OAAO,MAA8B,CAAC;IACxC,CAAC;IACD,IAAK,MAAkB,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3C,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,CAAC,MAAoD,CAAC;SACjE,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,wCAAwC,CAC5E,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAAwB,EACxB,UAAkB;IAElB,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACjE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,4EAA4E;AAC5E,MAAM;AACN,4EAA4E;AAE5E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,EAAwB,EACxB,UAAkB,EAClB,UAAqC,EAAE;IAEvC,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,IAAI,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;SAC1D,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;SACvD,GAAG,CAAC,UAAU,CAAC;SACf,GAAG,CAAC,MAAM,CAAC;SACX,GAAG,CAAC,OAAO,CAAC;SACZ,EAAE,EAAE,CAAC;IAER,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,IAAI,IAAI,CAAC,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAW,CAAC;QAC5E,IAAI,QAAQ;YAAE,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC/D,oCAAoC;QACpC,IAAI,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC1C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;oBAAE,SAAS;gBAC5C,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YACrE,CAAC;QACH,CAAC;QACD,iBAAiB,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,UAAU,CAAC;AACpB,CAAC;AAQD,SAAS,iBAAiB,CAAC,MAAc,EAAE,IAAc;IACvD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,OAAO;YACV,MAAM;iBACH,GAAG,CAAC,OAAO,CAAC;iBACZ,GAAG,CAAC,aAAa,CAAC;iBAClB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;iBAC3C,EAAE,EAAE;iBACJ,EAAE,EAAE,CAAC;YACR,MAAM;QACR,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC1C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjC,KAAK;qBACF,GAAG,CAAC,OAAO,CAAC;qBACZ,GAAG,CAAC,aAAa,CAAC;qBAClB,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;qBAC5B,EAAE,EAAE;qBACJ,EAAE,EAAE,CAAC;YACV,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,YAAY;YACf,MAAM;iBACH,GAAG,CAAC,YAAY,CAAC;iBACjB,GAAG,CAAC,aAAa,CAAC;iBAClB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;iBACnE,EAAE,EAAE;iBACJ,EAAE,EAAE,CAAC;YACR,MAAM;QACR,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC1C,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAClC,KAAK;qBACF,GAAG,CAAC,YAAY,CAAC;qBACjB,GAAG,CAAC,aAAa,CAAC;qBAClB,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;qBACrD,EAAE,EAAE;qBACJ,EAAE,EAAE,CAAC;YACV,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,SAAS;YACZ,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;YAC3C,MAAM;QACR,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC1C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACpC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAChC,CAAC;YACD,MAAM;QACR,CAAC;QACD;YACE,qEAAqE;YACrE,MAAM;IACV,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc,EAAE,KAAmB;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;IAChC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM;aACH,GAAG,CAAC,iBAAiB,CAAC;aACtB,GAAG,CAAC,YAAY,CAAC;aACjB,GAAG,CAAC,aAAa,CAAC;aAClB,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aACxD,EAAE,EAAE;aACJ,EAAE,EAAE;aACJ,EAAE,EAAE,CAAC;IACV,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM;aACH,GAAG,CAAC,iBAAiB,CAAC;aACtB,GAAG,CAAC,YAAY,CAAC;aACjB,GAAG,CAAC,aAAa,CAAC;aAClB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aACvD,EAAE,EAAE;aACJ,EAAE,EAAE;aACJ,EAAE,EAAE,CAAC;IACV,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,kBAAkB;AAClB,4EAA4E;AAE5E,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAC1B,IAAY;IAEZ,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACjC,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAC5D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY;IACxC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;QAC7B,KAAK,KAAK;YACR,MAAM,IAAI,KAAK,CACb,sHAAsH,CACvH,CAAC;QACJ,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B;YACE,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,qCAAqC,CACxE,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAiB,EACjB,MAAc,EACd,GAAW;IAEX,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;AAC/E,CAAC"}

package/dist/gis-ops.d.ts

@@ -0,0 +1,112 @@
+/**
+ * GIS operations — pure-JS implementations on top of `@turf/turf` so the
+ * MCP host machine does everything locally and the Kaax server never has
+ * to lift big geometry workloads. Returns FeatureCollections that gis-io
+ * writes out as SHP / KML / GeoJSON.
+ *
+ * Everything operates in WGS84 (lon/lat); distances are great-circle.
+ */
+import type { AnyFeatureCollection } from "./gis-io.js";
+/**
+ * Geometric intersection of every feature in `a` with every feature in
+ * `b`. Returns one feature per non-empty intersection, preserving the
+ * properties of A and prefixing B's properties with `b__` so attribute
+ * collisions don't silently overwrite.
+ *
+ * Useful for "show me which parcels of A fall inside the area of B".
+ */
+export declare function intersectLayers(a: AnyFeatureCollection, b: AnyFeatureCollection): AnyFeatureCollection;
+/**
+ * Geometric difference: every feature in `a` minus the union of features
+ * in `b`. Returns A's properties unchanged.
+ */
+export declare function differenceLayers(a: AnyFeatureCollection, b: AnyFeatureCollection): AnyFeatureCollection;
+/**
+ * Buffer every feature by `distanceMeters`. Negative values shrink
+ * polygons. Useful before splitting parcels — a 1 m negative buffer
+ * pulls geometries off shared edges so neighbour clips don't double-count.
+ */
+export declare function bufferLayer(fc: AnyFeatureCollection, distanceMeters: number): AnyFeatureCollection;
+/**
+ * Clip every feature in `layer` by the polygon mask. Returns only the
+ * portion of each feature that falls **inside** any feature of `mask`.
+ * For lines we use `lineSplit + booleanWithin`; for polygons we use
+ * `intersect`; for points we use `booleanPointInPolygon`.
+ */
+export declare function clipByMask(layer: AnyFeatureCollection, mask: AnyFeatureCollection): AnyFeatureCollection;
+/**
+ * Bin every feature in `layer` as "inside any polygon of `zones`" or
+ * "outside". Lines whose midpoint is in a zone are counted as inside.
+ * Returns two collections so the caller can write them to two SHPs.
+ */
+export declare function extractFeaturesInPolygons(layer: AnyFeatureCollection, zones: AnyFeatureCollection): {
+    inside: AnyFeatureCollection;
+    outside: AnyFeatureCollection;
+};
+/**
+ * Split a FeatureCollection into one FeatureCollection per unique value of
+ * `fieldName`. Features without the field land under the special bucket
+ * `__missing__`. Useful for "I have one SHP with N parcels and I want one
+ * file per parcel".
+ */
+export declare function splitByAttribute(fc: AnyFeatureCollection, fieldName: string): Map<string, AnyFeatureCollection>;
+/**
+ * Add an `id` property to every feature. Modes:
+ *   - "auto":   sequential integers starting at 1
+ *   - "from":   copy the value of another field
+ *   - "manual": caller supplies a `values` array of the same length
+ *
+ * Only adds; never overwrites an existing `id` unless `overwrite: true`.
+ * Kaax expects `id` to be present on every uploaded SHP, so this is the
+ * defensive tool that any agentic flow should call before uploading.
+ */
+export declare function addIdField(fc: AnyFeatureCollection, opts: {
+    mode: "auto";
+    overwrite?: boolean;
+} | {
+    mode: "from";
+    sourceField: string;
+    overwrite?: boolean;
+} | {
+    mode: "manual";
+    values: (string | number)[];
+    overwrite?: boolean;
+}): AnyFeatureCollection;
+/**
+ * Filter features by a predicate over their properties. The expression
+ * is a very small whitelist DSL — only equality, AND, OR — to keep the
+ * MCP from evaluating arbitrary user JS.
+ *
+ * Examples:
+ *   `codigo = 'CCM-12'`
+ *   `region = 'escuintla' AND zafra = 2024`
+ *   `state = 'active' OR state = 'pending'`
+ */
+export declare function filterFeatures(fc: AnyFeatureCollection, expression: string): AnyFeatureCollection;
+export interface ValidationIssue {
+    level: "error" | "warning";
+    code: string;
+    message: string;
+    featureIndex?: number;
+}
+/**
+ * Check a layer for the invariants Kaax expects on upload:
+ *   - Geometries are Polygon or MultiPolygon (Kaax fields are parcels)
+ *   - At least one feature
+ *   - Every feature has a populated `id` property
+ *   - `id` values are unique
+ *   - Coordinates look like WGS84 (lon in [-180, 180], lat in [-90, 90])
+ *   - Polygons close (first == last vertex) — turf usually tolerates open
+ *     polygons but Kaax's ingestion is strict.
+ *
+ * Returns the list of issues found. Caller decides whether to abort, fix
+ * automatically, or surface to the user.
+ */
+export declare function validateForKaax(fc: AnyFeatureCollection): ValidationIssue[];
+/** Exported for tools that want to render summary statistics. */
+export declare function summariseLayer(fc: AnyFeatureCollection): {
+    count: number;
+    byGeometry: Record<string, number>;
+    totalAreaHa?: number;
+    totalLengthM?: number;
+};