Useful library for running a basic settings wizard.
Version vom
Dieses Skript sollte nicht direkt installiert werden. Es handelt sich hier um eine Bibliothek für andere Skripte, welche über folgenden Befehl in den Metadaten eines Skriptes eingebunden wird // @require https://update.greasyfork.org/scripts/405840/818921/Monkey%20Wizard.js
// ==UserScript==
// @name Monkey Wizard
// @namespace https://rafaelgssa.gitlab.io/monkey-scripts
// @author rafaelgssa
// @version 1.0.0
// @description Useful library for running a basic settings wizard.
// @require https://greasemonkey.github.io/gm4-polyfill/gm4-polyfill.js
// @require https://greasyfork.org/scripts/405831-monkey-storage/code/Monkey%20Storage.js?version=818910
// @require https://greasyfork.org/scripts/405813-monkey-utils/code/Monkey%20Utils.js?version=818882
// @grant GM.setValue
// @grant GM.getValue
// @grant GM.deleteValue
// @grant GM_setValue
// @grant GM_getValue
// @grant GM_deleteValue
// ==/UserScript==
/* global MonkeyStorage, MonkeyUtils */
/**
* @typedef {Object} MonkeyWizardSchema
* @property {'string' | 'number' | 'multi'} type
* @property {string} id
* @property {string} message
* @property {unknown} defaultValue
* @property {number} [min] Only available for 'number' type.
* @property {number} [max] Only available for 'number' type.
* @property {MonkeyWizardSchemaChoice[]} [choices] Only available for 'multi' type.
* @typedef {Object} MonkeyWizardSchemaChoice
* @property {string} id
* @property {string} template
* @property {unknown} value
*
*/
// eslint-disable-next-line
const MonkeyWizard = (() => {
let _id = '';
let _name = '';
/** @type {MonkeyWizardSchema[]} */
let _schemas = [];
/**
* Initializes the wizard.
* @param {string} id The ID to use for the wizard URL.
* @param {string} name The name to show in dialogs.
* @param {MonkeyWizardSchema[]} schemas The schemas for the settings.
* @returns {Promise<void>}
*/
const init = (id, name, schemas) => {
_id = id;
_name = name;
_schemas = schemas;
return run();
};
/**
* Runs the wizard.
* @returns {Promise<void>}
*/
const run = async () => {
if (window.location.search !== `?${_id}=wizard`) {
return;
}
const mainTitle = `${_name} Wizard`;
for (const schema of _schemas) {
const value = _readValue(mainTitle, schema);
MonkeyStorage.setSetting(schema.id, value);
}
await MonkeyStorage.saveSettings();
window.alert(`${mainTitle}\n\nDone!`);
};
/**
* Reads a value in the wizard.
* @param {string} mainTitle
* @param {MonkeyWizardSchema} schema
* @returns {unknown}
*/
const _readValue = (mainTitle, schema) => {
const title = `${mainTitle}\n\n${schema.message}`;
switch (schema.type) {
case 'string':
return _readStringValue(title);
case 'number':
return _readNumberValue(title, schema);
case 'multi':
return _readMultiValue(title, schema);
// no default
}
};
/**
* @param {string} title
* @returns {string}
*/
const _readStringValue = (title) => {
const inputValue = window.prompt(`${title} Enter the string.`);
return MonkeyUtils.isSet(inputValue) ? inputValue : '';
};
/**
* @param {string} title
* @param {MonkeyWizardSchema} schema
* @returns {number}
*/
const _readNumberValue = (title, schema) => {
let value = 0.0;
do {
const inputValue = window.prompt(
`${title} Enter the number from ${schema.min} to ${schema.max}.`
);
try {
value = MonkeyUtils.isSet(inputValue) ? parseFloat(inputValue) : 0.0;
if (Number.isNaN(value)) {
throw new Error('Invalid number');
}
} catch (err) {
// Value is not a number, just ignore.
value = 0.0;
}
} while (value < schema.min || value > schema.max);
return value;
};
/**
* @param {string} title
* @param {MonkeyWizardSchema} schema
* @returns {unknown}
*/
const _readMultiValue = (title, schema) => {
let choice;
const choiceList = schema.choices
.map((schemaChoice) => schemaChoice.template.replace(/%/, schemaChoice.id))
.join(' or ');
do {
const inputValue = window.prompt(`${title} Type ${choiceList}`);
choice = schema.choices.find((schemaChoice) => schemaChoice.id === inputValue);
} while (!MonkeyUtils.isSet(choice));
return choice.value;
};
return {
init,
run,
};
})();