pmx-canvas 0.8.2 → 0.9.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/.github/extensions/pmx-canvas/runtime.json +1 -1
- package/.github/extensions/pmx-canvas/tools.json +601 -22
- package/CHANGELOG.md +59 -0
- package/Readme.md +131 -532
- package/dist/canvas/global.css +2724 -476
- package/dist/canvas/index.js +168 -107
- package/dist/canvas/mcp-app.html +2899 -596
- package/dist/json-render/index.js +20 -20
- package/dist/types/client/canvas/BarHint.d.ts +12 -2
- package/dist/types/client/canvas/BoardLinkDialog.d.ts +3 -1
- package/dist/types/client/canvas/BoardPinButton.d.ts +10 -0
- package/dist/types/client/canvas/BoardSwitcher.d.ts +1 -1
- package/dist/types/client/canvas/CanvasViewport.d.ts +1 -1
- package/dist/types/client/canvas/CommandBar.d.ts +3 -4
- package/dist/types/client/canvas/ConnectionBanner.d.ts +2 -1
- package/dist/types/client/canvas/ContextChip.d.ts +3 -0
- package/dist/types/client/canvas/CrossBoardReferences.d.ts +5 -0
- package/dist/types/client/canvas/EdgeLayer.d.ts +14 -3
- package/dist/types/client/canvas/EmptyState.d.ts +4 -4
- package/dist/types/client/canvas/HomeGraphView.d.ts +2 -0
- package/dist/types/client/canvas/HomeMapView.d.ts +1 -0
- package/dist/types/client/canvas/HomeReviewView.d.ts +6 -0
- package/dist/types/client/canvas/HomeView.d.ts +9 -7
- package/dist/types/client/canvas/KnowledgeDialog.d.ts +4 -0
- package/dist/types/client/canvas/LifecycleChrome.d.ts +5 -0
- package/dist/types/client/canvas/LifecycleFields.d.ts +7 -0
- package/dist/types/client/canvas/LifecyclePanel.d.ts +1 -0
- package/dist/types/client/canvas/MemoryInspector.d.ts +7 -0
- package/dist/types/client/canvas/NearPinLayer.d.ts +14 -0
- package/dist/types/client/canvas/NodeContextMark.d.ts +40 -7
- package/dist/types/client/canvas/RelationPresetsDialog.d.ts +4 -0
- package/dist/types/client/canvas/RelationsPanel.d.ts +4 -0
- package/dist/types/client/canvas/SessionPanel.d.ts +2 -0
- package/dist/types/client/canvas/canvas-area.d.ts +1 -1
- package/dist/types/client/canvas/graph-geometry.d.ts +27 -0
- package/dist/types/client/canvas/graph-model.d.ts +37 -0
- package/dist/types/client/canvas/memory-layout.d.ts +23 -0
- package/dist/types/client/canvas/use-chrome-height.d.ts +2 -0
- package/dist/types/client/canvas/use-focus-trap.d.ts +1 -0
- package/dist/types/client/canvas/use-memory-graph.d.ts +8 -0
- package/dist/types/client/canvas/use-pan-zoom.d.ts +4 -1
- package/dist/types/client/icons.d.ts +0 -10
- package/dist/types/client/nodes/AxStepControls.d.ts +1 -1
- package/dist/types/client/nodes/InlineMarkdownEditor.d.ts +4 -4
- package/dist/types/client/nodes/MarkdownNode.d.ts +5 -1
- package/dist/types/client/nodes/McpAppNode.d.ts +4 -4
- package/dist/types/client/nodes/viewer-runtime-state.d.ts +1 -1
- package/dist/types/client/state/boards-store.d.ts +81 -9
- package/dist/types/client/state/canvas-store.d.ts +14 -1
- package/dist/types/client/state/context-chip-store.d.ts +22 -0
- package/dist/types/client/state/context-status-store.d.ts +35 -0
- package/dist/types/client/state/human-store.d.ts +2 -1
- package/dist/types/client/state/intent-bridge.d.ts +11 -8
- package/dist/types/client/state/knowledge-store.d.ts +22 -0
- package/dist/types/client/state/near-pin-store.d.ts +44 -1
- package/dist/types/client/state/presence-store.d.ts +4 -4
- package/dist/types/client/state/presentation.d.ts +28 -0
- package/dist/types/client/state/relation-store.d.ts +10 -0
- package/dist/types/client/state/session-store.d.ts +41 -2
- package/dist/types/client/state/workspace-settings.d.ts +7 -0
- package/dist/types/client/types.d.ts +13 -1
- package/dist/types/client/utils/keyboard.d.ts +2 -0
- package/dist/types/client/utils/time-ago.d.ts +4 -0
- package/dist/types/mcp/context-uri-template.d.ts +3 -1
- package/dist/types/server/agent-presence.d.ts +10 -3
- package/dist/types/server/ax-context.d.ts +1 -1
- package/dist/types/server/canvas-db.d.ts +30 -7
- package/dist/types/server/canvas-operations.d.ts +24 -2
- package/dist/types/server/canvas-provenance.d.ts +22 -2
- package/dist/types/server/canvas-serialization.d.ts +2 -0
- package/dist/types/server/canvas-state.d.ts +93 -15
- package/dist/types/server/canvas-validation.d.ts +1 -1
- package/dist/types/server/context-brief.d.ts +94 -6
- package/dist/types/server/context-reads.d.ts +33 -7
- package/dist/types/server/edit-summary.d.ts +20 -0
- package/dist/types/server/index.d.ts +71 -10
- package/dist/types/server/knowledge-lifecycle.d.ts +221 -0
- package/dist/types/server/lifecycle-status.d.ts +10 -0
- package/dist/types/server/memory-graph.d.ts +9 -0
- package/dist/types/server/mutation-history.d.ts +2 -0
- package/dist/types/server/operations/ops/ax-shared.d.ts +1 -1
- package/dist/types/server/operations/ops/boards.d.ts +2 -1
- package/dist/types/server/operations/ops/lifecycle.d.ts +2 -0
- package/dist/types/server/operations/ops/memory-graph.d.ts +2 -0
- package/dist/types/server/operations/ops/nodes.d.ts +5 -0
- package/dist/types/server/operations/ops/query.d.ts +23 -0
- package/dist/types/server/operations/registry.d.ts +1 -0
- package/dist/types/server/placement.d.ts +7 -0
- package/dist/types/server/scope-fence.d.ts +2 -1
- package/dist/types/server/spatial-analysis.d.ts +6 -3
- package/dist/types/server/tour-control.d.ts +32 -0
- package/dist/types/server/wiki-links.d.ts +14 -0
- package/dist/types/server/workbench-auth.d.ts +2 -0
- package/dist/types/shared/agent-context.d.ts +2 -0
- package/dist/types/shared/agent-presence.d.ts +15 -12
- package/dist/types/shared/auto-arrange.d.ts +1 -0
- package/dist/types/shared/boards.d.ts +4 -4
- package/dist/types/shared/knowledge-lifecycle.d.ts +41 -0
- package/dist/types/shared/knowledge-presets.d.ts +6 -0
- package/dist/types/shared/lifecycle-status.d.ts +24 -0
- package/dist/types/shared/memory-graph.d.ts +53 -0
- package/dist/types/shared/relations.d.ts +68 -0
- package/dist/types/shared/semantic-attention.d.ts +2 -0
- package/dist/types/shared/tour.d.ts +38 -0
- package/dist/types/shared/workspace-settings.d.ts +11 -0
- package/docs/RELEASE.md +21 -3
- package/docs/adr-001-bun-only-runtime.md +7 -1
- package/docs/adr-002-shared-product-separate-runtimes.md +93 -0
- package/docs/api-reference.md +109 -0
- package/docs/ax-host-adapter-contract.md +1 -1
- package/docs/ax-state-contract.md +5 -4
- package/docs/cli.md +153 -15
- package/docs/demos/pmx-canvas-demo.mp4 +0 -0
- package/docs/design/AgentContext.dc.html +3 -3
- package/docs/design/BoardPins.dc.html +37 -22
- package/docs/design/Categories.dc.html +208 -0
- package/docs/design/CategoryEditor.dc.html +33 -0
- package/docs/design/Chrome.dc.html +52 -9
- package/docs/design/ContextChip.dc.html +224 -0
- package/docs/design/ContextChip600.dc.html +136 -0
- package/docs/design/EmptyState.dc.html +45 -0
- package/docs/design/Flows.dc.html +23 -1
- package/docs/design/HeaderMarks.dc.html +183 -0
- package/docs/design/Home.dc.html +19 -1
- package/docs/design/HomeGraph.dc.html +86 -202
- package/docs/design/HomeMap.dc.html +23 -1
- package/docs/design/HomeTeam.dc.html +32 -14
- package/docs/design/Lifecycle.dc.html +22 -0
- package/docs/design/Lifecycle600.dc.html +18 -0
- package/docs/design/LifecycleVariants.dc.html +157 -0
- package/docs/design/LinkAuthorship.dc.html +139 -0
- package/docs/design/LinksChanged.dc.html +203 -0
- package/docs/design/LinksOptions.dc.html +137 -0
- package/docs/design/LinksOptions600.dc.html +134 -0
- package/docs/design/NearPin.dc.html +9 -10
- package/docs/design/Pane600.dc.html +4 -3
- package/docs/design/Relations.dc.html +3 -2
- package/docs/design/Restore.dc.html +152 -0
- package/docs/design/SeeChange.dc.html +267 -0
- package/docs/design/Uses.dc.html +12 -6
- package/docs/design/canvas.json +146 -19
- package/docs/design.md +449 -16
- package/docs/environment.md +0 -1
- package/docs/evals/curation-effect.md +128 -0
- package/docs/http-api.md +459 -37
- package/docs/mcp.md +146 -18
- package/docs/node-types.md +58 -3
- package/docs/plans/design-gaps-2026-10-08.md +53 -0
- package/docs/plans/plan-009-tech-debt-backlog.md +379 -0
- package/docs/plans/plan-016-context-made-visible-wave-1.md +150 -5
- package/docs/plans/plan-017-knowledge-categories-and-lifecycle.md +175 -0
- package/docs/plans/plan-018-connected-memory-wave-2.md +594 -0
- package/docs/plans/plan-019-post-0.9-roadmap.md +198 -0
- package/docs/product-context-vision-2026-09.md +17 -1
- package/docs/product-vision-2026-09.md +1082 -43
- package/docs/product-vision-review-2026-09.md +13 -1
- package/docs/screenshots/workbench-live-dark.png +0 -0
- package/docs/screenshots/workbench-live-light.png +0 -0
- package/docs/sdk.md +62 -2
- package/package.json +1 -1
- package/plugins/pmx-canvas/com.github.copilot/extensions/pmx-canvas/runtime.json +1 -1
- package/plugins/pmx-canvas/plugin.json +1 -1
- package/plugins/pmx-canvas/runtime.json +1 -1
- package/plugins/pmx-canvas/tools.json +601 -22
- package/skills/pmx-canvas/SKILL.md +216 -42
- package/skills/pmx-canvas/evals/evals.json +224 -0
- package/skills/pmx-canvas/references/full-reference.md +120 -21
- package/skills/pmx-canvas/references/github-copilot-app-adapter.md +2 -2
- package/skills/pmx-canvas/references/importing-context.md +132 -0
- package/skills/pmx-canvas/references/installing-pmx-canvas.md +6 -6
- package/skills/pmx-canvas/references/tours-and-recording.md +16 -1
- package/skills/pmx-canvas-testing/SKILL.md +20 -0
- package/src/cli/agent.ts +2 -0
- package/src/cli/commands/ax.ts +12 -0
- package/src/cli/commands/boards.ts +88 -11
- package/src/cli/commands/edges.ts +28 -0
- package/src/cli/commands/groups.ts +7 -0
- package/src/cli/commands/nodes.ts +1 -0
- package/src/cli/commands/query.ts +34 -2
- package/src/cli/commands/record.ts +199 -48
- package/src/cli/index.ts +6 -1
- package/src/client/App.tsx +177 -70
- package/src/client/canvas/AttentionHistory.tsx +0 -2
- package/src/client/canvas/BarHint.tsx +40 -2
- package/src/client/canvas/BoardCopyDialog.tsx +1 -1
- package/src/client/canvas/BoardFolderDialog.tsx +7 -7
- package/src/client/canvas/BoardLinkDialog.tsx +138 -33
- package/src/client/canvas/BoardPinButton.tsx +33 -0
- package/src/client/canvas/BoardSwitcher.tsx +26 -40
- package/src/client/canvas/CanvasNode.tsx +360 -237
- package/src/client/canvas/CanvasViewport.tsx +45 -7
- package/src/client/canvas/CommandBar.tsx +29 -23
- package/src/client/canvas/CommandPalette.tsx +5 -12
- package/src/client/canvas/ConnectionBanner.tsx +3 -3
- package/src/client/canvas/ContextChip.tsx +296 -0
- package/src/client/canvas/ContextMenu.tsx +63 -5
- package/src/client/canvas/CrossBoardReferences.tsx +60 -0
- package/src/client/canvas/EdgeLayer.tsx +339 -76
- package/src/client/canvas/EmptyState.tsx +33 -18
- package/src/client/canvas/ExpandedNodeOverlay.tsx +72 -40
- package/src/client/canvas/ExternalWriters.tsx +57 -42
- package/src/client/canvas/HomeGraphView.tsx +942 -0
- package/src/client/canvas/HomeMapView.tsx +641 -0
- package/src/client/canvas/HomeReviewView.tsx +167 -0
- package/src/client/canvas/HomeView.tsx +687 -160
- package/src/client/canvas/IntentLayer.tsx +19 -12
- package/src/client/canvas/KnowledgeDialog.tsx +488 -0
- package/src/client/canvas/LifecycleChrome.tsx +133 -0
- package/src/client/canvas/LifecycleFields.tsx +91 -0
- package/src/client/canvas/LifecyclePanel.tsx +543 -0
- package/src/client/canvas/MemoryInspector.tsx +104 -0
- package/src/client/canvas/Minimap.tsx +3 -3
- package/src/client/canvas/NearPinLayer.tsx +187 -0
- package/src/client/canvas/NodeContextMark.tsx +175 -97
- package/src/client/canvas/Presentation.tsx +23 -57
- package/src/client/canvas/RelationPresetsDialog.tsx +413 -0
- package/src/client/canvas/RelationsPanel.tsx +82 -0
- package/src/client/canvas/SelectionBar.tsx +3 -6
- package/src/client/canvas/SessionPanel.tsx +90 -50
- package/src/client/canvas/SessionReceipt.tsx +311 -39
- package/src/client/canvas/ShortcutOverlay.tsx +1 -1
- package/src/client/canvas/SnapshotPanel.tsx +27 -36
- package/src/client/canvas/ToolRail.tsx +367 -192
- package/src/client/canvas/TopBar.tsx +354 -124
- package/src/client/canvas/canvas-area.ts +10 -3
- package/src/client/canvas/graph-geometry.ts +195 -0
- package/src/client/canvas/graph-model.ts +254 -0
- package/src/client/canvas/memory-layout.ts +106 -0
- package/src/client/canvas/use-chrome-height.ts +20 -0
- package/src/client/canvas/use-focus-trap.ts +31 -5
- package/src/client/canvas/use-memory-graph.ts +58 -0
- package/src/client/canvas/use-node-drag.ts +2 -1
- package/src/client/canvas/use-pan-zoom.ts +64 -7
- package/src/client/icons.tsx +0 -63
- package/src/client/mcp-app/style.css +0 -6
- package/src/client/nodes/AxStepControls.tsx +74 -50
- package/src/client/nodes/BoardNode.tsx +5 -1
- package/src/client/nodes/ContextNode.tsx +18 -11
- package/src/client/nodes/ExtAppFrame.tsx +6 -3
- package/src/client/nodes/FileNode.tsx +46 -42
- package/src/client/nodes/HtmlNode.tsx +32 -0
- package/src/client/nodes/ImageNode.tsx +1 -1
- package/src/client/nodes/InlineFormatBar.tsx +6 -9
- package/src/client/nodes/InlineMarkdownEditor.tsx +56 -17
- package/src/client/nodes/MarkdownNode.tsx +377 -109
- package/src/client/nodes/McpAppNode.tsx +50 -20
- package/src/client/nodes/MdFormatBar.tsx +21 -18
- package/src/client/nodes/PromptNode.tsx +1 -1
- package/src/client/nodes/ResponseNode.tsx +1 -1
- package/src/client/nodes/viewer-runtime-state.ts +54 -22
- package/src/client/state/attention-bridge.ts +64 -15
- package/src/client/state/boards-store.ts +193 -39
- package/src/client/state/canvas-store.ts +99 -12
- package/src/client/state/context-chip-store.ts +70 -0
- package/src/client/state/context-status-store.ts +53 -0
- package/src/client/state/human-store.ts +13 -7
- package/src/client/state/intent-bridge.ts +51 -30
- package/src/client/state/knowledge-store.ts +43 -0
- package/src/client/state/near-pin-store.ts +115 -6
- package/src/client/state/presence-store.ts +7 -10
- package/src/client/state/presentation.ts +91 -0
- package/src/client/state/relation-store.ts +81 -0
- package/src/client/state/session-store.ts +144 -18
- package/src/client/state/sse-bridge.ts +235 -32
- package/src/client/state/workspace-settings.ts +11 -0
- package/src/client/theme/global.css +2724 -476
- package/src/client/types.ts +12 -0
- package/src/client/utils/keyboard.ts +10 -0
- package/src/client/utils/time-ago.ts +14 -0
- package/src/json-render/renderer/index.tsx +31 -0
- package/src/mcp/canvas-app.ts +12 -2
- package/src/mcp/context-uri-template.ts +7 -4
- package/src/mcp/server.ts +63 -41
- package/src/mcp/workbench-app.ts +39 -6
- package/src/server/agent-presence.ts +128 -28
- package/src/server/ax-context.ts +27 -13
- package/src/server/board-export.ts +12 -1
- package/src/server/canvas-db.ts +331 -42
- package/src/server/canvas-operations.ts +195 -83
- package/src/server/canvas-provenance.ts +53 -22
- package/src/server/canvas-serialization.ts +2 -0
- package/src/server/canvas-state.ts +950 -122
- package/src/server/canvas-validation.ts +9 -2
- package/src/server/context-brief.ts +345 -38
- package/src/server/context-reads.ts +178 -30
- package/src/server/demo-state.json +355 -24
- package/src/server/edit-summary.ts +74 -0
- package/src/server/html-surface.ts +8 -1
- package/src/server/index.ts +181 -11
- package/src/server/knowledge-lifecycle.ts +304 -0
- package/src/server/lifecycle-status.ts +232 -0
- package/src/server/memory-graph.ts +166 -0
- package/src/server/mutation-history.ts +18 -6
- package/src/server/operations/composites.ts +32 -11
- package/src/server/operations/http.ts +7 -2
- package/src/server/operations/index.ts +4 -0
- package/src/server/operations/mcp.ts +26 -1
- package/src/server/operations/ops/ax-presence.ts +1 -1
- package/src/server/operations/ops/ax-read.ts +57 -6
- package/src/server/operations/ops/ax-timeline.ts +28 -2
- package/src/server/operations/ops/backup.ts +5 -3
- package/src/server/operations/ops/batch.ts +35 -4
- package/src/server/operations/ops/boards.ts +188 -47
- package/src/server/operations/ops/canvas-wire.ts +31 -1
- package/src/server/operations/ops/edges.ts +36 -2
- package/src/server/operations/ops/groups.ts +6 -1
- package/src/server/operations/ops/lifecycle.ts +262 -0
- package/src/server/operations/ops/memory-graph.ts +45 -0
- package/src/server/operations/ops/nodes.ts +107 -24
- package/src/server/operations/ops/query.ts +281 -68
- package/src/server/operations/ops/snapshots.ts +73 -1
- package/src/server/operations/ops/validate.ts +5 -1
- package/src/server/operations/ops/viewport.ts +97 -3
- package/src/server/operations/registry.ts +74 -25
- package/src/server/placement.ts +29 -0
- package/src/server/scope-fence.ts +78 -6
- package/src/server/server.ts +115 -16
- package/src/server/spatial-analysis.ts +48 -23
- package/src/server/tour-control.ts +82 -0
- package/src/server/wiki-links.ts +137 -0
- package/src/server/workbench-auth.ts +11 -0
- package/src/shared/agent-context.ts +3 -0
- package/src/shared/agent-presence.ts +15 -15
- package/src/shared/auto-arrange.ts +2 -0
- package/src/shared/boards.ts +4 -4
- package/src/shared/knowledge-lifecycle.ts +22 -0
- package/src/shared/knowledge-presets.ts +80 -0
- package/src/shared/lifecycle-status.ts +26 -0
- package/src/shared/memory-graph.ts +74 -0
- package/src/shared/relations.ts +98 -0
- package/src/shared/semantic-attention.ts +15 -1
- package/src/shared/tour.ts +23 -5
- package/src/shared/workspace-settings.ts +13 -0
- package/dist/types/client/canvas/ContextPinBar.d.ts +0 -1
- package/dist/types/client/canvas/FocusFieldLayer.d.ts +0 -1
- package/dist/types/client/canvas/kind-colors.d.ts +0 -3
- package/dist/types/server/agent-context.d.ts +0 -22
- package/src/client/canvas/ContextPinBar.tsx +0 -25
|
@@ -121,6 +121,37 @@ export function HtmlNode({
|
|
|
121
121
|
return () => window.clearTimeout(id);
|
|
122
122
|
}, [autoFocus, surfaceSrc]);
|
|
123
123
|
|
|
124
|
+
const handleDocumentLoad = (frame: HTMLIFrameElement, signal: AbortSignal): Promise<boolean> => {
|
|
125
|
+
if (signal.aborted) return Promise.resolve(false);
|
|
126
|
+
return new Promise((resolve) => {
|
|
127
|
+
const finish = (ready: boolean) => {
|
|
128
|
+
clearTimeout(timer);
|
|
129
|
+
window.removeEventListener('message', receive);
|
|
130
|
+
signal.removeEventListener('abort', cancel);
|
|
131
|
+
resolve(ready);
|
|
132
|
+
};
|
|
133
|
+
const cancel = () => finish(false);
|
|
134
|
+
const receive = (event: MessageEvent) => {
|
|
135
|
+
if (
|
|
136
|
+
event.source !== frame.contentWindow ||
|
|
137
|
+
event.data?.source !== HTML_SURFACE_PUSH_SOURCE ||
|
|
138
|
+
event.data?.token !== themeToken
|
|
139
|
+
)
|
|
140
|
+
return;
|
|
141
|
+
// A healthy offscreen frame can wait for paint without a deadline.
|
|
142
|
+
if (event.data.type === 'mounted') clearTimeout(timer);
|
|
143
|
+
if (event.data.type === 'ready') finish(true);
|
|
144
|
+
};
|
|
145
|
+
const timer = setTimeout(cancel, 10_000);
|
|
146
|
+
window.addEventListener('message', receive);
|
|
147
|
+
signal.addEventListener('abort', cancel, { once: true });
|
|
148
|
+
frame.contentWindow?.postMessage(
|
|
149
|
+
{ source: HTML_SURFACE_PUSH_SOURCE, type: 'check-ready', token: themeToken },
|
|
150
|
+
'*',
|
|
151
|
+
);
|
|
152
|
+
});
|
|
153
|
+
};
|
|
154
|
+
|
|
124
155
|
const handleFrameLoad = () => {
|
|
125
156
|
iframeRef.current?.contentWindow?.postMessage(
|
|
126
157
|
{
|
|
@@ -174,6 +205,7 @@ export function HtmlNode({
|
|
|
174
205
|
allow=""
|
|
175
206
|
tabIndex={autoFocus ? 0 : undefined}
|
|
176
207
|
onLoad={handleFrameLoad}
|
|
208
|
+
onDocumentLoad={handleDocumentLoad}
|
|
177
209
|
/>
|
|
178
210
|
);
|
|
179
211
|
}
|
|
@@ -142,7 +142,7 @@ export function ImageNode({ node, expanded = false }: { node: CanvasNodeState; e
|
|
|
142
142
|
<span class="image-node-meta">
|
|
143
143
|
{sizeLabel && <span>{sizeLabel}</span>}
|
|
144
144
|
{zoom !== 1 && (
|
|
145
|
-
<button type="button" class="image-node-zoom-reset" onClick={resetView}
|
|
145
|
+
<button type="button" class="image-node-zoom-reset" onClick={resetView} aria-label="Reset zoom">
|
|
146
146
|
{zoomPct}% <IconRefresh size={14} />
|
|
147
147
|
</button>
|
|
148
148
|
)}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { RefObject } from 'preact';
|
|
2
|
+
import { BarHint } from '../canvas/BarHint';
|
|
2
3
|
import { useCallback, useEffect, useLayoutEffect, useRef, useState } from 'preact/hooks';
|
|
3
4
|
import { modChord } from '../utils/platform';
|
|
4
5
|
import { promptAndInsertLink, wrapSelectionInCode } from './inline-editor-commands';
|
|
@@ -136,15 +137,11 @@ export function InlineFormatBar({ hostRef, onChange }: { hostRef: RefObject<HTML
|
|
|
136
137
|
>
|
|
137
138
|
{ACTIONS.flatMap((a, i) => {
|
|
138
139
|
const btn = (
|
|
139
|
-
<
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
onClick={() => handleClick(a)}
|
|
145
|
-
>
|
|
146
|
-
{a.icon}
|
|
147
|
-
</button>
|
|
140
|
+
<BarHint key={`btn-${i}`} label={a.title}>
|
|
141
|
+
<button type="button" class="md-inline-format-btn" aria-label={a.title} onClick={() => handleClick(a)}>
|
|
142
|
+
{a.icon}
|
|
143
|
+
</button>
|
|
144
|
+
</BarHint>
|
|
148
145
|
);
|
|
149
146
|
return a.dividerBefore ? [<span key={`div-${i}`} class="md-inline-format-divider" />, btn] : [btn];
|
|
150
147
|
})}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { gfm } from '@joplin/turndown-plugin-gfm';
|
|
2
2
|
import TurndownService from 'turndown';
|
|
3
|
-
import { useCallback,
|
|
3
|
+
import { useCallback, useLayoutEffect, useRef } from 'preact/hooks';
|
|
4
4
|
import { InlineFormatBar } from './InlineFormatBar';
|
|
5
5
|
import { promptAndInsertLink } from './inline-editor-commands';
|
|
6
6
|
import { sanitizeMarkdownHtml } from './markdown-sanitize';
|
|
@@ -15,6 +15,15 @@ function getTurndown(): TurndownService {
|
|
|
15
15
|
bulletListMarker: '-',
|
|
16
16
|
});
|
|
17
17
|
td.use(gfm);
|
|
18
|
+
td.addRule('wikiLink', {
|
|
19
|
+
filter: (node) => node.nodeName === 'A' && node.hasAttribute('data-wiki-markdown'),
|
|
20
|
+
replacement: (_content, node) => {
|
|
21
|
+
const label = node.textContent ?? '';
|
|
22
|
+
return label === node.getAttribute('data-wiki-label')
|
|
23
|
+
? node.getAttribute('data-wiki-markdown')!
|
|
24
|
+
: `[[${node.getAttribute('data-wiki-ref')}|${label}]]`;
|
|
25
|
+
},
|
|
26
|
+
});
|
|
18
27
|
_turndown = td;
|
|
19
28
|
return td;
|
|
20
29
|
}
|
|
@@ -23,36 +32,61 @@ function getTurndown(): TurndownService {
|
|
|
23
32
|
*
|
|
24
33
|
* Two persistence signals:
|
|
25
34
|
* - `onChange(md)` — fires on every input. Caller typically debounces.
|
|
26
|
-
* - `onSave(md)` — fires on ⌘S and blur. Caller should persist immediately
|
|
35
|
+
* - `onSave(md)` — fires on ⌘S and blur. Caller should persist dirty drafts immediately
|
|
27
36
|
* and cancel any pending debounced save, since `md` is the authoritative
|
|
28
|
-
* latest content
|
|
29
|
-
* never reads a stale state snapshot. */
|
|
37
|
+
* latest content: the exact caller draft until input, serialized DOM after it. */
|
|
30
38
|
export function InlineMarkdownEditor({
|
|
39
|
+
markdown,
|
|
31
40
|
initialHtml,
|
|
32
41
|
className,
|
|
33
42
|
onChange,
|
|
34
43
|
onSave,
|
|
35
44
|
}: {
|
|
45
|
+
markdown: string;
|
|
36
46
|
initialHtml: string;
|
|
37
47
|
className?: string;
|
|
38
48
|
onChange: (markdown: string) => void;
|
|
39
49
|
onSave?: (markdown: string) => void;
|
|
40
50
|
}) {
|
|
41
51
|
const rootRef = useRef<HTMLDivElement>(null);
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
const
|
|
52
|
+
const initialized = useRef(false);
|
|
53
|
+
const edited = useRef(false);
|
|
54
|
+
const displayedMarkdown = useRef(markdown);
|
|
55
|
+
const previousMarkdown = useRef(markdown);
|
|
45
56
|
|
|
46
|
-
|
|
57
|
+
useLayoutEffect(() => {
|
|
47
58
|
const el = rootRef.current;
|
|
48
59
|
if (!el) return;
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
60
|
+
const html = sanitizeMarkdownHtml(initialHtml);
|
|
61
|
+
const sourceChanged = previousMarkdown.current !== markdown;
|
|
62
|
+
previousMarkdown.current = markdown;
|
|
63
|
+
if (!initialized.current || (sourceChanged && displayedMarkdown.current !== markdown)) {
|
|
64
|
+
initialized.current = true;
|
|
65
|
+
displayedMarkdown.current = markdown;
|
|
66
|
+
edited.current = false;
|
|
67
|
+
el.innerHTML = html;
|
|
68
|
+
// Marked emits disabled GFM boxes; they are editable here.
|
|
69
|
+
for (const box of el.querySelectorAll('input[type="checkbox"][disabled]')) box.removeAttribute('disabled');
|
|
70
|
+
return;
|
|
54
71
|
}
|
|
55
|
-
|
|
72
|
+
// Local input already owns this Markdown. Only a different accepted source
|
|
73
|
+
// replaces it; metadata-only refreshes must not move the selection.
|
|
74
|
+
const fresh = document.createElement('div');
|
|
75
|
+
fresh.innerHTML = html;
|
|
76
|
+
const links = new Map(
|
|
77
|
+
[...fresh.querySelectorAll('a[data-wiki-ref]')].map((link) => [link.getAttribute('data-wiki-ref'), link]),
|
|
78
|
+
);
|
|
79
|
+
for (const link of el.querySelectorAll('a[data-wiki-ref]')) {
|
|
80
|
+
const replacement = links.get(link.getAttribute('data-wiki-ref'));
|
|
81
|
+
if (!replacement) continue;
|
|
82
|
+
for (const attribute of ['data-wiki-board', 'data-wiki-card', 'data-wiki-missing']) {
|
|
83
|
+
const value = replacement.getAttribute(attribute);
|
|
84
|
+
if (value === null) link.removeAttribute(attribute);
|
|
85
|
+
else link.setAttribute(attribute, value);
|
|
86
|
+
}
|
|
87
|
+
link.classList.toggle('is-unresolved', replacement.classList.contains('is-unresolved'));
|
|
88
|
+
}
|
|
89
|
+
}, [initialHtml, markdown]);
|
|
56
90
|
|
|
57
91
|
const serialize = useCallback((): string => {
|
|
58
92
|
const el = rootRef.current;
|
|
@@ -61,7 +95,10 @@ export function InlineMarkdownEditor({
|
|
|
61
95
|
}, []);
|
|
62
96
|
|
|
63
97
|
const handleInput = useCallback(() => {
|
|
64
|
-
|
|
98
|
+
edited.current = true;
|
|
99
|
+
const md = serialize();
|
|
100
|
+
displayedMarkdown.current = md;
|
|
101
|
+
onChange(md);
|
|
65
102
|
}, [onChange, serialize]);
|
|
66
103
|
|
|
67
104
|
const handleSave = useCallback(() => {
|
|
@@ -69,8 +106,10 @@ export function InlineMarkdownEditor({
|
|
|
69
106
|
// focused) reads back an empty tree — saving that would WIPE the document.
|
|
70
107
|
const el = rootRef.current;
|
|
71
108
|
if (!el || !el.isConnected || el.innerHTML === '') return;
|
|
72
|
-
|
|
73
|
-
|
|
109
|
+
// Turndown cannot round-trip source spacing. Until this editor receives
|
|
110
|
+
// input, flush the caller's exact draft (including edits from Source mode).
|
|
111
|
+
onSave?.(edited.current ? serialize() : markdown);
|
|
112
|
+
}, [markdown, onSave, serialize]);
|
|
74
113
|
|
|
75
114
|
const handleKeyDown = useCallback(
|
|
76
115
|
(e: KeyboardEvent) => {
|