@fieldia/map 0.0.0-stage → 0.14.0

package/src/lib/geo.d.mts

@@ -0,0 +1,72 @@
+import type { JsonValue } from '@fieldia/core';
+/**
+ * Places and areas as a form keeps them: GeoJSON (RFC 7946), longitude
+ * first, so any backend or map library reads them as they are. A place is a
+ * Point. An area is a Feature whose `properties.shape` says how it was drawn,
+ * so it comes back as the same shape with the same grips: a polygon, a box
+ * (a polygon of four corners), or a circle (its centre as a Point and its
+ * `radius` in metres, since GeoJSON has no circle).
+ */
+export interface LatLng {
+    lat: number;
+    lng: number;
+}
+export type Shape = 'polygon' | 'box' | 'circle';
+export type Area = {
+    shape: 'polygon' | 'box';
+    points: LatLng[];
+} | {
+    shape: 'circle';
+    center: LatLng;
+    radius: number;
+};
+export type PointsArea = Extract<Area, {
+    points: LatLng[];
+}>;
+export type CircleArea = Extract<Area, {
+    shape: 'circle';
+}>;
+export interface Bounds {
+    south: number;
+    west: number;
+    north: number;
+    east: number;
+}
+export interface PointGeometry {
+    type: 'Point';
+    coordinates: [number, number];
+}
+export interface AreaFeature {
+    type: 'Feature';
+    properties: {
+        shape: Shape;
+        radius?: number;
+    };
+    geometry: PointGeometry | {
+        type: 'Polygon';
+        coordinates: [number, number][][];
+    };
+}
+export declare const isLatLng: (lat: unknown, lng: unknown) => boolean;
+/** A place's value: a GeoJSON Point. */
+export declare function writePoint(point: LatLng): PointGeometry;
+/** The place a value holds: a Point, or a Feature holding one; anything else is no place. */
+export declare function readPoint(value: unknown): LatLng | null;
+/** An area's value: a GeoJSON Feature, its ring closed and counter-clockwise as RFC 7946 asks. */
+export declare function writeArea(area: Area): AreaFeature;
+/** The area a value holds, as it was drawn; a plain Polygon from elsewhere is read as a polygon. */
+export declare function readArea(value: unknown): Area | null;
+/** A coordinate as a person types it: a point or a comma for the decimals, Western or Arabic digits. */
+export declare function parseCoordinate(text: string): number | null;
+/** Metres between two places on the ground (the haversine formula). */
+export declare function metresBetween(a: LatLng, b: LatLng): number;
+/** The place `metres` due east: where a circle's edge grip sits. */
+export declare function offsetEast(from: LatLng, metres: number): LatLng;
+/** A box's four corners from two dragged to, counter-clockwise from the south-west. */
+export declare function boxFrom(a: LatLng, b: LatLng): LatLng[];
+/** The same area, carried by so many degrees. */
+export declare function moveArea(area: Area, dLat: number, dLng: number): Area;
+/** The smallest box an area fits in. */
+export declare function areaBounds(area: Area): Bounds;
+/** A value fit for a json field. */
+export declare const asJson: (value: AreaFeature | PointGeometry) => JsonValue;

package/src/lib/geo.d.ts

