@ixo/openhands-sdk 0.0.0-stage → 0.2.0

package/dist/cjs/geo/exifcarry.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Moving a photograph's own metadata onto a smaller copy of itself.
+ *
+ * The problem this solves is concrete and was found in a village: the upload
+ * ceiling is a few megabytes, phone photographs are routinely 2–5 MB, and
+ * a canvas resize — the obvious fix — **throws away the EXIF the whole check
+ * reads**. So a worker either cannot upload, or uploads something nobody can
+ * verify. Neither is a product.
+ *
+ * The answer is to keep the camera's own APP1 segment byte for byte and put it
+ * back on the resized image. What that claims is exactly what it should: this
+ * is the same photograph, at fewer pixels, and its metadata is the camera's
+ * unmodified. Nothing is invented — the alternative is a stripped file, which
+ * is strictly less true.
+ *
+ * It is worth being plain that EXIF is editable by anyone who wants to, which
+ * is why every gate that reads it calls itself client-assisted. Carrying it
+ * across a resize does not make it weaker; it keeps it exactly as weak as it
+ * already was.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exifSegment = exifSegment;
+exports.withExifSegment = withExifSegment;
+/** The `FF E1 … Exif\0\0 …` segment, exactly as the camera wrote it. */
+function exifSegment(bytes) {
+    if (bytes.length < 4 || bytes[0] !== 0xff || bytes[1] !== 0xd8)
+        return null;
+    let at = 2;
+    while (at + 4 <= bytes.length) {
+        if (bytes[at] !== 0xff)
+            return null;
+        const marker = bytes[at + 1];
+        /* Start of scan: the pixels begin and the metadata is behind us. */
+        if (marker === 0xda)
+            return null;
+        const length = (bytes[at + 2] << 8) | bytes[at + 3];
+        if (length < 2)
+            return null;
+        if (marker === 0xe1 && at + 10 <= bytes.length) {
+            const isExif = bytes[at + 4] === 0x45 && bytes[at + 5] === 0x78 && bytes[at + 6] === 0x69 && bytes[at + 7] === 0x66;
+            if (isExif)
+                return bytes.slice(at, at + 2 + length);
+        }
+        at += 2 + length;
+    }
+    return null;
+}
+/**
+ * Put a segment back, immediately after the start-of-image marker.
+ *
+ * Any APP1 the encoder wrote itself is dropped first: two Exif segments is an
+ * ambiguity readers resolve differently, including ours, which takes the first
+ * it meets. One photograph, one answer about where it was taken.
+ */
+function withExifSegment(jpeg, segment) {
+    if (jpeg.length < 2 || jpeg[0] !== 0xff || jpeg[1] !== 0xd8)
+        return jpeg;
+    const kept = [];
+    let at = 2;
+    while (at + 4 <= jpeg.length) {
+        if (jpeg[at] !== 0xff)
+            break;
+        const marker = jpeg[at + 1];
+        if (marker === 0xda)
+            break;
+        const length = (jpeg[at + 2] << 8) | jpeg[at + 3];
+        if (length < 2)
+            break;
+        if (marker !== 0xe1)
+            kept.push(...Array.from(jpeg.slice(at, at + 2 + length)));
+        at += 2 + length;
+    }
+    const out = new Uint8Array(2 + segment.length + kept.length + (jpeg.length - at));
+    out.set([0xff, 0xd8], 0);
+    out.set(segment, 2);
+    out.set(Uint8Array.from(kept), 2 + segment.length);
+    out.set(jpeg.slice(at), 2 + segment.length + kept.length);
+    return out;
+}
+//# sourceMappingURL=exifcarry.js.map

package/dist/cjs/geo/exifcarry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exifcarry.js","sourceRoot":"","sources":["../../../src/geo/exifcarry.ts"],"names":[],"mappings":"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"}

package/dist/cjs/geo/exifnote.d.ts

