@jakubmazanec/carson 0.1.0-11dd4a3

package/dist/workspace/internals.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/workspace/internals.ts"],"sourcesContent":["export * from './internals/compareSemver.js';\nexport * from './internals/getPackageJsonWorkspaces.js';\nexport * from './internals/getRepositoryBranches.js';\nexport * from './internals/getRepositoryUrl.js';\n"],"names":[],"mappings":"AAAA,cAAc,+BAA+B;AAC7C,cAAc,0CAA0C;AACxD,cAAc,uCAAuC;AACrD,cAAc,kCAAkC"}

package/dist/workspace/saveProjectConfig.d.ts

@@ -0,0 +1,6 @@
+import { type ProjectConfig } from './ProjectConfig.js';
+export type SaveProjectConfigOptions = {
+    projectPath: string;
+    projectConfig: ProjectConfig;
+};
+export declare function saveProjectConfig({ projectPath, projectConfig }: SaveProjectConfigOptions): Promise<void>;

package/dist/workspace/saveProjectConfig.js

@@ -0,0 +1,13 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+import { CARSON_CONFIG_DIRECTORY, PROJECT_CONFIG_FILENAME } from '../constants.js';
+import { prettify } from '../template/internals.js';
+export async function saveProjectConfig({ projectPath , projectConfig  }) {
+    await fs.ensureDir(path.join(projectPath, CARSON_CONFIG_DIRECTORY));
+    let projectConfigPath = path.join(projectPath, CARSON_CONFIG_DIRECTORY, PROJECT_CONFIG_FILENAME);
+    await fs.writeFile(projectConfigPath, await prettify(JSON.stringify(projectConfig), projectConfigPath), {
+        encoding: 'utf8'
+    });
+}
+
+//# sourceMappingURL=saveProjectConfig.js.map

package/dist/workspace/saveProjectConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/workspace/saveProjectConfig.ts"],"sourcesContent":["import fs from 'fs-extra';\nimport path from 'node:path';\n\nimport {type ProjectConfig} from './ProjectConfig.js';\nimport {CARSON_CONFIG_DIRECTORY, PROJECT_CONFIG_FILENAME} from '../constants.js';\nimport {prettify} from '../template/internals.js';\n\nexport type SaveProjectConfigOptions = {\n  projectPath: string;\n  projectConfig: ProjectConfig;\n};\n\nexport async function saveProjectConfig({projectPath, projectConfig}: SaveProjectConfigOptions) {\n  await fs.ensureDir(path.join(projectPath, CARSON_CONFIG_DIRECTORY));\n\n  let projectConfigPath = path.join(projectPath, CARSON_CONFIG_DIRECTORY, PROJECT_CONFIG_FILENAME);\n\n  await fs.writeFile(\n    projectConfigPath,\n    await prettify(JSON.stringify(projectConfig), projectConfigPath),\n    {encoding: 'utf8'},\n  );\n}\n"],"names":["fs","path","CARSON_CONFIG_DIRECTORY","PROJECT_CONFIG_FILENAME","prettify","saveProjectConfig","projectPath","projectConfig","ensureDir","join","projectConfigPath","writeFile","JSON","stringify","encoding"],"mappings":"AAAA,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,UAAU,YAAY;AAG7B,SAAQC,uBAAuB,EAAEC,uBAAuB,QAAO,kBAAkB;AACjF,SAAQC,QAAQ,QAAO,2BAA2B;AAOlD,OAAO,eAAeC,kBAAkB,EAACC,YAAW,EAAEC,cAAa,EAA2B;IAC5F,MAAMP,GAAGQ,UAAUP,KAAKQ,KAAKH,aAAaJ;IAE1C,IAAIQ,oBAAoBT,KAAKQ,KAAKH,aAAaJ,yBAAyBC;IAExE,MAAMH,GAAGW,UACPD,mBACA,MAAMN,SAASQ,KAAKC,UAAUN,gBAAgBG,oBAC9C;QAACI,UAAU;IAAM;AAErB"}

package/dist/workspace/saveWorkspaceConfig.d.ts

