@mapka/sprites-generate 0.4.1

package/lib/index.js

@@ -0,0 +1,5 @@
+export { generateLayout, generateLayoutUnique } from './generate.js';
+export { generateImage, generateOptimizedImage } from './image.js';
+export { extractSvgMetadata } from './metadata.js';
+export { validateMetadata } from './validate.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAE,oBAAoB,EAAC,MAAM,eAAe,CAAC;AACnE,OAAO,EAAC,aAAa,EAAE,sBAAsB,EAAC,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAC,kBAAkB,EAAC,MAAM,eAAe,CAAC;AACjD,OAAO,EAAC,gBAAgB,EAAC,MAAM,eAAe,CAAC"}

package/lib/metadata.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Parses a SVG document and extracts metadata from its shapes and paths.
+ *
+ * @param   {Object}                [img]
+ * @param   {Buffer|string}         [img.svg]             A string of the SVG.
+ * @param   {number}                [img.pixelRatio]      Ratio of a 72dpi screen pixel to the destination pixel density
+ * @param   {Function}              callback              Accepts two arguments, `err` and `metadata` Object
+ * @return  {Metadata}              metadata              An object with the extracted information.
+ */
+export function extractSvgMetadata(img?: {
+    svg?: string | Buffer<ArrayBufferLike> | undefined;
+    pixelRatio?: number | undefined;
+}, callback: Function): Metadata;
+//# sourceMappingURL=metadata.d.ts.map

package/lib/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.js"],"names":[],"mappings":"AA2IA;;;;;;;;GAQG;AACH,yCALG;IAAsC,GAAG;IACH,UAAU;CAChD,uBACU,QAAQ,CA6CpB"}

package/lib/metadata.js