@@ -0,0 +1,72 @@
+import type { JsonValue } from '@fieldia/core';
+/**
+ * Places and areas as a form keeps them: GeoJSON (RFC 7946), longitude
+ * first, so any backend or map library reads them as they are. A place is a
+ * Point. An area is a Feature whose `properties.shape` says how it was drawn,
+ * so it comes back as the same shape with the same grips: a polygon, a box
+ * (a polygon of four corners), or a circle (its centre as a Point and its
+ * `radius` in metres, since GeoJSON has no circle).
+ */
+export interface LatLng {
+    lat: number;
+    lng: number;
+}
+export type Shape = 'polygon' | 'box' | 'circle';
+export type Area = {
+    shape: 'polygon' | 'box';
+    points: LatLng[];
+} | {
+    shape: 'circle';
+    center: LatLng;
+    radius: number;
+};
+export type PointsArea = Extract<Area, {
+    points: LatLng[];
+}>;
+export type CircleArea = Extract<Area, {
+    shape: 'circle';
+}>;
+export interface Bounds {
+    south: number;
+    west: number;
+    north: number;
+    east: number;
+}
+export interface PointGeometry {
+    type: 'Point';
+    coordinates: [number, number];
+}
+export interface AreaFeature {
+    type: 'Feature';
+    properties: {
+        shape: Shape;
+        radius?: number;
+    };
+    geometry: PointGeometry | {
+        type: 'Polygon';
+        coordinates: [number, number][][];
+    };
+}
+export declare const isLatLng: (lat: unknown, lng: unknown) => boolean;
+/** A place's value: a GeoJSON Point. */
+export declare function writePoint(point: LatLng): PointGeometry;
+/** The place a value holds: a Point, or a Feature holding one; anything else is no place. */
+export declare function readPoint(value: unknown): LatLng | null;
+/** An area's value: a GeoJSON Feature, its ring closed and counter-clockwise as RFC 7946 asks. */
+export declare function writeArea(area: Area): AreaFeature;
+/** The area a value holds, as it was drawn; a plain Polygon from elsewhere is read as a polygon. */
+export declare function readArea(value: unknown): Area | null;
+/** A coordinate as a person types it: a point or a comma for the decimals, Western or Arabic digits. */
+export declare function parseCoordinate(text: string): number | null;
+/** Metres between two places on the ground (the haversine formula). */
+export declare function metresBetween(a: LatLng, b: LatLng): number;
+/** The place `metres` due east: where a circle's edge grip sits. */
+export declare function offsetEast(from: LatLng, metres: number): LatLng;
+/** A box's four corners from two dragged to, counter-clockwise from the south-west. */
+export declare function boxFrom(a: LatLng, b: LatLng): LatLng[];
+/** The same area, carried by so many degrees. */
+export declare function moveArea(area: Area, dLat: number, dLng: number): Area;
+/** The smallest box an area fits in. */
+export declare function areaBounds(area: Area): Bounds;
+/** A value fit for a json field. */
+export declare const asJson: (value: AreaFeature | PointGeometry) => JsonValue;

