From c1e2414fb085dc63fa89a8d6e9df5a44c44d4a72 Mon Sep 17 00:00:00 2001
From: lorenzozanee <wyz0707@proton.me>
Date: Mon, 12 Oct 2026 00:19:31 +0800
Subject: [PATCH 1/2] fix(pipeline): resolve parent-relative non-code imports

Signed-off-by: lorenzozanee <wyz0707@proton.me>
---
 src/pipeline/fqn.c         |  3 ++
 src/pipeline/pass_pkgmap.c | 16 +++++++
 tests/test_edge_imports.c  | 98 ++++++++++++++++++++++++++++++++++++++
 3 files changed, 117 insertions(+)

diff --git a/src/pipeline/fqn.c b/src/pipeline/fqn.c
index 96e959a0b..cb2c49a5b 100644
--- a/src/pipeline/fqn.c
+++ b/src/pipeline/fqn.c
@@ -317,6 +317,9 @@ static char *resolve_js_relative(char *buf, size_t buf_size, const char *module_
             continue;
         }
         if (seg_len == FQN_DOTDOT_LEN && seg_start[0] == '.' && seg_start[FQN_SEP_LEN] == '.') {
+            if (!buf[0]) {
+                return NULL;
+            }
             path_pop_segment(buf);
             continue;
         }
diff --git a/src/pipeline/pass_pkgmap.c b/src/pipeline/pass_pkgmap.c
index f12dd8d4e..c934c9829 100644
--- a/src/pipeline/pass_pkgmap.c
+++ b/src/pipeline/pass_pkgmap.c
@@ -2305,6 +2305,22 @@ const cbm_gbuf_node_t *cbm_pipeline_resolve_import_node(const cbm_pipeline_ctx_t
         }
     }
 