@@ -0,0 +1,6 @@
+import { type WorkspaceConfig } from './WorkspaceConfig.js';
+export type SaveWorkspaceConfigOptions = {
+    workspacePath: string;
+    workspaceConfig: WorkspaceConfig;
+};
+export declare function saveWorkspaceConfig({ workspacePath, workspaceConfig, }: SaveWorkspaceConfigOptions): Promise<void>;

package/dist/workspace/saveWorkspaceConfig.js

@@ -0,0 +1,13 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+import { CARSON_CONFIG_DIRECTORY, WORKSPACE_CONFIG_FILENAME } from '../constants.js';
+import { prettify } from '../template/internals.js';
+export async function saveWorkspaceConfig({ workspacePath , workspaceConfig  }) {
+    await fs.ensureDir(path.join(workspacePath, CARSON_CONFIG_DIRECTORY));
+    let workspaceConfigPath = path.join(workspacePath, CARSON_CONFIG_DIRECTORY, WORKSPACE_CONFIG_FILENAME);
+    await fs.writeFile(workspaceConfigPath, await prettify(JSON.stringify(workspaceConfig), workspaceConfigPath), {
+        encoding: 'utf8'
+    });
+}
+
+//# sourceMappingURL=saveWorkspaceConfig.js.map

package/dist/workspace/saveWorkspaceConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/workspace/saveWorkspaceConfig.ts"],"sourcesContent":["import fs from 'fs-extra';\nimport path from 'node:path';\n\nimport {type WorkspaceConfig} from './WorkspaceConfig.js';\nimport {CARSON_CONFIG_DIRECTORY, WORKSPACE_CONFIG_FILENAME} from '../constants.js';\nimport {prettify} from '../template/internals.js';\n\nexport type SaveWorkspaceConfigOptions = {\n  workspacePath: string;\n  workspaceConfig: WorkspaceConfig;\n};\n\nexport async function saveWorkspaceConfig({\n  workspacePath,\n  workspaceConfig,\n}: SaveWorkspaceConfigOptions) {\n  await fs.ensureDir(path.join(workspacePath, CARSON_CONFIG_DIRECTORY));\n\n  let workspaceConfigPath = path.join(\n    workspacePath,\n    CARSON_CONFIG_DIRECTORY,\n    WORKSPACE_CONFIG_FILENAME,\n  );\n\n  await fs.writeFile(\n    workspaceConfigPath,\n    await prettify(JSON.stringify(workspaceConfig), workspaceConfigPath),\n    {encoding: 'utf8'},\n  );\n}\n"],"names":["fs","path","CARSON_CONFIG_DIRECTORY","WORKSPACE_CONFIG_FILENAME","prettify","saveWorkspaceConfig","workspacePath","workspaceConfig","ensureDir","join","workspaceConfigPath","writeFile","JSON","stringify","encoding"],"mappings":"AAAA,OAAOA,QAAQ,WAAW;AAC1B,OAAOC,UAAU,YAAY;AAG7B,SAAQC,uBAAuB,EAAEC,yBAAyB,QAAO,kBAAkB;AACnF,SAAQC,QAAQ,QAAO,2BAA2B;AAOlD,OAAO,eAAeC,oBAAoB,EACxCC,cAAa,EACbC,gBAAe,EACY;IAC3B,MAAMP,GAAGQ,UAAUP,KAAKQ,KAAKH,eAAeJ;IAE5C,IAAIQ,sBAAsBT,KAAKQ,KAC7BH,eACAJ,yBACAC;IAGF,MAAMH,GAAGW,UACPD,qBACA,MAAMN,SAASQ,KAAKC,UAAUN,kBAAkBG,sBAChD;QAACI,UAAU;IAAM;AAErB"}

package/dist/workspace.d.ts

@@ -0,0 +1,10 @@
+export * from './workspace/Project.js';
+export * from './workspace/ProjectConfig.js';
+export * from './workspace/ProjectError.js';
+export * from './workspace/saveProjectConfig.js';
+export * from './workspace/saveWorkspaceConfig.js';
+export * from './workspace/Workspace.js';
+export * from './workspace/WorkspaceConfig.js';
+export * from './workspace/WorkspaceDependencies.js';
+export * from './workspace/WorkspaceError.js';
+export * from './workspace/WorkspaceRepository.js';

