@mapcreator/sdk 0.0.1

package/dist/utils/graphhopper.d.ts

@@ -0,0 +1,6 @@
+import { LngLat } from '../types/geometry';
+export declare class GraphHopperGeocoderService {
+    getLocationInBounds(location: string, center: LngLat, limit?: number): Promise<any>;
+    _callGraphHopper(params: any): Promise<any>;
+    _mapResults(results: any): any;
+}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,28 @@
+import { JobObjectDataBindings, JobObjectStoredValue } from '../types/jobObject';
+import { LngLat } from '../types/geometry';
+export declare const numberRe: RegExp;
+export declare function degToRad(angle: number): number;
+export declare function radToDeg(angle: number): number;
+export declare function calcDistance(lngLat1: LngLat, lngLat2: LngLat): number;
+export declare function stringToId(str: string): number;
+/**
+ * Resolves a potential binding reference.
+ *
+ * 1. If the string starts with a $, it is considered a binding reference. The value of the binding
+ *    is then returned.
+ * 2. Otherwise, the string is returned as is.
+ */
+export declare function resolveBinding(str: string, bindings: JobObjectDataBindings): string;
+export declare function bindingToString(binding: JobObjectStoredValue | undefined): string;
+export declare function bindingToPrimitive(binding: JobObjectStoredValue | undefined): string | number | boolean | null;
+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 lerp(value1: number, value2: number, ratio: number): number;
+export declare function unlerp(min: number, max: number, value: number): number;
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Fast hash function for non-cryptographic use
+ */
+export declare function fnv32b(str: string): string;
+export {};

package/dist/utils/language.d.ts

@@ -0,0 +1,19 @@
+import { Map } from '@mapcreator/maplibre-gl';
+export declare function setLanguage(language: string, map: Map): void;
+export declare const LanguageNotation: Readonly<{
+    THREE: "ISO 639-2/B";
+    API: "ISO 639-2/B";
+    TWO: "ISO 639-1";
+    MAPLIBRE_COMPAT: "ISO 639-1";
+    ENDONYM: "name";
+    NAME: "name";
+    LOCALE: "locale";
+    i18n: "locale";
+}>;
+export declare const LanguageCodes: readonly {
+    "ISO 639-1": string;
+    "ISO 639-2/B": string;
+    name: string;
+    locale: string;
+}[];
+export declare function transformLanguageCode(input: string, type?: (typeof LanguageNotation)[keyof typeof LanguageNotation]): string;

package/dist/utils/models.d.ts

@@ -0,0 +1,16 @@
+import { LngLat, Position } from '../types/geometry';
+import { JobObjectPolygon } from '../types/jobObject';
+import { ModelBindings } from '../types';
+import { Map } from '@mapcreator/maplibre-gl';
+export declare function calculateCircle(center: LngLat, radius: number): Array<[number, number]>;
+export declare function calculateRadiusLine(center: LngLat, radius: number, bearing: number): Position[];
+export declare function calculatePolygonGeometry(polygon: JobObjectPolygon): Position[][];
+export declare function getAreaLayerId(groupId: string, area: {
+    vectorUrl: string;
+    sourceLayerId: string;
+}): string;
+export declare function getAreaSourceId(area: {
+    vectorUrl: string;
+}): string;
+export declare function getBoundValues(modelBindings: ModelBindings[], dataColumn: string): Array<number | string>;
+export declare function getLineAngle(line: Position[], map: Map): number;

package/dist/utils/overlays.d.ts

@@ -0,0 +1,4 @@
+import { Map, LayerSpecification } from '@mapcreator/maplibre-gl';
+export declare function loadOverlays(overlays: string[], map: Map, vapiUrl: string, accessToken: string, styleOverrides?: {
+    [layerId: string]: Partial<LayerSpecification>;
+}): Promise<void>;

package/dist/utils/scalebar.d.ts

@@ -0,0 +1,2 @@
+export declare function floatToFraction(x: number, error?: number): number[];
+export declare function getRoundNum(num: number): number;

package/dist/utils/svgHelpers.d.ts

