@tileflow/dev 0.1.0-alpha.3 → 0.1.0-alpha.31

package/dist/server.d.ts

@@ -0,0 +1,82 @@
+import { TileflowArtifactSession, TileflowArtifactSessionState, TileflowArtifactDiagnostic } from './artifacts.js';
+export { TileflowArtifactAcquisition, TileflowArtifactSessionOptions, createTileflowArtifactDiagnostics, getTileflowAssetBasePath, getTileflowAssetFileName, joinTileflowPublicUrl, normalizeTileflowBasePath, resolveTileflowArtifactPublicUrls, tileflowArtifactSessionSchemaVersion } from './artifacts.js';
+import { IncomingMessage, ServerResponse } from 'node:http';
+import '@tileflow/core';
+import '@tileflow/core/build';
+import '@tileflow/core/manifest';
+import '@tileflow/core/native-profile';
+import './icons.js';
+import './config.js';
+
+declare const tileflowComparisonSchemaVersion: 1;
+type TileflowComparisonRequestHandler = (request: Request) => Promise<Response> | Response;
+type TileflowComparisonSide = {
+    /** Route base owned by this side's existing Tileflow dev handler. */
+    basePath: string;
+    /** Optional safe cwd-relative config argument used by Copy command. */
+    captureConfig?: string;
+    handler: TileflowComparisonRequestHandler;
+    /** Human-readable local label. It is never interpreted as HTML. */
+    label: string;
+    /** Optional compiler-inspection sidecar exposed by the owning handler. */
+    sidecarUrl?: string;
+    /** Same-origin preview URL below basePath, including its map/theme query. */
+    previewUrl: string;
+};
+type TileflowComparisonMode = 'blink' | 'overlay' | 'side-by-side' | 'split';
+type TileflowComparisonOptions = {
+    basePath?: string;
+    initialMode?: TileflowComparisonMode;
+    left: TileflowComparisonSide;
+    right: TileflowComparisonSide;
+    title?: string;
+};
+/**
+ * Compose two existing Tileflow dev handlers behind one same-origin comparison shell.
+ *
+ * The side handlers retain ownership of styles, sprites, fonts, generations, live
+ * events, and last-known-good behavior. This router owns only the shell document and
+ * deterministic dispatch by route prefix.
+ */
+declare function createTileflowComparisonRequestHandler(options: TileflowComparisonOptions): (request: Request) => Promise<Response>;
+
+type TileflowDevRequestHandlerOptions = {
+    apiBaseUrl?: string;
+    basePath?: string;
+    config?: string;
+    cwd?: string;
+    inspection?: boolean;
+    map?: string;
+    onError?: (error: unknown) => void;
+    scene?: string;
+    session?: TileflowArtifactSession;
+    styleBaseUrl?: string;
+    theme?: string;
+};
+type TileflowDevRequestHandler = ((request: Request) => Promise<Response>) & {
+    close(): Promise<void>;
+    refresh(): Promise<void>;
+};
+declare function getTileflowStyleSelection(path: string): {
+    mapName: string;
+    themeName: string;
+} | undefined;
+declare function getTileflowStyleInspectionSelection(path: string): {
+    mapName: string;
+    themeName: string;
+} | undefined;
+declare function isTileflowRequestUrl(url: string | undefined, basePath: string): boolean;
+/** Match and strip the configured route base using the same route table as the request handler. */
+declare function getTileflowRequestPath(url: string | undefined, basePath: string): string | null;
+declare function createTileflowNodeRequest(request: IncomingMessage): Request;
+declare function writeTileflowNodeResponse(response: ServerResponse, tileflowResponse: Response): Promise<void>;
+declare function createTileflowDevRequestHandler(options?: TileflowDevRequestHandlerOptions): TileflowDevRequestHandler;
+declare function createTileflowArtifactStatus(state: TileflowArtifactSessionState): {
+    schemaVersion: 1;
+    generation: number;
+    status: "building" | "invalid" | "ready";
+    lastGoodGeneration?: number | undefined;
+    diagnostics?: TileflowArtifactDiagnostic[] | undefined;
+};
+
+export { TileflowArtifactDiagnostic, TileflowArtifactSession, TileflowArtifactSessionState, type TileflowComparisonMode, type TileflowComparisonOptions, type TileflowComparisonRequestHandler, type TileflowComparisonSide, type TileflowDevRequestHandler, type TileflowDevRequestHandlerOptions, createTileflowArtifactStatus, createTileflowComparisonRequestHandler, createTileflowDevRequestHandler, createTileflowNodeRequest, getTileflowRequestPath, getTileflowStyleInspectionSelection, getTileflowStyleSelection, isTileflowRequestUrl, tileflowComparisonSchemaVersion, writeTileflowNodeResponse };