pixeli 0.1.9 → 1.0.3

package/dist/cli/commands/template/presets.d.ts

@@ -0,0 +1,73 @@
+export declare const PRESETS: {
+    'instagram-grid': {
+        canvas: {
+            width: number;
+            height: number;
+            columns: number;
+            rows: number;
+        };
+        slots: {
+            col: number;
+            row: number;
+            colSpan: number;
+            rowSpan: number;
+        }[];
+    };
+    'dashboard-shot': {
+        canvas: {
+            width: number;
+            height: number;
+            columns: number;
+            rows: number;
+        };
+        slots: {
+            col: number;
+            row: number;
+            colSpan: number;
+            rowSpan: number;
+        }[];
+    };
+    'horizontal-book-spread': {
+        canvas: {
+            width: number;
+            height: number;
+            columns: number;
+            rows: number;
+        };
+        slots: {
+            col: number;
+            row: number;
+            colSpan: number;
+            rowSpan: number;
+        }[];
+    };
+    'vertical-book-spread': {
+        canvas: {
+            width: number;
+            height: number;
+            columns: number;
+            rows: number;
+        };
+        slots: {
+            col: number;
+            row: number;
+            colSpan: number;
+            rowSpan: number;
+        }[];
+    };
+    'art-gallery': {
+        canvas: {
+            width: number;
+            height: number;
+            columns: number;
+            rows: number;
+        };
+        slots: {
+            col: number;
+            row: number;
+            colSpan: number;
+            rowSpan: number;
+        }[];
+    };
+};
+export declare const isValidPreset: (presetId: string) => boolean;

package/{lib/merges/collage-merge → dist/cli/commands/template}/presets.js

@@ -3,15 +3,13 @@ import dashboardShot from './presets/dashboardShot.js';
 import horizontalBookSpread from './presets/horizontalBookSpread.js';
 import verticalBookSpread from './presets/verticalBookSpread.js';
 import artGallery from './presets/artGallery.js';
-
 export const PRESETS = {
-  'instagram-grid': instagramGrid,
-  'dashboard-shot': dashboardShot,
-  'horizontal-book-spread': horizontalBookSpread,
-  'vertical-book-spread': verticalBookSpread,
-  'art-gallery': artGallery,
+    'instagram-grid': instagramGrid,
+    'dashboard-shot': dashboardShot,
+    'horizontal-book-spread': horizontalBookSpread,
+    'vertical-book-spread': verticalBookSpread,
+    'art-gallery': artGallery,
 };
-
 export const isValidPreset = (presetId) => {
-  return presetId in PRESETS;
+    return presetId in PRESETS;
 };

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { configureCommandErrors } from './utils/configureCommandErrors.js';
+import gridCommand from './commands/grid/index.js';
+import masonryCommand from './commands/masonry/index.js';
+import templateCommand from './commands/template/index.js';
+import collageCommand from './commands/collage/index.js';
+import pkg from '../../package.json' with { type: 'json' };
+const program = new Command();
+program
+    .name('pixeli')
+    .description('A lightweight command-line tool for merging multiple images into customizable grid layouts.')
+    .version(pkg.version);
+program.addCommand(gridCommand);
+program.addCommand(masonryCommand);
+program.addCommand(templateCommand);
+program.addCommand(collageCommand);
+configureCommandErrors(program);
+try {
+    program.parse();
+}
+catch (e) {
+    console.log(e);
+}

package/dist/cli/modules/loadImages.d.ts

@@ -0,0 +1,15 @@
+export interface LoadImagesOptions {
+    input: {
+        files: string[] | undefined;
+        dir: string | undefined;
+    };
+    recursive: boolean;
+    count?: number;
+}
+export declare const loadImages: ({ input, recursive, count }: LoadImagesOptions) => Promise<{
+    images: Buffer<ArrayBufferLike>[];
+    imagePaths: string[];
+    ignoredPaths: string[];
+}>;
+export declare const loadFromFiles: (files: string[], count: number | undefined) => Promise<NonSharedBuffer[]>;
+export declare const getFilepathsFromDirectory: (dir: string, recursive: boolean, depth?: number) => Promise<string[]>;

package/dist/cli/modules/loadImages.js

