assets-toolkit 1.0.0

package/LICENSE

@@ -0,0 +1,7 @@
+MIT License
+
+Copyright (c) 2026 Mukthahar Shaik
+
+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...

package/README.md

@@ -0,0 +1,354 @@
+# Assets Toolkit
+
+> Generate clean, typed, production-ready asset maps for React Native, Expo, React, Next.js, and Vite projects.
+
+![npm](https://img.shields.io/npm/v/assets-toolkit?color=0f766e)
+![license](https://img.shields.io/npm/l/assets-toolkit?color=2563eb)
+![typescript](https://img.shields.io/badge/TypeScript-ready-3178c6)
+![platforms](https://img.shields.io/badge/platforms-RN%20%7C%20Expo%20%7C%20React%20%7C%20Next%20%7C%20Vite-7c3aed)
+
+Assets Toolkit scans your project assets, validates them, detects duplicates and risky files, then generates a typed asset map you can import from your app code. It is built for teams that want asset access to feel boring in the best way: consistent names, stable imports, and fewer surprises during release.
+
+```txt
+assets/                      generated-assets/
+  logo.png        ─────▶       index.ts
+  icons/search.svg             images-generate.ts
+  fonts/Inter.ttf              svg-generate.ts
+                               fonts-generate.ts
+```
+
+## ✨ Why Use It?
+
+- 🚀 Generate one tidy `Assets` object from images, SVGs, fonts, audio, video, and Lottie files.
+- 🗂️ Keep nested folder structure in the generated output.
+- 🧹 Detect duplicate files before they bloat your app.
+- 🛡️ Catch invalid filenames before Metro, Vite, Next.js, or CI complains.
+- 📊 Check large assets and platform support from one simple command.
+- ♻️ Clean generated files and cache whenever you want a fresh build.
+
+## 📦 Installation
+
+Install it as a development dependency:
+
+```sh
+npm install --save-dev assets-toolkit
+```
+
+Or run it directly with `npx`:
+
+```sh
+npx assets-toolkit help
+```
+
+## ⚡ Quick Start
+
+Put assets in one of the default folders:
+
+```txt
+assets/
+  logo.png
+  home@2x.png
+  icons/
+    search.svg
+  fonts/
+    Inter.ttf
+```
+
+Generate the asset files:
+
+```sh
+npx assets-toolkit generate
+```
+
+Import the generated output in your app:
+
+```ts
+import { Assets, images, svg, fonts } from "./generated-assets";
+
+const logo = Assets.images.logo;
+const searchIcon = svg.icons.search;
+const interFont = fonts.fonts.Inter;
+```
+
+By default, Assets Toolkit looks in:
+
+```txt
+./src/assets
+./assets
+```
+
+And writes generated files to:
+
+```txt
+./generated-assets
+```
+
+## 🧭 CLI Commands
+
+| Command           | Purpose                                                        |
+| ----------------- | -------------------------------------------------------------- |
+| `generate`, `-g`  | Generate typed asset files.                                    |
+| `doctor`          | Validate assets and detect common problems.                    |
+| `doctor --fix`    | Rename invalid files and remove duplicates after confirmation. |
+| `reports`         | Print asset statistics and project insights.                   |
+| `clean`, `-c`     | Remove generated files and cache.                              |
+| `--version`, `-v` | Show installed package version.                                |
+| `help`, `-h`      | Show CLI help.                                                 |
+
+### `generate`
+
+🚀 Generate asset maps from your project assets.
+
+```sh
+npx assets-toolkit generate
+```
+
+Alias:
+
+```sh
+npx assets-toolkit -g
+```
+
+Useful options:
+
+```sh
+npx assets-toolkit generate --outDir src/generated-assets
+npx assets-toolkit generate -o src/generated-assets
+npx assets-toolkit generate --assetsDir assets
+npx assets-toolkit generate --assetsDirs assets,src/shared/assets
+```
+
+What it does:
+
+- Creates generated category files like `images-generate.ts`, `svg-generate.ts`, and `fonts-generate.ts`.
+- Creates a generated `index.ts` that exports `Assets` plus each category.
+- Preserves nested folders as nested object keys.
+- Skips invalid asset filenames.
+- Reports duplicate files and validation warnings.
+
+### `doctor`
+
+🩺 Inspect your asset setup and find issues before they become runtime problems.
+
+```sh
+npx assets-toolkit doctor
+```
+
+Checks include:
+
+- Missing asset directories
+- Invalid filenames
+- Duplicate assets
+- Unsupported platform assets
+- Large files over the recommended threshold
+
+### `doctor --fix`
+
+🛠️ Preview and fix invalid asset filenames.
+
+```sh
+npx assets-toolkit doctor --fix
+```
+
+Skip the confirmation prompt when you want an automated cleanup:
+
+```sh
+npx assets-toolkit doctor --fix --yes
+```
+
+This command can:
+
+- Rename invalid filenames into safe asset names.
+- Avoid collisions with files that already exist.
+- Remove duplicate asset files after confirmation.
+
+### `reports`
+
+📊 Show a project asset report.
+
+```sh
+npx assets-toolkit reports
+```
+
+The report includes:
+
+- Current configuration
+- Asset counts by category
+- Storage usage
+- Largest assets
+- Extension breakdown
+- Generated output status
+
+### `clean`
+
+♻️ Remove generated files and the Assets Toolkit cache.
+
+```sh
+npx assets-toolkit clean
+```
+
+Alias:
+
+```sh
+npx assets-toolkit -c
+```
+
+Use this when you want to regenerate from a clean state.
+
+### `--version`
+
+🏷️ Print the installed package version.
+
+```sh
+npx assets-toolkit --version
+npx assets-toolkit -v
+```
+
+### `help`
+
+💡 Show CLI help.
+
+```sh
+npx assets-toolkit help
+npx assets-toolkit -h
+```
+
+## ⚙️ Configuration
+
+On first use, Assets Toolkit creates `assets-toolkit.config.json` if it does not already exist.
+
+Default config:
+
+```json
+{
+  "assets": ["./src/assets", "./assets"],
+  "output": "generated-assets",
+  "target": "auto",
+  "duplicates": "ignore"
+}
+```
+
+### Config Options
+
+| Option       | Type       | Description                                                                                                                                                    |
+| ------------ | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `assets`     | `string[]` | Asset directories to scan.                                                                                                                                     |
+| `output`     | `string`   | Directory where generated files are written. Must stay inside the project root.                                                                                |
+| `target`     | `string`   | Valid target value: `auto`, `react-native`, `expo`, `react`, `next`, `vite`, or `unknown`. The CLI auto-detects the active platform from package dependencies. |
+| `duplicates` | `string`   | Duplicate preference value: `ignore`, `warn`, or `error`. Duplicate files are surfaced by `generate`, `doctor`, and `doctor --fix`.                            |
+
+Example:
+
+```json
+{
+  "assets": ["./assets", "./src/shared/assets"],
+  "output": "src/generated-assets",
+  "target": "react-native",
+  "duplicates": "warn"
+}
+```
+
+## 🧩 Supported Assets
+
+| Category | Extensions                                                                                           |
+| -------- | ---------------------------------------------------------------------------------------------------- |
+| Images   | `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.bmp`, `.heic`, `.heif`, `.avif`, `.tiff`, `.tif`, `.ico` |
+| SVG      | `.svg`                                                                                               |
+| Fonts    | `.ttf`, `.otf`, `.woff`, `.woff2`                                                                    |
+| Audio    | `.mp3`, `.wav`, `.aac`, `.m4a`, `.ogg`, `.flac`, `.amr`, `.opus`, `.caf`, `.aiff`                    |
+| Video    | `.mp4`, `.mov`, `.m4v`, `.avi`, `.mkv`, `.webm`, `.3gp`, `.mpeg`, `.mpg`                             |
+| Lottie   | `.lottie`, plus valid Lottie `.json` files                                                           |
+
+## ✅ Filename Rules
+
+Use simple, portable filenames:
+
+```txt
+logo.png
+logo-dark.svg
+home@2x.png
+home@3x.png
+Inter.ttf
+```
+
+Avoid:
+
+```txt
+bad name.png
+bad!name.svg
+logo.PNG
+___.png
+```
+
+Safe filenames make generated keys cleaner and reduce cross-platform build issues.
+
+## 🏗️ Generated Output
+
+After running `generate`, you will get output similar to:
+
+```txt
+generated-assets/
+  index.ts
+  images-generate.ts
+  svg-generate.ts
+  fonts-generate.ts
+  audio-generate.ts
+  video-generate.ts
+  lottie-generate.ts
+```
+
+Example generated shape:
+
+```ts
+export const Assets = {
+  images,
+  svg,
+  fonts,
+  audio,
+  video,
+  lottie,
+} as const;
+```
+
+Nested folders become nested object keys, so your file layout stays readable in code.
+
+## 🧪 Recommended Workflow
+
+Add these scripts to your project:
+
+```json
+{
+  "scripts": {
+    "assets": "assets-toolkit generate",
+    "assets:check": "assets-toolkit doctor",
+    "assets:fix": "assets-toolkit doctor --fix",
+    "assets:report": "assets-toolkit reports",
+    "assets:clean": "assets-toolkit clean"
+  }
+}
+```
+
+Then run:
+
+```sh
+npm run assets:check
+npm run assets
+```
+
+For CI, a simple check is often enough:
+
+```sh
+npx assets-toolkit doctor
+```
+
+## 💎 Practical Tips
+
+- 📁 Keep app assets in `assets` or `src/assets` for zero-config usage.
+- 🧪 Run `doctor` before release builds to catch large, duplicate, or unsupported files.
+- 🛠️ Use `doctor --fix` when designers or teammates add files with spaces or special characters.
+- 📌 Commit generated assets only if your team wants stable generated files in source control.
+- ♻️ Run `clean` when switching branches if generated output looks stale.
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE).

package/dist/cacheHelper.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cacheHelper.d.ts.map

package/dist/cacheHelper.d.ts.map

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

package/dist/cacheHelper.js

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

package/dist/cacheHelper.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+import { runClean } from "./toolkits/clean.js";
+import { runDoctor } from "./toolkits/doctor.js";
+import { generateAssets } from "./toolkits/generator.js";
+import { runReport } from "./toolkits/reports.js";
+import packageJson from "../package.json" with { type: "json" };
+import { runDoctorFix } from "./toolkits/doctorFix.js";
+import { colorText } from "./colorConsole.js";
+import { printHelp } from "./helps/printHelp.js";
+function parseArguments() {
+    const argv = process.argv.slice(2);
+    const result = {
+        command: "",
+        options: {},
+    };
+    if (argv.length === 0) {
+        return result;
+    }
+    result.command = argv[0] ?? "";
+    for (let index = 1; index < argv.length; index += 1) {
+        const arg = argv[index];
+        const nextArg = argv[index + 1];
+        if (arg === "--outDir" || arg === "-o") {
+            if (typeof nextArg === "string") {
+                result.options.outputDir = nextArg;
+            }
+            index += 1;
+        }
+        else if (arg === "--assetsDir") {
+            if (typeof nextArg === "string") {
+                result.options.assetDirectories = [nextArg];
+            }
+            index += 1;
+        }
+        else if (arg === "--assetsDirs") {
+            if (typeof nextArg === "string") {
+                result.options.assetDirectories = nextArg
+                    .split(",")
+                    .map((dir) => dir.trim());
+            }
+            index += 1;
+        }
+        else if (arg === "--fix") {
+            result.options.fix = true;
+        }
+        else if (arg === "--yes") {
+            result.options.yes = true;
+        }
+    }
+    return result;
+}
+const { command, options } = parseArguments();
+if (command === "generate" || command === "-g") {
+    try {
+        generateAssets({
+            outputDir: options.outputDir,
+            assetDirectories: options.assetDirectories,
+        });
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+else if (command === "reports") {
+    runReport();
+}
+else if (command === "doctor") {
+    if (options.fix) {
+        await runDoctorFix(process.cwd(), {
+            yes: options.yes,
+        });
+    }
+    else {
+        await runDoctor(process.cwd());
+    }
+}
+else if (command === "clean" || command === "-c") {
+    runClean();
+}
+else if (command === "help" || command === "-h") {
+    printHelp();
+}
+else if (command === "--version" || command === "-v") {
+    console.log(packageJson.version);
+}
+else {
+    console.log(colorText("info", 'Unknown command. Run "assets-toolkit --help" to see available commands.'));
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/colorConsole.d.ts

@@ -0,0 +1,3 @@
+export type ColorType = "success" | "warning" | "error" | "info" | "title" | "muted" | "command";
+export declare function colorText(type: ColorType, message: string): string;
+//# sourceMappingURL=colorConsole.d.ts.map

package/dist/colorConsole.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorConsole.d.ts","sourceRoot":"","sources":["../src/colorConsole.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,SAAS,GACT,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,GACP,SAAS,CAAC;AAEd,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA0BlE"}

package/dist/colorConsole.js

@@ -0,0 +1,22 @@
+import pc from "picocolors";
+export function colorText(type, message) {
+    switch (type) {
+        case "success":
+            return pc.green(message);
+        case "warning":
+            return pc.yellow(message);
+        case "error":
+            return pc.red(message);
+        case "info":
+            return pc.cyan(message);
+        case "title":
+            return pc.bold(pc.cyan(message));
+        case "muted":
+            return pc.gray(message);
+        case "command":
+            return pc.blue(message);
+        default:
+            return message;
+    }
+}
+//# sourceMappingURL=colorConsole.js.map

package/dist/colorConsole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorConsole.js","sourceRoot":"","sources":["../src/colorConsole.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAW5B,MAAM,UAAU,SAAS,CAAC,IAAe,EAAE,OAAe;IACxD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE3B,KAAK,SAAS;YACZ,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE5B,KAAK,OAAO;YACV,OAAO,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEzB,KAAK,MAAM;YACT,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE1B,KAAK,OAAO;YACV,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAEnC,KAAK,OAAO;YACV,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE1B,KAAK,SAAS;YACZ,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE1B;YACE,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/config-types.d.ts

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

package/dist/config-types.d.ts.map

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

package/dist/config-types.js

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

package/dist/config-types.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+import type { AssetsToolkitConfig } from "./types.js";
+export declare const defaultConfig: Required<AssetsToolkitConfig>;
+export declare function createDefaultConfig(root: string): void;
+export declare function loadConfig(root: string): AssetsToolkitConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMtD,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,mBAAmB,CAKvD,CAAC;AAMF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAStD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAgC5D"}

package/dist/config.js

@@ -0,0 +1,82 @@
+import fs from "fs";
+import path from "path";
+import { ensureGitIgnore } from "./helps/gitignore.js";
+import { colorText } from "./colorConsole.js";
+const CONFIG_FILE = "assets-toolkit.config.json";
+export const defaultConfig = {
+    assets: ["./src/assets", "./assets"],
+    output: "generated-assets",
+    target: "auto",
+    duplicates: "ignore",
+};
+function getConfigPath(root) {
+    return path.join(root, CONFIG_FILE);
+}
+export function createDefaultConfig(root) {
+    const configPath = getConfigPath(root);
+    if (fs.existsSync(configPath)) {
+        return;
+    }
+    fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2), "utf8");
+    ensureGitIgnore(root);
+    console.log(colorText("success", "✓ Created assets-toolkit.config.json"));
+}
+export function loadConfig(root) {
+    const configPath = getConfigPath(root);
+    // First run
+    if (!fs.existsSync(configPath)) {
+        createDefaultConfig(root);
+        return defaultConfig;
+    }
+    try {
+        const content = fs.readFileSync(configPath, "utf8");
+        const userConfig = JSON.parse(content);
+        updateConfigWithDefaults(configPath, userConfig);
+        const config = {
+            ...defaultConfig,
+            ...userConfig,
+        };
+        validateConfig(config);
+        return config;
+    }
+    catch (error) {
+        throw new Error(`Invalid assets-toolkit.config.json: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function validateConfig(config) {
+    if (!Array.isArray(config.assets)) {
+        throw new Error(`"assets" must be an array`);
+    }
+    if (typeof config.output !== "string") {
+        throw new Error(`"output" must be a string`);
+    }
+    const validTargets = [
+        "auto",
+        "react-native",
+        "expo",
+        "react",
+        "next",
+        "vite",
+        "unknown",
+    ];
+    if (!validTargets.includes(config.target)) {
+        throw new Error(`Invalid target "${config.target}"`);
+    }
+    const validDuplicates = ["ignore", "warn", "error"];
+    if (!validDuplicates.includes(config.duplicates)) {
+        throw new Error(`Invalid duplicates option "${config.duplicates}"`);
+    }
+}
+function updateConfigWithDefaults(configPath, userConfig) {
+    const mergedConfig = {
+        ...defaultConfig,
+        ...userConfig,
+    };
+    const missingKeys = Object.keys(defaultConfig).filter((key) => !(key in userConfig));
+    if (missingKeys.length === 0) {
+        return;
+    }
+    fs.writeFileSync(configPath, JSON.stringify(mergedConfig, null, 2), "utf8");
+    console.log(colorText("success", `✓ Updated assets-toolkit.config.json (${missingKeys.join(", ")})`));
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,12 @@
+import type { AssetCategory } from "./types.js";
+export declare const categoryExtensions: Record<AssetCategory, string[]>;
+export declare const SUPPORTED_EXTENSIONS: Set<string>;
+export declare const VALID_FILE_NAME: RegExp;
+export declare const INVALID_FILE_NAME_REASONS: {
+    readonly EMPTY: "Empty filename";
+    readonly ONLY_UNDERSCORES: "Filename contains only underscores";
+    readonly STARTS_WITH_NUMBER: "Filename starts with a number";
+    readonly INVALID_CHARACTERS: "Filename contains invalid characters";
+    readonly UPPERCASE_EXTENSION: "Uppercase extension";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAyC9D,CAAC;AAEF,eAAO,MAAM,oBAAoB,aAEhC,CAAC;AAEF,eAAO,MAAM,eAAe,QAC0B,CAAC;AAEvD,eAAO,MAAM,yBAAyB;aACpC,KAAK,EAAE,gBAAgB;aACvB,gBAAgB,EAAE,oCAAoC;aACtD,kBAAkB,EAAE,+BAA+B;aACnD,kBAAkB,EAAE,sCAAsC;aAC1D,mBAAmB,EAAE,qBAAqB;CAClC,CAAC"}