@basemaps/cli-vector 8.1.0 → 8.2.0

package/build/index.d.ts

@@ -1,29 +1,107 @@
-export declare const vectorCli: Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
+export declare const VectorCli: Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
     parse(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<{
+        command: "join";
+        args: {
+            fromFile: URL[];
+            filename: string;
+            tileMatrix: string;
+            title: string;
+            target: URL | undefined;
+            verbose: boolean;
+            extraVerbose: boolean;
+        };
+    } | {
         command: "extract";
         args: {
-            path: string;
+            schema: URL;
             cache: string;
-            group: number;
+            tileMatrix: string;
+            verbose: boolean;
+            extraVerbose: boolean;
+        };
+    } | {
+        command: "create";
+        args: {
+            path: URL[];
+            fromFile: URL[] | undefined;
+            concurrency: number;
+            join: boolean;
+            verbose: boolean;
+            extraVerbose: boolean;
+        };
+    } | {
+        command: "analyse";
+        args: {
+            path: URL;
+            template: string;
+            target: URL;
             verbose: boolean;
             extraVerbose: boolean;
         };
     }>>;
 } & import("cmd-ts/dist/cjs/helpdoc.js").Named & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Descriptive & import("cmd-ts/dist/cjs/helpdoc.js").Versioned> & import("cmd-ts/dist/cjs/helpdoc.js").PrintHelp & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Versioned> & import("cmd-ts/dist/cjs/argparser.js").Register & import("cmd-ts/dist/cjs/runner.js").Handling<{
+    command: "join";
+    args: {
+        fromFile: URL[];
+        filename: string;
+        tileMatrix: string;
+        title: string;
+        target: URL | undefined;
+        verbose: boolean;
+        extraVerbose: boolean;
+    };
+} | {
     command: "extract";
     args: {
-        path: string;
+        schema: URL;
         cache: string;
-        group: number;
+        tileMatrix: string;
+        verbose: boolean;
+        extraVerbose: boolean;
+    };
+} | {
+    command: "create";
+    args: {
+        path: URL[];
+        fromFile: URL[] | undefined;
+        concurrency: number;
+        join: boolean;
+        verbose: boolean;
+        extraVerbose: boolean;
+    };
+} | {
+    command: "analyse";
+    args: {
+        path: URL;
+        template: string;
+        target: URL;
         verbose: boolean;
         extraVerbose: boolean;
     };
 }, {
+    command: "join";
+    value: Promise<void>;
+} | {
     command: "extract";
     value: Promise<void>;
+} | {
+    command: "create";
+    value: Promise<void>;
+} | {
+    command: "analyse";
+    value: Promise<void>;
 }> & {
     run(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<{
+        command: "join";
+        value: Promise<void>;
+    } | {
         command: "extract";
         value: Promise<void>;
+    } | {
+        command: "create";
+        value: Promise<void>;
+    } | {
+        command: "analyse";
+        value: Promise<void>;
     }>>;
 };

package/build/index.js

@@ -1,10 +1,16 @@
 // eslint-disable-next-line simple-import-sort/imports
 import { subcommands } from 'cmd-ts';
 import { ExtractCommand } from './cli/cli.extract.js';
-export const vectorCli = subcommands({
+import { CreateCommand } from './cli/cli.create.js';
+import { JoinCommand } from './cli/cli.join.js';
+import { AnalyseCommand } from './cli/cli.analyse.js';
+export const VectorCli = subcommands({
     name: 'vector',
     cmds: {
         extract: ExtractCommand,
+        create: CreateCommand,
+        join: JoinCommand,
+        analyse: AnalyseCommand,
     },
 });
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;IACnC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE;QACJ,OAAO,EAAE,cAAc;KACxB;CACF,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;IACnC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE;QACJ,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB;CACF,CAAC,CAAC"}

package/build/modify/consts.d.ts

@@ -0,0 +1 @@
+export declare const MajorHighWays: Readonly<Set<string>>;

package/build/modify/consts.js

@@ -0,0 +1,23 @@
+export const MajorHighWays = new Set([
+    '1',
+    '1B',
+    '2',
+    '3',
+    '3A',
+    '4',
+    '5',
+    '6',
+    '6A',
+    '7',
+    '8',
+    '8A',
+    '18',
+    '20',
+    '51',
+    '76',
+    '73',
+    '1,3',
+    '6,94',
+    '6,96',
+]);
+//# sourceMappingURL=consts.js.map

package/build/modify/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/modify/consts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAA0B,IAAI,GAAG,CAAC;IAC1D,GAAG;IACH,IAAI;IACJ,GAAG;IACH,GAAG;IACH,IAAI;IACJ,GAAG;IACH,GAAG;IACH,GAAG;IACH,IAAI;IACJ,GAAG;IACH,GAAG;IACH,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,MAAM;IACN,MAAM;CACP,CAAC,CAAC"}

package/build/modify/layers/__test__/contours.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/modify/layers/__test__/contours.test.js

@@ -0,0 +1,59 @@
+import { describe, it } from 'node:test';
+import { LogConfig } from '@basemaps/shared';
+import { strictEqual } from 'assert';
+import { handleKindContours, handleKindPeak } from '../contours.js';
+describe('HandleLayerContours', () => {
+    const Logger = LogConfig.get();
+    const FakeFeature = {
+        type: 'Feature',
+        properties: {},
+        tippecanoe: {
+            layer: 'contours',
+            minzoom: -1,
+            maxzoom: -1,
+        },
+        geometry: {
+            type: 'MultiLineString',
+            coordinates: [
+                [
+                    [-1, -1, -1],
+                    [-1, -1, -1],
+                ],
+            ],
+        },
+    };
+    describe('handleKindContours', () => {
+        it('should assign a feature a type of index', () => {
+            const feature = structuredClone(FakeFeature);
+            feature.properties['elevation'] = 100;
+            const modifiedFeature = handleKindContours(feature, Logger);
+            strictEqual(modifiedFeature.properties['type'], 'index');
+            strictEqual(modifiedFeature.tippecanoe.minzoom, FakeFeature.tippecanoe.minzoom);
+        });
+        it("should override a feature's minzoom, but not assign it a type", () => {
+            const feature = structuredClone(FakeFeature);
+            feature.properties['elevation'] = 105;
+            const modifiedFeature = handleKindContours(feature, Logger);
+            strictEqual(modifiedFeature.properties['type'], undefined);
+            strictEqual(modifiedFeature.tippecanoe.minzoom, 14);
+        });
+    });
+    describe('handleKindPeak', () => {
+        it('should assign a feature a rank from 1-5', () => {
+            const cases = [
+                { elevation: 2000, rank: 1 },
+                { elevation: 1500, rank: 2 },
+                { elevation: 1000, rank: 3 },
+                { elevation: 500, rank: 4 },
+                { elevation: 0, rank: 5 },
+            ];
+            for (const { elevation, rank } of cases) {
+                const feature = structuredClone(FakeFeature);
+                feature.properties['elevation'] = elevation;
+                const modifiedFeature = handleKindPeak(feature, Logger);
+                strictEqual(modifiedFeature.properties['rank'], rank);
+            }
+        });
+    });
+});
+//# sourceMappingURL=contours.test.js.map

package/build/modify/layers/__test__/contours.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contours.test.js","sourceRoot":"","sources":["../../../../src/modify/layers/__test__/contours.test.ts"],"names":[],"mappings":"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"}

package/build/modify/layers/contours.d.ts

@@ -0,0 +1,28 @@
+import { LogType } from '@basemaps/shared';
+import { VectorCreationOptions } from '../../stac.js';
+import { VectorGeoFeature } from '../../types/VectorGeoFeature.js';
+/**
+ * Processes a 'contours' layer feature.
+ *
+ * @param feature - the feature to process
+ * @param options - the layer's options
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+export declare function handleLayerContours(feature: VectorGeoFeature, options: VectorCreationOptions, logger: LogType): VectorGeoFeature;
+/**
+ * Processes a 'contours' layer feature with a 'kind' value of 'contours'.
+ *
+ * @param feature - the feature to process
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+export declare function handleKindContours(feature: VectorGeoFeature, logger: LogType): VectorGeoFeature;
+/**
+ * Processes a 'contours' layer feature with a 'kind' value of 'peak'.
+ *
+ * @param feature - the feature to process
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+export declare function handleKindPeak(feature: VectorGeoFeature, logger: LogType): VectorGeoFeature;

package/build/modify/layers/contours.js

@@ -0,0 +1,90 @@
+/**
+ * Processes a 'contours' layer feature.
+ *
+ * @param feature - the feature to process
+ * @param options - the layer's options
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+export function handleLayerContours(feature, options, logger) {
+    logger.trace({}, 'HandleContours:Start');
+    const kind = options.layer.tags['kind'];
+    switch (kind) {
+        case 'contours':
+            feature = handleKindContours(feature, logger);
+            break;
+        case 'peak':
+            feature = handleKindPeak(feature, logger);
+            break;
+    }
+    logger.trace({}, 'HandleContours:End');
+    return feature;
+}
+/**
+ * Processes a 'contours' layer feature with a 'kind' value of 'contours'.
+ *
+ * @param feature - the feature to process
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+export function handleKindContours(feature, logger) {
+    logger?.trace({}, 'HandleKindContours:Start');
+    feature = structuredClone(feature);
+    // read the 'elevation' property
+    const elevation = feature.properties['elevation'];
+    if (typeof elevation !== 'number')
+        throw new Error('Elevation is not a number');
+    // if 'elevation' is divisble by 100 with no remainder
+    if (elevation % 100 === 0) {
+        // append 'type' property
+        const type = 'index';
+        feature.properties['type'] = type;
+        logger?.trace({ type }, 'new/overidden tags');
+    }
+    else {
+        // override 'minzoom'
+        const minzoom = 14;
+        feature.tippecanoe.minzoom = minzoom;
+        logger?.trace({ minzoom }, 'overidden styles');
+    }
+    logger?.trace({}, 'HandleKindContours:End');
+    return feature;
+}
+/**
+ * Processes a 'contours' layer feature with a 'kind' value of 'peak'.
+ *
+ * @param feature - the feature to process
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+export function handleKindPeak(feature, logger) {
+    logger?.trace({}, 'HandleKindPeak:Start');
+    feature = structuredClone(feature);
+    // read the 'elevation' property
+    const elevation = feature.properties['elevation'];
+    // if 'elevation' is a number
+    if (typeof elevation === 'number') {
+        let rank;
+        if (elevation >= 2000) {
+            rank = 1;
+        }
+        else if (elevation >= 1500) {
+            rank = 2;
+        }
+        else if (elevation >= 1000) {
+            rank = 3;
+        }
+        else if (elevation >= 500) {
+            rank = 4;
+        }
+        else {
+            rank = 5;
+        }
+        // append 'rank' property
+        feature.properties['rank'] = rank;
+        logger?.trace({ rank }, 'new/overidden tags');
+    }
+    logger?.trace({}, 'HandleKindPeak:End');
+    return feature;
+}
+//# sourceMappingURL=contours.js.map

package/build/modify/layers/contours.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contours.js","sourceRoot":"","sources":["../../../src/modify/layers/contours.ts"],"names":[],"mappings":"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"}

package/build/modify/layers/place_labels.d.ts

@@ -0,0 +1,18 @@
+import { LogType } from '@basemaps/shared';
+import { VectorGeoFeature } from '../../types/VectorGeoFeature.js';
+import { VectorGeoPlaceLabelsFeature } from '../schema.js';
+export declare const PlaceLabelsFeatures: Map<string, VectorGeoPlaceLabelsFeature>;
+/**
+ *  Processes a 'place_labels' layer feature. Specifically, features of the gazatteer dataset.
+ *
+ *  The gazatteer dataset contains multiple features that technically describe the same feature, such that:
+ * - 1. One feature will contain all of the expected properties.
+ * - 2. The other features will have 'null' values for all expected properties, except `label` and `zoom_level`.
+ * - 3. All of the features describing the same feature will have the same `label` value, but different `zoom_level` values.
+ *
+ * @param feature - the feature to process
+ * @param options - the layer's options
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+export declare function handleLayerPlaceLabels(feature: VectorGeoFeature, logger: LogType): VectorGeoFeature | null;

package/build/modify/layers/place_labels.js

@@ -0,0 +1,122 @@
+import { z } from 'zod';
+import { zPlaceLabelsProperties, zPlaceLabelsTippecanoe, } from '../parser.js';
+export const PlaceLabelsFeatures = new Map();
+/**
+ *  Processes a 'place_labels' layer feature. Specifically, features of the gazatteer dataset.
+ *
+ *  The gazatteer dataset contains multiple features that technically describe the same feature, such that:
+ * - 1. One feature will contain all of the expected properties.
+ * - 2. The other features will have 'null' values for all expected properties, except `label` and `zoom_level`.
+ * - 3. All of the features describing the same feature will have the same `label` value, but different `zoom_level` values.
+ *
+ * @param feature - the feature to process
+ * @param options - the layer's options
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+export function handleLayerPlaceLabels(feature, logger) {
+    logger.trace({}, 'HandlePlaceLabels:Start');
+    feature = structuredClone(feature);
+    // read the 'label' and 'zoom_level' properties (required)
+    const label = feature.properties['label'];
+    if (typeof label !== 'string')
+        throw new Error('Label property is not a string');
+    const zoomLevel = feature.properties['zoom_level'];
+    if (typeof zoomLevel !== 'number')
+        throw new Error('Zoom level is not a number');
+    const storedFeature = PlaceLabelsFeatures.get(label);
+    if (storedFeature == null) {
+        const newFeature = createNewFeature(feature, label, zoomLevel, logger);
+        if (newFeature == null)
+            return null;
+        PlaceLabelsFeatures.set(label, newFeature);
+        logger.trace({}, 'HandlePlaceLabels:End');
+        return newFeature;
+    }
+    // update the stored feature's 'minzoom' value
+    if (zoomLevel < storedFeature.tippecanoe.minzoom) {
+        storedFeature.tippecanoe.minzoom = zoomLevel;
+        PlaceLabelsFeatures.set(label, storedFeature);
+    }
+    // update the stored feature's 'maxzoom' value
+    if (zoomLevel > storedFeature.tippecanoe.maxzoom) {
+        storedFeature.tippecanoe.maxzoom = zoomLevel;
+        PlaceLabelsFeatures.set(label, storedFeature);
+    }
+    logger.trace({}, 'HandlePlaceLabels:End');
+    return storedFeature;
+}
+/**
+ * Parses a 'place_labels' layer feature into a VectorGeoPlaceLabelsFeature object.
+ *
+ * @param feature - the feature to process
+ * @param label - the feature's 'label' property
+ * @param zoomLevel - the feature's 'zoom_level' property
+ * @param logger - a logger instance
+ * @returns a VectorGeoPlaceLabelsFeature object
+ */
+function createNewFeature(feature, label, zoomLevel, logger) {
+    let properties;
+    let tippecanoe;
+    try {
+        properties = zPlaceLabelsProperties.parse({
+            label,
+            style: feature.properties['style'],
+            place: feature.properties['place'],
+            adminlevel: feature.properties['adminlevel'],
+            natural: feature.properties['natural'],
+            water: feature.properties['water'],
+        });
+        tippecanoe = zPlaceLabelsTippecanoe.parse({
+            layer: 'place_labels',
+            minzoom: zoomLevel,
+            maxzoom: zoomLevel,
+        });
+    }
+    catch (e) {
+        if (e instanceof z.ZodError) {
+            logger.trace({ label }, 'Failed to parse expected properties. Discarding feature.');
+            return null;
+        }
+        else {
+            throw new Error('An unexpected error occurred.');
+        }
+    }
+    const newFeature = {
+        type: feature.type,
+        properties: {
+            name: properties.label,
+            kind: convertStyleToKind(properties.style, tippecanoe.minzoom),
+            place: properties.place,
+            adminlevel: properties.adminlevel,
+            natural: properties.natural,
+            water: properties.water,
+        },
+        geometry: feature.geometry,
+        tippecanoe,
+    };
+    return newFeature;
+}
+/**
+ * Determines a feature's 'kind' based on its 'styles' property.
+ *
+ * @param style - the feature's 'style' property
+ */
+function convertStyleToKind(style, minzoom) {
+    if (style.startsWith('ANT'))
+        return 'ant';
+    if (style.startsWith('GEO'))
+        return 'geo';
+    if (style.startsWith('TWN')) {
+        if (minzoom <= 8)
+            return 'city';
+        if (style === 'TWN1')
+            return 'suburb';
+        if (style === 'TWN2')
+            return 'town';
+        if (style === 'TWN3')
+            return 'city';
+    }
+    return '';
+}
+//# sourceMappingURL=place_labels.js.map

package/build/modify/layers/place_labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"place_labels.js","sourceRoot":"","sources":["../../../src/modify/layers/place_labels.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GAGvB,MAAM,cAAc,CAAC;AAGtB,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAuC,CAAC;AAElF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAyB,EAAE,MAAe;IAC/E,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,yBAAyB,CAAC,CAAC;IAC5C,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAEnC,0DAA0D;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAEjF,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IACnD,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAEjF,MAAM,aAAa,GAAG,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrD,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACvE,IAAI,UAAU,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;QAEpC,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAE3C,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,uBAAuB,CAAC,CAAC;QAC1C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,8CAA8C;IAC9C,IAAI,SAAS,GAAG,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACjD,aAAa,CAAC,UAAU,CAAC,OAAO,GAAG,SAAS,CAAC;QAC7C,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,8CAA8C;IAC9C,IAAI,SAAS,GAAG,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACjD,aAAa,CAAC,UAAU,CAAC,OAAO,GAAG,SAAS,CAAC;QAC7C,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,uBAAuB,CAAC,CAAC;IAC1C,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,gBAAgB,CACvB,OAAyB,EACzB,KAAa,EACb,SAAiB,EACjB,MAAe;IAEf,IAAI,UAAsC,CAAC;IAC3C,IAAI,UAAsC,CAAC;IAE3C,IAAI,CAAC;QACH,UAAU,GAAG,sBAAsB,CAAC,KAAK,CAAC;YACxC,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;YAClC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;YAClC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC;YAC5C,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;YACtC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;SACnC,CAAC,CAAC;QAEH,UAAU,GAAG,sBAAsB,CAAC,KAAK,CAAC;YACxC,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,0DAA0D,CAAC,CAAC;YACpF,OAAO,IAAI,CAAC;QACd,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG;QACjB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE;YACV,IAAI,EAAE,UAAU,CAAC,KAAK;YACtB,IAAI,EAAE,kBAAkB,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC;YAC9D,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;SACxB;QACD,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,UAAU;KACX,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,KAAa,EAAE,OAAe;IACxD,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,IAAI,OAAO,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC;QAChC,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,QAAQ,CAAC;QACtC,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC;QACpC,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/build/modify/layers/pois.d.ts

@@ -0,0 +1,11 @@
+import { LogType } from '@basemaps/shared';
+import { VectorGeoFeature } from '../../types/VectorGeoFeature.js';
+/**
+ * Processes a 'pois' layer feature.
+ *
+ * @param feature - the feature to process
+ * @param options - the layer's options
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+export declare function handleLayerPois(feature: VectorGeoFeature, logger: LogType): VectorGeoFeature | null;

package/build/modify/layers/pois.js

@@ -0,0 +1,27 @@
+/**
+ * Processes a 'pois' layer feature.
+ *
+ * @param feature - the feature to process
+ * @param options - the layer's options
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+export function handleLayerPois(feature, logger) {
+    logger.trace({}, 'HandlePois:Start');
+    feature = structuredClone(feature);
+    // REVIEW: We don't have any use for this criteria as we don't include the following layers:
+    // 1. 50245-nz-building-points-topo-150k
+    // 2. 50246-nz-building-polygons-topo-150k
+    if (feature.properties['building'] === 'building') {
+        const bldgUse = feature.properties['bldg_use'];
+        if (bldgUse == null) {
+            // discard the feature
+            logger.trace({}, 'HandlePois:End');
+            return null;
+        }
+        feature.properties['building'] = bldgUse;
+    }
+    logger.trace({}, 'HandlePois:End');
+    return feature;
+}
+//# sourceMappingURL=pois.js.map

package/build/modify/layers/pois.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pois.js","sourceRoot":"","sources":["../../../src/modify/layers/pois.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyB,EAAE,MAAe;IACxE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC;IACrC,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAEnC,4FAA4F;IAC5F,wCAAwC;IACxC,0CAA0C;IAC1C,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,UAAU,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAE/C,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,sBAAsB;YACtB,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACnC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/build/modify/layers/public_transport.d.ts

@@ -0,0 +1,12 @@
+import { LogType } from '@basemaps/shared';
+import { VectorCreationOptions } from '../../stac.js';
+import { VectorGeoFeature } from '../../types/VectorGeoFeature.js';
+/**
+ * Processes a 'public_transport' layer feature.
+ *
+ * @param feature - the feature to process
+ * @param options - the layer's options
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+export declare function handleLayerPublicTransport(feature: VectorGeoFeature, options: VectorCreationOptions, logger: LogType): VectorGeoFeature;

package/build/modify/layers/public_transport.js

@@ -0,0 +1,53 @@
+import * as poly from 'polylabel';
+const polylabel = poly.default;
+/**
+ * Processes a 'public_transport' layer feature.
+ *
+ * @param feature - the feature to process
+ * @param options - the layer's options
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+export function handleLayerPublicTransport(feature, options, logger) {
+    logger.trace({}, 'HandlePublicTransport:Start');
+    const kind = options.layer.tags['kind'];
+    switch (kind) {
+        case 'aerodrome':
+            feature = handleKindAerodrome(feature, logger);
+            break;
+    }
+    logger.trace({}, 'HandlePublicTransport:End');
+    return feature;
+}
+/**
+ * Processes a 'public_transport' layer feature with a 'kind' value of 'aerodrome'.
+ *
+ * @param feature - the feature to process
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+function handleKindAerodrome(feature, logger) {
+    logger.trace({}, 'HandleKindAerodrome:Start');
+    feature = structuredClone(feature);
+    const coordinates = getCoordinates(feature.geometry, logger);
+    // REVIEW: the following resource suggests using a precision value of 0.000001 for geo-coords:
+    // https://github.com/mapbox/polylabel?tab=readme-ov-file#javascript-usage
+    // currently, we use the default value of 1.0
+    const inaccessibilityPole = polylabel(coordinates);
+    const point = { type: 'Point', coordinates: inaccessibilityPole };
+    feature.geometry = point;
+    logger.trace({}, 'HandleKindAerodrome:End');
+    return feature;
+}
+function getCoordinates(geometry, logger) {
+    switch (geometry.type) {
+        case 'MultiPolygon':
+            // TODO: Worth to try create a point for each polygon and see how it looks line.
+            return geometry.coordinates[0];
+        case 'Polygon':
+            return geometry.coordinates;
+    }
+    logger.error({ type: geometry.type }, 'Unsupported geometry type');
+    throw new Error('Unsupported geometry type');
+}
+//# sourceMappingURL=public_transport.js.map

package/build/modify/layers/public_transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public_transport.js","sourceRoot":"","sources":["../../../src/modify/layers/public_transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAKlC,MAAM,SAAS,GAAG,IAAI,CAAC,OAA8F,CAAC;AAEtH;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAyB,EACzB,OAA8B,EAC9B,MAAe;IAEf,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,6BAA6B,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAExC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW;YACd,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC/C,MAAM;IACV,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,2BAA2B,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,OAAyB,EAAE,MAAe;IACrE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,2BAA2B,CAAC,CAAC;IAC9C,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAEnC,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7D,8FAA8F;IAC9F,0EAA0E;IAC1E,6CAA6C;IAC7C,MAAM,mBAAmB,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAU,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACzE,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC;IAEzB,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,yBAAyB,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CAAC,QAAkB,EAAE,MAAe;IACzD,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,cAAc;YACjB,gFAAgF;YAChF,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACjC,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC,WAAW,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,2BAA2B,CAAC,CAAC;IACnE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;AAC/C,CAAC"}

package/build/modify/layers/street_labels.d.ts

@@ -0,0 +1,12 @@
+import { LogType } from '@basemaps/shared';
+import { VectorCreationOptions } from '../../stac.js';
+import { VectorGeoFeature } from '../../types/VectorGeoFeature.js';
+/**
+ * Processes a 'street_labels' layer feature.
+ *
+ * @param feature - the feature to process
+ * @param options - the layer's options
+ * @param logger - a logger instance
+ * @returns the processed feature
+ */
+export declare function handleLayerStreetLabels(feature: VectorGeoFeature, options: VectorCreationOptions, logger: LogType): VectorGeoFeature;