package/src/lib/geo.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asJson = exports.isLatLng = void 0;
+exports.writePoint = writePoint;
+exports.readPoint = readPoint;
+exports.writeArea = writeArea;
+exports.readArea = readArea;
+exports.parseCoordinate = parseCoordinate;
+exports.metresBetween = metresBetween;
+exports.offsetEast = offsetEast;
+exports.boxFrom = boxFrom;
+exports.moveArea = moveArea;
+exports.areaBounds = areaBounds;
+/** The earth's mean radius, in metres: the one GeoJSON's distances are usually worked out with. */
+const EARTH = 6371008.8;
+const rad = (degrees) => (degrees * Math.PI) / 180;
+const deg = (radians) => (radians * 180) / Math.PI;
+/** Six decimals: about 11 cm on the ground, finer than any finger. */
+const round6 = (n) => Math.round(n * 1e6) / 1e6;
+const isLatLng = (lat, lng) => typeof lat === 'number' && typeof lng === 'number' && Number.isFinite(lat) && Number.isFinite(lng) && Math.abs(lat) <= 90 && Math.abs(lng) <= 180;
+exports.isLatLng = isLatLng;
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** A place's value: a GeoJSON Point. */
+function writePoint(point) {
+    return { type: 'Point', coordinates: [round6(point.lng), round6(point.lat)] };
+}
+function geometryOf(value) {
+    if (!isObject(value))
+        return null;
+    if (value['type'] === 'Feature')
+        return isObject(value['geometry']) ? value['geometry'] : null;
+    return value;
+}
+function latLngOf(position) {
+    if (!Array.isArray(position))
+        return null;
+    const [lng, lat] = position;
+    return (0, exports.isLatLng)(lat, lng) ? { lat: lat, lng: lng } : null;
+}
+/** The place a value holds: a Point, or a Feature holding one; anything else is no place. */
+function readPoint(value) {
+    const geometry = geometryOf(value);
+    return geometry?.['type'] === 'Point' ? latLngOf(geometry['coordinates']) : null;
+}
+/** The signed area of a ring in degrees: above zero when it runs counter-clockwise. */
+function signedArea(points) {
+    let sum = 0;
+    points.forEach((p, i) => {
+        const q = points[(i + 1) % points.length];
+        sum += p.lng * q.lat - q.lng * p.lat;
+    });
+    return sum / 2;
+}
+/** An area's value: a GeoJSON Feature, its ring closed and counter-clockwise as RFC 7946 asks. */
+function writeArea(area) {
+    if (area.shape === 'circle') {
+        return { type: 'Feature', properties: { shape: 'circle', radius: Math.round(area.radius) }, geometry: writePoint(area.center) };
+    }
+    const [first, ...rest] = area.points;
+    const ring = signedArea(area.points) < 0 ? [first, ...rest.reverse()] : area.points;
+    const coordinates = [...ring, ring[0]].map((p) => [round6(p.lng), round6(p.lat)]);
+    return { type: 'Feature', properties: { shape: area.shape }, geometry: { type: 'Polygon', coordinates: [coordinates] } };
+}
+/** The area a value holds, as it was drawn; a plain Polygon from elsewhere is read as a polygon. */
+function readArea(value) {
+    const geometry = geometryOf(value);
+    if (!geometry)
+        return null;
+    const properties = isObject(value) && value['type'] === 'Feature' && isObject(value['properties']) ? value['properties'] : {};
+    if (geometry['type'] === 'Point') {
+        const center = latLngOf(geometry['coordinates']);
+        const radius = properties['radius'];
+        return center && properties['shape'] === 'circle' && typeof radius === 'number' && radius > 0 ? { shape: 'circle', center, radius } : null;
+    }
+    if (geometry['type'] !== 'Polygon' || !Array.isArray(geometry['coordinates']))
+        return null;
+    const ring = (geometry['coordinates'][0] ?? []);
+    const points = ring.map(latLngOf);
+    if (points.some((p) => p === null))
+        return null;
+    const open = points;
+    const last = open[open.length - 1];
+    // The ring's closing point repeats its first: drawn once.
+    if (open.length > 1 && last.lat === open[0].lat && last.lng === open[0].lng)
+        open.pop();
+    if (open.length < 3)
+        return null;
+    return { shape: properties['shape'] === 'box' && open.length === 4 ? 'box' : 'polygon', points: open };
+}
+const ARABIC_DIGITS = '٠١٢٣٤٥٦٧٨٩';
+/** A coordinate as a person types it: a point or a comma for the decimals, Western or Arabic digits. */
+function parseCoordinate(text) {
+    const plain = text
+        .trim()
+        .replace(/[٠-٩]/g, (d) => String(ARABIC_DIGITS.indexOf(d)))
+        .replace(/[٫,]/g, '.')
+        .replace(/^[−–]/, '-');
+    if (!/^-?\d+(\.\d+)?$/.test(plain))
+        return null;
+    return Number(plain);
+}
+/** Metres between two places on the ground (the haversine formula). */
+function metresBetween(a, b) {
+    const dLat = rad(b.lat - a.lat);
+    const dLng = rad(b.lng - a.lng);
+    const h = Math.sin(dLat / 2) ** 2 + Math.cos(rad(a.lat)) * Math.cos(rad(b.lat)) * Math.sin(dLng / 2) ** 2;
+    return 2 * EARTH * Math.asin(Math.min(1, Math.sqrt(h)));
+}
+/** The place `metres` due east: where a circle's edge grip sits. */
+function offsetEast(from, metres) {
+    return { lat: from.lat, lng: from.lng + deg(metres / (EARTH * Math.cos(rad(from.lat)))) };
+}
+/** A box's four corners from two dragged to, counter-clockwise from the south-west. */
+function boxFrom(a, b) {
+    const south = Math.min(a.lat, b.lat);
+    const north = Math.max(a.lat, b.lat);
+    const west = Math.min(a.lng, b.lng);
+    const east = Math.max(a.lng, b.lng);
+    return [
+        { lat: south, lng: west },
+        { lat: south, lng: east },
+        { lat: north, lng: east },
+        { lat: north, lng: west },
+    ];
+}
+/** The same area, carried by so many degrees. */
+function moveArea(area, dLat, dLng) {
+    const move = (p) => ({ lat: p.lat + dLat, lng: p.lng + dLng });
+    return area.shape === 'circle' ? { ...area, center: move(area.center) } : { ...area, points: area.points.map(move) };
+}
+/** The smallest box an area fits in. */
+function areaBounds(area) {
+    const points = area.shape === 'circle'
+        ? [
+            { lat: area.center.lat + deg(area.radius / EARTH), lng: offsetEast(area.center, area.radius).lng },
+            { lat: area.center.lat - deg(area.radius / EARTH), lng: 2 * area.center.lng - offsetEast(area.center, area.radius).lng },
+        ]
+        : area.points;
+    return {
+        south: Math.min(...points.map((p) => p.lat)),
+        west: Math.min(...points.map((p) => p.lng)),
+        north: Math.max(...points.map((p) => p.lat)),
+        east: Math.max(...points.map((p) => p.lng)),
+    };
+}
+/** A value fit for a json field. */
+const asJson = (value) => value;
+exports.asJson = asJson;
+//# sourceMappingURL=geo.js.map

