luxen-ui 0.6.2 → 0.7.0

package/cdn/elements/prose-editor/prose-editor.d.ts

@@ -0,0 +1,110 @@
+import { PropertyValues, TemplateResult } from 'lit';
+import { Editor, JSONContent } from '@tiptap/core';
+import { LuxenFormAssociatedElement } from '../../shared/luxen-form-associated-element.js';
+type ToolbarCommandName = 'heading-1' | 'heading-2' | 'heading-3' | 'bold' | 'italic' | 'underline' | 'strike' | 'highlight' | 'bulletlist' | 'orderedlist' | 'blockquote' | 'code-block' | 'horizontal-rule' | 'link' | 'emoji' | 'attachment' | 'undo' | 'redo' | 'divider';
+/**
+ * @summary A rich text editor built on Tiptap (ProseMirror). Form-associated: its value is the editor HTML.
+ * @customElement l-prose-editor
+ *
+ * @slot toolbar-start - Content placed before the generated toolbar buttons.
+ * @slot toolbar-end - Content placed after the generated toolbar buttons.
+ *
+ * @event change - Fired when the content changes. `detail` is `{ html, json }`.
+ * @event add-file - Fired when the attachment toolbar button is clicked.
+ *
+ * @csspart wrapper - The editor frame wrapping the toolbar and content.
+ * @csspart toolbar - The toolbar row.
+ * @csspart toolbar-button - Any toolbar button.
+ * @csspart divider - A toolbar divider.
+ * @csspart editor - The container around the editable content.
+ *
+ * @cssproperty --border-color - Color of the editor frame border.
+ * @cssproperty --border-width - Width of the editor frame border.
+ * @cssproperty --border-radius - Corner radius of the editor frame.
+ * @cssproperty --background - Background color of the editor.
+ * @cssproperty --color - Text color of the editor.
+ * @cssproperty --toolbar-background - Background color of the toolbar.
+ * @cssproperty --toolbar-padding - Padding around the toolbar.
+ * @cssproperty --toolbar-gap - Gap between toolbar buttons.
+ * @cssproperty --toolbar-divider-color - Color of toolbar dividers.
+ * @cssproperty --toolbar-button-size - Size of toolbar buttons.
+ * @cssproperty --toolbar-button-radius - Corner radius of toolbar buttons.
+ * @cssproperty --toolbar-button-color - Icon color of inactive toolbar buttons.
+ * @cssproperty --toolbar-button-color-active - Icon color of hovered/active toolbar buttons.
+ * @cssproperty --toolbar-button-background-hover - Background of hovered toolbar buttons.
+ * @cssproperty --toolbar-button-background-active - Background of active toolbar buttons.
+ */
+export declare class ProseEditor extends LuxenFormAssociatedElement {
+    static styles: import('lit').CSSResult[];
+    /** The Tiptap editor instance. Available after the first render. */
+    editor: Editor;
+    /** Initial HTML content. */
+    accessor initialHtml: string;
+    /** Initial content as a serialized ProseMirror JSON string. */
+    accessor initialJson: string;
+    /** Class applied to the `.ProseMirror` editable element (e.g. for Tailwind Typography `prose`). */
+    accessor editorClass: string;
+    /** Explicit list of toolbar commands. Overrides `toolbar-preset` when set. */
+    accessor toolbar: ToolbarCommandName[];
+    /** Built-in toolbar layout used when `toolbar` is not set. */
+    accessor toolbarPreset: 'default' | 'minimal';
+    /** Where the toolbar sits relative to the content. */
+    accessor toolbarPlacement: 'top' | 'bottom';
+    /** Focus the editor on creation. */
+    accessor autofocus: boolean;
+    /** Placeholder shown when the editor is empty. */
+    accessor placeholder: string;
+    accessor _emojiPickerActive: boolean;
+    private _editorRoot?;
+    private _emojiPicker?;
+    get validationTarget(): HTMLElement | undefined;
+    private get _toolbar();
+    firstUpdated(): void;
+    updated(changed: PropertyValues<this>): void;
+    disconnectedCallback(): void;
+    /** Get the current content as an HTML string. Empty paragraph resolves to `''`. */
+    getHTML(): string;
+    /** Get the current content as ProseMirror JSON. */
+    getJSON(): JSONContent;
+    /** Remove all content. */
+    clear(): void;
+    focus(): void;
+    blur(): void;
+    toggleBold(): void;
+    toggleItalic(): void;
+    toggleUnderline(): void;
+    toggleStrike(): void;
+    toggleHighlight(): void;
+    toggleHeading(level: 1 | 2 | 3): void;
+    toggleBulletList(): void;
+    toggleOrderedList(): void;
+    toggleBlockquote(): void;
+    toggleCodeBlock(): void;
+    setHorizontalRule(): void;
+    undo(): void;
+    redo(): void;
+    toggleLink(): void;
+    formResetCallback(): void;
+    /** Sync the form value and validity from the current content. Returns the HTML. */
+    private _syncValue;
+    private _emitChange;
+    private _initialContent;
+    /**
+     * The editable element is created in light DOM (slotted), not the shadow root.
+     * Firefox and WebKit have long-standing bugs with `contenteditable` carets and
+     * DOM selections inside a shadow tree, so ProseMirror must live outside it.
+     * @see https://bugzilla.mozilla.org/show_bug.cgi?id=1496769
+     * @see https://bugs.webkit.org/show_bug.cgi?id=163921
+     */
+    private _createEditorRoot;
+    private _onFocus;
+    private _onKeyDown;
+    private _toggleEmojiPicker;
+    private get _emojiButton();
+    private _positionEmojiPicker;
+    private _renderButton;
+    private _renderToolbarItem;
+    render(): TemplateResult<1>;
+}
+export {};
+//# sourceMappingURL=prose-editor.d.ts.map

