@tanstack/create-start 1.92.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-present Tanner Linsley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli-entry.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli-entry.mjs

@@ -0,0 +1,5 @@
+import { runCli } from "./cli.mjs";
+runCli(process.argv).catch((error) => {
+  console.error(error);
+  process.exit(1);
+});

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export declare function runCli(argv: Array<string>): Promise<unknown>;

package/dist/cli.mjs

@@ -0,0 +1,92 @@
+import { Command, createOption } from "@commander-js/extra-typings";
+import { packageManagerOption } from "./modules/packageManager.mjs";
+import { logo } from "./logo.mjs";
+import {
+  scaffoldTemplate,
+  templateCliOption,
+  templatePrompt
+} from "./templates/index.mjs";
+import { createDebugger, debugCliOption, initDebug } from "./utils/debug.mjs";
+import { getAbsolutePath, newProjectDirectoryPrompt } from "./directory.mjs";
+import { packageNameCliOption } from "./modules/packageJson.mjs";
+import { ideCliOption } from "./modules/ide.mjs";
+const logger = createDebugger("cli");
+const options = {
+  template: templateCliOption,
+  packageNameCliOption,
+  packageManager: packageManagerOption,
+  directory: createOption("--directory <string>", "The directory to use"),
+  installDeps: createOption(
+    "--install-deps",
+    "Install dependencies after scaffolding"
+  ),
+  noInstallDeps: createOption(
+    "--no-install-deps",
+    "Skip installing dependencies after scaffolding"
+  ),
+  initGit: createOption("--init-git", "Initialise git"),
+  noInitGit: createOption("--no-init-git", "Skip initialising git"),
+  hideLogo: createOption("--hide-logo", "Hide the Tanstack Start logo"),
+  ide: ideCliOption,
+  debug: debugCliOption
+};
+const addNewProjectOptions = (command) => {
+  return command.addOption(options.template).addOption(options.packageNameCliOption).addOption(options.packageManager).addOption(options.directory).addOption(options.installDeps).addOption(options.noInstallDeps).addOption(options.initGit).addOption(options.noInitGit).addOption(options.hideLogo).addOption(options.ide).addOption(options.debug);
+};
+const program = addNewProjectOptions(
+  new Command("create-start").name("create-start").description("Scaffold a Tanstack Start appliaction").command("default", {
+    isDefault: true,
+    hidden: true
+  })
+).action(async (options2) => {
+  logger.info("Starting CLI action", { options: options2 });
+  initDebug(options2.debug);
+  const templateId = options2.template ?? await templatePrompt();
+  logger.verbose("Template selected", { templateId });
+  const directory = options2.directory ?? await newProjectDirectoryPrompt();
+  const targetPath = getAbsolutePath(directory);
+  logger.verbose("Target directory resolved", { directory, targetPath });
+  logger.info("Starting scaffold process", {
+    templateId,
+    targetPath,
+    packageManager: options2.packageManager,
+    installDeps: options2.installDeps,
+    packageName: options2.packageName,
+    initGit: options2.initGit,
+    ide: options2.ide
+  });
+  await scaffoldTemplate({
+    cfg: {
+      packageManager: {
+        packageManager: options2.packageManager,
+        installDeps: options2.installDeps
+      },
+      packageJson: {
+        type: "new",
+        name: options2.packageName
+      },
+      git: {
+        setupGit: options2.initGit
+      },
+      ide: {
+        ide: options2.ide
+      }
+    },
+    targetPath,
+    templateId
+  });
+  logger.info("Scaffold process complete");
+});
+export async function runCli(argv) {
+  logger.info("CLI starting", { argv });
+  if (!argv.includes("--hide-logo")) {
+    logo();
+  }
+  return new Promise((resolve, reject) => {
+    logger.verbose("Parsing CLI arguments");
+    program.parseAsync(argv).then(resolve).catch((error) => {
+      logger.error("CLI execution failed", error);
+      reject(error);
+    });
+  });
+}

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const NAME = "create-start";
+export declare const SUPPORTED_PACKAGE_MANAGERS: readonly ["bun", "pnpm", "npm", "yarn"];
+export type PackageManager = (typeof SUPPORTED_PACKAGE_MANAGERS)[number];

package/dist/constants.mjs

@@ -0,0 +1,7 @@
+export const NAME = "create-start";
+export const SUPPORTED_PACKAGE_MANAGERS = [
+  "bun",
+  "pnpm",
+  "npm",
+  "yarn"
+];

package/dist/directory.d.ts

@@ -0,0 +1,3 @@
+export declare const getAbsolutePath: (relativePath: string) => any;
+export declare const newProjectDirectoryCliOption: import("@commander-js/extra-typings").Option<"--directory <string>", undefined, undefined, Promise<string>, false, undefined>;
+export declare const newProjectDirectoryPrompt: () => Promise<string>;

package/dist/directory.mjs

@@ -0,0 +1,62 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { InvalidArgumentError, createOption } from "@commander-js/extra-typings";
+import { input } from "@inquirer/prompts";
+export const getAbsolutePath = (relativePath) => {
+  return path.resolve(process.cwd(), relativePath);
+};
+const doesPathExist = async (absolutePath) => {
+  try {
+    await fs.access(absolutePath);
+    return true;
+  } catch {
+    return false;
+  }
+};
+const isFolderEmpty = async (absolutePath) => {
+  try {
+    const files = await fs.readdir(absolutePath);
+    return files.length === 0;
+  } catch {
+    return false;
+  }
+};
+const DEFAULT_NAME = "my-tanstack-start-app";
+const generateDefaultName = async () => {
+  let folderName = DEFAULT_NAME;
+  let absolutePath = getAbsolutePath(folderName);
+  let pathExists = await doesPathExist(absolutePath);
+  let counter = 1;
+  while (pathExists) {
+    folderName = `${DEFAULT_NAME}-${counter}`;
+    absolutePath = getAbsolutePath(folderName);
+    pathExists = await doesPathExist(absolutePath);
+    counter++;
+  }
+  return `./${folderName}`;
+};
+const validateDirectory = async (directory) => {
+  const absolutePath = getAbsolutePath(directory);
+  const pathExists = await doesPathExist(absolutePath);
+  if (!pathExists) return true;
+  const folderEmpty = await isFolderEmpty(absolutePath);
+  if (folderEmpty) return true;
+  return "The directory is not empty. New projects can only be scaffolded in empty directories";
+};
+export const newProjectDirectoryCliOption = createOption(
+  "--directory <string>",
+  "The directory to scaffold your app in"
+).argParser(async (directory) => {
+  const validationResult = await validateDirectory(directory);
+  if (validationResult === true) return directory;
+  throw new InvalidArgumentError(validationResult);
+});
+export const newProjectDirectoryPrompt = async () => {
+  return await input({
+    message: "Where should the project be created?",
+    default: await generateDefaultName(),
+    validate: async (path2) => {
+      return await validateDirectory(path2);
+    }
+  });
+};