@@ -0,0 +1,74 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { isSupportedInputImage } from '../../core/helpers.js';
+const MAX_RECURSION_DEPTH = 10;
+const hasDir = (input) => {
+    return typeof input.dir === 'string';
+};
+export const loadImages = async ({ input, recursive, count }) => {
+    let filepaths = [];
+    let images = [];
+    // Get all file paths
+    if (input.files && input.files.length) {
+        filepaths = input.files;
+    }
+    else if (hasDir(input)) {
+        filepaths = await getFilepathsFromDirectory(input.dir, recursive);
+    }
+    // Load valid image paths
+    const { ignoredPaths, imagePaths } = validateFilepaths(filepaths);
+    images = await loadFromFiles(imagePaths, count);
+    // Ensure filepaths and images match
+    if (images.length !== filepaths.length) {
+        filepaths = filepaths.slice(0, images.length);
+    }
+    return { images, imagePaths, ignoredPaths };
+};
+export const loadFromFiles = async (files, count) => {
+    const loadedFiles = [];
+    const total = count || files.length;
+    for (let i = 0; i < total; i++) {
+        // End the loop if count is higher than number of available files
+        if (i >= files.length)
+            break;
+        // Load images
+        const filepath = files[i];
+        const file = await fs.readFile(filepath);
+        loadedFiles.push(file);
+    }
+    return loadedFiles;
+};
+export const getFilepathsFromDirectory = async (dir, recursive, depth = 0) => {
+    // Ensure recursiveness ends at the max recursion depth
+    if (depth >= MAX_RECURSION_DEPTH)
+        return [];
+    // Get entries
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const file = path.join(entry.parentPath, entry.name);
+        // If the entry is a file, add it to the list
+        if (entry.isFile()) {
+            files.push(file);
+        }
+        // If it's a directory AND the recursive option is true,
+        // recursively get all the files
+        else if (recursive && entry.isDirectory() && !entry.isSymbolicLink()) {
+            const dirPath = path.join(entry.parentPath, entry.name);
+            const paths = await getFilepathsFromDirectory(dirPath, recursive, depth + 1);
+            files.push(...paths);
+        }
+    }
+    return files;
+};
+const validateFilepaths = (filepaths) => {
+    const ignoredPaths = [];
+    const imagePaths = [];
+    for (const filepath of filepaths) {
+        if (path.basename(filepath) === '.DS_Store')
+            continue;
+        const extname = path.extname(filepath).replace('.', '');
+        isSupportedInputImage(extname) ? imagePaths.push(filepath) : ignoredPaths.push(filepath);
+    }
+    return { ignoredPaths, imagePaths };
+};

package/dist/cli/modules/progressBar.d.ts

@@ -0,0 +1,10 @@
+import { SingleBar } from 'cli-progress';
+import type { ProgressInfo } from '../../core/merges/types.js';
+export declare class MergeProgressBar {
+    #private;
+    progressBar: SingleBar;
+    constructor();
+    startBar(phase: string): void;
+    updateBar(progressInfo: ProgressInfo): void;
+    endBar(): void;
+}

package/dist/cli/modules/progressBar.js

@@ -0,0 +1,34 @@
+import { SingleBar } from 'cli-progress';
+import chalk from 'chalk';
+const title = chalk.gray('Creating Image:');
+const bar = chalk.blue('{bar}');
+const percentage = chalk.yellow('{percentage}%');
+const eta = chalk.blue('ETA: ') + chalk.yellow('{eta_formatted}');
+const phase = chalk.gray('{phase}...');
+const divider = chalk.blue('|');
+export class MergeProgressBar {
+    #PROCESSING_WEIGHT = 0.95;
+    progressBar;
+    constructor() {
+        // Initialize progress bar
+        this.progressBar = new SingleBar({
+            format: `${title} ${divider}${bar}${divider} ${percentage} ${divider} ${eta} ${divider} ${phase} `,
+            barCompleteChar: '\u2588',
+            barIncompleteChar: '\u2591',
+            stopOnComplete: true,
+            barsize: 40,
+            etaBuffer: 50,
+        });
+    }
+    startBar(phase) {
+        this.progressBar.start(100, 0, { phase });
+    }
+    updateBar(progressInfo) {
+        const processing = progressInfo.completed / progressInfo.total;
+        const progress = processing * this.#PROCESSING_WEIGHT;
+        this.progressBar.update(progress * 100, { phase: processing === 1 ? 'Writing to file' : progressInfo.phase });
+    }
+    endBar() {
+        this.progressBar.update(100);
+    }
+}

package/dist/cli/schemas/collage.d.ts

