@hellkite/pipkin 0.1.0

package/.editorconfig

@@ -0,0 +1,8 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+insert_final_newline = true

package/.eslintignore

@@ -0,0 +1 @@
+build/

package/.eslintrc.json

@@ -0,0 +1,15 @@
+{
+    "extends": "./node_modules/gts/",
+    "rules": {
+        "node/no-unpublished-import": "off",
+        "@typescript-eslint/no-unused-vars": [
+            "warn",
+            {
+                "argsIgnorePattern": "^_",
+                "varsIgnorePattern": "^_",
+                "caughtErrorsIgnorePattern": "^_"
+            }
+        ],
+        "object-curly-spacing": ["error", "always"]
+    }
+}

package/.nvmrc

@@ -0,0 +1 @@
+v18.16.0

package/.prettierrc.js

@@ -0,0 +1,4 @@
+module.exports = {
+    ...require('gts/.prettierrc.json'),
+    bracketSpacing: true,
+};

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hellkite
+
+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,3 @@
+# pipkin
+
+Card generation framework for TCGs or Boardgames

package/build/src/index.d.ts

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

package/build/src/index.js

@@ -0,0 +1,65 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const template_1 = require("./lib/template");
+const _2d_1 = require("./lib/types/2d");
+(() => __awaiter(void 0, void 0, void 0, function* () {
+    const result = yield template_1.Template.new({
+        defaultFontFamily: 'branela',
+        defaultAssetsPath: 'assets',
+    })
+        .textLayer('title', {
+        start: (0, _2d_1.toPoint)(25, 25),
+        size: (0, _2d_1.toSize)(700, 700),
+        textAlign: 'center',
+    }, {
+        font: {
+            size: 48,
+            family: 'blackflag',
+        },
+    })
+        .font('assets/BlackFlag.ttf', 'blackflag')
+        .textLayer('subtitle', {
+        start: (0, _2d_1.toPoint)(25, 125),
+        size: (0, _2d_1.toSize)(700, 700),
+        textAlign: 'center',
+    }, {
+        font: {
+            size: 38,
+        },
+        color: 'purple',
+    })
+        .font('assets/branela.otf', 'branela')
+        .imageLayer('title', {
+        start: (0, _2d_1.toPoint)(25, 225),
+        size: (0, _2d_1.toSize)(700, 700),
+        scale: 'stretch',
+    }, {
+        assetsPath: 'assets',
+        pathFn: (title) => `${title.toLowerCase()}.png`,
+    })
+        .textLayer('effect', {
+        start: (0, _2d_1.toPoint)(125, 950),
+        size: (0, _2d_1.toSize)(500, 150),
+        textAlign: 'center',
+    }, {
+        font: {
+            size: 32,
+        },
+    })
+        .fromCsv('assets/data.csv', {
+        duplication: {
+            countField: 'copies',
+        },
+    });
+    yield Promise.all(result.map((r, index) => r.write(`assets/test-${index + 1}.png`)));
+}))();
+//# sourceMappingURL=index.js.map