package/dist/workspace.js

@@ -0,0 +1,12 @@
+export * from './workspace/Project.js';
+export * from './workspace/ProjectConfig.js';
+export * from './workspace/ProjectError.js';
+export * from './workspace/saveProjectConfig.js';
+export * from './workspace/saveWorkspaceConfig.js';
+export * from './workspace/Workspace.js';
+export * from './workspace/WorkspaceConfig.js';
+export * from './workspace/WorkspaceDependencies.js';
+export * from './workspace/WorkspaceError.js';
+export * from './workspace/WorkspaceRepository.js';
+
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/workspace.ts"],"sourcesContent":["export * from './workspace/Project.js';\nexport * from './workspace/ProjectConfig.js';\nexport * from './workspace/ProjectError.js';\nexport * from './workspace/saveProjectConfig.js';\nexport * from './workspace/saveWorkspaceConfig.js';\nexport * from './workspace/Workspace.js';\nexport * from './workspace/WorkspaceConfig.js';\nexport * from './workspace/WorkspaceDependencies.js';\nexport * from './workspace/WorkspaceError.js';\nexport * from './workspace/WorkspaceRepository.js';\n"],"names":[],"mappings":"AAAA,cAAc,yBAAyB;AACvC,cAAc,+BAA+B;AAC7C,cAAc,8BAA8B;AAC5C,cAAc,mCAAmC;AACjD,cAAc,qCAAqC;AACnD,cAAc,2BAA2B;AACzC,cAAc,iCAAiC;AAC/C,cAAc,uCAAuC;AACrD,cAAc,gCAAgC;AAC9C,cAAc,qCAAqC"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@jakubmazanec/carson",
+  "version": "0.1.0-11dd4a3",
+  "description": "Tool for managing workspace and project configuration.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jakubmazanec/js-tools",
+    "directory": "packages/carson"
+  },
+  "license": "AGPL-3.0-only",
+  "author": "Jakub Mazanec <jakub@mazanec.dev>",
+  "sideEffects": false,
+  "type": "module",
+  "exports": "./dist/main.js",
+  "bin": {
+    "carson": "bin/carson.js"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "swc src -d dist && tsc",
+    "clean": "del-cli dist *.tsbuildinfo",
+    "develop": "swc src -d dist --watch",
+    "document": "typedoc --options typedoc.config.cjs",
+    "format": "prettier . --write --ignore-unknown --ignore-path ../../.prettierignore",
+    "lint": "eslint .",
+    "start": "node --loader ts-node/esm/transpile-only --inspect src/run.ts",
+    "test": "cross-env NODE_OPTIONS=--experimental-vm-modules jest --passWithNoTests",
+    "typecheck": "tsc --project tsconfig.typecheck.json"
+  },
+  "dependencies": {
+    "@jakubmazanec/args": "1.0.1-11dd4a3",
+    "@jakubmazanec/cli": "0.1.0-11dd4a3",
+    "@jakubmazanec/error": "2.0.1-11dd4a3",
+    "@jakubmazanec/fs-utils": "0.1.0-11dd4a3",
+    "@jakubmazanec/template": "1.0.1-11dd4a3",
+    "@jakubmazanec/ts-utils": "2.1.0-11dd4a3",
+    "@jakubmazanec/zod-utils": "1.0.0-11dd4a3",
+    "chalk": "^5.2.0",
+    "diff": "^5.1.0",
+    "fast-glob": "^3.2.11",
+    "fflate": "^0.7.4",
+    "fs-extra": "^10.0.1",
+    "json5": "^2.2.1",
+    "lodash": "^4.17.21",
+    "micromatch": "^4.0.5",
+    "prettier": "^2.8.5",
+    "prettier-plugin-packagejson": "^2.4.3",
+    "semver": "^7.3.6",
+    "simple-git": "^3.15.1",
+    "yaml": "^2.1.3",
+    "zen-observable": "^0.10.0",
+    "zod": "^3.14.4"
+  },
+  "devDependencies": {
+    "@jest/globals": "^29.5.0",
+    "@types/diff": "^5.0.2",
+    "@types/fs-extra": "^9.0.13",
+    "@types/lodash": "^4.14.195",
+    "@types/micromatch": "^4.0.2",
+    "@types/node": "^16.18.3",
+    "@types/react": "^18.0.26",
+    "@types/semver": "^7.3.9",
+    "@types/zen-observable": "^0.8.3",
+    "ink": "^3.2.0",
+    "react": "^18.2.0"
+  },
+  "peerDependencies": {
+    "@types/react": "17.x || 18.x",
+    "ink": "^3.0.0",
+    "react": "17.x || 18.x"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  },
+  "packageManager": "npm@8.19.4",
+  "engines": {
+    "node": ">=16.20.0"
+  }
+}