@@ -0,0 +1,175 @@
+import { resolvePluginConfig } from 'svgo/lib/svgo/config.js';
+import { parseSvg } from 'svgo/lib/parser.js';
+import { stringifySvg } from 'svgo/lib/stringifier.js';
+import { invokePlugins } from 'svgo/lib/svgo/plugins.js';
+import svgBoundings from 'svg-boundings';
+const computePathBounds = svgBoundings.path;
+const metadataPrefix = 'mapbox-';
+// Removes `style` attribute. Otherwise, transforms will not apply. 
+// Refer to https://github.com/svg/svgo/blob/a9834efa1603198ae606765292215462ae193d0d/plugins/applyTransforms.js#L55-L57
+const removeStyleAttribute = {
+    name: 'removeStyleAttribute',
+    type: 'perItem',
+    fn: (item) => {
+        if (item.hasAttr('style'))
+            item.removeAttr('style');
+        return item;
+    }
+};
+// Transforms `id="mapbox-*"` into `mapbox:metadata="*"` so that the `convertPathData` step
+// resolves transforms.
+const renameMapboxMetadata = {
+    name: 'renameMapboxMetadata',
+    type: 'perItem',
+    fn: function (item) {
+        if (item.hasAttr('id')) {
+            const id = item.attr('id');
+            if (id.value.startsWith(metadataPrefix)) {
+                let valueSubstr = id.value.substring(metadataPrefix.length);
+                item.removeAttr('id');
+                item.addAttr({
+                    name: 'mapbox:metadata',
+                    value: valueSubstr,
+                    prefix: '',
+                    local: 'mapbox:metadata',
+                });
+            }
+        }
+        return item;
+    }
+};
+/**
+ * Decrease accuracy of floating-point numbers
+ * in path data keeping a specified number of decimals.
+ * Smart rounds values like 2.3491 to 2.35 instead of 2.349.
+ * Doesn't apply "smartness" if the number precision fits already.
+ *
+ * Taken from svgo at https://github.com/svg/svgo/blob/72db8eb/plugins/convertPathData.js#L773
+ */
+function strongRound(value, precision) {
+    if (!precision) {
+        precision = 3;
+    }
+    const error = +Math.pow(0.1, precision).toFixed(precision);
+    if (+value.toFixed(precision) !== value) {
+        var rounded = +value.toFixed(precision - 1);
+        value = +Math.abs(rounded - value).toFixed(precision + 1) >= error ?
+            +value.toFixed(precision) :
+            rounded;
+    }
+    return value;
+}
+// Plugin for use with svgo that extracts metadata from paths.
+const extractMapboxMetadata = {
+    name: 'extractMapboxMetadata',
+    type: 'perItem',
+    fn: function (item, params, info) {
+        if (item.isElem('path') && item.hasAttr('mapbox:metadata') && item.hasAttr('d')) {
+            const metadata = item.attr('mapbox:metadata');
+            const bounds = computePathBounds({ d: item.attr('d').value }, true);
+            // Make sure that we actually have a valid bounding box.
+            if (!Number.isFinite(bounds.left) || !Number.isFinite(bounds.right) ||
+                !Number.isFinite(bounds.top) || !Number.isFinite(bounds.bottom)) {
+                return true;
+            }
+            // Scale bounds by pixel ratio.
+            bounds.left = strongRound(bounds.left * info.pixelRatio);
+            bounds.top = strongRound(bounds.top * info.pixelRatio);
+            bounds.right = strongRound(bounds.right * info.pixelRatio);
+            bounds.bottom = strongRound(bounds.bottom * info.pixelRatio);
+            if (metadata.value.startsWith('stretch-x')) {
+                (info.metadata.stretchX = info.metadata.stretchX || []).push([bounds.left, bounds.right]);
+            }
+            else if (metadata.value.startsWith('stretch-y')) {
+                (info.metadata.stretchY = info.metadata.stretchY || []).push([bounds.top, bounds.bottom]);
+            }
+            else if (metadata.value === 'stretch') {
+                (info.metadata.stretchX = info.metadata.stretchX || []).push([bounds.left, bounds.right]);
+                (info.metadata.stretchY = info.metadata.stretchY || []).push([bounds.top, bounds.bottom]);
+            }
+            else if (metadata.value === 'content' || metadata.value === 'text-placeholder') {
+                const key = metadata.value === 'content' ? 'content' : 'placeholder';
+                info.metadata[key] = [bounds.left, bounds.top, bounds.right, bounds.bottom];
+            }
+        }
+        return true;
+    }
+};
+const preparePluginsConfig = [
+    {
+        name: 'cleanupIDs',
+        params: {
+            // Remove all IDs first so that `convertPathData` resolves transforms.
+            preservePrefixes: ['mapbox-']
+        }
+    },
+    renameMapboxMetadata,
+    'convertShapeToPath'
+].map(resolvePluginConfig);
+const collapsePluginsConfig = [
+    'convertTransform',
+    'moveGroupAttrsToElems',
+    'collapseGroups'
+].map(resolvePluginConfig);
+const extractPluginsConfig = [
+    removeStyleAttribute,
+    {
+        name: 'convertPathData',
+        params: {
+            // svg-boundings has trouble parsing consecutive numbers without space and without a leading
+            // zero. Therefore, we force leading zeros. Note that this option confusingly has to be set
+            // to _false_ to produce leading zeros.
+            // See https://github.com/kfitfk/svg-boundings/issues/2
+            leadingZero: false
+        }
+    },
+    extractMapboxMetadata
+].map(resolvePluginConfig);
+/**
+ * Parses a SVG document and extracts metadata from its shapes and paths.
+ *
+ * @param   {Object}                [img]
+ * @param   {Buffer|string}         [img.svg]             A string of the SVG.
+ * @param   {number}                [img.pixelRatio]      Ratio of a 72dpi screen pixel to the destination pixel density
+ * @param   {Function}              callback              Accepts two arguments, `err` and `metadata` Object
+ * @return  {Metadata}              metadata              An object with the extracted information.
+ */
+export function extractSvgMetadata(img, callback) {
+    try {
+        const imgSvg = Buffer.isBuffer(img.svg) ? img.svg.toString('utf-8') : img.svg;
+        let result = parseSvg(imgSvg);
+        // We'll add the metadata that we extract in the svgo plugin above to this object.
+        const info = {
+            metadata: {},
+            pixelRatio: Number.isFinite(img.pixelRatio) && img.pixelRatio || 1
+        };
+        let previousSVG;
+        let svg = img.svg;
+        try {
+            // A few initial plugins prepare the data, e.g. by moving IDs to custom attributes.
+            result = invokePlugins(result, info, preparePluginsConfig);
+            // We'll walk through the plugins that collapse groups until there are no changes to the output.
+            do {
+                previousSVG = svg;
+                result = invokePlugins(result, info, collapsePluginsConfig);
+                svg = stringifySvg(result).data;
+            } while (previousSVG !== svg);
+            // Finally, we'll run through the plugins that actually read and parse the metadata.
+            invokePlugins(result, info, extractPluginsConfig);
+        }
+        catch (err) {
+            return callback(err);
+        }
+        // Sort stretches ascending.
+        for (const key of ['stretchX', 'stretchY']) {
+            if (info.metadata[key]) {
+                info.metadata[key].sort((a, b) => a[0] - b[0]);
+            }
+        }
+        callback(null, info.metadata);
+    }
+    catch (err) {
+        return callback(err);
+    }
+}
+//# sourceMappingURL=metadata.js.map

