create-bl-theme 1.0.6 → 1.0.8

package/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(cat:*)",
+      "Bash(node /Users/boidu/Developer/create-bl-theme/bin/cli.js bump:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/README.md

@@ -45,9 +45,41 @@ The validator checks:
 - Required files (metadata.json, style.rics or style.css, images/)
 - RICS syntax validation (for .rics files)
 - Valid JSON structure and required fields
+- Semver version format
 - Image integrity (detects corrupted files)
 - Image dimensions (recommends 1280x720, but other sizes work fine)
 
+### Bump version
+
+```bash
+# Bump patch version (1.0.0 → 1.0.1)
+create-bl-theme bump patch
+
+# Bump minor version (1.0.0 → 1.1.0)
+create-bl-theme bump minor
+
+# Bump major version (1.0.0 → 2.0.0)
+create-bl-theme bump major
+
+# Bump in a specific directory
+create-bl-theme bump patch ./my-theme
+```
+
+### Check publishing status
+
+```bash
+# Check if theme is registered and ready to publish
+create-bl-theme publish
+
+# Check a specific directory
+create-bl-theme publish ./my-theme
+```
+
+The publish command:
+- Checks if your theme is registered in the theme store
+- Shows your current version vs. the registry version
+- Provides setup instructions for auto-publishing
+
 ## Generated Structure
 
 ```
@@ -130,6 +162,16 @@ Better Lyrics supports **GitHub Flavored Markdown (GFM)** in DESCRIPTION.md, so
    ```
 4. Open a pull request
 