package/src/commands/create-project/CreateProject.tsx

@@ -0,0 +1,130 @@
+import {Header, icons, colors, type CommandArguments, useProgram} from '@jakubmazanec/cli';
+import chalk from 'chalk';
+import {Box, Text} from 'ink';
+import path from 'node:path';
+import {useEffect, useState} from 'react';
+
+import {type createProjectCommand} from './createProjectCommand.js';
+import {CreateProjectInput, type CreateProjectInputResult} from './CreateProjectInput.js';
+import {runCreateProject} from './runCreateProject.js';
+import {type Workspace} from '../../workspace.js';
+import {packageNameToDirectory} from '../internals.js';
+
+const ONLY_ONE_STAR_REGEXP = /^(?!(.*?\*){2,}|.*? |\*$).*?\*.*$/;
+
+export type CreateProjectProps = {
+  args: CommandArguments<typeof createProjectCommand>;
+  workspace: Workspace | Workspace<false>;
+};
+
+export function CreateProject({args, workspace}: CreateProjectProps) {
+  let [status, setStatus] = useState<'finished' | 'in-progress' | 'not-started'>('not-started');
+  let [subscription, setSubscription] = useState<ZenObservable.Subscription | null>(null);
+  let [jobs, setJobs] = useState<string[]>([]);
+  let [createProjectInputResult, setCreateProjectInputResult] = useState<CreateProjectInputResult>(
+    () => ({
+      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: Array<{value: string; label: string}> = [];
+
+  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 (
+    <Box flexDirection="column">
+      <Text color={colors.body}>
+        {`Creating project in the workspace at ${chalk[colors.info](workspace.path)}.`}
+      </Text>
+
+      <CreateProjectInput
+        rows={{
+          projectPath: {
+            choices: possiblePaths,
+          },
+        }}
+        values={createProjectInputResult}
+        marginTop={1}
+        onChange={setCreateProjectInputResult}
+        onComplete={setCreateProjectInputResult}
+      />
+
+      {status === 'in-progress' || status === 'finished' ? (
+        <Box marginTop={1} flexDirection="column">
+          <Header showSpinner={status === 'in-progress'} icon={icons.success} marginBottom={1}>
+            <Text>Creating project...</Text>
+          </Header>
+
+          {jobs.map((job) => (
+            <Text key={job}>{`${icons.info} ${job}`}</Text>
+          ))}
+        </Box>
+      ) : null}
+
+      {status === 'finished' ? (
+        <Header marginTop={1} icon={icons.success}>
+          <Text>Done.</Text>
+        </Header>
+      ) : null}
+    </Box>
+  );
+}

package/src/commands/create-project/CreateProjectInput.ts

@@ -0,0 +1,37 @@
+import {type FormResult, 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: string) => {
+        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: string) => {
+        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?',
+    },
+  },
+});
+
+export type CreateProjectInputResult = FormResult<typeof CreateProjectInput>;

package/src/commands/create-project/createProjectCommand.tsx

@@ -0,0 +1,33 @@
+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(<CreateProject args={args} workspace={workspace} />);
+  },
+  {
+    description: 'Creates a new project in an existing workspace.',
+    options: {
+      path: {
+        type: 'string',
+      },
+      template: {
+        type: 'string',
+      },
+      name: {
+        type: 'string',
+      },
+    },
+  },
+);

package/src/commands/create-project/runCreateProject.ts

