@shivaedev/work-board 0.5.0 → 0.6.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +38 -0
- package/README.md +40 -2
- package/dist/board.d.ts.map +1 -1
- package/dist/board.js +2 -0
- package/dist/board.js.map +1 -1
- package/dist/cli.js +1 -1
- package/dist/files/watchDirectories.d.ts.map +1 -1
- package/dist/files/watchDirectories.js +2 -1
- package/dist/files/watchDirectories.js.map +1 -1
- package/dist/http/assets.d.ts.map +1 -1
- package/dist/http/assets.js +4 -0
- package/dist/http/assets.js.map +1 -1
- package/dist/http/attachment.d.ts +4 -0
- package/dist/http/attachment.d.ts.map +1 -0
- package/dist/http/attachment.js +43 -0
- package/dist/http/attachment.js.map +1 -0
- package/dist/metadata/sourceLinks.d.ts.map +1 -1
- package/dist/metadata/sourceLinks.js +3 -1
- package/dist/metadata/sourceLinks.js.map +1 -1
- package/dist/page/client.d.ts +1 -1
- package/dist/page/client.d.ts.map +1 -1
- package/dist/page/client.js +1 -0
- package/dist/page/client.js.map +1 -1
- package/dist/page/diagrams.d.ts +1 -1
- package/dist/page/diagrams.d.ts.map +1 -1
- package/dist/page/diagrams.js +8 -0
- package/dist/page/diagrams.js.map +1 -1
- package/dist/page/shell.d.ts.map +1 -1
- package/dist/page/shell.js +3 -2
- package/dist/page/shell.js.map +1 -1
- package/dist/page/style.d.ts.map +1 -1
- package/dist/page/style.js +3 -2
- package/dist/page/style.js.map +1 -1
- package/dist/page/swap.d.ts +1 -1
- package/dist/page/swap.d.ts.map +1 -1
- package/dist/page/swap.js +7 -2
- package/dist/page/swap.js.map +1 -1
- package/dist/page/visualDialog.d.ts +3 -0
- package/dist/page/visualDialog.d.ts.map +1 -0
- package/dist/page/visualDialog.js +25 -0
- package/dist/page/visualDialog.js.map +1 -0
- package/dist/page/visualScript.d.ts +2 -0
- package/dist/page/visualScript.d.ts.map +1 -0
- package/dist/page/visualScript.js +42 -0
- package/dist/page/visualScript.js.map +1 -0
- package/dist/page/visualViewport.d.ts +2 -0
- package/dist/page/visualViewport.d.ts.map +1 -0
- package/dist/page/visualViewport.js +87 -0
- package/dist/page/visualViewport.js.map +1 -0
- package/dist/path/attachment.d.ts +3 -0
- package/dist/path/attachment.d.ts.map +1 -0
- package/dist/path/attachment.js +22 -0
- package/dist/path/attachment.js.map +1 -0
- package/dist/render/code.d.ts +2 -8
- package/dist/render/code.d.ts.map +1 -1
- package/dist/render/code.js +26 -18
- package/dist/render/code.js.map +1 -1
- package/dist/render/documentHeadings.d.ts +2 -658
- package/dist/render/documentHeadings.d.ts.map +1 -1
- package/dist/render/documentHeadings.js +20 -23
- package/dist/render/documentHeadings.js.map +1 -1
- package/dist/render/documentLinks.d.ts +2 -658
- package/dist/render/documentLinks.d.ts.map +1 -1
- package/dist/render/documentLinks.js +23 -15
- package/dist/render/documentLinks.js.map +1 -1
- package/dist/render/footnotes.d.ts +2 -18
- package/dist/render/footnotes.d.ts.map +1 -1
- package/dist/render/footnotes.js +9 -11
- package/dist/render/footnotes.js.map +1 -1
- package/dist/render/markdown.d.ts.map +1 -1
- package/dist/render/markdown.js +13 -4
- package/dist/render/markdown.js.map +1 -1
- package/dist/render/textContent.d.ts +3 -0
- package/dist/render/textContent.d.ts.map +1 -0
- package/dist/render/textContent.js +7 -0
- package/dist/render/textContent.js.map +1 -0
- package/dist/search/collector.d.ts +2 -8
- package/dist/search/collector.d.ts.map +1 -1
- package/dist/search/collector.js +29 -25
- package/dist/search/collector.js.map +1 -1
- package/dist/search/entries.d.ts.map +1 -1
- package/dist/search/entries.js +7 -3
- package/dist/search/entries.js.map +1 -1
- package/dist/search/linkCollector.d.ts +2 -7
- package/dist/search/linkCollector.d.ts.map +1 -1
- package/dist/search/linkCollector.js +12 -13
- package/dist/search/linkCollector.js.map +1 -1
- package/package.json +10 -1
- package/src/board.ts +2 -0
- package/src/cli.ts +1 -1
- package/src/files/watchDirectories.ts +2 -1
- package/src/http/assets.ts +4 -0
- package/src/http/attachment.ts +46 -0
- package/src/metadata/sourceLinks.ts +3 -1
- package/src/page/client.ts +1 -0
- package/src/page/diagrams.ts +8 -0
- package/src/page/shell.ts +3 -2
- package/src/page/style.ts +4 -2
- package/src/page/swap.ts +7 -2
- package/src/page/visualDialog.ts +25 -0
- package/src/page/visualScript.ts +41 -0
- package/src/page/visualViewport.ts +86 -0
- package/src/path/attachment.ts +23 -0
- package/src/render/code.ts +29 -19
- package/src/render/documentHeadings.ts +21 -23
- package/src/render/documentLinks.ts +24 -15
- package/src/render/footnotes.ts +11 -14
- package/src/render/markdown.ts +17 -4
- package/src/render/textContent.ts +8 -0
- package/src/search/collector.ts +30 -27
- package/src/search/entries.ts +7 -3
- package/src/search/linkCollector.ts +13 -13
package/src/page/shell.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { fileUrl } from "#files/url.ts";
|
|
2
2
|
import { escapeHtml } from "./escape.ts";
|
|
3
3
|
import { searchDialog } from "./searchDialog.ts";
|
|
4
|
+
import { visualDialog } from "./visualDialog.ts";
|
|
4
5
|
|
|
5
6
|
function location(file: string): string {
|
|
6
7
|
return file
|
|
@@ -23,7 +24,7 @@ export const shell = (
|
|
|
23
24
|
'<meta name="viewport" content="width=device-width, initial-scale=1"><meta name="color-scheme" content="light dark">',
|
|
24
25
|
`<title>${escapeHtml(title)}</title>`,
|
|
25
26
|
'<link rel="stylesheet" href="/_board/style.css"><script type="module" src="/_board/client.js"></script>',
|
|
26
|
-
'</head><body><a class="skip" href="#doc">Skip to content</a><div class="workspace">',
|
|
27
|
+
'</head><body><noscript><style>html:not([data-js]) figure.diagram .diagram-source{display:block}html:not([data-js]) figure.diagram[data-state="pending"]{min-height:0}</style></noscript><a class="skip" href="#doc">Skip to content</a><div class="workspace">',
|
|
27
28
|
'<aside id="sidebar" class="sidebar"><a class="brand" href="/">work board<span>Local workspace</span></a>',
|
|
28
29
|
'<div id="reading-library" class="reading-library" hidden></div><h2 class="nav-heading">Project files</h2>',
|
|
29
30
|
`<nav id="files" class="files" aria-label="Project files">${nav}</nav></aside>`,
|
|
@@ -35,5 +36,5 @@ export const shell = (
|
|
|
35
36
|
'<div class="preference"><label for="density">Density</label><select id="density"><option value="comfortable">Comfortable</option><option value="compact">Compact</option></select></div>',
|
|
36
37
|
'<button id="updates-toggle" type="button" aria-pressed="false" disabled>Pause updates</button><span id="preference-status" role="status"></span></div>',
|
|
37
38
|
`<main${view ? ` data-view="${typeof view === "string" ? view : "work"}"` : ""}${identity ? ` data-identity="${escapeHtml(identity)}"` : ""} id="doc" data-file="${escapeHtml(title)}" data-url="${escapeHtml(fileUrl(title))}" class="${board ? "board-view" : "document-view"}" tabindex="-1">${main}</main>`,
|
|
38
|
-
`</div></div>${searchDialog}</body></html>`,
|
|
39
|
+
`</div></div>${searchDialog}${visualDialog}</body></html>`,
|
|
39
40
|
].join("");
|
package/src/page/style.ts
CHANGED
|
@@ -3,6 +3,7 @@ import { workStyle } from "#views/workStyle.ts";
|
|
|
3
3
|
import { metadataStyles } from "./metadata.ts";
|
|
4
4
|
import { readingStyles } from "./readingStyles.ts";
|
|
5
5
|
import { searchStyles } from "./searchDialog.ts";
|
|
6
|
+
import { visualStyles } from "./visualDialog.ts";
|
|
6
7
|
import { layout, theme } from "./workspaceStyles.ts";
|
|
7
8
|
|
|
8
9
|
const prose = `
|
|
@@ -53,8 +54,9 @@ figure.diagram { margin-left: 0; margin-right: 0; }
|
|
|
53
54
|
figure.diagram[data-state="pending"] { min-height: 12rem; background: var(--surface); border-radius: 6px; }
|
|
54
55
|
figure.diagram .diagram-source { display: none; }
|
|
55
56
|
figure.diagram[data-state="failed"] .diagram-source { display: block; }
|
|
56
|
-
|
|
57
|
+
[data-diagram-error] { color: var(--danger); font-size: 0.875em; }
|
|
57
58
|
@media (prefers-reduced-motion: reduce) { * { transition: none !important; animation: none !important; } }
|
|
58
59
|
`;
|
|
59
60
|
|
|
60
|
-
export const style =
|
|
61
|
+
export const style =
|
|
62
|
+
theme + layout + prose + board + diagrams + readingStyles() + searchStyles + metadataStyles + workStyle() + attentionStyle() + visualStyles;
|
package/src/page/swap.ts
CHANGED
|
@@ -12,12 +12,13 @@ const flash = (element) => {
|
|
|
12
12
|
};
|
|
13
13
|
|
|
14
14
|
export const remember = (element) => {
|
|
15
|
-
pristine.set(element, element
|
|
15
|
+
pristine.set(element, normalized(element));
|
|
16
16
|
if (containers.has(element.tagName)) for (const child of element.children) remember(child);
|
|
17
17
|
};
|
|
18
18
|
|
|
19
19
|
const normalized = (element) => {
|
|
20
20
|
const copy = element.cloneNode(true);
|
|
21
|
+
for (const tool of copy.querySelectorAll("[data-visual-tools], [data-image-error], [data-diagram-error]")) tool.remove();
|
|
21
22
|
for (const node of [copy, ...copy.querySelectorAll("*")]) {
|
|
22
23
|
node.removeAttribute("data-live-change");
|
|
23
24
|
if (node.tagName === "DETAILS") node.removeAttribute("open");
|
|
@@ -27,6 +28,10 @@ const normalized = (element) => {
|
|
|
27
28
|
delete node.dataset.error;
|
|
28
29
|
}
|
|
29
30
|
if (node.matches("[data-modified]")) node.textContent = "";
|
|
31
|
+
if (node.matches("img[data-local-image]")) {
|
|
32
|
+
node.setAttribute("src", node.dataset.localImage);
|
|
33
|
+
for (const attribute of ["tabindex", "role", "aria-label"]) node.removeAttribute(attribute);
|
|
34
|
+
}
|
|
30
35
|
}
|
|
31
36
|
return copy.outerHTML;
|
|
32
37
|
};
|
|
@@ -75,7 +80,7 @@ const patch = (current, incoming, highlight) => {
|
|
|
75
80
|
}
|
|
76
81
|
const olds = [...current.children];
|
|
77
82
|
const news = [...incoming.children];
|
|
78
|
-
const signatures = news.map(
|
|
83
|
+
const signatures = news.map(normalized);
|
|
79
84
|
const arrive = (index) => {
|
|
80
85
|
remember(news[index]);
|
|
81
86
|
if (highlight) flash(news[index]);
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
export const visualDialog = `<dialog id="visual-dialog" aria-labelledby="visual-title">
|
|
2
|
+
<div id="visual-stage">
|
|
3
|
+
<div class="visual-bar"><h2 id="visual-title">Visual evidence</h2><button id="visual-close" type="button">Close</button></div>
|
|
4
|
+
<p id="visual-context"></p>
|
|
5
|
+
<div class="visual-bar" role="group" aria-label="Visual controls">
|
|
6
|
+
<button id="visual-previous" type="button">Previous image</button><button id="visual-next" type="button">Next image</button>
|
|
7
|
+
<button id="visual-out" type="button" aria-label="Zoom out">−</button><button id="visual-fit" type="button">Fit</button><button id="visual-actual" type="button" aria-pressed="false">Actual size</button><button id="visual-in" type="button" aria-label="Zoom in">+</button>
|
|
8
|
+
<button id="visual-fullscreen" type="button">Fullscreen</button><a id="visual-download" download>Save locally</a>
|
|
9
|
+
</div><p id="visual-status" role="status"></p><div id="visual-viewport" tabindex="0" aria-label="Scrollable visual"><div id="visual-content"></div></div>
|
|
10
|
+
<p class="visual-help">Arrow keys choose images · Zoom and scroll to inspect · Escape returns to the source. Recorded evidence does not verify acceptance.</p>
|
|
11
|
+
</div></dialog>`;
|
|
12
|
+
|
|
13
|
+
export const visualStyles = `
|
|
14
|
+
#visual-dialog{width:min(1100px,calc(100vw - 24px));max-height:calc(100dvh - 24px);padding:16px;border:1px solid var(--border);border-radius:12px;background:var(--card);color:var(--text)}
|
|
15
|
+
#visual-dialog::backdrop{background:rgb(0 0 0 / .6)}
|
|
16
|
+
.visual-bar{display:flex;align-items:center;gap:8px;flex-wrap:wrap}.visual-bar h2{flex:1;margin:0;font-size:1.2rem}
|
|
17
|
+
.visual-bar button,.visual-bar a{font:inherit;padding:6px 10px;cursor:pointer;background:var(--surface);color:var(--text);border:1px solid var(--border);border-radius:6px}
|
|
18
|
+
#visual-context,.visual-help,#visual-status{font-size:.85rem;overflow-wrap:anywhere;color:var(--muted)}
|
|
19
|
+
#visual-viewport{overflow:auto;max-height:65dvh;min-height:150px;background:var(--surface);border:1px solid var(--border);padding:12px}
|
|
20
|
+
#visual-content{width:100%;min-width:0}#visual-content img,#visual-content svg{display:block;width:100%;max-width:none;height:auto}
|
|
21
|
+
#visual-stage:fullscreen{width:100vw;height:100dvh;box-sizing:border-box;padding:16px;background:var(--card);color:var(--text);overflow:auto}#visual-stage:fullscreen #visual-viewport{max-height:75dvh}
|
|
22
|
+
[data-local-image]{cursor:zoom-in}[data-local-image]:focus-visible{outline:2px solid var(--focus)}
|
|
23
|
+
[data-visual-tools]{display:block;margin:8px 0;font-size:.85rem}[data-visual-tools] button{font:inherit;cursor:pointer;color:var(--text);background:var(--surface);border:1px solid var(--border);border-radius:6px;padding:5px 10px}
|
|
24
|
+
[data-image-error]{display:block;color:var(--danger);font-size:.85rem}
|
|
25
|
+
`;
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
export function visualScript(): string {
|
|
2
|
+
return `
|
|
3
|
+
import { inspectImage, inspectDiagram, inspectAttachment } from "/_board/visual-viewport.js";
|
|
4
|
+
let revision = 0;
|
|
5
|
+
const refresh = () => {
|
|
6
|
+
revision++;
|
|
7
|
+
for (const image of document.querySelectorAll("#doc img[data-local-image]")) {
|
|
8
|
+
image.tabIndex = 0; image.setAttribute("role", "button"); image.setAttribute("aria-label", "Inspect image: " + (image.alt || "Local image"));
|
|
9
|
+
const url = new URL(image.dataset.localImage, location.href); url.searchParams.set("_wb", Date.now() + "-" + revision); image.src = url.href;
|
|
10
|
+
image.onerror = () => {
|
|
11
|
+
if (!image.isConnected || image.nextElementSibling?.hasAttribute("data-image-error")) return;
|
|
12
|
+
const error = document.createElement("span"); error.setAttribute("data-image-error", ""); error.setAttribute("role", "status");
|
|
13
|
+
error.textContent = "Image unavailable. Check the local path, supported type, workspace boundary and 16 MiB limit."; image.after(error);
|
|
14
|
+
};
|
|
15
|
+
image.onload = () => { if (image.nextElementSibling?.hasAttribute("data-image-error")) image.nextElementSibling.remove(); };
|
|
16
|
+
}
|
|
17
|
+
};
|
|
18
|
+
export const diagramTools = (figure) => {
|
|
19
|
+
let tools = figure.querySelector("[data-visual-tools]");
|
|
20
|
+
if (!tools) {
|
|
21
|
+
tools = document.createElement("span"); tools.setAttribute("data-visual-tools", "");
|
|
22
|
+
const button = document.createElement("button"); button.type = "button"; button.textContent = "Inspect diagram"; button.setAttribute("data-inspect-diagram", "");
|
|
23
|
+
tools.append(button); figure.append(tools);
|
|
24
|
+
}
|
|
25
|
+
tools.querySelector("button").disabled = figure.dataset.state !== "drawn";
|
|
26
|
+
};
|
|
27
|
+
document.addEventListener("click", (event) => {
|
|
28
|
+
if (event.defaultPrevented || event.button !== 0 || event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;
|
|
29
|
+
const diagram = event.target.closest?.("#doc [data-inspect-diagram]");
|
|
30
|
+
if (diagram && !diagram.disabled) { inspectDiagram(diagram.closest("figure.diagram"), diagram); return; }
|
|
31
|
+
const link = event.target.closest?.('#doc a[href^="/_board/attachment/"]');
|
|
32
|
+
if (link && !link.hasAttribute("download") && (!link.target || link.target === "_self")) { event.preventDefault(); inspectAttachment(link); return; }
|
|
33
|
+
const image = event.target.closest?.("#doc img[data-local-image]"); if (image) { event.preventDefault(); inspectImage(image); }
|
|
34
|
+
});
|
|
35
|
+
document.addEventListener("keydown", (event) => {
|
|
36
|
+
if (["Enter", " "].includes(event.key) && event.target.matches?.("#doc img[data-local-image]")) { event.preventDefault(); inspectImage(event.target); }
|
|
37
|
+
});
|
|
38
|
+
document.addEventListener("board-page", refresh);
|
|
39
|
+
refresh();
|
|
40
|
+
`;
|
|
41
|
+
}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
export function visualViewport(): string {
|
|
2
|
+
return `
|
|
3
|
+
const dialog = document.getElementById("visual-dialog");
|
|
4
|
+
const content = document.getElementById("visual-content");
|
|
5
|
+
const viewport = document.getElementById("visual-viewport");
|
|
6
|
+
const status = document.getElementById("visual-status");
|
|
7
|
+
const download = document.getElementById("visual-download");
|
|
8
|
+
let scale = 100;
|
|
9
|
+
let baseWidth = 0;
|
|
10
|
+
let objectUrl;
|
|
11
|
+
let origin;
|
|
12
|
+
let images = [];
|
|
13
|
+
let selected = -1;
|
|
14
|
+
const id = (name) => document.getElementById("visual-" + name);
|
|
15
|
+
const release = () => { if (objectUrl) URL.revokeObjectURL(objectUrl); objectUrl = undefined; };
|
|
16
|
+
const zoom = (next) => {
|
|
17
|
+
scale = Math.max(25, Math.min(800, next));
|
|
18
|
+
content.style.width = baseWidth ? (baseWidth * scale / 100) + "px" : scale + "%";
|
|
19
|
+
id("actual").setAttribute("aria-pressed", baseWidth ? "true" : "false");
|
|
20
|
+
id("fit").textContent = scale === 100 && !baseWidth ? "Fit" : Math.round(scale) + "% · Fit";
|
|
21
|
+
};
|
|
22
|
+
const fit = () => { baseWidth = 0; zoom(100); viewport.scrollTop = 0; viewport.scrollLeft = 0; };
|
|
23
|
+
const showImage = () => {
|
|
24
|
+
release(); fit(); status.textContent = "";
|
|
25
|
+
const source = images[selected];
|
|
26
|
+
const image = new Image(); image.alt = source.alt;
|
|
27
|
+
image.onerror = () => { if (content.contains(image)) { status.textContent = "Image unavailable. Check the local path, supported type, workspace boundary and 16 MiB limit."; download.removeAttribute("href"); download.setAttribute("aria-disabled", "true"); } };
|
|
28
|
+
image.src = source.src; content.replaceChildren(image);
|
|
29
|
+
id("context").textContent = (source.alt || "Local image") + " · " + (selected + 1) + " of " + images.length + " · " + source.dataset.localImage + " · " + document.getElementById("doc").dataset.file;
|
|
30
|
+
download.href = source.dataset.localImage;
|
|
31
|
+
try { download.download = decodeURIComponent(new URL(download.href).pathname.split("/").at(-1)); } catch { download.download = "work-board-image"; }
|
|
32
|
+
download.setAttribute("aria-disabled", "false");
|
|
33
|
+
id("previous").disabled = selected <= 0; id("next").disabled = selected >= images.length - 1;
|
|
34
|
+
};
|
|
35
|
+
export const inspectImage = (source) => {
|
|
36
|
+
origin = source; images = [...document.querySelectorAll("#doc img[data-local-image]")]; selected = images.indexOf(source);
|
|
37
|
+
id("previous").hidden = false; id("next").hidden = false; showImage(); dialog.showModal();
|
|
38
|
+
};
|
|
39
|
+
export const inspectAttachment = (link) => {
|
|
40
|
+
origin = link; const source = { alt: link.textContent, dataset: { localImage: link.getAttribute("href") }, src: link.href };
|
|
41
|
+
images = [source]; selected = 0; id("previous").hidden = false; id("next").hidden = false; showImage(); dialog.showModal();
|
|
42
|
+
};
|
|
43
|
+
export const inspectDiagram = (figure, trigger) => {
|
|
44
|
+
const drawing = figure.querySelector(".diagram-svg svg");
|
|
45
|
+
if (!drawing) return;
|
|
46
|
+
origin = trigger; selected = -1; images = []; release(); fit(); status.textContent = "";
|
|
47
|
+
const copy = drawing.cloneNode(true); copy.style.maxWidth = "none"; copy.style.width = "100%"; copy.style.height = "auto";
|
|
48
|
+
content.replaceChildren(copy);
|
|
49
|
+
id("context").textContent = "Mermaid diagram · " + document.getElementById("doc").dataset.file + " · Current drawing";
|
|
50
|
+
id("previous").hidden = true; id("next").hidden = true;
|
|
51
|
+
const xml = new XMLSerializer().serializeToString(drawing);
|
|
52
|
+
objectUrl = URL.createObjectURL(new Blob([xml], { type: "image/svg+xml" }));
|
|
53
|
+
download.href = objectUrl; download.download = "work-board-diagram.svg"; dialog.showModal();
|
|
54
|
+
download.setAttribute("aria-disabled", "false");
|
|
55
|
+
};
|
|
56
|
+
const move = (offset) => { if (selected < 0) return; selected = Math.max(0, Math.min(images.length - 1, selected + offset)); showImage(); };
|
|
57
|
+
id("previous").addEventListener("click", () => move(-1)); id("next").addEventListener("click", () => move(1));
|
|
58
|
+
id("in").addEventListener("click", () => zoom(scale * 1.5)); id("out").addEventListener("click", () => zoom(scale / 1.5));
|
|
59
|
+
id("fit").addEventListener("click", fit);
|
|
60
|
+
id("actual").addEventListener("click", () => {
|
|
61
|
+
const graphic = content.firstElementChild;
|
|
62
|
+
const width = graphic?.naturalWidth || graphic?.viewBox?.baseVal?.width;
|
|
63
|
+
if (!width) { status.textContent = "Original dimensions unavailable; Fit and zoom remain available."; return; }
|
|
64
|
+
baseWidth = width; zoom(100); viewport.scrollTop = 0; viewport.scrollLeft = 0;
|
|
65
|
+
});
|
|
66
|
+
id("close").addEventListener("click", () => dialog.close());
|
|
67
|
+
id("fullscreen").addEventListener("click", async () => {
|
|
68
|
+
try { if (document.fullscreenElement) await document.exitFullscreen(); else await id("stage").requestFullscreen(); }
|
|
69
|
+
catch { status.textContent = "Fullscreen is unavailable here; the scrollable viewer remains available."; }
|
|
70
|
+
});
|
|
71
|
+
dialog.addEventListener("keydown", (event) => {
|
|
72
|
+
if (event.key === "ArrowLeft" && selected >= 0) { event.preventDefault(); move(-1); }
|
|
73
|
+
if (event.key === "ArrowRight" && selected >= 0) { event.preventDefault(); move(1); }
|
|
74
|
+
if (event.key === "Escape") { event.preventDefault(); dialog.close(); }
|
|
75
|
+
});
|
|
76
|
+
dialog.addEventListener("close", async () => {
|
|
77
|
+
release(); content.replaceChildren();
|
|
78
|
+
if (dialog.contains(document.fullscreenElement)) await document.exitFullscreen().catch(() => {});
|
|
79
|
+
(origin?.isConnected ? origin : document.getElementById("doc")).focus();
|
|
80
|
+
});
|
|
81
|
+
document.addEventListener("board-page", () => {
|
|
82
|
+
if (dialog.open) { status.textContent = "Source updated. This preview is the drawing/image opened earlier; close and reopen to inspect or save the latest source."; download.removeAttribute("href"); download.setAttribute("aria-disabled", "true"); }
|
|
83
|
+
});
|
|
84
|
+
window.addEventListener("pagehide", () => { release(); if (dialog.open) dialog.close(); });
|
|
85
|
+
`;
|
|
86
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
const TYPES: Readonly<Record<string, string>> = {
|
|
2
|
+
gif: "image/gif",
|
|
3
|
+
jpeg: "image/jpeg",
|
|
4
|
+
jpg: "image/jpeg",
|
|
5
|
+
png: "image/png",
|
|
6
|
+
webp: "image/webp",
|
|
7
|
+
};
|
|
8
|
+
|
|
9
|
+
export function attachmentType(file: string): string | undefined {
|
|
10
|
+
const extension = file.split(".").at(-1)?.toLowerCase() ?? "";
|
|
11
|
+
return Object.hasOwn(TYPES, extension) ? TYPES[extension] : undefined;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export function attachmentHref(href: string): string | undefined {
|
|
15
|
+
if (!href.startsWith("/") || href.startsWith("//")) {
|
|
16
|
+
return undefined;
|
|
17
|
+
}
|
|
18
|
+
const url = new URL(href, "http://work-board.local");
|
|
19
|
+
if (url.pathname.startsWith("/_board/attachment/")) {
|
|
20
|
+
return href;
|
|
21
|
+
}
|
|
22
|
+
return attachmentType(url.pathname) ? `/_board/attachment${url.pathname}${url.search}${url.hash}` : undefined;
|
|
23
|
+
}
|
package/src/render/code.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import type { Element, ElementContent } from "hast";
|
|
2
|
-
import { defineHastPlugin } from "satteri";
|
|
1
|
+
import type { Element, ElementContent, Root } from "hast";
|
|
3
2
|
import { type BundledLanguage, bundledLanguages, type Highlighter as Shiki } from "shiki";
|
|
3
|
+
import { visit as visitElements } from "unist-util-visit";
|
|
4
4
|
import { THEMES } from "./highlighter.ts";
|
|
5
5
|
|
|
6
6
|
const languageOf = (code: Element): string | undefined => {
|
|
@@ -33,22 +33,32 @@ const highlighted = async (highlighter: Shiki, source: string, language: string)
|
|
|
33
33
|
return highlighter.codeToHast(source, { defaultColor: false, lang: language, themes: THEMES }).children.at(0);
|
|
34
34
|
};
|
|
35
35
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
36
|
+
async function renderedCode(highlighter: Shiki, pre: Element) {
|
|
37
|
+
const [code] = pre.children;
|
|
38
|
+
if (code?.type !== "element" || code.tagName !== "code") {
|
|
39
|
+
return undefined;
|
|
40
|
+
}
|
|
41
|
+
const language = languageOf(code);
|
|
42
|
+
const source = textOf(code);
|
|
43
|
+
if (language === "mermaid") {
|
|
44
|
+
return diagram(source);
|
|
45
|
+
}
|
|
46
|
+
return language === undefined ? undefined : await highlighted(highlighter, source, language);
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
export const codeBlocks = (highlighter: Shiki) => () => async (tree: Root) => {
|
|
50
|
+
const work: Promise<void>[] = [];
|
|
51
|
+
visitElements(tree, "element", (pre, index, parent) => {
|
|
52
|
+
if (pre.tagName !== "pre" || index === undefined || parent === undefined) {
|
|
53
|
+
return;
|
|
54
|
+
}
|
|
55
|
+
work.push(
|
|
56
|
+
renderedCode(highlighter, pre).then((result) => {
|
|
57
|
+
if (result?.type === "element") {
|
|
58
|
+
parent.children[index] = result;
|
|
49
59
|
}
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
},
|
|
53
|
-
name: "work-board-code",
|
|
60
|
+
}),
|
|
61
|
+
);
|
|
54
62
|
});
|
|
63
|
+
await Promise.all(work);
|
|
64
|
+
};
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import type { Root } from "hast";
|
|
2
|
+
import { visit as visitElements } from "unist-util-visit";
|
|
3
|
+
import { textContent } from "#render/textContent.ts";
|
|
2
4
|
|
|
3
5
|
export interface Heading {
|
|
4
6
|
readonly depth: number;
|
|
@@ -9,14 +11,16 @@ export interface Heading {
|
|
|
9
11
|
export function documentHeadings() {
|
|
10
12
|
const entries: Heading[] = [];
|
|
11
13
|
const used = new Set<string>();
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
14
|
+
function plugin() {
|
|
15
|
+
return function transform(tree: Root) {
|
|
16
|
+
visitElements(tree, "element", (element) => {
|
|
17
|
+
if (!["h1", "h2", "h3", "h4", "h5", "h6"].includes(element.tagName)) {
|
|
18
|
+
return;
|
|
19
|
+
}
|
|
16
20
|
if (element.properties.id !== undefined) {
|
|
17
21
|
return;
|
|
18
22
|
}
|
|
19
|
-
const title =
|
|
23
|
+
const title = element.children.map(textContent).join("").trim();
|
|
20
24
|
const slug =
|
|
21
25
|
title
|
|
22
26
|
.normalize("NFKC")
|
|
@@ -31,22 +35,16 @@ export function documentHeadings() {
|
|
|
31
35
|
}
|
|
32
36
|
used.add(id);
|
|
33
37
|
entries.push({ depth: Number(element.tagName.slice(1)), id, title });
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
properties: { ...element.properties, id, tabIndex: -1 },
|
|
46
|
-
};
|
|
47
|
-
},
|
|
48
|
-
},
|
|
49
|
-
name: "work-board-headings",
|
|
50
|
-
});
|
|
38
|
+
element.children.push({
|
|
39
|
+
children: [],
|
|
40
|
+
properties: { ariaLabel: `Link to ${title || "section"}`, className: ["heading-anchor"], href: `#${id}` },
|
|
41
|
+
tagName: "a",
|
|
42
|
+
type: "element",
|
|
43
|
+
});
|
|
44
|
+
element.properties.id = id;
|
|
45
|
+
element.properties.tabIndex = -1;
|
|
46
|
+
});
|
|
47
|
+
};
|
|
48
|
+
}
|
|
51
49
|
return { entries, plugin };
|
|
52
50
|
}
|
|
@@ -1,19 +1,28 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import type { Element, Root } from "hast";
|
|
2
|
+
import { visit as visitElements } from "unist-util-visit";
|
|
2
3
|
import { fileUrl } from "#files/url.ts";
|
|
4
|
+
import { attachmentHref } from "#path/attachment.ts";
|
|
3
5
|
|
|
4
6
|
export function documentLinks(file: string) {
|
|
5
|
-
|
|
6
|
-
element:
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
}
|
|
7
|
+
function resolve(element: Element) {
|
|
8
|
+
const attribute = element.tagName === "img" ? "src" : "href";
|
|
9
|
+
const href = element.properties[attribute];
|
|
10
|
+
if (typeof href !== "string" || href.startsWith("#") || href.startsWith("//") || /^[a-z][a-z\d+.-]*:/iu.exec(href) !== null) {
|
|
11
|
+
return;
|
|
12
|
+
}
|
|
13
|
+
const target = new URL(href, `http://work-board.local${fileUrl(file)}`);
|
|
14
|
+
const resolved = target.pathname + target.search + target.hash;
|
|
15
|
+
const image = attachmentHref(resolved);
|
|
16
|
+
element.properties[attribute] = image ?? resolved;
|
|
17
|
+
if (element.tagName === "img" && image) {
|
|
18
|
+
element.properties.dataLocalImage = image;
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
return () => (tree: Root) => {
|
|
22
|
+
visitElements(tree, "element", (element) => {
|
|
23
|
+
if (element.tagName === "a" || element.tagName === "img") {
|
|
24
|
+
resolve(element);
|
|
25
|
+
}
|
|
26
|
+
});
|
|
27
|
+
};
|
|
19
28
|
}
|
package/src/render/footnotes.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import type { Element } from "hast";
|
|
2
|
-
import {
|
|
1
|
+
import type { Element, Root } from "hast";
|
|
2
|
+
import { visit as visitElements } from "unist-util-visit";
|
|
3
3
|
|
|
4
4
|
const FOOTNOTE_IDS = /^(?:user-content-fn|footnote-label)/u;
|
|
5
5
|
|
|
@@ -17,16 +17,13 @@ const scoped = (prefix: string, value: Value): Value => {
|
|
|
17
17
|
return Array.isArray(value) ? value.map((each) => (typeof each === "string" ? String(scoped(prefix, each)) : each)) : value;
|
|
18
18
|
};
|
|
19
19
|
|
|
20
|
-
export const footnoteIds = (prefix: string) =>
|
|
21
|
-
|
|
22
|
-
element
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
),
|
|
29
|
-
}),
|
|
30
|
-
},
|
|
31
|
-
name: "work-board-footnote-ids",
|
|
20
|
+
export const footnoteIds = (prefix: string) => () => (tree: Root) => {
|
|
21
|
+
visitElements(tree, "element", (element) => {
|
|
22
|
+
if (!["a", "h2", "li"].includes(element.tagName)) {
|
|
23
|
+
return;
|
|
24
|
+
}
|
|
25
|
+
element.properties = Object.fromEntries(
|
|
26
|
+
Object.entries(element.properties).map(([name, value]) => [name, SCOPED.has(name) ? scoped(prefix, value) : value]),
|
|
27
|
+
);
|
|
32
28
|
});
|
|
29
|
+
};
|
package/src/render/markdown.ts
CHANGED
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
import { Effect } from "effect";
|
|
2
|
-
import {
|
|
2
|
+
import { createElement } from "react";
|
|
3
|
+
import { renderToStaticMarkup } from "react-dom/server";
|
|
4
|
+
import { MarkdownAsync } from "react-markdown";
|
|
5
|
+
import rehypeRaw from "rehype-raw";
|
|
6
|
+
import remarkGfm from "remark-gfm";
|
|
7
|
+
import type { PluggableList } from "unified";
|
|
3
8
|
import { codeBlocks } from "./code.ts";
|
|
4
9
|
import type { documentHeadings } from "./documentHeadings.ts";
|
|
5
10
|
import { documentLinks } from "./documentLinks.ts";
|
|
@@ -15,7 +20,7 @@ export interface RenderOptions {
|
|
|
15
20
|
|
|
16
21
|
export const renderMarkdown = Effect.fn("WorkBoard.renderMarkdown")(function* (source: string, options: RenderOptions = {}) {
|
|
17
22
|
const highlighter = yield* Highlighter;
|
|
18
|
-
const plugins:
|
|
23
|
+
const plugins: PluggableList = [rehypeRaw, codeBlocks(highlighter)];
|
|
19
24
|
if (options.idPrefix !== undefined) {
|
|
20
25
|
plugins.push(footnoteIds(options.idPrefix));
|
|
21
26
|
}
|
|
@@ -25,9 +30,17 @@ export const renderMarkdown = Effect.fn("WorkBoard.renderMarkdown")(function* (s
|
|
|
25
30
|
if (options.headings !== undefined) {
|
|
26
31
|
plugins.push(options.headings.plugin);
|
|
27
32
|
}
|
|
28
|
-
const
|
|
33
|
+
const html = yield* Effect.tryPromise({
|
|
29
34
|
catch: (cause) => new RenderFailed({ cause }),
|
|
30
|
-
try: async () =>
|
|
35
|
+
try: async () =>
|
|
36
|
+
renderToStaticMarkup(
|
|
37
|
+
await MarkdownAsync({
|
|
38
|
+
children: source,
|
|
39
|
+
components: { img: ({ node: _node, ...props }) => createElement("img", { ...props, loading: "lazy" }) },
|
|
40
|
+
rehypePlugins: plugins,
|
|
41
|
+
remarkPlugins: [remarkGfm],
|
|
42
|
+
}),
|
|
43
|
+
),
|
|
31
44
|
});
|
|
32
45
|
return html;
|
|
33
46
|
});
|
package/src/search/collector.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
|
-
import type { Element } from "hast";
|
|
2
|
-
import {
|
|
1
|
+
import type { Element, Root } from "hast";
|
|
2
|
+
import { visit as visitElements } from "unist-util-visit";
|
|
3
3
|
import { fileUrl } from "#files/url.ts";
|
|
4
|
+
import { textContent } from "#render/textContent.ts";
|
|
4
5
|
import type { Entry } from "./entries.ts";
|
|
5
6
|
|
|
6
7
|
function sourceLine(element: Element, first: number | undefined, length: number): { readonly line?: number } {
|
|
@@ -14,31 +15,33 @@ export function searchCollector(file: string, startLine: () => number | undefine
|
|
|
14
15
|
const entries: Entry[] = [];
|
|
15
16
|
let passage = "";
|
|
16
17
|
let label = file;
|
|
17
|
-
|
|
18
|
-
element
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
18
|
+
function collect(element: Element) {
|
|
19
|
+
const text = element.children.map(textContent).join("").replace(/\s+/gu, " ").trim();
|
|
20
|
+
if (!text || element.properties.id === "footnote-label") {
|
|
21
|
+
return;
|
|
22
|
+
}
|
|
23
|
+
const heading = element.tagName.startsWith("h") && element.tagName !== "th";
|
|
24
|
+
if (heading && typeof element.properties.id === "string") {
|
|
25
|
+
passage = element.properties.id;
|
|
26
|
+
label = text;
|
|
27
|
+
}
|
|
28
|
+
entries.push({
|
|
29
|
+
file,
|
|
30
|
+
href: fileUrl(file) + (passage ? `#${encodeURIComponent(passage)}` : ""),
|
|
31
|
+
kind: heading ? "heading" : "passage",
|
|
32
|
+
...sourceLine(element, startLine(), length()),
|
|
33
|
+
text,
|
|
34
|
+
title: label,
|
|
35
|
+
});
|
|
36
|
+
}
|
|
37
|
+
function plugin() {
|
|
38
|
+
return function transform(tree: Root) {
|
|
39
|
+
visitElements(tree, "element", (element) => {
|
|
40
|
+
if (["h1", "h2", "h3", "h4", "h5", "h6", "p", "pre", "li", "td", "th"].includes(element.tagName)) {
|
|
41
|
+
collect(element);
|
|
29
42
|
}
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
kind: heading ? "heading" : "passage",
|
|
34
|
-
...sourceLine(element, startLine(), length()),
|
|
35
|
-
text,
|
|
36
|
-
title: label,
|
|
37
|
-
});
|
|
38
|
-
},
|
|
39
|
-
},
|
|
40
|
-
name: "work-board-search-text",
|
|
41
|
-
});
|
|
42
|
-
|
|
43
|
+
});
|
|
44
|
+
};
|
|
45
|
+
}
|
|
43
46
|
return { entries, plugin };
|
|
44
47
|
}
|
package/src/search/entries.ts
CHANGED
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { MarkdownAsync } from "react-markdown";
|
|
2
|
+
import rehypeRaw from "rehype-raw";
|
|
3
|
+
import remarkGfm from "remark-gfm";
|
|
2
4
|
import { fileUrl } from "#files/url.ts";
|
|
3
5
|
import { boardOf } from "#render/board.ts";
|
|
4
6
|
import { documentHeadings } from "#render/documentHeadings.ts";
|
|
@@ -41,8 +43,10 @@ export async function entriesOf(source: string, file: string, home: boolean, bod
|
|
|
41
43
|
if (fragment) {
|
|
42
44
|
fragmentLength = fragment.split("\n").length;
|
|
43
45
|
fragmentLine = board ? fragmentLocation(source, fragment, bodyLine, seenFragments) : bodyLine;
|
|
44
|
-
await
|
|
45
|
-
|
|
46
|
+
await MarkdownAsync({
|
|
47
|
+
children: board?.definitions ? `${fragment}\n\n${board.definitions}` : fragment,
|
|
48
|
+
rehypePlugins: [rehypeRaw, headings.plugin, plugin, linkCollector(links)],
|
|
49
|
+
remarkPlugins: [remarkGfm],
|
|
46
50
|
});
|
|
47
51
|
}
|
|
48
52
|
}
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import type { Root } from "hast";
|
|
2
|
+
import { visit as visitElements } from "unist-util-visit";
|
|
2
3
|
|
|
3
4
|
export function linkCollector(links: Set<string>) {
|
|
4
|
-
return
|
|
5
|
-
element
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
}
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
});
|
|
5
|
+
return () => (tree: Root) => {
|
|
6
|
+
visitElements(tree, "element", (element) => {
|
|
7
|
+
if (element.tagName !== "a") {
|
|
8
|
+
return;
|
|
9
|
+
}
|
|
10
|
+
const href = element.properties.href;
|
|
11
|
+
if (typeof href === "string" && !href.startsWith("#")) {
|
|
12
|
+
links.add(href);
|
|
13
|
+
}
|
|
14
|
+
});
|
|
15
|
+
};
|
|
16
16
|
}
|