package/src/lib/geo.js.map

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

package/src/lib/geo.mjs

@@ -0,0 +1,134 @@
+/** The earth's mean radius, in metres: the one GeoJSON's distances are usually worked out with. */
+const EARTH = 6371008.8;
+const rad = (degrees) => (degrees * Math.PI) / 180;
+const deg = (radians) => (radians * 180) / Math.PI;
+/** Six decimals: about 11 cm on the ground, finer than any finger. */
+const round6 = (n) => Math.round(n * 1e6) / 1e6;
+export const isLatLng = (lat, lng) => typeof lat === 'number' && typeof lng === 'number' && Number.isFinite(lat) && Number.isFinite(lng) && Math.abs(lat) <= 90 && Math.abs(lng) <= 180;
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** A place's value: a GeoJSON Point. */
+export function writePoint(point) {
+    return { type: 'Point', coordinates: [round6(point.lng), round6(point.lat)] };
+}
+function geometryOf(value) {
+    if (!isObject(value))
+        return null;
+    if (value['type'] === 'Feature')
+        return isObject(value['geometry']) ? value['geometry'] : null;
+    return value;
+}
+function latLngOf(position) {
+    if (!Array.isArray(position))
+        return null;
+    const [lng, lat] = position;
+    return isLatLng(lat, lng) ? { lat: lat, lng: lng } : null;
+}
+/** The place a value holds: a Point, or a Feature holding one; anything else is no place. */
+export function readPoint(value) {
+    const geometry = geometryOf(value);
+    return geometry?.['type'] === 'Point' ? latLngOf(geometry['coordinates']) : null;
+}
+/** The signed area of a ring in degrees: above zero when it runs counter-clockwise. */
+function signedArea(points) {
+    let sum = 0;
+    points.forEach((p, i) => {
+        const q = points[(i + 1) % points.length];
+        sum += p.lng * q.lat - q.lng * p.lat;
+    });
+    return sum / 2;
+}
+/** An area's value: a GeoJSON Feature, its ring closed and counter-clockwise as RFC 7946 asks. */
+export function writeArea(area) {
+    if (area.shape === 'circle') {
+        return { type: 'Feature', properties: { shape: 'circle', radius: Math.round(area.radius) }, geometry: writePoint(area.center) };
+    }
+    const [first, ...rest] = area.points;
+    const ring = signedArea(area.points) < 0 ? [first, ...rest.reverse()] : area.points;
+    const coordinates = [...ring, ring[0]].map((p) => [round6(p.lng), round6(p.lat)]);
+    return { type: 'Feature', properties: { shape: area.shape }, geometry: { type: 'Polygon', coordinates: [coordinates] } };
+}
+/** The area a value holds, as it was drawn; a plain Polygon from elsewhere is read as a polygon. */
+export function readArea(value) {
+    const geometry = geometryOf(value);
+    if (!geometry)
+        return null;
+    const properties = isObject(value) && value['type'] === 'Feature' && isObject(value['properties']) ? value['properties'] : {};
+    if (geometry['type'] === 'Point') {
+        const center = latLngOf(geometry['coordinates']);
+        const radius = properties['radius'];
+        return center && properties['shape'] === 'circle' && typeof radius === 'number' && radius > 0 ? { shape: 'circle', center, radius } : null;
+    }
+    if (geometry['type'] !== 'Polygon' || !Array.isArray(geometry['coordinates']))
+        return null;
+    const ring = (geometry['coordinates'][0] ?? []);
+    const points = ring.map(latLngOf);
+    if (points.some((p) => p === null))
+        return null;
+    const open = points;
+    const last = open[open.length - 1];
+    // The ring's closing point repeats its first: drawn once.
+    if (open.length > 1 && last.lat === open[0].lat && last.lng === open[0].lng)
+        open.pop();
+    if (open.length < 3)
+        return null;
+    return { shape: properties['shape'] === 'box' && open.length === 4 ? 'box' : 'polygon', points: open };
+}
+const ARABIC_DIGITS = '٠١٢٣٤٥٦٧٨٩';
+/** A coordinate as a person types it: a point or a comma for the decimals, Western or Arabic digits. */
+export function parseCoordinate(text) {
+    const plain = text
+        .trim()
+        .replace(/[٠-٩]/g, (d) => String(ARABIC_DIGITS.indexOf(d)))
+        .replace(/[٫,]/g, '.')
+        .replace(/^[−–]/, '-');
+    if (!/^-?\d+(\.\d+)?$/.test(plain))
+        return null;
+    return Number(plain);
+}
+/** Metres between two places on the ground (the haversine formula). */
+export function metresBetween(a, b) {
+    const dLat = rad(b.lat - a.lat);
+    const dLng = rad(b.lng - a.lng);
+    const h = Math.sin(dLat / 2) ** 2 + Math.cos(rad(a.lat)) * Math.cos(rad(b.lat)) * Math.sin(dLng / 2) ** 2;
+    return 2 * EARTH * Math.asin(Math.min(1, Math.sqrt(h)));
+}
+/** The place `metres` due east: where a circle's edge grip sits. */
+export function offsetEast(from, metres) {
+    return { lat: from.lat, lng: from.lng + deg(metres / (EARTH * Math.cos(rad(from.lat)))) };
+}
+/** A box's four corners from two dragged to, counter-clockwise from the south-west. */
+export function boxFrom(a, b) {
+    const south = Math.min(a.lat, b.lat);
+    const north = Math.max(a.lat, b.lat);
+    const west = Math.min(a.lng, b.lng);
+    const east = Math.max(a.lng, b.lng);
+    return [
+        { lat: south, lng: west },
+        { lat: south, lng: east },
+        { lat: north, lng: east },
+        { lat: north, lng: west },
+    ];
+}
+/** The same area, carried by so many degrees. */
+export function moveArea(area, dLat, dLng) {
+    const move = (p) => ({ lat: p.lat + dLat, lng: p.lng + dLng });
+    return area.shape === 'circle' ? { ...area, center: move(area.center) } : { ...area, points: area.points.map(move) };
+}
+/** The smallest box an area fits in. */
+export function areaBounds(area) {
+    const points = area.shape === 'circle'
+        ? [
+            { lat: area.center.lat + deg(area.radius / EARTH), lng: offsetEast(area.center, area.radius).lng },
+            { lat: area.center.lat - deg(area.radius / EARTH), lng: 2 * area.center.lng - offsetEast(area.center, area.radius).lng },
+        ]
+        : area.points;
+    return {
+        south: Math.min(...points.map((p) => p.lat)),
+        west: Math.min(...points.map((p) => p.lng)),
+        north: Math.max(...points.map((p) => p.lat)),
+        east: Math.max(...points.map((p) => p.lng)),
+    };
+}
+/** A value fit for a json field. */
+export const asJson = (value) => value;
+//# sourceMappingURL=geo.mjs.map

