@sakuzu/maplibre-gl-draw 1.0.0 → 2.0.0

package/dist/geometry/public-repair.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Repair: the public functions that tidy polygons and reduce vertices
+ */
+import type { Geometry, LineString, MultiPolygon, Polygon } from 'geojson';
+/**
+ * Returns a polygon with its self-intersections resolved, its rings oriented and its rings
+ * without an area removed.
+ *
+ * @param polygon The Polygon or MultiPolygon, or a feature whose geometry is one; coordinates
+ *   in degrees. A ring with fewer than 3 positions or a position that is not finite is dropped
+ * @returns A Polygon, or a MultiPolygon when the result falls apart (a figure eight becomes two
+ *   parts), with outer rings counter-clockwise and holes clockwise. null when nothing with an
+ *   area remains
+ * @throws {@link GeometryError} (`invalid-input`) when the input is not a Polygon or a
+ *   MultiPolygon, and (`engine-failure`) when the boolean operation fails
+ */
+export declare function makeValid(polygon: Polygon | MultiPolygon | {
+    readonly geometry: Geometry;
+}): Polygon | MultiPolygon | null;
+/**
+ * Returns a polygon with its rings oriented as RFC 7946 recommends: outer rings
+ * counter-clockwise and holes clockwise.
+ *
+ * @param polygon The Polygon or MultiPolygon, or a feature whose geometry is one; coordinates
+ *   in degrees. Only the orientation changes; self-intersections are left as they are (see
+ *   {@link makeValid})
+ * @returns A geometry of the same type as the input
+ * @throws {@link GeometryError} (`invalid-input`) when the input is not a Polygon or a
+ *   MultiPolygon
+ */
+export declare function rewind(polygon: Polygon | {
+    readonly geometry: Polygon;
+}): Polygon;
+export declare function rewind(polygon: MultiPolygon | {
+    readonly geometry: MultiPolygon;
+}): MultiPolygon;
+export declare function rewind(polygon: Polygon | MultiPolygon | {
+    readonly geometry: Geometry;
+}): Polygon | MultiPolygon;
+/**
+ * Reduces the vertices of a line or a polygon with the Douglas-Peucker algorithm and a
+ * tolerance in meters.
+ *
+ * @param geometry The LineString, Polygon or MultiPolygon, or a feature whose geometry is one;
+ *   coordinates in degrees
+ * @param toleranceMeters The largest distance in meters a removed vertex may lie from the
+ *   simplified line, measured on a plane at the latitude of the center of the bounding box. 0
+ *   or less removes nothing
+ * @returns A geometry of the same type. The ends of a line always remain, and a ring that
+ *   would keep fewer than 4 positions is kept as it is. The result may intersect itself (see
+ *   {@link makeValid})
+ * @throws {@link GeometryError} (`invalid-input`) when the input is not a LineString, a
+ *   Polygon or a MultiPolygon, and when the tolerance is not a finite number
+ *
+ * @example
+ * ```ts
+ * import { simplify } from '@sakuzu/maplibre-gl-draw/geometry';
+ *
+ * // The middle vertex lies about 1 m off the line, within the 5 m tolerance
+ * simplify({ type: 'LineString', coordinates: [[0, 0], [0.001, 0.00001], [0.002, 0]] }, 5);
+ * // { type: 'LineString', coordinates: [[0, 0], [0.002, 0]] }
+ * ```
+ */
+export declare function simplify(geometry: LineString | {
+    readonly geometry: LineString;
+}, toleranceMeters: number): LineString;
+export declare function simplify(geometry: Polygon | {
+    readonly geometry: Polygon;
+}, toleranceMeters: number): Polygon;
+export declare function simplify(geometry: MultiPolygon | {
+    readonly geometry: MultiPolygon;
+}, toleranceMeters: number): MultiPolygon;
+export declare function simplify(geometry: LineString | Polygon | MultiPolygon | {
+    readonly geometry: Geometry;
+}, toleranceMeters: number): LineString | Polygon | MultiPolygon;

package/dist/geometry/public-repair.js

