@tileflow/core 0.1.0-alpha.26 → 0.1.0-alpha.27

package/dist/native-profile.d.ts

@@ -0,0 +1,187 @@
+import { z } from 'zod';
+
+/** Static preparation profile, not evidence that an application ran on a device. */
+declare const tileflowNativeProfileSchema: z.ZodLazy<z.core.$ZodObject<{
+    id: z.ZodLiteral<"native-v1">;
+    renderer: z.ZodLiteral<"native">;
+    schemaVersion: z.ZodLiteral<1>;
+    styleVersion: z.ZodLiteral<8>;
+    validatorStyleSpec: z.ZodLiteral<"24.8.5">;
+    reactNativeStyleSpec: z.ZodLiteral<"26.2.1">;
+    maplibreReactNative: z.ZodLiteral<"11.3.10">;
+    android: z.ZodLiteral<"13.2.0">;
+    ios: z.ZodLiteral<"6.26.0">;
+}, z.core.$strict>>;
+type TileflowNativeProfile = z.infer<typeof tileflowNativeProfileSchema>;
+declare const tileflowNativeProfile: Readonly<TileflowNativeProfile>;
+declare const tileflowNativeProfileIdSchema: z.ZodLiteral<"native-v1">;
+declare const tileflowRendererSchema: z.ZodEnum<{
+    native: "native";
+    web: "web";
+}>;
+type TileflowRenderer = z.infer<typeof tileflowRendererSchema>;
+
+type TileflowColor = `#${string}`;
+type MapLibreSprite = string | Array<{
+    id: string;
+    url: string;
+}>;
+type TileflowProjection = 'globe' | 'mercator';
+type TileflowLight = {
+    anchor?: 'map' | 'viewport';
+    color?: TileflowColor;
+    intensity?: number;
+    position?: readonly [number, number, number];
+};
+type MapLibreStyle = {
+    version: 8;
+    name: string;
+    glyphs?: string;
+    light?: TileflowLight;
+    projection?: {
+        type: TileflowProjection;
+    };
+    sprite?: MapLibreSprite;
+    sources: Record<string, Record<string, unknown>>;
+    layers: Array<Record<string, unknown>>;
+    terrain?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+};
+
+/** Resource budgets apply to validation work, not downloaded resources or native GPU memory. */
+declare const tileflowNativeProfileLimits: Readonly<{
+    maximumStyleBytes: number;
+    maximumDepth: 64;
+    maximumNodes: 160000;
+    maximumSources: 128;
+    maximumLayers: 4096;
+    maximumIssues: 32;
+    maximumFontFaces: 16;
+    maximumFontBytes: number;
+}>;
+/** Fixed output budget for a prepared native-v1 style, never a raw input allowance. */
+declare const tileflowNativePreparedStyleLimits: Readonly<{
+    maximumNodes: 540000;
+    maximumStyleBytes: number;
+    maximumDepth: 64;
+    maximumSources: 128;
+    maximumLayers: 4096;
+    maximumIssues: 32;
+    maximumFontFaces: 16;
+    maximumFontBytes: number;
+}>;
+
+declare const tileflowNativeBuildRecordFileName = "native-build.json";
+declare const tileflowNativeStyleTransformationSchema: z.ZodLazy<z.core.$ZodObject<{
+    map: z.ZodString;
+    theme: z.ZodString;
+    inputStyleSha256: z.ZodString;
+    loweredStyleSha256: z.ZodString;
+    inputLayers: z.ZodNumber;
+    outputLayers: z.ZodNumber;
+    projection: z.ZodEnum<{
+        none: "none";
+        "mercator-to-implicit": "mercator-to-implicit";
+        "globe-to-mercator": "globe-to-mercator";
+    }>;
+    layers: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
+        inputLayer: z.ZodNumber;
+        outputStart: z.ZodNumber;
+        outputCount: z.ZodNumber;
+        properties: z.ZodArray<z.ZodEnum<{
+            "line-dasharray": "line-dasharray";
+            "line-cap": "line-cap";
+        }>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>>;
+type TileflowNativeStyleTransformation = z.infer<typeof tileflowNativeStyleTransformationSchema>;
+/** Version 2 adds explicit preparation evidence. The runtime manifest remains version 1. */
+declare const tileflowNativeBuildRecordSchema: z.ZodLazy<z.core.$ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    renderer: z.ZodLiteral<"native">;
+    profile: z.ZodLiteral<"native-v1">;
+    validation: z.ZodLiteral<"static-artifacts">;
+    preparationVersion: z.ZodLiteral<"native-lowering-v1">;
+    engines: z.ZodLazy<z.core.$ZodObject<{
+        android: z.ZodLiteral<"13.2.0">;
+        ios: z.ZodLiteral<"6.26.0">;
+    }, z.core.$strict>>;
+    buildManifestSha256: z.ZodString;
+    transformations: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
+        map: z.ZodString;
+        theme: z.ZodString;
+        inputStyleSha256: z.ZodString;
+        loweredStyleSha256: z.ZodString;
+        inputLayers: z.ZodNumber;
+        outputLayers: z.ZodNumber;
+        projection: z.ZodEnum<{
+            none: "none";
+            "mercator-to-implicit": "mercator-to-implicit";
+            "globe-to-mercator": "globe-to-mercator";
+        }>;
+        layers: z.ZodArray<z.ZodLazy<z.core.$ZodObject<{
+            inputLayer: z.ZodNumber;
+            outputStart: z.ZodNumber;
+            outputCount: z.ZodNumber;
+            properties: z.ZodArray<z.ZodEnum<{
+                "line-dasharray": "line-dasharray";
+                "line-cap": "line-cap";
+            }>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>>;
+type TileflowNativeBuildRecord = z.infer<typeof tileflowNativeBuildRecordSchema>;
+declare function createTileflowNativeBuildRecord(buildManifestSha256: string, transformations?: readonly TileflowNativeStyleTransformation[]): TileflowNativeBuildRecord;
+
+declare const tileflowNativeDiagnosticCodeSchema: z.ZodEnum<{
+    NATIVE_UNSUPPORTED_STYLE: "NATIVE_UNSUPPORTED_STYLE";
+    NATIVE_UNSUPPORTED_SOURCE: "NATIVE_UNSUPPORTED_SOURCE";
+    NATIVE_FONT_UNAVAILABLE: "NATIVE_FONT_UNAVAILABLE";
+    NATIVE_MANIFEST_REQUIRED: "NATIVE_MANIFEST_REQUIRED";
+    NATIVE_RENDERER_UNSUPPORTED: "NATIVE_RENDERER_UNSUPPORTED";
+}>;
+type TileflowNativeDiagnosticCode = z.infer<typeof tileflowNativeDiagnosticCodeSchema>;
+/** Uses the command diagnostic fields; renderer/profile are bounded additional context. */
+declare const tileflowNativeDiagnosticSchema: z.ZodLazy<z.core.$ZodObject<{
+    code: z.ZodEnum<{
+        NATIVE_UNSUPPORTED_STYLE: "NATIVE_UNSUPPORTED_STYLE";
+        NATIVE_UNSUPPORTED_SOURCE: "NATIVE_UNSUPPORTED_SOURCE";
+        NATIVE_FONT_UNAVAILABLE: "NATIVE_FONT_UNAVAILABLE";
+        NATIVE_MANIFEST_REQUIRED: "NATIVE_MANIFEST_REQUIRED";
+        NATIVE_RENDERER_UNSUPPORTED: "NATIVE_RENDERER_UNSUPPORTED";
+    }>;
+    phase: z.ZodLiteral<"native-compatibility">;
+    severity: z.ZodLiteral<"error">;
+    path: z.ZodString;
+    renderer: z.ZodLiteral<"native">;
+    profile: z.ZodLiteral<"native-v1">;
+    message: z.ZodString;
+    suggestion: z.ZodString;
+}, z.core.$strict>>;
+type TileflowNativeDiagnostic = z.infer<typeof tileflowNativeDiagnosticSchema>;
+declare function createTileflowNativeDiagnostic(code: TileflowNativeDiagnosticCode, path?: string): TileflowNativeDiagnostic;
+declare class TileflowNativeCompatibilityError extends Error {
+    readonly phase: "native-compatibility";
+    readonly issues: readonly TileflowNativeDiagnostic[];
+    readonly code: TileflowNativeDiagnosticCode;
+    constructor(issues: readonly TileflowNativeDiagnostic[]);
+}
+declare function resolveTileflowRenderer(value?: unknown): TileflowRenderer;
+type TileflowNativeStyleValidationOptions = {
+    profile?: 'native-v1';
+    /** Used only for URL syntax resolution; no request or authority is implied. */
+    documentUrl?: string;
+    developmentOrigin?: string;
+    /** Build preflight may defer font closure until the existing font pipeline has run. */
+    deferFontClosure?: boolean;
+};
+/** Validate bounded JSON and the common native engine surface without executing a renderer. */
+declare function validateTileflowNativeStyle(input: unknown, options?: TileflowNativeStyleValidationOptions): TileflowNativeDiagnostic[];
+/**
+ * Check an already prepared artifact with the fixed native-v1 output allowance.
+ * This does not lower a style or prove its origin. Authoring input must use the raw validator.
+ */
+declare function validateTileflowNativePreparedStyle(input: unknown, options?: TileflowNativeStyleValidationOptions): TileflowNativeDiagnostic[];
+declare function assertTileflowNativeStyle(style: unknown, options?: TileflowNativeStyleValidationOptions): asserts style is MapLibreStyle;
+
+export { type TileflowNativeBuildRecord, TileflowNativeCompatibilityError, type TileflowNativeDiagnostic, type TileflowNativeDiagnosticCode, type TileflowNativeProfile, type TileflowNativeStyleValidationOptions, type TileflowRenderer, assertTileflowNativeStyle, createTileflowNativeBuildRecord, createTileflowNativeDiagnostic, resolveTileflowRenderer, tileflowNativeBuildRecordFileName, tileflowNativeBuildRecordSchema, tileflowNativeDiagnosticCodeSchema, tileflowNativeDiagnosticSchema, tileflowNativePreparedStyleLimits, tileflowNativeProfile, tileflowNativeProfileIdSchema, tileflowNativeProfileLimits, tileflowNativeProfileSchema, tileflowRendererSchema, validateTileflowNativePreparedStyle, validateTileflowNativeStyle };