@aiquants/markdown-explorer 0.17.0 → 0.18.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.
Files changed (33) hide show
  1. package/CHANGELOG.md +39 -0
  2. package/README.md +6 -5
  3. package/dist/{EditSurface-0owpPyLE.js → EditSurface-B2bzY1b_.js} +3 -3
  4. package/dist/{EditSurface-D-nhilRk.cjs → EditSurface-BRuIjA9L.cjs} +1 -1
  5. package/dist/{ExplorerSplit-bpEvHrCo.cjs → ExplorerSplit-BE1VJuok.cjs} +1 -1
  6. package/dist/{ExplorerSplit-8c93p1hy.js → ExplorerSplit-qAKZsLZa.js} +3 -3
  7. package/dist/{MultiLayout-BXfzR6XC.cjs → MultiLayout-Bc6RYc3U.cjs} +1 -1
  8. package/dist/{MultiLayout-Dy3DD_09.js → MultiLayout-rsmtFma5.js} +251 -247
  9. package/dist/{NativeScrollBar-CI9fTvkt.js → NativeScrollBar-Dq3YeUVY.js} +1 -1
  10. package/dist/{NativeScrollBar-Ddn0iHjv.cjs → NativeScrollBar-DqTkrnPZ.cjs} +1 -1
  11. package/dist/{TreeLayout-eFQmzpNj.js → TreeLayout-BPa7NdeT.js} +3 -3
  12. package/dist/{TreeLayout-CKZ-XQgn.cjs → TreeLayout-DXoEAcpD.cjs} +1 -1
  13. package/dist/core/geometry.d.cts +1 -1
  14. package/dist/core/geometry.d.ts +1 -1
  15. package/dist/core/labels.d.cts +1 -0
  16. package/dist/core/labels.d.ts +1 -0
  17. package/dist/{index-h9e3p5Pd.js → index-25s_q0vD.js} +7 -5
  18. package/dist/{index-5gwNJ8CB.cjs → index-W3iAjkLb.cjs} +4 -4
  19. package/dist/index.cjs +1 -1
  20. package/dist/index.js +2 -2
  21. package/dist/{location-G7psbmv_.js → location-B-m9scLf.js} +82 -82
  22. package/dist/{location-D85EXiPt.cjs → location-BVEN_Ihk.cjs} +1 -1
  23. package/dist/{merge-CS3p9BVw.js → merge-B9jrWxMa.js} +1 -1
  24. package/dist/{merge-C_g05UGC.cjs → merge-DuTAponF.cjs} +1 -1
  25. package/dist/server.cjs +1 -1
  26. package/dist/server.js +1 -1
  27. package/dist/styles/markdown-explorer.css +1 -1
  28. package/dist/{useSplitPersistence-DRjsPZdH.cjs → useSplitPersistence-Ba-v64n-.cjs} +1 -1
  29. package/dist/{useSplitPersistence-B1b5Lg5E.js → useSplitPersistence-Cc4tDxB4.js} +1 -1
  30. package/docs/behavior/dom-hooks.md +1 -1
  31. package/docs/behavior/layout.md +16 -11
  32. package/docs/behavior/localization.md +2 -1
  33. package/package.json +5 -5
@@ -21,7 +21,7 @@ The tree and multi-panel views split the frame into the explorer and the content
21
21
  | Explorer maximum | 100/φ² ≈ 38.197 % | The golden section; the content keeps at least 1/φ |
22
22
  | Explorer minimum | 13rem: 13 times the root font size (208 px at the browsers' default 16 px root) | Fibonacci 13; it follows the reader's font size |
23
23
  | 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
- | Handle | A band as wide as the minimum pointer target: 24 px under a fine pointer, 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, enhanced for a coarse one). 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 |
24
+ | 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
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); on the server and in the first paint it is assumed to be 16 px.
27
27
  - The server cannot know the pointer, so the server render and the hydration render assume a fine one; under a coarse pointer the handle widens right after hydration.
