touch-all 0.0.1

package/dist/lib/index.d.ts

@@ -0,0 +1,45 @@
+import { Effect } from 'effect';
+import * as _effect_cli_CliApp from '@effect/cli/CliApp';
+import * as _effect_cli_ValidationError from '@effect/cli/ValidationError';
+
+interface ParserResultLineItem {
+    path: string;
+    isFile: boolean;
+}
+type ParserResult = Array<ParserResultLineItem>;
+
+/**
+ * Error type for path traversal detection
+ */
+declare class PathTraversalError {
+    readonly path: string;
+    readonly _tag = "PathTraversalError";
+    constructor(path: string);
+    toString(): string;
+}
+/**
+ * Error type for file system operation failures
+ */
+declare class FsError {
+    readonly message: string;
+    readonly _tag = "FsError";
+    constructor(message: string);
+    toString(): string;
+}
+
+declare const fileStructureCreator: (items: ParserResult, basePath: string) => Effect.Effect<void, FsError | PathTraversalError>;
+
+/**
+ * Safely normalize a user-supplied path against a base directory.
+ * Fails with PathTraversalError if the resolved path escapes the base.
+ *
+ * @param projectPath string - Path relative to project.
+ * @param basePath string - Must be absolute.
+ */
+declare const resolveProjectPathToBase: (projectPath: string, basePath: string) => Effect.Effect<string, PathTraversalError>;
+
+declare const parserFolderStructure: (treeString: string) => ParserResult;
+
+declare const cli: (args: ReadonlyArray<string>) => Effect.Effect<void, PathTraversalError | FsError | Error | _effect_cli_ValidationError.ValidationError, _effect_cli_CliApp.CliApp.Environment>;
+
+export { FsError, type ParserResult, type ParserResultLineItem, PathTraversalError, cli, fileStructureCreator, parserFolderStructure, resolveProjectPathToBase };

package/dist/lib/index.js

