@tileflow/core 0.1.0-alpha.21 → 0.1.0-alpha.23

package/dist/runtime.d.ts

@@ -1,3 +1,2 @@
-export { T as TileflowAnalytics, f as TileflowManifestFetchOptions, g as TileflowManifestLoadOptions, h as TileflowMapMarker, i as TileflowMapMode, j as TileflowMapModeOptions, k as TileflowResolvedRuntimeTheme, l as TileflowRuntimeCenterLike, d as TileflowRuntimeColorScheme, e as TileflowRuntimeManifest, m as TileflowRuntimeManifestMap, n as TileflowRuntimeManifestMapEntry, o as TileflowRuntimeManifestTheme, p as TileflowRuntimeSource, q as TileflowRuntimeSourceValidation, b as TileflowRuntimeStyle, r as TileflowRuntimeStyleOptions, s as TileflowRuntimeSystemThemes, t as TileflowRuntimeViewOptions, c as TileflowSessionController, u as TileflowSessionGrantResponse, a as TileflowStyleFontFace, v as TileflowThemeSelection, w as assertValidTileflowRuntimeSource, x as clearTileflowManifestCache, y as createTileflowSessionController, z as createTileflowSessionId, A as defaultTileflowManifestUrl, B as defaultTileflowRuntimeView, C as getTileflowAnalyticsApiUrl, D as getTileflowStyleFontFaces, E as inferTileflowAnalyticsFromStyleUrl, F as loadTileflowManifest, G as mergeTileflowAnalytics, H as normalizeTileflowRuntimeCenter, I as normalizeTileflowStaticImageSize, J as normalizeTileflowUrl, L as resolveTileflowAnalyticsRequestUrl, M as resolveTileflowManifestMap, N as resolveTileflowMapMode, O as resolveTileflowRuntimeStyle, P as resolveTileflowRuntimeTheme, Q as resolveTileflowRuntimeView, R as resolveTileflowStaticImageUrl, U as shouldLoadTileflowManifest, V as startTileflowSession, Z as tileflowStyleFontFaceLimits, _ as tileflowStyleFontFacesMetadataKey, $ as validateTileflowRuntimeSource, a0 as validateTileflowThemeSelection } from './runtime-C4MtSzkB.js';
-import './types-DlUGI6LC.js';
+export { t as TileflowAnalytics, U as TileflowManifestFetchOptions, W as TileflowManifestLoadOptions, X as TileflowMapMode, Y as TileflowMapModeOptions, a8 as TileflowResolvedRuntimeTheme, av as TileflowRuntimeCenterLike, aw as TileflowRuntimeColorScheme, T as TileflowRuntimeManifest, ax as TileflowRuntimeManifestMap, ay as TileflowRuntimeManifestMapEntry, az as TileflowRuntimeManifestTheme, aA as TileflowRuntimeSource, aB as TileflowRuntimeSourceValidation, aC as TileflowRuntimeStyle, aD as TileflowRuntimeStyleOptions, aE as TileflowRuntimeSystemThemes, aF as TileflowRuntimeViewOptions, aG as TileflowSessionController, aH as TileflowSessionGrantResponse, aK as TileflowStyleFontFace, b7 as TileflowThemeSelection, bf as assertValidTileflowRuntimeSource, bg as clearTileflowManifestCache, bi as createTileflowSessionController, bj as createTileflowSessionId, bk as defaultTileflowManifestUrl, bl as defaultTileflowRuntimeView, bn as getTileflowAnalyticsApiUrl, bo as getTileflowStyleFontFaces, bp as inferTileflowAnalyticsFromStyleUrl, bq as loadTileflowManifest, br as mergeTileflowAnalytics, bs as normalizeTileflowRuntimeCenter, bt as normalizeTileflowStaticImageSize, bT as normalizeTileflowSurfaceId, bu as normalizeTileflowUrl, bw as resolveTileflowAnalyticsRequestUrl, bx as resolveTileflowManifestMap, by as resolveTileflowMapMode, bz as resolveTileflowRuntimeStyle, bA as resolveTileflowRuntimeTheme, bB as resolveTileflowRuntimeView, bC as resolveTileflowStaticImageUrl, bE as shouldLoadTileflowManifest, bF as startTileflowSession, bK as tileflowStyleFontFaceLimits, bL as tileflowStyleFontFacesMetadataKey, bO as validateTileflowRuntimeSource, bP as validateTileflowThemeSelection } from './manifest-B5GKVMFE.js';
 import 'zod';

