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

package/dist/build.d.ts

@@ -1,48 +1,8 @@
 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 { R as ResolvedTileflowMap, T as TileflowDataRequirementsV1, a as TileflowSourceRequirementsV1, b as TileflowMap, c as TileflowStyleOptions, d as TileflowInspectedStyle, e as TileflowPreparedMapAssets } from './map-BHL_0Mkx.js';
+export { f as TileflowDataCompatibilityIssue, g as TileflowDataFieldRequirement, h as TileflowDataFieldType, i as TileflowDataLayerRequirement, j as TileflowObservedDataContractV1, k as TileflowStyleInspection, l as TileflowStyleInspectionContribution, m as TileflowStyleInspectionLayer, n as TileflowStyleInspectionRenderOperation, o as collectMapLineage, p as inferTileflowDataRequirements, q as inferTileflowSourceRequirements, t as tileflowStyleInspectionSchemaVersion, v as validateTileflowDataCompatibility } from './map-BHL_0Mkx.js';
+import { M as MapLibreStyle, T as TileflowRuntimeManifest } from './manifest-B5GKVMFE.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";
@@ -86,7 +46,8 @@ type TileflowMapBuildLineageEntry = {
 type TileflowMapBuildInput = {
     assets: readonly TileflowHashableBuildAsset[];
     lineage: readonly TileflowMapBuildLineageEntry[];
-    map: TileflowMap;
+    /** Validated, inheritance-free semantic compiler input. */
+    map: ResolvedTileflowMap;
     sourceAssets: TileflowEffectiveMapSourceAssets;
     styles: Readonly<Record<string, MapLibreStyle>>;
 };
@@ -104,9 +65,9 @@ type TileflowMapBuildManifestEntryV1 = {
     lineage: readonly TileflowMapBuildLineageEntry[];
     mapRevisionSha256: string;
     mapVersion: number;
-    recipe: {
-        compiler: 'streets';
-        compilerVersion: number;
+    semanticCompiler: {
+        name: 'tileflow-semantic';
+        version: number;
     };
     sourceAssets: TileflowEffectiveMapSourceAssets;
     systemThemes?: {
@@ -139,7 +100,7 @@ type TileflowMapBuildManifestV1 = {
  * 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
+ * icon/font bytes. Editorial identity, default view, capture scenes, 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.
@@ -148,7 +109,7 @@ declare function createTileflowMapBuildManifest(maps: Readonly<Record<string, Ti
     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>;
+declare function hashTileflowMapRevision(input: 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>;
 /**
@@ -160,23 +121,25 @@ declare function hashTileflowAssetSet(input: readonly TileflowHashableBuildAsset
 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.
+ * Compile the ordinary MapLibre Style and a separate read-only physical-output sidecar.
+ * Its physical IDs are diagnostic observations, never authoring targets. 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'> & {
+type TileflowCompiledMapMetadata = Pick<ResolvedTileflowMap, 'id' | 'version'> & {
     lineage: readonly TileflowMapBuildLineageEntry[];
 };
 /** Multi-map intermediate representation owned by Node build tooling. */
 type TileflowBuildCatalog = {
-    maps: Record<string, TileflowMap>;
+    /** Validated, inheritance-free compiler inputs. Authoring definitions live outside the catalog. */
+    maps: Record<string, ResolvedTileflowMap>;
     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. */
+/** Style family plus opt-in, read-only, non-addressable physical-output diagnostics. */
 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;
@@ -184,7 +147,7 @@ declare function createStyleFromCatalogWithInspection<const TCatalog extends Til
 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. */
+/** Compile every declared theme with a separate read-only physical-output diagnostic sidecar. */
 declare function createStylesFromCatalogWithInspection(catalog: TileflowBuildCatalog, options?: Omit<TileflowStyleOptions, 'preparedAssets' | 'theme'> & {
     mapAssets?: Readonly<Record<string, TileflowPreparedMapAssets>>;
 }): TileflowBuildInspectedStyles;
@@ -192,4 +155,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, 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 };
+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 };