supamde 0.1.0 → 0.2.0

package/README.md

@@ -196,20 +196,21 @@ bottom:
 
 ## Options (core)
 
-| Option         | Type                   | Default          | Meaning                                                        |
-| -------------- | ---------------------- | ---------------- | -------------------------------------------------------------- |
-| `element`      | `HTMLTextAreaElement`  | —                | **Required.** The textarea to replace.                         |
-| `lineWrapping` | `boolean`              | `true`           | Wrap lines instead of scrolling horizontally.                  |
-| `placeholder`  | `string`               | —                | Placeholder text in the empty editor.                          |
-| `autofocus`    | `boolean`              | `false`          | Focuses the editor after creation.                             |
-| `tabSize`      | `number`               | `2`              | Tab width in columns.                                          |
-| `indentUnit`   | `number`               | `2`              | Indentation depth in spaces.                                   |
-| `initialValue` | `string`               | textarea content | Initial value (overrides the textarea).                        |
-| `extraKeys`    | `KeyBinding[]`         | `[]`             | Custom CM6 key bindings; take precedence over defaults.        |
-| `autosave`     | `AutosaveOptions`      | —                | Autosave, see [Autosave](#autosave).                           |
-| `uploadImage`  | `UploadImageOptions`   | —                | Image upload, see [Image upload](#image-upload).               |
-| `locale`       | `Locale`               | `en`             | UI language, see [Localization](#localization).                |
-| `texts`        | `Partial<LocaleTexts>` | —                | Overrides individual UI texts; takes precedence over `locale`. |
+| Option           | Type                   | Default          | Meaning                                                                      |
+| ---------------- | ---------------------- | ---------------- | ---------------------------------------------------------------------------- |
+| `element`        | `HTMLTextAreaElement`  | —                | **Required.** The textarea to replace.                                       |
+| `lineWrapping`   | `boolean`              | `true`           | Wrap lines instead of scrolling horizontally.                                |
+| `placeholder`    | `string`               | —                | Placeholder text in the empty editor.                                        |
+| `autofocus`      | `boolean`              | `false`          | Focuses the editor after creation.                                           |
+| `tabSize`        | `number`               | `2`              | Tab width in columns.                                                        |
+| `indentUnit`     | `number`               | `2`              | Indentation depth in spaces.                                                 |
+| `codeIndentUnit` | `number \| 'tab'`      | `indentUnit`     | Indentation inside code blocks: spaces, or `'tab'` for a real tab character. |
+| `initialValue`   | `string`               | textarea content | Initial value (overrides the textarea).                                      |
+| `extraKeys`      | `KeyBinding[]`         | `[]`             | Custom CM6 key bindings; take precedence over defaults.                      |
+| `autosave`       | `AutosaveOptions`      | —                | Autosave, see [Autosave](#autosave).                                         |
+| `uploadImage`    | `UploadImageOptions`   | —                | Image upload, see [Image upload](#image-upload).                             |
+| `locale`         | `Locale`               | `en`             | UI language, see [Localization](#localization).                              |
+| `texts`          | `Partial<LocaleTexts>` | —                | Overrides individual UI texts; takes precedence over `locale`.               |
 
 ## Toolbar & status bar
 
@@ -1118,7 +1119,9 @@ clicking in the toolbar.
 `Tab` indents the current line by one `indentUnit`, `Shift-Tab` outdents it —
 regardless of where the cursor is in the line. With a selection, this applies
 to all touched lines. This is how lists are nested: `- item` becomes
-`  - item`.
+`  - item`. Inside code blocks, `codeIndentUnit` is used instead (with `'tab'`, a
+real tab character is inserted); fence lines count as normal text. In a code block
+inside a blockquote, the indentation goes after the `>` so the quote stays intact.
 
 > **Note (accessibility):** `Tab` is always captured by the editor and does not
 > leave it. To leave the editor via keyboard, you currently have to use other
@@ -1223,4 +1226,4 @@ npx playwright install chromium
 
 ## License
 
-MIT © Sven Deginther
+MIT © svenho

package/dist/commands/code-indent.d.ts

@@ -0,0 +1,38 @@
+import { Facet, type EditorState, type Line } from '@codemirror/state';
+import type { Tree } from '@lezer/common';
+/**
+ * Einfüge-String für `Tab` in Code-Zeilen (`'\t'` oder Leerzeichen), gesetzt aus
+ * der Option `codeIndentUnit`. `null` = nicht gesetzt — dann gilt in Code-Zeilen
+ * dieselbe Einheit wie im Text (`indentUnit`).
+ */
+export declare const codeIndent: Facet<string, string | null>;
+/**
+ * Liegt die Zeile im Inhalt eines Code-Blocks? Zählt: jede Zeile eines
+ * eingerückten `CodeBlock` und die Inhaltszeilen eines `FencedCode`. Die Zaunzeilen
+ * selbst zählen als Text; ein ungeschlossener Fenced Block reicht bis Dokumentende.
+ *
+ * `tree` sollte bis `line.to` geparst sein (siehe `codeTreeUpTo`); ohne Angabe
+ * wird der aktuelle, ggf. unvollständige Baum genommen.
+ */
+export declare function isCodeLine(state: EditorState, line: Line, tree?: Tree): boolean;
+/**
+ * Syntaxbaum, der bis `upTo` geparst ist. Eine große Auswahl (z. B. Alles markieren)
+ * reicht über den Viewport hinaus, wo der Hintergrund-Parser noch nicht war —
+ * dort würden Code-Zeilen sonst als Text gelten. Gelingt das Nachparsen nicht
+ * innerhalb des Zeitbudgets, bleibt der vorhandene Baum (bestmöglich).
+ */
+export declare function codeTreeUpTo(state: EditorState, upTo: number): Tree;
+/** Wo in einer Code-Zeile die Einrückung beginnt (siehe `codeIndentAnchor`). */
+export interface CodeIndentAnchor {
+    /** Doc-Offset, an dem eingefügt bzw. ausgerückt wird. */
+    at: number;
+    /** Fehlt hinter dem Zitatzeichen das Leerzeichen, das es „schluckt"? */
+    missingSpace: boolean;
+}
+/**
+ * Einrück-Position einer Code-Zeile. Ohne Zitat ist das der Zeilenanfang. In einem
+ * Zitat liegt sie hinter dem letzten `QuoteMark` der Zeile und einem direkt folgenden
+ * Leerzeichen — am Zeilenanfang würde das `>` ab 4 Spalten Einrückung kein
+ * Zitatzeichen mehr sein und Standard-Renderer beendeten Zitat und Code-Block.
+ */
+export declare function codeIndentAnchor(state: EditorState, line: Line, tree: Tree): CodeIndentAnchor;

package/dist/commands/indent.d.ts

@@ -7,6 +7,11 @@ import type { SupaCommand } from './types';
  *
  * In Markdown ergibt sich die Listen-Verschachtelung genau aus dieser
  * Leerzeichen-Einrückung, deshalb braucht es keinen Listen-Sonderfall.
+ *
+ * Zeilen im Inhalt eines Code-Blocks nutzen stattdessen die Einheit aus dem
+ * `codeIndent`-Facet (Option `codeIndentUnit`, ggf. ein Tab-Zeichen) — pro Zeile
+ * entschieden, damit eine gemischte Auswahl jede Zeile passend einrückt. In
+ * Zitaten wird bei Code-Zeilen hinter dem Zitatzeichen eingefügt (`codeIndentAnchor`).
  */
 export declare const indentLines: SupaCommand;
 /**
@@ -14,5 +19,10 @@ export declare const indentLines: SupaCommand;
  * aus. Zeilen ohne führenden Whitespace bleiben unverändert — der Command gibt
  * dennoch `true` zurück, damit `Shift-Tab` die Taste konsumiert und den Fokus
  * nicht aus dem Editor bewegt.
+ *
+ * In Code-Zeilen gilt die Code-Einheit: bei Leerzeichen deren Anzahl, bei einem
+ * Tab-Zeichen bis zu `tabSize` Leerzeichen (ein führendes Tab entfernt
+ * `dedentWidth` ohnehin als Ganzes). In Zitaten wird hinter dem Zitatzeichen
+ * ausgerückt.
  */
 export declare const dedentLines: SupaCommand;

package/dist/options.d.ts

@@ -19,6 +19,8 @@ export interface SupaMDEOptions {
     tabSize?: number;
     /** Einrücktiefe in Leerzeichen (Default: 2). */
     indentUnit?: number;
+    /** Einrücktiefe in Code-Blöcken: Leerzeichen-Anzahl oder 'tab' (Default: indentUnit). */
+    codeIndentUnit?: number | 'tab';
     /** Startwert; überschreibt den Textarea-Inhalt, falls gesetzt. */
     initialValue?: string;
     /** Eigene Tastenkürzel; haben Vorrang vor den SupaMDE-Defaults bei Konflikten. */
@@ -73,6 +75,7 @@ export interface ResolvedOptions {
     autofocus: boolean;
     tabSize: number;
     indentUnit: number;
+    codeIndentUnit: number | 'tab';
     extraKeys: KeyBinding[];
     editorMode: EditorMode;
 }