@texturehq/edges 1.5.1 → 1.5.3

package/scripts/generate-utilities-manifest.js

@@ -23,13 +23,19 @@ function extractJSDoc(content, functionName) {
   // Look for JSDoc block immediately before the function/const declaration
   const patterns = [
     // Function declaration: /** ... */ export function name OR export async function name
-    new RegExp(`\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+(?:async\\s+)?function\\s+${functionName}\\b`, "s"),
+    new RegExp(
+      `\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+(?:async\\s+)?function\\s+${functionName}\\b`,
+      "s"
+    ),
     // Arrow function: /** ... */ export const name =
     new RegExp(`\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+const\\s+${functionName}\\s*=`, "s"),
     // Type export: /** ... */ export type name
     new RegExp(`\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+type\\s+${functionName}\\b`, "s"),
     // Interface export: /** ... */ export interface name
-    new RegExp(`\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+interface\\s+${functionName}\\b`, "s"),
+    new RegExp(
+      `\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+interface\\s+${functionName}\\b`,
+      "s"
+    ),
   ];
 
   for (const pattern of patterns) {
@@ -56,7 +62,10 @@ function extractJSDoc(content, functionName) {
  */
 function extractParams(content, functionName) {
   const patterns = [
-    new RegExp(`\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+(?:async\\s+)?function\\s+${functionName}\\b`, "s"),
+    new RegExp(
+      `\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+(?:async\\s+)?function\\s+${functionName}\\b`,
+      "s"
+    ),
     new RegExp(`\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+const\\s+${functionName}\\s*=`, "s"),
   ];
 
@@ -89,7 +98,10 @@ function extractParams(content, functionName) {
  */
 function extractReturns(content, functionName) {
   const patterns = [
-    new RegExp(`\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+(?:async\\s+)?function\\s+${functionName}\\b`, "s"),
+    new RegExp(
+      `\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+(?:async\\s+)?function\\s+${functionName}\\b`,
+      "s"
+    ),
     new RegExp(`\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+const\\s+${functionName}\\s*=`, "s"),
   ];
 
@@ -119,7 +131,10 @@ function extractReturns(content, functionName) {
  */
 function extractExample(content, functionName) {
   const patterns = [
-    new RegExp(`\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+(?:async\\s+)?function\\s+${functionName}\\b`, "s"),
+    new RegExp(
+      `\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+(?:async\\s+)?function\\s+${functionName}\\b`,
+      "s"
+    ),
     new RegExp(`\\/\\*\\*([^*]|\\*(?!\\/))*\\*\\/\\s*export\\s+const\\s+${functionName}\\s*=`, "s"),
   ];
 
@@ -137,7 +152,10 @@ function extractExample(content, functionName) {
             .join("\n")
             .trim();
           // Remove ```typescript and ``` markers if present
-          return example.replace(/^```\w*\n?/, "").replace(/\n?```$/, "").trim();
+          return example
+            .replace(/^```\w*\n?/, "")
+            .replace(/\n?```$/, "")
+            .trim();
         }
       }
     }
@@ -153,7 +171,7 @@ function extractExports(filePath) {
   if (!content) return [];
 
   const utilities = [];
-  
+
   // Match export function declarations
   const functionPattern = /export\s+(?:async\s+)?function\s+(\w+)/g;
   let match;
@@ -174,9 +192,12 @@ function extractExports(filePath) {
   while ((match = constPattern.exec(content))) {
     const name = match[1];
     // Check if it's likely a function (has => or function keyword after =)
-    const afterMatch = content.slice(match.index + match[0].length, match.index + match[0].length + 50);
+    const afterMatch = content.slice(
+      match.index + match[0].length,
+      match.index + match[0].length + 50
+    );
     const isFunction = afterMatch.includes("=>") || afterMatch.includes("function");
-    
+
     utilities.push({
       name,
       type: isFunction ? "function" : "constant",
@@ -207,28 +228,24 @@ function extractExports(filePath) {
  */
 function scanDirectory(dir, category) {
   const utilities = [];
-  
+
   if (!fs.existsSync(dir)) return utilities;
-  
+
   const files = fs.readdirSync(dir);
-  
+
   for (const file of files) {
     const filePath = path.join(dir, file);
     const stat = fs.statSync(filePath);
-    
+
     if (stat.isDirectory() && file !== "__tests__" && file !== "tests") {
       // Recursively scan subdirectories
       utilities.push(...scanDirectory(filePath, `${category}/${file}`));
     } else if ((file.endsWith(".ts") || file.endsWith(".tsx")) && !file.endsWith(".d.ts")) {
       // Skip test files, stories, and type definition files
-      if (
-        file.includes(".test.") ||
-        file.includes(".spec.") ||
-        file.includes(".stories.")
-      ) {
+      if (file.includes(".test.") || file.includes(".spec.") || file.includes(".stories.")) {
         continue;
       }
-      
+
       const funcs = extractExports(filePath);
       for (const func of funcs) {
         utilities.push({
@@ -239,43 +256,45 @@ function scanDirectory(dir, category) {
       }
     }
   }
-  
+
   return utilities;
 }
 
 function run() {
   try {
     console.log("Generating utilities manifest...");
-    
+
     const manifest = {
       version: process.env.npm_package_version || "unknown",
       generatedAt: new Date().toISOString(),
       categories: {},
     };
-    
+
     // Scan hooks directory
     const hooksDir = path.join(SRC_DIR, "hooks");
     const hooks = scanDirectory(hooksDir, "hooks");
     if (hooks.length > 0) {
       manifest.categories.hooks = {
-        description: "React hooks for common functionality like debouncing, local storage, and time controls",
+        description:
+          "React hooks for common functionality like debouncing, local storage, and time controls",
         utilities: hooks.sort((a, b) => a.name.localeCompare(b.name)),
       };
     }
-    
+
     // Scan utils directory
     const utilsDir = path.join(SRC_DIR, "utils");
-    
+
     // Formatting utilities
     const formattingDir = path.join(utilsDir, "formatting");
     const formatting = scanDirectory(formattingDir, "formatting");
     if (formatting.length > 0) {
       manifest.categories.formatting = {
-        description: "Comprehensive formatting utilities for text, numbers, dates, currency, energy, temperature, distance, and more",
+        description:
+          "Comprehensive formatting utilities for text, numbers, dates, currency, energy, temperature, distance, and more",
         utilities: formatting.sort((a, b) => a.name.localeCompare(b.name)),
       };
     }
-    
+
     // Chart utilities
     const chartsDir = path.join(utilsDir, "charts");
     const charts = scanDirectory(chartsDir, "charts");
@@ -283,52 +302,56 @@ function run() {
     const chartUtils = extractExports(path.join(utilsDir, "charts.ts"));
     const allChartUtils = [
       ...charts,
-      ...chartExportUtils.map(f => ({ ...f, category: "charts", file: "utils/chartExport.ts" })),
-      ...chartUtils.map(f => ({ ...f, category: "charts", file: "utils/charts.ts" }))
+      ...chartExportUtils.map((f) => ({ ...f, category: "charts", file: "utils/chartExport.ts" })),
+      ...chartUtils.map((f) => ({ ...f, category: "charts", file: "utils/charts.ts" })),
     ];
-    
+
     if (allChartUtils.length > 0) {
       manifest.categories.charts = {
         description: "Chart utilities for data visualization, scaling, and export functionality",
         utilities: allChartUtils.sort((a, b) => a.name.localeCompare(b.name)),
       };
     }
-    
+
     // Color utilities
     const colorUtils = extractExports(path.join(utilsDir, "colors.ts"));
     if (colorUtils.length > 0) {
       manifest.categories.colors = {
-        description: "Color management utilities for theme-aware color resolution, contrast calculation, and palette generation",
-        utilities: colorUtils.map(f => ({ ...f, category: "colors", file: "utils/colors.ts" }))
+        description:
+          "Color management utilities for theme-aware color resolution, contrast calculation, and palette generation",
+        utilities: colorUtils
+          .map((f) => ({ ...f, category: "colors", file: "utils/colors.ts" }))
           .sort((a, b) => a.name.localeCompare(b.name)),
       };
     }
-    
+
     // General utilities from utils/index.ts
     const generalUtils = extractExports(path.join(utilsDir, "index.ts"));
     if (generalUtils.length > 0) {
       manifest.categories.general = {
-        description: "General utility functions for focus management, Tailwind class composition, and theme utilities",
-        utilities: generalUtils.map(f => ({ ...f, category: "general", file: "utils/index.ts" }))
+        description:
+          "General utility functions for focus management, Tailwind class composition, and theme utilities",
+        utilities: generalUtils
+          .map((f) => ({ ...f, category: "general", file: "utils/index.ts" }))
           .sort((a, b) => a.name.localeCompare(b.name)),
       };
     }
-    
+
     // Add summary
     const totalUtilities = Object.values(manifest.categories).reduce(
       (sum, cat) => sum + cat.utilities.length,
       0
     );
-    
+
     manifest.summary = {
       totalUtilities,
       totalCategories: Object.keys(manifest.categories).length,
-      categories: Object.keys(manifest.categories).map(cat => ({
+      categories: Object.keys(manifest.categories).map((cat) => ({
         name: cat,
         count: manifest.categories[cat].utilities.length,
       })),
     };
-    
+
     // Add import information
     manifest.importInfo = {
       package: "@texturehq/edges",
@@ -348,15 +371,15 @@ function run() {
         {
           description: "Import color utilities",
           code: 'import { getResolvedColor, isLightColor } from "@texturehq/edges"',
-        }
+        },
       ],
     };
-    
+
     // Write the manifest
     ensureDir(DIST_DIR);
     const outputPath = path.join(DIST_DIR, "utilities.manifest.json");
     fs.writeFileSync(outputPath, JSON.stringify(manifest, null, 2));
-    
+
     console.log(
       `Generated ${path.join("dist", "utilities.manifest.json")} with ${totalUtilities} utilities in ${Object.keys(manifest.categories).length} categories.`
     );

package/scripts/generate-viz-runtime.js

@@ -92,4 +92,3 @@ try {
   console.error("❌ Error generating viz-runtime.css:", error);
   process.exit(1);
 }
-