@dicebear/converter 5.0.0-alpha.20

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Florian Körner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,10 @@
+<h1 align="center"><img src="https://dicebear.com/api/male/seed.svg?mood=happy" width="124" /> <br />DiceBear</h1>
+<p align="center">
+  <strong>SVG Converter for DiceBear</strong>
+</p>
+
+<p align="center">
+  <a href="https://dicebear.com/">
+    Read Documentation
+  </a>
+</p>

package/fonts/inter/License.txt

@@ -0,0 +1,94 @@
+Copyright (c) 2016-2020 The Inter Project Authors.
+"Inter" is trademark of Rasmus Andersson.
+https://github.com/rsms/inter
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION AND CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/lib/core.d.ts

@@ -0,0 +1,2 @@
+import type { ToFormat } from './types';
+export declare const toFormat: ToFormat;

package/lib/core.js

@@ -0,0 +1,65 @@
+import { getMimeType } from './utils/mime-type.js';
+import { ensureSize } from './utils/svg.js';
+export const toFormat = function (svg, format, exif) {
+    const blob = toBlob(svg, format, exif);
+    return {
+        toDataUri: async () => toDataUri(await blob),
+        toFile: async (name) => toFile(await blob, name),
+        toArrayBuffer: async () => (await blob).arrayBuffer(),
+    };
+};
+async function toDataUri(blob) {
+    if (blob.type === getMimeType('svg')) {
+        return `data:image/svg+xml;utf8,${encodeURIComponent(await blob.text())}`;
+    }
+    else {
+        return new Promise((resolve, reject) => {
+            const reader = new FileReader();
+            reader.readAsDataURL(blob);
+            reader.onload = () => resolve(reader.result);
+            reader.onerror = (e) => reject(e);
+        });
+    }
+}
+async function toFile(blob, name) {
+    const link = document.createElement('a');
+    link.href = await toDataUri(blob);
+    link.download = name;
+    link.click();
+    link.remove();
+}
+async function toBlob(rawSvg, format, exif) {
+    if (exif) {
+        console.warn('The `exif` option is not supported in the browser version of `@dicebear/converter`.');
+        console.warn('Please use the node version of `@dicebear/converter` to generate images with exif data.');
+    }
+    if (format === 'svg') {
+        return new Blob([rawSvg], { type: getMimeType('svg') });
+    }
+    let { svg, size } = ensureSize(rawSvg);
+    const svgBlob = new Blob([svg], { type: getMimeType('svg') });
+    const canvas = document.createElement('canvas');
+    canvas.width = size;
+    canvas.height = size;
+    const context = canvas.getContext('2d');
+    if (null === context) {
+        throw new Error('Could not get canvas context');
+    }
+    if (format === 'jpeg') {
+        context.fillStyle = 'white';
+        context.fillRect(0, 0, size, size);
+    }
+    var img = document.createElement('img');
+    img.width = size;
+    img.height = size;
+    img.setAttribute('src', await toDataUri(svgBlob));
+    return new Promise((resolve, reject) => {
+        img.onload = () => {
+            context.drawImage(img, 0, 0, size, size);
+            canvas.toBlob((blob) => {
+                blob ? resolve(blob) : reject(new Error('Could not create blob'));
+            }, `image/${format}`);
+        };
+        img.onerror = (e) => reject(e);
+    });
+}

package/lib/index.d.ts

@@ -0,0 +1,8 @@
+/*!
+ * DiceBear Converter (@dicebear/converter)
+ *
+ * Code licensed under MIT (https://github.com/dicebear/dicebear/blob/main/LICENSE)
+ * Copyright (c) 2022 Florian Körner
+ */
+export * from './core.js';
+export * from './types.js';

package/lib/index.js

@@ -0,0 +1,8 @@
+/*!
+ * DiceBear Converter (@dicebear/converter)
+ *
+ * Code licensed under MIT (https://github.com/dicebear/dicebear/blob/main/LICENSE)
+ * Copyright (c) 2022 Florian Körner
+ */
+export * from './core.js';
+export * from './types.js';

