@dittowords/cli 2.8.0 → 3.2.0-alpha

package/bin/utils/generateJsDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateJsDriver.js","sourceRoot":"","sources":["../../lib/utils/generateJsDriver.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AACxB,uDAA+B;AAC/B,uDAA+B;AAE/B,mDAAgD;AAEhD,6DAA6D;AAC7D,2CAA2C;AAC3C,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAE,EAAE,CAC9C,SAAS,KAAK,yBAAyB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,SAAS,EAAE,CAAC;AAE/E;;;;;;;;;;GAUG;AAEH,oBAAoB;AACpB,SAAgB,gBAAgB,CAAC,OAAiB;IAChD,MAAM,SAAS,GAAG,YAAE;SACjB,WAAW,CAAC,gBAAM,CAAC,QAAQ,CAAC;SAC5B,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAElD,MAAM,eAAe,GAA2B,OAAO,CAAC,MAAM,CAC5D,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;QACd,IAAI,MAAM,CAAC,QAAQ,EAAE;YACnB,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC,IAAA,6BAAa,EAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;SAChE;QAED,OAAO,GAAG,CAAC;IACb,CAAC,EACD,EAAE,CACH,CAAC;IAEF,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAC3B,CAAC,GAA2C,EAAE,QAAQ,EAAE,EAAE;QACxD,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEvC,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,YAAY,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAElD,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE;YACtB,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;SACxB;QAED,GAAG,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,GAAG,cAAc,QAAQ,IAAI,CAAC;QAC7D,OAAO,GAAG,CAAC;IACb,CAAC,EACD,EAAE,CACH,CAAC;IAEF,IAAI,UAAU,GAAG,oBAAoB,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QAClE,0CAA0C;SACzC,OAAO,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC;IAEhD,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,gBAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC3D,YAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAE7D,OAAO,+BAA+B,gBAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;AAChE,CAAC;AA1CD,4CA0CC"}

package/bin/utils/getSelectedProjects.js

@@ -27,9 +27,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getIsUsingComponents = exports.getSelectedProjects = void 0;
-const fs_1 = __importDefault(require("fs"));
 const js_yaml_1 = __importStar(require("js-yaml"));
 const consts_1 = require("../consts");
+const config_1 = __importDefault(require("../config"));
 function jsonIsConfigYAML(json) {
     return typeof json === "object";
 }
