highmark-cli 1.2.12 → 1.3.1

package/bin/action/setOptions.js

@@ -0,0 +1,39 @@
+"use strict";
+
+const setOptionsOperation = require("../operation/setOptions"),
+      linesPerPagePromptOperation = require("../operation/prompt/linesPerPage"),
+      contentsDepthPromptOperation = require("../operation/prompt/contentsDepth"),
+      charactersPerLinePromptOperation = require("../operation/prompt/charactersPerLine");
+
+const { retrieveOptions } = require("../configuration"),
+      { executeOperations } = require("../utilities/operation"),
+      { SUCCESSFUL_SET_OPTIONS_MESSAGE, FAILED_SET_OPTIONS_MESSAGE } = require("../messages");
+
+function setOptionsAction() {
+  const options = retrieveOptions(),
+        { linesPerPage,
+          contentsDepth,
+          charactersPerLine } = options,
+        operations = [
+          contentsDepthPromptOperation,
+          linesPerPagePromptOperation,
+          charactersPerLinePromptOperation,
+          setOptionsOperation
+        ],
+        context = {
+          linesPerPage,
+          contentsDepth,
+          charactersPerLine
+        };
+
+  executeOperations(operations, (completed) => {
+    const success = completed,  ///
+          message = success ?
+                      SUCCESSFUL_SET_OPTIONS_MESSAGE :
+                        FAILED_SET_OPTIONS_MESSAGE;
+
+    console.log(message);
+  }, context);
+}
+
+module.exports = setOptionsAction;

package/bin/commands.js

@@ -4,12 +4,14 @@ const HELP_COMMAND = "help",
       SERVER_COMMAND = "server",
       VERSION_COMMAND = "version",
       PUBLISH_COMMAND = 'publish',
-      INITIALISE_COMMAND = 'initialise';
+      INITIALISE_COMMAND = 'initialise',
+      SET_OPTIONS_COMMAND = "set-options";
 
 module.exports = {
   HELP_COMMAND,
   SERVER_COMMAND,
   VERSION_COMMAND,
   PUBLISH_COMMAND,
-  INITIALISE_COMMAND
+  INITIALISE_COMMAND,
+  SET_OPTIONS_COMMAND
 };

package/bin/configuration/version_1_2.js

@@ -2,22 +2,7 @@
 
 const { VERSION_1_2 } = require("../versions");
 
