pressship 0.1.13 → 0.1.15

package/dist/web/server.js

@@ -1,6 +1,6 @@
 import { createHash, randomBytes } from "node:crypto";
 import { createReadStream } from "node:fs";
-import { cp, mkdir, mkdtemp, readFile, rm, stat, unlink, writeFile } from "node:fs/promises";
+import { cp, mkdir, mkdtemp, readdir, readFile, rm, stat, unlink, writeFile } from "node:fs/promises";
 import { createServer } from "node:http";
 import { createRequire } from "node:module";
 import { tmpdir } from "node:os";
@@ -12,6 +12,8 @@ import fg from "fast-glob";
 import { z } from "zod";
 import { hasSavedSession } from "../auth/session.js";
 import { getWordPressOrgAccount } from "../auth/whoami.js";
+import { analyzePluginPackage, stagePluginDirectory } from "../package/archive.js";
+import { addPressshipIgnorePattern, createPressshipIgnoreMatcher, hardIgnoreDirectories, isHardIgnoredPath, pressshipIgnoreFile, readPressshipIgnorePatterns, removePressshipIgnorePattern } from "../package/ignore.js";
 import { createPluginPack, summarizePackResult, validatePluginPack } from "../package/pack.js";
 import { discoverPluginProject, resolvePluginProjectPath } from "../plugin/discover.js";
 import { assertDemoLaunchPlanSupported, createDemoLaunchPlan, prepareDemoRuntime, publicDemoLaunchPlan, resetPlaygroundSite } from "../plugin/demo.js";
@@ -25,7 +27,7 @@ import { publish } from "../wordpress-org/publish.js";
 import { fetchPluginStates, matchesPluginState } from "../wordpress-org/state.js";
 import { runPluginCheck } from "../checks/plugin-check.js";
 import { hasBlockingFindings } from "../checks/summary.js";
-import { ensureCacheDir, getConfigDir } from "../utils/paths.js";
+import { ensureCacheDir, getConfigDir, pathExists } from "../utils/paths.js";
 import { addLocalPluginPath, getLocalPlugin, listLocalPlugins, removeLocalPlugin } from "./registry.js";
 import { WebJobManager } from "./jobs.js";
 import { getVersionState } from "./version-state.js";
