@tileflow/core 0.1.0-alpha.31 → 0.1.0-alpha.33

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 (40) hide show
  1. package/README.md +41 -2
  2. package/THIRD_PARTY_NOTICES.md +25 -2
  3. package/dist/browser.d.ts +1008 -16
  4. package/dist/browser.js +6661 -1392
  5. package/dist/build.d.ts +64 -56
  6. package/dist/build.js +702 -253
  7. package/dist/capture-shot-ChPQvPyi.d.ts +291 -0
  8. package/dist/capture.d.ts +1 -1
  9. package/dist/capture.js +230 -0
  10. package/dist/config-reference.json +1710 -1370
  11. package/dist/{icon-composition-BiOTwrvD.d.ts → icon-composition-CSnN2-Xt.d.ts} +169 -33
  12. package/dist/index.d.ts +57 -13
  13. package/dist/index.js +1684 -800
  14. package/dist/{manifest-types-CTT2eLbp.d.ts → manifest-types-E7m23eXL.d.ts} +18 -1
  15. package/dist/manifest.d.ts +2 -2
  16. package/dist/native-profile.d.ts +25 -11
  17. package/dist/native-profile.js +21 -1
  18. package/dist/native.js +1893 -1884
  19. package/dist/runtime.d.ts +1 -1
  20. package/docs/application-tile-reading.md +80 -0
  21. package/docs/authoring-model.md +16 -6
  22. package/docs/buildings-3d.md +168 -0
  23. package/docs/camera-moves-and-tile-cache.md +112 -0
  24. package/docs/capture-scenes.md +5 -1
  25. package/docs/capture-shots.md +173 -0
  26. package/docs/compiled-style-performance.md +4 -1
  27. package/docs/data-is-separate-from-design.md +103 -9
  28. package/docs/depth-markers.md +65 -0
  29. package/docs/dynamic-style-images.md +100 -0
  30. package/docs/native-artifact-profile.md +5 -3
  31. package/docs/public-api-and-browser-subpath.md +3 -3
  32. package/docs/route-drawing.md +191 -0
  33. package/docs/shared-visual-primitives.md +20 -0
  34. package/docs/street-lights.md +80 -0
  35. package/docs/style-states.md +73 -0
  36. package/docs/sun-and-light.md +125 -0
  37. package/docs/theme-transitions-and-blends.md +41 -2
  38. package/docs/themes-and-module-styles.md +7 -0
  39. package/package.json +4 -1
  40. package/dist/capture-scene-D6soWztE.d.ts +0 -161
package/dist/build.d.ts CHANGED
@@ -1,7 +1,7 @@
1
- import { T as TileflowCaptureScene } from './capture-scene-D6soWztE.js';
2
- import { T as TileflowRenderedIconIdentity, a as TileflowIconCompositionV1, R as ResolvedTileflowMap, b as TileflowDataRequirementsV1, c as TileflowSourceRequirementsV1, d as TileflowMap, e as TileflowStyleOptions, f as TileflowInspectedStyle, g as TileflowPreparedMapAssets } from './icon-composition-BiOTwrvD.js';
3
- export { h as TileflowDataCompatibilityIssue, i as TileflowDataFieldRequirement, j as TileflowDataFieldType, k as TileflowDataLayerRequirement, l as TileflowObservedDataContractV1, m as TileflowStyleInspection, n as TileflowStyleInspectionContribution, o as TileflowStyleInspectionLayer, p as TileflowStyleInspectionRenderOperation, q as collectMapLineage, r as inferTileflowDataRequirements, s as inferTileflowSourceRequirements, t as tileflowStyleInspectionSchemaVersion, v as validateTileflowDataCompatibility } from './icon-composition-BiOTwrvD.js';
4
- import { M as MapLibreStyle, T as TileflowRuntimeManifest } from './manifest-types-CTT2eLbp.js';
1
+ import { T as TileflowCaptureScene, a as TileflowCaptureShot } from './capture-shot-ChPQvPyi.js';
2
+ import { T as TileflowRenderedIconIdentity, a as TileflowIconCompositionV1, R as ResolvedTileflowMap, b as TileflowDataRequirementsV1, c as TileflowSourceRequirementsV1, d as TileflowMap, e as TileflowStyleOptions, f as TileflowInspectedStyle, g as TileflowPreparedMapAssets } from './icon-composition-CSnN2-Xt.js';
3
+ export { h as TileflowDataCompatibilityIssue, i as TileflowDataFieldRequirement, j as TileflowDataFieldType, k as TileflowDataLayerRequirement, l as TileflowObservedDataContractV1, m as TileflowStyleInspection, n as TileflowStyleInspectionContribution, o as TileflowStyleInspectionLayer, p as TileflowStyleInspectionRenderOperation, q as collectMapLineage, r as inferTileflowDataRequirements, s as inferTileflowSourceRequirements, t as tileflowStyleInspectionSchemaVersion, v as validateTileflowDataCompatibility } from './icon-composition-CSnN2-Xt.js';
4
+ import { M as MapLibreStyle, T as TileflowRuntimeManifest } from './manifest-types-E7m23eXL.js';
5
5
  import { z } from 'zod';
