@mozole/cli 2.0.0-b → 2.1.0

package/dist/commands/adopt.js

@@ -1,52 +1,250 @@
+import { mkdtemp, readFile, readdir, rm } from "node:fs/promises";
+import os from "node:os";
 import path from "node:path";
 import pc from "picocolors";
-import { scaffoldAgentPolicies } from "../scaffold/agents.js";
-import { scaffoldDesign } from "../scaffold/design.js";
-import { scaffoldPhases } from "../scaffold/phases.js";
-import { scaffoldRepomap } from "../scaffold/repomap.js";
-import { scaffoldTokens } from "../scaffold/tokens.js";
-import { exists } from "../utils/fs.js";
+import { generateFlagshipPackageJson } from "../scaffold/flagship.js";
+import { scaffoldNewProject } from "../scaffold/index.js";
+import { generateStandardPackageJson } from "../scaffold/standard.js";
+import { linkWorkflowPolicies } from "../scaffold/workflow.js";
+import { atomicWrite, exists, isDirectory, writeFiles } from "../utils/fs.js";
+import { enableBackend } from "./backend.js";
 export async function adoptProject(options = {}) {
-    const targetDir = options.targetDir ? path.resolve(options.targetDir) : process.cwd();
-    const projectName = options.projectName ?? path.basename(targetDir);
-    if (!(await exists(targetDir))) {
+    const targetDir = path.resolve(options.targetDir ?? process.cwd());
+    if (!(await isDirectory(targetDir)))
         throw new Error(`Directory not found: ${targetDir}`);
+    const pkgPath = path.join(targetDir, "package.json");
+    const hasPackage = await exists(pkgPath);
+    const pkg = hasPackage ? JSON.parse(await readFile(pkgPath, "utf8")) : {};
+    const dependencies = { ...pkg.devDependencies, ...pkg.dependencies };
+    const foreignFramework = dependencies.vue ||
+        dependencies.svelte ||
+        dependencies["@angular/core"] ||
+        dependencies.angular ||
+        dependencies.next ||
+        dependencies.nuxt;
+    if (hasPackage && foreignFramework) {
+        throw new Error("Adopt supports Vite + React projects. Migrate this project's framework to Vite + React before adopting; no files were changed.");
     }
-    console.log(pc.cyan(`\n📦 Adopting existing project into Mozole Studio governance: ${pc.bold(projectName)}`));
-    console.log(`  Target: ${targetDir}\n`);
-    // 1. Authoritative Policies
-    const agentsPath = path.join(targetDir, "AGENTS.md");
-    if (!(await exists(agentsPath))) {
-        await scaffoldAgentPolicies(targetDir, projectName);
-        console.log(pc.green("  ✓ Injected AGENTS.md, CLAUDE.md, and Cursor rules"));
-    }
-    else {
-        console.log(pc.yellow("  - AGENTS.md already exists, preserving"));
-    }
-    // 2. Phases & Repomap
-    const phasesPath = path.join(targetDir, "docs", "phases", "status.md");
-    if (!(await exists(phasesPath))) {
-        await scaffoldPhases(targetDir);
-        console.log(pc.green("  ✓ Generated docs/phases/status.md (Phase 00 initialized)"));
-    }
-    const repomapPath = path.join(targetDir, "docs", "repomap", "architecture.md");
-    if (!(await exists(repomapPath))) {
-        await scaffoldRepomap(targetDir, projectName, false);
-        console.log(pc.green("  ✓ Generated docs/repomap/ fihrist architecture"));
-    }
-    // 3. Design References
-    const designPath = path.join(targetDir, "docs", "design", "README.md");
-    if (!(await exists(designPath))) {
-        await scaffoldDesign(targetDir, projectName);
-        console.log(pc.green("  ✓ Generated docs/design/ evidence directory"));
-    }
-    // 4. Tokens
-    const tokensPath = path.join(targetDir, "src", "styles", "tokens.css");
-    if (!(await exists(tokensPath))) {
-        await scaffoldTokens(targetDir);
-        console.log(pc.green("  ✓ Generated canonical src/styles/tokens.css"));
-    }
-    console.log(pc.green("\n✓ Project successfully adopted into Mozole governance."));
-    console.log(`Run ${pc.cyan("mozole verify")} to audit current conformance.\n`);
+    if (!hasPackage) {
+        const contents = await readdir(targetDir);
+        if (contents.some((file) => !file.startsWith(".") && !/^(README|LICENSE|AGENTS|CLAUDE)(\.|$)/i.test(file))) {
+            throw new Error("A nonempty project needs a Vite + React package.json before adoption.");
+        }
+    }
+    if (options.backend && !["none", "php", "node"].includes(options.backend))
+        throw new Error("Invalid backend runtime.");
+    const flagship = options.flagship ?? Boolean(dependencies.wouter);
+    if (flagship &&
+        (dependencies["@react-router/dev"] ||
+            dependencies["react-router"] ||
+            dependencies["react-router-dom"])) {
+        throw new Error("Convert React Router framework routes to Wouter before adopting as Flagship.");
+    }
+    const name = options.projectName ?? pkg.name ?? path.basename(targetDir);
+    const metadataPath = path.join(targetDir, ".mozole/project.json");
+    const metadata = (await exists(metadataPath))
+        ? JSON.parse(await readFile(metadataPath, "utf8"))
+        : {};
+    const backend = metadata.backend ??
+        ((await exists(path.join(targetDir, "server/index.mjs")))
+            ? "node"
+            : (await exists(path.join(targetDir, "api/index.php")))
+                ? "php"
+                : "none");
+    if (options.backend &&
+        options.backend !== "none" &&
+        backend !== "none" &&
+        options.backend !== backend) {
+        throw new Error(`Existing ${backend} backend must be migrated explicitly before switching runtime.`);
+    }
+    const framework = Boolean(dependencies["@react-router/dev"]);
+    if (hasPackage &&
+        dependencies.tailwindcss &&
+        !/^(?:\^|~)?4(?:\.|$)/.test(dependencies.tailwindcss)) {
+        throw new Error("Adopt requires Tailwind v4. Migrate the existing Tailwind configuration first; no files were changed.");
+    }
+    const expected = JSON.parse(flagship
+        ? generateFlagshipPackageJson("adopted-project")
+        : generateStandardPackageJson("adopted-project"));
+    // Existing Vite SPAs retain their entry and routing composition.
+    if (hasPackage && !flagship && !framework) {
+        const { "@react-router/node": _node, "@react-router/serve": _serve, isbot: _bot, ...filteredDeps } = expected.dependencies;
+        expected.dependencies = filteredDeps;
+        const { "@react-router/dev": _dev, ...filteredDevDeps } = expected.devDependencies;
+        expected.devDependencies = filteredDevDeps;
+        expected.devDependencies["@vitejs/plugin-react"] = "^4.3.4";
+        expected.scripts = {
+            dev: "vite",
+            build: "tsc --noEmit && vite build",
+            preview: "vite preview",
+            typecheck: "tsc --noEmit",
+            verify: "mozole verify",
+        };
+    }
+    const report = [];
+    if (hasPackage &&
+        !flagship &&
+        !framework &&
+        !dependencies["react-router"] &&
+        !dependencies["react-router-dom"]) {
+        report.push("React Router was added. Mount a BrowserRouter or RouterProvider when composing route-aware layouts into existing pages.");
+    }
+    for (const section of ["dependencies", "devDependencies"]) {
+        for (const [dependency, version] of Object.entries(expected[section])) {
+            if (dependencies[dependency]) {
+                if (dependencies[dependency] !== version)
+                    report.push(`Review dependency ${dependency}: preserved ${dependencies[dependency]}, scaffold baseline ${version}.`);
+            }
+            else {
+                pkg[section] = { ...pkg[section], [dependency]: version };
+            }
+        }
+    }
+    pkg.name ??= name;
+    pkg.type ??= "module";
+    pkg.private ??= true;
+    pkg.scripts = { ...expected.scripts, ...pkg.scripts };
+    const temp = await mkdtemp(path.join(os.tmpdir(), "mozole-adopt-"));
+    const written = [];
+    try {
+        await scaffoldNewProject({
+            targetDir: temp,
+            name: "adopted-project",
+            flagship,
+            initGit: false,
+        });
+        async function collect(dir, prefix = "") {
+            const files = {};
+            for (const item of await readdir(dir, { withFileTypes: true })) {
+                const relative = prefix ? `${prefix}/${item.name}` : item.name;
+                if (item.isDirectory())
+                    Object.assign(files, await collect(path.join(dir, item.name), relative));
+                else
+                    files[relative] = await readFile(path.join(dir, item.name), "utf8");
+            }
+            return files;
+        }
+        const files = await collect(temp);
+        if (hasPackage) {
+            files["docs/repomap/routes.md"] =
+                "# Existing routes\n\nApplication routes are preserved. Index the existing route components here during adoption review.\n";
+            files["docs/repomap/architecture.md"] = files["docs/repomap/architecture.md"].replace("None (static frontend)", backend === "none" ? "None (static frontend)" : `${backend} (existing project backend)`);
+            if (!flagship && !framework)
+                files["docs/repomap/architecture.md"] = files["docs/repomap/architecture.md"].replace("React Router 7 (Framework Mode with Static Pre-rendering / SSG)", "Existing Vite React SPA; React Router library available for composition");
+        }
+        const { "package.json": _packageJson, ".mozole/project.json": _projectJson, ...filteredFiles } = files;
+        for (const [file, content] of Object.entries(filteredFiles)) {
+            if (file === "docs/design/design.md" && (await exists(path.join(targetDir, "design.md"))))
+                continue;
+            if (hasPackage &&
+                (file === "index.html" ||
+                    file === "react-router.config.ts" ||
+                    file === "src/main.tsx" ||
+                    file === "src/App.tsx" ||
+                    file === "src/root.tsx" ||
+                    file === "src/routes.ts" ||
+                    file.startsWith("src/routes/")))
+                continue;
+            if (hasPackage && file === "vite.config.ts")
+                continue;
+            if (await exists(path.join(targetDir, file))) {
+                if (file.startsWith("src/components/") ||
+                    file.startsWith("src/behaviors/") ||
+                    file === "src/library/index.ts") {
+                    await writeFiles(targetDir, { [`.mozole/adoption-proposals/${file}`]: content });
+                }
+                if (file.endsWith("index.ts") ||
+                    file === "tsconfig.json" ||
+                    file === "src/styles/tokens.css")
+                    report.push(`Preserved ${file}; review the project library exports and token/tooling integration.`);
+                continue;
+            }
+            const value = file.endsWith(".md") || file.endsWith(".mdc")
+                ? content.replaceAll("adopted-project", name)
+                : content;
+            written.push(...(await writeFiles(targetDir, { [file]: value })));
+        }
+    }
+    finally {
+        await rm(temp, { recursive: true, force: true });
+    }
+    await linkWorkflowPolicies(targetDir);
+    if (hasPackage) {
+        let entry;
+        for (const candidate of framework
+            ? ["src/root.tsx"]
+            : ["src/main.tsx", "src/main.jsx", "src/index.tsx", "src/index.jsx"]) {
+            if (await exists(path.join(targetDir, candidate))) {
+                entry = candidate;
+                break;
+            }
+        }
+        if (entry) {
+            const file = path.join(targetDir, entry);
+            const content = await readFile(file, "utf8");
+            if (!content.includes("./styles/tokens.css"))
+                await atomicWrite(file, `import "./styles/tokens.css";\n${content}`);
+        }
+        else
+            report.push("Import src/styles/tokens.css from your custom application entry.");
+        let config;
+        for (const candidate of [
+            "vite.config.ts",
+            "vite.config.mts",
+            "vite.config.js",
+            "vite.config.mjs",
+        ]) {
+            if (await exists(path.join(targetDir, candidate))) {
+                config = candidate;
+                break;
+            }
+        }
+        const configText = config ? await readFile(path.join(targetDir, config), "utf8") : "";
+        if (!configText.includes("@tailwindcss/vite")) {
+            const wrapper = "mozole.adopt.vite.config.mjs";
+            if (!(await exists(path.join(targetDir, wrapper)))) {
+                await writeFiles(targetDir, {
+                    [wrapper]: `${config ? `import base from "./${config}";` : framework ? 'import { reactRouter } from "@react-router/dev/vite";\nconst base = { plugins: [reactRouter()] };' : 'import react from "@vitejs/plugin-react";\nconst base = { plugins: [react()] };'}
+import tailwindcss from "@tailwindcss/vite";
+import { defineConfig, mergeConfig } from "vite";
+
+export default defineConfig(async (env) => mergeConfig(
+  await (typeof base === "function" ? base(env) : base),
+  { plugins: [tailwindcss()], server: { proxy: { "/api": "http://127.0.0.1:3001" } } },
+));
+`,
+                });
+            }
+            for (const script of ["dev", "build", "preview"]) {
+                if (typeof pkg.scripts[script] === "string" &&
+                    !pkg.scripts[script].includes("--config") &&
+                    !/(?:^|\s)-c(?:\s|$)/.test(pkg.scripts[script]) &&
+                    /\b(vite|react-router)\b/.test(pkg.scripts[script])) {
+                    pkg.scripts[script] += ` --config ${wrapper}`;
+                }
+                else
+                    report.push(`Review ${script} script: retained its existing config selection.`);
+            }
+        }
+        report.push("Existing pages and routing were preserved. Compose the local UI/layout modules into those pages; remove legacy duplicate styles after reviewing their appearance.");
+        if (flagship)
+            report.push("Mount useSmoothScroll and Reveal where desired; generated behavior and motion remain opt-in in existing pages.");
+    }
+    await atomicWrite(pkgPath, JSON.stringify(pkg, null, 2));
+    await atomicWrite(metadataPath, JSON.stringify({
+        ...metadata,
+        version: 1,
+        name,
+        profile: flagship ? "flagship" : "standard",
+        backend,
+        library: "src/library/index.ts",
+        adoption: report.length ? "review-required" : "complete",
+    }, null, 2));
+    if (options.backend && options.backend !== "none" && backend === "none") {
+        await enableBackend({ targetDir, runtime: options.backend });
+    }
+    await atomicWrite(path.join(targetDir, ".mozole/adoption-report.md"), `# Adoption report\n\nAdded ${written.length} files. Existing application files were preserved.\n\n${report.length ? report.map((item) => `- ${item}`).join("\n") : "No manual integration items detected."}\n\nInstall dependencies at the prototype root (if applicable), otherwise here. Run mozole verify after completing the review.\n`);
+    console.log(pc.green(`✓ Adopted ${name}; added ${written.length} files.`));
+    console.log(`Review ${path.join(targetDir, ".mozole/adoption-report.md")} before claiming full conformance.`);
 }
 //# sourceMappingURL=adopt.js.map

package/dist/commands/adopt.js.map

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

package/dist/commands/assets.d.ts

@@ -0,0 +1,28 @@
+export declare const IMAGE_WIDTHS: number[];
+export interface AssetOptions {
+    cwd?: string;
+    input?: string;
+    output?: string;
+    widths?: string;
+    quality?: number;
+    base?: string;
+    log?: (message: string) => void;
+}
+export interface OptimizedImage {
+    src: string;
+    width: number;
+    height: number;
+    sources: {
+        type: string;
+        srcSet: string;
+    }[];
+    variants: {
+        src: string;
+        width: number;
+        height: number;
+        bytes: number;
+        format: string;
+    }[];
+}
+export declare function optimizeAssets(options?: AssetOptions): Promise<Record<string, OptimizedImage>>;
+//# sourceMappingURL=assets.d.ts.map

package/dist/commands/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/commands/assets.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,YAAY,UAA2D,CAAC;AACrF,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AACD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3F;AAED,wBAAsB,cAAc,CAClC,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CA0LzC"}

package/dist/commands/assets.js

@@ -0,0 +1,176 @@
+import { createHash } from "node:crypto";
+import { readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { scaffoldToolsGuide } from "../scaffold/tools-guide.js";
+import { atomicWrite, exists, writeFiles } from "../utils/fs.js";
+import { run } from "../utils/process.js";
+import { projectDirectory, projectPath, regularFiles } from "../utils/project-files.js";
+export const IMAGE_WIDTHS = [320, 480, 640, 768, 1024, 1280, 1600, 1920, 2560, 3840];
+export async function optimizeAssets(options = {}) {
+    const log = options.log ?? console.log;
+    const root = await projectDirectory(options.cwd);
+    const input = await projectPath(root, options.input ?? "assets/images");
+    const output = await projectPath(root, options.output ?? "public/media");
+    const publicRoot = path.join(root, "public");
+    if (!output.startsWith(publicRoot + path.sep))
+        throw new Error("Asset output must be a subdirectory of public/.");
+    if (output === input ||
+        output.startsWith(input + path.sep) ||
+        input.startsWith(output + path.sep))
+        throw new Error("Input and output directories must not overlap.");
+    const widths = options.widths
+        ? [...new Set(options.widths.split(",").map(Number))].sort((a, b) => a - b)
+        : IMAGE_WIDTHS;
+    if (!widths.length ||
+        widths.length > 20 ||
+        widths.some((width) => !Number.isInteger(width) || width < 1 || width > 7680))
+        throw new Error("Widths must contain 1–20 integer sizes between 1 and 7680.");
+    const quality = options.quality ?? 78;
+    if (!Number.isInteger(quality) || quality < 1 || quality > 100)
+        throw new Error("Quality must be an integer from 1 to 100.");
+    const base = options.base ?? "/";
+    if (!base.startsWith("/") ||
+        base.startsWith("//") ||
+        /[?#\\\s]/.test(base) ||
+        base.split("/").includes(".."))
+        throw new Error("Base must be a site path such as / or /client/.");
+    const prefix = `${base.replace(/\/$/, "")}/${path.relative(publicRoot, output).split(path.sep).map(encodeURIComponent).join("/")}`;
+    for (const file of [
+        "src/assets/images.generated.ts",
+        "src/components/ui/ResponsiveImage.tsx",
+        "src/components/ui/index.ts",
+        "src/library/index.ts",
+        `${path.relative(root, output)}/manifest.json`,
+    ])
+        await projectPath(root, file);
+    const candidates = (await regularFiles(input)).filter((file) => /\.(jpe?g|png|webp|avif|tiff?|gif)$/i.test(file));
+    if (!candidates.length)
+        throw new Error(`No supported raster images found in ${input}.`);
+    const { default: sharp } = await import("sharp");
+    const images = {};
+    const skipped = [];
+    for (const file of candidates) {
+        const source = path.join(input, file);
+        if ((await stat(source)).size > 50 * 1024 * 1024)
+            throw new Error(`Image exceeds 50 MB: ${file}`);
+        const buffer = await readFile(source);
+        const metadata = await sharp(buffer, { limitInputPixels: 100_000_000 }).metadata();
+        if ((metadata.pages ?? 1) > 1) {
+            skipped.push(`${file} (animated/multipage)`);
+            continue;
+        }
+        const swapped = [5, 6, 7, 8].includes(metadata.orientation ?? 1);
+        const width = (swapped ? metadata.height : metadata.width) ?? 0;
+        const height = (swapped ? metadata.width : metadata.height) ?? 0;
+        if (!width || !height)
+            throw new Error(`Missing image dimensions: ${file}`);
+        const sizes = [
+            ...new Set([
+                ...widths.filter((size) => size <= width),
+                Math.min(width, widths[widths.length - 1]),
+            ]),
+        ].sort((a, b) => a - b);
+        const id = createHash("sha256")
+            .update(buffer)
+            .update(JSON.stringify({
+            file,
+            sizes,
+            quality,
+            sharp: sharp.versions.sharp,
+            vips: sharp.versions.vips,
+        }))
+            .digest("hex")
+            .slice(0, 20);
+        const variants = [];
+        for (const size of sizes) {
+            for (const format of ["avif", "webp"]) {
+                const result = await sharp(buffer, { limitInputPixels: 100_000_000 })
+                    .rotate()
+                    .resize({ width: size, withoutEnlargement: true })[format]({ quality, effort: 4 })
+                    .toBuffer({ resolveWithObject: true });
+                const name = `${id}-${result.info.width}.${format}`;
+                await atomicWrite(path.join(output, name), result.data);
+                variants.push({
+                    src: `${prefix}/${name}`,
+                    width: result.info.width,
+                    height: result.info.height,
+                    bytes: result.info.size,
+                    format,
+                });
+            }
+        }
+        const fallbackSize = sizes.find((size) => size >= 1280) ?? sizes[sizes.length - 1];
+        const format = metadata.hasAlpha ? "png" : "jpeg";
+        const fallback = await sharp(buffer, { limitInputPixels: 100_000_000 })
+            .rotate()
+            .resize({ width: fallbackSize, withoutEnlargement: true })[format]({ quality })
+            .toBuffer({ resolveWithObject: true });
+        const name = `${id}-fallback.${format === "jpeg" ? "jpg" : "png"}`;
+        await atomicWrite(path.join(output, name), fallback.data);
+        images[file] = {
+            src: `${prefix}/${name}`,
+            width: fallback.info.width,
+            height: fallback.info.height,
+            sources: ["avif", "webp"].map((type) => ({
+                type: `image/${type}`,
+                srcSet: variants
+                    .filter((item) => item.format === type)
+                    .map((item) => `${item.src} ${item.width}w`)
+                    .join(", "),
+            })),
+            variants,
+        };
+        log(`Optimized ${file}: ${sizes.join(", ")}px, AVIF + WebP`);
+    }
+    if (!Object.keys(images).length)
+        throw new Error(`No still images optimized. Skipped: ${skipped.join(", ")}`);
+    await atomicWrite(path.join(output, "manifest.json"), JSON.stringify({ images, skipped }, null, 2));
+    await atomicWrite(path.join(root, "src/assets/images.generated.ts"), `// Asset manifest; regenerate with mozole assets.\nexport const images = ${JSON.stringify(images, null, 2)} as const;\n`);
+    const component = "src/components/ui/ResponsiveImage.tsx";
+    const newComponent = !(await exists(path.join(root, component)));
+    await writeFiles(root, {
+        [component]: `import type { ImgHTMLAttributes } from "react";
+
+export interface ResponsiveImageProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, "src" | "srcSet" | "width" | "height" | "loading" | "fetchPriority" | "alt" | "sizes"> {
+  image: { src: string; width: number; height: number; sources: readonly { type: string; srcSet: string }[] };
+  alt: string;
+  sizes: string;
+  priority?: boolean;
+}
+
+export function ResponsiveImage({ image, alt, sizes, priority = false, ...props }: ResponsiveImageProps) {
+  return <picture>
+    {image.sources.map(source => <source key={source.type} type={source.type} srcSet={source.srcSet} sizes={sizes} />)}
+    <img {...props} src={image.src} width={image.width} height={image.height} alt={alt} sizes={sizes} loading={priority ? "eager" : "lazy"} fetchPriority={priority ? "high" : "auto"} decoding="async" />
+  </picture>;
+}
+`,
+    });
+    if (newComponent) {
+        for (const [file, line] of [
+            ["src/components/ui/index.ts", 'export * from "./ResponsiveImage";'],
+            ["src/library/index.ts", 'export * from "../components/ui";'],
+        ]) {
+            const target = path.join(root, file);
+            const content = (await exists(target)) ? await readFile(target, "utf8") : "";
+            if (!content.includes(line))
+                await atomicWrite(target, `${content}\n${line}\n`);
+        }
+    }
+    await scaffoldToolsGuide(root);
+    try {
+        await run("npx", [
+            "@biomejs/biome",
+            "format",
+            "--write",
+            "src/assets",
+            "src/components/ui/ResponsiveImage.tsx",
+        ], { cwd: root });
+    }
+    catch {
+        // Non-fatal if biome is not yet available in the environment
+    }
+    log(`Wrote ${Object.keys(images).length} images to ${output}; skipped: ${skipped.join(", ") || "none"}. Originals preserved.`);
+    return images;
+}
+//# sourceMappingURL=assets.js.map

package/dist/commands/assets.js.map

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

package/dist/commands/backend.d.ts

@@ -0,0 +1,5 @@
+export declare function enableBackend(options: {
+    targetDir?: string;
+    runtime: string;
+}): Promise<void>;
+//# sourceMappingURL=backend.d.ts.map

package/dist/commands/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/commands/backend.ts"],"names":[],"mappings":"AAKA,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0EhB"}

package/dist/commands/backend.js

@@ -0,0 +1,68 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { scaffoldBackend } from "../scaffold/backend.js";
+import { atomicWrite, exists, findProjectRoot, writeFiles } from "../utils/fs.js";
+export async function enableBackend(options) {
+    const { runtime } = options;
+    if (runtime !== "php" && runtime !== "node")
+        throw new Error("Choose backend runtime: php or node.");
+    const root = path.resolve(options.targetDir ?? (await findProjectRoot()) ?? process.cwd());
+    const manifestPath = path.join(root, ".mozole/project.json");
+    const project = (await exists(manifestPath))
+        ? JSON.parse(await readFile(manifestPath, "utf8"))
+        : {};
+    if (project.backend && project.backend !== "none") {
+        if (project.backend !== runtime)
+            throw new Error(`Project already uses ${project.backend}. Migrate its data and API explicitly before switching.`);
+        console.log(`Backend ${runtime} already enabled. Run npm run dev:backend.`);
+        return;
+    }
+    const pkgPath = path.join(root, "package.json");
+    const pkg = JSON.parse(await readFile(pkgPath, "utf8"));
+    const dev = pkg.scripts?.dev;
+    if (typeof dev !== "string" || !/^(vite|react-router dev)(\s|$)/.test(dev)) {
+        throw new Error("Backend activation requires a Vite or React Router dev script. Adopt or configure the project first.");
+    }
+    const selected = dev.match(/(?:--config(?:=|\s+)|-c\s+)([a-zA-Z0-9_./-]+)/);
+    if ((dev.includes("--config") || /(?:^|\s)-c(?:\s|$)/.test(dev)) && !selected) {
+        throw new Error("Use an unquoted project-relative Vite config path before enabling backend.");
+    }
+    if (selected && (path.isAbsolute(selected[1]) || selected[1].split("/").includes(".."))) {
+        throw new Error("Vite config must be inside the project.");
+    }
+    const configs = ["vite.config.ts", "vite.config.mts", "vite.config.js", "vite.config.mjs"];
+    let config;
+    for (const candidate of configs)
+        if (await exists(path.join(root, candidate))) {
+            config = candidate;
+            break;
+        }
+    config = selected?.[1] ?? config;
+    if (config && !(await exists(path.join(root, config))))
+        throw new Error(`Vite config not found: ${config}`);
+    const wrapper = "mozole.backend.vite.config.mjs";
+    if (await exists(path.join(root, wrapper)))
+        throw new Error(`Preserving existing ${wrapper}; integrate the API proxy manually.`);
+    await scaffoldBackend(root, runtime);
+    await writeFiles(root, {
+        [wrapper]: `${config ? `import base from "./${config}";` : "const base = {};"}
+import { defineConfig, mergeConfig } from "vite";
+
+export default defineConfig(async (env) => mergeConfig(
+  await (typeof base === "function" ? base(env) : base),
+  { server: { proxy: { "/api": "http://127.0.0.1:3001" } } },
+));
+`,
+    });
+    const updatedPkg = JSON.parse(await readFile(pkgPath, "utf8"));
+    updatedPkg.scripts.dev = `${selected ? dev.replace(selected[0], "").trim() : dev} --config ${wrapper}`;
+    await atomicWrite(pkgPath, JSON.stringify(updatedPkg, null, 2));
+    await atomicWrite(manifestPath, JSON.stringify({ ...project, backend: runtime }, null, 2));
+    const architecturePath = path.join(root, "docs/repomap/architecture.md");
+    if (await exists(architecturePath)) {
+        const architecture = await readFile(architecturePath, "utf8");
+        await atomicWrite(architecturePath, architecture.replace(/^- \*\*Backend Architecture:\*\*.*$/m, `- **Backend Architecture:** ${runtime === "php" ? "PHP 8.1+ API in api/" : "Node.js HTTP API in server/"}`));
+    }
+    console.log(`Backend ${runtime} enabled. Run npm run dev:backend and npm run dev in separate terminals.`);
+}
+//# sourceMappingURL=backend.js.map