create-convex-monorepo 0.2.0

package/assets/setup/convex-setup.mjs

@@ -0,0 +1,250 @@
+// @ts-check
+import { spawn } from 'node:child_process';
+import { lstat, readFile, writeFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { dirname, join, resolve, relative, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseEnv } from 'node:util';
+
+/** @param {string} framework */
+export function publicVariable(framework) {
+  switch (framework) {
+    case 'next':
+      return 'NEXT_PUBLIC_CONVEX_URL';
+    case 'vite':
+    case 'tanstack-start':
+      return 'VITE_CONVEX_URL';
+    case 'expo':
+      return 'EXPO_PUBLIC_CONVEX_URL';
+    default:
+      throw new Error(
+        `Unknown framework in convex-monorepo.json: ${framework}`,
+      );
+  }
+}
+
+/** Reject links before reading or updating local configuration.
+ * @param {string} root @param {string} file
+ */
+async function safeFile(root, file) {
+  const path = relative(root, file);
+  if (!path || path.startsWith(`..${sep}`) || path === '..')
+    throw new Error('Invalid environment file path.');
+  let current = root;
+  for (const part of path.split(sep)) {
+    current = join(current, part);
+    try {
+      if ((await lstat(current)).isSymbolicLink())
+        throw new Error(`Refusing symlink: ${current}`);
+    } catch (error) {
+      if (
+        !(error instanceof Error && 'code' in error && error.code === 'ENOENT')
+      )
+        throw error;
+    }
+  }
+}
+
+/** @param {string} file */
+async function readOptional(file) {
+  try {
+    return await readFile(file, 'utf8');
+  } catch (error) {
+    if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+      return '';
+    throw error;
+  }
+}
+
+/** @param {string | undefined} value */
+export function deploymentUrl(value) {
+  if (!value)
+    throw new Error(
+      'CONVEX_URL is missing from packages/backend/.env.local or .env. Run pnpm convex:setup first.',
+    );
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    throw new Error('The backend CONVEX_URL is not a valid deployment URL.');
+  }
+  if (
+    !['http:', 'https:'].includes(url.protocol) ||
+    url.username ||
+    url.password ||
+    url.search ||
+    url.hash ||
+    url.pathname !== '/' ||
+    /\s/.test(value)
+  ) {
+    throw new Error(
+      'CONVEX_URL must be an HTTP(S) origin without credentials, a path, query parameters or a fragment.',
+    );
+  }
+  return url.origin;
+}
+
+/** Preserve existing text, including multiline values and comments. dotenv uses
+ * the last assignment. Re-running with the same URL makes no changes.
+ * @param {string} contents @param {string} variable @param {string} url
+ */
+export function linkEnvironment(contents, variable, url) {
+  if (parseEnv(contents)[variable] === url) return contents;
+  const newline = contents.includes('\r\n') ? '\r\n' : '\n';
+  const separator = contents && !contents.endsWith('\n') ? newline : '';
+  return `${contents}${separator}${variable}=${url}${newline}`;
+}
+
+/** @param {string} root @param {AbortSignal} [signal] */
+export async function linkFrontends(root, signal) {
+  signal?.throwIfAborted();
+  root = resolve(root);
+  const configFile = join(root, 'convex-monorepo.json');
+  await safeFile(root, configFile);
+  /** @type {unknown} */
+  const config = JSON.parse(await readFile(configFile, 'utf8'));
+  if (
+    !config ||
+    typeof config !== 'object' ||
+    !('apps' in config) ||
+    !Array.isArray(config.apps) ||
+    config.apps.length === 0
+  ) {
+    throw new Error('convex-monorepo.json must list the applications to link.');
+  }
+  /** @type {Record<string, string | undefined>} */
+  let backend = {};
+  for (const name of ['.env', '.env.local']) {
+    const file = join(root, 'packages/backend', name);
+    await safeFile(root, file);
+    backend = { ...backend, ...parseEnv(await readOptional(file)) };
+  }
+  const url = deploymentUrl(backend.CONVEX_URL);
+  /** @type {Array<{ file: string, before: string, after: string, name: string }>} */
+  const updates = [];
+  const names = new Set();
+  let hasExpo = false;
+  // Preflight every app before changing any environment file.
+  for (const app of /** @type {unknown[]} */ (config.apps)) {
+    if (
+      !app ||
+      typeof app !== 'object' ||
+      !('name' in app) ||
+      typeof app.name !== 'string' ||
+      !/^[a-z0-9][a-z0-9-]{0,99}$/.test(app.name) ||
+      !('framework' in app) ||
+      typeof app.framework !== 'string' ||
+      names.has(app.name)
+    ) {
+      throw new Error(
+        'Invalid or duplicate application in convex-monorepo.json.',
+      );
+    }
+    signal?.throwIfAborted();
+    hasExpo ||= app.framework === 'expo';
+    names.add(app.name);
+    const variable = publicVariable(app.framework);
+    const file = join(root, 'apps', app.name, '.env.local');
+    await safeFile(root, file);
+    if (!(await lstat(dirname(file))).isDirectory())
+      throw new Error(`Application directory is missing: ${app.name}`);
+    const before = await readOptional(file);
+    updates.push({
+      file,
+      before,
+      after: linkEnvironment(before, variable, url),
+      name: app.name,
+    });
+  }
+  for (const update of updates) {
+    signal?.throwIfAborted();
+    await safeFile(root, update.file);
+    if ((await readOptional(update.file)) !== update.before)
+      throw new Error(
+        `Environment changed while linking ${update.name}. Run pnpm convex:link again.`,
+      );
+    signal?.throwIfAborted();
+    if (update.after !== update.before)
+      await writeFile(update.file, update.after, { mode: 0o600 });
+    signal?.throwIfAborted();
+    console.log(`Linked apps/${update.name}/.env.local`);
+  }
+  signal?.throwIfAborted();
+  if (
+    hasExpo &&
+    ['localhost', '127.0.0.1', '[::1]'].includes(new URL(url).hostname)
+  ) {
+    console.log(
+      'Local Convex URL linked. Physical phones need a reachable development URL; localhost points to the phone itself.',
+    );
+  }
+}
+
+/** @param {string} root @param {AbortSignal} [signal] */
+export async function initializeConvex(root, signal) {
+  const backend = join(root, 'packages/backend');
+  const require = createRequire(join(backend, 'package.json'));
+  let cli;
+  try {
+    cli = join(dirname(require.resolve('convex/package.json')), 'bin/main.js');
+  } catch {
+    throw new Error(
+      'Convex is not installed. Run pnpm install, then pnpm convex:setup.',
+    );
+  }
+  console.log('Initializing Convex. Complete the Convex CLI prompts below.');
+  await new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, [cli, 'dev', '--once'], {
+      cwd: backend,
+      stdio: 'inherit',
+      ...(signal ? { signal } : {}),
+    });
+    /** @type {Error | undefined} */
+    let processError;
+    child.once('error', (error) => {
+      processError = error;
+    });
+    // Abort errors arrive before shutdown. Wait until the child releases its files.
+    child.once('close', (code, interrupted) =>
+      processError
+        ? reject(processError)
+        : code === 0
+          ? resolve(undefined)
+          : reject(
+              new Error(
+                `Convex setup stopped (${interrupted ?? `exit ${code}`}). Project files are preserved; frontend URLs were not changed. Resolve the error above and run pnpm convex:setup again. For Clerk, configure CLERK_JWT_ISSUER_DOMAIN on the deployment as described in README.md.`,
+              ),
+            ),
+    );
+  });
+  signal?.throwIfAborted();
+  await linkFrontends(root, signal);
+}
+
+if (
+  process.argv[1] &&
+  resolve(process.argv[1]) === fileURLToPath(import.meta.url)
+) {
+  const controller = new AbortController();
+  const interrupt = () =>
+    controller.abort(new Error('Convex setup cancelled.'));
+  process.once('SIGINT', interrupt);
+  process.once('SIGTERM', interrupt);
+  try {
+    const args = process.argv.slice(2);
+    if (args.length && !(args.length === 1 && args[0] === '--link-only'))
+      throw new Error('Usage: pnpm convex:setup or pnpm convex:link');
+    const root = fileURLToPath(new URL('../', import.meta.url));
+    if (args[0] === '--link-only') await linkFrontends(root, controller.signal);
+    else await initializeConvex(root, controller.signal);
+    controller.signal.throwIfAborted();
+  } catch (error) {
+    console.error(
+      error instanceof Error ? error.message : 'Convex setup failed.',
+    );
+    process.exitCode = controller.signal.aborted ? 130 : 1;
+  } finally {
+    process.removeListener('SIGINT', interrupt);
+    process.removeListener('SIGTERM', interrupt);
+  }
+}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { getPackageVersion } from '../version.js';
+import { runCreate } from '../commands/create.js';
+const controller = new AbortController();
+const interrupt = () => controller.abort(new Error('Generation interrupted.'));
+process.once('SIGINT', interrupt);
+process.once('SIGTERM', interrupt);
+try {
+    await runCreate(process.argv.slice(2), await getPackageVersion(), controller.signal);
+}
+catch (error) {
+    console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+    process.exitCode = controller.signal.aborted ? 130 : 1;
+}
+finally {
+    process.removeListener('SIGINT', interrupt);
+    process.removeListener('SIGTERM', interrupt);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;AACzC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;AAC/E,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAClC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AACnC,IAAI,CAAC;IACH,MAAM,SAAS,CACb,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EACrB,MAAM,iBAAiB,EAAE,EACzB,UAAU,CAAC,MAAM,CAClB,CAAC;AACJ,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CACX,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnE,CAAC;IACF,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;QAAS,CAAC;IACT,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC5C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAC/C,CAAC"}

package/dist/commands/create.d.ts

@@ -0,0 +1,8 @@
+import { type RawOptions } from '../generator/options.js';
+export declare const help = "create-convex-monorepo [project-name] [options]\n\nGenerate a pnpm + Turborepo workspace sharing one Convex backend.\n\n  --apps <list>             next,vite,tanstack-start,expo or web:next,admin:vite\n  --example <name>         messages (default) or none for blank apps\n  --auth <provider>         none (default) or clerk\n  --package-manager <name>  pnpm (v0.1)\n  --install / --no-install  Install generated dependencies\n  --init-convex / --no-init-convex  Set up Convex and link URLs (requires install)\n  --git / --no-git          Initialize a git repository\n  --yes, -y                Accept defaults, including installation and git\n  --help, -h               Show usage\n  --version, -v            Show version\n\nWithout a terminal, prompts are disabled. Installation and git default to off\nunless explicitly enabled or --yes is passed. Convex setup requires --init-convex\nwhen prompts are skipped; --yes does not opt into Convex account setup.\nNamed apps may repeat a framework.\n";
+export declare function parseCommand(args: string[]): {
+    raw: RawOptions;
+    help: boolean;
+    version: boolean;
+};
+export declare function runCreate(args: string[], version: string, signal?: AbortSignal): Promise<void>;

package/dist/commands/create.js

@@ -0,0 +1,182 @@
+import * as prompts from '@clack/prompts';
+import { parseArgs } from 'node:util';
+import { generateProject } from '../generator/index.js';
+import { frameworks, normalizeOptions, validateProjectName, } from '../generator/options.js';
+export const help = `create-convex-monorepo [project-name] [options]
+
+Generate a pnpm + Turborepo workspace sharing one Convex backend.
+
+  --apps <list>             next,vite,tanstack-start,expo or web:next,admin:vite
+  --example <name>         messages (default) or none for blank apps
+  --auth <provider>         none (default) or clerk
+  --package-manager <name>  pnpm (v0.1)
+  --install / --no-install  Install generated dependencies
+  --init-convex / --no-init-convex  Set up Convex and link URLs (requires install)
+  --git / --no-git          Initialize a git repository
+  --yes, -y                Accept defaults, including installation and git
+  --help, -h               Show usage
+  --version, -v            Show version
+
+Without a terminal, prompts are disabled. Installation and git default to off
+unless explicitly enabled or --yes is passed. Convex setup requires --init-convex
+when prompts are skipped; --yes does not opt into Convex account setup.
+Named apps may repeat a framework.
+`;
+export function parseCommand(args) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        options: {
+            apps: { type: 'string' },
+            auth: { type: 'string' },
+            example: { type: 'string' },
+            'package-manager': { type: 'string' },
+            'init-convex': { type: 'boolean' },
+            'no-init-convex': { type: 'boolean' },
+            install: { type: 'boolean' },
+            'no-install': { type: 'boolean' },
+            git: { type: 'boolean' },
+            'no-git': { type: 'boolean' },
+            yes: { type: 'boolean', short: 'y' },
+            help: { type: 'boolean', short: 'h' },
+            version: { type: 'boolean', short: 'v' },
+        },
+    });
+    if (positionals.length > 1)
+        throw new Error('Expected one project name. Use --apps to select applications.');
+    if (values.install && values['no-install'])
+        throw new Error('Choose either --install or --no-install.');
+    if (values.git && values['no-git'])
+        throw new Error('Choose either --git or --no-git.');
+    if (values['init-convex'] && values['no-init-convex'])
+        throw new Error('Choose either --init-convex or --no-init-convex.');
+    const raw = {};
+    if (values['init-convex'] !== undefined ||
+        values['no-init-convex'] !== undefined)
+        raw.initConvex = !values['no-init-convex'] && !!values['init-convex'];
+    if (positionals[0] !== undefined)
+        raw.name = positionals[0];
+    if (values.apps !== undefined)
+        raw.apps = values.apps;
+    if (values.auth !== undefined)
+        raw.auth = values.auth;
+    if (values.example !== undefined)
+        raw.example = values.example;
+    if (values['package-manager'] !== undefined)
+        raw.packageManager = values['package-manager'];
+    if (values.yes !== undefined)
+        raw.yes = values.yes;
+    if (values.install !== undefined || values['no-install'] !== undefined)
+        raw.install = values['no-install'] ? false : (values.install ?? false);
+    if (values.git !== undefined || values['no-git'] !== undefined)
+        raw.git = values['no-git'] ? false : (values.git ?? false);
+    return { raw, help: values.help ?? false, version: values.version ?? false };
+}
+function answer(value) {
+    if (prompts.isCancel(value))
+        throw new Error('Generation cancelled. No project was created.');
+    return value;
+}
+export async function runCreate(args, version, signal) {
+    const parsed = parseCommand(args);
+    if (parsed.help) {
+        console.log(help);
+        return;
+    }
+    if (parsed.version) {
+        console.log(version);
+        return;
+    }
+    const raw = parsed.raw;
+    if (process.stdin.isTTY && process.stdout.isTTY && !raw.yes) {
+        prompts.intro('create-convex-monorepo');
+        if (!raw.name)
+            raw.name = answer(await prompts.text({
+                message: 'Project name?',
+                placeholder: 'my-app',
+                defaultValue: 'my-app',
+                validate: (value) => validateProjectName(value ?? ''),
+            }));
+        if (!raw.packageManager)
+            raw.packageManager = answer(await prompts.select({
+                message: 'Package manager?',
+                options: [{ value: 'pnpm', label: 'pnpm' }],
+            }));
+        if (!raw.apps) {
+            const apps = [];
+            do {
+                const framework = answer(await prompts.select({
+                    message: 'Application framework?',
+                    options: frameworks.map((value) => ({
+                        value,
+                        label: {
+                            next: 'Next.js',
+                            vite: 'Vite + React',
+                            'tanstack-start': 'TanStack Start',
+                            expo: 'Expo / React Native',
+                        }[value],
+                    })),
+                }));
+                const defaultName = framework === 'expo' ? 'mobile' : apps.length === 0 ? 'web' : 'admin';
+                const name = answer(await prompts.text({
+                    message: 'Application name?',
+                    placeholder: defaultName,
+                    defaultValue: defaultName,
+                    validate(value) {
+                        return (validateProjectName(value ?? '') ??
+                            (apps.some((app) => app.name === value)
+                                ? 'Choose a unique application name.'
+                                : undefined));
+                    },
+                }));
+                apps.push({ name, framework });
+            } while (answer(await prompts.confirm({
+                message: 'Add another frontend?',
+                initialValue: false,
+            })));
+            raw.apps = apps;
+        }
+        if (!raw.auth)
+            raw.auth = answer(await prompts.select({
+                message: 'Authentication?',
+                options: [
+                    { value: 'none', label: 'None' },
+                    { value: 'clerk', label: 'Clerk' },
+                ],
+            }));
+        if (raw.example === undefined)
+            raw.example = answer(await prompts.select({
+                message: 'Starter content?',
+                initialValue: 'messages',
+                options: [
+                    { value: 'messages', label: 'Messages example' },
+                    { value: 'none', label: 'Blank project' },
+                ],
+            }));
+        if (raw.git === undefined)
+            raw.git = answer(await prompts.confirm({
+                message: 'Initialize git?',
+                initialValue: true,
+            }));
+        if (raw.initConvex === undefined && raw.install !== false) {
+            raw.initConvex = answer(await prompts.confirm({
+                message: 'Initialize Convex and link frontend URLs? (installs dependencies)',
+                initialValue: true,
+            }));
+        }
+        if (raw.initConvex && raw.install !== false)
+            raw.install = true;
+        if (raw.install === undefined)
+            raw.install = answer(await prompts.confirm({
+                message: 'Install dependencies?',
+                initialValue: true,
+            }));
+    }
+    const options = normalizeOptions(raw);
+    await generateProject(options, {
+        ...(signal ? { signal } : {}),
+        onProgress: (message) => console.log(`✓ ${message}`),
+    });
+    console.log(`✓ Created ${options.name}\n\nNext:\n\n  cd ${options.name}\n${options.install ? '' : '  pnpm install\n'}${options.initConvex ? '  pnpm dev' : '  pnpm convex:setup\n  pnpm dev'}\n\n${options.initConvex ? 'Frontend Convex URLs are linked.' : 'convex:setup initializes the backend and links its public URL to every frontend.'}${options.auth === 'clerk' ? '\nAdd Clerk keys from .env.clerk.example and complete the auth setup in README.md.' : ''}`);
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"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"}