package/build/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,6CAA0C;AAC1C,wCAAiD;AASjD,CAAC,GAAS,EAAE;IACR,MAAM,MAAM,GAAG,MAAM,mBAAQ,CAAC,GAAG,CAAe;QAC5C,iBAAiB,EAAE,SAAS;QAC5B,iBAAiB,EAAE,QAAQ;KAC9B,CAAC;SACG,SAAS,CACN,OAAO,EACP;QACI,KAAK,EAAE,IAAA,aAAO,EAAC,EAAE,EAAE,EAAE,CAAC;QACtB,IAAI,EAAE,IAAA,YAAM,EAAC,GAAG,EAAE,GAAG,CAAC;QACtB,SAAS,EAAE,QAAQ;KACtB,EACD;QACI,IAAI,EAAE;YACF,IAAI,EAAE,EAAE;YACR,MAAM,EAAE,WAAW;SACtB;KACJ,CACJ;SACA,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC;SACzC,SAAS,CACN,UAAU,EACV;QACI,KAAK,EAAE,IAAA,aAAO,EAAC,EAAE,EAAE,GAAG,CAAC;QACvB,IAAI,EAAE,IAAA,YAAM,EAAC,GAAG,EAAE,GAAG,CAAC;QACtB,SAAS,EAAE,QAAQ;KACtB,EACD;QACI,IAAI,EAAE;YACF,IAAI,EAAE,EAAE;SACX;QACD,KAAK,EAAE,QAAQ;KAClB,CACJ;SACA,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC;SACrC,UAAU,CACP,OAAO,EACP;QACI,KAAK,EAAE,IAAA,aAAO,EAAC,EAAE,EAAE,GAAG,CAAC;QACvB,IAAI,EAAE,IAAA,YAAM,EAAC,GAAG,EAAE,GAAG,CAAC;QACtB,KAAK,EAAE,SAAS;KACnB,EACD;QACI,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,MAAM;KAClE,CACJ;SACA,SAAS,CACN,QAAQ,EACR;QACI,KAAK,EAAE,IAAA,aAAO,EAAC,GAAG,EAAE,GAAG,CAAC;QACxB,IAAI,EAAE,IAAA,YAAM,EAAC,GAAG,EAAE,GAAG,CAAC;QACtB,SAAS,EAAE,QAAQ;KACtB,EACD;QACI,IAAI,EAAE;YACF,IAAI,EAAE,EAAE;SACX;KACJ,CACJ;SACA,OAAO,CAAC,iBAAiB,EAAE;QACxB,WAAW,EAAE;YACT,UAAU,EAAE,QAAQ;SACvB;KACJ,CAAC,CAAC;IAEP,MAAM,OAAO,CAAC,GAAG,CACb,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CACpE,CAAC;AACN,CAAC,CAAA,CAAC,EAAE,CAAC"}

package/build/src/lib/template.d.ts

@@ -0,0 +1,44 @@
+import * as fs from 'fs';
+import { ImageType, ImagePosition, ImageLayerOptions } from './types/image';
+import { TextPosition, TextLayerOptions } from './types/text';
+import { RenderOptions } from './types/render';
+type RequiredTemplateOptions = {
+    height: number;
+    width: number;
+    color: number;
+};
+type OptionalTemplateOptions = {
+    defaultFontFamily?: string;
+    defaultAssetsPath?: string;
+};
+export type TemplateOptions = RequiredTemplateOptions & OptionalTemplateOptions;
+export type LayerFnContext = {
+    width: number;
+    height: number;
+    debugMode: boolean;
+};
+export type LayerFn<EntryType> = (entry: EntryType, context: LayerFnContext) => Promise<ImageType>;
+export type TemplateLayerFn<EntryType extends Record<string, string>> = (template: Template<EntryType>) => Template<EntryType>;
+export declare class Template<EntryType extends Record<string, string>> {
+    private readonly layers;
+    private readonly background;
+    private debugMode;
+    private defaultFontFamily?;
+    private defaultAssetsPath?;
+    private constructor();
+    static new<EntryType extends Record<string, string>>(options?: Partial<TemplateOptions>): Template<EntryType>;
+    private shadowTemplate;
+    private shadowBackground;
+    layer(fn: LayerFn<EntryType>): this;
+    templateLayer: (fn: TemplateLayerFn<EntryType>) => this;
+    imageLayer: (key: keyof EntryType, position: ImagePosition, options?: ImageLayerOptions) => this;
+    staticImageLayer: (path: string, position: ImagePosition, options?: ImageLayerOptions) => this;
+    textLayer: (key: keyof EntryType, position: TextPosition, options?: TextLayerOptions) => this;
+    font(path: fs.PathLike, name: string): this;
+    debug(): this;
+    renderLayers(entry: EntryType): Promise<Array<ImageType>>;
+    render(entry: EntryType, options?: RenderOptions<EntryType>): Promise<ImageType>;
+    renderAll(entries: Array<EntryType>, options?: RenderOptions<EntryType>): Promise<Array<ImageType>>;
+    fromCsv(path: string, options?: RenderOptions<EntryType>): Promise<Array<ImageType>>;
+}
+export {};