package/src/lib/geo.mjs.map

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

package/src/lib/kinds.d.mts

@@ -0,0 +1,35 @@
+import type { Field, FieldNode, Locale, Page } from '@fieldia/core';
+import { type MapLabels } from './labels.mjs';
+/**
+ * The maps as kinds of field in Fieldia's designer: Place and Area in its
+ * toolbox, each with its settings on the picked field. Pass them to the
+ * designer as `kinds`, and the widgets as `widgets`, as an app does its own
+ * kinds. Shaped as the designer's AppKind, without this package needing the
+ * designer.
+ */
+export interface MapKindContext {
+    document: Document;
+    /** Keeps settings on the field's place on the page (`node.options`); null takes one away. */
+    set(patch: Record<string, string | number | boolean | null>): boolean;
+}
+export interface MapKind {
+    id: string;
+    label: string;
+    group: string;
+    icon: string;
+    widget: string;
+    field(label: string): Field;
+    fits(field: Field): boolean;
+    settings(context: MapKindContext): {
+        element: HTMLElement;
+        refresh(page: Page, node: FieldNode): void;
+    };
+    preview(context: {
+        document: Document;
+    }): HTMLElement;
+}
+/** Place and Area for the designer, in its language. */
+export declare function mapKinds(options?: {
+    locale?: Locale;
+    labels?: Partial<MapLabels>;
+}): MapKind[];