@@ -0,0 +1,179 @@
+// src/fsGenerator.ts
+import { Effect as Effect2 } from "effect";
+import path from "path";
+import fs from "fs";
+
+// src/fsNormalizator.ts
+import { resolve, relative, sep } from "path";
+import { Effect } from "effect";
+
+// src/_commonErrors.ts
+var PathTraversalError = class {
+  constructor(path2) {
+    this.path = path2;
+  }
+  _tag = "PathTraversalError";
+  toString() {
+    return `${this._tag}: The path cannot be used ${this.path}`;
+  }
+};
+var FsError = class {
+  constructor(message) {
+    this.message = message;
+  }
+  _tag = "FsError";
+  toString() {
+    return `${this._tag}: ${this.message}`;
+  }
+};
+
+// src/fsNormalizator.ts
+var resolveProjectPathToBase = (projectPath, basePath) => {
+  const filePath = projectPath.startsWith(sep) ? `.${projectPath}` : projectPath;
+  const absolute = resolve(basePath, filePath);
+  const rel = relative(basePath, absolute);
+  if (rel.startsWith("..")) {
+    return Effect.fail(new PathTraversalError(["project:", projectPath, "base:", basePath].join(" ")));
+  }
+  return Effect.succeed(absolute);
+};
+
+// src/fsGenerator.ts
+var fileStructureCreator = (items, basePath) => Effect2.gen(function* (_) {
+  yield* _(Effect2.logInfo(`Creating structure in: ${basePath}`));
+  for (const item of items) {
+    const fullPath = yield* _(resolveProjectPathToBase(item.path, basePath));
+    if (item.isFile) {
+      const dir = path.dirname(fullPath);
+      yield* _(
+        Effect2.try({
+          try: () => fs.mkdirSync(dir, { recursive: true }),
+          catch: (error) => new FsError(`Failed to create directory ${dir}: ${String(error)}`)
+        })
+      );
+      yield* _(
+        Effect2.try({
+          try: () => fs.writeFileSync(fullPath, ""),
+          catch: (error) => new FsError(`Failed to create file ${fullPath}: ${String(error)}`)
+        })
+      );
+      yield* _(Effect2.logInfo(`  Created file:      ${item.path}`));
+    } else {
+      yield* _(
+        Effect2.try({
+          try: () => fs.mkdirSync(fullPath, { recursive: true }),
+          catch: (error) => new FsError(`Failed to create directory ${fullPath}: ${String(error)}`)
+        })
+      );
+      yield* _(Effect2.logInfo(`  Created directory: ${item.path}`));
+    }
+  }
+  yield* _(Effect2.logInfo("\n\u2713 Structure created successfully!"));
+});
+
+// src/parser.ts
+var parserFolderStructure = (treeString) => {
+  const lines = treeString.split("\n");
+  const result = [];
+  const pathStack = [];
+  let indentSize = 0;
+  let previousIndentLevel = 0;
+  for (const line of lines) {
+    const [p01 = "", _comment01] = line.split("#");
+    const [p02 = "", _comment02] = p01.split("//");
+    const p03 = p02.replace(/[│├└─\s]/g, " ");
+    const cleanLine = p03.trim();
+    if (!cleanLine) continue;
+    if (cleanLine === "/") continue;
+    if (cleanLine.startsWith("./")) continue;
+    if (cleanLine.endsWith("../")) continue;
+    const indent = countLeadingSpaces(p03);
+    indentSize = indentSize === 0 && indent > 0 ? indent : indentSize;
+    const level = indentSize === 0 ? 0 : indent / indentSize;
+    if (previousIndentLevel > level) {
+      pathStack.splice(level, previousIndentLevel - level);
+    }
+    previousIndentLevel = level;
+    const isFile = !cleanLine.endsWith("/");
+    const name = cleanLine.split("/").filter(Boolean);
+    pathStack.push(name);
+    const path2 = pathStack.flat().join("/");
+    result.push({
+      path: path2,
+      isFile
+    });
+    if (isFile) {
+      pathStack.pop();
+    }
+  }
+  return result;
+};
+function countLeadingSpaces(str) {
+  const match = str.match(/^[\s]*/);
+  return match ? match[0].length : 0;
+}
+
+// src/cli.ts
+import { Args, Command, Options } from "@effect/cli";
+import { Console, Effect as Effect3, Logger, LogLevel } from "effect";
+var treeArg = Args.text({ name: "tree" }).pipe(
+  Args.withDescription("Multiline string representing the directory tree structure")
+);
+var pathOption = Options.directory("path").pipe(
+  Options.withAlias("p"),
+  Options.withDefault("."),
+  Options.withDescription("Target folder path (defaults to current directory)")
+);
+var dryRunOption = Options.boolean("dry-run").pipe(
+  Options.withAlias("n"),
+  Options.withDefault(false),
+  Options.withDescription("Skip the top-level directory if there is only one")
+);
+var verboseOption = Options.boolean("verbose").pipe(
+  Options.withAlias("v"),
+  Options.withDefault(false),
+  Options.withDescription("Log to console extra information about creating a directory tree")
+);
+var command = Command.make("touch-all", {
+  tree: treeArg,
+  path: pathOption,
+  dryRun: dryRunOption,
+  verbose: verboseOption
+}).pipe(
+  Command.withDescription("Create directory structure from a tree representation"),
+  Command.withHandler(({ tree, path: targetPath, dryRun = false, verbose }) => {
+    const program = Effect3.gen(function* (_) {
+      if (dryRun) {
+        yield* _(Effect3.logInfo("Running in dry mode. No one file system node will be created."));
+      }
+      yield* _(Effect3.logInfo("Parsing tree structure..."));
+      const items = parserFolderStructure(tree);
+      if (items.length === 0) {
+        yield* _(Console.error("No valid items found in the tree structure"));
+        yield* _(Console.error(items));
+        yield* _(Console.error(tree));
+        return yield* _(Effect3.fail(new Error("Invalid tree structure")));
+      }
+      yield* _(Effect3.logInfo(`Found ${items.length} items to create`));
+      yield* _(Effect3.logInfo(`Found: 
+${items.map((i) => `${i.path} 
+`).join("")}`));
+      if (!dryRun) {
+        yield* _(fileStructureCreator(items, targetPath));
+      }
+    });
+    return verbose ? program.pipe(Logger.withMinimumLogLevel(LogLevel.Info)) : program;
+  })
+);
+var cli = Command.run(command, {
+  name: "Touch All",
+  version: "0.0.1"
+});
+export {
+  FsError,
+  PathTraversalError,
+  cli,
+  fileStructureCreator,
+  parserFolderStructure,
+  resolveProjectPathToBase
+};

