@mapcreator/sdk 3.0.0 → 3.1.1

package/dist/models/line.d.ts

@@ -1,6 +1,7 @@
 import { SvgCache } from '../utils/svgHelpers';
 import { JobObjectLine, JobObjectLineGroup } from '../types/jobObject';
 import { Map } from '@mapcreator/maplibre-gl';
+import { ExportType } from '../types';
 import { Feature } from 'geojson';
-export declare function addLineGroup(map: Map, group: JobObjectLineGroup, beforeId: string, svgCache: SvgCache): void;
+export declare function addLineGroup(map: Map, group: JobObjectLineGroup, beforeId: string, svgCache: SvgCache, exportType: ExportType): void;
 export declare function buildLineFeature(map: Map, group: JobObjectLineGroup, line: JobObjectLine, trimEnd: number, svgCache: SvgCache): Feature;

package/dist/renderAdornments.d.ts

@@ -2,5 +2,5 @@ import { Map as MapLibre } from '@mapcreator/maplibre-gl';
 import { InitialPositionInfo, ExportType } from './types';
 import { SvgCache } from './utils/svgHelpers';
 import { PositionOffsets, JobObject } from './types/jobObject';
-export declare function useRenderAdornments(jobObject: JobObject, positionOffsets: PositionOffsets, map: MapLibre, svgCache: SvgCache, initialPosition: InitialPositionInfo, vapiUrl: string, cdnUrl: string, accessToken: string, exportType: ExportType): Promise<void>;
-export declare function updateCollisionDetection(map: MapLibre): void;
+export declare const removeAdornmentContainers: (map: MapLibre) => boolean;
+export declare function useRenderAdornments(jobObject: JobObject, positionOffsets: PositionOffsets, map: MapLibre, svgCache: SvgCache, initialPosition: InitialPositionInfo, cdnUrl: string, exportType: ExportType): Promise<void>;

package/dist/types/index.d.ts

@@ -20,9 +20,3 @@ export type LayerInfo = {
         opacity?: number;
     };
 };
-export type Font = {
-    name: string;
-    family: string;
-    weight: string;
-    style: string;
-};

package/dist/utils/fonts.d.ts

@@ -1,5 +1,49 @@
-import { Env, Font } from '../types';
-export declare function loadFont(name: string, vapiUrl: string, accessToken: string): Promise<string | undefined>;
+import { Env } from '../types';
+export type Font = {
+    name: string;
+    family: string;
+    weight: string;
+    style: string;
+};
+/**
+ * Registry fields stay raw.
+ * Rendering uses this separately serialized CSS value.
+ */
+export type ResolvedFont = Font & {
+    cssFamily: string;
+};
+/** Font resources and loaded faces belong to one map's organization. */
+export declare class Fonts {
+    private vapiUrl;
+    private accessToken;
+    private cache;
+    private directFonts;
+    private registrations;
+    readonly fontMap: Map<string, Font>;
+    usedFontsCache: Map<string, Font[]>;
+    fontInjectedSvgCache: Map<string, string>;
+    constructor(fontMap: Map<string, Font>, vapiUrl: string, accessToken: string);
+    resolve(name: string, weight?: string): ResolvedFont;
+    loadFont(name: string): Promise<string | undefined>;
+    loadReference(name: string, weight?: string): Promise<void>;
+    getDirectFont(name: string): Font | undefined;
+}
 export declare function loadFontFaces(env: Env, vapiUrl: string, accessToken: string): Promise<Map<string, Font>>;
+/**
+ * Serialize one literal family name as a CSS string (not a fallback list).
+ */
+export declare function cssFontFamily(name: string): string;
+/**
+ * Quote named families individually, preserving quoted names and generic keywords.
+ */
+export declare function cssFontFamilies(value: string): string;
+/**
+ * Decode CSS family-list syntax before resource/API lookup.
+ */
+export declare function parseFontFamilies(value: string): Array<{
+    name: string;
+    generic: boolean;
+}>;
+export declare function matchFontFace(faces: Iterable<Font>, family: string, weight: string | number, style?: string): Font | undefined;
+export declare function fontAttrs(font: ResolvedFont): string;
 export declare function fontKey(family: string, weight: string, style: string): string;
