@tileflow/dev 0.1.0-alpha.17 → 0.1.0-alpha.19

package/dist/index.d.ts

@@ -1,322 +1,12 @@
-import { IncomingMessage, ServerResponse } from 'node:http';
-import { TileflowIconPackageFileName, TileflowIconPackageManifest, TileflowProjectConfig, MapLibreStyle, NormalizedTileflowCaptureScene, TileflowManifest, ValidationMessage, TileflowStyleOptions } from '@tileflow/core';
-
-declare const tileflowArtifactSessionSchemaVersion: 1;
-type TileflowArtifactDiagnostic = {
-    code?: string;
-    message: string;
-    path: string;
-    phase?: string;
-};
-type TileflowArtifactSessionState = {
-    status: 'building';
-    generation: number;
-    lastGoodGeneration?: number;
-} | {
-    status: 'ready';
-    generation: number;
-    artifacts: TileflowBuildArtifacts;
-    lastGoodGeneration: number;
-} | {
-    status: 'invalid';
-    generation: number;
-    diagnostics: TileflowArtifactDiagnostic[];
-    lastGoodGeneration?: number;
-};
-type TileflowArtifactSessionOptions = TileflowBuildArtifactsOptions & {
-    debounceMs?: number;
-    ignoredPaths?: string[];
-    watch?: boolean;
-};
-type TileflowArtifactSession = {
-    close(): Promise<void>;
-    getLastGoodArtifacts(): TileflowBuildArtifacts | undefined;
-    getState(): TileflowArtifactSessionState;
-    refresh(reason?: string): Promise<void>;
-    subscribe(listener: (state: TileflowArtifactSessionState) => void): () => void;
-};
-declare function createTileflowArtifactDiagnostics(error: unknown, cwd: string): TileflowArtifactDiagnostic[];
-
-type TileflowBuildAsset = {
-    contentType: string;
-    fileName: string;
-    source: string | Uint8Array;
-};
-type PreparedTileflowProject = {
-    assets: TileflowBuildAsset[];
-    project: TileflowProjectConfig;
-    watchPaths: string[];
-};
-type TileflowIconCompilationTarget = 'hosted' | 'local';
-type TileflowIconCompilationIssue = {
-    message: string;
-    path: string;
-};
-type CompiledTileflowIconPackageFile = {
-    contentType: 'application/json' | 'image/png';
-    fileName: TileflowIconPackageFileName;
-    source: Uint8Array;
-};
-type CompiledTileflowIconPackage = {
-    contentHash: string;
-    files: CompiledTileflowIconPackageFile[];
-    manifest: TileflowIconPackageManifest;
-};
-type TileflowMapIconPackageBinding = {
-    label: string;
-    mapName: string;
-    mapping?: Record<string, string>;
-    packageHash: string;
-};
-type CompileTileflowIconPackagesResult = {
-    bindings: TileflowMapIconPackageBinding[];
-    packages: CompiledTileflowIconPackage[];
-    watchPaths: string[];
-};
-type InspectTileflowIconCatalogsOptions = {
-    cwd: string;
-    mapNames?: readonly string[];
-};
-type TileflowIconCatalogSourceFormat = 'jpeg' | 'png' | 'svg' | 'webp';
-type TileflowIconCatalogMapping = {
-    iconId: string;
-    semantic: string;
-    targetStatus: 'missing' | 'present' | 'unknown';
-};
-type TileflowIconCatalogMappedFrom = {
-    map: string;
-    semantic: string;
-};
-type TileflowIconCatalogAtlasRectangle = {
-    height: number;
-    width: number;
-    x: number;
-    y: number;
-};
-type TileflowIconCatalogRenderedDensity = {
-    atlas: TileflowIconCatalogAtlasRectangle;
-    height: number;
-    pixelRatio: 1 | 2;
-    pixelSha256: string;
-    width: number;
-};
-type TileflowIconCatalogIcon = {
-    id: string;
-    mappedFrom: TileflowIconCatalogMappedFrom[];
-    rendered: {
-        oneX: TileflowIconCatalogRenderedDensity;
-        twoX: TileflowIconCatalogRenderedDensity;
-    };
-    source: {
-        byteLength: number;
-        dimensions: {
-            height: number;
-            width: number;
-        } | null;
-        format: TileflowIconCatalogSourceFormat;
-        path: string;
-    };
-};
-type TileflowIconCatalog = {
-    compiledPackage: CompiledTileflowIconPackage;
-    icons: TileflowIconCatalogIcon[];
-    insideWorkingTree: boolean;
-    sourcePath: string;
-};
-type TileflowIconCatalogMap = {
-    name: string;
-    icons: {
-        catalogSourcePath: string;
-        kind: 'local';
-        label: string;
-        mappings: TileflowIconCatalogMapping[];
-        packageHash: string;
-    } | {
-        inspectable: false;
-        kind: 'external';
-        mappings: TileflowIconCatalogMapping[];
-    } | {
-        inspectable: false;
-        kind: 'none';
-        mappings: TileflowIconCatalogMapping[];
-    };
-};
-type TileflowIconCatalogInspection = {
-    catalogs: TileflowIconCatalog[];
-    maps: TileflowIconCatalogMap[];
-};
-declare class TileflowIconCompilationError extends Error {
-    readonly code: "ICON_INVALID";
-    readonly issues: TileflowIconCompilationIssue[];
-    readonly phase: "icon-compilation";
-    constructor(issues: TileflowIconCompilationIssue[]);
-}
-declare const iconFileExtensions: Set<string>;
-declare function compileTileflowIconPackages(project: TileflowProjectConfig, options: {
-    cwd: string;
-    target: TileflowIconCompilationTarget;
-}): Promise<CompileTileflowIconPackagesResult>;
-declare function inspectTileflowIconCatalogs(project: TileflowProjectConfig, options: InspectTileflowIconCatalogsOptions): Promise<TileflowIconCatalogInspection>;
-declare function prepareTileflowProjectIcons(project: TileflowProjectConfig, options: {
-    assetBaseUrl: string;
-    cwd: string;
-}): Promise<PreparedTileflowProject>;
-
-type TileflowFeatureInspectionOptions = {
-    center: readonly [number, number];
-    fetch?: typeof fetch;
-    height?: number;
-    limit?: number;
-    properties?: readonly string[];
-    signal?: AbortSignal;
-    sourceLayers: readonly string[];
-    tileBaseUrl?: string;
-    timeoutMs?: number;
-    width?: number;
-    zoom: number;
-};
-type TileflowInspectedProperty = boolean | number | string;
-type TileflowInspectedFeature = {
-    sourceLayer: string;
-    id: number | null;
-    geometry: {
-        type: string;
-        center: [number, number];
-        bounds: [number, number, number, number];
-    };
-    properties: Record<string, TileflowInspectedProperty>;
-};
-type TileflowFeatureInspection = {
-    schemaVersion: 1;
-    map: string;
-    camera: {
-        center: [number, number];
-        zoom: number;
-        viewport: {
-            width: number;
-            height: number;
-        };
-    };
-    source: {
-        id: string;
-        origin: string;
-        tileJsonPath: string | null;
-        tileOrigins: string[];
-        version: string | null;
-    };
-    sourceLayers: string[];
-    properties: string[];
-    tileZoom: number;
-    tilesRead: number;
-    scannedFeatures: number;
-    truncated: boolean;
-    features: TileflowInspectedFeature[];
-};
-declare function inspectTileflowFeatures(project: TileflowProjectConfig, mapName: string, input: TileflowFeatureInspectionOptions): Promise<TileflowFeatureInspection>;
-
-type TileflowStyleValidationIssue = {
-    map: string;
-    message: string;
-    path: string;
-};
-declare class TileflowStyleValidationError extends Error {
-    readonly code: "STYLE_INVALID";
-    readonly issues: TileflowStyleValidationIssue[];
-    readonly phase: "style-validation";
-    constructor(issues: readonly TileflowStyleValidationIssue[]);
-}
-declare function assertValidTileflowStyle(style: MapLibreStyle, map: string): void;
-declare function validateTileflowStyle(style: MapLibreStyle, map: string): TileflowStyleValidationIssue[];
-
-declare const defaultTileflowApiUrl = "https://api.tileflow.dev";
-declare const defaultTileflowConfigPath = "tileflow.config.ts";
-declare const defaultTileflowManifestPath = "public/tileflow/manifest.json";
-declare const defaultTileflowTileset = "world";
-type LoadTileflowConfigOptions = {
-    cwd?: string;
-    fresh?: boolean;
-};
-type TileflowManifestOptions = {
-    styleBaseUrl?: string;
-    tileBaseUrl?: string;
-};
-type TileflowDevRequestHandlerOptions = {
-    basePath?: string;
-    config?: string;
-    cwd?: string;
-    map?: string;
-    onError?: (error: unknown) => void;
-    scene?: string;
-    session?: TileflowArtifactSession;
-    styleBaseUrl?: string;
-    tileBaseUrl?: string;
-};
-type TileflowPreviewSelection = {
-    map?: string;
-    scene?: string;
-};
-type ResolvedTileflowPreview = {
-    camera: NormalizedTileflowCaptureScene['camera'];
-    label: string;
-    mapName: string;
-    viewport?: NormalizedTileflowCaptureScene['viewport'];
-};
-declare class TileflowPreviewSelectionError extends Error {
-    readonly code: "PREVIEW_SELECTION_INVALID";
-    constructor(message: string);
-}
-type TileflowBuildArtifactsOptions = {
-    assetBaseUrl?: string;
-    config?: string;
-    cwd?: string;
-    styleBaseUrl?: string;
-    tileBaseUrl?: string;
-};
-type TileflowBuildArtifacts = {
-    assets: TileflowBuildAsset[];
-    manifest: TileflowManifest;
-    project: TileflowProjectConfig;
-    styles: Record<string, MapLibreStyle>;
-    watchPaths: string[];
-};
-type WriteTileflowBuildArtifactsOptions = TileflowBuildArtifactsOptions & {
-    outDir: string;
-};
-declare class TileflowValidationError extends Error {
-    readonly code: "CONFIG_INVALID";
-    readonly messages: ValidationMessage[];
-    readonly phase: "config-validation";
-    constructor(messages: ValidationMessage[]);
-}
-declare function loadTileflowConfig(configPath?: string, options?: LoadTileflowConfigOptions): Promise<TileflowProjectConfig>;
-declare function loadValidTileflowConfig(configPath?: string, options?: LoadTileflowConfigOptions): Promise<TileflowProjectConfig>;
-declare function assertValidTileflowConfig(project: TileflowProjectConfig): void;
-declare function asTileflowProjectConfig(input: unknown): TileflowProjectConfig;
-declare function getTileflowMapNames(project: TileflowProjectConfig): string[];
-declare function getFirstTileflowMapName(project: TileflowProjectConfig): string;
-declare function resolveTileflowPreview(project: TileflowProjectConfig, selection?: TileflowPreviewSelection): ResolvedTileflowPreview;
-declare function getTileflowStyleMapName(path: string): string;
-declare function createTileflowManifest(project: TileflowProjectConfig, options?: TileflowManifestOptions): TileflowManifest;
-declare function createTileflowStyle(project: TileflowProjectConfig, mapName: string, options?: TileflowStyleOptions): MapLibreStyle;
-declare function createTileflowStyles(project: TileflowProjectConfig, options?: TileflowStyleOptions): Record<string, MapLibreStyle>;
-declare function createTileflowBuildArtifacts(options?: TileflowBuildArtifactsOptions): Promise<TileflowBuildArtifacts>;
-declare function createTileflowArtifactSession(options?: TileflowArtifactSessionOptions): Promise<TileflowArtifactSession>;
-declare function getTileflowWatchPaths(options?: Pick<TileflowBuildArtifactsOptions, 'config' | 'cwd'>): Promise<string[]>;
-declare function writeTileflowBuildArtifacts(options: WriteTileflowBuildArtifactsOptions): Promise<TileflowBuildArtifacts>;
-declare function isTileflowRequestUrl(url: string | undefined, basePath: string): boolean;
-declare function createTileflowNodeRequest(request: IncomingMessage): Request;
-declare function writeTileflowNodeResponse(response: ServerResponse, tileflowResponse: Response): Promise<void>;
-declare function joinTileflowPublicUrl(publicBase: string, basePath: string): string;
-declare function getTileflowAssetBasePath(basePath: string): string;
-declare function getTileflowAssetFileName(basePath: string, fileName: string): string;
-declare function createTileflowDevRequestHandler(options?: TileflowDevRequestHandlerOptions): (request: Request) => Promise<Response>;
-declare function createTileflowArtifactStatus(state: TileflowArtifactSessionState): {
-    diagnostics?: TileflowArtifactDiagnostic[] | undefined;
-    lastGoodGeneration?: number | undefined;
-    schemaVersion: 1;
-    generation: number;
-    status: "building" | "ready" | "invalid";
-};
-declare function normalizeTileflowBasePath(value?: string): string;
-
-export { type CompileTileflowIconPackagesResult, type CompiledTileflowIconPackage, type CompiledTileflowIconPackageFile, type InspectTileflowIconCatalogsOptions, type LoadTileflowConfigOptions, type PreparedTileflowProject, type ResolvedTileflowPreview, type TileflowArtifactDiagnostic, type TileflowArtifactSession, type TileflowArtifactSessionOptions, type TileflowArtifactSessionState, type TileflowBuildArtifacts, type TileflowBuildArtifactsOptions, type TileflowBuildAsset, type TileflowDevRequestHandlerOptions, type TileflowFeatureInspection, type TileflowFeatureInspectionOptions, type TileflowIconCatalog, type TileflowIconCatalogAtlasRectangle, type TileflowIconCatalogIcon, type TileflowIconCatalogInspection, type TileflowIconCatalogMap, type TileflowIconCatalogMappedFrom, type TileflowIconCatalogMapping, type TileflowIconCatalogRenderedDensity, type TileflowIconCatalogSourceFormat, TileflowIconCompilationError, type TileflowIconCompilationIssue, type TileflowIconCompilationTarget, type TileflowInspectedFeature, type TileflowInspectedProperty, type TileflowManifestOptions, type TileflowMapIconPackageBinding, type TileflowPreviewSelection, TileflowPreviewSelectionError, TileflowStyleValidationError, type TileflowStyleValidationIssue, TileflowValidationError, type WriteTileflowBuildArtifactsOptions, asTileflowProjectConfig, assertValidTileflowConfig, assertValidTileflowStyle, compileTileflowIconPackages, createTileflowArtifactDiagnostics, createTileflowArtifactSession, createTileflowArtifactStatus, createTileflowBuildArtifacts, createTileflowDevRequestHandler, createTileflowManifest, createTileflowNodeRequest, createTileflowStyle, createTileflowStyles, defaultTileflowApiUrl, defaultTileflowConfigPath, defaultTileflowManifestPath, defaultTileflowTileset, getFirstTileflowMapName, getTileflowAssetBasePath, getTileflowAssetFileName, getTileflowMapNames, getTileflowStyleMapName, getTileflowWatchPaths, iconFileExtensions, inspectTileflowFeatures, inspectTileflowIconCatalogs, isTileflowRequestUrl, joinTileflowPublicUrl, loadTileflowConfig, loadValidTileflowConfig, normalizeTileflowBasePath, prepareTileflowProjectIcons, resolveTileflowPreview, tileflowArtifactSessionSchemaVersion, validateTileflowStyle, writeTileflowBuildArtifacts, writeTileflowNodeResponse };
+export { CreateTileflowArtifactPlanOptions, TileflowArtifactDiagnostic, TileflowArtifactFile, TileflowArtifactInputGraph, TileflowArtifactPlan, TileflowArtifactSession, TileflowArtifactSessionOptions, TileflowArtifactSessionState, TileflowBuildArtifacts, TileflowBuildArtifactsOptions, TileflowBuildStyleInspections, TileflowHostedManifestOverwriteError, TileflowManifestOptions, WriteTileflowArtifactPlanOptions, WriteTileflowBuildArtifactsOptions, assertTileflowSelfHostedManifestTarget, createTileflowArtifactDiagnostics, createTileflowArtifactPlan, createTileflowArtifactSession, createTileflowBuildArtifacts, createTileflowBuildProvenance, createTileflowManifest, createTileflowStyle, createTileflowStyles, getTileflowArtifactFiles, getTileflowAssetBasePath, getTileflowAssetFileName, getTileflowWatchPaths, isTileflowArtifactInputPath, joinTileflowPublicUrl, normalizeTileflowBasePath, refreshTileflowArtifactSession, resolveTileflowArtifactPublicUrls, tileflowArtifactInventoryFileName, tileflowArtifactPlanSchemaVersion, tileflowArtifactSessionSchemaVersion, writeTileflowArtifactPlan, writeTileflowBuildArtifacts } from './artifacts.js';
+export { LoadTileflowConfigOptions, LoadedTileflowConfig, TileflowValidationError, assertValidTileflowConfig, defaultTileflowApiUrl, defaultTileflowConfigPath, defaultTileflowManifestPath, getFirstTileflowMapName, getTileflowMapNames, loadTileflowConfig, loadTileflowConfigWithInputs, loadValidTileflowConfig, loadValidTileflowConfigWithInputs } from './config.js';
+export { CompiledTileflowFontBundle, PrepareTileflowStyleFontsOptions, PreparedTileflowStyleFonts, TileflowFontCompilationError, TileflowFontCompilationIssue, TileflowFontCompilationTarget, bindTileflowStyleFontBundle, getTileflowFontWatchPaths, prepareTileflowStyleFonts, replaceTileflowStyleFontSources } from './fonts.js';
+export { CompileTileflowIconPackagesResult, CompiledTileflowIconPackage, CompiledTileflowIconPackageFile, InspectTileflowIconCatalogsOptions, PreparedTileflowBuildCatalog, PreparedTileflowCatalog, TileflowBuildAsset, TileflowIconCatalog, TileflowIconCatalogAtlasRectangle, TileflowIconCatalogIcon, TileflowIconCatalogInspection, TileflowIconCatalogMap, TileflowIconCatalogRenderedDensity, TileflowIconCatalogSourceFormat, TileflowIconCompilationError, TileflowIconCompilationIssue, TileflowIconCompilationTarget, TileflowIconReplacement, TileflowMapIconPackageBinding, TileflowSourceCatalog, compileTileflowIconPackages, getTileflowIconWatchPaths, iconFileExtensions, inspectTileflowIconCatalogs, prepareTileflowCatalogIcons } from './icons.js';
+export { TileflowConfigInspection, TileflowConfigInspectionError, TileflowConfigInspectionOptions, TileflowFeatureInspection, TileflowFeatureInspectionOptions, TileflowInspectedFeature, TileflowInspectedProperty, TileflowMapLineageInspection, TileflowMapMergeProvenance, TileflowResolvedMapInspection, TileflowThemeContractInspection, TileflowThemeDifferenceInspection, TileflowThemeInspection, inspectLoadedTileflowConfig, inspectTileflowConfig, inspectTileflowFeatures } from './inspect.js';
+export { ResolvedTileflowPreview, TileflowLandmark, TileflowLandmarkArchive, TileflowLandmarkAxisConvention, TileflowLandmarkManifestV2, TileflowLandmarkModel, TileflowPreviewSelection, TileflowPreviewSelectionError, normalizeTileflowLandmarkManifest, readBoundedTileflowJsonResponse, readBoundedTileflowResponse, renderTileflowPreviewHtml, resolveTileflowPreview } from './preview.js';
+export { TileflowComparisonMode, TileflowComparisonOptions, TileflowComparisonRequestHandler, TileflowComparisonSide, TileflowDevRequestHandlerOptions, createTileflowArtifactStatus, createTileflowComparisonRequestHandler, createTileflowDevRequestHandler, createTileflowNodeRequest, getTileflowRequestPath, getTileflowStyleInspectionSelection, getTileflowStyleSelection, isTileflowRequestUrl, tileflowComparisonSchemaVersion, writeTileflowNodeResponse } from './server.js';
+export { TileflowCommandFailureDocument, TileflowCommandSummary, TileflowDiagnosticSeverity, TileflowStructuredDiagnostic, TileflowStyleValidationError, TileflowStyleValidationIssue, assertValidTileflowStyle, createTileflowCommandFailureDocument, createTileflowCommandSummary, createTileflowStructuredDiagnostics, serializeTileflowCommandDocument, tileflowCommandDocumentSchemaVersion, validateTileflowStyle } from './validation.js';
+import '@tileflow/core';
+import '@tileflow/core/build';
+import '@tileflow/core/manifest';
+import 'node:http';