package/build/src/lib/template.js

@@ -0,0 +1,226 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Template = void 0;
+const fs = __importStar(require("fs"));
+const papaparse_1 = require("papaparse");
+const jimp_1 = require("jimp");
+const lodash_camelcase_1 = __importDefault(require("lodash.camelcase"));
+const placeImage_1 = require("./utils/placeImage");
+const drawBoundingBox_1 = require("./utils/drawBoundingBox");
+const text_1 = require("./types/text");
+const lodash_concat_1 = __importDefault(require("lodash.concat"));
+const fabric = __importStar(require("fabric/node"));
+const canvasToImage_1 = require("./utils/canvasToImage");
+const canvas_1 = require("canvas");
+const DEFAULT_TEMPLATE_OPTIONS = {
+    height: 1050,
+    width: 750,
+    color: (0, jimp_1.rgbaToInt)(255, 255, 255, 255),
+};
+class Template {
+    // disallow constructor initialization
+    constructor(options) {
+        this.layers = [];
+        this.debugMode = false;
+        this.templateLayer = (fn) => this.layer(entry => {
+            const template = fn(this.shadowTemplate());
+            return template.render(entry);
+        });
+        this.imageLayer = (key, position, options) => this.layer((entry_1, _a) => __awaiter(this, [entry_1, _a], void 0, function* (entry, { debugMode, width, height }) {
+            const imagePath = (options === null || options === void 0 ? void 0 : options.pathFn)
+                ? options.pathFn(entry[key])
+                : entry[key];
+            const result = yield (0, placeImage_1.placeImage)(this.shadowBackground(), imagePath, position, options, this.defaultAssetsPath);
+            // debug mode
+            if (debugMode) {
+                const debugImage = yield (0, drawBoundingBox_1.drawBoundingBox)(position, {
+                    width,
+                    height,
+                });
+                return debugImage.composite(result);
+            }
+            return result;
+        }));
+        this.staticImageLayer = (path, position, options) => this.layer((_1, _a) => __awaiter(this, [_1, _a], void 0, function* (_, { debugMode, width, height }) {
+            const result = yield (0, placeImage_1.placeImage)(this.shadowBackground(), path, position, options, this.defaultAssetsPath);
+            // debug mode
+            if (debugMode) {
+                const debugImage = yield (0, drawBoundingBox_1.drawBoundingBox)(position, {
+                    width,
+                    height,
+                });
+                return debugImage.composite(result);
+            }
+            return result;
+        }));
+        this.textLayer = (key, position, options) => this.layer((entry_1, _a) => __awaiter(this, [entry_1, _a], void 0, function* (entry, { debugMode, width, height }) {
+            var _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const text = entry[key];
+            // render text
+            const canvas = new fabric.Canvas(null, { width, height });
+            const textObject = new fabric.Textbox(text, {
+                left: position.start.x,
+                top: position.start.y,
+                width: position.size.width,
+                height: position.size.height,
+                fontSize: (_c = (_b = options === null || options === void 0 ? void 0 : options.font) === null || _b === void 0 ? void 0 : _b.size) !== null && _c !== void 0 ? _c : 16,
+                fontFamily: (_f = (_e = (_d = options === null || options === void 0 ? void 0 : options.font) === null || _d === void 0 ? void 0 : _d.family) !== null && _e !== void 0 ? _e : this.defaultFontFamily) !== null && _f !== void 0 ? _f : 'Arial',
+                fontWeight: ((_g = options === null || options === void 0 ? void 0 : options.font) === null || _g === void 0 ? void 0 : _g.bold) ? 'bold' : 'normal',
+                fontStyle: ((_h = options === null || options === void 0 ? void 0 : options.font) === null || _h === void 0 ? void 0 : _h.italic) ? 'italic' : 'normal',
+                fill: (_j = options === null || options === void 0 ? void 0 : options.color) !== null && _j !== void 0 ? _j : 'black',
+                textAlign: (_k = position.textAlign) !== null && _k !== void 0 ? _k : text_1.DEFAULT_TEXT_ALIGNMENT_PROPS.textAlign,
+                splitByGrapheme: true, // word wrapping
+            });
+            canvas.add(textObject);
+            // debug mode
+            if (debugMode) {
+                const boundingBox = textObject.getBoundingRect();
+                const debugRect = new fabric.Rect({
+                    left: boundingBox.left,
+                    top: boundingBox.top,
+                    width: boundingBox.width,
+                    height: boundingBox.height,
+                    stroke: 'red',
+                    strokeWidth: 2,
+                    fill: 'transparent',
+                });
+                canvas.add(debugRect);
+            }
+            return (0, canvasToImage_1.canvasToImage)(canvas);
+        }));
+        this.background = new jimp_1.Jimp({
+            height: options.height,
+            width: options.width,
+            color: options.color,
+        });
+        this.defaultFontFamily = options.defaultFontFamily;
+        this.defaultAssetsPath = options.defaultAssetsPath;
+    }
+    static new(options) {
+        return new Template(Object.assign(Object.assign({}, DEFAULT_TEMPLATE_OPTIONS), options));
+    }
+    shadowTemplate() {
+        return Template.new({
+            height: this.background.height,
+            width: this.background.width,
+        });
+    }
+    shadowBackground() {
+        return new jimp_1.Jimp({
+            width: this.background.width,
+            height: this.background.height,
+        });
+    }
+    layer(fn) {
+        this.layers.push(fn);
+        return this;
+    }
+    font(path, name) {
+        (0, canvas_1.registerFont)(path.toString(), {
+            family: name,
+        });
+        return this;
+    }
+    debug() {
+        this.debugMode = true;
+        return this;
+    }
+    renderLayers(entry) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return Promise.all(this.layers.map(layerFn => layerFn(entry, {
+                debugMode: this.debugMode,
+                width: this.background.width,
+                height: this.background.height,
+            })));
+        });
+    }
+    render(entry, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const renderedLayers = yield this.renderLayers(entry);
+            return renderedLayers.reduce((acc, layerRender) => acc.composite(layerRender), this.background.clone());
+        });
+    }
+    renderAll(entries, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = yield Promise.all(entries.map(entry => new Promise(resolve => this.render(entry, options).then(image => {
+                var _a;
+                if (!(options === null || options === void 0 ? void 0 : options.duplication)) {
+                    return resolve([image]);
+                }
+                const copies = parseInt(entry[options.duplication.countField]);
+                if (Number.isNaN(copies)) {
+                    return resolve([image]);
+                }
+                const deepCopy = (_a = options.duplication.deepCopy) !== null && _a !== void 0 ? _a : false;
+                return resolve(Array.from({ length: copies }, () => deepCopy ? image.clone() : image));
+            }))));
+            return (0, lodash_concat_1.default)(...results);
+        });
+    }
+    fromCsv(path, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                try {
+                    const fileContent = fs.readFileSync(path, 'utf8');
+                    const parsedData = (0, papaparse_1.parse)(fileContent, {
+                        header: true,
+                        skipEmptyLines: true,
+                        transformHeader: (header, index) => (0, lodash_camelcase_1.default)(header !== null && header !== void 0 ? header : `header${index}`),
+                    });
+                    resolve(this.renderAll(parsedData.data, options));
+                }
+                catch (err) {
+                    reject(err);
+                }
+            });
+        });
+    }
+}
+exports.Template = Template;
+// TODO: Ledger of actions applied to the image like a logging feed
+//# sourceMappingURL=template.js.map