@@ -54,23 +54,8 @@ function yamlToJson(_yaml) {
  * Returns an array containing all valid projects ({ id, name })
  * currently contained in the project config file.
  */
-const getSelectedProjects = (configFile = consts_1.PROJECT_CONFIG_FILE) => {
-    if (!fs_1.default.existsSync(configFile))
-        return [];
-    const contentYaml = fs_1.default.readFileSync(configFile, "utf8");
-    const contentJson = yamlToJson(contentYaml);
-    if (!(contentJson && contentJson.projects)) {
-        return [];
-    }
-    return contentJson.projects.filter(({ name, id }) => name && id);
-};
+const getSelectedProjects = (configFile = consts_1.PROJECT_CONFIG_FILE) => config_1.default.parseSourceInformation(configFile).validProjects;
 exports.getSelectedProjects = getSelectedProjects;
-const getIsUsingComponents = (configFile = consts_1.PROJECT_CONFIG_FILE) => {
-    if (!fs_1.default.existsSync(configFile))
-        return false;
-    const contentYaml = fs_1.default.readFileSync(configFile, "utf8");
-    const contentJson = yamlToJson(contentYaml);
-    return !!contentJson && !!contentJson.components;
-};
+const getIsUsingComponents = (configFile = consts_1.PROJECT_CONFIG_FILE) => config_1.default.parseSourceInformation(configFile).shouldFetchComponentLibrary;
 exports.getIsUsingComponents = getIsUsingComponents;
 //# sourceMappingURL=getSelectedProjects.js.map

package/bin/utils/getSelectedProjects.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSelectedProjects.js","sourceRoot":"","sources":["../../lib/utils/getSelectedProjects.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,mDAA8C;AAE9C,sCAAgD;AAGhD,SAAS,gBAAgB,CAAC,IAAa;IACrC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC;AAClC,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI;QACF,IAAI,UAAU,GAAG,iBAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE;YACjC,OAAO,EAAE,CAAC;SACX;QACD,OAAO,UAAU,CAAC;KACnB;IAAC,OAAO,CAAC,EAAE;QACV,IAAI,CAAC,YAAY,uBAAa,EAAE;YAC9B,OAAO,IAAI,CAAC;SACb;aAAM;YACL,MAAM,CAAC,CAAC;SACT;KACF;AACH,CAAC;AAED;;;GAGG;AACI,MAAM,mBAAmB,GAAG,CACjC,UAAU,GAAG,4BAAmB,EACrB,EAAE;IACb,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IAE1C,MAAM,WAAW,GAAG,YAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAE5C,IAAI,CAAC,CAAC,WAAW,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE;QAC1C,OAAO,EAAE,CAAC;KACX;IAED,OAAO,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACnE,CAAC,CAAC;AAbW,QAAA,mBAAmB,uBAa9B;AAEK,MAAM,oBAAoB,GAAG,CAClC,UAAU,GAAG,4BAAmB,EACvB,EAAE;IACX,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7C,MAAM,WAAW,GAAG,YAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAE5C,OAAO,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC;AACnD,CAAC,CAAC;AATW,QAAA,oBAAoB,wBAS/B"}
+{"version":3,"file":"getSelectedProjects.js","sourceRoot":"","sources":["../../lib/utils/getSelectedProjects.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,mDAA8C;AAE9C,sCAAgD;AAEhD,uDAAwD;AAExD,SAAS,gBAAgB,CAAC,IAAa;IACrC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC;AAClC,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI;QACF,IAAI,UAAU,GAAG,iBAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE;YACjC,OAAO,EAAE,CAAC;SACX;QACD,OAAO,UAAU,CAAC;KACnB;IAAC,OAAO,CAAC,EAAE;QACV,IAAI,CAAC,YAAY,uBAAa,EAAE;YAC9B,OAAO,IAAI,CAAC;SACb;aAAM;YACL,MAAM,CAAC,CAAC;SACT;KACF;AACH,CAAC;AAED;;;GAGG;AACI,MAAM,mBAAmB,GAAG,CAAC,UAAU,GAAG,4BAAmB,EAAE,EAAE,CACtE,gBAAM,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,aAAa,CAAC;AAD7C,QAAA,mBAAmB,uBAC0B;AAEnD,MAAM,oBAAoB,GAAG,CAAC,UAAU,GAAG,4BAAmB,EAAE,EAAE,CACvE,gBAAM,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,2BAA2B,CAAC;AAD3D,QAAA,oBAAoB,wBACuC"}

package/bin/utils/projectsToText.js

@@ -3,14 +3,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSourceUrl = void 0;
 const output_1 = __importDefault(require("../output"));
+const getSourceUrl = (sourceId) => {
+    let base = "https://app.dittowords.com";
+    if (sourceId === "ditto_component_library") {
+        return `${base}/components`;
+    }
+    return `${base}/doc/${sourceId}`;
+};
+exports.getSourceUrl = getSourceUrl;
 const projectsToText = (projects) => {
     return ((projects || []).reduce((outputString, { name, id }) => outputString +
         ("\n" +
             "- " +
             output_1.default.info(name) +
             " " +
-            output_1.default.subtle("https://app.dittowords.com/doc/" + id)), "") + "\n");
+            output_1.default.subtle((0, exports.getSourceUrl)(id))), "") + "\n");
 };
 exports.default = projectsToText;
 //# sourceMappingURL=projectsToText.js.map

package/bin/utils/projectsToText.js.map