@@ -0,0 +1,59 @@
+import {type CommandArguments} from '@jakubmazanec/cli';
+import {isEmptyDirectory} from '@jakubmazanec/fs-utils';
+import fs from 'fs-extra';
+import path from 'node:path';
+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 function runCreateProject({
+  projectPath,
+  templateId,
+  projectName,
+  workspace,
+  args,
+}: CreateProjectOptions) {
+  return new Observable<CreateProjectStatus>((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);
+      });
+  });
+}

package/src/commands/create-project.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/src/commands/create-workspace/CreateWorkspace.tsx

@@ -0,0 +1,90 @@
+import {Header, icons, colors, type CommandArguments, useProgram} from '@jakubmazanec/cli';
+import chalk from 'chalk';
+import {Box, Text} from 'ink';
+import {useEffect, useState} from 'react';
+
+import {type createWorkspaceCommand} from './createWorkspaceCommand.js';
+import {CreateWorkspaceInput, type CreateWorkspaceInputResult} from './CreateWorkspaceInput.js';
+import {runCreateWorkspace} from './runCreateWorkspace.js';
+
+export type CreateWorkspaceProps = {
+  args: CommandArguments<typeof createWorkspaceCommand>;
+  path: string;
+};
+
+export function CreateWorkspace({args, path}: CreateWorkspaceProps) {
+  let [status, setStatus] = useState<'finished' | 'in-progress' | 'not-started'>('not-started');
+  let [subscription, setSubscription] = useState<ZenObservable.Subscription | null>(null);
+  let [jobs, setJobs] = useState<string[]>([]);
+  let [createWorkspaceInputResult, setCreateWorkspaceInputResult] =
+    useState<CreateWorkspaceInputResult>(() => ({
+      templateId: {value: args.options.template ?? '', isComplete: !!args.options.template},
+    }));
+  let {exit} = useProgram();
+
+  useEffect(() => {
+    if (Object.entries(createWorkspaceInputResult).every(([, result]) => result.isComplete)) {
+      setStatus('in-progress');
+    }
+  }, [createWorkspaceInputResult]);
+
+  useEffect(() => {
+    if (status === 'in-progress' && !subscription) {
+      let newSubscription = runCreateWorkspace({
+        workspacePath: path,
+        templateId: createWorkspaceInputResult.templateId.value,
+        args,
+      }).subscribe({
+        next(value) {
+          setJobs((previousJobs) => [...previousJobs, value]);
+        },
+        error(error) {
+          exit(error);
+        },
+        complete() {
+          newSubscription.unsubscribe();
+          setStatus('finished');
+        },
+      });
+
+      setSubscription(newSubscription);
+    }
+
+    return () => {
+      if (subscription) {
+        subscription.unsubscribe();
+      }
+    };
+  }, [createWorkspaceInputResult, path, status, subscription, args, exit]);
+
+  return (
+    <Box flexDirection="column">
+      <Text>{`Creating workspace at ${chalk[colors.highlighted](path)}.`}</Text>
+
+      <CreateWorkspaceInput
+        values={createWorkspaceInputResult}
+        marginTop={1}
+        onChange={setCreateWorkspaceInputResult}
+        onComplete={setCreateWorkspaceInputResult}
+      />
+
+      {status === 'in-progress' || status === 'finished' ? (
+        <Box marginTop={1} flexDirection="column">
+          <Header showSpinner={status === 'in-progress'} icon={icons.success} marginBottom={1}>
+            <Text>Creating workspace...</Text>
+          </Header>
+
+          {jobs.map((job) => (
+            <Text key={job}>{`${icons.info} ${job}`}</Text>
+          ))}
+        </Box>
+      ) : null}
+
+      {status === 'finished' ? (
+        <Header marginTop={1} icon={icons.success}>
+          <Text>Done.</Text>
+        </Header>
+      ) : null}
+    </Box>
+  );
+}

package/src/commands/create-workspace/CreateWorkspaceInput.ts

