@timeax/scaffold 0.0.1 → 0.0.3

package/dist/cli.mjs

@@ -10,6 +10,9 @@ import { transform } from 'esbuild';
 import { minimatch } from 'minimatch';
 import chokidar from 'chokidar';
 
+// src/schema/index.ts
+var SCAFFOLD_ROOT_DIR = ".scaffold";
+
 // src/util/logger.ts
 var supportsColor = typeof process !== "undefined" && process.stdout && process.stdout.isTTY && process.env.NO_COLOR !== "1";
 function wrap(code) {
@@ -133,14 +136,14 @@ function toProjectRelativePath(projectRoot, absolutePath) {
 var logger = defaultLogger.child("[config]");
 async function loadScaffoldConfig(cwd, options = {}) {
   const absCwd = path2.resolve(cwd);
-  const initialScaffoldDir = options.scaffoldDir ? path2.resolve(absCwd, options.scaffoldDir) : path2.join(absCwd, "scaffold");
+  const initialScaffoldDir = options.scaffoldDir ? path2.resolve(absCwd, options.scaffoldDir) : path2.join(absCwd, SCAFFOLD_ROOT_DIR);
   const configPath = options.configPath ?? resolveConfigPath(initialScaffoldDir);
   const config = await importConfig(configPath);
   let configRoot = absCwd;
   if (config.root) {
     configRoot = path2.resolve(absCwd, config.root);
   }
-  const scaffoldDir = options.scaffoldDir ? path2.resolve(absCwd, options.scaffoldDir) : path2.join(configRoot, "scaffold");
+  const scaffoldDir = options.scaffoldDir ? path2.resolve(absCwd, options.scaffoldDir) : path2.join(configRoot, SCAFFOLD_ROOT_DIR);
   const baseRoot = config.base ? path2.resolve(configRoot, config.base) : configRoot;
   logger.debug(
     `Loaded config: configRoot=${configRoot}, baseRoot=${baseRoot}, scaffoldDir=${scaffoldDir}`
@@ -205,14 +208,50 @@ async function importTsConfig(configPath) {
 }
 
 // src/core/structure-txt.ts
+function stripInlineComment(content) {
+  let cutIndex = -1;
+  const len = content.length;
+  for (let i = 0; i < len; i++) {
+    const ch = content[i];
+    const prev = i > 0 ? content[i - 1] : "";
+    if (ch === "#") {
+      if (i === 0) continue;
+      if (prev === " " || prev === "	") {
+        cutIndex = i;
+        break;
+      }
+    }
+    if (ch === "/" && i + 1 < len && content[i + 1] === "/" && (prev === " " || prev === "	")) {
+      cutIndex = i;
+      break;
+    }
+  }
+  if (cutIndex === -1) {
+    return content.trimEnd();
+  }
+  return content.slice(0, cutIndex).trimEnd();
+}
 function parseLine(line, lineNo) {
-  const match = line.match(/^(\s*)(.+)$/);
+  const match = line.match(/^(\s*)(.*)$/);
   if (!match) return null;
   const indentSpaces = match[1].length;
-  const rest = match[2].trim();
-  if (!rest || rest.startsWith("#")) return null;
-  const parts = rest.split(/\s+/);
+  let rest = match[2];
+  if (!rest.trim()) return null;
+  const trimmedRest = rest.trimStart();
+  if (trimmedRest.startsWith("#") || trimmedRest.startsWith("//")) {
+    return null;
+  }
+  const stripped = stripInlineComment(rest);
+  const trimmed = stripped.trim();
+  if (!trimmed) return null;
+  const parts = trimmed.split(/\s+/);
+  if (!parts.length) return null;
   const pathToken = parts[0];
+  if (pathToken.includes(":")) {
+    throw new Error(
+      `structure.txt: ":" is reserved for annotations (@stub:, @include:, etc). Invalid path "${pathToken}" on line ${lineNo}.`
+    );
+  }
   let stub;
   const include = [];
   const exclude = [];
@@ -244,7 +283,7 @@ function parseLine(line, lineNo) {
     exclude: exclude.length ? exclude : void 0
   };
 }
-function parseStructureText(text) {
+function parseStructureText(text, indentStep = 2) {
   const lines = text.split(/\r?\n/);
   const parsed = [];
   for (let i = 0; i < lines.length; i++) {
@@ -254,15 +293,14 @@ function parseStructureText(text) {
   }
   const rootEntries = [];
   const stack = [];
-  const INDENT_STEP = 2;
   for (const p of parsed) {
     const { indentSpaces, lineNo } = p;
-    if (indentSpaces % INDENT_STEP !== 0) {
+    if (indentSpaces % indentStep !== 0) {
       throw new Error(
-        `structure.txt: Invalid indent on line ${lineNo}. Indent must be multiples of ${INDENT_STEP} spaces.`
+        `structure.txt: Invalid indent on line ${lineNo}. Indent must be multiples of ${indentStep} spaces.`
       );
     }
-    const level = indentSpaces / INDENT_STEP;
+    const level = indentSpaces / indentStep;
     if (level > stack.length) {
       if (level !== stack.length + 1) {
         throw new Error(
@@ -828,6 +866,45 @@ async function writeScannedStructuresFromConfig(cwd, options = {}) {
     );
   }
 }
+async function ensureStructureFilesFromConfig(cwd, options = {}) {
+  const { config, scaffoldDir } = await loadScaffoldConfig(cwd, {
+    scaffoldDir: options.scaffoldDirOverride
+  });
+  ensureDirSync(scaffoldDir);
+  const created = [];
+  const existing = [];
+  const seen = /* @__PURE__ */ new Set();
+  const ensureFile = (fileName) => {
+    if (!fileName) return;
+    const filePath = path2.join(scaffoldDir, fileName);
+    const key = path2.resolve(filePath);
+    if (seen.has(key)) return;
+    seen.add(key);
+    if (fs7.existsSync(filePath)) {
+      existing.push(filePath);
+      return;
+    }
+    const header = `# ${fileName}
+# Structure file for @timeax/scaffold
+# Define your desired folders/files here.
+`;
+    fs7.writeFileSync(filePath, header, "utf8");
+    created.push(filePath);
+  };
+  if (config.groups && config.groups.length > 0) {
+    for (const group of config.groups) {
+      const fileName = group.structureFile ?? `${group.name}.txt`;
+      ensureFile(fileName);
+    }
+  } else {
+    const fileName = config.structureFile ?? "structure.txt";
+    ensureFile(fileName);
+  }
+  logger4.debug(
+    `ensureStructureFilesFromConfig: created=${created.length}, existing=${existing.length}`
+  );
+  return { created, existing };
+}
 var logger5 = defaultLogger.child("[init]");
 var DEFAULT_CONFIG_TS = `import type { ScaffoldConfig } from '@timeax/scaffold';
 
@@ -846,7 +923,10 @@ const config: ScaffoldConfig = {
   //   base: 'src',        // apply to <root>/src
   //   base: '..',         // apply to parent of <root>
   // base: '.',
-
+  
+  // Number of spaces per indent level in structure files (default: 2).
+  // indentStep: 2,
+  
   // Cache file path, relative to base.
   // cacheFile: '.scaffold-cache.json',
 
@@ -878,7 +958,7 @@ const config: ScaffoldConfig = {
 
 export default config;
 `;
-var DEFAULT_STRUCTURE_TXT = `# scaffold/structure.txt
+var DEFAULT_STRUCTURE_TXT = `# ${SCAFFOLD_ROOT_DIR}/structure.txt
 # Example structure definition.
 # - Indent with 2 spaces per level
 # - Directories must end with "/"
@@ -890,7 +970,7 @@ var DEFAULT_STRUCTURE_TXT = `# scaffold/structure.txt
 #   index.ts
 `;
 async function initScaffold(cwd, options = {}) {
-  const scaffoldDirRel = options.scaffoldDir ?? "scaffold";
+  const scaffoldDirRel = options.scaffoldDir ?? SCAFFOLD_ROOT_DIR;
   const scaffoldDirAbs = path2.resolve(cwd, scaffoldDirRel);
   const configFileName = options.configFileName ?? "config.ts";
   const structureFileName = options.structureFileName ?? "structure.txt";
@@ -1025,6 +1105,21 @@ async function handleInitCommand(cwd, initOpts, baseOpts) {
     `Done. Config: ${result.configPath}, Structure: ${result.structurePath}`
   );
 }
+async function handleStructuresCommand(cwd, baseOpts) {
+  const logger6 = createCliLogger(baseOpts);
+  logger6.info("Ensuring structure files declared in config exist...");
+  const { created, existing } = await ensureStructureFilesFromConfig(cwd, {
+    scaffoldDirOverride: baseOpts.dir
+  });
+  if (created.length === 0) {
+    logger6.info("All structure files already exist. Nothing to do.");
+  } else {
+    for (const filePath of created) {
+      logger6.info(`Created structure file: ${filePath}`);
+    }
+  }
+  existing.forEach((p) => logger6.debug(`Structure file already exists: ${p}`));
+}
 async function main() {
   const cwd = process.cwd();
   const program = new Command();
@@ -1060,6 +1155,12 @@ async function main() {
   program.action(async (opts) => {
     await handleRunCommand(cwd, opts);
   });
+  program.command("structures").description(
+    "Create missing structure files specified in the config (does not overwrite existing files)"
+  ).action(async (_opts, cmd) => {
+    const baseOpts = cmd.parent?.opts() ?? {};
+    await handleStructuresCommand(cwd, baseOpts);
+  });
   await program.parseAsync(process.argv);
 }
 main().catch((err) => {