@@ -1 +1 @@
-{"version":3,"file":"projectsToText.js","sourceRoot":"","sources":["../../lib/utils/projectsToText.ts"],"names":[],"mappings":";;;;;AAAA,uDAA+B;AAG/B,MAAM,cAAc,GAAG,CAAC,QAAmB,EAAE,EAAE;IAC7C,OAAO,CACL,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CACrB,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAC7B,YAAY;QACZ,CAAC,IAAI;YACH,IAAI;YACJ,gBAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YACjB,GAAG;YACH,gBAAM,CAAC,MAAM,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC,EAC1D,EAAE,CACH,GAAG,IAAI,CACT,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,cAAc,CAAC"}
+{"version":3,"file":"projectsToText.js","sourceRoot":"","sources":["../../lib/utils/projectsToText.ts"],"names":[],"mappings":";;;;;;AAAA,uDAA+B;AAGxB,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAE,EAAE;IAC/C,IAAI,IAAI,GAAG,4BAA4B,CAAC;IAExC,IAAI,QAAQ,KAAK,yBAAyB,EAAE;QAC1C,OAAO,GAAG,IAAI,aAAa,CAAC;KAC7B;IAED,OAAO,GAAG,IAAI,QAAQ,QAAQ,EAAE,CAAC;AACnC,CAAC,CAAC;AARW,QAAA,YAAY,gBAQvB;AAEF,MAAM,cAAc,GAAG,CAAC,QAAmB,EAAE,EAAE;IAC7C,OAAO,CACL,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CACrB,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAC7B,YAAY;QACZ,CAAC,IAAI;YACH,IAAI;YACJ,gBAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YACjB,GAAG;YACH,gBAAM,CAAC,MAAM,CAAC,IAAA,oBAAY,EAAC,EAAE,CAAC,CAAC,CAAC,EACpC,EAAE,CACH,GAAG,IAAI,CACT,CAAC;AACJ,CAAC,CAAC;AAEF,kBAAe,cAAc,CAAC"}

package/bin/utils/promptForProject.js

@@ -5,10 +5,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const { AutoComplete } = require("enquirer");
 const output_1 = __importDefault(require("../output"));