@@ -76,14 +76,17 @@ Documents in the multi-panel view sit in `multiView.columns` logical columns (4
76
76
  - **Hysteresis.** A width hovering at a threshold does not flip the count: it grows only once one more column fits with a margin of g/φ (A ≥ (n + 1)m + ng + g/φ) and shrinks only once the current count no longer fits (A < nm + (n − 1)g). The count is frozen while a panel is maximized and while the reader drags the explorer's handle.
77
77
  - **Projection.** When fewer columns are visible than exist, visible column i shows the logical columns ⌊iN/n⌋ to ⌊(i + 1)N/n⌋ − 1, stacked in order. Reading order is kept, and the original arrangement returns unchanged as soon as the width allows.
78
78
  - **Rearranging while projected.** When the reader drags or moves panels while fewer columns are visible, the new arrangement is mapped back onto the logical columns by dynamic programming: the cut points inside each visible column are chosen so that the largest number of panels keeps its previous logical column (the earliest cuts win a tie). Rearranging is idempotent: applying the arrangement that is already shown changes nothing.
79
- - **Moving without a drag.** Each panel's header (drawn by `@aiquants/drag-drop-panels`) has move buttons. On a stage that shows two or more columns they are four — Move to the previous column, Move to the next column, Move up and Move down (`panelMovePreviousColumn`, `panelMoveNextColumn`, `panelMoveUp`, `panelMoveDown`); on a stage that shows one column (a phone, a narrow window), where no panel can change column, only Move up and Move down. A move the stage offers that is impossible from where the panel sits is `aria-disabled` and stays focusable.
79
+ - **Moving without a drag.** Each panel's header (drawn by `@aiquants/drag-drop-panels`) has a move menu: its button, Move the panel (`panelMove`), opens a menu of the moves the stage offers. On a stage that shows two or more columns they are four — Move to the previous column, Move to the next column, Move up and Move down (`panelMovePreviousColumn`, `panelMoveNextColumn`, `panelMoveUp`, `panelMoveDown`); on a stage that shows one column (a phone, a narrow window), where no panel can change column, only Move up and Move down.
80
+ A move that is impossible from where the panel sits stays in the menu as `aria-disabled`, focusable, and choosing it moves nothing and announces that the panel cannot make it (`panelMoveUnavailable`). A click, Enter or Space opens the menu on its first item (ArrowDown on the first, ArrowUp on the last); ArrowDown and ArrowUp go through the items (wrapping around), Home and End to the ends, Enter, Space or a click chooses, Escape closes the menu with the focus back on its button, and Tab closes it and goes on from the button.
81
+ The menu opens in the top layer through the Popover API, so in a browser without that API it does not open and the shortcuts below move the panel.
80
82
  The header's buttons show while the panel is hovered or one of them holds the focus, and always on a device that cannot hover (touch), so panels move with them on a touch screen as well.
81
83
  The same moves are keyboard shortcuts while the focus is in the panel: Alt + Shift + ← / → / ↑ / ↓ (Alt + ← / → alone stay the browser's Back / Forward). A held chord moves once, and the shortcuts are ignored in text inputs and editable content, with Ctrl or ⌘, while a panel is maximized and during a drag. A move to another visible column keeps the panel's position among that column's shown panels (its end when the column has fewer); up and down swap the panel with the neighbouring shown panel, and hidden panels keep their place.
82
84
  The layout computes a move on the visible columns the stage shows and reports it as their next arrangement; the stage maps it back like a drop, which refreshes the column memory, and the layout then shows exactly the arrangement it asked for, so it announces the move from its own live region (`panelMoved`).
83
- The focus stays where it was: when a move to another column rebuilt the panel, the element that held the focus — the move button, or the link or frame the shortcut was pressed in — takes it back without scrolling, as after any rebuild (see Reading position below), and the layout then brings it into view by the least distance. A shortcut the panel cannot follow (Alt + Shift + ← in the first column, or Alt + Shift + ← / → on a stage of one column, for example) changes nothing and is announced as unavailable (`panelMoveUnavailable`). No moves while a panel is maximized.
85
+ The focus stays with the panel: a move chosen in the menu leaves it on the menu's button, and when a move to another column rebuilt the panel, the element that held the focus — the menu's button, or the link or frame the shortcut was pressed in — takes it back without scrolling, as after any rebuild (see Reading position below), and the layout then brings it into view by the least distance.
86
+ A shortcut the panel cannot follow (Alt + Shift + ← in the first column, or Alt + Shift + ← / → on a stage of one column, for example) changes nothing and is announced as unavailable (`panelMoveUnavailable`), like an unavailable item of the menu. No moves while a panel is maximized.
84
87
  - **Touch and pen drag.** A long-press on a panel's header — its title, or anywhere outside its buttons — lifts the panel once the finger or pen has rested there for 500 ms within 10 px (`@aiquants/drag-drop-panels`' `DEFAULT_TOUCH_DRAG_CONFIG`); until then nothing is held back, so a swipe that starts on a header scrolls the stage and a tap stays a tap, and no drag state shows. A long-press on a header button starts nothing (the press belongs to the button), and a finger on a panel's body scrolls it as on any page.
85
88
  Once lifted, the stage does not scroll under the finger, a copy of the panel follows it, the drop placeholder nearest to the finger in the column under it is the target, and the stage scrolls while the finger rests near its top or bottom edge (the target follows as the stage moves). Releasing over a target moves the panel exactly like a mouse drop on that placeholder — mapped back like any rearrangement, written to the URL and the column memory — and the layout announces the move (`panelMoved`).
86
- The browser cancelling the touch, Escape, the finger leaving the layout, or a release where the panel would stay where it is changes nothing. The layout announces the lift and every cancel too (`panelDragStarted`, `panelDragCancelled`). The stage wires nothing for this: the layout runs the drag and asks for the drop through the same `onColumnPanelsChange` as the move buttons.
89
+ The browser cancelling the touch, Escape, the finger leaving the layout, or a release where the panel would stay where it is changes nothing. The layout announces the lift and every cancel too (`panelDragStarted`, `panelDragCancelled`). The stage wires nothing for this: the layout runs the drag and asks for the drop through the same `onColumnPanelsChange` as the move menu.
87
90
  - **Panel height.** A panel is as tall as its document, between stage/φ³ and stage/φ: no single panel takes more than the golden share of the stage, none shrinks below the next golden step, and a longer document scrolls inside its panel. A panel alone in its column keeps the same cap: the band below it is where a dragged panel is dropped after it and where a newly opened panel appears, so neither resizes the panel being read; maximize gives one document the whole viewport.
88
91
  The bounds hold the whole panel, header included, so the body's floor is added to the header: the panel's scroll area keeps at least three lines of text at the reader's root font size (each `1rem` × φ, never less than the viewer's own line at the default size), and where stage/φ minus the header — which wraps onto more lines at narrow widths and large text sizes — would leave less, the panel's largest height is its header plus that floor, even beyond stage/φ (a phone width with 200 % text, a 400 % zoom).