@@ -0,0 +1,29 @@
+import z from 'zod';
+export declare const cliCollageSchema: z.ZodObject<{
+    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dir: z.ZodOptional<z.ZodString>;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    shuffle: z.ZodDefault<z.ZodBoolean>;
+    cornerRadius: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    gap: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    canvasColor: z.ZodPrefault<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/utils/colors/types.js").RGBA, string>>, z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        alpha: z.ZodNumber;
+    }, z.z.core.$strip>]>>;
+    borderWidth: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    borderColor: z.ZodPrefault<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/utils/colors/types.js").RGBA, string>>, z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        alpha: z.ZodNumber;
+    }, z.z.core.$strip>]>>;
+    output: z.ZodDefault<z.ZodString>;
+    aspectRatio: z.ZodPrefault<z.ZodPipe<z.z.ZodCoercedString<unknown>, z.ZodTransform<number, string>>>;
+    imageWidth: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    columns: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    overlapPercentage: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    rotationRange: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    imageWidthVariance: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+}, z.z.core.$strict>;

package/dist/cli/schemas/collage.js

@@ -0,0 +1,38 @@
+import z from 'zod';
+import { VALIDATORS } from '../../validators/index.js';
+export const cliCollageSchema = z
+    .strictObject({
+    files: VALIDATORS.files.optional(),
+    dir: VALIDATORS.dir.optional(),
+    recursive: VALIDATORS.recursive.default(false),
+    shuffle: VALIDATORS.shuffle.default(false),
+    cornerRadius: VALIDATORS.cliCornerRadius.default(0),
+    gap: VALIDATORS.cliGap.default(50),
+    canvasColor: VALIDATORS.canvasColor.prefault('#fff'),
+    borderWidth: VALIDATORS.cliBorderWidth.default(0),
+    borderColor: VALIDATORS.borderColor.prefault('#000'),
+    output: VALIDATORS.output.default('./pixeli.png'),
+    aspectRatio: VALIDATORS.aspectRatio.prefault('1:1'),
+    imageWidth: VALIDATORS.cliImageWidth.optional(),
+    columns: VALIDATORS.cliColumns.default(4),
+    overlapPercentage: VALIDATORS.cliOverlapPercentage.default(25),
+    rotationRange: VALIDATORS.cliRotationRange.default(7),
+    imageWidthVariance: VALIDATORS.cliImageWidthVariance.default(10),
+})
+    .superRefine((opts, ctx) => {
+    // files XOR dir
+    if (opts.files && !opts.files.length && !opts.dir) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'You must provide either --files or --dir',
+            path: [],
+        });
+    }
+    if (opts.files && opts.files.length && opts.dir) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'You cannot use --files and --dir together',
+            path: [],
+        });
+    }
+});

package/dist/cli/schemas/grid.d.ts

@@ -0,0 +1,34 @@
+import z from 'zod';
+export declare const cliGridSchema: z.ZodObject<{
+    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dir: z.ZodOptional<z.ZodString>;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    shuffle: z.ZodDefault<z.ZodBoolean>;
+    cornerRadius: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    gap: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    canvasColor: z.ZodPrefault<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/utils/colors/types.js").RGBA, string>>, z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        alpha: z.ZodNumber;
+    }, z.z.core.$strip>]>>;
+    output: z.ZodDefault<z.ZodString>;
+    aspectRatio: z.ZodPrefault<z.ZodPipe<z.z.ZodCoercedString<unknown>, z.ZodTransform<number, string>>>;
+    imageWidth: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    columns: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    caption: z.ZodDefault<z.ZodBoolean>;
+    captionColor: z.ZodPrefault<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/utils/colors/types.js").RGBA, string>>, z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        alpha: z.ZodNumber;
+    }, z.z.core.$strip>]>>;
+    borderWidth: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    borderColor: z.ZodPrefault<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/utils/colors/types.js").RGBA, string>>, z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        alpha: z.ZodNumber;
+    }, z.z.core.$strip>]>>;
+    maxCaptionSize: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+}, z.z.core.$strict>;

package/dist/cli/schemas/grid.js

