@tensor_1/react 2.18.0 → 2.19.0

package/dist/rich-text.d.cts

@@ -0,0 +1,148 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { E as EmojiPickerLabels, a as EmojiLocale } from './emoji-image-WQLh8ZQP.cjs';
+export { l as emojiImageFileName } from './emoji-image-WQLh8ZQP.cjs';
+import './overlay-position-CEGSz6Z2.cjs';
+
+type RichTextFeatures = 'full' | 'comment' | 'template';
+type RichTextHeadingLevel = 1 | 2 | 3;
+/** Every visible and accessible string of the editor. Placeholders are filled by the editor. */
+interface RichTextLabels {
+    toolbar: string;
+    heading1: string;
+    heading2: string;
+    heading3: string;
+    bold: string;
+    italic: string;
+    strike: string;
+    code: string;
+    bulletList: string;
+    orderedList: string;
+    taskList: string;
+    blockquote: string;
+    codeBlock: string;
+    horizontalRule: string;
+    link: string;
+    /** Label of the link address field. */
+    linkUrl: string;
+    linkApply: string;
+    linkRemove: string;
+    /** Shown when the link address is refused by `isSafeUrl`. */
+    linkInvalid: string;
+    table: string;
+    tableAddRow: string;
+    tableAddColumn: string;
+    tableDeleteRow: string;
+    tableDeleteColumn: string;
+    tableDelete: string;
+    image: string;
+    imageUploading: string;
+    imageFailed: string;
+    emoji: string;
+    /** Accessible name of the `:shortcode` suggestion list. */
+    emojiSuggestions: string;
+    undo: string;
+    redo: string;
+    /** Toggle to markdown source. */
+    sourceMode: string;
+    /** Toggle back to formatted editing. */
+    richMode: string;
+    /** Character counter. Placeholders: `{count}`, `{max}`. */
+    characterCount: string;
+}
+declare const DEFAULT_RICH_TEXT_LABELS: RichTextLabels;
+interface RichTextEditorProps {
+    /** Markdown. */
+    value: string;
+    /**
+     * Fired only for user edits — never on mount or when `value` changes from outside.
+     * Pass the emitted markdown back as `value` in the same update (as React state does):
+     * a different `value` is treated as an outside change and replaces the content.
+     */
+    onChange: (markdown: string) => void;
+    /** Toolbar preset. Default `'full'`. */
+    features?: RichTextFeatures;
+    /** Heading levels the toolbar and input rules offer. Default `[1, 2, 3]`. */
+    headingLevels?: ReadonlyArray<RichTextHeadingLevel>;
+    /** Enables the image button (preset `full`), and image paste/drop. */
+    onUploadImage?: (file: File) => Promise<{
+        src: string;
+        alt: string;
+    }>;
+    /** Link policy. Default: http(s), mailto and same-app paths. */
+    isSafeUrl?: (url: string) => boolean;
+    /** Image policy: the URL to display, or `null` to show the image as a link chip. */
+    resolveImageSrc?: (src: string) => string | null;
+    /** Ctrl/Cmd+Enter. */
+    onSubmitShortcut?: () => void;
+    /** Emoji button and `:shortcode` suggestions. Default `true`. */
+    emoji?: boolean;
+    /**
+     * Same-origin folder of fallback emoji PNGs for devices without a colour emoji font
+     * (e.g. `/static/emoji`). Emoji the device cannot draw show as
+     * `<img src="{base}/{codepoints}.png">`; see `emojiImageFileName`. Values with a scheme or
+     * `//` are ignored. Unset = native emoji only; UIx ships no image set.
+     */
+    emojiImageBaseUrl?: string;
+    /** Shows a character counter (markdown characters); over the limit sets `aria-invalid`. */
+    maxLength?: number;
+    placeholder?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    labels?: Partial<RichTextLabels>;
+    /** Labels of the emoji picker opened from the toolbar. */
+    emojiPickerLabels?: Partial<EmojiPickerLabels>;
+    /** Language of emoji names in the picker. Default `'en'`. */
+    emojiLocale?: EmojiLocale;
+    id?: string;
+    /** Renders a hidden input with the markdown, for native form posts. */
+    name?: string;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    'aria-describedby'?: string;
+    'aria-invalid'?: boolean;
+    'aria-required'?: boolean;
+    /** `'composer'` renders inside Composer with the toolbar in ComposerBar. Default `'field'`. */
+    variant?: 'field' | 'composer';
+    /** Composer actions (visibility, send), placed at the end of the bar. */
+    toolbarEnd?: ReactNode;
+    /** Minimum visible lines. Default 4 (field) / 3 (composer). */
+    minRows?: number;
+    className?: string;
+    onBlur?: () => void;
+}
+/** The loading/error stand-in: a plain Textarea with the same value and ARIA, and the composer bar. */
+declare function RichTextEditorFallback(props: RichTextEditorProps): react.JSX.Element;
+/**
+ * Markdown rich-text editor on Tiptap v3 (RTE-01). Markdown in, markdown out:
+ * untouched blocks keep their exact source bytes, `onChange` fires only for user
+ * edits, emoji are stored as Unicode, raw HTML is never interpreted, and links and
+ * images pass the consumer's policy. The toolbar is one tab stop (arrow keys move
+ * within it) and scrolls horizontally on narrow screens.
+ */
+declare function RichTextEditor(props: RichTextEditorProps): react.JSX.Element;
+
+/** Editor options that change how markdown is read. */
+interface RoundTripOptions {
+    /** As on RichTextEditor. Does not affect round-trip bytes; accepted for parity. */
+    headingLevels?: ReadonlyArray<1 | 2 | 3>;
+    /** As on RichTextEditor. */
+    isSafeUrl?: (url: string) => boolean;
+}
+/**
+ * Load markdown into the RichTextEditor's document model and write it back, exactly as
+ * the editor does when a user opens a field and saves without editing it. Consumers
+ * use it to gate their own content corpus: every stored value should satisfy
+ * `await roundTripMarkdown(md) === md`.
+ *
+ * Runs without a DOM (Node, Vitest, Jest). Asynchronous so the pipeline can be loaded
+ * lazily in future versions without an API change.
+ *
+ * @example
+ * for (const article of corpus) {
+ *   expect(await roundTripMarkdown(article.body)).toBe(article.body);
+ * }
+ */
+declare function roundTripMarkdown(markdown: string, options?: RoundTripOptions): Promise<string>;
+
+export { DEFAULT_RICH_TEXT_LABELS, EmojiLocale, EmojiPickerLabels, RichTextEditor, RichTextEditorFallback, type RichTextEditorProps, type RichTextFeatures, type RichTextHeadingLevel, type RichTextLabels, type RoundTripOptions, roundTripMarkdown };