+const projectsToText_1 = require("./projectsToText");
 function formatProjectChoice(project) {
-    return (project.name +
-        " " +
-        output_1.default.subtle(project.url || `https://app.dittowords.com/doc/${project.id}`));
+    return (project.name + " " + output_1.default.subtle(project.url || (0, projectsToText_1.getSourceUrl)(project.id)));
 }
 function parseResponse(response) {
     if (!response) {

package/bin/utils/promptForProject.js.map

@@ -1 +1 @@
-{"version":3,"file":"promptForProject.js","sourceRoot":"","sources":["../../lib/utils/promptForProject.ts"],"names":[],"mappings":";;;;;AAAA,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAE7C,uDAA+B;AAG/B,SAAS,mBAAmB,CAAC,OAAgB;IAC3C,OAAO,CACL,OAAO,CAAC,IAAI;QACZ,GAAG;QACH,gBAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,kCAAkC,OAAO,CAAC,EAAE,EAAE,CAAC,CAC7E,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,IAAI,CAAC,QAAQ,EAAE;QACb,OAAO,IAAI,CAAC;KACb;IAED,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAEjE,IAAI,EAAE,KAAK,KAAK,EAAE;QAChB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,yBAAyB,EAAE,CAAC;KAChD;IAED,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACtB,CAAC;AAQD,MAAM,gBAAgB,GAAG,KAAK,EAAE,EAC9B,OAAO,EACP,QAAQ,EACR,KAAK,GAAG,EAAE,GACU,EAAE,EAAE;IACxB,gBAAM,CAAC,EAAE,EAAE,CAAC;IAEZ,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;QAC9B,IAAI,EAAE,SAAS;QACf,OAAO;QACP,KAAK;QACL,OAAO;KACR,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC;IAEb,IAAI;QACF,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;KAC/B;IAAC,OAAO,CAAC,EAAE;QACV,oDAAoD;QACpD,4CAA4C;QAC5C,QAAQ,GAAG,IAAI,CAAC;KACjB;IAED,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,kBAAe,gBAAgB,CAAC"}
+{"version":3,"file":"promptForProject.js","sourceRoot":"","sources":["../../lib/utils/promptForProject.ts"],"names":[],"mappings":";;;;;AAAA,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAE7C,uDAA+B;AAE/B,qDAAgD;AAEhD,SAAS,mBAAmB,CAAC,OAAgB;IAC3C,OAAO,CACL,OAAO,CAAC,IAAI,GAAG,GAAG,GAAG,gBAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,IAAA,6BAAY,EAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAC5E,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,IAAI,CAAC,QAAQ,EAAE;QACb,OAAO,IAAI,CAAC;KACb;IAED,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAEjE,IAAI,EAAE,KAAK,KAAK,EAAE;QAChB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,yBAAyB,EAAE,CAAC;KAChD;IAED,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACtB,CAAC;AAQD,MAAM,gBAAgB,GAAG,KAAK,EAAE,EAC9B,OAAO,EACP,QAAQ,EACR,KAAK,GAAG,EAAE,GACU,EAAE,EAAE;IACxB,gBAAM,CAAC,EAAE,EAAE,CAAC;IAEZ,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;QAC9B,IAAI,EAAE,SAAS;QACf,OAAO;QACP,KAAK;QACL,OAAO;KACR,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC;IAEb,IAAI;QACF,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;KAC/B;IAAC,OAAO,CAAC,EAAE;QACV,oDAAoD;QACpD,4CAA4C;QAC5C,QAAQ,GAAG,IAAI,CAAC;KACjB;IAED,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,kBAAe,gBAAgB,CAAC"}

package/bin/utils/quit.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quit = void 0;
+function quit(message, exitCode = 2) {
+    console.log(`\n${message}\n`);
+    process.exitCode = exitCode;
+    process.exit();
+}
+exports.quit = quit;
+//# sourceMappingURL=quit.js.map

package/bin/utils/quit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quit.js","sourceRoot":"","sources":["../../lib/utils/quit.ts"],"names":[],"mappings":";;;AAAA,SAAgB,IAAI,CAAC,OAAe,EAAE,QAAQ,GAAG,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC5B,OAAO,CAAC,IAAI,EAAE,CAAC;AACjB,CAAC;AAJD,oBAIC"}

package/lib/add-project.ts

@@ -1,16 +1,11 @@
-import { collectAndSaveProject } from "./init/project";
+import { collectAndSaveSource } from "./init/project";
 import projectsToText from "./utils/projectsToText";
 import {
   getSelectedProjects,
   getIsUsingComponents,
 } from "./utils/getSelectedProjects";
 import output from "./output";
-
-function quit(exitCode = 2) {
-  console.log("Project selection was not updated.");
-  process.exitCode = exitCode;
-  process.exit();
-}
+import { quit } from "./utils/quit";
 
 const addProject = async () => {
   const projects = getSelectedProjects();
@@ -38,13 +33,15 @@ const addProject = async () => {
         )}`
       );
     }
-    await collectAndSaveProject(false);
+    await collectAndSaveSource({
+      components: false,
+    });
   } catch (error) {
     console.log(
       `\nSorry, there was an error adding a project to your workspace: `,
       error
     );
-    quit();
+    quit("Project selection was not updated.");
   }
 };
 

package/lib/config.ts

@@ -3,16 +3,30 @@ import path from "path";
 import url from "url";
 import yaml from "js-yaml";
 
+import output from "./output";
 import consts from "./consts";
 import { Project, ConfigYAML } from "./types";
 
-function createFileIfMissing(filename: string) {
+export const DEFAULT_CONFIG_JSON: ConfigYAML = {
+  sources: {
+    components: { enabled: true },
+  },
+  variants: true,
+  format: "flat",
+};
+
+export const DEFAULT_CONFIG = yaml.dump(DEFAULT_CONFIG_JSON);
+
+function createFileIfMissing(filename: string, defaultContents?: any) {
   const dir = path.dirname(filename);
 
+  // create the directory if it doesn't already exist
   if (!fs.existsSync(dir)) fs.mkdirSync(dir);
 
+  // create the file if it doesn't already exist
   if (!fs.existsSync(filename)) {
-    fs.closeSync(fs.openSync(filename, "w"));
+    // create the file, writing the `defaultContents` if provided
+    fs.writeFileSync(filename, defaultContents || "", "utf-8");
   }
 }
 
@@ -26,11 +40,13 @@ function jsonIsGlobalYAML(
   return (
     !!json &&
     typeof json === "object" &&
-    Object.values(json).every((arr) =>
-      arr.every(
-        (val: any) =>
-          typeof val === "object" && Object.keys(val).includes("token")
-      )
+    Object.values(json).every(
+      (arr) =>
+        (arr as any).every &&
+        arr.every(
+          (val: any) =>
+            typeof val === "object" && Object.keys(val).includes("token")
+        )
     )
   );
 }
@@ -45,7 +61,7 @@ function readProjectConfigData(
   file = consts.PROJECT_CONFIG_FILE,
   defaultData = {}
 ): ConfigYAML {
-  createFileIfMissing(file);
+  createFileIfMissing(file, DEFAULT_CONFIG);
   const fileContents = fs.readFileSync(file, "utf8");
   const yamlData = yaml.load(fileContents);
   if (jsonIsConfigYAML(yamlData)) {
@@ -73,10 +89,20 @@ function readGlobalConfigData(
   return defaultData;
 }
 
-function writeProjectConfigData(file: string, data: object) {
-  createFileIfMissing(file);
+function writeProjectConfigData(file: string, data: Partial<ConfigYAML>) {
+  createFileIfMissing(file, DEFAULT_CONFIG);
   const existingData = readProjectConfigData(file);
-  const yamlStr = yaml.dump({ ...existingData, ...data });
+
+  const configData: ConfigYAML = {
+    ...existingData,
+    ...data,
+    sources: {
+      ...existingData.sources,
+      ...data.sources,
+    },
+  };
+
+  const yamlStr = yaml.dump(configData);
   fs.writeFileSync(file, yamlStr, "utf8");
 }
 
@@ -160,14 +186,22 @@ function dedupeProjectName(projectNames: Set<string>, projectName: string) {
  * - an array of valid, deduped projects
  * - the `variants` and `format` config options
  */
-function parseSourceInformation() {
-  const { projects, components, variants, format, status, richText } =
-    readProjectConfigData();
+function parseSourceInformation(file?: string) {
+  const {
+    sources,
+    variants,
+    format,
+    status,
+    richText,
+    projects: projectsRoot,
+    components: componentsRoot,
+  } = readProjectConfigData(file);
+
+  const projects = sources?.projects || [];
 
   const projectNames = new Set<string>();
   const validProjects: Project[] = [];
-
-  let componentLibraryInProjects = false;
+  let hasComponentLibraryInProjects = false;
 
   (projects || []).forEach((project) => {
     const isValid = project.id && project.name;
@@ -176,7 +210,7 @@ function parseSourceInformation() {
     }
 
     if (project.id === "ditto_component_library") {
-      componentLibraryInProjects = true;
+      hasComponentLibraryInProjects = true;
       return;
     }
 
@@ -186,8 +220,7 @@ function parseSourceInformation() {
     validProjects.push(project);
   });
 
-  const shouldFetchComponentLibrary =
-    !!components || componentLibraryInProjects;
+  const shouldFetchComponentLibrary = Boolean(sources?.components?.enabled);
 
   const hasSourceData = !!validProjects.length || shouldFetchComponentLibrary;
 
@@ -199,6 +232,10 @@ function parseSourceInformation() {
     format,
     status,
     richText,
+    hasTopLevelProjectsField: !!projectsRoot,
+    hasTopLevelComponentsField: !!componentsRoot,
+    hasComponentLibraryInProjects,
+    componentFolders: sources?.components?.folders || null,
   };
 }
 

package/lib/ditto.ts

@@ -4,93 +4,144 @@ import { program } from "commander";
 // to use V8's code cache to speed up instantiation time
 import "v8-compile-cache";
 
-import { init, needsInit } from "./init/init";
-import { pull } from "./pull";
+import packageJson from "../package.json";
 
+import { init, needsTokenOrSource } from "./init/init";
+import { pull } from "./pull";
+import { quit } from "./utils/quit";
 import addProject from "./add-project";
 import removeProject from "./remove-project";
+import { replace } from "./replace";
+import { generateSuggestions } from "./generate-suggestions";
+
 import processMetaOption from "./utils/processMetaOption";
 
-/**
- * Catch and report unexpected error.
- * @param {any} error The thrown error object.
- * @returns {void}
- */
-function quit(exitCode = 2) {
-  console.log("\nExiting Ditto CLI...\n");
-  process.exitCode = exitCode;
-  process.exit();
-}
+const VERSION = packageJson.version;
+
+type Command =
+  | "pull"
+  | "project"
+  | "project add"
+  | "project remove"
+  | "generate-suggestions"
+  | "replace";
+
+const COMMANDS = [
+  {
+    name: "pull",
+    description: "Sync copy from Ditto into the current working directory",
+  },
+  {
+    name: "project",
+    description: "Add a Ditto project to sync copy from",
+    commands: [
+      {
+        name: "add",
+        description: "Add a Ditto project to sync copy from",
+      },
+      {
+        name: "remove",
+        description: "Stop syncing copy from a Ditto project",
+      },
+    ],
+  },
+  {
+    name: "generate-suggestions",
+    description: "Find text that can be potentially replaced with Ditto text",
+  },
+  {
+    name: "replace",
+    description: "Find and replace Ditto text with code",
+  },
+] as const;
 
 const setupCommands = () => {
   program.name("ditto-cli");
-  program
-    .command("pull")
-    .description("Sync copy from Ditto into working directory")
-    .action(() => checkInit("pull"));
-
-  const projectDescription = "Add a Ditto project to sync copy from";
-  const projectCommand = program
-    .command("project")
-    .description(projectDescription)
-    .action(() => checkInit("project"));
-
-  projectCommand
-    .command("add")
-    .description(projectDescription)
-    .action(() => checkInit("project"));
-
-  projectCommand
-    .command("remove")
-    .description("Stop syncing copy from a Ditto project")
-    .action(() => checkInit("project remove"));
+
+  COMMANDS.forEach((commandConfig) => {
+    const cmd = program
+      .command(commandConfig.name)
+      .description(commandConfig.description)
+      .action((str, options) => executeCommand(commandConfig.name, options));
+
+    if ("commands" in commandConfig) {
+      commandConfig.commands.forEach((nestedCommand) => {
+        cmd
+          .command(nestedCommand.name)
+          .description(nestedCommand.description)
+          .action((str, options) =>
+            executeCommand(
+              `${commandConfig.name} ${nestedCommand.name}`,
+              options
+            )
+          );
+      });
+    }
+  });
 };
 
 const setupOptions = () => {
   program.option(
     "-m, --meta <data...>",
-    "Optional metadata for this command to send arbitrary data to the backend. Ex: -m githubActionRequest:true trigger:manual"
+    "Include arbitrary data in requests to the Ditto API. Ex: -m githubActionRequest:true trigger:manual"
   );
+  program.version(VERSION, "-v, --version", "Output the current version");
 };
 
-const checkInit = async (command: string) => {
-  if (needsInit() && command !== "project remove") {
+const executeCommand = async (
+  command: Command | "none",
+  options: string[]
+): Promise<void> => {
+  const needsInitialization = needsTokenOrSource();
+  if (needsInitialization) {
     try {
       await init();
-      if (command === "pull") main(); // re-run to actually pull text now that init is finished
     } catch (error) {
-      quit();
+      quit("Exiting Ditto CLI...");
+      return;
+    }
+  }
+
+  const { meta } = program.opts();
+  switch (command) {
+    case "none":
+    case "pull": {
+      return pull({ meta: processMetaOption(meta) });
+    }
+    case "project":
+    case "project add": {
+      // initialization already includes the selection of a source,
+      // so if `project add` is called during initialization, don't
+      // prompt the user to select a source again
+      if (needsInitialization) return;
+
+      return addProject();
+    }
+    case "project remove": {
+      return removeProject();
     }
-  } else {
-    const { meta } = program.opts();
-    switch (command) {
-      case "pull":
-        pull({ meta: processMetaOption(meta) });
-        break;
-      case "project":
-      case "project add":
-        addProject();
-        break;
-      case "project remove":
-        removeProject();
-        break;
-      case "none":
-        setupCommands();
-        program.help();
-        break;
-      default:
-        quit();
+    case "generate-suggestions": {
+      return generateSuggestions();
+    }
+    case "replace": {
+      return replace(options);
+    }
+    default: {
+      quit("Exiting Ditto CLI...");
+      return;
     }
   }
 };
 
 const main = async () => {
+  setupCommands();
+  setupOptions();
+
   if (process.argv.length <= 2 && process.argv[1].includes("ditto-cli")) {
-    await checkInit("none");
-  } else {
-    setupCommands();
-    setupOptions();
+    await executeCommand("none", []);
+    return;
   }
+
   program.parse(process.argv);
 };
 

package/lib/generate-suggestions.test.ts

@@ -0,0 +1,65 @@
+import fs from "fs/promises";
+import path from "path";
+import { findTextInJSXFiles } from "./generate-suggestions";
+
+describe("findTextInJSXFiles", () => {
+  async function createTempFile(filename, content) {
+    const filePath = path.join(".", filename);
+    await fs.writeFile(filePath, content);
+    return filePath;
+  }
+
+  async function deleteTempFile(filename) {
+    const filePath = path.join(".", filename);
+    await fs.unlink(filePath);
+  }
+
+  it("should return an empty array when no files are found", async () => {
+    const result = await findTextInJSXFiles(".", "searchString");
+
+    expect(result).toEqual([]);
+  });
+
+  it("should return an empty array when searchString is not found in any file", async () => {
+    const file1 = await createTempFile("file1.jsx", "<div>No match</div>");
+    const file2 = await createTempFile("file2.tsx", "<div>No match</div>");
+
+    const result = await findTextInJSXFiles(".", "searchString");
+
+    expect(result).toEqual([]);
+
+    await deleteTempFile(file1);
+    await deleteTempFile(file2);
+  });
+
+  it("should return an array with correct occurrences when searchString is found", async () => {
+    const file1 = await createTempFile(
+      "file1.jsx",
+      `<div>Test searchString and another searchString</div>`
+    );
+
+    const expectedResult = [
+      {
+        file: file1,
+        occurrences: [
+          {
+            lineNumber: 1,
+            preview:
+              "<div>Test {{searchString}} and another searchString</div>",
+          },
+          {
+            lineNumber: 1,
+            preview:
+              "<div>Test searchString and another {{searchString}}</div>",
+          },
+        ],
+      },
+    ];
+
+    const result = await findTextInJSXFiles(".", "searchString");
+
+    expect(result).toEqual(expectedResult);
+
+    await deleteTempFile(file1);
+  });
+});