dx-devkit 0.0.0-stage → 1.1.0

package/node_modules/@dx/core/dist/tools/ports.d.ts

@@ -0,0 +1,42 @@
+export interface PortEntry {
+    port: number;
+    pid: number;
+    /** Every local address this process listens on for the port, e.g. ["0.0.0.0", "::"]. */
+    addresses: string[];
+    processName?: string;
+    commandLine?: string;
+    /** True for the OS itself (PID 0 / 4 on Windows, 0 / 1 elsewhere). These are never killed. */
+    system: boolean;
+}
+/** Lists TCP ports that are listening, optionally only one port. Sorted by port. */
+export declare function listListeningPorts(port?: number): Promise<PortEntry[]>;
+export interface KillResult {
+    pid: number;
+    ok: boolean;
+    message: string;
+}
+/** Kills a process and its children. Refuses to touch system processes or dx itself. */
+export declare function killProcess(pid: number): Promise<KillResult>;
+/** Kills everything listening on a port. */
+export declare function killPort(port: number): Promise<{
+    entries: PortEntry[];
+    results: KillResult[];
+}>;
+export declare function isSystemPid(pid: number): boolean;
+/**
+ * Uses Get-NetTCPConnection rather than parsing `netstat`, because netstat's state column is
+ * translated on non-English Windows. Process names and command lines come from one CIM query.
+ */
+export declare function windowsPortScript(port?: number): string;
+interface RawEntry {
+    port: number;
+    address: string;
+    pid: number;
+    name?: string | null;
+    cmd?: string | null;
+}
+export declare function parseWindowsJson(stdout: string): RawEntry[];
+export declare function parseLsof(stdout: string): RawEntry[];
+export declare function mergeEntries(rows: RawEntry[]): PortEntry[];
+export {};
+//# sourceMappingURL=ports.d.ts.map

package/node_modules/@dx/core/dist/tools/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/tools/ports.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,wFAAwF;IACxF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8FAA8F;IAC9F,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,oFAAoF;AACpF,wBAAsB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAI5E;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wFAAwF;AACxF,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAqClE;AAED,4CAA4C;AAC5C,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CASrG;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAyBvD;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAYD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CAe3D;AAmBD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CAoBpD;AAmBD,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE,CAmB1D"}

package/node_modules/@dx/core/dist/tools/ports.js

