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

package/README.md

@@ -107,3 +107,5 @@ UNLICENSED - Aippy Team
 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-QZY6fyKx.js";
+import { t as e } from "../aippy-preload-Dhhw3O6d.js";
 export { e as aippyPreloadPlugin, e as default };

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

@@ -1,5 +1,5 @@
 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 { 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

package/dist/asset-constants/index.js

@@ -1,2 +1,2 @@
-import { t as e } from "../asset-constants-C59CLHCE.js";
+import { t as e } from "../asset-constants-BUK7zWRd.js";
 export { e as assetConstantsPlugin, e 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/{asset-constants-C59CLHCE.js → asset-constants-BUK7zWRd.js}

@@ -1,5 +1,5 @@
 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 { 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-DQGCd9CQ.js";
 import { promises as g } from "fs";
 import _ from "path";
 import { parse as v } from "@babel/parser";
@@ -185,11 +185,12 @@ import assetsData from "./${t}";
 export default assetsData;
 `;
 		if (this.document && f(this.document)) {
-			let e = Object.keys(m(this.document));
+			let e = [.../* @__PURE__ */ new Set([...Object.keys(m(this.document)), ...this.document.legacyPlaceholderKeys ?? []])];
 			n = `// Auto-generated asset URL map. Planning metadata stays in assets.json.
 import manifest from "./${t}";
+const entries = manifest.assets as Record<string, { url?: string; [field: string]: unknown }>;
 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 };
+const assetsData = ${e.length ? "Object.fromEntries(keys.map(name => [name, entries[name]?.url ?? \"\"]))" : "{}"} as { [K in typeof keys[number]]: string };
 (window as any).getReplacedAssets?.(assetsData);
 export default assetsData;
 `;

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 { t as a } from "../asset-constants-BUK7zWRd.js";
+import { t as o } from "../aippy-preload-Dhhw3O6d.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/dist/{manifest-CI1ALLzl.js → manifest-DQGCd9CQ.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.source !== "code" || t.type !== "file" || t.url) && S("invalid legacy placeholder key");
+	}
 	return n;
 }
 function j(e) {
+	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 || /[\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;
+	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,12 @@ 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) {
+function P(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
-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 { m as a, _ as c, l as d, u as f, A as i, f as l, P as n, y as o, c as p, O as r, v as s, N as t, d as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aippy/vite-plugins",
-  "version": "0.4.0-dev.1",
+  "version": "0.4.0-dev.2",
   "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,12 @@
   "properties": {
     "schemaVersion": { "const": 1 },
     "artStyle": { "type": "string" },
+    "legacyInventory": { "type": "string" },
+    "legacyPlaceholderKeys": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
     "planningError": {
       "allOf": [
         { "$ref": "#/$defs/error" },