@tileflow/core 0.1.0-alpha.26 → 0.1.0-alpha.27

package/README.md

@@ -90,13 +90,14 @@ Shared-set content identifies the effective published artifact. Git owns origina
 source-only SVG edits producing the same artifact are not shared content changes. No original-source
 hash, source format, or filesystem path is added to a shared package. Local/package originals retain
 their existing source identity. Shared winners use explicit `rendered-icon` identity, while an
-ordered `tileflow-icon-composition-v1` receipt records consumed revisions separately, including
+ordered versioned icon-composition receipt records consumed revisions separately, including
 fully shadowed sets and dependency changes that preserve rendered pixels.
 
 Map revision hashing preserves the existing v1 result for maps without shared sets. Maps with sets
 require a complete receipt and use the domain-separated v2 revision contract. Build-manifest map
 entries identify that contract with `mapRevisionSchemaVersion: 2`; omission means legacy v1. The
-generated icon package remains `tileflow-icon-package-v1` and the asset-set hash is unchanged.
+Metadata-free RGBA icon packages retain `tileflow-icon-package-v1` identity. SDF appearance or text-fitting metadata uses
+`tileflow-icon-package-v2` and v2 composition receipts; defaults and layout participate in identity.
 
 These are portable contracts. `@tileflow/dev` composes declared contributors on its normal
 preparation path, and the `tileflow` CLI owns catalog management and exact lock maintenance.