6
6
 
7
7
  declare const tileflowMapRevisionSchemaVersion: 1;
@@ -105,7 +105,7 @@ type TileflowMapBuildManifestV1 = {
105
105
  * Create the portable map build identity document.
106
106
  *
107
107
  * `mapRevisionSha256` identifies the effective cartographic definition and effective source
108
- * icon/font bytes. Editorial identity, default view, capture scenes, package
108
+ * icon/font bytes. Editorial identity, default view, capture scenes and shots, package
109
109
  * versions, compiler ABI versions, compiled Style JSON, generated sprite/font outputs, filesystem
110
110
  * paths, and a concrete resolution of a floating World selector are outside that hash. They have
111
111
  * their own identities or remain tooling/delivery state.
@@ -146,8 +146,8 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
146
146
  teamSources: z.ZodRecord<z.ZodString, z.ZodObject<{
147
147
  tileset: z.ZodString;
148
148
  type: z.ZodEnum<{
149
- vector: "vector";
150
149
  raster: "raster";
150
+ vector: "vector";
151
151
  }>;
152
152
  }, z.core.$strict>>;
153
153
  view: z.ZodOptional<z.ZodObject<{
@@ -204,8 +204,8 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
204
204
  }>;
205
205
  id: z.ZodString;
206
206
  kind: z.ZodEnum<{
207
- pattern: "pattern";
208
207
  icon: "icon";
208
+ pattern: "pattern";
209
209
  }>;
210
210
  sha256: z.ZodString;
211
211
  }, z.core.$strict>, z.ZodObject<{
@@ -259,13 +259,6 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
259
259
  }, z.core.$strict>], "kind">>;
260
260
  winners: z.ZodArray<z.ZodObject<{
261
261
  id: z.ZodString;
262
- width: z.ZodNumber;
263
- height: z.ZodNumber;
264
- layout: z.ZodOptional<z.ZodObject<{
265
- stretchX: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
266
- stretchY: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
267
- content: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
268
- }, z.core.$strict>>;
269
262
  appearance: z.ZodOptional<z.ZodObject<{
270
263
  representation: z.ZodLiteral<"sdf">;
271
264
  defaults: z.ZodObject<{
@@ -275,6 +268,13 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
275
268
  haloBlur: z.ZodNumber;
276
269
  }, z.core.$strict>;
277
270
  }, z.core.$strict>>;
271
+ layout: z.ZodOptional<z.ZodObject<{
272
+ stretchX: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
273
+ stretchY: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
274
+ content: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
275
+ }, z.core.$strict>>;
276
+ width: z.ZodNumber;
277
+ height: z.ZodNumber;
278
278
  pixelSha256: z.ZodObject<{
279
279
  oneX: z.ZodString;
280
280
  twoX: z.ZodString;
@@ -316,40 +316,6 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
316
316
  styles: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
317
317
  }, z.core.$strict>;
318
318
  native: z.ZodObject<{
319
- buildRecord: z.ZodLazy<z.core.$ZodObject<{
320
- schemaVersion: z.ZodLiteral<2>;
321
- renderer: z.ZodLiteral<"native">;
322
- profile: z.ZodLiteral<"native-v1">;
323
- validation: z.ZodLiteral<"static-artifacts">;
324
- preparationVersion: z.ZodLiteral<"native-lowering-v1">;
325
- engines: z.ZodLazy<z.core.$ZodObject<{
326
- android: z.ZodLiteral<"13.2.0">;
327
- ios: z.ZodLiteral<"6.26.0">;
328
- }, z.core.$strict>>;
329
- buildManifestSha256: z.ZodString;
330
- transformations: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
331
- map: z.ZodString;
332
- theme: z.ZodString;
333
- inputStyleSha256: z.ZodString;
334
- loweredStyleSha256: z.ZodString;
335
- inputLayers: z.ZodNumber;
336
- outputLayers: z.ZodNumber;
337
- projection: z.ZodEnum<{
338
- none: "none";
339
- "mercator-to-implicit": "mercator-to-implicit";
340
- "globe-to-mercator": "globe-to-mercator";
341
- }>;
342
- layers: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
343
- inputLayer: z.ZodNumber;
344
- outputStart: z.ZodNumber;
345
- outputCount: z.ZodNumber;
346
- properties: z.ZodArray<z.ZodEnum<{
347
- "line-dasharray": "line-dasharray";
348
- "line-cap": "line-cap";
349
- }>>;
350
- }, z.core.$strict>>>;
351
- }, z.core.$strict>>>;
352
- }, z.core.$strict>>;
353
319
  buildManifest: z.ZodObject<{
354
320
  schemaVersion: z.ZodLiteral<1>;
355
321
  maps: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -396,8 +362,8 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
396
362
  }>;
