@aiquants/markdown-explorer 0.33.0 → 0.35.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 (146) hide show
  1. package/CHANGELOG.md +795 -0
  2. package/README.md +119 -55
  3. package/dist/EditSurface-CLG70Vnn.cjs +6 -0
  4. package/dist/EditSurface-D2j1kCEE.js +990 -0
  5. package/dist/ExplorerSplit-CfP1smbT.js +1589 -0
  6. package/dist/ExplorerSplit-D_0VohOv.cjs +2 -0
  7. package/dist/{MultiLayout-DYNGlNy0.js → MultiLayout-BeJ5Lubb.js} +291 -290
  8. package/dist/MultiLayout-CxV5SI7f.cjs +1 -0
  9. package/dist/NativeScrollBar-BM5NULzg.js +62 -0
  10. package/dist/NativeScrollBar-RWXpVhbI.cjs +1 -0
  11. package/dist/TreeLayout-AxLw-36S.js +103 -0
  12. package/dist/TreeLayout-Bg2YH-EY.cjs +1 -0
  13. package/dist/client/MarkdownExplorer.d.cts +14 -1
  14. package/dist/client/MarkdownExplorer.d.ts +14 -1
  15. package/dist/client/edit/lineEndings.d.cts +4 -0
  16. package/dist/client/edit/lineEndings.d.ts +4 -0
  17. package/dist/client/hostContract.d.cts +67 -0
  18. package/dist/client/hostContract.d.ts +67 -0
  19. package/dist/core/config.d.cts +7 -0
  20. package/dist/core/config.d.ts +7 -0
  21. package/dist/core/contracts.d.cts +10 -4
  22. package/dist/core/contracts.d.ts +10 -4
  23. package/dist/core/draftAnswer.d.cts +23 -0
  24. package/dist/core/draftAnswer.d.ts +23 -0
  25. package/dist/core/geometry.d.cts +1 -0
  26. package/dist/core/geometry.d.ts +1 -0
  27. package/dist/core/labels.d.cts +78 -0
  28. package/dist/core/labels.d.ts +78 -0
  29. package/dist/core/location.d.cts +3 -2
  30. package/dist/core/location.d.ts +3 -2
  31. package/dist/core/ownUrls.d.cts +15 -0
  32. package/dist/core/ownUrls.d.ts +15 -0
  33. package/dist/core/treeSettings.d.cts +3 -2
  34. package/dist/core/treeSettings.d.ts +3 -2
  35. package/dist/core/viewSettings.d.cts +5 -1
  36. package/dist/core/viewSettings.d.ts +5 -1
  37. package/dist/describeValue-CLlVRO8d.js +17 -0
  38. package/dist/describeValue-Ccvhbt36.cjs +1 -0
  39. package/dist/explorerCore-DLpDuSev.js +998 -0
  40. package/dist/explorerCore-DYrxS9ez.cjs +1 -0
  41. package/dist/index-C1YMH-yI.js +5816 -0
  42. package/dist/index-LQWQfpAf.cjs +18 -0
  43. package/dist/index.cjs +1 -1
  44. package/dist/index.d.cts +7 -4
  45. package/dist/index.d.ts +7 -4
  46. package/dist/index.js +47 -42
  47. package/dist/licenses/@heroicons/react/LICENSE +21 -0
  48. package/dist/licenses/entities/LICENSE +11 -0
  49. package/dist/licenses/parse5/LICENSE +19 -0
  50. package/dist/location--KvTA0Ri.js +726 -0
  51. package/dist/location-D8DyDkuA.cjs +1 -0
  52. package/dist/lru-DC8GBmkX.js +39 -0
  53. package/dist/lru-SGmUyBQU.cjs +1 -0
  54. package/dist/{merge-D7L_pINl.js → merge-Bb_HpPhe.js} +1 -1
  55. package/dist/{merge-DZI4pkWI.cjs → merge-DQUYEGCx.cjs} +1 -1
  56. package/dist/nestingGuardWorker.js +5511 -0
  57. package/dist/ownUrls-B259RGgd.cjs +1 -0
  58. package/dist/ownUrls-Dh5g6ZJi.js +370 -0
  59. package/dist/sanitizeJob-BYRk17nr.js +21 -0
  60. package/dist/sanitizeJob-Cs9o3Vpl.cjs +1 -0
  61. package/dist/sanitizePolicy-CEMdaLUB.js +139 -0
  62. package/dist/sanitizePolicy-CiQfnxyd.cjs +2 -0
  63. package/dist/sanitizeWorker.cjs +1 -1
  64. package/dist/sanitizeWorker.js +134 -139
  65. package/dist/sanitizerService-BY4CPCoA.cjs +1 -0
  66. package/dist/sanitizerService-KWXv7bPm.js +240 -0
  67. package/dist/server/assetResponse.d.cts +60 -0
  68. package/dist/server/assetResponse.d.ts +60 -0
  69. package/dist/server/browser/browserPlatform.d.cts +12 -0
  70. package/dist/server/browser/browserPlatform.d.ts +12 -0
  71. package/dist/server/createMarkdownExplorer.d.cts +0 -10
  72. package/dist/server/createMarkdownExplorer.d.ts +0 -10
  73. package/dist/server/explorerCore.d.cts +12 -0
  74. package/dist/server/explorerCore.d.ts +12 -0
  75. package/dist/server/fileSystemSource.d.cts +1 -0
  76. package/dist/server/fileSystemSource.d.ts +1 -0
  77. package/dist/server/inProcessFetch.d.cts +5 -0
  78. package/dist/server/inProcessFetch.d.ts +5 -0
  79. package/dist/server/platform.d.cts +18 -0
  80. package/dist/server/platform.d.ts +18 -0
  81. package/dist/server/ports.d.cts +36 -5
  82. package/dist/server/ports.d.ts +36 -5
  83. package/dist/server/sanitizeProtocol.d.cts +3 -0
  84. package/dist/server/sanitizeProtocol.d.ts +3 -0
  85. package/dist/server/sanitizer.d.cts +5 -40
  86. package/dist/server/sanitizer.d.ts +5 -40
  87. package/dist/server/sanitizerOptions.d.cts +24 -0
  88. package/dist/server/sanitizerOptions.d.ts +24 -0
  89. package/dist/server/sanitizerService.d.cts +41 -0
  90. package/dist/server/sanitizerService.d.ts +41 -0
  91. package/dist/server/{workerPool.d.cts → workerJobs.d.cts} +0 -16
  92. package/dist/server/{workerPool.d.ts → workerJobs.d.ts} +0 -16
  93. package/dist/server.cjs +1 -1
  94. package/dist/server.d.cts +3 -1
  95. package/dist/server.d.ts +3 -1
  96. package/dist/server.js +270 -1343
  97. package/dist/serverBrowser.cjs +1 -0
  98. package/dist/serverBrowser.d.cts +1 -0
  99. package/dist/serverBrowser.d.ts +1 -0
  100. package/dist/serverBrowser.js +120 -0
  101. package/dist/serverCore.cjs +1 -0
  102. package/dist/serverCore.d.cts +14 -0
  103. package/dist/serverCore.d.ts +14 -0
  104. package/dist/serverCore.js +46 -0
  105. package/dist/storage-BpYsprog.cjs +1 -0
  106. package/dist/{storage-CmGHg7OA.js → storage-D1uSw-xj.js} +19 -18
  107. package/dist/storage.cjs +1 -1
  108. package/dist/storage.js +1 -1
  109. package/dist/styles/markdown-explorer.css +1 -1
  110. package/dist/tapScrollCircle-BEydRn0y.js +14 -0
  111. package/dist/tapScrollCircle-DdX0Wri0.cjs +1 -0
  112. package/dist/testing.cjs +1 -0
  113. package/dist/testing.d.cts +6 -0
  114. package/dist/testing.d.ts +6 -0
  115. package/dist/testing.js +4 -0
  116. package/dist/useSplitPersistence-B2Fj508K.cjs +1 -0
  117. package/dist/useSplitPersistence-Fkqak8G8.js +44 -0
  118. package/docs/behavior/dom-hooks.md +14 -3
  119. package/docs/behavior/hosting.md +123 -0
  120. package/docs/behavior/layout.md +69 -19
  121. package/docs/behavior/localization.md +28 -10
  122. package/docs/behavior/security.md +34 -14
  123. package/docs/behavior/url-contract.md +13 -6
  124. package/package.json +54 -16
  125. package/dist/EditSurface-BPqqykro.cjs +0 -6
  126. package/dist/EditSurface-CWq35IWQ.js +0 -972
  127. package/dist/ExplorerSplit-BRY4uy6x.js +0 -1493
  128. package/dist/ExplorerSplit-CQxr6b0v.cjs +0 -1
  129. package/dist/MultiLayout-TXbet9k3.cjs +0 -1
  130. package/dist/NativeScrollBar-BsWdvkHa.js +0 -64
  131. package/dist/NativeScrollBar-UpjxjLlB.cjs +0 -1
  132. package/dist/TreeLayout-BQEgZhz9.js +0 -72
  133. package/dist/TreeLayout-C0O1OGi4.cjs +0 -1
  134. package/dist/dataRoute-DLhQfdoW.js +0 -298
  135. package/dist/dataRoute-DwYtgyt6.cjs +0 -1
  136. package/dist/index-CO-RgTml.js +0 -4912
  137. package/dist/index-DSkK8iLE.cjs +0 -15
  138. package/dist/location-BxiJRTyw.cjs +0 -1
  139. package/dist/location-perTmwct.js +0 -663
  140. package/dist/sanitizePolicy-By0tKOpZ.js +0 -98
  141. package/dist/sanitizePolicy-T5T-3vV5.cjs +0 -1
  142. package/dist/storage-DM0EvkVf.cjs +0 -1
  143. package/dist/tapScrollCircle-CRKZremf.js +0 -12
  144. package/dist/tapScrollCircle-Cbf17x8g.cjs +0 -1
  145. package/dist/useSplitPersistence-Du01PHNg.js +0 -42
  146. package/dist/useSplitPersistence-pPmE4GTT.cjs +0 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,800 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.35.0 (2026-11-10) — The server half runs in the page on a browser runtime, a host drives the explorer through props and a handle, and each document carries its language
