visualproof 0.4.2 → 0.4.4

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.
Files changed (47) hide show
  1. package/dist/assets/latex/visualproof.sty +19 -9
  2. package/dist/mcp/visualproof-mcp.mjs +7 -3
  3. package/dist/server/access.js +34 -0
  4. package/dist/server/agent.js +5 -4
  5. package/dist/server/agentlibrary.js +1 -1
  6. package/dist/server/agentviews.js +1 -1
  7. package/dist/server/artcmd.js +1 -1
  8. package/dist/server/askfollow.js +1 -4
  9. package/dist/server/events.js +20 -5
  10. package/dist/server/export.js +17 -4
  11. package/dist/server/fetchurl.js +30 -13
  12. package/dist/server/history.js +3 -1
  13. package/dist/server/identity.js +25 -1
  14. package/dist/server/library.js +10 -3
  15. package/dist/server/live.js +32 -5
  16. package/dist/server/lostfound.js +3 -2
  17. package/dist/server/main.js +113 -28
  18. package/dist/server/poppler.js +48 -10
  19. package/dist/server/renames.js +10 -5
  20. package/dist/server/review.js +10 -0
  21. package/dist/server/reviewapi.js +1 -1
  22. package/dist/server/status.js +29 -8
  23. package/dist/server/talk.js +7 -2
  24. package/dist/server/views.js +21 -7
  25. package/dist/shared/collab.js +14 -8
  26. package/dist/shared/doc/latex.js +5 -3
  27. package/dist/shared/doc/outline.js +6 -3
  28. package/dist/shared/library.js +11 -6
  29. package/dist/shared/review.js +7 -5
  30. package/dist/shared/search.js +7 -3
  31. package/dist/shared/views.js +8 -1
  32. package/dist/web/bundle/app.js +1800 -753
  33. package/dist/web/bundle/edges.js +42 -15
  34. package/dist/web/index.html +2 -2
  35. package/dist/web/src/artwork.js +25 -4
  36. package/dist/web/src/axiomring.js +42 -0
  37. package/dist/web/src/bundles.js +52 -16
  38. package/dist/web/src/canvas.js +62 -20
  39. package/dist/web/src/past.js +28 -0
  40. package/dist/web/src/selection.js +47 -4
  41. package/dist/web/src/status.js +4 -2
  42. package/dist/web/style.css +183 -21
  43. package/docs/agent-api/following.md +1 -1
  44. package/docs/agent-api/library.md +1 -1
  45. package/docs/agent-api/requests.md +3 -1
  46. package/docs/agent-api/views.md +1 -1
  47. package/package.json +1 -1
@@ -1019,7 +1019,9 @@ button.o-trust:hover { color: var(--accent); background: var(--code-bg); }
1019
1019
  box-shadow: 0 0 0 1px var(--line), var(--shadow-lg);
1020
1020
  }
1021
1021
  #peer-menu[hidden] { display: none; }
1022
- #bar:has(#peer-menu:not([hidden])) { z-index: 36; }
1022
+ /* over the Export window and the artwork's panel too: following someone, or no longer, is the
1023
+ reader's own way out wherever they are (CollabSpec, "What following leaves") */
1024
+ #bar:has(#peer-menu:not([hidden])) { z-index: 42; }
1023
1025
  .pm-who { display: grid; grid-template-columns: auto minmax(0, 1fr); column-gap: 8px; align-items: center; padding: 6px 10px 4px; }
1024
1026
  .pm-dot { width: 9px; height: 9px; border-radius: 50%; }
