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

package/README.md

@@ -2,7 +2,7 @@
 
 Node utilities used by the Tileflow CLI and build integrations.
 
-Most apps should use `@tileflow/cli`, `@tileflow/vite`, or `@tileflow/next` directly. Use this
+Most apps should use `tileflow`, `@tileflow/vite`, or `@tileflow/next` directly. Use this
 package when you are building a custom dev server, bundler plugin, or deployment adapter that needs
 to load and compile the single map exported by `tileflow.config.ts`.
 
@@ -12,6 +12,12 @@ import {createTileflowBuildArtifacts} from '@tileflow/dev/artifacts';
 const artifacts = await createTileflowBuildArtifacts({
   config: 'tileflow.config.ts',
 });
+
+try {
+  // Serve, capture, or write this exact generation.
+} finally {
+  await artifacts.dispose?.();
+}
 ```
 
 The integration surfaces are deliberately split: use `@tileflow/dev/artifacts` for source
@@ -31,14 +37,25 @@ point to content-addressed `generations/<sha256>/...` theme styles and sprites;
 installed before the manifest pointer changes. Stable style paths are
 `styles/<map>/<theme>.json`; every manifest lookup resolves a concrete theme. The disk writer also stages the complete plan,
 records a managed-file inventory, rolls back caught filesystem failures, and removes only stale
-files named by its previous valid inventory. It retains the immediately preceding immutable
-generation during each replacement, so a client that already read the old manifest can finish its
-style and sprite requests; the next replacement retires that older generation. Stable `styles/`
-and `icons/` paths remain available, but generation-consistent consumers
-resolve maps through `manifest.json`.
+files named by its previous valid inventory. Stable `styles/` and `icons/` paths remain available,
+but generation-consistent consumers resolve maps through `manifest.json`.
+
+A local `hostedTileset()` path remains user-owned input. Dev performs bounded header, root-directory,
+and metadata checks, then creates an opaque immutable snapshot under
+`.tileflow/cache/pmtiles-snapshots/v1/`, using copy-on-write cloning when available and a safe copy
+otherwise. It does not hash the complete archive or traverse every leaf directory. Dev and Capture
+read only that snapshot. The current generation and already-started operations retain references;
+a replaced generation accepts no new acquisitions and is collected after its last operation.
+The Style-facing path remains `tilesets/<logical-id>.pmtiles` across generations; physical snapshot
+identity stays out of Style JSON. Generation ETags make cached PMTiles reads restart instead of
+mixing ranges when current changes. Invalid edits keep the prior valid generation. Production
+writers reject unresolved local PMTiles instead of copying, content-addressing, deduplicating, or
+retaining them. Explicit `tileset publish` owns managed publication and exhaustive validation.
+Startup removes snapshot generations owned by dead processes, and symlinked snapshot-store
+boundaries are rejected.
 
 Every plan also emits canonical `build-manifest.json` (schema version 1). For each map it records
-the leaf `mapVersion`, resolved lineage, effective icon/font source identities, Recipe ABI, and
+the leaf `mapVersion`, resolved lineage, effective icon/font source identities, semantic compiler ABI, and
 one entry per concrete theme with `colorScheme`, identity, inferred legacy `dataRequirements`,
 multi-source `sourceRequirements`, and `styleSha256`. The multi-source contract records each
 referenced vector source independently and records raster DEM source ID, encoding, and tile size;
@@ -46,17 +63,17 @@ it therefore distinguishes Bathymetry vector bands from optional relief without
 fields. `mapRevisionSha256` identifies the effective cartographic definition after `extends`;
 `assetSetSha256` for that map's generated runtime resources. Data requirements are derived from the
 final Style layers and fields rather than copied from a manually maintained allowlist, so disabled
-or overridden modules do not claim data they no longer use. The Recipe ABI remains a separate
-`recipe: {compiler, compilerVersion}` compatibility axis.
+or overridden modules do not claim data they no longer use. Maps use the single implicit semantic
+compiler; its ABI remains a separate `semanticCompiler: {name, version}` build-manifest axis.
 
 The map revision is versioned and domain-separated. It contains the resolved cartographic design,
-the compiler family, private effective module contributions, and effective icon/font source
-identities. Map `id`, `name`, editorial `mapVersion`, default `view`, capture `scenes`, delivery
-policy, package SemVer, compiler ABI, local paths, timestamps, generated sprite/font output, and a
+semantic language version, effective public module/render-stack design, and effective icon/font
+identities. Map `id`, `name`, editorial `mapVersion`, default `view`, capture `scenes`, package
+SemVer, compiler ABI, local paths, timestamps, generated sprite/font output, and a
 concrete resolution of a floating World selector are deliberately outside it. Changing a shadowed
 ancestor does not change the revision; changing an effective cartographic override or source asset
-does. Lineage and the leaf `mapVersion` remain beside the hash for traceability, Style JSON owns its
-compiled-output identity, and Hosted delivery policy belongs to the deployment fingerprint. The
+does. Lineage and the leaf `mapVersion` remain beside the hash for traceability, and Style JSON owns
+its compiled-output identity. Hosted browser policy is managed outside repository artifacts. The
 top-level `provenance` block records the exact participating Tileflow package versions and the
 nearest package-manager lockfile's format and content hash, without embedding its local path;
 provenance remains outside every map revision. The same portable block is available to Hosted
@@ -90,6 +107,11 @@ unsubscribe();
 await session.close();
 ```
 