package/dist/slim/touch-all.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+
+// src/touch-all.ts
+import { Effect as Effect4, Logger as Logger2, LogLevel as LogLevel2 } from "effect";
+import { NodeContext, NodeRuntime } from "@effect/platform-node";
+
+// src/cli.ts
+import { Args, Command, Options } from "@effect/cli";
+import { Console, Effect as Effect3, Logger, LogLevel } from "effect";
+
+// src/parser.ts
+var parserFolderStructure = (treeString) => {
+  const lines = treeString.split("\n");
+  const result = [];
+  const pathStack = [];
+  let indentSize = 0;
+  let previousIndentLevel = 0;
+  for (const line of lines) {
+    const [p01 = "", _comment01] = line.split("#");
+    const [p02 = "", _comment02] = p01.split("//");
+    const p03 = p02.replace(/[│├└─\s]/g, " ");
+    const cleanLine = p03.trim();
+    if (!cleanLine) continue;
+    if (cleanLine === "/") continue;
+    if (cleanLine.startsWith("./")) continue;
+    if (cleanLine.endsWith("../")) continue;
+    const indent = countLeadingSpaces(p03);
+    indentSize = indentSize === 0 && indent > 0 ? indent : indentSize;
+    const level = indentSize === 0 ? 0 : indent / indentSize;
+    if (previousIndentLevel > level) {
+      pathStack.splice(level, previousIndentLevel - level);
+    }
+    previousIndentLevel = level;
+    const isFile = !cleanLine.endsWith("/");
+    const name = cleanLine.split("/").filter(Boolean);
+    pathStack.push(name);
+    const path2 = pathStack.flat().join("/");
+    result.push({
+      path: path2,
+      isFile
+    });
+    if (isFile) {
+      pathStack.pop();
+    }
+  }
+  return result;
+};
+function countLeadingSpaces(str) {
+  const match = str.match(/^[\s]*/);
+  return match ? match[0].length : 0;
+}
+
+// src/fsGenerator.ts
+import { Effect as Effect2 } from "effect";
+import path from "path";
+import fs from "fs";
+
+// src/fsNormalizator.ts
+import { resolve, relative, sep } from "path";
+import { Effect } from "effect";
+
+// src/_commonErrors.ts
+var PathTraversalError = class {
+  constructor(path2) {
+    this.path = path2;
+  }
+  _tag = "PathTraversalError";
+  toString() {
+    return `${this._tag}: The path cannot be used ${this.path}`;
+  }
+};
+var FsError = class {
+  constructor(message) {
+    this.message = message;
+  }
+  _tag = "FsError";
+  toString() {
+    return `${this._tag}: ${this.message}`;
+  }
+};
+
+// src/fsNormalizator.ts
+var resolveProjectPathToBase = (projectPath, basePath) => {
+  const filePath = projectPath.startsWith(sep) ? `.${projectPath}` : projectPath;
+  const absolute = resolve(basePath, filePath);
+  const rel = relative(basePath, absolute);
+  if (rel.startsWith("..")) {
+    return Effect.fail(new PathTraversalError(["project:", projectPath, "base:", basePath].join(" ")));
+  }
+  return Effect.succeed(absolute);
+};
+
+// src/fsGenerator.ts
+var fileStructureCreator = (items, basePath) => Effect2.gen(function* (_) {
+  yield* _(Effect2.logInfo(`Creating structure in: ${basePath}`));
+  for (const item of items) {
+    const fullPath = yield* _(resolveProjectPathToBase(item.path, basePath));
+    if (item.isFile) {
+      const dir = path.dirname(fullPath);
+      yield* _(
+        Effect2.try({
+          try: () => fs.mkdirSync(dir, { recursive: true }),
+          catch: (error) => new FsError(`Failed to create directory ${dir}: ${String(error)}`)
+        })
+      );
+      yield* _(
+        Effect2.try({
+          try: () => fs.writeFileSync(fullPath, ""),
+          catch: (error) => new FsError(`Failed to create file ${fullPath}: ${String(error)}`)
+        })
+      );
+      yield* _(Effect2.logInfo(`  Created file:      ${item.path}`));
+    } else {
+      yield* _(
+        Effect2.try({
+          try: () => fs.mkdirSync(fullPath, { recursive: true }),
+          catch: (error) => new FsError(`Failed to create directory ${fullPath}: ${String(error)}`)
+        })
+      );
+      yield* _(Effect2.logInfo(`  Created directory: ${item.path}`));
+    }
+  }
+  yield* _(Effect2.logInfo("\n\u2713 Structure created successfully!"));
+});
+
+// src/cli.ts
+var treeArg = Args.text({ name: "tree" }).pipe(
+  Args.withDescription("Multiline string representing the directory tree structure")
+);
+var pathOption = Options.directory("path").pipe(
+  Options.withAlias("p"),
+  Options.withDefault("."),
+  Options.withDescription("Target folder path (defaults to current directory)")
+);
+var dryRunOption = Options.boolean("dry-run").pipe(
+  Options.withAlias("n"),
+  Options.withDefault(false),
+  Options.withDescription("Skip the top-level directory if there is only one")
+);
+var verboseOption = Options.boolean("verbose").pipe(
+  Options.withAlias("v"),
+  Options.withDefault(false),
+  Options.withDescription("Log to console extra information about creating a directory tree")
+);
+var command = Command.make("touch-all", {
+  tree: treeArg,
+  path: pathOption,
+  dryRun: dryRunOption,
+  verbose: verboseOption
+}).pipe(
+  Command.withDescription("Create directory structure from a tree representation"),
+  Command.withHandler(({ tree, path: targetPath, dryRun = false, verbose }) => {
+    const program = Effect3.gen(function* (_) {
+      if (dryRun) {
+        yield* _(Effect3.logInfo("Running in dry mode. No one file system node will be created."));
+      }
+      yield* _(Effect3.logInfo("Parsing tree structure..."));
+      const items = parserFolderStructure(tree);
+      if (items.length === 0) {
+        yield* _(Console.error("No valid items found in the tree structure"));
+        yield* _(Console.error(items));
+        yield* _(Console.error(tree));
+        return yield* _(Effect3.fail(new Error("Invalid tree structure")));
+      }
+      yield* _(Effect3.logInfo(`Found ${items.length} items to create`));
+      yield* _(Effect3.logInfo(`Found: 
+${items.map((i) => `${i.path} 
+`).join("")}`));
+      if (!dryRun) {
+        yield* _(fileStructureCreator(items, targetPath));
+      }
+    });
+    return verbose ? program.pipe(Logger.withMinimumLogLevel(LogLevel.Info)) : program;
+  })
+);
+var cli = Command.run(command, {
+  name: "Touch All",
+  version: "0.0.1"
+});
+
+// src/touch-all.ts
+Effect4.suspend(() => cli(process.argv)).pipe(
+  Logger2.withMinimumLogLevel(LogLevel2.Warning),
+  Effect4.provide(NodeContext.layer),
+  NodeRuntime.runMain
+);

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "touch-all",
+  "version": "0.0.1",
+  "description": "CLI tool to create folder structures from markdown tree representations",
+  "keywords": [
+    "cli",
+    "folders",
+    "generator",
+    "markdown",
+    "structure"
+  ],
+  "license": "GPL-3.0-or-later",
+  "author": "Anton Huz <anton@ahuz.dev>",
+  "bin": {
+    "touch-all": "./dist/slim/touch-all.js"
+  },
+  "files": [
+    "dist/bundled",
+    "dist/lib"
+  ],
+  "type": "module",
+  "main": "dist/lib/index.js",
+  "types": "dist/lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/lib/index.d.ts",
+      "import": "./dist/lib/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup --config .config/tsup.config.ts",
+    "check:lint": "oxlint . -c .config/.oxlintrc.json",
+    "check:format": "oxfmt . -c .config/.oxfmtrc.json --check",
+    "format": "oxfmt . -c .config/.oxfmtrc.json --write",
+    "test": "vitest --config .config/vitest.config.ts run"
+  },
+  "dependencies": {
+    "@effect/cli": "^0.73.2",
+    "@effect/platform-node": "^0.104.1",
+    "effect": "^3.19.16"
+  },
+  "devDependencies": {
+    "@total-typescript/tsconfig": "1.0.4",
+    "@types/node": "22.10.2",
+    "oxfmt": "0.28.0",
+    "oxlint": "1.43.0",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3",
+    "vitest": "4.0.18"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}