package/lib/node/core.d.ts

@@ -0,0 +1,2 @@
+import type { ToFormat } from '../types';
+export declare const toFormat: ToFormat;

package/lib/node/core.js

@@ -0,0 +1,64 @@
+import { promises as fs } from 'node:fs';
+import { Blob } from 'node:buffer';
+import { getMimeType } from '../utils/mime-type.js';
+import { ensureSize } from '../utils/svg.js';
+import * as tmp from 'tmp-promise';
+import { ensurePackage } from '../utils/package-helper.js';
+export const toFormat = function (svg, format, exif) {
+    const blob = toBlob(svg, format, exif);
+    return {
+        toDataUri: async () => toDataUri(await blob),
+        toFile: async (name) => toFile(await blob, name),
+        toArrayBuffer: async () => (await blob).arrayBuffer(),
+    };
+};
+async function toDataUri(blob) {
+    if (blob.type === getMimeType('svg')) {
+        return `data:${blob.type};utf8,${encodeURIComponent(await blob.text())}`;
+    }
+    else {
+        const buffer = Buffer.from(await blob.arrayBuffer());
+        return `data:image/${blob.type};base64,${buffer.toString('base64')}`;
+    }
+}
+async function toFile(blob, name) {
+    return fs.writeFile(name, Buffer.from(await blob.arrayBuffer()));
+}
+async function toBlob(rawSvg, format, exif) {
+    if (format === 'svg') {
+        if (exif) {
+            console.warn('Exif is ignored when converting to svg.');
+        }
+        return new Blob([rawSvg], { type: getMimeType('svg') });
+    }
+    await ensurePackage('@resvg/resvg-js', '1.4.0');
+    const { renderAsync } = await import('@resvg/resvg-js');
+    const interRegular = new URL('../../fonts/inter/inter-regular.otf', import.meta.url);
+    const interBold = new URL('../../fonts/inter/inter-bold.otf', import.meta.url);
+    let { svg } = ensureSize(rawSvg);
+    let buffer = await renderAsync(svg, {
+        font: {
+            loadSystemFonts: false,
+            defaultFontFamily: 'Inter',
+            fontFiles: [interRegular.pathname, interBold.pathname],
+        },
+    });
+    if (format === 'jpeg') {
+        await ensurePackage('sharp', '0.30.0');
+        const sharp = (await import('sharp')).default;
+        buffer = await sharp(buffer)
+            .flatten({ background: '#ffffff' })
+            .toFormat(format)
+            .toBuffer();
+    }
+    if (exif) {
+        await ensurePackage('exiftool-vendored', '16.3.0');
+        const exiftool = (await import('exiftool-vendored')).exiftool;
+        await tmp.withFile(async ({ path }) => {
+            await fs.writeFile(path, buffer);
+            await exiftool.write(path, exif);
+            buffer = await fs.readFile(path);
+        });
+    }
+    return new Blob([buffer], { type: getMimeType(format) });
+}

package/lib/node/index.d.ts

@@ -0,0 +1,8 @@
+/*!
+ * DiceBear Convert (@dicebear/converter)
+ *
+ * Code licensed under MIT (https://github.com/dicebear/dicebear/blob/main/LICENSE)
+ * Copyright (c) 2022 Florian Körner
+ */
+export * from './core.js';
+export * from '../types.js';

package/lib/node/index.js

@@ -0,0 +1,8 @@
+/*!
+ * DiceBear Convert (@dicebear/converter)
+ *
+ * Code licensed under MIT (https://github.com/dicebear/dicebear/blob/main/LICENSE)
+ * Copyright (c) 2022 Florian Körner
+ */
+export * from './core.js';
+export * from '../types.js';

package/lib/types.d.ts