@@ -0,0 +1,38 @@
+import z from 'zod';
+import { VALIDATORS } from '../../validators/index.js';
+export const cliGridSchema = z
+    .strictObject({
+    files: VALIDATORS.files.optional(),
+    dir: VALIDATORS.dir.optional(),
+    recursive: VALIDATORS.recursive.default(false),
+    shuffle: VALIDATORS.shuffle.default(false),
+    cornerRadius: VALIDATORS.cliCornerRadius.default(0),
+    gap: VALIDATORS.cliGap.default(50),
+    canvasColor: VALIDATORS.canvasColor.prefault('#fff'),
+    output: VALIDATORS.output.default('./pixeli.png'),
+    aspectRatio: VALIDATORS.aspectRatio.prefault('1:1'),
+    imageWidth: VALIDATORS.cliImageWidth.optional(),
+    columns: VALIDATORS.cliColumns.default(4),
+    caption: VALIDATORS.caption.default(false),
+    captionColor: VALIDATORS.captionColor.prefault('#000'),
+    borderWidth: VALIDATORS.cliBorderWidth.default(0),
+    borderColor: VALIDATORS.borderColor.prefault("#000"),
+    maxCaptionSize: VALIDATORS.cliMaxCaptionSize.default(100),
+})
+    .superRefine((opts, ctx) => {
+    // files XOR dir
+    if (opts.files && !opts.files.length && !opts.dir) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'You must provide either --files or --dir',
+            path: [],
+        });
+    }
+    if (opts.files && opts.files.length && opts.dir) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'You cannot use --files and --dir together',
+            path: [],
+        });
+    }
+});

package/dist/cli/schemas/masonry.d.ts

@@ -0,0 +1,62 @@
+import z from 'zod';
+export declare const cliMasonrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    flow: z.ZodLiteral<"vertical">;
+    columnWidth: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    canvasHeight: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>;
+    vAlign: z.ZodDefault<z.ZodEnum<{
+        justified: "justified";
+        top: "top";
+        middle: "middle";
+        bottom: "bottom";
+    }>>;
+    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dir: z.ZodOptional<z.ZodString>;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    shuffle: z.ZodDefault<z.ZodBoolean>;
+    cornerRadius: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    gap: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    canvasColor: z.ZodPrefault<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/utils/colors/types.js").RGBA, string>>, z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        alpha: z.ZodNumber;
+    }, z.z.core.$strip>]>>;
+    borderWidth: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    borderColor: z.ZodPrefault<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/utils/colors/types.js").RGBA, string>>, z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        alpha: z.ZodNumber;
+    }, z.z.core.$strip>]>>;
+    output: z.ZodDefault<z.ZodString>;
+}, z.z.core.$strip>, z.ZodObject<{
+    flow: z.ZodDefault<z.ZodLiteral<"horizontal">>;
+    rowHeight: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    canvasWidth: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>;
+    hAlign: z.ZodDefault<z.ZodEnum<{
+        left: "left";
+        center: "center";
+        right: "right";
+        justified: "justified";
+    }>>;
+    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dir: z.ZodOptional<z.ZodString>;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    shuffle: z.ZodDefault<z.ZodBoolean>;
+    cornerRadius: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    gap: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    canvasColor: z.ZodPrefault<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/utils/colors/types.js").RGBA, string>>, z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        alpha: z.ZodNumber;
+    }, z.z.core.$strip>]>>;
+    borderWidth: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    borderColor: z.ZodPrefault<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/utils/colors/types.js").RGBA, string>>, z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        alpha: z.ZodNumber;
+    }, z.z.core.$strip>]>>;
+    output: z.ZodDefault<z.ZodString>;
+}, z.z.core.$strip>], "flow">;

package/dist/cli/schemas/masonry.js

@@ -0,0 +1,62 @@
+import z from 'zod';
+import { VALIDATORS } from '../../validators/index.js';
+const baseCliMasonryOptions = z.object({
+    files: VALIDATORS.files.optional(),
+    dir: VALIDATORS.dir.optional(),
+    recursive: VALIDATORS.recursive.default(false),
+    shuffle: VALIDATORS.shuffle.default(false),
+    cornerRadius: VALIDATORS.cliCornerRadius.default(0),
+    gap: VALIDATORS.cliGap.default(50),
+    canvasColor: VALIDATORS.canvasColor.prefault('#fff'),
+    borderWidth: VALIDATORS.cliBorderWidth.default(0),
+    borderColor: VALIDATORS.borderColor.prefault('#000'),
+    output: VALIDATORS.output.default('./pixeli.png'),
+    flow: VALIDATORS.flow.default('horizontal'),
+});
+const horizontalCliMasonryOptions = z.object({
+    ...baseCliMasonryOptions.shape,
+    flow: z.literal('horizontal').default('horizontal'), // default() ensures proper command line defaults
+    rowHeight: VALIDATORS.cliRowHeight.optional(),
+    canvasWidth: VALIDATORS.cliCanvasWidth,
+    hAlign: VALIDATORS.hAlign.default('justified'),
+});
+const verticalCliMasonryOptions = z.object({
+    ...baseCliMasonryOptions.shape,
+    flow: z.literal('vertical'),
+    columnWidth: VALIDATORS.cliColumnWidth.optional(),
+    canvasHeight: VALIDATORS.cliCanvasHeight,
+    vAlign: VALIDATORS.vAlign.default('justified'),
+});
+export const cliMasonrySchema = z
+    .discriminatedUnion('flow', [verticalCliMasonryOptions, horizontalCliMasonryOptions])
+    .superRefine((opts, ctx) => {
+    // files XOR dir
+    if (opts.files && !opts.files.length && !opts.dir) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'You must provide either --files or --dir',
+            path: [],
+        });
+    }
+    if (opts.files && opts.files.length && opts.dir) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'You cannot use --files and --dir together',
+            path: [],
+        });
+    }
+    if (opts.flow === 'horizontal' && opts.canvasWidth <= opts.gap * 2) {
+        ctx.addIssue({
+            code: 'custom',
+            message: "Canvas is too small to place images in. Increase 'canvasWidth'.",
+            path: ['canvasWidth'],
+        });
+    }
+    if (opts.flow === 'vertical' && opts.canvasHeight <= opts.gap * 2) {
+        ctx.addIssue({
+            code: 'custom',
+            message: "Canvas is too small to place images in. Increase 'canvasHeight'.",
+            path: ['canvasHeight'],
+        });
+    }
+});

