terra-draw 0.0.1-alpha.3 → 0.0.1-alpha.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. package/CHANGELOG.md +311 -0
  2. package/README.md +25 -4
  3. package/dist/adapters/common/adapter-listener.d.ts +22 -0
  4. package/dist/adapters/common/base-adapter.d.ts +31 -0
  5. package/dist/adapters/common/base.adapter.d.ts +47 -0
  6. package/dist/adapters/google-maps.adapter.d.ts +87 -38
  7. package/dist/adapters/leaflet.adapter.d.ts +98 -35
  8. package/dist/adapters/mapbox-gl.adapter.d.ts +85 -36
  9. package/dist/adapters/maplibre-gl.adapter.d.ts +72 -0
  10. package/dist/adapters/openlayers.adapter.d.ts +117 -0
  11. package/dist/common.d.ts +90 -99
  12. package/dist/extend-types.d.ts +4 -0
  13. package/dist/geometry/boolean/point-in-polygon.d.ts +2 -2
  14. package/dist/geometry/boolean/self-intersects.d.ts +2 -2
  15. package/dist/geometry/centroid.d.ts +2 -2
  16. package/dist/geometry/coordinates-identical.d.ts +2 -2
  17. package/dist/geometry/get-coordinates-as-points.d.ts +6 -6
  18. package/dist/geometry/get-midpoints.d.ts +8 -7
  19. package/dist/geometry/helpers.d.ts +4 -4
  20. package/dist/geometry/limit-decimal-precision.d.ts +1 -1
  21. package/dist/geometry/measure/haversine-distance.d.ts +2 -2
  22. package/dist/geometry/measure/pixel-distance-to-line.d.ts +10 -10
  23. package/dist/geometry/measure/pixel-distance.d.ts +7 -7
  24. package/dist/geometry/measure/rhumb-bearing.d.ts +2 -2
  25. package/dist/geometry/measure/rhumb-destination.d.ts +2 -2
  26. package/dist/geometry/measure/rhumb-distance.d.ts +2 -2
  27. package/dist/geometry/midpoint-coordinate.d.ts +3 -2
  28. package/dist/geometry/shape/create-circle.d.ts +8 -7
  29. package/dist/geometry/shape/great-circle-line.d.ts +12 -0
  30. package/dist/geometry/transform/rotate.d.ts +2 -2
  31. package/dist/geometry/transform/scale.d.ts +2 -2
  32. package/dist/modes/base.behavior.d.ts +19 -19
  33. package/dist/modes/base.mode.d.ts +46 -30
  34. package/dist/modes/circle/circle.mode.d.ts +48 -27
  35. package/dist/modes/click-bounding-box.behavior.d.ts +7 -7
  36. package/dist/modes/freehand/freehand.mode.d.ts +54 -29
  37. package/dist/modes/great-circle-snapping.behavior.d.ts +13 -0
  38. package/dist/modes/greatcircle/great-circle.mode.d.ts +57 -0
  39. package/dist/modes/linestring/linestring.mode.d.ts +60 -34
  40. package/dist/modes/pixel-distance.behavior.d.ts +7 -7
  41. package/dist/modes/point/point.mode.d.ts +38 -18
  42. package/dist/modes/polygon/behaviors/closing-points.behavior.d.ts +19 -0
  43. package/dist/modes/polygon/polygon.mode.d.ts +63 -37
  44. package/dist/modes/rectangle/rectangle.mode.d.ts +48 -0
  45. package/dist/modes/render/render.mode.d.ts +36 -0
  46. package/dist/modes/select/behaviors/drag-coordinate.behavior.d.ts +13 -13
  47. package/dist/modes/select/behaviors/drag-feature.behavior.d.ts +17 -17
  48. package/dist/modes/select/behaviors/features-at-mouse-event.behavior.d.ts +15 -15
  49. package/dist/modes/select/behaviors/midpoint.behavior.d.ts +18 -18
  50. package/dist/modes/select/behaviors/rotate-feature.behavior.d.ts +13 -13
  51. package/dist/modes/select/behaviors/scale-feature.behavior.d.ts +13 -13
  52. package/dist/modes/select/behaviors/selection-point.behavior.d.ts +18 -18
  53. package/dist/modes/select/select.mode.d.ts +89 -62
  54. package/dist/modes/snapping.behavior.d.ts +13 -13
  55. package/dist/modes/static/static.mode.d.ts +31 -13
  56. package/dist/store/spatial-index/quickselect.d.ts +2 -2
  57. package/dist/store/spatial-index/rbush.d.ts +35 -35
  58. package/dist/store/spatial-index/spatial-index.d.ts +18 -18
  59. package/dist/store/store.d.ts +50 -48
  60. package/dist/terra-draw.cjs +1 -1
  61. package/dist/terra-draw.cjs.map +1 -1
  62. package/dist/terra-draw.d.ts +139 -47
  63. package/dist/terra-draw.modern.js +1 -1
  64. package/dist/terra-draw.modern.js.map +1 -1
  65. package/dist/terra-draw.module.js +1 -1
  66. package/dist/terra-draw.module.js.map +1 -1
  67. package/dist/terra-draw.umd.js +1 -1
  68. package/dist/terra-draw.umd.js.map +1 -1
  69. package/dist/util/geoms.d.ts +3 -3
  70. package/dist/util/id.d.ts +1 -1
  71. package/dist/util/styling.d.ts +2 -2
  72. package/{CONTRIBUTING.md → guides/CONTRIBUTING.md} +7 -7
  73. package/guides/DEVELOPMENT.md +156 -0
  74. package/guides/GETTING_STARTED.md +211 -0
  75. package/jest.config.ts +22 -22
  76. package/logo.png +0 -0
  77. package/package.json +151 -87
  78. package/readme.gif +0 -0
  79. package/scratch/release.sh +6 -0
  80. package/tsconfig.json +20 -12
  81. package/DEVELOPMENT.md +0 -77
  82. /package/{CODE_OF_CONDUCT.md → guides/CODE_OF_CONDUCT.md} +0 -0
