@aippy/vite-plugins 0.3.0 → 0.4.0-dev.2

package/README.md

@@ -15,7 +15,7 @@ pnpm add -D @aippy/vite-plugins
 Generates constant references for static assets and replaces hardcoded paths.
 
 ```typescript
-import { assetConstantsPlugin } from '@aippy/vite-plugins/asset-constants'
+import { assetConstantsPlugin } from '@aippy/vite-plugins/asset-constants';
 
 export default defineConfig({
   plugins: [
@@ -23,10 +23,10 @@ export default defineConfig({
       extensions: ['.png', '.jpg', '.jpeg', '.gif', '.svg', '.mp4', '.mp3'],
       srcDir: 'src',
       outputFile: 'src/config/assets.json',
-      devMode: true
-    })
-  ]
-})
+      devMode: true,
+    }),
+  ],
+});
 ```
 
 ### 2. Aippy Preload Plugin
@@ -34,17 +34,17 @@ export default defineConfig({
 Scans build output and generates preload meta tags for assets.
 
 ```typescript
-import { aippyPreloadPlugin } from '@aippy/vite-plugins/aippy-preload'
+import { aippyPreloadPlugin } from '@aippy/vite-plugins/aippy-preload';
 
 export default defineConfig({
   plugins: [
     aippyPreloadPlugin({
       extensions: ['.js', '.css', '.png', '.jpg', '.svg'],
       outDir: 'dist',
-      includeSubdirs: true
-    })
-  ]
-})
+      includeSubdirs: true,
+    }),
+  ],
+});
 ```
 
 ### 3. Aippy Tagger Plugin
@@ -52,19 +52,21 @@ export default defineConfig({
 Tags React components with metadata for development tools and inspector.
 
 ```typescript
-import { aippyTaggerPlugin } from '@aippy/vite-plugins/aippy-tagger'
+import { aippyTaggerPlugin } from '@aippy/vite-plugins/aippy-tagger';
 
 export default defineConfig({
-  plugins: [
-    aippyTaggerPlugin()
-  ]
-})
+  plugins: [aippyTaggerPlugin()],
+});
 ```
 
 ### All-in-One Import
 
 ```typescript
-import { assetConstantsPlugin, aippyPreloadPlugin, aippyTaggerPlugin } from '@aippy/vite-plugins'
+import {
+  assetConstantsPlugin,
+  aippyPreloadPlugin,
+  aippyTaggerPlugin,
+} from '@aippy/vite-plugins';
 ```
 
 ### Utility Functions
@@ -72,31 +74,38 @@ import { assetConstantsPlugin, aippyPreloadPlugin, aippyTaggerPlugin } from '@ai
 The package also exports utility functions that can be used independently:
 
 ```typescript
-import { 
-  processAssetURL, 
-  isValidAsset, 
-  generateConstantName, 
+import {
+  processAssetURL,
+  isValidAsset,
+  generateConstantName,
   extractAssetsFromContent,
-  findProjectRoot 
-} from '@aippy/vite-plugins/utils'
+  findProjectRoot,
+} from '@aippy/vite-plugins/utils';
 
 // Process asset URLs
-const processedUrl = processAssetURL('./image.png') // '/image.png'
+const processedUrl = processAssetURL('./image.png'); // '/image.png'
 
 // Validate asset paths
-const isValid = isValidAsset('./image.png') // true
+const isValid = isValidAsset('./image.png'); // true
 
 // Generate constant names
-const constantName = generateConstantName('/image.png') // 'IMAGE_ABCD'
+const constantName = generateConstantName('/image.png'); // 'IMAGE_ABCD'
 
 // Extract assets from content
-const assets = extractAssetsFromContent(htmlContent, 'html', ['.png', '.jpg'])
+const assets = extractAssetsFromContent(htmlContent, 'html', ['.png', '.jpg']);
 
 // Find project root
-const projectRoot = findProjectRoot() // '/path/to/project'
+const projectRoot = findProjectRoot(); // '/path/to/project'
 ```
 
 ## License
 
 UNLICENSED - Aippy Team
 
+## Asset manifest v1
+
+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.
+
+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.
+
+Pending the next dev release, wrappers retain only historical flat placeholder keys listed in `legacyPlaceholderKeys` as empty strings; other unavailable media remain absent. Concrete code assets continue to use their source references. These changes are not included in the published 0.4.0-dev.1 package.

package/dist/aippy-preload/index.js

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

package/dist/{aippy-preload-8BoWu90-.js → aippy-preload-Dhhw3O6d.js}

@@ -1,86 +1,103 @@
 import { extractAssetsFromContent as e } from "./utils/index.js";
-import { r as t } from "./file-scanner-DT-LbrCa.js";
-import { promises as n } from "fs";
-import r from "path";
+import { d as t, i as n, o as r, r as i, t as a } from "./manifest-DQGCd9CQ.js";
+import { promises as o } from "fs";
+import s from "path";
 //#region src/aippy-preload/scanner-utils.ts
-async function i(t) {
-	let i = [], a = [r.join(process.cwd(), "index.html")];
-	for (let r of a) try {
-		let a = await n.readFile(r, "utf-8"), o = e(a, "html", t);
-		i.push(...o);
+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 i;
+	return n;
 }
-async function a(r, i) {
-	let a = [], o = await t(r, [
+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 o) try {
-		let r = await n.readFile(t, "utf-8"), o = e(r, "js", i);
-		a.push(...o);
+	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 a;
+	return l;
 }
-async function o(r, i) {
-	let a = [], o = await t(r, [
+async function u(n, r) {
+	let i = [], a = await t(n, [
 		".css",
 		".scss",
 		".sass",
 		".less"
 	]);
-	for (let t of o) try {
-		let r = await n.readFile(t, "utf-8"), o = e(r, "css", i);
-		a.push(...o);
+	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 a;
+	return i;
 }
-async function s(r, i) {
-	let a = [], o = await t(r, [".json"]);
-	for (let t of o) try {
-		let r = await n.readFile(t, "utf-8"), o = e(r, "js", i);
-		a.push(...o);
+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 a;
+	return l;
 }
-async function c(e, t, n) {
+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, c, l, u] = await Promise.all([
-			i(t),
-			a(e, t),
-			o(e, t),
-			s(e, t)
+		let [n, i, a, o] = await Promise.all([
+			c(t),
+			l(e, t),
+			u(e, t),
+			d(e, t)
 		]);
-		r.push(...n, ...c, ...l, ...u);
+		r.push(...n, ...i, ...a, ...o);
 	}
 	return [...new Set(r)];
 }
 //#endregion
 //#region src/aippy-preload/html-utils.ts
-var l = "<head>", u = 6;
-function d(e) {
+var p = "<head>", m = 6;
+function h(e) {
 	return e.map((e) => `    <meta content="${e}" name="aippy:preload">`).join("\n");
 }
-function f(e, t) {
-	let n = e.indexOf(l);
+function g(e, t) {
+	let n = e.indexOf(p);
 	if (n === -1) throw Error("Could not find <head> tag in HTML");
-	let r = n + u;
+	let r = n + m;
 	return e.slice(0, r) + "\n" + t + "\n" + e.slice(r);
 }
-function p(e) {
+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.");
@@ -88,22 +105,22 @@ function p(e) {
 	}
 	console.log(`📋 ${t === 1 ? "Asset" : "Assets"} found:`), e.forEach((e) => console.log(`   - ${e}`));
 }
-function m(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 h = 3, g = 1e3;
-function _(e) {
+var y = 3, b = 1e3;
+function x(e) {
 	return new Promise((t) => setTimeout(t, e));
 }
-async function v(e, t = h, r = g) {
-	for (let i = 1; i <= t; i++) try {
-		return await n.readFile(e, "utf-8");
+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 (i < t) {
-				console.log(`⏳ index.html not found, waiting ${r}ms before retry (attempt ${i}/${t})...`), await _(r);
+			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;
@@ -112,7 +129,7 @@ async function v(e, t = h, r = g) {
 	}
 	return null;
 }
-function y(e = {}) {
+function C(e = {}) {
 	let t = {
 		extensions: [
 			".png",
@@ -137,12 +154,12 @@ function y(e = {}) {
 		enforce: "post",
 		async writeBundle() {
 			try {
-				let e = await c(t.srcDir, t.extensions, t.deepScan);
-				if (p(e), e.length === 0) return;
-				let i = r.join(t.outDir, "index.html"), a = await v(i);
-				if (a === null) return;
-				let o = f(a, d(e));
-				await n.writeFile(i, o, "utf-8"), m(e.length);
+				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);
 			}
@@ -150,4 +167,4 @@ function y(e = {}) {
 	};
 }
 //#endregion
-export { y as t };
+export { C as t };

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

@@ -1,11 +1,12 @@
 import { AssetInfo } from './types';
+import { AssetDocument } from './manifest';
 /**
  * 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
  */
-export declare function generateAssetsFileContent(assets: Map<string, AssetInfo>, existingAssets: Map<string, string>): string;
+export declare function generateAssetsFileContent(assets: Map<string, AssetInfo>, existingAssets: Map<string, string>, document?: AssetDocument): string;
 /**
  * Parse existing assets.json file
  * @param content - File content

package/dist/asset-constants/index.js

@@ -1,2 +1,2 @@
-import { t as e } from "../asset-constants-BvKclVVI.js";
+import { t as e } from "../asset-constants-BUK7zWRd.js";
 export { e as assetConstantsPlugin, e as default };

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

@@ -0,0 +1,53 @@
+export interface AssetError {
+    stage: string;
+    code: string;
+    message: string;
+    retryable: boolean;
+}
+export interface AssetParams {
+    width?: number;
+    height?: number;
+    durationSeconds?: number;
+    loop?: boolean;
+}
+export interface AssetImplementation {
+    method: 'svg' | 'canvas' | 'css' | 'synth' | 'animation' | 'three';
+    description: string;
+    status: 'planned' | 'ready';
+    path?: string;
+    symbol?: string;
+}
+export interface AssetEntry {
+    type: string;
+    source: 'generated' | 'user' | 'existing' | 'code';
+    replaceable: boolean;
+    description: string;
+    params?: AssetParams;
+    generation?: {
+        action: 'generate' | 'reuse';
+        prompt: string;
+    };
+    status: 'planned' | 'ready' | 'failed' | 'skipped' | 'degraded';
+    url?: string;
+    output?: {
+        format?: string;
+        width?: number;
+        height?: number;
+        durationSeconds?: number;
+    };
+    error?: AssetError;
+    implementation?: AssetImplementation;
+}
+export interface AssetManifest {
+    schemaVersion: 1;
+    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;
+export declare function parseAssetDocument(content: string): AssetDocument;
+export declare function assetUrlMap(document: AssetDocument): Record<string, string>;
+export declare function inferExistingType(uri: string): string;

package/dist/asset-constants/wrapper-keys.d.ts

@@ -0,0 +1,5 @@
+import * as t from '@babel/types';
+export declare function isDefaultImport(item: t.ImportDeclaration['specifiers'][number]): boolean;
+export declare function wrapperKeyGuard(ast: t.File, importSources: Set<string>): (p: any) => boolean;
+export declare function wrapperImportSources(filePath: string, srcDir: string, outputFile: string): Set<string>;
+export declare function withoutWrapperKeys(content: string, filePath: string, srcDir: string, outputFile: string): string;