@@ -0,0 +1,220 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const run = promisify(execFile);
+/** Lists TCP ports that are listening, optionally only one port. Sorted by port. */
+export async function listListeningPorts(port) {
+    if (port !== undefined)
+        assertPort(port);
+    const raw = process.platform === "win32" ? await listWindows(port) : await listUnix(port);
+    return mergeEntries(raw);
+}
+/** Kills a process and its children. Refuses to touch system processes or dx itself. */
+export async function killProcess(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return { pid, ok: false, message: `Not a valid PID: ${pid}` };
+    if (isSystemPid(pid))
+        return { pid, ok: false, message: `PID ${pid} belongs to the operating system; dx won't kill it.` };
+    if (pid === process.pid)
+        return { pid, ok: false, message: "That's dx itself." };
+    if (process.platform === "win32") {
+        try {
+            await run("taskkill", ["/PID", String(pid), "/T", "/F"], { windowsHide: true });
+            return { pid, ok: true, message: `Killed PID ${pid} and its child processes.` };
+        }
+        catch (err) {
+            const e = err;
+            const detail = (e.stderr || e.stdout || e.message).trim();
+            const hint = /denied|access/i.test(detail)
+                ? " The process may belong to another user or need admin rights: try again from a terminal opened as administrator."
+                : "";
+            return { pid, ok: false, message: `Couldn't kill PID ${pid}: ${detail}${hint}` };
+        }
+    }
+    try {
+        process.kill(pid, "SIGTERM");
+    }
+    catch (err) {
+        return { pid, ok: false, message: `Couldn't kill PID ${pid}: ${err.message}` };
+    }
+    for (let i = 0; i < 30; i++) {
+        await sleep(100);
+        if (!isAlive(pid))
+            return { pid, ok: true, message: `Stopped PID ${pid}.` };
+    }
+    try {
+        process.kill(pid, "SIGKILL");
+    }
+    catch {
+        // already gone
+    }
+    await sleep(100);
+    return isAlive(pid)
+        ? { pid, ok: false, message: `PID ${pid} is still running after SIGKILL.` }
+        : { pid, ok: true, message: `Force-killed PID ${pid}.` };
+}
+/** Kills everything listening on a port. */
+export async function killPort(port) {
+    const entries = await listListeningPorts(port);
+    const pids = [...new Set(entries.filter((e) => !e.system).map((e) => e.pid))];
+    const results = [];
+    for (const pid of pids)
+        results.push(await killProcess(pid));
+    for (const e of entries.filter((x) => x.system)) {
+        results.push({ pid: e.pid, ok: false, message: `PID ${e.pid} belongs to the operating system; dx won't kill it.` });
+    }
+    return { entries, results };
+}
+export function isSystemPid(pid) {
+    return process.platform === "win32" ? pid === 0 || pid === 4 : pid === 0 || pid === 1;
+}
+// ---------------------------------------------------------------- Windows
+/**
+ * Uses Get-NetTCPConnection rather than parsing `netstat`, because netstat's state column is
+ * translated on non-English Windows. Process names and command lines come from one CIM query.
+ */
+export function windowsPortScript(port) {
+    const filter = port !== undefined ? ` -LocalPort ${port}` : "";
+    return `
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$ErrorActionPreference = 'SilentlyContinue'
+$conns = @(Get-NetTCPConnection -State Listen${filter})
+$ids = @($conns | ForEach-Object { [int]$_.OwningProcess } | Sort-Object -Unique)
+$procs = @{}
+if ($ids.Count -gt 0) {
+  $f = ($ids | ForEach-Object { "ProcessId=$_" }) -join ' OR '
+  Get-CimInstance Win32_Process -Filter $f | ForEach-Object { $procs[[int]$_.ProcessId] = $_ }
+}
+$list = New-Object System.Collections.Generic.List[object]
+foreach ($c in $conns) {
+  $p = $procs[[int]$c.OwningProcess]
+  $list.Add([pscustomobject]@{
+    port = [int]$c.LocalPort
+    address = [string]$c.LocalAddress
+    pid = [int]$c.OwningProcess
+    name = $p.Name
+    cmd = $p.CommandLine
+  })
+}
+if ($list.Count -eq 0) { '[]' } else { ConvertTo-Json -InputObject $list.ToArray() -Compress -Depth 3 }
+`;
+}
+async function listWindows(port) {
+    const encoded = Buffer.from(windowsPortScript(port), "utf16le").toString("base64");
+    const { stdout } = await run("powershell.exe", ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-EncodedCommand", encoded], { windowsHide: true, maxBuffer: 16 * 1024 * 1024, encoding: "utf8" });
+    return parseWindowsJson(stdout);
+}
+export function parseWindowsJson(stdout) {
+    const text = stdout.replace(/^/, "").trim();
+    if (!text)
+        return [];
+    const parsed = JSON.parse(text);
+    const rows = Array.isArray(parsed) ? parsed : [parsed];
+    return rows
+        .filter((r) => Boolean(r) && typeof r === "object")
+        .map((r) => ({
+        port: Number(r.port),
+        address: String(r.address ?? ""),
+        pid: Number(r.pid),
+        name: typeof r.name === "string" ? r.name : null,
+        cmd: typeof r.cmd === "string" ? r.cmd : null,
+    }))
+        .filter((r) => Number.isFinite(r.port) && Number.isFinite(r.pid));
+}
+// ---------------------------------------------------------------- macOS / Linux
+async function listUnix(port) {
+    const args = ["-nP", port !== undefined ? `-iTCP:${port}` : "-iTCP", "-sTCP:LISTEN", "-Fpcn"];
+    let stdout = "";
+    try {
+        ({ stdout } = await run("lsof", args, { maxBuffer: 16 * 1024 * 1024 }));
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT")
+            throw new Error("lsof isn't installed, so dx can't list ports on this system.");
+        stdout = e.stdout ?? ""; // lsof exits 1 when nothing matches
+    }
+    const rows = parseLsof(stdout);
+    const cmds = await unixCommandLines([...new Set(rows.map((r) => r.pid))]);
+    return rows.map((r) => ({ ...r, cmd: cmds.get(r.pid) ?? null }));
+}
+export function parseLsof(stdout) {
+    const rows = [];
+    let pid = 0;
+    let name;
+    for (const line of stdout.split(/\r?\n/)) {
+        if (!line)
+            continue;
+        const tag = line[0];
+        const value = line.slice(1);
+        if (tag === "p") {
+            pid = Number(value);
+            name = undefined;
+        }
+        else if (tag === "c") {
+            name = value;
+        }
+        else if (tag === "n") {
+            const m = /^(.*):(\d+)$/.exec(value);
+            if (!m)
+                continue;
+            rows.push({ port: Number(m[2]), address: m[1].replace(/^\[|\]$/g, ""), pid, name: name ?? null });
+        }
+    }
+    return rows;
+}
+async function unixCommandLines(pids) {
+    const map = new Map();
+    if (pids.length === 0)
+        return map;
+    try {
+        const { stdout } = await run("ps", ["-o", "pid=,command=", "-p", pids.join(",")]);
+        for (const line of stdout.split("\n")) {
+            const m = /^\s*(\d+)\s+(.*)$/.exec(line);
+            if (m)
+                map.set(Number(m[1]), m[2]);
+        }
+    }
+    catch {
+        // command lines are a nice-to-have
+    }
+    return map;
+}
+// ---------------------------------------------------------------- shared
+export function mergeEntries(rows) {
+    const byKey = new Map();
+    for (const r of rows) {
+        const key = `${r.port}:${r.pid}`;
+        const existing = byKey.get(key);
+        if (existing) {
+            if (r.address && !existing.addresses.includes(r.address))
+                existing.addresses.push(r.address);
+            continue;
+        }
+        byKey.set(key, {
+            port: r.port,
+            pid: r.pid,
+            addresses: r.address ? [r.address] : [],
+            processName: r.name ?? undefined,
+            commandLine: r.cmd ?? undefined,
+            system: isSystemPid(r.pid),
+        });
+    }
+    return [...byKey.values()].sort((a, b) => a.port - b.port || a.pid - b.pid);
+}
+function assertPort(port) {
+    if (!Number.isInteger(port) || port < 1 || port > 65535)
+        throw new Error(`Not a valid port: ${port}`);
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === "EPERM";
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=ports.js.map

package/node_modules/@dx/core/dist/tools/ports.js.map

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

package/node_modules/@dx/core/dist/tools/projects.d.ts

@@ -0,0 +1,58 @@
+import { type DxConfig } from "../config.js";
+export type ProjectKind = "node" | "go" | "rust" | "python" | "dotnet" | "other";
+export type PackageManager = "npm" | "pnpm" | "yarn" | "bun";
+export interface Project {
+    name: string;
+    dir: string;
+    /** Which projects root it was found under. */
+    root: string;
+    kind: ProjectKind;
+    packageManager?: PackageManager;
+    /** Command that starts the project locally, from .devrc.json or detected. */
+    devCommand?: string;
+    /** Where the dev server will be, from .devrc.json or guessed from the dev script. */
+    url?: string;
+    /** True when `url` was guessed from the framework rather than set in .devrc.json. */
+    urlGuessed?: boolean;
+    /** Editor override from .devrc.json. */
+    editor?: string;
+    scripts: string[];
+    hasGit: boolean;
+    /** Last time something happened in the project (ms since epoch). */
+    lastActive: number;
+}
+/**
+ * Optional per-project file, `.devrc.json` in the project folder:
+ *   { "dev": "npm run dev -- --turbo", "url": "http://localhost:3000", "name": "shop", "editor": "cursor" }
+ */
+export interface DevRc {
+    name?: string;
+    dev?: string;
+    url?: string;
+    editor?: string;
+}
+export declare function scanProjects(config?: DxConfig): Project[];
+/** Returns project info if `dir` looks like a project, otherwise undefined. */
+export declare function readProject(dir: string, root?: string): Project | undefined;
+interface PackageJson {
+    name?: string;
+    scripts?: Record<string, string>;
+    packageManager?: string;
+}
+export declare function detectPackageManager(dir: string, pkg?: PackageJson): PackageManager;
+/**
+ * Best guess at the local URL from a dev script such as "next dev -p 3001" or "vite --port 5174".
+ * Only used to open the browser once that port is actually listening, so a wrong guess is harmless.
+ */
+export declare function guessDevUrl(script: string): string | undefined;
+export declare function getProjectPort(project: Project): number | undefined;
+export interface FindResult {
+    /** Set when one project is a clear winner. */
+    match?: Project;
+    /** Ranked candidates (best first), for asking the user to pick. */
+    candidates: Project[];
+}
+/** Fuzzy-find projects by name. An empty query returns the most recently active ones. */
+export declare function findProjects(query: string, projects: Project[]): FindResult;
+export {};
+//# sourceMappingURL=projects.d.ts.map

package/node_modules/@dx/core/dist/tools/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGnE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AACjF,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7D,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAcD,wBAAgB,YAAY,CAAC,MAAM,GAAE,QAAuB,GAAG,OAAO,EAAE,CA4BvE;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAoB,GAAG,OAAO,GAAG,SAAS,CAgDtF;AAED,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,WAAW,GAAG,cAAc,CAQnF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK9D;AAcD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CASnE;AAED,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,UAAU,EAAE,OAAO,EAAE,CAAC;CACvB;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,UAAU,CAW3E"}

package/node_modules/@dx/core/dist/tools/projects.js

@@ -0,0 +1,208 @@
+import fs from "node:fs";
+import path from "node:path";
+import { loadConfig, stripBom } from "../config.js";
+import { fuzzyRank } from "../fuzzy.js";
+const MARKERS = [
+    ["package.json", "node"],
+    ["go.mod", "go"],
+    ["Cargo.toml", "rust"],
+    ["pyproject.toml", "python"],
+    ["requirements.txt", "python"],
+    ["manage.py", "python"],
+];
+/** Files that make a folder a project without telling its language (Rails, a stack of containers, …). */
+const OTHER_MARKERS = ["Gemfile", "Procfile", "Procfile.dev", "compose.yaml", "compose.yml", "docker-compose.yml", "docker-compose.yaml"];
+export function scanProjects(config = loadConfig()) {
+    const found = new Map();
+    const ignore = new Set(config.ignore.map((n) => n.toLowerCase()));
+    for (const root of config.projectsRoots) {
+        if (!isDir(root))
+            continue;
+        walk(root, root, 1);
+    }
+    return [...found.values()].sort((a, b) => b.lastActive - a.lastActive);
+    function walk(dir, root, depth) {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name.startsWith(".") || ignore.has(entry.name.toLowerCase()))
+                continue;
+            const child = path.join(dir, entry.name);
+            const project = readProject(child, root);
+            if (project) {
+                found.set(child.toLowerCase(), project);
+            }
+            else if (depth < config.scanDepth) {
+                walk(child, root, depth + 1);
+            }
+        }
+    }
+}
+/** Returns project info if `dir` looks like a project, otherwise undefined. */
+export function readProject(dir, root = path.dirname(dir)) {
+    const has = (f) => fs.existsSync(path.join(dir, f));
+    const hasGit = has(".git");
+    const devrc = readJson(path.join(dir, ".devrc.json"));
+    let kind = MARKERS.find(([f]) => has(f))?.[1];
+    if (!kind && hasDotnetProject(dir))
+        kind = "dotnet";
+    if (!kind && (hasGit || devrc || OTHER_MARKERS.some(has)))
+        kind = "other";
+    if (!kind)
+        return undefined;
+    const pkg = kind === "node" ? readJson(path.join(dir, "package.json")) : undefined;
+    const scripts = Object.keys(pkg?.scripts ?? {});
+    const packageManager = kind === "node" ? detectPackageManager(dir, pkg) : undefined;
+    let devCommand = devrc?.dev;
+    let devScript;
+    if (!devCommand) {
+        if (kind === "node" && pkg?.scripts) {
+            const script = ["dev", "start", "serve", "develop"].find((s) => pkg.scripts?.[s]);
+            if (script) {
+                devCommand = `${packageManager ?? "npm"} run ${script}`;
+                devScript = pkg.scripts[script];
+            }
+        }
+        else if (kind === "go")
+            devCommand = "go run .";
+        else if (kind === "rust")
+            devCommand = "cargo run";
+        else if (kind === "python" && has("manage.py"))
+            devCommand = "python manage.py runserver";
+    }
+    let url = devrc?.url;
+    let urlGuessed = false;
+    if (!url && devScript) {
+        url = guessDevUrl(devScript);
+        urlGuessed = Boolean(url);
+    }
+    return {
+        name: devrc?.name ?? path.basename(dir),
+        dir,
+        root,
+        kind,
+        packageManager,
+        devCommand,
+        url,
+        urlGuessed: url ? urlGuessed : undefined,
+        editor: devrc?.editor,
+        scripts,
+        hasGit,
+        lastActive: lastActivity(dir, hasGit),
+    };
+}
+export function detectPackageManager(dir, pkg) {
+    const declared = pkg?.packageManager?.split("@")[0];
+    if (declared === "pnpm" || declared === "yarn" || declared === "bun" || declared === "npm")
+        return declared;
+    const has = (f) => fs.existsSync(path.join(dir, f));
+    if (has("pnpm-lock.yaml"))
+        return "pnpm";
+    if (has("yarn.lock"))
+        return "yarn";
+    if (has("bun.lockb") || has("bun.lock"))
+        return "bun";
+    return "npm";
+}
+/**
+ * Best guess at the local URL from a dev script such as "next dev -p 3001" or "vite --port 5174".
+ * Only used to open the browser once that port is actually listening, so a wrong guess is harmless.
+ */
+export function guessDevUrl(script) {
+    const explicit = /(?:^|\s)(?:-p|--port)(?:\s+|=)(\d{2,5})\b/.exec(script) ?? /\bPORT=(\d{2,5})\b/.exec(script);
+    const port = explicit ? Number(explicit[1]) : frameworkDefaultPort(script);
+    return port ? `http://localhost:${port}` : undefined;
+}
+function frameworkDefaultPort(script) {
+    const s = script.toLowerCase();
+    if (/\bnext\b/.test(s) || /\bnuxt\b/.test(s) || /\bremix dev\b/.test(s))
+        return 3000;
+    if (/\bvite\b/.test(s) || /react-router dev/.test(s) || /\bsvelte-kit dev\b/.test(s))
+        return 5173;
+    if (/\bastro\b/.test(s))
+        return 4321;
+    if (/\bng serve\b/.test(s))
+        return 4200;
+    if (/\bgatsby develop\b/.test(s))
+        return 8000;
+    if (/\bexpo start\b/.test(s))
+        return 8081;
+    if (/webpack(-dev-server| serve)/.test(s))
+        return 8080;
+    return undefined;
+}
+export function getProjectPort(project) {
+    if (!project.url)
+        return undefined;
+    try {
+        const u = new URL(project.url);
+        if (u.port)
+            return Number(u.port);
+        return u.protocol === "https:" ? 443 : 80;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Fuzzy-find projects by name. An empty query returns the most recently active ones. */
+export function findProjects(query, projects) {
+    const q = query.trim();
+    if (!q)
+        return { candidates: projects };
+    const ranked = fuzzyRank(q, projects, (p) => [p.name, path.basename(p.dir)]);
+    // On equal scores prefer the project touched most recently.
+    ranked.sort((a, b) => b.score - a.score || b.item.lastActive - a.item.lastActive);
+    const candidates = ranked.map((r) => r.item);
+    if (ranked.length === 0)
+        return { candidates };
+    const [first, second] = ranked;
+    const clear = ranked.length === 1 || first.score >= 1000 || first.score - (second?.score ?? 0) >= 150;
+    return { match: clear ? first.item : undefined, candidates };
+}
+function lastActivity(dir, hasGit) {
+    const files = [dir, path.join(dir, "package.json")];
+    if (hasGit)
+        files.push(path.join(dir, ".git", "index"), path.join(dir, ".git", "HEAD"), path.join(dir, ".git", "FETCH_HEAD"));
+    let latest = 0;
+    for (const f of files) {
+        try {
+            latest = Math.max(latest, fs.statSync(f).mtimeMs);
+        }
+        catch {
+            // file not present
+        }
+    }
+    return latest;
+}
+function hasDotnetProject(dir) {
+    try {
+        return fs.readdirSync(dir).some((f) => f.endsWith(".sln") || f.endsWith(".csproj"));
+    }
+    catch {
+        return false;
+    }
+}
+function isDir(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function readJson(file) {
+    try {
+        return JSON.parse(stripBom(fs.readFileSync(file, "utf8")));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=projects.js.map

package/node_modules/@dx/core/dist/tools/projects.js.map

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

package/node_modules/@dx/core/dist/tools/scaffold.d.ts

@@ -0,0 +1,40 @@
+import { type DxConfig } from "../config.js";
+/**
+ * `dx new`: start a project from a template folder (~/.dx/templates/<name>) or from a copy of an
+ * existing project. Copies leave out what belongs to the old project: git history, installed
+ * packages, build output and .env files with secrets (.env.example is kept).
+ */
+export interface Template {
+    name: string;
+    dir: string;
+}
+export type SourceKind = "template" | "project" | "folder";
+export interface Source {
+    kind: SourceKind;
+    name: string;
+    dir: string;
+}
+/** Placeholder replaced with the new project's name in template files and file names. */
+export declare const NAME_PLACEHOLDER = "{{name}}";
+export declare function templatesDir(config?: DxConfig): string;
+export declare function listTemplates(config?: DxConfig): Template[];
+/** A template by exact name, else a folder path, else a project with a clear name match. */
+export declare function resolveSource(input: string, config?: DxConfig): Source | {
+    candidates: string[];
+};
+/** Lowercase letters, digits, dots, dashes and underscores: valid as a folder and an npm package name. */
+export declare function isValidProjectName(name: string): boolean;
+export interface CopyResult {
+    dir: string;
+    files: number;
+    /** Files whose {{name}} placeholder was filled in. */
+    filled: number;
+}
+/**
+ * Copies `source` to `dest` (which must not exist yet) and gives the copy its new name:
+ * package.json and .devrc.json get `name`, and template files get {{name}} filled in.
+ */
+export declare function copyProject(source: Source, dest: string, name: string): CopyResult;
+/** Saves a copy of a project as a template, leaving out the same things a copy does. */
+export declare function saveAsTemplate(source: Source, templateName: string, config?: DxConfig): CopyResult;
+//# sourceMappingURL=scaffold.d.ts.map

package/node_modules/@dx/core/dist/tools/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/tools/scaffold.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4C,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGvF;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAyBD,yFAAyF;AACzF,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAG3C,wBAAgB,YAAY,CAAC,MAAM,GAAE,QAAuB,GAAG,MAAM,CAEpE;AAED,wBAAgB,aAAa,CAAC,MAAM,GAAE,QAAuB,GAAG,QAAQ,EAAE,CAWzE;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,QAAuB,GAAG,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAQ/G;AAED,0GAA0G;AAC1G,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAiClF;AA2DD,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAE,QAAuB,GAAG,UAAU,CAGhH"}