@@ -0,0 +1,21 @@
+import {type FormResult, createForm} from '@jakubmazanec/cli';
+
+const TEMPLATE_ID_REGEXP = /^.+:.+$/;
+
+export const CreateWorkspaceInput = createForm({
+  rows: {
+    templateId: {
+      type: 'text',
+      label: 'Enter template ID:',
+      validate: (value: string) => {
+        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.',
+          );
+        }
+      },
+    },
+  },
+});
+
+export type CreateWorkspaceInputResult = FormResult<typeof CreateWorkspaceInput>;

package/src/commands/create-workspace/createWorkspaceCommand.tsx

@@ -0,0 +1,34 @@
+import {Command} from '@jakubmazanec/cli';
+import {isEmptyDirectory} from '@jakubmazanec/fs-utils';
+import fs from 'fs-extra';
+import path from 'node:path';
+
+import {CreateWorkspace} from './CreateWorkspace.js';
+
+export const createWorkspaceCommand = new Command(
+  'create workspace',
+  async (args, program) => {
+    let workspacePath = path.resolve(process.cwd(), args.options.path ?? '');
+
+    await fs.ensureDir(workspacePath);
+
+    let isWorkspacePathEmpty = await isEmptyDirectory(workspacePath);
+
+    if (!isWorkspacePathEmpty) {
+      throw new Error(`Directory "${workspacePath}" must be empty`);
+    }
+
+    await program.renderElement(<CreateWorkspace args={args} path={workspacePath} />);
+  },
+  {
+    description: 'Creates a new workspacee.',
+    options: {
+      path: {
+        type: 'string',
+      },
+      template: {
+        type: 'string',
+      },
+    },
+  },
+);

package/src/commands/create-workspace/runCreateWorkspace.ts

@@ -0,0 +1,49 @@
+import {type CommandArguments} from '@jakubmazanec/cli';
+import {isEmptyDirectory} from '@jakubmazanec/fs-utils';
+import fs from 'fs-extra';
+import path from 'node:path';
+import Observable from 'zen-observable';
+
+import {type createWorkspaceCommand} from './createWorkspaceCommand.js';
+import {Workspace} from '../../workspace.js';
+
+export type CreateWorkspaceOptions = {
+  workspacePath: string;
+  templateId: string;
+  args: CommandArguments<typeof createWorkspaceCommand>;
+};
+
+export type CreateWorkspaceStatus = string;
+
+export function runCreateWorkspace({workspacePath, templateId, args}: CreateWorkspaceOptions) {
+  return new Observable<CreateWorkspaceStatus>((observer) => {
+    (async () => {
+      observer.next('TODO');
+
+      let resolvedWorkspacePath = path.resolve(workspacePath);
+
+      await fs.ensureDir(resolvedWorkspacePath);
+
+      let isWorkspacePathEmpty = await isEmptyDirectory(resolvedWorkspacePath);
+
+      if (!isWorkspacePathEmpty) {
+        throw new Error(`Directory "${resolvedWorkspacePath}" must be empty`);
+      }
+
+      // create new workspace
+      let workspace = await Workspace.create({
+        args,
+        path: resolvedWorkspacePath,
+        templateId,
+      });
+
+      await workspace.update({args});
+    })()
+      .then(() => {
+        observer.complete();
+      })
+      .catch((error) => {
+        observer.error(error);
+      });
+  });
+}

package/src/commands/create-workspace.ts

@@ -0,0 +1,4 @@
+export * from './create-workspace/CreateWorkspaceInput.js';
+export * from './create-workspace/runCreateWorkspace.js';
+export * from './create-workspace/CreateWorkspace.js';
+export * from './create-workspace/createWorkspaceCommand.js';

package/src/commands/internals/packageNameToDirectory.ts

@@ -0,0 +1,13 @@
+export function packageNameToDirectory(packageName: string): string {
+  const packageNameParts = packageName.split('/');
+
+  if (packageNameParts.length === 1) {
+    return packageNameParts[0] as string;
+  }
+
+  if (packageNameParts.length > 1 && packageName[0] !== '@') {
+    return packageNameParts[0] as string;
+  }
+
+  return packageNameParts[1] as string;
+}

package/src/commands/internals.ts

@@ -0,0 +1 @@
+export * from './internals/packageNameToDirectory.js';