package/dist/rich-text.d.ts

@@ -0,0 +1,8 @@
+export { DEFAULT_RICH_TEXT_LABELS, RichTextEditor, RichTextEditorFallback, RichTextEditorProps, RichTextFeatures, RichTextHeadingLevel, RichTextLabels } from './components/RichTextEditor.js';
+export { RoundTripOptions, roundTripMarkdown } from './rich-text/round-trip.js';
+export { EmojiLocale } from './emoji-model.js';
+export { EmojiPickerLabels } from './components/EmojiPicker.js';
+export { emojiImageFileName } from './emoji-image.js';
+import 'react';
+import '@tiptap/extension-emoji';
+import './overlay-position.js';

package/dist/rich-text.js

@@ -0,0 +1,10 @@
+import { RichTextEditor, RichTextEditorFallback, DEFAULT_RICH_TEXT_LABELS } from "./components/RichTextEditor.js";
+import { roundTripMarkdown } from "./rich-text/round-trip.js";
+import { emojiImageFileName } from "./emoji-image.js";
+export {
+  DEFAULT_RICH_TEXT_LABELS,
+  RichTextEditor,
+  RichTextEditorFallback,
+  emojiImageFileName,
+  roundTripMarkdown
+};

package/dist/url-policy.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Allows http(s), mailto and same-app references (`/path`, `#anchor`, `./x`, `../x`).
+ * Browsers drop tabs and newlines inside URLs and read `\` as `/`, so those are removed
+ * or refused first: `//evil.test`, `/\evil.test` and `/<TAB>/evil.test` are not
+ * same-app paths.
+ */
+declare function defaultIsSafeUrl(url: string): boolean;
+
+export { defaultIsSafeUrl };

package/dist/url-policy.js