1025
1027
  .pm-name { font-weight: 600; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
@@ -1381,7 +1383,9 @@ details.lf-archived > summary { cursor: pointer; }
1381
1383
  .p-also .avatar { width: 20px; height: 20px; font-size: 9px; }
1382
1384
  .modal-actions { display: flex; justify-content: flex-end; gap: 8px; }
1383
1385
  .rv-btn.primary { background: var(--accent); border-color: var(--accent); color: white; }
1384
- .rv-btn.primary:hover { color: white; filter: brightness(1.08); }
1386
+ .rv-btn.primary:hover:not(:disabled) { color: white; filter: brightness(1.08); }
1387
+ /* one that cannot be used looks it, as the others do (above): faded, never grey on its colour */
1388
+ .rv-btn.primary:disabled { color: white; opacity: 0.45; }
1385
1389
  .tk-ref:hover { text-decoration: underline; background: var(--code-bg); }
1386
1390
  .brand .logo { font-size: 17px; }
1387
1391
  .project { color: var(--text-2); font-weight: 500; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
@@ -1510,7 +1514,8 @@ details.lf-archived > summary { cursor: pointer; }
1510
1514
  /* something said for a moment (a shift-click that changed nothing): read, then gone */
1511
1515
  /* something said for a moment is read above the floating windows too: it answers what was just done */
1512
1516
  .hint.say { color: var(--text); padding: 3px 10px; border-radius: 8px; background: var(--surface-solid); box-shadow: var(--shadow); z-index: 36; }
1513
- .hint.say.below { top: 156px; }
1517
+ /* under the review strip and the note of a kept view (--strip-h: main.ts) */
1518
+ .hint.say.below { top: calc(118px + var(--strip-h, 38px)); }
1514
1519
 
1515
1520
  /* the selection (web/src/selbar.ts): under the modes, heading the panel's column */
1516
1521
  #selbar {
@@ -1774,7 +1779,9 @@ details.lf-archived > summary { cursor: pointer; }
1774
1779
  .o-row.on { background: color-mix(in srgb, var(--accent) 11%, transparent); box-shadow: inset 2px 0 0 var(--accent); }
1775
1780
  .o-row.on .o-label { color: var(--accent); font-weight: 600; }
1776
1781
  .o-row .tw { width: 12px; color: var(--text-3); font-size: 10px; flex: none; text-align: center; }
1777
- .o-label { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
1782
+ /* the arrow and the name are buttons (the keyboard's too), drawn as the row's text */
1783
+ .o-row button.tw, .o-row button.o-label { border: 0; background: none; padding: 0; height: 100%; }
1784
+ .o-label { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; text-align: left; }
1778
1785
  .o-count { color: var(--text-3); font-size: 11px; font-variant-numeric: tabular-nums; }
1779
1786
  .o-row .fold { border: 0; background: transparent; color: var(--text-2); width: 20px; padding: 0; font-size: 10px; }
1780
1787
  .o-row .fold:hover { color: var(--accent); }
@@ -1940,6 +1947,14 @@ a.link:hover { text-decoration: underline; }
1940
1947
  .s-trusted { --s: var(--status-trusted); }
1941
1948
  .dot.ss, .card.ss .dot { background: var(--s); box-shadow: none; }
1942
1949
  .dot.ss.k-external, .card.ss.k-external .dot { background: transparent; box-shadow: inset 0 0 0 1.5px var(--s); }
1950
+ /* an axiom is a ring (CanvasSpec, "Colour schemes and the legend", the owner's decision of
1951
+ 2026-10-18; web/src/axiomring.ts): its dot ringed in its own colour a gap apart, as its point on
1952
+ the canvas is, in either scheme — in the legend, the panel, a card, the search, the hover */
1953
+ .dot.k-axiom, .k-axiom .dot, .dot.axiom, .axiom .dot { outline: 1.5px solid var(--ring, var(--k-axiom)); outline-offset: 1.5px; }
1954
+ .dot.k-external.axiom, .k-external .dot.axiom, .k-external.axiom .dot { --ring: var(--k-external); }
1955
+ .dot.ss.axiom, .ss.axiom .dot, .ss.k-axiom .dot { --ring: var(--s); }
1956
+ /* the legend's line for it, by status: a ring round a dot of no state's colour */
1957
+ .lg-ring .dot { background: var(--text-2); --ring: var(--text-2); width: 8px; height: 8px; margin: 0 3px; }
1943
1958
  .cluster-card .dot { background: var(--grad); }
1944
1959
 
1945
1960
  /* the guide (CollabSpec, G1): the first-visit tour, and the sheet of keys */
@@ -2530,6 +2545,7 @@ body.tm #tabs, body.tm .views-wrap, body.tm .vb-gap, body.tm .light-l { display:
2530
2545
  #tmbar.busy .tm-mark.aim { fill: var(--surface-solid); stroke: var(--accent); stroke-width: 1.4; }
2531
2546
  .tm-wait:not(.tm-failed) { display: none; }
2532
2547
  #tmbar.busy .tm-wait { display: inline; }
2548
+ #tabs.busy .tab-wait { display: inline-flex; gap: 0; padding: 0 12px; color: var(--text-3); cursor: default; }
2533
2549
  .tm-wait.tm-failed { color: var(--tm-gone); font-style: normal; }
2534
2550
  .tm-spin { display: inline-block; width: 9px; height: 9px; margin-right: 4px; vertical-align: -1px; box-sizing: border-box; border: 1.5px solid color-mix(in srgb, var(--accent) 28%, transparent); border-top-color: var(--accent); border-radius: 50%; animation: tm-spin 900ms linear infinite; }
2535
2551
  @keyframes tm-spin { to { transform: rotate(360deg); } }
@@ -2537,6 +2553,8 @@ body.tm #tabs, body.tm .views-wrap, body.tm .vb-gap, body.tm .light-l { display:
2537
2553
  .tm-when { flex: none; font-size: 12px; white-space: nowrap; color: var(--text); }
2538
2554
  .tm-when .mono { font: 11.5px var(--mono); color: var(--text-2); }
2539
2555
  .tm-latest { font-size: 10.5px; padding: 1px 6px; border-radius: 6px; background: var(--code-bg); color: var(--text-2); }
2556
+ /* a build that could not read some files (web/src/past.ts, unreadWords) */
2557
+ .tm-unread { flex: none; font-size: 10.5px; padding: 1px 6px; border-radius: 6px; background: rgba(255, 159, 10, 0.13); color: var(--banner-warn); }
2540
2558
  .tm-wait { color: var(--text-3); font-style: italic; }
2541
2559
  .tm-sum { flex: 0 1 auto; display: flex; align-items: center; gap: 4px; min-width: 0; overflow: hidden; font-size: 12px; white-space: nowrap; }
2542
2560
  .tm-n {
@@ -2579,9 +2597,10 @@ button.tm-row:hover { background: var(--code-bg); }
2579
2597
  /* what was added since: a name, not a place on this build's board */
2580
2598
  span.tm-row { color: var(--text-2); cursor: default; }
2581
2599
  .tm-more { padding: 6px; font-size: 11.5px; }
2582
- /* a view kept at a past build (HistorySpec decision 19): said where the review strip goes */
2600
+ /* a view kept at a past build (HistorySpec decision 19): said where the review strip goes, under it
2601
+ where both show (a kept view focused on a target; --lens-h: main.ts) */
2583
2602
  #tm-kept {
2584
- position: fixed; top: 110px; left: calc((100vw + var(--inset-left, 0px) - var(--inset-right, 0px)) / 2); transform: translateX(-50%); z-index: 15;
2603
+ position: fixed; top: calc(110px + var(--lens-h, 0px)); left: calc((100vw + var(--inset-left, 0px) - var(--inset-right, 0px)) / 2); transform: translateX(-50%); z-index: 15;
2585
2604
  display: flex; align-items: center; gap: 8px; padding: 5px 6px 5px 12px; border-radius: 12px; font-size: 12.5px;
2586
2605
  max-width: calc(100vw - var(--inset-left, 0px) - var(--inset-right, 0px) - 16px); white-space: nowrap;
2587
2606
  }
@@ -2649,7 +2668,6 @@ span.tm-row { color: var(--text-2); cursor: default; }
2649
2668
  width: auto !important; max-width: none !important; max-height: calc(100dvh - 70px); overflow: auto;
2650
2669
  }
2651
2670
  #viewbar { top: 58px; left: 8px; right: 8px; gap: 6px; }
2652
- .side-btn { display: inline-flex; flex: none; width: 36px; justify-content: center; padding: 0; }
2653
2671
  #tabs { flex: 1 1 auto; min-width: 0; overflow-x: auto; scrollbar-width: none; }
2654
2672
  #tabs::-webkit-scrollbar { display: none; }
2655
2673
  .vb-gap, .light-l { display: none; }
@@ -2678,6 +2696,7 @@ span.tm-row { color: var(--text-2); cursor: default; }
2678
2696
  #foot { left: 8px; bottom: calc(8px + env(safe-area-inset-bottom)); }
2679
2697
  /* under the view bar, the review strip, then the selection bar (--strip-h: main.ts) */
2680
2698
  #lensbar, #tm-kept { top: 100px; left: 8px; right: 8px; transform: none; max-width: none; }
2699
+ #tm-kept { top: calc(100px + var(--lens-h, 0px)); }
2681
2700
  #selbar { top: calc(100px + var(--strip-h, 0px)); left: 8px; right: 8px; width: auto; }
2682
2701
  /* the panel: a sheet from the bottom, its height the reader's to drag */
2683
2702
  #panel {
@@ -2688,20 +2707,6 @@ span.tm-row { color: var(--text-2); cursor: default; }
2688
2707
  }
2689
2708
  #panel.open { transform: none; }
2690
2709
  #panel::before { content: ""; position: sticky; top: -18px; display: block; width: 40px; height: 5px; margin: -18px auto 13px; border-radius: 3px; background: var(--text-3); opacity: 0.6; }
2691
- /* the side panel: a drawer from the left, over a shade */
2692
- body.side-open #side { display: flex; position: fixed; top: 0; left: 0; bottom: 0; width: min(320px, 86vw); border-radius: 0 16px 16px 0; z-index: 47; padding-top: env(safe-area-inset-top); background: var(--surface-solid); }
2693
- body.side-open::after { content: ""; position: fixed; inset: 0; z-index: 46; background: rgba(0, 0, 0, 0.3); }
2694
- /* ⚙ Board and Trusted: in the drawer's place, over it, with a way back */
2695
- body.side-open .side-pop {
2696
- left: 0 !important; top: 0 !important; bottom: 0 !important; right: auto !important; width: min(320px, 86vw) !important;
2697
- height: auto !important; max-height: none !important; border-radius: 0 16px 16px 0; z-index: 48;
2698
- background: var(--surface-solid); padding-top: calc(8px + env(safe-area-inset-top));
2699
- }
2700
- body.side-open .side-back {
2701
- display: flex; align-items: center; gap: 4px; min-height: 40px; margin: 0 0 6px -6px; padding: 0 6px; border: 0;
2702
- background: none; color: var(--accent); font: 600 15px var(--font);
2703
- }
2704
- .side-back svg { width: 18px; height: 18px; fill: none; stroke: currentColor; stroke-width: 1.8; stroke-linecap: round; stroke-linejoin: round; }
2705
2710
  /* a field under 16 px makes iOS zoom the whole page into it */
2706
2711
  #panel textarea, #panel input, #share-pop input, #share-pop select, #who-menu input, #modal input, .sh-field input, .sh-field select { font-size: 16px; }
2707
2712
  /* nothing slides sideways: the page is the screen */
@@ -2741,3 +2746,160 @@ span.tm-row { color: var(--text-2); cursor: default; }
2741
2746
  }