@@ -0,0 +1,10 @@
+export declare type ToFormat = (svg: string, format: Format, exif?: Exif) => BinaryResult;
+export interface BinaryResult {
+    toDataUri(): Promise<string>;
+    toFile(name: string): Promise<void>;
+    toArrayBuffer(): Promise<ArrayBuffer>;
+}
+export interface Exif {
+    [key: string]: string;
+}
+export declare type Format = 'svg' | 'png' | 'jpeg';

package/lib/types.js

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

package/lib/utils/mime-type.d.ts

@@ -0,0 +1,2 @@
+import { Format } from '../types';
+export declare function getMimeType(format: Format): string;

package/lib/utils/mime-type.js

@@ -0,0 +1,9 @@
+export function getMimeType(format) {
+    switch (format) {
+        case 'png':
+        case 'jpeg':
+            return `image/${format}`;
+        default:
+            return 'image/svg+xml';
+    }
+}

package/lib/utils/package-helper.d.ts

@@ -0,0 +1 @@
+export declare function ensurePackage(name: string, version: string): Promise<void>;

package/lib/utils/package-helper.js

@@ -0,0 +1,18 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+export async function ensurePackage(name, version) {
+    let packageJson;
+    try {
+        packageJson = require(`${name}/package.json`);
+    }
+    catch (e) {
+        // prettier-ignore
+        throw new Error(`Please install \`${name}@^${version}\` to use this feature.'`);
+    }
+    const packageVersion = packageJson.version.split('.').map((v) => parseInt(v));
+    const requiredVersion = version.split('.').map((v) => parseInt(v));
+    if (packageVersion[0] !== requiredVersion[0] ||
+        packageVersion[1] < requiredVersion[1]) {
+        throw new Error(`Please install \`${name}@^${version}\` to use this feature. (Currently installed version: \`${packageJson.version})\`})'`);
+    }
+}

package/lib/utils/svg.d.ts

@@ -0,0 +1,4 @@
+export declare function ensureSize(svg: string, defaultSize?: number): {
+    svg: string;
+    size: number;
+};

package/lib/utils/svg.js

@@ -0,0 +1,13 @@
+export function ensureSize(svg, defaultSize = 512) {
+    let size = defaultSize;
+    svg = svg.replace(/<svg([^>]*?(?:width="(\d+)"[^>]*)?)>/, (match, g1, g2) => {
+        if (g2) {
+            size = parseInt(g2);
+        }
+        else {
+            g1 += ` width="${size}" height="${size}"`;
+        }
+        return `<svg${g1}>`;
+    });
+    return { svg, size };
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@dicebear/converter",
+  "version": "5.0.0-alpha.20",
+  "description": "SVG Converter for DiceBear",
+  "keywords": [
+    "dicebear"
+  ],
+  "homepage": "https://dicebear.com",
+  "bugs": {
+    "url": "https://github.com/dicebear/dicebear/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dicebear/dicebear.git"
+  },
+  "license": "MIT",
+  "author": "Florian Körner <contact@florian-koerner.com>",
+  "type": "module",
+  "exports": {
+    "node": "./lib/node/index.js",
+    "default": "./lib/index.js"
+  },
+  "types": "./lib/index.d.ts",
+  "files": [
+    "fonts",
+    "LICENSE",
+    "lib",
+    "README.md"
+  ],
+  "scripts": {
+    "prebuild": "del-cli lib",
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "uvu tests"
+  },
+  "dependencies": {
+    "@types/json-schema": "^7.0.7",
+    "tmp-promise": "^3.0.3"
+  },
+  "devDependencies": {
+    "@resvg/resvg-js": "^1.4.0",
+    "@tsconfig/recommended": "^1.0.1",
+    "@types/sharp": "^0.30.2",
+    "del-cli": "^4.0.1",
+    "exiftool-vendored": "^16.3.0",
+    "sharp": "^0.30.4",
+    "typescript": "^4.6.3",
+    "uvu": "^0.5.3"
+  },
+  "engines": {
+    "node": "^14.13.1 || >=16.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "6b1c2bd64294365be21d0a133a362ede5ed62b5a"
+}