+`getState()` and `getLastGoodArtifacts()` are borrowed synchronous views. Before starting async
+work, call `session.acquireArtifacts(generation?)` and release the returned acquisition in `finally`.
+A replacement stops new acquisitions of the old generation and deletes its snapshot after the last
+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
@@ -107,8 +129,13 @@ const fetch = createTileflowDevRequestHandler({
   session,
   scene: 'madrid-mobile',
 });
+
+// On server shutdown:
+await Promise.all([fetch.close(), session.close()]);
 ```
 
+The handler does not close a caller-owned session.
+
 Map preview uses the exported map's `view` and accepts one concrete `theme`; scene preview uses its
 committed concrete theme, camera, and CSS viewport metadata from that same map. A scene does not
 repeat the map ID because its owner is implicit.
@@ -175,18 +202,10 @@ pipeline. After inheritance resolves, a map with any text layer must have exactl
 produced by the style's `text-font` arrays.
 
 The resulting style records strict `tileflow:fontFaces` metadata. Preview, capture, and browser
-framework adapters load those generic definitions before constructing MapLibre. Hosted preparation
-also emits one canonical `tileflow-font-bundle-v1` closure containing only selected faces and their
-license bytes. Its manifest SHA-256 is the sole content identity; Hosted adds an opaque project-owned
-storage ID. Deploy uploads that bundle before the Style and then replaces provisional sources with
-the exact immutable ID URLs confirmed by Hosted. A derived map that declares `glyphs` replaces the
-inherited local provider atomically; the URL-backed map is complete as declared and independent of
-its World selection.
-
-That upload and binding contract is implemented, but it is not by itself a production-availability
-promise. The matching Hosted rollout candidate adds DB-backed project ownership, organization quota,
-durable deployment references, grace-based garbage collection, and deletion receipts; availability
-still requires that matching migration, API, and SDK pair to be promoted together.
+framework adapters load those definitions before constructing MapLibre. Hosted deploy rejects a
+prepared local-font bundle before authentication until managed font storage is available. A derived
+map that declares `glyphs` replaces the inherited local provider atomically; the URL-backed map is
+complete as declared and independent of its World selection.
 
 For Streets styles whose vegetation layer declares `tileflow:vegetation-mode = 3d`, the built-in
 preview uses the same portable circle fallback as capture and the published framework adapters by
@@ -361,13 +380,14 @@ export default defineMap({
 Directories apply left to right. `<id>.<ext>` publishes an icon as `<id>`;
 `<id>.pattern.<ext>` publishes the intrinsic-size pattern as `<id>`. The published ID must already
 be canonical lower-kebab-case. A later file replaces an earlier file only for the same exact ID;
-case-only collisions fail. Package maps export `streetsIcons`, `ferrarisIcons`,
-`haradIcons`, `siegfriedIcons`, `soundingsIcons`, `cyberpunkIcons`, `matrixIcons`, and `verdantIcons`
-directory descriptors from `@tileflow/maps`. Cyberpunk, Matrix, and Siegfried also export
-`cyberpunkFonts`, `matrixFonts`, and `siegfriedFonts`. Preparation resolves package descriptors inside their owning
-package, checks real-path containment, and compiles them through the same pipeline as a
-config-relative directory. There are no built-in/source/sprite selectors, mappings, icon-specific
-inheritance, or compatibility aliases.
+case-only collisions fail. Package maps export `streetsIcons`, `baedekerIcons`, `ferrarisIcons`,
+`haradIcons`, `siegfriedIcons`, `soundingsIcons`, `cyberpunkIcons`, `matrixIcons`, and
+`verdantIcons`, and `sanFrancistoIcons` directory descriptors from `@tileflow/maps`. Cyberpunk,
+Matrix, Baedeker, and Siegfried also export `cyberpunkFonts`, `matrixFonts`, `baedekerFonts`, and
+`siegfriedFonts`. Preparation
+resolves package descriptors inside their owning package, checks real-path containment, and
+compiles them through the same pipeline as a config-relative directory. There are no
+built-in/source/sprite selectors, mappings, icon-specific inheritance, or compatibility aliases.
 
 Local directories resolve from the directory containing the selected `tileflow.config.ts`, while
 the workspace `cwd` remains their containment boundary. Canonical local syntax starts with `./` or
@@ -401,9 +421,9 @@ try {
 The inspection resolves one config load into sorted maps, root-to-leaf lineage, declared paths, and
 leaf-level merge provenance. Its `themeContract` exposes the default/system mapping, shared token
 schema, concrete resolved token values, typography and lighting, differences from the default, and
-stable `THEME_IMPLICIT_FIXED` diagnostics across modules, terrain, and compiler-owned effects. Each
-diagnostic carries a semantic scope and, for compiler effects, its owner, target, and effect kind,
-plus machine-readable severity and remediation. Colors, fonts, and images are followed through
+stable `THEME_IMPLICIT_FIXED` diagnostics across modules, render stacks, and terrain. Each
+diagnostic carries a semantic scope and, for module values, its owner, plus machine-readable
+severity and remediation. Colors, fonts, and images are followed through
 expression outputs; numeric diagnostics intentionally cover only direct visual scalars, excluding
 expression operands, zoom stops, tuples, placement, priority, and other structural numbers.
 Agents can therefore edit semantic roles without
@@ -412,6 +432,26 @@ URL queries, data URLs, or recognized secret formats. Structured summaries and d
 same required schema-version-1 fields and bounded safe suggestions so consumers do not need to
 parse human prose.
 
+## Bounded PMTiles resource inspection
+
+Node tooling can inspect one local PMTiles archive without reading it completely:
+
+```ts
+import {inspectTileflowPmtiles} from '@tileflow/dev/tilesets';
+
+const inspection = await inspectTileflowPmtiles('./data/stores.pmtiles', {
+  includeValues: ['category', 'status'],
+});
+```
+
+Inspection schema 1 separates the authoritative PMTiles header and TileJSON `vector_layers` metadata
+from deterministic bounded MVT observations. Each sampled field reports present/missing feature
+counts, observed primitive types, capped distinct-value cardinality, numeric min/max, and explicit
+truncation. Values are returned only for requested portable field names, with at most 32 requested
+fields, 16 values per field, and 256 characters per string. Sampling reads at most eight tiles,
+20,000 features, or 24 MB of tile data; `sample: false` returns only authoritative metadata and does
+not accept `includeValues`.
+
 ## Bounded vector-feature inspection
 
 Custom Node tooling can inspect only the features visible near a configured camera without opening
@@ -452,14 +492,18 @@ 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]`. Ferraris, Härad,
-Siegfried, Soundings, and Verdant declare only `[ferrarisIcons]`, `[haradIcons]`, `[siegfriedIcons]`,
-`[soundingsIcons]`, and `[verdantIcons]`, respectively. No official root composes another map's
-assets even though all use the semantic Streets compiler ABI. Härad's directory contains nine original Tileflow
-patterns inspired by Lantmäteriet's CC0 Häradsekonomiska kartan series from 1859–1934. Soundings owns ten
-original nautical symbols and patterns. An application map may inherit a root's exact array,
-replace it, clear it with `[]`, or
-compose it explicitly with a spread.
+Cyberpunk and Matrix independently declare `[cyberpunkIcons]` and `[matrixIcons]`. Baedeker,
+Ferraris, Härad, Siegfried, Soundings, Verdant, and San Francisto declare only `[baedekerIcons]`,
+`[ferrarisIcons]`, `[haradIcons]`, `[siegfriedIcons]`, `[soundingsIcons]`, `[verdantIcons]`, and
+`[sanFrancistoIcons]`, 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
+Häradsekonomiska kartan series from 1859–1934. Soundings owns ten original nautical symbols and
+patterns. San Francisto owns four technical blueprint patterns and one schematic POI node; its
+unbundled Mapterhorn contours remain runtime terrain, and its text uses the canonical Noto Sans
+glyph provider. An application map may inherit a root's exact array, replace it, clear it with `[]`,
+or compose it explicitly with a spread.
 `modules.poi.icons: false` or a disabled POI module suppresses POI icon layers without moving asset
 ownership into dev. POI density is the numeric producer threshold 1–5; it is not an asset-provider
 preset.