package/dist/runtime.js

@@ -49,6 +49,39 @@ var init_portable_identity = __esm({
   }
 });
 
+// src/themes/visual-semantics.ts
+var init_visual_semantics = __esm({
+  "src/themes/visual-semantics.ts"() {
+    "use strict";
+  }
+});
+
+// src/themes/model.ts
+var tileflowThemeLimits, themeTypographyStyleKeys, themeTypographyKeys;
+var init_model = __esm({
+  "src/themes/model.ts"() {
+    "use strict";
+    tileflowThemeLimits = Object.freeze({ maxThemes: 64 });
+    themeTypographyStyleKeys = ["fallbacks", "font", "letterSpacing", "transform"];
+    themeTypographyKeys = [
+      ...themeTypographyStyleKeys,
+      "places",
+      "poi",
+      "roads",
+      "water"
+    ];
+  }
+});
+
+// src/themes/index.ts
+var init_themes = __esm({
+  "src/themes/index.ts"() {
+    "use strict";
+    init_model();
+    init_visual_semantics();
+  }
+});
+
 // src/manifest.ts
 var manifest_exports = {};
 __export(manifest_exports, {
@@ -145,6 +178,7 @@ var init_manifest = __esm({
   "src/manifest.ts"() {
     "use strict";
     init_portable_identity();
+    init_themes();
     tileflowRuntimeManifestVersion = 1;
     tileflowRuntimeManifestLimits = Object.freeze({ maximumBytes: 1024 * 1024 });
     safeTextSchema = z2.string().min(1).max(2048).refine((value) => value === value.trim(), "Expected text without surrounding whitespace").refine((value) => !/[\p{Cc}\\]/u.test(value), "Expected safe text");
@@ -189,8 +223,13 @@ var init_manifest = __esm({
       if (names.length === 0) {
         context.addIssue({ code: "custom", message: "Expected at least one theme", path: ["themes"] });
       }
-      if (names.length > 64) {
-        context.addIssue({ code: "too_big", maximum: 64, origin: "object", path: ["themes"] });
+      if (names.length > tileflowThemeLimits.maxThemes) {
+        context.addIssue({
+          code: "too_big",
+          maximum: tileflowThemeLimits.maxThemes,
+          origin: "object",
+          path: ["themes"]
+        });
       }
       if (!Object.hasOwn(entry.themes, entry.defaultTheme)) {
         context.addIssue({
@@ -269,6 +308,10 @@ var defaultTileflowRuntimeView = Object.freeze({
   pitch: 0,
   zoom: 2
 });
+var tileflowSurfaceIdPattern = /^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$/u;
+function normalizeTileflowSurfaceId(value) {
+  return typeof value === "string" && tileflowSurfaceIdPattern.test(value) ? value : "default";
+}
 var tileflowStyleFontFacesMetadataKey = "tileflow:fontFaces";
 var tileflowStyleFontFaceLimits = Object.freeze({
   maximumCount: 16,
@@ -551,7 +594,8 @@ async function requestSessionGrant(input) {
         sdkVersion: input.analytics.sdkVersion,
         sessionId: input.sessionId,
         source: input.analytics.source ?? input.source,
-        styleId: input.analytics.styleId
+        styleId: input.analytics.styleId,
+        surfaceId: normalizeTileflowSurfaceId(input.analytics.surfaceId)
       }),
       credentials: "omit",
       headers: { "Content-Type": "application/json" },
@@ -693,11 +737,19 @@ function isEligibleResource(value, mapId, apiOrigin, grantedOrigins) {
     if (url.username || url.password) return false;
     const originAllowed = url.origin === apiOrigin || grantedOrigins?.has(url.origin) || apiOrigin === "https://api.tileflow.dev" && url.origin === "https://cdn.tileflow.dev";
     if (!originAllowed) return false;
-    return url.pathname === `/maps/${encodeURIComponent(mapId)}/style.json` || url.pathname.startsWith("/tiles/") || url.pathname.startsWith("/v1/tiles/") || url.pathname.startsWith("/fonts/") || url.pathname.startsWith("/sprites/");
+    return isHostedStylePath(url.pathname, mapId) || url.pathname.startsWith("/tiles/") || url.pathname.startsWith("/v1/tiles/") || url.pathname.startsWith("/fonts/") || url.pathname.startsWith("/sprites/");
   } catch {
     return false;
   }
 }
+function isHostedStylePath(pathname, mapId) {
+  const prefix = `/maps/${encodeURIComponent(mapId)}/`;
+  if (!pathname.startsWith(prefix)) return false;
+  const file = pathname.slice(prefix.length);
+  if (file === "style.json") return true;
+  if (!file.endsWith(".json")) return false;
+  return isTileflowThemeName(file.slice(0, -".json".length));
+}
 function originOf(value) {
   if (typeof value !== "string") return null;
   try {
@@ -739,6 +791,7 @@ function startTileflowSession(analytics, input) {
     sessionId: input.sessionId,
     source: analytics.source ?? input.source,
     styleId: input.styleId,
+    surfaceId: normalizeTileflowSurfaceId(analytics.surfaceId),
     timestamp: (/* @__PURE__ */ new Date()).toISOString()
   });
   const blob = new Blob([payload], { type: "application/json" });
@@ -778,7 +831,8 @@ function mergeTileflowAnalytics(userAnalytics, runtimeAnalytics) {
     ...userAnalytics,
     apiUrl: userAnalytics?.apiUrl ?? runtimeAnalytics?.apiUrl,
     mapId: userAnalytics?.mapId ?? runtimeAnalytics?.mapId,
-    styleId: userAnalytics?.styleId ?? runtimeAnalytics?.styleId
+    styleId: userAnalytics?.styleId ?? runtimeAnalytics?.styleId,
+    surfaceId: normalizeTileflowSurfaceId(userAnalytics?.surfaceId ?? runtimeAnalytics?.surfaceId)
   };
 }
 function resolveTileflowMapMode(options) {
@@ -1100,6 +1154,7 @@ export {
   mergeTileflowAnalytics,
   normalizeTileflowRuntimeCenter,
   normalizeTileflowStaticImageSize,
+  normalizeTileflowSurfaceId,
   normalizeTileflowUrl,
   resolveTileflowAnalyticsRequestUrl,
   resolveTileflowManifestMap,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/core",
-  "version": "0.1.0-alpha.21",
+  "version": "0.1.0-alpha.23",
   "license": "Apache-2.0",
   "description": "Typed Tileflow config and MapLibre style compiler.",
   "type": "module",
@@ -52,16 +52,12 @@
       "import": "./dist/capture.js",
       "default": "./dist/capture.js"
     },
+    "./config-reference.json": "./dist/config-reference.json",
     "./manifest": {
       "types": "./dist/manifest.d.ts",
       "import": "./dist/manifest.js",
       "default": "./dist/manifest.js"
     },
-    "./recipe": {
-      "types": "./dist/recipe.d.ts",
-      "import": "./dist/recipe.js",
-      "default": "./dist/recipe.js"
-    },
     "./runtime": {
       "types": "./dist/runtime.d.ts",
       "import": "./dist/runtime.js",
@@ -77,10 +73,11 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "maplibre-contour": "0.1.0"
+    "maplibre-contour": "0.1.0",
+    "pmtiles": "4.4.0"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/browser.ts src/build.ts src/capture.ts src/manifest.ts src/recipe.ts src/runtime.ts --format esm --dts --clean --no-splitting",
+    "build": "tsup src/index.ts src/build.ts src/capture.ts src/manifest.ts src/runtime.ts --format esm --dts --clean --no-splitting && tsup src/browser.ts --format esm --dts --no-splitting --platform browser && cp ../../docs/modules-api-reference.json dist/config-reference.json",
     "reference:check": "tsx scripts/generate-config-reference.ts --check",
     "reference:generate": "tsx scripts/generate-config-reference.ts --write",
     "verify": "pnpm run build && tsx --test test/*.test.ts",

package/dist/domains-CPSrdTik.d.ts

@@ -1,4 +0,0 @@
-declare const tileflowLayerDomains: readonly ["addresses", "land", "terrain", "landforms", "water", "nautical", "roads", "transit", "aeroways", "buildings", "vegetation", "boundaries", "labels", "poi"];
-type TileflowLayerDomain = (typeof tileflowLayerDomains)[number];
-
-export type { TileflowLayerDomain as T };

package/dist/recipe.d.ts

@@ -1,66 +0,0 @@
-import { T as TileflowStreetsModuleName, O as OpenMapTilesFieldBindings, a as OpenMapTilesLayerBindings } from './visual-semantics-DTC-8Hsb.js';
-export { b as TileflowVisualValueCategory, c as classifyTileflowVisualProperty } from './visual-semantics-DTC-8Hsb.js';
-import { T as TileflowLayerDomain } from './domains-CPSrdTik.js';
-export { t as toMapLibreStyleValue } from './types-DlUGI6LC.js';
-
-type TileflowSemanticFieldReference = {
-    readonly kind: 'tileflow-semantic-field';
-    readonly name: keyof OpenMapTilesFieldBindings;
-};
-type TileflowSemanticLayerReference = {
-    readonly kind: 'tileflow-semantic-layer';
-    readonly name: keyof OpenMapTilesLayerBindings;
-};
-type TileflowModuleLayerPlacement = {
-    after: string;
-} | {
-    before: string;
-};
-type TileflowModuleEffect = {
-    kind: 'patch';
-    owner: TileflowStreetsModuleName;
-    patch: Record<string, unknown>;
-    requires?: readonly TileflowLayerDomain[];
-    target: string;
-} | {
-    kind: 'add';
-    layer: Record<string, unknown> & {
-        id: string;
-        type: string;
-    };
-    owner: TileflowStreetsModuleName;
-    placement: TileflowModuleLayerPlacement;
-    requires?: readonly TileflowLayerDomain[];
-    target: string;
-} | {
-    kind: 'remove';
-    owner: TileflowStreetsModuleName;
-    requires?: readonly TileflowLayerDomain[];
-    target: string;
-};
-/** Compiler-private authoring field reference. Official maps never capture physical data fields. */
-declare function semanticField(name: keyof OpenMapTilesFieldBindings): TileflowSemanticFieldReference;
-/** Compiler-private authoring layer reference. Official maps never capture physical source layers. */
-declare function semanticLayer(name: keyof OpenMapTilesLayerBindings): TileflowSemanticLayerReference;
-declare function patchModuleLayer(owner: TileflowStreetsModuleName, target: string, patch: Record<string, unknown>, options?: {
-    requires?: readonly TileflowLayerDomain[];
-}): TileflowModuleEffect;
-declare function addModuleLayer(owner: TileflowStreetsModuleName, target: string, layer: Record<string, unknown> & {
-    id: string;
-    type: string;
-}, placement: TileflowModuleLayerPlacement, options?: {
-    requires?: readonly TileflowLayerDomain[];
-}): TileflowModuleEffect;
-declare function removeModuleLayer(owner: TileflowStreetsModuleName, target: string, options?: {
-    requires?: readonly TileflowLayerDomain[];
-}): TileflowModuleEffect;
-/**
- * Attach compiler-private effects without adding a public string key to a map definition.
- * The empty return type deliberately keeps the symbol out of public authoring inference.
- */
-declare function internalModuleEffects(effects: readonly TileflowModuleEffect[]): {};
-declare function getResolvedModuleEffects(input: object): readonly TileflowModuleEffect[];
-
-declare function isMapLibreExpressionOperator(value: unknown): value is string;
-
-export { type TileflowModuleEffect, type TileflowModuleLayerPlacement, addModuleLayer, internalModuleEffects as defineModuleEffects, getResolvedModuleEffects, isMapLibreExpressionOperator, patchModuleLayer, removeModuleLayer, semanticField, semanticLayer };