@tileflow/dev 0.1.0-alpha.19 → 0.1.0-alpha.20

package/dist/config.js

@@ -10,7 +10,7 @@ import {
   loadTileflowConfigWithInputs,
   loadValidTileflowConfig,
   loadValidTileflowConfigWithInputs
-} from "./chunk-BKHIZ7H2.js";
+} from "./chunk-6MGFMKG3.js";
 import "./chunk-D4OE4ITL.js";
 export {
   TileflowValidationError,

package/dist/fonts.js

@@ -4,7 +4,7 @@ import {
   getTileflowFontWatchPaths,
   prepareTileflowStyleFonts,
   replaceTileflowStyleFontSources
-} from "./chunk-VEB43KDS.js";
+} from "./chunk-RSBV4L2Y.js";
 import "./chunk-BL3FK4GO.js";
 import "./chunk-D4OE4ITL.js";
 export {

package/dist/icons.js

@@ -5,7 +5,7 @@ import {
   iconFileExtensions,
   inspectTileflowIconCatalogs,
   prepareTileflowCatalogIcons
-} from "./chunk-BALG4DSG.js";
+} from "./chunk-CENQR5Q2.js";
 import "./chunk-BL3FK4GO.js";
 export {
   TileflowIconCompilationError,

package/dist/index.d.ts

@@ -1,11 +1,12 @@
-export { CreateTileflowArtifactPlanOptions, TileflowArtifactDiagnostic, TileflowArtifactFile, TileflowArtifactInputGraph, TileflowArtifactPlan, TileflowArtifactSession, TileflowArtifactSessionOptions, TileflowArtifactSessionState, TileflowBuildArtifacts, TileflowBuildArtifactsOptions, TileflowBuildStyleInspections, TileflowHostedManifestOverwriteError, TileflowManifestOptions, WriteTileflowArtifactPlanOptions, WriteTileflowBuildArtifactsOptions, assertTileflowSelfHostedManifestTarget, createTileflowArtifactDiagnostics, createTileflowArtifactPlan, createTileflowArtifactSession, createTileflowBuildArtifacts, createTileflowBuildProvenance, createTileflowManifest, createTileflowStyle, createTileflowStyles, getTileflowArtifactFiles, getTileflowAssetBasePath, getTileflowAssetFileName, getTileflowWatchPaths, isTileflowArtifactInputPath, joinTileflowPublicUrl, normalizeTileflowBasePath, refreshTileflowArtifactSession, resolveTileflowArtifactPublicUrls, tileflowArtifactInventoryFileName, tileflowArtifactPlanSchemaVersion, tileflowArtifactSessionSchemaVersion, writeTileflowArtifactPlan, writeTileflowBuildArtifacts } from './artifacts.js';
+export { CreateTileflowArtifactPlanOptions, TileflowArtifactAcquisition, TileflowArtifactDiagnostic, TileflowArtifactFile, TileflowArtifactInputGraph, TileflowArtifactPlan, TileflowArtifactSession, TileflowArtifactSessionOptions, TileflowArtifactSessionState, TileflowBuildArtifacts, TileflowBuildArtifactsOptions, TileflowBuildStyleInspections, TileflowHostedManifestOverwriteError, TileflowLocalTilesetFile, TileflowLocalTilesetProductionError, TileflowManifestOptions, WriteTileflowArtifactPlanOptions, WriteTileflowBuildArtifactsOptions, assertNoLocalTilesetsForProduction, assertTileflowSelfHostedManifestTarget, createTileflowArtifactDiagnostics, createTileflowArtifactPlan, createTileflowArtifactSession, createTileflowBuildArtifacts, createTileflowBuildProvenance, createTileflowManifest, createTileflowStyle, createTileflowStyles, disposeTileflowBuildArtifacts, getTileflowArtifactFiles, getTileflowAssetBasePath, getTileflowAssetFileName, getTileflowWatchPaths, isTileflowArtifactInputPath, joinTileflowPublicUrl, normalizeTileflowBasePath, prepareTileflowLocalTilesets, refreshTileflowArtifactSession, resolveTileflowArtifactPublicUrls, tileflowArtifactInventoryFileName, tileflowArtifactPlanSchemaVersion, tileflowArtifactSessionSchemaVersion, writeTileflowArtifactPlan, writeTileflowBuildArtifacts } from './artifacts.js';
 export { LoadTileflowConfigOptions, LoadedTileflowConfig, TileflowValidationError, assertValidTileflowConfig, defaultTileflowApiUrl, defaultTileflowConfigPath, defaultTileflowManifestPath, getFirstTileflowMapName, getTileflowMapNames, loadTileflowConfig, loadTileflowConfigWithInputs, loadValidTileflowConfig, loadValidTileflowConfigWithInputs } from './config.js';
 export { CompiledTileflowFontBundle, PrepareTileflowStyleFontsOptions, PreparedTileflowStyleFonts, TileflowFontCompilationError, TileflowFontCompilationIssue, TileflowFontCompilationTarget, bindTileflowStyleFontBundle, getTileflowFontWatchPaths, prepareTileflowStyleFonts, replaceTileflowStyleFontSources } from './fonts.js';
 export { CompileTileflowIconPackagesResult, CompiledTileflowIconPackage, CompiledTileflowIconPackageFile, InspectTileflowIconCatalogsOptions, PreparedTileflowBuildCatalog, PreparedTileflowCatalog, TileflowBuildAsset, TileflowIconCatalog, TileflowIconCatalogAtlasRectangle, TileflowIconCatalogIcon, TileflowIconCatalogInspection, TileflowIconCatalogMap, TileflowIconCatalogRenderedDensity, TileflowIconCatalogSourceFormat, TileflowIconCompilationError, TileflowIconCompilationIssue, TileflowIconCompilationTarget, TileflowIconReplacement, TileflowMapIconPackageBinding, TileflowSourceCatalog, compileTileflowIconPackages, getTileflowIconWatchPaths, iconFileExtensions, inspectTileflowIconCatalogs, prepareTileflowCatalogIcons } from './icons.js';
-export { TileflowConfigInspection, TileflowConfigInspectionError, TileflowConfigInspectionOptions, TileflowFeatureInspection, TileflowFeatureInspectionOptions, TileflowInspectedFeature, TileflowInspectedProperty, TileflowMapLineageInspection, TileflowMapMergeProvenance, TileflowResolvedMapInspection, TileflowThemeContractInspection, TileflowThemeDifferenceInspection, TileflowThemeInspection, inspectLoadedTileflowConfig, inspectTileflowConfig, inspectTileflowFeatures } from './inspect.js';
+export { TileflowConfigInspection, TileflowConfigInspectionError, TileflowConfigInspectionOptions, TileflowFeatureInspection, TileflowFeatureInspectionOptions, TileflowInspectedFeature, TileflowInspectedProperty, TileflowMapLineageInspection, TileflowMapMergeProvenance, TileflowResolvedMapInspection, TileflowThemeContractInspection, TileflowThemeDifferenceInspection, TileflowThemeInspection, inspectLoadedTileflowConfig, inspectTileflowConfig, inspectTileflowFeatures, sanitizeTileflowInspectableValue } from './inspect.js';
 export { ResolvedTileflowPreview, TileflowLandmark, TileflowLandmarkArchive, TileflowLandmarkAxisConvention, TileflowLandmarkManifestV2, TileflowLandmarkModel, TileflowPreviewSelection, TileflowPreviewSelectionError, normalizeTileflowLandmarkManifest, readBoundedTileflowJsonResponse, readBoundedTileflowResponse, renderTileflowPreviewHtml, resolveTileflowPreview } from './preview.js';
-export { TileflowComparisonMode, TileflowComparisonOptions, TileflowComparisonRequestHandler, TileflowComparisonSide, TileflowDevRequestHandlerOptions, createTileflowArtifactStatus, createTileflowComparisonRequestHandler, createTileflowDevRequestHandler, createTileflowNodeRequest, getTileflowRequestPath, getTileflowStyleInspectionSelection, getTileflowStyleSelection, isTileflowRequestUrl, tileflowComparisonSchemaVersion, writeTileflowNodeResponse } from './server.js';
-export { TileflowCommandFailureDocument, TileflowCommandSummary, TileflowDiagnosticSeverity, TileflowStructuredDiagnostic, TileflowStyleValidationError, TileflowStyleValidationIssue, assertValidTileflowStyle, createTileflowCommandFailureDocument, createTileflowCommandSummary, createTileflowStructuredDiagnostics, serializeTileflowCommandDocument, tileflowCommandDocumentSchemaVersion, validateTileflowStyle } from './validation.js';
+export { TileflowComparisonMode, TileflowComparisonOptions, TileflowComparisonRequestHandler, TileflowComparisonSide, TileflowDevRequestHandler, TileflowDevRequestHandlerOptions, createTileflowArtifactStatus, createTileflowComparisonRequestHandler, createTileflowDevRequestHandler, createTileflowNodeRequest, getTileflowRequestPath, getTileflowStyleInspectionSelection, getTileflowStyleSelection, isTileflowRequestUrl, tileflowComparisonSchemaVersion, writeTileflowNodeResponse } from './server.js';
+export { T as TileflowLocalTilesetInspection, a as TileflowTilesetInspectionV1, b as TileflowTilesetInspectionWarning, i as inspectTileflowPmtiles, c as inspectTileflowPmtilesForLocalUse } from './tilesets-C0tGeenP.js';
+export { TileflowCommandFailureDocument, TileflowCommandSummary, TileflowDiagnosticSeverity, TileflowStructuredDiagnostic, TileflowStyleValidationError, TileflowStyleValidationIssue, assertValidTileflowStyle, createTileflowCommandFailureDocument, createTileflowCommandSummary, createTileflowStructuredDiagnostics, sanitizeDiagnosticSecrets, serializeTileflowCommandDocument, tileflowCommandDocumentSchemaVersion, validateTileflowStyle } from './validation.js';
 import '@tileflow/core';
 import '@tileflow/core/build';
 import '@tileflow/core/manifest';

package/dist/index.js

@@ -2,15 +2,16 @@ import {
   TileflowConfigInspectionError,
   inspectLoadedTileflowConfig,
   inspectTileflowConfig,
-  inspectTileflowFeatures
-} from "./chunk-ZOYFZ3MT.js";
+  inspectTileflowFeatures,
+  sanitizeTileflowInspectableValue
+} from "./chunk-MKPSQSMX.js";
 import {
   createTileflowCommandFailureDocument,
   createTileflowCommandSummary,
   createTileflowStructuredDiagnostics,
   serializeTileflowCommandDocument,
   tileflowCommandDocumentSchemaVersion
-} from "./chunk-ZRI6PNFL.js";
+} from "./chunk-LNCTVFUD.js";
 import {
   TileflowPreviewSelectionError,
   normalizeTileflowLandmarkManifest,
@@ -18,7 +19,7 @@ import {
   readBoundedTileflowResponse,
   renderTileflowPreviewHtml,
   resolveTileflowPreview
-} from "./chunk-GWUMIHL6.js";
+} from "./chunk-MIGBHCXX.js";
 import {
   createTileflowArtifactStatus,
   createTileflowComparisonRequestHandler,
@@ -30,9 +31,11 @@ import {
   isTileflowRequestUrl,
   tileflowComparisonSchemaVersion,
   writeTileflowNodeResponse
-} from "./chunk-OEABXOJH.js";
+} from "./chunk-KH7CMHT3.js";
 import {
   TileflowHostedManifestOverwriteError,
+  TileflowLocalTilesetProductionError,
+  assertNoLocalTilesetsForProduction,
   assertTileflowSelfHostedManifestTarget,
   createTileflowArtifactDiagnostics,
   createTileflowArtifactPlan,
@@ -42,16 +45,22 @@ import {
   createTileflowManifest,
   createTileflowStyle,
   createTileflowStyles,
+  disposeTileflowBuildArtifacts,
   getTileflowArtifactFiles,
   getTileflowWatchPaths,
   isTileflowArtifactInputPath,
+  prepareTileflowLocalTilesets,
   refreshTileflowArtifactSession,
   tileflowArtifactInventoryFileName,
   tileflowArtifactPlanSchemaVersion,
   tileflowArtifactSessionSchemaVersion,
   writeTileflowArtifactPlan,
   writeTileflowBuildArtifacts
-} from "./chunk-O7PE6FB2.js";
+} from "./chunk-XTRHREXO.js";
+import {
+  inspectTileflowPmtiles,
+  inspectTileflowPmtilesForLocalUse
+} from "./chunk-ONYQNLNA.js";
 import {
   TileflowFontCompilationError,
   bindTileflowStyleFontBundle,
@@ -63,7 +72,7 @@ import {
   prepareTileflowStyleFonts,
   replaceTileflowStyleFontSources,
   resolveTileflowArtifactPublicUrls
-} from "./chunk-VEB43KDS.js";
+} from "./chunk-RSBV4L2Y.js";
 import {
   TileflowIconCompilationError,
   compileTileflowIconPackages,
@@ -71,11 +80,12 @@ import {
   iconFileExtensions,
   inspectTileflowIconCatalogs,
   prepareTileflowCatalogIcons
-} from "./chunk-BALG4DSG.js";
+} from "./chunk-CENQR5Q2.js";
 import "./chunk-BL3FK4GO.js";
 import {
   TileflowStyleValidationError,
   assertValidTileflowStyle,
+  sanitizeDiagnosticSecrets,
   validateTileflowStyle
 } from "./chunk-KDFTE4Q5.js";
 import {
@@ -90,16 +100,18 @@ import {
   loadTileflowConfigWithInputs,
   loadValidTileflowConfig,
   loadValidTileflowConfigWithInputs
-} from "./chunk-BKHIZ7H2.js";
+} from "./chunk-6MGFMKG3.js";
 import "./chunk-D4OE4ITL.js";
 export {
   TileflowConfigInspectionError,
   TileflowFontCompilationError,
   TileflowHostedManifestOverwriteError,
   TileflowIconCompilationError,
+  TileflowLocalTilesetProductionError,
   TileflowPreviewSelectionError,
   TileflowStyleValidationError,
   TileflowValidationError,
+  assertNoLocalTilesetsForProduction,
   assertTileflowSelfHostedManifestTarget,
   assertValidTileflowConfig,
   assertValidTileflowStyle,
@@ -123,6 +135,7 @@ export {
   defaultTileflowApiUrl,
   defaultTileflowConfigPath,
   defaultTileflowManifestPath,
+  disposeTileflowBuildArtifacts,
   getFirstTileflowMapName,
   getTileflowArtifactFiles,
   getTileflowAssetBasePath,
@@ -139,6 +152,8 @@ export {
   inspectTileflowConfig,
   inspectTileflowFeatures,
   inspectTileflowIconCatalogs,
+  inspectTileflowPmtiles,
+  inspectTileflowPmtilesForLocalUse,
   isTileflowArtifactInputPath,
   isTileflowRequestUrl,
   joinTileflowPublicUrl,
@@ -149,6 +164,7 @@ export {
   normalizeTileflowBasePath,
   normalizeTileflowLandmarkManifest,
   prepareTileflowCatalogIcons,
+  prepareTileflowLocalTilesets,
   prepareTileflowStyleFonts,
   readBoundedTileflowJsonResponse,
   readBoundedTileflowResponse,
@@ -157,6 +173,8 @@ export {
   replaceTileflowStyleFontSources,
   resolveTileflowArtifactPublicUrls,
   resolveTileflowPreview,
+  sanitizeDiagnosticSecrets,
+  sanitizeTileflowInspectableValue,
   serializeTileflowCommandDocument,
   tileflowArtifactInventoryFileName,
   tileflowArtifactPlanSchemaVersion,

package/dist/inspect.d.ts

@@ -143,5 +143,7 @@ declare class TileflowConfigInspectionError extends Error {
     }>;
     constructor(code: string, message: string, path: string);
 }
+/** Sanitize a deterministic JSON-like authoring value for machine-facing CLI output. */
+declare function sanitizeTileflowInspectableValue(value: unknown, cwd: string): unknown;
 
-export { type TileflowConfigInspection, TileflowConfigInspectionError, type TileflowConfigInspectionOptions, type TileflowFeatureInspection, type TileflowFeatureInspectionOptions, type TileflowInspectedFeature, type TileflowInspectedProperty, type TileflowMapLineageInspection, type TileflowMapMergeProvenance, type TileflowResolvedMapInspection, type TileflowThemeContractInspection, type TileflowThemeDifferenceInspection, type TileflowThemeInspection, inspectLoadedTileflowConfig, inspectTileflowConfig, inspectTileflowFeatures };
+export { type TileflowConfigInspection, TileflowConfigInspectionError, type TileflowConfigInspectionOptions, type TileflowFeatureInspection, type TileflowFeatureInspectionOptions, type TileflowInspectedFeature, type TileflowInspectedProperty, type TileflowMapLineageInspection, type TileflowMapMergeProvenance, type TileflowResolvedMapInspection, type TileflowThemeContractInspection, type TileflowThemeDifferenceInspection, type TileflowThemeInspection, inspectLoadedTileflowConfig, inspectTileflowConfig, inspectTileflowFeatures, sanitizeTileflowInspectableValue };

package/dist/inspect.js

@@ -2,15 +2,17 @@ import {
   TileflowConfigInspectionError,
   inspectLoadedTileflowConfig,
   inspectTileflowConfig,
-  inspectTileflowFeatures
-} from "./chunk-ZOYFZ3MT.js";
-import "./chunk-ZRI6PNFL.js";
+  inspectTileflowFeatures,
+  sanitizeTileflowInspectableValue
+} from "./chunk-MKPSQSMX.js";
+import "./chunk-LNCTVFUD.js";
 import "./chunk-KDFTE4Q5.js";
-import "./chunk-BKHIZ7H2.js";
+import "./chunk-6MGFMKG3.js";
 import "./chunk-D4OE4ITL.js";
 export {
   TileflowConfigInspectionError,
   inspectLoadedTileflowConfig,
   inspectTileflowConfig,
-  inspectTileflowFeatures
+  inspectTileflowFeatures,
+  sanitizeTileflowInspectableValue
 };

package/dist/preview.d.ts

@@ -1,7 +1,7 @@
 import { TileflowStyleFontFace, NormalizedTileflowCaptureScene } from '@tileflow/core';
 import { TileflowBuildCatalog } from '@tileflow/core/build';
 
-declare function renderTileflowPreviewHtml(preview: ResolvedTileflowPreview | undefined, basePath: string, initialStatus: unknown, isStreetsPreview: boolean, fontFaces?: readonly TileflowStyleFontFace[]): string;
+declare function renderTileflowPreviewHtml(preview: ResolvedTileflowPreview | undefined, basePath: string, initialStatus: unknown, isSemanticPreview: boolean, fontFaces?: readonly TileflowStyleFontFace[]): string;
 
 type TileflowLandmarkAxisConvention = 'ENU_Z_UP' | 'EUN_Y_UP' | 'EUS_Y_UP';
 type TileflowLandmarkArchive = {

package/dist/preview.js

@@ -5,8 +5,8 @@ import {
   readBoundedTileflowResponse,
   renderTileflowPreviewHtml,
   resolveTileflowPreview
-} from "./chunk-GWUMIHL6.js";
-import "./chunk-BKHIZ7H2.js";
+} from "./chunk-MIGBHCXX.js";
+import "./chunk-6MGFMKG3.js";
 import "./chunk-D4OE4ITL.js";
 export {
   TileflowPreviewSelectionError,

package/dist/server.d.ts

@@ -1,5 +1,5 @@
 import { TileflowArtifactSession, TileflowArtifactSessionState, TileflowArtifactDiagnostic } from './artifacts.js';
-export { TileflowArtifactSessionOptions, createTileflowArtifactDiagnostics, getTileflowAssetBasePath, getTileflowAssetFileName, joinTileflowPublicUrl, normalizeTileflowBasePath, resolveTileflowArtifactPublicUrls, tileflowArtifactSessionSchemaVersion } from './artifacts.js';
+export { TileflowArtifactAcquisition, TileflowArtifactSessionOptions, createTileflowArtifactDiagnostics, getTileflowAssetBasePath, getTileflowAssetFileName, joinTileflowPublicUrl, normalizeTileflowBasePath, resolveTileflowArtifactPublicUrls, tileflowArtifactSessionSchemaVersion } from './artifacts.js';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import '@tileflow/core';
 import '@tileflow/core/build';
@@ -52,6 +52,10 @@ type TileflowDevRequestHandlerOptions = {
     styleBaseUrl?: string;
     theme?: string;
 };
+type TileflowDevRequestHandler = ((request: Request) => Promise<Response>) & {
+    close(): Promise<void>;
+    refresh(): Promise<void>;
+};
 declare function getTileflowStyleSelection(path: string): {
     mapName: string;
     themeName: string;
@@ -65,7 +69,7 @@ declare function isTileflowRequestUrl(url: string | undefined, basePath: string)
 declare function getTileflowRequestPath(url: string | undefined, basePath: string): string | null;
 declare function createTileflowNodeRequest(request: IncomingMessage): Request;
 declare function writeTileflowNodeResponse(response: ServerResponse, tileflowResponse: Response): Promise<void>;
-declare function createTileflowDevRequestHandler(options?: TileflowDevRequestHandlerOptions): (request: Request) => Promise<Response>;
+declare function createTileflowDevRequestHandler(options?: TileflowDevRequestHandlerOptions): TileflowDevRequestHandler;
 declare function createTileflowArtifactStatus(state: TileflowArtifactSessionState): {
     diagnostics?: TileflowArtifactDiagnostic[] | undefined;
     lastGoodGeneration?: number | undefined;
@@ -74,4 +78,4 @@ declare function createTileflowArtifactStatus(state: TileflowArtifactSessionStat
     status: "ready" | "building" | "invalid";
 };
 
-export { TileflowArtifactDiagnostic, TileflowArtifactSession, TileflowArtifactSessionState, type TileflowComparisonMode, type TileflowComparisonOptions, type TileflowComparisonRequestHandler, type TileflowComparisonSide, type TileflowDevRequestHandlerOptions, createTileflowArtifactStatus, createTileflowComparisonRequestHandler, createTileflowDevRequestHandler, createTileflowNodeRequest, getTileflowRequestPath, getTileflowStyleInspectionSelection, getTileflowStyleSelection, isTileflowRequestUrl, tileflowComparisonSchemaVersion, writeTileflowNodeResponse };
+export { TileflowArtifactDiagnostic, TileflowArtifactSession, TileflowArtifactSessionState, type TileflowComparisonMode, type TileflowComparisonOptions, type TileflowComparisonRequestHandler, type TileflowComparisonSide, type TileflowDevRequestHandler, type TileflowDevRequestHandlerOptions, createTileflowArtifactStatus, createTileflowComparisonRequestHandler, createTileflowDevRequestHandler, createTileflowNodeRequest, getTileflowRequestPath, getTileflowStyleInspectionSelection, getTileflowStyleSelection, isTileflowRequestUrl, tileflowComparisonSchemaVersion, writeTileflowNodeResponse };

package/dist/server.js

@@ -9,22 +9,23 @@ import {
   isTileflowRequestUrl,
   tileflowComparisonSchemaVersion,
   writeTileflowNodeResponse
-} from "./chunk-OEABXOJH.js";
+} from "./chunk-KH7CMHT3.js";
 import {
   createTileflowArtifactDiagnostics,
   tileflowArtifactSessionSchemaVersion
-} from "./chunk-O7PE6FB2.js";
+} from "./chunk-XTRHREXO.js";
+import "./chunk-ONYQNLNA.js";
 import {
   getTileflowAssetBasePath,
   getTileflowAssetFileName,
   joinTileflowPublicUrl,
   normalizeTileflowBasePath,
   resolveTileflowArtifactPublicUrls
-} from "./chunk-VEB43KDS.js";
-import "./chunk-BALG4DSG.js";
+} from "./chunk-RSBV4L2Y.js";
+import "./chunk-CENQR5Q2.js";
 import "./chunk-BL3FK4GO.js";
 import "./chunk-KDFTE4Q5.js";
-import "./chunk-BKHIZ7H2.js";
+import "./chunk-6MGFMKG3.js";
 import "./chunk-D4OE4ITL.js";
 export {
   createTileflowArtifactDiagnostics,

package/dist/tilesets-C0tGeenP.d.ts

@@ -0,0 +1,94 @@
+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[];
+}>;
+type TileflowLocalTilesetInspection = Readonly<{
+    contract: Pick<TileflowTilesetInspectionV1['contract'], 'sourceLayers' | 'sourceLayersDeclared' | 'tileType'>;
+    warnings: readonly TileflowTilesetInspectionWarning[];
+}>;
+declare function inspectTileflowPmtilesForLocalUse(archivePath: string): Promise<TileflowLocalTilesetInspection>;
+declare function inspectTileflowPmtiles(archivePath: string, options?: {
+    includeValues?: readonly string[];
+    maximumDirectoryDepth?: number;
+    sample?: boolean;
+    signal?: AbortSignal;
+}): Promise<TileflowTilesetInspectionV1>;
+
+export { type TileflowLocalTilesetInspection as T, type TileflowTilesetInspectionV1 as a, type TileflowTilesetInspectionWarning as b, inspectTileflowPmtilesForLocalUse as c, inspectTileflowPmtiles as i };

package/dist/tilesets.d.ts

@@ -0,0 +1 @@
+export { a as TileflowTilesetInspectionV1, b as TileflowTilesetInspectionWarning, i as inspectTileflowPmtiles } from './tilesets-C0tGeenP.js';

package/dist/tilesets.js

@@ -0,0 +1,6 @@
+import {
+  inspectTileflowPmtiles
+} from "./chunk-ONYQNLNA.js";
+export {
+  inspectTileflowPmtiles
+};

package/dist/validation.d.ts

@@ -1,5 +1,7 @@
 import { MapLibreStyle } from '@tileflow/core';
 
+declare function sanitizeDiagnosticSecrets(value: string): string;
+
 type TileflowStyleValidationIssue = {
     map: string;
     message: string;
@@ -20,7 +22,11 @@ type TileflowDiagnosticSeverity = 'error' | 'info' | 'warning';
 type TileflowStructuredDiagnostic = {
     phase: string;
     code: string;
+    /** Semantic compiler domain. Legacy `owner` inputs are normalized to this field. */
+    domain?: string;
     path: string;
+    /** Semantic compiler target, when the diagnostic applies to one render contribution. */
+    target?: string;
     severity: TileflowDiagnosticSeverity;
     message: string;
     suggestion: string;
@@ -54,4 +60,4 @@ declare function createTileflowStructuredDiagnostics(error: unknown, cwd: string
 declare function createTileflowCommandFailureDocument(command: string, error: unknown, cwd: string, defaults: TileflowDiagnosticDefaults): TileflowCommandFailureDocument;
 declare function serializeTileflowCommandDocument(value: unknown): string;
 
-export { type TileflowCommandFailureDocument, type TileflowCommandSummary, type TileflowDiagnosticSeverity, type TileflowStructuredDiagnostic, TileflowStyleValidationError, type TileflowStyleValidationIssue, assertValidTileflowStyle, createTileflowCommandFailureDocument, createTileflowCommandSummary, createTileflowStructuredDiagnostics, serializeTileflowCommandDocument, tileflowCommandDocumentSchemaVersion, validateTileflowStyle };
+export { type TileflowCommandFailureDocument, type TileflowCommandSummary, type TileflowDiagnosticSeverity, type TileflowStructuredDiagnostic, TileflowStyleValidationError, type TileflowStyleValidationIssue, assertValidTileflowStyle, createTileflowCommandFailureDocument, createTileflowCommandSummary, createTileflowStructuredDiagnostics, sanitizeDiagnosticSecrets, serializeTileflowCommandDocument, tileflowCommandDocumentSchemaVersion, validateTileflowStyle };

package/dist/validation.js

@@ -4,10 +4,11 @@ import {
   createTileflowStructuredDiagnostics,
   serializeTileflowCommandDocument,
   tileflowCommandDocumentSchemaVersion
-} from "./chunk-ZRI6PNFL.js";
+} from "./chunk-LNCTVFUD.js";
 import {
   TileflowStyleValidationError,
   assertValidTileflowStyle,
+  sanitizeDiagnosticSecrets,
   validateTileflowStyle
 } from "./chunk-KDFTE4Q5.js";
 export {
@@ -16,6 +17,7 @@ export {
   createTileflowCommandFailureDocument,
   createTileflowCommandSummary,
   createTileflowStructuredDiagnostics,
+  sanitizeDiagnosticSecrets,
   serializeTileflowCommandDocument,
   tileflowCommandDocumentSchemaVersion,
   validateTileflowStyle

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/dev",
-  "version": "0.1.0-alpha.19",
+  "version": "0.1.0-alpha.20",
   "license": "Apache-2.0",
   "description": "Node development utilities for Tileflow configs and builds.",
   "type": "module",
@@ -75,6 +75,11 @@
       "import": "./dist/server.js",
       "default": "./dist/server.js"
     },
+    "./tilesets": {
+      "types": "./dist/tilesets.d.ts",
+      "import": "./dist/tilesets.js",
+      "default": "./dist/tilesets.js"
+    },
     "./validation": {
       "types": "./dist/validation.d.ts",
       "import": "./dist/validation.js",
@@ -87,7 +92,7 @@
   "dependencies": {
     "@mapbox/vector-tile": "2.0.5",
     "@maplibre/maplibre-gl-style-spec": "24.8.5",
-    "@tileflow/core": ">=0.1.0-alpha.21 <0.1.0-beta.0",
+    "@tileflow/core": ">=0.1.0-alpha.22 <0.1.0-beta.0",
     "chokidar": "4.0.3",
     "fflate": "0.8.2",
     "fontkit": "2.0.4",
@@ -99,13 +104,13 @@
     "three": "0.180.0"
   },
   "devDependencies": {
-    "@tileflow/maps": "0.1.0-alpha.0"
+    "@tileflow/maps": "0.1.0-alpha.1"
   },
   "optionalDependencies": {
     "sharp": "0.35.3"
   },
   "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/validation.ts --format esm --dts --clean --platform node --external sharp",
+    "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",
     "test": "tsx --test test/*.test.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint": "tsc -p tsconfig.json --noEmit",