package/dist/artifacts.d.ts

@@ -1,9 +1,27 @@
 import { TileflowStyleOptions, MapLibreStyle } from '@tileflow/core';
-import { TileflowMapBuildManifestV1, TileflowBuildCatalog, TileflowStyleInspection, TileflowBuildStyles, TileflowMapBuildProvenanceV1, TileflowPreparedMapAssets } from '@tileflow/core/build';
+import { TileflowBuildCatalog, TileflowBuildStyles, TileflowMapBuildManifestV1, TileflowStyleInspection, TileflowMapBuildProvenanceV1, TileflowPreparedMapAssets } from '@tileflow/core/build';
 import { TileflowRuntimeManifest } from '@tileflow/core/manifest';
 import { TileflowBuildAsset, PreparedTileflowBuildCatalog, TileflowSourceCatalog, PreparedTileflowCatalog } from './icons.js';
 export { defaultTileflowConfigPath } from './config.js';
 
+type TileflowLocalTilesetFile = Readonly<{
+    byteLength: number;
+    etag: string;
+    fileName: string;
+    logicalId: string;
+    sourcePath: string;
+}>;
+declare function prepareTileflowLocalTilesets(project: TileflowBuildCatalog, styles: TileflowBuildStyles, options: {
+    assetBaseUrl: string;
+    baseDirectory: string;
+    cwd: string;
+}): Promise<{
+    dispose(): Promise<void>;
+    files: TileflowLocalTilesetFile[];
+    styles: TileflowBuildStyles;
+    watchPaths: string[];
+}>;
+
 declare const tileflowArtifactSessionSchemaVersion: 1;
 type TileflowArtifactDiagnostic = {
     code?: string;
@@ -31,9 +49,18 @@ type TileflowArtifactSessionOptions = TileflowBuildArtifactsOptions & {
     ignoredPaths?: string[];
     watch?: boolean;
 };
+type TileflowArtifactAcquisition = Readonly<{
+    artifacts: TileflowBuildArtifacts;
+    generation: number;
+    release(): Promise<void>;
+}>;
 type TileflowArtifactSession = {
+    /** Pins the current generation for asynchronous work; the caller must release it. */
+    acquireArtifacts(generation?: number): TileflowArtifactAcquisition | undefined;
     close(): Promise<void>;
+    /** Borrowed synchronous view. Use acquireArtifacts() before retaining it across an await. */
     getLastGoodArtifacts(): TileflowBuildArtifacts | undefined;
+    /** Ready-state artifacts are a borrowed synchronous view. */
     getState(): TileflowArtifactSessionState;
     refresh(reason?: string): Promise<void>;
     subscribe(listener: (state: TileflowArtifactSessionState) => void): () => void;
@@ -74,14 +101,20 @@ type TileflowBuildArtifactsOptions = {
     /** Build a memory-only compiler sidecar for local authoring tools. */
     inspection?: boolean;
     styleBaseUrl?: string;
+    /** Local tools may snapshot local PMTiles; production output must resolve them explicitly. */
+    target?: 'local' | 'production';
 };
 type TileflowBuildStyleInspections = Record<string, Record<string, TileflowStyleInspection>>;
 /** Compatibility shape consumed by sessions and capture callers. */
 type TileflowBuildArtifacts = {
     assets: TileflowBuildAsset[];
     buildManifest: TileflowMapBuildManifestV1;
+    /** Releases local immutable snapshot references owned by this artifact generation. */
+    dispose?: () => Promise<void>;
     manifest: TileflowRuntimeManifest;
     project: TileflowBuildCatalog;
+    /** Local-only archive ports. Paths never enter serialized build artifacts. */
+    localTilesets?: TileflowLocalTilesetFile[];
     /** Optional local-only provenance. It is never serialized as a build artifact. */
     styleInspections?: TileflowBuildStyleInspections;
     styles: TileflowBuildStyles;
@@ -105,7 +138,7 @@ type TileflowArtifactPlan = TileflowBuildArtifacts & {
     schemaVersion: typeof tileflowArtifactPlanSchemaVersion;
     sourceProject: TileflowSourceCatalog;
 };
-type CreateTileflowArtifactPlanOptions = Pick<TileflowBuildArtifactsOptions, 'apiBaseUrl' | 'assetBaseUrl' | 'inspection' | 'styleBaseUrl'> & {
+type CreateTileflowArtifactPlanOptions = Pick<TileflowBuildArtifactsOptions, 'apiBaseUrl' | 'assetBaseUrl' | 'inspection' | 'styleBaseUrl' | 'target'> & {
     inputFiles?: readonly string[];
 };
 type WriteTileflowArtifactPlanOptions = {
@@ -119,6 +152,10 @@ declare class TileflowHostedManifestOverwriteError extends Error {
     readonly code: "HOSTED_MANIFEST_OVERWRITE_REFUSED";
     constructor(path: string);
 }
+declare class TileflowLocalTilesetProductionError extends Error {
+    readonly code: "TF_LOCAL_TILESET_PRODUCTION_UNRESOLVED";
+    constructor();
+}
 declare function createTileflowManifest(project: TileflowBuildCatalog, options?: TileflowManifestOptions): TileflowRuntimeManifest;
 declare function createTileflowStyle(project: TileflowBuildCatalog, mapName: string, options?: TileflowStyleOptions): MapLibreStyle;
 declare function createTileflowStyles(project: TileflowBuildCatalog, options?: Omit<TileflowStyleOptions, 'preparedAssets' | 'theme'> & {
@@ -139,14 +176,16 @@ declare function refreshTileflowArtifactSession(session: TileflowArtifactSession
     reason: string;
 }): Promise<boolean>;
 declare function writeTileflowBuildArtifacts(options: WriteTileflowBuildArtifactsOptions): Promise<TileflowArtifactPlan>;
+declare function disposeTileflowBuildArtifacts(artifacts: Pick<TileflowBuildArtifacts, 'dispose'>): Promise<void>;
 /**
  * Replaces one managed artifact generation and records its exact file inventory. Unmanaged files
  * are never scanned or removed. A caught filesystem failure restores every previous managed file.
  */
 declare function writeTileflowArtifactPlan(artifacts: TileflowArtifactPlan, options: WriteTileflowArtifactPlanOptions): Promise<void>;
+declare function assertNoLocalTilesetsForProduction(artifacts: Pick<TileflowBuildArtifacts, 'localTilesets'>): void;
 /** Prevents a framework build from silently replacing the frontend's Hosted delivery contract. */
 declare function assertTileflowSelfHostedManifestTarget(manifestPath: string, options?: {
     overwriteHostedManifest?: boolean;
 }): Promise<void>;
 
-export { type CreateTileflowArtifactPlanOptions, PreparedTileflowBuildCatalog, PreparedTileflowCatalog, type TileflowArtifactDiagnostic, type TileflowArtifactFile, type TileflowArtifactInputGraph, type TileflowArtifactPlan, type TileflowArtifactSession, type TileflowArtifactSessionOptions, type TileflowArtifactSessionState, type TileflowBuildArtifacts, type TileflowBuildArtifactsOptions, TileflowBuildAsset, type TileflowBuildStyleInspections, TileflowHostedManifestOverwriteError, type TileflowManifestOptions, TileflowSourceCatalog, type WriteTileflowArtifactPlanOptions, type WriteTileflowBuildArtifactsOptions, assertTileflowSelfHostedManifestTarget, createTileflowArtifactDiagnostics, createTileflowArtifactPlan, createTileflowArtifactSession, createTileflowBuildArtifacts, createTileflowBuildProvenance, createTileflowManifest, createTileflowStyle, createTileflowStyles, getTileflowArtifactFiles, getTileflowAssetBasePath, getTileflowAssetFileName, getTileflowWatchPaths, isTileflowArtifactInputPath, joinTileflowPublicUrl, normalizeTileflowBasePath, refreshTileflowArtifactSession, resolveTileflowArtifactPublicUrls, tileflowArtifactInventoryFileName, tileflowArtifactPlanSchemaVersion, tileflowArtifactSessionSchemaVersion, writeTileflowArtifactPlan, writeTileflowBuildArtifacts };
+export { type CreateTileflowArtifactPlanOptions, PreparedTileflowBuildCatalog, PreparedTileflowCatalog, type TileflowArtifactAcquisition, type TileflowArtifactDiagnostic, type TileflowArtifactFile, type TileflowArtifactInputGraph, type TileflowArtifactPlan, type TileflowArtifactSession, type TileflowArtifactSessionOptions, type TileflowArtifactSessionState, type TileflowBuildArtifacts, type TileflowBuildArtifactsOptions, TileflowBuildAsset, type TileflowBuildStyleInspections, TileflowHostedManifestOverwriteError, type TileflowLocalTilesetFile, TileflowLocalTilesetProductionError, type TileflowManifestOptions, TileflowSourceCatalog, type WriteTileflowArtifactPlanOptions, type 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 };

package/dist/artifacts.js

@@ -1,5 +1,7 @@
 import {
   TileflowHostedManifestOverwriteError,
+  TileflowLocalTilesetProductionError,
+  assertNoLocalTilesetsForProduction,
   assertTileflowSelfHostedManifestTarget,
   createTileflowArtifactDiagnostics,
   createTileflowArtifactPlan,
@@ -9,32 +11,37 @@ import {
   createTileflowManifest,
   createTileflowStyle,
   createTileflowStyles,
+  disposeTileflowBuildArtifacts,
   getTileflowArtifactFiles,
   getTileflowWatchPaths,
   isTileflowArtifactInputPath,
+  prepareTileflowLocalTilesets,
   refreshTileflowArtifactSession,
   tileflowArtifactInventoryFileName,
   tileflowArtifactPlanSchemaVersion,
   tileflowArtifactSessionSchemaVersion,
   writeTileflowArtifactPlan,
   writeTileflowBuildArtifacts
-} 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 {
   defaultTileflowConfigPath
-} from "./chunk-BKHIZ7H2.js";
+} from "./chunk-6MGFMKG3.js";
 import "./chunk-D4OE4ITL.js";
 export {
   TileflowHostedManifestOverwriteError,
+  TileflowLocalTilesetProductionError,
+  assertNoLocalTilesetsForProduction,
   assertTileflowSelfHostedManifestTarget,
   createTileflowArtifactDiagnostics,
   createTileflowArtifactPlan,
@@ -45,6 +52,7 @@ export {
   createTileflowStyle,
   createTileflowStyles,
   defaultTileflowConfigPath,
+  disposeTileflowBuildArtifacts,
   getTileflowArtifactFiles,
   getTileflowAssetBasePath,
   getTileflowAssetFileName,
@@ -52,6 +60,7 @@ export {
   isTileflowArtifactInputPath,
   joinTileflowPublicUrl,
   normalizeTileflowBasePath,
+  prepareTileflowLocalTilesets,
   refreshTileflowArtifactSession,
   resolveTileflowArtifactPublicUrls,
   tileflowArtifactInventoryFileName,

package/dist/{chunk-BKHIZ7H2.js → chunk-6MGFMKG3.js}

@@ -8,6 +8,7 @@ import { existsSync, realpathSync } from "fs";
 import { createRequire } from "module";
 import { dirname, resolve, sep } from "path";
 import {
+  parseResolvedTileflowMap,
   parseTileflowMap,
   tileflowCaptureSceneNameSchema,
   TileflowResolvedMapValidationError
@@ -66,7 +67,7 @@ function assertValidTileflowConfig(project) {
   const messages = [];
   for (const [mapId, map] of Object.entries(project.maps)) {
     try {
-      parseTileflowMap(map);
+      parseResolvedTileflowMap(map);
     } catch (error) {
       messages.push({
         level: "error",
@@ -139,10 +140,7 @@ function asTileflowBuildCatalog(input, options = {}) {
     }
     return {
       mapMetadata: Object.fromEntries(
-        entries.map(([id, map2, lineage]) => [
-          id,
-          { id, lineage, root: map2.root, version: map2.version }
-        ])
+        entries.map(([id, map2, lineage]) => [id, { id, lineage, version: map2.version }])
       ),
       maps: Object.fromEntries(entries.map(([id, map2]) => [id, map2])),
       ...scenes2.size > 0 ? { scenes: Object.fromEntries(scenes2) } : {}
@@ -161,7 +159,6 @@ function asTileflowBuildCatalog(input, options = {}) {
       [resolved.id]: {
         id: resolved.id,
         lineage: collectTileflowMapBuildLineage(map),
-        root: resolved.root,
         version: resolved.version
       }
     },

package/dist/{chunk-BALG4DSG.js → chunk-CENQR5Q2.js}

@@ -11,7 +11,7 @@ import {
   compareCodeUnits,
   hashTileflowIconPackageManifest,
   hashTileflowRenderedIconPixels,
-  parseTileflowMap,
+  parseResolvedTileflowMap,
   serializeCanonicalJson,
   sha256Hex,
   tileflowIconIdPattern,
@@ -237,7 +237,7 @@ async function getMapIconRequests(project, cwd, baseDirectory, target, mapNames)
   for (const mapName of selectedNames) {
     const mapConfig = project.maps[mapName];
     if (!mapConfig) throw new Error(`Unknown Tileflow map: ${mapName}`);
-    const resolvedMap = parseTileflowMap(mapConfig);
+    const resolvedMap = parseResolvedTileflowMap(mapConfig);
     try {
       const directories = await resolveTileflowAssetDirectories(resolvedMap.icons ?? [], {
         baseDirectory,