-export declare function fallbackFont(font: string): string;

package/dist/utils/geoTiff.d.ts

@@ -0,0 +1,13 @@
+import { Map } from '@mapcreator/maplibre-gl';
+export declare function geoTiffMetadata(map: Map, { width, height }: {
+    width: number;
+    height: number;
+}): {
+    width: number;
+    height: number;
+    GTRasterTypeGeoKey: number;
+    PhotometricInterpretation: number;
+    ProjectedCSTypeGeoKey: number;
+    ModelTiepoint: number[];
+    ModelPixelScale: never[];
+};

package/dist/utils/helpers.d.ts

@@ -1,7 +1,7 @@
-import { JobObject, JobObjectDataBindings, JobObjectStoredValue } from '../types/jobObject';
 import { Map } from '@mapcreator/maplibre-gl';
 import { LngLat } from '../types/geometry';
 import { ExportType } from '../types';
+import { JobObject, JobObjectDataBindings, JobObjectFormat, JobObjectStoredValue } from '../types/jobObject';
 export declare const numberRe: RegExp;
 export declare function degToRad(angle: number): number;
 export declare function radToDeg(angle: number): number;
@@ -20,6 +20,8 @@ export declare function bindingToPrimitive(binding: JobObjectStoredValue | undef
 export declare function getYoutubeVideoId(url: string): string | undefined;
 type Unit = 'millimeter' | 'centimeter' | 'inch' | 'pixel' | 'pica' | 'kilometer' | 'mile' | 'nauticalMile' | 'foot' | 'meter';
 export declare function unitConvert(from: Unit, to: Unit, value: number): number;
+export declare function toPixels(value: number, unit?: Unit, dpi?: number): number;
+export declare function getMaxCanvasSize(): [number, number];
 export declare function getEvenSize(value: number): number;
 export declare function lerp(value1: number, value2: number, ratio: number): number;
 export declare function unlerp(min: number, max: number, value: number): number;
@@ -30,7 +32,7 @@ export declare function stripQuotes(s: string): string;
  * Fast hash function for non-cryptographic use
  */
 export declare function fnv32b(str: string): string;
-export declare function calculateScaleCorrection(jobObject: JobObject, container: HTMLElement, exportType: ExportType): number;
+export declare function calculateScaleCorrection(jobObject: JobObject, container: HTMLElement, exportType: ExportType, format: JobObjectFormat): number;
 export declare function almostEqual(a: number, b: number, delta?: number): boolean;
 export declare function pause(ms: number): Promise<void>;
 export declare function visibleOnGlobe(map: Map, lng: number, lat: number): boolean;

package/dist/utils/labelFreeAreas.d.ts

@@ -0,0 +1,3 @@
+import { Map } from '@mapcreator/maplibre-gl';
+import { ExportType } from '../types';
+export declare function updateLabelFreeAreas(map: Map, exportType: ExportType): void;

package/dist/utils/pdfFonts.d.ts

@@ -0,0 +1,22 @@
+type PdfFont = {
+    name: string;
+    weight: number;
+    style: string;
+};
+type FontOptions = {
+    fauxBold: boolean;
+    fauxItalic: boolean;
+};
+type PdfDocument = {
+    registerFont(name: string, data: ArrayBuffer): unknown;
+};
+type FontResolver = {
+    registered: (family: string, weight: number, style: string) => PdfFont | undefined;
+    search: (family: string, weight: number, style: string) => Promise<string | undefined>;
+    load: (name: string) => Promise<ArrayBuffer | undefined>;
+};
+/**
+ * Each PDF document will own its resolution and physical-font registration caches.
+ */
+export declare function createPdfFontCallback(resolver: FontResolver): (family: string, requestedWeight: number, requestedStyle: string, doc: PdfDocument, fontOptions?: FontOptions) => Promise<string>;
+export {};

package/dist/utils/svg2pdf.d.ts

@@ -0,0 +1,21 @@
+import { Fonts } from './fonts';
+import { StyleSpecification } from '@mapcreator/maplibre-gl';
+type CMYK = [number, number, number, number];
+type RGB = [number, number, number];
+type API = {
+    vapiUrl: string;
+    accessToken: string;
+    apiUrl?: string | undefined;
+    bearerToken: string;
+};
+export declare function pdfExportOptions(mapstyle: StyleSpecification, fonts: Fonts, api: API): {
+    colorCallback: (inValue: [RGB, number] | undefined) => [CMYK, number] | undefined;
+    fontCallback: (family: string, requestedWeight: number, requestedStyle: string, doc: {
+        registerFont(name: string, data: ArrayBuffer): unknown;
+    }, fontOptions?: {
+        fauxBold: boolean;
+        fauxItalic: boolean;
+    }) => Promise<string>;
+    assumePt: boolean;
+};
+export {};

package/dist/utils/svgHelpers.d.ts

@@ -1,10 +1,19 @@
+import { Fonts, Font, ResolvedFont } from './fonts';
 import { JobObjectDataBindings } from '../types/jobObject';
 import { Map as MapLibre } from '@mapcreator/maplibre-gl';
 import { BBox as BBoxArray } from '../types/geometry';
 import { ColorGenerator } from './choropleth';
-import { Font } from '../types';
-export declare function escapeXML(str: string): string;
-export declare function createImage(svgString: string, width: number, height: number, fontMap: Map<string, Font>, vapiUrl: string, accessToken: string): Promise<HTMLImageElement>;
+export declare function escapeXML(str: unknown): string;
+export declare function createImage(svgString: string, width: number, height: number, fonts: Fonts): Promise<HTMLImageElement>;
+export declare function getAdornments(mapContainer: HTMLElement, containerRect?: DOMRect): Array<{
+    name: string | undefined;
+    svg: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}>;
+export declare function drawAdornments(ctx2d: OffscreenCanvasRenderingContext2D, svgCache: SvgCache, mapContainer: HTMLElement, containerRect?: DOMRect): Promise<void>;
 export interface SvgColor {
     name: string;
     color: Color | string | undefined;
@@ -14,8 +23,6 @@ export interface SvgText {
     text: string | undefined;
     isMultiline: boolean;
 }
-export declare function collectUsedFonts(svg: string, fontMap: Map<string, Font>): Font[];
-export declare function injectFonts(svg: string, fonts: Font[], fontBuffers: Array<string | undefined>): string;
 export declare function getBBox(svg: string): BBoxArray;
 export declare class SvgHelper {
     private _seen;
@@ -66,13 +73,17 @@ export declare class SvgHelper {
 export declare class SvgCache {
     private map;
     private keyCache;
-    fontMap: Map<string, Font>;
-    vapiUrl: string;
-    accessToken: string;
+    private promises;
+    fonts: Fonts;
     constructor(map: MapLibre, fontMap: Map<string, Font>, vapiUrl: string, accessToken: string);
     getMapLibreImageKey(svg: string, pixelRatio: number): string;
+    settledImages(): Promise<void>;
+    getFillPatterns(pixelRatio: number): {
+        name: string;
+        string: string;
+    }[];
 }
-export declare function measureTextBlock(lines: string[], fontFamily: string, fontSize: number): {
+export declare function measureTextBlock(lines: string[], fontFamily: ResolvedFont, fontSize: number): {
     width: number;
     height: number;
     ascent: number;
@@ -95,4 +106,9 @@ declare class Color {
     sameColor(color: Color): boolean;
     toString(): string;
 }
+export declare function splitColor(color: string): {
+    color: string;
+    opacity: number;
+};
+export declare function colorAttrs(value: string, property?: 'fill' | 'stroke' | 'stop-color'): string;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapcreator/sdk",
-  "version": "3.0.0",
+  "version": "3.1.1",
   "engines": {
     "node": "^24.0.0",
     "npm": "^11.0.0"