@cedarjs/cli 0.0.4

package/dist/commands/setup/server-file/serverFile.js

@@ -0,0 +1,31 @@
+import { recordTelemetryAttributes } from "@cedarjs/cli-helpers";
+const command = "server-file";
+const description = "Setup the server file";
+function builder(yargs) {
+  yargs.option("force", {
+    alias: "f",
+    default: false,
+    description: "Overwrite existing configuration",
+    type: "boolean"
+  }).option("verbose", {
+    alias: "v",
+    default: false,
+    description: "Print more logs",
+    type: "boolean"
+  });
+}
+async function handler(options) {
+  recordTelemetryAttributes({
+    command: "setup server-file",
+    force: options.force,
+    verbose: options.verbose
+  });
+  const { handler: handler2 } = await import("./serverFileHandler.js");
+  return handler2(options);
+}
+export {
+  builder,
+  command,
+  description,
+  handler
+};

package/dist/commands/setup/server-file/serverFileHandler.js

@@ -0,0 +1,56 @@
+import path from "path";
+import fs from "fs-extra";
+import { Listr } from "listr2";
+import { addApiPackages } from "@cedarjs/cli-helpers";
+import { errorTelemetry } from "@cedarjs/telemetry";
+import c from "../../../lib/colors.js";
+import { getPaths, transformTSToJS, writeFile } from "../../../lib/index.js";
+import { isTypeScriptProject } from "../../../lib/project.js";
+const { version } = JSON.parse(
+  fs.readFileSync(
+    path.resolve(import.meta.dirname, "../../../../package.json"),
+    "utf-8"
+  )
+);
+function setupServerFileTasks({ force = false } = {}) {
+  return [
+    {
+      title: "Adding the server file...",
+      task: async () => {
+        const ts = isTypeScriptProject();
+        const serverFilePath = path.join(
+          getPaths().api.src,
+          `server.${ts ? "ts" : "js"}`
+        );
+        const serverFileTemplateContent = fs.readFileSync(
+          path.join(import.meta.dirname, "templates", "server.ts.template"),
+          "utf-8"
+        );
+        const setupScriptContent = ts ? serverFileTemplateContent : await transformTSToJS(serverFilePath, serverFileTemplateContent);
+        return [
+          writeFile(serverFilePath, setupScriptContent, {
+            overwriteExisting: force
+          })
+        ];
+      }
+    },
+    addApiPackages([`@cedarjs/api-server@${version}`])
+  ];
+}
+async function handler({ force, verbose }) {
+  const tasks = new Listr(setupServerFileTasks({ force }), {
+    rendererOptions: { collapseSubtasks: false, persistentOutput: true },
+    renderer: verbose ? "verbose" : "default"
+  });
+  try {
+    await tasks.run();
+  } catch (e) {
+    errorTelemetry(process.argv, e.message);
+    console.error(c.error(e.message));
+    process.exit(e?.exitCode || 1);
+  }
+}
+export {
+  handler,
+  setupServerFileTasks
+};

package/dist/commands/setup/server-file/templates/server.ts.template

@@ -0,0 +1,13 @@
+import { createServer } from '@cedarjs/api-server'
+
+import { logger } from 'src/lib/logger'
+
+async function main() {
+  const server = await createServer({
+    logger,
+  })
+
+  await server.start()
+}
+
+main()

package/dist/commands/setup/tsconfig/tsconfig.js

@@ -0,0 +1,25 @@
+import { recordTelemetryAttributes } from "@cedarjs/cli-helpers";
+const command = "tsconfig";
+const description = "Set up tsconfig for web and api sides";
+const builder = (yargs) => {
+  yargs.option("force", {
+    alias: "f",
+    default: false,
+    description: "Overwrite existing tsconfig.json files",
+    type: "boolean"
+  });
+};
+const handler = async (options) => {
+  recordTelemetryAttributes({
+    command: "setup tsconfig",
+    force: options.force
+  });
+  const { handler: handler2 } = await import("./tsconfigHandler.js");
+  return handler2(options);
+};
+export {
+  builder,
+  command,
+  description,
+  handler
+};

package/dist/commands/setup/tsconfig/tsconfigHandler.js

