dx-devkit 0.0.0-stage → 1.1.0

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

@@ -0,0 +1,188 @@
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { dxPath, expandHome, loadConfig, stripBom } from "../config.js";
+import { findProjects, scanProjects } from "./projects.js";
+/** Folders and files never copied. */
+const SKIP_DIRS = new Set([
+    ".git",
+    "node_modules",
+    ".next",
+    ".nuxt",
+    ".svelte-kit",
+    ".turbo",
+    ".parcel-cache",
+    ".cache",
+    ".vercel",
+    ".output",
+    "dist",
+    "build",
+    "out",
+    "coverage",
+    "__pycache__",
+    ".venv",
+    "venv",
+    "target",
+]);
+const SKIP_FILES = /^(\.env(\..+)?|.*\.log|\.DS_Store|Thumbs\.db|.*\.tsbuildinfo)$/i;
+const KEEP_FILES = /^\.env\.(example|sample|template)$/i;
+/** Placeholder replaced with the new project's name in template files and file names. */
+export const NAME_PLACEHOLDER = "{{name}}";
+const MAX_TEXT_BYTES = 1024 * 1024;
+export function templatesDir(config = loadConfig()) {
+    return config.templatesDir ? expandHome(config.templatesDir) : dxPath("templates");
+}
+export function listTemplates(config = loadConfig()) {
+    const dir = templatesDir(config);
+    try {
+        return fs
+            .readdirSync(dir, { withFileTypes: true })
+            .filter((e) => e.isDirectory() && !e.name.startsWith("."))
+            .map((e) => ({ name: e.name, dir: path.join(dir, e.name) }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+    catch {
+        return [];
+    }
+}
+/** A template by exact name, else a folder path, else a project with a clear name match. */
+export function resolveSource(input, config = loadConfig()) {
+    const template = listTemplates(config).find((t) => t.name.toLowerCase() === input.toLowerCase());
+    if (template)
+        return { kind: "template", ...template };
+    const asPath = path.resolve(expandHome(input));
+    if (/[\\/]/.test(input) && isDir(asPath))
+        return { kind: "folder", name: path.basename(asPath), dir: asPath };
+    const { match, candidates } = findProjects(input, scanProjects(config));
+    if (match)
+        return { kind: "project", name: match.name, dir: match.dir };
+    return { candidates: candidates.slice(0, 8).map((p) => p.name) };
+}
+/** Lowercase letters, digits, dots, dashes and underscores: valid as a folder and an npm package name. */
+export function isValidProjectName(name) {
+    return /^[a-z0-9][a-z0-9._-]{0,213}$/.test(name);
+}
+/**
+ * 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 function copyProject(source, dest, name) {
+    if (fs.existsSync(dest))
+        throw new Error(`${dest} already exists.`);
+    const destParent = path.dirname(dest);
+    const rel = path.relative(source.dir, dest);
+    if (!rel.startsWith("..") && !path.isAbsolute(rel))
+        throw new Error("The new project can't be inside the one it's copied from.");
+    fs.mkdirSync(destParent, { recursive: true });
+    const fill = source.kind === "template";
+    let files = 0;
+    let filled = 0;
+    fs.mkdirSync(dest, { recursive: true });
+    for (const rel of filesToCopy(source.dir)) {
+        const parts = rel.split("/");
+        if (parts.slice(0, -1).some((p) => SKIP_DIRS.has(p)))
+            continue;
+        const base = parts[parts.length - 1];
+        if (SKIP_FILES.test(base) && !KEEP_FILES.test(base))
+            continue;
+        const src = path.join(source.dir, ...parts);
+        let stat;
+        try {
+            stat = fs.lstatSync(src);
+        }
+        catch {
+            continue; // listed by git but deleted on disk
+        }
+        if (!stat.isFile())
+            continue; // symlinks are left out rather than pointing back into the source
+        const dst = path.join(dest, ...(fill ? parts.map((p) => p.split(NAME_PLACEHOLDER).join(name)) : parts));
+        fs.mkdirSync(path.dirname(dst), { recursive: true });
+        if (fill && fillPlaceholder(src, dst, name))
+            filled++;
+        else
+            fs.copyFileSync(src, dst);
+        files++;
+    }
+    renameManifest(path.join(dest, "package.json"), name);
+    renameManifest(path.join(dest, ".devrc.json"), name, true);
+    return { dir: dest, files, filled };
+}
+/**
+ * The files that make up a project, as "/"-separated paths. In a git repo that's what git tracks
+ * plus new files it doesn't ignore, so local reports, uploads and caches stay behind. Elsewhere,
+ * every file except the skipped folders.
+ */
+function filesToCopy(dir) {
+    if (fs.existsSync(path.join(dir, ".git"))) {
+        try {
+            const out = execFileSync("git", ["-C", dir, "ls-files", "-z", "--cached", "--others", "--exclude-standard"], {
+                windowsHide: true,
+                maxBuffer: 256 * 1024 * 1024,
+                stdio: ["ignore", "pipe", "ignore"],
+            });
+            return [...new Set(out.toString("utf8").split("\0").filter(Boolean))];
+        }
+        catch {
+            // git not available: fall back to walking the folder
+        }
+    }
+    const out = [];
+    const walk = (abs, rel) => {
+        for (const e of fs.readdirSync(abs, { withFileTypes: true })) {
+            const childRel = rel ? `${rel}/${e.name}` : e.name;
+            if (e.isDirectory()) {
+                if (!SKIP_DIRS.has(e.name))
+                    walk(path.join(abs, e.name), childRel);
+            }
+            else if (e.isFile())
+                out.push(childRel);
+        }
+    };
+    walk(dir, "");
+    return out;
+}
+/** Writes a copy of a text file with {{name}} replaced. False when it isn't text or has no placeholder. */
+function fillPlaceholder(src, dst, name) {
+    if (fs.statSync(src).size > MAX_TEXT_BYTES)
+        return false;
+    const buf = fs.readFileSync(src);
+    if (buf.includes(0))
+        return false; // binary
+    const text = buf.toString("utf8");
+    if (!text.includes(NAME_PLACEHOLDER))
+        return false;
+    fs.writeFileSync(dst, text.split(NAME_PLACEHOLDER).join(name), "utf8");
+    return true;
+}
+/** Sets "name" in a JSON manifest, keeping its formatting style (2-space or tab). */
+function renameManifest(file, name, onlyIfSet = false) {
+    if (!fs.existsSync(file))
+        return;
+    try {
+        const text = stripBom(fs.readFileSync(file, "utf8"));
+        const json = JSON.parse(text);
+        if (onlyIfSet && json.name === undefined)
+            return;
+        json.name = name;
+        const indent = /^\t/m.test(text) ? "\t" : 2;
+        fs.writeFileSync(file, JSON.stringify(json, null, indent) + (text.endsWith("\n") ? "\n" : ""), "utf8");
+    }
+    catch {
+        // not valid JSON: leave it as copied
+    }
+}
+/** Saves a copy of a project as a template, leaving out the same things a copy does. */
+export function saveAsTemplate(source, templateName, config = loadConfig()) {
+    if (!isValidProjectName(templateName))
+        throw new Error(`"${templateName}" isn't a valid template name (lowercase, digits, - _ .).`);
+    return copyProject({ ...source, kind: "project" }, path.join(templatesDir(config), templateName), templateName);
+}
+function isDir(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=scaffold.js.map

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

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

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

@@ -0,0 +1,119 @@
+import { type Project } from "./projects.js";
+/**
+ * A stack is the set of processes an app needs to run locally: a front end, an API, a worker, a
+ * database. dx finds it from what the project already has, in this order:
+ *
+ *   1. "stack" in .devrc.json, written by you or by your AI agent (set_stack);
+ *   2. Procfile.dev or Procfile;
+ *   3. a root "dev" script that runs turbo, nx, concurrently, npm-run-all or lerna: that one
+ *      command, its output split back into services by the prefixes those tools print;
+ *   4. root scripts named dev:web, dev:api, …;
+ *   5. workspaces (npm, yarn or pnpm) whose packages have a "dev" script;
+ *   6. docker-compose.yml services that are infrastructure (postgres, redis, …), added to any
+ *      of the above and started first with `docker compose up -d`.
+ *
+ * A project with only one thing to run has no stack; it runs as before.
+ */
+export type ServiceRole = "data" | "backend" | "frontend" | "other";
+export interface StackService {
+    /** Short name, unique in the stack: web, api, postgres. Lowercase letters, digits and dashes. */
+    name: string;
+    role: ServiceRole;
+    /** "process" runs `command` in `dir`; "docker" is a docker compose service. */
+    kind: "process" | "docker";
+    dir: string;
+    command: string;
+    /** Where it will listen, when known or guessed. */
+    url?: string;
+    /** Services that must be ready before this one starts. */
+    dependsOn: string[];
+    /** Extra environment, e.g. PORT for Procfile services. */
+    env?: Record<string, string>;
+    /** For docker services: the compose service name, and the host port it publishes. */
+    composeService?: string;
+    hostPort?: number;
+}
+export interface Stack {
+    source: "devrc" | "procfile" | "runner" | "scripts" | "workspaces" | "compose";
+    /** The project folder the stack belongs to. */
+    dir: string;
+    services: StackService[];
+    /**
+     * For "runner" stacks: the one command that starts every app service. Its output lines carry a
+     * prefix naming the service ("web:dev: …" from turbo, "[api] …" from concurrently).
+     */
+    runner?: {
+        command: string;
+    };
+    /** The compose file docker services come from. */
+    composeFile?: string;
+}
+/** What .devrc.json's "stack" may hold, per service name. */
+export interface DevRcService {
+    /** Command to run. */
+    dev?: string;
+    /** Folder to run it in, relative to the project (may be outside it, e.g. ../shop-api). */
+    dir?: string;
+    /** Another project dx knows, by folder (relative or absolute): its own dev command and URL are used. */
+    project?: string;
+    url?: string;
+    dependsOn?: string[];
+    /** A docker compose service of this project to start. */
+    docker?: string;
+    role?: ServiceRole;
+}
+export declare function detectStack(project: Project): Stack | undefined;
+/** Guesses what a service is from its name and command. */
+export declare function roleOf(name: string, command?: string): ServiceRole;
+/** Groups services into the order they start in: each group only after the one before is ready. */
+export declare function startOrder(stack: Stack): StackService[][];
+/** The service a browser should open: the first front end, else the first app service. */
+export declare function mainService(stack: Stack): StackService | undefined;
+/** "@acme/Web App" → "web-app" */
+export declare function serviceName(raw: string): string;
+/**
+ * Which service a line from a runner belongs to, and the line without its prefix.
+ * turbo: "web:dev: ready" or "@acme/web:dev: ready"; concurrently and npm-run-all: "[api] listening".
+ */
+export declare function splitRunnerLine(text: string, services: StackService[]): {
+    service?: string;
+    text: string;
+};
+/**
+ * Writes (or with no services, removes) the "stack" in a project's .devrc.json, keeping the rest
+ * of the file. This is how an AI agent sets up a stack dx can't guess, such as two repositories.
+ */
+export declare function saveStackSpec(dir: string, spec: Record<string, DevRcService> | undefined): string;
+interface PackageJson {
+    name?: string;
+    scripts?: Record<string, string>;
+    workspaces?: string[] | {
+        packages?: string[];
+    };
+    packageManager?: string;
+}
+interface Workspace {
+    dir: string;
+    folder: string;
+    name: string;
+    scripts: Record<string, string>;
+}
+/** The packages listed in package.json "workspaces" or pnpm-workspace.yaml. Patterns: "apps/*", "packages/**", or a folder. */
+export declare function workspacePackages(dir: string, pkg?: PackageJson | undefined): Workspace[];
+interface ComposeService {
+    name: string;
+    image?: string;
+    build?: boolean;
+    hostPort?: number;
+}
+interface Compose {
+    file: string;
+    services: ComposeService[];
+}
+/**
+ * Reads the services of a compose file: just enough YAML for names, image, build and the first
+ * published port. Anything it can't read is skipped, never guessed.
+ */
+export declare function readCompose(dir: string): Compose | undefined;
+export {};
+//# sourceMappingURL=stacks.d.ts.map

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

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