@@ -0,0 +1,86 @@
+/**
+ * The app's own note of when and where, written into the photograph.
+ *
+ * A live capture through `<input capture>` on iOS hands the page a JPEG with
+ * an APP1 stub — orientation and nothing else — while a photo-roll pick
+ * carries the camera's full EXIF (Michael's iPhone 16 Pro, iOS 26.6.2,
+ * 2026-09-19). The page knows the moment and the place anyway: `nowAndHere`
+ * asks the browser as the shutter closes and the envelope carries the
+ * answer. But the oracle's stock before/after gate reads the photographs,
+ * not the envelope, so a live-capture cleanup was refused before any judge
+ * saw it.
+ *
+ * This writes that same note where the gate looks: a minimal, valid
+ * `Exif\0\0` TIFF block with `DateTimeOriginal` (+ its offset), a GPS IFD
+ * when the place is known, and `Software = "openhands-app"` so a reviewer
+ * can tell the app's note from a camera's. It **never overwrites a camera's
+ * own values**: a photograph that already says when and where is left
+ * untouched; one that says only one of the two keeps that value and gains
+ * the other. The orientation tag a stub carries is kept, so the picture
+ * still stands the right way up.
+ *
+ * As with everything EXIF, this is client-assisted evidence and says so:
+ * the note is the phone's testimony about itself, exactly as it was in the
+ * envelope — no more true, no less, only now where the check reads it.
+ *
+ * Little-endian TIFF, offsets relative to the TIFF header, values of four
+ * bytes or fewer inline, the rest in a data area after the IFDs — the shape
+ * `exif.ts` (and the oracle's port of it) reads.
+ */
+export interface ExifNote {
+    /** The moment, as an ISO instant. A value with no zone is read as UTC. */
+    at: string;
+    lat?: number;
+    lon?: number;
+}
+export interface NoteOptions {
+    /** The local offset to write the time in, minutes east of UTC. Default: this runtime's offset at that instant. */
+    offsetMinutes?: number;
+    /** What `Software` says. */
+    software?: string;
+}
+export interface Noted {
+    bytes: Uint8Array;
+    /** Whether anything was written. False is not a failure: a camera's own EXIF is the better note. */
+    noted: boolean;
+    why: "camera-exif" | "not-jpeg" | "nothing-to-note" | null;
+}
+export declare const NOTE_SOFTWARE = "openhands-app";
+/** Degrees as the three positive rationals EXIF wants; the sign is the caller's letter. */
+export declare function dms(value: number): [number, number, number][];
+/** An ISO instant, or a zone-less stamp read as UTC. Null when it is neither. */
+export declare function instantOf(at: string): number | null;
+/** `YYYY:MM:DD HH:MM:SS` in the given offset, and the offset as EXIF writes it. */
+export declare function exifClock(instantMs: number, offsetMinutes: number): {
+    stamp: string;
+    offset: string;
+};
+/** The orientation a JPEG's existing APP1 carries, if any. */
+export declare function orientationOf(jpeg: Uint8Array): number | null;
+/** A complete `FF E1` APP1 segment holding the note. Exported for the tests; `noteJpeg` is the door. */
+export declare function noteSegment(parts: {
+    stamp?: string;
+    offset?: string;
+    point?: {
+        lat: number;
+        lon: number;
+    } | null;
+    orientation?: number | null;
+    software?: string;
+}): Uint8Array;
+/**
+ * The note, written into a JPEG that lacks it.
+ *
+ * Untouched when the photograph already says when *and* where — a camera's
+ * word beats the page's. Otherwise the camera's value is kept for whichever
+ * of the two it did give, the note fills the other, and the orientation is
+ * carried over.
+ */
+export declare function noteJpeg(jpeg: Uint8Array, note: ExifNote, options?: NoteOptions): Noted;
+/** The same, for a browser's `File`. A file that needed no note is returned as it was. */
+export declare function noteFile(file: File, note: ExifNote, options?: NoteOptions): Promise<{
+    file: File;
+    noted: boolean;
+    why: Noted["why"];
+}>;
+//# sourceMappingURL=exifnote.d.ts.map

