@exsto/ds 0.0.1-rc.6 → 0.0.1-rc.7

package/dist/ui/src/components/edyn/rich-text-editor/types.d.ts

@@ -0,0 +1,68 @@
+/** One person (or anything else) the app offers when the writer types @. */
+export interface IRichTextMentionItem {
+    /** What the HTML carries. By default the value is written as `@${id}`, so an email address works as an id. */
+    id: string;
+    /** What the chip shows while the text is being edited. */
+    label: string;
+    /** A second, muted line in the list (a role, an email address). */
+    secondary?: string;
+}
+/** A page of results. Return a plain array instead when there is only ever one page. */
+export interface IRichTextMentionPage {
+    items: IRichTextMentionItem[];
+    /** True when asking for `page + 1` would return more. The list loads it when it is scrolled to the end. */
+    hasMore?: boolean;
+}
+export interface IRichTextMentionSearchOptions {
+    /** 1-based. */
+    page: number;
+    /** Aborted when the writer types on or closes the list: pass it to `fetch` so a stale search stops. */
+    signal: AbortSignal;
+}
+export type TRichTextMentionSearch = (query: string, options: IRichTextMentionSearchOptions) => Promise<IRichTextMentionItem[] | IRichTextMentionPage>;
+export interface IRichTextMention {
+    /** Asked for the first page when the writer types @ and again for every change of the text after it, debounced. */
+    search: TRichTextMentionSearch;
+    /**
+     * How a mention is written into the HTML. The chip exists only while editing; the HTML carries this text
+     * and no element. Default: `@${item.id}`.
+     */
+    toText?: (item: Pick<IRichTextMentionItem, 'id' | 'label'>) => string;
+    /** Milliseconds to wait after the last keystroke before searching. Default 250. */
+    debounce?: number;
+}
+/** A field of a template (a mail merge token). Inserted as the plain text `{{id}}`. */
+export interface IRichTextField {
+    id: string;
+    label: string;
+}
+/** What a ref to the editor can do, for a button outside it (a merge tag, say). */
+export interface IRichTextEditorHandle {
+    /** Writes plain text at the caret (over the selection), and puts focus back in the editor. */
+    insertText: (text: string) => void;
+    focus: () => void;
+}
+/** Every string the editor shows, so an app can translate them. */
+export interface IRichTextLabels {
+    toolbar: string;
+    bold: string;
+    italic: string;
+    underline: string;
+    bulletList: string;
+    numberedList: string;
+    link: string;
+    horizontalRule: string;
+    insertField: string;
+    linkAddress: string;
+    linkApply: string;
+    linkRemove: string;
+    linkInvalid: string;
+    mentionList: string;
+    mentionSearching: string;
+    mentionEmpty: string;
+    mentionError: string;
+    mentionLoadingMore: string;
+    /** Announced as the list changes. `{count}` is replaced. */
+    mentionResults: string;
+}
+export declare const DEFAULT_RICH_TEXT_LABELS: IRichTextLabels;

package/dist/ui/src/components/ui/popover/popover.d.ts

@@ -2,7 +2,7 @@ import { Popover as PopoverPrimitive } from '@base-ui/react/popover';
 import type * as React from 'react';
 export declare const Popover: ({ ...props }: PopoverPrimitive.Root.Props) => React.JSX.Element;
 export declare const PopoverTrigger: ({ ...props }: PopoverPrimitive.Trigger.Props) => React.JSX.Element;
-export declare const PopoverContent: ({ className, align, alignOffset, side, sideOffset, ...props }: PopoverPrimitive.Popup.Props & Pick<PopoverPrimitive.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset">) => React.JSX.Element;
+export declare const PopoverContent: ({ className, align, alignOffset, side, sideOffset, anchor, ...props }: PopoverPrimitive.Popup.Props & Pick<PopoverPrimitive.Positioner.Props, "align" | "alignOffset" | "anchor" | "side" | "sideOffset">) => React.JSX.Element;
 export declare const PopoverHeader: ({ className, ...props }: React.ComponentProps<"div">) => React.JSX.Element;
 export declare const PopoverTitle: ({ className, ...props }: PopoverPrimitive.Title.Props) => React.JSX.Element;
 export declare const PopoverDescription: ({ className, ...props }: PopoverPrimitive.Description.Props) => React.JSX.Element;

package/dist/ui/src/index.d.ts

@@ -4,6 +4,7 @@ export * from './components/edyn/date-range-picker';
 export * from './components/edyn/initials-avatar';
 export * from './components/edyn/multi-select';
 export * from './components/edyn/progress-line';
+export * from './components/edyn/rich-text-content';
 export * from './components/edyn/video-player';
 export * from './components/ui/accordion';
 export * from './components/ui/alert';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exsto/ds",
-  "version": "0.0.1-rc.6",
+  "version": "0.0.1-rc.7",
   "description": "The eDynamix design system: React components and design tokens.",
   "license": "Apache-2.0",
   "keywords": [
@@ -27,6 +27,10 @@
       "types": "./dist/ds/src/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./rich-text-editor": {
+      "types": "./dist/ds/src/rich-text-editor.d.ts",
+      "default": "./dist/rich-text-editor.js"
+    },
     "./styles.css": {
       "types": "./dist/styles.css.d.ts",
       "default": "./dist/styles.css"
@@ -46,6 +50,22 @@
     "@shadcn/react": "^0.3.1",
     "@tabler/icons-react": "^3.44.0",
     "@tanstack/react-virtual": "^3.13.0",
+    "@tiptap/core": "3.32.2",
+    "@tiptap/extension-bold": "3.32.2",
+    "@tiptap/extension-document": "3.32.2",
+    "@tiptap/extension-hard-break": "3.32.2",
+    "@tiptap/extension-horizontal-rule": "3.32.2",
+    "@tiptap/extension-italic": "3.32.2",
+    "@tiptap/extension-link": "3.32.2",
+    "@tiptap/extension-list": "3.32.2",
+    "@tiptap/extension-mention": "3.32.2",
+    "@tiptap/extension-paragraph": "3.32.2",
+    "@tiptap/extension-text": "3.32.2",
+    "@tiptap/extension-underline": "3.32.2",
+    "@tiptap/extensions": "3.32.2",
+    "@tiptap/pm": "3.32.2",
+    "@tiptap/react": "3.32.2",
+    "@tiptap/suggestion": "3.32.2",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",