397
363
  id: z.ZodString;
398
364
  kind: z.ZodEnum<{
399
- pattern: "pattern";
400
365
  icon: "icon";
366
+ pattern: "pattern";
401
367
  }>;
402
368
  sha256: z.ZodString;
403
369
  }, z.core.$strict>, z.ZodObject<{
@@ -451,13 +417,6 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
451
417
  }, z.core.$strict>], "kind">>;
452
418
  winners: z.ZodArray<z.ZodObject<{
453
419
  id: z.ZodString;
454
- width: z.ZodNumber;
455
- height: z.ZodNumber;
456
- layout: z.ZodOptional<z.ZodObject<{
457
- stretchX: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
458
- stretchY: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
459
- content: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
460
- }, z.core.$strict>>;
461
420
  appearance: z.ZodOptional<z.ZodObject<{
462
421
  representation: z.ZodLiteral<"sdf">;
463
422
  defaults: z.ZodObject<{
@@ -467,6 +426,13 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
467
426
  haloBlur: z.ZodNumber;
468
427
  }, z.core.$strict>;
469
428
  }, z.core.$strict>>;
429
+ layout: z.ZodOptional<z.ZodObject<{
430
+ stretchX: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
431
+ stretchY: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
432
+ content: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
433
+ }, z.core.$strict>>;
434
+ width: z.ZodNumber;
435
+ height: z.ZodNumber;
470
436
  pixelSha256: z.ZodObject<{
471
437
  oneX: z.ZodString;
472
438
  twoX: z.ZodString;
@@ -506,6 +472,47 @@ declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
506
472
  }, z.core.$strict>>;
507
473
  }, z.core.$strict>;
508
474
  styles: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
475
+ buildRecord: z.ZodLazy<z.core.$ZodObject<{
476
+ schemaVersion: z.ZodLiteral<2>;
477
+ renderer: z.ZodLiteral<"native">;
478
+ profile: z.ZodLiteral<"native-v1">;
479
+ validation: z.ZodLiteral<"static-artifacts">;
480
+ preparationVersion: z.ZodLiteral<"native-lowering-v1">;
481
+ engines: z.ZodLazy<z.core.$ZodObject<{
482
+ android: z.ZodLiteral<"13.2.0">;
483
+ ios: z.ZodLiteral<"6.26.0">;
484
+ }, z.core.$strict>>;
485
+ buildManifestSha256: z.ZodString;
486
+ transformations: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
487
+ map: z.ZodString;
488
+ theme: z.ZodString;
489
+ inputStyleSha256: z.ZodString;
490
+ loweredStyleSha256: z.ZodString;
491
+ inputLayers: z.ZodNumber;
492
+ outputLayers: z.ZodNumber;
493
+ projection: z.ZodEnum<{
494
+ "globe-to-mercator": "globe-to-mercator";
495
+ "mercator-to-implicit": "mercator-to-implicit";
496
+ none: "none";
497
+ }>;
498
+ layers: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
499
+ inputLayer: z.ZodNumber;
500
+ outputStart: z.ZodNumber;
501
+ outputCount: z.ZodNumber;
502
+ properties: z.ZodArray<z.ZodEnum<{
503
+ "line-cap": "line-cap";
504
+ "line-dasharray": "line-dasharray";
505
+ }>>;
506
+ }, z.core.$strict>>>;
507
+ symbolOverlap: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
508
+ inputLayer: z.ZodNumber;
509
+ properties: z.ZodArray<z.ZodEnum<{
510
+ "icon-overlap": "icon-overlap";
511
+ "text-overlap": "text-overlap";
512
+ }>>;
513
+ }, z.core.$strict>>>;
514
+ }, z.core.$strict>>>;
515
+ }, z.core.$strict>>;
509
516
  }, z.core.$strict>;
510
517
  }, z.core.$strict>;
511
518
  }, z.core.$strict>;
@@ -552,6 +559,7 @@ type TileflowBuildCatalog = {
552
559
  maps: Record<string, ResolvedTileflowMap>;
553
560
  mapMetadata?: Record<string, TileflowCompiledMapMetadata>;
554
561
  scenes?: Record<string, TileflowCaptureScene>;
562
+ shots?: Record<string, TileflowCaptureShot>;
555
563
  };
556
564
  /** Complete compiled style family, addressed first by logical map and then by theme name. */
557
565
  type TileflowBuildStyles = Record<string, Record<string, MapLibreStyle>>;