@@ -0,0 +1,77 @@
+// SPDX-FileCopyrightText: 2026 SAKAIDA Atsushi
+// SPDX-License-Identifier: AGPL-3.0-only
+import { coordinatesBBox } from './bbox.js';
+import { normalizeArea } from './boolean.js';
+import { invalidInput, withOperation } from './errors.js';
+import { areaGeometryOf, areaOf, geometryOf, positionsOf, toAreaGeometry } from './geojson.js';
+import { normalizeMultiPolygonOrientation, normalizePolygonOrientation, simplify as simplifyPath, } from './simplify.js';
+import { metersToDegrees, toRadians } from './units.js';
+/**
+ * Returns a polygon with its self-intersections resolved, its rings oriented and its rings
+ * without an area removed.
+ *
+ * @param polygon The Polygon or MultiPolygon, or a feature whose geometry is one; coordinates
+ *   in degrees. A ring with fewer than 3 positions or a position that is not finite is dropped
+ * @returns A Polygon, or a MultiPolygon when the result falls apart (a figure eight becomes two
+ *   parts), with outer rings counter-clockwise and holes clockwise. null when nothing with an
+ *   area remains
+ * @throws {@link GeometryError} (`invalid-input`) when the input is not a Polygon or a
+ *   MultiPolygon, and (`engine-failure`) when the boolean operation fails
+ */
+export function makeValid(polygon) {
+    const coordinates = areaOf(polygon, 'makeValid');
+    return withOperation('makeValid', () => toAreaGeometry(normalizeArea(coordinates)));
+}
+export function rewind(polygon) {
+    const geometry = areaGeometryOf(polygon, 'rewind');
+    if (geometry.type === 'Polygon') {
+        return {
+            type: 'Polygon',
+            coordinates: normalizePolygonOrientation(geometry.coordinates),
+        };
+    }
+    return {
+        type: 'MultiPolygon',
+        coordinates: normalizeMultiPolygonOrientation(geometry.coordinates),
+    };
+}
+/**
+ * Simplifies a path with a tolerance in meters: the path is scaled to a local plane in which
+ * a degree of longitude is `cos(latitude)` degrees of latitude, and the tolerance is taken in
+ * degrees of latitude
+ */
+function simplifyInMeters(path, toleranceDegrees, lngScale) {
+    const scaled = path.map((position) => [position[0] * lngScale, position[1]]);
+    const indexOf = new Map();
+    scaled.forEach((position, index) => {
+        indexOf.set(position, index);
+    });
+    return simplifyPath(scaled, toleranceDegrees).map((position) => [
+        ...path[indexOf.get(position) ?? 0],
+    ]);
+}
+export function simplify(geometry, toleranceMeters) {
+    const input = geometryOf(geometry, 'simplify');
+    if (input.type !== 'LineString' && input.type !== 'Polygon' && input.type !== 'MultiPolygon') {
+        throw invalidInput('simplify', 'the input is not a LineString, a Polygon or a MultiPolygon');
+    }
+    if (!Number.isFinite(toleranceMeters)) {
+        throw invalidInput('simplify', 'the tolerance is not a finite number');
+    }
+    const box = coordinatesBBox(positionsOf(input));
+    const latitude = box === null ? 0 : (box[1] + box[3]) / 2;
+    const toleranceDegrees = metersToDegrees(toleranceMeters, latitude).lat;
+    const lngScale = Math.cos(toRadians(latitude));
+    const path = (positions) => simplifyInMeters(positions, toleranceDegrees, lngScale);
+    switch (input.type) {
+        case 'LineString':
+            return { type: 'LineString', coordinates: path(input.coordinates) };
+        case 'Polygon':
+            return { type: 'Polygon', coordinates: input.coordinates.map(path) };
+        case 'MultiPolygon':
+            return {
+                type: 'MultiPolygon',
+                coordinates: input.coordinates.map((polygon) => polygon.map(path)),
+            };
+    }
+}

package/dist/geometry/simplify.d.ts

@@ -14,13 +14,6 @@ import type { Coordinate, MultiPolygonCoordinates, PolygonCoordinates, Ring } fr
  *   simplified line
  * @returns The simplified vertices as a new array. A copy of the input for 2 positions or
  *   fewer, for a tolerance that is not positive, and for a ring that would collapse
