@object-ui/plugin-map 17.5.0 → 17.7.0

package/dist/camera.d.ts

@@ -0,0 +1,102 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Initial-camera derivation for ObjectMap (objectui#4941).
+ *
+ * A map view whose query returned records must never first-paint an empty
+ * viewport. The camera is therefore derived from the records themselves: the
+ * marker set's bounding box, handed to MapLibre so it fits the box with the
+ * real container size (`initialViewState.bounds` -> the `bounds` /
+ * `fitBoundsOptions` pair on the MapLibre `Map` constructor, which overrides
+ * `center` / `zoom`).
+ *
+ * Two things this module deliberately does NOT do:
+ *
+ * 1. It does not rescue out-of-range record coordinates. The platform's
+ *    `location` value is `{ lat, lng }` with longitude bounded to [-180, 180]
+ *    by `@objectstack/spec` (`data/field-value.zod.ts`), so a longitude outside
+ *    that range is a producer-side defect, not a dialect this renderer should
+ *    learn to read. `ObjectMap` keeps rejecting such records and counting them
+ *    in its "invalid coordinates" notice. The normalization here is projection
+ *    arithmetic over already-valid values, applied to the CAMERA only.
+ * 2. It does not introduce any authoring surface. The only camera declaration
+ *    read anywhere is the documented `zoom` / `center` pair of the map config
+ *    block (`content/docs/plugins/plugin-map.mdx`), and an author who declares
+ *    it keeps winning over everything computed here.
+ */
+/**
+ * `[[west, south], [east, north]]` — the two-corner form MapLibre accepts as
+ * `LngLatBoundsLike`. `east` may exceed 180: that is how MapLibre expects a box
+ * crossing the antimeridian to be spelled (its own `adjustAntiMeridian` produces
+ * exactly this shape), and it is what keeps the fitted camera on the same world
+ * copy as the markers.
+ */
+export type MarkerBounds = [[number, number], [number, number]];
+/** Breathing room around the fitted box, in pixels. */
+export declare const FIT_PADDING_PX = 48;
+/**
+ * Ceiling for the fitted zoom. A single record — or several records at one
+ * address — fits a zero-width box, and an unbounded fit answers that with the
+ * map's maximum zoom (22): a building-level view of a style whose tiles usually
+ * stop far short of it. City scale is the useful answer instead.
+ */
+export declare const FIT_MAX_ZOOM = 12;
+/** Zoom used when there is nothing to fit: the whole world, not a random sea. */
+export declare const EMPTY_VIEW_ZOOM = 2;
+/**
+ * Zoom used when a partially declared camera pins the position but not the
+ * scale, so the box cannot drive the fit. Same value the component used before
+ * the fit existed.
+ */
+export declare const UNFITTED_CENTER_ZOOM = 3;
+/**
+ * Latitude ceiling for the fitted box. Web Mercator is unbounded at the poles,
+ * so a record sitting exactly at +/-90 projects to infinity and takes the whole
+ * camera with it. Markers themselves stay at their real latitude.
+ */
+export declare const MAX_FIT_LATITUDE = 85;
+/**
+ * Fold any longitude onto the [-180, 180) circle.
+ *
+ * In-range values return unchanged rather than through the modulo, which would
+ * round-trip them into a neighbouring float (-74.006 came back as
+ * -74.00599999999997) and put that drift into every fitted box.
+ */
+export declare function normalizeLongitude(lng: number): number;
+/**
+ * Bounding box of a marker set, along the SHORTEST arc that contains every
+ * marker.
+ *
+ * Why the shortest arc and not `[min(lng), max(lng)]`: the naive extremes read
+ * the circle as a line, so a set straddling the antimeridian (say 179 and -179,
+ * two degrees apart) yields a 358-degree-wide box whose midpoint is 0 — the
+ * antipode of the data, half a planet away. MapLibre then places the markers in
+ * whichever world copy is nearest their previous screen position (`smartWrap`),
+ * which is how a fitted-looking camera ends up showing an empty ocean with the
+ * records sitting on a neighbouring copy of the world.
+ *
+ * The widest EMPTY gap between adjacent longitudes is the seam to cut; what
+ * remains is the shortest containing arc. `west` is the first marker east of
+ * that seam, and the span is measured eastward from it, so the box may extend
+ * past 180.
+ *
+ * @param coordinates marker coordinates in MapLibre order, `[lng, lat]`
+ * @returns the box, or `null` when there is nothing to fit
+ */
+export declare function computeMarkerBounds(coordinates: ReadonlyArray<readonly [number, number]>): MarkerBounds | null;
+/**
+ * Centre of a box from {@link computeMarkerBounds}, for the paths that cannot
+ * hand the box to a fit (a declared zoom with no declared centre). The
+ * longitude is folded back onto the circle so a box crossing the antimeridian
+ * still yields a real centre rather than a value past 180.
+ */
+export declare function boundsCenter(bounds: MarkerBounds): {
+    longitude: number;
+    latitude: number;
+};
+//# sourceMappingURL=camera.d.ts.map

package/dist/camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../src/camera.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhE,uDAAuD;AACvD,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,iFAAiF;AACjF,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGtD;AAKD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACpD,YAAY,GAAG,IAAI,CA8BrB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAM1F"}

package/dist/index.d.ts

@@ -1,6 +1,44 @@
 import { default as React } from 'react';
-import { ObjectMap, ObjectMapProps } from './ObjectMap';
+import { ObjectMap, ObjectMapProps } from './ObjectMap.js';
 export { ObjectMap };
 export type { ObjectMapProps };
 export declare const ObjectMapRenderer: React.FC<any>;
+/**
+ * ⛔ The bare `map` node type key is RETIRED (objectui#10393, executing the
+ * objectui#8008 family ruling of 2026-09-09, route 3). `object-map` is the one
+ * spelling this plugin serves.
+ *
+ * ## What was here, and why it went
+ *
+ * `ComponentRegistry.register('map', ObjectMapRenderer, { namespace: 'view',
+ * ... })` — a second key on the SAME renderer, which stored both `view:map`
+ * and the bare `map` fallback. The declared face admitted only one of the two:
+ * `ObjectMapSchema.type` is the literal `'object-map'` and `AnyComponentSchema`
+ * has no `map` arm, so a node authored `type: 'map'` failed validation
+ * (`invalid_union`) while the registry mounted it. Two published faces,
+ * opposite verdicts — the shape objectui#8008 retired for `gantt`.
+ *
+ * ## Why unregistering is the whole retirement here — measured, not assumed
+ *
+ * ⚠️ `BaseSchema` closes with `[key: string]: any` and `BaseSchemaCore` ends
+ * `.passthrough()`, so a dropped MEMBER KEY is KEPT, not refused (the
+ * objectui#7664 failure). That hazard needs a schema face to arise on, and this
+ * TYPE NAME never had one: in `@object-ui/types` the literal `'map'` appears
+ * only in the stored view-type unions (`NamedListView.type`,
+ * `defaultViewType`), never as a component node type, against a firing control
+ * of two for `object-map` (`objectql.ts` + its Zod mirror). There is no arm to
+ * convert into a named refusal, so unregistering IS the retirement.
+ *
+ * ## ⛔ Two layers, and only one of them moved
+ *
+ * The string `map` also names a STORED `NamedListView.type` — the value
+ * `CreateViewDialog` writes and every tenant's database holds. That layer is
+ * untouched: `plugin-view`'s `ObjectView` and `plugin-list`'s `ListView` each
+ * map a stored `map` view onto the node type they emit (their `case 'map'`
+ * branches), and both already emit `object-map`. ⇒ Every map view any user
+ * ever created through the console already renders through the surviving
+ * spelling; this retirement moves zero stored documents.
+ *
+ * Pinned in `src/index.bareMapKeyRetired-10393.test.tsx`.
+ */
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,CAAC;AAwB/B,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,CAgB3C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,CAAC;AAwB/B,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,CAgB1C,CAAC;AAmEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG"}