@aiquants/markdown-explorer 0.35.0 → 0.37.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 (93) hide show
  1. package/CHANGELOG.md +165 -0
  2. package/README.md +105 -13
  3. package/dist/{EditSurface-D2j1kCEE.js → EditSurface-BQgwRUrR.js} +250 -245
  4. package/dist/EditSurface-Xvk5wZu7.cjs +6 -0
  5. package/dist/ExplorerSplit-C_3FChSt.cjs +2 -0
  6. package/dist/ExplorerSplit-C_kaEnyM.js +1619 -0
  7. package/dist/{MultiLayout-CxV5SI7f.cjs → MultiLayout-BZNj1GYo.cjs} +1 -1
  8. package/dist/{MultiLayout-BeJ5Lubb.js → MultiLayout-DROxkTdD.js} +24 -24
  9. package/dist/{NativeScrollBar-RWXpVhbI.cjs → NativeScrollBar-BDF9A1sc.cjs} +1 -1
  10. package/dist/{NativeScrollBar-BM5NULzg.js → NativeScrollBar-DvdOpwIW.js} +2 -2
  11. package/dist/TreeLayout-Cc-ykewY.js +103 -0
  12. package/dist/TreeLayout-D_DYV64_.cjs +1 -0
  13. package/dist/client/MarkdownExplorer.d.cts +4 -5
  14. package/dist/client/MarkdownExplorer.d.ts +4 -5
  15. package/dist/client/hostContract.d.cts +1 -8
  16. package/dist/client/hostContract.d.ts +1 -8
  17. package/dist/core/config.d.cts +6 -0
  18. package/dist/core/config.d.ts +6 -0
  19. package/dist/core/contracts.d.cts +21 -0
  20. package/dist/core/contracts.d.ts +21 -0
  21. package/dist/core/dataRoute.d.cts +5 -1
  22. package/dist/core/dataRoute.d.ts +5 -1
  23. package/dist/core/documentId.d.cts +6 -0
  24. package/dist/core/documentId.d.ts +6 -0
  25. package/dist/core/labels.d.cts +10 -9
  26. package/dist/core/labels.d.ts +10 -9
  27. package/dist/core/location.d.cts +21 -0
  28. package/dist/core/location.d.ts +21 -0
  29. package/dist/explorerCore-DivWkFQF.cjs +1 -0
  30. package/dist/explorerCore-EkU0mwdW.js +1085 -0
  31. package/dist/index-BmOU3xcK.cjs +18 -0
  32. package/dist/{index-C1YMH-yI.js → index-dtjghDWY.js} +2647 -2466
  33. package/dist/index.cjs +1 -1
  34. package/dist/index.d.cts +3 -2
  35. package/dist/index.d.ts +3 -2
  36. package/dist/index.js +49 -45
  37. package/dist/location-Dh6K-y7w.js +761 -0
  38. package/dist/location-DrOP6t1F.cjs +1 -0
  39. package/dist/{merge-DQUYEGCx.cjs → merge-BCFCL1cF.cjs} +1 -1
  40. package/dist/{merge-Bb_HpPhe.js → merge-DC_h-t31.js} +1 -1
  41. package/dist/ownUrls-BTPGNhBt.cjs +1 -0
  42. package/dist/ownUrls-DD0cSCsF.js +409 -0
  43. package/dist/{sanitizeJob-BYRk17nr.js → sanitizeJob-BYqzjFJC.js} +1 -1
  44. package/dist/{sanitizeJob-Cs9o3Vpl.cjs → sanitizeJob-CudE1RUP.cjs} +1 -1
  45. package/dist/{sanitizePolicy-CiQfnxyd.cjs → sanitizePolicy-C-ehd0J_.cjs} +1 -1
  46. package/dist/{sanitizePolicy-CEMdaLUB.js → sanitizePolicy-DAPnUUVm.js} +1 -1
  47. package/dist/sanitizeWorker.cjs +1 -1
  48. package/dist/sanitizeWorker.js +3 -3
  49. package/dist/{sanitizerService-KWXv7bPm.js → sanitizerService-B8v4ap9t.js} +1 -1
  50. package/dist/{sanitizerService-BY4CPCoA.cjs → sanitizerService-DomN7lwC.cjs} +1 -1
  51. package/dist/server/anonymous.d.cts +2 -2
  52. package/dist/server/anonymous.d.ts +2 -2
  53. package/dist/server/errors.d.cts +1 -1
  54. package/dist/server/errors.d.ts +1 -1
  55. package/dist/server/ports.d.cts +24 -2
  56. package/dist/server/ports.d.ts +24 -2
  57. package/dist/server.cjs +1 -1
  58. package/dist/server.d.cts +1 -1
  59. package/dist/server.d.ts +1 -1
  60. package/dist/server.js +16 -16
  61. package/dist/serverBrowser.cjs +1 -1
  62. package/dist/serverBrowser.js +3 -3
  63. package/dist/serverCore.cjs +1 -1
  64. package/dist/serverCore.d.cts +1 -1
  65. package/dist/serverCore.d.ts +1 -1
  66. package/dist/serverCore.js +4 -4
  67. package/dist/styles/markdown-explorer.css +1 -1
  68. package/dist/{tapScrollCircle-BEydRn0y.js → tapScrollCircle-CqMZzWjo.js} +1 -1
  69. package/dist/{tapScrollCircle-DdX0Wri0.cjs → tapScrollCircle-DVNlszeF.cjs} +1 -1
  70. package/dist/testing.cjs +1 -1
  71. package/dist/testing.d.cts +5 -0
  72. package/dist/testing.d.ts +5 -0
  73. package/dist/testing.js +80 -2
  74. package/dist/{useSplitPersistence-B2Fj508K.cjs → useSplitPersistence-BUa_KMsV.cjs} +1 -1
  75. package/dist/{useSplitPersistence-Fkqak8G8.js → useSplitPersistence-pnb21dsr.js} +1 -1
  76. package/docs/behavior/dom-hooks.md +11 -2
  77. package/docs/behavior/hosting.md +1 -1
  78. package/docs/behavior/localization.md +2 -2
  79. package/docs/behavior/security.md +24 -3
  80. package/docs/behavior/url-contract.md +26 -0
  81. package/package.json +6 -4
  82. package/dist/EditSurface-CLG70Vnn.cjs +0 -6
  83. package/dist/ExplorerSplit-CfP1smbT.js +0 -1589
  84. package/dist/ExplorerSplit-D_0VohOv.cjs +0 -2
  85. package/dist/TreeLayout-AxLw-36S.js +0 -103
  86. package/dist/TreeLayout-Bg2YH-EY.cjs +0 -1
  87. package/dist/explorerCore-DLpDuSev.js +0 -998
  88. package/dist/explorerCore-DYrxS9ez.cjs +0 -1
  89. package/dist/index-LQWQfpAf.cjs +0 -18
  90. package/dist/location--KvTA0Ri.js +0 -726
  91. package/dist/location-D8DyDkuA.cjs +0 -1
  92. package/dist/ownUrls-B259RGgd.cjs +0 -1
  93. package/dist/ownUrls-Dh5g6ZJi.js +0 -370
@@ -22,6 +22,7 @@ Tests and host styling may rely on the `data-testid` values and `data-aqmx-*` at
22
22
  | `data-testid="markdown-explorer-sheet"` | The explorer sheet (a modal `dialog`) | Has the `open` attribute while shown |
23
23
  | `data-testid="markdown-explorer-sheet-close"` | Close button of the sheet | |
24
24
  | `data-testid="markdown-explorer-sheet-announcer"` | The sheet's polite live region (`role="status"`), inside the dialog | Holds the announcements while the sheet is open (the modal dialog hides the root's region), with the same text as the root's region would; empty while the sheet is closed and when it opens |
