@jakubmazanec/carson 0.1.0-11dd4a3

package/README.md

@@ -0,0 +1,237 @@
+<div align="center">
+
+# @jakubmazanec/carson
+
+<!-- description -->Tool for managing workspace and project configuration.<!-- description -->
+
+</div>
+
+## Installation
+
+```sh
+npm install @jakubmazanec/carson -g
+```
+
+⚠️ This is an [ESM](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c) package!
+It cannot be required from a CommonJS module.
+
+#### Prerequisites
+
+- Node.js 16 or later
+
+## Usage
+
+Software development is constantly evolving and best practices often change. If you want to migrate
+to a new tool, or merely update some settings, it can be time-consuming to do it in multiple
+repositories. Instead, Carson lets you write and use a template that defines what files should exist
+and what content should they have. Instead of updating files in your repositories manually, you
+change only the template and Carson handles the updates automatically for you, and keeps every
+repository in sync. With a template, creating new projects is also super fast and simple.
+
+### Quick overview
+
+Update workspace:
+
+```sh
+npx carson update workspace
+```
+
+Create a new project in an existing workspace:
+
+```sh
+npx carson create project
+```
+
+See [CLI documentation](#cli) for the complete overview.
+
+### How it works
+
+Carson assumes your codebase is organized in a workspace, which is simply a directory, and also
+usually a git repository, that contains one or multiple projects. A project is a self-contained
+piece of code, e.g. a package, or an app.
+
+> ⚠️ Currently only Node.js projects are supported.
+
+Take a look at this simplified example of a workspace:
+
+```
+workspace/
+├── .carson/
+│   ├── .snapshots
+│   └── workspace.json
+├── packages/
+│   ├── foo/
+│   │   ├── .carson/
+│   │   │   ├── .snapshots
+│   │   │   └── project.json
+│   │   ├── src/
+│   │   │   └── main.js
+│   │   └── package.json
+│   └── bar/
+│       ├── .carson/
+│       │   ├── .snapshots
+│       │   └── project.json
+│       ├── src/
+│       │   └── main.js
+│       └── package.json
+└── package.json
+```
+
+Notice that the workspace and each of the two packages in it (`foo` and `bar`) have a directory
+named `.carson` with 2 files:
+
+1. Configuration file, which specifies the ID of the Carson template that is used to define the
+   files (or just some parts of the files) in the workspace or the project.
+2. Snapshots file with all the information necessary to revert any changes.
+
+Let's say config files `workspace/packages/foo/.carson/project.json` and
+`workspace/packages/bar/.carson/project.json` both contain this:
+
+```json
+{
+  "template": "carson-templates:project"
+}
+```
+
+That means they're using a Carson template named `project` from a package named `carson-templates`.
+Carson template is just a directory containing `*.ejs` files parsed and rendered via
+`@jakubmazanec/template` package; these files are actually [EJS](https://ejs.co/) templates with
+YAML front matter. Please read [`@jakubmazanec/template` documentation](../template/README.md) to
+find out in more detail how they work. Simply, they're for generating content using JavaScript as a
+templating language.
+
+> Yes, each "Carson template" is composed of multiple "EJS templates". Hopefully, the existence of
+> these two different template "types" isn't very confusing.
+
+Take a look at this simplified example of `carson-templates` with two templates named `workspace`
+and `project`:
+
+```
+carson-templates@1.0.0
+└── templates
+    ├── project
+    │   └── package.json.ejs
+    └── workspace
+        └── package.json.ejs
+```
+
+Because we're interested in the `project` template, let's see file
+`carson-templates@1.0.0/templates/project/package.json.ejs`:
+
+```
+---
+to: 'package.json'
+strategy: merge
+---
+{
+  "repository": {
+    "directory": "<%- project.relativePath %>"
+  },
+  "type": "module",
+  "exports": "./dist/main.js",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "swc src -d dist"
+  },
+  "devDependencies": {
+    "@swc/cli": "^0.1.62",
+    "@swc/core": "^1.3.56"
+  }
+}
+```
+
+When Carson performs a workspace update, `carson-templates:project` template is rendered for each
+project that uses it, and `foo`, and `bar` have their files changed accordingly. In this example
+that means `foo/package.json` and `bar/package.json` are recursively merged with the JSONs obtained
+from the EJS template above (so SWC is added to development dependencies, or field
+`repository.directory` is set to always be the value of a variable `project.relativePath`, i.e.
+`'packages/foo'` or `'packages/bar'`). Updating the workspace works the same way (although using a
+different Carson template, e.g. `carson-templates:workspace`).
+
+When you install a newer version of `carson-templates` that e.g. replaces SWC with another tool,
+before Carson does fresh update, it first uses saved (and committed to git) snapshots from the
+previous update to revert all its changes. This way you don't need to keep the previous version of
+`carson-templates` around and the updates can be always done automatically from the current state of
+the workspace.
+
+The fact that EJS templates are just JavaScript means Carson can support almost any use case. For
+that, there are also more Carson template features you need to learn than this example showcases:
+mainly additional strategies (you can e.g. instead of merging simply overwrite the whole file, or
+just create a file with some default content and then let the user change it freely) and what
+variables with what information is available during EJS template rendering. Please read
+[Carson templates documentation](#carson-templates) to find out in more detail how they work, or see
+[`@jakubmazanec/carson-templates`](../template/README.md) for examples.
+
+## Documentation
+
+### API
+
+See [API reference](./docs) for auto-generated documentation.
+
+### Configuration
+
+Carson configuration files are located in a directory named `.carson` directory. Files named
+`workspace.json` and `project.json` are used to configure workspace and project respectively (in
+case of single-project workspace they're both in the same `.carson` directory).
+
+You can add arbitrary data to these JSONs in addition to the options described below. Because
+workspace and project configurations are available as JavaScript variables during the rendering of
+Carson templates, they can be used to store ad-hoc data or to allow custom, per-project
+configuration.
+
+#### `workspace.json`
+
+| Option   | Type   | Description        |
+| -------- | ------ | ------------------ |
+| template | string | Carson template ID |
+
+#### `project.json`
+
+| Option   | Type   | Description        |
+| -------- | ------ | ------------------ |
+| template | string | Carson template ID |
+
+### CLI
+
+#### `update workspace [<options>]`
+
+Updates workspace and all projects using the configured Carson templates.
+
+| Option | Description                                                                                                                                                    |
+| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| --path | Path to the workspace. A relative path is appended to the current working directory. The file system is traversed up to the root when looking for a workspace. |
+
+#### `create project [<options>]`
+
+Creates a new project in a workspace.
+
+| Option     | Description                                                                                                                                                                                           |
+| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| --path     | Path to the workspace in which the project should be created. A relative path is appended to the current working directory. The file system is traversed up to the root when looking for a workspace. |
+| --template | ID of the Carson template used to create the project.                                                                                                                                                 |
+| --name     | Project name.                                                                                                                                                                                         |
+
+#### `create workspace [<options>]`
+
+Creates new workspace.
+
+| Option     | Description                                                                                               |
+| ---------- | --------------------------------------------------------------------------------------------------------- |
+| --path     | Path where the workspace should be created. A relative path is appended to the current working directory. |
+| --template | ID of the Carson template used to create the workspace.                                                   |
+
+### Carson templates
+
+🚧 This section is under development. Please check back later for updates.
+
+## Contributing
+
+If you want to contribute, see [CONTRIBUTING](./CONTRIBUTING.md) for details.
+
+## License
+
+This package is licensed under the GNU Affero General Public License v3. See [LICENSE](./LICENSE.md)
+for details.

package/bin/carson.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import '../dist/run.js';

package/dist/commands/create-project/CreateProject.d.ts

@@ -0,0 +1,8 @@
+import { type CommandArguments } from '@jakubmazanec/cli';
+import { type createProjectCommand } from './createProjectCommand.js';
+import { type Workspace } from '../../workspace.js';
+export type CreateProjectProps = {
+    args: CommandArguments<typeof createProjectCommand>;
+    workspace: Workspace | Workspace<false>;
+};
+export declare function CreateProject({ args, workspace }: CreateProjectProps): import("react/jsx-runtime").JSX.Element;

package/dist/commands/create-project/CreateProject.js

@@ -0,0 +1,138 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Header, icons, colors, useProgram } from '@jakubmazanec/cli';
+import chalk from 'chalk';
+import { Box, Text } from 'ink';
+import path from 'node:path';
+import { useEffect, useState } from 'react';
+import { CreateProjectInput } from './CreateProjectInput.js';
+import { runCreateProject } from './runCreateProject.js';
+import { packageNameToDirectory } from '../internals.js';
+const ONLY_ONE_STAR_REGEXP = /^(?!(.*?\*){2,}|.*? |\*$).*?\*.*$/;
+export function CreateProject({ args , workspace  }) {
+    let [status, setStatus] = useState('not-started');
+    let [subscription, setSubscription] = useState(null);
+    let [jobs, setJobs] = useState([]);
+    let [createProjectInputResult, setCreateProjectInputResult] = useState(()=>({
+            projectName: {
+                value: args.options.name ?? '',
+                isComplete: !!args.options.name
+            },
+            projectPath: {
+                value: '',
+                isComplete: false
+            },
+            templateId: {
+                value: args.options.template ?? '',
+                isComplete: !!args.options.template
+            }
+        }));
+    let { exit  } = useProgram();
+    useEffect(()=>{
+        if (Object.entries(createProjectInputResult).every(([, result])=>result.isComplete)) {
+            setStatus('in-progress');
+        }
+    }, [
+        createProjectInputResult
+    ]);
+    useEffect(()=>{
+        if (status === 'in-progress' && !subscription) {
+            let newSubscription = runCreateProject({
+                projectPath: createProjectInputResult.projectPath.value,
+                templateId: createProjectInputResult.templateId.value,
+                projectName: createProjectInputResult.projectName.value,
+                workspace,
+                args
+            }).subscribe({
+                next (value) {
+                    setJobs((previousJobs)=>[
+                            ...previousJobs,
+                            value
+                        ]);
+                },
+                error (error) {
+                    exit(error);
+                },
+                complete () {
+                    newSubscription.unsubscribe();
+                    setStatus('finished');
+                }
+            });
+            setSubscription(newSubscription);
+        }
+        return ()=>{
+            if (subscription) {
+                subscription.unsubscribe();
+            }
+        };
+    }, [
+        args,
+        createProjectInputResult,
+        exit,
+        status,
+        subscription,
+        workspace
+    ]);
+    let possiblePaths = [];
+    if (createProjectInputResult.projectName.value) {
+        let destinationDirectory = packageNameToDirectory(createProjectInputResult.projectName.value);
+        if (workspace.projectGlobs) {
+            possiblePaths = workspace.projectGlobs.filter((projectGlob)=>ONLY_ONE_STAR_REGEXP.test(projectGlob)).map((projectGlob)=>projectGlob.replace(/\*/, destinationDirectory)).map((projectGlob)=>path.join(workspace.path, projectGlob)).map((projectPath)=>({
+                    value: projectPath,
+                    label: path.relative(workspace.path, projectPath).replace('\\', '/')
+                }));
+        } else {
+            possiblePaths = [
+                {
+                    value: workspace.path,
+                    label: workspace.path
+                }
+            ];
+        }
+    }
+    return /*#__PURE__*/ _jsxs(Box, {
+        flexDirection: "column",
+        children: [
+            /*#__PURE__*/ _jsx(Text, {
+                color: colors.body,
+                children: `Creating project in the workspace at ${chalk[colors.info](workspace.path)}.`
+            }),
+            /*#__PURE__*/ _jsx(CreateProjectInput, {
+                rows: {
+                    projectPath: {
+                        choices: possiblePaths
+                    }
+                },
+                values: createProjectInputResult,
+                marginTop: 1,
+                onChange: setCreateProjectInputResult,
+                onComplete: setCreateProjectInputResult
+            }),
+            status === 'in-progress' || status === 'finished' ? /*#__PURE__*/ _jsxs(Box, {
+                marginTop: 1,
+                flexDirection: "column",
+                children: [
+                    /*#__PURE__*/ _jsx(Header, {
+                        showSpinner: status === 'in-progress',
+                        icon: icons.success,
+                        marginBottom: 1,
+                        children: /*#__PURE__*/ _jsx(Text, {
+                            children: "Creating project..."
+                        })
+                    }),
+                    jobs.map((job)=>/*#__PURE__*/ _jsx(Text, {
+                            children: `${icons.info} ${job}`
+                        }, job))
+                ]
+            }) : null,
+            status === 'finished' ? /*#__PURE__*/ _jsx(Header, {
+                marginTop: 1,
+                icon: icons.success,
+                children: /*#__PURE__*/ _jsx(Text, {
+                    children: "Done."
+                })
+            }) : null
+        ]
+    });
+}
+
+//# sourceMappingURL=CreateProject.js.map

package/dist/commands/create-project/CreateProject.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/create-project/CreateProject.tsx"],"sourcesContent":["import {Header, icons, colors, type CommandArguments, useProgram} from '@jakubmazanec/cli';\nimport chalk from 'chalk';\nimport {Box, Text} from 'ink';\nimport path from 'node:path';\nimport {useEffect, useState} from 'react';\n\nimport {type createProjectCommand} from './createProjectCommand.js';\nimport {CreateProjectInput, type CreateProjectInputResult} from './CreateProjectInput.js';\nimport {runCreateProject} from './runCreateProject.js';\nimport {type Workspace} from '../../workspace.js';\nimport {packageNameToDirectory} from '../internals.js';\n\nconst ONLY_ONE_STAR_REGEXP = /^(?!(.*?\\*){2,}|.*? |\\*$).*?\\*.*$/;\n\nexport type CreateProjectProps = {\n  args: CommandArguments<typeof createProjectCommand>;\n  workspace: Workspace | Workspace<false>;\n};\n\nexport function CreateProject({args, workspace}: CreateProjectProps) {\n  let [status, setStatus] = useState<'finished' | 'in-progress' | 'not-started'>('not-started');\n  let [subscription, setSubscription] = useState<ZenObservable.Subscription | null>(null);\n  let [jobs, setJobs] = useState<string[]>([]);\n  let [createProjectInputResult, setCreateProjectInputResult] = useState<CreateProjectInputResult>(\n    () => ({\n      projectName: {value: args.options.name ?? '', isComplete: !!args.options.name},\n      projectPath: {value: '', isComplete: false},\n      templateId: {value: args.options.template ?? '', isComplete: !!args.options.template},\n    }),\n  );\n  let {exit} = useProgram();\n\n  useEffect(() => {\n    if (Object.entries(createProjectInputResult).every(([, result]) => result.isComplete)) {\n      setStatus('in-progress');\n    }\n  }, [createProjectInputResult]);\n\n  useEffect(() => {\n    if (status === 'in-progress' && !subscription) {\n      let newSubscription = runCreateProject({\n        projectPath: createProjectInputResult.projectPath.value,\n        templateId: createProjectInputResult.templateId.value,\n        projectName: createProjectInputResult.projectName.value,\n        workspace,\n        args,\n      }).subscribe({\n        next(value) {\n          setJobs((previousJobs) => [...previousJobs, value]);\n        },\n        error(error) {\n          exit(error);\n        },\n        complete() {\n          newSubscription.unsubscribe();\n          setStatus('finished');\n        },\n      });\n      setSubscription(newSubscription);\n    }\n\n    return () => {\n      if (subscription) {\n        subscription.unsubscribe();\n      }\n    };\n  }, [args, createProjectInputResult, exit, status, subscription, workspace]);\n\n  let possiblePaths: Array<{value: string; label: string}> = [];\n\n  if (createProjectInputResult.projectName.value) {\n    let destinationDirectory = packageNameToDirectory(createProjectInputResult.projectName.value);\n\n    if (workspace.projectGlobs) {\n      possiblePaths = workspace.projectGlobs\n        .filter((projectGlob) => ONLY_ONE_STAR_REGEXP.test(projectGlob))\n        .map((projectGlob) => projectGlob.replace(/\\*/, destinationDirectory))\n        .map((projectGlob) => path.join(workspace.path, projectGlob))\n        .map((projectPath) => ({\n          value: projectPath,\n          label: path.relative(workspace.path, projectPath).replace('\\\\', '/'),\n        }));\n    } else {\n      possiblePaths = [\n        {\n          value: workspace.path,\n          label: workspace.path,\n        },\n      ];\n    }\n  }\n\n  return (\n    <Box flexDirection=\"column\">\n      <Text color={colors.body}>\n        {`Creating project in the workspace at ${chalk[colors.info](workspace.path)}.`}\n      </Text>\n\n      <CreateProjectInput\n        rows={{\n          projectPath: {\n            choices: possiblePaths,\n          },\n        }}\n        values={createProjectInputResult}\n        marginTop={1}\n        onChange={setCreateProjectInputResult}\n        onComplete={setCreateProjectInputResult}\n      />\n\n      {status === 'in-progress' || status === 'finished' ? (\n        <Box marginTop={1} flexDirection=\"column\">\n          <Header showSpinner={status === 'in-progress'} icon={icons.success} marginBottom={1}>\n            <Text>Creating project...</Text>\n          </Header>\n\n          {jobs.map((job) => (\n            <Text key={job}>{`${icons.info} ${job}`}</Text>\n          ))}\n        </Box>\n      ) : null}\n\n      {status === 'finished' ? (\n        <Header marginTop={1} icon={icons.success}>\n          <Text>Done.</Text>\n        </Header>\n      ) : null}\n    </Box>\n  );\n}\n"],"names":["Header","icons","colors","useProgram","chalk","Box","Text","path","useEffect","useState","CreateProjectInput","runCreateProject","packageNameToDirectory","ONLY_ONE_STAR_REGEXP","CreateProject","args","workspace","status","setStatus","subscription","setSubscription","jobs","setJobs","createProjectInputResult","setCreateProjectInputResult","projectName","value","options","name","isComplete","projectPath","templateId","template","exit","Object","entries","every","result","newSubscription","subscribe","next","previousJobs","error","complete","unsubscribe","possiblePaths","destinationDirectory","projectGlobs","filter","projectGlob","test","map","replace","join","label","relative","flexDirection","color","body","info","rows","choices","values","marginTop","onChange","onComplete","showSpinner","icon","success","marginBottom","job"],"mappings":"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"}

package/dist/commands/create-project/CreateProjectInput.d.ts

@@ -0,0 +1,20 @@
+import { type FormResult } from '@jakubmazanec/cli';
+export declare const CreateProjectInput: import("@jakubmazanec/cli").Form<{
+    rows: {
+        templateId: {
+            type: "text";
+            label: string;
+            validate: (value: string) => void;
+        };
+        projectName: {
+            type: "text";
+            label: string;
+            validate: (value: string) => void;
+        };
+        projectPath: {
+            type: "select";
+            label: string;
+        };
+    };
+}>;
+export type CreateProjectInputResult = FormResult<typeof CreateProjectInput>;

package/dist/commands/create-project/CreateProjectInput.js

@@ -0,0 +1,31 @@
+import { createForm } from '@jakubmazanec/cli';
+const TEMPLATE_ID_REGEXP = /^.+:.+$/;
+const PROJECT_NAME_ID_REGEXP = /^[\d./@a-z-]+$/;
+export const CreateProjectInput = createForm({
+    rows: {
+        templateId: {
+            type: 'text',
+            label: 'What template do you want to use?',
+            validate: (value)=>{
+                if (!TEMPLATE_ID_REGEXP.test(value)) {
+                    throw new Error('Template ID must consist of a module ID and a template name separated by a colon.');
+                }
+            }
+        },
+        projectName: {
+            type: 'text',
+            label: 'What is the project name?',
+            validate: (value)=>{
+                if (!PROJECT_NAME_ID_REGEXP.test(value)) {
+                    throw new Error('Project name can containg only lowercase letters, numbers, hyphen, @, dot or /.');
+                }
+            }
+        },
+        projectPath: {
+            type: 'select',
+            label: 'What is the project location?'
+        }
+    }
+});
+
+//# sourceMappingURL=CreateProjectInput.js.map

package/dist/commands/create-project/CreateProjectInput.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/create-project/CreateProjectInput.ts"],"sourcesContent":["import {type FormResult, createForm} from '@jakubmazanec/cli';\n\nconst TEMPLATE_ID_REGEXP = /^.+:.+$/;\nconst PROJECT_NAME_ID_REGEXP = /^[\\d./@a-z-]+$/;\n\nexport const CreateProjectInput = createForm({\n  rows: {\n    templateId: {\n      type: 'text',\n      label: 'What template do you want to use?',\n      validate: (value: string) => {\n        if (!TEMPLATE_ID_REGEXP.test(value)) {\n          throw new Error(\n            'Template ID must consist of a module ID and a template name separated by a colon.',\n          );\n        }\n      },\n    },\n    projectName: {\n      type: 'text',\n      label: 'What is the project name?',\n      validate: (value: string) => {\n        if (!PROJECT_NAME_ID_REGEXP.test(value)) {\n          throw new Error(\n            'Project name can containg only lowercase letters, numbers, hyphen, @, dot or /.',\n          );\n        }\n      },\n    },\n    projectPath: {\n      type: 'select',\n      label: 'What is the project location?',\n    },\n  },\n});\n\nexport type CreateProjectInputResult = FormResult<typeof CreateProjectInput>;\n"],"names":["createForm","TEMPLATE_ID_REGEXP","PROJECT_NAME_ID_REGEXP","CreateProjectInput","rows","templateId","type","label","validate","value","test","Error","projectName","projectPath"],"mappings":"AAAA,SAAyBA,UAAU,QAAO,oBAAoB;AAE9D,MAAMC,qBAAqB;AAC3B,MAAMC,yBAAyB;AAE/B,OAAO,MAAMC,qBAAqBH,WAAW;IAC3CI,MAAM;QACJC,YAAY;YACVC,MAAM;YACNC,OAAO;YACPC,UAAU,CAACC;gBACT,IAAI,CAACR,mBAAmBS,KAAKD,QAAQ;oBACnC,MAAM,IAAIE,MACR;gBAEJ;YACF;QACF;QACAC,aAAa;YACXN,MAAM;YACNC,OAAO;YACPC,UAAU,CAACC;gBACT,IAAI,CAACP,uBAAuBQ,KAAKD,QAAQ;oBACvC,MAAM,IAAIE,MACR;gBAEJ;YACF;QACF;QACAE,aAAa;YACXP,MAAM;YACNC,OAAO;QACT;IACF;AACF,GAAG"}

package/dist/commands/create-project/createProjectCommand.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@jakubmazanec/cli';
+export declare const createProjectCommand: Command<"create project", undefined, {
+    path: {
+        type: "string";
+    };
+    template: {
+        type: "string";
+    };
+    name: {
+        type: "string";
+    };
+}, false, false>;

package/dist/commands/create-project/createProjectCommand.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Command } from '@jakubmazanec/cli';
+import path from 'node:path';
+import { CreateProject } from './CreateProject.js';
+import { Workspace } from '../../workspace.js';
+export const createProjectCommand = new Command('create project', async (args, program)=>{
+    let targetPath = path.resolve(process.cwd(), args.options.path ?? '');
+    let workspace = await Workspace.findAndRead(targetPath);
+    if (!workspace) {
+        throw new Error(`No workspace found at "${targetPath}"!`);
+    }
+    await program.renderElement(/*#__PURE__*/ _jsx(CreateProject, {
+        args: args,
+        workspace: workspace
+    }));
+}, {
+    description: 'Creates a new project in an existing workspace.',
+    options: {
+        path: {
+            type: 'string'
+        },
+        template: {
+            type: 'string'
+        },
+        name: {
+            type: 'string'
+        }
+    }
+});
+
+//# sourceMappingURL=createProjectCommand.js.map

package/dist/commands/create-project/createProjectCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/create-project/createProjectCommand.tsx"],"sourcesContent":["import {Command} from '@jakubmazanec/cli';\nimport path from 'node:path';\n\nimport {CreateProject} from './CreateProject.js';\nimport {Workspace} from '../../workspace.js';\n\nexport const createProjectCommand = new Command(\n  'create project',\n  async (args, program) => {\n    let targetPath = path.resolve(process.cwd(), args.options.path ?? '');\n    let workspace = await Workspace.findAndRead(targetPath);\n\n    if (!workspace) {\n      throw new Error(`No workspace found at \"${targetPath}\"!`);\n    }\n\n    await program.renderElement(<CreateProject args={args} workspace={workspace} />);\n  },\n  {\n    description: 'Creates a new project in an existing workspace.',\n    options: {\n      path: {\n        type: 'string',\n      },\n      template: {\n        type: 'string',\n      },\n      name: {\n        type: 'string',\n      },\n    },\n  },\n);\n"],"names":["Command","path","CreateProject","Workspace","createProjectCommand","args","program","targetPath","resolve","process","cwd","options","workspace","findAndRead","Error","renderElement","description","type","template","name"],"mappings":";AAAA,SAAQA,OAAO,QAAO,oBAAoB;AAC1C,OAAOC,UAAU,YAAY;AAE7B,SAAQC,aAAa,QAAO,qBAAqB;AACjD,SAAQC,SAAS,QAAO,qBAAqB;AAE7C,OAAO,MAAMC,uBAAuB,IAAIJ,QACtC,kBACA,OAAOK,MAAMC;IACX,IAAIC,aAAaN,KAAKO,QAAQC,QAAQC,OAAOL,KAAKM,QAAQV,QAAQ;IAClE,IAAIW,YAAY,MAAMT,UAAUU,YAAYN;IAE5C,IAAI,CAACK,WAAW;QACd,MAAM,IAAIE,MAAM,CAAC,uBAAuB,EAAEP,WAAW,EAAE,CAAC;IAC1D;IAEA,MAAMD,QAAQS,4BAAc,KAACb;QAAcG,MAAMA;QAAMO,WAAWA;;AACpE,GACA;IACEI,aAAa;IACbL,SAAS;QACPV,MAAM;YACJgB,MAAM;QACR;QACAC,UAAU;YACRD,MAAM;QACR;QACAE,MAAM;YACJF,MAAM;QACR;IACF;AACF,GACA"}

package/dist/commands/create-project/runCreateProject.d.ts

@@ -0,0 +1,13 @@
+import { type CommandArguments } from '@jakubmazanec/cli';
+import Observable from 'zen-observable';
+import { type createProjectCommand } from './createProjectCommand.js';
+import { type Workspace } from '../../workspace.js';
+export type CreateProjectOptions = {
+    projectPath: string;
+    projectName: string;
+    templateId: string;
+    workspace: Workspace | Workspace<false>;
+    args: CommandArguments<typeof createProjectCommand>;
+};
+export type CreateProjectStatus = string;
+export declare function runCreateProject({ projectPath, templateId, projectName, workspace, args, }: CreateProjectOptions): Observable<string>;

package/dist/commands/create-project/runCreateProject.js

@@ -0,0 +1,34 @@
+import { isEmptyDirectory } from '@jakubmazanec/fs-utils';
+import fs from 'fs-extra';
+import path from 'node:path';
+import Observable from 'zen-observable';
+export function runCreateProject({ projectPath , templateId , projectName , workspace , args  }) {
+    return new Observable((observer)=>{
+        (async ()=>{
+            observer.next('TODO');
+            let resolvedProjectPath = path.resolve(projectPath);
+            // check if path is ok
+            await fs.ensureDir(resolvedProjectPath);
+            let isProjectPathEmpty = await isEmptyDirectory(resolvedProjectPath);
+            if (!isProjectPathEmpty) {
+                throw new Error(`Directory "${resolvedProjectPath}" must be empty`);
+            }
+            // create new project
+            let project = await workspace.createProject({
+                projectPath: resolvedProjectPath,
+                projectName,
+                templateId,
+                args
+            });
+            await project.update({
+                args
+            });
+        })().then(()=>{
+            observer.complete();
+        }).catch((error)=>{
+            observer.error(error);
+        });
+    });
+}
+
+//# sourceMappingURL=runCreateProject.js.map

package/dist/commands/create-project/runCreateProject.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/create-project/runCreateProject.ts"],"sourcesContent":["import {type CommandArguments} from '@jakubmazanec/cli';\nimport {isEmptyDirectory} from '@jakubmazanec/fs-utils';\nimport fs from 'fs-extra';\nimport path from 'node:path';\nimport Observable from 'zen-observable';\n\nimport {type createProjectCommand} from './createProjectCommand.js';\nimport {type Workspace} from '../../workspace.js';\n\nexport type CreateProjectOptions = {\n  projectPath: string;\n  projectName: string;\n  templateId: string;\n  workspace: Workspace | Workspace<false>;\n  args: CommandArguments<typeof createProjectCommand>;\n};\n\nexport type CreateProjectStatus = string;\n\nexport function runCreateProject({\n  projectPath,\n  templateId,\n  projectName,\n  workspace,\n  args,\n}: CreateProjectOptions) {\n  return new Observable<CreateProjectStatus>((observer) => {\n    (async () => {\n      observer.next('TODO');\n\n      let resolvedProjectPath = path.resolve(projectPath);\n\n      // check if path is ok\n      await fs.ensureDir(resolvedProjectPath);\n\n      let isProjectPathEmpty = await isEmptyDirectory(resolvedProjectPath);\n\n      if (!isProjectPathEmpty) {\n        throw new Error(`Directory \"${resolvedProjectPath}\" must be empty`);\n      }\n\n      // create new project\n      let project = await workspace.createProject({\n        projectPath: resolvedProjectPath,\n        projectName,\n        templateId,\n        args,\n      });\n\n      await project.update({args});\n    })()\n      .then(() => {\n        observer.complete();\n      })\n      .catch((error) => {\n        observer.error(error);\n      });\n  });\n}\n"],"names":["isEmptyDirectory","fs","path","Observable","runCreateProject","projectPath","templateId","projectName","workspace","args","observer","next","resolvedProjectPath","resolve","ensureDir","isProjectPathEmpty","Error","project","createProject","update","then","complete","catch","error"],"mappings":"AACA,SAAQA,gBAAgB,QAAO,yBAAyB;AACxD,OAAOC,QAAQ,WAAW;AAC1B,OAAOC,UAAU,YAAY;AAC7B,OAAOC,gBAAgB,iBAAiB;AAexC,OAAO,SAASC,iBAAiB,EAC/BC,YAAW,EACXC,WAAU,EACVC,YAAW,EACXC,UAAS,EACTC,KAAI,EACiB;IACrB,OAAO,IAAIN,WAAgC,CAACO;QACzC,CAAA;YACCA,SAASC,KAAK;YAEd,IAAIC,sBAAsBV,KAAKW,QAAQR;YAEvC,sBAAsB;YACtB,MAAMJ,GAAGa,UAAUF;YAEnB,IAAIG,qBAAqB,MAAMf,iBAAiBY;YAEhD,IAAI,CAACG,oBAAoB;gBACvB,MAAM,IAAIC,MAAM,CAAC,WAAW,EAAEJ,oBAAoB,eAAe,CAAC;YACpE;YAEA,qBAAqB;YACrB,IAAIK,UAAU,MAAMT,UAAUU,cAAc;gBAC1Cb,aAAaO;gBACbL;gBACAD;gBACAG;YACF;YAEA,MAAMQ,QAAQE,OAAO;gBAACV;YAAI;QAC5B,CAAA,IACGW,KAAK;YACJV,SAASW;QACX,GACCC,MAAM,CAACC;YACNb,SAASa,MAAMA;QACjB;IACJ;AACF"}

package/dist/commands/create-project.d.ts

@@ -0,0 +1,4 @@
+export * from './create-project/CreateProjectInput.js';
+export * from './create-project/runCreateProject.js';
+export * from './create-project/CreateProject.js';
+export * from './create-project/createProjectCommand.js';

package/dist/commands/create-project.js

@@ -0,0 +1,6 @@
+export * from './create-project/CreateProjectInput.js';
+export * from './create-project/runCreateProject.js';
+export * from './create-project/CreateProject.js';
+export * from './create-project/createProjectCommand.js';
+
+//# sourceMappingURL=create-project.js.map

package/dist/commands/create-project.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commands/create-project.ts"],"sourcesContent":["export * from './create-project/CreateProjectInput.js';\nexport * from './create-project/runCreateProject.js';\nexport * from './create-project/CreateProject.js';\nexport * from './create-project/createProjectCommand.js';\n"],"names":[],"mappings":"AAAA,cAAc,yCAAyC;AACvD,cAAc,uCAAuC;AACrD,cAAc,oCAAoC;AAClD,cAAc,2CAA2C"}

package/dist/commands/create-workspace/CreateWorkspace.d.ts

@@ -0,0 +1,7 @@
+import { type CommandArguments } from '@jakubmazanec/cli';
+import { type createWorkspaceCommand } from './createWorkspaceCommand.js';
+export type CreateWorkspaceProps = {
+    args: CommandArguments<typeof createWorkspaceCommand>;
+    path: string;
+};
+export declare function CreateWorkspace({ args, path }: CreateWorkspaceProps): import("react/jsx-runtime").JSX.Element;