-const { DEFAULT_CONTENTS_DEPTH, DEFAULT_LINES_PER_PAGE, DEFAULT_CHARACTERS_PER_LINE } = require("../defaults");
-
-function createConfiguration() {
-  const version = VERSION_1_2,
-        linesPerPage = DEFAULT_LINES_PER_PAGE,
-        contentsDepth = DEFAULT_CONTENTS_DEPTH,
-        charactersPerLine = DEFAULT_CHARACTERS_PER_LINE,
-        configuration = {
-          version,
-          linesPerPage,
-          contentsDepth,
-          charactersPerLine
-        };
-
-  return configuration;
-}
+const { DEFAULT_LINES_PER_PAGE, DEFAULT_CHARACTERS_PER_LINE } = require("../defaults");
 
 function migrateToVersion1_2(json) {
   const version = VERSION_1_2,
@@ -33,6 +18,5 @@ function migrateToVersion1_2(json) {
   return json;
 }
 module.exports = {
-  createConfiguration,
   migrateToVersion1_2
 };

package/bin/configuration/version_1_3.js

@@ -0,0 +1,50 @@
+"use strict";
+
+const { VERSION_1_3 } = require("../versions");
+
+const { DEFAULT_CONTENTS_DEPTH, DEFAULT_LINES_PER_PAGE, DEFAULT_CHARACTERS_PER_LINE } = require("../defaults");
+
+function createConfiguration() {
+  const version = VERSION_1_3,
+        linesPerPage = DEFAULT_LINES_PER_PAGE,
+        contentsDepth = DEFAULT_CONTENTS_DEPTH,
+        charactersPerLine = DEFAULT_CHARACTERS_PER_LINE,
+        options = {
+          linesPerPage,
+          contentsDepth,
+          charactersPerLine
+        },
+        configuration = {
+          version,
+          options
+        };
+
+  return configuration;
+}
+
+function migrateToVersion1_3(json) {
+  const { linesPerPage,
+          contentsDepth,
+          charactersPerLine } = json,
+        version = VERSION_1_3,
+        options = {
+          linesPerPage,
+          contentsDepth,
+          charactersPerLine
+        };
+
+  delete json.linesPerPage;
+  delete json.contentsDepth;
+  delete json.charactersPerLine;
+
+  json = Object.assign({}, json, {
+    version,
+    options
+  });
+
+  return json;
+}
+module.exports = {
+  createConfiguration,
+  migrateToVersion1_3
+};

package/bin/configuration.js

@@ -3,10 +3,12 @@
 const { versionUtilities, configurationUtilities } = require("necessary");
 
 const { HIGHMARK } = require("./constants"),
-      { VERSION_1_0, VERSION_1_1, VERSION_1_2 } = require("./versions"),
       { migrateToVersion1_1 } = require("./configuration/version_1_1"),
-      { createConfiguration, migrateToVersion1_2 } = require("./configuration/version_1_2"),
-      { CONFIGURATION_FILE_DOES_NOT_EXIST_MESSAGE } = require("./messages");
+      { migrateToVersion1_2 } = require("./configuration/version_1_2"),
+      { serialiseJSON, unserialiseJSON } = require("./utilities/json"),
+      { createConfiguration, migrateToVersion1_3 } = require("./configuration/version_1_3"),
+      { CONFIGURATION_FILE_DOES_NOT_EXIST_MESSAGE } = require("./messages"),
+      { VERSION_1_0, VERSION_1_1, VERSION_1_2, VERSION_1_3 } = require("./versions");
 
 const { rc } = configurationUtilities,
       { migrate } = versionUtilities,
@@ -16,30 +18,25 @@ const rcBaseExtension = HIGHMARK; ///
 
 setRCBaseExtension(rcBaseExtension);
 
-function getLinesPerPage() {
-  const configuration = readConfigurationFile(),
-        { linesPerPage } = configuration;
-
-  return linesPerPage;
+function updateOptions(options) {
+  updateConfigurationFile({
+    options
+  });
 }
 
-function getContentsDepth() {
+function retrieveOptions() {
   const configuration = readConfigurationFile(),
-        { contentsDepth } = configuration;
+        { options } = configuration;
 
-  return contentsDepth;
+  return options;
 }
 
-function getCharactersPerLine() {
-  const configuration = readConfigurationFile(),
-        { charactersPerLine } = configuration;
+function createConfigurationFile() {
+  const configuration = createConfiguration();
 
-  return charactersPerLine;
-}
+  let json = configuration; ///
 
-function createConfigurationFile() {
-  const configuration = createConfiguration(),
-        json = configuration; ///
+  json = serialiseJSON(json); ///
 
   writeRCFile(json);
 }
@@ -49,14 +46,19 @@ function migrateConfigurationFile() {
 
   let json = readRCFile();
 
+  json = unserialiseJSON(json); ///
+
   const migrationMap = {
           [VERSION_1_0]: migrateToVersion1_1,
-          [VERSION_1_1]: migrateToVersion1_2
+          [VERSION_1_1]: migrateToVersion1_2,
+          [VERSION_1_2]: migrateToVersion1_3
         },
-        latestVersion = VERSION_1_2;
+        latestVersion = VERSION_1_3;
 
   json = migrate(json, migrationMap, latestVersion);
 
+  json = serialiseJSON(json); ///
+
   writeRCFile(json);
 }
 
@@ -78,9 +80,8 @@ function assertConfigurationFileExists() {
 }
 
 module.exports = {
-  getLinesPerPage,
-  getContentsDepth,
-  getCharactersPerLine,
+  updateOptions,
+  retrieveOptions,
   createConfigurationFile,
   migrateConfigurationFile,
   checkConfigurationFileExists,
@@ -90,8 +91,11 @@ module.exports = {
 function readConfigurationFile() {
   assertConfigurationFileExists();
 
-  const json = readRCFile(),
-        configuration = json; ///
+  let json = readRCFile();
+
+  json = unserialiseJSON(json); ///
+
+  const configuration = json; ///
 
   return configuration;
 }
@@ -99,7 +103,9 @@ function readConfigurationFile() {
 function writeConfigurationFile(configuration) {
   assertConfigurationFileExists();
 
-  const json = configuration; ///
+  let json = configuration; ///
+
+  json = serialiseJSON(json); ///
 
   writeRCFile(json);
 }
@@ -107,6 +113,12 @@ function writeConfigurationFile(configuration) {
 function updateConfigurationFile(addedConfiguration, ...deleteConfigurationNames) {
   assertConfigurationFileExists();
 
+  let json = addedConfiguration;  ///
+
+  json = serialiseJSON(json); ///
+
+  addedConfiguration = json;  ///
+
   const addedProperties = addedConfiguration, ///
         deletedPropertyNames = deleteConfigurationNames;  ///
 

package/bin/constants.js

@@ -2,8 +2,13 @@
 
 const FONT = "font",
       ERROR = "error",
+      STRING = "string",
+      NUMBER = "number",
+      BOOLEAN = "boolean",
       HIGHMARK = "highmark",
+      INFINITY = "Infinity",
       DOUBLE_DOTS = "..",
+      EMPTY_STRING = "",
       HIGHMARK_CLI = "Highmark-CLI",
       LIVE_RELOAD_PATH = "/live-reload",
       DIVS_SELECTOR_STRING = "body > div",
@@ -12,8 +17,13 @@ const FONT = "font",
 module.exports = {
   FONT,
   ERROR,
+  STRING,
+  NUMBER,
+  BOOLEAN,
   HIGHMARK,
+  INFINITY,
   DOUBLE_DOTS,
+  EMPTY_STRING,
   HIGHMARK_CLI,
   LIVE_RELOAD_PATH,
   DIVS_SELECTOR_STRING,

package/bin/defaults.js

@@ -8,7 +8,7 @@ const DEFAULT_HELP = false,
       DEFAULT_VERSION = false,
       DEFAULT_NO_CLIENT = false,
       DEFAULT_COPY_FONTS = false,
-      DEFAULT_LINES_PER_PAGE = 40,
+      DEFAULT_LINES_PER_PAGE = Infinity,
       DEFAULT_CONTENTS_DEPTH = 2,
       DEFAULT_INPUT_FILE_NAME = "default.md",
       DEFAULT_COPY_CLIENT_FILES = false,

package/bin/descriptions.js

@@ -0,0 +1,11 @@
+"use strict";
+
+const LINES_PER_PAGE_DESCRIPTION = "Lines per page (leave blank for default of Infinity): ",
+      CONTENTS_DEPTH_DESCRIPTION = "Contents depth (from 1 to 4): ",
+      CHARACTERS_PER_LINE_DESCRIPTION = "Characters per line: "
+
+module.exports = {
+  LINES_PER_PAGE_DESCRIPTION,
+  CONTENTS_DEPTH_DESCRIPTION,
+  CHARACTERS_PER_LINE_DESCRIPTION
+};

package/bin/jsonTypes.js

@@ -0,0 +1,13 @@
+"use strict";
+
+const NULL_JSON_TYPE = "null",
+      ARRAY_JSON_TYPE = "array",
+      OBJECT_JSON_TYPE = "object",
+      PRIMITIVE_JSON_TYPE = "primitive";
+
+module.exports = {
+  NULL_JSON_TYPE,
+  ARRAY_JSON_TYPE,
+  OBJECT_JSON_TYPE,
+  PRIMITIVE_JSON_TYPE
+};

package/bin/main.js

@@ -4,10 +4,11 @@ const helpAction = require("./action/help"),
       serverAction = require("./action/server"),
       versionAction = require("./action/version"),
       publishAction = require("./action/publish"),
-      initialiseAction = require("./action/initialise");
+      initialiseAction = require("./action/initialise"),
+      setOptionsAction = require("./action/setOptions");
 
 const { NO_COMMAND_GIVEN_MESSAGE, COMMAND_NOT_RECOGNISED_MESSAGE } = require("./messages"),
-      { HELP_COMMAND, SERVER_COMMAND, VERSION_COMMAND, PUBLISH_COMMAND, INITIALISE_COMMAND } = require("./commands"),
+      { HELP_COMMAND, SERVER_COMMAND, VERSION_COMMAND, PUBLISH_COMMAND, INITIALISE_COMMAND, SET_OPTIONS_COMMAND } = require("./commands"),
       { DEFAULT_PORT,
         DEFAULT_WATCH,
         DEFAULT_QUIETLY,
@@ -66,6 +67,12 @@ function main(command, argument, options) {
       break;
     }
 
+    case SET_OPTIONS_COMMAND: {
+      setOptionsAction();
+
+      break;
+    }
+
     default: {
       console.log(COMMAND_NOT_RECOGNISED_MESSAGE);
 

package/bin/messages.js

@@ -2,12 +2,17 @@
 
 const NO_COMMAND_GIVEN_MESSAGE = "No command has been given.",
       COMMAND_NOT_RECOGNISED_MESSAGE = "The command is not recognised.",
+      INVALID_LINES_PER_PAGE_MESSAGE = "The lines per page must either be a number or left blank for the default of Infinity, which effectively suppresses pagination.",
+      INVALID_CONTENTS_DEPTH_MESSAGE = "The contents depth must be a number between 1 and 4 inclusive, with 1 being primary headings only, 4 down to quaternary headings.",
+      INVALID_CHARACTERS_PER_LINE_MESSAGE = "The characters per line must a number.",
       FAILED_SERVER_MESSAGE = "Failed to serve.",
       FAILED_PUBLISH_MESSAGE = "Failed to publish.",
       FAILED_INITIALISE_MESSAGE = "Failed to create a configuration file because one is already present.",
+      FAILED_SET_OPTIONS_MESSAGE = "Failed to set the options.",
       SUCCESSFUL_SERVER_MESSAGE = "Served successfully.",
       SUCCESSFUL_PUBLISH_MESSAGE = "Published successfully.",
       SUCCESSFUL_INITIALISE_MESSAGE = "The configuration file has been created successfully.",
+      SUCCESSFUL_SET_OPTIONS_MESSAGE = "The options have been set successfully.",
       UNABLE_TO_COPY_FILE_MESSAGE = "Unable to copy the file.",
       UNABLE_TO_READ_FILE_MESSAGE = "Unable to read the file.",
       UNABLE_TO_WRITE_FILE_MESSAGE = "Unable to write the file.",
@@ -22,12 +27,17 @@ const NO_COMMAND_GIVEN_MESSAGE = "No command has been given.",
 module.exports = {
   NO_COMMAND_GIVEN_MESSAGE,
   COMMAND_NOT_RECOGNISED_MESSAGE,
+  INVALID_LINES_PER_PAGE_MESSAGE,
+  INVALID_CONTENTS_DEPTH_MESSAGE,
+  INVALID_CHARACTERS_PER_LINE_MESSAGE,
   FAILED_SERVER_MESSAGE,
   FAILED_PUBLISH_MESSAGE,
   FAILED_INITIALISE_MESSAGE,
+  FAILED_SET_OPTIONS_MESSAGE,
   SUCCESSFUL_SERVER_MESSAGE,
   SUCCESSFUL_PUBLISH_MESSAGE,
   SUCCESSFUL_INITIALISE_MESSAGE,
+  SUCCESSFUL_SET_OPTIONS_MESSAGE,
   UNABLE_TO_COPY_FILE_MESSAGE,
   UNABLE_TO_READ_FILE_MESSAGE,
   UNABLE_TO_WRITE_FILE_MESSAGE,

package/bin/operation/markdownHTML.js

@@ -6,10 +6,10 @@ const { processingUtilities } = require("highmark-markdown");
 const importer = require("../importer");
 
 const { readFile } = require("../utilities/fileSystem"),
+      { retrieveOptions } = require("../configuration"),
       { classNameFromFilePath } = require("../utilities/division"),
       { nodeFromTokens, tokensFromContent } = require("../utilities/markdown"),
-      { UNABLE_TO_CONVERT_MARKDOWN_TO_HTML_MESSAGE } = require("../messages"),
-      { getLinesPerPage, getContentsDepth, getCharactersPerLine } = require("../configuration");
+      { UNABLE_TO_CONVERT_MARKDOWN_TO_HTML_MESSAGE } = require("../messages");
 
 const { postprocess } = processingUtilities,
       { concatenatePaths } = pathUtilities;
@@ -44,9 +44,10 @@ function markdownHTMLOperation(proceed, abort, context) {
     return;
   }
 
-  const linesPerPage = getLinesPerPage(),
-        contentsDepth = getContentsDepth(),
-        charactersPerLine = getCharactersPerLine(),
+  const options = retrieveOptions(),
+        { linesPerPage,
+          contentsDepth,
+          charactersPerLine } = options,
         divisionClassName = className,  ///
         divisionMarkdownNode = node;  ///
 

package/bin/operation/markdownStylesCSS.js

@@ -1,7 +1,6 @@
 "use strict";
 
 const { constants } = require("highmark-client"),
-      { mediaTypeNames } = require("highmark-markdown"),
       { filePathUtilities } = require("occam-entities"),
       { cssUtilities, defaultMarkdownStyle } = require("highmark-markdown")
 
@@ -9,9 +8,8 @@ const { DIVS_SELECTOR_STRING } = require("../constants"),
       { classNameFromFilePath } = require("../utilities/division"),
       { readFile, readDirectory } = require("../utilities/fileSystem");
 
-const { WEB_MEDIA_TYPE_NAME } = mediaTypeNames,
-      { DIVS_SELECTOR_STRING: CLIENT_DIVS_SELECTOR_STRING } = constants,
-      { cssFromMarkdownStyleMediaTypeNameAndSelectorString } = cssUtilities,
+const { DIVS_SELECTOR_STRING: CLIENT_DIVS_SELECTOR_STRING } = constants,
+      { cssFromMarkdownStyleAndSelectorString } = cssUtilities,
       { isFilePathMarkdownStyleFilePath, isFilePathDefaultMarkdownStyleFilePath } = filePathUtilities;
 
 function markdownStylesCSSOperation(proceed, abort, context) {
@@ -36,15 +34,14 @@ function markdownStylesCSSOperation(proceed, abort, context) {
                            CLIENT_DIVS_SELECTOR_STRING :
                              DIVS_SELECTOR_STRING,
         markdownStyle = defaultMarkdownStyle, ///
-        mediaTypeName = WEB_MEDIA_TYPE_NAME,
-        defaultCSS = cssFromMarkdownStyleMediaTypeNameAndSelectorString(markdownStyle, mediaTypeName, selectorString);
+        defaultCSS = cssFromMarkdownStyleAndSelectorString(markdownStyle, selectorString);
 
   let markdownStylesCSS = defaultCSS; ///
 
   markdownStyleFilePaths.forEach((markdownStyleFilePath) => {
     const selectorString = selectorStringFromMarkdownStyleFilePathAndCopyClientFiles(markdownStyleFilePath, copyClientFiles),
           markdownStyle = markdownStyleFromMarkdownStyleFilePath(markdownStyleFilePath),
-          css = cssFromMarkdownStyleMediaTypeNameAndSelectorString(markdownStyle, mediaTypeName, selectorString, markdownStylesCSS);  ///
+          css = cssFromMarkdownStyleAndSelectorString(markdownStyle, selectorString, markdownStylesCSS);  ///
 
     markdownStylesCSS = `${markdownStylesCSS}${css}`;
   });

package/bin/operation/prompt/charactersPerLine.js

@@ -0,0 +1,45 @@
+"use strict";
+
+const { shellUtilities } = require("necessary");
+
+const { validateCharactersPerLine } = require("../../utilities/validate"),
+      { CHARACTERS_PER_LINE_DESCRIPTION } = require("../../descriptions"),
+      { INVALID_CHARACTERS_PER_LINE_MESSAGE } = require("../../messages");
+
+const { prompt } = shellUtilities;
+
+function contentsDepthPromptOperation(proceed, abort, context) {
+  const { charactersPerLine } = context,
+        description = CHARACTERS_PER_LINE_DESCRIPTION,
+        errorMessage = INVALID_CHARACTERS_PER_LINE_MESSAGE,
+        initialAnswer = `${charactersPerLine}`,
+        validationFunction = validateCharactersPerLine,  ///
+        options = {
+          description,
+          errorMessage,
+          initialAnswer,
+          validationFunction
+        };
+
+  prompt(options, (answer) => {
+    let charactersPerLine = answer;  ///
+
+    const valid = (charactersPerLine !== null);
+
+    if (valid) {
+      charactersPerLine = Number(charactersPerLine);
+
+      Object.assign(context, {
+        charactersPerLine
+      });
+
+      proceed();
+      
+      return;
+    }
+
+    abort();
+  });
+}
+
+module.exports = contentsDepthPromptOperation;

package/bin/operation/prompt/contentsDepth.js

@@ -0,0 +1,45 @@
+"use strict";
+
+const { shellUtilities } = require("necessary");
+
+const { validateContentsDepth } = require("../../utilities/validate"),
+      { CONTENTS_DEPTH_DESCRIPTION } = require("../../descriptions"),
+      { INVALID_CONTENTS_DEPTH_MESSAGE } = require("../../messages");
+
+const { prompt } = shellUtilities;
+
+function contentsDepthPromptOperation(proceed, abort, context) {
+  const { contentsDepth } = context,
+        description = CONTENTS_DEPTH_DESCRIPTION,
+        errorMessage = INVALID_CONTENTS_DEPTH_MESSAGE,
+        initialAnswer = `${contentsDepth}`,
+        validationFunction = validateContentsDepth,  ///
+        options = {
+          description,
+          errorMessage,
+          initialAnswer,
+          validationFunction
+        };
+
+  prompt(options, (answer) => {
+    let contentsDepth = answer;  ///
+
+    const valid = (contentsDepth !== null);
+
+    if (valid) {
+      contentsDepth = Number(contentsDepth);
+
+      Object.assign(context, {
+        contentsDepth
+      });
+
+      proceed();
+      
+      return;
+    }
+
+    abort();
+  });
+}
+
+module.exports = contentsDepthPromptOperation;

package/bin/operation/prompt/linesPerPage.js

@@ -0,0 +1,51 @@
+"use strict";
+
+const { shellUtilities } = require("necessary");
+
+const { validateLinesPerPage } = require("../../utilities/validate"),
+      { EMPTY_STRING } = require("../../constants"),
+      { DEFAULT_LINES_PER_PAGE } = require("../../defaults"),
+      { LINES_PER_PAGE_DESCRIPTION } = require("../../descriptions"),
+      { INVALID_LINES_PER_PAGE_MESSAGE } = require("../../messages");
+
+const { prompt } = shellUtilities;
+
+function linesPerPagePromptOperation(proceed, abort, context) {
+  const { linesPerPage } = context,
+        description = LINES_PER_PAGE_DESCRIPTION,
+        errorMessage = INVALID_LINES_PER_PAGE_MESSAGE,
+        initialAnswer = (linesPerPage === Infinity) ?
+                          EMPTY_STRING :
+                           `${linesPerPage}`,
+        validationFunction = validateLinesPerPage,  ///
+        options = {
+          description,
+          errorMessage,
+          initialAnswer,
+          validationFunction
+        };
+
+  prompt(options, (answer) => {
+    let linesPerPage = answer;  ///
+
+    const valid = (linesPerPage !== null);
+
+    if (valid) {
+      linesPerPage = (linesPerPage === EMPTY_STRING) ?
+                       DEFAULT_LINES_PER_PAGE :
+                         Number(linesPerPage);
+
+      Object.assign(context, {
+        linesPerPage
+      });
+
+      proceed();
+      
+      return;
+    }
+
+    abort();
+  });
+}
+
+module.exports = linesPerPagePromptOperation;

package/bin/operation/setOptions.js

@@ -0,0 +1,18 @@
+"use strict";
+
+const { updateOptions } = require("../configuration");
+
+function setOptionsOperation(proceed, abort, context) {
+  const { linesPerPage, contentsDepth, charactersPerLine } = context,
+        options = {
+          linesPerPage,
+          contentsDepth,
+          charactersPerLine
+        };
+
+  updateOptions(options);
+
+  proceed();
+}
+
+module.exports = setOptionsOperation;

package/bin/utilities/json.js

@@ -0,0 +1,162 @@
+"use strict";
+
+const { typeOf } = require("../utilities/type"),
+      { INFINITY } = require("../constants"),
+      { ARRAY_JSON_TYPE, OBJECT_JSON_TYPE, PRIMITIVE_JSON_TYPE } = require("../jsonTypes");
+
+function serialiseJSON(json) {
+  const type = typeOf(json);
+
+  switch (type) {
+    case ARRAY_JSON_TYPE: {
+      let array = json; ///
+
+      array = serialiseArray(array);  ///
+
+      json = array; ///
+
+      break;
+    }
+
+    case OBJECT_JSON_TYPE: {
+      let object = json;  ///
+
+      object = serialiseObject(object); ///
+
+      json = object;  ///
+
+      break;
+    }
+
+    case PRIMITIVE_JSON_TYPE: {
+      let primitive = json; ///
+
+      primitive = serialisePrimitive(primitive);  ///
+
+      json = primitive; ///
+
+      break;
+    }
+  }
+
+  return json;
+}
+
+function unserialiseJSON(json) {
+  const type = typeOf(json);
+
+  switch (type) {
+    case ARRAY_JSON_TYPE: {
+      let array = json; ///
+
+      array = unserialiseArray(array);  ///
+
+      json = array; ///
+
+      break;
+    }
+
+    case OBJECT_JSON_TYPE: {
+      let object = json;  ///
+
+      object = unserialiseObject(object); ///
+
+      json = object;  ///
+
+      break;
+    }
+
+    case PRIMITIVE_JSON_TYPE: {
+      let primitive = json; ///
+
+      primitive = unserialisePrimitive(primitive);  ///
+
+      json = primitive; ///
+
+      break;
+    }
+  }
+
+  return json;
+}
+
+module.exports = {
+  serialiseJSON,
+  unserialiseJSON
+};
+
+function serialiseArray(array) {
+  array = array.map((json) => {
+    json = serialiseJSON(json);  ///
+
+    return json;
+  });
+
+  return array;
+}
+
+function unserialiseArray(array) {
+  array = array.map((json) => {
+    json = unserialiseJSON(json);  ///
+
+    return json;
+  });
+
+  return array;
+}
+
+function serialiseObject(object) {
+  const keys = Object.keys(object),
+        values = Object.values(object);
+
+  object = keys.reduce((object, key, index) => {
+    let value = values[index],
+        json = value; //
+
+    json = serialiseJSON(json); ///
+
+    value = json; ///
+
+    object[key] = value;
+
+    return object;
+  }, {});
+
+  return object;
+}
+
+function unserialiseObject(object) {
+  const keys = Object.keys(object),
+        values = Object.values(object);
+
+  object = keys.reduce((object, key, index) => {
+    let value = values[index],
+        json = value; //
+
+    json = unserialiseJSON(json); ///
+
+    value = json; ///
+
+    object[key] = value;
+
+    return object;
+  }, {});
+
+  return object;
+}
+
+function serialisePrimitive(primitive) {
+  if (primitive === Infinity) {
+    primitive = INFINITY;
+  }
+
+  return primitive;
+}
+
+function unserialisePrimitive(primitive) {
+  if (primitive === INFINITY) {
+    primitive = Infinity;
+  }
+
+  return primitive;
+}

package/bin/utilities/type.js

@@ -0,0 +1,83 @@
+"use strict";
+
+const { STRING, NUMBER, BOOLEAN } = require("../constants"),
+      { NULL_JSON_TYPE, ARRAY_JSON_TYPE, OBJECT_JSON_TYPE, PRIMITIVE_JSON_TYPE } = require("../jsonTypes");
+
+function typeOf(json) {
+  let type;
+
+  const _null = isNull(json),
+        array = isArray(json),
+        object = isObject(json),
+        primitive = isPrimitive(json);
+
+  if (_null) {
+    type = NULL_JSON_TYPE;
+  }
+
+  if (array) {
+    type = ARRAY_JSON_TYPE;
+  }
+
+  if (object) {
+    type = OBJECT_JSON_TYPE;
+  }
+
+  if (primitive) {
+    type = PRIMITIVE_JSON_TYPE;
+  }
+
+  return type;
+}
+
+module.exports = {
+  typeOf
+};
+
+function isNull(json) {
+  const _null = (json === null);
+
+  return _null;
+}
+
+function isArray(json) {
+  const array = Array.isArray(json);
+
+  return array;
+}
+
+function isObject(json) {
+  const array = isArray(json),
+        primitive = isPrimitive(json),
+        object = (!array && !primitive);
+
+  return object;
+}
+
+function isString(json) {
+  const string = ((typeof json) === STRING);
+
+  return string;
+}
+
+function isNumber(json) {
+  const number = ((typeof json) === NUMBER);
+
+  return number;
+}
+
+function isBoolean(json) {
+  const boolean = ((typeof json) === BOOLEAN);
+
+  return boolean;
+}
+
+function isPrimitive(json) {
+  const _null = isNull(json),
+        string = isString(json),
+        number = isNumber(json),
+        boolean = isBoolean(json),
+        primitive = (_null || string || number || boolean);
+
+  return primitive;
+}

package/bin/utilities/validate.js

@@ -0,0 +1,13 @@
+"use strict";
+
+function validateLinesPerPage(linesPerPage) { return /^\d*$/.test(linesPerPage); }
+
+function validateContentsDepth(contentsDepth) { return /^1|2|3|4$/.test(contentsDepth); }
+
+function validateCharactersPerLine(charactersPerLine) { return /^\d+$/.test(charactersPerLine); }
+
+module.exports = {
+  validateLinesPerPage,
+  validateContentsDepth,
+  validateCharactersPerLine
+};

package/bin/versions.js

@@ -2,10 +2,12 @@
 
 const VERSION_1_0 = "1.0",
       VERSION_1_1 = "1.1",
-      VERSION_1_2 = "1.2";
+      VERSION_1_2 = "1.2",
+      VERSION_1_3 = "1.3";
 
 module.exports = {
   VERSION_1_0,
   VERSION_1_1,
-  VERSION_1_2
+  VERSION_1_2,
+  VERSION_1_3
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "highmark-cli",
   "author": "James Smith",
-  "version": "1.2.12",
+  "version": "1.3.1",
   "license": "MIT, Anti-996",
   "homepage": "https://github.com/djalbat/highmark-cli",
   "description": "Highmark's LIC tool.",
@@ -13,10 +13,10 @@
     "argumentative": "^2.0.28",
     "express": "^4.19.2",
     "highmark-client": "^0.0.98",
-    "highmark-markdown": "^0.0.426",
+    "highmark-markdown": "^0.0.430",
     "lively-cli": "^2.0.65",
     "necessary": "^14.0.1",
-    "occam-entities": "^1.0.111"
+    "occam-entities": "^1.0.112"
   },
   "bin": {
     "highmark": "./highmark.js"