@@ -0,0 +1,90 @@
+import { JobObjectDataBindings } from '../types/jobObject';
+import { Map as MapLibre } from '@mapcreator/maplibre-gl';
+import { ColorGenerator } from './choropleth';
+export declare function escapeXML(str: string): string;
+export declare function loadFonts(fontNames: string[], vapiUrl: string, accessToken: string): Promise<void>;
+export interface SvgColor {
+    name: string;
+    color: Color | string | undefined;
+}
+export interface SvgText {
+    name: string;
+    text: string | undefined;
+    isMultiline: boolean;
+}
+export declare class SvgHelper {
+    private _seen;
+    private _svg;
+    private _element;
+    constructor(svg: string);
+    private setElement;
+    getSvgString(): string;
+    getSvgSize(): [number, number];
+    getSvgColors(): SvgColor[];
+    setSvgColors(values: {
+        name: string;
+        color: Color;
+    }[]): SvgHelper;
+    getSvgTexts(): SvgText[];
+    setSvgTexts(values: Pick<SvgText, 'name' | 'text'>[]): SvgHelper;
+    private nodeChanged;
+    private autoResizeId;
+    private sameWidth;
+    private sameHeight;
+    private stack;
+    private rectPosition;
+    private pathPosition;
+    private copyPosition;
+    private resetSize;
+    private resetAnchor;
+    private getBBox;
+    /**
+     * Convert the points in the path shape into an array of points
+     * @param {Object} node of the shape to be used for this object
+     * @return {Object} node Array of coordinates
+     */
+    private nodeToPoints;
+    /**
+     * Convert the points in the given array into a path string
+     * @param {Object} pnts Node of the shape to be used for this object
+     * @return {String} String of the SVG path
+     */
+    private pointsToString;
+    private getCoordinate;
+    private setCoordinate;
+    private moveElement;
+    /**
+     * TODO Needs to be made DRY
+     */
+    private wrapText;
+}
+export declare class SvgCache {
+    private map;
+    private keyCache;
+    constructor(map: MapLibre);
+    getMapLibreImageKey(svg: string, pixelRatio: number): string;
+}
+export declare function measureTextBlock(lines: string[], fontFamily: string, fontSize: number): {
+    width: number;
+    height: number;
+    ascent: number;
+    descent: number;
+};
+export declare function getColorValue(dataBindings: JobObjectDataBindings, modelOrigValue: string | undefined, groupOrigValue: string | undefined, colorGenerator?: ColorGenerator, unmatchedColor?: string): string;
+export declare function getTextValue(dataBindings: JobObjectDataBindings, modelOrigValue: string | undefined, groupOrigValue: string | undefined): string | undefined;
+export declare function getSvgValue(dataBindings: JobObjectDataBindings, modelOrigValue: string | undefined, groupOrigValue: string | undefined): string | undefined;
+type RGB = [number, number, number];
+type RGBA = [number, number, number, number];
+declare class Color {
+    private readonly _error;
+    private readonly _rgba;
+    static fromRGB(rgb: RGB | RGBA): Color;
+    constructor(cstr: string);
+    get badValue(): boolean;
+    get a(): number;
+    get hex(): string;
+    get rgba(): RGBA;
+    sameColor(color: Color): boolean;
+    toString(): string;
+}
+export {};

package/dist/utils/template.d.ts

@@ -0,0 +1,5 @@
+import { Mode } from '../types';
+import { JobObjectDataBindings, PopupMedia } from '../types/jobObject';
+export declare function buildTemplate(template: string | undefined, popupMedia: PopupMedia | undefined, bindings: JobObjectDataBindings, mode: Mode): string;
+export declare const closeButtonHtml: string;
+export declare const cycleButtonsHtml: string;

package/dist/utils/youtube.d.ts

@@ -0,0 +1,4 @@
+import { PopupMedia, JobObjectDataBindings } from '../types/jobObject';
+export declare function getEmbedUrlFromYoutubeUrl(popupmedia: Extract<PopupMedia, {
+    type: 'video';
+}>, bindings: JobObjectDataBindings): string;

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@mapcreator/sdk",
+  "version": "0.0.1",
+  "description": "Mapcreator JavaScript SDK",
+  "type": "module",
+  "main": "./dist/mapcreator-sdk.umd.cjs",
+  "module": "./dist/mapcreator-sdk.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/mapcreator-sdk.js",
+      "require": "./dist/mapcreator-sdk.umd.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "prettier": "prettier --check src/",
+    "prettier:fix": "prettier --write src/",
+    "types": "tsc",
+    "lint": "eslint src --ext .vue,.js,.jsx,.cjs,.mjs,.ts,.tsx,.cts,.mts --ignore-path .gitignore",
+    "lint:fix": "eslint src --ext .vue,.js,.jsx,.cjs,.mjs,.ts,.tsx,.cts,.mts --fix --ignore-path .gitignore"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/mapcreator/sdk.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/d3-array": "^3.2.2",
+    "@types/d3-format": "^3.0.4",
+    "@types/d3-geo": "^3.1.0",
+    "@types/d3-interpolate": "^3.0.4",
+    "@types/d3-scale": "^4.0.9",
+    "@types/topojson-client": "^3.1.5",
+    "@vue/eslint-config-prettier": "^10.2.0",
+    "@vue/eslint-config-typescript": "^13.0.0",
+    "eslint": "^8.57.1",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-vue": "^9.33.0",
+    "prettier": "^3.8.1",
+    "typescript": "^5.9.3",
+    "vite": "^8.0.1",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "dependencies": {
+    "@mapcreator/maplibre-gl": "5.7.0-mc.5",
+    "@turf/area": "^7.3.4",
+    "@turf/bbox-clip": "^7.3.4",
+    "@turf/intersect": "^7.3.4",
+    "@turf/polygon-smooth": "^7.3.4",
+    "d3-array": "^3.2.4",
+    "d3-format": "^3.1.2",
+    "d3-geo": "^3.1.1",
+    "d3-interpolate": "^3.0.1",
+    "d3-scale": "^4.0.2",
+    "path-data-polyfill": "^1.0.10",
+    "topojson-client": "^3.1.0"
+  }
+}