vite-userscript-plugin 2.1.0 → 2.2.0

package/README.md

@@ -83,7 +83,7 @@ Details: [types/README.md](./types/README.md).
 
 `vite` prints `/{fileName}.dev.user.js` — install that URL once. HMR covers code and styles.
 
-`server.file: true` skips HMR. The same `vite` watch-builds `{fileName}.js` (headerless IIFE) and `{fileName}.proxy.user.js` with `@require file://` to that IIFE. Install the printed `/{fileName}.proxy.user.js` URL. See [examples/serve-file](./examples/serve-file).
+`server.file: true` skips HMR. The same `vite` watch-builds `{fileName}.user.js` (headed IIFE), `{fileName}.js`, and `{fileName}.proxy.user.js` (`@require file://` to the IIFE). Install the printed `/{fileName}.user.js` URL (Firefox-safe). The `Proxy` line is for managers that can poll `file://`. See [examples/serve-file](./examples/serve-file).
 
 > [!IMPORTANT]
 > Changing `@match`, `@grant`, or `@name` needs a reinstall.
@@ -133,13 +133,12 @@ See [examples/sourcemap](./examples/sourcemap).
 | Option | Default | Description |
 | --- | --- | --- |
 | `entry` | — | Userscript entry. Required. |
-| `header` | — | Metablock. Required: `name`, `version`, `match`. |
+| `header` | — | Metablock. Required: `name`, `version`, `match`. Relative `icon` / `require` / `resource` / `supportURL` / `updateURL` / `downloadURL` join `homepage` (`homepageURL` / `website` / `source`). Absolute `http(s):` URLs stay as-is. |
 | `fileName` | sanitized `header.name` | Output base name (`{fileName}.user.js`). |
-| `server.open` | `false` | Open the install target when Vite starts. HMR: `.dev.user.js`. `file`: `.proxy.user.js` URL. |
+| `server.open` | `false` | Open the install target when Vite starts. HMR: `.dev.user.js`. `file`: `.user.js` URL. |
 | `server.prefix` | `'server:'` | Prefix for `@name` in serve mode. `false` disables it. |
-| `server.file` | `false` | Watch-build `{fileName}.js` + `{fileName}.proxy.user.js` (`@require file://`). Install from the printed URL. No HMR. |
-| `cssInject` | `'auto'` | How production CSS is injected. `'auto'` uses `GM_addStyle` or a `<style>` node. |
-| `align` | `1` | Extra spaces after the longest `@key`. `false` — one space. |
+| `server.file` | `false` | Watch-build `{fileName}.user.js` + `{fileName}.js` + `{fileName}.proxy.user.js`. Install `.user.js` (or the proxy if `file://` `@require` works). No HMR. |
+| `headerAlign` | `1` | Extra spaces after the longest `@key`. `false` — one space. |
 | `generate` | — | Rewrite the generated metablock. |
 | `autoMetaUrls` | `false` | Fill empty `updateURL` / `downloadURL` from `homepage` / `homepageURL` / `website` / `source`. |
 | `metaFile` | `true` | Emit `{fileName}.meta.js`. |
@@ -161,7 +160,7 @@ In serve mode the header lists every grant. In production the plugin scans the b
 | [svelte](./examples/svelte) | SFC `<style>`. |
 | [multiple-entries](./examples/multiple-entries) | Two scripts. |
 | [sourcemap](./examples/sourcemap) | Inline map, HTML page, virtual module. |
-| [serve-file](./examples/serve-file) | `server.file`, install the proxy from the printed URL. |
+| [serve-file](./examples/serve-file) | `server.file`, install `.user.js` or the proxy from the printed URLs. |
 
 ## FAQ
 
@@ -181,6 +180,8 @@ In serve mode the header lists every grant. In production the plugin scans the b
 
 > [!NOTE]
 > Userscripts run on someone else’s origin. Import the file so Vite inlines it. `public/` only works for the `index.html` app on the Vite origin.
+>
+> `@icon`, `@require`, and `@resource` are different: the manager fetches them from the metablock URL, not from the `match` site. Write `icon: 'greasify.svg'` plus `homepage` (GitHub Pages, etc.) — the plugin joins them. Leave `https://…` as-is.
 
 ### `@run-at document-start` feels late in dev
 
