@mxmweb/rtext 1.0.1 → 1.0.6

package/core/UnifiedRichText.d.ts

@@ -0,0 +1,86 @@
+import { default as React } from 'react';
+import { RenderElementProps, RenderLeafProps } from 'slate-react';
+export declare enum DataType {
+    SLATE = "slate",
+    MARKDOWN = "markdown",
+    HTML = "html",
+    TEXT = "text"
+}
+export interface DataSource {
+    type: DataType;
+    content: any;
+}
+export interface UnifiedRichTextProps {
+    /** 数据源 */
+    dataSource: {
+        type: DataType;
+        content?: any;
+    };
+    /** 是否处于编辑模式 */
+    isEditing?: boolean;
+    /** 占位符文本 */
+    placeholder?: string;
+    /** 组件尺寸 */
+    size?: 'sm' | 'md';
+    /** 主题样式 */
+    theme?: {
+        primaryColor?: string;
+        secondaryColor?: string;
+        backgroundColor?: string;
+        textColor?: string;
+        borderColor?: string;
+        disabledBackground?: string;
+        borderRadius?: string;
+        padding?: string;
+        margin?: string;
+        minHeight?: string;
+    };
+    /** 内容变化回调 */
+    onChange?: (content: any, type: DataType) => void;
+    /** 聚焦回调 */
+    onFocus?: () => void;
+    /** 失焦回调 */
+    onBlur?: () => void;
+    /** 自定义渲染元素 */
+    renderElement?: (props: RenderElementProps) => JSX.Element;
+    /** 自定义渲染叶子节点 */
+    renderLeaf?: (props: RenderLeafProps) => JSX.Element;
+    /** 自定义样式 */
+    className?: string;
+    /** 自定义样式对象 */
+    style?: React.CSSProperties;
+    /** 样式配置 */
+    styles?: {
+        /** 字间距 */
+        letterSpacing?: string;
+        /** 行间距 */
+        lineHeight?: string;
+        /** 蓝框背景样式 */
+        templateField?: {
+            backgroundColor?: string;
+            borderColor?: string;
+            borderRadius?: string;
+            padding?: string;
+            margin?: string;
+            fontSize?: string;
+            fontWeight?: string;
+            minWidth?: string;
+            maxWidth?: string;
+            /** 文字颜色 */
+            textColor?: string;
+        };
+        /** 文本样式 */
+        text?: {
+            fontSize?: string;
+            lineHeight?: string;
+            color?: string;
+        };
+    };
+}
+/**
+ * 统一富文本组件
+ * 支持编辑和渲染模式，通过dataSource和dataType判断数据源
+ */
+declare const UnifiedRichText: React.FC<UnifiedRichTextProps>;
+export default UnifiedRichText;
+export { UnifiedRichText };

package/core/richElements/TemplateField.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+import { TemplateElement } from '../types';
+declare const TemplateField: React.ForwardRefExoticComponent<{
+    element: TemplateElement;
+    attributes: any;
+    children: React.ReactNode;
+    styles?: any;
+    onTemplateChange?: (id: string, value: string) => void;
+} & React.RefAttributes<HTMLSpanElement>>;
+export default TemplateField;

package/core/richElements/TemplateLeaf.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+interface TemplateLeaf {
+    type: 'template';
+    id: string;
+    placeholder: string;
+    value: string;
+    style?: string;
+}
+declare const TemplateLeaf: React.ForwardRefExoticComponent<{
+    leaf: TemplateLeaf;
+    attributes: any;
+    children: React.ReactNode;
+    styles?: any;
+    onTemplateChange?: (id: string, value: string) => void;
+} & React.RefAttributes<HTMLSpanElement>>;
+export default TemplateLeaf;

package/core/richElements/index.d.ts

@@ -0,0 +1,2 @@
+export declare const renderElement: (props: any) => import("react/jsx-runtime").JSX.Element;
+export declare const renderLeaf: (props: any) => any;

package/core/richElements/styles.d.ts

@@ -0,0 +1,4 @@
+export declare const RichTextContainer: import('styled-components/dist/types').IStyledComponentBase<"web", import('styled-components/dist/types').Substitute<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
+    theme?: any;
+    $size?: "sm" | "md";
+}>> & string;

package/core/types.d.ts

@@ -154,7 +154,47 @@ export interface LinkElement extends BaseElement {
     type: 'link';
     url: string;
 }
