Merge pull request #2798 from SillyTavern/popup-command-styles Expand `/popup` command and refactor a bit

01b6ddbf8af179a3210082c8b0b7f3050bf28d92

Cohee <18619528+Cohee1207@users.noreply.github.com>

Signed

Parents: 42b1a368cb385fc675b3ba3af512b48e32781e54 2385c5a59a4b729224678b1cfe8f8a2eb642974a

public/scripts/popup.js+2 -2 Viewed

      * @param {string?} header - The header text for the popup.
      * @param {string?} text - The main text for the popup.
      * @param {PopupOptions} [popupOptions={}] - Options for the popup.
      * @return {Promise<POPUP_RESULT?>} A Promise that resolves with the result of the user's interaction.
      */
     confirm: async (header, text, popupOptions = {}) => {
         const content = PopupUtils.BuildTextWithHeader(header, text);

      * @param {string?} header - The header text for the popup.
      * @param {string?} text - The main text for the popup.
      * @param {PopupOptions} [popupOptions={}] - Options for the popup.
      * @return {Promise<POPUP_RESULT?>} A Promise that resolves with the result of the user's interaction.
      */
     text: async (header, text, popupOptions = {}) => {
         const content = PopupUtils.BuildTextWithHeader(header, text);

public/scripts/slash-commands.js+65 -18 Viewed

         callback: popupCallback,
         returns: 'popup text',
         namedArgumentList: [
             new SlashCommandNamedArgument.fromProps({
 -                'large', 'show large popup', [ARGUMENT_TYPE.BOOLEAN], false, false, null, commonEnumProviders.boolean('onOff')(),
 +                name: 'large',
 -            ),
 +                description: 'show large popup',
 -            new SlashCommandNamedArgument(
 +                typeList: [ARGUMENT_TYPE.BOOLEAN],
 -                'wide', 'show wide popup', [ARGUMENT_TYPE.BOOLEAN], false, false, null, commonEnumProviders.boolean('onOff')(),
 +                enumList: commonEnumProviders.boolean('trueFalse')(),
 -            ),
 +                defaultValue: 'false',
 -            new SlashCommandNamedArgument(
 +            }),
 -                'okButton', 'text for the OK button', [ARGUMENT_TYPE.STRING], false,
 +            SlashCommandNamedArgument.fromProps({
 -            ),
 +                name: 'wide',
 +                description: 'show wide popup',
 +                typeList: [ARGUMENT_TYPE.BOOLEAN],
 +                enumList: commonEnumProviders.boolean('trueFalse')(),
 +                defaultValue: 'false',
 +            }),
 +            SlashCommandNamedArgument.fromProps({
 +                name: 'wider',
 +                description: 'show wider popup',
 +                typeList: [ARGUMENT_TYPE.BOOLEAN],
 +                enumList: commonEnumProviders.boolean('trueFalse')(),
 +                defaultValue: 'false',
 +            }),
 +            SlashCommandNamedArgument.fromProps({
 +                name: 'transparent',
 +                description: 'show transparent popup',
 +                typeList: [ARGUMENT_TYPE.BOOLEAN],
 +                enumList: commonEnumProviders.boolean('trueFalse')(),
 +                defaultValue: 'false',
 +            }),
 +            SlashCommandNamedArgument.fromProps({
 +                name: 'okButton',
 +                description: 'text for the OK button',
 +                typeList: [ARGUMENT_TYPE.STRING],
 +                defaultValue: 'OK',
 +            }),
 +            SlashCommandNamedArgument.fromProps({
 +                name: 'cancelButton',
 +                description: 'text for the Cancel button',
 +                typeList: [ARGUMENT_TYPE.STRING],
 +            }),
 +            SlashCommandNamedArgument.fromProps({
 +                name: 'result',
 +                description: 'if enabled, returns the popup result (as an integer) instead of the popup text. Resolves to 1 for OK and 0 cancel button, empty string for exiting out.',
 +                typeList: [ARGUMENT_TYPE.BOOLEAN],
 +                enumList: commonEnumProviders.boolean('trueFalse')(),
 +                defaultValue: 'false',
 +            }),
         ],
         unnamedArgumentList: [
             new SlashCommandArgument.fromProps({
 -                'text', [ARGUMENT_TYPE.STRING], true,
 +                description: 'popup text',
 -            ),
 +                typeList: [ARGUMENT_TYPE.STRING],
 +                isRequired: true,
 +            }),
         ],
         helpString: `
         <div>

             <strong>Example:</strong>
             <ul>
                 <li>
                     <pre><code>/popup large=on wide=on okButton="SubmitConfirm" EnterPlease someconfirm text:this action.</code></pre>
 +                </li>
 +                <li>
 +                    <pre><code>/popup okButton="Left" cancelButton="Right" result=true Do you want to go left or right? | /echo 0 means right, 1 means left. Choice: {{pipe}}</code></pre>
                 </li>
             </ul>
         </div>

+}
 async function popupCallback(args, value) {
     const safeValuesafeBody = DOMPurify.sanitize(value || '');
 +    const safeHeader = args?.header && typeof args?.header === 'string' ? DOMPurify.sanitize(args.header) : null;
 +    const requestedResult = isTrueBoolean(args?.result);
++
 +    /** @type {import('./popup.js').PopupOptions} */
     const popupOptions = {
         large: isTrueBoolean(args?.large),
         wide: isTrueBoolean(args?.wide),
 +        wider: isTrueBoolean(args?.wider),
 +        transparent: isTrueBoolean(args?.transparent),
         okButton: args?.okButton !== undefined && typeof args?.okButton === 'string' ? args.okButton : 'Ok',
 +        cancelButton: args?.cancelButton !== undefined && typeof args?.cancelButton === 'string' ? args.cancelButton : null,
     };
 -    await delay(1);
 +    const result = await Popup.show.text(safeHeader, safeBody, popupOptions);
 -    await callGenericPopup(safeValue, POPUP_TYPE.TEXT, '', popupOptions);
 +    return String(requestedResult ? result ?? '' : value);
 -    await delay(1);
 -    return String(value);
+}
 async function getMessagesCallback(args, value) {