package/src/lib/kinds.d.ts

@@ -0,0 +1,35 @@
+import type { Field, FieldNode, Locale, Page } from '@fieldia/core';
+import { type MapLabels } from './labels';
+/**
+ * The maps as kinds of field in Fieldia's designer: Place and Area in its
+ * toolbox, each with its settings on the picked field. Pass them to the
+ * designer as `kinds`, and the widgets as `widgets`, as an app does its own
+ * kinds. Shaped as the designer's AppKind, without this package needing the
+ * designer.
+ */
+export interface MapKindContext {
+    document: Document;
+    /** Keeps settings on the field's place on the page (`node.options`); null takes one away. */
+    set(patch: Record<string, string | number | boolean | null>): boolean;
+}
+export interface MapKind {
+    id: string;
+    label: string;
+    group: string;
+    icon: string;
+    widget: string;
+    field(label: string): Field;
+    fits(field: Field): boolean;
+    settings(context: MapKindContext): {
+        element: HTMLElement;
+        refresh(page: Page, node: FieldNode): void;
+    };
+    preview(context: {
+        document: Document;
+    }): HTMLElement;
+}
+/** Place and Area for the designer, in its language. */
+export declare function mapKinds(options?: {
+    locale?: Locale;
+    labels?: Partial<MapLabels>;
+}): MapKind[];