@@ -190,7 +191,7 @@ In serve mode the header lists every grant. In production the plugin scans the b
 ### `file://` `@require` is blocked
 
 > [!NOTE]
-> Tampermonkey must allow local file access (`@require` from `file://`). Violentmonkey polls the required file after you install `{fileName}.proxy.user.js` from the printed URL. HTTP `@require` and page auto-reload are not part of this mode.
+> Firefox extensions cannot read `file://`. Install the printed `{fileName}.user.js` URL instead of the proxy. Tampermonkey on Chromium must allow local file access for the proxy `@require`. Violentmonkey can poll the local IIFE after you install the proxy.
 
 ## Migration from v1
 
@@ -204,6 +205,8 @@ In serve mode the header lists every grant. In production the plugin scans the b
 | Vite 3–7 | Vite 8 |
 | `scripts` + shared `header` | `userscript([config, config, …])` |
 | `ScriptOptions` | removed |
+| `cssInject` | removed; imported CSS always appends a `<style>` node |
+| `align` | `headerAlign` |
 
 ## License
 

package/dist/index.d.ts

@@ -147,7 +147,7 @@ type HeaderConfig = {
 interface ServerConfig {
   /**
    * Open the install target when Vite starts.
-   * HMR: `.dev.user.js` URL. `file`: `{fileName}.proxy.user.js` URL.
+   * HMR: `.dev.user.js` URL. `file`: `{fileName}.user.js` URL.
    *
    * @default false
    */
@@ -160,9 +160,9 @@ interface ServerConfig {
    */
   prefix?: string | false;
   /**
-   * Watch-build into `outDir`: headerless `{fileName}.js` and `{fileName}.proxy.user.js`
-   * with `@require file://` pointing at the IIFE.
-   * Install the proxy from the printed `/{fileName}.proxy.user.js` URL. No HMR for this script.
+   * Watch-build into `outDir`: `{fileName}.user.js`, headerless `{fileName}.js`,
+   * and `{fileName}.proxy.user.js` with `@require file://` pointing at the IIFE.
+   * Install `/{fileName}.user.js` (Firefox-safe) or the proxy URL. No HMR for this script.
    *
    * @default false
    */
@@ -173,7 +173,6 @@ interface HeaderGenerateContext {
   userscript: string;
   mode: HeaderMode;
 }
-type CssInject = 'auto' | string | ((css: string) => void);
 /**
  * One userscript. Pass an object, or an array of these, to {@link UserscriptPluginConfig}.
  */
@@ -196,18 +195,12 @@ interface UserscriptConfig {
    * Serve-mode options.
    */
   server?: ServerConfig;
-  /**
-   * How to inject collected CSS in production builds.
-   *
-   * @default 'auto'
-   */
-  cssInject?: CssInject;
   /**
    * Extra spaces after the longest `@key`, or `false` for a single space.
    *
    * @default 1
    */
-  align?: number | false;
+  headerAlign?: number | false;
   /**
    * Rewrite the generated metablock.
    */
@@ -240,32 +233,13 @@ interface ResolvedScript {
     prefix: string | false;
     file: boolean;
   };
-  cssInject: CssInject;
-  align: number | false;
+  headerAlign: number | false;
   generate?: (ctx: HeaderGenerateContext) => string;
   autoMetaUrls: boolean;
   metaFile: boolean;
 }
 //#endregion
-//#region src/header.d.ts
-interface HeaderOptions {
-  align?: number | false;
-  autoMetaUrls?: boolean;
-  fileName?: string;
-  generate?: (ctx: HeaderGenerateContext) => string;
-  mode?: HeaderMode;
-}
-declare function resolveHomePage(header: HeaderConfig): string | undefined;
-declare function resolvePublicFileUrl(header: HeaderConfig, fileName: string): string | undefined;
-declare function generateHeader(config: HeaderConfig, options?: HeaderOptions): string;
-declare class Header {
-  private readonly config;
-  private readonly options;
-  constructor(config: HeaderConfig, options?: HeaderOptions);
-  generate(): string;
-}
-//#endregion
 //#region src/plugin.d.ts
 declare function UserscriptPlugin(config: UserscriptPluginConfig): Plugin[];
 //#endregion
-export { type CssInject, Header, type HeaderConfig, type HeaderGenerateContext, type ResolvedScript, type ServerConfig, type UserscriptConfig, type UserscriptPluginConfig, UserscriptPlugin as default, generateHeader, resolveHomePage, resolvePublicFileUrl };
+export { type HeaderConfig, type HeaderGenerateContext, type ResolvedScript, type ServerConfig, type UserscriptConfig, type UserscriptPluginConfig, UserscriptPlugin as default };

package/dist/index.js

@@ -2,9 +2,91 @@ import { basename, posix, relative, resolve, sep } from "node:path";
 import { build } from "vite";
 import { Buffer } from "node:buffer";
 import { pathToFileURL } from "node:url";
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { styleText } from "node:util";
 import openLink from "open";
+//#region src/grants/catalog.ts
+const GM = [
+	"setValue",
+	"getValue",
+	"deleteValue",
+	"listValues",
+	"setValues",
+	"getValues",
+	"deleteValues",
+	"setClipboard",
+	"addStyle",
+	"addElement",
+	"addValueChangeListener",
+	"removeValueChangeListener",
+	"registerMenuCommand",
+	"unregisterMenuCommand",
+	"download",
+	"getTab",
+	"getTabs",
+	"saveTab",
+	"openInTab",
+	"notification",
+	"getResourceURL",
+	"getResourceText",
+	"xmlhttpRequest",
+	"webRequest",
+	"cookie",
+	"audio",
+	"log",
+	"info"
+];
+const GMwindow = [
+	"unsafeWindow",
+	"window.onurlchange",
+	"window.focus",
+	"window.close"
+];
+const GM_DOT_ALIASES = ["GM.xmlHttpRequest", "GM.getResourceUrl"];
+const grants = [
+	...GM.flatMap((grant) => [`GM_${grant}`, `GM.${grant}`]),
+	...GMwindow,
+	...GM_DOT_ALIASES
+];
+const gmIdentifiers = [
+	"GM",
+	"unsafeWindow",
+	...GM.map((grant) => `GM_${grant}`)
+];
+//#endregion
+//#region src/grants/scan.ts
+const grantMatchers = grants.map((grant) => ({
+	grant,
+	pattern: new RegExp(`\\b${grant.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\b`)
+}));
+function removeDuplicates(arr) {
+	if (Array.isArray(arr)) return [...new Set(arr)];
+	return arr ? [arr] : [];
+}
+function defineGrants(code) {
+	return grantMatchers.filter(({ pattern }) => pattern.test(code)).map(({ grant }) => grant);
+}
+//#endregion
+//#region src/grants/policy.ts
+function withServeGrants(header) {
+	if (header.grant === "none") return header;
+	return {
+		...header,
+		grant: [.../* @__PURE__ */ new Set([...header.grant ?? [], ...grants])]
+	};
+}
+function withBuildGrants(header, code, extraGrants = []) {
+	if (header.grant === "none") return header;
+	return {
+		...header,
+		grant: removeDuplicates([
+			...defineGrants(code),
+			...removeDuplicates(header.grant),
+			...extraGrants
+		])
+	};
+}
+//#endregion
 //#region src/names.ts
 function sanitizeFileName(name) {
 	return name.replace(/[<>:"/\\|?*\u0000-\u001F]+/g, "-").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "") || "userscript";
@@ -16,6 +98,18 @@ function toIdentifier(name) {
 }
 //#endregion
 //#region src/header.ts
+const ABSOLUTE_URL_RE = /^[a-z][a-z0-9+.-]*:/i;
+const HOMEPAGE_RELATIVE_FIELDS = [
+	"icon",
+	"iconURL",
+	"defaulticon",
+	"icon64",
+	"icon64URL",
+	"require",
+	"supportURL",
+	"updateURL",
+	"downloadURL"
+];
 function ensureTrailingSlash(url) {
 	return url.endsWith("/") ? url : `${url}/`;
 }
@@ -25,6 +119,29 @@ function resolveHomePage(header) {
 	const trimmed = homePage.trim();
 	return trimmed === "" ? void 0 : trimmed;
 }
+function isResolvableHeaderPath(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return false;
+	if (ABSOLUTE_URL_RE.test(trimmed) || trimmed.startsWith("//") || trimmed.startsWith("/")) return false;
+	return true;
+}
+function containsResolvableHeaderPath(value) {
+	if (typeof value === "string") return isResolvableHeaderPath(value);
+	if (!Array.isArray(value)) return false;
+	return value.some((item) => typeof item === "string" && isResolvableHeaderPath(item));
+}
+function containsResolvableResourcePath(resource) {
+	if (!Array.isArray(resource)) return false;
+	return resource.some((item) => {
+		return Array.isArray(item) && typeof item[1] === "string" && isResolvableHeaderPath(item[1]);
+	});
+}
+function listHomepageRelativeFields(header) {
+	const fields = [];
+	for (const key of HOMEPAGE_RELATIVE_FIELDS) if (containsResolvableHeaderPath(header[key])) fields.push(key);
+	if (containsResolvableResourcePath(header.resource)) fields.push("resource");
+	return fields;
+}
 function resolvePublicFileUrl(header, fileName) {
 	const homePage = resolveHomePage(header);
 	if (!homePage) return;
@@ -32,6 +149,31 @@ function resolvePublicFileUrl(header, fileName) {
 		return new URL(fileName, ensureTrailingSlash(homePage)).href;
 	} catch {}
 }
+function resolveHeaderUrlValue(header, value) {
+	if (typeof value === "string") {
+		if (!isResolvableHeaderPath(value)) return value;
+		return resolvePublicFileUrl(header, value.trim()) ?? value;
+	}
+	if (Array.isArray(value)) return value.map((item) => typeof item === "string" ? resolveHeaderUrlValue(header, item) : item);
+	return value;
+}
+function resolveResourceUrls(header, resource) {
+	if (!Array.isArray(resource)) return resource;
+	return resource.map((item) => {
+		if (!Array.isArray(item) || typeof item[1] !== "string") return item;
+		const [key, url] = item;
+		if (!isResolvableHeaderPath(url)) return item;
+		const resolved = resolvePublicFileUrl(header, url.trim());
+		return resolved ? [key, resolved] : item;
+	});
+}
+function applyHomepageRelativeUrls(header) {
+	if (!resolveHomePage(header)) return header;
+	const next = { ...header };
+	for (const key of HOMEPAGE_RELATIVE_FIELDS) if (next[key] != null) Object.assign(next, { [key]: resolveHeaderUrlValue(next, next[key]) });
+	if (next.resource != null) next.resource = resolveResourceUrls(next, next.resource);
+	return next;
+}
 function applyAutoMetaUrls(header, fileName) {
 	const updateURL = header.updateURL ?? resolvePublicFileUrl(header, `${fileName}.meta.js`);
 	const downloadURL = header.downloadURL ?? resolvePublicFileUrl(header, `${fileName}.user.js`);
@@ -53,7 +195,8 @@ function formatValue(value) {
 }
 function generateHeader(config, options = {}) {
 	const fileName = options.fileName ?? sanitizeFileName(config.name);
-	const header = options.autoMetaUrls ? applyAutoMetaUrls({ ...config }, fileName) : { ...config };
+	const withRelativeUrls = applyHomepageRelativeUrls({ ...config });
+	const header = options.autoMetaUrls ? applyAutoMetaUrls(withRelativeUrls, fileName) : withRelativeUrls;
 	const keys = Object.keys(header).filter((key) => {
 		const value = header[key];
 		return value !== void 0 && value !== null && value !== false;
@@ -88,99 +231,6 @@ function generateHeader(config, options = {}) {
 		mode: options.mode ?? "build"
 	});
 }
-var Header = class {
-	config;
-	options;
-	constructor(config, options = {}) {
-		this.config = config;
-		this.options = options;
-	}
-	generate() {
-		return generateHeader(this.config, this.options);
-	}
-};
-//#endregion
-//#region src/grants/catalog.ts
-const GM = [
-	"setValue",
-	"getValue",
-	"deleteValue",
-	"listValues",
-	"setValues",
-	"getValues",
-	"deleteValues",
-	"setClipboard",
-	"addStyle",
-	"addElement",
-	"addValueChangeListener",
-	"removeValueChangeListener",
-	"registerMenuCommand",
-	"unregisterMenuCommand",
-	"download",
-	"getTab",
-	"getTabs",
-	"saveTab",
-	"openInTab",
-	"notification",
-	"getResourceURL",
-	"getResourceText",
-	"xmlhttpRequest",
-	"webRequest",
-	"cookie",
-	"audio",
-	"log",
-	"info"
-];
-const GMwindow = [
-	"unsafeWindow",
-	"window.onurlchange",
-	"window.focus",
-	"window.close"
-];
-const GM_DOT_ALIASES = ["GM.xmlHttpRequest", "GM.getResourceUrl"];
-const grants = [
-	...GM.flatMap((grant) => [`GM_${grant}`, `GM.${grant}`]),
-	...GMwindow,
-	...GM_DOT_ALIASES
-];
-const gmIdentifiers = [
-	"GM",
-	"unsafeWindow",
-	...GM.map((grant) => `GM_${grant}`)
-];
-//#endregion
-//#region src/grants/scan.ts
-const grantMatchers = grants.map((grant) => ({
-	grant,
-	pattern: new RegExp(`\\b${grant.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\b`)
-}));
-function removeDuplicates(arr) {
-	if (Array.isArray(arr)) return [...new Set(arr)];
-	return arr ? [arr] : [];
-}
-function defineGrants(code) {
-	return grantMatchers.filter(({ pattern }) => pattern.test(code)).map(({ grant }) => grant);
-}
-//#endregion
-//#region src/grants/policy.ts
-function withServeGrants(header) {
-	if (header.grant === "none") return header;
-	return {
-		...header,
-		grant: [.../* @__PURE__ */ new Set([...header.grant ?? [], ...grants])]
-	};
-}
-function withBuildGrants(header, code, extraGrants = []) {
-	if (header.grant === "none") return header;
-	return {
-		...header,
-		grant: removeDuplicates([
-			...defineGrants(code),
-			...removeDuplicates(header.grant),
-			...extraGrants
-		])
-	};
-}
 //#endregion
 //#region src/sourcemap.ts
 function countHeaderLines(prefix) {
@@ -264,13 +314,9 @@ function isAsset(item) {
 //#endregion
 //#region src/build/css.ts
 const defaultCssInjector = `(function (css) {
-  if (typeof GM_addStyle === 'function') {
-    GM_addStyle(css)
-  } else {
-    var style = document.createElement('style')
-    style.textContent = css
-    ;(document.head || document.documentElement).appendChild(style)
-  }
+  var style = document.createElement('style')
+  style.textContent = css
+  ;(document.head || document.documentElement).appendChild(style)
 })`;
 function collectImportedCss(chunk, bundle, seen = /* @__PURE__ */ new Set()) {
 	const files = [...chunk.viteMetadata?.importedCss ?? []];
@@ -297,11 +343,8 @@ function collectCss(chunk, bundle) {
 		files
 	};
 }
-function createCssInject(css, cssInject = "auto") {
-	const payload = JSON.stringify(css);
-	if (cssInject === "auto") return `${defaultCssInjector}(${payload});\n`;
-	if (typeof cssInject === "function") return `(${cssInject.toString()})(${payload});\n`;
-	return `(${cssInject})(${payload});\n`;
+function createCssInject(css) {
+	return `${defaultCssInjector}(${JSON.stringify(css)});\n`;
 }
 //#endregion
 //#region src/build/iife.ts
@@ -345,7 +388,7 @@ function createWatchProxyHeader(script, jsAbsPath) {
 }
 function generateWatchProxy(script, jsAbsPath) {
 	return generateHeader(createWatchProxyHeader(script, jsAbsPath), {
-		align: script.align,
+		align: script.headerAlign,
 		autoMetaUrls: false,
 		fileName: script.fileName,
 		generate: script.generate,
@@ -406,6 +449,28 @@ function withSourceMaps(fileNames) {
 function findScriptForChunk(chunk, fileName, scripts) {
 	return scripts.find((script) => chunk.name === script.fileName || fileName === `${script.fileName}.js` || fileName === `${script.fileName}.user.js`);
 }
+function createHeadedUserscript(script, options) {
+	const headerConfig = withBuildGrants(script.header, options.wrapped);
+	const prefix = `${generateHeader(headerConfig, {
+		align: script.headerAlign,
+		autoMetaUrls: script.autoMetaUrls,
+		fileName: script.fileName,
+		generate: script.generate,
+		mode: "build"
+	})}\n\n`;
+	const nextFileName = `${script.fileName}.user.js`;
+	let nextCode = `${prefix}${options.code}`;
+	if (options.map) {
+		const wrapOffset = isAlreadyIife(stripSourceMappingUrl(options.body)) ? 0 : 1;
+		const lineOffset = countHeaderLines(prefix) + countHeaderLines(options.cssPrelude) + wrapOffset + countHeaderLines(options.inlined);
+		const map = stripVendorSourcesContent(offsetSourceMap(options.map, lineOffset, nextFileName));
+		nextCode = `${stripSourceMappingUrl(nextCode).replace(/\n+$/g, "\n")}//# sourceMappingURL=${toInlineSourceMappingUrl(map)}\n`;
+	}
+	return {
+		headerConfig,
+		code: nextCode.endsWith("\n") ? nextCode : `${nextCode}\n`
+	};
+}
 function deleteBundleFiles(bundle, fileNames) {
 	for (const fileName of fileNames) delete bundle[fileName];
 }
@@ -435,13 +500,20 @@ function applyUserscriptBundle(bundle, config, context) {
 		const inlined = stripSourceMappingUrl(inlineImportedChunks(chunk, bundle));
 		const { css, files: cssFiles } = collectCss(chunk, bundle);
 		for (const cssFile of cssFiles) if (!keptCss.has(cssFile)) leftoverAssets.push(...withSourceMaps([cssFile]));
-		const cssPrelude = css ? createCssInject(css, script.cssInject) : "";
+		const cssPrelude = css ? createCssInject(css) : "";
 		const body = `${inlined}${chunk.code}`;
 		const wrapped = ensureIife(body);
-		const extraGrants = css && script.cssInject === "auto" ? ["GM_addStyle"] : [];
 		const code = `${cssPrelude}${wrapped}`;
 		const emitFileProxy = Boolean(context.emitProxy && context.outDir && script.server.file);
 		leftoverAssets.push(`${fileName}.map`);
+		const headed = createHeadedUserscript(script, {
+			body,
+			code,
+			cssPrelude,
+			inlined,
+			map: chunk.map,
+			wrapped
+		});
 		if (emitFileProxy) {
 			const requireName = toRequireFileName(script.fileName);
 			let nextCode = code.endsWith("\n") ? code : `${code}\n`;
@@ -454,28 +526,13 @@ function applyUserscriptBundle(bundle, config, context) {
 			chunk.code = nextCode;
 			chunk.fileName = requireName;
 			emitFile(toProxyFileName(script.fileName), `${generateWatchProxy(script, resolve(context.outDir, requireName))}\n`);
+			emitFile(`${script.fileName}.user.js`, headed.code);
 			continue;
 		}
-		const headerConfig = withBuildGrants(script.header, wrapped, extraGrants);
-		const prefix = `${generateHeader(headerConfig, {
-			align: script.align,
-			autoMetaUrls: script.autoMetaUrls,
-			fileName: script.fileName,
-			generate: script.generate,
-			mode: "build"
-		})}\n\n`;
-		const nextFileName = `${script.fileName}.user.js`;
-		let nextCode = `${prefix}${code}`;
-		if (chunk.map) {
-			const wrapOffset = isAlreadyIife(stripSourceMappingUrl(body)) ? 0 : 1;
-			const lineOffset = countHeaderLines(prefix) + countHeaderLines(cssPrelude) + wrapOffset + countHeaderLines(inlined);
-			chunk.map = stripVendorSourcesContent(offsetSourceMap(chunk.map, lineOffset, nextFileName));
-			nextCode = `${stripSourceMappingUrl(nextCode).replace(/\n+$/g, "\n")}//# sourceMappingURL=${toInlineSourceMappingUrl(chunk.map)}\n`;
-		}
-		chunk.code = nextCode;
-		chunk.fileName = nextFileName;
-		if (script.metaFile) emitFile(`${script.fileName}.meta.js`, generateHeader(headerConfig, {
-			align: script.align,
+		chunk.code = headed.code;
+		chunk.fileName = `${script.fileName}.user.js`;
+		if (script.metaFile) emitFile(`${script.fileName}.meta.js`, generateHeader(headed.headerConfig, {
+			align: script.headerAlign,
 			autoMetaUrls: script.autoMetaUrls,
 			fileName: script.fileName,
 			generate: script.generate,
@@ -495,7 +552,7 @@ function createClientSnapshot(scripts, command) {
 	return scripts.map((script) => {
 		let suffix = ".dev.user.js";
 		if (command === "build") suffix = ".user.js";
-		else if (script.server.file) suffix = ".proxy.user.js";
+		else if (script.server.file) suffix = ".user.js";
 		return {
 			name: script.header.name,
 			version: script.header.version,
@@ -596,8 +653,7 @@ function toResolvedScript(config) {
 			prefix: config.server?.prefix ?? "server:",
 			file: config.server?.file ?? false
 		},
-		cssInject: config.cssInject ?? "auto",
-		align: config.align ?? 1,
+		headerAlign: config.headerAlign ?? 1,
 		generate: config.generate,
 		autoMetaUrls: config.autoMetaUrls ?? false,
 		metaFile: config.metaFile ?? true
@@ -612,6 +668,19 @@ function collectAutoMetaUrlsWarnings(config) {
 	}
 	return warnings;
 }
+function collectHomepageRelativeUrlWarnings(config) {
+	const warnings = [];
+	for (const script of config.scripts) {
+		if (resolveHomePage(script.header)) continue;
+		const fields = listHomepageRelativeFields(script.header);
+		if (!fields.length) continue;
+		warnings.push(`[${PLUGIN_NAME}] "${script.fileName}" has relative header URLs (${fields.join(", ")}) but no homepage, homepageURL, website, or source`);
+	}
+	return warnings;
+}
+function collectConfigWarnings(config) {
+	return [...collectAutoMetaUrlsWarnings(config), ...collectHomepageRelativeUrlWarnings(config)];
+}
 function resolvePluginConfig(config) {
 	const items = Array.isArray(config) ? config : [config];
 	if (!items.length) throw new Error(`[${PLUGIN_NAME}] Provide a userscript config or a non-empty array`);
@@ -648,9 +717,10 @@ function shimModule(code, id) {
 }
 //#endregion
 //#region src/serve/logger.ts
-function formatInstallLine(installUrl) {
+function formatInstallLine(installUrl, label = "Userscript") {
 	const coloredUrl = styleText("cyan", installUrl.replace(/:(\d+)\//, (_match, port) => `:${styleText("bold", port)}/`));
-	return `  ${styleText("green", "➜")}  ${styleText("bold", "Userscript")}: ${coloredUrl}`;
+	const padded = label.padEnd(10);
+	return `  ${styleText("green", "➜")}  ${styleText("bold", padded)}: ${coloredUrl}`;
 }
 function formatRebuildLine(elapsedMs) {
 	return `${styleText("green", "Userscript rebuilt")} ${styleText("dim", `(${elapsedMs}ms)`)}`;
@@ -720,9 +790,16 @@ function matchDevUserscript(url, fileName) {
 function matchProxyUserscript(url, fileName) {
 	return (url.split("?")[0] ?? "") === `/${toProxyFileName(fileName)}`;
 }
-function toInstallUrl(origin, fileName, file = false) {
-	const name = file ? toProxyFileName(fileName) : `${fileName}.dev.user.js`;
-	return `${origin.replace(/\/$/, "")}/${name}`;
+function matchFileUserscript(url, fileName) {
+	return (url.split("?")[0] ?? "") === `/${fileName}.user.js`;
+}
+function toInstallUrl(origin, fileName, kind = "dev") {
+	const names = {
+		dev: `${fileName}.dev.user.js`,
+		proxy: toProxyFileName(fileName),
+		user: `${fileName}.user.js`
+	};
+	return `${origin.replace(/\/$/, "")}/${names[kind]}`;
 }
 function toServeEntryPath(root, entry) {
 	const absolute = resolve(root, entry);
@@ -779,6 +856,9 @@ function findDevScript(url, scripts) {
 function findProxyScript(url, scripts) {
 	return scripts.find((script) => script.server.file && matchProxyUserscript(url, script.fileName));
 }
+function findFileUserscript(url, scripts) {
+	return scripts.find((script) => script.server.file && matchFileUserscript(url, script.fileName));
+}
 function createDevUserscript(options) {
 	return generateDevUserscript({
 		script: options.script,
@@ -786,7 +866,7 @@ function createDevUserscript(options) {
 		root: options.root,
 		prefix: options.script.server.prefix,
 		headerOptions: {
-			align: options.script.align,
+			align: options.script.headerAlign,
 			autoMetaUrls: options.script.autoMetaUrls,
 			generate: options.script.generate
 		},
@@ -824,6 +904,17 @@ function configureDevServer(server, resolved, reactPreamble) {
 			writeScript(res, createReactBootstrapModule(entry));
 			return;
 		}
+		const fileScript = findFileUserscript(url, resolved.scripts);
+		if (fileScript) {
+			const userJsPath = resolve(server.config.root, server.config.build.outDir, `${fileScript.fileName}.user.js`);
+			try {
+				writeScript(res, readFileSync(userJsPath, "utf8"));
+			} catch {
+				res.statusCode = 404;
+				res.end();
+			}
+			return;
+		}
 		const proxyScript = findProxyScript(url, resolved.scripts);
 		if (proxyScript) {
 			writeScript(res, `${generateWatchProxy(proxyScript, resolve(server.config.root, server.config.build.outDir, toRequireFileName(proxyScript.fileName)))}\n`);
@@ -848,7 +939,14 @@ function configureDevServer(server, resolved, reactPreamble) {
 		let origins = [];
 		if (urls) origins = urls.local.length ? urls.local : urls.network;
 		const printInstall = () => {
-			for (const origin of origins) for (const script of resolved.scripts) info(formatInstallLine(toInstallUrl(origin, script.fileName, script.server.file)));
+			for (const origin of origins) for (const script of resolved.scripts) {
+				if (script.server.file) {
+					info(formatInstallLine(toInstallUrl(origin, script.fileName, "user")));
+					info(formatInstallLine(toInstallUrl(origin, script.fileName, "proxy"), "Proxy"));
+					continue;
+				}
+				info(formatInstallLine(toInstallUrl(origin, script.fileName)));
+			}
 			info(formatFaqHint());
 		};
 		const logger = createAfterLocalLogger(info, urls?.local.length ?? 0, printInstall);
@@ -866,7 +964,7 @@ function configureDevServer(server, resolved, reactPreamble) {
 		if (!toOpen.length) return;
 		queueMicrotask(() => {
 			const origin = resolveServerOrigin(server.resolvedUrls);
-			for (const script of toOpen) openLink(toInstallUrl(origin, script.fileName, script.server.file));
+			for (const script of toOpen) openLink(toInstallUrl(origin, script.fileName, script.server.file ? "user" : "dev"));
 		});
 	});
 }
@@ -984,7 +1082,7 @@ function UserscriptPlugin(config) {
 				command = viteConfig.command;
 				resolved = absolutizeEntries(resolved, viteConfig.root);
 				reactPreamble = hasReactRefreshPlugin(viteConfig.plugins);
-				for (const message of collectAutoMetaUrlsWarnings(resolved)) viteConfig.logger.warn(message);
+				for (const message of collectConfigWarnings(resolved)) viteConfig.logger.warn(message);
 			}
 		},
 		{
@@ -1042,4 +1140,4 @@ function UserscriptPlugin(config) {
 	];
 }
 //#endregion
-export { Header, UserscriptPlugin as default, generateHeader, resolveHomePage, resolvePublicFileUrl };
+export { UserscriptPlugin as default };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vite-userscript-plugin",
   "type": "module",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "author": {
     "name": "Vitalij Ryndin",
     "url": "https://github.com/crashmax-dev"