@@ -37,11 +39,13 @@ import { addStudioPluginCheckLineHints, normalizeStudioPluginCheckFindings, summ
 import { readStudioPluginCheckState, removeStudioPluginCheckFindingsForFiles, removeStudioPluginCheckState, writeStudioPluginCheckState } from "./plugin-check-state.js";
 const nodeRequire = createRequire(import.meta.url);
 const mutationMethods = new Set(["POST", "PUT", "PATCH", "DELETE"]);
+const spaRoutePrefixes = new Set(["dashboard", "studio", "wordpress.org", "remote", "local", "release", "settings"]);
 const addLocalPluginSchema = z.object({ path: z.string().min(1) });
 const bumpVersionSchema = z.object({ bump: z.enum(["patch", "minor", "major"]) });
 const setVersionSchema = z.object({ version: z.string().min(1) });
 const createSvnTagSchema = z.object({ name: z.string().min(1) });
 const switchSvnTagSchema = z.object({ conflictResolution: z.enum(["override", "revert"]).optional() });
+const ignoreRuleSchema = z.object({ pattern: z.string().min(1) });
 const writeStudioFileSchema = z.object({
     path: z.string().min(1),
     content: z.string()
@@ -102,7 +106,9 @@ export async function startWebServer(options = {}) {
     const approvals = new Map();
     const playgrounds = new Map();
     const playgroundPortReservations = new Set();
+    const packageSizeCache = new Map();
     const staticDir = resolveStaticDir();
+    const dependencies = options.dependencies ?? {};
     const server = createServer((request, response) => {
         void handleRequest(request, response, {
             token,
@@ -110,7 +116,9 @@ export async function startWebServer(options = {}) {
             approvals,
             playgrounds,
             playgroundPortReservations,
-            staticDir
+            packageSizeCache,
+            staticDir,
+            dependencies
         });
     });
     await new Promise((resolve, reject) => {
@@ -271,6 +279,62 @@ async function handleApi(request, response, url, context) {
         sendJson(response, 200, await listStudioFiles(plugin.path));
         return;
     }
+    const studioFilesDirectoryMatch = url.pathname.match(/^\/api\/plugins\/local\/([^/]+)\/files\/directory$/);
+    if (method === "GET" && studioFilesDirectoryMatch) {
+        const plugin = await requireLocalPlugin(decodeURIComponent(studioFilesDirectoryMatch[1]));
+        const relativePath = url.searchParams.get("path") ?? "";
+        sendJson(response, 200, await listStudioDirectory(plugin.path, relativePath));
+        return;
+    }
+    const studioIgnoreStateMatch = url.pathname.match(/^\/api\/plugins\/local\/([^/]+)\/ignore-state$/);
+    if (method === "GET" && studioIgnoreStateMatch) {
+        const plugin = await requireLocalPlugin(decodeURIComponent(studioIgnoreStateMatch[1]));
+        sendJson(response, 200, await readStudioIgnoreState(plugin.path));
+        return;
+    }
+    const studioPackageSizeMatch = url.pathname.match(/^\/api\/plugins\/local\/([^/]+)\/package-size$/);
+    if (method === "GET" && studioPackageSizeMatch) {
+        const plugin = await requireLocalPlugin(decodeURIComponent(studioPackageSizeMatch[1]));
+        sendJson(response, 200, readStudioPackageSize(plugin.path, context.packageSizeCache));
+        return;
+    }
+    const studioIgnoreRulesMatch = url.pathname.match(/^\/api\/plugins\/local\/([^/]+)\/ignore-rules$/);
+    if (method === "POST" && studioIgnoreRulesMatch) {
+        const plugin = await requireLocalPlugin(decodeURIComponent(studioIgnoreRulesMatch[1]));
+        const body = ignoreRuleSchema.parse(await readJson(request));
+        try {
+            await addPressshipIgnorePattern(path.resolve(plugin.path), body.pattern);
+            invalidateStudioPackageSize(plugin.path, context.packageSizeCache);
+            sendJson(response, 200, await readStudioIgnoreState(plugin.path));
+        }
+        catch (error) {
+            sendJson(response, 400, {
+                error: {
+                    message: error instanceof Error ? error.message : String(error),
+                    code: "invalid_ignore_pattern"
+                }
+            });
+        }
+        return;
+    }
+    if (method === "DELETE" && studioIgnoreRulesMatch) {
+        const plugin = await requireLocalPlugin(decodeURIComponent(studioIgnoreRulesMatch[1]));
+        const body = ignoreRuleSchema.parse(await readJson(request));
+        try {
+            await removePressshipIgnorePattern(path.resolve(plugin.path), body.pattern);
+            invalidateStudioPackageSize(plugin.path, context.packageSizeCache);
+            sendJson(response, 200, await readStudioIgnoreState(plugin.path));
+        }
+        catch (error) {
+            sendJson(response, 400, {
+                error: {
+                    message: error instanceof Error ? error.message : String(error),
+                    code: "invalid_ignore_pattern"
+                }
+            });
+        }
+        return;
+    }
     const studioCheckStateMatch = url.pathname.match(/^\/api\/plugins\/local\/([^/]+)\/check-state$/);
     if (method === "GET" && studioCheckStateMatch) {
         const localId = decodeURIComponent(studioCheckStateMatch[1]);
@@ -290,6 +354,7 @@ async function handleApi(request, response, url, context) {
         const plugin = await requireLocalPlugin(localId);
         const body = writeStudioFileSchema.parse(await readJson(request));
         const saved = await writeStudioFile(plugin.path, body.path, body.content);
+        invalidateStudioPackageSize(plugin.path, context.packageSizeCache);
         sendJson(response, 200, {
             ...saved,
             checkState: await removeStudioPluginCheckFindingsForFiles(localId, [saved.path])
@@ -303,6 +368,7 @@ async function handleApi(request, response, url, context) {
         const body = studioAiChangeSchema.parse(await readJson(request));
         try {
             const applied = await applyStudioAiChange(plugin.path, body);
+            invalidateStudioPackageSize(plugin.path, context.packageSizeCache);
             const checkState = await removeStudioPluginCheckFindingsForFiles(localId, [applied.path]);
             sendJson(response, 200, {
                 ...applied,
@@ -325,6 +391,7 @@ async function handleApi(request, response, url, context) {
         const localId = decodeURIComponent(bumpMatch[1]);
         const plugin = await requireLocalPlugin(localId);
         await bumpLocalPluginVersion(plugin.path, body.bump);
+        invalidateStudioPackageSize(plugin.path, context.packageSizeCache);
         await addLocalPluginPath(plugin.path, plugin.source);
         await removeStudioPluginCheckState(localId);
         sendJson(response, 200, { ...(await getVersionState(plugin.path)), checkState: null });
@@ -347,6 +414,7 @@ async function handleApi(request, response, url, context) {
         }
         try {
             await setLocalPluginVersion(plugin.path, trimmed);
+            invalidateStudioPackageSize(plugin.path, context.packageSizeCache);
             await addLocalPluginPath(plugin.path, plugin.source);
             await removeStudioPluginCheckState(localId);
             sendJson(response, 200, { ...(await getVersionState(plugin.path)), checkState: null });
@@ -410,7 +478,7 @@ async function handleApi(request, response, url, context) {
     }
     if (method === "POST" && url.pathname === "/api/jobs") {
         const body = jobSchema.parse(await readJson(request));
-        const job = createWebJob(body, context.jobs, context.approvals, context.playgrounds, context.playgroundPortReservations);
+        const job = createWebJob(body, context.jobs, context.approvals, context.playgrounds, context.playgroundPortReservations, context.dependencies);
         sendJson(response, 202, job);
         return;
     }
@@ -437,7 +505,7 @@ async function handleApi(request, response, url, context) {
     }
     sendJson(response, 404, { error: { message: "Not found.", code: "not_found" } });
 }
-function createWebJob(input, jobs, approvals, playgrounds, playgroundPortReservations) {
+function createWebJob(input, jobs, approvals, playgrounds, playgroundPortReservations, dependencies = {}) {
     if (input.type === "clone") {
         return jobs.create("clone", `Clone/update ${input.slug}`, (context) => clonePluginJob(input, context));
     }
@@ -445,7 +513,7 @@ function createWebJob(input, jobs, approvals, playgrounds, playgroundPortReserva
         return jobs.create("play", `Start Playground for ${input.id}`, (context) => playPluginJob(input, playgrounds, playgroundPortReservations, context));
     }
     if (input.type === "check") {
-        return jobs.create("check", "Plugin Check", (context) => pluginCheckJob(input.localId, context));
+        return jobs.create("check", "Plugin Check", (context) => pluginCheckJob(input.localId, context, dependencies));
     }
     if (input.type === "ai-chat") {
         return jobs.create("ai-chat", "AI Assistance", (context) => aiChatJob(input, context));
@@ -569,41 +637,50 @@ async function playPluginJob(input, playgrounds, playgroundPortReservations, con
         throw error;
     }
 }
-async function pluginCheckJob(localId, context) {
+async function pluginCheckJob(localId, context, dependencies = {}) {
     const local = await requireLocalPlugin(localId);
     const source = resolvePluginProjectPath(local.path);
     const project = await discoverPluginProject(source.rootDir);
+    const stagePlugin = dependencies.stagePluginDirectory ?? stagePluginDirectory;
+    const pluginChecker = dependencies.runPluginCheck ?? runPluginCheck;
+    const stageRoot = await mkdtemp(path.join(tmpdir(), "pressship-studio-check-"));
     context.status(`Running WordPress.org Plugin Check for ${project.headers.pluginName}.`);
-    const result = await runPluginCheck(source.rootDir, { mode: "new" });
-    const findings = await addStudioPluginCheckLineHints(normalizeStudioPluginCheckFindings(result.findings, source.rootDir, project.slug), source.rootDir);
-    const summary = summarizeStudioPluginCheckFindings(findings);
-    const checkedAt = new Date().toISOString();
-    const persisted = await writeStudioPluginCheckState({
-        pluginId: local.id,
-        pluginPath: local.path,
-        slug: local.slug,
-        name: local.name,
-        skipped: result.skipped,
-        available: result.available,
-        findings,
-        summary,
-        checkedAt
-    });
-    context.log(`Plugin Check finished: ${summary.error} errors, ${summary.warning} warnings, ${summary.info} info.`);
-    return {
-        plugin: {
-            id: local.id,
-            name: local.name,
+    try {
+        const checkTarget = await stagePlugin(project, { outputDir: stageRoot });
+        const result = await pluginChecker(checkTarget.path, { mode: "new" });
+        const findings = await addStudioPluginCheckLineHints(normalizeStudioPluginCheckFindings(result.findings, checkTarget.path, project.slug), source.rootDir);
+        const summary = summarizeStudioPluginCheckFindings(findings);
+        const checkedAt = new Date().toISOString();
+        const persisted = await writeStudioPluginCheckState({
+            pluginId: local.id,
+            pluginPath: local.path,
             slug: local.slug,
-            path: local.path
-        },
-        skipped: result.skipped,
-        available: result.available,
-        findings,
-        summary,
-        checkedAt: persisted.checkedAt,
-        rawOutput: result.rawOutput
-    };
+            name: local.name,
+            skipped: result.skipped,
+            available: result.available,
+            findings,
+            summary,
+            checkedAt
+        });
+        context.log(`Plugin Check finished: ${summary.error} errors, ${summary.warning} warnings, ${summary.info} info.`);
+        return {
+            plugin: {
+                id: local.id,
+                name: local.name,
+                slug: local.slug,
+                path: local.path
+            },
+            skipped: result.skipped,
+            available: result.available,
+            findings,
+            summary,
+            checkedAt: persisted.checkedAt,
+            rawOutput: result.rawOutput
+        };
+    }
+    finally {
+        await rm(stageRoot, { recursive: true, force: true });
+    }
 }
 async function aiChatJob(input, context) {
     const local = await requireLocalPlugin(input.localId);
@@ -680,12 +757,13 @@ async function dryRunPublishJob(localId, requestedAction, approvals, context) {
     if (route.action === "release" && versionState.releaseBlocked) {
         context.log("Release is blocked by version state.", versionState);
     }
+    const ignorePatterns = await readPressshipIgnorePatterns(source.rootDir);
     context.status("Validating package.");
-    const validation = await validatePluginPack(project, {});
+    const validation = await validatePluginPack(project, { ignore: ignorePatterns });
     const validationBlocked = hasBlockingFindings(validation.readmeFindings) || hasBlockingFindings(validation.pluginCheckFindings);
     const cacheDir = path.join(await ensureCacheDir(), "studio-packages");
     await mkdir(cacheDir, { recursive: true, mode: 0o700 });
-    const pack = summarizePackResult(await createPluginPack(source.rootDir, { outputDir: cacheDir }), validation);
+    const pack = summarizePackResult(await createPluginPack(source.rootDir, { outputDir: cacheDir, ignore: ignorePatterns }), validation);
     const releasePlan = route.action === "release"
         ? createReleaseCommandPlan(project.slug, path.resolve(source.svnRootDir ?? path.join(process.cwd(), ".pressship-svn", project.slug)), project.version ?? "unknown", `Release ${project.slug} ${project.version ?? "unknown"}`, await inferWordPressOrgUsername())
         : undefined;
@@ -695,7 +773,8 @@ async function dryRunPublishJob(localId, requestedAction, approvals, context) {
             localId,
             pluginPath: source.inputDir,
             action: route.action,
-            version: project.version
+            version: project.version,
+            ignore: ignorePatterns
         })
         : undefined;
     return {
@@ -728,6 +807,7 @@ async function confirmPublishJob(approvalId, overview, approvals, context) {
         yes: true,
         submit: approval.action === "submit",
         release: approval.action === "release",
+        ignore: approval.ignore ?? [],
         overview: overview ?? project.headers.description ?? ""
     });
     approvals.delete(approvalId);
@@ -749,39 +829,366 @@ async function readPluginDetail(scope, id) {
         readme: await fetchHostedReadme(id).catch(() => undefined)
     };
 }
+const studioHiddenFilePatterns = [
+    "**/.git/**",
+    "**/.svn/**",
+    "**/node_modules/**",
+    "**/vendor/**",
+    "**/build/**",
+    "**/dist/**",
+    "**/playground/**",
+    "**/.wordpress-playground/**"
+];
+const maxStudioEditableFileBytes = 1_000_000;
+const studioAlwaysHiddenDirectoryNames = new Set([".git"]);
+const studioDeferredDirectoryNames = new Set([
+    ...hardIgnoreDirectories,
+    "vendor",
+    ".wordpress-playground",
+    "playground"
+]);
+const studioDeferredDirectoryPatterns = Array.from(studioDeferredDirectoryNames).flatMap((directory) => [
+    `${directory}/**`,
+    `**/${directory}/**`
+]);
+const studioEditableExtensions = new Set([
+    ".php",
+    ".js",
+    ".jsx",
+    ".ts",
+    ".tsx",
+    ".css",
+    ".scss",
+    ".sass",
+    ".html",
+    ".htm",
+    ".json",
+    ".md",
+    ".txt",
+    ".xml",
+    ".yml",
+    ".yaml",
+    ".po",
+    ".pot",
+    ".ini",
+    ".sh",
+    ".svg"
+]);
+const studioEditableFileNames = new Set([
+    "composer.json",
+    "package.json",
+    "readme.txt",
+    "license",
+    "license.txt",
+    pressshipIgnoreFile
+]);
 async function listStudioFiles(pluginPath) {
     const root = path.resolve(pluginPath);
-    const files = await fg([
-        "**/*.{php,js,jsx,ts,tsx,css,scss,sass,html,htm,json,md,txt,xml,yml,yaml,po,pot,ini,sh}",
-        "composer.json",
-        "package.json",
-        "readme.txt"
-    ], {
+    const patterns = await readPressshipIgnorePatterns(root);
+    const matcher = createPressshipIgnoreMatcher(patterns);
+    const [files, deferredDirectories, ignoredDirectories] = await Promise.all([
+        fg("**/*", {
+            cwd: root,
+            onlyFiles: true,
+            dot: true,
+            unique: true,
+            ignore: studioDeferredDirectoryPatterns
+        }),
+        listStudioDeferredDirectories(root, matcher),
+        listStudioIgnoredPatternDirectories(root, patterns, matcher)
+    ]);
+    const directories = mergeStudioDirectoryEntries([...deferredDirectories, ...ignoredDirectories]);
+    const entries = await Promise.all(files.sort((a, b) => a.localeCompare(b)).map(async (relativePath) => {
+        const fileStats = await stat(path.join(root, relativePath));
+        const ignoredBy = matcher.ignoredBy(relativePath);
+        return {
+            path: relativePath,
+            name: path.basename(relativePath),
+            directory: path.dirname(relativePath) === "." ? "" : path.dirname(relativePath),
+            size: fileStats.size,
+            hardIgnored: isHardIgnoredPath(relativePath),
+            ignored: Boolean(ignoredBy),
+            ignoredBy
+        };
+    }));
+    return { files: entries, directories };
+}
+async function listStudioDirectory(pluginPath, relativePath) {
+    const root = path.resolve(pluginPath);
+    const normalized = normalizeStudioRelativePath(relativePath);
+    if (!normalized) {
+        throw new Error("Choose a folder first.");
+    }
+    if (studioExplorerDirectoryIsAlwaysHidden(normalized)) {
+        return { files: [], directories: [] };
+    }
+    const directoryPath = path.resolve(root, normalized);
+    if (directoryPath !== root && !directoryPath.startsWith(`${root}${path.sep}`)) {
+        throw new Error("Folder is outside the plugin directory.");
+    }
+    const directoryStats = await stat(directoryPath);
+    if (!directoryStats.isDirectory()) {
+        throw new Error("Studio can only load folders.");
+    }
+    const patterns = await readPressshipIgnorePatterns(root);
+    const matcher = createPressshipIgnoreMatcher(patterns);
+    const ignoredBy = studioIgnoredBy(normalized, matcher);
+    const entries = await readdir(directoryPath, { withFileTypes: true });
+    const files = [];
+    const directories = [
+        {
+            path: normalized,
+            name: path.basename(normalized),
+            directory: path.dirname(normalized) === "." ? "" : path.dirname(normalized),
+            deferred: false,
+            ignored: Boolean(ignoredBy),
+            ignoredBy,
+            hardIgnored: isHardIgnoredPath(normalized)
+        }
+    ];
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+        const childPath = `${normalized}/${entry.name}`;
+        if (studioExplorerDirectoryIsAlwaysHidden(childPath)) {
+            continue;
+        }
+        const childIgnoredBy = studioIgnoredBy(childPath, matcher);
+        if (entry.isDirectory()) {
+            directories.push({
+                path: childPath,
+                name: entry.name,
+                directory: normalized,
+                deferred: true,
+                ignored: Boolean(childIgnoredBy),
+                ignoredBy: childIgnoredBy,
+                hardIgnored: isHardIgnoredPath(childPath)
+            });
+            continue;
+        }
+        if (!entry.isFile()) {
+            continue;
+        }
+        const fileStats = await stat(path.join(directoryPath, entry.name));
+        files.push({
+            path: childPath,
+            name: entry.name,
+            directory: normalized,
+            size: fileStats.size,
+            hardIgnored: isHardIgnoredPath(childPath),
+            ignored: Boolean(childIgnoredBy),
+            ignoredBy: childIgnoredBy
+        });
+    }
+    return { files, directories };
+}
+async function listStudioDeferredDirectories(root, matcher) {
+    const entries = await readdir(root, { withFileTypes: true });
+    return entries
+        .filter((entry) => entry.isDirectory() &&
+        studioDeferredDirectoryNames.has(entry.name) &&
+        !studioExplorerDirectoryIsAlwaysHidden(entry.name))
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .map((entry) => {
+        const ignoredBy = isHardIgnoredPath(entry.name)
+            ? "Pressship package rules"
+            : matcher.ignoredBy(entry.name) ?? matcher.ignoredBy(`${entry.name}/.pressship-directory`);
+        return {
+            path: entry.name,
+            name: entry.name,
+            directory: "",
+            deferred: true,
+            ignored: Boolean(ignoredBy),
+            ignoredBy,
+            hardIgnored: isHardIgnoredPath(entry.name)
+        };
+    });
+}
+async function listStudioIgnoredPatternDirectories(root, patterns, matcher) {
+    const candidates = Array.from(new Set(patterns.flatMap(studioIgnoredDirectoryCandidates)));
+    const entries = await Promise.all(candidates.map(async (relativePath) => {
+        if (studioExplorerDirectoryIsAlwaysHidden(relativePath)) {
+            return undefined;
+        }
+        const absolutePath = path.join(root, relativePath);
+        if (!pathExists(absolutePath)) {
+            return undefined;
+        }
+        const entryStats = await stat(absolutePath);
+        if (!entryStats.isDirectory()) {
+            return undefined;
+        }
+        const ignoredBy = matcher.ignoredBy(relativePath) ?? matcher.ignoredBy(`${relativePath}/.pressship-directory`);
+        if (!ignoredBy) {
+            return undefined;
+        }
+        return {
+            path: relativePath,
+            name: path.basename(relativePath),
+            directory: path.dirname(relativePath) === "." ? "" : path.dirname(relativePath),
+            deferred: false,
+            ignored: true,
+            ignoredBy,
+            hardIgnored: isHardIgnoredPath(relativePath)
+        };
+    }));
+    return entries
+        .filter((entry) => Boolean(entry))
+        .sort((a, b) => a.path.localeCompare(b.path));
+}
+function studioIgnoredDirectoryCandidates(pattern) {
+    const trimmed = pattern.trim();
+    if (!trimmed || trimmed.startsWith("!")) {
+        return [];
+    }
+    let candidate = "";
+    if (trimmed.endsWith("/**")) {
+        candidate = trimmed.slice(0, -3);
+    }
+    else if (trimmed.endsWith("/")) {
+        candidate = trimmed.slice(0, -1);
+    }
+    else if (!hasStudioGlobMagic(trimmed)) {
+        candidate = trimmed;
+    }
+    candidate = candidate.replace(/^\.\/+/, "").replace(/\/+$/, "");
+    if (!candidate || candidate === "." || hasStudioGlobMagic(candidate)) {
+        return [];
+    }
+    return [candidate];
+}
+function hasStudioGlobMagic(value) {
+    return /[*?[\]{}]/.test(value);
+}
+function studioIgnoredBy(relativePath, matcher) {
+    return isHardIgnoredPath(relativePath)
+        ? "Pressship package rules"
+        : matcher.ignoredBy(relativePath);
+}
+function studioExplorerDirectoryIsAlwaysHidden(relativePath) {
+    return relativePath
+        .split("/")
+        .filter(Boolean)
+        .some((segment) => studioAlwaysHiddenDirectoryNames.has(segment));
+}
+function mergeStudioDirectoryEntries(entries) {
+    const merged = new Map();
+    for (const entry of entries) {
+        const existing = merged.get(entry.path);
+        if (!existing) {
+            merged.set(entry.path, entry);
+            continue;
+        }
+        merged.set(entry.path, {
+            ...existing,
+            ...entry,
+            deferred: Boolean(existing.deferred || entry.deferred),
+            ignored: Boolean(existing.ignored || entry.ignored),
+            ignoredBy: existing.hardIgnored ? existing.ignoredBy : entry.ignoredBy ?? existing.ignoredBy,
+            hardIgnored: Boolean(existing.hardIgnored || entry.hardIgnored)
+        });
+    }
+    return Array.from(merged.values()).sort((a, b) => a.path.localeCompare(b.path));
+}
+async function readStudioIgnoreState(pluginPath) {
+    const root = path.resolve(pluginPath);
+    const patterns = await readPressshipIgnorePatterns(root);
+    const ignoredFiles = await listStudioIgnoredFiles(root, patterns);
+    return {
+        ignorePath: path.join(root, pressshipIgnoreFile),
+        patterns,
+        ignoredFiles
+    };
+}
+async function listStudioIgnoredFiles(root, patterns) {
+    if (!patterns.length) {
+        return [];
+    }
+    const matcher = createPressshipIgnoreMatcher(patterns);
+    const files = await fg("**/*", {
         cwd: root,
         onlyFiles: true,
         dot: false,
         unique: true,
-        ignore: [
-            "**/.git/**",
-            "**/.svn/**",
-            "**/node_modules/**",
-            "**/vendor/**",
-            "**/build/**",
-            "**/dist/**",
-            "**/playground/**",
-            "**/.wordpress-playground/**"
-        ]
+        ignore: studioHiddenFilePatterns
     });
-    const entries = await Promise.all(files.sort((a, b) => a.localeCompare(b)).map(async (relativePath) => {
+    const ignored = files
+        .map((relativePath) => ({ relativePath, ignoredBy: matcher.ignoredBy(relativePath) }))
+        .filter((entry) => Boolean(entry.ignoredBy));
+    const entries = await Promise.all(ignored.sort((a, b) => a.relativePath.localeCompare(b.relativePath)).map(async ({ relativePath, ignoredBy }) => {
         const fileStats = await stat(path.join(root, relativePath));
         return {
             path: relativePath,
             name: path.basename(relativePath),
             directory: path.dirname(relativePath) === "." ? "" : path.dirname(relativePath),
-            size: fileStats.size
+            size: fileStats.size,
+            ignoredBy
         };
     }));
-    return { files: entries.filter((entry) => entry.size <= 1_000_000) };
+    return entries;
+}
+function readStudioPackageSize(pluginPath, cache) {
+    const source = resolvePluginProjectPath(pluginPath);
+    const key = source.rootDir;
+    const cached = cache.get(key);
+    if (cached) {
+        return publicStudioPackageSizeEntry(cached);
+    }
+    const entry = {
+        status: "calculating",
+        requestedAt: new Date().toISOString()
+    };
+    cache.set(key, entry);
+    entry.promise = calculateStudioPackageSize(source.rootDir)
+        .then((result) => {
+        entry.status = "ready";
+        entry.result = result;
+        entry.error = undefined;
+        entry.updatedAt = new Date().toISOString();
+    })
+        .catch((error) => {
+        entry.status = "error";
+        entry.error = error instanceof Error ? error.message : String(error);
+        entry.updatedAt = new Date().toISOString();
+    });
+    return publicStudioPackageSizeEntry(entry);
+}
+function invalidateStudioPackageSize(pluginPath, cache) {
+    cache.delete(resolvePluginProjectPath(pluginPath).rootDir);
+}
+async function calculateStudioPackageSize(rootDir) {
+    const project = await discoverPluginProject(rootDir);
+    const ignorePatterns = await readPressshipIgnorePatterns(rootDir);
+    const analysis = await analyzePluginPackage(project, { ignore: ignorePatterns });
+    return {
+        sizeBytes: analysis.sizeBytes,
+        maxSizeBytes: analysis.maxSizeBytes,
+        overLimit: analysis.overLimit,
+        fileCount: analysis.files.length,
+        topLevelFolder: analysis.topLevelFolder,
+        largestFiles: analysis.largestFiles
+    };
+}
+function publicStudioPackageSizeEntry(entry) {
+    if (entry.status === "ready" && entry.result) {
+        return {
+            status: "ready",
+            cached: true,
+            calculatedAt: entry.updatedAt,
+            ...entry.result
+        };
+    }
+    if (entry.status === "error") {
+        return {
+            status: "error",
+            cached: true,
+            error: entry.error ?? "Package size could not be calculated.",
+            calculatedAt: entry.updatedAt
+        };
+    }
+    return {
+        status: "calculating",
+        cached: false,
+        requestedAt: entry.requestedAt
+    };
 }
 async function readStudioFile(pluginPath, relativePath) {
     const filePath = await resolveStudioFilePath(pluginPath, relativePath);
@@ -887,11 +1294,18 @@ async function resolveStudioFilePath(pluginPath, relativePath) {
     if (!fileStats.isFile()) {
         throw new Error("Studio can only open files.");
     }
+    if (fileStats.size > maxStudioEditableFileBytes) {
+        throw new Error(`Studio can list ${normalized}, but files larger than 1 MB are not opened in the editor.`);
+    }
     return filePath;
 }
 function normalizeStudioRelativePath(relativePath) {
     return relativePath.replace(/\\/g, "/").replace(/^\/+/, "").split("/").filter(Boolean).join("/");
 }
+function isStudioEditablePath(relativePath) {
+    const name = path.basename(relativePath).toLowerCase();
+    return studioEditableFileNames.has(name) || studioEditableExtensions.has(path.extname(name));
+}
 async function selectFolder() {
     if (process.platform === "darwin") {
         const result = await execa("osascript", [
@@ -1248,7 +1662,7 @@ async function createStudioAiPreviewWorkspace(pluginPath) {
 async function snapshotStudioFileContents(pluginPath) {
     const root = path.resolve(pluginPath);
     const { files } = await listStudioFiles(root);
-    const entries = await Promise.all(files.map(async (file) => {
+    const entries = await Promise.all(files.filter((file) => file.size <= maxStudioEditableFileBytes && isStudioEditablePath(file.path)).map(async (file) => {
         const filePath = path.join(root, file.path);
         const [fileStats, content] = await Promise.all([stat(filePath), readFile(filePath, "utf8")]);
         return [
@@ -1358,18 +1772,26 @@ function streamJobEvents(response, jobs, id) {
     response.on("close", unsubscribe);
 }
 async function serveStatic(response, staticDir, requestPath, token) {
-    const filePath = path.join(staticDir, requestPath === "/" ? "index.html" : requestPath);
-    if (!filePath.startsWith(staticDir)) {
+    if (requestPath === "/" || isSpaRoutePath(requestPath)) {
+        await serveIndex(response, staticDir, token);
+        return;
+    }
+    const rootDir = path.resolve(staticDir);
+    const relativePath = requestPath.replace(/^\/+/, "");
+    const filePath = path.resolve(rootDir, relativePath);
+    if (filePath !== rootDir && !filePath.startsWith(`${rootDir}${path.sep}`)) {
         sendJson(response, 403, { error: { message: "Forbidden." } });
         return;
     }
     if (path.basename(filePath) === "index.html") {
-        const html = (await import("node:fs/promises")).readFile(filePath, "utf8");
-        response.writeHead(200, {
-            "Cache-Control": "no-store",
-            "Content-Type": "text/html; charset=utf-8"
-        });
-        response.end((await html).replace("__PRESSSHIP_TOKEN__", token));
+        await serveIndex(response, rootDir, token);
+        return;
+    }
+    try {
+        await stat(filePath);
+    }
+    catch {
+        sendJson(response, 404, { error: { message: "Not found." } });
         return;
     }
     const type = contentType(filePath);
@@ -1381,6 +1803,19 @@ async function serveStatic(response, staticDir, requestPath, token) {
         .on("error", () => sendJson(response, 404, { error: { message: "Not found." } }))
         .pipe(response);
 }
+function isSpaRoutePath(requestPath) {
+    const firstSegment = requestPath.split("/").filter(Boolean)[0] ?? "";
+    return spaRoutePrefixes.has(firstSegment);
+}
+async function serveIndex(response, staticDir, token) {
+    const filePath = path.join(staticDir, "index.html");
+    const html = await readFile(filePath, "utf8");
+    response.writeHead(200, {
+        "Cache-Control": "no-store",
+        "Content-Type": "text/html; charset=utf-8"
+    });
+    response.end(html.replace("__PRESSSHIP_TOKEN__", token));
+}
 async function readJson(request) {
     const chunks = [];
     for await (const chunk of request) {