@cr8rcho/alkahest 0.1.1

package/dist/core/adapters/react-router.js

@@ -0,0 +1,249 @@
+import { readFileSync, existsSync, statSync } from "node:fs";
+import { join, relative, sep, dirname } from "node:path";
+import { Node, SyntaxKind } from "ts-morph";
+import { walk, sourceFileFor, parseReactScreen, titleFromRoute, hasDependency, importMap, resolveComponentFile, } from "./react-jsx.js";
+/**
+ * React Router adapter (generic React SPA: Vite / CRA). Routes are *declared*, not
+ * file-based — so discover parses the router config (data router objects and/or JSX
+ * <Routes>/<Route>), maps each route to the component it renders, and resolves that
+ * component to its source file. parse() then runs the shared JSX parser on that file.
+ *
+ * Screen id = full route path ("/dashboard/settings"). Entry = "/".
+ * Supported route forms:
+ *  - createBrowserRouter / createHashRouter / createMemoryRouter ([{ path, element, children }])
+ *  - JSX <Routes><Route path element /></Routes> (incl. nested + index routes)
+ *  - element={<X/>} or Component={X}; lazy(() => import("…")) component imports
+ */
+const ROUTER_CALLS = new Set(["createBrowserRouter", "createHashRouter", "createMemoryRouter"]);
+const SOURCE_RE = /\.(tsx|jsx|ts|js)$/;
+const CONFIG_HINT = /create(Browser|Hash|Memory)Router|createRoutesFromElements|<Routes[\s>]|<Route[\s/>]/;
+function srcRootOf(projectRoot) {
+    const src = join(projectRoot, "src");
+    return existsSync(src) && statSync(src).isDirectory() ? src : projectRoot;
+}
+export const reactRouterAdapter = {
+    id: "react-router",
+    router: "react-router",
+    detect(projectRoot) {
+        return hasDependency(projectRoot, "react-router-dom", "react-router");
+    },
+    discover(projectRoot) {
+        const root = srcRootOf(projectRoot);
+        const byRoute = new Map();
+        walk(root, (file) => {
+            if (!SOURCE_RE.test(file))
+                return;
+            const src = safeRead(file);
+            if (!CONFIG_HINT.test(src))
+                return; // cheap pre-filter before parsing
+            const sf = sourceFileFor(file);
+            const entries = [...routesFromDataRouter(sf), ...routesFromJsx(sf)];
+            if (entries.length === 0)
+                return;
+            const imports = importMap(sf);
+            const configDir = dirname(file);
+            for (const { route, component } of entries) {
+                if (byRoute.has(route))
+                    continue; // first declaration wins
+                const abs = component ? resolveComponentFile(configDir, imports.get(component)) : null;
+                if (!abs)
+                    continue; // can't open the component → can't extract signals; skip
+                byRoute.set(route, {
+                    absPath: abs,
+                    relPath: relative(projectRoot, abs).split(sep).join("/"),
+                    id: route,
+                    route,
+                    title: titleFromRoute(route),
+                    isEntry: route === "/",
+                });
+            }
+        });
+        return [...byRoute.values()].sort((a, b) => a.route.localeCompare(b.route));
+    },
+    parse(file) {
+        return parseReactScreen(sourceFileFor(file.absPath));
+    },
+};
+// ---------- route extraction ----------
+/** createBrowserRouter([...]) and friends → flattened routes (paths joined through children). */
+function routesFromDataRouter(sf) {
+    const out = [];
+    for (const ce of sf.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+        const expr = ce.getExpression();
+        if (!Node.isIdentifier(expr) || !ROUTER_CALLS.has(expr.getText()))
+            continue;
+        const arg = ce.getArguments()[0];
+        if (arg && Node.isArrayLiteralExpression(arg))
+            walkRouteArray(arg, "/", out);
+    }
+    return out;
+}
+function walkRouteArray(arr, parentPath, out) {
+    if (!Node.isArrayLiteralExpression(arr))
+        return;
+    for (const el of arr.getElements()) {
+        if (Node.isObjectLiteralExpression(el))
+            walkRouteObject(el, parentPath, out);
+    }
+}
+function walkRouteObject(obj, parentPath, out) {
+    const isIndex = boolProp(obj, "index");
+    const pathVal = stringProp(obj, "path");
+    const route = isIndex ? parentPath : joinRoute(parentPath, pathVal);
+    const component = componentOfObject(obj);
+    if (component || pathVal != null || isIndex)
+        out.push({ route, component });
+    const childrenProp = obj.getProperty("children");
+    if (childrenProp && Node.isPropertyAssignment(childrenProp)) {
+        const init = childrenProp.getInitializer();
+        if (init)
+            walkRouteArray(init, route, out);
+    }
+}
+/** <Routes><Route .../></Routes> and createRoutesFromElements(...) → flattened routes. */
+function routesFromJsx(sf) {
+    const out = [];
+    const routes = [
+        ...sf.getDescendantsOfKind(SyntaxKind.JsxElement),
+        ...sf.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement),
+    ].filter((el) => tagName(el) === "Route");
+    for (const el of routes) {
+        if (nearestRouteAncestor(el))
+            continue; // children handled via recursion from their parent
+        walkRouteJsx(el, "/", out);
+    }
+    return out;
+}
+function walkRouteJsx(el, parentPath, out) {
+    const isIndex = jsxBoolAttr(el, "index");
+    const pathVal = jsxStringAttr(el, "path");
+    const route = isIndex ? parentPath : joinRoute(parentPath, pathVal);
+    const component = componentOfJsx(el);
+    if (component || pathVal != null || isIndex)
+        out.push({ route, component });
+    if (Node.isJsxElement(el)) {
+        for (const child of el.getJsxChildren()) {
+            if ((Node.isJsxElement(child) || Node.isJsxSelfClosingElement(child)) && tagName(child) === "Route") {
+                walkRouteJsx(child, route, out);
+            }
+        }
+    }
+}
+// ---------- small ts-morph helpers ----------
+function tagName(el) {
+    return Node.isJsxElement(el) ? el.getOpeningElement().getTagNameNode().getText() : el.getTagNameNode().getText();
+}
+function nearestRouteAncestor(el) {
+    for (let p = el.getParent(); p; p = p.getParent()) {
+        if ((Node.isJsxElement(p) || Node.isJsxSelfClosingElement(p)) && tagName(p) === "Route")
+            return true;
+    }
+    return false;
+}
+/** element={<X/>} / Component={X} → "X". */
+function componentOfJsx(el) {
+    const attrs = Node.isJsxElement(el) ? el.getOpeningElement() : el;
+    const element = attrs.getAttribute("element");
+    if (element && Node.isJsxAttribute(element)) {
+        const init = element.getInitializer();
+        if (init && Node.isJsxExpression(init)) {
+            const inner = init.getExpression();
+            if (inner && (Node.isJsxElement(inner) || Node.isJsxSelfClosingElement(inner)))
+                return tagName(inner);
+        }
+    }
+    const comp = attrs.getAttribute("Component");
+    if (comp && Node.isJsxAttribute(comp)) {
+        const init = comp.getInitializer();
+        if (init && Node.isJsxExpression(init)) {
+            const inner = init.getExpression();
+            if (inner && Node.isIdentifier(inner))
+                return inner.getText();
+        }
+    }
+    return null;
+}
+/** { element: <X/> } / { Component: X } → "X". */
+function componentOfObject(obj) {
+    const element = obj.getProperty("element");
+    if (element && Node.isPropertyAssignment(element)) {
+        const init = element.getInitializer();
+        if (init && (Node.isJsxElement(init) || Node.isJsxSelfClosingElement(init)))
+            return tagName(init);
+    }
+    const comp = obj.getProperty("Component");
+    if (comp && Node.isPropertyAssignment(comp)) {
+        const init = comp.getInitializer();
+        if (init && Node.isIdentifier(init))
+            return init.getText();
+    }
+    return null;
+}
+function stringProp(obj, name) {
+    const prop = obj.getProperty(name);
+    if (prop && Node.isPropertyAssignment(prop)) {
+        const init = prop.getInitializer();
+        if (init && Node.isStringLiteral(init))
+            return init.getLiteralValue();
+    }
+    return null;
+}
+function boolProp(obj, name) {
+    const prop = obj.getProperty(name);
+    if (prop && Node.isPropertyAssignment(prop)) {
+        return prop.getInitializer()?.getText() === "true";
+    }
+    return false;
+}
+function jsxStringAttr(el, name) {
+    const attrs = Node.isJsxElement(el) ? el.getOpeningElement() : el;
+    const attr = attrs.getAttribute(name);
+    if (!attr || !Node.isJsxAttribute(attr))
+        return null;
+    const init = attr.getInitializer();
+    if (!init)
+        return null;
+    if (Node.isStringLiteral(init))
+        return init.getLiteralValue();
+    if (Node.isJsxExpression(init)) {
+        const inner = init.getExpression();
+        if (inner && Node.isStringLiteral(inner))
+            return inner.getLiteralValue();
+    }
+    return null;
+}
+/** Bare boolean attr (`index`) or `index={true}`. */
+function jsxBoolAttr(el, name) {
+    const attrs = Node.isJsxElement(el) ? el.getOpeningElement() : el;
+    const attr = attrs.getAttribute(name);
+    if (!attr || !Node.isJsxAttribute(attr))
+        return false;
+    const init = attr.getInitializer();
+    if (!init)
+        return true; // bare `index`
+    if (Node.isJsxExpression(init))
+        return init.getExpression()?.getText() === "true";
+    return false;
+}
+/** Join a child route segment onto a parent path (react-router relative semantics). */
+function joinRoute(parent, child) {
+    if (child == null || child === "")
+        return parent || "/";
+    if (child.startsWith("/"))
+        return normalize(child);
+    const base = parent === "/" ? "" : parent;
+    return normalize(base + "/" + child);
+}
+function normalize(route) {
+    const r = ("/" + route).replace(/\/{2,}/g, "/");
+    return r.length > 1 ? r.replace(/\/+$/, "") : "/";
+}
+function safeRead(file) {
+    try {
+        return readFileSync(file, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=react-router.js.map

package/dist/core/adapters/react-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-router.js","sourceRoot":"","sources":["../../../src/core/adapters/react-router.ts"],"names":[],"mappings":"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"}

package/dist/core/adapters/remix.d.ts

@@ -0,0 +1,2 @@
+import type { FrameworkAdapter } from "./types.js";
+export declare const remixAdapter: FrameworkAdapter;

package/dist/core/adapters/remix.js

@@ -0,0 +1,109 @@
+import { readdirSync, existsSync, statSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+import { sourceFileFor, parseReactScreen, titleFromRoute, hasDependency } from "./react-jsx.js";
+/**
+ * Remix / React Router 7 (framework mode) adapter. File-based flat routes under `app/routes/`,
+ * parsed with the shared React JSX parser (Remix screens are JSX, same as Next/React Router).
+ *
+ * Flat-route naming → route:
+ *  - `.` separates path segments: `blog.$slug.tsx` → `/blog/:slug`
+ *  - `_index` is the index route (collapses to its parent): `_index.tsx` → `/`, `blog._index.tsx` → `/blog`
+ *  - a leading-underscore segment is a pathless layout (dropped): `_auth.login.tsx` → `/login`
+ *  - `$param` → `:param`, bare `$` → `*` (splat)
+ *  - folder form `routes/blog/route.tsx` is treated like `routes/blog.tsx`
+ *  Screen id = route path; entry = "/".
+ */
+const ROUTE_RE = /\.(tsx|jsx|ts|js)$/;
+function routesDirOf(projectRoot) {
+    return ([join(projectRoot, "app", "routes"), join(projectRoot, "src", "app", "routes")].find((d) => existsSync(d) && statSync(d).isDirectory()) ?? null);
+}
+export const remixAdapter = {
+    id: "remix",
+    router: "remix-routes",
+    detect(projectRoot) {
+        return (hasDependency(projectRoot, "@remix-run/react", "@remix-run/node", "@remix-run/dev", "@react-router/dev") &&
+            routesDirOf(projectRoot) !== null);
+    },
+    discover(projectRoot) {
+        const routesDir = routesDirOf(projectRoot);
+        if (!routesDir)
+            return [];
+        const files = [];
+        const seen = new Set();
+        for (const { abs, routeName } of routeModules(routesDir)) {
+            const route = routeFromFlat(routeName);
+            if (route == null || seen.has(route))
+                continue;
+            seen.add(route);
+            files.push({
+                absPath: abs,
+                relPath: relative(projectRoot, abs).split(sep).join("/"),
+                id: route,
+                route,
+                title: titleFromRoute(route),
+                isEntry: route === "/",
+            });
+        }
+        files.sort((a, b) => a.route.localeCompare(b.route));
+        return files;
+    },
+    parse(file) {
+        return parseReactScreen(sourceFileFor(file.absPath));
+    },
+};
+// ---------- route module enumeration ----------
+/** Each route module = a flat file `routes/<name>.tsx` or a folder `routes/<name>/route.tsx`. */
+function routeModules(routesDir) {
+    const out = [];
+    for (const entry of safeReaddir(routesDir)) {
+        if (entry.name.startsWith("."))
+            continue;
+        const full = join(routesDir, entry.name);
+        if (entry.isDirectory()) {
+            const routeFile = ["route.tsx", "route.jsx", "route.ts", "route.js"]
+                .map((f) => join(full, f))
+                .find((f) => existsSync(f));
+            if (routeFile)
+                out.push({ abs: routeFile, routeName: entry.name });
+        }
+        else if (ROUTE_RE.test(entry.name)) {
+            out.push({ abs: full, routeName: entry.name.replace(ROUTE_RE, "") });
+        }
+    }
+    return out;
+}
+function safeReaddir(dir) {
+    try {
+        return readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+// ---------- flat-route name → route path ----------
+/** Convert a Remix flat-route name (no extension) to a URL path. Null if it's not a routable module. */
+function routeFromFlat(name) {
+    // Skip non-route conventions that sometimes live in routes/ as plain files.
+    if (name === "root")
+        return null;
+    const segs = [];
+    for (const raw of name.split(".")) {
+        if (raw === "_index" || raw === "")
+            continue; // index marker / empty
+        if (raw.startsWith("_"))
+            continue; // pathless layout segment (dropped from URL)
+        if (raw === "$") {
+            segs.push("*"); // splat
+            continue;
+        }
+        if (raw.startsWith("$")) {
+            segs.push(":" + raw.slice(1)); // $slug → :slug
+            continue;
+        }
+        // `parent_` (trailing underscore = break out of layout nesting) keeps the literal sans the underscore
+        segs.push(raw.replace(/_$/, ""));
+    }
+    const route = "/" + segs.join("/");
+    return route.length > 1 ? route.replace(/\/+$/, "") : "/";
+}
+//# sourceMappingURL=remix.js.map

package/dist/core/adapters/remix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remix.js","sourceRoot":"","sources":["../../../src/core/adapters/remix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEhG;;;;;;;;;;;GAWG;AACH,MAAM,QAAQ,GAAG,oBAAoB,CAAC;AAEtC,SAAS,WAAW,CAAC,WAAmB;IACtC,OAAO,CACL,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAClF,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAClD,IAAI,IAAI,CACV,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,EAAE,EAAE,OAAO;IACX,MAAM,EAAE,cAAc;IAEtB,MAAM,CAAC,WAAW;QAChB,OAAO,CACL,aAAa,CAAC,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,CAAC;YACxG,WAAW,CAAC,WAAW,CAAC,KAAK,IAAI,CAClC,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,WAAW;QAClB,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;QAC3C,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAiB,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,KAAK,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YAC/C,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC;gBACT,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBACxD,EAAE,EAAE,KAAK;gBACT,KAAK;gBACL,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;gBAC5B,OAAO,EAAE,KAAK,KAAK,GAAG;aACvB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;CACF,CAAC;AAEF,iDAAiD;AAEjD,iGAAiG;AACjG,SAAS,YAAY,CAAC,SAAiB;IACrC,MAAM,GAAG,GAA8C,EAAE,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC;iBACjE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;iBACzB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,SAAS;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;aAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,qDAAqD;AAErD,wGAAwG;AACxG,SAAS,aAAa,CAAC,IAAY;IACjC,4EAA4E;IAC5E,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,EAAE;YAAE,SAAS,CAAC,uBAAuB;QACrE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,6CAA6C;QAChF,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ;YACxB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB;YAC/C,SAAS;QACX,CAAC;QACD,sGAAsG;QACtG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAC5D,CAAC"}

package/dist/core/adapters/static-html.d.ts

@@ -0,0 +1,2 @@
+import type { FrameworkAdapter } from "./types.js";
+export declare const staticHtmlAdapter: FrameworkAdapter;

package/dist/core/adapters/static-html.js

@@ -0,0 +1,157 @@
+import { readdirSync, readFileSync } from "node:fs";
+import { join, relative, sep, posix } from "node:path";
+/**
+ * Plain multi-page HTML sites — the lowest-fidelity fallback (registered last). Each `.html`
+ * file is a page; cross-page `<a href>` links are transitions. Zero-dependency regex scan.
+ *
+ * Because it's last in the registry, by the time this runs the project matched no framework —
+ * so "a folder of .html files" still yields a product map.
+ *
+ * Mapping:
+ *  - screen id = the page's route ("/about", "/docs/intro"; index.html → its dir)
+ *  - nav = <a href="other.html"> resolved (relative to the page) to a route id
+ *  - call = <form action> / <script> fetch()/XHR
+ *  - feature = <button>, <input|textarea|select>, <form>
+ */
+const HTML_RE = /\.html?$/i;
+const SKIP_DIRS = /^(node_modules|dist|build|out|coverage|\.git)$/i;
+export const staticHtmlAdapter = {
+    id: "static",
+    router: "static-html",
+    detect(projectRoot) {
+        let found = false;
+        walkHtml(projectRoot, () => {
+            found = true;
+        });
+        return found;
+    },
+    discover(projectRoot) {
+        const files = [];
+        walkHtml(projectRoot, (file) => {
+            const route = routeFromHtmlFile(projectRoot, file);
+            files.push({
+                absPath: file,
+                relPath: relative(projectRoot, file).split(sep).join("/"),
+                id: route,
+                route,
+                title: titleFromHtmlFile(route, file),
+                isEntry: route === "/",
+            });
+        });
+        files.sort((a, b) => a.route.localeCompare(b.route));
+        return files;
+    },
+    parse(file) {
+        return parseHtml(safeRead(file.absPath), file.route);
+    },
+};
+// ---------- discovery ----------
+function walkHtml(dir, onFile) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith(".") || SKIP_DIRS.test(entry.name))
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.isDirectory())
+            walkHtml(full, onFile);
+        else if (HTML_RE.test(entry.name))
+            onFile(full);
+    }
+}
+/** File path → route. `index.html` collapses to its dir; ".html" stripped; leading "/". */
+function routeFromHtmlFile(root, file) {
+    const rel = relative(root, file).split(sep).join("/").replace(HTML_RE, "");
+    const segs = rel.split("/").filter(Boolean);
+    if (segs[segs.length - 1] === "index")
+        segs.pop();
+    const route = "/" + segs.join("/");
+    return route.length > 1 ? route.replace(/\/+$/, "") : "/";
+}
+function titleFromHtmlFile(route, file) {
+    // Prefer the page's <title>, else derive from the route's last segment.
+    const m = safeRead(file).match(/<title[^>]*>([^<]+)<\/title>/i);
+    if (m && m[1].trim())
+        return m[1].trim();
+    if (route === "/")
+        return "Home";
+    const last = route.split("/").filter(Boolean).pop() ?? route;
+    return last.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function safeRead(file) {
+    try {
+        return readFileSync(file, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+// ---------- parsing (regex scan) ----------
+const FEATURE_RULES = [
+    { re: /<button\b[^>]*>([^<]*)/i, kind: "button", label: (m) => m[1].trim() || "Button" },
+    { re: /<(?:input|textarea|select)\b[^>]*\bplaceholder=["']([^"']*)["']/i, kind: "input", label: (m) => m[1] || "Input" },
+    { re: /<(?:input|textarea|select)\b/i, kind: "input", label: () => "Input" },
+    { re: /<form\b/i, kind: "form", label: () => "Form" },
+];
+const HREF = /<a\b[^>]*?\shref=["']([^"'#]+)["']/i;
+const FORM_ACTION = /<form\b[^>]*?\saction=["']([^"']+)["']/i;
+const FETCH = /\bfetch\s*\(\s*["'`]([^"'`]+)["'`]/;
+/** `routeBase` is the page's own route, used to resolve relative <a href> into absolute route ids. */
+function parseHtml(src, routeBase) {
+    const navs = [];
+    const calls = [];
+    const features = [];
+    const lines = src.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        const lineNo = i + 1;
+        const href = line.match(HREF);
+        if (href) {
+            const target = resolveHref(href[1], routeBase);
+            navs.push({ target, raw: snippet(line), trigger: "<a href>", line: lineNo });
+        }
+        const action = line.match(FORM_ACTION);
+        if (action)
+            calls.push({ url: action[1], method: "POST", raw: snippet(line), trigger: "<form action>", line: lineNo });
+        const fetchM = line.match(FETCH);
+        if (fetchM)
+            calls.push({ url: fetchM[1], raw: snippet(line), trigger: "fetch", line: lineNo });
+        for (const rule of FEATURE_RULES) {
+            const m = line.match(rule.re);
+            if (m) {
+                features.push({ kind: rule.kind, label: rule.label(m), detail: m[0].trim().slice(0, 40), line: lineNo });
+                break;
+            }
+        }
+    }
+    return { navs, calls, features, components: [], contains: [] };
+}
+/**
+ * Resolve an <a href> to a screen-route id so transitions match other pages.
+ * External URLs pass through untouched; otherwise strip ".html"/query, resolve relative to the
+ * page's route dir, and collapse a trailing "index".
+ */
+function resolveHref(href, routeBase) {
+    if (/^https?:\/\//i.test(href) || href.startsWith("mailto:") || href.startsWith("tel:"))
+        return href;
+    const clean = href.split(/[?#]/)[0].replace(HTML_RE, "");
+    if (!clean)
+        return routeBase;
+    const baseDir = routeBase === "/" ? "/" : routeBase.replace(/\/[^/]*$/, "") || "/";
+    const abs = clean.startsWith("/") ? clean : posix.join(baseDir, clean);
+    const segs = abs.split("/").filter(Boolean);
+    if (segs[segs.length - 1] === "index")
+        segs.pop();
+    const route = "/" + segs.join("/");
+    return route.length > 1 ? route.replace(/\/+$/, "") : "/";
+}
+function snippet(text) {
+    const flat = text.replace(/\s+/g, " ").trim();
+    return flat.length > 80 ? flat.slice(0, 77) + "..." : flat;
+}
+//# sourceMappingURL=static-html.js.map

package/dist/core/adapters/static-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-html.js","sourceRoot":"","sources":["../../../src/core/adapters/static-html.ts"],"names":[],"mappings":"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"}

package/dist/core/adapters/sveltekit.d.ts

@@ -0,0 +1,2 @@
+import type { FrameworkAdapter } from "./types.js";
+export declare const svelteKitAdapter: FrameworkAdapter;