@aippy/vite-plugins 0.4.0-dev.1 → 0.4.0-dev.3

package/README.md

@@ -102,8 +102,8 @@ const projectRoot = findProjectRoot(); // '/path/to/project'
 
 UNLICENSED - Aippy Team
 
-## Asset manifest v1
+## Asset files
 
-Version 0.4.0-dev.1 reads both legacy flat URL inventories and `schemaVersion: 1` manifests. Assets Agent writes resource plans; development builds preserve their metadata and supplement resources discovered by the existing scanner. Invalid v1 inventories and manifest/wrapper write failures stop the build.
+`src/config/assets.json` is a flat URL dictionary. The plugin writes only that file. The project-root `assets-plan.json` is read-only input for reserved names and `implementation.path` exclusions; a missing or unreadable plan does not stop the build. Invalid dictionary JSON, or a single-file v1 plan stored in the dictionary, stops the build without overwriting the file.
 
-Import the generated flat URL map from `@/config/assets`. Only entries with usable URLs appear in that map; the existing `window.getReplacedAssets` hook still mutates it in place. Source-code assets and generated fallbacks with an exact `implementation.path` retain their original source references. Preload reads resource URLs rather than generation prompts or error text. The JSON schema is exported as `@aippy/vite-plugins/assets.schema.json`; parser checks also enforce byte, reference and semantic constraints.
+Import the generated map from `@/config/assets`. It exports the dictionary's string values. `window.getReplacedAssets` still mutates that object in place. Preload reads those string values and URLs in other source files, not prompts inside the plan. The JSON schema remains `@aippy/vite-plugins/assets.schema.json`. Version 0.4.0-dev.3 is prepared locally and is not published yet.

package/dist/aippy-preload/html-utils.d.ts

@@ -1,11 +1,6 @@
 /**
  * HTML processing utilities for aippy preload plugin
  */
