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

package/dist/build.d.ts

@@ -0,0 +1,195 @@
+import { T as TileflowCaptureScene } from './capture-scene-BK_0J2oR.js';
+import { T as TileflowMap, a as TileflowDataRequirementsV1, b as TileflowSourceRequirementsV1, R as ResolvedTileflowMap, c as TileflowStyleOptions, d as TileflowPreparedMapAssets } from './requirements-BV77ZVhR.js';
+export { e as TileflowDataCompatibilityIssue, f as TileflowDataFieldRequirement, g as TileflowDataFieldType, h as TileflowDataLayerRequirement, i as TileflowObservedDataContractV1, j as collectMapLineage, k as inferTileflowDataRequirements, l as inferTileflowSourceRequirements, v as validateTileflowDataCompatibility } from './requirements-BV77ZVhR.js';
+import { e as TileflowRuntimeManifest } from './runtime-C4MtSzkB.js';
+import { M as MapLibreStyle } from './types-DlUGI6LC.js';
+import { T as TileflowLayerDomain } from './domains-CPSrdTik.js';
+import 'zod';
+import './visual-semantics-DTC-8Hsb.js';
+
+declare const tileflowLayerSlots: readonly ["background", "land", "terrain", "hydro", "building-areas", "transport-areas", "transport-tunnel-shadow", "transport-tunnel-casing", "transport-tunnel-fill", "transport-pedestrian-areas", "aeroways", "transport-surface-shadow", "transport-surface-casing", "transport-surface-fill", "transport-bridge-shadow", "transport-bridge-casing", "transport-bridge-fill", "transport-symbols", "boundaries", "buildings", "vegetation", "symbols"];
+type TileflowLayerSlot = (typeof tileflowLayerSlots)[number];
+
+/** Version of the build-only style inspection sidecar. */
+declare const tileflowStyleInspectionSchemaVersion: 1;
+type TileflowStyleInspectionEffect = {
+    readonly kind: 'add' | 'patch';
+    readonly owner: TileflowLayerDomain;
+    readonly target: string;
+};
+/** One semantic contribution represented by a compiled physical style layer. */
+type TileflowStyleInspectionContribution = {
+    readonly owner: TileflowLayerDomain;
+    readonly slot: TileflowLayerSlot;
+    readonly target: string;
+    /** Ordered module-effect chain applied before physical-layer optimization. */
+    readonly effects: readonly TileflowStyleInspectionEffect[];
+};
+type TileflowStyleInspectionLayer = {
+    readonly id: string;
+    readonly index: number;
+    readonly type: string;
+    /** Multiple entries are expected when the optimizer combines semantic layers. */
+    readonly contributions: readonly TileflowStyleInspectionContribution[];
+};
+/** Build-only cartographic provenance. This object is never embedded in Style JSON. */
+type TileflowStyleInspection = {
+    readonly schemaVersion: typeof tileflowStyleInspectionSchemaVersion;
+    readonly map: string;
+    readonly theme: string;
+    readonly layers: readonly TileflowStyleInspectionLayer[];
+};
+type TileflowInspectedStyle = {
+    readonly style: MapLibreStyle;
+    readonly inspection: TileflowStyleInspection;
+};
+
+declare const tileflowMapRevisionSchemaVersion: 1;
+declare const tileflowMapRevisionCanonicalization: "tileflow-canonical-json-v1";
+declare const tileflowMapBuildManifestSchemaVersion: 1;
+declare const tileflowMapBuildManifestFileName: "build-manifest.json";
+/** One effective icon source after ordered directory replacement has completed. */
+type TileflowEffectiveIconSourceIdentity = {
+    format: 'jpeg' | 'png' | 'svg' | 'webp';
+    id: string;
+    kind: 'icon' | 'pattern';
+    sha256: string;
+};
+/** One effective local font face actually referenced by the compiled map. */
+type TileflowEffectiveFontSourceIdentity = {
+    family: string;
+    sha256: string;
+    style: 'italic' | 'normal' | 'oblique';
+    weight: '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900';
+};
+type TileflowEffectiveMapSourceAssets = {
+    fonts: readonly TileflowEffectiveFontSourceIdentity[];
+    icons: readonly TileflowEffectiveIconSourceIdentity[];
+};
+type TileflowHashableBuildAsset = {
+    contentType: string;
+    fileName: string;
+    source: string | Uint8Array;
+};
+/** Canonical byte identity used by the immutable asset-set hash. */
+type TileflowBuildAssetIdentity = {
+    byteLength: number;
+    contentType: string;
+    fileName: string;
+    sha256: string;
+};
+/** One authoring node in leaf-to-root order, retained only for auditability. */
+type TileflowMapBuildLineageEntry = {
+    id: string;
+    mapVersion: number;
+};
+type TileflowMapBuildInput = {
+    assets: readonly TileflowHashableBuildAsset[];
+    lineage: readonly TileflowMapBuildLineageEntry[];
+    map: TileflowMap;
+    sourceAssets: TileflowEffectiveMapSourceAssets;
+    styles: Readonly<Record<string, MapLibreStyle>>;
+};
+type TileflowThemeBuildManifestEntryV1 = {
+    colorScheme: 'dark' | 'light';
+    dataRequirements: TileflowDataRequirementsV1;
+    sourceRequirements: TileflowSourceRequirementsV1;
+    styleSha256: string;
+    themeId: string;
+    themeVersion: number;
+};
+type TileflowMapBuildManifestEntryV1 = {
+    assetSetSha256: string;
+    defaultTheme: string;
+    lineage: readonly TileflowMapBuildLineageEntry[];
+    mapRevisionSha256: string;
+    mapVersion: number;
+    recipe: {
+        compiler: 'streets';
+        compilerVersion: number;
+    };
+    sourceAssets: TileflowEffectiveMapSourceAssets;
+    systemThemes?: {
+        dark: string;
+        light: string;
+    };
+    themes: Record<string, TileflowThemeBuildManifestEntryV1>;
+};
+/**
+ * Collect leaf-to-root editorial identities for manifest auditability.
+ *
+ * This lineage is deliberately not an additional `mapRevisionSha256` input. The resolved effective
+ * map already determines that identity, so a fully shadowed ancestor change stays non-material.
+ */
+declare function collectTileflowMapBuildLineage(input: TileflowMap): TileflowMapBuildLineageEntry[];
+type TileflowMapBuildProvenanceV1 = {
+    lockfile?: {
+        format: 'bun' | 'npm' | 'pnpm' | 'yarn';
+        sha256: string;
+    };
+    packages: Readonly<Record<string, string>>;
+    schemaVersion: 1;
+};
+type TileflowMapBuildManifestV1 = {
+    maps: Record<string, TileflowMapBuildManifestEntryV1>;
+    provenance?: TileflowMapBuildProvenanceV1;
+    schemaVersion: typeof tileflowMapBuildManifestSchemaVersion;
+};
+/**
+ * Create the portable map build identity document.
+ *
+ * `mapRevisionSha256` identifies the effective cartographic definition and effective source
+ * icon/font bytes. Editorial identity, default view, capture scenes, delivery policy, package
+ * versions, compiler ABI versions, compiled Style JSON, generated sprite/font outputs, filesystem
+ * paths, and a concrete resolution of a floating World selector are outside that hash. They have
+ * their own identities or remain tooling/delivery state.
+ */
+declare function createTileflowMapBuildManifest(maps: Readonly<Record<string, TileflowMapBuildInput>>, options?: {
+    provenance?: TileflowMapBuildProvenanceV1;
+}): Promise<TileflowMapBuildManifestV1>;
+/** Hash a resolved map definition with the versioned, domain-separated revision contract. */
+declare function hashTileflowMapRevision(input: TileflowMap | ResolvedTileflowMap, sourceAssets: TileflowEffectiveMapSourceAssets): Promise<string>;
+/** Hash the exact compiled resources bound to one map, independently from its Style JSON. */
+declare function hashTileflowAssetSet(input: readonly TileflowHashableBuildAsset[]): Promise<string>;
+/**
+ * Hash already-verified resource identities with the same v1 contract as byte-backed build assets.
+ *
+ * Hosted uses this after independently confirming immutable object bytes against their manifests;
+ * package or bundle hashes are not substitutes for this per-file identity closure.
+ */
+declare function hashTileflowAssetSetIdentities(input: readonly TileflowBuildAssetIdentity[]): Promise<string>;
+
+/**
+ * Compile the ordinary MapLibre Style and a separate build-only inspection sidecar.
+ * The sidecar never enters the Style object or runtime manifest.
+ */
+declare function createStyleWithInspection(config: TileflowMap, options?: TileflowStyleOptions): TileflowInspectedStyle;
+
+type TileflowCompiledMapMetadata = Pick<ResolvedTileflowMap, 'id' | 'root' | 'version'> & {
+    lineage: readonly TileflowMapBuildLineageEntry[];
+};
+/** Multi-map intermediate representation owned by Node build tooling. */
+type TileflowBuildCatalog = {
+    maps: Record<string, TileflowMap>;
+    mapMetadata?: Record<string, TileflowCompiledMapMetadata>;
+    scenes?: Record<string, TileflowCaptureScene>;
+};
+/** Complete compiled style family, addressed first by logical map and then by theme name. */
+type TileflowBuildStyles = Record<string, Record<string, MapLibreStyle>>;
+/** Build-only Style and inspection family with the same map/theme addressing. */
+type TileflowBuildInspectedStyles = Record<string, Record<string, TileflowInspectedStyle>>;
+declare function createStyleFromCatalog<const TCatalog extends TileflowBuildCatalog, const TMapName extends keyof TCatalog['maps'] & string>(catalog: TCatalog, mapName: TMapName, options?: TileflowStyleOptions): MapLibreStyle;
+declare function createStyleFromCatalogWithInspection<const TCatalog extends TileflowBuildCatalog, const TMapName extends keyof TCatalog['maps'] & string>(catalog: TCatalog, mapName: TMapName, options?: TileflowStyleOptions): TileflowInspectedStyle;
+/** Compile every declared theme for every logical map in deterministic key order. */
+declare function createStylesFromCatalog(catalog: TileflowBuildCatalog, options?: Omit<TileflowStyleOptions, 'preparedAssets' | 'theme'> & {
+    mapAssets?: Readonly<Record<string, TileflowPreparedMapAssets>>;
+}): TileflowBuildStyles;
+/** Compile every declared theme with a separate inspection sidecar. */
+declare function createStylesFromCatalogWithInspection(catalog: TileflowBuildCatalog, options?: Omit<TileflowStyleOptions, 'preparedAssets' | 'theme'> & {
+    mapAssets?: Readonly<Record<string, TileflowPreparedMapAssets>>;
+}): TileflowBuildInspectedStyles;
+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, type TileflowInspectedStyle, type TileflowMapBuildInput, type TileflowMapBuildLineageEntry, type TileflowMapBuildManifestEntryV1, type TileflowMapBuildManifestV1, type TileflowMapBuildProvenanceV1, TileflowPreparedMapAssets, TileflowSourceRequirementsV1, type TileflowStyleInspection, type TileflowStyleInspectionContribution, type TileflowStyleInspectionEffect, type TileflowStyleInspectionLayer, type TileflowThemeBuildManifestEntryV1, collectTileflowMapBuildLineage, createManifest, createStyleFromCatalog, createStyleFromCatalogWithInspection, createStyleWithInspection, createStylesFromCatalog, createStylesFromCatalogWithInspection, createTileflowMapBuildManifest, hashTileflowAssetSet, hashTileflowAssetSetIdentities, hashTileflowMapRevision, tileflowMapBuildManifestFileName, tileflowMapBuildManifestSchemaVersion, tileflowMapRevisionCanonicalization, tileflowMapRevisionSchemaVersion, tileflowStyleInspectionSchemaVersion };