@opendfieldmap/map 0.2.0-beta → 0.2.2-beta

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import type { OEM, OEMOptions } from './types';
 export type * from './types';
 export { gameToOEMPosition, gameXZToOEMPosition, mapToGameXZPosition, oemToGamePosition, toOEMMapPosition, fromOEMMapPosition, toOEMLeafletMapPosition } from '@opendfieldmap/core';
-export type { OEMGamePosition, OEMGameTransform, OEMGameXZPosition, OEMMapPosition } from '@opendfieldmap/core';
+export type { OEMGamePosition, OEMGameTransform, OEMGameXZPosition, OEMMapOffset, OEMMapPosition } from '@opendfieldmap/core';
 /** Creates the framework-agnostic OEM rendering kernel in a browser. */
 export declare function createOEM(container: string | HTMLElement, options: OEMOptions): Promise<OEM>;

package/dist/index.js

@@ -2,7 +2,7 @@
 import { loadOEMManifest, validateOEMManifest } from "@opendfieldmap/core";
 import { gameToOEMPosition, gameXZToOEMPosition, mapToGameXZPosition, oemToGamePosition, toOEMMapPosition, fromOEMMapPosition, toOEMLeafletMapPosition } from "@opendfieldmap/core";
 var runtimePromise;
-var loadRuntime = () => runtimePromise ??= import("./runtime-QH7IV2ZV.js");
+var loadRuntime = () => runtimePromise ??= import("./runtime-6E7MGGCD.js");
 if (typeof document !== "undefined") void loadRuntime();
 async function createOEM(container, options) {
   if (typeof document === "undefined") throw new Error("createOEM must run in a browser");
@@ -20,6 +20,7 @@ async function createOEM(container, options) {
   const instance = new OEMClass(element, manifest, options);
   try {
     await instance.setFeatures(options.features ?? {});
+    await instance.prepareSubregionBoundaries();
     if (options.customPointsUrl !== void 0) await instance.loadCustomPoints(options.customPointsUrl);
     options.signal?.throwIfAborted();
     return instance;

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["import { loadOEMManifest, validateOEMManifest } from '@opendfieldmap/core';\nimport type { OEM, OEMOptions } from './types';\nexport type * from './types';\nexport { gameToOEMPosition, gameXZToOEMPosition, mapToGameXZPosition, oemToGamePosition, toOEMMapPosition, fromOEMMapPosition, toOEMLeafletMapPosition } from '@opendfieldmap/core';\nexport type { OEMGamePosition, OEMGameTransform, OEMGameXZPosition, OEMMapPosition } from '@opendfieldmap/core';\n\ntype OEMRuntime = typeof import('./runtime');\nlet runtimePromise: Promise<OEMRuntime> | undefined;\nconst loadRuntime = (): Promise<OEMRuntime> => runtimePromise ??= import('./runtime');\n\nif (typeof document !== 'undefined') void loadRuntime();\n\n/** Creates the framework-agnostic OEM rendering kernel in a browser. */\nexport async function createOEM(container: string | HTMLElement, options: OEMOptions): Promise<OEM> {\n  if (typeof document === 'undefined') throw new Error('createOEM must run in a browser');\n  if (options.customPoints !== undefined && options.customPointsUrl !== undefined) {\n    throw new Error('Pass either customPoints or customPointsUrl, not both');\n  }\n  options.signal?.throwIfAborted();\n  const element = typeof container === 'string' ? document.querySelector<HTMLElement>(container) : container;\n  if (!element) throw new Error(`OEM container not found: ${container}`);\n  const [manifest, { OEM: OEMClass }] = await Promise.all([\n    options.manifest ? validateOEMManifest(options.manifest) : loadOEMManifest(options.resources, options.signal),\n    loadRuntime(),\n  ]);\n  options.signal?.throwIfAborted();\n  const instance = new OEMClass(element, manifest, options);\n  try {\n    await instance.setFeatures(options.features ?? {});\n    if (options.customPointsUrl !== undefined) await instance.loadCustomPoints(options.customPointsUrl);\n    options.signal?.throwIfAborted();\n    return instance;\n  } catch (error) {\n    instance.destroy();\n    throw error;\n  }\n}\n"],
-  "mappings": ";AAAA,SAAS,iBAAiB,2BAA2B;AAGrD,SAAS,mBAAmB,qBAAqB,qBAAqB,mBAAmB,kBAAkB,oBAAoB,+BAA+B;AAI9J,IAAI;AACJ,IAAM,cAAc,MAA2B,mBAAmB,OAAO,uBAAW;AAEpF,IAAI,OAAO,aAAa,YAAa,MAAK,YAAY;AAGtD,eAAsB,UAAU,WAAiC,SAAmC;AAClG,MAAI,OAAO,aAAa,YAAa,OAAM,IAAI,MAAM,iCAAiC;AACtF,MAAI,QAAQ,iBAAiB,UAAa,QAAQ,oBAAoB,QAAW;AAC/E,UAAM,IAAI,MAAM,uDAAuD;AAAA,EACzE;AACA,UAAQ,QAAQ,eAAe;AAC/B,QAAM,UAAU,OAAO,cAAc,WAAW,SAAS,cAA2B,SAAS,IAAI;AACjG,MAAI,CAAC,QAAS,OAAM,IAAI,MAAM,4BAA4B,SAAS,EAAE;AACrE,QAAM,CAAC,UAAU,EAAE,KAAK,SAAS,CAAC,IAAI,MAAM,QAAQ,IAAI;AAAA,IACtD,QAAQ,WAAW,oBAAoB,QAAQ,QAAQ,IAAI,gBAAgB,QAAQ,WAAW,QAAQ,MAAM;AAAA,IAC5G,YAAY;AAAA,EACd,CAAC;AACD,UAAQ,QAAQ,eAAe;AAC/B,QAAM,WAAW,IAAI,SAAS,SAAS,UAAU,OAAO;AACxD,MAAI;AACF,UAAM,SAAS,YAAY,QAAQ,YAAY,CAAC,CAAC;AACjD,QAAI,QAAQ,oBAAoB,OAAW,OAAM,SAAS,iBAAiB,QAAQ,eAAe;AAClG,YAAQ,QAAQ,eAAe;AAC/B,WAAO;AAAA,EACT,SAAS,OAAO;AACd,aAAS,QAAQ;AACjB,UAAM;AAAA,EACR;AACF;",
+  "sourcesContent": ["import { loadOEMManifest, validateOEMManifest } from '@opendfieldmap/core';\nimport type { OEM, OEMOptions } from './types';\nexport type * from './types';\nexport { gameToOEMPosition, gameXZToOEMPosition, mapToGameXZPosition, oemToGamePosition, toOEMMapPosition, fromOEMMapPosition, toOEMLeafletMapPosition } from '@opendfieldmap/core';\nexport type { OEMGamePosition, OEMGameTransform, OEMGameXZPosition, OEMMapOffset, OEMMapPosition } from '@opendfieldmap/core';\n\ntype OEMRuntime = typeof import('./runtime');\nlet runtimePromise: Promise<OEMRuntime> | undefined;\nconst loadRuntime = (): Promise<OEMRuntime> => runtimePromise ??= import('./runtime');\n\nif (typeof document !== 'undefined') void loadRuntime();\n\n/** Creates the framework-agnostic OEM rendering kernel in a browser. */\nexport async function createOEM(container: string | HTMLElement, options: OEMOptions): Promise<OEM> {\n  if (typeof document === 'undefined') throw new Error('createOEM must run in a browser');\n  if (options.customPoints !== undefined && options.customPointsUrl !== undefined) {\n    throw new Error('Pass either customPoints or customPointsUrl, not both');\n  }\n  options.signal?.throwIfAborted();\n  const element = typeof container === 'string' ? document.querySelector<HTMLElement>(container) : container;\n  if (!element) throw new Error(`OEM container not found: ${container}`);\n  const [manifest, { OEM: OEMClass }] = await Promise.all([\n    options.manifest ? validateOEMManifest(options.manifest) : loadOEMManifest(options.resources, options.signal),\n    loadRuntime(),\n  ]);\n  options.signal?.throwIfAborted();\n  const instance = new OEMClass(element, manifest, options);\n  try {\n    await instance.setFeatures(options.features ?? {});\n    await instance.prepareSubregionBoundaries();\n    if (options.customPointsUrl !== undefined) await instance.loadCustomPoints(options.customPointsUrl);\n    options.signal?.throwIfAborted();\n    return instance;\n  } catch (error) {\n    instance.destroy();\n    throw error;\n  }\n}\n"],
+  "mappings": ";AAAA,SAAS,iBAAiB,2BAA2B;AAGrD,SAAS,mBAAmB,qBAAqB,qBAAqB,mBAAmB,kBAAkB,oBAAoB,+BAA+B;AAI9J,IAAI;AACJ,IAAM,cAAc,MAA2B,mBAAmB,OAAO,uBAAW;AAEpF,IAAI,OAAO,aAAa,YAAa,MAAK,YAAY;AAGtD,eAAsB,UAAU,WAAiC,SAAmC;AAClG,MAAI,OAAO,aAAa,YAAa,OAAM,IAAI,MAAM,iCAAiC;AACtF,MAAI,QAAQ,iBAAiB,UAAa,QAAQ,oBAAoB,QAAW;AAC/E,UAAM,IAAI,MAAM,uDAAuD;AAAA,EACzE;AACA,UAAQ,QAAQ,eAAe;AAC/B,QAAM,UAAU,OAAO,cAAc,WAAW,SAAS,cAA2B,SAAS,IAAI;AACjG,MAAI,CAAC,QAAS,OAAM,IAAI,MAAM,4BAA4B,SAAS,EAAE;AACrE,QAAM,CAAC,UAAU,EAAE,KAAK,SAAS,CAAC,IAAI,MAAM,QAAQ,IAAI;AAAA,IACtD,QAAQ,WAAW,oBAAoB,QAAQ,QAAQ,IAAI,gBAAgB,QAAQ,WAAW,QAAQ,MAAM;AAAA,IAC5G,YAAY;AAAA,EACd,CAAC;AACD,UAAQ,QAAQ,eAAe;AAC/B,QAAM,WAAW,IAAI,SAAS,SAAS,UAAU,OAAO;AACxD,MAAI;AACF,UAAM,SAAS,YAAY,QAAQ,YAAY,CAAC,CAAC;AACjD,UAAM,SAAS,2BAA2B;AAC1C,QAAI,QAAQ,oBAAoB,OAAW,OAAM,SAAS,iBAAiB,QAAQ,eAAe;AAClG,YAAQ,QAAQ,eAAe;AAC/B,WAAO;AAAA,EACT,SAAS,OAAO;AACd,aAAS,QAAQ;AACjB,UAAM;AAAA,EACR;AACF;",
   "names": []
 }

package/dist/runtime/geometry.d.ts

@@ -0,0 +1,11 @@
+import type { OEMBoundary } from '@opendfieldmap/core';
+export type GeometryPoint = {
+    x: number;
+    z: number;
+};
+/** Scores a boundary for hit-testing, including polygon holes and edge distance. */
+export declare const boundaryScore: (boundary: OEMBoundary, point: GeometryPoint) => {
+    id: string;
+    inside: boolean;
+    distance: number;
+};

package/dist/runtime/helpers.d.ts

@@ -0,0 +1,12 @@
+import type { OEMPoint, OEMPointFilter } from '@opendfieldmap/core';
+import type { OEMCustomPoint } from '../types';
+export declare const cloneFilter: (filter: OEMPointFilter) => OEMPointFilter;
+export declare const sameFilter: (left: OEMPointFilter, right: OEMPointFilter) => boolean;
+export declare const clonePoint: (point: OEMPoint) => OEMPoint;
+export declare const cloneCustomPoint: (point: OEMCustomPoint) => OEMCustomPoint;
+export declare const CLUSTER_SUBCATEGORIES: Set<string>;
+export declare const FEATURE_NAMES: readonly ["points", "labels", "boundaries"];
+export type OEMFeatureName = typeof FEATURE_NAMES[number];
+export declare const BRAND_URL = "https://oem.re/";
+export declare const GITHUB_URL = "https://github.com/Terra-Online/OEM-SDK";
+export declare const TERMS_URL = "https://blog.opendfieldmap.org/docs/tos#intellectual-property-and-copyright";

package/dist/runtime/index.d.ts

@@ -0,0 +1 @@
+export { OEM } from './oem';

package/dist/runtime/layers.d.ts

@@ -0,0 +1,19 @@
+import L from 'leaflet';
+import type { OEMFloor, OEMRegion } from '@opendfieldmap/core';
+import { SmoothTileLayer } from '../atlos/smoothTileLayer';
+/** Leaflet marker with the subpixel positioning used by Atlos. */
+export declare class OEMMarker extends L.Marker {
+    update(): this;
+    _animateZoom(event: {
+        center: L.LatLng;
+        zoom: number;
+    }): void;
+}
+/** Tile layer that skips coordinates absent from the published coverage index. */
+export declare class CoveredTileLayer extends SmoothTileLayer {
+    private coverage;
+    private floor;
+    constructor(url: string, options: L.TileLayerOptions, coverage: OEMRegion['coverage'], floor: OEMFloor);
+    getTileUrl(coords: L.Coords): string;
+    _isValidTile(coords: L.Coords): boolean;
+}

package/dist/runtime/oem.d.ts

@@ -0,0 +1,145 @@
+import 'leaflet.markercluster';
+import type { OEMManifest, OEMPoint, OEMPointFilter, OEMPosition, OEMView } from '@opendfieldmap/core';
+import type { OEM as OEMContract, OEMClickPointOptions, OEMCustomPoint, OEMEvents, OEMFeatures, OEMOptions, OEMZoomOptions } from '../types';
+/** Leaflet-backed implementation of the public OEM interface. */
+export declare class OEM implements OEMContract {
+    private container;
+    readonly manifest: OEMManifest;
+    private options;
+    destroyed: boolean;
+    private map;
+    private root;
+    private region;
+    private floorId;
+    private features;
+    private boundarySource;
+    private listeners;
+    private requests;
+    private baseTiles?;
+    private floorTiles?;
+    private pointsLayer;
+    private customPointsLayer;
+    private pointClusters;
+    private labelsLayer;
+    private boundariesLayer;
+    private points;
+    private customPoints;
+    private clickPoints;
+    private clickPointOptions?;
+    private clickPointSequence;
+    private customPointsRequest?;
+    private pointIndex?;
+    private pointIndexRequest?;
+    private pointShardRequests;
+    private boundaryData;
+    private boundaryDataRequests;
+    private types;
+    private labels;
+    private visibleLabelType?;
+    private messages;
+    private filter;
+    private markerClustering;
+    private locale;
+    private resolvedLocale;
+    private attributionBrand;
+    private attributionLink;
+    private observer?;
+    private updatingView;
+    private emittedView?;
+    private overdragFrame?;
+    private overdragged;
+    private wheel;
+    constructor(container: HTMLElement, manifest: OEMManifest, options: OEMOptions);
+    /** Prevents calls against a released map instance. */
+    private assertAlive;
+    private validateFloor;
+    private validatePosition;
+    private normalizeCustomPoints;
+    private normalizeClickPointOptions;
+    private position;
+    private loadOEMBoundaryData;
+    /** Preloads OEM subregion geometry so map clicks can resolve an exact subregion. */
+    prepareSubregionBoundaries(): Promise<void>;
+    private inferSubregionId;
+    private emitMapClick;
+    private emit;
+    private scheduleOverdragUpdate;
+    private clearOverdrag;
+    /** Emits one resolved view for duplicate Leaflet move and zoom events. */
+    private emitView;
+    /** Resolves the compact attribution without inheriting the map control font. */
+    private updateAttribution;
+    on<Event extends keyof OEMEvents>(event: Event, handler: (payload: OEMEvents[Event]) => void): () => void;
+    /** Rebuilds the base map constraints and main tile layer for one region. */
+    private applyRegion;
+    /** Converts the region's published pixel extent to Simple CRS bounds. */
+    private regionBounds;
+    /** Creates a coverage-aware layer for one region floor. */
+    private makeTiles;
+    private clampZoom;
+    /** Returns the current view in the OEM pixel coordinate system. */
+    getView(): OEMView;
+    /** Sets the view without exposing Leaflet's coordinate objects. */
+    setView(view: OEMView): void;
+    /** Changes zoom around the current center with an optional native transition. */
+    setZoom(zoom: number, options?: OEMZoomOptions): void;
+    /** Fits the map to an OEM pixel-coordinate extent. */
+    fitBounds(bounds: [OEMPosition, OEMPosition]): void;
+    /** Switches regions and reloads only the features currently enabled. */
+    setRegion(regionId: string): Promise<void>;
+    /** Switches the rendered floor while retaining the current region view. */
+    setFloor(floorId: string): void;
+    /** Changes label language and applies the manifest fallback chain. */
+    setLocale(locale: string): Promise<void>;
+    /** Returns both the requested and resolved locale values. */
+    getLocale(): {
+        requested: string;
+        resolved: string;
+    };
+    /** Changes only this instance's theme attribute. */
+    setTheme(theme: 'light' | 'dark'): void;
+    /** Enables or disables static layers and cancels disabled layer requests. */
+    setFeatures(features: OEMFeatures): Promise<void>;
+    /** Replaces host-defined points without reloading static map data. */
+    setCustomPoints(points: readonly OEMCustomPoint[]): void;
+    /** Enables or disables automatic custom-point creation from map clicks. */
+    setClickPointMode(options?: OEMClickPointOptions | null): void;
+    /** Removes only points created by the click-point mode. */
+    clearClickPoints(): void;
+    loadCustomPoints(url: string): Promise<void>;
+    /** Removes all host-defined points from this map instance. */
+    clearCustomPoints(): void;
+    /** Returns a loaded published point from the current region, if available. */
+    getPoint(pointId: string): OEMPoint | undefined;
+    /** Loads one published point by using the release point index when available. */
+    loadPoint(pointId: string): Promise<OEMPoint | undefined>;
+    private loadPointIndex;
+    private loadPointShard;
+    private decodePointShard;
+    private cancelRequest;
+    private cancelRequests;
+    private loadFeatures;
+    /** Loads one feature with a request token so stale responses are ignored. */
+    private loadFeature;
+    /** Applies a client-side filter without making another network request. */
+    setPointFilter(filter: OEMPointFilter): void;
+    /** Enables or disables Atlos-style marker clustering without reloading point data. */
+    setMarkerClustering(enabled: boolean): void;
+    private clearPointLayers;
+    private createCustomPointVisual;
+    private renderCustomPoints;
+    /** Builds the shared Atlos marker composition for points and cluster summaries. */
+    private createMarkerVisual;
+    private createPointMarker;
+    private createPointCluster;
+    /** Rebuilds visible markers and groups eligible types with Atlos clustering rules. */
+    private renderPoints;
+    /** Renders Atlos-style fill and dashed stroke layers for published subregions. */
+    private renderBoundaries;
+    /** Renders Atlos site or subregion labels according to the current zoom. */
+    private renderLabels;
+    /** Recalculates Leaflet dimensions after the host element changes size. */
+    resize(): void;
+    /** Releases listeners, observers, pending requests, layers and DOM nodes. */
+    destroy: () => void;
+}