package/build/src/lib/template.js.map

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

package/build/src/lib/types/2d.d.ts

@@ -0,0 +1,10 @@
+export type Point = {
+    x: number;
+    y: number;
+};
+export type Size = {
+    width: number;
+    height: number;
+};
+export declare const toPoint: (x: number, y: number) => Point;
+export declare const toSize: (w: number, h: number) => Size;

package/build/src/lib/types/2d.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toSize = exports.toPoint = void 0;
+const toPoint = (x, y) => ({ x, y });
+exports.toPoint = toPoint;
+const toSize = (w, h) => ({ width: w, height: h });
+exports.toSize = toSize;
+//# sourceMappingURL=2d.js.map

package/build/src/lib/types/2d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"2d.js","sourceRoot":"","sources":["../../../../src/lib/types/2d.ts"],"names":[],"mappings":";;;AAUO,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,CAAS,EAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAAtD,QAAA,OAAO,WAA+C;AAE5D,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,CAAS,EAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AAAnE,QAAA,MAAM,UAA6D"}

package/build/src/lib/types/image.d.ts

@@ -0,0 +1,44 @@
+import { JimpInstance } from 'jimp';
+import { Point, Size } from './2d';
+export type ImageType = JimpInstance;
+export type ImageLayerOptions = {
+    assetsPath?: string;
+    pathFn?: (path: string) => string;
+};
+export type ImagePosition = ImageAlignmentProps & ScaleProps & BoundingBox;
+export type BoundingBox = {
+    start: Point;
+    size: Size;
+};
+export type ImageAlignmentProps = {
+    /**
+     * Overridden by xAlignment and/or yAlignment if provided.
+     * default `center`
+     */
+    alignment?: ImageAlignment;
+    /**
+     * default `center`
+     */
+    xAlignment?: ImageAlignment;
+    /**
+     * default `center`
+     */
+    yAlignment?: ImageAlignment;
+};
+export type ImageAlignment = 'start' | 'center' | 'end';
+export declare const DEFAULT_IMAGE_ALIGNMENT: ImageAlignment;
+/**
+ * Could be extended with 'x-stretch' and 'y-stretch'
+ */
+export type ScaleMode = 'none' | 'keep-ratio' | 'stretch';
+export declare const DEFAULT_SCALE_MODE: ScaleMode;
+export type ScaleProps = {
+    /**
+     * Behavior of the content around a space
+     * that is bigger or smaller than necessary
+     * - `none`: no scaling
+     * - `keep-ration`: scale while preserving aspect ration
+     * - `stretch`: scale without preserving aspect ration
+     */
+    scale?: ScaleMode;
+};