@@ -0,0 +1,59 @@
+import path from "path";
+import { Listr } from "listr2";
+import { errorTelemetry } from "@cedarjs/telemetry";
+import c from "../../../lib/colors.js";
+import {
+  getInstalledCedarVersion,
+  getPaths,
+  saveRemoteFileToDisk
+} from "../../../lib/index.js";
+const handler = async ({ force }) => {
+  const installedRwVersion = await getInstalledCedarVersion();
+  const GITHUB_VERSION_TAG = installedRwVersion.match("canary") ? "main" : `v${installedRwVersion}`;
+  const CRWA_TEMPLATE_URL = `https://raw.githubusercontent.com/redwoodjs/redwood/${GITHUB_VERSION_TAG}/packages/create-cedar-app/templates/ts`;
+  const tasks = new Listr(
+    [
+      {
+        title: "Creating tsconfig in web",
+        task: () => {
+          const webConfigPath = path.join(getPaths().web.base, "tsconfig.json");
+          const templateUrl = `${CRWA_TEMPLATE_URL}/web/tsconfig.json`;
+          return saveRemoteFileToDisk(templateUrl, webConfigPath, {
+            overwriteExisting: force
+          });
+        }
+      },
+      {
+        title: "Creating tsconfig in api",
+        task: () => {
+          const webConfigPath = path.join(getPaths().api.base, "tsconfig.json");
+          const templateUrl = `${CRWA_TEMPLATE_URL}/api/tsconfig.json`;
+          return saveRemoteFileToDisk(templateUrl, webConfigPath, {
+            overwriteExisting: force
+          });
+        }
+      },
+      {
+        title: "One more thing...",
+        task: (_ctx, task) => {
+          task.title = `One more thing...
+
+          ${c.tip("Quick link to the docs on configuring TypeScript")}
+          ${c.link("https://redwoodjs.com/docs/typescript")}
+        `;
+        }
+      }
+    ],
+    { rendererOptions: { collapseSubtasks: false } }
+  );
+  try {
+    await tasks.run();
+  } catch (e) {
+    errorTelemetry(process.argv, e.message);
+    console.error(c.error(e.message));
+    process.exit(e?.exitCode || 1);
+  }
+};
+export {
+  handler
+};

package/dist/commands/setup/ui/helpers/helpers.js

@@ -0,0 +1,9 @@
+function createHandler(componentName) {
+  return async function handler(argv) {
+    const { handler: importedHandler } = await import(`../libraries/${componentName}Handler.js`);
+    return importedHandler(argv);
+  };
+}
+export {
+  createHandler
+};

package/dist/commands/setup/ui/libraries/chakra-ui.js

@@ -0,0 +1,24 @@
+import { createHandler } from "../helpers/helpers.js";
+const command = "chakra-ui";
+const description = "Set up Chakra UI";
+function builder(yargs) {
+  yargs.option("force", {
+    alias: "f",
+    default: false,
+    description: "Overwrite existing configuration",
+    type: "boolean"
+  });
+  yargs.option("install", {
+    alias: "i",
+    default: true,
+    description: "Install packages",
+    type: "boolean"
+  });
+}
+const handler = createHandler(command);
+export {
+  builder,
+  command,
+  description,
+  handler
+};

package/dist/commands/setup/ui/libraries/chakra-uiHandler.js