2742
2747
  .act-head .icon { width: 40px; height: 40px; font-size: 20px; }
2743
2748
  }
2749
+
2750
+ /* ---------------------------------------------------------------- a phone or a tall screen
2751
+
2752
+ What the two shapes whose panel is a sheet share (web/src/phone.ts, SHEETED): the side panel is a
2753
+ drawer from ☰, at the left of the view bar, and ⚙ Board and Trusted take its place. */
2754
+ @media (max-width: 640px), (min-width: 641px) and (max-aspect-ratio: 5/6) and (pointer: coarse), (min-width: 641px) and (max-width: 999px) and (max-aspect-ratio: 5/6) {
2755
+ .side-btn { display: inline-flex; flex: none; width: 36px; justify-content: center; padding: 0; }
2756
+ /* the side panel: a drawer from the left, over a shade */
2757
+ body.side-open #side { display: flex; position: fixed; top: 0; left: 0; bottom: 0; width: min(320px, 86vw); border-radius: 0 16px 16px 0; z-index: 47; padding-top: env(safe-area-inset-top); background: var(--surface-solid); }
2758
+ body.side-open::after { content: ""; position: fixed; inset: 0; z-index: 46; background: rgba(0, 0, 0, 0.3); }
2759
+ /* ⚙ Board and Trusted: in the drawer's place, over it, with a way back */
2760
+ body.side-open .side-pop {
2761
+ left: 0 !important; top: 0 !important; bottom: 0 !important; right: auto !important; width: min(320px, 86vw) !important;
2762
+ height: auto !important; max-height: none !important; border-radius: 0 16px 16px 0; z-index: 48;
2763
+ background: var(--surface-solid); padding-top: calc(8px + env(safe-area-inset-top));
2764
+ }
2765
+ body.side-open .side-back {
2766
+ display: flex; align-items: center; gap: 4px; min-height: 40px; margin: 0 0 6px -6px; padding: 0 6px; border: 0;
2767
+ background: none; color: var(--accent); font: 600 15px var(--font);
2768
+ }
2769
+ .side-back svg { width: 18px; height: 18px; fill: none; stroke: currentColor; stroke-width: 1.8; stroke-linecap: round; stroke-linejoin: round; }
2770
+ }
2771
+
2772
+ /* ---------------------------------------------------------------- a tall screen (PhoneSpec, "Tall screens")
2773
+
2774
+ Wider than a phone and upright, under a finger or narrower than 1000 px: a tablet held upright, a
2775
+ narrow window (an upright monitor with a mouse is not one: below). A larger screen's page, placed
2776
+ for the shape: the side panel is the drawer (above), the panel a sheet
2777
+ from the bottom across the screen, and what takes the panel's place on a larger screen —
2778
+ Activity, the lost-and-found, Export's window — takes the sheet's; the floating windows dock there
2779
+ too. The review strip, then the selection bar, go across under the view bar; the legend and the
2780
+ zoom's box keep to the board's room, above the sheet (--room-bottom: web/src/phone.ts). */
2781
+ @media (min-width: 641px) and (max-aspect-ratio: 5/6) and (pointer: coarse), (min-width: 641px) and (max-width: 999px) and (max-aspect-ratio: 5/6) {
2782
+ /* the tallest the sheet and the dock go: under the view bar, the review strip and the selection
2783
+ bar (--strip-h, --selbar-h: main.ts) */
2784
+ body { --sheet-most: calc(100dvh - 120px - var(--strip-h, 0px) - var(--selbar-h, 0px)); }
2785
+ #side { display: none; }
2786
+ body.side-open #side, body.side-open .side-pop { width: min(360px, 60vw) !important; }
2787
+ /* the sheet: the panel, or Activity or the lost-and-found in its place, at the height the reader
2788
+ gives it (a drag on its handle, or a tap: half the screen or the tallest, under the view bar) */
2789
+ #panel, #activity, #lostfound {
2790
+ top: auto; left: 12px; right: 12px; bottom: 12px; width: auto; height: var(--sheet-h, 50dvh); max-height: var(--sheet-most);
2791
+ padding-top: 30px; overflow-x: hidden; overscroll-behavior: contain;
2792
+ transform: translateY(calc(100% + 60px)); transition: transform 0.32s cubic-bezier(0.2, 0.9, 0.25, 1), height 0.2s;
2793
+ }
2794
+ #activity, #lostfound { z-index: 7; }
2795
+ #panel.open, #activity.open, #lostfound.open { transform: none; }
2796
+ #panel.sizing, #activity.sizing, #lostfound.sizing { transition: none; user-select: none; -webkit-user-select: none; }
2797
+ #panel::before, #activity::before, #lostfound::before {
2798
+ content: ""; position: sticky; top: -22px; z-index: 3; display: block; width: 44px; height: 5px; margin: -22px auto 17px;
2799
+ border-radius: 3px; background: var(--text-3); opacity: 0.6; cursor: ns-resize; touch-action: none;
2800
+ }
2801
+ /* the floating windows: docked in the sheet's place, over it, side by side where there is room
2802
+ and one over the other where there is not; a collapsed one its pill, at the dock's foot. The
2803
+ dock places them: no edge resizes them, no drag moves them (web/src/floatwin.ts) */
2804
+ #windows {
2805
+ top: auto; left: 12px; right: 12px; bottom: 12px; height: var(--sheet-h, 50dvh); max-height: var(--sheet-most);
2806
+ display: flex; flex-direction: column; justify-content: flex-end; gap: 8px;
2807
+ }
2808
+ /* its handle, over the windows while one is open there, sets the dock's height as the sheet's does
2809
+ (the same height: web/src/phone.ts) */
2810
+ #windows:has(> :is(.sw-win, .pw-win, #following.talking):not(.collapsed, [hidden])) { padding-top: 14px; }
2811
+ #windows:has(> :is(.sw-win, .pw-win, #following.talking):not(.collapsed, [hidden]))::before {
2812
+ content: ""; position: absolute; top: 0; left: 50%; width: 120px; height: 14px; transform: translateX(-50%);
2813
+ pointer-events: auto; cursor: ns-resize; touch-action: none;
2814
+ background: linear-gradient(var(--text-3), var(--text-3)) center 4px / 44px 5px no-repeat; opacity: 0.6; border-radius: 3px;
2815
+ }
2816
+ /* the declaration's source first, then the reference beside it, then a conversation */
2817
+ #windows > .sw-win { order: 1; }
2818
+ #windows > .pw-win { order: 2; }
2819
+ #windows > #following { order: 3; }
2820
+ #windows > .sw-win, #windows > .pw-win, #windows > #following.talking {
2821
+ position: relative !important; inset: auto !important; transform: none;
2822
+ width: auto !important; height: auto !important; min-width: 0 !important; min-height: 0 !important; max-width: none !important; max-height: none !important;
2823
+ flex: 1 1 0; z-index: auto !important;
2824
+ }
2825
+ #windows > .collapsed { flex: none; align-self: flex-start; max-width: min(360px, 100%) !important; }
2826
+ #windows .fl-rz { display: none !important; }
2827
+ @media (min-width: 960px) { #windows { flex-direction: row; align-items: stretch; } #windows > .collapsed { align-self: flex-end; } }
2828
+ #windows .sw-head, #windows .pw-head, #windows > #following.talking > .fl-strip { cursor: default; }
2829
+ /* Export's window: in the sheet's place too, the outline it arranges above it */
2830
+ #export-modal { top: auto; left: 12px; right: 12px; bottom: 12px; }
2831
+ #export-modal .ex-box { width: auto; max-height: var(--sheet-h, 50dvh); }
2832
+ /* under the view bar, across the screen: the review strip, then the selection bar (--strip-h:
2833
+ main.ts) */
2834
+ #lensbar, #tm-kept { top: 108px; left: 12px; right: 12px; transform: none; max-width: none; }
2835
+ #tm-kept { top: calc(108px + var(--lens-h, 0px)); }
2836
+ #selbar { top: calc(108px + var(--strip-h, 0px)); left: 12px; right: 12px; width: auto; }
2837
+ /* the legend and the zoom's box at the foot of the board's room, above the sheet or the dock */
2838
+ #foot { left: 12px; bottom: var(--room-bottom, 12px); visibility: var(--room-shown, visible); transition: bottom 0.32s cubic-bezier(0.2, 0.9, 0.25, 1); }
2839
+ #zoom { right: 12px; bottom: var(--room-bottom, 12px); visibility: var(--room-shown, visible); transition: bottom 0.32s cubic-bezier(0.2, 0.9, 0.25, 1); }
2840
+ #following:not(.talking), #whatsnew { bottom: calc(var(--room-bottom, 12px) + 40px); }
2841
+ #welcome { left: 12px; bottom: calc(var(--room-bottom, 12px) + 40px); }
2842
+ /* the bar's popovers: at its right, under it, never past the screen's edge */
2843
+ .share-wrap, .library-wrap { position: static; }
2844
+ #share-pop, #library-pop { top: calc(100% + 6px); right: 0; }
2845
+ /* the help: as wide as the screen allows, the film over its chapters */
2846
+ .help-box, .help-box:has([data-help-pane="tips"]:not([hidden])) { width: calc(100vw - 32px); max-height: calc(100dvh - 32px); }
2847
+ }
2848
+ /* a tall screen narrower than the bar's words: Share, the library and Export by their icons; the
2849
+ focus gives way to the Time Machine, as on a phone */
2850
+ @media (min-width: 641px) and (max-width: 999px) and (max-aspect-ratio: 5/6) {
2851
+ body.tm .focus-wrap { display: none; }
2852
+ }
2853
+ @media (min-width: 641px) and (max-width: 900px) and (max-aspect-ratio: 5/6) {
2854
+ #share-btn > span, #library-btn > span, #export-btn > span { display: none; }
2855
+ #bar { gap: 10px; }
2856
+ }
2857
+
2858
+ /* ---------------------------------------------------------------- an upright monitor (PhoneSpec decisions 29–35)
2859
+
2860
+ At least 1000 px wide, upright, with a mouse (web/src/monitor.ts): a desktop's page, the board above
2861
+ and a work area across the bottom. The side panel stands at the board's left; in the work area the
2862
+ panel (or what takes its place) is a pane at the left and the windows one column at its right,
2863
+ stacked from the top, each where monitor.ts puts it (--dock-x, --dock-y, --dock-w, --dock-h). The
2864
+ work area's height, the panel's width and what the board has above them are the page's variables
2865
+ (--mon-low, --mon-pane-w, --mon-room-bottom); the splitters (.mon-split) change them. */
2866
+ @media (min-width: 1000px) and (max-aspect-ratio: 5/6) and (pointer: fine) {
2867
+ #side { top: 108px; bottom: var(--mon-room-bottom, 12px); width: 300px; transition: bottom 0.32s cubic-bezier(0.2, 0.9, 0.25, 1); }
2868
+ /* the work area: a surface under the board while something is in it */
2869
+ body::before {
2870
+ content: ""; display: var(--mon-area, none); position: fixed; left: 12px; right: 12px; bottom: 12px; height: var(--mon-low); z-index: 5;
2871
+ pointer-events: none; border-radius: 18px; background: color-mix(in srgb, var(--surface) 70%, transparent); box-shadow: inset 0 0 0 1px var(--line);
2872
+ }
2873
+ /* the panel, or Activity or the lost-and-found in its place: the pane at the work area's left, its
2874
+ whole width where no window is open */
2875
+ #panel, #activity, #lostfound {
2876
+ top: auto; bottom: 12px; left: 12px; right: auto; width: var(--mon-pane-w); height: var(--mon-low);
2877
+ transform: translateY(calc(100% + 60px));
2878
+ }
2879
+ #panel.open, #activity.open, #lostfound.open { transform: none; }
2880
+ /* the windows: in the column, placed there and not dragged; a collapsed one its pill */
2881
+ #windows > .mon-docked {
2882
+ position: fixed !important; left: var(--dock-x) !important; top: var(--dock-y) !important; right: auto !important; bottom: auto !important;
2883
+ width: var(--dock-w) !important; height: var(--dock-h) !important; min-width: 0 !important; min-height: 0 !important;
2884
+ max-width: none !important; max-height: none !important; transform: none;
2885
+ }
2886
+ #windows > .mon-docked.collapsed { width: auto !important; height: auto !important; max-width: 280px !important; }
2887
+ #windows .fl-rz { display: none !important; }
2888
+ #windows .sw-head, #windows .pw-head, #windows > #following.talking > .fl-strip { cursor: default; }
2889
+ /* the review strip at the board's top left, beside the selection bar under the modes */
2890
+ #lensbar, #tm-kept { left: calc(var(--inset-left, 0px) + 12px); transform: none; max-width: calc(100vw - var(--inset-left, 0px) - 448px); }
2891
+ /* the legend and the zoom's box at the foot of the board's room */
2892
+ #foot { left: 320px; bottom: var(--mon-room-bottom, 12px); transition: bottom 0.32s cubic-bezier(0.2, 0.9, 0.25, 1); }
2893
+ #zoom { right: 12px; bottom: var(--mon-room-bottom, 12px); transition: bottom 0.32s cubic-bezier(0.2, 0.9, 0.25, 1); }
2894
+ #welcome, #whatsnew, #following:not(.talking) { bottom: calc(var(--mon-room-bottom, 12px) + 40px); }
2895
+ /* the splitters: the work area's top, between the panel and the column, between two windows */
2896
+ .mon-split { position: fixed; z-index: 36; touch-action: none; }
2897
+ .mon-split-y { cursor: ns-resize; }
2898
+ .mon-split-x { cursor: ew-resize; }
2899
+ .mon-split::after { content: ""; position: absolute; border-radius: 3px; background: var(--text-3); opacity: 0.45; transition: opacity 0.15s, background 0.15s; }
2900
+ .mon-split-y::after { left: calc(50% - 22px); width: 44px; top: 2px; height: 4px; }
2901
+ .mon-split-x::after { top: calc(50% - 22px); height: 44px; left: 2px; width: 4px; }
2902
+ .mon-split:hover::after, .mon-split.on::after { opacity: 1; background: var(--accent); }
2903
+ }
2904
+ .mon-split { display: none; }
2905
+ @media (min-width: 1000px) and (max-aspect-ratio: 5/6) and (pointer: fine) { .mon-split:not([hidden]) { display: block; } }
@@ -53,7 +53,7 @@ What you look at; fields left out keep their value. MCP: `view` (action `move`,
53
53
  | `source` | `true`: the source window open on `sel` |
54
54
  | `paper` | the reference window, for followers: `{"link": "<id>"}` (its file at its place, lit) or `{"file": "<sha256>", "page": 3}`; `null` closes ([library](library.md)) |
55
55
  | `focus` | your own focus on the view: a target's full name; `null`/`"none"`: none; `false`/`"view"`: the view's own. Followers take it. Each view starts you on its own |
56
- | `leave` | `true`: done. Without a token you leave the list until your next request; with one you stay listed while it is in force, view cleared, offline until you wait or request again. Answer `{ok, left: true}` |
56
+ | `leave` | `true`: done. Without a token you leave the list until your next request; with one you stay listed while it is in force, view cleared, offline until you wait or request again. Answer `{ok, left: true}`; `left: false` where your `X-VisualProof-Session` is not the one that waited last (a newer session listens: it stays) |
57
57
 
58
58
  A click on your initials follows you: the page goes to your view (in a new tab) and tracks your
59
59
  selection, what you light up and the source window. The answer says what they see:
@@ -29,7 +29,7 @@ Under `/api/agent/`. MCP: `library` (`list`, `file`, `save`, `text`, `search`, `
29
29
  | `GET library/file?sha=` | a file's record and every link into it |
30
30
  | `GET library/bytes?sha=` | the file (MCP `save` writes it to a path you give) |
31
31
  | `GET library/text?sha=&page=` | a PDF page: `text`, `words` (`[text, left, top, right, bottom]`), `lines` (each line's start among the words), `pages`, `size` in points |
32
- | `GET library/search?sha=&q=&limit=` | every match of `q` in the PDF (case and line breaks loosely): `page`, `boxes` of its words, `text`, `before`, `after` |
32
+ | `GET library/search?sha=&q=&limit=` | every match of `q` in the PDF (case, line breaks, curly quotes and dashes loosely): `page`, `boxes` of its words, `text`, `before`, `after` |
33
33
  | `GET library/page?sha=&page=&width=` | the page as a PNG, 400, 800, 1200 (default), 1600 or 2000 px wide (MCP `page`: as an image) |
34
34
  | `GET library/clip?sha=&page=&region=&width=` | a region as a PNG, `region=left,top,right,bottom` |
35
35
  | `GET links?subject=&file=` | a subject's or a file's links, in the order made; all without either |
@@ -12,7 +12,9 @@ that describe the API itself. The rules are in the [index](README.md).
12
12
  - **A server that lets in only those given its link** (`--access-key-file`) answers 404 to
13
13
  everything, `/api/agent` included, unless the request carries `Authorization: Bearer <key>` (the
14
14
  key is the last part of the link you were given, `…/k/<key>`) or an agent token of its own,
15
- `Authorization: Bearer vpa_…`.
15
+ `Authorization: Bearer vpa_…`. **A server without a key** answers only its IP addresses,
16
+ `localhost` and the names it was given (`--public-url`, `--allowed-host`): another name is 403,
17
+ in plain text — use the address your prompt gives.
16
18
  - Every answer is JSON — but the documentation, the MCP server's file and install text, and the
17
19
  files you download. **Every error
18
20
  is `{error, hint}`**: what went wrong and what to do. A name that does not exist answers 404 with
@@ -55,7 +55,7 @@ part (`list` for `GET views`, `read` for `views/view`).
55
55
  | `GET views/view?id=&mode=&members=` | — | scope; holdings `{project, outside}`; items `{add, remove}` (project notes added, taken out: `{id, text}`; `all: true` on the Project); folds; `hidden`; pins; clusters as laid out (`key, depth, count, r, parent, room, at, pinned`), in its own coordinates. `members=1`: its declarations (≤ 5,000) |
56
56
  | `POST views/open {scope, version?, clustering?, focus?}` | — | the view on that query (the open one with the same scope and build, or a new unkept one); you are on it: `{view, holds, note}`. `version`: a snapshot id (`null`, `0`, left out: latest); `clustering`, `focus` (the target it is made from): a new one's |
57
57
  | `POST views/create {name, scope?, clustering?, from?, version?}` | full | a kept, named view on a scope, or a copy of `from` (scope, clustering, pins, folds, items — on the Project, every note its scope would not give, as added — and build; with `scope`, that scope arranged as `from`); `version` keeps it at a build (the Time Machine's Save as new view), `null`/`0` latest |
58
- | `POST views/scope {id, scope}` | full | change what it holds (those on it are told) |
58
+ | `POST views/scope {id, scope}` | full | change what it holds (those on it are told); not the Project, which holds everything (400) |
59
59
  | `POST views/items {id, add?, remove?}` | full | project notes (by id) added or taken out: on the add list only where the scope does not give it, the remove list only where it does. Not the Project (400; deleting is [`note/delete`](notes.md)); 404 for no project note. An Activity event, as a scope change: `{ok, changed, view, items: {add, remove}, notes: [{id, shown}]}` |
60
60
  | `POST views/focus {id, focus}` | full | the view's own focus: a target's full name, or `null`/left out; personal focuses stay: `{ok, changed, view}` |
61
61
  | `POST views/link {id, target}` | full | link a target (a view with targets takes another; an unkept one becomes kept); not the Project, nor a view at a past build (409): `{ok, changed, view, left?}`, `left` the view it leaves |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "visualproof",
3
- "version": "0.4.2",
3
+ "version": "0.4.4",
4
4
  "type": "module",
5
5
  "description": "See a Lean codebase's declaration graph and the TCB of its theorems.",
6
6
  "license": "Apache-2.0",