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

package/README.md

@@ -104,6 +104,10 @@ UNLICENSED - Aippy Team
 
 ## Asset files
 
-`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.
+`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. The plugin does not validate the plan; aippy-chat does. A missing or unreadable plan does not stop the build. Invalid dictionary JSON, a single-file v1 plan stored in the dictionary, or a failed dictionary/wrapper write stops the build without overwriting the file. A source file the plugin cannot parse or rewrite only logs a warning.
 
-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.
+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.
+
+Source written as `aippy-asset:` + `encodeURIComponent(key)` + `:` + url rewrites to that dictionary key. The url may be any reference aippy-chat accepts (`ValidReference`): http(s), root-relative, or relative. A token the rewrite cannot reach (template literal, CSS, HTML, unknown key) is reduced to its plain url, on disk in `devMode` and in every build's `transform`, so a token never reaches the browser.
+
+Version 0.4.0-dev.3 is published. The `dev` dist-tag points at it. `latest` remains `0.3.0`.

package/dist/aippy-preload/index.js

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

package/dist/{aippy-preload-DtngFmJ5.js → aippy-preload-BjhVTEKH.js}

@@ -1,98 +1,87 @@
 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";
+import { l as n, m as r, s as i } from "./generator-utils-VznlFF00.js";
+import { promises as a } from "fs";
+import o 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);
+async function s(t) {
+	let n = [], r = [o.join(process.cwd(), "index.html")];
+	for (let o of r) try {
+		let r = i(await a.readFile(o, "utf-8")), s = e(r, "html", t);
+		n.push(...s);
 	} 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();
+async function c(t, s) {
+	let c = [], l = o.resolve(t, "config/assets.json"), u = /* @__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)));
+		let e = JSON.parse(await a.readFile(l, "utf8"));
+		e && typeof e == "object" && !Array.isArray(e) && (u = new Set(Object.keys(e)));
 	} catch {}
-	let m = await i(t, [
+	let d = await r(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);
+	for (let r of d) try {
+		let o = i(await a.readFile(r, "utf-8")), d = e(o, "js", s);
+		d.some((e) => u.has(e)) && (d = e(n(o, r, t, l), "js", s)), c.push(...d);
 	} catch (e) {
-		console.warn(`⚠️  Failed to read JS file: ${i}`, e);
+		console.warn(`⚠️  Failed to read JS file: ${r}`, e);
 	}
-	return u;
+	return c;
 }
-async function f(t, n) {
-	let r = [], a = await i(t, [
+async function l(t, n) {
+	let o = [], s = await r(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);
+	for (let t of s) try {
+		let r = i(await a.readFile(t, "utf-8")), s = e(r, "css", n);
+		o.push(...s);
 	} catch (e) {
 		console.warn(`⚠️  Failed to read CSS file: ${t}`, e);
 	}
-	return r;
+	return o;
 }
-function p(e, n) {
+function u(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;
-				}
-			}
+async function d(t, n) {
+	let s = [], c = await r(t, [".json"]);
+	for (let r of c) try {
+		let c = i(await a.readFile(r, "utf-8"));
+		if (o.basename(r) === "assets-plan.json") continue;
+		if (o.resolve(r) === o.resolve(t, "config/assets.json")) {
+			let e = JSON.parse(c);
 			if (e && typeof e == "object" && !Array.isArray(e)) {
-				for (let t of Object.values(e)) typeof t == "string" && p(t, r) && u.push(t);
+				for (let t of Object.values(e)) typeof t == "string" && u(t, n) && s.push(t);
 				continue;
 			}
 		}
-		let f = e(d, "js", r);
-		u.push(...f);
+		let l = e(c, "js", n);
+		s.push(...l);
 	} catch (e) {
-		console.warn(`⚠️  Failed to read JSON file: ${i}`, e);
+		console.warn(`⚠️  Failed to read JSON file: ${r}`, e);
 	}
-	return u;
+	return s;
 }
-async function h(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, i, a, o] = await Promise.all([
-			u(t),
-			d(e, t),
-			f(e, t),
-			m(e, t)
+			s(t),
+			c(e, t),
+			l(e, t),
+			d(e, t)
 		]);
 		r.push(...n, ...i, ...a, ...o);
 	}
@@ -100,20 +89,20 @@ async function h(e, t, n) {
 }
 //#endregion
 //#region src/aippy-preload/html-utils.ts
-var g = "<head>", _ = 6;
-function v(e) {
+var p = "<head>", m = 6;
+function h(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 g(e) {
+	return e.map((e) => `    <meta content="${h(e)}" name="aippy:preload">`).join("\n");
 }
-function b(e, t) {
-	let n = e.indexOf(g);
+function _(e, t) {
+	let n = e.indexOf(p);
 	if (n === -1) throw Error("Could not find <head> tag in HTML");
-	let r = n + _;
+	let r = n + m;
 	return e.slice(0, r) + "\n" + t + "\n" + e.slice(r);
 }
-function x(e) {
+function v(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.");
@@ -121,22 +110,22 @@ function x(e) {
 	}
 	console.log(`📋 ${t === 1 ? "Asset" : "Assets"} found:`), e.forEach((e) => console.log(`   - ${e}`));
 }
-function S(e) {
+function y(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) {
+var b = 3, x = 1e3;
+function S(e) {
 	return new Promise((t) => setTimeout(t, e));
 }
-async function E(e, t = C, n = w) {
+async function C(e, t = b, n = x) {
 	for (let r = 1; r <= t; r++) try {
-		return await c.readFile(e, "utf-8");
+		return await a.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);
+				console.log(`⏳ index.html not found, waiting ${n}ms before retry (attempt ${r}/${t})...`), await S(n);
 				continue;
 			}
 			return console.log(`⚠️ index.html not found after ${t} attempts, skipping preload injection.`), null;
@@ -145,7 +134,7 @@ async function E(e, t = C, n = w) {
 	}
 	return null;
 }
-function D(e = {}) {
+function w(e = {}) {
 	let t = {
 		extensions: [
 			".png",
@@ -170,12 +159,12 @@ function D(e = {}) {
 		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);
+				let e = await f(t.srcDir, t.extensions, t.deepScan);
+				if (v(e), e.length === 0) return;
+				let n = o.join(t.outDir, "index.html"), r = await C(n);
 				if (r === null) return;
-				let i = b(r, y(e));
-				await c.writeFile(n, i, "utf-8"), S(e.length);
+				let i = _(r, g(e));
+				await a.writeFile(n, i, "utf-8"), y(e.length);
 			} catch (e) {
 				console.error("❌ Error in aippy preload plugin:", e);
 			}
@@ -183,4 +172,4 @@ function D(e = {}) {
 	};
 }
 //#endregion
-export { D as t };
+export { w as t };

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

@@ -1,6 +1,33 @@
 import { AssetInfo } from './types';
 /** 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;
+export declare const ASSET_TOKEN_PREFIX = "aippy-asset:";
+/**
+ * Mirrors aippy-chat `assetmanifest.ValidReference`: every value the server
+ * puts in the inventory as a usable url must be accepted here, including
+ * root-relative and relative paths.
+ */
+export declare function isDictionaryResourceURL(value: string): boolean;
+/** Keys that own each usable dictionary URL. A shared URL lists every key. */
+export declare function dictionaryResourceOwners(flat: Record<string, unknown>): Map<string, string[]>;
+/** Percent-encode a dictionary key so `:` and `$` cannot be read as separators. */
+export declare function encodeAssetKey(key: string): string;
+/**
+ * `aippy-asset:<encodeURIComponent(key)>:<url>`.
+ * The key ends at the first raw colon. `hero:mobile` must be `hero%3Amobile`;
+ * splitting that unencoded form would name `hero` and is rejected because the
+ * remainder `mobile:https://...` is not a resource reference.
+ */
+export declare function parseAssetToken(value: string): {
+    key: string;
+    url: string;
+} | undefined;
+/**
+ * Drop the `aippy-asset:<key>:` prefix from any token the key rewrite did not
+ * reach (template literals, CSS, HTML, unknown keys), leaving the url itself.
+ * A literal token is never a loadable resource.
+ */
+export declare function stripAssetTokens(code: string): 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.