@@ -0,0 +1,98 @@
+import path from "path";
+import execa from "execa";
+import { Listr } from "listr2";
+import { recordTelemetryAttributes } from "@cedarjs/cli-helpers";
+import c from "../../../../lib/colors.js";
+import extendStorybookConfiguration from "../../../../lib/configureStorybook.js";
+import { extendJSXFile, fileIncludes } from "../../../../lib/extendFile.js";
+import { getPaths, writeFile } from "../../../../lib/index.js";
+const CHAKRA_THEME_AND_COMMENTS = `// This object will be used to override Chakra-UI theme defaults.
+// See https://chakra-ui.com/docs/styled-system/theming/theme for theming options
+const theme = {}
+export default theme
+`;
+async function handler({ force, install }) {
+  recordTelemetryAttributes({
+    command: "setup ui chakra-ui",
+    force,
+    install
+  });
+  const rwPaths = getPaths();
+  const packages = [
+    "@chakra-ui/react@^2",
+    "@emotion/react@^11",
+    "@emotion/styled@^11",
+    "framer-motion@^11"
+  ];
+  const tasks = new Listr(
+    [
+      {
+        title: "Installing packages...",
+        skip: () => !install,
+        task: () => {
+          return new Listr(
+            [
+              {
+                title: `Install ${packages.join(", ")}`,
+                task: async () => {
+                  await execa("yarn", ["workspace", "web", "add", ...packages]);
+                }
+              }
+            ],
+            { rendererOptions: { collapseSubtasks: false } }
+          );
+        }
+      },
+      {
+        title: "Setting up Chakra UI...",
+        skip: () => fileIncludes(rwPaths.web.app, "ChakraProvider"),
+        task: () => extendJSXFile(rwPaths.web.app, {
+          insertComponent: {
+            name: "ChakraProvider",
+            props: { theme: "extendedTheme" },
+            within: "RedwoodProvider",
+            insertBefore: "<ColorModeScript />"
+          },
+          imports: [
+            "import { ChakraProvider, ColorModeScript, extendTheme } from '@chakra-ui/react'",
+            "import * as theme from 'config/chakra.config'"
+          ],
+          moduleScopeLines: ["const extendedTheme = extendTheme(theme)"]
+        })
+      },
+      {
+        title: `Creating Theme File...`,
+        task: () => {
+          writeFile(
+            path.join(rwPaths.web.config, "chakra.config.js"),
+            CHAKRA_THEME_AND_COMMENTS,
+            { overwriteExisting: force }
+          );
+        }
+      },
+      {
+        title: "Configure Storybook...",
+        // skip this task if the user's storybook config already includes "withChakra"
+        skip: () => fileIncludes(rwPaths.web.storybookConfig, "withChakra"),
+        task: async () => extendStorybookConfiguration(
+          path.join(
+            import.meta.dirname,
+            "..",
+            "templates",
+            "chakra.storybook.preview.tsx.template"
+          )
+        )
+      }
+    ],
+    { rendererOptions: { collapseSubtasks: false } }
+  );
+  try {
+    await tasks.run();
+  } catch (e) {
+    console.error(c.error(e.message));
+    process.exit(e?.exitCode || 1);
+  }
+}
+export {
+  handler
+};

package/dist/commands/setup/ui/libraries/mantine.js

@@ -0,0 +1,32 @@
+import { createHandler } from "../helpers/helpers.js";
+const command = "mantine";
+const description = "Set up Mantine UI";
+const ALL_KEYWORD = "all";
+function builder(yargs) {
+  yargs.option("force", {
+    alias: "f",
+    default: false,
+    description: "Overwrite existing configuration",
+    type: "boolean"
+  });
+  yargs.option("install", {
+    alias: "i",
+    default: true,
+    description: "Install packages",
+    type: "boolean"
+  });
+  yargs.option("packages", {
+    alias: "p",
+    default: ["core", "hooks"],
+    description: `Mantine packages to install. Specify '${ALL_KEYWORD}' to install all packages. Default: ['core', 'hooks']`,
+    type: "array"
+  });
+}
+const handler = createHandler(command);
+export {
+  ALL_KEYWORD,
+  builder,
+  command,
+  description,
+  handler
+};

package/dist/commands/setup/ui/libraries/mantineHandler.js