+    /* Relative non-module files can have a File QN that does not match the
+     * module QN above. Resolve the exact file after module and sibling lookup. */
+    if (imp->module_path[0] == '.' &&
+        (imp->module_path[1] == '/' ||
+         (imp->module_path[1] == '.' && imp->module_path[2] == '/'))) {
+        char *resolved = cbm_pipeline_resolve_relative_import(source_rel, imp->module_path);
+        if (resolved) {
+            const cbm_gbuf_node_t *file =
+                cbm_pipeline_file_node(ctx->gbuf, ctx->project_name, resolved);
+            free(resolved);
+            if (file) {
+                return file;
+            }
+        }
+    }
+
     /* Strategy 2: namespace map.  `using App.Utils`, `import com.example.Foo`,
      * `use App\Utils\Helper` name a NAMESPACE (or a member of it) that the
      * path-based QN cannot express.  Try the full module path and progressively
diff --git a/tests/test_edge_imports.c b/tests/test_edge_imports.c
index 685cad0fb..fbeb90942 100644
--- a/tests/test_edge_imports.c
+++ b/tests/test_edge_imports.c
@@ -266,6 +266,102 @@ static int ei_edge_present(const EILangFile *files, int nfiles, const char *edge
     return got >= floor;
 }
 
+typedef struct {
+    const char *importer;
+    const char *target;
+} EIFileEdgeExpect;
+
+static int ei_file_edges_match(const EILangFile *files, int nfiles, const EIFileEdgeExpect *want,
+                               int nwant, int expected_count) {
+    EILangProj lp;
+    cbm_store_t *store = ei_index_files(&lp, files, nfiles);
+    int ok = store && cbm_store_count_edges_by_type(store, lp.project, "IMPORTS") == expected_count;
+    if (store && !ok) {
+        int got = cbm_store_count_edges_by_type(store, lp.project, "IMPORTS");
+        fprintf(stderr, "  [IMPORTS] FAIL count=%d expected==%d\n", got, expected_count);
+    }
+    for (int i = 0; store && i < nwant; i++) {
+        int64_t source_id = ei_node_id_for_file_label(store, lp.project, want[i].importer, "File");
+        cbm_edge_t *edges = NULL;
+        int edge_count = 0;
+        int found = 0;
+        if (source_id > 0 &&
+            cbm_store_find_edges_by_source_type(store, source_id, "IMPORTS", &edges, &edge_count) ==
+                CBM_STORE_OK) {
+            for (int j = 0; j < edge_count; j++) {
+                cbm_node_t target;
+                memset(&target, 0, sizeof(target));
+                if (cbm_store_find_node_by_id(store, edges[j].target_id, &target) == CBM_STORE_OK) {
+                    found = target.file_path && strcmp(target.file_path, want[i].target) == 0;
+                    cbm_node_free_fields(&target);
+                }
+                if (found) {
+                    break;
+                }
+            }
+        }
+        cbm_store_free_edges(edges, edge_count);
+        if (!found) {
+            fprintf(stderr, "  [IMPORTS] FAIL %s -> %s\n", want[i].importer, want[i].target);
+            ok = 0;
+        }
+    }
+    ei_cleanup(&lp, store);
+    return ok;
+}
+
+TEST(ei_relative_astro_css_imports_issue2558) {
+    static const EILangFile f[] = {
+        {"Badge.astro", "<span>outside</span>\n"},
+        {"src/components/shared/Button.astro",
+         "---\nexport function buttonLabel(t: string): string { return t; }\n---\n<button />\n"},
+        {"src/components/Badge.astro", "<span>badge</span>\n"},
+        {"src/components/Card.astro",
+         "---\nimport Badge from './Badge.astro';\n"
+         "import Button from './shared/Button.astro';\n---\n<div><Badge /><Button /></div>\n"},
+        {"src/layouts/local.css", "body { margin: 0; }\n"},
+        {"src/styles/global.css", "body { color: black; }\n"},
+        {"src/layouts/Layout.astro",
+         "---\nimport '../styles/global.css';\nimport './local.css';\n---\n"
+         "<html><body><slot /></body></html>\n"},
+        {"src/lib/format.ts", "export function formatTitle(t: string): string { return t.trim(); }\n"},
+        {"src/lib/registry.ts",
+         "import Badge from '../components/Badge.astro';\n"
+         "import '../styles/global.css';\n"
+         "import { formatTitle } from './format';\n"
+         "export function registry(): unknown[] { return [Badge, formatTitle]; }\n"},
+        {"src/lib/sub/deep.ts",
+         "import { formatTitle } from '../format';\n"
+         "import { registry } from '../registry.ts';\n"
+         "export function deep(): string { registry(); return formatTitle('x'); }\n"},
+        {"src/pages/index.astro",
+         "---\nimport Layout from '../layouts/Layout.astro';\n"
+         "import Card from '../components/Card.astro';\n"
+         "import Outside from '../../../Badge.astro';\n"
+         "import { formatTitle } from '../lib/format';\n"
+         "const title = formatTitle(' Home ');\n---\n"
+         "<Layout><h1>{title}</h1><Card /></Layout>\n"},
+    };
+    static const EIFileEdgeExpect want[] = {
+        {"src/components/Card.astro", "src/components/Badge.astro"},
+        {"src/components/Card.astro", "src/components/shared/Button.astro"},
+        {"src/layouts/Layout.astro", "src/styles/global.css"},
+        {"src/layouts/Layout.astro", "src/layouts/local.css"},
+        {"src/lib/registry.ts", "src/components/Badge.astro"},
+        {"src/lib/registry.ts", "src/styles/global.css"},
+        {"src/lib/registry.ts", "src/lib/format.ts"},
+        {"src/lib/sub/deep.ts", "src/lib/format.ts"},
+        {"src/lib/sub/deep.ts", "src/lib/registry.ts"},
+        {"src/pages/index.astro", "src/layouts/Layout.astro"},
+        {"src/pages/index.astro", "src/components/Card.astro"},
+        {"src/pages/index.astro", "src/lib/format.ts"},
+    };
+
+    ASSERT_TRUE(ei_file_edges_match(f, (int)(sizeof(f) / sizeof(f[0])), want,
+                                    (int)(sizeof(want) / sizeof(want[0])), 12));
+    PASS();
+}
+
 /* ═══════════════════════════════════════════════════════════════════════════
  * GREEN GUARD — Python
  *
@@ -1604,6 +1700,8 @@ TEST(ei_php_psr4_missing_class_file_unresolved_issue1186) {
  * ═══════════════════════════════════════════════════════════════════════════ */
 
 SUITE(edge_imports) {
+    RUN_TEST(ei_relative_astro_css_imports_issue2558);
+
     /* ── GREEN GUARDS — Python (must stay passing) ── */
     RUN_TEST(ei_python_relative_from_import);
     RUN_TEST(ei_python_absolute_import);

From 0baad9450fcb63bc3d50d8c597a205bf10d1befd Mon Sep 17 00:00:00 2001
From: Martin Vogel <martin.vogel.tech@gmail.com>
Date: Tue, 20 Oct 2026 03:32:28 +0200
Subject: [PATCH 2/2] fix(pipeline): resolve relative import files without a
 raw allocation

Resolve the exact File an explicit relative import names through
cbm_repo_rel_join into stack buffers instead of the allocating relative
resolver, so the raw allocator count of pass_pkgmap.c does not grow
(memory-core ratchet). The helper refuses a path above the repository
root and honours php_only like the other strategies in
resolve_import_strategies, which main gained after the base of this
branch.

Signed-off-by: Martin Vogel <martin.vogel.tech@gmail.com>
---
 src/pipeline/pass_pkgmap.c | 52 ++++++++++++++++++++++++++++----------
 1 file changed, 38 insertions(+), 14 deletions(-)

diff --git a/src/pipeline/pass_pkgmap.c b/src/pipeline/pass_pkgmap.c
index 8313e84ef..ef3ba0f10 100644
--- a/src/pipeline/pass_pkgmap.c
+++ b/src/pipeline/pass_pkgmap.c
@@ -2115,6 +2115,37 @@ static const cbm_gbuf_node_t *resolve_sibling_file(const cbm_pipeline_ctx_t *ctx
     return found;
 }
 
+/* The File an explicit relative import (`./x`, `../x`) names exactly, for
+ * files whose File QN differs from the module QN Strategy 1 tries
+ * (`../styles/global.css`, `../layouts/Layout.astro`, #2558). Resolved in
+ * stack buffers by cbm_repo_rel_join, which refuses a path above the
+ * repository root. */
+static const cbm_gbuf_node_t *resolve_relative_file(const cbm_pipeline_ctx_t *ctx,
+                                                    const char *source_rel, const char *module_path,
+                                                    bool php_only) {
+    if (!source_rel || !module_path || module_path[0] != '.' ||
+        !(module_path[1] == '/' || (module_path[1] == '.' && module_path[2] == '/'))) {
+        return NULL;
+    }
+    char dir[PKGMAP_PATH_BUF];
+    int dir_len = snprintf(dir, sizeof(dir), "%s", source_rel);
+    if (dir_len < 0 || (size_t)dir_len >= sizeof(dir)) {
+        return NULL;
+    }
+    char *slash = strrchr(dir, '/');
+    if (slash) {
+        *slash = '\0';
+    } else {
+        dir[0] = '\0';
+    }
+    char path[PKGMAP_PATH_BUF];
+    if (!cbm_repo_rel_join(dir, module_path, path, sizeof(path))) {
+        return NULL;
+    }
+    const cbm_gbuf_node_t *file = cbm_pipeline_file_node(ctx->gbuf, ctx->project_name, path);
+    return file && (!php_only || node_in_php_file(file)) ? file : NULL;
+}
+
 /* ── PHP PSR-4 class imports (#1186) ──────────────────────────────── */
 
 typedef enum {
@@ -2389,20 +2420,13 @@ static const cbm_gbuf_node_t *resolve_import_strategies(
         }
     }
 
-    /* Relative non-module files can have a File QN that does not match the
-     * module QN above. Resolve the exact file after module and sibling lookup. */
-    if (imp->module_path[0] == '.' &&
-        (imp->module_path[1] == '/' ||
-         (imp->module_path[1] == '.' && imp->module_path[2] == '/'))) {
-        char *resolved = cbm_pipeline_resolve_relative_import(source_rel, imp->module_path);
-        if (resolved) {
-            const cbm_gbuf_node_t *file =
-                cbm_pipeline_file_node(ctx->gbuf, ctx->project_name, resolved);
-            free(resolved);
-            if (file) {
-                return file;
-            }
-        }
+    /* Strategy 1c: relative non-module files can have a File QN that does not
+     * match the module QN above. Resolve the exact file after module and
+     * sibling lookup. */
+    const cbm_gbuf_node_t *rel_file =
+        resolve_relative_file(ctx, source_rel, imp->module_path, php_only);
+    if (rel_file) {
+        return rel_file;
     }
 
     /* Strategy 2: namespace map.  `using App.Utils`, `import com.example.Foo`,