+### Auto-Publishing
+
+After your theme is registered, install the [Better Lyrics Themes](https://github.com/marketplace/better-lyrics-themes) GitHub App on your repo. This enables automatic updates:
+
+1. Bump your version: `create-bl-theme bump patch`
+2. Commit and push
+3. The registry automatically validates and publishes your update
+
+Use `create-bl-theme publish` to check your publishing status.
+
 ## License
 
 MIT

package/bin/cli.js

@@ -22,12 +22,28 @@ const RECOMMENDED_HEIGHT = 720;
 // GitHub URL patterns
 const GITHUB_URL_PATTERN = /^(?:https?:\/\/)?(?:www\.)?github\.com\/([^\/]+)\/([^\/]+)(?:\/)?(?:\.git)?$/;
 
+// Load package.json for version
+const pkg = JSON.parse(
+  fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf-8")
+);
+
 async function main() {
   const args = process.argv.slice(2);
   const command = args[0];
 
+  // Handle flags first (no banner)
+  if (command === "--version" || command === "-v" || command === "version") {
+    console.log(pkg.version);
+    return;
+  }
+
+  if (command === "--help" || command === "-h" || command === "help") {
+    showHelp();
+    return;
+  }
+
   console.log();
-  console.log(pc.bold(pc.cyan("  Better Lyrics Theme Creator")));
+  console.log(pc.bold(pc.cyan("  Better Lyrics Theme Creator")) + pc.dim(` v${pkg.version}`));
   console.log(pc.dim("  Create themes for Better Lyrics extension"));
   console.log();
 
@@ -41,8 +57,8 @@ async function main() {
     return;
   }
 
-  if (command === "help" || command === "--help" || command === "-h") {
-    showHelp();
+  if (command === "bump") {
+    await bump(args[1], args[2]);
     return;
   }
 
@@ -50,16 +66,27 @@ async function main() {
 }
 
 function showHelp() {
-  console.log(`${pc.bold("Usage:")}
+  console.log(`
+${pc.bold(pc.cyan("create-bl-theme"))} ${pc.dim(`v${pkg.version}`)}
+CLI for Better Lyrics themes
+
+${pc.bold("Usage:")}
   ${pc.cyan("create-bl-theme")} [name]              Create a new theme
   ${pc.cyan("create-bl-theme")} validate [dir|url]  Validate a theme (local or GitHub)
   ${pc.cyan("create-bl-theme")} publish [dir]       Check publishing status
+  ${pc.cyan("create-bl-theme")} bump [type] [dir]   Bump version (patch, minor, major)
+
+${pc.bold("Options:")}
+  ${pc.cyan("-v, --version")}  Show version number
+  ${pc.cyan("-h, --help")}     Show this help message
 
 ${pc.bold("Examples:")}
   ${pc.dim("$")} create-bl-theme my-awesome-theme
   ${pc.dim("$")} create-bl-theme validate ./my-theme
   ${pc.dim("$")} create-bl-theme validate https://github.com/user/theme-repo
   ${pc.dim("$")} create-bl-theme publish
+  ${pc.dim("$")} create-bl-theme bump patch
+  ${pc.dim("$")} create-bl-theme bump minor ./my-theme
 
 ${pc.bold("Theme Structure:")}
   my-theme/
@@ -762,11 +789,16 @@ function getGitRemote(themePath) {
 async function checkThemeRegistered(repo) {
   try {
     const response = await fetch(
-      "https://raw.githubusercontent.com/better-lyrics/themes/main/index.json"
+      "https://raw.githubusercontent.com/better-lyrics/themes/master/index.json"
     );
+    if (!response.ok) {
+      console.log(pc.dim(`  (Could not fetch registry: ${response.status})`));
+      return false;
+    }
     const index = await response.json();
     return index.themes?.some((t) => t.repo === repo) ?? false;
-  } catch {
+  } catch (e) {
+    console.log(pc.dim(`  (Could not fetch registry: ${e.message})`));
     return false;
   }
 }
@@ -774,7 +806,7 @@ async function checkThemeRegistered(repo) {
 async function checkLockStatus(repo) {
   try {
     const response = await fetch(
-      "https://raw.githubusercontent.com/better-lyrics/themes/main/index.lock.json"
+      "https://raw.githubusercontent.com/better-lyrics/themes/master/index.lock.json"
     );
     const lock = await response.json();
     return lock.themes?.find((t) => t.repo === repo) ?? null;
@@ -783,6 +815,90 @@ async function checkLockStatus(repo) {
   }
 }
 
+async function bump(typeOrDir, dirArg) {
+  // Handle flexible argument order: bump [type] [dir] or bump [dir]
+  let type = "patch";
+  let dir = ".";
+
+  const validTypes = ["patch", "minor", "major"];
+
+  if (typeOrDir) {
+    if (validTypes.includes(typeOrDir)) {
+      type = typeOrDir;
+      dir = dirArg || ".";
+    } else {
+      // Assume it's a directory
+      dir = typeOrDir;
+    }
+  }
+
+  const fullPath = path.resolve(process.cwd(), dir);
+  const metadataPath = path.join(fullPath, "metadata.json");
+
+  // Check metadata.json exists
+  if (!fs.existsSync(metadataPath)) {
+    console.log(pc.red("Error: metadata.json not found."));
+    process.exit(1);
+  }
+
+  let metadata;
+  try {
+    metadata = JSON.parse(fs.readFileSync(metadataPath, "utf-8"));
+  } catch (e) {
+    console.log(pc.red(`Error: Invalid metadata.json - ${e.message}`));
+    process.exit(1);
+  }
+
+  const currentVersion = metadata.version;
+  if (!currentVersion) {
+    console.log(pc.red("Error: No version field in metadata.json"));
+    process.exit(1);
+  }
+
+  // Parse current version
+  const match = currentVersion.match(/^(\d+)\.(\d+)\.(\d+)(.*)$/);
+  if (!match) {
+    console.log(pc.red(`Error: Invalid version format "${currentVersion}"`));
+    process.exit(1);
+  }
+
+  let [, major, minor, patch, prerelease] = match;
+  major = parseInt(major, 10);
+  minor = parseInt(minor, 10);
+  patch = parseInt(patch, 10);
+
+  // Bump version
+  switch (type) {
+    case "major":
+      major++;
+      minor = 0;
+      patch = 0;
+      prerelease = "";
+      break;
+    case "minor":
+      minor++;
+      patch = 0;
+      prerelease = "";
+      break;
+    case "patch":
+    default:
+      patch++;
+      prerelease = "";
+      break;
+  }
+
+  const newVersion = `${major}.${minor}.${patch}`;
+  metadata.version = newVersion;
+
+  // Write back
+  fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2) + "\n");
+
+  console.log(pc.green(`  ${currentVersion} → ${newVersion}`));
+  console.log();
+  console.log(pc.dim(`  Updated ${metadataPath}`));
+  console.log();
+}
+
 main().catch((err) => {
   console.error(pc.red(err.message));
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-bl-theme",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "CLI tool to scaffold Better Lyrics themes",
   "type": "module",
   "bin": {