@tileflow/core 0.1.0-alpha.42 → 0.1.0-alpha.44
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.
- package/README.md +56 -69
- package/THIRD_PARTY_NOTICES.md +3 -3
- package/dist/{3d-CzLTD0RK.d.ts → 3d-CW5Ls0An.d.ts} +32 -2
- package/dist/3d.d.ts +1 -1
- package/dist/3d.js +425 -50
- package/dist/browser.d.ts +95 -5
- package/dist/browser.js +866 -101
- package/dist/build.d.ts +8 -4
- package/dist/build.js +250 -3
- package/dist/config-reference.json +3395 -2140
- package/dist/{icon-composition-B1A2udKb.d.ts → icon-composition-Bbw9umUA.d.ts} +37 -2
- package/dist/index.d.ts +13 -4
- package/dist/index.js +193 -3
- package/dist/{manifest-types-B0lQjabX.d.ts → manifest-types-CwjHd4qc.d.ts} +8 -0
- package/dist/manifest.d.ts +2 -2
- package/dist/native-profile.d.ts +4 -0
- package/dist/native-profile.js +2 -0
- package/dist/native.js +789 -462
- package/dist/runtime.d.ts +1 -1
- package/dist/worker/camera-tile-worker.global.js +2 -2
- package/package.json +5 -6
- package/docs/application-tile-reading.md +0 -86
- package/docs/authoring-model.md +0 -269
- package/docs/boundary-areas-and-choropleths.md +0 -230
- package/docs/buildings-3d.md +0 -624
- package/docs/camera-moves-and-tile-cache.md +0 -112
- package/docs/capture-scenes.md +0 -40
- package/docs/capture-shots.md +0 -173
- package/docs/cartographic-defaults.md +0 -214
- package/docs/compiled-style-performance.md +0 -286
- package/docs/data-is-separate-from-design.md +0 -610
- package/docs/depth-markers.md +0 -65
- package/docs/dynamic-style-images.md +0 -100
- package/docs/globe-atmosphere.md +0 -113
- package/docs/hosted-session-authorization.md +0 -106
- package/docs/map-and-terrain-examples.md +0 -156
- package/docs/map-emphasis.md +0 -89
- package/docs/native-artifact-profile.md +0 -152
- package/docs/native-resource-urls.md +0 -369
- package/docs/nautical-marks.md +0 -308
- package/docs/public-api-and-browser-subpath.md +0 -101
- package/docs/route-drawing.md +0 -191
- package/docs/shared-visual-primitives.md +0 -101
- package/docs/street-lights.md +0 -127
- package/docs/street-sky.md +0 -156
- package/docs/style-states.md +0 -73
- package/docs/sun-and-light.md +0 -167
- package/docs/theme-transitions-and-blends.md +0 -317
- package/docs/themes-and-module-styles.md +0 -156
- package/docs/trees-3d.md +0 -295
package/README.md
CHANGED
|
@@ -69,9 +69,7 @@ Omitted fields inherit, but declaring a field does not imply a recursive merge:
|
|
|
69
69
|
provider. `atmosphere`, `data`, `projection`, `sky`, `terrain`, and `marine` are also atomic.
|
|
70
70
|
|
|
71
71
|
Identity (`id`, `name`, `version`) and tooling `scenes` and `shots` belong to the leaf map and do not inherit.
|
|
72
|
-
Module object order does not determine rendering order.
|
|
73
|
-
[map inheritance contract](https://github.com/tileflow/tileflow-sdk/blob/main/docs/contracts/map-inheritance.md)
|
|
74
|
-
for the complete merge rules.
|
|
72
|
+
Module object order does not determine rendering order.
|
|
75
73
|
|
|
76
74
|
## Team Icon Sets foundations
|
|
77
75
|
|
|
@@ -105,6 +103,20 @@ Team catalog available to your deployment.
|
|
|
105
103
|
|
|
106
104
|
## Style with themes and semantic modules
|
|
107
105
|
|
|
106
|
+
`roads.pathGround` optionally gives surface paths different colors on mapped green ground and
|
|
107
|
+
elsewhere. It accepts `greenColor`, `groundColor`, optional `widthScale`, and `opacity` (zero
|
|
108
|
+
disables the treatment). The compiler keeps a complete ground-colored path, adds clipped green
|
|
109
|
+
portions from the same HTTP(S) vector source, and places paths below vehicle casings. Grass,
|
|
110
|
+
woods, wetlands, orchards, nurseries, and green recreation polygons supply context; polygon
|
|
111
|
+
holes remain unpainted. Classification follows tile geometry, not imagery or inferred climate.
|
|
112
|
+
|
|
113
|
+
Framework web adapters, CLI preview, capture, and the embedded mobile web runtime register the
|
|
114
|
+
derived-source protocol automatically. Raw MapLibre integrations must call
|
|
115
|
+
`registerTileflowPathGroundProtocol({addProtocol: maplibregl.addProtocol})` from
|
|
116
|
+
`@tileflow/core/browser` before creating the map. The `native-v1` build keeps the complete
|
|
117
|
+
ground-colored paths and disables the green overlay, since native renderers cannot run this
|
|
118
|
+
browser protocol. Its build record explicitly reports `pathGround: 'ground-fallback'`.
|
|
119
|
+
|
|
108
120
|
Themes are complete appearance documents, not loose color overrides. Every theme must supply the
|
|
109
121
|
same token schema. Use `token.color(...)`, `token.number(...)`, `token.image(...)`, and typed font
|
|
110
122
|
roles for theme-dependent values. Use `fixed(value, {reason})` for an intentionally invariant visual
|
|
@@ -138,35 +150,27 @@ export default defineMap({
|
|
|
138
150
|
`system` is a runtime selection policy, not a stored theme. Builds, captures, static scenes, and
|
|
139
151
|
receipts must use a concrete theme such as `light` or `dark`.
|
|
140
152
|
|
|
141
|
-
Theme and `timeOfDay` changes animate over 450 ms by default, respecting reduced motion.
|
|
142
|
-
[theme transitions, time-of-day presets and blends](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/theme-transitions-and-blends.md).
|
|
153
|
+
Theme and `timeOfDay` changes animate over 450 ms by default, respecting reduced motion.
|
|
143
154
|
The same controller can make chosen modules recede and the map's labels fade so an application's
|
|
144
|
-
own content reads first
|
|
155
|
+
own content reads first.
|
|
145
156
|
It also sets the style-wide states that themes read with `expr.globalState`, easing numbers so the
|
|
146
|
-
values a theme interpolates on them move smoothly
|
|
147
|
-
[style states](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/style-states.md).
|
|
157
|
+
values a theme interpolates on them move smoothly.
|
|
148
158
|
For application-drawn RGBA symbols, it also manages fixed-size
|
|
149
|
-
|
|
159
|
+
dynamic style images,
|
|
150
160
|
including state refresh, theme changes and restoration without changing layer placement.
|
|
151
161
|
Applications draw their own routes in the theme's inks, read with `getRouteInks()`, and draw them
|
|
152
162
|
on with `createTileflowLineProgress`. `createTileflowGroundLayers` keeps them under 3D buildings,
|
|
153
|
-
which hide them where they stand in front, and can show the hidden stretches faintly
|
|
154
|
-
[route drawing](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/route-drawing.md).
|
|
163
|
+
which hide them where they stand in front, and can show the hidden stretches faintly.
|
|
155
164
|
A theme can describe its sun and sky light (`lighting.sun`, `lighting.ambient`); the controller
|
|
156
165
|
returns the sun the map shows with `getSun()`, mixed during a blend, for an application's own 3D
|
|
157
|
-
layers, and `setSun()` places it by direction or by the real sun of a date and place
|
|
158
|
-
[sun and light](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/sun-and-light.md).
|
|
166
|
+
layers, and `setSun()` places it by direction or by the real sun of a date and place.
|
|
159
167
|
`createTileflowBuildings3D` enables worker-meshed buildings rising in at zoom 15–15.3, with scene
|
|
160
|
-
sun, cast/contact shadows and 0.8 m rounded corners. Each effect is independently overridable.
|
|
161
|
-
[3D buildings](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/buildings-3d.md).
|
|
168
|
+
sun, cast/contact shadows and 0.8 m rounded corners. Each effect is independently overridable.
|
|
162
169
|
Street lights default to off, including in Streets. Set `roads.streetLights.enabled: true` and mount
|
|
163
|
-
`createTileflowStreetLights` to enable them
|
|
164
|
-
|
|
165
|
-
`createTileflowVegetation` controls all trees using the map's `3d`, `flat` or `auto` policy; see
|
|
166
|
-
[vegetation controls and 3D trees](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/trees-3d.md).
|
|
170
|
+
`createTileflowStreetLights` to enable them.
|
|
171
|
+
`createTileflowVegetation` controls all trees using the map's `3d`, `flat` or `auto` policy.
|
|
167
172
|
|
|
168
173
|
POI icons and names place together; `placement.coupleIconAndLabel: false` separates them.
|
|
169
|
-
See [rank limits](docs/cartographic-defaults.md).
|
|
170
174
|
|
|
171
175
|
The semantic domains are `land`, `water`, `nautical`, `roads`, `buildings`, `boundaries`, `labels`,
|
|
172
176
|
`poi`, `aeroways`, `transit`, `vegetation`, `addresses`, and `landforms`. Style stable geographic
|
|
@@ -231,8 +235,7 @@ framework Map is manifest-backed, without a renderer discriminator or direct-sty
|
|
|
231
235
|
obsolete source fields `kind` and `style` are rejected. Completely unmanaged maps use upstream
|
|
232
236
|
MapLibre directly. Omitted themes use the manifest default, concrete themes select exact names,
|
|
233
237
|
and `system` requires the manifest's explicit light/dark mapping and a supplied runtime color scheme.
|
|
234
|
-
|
|
235
|
-
for source coordination, bounded acquisition and safe diagnostics. The pre-release React Native
|
|
238
|
+
The pre-release React Native
|
|
236
239
|
package uses this contract for its mounted Map; it is not yet published.
|
|
237
240
|
|
|
238
241
|
## Data, terrain, and browser resources
|
|
@@ -251,24 +254,28 @@ vector data retains the attribution supplied by its owner.
|
|
|
251
254
|
form for explicit hillshade and contour configuration. Browser-derived contours require a DEM tile
|
|
252
255
|
template, zoom limits, thresholds, and the Tileflow contour protocol. Framework adapters and local
|
|
253
256
|
tooling prepare browser resources; direct MapLibre integrations must register required protocols
|
|
254
|
-
before loading a style.
|
|
255
|
-
[browser runtime contract](https://github.com/tileflow/tileflow-sdk/blob/main/docs/contracts/framework-browser-runtime.md).
|
|
257
|
+
before loading a style.
|
|
256
258
|
|
|
257
259
|
With `projection: 'globe'`, `atmosphere: true` adds a halo and stars; an object configures colors, star count and size.
|
|
258
260
|
`sky` follows the sun at street level. Frameworks and capture attach both; direct
|
|
259
261
|
MapLibre consumers call `attachTileflowAtmosphere(map)` from `@tileflow/core/browser`.
|
|
260
|
-
See
|
|
261
|
-
[globe atmosphere](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/globe-atmosphere.md)
|
|
262
|
-
and [street sky](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/street-sky.md).
|
|
263
262
|
|
|
264
263
|
Applications that need the map's data themselves, such as streets to route over or the place
|
|
265
264
|
under the camera, read chosen layers of a vector source for an area at a fixed zoom with
|
|
266
|
-
`createTileflowTileReader` from `@tileflow/core/browser`, which also runs in a module worker.
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
265
|
+
`createTileflowTileReader` from `@tileflow/core/browser`, which also runs in a module worker.
|
|
266
|
+
|
|
267
|
+
Browser 3D scenes support `camera.adaptivePerspective`: caller override,
|
|
268
|
+
map default, then `false`. Streets enables it. Depth markers let buildings
|
|
269
|
+
occlude application markers.
|
|
270
|
+
Custom 3D layers load visible ground from the bottom of the viewport towards the horizon before
|
|
271
|
+
spending tiles offscreen. Buildings fade down at the far boundary, across the view's width, and
|
|
272
|
+
distance haze follows that boundary. Coverage follows the viewport and its projection on resize,
|
|
273
|
+
within each layer's `maxTiles` budget (25 by default); views exceeding that budget still have
|
|
274
|
+
bounded coverage, with the nearest ground taking priority.
|
|
275
|
+
Model roles use `modelLighting` for independent colours and materials. `colorScale` (0–1,
|
|
276
|
+
default 1) subtly darkens a role after recolouring. Map-shaded models share the buildings’
|
|
277
|
+
vertical/contact gradient; physical roles keep their own lighting. Model corner geometry is
|
|
278
|
+
authored in the asset, while ordinary tile corners use `edgeRadius`.
|
|
272
279
|
|
|
273
280
|
Text requires exactly one provider. Soundings and Blueprint use URL glyphs; Streets packages DINish
|
|
274
281
|
and Noto Sans; Baedeker, 1777 and Siegfried package Cormorant; Cívica packages its lettering. Hosted
|
|
@@ -277,50 +284,30 @@ URLs do not grant redistribution rights.
|
|
|
277
284
|
|
|
278
285
|
## Reference
|
|
279
286
|
|
|
280
|
-
Use the [generated language schema](https://github.com/tileflow/tileflow-sdk/blob/main/
|
|
281
|
-
[cartographic authoring contract](https://github.com/tileflow/tileflow-sdk/blob/main/docs/contracts/cartographic-authoring.md),
|
|
287
|
+
Use the [generated language schema](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/reference/modules-api-reference.json),
|
|
282
288
|
and [public exports](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/src/index.ts)
|
|
283
289
|
for exact options. Prefer the installed CLI's generated contracts when using a published release;
|
|
284
290
|
`main` can contain unreleased changes. Report defects in the
|
|
285
291
|
[issue tracker](https://github.com/tileflow/tileflow-sdk/issues).
|
|
286
292
|
|
|
287
|
-
## Detailed guides
|
|
288
|
-
|
|
289
|
-
These guides also ship in the installed package under `docs/` and describe this source revision;
|
|
290
|
-
prefer the installed copy for an older release.
|
|
291
|
-
|
|
292
|
-
- [Globe atmosphere](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/globe-atmosphere.md)
|
|
293
|
-
- [Map and terrain examples](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/map-and-terrain-examples.md)
|
|
294
|
-
- [Authoring model](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/authoring-model.md)
|
|
295
|
-
- [Shared visual primitives](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/shared-visual-primitives.md)
|
|
296
|
-
- [Compiled-style performance](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/compiled-style-performance.md)
|
|
297
|
-
- [Camera moves and the tile cache](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/camera-moves-and-tile-cache.md)
|
|
298
|
-
- [Cartographic defaults and overrides](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/cartographic-defaults.md)
|
|
299
|
-
- [Themes and module styles](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/themes-and-module-styles.md)
|
|
300
|
-
- [Theme transitions and blends](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/theme-transitions-and-blends.md)
|
|
301
|
-
- [Map emphasis](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/map-emphasis.md)
|
|
302
|
-
- [Style states](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/style-states.md)
|
|
303
|
-
- [Route drawing](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/route-drawing.md)
|
|
304
|
-
- [Sun and light](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/sun-and-light.md)
|
|
305
|
-
- [3D buildings](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/buildings-3d.md)
|
|
306
|
-
- [Street lights](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/street-lights.md)
|
|
307
|
-
- [3D trees](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/trees-3d.md)
|
|
308
|
-
- [Boundary areas and choropleths](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/boundary-areas-and-choropleths.md)
|
|
309
|
-
- [Nautical marks](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/nautical-marks.md)
|
|
310
|
-
- [Data is separate from design](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/data-is-separate-from-design.md)
|
|
311
|
-
- [Capture scenes](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/capture-scenes.md)
|
|
312
|
-
- [Capture shots](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/capture-shots.md)
|
|
313
|
-
- [Public API and browser subpath](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/public-api-and-browser-subpath.md)
|
|
314
|
-
- [Application tile reading](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/application-tile-reading.md)
|
|
315
|
-
- [Depth markers](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/depth-markers.md)
|
|
316
|
-
- [Hosted session authorization](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/hosted-session-authorization.md)
|
|
317
|
-
- [Native resource URLs](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/native-resource-urls.md)
|
|
318
|
-
- [Native artifact profile](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/native-artifact-profile.md)
|
|
319
|
-
|
|
320
293
|
## Native icon capabilities
|
|
321
294
|
|
|
322
295
|
Prepared icon metadata identifies SDF assets and their default fill and halo. Core rejects any
|
|
323
296
|
symbol layer that can select both SDF and RGBA, including fallbacks and effective local overrides,
|
|
324
297
|
with `TF_ICON_REPRESENTATION_MIXED`. It preserves layers, collisions and interaction IDs. Omitted
|
|
325
298
|
SDF paint follows the resolved image selection; supplied map paint stays independent from asset
|
|
326
|
-
defaults. See [Author recolorable and adaptable icons](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/
|
|
299
|
+
defaults. See [Author recolorable and adaptable icons](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/README.md).
|
|
300
|
+
|
|
301
|
+
Land may supply a georeferenced `globalLandcoverUnderlay` image with `url`, four
|
|
302
|
+
`coordinates` (northwest, northeast, southeast, southwest), `attribution`, zoom bounds
|
|
303
|
+
and themed `opacity`. It is drawn below global cover and omitted when land is disabled.
|
|
304
|
+
Tree forms may use `sizeAnchor` and `crownAnchor` (metres) with `sizeCompression`
|
|
305
|
+
from 0 to 1 to reduce size variation while preserving each tree’s proportions.
|
|
306
|
+
|
|
307
|
+
## Flat footprints under 3D buildings
|
|
308
|
+
|
|
309
|
+
`modules.buildings.threeDimensional.flatFootprints` defaults to `true`. Set it to `false`
|
|
310
|
+
to suspend duplicate flat building fills, outlines and flat shadows in the shared 3D scene,
|
|
311
|
+
after its building entrance zoom. Roads then remain visible beneath open landmark structures.
|
|
312
|
+
Returning to 2D or disposing the scene restores their previous visibility; without WebGL2 the
|
|
313
|
+
flat fallback remains. Streets selects this option; other maps keep their authored treatment.
|
package/THIRD_PARTY_NOTICES.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# Third-party notices
|
|
2
2
|
|
|
3
|
-
`@tileflow/core/browser` embeds `maplibre-contour` 0.1.
|
|
3
|
+
`@tileflow/core/browser` embeds `maplibre-contour` 0.1.1, `PMTiles` 4.5.0, `fflate` 0.8.3, and
|
|
4
4
|
`earcut` 3.2.4 so contour, local archive, and 3D building rendering remain self-contained.
|
|
5
5
|
`@tileflow/core` and `@tileflow/core/browser` embed the decoder of `meshoptimizer` 1.3.0, loaded
|
|
6
6
|
only to read a compressed 3D model file. The complete upstream licenses follow.
|
|
7
7
|
|
|
8
|
-
## maplibre-contour 0.1.
|
|
8
|
+
## maplibre-contour 0.1.1
|
|
9
9
|
|
|
10
10
|
BSD 3-Clause License
|
|
11
11
|
|
|
@@ -295,7 +295,7 @@ OF THIS SOFTWARE.
|
|
|
295
295
|
|
|
296
296
|
---
|
|
297
297
|
|
|
298
|
-
## whatwg-url 17.
|
|
298
|
+
## whatwg-url 17.3.0 and tr46 7.0.0
|
|
299
299
|
|
|
300
300
|
The native entry embeds the low-level `whatwg-url` parser and `tr46` IDNA processing. During the
|
|
301
301
|
native build only, the parser's encoding and query-encoding imports use Tileflow's private UTF-8
|
|
@@ -605,6 +605,25 @@ declare const tileflowBuildings3DLayerId = "tileflow-buildings-3d";
|
|
|
605
605
|
*/
|
|
606
606
|
declare function createTileflowBuildings3D(options: TileflowBuildings3DOptions): TileflowBuildings3D;
|
|
607
607
|
|
|
608
|
+
/** Camera policy used by a map's browser 3D scene. */
|
|
609
|
+
type TileflowCameraOptions = Readonly<{
|
|
610
|
+
/** Subtle top-down perspective at street zooms. Omission uses the map's default, else false. */
|
|
611
|
+
adaptivePerspective?: boolean | undefined;
|
|
612
|
+
}>;
|
|
613
|
+
|
|
614
|
+
/** Public camera capabilities; renderers without a field-of-view setter keep their own lens. */
|
|
615
|
+
type TileflowAdaptiveCameraMap = {
|
|
616
|
+
getPitch(): number;
|
|
617
|
+
getZoom(): number;
|
|
618
|
+
getCanvas?(): {
|
|
619
|
+
clientHeight: number;
|
|
620
|
+
};
|
|
621
|
+
getVerticalFieldOfView?(): number;
|
|
622
|
+
setVerticalFieldOfView?(degrees: number): unknown;
|
|
623
|
+
on(event: string, listener: () => void): unknown;
|
|
624
|
+
off(event: string, listener: () => void): unknown;
|
|
625
|
+
};
|
|
626
|
+
|
|
608
627
|
/** The MapLibre GL JS map capabilities the street lights use. */
|
|
609
628
|
type TileflowStreetLightsMap = {
|
|
610
629
|
addLayer(layer: object, beforeId?: string): unknown;
|
|
@@ -783,6 +802,10 @@ type TileflowTreeFinish = (typeof tileflowTreeFinishes)[number];
|
|
|
783
802
|
type TileflowTreeFormStyle = Readonly<{
|
|
784
803
|
heightScale?: number;
|
|
785
804
|
crownScale?: number;
|
|
805
|
+
/** Reference height/crown in metres and strength of proportional size compression. */
|
|
806
|
+
sizeAnchor?: number;
|
|
807
|
+
crownAnchor?: number;
|
|
808
|
+
sizeCompression?: number;
|
|
786
809
|
/** Ids of the map's own models, one to four; each tree draws one by its stable seed. */
|
|
787
810
|
models?: readonly string[];
|
|
788
811
|
}>;
|
|
@@ -978,6 +1001,9 @@ type TileflowVegetationThreeDimensionalStyle = {
|
|
|
978
1001
|
forms?: Partial<Record<TileflowTreeForm, {
|
|
979
1002
|
heightScale?: TileflowThemeNumberValue;
|
|
980
1003
|
crownScale?: TileflowThemeNumberValue;
|
|
1004
|
+
sizeAnchor?: TileflowThemeNumberValue;
|
|
1005
|
+
crownAnchor?: TileflowThemeNumberValue;
|
|
1006
|
+
sizeCompression?: TileflowThemeNumberValue;
|
|
981
1007
|
models?: readonly string[];
|
|
982
1008
|
}>>;
|
|
983
1009
|
/**
|
|
@@ -1053,7 +1079,7 @@ type TileflowVegetationController = {
|
|
|
1053
1079
|
declare function createTileflowVegetation(options: TileflowVegetationOptions): TileflowVegetationController;
|
|
1054
1080
|
|
|
1055
1081
|
/** The MapLibre GL JS map capabilities the 3D scene uses. */
|
|
1056
|
-
type TileflowMap3DMap = TileflowBuildings3DMap & TileflowStreetLightsMap & TileflowVegetationOptions['map'];
|
|
1082
|
+
type TileflowMap3DMap = TileflowBuildings3DMap & TileflowStreetLightsMap & TileflowAdaptiveCameraMap & TileflowVegetationOptions['map'];
|
|
1057
1083
|
type TileflowMap3DOptions = Readonly<{
|
|
1058
1084
|
map: TileflowMap3DMap;
|
|
1059
1085
|
/** The theme controller, for the sun and the scene's design in every theme. */
|
|
@@ -1062,6 +1088,8 @@ type TileflowMap3DOptions = Readonly<{
|
|
|
1062
1088
|
viewMode?: TileflowViewMode;
|
|
1063
1089
|
/** Overrides the map's vegetation visibility; undefined uses the authored default. */
|
|
1064
1090
|
vegetation?: boolean | undefined;
|
|
1091
|
+
/** Camera overrides. Omission uses the compiled map's policy, falling back to false. */
|
|
1092
|
+
camera?: TileflowCameraOptions;
|
|
1065
1093
|
/** The map's request rules, for the tiles the renderers read. */
|
|
1066
1094
|
transformRequest?: TileflowTileRequestTransform;
|
|
1067
1095
|
}>;
|
|
@@ -1074,6 +1102,8 @@ type TileflowMap3D = {
|
|
|
1074
1102
|
readonly viewMode: TileflowViewMode;
|
|
1075
1103
|
/** Overrides the map's vegetation visibility; undefined restores the authored default. */
|
|
1076
1104
|
setVegetation(visible: boolean | undefined): void;
|
|
1105
|
+
/** Overrides the camera policy; undefined restores the map's authored default. */
|
|
1106
|
+
setAdaptivePerspective(enabled: boolean | undefined): void;
|
|
1077
1107
|
/** The mounted renderers, for diagnostics; each is present while the style declares it. */
|
|
1078
1108
|
readonly buildings: TileflowBuildings3D | undefined;
|
|
1079
1109
|
readonly vegetation: TileflowVegetationController | undefined;
|
|
@@ -1089,4 +1119,4 @@ type TileflowMap3D = {
|
|
|
1089
1119
|
*/
|
|
1090
1120
|
declare function createTileflowMap3D(options: TileflowMap3DOptions): TileflowMap3D;
|
|
1091
1121
|
|
|
1092
|
-
export { type
|
|
1122
|
+
export { type TileflowTrees3D as $, type TileflowBuildings3DOptions as A, type TileflowBuildings3DThemes as B, type TileflowCameraOptions as C, type TileflowMap3DMap as D, type TileflowStreetLights as E, type TileflowStreetLightsMap as F, type TileflowStreetLightsOptions as G, type TileflowSunPreset as H, type TileflowTile as I, type TileflowTileAddress as J, type TileflowTileAreaRequest as K, type TileflowTileFeature as L, type TileflowTileGeometryType as M, type TileflowTileReader as N, type TileflowTileReaderOptions as O, type TileflowTileRequestTransform as P, type TileflowTileSourceMap as Q, type TileflowTreeFields as R, type TileflowTreeForm as S, type TileflowSymbolStyle as T, type TileflowTreeFormMix as U, type TileflowTreeFormRange as V, type TileflowTreeLayers as W, type TileflowTreePlacement as X, type TileflowTreePlacementOptions as Y, type TileflowTreeRange as Z, type TileflowTreeRegion as _, type TileflowThemeImageValue as a, type TileflowTrees3DChange as a0, type TileflowTrees3DMap as a1, type TileflowTrees3DOptions as a2, type TileflowTrees3DThemes as a3, type TileflowVectorTileDecodeOptions as a4, type TileflowVegetation3D as a5, type TileflowVegetationController as a6, type TileflowVegetationDisplay as a7, type TileflowVegetationOptions as a8, type TileflowVegetationRepresentation as a9, tileflowTreeForms as aA, tileflowTrees3DLayerId as aB, tileflowVegetationDisplayMetadataKey as aC, tileflowVegetationMetadataKey as aD, createTileflowBuildings3D as aa, createTileflowMap3D as ab, createTileflowStreetLights as ac, createTileflowTileReader as ad, createTileflowTrees3D as ae, createTileflowVegetation as af, decodeTileflowVectorTile as ag, mixTileflowSunPresets as ah, placeTileflowTrees as ai, readTileflowMapTileSource as aj, readTileflowSunPreset as ak, readTileflowVegetation3D as al, readTileflowVegetationDisplay as am, resolveTileflowSun as an, resolveTileflowVegetationRepresentation as ao, tileflowBuildings3DLayerId as ap, tileflowDefaultSunPreset as aq, tileflowStreetLightsLayerId as ar, tileflowStyleSunPreset as as, tileflowSunDirection as at, tileflowSunMetadataKey as au, tileflowSunPosition as av, tileflowTilePointToLngLat as aw, tileflowTilesForBounds as ax, tileflowTreeBytes as ay, tileflowTreeFormOf as az, type TileflowThemeColorValue as b, type TileflowMarkerSymbolStyle as c, type TileflowAreaStyle as d, type TileflowLineStackStyle as e, type TileflowLineHatchStyle as f, type TileflowIconStyle as g, type TileflowLinePaint as h, type TileflowThemeNumberValue as i, type TileflowNumberStyleValue as j, type TileflowCircleStyle as k, type TileflowLineStyle as l, type TileflowFillStyle as m, type TileflowExtrusionStyle as n, type TileflowThemeValue as o, type TileflowBackgroundStyle as p, type TileflowSymbolPlacement as q, type TileflowVegetationModuleConfig as r, type TileflowTileLayer as s, type TileflowMap3DOptions as t, type TileflowMap3D as u, type TileflowViewMode as v, type TileflowBuildings3DChange as w, type TileflowSun as x, type TileflowBuildings3D as y, type TileflowBuildings3DMap as z };
|
package/dist/3d.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export { u as TileflowMap3D,
|
|
1
|
+
export { C as TileflowCameraOptions, u as TileflowMap3D, D as TileflowMap3DMap, t as TileflowMap3DOptions, ab as createTileflowMap3D } from './3d-CW5Ls0An.js';
|