@rootnative/cli 0.0.0-alpha.0 → 0.0.0-alpha.2

package/README.md

@@ -305,6 +305,12 @@ export default function App() {
 }
 ```
 
+## Docs
+
+Full docs: https://rootnative.github.io/ui/cli
+
+LLM-optimized reference: https://rootnative.github.io/ui/llms-full.txt — or read `node_modules/@rootnative/cli/llms.txt` for the exact installed version.
+
 ## License
 
 MIT

package/dist/index.mjs

@@ -277,6 +277,10 @@ function transformImports(source, options) {
     if (importPath.startsWith("@rootnative/core")) {
       return match;
     }
+    if (importPath.startsWith("../internal/")) {
+      const restOfPath = importPath.replace(/^\.\.\/internal\//, "");
+      return `${prefix}${quote}./${restOfPath}${quote}`;
+    }
     if (importPath.startsWith("../")) {
       const targetComponent = extractComponentName(importPath);
       if (targetComponent && installedComponents.includes(targetComponent)) {
@@ -561,6 +565,7 @@ var TEMPLATE_BINARY_FILES = [
   "assets/adaptive-icon.png",
   "assets/favicon.png"
 ];
+var TEMPLATE_OPTIONAL_TEXT_FILES = ["CLAUDE.md"];
 function isValidTemplate(value) {
   return value in TEMPLATE_CONFIGS;
 }
@@ -589,6 +594,11 @@ async function fetchText(url) {
   }
   return res.text();
 }
+async function fetchTextOptional(url) {
+  const res = await fetch(url);
+  if (!res.ok) return null;
+  return res.text();
+}
 async function fetchBinary(url) {
   const res = await fetch(url);
   if (!res.ok) return null;
@@ -737,6 +747,12 @@ async function createCommand(name, options = {}) {
       }
       await fs4.outputFile(path4.join(targetDir, file), content);
     }
+    for (const file of TEMPLATE_OPTIONAL_TEXT_FILES) {
+      const content = await fetchTextOptional(`${templateBaseUrl}/${file}`);
+      if (content !== null) {
+        await fs4.outputFile(path4.join(targetDir, file), content);
+      }
+    }
     for (const file of TEMPLATE_BINARY_FILES) {
       const buffer = await fetchBinary(`${templateBaseUrl}/${file}`);
       if (buffer) {
@@ -912,6 +928,22 @@ async function doctorCommand(cwd) {
     }
   }
   const nodeModules = path5.resolve(cwd, "node_modules");
+  const inertiaPkgPath = path5.join(
+    nodeModules,
+    "@rootnative",
+    "inertia",
+    "package.json"
+  );
+  if (await fs5.pathExists(inertiaPkgPath)) {
+    const inertiaPkg = await fs5.readJSON(inertiaPkgPath);
+    logCheck("pass", `@rootnative/inertia@${inertiaPkg.version} installed`);
+  } else {
+    logCheck(
+      "fail",
+      '@rootnative/inertia not installed (required by all animated components). Run "rootnative upgrade" or install it with react-native-reanimated and react-native-worklets.'
+    );
+    issues++;
+  }
   const safeAreaInstalled = await fs5.pathExists(
     path5.join(nodeModules, "react-native-safe-area-context")
   );
@@ -947,6 +979,41 @@ async function doctorCommand(cwd) {
 import chalk5 from "chalk";
 import { execa as execa3 } from "execa";
 import prompts3 from "prompts";
+
+// src/lib/llm-docs.ts
+import path6 from "path";
+import fs6 from "fs-extra";
+var CLAUDE_MD = "CLAUDE.md";
+var POINTER_MARKER = "@rootnative/components/llms.txt";
+var LLM_DOCS_POINTER = `## RootNative UI docs for AI agents
+
+This project uses RootNative UI (\`@rootnative/*\`). LLM-optimized docs:
+
+- \`node_modules/@rootnative/components/llms.txt\` \u2014 all component props for the exact installed version (works offline)
+- \`node_modules/@rootnative/core/llms.txt\` \u2014 theme system API (\`ThemeProvider\`, \`useTheme\`, \`defineTheme\`)
+- https://rootnative.github.io/ui/llms.txt \u2014 hosted overview (latest release)
+- https://rootnative.github.io/ui/llms-full.txt \u2014 hosted complete API reference (latest release)
+
+Prefer the \`node_modules\` copies \u2014 they match the installed version exactly.
+`;
+async function ensureLlmDocsPointer(cwd) {
+  const filePath = path6.join(cwd, CLAUDE_MD);
+  if (!await fs6.pathExists(filePath)) {
+    await fs6.outputFile(filePath, `# CLAUDE.md
+
+${LLM_DOCS_POINTER}`);
+    return "created";
+  }
+  const existing = await fs6.readFile(filePath, "utf8");
+  if (existing.includes(POINTER_MARKER)) {
+    return "already-present";
+  }
+  const separator = existing.endsWith("\n") ? "\n" : "\n\n";
+  await fs6.outputFile(filePath, `${existing}${separator}${LLM_DOCS_POINTER}`);
+  return "appended";
+}
+
+// src/commands/init.ts
 async function initCommand(cwd, options = {}) {
   logger.break();
   if (await configExists(cwd)) {
@@ -1029,6 +1096,26 @@ async function initCommand(cwd, options = {}) {
   };
   await writeConfig(cwd, config);
   logger.success("Created rootnative.json");
+  let addLlmDocs = options.yes;
+  if (!options.yes) {
+    const answer = await prompts3({
+      type: "confirm",
+      name: "addLlmDocs",
+      message: "Add RootNative LLM docs pointer to CLAUDE.md (for AI agents)?",
+      initial: true
+    });
+    addLlmDocs = answer.addLlmDocs;
+  }
+  if (addLlmDocs) {
+    const result = await ensureLlmDocsPointer(cwd);
+    if (result === "created") {
+      logger.success("Created CLAUDE.md with LLM docs pointer");
+    } else if (result === "appended") {
+      logger.success("Added LLM docs pointer to CLAUDE.md");
+    } else {
+      logger.info("CLAUDE.md already points to the RootNative LLM docs");
+    }
+  }
   let installCore = options.yes;
   if (!options.yes) {
     const answer = await prompts3({
@@ -1065,9 +1152,9 @@ async function initCommand(cwd, options = {}) {
 }
 
 // src/commands/list.ts
-import path6 from "path";
+import path7 from "path";
 import chalk6 from "chalk";
-import fs6 from "fs-extra";
+import fs7 from "fs-extra";
 async function listCommand(cwd) {
   logger.break();
   const config = await readConfig(cwd);
@@ -1093,8 +1180,8 @@ async function listCommand(cwd) {
     `  ${chalk6.dim("-".repeat(70))}`
   );
   for (const component of registryIndex.components) {
-    const componentDir = path6.join(componentsDir, component.name);
-    const installed = await fs6.pathExists(componentDir);
+    const componentDir = path7.join(componentsDir, component.name);
+    const installed = await fs7.pathExists(componentDir);
     const status = installed ? chalk6.green("installed") : chalk6.dim("-");
     const nameDisplay = installed ? chalk6.green(component.name) : component.name;
     console.log(
@@ -1114,9 +1201,9 @@ function padEnd(str, length) {
 }
 
 // src/commands/update.ts
-import path7 from "path";
+import path8 from "path";
 import chalk8 from "chalk";
-import fs7 from "fs-extra";
+import fs8 from "fs-extra";
 import prompts4 from "prompts";
 
 // src/lib/diff.ts
@@ -1266,8 +1353,8 @@ async function updateCommand(componentNames, cwd, options) {
     targetNames = componentNames;
     const missing = [];
     for (const name of targetNames) {
-      const dir = path7.join(componentsDir, name);
-      if (!await fs7.pathExists(dir)) {
+      const dir = path8.join(componentsDir, name);
+      if (!await fs8.pathExists(dir)) {
         missing.push(name);
       }
     }
@@ -1290,8 +1377,8 @@ async function updateCommand(componentNames, cwd, options) {
   resolveSpinner.succeed("Registry fetched");
   const componentDiffs = [];
   for (const { entry } of resolution.components) {
-    const componentDir = path7.join(componentsDir, entry.name);
-    if (!await fs7.pathExists(componentDir)) {
+    const componentDir = path8.join(componentsDir, entry.name);
+    if (!await fs8.pathExists(componentDir)) {
       componentDiffs.push({
         name: entry.name,
         diffs: [],
@@ -1301,8 +1388,8 @@ async function updateCommand(componentNames, cwd, options) {
     }
     const diffs = [];
     for (const filePath of entry.files) {
-      const fileName = path7.basename(filePath);
-      const localPath = path7.join(componentDir, fileName);
+      const fileName = path8.basename(filePath);
+      const localPath = path8.join(componentDir, fileName);
       const remoteContent = await fetchFileContent(config, filePath);
       const transformed = transformImports(remoteContent, {
         config,
@@ -1310,8 +1397,8 @@ async function updateCommand(componentNames, cwd, options) {
         installedComponents: allComponentNames
       });
       let localContent = "";
-      if (await fs7.pathExists(localPath)) {
-        localContent = await fs7.readFile(localPath, "utf-8");
+      if (await fs8.pathExists(localPath)) {
+        localContent = await fs8.readFile(localPath, "utf-8");
       }
       diffs.push(computeDiff(localContent, transformed, fileName));
     }
@@ -1322,12 +1409,12 @@ async function updateCommand(componentNames, cwd, options) {
   for (const utilName of resolution.utils) {
     const utilEntry = utilsRegistry[utilName];
     if (!utilEntry) continue;
-    const fileName = path7.basename(utilEntry.file);
-    const localPath = path7.join(libDir, fileName);
+    const fileName = path8.basename(utilEntry.file);
+    const localPath = path8.join(libDir, fileName);
     const remoteContent = await fetchFileContent(config, utilEntry.file);
     let localContent = "";
-    if (await fs7.pathExists(localPath)) {
-      localContent = await fs7.readFile(localPath, "utf-8");
+    if (await fs8.pathExists(localPath)) {
+      localContent = await fs8.readFile(localPath, "utf-8");
     }
     utilDiffs.push(computeDiff(localContent, remoteContent, `lib/${fileName}`));
   }
@@ -1339,10 +1426,10 @@ async function updateCommand(componentNames, cwd, options) {
     }
   }
   const newBarrel = generateUtilsBarrel(resolution.utils, utilExports);
-  const barrelPath = path7.join(libDir, "rootnative-utils.ts");
+  const barrelPath = path8.join(libDir, "rootnative-utils.ts");
   let oldBarrel = "";
-  if (await fs7.pathExists(barrelPath)) {
-    oldBarrel = await fs7.readFile(barrelPath, "utf-8");
+  if (await fs8.pathExists(barrelPath)) {
+    oldBarrel = await fs8.readFile(barrelPath, "utf-8");
   }
   utilDiffs.push(computeDiff(oldBarrel, newBarrel, "lib/rootnative-utils.ts"));
   const changedComponents = componentDiffs.filter((c) => c.hasChanges);
@@ -1405,8 +1492,8 @@ async function updateCommand(componentNames, cwd, options) {
   const applySpinner = createSpinner("Applying updates...");
   applySpinner.start();
   for (const comp of changedComponents) {
-    const componentDir = path7.join(componentsDir, comp.name);
-    await fs7.ensureDir(componentDir);
+    const componentDir = path8.join(componentsDir, comp.name);
+    await fs8.ensureDir(componentDir);
     if (comp.diffs.length === 0) {
       const entry = resolution.components.find(
         (c) => c.entry.name === comp.name
@@ -1414,14 +1501,14 @@ async function updateCommand(componentNames, cwd, options) {
       if (!entry) continue;
       for (const filePath of entry.entry.files) {
         const content = await fetchFileContent(config, filePath);
-        const fileName = path7.basename(filePath);
+        const fileName = path8.basename(filePath);
         const transformed = transformImports(content, {
           config,
           componentName: comp.name,
           installedComponents: allComponentNames
         });
-        await fs7.writeFile(
-          path7.join(componentDir, fileName),
+        await fs8.writeFile(
+          path8.join(componentDir, fileName),
           transformed,
           "utf-8"
         );
@@ -1431,23 +1518,23 @@ async function updateCommand(componentNames, cwd, options) {
     for (const diff of comp.diffs) {
       if (!diff.hasChanges) continue;
       const newContent = diff.lines.filter((l) => l.type !== "remove").map((l) => l.content).join("\n");
-      await fs7.writeFile(
-        path7.join(componentDir, diff.fileName),
+      await fs8.writeFile(
+        path8.join(componentDir, diff.fileName),
         newContent,
         "utf-8"
       );
     }
   }
-  await fs7.ensureDir(libDir);
+  await fs8.ensureDir(libDir);
   for (const diff of changedUtils) {
     if (!diff.hasChanges) continue;
     const newContent = diff.lines.filter((l) => l.type !== "remove").map((l) => l.content).join("\n");
-    const filePath = path7.join(
+    const filePath = path8.join(
       libDir,
       // diff.fileName is like "lib/color.ts" — strip the "lib/" prefix
       diff.fileName.replace(/^lib\//, "")
     );
-    await fs7.writeFile(filePath, newContent, "utf-8");
+    await fs8.writeFile(filePath, newContent, "utf-8");
   }
   applySpinner.succeed("Updates applied");
   logger.break();
@@ -1457,17 +1544,17 @@ async function updateCommand(componentNames, cwd, options) {
   logger.break();
 }
 async function getInstalledComponents(componentsDir) {
-  if (!await fs7.pathExists(componentsDir)) {
+  if (!await fs8.pathExists(componentsDir)) {
     return [];
   }
-  const entries = await fs7.readdir(componentsDir);
+  const entries = await fs8.readdir(componentsDir);
   const components = [];
   for (const entry of entries) {
-    const fullPath = path7.join(componentsDir, entry);
-    const stat = await fs7.stat(fullPath);
+    const fullPath = path8.join(componentsDir, entry);
+    const stat = await fs8.stat(fullPath);
     if (stat.isDirectory()) {
-      const indexPath = path7.join(fullPath, "index.ts");
-      if (await fs7.pathExists(indexPath)) {
+      const indexPath = path8.join(fullPath, "index.ts");
+      if (await fs8.pathExists(indexPath)) {
         components.push(entry);
       }
     }
@@ -1476,10 +1563,10 @@ async function getInstalledComponents(componentsDir) {
 }
 
 // src/commands/upgrade.ts
-import path8 from "path";
+import path9 from "path";
 import chalk9 from "chalk";
 import { execa as execa4 } from "execa";
-import fs8 from "fs-extra";
+import fs9 from "fs-extra";
 import prompts5 from "prompts";
 async function fetchLatestFromNpm(packageName) {
   const url = `https://registry.npmjs.org/${packageName}/latest`;
@@ -1492,16 +1579,16 @@ async function fetchLatestFromNpm(packageName) {
   return response.json();
 }
 function getInstalledPackageInfo(cwd, packageName) {
-  const pkgPath = path8.resolve(
+  const pkgPath = path9.resolve(
     cwd,
     "node_modules",
     ...packageName.split("/"),
     "package.json"
   );
-  if (!fs8.pathExistsSync(pkgPath)) {
+  if (!fs9.pathExistsSync(pkgPath)) {
     return null;
   }
-  const pkg = fs8.readJSONSync(pkgPath);
+  const pkg = fs9.readJSONSync(pkgPath);
   return {
     version: pkg.version,
     peerDependencies: pkg.peerDependencies,
@@ -1532,9 +1619,9 @@ function diffPeerDeps(current, latest) {
   return { added, changed, removed };
 }
 function getProjectDeps(cwd) {
-  const pkgPath = path8.resolve(cwd, "package.json");
+  const pkgPath = path9.resolve(cwd, "package.json");
   try {
-    const pkg = fs8.readJSONSync(pkgPath);
+    const pkg = fs9.readJSONSync(pkgPath);
     return {
       ...pkg.dependencies,
       ...pkg.devDependencies

package/llms.txt

@@ -1,6 +1,6 @@
 # @rootnative/cli — CLI for RootNative UI
 
-> Version: 0.0.0-alpha.0
+> Version: 0.0.0-alpha.2
 > Binary: `rootnative`
 > Requirements: Node >=18
 

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@rootnative/cli",
-  "version": "0.0.0-alpha.0",
+  "version": "0.0.0-alpha.2",
   "description": "CLI for adding RootNative UI components to your React Native project",
   "private": false,
   "bin": {
     "rootnative": "dist/index.mjs"
   },
-  "exports": "./dist/index.mjs",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": "./dist/index.mjs"
+  },
   "files": [
     "dist",
     "llms.txt"