package/src/lib/kinds.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapKinds = mapKinds;
+const labels_1 = require("./labels");
+const PIN_ICON = '<path d="M12 21s-6.5-6.2-6.5-11.2a6.5 6.5 0 0 1 13 0C18.5 14.8 12 21 12 21z" fill="none" stroke="currentColor" stroke-width="1.8"/><circle cx="12" cy="9.8" r="2.4" fill="none" stroke="currentColor" stroke-width="1.8"/>';
+const AREA_ICON = '<path d="M4.5 8.5 11 4l8.5 5-2.5 10.5H7.5z" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linejoin="round"/>';
+const HEIGHTS = [
+    ['heightSmall', 200],
+    ['heightMedium', 280],
+    ['heightLarge', 400],
+];
+/** A setting: words then a choice, or a tick then its words, as the designer's own ticks read. */
+function row(doc, words, control) {
+    const label = doc.createElement('label');
+    label.className = 'fd-inline-setting';
+    const span = doc.createElement('span');
+    span.textContent = words;
+    if (control instanceof HTMLInputElement && control.type === 'checkbox')
+        label.append(control, span);
+    else
+        label.append(span, control);
+    return label;
+}
+/** The settings side by side, spaced so each tick plainly goes with its own words. */
+function settingsRow(doc) {
+    const element = doc.createElement('div');
+    element.className = 'fd-map-settings';
+    element.style.cssText = 'display:flex;flex-wrap:wrap;align-items:center;gap:8px 20px;';
+    return element;
+}
+function checkbox(doc, onChange) {
+    const box = doc.createElement('input');
+    box.type = 'checkbox';
+    box.addEventListener('change', () => onChange(box.checked));
+    return box;
+}
+function heightSetting(doc, words, set) {
+    const select = doc.createElement('select');
+    select.className = 'fd-inline-select';
+    for (const [key, px] of HEIGHTS)
+        select.append(new Option(words[key], String(px)));
+    select.addEventListener('change', () => set({ height: select.value === '280' ? null : Number(select.value) }));
+    return { element: row(doc, words.settingHeight, select), read: (node) => (select.value = String(node.options?.['height'] ?? 280)) };
+}
+/** The demo's drawing on a closed card: a pin or an outline on a faint grid, never a live map. */
+function previewOf(doc, icon, words) {
+    const element = doc.createElement('div');
+    element.className = 'fd-map-preview';
+    element.style.cssText = 'display:flex;align-items:center;gap:8px;padding:10px 12px;border:1px dashed var(--fd-border);border-radius:var(--fd-control-radius);color:var(--fd-muted);font-size:13px;';
+    element.innerHTML = `<svg viewBox="0 0 24 24" width="22" height="22" aria-hidden="true">${icon}</svg>`;
+    element.append(words);
+    return element;
+}
+/** Place and Area for the designer, in its language. */
+function mapKinds(options = {}) {
+    const words = (0, labels_1.mapLabels)(options.locale, options.labels);
+    const place = {
+        id: 'map-place',
+        label: words.placeKind,
+        group: words.mapsGroup,
+        icon: PIN_ICON,
+        widget: 'place',
+        field: (label) => ({ type: 'json', label }),
+        fits: (field) => field.type === 'json',
+        settings({ document: doc, set }) {
+            const myLocation = checkbox(doc, (on) => set({ myLocation: on ? null : false }));
+            const search = checkbox(doc, (on) => set({ search: on ? null : false }));
+            const height = heightSetting(doc, words, set);
+            const element = settingsRow(doc);
+            element.append(row(doc, words.settingMyLocation, myLocation), row(doc, words.settingSearch, search), height.element);
+            return {
+                element,
+                refresh(_page, node) {
+                    myLocation.checked = node.options?.['myLocation'] !== false;
+                    search.checked = node.options?.['search'] !== false;
+                    height.read(node);
+                },
+            };
+        },
+        preview: ({ document: doc }) => previewOf(doc, PIN_ICON, words.placeKind),
+    };
+    const area = {
+        id: 'map-area',
+        label: words.areaKind,
+        group: words.mapsGroup,
+        icon: AREA_ICON,
+        widget: 'area',
+        field: (label) => ({ type: 'json', label }),
+        fits: (field) => field.type === 'json',
+        settings({ document: doc, set }) {
+            const element = settingsRow(doc);
+            const boxes = ['polygon', 'box', 'circle'].map((shape) => {
+                const box = checkbox(doc, () => {
+                    const on = boxes.filter((b) => b.box.checked).map((b) => b.shape);
+                    // At least one shape stays: the last one ticked cannot be taken away.
+                    if (!on.length) {
+                        box.checked = true;
+                        return;
+                    }
+                    set({ shapes: on.length === 3 ? null : on.join(',') });
+                });
+                element.append(row(doc, words[shape], box));
+                return { shape, box };
+            });
+            const legend = doc.createElement('span');
+            legend.className = 'fd-map-settings-title';
+            legend.style.cssText = 'font-weight:600;';
+            legend.textContent = words.settingShapes;
+            element.prepend(legend);
+            const height = heightSetting(doc, words, set);
+            element.append(height.element);
+            return {
+                element,
+                refresh(_page, node) {
+                    const raw = node.options?.['shapes'];
+                    const listed = Array.isArray(raw) ? raw.map(String) : typeof raw === 'string' ? raw.split(',').map((s) => s.trim()) : null;
+                    for (const { shape, box } of boxes)
+                        box.checked = !listed || listed.includes(shape);
+                    height.read(node);
+                },
+            };
+        },
+        preview: ({ document: doc }) => previewOf(doc, AREA_ICON, words.areaKind),
+    };
+    return [place, area];
+}
+//# sourceMappingURL=kinds.js.map