89
92
  The header is measured per panel, so the bounds follow it as it wraps again. The smallest height needs no floor: a panel at stage/φ³ shows a document shorter than that whole.
@@ -99,10 +102,11 @@ Documents in the multi-panel view sit in `multiView.columns` logical columns (4
99
102
  An image keeps its zoom across the rebuild: the panel remembers the zoom, with the size its levels are relative to, and the natural size the browser reported (forgotten when the panel moves to another document or closes), so the rebuilt viewer draws the same size and its zoom buttons take the focus back.
100
103
  The frame that receives the focus in the multi view's hand-offs (closing or hiding a panel, opening documents in panels, and the fallback above) is a `group` named after the panel's document, so a screen reader names the document; the document region inside stays the panel's only landmark.
101
104
  Rebuilding a panel requests nothing: its document is reused as it is. A panel that follows a link starts the new document at its top (or at the link's fragment), and brings that start into the stage's view with the panel when the stage had scrolled the panel's header out of it (see [The document region](#the-document-region)); a remembered position is only ever restored into the document it was taken in.
102
- - **Panel headers.** A panel's header (drawn by `@aiquants/drag-drop-panels` and named in the explorer's language, see [Localization](localization.md)) holds the panel's title and, after it, the custom drag mode's badge and the buttons: the moves the stage offers (see Moving without a drag; none while the panel is maximized), the drag-mode toggle, Hide (absent while the panel is maximized), Maximize or Restore, and Close.
105
+ - **Panel headers.** A panel's header (drawn by `@aiquants/drag-drop-panels` and named in the explorer's language, see [Localization](localization.md)) holds the panel's title and, after it, the custom drag mode's badge and at most five buttons: the move menu (see Moving without a drag; absent while the panel is maximized), the drag-mode toggle, Hide (absent while the panel is maximized), Maximize or Restore, and Close.
103
106
  On a device without any fine pointer (a touch-only phone or tablet, `not (any-pointer: fine)`) the toggle of a panel in the normal mode is not shown: touch and pen drag a panel by a long-press on its header in both modes, so there it could only stop the panel's text selection; a panel in the custom mode keeps it, so the reader can return to the normal mode, and a toggle that held the focus when it went away passes it to the header's next shown button (Hide, or Restore while the panel is maximized). The header has one or more lines.