package/cdn/elements/prose-editor/prose-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prose-editor.d.ts","sourceRoot":"","sources":["../../../src/html/elements/prose-editor/prose-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAKhF,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAIxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAE3F,OAAO,kBAAkB,CAAC;AAK1B,KAAK,kBAAkB,GACnB,WAAW,GACX,WAAW,GACX,WAAW,GACX,MAAM,GACN,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,iBAAiB,GACjB,MAAM,GACN,OAAO,GACP,YAAY,GACZ,MAAM,GACN,MAAM,GACN,SAAS,CAAC;AA2Bd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,WAAY,SAAQ,0BAA0B;IACzD,OAAgB,MAAM,4BAAwB;IAE9C,oEAAoE;IACpE,MAAM,EAAG,MAAM,CAAC;IAEhB,4BAA4B;IAE5B,QAAQ,CAAC,WAAW,SAAM;IAE1B,+DAA+D;IAE/D,QAAQ,CAAC,WAAW,SAAM;IAE1B,mGAAmG;IAEnG,QAAQ,CAAC,WAAW,SAAW;IAE/B,8EAA8E;IAO9E,QAAQ,CAAC,OAAO,EAAE,kBAAkB,EAAE,CAAM;IAE5C,8DAA8D;IAE9D,QAAQ,CAAC,aAAa,EAAE,SAAS,GAAG,SAAS,CAAa;IAE1D,sDAAsD;IAEtD,QAAQ,CAAC,gBAAgB,EAAE,KAAK,GAAG,QAAQ,CAAS;IAEpD,oCAAoC;IAEpC,QAAQ,CAAC,SAAS,UAAS;IAE3B,kDAAkD;IAElD,QAAQ,CAAC,WAAW,SAAM;IAG1B,QAAQ,CAAC,kBAAkB,UAAS;IAEpC,OAAO,CAAC,WAAW,CAAC,CAAiB;IACrC,OAAO,CAAC,YAAY,CAAC,CAAc;IAEnC,IAAa,gBAAgB,IAAI,WAAW,GAAG,SAAS,CAEvD;IAED,OAAO,KAAK,QAAQ,GAEnB;IAEQ,YAAY;IA4BZ,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC;IASrC,oBAAoB;IAW7B,mFAAmF;IACnF,OAAO,IAAI,MAAM;IAMjB,mDAAmD;IACnD,OAAO,IAAI,WAAW;IAItB,0BAA0B;IAC1B,KAAK;IAII,KAAK;IAIL,IAAI;IAIb,UAAU;IAIV,YAAY;IAIZ,eAAe;IAIf,YAAY;IAIZ,eAAe;IAIf,aAAa,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;IAI9B,gBAAgB;IAIhB,iBAAiB;IAIjB,gBAAgB;IAIhB,eAAe;IAIf,iBAAiB;IAIjB,IAAI;IAIJ,IAAI;IAIJ,UAAU;IAaD,iBAAiB;IAK1B,mFAAmF;IACnF,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,eAAe;IAQvB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,QAAQ,CAId;IAEF,OAAO,CAAC,UAAU,CAEhB;YAIY,kBAAkB;IA0BhC,OAAO,KAAK,YAAY,GAEvB;YAEa,oBAAoB;IAwBlC,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,kBAAkB;IAwIjB,MAAM;CAyBhB"}