@aiquants/markdown-explorer 0.33.0 → 0.34.0
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 +280 -0
- package/README.md +31 -18
- package/dist/{EditSurface-BPqqykro.cjs → EditSurface-CF82jZQg.cjs} +5 -5
- package/dist/{EditSurface-CWq35IWQ.js → EditSurface-CqHk2R3k.js} +73 -63
- package/dist/ExplorerSplit-D325YGEf.cjs +1 -0
- package/dist/ExplorerSplit-DGH9bckm.js +1500 -0
- package/dist/MultiLayout-CzR7yJ0m.cjs +1 -0
- package/dist/{MultiLayout-DYNGlNy0.js → MultiLayout-kcZyVnvK.js} +176 -176
- package/dist/NativeScrollBar-UNed10Na.js +62 -0
- package/dist/NativeScrollBar-pUbA4Zq3.cjs +1 -0
- package/dist/TreeLayout-BnIU87HX.js +96 -0
- package/dist/TreeLayout-DtvIpuOe.cjs +1 -0
- package/dist/core/geometry.d.cts +1 -0
- package/dist/core/geometry.d.ts +1 -0
- package/dist/core/labels.d.cts +10 -0
- package/dist/core/labels.d.ts +10 -0
- package/dist/core/location.d.cts +2 -0
- package/dist/core/location.d.ts +2 -0
- package/dist/core/viewSettings.d.cts +2 -0
- package/dist/core/viewSettings.d.ts +2 -0
- package/dist/{dataRoute-DLhQfdoW.js → dataRoute-D6KiSHIc.js} +20 -20
- package/dist/index-BDCbvHDs.cjs +15 -0
- package/dist/{index-CO-RgTml.js → index-DR31S_-4.js} +2029 -1929
- package/dist/index.cjs +1 -1
- package/dist/index.js +17 -17
- package/dist/{location-perTmwct.js → location-C44b9H1S.js} +291 -278
- package/dist/location-hGLhCCg4.cjs +1 -0
- package/dist/{merge-DZI4pkWI.cjs → merge-BziXxZkE.cjs} +1 -1
- package/dist/{merge-D7L_pINl.js → merge-C1MWvhCS.js} +1 -1
- package/dist/{sanitizePolicy-By0tKOpZ.js → sanitizePolicy-CwvyPpp5.js} +1 -1
- package/dist/sanitizeWorker.js +1 -1
- package/dist/server.cjs +1 -1
- package/dist/server.js +4 -4
- package/dist/styles/markdown-explorer.css +1 -1
- package/dist/tapScrollCircle-D_BpaLwY.js +14 -0
- package/dist/tapScrollCircle-DigcJCsu.cjs +1 -0
- package/dist/useSplitPersistence-DCeYbJMx.js +38 -0
- package/dist/useSplitPersistence-QGcvyMAa.cjs +1 -0
- package/docs/behavior/dom-hooks.md +12 -3
- package/docs/behavior/layout.md +64 -16
- package/docs/behavior/localization.md +4 -3
- package/docs/behavior/security.md +2 -1
- package/docs/behavior/url-contract.md +11 -5
- package/package.json +11 -11
- package/dist/ExplorerSplit-BRY4uy6x.js +0 -1493
- package/dist/ExplorerSplit-CQxr6b0v.cjs +0 -1
- package/dist/MultiLayout-TXbet9k3.cjs +0 -1
- package/dist/NativeScrollBar-BsWdvkHa.js +0 -64
- package/dist/NativeScrollBar-UpjxjLlB.cjs +0 -1
- package/dist/TreeLayout-BQEgZhz9.js +0 -72
- package/dist/TreeLayout-C0O1OGi4.cjs +0 -1
- package/dist/index-DSkK8iLE.cjs +0 -15
- package/dist/location-BxiJRTyw.cjs +0 -1
- package/dist/tapScrollCircle-CRKZremf.js +0 -12
- package/dist/tapScrollCircle-Cbf17x8g.cjs +0 -1
- package/dist/useSplitPersistence-Du01PHNg.js +0 -42
- package/dist/useSplitPersistence-pPmE4GTT.cjs +0 -1
package/docs/behavior/layout.md
CHANGED
|
@@ -6,9 +6,10 @@ This page is part of the host-facing contract of `@aiquants/markdown-explorer`;
|
|
|
6
6
|
|
|
7
7
|
The explorer fills its container's block size, so the container needs a definite block size: for example `height: 100dvh`, or a flex column of definite height whose item has `flex: 1` and `min-height: 0` (in a fresh React Router app, with `html` and `body` at `height: 100%`).
|
|
8
8
|
A container whose block size is auto or only a minimum (`html` and `body` at their default auto height included) does not size the explorer: the areas that fill the leftover height collapse to 0 px, or the explorer grows with its content, depending on the host's structure.
|
|
9
|
+
The explorer takes its inline size from its container too, never from its content: the split's frame is a size container in the inline axis (it lays itself out from its own width, from the first paint), so a container that shrinks to fit its content — an absolutely positioned or fixed box without a width, `width: fit-content` or `max-content`, a float, an `auto` grid track with `justify-content: start` — sizes the explorer to 0 px. Give such a container a width; a block container and a stretched flex or grid item already have one.
|
|
9
10
|
With `lockDocumentScroll` the explorer must fill a container of definite block size inside the viewport: while the page is locked it logs one `console.error` per mount — checked once the layout has settled, when the explorer's root and the window have kept their size for one second after the mount or after the last resize of either — naming either the overflow (the explorer ends more than 1 px below the viewport) or the collapse (its root, the document region of the tree or single view, or the explorer's tree area is rendered but less than 1 px tall), and what to give the container.
|
|
10
11
|
A resize can pass through intermediate viewports before it ends (switching Chrome DevTools' device toolbar between a desktop and a phone size does), and one shorter than the host's own bars collapses the explorer for a moment; the explorer is judged only after the layout has settled, so such a moment is not reported, while a container without a definite block size, which keeps the explorer misplaced, still is.
|
|
11
|
-
Only rendered parts are measured: a part with no layout box (`display: none` on it or an ancestor — a closed sheet, an explorer panel
|
|
12
|
+
Only rendered parts are measured: a part with no layout box (`display: none` on it or an ancestor — a closed sheet, an explorer panel a drag holds collapsed, an explorer the host hides) is hidden, not collapsed, and is never reported.
|
|
12
13
|
|
|
13
14
|
## The split
|
|
14
15
|
|
|
@@ -23,19 +24,37 @@ The tree and multi-panel views split the frame into the explorer and the content
|
|
|
23
24
|
| Sheet threshold | 13rem × φ² (≈ 544.6 px at a 16 px root) | Below it the minimum explorer would pass the golden section, so the explorer leaves the split and opens as a sheet |
|
|
24
25
|
| Handle | A band 24 px wide under a fine pointer and one control wide, 44 px, under a coarse one (`(pointer: coarse)`); a 5 × 34 px grip around a 2 × 21 px bar | WCAG 2.2 target size (minimum for a fine pointer, which keeps the handle thin, and enhanced for a coarse one); the arrow keys move the handle as well. The band itself is the target, and each side keeps half of it clear (below): a wider invisible hit area would cover the tree's scroll bar beside it. The grip is Fibonacci |
|
|
25
26
|
|
|
26
|
-
- The root font size is measured in the browser (through a 1rem probe, so a text-only zoom is followed as well)
|
|
27
|
-
- The server
|
|
27
|
+
- The root font size is measured in the browser (through a 1rem probe, so a text-only zoom is followed as well).
|
|
28
|
+
- The server knows neither the frame's width, nor the root font size, nor the pointer, so it renders the split with the explorer open beside the content (or closed to its rail, by the display settings), and the frame carries `data-aqmx-measured="false"` until the first layout after hydration has measured it. Meanwhile the stylesheet lays the frame out as the measure will, from the frame's own width (a container query in rem, so the reader's font size counts as well):
|
|
29
|
+
narrower than 13rem × φ², the explorer, its handle and the rail are hidden, the content takes the whole width, the tree view's document bar wears the sheet bar's look with the toggle's lane at its start, and a frame without that bar keeps one bar's room above the split, where the sheet's bar comes; wider, the explorer keeps its 13rem floor.
|
|
30
|
+
The handle's band (below) follows `(pointer: coarse)` in the stylesheet (`--aqmx-split-handle-size`). So the explorer, the rail, the content's panel and the document bar keep their places when the page hydrates; only the handle, which takes no room, widens then under a coarse pointer.
|
|
31
|
+
The document viewer keeps its text in place too: its bar's slot is as wide as the bar from the first paint (`--aqmx-scroll-bar-slot-size`: 8 px under a fine pointer, 0 under a coarse one, where the bar lies over the text's end), though the bars' module loads only after the page, and a viewer that starts its region reserves the band its toolbar covers before it measures the toolbar (see the toolbar under [The document region](#the-document-region)), so the text neither narrows when its bar appears nor moves down when the toolbar is measured.
|
|
32
|
+
The tree's bar, which the server draws for a fine pointer (with its arrows and an always-shown circle), stays hidden in its place under a coarse pointer until hydration draws it without them (below).
|
|
28
33
|
- The handle takes no room of its own: it lies over the boundary, half on each side, and each side keeps that half clear (the explorer ends, and the content starts, half the band away from the boundary), so the band covers neither the tree's scroll bar nor the content's edge.
|
|
29
34
|
- At 1920 px, with a 16 px root and a fine pointer, the tree view gives the explorer 1920/φ³ ≈ 453.3 px, 12 px of which it keeps clear beside the 24 px handle. The multi-panel view gives it 1920/φ⁴ ≈ 280.1 px and the stage ≈ 1639.9 px; less the 12 px it keeps clear and 13 px of padding at each side, the column track is ≈ 1601.9 px,
|
|
30
35
|
so the stage shows ⌊(1601.9 + 13) / (384 + 13)⌋ = 4 columns of (1601.9 − 3 × 13) / 4 ≈ 390.7 px, each wider than the 40ch measure (≈ 384 px with a common UI font, whose `0` is about 0.6em wide). At 1280 px the multi-panel explorer stays at its 13rem floor (1280/φ⁴ ≈ 186.7 px is less than 208 px) and the stage shows two columns.
|
|
31
36
|
- The reader's width is remembered per view, as a percentage of the split, in the display-settings cookie (see [URL contract](url-contract.md#display-settings)). It is written only after the reader moves the handle — at the end of a drag, or when the arrow keys are released (or the handle loses focus) after they moved it, 233 ms later in both cases — never because the window was resized, so a narrow window does not overwrite the width chosen on a wide one.
|
|
32
|
-
- The handle is a focusable `separator` (named by `resizeExplorer`) from `@aiquants/resize-panels`: Left and Right move it by 10 px (50 px with Shift), pressing past the minimum
|
|
37
|
+
- The handle is a focusable `separator` (named by `resizeExplorer`) from `@aiquants/resize-panels`: Left and Right move it by 10 px (50 px with Shift), and pressing past the minimum closes the explorer (see [Closing the explorer](#closing-the-explorer)), which its rail opens again at its previous width. Only keys that moved the handle by the time they were released count as the reader's choice.
|
|
38
|
+
|
|
39
|
+
## Closing the explorer
|
|
40
|
+
|
|
41
|
+
In the tree and multi-panel views the reader can close the explorer, which gives the content the whole frame but a rail:
|
|
42
|
+
|
|
43
|
+
- Three ways lead to the same closed state: the close button at the end of the explorer's first line, where the sheet has its own (named by `hideExplorer`, «Close the explorer» / 「エクスプローラーを閉じる」, a 44 px target under every pointer); the handle dragged to the split's edge and released there (dragged back before the release, the explorer stays open; while the drag holds it collapsed it stays mounted but is not displayed, so its tree lists nothing); and the arrow keys pressed past the minimum.
|
|
44
|
+
- Closed, the explorer and its handle leave the split, and a rail 55 px wide (`--aqmx-space-9`: the sheet's bar turned 90°, a 44 px toggle between 5 px of padding on each side, and a 1 px border) holds the explorer's side. Its toggle (named by `showExplorer`, with `aria-expanded="false"`) opens the explorer again at the width the reader last chose.
|
|
45
|
+
- The choice is remembered per view in the display-settings cookie (`treeExplorerHidden`, `multiExplorerHidden`; see [URL contract](url-contract.md#display-settings)), so the server renders the rail on the first paint and a reload keeps it. Below the sheet threshold the explorer is a sheet, which starts closed whatever the choice says; widening the frame out of the sheet follows the choice.
|
|
46
|
+
- Focus on the explorer's side follows the explorer: closing it moves the focus to the rail's toggle, and opening it moves the focus to the explorer's close button, so a round trip returns to the button pressed first; with the explorer closed, crossing the sheet threshold moves the focus between the rail's toggle and the sheet's toggle. Focus in the content stays where it is.
|
|
47
|
+
- While a maximized panel or document covers the page, the rail is inert, like the rest of the explorer's side.
|
|
33
48
|
|
|
34
49
|
## The sheet on narrow frames
|
|
35
50
|
|
|
36
51
|
When the frame is narrower than 13rem × φ² — a phone, or a narrow window — the explorer leaves the split:
|
|
37
52
|
|
|
38
|
-
- The content takes the whole width under a bar with a visible toggle (named by `showExplorer`, a 44 px target under every pointer, with `aria-haspopup="dialog"`, `aria-expanded` and `aria-controls`). It stays mounted across the change, so the document keeps its scroll position and focus.
|
|
53
|
+
- The content takes the whole width under a bar 55 px high (`--aqmx-space-9`: a 44 px control between 5 px of padding, and a 1 px border) with a visible toggle (named by `showExplorer`, a 44 px target under every pointer, with `aria-haspopup="dialog"`, `aria-expanded` and `aria-controls`). It stays mounted across the change, so the document keeps its scroll position and focus.
|
|
54
|
+
- In the tree view, while a document is shown, the sheet's bar and the document's bar are one bar: the sheet's bar lies over the start of the document's bar (`data-aqmx-sheet-bar-merged="true"` on the sheet's bar), and the document's bar takes the sheet's look —
|
|
55
|
+
its height, border and surface, and its labelled buttons (Source, Edit, Refresh document and the editor's controls) showing their icons only, their labels kept as their accessible names beside the tooltips they always have — with a lane at its start that the toggle lies over (`data-aqmx-sheet-bar="merged"` on the document's bar).
|
|
56
|
+
Both bars keep their places in the DOM, so the toggle stays the same element, first in the Tab order, with the same name; while the bars are one it shows its label as its tooltip. The empty state and a folder without a README have no document bar, and the sheet's bar stands alone above the content.
|
|
57
|
+
While the document is maximized (see [The maximized document](#the-maximized-document)) the document's bar keeps the sheet's look without the lane (`data-aqmx-sheet-bar="covering"`), since the toggle lies inert under the cover, so nothing below the bar moves when the document is maximized or restored. A multi-view panel's bar never takes the sheet's look.
|
|
39
58
|
- The toggle opens the explorer as a modal sheet over the content: a native `dialog` named by `explorerRegion`, at most 21rem wide (13rem × φ ≈ 21rem) and leaving 3.4375rem of the content visible beside it (55 px at 16 px text, 110 px at 200 %). The sheet has no header row of its own: its close button (named by `hideExplorer`, 44 px under every pointer) sits at the end of the explorer's first line, beside the source switch, or beside the header's actions when there is one source; that line leaves it the room and takes its height.
|
|
40
59
|
Focus moves to the close button, and the rest of the page is inert while it is open — the explorer's root live region included, so the sheet holds a live region of its own that speaks the explorer's announcements while it is open (see [Announcements](#announcements)).
|
|
41
60
|
- Escape, the close button, a press on the backdrop that also started there (a press that starts inside the sheet and is released over the backdrop does not close it) and any navigation that keeps the tree's source (choosing a document, opening a selection) close it, and focus returns to the toggle. Switching the source keeps it open.
|
|
@@ -44,6 +63,19 @@ When the frame is narrower than 13rem × φ² — a phone, or a narrow window
|
|
|
44
63
|
- Focus on the explorer's side (the tree, the handle, the toggle or the open sheet) is handed over when the mode changes: to the sheet's toggle when the frame narrows past the threshold; when it widens past it, once the rebuilt tree has drawn its rows, to the tree row the reader was on (found by its path in the rebuilt tree), else the tree's tab-stop row, else the tree's stand-in stop (see [The tree](#the-tree)), which brings that row into view and hands it the focus, else the handle.
|
|
45
64
|
The row is remembered from the reader's own focus moves only, so a round trip (split, sheet, split) without touching anything returns to the same row, while a later focus move by the reader (opening the sheet, say) replaces it. A row the rebuilt tree has not rendered (far down a long tree) falls back to the tab-stop row. The row that takes the focus becomes the tree's only Tab stop, so Shift+Tab from it leaves the tree at once. Focus elsewhere stays where it is.
|
|
46
65
|
|
|
66
|
+
## The maximized document
|
|
67
|
+
|
|
68
|
+
In the tree view the document can take the whole page:
|
|
69
|
+
|
|
70
|
+
- The document's bar ends with Maximize, icon-only and named and titled for what a press does: `documentMaximize` («Maximize the document» / 「文書を最大化」), and while the document is maximized `documentRestore` («Restore the document to its size» / 「文書を元のサイズに戻す」). Its name says what the next press does, so it carries no pressed state, and it is the same element in every state, reading or editing, so the focus stays on it. The single view, whose frame is the page already, and a multi-view panel, which its header maximizes, have no such button.
|
|
71
|
+
- A press replaces the URL with the same location maximized (`maximized=true`) or restored, without a new history entry, keeping the scroll and leaving the fragment behind, so a reload, a shared link and Back and Forward keep it (see [URL contract](url-contract.md#shape)). It reads nothing again and renders no document anew.
|
|
72
|
+
Each press is announced (`documentMaximized`, `documentRestored`, named after the last segment of the shown document's path, or of the folder's whose README shows), because the button's name changes under the focus, which assistive technology does not reliably speak.
|
|
73
|
+
- Maximized, the document's column (`data-aqmx-maximized="true"`) covers the page inside the explorer's maximize insets (`--aqmx-maximize-top`, `-right`, `-bottom` and `-left`, 0px by default), the insets a maximized panel covers inside as well, so a host binds one set for both views; the split's frame carries `data-aqmx-content-covers-page="true"`, and the explorer's side underneath — the explorer and its handle, the rail, or the sheet's bar — is inert. The host's own chrome is not the explorer's to make inert, as for a maximized panel (see [The multi-panel stage](#the-multi-panel-stage)).
|
|
74
|
+
- Escape restores the document by the rule a maximized panel's Escape follows: an Escape another handler marked handled (`preventDefault()`), one that belongs to an input method's composition, and one the browser turns into a close request for a layer above the page (while a modal dialog — a block's full screen among them —, a non-modal dialog whose `closedby` takes close requests or a popover the browser closes on Escape is open) are left alone, and the Escape it uses is marked handled. An Escape pressed inside a document's table, diagram or image block
|
|
75
|
+
restores the document: a block keeps its toolbar in a non-modal dialog that the browser leaves open on Escape.
|
|
76
|
+
- The column covers the page while there is a document to show, its failure view included, and while a maximized folder looks for its README, so a maximized address never flashes the explorer while it loads; a folder without a README to show, and the empty state, have no bar and cover nothing.
|
|
77
|
+
- The maximize stays with the document through a source switch, the reveal's move to the source that holds the document, and the document links and table-of-contents entries it follows, which read it at the moment of the click (their hrefs never carry it, so a maximize renders no link anew); a pick in the tree shows the next document at its size.
|
|
78
|
+
|
|
47
79
|
## The tree
|
|
48
80
|
|
|
49
81
|
- **One Tab stop.** The tree is one stop in the Tab order: the row the reader last focused — with the keyboard, a press or a script — while it holds the focus or as long as the shown document has not changed since, else the shown document's row, else the first row (`@aiquants/directory-tree`'s roving tab index). Shift+Tab from any row leaves the tree, and Tab comes back to the same row. While that row is outside the tree's render window (far down a long tree, or at a large text size), the tree puts a stand-in stop in its place, outside the `tree` role (`data-directory-tree-tab-stop`):
|
|
@@ -52,14 +84,16 @@ When the frame is narrower than 13rem × φ² — a phone, or a narrow window
|
|
|
52
84
|
- **The shown document's row.** In the tree view, with Selection set to Single or Multiple, the shown document's row carries `aria-current="page"` (none with Selection Off, and none in the multi view, whose open panels are the selected rows). While the reader gathers documents (Multiple), the gathered rows carry `aria-selected="true"` and the current row moves with the shown document alone.
|
|
53
85
|
On load, and whenever the shown document changes while the focus is outside the tree (a document link, Back or Forward), its row is brought into the tree's view by the least distance, without moving the focus, and kept there whenever the tree's area changes size (the explorer's layout settling, the tray growing or shrinking, the sheet opening on a tree it hid) until the reader presses, wheels, touches, types or moves the focus inside the tree.
|
|
54
86
|
A row the tree does not list (inside a collapsed folder) is left alone, and a document opened from the tree does not move the tree: the pressed row stays where it was, also when it was only partly visible.
|
|
87
|
+
- **The first row it showed.** While a tree is away — the explorer closed, the sheet closed, or the frame between the split and the sheet — the split keeps, per source, the row the tree showed first and how far that row was hidden above the tree's top, and the tree it rebuilds starts there, at the same height, from its first paint (`@aiquants/directory-tree` applies the expansion from the first render of a mount, so a row inside an open folder is in the list the tree starts from). The shown document's row then moves the tree only when it lies outside the
|
|
88
|
+
tree's view (see the previous item). The split keeps the rows while it is mounted, so a reload starts the tree afresh.
|
|
55
89
|
- **Loading follows what is shown open.** A lazy folder's listing is asked for while some tree shows the folder open, whatever opened it, at most 4 at a time per explorer. Bulk work — Expand all, a remembered expansion restored on load, a recursive double click — uses at most 3 of them, so a folder the reader opens (a click, Enter or ArrowRight) or retries goes ahead of every queued bulk listing and starts at once on the slot kept for the reader, unless another folder the reader opened is using it (a listing in flight is never interrupted).
|
|
56
90
|
Each source has its own queues and the sources are served in turn, so one source's bulk work never holds back another's.
|
|
57
91
|
Queues follow the order on screen (the tree's sort order), not the source's listing order.
|
|
58
92
|
A listing no tree wants any more is cancelled when the current task ends — a queued one is never sent, one in flight is aborted and frees its slot at once — and the folder goes back to not loaded: no failure, no Try again, no announcement and no loading pulse (`data-aqmx-children="loading"` is left only on folders some tree still wants).
|
|
59
|
-
That happens when the reader collapses the folder or one of its ancestors, uses Collapse all (at the click), switches the source, closes the sheet or
|
|
93
|
+
That happens when the reader collapses the folder or one of its ancestors, uses Collapse all (at the click), switches the source, closes the sheet or the explorer, or holds the explorer panel collapsed in a drag, when the explorer or the pane unmounts, and when a refresh, a seed or a reader change replaces the tree (a refresh lists the folders still shown open again). Opening the folder again asks for it again. Nothing is listed while the explorer is mounted but hidden (a closed sheet, an explorer panel a drag holds collapsed), not even on its first render.
|
|
60
94
|
- **Expand all.** Each press opens every folder and keeps opening the folders inside as their listings land, until the tree is fully open or the press's budget (`expandAll` in the configuration) runs out: at most `maxFolders` listings (500 by default), and a folder whose contents are not known yet only down to `maxDepth` levels (16 by default, the top level being 1). Folders whose contents are known — loaded, or listed by the source up front — always open, as do folders loading or failed.
|
|
61
95
|
A press walks the tree level by level, siblings in the tree's order, so its bulk listings run roughly level by level (a listing that lands early can let a deeper level start while a slower, shallower one is still in flight).
|
|
62
|
-
A folder the reader closes during a press stays closed, and the press does not walk into it. The folders a press opened join the tree's remembered expansion (per source, in browser storage), so a reload lists them again as bulk work, without opening anything beyond them and without an announcement. Hiding the explorer pauses a running press, which continues once the explorer is shown again;
|
|
96
|
+
A folder the reader closes during a press stays closed, and the press does not walk into it. The folders a press opened join the tree's remembered expansion (per source, in browser storage), so a reload lists them again as bulk work, without opening anything beyond them and without an announcement. Hiding the explorer (the sheet closed, or its panel held collapsed by a drag) pauses a running press, which continues once the explorer is shown again; closing the explorer removes its pane and ends the press with it, as a view switch does;
|
|
63
97
|
Collapse all, a source switch and a tree with no rows to show (failed, empty or cleared) end it silently.
|
|
64
98
|
While a change of the expansion is pending (folders open and close in a React transition), the tree is marked busy (`aria-busy` on the tree) and shows the progress cursor, and nothing in it is dimmed. A running press does not mark it: each level's change would make the mark and the cursor flicker, and the progress line tells the press's progress instead.
|
|
65
99
|
- **Progress line.** While the source has listings queued or in flight, a line floats at the bottom of the tree area, over the rows and clear of the scroll buttons and the scroll bar, without moving the tree (`markdown-explorer-tree-progress`): "Loading 12 folders…", or "Opening all folders (40 opened, 12 loading)…" during a press. After a press stopped at a limit it shows the loading count alone while listings remain and nothing once none does; it never shows the stop sentence, which would cover the last rows until the next press (see the stop notice below).
|
|
@@ -125,9 +159,9 @@ Documents in the multi-panel view sit in `multiView.columns` logical columns (4
|
|
|
125
159
|
A panel that a pick opened or showed is then brought into the stage's view by the least distance, without moving the focus (a pick in the split leaves the focus on the tree row, so the reader keeps picking): in a crowded stage it would otherwise sit below the fold, where the pick changes nothing the reader sees and a second click on the same row closes a panel they never saw.
|
|
126
160
|
A panel is always brought into view whole — its header with the title and buttons, and its body — and kept there, with the focus a restore left in it, while the stage settles around it (its own document arriving, an image loading in a panel above it once the scroll brought that panel near, the restored document's text wrapping again), until the reader's next key, press, wheel or touch anywhere on the page, or until the stage, the panel's scroll area or the page is scrolled to a place these reveals did not leave it at (assistive technology's browse mode,
|
|
127
161
|
the browser's find bar or a script moved it). Meanwhile scroll anchoring is off in the scroll containers around what is kept (`overflow-anchor: none`, restored when the keeping ends): the browser's adjustment holds a node of its own choosing, and it would be such a scroll.
|
|
128
|
-
- **Maximized panels.** A maximized panel covers the stage and the explorer, and everything of the explorer it covers is inert until it is restored: the explorer makes its own side inert — the explorer and its handle (or, in sheet mode, the sheet's bar) — and drag-drop-panels everything else it renders — the other panels, the bar of hidden panels, the drop placeholders and its announcer. Tab and Shift+Tab therefore never land on the explorer's hidden controls, and Enter or Space never acts on one.
|
|
129
|
-
The host's own chrome is not the explorer's to make inert: what the panel covers of it stays focusable, so a host binds
|
|
130
|
-
Escape restores the panel only when nothing else used the key: drag-drop-panels ignores an Escape another handler marked handled (`preventDefault()`), one that belongs to an input method's composition, one
|
|
162
|
+
- **Maximized panels.** A maximized panel covers the stage and the explorer, and everything of the explorer it covers is inert until it is restored: the explorer makes its own side inert — the explorer and its handle (the rail while the reader closed the explorer, or, in sheet mode, the sheet's bar) — and drag-drop-panels everything else it renders — the other panels, the bar of hidden panels, the drop placeholders and its announcer. Tab and Shift+Tab therefore never land on the explorer's hidden controls, and Enter or Space never acts on one.
|
|
163
|
+
The host's own chrome is not the explorer's to make inert: what the panel covers of it stays focusable, so a host binds the explorer's maximize insets to keep its chrome uncovered — `--aqmx-maximize-top`, `-right`, `-bottom` and `-left` (0px by default), which the stage hands to drag-drop-panels' `--aqdd-maximize-*` and which the tree view's maximized document reads too (the demo binds `--aqmx-maximize-top` to its header) — or makes it inert while the maximized panel's frame, or the tree view's maximized document column, carries `data-aqmx-maximized="true"` (see the README's "Load the styles").
|
|
164
|
+
Escape restores the panel only when nothing else used the key: drag-drop-panels ignores an Escape another handler marked handled (`preventDefault()`), one that belongs to an input method's composition, and one the browser turns into a close request for a layer above the page (a modal dialog, a non-modal dialog whose `closedby` takes close requests, or a popover it closes on Escape); one pressed inside a document's block restores the panel.
|
|
131
165
|
Every Escape the explorer handles is marked so — closing the sheet or the tree settings menu (it also stops there, so the explorer's outer handlers never see it) — and so is every Escape the document viewer handles: in a maximized panel, the first Escape in the viewer's open table of contents, style or alignment menu closes the menu, returns the focus to its button and keeps the panel maximized, and the next Escape restores the panel.
|
|
132
166
|
This holds in framework mode as well, where React's root listener sits on the document itself: the mark, not the propagation, is what the page's later listeners read, so a host's own Escape listener on the document honours it by checking `defaultPrevented`.
|
|
133
167
|
- **Panel limit.** A pick beyond `multiView.maxPanels` opens nothing; the announcer says `panelLimit` once and a visible notice appears for three seconds where the reader made the pick.
|
|
@@ -181,6 +215,8 @@ Documents in the multi-panel view sit in `multiView.columns` logical columns (4
|
|
|
181
215
|
A block `@aiquants/markdown` shows full screen — a ```spreadsheets table, a Mermaid diagram or a storage SVG image alone in a paragraph, each from the full-screen toggle that ends its toolbar — becomes a modal dialog over the page, named for full screen (see [Localization](localization.md)), which no pane or panel clips, and carries `data-aqmd-fullscreen` while it is.
|
|
182
216
|
Everything inside it is then the block's: a double-click there neither opens the editor nor maximizes the panel behind it, the editing surface leaves its keys alone (see **Editing a Markdown document** below), and Escape leaves full screen without restoring a maximized panel.
|
|
183
217
|
Where the toolbar covers the inline extent of the document's content — in the tree view and a maximized panel at every width, where the content spans the pane, and in the single view unless its `width` or `maxWidth` leaves room beside the content — the viewer reserves the depth it covers as the top padding and the `scroll-padding-block-start` of its scroll container and publishes it as `--aqmd-toolbar-block-overlap` on `[data-aqmd-scroll-container]`: the first line and every fragment's element start below the buttons. Where the toolbar covers none of the content the band is `0px`.
|
|
218
|
+
Until the viewer has measured its toolbar — in the server's render and until hydration — a viewer that is its region's first child (the progress line that may come before it lies outside the flow) opts in to the viewer's own reservation, `--aqmd-toolbar-reserve-before-measure: 1` on the viewer's frame: wherever the content spans the column (`[data-aqmd-toolbar-over-content]`)
|
|
219
|
+
the band is then the toolbar's inset plus its block size rounded up to a whole px, the depth the measure finds, so the first line does not move when the toolbar is measured. A viewer under a file header (a text file's), whose toolbar lies over the header, and a viewer given a `width` or `maxWidth` reserve nothing before the measure.
|
|
184
220
|
An open, unpinned menu of the toolbar (the table of contents, the style or the alignment menu) closes on Escape while the focus is inside it and returns the focus to its button; the viewer marks that keydown handled (`preventDefault()`). In a panel every part of the document (failure callout, image, media) takes its content height, and an embedded PDF is 1 : √2.
|
|
185
221
|
- A file header (the toolbar of an image, a medium, a text or a table file: its name, the zoom controls or Copy the text, Open in a new tab — for a text and a table file, the whole file as UTF-8 plain text, which a browser shows instead of downloading — and Download) wraps its controls onto more lines instead of letting any of them run out of the pane or the panel at a narrow width or a large text size; the name takes what the controls leave on the first line and is cut with an ellipsis.
|
|
186
222
|
- An image opens fitted to the pane (Fit pressed). Zoom in and Zoom out step through the levels 1/φ², 1/φ, 1, φ and φ² (≈ 38.2 %, 61.8 %, 100 %, 161.8 % and 261.8 %) of a base size — the image's natural size, or for an image without one the fitted size described below — and the level shown is a percentage of that base; from the fitted size they go to the nearest level above or below it.
|
|
@@ -202,7 +238,8 @@ Documents in the multi-panel view sit in `multiView.columns` logical columns (4
|
|
|
202
238
|
A raster image, a media, text or file document, a workbook (a spreadsheet document whose `format` is `workbook`: its bytes are no text) and a failure show no toggle, and neither does a document still loading, which gets it once it is there.
|
|
203
239
|
A table file's source is its CSV or TSV as written, read by the same rule as its table (a byte order mark's encoding, UTF-8 or the configured legacy encoding).
|
|
204
240
|
Pressing it shows the document as written instead of rendered, in place and without moving the focus from the toggle: the pane reads the document's file through the data route's `text` operation (only once the toggle is pressed) and shows the text the way it shows a text file — the file header with Copy the text, Open (the whole file as plain text in a new tab) and Download, the note `textTruncated` when the server cut the file at its `textMaxBytes`, and the text, which wraps and is never interpreted.
|
|
205
|
-
Copy the text (an icon button, `copyText`) puts the text on the clipboard exactly as read, line endings included, and is offered only for a text read whole, so a cut file is never copied in part (Download fetches it whole). The outcome is announced (`copiedText`, or `copyTextFailed` when the browser has no asynchronous clipboard — an insecure origin
|
|
241
|
+
Copy the text (an icon button, `copyText`) puts the text on the clipboard exactly as read, line endings included, and is offered only for a text read whole, so a cut file is never copied in part (Download fetches it whole). The outcome is announced (`copiedText`, or `copyTextFailed` when the browser has no asynchronous clipboard — an insecure origin —, refuses the write or has a clipboard that throws; the refused and the thrown write are also logged to the console) and shown for 2 seconds by the button's icon and tooltip, while its accessible name
|
|
242
|
+
stays the same; a second press counts the 2 seconds again, and only the latest press decides the outcome, so a late answer to an earlier press shows and announces nothing. The same button heads every text file.
|
|
206
243
|
Until the first answer the region shows a skeleton (`markupLoading` for screen readers); a failure before any text shows the failure callout, with Try again for a `failed` read, and is announced once (`documentFailed`), like a document's; a retry that succeeds moves a focus the swap dropped into the text and, in a page view, announces the document (`documentShown`), as the pane does for a document that replaces a failure.
|
|
207
244
|
Every new answer for the document — Refresh document, Refresh tree, a background revalidation — reads the text again, the previous text staying on screen meanwhile and the region busy (its progress line and `aria-busy`); a reading again that fails keeps the text: Refresh document reports it in the bar (see Document refresh), and a background answer's reading that fails says nothing, as a background failure under a loaded document does. The next press shows the document rendered again (an SVG image as the image).
|
|
208
245
|
The choice is part of the URL (`markup`, see the [URL contract](url-contract.md#shape)), written by replacing the entry: a reload, a shared link and Back and Forward show the document the same way, and the switches between the tree and multi views carry it for the document they open. It belongs to that document only: another document opens rendered, and the document still shown while the next one loads keeps the way it showed. The region tells which way a Markdown document, an SVG image or a table file shows with `data-aqmx-document-view` (`rendered` / `markup`).
|
|
@@ -264,7 +301,8 @@ A dialog's margin box's left is clamp((l′ + r′) / 2 − w / 2, 0, W − w),
|
|
|
264
301
|
|
|
265
302
|
## Switching views
|
|
266
303
|
|
|
267
|
-
The tree and multi-panel views are separate parts of the page, so the control a reader uses to switch between them leaves with the old view. Switching with the explorer's own controls keeps the keyboard focus in the explorer instead of dropping it to the page:
|
|
304
|
+
The tree and multi-panel views are separate parts of the page, so the control a reader uses to switch between them leaves with the old view. Switching with the explorer's own controls keeps the keyboard focus in the explorer instead of dropping it to the page:
|
|
305
|
+
the header's link to the other view hands the focus to the new view's link (the same place in the same header), or — below the sheet threshold, where that link sits in the new view's closed sheet — to the sheet's toggle, or — when the reader closed the new view's explorer, which leaves it no link — to the rail's toggle; the selection tray's Open in panels hands it to the first panel it opened.
|
|
268
306
|
The hand-over happens once the new view has rendered, also while its code is still loading. Whether the reader was still on the control is decided after the switch removed it, so the hand-over works whether or not the browser fires `focusout` when it removes the focused element (Chromium does). Focus that was anywhere else, that the reader let go of before the switch, or that the reader moved meanwhile stays where it is.
|
|
269
307
|
|
|
270
308
|
## Busy and unavailable controls
|
|
@@ -277,7 +315,7 @@ It has the server reload the source's tree and shows the tree the server answers
|
|
|
277
315
|
A reload that fails keeps the tree on screen and shows an alert first in the explorer's body (`treeRefreshFailed` with the failure's title, `data-testid="markdown-explorer-refresh-failure"`), until the next refresh starts and only while the pane shows that source. Switching to another source after a refresh fetches that source's tree again in the background (it may share the storage that changed).
|
|
278
316
|
|
|
279
317
|
**Document refresh.** Every view reads one shown document alone again past the host's caches with Refresh document, apart from Refresh tree (which also lists every expanded folder again).
|
|
280
|
-
The tree and single views show it in a thin bar above the document region, at the bar's inline end, as a labelled button (`refreshDocumentLabel`, «Refresh document» / 「文書を更新」, which is also its accessible name; its tooltip is `refreshDocument`), and the tree view's empty state, which has no document, has no bar.
|
|
318
|
+
The tree and single views show it in a thin bar above the document region, at the bar's inline end, as a labelled button (`refreshDocumentLabel`, «Refresh document» / 「文書を更新」, which is also its accessible name; its tooltip is `refreshDocument`), and the tree view's empty state, which has no document, has no bar. In the tree view the bar ends with Maximize (see [The maximized document](#the-maximized-document)) and, below the sheet threshold, is the sheet's bar too (see [The sheet on narrow frames](#the-sheet-on-narrow-frames)).
|
|
281
319
|
A multi-view panel shows it icon-only in a bar pinned to the top of the panel's scroll area (see [The multi-panel stage](#the-multi-panel-stage)), named after the panel's document (`refreshDocumentNamed`, «Refresh a.md» / 「a.md を更新」, its accessible name and its tooltip). The document stays on screen while it reloads.
|
|
282
320
|
A loaded document is replaced in place only when it changed, keeping its scroller and the reader's offset (see [The document region](#the-document-region)); a shown failure, a document the page loader gave up on and one not cached yet are fetched in the foreground. Each press is announced once.
|
|
283
321
|
A document whose content reads a part of it itself — a table file's table, a document shown as written — is reloaded with that part: the control stays busy until the part is read from the new answer, and the outcome is reported only then.
|
|
@@ -294,7 +332,7 @@ Folders whose loads fail within the same animation frame — Expand all or a res
|
|
|
294
332
|
|
|
295
333
|
## Announcements
|
|
296
334
|
|
|
297
|
-
The explorer's own messages — failed folder loads, the start and end of an Expand all press, tree setting changes, the document shown, a document that failed, panel actions other than moves and the panel limit — go through one announcer per reader, which speaks them through a live region (`role="status"`, polite and atomic).
|
|
335
|
+
The explorer's own messages — failed folder loads, the start and end of an Expand all press, tree setting changes, the document shown, a document that failed, the tree view's document maximized or restored, panel actions other than moves and the panel limit — go through one announcer per reader, which speaks them through a live region (`role="status"`, polite and atomic).
|
|
298
336
|
Every message posted before the next animation frame is spoken: the region takes them together in that frame as one text — two or more joined as separate sentences (`announcementSequence`) — so neither of two failures, nor a failure and the document shown in the same frame, is dropped.
|
|
299
337
|
They are spoken in the order posted, except that the items posted through the same list label within a frame (the folders whose children failed, `foldersLoadFailedNamed`) merge into one sentence in the place of the first item, ahead of any message posted between them: folder a failing, then the document shown, then folder b failing in one frame is spoken "a and b could not be loaded. Showing x.md." The region is emptied when the first message of a frame is posted, so the same text posted again is spoken again, and a later frame replaces the text.
|
|
300
338
|
|
|
@@ -329,16 +367,26 @@ Space needs no such rule on buttons, which act when the key is released, and a t
|
|
|
329
367
|
## Rhythm
|
|
330
368
|
|
|
331
369
|
- Spacing is the Fibonacci scale 1, 2, 3, 5, 8, 13, 21, 34, 55 px, written in rem (`--aqmx-space-1` to `--aqmx-space-9`), so it scales with the reader's font size.
|
|
332
|
-
- Header rows, icon buttons, menu items, tree rows and the retry button of a folder that failed to load are one control high: 44 px (2.75rem, `--aqmx-control`) under every pointer, the WCAG 2.2 enhanced target size, and icon buttons, labelled buttons and the
|
|
370
|
+
- Header rows, icon buttons, menu items, tree rows and the retry button of a folder that failed to load are one control high: 44 px (2.75rem, `--aqmx-control`) under every pointer, the WCAG 2.2 enhanced target size, and icon buttons, labelled buttons, the sheet's toggle and close button, the rail's toggle and the explorer's close button are at least as wide (the retry button narrows to its icon, 24 px, only in a row without room for its label).
|
|
333
371
|
The tree measures `--aqmx-control` at run time, so its rows follow the root font size and a host's token override. The resize handles are 24 px bands under a fine pointer and 44 px under a coarse one (see [The split](#the-split) and [The editor's split](#the-editors-split)).
|
|
334
372
|
- The tree's virtual scrolling renders 13 rows beyond each edge and reports scrolling at most every 13 ms. Its 8 px scroll bar does not grow under a coarse pointer (the wheel, touch drag and the tree's arrow keys scroll the same list), and its arrow buttons are not Tab stops. The arrow keys, Home and End keep the focused row wholly visible: when the focus moves onto a row outside the tree's window, the tree scrolls by exactly the distance needed.
|
|
335
373
|
- Every scroller the reader browses scrolls natively, with an 8 px pointer scroll bar beside it in place of the native vertical scrollbar: the document of the tree and single views (`@aiquants/markdown`'s `renderScrollBar`), an image's canvas, a medium's and a file view's stage and a failure view there (`@aiquants/markdown`'s `HostedScrollArea`), each multi-view panel's scroll area (drag-drop-panels' `renderPanelScrollArea`) and the multi view's stage (`renderStageScrollBar`).
|
|
374
|
+
The explorer gives every content scroller's bar its slot's width from the first paint (`--aqmx-scroll-bar-slot-size`), since the bars' module loads after the page, so the text never narrows when a bar appears.
|
|
336
375
|
Every bar but the stage's carries the same tap-scroll circle as the tree's bar; every bar shows only while its content overflows, is hidden from assistive technology and has no Tab stops, so the keyboard, the wheel and touch scroll the scroller itself; a zoomed image keeps its native horizontal scrollbar.
|
|
337
376
|
The tables' grids draw their circle in the same look and speeds (the look loads on first use, as the bars' module does): a table file's preview one control wide, a document's table 24 px wide (WCAG 2.5.8's minimum target, from markdown 11.8.2) and only where its options say `tapscroll=1`. Inside a multi-view panel the document and the image, media, file and failure views grow to their content and have no bar of their own: the panel's area scrolls.
|
|
338
377
|
The circle is one control wide (44 px) and sits 49 px before its bar, centred in a 54 px gutter (the circle and 5 px on each side) that every document scroller with a circle keeps at its inline end, outside its own padding: the document's scroll container (`@aiquants/markdown`'s `scrollBarGutter`), the image, media, file and failure views, and each multi-view panel's area.
|
|
339
378
|
No content (a diagram's or a table's toolbar, a code block's copy button, a focused link) lies under the circle at any scroll position; only an image zoomed wider than its canvas passes beneath it while it pans sideways. The wheel and touch scroll over the gutter as over the rest of the document.
|
|
340
379
|
The gutter is kept while the content fits as well, as the native scrollbar's room is, so the text never re-wraps when the bar appears. The tree's rows reach under the tree's circle: a gutter there would take 54 px from a pane as narrow as 13rem.
|
|
341
380
|
The stage's bar sits in 8 px the stage adds to the inline end of its padding, and has no circle: 49 px before that bar a circle would cover the right-most panel's own bar and circle, and a gutter that holds it (54 px more of the stage's padding) would cost the stage a column at a 1920 px or a 1440 px window. Menus and popovers, the scrollers nested in a document and embedded frames (a PDF's included) keep their native scrollbars and have no circle.
|
|
381
|
+
- Under a coarse pointer (a touch screen, `(pointer: coarse)`) a narrow screen gives its whole width to the content: every content scroller's bar lies over the scroller's inline end instead of beside it (its slot takes no width: `--aqmx-scroll-bar-slot-size` is `0px` there), and the scrollers keep no gutter for the circle.
|
|
382
|
+
Such a bar takes no presses — a finger scrolls the scroller itself, and a press at the edge reaches the content under the bar — and every bar, the tree's, the stage's and the tables' grids' (a document's tables and a table file's grid) included, leaves out its thumb drag and its track click and draws no arrows, its track running the bar's whole length: an 8 px bar (a table's 12 px) is no
|
|
383
|
+
target for a finger, and a finger that drags a table near its edge would meet an arrow or the track by mistake. The other bars take no presses either, so a finger's pan that starts on a bar's strip scrolls what the bar scrolls: a press on the stage's strip reaches the stage beneath, and one on the tree's strip or on a table's vertical bar reaches the box of the tree's or
|
|
384
|
+
the table's rows' scroll pane, which takes it as a press on its rows (`@aiquants/virtualscroll`), so the pan scrolls the tree or the table's rows and leaves the document where it is. A table's horizontal bar lies below its rows, outside their pane: a pan that starts on its strip goes to the browser, which scrolls the document up or down and has nothing to move sideways.
|
|
385
|
+
So does a pan that starts on a table's header or footer rows, which lie outside the rows' pane too. A horizontal pan over the rows moves the columns even when every row fits the box: the rows' pane then leaves vertical pans to the document (`touch-action: pan-y`) and takes only the horizontal ones.
|
|
386
|
+
The circles, the one part of a bar that takes presses, show only while the reader scrolls: a circle appears when the scroll position changes within 2 s of the reader's own input (a press, a finger, a wheel turn or a key), stays while the scroll goes on (a flick's momentum included) and hides 2 s after the last change, taking no presses while hidden. The watch hears those inputs anywhere in the page and does not ask what they start, so a scroll the page makes on its own (to a fragment, to a restored reading position, scroll anchoring) shows a circle
|
|
387
|
+
only when such an input came within 2 s before it, as a click on a link to a fragment does.
|
|
388
|
+
The tree's bar keeps its place beside the rows, with its Top and Bottom buttons, and its circle follows the same rule; the tables' grids show their circles by it as well. The stylesheet follows `(pointer: coarse)` itself, so the bars and the scrollers' padding take their places from the first paint.
|
|
389
|
+
The server cannot know the pointer and draws the tree's bar for a fine one, with its arrows and an always-shown circle; under a coarse pointer the stylesheet keeps a tree bar that has arrows hidden, in its place, until hydration draws it without them, so no arrow or circle appears and vanishes. The other bars draw only in the browser, with the reader's pointer from the start.
|
|
342
390
|
- The explorer's header wraps rather than cutting a control off: the source switch keeps at least 9rem and the icon buttons wrap below it, so every control stays reachable at the minimum width and at large font sizes.
|
|
343
391
|
A labelled button that is wider on its own than its line — Refresh tree in the header, Refresh document in its bar — shrinks, down to one control wide, and ends its label with an ellipsis (its icon stays whole), so it never pushes the explorer pane or the bar sideways; the cut is visual only, and the button's accessible name stays its whole label. The tree settings menu opens below the header.
|
|
344
392
|
- Durations are 89, 144, 233 and 377 ms (`--aqmx-duration-1` to `--aqmx-duration-4`); with `prefers-reduced-motion: reduce` every explorer duration is 0, the resize handles' (the explorer's and the editor's) included. The drag-and-drop panels follow the setting as well: `@aiquants/drag-drop-panels` leaves out its own transitions and its reorder animation.
|
|
@@ -350,7 +398,7 @@ Space needs no such rule on buttons, which act when the key is released, and a t
|
|
|
350
398
|
## Colour
|
|
351
399
|
|
|
352
400
|
Text colours reach WCAG 2.2's enhanced 7:1 against every surface and tint they are drawn on, in both colour schemes (the editor's syntax colours over its current line and its conflict tints included); a unit test reads the shipped tokens and checks every pair. The scheme follows the `theme` prop (`data-aqmx-theme` on the root), not the operating system, so a host with its own theme switch stays in control.
|
|
353
|
-
The root declares the scheme as its `color-scheme` (`light` or `dark`), so what colours itself by the scheme inside the explorer follows `theme` too, whatever the page declares: the colours `@aiquants/directory-tree`
|
|
401
|
+
The root declares the scheme as its `color-scheme` (`light` or `dark`), so what colours itself by the scheme inside the explorer follows `theme` too, whatever the page declares: the colours `@aiquants/directory-tree` and `@aiquants/virtualscroll` paint from their `light-dark()` palettes (the tree's type icons, and the bars of the tree, the document and the tables), and the browser's own form controls and scrollbars.
|
|
354
402
|
|
|
355
403
|
Tree rows take their text and background colours from the tokens: rest rows `--aqmx-text` on the surface; hovered and selected rows `--aqmx-text` on `--aqmx-tree-row-tint` (a selected row also has a 2 px bar in its text colour); the shown document and documents open as panels `--aqmx-accent` on `--aqmx-tree-row-accent-tint`.
|
|
356
404
|
The two row tints are opaque: with the tree lines on, `@aiquants/directory-tree` draws the connector lines and the expand glyphs on a canvas above the rows, so no row state covers them, and a hovered folder keeps its glyph.
|
|
@@ -11,7 +11,8 @@ This page is part of the host-facing contract of `@aiquants/markdown-explorer`;
|
|
|
11
11
|
and every Mermaid diagram's controls (`viewerMermaidInteractionMode` for the mouse-interaction menu and its button, `viewerMermaidModeNone`, `viewerMermaidModeZoom`, `viewerMermaidModePan`, `viewerMermaidModePanShift`, `viewerMermaidModeBoth`, `viewerMermaidModeBothShift` for its modes, `viewerMermaidInteractionModeTouch` for the same menu and button under a coarse pointer, `viewerMermaidModeNoneTouch`, `viewerMermaidModeZoomTouch`, `viewerMermaidModePanTouch`, `viewerMermaidModeBothTouch` for its touch items, `viewerMermaidZoomIn`, `viewerMermaidZoomOut`, `viewerMermaidResetView`,
|
|
12
12
|
`viewerMermaidPanUp`, `viewerMermaidPanDown`, `viewerMermaidPanLeft`, `viewerMermaidPanRight` for the buttons that move the view while the drawing overflows its frame, `viewerMermaidRetry`, `viewerMermaidDiagram`, the name of the diagram's focusable frame, and `viewerMermaidFullscreen`, `viewerMermaidExitFullscreen` and `viewerMermaidFullscreenDialog` for the full-screen toggle, the same toggle while the diagram is shown full screen, and the full-screen dialog's name),
|
|
13
13
|
the toolbar of a storage SVG image that stands alone in a paragraph (`viewerSvgImageToolbar` naming the toolbar, `viewerSvgImageSource` its Source toggle, `viewerSvgImageSourceRegion` the shown SVG, `viewerSvgImageLoading`, `viewerSvgImageFailed` and `viewerSvgImageRetry` while it is read, `viewerSvgImageTruncated` under a file cut at `textMaxBytes`, `viewerSvgImageCopy`, `viewerSvgImageCopied` and `viewerSvgImageCopyFailed` for its Copy button and its outcomes while the source shows, and `viewerSvgImageCopyImage`,
|
|
14
|
-
`viewerSvgImageCopiedImage` and `viewerSvgImageCopyImageFailed` for its Copy button and its outcomes while the image shows, and `viewerSvgImageFullscreen`, `viewerSvgImageExitFullscreen` and `viewerSvgImageFullscreenDialog` for its full-screen toggle, the same toggle while the image is shown full screen, and the full-screen dialog's name)
|
|
14
|
+
`viewerSvgImageCopiedImage` and `viewerSvgImageCopyImageFailed` for its Copy button and its outcomes while the image shows, and `viewerSvgImageFullscreen`, `viewerSvgImageExitFullscreen` and `viewerSvgImageFullscreenDialog` for its full-screen toggle, the same toggle while the image is shown full screen, and the full-screen dialog's name),
|
|
15
|
+
the copy buttons of the code blocks (`viewerCodeBlockCopy` naming the button, `viewerCodeBlockCopied` and `viewerCodeBlockCopyFailed` announcing its outcomes) and of the display formulas (`viewerDisplayMathCopy`, `viewerDisplayMathCopied` and `viewerDisplayMathCopyFailed`)
|
|
15
16
|
and the titles of embedded frames (`viewerEmbeddedVideo` and `viewerEmbeddedPost` after a provider's name, as in "YouTube: embedded video", and `viewerEmbeddedFrame` before the host of an iframe written in a document without a title).
|
|
16
17
|
A label the viewer receives carries no `lang` of its own, so it is read in the page's language.
|
|
17
18
|
- Every ```spreadsheets table's labels are `@aiquants/markdown`'s own, derived rather than copied: each label of its table block (`SPREADSHEET_BLOCK_LABEL_CATALOGS` of `@aiquants/markdown/code-blocks`, see its README) is a key prefixed with `viewerSpreadsheet` (`zoomIn` → `viewerSpreadsheetZoomIn`, `cellAnnouncement` → `viewerSpreadsheetCellAnnouncement`), its built-in text is the block's catalog of the UI language, and its placeholders are the block's (`SPREADSHEET_BLOCK_LABEL_PLACEHOLDERS`).
|
|
@@ -35,7 +36,7 @@ This page is part of the host-facing contract of `@aiquants/markdown-explorer`;
|
|
|
35
36
|
- A workbook's view names a sheet's table after the file and the sheet with `spreadsheetSheetName(name, sheet)` (its full-screen table with `spreadsheetFullscreen` of that name) and its tabs with `spreadsheetSheets(name)`, each tab named by its sheet as the workbook writes it.
|
|
36
37
|
`spreadsheetSheetLoading` is the screen-reader text while a sheet is read for the first time; a sheet without data shows `spreadsheetSheetEmpty`. Its notes are `spreadsheetUnshownSheets(count)` (sheets left out: hidden, or without a table), `spreadsheetUnlistedSheets(count)` (the number of sheets listed, when the workbook has more than the reader lists) and `spreadsheetWorkbookFirstSheet` (the first sheet's text shown instead of the workbook);
|
|
37
38
|
in place of the tabs or a sheet's table, `spreadsheetWorkbookEncrypted` (a password-protected workbook), `spreadsheetNotWorkbook` (bytes that are no workbook the explorer reads, a legacy `.xls` included) or `spreadsheetWorkbookTooLarge` (past `spreadsheets.maxWorkbookBytes` or the reader's limit for one part).
|
|
38
|
-
- `copyText` is the accessible name and tooltip of the icon-only Copy the text button in the header of a text read whole (a text file, or a Markdown document shown as written). A copy is announced with `copiedText`, or with `copyTextFailed` when the browser has no asynchronous clipboard
|
|
39
|
+
- `copyText` is the accessible name and tooltip of the icon-only Copy the text button in the header of a text read whole (a text file, or a Markdown document shown as written). A copy is announced with `copiedText`, or with `copyTextFailed` when the browser has no asynchronous clipboard, refuses the write or has a clipboard that throws; for 2 seconds the outcome's label is also the button's tooltip, while its name stays `copyText`.
|
|
39
40
|
- `switchToTree` and `switchToMulti` name their destination with the README's view names ("Open in the tree view" / "ツリービューで開く", "Open in the multi-panel view" / "マルチビューで開く"); no label names the single view, which no control inside the explorer opens.
|
|
40
41
|
|
|
41
42
|
## Overrides
|
|
@@ -56,7 +57,7 @@ const HANDBOOK_LABELS = {
|
|
|
56
57
|
`expandAllDone(opened, failed, complete)` (the end of a press that no limit stopped; `complete` is whether every folder is open at the end, false when the reader closed one during the press, so the sentence then claims nothing about the rest; nothing opened, nothing failed and complete means every folder was already open), `expandAllFolderLimit(opened, limit, expandAll)` (a press stopped at `expandAll.maxFolders`;
|
|
57
58
|
`expandAll` is the Expand all button's own label, so a host that renames the button keeps the invitation to press it again consistent), `expandAllDepthLimit(opened, depth)` (a press that left folders deeper than `expandAll.maxDepth` closed), `loopFolderName(name)` (the name of a loop row, a folder met again among its own ancestors), `documentFailed(name, title)` (a document that could not be shown:
|
|
58
59
|
the path's last segment and the failure's title — the text of the matching `failure…Title` label, not the reason's code), `imageZoomLevel(percent)`, `treeRefreshFailed(reason)`, `documentRefreshed(name)`, `documentRefreshFailed(reason)`, `refreshDocumentNamed(name)` (a multi-view panel's icon-only Refresh document: its accessible name and tooltip, `name` being the panel title),
|
|
59
|
-
`showMarkupNamed(name)` (a multi-view panel's icon-only Source toggle: its accessible name and tooltip, `name` being the panel title), `panelLimit(max)`, `panelOpened(name)`, `panelClosed(name)`, `panelAlreadyOpen(name)`, `panelHidden(name)`, `panelShown(name)`, `panelMaximized(name)`, `panelRestored(name)` — so each language can place the value where its grammar needs it.
|
|
60
|
+
`showMarkupNamed(name)` (a multi-view panel's icon-only Source toggle: its accessible name and tooltip, `name` being the panel title), `documentMaximized(name)` and `documentRestored(name)` (the tree view's document maximized and restored, `name` being the last segment of the shown document's path, or of the folder's whose README shows), `panelLimit(max)`, `panelOpened(name)`, `panelClosed(name)`, `panelAlreadyOpen(name)`, `panelHidden(name)`, `panelShown(name)`, `panelMaximized(name)`, `panelRestored(name)` — so each language can place the value where its grammar needs it.
|
|
60
61
|
- The labels `@aiquants/drag-drop-panels` fills itself are templates instead, strings whose `{name}` placeholders mark where each value goes: `panelMoved` (`{title}` the panel's name, `{column}` its visible column, `{position}` its place among that column's shown panels), `panelMoveUnavailable` (`{title}`, and `{move}` the name of the move, one of the `panelMove…` labels), `panelDragStarted` and `panelDragCancelled` (`{title}`) and `multiColumnRegion` (`{column}`); columns and positions count from 1.
|
|
61
62
|
So are the table labels `@aiquants/markdown` fills, with the block's placeholders (`viewerSpreadsheetSize` with `{rows}` and `{cols}`, `viewerSpreadsheetCellAnnouncement` with `{cell}` and `{value}`, and so on; `SPREADSHEET_BLOCK_LABEL_PLACEHOLDERS` lists them), and `viewerSvgImageSourceRegion` and `viewerSvgImageFullscreenDialog`, whose `{name}` is the SVG image's name (its alternative text, else its file name).
|
|
62
63
|
`MARKDOWN_EXPLORER_LABEL_TEMPLATES` lists each template's placeholders, and braces in every other label are literal text.
|
|
@@ -190,4 +190,5 @@ In a tree or children listing, an entry with an empty name, or with a path the b
|
|
|
190
190
|
- Inline only for raster images, audio, video and PDF; everything else, SVG and an empty or unknown type included, as an attachment — unless the request asks for the plain-text display (`as=text`, the text viewers' Open in a new tab and a table file's preview), which shows any admitted file in place as `text/plain; charset=<encoding>` (the encoding the explorer's one text rule reads the file's first 64 KiB in) whatever its declared type,
|
|
191
191
|
under the same `nosniff` and sandboxing policy, so an HTML or SVG file opened that way shows its source and runs nothing. A workbook's preview delivery (`as=workbook`) is always an attachment of `application/octet-stream`, whatever the declared type. Both dispositions name the file (`filename*=UTF-8''<name>`, the RFC 8187 encoding of the name with `'`, `(`, `)` and `*` percent-encoded too), so a saved file keeps its name although every asset URL's path ends in `asset`.
|
|
192
192
|
- The type is the one the host declares, parsed as a browser parses it, never guessed from the name; `nosniff` stops the browser from guessing either, and the sandboxing policy keeps an SVG or HTML file opened on its own from running script.
|
|
193
|
-
- For `createFileSystemSource`, files of unknown extensions are downloadable, and so are the whole bytes of every Markdown and text file the source admits: raw Markdown keeps what the rendered view drops (front matter,
|
|
193
|
+
- For `createFileSystemSource`, files of unknown extensions are downloadable, and so are the whole bytes of every Markdown and text file the source admits: raw Markdown keeps what the rendered view drops (front matter, which `@aiquants/markdown`'s converter renders as nothing in every document, and HTML comments), and a text file is served beyond its preview.
|
|
194
|
+
Its deny rules — `DEFAULT_DENIED_PATH_SEGMENTS` (environment files, keys and certificates, credential files, Terraform state, shell histories) plus the host's `deny` patterns — are the only filter, so add a pattern for anything else the folder must withhold.
|
|
@@ -6,7 +6,7 @@ This page is part of the host-facing contract of `@aiquants/markdown-explorer`;
|
|
|
6
6
|
|
|
7
7
|
| View | Path | Query |
|
|
8
8
|
| --- | --- | --- |
|
|
9
|
-
| Tree | `{basePath}/{views.tree}`, `{basePath}/{views.tree}/{document}` or `{basePath}/{views.tree}/{folder}/` | `source`, `style`, `align`, `markup` |
|
|
9
|
+
| Tree | `{basePath}/{views.tree}`, `{basePath}/{views.tree}/{document}` or `{basePath}/{views.tree}/{folder}/` | `source`, `style`, `align`, `maximized`, `markup` |
|
|
10
10
|
| Multi-panel | `{basePath}/{views.multi}` | `source`, `doc` (repeated, in panel order), `maximized`, `markup` (repeated, in the order of `doc`) |
|
|
11
11
|
| Single | `{basePath}/{views.single}/{document}` | `source`, `style`, `align`, `markup`, `showToc`, `showStyle`, `showAlign`, `padding`, `width`, `maxWidth` |
|
|
12
12
|
|
|
@@ -15,10 +15,11 @@ This page is part of the host-facing contract of `@aiquants/markdown-explorer`;
|
|
|
15
15
|
- The tree view shows a document, a folder (its README, see [Folder segment](#folder-segment)) or neither: `ExplorerLocation`'s tree view has `doc` and `folder`, at most one of them not `null`.
|
|
16
16
|
- `markup` names the Markdown documents, SVG images and table files shown as written (their source — an SVG image's own SVG, a table file's CSV or TSV —, the document bar's Source toggle) instead of rendered (a table file as its table): in the tree and single views `markup=true` for the URL's document — in the tree view a folder's README too —, and in the multi-panel view one `markup` per open document shown that way, in the order of `doc` (a maximized document included).
|
|
17
17
|
`ExplorerLocation`'s `markup` is a boolean in the tree and single views (always `false` in the tree view without a document or a folder) and a list in the multi-panel view; a target without it (`ExplorerHrefTarget`) shows every document rendered. A document that is neither Markdown, an SVG image nor a table file (a raster image, media, text, a file or a failure) ignores it and shows as it always does. The Source toggle of an SVG image inside a rendered document is the image block's own and never enters the URL.
|
|
18
|
+
- `maximized` says what fills the page: in the tree view `maximized=true` for the URL's document — a folder's README too — (the document bar's Maximize, see [Layout](layout.md#the-maximized-document)), and in the multi-panel view the open document whose panel is maximized. `ExplorerLocation`'s `maximized` is a boolean in the tree view (always `false` without a document or a folder) and a document or `null` in the multi-panel view; the single view has none, and a target without it fills nothing.
|
|
18
19
|
- The source never limits which documents can be open: a path names one document; it may appear in several sources' trees, and it opens when the boundary of at least one source admits it, whichever source the URL names. Switching the source therefore keeps every open document, and a document no source's boundary admits is answered `forbidden` in every view.
|
|
19
20
|
- `explorerHref(config, target)` is the only function that writes explorer URLs, and `resolveExplorerLocation(config, splat, search)` is the only one that reads them. The server's loader and the browser call the same two functions, each with a configuration joined with the server's source ids by `withExplorerSources(config, sourceIds)` (an `ExplorerLocationConfig`; no ids, an invalid id or a repeated one throws a `RangeError`).
|
|
20
21
|
`explorerHref` has two forms: any target with such a configuration, and a target without `source` (`ExplorerSourcelessHrefTarget`, the default source) with a plain `ExplorerConfig`, for links built where the server's sources are not known (a host menu). A target with a `source` and a configuration without ids throws a `TypeError` naming `withExplorerSources`, and so does `resolveExplorerLocation` given such a configuration.
|
|
21
|
-
- `explorerHref` writes only canonical URLs. It throws a `RangeError` for a target the resolver would redirect, read as another location or partly ignore: an unknown source, an unacceptable document or folder path, a tree or single view's document path that ends in a slash (its segment would name a folder), a tree view with both a document and a folder, multi-panel documents that repeat or exceed `multiView.maxPanels`, a maximized document or a document shown as written that is not open, a document shown as written twice, a tree view with neither a document nor a folder shown as written,
|
|
22
|
+
- `explorerHref` writes only canonical URLs. It throws a `RangeError` for a target the resolver would redirect, read as another location or partly ignore: an unknown source, an unacceptable document or folder path, a tree or single view's document path that ends in a slash (its segment would name a folder), a tree view with both a document and a folder, multi-panel documents that repeat or exceed `multiView.maxPanels`, a maximized document or a document shown as written that is not open, a document shown as written twice, a tree view with neither a document nor a folder maximized or shown as written,
|
|
22
23
|
a `style` naming no configured document style, an `align` other than `left`, `center` or `right`, and an embedding value outside the rules below (a non-boolean switch, a padding outside 0–256 or not writable in decimal digits, a width that is not one of the accepted CSS lengths).
|
|
23
24
|
Resolving a link it wrote therefore always yields the very location it was given.
|
|
24
25
|
|
|
@@ -53,13 +54,14 @@ Every URL resolves either to a location or to a redirect to its canonical form.
|
|
|
53
54
|
| A single URL whose segment names a folder | Redirect to the tree view's folder, keeping `source`, `style`, `align` and `markup` (the embedding parameters are dropped) |
|
|
54
55
|
| `source` unknown, repeated, or equal to the default | Redirect to the same location with `source` dropped |
|
|
55
56
|
| Multi-panel `doc` values that are not acceptable paths, repeated, or beyond `multiView.maxPanels` | Redirect with only the first occurrence of each acceptable path, in order, up to the limit |
|
|
56
|
-
| `maximized` repeated, or not one of the open documents | Redirect without `maximized` |
|
|
57
|
+
| Multi-panel `maximized` repeated, or not one of the open documents | Redirect without `maximized` |
|
|
57
58
|
| Multi-panel `markup` values that are not open documents, repeated, or out of the order of `doc` | Redirect with each open document shown as written once, in the order of `doc` |
|
|
58
59
|
| A path segment after the multi-panel slug | Redirect to the multi-panel view without it |
|
|
59
60
|
| `style` naming no configured document style, `align` other than `left`, `center` or `right` | Ignored (the reader's own setting applies) |
|
|
60
61
|
| `padding` outside 0–256 or not written in decimal digits (signs, exponents, hexadecimal, surrounding spaces and `Infinity` are not numbers here), `width` / `maxWidth` not a CSS length in `px`, `rem`, `em`, `ch`, `vw` or `%` | Ignored (the default applies) |
|
|
61
62
|
| `showToc`, `showStyle`, `showAlign` other than `false` | Ignored (the control is shown) |
|
|
62
63
|
| `markup` in the tree or single view other than `true`, or in the tree view without a document or a folder | Ignored (the document shows rendered) |
|
|
64
|
+
| `maximized` in the tree view other than `true`, or without a document or a folder | Ignored (the document does not fill the page) |
|
|
63
65
|
|
|
64
66
|
An acceptable document path is non-empty, at most 4096 UTF-16 code units long, well-formed (no lone surrogate, which no URL can carry), and contains neither a control character (U+0000–U+001F, U+007F) nor a backslash. Whether the path exists, and whether it is denied, is decided by the server for the document request; the URL itself stays as written.
|
|
65
67
|
|
|
@@ -137,21 +139,25 @@ In the tree and single views that address is the page's URL (the same view, with
|
|
|
137
139
|
| Switching between the views (the view switch, "open selection in the multi-panel view") | Pushes |
|
|
138
140
|
| Any multi-panel action (open, close, maximize, restore, navigate inside a panel, rearrange (drag or move)) | Replaces; hiding and showing a panel do not change the URL (browser storage remembers them) |
|
|
139
141
|
| The Source toggle (a Markdown document shown as written or rendered) | Replaces; in the tree and single views the fragment is dropped, since the swapped content starts at its top |
|
|
142
|
+
| The tree view's Maximize (the document filling the page or restored) | Replaces, keeping the scroll; the fragment is dropped, since it would take the reader back to its target on every press |
|
|
140
143
|
|
|
141
144
|
A multi-panel action that follows a source switch before the router reports it keeps the new source.
|
|
142
145
|
|
|
143
146
|
Whether a document shows as written stays with that document only: selecting another document in the tree, following a document link and navigating inside a panel show the next document rendered (the document still shown while it loads keeps the way it showed), and closing a panel forgets it.
|
|
144
147
|
Switching the tree's source, the reveal's move of the tree and the switches between the views keep it — the view switch carries it for the document it opens (the tree view's document as a panel, the multi-panel view's maximized or first document in the tree view), and opening a selection carries it for the tree view's document when the selection holds it.
|
|
145
148
|
|
|
149
|
+
Whether the tree view's document fills the page stays with it through a source switch, the reveal's move and the document links and table-of-contents entries it follows, which read it at the moment of the click: their hrefs never carry it, so a modified click or a copied link opens the target at its size. Selecting a document or a folder in the tree shows it at its size, and the switches between the views, whose controls lie inert under the cover, never carry it.
|
|
150
|
+
|
|
146
151
|
The page loader only seeds the first paint; after that the browser reads through the data route. Export `shouldRevalidateExplorer` as the page route's `shouldRevalidate`: it runs the loader again only for a revalidation of the very same URL (`useRevalidator().revalidate()`, or a navigation to the current URL) and never after a form or fetcher submission elsewhere on the page, so moving between views, documents and sources never reloads the tree. Entering the explorer from another route always runs the loader.
|
|
147
152
|
A revalidation keeps the shown tree and documents on screen and replaces each only when its new value differs (a different tree also drops its loaded lazy folders); a failure, or a value the loader gave up on, leaves the shown one alone.
|
|
148
153
|
|
|
149
154
|
## Display settings
|
|
150
155
|
|
|
151
|
-
The reader's display settings — the explorer width per view, the document style and the alignment — live in a cookie named by `settingsCookie`, so the server renders the first paint with them:
|
|
156
|
+
The reader's display settings — the explorer width per view, whether the reader closed the explorer in each view, the document style and the alignment — live in a cookie named by `settingsCookie`, so the server renders the first paint with them:
|
|
152
157
|
|
|
153
|
-
- the value is percent-encoded JSON with the keys `treeExplorer`, `multiExplorer`, `style` and `align`, written in that order and only when set;
|
|
158
|
+
- the value is percent-encoded JSON with the keys `treeExplorer`, `treeExplorerHidden`, `multiExplorer`, `multiExplorerHidden`, `style` and `align`, written in that order and only when set;
|
|
154
159
|
- widths are percentages of the split, greater than 0 and at most 1/φ² (38.197 %), rounded to 0.01 %;
|
|
160
|
+
- a closed explorer is written as `true` and an open one not at all, and the explorer reads the flag as `=== true`, so `false` and a missing key mean the same (see [Layout](layout.md#closing-the-explorer));
|
|
155
161
|
- the cookie is written with `Path=/`, `Max-Age=31536000`, `SameSite=Lax`, and `Secure` on HTTPS;
|
|
156
162
|
- a malformed cookie, or a value outside these rules, is treated as absent (key by key).
|
|
157
163
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aiquants/markdown-explorer",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.34.0",
|
|
4
4
|
"description": "Markdown document explorer for React Router 8 (framework mode): a source tree with a single-document view and a multi-panel reading view, storage-agnostic server ports, golden-ratio layout and an en / ja UI.",
|
|
5
5
|
"sideEffects": [
|
|
6
6
|
"**/*.css"
|
|
@@ -68,23 +68,23 @@
|
|
|
68
68
|
"parse5": "^8.0.0"
|
|
69
69
|
},
|
|
70
70
|
"peerDependencies": {
|
|
71
|
-
"@aiquants/directory-tree": "^6.
|
|
72
|
-
"@aiquants/drag-drop-panels": "^0.
|
|
73
|
-
"@aiquants/markdown": "^12.
|
|
71
|
+
"@aiquants/directory-tree": "^6.1.1",
|
|
72
|
+
"@aiquants/drag-drop-panels": "^0.14.0",
|
|
73
|
+
"@aiquants/markdown": "^12.3.0",
|
|
74
74
|
"@aiquants/resize-panels": "^2.2.0",
|
|
75
|
-
"@aiquants/spreadsheet": "^0.
|
|
76
|
-
"@aiquants/virtualscroll": "^3.
|
|
75
|
+
"@aiquants/spreadsheet": "^0.20.0",
|
|
76
|
+
"@aiquants/virtualscroll": "^3.24.0",
|
|
77
77
|
"react": "^19.2.7",
|
|
78
78
|
"react-dom": "^19.2.7",
|
|
79
79
|
"react-router": "^8.0.0"
|
|
80
80
|
},
|
|
81
81
|
"devDependencies": {
|
|
82
|
-
"@aiquants/directory-tree": "6.
|
|
83
|
-
"@aiquants/drag-drop-panels": "0.
|
|
84
|
-
"@aiquants/markdown": "12.
|
|
82
|
+
"@aiquants/directory-tree": "6.1.1",
|
|
83
|
+
"@aiquants/drag-drop-panels": "0.14.0",
|
|
84
|
+
"@aiquants/markdown": "12.3.0",
|
|
85
85
|
"@aiquants/resize-panels": "2.2.0",
|
|
86
|
-
"@aiquants/spreadsheet": "0.
|
|
87
|
-
"@aiquants/virtualscroll": "3.
|
|
86
|
+
"@aiquants/spreadsheet": "0.20.0",
|
|
87
|
+
"@aiquants/virtualscroll": "3.24.0",
|
|
88
88
|
"@heroicons/react": "^2.2.0",
|
|
89
89
|
"@playwright/test": "^1.64.1",
|
|
90
90
|
"@tailwindcss/cli": "^4.1.18",
|