@textjs/app 0.0.0-stage → 1.0.3

package/dist/server/scan.js

@@ -0,0 +1,161 @@
+/**
+ * File-system scanner for the `app/` directory (Node only).
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+import { flattenRoutes, matchAppRoutes, ROUTE_FILE_KINDS } from "../routing.js";
+export const ROUTE_EXTENSIONS = [".tsx", ".ts", ".jsx", ".js"];
+export function toPosix(p) {
+    return sep === "\\" ? p.split(sep).join("/") : p;
+}
+function findFile(dir, base, entries) {
+    for (const ext of ROUTE_EXTENSIONS)
+        if (entries.has(base + ext))
+            return join(dir, base + ext);
+    return undefined;
+}
+function scanDir(dir, segment) {
+    const entries = new Set(readdirSync(dir));
+    const files = {};
+    for (const kind of ROUTE_FILE_KINDS) {
+        const f = findFile(dir, kind, entries);
+        if (f)
+            files[kind] = f;
+    }
+    const node = { segment, dir, files, route: findFile(dir, "route", entries), children: [] };
+    for (const name of [...entries].sort()) {
+        if (name.startsWith(".") || name.startsWith("_") || name === "node_modules")
+            continue;
+        const full = join(dir, name);
+        let isDir = false;
+        try {
+            isDir = statSync(full).isDirectory();
+        }
+        catch {
+            continue;
+        }
+        if (isDir)
+            node.children.push(scanDir(full, name));
+    }
+    return node;
+}
+/** Scan `<root>/<appDir>` into a segment tree. */
+export function scanApp(root, appDir = "app") {
+    const dir = join(root, appDir);
+    if (!existsSync(dir))
+        return { root, appDir: dir, tree: { segment: "", dir, files: {}, children: [] } };
+    return { root, appDir: dir, tree: scanDir(dir, "") };
+}
+/** `true` when `file` is a route file the manifest depends on. */
+export function isRouteFile(file, appDir) {
+    const rel = toPosix(relative(appDir, file));
+    if (rel.startsWith(".."))
+        return false;
+    const base = rel.split("/").pop() ?? "";
+    const name = base.replace(/\.(tsx|ts|jsx|js)$/, "");
+    if (name === base)
+        return false;
+    return ROUTE_FILE_KINDS.includes(name) || name === "route";
+}
+const FORCE_DYNAMIC = /export\s+const\s+dynamic\s*=\s*["']force-dynamic["']/;
+function isForceDynamicFile(file) {
+    if (!file)
+        return false;
+    try {
+        return FORCE_DYNAMIC.test(readFileSync(file, "utf8"));
+    }
+    catch {
+        return false;
+    }
+}
+/** A manifest with placeholder modules (for summaries and matching on the server). */
+export function toStaticManifest(scan) {
+    const convert = (s) => {
+        const node = { segment: s.segment, files: {} };
+        for (const kind of ROUTE_FILE_KINDS) {
+            const f = s.files[kind];
+            if (!f)
+                continue;
+            const key = kind === "not-found" ? "notFound" : kind;
+            node[key] = isForceDynamicFile(f) ? { dynamic: "force-dynamic" } : {};
+            node.files[kind] = toPosix(relative(scan.root, f));
+        }
+        const children = s.children.map(convert).filter((c) => hasContent(c));
+        if (children.length > 0)
+            node.children = children;
+        return node;
+    };
+    return convert(scan.tree);
+}
+function hasContent(n) {
+    return Boolean(n.page || n.layout || n.loading || n.error || n.notFound || (n.children && n.children.length > 0));
+}
+/** API route handlers as a manifest (route files stand in for pages). */
+export function toApiManifest(scan) {
+    const convert = (s) => {
+        const node = { segment: s.segment };
+        if (s.route) {
+            node.page = {};
+            node.files = { page: s.route };
+        }
+        const children = s.children.map(convert).filter((c) => c.page || (c.children && c.children.length > 0));
+        if (children.length > 0)
+            node.children = children;
+        return node;
+    };
+    return convert(scan.tree);
+}
+export function listApiRoutes(scan) {
+    return flattenRoutes(toApiManifest(scan)).map((r) => ({ pattern: r.pattern, file: r.file }));
+}
+export function matchApiRoute(api, pathname) {
+    const m = matchAppRoutes(api, pathname);
+    if (!m)
+        return null;
+    const leaf = m.chain[m.chain.length - 1];
+    const file = leaf.files?.page;
+    return file ? { file, params: m.params, pattern: m.pattern } : null;
+}
+export function listPages(scan) {
+    return flattenRoutes(toStaticManifest(scan));
+}
+/** Generate the `virtual:textjs/routes` module source. */
+export function generateRoutesModule(scan, options = {}) {
+    const imports = [];
+    let n = 0;
+    const ref = (file, lazy) => {
+        const spec = JSON.stringify(toPosix(file));
+        if (lazy)
+            return `() => import(${spec})`;
+        const id = `m${n++}`;
+        imports.push(`import * as ${id} from ${spec};`);
+        return id;
+    };
+    const emit = (s, indent) => {
+        const props = [`segment: ${JSON.stringify(s.segment)}`];
+        const files = [];
+        for (const kind of ROUTE_FILE_KINDS) {
+            const f = s.files[kind];
+            if (!f)
+                continue;
+            const key = kind === "not-found" ? "notFound" : kind;
+            props.push(`${key}: ${ref(f, kind === "page" && options.lazyPages === true)}`);
+            files.push(`${JSON.stringify(kind)}: ${JSON.stringify(toPosix(relative(scan.root, f)))}`);
+        }
+        if (files.length > 0)
+            props.push(`files: { ${files.join(", ")} }`);
+        const kids = s.children.map((c) => emit(c, `${indent}  `)).filter((c) => c !== null);
+        if (kids.length > 0)
+            props.push(`children: [\n${kids.map((k) => `${indent}  ${k}`).join(",\n")}\n${indent}]`);
+        if (files.length === 0 && kids.length === 0 && s.segment !== "")
+            return null;
+        return `{ ${props.join(", ")} }`;
+    };
+    const body = emit(scan.tree, "") ?? `{ segment: "" }`;
+    const lines = [...imports, "", `export const routes = ${body};`, "export default routes;"];
+    if (options.hmr) {
+        lines.push("if (import.meta.hot) {", "  import.meta.hot.accept((mod) => {", "    if (mod && typeof window !== 'undefined' && window.__TEXTJS_APP__) window.__TEXTJS_APP__.updateRoutes(mod.routes);", "  });", "}");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=scan.js.map

package/dist/server/scan.js.map

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

package/dist/server/server-components.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Async Server Components for server-rendered console routes.
+ *
+ * React's client reconciler (which the console renderer is) re-runs an
+ * `async function` component on every retry, creating a fresh promise each
+ * time, so it never settles. On the server, `text dev` / `text build` alias
+ * `react/jsx-runtime` to {@link ./jsx-runtime}, which swaps every async
+ * component for a wrapper that memoizes its promise per session, navigation
+ * and props, then unwraps it with `use()` (suspending to the nearest
+ * `<Suspense>` / `loading.tsx` meanwhile). The data access stays on the server:
+ * these modules never ship to the frame player.
+ */
+import { type ComponentType, type ReactNode } from "react";
+type AnyComponent = (props: any) => unknown;
+/** Promises kept per cache (least recently used are dropped first). */
+export declare const SERVER_COMPONENT_CACHE_SIZE = 256;
+/** Per-session promise cache, cleared whenever the route or `router.refresh()` generation changes. */
+export declare class ServerComponentCache {
+    private generation;
+    private readonly entries;
+    private readonly ids;
+    private nextId;
+    private inflight;
+    private settledAt;
+    private readonly maxEntries;
+    private readonly onActivity;
+    /** `onActivity` runs whenever a component's promise starts or settles (idle tracking). */
+    constructor(options?: {
+        maxEntries?: number;
+        onActivity?: () => void;
+    });
+    get size(): number;
+    /** Component promises that have not settled yet. */
+    get pending(): number;
+    /** `Date.now()` when a component promise last settled (0 = never). */
+    get lastSettled(): number;
+    clear(): void;
+    /** Stable identity id for functions, symbols-as-objects and non-plain objects. */
+    idOf(value: object): number;
+    read(component: AnyComponent, props: object, generation: string): Promise<ReactNode>;
+}
+/**
+ * Structural key for props: primitives, plain objects, arrays, `Date`, `URL`,
+ * `URLSearchParams`, `RegExp`, `Map`, `Set`, class instances (by constructor
+ * and own fields) and React elements by value; component types by identity
+ * (they're module-level). Function props aren't part of the key: a callback
+ * rebuilt on every render would otherwise miss on every retry and suspend
+ * forever. Props rebuilt on every parent render keep the same key, so a
+ * retried render reuses the in-flight promise.
+ */
+export declare function stableKey(value: unknown, cache: ServerComponentCache, depth: number, seen?: WeakSet<object>): string;
+export declare const ServerComponentCacheContext: import("react").Context<ServerComponentCache | null>;
+/** Drop every promise cached outside live sessions (`text run` between apps, tests). */
+export declare function clearFallbackServerComponentCache(): void;
+export declare function isAsyncComponent(type: unknown): type is AnyComponent;
+/** Wrap an `async function` component so it renders on the console reconciler. */
+export declare function serverComponent<P extends object>(component: (props: P) => Promise<ReactNode>): ComponentType<P>;
+export declare function resolveServerType<T>(type: T): T;
+/** Provide a session's cache to every async component below. */
+export declare function ServerComponentsProvider({ cache, children }: {
+    cache: ServerComponentCache;
+    children?: ReactNode;
+}): ReactNode;
+export {};
+//# sourceMappingURL=server-components.d.ts.map

package/dist/server/server-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-components.d.ts","sourceRoot":"","sources":["../../src/server/server-components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAkC,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI3F,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;AAE5C,uEAAuE;AACvE,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,sGAAsG;AACtG,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IACjE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiC;IACrD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IAEtD,0FAA0F;gBAC9E,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;KAAO;IAK1E,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,oDAAoD;IACpD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,sEAAsE;IACtE,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,KAAK,IAAI,IAAI;IAIb,kFAAkF;IAClF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAS3B,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAkCrF;AAQD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,OAAO,CAAC,MAAM,CAAiB,GAAG,MAAM,CA8CnI;AAED,eAAO,MAAM,2BAA2B,sDAAuG,CAAC;AAKhJ,wFAAwF;AACxF,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AAID,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,YAAY,CAEpE;AAID,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAe/G;AAMD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAY/C;AAED,gEAAgE;AAChE,wBAAgB,wBAAwB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAAE,KAAK,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,SAAS,CAE9H"}

package/dist/server/server-components.js

@@ -0,0 +1,215 @@
+/**
+ * Async Server Components for server-rendered console routes.
+ *
+ * React's client reconciler (which the console renderer is) re-runs an
+ * `async function` component on every retry, creating a fresh promise each
+ * time, so it never settles. On the server, `text dev` / `text build` alias
+ * `react/jsx-runtime` to {@link ./jsx-runtime}, which swaps every async
+ * component for a wrapper that memoizes its promise per session, navigation
+ * and props, then unwraps it with `use()` (suspending to the nearest
+ * `<Suspense>` / `loading.tsx` meanwhile). The data access stays on the server:
+ * these modules never ship to the frame player.
+ */
+import { createElement, use, useContext } from "react";
+import { sharedContext } from "@textjs/react";
+import { RouterContext } from "../context.js";
+/** Promises kept per cache (least recently used are dropped first). */
+export const SERVER_COMPONENT_CACHE_SIZE = 256;
+/** Per-session promise cache, cleared whenever the route or `router.refresh()` generation changes. */
+export class ServerComponentCache {
+    generation = "";
+    entries = new Map();
+    ids = new WeakMap();
+    nextId = 1;
+    inflight = 0;
+    settledAt = 0;
+    maxEntries;
+    onActivity;
+    /** `onActivity` runs whenever a component's promise starts or settles (idle tracking). */
+    constructor(options = {}) {
+        this.maxEntries = options.maxEntries ?? SERVER_COMPONENT_CACHE_SIZE;
+        this.onActivity = options.onActivity;
+    }
+    get size() {
+        return this.entries.size;
+    }
+    /** Component promises that have not settled yet. */
+    get pending() {
+        return this.inflight;
+    }
+    /** `Date.now()` when a component promise last settled (0 = never). */
+    get lastSettled() {
+        return this.settledAt;
+    }
+    clear() {
+        this.entries.clear();
+    }
+    /** Stable identity id for functions, symbols-as-objects and non-plain objects. */
+    idOf(value) {
+        let id = this.ids.get(value);
+        if (id === undefined) {
+            id = this.nextId++;
+            this.ids.set(value, id);
+        }
+        return id;
+    }
+    read(component, props, generation) {
+        if (generation !== this.generation) {
+            this.generation = generation;
+            this.entries.clear();
+        }
+        const key = `${this.idOf(component)}|${stableKey(props, this, 0)}`;
+        let p = this.entries.get(key);
+        if (p !== undefined) {
+            // Most recently used last.
+            this.entries.delete(key);
+            this.entries.set(key, p);
+        }
+        else {
+            try {
+                p = Promise.resolve(component(props));
+            }
+            catch (error) {
+                p = Promise.reject(error);
+            }
+            // Rejections surface through `use()` to the nearest error boundary.
+            this.inflight++;
+            this.onActivity?.();
+            const settled = () => {
+                this.inflight--;
+                this.settledAt = Date.now();
+                this.onActivity?.();
+            };
+            p.then(settled, settled);
+            this.entries.set(key, p);
+            for (const k of this.entries.keys()) {
+                if (this.entries.size <= this.maxEntries)
+                    break;
+                this.entries.delete(k);
+            }
+        }
+        return p;
+    }
+}
+const MAX_DEPTH = 64;
+const REACT_ELEMENT = Symbol.for("react.transitional.element");
+const REACT_ELEMENT_LEGACY = Symbol.for("react.element");
+let warnedFunctionProp = false;
+/**
+ * Structural key for props: primitives, plain objects, arrays, `Date`, `URL`,
+ * `URLSearchParams`, `RegExp`, `Map`, `Set`, class instances (by constructor
+ * and own fields) and React elements by value; component types by identity
+ * (they're module-level). Function props aren't part of the key: a callback
+ * rebuilt on every render would otherwise miss on every retry and suspend
+ * forever. Props rebuilt on every parent render keep the same key, so a
+ * retried render reuses the in-flight promise.
+ */
+export function stableKey(value, cache, depth, seen = new WeakSet()) {
+    switch (typeof value) {
+        case "string":
+            return JSON.stringify(value);
+        case "number":
+        case "boolean":
+        case "bigint":
+            return `${typeof value}:${String(value)}`;
+        case "undefined":
+            return "u";
+        case "symbol":
+            return `s:${String(value)}`;
+        case "function":
+            if (!warnedFunctionProp) {
+                warnedFunctionProp = true;
+                console.warn("▼ Text.js: an async server component received a function prop. Functions aren't part of its cache key; pass data instead of callbacks.");
+            }
+            return "f";
+    }
+    if (value === null)
+        return "n";
+    const obj = value;
+    if (seen.has(obj))
+        return "cycle";
+    if (depth >= MAX_DEPTH)
+        return `o#${cache.idOf(obj)}`;
+    seen.add(obj);
+    try {
+        const next = (v) => stableKey(v, cache, depth + 1, seen);
+        if (Array.isArray(obj))
+            return `[${obj.map(next).join(",")}]`;
+        const tag = obj.$$typeof;
+        if (tag === REACT_ELEMENT || tag === REACT_ELEMENT_LEGACY) {
+            const type = obj.type;
+            const t = typeof type === "string" ? type : typeof type === "object" || typeof type === "function" ? `#${cache.idOf(type)}` : String(type);
+            return `<${t}:${String(obj.key)}:${next(obj.props)}>`;
+        }
+        if (obj instanceof Date)
+            return `d:${obj.getTime()}`;
+        if (obj instanceof URL)
+            return `url:${JSON.stringify(obj.href)}`;
+        if (obj instanceof URLSearchParams)
+            return `qs:${JSON.stringify(obj.toString())}`;
+        if (obj instanceof RegExp)
+            return `re:${JSON.stringify(obj.toString())}`;
+        if (obj instanceof Map)
+            return `map{${[...obj].map(([k, v]) => `${next(k)}=>${next(v)}`).sort().join(",")}}`;
+        if (obj instanceof Set)
+            return `set{${[...obj].map(next).sort().join(",")}}`;
+        const proto = Object.getPrototypeOf(obj);
+        const prefix = proto !== Object.prototype && proto !== null ? `${proto.constructor?.name ?? "?"}` : "";
+        const keys = Object.keys(obj).sort();
+        return `${prefix}{${keys.map((k) => `${JSON.stringify(k)}:${next(obj[k])}`).join(",")}}`;
+    }
+    finally {
+        seen.delete(obj);
+    }
+}
+export const ServerComponentCacheContext = sharedContext("serverComponentCache", null, "TextServerComponentCache");
+/** Used when an async component renders outside a live session (tests, `text run`); bounded like a session's. */
+const fallbackCache = new ServerComponentCache();
+/** Drop every promise cached outside live sessions (`text run` between apps, tests). */
+export function clearFallbackServerComponentCache() {
+    fallbackCache.clear();
+}
+const AsyncFunction = (async () => undefined).constructor;
+export function isAsyncComponent(type) {
+    return typeof type === "function" && type instanceof AsyncFunction;
+}
+const wrappers = new WeakMap();
+/** Wrap an `async function` component so it renders on the console reconciler. */
+export function serverComponent(component) {
+    const fn = component;
+    let wrapped = wrappers.get(fn);
+    if (wrapped === undefined) {
+        const Wrapped = (props) => {
+            const cache = useContext(ServerComponentCacheContext) ?? fallbackCache;
+            const router = useContext(RouterContext);
+            const generation = router ? `${router.location.key}:${router.refreshKey}` : "";
+            return use(cache.read(fn, props, generation));
+        };
+        Wrapped.displayName = fn.name ? `${fn.name}` : "ServerComponent";
+        wrapped = Wrapped;
+        wrappers.set(fn, wrapped);
+    }
+    return wrapped;
+}
+/** `type` with async function components swapped for their wrappers. */
+const REACT_MEMO = Symbol.for("react.memo");
+const memoWrappers = new WeakMap();
+export function resolveServerType(type) {
+    if (isAsyncComponent(type))
+        return serverComponent(type);
+    // `React.memo(async function …)`: wrap the inner component, keep the memo.
+    if (typeof type === "object" && type !== null && type.$$typeof === REACT_MEMO && isAsyncComponent(type.type)) {
+        let wrapped = memoWrappers.get(type);
+        if (wrapped === undefined) {
+            wrapped = { ...type, type: serverComponent(type.type) };
+            memoWrappers.set(type, wrapped);
+        }
+        return wrapped;
+    }
+    return type;
+}
+/** Provide a session's cache to every async component below. */
+export function ServerComponentsProvider({ cache, children }) {
+    return createElement(ServerComponentCacheContext, { value: cache }, children);
+}
+//# sourceMappingURL=server-components.js.map

package/dist/server/server-components.js.map

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

package/dist/terminal.d.ts

@@ -0,0 +1,5 @@
+/**
+ * `@textjs/app/terminal` — render the same app in a real terminal.
+ */
+export * from "@textjs/react/terminal";
+//# sourceMappingURL=terminal.d.ts.map

package/dist/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,wBAAwB,CAAC"}

package/dist/terminal.js

@@ -0,0 +1,5 @@
+/**
+ * `@textjs/app/terminal` — render the same app in a real terminal.
+ */
+export * from "@textjs/react/terminal";
+//# sourceMappingURL=terminal.js.map

package/dist/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,wBAAwB,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,5 @@
+/**
+ * `@textjs/app/testing` — render apps offscreen and drive them with keys.
+ */
+export * from "@textjs/react/testing";
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/testing.js

@@ -0,0 +1,5 @@
+/**
+ * `@textjs/app/testing` — render apps offscreen and drive them with keys.
+ */
+export * from "@textjs/react/testing";
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC"}

package/dist/vite-plugin.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `@textjs/app/vite` — the Vite plugin behind `text dev` and `text build`:
+ * file-system App Router manifest, virtual `index.html` + client entry,
+ * `app/**\/route.ts` API handlers, rewrites / proxy and React Fast Refresh.
+ */
+import type { Plugin, ViteDevServer } from "vite";
+import { type TextConfig } from "./config.js";
+import { type AppScan } from "./server/scan.js";
+export declare const VIRTUAL_ROUTES = "virtual:textjs/routes";
+export declare const VIRTUAL_CONFIG = "virtual:textjs/config";
+export declare const VIRTUAL_ENTRY = "virtual:textjs/entry";
+export declare const VIRTUAL_API = "virtual:textjs/api";
+/** The script `src` used by the generated `index.html`. */
+export declare const ENTRY_URL = "/@textjs/entry";
+/**
+ * The URL every page's HTML is transformed as (Vite's SPA fallback does the same).
+ * The request URL can't be used: Vite maps `/?q` to the project directory and then
+ * watches the inline `<style>`'s "file", `/`, so chokidar crawls the whole disk.
+ */
+export declare const HTML_TRANSFORM_URL = "/index.html";
+export interface TextLogger {
+    info(message: string): void;
+    error(message: string): void;
+}
+export interface TextVitePluginOptions extends TextConfig {
+    /** Project root (defaults to Vite's `root`). */
+    root?: string;
+    /** Request / HMR log lines (the CLI passes its logger). */
+    logger?: TextLogger;
+}
+/**
+ * Mirrors Vite's `server.allowedHosts` check. Text.js API routes and user
+ * middleware are registered in the pre-hook phase (ahead of Vite's own host
+ * check), so they get the same DNS-rebinding protection here.
+ */
+export declare function isAllowedDevHost(server: Pick<ViteDevServer, "config">, hostHeader: string | undefined): boolean;
+/** Absolute path of `@textjs/app/client` (deduped with the user's `@textjs/app` imports via realpath). */
+export declare const CLIENT_MODULE: string;
+export declare const FAVICON: string;
+/** The generated `index.html` used when the project has none. */
+export declare function createIndexHtml(title: string, entryUrl?: string): string;
+export declare function createEntryModule(clientModule?: string): string;
+/** Generate the server-side API handler bundle entry. */
+export declare function generateApiModule(scan: AppScan): string;
+/** Whether Vite's `server.proxy` owns `url` (same key semantics: a path prefix, or a RegExp source starting with `^`). */
+export declare function matchesProxy(proxy: TextConfig["proxy"], url: string): boolean;
+/** Text.js Vite plugin (includes `@vitejs/plugin-react` for Fast Refresh). */
+export declare function textjsVitePlugin(options?: TextVitePluginOptions): Plugin[];
+export { scanApp, toStaticManifest, listApiRoutes, listPages, generateRoutesModule, type AppScan } from "./server/scan.js";
+export default textjsVitePlugin;
+//# sourceMappingURL=vite-plugin.d.ts.map

package/dist/vite-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,MAAM,EAAgB,aAAa,EAAE,MAAM,MAAM,CAAC;AAEhE,OAAO,EAAmD,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAO5F,OAAO,EAAuG,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAGlJ,eAAO,MAAM,cAAc,0BAA0B,CAAC;AACtD,eAAO,MAAM,cAAc,0BAA0B,CAAC;AACtD,eAAO,MAAM,aAAa,yBAAyB,CAAC;AACpD,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAChD,2DAA2D;AAC3D,eAAO,MAAM,SAAS,mBAAmB,CAAC;AAC1C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAIhD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAmB/G;AAqBD,0GAA0G;AAC1G,eAAO,MAAM,aAAa,QAAiC,CAAC;AAE5D,eAAO,MAAM,OAAO,QAEjB,CAAC;AAMJ,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,MAAM,CAuB3E;AAED,wBAAgB,iBAAiB,CAAC,YAAY,SAAgB,GAAG,MAAM,CAOtE;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAsBvD;AA4BD,0HAA0H;AAC1H,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAG7E;AAWD,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,qBAA0B,GAAG,MAAM,EAAE,CAyM9E;AAED,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,EAAE,oBAAoB,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AACxH,eAAe,gBAAgB,CAAC"}