@tileflow/core 0.1.0-alpha.44 → 0.1.0-alpha.45

package/dist/{manifest-types-CwjHd4qc.d.ts → manifest-types-GeYn0SQM.d.ts}

@@ -645,6 +645,10 @@ type MapLibreStyle = {
     version: 8;
     name: string;
     glyphs?: string;
+    'font-faces'?: Record<string, string | {
+        url: string;
+        'unicode-range'?: string[];
+    }>;
     light?: TileflowLight;
     projection?: {
         type: TileflowProjection;
@@ -672,6 +676,96 @@ type TileflowTimeOfDay = (typeof tileflowTimesOfDay)[number];
 type TileflowTimeOfDayVariants = Readonly<Record<string, Readonly<Partial<Record<TileflowTimeOfDay, string>>>>>;
 declare function isTileflowTimeOfDay(value: unknown): value is TileflowTimeOfDay;
 
+type Json = null | boolean | number | string | Json[] | {
+    [key: string]: Json;
+};
+type TileflowFamilyUpdate = readonly [layer: number, property: string];
+/** A shared cartography document. Parameter columns are storage identities, not color tokens. */
+type TileflowStyleFamily = Readonly<{
+    kind: 'tileflow-style-family';
+    version: 1;
+    themes: readonly string[];
+    template: Json;
+    parameters: readonly (readonly Json[])[];
+    /** Literal shared subtrees. Entries are never interpreted as references. */
+    constants: readonly Json[];
+    updates: Readonly<{
+        /** False means that this family contains structural alternatives requiring a style change. */
+        appearanceOnly: boolean;
+        paint: readonly TileflowFamilyUpdate[];
+        roots: readonly ('light' | 'sky')[];
+    }>;
+}>;
+declare const tileflowStyleFamilyLimits: Readonly<{
+    themes: 64;
+    documentBytes: number;
+    expandedStyleBytes: number;
+    expandedFamilyBytes: number;
+    layers: 4096;
+    nodes: 500000;
+    depth: 96;
+}>;
+/** Factor identical JSON structure and repeated variant columns without guessing token identity. */
+declare function createTileflowStyleFamily(styles: Readonly<Record<string, MapLibreStyle>>): TileflowStyleFamily;
+/** Validate budgets before materializing; malformed or oversized input never reaches a renderer. */
+declare function parseTileflowStyleFamily(input: unknown): TileflowStyleFamily;
+/** Export one conventional MapLibre JSON. The result is detached from the shared document. */
+declare function materializeTileflowStyleFamily(family: TileflowStyleFamily, theme: string): MapLibreStyle;
+/** Expand at a trust boundary when a consumer requires conventional style documents. */
+declare function expandTileflowStyleFamily(input: unknown): Record<string, MapLibreStyle>;
+/** Expand shared literals once when a build/delivery pass needs to inspect the template. */
+declare function expandTileflowFamilyTemplate(family: TileflowStyleFamily): Json;
+/** Repack a resource-rewritten template while retaining and verifying its update contract. */
+declare function withTileflowFamilyTemplate(family: TileflowStyleFamily, template: unknown): TileflowStyleFamily;
+
+/** Read a shared family with a strict streaming bound; caller owns cache and request lifetime. */
+declare function loadTileflowStyleFamily(url: string, options?: {
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}): Promise<TileflowStyleFamily>;
+
+type TileflowColorOverrides = Readonly<Record<string, string>>;
+/** Reevaluate only explicit colour programs; fixed values and application-owned layers are untouched. */
+declare function applyTileflowColorOverrides(style: MapLibreStyle, overrides: TileflowColorOverrides): MapLibreStyle;
+
+/** Prepare feature-dependent paint once, before the first style is installed in the renderer. */
+declare function prepareTileflowStyleFamilyForRendering(family: TileflowStyleFamily): TileflowStyleFamily;
+
+/** Resolve document-relative assets without fetching textures, tiles or models ahead of demand. */
+declare function resolveTileflowStyleResourceUrls(style: MapLibreStyle, documentUrl: string): MapLibreStyle;
+declare function resolveTileflowFamilyResourceUrls(family: TileflowStyleFamily, documentUrl: string): TileflowStyleFamily;
+/** Prepare the initial appearance before constructing MapLibre; subsequent changes reuse this family. */
+declare function loadTileflowRuntimeAppearance(style: TileflowRuntimeStyle, options?: {
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}): Promise<TileflowRuntimeStyle>;
+
+type TileflowAppearanceSelection = Readonly<{
+    palette?: string;
+} & ({
+    mode: 'fixed';
+    moment?: TileflowTimeOfDay;
+} | {
+    mode: 'system';
+    light: TileflowTimeOfDay;
+    dark: TileflowTimeOfDay;
+} | {
+    mode: 'clock';
+    schedule: readonly Readonly<{
+        hour: number;
+        moment: TileflowTimeOfDay;
+    }>[];
+    blend?: boolean;
+})>;
+/** Resolve artistic time presets. Device dark mode and local clock are independent inputs. */
+declare function resolveTileflowAppearance(map: TileflowRuntimeManifestMap, selection: TileflowAppearanceSelection, context: {
+    date: Date;
+    colorScheme: 'light' | 'dark';
+}): Readonly<{
+    themes: readonly string[];
+    position: number;
+}>;
+
 declare const defaultTileflowManifestUrl = "/tileflow/manifest.json";
 declare const defaultTileflowRuntimeView: Readonly<{
     bearing: 0;
@@ -724,6 +818,9 @@ type TileflowResolvedRuntimeTheme = TileflowRuntimeManifestTheme & {
     name: string;
 };
 type TileflowRuntimeStyle = {
+    /** Shared validated family used for appearance updates without replacing the style. */
+    family?: TileflowStyleFamily;
+    familyUrl?: string;
     analytics?: TileflowAnalytics;
     colorScheme?: TileflowRuntimeColorScheme;
     /** An explicit empty array means the manifest declares that no web fonts are required. */
@@ -867,6 +964,7 @@ declare function inferTileflowAnalyticsFromStyleUrl(styleUrl: string): TileflowA
 declare const tileflowRuntimeManifestVersion: 1;
 /** V2 adds the optional time-of-day catalog; maps without it still publish V1. */
 declare const tileflowTimeOfDayManifestVersion: 2;
+declare const tileflowFamilyManifestVersion: 3;
 declare const tileflowRuntimeManifestLimits: Readonly<{
     maximumBytes: number;
 }>;
@@ -886,6 +984,8 @@ type TileflowRuntimeSystemThemes = {
     light: string;
 };
 type TileflowRuntimeManifestMapEntry = {
+    /** One shared document for every appearance; styleUrl remains the flat export. */
+    familyUrl?: string;
     apiUrl?: string;
     defaultTheme: string;
     environment?: string;
@@ -906,7 +1006,7 @@ type TileflowRuntimeManifestMapEntry = {
 type TileflowRuntimeManifest = {
     apiUrl?: string;
     maps: Record<string, TileflowRuntimeManifestMapEntry>;
-    version: typeof tileflowRuntimeManifestVersion | typeof tileflowTimeOfDayManifestVersion;
+    version: typeof tileflowRuntimeManifestVersion | typeof tileflowTimeOfDayManifestVersion | typeof tileflowFamilyManifestVersion;
 };
 
-export { type TileflowLineLayout as $, type TileflowAerodromeCodeDetail as A, type TileflowAlignment as B, type TileflowAnalytics as C, type TileflowAreaStyle as D, type TileflowBackgroundPaint as E, type TileflowCirclePaint as F, type TileflowColor as G, type TileflowColorStyleValue as H, type TileflowExtrusionPaint as I, type TileflowFillPaint as J, type TileflowIconAnchor as K, type TileflowIconLayout as L, type MapLibreStyle as M, type TileflowIconPaint as N, type TileflowIconStyle as O, type TileflowIconTextFit as P, type TileflowImageStyleValue as Q, type TileflowLabelDetail as R, type TileflowLabelLanguage as S, type TileflowRuntimeManifest as T, type TileflowLabelStyles as U, type ValidationMessage as V, type TileflowLayerRange as W, type TileflowLight as X, type TileflowLineCap as Y, type TileflowLineHatchStyle as Z, type TileflowLineJoin as _, type TileflowRuntimeColorScheme as a, type TileflowTerrainContoursConfig as a$, type TileflowLinePaint as a0, type TileflowLineStackStyle as a1, type TileflowManifestFetchOptions as a2, type TileflowManifestLoadOptions as a3, type TileflowMapMode as a4, type TileflowMapModeOptions as a5, type TileflowMarkerSymbolStyle as a6, type TileflowMountainBikeScale as a7, type TileflowNumberInsetsStyleValue as a8, type TileflowNumberStyleValue as a9, type TileflowRoadStreetLightStyle as aA, type TileflowRoadStructure as aB, type TileflowRoadTreatmentLayerStyle as aC, type TileflowRoadTreatmentLineStyle as aD, type TileflowRoadTreatmentStyle as aE, type TileflowRoadWeight as aF, type TileflowRuntimeCenterLike as aG, type TileflowRuntimeManifestMap as aH, type TileflowRuntimeSource as aI, type TileflowRuntimeSourceValidation as aJ, type TileflowRuntimeStyle as aK, type TileflowRuntimeStyleOptions as aL, type TileflowRuntimeViewOptions as aM, type TileflowSessionController as aN, type TileflowSessionGrantResponse as aO, type TileflowStringStyleValue as aP, type TileflowStructuralStyleValue as aQ, type TileflowStyleFontFace as aR, type TileflowStyleValue as aS, type TileflowSymbolOverlap as aT, type TileflowSymbolPlacement as aU, type TileflowSymbolPlacementStyle as aV, type TileflowSymbolZOrder as aW, type TileflowTerrain as aX, type TileflowTerrainConfig as aY, type TileflowTerrainContourLabelStyle as aZ, type TileflowTerrainContourLineStyle as a_, type TileflowPlaceLabelClass as aa, type TileflowPoiCategory as ab, type TileflowPoiCategoryStyle as ac, type TileflowPoiColorMode as ad, type TileflowPoiDensity as ae, type TileflowPoiPlacementOrder as af, type TileflowPriorityOrder as ag, type TileflowProjection as ah, type TileflowResolvedRuntimeTheme as ai, type TileflowRoadAreaStyle as aj, type TileflowRoadClass as ak, type TileflowRoadClassStyle as al, type TileflowRoadCrossingStyle as am, type TileflowRoadDetail as an, type TileflowRoadExtras as ao, type TileflowRoadHierarchy as ap, type TileflowRoadLabelDetail as aq, type TileflowRoadLayerStyle as ar, type TileflowRoadModifier as as, type TileflowRoadOutline as at, type TileflowRoadRestriction as au, type TileflowRoadRoundaboutStyle as av, type TileflowRoadServiceType as aw, type TileflowRoadShieldDetail as ax, type TileflowRoadShieldStyles as ay, type TileflowRoadSidewalkStyle as az, type TileflowRuntimeManifestMapEntry as b, zoom as b$, type TileflowTerrainEncoding as b0, type TileflowTerrainHillshadeStyle as b1, type TileflowTerrainLayerRange as b2, type TileflowTerrainMode as b3, type TileflowTextAnchor as b4, type TileflowTextBackground as b5, type TileflowTextJustify as b6, type TileflowTextLayout as b7, type TileflowTextPaint as b8, type TileflowTextStyle as b9, isTileflowTimeOfDay as bA, loadTileflowManifest as bB, mergeTileflowAnalytics as bC, nearestTileflowBlendTheme as bD, normalizeTileflowRuntimeCenter as bE, normalizeTileflowStaticImageSize as bF, normalizeTileflowUrl as bG, resolveTileflowAnalyticsRequestUrl as bH, resolveTileflowManifestMap as bI, resolveTileflowMapMode as bJ, resolveTileflowRuntimeStyle as bK, resolveTileflowRuntimeTheme as bL, resolveTileflowRuntimeThemeBlend as bM, resolveTileflowRuntimeView as bN, resolveTileflowStaticImageUrl as bO, shouldLoadTileflowManifest as bP, startTileflowSession as bQ, tileflowPoiCategories as bR, tileflowStyleFontFaceLimits as bS, tileflowStyleFontFacesMetadataKey as bT, tileflowThemeBlendLimits as bU, tileflowThemeTokenCategories as bV, tileflowTimesOfDay as bW, token as bX, validateTileflowRuntimeSource as bY, validateTileflowThemeBlendSelection as bZ, validateTileflowThemeSelection as b_, type TileflowThemeBlendSelection as ba, type TileflowThemeColorAlpha as bb, type TileflowThemeColorMix as bc, type TileflowThemeColorValue as bd, type TileflowThemeFontValue as be, type TileflowThemeImageValue as bf, type TileflowThemeNumberValue as bg, type TileflowThemeSelection as bh, type TileflowThemeTokenCategory as bi, type TileflowThemeValue as bj, type TileflowViewConfig as bk, type TileflowWaterLabelClass as bl, type TileflowZoomInterpolation as bm, type TileflowZoomValue as bn, type ValidationResult as bo, assertValidTileflowRuntimeSource as bp, clearTileflowManifestCache as bq, color as br, createTileflowSessionController as bs, createTileflowSessionId as bt, defaultTileflowManifestUrl as bu, defaultTileflowRuntimeView as bv, fixed as bw, getTileflowAnalyticsApiUrl as bx, getTileflowStyleFontFaces as by, inferTileflowAnalyticsFromStyleUrl as bz, type TileflowRuntimeManifestTheme as c, type TileflowTypographyStyle as c0, type ResolvedTileflowTypography as c1, normalizeTileflowSurfaceId as c2, type TileflowRuntimeSystemThemes as d, type TileflowTimeOfDay as e, type TileflowTimeOfDayVariants as f, tileflowRuntimeManifestVersion as g, tileflowTimeOfDayManifestVersion as h, type TileflowExpression as i, type TileflowFixedValue as j, type TileflowThemeTokenReference as k, type TileflowThemeColorOperation as l, type TileflowBackgroundStyle as m, type TileflowCircleStyle as n, type TileflowExtrusionStyle as o, type TileflowFillStyle as p, type TileflowLineStyle as q, type TileflowSymbolStyle as r, type TileflowRoadsModuleOptions as s, tileflowRuntimeManifestLimits as t, type TileflowRoadsModuleConfig as u, type TileflowLabelsModuleOptions as v, type TileflowLabelsModuleConfig as w, type TileflowPoiModuleOptions as x, type TileflowPoiModuleConfig as y, type MapLibreSprite as z };
+export { type TileflowImageStyleValue as $, type TileflowLineStyle as A, type TileflowSymbolStyle as B, type TileflowRoadsModuleOptions as C, type TileflowRoadsModuleConfig as D, type TileflowLabelsModuleOptions as E, type TileflowLabelsModuleConfig as F, type TileflowPoiModuleOptions as G, type TileflowPoiModuleConfig as H, type MapLibreSprite as I, type TileflowAerodromeCodeDetail as J, type TileflowAlignment as K, type TileflowAnalytics as L, type MapLibreStyle as M, type TileflowAreaStyle as N, type TileflowBackgroundPaint as O, type TileflowCirclePaint as P, type TileflowColor as Q, type TileflowColorStyleValue as R, type TileflowExtrusionPaint as S, type TileflowRuntimeManifest as T, type TileflowFillPaint as U, type ValidationMessage as V, type TileflowIconAnchor as W, type TileflowIconLayout as X, type TileflowIconPaint as Y, type TileflowIconStyle as Z, type TileflowIconTextFit as _, type TileflowRuntimeColorScheme as a, type TileflowStyleValue as a$, type TileflowLabelDetail as a0, type TileflowLabelLanguage as a1, type TileflowLabelStyles as a2, type TileflowLayerRange as a3, type TileflowLight as a4, type TileflowLineCap as a5, type TileflowLineHatchStyle as a6, type TileflowLineJoin as a7, type TileflowLineLayout as a8, type TileflowLinePaint as a9, type TileflowRoadLayerStyle as aA, type TileflowRoadModifier as aB, type TileflowRoadOutline as aC, type TileflowRoadRestriction as aD, type TileflowRoadRoundaboutStyle as aE, type TileflowRoadServiceType as aF, type TileflowRoadShieldDetail as aG, type TileflowRoadShieldStyles as aH, type TileflowRoadSidewalkStyle as aI, type TileflowRoadStreetLightStyle as aJ, type TileflowRoadStructure as aK, type TileflowRoadTreatmentLayerStyle as aL, type TileflowRoadTreatmentLineStyle as aM, type TileflowRoadTreatmentStyle as aN, type TileflowRoadWeight as aO, type TileflowRuntimeCenterLike as aP, type TileflowRuntimeManifestMap as aQ, type TileflowRuntimeSource as aR, type TileflowRuntimeSourceValidation as aS, type TileflowRuntimeStyle as aT, type TileflowRuntimeStyleOptions as aU, type TileflowRuntimeViewOptions as aV, type TileflowSessionController as aW, type TileflowSessionGrantResponse as aX, type TileflowStringStyleValue as aY, type TileflowStructuralStyleValue as aZ, type TileflowStyleFontFace as a_, type TileflowLineStackStyle as aa, type TileflowManifestFetchOptions as ab, type TileflowManifestLoadOptions as ac, type TileflowMapMode as ad, type TileflowMapModeOptions as ae, type TileflowMarkerSymbolStyle as af, type TileflowMountainBikeScale as ag, type TileflowNumberInsetsStyleValue as ah, type TileflowNumberStyleValue as ai, type TileflowPlaceLabelClass as aj, type TileflowPoiCategory as ak, type TileflowPoiCategoryStyle as al, type TileflowPoiColorMode as am, type TileflowPoiDensity as an, type TileflowPoiPlacementOrder as ao, type TileflowPriorityOrder as ap, type TileflowProjection as aq, type TileflowResolvedRuntimeTheme as ar, type TileflowRoadAreaStyle as as, type TileflowRoadClass as at, type TileflowRoadClassStyle as au, type TileflowRoadCrossingStyle as av, type TileflowRoadDetail as aw, type TileflowRoadExtras as ax, type TileflowRoadHierarchy as ay, type TileflowRoadLabelDetail as az, type TileflowRuntimeManifestMapEntry as b, tileflowStyleFontFaceLimits as b$, type TileflowSymbolOverlap as b0, type TileflowSymbolPlacement as b1, type TileflowSymbolPlacementStyle as b2, type TileflowSymbolZOrder as b3, type TileflowTerrain as b4, type TileflowTerrainConfig as b5, type TileflowTerrainContourLabelStyle as b6, type TileflowTerrainContourLineStyle as b7, type TileflowTerrainContoursConfig as b8, type TileflowTerrainEncoding as b9, color as bA, createTileflowSessionController as bB, createTileflowSessionId as bC, defaultTileflowManifestUrl as bD, defaultTileflowRuntimeView as bE, fixed as bF, getTileflowAnalyticsApiUrl as bG, getTileflowStyleFontFaces as bH, inferTileflowAnalyticsFromStyleUrl as bI, isTileflowTimeOfDay as bJ, loadTileflowManifest as bK, mergeTileflowAnalytics as bL, nearestTileflowBlendTheme as bM, normalizeTileflowRuntimeCenter as bN, normalizeTileflowStaticImageSize as bO, normalizeTileflowUrl as bP, resolveTileflowAnalyticsRequestUrl as bQ, resolveTileflowManifestMap as bR, resolveTileflowMapMode as bS, resolveTileflowRuntimeStyle as bT, resolveTileflowRuntimeTheme as bU, resolveTileflowRuntimeThemeBlend as bV, resolveTileflowRuntimeView as bW, resolveTileflowStaticImageUrl as bX, shouldLoadTileflowManifest as bY, startTileflowSession as bZ, tileflowPoiCategories as b_, type TileflowTerrainHillshadeStyle as ba, type TileflowTerrainLayerRange as bb, type TileflowTerrainMode as bc, type TileflowTextAnchor as bd, type TileflowTextBackground as be, type TileflowTextJustify as bf, type TileflowTextLayout as bg, type TileflowTextPaint as bh, type TileflowTextStyle as bi, type TileflowThemeBlendSelection as bj, type TileflowThemeColorAlpha as bk, type TileflowThemeColorMix as bl, type TileflowThemeColorValue as bm, type TileflowThemeFontValue as bn, type TileflowThemeImageValue as bo, type TileflowThemeNumberValue as bp, type TileflowThemeSelection as bq, type TileflowThemeTokenCategory as br, type TileflowThemeValue as bs, type TileflowViewConfig as bt, type TileflowWaterLabelClass as bu, type TileflowZoomInterpolation as bv, type TileflowZoomValue as bw, type ValidationResult as bx, assertValidTileflowRuntimeSource as by, clearTileflowManifestCache as bz, type TileflowRuntimeManifestTheme as c, tileflowStyleFontFacesMetadataKey as c0, tileflowThemeBlendLimits as c1, tileflowThemeTokenCategories as c2, tileflowTimesOfDay as c3, token as c4, validateTileflowRuntimeSource as c5, validateTileflowThemeBlendSelection as c6, validateTileflowThemeSelection as c7, zoom as c8, type TileflowTypographyStyle as c9, type ResolvedTileflowTypography as ca, type TileflowAppearanceSelection as cb, type TileflowColorOverrides as cc, applyTileflowColorOverrides as cd, loadTileflowRuntimeAppearance as ce, loadTileflowStyleFamily as cf, normalizeTileflowSurfaceId as cg, prepareTileflowStyleFamilyForRendering as ch, resolveTileflowAppearance as ci, resolveTileflowFamilyResourceUrls as cj, resolveTileflowStyleResourceUrls as ck, type TileflowRuntimeSystemThemes as d, type TileflowTimeOfDay as e, type TileflowTimeOfDayVariants as f, tileflowRuntimeManifestLimits as g, tileflowRuntimeManifestVersion as h, tileflowTimeOfDayManifestVersion as i, type TileflowStyleFamily as j, createTileflowStyleFamily as k, expandTileflowFamilyTemplate as l, expandTileflowStyleFamily as m, materializeTileflowStyleFamily as n, tileflowStyleFamilyLimits as o, parseTileflowStyleFamily as p, type TileflowExpression as q, type TileflowFixedValue as r, type TileflowThemeTokenReference as s, tileflowFamilyManifestVersion as t, type TileflowThemeColorOperation as u, type TileflowBackgroundStyle as v, withTileflowFamilyTemplate as w, type TileflowCircleStyle as x, type TileflowExtrusionStyle as y, type TileflowFillStyle as z };

package/dist/manifest.d.ts

@@ -1,6 +1,6 @@
-import { T as TileflowRuntimeManifest } from './manifest-types-CwjHd4qc.js';
-export { a as TileflowRuntimeColorScheme, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, d as TileflowRuntimeSystemThemes, e as TileflowTimeOfDay, f as TileflowTimeOfDayVariants, t as tileflowRuntimeManifestLimits, g as tileflowRuntimeManifestVersion, h as tileflowTimeOfDayManifestVersion } from './manifest-types-CwjHd4qc.js';
 import { z } from 'zod';
+import { T as TileflowRuntimeManifest } from './manifest-types-GeYn0SQM.js';
+export { a as TileflowRuntimeColorScheme, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, d as TileflowRuntimeSystemThemes, e as TileflowTimeOfDay, f as TileflowTimeOfDayVariants, t as tileflowFamilyManifestVersion, g as tileflowRuntimeManifestLimits, h as tileflowRuntimeManifestVersion, i as tileflowTimeOfDayManifestVersion } from './manifest-types-GeYn0SQM.js';
 
 declare const tileflowRuntimeManifestSchema: z.ZodType<TileflowRuntimeManifest>;
 declare function parseTileflowRuntimeManifest(input: unknown): TileflowRuntimeManifest;

package/dist/manifest.js

@@ -1,6 +1,7 @@
 // src/manifest-types.ts
 var tileflowRuntimeManifestVersion = 1;
 var tileflowTimeOfDayManifestVersion = 2;
+var tileflowFamilyManifestVersion = 3;
 var tileflowRuntimeManifestLimits = Object.freeze({ maximumBytes: 1024 * 1024 });
 
 // src/portable-identity-rules.ts
@@ -160,6 +161,7 @@ function createTileflowRuntimeManifestSchema(primitives, operations, identities
       apiUrl: operations.optional(apiOriginSchema),
       defaultTheme: tileflowThemeNameSchema2,
       environment: operations.optional(operations.maxLength(safeTextSchema, 128)),
+      familyUrl: operations.optional(publicResourceUrlSchema),
       mapId: operations.optional(operations.maxLength(safeTextSchema, 128)),
       systemThemes: operations.optional(
         operations.object({
@@ -241,11 +243,20 @@ function createTileflowRuntimeManifestSchema(primitives, operations, identities
       maps: operations.record(tileflowPortableIdSchema2, manifestMapSchema),
       version: operations.union(
         operations.literal(tileflowRuntimeManifestVersion),
-        operations.literal(2)
+        operations.union(operations.literal(2), operations.literal(3))
       )
     }),
     (manifest, context) => {
       const mapCount = Object.keys(manifest.maps).length;
+      if (manifest.version !== 3)
+        for (const [name, map] of Object.entries(manifest.maps)) {
+          if (map.familyUrl !== void 0)
+            context.addIssue({
+              code: "custom",
+              message: "familyUrl requires manifest version 3",
+              path: ["maps", name, "familyUrl"]
+            });
+        }
       if (manifest.version === 1) {
         for (const [name, map] of Object.entries(manifest.maps)) {
           if (map.timeOfDay !== void 0)
@@ -442,6 +453,7 @@ function safeParseTileflowRuntimeManifest(input) {
 export {
   parseTileflowRuntimeManifest,
   safeParseTileflowRuntimeManifest,
+  tileflowFamilyManifestVersion,
   tileflowRuntimeManifestLimits,
   tileflowRuntimeManifestSchema,
   tileflowRuntimeManifestVersion,

package/dist/native-profile.d.ts

@@ -38,6 +38,10 @@ type MapLibreStyle = {
     version: 8;
     name: string;
     glyphs?: string;
+    'font-faces'?: Record<string, string | {
+        url: string;
+        'unicode-range'?: string[];
+    }>;
     light?: TileflowLight;
     projection?: {
         type: TileflowProjection;

package/dist/native.d.ts

@@ -55,6 +55,10 @@ type MapLibreStyle = {
     version: 8;
     name: string;
     glyphs?: string;
+    'font-faces'?: Record<string, string | {
+        url: string;
+        'unicode-range'?: string[];
+    }>;
     light?: TileflowLight;
     projection?: {
         type: TileflowProjection;
@@ -103,6 +107,7 @@ declare function nearestTileflowBlendTheme(blend: TileflowThemeBlendSelection):
 declare const tileflowRuntimeManifestVersion: 1;
 /** V2 adds the optional time-of-day catalog; maps without it still publish V1. */
 declare const tileflowTimeOfDayManifestVersion: 2;
+declare const tileflowFamilyManifestVersion: 3;
 type TileflowRuntimeColorScheme = 'dark' | 'light';
 type TileflowRuntimeManifestTheme = {
     colorScheme: TileflowRuntimeColorScheme;
@@ -119,6 +124,8 @@ type TileflowRuntimeSystemThemes = {
     light: string;
 };
 type TileflowRuntimeManifestMapEntry = {
+    /** One shared document for every appearance; styleUrl remains the flat export. */
+    familyUrl?: string;
     apiUrl?: string;
     defaultTheme: string;
     environment?: string;
@@ -139,7 +146,7 @@ type TileflowRuntimeManifestMapEntry = {
 type TileflowRuntimeManifest = {
     apiUrl?: string;
     maps: Record<string, TileflowRuntimeManifestMapEntry>;
-    version: typeof tileflowRuntimeManifestVersion | typeof tileflowTimeOfDayManifestVersion;
+    version: typeof tileflowRuntimeManifestVersion | typeof tileflowTimeOfDayManifestVersion | typeof tileflowFamilyManifestVersion;
 };
 
 /** The adapter must honor the requested read bound, without first buffering an unbounded body. */

package/dist/native.js

@@ -4086,6 +4086,18 @@ var init_runtime_view_schema = __esm({
   }
 });
 
+// src/color-program.ts
+function isColorProgramMarker(value) {
+  return Array.isArray(value) && value.length === 6 && value[0] === "let" && value[1] === marker && Array.isArray(value[2]) && value[2][0] === "literal";
+}
+var marker;
+var init_color_program = __esm({
+  "src/color-program.ts"() {
+    "use strict";
+    marker = "__tileflow_color_program";
+  }
+});
+
 // src/theme-blend.ts
 function planTileflowThemeBlend(styles, options = {}) {
   if (styles.length < 2)
@@ -4248,12 +4260,16 @@ function planTileflowThemeBlend(styles, options = {}) {
     }
     function splitLayer() {
       if (isLegacyFilter(layer.filter)) return void 0;
+      const values = driven.map(
+        (property) => [
+          property,
+          variants.map((variant) => inlineBranchBindings(paintOf(variant)[property]))
+        ]
+      );
+      if (values.some(([, entries]) => entries.some((entry) => !entry))) return void 0;
       const branches = splitBranches(
         Object.fromEntries(
-          driven.map((property) => [
-            property,
-            variants.map((variant) => paintOf(variant)[property])
-          ])
+          values.map(([property, entries]) => [property, entries.map((entry) => entry.value)])
         )
       );
       if (!branches) return void 0;
@@ -4263,8 +4279,8 @@ function planTileflowThemeBlend(styles, options = {}) {
         let group = groups.get(key);
         if (!group) {
           const templates = {};
-          for (const [property, values] of Object.entries(branch.valuesByProperty)) {
-            const template = tryMixTemplate(values);
+          for (const [property, values2] of Object.entries(branch.valuesByProperty)) {
+            const template = tryMixTemplate(values2);
             if (template === void 0) return void 0;
             templates[property] = template;
           }
@@ -4633,6 +4649,38 @@ function splitBranches(valuesByProperty, conditions = []) {
   }
   return branches;
 }
+function inlineBranchBindings(input) {
+  const limit = 2e4;
+  const visit = (node, scope, depth) => {
+    if (depth > 96) throw new RangeError("Expression nesting limit");
+    if (!Array.isArray(node) || node[0] === "literal" || isColorProgramMarker(node))
+      return { value: node, size: 1 };
+    if (node[0] === "var") {
+      const bound = scope.get(String(node[1]));
+      if (!bound) throw new TypeError("Unbound branch variable");
+      return bound;
+    }
+    if (node[0] === "let") {
+      const inner = new Map(scope);
+      for (let index = 1; index < node.length - 1; index += 2)
+        inner.set(String(node[index]), visit(node[index + 1], scope, depth + 1));
+      return visit(node.at(-1), inner, depth + 1);
+    }
+    let size = 1;
+    const value = node.map((child) => {
+      const result = visit(child, scope, depth + 1);
+      size += result.size;
+      if (size > limit) throw new RangeError("Expanded branch limit");
+      return result.value;
+    });
+    return { value, size };
+  };
+  try {
+    return { value: visit(input, /* @__PURE__ */ new Map(), 0).value };
+  } catch {
+    return void 0;
+  }
+}
 function scaleByWeight(opacity, weight) {
   const input = Array.isArray(opacity) ? opacity[0] === "interpolate" ? opacity[2] : opacity[1] : void 0;
   if (Array.isArray(opacity) && (opacity[0] === "interpolate" || opacity[0] === "step") && reads(input, "zoom")) {
@@ -4726,6 +4774,7 @@ var TileflowThemeBlendError, BlendLeaf, imageProperties, opacityProperties, feat
 var init_theme_blend = __esm({
   "src/theme-blend.ts"() {
     "use strict";
+    init_color_program();
     TileflowThemeBlendError = class extends Error {
       constructor() {
         super(...arguments);
@@ -4909,6 +4958,7 @@ function createTileflowRuntimeManifestSchema(primitives, operations, identities
       apiUrl: operations.optional(apiOriginSchema),
       defaultTheme: tileflowThemeNameSchema,
       environment: operations.optional(operations.maxLength(safeTextSchema, 128)),
+      familyUrl: operations.optional(publicResourceUrlSchema),
       mapId: operations.optional(operations.maxLength(safeTextSchema, 128)),
       systemThemes: operations.optional(
         operations.object({
@@ -4990,11 +5040,20 @@ function createTileflowRuntimeManifestSchema(primitives, operations, identities
       maps: operations.record(tileflowPortableIdSchema, manifestMapSchema),
       version: operations.union(
         operations.literal(tileflowRuntimeManifestVersion),
-        operations.literal(2)
+        operations.union(operations.literal(2), operations.literal(3))
       )
     }),
     (manifest, context) => {
       const mapCount = Object.keys(manifest.maps).length;
+      if (manifest.version !== 3)
+        for (const [name, map2] of Object.entries(manifest.maps)) {
+          if (map2.familyUrl !== void 0)
+            context.addIssue({
+              code: "custom",
+              message: "familyUrl requires manifest version 3",
+              path: ["maps", name, "familyUrl"]
+            });
+        }
       if (manifest.version === 1) {
         for (const [name, map2] of Object.entries(manifest.maps)) {
           if (map2.timeOfDay !== void 0)

package/dist/runtime.d.ts

@@ -1 +1 @@
-export { C as TileflowAnalytics, a2 as TileflowManifestFetchOptions, a3 as TileflowManifestLoadOptions, a4 as TileflowMapMode, a5 as TileflowMapModeOptions, ai as TileflowResolvedRuntimeTheme, aG as TileflowRuntimeCenterLike, a as TileflowRuntimeColorScheme, T as TileflowRuntimeManifest, aH as TileflowRuntimeManifestMap, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, aI as TileflowRuntimeSource, aJ as TileflowRuntimeSourceValidation, aK as TileflowRuntimeStyle, aL as TileflowRuntimeStyleOptions, d as TileflowRuntimeSystemThemes, aM as TileflowRuntimeViewOptions, aN as TileflowSessionController, aO as TileflowSessionGrantResponse, aR as TileflowStyleFontFace, ba as TileflowThemeBlendSelection, bh as TileflowThemeSelection, e as TileflowTimeOfDay, f as TileflowTimeOfDayVariants, bp as assertValidTileflowRuntimeSource, bq as clearTileflowManifestCache, bs as createTileflowSessionController, bt as createTileflowSessionId, bu as defaultTileflowManifestUrl, bv as defaultTileflowRuntimeView, bx as getTileflowAnalyticsApiUrl, by as getTileflowStyleFontFaces, bz as inferTileflowAnalyticsFromStyleUrl, bA as isTileflowTimeOfDay, bB as loadTileflowManifest, bC as mergeTileflowAnalytics, bD as nearestTileflowBlendTheme, bE as normalizeTileflowRuntimeCenter, bF as normalizeTileflowStaticImageSize, c2 as normalizeTileflowSurfaceId, bG as normalizeTileflowUrl, bH as resolveTileflowAnalyticsRequestUrl, bI as resolveTileflowManifestMap, bJ as resolveTileflowMapMode, bK as resolveTileflowRuntimeStyle, bL as resolveTileflowRuntimeTheme, bM as resolveTileflowRuntimeThemeBlend, bN as resolveTileflowRuntimeView, bO as resolveTileflowStaticImageUrl, bP as shouldLoadTileflowManifest, bQ as startTileflowSession, bS as tileflowStyleFontFaceLimits, bT as tileflowStyleFontFacesMetadataKey, bU as tileflowThemeBlendLimits, bW as tileflowTimesOfDay, bY as validateTileflowRuntimeSource, bZ as validateTileflowThemeBlendSelection, b_ as validateTileflowThemeSelection } from './manifest-types-CwjHd4qc.js';
+export { L as TileflowAnalytics, cb as TileflowAppearanceSelection, cc as TileflowColorOverrides, ab as TileflowManifestFetchOptions, ac as TileflowManifestLoadOptions, ad as TileflowMapMode, ae as TileflowMapModeOptions, ar as TileflowResolvedRuntimeTheme, aP as TileflowRuntimeCenterLike, a as TileflowRuntimeColorScheme, T as TileflowRuntimeManifest, aQ as TileflowRuntimeManifestMap, b as TileflowRuntimeManifestMapEntry, c as TileflowRuntimeManifestTheme, aR as TileflowRuntimeSource, aS as TileflowRuntimeSourceValidation, aT as TileflowRuntimeStyle, aU as TileflowRuntimeStyleOptions, d as TileflowRuntimeSystemThemes, aV as TileflowRuntimeViewOptions, aW as TileflowSessionController, aX as TileflowSessionGrantResponse, j as TileflowStyleFamily, a_ as TileflowStyleFontFace, bj as TileflowThemeBlendSelection, bq as TileflowThemeSelection, e as TileflowTimeOfDay, f as TileflowTimeOfDayVariants, cd as applyTileflowColorOverrides, by as assertValidTileflowRuntimeSource, bz as clearTileflowManifestCache, bB as createTileflowSessionController, bC as createTileflowSessionId, bD as defaultTileflowManifestUrl, bE as defaultTileflowRuntimeView, l as expandTileflowFamilyTemplate, bG as getTileflowAnalyticsApiUrl, bH as getTileflowStyleFontFaces, bI as inferTileflowAnalyticsFromStyleUrl, bJ as isTileflowTimeOfDay, bK as loadTileflowManifest, ce as loadTileflowRuntimeAppearance, cf as loadTileflowStyleFamily, n as materializeTileflowStyleFamily, bL as mergeTileflowAnalytics, bM as nearestTileflowBlendTheme, bN as normalizeTileflowRuntimeCenter, bO as normalizeTileflowStaticImageSize, cg as normalizeTileflowSurfaceId, bP as normalizeTileflowUrl, p as parseTileflowStyleFamily, ch as prepareTileflowStyleFamilyForRendering, bQ as resolveTileflowAnalyticsRequestUrl, ci as resolveTileflowAppearance, cj as resolveTileflowFamilyResourceUrls, bR as resolveTileflowManifestMap, bS as resolveTileflowMapMode, bT as resolveTileflowRuntimeStyle, bU as resolveTileflowRuntimeTheme, bV as resolveTileflowRuntimeThemeBlend, bW as resolveTileflowRuntimeView, bX as resolveTileflowStaticImageUrl, ck as resolveTileflowStyleResourceUrls, bY as shouldLoadTileflowManifest, bZ as startTileflowSession, o as tileflowStyleFamilyLimits, b$ as tileflowStyleFontFaceLimits, c0 as tileflowStyleFontFacesMetadataKey, c1 as tileflowThemeBlendLimits, c3 as tileflowTimesOfDay, c5 as validateTileflowRuntimeSource, c6 as validateTileflowThemeBlendSelection, c7 as validateTileflowThemeSelection, w as withTileflowFamilyTemplate } from './manifest-types-GeYn0SQM.js';