@texturehq/edges 1.29.1 → 1.30.1

package/scripts/setup-cursor-rules-manual.js

@@ -1,163 +0,0 @@
-#!/usr/bin/env node
-// setup-cursor-rules-manual.js (manual installer for Cursor rules)
-const fs = require("fs");
-const path = require("path");
-
-const setupCursorRules = () => {
-  const cwd = process.cwd();
-
-  // Don't run inside the edges package itself
-  try {
-    const pkgJsonPath = path.join(cwd, "package.json");
-    if (fs.existsSync(pkgJsonPath)) {
-      const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"));
-      if (pkg.name === "@texturehq/edges") return;
-    }
-  } catch {
-    // ignore
-  }
-
-  // Try multiple possible locations for the templates directory
-  const possibleTemplatePaths = [
-    // Yalc path (the actual files)
-    path.join(cwd, "node_modules/.yalc/@texturehq/edges/templates/cursor-rules"),
-    // Regular npm install path
-    path.join(__dirname, "../templates/cursor-rules"),
-    // Alternative paths
-    path.join(__dirname, "../../templates/cursor-rules"),
-    path.join(__dirname, "../../../templates/cursor-rules"),
-    // Direct path from node_modules
-    path.join(cwd, "node_modules/@texturehq/edges/templates/cursor-rules"),
-  ];
-
-  let templatesDir = null;
-  for (const templatePath of possibleTemplatePaths) {
-    if (fs.existsSync(templatePath)) {
-      templatesDir = templatePath;
-      break;
-    }
-  }
-
-  if (!templatesDir) {
-    console.log("⚠️  Could not find cursor rules templates. Tried paths:");
-    possibleTemplatePaths.forEach((path) => console.log(`   - ${path}`));
-    return;
-  }
-
-  console.log(`✅ Found templates at: ${templatesDir}`);
-
-  // Try to read package version from multiple locations
-  const possiblePackageJsonPaths = [
-    // Yalc path (the actual files)
-    path.join(cwd, "node_modules/.yalc/@texturehq/edges/package.json"),
-    // Regular npm install path
-    path.join(__dirname, "../package.json"),
-    path.join(__dirname, "../../package.json"),
-    path.join(__dirname, "../../../package.json"),
-    path.join(cwd, "node_modules/@texturehq/edges/package.json"),
-  ];
-
-  let packageVersion = "unknown";
-  for (const packageJsonPath of possiblePackageJsonPaths) {
-    if (fs.existsSync(packageJsonPath)) {
-      try {
-        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
-        packageVersion = packageJson.version;
-        console.log(`📦 Found package version: ${packageVersion}`);
-        break;
-      } catch (_error) {
-        console.log(`⚠️  Could not read package.json at: ${packageJsonPath}`);
-      }
-    }
-  }
-
-  const templateFiles = fs.readdirSync(templatesDir).filter((file) => file.endsWith(".mdc"));
-
-  if (templateFiles.length === 0) {
-    console.log("⚠️  No .mdc files found in templates directory");
-    return;
-  }
-
-  // Always use package-level rules for version-specific behavior
-  const cursorDir = path.join(cwd, ".cursor");
-  const rulesDir = path.join(cursorDir, "rules");
-
-  // Create directories recursively
-  fs.mkdirSync(cursorDir, { recursive: true });
-  fs.mkdirSync(rulesDir, { recursive: true });
-
-  let copiedCount = 0;
-
-  templateFiles.forEach((file) => {
-    const templatePath = path.join(templatesDir, file);
-
-    // Read template content and inject version info
-    let templateContent = fs.readFileSync(templatePath, "utf8");
-
-    // Add version information to the rule
-    const versionHeader = `\n\n<!-- @texturehq/edges version: ${packageVersion} -->\n`;
-    templateContent = templateContent + versionHeader;
-
-    const targetPath = path.join(rulesDir, file);
-
-    // Always overwrite to ensure version-specific rules
-    fs.writeFileSync(targetPath, templateContent, "utf8");
-    copiedCount++;
-    console.log(`✅ Updated .cursor/rules/${file} for @texturehq/edges v${packageVersion}`);
-  });
-
-  // Additionally, try to render a components list rule from the manifest if available
-  const possibleManifestPaths = [
-    path.join(cwd, "node_modules/.yalc/@texturehq/edges/dist/components.manifest.json"),
-    path.join(cwd, "node_modules/@texturehq/edges/dist/components.manifest.json"),
-  ];
-  let manifestPath = null;
-  for (const p of possibleManifestPaths) {
-    if (fs.existsSync(p)) {
-      manifestPath = p;
-      break;
-    }
-  }
-  if (manifestPath) {
-    try {
-      const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
-      const lines = [
-        "---",
-        "alwaysApply: true",
-        "---",
-        "",
-        `## @texturehq/edges Components (v${manifest.version || "unknown"})`,
-        "",
-      ];
-      for (const c of manifest.components || []) {
-        lines.push(`- ${c.name}`);
-        if (c.importRoot) lines.push(`  - Import: \`import { ${c.name} } from "${c.importRoot}"\``);
-        if (c.importPath)
-          lines.push(`  - Subpath: \`import { ${c.name} } from "${c.importPath}"\``);
-        if (c.props && c.props.length) {
-          const propNames = c.props
-            .slice(0, 8)
-            .map((p) => p.name)
-            .join(", ");
-          lines.push(`  - Props: ${propNames}${c.props.length > 8 ? ", …" : ""}`);
-        }
-      }
-      const outPath = path.join(rulesDir, "edges-components.mdc");
-
-      fs.writeFileSync(outPath, lines.join("\n"), "utf8");
-      console.log(
-        `✅ Wrote .cursor/rules/edges-components.mdc from manifest (${manifest.components?.length || 0} components)`
-      );
-    } catch (err) {
-      console.log("⚠️  Failed to read components.manifest.json:", err.message);
-    }
-  } else {
-    console.log("ℹ️  No components.manifest.json found; skipping edges-components.mdc generation");
-  }
-
-  if (copiedCount > 0) {
-    console.log(`🎨 Updated ${copiedCount} cursor rule(s) for @texturehq/edges v${packageVersion}`);
-  }
-};
-
-setupCursorRules();

