@tanstack/cta-engine 0.10.0-alpha.25 → 0.10.0-alpha.27

package/dist/custom-add-ons/add-on.js

@@ -0,0 +1,175 @@
+import { readFile } from 'node:fs/promises';
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { basename, dirname, resolve } from 'node:path';
+import { AddOnCompiledSchema } from '../types.js';
+import { createIgnore, recursivelyGatherFiles } from '../file-helpers.js';
+import { compareFilesRecursively, createAppOptionsFromPersisted, createPackageAdditions, readCurrentProjectOptions, runCreateApp, } from './shared.js';
+const ADD_ON_DIR = '.add-on';
+export const ADD_ON_IGNORE_FILES = [
+    'main.jsx',
+    'App.jsx',
+    'main.tsx',
+    'App.tsx',
+    'routeTree.gen.ts',
+];
+const INFO_FILE = '.add-on/info.json';
+const COMPILED_FILE = 'add-on.json';
+const ASSETS_DIR = 'assets';
+export function camelCase(str) {
+    return str
+        .split(/(\.|-|\/)/)
+        .filter((part) => /^[a-zA-Z]+$/.test(part))
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+export function templatize(routeCode, routeFile) {
+    let code = routeCode;
+    // Replace the import
+    code = code.replace(/import { createFileRoute } from ['"]@tanstack\/react-router['"]/g, `import { <% if (fileRouter) { %>createFileRoute<% } else { %>createRoute<% } %> } from '@tanstack/react-router'`);
+    // Extract route path and definition, then transform the route declaration
+    const routeMatch = code.match(/export\s+const\s+Route\s*=\s*createFileRoute\(['"]([^'"]+)['"]\)\s*\(\{([^}]+)\}\)/);
+    let path = '';
+    if (routeMatch) {
+        const fullMatch = routeMatch[0];
+        path = routeMatch[1];
+        const routeDefinition = routeMatch[2];
+        code = code.replace(fullMatch, `<% if (codeRouter) { %>
+import type { RootRoute } from '@tanstack/react-router'
+<% } else { %>
+export const Route = createFileRoute('${path}')({${routeDefinition}})
+<% } %>`);
+        code += `
+<% if (codeRouter) { %>
+export default (parentRoute: RootRoute) => createRoute({
+  path: '${path}',
+  ${routeDefinition}
+  getParentRoute: () => parentRoute,
+})
+<% } %>
+`;
+    }
+    else {
+        console.error(`No route found in the file: ${routeFile}`);
+    }
+    const name = basename(path)
+        .replace('.tsx', '')
+        .replace(/^demo/, '')
+        .replace('.', ' ')
+        .trim();
+    const jsName = camelCase(basename(path));
+    return { url: path, code, name, jsName };
+}
+export async function validateAddOnSetup(environment) {
+    const options = await readCurrentProjectOptions(environment);
+    if (options.mode !== 'file-router') {
+        environment.error('This project is not using file-router mode.', 'To create an add-on, the project must be created with the file-router mode.');
+        process.exit(1);
+    }
+    if (!options.tailwind) {
+        environment.error('This project is not using Tailwind CSS.', 'To create an add-on, the project must be created with Tailwind CSS.');
+        process.exit(1);
+    }
+    if (!options.typescript) {
+        environment.error('This project is not using TypeScript.', 'To create an add-on, the project must be created with TypeScript.');
+        process.exit(1);
+    }
+}
+export async function readOrGenerateAddOnInfo(options) {
+    return existsSync(INFO_FILE)
+        ? JSON.parse((await readFile(INFO_FILE)).toString())
+        : {
+            id: `${options.projectName}-add-on`,
+            name: `${options.projectName}-add-on`,
+            version: '0.0.1',
+            description: 'Add-on',
+            author: 'Jane Smith <jane.smith@example.com>',
+            license: 'MIT',
+            link: `https://github.com/jane-smith/${options.projectName}-add-on`,
+            shadcnComponents: [],
+            framework: options.framework,
+            modes: [options.mode],
+            routes: [],
+            warning: '',
+            phase: 'add-on',
+            type: 'add-on',
+            packageAdditions: {
+                scripts: {},
+                dependencies: {},
+                devDependencies: {},
+            },
+            dependsOn: options.chosenAddOns,
+        };
+}
+export async function generateProject(persistedOptions) {
+    const info = await readOrGenerateAddOnInfo(persistedOptions);
+    const output = await runCreateApp((await createAppOptionsFromPersisted(persistedOptions)));
+    return { info, output };
+}
+export async function buildAssetsDirectory(output, info) {
+    const assetsDir = resolve(ADD_ON_DIR, ASSETS_DIR);
+    const ignore = createIgnore(process.cwd());
+    if (!existsSync(assetsDir)) {
+        const changedFiles = {};
+        await compareFilesRecursively('.', ignore, output.files, changedFiles);
+        for (const file of Object.keys(changedFiles).filter((file) => !ADD_ON_IGNORE_FILES.includes(basename(file)))) {
+            mkdirSync(dirname(resolve(assetsDir, file)), {
+                recursive: true,
+            });
+            if (file.includes('/routes/')) {
+                const { url, code, name, jsName } = templatize(changedFiles[file], file);
+                info.routes || (info.routes = []);
+                if (!info.routes.find((r) => r.url === url)) {
+                    info.routes.push({
+                        url,
+                        name,
+                        jsName,
+                        path: file,
+                    });
+                }
+                writeFileSync(resolve(assetsDir, `${file}.ejs`), code);
+            }
+            else {
+                writeFileSync(resolve(assetsDir, file), changedFiles[file]);
+            }
+        }
+    }
+}
+export async function updateAddOnInfo(environment) {
+    const { info, output } = await generateProject(await readCurrentProjectOptions(environment));
+    info.packageAdditions = createPackageAdditions(JSON.parse(output.files['./package.json']), JSON.parse((await readFile('package.json')).toString()));
+    await buildAssetsDirectory(output, info);
+    mkdirSync(resolve(dirname(INFO_FILE)), { recursive: true });
+    writeFileSync(INFO_FILE, JSON.stringify(info, null, 2));
+}
+export async function compileAddOn(environment) {
+    const info = await readOrGenerateAddOnInfo(await readCurrentProjectOptions(environment));
+    const assetsDir = resolve(ADD_ON_DIR, ASSETS_DIR);
+    const compiledInfo = {
+        ...info,
+        files: await recursivelyGatherFiles(assetsDir),
+        deletedFiles: [],
+    };
+    writeFileSync(COMPILED_FILE, JSON.stringify(compiledInfo, null, 2));
+}
+export async function initAddOn(environment) {
+    await validateAddOnSetup(environment);
+    await updateAddOnInfo(environment);
+    await compileAddOn(environment);
+}
+export async function loadRemoteAddOn(url) {
+    const response = await fetch(url);
+    const jsonContent = await response.json();
+    const checked = AddOnCompiledSchema.safeParse(jsonContent);
+    if (!checked.success) {
+        throw new Error(`Invalid add-on: ${url}`);
+    }
+    const addOn = checked.data;
+    addOn.id = url;
+    const out = {
+        ...addOn,
+        getFiles: () => Promise.resolve(Object.keys(addOn.files)),
+        getFileContents: (path) => Promise.resolve(addOn.files[path]),
+        getDeletedFiles: () => Promise.resolve(addOn.deletedFiles),
+    };
+    return out;
+}

package/dist/custom-add-ons/shared.js

@@ -0,0 +1,116 @@
+import { readdir } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { createApp } from '../create-app.js';
+import { createMemoryEnvironment } from '../environment.js';
+import { finalizeAddOns } from '../add-ons.js';
+import { getFrameworkById } from '../frameworks.js';
+import { readConfigFileFromEnvironment } from '../config-file.js';
+import { readFileHelper } from '../file-helpers.js';
+import { loadStarter } from '../custom-add-ons/starter.js';
+export function createPackageAdditions(originalPackageJson, currentPackageJson) {
+    const packageAdditions = {};
+    const scripts = {};
+    for (const script of Object.keys(currentPackageJson.scripts || {})) {
+        if (originalPackageJson.scripts[script] !== currentPackageJson.scripts[script]) {
+            scripts[script] = currentPackageJson.scripts[script];
+        }
+    }
+    packageAdditions.scripts = Object.keys(scripts).length ? scripts : undefined;
+    const dependencies = {};
+    for (const dependency of Object.keys(currentPackageJson.dependencies || {})) {
+        if (originalPackageJson.dependencies[dependency] !==
+            currentPackageJson.dependencies[dependency]) {
+            dependencies[dependency] = currentPackageJson.dependencies[dependency];
+        }
+    }
+    packageAdditions.dependencies = Object.keys(dependencies).length
+        ? dependencies
+        : undefined;
+    const devDependencies = {};
+    for (const dependency of Object.keys(currentPackageJson.devDependencies || {})) {
+        if (originalPackageJson.devDependencies[dependency] !==
+            currentPackageJson.devDependencies[dependency]) {
+            devDependencies[dependency] =
+                currentPackageJson.devDependencies[dependency];
+        }
+    }
+    packageAdditions.devDependencies = Object.keys(devDependencies).length
+        ? devDependencies
+        : undefined;
+    return packageAdditions;
+}
+export async function createAppOptionsFromPersisted(json) {
+    /* eslint-disable unused-imports/no-unused-vars */
+    const { version, ...rest } = json;
+    /* eslint-enable unused-imports/no-unused-vars */
+    const framework = getFrameworkById(rest.framework);
+    return {
+        ...rest,
+        mode: json.mode,
+        projectName: json.projectName,
+        typescript: json.typescript,
+        tailwind: json.tailwind,
+        git: json.git,
+        packageManager: json.packageManager,
+        targetDir: '',
+        framework: framework,
+        starter: json.starter ? await loadStarter(json.starter) : undefined,
+        chosenAddOns: await finalizeAddOns(framework, json.mode, [
+            ...json.chosenAddOns,
+        ]),
+    };
+}
+export function createSerializedOptionsFromPersisted(json) {
+    /* eslint-disable unused-imports/no-unused-vars */
+    const { version, ...rest } = json;
+    /* eslint-enable unused-imports/no-unused-vars */
+    return {
+        ...rest,
+        mode: json.mode,
+        projectName: json.projectName,
+        typescript: json.typescript,
+        tailwind: json.tailwind,
+        git: json.git,
+        packageManager: json.packageManager,
+        targetDir: '',
+        framework: json.framework,
+        starter: json.starter,
+    };
+}
+export async function runCreateApp(options) {
+    const { environment, output } = createMemoryEnvironment();
+    const targetDir = resolve(process.cwd());
+    await createApp(environment, {
+        ...options,
+        targetDir,
+    });
+    output.files = Object.fromEntries(Object.entries(output.files).map(([key, value]) => {
+        return [key.replace(targetDir, '.'), value];
+    }));
+    return output;
+}
+export async function compareFilesRecursively(path, ignore, original, changedFiles) {
+    const files = await readdir(path, { withFileTypes: true });
+    for (const file of files) {
+        const filePath = `${path}/${file.name}`;
+        if (!ignore(file.name)) {
+            if (file.isDirectory()) {
+                await compareFilesRecursively(filePath, ignore, original, changedFiles);
+            }
+            else {
+                const contents = await readFileHelper(filePath);
+                if (!original[filePath] || original[filePath] !== contents) {
+                    changedFiles[filePath] = contents;
+                }
+            }
+        }
+    }
+}
+export async function readCurrentProjectOptions(environment) {
+    const persistedOptions = await readConfigFileFromEnvironment(environment, process.cwd());
+    if (!persistedOptions) {
+        environment.error('There is no .cta.json file in your project.', `This is probably because this was created with an older version of create-tsrouter-app.`);
+        process.exit(1);
+    }
+    return persistedOptions;
+}

package/dist/custom-add-ons/starter.js

@@ -0,0 +1,84 @@
+import { readFile } from 'node:fs/promises';
+import { existsSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { StarterCompiledSchema } from '../types.js';
+import { createIgnore } from '../file-helpers.js';
+import { compareFilesRecursively, createAppOptionsFromPersisted, createPackageAdditions, readCurrentProjectOptions, runCreateApp, } from './shared.js';
+const INFO_FILE = 'starter-info.json';
+const COMPILED_FILE = 'starter.json';
+export async function readOrGenerateStarterInfo(options) {
+    return existsSync(INFO_FILE)
+        ? JSON.parse((await readFile(INFO_FILE)).toString())
+        : {
+            id: `${options.projectName}-starter`,
+            name: `${options.projectName}-starter`,
+            version: '0.0.1',
+            description: 'Project starter',
+            author: 'Jane Smith <jane.smith@example.com>',
+            license: 'MIT',
+            link: `https://github.com/jane-smith/${options.projectName}-starter`,
+            shadcnComponents: [],
+            framework: options.framework,
+            mode: options.mode,
+            routes: [],
+            warning: '',
+            type: 'starter',
+            packageAdditions: {
+                scripts: {},
+                dependencies: {},
+                devDependencies: {},
+            },
+            dependsOn: options.chosenAddOns,
+            typescript: options.typescript,
+            tailwind: options.tailwind,
+        };
+}
+async function loadCurrentStarterInfo(environment) {
+    const persistedOptions = await readCurrentProjectOptions(environment);
+    const info = await readOrGenerateStarterInfo(persistedOptions);
+    const output = await runCreateApp((await createAppOptionsFromPersisted(persistedOptions)));
+    return { info, output };
+}
+export async function updateStarterInfo(environment) {
+    const { info, output } = await loadCurrentStarterInfo(environment);
+    info.packageAdditions = createPackageAdditions(JSON.parse(output.files['./package.json']), JSON.parse((await readFile('package.json')).toString()));
+    writeFileSync(INFO_FILE, JSON.stringify(info, null, 2));
+}
+export async function compileStarter(environment) {
+    const { info, output } = await loadCurrentStarterInfo(environment);
+    const ignore = createIgnore(process.cwd());
+    const changedFiles = {};
+    await compareFilesRecursively('.', ignore, output.files, changedFiles);
+    const deletedFiles = [];
+    for (const file of Object.keys(output.files)) {
+        if (!existsSync(resolve(process.cwd(), file))) {
+            deletedFiles.push(file);
+        }
+    }
+    const compiledInfo = {
+        ...info,
+        files: changedFiles,
+        deletedFiles,
+    };
+    writeFileSync(COMPILED_FILE, JSON.stringify(compiledInfo, null, 2));
+}
+export async function initStarter(environment) {
+    await updateStarterInfo(environment);
+    await compileStarter(environment);
+}
+export async function loadStarter(url) {
+    const response = await fetch(url);
+    const jsonContent = await response.json();
+    const checked = StarterCompiledSchema.safeParse(jsonContent);
+    if (!checked.success) {
+        throw new Error(`Invalid starter: ${url}`);
+    }
+    const starter = checked.data;
+    starter.id = url;
+    return {
+        ...starter,
+        getFiles: () => Promise.resolve(Object.keys(starter.files)),
+        getFileContents: (path) => Promise.resolve(starter.files[path]),
+        getDeletedFiles: () => Promise.resolve(starter.deletedFiles),
+    };
+}

package/dist/environment.js

@@ -1,8 +1,10 @@
-import { appendFile, copyFile, mkdir, readFile, unlink, writeFile, } from 'node:fs/promises';
-import { existsSync, readdirSync, statSync } from 'node:fs';
+import { appendFile, copyFile, mkdir, readFile, readdir, unlink, writeFile, } from 'node:fs/promises';
+import { existsSync, statSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { execa } from 'execa';
 import { memfs } from 'memfs';
+import { rimraf } from 'rimraf';
+import { cleanUpFileArray, cleanUpFiles, getBinaryFile, } from './file-helpers.js';
 export function createDefaultEnvironment() {
     let errors = [];
     return {
@@ -23,33 +25,57 @@ export function createDefaultEnvironment() {
             await mkdir(dirname(path), { recursive: true });
             return writeFile(path, contents);
         },
+        writeFileBase64: async (path, base64Contents) => {
+            await mkdir(dirname(path), { recursive: true });
+            return writeFile(path, getBinaryFile(base64Contents));
+        },
         execute: async (command, args, cwd) => {
             try {
-                await execa(command, args, {
+                const result = await execa(command, args, {
                     cwd,
                 });
+                return { stdout: result.stdout };
             }
             catch {
                 errors.push(`Command "${command} ${args.join(' ')}" did not run successfully. Please run this manually in your project.`);
+                return { stdout: '' };
             }
         },
         deleteFile: async (path) => {
-            await unlink(path);
+            if (existsSync(path)) {
+                await unlink(path);
+            }
+        },
+        readFile: async (path) => {
+            return (await readFile(path)).toString();
         },
-        readFile: (path, encoding) => readFile(path, { encoding: encoding || 'utf8' }),
         exists: (path) => existsSync(path),
-        readdir: (path) => readdirSync(path),
-        isDirectory: (path) => {
-            const stat = statSync(path);
-            return stat.isDirectory();
+        isDirectory: (path) => statSync(path).isDirectory(),
+        readdir: async (path) => readdir(path),
+        rimraf: async (path) => {
+            await rimraf(path);
         },
+        appName: 'TanStack',
+        startStep: () => { },
+        finishStep: () => { },
+        intro: () => { },
+        outro: () => { },
+        info: () => { },
+        error: () => { },
+        warn: () => { },
+        confirm: () => Promise.resolve(true),
+        spinner: () => ({
+            start: () => { },
+            stop: () => { },
+        }),
     };
 }
-export function createMemoryEnvironment() {
+export function createMemoryEnvironment(returnPathsRelativeTo = '') {
     const environment = createDefaultEnvironment();
     const output = {
         files: {},
         commands: [],
+        deletedFiles: [],
     };
     const { fs, vol } = memfs({});
     const cwd = process.cwd();
@@ -75,43 +101,49 @@ export function createMemoryEnvironment() {
             command,
             args,
         });
-        return Promise.resolve();
+        return Promise.resolve({ stdout: '' });
     };
-    environment.readFile = async (path, encoding) => {
-        if (isTemplatePath(path)) {
-            return (await readFile(path, encoding)).toString();
-        }
-        return fs.readFileSync(path, 'utf8').toString();
+    environment.readFile = async (path) => {
+        return Promise.resolve(fs.readFileSync(path, 'utf-8').toString());
     };
     environment.writeFile = async (path, contents) => {
         fs.mkdirSync(dirname(path), { recursive: true });
         await fs.writeFileSync(path, contents);
     };
-    environment.deleteFile = async (path) => {
-        await fs.unlinkSync(path);
+    environment.writeFileBase64 = async (path, contents) => {
+        // For the in-memory file system, we are not converting the base64 to binary
+        // because it's not needed.
+        fs.mkdirSync(dirname(path), { recursive: true });
+        await fs.writeFileSync(path, contents);
     };
-    environment.exists = (path) => {
-        if (isTemplatePath(path)) {
-            return existsSync(path);
+    environment.deleteFile = async (path) => {
+        output.deletedFiles.push(path);
+        if (fs.existsSync(path)) {
+            await fs.unlinkSync(path);
         }
-        return fs.existsSync(path);
     };
-    environment.readdir = (path) => {
-        if (isTemplatePath(path)) {
-            return readdirSync(path);
+    environment.finishRun = () => {
+        output.files = vol.toJSON();
+        for (const file of Object.keys(output.files)) {
+            if (fs.statSync(file).isDirectory()) {
+                delete output.files[file];
+            }
         }
-        return fs.readdirSync(path).map((file) => file.toString());
+        if (returnPathsRelativeTo.length) {
+            output.files = cleanUpFiles(output.files, returnPathsRelativeTo);
+            output.deletedFiles = cleanUpFileArray(output.deletedFiles, returnPathsRelativeTo);
+        }
+    };
+    environment.exists = (path) => {
+        return fs.existsSync(path);
     };
     environment.isDirectory = (path) => {
-        if (isTemplatePath(path)) {
-            const stat = statSync(path);
-            return stat.isDirectory();
-        }
         return fs.statSync(path).isDirectory();
     };
-    environment.finishRun = () => {
-        output.files = vol.toJSON();
+    environment.readdir = async (path) => {
+        return Promise.resolve(fs.readdirSync(path).map((d) => d.toString()));
     };
+    environment.rimraf = async () => { };
     return {
         environment,
         output,

package/dist/file-helpers.js

@@ -0,0 +1,165 @@
+import { readdir } from 'node:fs/promises';
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { basename, extname, resolve } from 'node:path';
+import parseGitignore from 'parse-gitignore';
+import ignore from 'ignore';
+const BINARY_EXTENSIONS = ['.png', '.jpg', '.jpeg', '.gif', '.svg', '.ico'];
+export function readFileHelper(path) {
+    if (isBinaryFile(path)) {
+        return `base64::${readFileSync(path).toString('base64')}`;
+    }
+    else {
+        return readFileSync(path, 'utf-8').toString();
+    }
+}
+export function isBinaryFile(path) {
+    return BINARY_EXTENSIONS.includes(extname(path));
+}
+export function convertBinaryContentsToBase64(contents) {
+    return `base64::${Buffer.from(contents).toString('base64')}`;
+}
+export function isBase64(content) {
+    return content.startsWith('base64::');
+}
+export function getBinaryFile(content) {
+    if (content.startsWith('base64::')) {
+        const binaryContent = Buffer.from(content.replace('base64::', ''), 'base64');
+        return binaryContent;
+    }
+    return null;
+}
+export function relativePath(from, to) {
+    const cleanedFrom = from.startsWith('./') ? from.slice(2) : from;
+    const cleanedTo = to.startsWith('./') ? to.slice(2) : to;
+    const fromSegments = cleanedFrom.split('/');
+    const toSegments = cleanedTo.split('/');
+    fromSegments.pop();
+    toSegments.pop();
+    let commonIndex = 0;
+    while (commonIndex < fromSegments.length &&
+        commonIndex < toSegments.length &&
+        fromSegments[commonIndex] === toSegments[commonIndex]) {
+        commonIndex++;
+    }
+    const upLevels = fromSegments.length - commonIndex;
+    const downLevels = toSegments.slice(commonIndex);
+    if (upLevels === 0 && downLevels.length === 0) {
+        return `./${basename(to)}`;
+    }
+    else if (upLevels === 0 && downLevels.length > 0) {
+        return `./${downLevels.join('/')}/${basename(to)}`;
+    }
+    else {
+        const relativePath = [...Array(upLevels).fill('..'), ...downLevels].join('/');
+        return `${relativePath}/${basename(to)}`;
+    }
+}
+export function isDirectory(path) {
+    return statSync(path).isDirectory();
+}
+export function findFilesRecursively(path, files) {
+    const dirFiles = readdirSync(path);
+    for (const file of dirFiles) {
+        const filePath = resolve(path, file);
+        if (isDirectory(filePath)) {
+            findFilesRecursively(filePath, files);
+        }
+        else {
+            files[filePath] = readFileHelper(filePath);
+        }
+    }
+}
+async function recursivelyGatherFilesHelper(basePath, path, files, ignore) {
+    const dirFiles = await readdir(path, { withFileTypes: true });
+    for (const file of dirFiles) {
+        if (ignore(file.name)) {
+            continue;
+        }
+        if (file.isDirectory()) {
+            await recursivelyGatherFilesHelper(basePath, resolve(path, file.name), files, ignore);
+        }
+        else {
+            const filePath = resolve(path, file.name);
+            files[filePath.replace(basePath, '.')] = await readFileHelper(filePath);
+        }
+    }
+}
+export async function recursivelyGatherFiles(path, includeProjectFiles = true) {
+    const ignore = createIgnore(path, includeProjectFiles);
+    const files = {};
+    await recursivelyGatherFilesHelper(path, path, files, ignore);
+    return files;
+}
+async function recursivelyGatherFilesFromEnvironmentHelper(environment, basePath, path, files, ignore) {
+    const dirFiles = await environment.readdir(path);
+    for (const file of dirFiles) {
+        if (ignore(file)) {
+            continue;
+        }
+        if (environment.isDirectory(resolve(path, file))) {
+            await recursivelyGatherFilesFromEnvironmentHelper(environment, basePath, resolve(path, file), files, ignore);
+        }
+        else {
+            const filePath = resolve(path, file);
+            files[filePath.replace(basePath, '.')] =
+                await environment.readFile(filePath);
+        }
+    }
+}
+export async function recursivelyGatherFilesFromEnvironment(environment, path, includeProjectFiles = true) {
+    const ignore = createIgnore(path, includeProjectFiles);
+    const files = {};
+    await recursivelyGatherFilesFromEnvironmentHelper(environment, path, path, files, ignore);
+    return files;
+}
+export const IGNORE_FILES = [
+    '.starter',
+    '.add-on',
+    '.cta.json',
+    '.git',
+    'add-on-info.json',
+    'add-on.json',
+    'build',
+    'bun.lock',
+    'bun.lockb',
+    'deno.lock',
+    'dist',
+    'node_modules',
+    'package-lock.json',
+    'pnpm-lock.yaml',
+    'starter.json',
+    'starter-info.json',
+    'yarn.lock',
+];
+const PROJECT_FILES = ['package.json'];
+export function createIgnore(path, includeProjectFiles = true) {
+    const ignoreList = existsSync(resolve(path, '.gitignore'))
+        ? parseGitignore(readFileSync(resolve(path, '.gitignore'))).patterns
+        : [];
+    const ig = ignore().add(ignoreList);
+    return (filePath) => {
+        const fileName = basename(filePath);
+        if (IGNORE_FILES.includes(fileName) ||
+            (includeProjectFiles && PROJECT_FILES.includes(fileName))) {
+            return true;
+        }
+        const nameWithoutDotSlash = fileName.replace(/^\.\//, '');
+        return ig.ignores(nameWithoutDotSlash);
+    };
+}
+export function cleanUpFiles(files, targetDir) {
+    return Object.keys(files).reduce((acc, file) => {
+        if (basename(file) !== '.cta.json') {
+            acc[targetDir ? file.replace(targetDir, '.') : file] = files[file];
+        }
+        return acc;
+    }, {});
+}
+export function cleanUpFileArray(files, targetDir) {
+    return files.reduce((acc, file) => {
+        if (basename(file) !== '.cta.json') {
+            acc.push(targetDir ? file.replace(targetDir, '.') : file);
+        }
+        return acc;
+    }, []);
+}