vite-userscript-plugin 1.9.2 → 1.11.0

package/types/violentmonkey.d.ts

@@ -9,10 +9,21 @@ declare type VMScriptRunAt =
 /** Injection mode of a script. */
 declare type VMScriptInjectInto = 'auto' | 'page' | 'content'
 
+declare type GenericObject = Record<string, unknown>
+
 declare interface VMScriptGMInfoPlatform {
-  arch: 'arm' | 'arm64' | 'x86-32' | 'x86-64' | 'mips' | 'mips64'
-  /** `chrome`, `firefox` or whatever was returned by the API. */
-  browserName: string
+  arch:
+    | 'aarch64'
+    | 'arm'
+    | 'arm64'
+    | 'mips'
+    | 'mips64'
+    | 'ppc64'
+    | 's390x'
+    | 'sparc64'
+    | 'x86-32'
+    | 'x86-64'
+  browserName: 'chrome' | 'firefox' | string
   browserVersion: string
   os: 'mac' | 'win' | 'android' | 'cros' | 'linux' | 'openbsd' | 'fuchsia'
 }
@@ -53,6 +64,10 @@ declare interface VMScriptGMInfoScriptMeta {
 declare interface VMScriptGMInfoObject {
   /** Unique ID of the script. */
   uuid: string
+  /** The injection mode of current script. */
+  injectInto: VMScriptInjectInto
+  /** Contains structured fields from the *Metadata Block*. */
+  script: VMScriptGMInfoScriptMeta
   /** The meta block of the script. */
   scriptMetaStr: string
   /** Whether the script will be updated automatically. */
@@ -68,10 +83,14 @@ declare interface VMScriptGMInfoObject {
    * extension API (`browser.runtime.getPlatformInfo` and `getBrowserInfo`).
    */
   platform: VMScriptGMInfoPlatform
-  /** Contains structured fields from the *Metadata Block*. */
-  script: VMScriptGMInfoScriptMeta
-  /** The injection mode of current script. */
-  injectInto: VMScriptInjectInto
+  /**
+   * A copy of navigator.userAgentData from the content script of the extension.
+   * @since VM2.20.2 */
+  userAgentData?: {
+    brands: { brand: string; version: string }[]
+    mobile: boolean
+    platform: string
+  }
 }
 
 /**
@@ -84,10 +103,18 @@ declare function GM_log(...args: any): void
 
 /** Retrieves a value for current script from storage. */
 declare function GM_getValue<T>(name: string, defaultValue?: T): T
+/** @since VM2.19.1 */
+declare function GM_getValues(names: string[]): GenericObject
+/** @since VM2.19.1 */
+declare function GM_getValues(namesWithDefaults: GenericObject): GenericObject
 /** Sets a key / value pair for current script to storage. */
 declare function GM_setValue<T>(name: string, value: T): void
+/** @since VM2.19.1 */
+declare function GM_setValues(values: GenericObject): void
 /** Deletes an existing key / value pair for current script from storage. */
 declare function GM_deleteValue(name: string): void
+/** @since VM2.19.1 */
+declare function GM_deleteValues(names: string[]): void
 /** Returns an array of keys of all available values within this script. */
 declare function GM_listValues(): string[]
 
@@ -214,13 +241,25 @@ declare function GM_openInTab(
 
 /**
  * Registers a command in Violentmonkey popup menu.
+ * Returns the command's id since VM2.12.5, see description of the `id` parameter.
  * If you want to add a shortcut, please see `@violentmonkey/shortcut`.
  */
 declare function GM_registerMenuCommand(
   /** The name to show in the popup menu. */
   caption: string,
   /** Callback function when the command is clicked in the menu. */
-  onClick: (event: MouseEvent | KeyboardEvent) => void
+  onClick: (event: MouseEvent | KeyboardEvent) => void,
+  /** @since VM2.15.9 */
+  options?: {
+    /** Default: the `caption` parameter.
+     * In 2.15.9-2.16.1 the default was a randomly generated string. */
+    id?: string
+    /** A hint shown in the status bar when hovering the command. */
+    title?: string
+    /** Default: `true`.
+     * Whether to auto-close the popup after the user invoked the command. */
+    autoClose?: boolean
+  }
 ): string
 /** Unregisters a command which has been registered to Violentmonkey popup menu. */
 declare function GM_unregisterMenuCommand(
@@ -244,6 +283,30 @@ declare interface VMScriptGMNotificationOptions {
   title?: string
   /** URL of an image to show in the notification. */
   image?: string
+  /** No sounds/vibrations when showing the notification.
+   * @since VM2.15.2, Chrome 70. */
+  silent?: boolean
+  /**
+   * Unique name of the notification, e.g. 'abc', same as the web Notification API.
+   * Names are scoped to each userscript i.e. your tag won't clash with another script's tag.
+   * The purpose of a tagged notification is to replace an older notification with the same tag,
+   * even if it was shown in another tab (or before this tab was navigated elsewhere
+   * and your notification had `zombieTimeout`).
+   * @since VM2.15.4
+   */
+  tag?: string
+  /**
+   * Number of milliseconds to keep the notification after the userscript "dies",
+   * i.e. when its tab or frame is reloaded/closed/navigated. If not specified or invalid,
+   * the default behavior is to immediately remove the notifications.
+   * @since VM2.15.4
+   */
+  zombieTimeout?: number
+  /**
+   * URL to open when a zombie notification is clicked, see `zombieTimeout` for more info.
+   * @since VM2.16.1
+   */
+  zombieUrl?: string
   /** Callback when the notification is clicked by user. */
   onclick?: () => void
   /** Callback when the notification is closed, either by user or by system. */
@@ -408,10 +471,20 @@ declare interface VMScriptGMObjectVMExtensions {
   addElement: typeof GM_addElement
   addStyle: typeof GM_addStyle
   addValueChangeListener: typeof GM_addValueChangeListener
-  download: typeof GM_download
+  /** @since VM2.19.1 */
+  deleteValues: (names: string[]) => Promise<void>
+  download:
+    | ((options: VMScriptGMDownloadOptions) => Promise<Blob> | void)
+    | ((url: string, name: string) => Promise<Blob> | void)
   getResourceText: typeof GM_getResourceText
+  /** @since VM2.19.1 */
+  getValues:
+    | ((names: string[]) => Promise<GenericObject>)
+    | ((namesWithDefaults: GenericObject) => Promise<GenericObject>)
   log: typeof GM_log
   removeValueChangeListener: typeof GM_removeValueChangeListener
+  /** @since VM2.19.1 */
+  setValues: (values: GenericObject) => Promise<void>
   unregisterMenuCommand: typeof GM_unregisterMenuCommand
 }
 
@@ -428,7 +501,9 @@ declare interface VMScriptGMObject extends VMScriptGMObjectVMExtensions {
   notification: typeof GM_notification
   openInTab: typeof GM_openInTab
   setClipboard: typeof GM_setClipboard
-  xmlHttpRequest: typeof GM_xmlhttpRequest
+  xmlHttpRequest: <T = string | Blob | ArrayBuffer | Document | object>(
+    details: VMScriptGMXHRDetails<T>
+  ) => Promise<T> & VMScriptXHRControl
 }
 
 declare const GM: VMScriptGMObject

package/dist/index.cjs

@@ -1,5 +0,0 @@
-"use strict";var te=Object.create;var b=Object.defineProperty;var re=Object.getOwnPropertyDescriptor;var ne=Object.getOwnPropertyNames;var se=Object.getPrototypeOf,oe=Object.prototype.hasOwnProperty;var ie=(e,t)=>{for(var r in t)b(e,r,{get:t[r],enumerable:!0})},_=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of ne(t))!oe.call(e,s)&&s!==r&&b(e,s,{get:()=>t[s],enumerable:!(n=re(t,s))||n.enumerable});return e};var v=(e,t,r)=>(r=e!=null?te(se(e)):{},_(t||!e||!e.__esModule?b(r,"default",{value:e,enumerable:!0}):r,e)),ae=e=>_(b({},"__esModule",{value:!0}),e);var me={};ie(me,{default:()=>B});module.exports=ae(me);var c=require("fs"),N=require("http"),p=require("path"),V=v(require("get-port"),1),H=v(require("open"),1),S=v(require("picocolors"),1),W=v(require("serve-handler"),1),q=require("vite"),z=require("websocket");var f=class{constructor(t){this.config=t;this.addHomepageMeta(),this.maxKeyLength=Math.max(...Object.keys(this.config).map(r=>r.length))+1}header=[];maxKeyLength;addHomepageMeta(){let t=this.config.homepage??this.config.homepageURL;t&&(this.config.updateURL=new URL(`${this.config.name}.meta.js`,t).href,this.config.downloadURL=new URL(`${this.config.name}.user.js`,t).href)}addSpaces(t){return" ".repeat(this.maxKeyLength-t.length)}addMetadata(t,r){r=Array.isArray(r)?r.join(" "):r===!0?"":r,this.header.push(`// @${t}${this.addSpaces(t)}${r}`)}generate(){for(let[t,r]of Object.entries(this.config))if(Array.isArray(r))r.forEach(n=>this.addMetadata(t,n));else{if(r===void 0)continue;this.addMetadata(t,r)}return["// ==UserScript==",...this.header,"// ==/UserScript=="].join(`
-`)}};var O=require("path"),E=require("url"),pe={},L=(0,O.dirname)((0,E.fileURLToPath)(pe.url)),j="vite-userscript-plugin",R='console.warn("__STYLE__")',D=new RegExp(/\.(t|j)sx?$/),C=new RegExp(/\.(s[ac]|c|le)ss$/),le=["setValue","getValue","deleteValue","listValues","setClipboard","addStyle","addElement","addValueChangeListener","removeValueChangeListener","registerMenuCommand","unregisterMenuCommand","download","getTab","getTabs","saveTab","openInTab","notification","getResourceURL","getResourceText","xmlhttpRequest","log","info"],ce=["unsafeWindow","window.onurlchange","window.focus","window.close"],g=le.map(e=>[`GM_${e}`,`GM.${e}`]).flat();g.push(...ce);var k=require("vite");function U(e){return[...new Set(Array.isArray(e)?e:e?[e]:[])]}async function h({minify:e,file:t,name:r,loader:n}){let{code:s}=await(0,k.transformWithEsbuild)(t,r,{minify:e,loader:n,sourcemap:!1,legalComments:"none"});return s}function A(e){let t=[];for(let r of g)e.indexOf(r)!==-1&&t.push(r);return t}var G=class{styles=new Map;async add(t,r,n){let s=await h({name:t,file:r,minify:n,loader:"css"});return this.styles.set(t,s.replace(`
-`,"")),""}inject(){return this.styles.size?`GM_addStyle(\`${[...this.styles.values()].join("")}\`)`:void 0}merge(t){let r=[];for(let n of t){let s=this.styles.get(n);s&&r.push([n,s])}this.styles.clear(),r.forEach(n=>this.styles.set(...n))}},$=new G;function B(e){try{let t,r,n=null,s=(0,q.createLogger)("info",{prefix:`[${j}]`,allowClearScreen:!0}),y=(0,N.createServer)((o,i)=>(0,W.default)(o,i,{public:t.build.outDir})),K=z.server;return new K({httpServer:y}).on("request",o=>{n=o.accept(null,o.origin)}),{name:j,apply:"build",config(){return{build:{target:"esnext",minify:!1,lib:{entry:e.entry,name:e.header.name,formats:["iife"],fileName:()=>`${e.header.name}.js`},rollupOptions:{output:{extend:!0}}}}},async configResolved(o){t=o,r=o.build.watch??!1,e.entry=(0,p.resolve)(o.root,e.entry),Array.from(["match","require","include","exclude","resource","connect"]).forEach(i=>{let a=e.header[i];e.header[i]=U(a)}),e.server={port:await(0,V.default)(),open:!1,...e.server}},async transform(o,i){let a=o;return C.test(i)&&(a=await $.add(i,a,!r)),i.includes(e.entry)&&(a=o+R),{code:a,map:null}},generateBundle(o,i){for(let a of Object.values(i)){if(a.type==="asset")continue;let m=Object.keys(a.modules).filter(u=>C.test(u));m.length&&$.merge(m)}},async writeBundle(o,i){let{open:a,port:m}=e.server,u=o.sanitizeFileName(e.header.name),I=`${u}.user.js`,F=`${u}.proxy.user.js`,J=`${u}.meta.js`;for(let[d]of Object.entries(i))if(D.test(d)){let w=t.root,x=t.build.outDir,M=(0,p.resolve)(w,x,d),Y=(0,p.resolve)(w,x,I),Q=(0,p.resolve)(w,x,F),X=(0,p.resolve)(w,x,J),P=(0,p.resolve)(L,`ws-${u}.js`);try{let l=(0,c.readFileSync)(M,"utf8");if(l=l.replace(R,`${$.inject()}`),l=await h({minify:!r,file:l,name:d,loader:"js"}),e.header.grant=U(r?g:[...A(l),...e.header.grant??[]]),r){let Z=(0,c.readFileSync)((0,p.resolve)(L,"ws.js"),"utf8"),ee=await h({minify:!r,file:Z.replace("__WS__",`ws://localhost:${m}`),name:P,loader:"js"});(0,c.writeFileSync)(P,ee),(0,c.writeFileSync)(Q,new f({...e.header,require:[...e.header.require??[],"file://"+P,"file://"+M]}).generate())}let T=new f(e.header).generate();(0,c.writeFileSync)(M,l),(0,c.writeFileSync)(X,T),(0,c.writeFileSync)(Y,`${T}
-
-${l}`)}catch(l){console.log(l)}}if(r&&!y.listening){let d=`http://localhost:${m}`;y.listen(m,()=>{s.clearScreen("info"),s.info(S.default.bold(`${S.default.cyan(">>> [vite-userscript-plugin]")} ${S.default.gray(d)}`))}),a&&await(0,H.default)(`${d}/${F}`)}else r||(y.close(),process.exit(0))},buildEnd(){r&&(s.clearScreen("info"),n&&n.sendUTF(JSON.stringify({message:"reload"})))}}}catch(t){return console.error(t),{name:j}}}

package/dist/index.d.cts

@@ -1,171 +0,0 @@
-import { PluginOption } from 'vite';
-
-declare const GM: readonly ["setValue", "getValue", "deleteValue", "listValues", "setClipboard", "addStyle", "addElement", "addValueChangeListener", "removeValueChangeListener", "registerMenuCommand", "unregisterMenuCommand", "download", "getTab", "getTabs", "saveTab", "openInTab", "notification", "getResourceURL", "getResourceText", "xmlhttpRequest", "log", "info"];
-declare const GMwindow: readonly ["unsafeWindow", "window.onurlchange", "window.focus", "window.close"];
-
-type RunAt = 'document-start' | 'document-body' | 'document-end' | 'document-idle' | 'context-menu';
-type GMLiterals<T extends string> = [`GM_${T}` | `GM.${T}`];
-type GMWindow = typeof GMwindow[number];
-type Grants = GMWindow | GMLiterals<typeof GM[number]>[number];
-type HeaderConfig = {
-    [property: string]: any;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:name
-     */
-    name: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:namespace
-     */
-    namespace?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:copyright
-     */
-    copyright?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:version
-     */
-    version: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:description
-     */
-    description?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:icon
-     */
-    icon?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:icon
-     */
-    iconURL?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:icon
-     */
-    defaulticon?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:icon64
-     */
-    icon64?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:icon64
-     */
-    icon64URL?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:grant
-     */
-    grant?: Grants[];
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:author
-     */
-    author?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:homepage
-     */
-    homepage?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:homepage
-     */
-    homepageURL?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:homepage
-     */
-    website?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:homepage
-     */
-    source?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.phpmeta:antifeature
-     */
-    antifeature?: [type: string, description: string][];
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:require
-     */
-    require?: string[] | string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:resource
-     */
-    resource?: [key: string, value: string][];
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:include
-     */
-    include?: string[] | string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:match
-     * @see https://violentmonkey.github.io/api/metadata-block/#match--exclude-match
-     */
-    match: string[] | string;
-    /**
-     * @see https://violentmonkey.github.io/api/metadata-block/#match--exclude-match
-     */
-    'exclude-match'?: string[] | string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:exclude
-     */
-    exclude?: string[] | string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:run_at
-     */
-    'run-at'?: RunAt;
-    /**
-     * @see https://www.tampermonkey.net/documentation.phpmeta:sandbox
-     */
-    sandbox?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:connect
-     */
-    connect?: string[] | string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:noframes
-     */
-    noframes?: boolean;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:updateURL
-     */
-    updateURL?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:downloadURL
-     */
-    downloadURL?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:supportURL
-     */
-    supportURL?: string;
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:webRequest
-     */
-    webRequest?: string[];
-    /**
-     * @see https://www.tampermonkey.net/documentation.php#meta:unwrap
-     */
-    unwrap?: boolean;
-};
-interface ServerConfig {
-    /**
-     * {@link https://github.com/sindresorhus/get-port}
-     */
-    port?: number;
-    /**
-     * @default false
-     */
-    open?: boolean;
-}
-interface UserscriptPluginConfig {
-    /**
-     * Path of userscript entry.
-     */
-    entry: string;
-    /**
-     * Userscript header config.
-     *
-     * @see https://www.tampermonkey.net/documentation.php
-     */
-    header: HeaderConfig;
-    /**
-     * Server config.
-     */
-    server?: ServerConfig;
-}
-
-declare function UserscriptPlugin(config: UserscriptPluginConfig): PluginOption;
-
-export { UserscriptPluginConfig, UserscriptPlugin as default };