hyperframes 0.1.6 → 0.1.7

package/dist/cli.js

@@ -422,7 +422,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.1.6" : "0.0.0-dev";
+    VERSION = true ? "0.1.7" : "0.0.0-dev";
   }
 });
 
@@ -2748,6 +2748,25 @@ import { existsSync as existsSync3, mkdirSync as mkdirSync3, readdirSync, rmSync
 import { join as join3, dirname } from "path";
 import { homedir as homedir3 } from "os";
 import { execFileSync as execFileSync2 } from "child_process";
+function hasNpx() {
+  try {
+    execFileSync2("npx", ["--version"], { stdio: "ignore", timeout: 5e3 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function runSkillsAdd(repo, agents, global) {
+  const args = ["skills", "add", repo, "-y"];
+  if (global) args.push("-g");
+  for (const agent of agents) {
+    args.push("-a", agent);
+  }
+  execFileSync2("npx", args, {
+    stdio: "ignore",
+    timeout: 12e4
+  });
+}
 function hasGit2() {
   try {
     execFileSync2("git", ["--version"], { stdio: "ignore", timeout: 5e3 });
@@ -2764,6 +2783,7 @@ function gitClone(repo, dest) {
   });
 }
 function fetchRepo(source) {
+  const gitUrl = `https://github.com/${source.repo}.git`;
   if (existsSync3(source.cache)) {
     try {
       execFileSync2("git", ["pull", "--ff-only"], {
@@ -2773,18 +2793,17 @@ function fetchRepo(source) {
         env: GIT_ENV
       });
     } catch {
-      const skillsDir = join3(source.cache, source.skillsPath);
-      if (existsSync3(skillsDir)) {
-        return skillsDir;
-      }
+      const skillsDir2 = join3(source.cache, source.skillsPath);
+      if (existsSync3(skillsDir2)) return skillsDir2;
       rmSync2(source.cache, { recursive: true, force: true });
-      gitClone(source.repo, source.cache);
+      gitClone(gitUrl, source.cache);
     }
   } else {
     mkdirSync3(dirname(source.cache), { recursive: true });
-    gitClone(source.repo, source.cache);
+    gitClone(gitUrl, source.cache);
   }
-  return join3(source.cache, source.skillsPath);
+  const skillsDir = join3(source.cache, source.skillsPath);
+  return existsSync3(skillsDir) ? skillsDir : void 0;
 }
 function installSkillsFromDir(sourceDir, targetDir, sourceName) {
   const installed = [];
@@ -2795,24 +2814,20 @@ function installSkillsFromDir(sourceDir, targetDir, sourceName) {
     const skillFile = join3(sourceDir, entry.name, "SKILL.md");
     if (!existsSync3(skillFile)) continue;
     const destDir = join3(targetDir, entry.name);
-    const overwritten = existsSync3(destDir);
-    if (overwritten) rmSync2(destDir, { recursive: true, force: true });
+    if (existsSync3(destDir)) rmSync2(destDir, { recursive: true, force: true });
     mkdirSync3(destDir, { recursive: true });
     cpSync(join3(sourceDir, entry.name), destDir, { recursive: true });
-    installed.push({ name: entry.name, source: sourceName, overwritten });
+    installed.push({ name: entry.name, source: sourceName });
   }
   return installed;
 }
-async function installAllSkills(targetNames) {
-  if (!hasGit2()) return { count: 0, targets: [], skipped: SOURCES.map((s) => s.name) };
-  const targets = targetNames ? TARGETS.filter((t2) => targetNames.includes(t2.flag)) : TARGETS.filter((t2) => t2.defaultEnabled);
-  let totalCount = 0;
+function fallbackInstall(targets) {
   const skipped = [];
   const fetched = [];
   for (const source of SOURCES) {
     try {
       const skillsDir = fetchRepo(source);
-      if (existsSync3(skillsDir)) {
+      if (skillsDir) {
         fetched.push({ source, skillsDir });
       } else {
         skipped.push(source.name);
@@ -2821,21 +2836,45 @@ async function installAllSkills(targetNames) {
       skipped.push(source.name);
     }
   }
-  const [firstTarget, ...remainingTargets] = targets;
-  if (firstTarget) {
-    mkdirSync3(firstTarget.dir, { recursive: true });
+  const [first, ...rest] = targets;
+  const allInstalled = [];
+  if (first) {
+    mkdirSync3(first.dir, { recursive: true });
     for (const { skillsDir, source } of fetched) {
-      const skills = installSkillsFromDir(skillsDir, firstTarget.dir, source.name);
-      totalCount += skills.length;
+      allInstalled.push(...installSkillsFromDir(skillsDir, first.dir, source.name));
     }
   }
-  for (const target of remainingTargets) {
+  for (const target of rest) {
     mkdirSync3(target.dir, { recursive: true });
     for (const { skillsDir, source } of fetched) {
       installSkillsFromDir(skillsDir, target.dir, source.name);
     }
   }
-  return { count: totalCount, targets: targets.map((t2) => t2.name), skipped };
+  return { count: allInstalled.length, installed: allInstalled, skipped };
+}
+async function installAllSkills(targetNames) {
+  const targets = targetNames ? TARGETS.filter((t2) => targetNames.includes(t2.flag)) : TARGETS.filter((t2) => t2.defaultEnabled);
+  const agents = targets.map((t2) => t2.skillsAgent);
+  if (hasNpx()) {
+    const skipped = [];
+    let count = 0;
+    for (const source of SOURCES) {
+      try {
+        runSkillsAdd(source.repo, agents, true);
+        count += 1;
+      } catch {
+        skipped.push(source.name);
+      }
+    }
+    if (count > 0) {
+      return { count, targets: targets.map((t2) => t2.name), skipped };
+    }
+  }
+  if (!hasGit2()) {
+    return { count: 0, targets: [], skipped: SOURCES.map((s) => s.name) };
+  }
+  const result = fallbackInstall(targets);
+  return { count: result.count, targets: targets.map((t2) => t2.name), skipped: result.skipped };
 }
 function resolveTargets(args) {
   const hasAnyFlag = TARGETS.some((t2) => args[t2.flag] === true);
@@ -2846,70 +2885,57 @@ function resolveTargets(args) {
 }
 async function runInstall({ args }) {
   Wt2(c.bold("hyperframes skills"));
-  if (!hasGit2()) {
-    R2.error(c.error("git is required to install skills. Install git and retry."));
-    Gt(c.warn("No skills installed."));
-    return;
-  }
   const targets = resolveTargets(args);
-  const fetched = [];
-  for (const source of SOURCES) {
-    const spinner = be();
-    spinner.start(`Fetching ${source.name} skills...`);
-    try {
-      const skillsDir = fetchRepo(source);
-      if (existsSync3(skillsDir)) {
-        fetched.push({ source, skillsDir });
-        spinner.stop(c.success(`${source.name} skills fetched`));
-      } else {
-        spinner.stop(c.warn(`${source.name}: no skills directory found`));
+  const agents = targets.map((t2) => t2.skillsAgent);
+  if (hasNpx()) {
+    const installed = [];
+    const skippedSources = [];
+    for (const source of SOURCES) {
+      const spinner = be();
+      spinner.start(`Installing ${source.name} skills...`);
+      try {
+        runSkillsAdd(source.repo, agents, true);
+        installed.push(source.name);
+        spinner.stop(c.success(`${source.name} skills installed`));
+      } catch {
+        skippedSources.push(source.name);
+        spinner.stop(c.dim(`${source.name} skills skipped (unavailable)`));
       }
-    } catch {
-      spinner.stop(c.dim(`${source.name} skills skipped (repo not accessible)`));
     }
-  }
-  const allInstalled = [];
-  let counted = false;
-  for (const target of targets) {
-    const spinner = be();
-    spinner.start(`Installing to ${target.name}...`);
-    mkdirSync3(target.dir, { recursive: true });
-    let count = 0;
-    for (const { source, skillsDir } of fetched) {
-      const skills = installSkillsFromDir(skillsDir, target.dir, source.name);
-      count += skills.length;
-      if (!counted) allInstalled.push(...skills);
+    console.log();
+    console.log(`   ${c.dim("Targets:")}  ${targets.map((t2) => t2.name).join(", ")}`);
+    if (skippedSources.length > 0) {
+      console.log(`   ${c.dim("Skipped:")}  ${skippedSources.join(", ")}`);
     }
-    counted = true;
-    spinner.stop(c.success(`${count} skills \u2192 ${target.name} ${c.dim(target.dir)}`));
+    console.log();
+    if (installed.length > 0) {
+      Gt(c.success(`${installed.join(" + ")} skills installed.`));
+      return;
+    }
+    R2.warn("npx skills add failed \u2014 trying fallback...");
+  }
+  if (!hasGit2()) {
+    R2.error(c.error("Neither npx nor git available. Install Node.js or git and retry."));
+    Gt(c.warn("No skills installed."));
+    return;
   }
+  R2.info(c.dim("Using git fallback..."));
+  const result = fallbackInstall(targets);
   console.log();
   for (const source of SOURCES) {
-    const names = allInstalled.filter((s) => s.source === source.name).map((s) => s.name);
+    const names = result.installed.filter((s) => s.source === source.name).map((s) => s.name);
     if (names.length > 0) {
       const label2 = `${source.name}:`.padEnd(14);
       console.log(`   ${c.dim(label2)} ${names.map((s) => c.accent(s)).join(", ")}`);
     }
   }
   console.log(`   ${c.dim("Targets:")}      ${targets.map((t2) => t2.name).join(", ")}`);
-  console.log();
-  const skippedSources = SOURCES.filter((s) => !fetched.some((f) => f.source.name === s.name));
-  if (skippedSources.length > 0) {
-    console.log(
-      `   ${c.dim("Skipped:")}      ${skippedSources.map((s) => s.name).join(", ")} (repo not accessible)`
-    );
+  if (result.skipped.length > 0) {
+    console.log(`   ${c.dim("Skipped:")}      ${result.skipped.join(", ")}`);
   }
   console.log();
-  if (allInstalled.length > 0 && skippedSources.length > 0) {
-    const readySources = fetched.map((f) => f.source.name).join(", ");
-    const skippedNames = skippedSources.map((s) => s.name).join(", ");
-    Gt(
-      c.warn(
-        `${allInstalled.length} skills ready (${readySources}). Unavailable: ${skippedNames}.`
-      )
-    );
-  } else if (allInstalled.length > 0) {
-    Gt(c.success(`${allInstalled.length} skills ready.`));
+  if (result.count > 0) {
+    Gt(c.success(`${result.count} skills ready.`));
   } else {
     Gt(c.warn("No skills installed."));
   }
@@ -2925,24 +2951,28 @@ var init_install_skills = __esm({
       {
         name: "Claude Code",
         flag: "claude",
+        skillsAgent: "claude-code",
         dir: join3(homedir3(), ".claude", "skills"),
         defaultEnabled: true
       },
       {
         name: "Gemini CLI",
         flag: "gemini",
+        skillsAgent: "gemini-cli",
         dir: join3(homedir3(), ".gemini", "skills"),
         defaultEnabled: true
       },
       {
         name: "Codex CLI",
         flag: "codex",
+        skillsAgent: "codex",
         dir: join3(homedir3(), ".codex", "skills"),
         defaultEnabled: true
       },
       {
         name: "Cursor",
         flag: "cursor",
+        skillsAgent: "cursor",
         get dir() {
           return join3(process.cwd(), ".cursor", "skills");
         },
@@ -2952,13 +2982,13 @@ var init_install_skills = __esm({
     SOURCES = [
       {
         name: "HyperFrames",
-        repo: "https://github.com/heygen-com/hyperframes.git",
+        repo: "heygen-com/hyperframes",
         skillsPath: "skills",
         cache: join3(homedir3(), ".cache", "hyperframes", "hyperframes-skills")
       },
       {
         name: "GSAP",
-        repo: "https://github.com/greensock/gsap-skills.git",
+        repo: "greensock/gsap-skills",
         skillsPath: "skills",
         cache: join3(homedir3(), ".cache", "hyperframes", "gsap-skills")
       }
@@ -24261,12 +24291,21 @@ function transcodeToMp4(inputPath, outputPath) {
     child.on("error", () => resolvePromise(false));
   });
 }
-function getStaticTemplateDir(templateId) {
-  const dir = dirname13(fileURLToPath5(import.meta.url));
-  const devPath = resolve14(dir, "..", "templates", templateId);
-  const builtPath = resolve14(dir, "templates", templateId);
+function resolveAssetDir(devSegments, builtSegments) {
+  const base = dirname13(fileURLToPath5(import.meta.url));
+  const devPath = resolve14(base, ...devSegments);
+  const builtPath = resolve14(base, ...builtSegments);
   return existsSync26(devPath) ? devPath : builtPath;
 }
+function getStaticTemplateDir(templateId) {
+  return resolveAssetDir(["..", "templates", templateId], ["templates", templateId]);
+}
+function getSharedTemplateDir() {
+  return resolveAssetDir(["..", "templates", "_shared"], ["templates", "_shared"]);
+}
+function getBundledSkillsDir() {
+  return resolveAssetDir(["..", "..", "..", "..", "skills"], ["skills"]);
+}
 function patchVideoSrc(dir, videoFilename, durationSeconds) {
   const htmlFiles = readdirSync7(dir, { withFileTypes: true, recursive: true }).filter((e) => e.isFile() && e.name.endsWith(".html")).map((e) => join24(e.parentPath ?? e.path, e.name));
   for (const file of htmlFiles) {
@@ -24417,6 +24456,28 @@ function scaffoldProject(destDir, name, templateId, localVideoName, durationSeco
     ),
     "utf-8"
   );
+  const sharedDir = getSharedTemplateDir();
+  if (existsSync26(sharedDir)) {
+    for (const entry of readdirSync7(sharedDir, { withFileTypes: true })) {
+      const src = join24(sharedDir, entry.name);
+      const dest = resolve14(destDir, entry.name);
+      if (entry.isFile() || entry.isSymbolicLink()) {
+        copyFileSync3(src, dest);
+      }
+    }
+  }
+  const skillsSrcDir = getBundledSkillsDir();
+  if (existsSync26(skillsSrcDir)) {
+    const projectSkills = ["compose-video", "captions"];
+    for (const skill of projectSkills) {
+      const src = join24(skillsSrcDir, skill);
+      if (existsSync26(src)) {
+        const dest = resolve14(destDir, ".claude", "skills", skill);
+        mkdirSync18(dest, { recursive: true });
+        cpSync2(src, dest, { recursive: true });
+      }
+    }
+  }
 }
 async function nextStepLoop(destDir) {
   while (true) {
@@ -24571,9 +24632,28 @@ Example: hyperframes init my-video --template blank --video video.mp4`);
             await installSkills(false);
           }
           console.log(c.success(`Created ${c.accent(name2 + "/")}`));
-          for (const f of readdirSync7(destDir2)) {
+          for (const f of readdirSync7(destDir2).filter((f2) => !f2.startsWith("."))) {
             console.log(`  ${c.accent(f)}`);
           }
+          console.log();
+          console.log("Next steps:");
+          console.log(
+            `  ${c.accent(`cd ${name2}`)} && ${c.accent("npx hyperframes dev")}      ${c.dim("# preview in studio")}`
+          );
+          console.log(
+            `  ${c.accent(`cd ${name2}`)} && ${c.accent("npx hyperframes render")}   ${c.dim("# render to MP4")}`
+          );
+          console.log(
+            `  ${c.accent("npx hyperframes docs")} ${c.dim("<topic>")}              ${c.dim("# learn composition syntax")}`
+          );
+          console.log(
+            `    ${c.dim("topics: data-attributes, gsap, compositions, rendering, templates, troubleshooting")}`
+          );
+          console.log();
+          console.log(
+            `  ${c.dim("AI skills installed \u2014 open this folder in your AI coding agent to get started.")}`
+          );
+          console.log(`  ${c.dim("Full docs: hyperframes.heygen.com")}`);
           return;
         }
         Wt2("Create a new HyperFrames project");