package/scripts/setup-cursor-rules.js

@@ -1,277 +0,0 @@
-// scripts/setup-cursor-rules.js
-import fs from "fs";
-import path from "path";
-
-const setupCursorRules = () => {
-  const cwd = process.env.INIT_CWD || process.cwd();
-
-  // Don't run inside the edges package itself
-  try {
-    const pkgJsonPath = path.join(cwd, "package.json");
-    if (fs.existsSync(pkgJsonPath)) {
-      const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"));
-      if (pkg.name === "@texturehq/edges") return;
-    }
-  } catch {
-    // ignore
-  }
-
-  // Clean up legacy generated edges context files
-  const legacyFiles = [
-    path.join(cwd, ".cursor/rules/edges-components-old.mdc"),
-    path.join(cwd, ".claude/edges-components.md"),
-    // Add any other legacy file names here as needed
-  ];
-
-  legacyFiles.forEach((file) => {
-    if (fs.existsSync(file)) {
-      try {
-        fs.unlinkSync(file);
-        console.log(`🧹 Cleaned up legacy file: ${path.relative(cwd, file)}`);
-      } catch (_err) {
-        // Ignore cleanup errors
-      }
-    }
-  });
-
-  const cursorTemplatesDir = path.join(
-    path.dirname(new URL(import.meta.url).pathname),
-    "../templates/cursor-rules"
-  );
-  const claudeTemplatesDir = path.join(
-    path.dirname(new URL(import.meta.url).pathname),
-    "../templates/claude-rules"
-  );
-  const codexTemplatesDir = path.join(
-    path.dirname(new URL(import.meta.url).pathname),
-    "../templates/codex-rules"
-  );
-  const cursorDir = path.join(cwd, ".cursor");
-  const rulesDir = path.join(cursorDir, "rules");
-
-  // Create directories recursively
-  fs.mkdirSync(cursorDir, { recursive: true });
-  fs.mkdirSync(rulesDir, { recursive: true });
-
-  // Setup Cursor rules
-  if (fs.existsSync(cursorTemplatesDir)) {
-    const templateFiles = fs
-      .readdirSync(cursorTemplatesDir)
-      .filter((file) => file.endsWith(".mdc"));
-
-    if (templateFiles.length > 0) {
-      let copiedCount = 0;
-
-      templateFiles.forEach((file) => {
-        const templatePath = path.join(cursorTemplatesDir, file);
-        const targetPath = path.join(rulesDir, file);
-
-        // Always copy to ensure latest version
-        fs.copyFileSync(templatePath, targetPath);
-        copiedCount++;
-        console.log(`✅ Updated .cursor/rules/${file}`);
-      });
-
-      if (copiedCount > 0) {
-        console.log(`🎨 Added ${copiedCount} cursor rule(s) for @texturehq/edges design system`);
-      }
-    }
-  }
-
-  // Setup Claude rules
-  if (fs.existsSync(claudeTemplatesDir)) {
-    const _claudeTemplateFiles = fs
-      .readdirSync(claudeTemplatesDir)
-      .filter((file) => file.endsWith(".md"));
-
-    // Claude template processing is done later with component injection (lines 221-236)
-    // so we don't need to copy templates here
-  }
-
-  // Also render edges-components.mdc from manifest when present
-  const manifestPath = [
-    path.join(cwd, "node_modules/@texturehq/edges/dist/components.manifest.json"),
-  ].find((p) => fs.existsSync(p));
-
-  // Track what we generated for summary
-  let cursorComponentCount = 0;
-  let claudeComponentCount = 0;
-  let codexComponentCount = 0;
-  let packageVersion = "unknown";
-
-  if (manifestPath) {
-    try {
-      const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
-      packageVersion = manifest.version || "unknown";
-      // Don't set counts yet - only set them when files are actually written
-
-      // Generate Cursor components list
-      const cursorLines = [
-        "---",
-        "alwaysApply: true",
-        "---",
-        "",
-        `## @texturehq/edges Components (v${manifest.version || "unknown"})`,
-        "",
-        "### Quick Reference",
-        "",
-      ];
-
-      // Add quick reference list
-      for (const c of manifest.components || []) {
-        cursorLines.push(`- **${c.name}** - ${c.description || "Component"}`);
-      }
-
-      cursorLines.push("");
-      cursorLines.push("### Detailed Component Reference");
-      cursorLines.push("");
-
-      for (const c of manifest.components || []) {
-        cursorLines.push(`#### ${c.name}`);
-        if (c.description) {
-          cursorLines.push(`${c.description}`);
-        }
-        cursorLines.push("");
-        cursorLines.push("**Imports:**");
-        cursorLines.push(`- \`import { ${c.name} } from "@texturehq/edges"\``);
-        cursorLines.push(`- \`import { ${c.name} } from "@texturehq/edges/components/${c.name}"\``);
-        cursorLines.push("");
-
-        if (c.props && c.props.length) {
-          cursorLines.push("**Props:**");
-          // Sort props alphabetically for deterministic output
-          const sortedProps = [...c.props].sort((a, b) => a.name.localeCompare(b.name));
-          sortedProps.forEach((prop) => {
-            cursorLines.push(`- \`${prop.name}: ${prop.type}\``);
-          });
-          cursorLines.push("");
-        }
-        cursorLines.push("---");
-        cursorLines.push("");
-      }
-      const cursorOutPath = path.join(rulesDir, "edges-components.mdc");
-
-      fs.writeFileSync(cursorOutPath, cursorLines.join("\n"), "utf8");
-      cursorComponentCount = manifest.components?.length || 0;
-      console.log(
-        `✅ Wrote .cursor/rules/edges-components.mdc from manifest (${cursorComponentCount} components)`
-      );
-
-      // Generate Claude components list
-      const claudeLines = [];
-      claudeLines.push("### Quick Reference");
-      claudeLines.push("");
-
-      // Add quick reference list
-      for (const c of manifest.components || []) {
-        claudeLines.push(`- **${c.name}** - ${c.description || "Component"}`);
-      }
-
-      claudeLines.push("");
-      claudeLines.push("### Detailed Component Reference");
-      claudeLines.push("");
-
-      for (const c of manifest.components || []) {
-        claudeLines.push(`#### ${c.name}`);
-        if (c.description) {
-          claudeLines.push(`${c.description}`);
-        }
-        claudeLines.push("");
-        claudeLines.push("**Imports:**");
-        claudeLines.push(`- \`import { ${c.name} } from "@texturehq/edges"\``);
-        claudeLines.push(`- \`import { ${c.name} } from "@texturehq/edges/components/${c.name}"\``);
-        claudeLines.push("");
-
-        if (c.props && c.props.length) {
-          claudeLines.push("**Props:**");
-          // Sort props alphabetically for deterministic output
-          const sortedProps = [...c.props].sort((a, b) => a.name.localeCompare(b.name));
-          sortedProps.forEach((prop) => {
-            claudeLines.push(`- \`${prop.name}: ${prop.type}\``);
-          });
-          claudeLines.push("");
-        }
-        claudeLines.push("---");
-        claudeLines.push("");
-      }
-
-      // Update Claude template with components list
-      const claudeTemplatePath = path.join(claudeTemplatesDir, "claude.md");
-      if (fs.existsSync(claudeTemplatePath)) {
-        const claudeDir = path.join(cwd, ".claude");
-        fs.mkdirSync(claudeDir, { recursive: true });
-
-        let claudeContent = fs.readFileSync(claudeTemplatePath, "utf8");
-        claudeContent = claudeContent.split("{{COMPONENTS_LIST}}").join(claudeLines.join("\n"));
-
-        const claudeOutPath = path.join(claudeDir, "edges.md");
-        fs.writeFileSync(claudeOutPath, claudeContent, "utf8");
-        claudeComponentCount = manifest.components?.length || 0;
-        console.log(
-          `✅ Wrote .claude/edges.md with components list (${claudeComponentCount} components)`
-        );
-      }
-
-      // Generate Codex docs using template
-      const codexTemplatePath = path.join(codexTemplatesDir, "codex.md");
-      if (fs.existsSync(codexTemplatePath)) {
-        const codexDir = path.join(cwd, ".codex");
-        fs.mkdirSync(codexDir, { recursive: true });
-
-        let codexContent = fs.readFileSync(codexTemplatePath, "utf8");
-        codexContent = codexContent.split("{{COMPONENTS_LIST}}").join(claudeLines.join("\n"));
-
-        const codexOutPath = path.join(codexDir, "edges.md");
-        fs.writeFileSync(codexOutPath, codexContent, "utf8");
-        codexComponentCount = manifest.components?.length || 0;
-        console.log(
-          `✅ Wrote .codex/edges.md with components list (${codexComponentCount} components)`
-        );
-      }
-    } catch (err) {
-      console.log("⚠️  Failed to read components.manifest.json:", err.message);
-      console.log("   This might mean:");
-      console.log("   1. @texturehq/edges is not installed");
-      console.log("   2. Package is installed but not built");
-      console.log("   3. Try: cd packages/edges && yarn build");
-    }
-  }
-
-  // Return summary for outer handler
-  return {
-    cursorCount: cursorComponentCount,
-    claudeCount: claudeComponentCount,
-    codexCount: codexComponentCount,
-    version: packageVersion,
-  };
-};
-
-try {
-  const result = setupCursorRules();
-
-  // Print summary if we generated context
-  if (result && (result.cursorCount > 0 || result.claudeCount > 0 || result.codexCount > 0)) {
-    console.log("\n" + "=".repeat(60));
-    console.log("🤖 Agent Context Generated Successfully");
-    console.log("=".repeat(60));
-
-    if (result.cursorCount > 0) {
-      console.log(`   ✅ Cursor: ${result.cursorCount} components (v${result.version})`);
-    }
-    if (result.claudeCount > 0) {
-      console.log(`   ✅ Claude: ${result.claudeCount} components (v${result.version})`);
-    }
-    if (result.codexCount > 0) {
-      console.log(`   ✅ Codex: ${result.codexCount} components (v${result.version})`);
-    }
-
-    console.log(`   📦 Source: @texturehq/edges v${result.version}`);
-    console.log("\n💡 Tip: Reload your AI agent to use the latest context");
-    console.log("   Cursor: Cmd+Shift+P → 'Developer: Reload Window'");
-    console.log("   Claude: Restart Claude Desktop / Reload project");
-    console.log("=".repeat(60) + "\n");
-  }
-} catch (err) {
-  console.warn("⚠️  setup-cursor-rules error:", err);
-  console.warn("   Agent context may not be available");
-}

