suneditor 3.2.1 → 3.2.3

package/types/helper/env.d.ts

@@ -19,6 +19,15 @@ export function getPageStyle(doc: Document | null): string;
  * @returns {string} If not found, return the first found value.
  */
 export function getIncludePath(nameArray: Array<string>, extension: string): string;
+/**
+ * @description Runtime probe: does this environment actually deliver input events for edits?
+ * Some managed/corporate environments (keyboard-hooking security SW, DLP, VDI) silently drop `beforeinput`
+ * **and** `input` at runtime even though the browser statically supports them — static feature-detection
+ * (`window.InputEvent`) cannot see that. This synthetically triggers an edit (`execCommand('insertText')`)
+ * on an offscreen contenteditable and observes whether an input-family event fires **synchronously**.
+ * @returns {boolean} `true` if an input-family event fired (environment delivers edits), else `false`.
+ */
+export function canUseBeforeInput(): boolean;
 /** @type {SunEditor.GlobalWindow} */
 export const _w: SunEditor.GlobalWindow;
 /** @type {Document} */
@@ -127,6 +136,7 @@ declare namespace env {
 	export { isAndroid };
 	export { isMobile };
 	export { isTouchDevice };
+	export { canUseBeforeInput };
 	export { cmdIcon };
 	export { shiftIcon };
 	export { DPI };

package/types/helper/index.d.ts

@@ -18,6 +18,7 @@ export const env: {
 	isAndroid: boolean;
 	isMobile: boolean;
 	isTouchDevice: boolean;
+	canUseBeforeInput: typeof import('./env').canUseBeforeInput;
 	cmdIcon: string;
 	shiftIcon: string;
 	DPI: number;

package/types/plugins/field/slashCommand.d.ts

@@ -75,7 +75,23 @@ export type SlashCommandPluginOptions = {
 	 * title: 'Heading 1',
 	 * icon: 'h1',
 	 * keywords: ['header', 'title'],
-	 * action: ($) => $.format.applyBlock(document.createElement('H1')),
+	 * // A line-level tag (H1-H6, P): `setLine` CHANGES the current line's tag → `<h1>…</h1>`.
+	 * // Do NOT use `applyBlock` here — it WRAPS (`<h1><p>…</p></h1>`) and traps Enter inside.
+	 * action: ($) => $.format.setLine(document.createElement('H1')),
+	 * },
+	 * {
+	 * key: 'code',
+	 * title: 'Code block',
+	 * keywords: ['pre'],
+	 * // A br-line block (PRE): `setBrLine` converts the line to a `<br>`-separated code block.
+	 * action: ($) => $.format.setBrLine(document.createElement('PRE')),
+	 * },
+	 * {
+	 * key: 'quote',
+	 * title: 'Quote',
+	 * keywords: ['blockquote'],
+	 * // A container block (BLOCKQUOTE, DIV…): `applyBlock` WRAPS the selected lines → `<blockquote>…</blockquote>`.
+	 * action: ($) => $.format.applyBlock(document.createElement('BLOCKQUOTE')),
 	 * },
 	 * 'bold',
 	 * 'image',
@@ -130,7 +146,23 @@ export type SlashCommandPluginOptions = {
  *         title: 'Heading 1',
  *         icon: 'h1',
  *         keywords: ['header', 'title'],
- *         action: ($) => $.format.applyBlock(document.createElement('H1')),
+ *         // A line-level tag (H1-H6, P): `setLine` CHANGES the current line's tag → `<h1>…</h1>`.
+ *         // Do NOT use `applyBlock` here — it WRAPS (`<h1><p>…</p></h1>`) and traps Enter inside.
+ *         action: ($) => $.format.setLine(document.createElement('H1')),
+ *       },
+ *       {
+ *         key: 'code',
+ *         title: 'Code block',
+ *         keywords: ['pre'],
+ *         // A br-line block (PRE): `setBrLine` converts the line to a `<br>`-separated code block.
+ *         action: ($) => $.format.setBrLine(document.createElement('PRE')),
+ *       },
+ *       {
+ *         key: 'quote',
+ *         title: 'Quote',
+ *         keywords: ['blockquote'],
+ *         // A container block (BLOCKQUOTE, DIV…): `applyBlock` WRAPS the selected lines → `<blockquote>…</blockquote>`.
+ *         action: ($) => $.format.applyBlock(document.createElement('BLOCKQUOTE')),
  *       },
  *       'bold',
  *       'image',