@@ -0,0 +1,138 @@
+import path from "path";
+import execa from "execa";
+import fse from "fs-extra";
+import { Listr } from "listr2";
+import { recordTelemetryAttributes } from "@cedarjs/cli-helpers";
+import c from "../../../../lib/colors.js";
+import extendStorybookConfiguration from "../../../../lib/configureStorybook.js";
+import { extendJSXFile, fileIncludes } from "../../../../lib/extendFile.js";
+import { getPaths, writeFile } from "../../../../lib/index.js";
+import { ALL_KEYWORD } from "./mantine.js";
+const ALL_MANTINE_PACKAGES = [
+  "core",
+  "dates",
+  "dropzone",
+  "form",
+  "hooks",
+  "modals",
+  "notifications",
+  "prism",
+  "rte",
+  "spotlight"
+];
+const MANTINE_THEME_AND_COMMENTS = `import { createTheme } from '@mantine/core'
+
+/**
+ * This object will be used to override Mantine theme defaults.
+ * See https://mantine.dev/theming/mantine-provider/#theme-object for theming options
+ * @type {import("@mantine/core").MantineThemeOverride}
+ */
+const theme = {}
+
+export default createTheme(theme)
+`;
+async function handler({ force, install, packages }) {
+  recordTelemetryAttributes({
+    command: "setup ui mantine",
+    force,
+    install,
+    packages
+  });
+  const rwPaths = getPaths();
+  const configFilePath = path.join(rwPaths.web.config, "mantine.config.js");
+  const installPackages = (packages.includes(ALL_KEYWORD) ? ALL_MANTINE_PACKAGES : packages).map((pack) => `@mantine/${pack}`).concat("postcss", "postcss-preset-mantine", "postcss-simple-vars");
+  const tasks = new Listr(
+    [
+      {
+        title: "Installing packages...",
+        skip: () => !install,
+        task: () => {
+          return new Listr(
+            [
+              {
+                title: `Install ${installPackages.join(", ")}`,
+                task: async () => {
+                  await execa("yarn", [
+                    "workspace",
+                    "web",
+                    "add",
+                    "-D",
+                    "@emotion/react",
+                    ...installPackages
+                  ]);
+                }
+              }
+            ],
+            { rendererOptions: { collapseSubtasks: false } }
+          );
+        }
+      },
+      {
+        title: "Setting up Mantine...",
+        skip: () => fileIncludes(rwPaths.web.app, "MantineProvider"),
+        task: () => extendJSXFile(rwPaths.web.app, {
+          insertComponent: {
+            name: "MantineProvider",
+            props: { theme: "theme" },
+            within: "RedwoodProvider"
+          },
+          imports: [
+            "import { MantineProvider } from '@mantine/core'",
+            "import theme from 'config/mantine.config'",
+            "import '@mantine/core/styles.css'"
+          ]
+        })
+      },
+      {
+        title: "Configuring PostCSS...",
+        task: () => {
+          const postCSSConfigPath = rwPaths.web.postcss;
+          if (!force && fse.existsSync(postCSSConfigPath)) {
+            throw new Error(
+              "PostCSS config already exists.\nUse --force to override existing config."
+            );
+          } else {
+            const postCSSConfig = fse.readFileSync(
+              path.join(
+                import.meta.dirname,
+                "../templates/mantine-postcss.config.js.template"
+              ),
+              "utf-8"
+            );
+            return fse.outputFileSync(postCSSConfigPath, postCSSConfig);
+          }
+        }
+      },
+      {
+        title: `Creating Theme File...`,
+        task: () => {
+          writeFile(configFilePath, MANTINE_THEME_AND_COMMENTS, {
+            overwriteExisting: force
+          });
+        }
+      },
+      {
+        title: "Configure Storybook...",
+        skip: () => fileIncludes(rwPaths.web.storybookPreviewConfig, "withMantine"),
+        task: async () => await extendStorybookConfiguration(
+          path.join(
+            import.meta.dirname,
+            "..",
+            "templates",
+            "mantine.storybook.preview.tsx.template"
+          )
+        )
+      }
+    ],
+    { rendererOptions: { collapseSubtasks: false } }
+  );
+  try {
+    await tasks.run();
+  } catch (e) {
+    console.error(c.error(e.message));
+    process.exit(e?.exitCode || 1);
+  }
+}
+export {
+  handler
+};

package/dist/commands/setup/ui/libraries/tailwindcss.js

@@ -0,0 +1,26 @@
+import { createHandler } from "../helpers/helpers.js";
+const command = "tailwindcss";
+const aliases = ["tailwind", "tw"];
+const description = "Set up tailwindcss and PostCSS";
+const builder = (yargs) => {
+  yargs.option("force", {
+    alias: "f",
+    default: false,
+    description: "Overwrite existing configuration",
+    type: "boolean"
+  });
+  yargs.option("install", {
+    alias: "i",
+    default: true,
+    description: "Install packages",
+    type: "boolean"
+  });
+};
+const handler = createHandler(command);
+export {
+  aliases,
+  builder,
+  command,
+  description,
+  handler
+};