@@ -0,0 +1,11 @@
+const ALLOWED_START = /^(https?:|mailto:|\/|#|\.\/|\.\.\/)/i;
+const CONTROL_OR_BACKSLASH = /[\x00-\x1f\x7f\\]/;
+const PROTOCOL_RELATIVE = /^[/\\]{2}/;
+function defaultIsSafeUrl(url) {
+  const candidate = url.replace(/[\t\n\r]/g, "").trim();
+  if (CONTROL_OR_BACKSLASH.test(candidate) || PROTOCOL_RELATIVE.test(candidate)) return false;
+  return ALLOWED_START.test(candidate);
+}
+export {
+  defaultIsSafeUrl
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tensor_1/react",
-  "version": "2.18.0",
+  "version": "2.19.0",
   "description": "Thin React wrappers over the UIx v2 CSS component library.",
   "license": "UNLICENSED",
   "type": "module",
@@ -31,6 +31,21 @@
       "types": "./dist/chart-preset.d.ts",
       "import": "./dist/chart-preset.js",
       "require": "./dist/chart-preset.cjs"
+    },
+    "./rich-text": {
+      "types": "./dist/rich-text.d.ts",
+      "import": "./dist/rich-text.js",
+      "require": "./dist/rich-text.cjs"
+    },
+    "./markdown": {
+      "types": "./dist/markdown.d.ts",
+      "import": "./dist/markdown.js",
+      "require": "./dist/markdown.cjs"
+    },
+    "./emoji": {
+      "types": "./dist/emoji.d.ts",
+      "import": "./dist/emoji.js",
+      "require": "./dist/emoji.cjs"
     }
   },
   "scripts": {
@@ -42,20 +57,86 @@
     "size": "node scripts/check-chart-preset-size.mjs"
   },
   "peerDependencies": {
+    "@tiptap/core": "3.31.3",
+    "@tiptap/extension-emoji": "3.31.3",
+    "@tiptap/extension-image": "3.31.3",
+    "@tiptap/extension-list": "3.31.3",
+    "@tiptap/extension-table": "3.31.3",
+    "@tiptap/extensions": "3.31.3",
+    "@tiptap/markdown": "3.31.3",
+    "@tiptap/pm": "3.31.3",
+    "@tiptap/react": "3.31.3",
+    "@tiptap/starter-kit": "3.31.3",
+    "@tiptap/suggestion": "3.31.3",
     "echarts": "^5.6.0",
+    "emojibase-data": "17.0.0",
+    "marked": "17.0.6",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {
+    "@tiptap/core": {
+      "optional": true
+    },
+    "@tiptap/extension-emoji": {
+      "optional": true
+    },
+    "@tiptap/extension-image": {
+      "optional": true
+    },
+    "@tiptap/extension-list": {
+      "optional": true
+    },
+    "@tiptap/extension-table": {
+      "optional": true
+    },
+    "@tiptap/extensions": {
+      "optional": true
+    },
+    "@tiptap/markdown": {
+      "optional": true
+    },
+    "@tiptap/pm": {
+      "optional": true
+    },
+    "@tiptap/react": {
+      "optional": true
+    },
+    "@tiptap/starter-kit": {
+      "optional": true
+    },
+    "@tiptap/suggestion": {
+      "optional": true
+    },
     "echarts": {
       "optional": true
+    },
+    "emojibase-data": {
+      "optional": true
+    },
+    "marked": {
+      "optional": true
     }
   },
   "devDependencies": {
+    "@tiptap/core": "3.31.3",
+    "@tiptap/extension-emoji": "3.31.3",
+    "@tiptap/extension-image": "3.31.3",
+    "@tiptap/extension-list": "3.31.3",
+    "@tiptap/extension-table": "3.31.3",
+    "@tiptap/extensions": "3.31.3",
+    "@tiptap/markdown": "3.31.3",
+    "@tiptap/pm": "3.31.3",
+    "@tiptap/react": "3.31.3",
+    "@tiptap/starter-kit": "3.31.3",
+    "@tiptap/suggestion": "3.31.3",
     "@types/react": "^18.0.0",
     "@types/react-dom": "^18.0.0",
     "echarts": "^5.6.0",
+    "emojibase-data": "17.0.0",
     "esbuild": "^0.27.0",
+    "jsdom": "30.1.0",
+    "marked": "17.0.6",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"
   }