vite-userscript-plugin 2.3.0 → 2.3.1

package/README.md

@@ -133,7 +133,7 @@ See [examples/sourcemap](./examples/sourcemap).
 | Option | Default | Description |
 | --- | --- | --- |
 | `entry` | — | Userscript entry. Required. |
-| `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. |
+| `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. `updateURL` / `downloadURL` of `none` disable updates and are not joined. |
 | `fileName` | sanitized `header.name` | Output base name (`{fileName}.user.js`). |
 | `server.open` | `false` | Open the install target when Vite starts (`true`, `'user'`, `'proxy'`). HMR: `.dev.user.js`. `file`: `.user.js` or `.proxy.user.js`. Vite opens one URL. |
 | `server.prefix` | `'server:'` | Prefix for `@name` in serve mode. `false` disables it. |

package/dist/index.d.ts

@@ -63,18 +63,33 @@ type HeaderConfig = {
    */
   'author'?: string;
   /**
+   * Script homepage. Also the base for relative `icon`, `iconURL`,
+   * `defaulticon`, `icon64`, `icon64URL`, `require`, `resource`, `supportURL`,
+   * `updateURL`, and `downloadURL`. Absolute `http(s):` URLs stay as-is.
+   * `updateURL` / `downloadURL` of `none` are not joined.
+   *
+   * Fallback order: `homepage`, `homepageURL`, `website`, `source`.
+   *
    * @see https://www.tampermonkey.net/documentation.php#meta:homepage
    */
   'homepage'?: string;
   /**
+   * Alias of `homepage`. Used as the relative-URL base when `homepage` is empty.
+   *
    * @see https://www.tampermonkey.net/documentation.php#meta:homepage
    */
   'homepageURL'?: string;
   /**
+   * Alias of `homepage`. Used as the relative-URL base when `homepage` and
+   * `homepageURL` are empty.
+   *
    * @see https://www.tampermonkey.net/documentation.php#meta:homepage
    */
   'website'?: string;
   /**
+   * Alias of `homepage`. Used as the relative-URL base when `homepage`,
+   * `homepageURL`, and `website` are empty.
+   *
    * @see https://www.tampermonkey.net/documentation.php#meta:homepage
    */
   'source'?: string;
@@ -124,13 +139,17 @@ type HeaderConfig = {
    */
   'noframes'?: boolean;
   /**
+   * `none` disables update checks. It is not joined with homepage.
+   *
    * @see https://www.tampermonkey.net/documentation.php#meta:updateURL
    */
-  'updateURL'?: string;
+  'updateURL'?: 'none' | (string & {});
   /**
+   * `none` disables update checks (pinned / non-latest installs). It is not joined with homepage.
+   *
    * @see https://www.tampermonkey.net/documentation.php#meta:downloadURL
    */
-  'downloadURL'?: string;
+  'downloadURL'?: 'none' | (string & {});
   /**
    * @see https://www.tampermonkey.net/documentation.php#meta:supportURL
    */

package/dist/index.js

@@ -118,16 +118,17 @@ function resolveHomePage(header) {
 	const trimmed = homePage.trim();
 	return trimmed === "" ? void 0 : trimmed;
 }
-function isResolvableHeaderPath(value) {
+function isResolvableHeaderPath(value, field) {
 	const trimmed = value.trim();
 	if (!trimmed) return false;
+	if ((field === "updateURL" || field === "downloadURL") && trimmed.toLowerCase() === "none") 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);
+function containsResolvableHeaderPath(value, field) {
+	if (typeof value === "string") return isResolvableHeaderPath(value, field);
 	if (!Array.isArray(value)) return false;
-	return value.some((item) => typeof item === "string" && isResolvableHeaderPath(item));
+	return value.some((item) => typeof item === "string" && isResolvableHeaderPath(item, field));
 }
 function containsResolvableResourcePath(resource) {
 	if (!Array.isArray(resource)) return false;
@@ -137,7 +138,7 @@ function containsResolvableResourcePath(resource) {
 }
 function listHomepageRelativeFields(header) {
 	const fields = [];
-	for (const key of HOMEPAGE_RELATIVE_FIELDS) if (containsResolvableHeaderPath(header[key])) fields.push(key);
+	for (const key of HOMEPAGE_RELATIVE_FIELDS) if (containsResolvableHeaderPath(header[key], key)) fields.push(key);
 	if (containsResolvableResourcePath(header.resource)) fields.push("resource");
 	return fields;
 }
@@ -148,12 +149,12 @@ function resolvePublicFileUrl(header, fileName) {
 		return new URL(fileName, ensureTrailingSlash(homePage)).href;
 	} catch {}
 }
-function resolveHeaderUrlValue(header, value) {
+function resolveHeaderUrlValue(header, value, field) {
 	if (typeof value === "string") {
-		if (!isResolvableHeaderPath(value)) return value;
+		if (!isResolvableHeaderPath(value, field)) return value;
 		return resolvePublicFileUrl(header, value.trim()) ?? value;
 	}
-	if (Array.isArray(value)) return value.map((item) => typeof item === "string" ? resolveHeaderUrlValue(header, item) : item);
+	if (Array.isArray(value)) return value.map((item) => typeof item === "string" ? resolveHeaderUrlValue(header, item, field) : item);
 	return value;
 }
 function resolveResourceUrls(header, resource) {
@@ -169,7 +170,7 @@ function resolveResourceUrls(header, resource) {
 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]) });
+	for (const key of HOMEPAGE_RELATIVE_FIELDS) if (next[key] != null) Object.assign(next, { [key]: resolveHeaderUrlValue(next, next[key], key) });
 	if (next.resource != null) next.resource = resolveResourceUrls(next, next.resource);
 	return next;
 }

package/package.json

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