evolit 0.1.1 → 0.1.2

package/README.md

@@ -32,6 +32,20 @@ Supported authored module extensions:
 - `.tsx`
 - `.mjs`
 
+### Internal imports
+
+Imports beginning with `@/` resolve from the application root in server and browser graphs. This
+keeps internal imports stable when modules move between route directories:
+
+```jsx
+import FeatureCard from "@/app/components/feature-card";
+import { formatPrice } from "@/lib/format-price";
+```
+
+Generated applications declare `"@/*": ["./*"]` in `jsconfig.json`, so editors and typechecking
+use the same convention. An explicit `@/*` mapping in `jsconfig.json` or `tsconfig.json` takes
+priority when an application needs a different source root.
+
 ## Commands
 
 ```sh

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolit",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "A convention-driven application framework for LitSX and web components.",
   "type": "module",
   "packageManager": "yarn@4.10.3",

package/src/compiler.js

@@ -706,8 +706,24 @@ async function resolveProjectPathAlias(projectRoot, specifier) {
   return null;
 }
 
+async function resolveProjectRootAlias(projectRoot, specifier) {
+  if (!specifier.startsWith("@/") || specifier.length === 2) return null;
+
+  const normalizedProjectRoot = path.resolve(projectRoot);
+  const candidatePath = path.resolve(normalizedProjectRoot, specifier.slice(2));
+  const relativePath = path.relative(normalizedProjectRoot, candidatePath);
+  const isOutsideProject =
+    relativePath === ".."
+    || relativePath.startsWith(`..${path.sep}`)
+    || path.isAbsolute(relativePath);
+  if (isOutsideProject) return null;
+
+  return resolveImportPath(path.join(normalizedProjectRoot, "__alias__.js"), candidatePath);
+}
+
 async function resolveProjectMappedImport(projectRoot, importerPath, specifier) {
   return await resolveProjectPathAlias(projectRoot, specifier)
+    ?? await resolveProjectRootAlias(projectRoot, specifier)
     ?? await resolveProjectPackageImportMap(importerPath, specifier);
 }
 

package/templates/default/app/page.jsx

@@ -1,4 +1,4 @@
-import FeatureCard from "./components/feature-card.jsx";
+import FeatureCard from "@/app/components/feature-card";
 
 export default async function HomePage() {
   return (

package/templates/default/jsconfig.json

@@ -9,6 +9,11 @@
     "jsx": "react-jsx",
     "jsxImportSource": "@litsx/core",
     "allowArbitraryExtensions": true,
+    "paths": {
+      "@/*": [
+        "./*"
+      ]
+    },
     "plugins": [
       {
         "name": "@litsx/typescript"