104
- It keeps every button wholly inside the panel at any width and text size, a phone width with 200 % text included, and keeps the title readable: with a fine pointer the badge and the buttons sit beside the title, and when the title would get less than the width of a few characters (6em) there they wrap to the next line of the header, at its end, and the title takes the whole first line; under a coarse pointer (a finger) the buttons always take a line of their own below the title (the badge a line of its own above them),
105
- each button is a target of at least 44 × 44 px (WCAG 2.2 enhanced target size), rows of buttons that wrap sit 22 px apart, and Close keeps 22 px from every other button however they wrap. A title longer than its line is cut with an ellipsis.
107
+ Every button, and every item of the move menu, is a target of at least 44 × 44 px under every pointer (WCAG 2.2 enhanced target size); rows of buttons that wrap sit 22 px apart, and Close keeps 22 px from every other button however they wrap.
108
+ The header keeps every button wholly inside the panel at any width and text size, a phone width with 200 % text included, and keeps the title readable. On a device that can hover (a mouse or a touchpad, whatever the primary pointer), where the buttons show while the pointer is over the panel or one of them holds the focus, the badge and the buttons sit beside the title, and when the title would get less than the width of a few characters (5em) there they wrap to the next line of the header, at its end, and the title takes the whole first line.
109
+ On a device that cannot hover (`(hover: none)`, a phone or a tablet), where the buttons always show, they take a line of their own below the title (the badge a line of its own above them), so the title keeps the header's whole width. A title longer than its line is cut with an ellipsis.
106
110
  The stage binds the header's colours to the explorer's tokens through drag-drop-panels' neutral properties, so they follow `theme` rather than a host's `dark` class: the panel's surface, border and title are `--aqmx-surface`, `--aqmx-border` and `--aqmx-text`; the icons are `--aqmx-text-muted` (`--aqmx-text` over `--aqmx-surface-sunken` on hover); the badge and the pressed custom-mode toggle are `--aqmx-warning-text` on `--aqmx-warning-surface` — at least 3:1 for the icons and 7:1 for the title and the badge in both colour schemes.
107
111
  The bar of hidden panels, an empty column's notice and a hidden panel's stand-in during a drag take the same surface, border and text.
108
112
  The bar's restore buttons are `--aqmx-surface` on `--aqmx-accent` (`--aqmx-info-text` while hovered), and the drop placeholders of a drag draw their text, icon and dashed border in `--aqmx-accent` on `--aqmx-surface`, the placeholder a drop would land on on `--aqmx-accent-surface` — at least 4.5:1 for that text and 3:1 for the dashed border against the stage in both colour schemes. The whole header, on one line or two, stays the panel's drag handle (a long-press outside its buttons for touch and pen), and a double-click on it outside its buttons toggles maximize.
