@popclip/types 1.4586.2 → 1.4604.1

package/package.json

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

package/popclip.d.ts

@@ -152,7 +152,7 @@ interface AssociatedApp {
  * @param context Information about the context surrounding the selection. (Same object as  {@link PopClip.context}.)
  * @returns A single action, an array of actions.
  */
-type PopulationFunction<CustomOptions extends Options = Options> = (
+type PopulationFunction<CustomOptions = Options> = (
 	input: Input,
 	options: CustomOptions,
 	context: Context,
@@ -413,7 +413,7 @@ interface ActionProperties extends IconProperties {
  * @param options Current values of the options for this extension. (Same object as  {@link PopClip.options}.)
  * @param context Information about the context surrounding the selection. (Same object as  {@link PopClip.context}.)
  */
-type ActionFunction<CustomOptions extends Options = Options> = (
+type ActionFunction<CustomOptions = Options> = (
 	input: Input,
 	options: CustomOptions & AuthOptions,
 	context: Context,
@@ -423,8 +423,7 @@ type ActionFunction<CustomOptions extends Options = Options> = (
  * **Action** represents the properties of a single action.
  * If `code` is omitted, the action displays a disabled title/icon only.
  */
-interface Action<CustomOptions extends Options = Options>
-	extends ActionProperties {
+interface Action<CustomOptions = Options> extends ActionProperties {
 	code?: ActionFunction<CustomOptions>;
 }
 
@@ -831,17 +830,22 @@ interface PopClip {
 	) => void;
 
 	/**
-	 * Display text inside PopClip's popup, with option to make the display a clickable button to
-	 * paste the text.
-	 * @param text The text to display. It will be truncated to 160 characters when shown.
-	 * @param options
+	 * Display text to the user.
+	 * @param text The text to display.
+	 * @param options Options.
 	 */
 	showText: (
 		text: string,
 		options?: {
 			/**
-			 * If `true`, and the app's Paste command is available, the displayed text will be in a cickable button,
-			 * which clicked, pastes the full text.
+			 * Display style:
+			 * - `compact` (default): Show the text inside PopClip's popup. It will be truncated to 160 characters when shown.
+			 * - `large`: Show as "Large Type" in full screen.
+			 */
+			style?: "compact" | "large";
+			/**
+			 * Applies to `compact` display mode only. If `true`, and the app's Paste command is available,
+			 * the displayed text will be in a clickable button, which clicked, pastes the full text.
 			 */
 			preview?: boolean;
 		},
@@ -1249,6 +1253,6 @@ declare function sleep(durationMilliseconds: number): Promise<void>;
  *
  * @param extension The extension object to export.
  */
-declare function defineExtension<CustomOptions extends Options = Options>(
+declare function defineExtension<CustomOptions = Options>(
 	extension: Extension<CustomOptions>,
 ): void;