extwee 2.0.6 → 2.2.1

package/test/JSON/JSON.Parse.test.js

@@ -0,0 +1,316 @@
+import { Story, creatorVersion, creatorName } from '../../src/Story.js';
+import Passage from '../../src/Passage.js';
+import { parse as parseJSON } from '../../src/JSON/parse.js';
+
+describe('JSON', () => {
+  describe('parse()', function () {
+    it('Should throw error if JSON is invalid', function () {
+      expect(() => { parseJSON('{'); }).toThrow();
+    });
+
+    it('Should roundtrip default Story values using toJSON() and fromJSON()', function () {
+      // Create Story.
+      const r = new Story();
+
+      // Convert to JSON and back.
+      const s = parseJSON(r.toJSON());
+
+      // Check all properties.
+      expect(s.name).toBe('');
+      expect(Object.keys(s.tagColors).length).toBe(0);
+      expect(s.IFID).toBe('');
+      expect(s.start).toBe('');
+      expect(s.formatVersion).toBe('');
+      expect(s.format).toBe('');
+      expect(s.creator).toBe(creatorName);
+      expect(s.creatorVersion).toBe(creatorVersion);
+      expect(s.zoom).toBe(0);
+      expect(Object.keys(s.metadata).length).toBe(0);
+    });
+
+    it('Should parse passage data', function () {
+      // Create passage.
+      const p = new Passage('Test', 'Default');
+
+      // Create Story.
+      const s = new Story();
+
+      // Add a passage.
+      s.addPassage(p);
+
+      // Convert to JSON.
+      const js = s.toJSON(s);
+
+      // Convert back to Story.
+      const result = parseJSON(js);
+
+      // Should have a single passage.
+      expect(result.size()).toBe(1);
+    });
+
+    describe('Partial Story Processing', function () {
+      it('Should parse everything but name', function () {
+        const s = '{"tagColors":{"r":"red"},"ifid":"dd","start":"Start","formatVersion":"1.0","metadata":{"some":"thing"},"format":"Snowman","creator":"extwee","creatorVersion":"2.2.0","zoom":1,"passages":[{"name":"Start","tags":["tag1"],"metadata":{},"text":"Word"}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(1);
+      });
+
+      it('Should parse everything but tagColors', function () {
+        const s = '{"name":"Test","ifid":"dd","start":"Start","formatVersion":"1.0","metadata":{"some":"thing"},"format":"Snowman","creator":"extwee","creatorVersion":"2.2.0","zoom":1,"passages":[{"name":"Start","tags":["tag1"],"metadata":{},"text":"Word"}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(0);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(1);
+      });
+
+      it('Should parse everything but ifid', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"start":"Start","formatVersion":"1.0","metadata":{"some":"thing"},"format":"Snowman","creator":"extwee","creatorVersion":"2.2.0","zoom":1,"passages":[{"name":"Start","tags":["tag1"],"metadata":{},"text":"Word"}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(1);
+      });
+
+      it('Should parse everything but start', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"ifid":"dd","formatVersion":"1.0","metadata":{"some":"thing"},"format":"Snowman","creator":"extwee","creatorVersion":"2.2.0","zoom":1,"passages":[{"name":"Star","tags":["tag1"],"metadata":{},"text":"Word"}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(1);
+      });
+
+      it('Should parse everything but formatVersion', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"ifid":"dd","start":"Start","metadata":{"some":"thing"},"format":"Snowman","creator":"extwee","creatorVersion":"2.2.0","zoom":1,"passages":[{"name":"Start","tags":["tag1"],"metadata":{},"text":"Word"}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(1);
+      });
+
+      it('Should parse everything but format', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"ifid":"dd","start":"Start","formatVersion":"1.0","metadata":{"some":"thing"},"creator":"extwee","creatorVersion":"2.2.0","zoom":1,"passages":[{"name":"Start","tags":["tag1"],"metadata":{},"text":"Word"}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(1);
+      });
+
+      it('Should parse everything but creator', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"ifid":"dd","start":"Start","formatVersion":"1.0","metadata":{"some":"thing"},"format":"Snowman","creatorVersion":"2.2.0","zoom":1,"passages":[{"name":"Start","tags":["tag1"],"metadata":{},"text":"Word"}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(1);
+      });
+
+      it('Should parse everything but creator version', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"ifid":"dd","start":"Start","formatVersion":"1.0","metadata":{"some":"thing"},"format":"Snowman","creator":"extwee","zoom":1,"passages":[{"name":"Start","tags":["tag1"],"metadata":{},"text":"Word"}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe(creatorVersion);
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(1);
+      });
+
+      it('Should parse everything but zoom', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"ifid":"dd","start":"Start","formatVersion":"1.0","metadata":{"some":"thing"},"format":"Snowman","creator":"extwee","creatorVersion":"2.2.0","passages":[{"name":"Start","tags":["tag1"],"metadata":{},"text":"Word"}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(0);
+        expect(r.size()).toBe(1);
+      });
+
+      it('Should parse everything but metadata', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"ifid":"dd","start":"Start","formatVersion":"1.0","format":"Snowman","creator":"extwee","creatorVersion":"2.2.0","zoom":1,"passages":[{"name":"Start","tags":["tag1"],"metadata":{},"text":"Word"}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(0);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(1);
+      });
+
+      it('Should parse everything but passages', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"ifid":"dd","start":"Start","formatVersion":"1.0","metadata":{"some":"thing"},"format":"Snowman","creator":"extwee","creatorVersion":"2.2.0","zoom":1}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(0);
+      });
+
+      it('Should ignore non-arrays for passages', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"ifid":"dd","start":"Start","formatVersion":"1.0","metadata":{"some":"thing"},"format":"Snowman","creator":"extwee","creatorVersion":"2.2.0","zoom":1,"passages":{}}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(0);
+      });
+
+      it('Should parse everything but passage name', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"ifid":"dd","start":"Start","formatVersion":"1.0","metadata":{"some":"thing"},"format":"Snowman","creator":"extwee","creatorVersion":"2.2.0","zoom":1,"passages":[{"tags":["tag1"],"metadata":{},"text":"Word"}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(1);
+        expect(r.getPassageByName('').name).toBe('');
+      });
+
+      it('Should parse everything but passage tags', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"ifid":"dd","start":"Start","formatVersion":"1.0","metadata":{"some":"thing"},"format":"Snowman","creator":"extwee","creatorVersion":"2.2.0","zoom":1,"passages":[{"name":"Start","metadata":{"s":"e"},"text":"Word"}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(1);
+        expect(r.getPassageByName('Start').metadata.s).toBe('e');
+        expect(r.getPassageByName('Start').tags.length).toBe(0);
+      });
+
+      it('Should parse everything but passage text', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"ifid":"dd","start":"Start","formatVersion":"1.0","metadata":{"some":"thing"},"format":"Snowman","creator":"extwee","creatorVersion":"2.2.0","zoom":1,"passages":[{"name":"Start","tags":["tag1"],"metadata":{"s":"e"}}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(1);
+        expect(r.getPassageByName('Start').metadata.s).toBe('e');
+        expect(r.getPassageByName('Start').text).toBe('');
+      });
+
+      it('Parse everything but passage metadata', function () {
+        const s = '{"name":"Test","tagColors":{"r":"red"},"ifid":"dd","start":"Start","formatVersion":"1.0","metadata":{"some":"thing"},"format":"Snowman","creator":"extwee","creatorVersion":"2.2.0","zoom":1,"passages":[{"name":"Start","tags":["tag1"],"text":"Word"}]}';
+        const r = parseJSON(s);
+        expect(r.name).toBe('Test');
+        expect(Object.keys(r.tagColors).length).toBe(1);
+        expect(r.IFID).toBe('DD');
+        expect(r.start).toBe('Start');
+        expect(r.formatVersion).toBe('1.0');
+        expect(Object.keys(r.metadata).length).toBe(1);
+        expect(r.format).toBe('Snowman');
+        expect(r.creator).toBe(creatorName);
+        expect(r.creatorVersion).toBe('2.2.0');
+        expect(r.zoom).toBe(1);
+        expect(r.size()).toBe(1);
+        expect(Object.prototype.hasOwnProperty.call(r.getPassageByName('Start').metadata, 's')).toBe(false);
+        expect(r.getPassageByName('Start').text).toBe('Word');
+      });
+    });
+  });
+});