@@ -161,7 +165,7 @@ Documents in the multi-panel view sit in `multiView.columns` logical columns (4
161
165
  After a jump within the shown document — either kind of link or a table-of-contents entry, in any view, or a page's hash changed by Back or Forward — the focus moves to the element without scrolling again (a heading takes it through a temporary `tabindex="-1"`) when it was inside the document region, or fell from it to the page while the reader stayed with the region — the browser's own fragment navigation takes it off the link when the element takes no focus, and a press on the document's text drops it to the page too —, as after a link to another document's section,
162
166
  so reading and the next Tab or Shift+Tab continue from the section; focus outside the region (a page load, a page loaded with a hash included) and focus the reader moved away from it (see below) are never taken.
163
167
  - The region is the containing block of the viewer's toolbar and of any fixed element of a document, and clips them, so the toolbar sits at the region's top-right; in a panel the panel's frame clips instead, at the same top edge, and the toolbar, attached to the top of the document, scrolls away with it. The explorer sets the viewer's `--aqmd-toolbar-inset-block-start` on the region to a focus ring's extent (`--aqmx-focus-ring-width` plus `--aqmx-focus-ring-offset`), so the buttons sit that far below the edge and a focused button's ring is drawn whole.
164
- The toolbar's buttons — alignment, style and table of contents — form one row in that visual and Tab order, spaced in rem, so at any text size they never overlap and each stays at least 24 × 24 CSS px.
168
+ The toolbar's buttons — alignment, style and table of contents — form one row in that visual and Tab order, spaced in rem, so at any text size they never overlap and each stays at least 44 × 44 CSS px under every pointer.
165
169
  The document's column fills its pane (the viewer's `[data-aqmd-content]` takes the track's full width): the explorer gives the viewer a `width` or `maxWidth` only where a single-view embed asks for one (`?width=` / `?maxWidth=`), each capped at the pane's width (`min(<value>, 100%)`, so a width wider than the pane never makes every line scroll sideways), so the alignment button, which places only a column narrower than its track, shows only there; the tree view, a single view without those parameters and a maximized panel show the style and table-of-contents buttons.
166
170
  A Mermaid gantt chart is drawn at the width of its slot (and again, after a short debounce, when a split or the window changes that width), so it keeps its natural height.
167
171
  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`.
@@ -289,17 +293,18 @@ Space needs no such rule on buttons, which act when the key is released, and a t
289
293
  ## Rhythm
290
294
 
291
295
  - 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.
292
- - Header rows, icon buttons, menu items, tree rows and the retry button of a folder that failed to load are one control high: 34 px (2.125rem), and 44 px (2.75rem) under a coarse pointer, the WCAG 2.2 enhanced target size. The tree measures `--aqmx-control` at run time, so its rows follow the pointer, the root font size and a host's token override. The sheet's toggle and close button are 44 px under every pointer, and the resize handles are 24 px bands under a fine pointer (see [The split](#the-split) and [The editor's split](#the-editors-split)).
296
+ - 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 sheet's toggle and 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).
297
+ 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)).
293
298
  - 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.
294
299
  - 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`).
295
300
  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. 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.
296
301
  The stage's bar sits in 8 px the stage adds to the inline end of its padding, and has no circle: 80 px before that bar a circle would cover the right-most panel next to that panel's own circle, and a gutter that holds it (53 px) 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.
297
- - 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, under a coarse pointer and at large font sizes.
302
+ - 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.
298
303
  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.
299
304
  - 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) and the tree's fade while an expansion is pending (a transition `@aiquants/directory-tree` sets on the tree's root element) included. The drag-and-drop panels follow the setting as well: `@aiquants/drag-drop-panels` leaves out its own transitions and its reorder animation.
300
305
  - Line heights are 1 + 1/φ² ≈ 1.382 for the interface and φ ≈ 1.618 for the explorer's own prose (callouts and empty states). A document's text keeps the line height that `@aiquants/markdown` and the document style set (not φ).
301
306
  - The type scale is 13, 16 and 21 px (0.8125, 1 and 1.3125rem) for body text, titles and display text: 13 and 21 are consecutive Fibonacci numbers (their ratio ≈ φ), and 16 sits near their geometric mean.