package/lib/metadata.js.map

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

package/lib/types.d.ts

@@ -0,0 +1,37 @@
+import type { Image } from "@mapnik/mapnik";
+import type { Metadata } from "./validate.js";
+export interface SvgImage {
+    svg: Buffer;
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    buffer: Image;
+}
+export interface DataSvgImage extends Metadata {
+    svg: Buffer;
+    id: string;
+    width: number;
+    height: number;
+    buffer: Image;
+}
+export interface DataLayout {
+    [key: string]: {
+        width: number;
+        height: number;
+        x: number;
+        y: number;
+        pixelRatio: number;
+        content?: [number, number, number, number];
+        stretchX?: [number, number][];
+        stretchY?: [number, number][];
+        placeholder?: [number, number, number, number];
+    };
+}
+export interface ImgLayout {
+    width: number;
+    height: number;
+    items: SvgImage[];
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QAC9B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QAC9B,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;KAChD,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB"}

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/lib/validate.d.ts

@@ -0,0 +1,20 @@
+/** biome-ignore-all lint/suspicious/noExplicitAny: nature of this validate function */
+export interface Metadata {
+    x: number;
+    y: number;
+    placeholder?: [number, number, number, number];
+    content?: [number, number, number, number];
+    stretchX?: [number, number][];
+    stretchY?: [number, number][];
+}
+export interface Image {
+    width?: number;
+    height?: number;
+}
+/**
+ * Validates metadata that is parsed from an SVG metadata
+ *
+ * @return {Error} if metadata is invalid
+ */
+export declare function validateMetadata(img?: any, metadata?: any): Error | null;
+//# sourceMappingURL=validate.d.ts.map

package/lib/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,MAAM,WAAW,QAAQ;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,KAAK;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,GAAG,gBAsEzD"}

package/lib/validate.js

@@ -0,0 +1,65 @@
+/** biome-ignore-all lint/suspicious/noExplicitAny: nature of this validate function */
+/**
+ * Validates metadata that is parsed from an SVG metadata
+ *
+ * @return {Error} if metadata is invalid
+ */
+export function validateMetadata(img, metadata) {
+    if (!img || typeof img !== 'object') {
+        return new Error('image is invalid');
+    }
+    if (!metadata || typeof metadata !== 'object') {
+        return new Error('image has invalid metadata');
+    }
+    if (typeof img.width !== 'number' || img.width <= 0) {
+        return new Error('image has invalid width');
+    }
+    if (typeof img.height !== 'number' || img.height <= 0) {
+        return new Error('image has invalid height');
+    }
+    if ('content' in metadata) {
+        const content = metadata.content;
+        if (!Array.isArray(content) || content.length !== 4 ||
+            typeof content[0] !== 'number' || typeof content[1] !== 'number' ||
+            typeof content[2] !== 'number' || typeof content[3] !== 'number') {
+            return new Error('image content area must be an array of 4 numbers');
+        }
+        if (content[0] >= content[2] || content[1] >= content[3]) {
+            return new Error('image content area must be positive');
+        }
+        if (content[0] < 0 || content[2] > img.width ||
+            content[1] < 0 || content[3] > img.height) {
+            return new Error('image content area must be within image bounds');
+        }
+    }
+    for (const key of ['stretchX', 'stretchY']) {
+        if (key in metadata) {
+            const stretches = metadata[key];
+            if (!Array.isArray(stretches)) {
+                return new Error(`image ${key} zones must be an array`);
+            }
+            for (const zone of stretches) {
+                if (!Array.isArray(zone) || zone.length !== 2 ||
+                    typeof zone[0] !== 'number' || typeof zone[1] !== 'number') {
+                    return new Error(`image ${key} zone must consist of two numbers`);
+                }
+                if (zone[0] >= zone[1]) {
+                    return new Error(`image ${key} zone may not be zero-size`);
+                }
+                if (zone[0] < 0 || zone[1] > img.width) {
+                    return new Error(`image ${key} zone must be within image bounds`);
+                }
+            }
+            for (let i = 1; i < stretches.length; i++) {
+                // Make sure that the previous stretch's end coordinate is
+                // smaller than this stretch's begin coordinate. Expects that
+                // stretch zones are sorted ascending by their first coordinate.
+                if (stretches[i][0] <= stretches[i - 1][1]) {
+                    return new Error(`image ${key} zones may not overlap`);
+                }
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=validate.js.map

package/lib/validate.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@mapka/sprites-generate",
+  "version": "0.4.1",
+  "description": "Generate sprites layout from individual svg icons",
+  "main": "./lib/index.js",
+  "license": "ISC",
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mapka-dev/sprites.git"
+  },
+  "dependencies": {
+    "@mapka/shelf-pack": "^0.4.1",
+    "@mapnik/mapnik": "^4.7.3",
+    "svg-boundings": "^2.0.8",
+    "svgo": "^2.8.0"
+  },
+  "files": [
+    "src/",
+    "lib/",
+    "LICENSE",
+    "!**/__tests__/",
+    "!lib/buildInfo.json"
+  ],
+  "gitHead": "5ff8c7554e4a4eb2349337c662bb853b588f7e45"
+}

package/src/__bench__/generate.bench.ts

@@ -0,0 +1,30 @@
+import { globSync, readFileSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+import { bench } from "vitest";
+import { generateLayout } from "../generate.js";
+
+const fixtures = globSync(resolve(join(import.meta.dirname, "../__tests__/fixture/svg/*.svg"))).map((im) => ({
+  svg: readFileSync(im),
+  id: basename(im).replace(".svg", ""),
+}));
+
+function getFixtures() {
+  return fixtures.sort(() => Math.random() - 0.5);
+}
+
+bench("generateLayout bench (concurrency=1,x20)", async () => {
+  for (let i = 0; i < 20; i++) {
+    await generateLayout({ imgs: getFixtures(), pixelRatio: 1, format: false });
+  }
+});
+
+bench("generateLayout bench (concurrency=4,x20)", async () => {
+  for (let i = 0; i < 20; i += 4) {
+    await Promise.all([
+      generateLayout({ imgs: getFixtures(), pixelRatio: 1, format: false }),
+      generateLayout({ imgs: getFixtures(), pixelRatio: 1, format: false }),  
+      generateLayout({ imgs: getFixtures(), pixelRatio: 1, format: false }),
+      generateLayout({ imgs: getFixtures(), pixelRatio: 1, format: false }),
+    ]);
+  }
+});

package/src/declarations.d.ts

@@ -0,0 +1,71 @@
+
+/**
+ * @see https://mapnik.org/documentation/node-mapnik/3.6/#blend
+ */
+interface BlendOptions {
+  /** 
+   * Output image format 
+   */
+  format?: "png" | "jpeg" | "webp";
+
+  /** 
+   * Image width in pixels 
+   */
+  width?: number;
+  
+  /** 
+   * Image height in pixels 
+   */
+  height?: number;
+  
+  /** 
+   * Compression level - references internal zlib compression algorithm
+   * (platform-dependent values)
+   */
+  compression?: number;
+  
+  /** Whether to re-encode the image */
+  reencode?: boolean;
+  
+  /** Enable palette-based encoding */
+  palette?: boolean;
+  
+  /** 
+   * Color quantization algorithm mode
+   * - hextree: Hexadecimal tree algorithm
+   * - octree: Octree algorithm
+   */
+  mode?: 'hextree' | 'octree';
+  
+  /** 
+   * Image quality setting:
+   * - JPEG & WebP: 0-100 (0 = lowest quality, 100 = highest quality)
+   * - PNG: 2-256 (2 = highest quality, 256 = lowest quality)
+   */
+  quality?: number;
+}
+
+declare module "@mapnik/mapnik" {
+    export class Image {
+      constructor(width: number, height: number);
+      width(): number;
+      height(): number;
+      encodeSync(format: string): Buffer;
+      static fromSVGBytes(
+        svg: Buffer, 
+        options: {
+          max_size?: number; 
+          scale?: number
+        }, callback: (err: Error | null, image: Image) => void
+      );
+    }
+
+    /**
+     * @see https://mapnik.org/documentation/node-mapnik/3.6/#blend
+     */ 
+    export function blend(
+      items: Buffer[] | {buffer: Image}[],
+      options: BlendOptions, 
+      callback: (err: Error | null, image: Buffer) => void
+    );
+}