-/**
- * Generate meta tags for asset preloading
- * @param assets - Array of asset URLs
- * @returns HTML meta tags string
- */
 export declare function generateMetaTags(assets: string[]): string;
 /**
  * Inject meta tags into HTML content

package/dist/aippy-preload/index.js

@@ -1,2 +1,2 @@
-import { t as e } from "../aippy-preload-QZY6fyKx.js";
+import { t as e } from "../aippy-preload-DtngFmJ5.js";
 export { e as aippyPreloadPlugin, e as default };

package/dist/aippy-preload-DtngFmJ5.js

@@ -0,0 +1,186 @@
+import { extractAssetsFromContent as e, isValidAsset as t } from "./utils/index.js";
+import { a as n, l as r, m as i, n as a, o, s } from "./generator-utils-CFYv7n_h.js";
+import { promises as c } from "fs";
+import l from "path";
+//#region src/aippy-preload/scanner-utils.ts
+async function u(t) {
+	let n = [], r = [l.join(process.cwd(), "index.html")];
+	for (let i of r) try {
+		let r = await c.readFile(i, "utf-8"), a = e(r, "html", t);
+		n.push(...a);
+	} catch {
+		console.warn("⚠️  No index.html found in project root");
+	}
+	return n;
+}
+async function d(t, n) {
+	let u = [], d = l.resolve(t, "config/assets.json"), f, p = /* @__PURE__ */ new Set();
+	try {
+		let e = JSON.parse(await c.readFile(d, "utf8"));
+		if (a(e)) {
+			let t = s(JSON.stringify(e));
+			o(t) && (f = t);
+		} else e && typeof e == "object" && !Array.isArray(e) && (p = new Set(Object.keys(e)));
+	} catch {}
+	let m = await i(t, [
+		".ts",
+		".tsx",
+		".js",
+		".jsx"
+	]);
+	for (let i of m) try {
+		if (f && l.resolve(i) === d.replace(/\.json$/, ".ts")) continue;
+		let a = await c.readFile(i, "utf-8"), o = e(a, "js", n), s = /* @__PURE__ */ new Set([...p, ...f ? Object.keys(f.assets) : []]);
+		o.some((e) => s.has(e)) && (o = e(r(a, i, t, d), "js", n)), u.push(...o);
+	} catch (e) {
+		console.warn(`⚠️  Failed to read JS file: ${i}`, e);
+	}
+	return u;
+}
+async function f(t, n) {
+	let r = [], a = await i(t, [
+		".css",
+		".scss",
+		".sass",
+		".less"
+	]);
+	for (let t of a) try {
+		let i = await c.readFile(t, "utf-8"), a = e(i, "css", n);
+		r.push(...a);
+	} catch (e) {
+		console.warn(`⚠️  Failed to read CSS file: ${t}`, e);
+	}
+	return r;
+}
+function p(e, n) {
+	if (!t(e) || /["'<>\s`]/.test(e)) return !1;
+	let r = e.split(/[?#]/, 1)[0].toLowerCase();
+	return n.some((e) => r.endsWith(e.toLowerCase()));
+}
+async function m(t, r) {
+	let u = [], d = await i(t, [".json"]);
+	for (let i of d) try {
+		let d = await c.readFile(i, "utf-8");
+		if (l.basename(i) === "assets-plan.json") continue;
+		if (l.resolve(i) === l.resolve(t, "config/assets.json")) {
+			let e = JSON.parse(d);
+			if (a(e)) {
+				let e = s(d);
+				if (o(e)) {
+					u.push(...Object.values(n(e)));
+					continue;
+				}
+			}
+			if (e && typeof e == "object" && !Array.isArray(e)) {
+				for (let t of Object.values(e)) typeof t == "string" && p(t, r) && u.push(t);
+				continue;
+			}
+		}
+		let f = e(d, "js", r);
+		u.push(...f);
+	} catch (e) {
+		console.warn(`⚠️  Failed to read JSON file: ${i}`, e);
+	}
+	return u;
+}
+async function h(e, t, n) {
+	console.log("🔍 Scanning source files for static assets...");
+	let r = [];
+	if (n) {
+		console.log("🔍 Deep scanning source file contents...");
+		let [n, i, a, o] = await Promise.all([
+			u(t),
+			d(e, t),
+			f(e, t),
+			m(e, t)
+		]);
+		r.push(...n, ...i, ...a, ...o);
+	}
+	return [...new Set(r)];
+}
+//#endregion
+//#region src/aippy-preload/html-utils.ts
+var g = "<head>", _ = 6;
+function v(e) {
+	return e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/'/g, "&#39;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function y(e) {
+	return e.map((e) => `    <meta content="${v(e)}" name="aippy:preload">`).join("\n");
+}
+function b(e, t) {
+	let n = e.indexOf(g);
+	if (n === -1) throw Error("Could not find <head> tag in HTML");
+	let r = n + _;
+	return e.slice(0, r) + "\n" + t + "\n" + e.slice(r);
+}
+function x(e) {
+	let t = e.length;
+	if (console.log(`📁 Found ${t} static ${t === 1 ? "asset" : "assets"} in source files`), t === 0) {
+		console.log("⚠️  No static assets found in source files.");
+		return;
+	}
+	console.log(`📋 ${t === 1 ? "Asset" : "Assets"} found:`), e.forEach((e) => console.log(`   - ${e}`));
+}
+function S(e) {
+	console.log(`✅ Injected ${e} preload meta ${e === 1 ? "tag" : "tags"} into index.html`);
+}
+//#endregion
+//#region src/aippy-preload/index.ts
+var C = 3, w = 1e3;
+function T(e) {
+	return new Promise((t) => setTimeout(t, e));
+}
+async function E(e, t = C, n = w) {
+	for (let r = 1; r <= t; r++) try {
+		return await c.readFile(e, "utf-8");
+	} catch (e) {
+		if (e.code === "ENOENT") {
+			if (r < t) {
+				console.log(`⏳ index.html not found, waiting ${n}ms before retry (attempt ${r}/${t})...`), await T(n);
+				continue;
+			}
+			return console.log(`⚠️ index.html not found after ${t} attempts, skipping preload injection.`), null;
+		}
+		return console.error("❌ Error reading index.html:", e), null;
+	}
+	return null;
+}
+function D(e = {}) {
+	let t = {
+		extensions: [
+			".png",
+			".jpg",
+			".jpeg",
+			".gif",
+			".svg",
+			".mp4",
+			".mp3",
+			".wav",
+			".ogg",
+			".webm"
+		],
+		srcDir: "src",
+		outDir: "dist",
+		deepScan: !0,
+		...e
+	};
+	return {
+		name: "vite-plugin-aippy-preload",
+		apply: "build",
+		enforce: "post",
+		async writeBundle() {
+			try {
+				let e = await h(t.srcDir, t.extensions, t.deepScan);
+				if (x(e), e.length === 0) return;
+				let n = l.join(t.outDir, "index.html"), r = await E(n);
+				if (r === null) return;
+				let i = b(r, y(e));
+				await c.writeFile(n, i, "utf-8"), S(e.length);
+			} catch (e) {
+				console.error("❌ Error in aippy preload plugin:", e);
+			}
+		}
+	};
+}
+//#endregion
+export { D as t };

package/dist/asset-constants/generator-utils.d.ts

@@ -1,12 +1,11 @@
 import { AssetInfo } from './types';
-import { AssetDocument } from './manifest';
+/** A flat dictionary is a v1 plan only when schemaVersion is a number and assets is an object. */
+export declare function isSingleFilePlan(value: unknown): boolean;
 /**
- * Generate assets.json file content from asset info
- * @param assets - Map of assets
- * @param existingAssets - Map of existing assets from previous runs
- * @returns JSON string
+ * Write the flat dictionary. Existing keys and non-string values stay; scanned
+ * resources only add a key when that URL is not already present.
  */
-export declare function generateAssetsFileContent(assets: Map<string, AssetInfo>, existingAssets: Map<string, string>, document?: AssetDocument): string;
+export declare function generateAssetsFileContent(assets: Map<string, AssetInfo>, existingAssets: Map<string, string>, flat?: Record<string, unknown>): string;
 /**
  * Parse existing assets.json file
  * @param content - File content

package/dist/asset-constants/index.js

@@ -1,2 +1,325 @@
-import { t as e } from "../asset-constants-C59CLHCE.js";
-export { e as assetConstantsPlugin, e as default };
+import { extractAssetsFromContent as e, generateConstantName as t, processAssetURL as n } from "../utils/index.js";
+import { c as r, d as i, f as a, g as o, h as s, i as c, l, m as u, n as d, o as f, p, r as m, s as h, t as g, u as _ } from "../generator-utils-CFYv7n_h.js";
+import { promises as v } from "fs";
+import y from "path";
+import { parse as b } from "@babel/parser";
+import x from "@babel/traverse";
+import * as S from "@babel/types";
+import C from "@babel/generator";
+//#region src/asset-constants/index.ts
+var w = typeof x == "function" ? x : x.default, T = typeof C == "function" ? C : C.default, E = class extends Error {}, D = class {
+	isStructuredInventory() {
+		return this.document !== void 0 && f(this.document);
+	}
+	constructor(e = {}) {
+		o(this, "options", void 0), o(this, "assets", /* @__PURE__ */ new Map()), o(this, "existingAssets", /* @__PURE__ */ new Map()), o(this, "flat", {}), o(this, "fileCache", new a()), o(this, "document", void 0), o(this, "implementationPaths", /* @__PURE__ */ new Set()), this.options = {
+			extensions: [
+				".png",
+				".jpg",
+				".jpeg",
+				".gif",
+				".svg",
+				".mp4",
+				".mp3",
+				".wav",
+				".ogg",
+				".webm"
+			],
+			srcDir: "src",
+			outputFile: "src/config/assets.json",
+			devMode: !1,
+			...e
+		};
+	}
+	clearCache() {
+		this.fileCache.clear();
+	}
+	generateConstantName(e) {
+		let n = /* @__PURE__ */ new Set([
+			...Array.from(this.assets.values()).map((e) => e.constantName),
+			...Array.from(this.existingAssets.values()),
+			...this.document && f(this.document) ? Object.keys(this.document.assets) : []
+		]);
+		return t(e, n);
+	}
+	async scanTsFile(t) {
+		try {
+			let n = await this.fileCache.read(t), r = [], i = e(n, "js", this.options.extensions), a = /* @__PURE__ */ new Set([...Object.keys(this.flat), ...this.document && f(this.document) ? Object.keys(this.document.assets) : []]);
+			if (i.some((e) => a.has(e))) {
+				let r = l(n, t, this.options.srcDir, this.options.outputFile);
+				i = e(r, "js", this.options.extensions);
+			}
+			let o = n.split("\n");
+			return i.forEach((e) => {
+				if (this.isImplementationReference(t, e)) return;
+				let n = this.generateConstantName(e), i = o.findIndex((t) => t.includes(e)) + 1;
+				r.push({
+					originalUri: e,
+					constantName: n,
+					filePath: t,
+					line: i,
+					column: 1
+				});
+			}), r;
+		} catch (e) {
+			return console.warn(`Warning: Failed to scan ${t}:`, e), [];
+		}
+	}
+	async scanAllTsFiles() {
+		let e = this.options.srcDir;
+		try {
+			let t = await u(e, [".ts", ".tsx"]);
+			for (let e of t) e.endsWith("assets.json") || e.endsWith("assets.ts") || (await this.scanTsFile(e)).forEach((e) => {
+				this.existingAssets.has(e.originalUri) && (e.constantName = this.existingAssets.get(e.originalUri));
+				let t = e.originalUri;
+				this.assets.has(t) || this.assets.set(t, e);
+			});
+		} catch (e) {
+			console.error("Error scanning TypeScript files:", e);
+		}
+	}
+	async readExistingAssetsFile() {
+		try {
+			return await v.readFile(this.options.outputFile, "utf-8");
+		} catch (e) {
+			if (e.code === "ENOENT") return "";
+			throw new E("Unable to read assets.json: " + String(e));
+		}
+	}
+	sidecarPath() {
+		return y.resolve(this.options.srcDir, "..", "assets-plan.json");
+	}
+	async parseExistingAssets() {
+		let e = await this.readExistingAssetsFile();
+		if (e.trim()) {
+			let t;
+			try {
+				t = JSON.parse(e);
+			} catch {
+				throw new E("assets: invalid JSON syntax");
+			}
+			if (d(t)) throw new E("assets: single-file asset plan is not supported");
+			if (!t || typeof t != "object" || Array.isArray(t)) throw new E("assets: URL dictionary object required");
+			this.flat = { ...t };
+		}
+		try {
+			this.existingAssets = c(e);
+		} catch (e) {
+			throw new E(e instanceof Error ? e.message : "assets: invalid JSON syntax");
+		}
+		await this.readSidecar();
+	}
+	async readSidecar() {
+		let e = "";
+		try {
+			e = await v.readFile(this.sidecarPath(), "utf-8");
+		} catch (e) {
+			e.code !== "ENOENT" && console.warn("assets: unable to read assets-plan.json; continuing with the dictionary only");
+			return;
+		}
+		if (!e.trim()) return;
+		let t;
+		try {
+			t = JSON.parse(e);
+		} catch {
+			console.warn("assets: assets-plan.json is not valid JSON; continuing with the dictionary only");
+			return;
+		}
+		if (!d(t)) {
+			console.warn("assets: assets-plan.json is not a plan; continuing with the dictionary only");
+			return;
+		}
+		try {
+			this.document = h(e);
+		} catch {
+			console.warn("assets: assets-plan.json could not be read; continuing with the dictionary only");
+			return;
+		}
+		if (!f(this.document)) return;
+		let n = y.resolve(this.options.srcDir, "..");
+		this.implementationPaths = new Set(Object.values(this.document.assets).filter((e) => e.implementation?.path).map((e) => y.resolve(n, e.implementation.path)));
+	}
+	isImplementationReference(e, t) {
+		if (!this.implementationPaths.size || /^[a-z][a-z0-9+.-]*:/i.test(t) || t.startsWith("//")) return !1;
+		let n = t.split(/[?#]/)[0], r = n.startsWith("@/") ? y.resolve(this.options.srcDir, n.slice(2)) : y.resolve(y.dirname(e), n);
+		return this.implementationPaths.has(r);
+	}
+	async generateAssetsFile() {
+		await this.parseExistingAssets(), await this.scanAllTsFiles();
+		let e = g(this.assets, this.existingAssets, this.flat), t = y.dirname(this.options.outputFile);
+		await v.mkdir(t, { recursive: !0 }), await v.writeFile(this.options.outputFile, e, "utf-8"), await this.generateAssetsWrapper(), m(this.assets.size, this.existingAssets, this.assets, this.options.outputFile);
+	}
+	async generateAssetsWrapper() {
+		let e = this.options.outputFile.replace(/\.json$/, ".ts"), t = `// 🍎 Auto-generated wrapper for assets.json
+// This file handles iOS image replacement via asset-interceptor.js
+import assetsData from "./${y.basename(this.options.outputFile)}";
+
+// Batch process all asset URLs for potential replacements
+// sessionStorage may contain __aippy_asset_overrides__ with multiple image mappings
+(window as any).getReplacedAssets?.(assetsData);
+
+export default assetsData;
+`;
+		await v.writeFile(e, t, "utf-8"), console.log(`  ✓ Generated assets wrapper: ${y.relative(process.cwd(), e)}`);
+	}
+	getAssets() {
+		return Array.from(this.assets.values());
+	}
+	async replaceUrisInFile(e, t) {
+		try {
+			let a = await this.fileCache.read(e), o = b(a, {
+				sourceType: "module",
+				plugins: [
+					"typescript",
+					"jsx",
+					"decorators-legacy"
+				]
+			}), s = !1, c = this.options.outputFile.replace(/\.json$/, ".ts"), l = p(c, this.options.srcDir), u = _(e, this.options.srcDir, this.options.outputFile), d = i(o, u), f = "assetsData", m = !1, h, g = /* @__PURE__ */ new Set();
+			w(o, {
+				Identifier: (e) => {
+					g.add(e.node.name);
+				},
+				ImportDeclaration: (e) => {
+					if (!(!u.has(e.node.source.value) || e.node.importKind === "type")) for (let t of e.node.specifiers) {
+						if (t.importKind === "type") continue;
+						let n = e.scope.getBinding(t.local.name);
+						r(t) && (f = t.local.name, m = !0, h = n);
+					}
+				}
+			});
+			let x = !1;
+			if (m && w(o, { StringLiteral: (r) => {
+				!S.isImportDeclaration(r.parent) && !d(r) && !this.isImplementationReference(e, r.node.value) && t.has(n(r.node.value)) && r.scope.getBinding(f) !== h && (x = !0);
+			} }), !m && g.has(f) || x) {
+				let e = "aippyAssetsData";
+				for (let t = 2; g.has(e); t++) e = `aippyAssetsData${t}`;
+				x && h.scope.rename(f, e), f = e;
+			}
+			if (w(o, { StringLiteral: (r) => {
+				let i = r.node.value;
+				if (this.isImplementationReference(e, i) || d(r) || S.isImportDeclaration(r.parent) || S.isExportNamedDeclaration(r.parent) || S.isExportAllDeclaration(r.parent) || r.findParent((e) => S.isTSType(e.node) || S.isTSInterfaceBody(e.node))) return;
+				let a = n(i);
+				if (t.has(a)) {
+					let e = t.get(a), n = S.memberExpression(S.identifier(f), /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e) ? S.identifier(e) : S.stringLiteral(e), !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e));
+					if ((S.isObjectProperty(r.parent) || S.isObjectMethod(r.parent) || S.isClassProperty(r.parent) || S.isClassMethod(r.parent)) && r.key === "key" && (r.parent.computed = !0), r.parent && S.isJSXAttribute(r.parent)) r.replaceWith(S.jsxExpressionContainer(n));
+					else {
+						try {
+							S.validate(r.parent, r.key, n);
+						} catch {
+							return;
+						}
+						r.replaceWith(n);
+					}
+					r.skip(), s = !0;
+				}
+			} }), !s) return;
+			if (!m) {
+				let e = S.importDeclaration([S.importDefaultSpecifier(S.identifier(f))], S.stringLiteral(l));
+				o.program.body.unshift(e);
+			}
+			let C = T(o, {
+				retainLines: !1,
+				comments: !0,
+				compact: !1
+			}, a);
+			await v.writeFile(e, C.code, "utf-8"), this.fileCache.invalidate(e), console.log(`  ✓ Replaced URIs in ${y.relative(process.cwd(), e)}`);
+		} catch (t) {
+			if (this.isStructuredInventory()) throw t;
+			console.warn(`Warning: Failed to replace URIs in ${e}:`, t);
+		}
+	}
+	async replaceAllUris() {
+		let e = /* @__PURE__ */ new Map(), t = /* @__PURE__ */ new Set();
+		for (let n of this.assets.values()) e.set(n.originalUri, n.constantName), t.add(n.filePath);
+		for (let n of t) await this.replaceUrisInFile(n, e);
+	}
+	async cleanupUnusedConstants() {
+		if (!(this.document && f(this.document))) try {
+			let e = await this.readExistingAssetsFile();
+			if (!e.trim()) return;
+			let t = /* @__PURE__ */ new Map();
+			try {
+				let n = JSON.parse(e);
+				for (let [e, r] of Object.entries(n)) typeof r == "string" && t.set(e, r);
+			} catch (e) {
+				console.warn("Warning: Failed to parse assets.json:", e);
+				return;
+			}
+			if (t.size === 0) return;
+			let n = /* @__PURE__ */ new Set(), r = await u(this.options.srcDir, [".ts", ".tsx"]);
+			for (let e of r) if (!(e.endsWith("assets.json") || e.endsWith("assets.ts"))) try {
+				let r = await this.fileCache.read(e);
+				for (let e of t.keys()) r.includes(e) && n.add(e);
+			} catch (t) {
+				console.warn(`Warning: Failed to read ${e}:`, t);
+			}
+			let i = [];
+			for (let e of t.keys()) n.has(e) || i.push(e);
+			if (i.length > 0) {
+				console.log(`🧹 Removing ${i.length} unused constant(s):`), i.forEach((e) => {
+					console.log(`  - ${e}`);
+				});
+				let e = [];
+				for (let n of i) {
+					let r = t.get(n);
+					r && e.push(r);
+				}
+				for (let t of e) this.assets.delete(t);
+			} else console.log("✅ All constants are in use");
+		} catch (e) {
+			console.warn("Warning: Failed to cleanup unused constants:", e);
+		}
+	}
+	async upgradeJsonImportsToTs() {
+		let e = this.options.outputFile.replace(/\.json$/, ".ts"), t = p(e, this.options.srcDir), n = await u(this.options.srcDir, [".ts", ".tsx"]), r = 0;
+		for (let i of n) if (!(i.endsWith("assets.ts") || i.endsWith("assets.json"))) try {
+			let n = await this.fileCache.read(i), a = s(i, this.options.outputFile) + ".json", o = s(i, e), c = p(this.options.outputFile, this.options.srcDir) + ".json";
+			if (!n.includes(a) && !n.includes(o) && !n.includes(c)) continue;
+			let l = b(n, {
+				sourceType: "module",
+				plugins: [
+					"typescript",
+					"jsx",
+					"decorators-legacy"
+				]
+			}), u = !1;
+			if (w(l, { ImportDeclaration: (e) => {
+				let n = e.node.source.value;
+				(n === a || n === o || n === c) && (e.node.source.value = t, u = !0);
+			} }), u) {
+				let e = T(l, {
+					retainLines: !1,
+					comments: !0,
+					compact: !1
+				}, n);
+				await v.writeFile(i, e.code, "utf-8"), this.fileCache.invalidate(i), console.log(`  ✓ Upgraded import in ${y.relative(process.cwd(), i)} → ${t}`), r++;
+			}
+		} catch (e) {
+			if (this.isStructuredInventory()) throw e;
+			console.warn(`Warning: Failed to upgrade imports in ${i}:`, e);
+		}
+		r > 0 && console.log(`✅ Upgraded ${r} file(s) to use ${t}`);
+	}
+};
+function O(e = {}) {
+	return {
+		name: "vite-plugin-asset-constants",
+		apply: "build",
+		enforce: "pre",
+		async buildStart() {
+			if (!e.devMode) return;
+			let t = new D(e);
+			try {
+				await t.generateAssetsFile();
+				let e = t.getAssets();
+				e.length > 0 && (console.log(`📦 Found ${e.length} asset references:`), e.forEach((e) => {
+					console.log(`  ${e.constantName} = '${e.originalUri}' (${y.relative(process.cwd(), e.filePath)}:${e.line})`);
+				}), console.log("\n🔄 Replacing URIs with constants..."), await t.replaceAllUris(), console.log("✅ URI replacement completed!")), console.log("\n🧹 Checking for unused constants..."), await t.cleanupUnusedConstants(), await t.generateAssetsFile(), console.log("\n🔄 Upgrading assets.json imports to assets.ts..."), await t.upgradeJsonImportsToTs(), console.log("✅ Asset constants finalized!\n"), t.clearCache();
+			} catch (e) {
+				console.error("❌ Error in asset constants plugin:", e), (e instanceof E || t.isStructuredInventory()) && this.error(e instanceof Error ? e.message : String(e));
+			}
+		}
+	};
+}
+//#endregion
+export { O as assetConstantsPlugin, O as default };

package/dist/asset-constants/manifest.d.ts

@@ -43,6 +43,8 @@ export interface AssetManifest {
     artStyle: string;
     assets: Record<string, AssetEntry>;
     planningError?: AssetError;
+    legacyInventory?: string;
+    legacyPlaceholderKeys?: string[];
 }
 export type AssetDocument = AssetManifest | Record<string, string>;
 export declare function isManifest(doc: AssetDocument): doc is AssetManifest;

package/dist/{manifest-CI1ALLzl.js → generator-utils-CFYv7n_h.js}

@@ -180,7 +180,7 @@ function C(e, t, n = []) {
 	return Object.keys(r).some((e) => !t.includes(e)) && S("unknown field"), n.some((e) => !(e in r) || r[e] === null) && S("required field missing"), r;
 }
 function w(e, t, n = !1) {
-	(typeof e != "string" || Buffer.byteLength(e) > t || /[\x00-\x08\x0b\x0c\x0e-\x1f\x7f\uFEFF]/.test(e) || n && !e.trim()) && S("invalid bounded text");
+	(typeof e != "string" || Buffer.byteLength(e) > t || /[\x00-\x08\x0b\x0c\x0e-\x1f\x7f-\x9f\uFEFF]/.test(e) || n && !e.trim()) && S("invalid bounded text");
 }
 function T(e, t) {
 	(typeof e != "string" || !t.includes(e)) && S("unsupported field value");
@@ -247,16 +247,23 @@ function A(e) {
 	k(e);
 	let n = C(t, Object.keys(t));
 	if (!("schemaVersion" in n)) return Object.values(n).some((e) => typeof e != "string") && S("legacy inventory must contain URLs"), n;
-	C(n, [
+	if (C(n, [
 		"schemaVersion",
 		"artStyle",
 		"assets",
-		"planningError"
+		"planningError",
+		"legacyInventory",
+		"legacyPlaceholderKeys"
 	], [
 		"schemaVersion",
 		"artStyle",
 		"assets"
-	]), n.schemaVersion !== 1 && S("unsupported schema version"), w(n.artStyle, 2048), n.planningError !== void 0 && (D(n.planningError), n.planningError.stage !== "planning" && S("planningError stage must be planning"));
+	]), n.schemaVersion !== 1 && S("unsupported schema version"), w(n.artStyle, 2048), n.legacyInventory !== void 0 && w(n.legacyInventory, b), n.legacyPlaceholderKeys !== void 0) {
+		Array.isArray(n.legacyPlaceholderKeys) || S("legacy placeholder keys must be an array");
+		for (let e of n.legacyPlaceholderKeys) w(e, 256, !0);
+		new Set(n.legacyPlaceholderKeys).size !== n.legacyPlaceholderKeys.length && S("duplicate legacy placeholder key");
+	}
+	n.planningError !== void 0 && (D(n.planningError), n.planningError.stage !== "planning" && S("planningError stage must be planning"));
 	let r = C(n.assets, Object.keys(n.assets ?? {}));
 	for (let [e, t] of Object.entries(r)) {
 		w(e, 256, !0);
@@ -295,7 +302,7 @@ function A(e) {
 			let e = C(n.generation, ["action", "prompt"], ["action", "prompt"]);
 			T(e.action, ["generate", "reuse"]), w(e.prompt, 4096, !0);
 		} else n.generation !== void 0 && S("non-generated assets cannot contain generation");
-		if ((n.type === "synth" || n.type === "animation") && n.source !== "code" && S("type requires code source"), n.url !== void 0 && (w(n.url, 4096), (typeof n.url != "string" || !j(n.url)) && S("invalid resource reference")), (n.source === "user" || n.source === "existing") && (!n.url || n.status !== "ready") && S("existing resource requires ready URL"), n.source === "generated" && n.status === "ready" && !n.url && S("ready media requires URL"), n.status === "degraded" && (n.source !== "generated" || !n.url || !n.error) && S("degraded media requires temporary URL and reason"), n.params !== void 0) {
+		if ((n.type === "synth" || n.type === "animation") && n.source !== "code" && S("type requires code source"), n.url !== void 0 && (w(n.url, 4096), (typeof n.url != "string" || !M(n.url)) && S("invalid resource reference")), (n.source === "user" || n.source === "existing") && (!n.url || n.status !== "ready") && S("existing resource requires ready URL"), n.source === "generated" && n.status === "ready" && !n.url && S("ready media requires URL"), n.status === "degraded" && (n.source !== "generated" || !n.url || !n.error) && S("degraded media requires temporary URL and reason"), n.params !== void 0) {
 			let e = C(n.params, [
 				"width",
 				"height",
@@ -339,11 +346,38 @@ function A(e) {
 		}
 		n.source === "code" && (!n.implementation || n.url || n.output || n.error || !["planned", "ready"].includes(String(n.status))) && S("code requires implementation without media result");
 	}
+	for (let e of n.legacyPlaceholderKeys ?? []) {
+		let t = r[e];
+		(!t || t.url) && S("invalid legacy placeholder key");
+	}
 	return n;
 }
 function j(e) {
-	if (!e || e.trim() !== e || /[\r\n\t\\]/.test(e) || e.startsWith("//") || /%(?![0-9a-f]{2})/i.test(e.split("?")[0]) || /%(?![0-9a-f]{2})/i.test(e.split("#")[1] ?? "")) return !1;
-	if (!/^[a-z][a-z0-9+.-]*:/i.test(e)) return !0;
+	return Buffer.byteLength(e, "utf8") <= 4096 && [
+		"",
+		"-",
+		"--",
+		"tbd",
+		"todo",
+		"none",
+		"n/a",
+		"null",
+		"pending",
+		"not-generated",
+		"待生成",
+		"待制作"
+	].includes(e.trim().toLowerCase());
+}
+function M(e) {
+	if (!e || e.trim() !== e || /[\s\\]/u.test(e) || e.startsWith("//") || /%(?![0-9a-f]{2})/i.test(e.split("?")[0]) || /%(?![0-9a-f]{2})/i.test(e.split("#")[1] ?? "")) return !1;
+	if (!/^[a-z][a-z0-9+.-]*:/i.test(e)) {
+		if (e.split(/[?#]/, 1)[0].split("/", 1)[0].includes(":")) return !1;
+		let t = e.split(/[?#]/, 1)[0].replace(/%([0-9a-f]{2})/gi, (e, t) => String.fromCharCode(Number.parseInt(t, 16)));
+		if (!t || t.endsWith("/") || j(t)) return !1;
+		if (t.includes("/")) return !0;
+		let n = t.lastIndexOf(".");
+		return n > 0 && n < t.length - 1;
+	}
 	if (!/^https?:\/\//i.test(e)) return !1;
 	try {
 		let t = e.slice(e.indexOf("://") + 3).split(/[/?#]/, 1)[0];
@@ -354,12 +388,48 @@ function j(e) {
 		return !1;
 	}
 }
-function M(e) {
+function N(e) {
 	return O(e) ? Object.fromEntries(Object.entries(e.assets).filter(([, e]) => e.replaceable && typeof e.url == "string" && e.url.length > 0).map(([e, t]) => [e, t.url])) : { ...e };
 }
-function N(e) {
-	let t = e.split(/[?#]/)[0].toLowerCase();
-	return /\.(mp3|wav|ogg|m4a|aac|flac)$/.test(t) ? "sound" : /\.(mp4|webm|mov)$/.test(t) ? "video" : /\.(png|jpg|jpeg|gif|svg|webp|avif)$/.test(t) ? "image" : /\.(glb|gltf|obj)$/.test(t) ? "model" : "file";
+//#endregion
+//#region src/asset-constants/generator-utils.ts
+function P(e) {
+	if (!e || typeof e != "object" || Array.isArray(e)) return !1;
+	let t = e;
+	return typeof t.schemaVersion == "number" && !!t.assets && typeof t.assets == "object" && !Array.isArray(t.assets);
+}
+function F(e, t, n = {}) {
+	let r = { ...n }, i = new Set(Object.keys(r));
+	for (let [e, n] of t.entries()) i.has(n) || Object.values(r).includes(e) || (r[n] = e, i.add(n));
+	for (let t of e.values()) {
+		let e = Object.entries(r).find(([, e]) => e === t.originalUri);
+		if (e) {
+			t.constantName = e[0];
+			continue;
+		}
+		let n = t.constantName, a = n, o = 2;
+		for (; i.has(a);) a = `${n}_${o++}`;
+		i.add(a), t.constantName = a, r[a] = t.originalUri;
+	}
+	return JSON.stringify(r, null, 2) + "\n";
+}
+function I(e) {
+	let t = /* @__PURE__ */ new Map();
+	try {
+		if (!e.trim()) return t;
+		let n = JSON.parse(e);
+		if (P(n)) throw Error("assets: single-file asset plan is not supported");
+		if (!n || typeof n != "object" || Array.isArray(n)) throw Error("assets: URL dictionary object required");
+		for (let [e, r] of Object.entries(n)) typeof r == "string" && t.set(r, e);
+		t.size > 0 && console.log(`📋 Found ${t.size} existing constants in assets.json`);
+	} catch (e) {
+		throw e instanceof Error && e.message.startsWith("assets:") ? e : Error("assets: invalid JSON syntax");
+	}
+	return t;
+}
+function L(e, t, n, r) {
+	let i = Array.from(n.values()).filter((e) => t.has(e.originalUri)).length, a = e - i;
+	console.log(a > 0 ? `✅ Generated ${e} asset constants (${a} new, ${i} reused) in ${r}` : e > 0 ? `✅ Generated ${e} asset constants (all reused from existing) in ${r}` : "✅ No asset constants found");
 }
 //#endregion
-export { m as a, _ as c, l as d, u as f, A as i, f as l, N as n, y as o, c as p, O as r, v as s, M as t, d as u };
+export { N as a, m as c, _ as d, f, c as g, u as h, I as i, y as l, l as m, P as n, O as o, d as p, L as r, A as s, F as t, v as u };

package/dist/index/index.js

@@ -1,5 +1,5 @@
 import { extractAssetsFromContent as e, findProjectRoot as t, generateConstantName as n, isValidAsset as r, processAssetURL as i } from "../utils/index.js";
-import { t as a } from "../asset-constants-C59CLHCE.js";
-import { t as o } from "../aippy-preload-QZY6fyKx.js";
+import { assetConstantsPlugin as a } from "../asset-constants/index.js";
+import { t as o } from "../aippy-preload-DtngFmJ5.js";
 import { t as s } from "../aippy-tagger-By5socAS.js";
 export { o as aippyPreloadPlugin, s as aippyTaggerPlugin, a as assetConstantsPlugin, a as default, e as extractAssetsFromContent, t as findProjectRoot, n as generateConstantName, r as isValidAsset, i as processAssetURL };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aippy/vite-plugins",
-  "version": "0.4.0-dev.1",
+  "version": "0.4.0-dev.3",
   "description": "Vite plugins for Aippy projects - Asset management and component tagging",
   "private": false,
   "type": "module",

package/src/asset-constants/assets.schema.json

@@ -7,6 +7,13 @@
   "properties": {
     "schemaVersion": { "const": 1 },
     "artStyle": { "type": "string" },
+    "legacyInventory": { "type": "string" },
+    "legacyPlaceholderKeys": {
+      "description": "Server-owned historical flat keys without a resource URL, retained as empty wrapper values regardless of current asset type or source.",
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
     "planningError": {
       "allOf": [
         { "$ref": "#/$defs/error" },

package/dist/aippy-preload-QZY6fyKx.js

@@ -1,170 +0,0 @@
-import { extractAssetsFromContent as e } from "./utils/index.js";
-import { d as t, i as n, o as r, r as i, t as a } from "./manifest-CI1ALLzl.js";
-import { promises as o } from "fs";
-import s from "path";
-//#region src/aippy-preload/scanner-utils.ts
-async function c(t) {
-	let n = [], r = [s.join(process.cwd(), "index.html")];
-	for (let i of r) try {
-		let r = await o.readFile(i, "utf-8"), a = e(r, "html", t);
-		n.push(...a);
-	} catch {
-		console.warn("⚠️  No index.html found in project root");
-	}
-	return n;
-}
-async function l(a, c) {
-	let l = [], u = s.resolve(a, "config/assets.json"), d;
-	try {
-		let e = n(await o.readFile(u, "utf8"));
-		i(e) && (d = e);
-	} catch {}
-	let f = await t(a, [
-		".ts",
-		".tsx",
-		".js",
-		".jsx"
-	]);
-	for (let t of f) try {
-		if (d && s.resolve(t) === u.replace(/\.json$/, ".ts")) continue;
-		let n = await o.readFile(t, "utf-8"), i = e(n, "js", c);
-		d && i.some((e) => Object.hasOwn(d.assets, e)) && (i = e(r(n, t, a, u), "js", c)), l.push(...i);
-	} catch (e) {
-		console.warn(`⚠️  Failed to read JS file: ${t}`, e);
-	}
-	return l;
-}
-async function u(n, r) {
-	let i = [], a = await t(n, [
-		".css",
-		".scss",
-		".sass",
-		".less"
-	]);
-	for (let t of a) try {
-		let n = await o.readFile(t, "utf-8"), a = e(n, "css", r);
-		i.push(...a);
-	} catch (e) {
-		console.warn(`⚠️  Failed to read CSS file: ${t}`, e);
-	}
-	return i;
-}
-async function d(r, c) {
-	let l = [], u = await t(r, [".json"]);
-	for (let t of u) try {
-		let r = await o.readFile(t, "utf-8");
-		if (s.basename(t) === "assets.json") {
-			let e = JSON.parse(r);
-			if (e && Object.prototype.hasOwnProperty.call(e, "schemaVersion")) {
-				let e = n(r);
-				if (i(e)) {
-					l.push(...Object.values(a(e)));
-					continue;
-				}
-			}
-		}
-		let u = e(r, "js", c);
-		l.push(...u);
-	} catch (e) {
-		console.warn(`⚠️  Failed to read JSON file: ${t}`, e);
-	}
-	return l;
-}
-async function f(e, t, n) {
-	console.log("🔍 Scanning source files for static assets...");
-	let r = [];
-	if (n) {
-		console.log("🔍 Deep scanning source file contents...");
-		let [n, i, a, o] = await Promise.all([
-			c(t),
-			l(e, t),
-			u(e, t),
-			d(e, t)
-		]);
-		r.push(...n, ...i, ...a, ...o);
-	}
-	return [...new Set(r)];
-}
-//#endregion
-//#region src/aippy-preload/html-utils.ts
-var p = "<head>", m = 6;
-function h(e) {
-	return e.map((e) => `    <meta content="${e}" name="aippy:preload">`).join("\n");
-}
-function g(e, t) {
-	let n = e.indexOf(p);
-	if (n === -1) throw Error("Could not find <head> tag in HTML");
-	let r = n + m;
-	return e.slice(0, r) + "\n" + t + "\n" + e.slice(r);
-}
-function _(e) {
-	let t = e.length;
-	if (console.log(`📁 Found ${t} static ${t === 1 ? "asset" : "assets"} in source files`), t === 0) {
-		console.log("⚠️  No static assets found in source files.");
-		return;
-	}
-	console.log(`📋 ${t === 1 ? "Asset" : "Assets"} found:`), e.forEach((e) => console.log(`   - ${e}`));
-}
-function v(e) {
-	console.log(`✅ Injected ${e} preload meta ${e === 1 ? "tag" : "tags"} into index.html`);
-}
-//#endregion
-//#region src/aippy-preload/index.ts
-var y = 3, b = 1e3;
-function x(e) {
-	return new Promise((t) => setTimeout(t, e));
-}
-async function S(e, t = y, n = b) {
-	for (let r = 1; r <= t; r++) try {
-		return await o.readFile(e, "utf-8");
-	} catch (e) {
-		if (e.code === "ENOENT") {
-			if (r < t) {
-				console.log(`⏳ index.html not found, waiting ${n}ms before retry (attempt ${r}/${t})...`), await x(n);
-				continue;
-			}
-			return console.log(`⚠️ index.html not found after ${t} attempts, skipping preload injection.`), null;
-		}
-		return console.error("❌ Error reading index.html:", e), null;
-	}
-	return null;
-}
-function C(e = {}) {
-	let t = {
-		extensions: [
-			".png",
-			".jpg",
-			".jpeg",
-			".gif",
-			".svg",
-			".mp4",
-			".mp3",
-			".wav",
-			".ogg",
-			".webm"
-		],
-		srcDir: "src",
-		outDir: "dist",
-		deepScan: !0,
-		...e
-	};
-	return {
-		name: "vite-plugin-aippy-preload",
-		apply: "build",
-		enforce: "post",
-		async writeBundle() {
-			try {
-				let e = await f(t.srcDir, t.extensions, t.deepScan);
-				if (_(e), e.length === 0) return;
-				let n = s.join(t.outDir, "index.html"), r = await S(n);
-				if (r === null) return;
-				let i = g(r, h(e));
-				await o.writeFile(n, i, "utf-8"), v(e.length);
-			} catch (e) {
-				console.error("❌ Error in aippy preload plugin:", e);
-			}
-		}
-	};
-}
-//#endregion
-export { C as t };

package/dist/asset-constants-C59CLHCE.js

@@ -1,359 +0,0 @@
-import { extractAssetsFromContent as e, generateConstantName as t, processAssetURL as n } from "./utils/index.js";
-import { a as r, c as i, d as a, f as o, i as s, l as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "./manifest-CI1ALLzl.js";
-import { promises as g } from "fs";
-import _ from "path";
-import { parse as v } from "@babel/parser";
-import y from "@babel/traverse";
-import * as b from "@babel/types";
-import x from "@babel/generator";
-//#region src/asset-constants/generator-utils.ts
-function S(e, t, n) {
-	if (n && f(n)) {
-		let t = structuredClone(n), r = new Set(Object.keys(t.assets));
-		for (let n of e.values()) {
-			let e = Object.keys(t.assets).filter((e) => t.assets[e].url === n.originalUri);
-			if (e.length) {
-				n.constantName = e[0];
-				continue;
-			}
-			let i = n.constantName, a = i, o = 2;
-			for (; r.has(a);) a = `${i}_${o++}`;
-			r.add(a), n.constantName = a, t.assets[a] = {
-				type: l(n.originalUri),
-				source: "existing",
-				replaceable: !0,
-				description: `Existing asset ${a}`,
-				status: "ready",
-				url: n.originalUri
-			};
-		}
-		return JSON.stringify(t, null, 2) + "\n";
-	}
-	let r = {};
-	for (let [e, n] of t.entries()) r[n] = e;
-	return Array.from(e.values()).forEach((e) => {
-		r[e.constantName] = e.originalUri;
-	}), JSON.stringify(r, null, 2) + "\n";
-}
-function C(e) {
-	let t = /* @__PURE__ */ new Map();
-	try {
-		if (!e.trim()) return t;
-		let n = JSON.parse(e);
-		for (let [e, r] of Object.entries(n)) typeof r == "string" && t.set(r, e);
-		t.size > 0 && console.log(`📋 Found ${t.size} existing constants in assets.json`);
-	} catch (e) {
-		console.warn("Warning: Failed to parse existing assets.json:", e);
-	}
-	return t;
-}
-function w(e, t, n, r) {
-	let i = Array.from(n.values()).filter((e) => t.has(e.originalUri)).length, a = e - i;
-	console.log(a > 0 ? `✅ Generated ${e} asset constants (${a} new, ${i} reused) in ${r}` : e > 0 ? `✅ Generated ${e} asset constants (all reused from existing) in ${r}` : "✅ No asset constants found");
-}
-//#endregion
-//#region src/asset-constants/index.ts
-var T = typeof y == "function" ? y : y.default, E = typeof x == "function" ? x : x.default, D = class extends Error {}, O = class {
-	isStructuredInventory() {
-		return this.document !== void 0 && f(this.document);
-	}
-	constructor(e = {}) {
-		d(this, "options", void 0), d(this, "assets", /* @__PURE__ */ new Map()), d(this, "existingAssets", /* @__PURE__ */ new Map()), d(this, "fileCache", new c()), d(this, "document", void 0), d(this, "implementationPaths", /* @__PURE__ */ new Set()), this.options = {
-			extensions: [
-				".png",
-				".jpg",
-				".jpeg",
-				".gif",
-				".svg",
-				".mp4",
-				".mp3",
-				".wav",
-				".ogg",
-				".webm"
-			],
-			srcDir: "src",
-			outputFile: "src/config/assets.json",
-			devMode: !1,
-			...e
-		};
-	}
-	clearCache() {
-		this.fileCache.clear();
-	}
-	generateConstantName(e) {
-		let n = /* @__PURE__ */ new Set([
-			...Array.from(this.assets.values()).map((e) => e.constantName),
-			...Array.from(this.existingAssets.values()),
-			...this.document && f(this.document) ? Object.keys(this.document.assets) : []
-		]);
-		return t(e, n);
-	}
-	async scanTsFile(t) {
-		try {
-			let n = await this.fileCache.read(t), r = [], i = e(n, "js", this.options.extensions), a = this.document;
-			if (a && f(a) && i.some((e) => Object.hasOwn(a.assets, e))) {
-				let r = u(n, t, this.options.srcDir, this.options.outputFile);
-				i = e(r, "js", this.options.extensions);
-			}
-			let o = n.split("\n");
-			return i.forEach((e) => {
-				if (this.isImplementationReference(t, e)) return;
-				let n = this.generateConstantName(e), i = o.findIndex((t) => t.includes(e)) + 1;
-				r.push({
-					originalUri: e,
-					constantName: n,
-					filePath: t,
-					line: i,
-					column: 1
-				});
-			}), r;
-		} catch (e) {
-			return console.warn(`Warning: Failed to scan ${t}:`, e), [];
-		}
-	}
-	async scanAllTsFiles() {
-		let e = this.options.srcDir;
-		try {
-			let t = await a(e, [".ts", ".tsx"]);
-			for (let e of t) e.endsWith("assets.json") || e.endsWith("assets.ts") || (await this.scanTsFile(e)).forEach((e) => {
-				this.existingAssets.has(e.originalUri) && (e.constantName = this.existingAssets.get(e.originalUri));
-				let t = e.originalUri;
-				this.assets.has(t) || this.assets.set(t, e);
-			});
-		} catch (e) {
-			console.error("Error scanning TypeScript files:", e);
-		}
-	}
-	async readExistingAssetsFile() {
-		try {
-			return await g.readFile(this.options.outputFile, "utf-8");
-		} catch (e) {
-			if (e.code === "ENOENT") return "";
-			throw new D("Unable to read assets.json: " + String(e));
-		}
-	}
-	async parseExistingAssets() {
-		let e = await this.readExistingAssetsFile();
-		if (e.trim()) {
-			let t;
-			try {
-				t = JSON.parse(e);
-			} catch {
-				if (/"schemaVersion(?:["\s:]|$)/i.test(e.replace(/\\u([0-9a-f]{4})/gi, (e, t) => String.fromCharCode(parseInt(t, 16))))) throw new D("assets: invalid JSON syntax");
-			}
-			if (t && Object.prototype.hasOwnProperty.call(t, "schemaVersion")) {
-				try {
-					this.document = s(e);
-				} catch (e) {
-					throw new D(e instanceof Error ? e.message : "Invalid asset manifest");
-				}
-				this.existingAssets = /* @__PURE__ */ new Map();
-				for (let [e, t] of Object.entries(m(this.document))) this.existingAssets.has(t) || this.existingAssets.set(t, e);
-				if (f(this.document)) {
-					let e = _.dirname(_.resolve(this.options.srcDir));
-					this.implementationPaths = new Set(Object.values(this.document.assets).filter((e) => (e.source === "code" || e.source === "generated") && e.implementation?.path).map((t) => _.resolve(e, t.implementation.path)));
-				}
-				return;
-			}
-		}
-		this.existingAssets = C(e);
-	}
-	isImplementationReference(e, t) {
-		if (!this.implementationPaths.size || /^[a-z][a-z0-9+.-]*:/i.test(t) || t.startsWith("//")) return !1;
-		let n = t.split(/[?#]/)[0], r = n.startsWith("@/") ? _.resolve(this.options.srcDir, n.slice(2)) : _.resolve(_.dirname(e), n);
-		return this.implementationPaths.has(r);
-	}
-	async generateAssetsFile() {
-		await this.parseExistingAssets(), await this.scanAllTsFiles();
-		let e = S(this.assets, this.existingAssets, this.document), t = _.dirname(this.options.outputFile);
-		if (await g.mkdir(t, { recursive: !0 }), this.document && f(this.document)) try {
-			this.document = s(e);
-		} catch (e) {
-			throw new D(e instanceof Error ? e.message : "Invalid supplementary asset");
-		}
-		await g.writeFile(this.options.outputFile, e, "utf-8"), await this.generateAssetsWrapper(), w(this.assets.size, this.existingAssets, this.assets, this.options.outputFile);
-	}
-	async generateAssetsWrapper() {
-		let e = this.options.outputFile.replace(/\.json$/, ".ts"), t = _.basename(this.options.outputFile), n = `// 🍎 Auto-generated wrapper for assets.json
-// This file handles iOS image replacement via asset-interceptor.js
-import assetsData from "./${t}";
-
-// Batch process all asset URLs for potential replacements
-// sessionStorage may contain __aippy_asset_overrides__ with multiple image mappings
-(window as any).getReplacedAssets?.(assetsData);
-
-export default assetsData;
-`;
-		if (this.document && f(this.document)) {
-			let e = Object.keys(m(this.document));
-			n = `// Auto-generated asset URL map. Planning metadata stays in assets.json.
-import manifest from "./${t}";
-const keys = ${JSON.stringify(e)} as const;
-const assetsData = ${e.length ? "Object.fromEntries(keys.map(name => [name, manifest.assets[name].url]))" : "{}"} as { [K in typeof keys[number]]: string };
-(window as any).getReplacedAssets?.(assetsData);
-export default assetsData;
-`;
-		}
-		await g.writeFile(e, n, "utf-8"), console.log(`  ✓ Generated assets wrapper: ${_.relative(process.cwd(), e)}`);
-	}
-	getAssets() {
-		return Array.from(this.assets.values());
-	}
-	async replaceUrisInFile(e, t) {
-		try {
-			let a = await this.fileCache.read(e), o = v(a, {
-				sourceType: "module",
-				plugins: [
-					"typescript",
-					"jsx",
-					"decorators-legacy"
-				]
-			}), s = !1, c = this.options.outputFile.replace(/\.json$/, ".ts"), l = h(c, this.options.srcDir), u = p(e, this.options.srcDir, this.options.outputFile), d = i(o, u), f = "assetsData", m = !1, y, x = /* @__PURE__ */ new Set();
-			T(o, {
-				Identifier: (e) => {
-					x.add(e.node.name);
-				},
-				ImportDeclaration: (e) => {
-					if (!(!u.has(e.node.source.value) || e.node.importKind === "type")) for (let t of e.node.specifiers) {
-						if (t.importKind === "type") continue;
-						let n = e.scope.getBinding(t.local.name);
-						r(t) && (f = t.local.name, m = !0, y = n);
-					}
-				}
-			});
-			let S = !1;
-			if (m && T(o, { StringLiteral: (r) => {
-				!b.isImportDeclaration(r.parent) && !d(r) && !this.isImplementationReference(e, r.node.value) && t.has(n(r.node.value)) && r.scope.getBinding(f) !== y && (S = !0);
-			} }), !m && x.has(f) || S) {
-				let e = "aippyAssetsData";
-				for (let t = 2; x.has(e); t++) e = `aippyAssetsData${t}`;
-				S && y.scope.rename(f, e), f = e;
-			}
-			if (T(o, { StringLiteral: (r) => {
-				let i = r.node.value;
-				if (this.isImplementationReference(e, i) || d(r) || b.isImportDeclaration(r.parent) || b.isExportNamedDeclaration(r.parent) || b.isExportAllDeclaration(r.parent) || r.findParent((e) => b.isTSType(e.node) || b.isTSInterfaceBody(e.node))) return;
-				let a = n(i);
-				if (t.has(a)) {
-					let e = t.get(a), n = b.memberExpression(b.identifier(f), /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e) ? b.identifier(e) : b.stringLiteral(e), !/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e));
-					if ((b.isObjectProperty(r.parent) || b.isObjectMethod(r.parent) || b.isClassProperty(r.parent) || b.isClassMethod(r.parent)) && r.key === "key" && (r.parent.computed = !0), r.parent && b.isJSXAttribute(r.parent)) r.replaceWith(b.jsxExpressionContainer(n));
-					else {
-						try {
-							b.validate(r.parent, r.key, n);
-						} catch {
-							return;
-						}
-						r.replaceWith(n);
-					}
-					r.skip(), s = !0;
-				}
-			} }), !s) return;
-			if (!m) {
-				let e = b.importDeclaration([b.importDefaultSpecifier(b.identifier(f))], b.stringLiteral(l));
-				o.program.body.unshift(e);
-			}
-			let C = E(o, {
-				retainLines: !1,
-				comments: !0,
-				compact: !1
-			}, a);
-			await g.writeFile(e, C.code, "utf-8"), this.fileCache.invalidate(e), console.log(`  ✓ Replaced URIs in ${_.relative(process.cwd(), e)}`);
-		} catch (t) {
-			if (this.isStructuredInventory()) throw t;
-			console.warn(`Warning: Failed to replace URIs in ${e}:`, t);
-		}
-	}
-	async replaceAllUris() {
-		let e = /* @__PURE__ */ new Map(), t = /* @__PURE__ */ new Set();
-		for (let n of this.assets.values()) e.set(n.originalUri, n.constantName), t.add(n.filePath);
-		for (let n of t) await this.replaceUrisInFile(n, e);
-	}
-	async cleanupUnusedConstants() {
-		if (!(this.document && f(this.document))) try {
-			let e = await this.readExistingAssetsFile();
-			if (!e.trim()) return;
-			let t = /* @__PURE__ */ new Map();
-			try {
-				let n = JSON.parse(e);
-				for (let [e, r] of Object.entries(n)) typeof r == "string" && t.set(e, r);
-			} catch (e) {
-				console.warn("Warning: Failed to parse assets.json:", e);
-				return;
-			}
-			if (t.size === 0) return;
-			let n = /* @__PURE__ */ new Set(), r = await a(this.options.srcDir, [".ts", ".tsx"]);
-			for (let e of r) if (!(e.endsWith("assets.json") || e.endsWith("assets.ts"))) try {
-				let r = await this.fileCache.read(e);
-				for (let e of t.keys()) r.includes(e) && n.add(e);
-			} catch (t) {
-				console.warn(`Warning: Failed to read ${e}:`, t);
-			}
-			let i = [];
-			for (let e of t.keys()) n.has(e) || i.push(e);
-			if (i.length > 0) {
-				console.log(`🧹 Removing ${i.length} unused constant(s):`), i.forEach((e) => {
-					console.log(`  - ${e}`);
-				});
-				let e = [];
-				for (let n of i) {
-					let r = t.get(n);
-					r && e.push(r);
-				}
-				for (let t of e) this.assets.delete(t);
-			} else console.log("✅ All constants are in use");
-		} catch (e) {
-			console.warn("Warning: Failed to cleanup unused constants:", e);
-		}
-	}
-	async upgradeJsonImportsToTs() {
-		let e = this.options.outputFile.replace(/\.json$/, ".ts"), t = h(e, this.options.srcDir), n = await a(this.options.srcDir, [".ts", ".tsx"]), r = 0;
-		for (let i of n) if (!(i.endsWith("assets.ts") || i.endsWith("assets.json"))) try {
-			let n = await this.fileCache.read(i), a = o(i, this.options.outputFile) + ".json", s = o(i, e), c = h(this.options.outputFile, this.options.srcDir) + ".json";
-			if (!n.includes(a) && !n.includes(s) && !n.includes(c)) continue;
-			let l = v(n, {
-				sourceType: "module",
-				plugins: [
-					"typescript",
-					"jsx",
-					"decorators-legacy"
-				]
-			}), u = !1;
-			if (T(l, { ImportDeclaration: (e) => {
-				let n = e.node.source.value;
-				(n === a || n === s || n === c) && (e.node.source.value = t, u = !0);
-			} }), u) {
-				let e = E(l, {
-					retainLines: !1,
-					comments: !0,
-					compact: !1
-				}, n);
-				await g.writeFile(i, e.code, "utf-8"), this.fileCache.invalidate(i), console.log(`  ✓ Upgraded import in ${_.relative(process.cwd(), i)} → ${t}`), r++;
-			}
-		} catch (e) {
-			if (this.isStructuredInventory()) throw e;
-			console.warn(`Warning: Failed to upgrade imports in ${i}:`, e);
-		}
-		r > 0 && console.log(`✅ Upgraded ${r} file(s) to use ${t}`);
-	}
-};
-function k(e = {}) {
-	return {
-		name: "vite-plugin-asset-constants",
-		apply: "build",
-		enforce: "pre",
-		async buildStart() {
-			if (!e.devMode) return;
-			let t = new O(e);
-			try {
-				await t.generateAssetsFile();
-				let e = t.getAssets();
-				e.length > 0 && (console.log(`📦 Found ${e.length} asset references:`), e.forEach((e) => {
-					console.log(`  ${e.constantName} = '${e.originalUri}' (${_.relative(process.cwd(), e.filePath)}:${e.line})`);
-				}), console.log("\n🔄 Replacing URIs with constants..."), await t.replaceAllUris(), console.log("✅ URI replacement completed!")), console.log("\n🧹 Checking for unused constants..."), await t.cleanupUnusedConstants(), await t.generateAssetsFile(), console.log("\n🔄 Upgrading assets.json imports to assets.ts..."), await t.upgradeJsonImportsToTs(), console.log("✅ Asset constants finalized!\n"), t.clearCache();
-			} catch (e) {
-				console.error("❌ Error in asset constants plugin:", e), (e instanceof D || t.isStructuredInventory()) && this.error(e instanceof Error ? e.message : String(e));
-			}
-		}
-	};
-}
-//#endregion
-export { k as t };