@quillmark/svelte 0.23.0 → 0.25.0

package/dist/core/codec/lists.d.ts

@@ -7,21 +7,28 @@ import type { Command } from 'prosemirror-state';
  * `Tab` / `Shift-Tab` hold the list link of the body's Tab chain. Surfaces that own
  * Tab more locally under the same rule (`prose/canon/VISUAL_EDITOR.md` §Chrome)
  * prepend a link ahead of these in `keymap.ts`: a `code_block` takes literal
- * indentation (`code.ts`), an island takes cell traversal once added. Outside all
- * of them every link returns false and the key is not swallowed: Tab keeps its
- * default meaning, which is the body's only keyboard exit and the open seam for a
- * shell structural keymap (VISUAL_EDITOR §Settled and open).
+ * indentation (`code.ts`). Where every link declines, the body holds the key
+ * (`keymap.ts`).
  *
- * `Enter` is a chain in precedence order: the escape-above gesture, then
- * `splitListItem` (`splitTaskItem`, which leaves a task item's new half an open task),
- * then `liftListItem`. The middle link carries two behaviors of
- * its own: it splits a non-empty item, and on an empty item it either splits the
- * wrapping item (a nested empty item, so Enter lifts exactly one level) or bails
- * so the third link lifts a top-level empty item out to a paragraph. `Backspace` lifts
- * an item at its start, and joins a block onto the list it stands after. `Delete` is
- * that same chain at the seam below rather than a second table of cases beside it, so
- * the two keys cannot come to differ over a seam this link reaches. An empty line is
- * not one: the block link takes it ahead of this chain (`blocks.ts`), the caret's own
- * line being a nearer fact than the boundary under it.
+ * `Mod-Shift-7` / `Mod-Shift-8` are the list toggle (`list-toggle.ts`), numbering or
+ * bulleting the selection's lines or taking their markers off.
+ *
+ * `Tab` sinks an unnumbered line alone into a sub-list, any other line its whole item,
+ * and a block right after a list into the list's last item.
+ *
+ * `Enter` is a chain in precedence order: the empty line above an unnumbered one, the
+ * marker off an empty middle item and back on an empty continuation line, then `splitListItem`
+ * (`splitTaskItem`, which leaves a task item's new half an open task), then
+ * `liftListItem`. The split link carries two behaviors of its own: it splits a
+ * non-empty item, and on an empty last item it either splits the wrapping item (a
+ * nested one, so Enter lifts exactly one level) or bails so the last link lifts a
+ * top-level one out to a paragraph. `Backspace` takes an item's marker off at its
+ * start, a top-level continuation line out to full width, and joins a block onto the
+ * list it stands after, and both keys over a selection spanning blocks join the lists
+ * the delete leaves touching. `Delete` is the marker off at the seam below with the two lines
+ * joined, never the line out: a forward delete edits the line after the caret, not its
+ * indent. An empty line is neither key's here:
+ * the block link takes it ahead of this chain (`blocks.ts`), the caret's own line
+ * being a nearer fact than the boundary under it.
  */
 export declare function listKeymap(schema: Schema): Record<string, Command>;