package/dist/cjs/geo/exifnote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exifnote.d.ts","sourceRoot":"","sources":["../../../src/geo/exifnote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,MAAM,WAAW,QAAQ;IACvB,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,kHAAkH;IAClH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,oGAAoG;IACpG,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,aAAa,GAAG,UAAU,GAAG,iBAAiB,GAAG,IAAI,CAAC;CAC5D;AAED,eAAO,MAAM,aAAa,kBAAkB,CAAC;AA6C7C,2FAA2F;AAC3F,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAY7D;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMnD;AAID,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAMrG;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAwB7D;AAgCD,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAoC/K;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,WAAgB,GAAG,KAAK,CA4B3F;AAED,0FAA0F;AAC1F,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;CAAE,CAAC,CAMhJ"}

package/dist/cjs/geo/exifnote.js

@@ -0,0 +1,253 @@
+"use strict";
+/**
+ * The app's own note of when and where, written into the photograph.
+ *
+ * A live capture through `<input capture>` on iOS hands the page a JPEG with
+ * an APP1 stub — orientation and nothing else — while a photo-roll pick
+ * carries the camera's full EXIF (Michael's iPhone 16 Pro, iOS 26.6.2,
+ * 2026-09-19). The page knows the moment and the place anyway: `nowAndHere`
+ * asks the browser as the shutter closes and the envelope carries the
+ * answer. But the oracle's stock before/after gate reads the photographs,
+ * not the envelope, so a live-capture cleanup was refused before any judge
+ * saw it.
+ *
+ * This writes that same note where the gate looks: a minimal, valid
+ * `Exif\0\0` TIFF block with `DateTimeOriginal` (+ its offset), a GPS IFD
+ * when the place is known, and `Software = "openhands-app"` so a reviewer
+ * can tell the app's note from a camera's. It **never overwrites a camera's
+ * own values**: a photograph that already says when and where is left
+ * untouched; one that says only one of the two keeps that value and gains
+ * the other. The orientation tag a stub carries is kept, so the picture
+ * still stands the right way up.
+ *
+ * As with everything EXIF, this is client-assisted evidence and says so:
+ * the note is the phone's testimony about itself, exactly as it was in the
+ * envelope — no more true, no less, only now where the check reads it.
+ *
+ * Little-endian TIFF, offsets relative to the TIFF header, values of four
+ * bytes or fewer inline, the rest in a data area after the IFDs — the shape
+ * `exif.ts` (and the oracle's port of it) reads.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOTE_SOFTWARE = void 0;
+exports.dms = dms;
+exports.instantOf = instantOf;
+exports.exifClock = exifClock;
+exports.orientationOf = orientationOf;
+exports.noteSegment = noteSegment;
+exports.noteJpeg = noteJpeg;
+exports.noteFile = noteFile;
+const exif_ts_1 = require("./exif.js");
+const exifcarry_ts_1 = require("./exifcarry.js");
+exports.NOTE_SOFTWARE = "openhands-app";
+const TAG_ORIENTATION = 0x0112;
+const TAG_SOFTWARE = 0x0131;
+const TAG_EXIF_IFD = 0x8769;
+const TAG_GPS_IFD = 0x8825;
+const TAG_DATE_ORIGINAL = 0x9003;
+const TAG_OFFSET_ORIGINAL = 0x9011;
+const TAG_GPS_VERSION = 0x0000;
+const TAG_LAT_REF = 0x0001;
+const TAG_LAT = 0x0002;
+const TAG_LON_REF = 0x0003;
+const TAG_LON = 0x0004;
+const BYTE = 1;
+const ASCII = 2;
+const SHORT = 3;
+const LONG = 4;
+const RATIONAL = 5;
+const le16 = (value) => [value & 0xff, (value >>> 8) & 0xff];
+const le32 = (value) => [value & 0xff, (value >>> 8) & 0xff, (value >>> 16) & 0xff, (value >>> 24) & 0xff];
+const asciiEntry = (tag, text) => {
+    const bytes = Uint8Array.from([...text].map((ch) => ch.charCodeAt(0) & 0x7f).concat(0));
+    return { tag, type: ASCII, count: bytes.length, data: bytes };
+};
+const shortEntry = (tag, value) => ({ tag, type: SHORT, count: 1, data: Uint8Array.from(le16(value)) });
+const longEntry = (tag, value) => ({ tag, type: LONG, count: 1, data: Uint8Array.from(le32(value)) });
+const bytesEntry = (tag, values) => ({ tag, type: BYTE, count: values.length, data: Uint8Array.from(values) });
+const rationalsEntry = (tag, pairs) => ({
+    tag,
+    type: RATIONAL,
+    count: pairs.length,
+    data: Uint8Array.from(pairs.flatMap(([numerator, denominator]) => [...le32(numerator), ...le32(denominator)]))
+});
+/** Degrees as the three positive rationals EXIF wants; the sign is the caller's letter. */
+function dms(value) {
+    const abs = Math.abs(value);
+    const degrees = Math.floor(abs);
+    const minutesFull = (abs - degrees) * 60;
+    const minutes = Math.floor(minutesFull);
+    /* Seconds to a ten-thousandth — about three millimetres — as a rational. */
+    const seconds = Math.round((minutesFull - minutes) * 60 * 10_000);
+    return [
+        [degrees, 1, 0],
+        [minutes, 1, 0],
+        [seconds, 10_000, 0]
+    ];
+}
+/** An ISO instant, or a zone-less stamp read as UTC. Null when it is neither. */
+function instantOf(at) {
+    const text = at.trim();
+    if (!text)
+        return null;
+    const zoned = /(?:Z|[+-]\d{2}:?\d{2})$/i.test(text);
+    const ms = Date.parse(zoned ? text : `${text}Z`);
+    return Number.isFinite(ms) ? ms : null;
+}
+const two = (n) => String(n).padStart(2, "0");
+/** `YYYY:MM:DD HH:MM:SS` in the given offset, and the offset as EXIF writes it. */
+function exifClock(instantMs, offsetMinutes) {
+    const local = new Date(instantMs + offsetMinutes * 60_000);
+    const stamp = `${local.getUTCFullYear()}:${two(local.getUTCMonth() + 1)}:${two(local.getUTCDate())} ${two(local.getUTCHours())}:${two(local.getUTCMinutes())}:${two(local.getUTCSeconds())}`;
+    const sign = offsetMinutes < 0 ? "-" : "+";
+    const abs = Math.abs(offsetMinutes);
+    return { stamp, offset: `${sign}${two(Math.floor(abs / 60))}:${two(abs % 60)}` };
+}
+/** The orientation a JPEG's existing APP1 carries, if any. */
+function orientationOf(jpeg) {
+    const segment = (0, exifcarry_ts_1.exifSegment)(jpeg);
+    if (!segment || segment.length < 10 + 8)
+        return null;
+    try {
+        const view = new DataView(segment.buffer, segment.byteOffset + 10, segment.byteLength - 10);
+        const order = view.getUint16(0, false);
+        if (order !== 0x4949 && order !== 0x4d4d)
+            return null;
+        const little = order === 0x4949;
+        const ifd0 = view.getUint32(4, little);
+        if (ifd0 + 2 > view.byteLength)
+            return null;
+        const count = view.getUint16(ifd0, little);
+        if (count > 200)
+            return null;
+        for (let index = 0; index < count; index += 1) {
+            const entry = ifd0 + 2 + index * 12;
+            if (entry + 12 > view.byteLength)
+                return null;
+            if (view.getUint16(entry, little) === TAG_ORIENTATION) {
+                const value = view.getUint16(entry + 8, little);
+                return value >= 1 && value <= 8 ? value : null;
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/** Serialise IFDs into one TIFF block: header, the tables in order, then every value that did not fit inline. */
+function tiff(ifds) {
+    const HEADER = 8;
+    const sizes = ifds.map((entries) => 2 + entries.length * 12 + 4);
+    const starts = [];
+    let at = HEADER;
+    for (const size of sizes) {
+        starts.push(at);
+        at += size;
+    }
+    const dataStart = at;
+    const data = [];
+    const tables = ifds.map((entries) => {
+        const table = [...le16(entries.length)];
+        for (const entry of [...entries].sort((a, b) => a.tag - b.tag)) {
+            table.push(...le16(entry.tag), ...le16(entry.type), ...le32(entry.count));
+            if (entry.data.length <= 4) {
+                table.push(...entry.data, ...new Array(4 - entry.data.length).fill(0));
+            }
+            else {
+                table.push(...le32(dataStart + data.length));
+                data.push(...entry.data);
+                if (data.length % 2 === 1)
+                    data.push(0);
+            }
+        }
+        table.push(...le32(0));
+        return table;
+    });
+    return Uint8Array.from([0x49, 0x49, ...le16(0x2a), ...le32(HEADER), ...tables.flat(), ...data]);
+}
+/** A complete `FF E1` APP1 segment holding the note. Exported for the tests; `noteJpeg` is the door. */
+function noteSegment(parts) {
+    const ifd0 = [asciiEntry(TAG_SOFTWARE, parts.software ?? exports.NOTE_SOFTWARE)];
+    if (parts.orientation)
+        ifd0.push(shortEntry(TAG_ORIENTATION, parts.orientation));
+    const ifds = [ifd0];
+    const exif = [];
+    if (parts.stamp)
+        exif.push(asciiEntry(TAG_DATE_ORIGINAL, parts.stamp));
+    if (parts.stamp && parts.offset)
+        exif.push(asciiEntry(TAG_OFFSET_ORIGINAL, parts.offset));
+    const gps = [];
+    if (parts.point) {
+        gps.push(bytesEntry(TAG_GPS_VERSION, [2, 3, 0, 0]));
+        gps.push(asciiEntry(TAG_LAT_REF, parts.point.lat < 0 ? "S" : "N"));
+        gps.push(rationalsEntry(TAG_LAT, dms(parts.point.lat).map(([n, d]) => [n, d])));
+        gps.push(asciiEntry(TAG_LON_REF, parts.point.lon < 0 ? "W" : "E"));
+        gps.push(rationalsEntry(TAG_LON, dms(parts.point.lon).map(([n, d]) => [n, d])));
+    }
+    /* The pointers need the tables' places, which depend only on entry counts. */
+    const HEADER = 8;
+    const ifd0Size = 2 + (ifd0.length + (exif.length ? 1 : 0) + (gps.length ? 1 : 0)) * 12 + 4;
+    let next = HEADER + ifd0Size;
+    if (exif.length) {
+        ifd0.push(longEntry(TAG_EXIF_IFD, next));
+        ifds.push(exif);
+        next += 2 + exif.length * 12 + 4;
+    }
+    if (gps.length) {
+        ifd0.push(longEntry(TAG_GPS_IFD, next));
+        ifds.push(gps);
+    }
+    const block = tiff(ifds);
+    const payload = [0x45, 0x78, 0x69, 0x66, 0, 0, ...block];
+    const length = payload.length + 2;
+    return Uint8Array.from([0xff, 0xe1, (length >>> 8) & 0xff, length & 0xff, ...payload]);
+}
+/**
+ * The note, written into a JPEG that lacks it.
+ *
+ * Untouched when the photograph already says when *and* where — a camera's
+ * word beats the page's. Otherwise the camera's value is kept for whichever
+ * of the two it did give, the note fills the other, and the orientation is
+ * carried over.
+ */
+function noteJpeg(jpeg, note, options = {}) {
+    if (jpeg.length < 4 || jpeg[0] !== 0xff || jpeg[1] !== 0xd8)
+        return { bytes: jpeg, noted: false, why: "not-jpeg" };
+    const facts = (0, exif_ts_1.factsFromJpeg)(jpeg);
+    if (facts.takenAt && facts.point)
+        return { bytes: jpeg, noted: false, why: "camera-exif" };
+    let stamp;
+    let offset;
+    if (facts.takenAt) {
+        /* The camera's own local stamp, exactly as it wrote it — its offset is unknown and not invented. */
+        const [date, clock] = facts.takenAt.split("T");
+        stamp = `${date.replaceAll("-", ":")} ${clock ?? "00:00:00"}`;
+    }
+    else {
+        const instant = instantOf(note.at);
+        if (instant !== null) {
+            const offsetMinutes = options.offsetMinutes ?? -new Date(instant).getTimezoneOffset();
+            ({ stamp, offset } = exifClock(instant, offsetMinutes));
+        }
+    }
+    const point = facts.point ??
+        (typeof note.lat === "number" && typeof note.lon === "number" && Number.isFinite(note.lat) && Number.isFinite(note.lon) && Math.abs(note.lat) <= 90 && Math.abs(note.lon) <= 180
+            ? { lat: note.lat, lon: note.lon }
+            : null);
+    if (!stamp && !point)
+        return { bytes: jpeg, noted: false, why: "nothing-to-note" };
+    const segment = noteSegment({ stamp, offset, point, orientation: orientationOf(jpeg), software: options.software });
+    return { bytes: (0, exifcarry_ts_1.withExifSegment)(jpeg, segment), noted: true, why: null };
+}
+/** The same, for a browser's `File`. A file that needed no note is returned as it was. */
+async function noteFile(file, note, options = {}) {
+    if (file.type && !/^image\/jpe?g$/i.test(file.type))
+        return { file, noted: false, why: "not-jpeg" };
+    const bytes = new Uint8Array(await file.arrayBuffer());
+    const result = noteJpeg(bytes, note, options);
+    if (!result.noted)
+        return { file, noted: false, why: result.why };
+    return { file: new File([result.bytes], file.name || "photo.jpg", { type: "image/jpeg", lastModified: file.lastModified }), noted: true, why: null };
+}
+//# sourceMappingURL=exifnote.js.map

package/dist/cjs/geo/exifnote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exifnote.js","sourceRoot":"","sources":["../../../src/geo/exifnote.ts"],"names":[],"mappings":"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"}

package/dist/cjs/geo/mentions.d.ts

@@ -0,0 +1,44 @@
+import { type FoundPlace, type Reach } from "./search.ts";
+/** A word as the comparisons see it: lower case, accents off. "Smokuč" and "smokuc" are one word. */
+export declare const fold: (word: string) => string;
+/**
+ * The phrases a sentence puts after a word like *in* or *at*, in order, with
+ * leading articles and descriptions trimmed — and only those that hold at
+ * least one word that names something. At most three: a sentence that names
+ * more places than that is describing a route, and the first is where it
+ * starts.
+ */
+export declare function placeMentions(sentence: string): string[];
+/** Does a phrase say what kind of place it is, beside its name? "prešeren square" does; "Smokuč Slovenia" does not. */
+export declare const saysWhatItIs: (mention: string) => boolean;
+/**
+ * The first place the map answered that is called by the phrase's naming
+ * words. A town, a street, a park, a venue counts on one shared name. A shop
+ * or a hotel counts only when every naming word matches, and there are at
+ * least two: "Pekarna Kroštl" is somewhere to go; "bloom", in "a tree in
+ * bloom", is a florist in another country.
+ */
+export declare function placeCalled(mention: string, places: FoundPlace[]): FoundPlace | null;
+export interface NamedPlace {
+    /** The phrase as the sentence says it: "ljubljana, prešeren square". */
+    mention: string;
+    /** Where the map put it, when it could: the sheet opens on this. */
+    found: FoundPlace | null;
+}
+/**
+ * The place a sentence names, and whether the answer can be trusted.
+ *
+ * `named` is null when it names none — and null too when the map could not be
+ * asked about a phrase only the map could settle, because a lookup that
+ * failed is not a reason to refuse somebody's ask. `unsure` says which: an
+ * answer given while the map was unreachable is not one to cache. A phrase
+ * that says what it is ("… square") never needs the map to count, only to be
+ * found.
+ */
+export declare function placeIn(sentence: string, reach?: Reach): Promise<{
+    named: NamedPlace | null;
+    unsure: boolean;
+}>;
+/** The place a sentence names, or null. See `placeIn` for when null means "could not tell". */
+export declare const namedPlaceIn: (sentence: string, reach?: Reach) => Promise<NamedPlace | null>;
+//# sourceMappingURL=mentions.d.ts.map

package/dist/cjs/geo/mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.d.ts","sourceRoot":"","sources":["../../../src/geo/mentions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAwExE,qGAAqG;AACrG,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAIlB,CAAC;AAYnB;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAqCxD;AAED,uHAAuH;AACvH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,OAAoF,CAAC;AAYpI;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,GAAG,IAAI,CAQpF;AAED,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1B;AAKD;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,KAAU,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAyBzH;AAED,+FAA+F;AAC/F,eAAO,MAAM,YAAY,GAAU,UAAU,MAAM,EAAE,QAAO,KAAU,KAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAA2C,CAAC"}