extwee 2.3.14 → 2.3.15

package/src/StoryFormat.js

@@ -5,9 +5,7 @@ import { valid } from 'semver';
  * 
  * This class has type checking on all of its properties.
  * If a property is set to a value of the wrong type, a TypeError will be thrown.
- * 
  * @see {@link https://github.com/iftechfoundation/twine-specs/blob/master/twine-2-storyformats-spec.md Twine 2 Story Formats Specification}
- * 
  * @class
  * @classdesc A class representing a Twine 2 story format.
  * @property {string} name - The name of the story format.
@@ -107,6 +105,7 @@ export default class StoryFormat {
   get name () { return this.#_name; }
 
   /**
+   * Set name.
    * @param {string} n - Replacement name.
    */
   set name (n) {
@@ -124,6 +123,7 @@ export default class StoryFormat {
   get version () { return this.#_version; }
 
   /**
+   * Set version.
    * @param {string} n - Replacement version.
    */
   set version (n) {
@@ -141,6 +141,7 @@ export default class StoryFormat {
   get description () { return this.#_description; }
 
   /**
+   * Set description.
    * @param {string} d - Replacement description.
    */
   set description (d) {
@@ -158,6 +159,7 @@ export default class StoryFormat {
   get author () { return this.#_author; }
 
   /**
+   * Set author.
    * @param {string} a - Replacement author.
    */
   set author (a) {
@@ -175,6 +177,7 @@ export default class StoryFormat {
   get image () { return this.#_image; }
 
   /**
+   * Set image.
    * @param {string} i - Replacement image.
    */
   set image (i) {
@@ -192,6 +195,7 @@ export default class StoryFormat {
   get url () { return this.#_url; }
 
   /**
+   * Set URL.
    * @param {string} u - Replacement URL.
    */
   set url (u) {
@@ -209,6 +213,7 @@ export default class StoryFormat {
   get license () { return this.#_license; }
 
   /**
+   * Set license.
    * @param {string} l - Replacement license.
    */
   set license (l) {
@@ -226,6 +231,7 @@ export default class StoryFormat {
   get proofing () { return this.#_proofing; }
 
   /**
+   * Set proofing.
    * @param {boolean} p - Replacement proofing.
    */
   set proofing (p) {
@@ -243,6 +249,7 @@ export default class StoryFormat {
   get source () { return this.#_source; }
 
   /**
+   * Set source.
    * @param {string} s - Replacement source.
    */
   set source (s) {
@@ -255,7 +262,7 @@ export default class StoryFormat {
 
   /**
    * Produces a string representation of the story format object.
-   * @method toString
+   * @function toString
    * @returns {string} - A string representation of the story format.
    */
   toString() {
@@ -264,7 +271,7 @@ export default class StoryFormat {
 
   /**
    * Produces a JSON representation of the story format object.
-   * @method toJSON
+   * @function toJSON
    * @returns {object} - A JSON representation of the story format.
    */
   toJSON() {

package/src/TWS/parse.js

@@ -21,7 +21,7 @@ function parse (binaryFileContents) {
   const parser = new Parser();
 
   // Set default value.
-  let pythonObject = null;
+  let pythonObject;
 
   // Does the Buffer contain pickle data?
   try {
@@ -29,7 +29,7 @@ function parse (binaryFileContents) {
     pythonObject = parser.parse(binaryFileContents);
   } catch (error) {
     // This is a Buffer, but not pickle data.
-    throw new TypeError(`Error: Buffer does not contain Python pickle data! ${error}`);
+    throw new TypeError(`Error: Buffer does not contain Python pickle data! ${error}`, { cause: error });
   }
 
   // Create Story object.

package/src/Twee/parse.js

@@ -119,7 +119,7 @@ function parse (fileContents) {
     throw new Error('Contents not a String');
   }
 
-  let adjusted = '';
+  let adjusted;
 
   // Check if there are extra content in the files
   // If so, cut it all out for the parser
@@ -143,8 +143,8 @@ function parse (fileContents) {
     // Set default values
     let tags = '';
     let metadata = '';
-    let text = '';
-    let name = '';
+    let text;
+    let name;
 
     // Header is everything to the first newline
     let header = passage.slice(0, passage.indexOf('\n'));

package/src/Twine1HTML/compile.js

@@ -21,36 +21,36 @@ function compile (story, engine = '', header = '', name = '', codeJS = '', confi
   }
 
   // Replace the "VERSION" with story.creator.
-  header = header.replaceAll(/"VERSION"/gm, story.creator);
+  header = header.replaceAll(/"VERSION"/gm, () => story.creator);
 
   // Replace the "TIME" with new Date().
-  header = header.replaceAll(/"TIME"/gm, new Date());
+  header = header.replaceAll(/"TIME"/gm, () => String(new Date()));
 
   // Replace the ENGINE with `engine.js` code.
-  header = header.replaceAll(/"ENGINE"/gm, engine);
+  header = header.replaceAll(/"ENGINE"/gm, () => engine);
 
   // Replace the NAME (e.g. "JONAH") with `engine.js` code.
-  header = header.replaceAll(`"${name.toUpperCase()}"`, codeJS);
+  header = header.replaceAll(`"${name.toUpperCase()}"`, () => codeJS);
 
   // Replace "STORY_SIZE".
-  header = header.replaceAll(/"STORY_SIZE"/gm, `"${story.size()}"`);
+  header = header.replaceAll(/"STORY_SIZE"/gm, () => `"${story.size()}"`);
 
   // Replace "STORY" with Twine 1 HTML.
-  header = header.replaceAll(/"STORY"/gm, story.toTwine1HTML());
+  header = header.replaceAll(/"STORY"/gm, () => story.toTwine1HTML());
 
   // Replace START_AT with ''.
-  header = header.replaceAll(/"START_AT"/gm, '\'\'');
+  header = header.replaceAll(/"START_AT"/gm, () => '\'\'');
 
   // Does 'jquery' exist?
   if (Object.prototype.hasOwnProperty.call(config, 'jquery')) {
     // Replace JQUERY with jQuery.
-    header = header.replaceAll(/"JQUERY"/gm, config.jquery);
+    header = header.replaceAll(/"JQUERY"/gm, () => config.jquery);
   }
 
   // Does 'modernizr' exist?
   if (Object.prototype.hasOwnProperty.call(config, 'modernizr')) {
     // Replace "MODERNIZR" with Modernizr.
-    header = header.replaceAll(/"MODERNIZR"/gm, config.modernizr);
+    header = header.replaceAll(/"MODERNIZR"/gm, () => config.modernizr);
   }
 
   // Return code.

package/types/src/Passage.d.ts

@@ -1,40 +1,40 @@
 /**
-  * Passage class.
-  * @class
-  * @classdesc Represents a passage in a Twine story.
-  * @property {string} name - Name of the passage.
-  * @property {Array} tags - Tags for the passage.
-  * @property {object} metadata - Metadata for the passage.
-  * @property {string} text - Text content of the passage.
-  * @method {string} toTwee - Return a Twee representation.
-  * @method {string} toJSON - Return JSON representation.
-  * @method {string} toTwine2HTML - Return Twine 2 HTML representation.
-  * @method {string} toTwine1HTML - Return Twine 1 HTML representation.
-  * @example
-  * const p = new Passage('Start', 'This is the start of the story.');
-  * console.log(p.toTwee());
-  * // :: Start
-  * // This is the start of the story.
-  * //
-  * console.log(p.toJSON());
-  * // {"name":"Start","tags":[],"metadata":{},"text":"This is the start of the story."}
-  * console.log(p.toTwine2HTML());
-  * // <tw-passagedata pid="1" name="Start" tags="" >This is the start of the story.</tw-passagedata>
-  * console.log(p.toTwine1HTML());
-  * // <div tiddler="Start" tags="" modifier="extwee" twine-position="10,10">This is the start of the story.</div>
-  * @example
-  * const p = new Passage('Start', 'This is the start of the story.', ['start', 'beginning'], {position: '10,10', size: '100,100'});
-  * console.log(p.toTwee());
-  * // :: Start [start beginning] {"position":"10,10","size":"100,100"}
-  * // This is the start of the story.
-  * //
-  * console.log(p.toJSON());
-  * // {"name":"Start","tags":["start","beginning"],"metadata":{"position":"10,10","size":"100,100"},"text":"This is the start of the story."}
-  * console.log(p.toTwine2HTML());
-  * // <tw-passagedata pid="1" name="Start" tags="start beginning" position="10,10" size="100,100">This is the start of the story.</tw-passagedata>
-  * console.log(p.toTwine1HTML());
-  * // <div tiddler="Start" tags="start beginning" modifier="extwee" twine-position="10,10">This is the start of the story.</div>
-  */
+ * Passage class.
+ * @class
+ * @classdesc Represents a passage in a Twine story.
+ * @property {string} name - Name of the passage.
+ * @property {Array} tags - Tags for the passage.
+ * @property {object} metadata - Metadata for the passage.
+ * @property {string} text - Text content of the passage.
+ * @function toTwee - Return a Twee representation.
+ * @function toJSON - Return JSON representation.
+ * @function toTwine2HTML - Return Twine 2 HTML representation.
+ * @function toTwine1HTML - Return Twine 1 HTML representation.
+ * @example
+ * const p = new Passage('Start', 'This is the start of the story.');
+ * console.log(p.toTwee());
+ * // :: Start
+ * // This is the start of the story.
+ * //
+ * console.log(p.toJSON());
+ * // {"name":"Start","tags":[],"metadata":{},"text":"This is the start of the story."}
+ * console.log(p.toTwine2HTML());
+ * // <tw-passagedata pid="1" name="Start" tags="" >This is the start of the story.</tw-passagedata>
+ * console.log(p.toTwine1HTML());
+ * // <div tiddler="Start" tags="" modifier="extwee" twine-position="10,10">This is the start of the story.</div>
+ * @example
+ * const p = new Passage('Start', 'This is the start of the story.', ['start', 'beginning'], {position: '10,10', size: '100,100'});
+ * console.log(p.toTwee());
+ * // :: Start [start beginning] {"position":"10,10","size":"100,100"}
+ * // This is the start of the story.
+ * //
+ * console.log(p.toJSON());
+ * // {"name":"Start","tags":["start","beginning"],"metadata":{"position":"10,10","size":"100,100"},"text":"This is the start of the story."}
+ * console.log(p.toTwine2HTML());
+ * // <tw-passagedata pid="1" name="Start" tags="start beginning" position="10,10" size="100,100">This is the start of the story.</tw-passagedata>
+ * console.log(p.toTwine1HTML());
+ * // <div tiddler="Start" tags="start beginning" modifier="extwee" twine-position="10,10">This is the start of the story.</div>
+ */
 export default class Passage {
     /**
      * Create a passage.
@@ -45,6 +45,7 @@ export default class Passage {
      */
     constructor(name?: string, text?: string, tags?: any[], metadata?: object);
     /**
+     * Set passage name.
      * @param {string} s - Name to replace
      * @throws {Error} Name must be a String!
      */
@@ -55,6 +56,7 @@ export default class Passage {
      */
     get name(): string;
     /**
+     * Set passage tags.
      * @param {Array} t - Replacement array
      * @throws {Error} Tags must be an array!
      */
@@ -65,6 +67,7 @@ export default class Passage {
      */
     get tags(): any[];
     /**
+     * Set passage metadata.
      * @param {object} m - Replacement object
      * @throws {Error} Metadata must be an object literal!
      */
@@ -75,6 +78,7 @@ export default class Passage {
      */
     get metadata(): object;
     /**
+     * Set passage text.
      * @param {string} t - Replacement text
      * @throws {Error} Text should be a String!
      */
@@ -88,28 +92,27 @@ export default class Passage {
      * Return a Twee representation.
      *
      * See: https://github.com/iftechfoundation/twine-specs/blob/master/twee-3-specification.md
-     *
-     * @method toTwee
+     * @function toTwee
      * @returns {string} String form of passage.
      */
     toTwee(): string;
     /**
      * Return JSON representation.
-     * @method toJSON
+     * @function toJSON
      * @returns {string} JSON string.
      */
     toJSON(): string;
     /**
      * Return Twine 2 HTML representation.
      * (Default Passage ID is 1.)
-     * @method toTwine2HTML
+     * @function toTwine2HTML
      * @param {number} pid - Passage ID (PID) to record in HTML.
      * @returns {string} Twine 2 HTML string.
      */
     toTwine2HTML(pid?: number): string;
     /**
      * Return Twine 1 HTML representation.
-     * @method toTwine1HTML
+     * @function toTwine1HTML
      * @returns {string} Twine 1 HTML string.
      */
     toTwine1HTML(): string;

package/types/src/Story.d.ts

@@ -8,22 +8,22 @@
  * @property {string} format - Story format of Story.
  * @property {string} formatVersion - Story format version of Story.
  * @property {number} zoom - Zoom level.
- * @property {Array} passages - Array of Passage objects. @see {@link Passage}
+ * @property {Array} passages - Array of Passage objects. See {@link Passage}.
  * @property {string} creator - Program used to create Story.
  * @property {string} creatorVersion - Version used to create Story.
  * @property {object} metadata - Metadata of Story.
  * @property {object} tagColors - Tag Colors
  * @property {string} storyJavaScript - Story JavaScript
  * @property {string} storyStylesheet - Story Stylesheet
- * @method {number} addPassage - Add a passage to the story and returns the new length of the passages array.
- * @method {number} removePassageByName - Remove a passage from the story by name and returns the new length of the passages array.
- * @method {Array} getPassagesByTag - Find passages by tag.
- * @method {Array} getPassageByName - Find passage by name.
- * @method {number} size - Size (number of passages).
- * @method {string} toJSON - Export Story as JSON representation.
- * @method {string} toTwee - Return Twee representation.
- * @method {string} toTwine2HTML - Return Twine 2 HTML representation.
- * @method {string} toTwine1HTML - Return Twine 1 HTML representation.
+ * @function addPassage - Add a passage to the story and returns the new length of the passages array.
+ * @function removePassageByName - Remove a passage from the story by name and returns the new length of the passages array.
+ * @function getPassagesByTag - Find passages by tag.
+ * @function getPassageByName - Find passage by name.
+ * @function size - Size (number of passages).
+ * @function toJSON - Export Story as JSON representation.
+ * @function toTwee - Return Twee representation.
+ * @function toTwine2HTML - Return Twine 2 HTML representation.
+ * @function toTwine1HTML - Return Twine 1 HTML representation.
  * @example
  * const story = new Story('My Story');
  * story.IFID = '12345678-1234-5678-1234-567812345678';
@@ -41,6 +41,7 @@ export class Story {
      */
     constructor(name?: string);
     /**
+     * Set story name.
      * @param {string} a - Replacement story name
      */
     set name(a: string);
@@ -50,6 +51,7 @@ export class Story {
      */
     get name(): string;
     /**
+     * Set tag colors.
      * @param {object} a - Replacement tag colors
      */
     set tagColors(a: object);
@@ -59,6 +61,7 @@ export class Story {
      */
     get tagColors(): object;
     /**
+     * Set story IFID.
      * @param {string} i - Replacement IFID.
      */
     set IFID(i: string);
@@ -68,6 +71,7 @@ export class Story {
      */
     get IFID(): string;
     /**
+     * Set start passage name.
      * @param {string} s - Replacement start
      */
     set start(s: string);
@@ -77,6 +81,7 @@ export class Story {
      */
     get start(): string;
     /**
+     * Set story format version.
      * @param {string} f - Replacement format version
      */
     set formatVersion(f: string);
@@ -86,6 +91,7 @@ export class Story {
      */
     get formatVersion(): string;
     /**
+     * Set story metadata.
      * @param {object} o - Replacement metadata
      */
     set metadata(o: object);
@@ -95,6 +101,7 @@ export class Story {
      */
     get metadata(): object;
     /**
+     * Set story format.
      * @param {string} f - Replacement format
      */
     set format(f: string);
@@ -104,6 +111,7 @@ export class Story {
      */
     get format(): string;
     /**
+     * Set creator program.
      * @param {string} c - Creator Program of Story
      */
     set creator(c: string);
@@ -113,6 +121,7 @@ export class Story {
      */
     get creator(): string;
     /**
+     * Set creator version.
      * @param {string} c - Version of creator program
      */
     set creatorVersion(c: string);
@@ -122,6 +131,7 @@ export class Story {
      */
     get creatorVersion(): string;
     /**
+     * Set zoom level.
      * @param {number} n - Replacement zoom level
      */
     set zoom(n: number);
@@ -142,9 +152,10 @@ export class Story {
      * Passages in Story.
      * @returns {Array} Passages
      * @property {Array} passages - Passages
-    */
+     */
     get passages(): any[];
     /**
+     * Set story stylesheet.
      * @param {string} s - Replacement story stylesheet
      */
     set storyStylesheet(s: string);
@@ -166,41 +177,41 @@ export class Story {
     /**
      * Add a passage to the story.
      * Passing `StoryData` will override story metadata and `StoryTitle` will override story name.
-     * @method addPassage
+     * @function addPassage
      * @param {Passage} p - Passage to add to Story.
      * @returns {number} Return new length of passages array.
      */
     addPassage(p: Passage): number;
     /**
      * Remove a passage from the story by name.
-     * @method removePassageByName
+     * @function removePassageByName
      * @param {string} name - Passage name to remove.
      * @returns {number} Return new length of passages array.
      */
     removePassageByName(name: string): number;
     /**
      * Find passages by tag.
-     * @method getPassagesByTag
+     * @function getPassagesByTag
      * @param {string} t - Passage name to search for
      * @returns {Array} Return array of passages
      */
     getPassagesByTag(t: string): any[];
     /**
      * Find passage by name.
-     * @method getPassageByName
+     * @function getPassageByName
      * @param {string} name - Passage name to search for
      * @returns {Passage | null} Return passage or null
      */
     getPassageByName(name: string): Passage | null;
     /**
      * Size (number of passages).
-     * @method size
+     * @function size
      * @returns {number} Return number of passages
      */
     size(): number;
     /**
      * Export Story as JSON representation.
-     * @method toJSON
+     * @function toJSON
      * @returns {string} JSON string.
      */
     toJSON(): string;
@@ -209,8 +220,7 @@ export class Story {
      *
      * See: Twee 3 Specification
      * (https://github.com/iftechfoundation/twine-specs/blob/master/twee-3-specification.md)
-     *
-     * @method toTwee
+     * @function toTwee
      * @returns {string} Twee String
      */
     toTwee(): string;
@@ -233,8 +243,7 @@ export class Story {
      * Because story stylesheet data can be represented as a passage, property value, or both, all approaches are encoded.
      *
      * Because story JavaScript can be represented as a passage, property value, or both, all approaches are encoded.
-     *
-     * @method toTwine2HTML
+     * @function toTwine2HTML
      * @returns {string} Twine 2 HTML string
      */
     toTwine2HTML(): string;
@@ -243,13 +252,12 @@ export class Story {
      *
      * See: Twine 1 HTML Output
      * (https://github.com/iftechfoundation/twine-specs/blob/master/twine-1-htmloutput-doc.md)
-     *
-     * @method toTwine1HTML
+     * @function toTwine1HTML
      * @returns {string} Twine 1 HTML string.
      */
     toTwine1HTML(): string;
     #private;
 }
 export const creatorName: "extwee";
-export const creatorVersion: "2.3.14";
+export const creatorVersion: "2.3.15";
 import Passage from './Passage.js';

package/types/src/StoryFormat.d.ts

@@ -3,9 +3,7 @@
  *
  * This class has type checking on all of its properties.
  * If a property is set to a value of the wrong type, a TypeError will be thrown.
- *
  * @see {@link https://github.com/iftechfoundation/twine-specs/blob/master/twine-2-storyformats-spec.md Twine 2 Story Formats Specification}
- *
  * @class
  * @classdesc A class representing a Twine 2 story format.
  * @property {string} name - The name of the story format.
@@ -32,6 +30,7 @@
 export default class StoryFormat {
     constructor(name?: string, version?: string, description?: string, author?: string, image?: string, url?: string, license?: string, proofing?: boolean, source?: string);
     /**
+     * Set name.
      * @param {string} n - Replacement name.
      */
     set name(n: string);
@@ -41,6 +40,7 @@ export default class StoryFormat {
      */
     get name(): string;
     /**
+     * Set version.
      * @param {string} n - Replacement version.
      */
     set version(n: string);
@@ -50,6 +50,7 @@ export default class StoryFormat {
      */
     get version(): string;
     /**
+     * Set description.
      * @param {string} d - Replacement description.
      */
     set description(d: string);
@@ -59,6 +60,7 @@ export default class StoryFormat {
      */
     get description(): string;
     /**
+     * Set author.
      * @param {string} a - Replacement author.
      */
     set author(a: string);
@@ -68,6 +70,7 @@ export default class StoryFormat {
      */
     get author(): string;
     /**
+     * Set image.
      * @param {string} i - Replacement image.
      */
     set image(i: string);
@@ -77,6 +80,7 @@ export default class StoryFormat {
      */
     get image(): string;
     /**
+     * Set URL.
      * @param {string} u - Replacement URL.
      */
     set url(u: string);
@@ -86,6 +90,7 @@ export default class StoryFormat {
      */
     get url(): string;
     /**
+     * Set license.
      * @param {string} l - Replacement license.
      */
     set license(l: string);
@@ -95,6 +100,7 @@ export default class StoryFormat {
      */
     get license(): string;
     /**
+     * Set proofing.
      * @param {boolean} p - Replacement proofing.
      */
     set proofing(p: boolean);
@@ -104,6 +110,7 @@ export default class StoryFormat {
      */
     get proofing(): boolean;
     /**
+     * Set source.
      * @param {string} s - Replacement source.
      */
     set source(s: string);
@@ -114,13 +121,13 @@ export default class StoryFormat {
     get source(): string;
     /**
      * Produces a string representation of the story format object.
-     * @method toString
+     * @function toString
      * @returns {string} - A string representation of the story format.
      */
     toString(): string;
     /**
      * Produces a JSON representation of the story format object.
-     * @method toJSON
+     * @function toJSON
      * @returns {object} - A JSON representation of the story format.
      */
     toJSON(): object;