@@ -135,7 +136,7 @@ export default defineMap({
 });
 ```
 
-`system` is a browser selection policy, not a stored theme. Builds, captures, static scenes, and
+`system` is a runtime selection policy, not a stored theme. Builds, captures, static scenes, and
 receipts must use a concrete theme such as `light` or `dark`.
 
 The semantic domains are `land`, `water`, `nautical`, `roads`, `buildings`, `boundaries`, `labels`,
@@ -174,6 +175,36 @@ resolved compiler input. `diffTileflowMaps(before, after)` returns deterministic
 at JSON Pointer paths. Physical inspection IDs and indexes are diagnostic observations, not stable
 application targets.
 
+## Select a prepared map
+
+React, Vue and Svelte accept a required `source` object, `{map, manifestUrl?}`. `map` is the portable
+name in the manifest, not a Hosted `map_...` identifier. An omitted web `manifestUrl` means exactly
+`/tileflow/manifest.json`; custom paths and external hosts must be explicit. The native Core and
+React Native type contracts use `{map, manifestUrl}` with an explicit absolute URL. They do not
+infer an application origin, Metro host or manifest location.
+
+<!-- docs:check -->
+
+```ts
+import type {TileflowNativeSource} from '@tileflow/core/native';
+import type {TileflowRuntimeSource} from '@tileflow/core/runtime';
+
+const webSource = {map: 'madrid'} satisfies TileflowRuntimeSource;
+const nativeSource = {
+  map: 'madrid',
+  manifestUrl: 'https://maps.example.com/tileflow/native/manifest.json',
+} satisfies TileflowNativeSource;
+```
+
+These objects select existing prepared maps; they do not compile or render one. Every Tileflow
+framework Map is manifest-backed, without a renderer discriminator or direct-style mode. The
+obsolete source fields `kind` and `style` are rejected. Completely unmanaged maps use upstream
+MapLibre directly. Omitted themes use the manifest default, concrete themes select exact names,
+and `system` requires the manifest's explicit light/dark mapping and a supplied runtime color scheme.
+See the [native source guide](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/native-resource-urls.md)
+for source coordination, bounded acquisition and safe diagnostics. The pre-release React Native
+package uses this contract for its mounted Map; it is not yet published.
+
 ## Data, terrain, and browser resources
 
 Tileflow World is the hosted primary-data path. `vectorTiles()` with `openMapTiles()` supports
@@ -218,3 +249,12 @@ revision; prefer the installed copy when working with an older release.
 - [Public API and browser subpath](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/public-api-and-browser-subpath.md)
 - [Hosted session authorization](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/hosted-session-authorization.md)
 - [Native resource URLs](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/native-resource-urls.md)
+- [Native artifact profile](https://github.com/tileflow/tileflow-sdk/blob/main/packages/core/docs/native-artifact-profile.md)
+
+## Native icon capabilities
+
+Prepared icon metadata identifies SDF assets and their default fill and halo. Core rejects any
+symbol layer that can select both SDF and RGBA, including fallbacks and effective local overrides,
+with `TF_ICON_REPRESENTATION_MIXED`. It preserves layers, collisions and interaction IDs. Omitted
+SDF paint follows the resolved image selection; supplied map paint stays independent from asset
+defaults. See [Author recolorable and adaptable icons](https://github.com/tileflow/tileflow-sdk/blob/main/packages/dev/docs/native-icons.md).

package/THIRD_PARTY_NOTICES.md

@@ -241,3 +241,87 @@ AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR
 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
 NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
 OF THIS SOFTWARE.
+
+---
+
+## whatwg-url 15.1.0 and tr46 6.0.0
+
+The native entry embeds the low-level `whatwg-url` parser and `tr46` IDNA processing. During the
+native build only, the parser's relative encoding module is replaced by Tileflow's private UTF-8
+codec. No upstream package is patched on disk and no global codec is installed. Both components
+are MIT-licensed:
+
+The MIT License (MIT)
+
+Copyright (c) Sebastian Mayr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+---
+
+## Punycode.js 2.3.1
+
+Copyright Mathias Bynens <https://mathiasbynens.be/>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---
+
+## Zod 4.4.3
+
+The native entry embeds the canonical manifest schema and the required Zod validation code.
+
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/build.d.ts

@@ -1,8 +1,8 @@
-import { T as TileflowCaptureScene } from './capture-scene-BK_0J2oR.js';
-import { T as TileflowRenderedIconIdentity, a as TileflowIconCompositionV1, R as ResolvedTileflowMap, b as TileflowDataRequirementsV1, c as TileflowSourceRequirementsV1, d as TileflowMap, e as TileflowStyleOptions, f as TileflowInspectedStyle, g as TileflowPreparedMapAssets } from './icon-composition-BssSKOKF.js';
-export { h as TileflowDataCompatibilityIssue, i as TileflowDataFieldRequirement, j as TileflowDataFieldType, k as TileflowDataLayerRequirement, l as TileflowObservedDataContractV1, m as TileflowStyleInspection, n as TileflowStyleInspectionContribution, o as TileflowStyleInspectionLayer, p as TileflowStyleInspectionRenderOperation, q as collectMapLineage, r as inferTileflowDataRequirements, s as inferTileflowSourceRequirements, t as tileflowStyleInspectionSchemaVersion, v as validateTileflowDataCompatibility } from './icon-composition-BssSKOKF.js';
-import { M as MapLibreStyle, T as TileflowRuntimeManifest } from './manifest-B5GKVMFE.js';
-import 'zod';
+import { T as TileflowCaptureScene } from './capture-scene-D6soWztE.js';
+import { T as TileflowRenderedIconIdentity, a as TileflowIconCompositionV1, R as ResolvedTileflowMap, b as TileflowDataRequirementsV1, c as TileflowSourceRequirementsV1, d as TileflowMap, e as TileflowStyleOptions, f as TileflowInspectedStyle, g as TileflowPreparedMapAssets } from './icon-composition-C2bVldOJ.js';
+export { h as TileflowDataCompatibilityIssue, i as TileflowDataFieldRequirement, j as TileflowDataFieldType, k as TileflowDataLayerRequirement, l as TileflowObservedDataContractV1, m as TileflowStyleInspection, n as TileflowStyleInspectionContribution, o as TileflowStyleInspectionLayer, p as TileflowStyleInspectionRenderOperation, q as collectMapLineage, r as inferTileflowDataRequirements, s as inferTileflowSourceRequirements, t as tileflowStyleInspectionSchemaVersion, v as validateTileflowDataCompatibility } from './icon-composition-C2bVldOJ.js';
+import { M as MapLibreStyle, T as TileflowRuntimeManifest } from './manifest-types-BdGjIYy-.js';
+import { z } from 'zod';
 
 declare const tileflowMapRevisionSchemaVersion: 1;
 declare const tileflowSharedIconMapRevisionSchemaVersion: 2;
@@ -132,6 +132,417 @@ declare function hashTileflowAssetSetIdentities(input: readonly TileflowBuildAss
  */
 declare function createStyleWithInspection(config: TileflowMap, options?: TileflowStyleOptions): TileflowInspectedStyle;
 
+/** These are transport/validation bounds, not renderer or commercial quotas. */
+declare const tileflowRendererDeploymentLimits: Readonly<{
+    maximumBytes: number;
+    maximumNativeFamilyBytes: number;
+    maximumThemes: 64;
+}>;
+/** Explicit v2 only. Existing v1 envelopes and decoders are not extended by this schema. */
+declare const tileflowRendererDeploymentArtifactSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"tileflow-map-deployment">;
+    schemaVersion: z.ZodLiteral<2>;
+    mapId: z.ZodString;
+    teamSources: z.ZodRecord<z.ZodString, z.ZodObject<{
+        tileset: z.ZodString;
+        type: z.ZodEnum<{
+            vector: "vector";
+            raster: "raster";
+        }>;
+    }, z.core.$strict>>;
+    view: z.ZodOptional<z.ZodObject<{
+        center: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        zoom: z.ZodOptional<z.ZodNumber>;
+        bearing: z.ZodOptional<z.ZodNumber>;
+        pitch: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    renderers: z.ZodObject<{
+        web: z.ZodObject<{
+            buildManifest: z.ZodObject<{
+                schemaVersion: z.ZodLiteral<1>;
+                maps: z.ZodRecord<z.ZodString, z.ZodObject<{
+                    assetSetSha256: z.ZodString;
+                    defaultTheme: z.ZodString;
+                    lineage: z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        mapVersion: z.ZodNumber;
+                    }, z.core.$strict>>;
+                    mapRevisionSha256: z.ZodString;
+                    mapRevisionSchemaVersion: z.ZodOptional<z.ZodLiteral<2>>;
+                    mapVersion: z.ZodNumber;
+                    semanticCompiler: z.ZodObject<{
+                        name: z.ZodLiteral<"tileflow-semantic">;
+                        version: z.ZodLiteral<1>;
+                    }, z.core.$strict>;
+                    sourceAssets: z.ZodObject<{
+                        fonts: z.ZodArray<z.ZodObject<{
+                            family: z.ZodString;
+                            sha256: z.ZodString;
+                            style: z.ZodEnum<{
+                                italic: "italic";
+                                normal: "normal";
+                                oblique: "oblique";
+                            }>;
+                            weight: z.ZodEnum<{
+                                100: "100";
+                                200: "200";
+                                300: "300";
+                                400: "400";
+                                500: "500";
+                                600: "600";
+                                700: "700";
+                                800: "800";
+                                900: "900";
+                            }>;
+                        }, z.core.$strict>>;
+                        icons: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                            format: z.ZodEnum<{
+                                jpeg: "jpeg";
+                                png: "png";
+                                svg: "svg";
+                                webp: "webp";
+                            }>;
+                            id: z.ZodString;
+                            kind: z.ZodEnum<{
+                                pattern: "pattern";
+                                icon: "icon";
+                            }>;
+                            sha256: z.ZodString;
+                        }, z.core.$strict>, z.ZodObject<{
+                            kind: z.ZodLiteral<"rendered-icon">;
+                            id: z.ZodString;
+                            appearance: z.ZodOptional<z.ZodObject<{
+                                representation: z.ZodLiteral<"sdf">;
+                                defaults: z.ZodObject<{
+                                    color: z.ZodString;
+                                    haloColor: z.ZodString;
+                                    haloWidth: z.ZodNumber;
+                                    haloBlur: z.ZodNumber;
+                                }, z.core.$strict>;
+                            }, z.core.$strict>>;
+                            layout: z.ZodOptional<z.ZodObject<{
+                                stretchX: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                                stretchY: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                                content: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                            }, z.core.$strict>>;
+                            width: z.ZodNumber;
+                            height: z.ZodNumber;
+                            pixelSha256: z.ZodObject<{
+                                oneX: z.ZodString;
+                                twoX: z.ZodString;
+                            }, z.core.$strict>;
+                        }, z.core.$strict>]>>;
+                        iconComposition: z.ZodOptional<z.ZodObject<{
+                            format: z.ZodEnum<{
+                                "tileflow-icon-composition-v1": "tileflow-icon-composition-v1";
+                                "tileflow-icon-composition-v2": "tileflow-icon-composition-v2";
+                            }>;
+                            compositionVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
+                            packageHash: z.ZodString;
+                            contributors: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                                kind: z.ZodLiteral<"local">;
+                                iconIds: z.ZodArray<z.ZodString>;
+                            }, z.core.$strict>, z.ZodObject<{
+                                kind: z.ZodLiteral<"package">;
+                                package: z.ZodString;
+                                iconIds: z.ZodArray<z.ZodString>;
+                            }, z.core.$strict>, z.ZodObject<{
+                                kind: z.ZodLiteral<"icon-set">;
+                                reference: z.ZodString;
+                                teamId: z.ZodString;
+                                setId: z.ZodString;
+                                versionId: z.ZodString;
+                                version: z.ZodNumber;
+                                packageId: z.ZodString;
+                                contentHash: z.ZodString;
+                                iconIds: z.ZodArray<z.ZodString>;
+                            }, z.core.$strict>], "kind">>;
+                            winners: z.ZodArray<z.ZodObject<{
+                                id: z.ZodString;
+                                width: z.ZodNumber;
+                                height: z.ZodNumber;
+                                layout: z.ZodOptional<z.ZodObject<{
+                                    stretchX: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                                    stretchY: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                                    content: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                                }, z.core.$strict>>;
+                                appearance: z.ZodOptional<z.ZodObject<{
+                                    representation: z.ZodLiteral<"sdf">;
+                                    defaults: z.ZodObject<{
+                                        color: z.ZodString;
+                                        haloColor: z.ZodString;
+                                        haloWidth: z.ZodNumber;
+                                        haloBlur: z.ZodNumber;
+                                    }, z.core.$strict>;
+                                }, z.core.$strict>>;
+                                pixelSha256: z.ZodObject<{
+                                    oneX: z.ZodString;
+                                    twoX: z.ZodString;
+                                }, z.core.$strict>;
+                                contributor: z.ZodNumber;
+                            }, z.core.$strict>>;
+                        }, z.core.$strict>>;
+                    }, z.core.$strict>;
+                    systemThemes: z.ZodOptional<z.ZodObject<{
+                        dark: z.ZodString;
+                        light: z.ZodString;
+                    }, z.core.$strict>>;
+                    themes: z.ZodRecord<z.ZodString, z.ZodObject<{
+                        colorScheme: z.ZodEnum<{
+                            dark: "dark";
+                            light: "light";
+                        }>;
+                        dataRequirements: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        sourceRequirements: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        styleSha256: z.ZodString;
+                        themeId: z.ZodString;
+                        themeVersion: z.ZodNumber;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>>;
+                provenance: z.ZodOptional<z.ZodObject<{
+                    schemaVersion: z.ZodLiteral<1>;
+                    lockfile: z.ZodOptional<z.ZodObject<{
+                        format: z.ZodEnum<{
+                            bun: "bun";
+                            npm: "npm";
+                            pnpm: "pnpm";
+                            yarn: "yarn";
+                        }>;
+                        sha256: z.ZodString;
+                    }, z.core.$strict>>;
+                    packages: z.ZodRecord<z.ZodString, z.ZodString>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>;
+            styles: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>;
+        native: z.ZodObject<{
+            buildRecord: z.ZodLazy<z.core.$ZodObject<{
+                schemaVersion: z.ZodLiteral<2>;
+                renderer: z.ZodLiteral<"native">;
+                profile: z.ZodLiteral<"native-v1">;
+                validation: z.ZodLiteral<"static-artifacts">;
+                preparationVersion: z.ZodLiteral<"native-lowering-v1">;
+                engines: z.ZodLazy<z.core.$ZodObject<{
+                    android: z.ZodLiteral<"13.2.0">;
+                    ios: z.ZodLiteral<"6.26.0">;
+                }, z.core.$strict>>;
+                buildManifestSha256: z.ZodString;
+                transformations: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
+                    map: z.ZodString;
+                    theme: z.ZodString;
+                    inputStyleSha256: z.ZodString;
+                    loweredStyleSha256: z.ZodString;
+                    inputLayers: z.ZodNumber;
+                    outputLayers: z.ZodNumber;
+                    projection: z.ZodEnum<{
+                        none: "none";
+                        "mercator-to-implicit": "mercator-to-implicit";
+                        "globe-to-mercator": "globe-to-mercator";
+                    }>;
+                    layers: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
+                        inputLayer: z.ZodNumber;
+                        outputStart: z.ZodNumber;
+                        outputCount: z.ZodNumber;
+                        properties: z.ZodArray<z.ZodEnum<{
+                            "line-dasharray": "line-dasharray";
+                            "line-cap": "line-cap";
+                        }>>;
+                    }, z.core.$strict>>>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>;
+            buildManifest: z.ZodObject<{
+                schemaVersion: z.ZodLiteral<1>;
+                maps: z.ZodRecord<z.ZodString, z.ZodObject<{
+                    assetSetSha256: z.ZodString;
+                    defaultTheme: z.ZodString;
+                    lineage: z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        mapVersion: z.ZodNumber;
+                    }, z.core.$strict>>;
+                    mapRevisionSha256: z.ZodString;
+                    mapRevisionSchemaVersion: z.ZodOptional<z.ZodLiteral<2>>;
+                    mapVersion: z.ZodNumber;
+                    semanticCompiler: z.ZodObject<{
+                        name: z.ZodLiteral<"tileflow-semantic">;
+                        version: z.ZodLiteral<1>;
+                    }, z.core.$strict>;
+                    sourceAssets: z.ZodObject<{
+                        fonts: z.ZodArray<z.ZodObject<{
+                            family: z.ZodString;
+                            sha256: z.ZodString;
+                            style: z.ZodEnum<{
+                                italic: "italic";
+                                normal: "normal";
+                                oblique: "oblique";
+                            }>;
+                            weight: z.ZodEnum<{
+                                100: "100";
+                                200: "200";
+                                300: "300";
+                                400: "400";
+                                500: "500";
+                                600: "600";
+                                700: "700";
+                                800: "800";
+                                900: "900";
+                            }>;
+                        }, z.core.$strict>>;
+                        icons: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                            format: z.ZodEnum<{
+                                jpeg: "jpeg";
+                                png: "png";
+                                svg: "svg";
+                                webp: "webp";
+                            }>;
+                            id: z.ZodString;
+                            kind: z.ZodEnum<{
+                                pattern: "pattern";
+                                icon: "icon";
+                            }>;
+                            sha256: z.ZodString;
+                        }, z.core.$strict>, z.ZodObject<{
+                            kind: z.ZodLiteral<"rendered-icon">;
+                            id: z.ZodString;
+                            appearance: z.ZodOptional<z.ZodObject<{
+                                representation: z.ZodLiteral<"sdf">;
+                                defaults: z.ZodObject<{
+                                    color: z.ZodString;
+                                    haloColor: z.ZodString;
+                                    haloWidth: z.ZodNumber;
+                                    haloBlur: z.ZodNumber;
+                                }, z.core.$strict>;
+                            }, z.core.$strict>>;
+                            layout: z.ZodOptional<z.ZodObject<{
+                                stretchX: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                                stretchY: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                                content: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                            }, z.core.$strict>>;
+                            width: z.ZodNumber;
+                            height: z.ZodNumber;
+                            pixelSha256: z.ZodObject<{
+                                oneX: z.ZodString;
+                                twoX: z.ZodString;
+                            }, z.core.$strict>;
+                        }, z.core.$strict>]>>;
+                        iconComposition: z.ZodOptional<z.ZodObject<{
+                            format: z.ZodEnum<{
+                                "tileflow-icon-composition-v1": "tileflow-icon-composition-v1";
+                                "tileflow-icon-composition-v2": "tileflow-icon-composition-v2";
+                            }>;
+                            compositionVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
+                            packageHash: z.ZodString;
+                            contributors: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                                kind: z.ZodLiteral<"local">;
+                                iconIds: z.ZodArray<z.ZodString>;
+                            }, z.core.$strict>, z.ZodObject<{
+                                kind: z.ZodLiteral<"package">;
+                                package: z.ZodString;
+                                iconIds: z.ZodArray<z.ZodString>;
+                            }, z.core.$strict>, z.ZodObject<{
+                                kind: z.ZodLiteral<"icon-set">;
+                                reference: z.ZodString;
+                                teamId: z.ZodString;
+                                setId: z.ZodString;
+                                versionId: z.ZodString;
+                                version: z.ZodNumber;
+                                packageId: z.ZodString;
+                                contentHash: z.ZodString;
+                                iconIds: z.ZodArray<z.ZodString>;
+                            }, z.core.$strict>], "kind">>;
+                            winners: z.ZodArray<z.ZodObject<{
+                                id: z.ZodString;
+                                width: z.ZodNumber;
+                                height: z.ZodNumber;
+                                layout: z.ZodOptional<z.ZodObject<{
+                                    stretchX: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                                    stretchY: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                                    content: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                                }, z.core.$strict>>;
+                                appearance: z.ZodOptional<z.ZodObject<{
+                                    representation: z.ZodLiteral<"sdf">;
+                                    defaults: z.ZodObject<{
+                                        color: z.ZodString;
+                                        haloColor: z.ZodString;
+                                        haloWidth: z.ZodNumber;
+                                        haloBlur: z.ZodNumber;
+                                    }, z.core.$strict>;
+                                }, z.core.$strict>>;
+                                pixelSha256: z.ZodObject<{
+                                    oneX: z.ZodString;
+                                    twoX: z.ZodString;
+                                }, z.core.$strict>;
+                                contributor: z.ZodNumber;
+                            }, z.core.$strict>>;
+                        }, z.core.$strict>>;
+                    }, z.core.$strict>;
+                    systemThemes: z.ZodOptional<z.ZodObject<{
+                        dark: z.ZodString;
+                        light: z.ZodString;
+                    }, z.core.$strict>>;
+                    themes: z.ZodRecord<z.ZodString, z.ZodObject<{
+                        colorScheme: z.ZodEnum<{
+                            dark: "dark";
+                            light: "light";
+                        }>;
+                        dataRequirements: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        sourceRequirements: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        styleSha256: z.ZodString;
+                        themeId: z.ZodString;
+                        themeVersion: z.ZodNumber;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>>;
+                provenance: z.ZodOptional<z.ZodObject<{
+                    schemaVersion: z.ZodLiteral<1>;
+                    lockfile: z.ZodOptional<z.ZodObject<{
+                        format: z.ZodEnum<{
+                            bun: "bun";
+                            npm: "npm";
+                            pnpm: "pnpm";
+                            yarn: "yarn";
+                        }>;
+                        sha256: z.ZodString;
+                    }, z.core.$strict>>;
+                    packages: z.ZodRecord<z.ZodString, z.ZodString>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>;
+            styles: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type TileflowRendererDeploymentArtifact = z.infer<typeof tileflowRendererDeploymentArtifactSchema>;
+declare class TileflowRendererDeploymentError extends Error {
+    readonly code: "RENDERER_DEPLOYMENT_INVALID";
+    constructor();
+}
+/** Hash/profile verification is deliberately separate from shape validation and server authority. */
+declare function parseTileflowRendererDeploymentArtifact(input: unknown): Promise<TileflowRendererDeploymentArtifact>;
+declare const tileflowRendererDeploymentResponseSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"tileflow-map-deployment-result">;
+    schemaVersion: z.ZodLiteral<2>;
+    changed: z.ZodBoolean;
+    mapId: z.ZodString;
+    deploymentId: z.ZodString;
+    version: z.ZodNumber;
+    worldConversionId: z.ZodOptional<z.ZodString>;
+    renderers: z.ZodObject<{
+        web: z.ZodObject<{
+            themes: z.ZodRecord<z.ZodString, z.ZodObject<{
+                styleId: z.ZodOptional<z.ZodString>;
+                styleUrl: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        native: z.ZodObject<{
+            profile: z.ZodLiteral<"native-v1">;
+            manifestUrl: z.ZodString;
+            themes: z.ZodRecord<z.ZodString, z.ZodObject<{
+                styleUrl: z.ZodString;
+                revision: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type TileflowRendererDeploymentResponse = z.infer<typeof tileflowRendererDeploymentResponseSchema>;
+
 type TileflowCompiledMapMetadata = Pick<ResolvedTileflowMap, 'id' | 'version'> & {
     lineage: readonly TileflowMapBuildLineageEntry[];
 };
@@ -160,4 +571,4 @@ declare function createManifest(catalog: TileflowBuildCatalog, options?: {
     styleBaseUrl?: string;
 }): TileflowRuntimeManifest;
 
-export { type TileflowBuildAssetIdentity, type TileflowBuildCatalog, type TileflowBuildInspectedStyles, type TileflowBuildStyles, type TileflowCompiledMapMetadata, TileflowDataRequirementsV1, type TileflowEffectiveFontSourceIdentity, type TileflowEffectiveIconSourceIdentity, type TileflowEffectiveMapSourceAssets, type TileflowHashableBuildAsset, TileflowInspectedStyle, type TileflowMapBuildInput, type TileflowMapBuildLineageEntry, type TileflowMapBuildManifestEntryV1, type TileflowMapBuildManifestV1, type TileflowMapBuildProvenanceV1, TileflowPreparedMapAssets, TileflowSourceRequirementsV1, type TileflowThemeBuildManifestEntryV1, collectTileflowMapBuildLineage, createManifest, createStyleFromCatalog, createStyleFromCatalogWithInspection, createStyleWithInspection, createStylesFromCatalog, createStylesFromCatalogWithInspection, createTileflowMapBuildManifest, hashTileflowAssetSet, hashTileflowAssetSetIdentities, hashTileflowMapRevision, tileflowMapBuildManifestFileName, tileflowMapBuildManifestSchemaVersion, tileflowMapRevisionCanonicalization, tileflowMapRevisionSchemaVersion, tileflowSharedIconMapRevisionSchemaVersion };
+export { type TileflowBuildAssetIdentity, type TileflowBuildCatalog, type TileflowBuildInspectedStyles, type TileflowBuildStyles, type TileflowCompiledMapMetadata, TileflowDataRequirementsV1, type TileflowEffectiveFontSourceIdentity, type TileflowEffectiveIconSourceIdentity, type TileflowEffectiveMapSourceAssets, type TileflowHashableBuildAsset, TileflowInspectedStyle, type TileflowMapBuildInput, type TileflowMapBuildLineageEntry, type TileflowMapBuildManifestEntryV1, type TileflowMapBuildManifestV1, type TileflowMapBuildProvenanceV1, TileflowPreparedMapAssets, type TileflowRendererDeploymentArtifact, TileflowRendererDeploymentError, type TileflowRendererDeploymentResponse, TileflowSourceRequirementsV1, type TileflowThemeBuildManifestEntryV1, collectTileflowMapBuildLineage, createManifest, createStyleFromCatalog, createStyleFromCatalogWithInspection, createStyleWithInspection, createStylesFromCatalog, createStylesFromCatalogWithInspection, createTileflowMapBuildManifest, hashTileflowAssetSet, hashTileflowAssetSetIdentities, hashTileflowMapRevision, parseTileflowRendererDeploymentArtifact, tileflowMapBuildManifestFileName, tileflowMapBuildManifestSchemaVersion, tileflowMapRevisionCanonicalization, tileflowMapRevisionSchemaVersion, tileflowRendererDeploymentArtifactSchema, tileflowRendererDeploymentLimits, tileflowRendererDeploymentResponseSchema, tileflowSharedIconMapRevisionSchemaVersion };