@yoamigo.com/core 0.4.8 → 1.0.1

package/dist/router.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, MouseEvent } from 'react';
-export { Route, Switch, useParams } from 'wouter';
+export { Route, Switch, useLocation, useParams } from 'wouter';
 
 /**
  * Router Abstraction - Shared Types
@@ -55,4 +55,82 @@ declare function Router({ children, base }: RouterProps): react_jsx_runtime.JSX.
  */
 declare function ScrollRestoration(): null;
 
-export { Link, type LinkProps, type NavigateFunction, Router, type RouterProps$1 as RouterProps, ScrollRestoration, useNavigate };
+/**
+ * Route Utilities
+ *
+ * Utilities for working with file-based routing conventions.
+ * Converts file paths with [param] syntax to wouter-compatible route paths.
+ *
+ * @example
+ * ```
+ * /src/pages/contact.tsx         → /contact
+ * /src/pages/products/index.tsx  → /products
+ * /src/pages/products/[slug].tsx → /products/:slug
+ * /src/pages/blog/[category]/[slug].tsx → /blog/:category/:slug
+ * ```
+ */
+interface RouteDefinition {
+    /** The wouter-compatible route path (e.g., '/products/:slug') */
+    path: string;
+    /** The original file path */
+    filePath: string;
+    /** Parameter names extracted from the path */
+    params: string[];
+    /** Whether this is a dynamic route (has params) */
+    isDynamic: boolean;
+}
+/**
+ * Convert a file path to a wouter-compatible route path.
+ *
+ * Supports:
+ * - `/src/pages/contact.tsx` → `/contact`
+ * - `/src/pages/index.tsx` → `/`
+ * - `/src/pages/products/index.tsx` → `/products`
+ * - `/src/pages/products/[slug].tsx` → `/products/:slug`
+ * - `/src/pages/blog/[category]/[slug].tsx` → `/blog/:category/:slug`
+ * - `/src/pages/[...rest].tsx` → `/:rest*` (catch-all)
+ *
+ * @param filePath - The file path (e.g., '/src/pages/products/[slug].tsx')
+ * @param options - Options for path conversion
+ * @returns The wouter-compatible route path
+ */
+declare function filePathToRoutePath(filePath: string, options?: {
+    /** Pages directory prefix to strip (default: '/src/pages') */
+    pagesDir?: string;
+    /** File extensions to remove (default: ['.tsx', '.ts', '.jsx', '.js']) */
+    extensions?: string[];
+}): string;
+/**
+ * Extract parameter names from a file path.
+ *
+ * @param filePath - The file path (e.g., '/src/pages/blog/[category]/[slug].tsx')
+ * @returns Array of parameter names (e.g., ['category', 'slug'])
+ */
+declare function extractRouteParams(filePath: string): string[];
+/**
+ * Create a RouteDefinition from a file path.
+ *
+ * @param filePath - The file path (e.g., '/src/pages/products/[slug].tsx')
+ * @param options - Options for path conversion
+ * @returns RouteDefinition object
+ */
+declare function createRouteDefinition(filePath: string, options?: Parameters<typeof filePathToRoutePath>[1]): RouteDefinition;
+/**
+ * Sort route definitions by specificity (most specific first).
+ * Static routes come before dynamic routes.
+ * More specific dynamic routes come before less specific ones.
+ *
+ * @param routes - Array of RouteDefinition objects
+ * @returns Sorted array (most specific first)
+ */
+declare function sortRoutesBySpecificity(routes: RouteDefinition[]): RouteDefinition[];
+/**
+ * Generate a path with parameters filled in.
+ *
+ * @param routePath - The route path with params (e.g., '/products/:slug')
+ * @param params - Object with parameter values (e.g., { slug: 'guitar' })
+ * @returns The filled path (e.g., '/products/guitar')
+ */
+declare function generatePath(routePath: string, params: Record<string, string>): string;
+
+export { Link, type LinkProps, type NavigateFunction, type RouteDefinition, Router, type RouterProps$1 as RouterProps, ScrollRestoration, createRouteDefinition, extractRouteParams, filePathToRoutePath, generatePath, sortRoutesBySpecificity, useNavigate };

package/dist/router.js

@@ -137,13 +137,86 @@ function ScrollRestoration() {
 }
 
 // src/router/index.ts
-import { Route, Switch, useParams } from "wouter";
+import { Route, Switch, useParams, useLocation as useLocation3 } from "wouter";
+
+// src/router/route-utils.ts
+function filePathToRoutePath(filePath, options = {}) {
+  const {
+    pagesDir = "/src/pages",
+    extensions = [".tsx", ".ts", ".jsx", ".js"]
+  } = options;
+  let path = filePath;
+  if (path.startsWith(pagesDir)) {
+    path = path.slice(pagesDir.length);
+  }
+  for (const ext of extensions) {
+    if (path.endsWith(ext)) {
+      path = path.slice(0, -ext.length);
+      break;
+    }
+  }
+  if (path.endsWith("/index")) {
+    path = path.slice(0, -6) || "/";
+  }
+  path = path.replace(/\[\.\.\.([^\]]+)\]/g, ":$1*");
+  path = path.replace(/\[([^\]]+)\]/g, ":$1");
+  if (!path.startsWith("/")) {
+    path = "/" + path;
+  }
+  if (path === "" || path === "/index") {
+    return "/";
+  }
+  return path;
+}
+function extractRouteParams(filePath) {
+  const matches = filePath.matchAll(/\[\.\.\.([^\]]+)\]|\[([^\]]+)\]/g);
+  const params = [];
+  for (const match of matches) {
+    params.push(match[1] || match[2]);
+  }
+  return params;
+}
+function createRouteDefinition(filePath, options) {
+  const path = filePathToRoutePath(filePath, options);
+  const params = extractRouteParams(filePath);
+  return {
+    path,
+    filePath,
+    params,
+    isDynamic: params.length > 0
+  };
+}
+function sortRoutesBySpecificity(routes) {
+  return [...routes].sort((a, b) => {
+    if (!a.isDynamic && b.isDynamic) return -1;
+    if (a.isDynamic && !b.isDynamic) return 1;
+    const aSegments = a.path.split("/").filter(Boolean);
+    const bSegments = b.path.split("/").filter(Boolean);
+    if (aSegments.length !== bSegments.length) {
+      return bSegments.length - aSegments.length;
+    }
+    return a.params.length - b.params.length;
+  });
+}
+function generatePath(routePath, params) {
+  let path = routePath;
+  for (const [key, value] of Object.entries(params)) {
+    path = path.replace(new RegExp(`:${key}\\*?`, "g"), encodeURIComponent(value));
+  }
+  return path;
+}
 export {
   Link,
   Route,
   Router,
   ScrollRestoration,
   Switch,
+  createRouteDefinition,
+  extractRouteParams,
+  filePathToRoutePath,
+  generatePath,
+  sortRoutesBySpecificity,
+  useLocation3 as useLocation,
   useNavigate,
   useParams
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoamigo.com/core",
-  "version": "0.4.8",
+  "version": "1.0.1",
   "description": "Core components, router, and utilities for YoAmigo templates",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",

package/dist/builder-selection-CYP91nRu.d.ts

@@ -1,6 +0,0 @@
-/**
- * Initialize builder selection when running in iframe
- */
-declare function initBuilderSelection(): void;
-
-export { initBuilderSelection as i };