-export type CustomElement = ParagraphElement | HeadingOneElement | HeadingTwoElement | HeadingThreeElement | ListElement | ListItemElement | TableElement | TableRowElement | TableCellElement | ImageElement | CodeBlockElement | BlockQuoteElement | LinkElement;
+/**
+ * 模版输入字段元素类型
+ * 用于在富文本中插入可编辑的模版输入框
+ */
+export interface TemplateInputElement extends BaseElement {
+    type: 'template-input';
+    /** 输入框的占位符文本 */
+    placeholder?: string;
+    /** 输入框的默认值 */
+    defaultValue?: string;
+    /** 输入框的当前值 */
+    value?: string;
+    /** 是否处于编辑状态 */
+    isEditing?: boolean;
+    /** 输入框的样式类型 */
+    style?: 'blue' | 'green' | 'purple' | 'custom';
+    /** 自定义样式 */
+    customStyle?: {
+        backgroundColor?: string;
+        borderColor?: string;
+        textColor?: string;
+    };
+}
+/**
+ * 模版元素类型
+ * 用于在富文本中插入可编辑的模版输入块
+ */
+export interface TemplateElement extends BaseElement {
+    type: 'template';
+    /** 占位符文本 */
+    placeholder: string;
+    /** 当前值 */
+    value: string;
+    /** 样式类型 */
+    style: 'blue' | 'green' | 'purple';
+    /** 字段标识 */
+    fieldId: string;
+    /** 是否处于编辑状态 */
+    isEditing?: boolean;
+}
+export type CustomElement = ParagraphElement | HeadingOneElement | HeadingTwoElement | HeadingThreeElement | ListElement | ListItemElement | TableElement | TableRowElement | TableCellElement | ImageElement | CodeBlockElement | BlockQuoteElement | LinkElement | TemplateInputElement | TemplateElement;
 declare module 'slate' {
     interface CustomTypes {
         Editor: BaseEditor & ReactEditor;

package/demo.md

@@ -0,0 +1,60 @@
+电压和电池容量是描述电池性能的两个不同但相关的参数，它们分别表示：
+
+------
+
+### 🔋 一、电压（Voltage, 单位：V）
+
+电压是电池**推动电流流动的“力”**。它主要取决于：
+
+- **电池的化学体系**（比如锂电池通常是 3.6V~3.7V，铅酸电池是 2V/单格）；
+- **串联的电芯数量**（比如 3 节锂电池串联就是 11.1V）；
+- **电池的状态**（充满时电压高，放电时电压下降）；
+
+🔹 举例：
+
+- 一节锂电池标称电压为 **3.7V**，满电约 **4.2V**，用光约 **3.0V**；
+- 2 节串联就是 **7.4V**，3 节就是 **11.1V**。
+
+------
+
+### 🔋 二、电池容量（Capacity, 单位：mAh 或 Ah）
+
+容量代表电池**能储存多少电荷**，通常写作 **mAh（毫安时）** 或 **Ah（安时）**。
+
+- 表示电池可以以**多少电流持续放电多长时间**；
+- 举例：一个 3000mAh 的电池，理论上可以：
+  - 放电 3 小时（如果以 1A 放电）；
+  - 或放电 1 小时（如果以 3A 放电）；
+
+------
+
+### ⚖️ 三、二者关系：能量（Wh）是关键
+
+它们的联系体现在电池总能量（电量）上：
+
+```
+电池能量（Wh）= 电压（V） × 容量（Ah）
+```
+
+🔸 例如：
+
+| 电池    | 电压 | 容量              | 总能量（Wh）       |
+| ------- | ---- | ----------------- | ------------------ |
+| A型电池 | 3.7V | 3000mAh（=3Ah）   | 3.7 × 3 = 11.1Wh   |
+| B型电池 | 7.4V | 1500mAh（=1.5Ah） | 7.4 × 1.5 = 11.1Wh |
+
+这两个电池的**容量不同、电压不同**，但**总能量一样**。
+
+------
+
+### 🧭 总结
+
+| 项目 | 含义             | 单位 | 说明                            |
+| ---- | ---------------- | ---- | ------------------------------- |
+| 电压 | 推动电流的“压力” | V    | 决定设备工作电压是否匹配        |
+| 容量 | 储存电能的“多少” | mAh  | 表示电池能用多久                |
+| 能量 | 实际输出的电力   | Wh   | 电压 × 容量，最能说明“续航能力” |
+
+------
+
+如你正在选购或设计电池设备（如无人机、电动车、UPS 等），可以告诉我你的需求，我可以帮你计算推荐规格。