package/scripts/setup-cursor-rules.sh

@@ -1,95 +0,0 @@
-// scripts/setup-cursor-rules.js
-import fs from 'fs';
-import path from 'path';
-
-const setupCursorRules = () => {
-  const cwd = process.cwd();
-  
-  // Don't run in the package itself
-  if (cwd.includes('mono/packages/edges')) {
-    return;
-  }
-  
-  const templatesDir = path.join(__dirname, '../templates/cursor-rules');
-  const cursorDir = path.join(cwd, '.cursor');
-  const rulesDir = path.join(cursorDir, 'rules');
-  
-  // Create directories if they don't exist
-  if (!fs.existsSync(cursorDir)) {
-    fs.mkdirSync(cursorDir);
-  }
-  if (!fs.existsSync(rulesDir)) {
-    fs.mkdirSync(rulesDir);
-  }
-  
-  // Check if templates directory exists
-  if (!fs.existsSync(templatesDir)) {
-    console.log('⚠️  No cursor rules templates found');
-    return;
-  }
-  
-  // Copy all .mdc files from templates to the project's cursor rules
-  const templateFiles = fs.readdirSync(templatesDir).filter(file => file.endsWith('.mdc'));
-  
-  if (templateFiles.length === 0) {
-    console.log('⚠️  No .mdc files found in templates directory');
-    return;
-  }
-  
-  let copiedCount = 0;
-  
-  templateFiles.forEach(file => {
-    const templatePath = path.join(templatesDir, file);
-    const targetPath = path.join(rulesDir, file);
-    
-    // Only copy if the target doesn't already exist
-    if (!fs.existsSync(targetPath)) {
-      fs.copyFileSync(templatePath, targetPath);
-      copiedCount++;
-      console.log(`✅ Added .cursor/rules/${file}`);
-    } else {
-      console.log(`⏭️  Skipped .cursor/rules/${file} (already exists)`);
-    }
-  });
-  
-  if (copiedCount > 0) {
-    console.log(`🎨 Added ${copiedCount} cursor rule(s) for @texturehq/edges design system`);
-  } else {
-    console.log('ℹ️  All cursor rules already exist');
-  }
-
-  // Also render edges-components.mdc from manifest when present
-  const manifestPath = [
-    path.join(cwd, 'node_modules/@texturehq/edges/dist/components.manifest.json')
-  ].find(p => fs.existsSync(p));
-
-  if (manifestPath) {
-    try {
-      const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
-      const lines = [
-        '---',
-        'alwaysApply: true',
-        '---',
-        '',
-        `## @texturehq/edges Components (v${manifest.version || 'unknown'})`,
-        ''
-      ];
-      for (const c of manifest.components || []) {
-        lines.push(`- ${c.name}`);
-        if (c.importRoot) lines.push(`  - Import: \`import { ${c.name} } from "${c.importRoot}"\``);
-        if (c.importPath) lines.push(`  - Subpath: \`import { ${c.name} } from "${c.importPath}"\``);
-        if (c.props && c.props.length) {
-          const propNames = c.props.slice(0, 8).map(p => p.name).join(', ');
-          lines.push(`  - Props: ${propNames}${c.props.length > 8 ? ', …' : ''}`);
-        }
-      }
-      const outPath = path.join(rulesDir, 'edges-components.mdc');
-      fs.writeFileSync(outPath, lines.join('\n'));
-      console.log(`✅ Wrote .cursor/rules/edges-components.mdc from manifest (${manifest.components?.length || 0} components)`);
-    } catch (err) {
-      console.log('⚠️  Failed to read components.manifest.json:', err.message);
-    }
-  }
-};
-
-setupCursorRules();