- *
- * @example
- * ```ts
- * import { simplify } from '@sakuzu/maplibre-gl-draw/geometry';
- *
- * simplify([[0, 0], [1, 0.00001], [2, 0], [3, 1]], 0.001); // [[0, 0], [2, 0], [3, 1]]
- * ```
  */
 export declare function simplify(path: Coordinate[], toleranceDegrees: number): Coordinate[];
 /**

package/dist/geometry/simplify.js

@@ -69,13 +69,6 @@ function markKeep(path, first, last, squaredTolerance, keep) {
  *   simplified line
  * @returns The simplified vertices as a new array. A copy of the input for 2 positions or
  *   fewer, for a tolerance that is not positive, and for a ring that would collapse
- *
- * @example
- * ```ts
- * import { simplify } from '@sakuzu/maplibre-gl-draw/geometry';
- *
- * simplify([[0, 0], [1, 0.00001], [2, 0], [3, 1]], 0.001); // [[0, 0], [2, 0], [3, 1]]
- * ```
  */
 export function simplify(path, toleranceDegrees) {
     if (path.length <= 2 || !(toleranceDegrees > 0)) {

package/dist/geometry/split.d.ts

@@ -18,14 +18,6 @@ import type { AreaCoordinates, Coordinate, MultiPolygonCoordinates } from './typ
  * @param b2 The end of segment B, `[lng, lat]` in degrees
  * @returns The intersection `[lng, lat]`, taken on segment A. `null` when they do not
  *   cross, are parallel or collinear, or either has length 0
- *
- * @example
- * ```ts
- * import { segmentIntersection } from '@sakuzu/maplibre-gl-draw/geometry';
- *
- * segmentIntersection([0, 0], [2, 2], [0, 2], [2, 0]); // [1, 1]
- * segmentIntersection([0, 0], [1, 0], [0, 1], [1, 1]); // null (parallel)
- * ```
  */
 export declare function segmentIntersection(a1: Coordinate, a2: Coordinate, b1: Coordinate, b2: Coordinate): Coordinate | null;
 /**
@@ -52,17 +44,5 @@ export declare function segmentIntersection(a1: Coordinate, a2: Coordinate, b1:
  *   input normalized) when it is not split. An empty array when the input has no area
  * @throws {@link GeometryError} when the boolean operation engine fails even after the
  *   retry on the 1e-9 degree grid
- *
- * @example
- * ```ts
- * import { splitArea } from '@sakuzu/maplibre-gl-draw/geometry';
- *
- * const square: [number, number][][] = [[[0, 0], [1, 0], [1, 1], [0, 1], [0, 0]]];
- * const parts = splitArea(square, [[0.5, -1], [0.5, 2]]);
- * parts.length; // 2: the halves west and east of longitude 0.5
- * if (parts.length === 1) {
- *   // Not split: the line does not cross the polygon
- * }
- * ```
  */
 export declare function splitArea(area: AreaCoordinates, line: Coordinate[]): MultiPolygonCoordinates[];

package/dist/geometry/split.js

@@ -64,14 +64,6 @@ const NODE_QUANTUM = 1e-9;
  * @param b2 The end of segment B, `[lng, lat]` in degrees
  * @returns The intersection `[lng, lat]`, taken on segment A. `null` when they do not
  *   cross, are parallel or collinear, or either has length 0
- *
- * @example
- * ```ts
- * import { segmentIntersection } from '@sakuzu/maplibre-gl-draw/geometry';
- *
- * segmentIntersection([0, 0], [2, 2], [0, 2], [2, 0]); // [1, 1]
- * segmentIntersection([0, 0], [1, 0], [0, 1], [1, 1]); // null (parallel)
- * ```
  */
 export function segmentIntersection(a1, a2, b1, b2) {
     const ax = a2[0] - a1[0];
@@ -119,18 +111,6 @@ export function segmentIntersection(a1, a2, b1, b2) {
  *   input normalized) when it is not split. An empty array when the input has no area
  * @throws {@link GeometryError} when the boolean operation engine fails even after the
  *   retry on the 1e-9 degree grid
- *
- * @example
- * ```ts
- * import { splitArea } from '@sakuzu/maplibre-gl-draw/geometry';
- *
- * const square: [number, number][][] = [[[0, 0], [1, 0], [1, 1], [0, 1], [0, 0]]];
- * const parts = splitArea(square, [[0.5, -1], [0.5, 2]]);
- * parts.length; // 2: the halves west and east of longitude 0.5
- * if (parts.length === 1) {
- *   // Not split: the line does not cross the polygon
- * }
- * ```
  */
 export function splitArea(area, line) {
     const normalized = normalizeArea(area);

package/dist/geometry/units.d.ts

@@ -5,25 +5,18 @@
  * whole geometry module.
  */
 /**
- * The radius of the sphere every geodesic function of this module uses, in meters.
+ * The radius in meters of the sphere on which every function of this entry measures.
  *
- * The value is the mean Earth radius, 6,371,000 m. Distances, bearings, areas, circles and
- * buffers all assume this sphere rather than an ellipsoid, so a result differs from an
- * ellipsoidal computation by up to about 0.5%.
+ * The value is the mean Earth radius of the IUGG, 6,371,008.8 m. Distances, bearings, areas,
+ * circles and buffers all assume this sphere rather than an ellipsoid, so a result differs from
+ * an ellipsoidal computation by up to about 0.5%.
  */
-export declare const EARTH_RADIUS_METERS = 6371000;
+export declare const EARTH_RADIUS_METERS = 6371008.8;
 /**
  * Converts an angle in degrees to radians.
  *
  * @param degrees The angle in degrees
  * @returns The angle in radians. NaN and infinities pass through unchanged
- *
- * @example
- * ```ts
- * import { toRadians } from '@sakuzu/maplibre-gl-draw/geometry';
- *
- * toRadians(180); // Math.PI
- * ```
  */
 export declare function toRadians(degrees: number): number;
 /**
@@ -33,3 +26,18 @@ export declare function toRadians(degrees: number): number;
  * @returns The angle in degrees. NaN and infinities pass through unchanged
  */
 export declare function toDegrees(radians: number): number;
+/**
+ * Converts a distance at a latitude into degrees of longitude and latitude.
+ *
+ * On the sphere of {@link EARTH_RADIUS_METERS}: a degree of latitude is always the same
+ * length, and a degree of longitude shrinks with the cosine of the latitude. Use it to turn a
+ * tolerance in meters into one in degrees. Near the poles the longitude grows without bound.
+ *
+ * @param meters The distance in meters
+ * @param latitude The latitude in degrees at which the distance is taken
+ * @returns The distance in degrees of longitude (`lng`) and of latitude (`lat`)
+ */
+export declare function metersToDegrees(meters: number, latitude: number): {
+    lng: number;
+    lat: number;
+};

package/dist/geometry/units.js

@@ -7,25 +7,18 @@
  * whole geometry module.
  */
 /**
- * The radius of the sphere every geodesic function of this module uses, in meters.
+ * The radius in meters of the sphere on which every function of this entry measures.
  *
- * The value is the mean Earth radius, 6,371,000 m. Distances, bearings, areas, circles and
- * buffers all assume this sphere rather than an ellipsoid, so a result differs from an
- * ellipsoidal computation by up to about 0.5%.
+ * The value is the mean Earth radius of the IUGG, 6,371,008.8 m. Distances, bearings, areas,
+ * circles and buffers all assume this sphere rather than an ellipsoid, so a result differs from
+ * an ellipsoidal computation by up to about 0.5%.
  */
-export const EARTH_RADIUS_METERS = 6371000;
+export const EARTH_RADIUS_METERS = 6371008.8;
 /**
  * Converts an angle in degrees to radians.
  *
  * @param degrees The angle in degrees
  * @returns The angle in radians. NaN and infinities pass through unchanged
- *
- * @example
- * ```ts
- * import { toRadians } from '@sakuzu/maplibre-gl-draw/geometry';
- *
- * toRadians(180); // Math.PI
- * ```
  */
 export function toRadians(degrees) {
     return (degrees * Math.PI) / 180;
@@ -39,3 +32,18 @@ export function toRadians(degrees) {
 export function toDegrees(radians) {
     return (radians * 180) / Math.PI;
 }
+/**
+ * Converts a distance at a latitude into degrees of longitude and latitude.
+ *
+ * On the sphere of {@link EARTH_RADIUS_METERS}: a degree of latitude is always the same
+ * length, and a degree of longitude shrinks with the cosine of the latitude. Use it to turn a
+ * tolerance in meters into one in degrees. Near the poles the longitude grows without bound.
+ *
+ * @param meters The distance in meters
+ * @param latitude The latitude in degrees at which the distance is taken
+ * @returns The distance in degrees of longitude (`lng`) and of latitude (`lat`)
+ */
+export function metersToDegrees(meters, latitude) {
+    const lat = toDegrees(meters / EARTH_RADIUS_METERS);
+    return { lng: lat / Math.cos(toRadians(latitude)), lat };
+}

package/dist/index.d.ts

@@ -1,72 +1,58 @@
 /**
- * MapLibre GL Draw - public entry point
+ * Draw and edit points, lines and areas on a MapLibre map, and show large data beside them.
  *
- * The caller accesses the whole public API through the single entry
- * `import { ... } from '@sakuzu/maplibre-gl-draw'` (plus the pure geometry functions of
- * `@sakuzu/maplibre-gl-draw/geometry`). Tree-shaking is applied by the ESM bundler, which
- * looks at `"sideEffects": false` in package.json.
+ * Import from here for everything an application does with a drawing: create the instance,
+ * read and change its features, layers and groups, listen to what changes, save and load the
+ * document, and add plugins, modes and feature types. Three subpaths cover the rest: geometry
+ * that needs no map (`/geometry`), large tables read in a Worker (`/table`) and custom shaders
+ * (`/webgl`).
  *
- * Every public symbol is listed here by name, in one of two layers (see "The public
- * surface" in CONTRIBUTING.md and "The two layers of the public API" in
- * docs/reference/README.md):
+ * ```ts
+ * import { createDraw } from '@sakuzu/maplibre-gl-draw';
  *
- *   - Layer 1, the public API: the factory, the instance and its options, the data model,
- *     the events, the extension points and the pure functions. It follows semver.
- *   - Layer 2, building blocks for extension authors: the rendering parts, the math and the
- *     core services that a plugin, a custom feature type or a custom mode may reuse. Its
- *     guarantee is weaker: it may change in a minor release.
+ * const draw = createDraw(map);
+ * draw.setMode('draw_polygon');
+ * draw.on('feature.created', ({ feature }) => {
+ *   console.log(feature.id, feature.geometry);
+ * });
+ * ```
  *
- * Anything not listed here is internal. Where it would otherwise appear in the emitted
- * declarations, its JSDoc carries the internal tag and `stripInternal` drops it from them.
- * The list is pinned by src/index.test.ts, so every addition or removal is deliberate.
+ * Read next: [getting started](https://sakuzu.github.io/maplibre-gl-draw/getting-started),
+ * then the guides for [drawing](https://sakuzu.github.io/maplibre-gl-draw/guides/drawing) and
+ * [saving and loading](https://sakuzu.github.io/maplibre-gl-draw/guides/save-load). The
+ * symbols used most are {@link createDraw}, {@link Draw}, {@link Feature} and
+ * {@link DrawEvents}.
+ *
+ * @module maplibre-gl-draw
  */
-export type { EventPayloads, MapLibreGLDraw, Options } from './api/index.js';
-export { createMapLibreGLDraw } from './maplibre-gl-draw.js';
-export type { BoundingBoxStyle, BoxSelectionStyleConfig, CenterMarkerStyle, FeatureStyleConfig, FillStyle, LineStringFeatureStyle, MidpointHandleStyle, PointFeatureStyle, PolygonFeatureStyle, RadiusHandleStyle, RadiusLineStyle, RenderingConfig, ResizeHandleStyle, RotateHandleStyle, SelectionUIConfig, TentativeStyle, TopologyConfig, TraceOptions, VertexHandleStyle, } from './shared/config/index.js';
-export type { AutoNameConfig, AutoNameType, PixelRatioInput, PixelRatioProvider, } from './shared/utils/index.js';
-export type { SnapDisableKey, SnapOptions, SnapTargetKind } from './snapping/index.js';
-export type { Color, LineStyle, PointShape, PointStyle, StrokeStyle } from './view/index.js';
-export { MESSAGES_EN, type Messages } from './messages.js';
-export type { BoundingBox, BoundingBoxCoordsSimple, BoxSelection, Coordinate, Data, DragOperationType, DragState, ExportFormat, ExportOptions, ExportResult, Feature, FeatureCoordinates, FeatureInput, FeatureStyle, FeatureType, FileData, Group, ImageProperties, ImageStyle, Layer, LoadOptions, LoadResult, Metadata, Mode, RotateInfo, Selection, SelectionType, SkippedFeature, StateChanges, StyleRule, TentativeState, UpdateFeatureOptions, UpdateSource, VertexRef, VertexSelection, } from './store/index.js';
-export type { LegendEntry } from './view/index.js';
-export type { DocumentStore, FeatureLockStore, InteractionGateStore, Store, StoreView, UiState, } from './store/index.js';
-export { isFeatureLocked, isGroupLocked, isInteractionBlocked, MemoryStore, } from './store/index.js';
-export type { MapClickEventPayload } from './dispatcher/index.js';
-export type { DatasetClickEventPayload } from './display/index.js';
-export type { EventListener, EventMap, FeaturesChangePayload, GeometryAppliedPayload, GeometryOperationName, LoadErrorPayload, } from './shared/utils/index.js';
-export type { GeometryBufferOptions, GeometryOperations, InputOperations, SnappingOperations, SyntheticInputOptions, SyntheticKeyOptions, SyntheticLngLat, SyntheticModifiers, TopologyOperations, TracingOperations, } from './api/index.js';
-export type { DatasetBaseStyle, DatasetChangePayload, DatasetClickPayload, Dataset, DatasetEventMap, DatasetOptions, DatasetOrder, DatasetPlacement, DatasetCollisionThinning, DatasetColumn, DatasetColumnarGeometry, DatasetColumnarGeometryType, DatasetColumnarInput, DatasetColumnarMixedGeometry, DatasetColumnarPrepared, DatasetDictionaryCodes, DatasetDictionaryColumn, DatasetFeatureInput, DatasetFeatureProvider, DatasetHoverPayload, DatasetThinningStats, DatasetZoomScale, ResolvedCollisionThinning, } from './display/index.js';
-export type { GuideSnapProviderDeps, GuideSnapProviderOptions, ResolvedSnapOptions, SnapCandidate, SnapContext, SnapExcludeVertex, SnapIndicatorStyles, SnapLngLat, SnapPointCandidate, SnapProvider, SnapProviderContext, SnapResult, SnapSegmentCandidate, SnapTarget, SnapTargetSegment, } from './snapping/index.js';
-export { createGuideSnapProvider, DEFAULT_SNAP_GUIDE_LINE_STYLE, DEFAULT_SNAP_INDICATOR_STYLES, } from './snapping/index.js';
-export type { TraceGraph, TraceGraphEdge, TraceGraphEndpoint, TraceGraphNode, } from './operations/index.js';
-export { buildTraceGraph, findTracePath } from './operations/index.js';
-export type { StyleRuleChannel } from './view/index.js';
-export { applyRuleColor, deriveLegend, evaluateStyleRule, getStyleRuleChannel, resolveFeatureStyle, resolveRuleColor, } from './view/index.js';
-export { getCreatedZoom, getRotation, getScale, setCreatedZoom, setRotation, } from './shared/utils/index.js';
-export type { CustomFeatureHandler, CustomFeatureRenderer, CustomOverlayRenderer, CustomRendererDrawContext, CustomResizeResult, LayerAwareOverlayRenderer, } from './extension/index.js';
-export type { BoxSelectionStrategy, DragNormalizedEvent, HitTestOptions, HitTestResult, HitTestStrategy, KeyNormalizedEvent, ModifierKeys, MouseNormalizedEvent, NormalizedEvent, PointerOriginalEvent, PointerType, VertexHit, } from './dispatcher/index.js';
-export type { ModeContext, ModeFactory, ModeHandler, SnapInputType } from './modes/index.js';
-export type { ResizeState } from './operations/index.js';
-export type { DragEndData, DragStartData, Hooks, HoverEvent, MouseLeaveEvent, MutationContext, Plugin, PluginContext, } from './plugins/index.js';
-export type { HandleType } from './shared/config/index.js';
-export type { LngLat, ScreenPoint } from './shared/math/index.js';
-export type { AdditionalHandleInfo, AdditionalResizeHandlesCalculator, AuxiliaryHandle, AuxiliaryHandleContext, AuxiliaryHandleHit, AuxiliaryHandleProvider, BoundingBoxCoords, CompanionHit, CompanionHitContext, CustomBoundingBoxCalculator, CustomResizeCalculator, FeatureCompanionProvider, HandleInfo, PointFrameExtent, PointFrameExtentProvider, RenderSlot, ResizeStrategy, } from './view/index.js';
-export type { BoxSelectionStrategyRegistry, HitTestService, HitTestTopmost, TopHit, TopmostHitTestOptions, UnprojectFunction, } from './dispatcher/index.js';
-export type { HookName, PluginManager } from './plugins/index.js';
-export type { TraceConfig } from './shared/config/index.js';
-export type { AutoNameGenerator, EventEmitter } from './shared/utils/index.js';
-export type { SpatialQuery } from './store/index.js';
-export type { AuxiliaryHandleRegistry, FeatureCompanionHitResult, FeatureCompanionRegistry, FillShaderManager, PointShapeRenderer, SDFLineRenderer, SDFStrokeOptions, SDFStrokeStyle, SelectionExtensionRegistry, SelectionScope, TerrainContext, TerrainRenderState, WidthUnit, } from './view/index.js';
-export type { TerrainDiagnostics, TerrainRenderDiagnostics } from './api/index.js';
-export type { TerrainDrapeDebug } from './view/index.js';
-export { resolvePixelRatio } from './shared/utils/index.js';
-export type { BlendCapableGL, DashSegment, DrapeQuadCorners, OffsetUniforms, ProjectionUniformLocations, QuadDrapeColor, QuadDrapeFill, QuadDrapeSurface, QuadDrapeGlyphs, QuadVertices, ShaderData, } from './view/index.js';
-export { applyDrawBlendState, calculateLngLatOffset, calculateOffsetUniforms, computeQuadVertices, createProgram, drawBillboardsWithoutDepth, drawQuadSurfaceOnTerrain, getProjectionTransitionUniform, getStrokeDashPattern, OFFSET_MODE_GLSL, ProjectionUniformManager, QUAD_GLYPH_STRIDE, QuadShader, splitIntoDashes, } from './view/index.js';
-export type { MercatorRect, TessellationStep, TessellationTiling } from './view/index.js';
-export { anchorElevationMeters, anchorGhostOpacity, densifyPath, getAnchorElevationGeneration, getTerrainTessellationStep, metersToMercatorScale, } from './view/index.js';
-export type { MercatorCoord, OBB, OBBCorners } from './shared/math/index.js';
-export { createOBB, DEFAULT_TILE_SIZE, distanceToOBB, generateCirclePolygon, getOBBAABB, lngLatToMercator, metersToDegreesLat, metersToDegreesLng, pixelsToDegreesLat, pixelsToDegreesLng, rectangleIntersectsOBB, } from './shared/math/index.js';
-export { getContrastColor } from './shared/utils/index.js';
-export { PointHitTestStrategy } from './dispatcher/index.js';
-export { createGeometryApi, type GeometryApi, type GeometryApiDeps } from './api/index.js';
-export { computeBoundingBox, createFeatureCompanionRegistry, createSelectionExtensionRegistry, DEFAULT_POINT_FRAME_SIZE, DEFAULT_VIEWPORT_EXPANSION_FACTOR, getExpandedViewportBounds, getSelectedFeatureIds, hasZeroArea, } from './view/index.js';
+export type { Draw, TransactOptions } from './api/draw.js';
+export { createDraw } from './api/draw.js';
+export type { AutoNameOptions, DrawOptions, OptionsResource, RenderingOptions, RuntimeOptions, SelectionStyleOptions, SnappingOptions, TopologyOptions, TracingOptions, } from './api/options.js';
+export type { Messages } from './messages.js';
+export type { FeaturesCollection } from './api/features.js';
+export type { LayersCollection } from './api/layers.js';
+export type { GroupsCollection } from './api/groups.js';
+export type { HiddenCollection } from './api/hidden.js';
+export type { SelectionResource, VertexSelectionResource } from './api/selection.js';
+export type { MetadataResource } from './api/metadata.js';
+export type { DrawingResource } from './api/drawing.js';
+export type { DocumentResource } from './api/document.js';
+export type { DrawDocument, DrawProperties, Feature, FeatureStyle, FeatureStyleResolved, FeatureType, FileData, Group, Layer, LegendEntry, LineStyle, Metadata, PointShape, StyleRule, } from './api/model.js';
+export { DRAW_PROPERTY_PREFIX, isDrawProperty } from './api/model.js';
+export type { FeatureFilter, FeatureInput, FeaturePatch, GroupFilter, GroupInput, GroupPatch, LayerFilter, LayerInput, LayerPatch, LoadOptions, LoadResult, LoadSource, MoveTarget, SkippedFeature, } from './api/model.js';
+export type { LayerStackEntry, Mode, Selection, SelectionType, SnapPreference, SnapResult, TerrainDiagnostics, VertexRef, VertexSelection, } from './api/state.js';
+export { MODES } from './api/state.js';
+export type { DocumentChange, DrawEventListener, DrawEvents, ScreenPoint } from './api/events.js';
+export type { Position } from 'geojson';
+export type { DrawErrorCode } from './api/errors.js';
+export { DrawError } from './api/errors.js';
+export type { Dataset, DatasetBaseStyle, DatasetCollisionThinning, DatasetEvents, DatasetOptions, DatasetOrder, DatasetPlacement, DatasetProvider, DatasetRow, DatasetsCollection, DatasetThinningStats, DatasetZoomScale, } from './api/datasets.js';
+export type { Store, StoreView, UpdateSource } from './api/extension/store.js';
+export type { ExtensionContext, HitTestContext, ModeContext, NameGenerator, PluginContext, ScreenContext, SnapContext, TerrainAnchors, } from './api/extension/context.js';
+export type { FeatureTypeDefinition, Handle } from './api/extension/feature-type.js';
+export type { DrawKeyEvent, DrawPointerEvent, InputHandlers, ModeFactory, ModeHandler, Modifiers, } from './api/extension/mode.js';
+export type { Plugin } from './api/extension/plugin.js';
+export type { CompanionProvider, HandleProvider, Hit, SnapCandidate, SnapProvider, } from './api/extension/provider.js';
+export type { FeatureRenderer, FillRenderer, LineRenderer, OffsetUniforms, OverlayRenderer, PointRenderer, RenderContext, ShaderData, } from './api/extension/render.js';
+export type { ExtensionsCollections, FeatureTypesCollection, ModesCollection, OverlaysCollection, PluginsCollection, ProvidersCollection, } from './api/extensions.js';
+export { deriveLegend, evaluateStyleRule, getStyleRuleChannel } from './api/model.js';

package/dist/index.js

@@ -1,20 +1,8 @@
 // SPDX-FileCopyrightText: 2026 SAKAIDA Atsushi
 // SPDX-License-Identifier: AGPL-3.0-only
-export { createMapLibreGLDraw } from './maplibre-gl-draw.js';
-export { MESSAGES_EN } from './messages.js';
-export { isFeatureLocked, isGroupLocked, isInteractionBlocked, MemoryStore, } from './store/index.js';
-export { createGuideSnapProvider, DEFAULT_SNAP_GUIDE_LINE_STYLE, DEFAULT_SNAP_INDICATOR_STYLES, } from './snapping/index.js';
-export { buildTraceGraph, findTracePath } from './operations/index.js';
-export { applyRuleColor, deriveLegend, evaluateStyleRule, getStyleRuleChannel, resolveFeatureStyle, resolveRuleColor, } from './view/index.js';
-// Property accessors
-export { getCreatedZoom, getRotation, getScale, setCreatedZoom, setRotation, } from './shared/utils/index.js';
-// WebGL building blocks
-export { resolvePixelRatio } from './shared/utils/index.js';
-export { applyDrawBlendState, calculateLngLatOffset, calculateOffsetUniforms, computeQuadVertices, createProgram, drawBillboardsWithoutDepth, drawQuadSurfaceOnTerrain, getProjectionTransitionUniform, getStrokeDashPattern, OFFSET_MODE_GLSL, ProjectionUniformManager, QUAD_GLYPH_STRIDE, QuadShader, splitIntoDashes, } from './view/index.js';
-export { anchorElevationMeters, anchorGhostOpacity, densifyPath, getAnchorElevationGeneration, getTerrainTessellationStep, metersToMercatorScale, } from './view/index.js';
-export { createOBB, DEFAULT_TILE_SIZE, distanceToOBB, generateCirclePolygon, getOBBAABB, lngLatToMercator, metersToDegreesLat, metersToDegreesLng, pixelsToDegreesLat, pixelsToDegreesLng, rectangleIntersectsOBB, } from './shared/math/index.js';
-export { getContrastColor } from './shared/utils/index.js';
-// Selection UI, hit testing and viewport helpers
-export { PointHitTestStrategy } from './dispatcher/index.js';
-export { createGeometryApi } from './api/index.js';
-export { computeBoundingBox, createFeatureCompanionRegistry, createSelectionExtensionRegistry, DEFAULT_POINT_FRAME_SIZE, DEFAULT_VIEWPORT_EXPANSION_FACTOR, getExpandedViewportBounds, getSelectedFeatureIds, hasZeroArea, } from './view/index.js';
+export { createDraw } from './api/draw.js';
+export { DRAW_PROPERTY_PREFIX, isDrawProperty } from './api/model.js';
+export { MODES } from './api/state.js';
+export { DrawError } from './api/errors.js';
+// Style rule functions
+export { deriveLegend, evaluateStyleRule, getStyleRuleChannel } from './api/model.js';

package/dist/messages.d.ts

@@ -9,12 +9,12 @@
  * - The keys are typed. A value is either a string or a function that formats one (it
  *   receives numbers already turned into strings)
  * - `MESSAGES_EN` is the default, in English. The library ships no other language
- * - `Options.messages` overrides part of the table for one instance. The table belongs to
+ * - `DrawOptions.messages` overrides part of the table for one instance. The table belongs to
  *   the instance and is never module-level state
  * - There is no locale detection and no automatic switching: the host passes the table
  *   it wants
  * - The words of the names generated for features, layers and groups are not in this table:
- *   they come from the naming configuration (`AutoNameConfig`, the `autoName` option)
+ *   they come from the `autoName` option
  */
 /**
  * The table of the strings the library returns as values: legend labels and the descriptions
@@ -22,14 +22,14 @@
  *
  * The library builds no such string inline; it reads it from the table of the instance, so
  * the host can show them in its own language. Pass the entries to replace as the `messages`
- * option of `createMapLibreGLDraw`; the entries left out keep {@link MESSAGES_EN}. A value is
- * a string, or a function that formats one from numbers already turned into strings. There is
- * no locale detection and no other built-in language. The words of generated names ("Layer 1")
- * are translated through the `autoName` option (`AutoNameConfig`), not here.
+ * option of `createDraw`; the entries left out keep the English defaults. A value is a string,
+ * or a function that formats one from numbers already turned into strings. There is no locale
+ * detection and no other built-in language. The words of generated names ("Layer 1") are
+ * translated through the `autoName` option, not here.
  *
  * @example
  * ```ts
- * const draw = createMapLibreGLDraw(map, {
+ * const draw = createDraw(map, {
  *   messages: {
  *     legendOther: 'Sonstige',
  *     legendRange: (lower, upper) => `${lower} bis unter ${upper}`,