@tileflow/dev 0.1.0-alpha.29 → 0.1.0-alpha.30

package/dist/tilesets.d.ts

@@ -1 +1,89 @@
-export { a as TileflowTilesetInspectionV1, b as TileflowTilesetInspectionWarning, i as inspectTileflowPmtiles } from './tilesets-C0tGeenP.js';
+declare const inspectionLimits: Readonly<{
+    maxBytes: 24000000;
+    maxDistinctValuesPerField: 256;
+    maxFeatures: 20000;
+    maxIncludedValueFields: 32;
+    maxTiles: 8;
+    maxValueLength: 256;
+    maxValuesPerField: 16;
+}>;
+type TileCoordinate = Readonly<{
+    x: number;
+    y: number;
+    z: number;
+}>;
+type FieldType = 'Boolean' | 'Number' | 'String';
+type FieldValue = boolean | number | string;
+type TileflowTilesetInspectionWarning = Readonly<{
+    code: string;
+    message: string;
+    path: string;
+}>;
+type TileflowTilesetInspectionV1 = Readonly<{
+    schemaVersion: 1;
+    contract: Readonly<{
+        authority: 'pmtiles-header-and-tilejson-v1';
+        attribution?: string;
+        bounds: readonly [number, number, number, number];
+        center: readonly [number, number, number];
+        counts: Readonly<{
+            addressedTiles: number;
+            declaredTileContents: number | null;
+            tileEntries: number;
+        }>;
+        maxzoom: number;
+        minzoom: number;
+        sourceLayersDeclared: boolean;
+        sourceLayers: readonly Readonly<{
+            fieldsDeclared: boolean;
+            fields: readonly Readonly<{
+                name: string;
+                type?: FieldType;
+            }>[];
+            id: string;
+            maxzoom?: number;
+            minzoom?: number;
+        }>[];
+        tileType: 'avif' | 'jpeg' | 'mlt' | 'mvt' | 'png' | 'webp';
+    }>;
+    observation?: Readonly<{
+        authority: 'bounded-mvt-sample-v1';
+        featuresRead: number;
+        includedValueFields: readonly string[];
+        limits: typeof inspectionLimits;
+        sourceLayers: readonly Readonly<{
+            featuresRead: number;
+            fields: readonly Readonly<{
+                distinctValuesObserved: number;
+                distinctValuesTruncated: boolean;
+                featuresMissing: number;
+                featuresPresent: number;
+                name: string;
+                numericRange?: Readonly<{
+                    max: number;
+                    min: number;
+                }>;
+                observedValues?: readonly Readonly<{
+                    count: number;
+                    value: FieldValue;
+                }>[];
+                observedValuesTruncated?: boolean;
+                types: readonly FieldType[];
+            }>[];
+            geometryTypes: readonly string[];
+            id: string;
+        }>[];
+        tiles: readonly TileCoordinate[];
+        tilesRead: number;
+        truncated: boolean;
+    }>;
+    warnings: readonly TileflowTilesetInspectionWarning[];
+}>;
+declare function inspectTileflowPmtiles(archivePath: string, options?: {
+    includeValues?: readonly string[];
+    maximumDirectoryDepth?: number;
+    sample?: boolean;
+    signal?: AbortSignal;
+}): Promise<TileflowTilesetInspectionV1>;
+
+export { type TileflowTilesetInspectionV1, type TileflowTilesetInspectionWarning, inspectTileflowPmtiles };

package/dist/validation.d.ts