package/build/src/lib/types/image.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SCALE_MODE = exports.DEFAULT_IMAGE_ALIGNMENT = void 0;
+exports.DEFAULT_IMAGE_ALIGNMENT = 'center';
+exports.DEFAULT_SCALE_MODE = 'none';
+//# sourceMappingURL=image.js.map

package/build/src/lib/types/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../../../src/lib/types/image.ts"],"names":[],"mappings":";;;AAqCa,QAAA,uBAAuB,GAAmB,QAAQ,CAAC;AAOnD,QAAA,kBAAkB,GAAc,MAAM,CAAC"}

package/build/src/lib/types/render.d.ts

@@ -0,0 +1,14 @@
+export type RenderOptions<EntryType extends Record<string, string>> = {
+    duplication?: DuplicationOptions<EntryType>;
+};
+export type DuplicationOptions<EntryType extends Record<string, string>> = {
+    /**
+     * Field used for determining how many copies of this entry should be.
+     */
+    countField: keyof EntryType;
+    /**
+     * Return the copies are complete clones, instead of same reference.
+     * default false
+     */
+    deepCopy?: boolean;
+};

package/build/src/lib/types/render.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=render.js.map

package/build/src/lib/types/render.js.map

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

package/build/src/lib/types/scale.d.ts

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

package/build/src/lib/types/scale.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=scale.js.map

package/build/src/lib/types/scale.js.map

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

package/build/src/lib/types/text.d.ts