4
+
5
+ ### Breaking
6
+
7
+ - **The peers `@aiquants/markdown` and `@aiquants/resize-panels` are `^13.0.0` and `^2.3.0` (hosts).** The explorer
8
+ offers the reader's column width and colour pair in markdown 13.0.0's display popover (`CONTENT_MEASURES` and
9
+ `CONTENT_COLORS` of `@aiquants/markdown/viewer-settings`) and names the popover's sections and a diagram's notices,
10
+ marks a document's content with its language (`contentLang`) and the labels it passes with the UI language
11
+ (`labelsLang`), hands a document's tables the size of its bars' tap-scroll circle (`spreadsheetTapScrollCircle`'s
12
+ `size`), and builds the browser runtime's link-card handler from `@aiquants/markdown/link-cards`; resize-panels
13
+ 2.3.0 draws the placeholder of a split that cannot fit its panels in the explorer's labels (`PanelGroup`'s
14
+ `labels`, `PanelGroupLabelKey`). On Node.js the `link-card` operation serves markdown 13.0.0's handler, which opens
15
+ pages only through the markdown service and without it answers its own `500` (`no-store`), so a host that serves
16
+ link cards without converting through the service now needs it. markdown 13.0.0's other breaking changes concern a
17
+ host's own conversions and the markdown service (see its changelog).
18
+ - **The two types named `ExplorerDraft` are renamed by role, and the unsaved draft the handle restores gets a name of
19
+ its own (hosts).** `ExplorerDraft` from `.` (`{ path, text }`, what `ExplorerDraftConverter.convert` receives) is
20
+ now `ExplorerPreviewDraft`; `ExplorerDraft` from `./server` (`{ text, baseVersion }`, what the `edit.save` port
21
+ receives) is now `ExplorerHostSaveDraft`. Their shapes are unchanged: rename the imports. `ExplorerUnsavedDraft` is
22
+ the new unsaved draft that `restoreDrafts()` takes and `onDraftChange` reports.
23
+ - **Each Markdown and text document carries its language as a canonical BCP 47 tag its source declares (hosts).** The
24
+ `markdown` and `text` documents of `ExplorerHostDocument` (`./server`) and of `ExplorerDocument` (`.`) carry a
25
+ required `lang`, the language their content is written in, apart from the explorer's `locale`: a non-empty string
26
+ that `Intl.getCanonicalLocales()` writes back unchanged (`"ja"`, `"en-US"` and `"zh-Hant-TW"` pass; `"EN"`,
27
+ `"en-us"`, `"en_US"` and `"iw"` do not). A host's `document` port answers it from its source's settings; an answer
28
+ without it, or with a tag off the rule, breaks the contract (a `TypeError`) and the document's load is `failed`.
29
+ `createFileSystemSource()` takes a required `lang`, which its Markdown and text documents carry: a value that is not
30
+ a string, an omitted one included, throws a `TypeError`, and a string off the rule a `RangeError` naming it. The
31
+ data route's `text` operation names no language, since it shows any file as written.
32
+ - **The HTML of a document and of the editing preview keeps a URL of the app itself only under the path its use allows
33
+ (hosts, readers).** The sanitizers, on the server and in the preview, know the app's own URLs from the
34
+ configuration: its origins (`appOrigins`), the data path for images and other resources, `basePath` and the data
35
+ path for links, and for the `src` of a `video`, an `audio` or a `source` also the media path (`mediaDataPath`). A
36
+ path-only URL, and an absolute one whose origin `appOrigins` lists (its scheme, host and port) or whose scheme is
37
+ that of a listed origin with a scheme that is not special (such as `wails:`, whatever its host), stays only when its
38
+ normalised path is the one its use allows or continues it after a `/`; a URL on the media path's origin alone stays
39
+ only as a media `src` under the media path. A protocol-relative URL (`//host/…`) stays only when it does under every
40
+ scheme the page may have, and an absolute URL that does not parse is dropped. A relative URL stays in a document
41
+ link (an HTML `a` with `data-link-kind="doc"`) and, without a `.` or `..` segment (`%2e` included), in any other
42
+ link; an SVG reference keeps a fragment only, and an image's or a media file's relative URL is dropped. A URL is
43
+ read as WHATWG reads it (leading and trailing C0 controls and spaces trimmed, tabs and newlines removed), one with a
44
+ backslash is dropped from any use, a `srcset` stays only when every candidate does, and the presentation attributes
45
+ (`clip-path`, `color-profile`, `cursor`, `fill`, `filter`, `marker-start`, `marker-mid`, `marker-end`, `mask`,
46
+ `stroke`) drop a value with a backslash, an image function or a `url(` whose argument does not start with `#`.
47
+ Absolute URLs of other origins stay as before. `video` and `audio` always carry `preload`: `none` where the document
48
+ wrote `none`, `metadata` otherwise. A host names its origins in `appOrigins` and its media path in `mediaDataPath`;
49
+ a document whose HTML reaches the app elsewhere (an image or a media file outside the data path, a relative link
50
+ with `..` that is not a document link) loses those URLs until they point under the allowed paths.
51
+ - **HTML nested deeper than 256 levels is refused as too large, in every runtime (readers, hosts).** The sanitizer's
52
+ nesting limit is 256 levels (it was 512), one value on the server, in the browser runtime and in the editing
53
+ preview: a document with an element placed deeper is `too-large`. The limit keeps a margin for the parsers to agree.
54
+ - **A path segment still percent-encoded after three decodes is denied (hosts, readers).** Deny rules that have at
55
+ least one pattern also deny a path segment or an entry name that one more lenient decode would still change after
56
+ the three they look through, whichever patterns they have, as the Go path rules that run the same table
57
+ (`./testing`) do; rules without a pattern (`deny: []`) deny nothing.
58
+ - **The `sanitizer` setting must be a plain object (hosts).** `createMarkdownExplorer`'s `sanitizer` and the browser
59
+ runtime's accept only a plain object: an array, a class instance or a `Map` throws a `TypeError`
60
+ (`[markdown-explorer] sanitizer must be a plain object of { … }`, naming the fields: `workers`, `deadlineMs`,
61
+ `maxHtmlBytes`, `cacheBytes`, `workerHeapMb`, `jobsPerScope` and `maxQueuedJobs` on Node, the same without `workers`
62
+ and `workerHeapMb` in the browser). Both refuse the five fields they share in the same order with the same messages;
63
+ a valid setting behaves as before.
64
+ - **A brace outside a placeholder is refused in every template label (hosts).** A template label
65
+ (`MARKDOWN_EXPLORER_LABEL_TEMPLATES`) holds braces only as its `{name}` placeholders, in both catalogs and in a
66
+ host's overrides: those the explorer passes to `@aiquants/drag-drop-panels` (the panels'), to
67
+ `@aiquants/resize-panels` (the split placeholder's details) and to `@aiquants/markdown` (a table block's, derived
68
+ from its catalog, and an SVG image's). An unclosed or unopened brace, a doubled one, an empty `{}` or a name with a
69
+ space throws a `RangeError` naming its position when the labels are resolved; the catalogs' own templates have none.
70
+
71
+ ### Added
72
+
73
+ - **The host contract (hosts).** `MarkdownExplorer` takes as props what a host that embeds it exchanges with it, each
74
+ defaulting to what a web page does (the default in parentheses): `fetch` for the data requests and the link cards
75
+ (the global `fetch`), `persistSettings(serialized)`, which stores the serialized view settings where the server's
76
+ `readSettings` finds them (the settings cookie), `subscribeHostChanges` with `hostChangePolicy` (`"reload"`, or
77
+ `"notify"`), `guardUnload` (`true`: leaving the page with an unsaved draft asks through `beforeunload`; a host that
78
+ asks on close itself passes `false`), `onReload` (the page's reload), `onSessionEnded` (none), `onDraftChange`
79
+ (none), `accountState` (`"signed-in"`, or `"signed-out"`), `confirmUnversionedSaves` (`false`), `paletteKey` (none),
80
+ an opaque name of the palette a host binds the explorer's colour roles to, whose change makes the explorer read
81
+ again the colours it paints itself (the tree's canvas lines), and `ref`. It checks them on every render (a function
82
+ or a flag of the wrong type, or a `paletteKey` that is not a string, throws a `TypeError`; a value outside its set
83
+ or an empty `paletteKey` a `RangeError`) and always calls the latest function given, without rebuilding its
84
+ transport or redrawing its context. `EXPLORER_HOST_CHANGE_POLICIES` and `EXPLORER_ACCOUNT_STATES` list the two sets
85
+ (`ExplorerHostChangePolicy`, `ExplorerAccountState`), and `.` exports the contract's types: `ExplorerHostChange`,
86
+ `ExplorerMediaFailure`, `ExplorerUnsavedDraft`, `ExplorerDraftChange`, `ExplorerDraftRestore`,
87
+ `MarkdownExplorerHandle` and `LineEnding`.
88
+ - **The handle (hosts).** `ref` receives a `MarkdownExplorerHandle`, the same value while the explorer renders, which
89
+ acts on the current reader's explorer when it is called: `flushUnsaved()` writes out the pending edits and returns
90
+ the paths left unsaved; `confirmDiscard(paths)` asks once about the unsaved ones among them and resolves `true`
91
+ without asking when there are none; `restoreDrafts(drafts)` brings a host's `ExplorerUnsavedDraft`s back as unsaved
92
+ drafts, as they were where their base version is still the document's and through a save's three-way merge where it
93
+ is not, and resolves the paths it restored and those it could not with the reason (a read's failure, `forbidden`
94
+ where the reader must grant a permission first, `failed` where the reader already edits the document, whose draft
95
+ stays); `announce(text)` speaks through the explorer's live region; `owns(element)` tells whether the element is
96
+ inside the explorer's root; and `reportMediaFailure(failure)` reports a media URL that failed
97
+ (`ExplorerMediaFailure`). Each checks its arguments and throws, or rejects where it returns a promise.
98
+ - **Changes the host saw elsewhere (hosts, readers).** `subscribeHostChanges(listener)` hands the explorer each
99
+ `ExplorerHostChange`, `{ sourceIds, paths }`. A listed source's tree is read again while a view shows it, that
100
+ source alone (one no view shows is only marked stale). A listed document that a pane shows, has loaded and the
101
+ reader is not editing follows `hostChangePolicy`: `"reload"` reads it again and announces
102
+ `documentReloadedAfterChange(name)`, or shows the notice when it cannot read it, and `"notify"` shows a notice above
103
+ the document, `documentChangedElsewhere(name)` with Reload. The explorer subscribes again when the function or the
104
+ reader changes and applies nothing that arrives after the unsubscribe; a subscribe that returns no unsubscribe
105
+ function throws.
106
+ - **Drafts kept outside the page (hosts).** `onDraftChange` receives, at the end of the task that changed them, the
107
+ drafts as the explorer writes them, those changed since the last call (`kept`), and the paths whose drafts ended:
108
+ saved, discarded, closed, or back to the text they started from (`ended`); its first call holds every draft unsaved
109
+ by then. The explorer listens only while a function is given, and not again when only the function changes; the
110
+ handle's `restoreDrafts` brings a kept copy back.
111
+ - **A save to a source that keeps no previous versions can ask first (hosts, readers).** With
112
+ `confirmUnversionedSaves`, a save that would write a change to a document whose source keeps no previous versions
113
+ (`history: false`), from the bar's Save or the editor's Mod-S, writes out the editor's pending keystrokes and asks:
114
+ `unversionedSaveTitle` («Save without keeping the previous version?» / 「前の版を残さずに保存しますか?」) and
115
+ `unversionedSaveBody`, with `unversionedSaveConfirm` («Save» / 「保存する」) and the existing `unsavedStay` to keep
116
+ editing. The confirmation sits outside the editing surface, so Ctrl+E inside it does not switch the view.
117
+ - **Sign-in and reload on a failure (hosts, readers).** A failure's Reload calls `onReload` and, when `guardUnload` is
118
+ `false`, first asks about the unsaved drafts. With `onSessionEnded`, an `unauthorized` failure (an ended session)
119
+ offers the host's sign-in without leaving the page: the function resolves `true` once the reader is signed in again,
120
+ and the failed view tries again (calls made while a sign-in is open share its answer; a failed or cancelled sign-in
121
+ resolves `false`). `accountState` picks the words, which name no service (a host names its own through `labels`):
122
+ `failureUnauthorizedSignInBody` («Sign in again to continue.» / 「もう一度サインインすると続けられます。」) with
123
+ `signInAgain` («Sign in again» / 「もう一度サインイン」) while signed in, and `failureUnauthorizedSignedOutBody`
124
+ («Sign in to open it.» / 「サインインすると開けます。」) with `signIn` («Sign in» / 「サインイン」) while signed
125
+ out. Without `onSessionEnded` the failure offers the reload.
126
+ - **Media failures (readers, hosts).** The explorer hears the media events inside its root, following the root a host
127
+ frame that differs per view recreates, and with the reports of the handle's `reportMediaFailure` tells, in the order
128
+ they come, a file it could not load from one it cannot play. The notice names one file (`mediaLoadFailed(name)`,
129
+ `mediaUnplayable(name)`) or counts several (`mediaLoadFailedCount(count)`, `mediaUnplayableCount(count)`); the one
130
+ of files that could not be loaded has Reload, which loads them again, and the one of files that cannot be played has
131
+ none. A report's `final` tells whether the host's cut is final: a final cut shows the notice at once, any other once
132
+ the element stalls or fails, since it reads again on its own; a reported PDF frame shows it at once.
133
+ - **Notices above the document (readers).** The changes made elsewhere and the media failures show in a
134
+ `role="status"` container between the document's refresh bar and the document region
135
+ (`markdown-explorer-document-notices`, each notice `markdown-explorer-document-notice` with `data-aqmx-notice`:
136
+ `changed`, `media-load` or `media-unplayable`); the first two offer `reload` («Reload» / 「読み込み直す」).
137
+ - **Announcements wait while a block is full screen (readers).** While a block of the document is full screen (its
138
+ dialog open as `:modal`), the explorer's announcements, the host's `announce` included, wait; when the block leaves
139
+ full screen they are spoken together in the order they came, a sentence that repeats the one before it dropped.
140
+ - **The reader's column width and colours (readers, hosts).** A page view's display popover offers the column width
141
+ and the colour pair (markdown 13.0.0's width and colours sections), as a panel's does while it is maximized; an
142
+ embed's `?showStyle=false` hides them with the style, and the editing preview shows neither. The choice is kept with
143
+ the display settings: `ExplorerViewSettings` has `measure` and `documentColors`, which the cookie writes after
144
+ `align`, each only as one of `@aiquants/markdown`'s `CONTENT_MEASURES` and `CONTENT_COLORS`. Any other value is
145
+ dropped with its key (the document then shows the viewer's own default), no other key name is read for them, and a
146
+ cookie without them reads and is written back as before.
147
+ - **A document's language (readers).** A Markdown or text document's `lang` marks its content for the viewer
148
+ (`contentLang`, markdown 13.0.0), rendered, shown as written or previewed while editing, so the content is read in
149
+ its own language.
150
+ - **The explorer's labels keep the UI language inside a document (readers).** The labels the explorer passes
151
+ `MarkdownViewer` carry the UI language (`labelsLang`), so every element they name declares it itself: the controls
152
+ the viewer draws inside the content (a code block's copy button, a diagram's controls, an embed frame's title) and
153
+ those of its bar. The explorer's own controls declare no language and read in the page's; a table file's grid is not
154
+ marked, as a table file names no language. An inert link's reason (`inertLink`: its `title` and its announced text)
155
+ reads in the UI language while the link's text keeps its own language and direction, moved to an inner span; where
156
+ the content names no language, the link declares none.
157
+ - **Fragment-only links under any router (readers, hosts).** In a page view a plain click on a fragment-only link
158
+ moves to its target once whatever the router, a memory router (as a desktop webview has) included: the explorer
159
+ follows the location the router made of the browser's own fragment navigation, or the click where it made none. `#`
160
+ keeps going to the top.
161
+ - **The split's placeholder reads in the explorer's language (readers, hosts).** When a split's panels cannot fit it,
162
+ `@aiquants/resize-panels` draws a placeholder over them, whose texts are now the explorer's labels
163
+ `panelGroupMinimumExceededSummary` and `panelGroupMinimumExceededDetail` (`{required}`, `{available}`), and
164
+ `panelGroupMaximumInsufficientSummary` and `panelGroupMaximumInsufficientDetail` (`{total}`, `{needed}`), the
165
+ English word for word resize-panels' own. The explorer passes all four to `PanelGroup`'s `labels` whichever a host
166
+ overrides; they carry no `lang`, so the placeholder, outside any document's language, reads in the page's.
167
+ - **Labels for markdown 13.0.0's display popover and diagram notices (hosts, readers).** `viewerStyleSectionTitle`
168
+ («Style» / 「スタイル」) heads the popover's style section; `viewerMeasureTitle` («Width» / 「幅」) with
169
+ `viewerMeasureFill` and `viewerMeasureReading`, and `viewerColorsTitle` («Colors» / 「配色」) with
170
+ `viewerColorsDefault`, `viewerColorsSepia`, `viewerColorsDarkLowGlare` and `viewerColorsHighContrast`, name the
171
+ width and colours sections and their choices; `viewerMermaidLoading`, `viewerMermaidInitializationFailed`,
172
+ `viewerMermaidRenderFailed` and `viewerMermaidEmptyDrawing` are a diagram's notices while it is drawn and when it
173
+ cannot be. The English catalog repeats the viewer's built-in texts, and the viewer receives all of them in the UI
174
+ language.
175
+ - **Labels for a diagram's source view and the names of the diagram types (hosts, readers).** `viewerMermaidSource`
176
+ («Source» / 「ソース」) names the toggle that shows a diagram's source in place of the drawing,
177
+ `viewerMermaidSourceRegion` («Diagram source» / 「図のソース」) the region that holds the source, and
178
+ `viewerMermaidCopySource`, `viewerMermaidCopiedSource` and `viewerMermaidCopySourceFailed` that region's Copy button
179
+ and its outcomes; the 31 `viewerMermaidType…` keys (`viewerMermaidTypeFlowchart` «Flowchart» / 「流れ図」,
180
+ `viewerMermaidTypeSequence` «Sequence diagram» / 「シーケンス図」 and the others) name the diagram types, which the
181
+ drawing carries as its role description in place of the type code Mermaid writes. The English catalog repeats the
182
+ viewer's built-in texts, and the viewer receives all of them in the UI language. The viewer reads them from the
183
+ `@aiquants/markdown` release that adds the source view and the type names; an earlier one reads only its own keys.
184
+ - **The server core (hosts).** `./server/core` is the server half without a runtime:
185
+ `createExplorerServer(config, platform)` runs on an `ExplorerServerPlatform` (`prepareScope`, `createSanitizer`,
186
+ `createLinkCardHandler`, with `SanitizerSetup`) and takes an `ExplorerServerCoreConfig`: the configuration
187
+ `createMarkdownExplorer` takes (`ExplorerServerSharedConfig`) without `scopeSecret`, with the `sanitizer` limits
188
+ every runtime accepts, and with a required `readSettings(request)`, which returns the request's serialized view
189
+ settings or `undefined` (any other answer throws a `TypeError`), and a required `assetMaxRangeBytes`. A platform's
190
+ scope must be 22 base64url characters for every principal key, or the core throws a `TypeError`. The entry also
191
+ exports `createInProcessDataFetch`, `ASSET_CONTENT_SECURITY_POLICIES`, the rules a host shares with the explorer
192
+ (the deny rules, the document-path and source-id rules, `EXPLORER_MAX_HEADINGS`, the text decoding),
193
+ `ExplorerError`, and the port and platform types. `createMarkdownExplorer` (`./server`) is `createExplorerServer` on
194
+ Node's runtime, which reads the settings cookie and caps no range.
195
+ - **The browser runtime (hosts).** `./server/browser` exports
196
+ `createBrowserExplorerPlatform({ principalKey, scope, window, nestingGuardWorkerUrl, pageFetch })`
197
+ (`BrowserExplorerPlatformOptions`), a platform that runs the core in the page, as a desktop webview does. It checks
198
+ its options when created and throws a `TypeError` naming the wrong one (a window without `crypto.subtle`, outside a
199
+ secure context, among them); answers the scope of its one principal key and refuses any other without naming it;
200
+ sanitizes with the page's DOMPurify behind a Web Worker that guards the nesting, the self-contained module
201
+ `./server/browser/nesting-guard-worker` (`dist/nestingGuardWorker.js`) whose URL the host passes as
202
+ `nestingGuardWorkerUrl`; measures the HTML with the window's Web Crypto, giving Node's values; and builds the
203
+ link-card handler from markdown 13.0.0's `@aiquants/markdown/link-cards` on `pageFetch` (with `null`, a
204
+ configuration that has link cards throws a `TypeError`). Its `sanitizer` limits default to one worker's, with the
205
+ parsed-node budget of a Node worker on the default heap (81,920 at the default 4 MiB, so `maxHtmlBytes` may be at
206
+ most 14,155,776, which leaves it 4,096 nodes; a `RangeError` above it), and `workers` and `workerHeapMb`, which only
207
+ Node reads, throw a `TypeError`. A job's deadline covers the guard and DOMPurify together: a result that ends after
208
+ it is dropped and the job times out. The demo's `/browser-docs` page runs the core this way.
209
+ - **The in-process fetch (hosts).** `createInProcessDataFetch(server, { dataPath, pageAddress })` returns, for the
210
+ explorer's `fetch`, a function that answers the data route inside the page: a request for `<dataPath>/<operation>`
211
+ on the page's scheme and host goes to the server's `dataLoader` (GET, HEAD) or `dataAction` (any other method), HEAD
212
+ keeping the status and headers without the body, and any other URL fails with a `TypeError`, reaching neither the
213
+ core nor the network. It compares scheme and host rather than origins, so a `wails://` page (origin `"null"`) is
214
+ answered. A request aborted before the call never reaches the core, and one aborted while the core works rejects
215
+ with its reason at once. `dataPath` follows the configuration's mount-path rule, and `pageAddress` must be an
216
+ absolute URL the data path resolves against (not relative, `about:blank`, `data:` or `mailto:`).
217
+ - **Files a host streams itself (hosts).** `MarkdownExplorerServer.planData(args)`, given the loader's arguments,
218
+ plans a data request (`ExplorerDataPlan`) for a host that streams files itself. An `asset` GET answered with bytes
219
+ (200 or 206) is a `file`: its status, all its headers, the file's bridge (`uri`, `storageVersion`), its range and
220
+ length, and `fail(error)` for a read that fails before the first byte (the error passes the host's `readFailure`,
221
+ then the route's failure mapping, log and headers), planned without reading the bytes (a plain-text view reads only
222
+ the head that names its encoding). Every other answer is a whole `response`, as `dataLoader` gives it. A file
223
+ without a bridge whose bytes would be planned is logged as a host contract violation and answered `failed` (500),
224
+ and a table preview's workbook (`as=workbook`), which the explorer reads only through its own fetch, is refused as
225
+ `invalid` (400) without a log.
226
+ - **A file's bridge (hosts).** `ExplorerAssetFile` takes an optional `bridge`, `{ uri, storageVersion, readFailure }`,
227
+ for a host that streams the bytes itself rather than through `open`: the storage URI, its version (`null` for a
228
+ storage without versions), and `readFailure`, which maps a failed read the way `open`'s failures are mapped, so a
229
+ bridged failure answers the status a failed `open` would. The explorer copies it field by field and freezes it.
230
+ `undefined` is no bridge; `null`, a value that is not an object, an empty `uri` or `storageVersion`, and a
231
+ `readFailure` that is not a function break the contract (logged, 500). The file's version is not compared with the
232
+ storage's.
233
+ - **A range answer can be capped, and the asset answers' policies are exported (hosts).** `assetMaxRangeBytes` (a
234
+ positive safe integer or `null`) caps the range answers of `asset`, stored as is or shown as plain text: a single
235
+ satisfiable range longer than it is answered with a 206 of that many bytes from its start. A request without
236
+ `Range`, a mismatching `If-Range` and a 416 are answered as before, and `null` answers the range asked, as the Node
237
+ entry does. `ASSET_CONTENT_SECURITY_POLICIES` holds the two `Content-Security-Policy` values the asset answers
238
+ carry, `sandboxed` and `mediaDocument`.
239
+ - **The app's own origins and media path (hosts).** The configuration takes `appOrigins`, the origins the app's own
240
+ pages are served from (a frozen `[]` by default), each exactly a URL's `protocol//host` (an origin whose scheme is
241
+ not special, such as `wails://localhost`, makes every URL of that scheme the app's): an empty host, an explicit
242
+ default port or a path throws a `RangeError`, a value that is not an array or an element that is not a string a
243
+ `TypeError` naming the element's index, and repeats collapse in the order written. `mediaDataPath` (`null` by
244
+ default) is the media data path: an absolute `http:` or `https:` URL, as the browser writes it, of an origin and a
245
+ mount path only (a trailing `/`, a query, a fragment, user information, an explicit default port or a `.` or `..`
246
+ segment throws). For either, `undefined` is the same as leaving it out, and `null`, `""` or a number is an error.
247
+ - **The rule of a document's language (hosts).** `.` and `./server/core` export `isExplorerDocumentLang(value)`, the
248
+ rule a Markdown or text document's `lang` is checked with (a non-empty string that `Intl.getCanonicalLocales()`
249
+ writes back unchanged), so a host refuses a wrong tag in its own settings when its server reads them, not on each
250
+ document's load.
251
+ - **Draft conversion helpers (hosts).** `.` exports `draftAnswerOf(error)` and `draftConversionOf(setup)` for a host's
252
+ browser draft converter. `draftAnswerOf` maps a conversion's failure to the explorer's draft answer: a conversion
253
+ stopped by its size limit or its deadline is a `too-large` failure document, `invalid_argument` is `invalid`,
254
+ `internal` is `failed`, and `unavailable` leaves the draft to the data route's `preview`; any other error, a value
255
+ that only looks like a converter error and a converter error with a reason it does not know are thrown again.
256
+ `draftConversionOf` builds from the deny rules and the conversion limits (`DraftConversionSetup`,
257
+ `MarkdownConversionLimits`) the deadline (`timeoutMs`) and each draft's options (`ExplorerDraftConversionOptions`: a
258
+ copy of the deny rules, the HTML limits, the source lines). The error classes are `@aiquants/markdown/converter`'s,
259
+ which markdown 13.0.0's `@aiquants/markdown/service-client` exports as well.
260
+ - **The deny table (hosts).** `./testing` exports `denyVectors()`, the explorer's deny-rule table as 207 frozen rows
261
+ of `{ pattern, path, expect }` (`DenyVector`), for a host to check its own deny implementation against. The entry
262
+ reaches no package, and no other entry reaches it.
263
+
264
+ - **The tree setting "Show folder READMEs" (readers, hosts).** A switch right after "Reveal the open document",
265
+ offered in the tree view only (`showFolderReadme`, on in `DEFAULT_TREE_SETTINGS`; `settingShowFolderReadme`: «Show
266
+ folder READMEs», 「フォルダーの README を表示」), ties the README the tree view shows to the folders' opening and
267
+ closing. Turned off, a press on a folder only opens or closes it, and a folder URL still shows the folder's README;
268
+ a host turns it off for every reader with `defaultTreeSettings: { showFolderReadme: false }`.
269
+
270
+ ### Changed
271
+
272
+ - **The viewer's style button is its display button (readers).** `viewerStyleTitle`, `viewerSelectStyle`,
273
+ `viewerPinStyle` and `viewerUnpinStyle` read «Display», «Display options», «Pin display options» and «Unpin display
274
+ options» (「表示」「表示の設定」「表示の設定をピン留め」「表示の設定のピン留めを解除」), the built-in texts of
275
+ markdown 13.0.0's display popover, whose style section `viewerStyleSectionTitle` heads.
276
+ - **A document table's tap-scroll circle is the bars' 44 px (readers).** The explorer hands a document's tables the
277
+ size of its bars' circle, 44 px, which markdown 13.0.0 draws.
278
+ - **A notice's action into the explorer moves through the router (readers).** An `ExplorerNotice`'s `action` whose
279
+ `href` is a page of the explorer, a path-only address under `basePath` outside the data route, moves through the
280
+ router; any other stays a plain link.
281
+ - **The history dialog retries a version's text alone (readers).** A version whose text failed to load is retried by
282
+ reading that text again.
283
+ - **The bundles carry the notices of the third-party code they inline (hosts).** A legal comment at the head of each
284
+ chunk that keeps such code names the package, its version and licence, and the copy of its licence file in
285
+ `dist/licenses/<name>/`: `parse5` (MIT) and `entities` (BSD-2-Clause) in the nesting-guard worker, and
286
+ `@heroicons/react` (MIT), which the library build bundles.
287
+
288
+ - **Closing the shown folder moves the tree view up (readers).** With "Show folder READMEs" on, a press (a click,
289
+ Enter or Space) on the shown folder while it is open moves the view up once the folder closes — at the end of the
290
+ delay that tells a single press from a double click, or at the end of a double click —: to the folder above the
291
+ pressed row (its README, or the line saying it has none), or for a top-level folder to the source's README as a
292
+ document, or to the empty pane when the source has none, so repeated presses walk up one level at a time. The move
293
+ replaces the URL's document and leaves an explorer sheet open, since it picks no destination; a document the reader
294
+ shows before the folder closes stays. A double click that leaves the folder open keeps its README, a press on an
295
+ open folder that is not shown now only closes it (it showed the folder and kept it open), and the arrow keys and
296
+ Collapse all never change what the view shows. Under "Always expanded" a press on a folder whose contents are known
297
+ shows it, or on the shown folder moves up at once, and no longer flips the folder's hidden expansion.
298
+ - **The explorer's navigations carry their kind as router state (hosts).** Every navigation the explorer starts
299
+ carries `{ aqmxNavigation }` (`browse`, `close-folder`, `switch-source`, `switch-view` or `follow-link`) as its
300
+ `location.state` (it was `null`), so what watches the location reads why it changed from the navigation itself.
301
+
302
+ ### Fixed
303
+
304
+ - **Every type a public entry's declarations show is exported (hosts).** `.` exports the seven types its declarations
305
+ showed but no entry exported: `ExplorerEntryType`, `ExplorerNoticeTone`, `ExplorerTextDocument` and its
306
+ `ExplorerFileText`, `MarkdownExplorerSpreadsheetLabels`, `ExplorerHrefWriter` and `TreeReadmePlacement`. `./server`
307
+ exports `ExplorerAssetDisplay`, which its declarations showed and no entry exported either, and, as types, the new
308
+ `ExplorerDataPlan`, `SanitizerLimitsInput` and `ExplorerServerSharedConfig` its declarations show. The build checks
309
+ every public entry for such types.
310
+ - **Under `lockDocumentScroll`, the placement check follows the explorer's current root (hosts).** A host frame that
311
+ differs per view and recreates the root stays watched: the check runs once per root element, a recreated root is
312
+ checked afresh, and the removed one is no longer watched.
313
+ - **Messages name values through one describer (hosts).** A value an error, violation or warning message names (a
314
+ rejected or out-of-range value, a quoted name or candidate) is written one way: a string quoted and cut after 80
315
+ code points, ending in `…`, never inside a surrogate pair; a number, a boolean, a symbol, `null` and `undefined` as
316
+ they are (`-0` included); a bigint with its `n`; an object by its kind, never by its content or its own `toString`.
317
+ The counts, limits, lengths and positions the package itself asks for stay plain numbers. A rejected value no longer
318
+ looks valid (the string `"5"` is not written `5`, nor `null` as `object`), a bigint no longer throws a `TypeError`
319
+ that hides the package's own error, and a document of an unknown kind no longer puts its content into the message. A
320
+ message about `scopeSecret` names the value's type alone; `iframeHosts` names an element out of place with its index
321
+ (as `appOrigins` does), overlapping view sections are named by value, a source id given twice to
322
+ `withExplorerSources` is named with its indices (as the server's `sources` are), and a malformed mount path's
323
+ message says that `.` and `..` segments are refused.
324
+ - **A URL whose scheme has a digit is judged by its scheme (readers).** The sanitizer's URL check counts digits among
325
+ a scheme's characters, so a URL such as `h323:…` is no longer taken for a relative one.
326
+ - **A document invalidated during a background re-read is no longer taken as checked (readers).** When the explorer
327
+ invalidates a document no pane holds, it also forgets the background re-read already running, whose answer, the
328
+ document from before the change, counted as checking it again.
329
+
330
+ - **A tree press navigates with the URL's current overrides (readers).** After the URL's overrides changed while the
331
+ same document or folder stayed shown (an override dropped, another style chosen), a press on the tree's Tab stop —
332
+ the row that last took the tree's focus, or else the shown row — navigated with the overrides of that row's last
333
+ render (Enter, Space, or a click, also one that brings the focus back into the tree), so a dropped override came
334
+ back: the tree's rows keep the press handler they last rendered with, and only a press that moves the Tab stop
335
+ renders the pressed row again. The tree's press handler now keeps its identity and reads the pane's current
336
+ handlers.
337
+
338
+ ### Tests
339
+
340
+ - `vitest.config.ts`: the runtime-independent server suites run in four projects, `server` (Node), `server-plan`
341
+ (Node, the data route's GET and HEAD planned by `planData` and answered from the file's bridge, as a host that
342
+ streams files itself), and `server-browser-chromium` and `server-browser-webkit` (Vitest's browser mode, headless
343
+ through Playwright), while the suites that test Node's runtime itself run in `server` alone
344
+ (`tests/server/README.md` says which run where and how to write one that runs anywhere); `tests/browser/**` runs in
345
+ the two browser projects, which pre-bundle every dependency their suites load. `test` and `test:coverage` run the
346
+ `browser`, `wiring`, `server`, `server-plan` and `server-browser-chromium` projects (V8 coverage is measured in
347
+ Chromium only), `test:browser:webkit` runs WebKit, and `test:run` and `test:watch` every project. `@vitest/browser`
348
+ and `@vitest/browser-playwright` are 4.1.10 exactly, and `playwright` is the catalog's.
349
+ - `tests/server/runtimes/` (`node.ts`, `browser.ts`, chosen per project through `projectRuntime`) and
350
+ `tests/server/fixtures/memorySource.ts` (an in-memory storage with the asset port, a default bridge and reads
351
+ through it): the suites build the core on either runtime. A browser runtime answers the page's one principal, so a
352
+ test of a second one runs on Node; cookies travel in headers every runtime keeps (`SESSION_COOKIE_HEADER`,
353
+ `SETTINGS_COOKIE_HEADER`), the assertions that need a forbidden header run only where it reaches the core, and
354
+ `testRequest` refuses a header the runtime dropped.
355
+ - `tests/server/explorerCore.test.ts`, `tests/server/nodePlatform.test.ts`, `tests/server/serverCoreTypes.test.ts`:
356
+ where and how often the core calls its platform, the order of its errors, the scope contract, the settings reader
357
+ and the range cap (stored as is, plain text, `null`); Node's runtime checks nothing when created, checks the secret
358
+ when the scope is prepared and derives the scope by HMAC; the two configurations share their fields, each keeps its
359
+ own, and the core's `sanitizer` takes Node's setting as it is. `tests/server/planData.test.ts`: a table of plans (a
360
+ capped range, 416, HEAD, 304, an empty file, a file of unknown length, `as=text`, a redirect, `not-found`, no cap,
361
+ `fail`, a file without a bridge), `fail`'s four answers through the host's mapping, `as=workbook`, other operations
362
+ and methods, `.data` and an unexpected error, and a `file` plan streamed from the bridge answering what `dataLoader`
363
+ answers.
364
+ - `tests/server/inProcessFetch.test.ts`: the in-process fetch answers the data route and never calls the global fetch.
365
+ `tests/server/sanitizerOptions.test.ts`, `tests/server/sanitizer.test.ts`: the browser's and Node's resolvers accept
366
+ only a plain object and refuse with the same first error. `tests/server/sanitizeJob.test.ts`: the sanitizing step
367
+ after the nesting guard, which every runtime shares. `tests/server/documentLang.test.ts`: the `lang` rule, the
368
+ contract and the host document's copy, answering alike in Node, Chromium and WebKit. `tests/server/ownUrls.test.ts`:
369
+ the table `tests/server/fixtures/own-urls.json` (80 rows over a web, a desktop and a desktop-media configuration)
370
+ and its shape, in Node, Chromium and WebKit. `tests/server/linkCardOperation.test.ts`: without
371
+ `MARKDOWN_SOCKET_PATH` the handler's own 500 reaches GET and HEAD with its status, headers and body, while the
372
+ explorer logs nothing and fetches no local page.
373
+ - `tests/unit/denyVectors.test.ts`: the deny rules answer the 207 rows of `tests/fixtures/deny-vectors.json`, the
374
+ table `./testing` exports. `tests/server/htmlNestingParity.test.ts` (Node), with
375
+ `tests/fixtures/nesting-parity.json` and `tests/fixtures/over-limit-nesting.html`: the 23 rows within the limit
376
+ agree between the guard, jsdom's parse and the table and sanitize idempotently, while the 12 over it and the
377
+ over-limit document are refused. `tests/server/fixtures/digest-vectors.json`: Node's measure and the browser's run
378
+ the same table.
379
+ - `tests/browser/` (Chromium and WebKit, real Web Workers): `nestingGuardWorker.test.ts` (the worker and the guard in
380
+ the page answer as the nesting table, and the three rows at the limit, a `div`, a `ul`/`li` and a `table`, keep
381
+ depth 256 in a document, a fragment and a document embedded 64 levels deep), `domSanitizerPool.test.ts` (the pool's
382
+ output matches the Node step's and is idempotent, rows over the limit are `too-large`, and its failures, deadline,
383
+ yield and admission, the guard's refusals and errors coming from stand-in workers, `guardWorkers.ts`),
384
+ `browserPlatform.test.ts` (the options' checks, the scope, the limits, the budget sent to the guard, real
385
+ sanitizing, the measure, and the link cards on a stand-in port) and `fullscreenBlock.test.ts`.
386
+ - `tests/browser/fragmentLinks.test.tsx`: under a browser router and a memory router, a fragment-only link pressed by
387
+ a pointer click or by Enter (a footnote's reference and back link in remark-gfm's and goldmark's markups, a heading
388
+ the URL does not hold yet, the top, and the fragment the URL already holds) scrolls the pane once, leaves the focus
389
+ where it went and keeps the document. `tests/browser/treeLinePalettes.test.tsx`: five palettes bound as a host binds
390
+ its own and named by a new `paletteKey` are read back from the tree canvas's pixels, and one bound without a new
391
+ name stays undrawn until the name changes. `tests/browser/fullscreenAnnouncements.test.tsx`: through the real
392
+ explorer and table block, announcements wait while the block is full screen and, once it leaves by its control or by
393
+ Escape, are spoken in order with a repeat dropped. `tests/browser/unversionedSaveConfirm.test.tsx`: Mod-S right
394
+ after typing writes the pending keystrokes and asks; Enter or Escape stays and hands the focus back to the editor,
395
+ and saving sends the text over its base version.
396
+ - `tests/unit/hostContract.test.ts`, `tests/unit/hostChanges.test.ts`, `tests/components/explorerHost.test.tsx`,
397
+ `tests/components/explorerDrafts.test.tsx`: the host's options and the handle's arguments are checked; a change
398
+ reloads or notifies by the policy and skips an edited, unshown or unloaded document; the paths `onDraftChange` folds
399
+ match `flushUnsaved()` after each write (the first render, typing, back to the original text, saving, discarding, a
400
+ restored draft), with a later listener, a replaced function, `confirmDiscard` and malformed arguments; under the
401
+ lock, a frame that recreates the root moves the watch to the current root, which reports a collapse once.
402
+ `tests/unit/stores.test.ts`: `noteChanged`, `reloadSource` and `invalidate`.
403
+ `tests/components/markdownExplorer.test.tsx`: the context's defaults and relays.
404
+ - `tests/components/documentNotices.test.tsx`, `tests/components/explorerNotices.test.tsx`,
405
+ `tests/components/historyConfirm.test.tsx`, `tests/components/historyDialog.test.tsx`,
406
+ `tests/components/liveRegion.test.tsx`, `tests/components/unsavedChangesGuard.test.tsx`,
407
+ `tests/unit/documentChanges.test.ts`, `tests/unit/mediaFailure.test.ts`: the screens' side of the host contract (the
408
+ notices above the document and their Reload, a notice's link into the explorer, the history dialog's retry, the
409
+ announcements held while a block is full screen, the unload and unversioned-save checks, and the order of media
410
+ reports and events). `tests/components/singleView.test.tsx`, `tests/components/treeLayout.test.tsx`: the notices'
411
+ container between the refresh bar and the document region.
412
+ - `tests/components/modalDialog.test.tsx`, `tests/components/documentEdit.test.tsx`: closing a modal dialog hands the
413
+ focus back to the control that opened it, under the stand-in dialog of `tests/support/dialogStandIn.ts`, which,
414
+ unlike a browser closing a modal dialog, hands none back itself; each press first moves the focus as a real press
415
+ does.
416
+ - `tests/unit/labels.test.ts`: both catalogs carry the 13 viewer keys of markdown 13.0.0 (82 viewer keys in all), the
417
+ 14 keys of the host contract's screens (their texts word for word, a host's override that names a service, a wrong
418
+ type, a blank text, and the spaces around alphanumerics in Japanese) and the split placeholder's four (the English
419
+ resize-panels' defaults word for word, the Japanese spaced, the placeholders per key); a brace outside a placeholder
420
+ is refused at its position, and neither catalog's templates has one. `tests/components/panelGroupLabels.test.tsx`,
421
+ `tests/components/explorerSplit.test.tsx`, `tests/components/editSplit.test.tsx`: the split takes both catalogs and
422
+ the overrides the resolution lets through, refuses the same templates at the same position, and names its
423
+ placeholder by the UI language's summary without a `lang`, with the same labels on every render.
424
+ - `tests/components/document.test.tsx`, `tests/wiring/editTables.test.tsx`: the elements the viewer's labels name
425
+ carry the UI language's `lang` themselves, inside content of the other language and outside it, while the explorer's
426
+ own controls carry none. `tests/components/documentLinks.test.tsx`: an inert link's reason reads in the UI language
427
+ while its text keeps the document's language, or its own `lang="ar"` and `dir="rtl"`, and outside the content it
428
+ names no language; fragment-only links scroll once under a browser and a memory router.
429
+ - `tests/unit/settings.test.ts`: `measure` and `documentColors` are written in the fixed order and read back, a value
430
+ outside the viewer's lists and a key under another name are dropped, a cookie without them is unchanged, and every
431
+ value of the lists round-trips; the reshaped messages. `tests/unit/describeValue.test.ts`: the describer (the cut,
432
+ numbers, bigint, kinds, no call of an object's own `toString`), and each layer's entry cutting a long rejected
433
+ string and refusing a bigint with its own error.
434
+ - `tests/unit/draftAnswer.test.ts`: the six answers, the service client's classes being the same classes, five errors
435
+ thrown again, and the options. `tests/wiring/documentTableCircle.test.tsx`: the circle's diameter reaching a
436
+ document table's grid. `tests/components/explorerPane.test.tsx`: the tree's line colours are the computed colours
437
+ the probe resolves. `tests/components/lockDocumentScroll.test.tsx`: the watch is one function while the flag holds
438
+ and watches nothing unlocked.
439
+ - `scripts/verify-dist.mjs`, `tests/unit/entryPurity.test.ts`, `tests/server/configuration.test.ts`: `./server/core`,
440
+ `./server/browser` and the nesting-guard worker reach no Node built-in, `@aiquants/markdown/server`, `undici` or
441
+ `jsdom`; `./server/core` loads in both formats; the worker is one module that imports nothing, and its notice names
442
+ `entities` and `parse5`; every chunk's notice has its licence file; no public entry's declarations show a type that
443
+ no public entry exports; `./testing` reaches no package and no other entry reaches it; the root entry and
444
+ `./server/core` export `isExplorerDocumentLang`; the server side may import
445
+ `@aiquants/markdown/link-cards`; the built server keeps a document's `lang`; and the link-card handler answers its
446
+ own 500 without the markdown service, its dependencies read from the installed `@aiquants/markdown/server` entry.
447
+ - `tests/support/`: `dialogStandIn.ts`, `documents.ts`, `routerProbes.tsx`, `viewsFromUrl.tsx`, `linkPresses.ts`,
448
+ `linkPages.tsx`, `frames.ts`, `explorerRoot.tsx`, `thrown.ts` and `panelGroupLabels.ts` replace the copies the
449
+ component tests each carried, or support the new ones.
450
+ - `playwright.config.ts`: two projects, `chromium` (every spec) and `webkit` (Desktop Safari, `browser-core.spec.ts`
451
+ only), and the servers it starts get an empty `MARKDOWN_SOCKET_PATH`. `tests/e2e/browser-core.spec.ts` (four tests
452
+ in both engines), on the demo's `/browser-docs` page, where the core runs on the browser runtime over three bundled
453
+ Markdown files: it renders with its tree, follows a document link and starts the nesting-guard worker, reveals a
454
+ document in its folder, round-trips the display settings and keeps the scope without a cookie, and goes from the
455
+ base path to the canonical tree URL, with no request to the data route or another origin and no exception.
456
+ - `tests/e2e/link-cards.spec.ts`: the demo's data route answers with the handler's own 500 and sets no cookie.
457
+ `tests/e2e/document-viewer.spec.ts`, `tests/e2e/embeds.spec.ts`: the elements with names carry the UI language's
458
+ `lang` themselves, a diagram's controls sit inside content of the guide source's language, and an embed frame's
459
+ title comes from the UI language's catalog. `tests/e2e/spreadsheets.spec.ts`: a document table's tap-scroll circle
460
+ is `TAP_SCROLL_CIRCLE_SIZE`. `tests/e2e/single-view.spec.ts`: the style control opens the width and colours
461
+ sections, which `?showStyle=false` hides with it. `tests/e2e/focus-handoff.spec.ts`: each page view's fragment test
462
+ runs with Enter and with a pointer click. `tests/e2e/multi-view.spec.ts`: the display popover's test titles.
463
+
464
+ - `tests/components/folderReadme.test.tsx`: closing the shown folder moves up to the pressed row's parent, to the
465
+ source's README (which the reveal does not move to another source), or to the empty pane at the root, with a
466
+ `close-folder` navigation; double clicks in both modes, the arrow keys (on a row and outside the rows), Collapse
467
+ all, a document shown before the folder closes, "Always expanded" (its hidden expansion kept, a lazy folder opened
468
+ in the reader's expansion), "Show folder READMEs" off, a folder listed in two places, and, after the overrides
469
+ changed, a press on the focused row and a pointer press from outside the tree on the shown folder.
470
+ `tests/components/explorerEntries.test.tsx`: `closeTargetOf` (the folder of the row above, told apart by identity;
471
+ the source's README; nothing; a row not drawn). `tests/components/explorerSheet.test.tsx`: the sheet stays open on a
472
+ move up and closes on a press that opens a folder and on going back to the move's entry.
473
+ `tests/components/navigation.test.tsx`: each kind's router state and `explorerNavigationOf`.
474
+ `tests/components/treeLayout.test.tsx`: after the URL's overrides changed, Enter and a click on the focused row, and
475
+ a pointer press from outside the tree on the Tab stop (the shown row, and the row focused last).
476
+ `tests/components/explorerPane.test.tsx` and `tests/unit/settings.test.ts`: the new switch's row, ring, storage and
477
+ host default, and the settings the multi view hides. `tests/support/routerProbes.tsx`: `LocationProbe` shows the
478
+ router state (`data-router-state`).
479
+
480
+ ### Documentation
481
+
482
+ - README: the package's entries, with a link to the new hosting page; `appOrigins` and `mediaDataPath` in the
483
+ configuration; `planData` and an asset file's `bridge`; the host contract's props and a section on the handle (its
484
+ methods, `ExplorerUnsavedDraft` and the checks of what a host gives); the shared halves of a browser draft converter
485
+ (`draftConversionOf`, `draftAnswerOf`); the split's labels, a template's braces and the language of the viewer's
486
+ labels; the demo's `/browser-docs` page and the two E2E projects; Link cards (the handler opens pages only through
487
+ the markdown service, and without it answers its own `500`, `no-store`), `documentStyles` in the style section of
488
+ the viewer's display popover, the documents' `lang` (with `isExplorerDocumentLang` for a host's own settings) and
489
+ `createFileSystemSource`'s `lang`, the 256-level nesting limit and the deny rules' three decoding levels,
490
+ `lockDocumentScroll`'s check per root element, `./storage` importing no package, the peers' floors with what the
491
+ explorer takes from markdown 13.0.0 and resize-panels 2.3.0, and a document table's circle one control wide.
492
+ - `docs/behavior/hosting.md` (new): what each entry holds and never loads; the steps for running the server half
493
+ inside the page (the core's configuration, the browser runtime's options, the in-process fetch and the route), with
494
+ what a page host must know; the browser runtime's sanitizer; the app's own URLs (`appOrigins`, `mediaDataPath`); and
495
+ streaming files from a bridge with `planData`.
496
+ - `docs/behavior/security.md`: the sanitizing on each runtime, with the browser runtime's guard worker, its refused
497
+ worker fields, node budget, `maxHtmlBytes` cap, admission defaults, deadline across both steps and guard failures;
498
+ the app's own URLs, the presentation attributes and `preload`; the scope on each runtime; the host's duties on each,
499
+ with the `media-src`, `frame-src` and `worker-src` directives; a file of no known kind as a `file` document offered
500
+ for download (it read `unsupported`); the link cards through the markdown service, the `text` operation's answer
501
+ without `lang`, the 256-level depth limit, and the denial of a segment still encoded after three decodes, with
502
+ `deny: []` denying nothing. `docs/behavior/layout.md`: the tree's type icons reach 3:1 against `--aqmx-surface` and
503
+ each tint in both schemes, the display popover and the alignment menu among the parts that stop a held Enter,
504
+ `lockDocumentScroll` per root element, and a document table's circle one control wide.
505
+ `docs/behavior/localization.md`: the viewer's labels of the display popover,
506
+ its width and colours sections and a diagram's notices; the notices above a document, the sign-in texts of an
507
+ `unauthorized` failure, the unversioned save's confirmation and the split placeholder's texts and templates; a brace
508
+ outside a placeholder; and the viewer's labels in the UI language (`labelsLang`). `docs/behavior/dom-hooks.md`: the
509
+ notices' container and each notice with its `data-aqmx-notice`. `docs/behavior/url-contract.md`: `measure` and
510
+ `documentColors` in the display settings.
511
+ - Docstrings: `ExplorerAssetFile.open` (the plain-text view opens the file's head on a HEAD to name its encoding, and
512
+ before the range of a range request), `ExplorerTextDocument` (its text is read by the reading order, the byte-order
513
+ mark, UTF-8 and the legacy encodings, rather than always as UTF-8), and the document table's circle (44 px).
514
+ - README: "Folders and their READMEs" (opening a folder, closing the shown one, double clicks, "Always expanded", the
515
+ keys and Collapse all, and "Show folder READMEs"), `showFolderReadme` among `defaultTreeSettings`, and the tree
516
+ settings the multi view does not offer. `docs/behavior/localization.md`: `settingShowFolderReadme`.
517
+
518
+ ## 0.34.0 (2026-11-06) — The explorer closes to a rail, the tree view's document maximizes over the page, and a touch screen gives the content its whole width
519
+
520
+ ### Breaking
521
+
522
+ - **The peers `@aiquants/virtualscroll`, `@aiquants/directory-tree`, `@aiquants/drag-drop-panels`,
523
+ `@aiquants/spreadsheet` and `@aiquants/markdown` are `^3.24.0`, `^6.1.1`, `^0.14.0`, `^0.20.0` and `^12.3.0`
524
+ (hosts).** The explorer shows a touch screen's tap-scroll circles only while the reader scrolls and draws no arrows
525
+ on its bars there (virtualscroll 3.24.0's `tapScrollCircleOptions.visibility` and `showArrowButtons`), the tables'
526
+ bars included (spreadsheet 0.20.0's `scrollBarControls`, which markdown 12.3.0 passes on as
527
+ `spreadsheetScrollBarControls` and its table block as `scrollBarControls`), starts a tree it rebuilds at the row it showed first
528
+ (directory-tree 6.1.1 applies the expansion from the first render of a mount, so a remembered row inside an open
529
+ folder is in the list the tree starts from), restores the tree view's maximized document by the rule a maximized
530
+ panel follows (drag-drop-panels 0.14.0's `isMaximizeEscape`), and hands the viewer its circle's gutter and its bar's
531
+ slot width as CSS lengths that a media query sets (markdown 12.3.0's `scrollBarGutter` and `scrollBarInlineSize`, and
532
+ `HostedScrollArea`'s `barInlineSize`), the viewer reserving the band its toolbar covers before it measures the
533
+ toolbar where the explorer opts in (`--aqmd-toolbar-reserve-before-measure`). markdown 12.3.0 also moves a code
534
+ block's Copy button into a header row above the code, renders no front matter, keeps a server-highlighted code
535
+ block's lines and height through hydration (the explorer's split changed a context right after hydration, which
536
+ turned every such block into its loading line), and leaves a formula's DOM alone while the document re-renders (the
537
+ editing preview rewrote every formula on each keystroke). Through virtualscroll 3.24.0 the bars also take 3.23.0's
538
+ colours, written with `light-dark()` only, so a browser before Chrome and Edge 123, Firefox 120 and Safari 17.5 draws
539
+ their tracks, arrows and thumbs transparent (the README's browser note says so beside the tree's icons). A host
540
+ updates the six packages together.
541
+ - **The maximize insets are the explorer's own `--aqmx-maximize-*` (hosts).** A maximized multi-view panel covers the
542
+ viewport inside `--aqmx-maximize-top`, `--aqmx-maximize-right`, `--aqmx-maximize-bottom` and `--aqmx-maximize-left`
543
+ (`0px` by default), which the stage hands to drag-drop-panels' `--aqdd-maximize-*` on its own element, and the tree
544
+ view's maximized document covers the page inside the same insets, so one binding serves both views. The stage's
545
+ declaration wins over an `--aqdd-maximize-*` a host sets on an ancestor: a host that bound those binds the `--aqmx-`
546
+ names instead.
547
+ - **`ExplorerLocation`'s tree view carries `maximized: boolean` (hosts).** `resolveExplorerLocation` reads
548
+ `maximized=true` and ignores any other value, as well as the flag on a tree location with neither a document nor a
549
+ folder; a host that builds a tree location itself adds the property. A tree `ExplorerHrefTarget` takes an optional
550
+ `maximized`, for which `explorerHref` writes `maximized=true` after `style` and `align` and before `markup`, and
551
+ throws a `RangeError` for a tree target with neither a document nor a folder.
552
+ - **The explorer takes its inline size from its container (hosts).** The split's frame is an inline-size container
553
+ (`container: aqmx-split-frame / inline-size`), so the stylesheet lays the first paint out from the frame's own width;
554
+ the containment also keeps the explorer from taking its width from its content. A container that shrinks to fit (an
555
+ absolutely positioned or fixed box without a width, `width: fit-content` or `max-content`, a float, an `auto` grid
556
+ track with `justify-content: start`) now sizes the explorer to 0 px instead of its content's width: give such a
557
+ container a width (README, Sizing). Block containers and stretched flex and grid items are unaffected.
558
+
559
+ ### Added
560
+
561
+ - **Closing the explorer (readers).** In the tree and multi-panel views a close button at the end of the explorer's
562
+ first line (`markdown-explorer-split-close`, named by `hideExplorer`, 44 px under every pointer, where the sheet has
563
+ its own), the handle dragged to the split's edge and released there, and the arrow keys pressed past the minimum close
564
+ the explorer. A rail 55 px wide (`markdown-explorer-rail`: a 44 px toggle between 5 px of padding, and a 1 px border)
565
+ then holds its side, and its toggle (`markdown-explorer-rail-toggle`, named by `showExplorer`, with
566
+ `aria-expanded="false"`) opens the explorer again at the width the reader last chose. Focus on the explorer's side
567
+ moves between the close button and the rail's toggle, and between the rail's and the sheet's toggles when the frame
568
+ crosses the sheet threshold; after a view switch from the header's link into a view whose explorer is closed it
569
+ lands on the rail's toggle. The frame's `data-aqmx-explorer-mode` is `rail` while the explorer is closed.
570
+ The tree that opens again starts at the row it showed first, at the same height, as a tree does when the frame
571
+ moves between the split and the sheet: the split keeps that row per source while its tree is away.
572
+ - **The choice is remembered per view (hosts).** `ExplorerViewSettings` has `treeExplorerHidden` and
573
+ `multiExplorerHidden`, written to the display-settings cookie only as `true` and read as `=== true` (a cookie without
574
+ them reads as an open explorer), so the server renders the rail on the first paint. The sheet starts closed whatever
575
+ the choice says.
576
+ - **The tree view's maximized document (readers).** The document's bar ends with Maximize
577
+ (`markdown-explorer-document-maximize`, icon-only, named and titled by `documentMaximize`, and by `documentRestore`
578
+ while the document is maximized, with no pressed state, the same element in every state). A press replaces the URL
579
+ with the same location maximized or restored, keeping the scroll and leaving the fragment behind, reads nothing again,
580
+ and is announced (`documentMaximized(name)`, `documentRestored(name)`). Maximized, the document's column
581
+ (`data-aqmx-maximized="true"`) covers the page, the split's frame carries `data-aqmx-content-covers-page="true"` (as
582
+ it does while a panel is maximized) and the explorer's side underneath is inert. Escape restores the document by the
583
+ rule a maximized panel's Escape follows. A maximized folder covers the page while it looks for its README; a folder
584
+ without one and the empty state cover nothing. The maximize stays through a source switch, the reveal's move of the
585
+ tree, and the document links and table-of-contents entries it follows, which read it at the moment of the click (their
586
+ hrefs never carry it); a pick in the tree and the switches between the views drop it.
587
+ - **One bar on a phone (readers).** Below the sheet threshold, while the tree view shows a document, the sheet's bar
588
+ (`markdown-explorer-sheet-bar`, `data-aqmx-sheet-bar-merged="true"`) lies over the start of the document's bar, which
589
+ takes the sheet's look (`data-aqmx-sheet-bar="merged"`): one 55 px bar instead of two, its labelled buttons showing
590
+ their icons only, their labels kept as their accessible names. Both bars keep their places in the DOM, so the toggle
591
+ stays the same element, first in the Tab order. While the document is maximized the document's bar keeps the look
592
+ without the toggle's lane (`data-aqmx-sheet-bar="covering"`), so nothing below it moves.
593
+ - **Labels for the copy buttons of the code blocks and the display formulas (hosts, readers).** `viewerCodeBlockCopy`
594
+ («Copy the code» / 「コードをコピー」), `viewerCodeBlockCopied` («Copied the code.» / 「コードをコピーしました。」) and
595
+ `viewerCodeBlockCopyFailed` («Could not copy the code.» / 「コードをコピーできませんでした。」) name a code block's
596
+ copy button and announce its outcomes; `viewerDisplayMathCopy` («Copy the formula» / 「数式をコピー」),
597
+ `viewerDisplayMathCopied` («Copied the formula.» / 「数式をコピーしました。」) and `viewerDisplayMathCopyFailed`
598
+ («Could not copy the formula.» / 「数式をコピーできませんでした。」) do so for a display formula's. The viewer receives
599
+ them as its `codeBlock*` and `displayMath*` labels, so the buttons follow the UI language.
600
+
601
+ ### Changed
602
+
603
+ - **A touch screen gives the content its whole width (readers).** Under `(pointer: coarse)` a content scroller's bar
604
+ lies over the scroller's inline end and lets every press but its circle's through to the content, and the scrollers
605
+ keep no gutter for the circle (`--aqmx-tap-circle-gutter-size` on the root, `54px`, and `0px` under a coarse pointer,
606
+ set by a media query, so the server's markup is the same on every device). Every bar, the tree's, the stage's and
607
+ the tables' grids' (a document's tables and a table file's grid) included, leaves out its thumb drag and track click
608
+ there and draws no arrows (virtualscroll 3.24.0's `showArrowButtons`, the track then running the bar's whole length;
609
+ for the tables spreadsheet 0.20.0's `scrollBarControls`), none of them a target for a finger, and every
610
+ tap-scroll circle, the tables' included, shows only while the reader scrolls: from a scroll within 2 s of the reader's
611
+ own press, touch, wheel turn or key, until 2 s after the scroll's last change. The multi-panel view's stage bar lets
612
+ every press through to the stage, so a finger's pan that starts on its strip scrolls the stage; the tree's bar and
613
+ the tables' vertical bars let them through to the box of their scroll pane, which takes them as presses on its rows
614
+ (virtualscroll 3.24.0), so a pan that starts on their strip scrolls the tree or the table's rows, and a table's
615
+ horizontal bar, below its rows, passes them to the browser. The tree's bar keeps its Top and Bottom buttons, and the server's fine-pointer tree bar, whose arrows hydration removes, stays hidden in
616
+ its place until then, so no arrow or circle appears and vanishes. The viewer's toolbar keeps clear of the overlaid
617
+ bar.
618
+ - **Every bar of the explorer is 55 px (readers).** The sheet's bar is one control inset by 5 px on each side with a
619
+ 1 px border, 55 px high (`--aqmx-space-9`; it was 51 px), the rail is as wide, and the document's bar places its
620
+ buttons 5 px from its edges (it was 4 px), where the explorer's first line and its close button sit.
621
+ - **The first paint has the layout the measure settles on (readers, hosts).** The server knows neither the frame's
622
+ width nor the pointer, and the split measures its frame only after the page hydrates; the frame now carries
623
+ `data-aqmx-measured` (`false` until that measure), and meanwhile the stylesheet lays it out from its own width (a
624
+ container query in rem): narrower than 13rem × φ², no explorer, handle or rail, the content the whole width, the tree
625
+ view's document bar in the sheet bar's look with the toggle's lane, and one bar's room above the other frames; wider,
626
+ the explorer at its 13rem floor at least. The handle's band is the stylesheet's (`--aqmx-split-handle-size`: 24 px,
627
+ 44 px under `(pointer: coarse)`), so the sides keep its halves clear from the first paint. Before, a phone showed the
628
+ explorer beside the content until the page hydrated (22 frames, from 115 ms to 716 ms, on a CPU slowed 4×), a tablet
629
+ drew the explorer narrower than its floor, and both moved the content when they hydrated; now the explorer, the rail,
630
+ the content's panel and the document bar keep their places.
631
+ - **The document's text keeps its place when the page hydrates (readers).** The viewer's bar slot is as wide as its bar
632
+ from the server's render on (`--aqmx-scroll-bar-slot-size` on the root: `8px`, and `0px` under a coarse pointer,
633
+ where the bar lies over the text's end; the explorer's own scrollers and the multi-view panels' areas take the same
634
+ slot), and a viewer that is its region's first child opts in to the band its toolbar covers before the toolbar is
635
+ measured (`--aqmd-toolbar-reserve-before-measure: 1` on the viewer's frame), which markdown 12.3.0 reserves where the
636
+ content spans the column. Before, the text moved 50 px down once the toolbar was measured and, under a fine pointer,
637
+ its column narrowed by 8 px when the bars' module arrived. A viewer under a file header (a text file's) or given a
638
+ `width` or `maxWidth` (a single-view embed) reserves nothing before the measure.
639
+ - **Class names (styling only).** `aqmx-sheet-toggle` is `aqmx-explorer-toggle`, `aqmx-sheet-close` is
640
+ `aqmx-explorer-close` and `aqmx-sheet-header` is `aqmx-explorer-chrome`; class names stay internal (see
641
+ [DOM hooks](docs/behavior/dom-hooks.md)).
642
+
643
+ ### Fixed
644
+
645
+ - **Copy the text reports a failed write to the developer, and only its latest press decides the outcome (readers,
646
+ hosts).** The text viewer's copy button dropped the reason a browser gave for refusing the write, and a clipboard
647
+ that throws before it returns its promise threw out of the press, leaving the button and the live region silent; a
648
+ late answer to an earlier press could also replace the outcome of the press after it. A refused or thrown write is
649
+ now a failure, announced and shown as before and logged to the console with its reason (a browser without the
650
+ asynchronous clipboard is a condition of an insecure origin, not an error, and is not logged), and an answer to a
651
+ press a later press replaced shows and announces nothing.
652
+
653
+ ### Tests
654
+
655
+ - `tests/components/explorerSplit.test.tsx`: a drag that holds the explorer panel collapsed keeps it mounted but not
656
+ displayed, and one dragged back before the release does not close it; a drag released at the edge closes the
657
+ explorer to the rail, remembers the choice per view and not the collapsed width; a drag that widens the explorer and
658
+ then closes it through the minimum reopens at the widened width; Shift+ArrowLeft stops at the minimum and keeps the
659
+ explorer open, the next press closes it, and the toggle reopens at the width remembered before; the arrow keys close
660
+ it, and the focus moves between the handle, the rail's toggle and the close button; the first paint follows the
661
+ cookie, per view,
662
+ and the rail is inert while the content covers the page; the sheet ignores the choice, and the focus crosses the
663
+ threshold between the rail's and the sheet's toggles; the frame is `data-aqmx-measured="false"` until its first
664
+ measure, and the split sets no band of its own under either pointer.
665
+ - `tests/components/treeLayout.test.tsx`, `tests/components/folderReadme.test.tsx`: Maximize replaces the URL, covers
666
+ the page, makes the explorer inert, keeps the button and its focus, renames it, announces each press and renders
667
+ nothing anew; a press at an address with a fragment, maximizing or restoring, replaces the URL without it; a
668
+ maximized address covers from the first paint and Escape restores it once, while a handled Escape does not and one
669
+ inside a block's non-modal dialog (an open `dialog`) does; the reveal keeps the maximize and the fragment; a
670
+ maximized lazy folder covers while it loads and an empty one covers nothing.
671
+ - `tests/components/documentLinks.test.tsx`: a maximized tree view's document link and table-of-contents entry carry
672
+ the maximize when followed, and their hrefs do not.
673
+ - `tests/components/explorerSheet.test.tsx`: the sheet's bar and the document's bar are one while a document shows
674
+ (the toggle the same element, its title only while merged), `covering` while the document is maximized with the
675
+ sheet's bar inert, and never on a multi-view panel's bar. `tests/components/singleView.test.tsx`,
676
+ `tests/components/multiLayout.test.tsx`: no Maximize and no sheet look there.
677
+ - `tests/components/viewSwitchFocus.test.tsx`: a view switch into a closed explorer hands the focus to the rail's
678
+ toggle.
679
+ - `tests/components/nativeScrollBar.test.tsx`: the stage's bar is in the content bars' wrapper and has no circle; the
680
+ coarse-pointer circle is the fine one shown while scrolling, and a content bar's starts hidden; a fine bar, content or
681
+ stage, draws both arrows around a 184 px track, and its track press and its thumb drag each move the scroller, while
682
+ a coarse one draws none, its 200 px track holding a 40 px thumb, and neither its track press nor its thumb drag moves
683
+ the scroller (each press on a scroller of its own, so the fine bar's moves show the presses reach the bar); the bars'
684
+ controls are one frozen object per pointer (all three under a fine one, none under a coarse one), and the tree's bar
685
+ takes the same.
686
+ `tests/components/explorerPane.test.tsx`: under a coarse pointer the tree's bar keeps its track and thumb and draws
687
+ no arrows.
688
+ - `tests/components/tableScrollBarWiring.test.tsx` (was `tableCircleWiring.test.tsx`): besides the tables' circle, a
689
+ document's tables (the viewer's `spreadsheetScrollBarControls`) and a CSV or workbook file's grid (its block's
690
+ `scrollBarControls`) get the pointer's bar controls, the frozen object (`scrollBarControlsFor`) the explorer's own bars
691
+ take; the tree's bar spreads the same values into its options.
692
+ - `tests/components/documentScrollAreas.test.tsx`, `tests/components/nativeScrollBar.test.tsx`: every content scroller's
693
+ bar slot, the viewer's in the tree and single views included, is as wide as the pointer's slot token, and the
694
+ viewer's toolbar keeps that length clear at its inline end. `tests/components/documentStreaming.test.tsx`: the
695
+ server's HTML of a delivered document already carries the slot's width, the toolbar's clearance and the full-width
696
+ column's mark. `tests/components/documentStyles.test.tsx`: the viewer that is its region's first child opts in to the
697
+ band before the measure, in a page and in a panel, and still while the next document loads behind the progress line;
698
+ a text file's viewer under its header does not. `tests/components/editPreview.test.tsx`: the editor's preview, handed
699
+ the page viewer's bar, circle gutter and slot width, keeps none of them.
700
+ - `tests/components/documentMarkup.test.tsx`: Copy the text logs a refused write with its reason and no missing
701
+ clipboard, turns a clipboard that throws into an announced failure, and lets a late answer to an earlier press,
702
+ success or failure, show and announce nothing while a late failure is still logged.
703
+ - `tests/unit/location.test.ts`: the tree view's `maximized` is written in its place and read back, other values and
704
+ a tree without a document or a folder are ignored without a redirect, `explorerHref` refuses the latter, the source
705
+ redirect keeps it while the redirects that lose the document do not, and the single view ignores it.
706
+ - `tests/unit/settings.test.ts`: a closed explorer is written only as `true` in the fixed key order and read back,
707
+ `false` is not written, and any other value is dropped.
708
+ - `tests/unit/geometryTokens.test.ts`, `tests/unit/tokens.test.ts`: `EXPLORER_BAR_PIXELS` is 55 px and the sheet's
709
+ bar, the rail and the merged document bar are spaced by it; every toggle and close button is one control at least;
710
+ the scrollers keep the gutter under a fine pointer and overlay the bar under a coarse one, the bar's slot taking the
711
+ bar's width under a fine pointer and none under a coarse one (the slot and the overlay add up to the bar's width under
712
+ both); the document bar's padding;
713
+ forced colors for the toggles and close buttons; the handle's band is `FINE_TARGET_PIXELS` and, under a coarse
714
+ pointer, `COARSE_TARGET_PIXELS`, and 0 without a handle; before the measure the container query's threshold is
715
+ `explorerSheetBelowPixels` in rem, the floor `EXPLORER_MIN_REM`, the explorer, the handle and the rail are hidden
716
+ below the threshold, and the sheet's shape there copies the rules it stands in for.
717
+ - `tests/unit/labels.test.ts`: both catalogs carry the six labels of the copy buttons of the code blocks and the
718
+ display formulas.
719
+ - `tests/support/mediaQueryStandIn.ts`: one `matchMedia` stand-in for the browser-half setup and
720
+ `installLayoutStandIns`.
721
+ - `tests/e2e/explorer-toggle.spec.ts` (real browser, 1280 × 720): the close button sits 5 px from the explorer's top
722
+ and from the end that keeps half the handle's band clear, with the source switch ending at least 5 px before it
723
+ and centred on it; closing leaves a 55 px rail whose 44 px toggle is 5 px from its edges, the content starting at
724
+ its edge, with the focus on the toggle, the choice in the cookie and in the server's markup, kept by a reload and
725
+ per view; the toggle reopens at the same width and hands the focus back to the close button; a drag held at the
726
+ edge and brought back keeps the split, one released there closes it, and Shift+ArrowLeft closes it to the rail;
727
+ in either view, widening the explorer and then dragging it closed reopens it at the widened width, and a reload
728
+ gives the same width; the handle's arrow keys stop at the minimum and close on the next press, the toggle then
729
+ reopening at the width a reload gives; a tree closed and reopened, or moved to the sheet and back, shows the row it
730
+ showed first at the same height; crossing the sheet threshold hands the focus between the rail's toggle and the
731
+ sheet's.
732
+ - `tests/e2e/document-maximize.spec.ts`: Maximize, the last button of the document's bar, replaces the URL, covers
733
+ the page below the demo's header to the window's edges, keeps the same focused button under the restore name,
734
+ announces the document's name, makes the explorer's panel and handle inert (Tab and Shift+Tab never land there and
735
+ still reach the host's header), and Escape restores all of it, from inside a block's toolbar (a non-modal dialog
736
+ the browser does not close on Escape) too, while Escape in a block's fullscreen (a modal dialog) closes only the
737
+ fullscreen and keeps the document maximized; maximizing and then restoring the long document keep its scroller's
738
+ `scrollTop` within 1 px; a maximized address covers in the server's markup, a link followed while maximized opens
739
+ the next document maximized while its href carries no flag, a maximized folder covers with its README; on a phone
740
+ the one 55 px bar keeps its height and the document's place while the sheet's toggle lies inert under the cover.
741
+ - `tests/e2e/touch-layout.spec.ts`: under a coarse pointer at 320, 360, 390 and 430 px the document keeps 16 px on
742
+ both sides and spans the width, its 8 px bar lying over the scroller's end and nothing overflowing; at 390 px the
743
+ bar draws no arrows, the bar and the hidden circle let presses through, a finger's scroll shows the circle, which
744
+ then takes presses, and it hides again `TAP_SCROLL_CIRCLE_HIDE_DELAY_MS` (2 s) after the last scroll, a flick's
745
+ momentum included, and no sooner (both times read on the page's clock); a multi-view panel keeps no gutter, and the
746
+ stage's bar draws no arrows, passes the presses at a quarter, half and three quarters of its length to the stage's
747
+ scroll root, and a finger's pan that starts on it scrolls the stage; the tree's bar, in the phone's sheet, and a
748
+ document's ```` ```spreadsheets ```` table's grid's bar draw no arrows, their thumbs are disabled, a press on their
749
+ strip lands on the box of their scroll pane (not on the track, nor on a row), and a finger's pan that starts there
750
+ scrolls the tree or the table's rows while the document stays where it was; a table whose rows fit its box while its
751
+ columns are wider gives its rows' pane `touch-action: pan-y` (vertical pans stay with the document, horizontal ones
752
+ go to the table) and a table whose rows scroll gives it `none`; a fine pointer at a phone's width keeps
753
+ the 54 px gutter, the bar beside the scroller with its arrows and the circle always shown, and the table's bar its
754
+ arrows and an idle thumb, a click at the same point of its track scrolling the table.
755
+ - `tests/e2e/appearance.spec.ts`: the bars follow the explorer's theme as the page does, not the system's scheme: under
756
+ a dark system scheme a light page's table, document and tree bars stay light, and choosing Dark turns all three
757
+ dark, the three drawing one track and thumb colour under either theme.
758
+ - `tests/e2e/support.ts`: one `cellOf`, `gridReady`, `TABLES_DOCUMENT` and `twoFrames` for the specs that read the
759
+ tables and wait for frames.
760
+ - `tests/e2e/first-paint.spec.ts`: at 390 px (coarse), 768 px (coarse) and 1280 px (fine), the tree view's document,
761
+ its empty state and the multi-panel view, with the explorer open and closed, draw the explorer panel, the rail, the
762
+ content panel and its first child, the document bar, the document's scroll row, the viewer's bar slot, its toolbar
763
+ and the document's first heading in the server's render (a bot's, without JavaScript) where the hydrated, measured
764
+ page draws them (the measured slot as wide as the pointer's bar, the heading below the toolbar's band): out of the
765
+ split at 390 px, the 13rem floor at
766
+ 768 px, the golden share at 1280 px, the rail one bar wide above the threshold. The tree view's document bar keeps
767
+ its inside as well: its row's start padding, its block-end border and its surface are the same in both paints, and
768
+ every button of the first paint is still there once measured, in the same box, its label visually hidden in both
769
+ paints or in neither (the source toggle and the Edit toggle, which hydration adds, are not compared). Read frame by
770
+ frame while the page loads and hydrates, a coarse-pointer tablet never shows the server's tree bar with its arrows
771
+ or its circle, and a document's eight code blocks keep their header rows and their lines in every frame while the
772
+ document never grows shorter: in the complete document a bot receives, all eight keep the server's highlighting in
773
+ every frame; in the document streamed to people, no highlighted block turns back into plain text and all eight end
774
+ highlighted, while a block the server finished after the browser's first frame shows its plain lines in the same
775
+ box until React reveals it (React batches such reveals, 300 ms after the previous one).
776
+ - `tests/e2e/instant-preview.spec.ts`: typing after a display formula and an inline one in the editing preview leaves
777
+ both formulas' MathML roots in the document. `tests/e2e/document-markup.spec.ts`, `editing.spec.ts`,
778
+ `svg-image-source.spec.ts`: the document bar ends with the icon-only Maximize, named and without text, which stays
779
+ while editing. `tests/e2e/expand-all.spec.ts`: the arrow keys close the explorer to the rail, which aborts the tree's
780
+ request in flight, and the focused rail toggle reopens it, which requests again.
781
+ `tests/e2e/scroll-lock-report.spec.ts`: the window resizes while the reader's drag holds the explorer collapsed, and
782
+ the release closes it to the rail.
783
+
784
+ ### Documentation
785
+
786
+ - README: the rail, the maximized document and the touch layout in the overview and the Layout table, the maximize
787
+ insets as `--aqmx-maximize-*` with `data-aqmx-content-covers-page`, the tree view's `maximized` and its history entry,
788
+ and the coarse-pointer scroll bars. `docs/behavior/layout.md`: "Closing the explorer", "The maximized document", the
789
+ merged sheet bar, the insets, the coarse-pointer rhythm, and which pans move a table's columns under a coarse pointer
790
+ (a horizontal pan over the rows does even when every row fits; one that starts on the header or footer rows or on the
791
+ horizontal bar goes to the document). `docs/behavior/url-contract.md`: `maximized` in the tree
792
+ view, its canonical form, history entry and carry, and the display settings' closed explorer.
793
+ `docs/behavior/dom-hooks.md`: the new hooks, `data-aqmx-measured` among them. `docs/behavior/localization.md`:
794
+ `documentMaximized` and `documentRestored`. `docs/behavior/layout.md` and the README's Layout table: the first
795
+ paint before the measure. `docs/behavior/layout.md` and the README's scroll bars: the bar's slot from the first
796
+ paint, and the band the viewer's toolbar covers before the measure.
797
+
3
798
  ## 0.33.0 (2026-11-04) — The tree's lines and expand glyphs lie above opaque row tints, and its colours follow the explorer's theme, on @aiquants/directory-tree 6.0.0
4
799
 
5
800
  ### Breaking