package/dist/cli/schemas/template.d.ts

@@ -0,0 +1,31 @@
+import z from 'zod';
+export declare const cliTemplateSchema: z.ZodObject<{
+    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dir: z.ZodOptional<z.ZodString>;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    shuffle: z.ZodDefault<z.ZodBoolean>;
+    cornerRadius: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    gap: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    canvasColor: z.ZodPrefault<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/utils/colors/types.js").RGBA, string>>, z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        alpha: z.ZodNumber;
+    }, z.z.core.$strip>]>>;
+    borderWidth: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    borderColor: z.ZodPrefault<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<import("../../core/utils/colors/types.js").RGBA, string>>, z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+        alpha: z.ZodNumber;
+    }, z.z.core.$strip>]>>;
+    output: z.ZodDefault<z.ZodString>;
+    template: z.ZodOptional<z.ZodString>;
+    preset: z.ZodOptional<z.ZodEnum<{
+        "instagram-grid": "instagram-grid";
+        "dashboard-shot": "dashboard-shot";
+        "horizontal-book-spread": "horizontal-book-spread";
+        "vertical-book-spread": "vertical-book-spread";
+        "art-gallery": "art-gallery";
+    }>>;
+}, z.z.core.$strict>;

package/dist/cli/schemas/template.js

@@ -0,0 +1,49 @@
+import z from 'zod';
+import { VALIDATORS } from '../../validators/index.js';
+export const cliTemplateSchema = z
+    .strictObject({
+    files: VALIDATORS.files.optional(),
+    dir: VALIDATORS.dir.optional(),
+    recursive: VALIDATORS.recursive.default(false),
+    shuffle: VALIDATORS.shuffle.default(false),
+    cornerRadius: VALIDATORS.cliCornerRadius.default(0),
+    gap: VALIDATORS.cliGap.default(50),
+    canvasColor: VALIDATORS.canvasColor.prefault('#fff'),
+    borderWidth: VALIDATORS.cliBorderWidth.default(0),
+    borderColor: VALIDATORS.borderColor.prefault('#000'),
+    output: VALIDATORS.output.default('./pixeli.png'),
+    template: VALIDATORS.cliTemplate.optional(),
+    preset: VALIDATORS.preset.optional(),
+})
+    .superRefine((opts, ctx) => {
+    // files XOR dir
+    if (opts.files && !opts.files.length && !opts.dir) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'You must provide either --files or --dir',
+            path: [],
+        });
+    }
+    if (opts.files && opts.files.length && opts.dir) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'You cannot use --files and --dir together',
+            path: [],
+        });
+    }
+    // template XOR preset
+    if (!opts.template && !opts.preset) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'You must provide either --template or --preset',
+            path: [],
+        });
+    }
+    if (opts.template && opts.preset) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'You cannot use --template and --preset together',
+            path: [],
+        });
+    }
+});

package/dist/cli/utils/buildCommandFromSchema.d.ts

@@ -0,0 +1,8 @@
+import z from 'zod';
+import { Command } from 'commander';
+interface CommandBuilderOption {
+    flags: string;
+    description: string;
+}
+export declare const buildCommandFromSchema: <Shape extends z.ZodRawShape>(name: string, description: string, schema: z.ZodObject<Shape> | z.ZodUnion, args: Record<string, CommandBuilderOption>, options: Record<string, CommandBuilderOption>) => Command;
+export {};