@@ -0,0 +1,31 @@
+import { BoundingBox } from './image';
+export type TextLayerOptions = {
+    font?: {
+        /**
+         * Size of font is represented in pixels
+         */
+        size?: number;
+        /**
+         * Either use one supported by canvas
+         * or load a custom one before rendering
+         */
+        family?: string;
+        /**
+         * Warning: Not supported by all fonts
+         */
+        bold?: boolean;
+        /**
+         * Warning: Not supported by all fonts
+         */
+        italic?: boolean;
+    };
+    color?: string;
+};
+export type TextPosition = TextAlignmentProps & BoundingBox;
+export type TextAlignmentProps = {
+    /**
+     * default `center`
+     */
+    textAlign?: 'left' | 'center' | 'right' | 'justify' | 'justify-left' | 'justify-center' | 'justify-right';
+};
+export declare const DEFAULT_TEXT_ALIGNMENT_PROPS: Required<TextAlignmentProps>;

package/build/src/lib/types/text.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TEXT_ALIGNMENT_PROPS = void 0;
+exports.DEFAULT_TEXT_ALIGNMENT_PROPS = {
+    textAlign: 'center',
+};
+//# sourceMappingURL=text.js.map

package/build/src/lib/types/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../../src/lib/types/text.ts"],"names":[],"mappings":";;;AA0Ca,QAAA,4BAA4B,GAAiC;IACtE,SAAS,EAAE,QAAQ;CACtB,CAAC"}

package/build/src/lib/utils/buildFontString.d.ts

@@ -0,0 +1,2 @@
+import { TextLayerOptions } from "../types/text";
+export declare const buildFontString: (font: TextLayerOptions["font"], defaultFontFamily?: string) => string;

package/build/src/lib/utils/buildFontString.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFontString = void 0;
+const buildFontString = (font, defaultFontFamily) => {
+    var _a, _b, _c;
+    const fragments = [];
+    if (font === null || font === void 0 ? void 0 : font.bold) {
+        fragments.push('bold');
+    }
+    if (font === null || font === void 0 ? void 0 : font.italic) {
+        fragments.push('italic');
+    }
+    fragments.push(`${(_a = font === null || font === void 0 ? void 0 : font.size) !== null && _a !== void 0 ? _a : 16}px`);
+    fragments.push((_c = (_b = font === null || font === void 0 ? void 0 : font.family) !== null && _b !== void 0 ? _b : defaultFontFamily) !== null && _c !== void 0 ? _c : 'Arial');
+    return fragments.join(' ');
+};
+exports.buildFontString = buildFontString;
+//# sourceMappingURL=buildFontString.js.map

package/build/src/lib/utils/buildFontString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildFontString.js","sourceRoot":"","sources":["../../../../src/lib/utils/buildFontString.ts"],"names":[],"mappings":";;;AAEO,MAAM,eAAe,GAAG,CAC3B,IAA8B,EAC9B,iBAA0B,EACpB,EAAE;;IACR,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,EAAE,CAAC;QACb,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,MAAM,EAAE,CAAC;QACf,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,GAAG,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,mCAAI,EAAE,IAAI,CAAC,CAAC;IACxC,SAAS,CAAC,IAAI,CAAC,MAAA,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,MAAM,mCAAI,iBAAiB,mCAAI,OAAO,CAAC,CAAC;IAC7D,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC,CAAC;AAdW,QAAA,eAAe,mBAc1B"}

package/build/src/lib/utils/canvasToImage.d.ts

@@ -0,0 +1,3 @@
+import { ImageType } from '../types/image';
+import * as fabric from 'fabric/node';
+export declare const canvasToImage: (canvas: fabric.Canvas) => Promise<ImageType>;

package/build/src/lib/utils/canvasToImage.js

@@ -0,0 +1,28 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canvasToImage = void 0;
+const jimp_1 = require("jimp");
+const canvasToImage = (canvas) => __awaiter(void 0, void 0, void 0, function* () {
+    const dataUrl = canvas.toDataURL({
+        format: 'png',
+        quality: 1,
+        multiplier: 1,
+    });
+    const image = yield jimp_1.Jimp.read(Buffer.from(dataUrl.split(',')[1], 'base64'));
+    return jimp_1.Jimp.fromBitmap({
+        data: image.bitmap.data,
+        width: image.bitmap.width,
+        height: image.bitmap.height
+    });
+});
+exports.canvasToImage = canvasToImage;
+//# sourceMappingURL=canvasToImage.js.map