🤖 Merge PR DefinitelyTyped#71873 [twine-sugarcube] fixes for missing properties added in 2.37.0 by @rohal12

Co-authored-by: Your Name <[email protected]>

Author: rohal12

types/twine-sugarcube/extensions.d.ts

@@ -683,6 +683,13 @@ declare global {
          * $('#the-box').wiki('Who //are// you?'); // Appends "Who <em>are</em> you?" to the target element
          */
         wiki(...sources: string[]): this;
+
+        /**
+         * Wikifies the passage by the given name and appends the result to the target element(s). Returns a reference to the current jQuery object for chaining.
+         * @param name The name of the passage.
+         * @since SugarCube 2.37.0
+         */
+        wikiPassage(name: string): void;
     }
 
     interface JQueryStatic {

types/twine-sugarcube/settings.d.ts

@@ -202,6 +202,23 @@ export interface SettingsAPI {
      * @since 2.0.0
      */
     save(): void;
+
+    /**
+     * Returns the setting's current value.
+     *
+     * **NOTE**: Calling this method is equivalent to using settings[name].
+     * @since 2.37.0
+     */
+    getValue(name: string): any;
+
+    /**
+     * Sets the setting's value.
+     *
+     * **NOTE**: This method automatically calls the Setting.save() method.
+     * **WARNING**: If manually changing a setting that has an associated control, be mindful that the value you set makes sense for the setting in question, elsewise shenanigans could occur—e.g., don't set a range-type setting to non-number or out-of-range values.
+     * @since 2.37.0
+     */
+    setValue(name: string, value: any): void;
 }
 
 export {};

types/twine-sugarcube/test/extensions.ts

@@ -100,6 +100,7 @@ RegExp.escape(s);
 
 const j: JQuery = $(s).ariaDisabled(true);
 $(s).wiki(s);
+$(s).wikiPassage(s);
 $.wiki(s);
 $.wikiPassage(s);
 

types/twine-sugarcube/test/settings.ts

@@ -34,6 +34,8 @@ Setting.addList("list", {
     desc: "description",
 });
 
+Setting.setValue("blahKey", "blahValue"); // $ExpectType void
+Setting.getValue("blahKey"); // $ExpectType any
 Setting.load(); // $ExpectType void
 Setting.save(); // $ExpectType void
 Setting.reset(); // $ExpectType void

types/twine-sugarcube/test/ui.ts

@@ -32,6 +32,7 @@ Dialog.setup("Character Sheet", "charsheet");
 Dialog.wiki("Blah //blah// ''blah''.");
 Dialog.wiki(Story.get("PC Sheet").processText());
 Dialog.wiki(Story.get("PC Sheet").processText());
+Dialog.wikiPassage("PC Sheet");
 
 // #endregion
 

types/twine-sugarcube/ui.d.ts

@@ -122,6 +122,15 @@ export interface DialogAPI {
      * Dialog.wiki("Cry 'Havoc!', and let slip the //ponies// of ''friendship''.");
      */
     wiki(wikiMarkup: string): this;
+    /**
+     * Renders the passage by the given name and appends it to the dialog's content area. Returns a reference to the Dialog object for chaining.
+     *
+     * @param name The name of the passage to render.
+     * @since 2.37.0
+     * @example
+     * Dialog.wikiPassage("Inventory");
+     */
+    wikiPassage(name: string): this;
 }
 
 export interface FullscreenRequestOptions {