302
- Under a coarse pointer the body text is 16 px (1rem, the reader's root size), as the controls grow to 44 px there: it is the size phones read at, and below it Safari on iOS zooms the page into a focused field such as the source switch. Titles keep 16 px there and stand out by their weight, as the platforms' own headline styles do. Tree rows are in the body size (the explorer overrides `@aiquants/directory-tree`'s own 12 px), and a document's text in that of its document style.
307
+ Under a coarse pointer the body text is 16 px (1rem, the reader's root size): it is the size phones read at, and below it Safari on iOS zooms the page into a focused field such as the source switch. Titles keep 16 px there and stand out by their weight, as the platforms' own headline styles do. Tree rows are in the body size (the explorer overrides `@aiquants/directory-tree`'s own 12 px), and a document's text in that of its document style.
303
308
  - Loading skeleton lines are 61.8 %, 100 % and 85.4 % wide (1/φ, 1 and 1 − 1/φ⁴).
304
309
 
305
310
  ## Colour
@@ -12,7 +12,8 @@ This page is part of the host-facing contract of `@aiquants/markdown-explorer`;
12
12
  `viewerMermaidPanUp`, `viewerMermaidPanDown`, `viewerMermaidPanLeft`, `viewerMermaidPanRight` for the buttons that move the view while the drawing overflows its frame, `viewerMermaidRetry`, and `viewerMermaidDiagram`, the name of the diagram's focusable frame), 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).
13
13
  A label the viewer receives carries no `lang` of its own, so it is read in the page's language. Where the viewer's own built-in label is in a catalog's language, the catalog repeats it word for word (the English catalog the viewer's English labels, such as `Display Style` and `Zoom In`; the Japanese catalog its Japanese ones, such as `目次を開く`), writing a full-width form in half-width (`拡大縮小+移動 (左ドラッグ)` for the viewer's `拡大縮小+移動 (左ドラッグ)`).
14
14
  - The explorer passes `treeEntryKindDirectory` and `treeEntryKindFile` (the kind words in the rows' accessible names) and `treeScrollUp`, `treeScrollDown`, `treeScrollToTop` and `treeScrollToBottom` (the tree's scroll bar) to `@aiquants/directory-tree`.
15
- - The explorer passes every string the multi view's drag-and-drop layout shows to `@aiquants/drag-drop-panels`: the panel headers' buttons (`panelSwitchToCustomDrag`, `panelSwitchToNormalDrag`, `panelMovePreviousColumn`, `panelMoveNextColumn`, `panelMoveUp`, `panelMoveDown`, `panelHide`, `panelMaximize`, `panelRestore`, `panelClose`) and the custom drag mode's badge (`panelCustomDragBadge`), the move announcements (`panelMoved`, `panelMoveUnavailable`), a touch or pen drag's lift and cancel announcements (`panelDragStarted`, `panelDragCancelled`), the bar of hidden panels (`hiddenPanelsTitle`)
15
+ - The explorer passes every string the multi view's drag-and-drop layout shows to `@aiquants/drag-drop-panels`: the panel headers' buttons (`panelMove`, `panelSwitchToCustomDrag`, `panelSwitchToNormalDrag`, `panelHide`, `panelMaximize`, `panelRestore`, `panelClose`), the items of their move menus (`panelMovePreviousColumn`, `panelMoveNextColumn`, `panelMoveUp`, `panelMoveDown`) and the custom drag mode's badge (`panelCustomDragBadge`),
16
+ the move announcements (`panelMoved`, `panelMoveUnavailable`), a touch or pen drag's lift and cancel announcements (`panelDragStarted`, `panelDragCancelled`), the bar of hidden panels (`hiddenPanelsTitle`)
16
17
  , a hidden panel's stand-in while a panel is dragged (`hiddenPanelBadge`, `hiddenPanelNotice`), the drop placeholders (`panelDropHere`), an empty column's text (`multiColumnEmpty`) and the name of each column's region (`multiColumnRegion`).
17
18
  The stage never lets the reader resize its columns, so the layout renders no column resize handle and the catalog has no key for that handle's name. A label the layout receives carries no `lang` of its own, so it is read in the page's language, like the explorer's other strings.
18
19
  - `treeRegion` names the tree itself, apart from `explorerRegion`, which names the explorer's landmark (and the sheet on narrow frames).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aiquants/markdown-explorer",
3
- "version": "0.17.0",
3
+ "version": "0.18.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"
@@ -69,8 +69,8 @@
69
69
  },
70
70
  "peerDependencies": {
71
71
  "@aiquants/directory-tree": "^4.1.1",
72
- "@aiquants/drag-drop-panels": "^0.11.0",
73
- "@aiquants/markdown": "^8.0.0",
72
+ "@aiquants/drag-drop-panels": "^0.12.0",
73
+ "@aiquants/markdown": "^8.1.0",
74
74
  "@aiquants/resize-panels": "^2.2.0",
75
75
  "@aiquants/virtualscroll": "^3.20.0",
76
76
  "react": "^19.2.7",
@@ -79,8 +79,8 @@
79
79
  },
80
80
  "devDependencies": {
81
81
  "@aiquants/directory-tree": "4.1.1",
82
- "@aiquants/drag-drop-panels": "0.11.0",
83
- "@aiquants/markdown": "8.0.0",
82
+ "@aiquants/drag-drop-panels": "0.12.0",
83
+ "@aiquants/markdown": "8.1.0",
84
84
  "@aiquants/resize-panels": "2.2.0",
85
85
  "@aiquants/virtualscroll": "3.20.0",
86
86
  "@heroicons/react": "^2.2.0",