package/dist/generator/context.d.ts

@@ -0,0 +1,3 @@
+import type { GeneratorContext, PackageManifest, ProjectOptions } from './types.js';
+export declare function mergeManifests(base: PackageManifest, patch: Partial<PackageManifest>): PackageManifest;
+export declare function createContext(root: string, options: ProjectOptions): GeneratorContext;

package/dist/generator/context.js

@@ -0,0 +1,81 @@
+import { mkdir, readFile, writeFile, lstat } from 'node:fs/promises';
+import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
+export function mergeManifests(base, patch) {
+    const result = { ...base, ...patch };
+    for (const field of [
+        'scripts',
+        'dependencies',
+        'devDependencies',
+        'peerDependencies',
+        'optionalDependencies',
+    ]) {
+        const previous = base[field];
+        const next = patch[field];
+        if (!previous && !next)
+            continue;
+        for (const [name, value] of Object.entries(next ?? {})) {
+            if (field !== 'scripts' &&
+                previous?.[name] !== undefined &&
+                previous[name] !== value)
+                throw new Error(`Conflicting ${field} entry for ${name}: ${previous[name]} versus ${value}.`);
+        }
+        result[field] = { ...previous, ...next };
+    }
+    for (const [name, version] of Object.entries(result.dependencies ?? {})) {
+        if (result.devDependencies?.[name] !== undefined &&
+            result.devDependencies[name] !== version)
+            throw new Error(`Conflicting dependency versions for ${name}.`);
+    }
+    return result;
+}
+export function createContext(root, options) {
+    const owned = new Set();
+    async function safePath(path) {
+        if (!path ||
+            isAbsolute(path) ||
+            path.includes('\\') ||
+            path.split('/').includes('..'))
+            throw new Error(`Unsafe output path: ${path}`);
+        const target = resolve(root, path);
+        const rel = relative(root, target);
+        if (!rel || rel.startsWith(`..${sep}`) || isAbsolute(rel))
+            throw new Error(`Unsafe output path: ${path}`);
+        let current = root;
+        for (const part of rel.split(sep)) {
+            current = resolve(current, part);
+            try {
+                if ((await lstat(current)).isSymbolicLink())
+                    throw new Error(`Refusing symlink in output path: ${path}`);
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+        }
+        return target;
+    }
+    return {
+        options,
+        root,
+        scope: options.name,
+        async write(path, contents) {
+            const target = await safePath(path);
+            if (owned.has(target))
+                throw new Error(`Template output collision: ${path}`);
+            await mkdir(dirname(target), { recursive: true });
+            await writeFile(target, contents, { flag: 'wx' });
+            owned.add(target);
+        },
+        async json(path, value) {
+            await this.write(path, `${JSON.stringify(value, null, 2)}\n`);
+        },
+        async mergePackage(path, patch) {
+            const target = await safePath(path);
+            if (!owned.has(target))
+                throw new Error(`Cannot patch a package not generated by this context: ${path}`);
+            const base = JSON.parse(await readFile(target, 'utf8'));
+            await writeFile(target, `${JSON.stringify(mergeManifests(base, patch), null, 2)}\n`);
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/generator/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/generator/context.ts"],"names":[],"mappings":"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"}

package/dist/generator/index.d.ts

@@ -0,0 +1,12 @@
+import { type RawOptions } from './options.js';
+import type { AppTemplate, Framework } from './types.js';
+export { normalizeOptions, validateProjectName } from './options.js';
+export type { RawOptions } from './options.js';
+export type * from './types.js';
+export declare function selectTemplate(framework: Framework): AppTemplate;
+export interface GenerateSettings {
+    cwd?: string;
+    onProgress?: (message: string) => void;
+    signal?: AbortSignal;
+}
+export declare function generateProject(raw: RawOptions, settings?: GenerateSettings): Promise<string>;