mirror of
https://github.com/jparkerweb/plan2code.git
synced 2026-11-18 21:01:19 -08:00
Add a Prototypes tab: list a spec's saved prototypes, read an md in place, open an html in a browser
AI Assisted
This commit is contained in:
1 parent
b38f2b987b
commit
ba19f79f1c
16 files changed
+511
-28
No files matched your search
@@ -56,6 +56,7 @@ import {
|
||||
activity, agentAdrift, agentWorking, askBusy, loopDriving, loopWaiting, loopWaitingKey, asked, awaitingReply, byId, dashboardLive, docs, doingNow,
|
||||
AGENTS_VIEW, agentsTabShown, finish, gitAwaiting, isDashboard, isGitBoard, isOpen, isSpecFileView, items, loadAgentsDoc, loadOverview, loadSpecCarry, myTurn, openItems,
|
||||
finishKey, overviewSpec, patience, pressStranded, reviewPending, scan, selSpec, sendCollected, specFileTabs, stagedCount, stranded,
|
||||
PROTOTYPES_VIEW, prototypesTabShown, loadPrototypes,
|
||||
topics, workingMs, WORKING_GRACE_MS,
|
||||
workspaceFolders,
|
||||
} from "../selectors.js";
|
||||
@@ -68,7 +69,7 @@ import { closeMentions } from "../mention-box.js";
|
||||
import { destroyFields } from "../md-field.js";
|
||||
import { buildPager, fitGrowBox, markFor, markMore, renderCard, renderEndItem, renderNotice } from "./cards.js";
|
||||
import { sendState, suggestState } from "../send-state.js";
|
||||
import { renderAgentsDoc, renderBriefButton, renderDoc, renderOverview } from "./docs.js";
|
||||
import { renderAgentsDoc, renderBriefButton, renderDoc, renderOverview, renderPrototypes } from "./docs.js";
|
||||
import { board, renderGitBoard, resetBoard } from "./git-host.js";
|
||||
import { renderWorkspace, tellFolderIssues } from "./workspace.js";
|
||||
import { openHelpOn } from "./help-dialog.js";
|
||||
@@ -550,6 +551,7 @@ export function adopt(body) {
|
||||
// A spec file tab's file changes under a build, so a tab you are watching
|
||||
// refetches on every new frame too, not only on the click that opened it.
|
||||
if (firstLoad || page.S.specDir !== prevSpecDir || page.S.workflow !== prevWorkflow || isSpecFileView(page.view)) loadOverview();
|
||||
else if (page.view === PROTOTYPES_VIEW) loadPrototypes();
|
||||
// A New Session in the app leaves the spec it was in; the fresh dashboard picks it up once its scan is here.
|
||||
loadSpecCarry();
|
||||
// The Dashboard's AGENTS.md tab: found on arrival, re-read while it is open.
|
||||
@@ -1030,7 +1032,7 @@ function withFocus(fn) {
|
||||
// (the dashboard menu, the end page).
|
||||
function currentScroller() {
|
||||
if (!drawnView) return null;
|
||||
if (drawnView.startsWith("doc:") || isSpecFileView(drawnView) || drawnView === AGENTS_VIEW) return $("main");
|
||||
if (drawnView.startsWith("doc:") || isSpecFileView(drawnView) || drawnView === AGENTS_VIEW || drawnView === PROTOTYPES_VIEW) return $("main");
|
||||
if (drawnView === "questions") return $("main").querySelector(":scope > .card.question");
|
||||
if (drawnView === "ask") return $("main").querySelector(".ask-list");
|
||||
return null;
|
||||
@@ -1481,6 +1483,10 @@ function renderViews() {
|
||||
const fileTabs = specFileTabs();
|
||||
for (const f of fileTabs) tabs.push({ id: f.id, label: f.label, count: 0 });
|
||||
if (isSpecFileView(page.view) && !fileTabs.some((f) => f.id === page.view)) page.view = "questions";
|
||||
// After the spec file tabs: the spec's saved prototypes, present while its
|
||||
// prototypes/ folder holds an .md or .html. Gone, it sends the person home.
|
||||
if (prototypesTabShown()) tabs.push({ id: PROTOTYPES_VIEW, label: "Prototypes", count: 0 });
|
||||
else if (page.view === PROTOTYPES_VIEW) page.view = "questions";
|
||||
// Right after Dashboard: the project's AGENTS.md, present while the file is.
|
||||
// Like a spec file tab, it sends the person home if the file goes away.
|
||||
if (agentsTabShown()) tabs.splice(1, 0, { id: AGENTS_VIEW, label: "AGENTS.md", count: 0 });
|
||||
@@ -1533,10 +1539,14 @@ function renderViews() {
|
||||
save();
|
||||
}
|
||||
page.view = t.id === "questions" && finish() ? "end" : t.id;
|
||||
// The tab always opens on the list, so the .md last read there must not
|
||||
// paint first.
|
||||
if (t.id === PROTOTYPES_VIEW) page.prototypes = { ...page.prototypes, open: null, texts: {} };
|
||||
// The cached text paints at once; the fresh read repaints if the file
|
||||
// changed on disk since.
|
||||
render();
|
||||
if (isSpecFileView(t.id)) loadOverview();
|
||||
if (t.id === PROTOTYPES_VIEW) loadPrototypes();
|
||||
if (t.id === AGENTS_VIEW) {
|
||||
page.agentsDoc.open = "AGENTS.md";
|
||||
loadAgentsDoc();
|
||||
@@ -1696,7 +1706,10 @@ function renderMain() {
|
||||
}
|
||||
|
||||
function paintMain(main) {
|
||||
main.classList.toggle("is-doc", page.view.startsWith("doc:") || isSpecFileView(page.view) || page.view === AGENTS_VIEW);
|
||||
main.classList.toggle(
|
||||
"is-doc",
|
||||
page.view.startsWith("doc:") || isSpecFileView(page.view) || page.view === AGENTS_VIEW || page.view === PROTOTYPES_VIEW
|
||||
);
|
||||
main.classList.toggle("is-ask", page.view === "ask");
|
||||
|
||||
// An agent-less session has no questions, docs or board to draw: its whole
|
||||
@@ -1706,6 +1719,7 @@ function paintMain(main) {
|
||||
if (page.view.startsWith("doc:")) return renderDoc(main, page.view.slice(4));
|
||||
if (isSpecFileView(page.view)) return renderOverview(main, page.view);
|
||||
if (page.view === AGENTS_VIEW) return renderAgentsDoc(main);
|
||||
if (page.view === PROTOTYPES_VIEW) return renderPrototypes(main);
|
||||
if (page.view === "ask") {
|
||||
const held = heldAsk;
|
||||
heldAsk = null;
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
// Plan2Code Web Console - documents: tabs, blocks, print and download, and the brief button; defines only.
|
||||
|
||||
import { docs, agentWorking, workingMs, patience, WORKING_GRACE_MS, finish, SPEC_FILES, loadAgentsDoc } from "../selectors.js";
|
||||
import {
|
||||
docs, agentWorking, workingMs, patience, WORKING_GRACE_MS, finish, SPEC_FILES, loadAgentsDoc, openPrototypeDoc, closePrototypeDoc,
|
||||
} from "../selectors.js";
|
||||
import { el, md } from "../render.js";
|
||||
import { downloadDocHtml, docSavedNote, downloadDoc, blockBody } from "../doc-files.js";
|
||||
import { hooks, page, redraw } from "../state.js";
|
||||
@@ -297,6 +299,70 @@ export function renderAgentsDoc(main) {
|
||||
main.appendChild(box);
|
||||
}
|
||||
|
||||
// A saved prototype page, handed to the server to open in the person's
|
||||
// default browser (the app's webview opens no windows, and a page served over
|
||||
// http cannot open a file:// link). A failure says so on the banner.
|
||||
async function openPrototypePage(spec, name) {
|
||||
const ok = await fetch("/open-prototype", {
|
||||
method: "POST",
|
||||
headers: { "content-type": "application/json" },
|
||||
body: JSON.stringify({ spec, name }),
|
||||
})
|
||||
.then((res) => res.ok)
|
||||
.catch(() => false);
|
||||
if (!ok) hooks.banner(`${name} could not open in your browser. Open it from ${spec}/prototypes/ yourself.`, "warn");
|
||||
}
|
||||
|
||||
// The Prototypes tab: the .md and .html files in the spec's prototypes/
|
||||
// folder. An .md opens in place, with a way back to the list (like Back to
|
||||
// AGENTS.md); an .html opens in the default browser.
|
||||
export function renderPrototypes(main) {
|
||||
const { key, files, open, texts } = page.prototypes;
|
||||
const reading = open && typeof texts[open] === "string";
|
||||
const head = el("div", "doc-head");
|
||||
head.appendChild(el("h2", null, reading ? open : "Prototypes"));
|
||||
const tools = el("div", "doc-tools");
|
||||
if (reading) {
|
||||
const list = el("button", "btn small", "Back to Prototypes");
|
||||
list.type = "button";
|
||||
list.addEventListener("click", () => {
|
||||
closePrototypeDoc();
|
||||
main.scrollTop = 0;
|
||||
});
|
||||
tools.appendChild(list);
|
||||
}
|
||||
tools.appendChild(backButton());
|
||||
if (reading) tools.appendChild(printButton());
|
||||
head.appendChild(tools);
|
||||
main.appendChild(head);
|
||||
main.appendChild(el("p", "help", `${key}/prototypes/${reading ? open : ""} · read-only, straight from disk`));
|
||||
if (reading) {
|
||||
const box = el("div", "block settled");
|
||||
box.appendChild(md(texts[open], "md"));
|
||||
main.appendChild(box);
|
||||
return;
|
||||
}
|
||||
const list = el("ul", "proto-list");
|
||||
for (const f of files) {
|
||||
const row = el("li", "proto-row");
|
||||
const b = el("button", "proto-open", null);
|
||||
b.type = "button";
|
||||
b.appendChild(el("span", "proto-kind proto-kind-" + f.kind, f.kind === "md" ? "MD" : "HTML"));
|
||||
b.appendChild(el("span", "proto-name", f.name));
|
||||
b.appendChild(el("span", "proto-how", f.kind === "md" ? "Read it here" : "Opens in your browser ↗"));
|
||||
b.title = f.kind === "md" ? `Read ${f.name} here` : `Open ${f.name} in your default browser`;
|
||||
b.addEventListener("click", () => {
|
||||
if (f.kind === "md") {
|
||||
openPrototypeDoc(f.name);
|
||||
main.scrollTop = 0;
|
||||
} else openPrototypePage(key, f.name);
|
||||
});
|
||||
row.appendChild(b);
|
||||
list.appendChild(row);
|
||||
}
|
||||
main.appendChild(list);
|
||||
}
|
||||
|
||||
// The brief dialog's buttons, wired once at start-up.
|
||||
export function wireDocs() {
|
||||
$("btn-brief").addEventListener("click", openBrief);
|
||||
|
||||
Reference in new issue
Block a user