package/templates/cursor-rules/edges-usage.mdc

@@ -1,65 +0,0 @@
----
-alwaysApply: true
----
-
- Usage Context for @texturehq/edges
-
-## Setup
-This project uses @texturehq/edges design system with Tailwind 4. The theme CSS file contains all design system variables that automatically become available as Tailwind classes.
-
-## Theme Import
-The theme is imported via CSS:
-```css
-@import "@texturehq/edges/theme.css";
-```
-
-## How It Works
-- CSS variables in the theme file automatically become Tailwind classes
-- `--color-brand-primary` becomes available as `bg-brand-primary`, `text-brand-primary`, `border-brand-primary`, etc.
-- `--spacing-md` becomes available as `p-md`, `m-md`, `gap-md`, etc.
-- `--text-lg` becomes available as `text-lg`
-- `--radius-lg` becomes available as `rounded-lg`
-
-## Usage Guidelines
-- **Use semantic classes over arbitrary values**
-- Prefer: `bg-brand-primary`, `text-text-body`, `p-md`, `rounded-lg`
-- Avoid: `bg-[#444ae1]`, `text-[#333333]`, `p-[1rem]`, `rounded-[0.5rem]`
-
-## Naming Conventions
-- Brand colors: `brand-primary`, `brand-light`, `brand-dark`
-- Text colors: `text-body`, `text-heading`, `text-muted`, `text-caption`
-- Background colors: `background-body`, `background-surface`, `background-muted`
-- Border colors: `border-default`, `border-focus`, `border-muted`
-- Action colors: `action-primary`, `action-secondary`, `action-destructive`
-- Feedback colors: `feedback-success`, `feedback-error`, `feedback-warning`, `feedback-info`
-- Spacing: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`, `3xl`, `4xl`
-- Typography: `xs`, `sm`, `base`, `lg`, `xl`, `2xl`, `3xl`, `4xl`
-- Border radius: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`, `3xl`, `4xl`
-
-## Examples
-```html
-<!-- ✅ Good - Uses semantic classes -->
-<div class="bg-brand-primary text-text-on-primary p-md rounded-lg shadow-md">
-  <h2 class="text-text-heading text-lg font-medium">Title</h2>
-  <p class="text-text-body text-base">Content</p>
-</div>
-
-<!-- ❌ Avoid - Uses arbitrary values -->
-<div class="bg-[#444ae1] text-[#ffffff] p-[1rem] rounded-[0.5rem]">
-  <h2 class="text-[#111827] text-[1.125rem] font-[500]">Title</h2>
-  <p class="text-[#333333] text-[1rem]">Content</p>
-</div>
-```
-
-## Dark Mode
-All colors automatically adapt to dark mode when `.theme-dark` class is present.
-
-## Available Variables
-All CSS variables from the theme file are automatically available. The theme includes:
-- Complete color system (brand, text, background, border, action, feedback, device states, data visualization)
-- Spacing scale
-- Typography scale  
-- Border radius scale
-- Shadow system
-- Animation definitions
-- Form control specifications