package/test/Passage.test.js

@@ -1,104 +1,244 @@
-import Passage from '../src/Passage.js';
-
-describe('Passage', () => {
-  describe('#constructor()', () => {
-    it('Set default values', () => {
-      const p = new Passage();
-      expect(p.name).toBe('');
-      expect(p.tags).toHaveLength(0);
-      expect(p.text).toBe('');
-      expect(typeof p.metadata).toBe('object');
-      expect(p.pid).toBe(-1);
-    });
-  });
-
-  describe('name', () => {
-    it('Set name', () => {
-      const p = new Passage();
-      p.name = 'New';
-      expect(p.name).toBe('New');
-    });
-
-    it('Throw error if name is not String', () => {
-      const p = new Passage();
-      expect(() => {
-        p.name = 1;
-      }).toThrow();
-    });
-  });
-
-  describe('tags', () => {
-    it('Set tags', () => {
-      const p = new Passage();
-      p.tags = ['tag'];
-      expect(p.tags).toHaveLength(1);
-    });
-
-    it('Throw error if tags is not Array', () => {
-      const p = new Passage();
-      expect(() => {
-        p.tags = 1;
-      }).toThrow();
-    });
-  });
-
-  describe('metadata', () => {
-    it('Set metadata', () => {
-      const p = new Passage();
-      p.metadata = { position: '100,100' };
-      expect(p.metadata).toEqual({ position: '100,100' });
-    });
-
-    it('Throw error if metadata is not an Object', () => {
-      const p = new Passage();
-      expect(() => {
-        p.metadata = 1;
-      }).toThrow();
-    });
-  });
-
-  describe('text', () => {
-    it('Set text', () => {
-      const p = new Passage();
-      p.text = 'New';
-      expect(p.text).toBe('New');
-    });
-
-    it('Throw error if text is not a String', () => {
-      const p = new Passage();
-      expect(() => {
-        p.text = 1;
-      }).toThrow();
-    });
-  });
-
-  describe('pid', () => {
-    it('Set PID', () => {
-      const p = new Passage();
-      p.pid = 12;
-      expect(p.pid).toBe(12);
-    });
-
-    it('Throw error if pid is not a Number', () => {
-      const p = new Passage();
-      expect(() => {
-        p.pid = [];
-      }).toThrow();
-    });
-  });
-
-  describe('toString()', () => {
-    it('Create name string', () => {
-      const p = new Passage('Name', 'Test');
-      expect(p.toString()).toBe(':: Name\nTest\n\n');
-    });
-    it('Create tags string', () => {
-      const p = new Passage('Name', 'Test', ['tags', 'another']);
-      expect(p.toString()).toBe(':: Name [tags another]\nTest\n\n');
-    });
-    it('Create metadata string', () => {
-      const p = new Passage('Name', 'Test', ['tags', 'another'], { position: '100,100' });
-      expect(p.toString()).toBe(':: Name [tags another] {"position":"100,100"}\nTest\n\n');
-    });
-  });
-});
+import Passage from '../src/Passage.js';
+import { parse as HTMLParser } from 'node-html-parser';
+
+describe('Passage', () => {
+  describe('constructor()', () => {
+    it('Set default values', () => {
+      const p = new Passage();
+      expect(p.name).toBe('');
+      expect(p.tags).toHaveLength(0);
+      expect(p.text).toBe('');
+      expect(typeof p.metadata).toBe('object');
+    });
+  });
+
+  describe('name', () => {
+    it('Set name', () => {
+      const p = new Passage();
+      p.name = 'New';
+      expect(p.name).toBe('New');
+    });
+
+    it('Throw error if name is not String', () => {
+      const p = new Passage();
+      expect(() => {
+        p.name = 1;
+      }).toThrow();
+    });
+  });
+
+  describe('tags', () => {
+    it('Set tags', () => {
+      const p = new Passage();
+      p.tags = ['tag'];
+      expect(p.tags).toHaveLength(1);
+    });
+
+    it('Throw error if tags is not Array', () => {
+      const p = new Passage();
+      expect(() => {
+        p.tags = 1;
+      }).toThrow();
+    });
+  });
+
+  describe('metadata', () => {
+    it('Set metadata', () => {
+      const p = new Passage();
+      p.metadata = { position: '100,100' };
+      expect(p.metadata).toEqual({ position: '100,100' });
+    });
+
+    it('Throw error if metadata is not an Object', () => {
+      const p = new Passage();
+      expect(() => {
+        p.metadata = 1;
+      }).toThrow();
+    });
+  });
+
+  describe('text', () => {
+    it('Set text', () => {
+      const p = new Passage();
+      p.text = 'New';
+      expect(p.text).toBe('New');
+    });
+
+    it('Throw error if text is not a String', () => {
+      const p = new Passage();
+      expect(() => {
+        p.text = 1;
+      }).toThrow();
+    });
+  });
+
+  describe('toTwee()', () => {
+    it('Create name string', () => {
+      const p = new Passage('Name', 'Test');
+      expect(p.toTwee()).toBe(':: Name\nTest\n\n');
+    });
+    it('Create tags string', () => {
+      const p = new Passage('Name', 'Test', ['tags', 'another']);
+      expect(p.toTwee()).toBe(':: Name [tags another]\nTest\n\n');
+    });
+    it('Create metadata string', () => {
+      const p = new Passage('Name', 'Test', ['tags', 'another'], { position: '100,100' });
+      expect(p.toTwee()).toBe(':: Name [tags another] {"position":"100,100"}\nTest\n\n');
+    });
+  });
+
+  describe('toJSON()', function () {
+    it('Should hold default values', function () {
+      const p = new Passage();
+      const r = JSON.parse(p.toJSON());
+      expect(r.name).toBe('');
+      expect(r.text).toBe('');
+      expect(r.tags.length).toBe(0);
+      expect(Object.keys(r.metadata).length).toBe(0);
+    });
+  });
+
+  describe('toTwine2HTML()', function () {
+    let p = null;
+    let result = null;
+
+    beforeEach(() => {
+      p = new Passage('Test', 'Word', ['tag1'], { some: 'thing' });
+      result = p.toTwine2HTML();
+    });
+
+    it('Should contain default PID', function () {
+      expect(result.includes('pid="1"')).toBe(true);
+    });
+
+    it('Should include name', function () {
+      expect(result.includes('name="Test"')).toBe(true);
+    });
+
+    it('Should include single tag', function () {
+      expect(result.includes('tags="tag1"')).toBe(true);
+    });
+
+    it('Should include multiple tags', function () {
+      p.tags = ['tag1', 'tag2'];
+      result = p.toTwine2HTML();
+      expect(result.includes('tags="tag1 tag2"')).toBe(true);
+    });
+
+    it('Should include position, if it exists', function () {
+      p.metadata = { position: '102,99' };
+      result = p.toTwine2HTML();
+      expect(result.includes('position="102,99"')).toBe(true);
+    });
+
+    it('Should include size, if it exists', function () {
+      p.metadata = { size: '100,100' };
+      result = p.toTwine2HTML();
+      expect(result.includes('size="100,100"')).toBe(true);
+    });
+  });
+
+  describe('toTwine1HTML()', function () {
+    let p = null;
+    let result = null;
+
+    beforeEach(() => {
+      p = new Passage('Test', 'Word', ['tag1'], { position: '12, 12' });
+      result = p.toTwine1HTML();
+    });
+
+    it('Should include tiddler', function () {
+      expect(result.includes('tiddler="Test"')).toBe(true);
+    });
+
+    it('Should include single tag', function () {
+      expect(result.includes('tags="tag1"')).toBe(true);
+    });
+
+    it('Should include multiple tags', function () {
+      p.tags = ['tag1', 'tag2'];
+      result = p.toTwine1HTML();
+      expect(result.includes('tags="tag1 tag2"')).toBe(true);
+    });
+
+    it('Should include position, if it exists', function () {
+      p.metadata = { position: '102,99' };
+      result = p.toTwine1HTML();
+      expect(result.includes('position="102,99"')).toBe(true);
+    });
+
+    it('Should use default position', function () {
+      p.metadata = {};
+      result = p.toTwine1HTML();
+      expect(result.includes('position="10,10"')).toBe(true);
+    });
+  });
+
+  describe('Escaping', function () {
+    it('Should escape double quotes', function () {
+      const p = new Passage('Test', 'Word "word"');
+      expect(p.toTwine2HTML().includes('Word "word"')).toBe(true);
+    });
+
+    it('Should escape ampersands', function () {
+      const p = new Passage('Test', 'Word & word');
+      expect(p.toTwine2HTML().includes('Word & word')).toBe(true);
+    });
+
+    it('Should escape less than', function () {
+      const p = new Passage('Test', 'Word < word');
+      expect(p.toTwine2HTML().includes('Word &lt; word')).toBe(true);
+    });
+
+    it('Should escape greater than', function () {
+      const p = new Passage('Test', 'Word > word');
+      expect(p.toTwine2HTML().includes('Word &gt; word')).toBe(true);
+    });
+
+    it('Should escape all', function () {
+      const p = new Passage('Test', 'Word &<>"\' word');
+      expect(p.toTwine2HTML().includes('>Word &amp;&lt;&gt;&quot;&apos; word<')).toBe(true);
+    });
+
+    it('Should escape meta-characters safely in name', function () {
+      const p = new Passage('"Test"');
+      expect(p.toTwine2HTML().includes('name="&quot;Test&quot;"')).toBe(true);
+      expect(p.toTwine1HTML().includes('tiddler="&quot;Test&quot;"')).toBe(true);
+    });
+
+    it('Should escape meta-characters safely in text', function () {
+      const p = new Passage('Test', '"Word"');
+      expect(p.toTwine2HTML().includes('&quot;Word&quot;')).toBe(true);
+    });
+
+    it('Should escape meta-characters safely in tags', function () {
+      const p = new Passage('Test', 'Word', ['&tag', '"bad"']);
+      expect(p.toTwine2HTML().includes('tags="&amp;tag &quot;bad&quot;"')).toBe(true);
+      expect(p.toTwine1HTML().includes('tags="&amp;tag &quot;bad&quot;"')).toBe(true);
+    });
+
+    it('Should escape meta-characters safely in Twee header', function () {
+      const p = new Passage('Where do tags begin? [well',  '', ['hmm']);
+      expect(p.toTwee().includes('Where do tags begin? \[well [hmm]')).toBe(true);
+    });
+
+    it('Should produce valid HTML attributes', function () {
+      // Generate passage.
+      const p = new Passage('"Test"', '"Word"', ['&tag', '"bad"'], { position: '100,100' });
+      // Parse HTML.
+      const d = new HTMLParser(p.toTwine2HTML());
+      // Test attributes.
+      expect(d.querySelector('tw-passagedata').getAttribute('name')).toBe('"Test"');
+      expect(d.querySelector('tw-passagedata').getAttribute('tags')).toBe('&tag "bad"');
+      expect(d.querySelector('tw-passagedata').getAttribute('position')).toBe('100,100');
+      // Use Twine 2 result.
+      const s = `<tw-passagedata pid="1" name="&quot;Test&quot;" tags="&amp;tag &quot;bad&quot;" position="100,100" size="100,100"></tw-passagedata>`;
+      // Parse HTML.
+      const t = new HTMLParser(s);
+      // Test Twine 2 attributes.
+      expect(t.querySelector('tw-passagedata').getAttribute('name')).toBe('"Test"');
+      expect(t.querySelector('tw-passagedata').getAttribute('tags')).toBe('&tag "bad"');
+      expect(t.querySelector('tw-passagedata').getAttribute('position')).toBe('100,100');
+    });
+  });
+});