leglas 0.4.0 → 0.4.1

package/README.md

@@ -286,8 +286,11 @@ trace.
 ## The interface
 
 Directions live in a rail on the left. The stage shows the active one in
-a framed viewport at Full, 1440, 834, or 390 wide. Rename, reorder, hide,
-and tag directions from the rail; layout is saved per project and
+a framed viewport at Full, 1440, 834 or 390 wide. Rename, reorder, hide
+and tag directions from the rail. Open the removed list to restore a
+direction, delete one permanently or clear the full list. Machine-local
+directions are removed from `.leglas/previews.json`; shared project config
+and preview source files stay untouched. Layout is saved per project and
 survives restarts and port changes.
 
 Flipping shows a difference over time. A split shows it at once, which is

package/dist/bin.js

@@ -973,8 +973,17 @@ async function readLocalPreviews(cwd) {
   let raw;
   try {
     raw = await readFile3(path, "utf8");
-  } catch {
-    return { previews: [], errors: [] };
+  } catch (error) {
+    const code = error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : null;
+    if (code === "ENOENT") {
+      return { previews: [], errors: [] };
+    }
+    return {
+      previews: [],
+      errors: [
+        `${LOCAL_PREVIEWS_PATH} could not be read (${code ?? "unknown error"}). Check its permissions and file type; nothing shared is lost.`
+      ]
+    };
   }
   let parsed2;
   try {
@@ -1859,13 +1868,23 @@ async function startServer(options) {
       const notice = configStalenessNotice(cwd, bootConfigSnapshot, snapshotConfig(cwd));
       if (notice !== null)
         errors.push(notice);
-      return void readLocalPreviews(cwd).then(({ previews: local }) => {
-        const known = new Set(boot.map((preview) => preview.title));
+      return void readLocalPreviews(cwd).then(({ previews: local, errors: localErrors }) => {
+        if (localErrors.length > 0) {
+          return sendJson(res, 200, {
+            project,
+            devServer: target,
+            previews: boot,
+            errors
+          });
+        }
+        const localTitles = new Set(local.map((preview) => preview.title));
+        const currentBoot = boot.filter((preview) => preview.local !== true || localTitles.has(preview.title));
+        const known = new Set(currentBoot.map((preview) => preview.title));
         const fresh = local.filter((preview) => !known.has(preview.title) && preview.branch === void 0 && preview.file === void 0);
         sendJson(res, 200, {
           project,
           devServer: target,
-          previews: [...boot, ...fresh],
+          previews: [...currentBoot, ...fresh],
           errors
         });
       }).catch(() => sendJson(res, 200, {
@@ -1875,6 +1894,47 @@ async function startServer(options) {
         errors
       }));
     }
+    if (path === `${LEGLAS_PREFIX}/api/previews/delete` && req.method === "POST") {
+      let body = "";
+      req.on("data", (chunk) => body += chunk);
+      return void req.on("end", async () => {
+        let parsed2;
+        try {
+          parsed2 = JSON.parse(body || "{}");
+        } catch {
+          return sendJson(res, 400, { ok: false, error: "Body must be JSON." });
+        }
+        const titles = parsed2.titles;
+        if (!Array.isArray(titles) || titles.length === 0 || titles.some((title) => typeof title !== "string" || title.trim() === "")) {
+          return sendJson(res, 400, {
+            ok: false,
+            error: "Body needs a non-empty array of direction titles."
+          });
+        }
+        const unique = [...new Set(titles)];
+        try {
+          const local = await readLocalPreviews(cwd);
+          if (local.errors.length > 0) {
+            return sendJson(res, 409, { ok: false, error: local.errors.join(" ") });
+          }
+          const localTitles = new Set(local.previews.map((preview) => preview.title));
+          const unknown = unique.filter((title) => !localTitles.has(title));
+          if (unknown.length > 0) {
+            return sendJson(res, 400, {
+              ok: false,
+              error: "Only machine-local directions can be deleted from the registry."
+            });
+          }
+          const deleted = await dropLocalPreviews(cwd, unique);
+          return sendJson(res, 200, { ok: true, deleted });
+        } catch {
+          return sendJson(res, 500, {
+            ok: false,
+            error: "The directions could not be deleted from Leglas."
+          });
+        }
+      });
+    }
     if (path === `${LEGLAS_PREFIX}/api/request` && req.method === "POST") {
       let body = "";
       req.on("data", (chunk) => body += chunk);
@@ -1885,8 +1945,12 @@ async function startServer(options) {
         } catch {
           return sendJson(res, 400, { ok: false, error: "Body must be JSON." });
         }
-        const local = await readLocalPreviews(cwd).then((read) => read.previews, () => []);
-        const preview = [...config?.previews ?? [], ...local].find((entry) => entry.title === parsed2.title);
+        const localRead = await readLocalPreviews(cwd).catch(() => null);
+        const local = localRead?.errors.length === 0 ? localRead.previews : [];
+        const localTitles = new Set(local.map((entry) => entry.title));
+        const bootConfig = config?.previews ?? [];
+        const boot = localRead === null || localRead.errors.length > 0 ? bootConfig : bootConfig.filter((entry) => entry.local !== true || localTitles.has(entry.title));
+        const preview = [...boot, ...local].find((entry) => entry.title === parsed2.title);
         if (!preview || !parsed2.intent?.trim()) {
           return sendJson(res, 400, { ok: false, error: "Unknown preview, or empty request." });
         }

package/dist/index.js

@@ -1333,8 +1333,17 @@ async function readLocalPreviews(cwd) {
   let raw;
   try {
     raw = await readFile3(path, "utf8");
-  } catch {
-    return { previews: [], errors: [] };
+  } catch (error) {
+    const code = error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : null;
+    if (code === "ENOENT") {
+      return { previews: [], errors: [] };
+    }
+    return {
+      previews: [],
+      errors: [
+        `${LOCAL_PREVIEWS_PATH} could not be read (${code ?? "unknown error"}). Check its permissions and file type; nothing shared is lost.`
+      ]
+    };
   }
   let parsed;
   try {
@@ -2219,13 +2228,23 @@ async function startServer(options) {
       const notice = configStalenessNotice(cwd, bootConfigSnapshot, snapshotConfig(cwd));
       if (notice !== null)
         errors.push(notice);
-      return void readLocalPreviews(cwd).then(({ previews: local }) => {
-        const known = new Set(boot.map((preview) => preview.title));
+      return void readLocalPreviews(cwd).then(({ previews: local, errors: localErrors }) => {
+        if (localErrors.length > 0) {
+          return sendJson(res, 200, {
+            project,
+            devServer: target,
+            previews: boot,
+            errors
+          });
+        }
+        const localTitles = new Set(local.map((preview) => preview.title));
+        const currentBoot = boot.filter((preview) => preview.local !== true || localTitles.has(preview.title));
+        const known = new Set(currentBoot.map((preview) => preview.title));
         const fresh = local.filter((preview) => !known.has(preview.title) && preview.branch === void 0 && preview.file === void 0);
         sendJson(res, 200, {
           project,
           devServer: target,
-          previews: [...boot, ...fresh],
+          previews: [...currentBoot, ...fresh],
           errors
         });
       }).catch(() => sendJson(res, 200, {
@@ -2235,6 +2254,47 @@ async function startServer(options) {
         errors
       }));
     }
+    if (path === `${LEGLAS_PREFIX}/api/previews/delete` && req.method === "POST") {
+      let body = "";
+      req.on("data", (chunk) => body += chunk);
+      return void req.on("end", async () => {
+        let parsed;
+        try {
+          parsed = JSON.parse(body || "{}");
+        } catch {
+          return sendJson(res, 400, { ok: false, error: "Body must be JSON." });
+        }
+        const titles = parsed.titles;
+        if (!Array.isArray(titles) || titles.length === 0 || titles.some((title) => typeof title !== "string" || title.trim() === "")) {
+          return sendJson(res, 400, {
+            ok: false,
+            error: "Body needs a non-empty array of direction titles."
+          });
+        }
+        const unique = [...new Set(titles)];
+        try {
+          const local = await readLocalPreviews(cwd);
+          if (local.errors.length > 0) {
+            return sendJson(res, 409, { ok: false, error: local.errors.join(" ") });
+          }
+          const localTitles = new Set(local.previews.map((preview) => preview.title));
+          const unknown = unique.filter((title) => !localTitles.has(title));
+          if (unknown.length > 0) {
+            return sendJson(res, 400, {
+              ok: false,
+              error: "Only machine-local directions can be deleted from the registry."
+            });
+          }
+          const deleted = await dropLocalPreviews(cwd, unique);
+          return sendJson(res, 200, { ok: true, deleted });
+        } catch {
+          return sendJson(res, 500, {
+            ok: false,
+            error: "The directions could not be deleted from Leglas."
+          });
+        }
+      });
+    }
     if (path === `${LEGLAS_PREFIX}/api/request` && req.method === "POST") {
       let body = "";
       req.on("data", (chunk) => body += chunk);
@@ -2245,8 +2305,12 @@ async function startServer(options) {
         } catch {
           return sendJson(res, 400, { ok: false, error: "Body must be JSON." });
         }
-        const local = await readLocalPreviews(cwd).then((read) => read.previews, () => []);
-        const preview = [...config?.previews ?? [], ...local].find((entry) => entry.title === parsed.title);
+        const localRead = await readLocalPreviews(cwd).catch(() => null);
+        const local = localRead?.errors.length === 0 ? localRead.previews : [];
+        const localTitles = new Set(local.map((entry) => entry.title));
+        const bootConfig = config?.previews ?? [];
+        const boot = localRead === null || localRead.errors.length > 0 ? bootConfig : bootConfig.filter((entry) => entry.local !== true || localTitles.has(entry.title));
+        const preview = [...boot, ...local].find((entry) => entry.title === parsed.title);
         if (!preview || !parsed.intent?.trim()) {
           return sendJson(res, 400, { ok: false, error: "Unknown preview, or empty request." });
         }