@popclip/types 1.4688.0 → 1.4892.0

package/README.md

@@ -3,3 +3,8 @@
 Typescript definitions for PopClip Extensions.
 
 Published to NPM as `@popclip/types`.
+
+To bum npm version, check in first, then bump:
+
+    npm version [<version>|patch]
+    npm publish

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@popclip/types",
-  "version": "1.4688.0",
+  "version": "1.4892.0",
   "devDependencies": {
     "typedoc": "0.25.13",
     "typescript": "5.4.5"

package/popclip.d.ts

@@ -476,7 +476,7 @@ interface Extension<CustomOptions = Options> extends ActionProperties {
 	/**
 	 * Exported test function for use during development.
 	 */
-	test: TestFunction;
+	test?: TestFunction;
 
 	// the following are static properties, included for the benefit of the JSON Scheme generation
 	popclipVersion?: number;
@@ -1137,6 +1137,19 @@ interface Util {
 			| BigUint64Array,
 	): void;
 
+	/**
+	 * Generate a random integer in range [0, max] with uniform distribution using a cryptographically secure random source.
+	 *
+	 * @example
+	 *
+	 * ```js
+	 * const coinFlip = util.randomUniform(1); // coinFlip has value 0 or 1
+	 * const dieRoll = util.randomUniform(5) + 1; // dieRoll has value from 1 to 6
+	 * ```
+	 * @param max Maximum value to generate. Supplied value will be coerced to a 32-bit unsigned integer.
+	 */
+	randomUniform(max: number): number;
+
 	/**
 	 * Generate a RFC 4122 version 4 UUID using a cryptographically secure random number generator.
 	 * @returns UUID string such as "e621e1f8-c36c-495a-93fc-0c247a3e6e5f".