25
+ | `data-testid="markdown-explorer-sheet-access-failures"` | The access failures of the content behind the open sheet, first in the explorer inside the sheet | Present only while the open sheet holds one. The content behind the modal sheet is inert and hidden from assistive technology, so each access failure met there is drawn here instead of in its place — its own element, with its hook and `data-aqmx-failure` — in the order they came, and goes back to its place, with the same occurrence, once the sheet closes (see [Access failures](../../README.md#access-failures)) |
25
26
  | `data-testid="markdown-explorer-split-loading"` | Placeholder while the tree view's code loads | Carries `data-aqmx-content-pane` |
26
27
  | `data-testid="markdown-explorer-single"` | Single view frame | Carries `data-aqmx-content-pane` |
27
28
  | `data-aqmx-content-pane` | The content pane the explorer's dialogs are centered over | The document column of the tree view (the bar and the document region), the single view's frame, the multi view's stage, and a maximized panel's frame (`markdown-explorer-panel-frame`, inside the stage) while it is maximized; a view's loading placeholder while its code loads. The innermost element carrying it is the pane |
@@ -33,10 +34,13 @@ Tests and host styling may rely on the `data-testid` values and `data-aqmx-*` at
33
34
  | `data-testid="markdown-explorer-edit-next-conflict"` / `-history` / `-save` | The editor's actions in the bar | Next conflict only while conflicts wait (it moves the focus to the conflict's first choice); History (`aria-haspopup="dialog"`) only when the host keeps revisions; Save carries `aria-keyshortcuts="Control+S Meta+S"`, `aria-busy` while it runs and `aria-disabled` until the draft changes (never `disabled`). A draft session, which never saves, has neither History nor Save |
34
35
  | `data-testid="markdown-explorer-edit-view"` | The view switch in the bar, between Next conflict and History (`role="radiogroup"`, named `editView`; in a panel `editViewNamed`) | Its radios are `-view-editor`, `-view-split` (only where the pane has room for the preview beside the editor: a page view, a maximized panel) and `-view-preview`, each a native radio (`input type="radio"`, the three sharing a name unique to the switch) covering its icon button (a `label`, which draws the checked state and the focus ring), checked for the shown view, titled by its tooltip and named by `aria-label` (`editViewEditor`, `editViewSplit`, `editViewPreview`), with its words hidden where the bar is narrower than two reading columns and in a panel. As in any radio group, Tab stops at the checked radio and the arrow keys check the next or the previous one. The editor's and the preview's radios carry `aria-keyshortcuts="Control+E Meta+E"`: Ctrl+E (⌘E on Apple's platforms) switches between the editor and the preview from the editor, the preview or the switch |
35
36
  | `data-testid="markdown-explorer-save-grant"` / `-open` / `-retry` | Notice below the bar's row when a save needs a grant, its action and Try again (which saves again) | |
37
+ | `data-testid="markdown-explorer-save-access-failure"` | The host's presenter's node for a save that met an access failure, below the bar's row | Carries `data-aqmx-failure` (`unauthorized` / `forbidden`). The place is `write`, and the node's retry saves again without asking `confirmUnversionedSaves` again. Meanwhile the status carries `data-aqmx-save="failed"` and names the unsaved draft alone (`draftUnsaved`), and the announcer says nothing of the failure |
36
38
  | `data-testid="markdown-explorer-edit-close-confirm"` / `-cancel` / `-confirm` | The confirmation before an unsaved draft is closed (a modal `dialog`) | Centered over the content pane (`data-aqmx-content-pane`), as the other dialogs below. Opens with the focus on the way back (`unsavedStay`); Escape and the backdrop choose it too (Escape is consumed). `-confirm` (`unsavedDiscard`) closes the draft |
37
39
  | `data-testid="markdown-explorer-unsaved-guard"` / `-cancel` / `-confirm` | The confirmation before a navigation drops unsaved drafts (a modal `dialog`, one per explorer) | As above; `-confirm` drops those drafts and goes on |
38
40
  | `data-testid="markdown-explorer-history"` | The revisions dialog (a modal `dialog`, named `historyTitle`) | Holds `-history-loading`, `-history-failure` or `-history-empty`, else `-history-list` of `-history-entry` buttons (`aria-pressed` for the one shown), the picked revision's text `-history-text` (focusable, so the keyboard scrolls it) or `-history-revision-failure`, and `-history-close` and `-history-restore` (`aria-disabled` until a revision's text is shown) |
39
41
  | `data-testid="markdown-explorer-document-refresh"` | The Refresh document button, in the bar | Reads that document alone again past the host's caches. The page views name it by its visible label (`refreshDocumentLabel`; tooltip `refreshDocument`); a panel's is icon-only, with `aria-label` and `title` set to `refreshDocumentNamed` (the panel title). Carries `aria-busy="true"` and `data-aqmx-busy="true"` while it runs, and `aria-disabled="true"` then and while the document loads (never `disabled`) |
42
+ | `data-testid="markdown-explorer-document-permalink"` | The Copy permalink button, in the bar after Refresh document | Drawn with `documentIds` in the configuration while the document is not edited, from the server's render on (see [URL contract](url-contract.md#document-ids)); `aria-disabled="true"` while the document loads or failed, when it ignores presses. The page views name it by its visible label (`copyPermalinkLabel`; tooltip `copyPermalink`); a panel's is icon-only, with `aria-label` and `title` set to `copyPermalinkNamed`. Carries `data-aqmx-copy-outcome`: `idle`, then `copied` or `failed` for 2 seconds after a press, while its `title` says what happened (its name never changes; the announcer speaks the outcome). |
43
+ | `data-testid="markdown-explorer-permalink-access-failure"` | The host's presenter's node for the latest Copy permalink press whose ID was refused by an access failure, in the bar below its button row | Carries `data-aqmx-failure` (`unauthorized` / `forbidden`). The place is `write`, with no retry (the reader presses again). The button keeps `data-aqmx-copy-outcome="idle"` and the announcer says nothing; the node goes at the next press and when the bar moves to another document (it does not come back on return), and while the document is edited, after which it is drawn again |
40
44
  | `data-testid="markdown-explorer-document-maximize"` | The Maximize button that ends the tree view's document bar | Icon-only, with `aria-label` and `title` naming what a press does (`documentMaximize`, or `documentRestore` while the document is maximized) and no `aria-pressed`; the same element in every state. Absent in the single view and in a multi-view panel |
41
45
  | `data-aqmx-maximized` | The tree view's document column (the bar and the document region, `data-aqmx-content-pane`) | `true` while the column covers the page — the document is maximized and has something to show, or its folder's README is being looked for — else `false` (a multi-view panel's frame carries the same attribute, see [Multi-panel view](#multi-panel-view)) |
42
46
  | `data-testid="markdown-explorer-document-refresh-failure"` | Notice of a document refresh that failed, inside the bar below its button row | No live role (the announcer speaks the same text); carries `data-aqmx-failure` (the reason). The failure is the document's answer, or the reading of the part the document's content reads itself (a table file's table, a document shown as written) when that content showed a copy of it, which stays. Shown while the copy of the document it kept stays on screen: a newer answer that replaces or confirms that copy, a move to another document (it does not come back on return), a switch between the document rendered and as written and that control's next refresh take it down. It is the one notice of a failed refresh: no notice inside the document repeats it |
@@ -57,6 +61,7 @@ Tests and host styling may rely on the `data-testid` values and `data-aqmx-*` at
57
61
  | `data-testid="markdown-explorer-view-switch"` | Link to the other view | Carries `data-aqmx-target` (`tree` / `multi`) |
58
62
  | `data-testid="markdown-explorer-notice"` | One notice | Carries `data-aqmx-notice` (its id) and `data-aqmx-tone` (`info` / `warning` / `danger`) |
59
63
  | `data-testid="markdown-explorer-expand-all-stop"` | Notice of an Expand all press that stopped at a limit, in the explorer's body just above the tree area (not a live region, not focusable) | Holds the stop sentence announced at the stop (`expandAllFolderLimit` / `expandAllDepthLimit`); shown until the next press, Collapse all, a pane with no rows (failed, empty or cleared) or unmount (a source or view switch). Carries `data-aqmx-stop` (`folder-limit` / `depth-limit`) |
64
+ | `data-testid="markdown-explorer-folder-access-failure"` | The host's presenter's node for the lazy folders whose children met an access failure, in the explorer's body above the tree area (before the Expand all stop notice) | Carries `data-aqmx-failure`, the reason of the first folder that stopped. One node for every folder that stopped, one after another, while any of them stays stopped (the folders one press of Expand all stops at once share it), with the place `read`; its retry loads every stopped folder again. The rows keep `data-aqmx-children="failed"` and their `markdown-explorer-folder-retry`; the announcer names none of the folders, and the end of an Expand all press counts them among the folders that could not be loaded |
60
65
  | `data-testid="markdown-explorer-tree"` | Tree area | |
61
66
  | `data-testid="markdown-explorer-tree-scroll"` | The tree's scroll pane (the virtual list's root) | |
62
67
  | `data-testid="markdown-explorer-tree-loading"` | Tree placeholder while it loads | |
@@ -81,9 +86,10 @@ The tree's stand-in Tab stop, present while the tab-stop row is outside the tree
81
86
  | `data-testid="markdown-explorer-document-empty"` | No document selected | |
82
87
  | `data-testid="markdown-explorer-folder-empty"` | The tree view's folder without a README | The region carries `data-aqmx-document-kind="empty"`; a page view announces the text (`folderReadmeMissing`) once for each folder shown |
83
88
  | `data-testid="markdown-explorer-folder-failure"` | Failure to list the tree view's folder, or to load the tree it lies in | Carries `data-aqmx-failure` (the reason; `not-found` for no such folder); its callout has no role: the announcer speaks the failure (`documentFailed`, with the folder's name), once for each failed attempt. A `failed` listing offers Try again (`retry`) |
84
- | `data-testid="markdown-explorer-document-skeleton"` | Placeholder while a pane has no document to show yet (its first document, one the server gave up on, or the README of the tree view's folder while it is looked for) | The region carries `aria-busy="true"` |
89
+ | `data-testid="markdown-explorer-document-skeleton"` | Placeholder while a pane has no document to show yet (its first document, one the server gave up on, the README of the tree view's folder while it is looked for, or the document of an ID URL while its ID is resolved) | The region carries `aria-busy="true"` |
85
90
  | `data-testid="markdown-explorer-document-progress"` | Progress bar while the next document (or a fresh copy of a failed one) loads over the one still shown | The region carries `aria-busy="true"` meanwhile, also during router navigations |
86
91
  | `data-testid="markdown-explorer-document-failure"` | Document failure | Carries `data-aqmx-failure` (the reason); its callout has no role in every view (tree, single and multi-view panels): the announcer speaks the failure (`documentFailed`), once for each failed attempt |
92
+ | `data-testid="markdown-explorer-document-id-failure"` | Failure to open the document of an ID URL, in the document's place | Carries `data-aqmx-failure` (the reason); its callout has no role: the announcer speaks the failure. Holds Try again only for `failed`, which resolves the ID again (see [URL contract](url-contract.md#document-ids)). |
87
93
  | `data-testid="markdown-explorer-document-notices"` | The notices above a document region | `role="status"` (polite, not atomic), in the page whenever the pane shows a document and empty while there is nothing to tell, so each notice is spoken as it appears; in this order: the document changed elsewhere, media that could not be loaded, media that cannot be played |
88
94
  | `data-testid="markdown-explorer-document-notice"` | One notice above the document | Carries `data-aqmx-notice` (`changed` under the host change policy `"notify"`, `media-load` or `media-unplayable`) and `data-aqmx-tone` (`info` for `changed`, `warning` for the media); `changed` and `media-load` hold a Reload button (`reload`), and a media notice names the one medium it tells of or counts two or more |
89
95
  | `data-testid="markdown-explorer-text-truncated"` | Notice under a cut text preview, or a cut source of a Markdown document shown as written | |
@@ -143,4 +149,7 @@ Everything around a panel's content is drawn by `@aiquants/drag-drop-panels` and
143
149
 
144
150
  ## Failures and tones
145
151
 
146
- `data-aqmx-failure` takes the failure reasons: `unauthorized`, `forbidden`, `not-found`, `not-configured`, `invalid`, `too-large`, `unsupported` and `failed`. `data-aqmx-tone` on a callout is `danger` for `unauthorized`, `forbidden` and `failed`, and `warning` for the other reasons. The explorer's own failure callout offers "Try again" (`retry`) only for `failed`, a reload of the page (`reloadPage`) for `unauthorized`, and no button for the other reasons, which retrying cannot change.
152
+ `data-aqmx-failure` takes the failure reasons: `unauthorized`, `forbidden`, `not-found`, `not-configured`, `invalid`, `too-large`, `unsupported` and `failed`. For the explorer's own reasons (all but `unauthorized` and `forbidden`) the element holds the explorer's callout: its `data-aqmx-tone` is `danger` for `failed` and `warning` for the other reasons, and it offers "Try again" (`retry`) only for `failed`, with no button for the other reasons, which retrying cannot change.
153
+ For an access failure (`unauthorized`, `forbidden`) the same element holds the node the host's `accessFailure` presenter returns instead, whatever its row says of the callout: no callout, tone, role or text of the explorer's, and nothing for its announcer to say.
154
+ This holds for every hook above that carries `data-aqmx-failure` (a host's `renderTreeFailure` view still replaces what the tree failure holds), and for the three only an access failure draws: `markdown-explorer-save-access-failure`, `markdown-explorer-permalink-access-failure` and `markdown-explorer-folder-access-failure`.
155
+ While the explorer's sheet is open, the content's access failures are drawn inside `markdown-explorer-sheet-access-failures` instead of in place (see [Access failures](../../README.md#access-failures)).
@@ -51,7 +51,7 @@ export const explorer = createExplorerServer(
51
51
  sources,
52
52
  document: documentOf,
53
53
  asset: assetOf,
54
- signedOutPage: (_request, headers) => new Response(null, { status: 401, headers }),
54
+ signedOutPage: (_args, headers) => new Response(null, { status: 401, headers }),
55
55
  readSettings: keptSettings,
56
56
  assetMaxRangeBytes: null,
57
57
  },
@@ -47,8 +47,8 @@ This page is part of the host-facing contract of `@aiquants/markdown-explorer`;
47
47
  `spreadsheetSheetLoading` is the screen-reader text while a sheet is read for the first time; a sheet without data shows `spreadsheetSheetEmpty`. Its notes are `spreadsheetUnshownSheets(count)` (sheets left out: hidden, or without a table), `spreadsheetUnlistedSheets(count)` (the number of sheets listed, when the workbook has more than the reader lists) and `spreadsheetWorkbookFirstSheet` (the first sheet's text shown instead of the workbook);
48
48
  in place of the tabs or a sheet's table, `spreadsheetWorkbookEncrypted` (a password-protected workbook), `spreadsheetNotWorkbook` (bytes that are no workbook the explorer reads, a legacy `.xls` included) or `spreadsheetWorkbookTooLarge` (past `spreadsheets.maxWorkbookBytes` or the reader's limit for one part).
49
49
  - `copyText` is the accessible name and tooltip of the icon-only Copy the text button in the header of a text read whole (a text file, or a Markdown document shown as written). A copy is announced with `copiedText`, or with `copyTextFailed` when the browser has no asynchronous clipboard, refuses the write or has a clipboard that throws; for 2 seconds the outcome's label is also the button's tooltip, while its name stays `copyText`.
50
- - An `unauthorized` failure asks the reader to reload the page (`failureUnauthorizedBody` with the `reloadPage` button) unless the host passes `onSessionEnded`; then `accountState` picks its body and its button: `failureUnauthorizedSignInBody` and `signInAgain` while the account is `"signed-in"` (the default; its session ended), `failureUnauthorizedSignedOutBody` and `signIn` while it is `"signed-out"`.
51
- Neither button names a service, so a host that signs in to a named one says so through `labels`.
50
+ - The catalogs hold no words for an access failure: a session that ended (`unauthorized`) and something the reader may not read or write (`forbidden`) are drawn by the host's `accessFailure` presenter, in the presenter's own words (for example `@aiquants/auth-core`'s, `resolveAccessFailureLabels(locale)`), so `labels` cannot reword them and a host that signs in to a named service says so there.
51
+ The one sentence the explorer gives the presenter is `documentIdForbidden`, what was denied when an ID URL answers `forbidden` (see [Access failures](../../README.md#access-failures)).
52
52
  - Under `confirmUnversionedSaves`, a save that would write a change to a source that keeps no previous versions asks first: `unversionedSaveTitle`, `unversionedSaveBody` (the previous content cannot be restored), `unversionedSaveConfirm`, which saves, and `unsavedStay`, which goes back to editing.
53
53
  - `switchToTree` and `switchToMulti` name their destination with the README's view names ("Open in the tree view" / "ツリービューで開く", "Open in the multi-panel view" / "マルチビューで開く"); no label names the single view, which no control inside the explorer opens.
54
54
 
@@ -113,12 +113,12 @@ In a tree or children listing, an entry with an empty name, or with a path the b
113
113
  ## Responses
114
114
 
115
115
  - Every JSON data response of the explorer's own carries `Content-Type: application/json; charset=utf-8`, `Cache-Control: private, no-store`, `X-Content-Type-Options: nosniff`, `Content-Security-Policy: default-src 'none'; frame-ancestors 'none'; sandbox` and `Cross-Origin-Resource-Policy: same-origin`, and has a JSON body.
116
- - The page loader's responses carry `Cache-Control: private, no-store` through the exported `headers`, to both the HTML document and the single-fetch data.
116
+ - The page loader's responses carry `Cache-Control: private, no-store` through the exported `headers`, to both the HTML document and the single-fetch data. A reader `authenticate` answers `forbidden` for is refused with `@aiquants/auth-core`'s `accessFailureResponse("forbidden")` and the authentication's headers: a 403 with `Cache-Control: no-store`, which the same `headers` carry to both while the page route has its own error boundary (the HTML document's `Content-Type` stays the entry's, and the single-fetch data's React Router's).
117
117
  - The data route answers a React Router single-fetch request (`<dataPath>/<operation>.data`: its own URL path ends in `.data`, which React Router strips from the route's `url` argument and `params` but not from `request.url`) with a `not-found` failure (404) before authenticating or calling a source. React Router would run the route for it, read the whole response into memory and keep none of the headers above but `Set-Cookie`.
118
118
  - Status codes: 200 for a tree, children, ancestors, reveal, document, text, refresh or editor (`edit`, `save`, `preview`, `revisions`, `revision`) answer (a refresh answers the reloaded tree, as a tree request does, failures included), 400 for a missing or malformed parameter or draft,
119
- 401 when the reader is signed out, 403 when the reader may not use the explorer (or a refresh, a document request marked as one's, a save or a preview lacks its proof), 404 for an unknown operation or source for a children request to a source without `children()`, for an ancestors request to a source without `ancestors()` and for the editor's operations without `edit` ports, 405 (with `Allow`) for a wrong method, 413 for a draft longer than `editMaxBytes`.
119
+ 401 when the reader is signed out, 403 when the reader may not use the explorer (or a refresh, a document request marked as one's, a save, a preview or an ID's issue lacks its proof), 404 for an unknown operation or source for a children request to a source without `children()`, for an ancestors request to a source without `ancestors()`, for the editor's operations without `edit` ports and for the ID operations without `documentIds` ports, 405 (with `Allow`) for a wrong method, 413 for a draft longer than `editMaxBytes`.
120
120
  When `authenticate`, `principalKey` or the route itself throws, the answer is the failure the exception maps to, with that failure's status: an `ExplorerError` keeps its reason (`too-large` is 413; `not-configured`, `unsupported` and `failed` are 500; the other reasons take the statuses above), and any other exception is logged and answered `failed` with 500.
121
- A document or folder that cannot be shown — missing, denied, too large — is answered with status 200 and a failure in the JSON, so one inaccessible document does not break the multi-panel view.
121
+ A document or folder that cannot be shown — missing, denied, too large — is answered with status 200 and a failure in the JSON, so one inaccessible document does not break the multi-panel view. The ID operations (`issue-id`, `resolve-id`) answer a failure with its own status instead (see [Document IDs](#document-ids)).
122
122
  - The tree refresh (`POST {dataPath}/refresh`) requires the custom request header `X-Markdown-Explorer: refresh` and passes the shared cross-origin check of server routes (`crossOriginRefusal` of `@aiquants/request-isolation`, serving no navigation from another origin).
123
123
  That check refuses a request whose `Sec-Fetch-Site` is present and neither `same-origin` nor `none`, and a request without Fetch Metadata whose `Origin` is present and does not name the request's host (another host or port, `null`, or a value that is not a URL), so neither a cross-site form nor a page of a sibling subdomain can trigger it.
124
124
  It reloads the tree from the source (the source receives `refresh: true`) and answers a tree whose walk began after the refresh arrived; refreshes arriving while a walk runs share one trailing walk, so repeated refreshes never run more than one walk of a tree at a time.
@@ -168,6 +168,26 @@ In a tree or children listing, an entry with an empty name, or with a path the b
168
168
  Its answer for an internal link — `204 No Content` with `X-Link-Card-Skip: private-network` — is passed through unchanged, and `@aiquants/markdown`'s link card shows the link as a compact card and writes one `console.info` line; the explorer logs nothing of its own for cards.
169
169
  - **Same origin.** The browser asks the page's own origin with its credentials and `redirect: "error"`, so no `connect-src` beyond `'self'` is needed and no cross-origin page can read an answer (the data route grants no CORS).
170
170
 
171
+ ## Document IDs
172
+
173
+ - **An ID is not a permission.** The ID operations and ID URLs exist only with `documentIds` in the configuration and the server's `documentIds` ports (the host's registry, which binds each ID to one document path). Without the ports both operations answer as unknown operations (404) before the method is checked or the reader authenticated, and without the option the ID URLs' slug is an unknown view slug.
174
+ Opening an ID URL, or asking `resolve-id`, passes the same checks as the document's path URL — the reader's authentication, the deny rules, the sources' boundaries (with the admitting source's `confirm`) and the document's existence, confirmed through the host's `asset` port without opening its bytes — and an answer names the path only to a reader who can open it:
175
+
176
+ | Case | Answer | The path |
177
+ | --- | --- | --- |
178
+ | The ID is written wrong | 400 `invalid` | Not sent (the registry is not asked) |
179
+ | The registry does not know the ID (never issued, or forgotten when its document was erased) | 404 `not-found` | Not sent |
180
+ | The deny rules refuse the path, no source's boundary admits it, or the reader may not read it | 403 `forbidden` | Not sent |
181
+ | No document is at the path | 404 `not-found` | Not sent |
182
+ | The reader can open the document | A `302` to its path URL (the page loader), 200 `{ status: "ok", path, source }` (`resolve-id`) | Sent: the reader can open that path |
183
+
184
+ - A 403 tells that the ID exists. An ID carries about 55 random bits and cannot be guessed, so the 403 tells only a reader who was given the ID, for whom "it exists, but you may not read it" is a lead to ask for access.
185
+ - **`resolve-id`** (`GET` or `HEAD` `{dataPath}/resolve-id?id=`; 405 with `Allow: GET, HEAD` otherwise) takes an ID in its canonical form only (the lenient reading of lowercase, hyphens, `I`, `L` and `O` is the page URL's alone): a missing, repeated or other value is 400 before the registry is asked. The page loader answers an ID URL by the same resolution (see [URL contract](url-contract.md#document-ids)), and both send `Cache-Control: private, no-store`, so a redirect never outlives the binding it followed.
186
+ - **`issue-id`** (`POST {dataPath}/issue-id?path=`; 405 with `Allow: POST` otherwise) needs `X-Markdown-Explorer: document-id` and the shared cross-origin check of a refresh (`crossOriginRefusal`), checked before the reader is authenticated (403), so another site's page cannot make a reader issue IDs.
187
+ It issues only for a document the reader can open now: a missing, repeated or unacceptable `path`, or one ending in a slash (it has no URL), is 400; a path the deny rules refuse is 403 and logged with the operation, since the bar names only documents it shows; a path outside every source's boundary is 403 and a path where no document is 404 — all before the registry is called.
188
+ The explorer draws each candidate itself and hands the registry the path it shows, never a source's `readPath`; a `taken` candidate draws another, up to 4 candidates, and a fourth `taken` is logged and answered `failed` (500).
189
+ - **Answers are checked.** An `existing` ID that is not in its canonical form, a `bound` path that is not acceptable or has no URL, and any other shape break the contract: logged (a resolution's log names the operation and the error, not the path) and answered `failed` (500). An `ExplorerError` the registry throws answers its reason's status without a log, and any other exception is logged and answered `failed`.
190
+
171
191
  ## Caches and identity
172
192
 
173
193
  - The server's tree cache is keyed by the reader's scope (derived from the principal's stable key) and the source. `cacheScope: "shared"` lets readers share one entry when the tree does not depend on who reads it; `createFileSystemSource` uses `"principal"` unless told otherwise, which a source wrapped to filter its tree per reader must keep. Entries expire after `treeCache.ttlMs`, and the cache holds at most `treeCache.maxEntries` trees and `treeCache.maxBytes` of their JSON.
@@ -188,6 +208,7 @@ In a tree or children listing, an entry with an empty name, or with a path the b
188
208
  Answer the page's data requests with `createInProcessDataFetch` passed as `<MarkdownExplorer fetch>` (the page's router has no `basename`). The browser loads a document's images and media from their URLs, never through that fetch, so serve `{dataPath}/asset` (and `mediaDataPath`) over the page's own scheme, or show content without them.
189
209
  - Implement the ports: `document` and `asset` (and `children` for lazy folders) read what the explorer admitted, with the `readPath` it hands them, and report the same `version` for the same file.
190
210
  The explorer serves every file's bytes itself (see [What the explorer serves](#what-the-explorer-serves)), so the host writes no asset route (nor a route for a document's source, which the `text` operation reads through the same port); the `asset` port only finds the file and opens its bytes, through a handle it checked (for example by comparing the opened file's device, inode, size and modification time with those of the checked path, refusing a file that has changed since it was found) and aborting with the request's signal.
211
+ - With `documentIds`, give the server a registry (`documentIds` ports) whose bindings are unique both ways — one ID per path, one path per ID — and whose `issue` is atomic, so two readers pressing Copy permalink at once get one ID; bind the path the explorer passes (the document path, never a source's `readPath`), keep the ID in the canonical form it was given, and forget a document's ID when the document is erased, so an ID never comes to name another document. The ID grants nothing: keep authorizing every read by its path.
191
212
  - Refuse React Router single-fetch requests in any code your data route module runs before it hands the request to `dataLoader` or `dataAction` (which refuse them themselves), and in every resource route of your own: answer 404 for a request whose own URL path (`new URL(request.url).pathname`) ends in `.data`, before authenticating or touching storage.
192
213
  React Router strips that suffix from `params` and from the loader's `url` argument, runs the loader for such a request, reads the whole `Response` body into memory and drops every header but `Set-Cookie`.
193
214
  - When a source addresses documents by ID rather than by name (a cloud drive, for example), the deny rules can only filter its listings by entry name; its `document` function must refuse denied names itself, since the request carries only the ID.
@@ -9,8 +9,10 @@ This page is part of the host-facing contract of `@aiquants/markdown-explorer`;
9
9
  | Tree | `{basePath}/{views.tree}`, `{basePath}/{views.tree}/{document}` or `{basePath}/{views.tree}/{folder}/` | `source`, `style`, `align`, `maximized`, `markup` |
10
10
  | Multi-panel | `{basePath}/{views.multi}` | `source`, `doc` (repeated, in panel order), `maximized`, `markup` (repeated, in the order of `doc`) |
11
11
  | Single | `{basePath}/{views.single}/{document}` | `source`, `style`, `align`, `markup`, `showToc`, `showStyle`, `showAlign`, `padding`, `width`, `maxWidth` |
12
+ | Document ID (with `documentIds`) | `{basePath}/{documentIds.slug}/{ID}` (opens the document in the tree view) or `{basePath}/{documentIds.slug}/{ID}/{views.single}` (in the single view) | `style`, `align`; with `{views.single}` also `showToc`, `showStyle`, `showAlign`, `padding`, `width`, `maxWidth` |
12
13
 
13
14
  - `basePath` and the view slugs come from `defineExplorerConfig` (`tree`, `multi` and `single` by default). The data route lives at `dataPath` and is not a page.
15
+ With `documentIds: { slug }` in the configuration, the URLs under that slug name a document by its ID instead of its path and are never a location of their own: they send the reader to the path URL of the document the ID names (see [Document IDs](#document-ids)). Without the option, the slug is an unknown view slug like any other.
14
16
  - `source` names the source shown in the tree: one of the server's sources, whose ids come from `createMarkdownExplorer`'s `sources` in their order (the browser reads them from the page data's `sources`). The first is the default and is written by **omission**; it is never written explicitly. A source id is lowercase letters, digits and `-`, starting with a letter or digit (`isExplorerSourceId`).
15
17
  - The tree view shows a document, a folder (its README, see [Folder segment](#folder-segment)) or neither: `ExplorerLocation`'s tree view has `doc` and `folder`, at most one of them not `null`.
16
18
  - `markup` names the Markdown documents, SVG images and table files shown as written (their source — an SVG image's own SVG, a table file's CSV or TSV —, the document bar's Source toggle) instead of rendered (a table file as its table): in the tree and single views `markup=true` for the URL's document — in the tree view a folder's README too —, and in the multi-panel view one `markup` per open document shown that way, in the order of `doc` (a maximized document included).
@@ -57,6 +59,10 @@ Every URL resolves either to a location or to a redirect to its canonical form.
57
59
  | Multi-panel `maximized` repeated, or not one of the open documents | Redirect without `maximized` |
58
60
  | Multi-panel `markup` values that are not open documents, repeated, or out of the order of `doc` | Redirect with each open document shown as written once, in the order of `doc` |
59
61
  | A path segment after the multi-panel slug | Redirect to the multi-panel view without it |
62
+ | An ID URL without an ID (`{basePath}/{documentIds.slug}` or `{basePath}/{documentIds.slug}/`) | Redirect to the tree view without a document, keeping a valid `source` |
63
+ | Anything after a well-written ID but `{views.single}` alone (a view slug, a trailing slash, more segments) | Redirect to the ID URL without it, keeping `style` and `align` (the embedding parameters are dropped) |
64
+ | An ID written in lowercase, with hyphens, or with `I`, `L` or `O` | Read as its canonical ID and not redirected (its resolution sends the reader to the path URL once) |
65
+ | An ID written wrong (not 12 symbols once the hyphens are dropped, a character outside the alphabet, a wrong check symbol) | Not redirected: the page shows the `invalid` failure (status 400 from the loader) |
60
66
  | `style` naming no configured document style, `align` other than `left`, `center` or `right` | Ignored (the reader's own setting applies) |
61
67
  | `padding` outside 0–256 or not written in decimal digits (signs, exponents, hexadecimal, surrounding spaces and `Infinity` are not numbers here), `width` / `maxWidth` not a CSS length in `px`, `rem`, `em`, `ch`, `vw` or `%` | Ignored (the default applies) |
62
68
  | `showToc`, `showStyle`, `showAlign` other than `false` | Ignored (the control is shown) |
@@ -69,6 +75,26 @@ The page loader answers a non-canonical URL with a redirect, and the browser app
69
75
  A redirect keeps the URL's fragment on a page load and on the explorer's own replacing navigation: the browser carries the fragment across the loader's HTTP redirect of a document request (whose `Location` has none), and the replacing navigation appends the current one to the canonical URL, so loading `/docs#%E6%A6%82%E8%A6%81` ends on the tree view's URL with `#%E6%A6%82%E8%A6%81`.
70
76
  A client-side navigation from another route to a non-canonical URL loses its fragment: the loader runs and redirects, and React Router builds the redirected location from the redirect's `Location` alone. To keep a fragment, link to the canonical URL (`explorerHref`) with the fragment appended.
71
77
 
78
+ ## Document IDs
79
+
80
+ With `documentIds: { slug }` in the configuration, a document can also be linked by an ID that stays with it when its path changes: the host's registry (the server's `documentIds` ports, see the README's [Document IDs](../../README.md#document-ids)) binds each ID to one document path, and an ID URL sends the reader to the path URL of the document its ID names. The ID is not a permission: an ID URL opens a document exactly when its path URL would, for the same reader (see [Security](security.md#document-ids)).
81
+
82
+ - **The ID.** 12 symbols of Crockford's Base32 (`DOCUMENT_ID_ALPHABET`: the digits and the capital letters without `I`, `L`, `O` and `U`; `DOCUMENT_ID_LENGTH`): 11 random symbols and a check symbol, the remainder of the 11 read as a base-32 number divided by 37.
83
+ The server draws each from Web Crypto and draws again when the remainder is 32 or more, so every check symbol is in the same alphabet and an ID carries about 55 random bits, never guessed.
84
+ `isCanonicalDocumentId(value)` tells whether a value is an ID in its canonical form; `parseDocumentId(written)` reads one as a reader writes it — hyphens dropped, lowercase raised, `I` and `L` read as `1` and `O` as `0` — into its canonical form, or `null` when it is no ID (a character outside ASCII is refused before any case is raised); `groupDocumentId(id)` groups an ID in its canonical form by four symbols for reading aloud and copying by hand (`7K3M-9QX2-AB4W`; any other value throws a `RangeError`). A URL carries the canonical form, ungrouped.
85
+ `documentIdVectors()` of `@aiquants/markdown-explorer/testing` lists the answers `parseDocumentId` owes, for a host's registry and for an implementation of the rule in another language.
86
+ - **Writing and reading.** `explorerHref(config, { view: "document-id", id, opens?, overrides?, embed? })` writes an ID URL: `opens: "single"` writes `{views.single}` after the ID and is the only form that takes `embed`; `overrides` (`style`, `align`) are written as in a path URL. It throws a `TypeError` with a configuration without `documentIds`, and a `RangeError` for an ID that is not canonical, an `opens` other than `"single"`, embedding options without `opens: "single"`, or a value the resolver would ignore.
87
+ `resolveExplorerLocation` answers an ID URL with `{ kind: "document-id", id, opens, location }`: the canonical ID (`null` when the URL's ID is written wrong), how its document opens (`ExplorerDocumentIdOpening`: the tree view with the overrides, or the single view with the overrides and the embedding options), and the location drawn meanwhile and on a failure — the default source's tree without a document. The URL's `source`, `doc`, `markup` and `maximized` are not read: the ID decides the document.
88
+ - **The page loader.** It authenticates first (a signed-out reader gets `signedOutPage`, and a reader `authenticate` answers `forbidden` for gets `@aiquants/auth-core`'s 403 refusal, before the registry is asked), resolves the ID as the `resolve-id` operation does, and answers a document the reader can open with a `302` to its path URL — the view the ID URL asked for, under the source that admits the document (written by omission when it is the default), with the ID URL's overrides and embedding parameters — carrying `Cache-Control: private, no-store` and the authentication's headers.
89
+ Never `301` or `308`: a browser keeps a permanent redirect, and the path an ID names changes when its document moves.
90
+ Otherwise it answers the page with the location above, `documentId: { id, failure }` in the page data (never naming the path) and the failure's status: `invalid` 400 for an ID written wrong (the registry is not asked), `not-found` 404 for an ID the registry does not know or a path where no document is, `forbidden` 403 for a path the deny rules refuse, no source's boundary admits or the reader may not read, `failed` 500. Every other page carries `documentId: null`.
91
+ The browser keeps a fragment across the `302` on a page load; a client-side navigation from another route loses it, as for any redirect above.
92
+ - **In the browser.** A navigation inside the explorer to an ID URL (a document's link, Back and Forward) runs no loader: the explorer shows the document's skeleton in the location above, asks the data route's `resolve-id` operation, and moves with a replacing navigation to the path URL it writes with `explorerHref`, keeping the current fragment, so Back returns to the page the reader came from. A change of URL cancels the resolution in flight.
93
+ A failure is drawn in the document's place (`data-testid="markdown-explorer-document-id-failure"`, its reason in `data-aqmx-failure`) under its own title, with words of its own for `invalid` and `not-found`, and with Try again for `failed` only; an access failure there is the host's presenter's node instead, `forbidden` with the sentence of what was denied `documentIdForbidden`; a failure the loader already answered for the same ID is drawn without asking again, and an answer that names a source the page does not know is drawn as `failed`.
94
+ - **Copy permalink.** The bar of a document that is not edited holds Copy permalink, from the server's render on; while the document loads or failed, the button is unavailable (`aria-disabled`) and ignores presses, so the bar's buttons keep their places whatever the document's state.
95
+ A press asks the data route's `issue-id` operation for the document's ID (issued on the first press, the same ID ever after) and copies its ID URL as an absolute URL with the router's basename, in the form of the current view: the single view's with its overrides and embedding parameters, the tree view's with its overrides, and a multi-view panel's as the tree view's without any.
96
+ The clipboard write starts inside the press, since Safari allows a write only during the reader's gesture: a `ClipboardItem` whose text the ID URL fulfils once the server answers. The outcome is announced and shown as the bar's other copies are, with the ID grouped, or with why nothing was copied: the failure's title when no ID could be issued, otherwise the browser's refusal — a browser without the asynchronous clipboard or without `ClipboardItem` included, never retried with `writeText()`, which would write outside the reader's gesture.
97
+
72
98
  ## Document links
73
99
 
74
100
  A Markdown link that should open another document inside the explorer is resolved by the host's parser, which marks it on the `a` element:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aiquants/markdown-explorer",
3
- "version": "0.35.0",
3
+ "version": "0.37.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"
@@ -102,6 +102,7 @@
102
102
  "parse5": "^8.0.0"
103
103
  },
104
104
  "peerDependencies": {
105
+ "@aiquants/auth-core": "^0.8.0",
105
106
  "@aiquants/directory-tree": "^6.1.1",
106
107
  "@aiquants/drag-drop-panels": "^0.14.0",
107
108
  "@aiquants/markdown": "^13.0.0",
@@ -113,12 +114,13 @@
113
114
  "react-router": "^8.0.0"
114
115
  },
115
116
  "devDependencies": {
117
+ "@aiquants/auth-core": "0.8.0",
116
118
  "@aiquants/directory-tree": "6.1.3",
117
119
  "@aiquants/drag-drop-panels": "0.14.1",
118
- "@aiquants/markdown": "13.0.0",
120
+ "@aiquants/markdown": "13.2.0",
119
121
  "@aiquants/resize-panels": "2.3.0",
120
- "@aiquants/spreadsheet": "0.20.0",
121
- "@aiquants/virtualscroll": "3.24.0",
122
+ "@aiquants/spreadsheet": "0.20.1",
123
+ "@aiquants/virtualscroll": "3.26.0",
122
124
  "@heroicons/react": "^2.2.0",
123
125
  "@playwright/test": "^1.64.1",
124
126
  "@tailwindcss/cli": "^4.1.18",
@@ -1,6 +0,0 @@
1
- "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const C=require("react/jsx-runtime"),m=require("react"),S=require("./index-LQWQfpAf.cjs"),Z=require("@aiquants/markdown/code-blocks"),J=require("@codemirror/commands"),we=require("@codemirror/lang-markdown"),ie=require("@codemirror/language"),Ee=require("@codemirror/search"),K=require("@codemirror/state"),_=require("@codemirror/view"),D=require("@lezer/highlight"),Ge=require("@aiquants/markdown"),me=require("@aiquants/markdown/source-lines"),ne=require("./ownUrls-B259RGgd.cjs"),he=require("./sanitizePolicy-CiQfnxyd.cjs"),We=require("isomorphic-dompurify"),X=require("./location-D8DyDkuA.cjs"),Xe=require("./describeValue-Ccvhbt36.cjs"),ce=require("@aiquants/resize-panels"),be=require("./useSplitPersistence-B2Fj508K.cjs"),Pe={history:J.historyField},$e=ie.HighlightStyle.define([{tag:[D.tags.heading1,D.tags.heading2,D.tags.heading3,D.tags.heading4,D.tags.heading5,D.tags.heading6,D.tags.heading],color:"var(--aqmx-syntax-heading)",fontWeight:"700"},{tag:D.tags.strong,fontWeight:"700"},{tag:D.tags.emphasis,fontStyle:"italic"},{tag:D.tags.strikethrough,textDecoration:"line-through"},{tag:D.tags.link,color:"var(--aqmx-syntax-link)",textDecoration:"underline"},{tag:D.tags.url,color:"var(--aqmx-syntax-url)"},{tag:D.tags.monospace,color:"var(--aqmx-syntax-code)"},{tag:D.tags.quote,color:"var(--aqmx-syntax-quote)"},{tag:[D.tags.processingInstruction,D.tags.contentSeparator,D.tags.labelName,D.tags.meta],color:"var(--aqmx-syntax-mark)"}]),Ke=_.EditorView.theme({"&":{height:"100%",color:"var(--aqmx-text)",backgroundColor:"var(--aqmx-surface)",fontSize:"var(--aqmx-font-size-title)"},"&.cm-focused":{outline:"none"},".cm-scroller":{fontFamily:'ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace',lineHeight:"var(--aqmx-line-height-prose)"},".cm-content":{caretColor:"var(--aqmx-text)",paddingBlock:"var(--aqmx-space-6)"},".cm-line":{paddingInline:"var(--aqmx-space-6)"},"&.cm-focused .cm-cursor":{borderLeftColor:"var(--aqmx-text)"},"&.cm-focused > .cm-scroller > .cm-selectionLayer .cm-selectionBackground, .cm-selectionBackground, .cm-content ::selection":{backgroundColor:"var(--aqmx-editor-selection)"},".cm-activeLine":{backgroundColor:"var(--aqmx-editor-active-line)"},".cm-gutters":{backgroundColor:"var(--aqmx-surface-raised)",color:"var(--aqmx-editor-gutter)",borderInlineEnd:"var(--aqmx-space-1) solid var(--aqmx-border)"},".cm-activeLineGutter":{backgroundColor:"var(--aqmx-editor-active-line)"},".cm-searchMatch":{outline:"var(--aqmx-space-1) solid var(--aqmx-border-strong)"},".cm-panels":{backgroundColor:"var(--aqmx-surface-raised)",color:"var(--aqmx-text)"}}),Ne="data-aqmx-conflict-actions",Ye=_.Decoration.line({attributes:{"data-aqmx-conflict-line":"marker"}}),Je=_.Decoration.line({attributes:{"data-aqmx-conflict-line":"ours"}}),Qe=_.Decoration.line({attributes:{"data-aqmx-conflict-line":"theirs"}});class Ze extends _.WidgetType{constructor(t,n){super(),this.index=t,this.labels=n}index;labels;eq(t){return t.index===this.index&&t.labels===this.labels}toDOM(t){const n=document.createElement("div");n.setAttribute(Ne,String(this.index));for(const[o,s]of[["ours",this.labels.useOurs],["theirs",this.labels.useTheirs],["both",this.labels.keepBoth]]){const r=document.createElement("button");r.type="button",r.textContent=s,r.setAttribute("data-aqmx-conflict-choice",o),r.addEventListener("mousedown",l=>l.preventDefault()),r.addEventListener("click",()=>{const l=se(t.state.doc)[this.index];l!==void 0&&(De(t,l,o),t.focus())}),n.append(r)}return n}ignoreEvent(){return!0}}const se=e=>S.findConflictsInLines(e.iterLines()),xe=(e,t)=>{const n=new K.RangeSetBuilder;return se(e).forEach((o,s)=>{const r=e.line(o.start);n.add(r.from,r.from,_.Decoration.widget({widget:new Ze(s,t),block:!0,side:-1}));for(let l=o.start;l<=o.end;l+=1){const i=e.line(l).from,f=l===o.start||l===o.separator||l===o.end?Ye:l<o.separator?Je:Qe;n.add(i,i,f)}}),n.finish()},et=e=>K.StateField.define({create:t=>xe(t.doc,e),update:(t,n)=>n.docChanged?xe(n.state.doc,e):t,provide:t=>_.EditorView.decorations.from(t)}),De=(e,t,n)=>{const{doc:o}=e.state,s=(E,c)=>{const w=[];for(let u=E;u<=c;u+=1)w.push(o.line(u).text);return w},r=s(t.start+1,t.separator-1),l=s(t.separator+1,t.end-1),i=n==="ours"?r:n==="theirs"?l:[...r,...l];let f=o.line(t.start).from,d=o.line(t.end).to;i.length===0&&(t.end<o.lines?d+=1:t.start>1&&(f-=1));const b=i.join(`
2
- `);e.dispatch({changes:{from:f,to:d,insert:b},selection:K.EditorSelection.cursor(f),scrollIntoView:!0,userEvent:"input.resolve"})},Se="input.preview",tt=20,nt=_.ViewPlugin.fromClass(class{constructor(e){this.view=e,this.schedule()}view;cancel=null;update(e){e.docChanged&&this.schedule()}schedule(){if(this.cancel!==null||ie.syntaxTreeAvailable(this.view.state))return;const e=this.view.dom.ownerDocument.defaultView;if(e===null)return;const t=()=>{this.cancel=null,ie.ensureSyntaxTree(this.view.state,this.view.state.doc.length,tt),this.schedule()};if(typeof e.requestIdleCallback=="function"){const n=e.requestIdleCallback(t);this.cancel=()=>e.cancelIdleCallback(n)}else{const n=e.setTimeout(t,0);this.cancel=()=>e.clearTimeout(n)}}destroy(){this.cancel?.(),this.cancel=null}}),rt=/`{3,}|~{3,}/u,re=Object.freeze({kind:"absent"}),de=Object.freeze({kind:"unreadable"}),ot=(e,t,n)=>{const o=[];for(let f=t.parent;f!==null;f=f.parent)(f.name==="Blockquote"||f.name==="ListItem")&&o.unshift(f);const s=[],r=[],l=f=>{const d=r.indexOf(f);return d===-1?r.length:d};for(const f of o){const d=e.lineAt(f.from).number;if(f.name==="ListItem"){const b=Z.listItemWidthOn(e.line(d).text,s,l(d));if(b===null)return null;s.push({kind:"listItem",width:b})}else s.push({kind:"quote"});r.push(d)}const i=Z.openingFenceOn(n.text,s,l(n.number));return i===null?null:{containers:s,...i}},st=(e,t)=>{const{doc:n}=e;let o=n.lineAt(t).to;for(;;){const s=ie.ensureSyntaxTree(e,o,Number.POSITIVE_INFINITY);if(s===null)return null;const r=s.resolveInner(t,1),l=r.parent;if(r.name!=="CodeMark"||l===null||l.name!=="FencedCode"||l.from!==r.from)return null;if(l.to<o||o>=n.length)return l;o=Math.min(n.length,l.to+Math.max(l.to-t,1))}},ye=(e,t)=>{const{doc:n}=e;if(!Number.isInteger(t)||t<1||t>n.lines)return re;const o=n.line(t),s=rt.exec(o.text);if(s===null)return re;const r=st(e,o.from+s.index);if(r===null)return re;const l=r.getChild("CodeInfo");if(l===null)return re;const i=Z.fencedCodeLanguageOf(n.sliceString(l.from,l.to));if(i===null)return de;if(i!==Z.SPREADSHEETS_LANGUAGE)return re;const f=ot(n,r,o);if(f===null)return de;const[,...d]=r.getChildren("CodeMark"),b=d.at(-1),E=b===void 0?n.lineAt(r.to).number:n.lineAt(b.from).number-1,c=[];let w="";for(let u=t+1;u<=E;u+=1){const h=n.line(u).text,g=Z.readFencedLine(h,f);if(g===null)return de;c.push(h),w+=u<n.lines?`${g.content}
3
- `:g.content}return{kind:"found",firstLine:t+1,lines:c,layout:f,body:w}},it=({parent:e,scroll:t,text:n,saved:o,labels:s,revisions:r,onChange:l,onGeometry:i,onSave:f})=>{let d=!1;const b=[_.EditorView.scrollHandler.of((u,h,g)=>(lt(u,h.head,g,t),!0)),_.lineNumbers(),_.highlightActiveLineGutter(),J.history(),_.drawSelection(),_.highlightActiveLine(),Ee.highlightSelectionMatches(),_.EditorView.lineWrapping,we.markdown({base:we.markdownLanguage}),nt,ie.syntaxHighlighting($e),et(s),_.keymap.of([{key:"Mod-s",preventDefault:!0,run:()=>(f(),!0)},...Ee.searchKeymap,...J.historyKeymap,...J.defaultKeymap]),_.EditorView.contentAttributes.of({"aria-label":s.editor,"aria-multiline":"true"}),_.EditorView.updateListener.of(u=>{for(const h of u.transactions)h.docChanged&&r.record(h.changes,h.newDoc);u.docChanged&&l(u.transactions.every(h=>!h.docChanged||h.isUserEvent(Se))),(u.docChanged||u.heightChanged||u.geometryChanged)&&i(u.docChanged&&!d)}),Ke],E=ut(o,b)??K.EditorState.create({doc:n,extensions:b}),c=new _.EditorView({state:E,parent:e});r.mount(c.state.doc);const w=u=>{d=!0;try{u()}finally{d=!1}};return{text:()=>c.state.doc.toString(),replaceText:u=>{const h=c.state.doc.toString();if(h===u)return;let g=0;const y=Math.min(h.length,u.length);for(;g<y&&h.charCodeAt(g)===u.charCodeAt(g);)g+=1;let p=0;for(;p<y-g&&h.charCodeAt(h.length-1-p)===u.charCodeAt(u.length-1-p);)p+=1;c.dispatch({changes:{from:g,to:h.length-p,insert:u.slice(g,u.length-p)},userEvent:"input.replace"})},replaceBody:(u,h,g,y)=>{const{doc:p}=c.state,T=r.lineOf(y,u);if(T===null)return"changed";const O=ye(c.state,T);if(O.kind==="absent")return"changed";if(O.kind==="unreadable")return"unwritable";if(O.body!==Z.fencedBodyAsRead(h,O.layout))return"changed";const L=Z.planFencedBodyEdit(O.lines,O.layout,g);if(L.kind!=="edit")return L.kind;if(L.from===L.to&&L.lines.length===0)return"written";const N=z=>{const H=O.firstLine+z;return H<=p.lines?p.line(H).from:p.length},M=N(L.from),B=`${M===p.length&&p.sliceString(p.length-1)!==`
4
- `?`
5
- `:""}${L.lines.map(z=>`${z}
6
- `).join("")}`;return w(()=>c.dispatch({changes:{from:M,to:N(L.to),insert:B},userEvent:Se,annotations:J.isolateHistory.of("full")})),"written"},readBody:(u,h)=>{const g=r.lineOf(h,u);if(g===null)return null;const y=ye(c.state,g);return y.kind==="found"?y.body:null},undo:()=>w(()=>J.undo(c)),redo:()=>w(()=>J.redo(c)),reveal:({line:u,column:h},g)=>{const{doc:y}=c.state,p=y.line(Math.min(Math.max(u,1),y.lines)),T=Math.min(p.from+h,p.to);c.dispatch({selection:K.EditorSelection.cursor(T),effects:Te(c,T,g,t)})},showLine:u=>{const{doc:h}=c.state,g=h.line(Math.min(Math.max(u,1),h.lines)).from;c.dispatch({effects:Te(c,g,null,t)})},topLine:()=>{const u=t.scrollerOf(c.scrollDOM),h=S.visibleTopOf(u,c.contentDOM),g=S.frameTopOf(u)+u.clientHeight,{documentTop:y}=c,{doc:p}=c.state;let T=c.lineBlockAtHeight(Math.max(h-y,0));for(;p.lineAt(T.from).text.trim()===""&&T.to<p.length;){const N=c.lineBlockAt(T.to+1);if(y+N.top>=g)break;T=N}const O=c.coordsAtPos(T.from),L=O===null?y+T.top:O.top;return{line:c.state.doc.lineAt(T.from).number,clientTop:L,offset:L-h}},lineSpans:u=>{const h=c.scrollDOM,g=h.scrollTop+c.documentTop-S.visibleTopOf(h,c.contentDOM),{doc:y}=c.state,p=T=>y.line(Math.min(Math.max(T,1),y.lines)).from;return u.map(({first:T,last:O})=>({top:g+c.lineBlockAt(p(T)).top,bottom:g+c.lineBlockAt(p(O)).bottom}))},scrollElement:c.scrollDOM,focus:()=>c.focus(),conflicts:()=>se(c.state.doc),resolveAtCursor:u=>{const h=se(c.state.doc),g=c.state.doc.lineAt(c.state.selection.main.head).number,y=h.find(p=>p.end>=g);return y===void 0?!1:(De(c,y,u),!0)},nextConflict:()=>{const u=se(c.state.doc);if(u[0]===void 0)return!1;const g=c.state.doc.lineAt(c.state.selection.main.head).number,y=u.findIndex(L=>L.start>g),p=y<0?0:y,T=c.state.doc.line(u[p].start).from;c.dispatch({selection:K.EditorSelection.cursor(T),effects:_.EditorView.scrollIntoView(T,{y:"center"})});const O=c.contentDOM.querySelector(`[${Ne}="${String(p)}"] button`);return O instanceof HTMLElement?O.focus({preventScroll:!0}):c.focus(),!0},save:()=>c.state.toJSON(Pe),destroy:()=>c.destroy()}},Te=(e,t,n,o)=>{const s=o.scrollerOf(e.scrollDOM),r=(n===null?S.visibleTopOf(s,e.contentDOM):n)-S.frameTopOf(s);return _.EditorView.scrollIntoView(t,{y:"start",yMargin:r})},lt=(e,t,n,o)=>{const s=ct(e,t),r=o.scrollerOf(e.scrollDOM),l=S.frameTopOf(r),i=S.visibleTopOf(r,e.contentDOM),f=l+r.clientHeight;let d=0;switch(n.y){case"start":d=s.top-(l+n.yMargin);break;case"center":d=(s.top+s.bottom)/2-(i+f)/2;break;case"end":d=s.bottom-(f-n.yMargin);break;default:s.top<i+n.yMargin?d=s.top-(i+n.yMargin):s.bottom>f-n.yMargin&&(d=Math.min(s.bottom-(f-n.yMargin),s.top-(i+n.yMargin)))}if(d!==0&&(r.scrollTop+=d),n.y==="start")return;const b=at(e,t);b!==null&&o.reveal(b)},ct=(e,t)=>{const{node:n,offset:o}=e.domAtPos(t);if(n.nodeType===Node.TEXT_NODE){const l=n.ownerDocument?.createRange();if(l!==void 0){l.setStart(n,o),l.setEnd(n,o);const[i]=l.getClientRects();if(i!==void 0&&i.height>0)return{top:i.top,bottom:i.bottom}}}const s=e.lineBlockAt(t),r=e.documentTop+s.top;return{top:r,bottom:r+s.height}},at=(e,t)=>{const{node:n}=e.domAtPos(t);for(let o=n instanceof Element?n:n.parentElement;o!==null;o=o.parentElement)if(o.parentElement===e.contentDOM)return o;return null},ut=(e,t)=>{if(e==null)return null;try{return K.EditorState.fromJSON(e,{extensions:t},Pe)}catch{return null}},dt=610,ft=987,ke=Object.freeze({kind:"unavailable"}),mt="true",ht="false",pt=e=>e===mt?!0:e===ht?!1:null,gt=e=>{const t=new DOMParser().parseFromString(e,"text/html"),n=[];for(const o of t.querySelectorAll("img[data-asset-src], a[data-doc-path]")){const s=o.localName==="img",r=o.getAttribute(s?"data-asset-src":"data-doc-path");r!==null&&n.push({target:{kind:s?"asset":"doc",path:r},exists:pt(o.getAttribute(s?"data-asset-exists":"data-doc-exists"))})}return n},vt=({path:e,instant:t,preview:n,initial:o,onView:s})=>{const r=new AbortController,l={asset:new Map,doc:new Map};let i=o,f=null,d=!1,b=!1,E=null,c=null,w=[],u,h=!1,g,y=null;const p=v=>{v.parsed===i.parsed&&v.source===i.source&&v.failure===i.failure&&v.busy===i.busy&&v.tier===i.tier||(i=v,s(v))},T=(v,x)=>{d||(d=!0,console.error(`[markdown-explorer] ${v}`,...x===void 0?[]:[x]))},O=v=>{if(t!==null)for(const{target:x,exists:q}of t.marksOf(v))l[x.kind].set(x.path,q)},L=()=>{clearTimeout(g),g=void 0,y?.abort(),y=null},N=()=>{c=null,w=[],clearTimeout(u),u=void 0},M=(v,x)=>{p({...i,failure:v,busy:!1,tier:x})},U=()=>{clearTimeout(u),u=w.length===0?void 0:setTimeout(z,ft)},B=()=>{if(t===null||c===null)return;const v=c,x=[],q={asset:new Set,doc:new Set};let G;try{G=t.sanitize(v.html,F=>{const le=l[F.kind].get(F.path);return le===void 0&&!q[F.kind].has(F.path)&&(q[F.kind].add(F.path),x.push(F)),le??void 0})}catch(F){N(),F instanceof he.HtmlNestingLimitError?M(ne.failureOf("too-large"),"instant"):(T("the draft sanitizer failed",F),M(ne.failureOf("failed"),"instant"));return}w=x;const Y=i.parsed!==null&&i.parsed.htmlContent===G&&i.parsed.headings===v.headings?i.parsed:{htmlContent:G,headings:v.headings};p({parsed:Y,source:v.draft,failure:null,busy:!1,tier:"instant"}),U()},z=()=>{if(u=void 0,h||c===null||w.length===0)return;h=!0;const v=w;n(e,c.draft.text,r.signal).then(x=>{if(h=!1,!(r.signal.aborted||!("kind"in x))){x.kind==="preview"&&O(x.htmlContent);for(const q of v)l[q.kind].has(q.path)||l[q.kind].set(q.path,null);B()}})},H=v=>{L(),N(),p({...i,busy:!0,tier:"server"});const x=new AbortController;y=x,g=setTimeout(()=>{g=void 0,n(e,v.text,x.signal).then(q=>{if(!(x.signal.aborted||!("kind"in q))){if(y=null,q.kind==="failure"){M(q.failure,"server");return}O(q.htmlContent),p({parsed:{htmlContent:q.htmlContent,headings:q.headings},source:v,failure:null,busy:!1,tier:"server"})}})},dt)},a=async(v,x)=>{let q;try{q=await v.convert({path:e,text:x},r.signal)}catch(Y){return r.signal.aborted||T("the draft converter rejected a conversion, which its contract allows only once the signal aborted",Y),ke}const G=ne.draftAnswerViolation(q);return G===null?q:(T(`the draft converter answered outside its contract: ${G}`),ke)},I=(v,x)=>{switch(x.kind){case"preview":if(L(),x.headings.length>ne.EXPLORER_MAX_HEADINGS){N(),M(ne.failureOf("too-large"),"instant");return}c={draft:v,html:x.htmlContent,headings:x.headings.map(({text:q,depth:G,id:Y})=>({text:q,depth:G,id:Y}))},B();return;case"failure":L(),N(),M(ne.failureOf(x.failure.reason,x.failure.code),"instant");return;case"unavailable":H(v);return}},A=async v=>{b=!0;try{for(;E!==null&&!r.signal.aborted;){const x=E;E=null;const q=await a(v,x.text);if(r.signal.aborted)return;I(x,q)}}finally{b=!1}};return t!==null&&t.seed!==null&&O(t.seed),{update:v=>{if(!(r.signal.aborted||v.text===f?.text)){if(f=v,clearTimeout(u),u=void 0,t===null){H(v);return}E=v,b||A(t.converter)}},dispose:()=>{r.abort(),E=null,clearTimeout(u),u=void 0,L()}}},wt=e=>he.createHtmlSanitizer(We(window),e.iframeHosts,e.dataPath,he.MAX_HTML_NESTING_DEPTH,X.ownUrlsOf(e)),Et=(e,t)=>e.flatMap((n,o)=>{const s=t[o];return s===void 0?[]:[{editor:s.top,preview:n.top},{editor:s.bottom,preview:n.bottom}]}),Q=(e,t)=>{const n=e[t];if(n===void 0)throw new RangeError(`[markdown-explorer] a scroll map index must be in 0..${String(e.length-1)}; got ${Xe.describeValue(t)}`);return n},bt=e=>{const t=[];for(const o of e){let s=0,r=t.length;for(;s<r;){const l=s+r>>1;Q(t,l).pair.preview<=o.preview?s=l+1:r=l}t[s]={pair:o,before:s===0?void 0:Q(t,s-1)}}const n=[];for(let o=t.at(-1);o!==void 0;o=o.before)n.push(o.pair);return n.reverse()},xt=(e,t)=>{const n=Math.max(t.editorMax,0),o=Math.max(t.previewMax,0),s=n-t.editorViewport,r=o-t.previewViewport,l=e.filter(d=>d.editor>0&&d.editor<s&&d.preview>0&&d.preview<r).sort((d,b)=>d.editor-b.editor||d.preview-b.preview);let i={editor:0,preview:0};const f=[i];for(const d of bt(l))d.editor>i.editor&&d.preview>i.preview&&(f.push(d),i=d);return f.push({editor:n,preview:o}),{toPreview:d=>Le(f,"editor","preview",d),toEditor:d=>Le(f,"preview","editor",d)}},Le=(e,t,n,o)=>{const s=Q(e,0),r=Q(e,e.length-1);if(Number.isNaN(o)||o<=s[t])return s[n];if(o>=r[t])return r[n];let l=0,i=e.length-1;for(;i-l>1;){const b=l+i>>1;Q(e,b)[t]<=o?l=b:i=b}const f=Q(e,l),d=Q(e,i);return f[n]+(d[n]-f[n])*(o-f[t])/(d[t]-f[t])},St=610,Ie=89,Ae=.5,yt=({editor:e,preview:t,previewBlocks:n,editorSpans:o,requestFrame:s,cancelFrame:r,now:l})=>{let i="editor",f=0,d=null,b=null,E=!1,c=null,w=null;const u={editor:0,preview:0},h={editor:null,preview:null};let g=null,y=()=>{};const p=a=>{d!==null&&a!==d||(i=a,f=l()+St)},T=(a,I)=>{a!==i&&d===null&&l()>=f&&!O(a,I)&&(i=a),B()},O=(a,I)=>{const A=h[a];return l()<u[a]||A!==null&&Math.abs(I.position()-A)<Ae},L=e.onScroll(()=>T("editor",e)),N=e.onIntent(()=>p("editor")),M=()=>{const a=t();return a!==g&&(y(),g=a,y=a===null?()=>{}:U(a)),a},U=a=>{const I=a.onScroll(()=>T("preview",a)),A=a.onIntent(()=>p("preview"));return()=>{I(),A()}},B=()=>{!E&&b===null&&(b=s(z))},z=()=>{b=null;const a=M();a!==null&&(c??=n(),w??=xt(Et(c,o(c)),{editorMax:e.max(),previewMax:a.max(),editorViewport:e.viewport(),previewViewport:a.viewport()}),i==="editor"?H(a,"preview",w.toPreview(e.position())):H(e,"editor",w.toEditor(a.position())))},H=(a,I,A)=>{if(Math.abs(a.position()-A)<Ae){h[I]=a.position();return}u[I]=l()+Ie,h[I]=a.scrollTo(A)};return B(),{editorChanged:a=>{w=null,a&&p("editor"),B()},previewChanged:()=>{c=null,w=null,u.preview=l()+Ie,B()},showAlone:a=>{d=a,!(a===null||a===i)&&(i=a,f=0,B())},dispose:()=>{E=!0,b!==null&&r(b),b=null,L(),N(),y()}}},Oe=Object.freeze(["wheel","pointerdown","keydown","focusin"]),Ve=e=>({position:()=>e.scrollTop,max:()=>Math.max(e.scrollHeight-e.clientHeight,0),viewport:()=>e.clientHeight,scrollTo:t=>(e.scrollTo({top:t,behavior:"instant"}),e.scrollTop),onScroll:t=>(e.addEventListener("scroll",t,{passive:!0}),()=>e.removeEventListener("scroll",t)),onIntent:t=>{for(const n of Oe)e.addEventListener(n,t,{capture:!0,passive:!0});return()=>{for(const n of Oe)e.removeEventListener(n,t,{capture:!0})}}}),oe="[data-aqmd-scroll-container]",Tt="[data-aqmd-content]",kt=`[${me.SOURCE_LINES_ATTRIBUTE}]`,Lt=Object.freeze(["p1","p2","p3","p4","p5","p6","p7","p8"]),Be=(e,t)=>{const n=S.loadedOf(e.peek(t));return n!==null&&n.document.kind==="markdown"?{htmlContent:n.document.htmlContent,headings:n.document.headings}:null},It=(e,t,n,o)=>{if(t===void 0)return null;let s;try{s=wt(e)}catch(r){return console.error("[markdown-explorer] the draft sanitizer cannot run in this browser, so the server renders the preview",r),null}return{converter:t,sanitize:s,marksOf:gt,seed:Be(n,o)?.htmlContent??null}},At=e=>{const t=[];let n=null;for(const o of e.querySelectorAll(kt)){const s=me.parseSourceLines(o.getAttribute(me.SOURCE_LINES_ATTRIBUTE));if(s===null||o.getClientRects().length===0)continue;n??=e.scrollTop-S.visibleTopOf(e,o);const{top:r,bottom:l}=o.getBoundingClientRect();t.push({first:s.first,last:s.last,top:n+r,bottom:n+l})}return t},Ot=({path:e,readDraft:t,viewer:n,tables:o,concealed:s,onEditAt:r,onLayout:l,handleRef:i})=>{const{config:f,data:d,documents:b,draftConverter:E,labels:c}=S.useExplorer(),[w,u]=m.useState(()=>({parsed:Be(b,e),source:null,failure:null,busy:!0,tier:E===void 0?"server":"instant"})),h=m.useRef(null),g=m.useRef(null),y=m.useRef(w);m.useLayoutEffect(()=>{y.current=w});const p=m.useEffectEvent(()=>t());m.useEffect(()=>{const a=It(f,E,b,e),I=p(),A=vt({path:e,instant:a,preview:d.preview,initial:y.current,onView:v=>m.startTransition(()=>u(v))});return g.current=A,A.update(I),()=>{A.dispose(),g.current=null}},[f,d,b,E,e]);const T=m.useEffectEvent(()=>l());m.useLayoutEffect(()=>{w.parsed!==null&&T()},[w.parsed]);const O=w.parsed!==null;m.useLayoutEffect(()=>{const a=O?h.current?.querySelector(oe):null;if(!(a instanceof HTMLElement))return;a.tabIndex=0;const I=new ResizeObserver(()=>T());I.observe(a);const A=a.querySelector(Tt);return A!==null&&I.observe(A),()=>I.disconnect()},[O]);const L=m.useRef(null);m.useImperativeHandle(i,()=>({draft:a=>{g.current?.update(a)},scrollPort:()=>{const a=h.current?.querySelector(oe);return a instanceof HTMLElement?(L.current?.scroller!==a&&(L.current={scroller:a,port:Ve(a)}),L.current.port):null},blocks:()=>{const a=h.current?.querySelector(oe);return a instanceof HTMLElement?At(a):[]},focus:()=>{const a=h.current?.querySelector(oe);a instanceof HTMLElement&&a.focus({preventScroll:!0})},anchor:a=>{const I=h.current,A=I?.querySelector(oe);return I===null||!(A instanceof HTMLElement)?null:S.anchorOfView(I,a(A))},place:({line:a,clientTop:I},A)=>{const v=h.current,x=v===null?null:S.blockAtLine(v,a);x!==null&&(A(x).scrollTop+=S.lineTopIn(x,a)-I)}}),[]);const N=a=>{const I=h.current,{target:A}=a;if(r===void 0||I===null||!(A instanceof Element)||!S.isEditingDoubleClick(A))return;const v=S.anchorOfDoubleClick(A,I,I.ownerDocument.getSelection());v!==null&&r(v)},M=w.source===null?null:w.source.revision,U=m.useMemo(()=>M===null?void 0:{write:a=>o.write(M,a),read:a=>o.read(M,a),undo:o.undo,redo:o.redo,subscribe:o.subscribe},[o,M]),B=m.useMemo(()=>({...n.labels,spreadsheetReadOnly:c.previewTablePending}),[n.labels,c.previewTablePending]),z=m.useMemo(()=>({...n,labels:U===void 0?B:n.labels,showToc:!1,showStyle:!1,showAlign:!1,showMeasure:!1,showContentColors:!1,renderScrollBar:void 0,scrollBarGutter:void 0,scrollBarInlineSize:void 0,spreadsheetEditor:U}),[n,B,U]),H=m.useMemo(()=>w.parsed===null?null:C.jsx("div",{className:"aqmx-document-viewer",children:C.jsx(Ge.MarkdownViewer,{...z,parseResult:w.parsed,content:null})}),[z,w.parsed]);return C.jsxs("section",{ref:h,className:"aqmx-edit-preview","aria-label":c.previewRegion,"aria-busy":w.busy,inert:s!==null,hidden:s==="removed","data-aqmx-preview-tier":w.tier,"data-testid":"markdown-explorer-edit-preview",onDoubleClick:r===void 0?void 0:N,children:[w.failure===null?null:C.jsx("p",{className:"aqmx-callout aqmx-document-notice","data-aqmx-tone":"warning","data-testid":"markdown-explorer-edit-preview-failure",children:c.previewFailed(S.failureTitleOf(c,w.failure.reason))}),H??(w.failure===null?C.jsx("div",{className:"aqmx-skeleton","aria-hidden":"true","data-testid":"markdown-explorer-edit-preview-skeleton",children:Lt.map(a=>C.jsx("span",{},a))}):null),w.busy?C.jsx("p",{className:"aqmx-sr-only",children:c.previewUpdating}):null]})},Re="data-aqmx-edit-split",fe="--aqmx-edit-share",qe="--aqmx-edit-gutter",Rt="data-aqmx-edit-split-probe",qt="aqmx-edit-split",Ct="aqmx-edit-editor",Mt="aqmx-edit-preview",Ce={value:X.EDIT_SPLIT_MIN_PERCENT,unit:"percentage"},Me={value:X.EDIT_SPLIT_MAX_PERCENT,unit:"percentage"},_e=e=>{if(e.length!==2)return null;const[t=0,n=0]=e,o=t+n;return o>0?t/o*100:null},ae=e=>{const t=e.current?.parentElement;if(t==null)throw new Error("[markdown-explorer] the edit split is not mounted in its surface");return t},_t=(e,t,n)=>{const[o,s]=m.useState(null);return m.useLayoutEffect(()=>{const r=e.current,l=t.current;if(r===null||l===null)throw new Error("[markdown-explorer] the edit split is not mounted");const i={frame:r.getBoundingClientRect().width,measure:l.getBoundingClientRect().width},f=()=>{i.frame>0&&i.measure>0&&s(X.editSplitOrientation(i.frame,i.measure,n))};f();const d=new ResizeObserver(b=>{for(const E of b){const[c]=E.borderBoxSize;c!==void 0&&(E.target===r&&(i.frame=c.inlineSize),E.target===l&&(i.measure=c.inlineSize))}f()});return d.observe(r),d.observe(l),()=>d.disconnect()},[e,t,n]),o},Pt=({editorId:e})=>{const{edits:t,labels:n}=S.useExplorer(),o=m.useMemo(()=>be.toPanelGroupLabels(n),[n]),s=m.useRef(null),r=m.useRef(null),l=S.useCoarsePointer()?X.COARSE_TARGET_PIXELS:X.FINE_TARGET_PIXELS,i=_t(s,r,l),[f]=m.useState(()=>t.editorShare());m.useLayoutEffect(()=>{const E=ae(s);return E.style.setProperty(qe,`${String(l)}px`),()=>{E.style.removeProperty(qe)}},[l]),m.useLayoutEffect(()=>{const E=ae(s);return E.style.setProperty(fe,`${String(f)}%`),()=>{E.style.removeProperty(fe)}},[f]),m.useLayoutEffect(()=>{if(i===null)return;const E=ae(s);return E.setAttribute(Re,i),()=>E.removeAttribute(Re)},[i]);const d=be.useSplitPersistence(m.useCallback(E=>{const c=_e(E);c!==null&&t.setEditorShare(c)},[t])),b=m.useCallback((E,c)=>{const w=_e(E);w!==null&&ae(s).style.setProperty(fe,`${String(w)}%`),d.layoutChanged(E,c)},[d]);return C.jsxs("div",{ref:s,className:"aqmx-edit-split","data-testid":"markdown-explorer-edit-split",children:[C.jsx("span",{ref:r,className:"aqmx-edit-split-probe","aria-hidden":"true",[Rt]:""}),i===null?null:C.jsxs(ce.PanelGroup,{id:qt,direction:i==="beside"?"horizontal":"vertical",onLayout:b,labels:o,className:"aqmx-edit-split-group",children:[C.jsx(ce.Panel,{id:Ct,defaultSize:{value:f,unit:"percentage"},minSize:Ce,maxSize:Me,contentOverflow:"hidden"}),C.jsx(ce.PanelResizeHandle,{thickness:l,indicator:{visible:!0,thickness:X.SPLIT_HANDLE_PIXELS.gripThickness,length:X.SPLIT_HANDLE_PIXELS.gripLength,barThickness:X.SPLIT_HANDLE_PIXELS.barThickness,barLength:X.SPLIT_HANDLE_PIXELS.barLength},title:n.editViewSplitResize,"aria-label":n.editViewSplitResize,"aria-controls":e,onDragging:d.draggingChanged,className:"aqmx-split-handle aqmx-edit-split-handle"}),C.jsx(ce.Panel,{id:Mt,defaultSize:{value:100-f,unit:"percentage"},minSize:Ce,maxSize:Me,contentOverflow:"hidden"})]})]})},Nt=512,Dt=()=>{const e=[];let t=0,n=null;const o=s=>{if(n===null||!Number.isInteger(s)||s<t)return null;if(s===t+e.length)return n;const r=e[s-t];return r===void 0?null:r.before};return{revision:()=>t+e.length,mount:s=>{if(n!==null&&(n===s||n.eq(s))){n=s;return}const r=t+e.length;e.length=0,t=n===null?r:r+1,n=s},record:(s,r)=>{if(n===null)throw new Error("[markdown-explorer] a change of the editor's text was recorded before an editor mounted");e.push({before:n,changes:s}),n=r,e.length>Nt&&(e.shift(),t+=1)},lineOf:(s,r)=>{const l=o(s);if(l===null||n===null||!Number.isInteger(r)||r<1||r>l.lines)return null;let i=l.line(r).from;for(const f of e.slice(s-t)){const d=f.changes.mapPos(i,1,K.MapMode.TrackAfter);if(d===null)return null;i=d}return n.lineAt(i).number}}},He=144,Vt=e=>{if(typeof e!="object"||e===null)return!1;const{generation:t,topLine:n}=e;return"state"in e&&typeof t=="number"&&typeof n=="number"},Bt=e=>{e.stopPropagation()},Ht=e=>{const{path:t,name:n,session:o}=e,{edits:s,labels:r,announcer:l}=S.useExplorer(),{phase:i}=o,f=m.useCallback(()=>s.retry(t),[s,t]);switch(m.useEffect(()=>{i.kind==="failed"&&l.announce(r.documentFailed(n,S.failureTitleOf(r,i.failure.reason)))},[i,l,r,n]),i.kind){case"opening":return C.jsx(S.ContentSkeleton,{label:r.editLoading,testId:"markdown-explorer-edit-skeleton"});case"grant":return C.jsx("div",{className:"aqmx-edit-message",children:C.jsx(S.EditGrantNotice,{href:i.href,onRetry:f,testId:"markdown-explorer-edit-grant"})});case"failed":return C.jsx("div",{className:"aqmx-edit-message",children:C.jsx(S.FailureView,{failure:i.failure,alert:!1,onRetry:f,testId:"markdown-explorer-edit-failure"})});case"editing":return C.jsx(jt,{...e})}},jt=({path:e,name:t,session:n,layout:o,viewer:s,region:r,paneScroll:l})=>{const{edits:i,labels:f}=S.useExplorer(),d=m.useRef(null),b=m.useId(),E=m.useRef(null),[c]=m.useState(()=>new Set),[w]=m.useState(Dt),u=m.useRef(null),h=m.useRef(null),g=o==="fill",y=S.useSideBySide(),p=S.editViewOf(n,y,g),T=p!=="editor"||n.previewPrepared,O=T&&g,L=m.useRef({layout:o,region:r,paneScroll:l});m.useLayoutEffect(()=>{L.current={layout:o,region:r,paneScroll:l}});const N=m.useRef(n.generation);m.useLayoutEffect(()=>{N.current=n.generation});const M=m.useRef({view:p,previewMounted:T});m.useLayoutEffect(()=>{M.current={view:p,previewMounted:T}});const{requestSave:U,confirmation:B}=S.useSaveRequest(e),z=m.useRef(U);m.useLayoutEffect(()=>{z.current=U});const H=m.useRef(null),a=m.useRef(null),I=m.useRef(!1),A=m.useMemo(()=>({editor:f.editorLabel(t),useOurs:f.conflictUseOurs,useTheirs:f.conflictUseTheirs,keepBoth:f.conflictKeepBoth}),[f,t]),v=m.useCallback(k=>{const{region:R,paneScroll:V}=L.current,j=R();return j===null?k:V.scrollerOf(j,k)},[]);m.useLayoutEffect(()=>{const k=d.current,R=i.draft(e);if(k===null||R===null)return;const V=i.editorState.get(e),j=Vt(V)&&V.generation===N.current?V:null;let $=null,ee=null;const ue=()=>{$!==null&&clearTimeout($),$=null,ee!==null&&i.setDraft(e,ee.text())},W=it({parent:k,scroll:{scrollerOf:P=>{const{layout:te,region:Fe,paneScroll:Ue}=L.current,ve=Fe();return te==="fill"||ve===null?P:Ue.scrollerOf(ve,P)},reveal:P=>L.current.paneScroll.reveal(P)},text:R,saved:j===null?void 0:j.state,labels:A,revisions:w,onGeometry:P=>h.current?.editorChanged(P),onChange:P=>{if($??=setTimeout(ue,He),!P)for(const te of[...c])te();M.current.previewMounted&&ee!==null&&u.current?.draft({text:ee.text(),revision:w.revision()})},onSave:()=>z.current()});ee=W,E.current=W;const pe=()=>{const P=W.topLine();return{line:P.line,clientTop:P.clientTop}},ge=()=>u.current?.anchor(v)??null,ze=i.bindEditor(e,{flush:ue,adopt:P=>W.replaceText(P),returnPoint:()=>{const P=M.current.view==="preview"&&L.current.layout==="content"?ge():null;return P===null?pe():{line:P.lines.first,clientTop:P.clientTop}},nextConflict:()=>M.current.view!=="preview"?W.nextConflict():W.conflicts().length===0?!1:(I.current=!0,i.setView(e,"editor"),!0),beforeView:P=>{if(L.current.layout==="fill")return;if(P==="preview"){H.current={to:"preview",point:pe()};return}const te=ge();H.current=te===null?null:{to:"editor",anchor:te}}});return j!==null&&W.showLine(j.topLine),()=>{ue(),i.editorState.set(e,{state:W.save(),generation:N.current,topLine:W.topLine().line}),ze(),W.destroy(),ee=null,E.current=null}},[i,e,A,v,c,w]);const{request:x}=n;m.useLayoutEffect(()=>{const k=E.current,R=i.draft(e);k===null||R===null||x===null||(x.anchor!==null&&k.reveal(S.positionInSource(R,x.anchor),x.anchor.clientTop),k.focus(),i.consumeRequest(e))},[i,e,x,A]),m.useLayoutEffect(()=>{p!=="editor"&&!n.previewPrepared&&i.preparePreview(e)},[i,e,p,n.previewPrepared]),m.useLayoutEffect(()=>{const k=H.current,R=a.current,V=I.current;H.current=null,a.current=null,I.current=!1;const j=E.current;if(k?.to==="preview")u.current?.place(k.point,v);else if(k?.to==="editor"&&j!==null){const $=i.draft(e);$!==null&&j.reveal(S.positionInSource($,k.anchor),k.anchor.clientTop)}V?j?.nextConflict():R==="editor"?j?.focus():R==="preview"&&u.current?.focus()},[i,e,p,v]);const q=m.useMemo(()=>{const k=()=>{const R=E.current;if(R===null)throw new Error("[markdown-explorer] a table of the preview wrote back while no editor was mounted");return R};return{write:(R,{fenceLine:V,expected:j,text:$})=>k().replaceBody(V,j,$,R),read:(R,V)=>k().readBody(V,R),undo:()=>k().undo(),redo:()=>k().redo(),subscribe:R=>(c.add(R),()=>{c.delete(R)})}},[c]),G=m.useCallback(()=>{const k=E.current;if(k===null)throw new Error("[markdown-explorer] the preview read the draft before the editor was mounted");return{text:k.text(),revision:w.revision()}},[w]);m.useLayoutEffect(()=>{const k=E.current;if(!O||k===null)return;const R=yt({editor:Ve(k.scrollElement),preview:()=>u.current?.scrollPort()??null,previewBlocks:()=>u.current?.blocks()??[],editorSpans:V=>k.lineSpans(V),requestFrame:V=>requestAnimationFrame(V),cancelFrame:V=>cancelAnimationFrame(V),now:()=>performance.now()});return R.showAlone(S.paneShownAlone(M.current.view)),h.current=R,()=>{R.dispose(),h.current=null}},[O,i,e,A]),m.useLayoutEffect(()=>{h.current?.showAlone(S.paneShownAlone(p))},[p]);const Y=m.useCallback(()=>h.current?.previewChanged(),[]),F=m.useCallback(k=>i.start(e,k),[i,e]),le=k=>{if(S.isInFullscreenBlock(k.target))return;if(k.key==="Escape"){S.consumeKey(k);return}if(!S.isEditViewShortcut(k.nativeEvent,S.isApplePlatform(navigator.platform)))return;S.consumeKey(k);const R=S.toggledEditView(p);a.current=R,S.chooseEditView(i,e,R,g)},je=C.jsxs("div",{className:"aqmx-edit","data-aqmx-edit-layout":o,"data-aqmx-edit-view":p,"data-testid":"markdown-explorer-edit",onKeyDown:le,onDoubleClick:Bt,children:[C.jsx("div",{ref:d,id:b,className:"aqmx-edit-editor","data-testid":"markdown-explorer-editor",inert:p==="preview",hidden:p==="preview"&&!g,...S.ALLOW_KEY_REPEAT}),p==="split"?C.jsx(Pt,{editorId:b}):null,T?C.jsx(Ot,{path:e,readDraft:G,viewer:s,tables:q,concealed:p!=="editor"?null:g?"overlay":"removed",onEditAt:p==="preview"?F:void 0,onLayout:Y,handleRef:u}):null]});return C.jsxs(C.Fragment,{children:[je,B]})};exports.DRAFT_WRITE_INTERVAL_MS=He;exports.default=Ht;