@tileflow/dev 0.1.0-alpha.25 → 0.1.0-alpha.27

package/dist/{chunk-3WCEHA27.js → chunk-UCBGTEQV.js}

@@ -1,7 +1,7 @@
 import {
   createTileflowArtifactSession,
   tileflowArtifactSessionSchemaVersion
-} from "./chunk-W3X2JXYS.js";
+} from "./chunk-QAMFAM3S.js";
 import {
   normalizeTileflowBasePath
 } from "./chunk-UTRO4IBQ.js";

package/dist/{chunk-LNCTVFUD.js → chunk-XHJBCVBB.js}

@@ -6,6 +6,7 @@ import {
 import { realpathSync } from "fs";
 import { isAbsolute, relative, resolve, sep, win32 } from "path";
 import { compareCodeUnits } from "@tileflow/core";
+import { TileflowNativeCompatibilityError } from "@tileflow/core/native-profile";
 var tileflowCommandDocumentSchemaVersion = 1;
 function createTileflowCommandSummary(input) {
   return {
@@ -21,6 +22,9 @@ function createTileflowCommandSummary(input) {
   };
 }
 function createTileflowStructuredDiagnostics(error, cwd, defaults) {
+  if (error instanceof TileflowNativeCompatibilityError) {
+    return error.issues.map((issue) => ({ ...issue }));
+  }
   const inheritedCode = optionalField(error, "code");
   const inheritedDomain = optionalField(error, "domain") ?? optionalField(error, "owner") ?? optionalNestedField(error, "domain") ?? optionalNestedField(error, "owner");
   const inheritedLevel = optionalField(error, "level") ?? optionalNestedField(error, "level");
@@ -85,7 +89,8 @@ function createTileflowCommandFailureDocument(command, error, cwd, defaults) {
     severity: primary.severity,
     message: primary.message,
     suggestion: primary.suggestion,
-    diagnostics
+    diagnostics,
+    ...primary.renderer ? { renderer: primary.renderer, profile: primary.profile } : {}
   };
 }
 function serializeTileflowCommandDocument(value) {

package/dist/icons.d.ts

@@ -1,4 +1,4 @@
-import { TileflowIconSetPin, TileflowIconSource, TileflowIconsLockfileV1, TileflowIconCompositionV1, TileflowIconPackageFileName, TileflowIconPackageManifest, TileflowIconDirectory } from '@tileflow/core';
+import { TileflowIconAppearance, TileflowIconLayoutMetadata, TileflowIconSetPin, TileflowIconSpriteIndex, TileflowIconSource, TileflowIconsLockfileV1, TileflowIconCompositionV1, TileflowIconPackageFileName, TileflowIconPackageManifest, TileflowIconDirectory } from '@tileflow/core';
 import { TileflowEffectiveIconSourceIdentity, TileflowBuildCatalog, TileflowPreparedMapAssets } from '@tileflow/core/build';
 
 type TileflowRenderedIconCell = {
@@ -8,6 +8,8 @@ type TileflowRenderedIconCell = {
 };
 type TileflowRenderedIcon = {
     id: string;
+    appearance?: TileflowIconAppearance;
+    layout?: TileflowIconLayoutMetadata;
     oneX: TileflowRenderedIconCell;
     twoX: TileflowRenderedIconCell;
 };
@@ -36,6 +38,9 @@ declare function loadTileflowIconSetArtifact(input: TileflowIconSetPin, options?
 /** Seed or repair a disposable cache using verified generated bytes, never original artwork. */
 declare function storeTileflowIconSetArtifact(input: TileflowIconSetPin, artifact: CompiledTileflowIconPackage, options?: Pick<TileflowIconCacheOptions, 'cacheRoot'>): Promise<VerifiedTileflowIconArtifact>;
 
+/** Render a report image without changing the immutable generated sprite. */
+declare function renderTileflowIconAtlasPreview(source: Uint8Array, index: TileflowIconSpriteIndex): Promise<Uint8Array>;
+
 /**
  * Read the exact current lock bytes for a compare-and-swap update.
  *
@@ -150,6 +155,7 @@ type CompiledTileflowIconPackage = {
     manifest: TileflowIconPackageManifest;
 };
 type TileflowMapIconPackageBinding = {
+    appearances?: Record<string, TileflowIconAppearance>;
     iconIds: readonly string[];
     label: string;
     mapName: string;
@@ -210,6 +216,8 @@ type TileflowIconCatalogIconSource = {
     version: number;
 };
 type TileflowIconCatalogIcon = {
+    appearance?: TileflowIconAppearance;
+    layout?: TileflowIconLayoutMetadata;
     id: string;
     rendered: {
         oneX: TileflowIconCatalogRenderedDensity;
@@ -326,4 +334,4 @@ declare function readTileflowIconDirectory(source: TileflowIconDirectory, option
     target: TileflowIconCompilationTarget;
 }): Promise<ReadTileflowIconDirectoryResult>;
 
-export { type CompileTileflowIconPackagesOptions, type CompileTileflowIconPackagesResult, type CompiledTileflowIconPackage, type CompiledTileflowIconPackageFile, type ComposeTileflowIconSourcesOptions, type InspectTileflowIconCatalogsOptions, type PreparedTileflowBuildCatalog, type PreparedTileflowCatalog, type ReadTileflowIconDirectoryResult, type TileflowBuildAsset, type TileflowComposedIconContributor, type TileflowComposedIconSources, type TileflowComposedIconWinner, type TileflowIconCacheOptions, type TileflowIconCatalog, type TileflowIconCatalogAtlasRectangle, type TileflowIconCatalogContributor, type TileflowIconCatalogIcon, type TileflowIconCatalogIconSource, type TileflowIconCatalogInspection, type TileflowIconCatalogMap, type TileflowIconCatalogRenderedDensity, type TileflowIconCatalogSourceFormat, TileflowIconCompilationError, type TileflowIconCompilationIssue, type TileflowIconCompilationTarget, type TileflowIconDirectoryEntry, type TileflowIconDirectorySourceFile, type TileflowIconReplacement, type TileflowIconResolutionOptions, type TileflowMapIconPackageBinding, type TileflowRenderedIcon, type TileflowRenderedIconCell, type TileflowSourceCatalog, type VerifiedTileflowIconArtifact, compileTileflowIconPackages, composeTileflowIconSources, getTileflowIconCacheDirectory, getTileflowIconWatchPaths, iconFileExtensions, inspectTileflowIconCatalogs, loadTileflowIconSetArtifact, packTileflowRenderedIcons, prepareTileflowCatalogIcons, readTileflowIconDirectory, readTileflowIconsLockfile, readTileflowIconsLockfileText, storeTileflowIconSetArtifact, verifyTileflowIconArtifact, writeTileflowIconsLockfile };
+export { type CompileTileflowIconPackagesOptions, type CompileTileflowIconPackagesResult, type CompiledTileflowIconPackage, type CompiledTileflowIconPackageFile, type ComposeTileflowIconSourcesOptions, type InspectTileflowIconCatalogsOptions, type PreparedTileflowBuildCatalog, type PreparedTileflowCatalog, type ReadTileflowIconDirectoryResult, type TileflowBuildAsset, type TileflowComposedIconContributor, type TileflowComposedIconSources, type TileflowComposedIconWinner, type TileflowIconCacheOptions, type TileflowIconCatalog, type TileflowIconCatalogAtlasRectangle, type TileflowIconCatalogContributor, type TileflowIconCatalogIcon, type TileflowIconCatalogIconSource, type TileflowIconCatalogInspection, type TileflowIconCatalogMap, type TileflowIconCatalogRenderedDensity, type TileflowIconCatalogSourceFormat, TileflowIconCompilationError, type TileflowIconCompilationIssue, type TileflowIconCompilationTarget, type TileflowIconDirectoryEntry, type TileflowIconDirectorySourceFile, type TileflowIconReplacement, type TileflowIconResolutionOptions, type TileflowMapIconPackageBinding, type TileflowRenderedIcon, type TileflowRenderedIconCell, type TileflowSourceCatalog, type VerifiedTileflowIconArtifact, compileTileflowIconPackages, composeTileflowIconSources, getTileflowIconCacheDirectory, getTileflowIconWatchPaths, iconFileExtensions, inspectTileflowIconCatalogs, loadTileflowIconSetArtifact, packTileflowRenderedIcons, prepareTileflowCatalogIcons, readTileflowIconDirectory, readTileflowIconsLockfile, readTileflowIconsLockfileText, renderTileflowIconAtlasPreview, storeTileflowIconSetArtifact, verifyTileflowIconArtifact, writeTileflowIconsLockfile };

package/dist/icons.js

@@ -12,10 +12,11 @@ import {
   readTileflowIconDirectory,
   readTileflowIconsLockfile,
   readTileflowIconsLockfileText,
+  renderTileflowIconAtlasPreview,
   storeTileflowIconSetArtifact,
   verifyTileflowIconArtifact,
   writeTileflowIconsLockfile
-} from "./chunk-D2QWYYIF.js";
+} from "./chunk-EJPVUSX4.js";
 import "./chunk-7C4F6GAX.js";
 export {
   TileflowIconCompilationError,
@@ -31,6 +32,7 @@ export {
   readTileflowIconDirectory,
   readTileflowIconsLockfile,
   readTileflowIconsLockfileText,
+  renderTileflowIconAtlasPreview,
   storeTileflowIconSetArtifact,
   verifyTileflowIconArtifact,
   writeTileflowIconsLockfile

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-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 { 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, prepareTileflowHostedNativeDeployment, 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 { CompileTileflowIconPackagesOptions, CompileTileflowIconPackagesResult, CompiledTileflowIconPackage, CompiledTileflowIconPackageFile, ComposeTileflowIconSourcesOptions, InspectTileflowIconCatalogsOptions, PreparedTileflowBuildCatalog, PreparedTileflowCatalog, ReadTileflowIconDirectoryResult, TileflowBuildAsset, TileflowComposedIconContributor, TileflowComposedIconSources, TileflowComposedIconWinner, TileflowIconCacheOptions, TileflowIconCatalog, TileflowIconCatalogAtlasRectangle, TileflowIconCatalogContributor, TileflowIconCatalogIcon, TileflowIconCatalogIconSource, TileflowIconCatalogInspection, TileflowIconCatalogMap, TileflowIconCatalogRenderedDensity, TileflowIconCatalogSourceFormat, TileflowIconCompilationError, TileflowIconCompilationIssue, TileflowIconCompilationTarget, TileflowIconDirectoryEntry, TileflowIconDirectorySourceFile, TileflowIconReplacement, TileflowIconResolutionOptions, TileflowMapIconPackageBinding, TileflowRenderedIcon, TileflowRenderedIconCell, TileflowSourceCatalog, VerifiedTileflowIconArtifact, compileTileflowIconPackages, composeTileflowIconSources, getTileflowIconCacheDirectory, getTileflowIconWatchPaths, iconFileExtensions, inspectTileflowIconCatalogs, loadTileflowIconSetArtifact, packTileflowRenderedIcons, prepareTileflowCatalogIcons, readTileflowIconDirectory, readTileflowIconsLockfile, readTileflowIconsLockfileText, storeTileflowIconSetArtifact, verifyTileflowIconArtifact, writeTileflowIconsLockfile } from './icons.js';
+export { CompileTileflowIconPackagesOptions, CompileTileflowIconPackagesResult, CompiledTileflowIconPackage, CompiledTileflowIconPackageFile, ComposeTileflowIconSourcesOptions, InspectTileflowIconCatalogsOptions, PreparedTileflowBuildCatalog, PreparedTileflowCatalog, ReadTileflowIconDirectoryResult, TileflowBuildAsset, TileflowComposedIconContributor, TileflowComposedIconSources, TileflowComposedIconWinner, TileflowIconCacheOptions, TileflowIconCatalog, TileflowIconCatalogAtlasRectangle, TileflowIconCatalogContributor, TileflowIconCatalogIcon, TileflowIconCatalogIconSource, TileflowIconCatalogInspection, TileflowIconCatalogMap, TileflowIconCatalogRenderedDensity, TileflowIconCatalogSourceFormat, TileflowIconCompilationError, TileflowIconCompilationIssue, TileflowIconCompilationTarget, TileflowIconDirectoryEntry, TileflowIconDirectorySourceFile, TileflowIconReplacement, TileflowIconResolutionOptions, TileflowMapIconPackageBinding, TileflowRenderedIcon, TileflowRenderedIconCell, TileflowSourceCatalog, VerifiedTileflowIconArtifact, compileTileflowIconPackages, composeTileflowIconSources, getTileflowIconCacheDirectory, getTileflowIconWatchPaths, iconFileExtensions, inspectTileflowIconCatalogs, loadTileflowIconSetArtifact, packTileflowRenderedIcons, prepareTileflowCatalogIcons, readTileflowIconDirectory, readTileflowIconsLockfile, readTileflowIconsLockfileText, renderTileflowIconAtlasPreview, storeTileflowIconSetArtifact, verifyTileflowIconArtifact, writeTileflowIconsLockfile } from './icons.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, TileflowDevRequestHandler, TileflowDevRequestHandlerOptions, createTileflowArtifactStatus, createTileflowComparisonRequestHandler, createTileflowDevRequestHandler, createTileflowNodeRequest, getTileflowRequestPath, getTileflowStyleInspectionSelection, getTileflowStyleSelection, isTileflowRequestUrl, tileflowComparisonSchemaVersion, writeTileflowNodeResponse } from './server.js';
@@ -10,4 +10,5 @@ export { TileflowCommandFailureDocument, TileflowCommandSummary, TileflowDiagnos
 import '@tileflow/core';
 import '@tileflow/core/build';
 import '@tileflow/core/manifest';
+import '@tileflow/core/native-profile';
 import 'node:http';

package/dist/index.js

@@ -4,14 +4,14 @@ import {
   inspectTileflowConfig,
   inspectTileflowFeatures,
   sanitizeTileflowInspectableValue
-} from "./chunk-MKPSQSMX.js";
+} from "./chunk-73YPFDPC.js";
 import {
   createTileflowCommandFailureDocument,
   createTileflowCommandSummary,
   createTileflowStructuredDiagnostics,
   serializeTileflowCommandDocument,
   tileflowCommandDocumentSchemaVersion
-} from "./chunk-LNCTVFUD.js";
+} from "./chunk-XHJBCVBB.js";
 import {
   TileflowPreviewSelectionError,
   normalizeTileflowLandmarkManifest,
@@ -31,7 +31,7 @@ import {
   isTileflowRequestUrl,
   tileflowComparisonSchemaVersion,
   writeTileflowNodeResponse
-} from "./chunk-3WCEHA27.js";
+} from "./chunk-UCBGTEQV.js";
 import {
   TileflowHostedManifestOverwriteError,
   TileflowLocalTilesetProductionError,
@@ -49,6 +49,7 @@ import {
   getTileflowArtifactFiles,
   getTileflowWatchPaths,
   isTileflowArtifactInputPath,
+  prepareTileflowHostedNativeDeployment,
   prepareTileflowLocalTilesets,
   refreshTileflowArtifactSession,
   tileflowArtifactInventoryFileName,
@@ -56,7 +57,7 @@ import {
   tileflowArtifactSessionSchemaVersion,
   writeTileflowArtifactPlan,
   writeTileflowBuildArtifacts
-} from "./chunk-W3X2JXYS.js";
+} from "./chunk-QAMFAM3S.js";
 import {
   inspectTileflowPmtiles,
   inspectTileflowPmtilesForLocalUse
@@ -87,10 +88,11 @@ import {
   readTileflowIconDirectory,
   readTileflowIconsLockfile,
   readTileflowIconsLockfileText,
+  renderTileflowIconAtlasPreview,
   storeTileflowIconSetArtifact,
   verifyTileflowIconArtifact,
   writeTileflowIconsLockfile
-} from "./chunk-D2QWYYIF.js";
+} from "./chunk-EJPVUSX4.js";
 import "./chunk-7C4F6GAX.js";
 import {
   TileflowStyleValidationError,
@@ -178,6 +180,7 @@ export {
   normalizeTileflowLandmarkManifest,
   packTileflowRenderedIcons,
   prepareTileflowCatalogIcons,
+  prepareTileflowHostedNativeDeployment,
   prepareTileflowLocalTilesets,
   prepareTileflowStyleFonts,
   readBoundedTileflowJsonResponse,
@@ -186,6 +189,7 @@ export {
   readTileflowIconsLockfile,
   readTileflowIconsLockfileText,
   refreshTileflowArtifactSession,
+  renderTileflowIconAtlasPreview,
   renderTileflowPreviewHtml,
   replaceTileflowStyleFontSources,
   resolveTileflowArtifactPublicUrls,

package/dist/inspect.js

@@ -4,8 +4,8 @@ import {
   inspectTileflowConfig,
   inspectTileflowFeatures,
   sanitizeTileflowInspectableValue
-} from "./chunk-MKPSQSMX.js";
-import "./chunk-LNCTVFUD.js";
+} from "./chunk-73YPFDPC.js";
+import "./chunk-XHJBCVBB.js";
 import "./chunk-KDFTE4Q5.js";
 import "./chunk-6MGFMKG3.js";
 import "./chunk-D4OE4ITL.js";

package/dist/server.d.ts

@@ -4,6 +4,7 @@ import { IncomingMessage, ServerResponse } from 'node:http';
 import '@tileflow/core';
 import '@tileflow/core/build';
 import '@tileflow/core/manifest';
+import '@tileflow/core/native-profile';
 import './icons.js';
 import './config.js';
 

package/dist/server.js

@@ -9,11 +9,11 @@ import {
   isTileflowRequestUrl,
   tileflowComparisonSchemaVersion,
   writeTileflowNodeResponse
-} from "./chunk-3WCEHA27.js";
+} from "./chunk-UCBGTEQV.js";
 import {
   createTileflowArtifactDiagnostics,
   tileflowArtifactSessionSchemaVersion
-} from "./chunk-W3X2JXYS.js";
+} from "./chunk-QAMFAM3S.js";
 import "./chunk-ONYQNLNA.js";
 import {
   getTileflowAssetBasePath,
@@ -22,7 +22,7 @@ import {
   normalizeTileflowBasePath,
   resolveTileflowArtifactPublicUrls
 } from "./chunk-UTRO4IBQ.js";
-import "./chunk-D2QWYYIF.js";
+import "./chunk-EJPVUSX4.js";
 import "./chunk-7C4F6GAX.js";
 import "./chunk-KDFTE4Q5.js";
 import "./chunk-6MGFMKG3.js";

package/dist/validation.d.ts

@@ -30,6 +30,8 @@ type TileflowStructuredDiagnostic = {
     severity: TileflowDiagnosticSeverity;
     message: string;
     suggestion: string;
+    renderer?: 'native';
+    profile?: 'native-v1';
 };
 type TileflowCommandSummary = TileflowStructuredDiagnostic & {
     schemaVersion: typeof tileflowCommandDocumentSchemaVersion;

package/dist/validation.js

@@ -4,7 +4,7 @@ import {
   createTileflowStructuredDiagnostics,
   serializeTileflowCommandDocument,
   tileflowCommandDocumentSchemaVersion
-} from "./chunk-LNCTVFUD.js";
+} from "./chunk-XHJBCVBB.js";
 import {
   TileflowStyleValidationError,
   assertValidTileflowStyle,

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

@@ -41,14 +41,14 @@ 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, 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
+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
 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
+patterns. Blueprint 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.

package/docs/local-comparison-workbench-and-compiler-inspection.md

@@ -235,11 +235,10 @@ 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`, `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
+case-only collisions fail. Package maps export `streetsIcons`, `baedekerIcons`, `civicaIcons`,
+`ferrarisIcons`, `haradIcons`, `siegfriedIcons`, `soundingsIcons`, `blueprintIcons` directory descriptors from
+`@tileflow/maps`. Baedeker, Cívica, and Siegfried also export
+`baedekerFonts`, `civicaFonts`, 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.

package/docs/native-artifacts.md

@@ -0,0 +1,258 @@
+# Prepare native map artifacts
+
+Use the existing artifact pipeline with `renderer: 'native'` to prepare the `native-v1` static
+profile. The same config loader, inheritance resolver, semantic compiler, icon composition and
+font pipeline are used. There is no separate native map language.
+
+Install the packages and create a trusted `tileflow.config.ts` as described in the
+[package README](../README.md). The source version containing this option must be installed;
+a source branch or a successful build does not establish npm availability.
+
+## Prepare in memory
+
+<!-- docs:check -->
+
+```ts
+import {createTileflowBuildArtifacts} from '@tileflow/dev/artifacts';
+
+const artifacts = await createTileflowBuildArtifacts({
+  config: 'tileflow.config.ts',
+  renderer: 'native',
+});
+
+try {
+  console.log(artifacts.manifest);
+  console.log(artifacts.nativeBuild);
+} finally {
+  await artifacts.dispose?.();
+}
+```
+
+The pipeline checks every concrete theme. A rejected theme fails the complete generation before
+production output is written. Native preparation applies the versioned transformations below;
+other unsupported layers, fonts or protocols are not silently removed.
+Local PMTiles are rejected before creating archive snapshots. URL checks do not fetch remote
+TileJSON, glyphs or tiles and do not prove their content or availability.
+
+Font preparation verifies the same licensed source bytes as web preparation, then maps exact full
+names into Native's `font-faces` root property. It does not retain browser `tileflow:fontFaces`
+metadata or claim a system font is equivalent. Sprites keep the original independently generated
+1x and 2x bytes; the native check verifies their pair, dimensions, IDs and existing size limits.
+
+## Versioned native lowering
+
+Selecting `renderer: 'native'` applies `native-lowering-v1` after shared semantic compilation and
+before final native validation. It never edits the authored map, the official map definitions or
+the shared compiler. Web output is not lowered.
+
+A fixed `projection: {type: 'globe'}` is explicitly normalized to Native's implicit Mercator. This
+is a renderer-specific projection change, not equivalent globe rendering. An explicit fixed
+Mercator declaration is also omitted. Adaptive/expression projections and unknown projection
+options remain errors. Every style receipt states which normalization, if any, occurred.
+
+For line layers, finite `line-cap` and `line-dasharray` decisions become contiguous physical layers
+with constant values. Supported trees use constant leaves, `literal`, first-match `case`, disjoint
+`match` labels and `step`. Predicates may combine boolean operations, scalar equality, membership,
+`has`, geometry type and typed numeric comparisons/steps. Unchecked feature values are restricted
+to vector sources, whose properties are scalar. Numeric coercion requires an explicit finite
+fallback. Arbitrary feature-valued leaves, continuous interpolation, feature state, unsupported
+operators and any unprovable decision fail with the original property pointer.
+
+The partition preserves first-match priority. Each feature accepted by the original filter is
+accepted by exactly one active replacement with the same cap and dash values; all other features
+remain excluded. Existing legacy filters are converted with the pinned Style Spec converter before
+intersection. Source, source-layer, metadata and other layout/paint values are preserved. Existing
+`minzoom`/`maxzoom` are intersected with the decision intervals. Both target properties use integer
+camera-zoom evaluation, so a step at 8.5 changes its value at zoom 9, while an original fractional
+layer visibility bound remains fractional. New branch filters contain no camera-zoom expression.
+
+Grouped outcomes use compact boolean decision trees rather than repeated lists of every earlier
+arm's negated guard. Multi-arm cases remain flat to avoid trading size for excessive depth.
+Identical outcomes and adjacent identical intervals are coalesced. IDs derive from the original
+layer ID, the lowering version and deterministic branch order, with collision checks against the
+whole input style. The original layer's replacements stay together; surrounding layers are not
+reordered. Existing sort-key expressions are retained, not simplified or replaced.
+
+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
+native representation has a separate fixed 540,000-node ceiling, checked after lowering, after
+font preparation and after generation URL retargeting. Both stages retain 4,096 layers, depth 64
+and 8 MiB. No caller option raises either budget and no rejected input is retried under the output
+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
+[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.
+
+The equivalence checks cover per-feature selection, cap/dash values and zoom ranges, **not draw
+order across features**. Copying `line-sort-key` preserves ordering only inside each physical
+layer. If a feature with sort key 1 enters the first branch and a feature with sort key 0 enters
+the second, the physical layers draw them as 1 then 0 instead of 0 then 1. Both features can satisfy
+mutually exclusive filters yet have overlapping geometry. The resulting composition can differ,
+not merely its antialiasing. Even without a sort key, partitioning can change source feature order.
+
+The native-lowering-v1 policy permits these bounded partitions without promising identical global
+feature order. Applications requiring exact overlapping-feature order must not treat such an
+artifact as order-equivalent to its web style. Automated checks establish feature selection,
+cap/dash values, zoom ranges, determinism and resource bounds, not pixel equivalence.
+
+A small directed iOS/Android rendering check of cap/dash/overlap is required for each accepted
+candidate using the recipe below. Full visual qualification belongs to the general mobile release
+gate; it is not claimed by artifact preparation. Browser capture cannot replace either native
+check, and a few visual samples cannot prove preservation of arbitrary feature order.
+
+## Write a separate output
+
+<!-- docs:check -->
+
+```ts
+import {writeTileflowBuildArtifacts} from '@tileflow/dev/artifacts';
+
+await writeTileflowBuildArtifacts({
+  config: 'tileflow.config.ts',
+  renderer: 'native',
+  outDir: 'public/tileflow',
+});
+```
+
+This writes `public/tileflow/native/manifest.json`, `build-manifest.json`, `native-build.json` and
+the complete style/asset generation beneath `public/tileflow/native`. The writer adds `native` once
+beneath `outDir`; pass the output parent, not an already renderer-qualified directory. The native
+subdirectory owns a separate inventory. A web build at the parent neither replaces its manifest nor
+collects the native generation, and vice versa.
+
+The runtime manifest remains strict version 1 with the same map/theme shape. No renderer/profile
+field is added to it. Native font declarations live in the native styles, not a web font loader.
+`native-build.json` is a separate strict build record that identifies the renderer, profile, selected
+engines, `validation: 'static-artifacts'` and the canonical `build-manifest.json` SHA-256. Its
+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
+compiler output; the lowered hash precedes native font preparation and generation URL retargeting.
+The build-manifest hash separately binds the final prepared styles and assets. All styles receive
+an entry, including styles for which no lowering was needed. Schema v1 build records do not imply
+this preparation policy and are not parsed as v2.
+
+The existing logical map revision remains based on resolved cartography and source asset identity.
+Representation changes, such as native font mapping, change the style hash rather than inventing
+a second logical map. Transport credentials and device state never enter these artifacts.
+
+File names in an in-memory plan remain relative to the renderer output root. Relative style/font
+URLs remain relative to their owning documents. An explicit absolute or host-relative
+`styleBaseUrl`/`assetBaseUrl`, such as `/tileflow`, receives the `/native` suffix. The pipeline uses
+an inert `.invalid` document base only to check relative URL syntax; it does not publish that base
+or infer the application's real delivery origin.
+
+Omitting `renderer`, or specifying `renderer: 'web'`, preserves the existing web artifact bytes and
+output layout. The native record is absent from web plans.
+
+## Retain the last valid generation
+
+`createTileflowArtifactSession({renderer: 'native', watch: true})` uses the existing session lifecycle.
+An incompatible edit publishes an `invalid` state with native diagnostic context. It retains the
+previous valid artifacts but does not publish them again as a new successful generation. Acquiring,
+releasing and disposing a generation follow the existing [artifact lifecycle](artifact-lifecycle.md).
+
+This is artifact watching, not a native preview server. Do not pass these artifacts to browser
+preview/capture as evidence of a native render. Native inspection sidecars, React Native components,
+Hermes execution, iOS/Android qualification, Hosted authorization and deployment are not supplied.
+
+## Audit lowering size and feature order
+
+From the SDK source root after installing and building the pinned workspace:
+
+```sh
+pnpm exec tsx scripts/native-lowering-audit.ts > native-lowering-audit.json
+```
+
+This diagnostic report compiles the unchanged full Streets family through the web preparation
+path, then measures the native representation for **both** dark and light before applying output
+budget assertions. It writes no native artifact generation and is not a compatibility verdict.
+Each theme includes layer counts, visited JSON nodes, UTF-8 bytes and maximum depth before/after;
+every transformed layer is listed with its ID, physical span, branch count and zoom intervals,
+sort-key expression and paint indicators. Simultaneously active branches are marked as an
+unproven feature-order boundary, not as a claim that their geometry is disjoint.
+
+Subtree accounts separate copied unchanged layer payload from generated filters and input
+cap/dash decisions. They identify whether predicate expansion or repetition of other properties
+dominates; they are not an additive byte decomposition. The counters include array keys, matching
+the profile's existing node convention. Retain the report with the checkout SHA. An over-budget
+result must not be treated as a successful native build or fixed by dropping layers or weakening
+validation. The test suite prints the two-theme size summary even when a budget assertion fails.
+
+## Prepare Streets for a directed native check
+
+From a source checkout, install and build the pinned workspace first. The test-only
+`test/fixtures/native-streets.config.ts` exports the unchanged official Streets definition. It
+exists to make artifact generation repeatable without a second compiler, custom map or native
+harness. From the SDK root:
+
+```sh
+pnpm --filter @tileflow/dev exec node ../cli/dist/index.js validate \
+  --config test/fixtures/native-streets.config.ts --renderer native --target local --json
+pnpm --filter @tileflow/dev exec node ../cli/dist/index.js build \
+  --config test/fixtures/native-streets.config.ts --renderer native --target local \
+  --out output/native-streets --json
+pnpm exec tsx scripts/native-lowering-audit.ts > /tmp/native-lowering-audit.json
+```
+
+The output root is `packages/dev/output/native-streets/native`. It contains
+`styles/streets/dark.json`, `styles/streets/light.json`, their shared sprite/font assets, a version-1
+`manifest.json` and the version-2 `native-build.json` receipt. Keep the complete directory together.
+The manifest points to the content-addressed generation; use those URLs for an actual render.
+Do not copy only the two style files and leave their relative assets behind. Record the checkout
+SHA, both prepared style hashes, engine versions and the resource origin used for the check.
+The fixture and output are source-checkout tools, not a published mobile component or a baseline.
+
+Use an existing native test application with the pinned engines and a reachable artifact origin;
+artifact generation starts no server and requests no deployment. Load the same generated manifest
+family independently on iOS and Android. Resolve its style URL against the manifest URL, then each
+relative style resource against that style's URL before passing the style to MapLibre Native. A raw
+style URL does not transfer this ownership to the renderer. The directed artifact check may use a
+test-owned resolver, but that does not qualify a future runtime resolver. A useful starting viewport
+is a dense road/rail junction with visible paths and bridges; select one where the loaded vector data
+actually contains features for the transformed layers listed in
+`/tmp/native-lowering-audit.json`. Use the audit's exact physical IDs, source layers, branch counts
+and zoom intervals rather than assuming that a map location exercises every branch.
+
+Check both themes at the same center, viewport, pitch 0 and bearing 0. Exercise at least one cap
+partition, one dashed/solid partition and an overlap between simultaneously active branches. Pan
+slightly and inspect just below/at/above the relevant audit zoom cuts (for example 15.99/16/16.01
+when a selected interval changes at 16). Check that caps and dash patterns are visible, layers do
+not disappear or double-select a feature, theme replacement preserves the scene, and no resource
+or style errors are reported. Inspect overlapping strokes for the documented composition
+trade-off, not for equality with web drawing order. Keep brief per-platform observations and
+explicitly distinguish an unexercised branch from a passed one.
+
+This check has not been run by the artifact tests. It neither establishes full iOS/Android visual
+qualification nor creates a screenshot baseline. Renderers, native view lifecycle, network
+transport and mobile distribution remain outside these build tools.
+
+## Reproduce the official-map report
+
+From an SDK source checkout after installing and building its pinned workspace:
+
+```sh
+pnpm exec tsx scripts/native-catalog-report.ts > native-catalog-report.json
+```
+
+The report evaluates all ten official maps and each of their themes through the shared pipeline.
+Rows contain either a static-compatible style hash or exact incompatibility diagnostics, sorted by
+map/theme with no timestamp or local path. Each row checks an individual theme; it is not a revision
+receipt for a rewritten single-theme map. Unexpected compilation/tool failures stop report generation
+rather than being relabeled as known incompatibilities. Retain the output together with the checkout
+SHA and lockfile used to produce it. The test suite compares two independent evaluations and requires
+Streets to pass. No unchecked catalog-wide compatibility assertion is implied by the presence of
+this command, and this report is not a device-qualification result.
+
+See the [Core profile contract](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/native-artifact-profile.md)
+for the version intersection, diagnostic codes and unsupported representations.