@@ -1,47 +1,139 @@
1
- import { TerraDrawGoogleMapsAdapter } from "./adapters/google-maps.adapter";
2
- import { TerraDrawLeafletAdapter } from "./adapters/leaflet.adapter";
3
- import { TerraDrawMapboxGLAdapter } from "./adapters/mapbox-gl.adapter";
4
- import { TerraDrawMode, TerraDrawAdapter, TerraDrawAdapterStyling } from "./common";
5
- import { TerraDrawCircleMode } from "./modes/circle/circle.mode";
6
- import { TerraDrawFreehandMode } from "./modes/freehand/freehand.mode";
7
- import { TerraDrawLineStringMode } from "./modes/linestring/linestring.mode";
8
- import { TerraDrawPointMode } from "./modes/point/point.mode";
9
- import { TerraDrawPolygonMode } from "./modes/polygon/polygon.mode";
10
- import { TerraDrawSelectMode } from "./modes/select/select.mode";
11
- import { GeoJSONStoreFeatures } from "./store/store";
12
- declare type ChangeListener = (ids: string[], type: string) => void;
13
- declare type SelectListener = (id: string) => void;
14
- declare type DeselectListener = () => void;
15
- interface TerraDrawEventListeners {
16
- change: ChangeListener;
17
- select: SelectListener;
18
- deselect: DeselectListener;
19
- }
20
- declare type TerraDrawEvents = keyof TerraDrawEventListeners;
21
- declare class TerraDraw {
22
- private _modes;
23
- private _mode;
24
- private _adapter;
25
- private _enabled;
26
- private _store;
27
- private _eventListeners;
28
- constructor(options: {
29
- adapter: TerraDrawAdapter;
30
- modes: {
31
- [mode: string]: TerraDrawMode;
32
- };
33
- data?: GeoJSONStoreFeatures[];
34
- });
35
- private getModeStyles;
36
- setModeStyling(mode: string, styling: TerraDrawAdapterStyling): void;
37
- getSnapshot(): GeoJSONStoreFeatures[];
38
- get enabled(): boolean;
39
- set enabled(_: boolean);
40
- getCurrentMode(): string;
41
- changeMode(mode: string): void;
42
- start(): void;
43
- stop(): void;
44
- on<T extends TerraDrawEvents>(event: T, callback: TerraDrawEventListeners[T]): void;
45
- off<T extends TerraDrawEvents>(event: TerraDrawEvents, callback: TerraDrawEventListeners[T]): void;
46
- }
47
- export { TerraDraw, TerraDrawSelectMode, TerraDrawPointMode, TerraDrawLineStringMode, TerraDrawPolygonMode, TerraDrawCircleMode, TerraDrawFreehandMode, TerraDrawGoogleMapsAdapter, TerraDrawMapboxGLAdapter, TerraDrawLeafletAdapter, };
1
+ import { TerraDrawGoogleMapsAdapter } from "./adapters/google-maps.adapter";
2
+ import { TerraDrawLeafletAdapter } from "./adapters/leaflet.adapter";
3
+ import { TerraDrawMapboxGLAdapter } from "./adapters/mapbox-gl.adapter";
4
+ import { TerraDrawMapLibreGLAdapter } from "./adapters/maplibre-gl.adapter";
5
+ import { TerraDrawOpenLayersAdapter } from "./adapters/openlayers.adapter";
6
+ import { TerraDrawAdapter, TerraDrawAdapterStyling, GetLngLatFromEvent, Project, SetCursor, TerraDrawChanges, TerraDrawStylingFunction, Unproject, HexColor, TerraDrawKeyboardEvent, TerraDrawMouseEvent } from "./common";
7
+ import { TerraDrawBaseAdapter } from "./adapters/common/base.adapter";
8
+ import { TerraDrawBaseDrawMode } from "./modes/base.mode";
9
+ import { TerraDrawCircleMode } from "./modes/circle/circle.mode";
10
+ import { TerraDrawFreehandMode } from "./modes/freehand/freehand.mode";
11
+ import { TerraDrawGreatCircleMode } from "./modes/greatcircle/great-circle.mode";
12
+ import { TerraDrawLineStringMode } from "./modes/linestring/linestring.mode";
13
+ import { TerraDrawPointMode } from "./modes/point/point.mode";
14
+ import { TerraDrawPolygonMode } from "./modes/polygon/polygon.mode";
15
+ import { TerraDrawRectangleMode } from "./modes/rectangle/rectangle.mode";
16
+ import { TerraDrawRenderMode } from "./modes/render/render.mode";
17
+ import { TerraDrawSelectMode } from "./modes/select/select.mode";
18
+ import { GeoJSONStoreFeatures } from "./store/store";
19
+ import { BehaviorConfig } from "./modes/base.behavior";
20
+ type ChangeListener = (ids: string[], type: string) => void;
21
+ type SelectListener = (id: string) => void;
22
+ type DeselectListener = () => void;
23
+ interface TerraDrawEventListeners {
24
+ change: ChangeListener;
25
+ select: SelectListener;
26
+ deselect: DeselectListener;
27
+ }
28
+ type TerraDrawEvents = keyof TerraDrawEventListeners;
29
+ declare class TerraDraw {
30
+ private _modes;
31
+ private _mode;
32
+ private _adapter;
33
+ private _enabled;
34
+ private _store;
35
+ private _eventListeners;
36
+ constructor(options: {
37
+ adapter: TerraDrawAdapter;
38
+ modes: {
39
+ [mode: string]: TerraDrawBaseDrawMode<any>;
40
+ };
41
+ data?: GeoJSONStoreFeatures[];
42
+ });
43
+ private checkEnabled;
44
+ private getModeStyles;
45
+ /**
46
+ * Allows the setting of a style for a given mode
47
+ *
48
+ * @param mode - The mode you wish to set a style for
49
+ * @param styles - The styles you wish to set for the mode - this is
50
+ * the same as the initialisation style schema
51
+ *
52
+ * @alpha
53
+ */
54
+ setModeStyles(mode: string, styles: TerraDrawAdapterStyling): void;
55
+ /**
56
+ * Allows the user to get a snapshot (copy) of all given features
57
+ *
58
+ * @returns An array of all given Feature Geometries in the instances store
59
+ *
60
+ * @alpha
61
+ */
62
+ getSnapshot(): GeoJSONStoreFeatures[];
63
+ /**
64
+ * Removes all data from the current store and removes any rendered layers
65
+ * via the registering the adapter.
66
+ *
67
+ * @alpha
68
+ */
69
+ clear(): void;
70
+ /**
71
+ * A property used to determine whether the instance is active or not. You
72
+ * can use the start method to set this to true, and stop method to set this to false.
73
+ * This is a read only property.
74
+ *
75
+ * @return true or false depending on if the instance is stopped or started
76
+ * @readonly
77
+ * @alpha
78
+ */
79
+ get enabled(): boolean;
80
+ /**
81
+ * enabled is a read only property and will throw and error if you try and set it.
82
+ *
83
+ * @alpha
84
+ */
85
+ set enabled(_: boolean);
86
+ /**
87
+ * A method for getting the current mode name
88
+ *
89
+ * @return the current mode name
90
+ *
91
+ * @alpha
92
+ */
93
+ getMode(): string;
94
+ /**
95
+ * A method for setting the current mode by name. Under the hood this will stop
96
+ * the previous mode and start the new one.
97
+ * @param mode - The mode name you wish to start
98
+ *
99
+ * @alpha
100
+ */
101
+ setMode(mode: string): void;
102
+ /**
103
+ * A method starting Terra Draw. It put the instance into a started state, and
104
+ * in registers the passed adapter giving it all the callbacks required to operate.
105
+ *
106
+ * @alpha
107
+ */
108
+ start(): void;
109
+ /**
110
+ * A method for stopping Terra Draw. Will clear the store, deregister the adapter and
111
+ * remove any rendered layers in the process.
112
+ *
113
+ * @alpha
114
+ */
115
+ stop(): void;
116
+ /**
117
+ * Registers a Terra Draw event
118
+ *
119
+ * @param event - The name of the event you wish to listen for
120
+ * @param callback - The callback with you wish to be called when this event occurs
121
+ *
122
+ * @alpha
123
+ */
124
+ on<T extends TerraDrawEvents>(event: T, callback: TerraDrawEventListeners[T]): void;
125
+ /**
126
+ * Unregisters a Terra Draw event
127
+ *
128
+ * @param event - The name of the event you wish to unregister
129
+ * @param callback - The callback you originally provided to the 'on' method
130
+ *
131
+ * @alpha
132
+ */
133
+ off<T extends TerraDrawEvents>(event: TerraDrawEvents, callback: TerraDrawEventListeners[T]): void;
134
+ }
135
+ declare const TerraDrawExtend: {
136
+ TerraDrawBaseDrawMode: typeof TerraDrawBaseDrawMode;
137
+ TerraDrawBaseAdapter: typeof TerraDrawBaseAdapter;
138
+ };
139
+ export { TerraDraw, TerraDrawSelectMode, TerraDrawPointMode, TerraDrawLineStringMode, TerraDrawGreatCircleMode, TerraDrawPolygonMode, TerraDrawCircleMode, TerraDrawFreehandMode, TerraDrawRenderMode, TerraDrawRectangleMode, TerraDrawGoogleMapsAdapter, TerraDrawMapboxGLAdapter, TerraDrawLeafletAdapter, TerraDrawMapLibreGLAdapter, TerraDrawOpenLayersAdapter, TerraDrawExtend, BehaviorConfig, GeoJSONStoreFeatures, HexColor, TerraDrawMouseEvent, TerraDrawAdapterStyling, TerraDrawKeyboardEvent, TerraDrawChanges, TerraDrawStylingFunction, Project, Unproject, SetCursor, GetLngLatFromEvent, };