@@ -22,7 +22,7 @@ type TileflowDiagnosticSeverity = 'error' | 'info' | 'warning';
 type TileflowStructuredDiagnostic = {
     phase: string;
     code: string;
-    /** Semantic compiler domain. Legacy `owner` inputs are normalized to this field. */
+    /** Semantic compiler domain; a Core diagnostic's owning-module `owner` is reported here. */
     domain?: string;
     path: string;
     /** Semantic compiler target, when the diagnostic applies to one render contribution. */

package/docs/artifact-lifecycle.md

@@ -26,8 +26,7 @@ The integration surfaces are deliberately split: use `@tileflow/dev/artifacts` f
 preparation and production outputs, `@tileflow/dev/server` for HTTP development handling,
 `@tileflow/dev/icons` for icon compilation, `@tileflow/dev/inspect` for safe resolved-config and
 bounded feature inspection, `@tileflow/dev/validation` for structured diagnostics, and
-`@tileflow/dev/preview` only for the local preview contract. The root entry keeps compatibility
-re-exports.
+`@tileflow/dev/preview` only for the local preview contract. The package has no root entry point.
 
 Artifact construction is an explicit `source map → resolved map → prepared map → ArtifactPlan`
 pipeline. Map inheritance resolves before its ordered local/package icon and font directories are
@@ -122,7 +121,7 @@ release. `close()` waits for outstanding acquisitions.
 The bounded watcher follows the config, transitive local TypeScript/JavaScript/JSON imports, and
 effective local icon/font directory inputs. Generations are monotonic, overlapping refreshes are latest-wins, invalid
 edits retain the last good snapshot, and caller-supplied output directories can be ignored to avoid
-feedback loops. `tileflow preview` (`tileflow dev` compatibility alias), `capture --watch`, and
+feedback loops. `tileflow preview`, `capture --watch`, and
 framework adapters use this shared status
 vocabulary. The built-in preview reloads after its live event stream reconnects following a server
 restart, even when the replacement process begins again at generation 1.

package/docs/bounded-vector-feature-inspection.md

@@ -39,11 +39,10 @@ const result = await compileTileflowIconPackages(internalCatalog, {
 });
 ```
 
-Streets declares `[streetsIcons]` and keeps light/dark image-token targets in that one closure;
-Cyberpunk and Matrix independently declare `[cyberpunkIcons]` and `[matrixIcons]`. Baedeker,
-Ferraris, Härad, Siegfried, Soundings, and Blueprint declare only `[baedekerIcons]`,
-`[ferrarisIcons]`, `[haradIcons]`, `[siegfriedIcons]`, `[soundingsIcons]`, and
-`[blueprintIcons]`, respectively. No official root composes another map's assets even though all
+Streets declares `[streetsIcons]` and keeps light/dark image-token targets in that one closure.
+Baedeker, Cívica, Ferraris, Härad, Siegfried, Soundings, and Blueprint declare only
+`[baedekerIcons]`, `[civicaIcons]`, `[ferrarisIcons]`, `[haradIcons]`, `[siegfriedIcons]`,
+`[soundingsIcons]`, and `[blueprintIcons]`, respectively. No official root composes another map's assets even though all
 use the semantic compiler ABI. Baedeker's directory contains eight original travel-atlas patterns;
 its browser-derived Mapterhorn contours use runtime terrain tiles and are not part of the icon
 package. Härad's directory contains nine original Tileflow patterns inspired by Lantmäteriet's CC0

package/docs/native-artifacts.md

@@ -82,6 +82,14 @@ match its layer or an anchor naming a missing layer, fails with `NATIVE_UNSUPPOR
 style's `/metadata` pointer rather than being guessed. Local builds, watched sessions and native
 preview share this step with Hosted publication.
 
+MapLibre Native has no symbol overlap modes and reads only `icon-allow-overlap` and
+`text-allow-overlap`. Lowering replaces each constant `icon-overlap` or `text-overlap` value with
+the matching `*-allow-overlap`: `false` for `never` and `true` for `always` and `cooperative`. A
+cooperative symbol therefore no longer gives way to symbols placed with `never` and can cover labels
+it avoids on the web. The layer keeps its ID and position, so the build record lists it under
+`symbolOverlap` rather than as a layer span. An overlap mode given as an expression fails with its
+property pointer.
+
 Work is bounded per property by depth 16, 512 decision visits, 64 decision paths, 16 distinct
 outcomes and 64 dash elements; the product is limited to 32 physical layers and 32 zoom intervals
 per logical layer. Raw compiler input must fit 160,000 JSON nodes before any lowering. Its expanded
@@ -91,10 +99,10 @@ and 8 MiB. No caller option raises either budget and no rejected input is retrie
 allowance. A failure occurs before output writes and leaves the previous valid generation intact.
 
 This is one shared authored map, not a second mobile catalog: the native-v1 representation adapts
-only finite `line-cap`/`line-dasharray` decisions, together with its explicit fixed-projection
-policy. Unsupported advanced expressions or other properties fail with their native diagnostic
-and JSON Pointer; their web behavior is unchanged. The raw and prepared validators share their
-semantic checks and bounded traversal. See the
+only finite `line-cap`/`line-dasharray` decisions and constant symbol overlap modes, together with
+its explicit fixed-projection policy. Unsupported advanced expressions or other properties fail
+with their native diagnostic and JSON Pointer; their web behavior is unchanged. The raw and
+prepared validators share their semantic checks and bounded traversal. See the
 [Core budget contract](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/native-artifact-profile.md#input-and-prepared-style-budgets)
 for the measured Streets sizes and the approximately 5.2% output margin.
 
@@ -142,10 +150,12 @@ engines, `validation: 'static-artifacts'` and the canonical `build-manifest.json
 schema version is 2 and its `preparationVersion` is `native-lowering-v1`.
 
 The `transformations` array is sorted uniquely by map/theme. Each entry records input and lowered
-style SHA-256 values, input/output layer counts, projection normalization, and the input ordinal,
-output start/count and affected properties of each changed layer. Ordinals refer to the complete
-style layer arrays, including unchanged layers. These spans make the deterministic physical IDs
-traceable without duplicating layer definitions in the receipt. The input hash binds shared
+style SHA-256 values, input/output layer counts and projection normalization. `layers` lists the
+input ordinal, output start/count and affected properties of each partitioned line layer;
+`symbolOverlap` lists the input ordinal and replaced properties of each symbol layer whose overlap
+modes became `*-allow-overlap` values. Ordinals refer to the complete style layer arrays, including
+unchanged layers. These spans make the deterministic
+physical IDs traceable without duplicating layer definitions in the receipt. The input hash binds shared
 compiler output; the lowered hash includes the rebound layer references and precedes native font
 preparation and generation URL retargeting.
 The build-manifest hash separately binds the final prepared styles and assets. All styles receive

package/docs/native-icons.md

@@ -46,7 +46,7 @@ It therefore requires a homogeneous inventory. To use a mixed package, select on
 an explicit `expr.match`/`expr.case` expression whose possible outputs and fallback are homogeneous.
 Sampling the current feature data does not prove this condition.
 
-`tileflow validate`, `tileflow dev`, `tileflow build`, framework preparation and Capture use the
+`tileflow validate`, `tileflow preview`, `tileflow build`, framework preparation and Capture use the
 same check. `TF_ICON_REPRESENTATION_MIXED` identifies the layer and image-selection path. Replace
 the conflicting override, align all selectable representations, or bound the selection explicitly.
 Compiled SDF admission rejects legacy token templates and function objects with

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/dev",
-  "version": "0.1.0-alpha.29",
+  "version": "0.1.0-alpha.30",
   "license": "Apache-2.0",
   "description": "Node development utilities for Tileflow configs and builds.",
   "type": "module",
@@ -24,8 +24,6 @@
   "engines": {
     "node": ">=22"
   },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
   "files": [
     "dist",
     "docs",
@@ -33,11 +31,6 @@
     "LICENSE"
   ],
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    },
     "./artifacts": {
       "types": "./dist/artifacts.d.ts",
       "import": "./dist/artifacts.js",
@@ -90,25 +83,25 @@
   "dependencies": {
     "@mapbox/vector-tile": "3.0.0",
     "@maplibre/maplibre-gl-style-spec": "24.8.5",
-    "@tileflow/core": ">=0.1.0-alpha.31 <0.1.0-beta.0",
+    "@tileflow/core": ">=0.1.0-alpha.32 <0.1.0-beta.0",
     "chokidar": "4.0.3",
     "fflate": "0.8.3",
     "fontkit": "2.0.4",
     "jiti": "^2.7.0",
-    "maplibre-gl": "6.9.0",
+    "maplibre-gl": "6.13.0",
     "pbf": "5.1.2",
     "pmtiles": "4.5.0",
     "saxes": "6.0.0",
     "three": "0.185.1"
   },
   "devDependencies": {
-    "@tileflow/maps": "0.1.0-alpha.7"
+    "@tileflow/maps": "0.1.0-alpha.8"
   },
   "optionalDependencies": {
-    "sharp": "0.35.4"
+    "sharp": "0.35.5"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/artifacts.ts src/config.ts src/fonts.ts src/icons.ts src/inspect.ts src/preview.ts src/server.ts src/tilesets.ts src/validation.ts --format esm --dts --clean --platform node --external sharp",
+    "build": "tsup src/artifacts.ts src/config.ts src/fonts.ts src/icons.ts src/inspect.ts src/preview.ts src/server.ts src/tilesets.ts src/validation.ts --format esm --dts --clean --platform node --external sharp",
     "test": "tsx --test test/*.test.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint": "tsc -p tsconfig.json --noEmit",