@flowgram.ai/cli 0.4.10 → 0.4.11

package/dist/index.cjs

@@ -40,6 +40,7 @@ var import_fs2 = __toESM(require("fs"), 1);
 // src/utils/file.ts
 var import_path = __toESM(require("path"), 1);
 var import_fs = __toESM(require("fs"), 1);
+var import_ignore = __toESM(require("ignore"), 1);
 var File = class {
   constructor(filePath, root = "/") {
     this.root = root;
@@ -65,7 +66,33 @@ var File = class {
     this.content = updater(this.content);
     import_fs.default.writeFileSync(this.path, this.content, "utf-8");
   }
+  write(nextContent) {
+    this.content = nextContent;
+    import_fs.default.writeFileSync(this.path, this.content, "utf-8");
+  }
 };
+function* traverseRecursiveFilePaths(folder, ig = (0, import_ignore.default)().add(".git"), root = folder) {
+  const files = import_fs.default.readdirSync(folder);
+  if (import_fs.default.existsSync(import_path.default.join(folder, ".gitignore"))) {
+    ig.add(import_fs.default.readFileSync(import_path.default.join(folder, ".gitignore"), "utf-8"));
+  }
+  for (const file of files) {
+    const filePath = import_path.default.join(folder, file);
+    if (ig.ignores(import_path.default.relative(root, filePath))) {
+      continue;
+    }
+    if (import_fs.default.statSync(filePath).isDirectory()) {
+      yield* traverseRecursiveFilePaths(filePath, ig, root);
+    } else {
+      yield filePath;
+    }
+  }
+}
+function* traverseRecursiveFiles(folder) {
+  for (const filePath of traverseRecursiveFilePaths(folder)) {
+    yield new File(filePath);
+  }
+}
 
 // src/utils/export.ts
 function extractNamedExports(content) {
@@ -303,15 +330,9 @@ ${restNewImports.map(
   }
 };
 function* traverseRecursiveTsFiles(folder) {
-  const files = import_fs2.default.readdirSync(folder);
-  for (const file of files) {
-    const filePath = import_path2.default.join(folder, file);
-    if (import_fs2.default.statSync(filePath).isDirectory()) {
-      yield* traverseRecursiveTsFiles(filePath);
-    } else {
-      if (file.endsWith(".ts") || file.endsWith(".tsx")) {
-        yield new TsFile(filePath);
-      }
+  for (const filePath of traverseRecursiveFilePaths(folder)) {
+    if (filePath.endsWith(".ts") || filePath.endsWith(".tsx")) {
+      yield new TsFile(filePath);
     }
   }
 }
@@ -485,6 +506,12 @@ var Project = class _Project {
       await this.addDependency(dependency);
     }
   }
+  writeToPackageJsonFile() {
+    (0, import_fs5.writeFileSync)(
+      this.packageJsonPath,
+      JSON.stringify(this.packageJson, null, 2)
+    );
+  }
   printInfo() {
     console.log(import_chalk.default.bold("Project Info:"));
     console.log(import_chalk.default.black(`  - Flowgram Version: ${this.flowgramVersion}`));
@@ -710,13 +737,63 @@ var createApp = async (projectName) => {
   }
 };
 
+// src/update-version/index.ts
+var import_chalk5 = __toESM(require("chalk"), 1);
+async function updateFlowgramVersion(inputVersion) {
+  console.log(import_chalk5.default.bold("\u{1F680} Welcome to @flowgram.ai update-version helper"));
+  const latestVersion = await getLatestVersion("@flowgram.ai/editor");
+  const currentPath = process.cwd();
+  console.log("- Latest flowgram version: ", latestVersion);
+  console.log("- Current Path: ", currentPath);
+  const flowgramVersion = inputVersion || latestVersion;
+  for (const file of traverseRecursiveFiles(currentPath)) {
+    if (file.path.endsWith("package.json")) {
+      console.log("\u{1F440} Find package.json: ", file.path);
+      let updated = false;
+      const json = JSON.parse(file.content);
+      if (json.dependencies) {
+        for (const key in json.dependencies) {
+          if (key.startsWith("@flowgram.ai/")) {
+            updated = true;
+            json.dependencies[key] = flowgramVersion;
+            console.log(`- Update ${key} to ${flowgramVersion}`);
+          }
+        }
+      }
+      if (json.devDependencies) {
+        for (const key in json.devDependencies) {
+          if (key.startsWith("@flowgram.ai/")) {
+            updated = true;
+            json.devDependencies[key] = flowgramVersion;
+            console.log(`- Update ${key} to ${flowgramVersion}`);
+          }
+        }
+      }
+      if (updated) {
+        file.write(JSON.stringify(json, null, 2));
+        console.log(`\u2705 ${file.path} Updated`);
+      }
+    }
+  }
+}
+
 // src/index.ts
 var program = new import_commander.Command();
 program.name("flowgram-cli").version("1.0.0").description("Flowgram CLI");
 program.command("create-app").description("Create a new flowgram project").argument("[string]", "Project name").action(async (projectName) => {
   await createApp(projectName);
 });
-program.command("materials").description("Sync materials to the project").argument("[string]", "Material name").option("--refresh-project-imports", "Refresh project imports to copied materials", false).action(async (materialName, options) => {
-  await syncMaterial({ materialName, refreshProjectImports: options.refreshProjectImports });
+program.command("materials").description("Sync materials to the project").argument("[string]", "Material name").option(
+  "--refresh-project-imports",
+  "Refresh project imports to copied materials",
+  false
+).action(async (materialName, options) => {
+  await syncMaterial({
+    materialName,
+    refreshProjectImports: options.refreshProjectImports
+  });
+});
+program.command("update-version").description("Update flowgram version in the project").argument("[string]", "Flowgram version").action(async (version) => {
+  await updateFlowgramVersion(version);
 });
 program.parse(process.argv);

package/dist/index.js

@@ -23,6 +23,7 @@ import fs2 from "fs";
 // src/utils/file.ts
 import path2 from "path";
 import fs from "fs";
+import ignore from "ignore";
 var File = class {
   constructor(filePath, root = "/") {
     this.root = root;
@@ -48,7 +49,33 @@ var File = class {
     this.content = updater(this.content);
     fs.writeFileSync(this.path, this.content, "utf-8");
   }
+  write(nextContent) {
+    this.content = nextContent;
+    fs.writeFileSync(this.path, this.content, "utf-8");
+  }
 };
+function* traverseRecursiveFilePaths(folder, ig = ignore().add(".git"), root = folder) {
+  const files = fs.readdirSync(folder);
+  if (fs.existsSync(path2.join(folder, ".gitignore"))) {
+    ig.add(fs.readFileSync(path2.join(folder, ".gitignore"), "utf-8"));
+  }
+  for (const file of files) {
+    const filePath = path2.join(folder, file);
+    if (ig.ignores(path2.relative(root, filePath))) {
+      continue;
+    }
+    if (fs.statSync(filePath).isDirectory()) {
+      yield* traverseRecursiveFilePaths(filePath, ig, root);
+    } else {
+      yield filePath;
+    }
+  }
+}
+function* traverseRecursiveFiles(folder) {
+  for (const filePath of traverseRecursiveFilePaths(folder)) {
+    yield new File(filePath);
+  }
+}
 
 // src/utils/export.ts
 function extractNamedExports(content) {
@@ -286,15 +313,9 @@ ${restNewImports.map(
   }
 };
 function* traverseRecursiveTsFiles(folder) {
-  const files = fs2.readdirSync(folder);
-  for (const file of files) {
-    const filePath = path3.join(folder, file);
-    if (fs2.statSync(filePath).isDirectory()) {
-      yield* traverseRecursiveTsFiles(filePath);
-    } else {
-      if (file.endsWith(".ts") || file.endsWith(".tsx")) {
-        yield new TsFile(filePath);
-      }
+  for (const filePath of traverseRecursiveFilePaths(folder)) {
+    if (filePath.endsWith(".ts") || filePath.endsWith(".tsx")) {
+      yield new TsFile(filePath);
     }
   }
 }
@@ -468,6 +489,12 @@ var Project = class _Project {
       await this.addDependency(dependency);
     }
   }
+  writeToPackageJsonFile() {
+    writeFileSync(
+      this.packageJsonPath,
+      JSON.stringify(this.packageJson, null, 2)
+    );
+  }
   printInfo() {
     console.log(chalk.bold("Project Info:"));
     console.log(chalk.black(`  - Flowgram Version: ${this.flowgramVersion}`));
@@ -693,13 +720,63 @@ var createApp = async (projectName) => {
   }
 };
 
+// src/update-version/index.ts
+import chalk5 from "chalk";
+async function updateFlowgramVersion(inputVersion) {
+  console.log(chalk5.bold("\u{1F680} Welcome to @flowgram.ai update-version helper"));
+  const latestVersion = await getLatestVersion("@flowgram.ai/editor");
+  const currentPath = process.cwd();
+  console.log("- Latest flowgram version: ", latestVersion);
+  console.log("- Current Path: ", currentPath);
+  const flowgramVersion = inputVersion || latestVersion;
+  for (const file of traverseRecursiveFiles(currentPath)) {
+    if (file.path.endsWith("package.json")) {
+      console.log("\u{1F440} Find package.json: ", file.path);
+      let updated = false;
+      const json = JSON.parse(file.content);
+      if (json.dependencies) {
+        for (const key in json.dependencies) {
+          if (key.startsWith("@flowgram.ai/")) {
+            updated = true;
+            json.dependencies[key] = flowgramVersion;
+            console.log(`- Update ${key} to ${flowgramVersion}`);
+          }
+        }
+      }
+      if (json.devDependencies) {
+        for (const key in json.devDependencies) {
+          if (key.startsWith("@flowgram.ai/")) {
+            updated = true;
+            json.devDependencies[key] = flowgramVersion;
+            console.log(`- Update ${key} to ${flowgramVersion}`);
+          }
+        }
+      }
+      if (updated) {
+        file.write(JSON.stringify(json, null, 2));
+        console.log(`\u2705 ${file.path} Updated`);
+      }
+    }
+  }
+}
+
 // src/index.ts
 var program = new Command();
 program.name("flowgram-cli").version("1.0.0").description("Flowgram CLI");
 program.command("create-app").description("Create a new flowgram project").argument("[string]", "Project name").action(async (projectName) => {
   await createApp(projectName);
 });
-program.command("materials").description("Sync materials to the project").argument("[string]", "Material name").option("--refresh-project-imports", "Refresh project imports to copied materials", false).action(async (materialName, options) => {
-  await syncMaterial({ materialName, refreshProjectImports: options.refreshProjectImports });
+program.command("materials").description("Sync materials to the project").argument("[string]", "Material name").option(
+  "--refresh-project-imports",
+  "Refresh project imports to copied materials",
+  false
+).action(async (materialName, options) => {
+  await syncMaterial({
+    materialName,
+    refreshProjectImports: options.refreshProjectImports
+  });
+});
+program.command("update-version").description("Update flowgram version in the project").argument("[string]", "Flowgram version").action(async (version) => {
+  await updateFlowgramVersion(version);
 });
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowgram.ai/cli",
-  "version": "0.4.10",
+  "version": "0.4.11",
   "description": "A CLI tool to create demo projects or sync materials",
   "bin": {
     "flowgram-cli": "./bin/index.js"
@@ -17,7 +17,8 @@
     "chalk": "^5.3.0",
     "download": "8.0.0",
     "tar": "7.4.3",
-    "inquirer": "^9.2.7"
+    "inquirer": "^9.2.7",
+    "ignore": "~7.0.5"
   },
   "devDependencies": {
     "@types/download": "8.0.5",

package/src/index.ts

@@ -7,6 +7,7 @@ import { Command } from "commander";
 
 import { syncMaterial } from "./materials";
 import { createApp } from "./create-app";
+import { updateFlowgramVersion } from "./update-version";
 
 const program = new Command();
 
@@ -15,7 +16,7 @@ program.name("flowgram-cli").version("1.0.0").description("Flowgram CLI");
 program
   .command("create-app")
   .description("Create a new flowgram project")
-  .argument('[string]', 'Project name')
+  .argument("[string]", "Project name")
   .action(async (projectName) => {
     await createApp(projectName);
   });
@@ -23,10 +24,25 @@ program
 program
   .command("materials")
   .description("Sync materials to the project")
-  .argument('[string]', 'Material name')
-  .option('--refresh-project-imports', 'Refresh project imports to copied materials', false)
+  .argument("[string]", "Material name")
+  .option(
+    "--refresh-project-imports",
+    "Refresh project imports to copied materials",
+    false,
+  )
   .action(async (materialName, options) => {
-    await syncMaterial({ materialName, refreshProjectImports: options.refreshProjectImports });
+    await syncMaterial({
+      materialName,
+      refreshProjectImports: options.refreshProjectImports,
+    });
+  });
+
+program
+  .command("update-version")
+  .description("Update flowgram version in the project")
+  .argument("[string]", "Flowgram version")
+  .action(async (version) => {
+    await updateFlowgramVersion(version);
   });
 
 program.parse(process.argv);

package/src/update-version/index.ts

@@ -0,0 +1,52 @@
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
+import { getLatestVersion } from "../utils/npm";
+import { traverseRecursiveFiles } from "../utils/file";
+import chalk from "chalk";
+
+export async function updateFlowgramVersion(inputVersion?: string) {
+  console.log(chalk.bold("🚀 Welcome to @flowgram.ai update-version helper"));
+
+  // Get latest version
+  const latestVersion = await getLatestVersion("@flowgram.ai/editor");
+  const currentPath = process.cwd();
+  console.log("- Latest flowgram version: ", latestVersion);
+  console.log("- Current Path: ", currentPath);
+
+  // User Input flowgram version, default is latestVersion
+  const flowgramVersion: string = inputVersion || latestVersion;
+
+  for (const file of traverseRecursiveFiles(currentPath)) {
+    if (file.path.endsWith("package.json")) {
+      console.log("👀 Find package.json: ", file.path);
+      let updated = false;
+      const json = JSON.parse(file.content);
+      if (json.dependencies) {
+        for (const key in json.dependencies) {
+          if (key.startsWith("@flowgram.ai/")) {
+            updated = true;
+            json.dependencies[key] = flowgramVersion;
+            console.log(`- Update ${key} to ${flowgramVersion}`);
+          }
+        }
+      }
+      if (json.devDependencies) {
+        for (const key in json.devDependencies) {
+          if (key.startsWith("@flowgram.ai/")) {
+            updated = true;
+            json.devDependencies[key] = flowgramVersion;
+            console.log(`- Update ${key} to ${flowgramVersion}`);
+          }
+        }
+      }
+
+      if (updated) {
+        file.write(JSON.stringify(json, null, 2));
+        console.log(`✅ ${file.path} Updated`);
+      }
+    }
+  }
+}

package/src/utils/file.ts

@@ -3,8 +3,9 @@
  * SPDX-License-Identifier: MIT
  */
 
-import path from 'path';
-import fs from 'fs';
+import path from "path";
+import fs from "fs";
+import ignore, { Ignore } from "ignore";
 
 export class File {
   content: string;
@@ -17,7 +18,7 @@ export class File {
 
   suffix: string;
 
-  constructor(filePath: string, public root: string = '/') {
+  constructor(filePath: string, public root: string = "/") {
     this.path = filePath;
     this.relativePath = path.relative(this.root, this.path);
     this.suffix = path.extname(this.path);
@@ -29,7 +30,7 @@ export class File {
 
     // If no utf-8, skip
     try {
-      this.content = fs.readFileSync(this.path, 'utf-8');
+      this.content = fs.readFileSync(this.path, "utf-8");
       this.isUtf8 = true;
     } catch (e) {
       this.isUtf8 = false;
@@ -39,22 +40,48 @@ export class File {
 
   replace(updater: (content: string) => string) {
     if (!this.isUtf8) {
-      console.warn('Not UTF-8 file skipped: ', this.path);
+      console.warn("Not UTF-8 file skipped: ", this.path);
       return;
     }
     this.content = updater(this.content);
-    fs.writeFileSync(this.path, this.content, 'utf-8');
+    fs.writeFileSync(this.path, this.content, "utf-8");
+  }
+
+  write(nextContent: string) {
+    this.content = nextContent;
+    fs.writeFileSync(this.path, this.content, "utf-8");
   }
 }
 
-export function* traverseRecursiveFiles(folder: string): Generator<File> {
+export function* traverseRecursiveFilePaths(
+  folder: string,
+  ig: Ignore = ignore().add(".git"),
+  root: string = folder,
+): Generator<string> {
   const files = fs.readdirSync(folder);
+
+  // add .gitignore to ignore if exists
+  if (fs.existsSync(path.join(folder, ".gitignore"))) {
+    ig.add(fs.readFileSync(path.join(folder, ".gitignore"), "utf-8"));
+  }
+
   for (const file of files) {
     const filePath = path.join(folder, file);
+
+    if (ig.ignores(path.relative(root, filePath))) {
+      continue;
+    }
+
     if (fs.statSync(filePath).isDirectory()) {
-      yield* traverseRecursiveFiles(filePath);
+      yield* traverseRecursiveFilePaths(filePath, ig, root);
     } else {
-      yield new File(filePath);
+      yield filePath;
     }
   }
 }
+
+export function* traverseRecursiveFiles(folder: string): Generator<File> {
+  for (const filePath of traverseRecursiveFilePaths(folder)) {
+    yield new File(filePath);
+  }
+}

package/src/utils/project.ts

@@ -89,6 +89,13 @@ export class Project {
     }
   }
 
+  writeToPackageJsonFile() {
+    writeFileSync(
+      this.packageJsonPath,
+      JSON.stringify(this.packageJson, null, 2),
+    );
+  }
+
   printInfo() {
     console.log(chalk.bold("Project Info:"));
     console.log(chalk.black(`  - Flowgram Version: ${this.flowgramVersion}`));

package/src/utils/ts-file.ts

@@ -5,7 +5,7 @@
 
 import path from "path";
 import fs from "fs";
-import { File } from "./file";
+import { File, traverseRecursiveFilePaths } from "./file";
 import { extractNamedExports } from "./export";
 import {
   assembleImport,
@@ -109,15 +109,9 @@ class TsFile extends File {
 }
 
 export function* traverseRecursiveTsFiles(folder: string): Generator<TsFile> {
-  const files = fs.readdirSync(folder);
-  for (const file of files) {
-    const filePath = path.join(folder, file);
-    if (fs.statSync(filePath).isDirectory()) {
-      yield* traverseRecursiveTsFiles(filePath);
-    } else {
-      if (file.endsWith(".ts") || file.endsWith(".tsx")) {
-        yield new TsFile(filePath);
-      }
+  for (const filePath of traverseRecursiveFilePaths(folder)) {
+    if (filePath.endsWith(".ts") || filePath.endsWith(".tsx")) {
+      yield new TsFile(filePath);
     }
   }
 }