@codady/coax 0.0.1 → 0.0.3

package/dist/coax.esm.js

@@ -1,8 +1,8 @@
 
 /*!
- * @since Last modified: 2026-1-4 16:0:48
+ * @since Last modified: 2026-1-12 9:47:5
  * @name Coax event management system.
- * @version 0.0.1
+ * @version 0.0.3
  * @author AXUI development team <3217728223@qq.com>
  * @description Coax is a custom web component that enables syntax highlighting for various programming languages inside your HTML documents.
  * @see {@link https://coax.axui.cn|Official website}
@@ -14,166 +14,849 @@
  * @license MIT license
  */
 
-class Coax extends HTMLElement {
+const typeWriter = (text, options) => {
+    const speed = options.speed || 100; // Set typing speed (default to 100ms per character)
+    return new Promise((resolve) => {
+        // Callback before typing starts
+        options?.onBeforeType?.(text);
+        let index = 0;
+        // Timer to type the text character by character at the given speed
+        const timer = setInterval(() => {
+            if (index < text.length) {
+                const char = text.charAt(index); // Get the character at the current index
+                const typedText = text.substring(0, index + 1); // The text typed so far
+                // Callback during typing each character
+                options?.onDuringType?.(char, typedText);
+                index++;
+            }
+            else {
+                // Clear the timer once typing is complete
+                clearInterval(timer);
+                // Resolve the Promise when typing is complete
+                resolve(text);
+                // Callback after typing is finished
+                options?.onAfterType?.(text);
+            }
+        }, speed);
+    });
+};
+
+const COMMA$1 = ',';
+
+const SPACE$1 = ' ';
+
+const trim$1 = (str, placement = 'compress') => {
+    if (typeof str !== 'string') {
+        console.warn('Expected a string input');
+        return '';
+    }
+    switch (placement) {
+        case 'start':
+            return str.trimStart();
+        case 'end':
+            return str.trimEnd();
+        case 'both':
+            return str.trim();
+        case 'global':
+            return str.replace(/[\s\r\n]+/g, '');
+        default:
+            return str.trim().replace(/[\s\r\n]+/g, ' '); // Default behavior, trims both ends and replaces inner spaces
+    }
+};
+
+const parseClasses$1 = (data) => {
+    let separator, result = [];
+    if (Array.isArray(data)) {
+        // If data is already an array, filter out invalid values
+        result = data.filter((k) => k && typeof k === 'string');
+    }
+    else {
+        // Trim the input string and handle multiple spaces
+        data = trim$1(data);
+        // Use comma as the separator if present, otherwise use space
+        separator = data.includes(COMMA$1) ? COMMA$1 : SPACE$1;
+        result = data.split(separator);
+    }
+    // Trim each item globally and filter out any empty strings
+    return result.map((k) => trim$1(k, 'global')).filter(Boolean);
+};
+
+const NAMESPACE = 'ax';
+
+const getDataType = (obj) => {
+    let tmp = Object.prototype.toString.call(obj).slice(8, -1), result;
+    if (tmp === 'Function' && /^\s*class\s+/.test(obj.toString())) {
+        result = 'Class';
+    }
+    else if (tmp === 'Object' && Object.getPrototypeOf(obj) !== Object.prototype) {
+        result = 'Instance';
+    }
+    else {
+        result = tmp;
+    }
+    return result;
+    //document.createElement -> HTMLxxxElement
+    //document.createDocumentFragment() -> DocumentFragment
+    //document.createComment() -> Comment
+    //document.createTextNode -> Text
+    //document.createCDATASection() -> XMLDocument
+    //document.createProcessingInstruction() -> ProcessingInstruction
+    //document.createRange() -> Range
+    //document.createTreeWalker() -> TreeWalker
+    //document.createNodeIterator() -> NodeIterator
+    //document.createElementNS('http://www.w3.org/2000/svg', 'svg'); -> SVGSVGElement
+    //document.createElementNS('http://www.w3.org/1998/Math/MathML', 'math'); -> MathMLElement
+};
+
+const getEl = (obj, wrap = document.body) => {
+    let objType = getDataType(obj), parType = getDataType(wrap), parent = parType.includes('HTML') || parType === 'ShadowRoot' ? wrap : document.querySelector(wrap), 
+    //如果parent是template节点，需要通过node.content.querySelector取得子节点
+    root = parent && parent instanceof HTMLTemplateElement ? parent.content : parent, result = null;
+    if (obj) {
+        if (objType.includes('HTML')) {
+            result = obj;
+        }
+        else if (objType === 'String') {
+            try {
+                result = (root || document).querySelector(obj.trim());
+                //可能会报错，报错则返回null
+            }
+            catch {
+                result = null;
+            }
+        }
+    }
+    return result;
+};
+
+const createEl = (name, attrs, content) => {
+    //默认为div
+    name = name || 'div';
+    //统一大小写
+    let rootName = name.toUpperCase().trim(), rootEl = document.createElement(rootName), attrsType = getDataType(attrs), loop = (host, data) => {
+        if (data === '' || data === null || data === undefined) {
+            //为空、未定义则不再执行
+            return false;
+        }
+        let dataType = getDataType(data);
+        //template是DocumentFragment类型不能用insertAdjacentHTML
+        if (rootName === 'TEMPLATE') {
+            host.innerHTML = data.toString();
+        }
+        else {
+            if (dataType === 'Array' && data.length > 0) {
+                //节点数组
+                //data.forEach((i: T_obj) => loop(el, i));
+                for (let k of data) {
+                    let childType = getDataType(k);
+                    if (childType.includes('HTML')) {
+                        //是个节点
+                        host.appendChild(k);
+                    }
+                    else {
+                        //是个对象{name:'',attrs:{},content:''}
+                        let child = createEl(k.name, k.attrs, k.content);
+                        child && host.appendChild(child);
+                    }
+                }
+            }
+            else if (dataType.includes('HTML')) {
+                //HTML节点
+                host.appendChild(data);
+            }
+            else if (dataType === 'String' && data.trim().startsWith('#') && data.trim().length > 1) {
+                //是字符串且是#id选择器，则取其文本
+                let el = getEl(data);
+                if (!el)
+                    return;
+                //如果是template模板节点则需要特殊处理
+                el.nodeName === 'TEMPLATE' ? host.appendChild(el.content.cloneNode(true)) : host.insertAdjacentHTML('beforeEnd', el.innerHTML);
+            }
+            else {
+                //字符串数字等
+                host.insertAdjacentHTML('beforeEnd', data);
+            }
+        }
+    };
+    //添加属性
+    if (attrs && attrsType === 'Object') {
+        for (let k in attrs) {
+            //注意，attrs[k]可能是一个{}或[]，不一定是字符串
+            // JSON.stringify可以将所有格式的数据都转成文本，会忽略函数和节点数据
+            //字符串则不需要stringify，否则会将字符串的引号也一并输出
+            attrs.hasOwnProperty(k) && rootEl.setAttribute(k, typeof attrs[k] === 'string' ? attrs[k] : JSON.stringify(attrs[k]));
+        }
+    }
+    //执行循环创建子节点
+    loop(rootEl, content);
+    return rootEl;
+};
+
+const isEmpty = (data) => {
+    let type = getDataType(data), flag;
+    if (!data) {
+        //0,'',false,undefined,null
+        flag = true;
+    }
+    else {
+        //function(){}|()=>{}
+        //[null]|[undefined]|['']|[""]
+        //[]|{}
+        //Symbol()|Symbol.for()
+        //Set,Map
+        //Date/Regex
+        flag = (type === 'Object') ? (Object.keys(data).length === 0) :
+            (type === 'Array') ? data.join('') === '' :
+                (type === 'Function') ? (data.toString().replace(/\s+/g, '').match(/{.*}/g)[0] === '{}') :
+                    (type === 'Symbol') ? (data.toString().replace(/\s+/g, '').match(/\(.*\)/g)[0] === '()') :
+                        (type === 'Set' || type === 'Map') ? data.size === 0 :
+                            type === 'Date' ? isNaN(data.getTime()) :
+                                type === 'RegExp' ? data.source === '' :
+                                    type === 'ArrayBuffer' ? data.byteLength === 0 :
+                                        (type === 'NodeList' || type === 'HTMLCollection') ? data.length === 0 :
+                                            ('length' in data && typeof data.length === 'number') ? data.length === 0 :
+                                                ('size' in data && typeof data.size === 'number') ? data.size === 0 :
+                                                    (type === 'Error' || data instanceof Error) ? data.message === '' :
+                                                        (type.includes('Array') && (['Uint8Array', 'Int8Array', 'Uint16Array', 'Int16Array', 'Uint32Array', 'Int32Array', 'Float32Array', 'Float64Array'].includes(type))) ? data.length === 0 :
+                                                            false;
+    }
+    return flag;
+};
+
+const ALIAS = 'rep';
+
+const addClasses = (target, classes, intercept) => {
+    const el = getEl(target), arr = parseClasses$1(classes);
+    if (!el || arr.length === 0) {
+        return;
+    }
+    arr.forEach((k) => {
+        {
+            el.classList.add(k);
+        }
+    });
+};
+
+const createTools = (data) => {
+    
+    const toolsEl = createEl('span', { class: `${NAMESPACE}-box-tools` }), renderFn = (props) => {
+        const dftAttrs = {}, arrow = props.extendable ? `<i ${ALIAS}="arrow"></i>` : '', iconStr = props.icon ? `<i ${ALIAS}="icon">${props.icon}</i>` : '', diskStr = props.disk ? `<i ${ALIAS}="disk"><img src="${props.disk}"/></i>` : '', cubeStr = props.cube ? `<i ${ALIAS}="cube"><img src="${props.cube}"/></i>` : '', imageStr = props.image ? `<i ${ALIAS}="image"><img src="${props.image}"/></i>` : '', label = props.label ? `<i ${ALIAS}="label">${props.label}</i>` : '', html = iconStr + diskStr + cubeStr + imageStr + label + arrow;
+        //使用title提示
+        props.title && (dftAttrs.title = props.title);
+        //可聚焦，增加tabindex=1
+        props.focusable && (dftAttrs.tabindex = 1);
+        //attrs是其他属性，可能会覆盖title、tabindex
+        props.wrapEl = createEl(props.nodeName || 'span', Object.assign(dftAttrs, props.attrs), html);
+        props.iconEl = props.wrapEl.querySelector(`[${ALIAS}="icon"]`);
+        props.cubeEl = props.wrapEl.querySelector(`[${ALIAS}="cube"]`);
+        props.diskEl = props.wrapEl.querySelector(`[${ALIAS}="disk"]`);
+        props.imageEl = props.wrapEl.querySelector(`[${ALIAS}="image"]`);
+        props.labelEl = props.wrapEl.querySelector(`[${ALIAS}="label"]`);
+        //增加classes和styles
+        !isEmpty(props.classes) && addClasses(props.wrapEl, props.classes);
+        !isEmpty(props.styles) && (props.wrapEl.style.cssText += props.styles);
+    };
+    //此处不用map方法，是避免改变原data的内存地址指向
+    for (let item of data) {
+        //data=[{},{},'toggle','close']
+        renderFn(item);
+        toolsEl.appendChild(item.wrapEl);
+        item?.action?.(item);
+    }
+    return toolsEl;
+};
+
+class CoaxElem extends HTMLElement {
     // A static Map to hold the configuration for different languages
     static languages = new Map();
-    // Raw code as text from the HTML content
-    rawCode;
+    static tools = [];
+    source;
+    _renderQueued = false;
+    baseStylesEl;
+    themeStylesEl;
+    dynamicStylesEl;
+    highlightedCodeEl;
+    headerEl;
+    codeNameEl;
+    codeToolsEl;
+    codeBodyEl;
+    alias;
+    lineString;
+    speed;
+    autoScroll;
     constructor() {
         super();
         // Attach a Shadow DOM to the custom element
         this.attachShadow({ mode: 'open' });
         // Remove leading/trailing whitespace from the raw code content
-        this.rawCode = this.textContent?.replace(/^\s*\n|\n\s*$/g, '') || '';
+        this.source = this.textContent?.replace(/^\s*\n|\n\s*$/g, '') || '';
+        this.lang = 'plain';
+        this.alias = 'Plain Text';
+        this.lineString = '';
+        this.speed = 5;
+        this.autoScroll = true;
+        // 1. 初始化基础骨架
+        this.shadowRoot.innerHTML = `
+            <style id="base-styles">
+                :host { 
+                    --border-width:1px;
+                    --border-style:solid;
+                    --radius:9px;
+                    --height:auto;
+                    --max-height:500px;
+                    --radius:9px;
+                    --padding:1em;
+                    --font-size:16px;
+                    --line-height:1.8;
+                    --background:rgb(247, 247, 247);
+                    --border-color:rgb(224, 224, 224);
+                    --color-code:rgb(51, 51, 51);
+                    --color-index:rgb(153, 153, 153);
+                    --color-stripe:rgba(0,0,0,0.04);
+                    --color-hover:rgba(0,0,0,0.06);
+                }           
+               :host([scheme="dark"]){
+                    --background: #282c34;
+                    --border-color: transparent;
+                    --color-code: #abb2bf;
+                    --color-index:rgb(153, 153, 153);
+                    --color-stripe:rgba(255,255,255,0.04);
+                    --color-hover:rgba(255,255,255,0.06);
+               }
+                @media (prefers-color-scheme: dark) {
+                    :host{
+                        --background: #282c34;
+                        --border-color: transparent;
+                        --color-code: #abb2bf;
+                        --color-index:rgb(153, 153, 153);
+                        --color-stripe:rgba(255,255,255,0.04);
+                        --color-hover:rgba(255,255,255,0.06);
+                    }
+                }
+                :host {
+                    font-size: var(--${NAMESPACE}-code-font-size,var(--font-size));
+                    display: block; 
+                    box-sizing:border-box;
+                    background:var(--${NAMESPACE}-code-background-color,var(--background));
+                    color:var(--${NAMESPACE}-code-color,var(--color-code));
+                    border:var(--${NAMESPACE}-code-border-width,var(--border-width)) var(--${NAMESPACE}-code-border-style,var(--border-style)) var(--${NAMESPACE}-code-border-color,var(--border-color));
+                    transition: border-color 0.3s ease,color 0.3s ease;  
+                    border-radius: var(--${NAMESPACE}-code-radius,var(--radius));
+                }
+                #code-header{
+                    line-height:calc(var(--${NAMESPACE}-code-line-height,var(--line-height))*1.5);
+                    padding-inline-start:var(--${NAMESPACE}-code-padding,var(--padding));
+                    display:flex;
+                    
+                    >:first-child{
+                        flex:auto;
+                    }
+                }
+                #code-body{
+                    padding: var(--${NAMESPACE}-code-padding,var(--padding)) 0;
+                    height:var(--${NAMESPACE}-code-height,var(--height));
+                    max-height:var(--${NAMESPACE}-code-max-height,var(--max-height));
+                    overflow:auto;
+                }
+                pre,code{
+                    font-family:"Consolas", "Monaco", "Andale Mono", "Ubuntu Mono", "monospace";
+                    margin:0; padding:0;
+                }
+                code>div{
+                    display:flex;
+                    padding:0 var(--${NAMESPACE}-code-padding,var(--padding));
+                    line-height: var(--${NAMESPACE}-code-line-height,var(--line-height));
+                    box-sizing:border-box;
+                    
+                    >div{
+                        flex:auto;
+                    }
+                }
+                code>div>div:empty:before{
+                    content:' ';
+                }
+                :host([indexed]) code>div:before{
+                    display:inline-flex;
+                    color:var(--color-index);
+                    content: attr(data-index);
+                    min-width:var(--${NAMESPACE}-code-index-width,2em);
+                    margin-inline-end:var(--${NAMESPACE}-code-padding,8px);
+                }
+                :host([striped]) code>div:nth-child(odd){
+                    background-color:var(--color-stripe);
+                }
+                :host([hoverable]) code>div:hover{
+                    background-color:var(--color-hover);
+                }
+                :host([wrapped]) code>div>div{
+                    white-space: pre-wrap;
+                }
+                :host([unnamed]) #code-name{
+                    display:none;
+                }
+                .${NAMESPACE}-box-tools{
+                    >*{
+                        font-size:14px;
+                        display:inline-flex;
+                        align-items:center;
+                        justify-content:center;
+                        height:2em;
+                        line-height:2em;
+                        aspect-ratio:1/1;
+                        margin-inline-end:8px;
+                        transition:all 200ms ease;
+                        border-radius:6px;
+                        &:hover{
+                            cursor:pointer;
+                            background-color:rgba(0,0,0,.04);
+                        }
+                    }
+                    [rep=icon]{
+                        display:inline-flex;
+                        align-items:center;
+                        justify-content:center;
+                    }
+                }
+                [disabled]{
+                    pointer-event:none;
+                }
+            </style>
+            <style id="dynamic-styles"></style>
+            <style id="theme-styles"></style>
+            <div id="code-header"><span id="code-name">${this.alias}</span><div id="code-tools"></div></div>
+            <div id="code-body">
+                <pre><code id="highlight-code"></code></pre>
+            </div>
+        `;
+        // 缓存引用
+        this.baseStylesEl = getEl('#base-styles', this.shadowRoot);
+        this.themeStylesEl = getEl('#theme-styles', this.shadowRoot);
+        this.dynamicStylesEl = getEl('#dynamic-styles', this.shadowRoot);
+        this.headerEl = getEl('#code-header', this.shadowRoot);
+        this.codeNameEl = getEl('#code-name', this.shadowRoot);
+        this.codeToolsEl = getEl('#code-tools', this.shadowRoot);
+        this.codeBodyEl = getEl('#code-body', this.shadowRoot);
+        this.highlightedCodeEl = getEl('#highlight-code', this.shadowRoot);
+        this.codeBodyEl.addEventListener('scroll', () => {
+            let flag = this.codeBodyEl.scrollTop + this.codeBodyEl.clientHeight < this.codeBodyEl.scrollHeight;
+            // 检测是否是用户手动滚动
+            this.autoScroll = !flag;
+        });
     }
     
-    static register(name, { rules, theme = {}, internalCss = '', cssPrefix = '' }) {
+    static register(name, config) {
         // Store the language configuration in the static map
-        this.languages.set(name, { rules, theme, internalCss, cssPrefix });
-        // Render the highlighted code for all elements with the registered language
-        document.querySelectorAll('ax-code').forEach(el => {
-            if (el.getAttribute('lang') === name)
-                el.render();
+        this.languages.set(name, { ...config });
+    }
+    //注册工具箱
+    static addTools(items) {
+        CoaxElem.tools = items;
+    }
+    //加入工具箱
+    mountTools(toolItems) {
+        requestAnimationFrame(() => {
+            this.codeToolsEl.innerHTML = '';
+            let items = toolItems.map(k => {
+                k.action = k.action.bind(this);
+                return k;
+            });
+            this.codeToolsEl.appendChild(createTools(items));
         });
     }
     // Called when the element is connected to the DOM
-    connectedCallback() { this.render(); }
+    connectedCallback() {
+        this.render();
+    }
     // Observed attributes for changes
-    static get observedAttributes() { return ['lang', 'height', 'max-height']; }
+    static get observedAttributes() { return ['lang', 'height', 'max-height', 'tools', 'speed']; }
     
-    attributeChangedCallback() {
-        this.render();
+    attributeChangedCallback(name, oldVal, newVal) {
+        if (oldVal === newVal)
+            return;
+        if (name === 'height' || name === 'max-height') {
+            this.updateStyleByRegExp(name, newVal);
+        }
+        if (name === 'speed') {
+            this.speed = ~~(!!newVal);
+        }
+        if (name === 'lang') {
+            //更新当前语言
+            this.lang = newVal;
+            this.render();
+        }
+        if (name === 'tools') {
+            if (!newVal)
+                this.codeToolsEl.innerHTML = '';
+            const tools = parseClasses$1(newVal), toolItems = CoaxElem.tools.filter(k => tools.includes(k.name));
+            if (!toolItems.length)
+                return;
+            this.mountTools(toolItems);
+        }
     }
     
-    render() {
-        // Get language name, fallback to 'js' if not provided
-        const lang = this.getAttribute('lang') || 'js', 
-        // Get the language configuration
-        config = Coax.languages.get(lang), 
-        // Default to language name if no prefix is set
-        cssPrefix = config?.cssPrefix || lang, height = this.getAttribute('height'), maxHeight = this.getAttribute('max-height');
-        let highlightedCode = '', dynamicStyles = '';
-        if (config) {
-            //Generate the highlighted HTML by applying the syntax rules
-            const combinedRegex = new RegExp(config.rules.map((r) => `(${r.reg.source})`).join('|'), 'g'), escaped = this.rawCode.replace(/[&<>]/g, m => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;' }[m]));
-            // Replace code with highlighted syntax
-            highlightedCode = escaped.replace(combinedRegex, (match, ...args) => {
-                const index = args.findIndex(val => val !== undefined);
-                return index !== -1 && config.rules[index] ? `<span class="ax-${cssPrefix}-${config.rules[index].name}">${match}</span>` : match;
-            });
-            //Generate dynamic CSS classes for each syntax rule
-            // 为 rules 中的每一个 name 生成类似 .hl-name { color: var(--ax-code-name); }
-            dynamicStyles = config.rules.map((rule) => `
-                .ax-${cssPrefix}-${rule.name} { color: var(--ax-${cssPrefix}-${rule.name}); }
-            `).join('\n');
+    updateStyleByRegExp(prop, value) {
+        // 构建正则：匹配属性名后面跟着冒号，直到分号或换行
+        // 例如：height:\s*[^;]+;
+        const regex = new RegExp(`;\\n\\s*${prop}:\\s*[^;]+;`, 'g');
+        // 替换为新的属性值
+        this.baseStylesEl.textContent = this.baseStylesEl.textContent.replace(regex, `;\n${prop}: ${value};`);
+    }
+    getCssPrefix(config) {
+        return (config?.cssPrefix || this.lang).replace(/[^a-zA-Z0-9_-]/g, '\\$&');
+    }
+    getHighLightString(string, config) {
+        config = config || CoaxElem.languages.get(this.lang);
+        if (!config)
+            return string;
+        // 如果找到了配置，则进行高亮处理
+        const cssPrefix = this.getCssPrefix(config), 
+        // 获取用于语法高亮的正则表达式
+        combinedRegex = new RegExp(config.rules.map((r) => `(${r.pattern.source})`).join('|'), 'g');
+        return string.replace(combinedRegex, (match, ...args) => {
+            const i = args.findIndex(val => val !== undefined);
+            return i !== -1 && config.rules[i] ? `<span class="${NAMESPACE}-${cssPrefix}-${config.rules[i].token}">${match}</span>` : match;
+        });
+    }
+    createLineWrap(index, startIndex) {
+        let dataIndex = 0;
+        if (index == null && startIndex == null) {
+            dataIndex = this.highlightedCodeEl.children.length;
         }
         else {
-            // If no config, display raw code without highlighting
-            highlightedCode = this.rawCode;
+            const start = startIndex || this.highlightedCodeEl.children.length;
+            dataIndex = start + index;
         }
-        //Generate CSS theme variables if a theme is provided
-        const themeVars = config?.theme
-            ? Object.entries(config.theme).map(([k, v]) => `--ax-${cssPrefix}-${k}: ${v};`).join('\n')
-            : '';
+        return createEl('div', { 'data-index': dataIndex }, '<div></div>');
+    }
+    getLineToFill(codeWrap, line, config) {
+        config = config || CoaxElem.languages.get(this.lang);
+        let highlightedLine = this.getHighLightString(line, config);
+        // 将高亮后的内容填充到 div 中
+        codeWrap.innerHTML = highlightedLine;
+    }
+    ;
+    
+    async highlight(newCode) {
+        const config = CoaxElem.languages.get(this.lang), startIndex = this.highlightedCodeEl.children.length, 
+        // 将新源码按行分割
+        newCodeLines = newCode ? newCode.split('\n') : [];
+        //更新别名
+        this.updateName(config);
+        if (!newCodeLines.length)
+            return true;
+        // 如果没有找到配置，则输出原始代码，并不进行高亮处理
+        for (let [index, lineString] of newCodeLines.entries()) {
+            //如果是空行则跳过
+            if (!lineString.trim() && this.hasAttribute('sanitized'))
+                continue;
+            // 创建一个 div 包裹每一行
+            const lineWrap = this.createLineWrap(index, startIndex), codeWrap = lineWrap.lastElementChild;
+            //标记完成
+            this.closeLine(lineWrap);
+            if (this.hasAttribute('speed')) {
+                this.highlightedCodeEl.appendChild(lineWrap);
+                //流式打字
+                await typeWriter(lineString, {
+                    speed: this.speed,
+                    onDuringType: (char, fullText) => {
+                        codeWrap.innerHTML = fullText;
+                    }
+                });
+                this.getLineToFill(codeWrap, lineString, config);
+            }
+            else {
+                //直接打出
+                this.getLineToFill(codeWrap, lineString, config);
+                //
+                this.highlightedCodeEl.appendChild(lineWrap);
+            }
+        }
+        //滚动到最底部
+        this.autoScrollCode();
+        return true;
+    }
+    autoScrollCode() {
+        if (this.autoScroll) {
+            this.codeBodyEl.scrollTop = this.codeBodyEl.scrollHeight;
+        }
+    }
+    injectThemeStyles() {
+        const config = CoaxElem.languages.get(this.lang);
+        if (!config)
+            return;
+        // Get language name, fallback to 'js' if not provided
+        let cssPrefix = this.getCssPrefix(config), 
+        //Generate dynamic CSS classes for each syntax rule
+        // 为 rules 中的每一个 name 生成类似 .hl-name { color: var(--ax-code-name); }
+        lightStyles = config.rules.map((rule) => `
+                .${NAMESPACE}-${cssPrefix}-${rule.token} { color: var(--${NAMESPACE}-${cssPrefix}-${rule.token}${rule.light ? ',' + rule.light : ''});}`).join('\n'), darkStyles = '', schemeStyles = '';
+        darkStyles += `:host([scheme="dark"]){`;
+        darkStyles += config.rules.map((rule) => `
+                ${rule.light ? `
+                    .${NAMESPACE}-${cssPrefix}-${rule.token} {color: var(--${NAMESPACE}-${cssPrefix}-${rule.token},${rule.dark});}` : ``}`).join('\n');
+        darkStyles += `}`;
+        schemeStyles = `@media (prefers-color-scheme: dark){
+                                :host{
+            `;
+        schemeStyles += config.rules.map((rule) => `
+                ${rule.light ? `
+                    .${NAMESPACE}-${cssPrefix}-${rule.token} { color: var(--${NAMESPACE}-${cssPrefix}-${rule.token},${rule.dark}); }` : ``} `).join('\n');
+        schemeStyles += `}`;
         // Set the inner HTML of the shadow root, including styles and highlighted code
-        this.shadowRoot.innerHTML = `
-        <style>
-            :host { 
-                ${themeVars} 
-
-                font-size: var(--ax-code-fs,14px);
-                display: block; 
-                padding: var(--ax-code-p,1em);
-                box-sizing:border-box;
-                line-height: var(--ax-code-lh,1.5);
-                background-color:var(--ax-code-bg,rgba(0,0,0,0.02));
-                color:var(--ax-code-c,#333);
-                border:var(--ax-code-bw,1px) solid var(--ax-code-bc,rgba(0,0,0,0.08));
-                height:${height || 'var(--ax-code-h,auto)'};
-                max-height:${maxHeight || 'var(--ax-code-mh,500px)'};
-                overflow:auto;
-                transition: border-color 0.3s ease,color 0.3s ease;  
-                border-radius: var(--ax-code-r,9px);
-            }
-            pre,code{
-                font-family:"Consolas", "Monaco", "Andale Mono", "Ubuntu Mono", "monospace", "microsoft yahei", "Microsoft JhengHei", "Yu Mincho", "simsun";
-                margin:0;
-                padding:0;
-            }
-           
-            
-             
-            ${dynamicStyles}
-            
-            
-            ${config?.internalCss || ''}
-        </style>
-        <pre><code>${highlightedCode}</code></pre>`;
+        // 2. 精确更新 DOM 节点而非重写 ShadowRoot
+        this.dynamicStylesEl.textContent = lightStyles + darkStyles + schemeStyles;
+        //附加主题样式
+        if (config?.themeStyles) {
+            this.themeStylesEl.textContent = config.themeStyles;
+        }
+    }
+    updateName(config) {
+        if (this.hasAttribute('unnamed'))
+            return;
+        if (!config) {
+            this.codeNameEl.innerHTML = 'Plain Text';
+        }
+        else {
+            //更新别名
+            this.alias = config.alias || this.lang;
+            this.codeNameEl.innerHTML = this.alias;
+        }
     }
-}
-customElements.define('ax-code', Coax);
-Coax.register('html', {
-    rules: [
-        { name: 'comment', reg: /&lt;!--[\s\S]*?--&gt;/ },
-        { name: 'doctype', reg: /&lt;!DOCTYPE[\s\S]*?&gt;/i },
-        // 匹配标签名: <div, </div
-        { name: 'tag', reg: /&lt;\/?[a-zA-Z0-9]+/ },
-        // 匹配属性名: class=
-        { name: 'attr', reg: /[a-zA-Z-]+(?=\s*=\s*)/ },
-        // 匹配属性值: "value"
-        { name: 'string', reg: /(['"])(?:\\.|[^\\])*?\1/ },
-        // 匹配标签闭合: >, />
-        { name: 'bracket', reg: /\/?&gt;/ }
-    ],
-    //添加root变量：--ax-html-keyword
     
-});
-Coax.register('css', {
-    rules: [
-        { name: 'comment', reg: /\/\*[\s\S]*?\*\// },
-        { name: 'value', reg: /(?:'|")(?:\\.|[^\\'"\b])*?(?:'|")/ },
-        { name: 'func', reg: /[a-z-]+\(?=/ },
-        { name: 'property', reg: /[a-z-]+(?=\s*:)/ },
-        { name: 'selector', reg: /[.#a-z0-9, \n\t>:+()_-]+(?=\s*\{)/i },
-        { name: 'unit', reg: /(?<=\d)(px|em|rem|%|vh|vw|ms|s|deg)/ },
-        { name: 'number', reg: /\b\d+(\.\d+)?\b/ },
-        { name: 'punct', reg: /[{}();:]/ }
-    ],
-    //添加root变量：--ax-code-keyword
-    theme: {
-        'type': '#61afef', // 蓝色选择器
-        'keyword': '#d19a66', // 橙色属性名
-        'string': '#98c379', // 绿色属性值
-        'op': '#abb2bf' // 灰色符号
-    },
-    internalCss: `
-        .ax-css-string { color: var(--ax-code-string); }
-        .ax-css-string::first-letter { color: var(--ax-code-c); }
-    `
-});
-Coax.register('js', {
-    rules: [
-        { name: 'comment', reg: /\/\/[^\n]*|\/\*[\s\S]*?\*\// },
-        { name: 'string', reg: /(?:'|"|`)(?:\\.|[^\\'"\b])*?(?:'|"|`)/ },
-        { name: 'keyword', reg: /\b(async|await|break|case|catch|class|const|continue|default|delete|do|else|export|extends|finally|for|function|if|import|in|instanceof|new|return|super|switch|this|throw|try|typeof|var|while|with|yield|let|static)\b/ },
-        { name: 'builtin', reg: /\b(console|window|document|Math|JSON|true|false|null|undefined|Object|Array|Promise)\b/ },
-        { name: 'number', reg: /\b\d+\b/ },
-        { name: 'func', reg: /\b[a-zA-Z_]\w*(?=\s*\()/ },
-        { name: 'op', reg: /[+\-*/%=<>!&|^~]+/ }
-    ],
+    render(code = this.source) {
+        //同时多次改变属性，只执行一次
+        // 如果已经在队列中，则直接返回
+        if (this._renderQueued)
+            return;
+        this._renderQueued = true;
+        // 使用 requestAnimationFrame 将渲染推迟到下一帧
+        requestAnimationFrame(async () => {
+            this.clear();
+            this.injectThemeStyles();
+            //一次性渲染
+            await this.highlight(code);
+            this._renderQueued = false;
+        });
+    }
+    clear() {
+        this.highlightedCodeEl.innerHTML = this.source = this.lineString = '';
+    }
     
-});
-Coax.register('ts', {
-    rules: [
-        { name: 'comment', reg: /\/\/[^\n]*|\/\*[\s\S]*?\*\// },
-        { name: 'string', reg: /(?:'|"|`)(?:\\.|[^\\'"\b])*?(?:'|"|`)/ },
-        { name: 'decorator', reg: /@[a-zA-Z_]\w*/ },
-        { name: 'keyword', reg: /\b(abstract|as|async|await|break|case|catch|class|const|continue|debugger|declare|default|delete|do|else|enum|export|extends|finally|for|from|function|get|if|implements|import|in|instanceof|interface|is|keyof|let|module|namespace|new|package|private|protected|public|readonly|return|set|static|super|switch|this|throw|try|type|typeof|var|while|with|yield)\b/ },
-        { name: 'builtin', reg: /\b(any|boolean|never|number|string|symbol|unknown|void|undefined|null|boolean|true|false|console|window|document)\b/ },
-        { name: 'type', reg: /\b[A-Z]\w*\b/ },
-        { name: 'number', reg: /\b\d+\b/ },
-        { name: 'func', reg: /\b[a-zA-Z_]\w*(?=\s*\()/ },
-        { name: 'op', reg: /(\?\.|![:\.]|[+\-*/%=<>!&|^~]+)/ }
-    ],
+    async replace(newCode) {
+        this.clear();
+        await this.highlight(newCode);
+    }
     
-});
+    async append(newCode) {
+        // 将新的代码追加到现有代码末尾
+        this.source += `\n${newCode}`;
+        // 高亮新的部分
+        await this.highlight(newCode);
+    }
+    getActiveCodeWrap() {
+        const lastChild = this.highlightedCodeEl.lastElementChild, lastLine = !lastChild || this.highlightedCodeEl.lastElementChild?.completed ?
+            this.createLineWrap() : lastChild;
+        return {
+            lineWrap: lastLine,
+            codeWrap: lastLine.lastElementChild
+        };
+    }
+    closeLine(lineWrap) {
+        lineWrap = lineWrap || this.highlightedCodeEl.lastElementChild;
+        lineWrap && (lineWrap.completed = true);
+    }
+    openLine(lineWrap) {
+        lineWrap = lineWrap || this.highlightedCodeEl.lastElementChild;
+        lineWrap && (lineWrap.completed = false);
+    }
+    stream(str, forceEnd = false) {
+        const { lineWrap, codeWrap } = this.getActiveCodeWrap();
+        this.highlightedCodeEl.appendChild(lineWrap);
+        //汇集
+        this.source += str;
+        //如果没有遇到换行符号，也可以强制结束
+        forceEnd && this.closeLine(lineWrap);
+        if (str.startsWith('\n') || str.startsWith('\r')) {
+            //标记完成
+            this.closeLine(lineWrap);
+            //渲染
+            this.getLineToFill(codeWrap, this.lineString);
+            //一行结束，清空临时行文本
+            this.lineString = '';
+        }
+        else {
+            //插入文本
+            codeWrap.innerHTML += str;
+            //临时保存行文本
+            this.lineString += str;
+        }
+        //滚动到最底部
+        this.autoScrollCode();
+    }
+}
+
+const css = [
+    { token: 'comment', pattern: /\/\*[\s\S]*?\*\//, light: '#6a737d', dark: '#8b949e' },
+    { token: 'value', pattern: /(?:'|")(?:\\.|[^\\'"\b])*?(?:'|")/, light: '#032f62', dark: '#a5d6ff' },
+    { token: 'func', pattern: /[a-z-]+\(?=/, light: '#e36209', dark: '#ffa657' },
+    { token: 'property', pattern: /[a-z-]+(?=\s*:)/, light: '#005cc5', dark: '#79c0ff' },
+    { token: 'selector', pattern: /[.#a-z0-9, \n\t>:+()_-]+(?=\s*\{)/i, light: '#22863a', dark: '#7ee787' },
+    { token: 'unit', pattern: /(?<=\d)(px|em|rem|%|vh|vw|ms|s|deg)/, light: '#d73a49', dark: '#ff7b72' },
+    { token: 'number', pattern: /\b\d+(\.\d+)?\b/, light: '#005cc5', dark: '#79c0ff' },
+    { token: 'punct', pattern: /[{}();:]/, light: '#24292e', dark: '#c9d1d9' }
+];
+
+const html = [
+    { token: 'comment', pattern: /&lt;!--[\s\S]*?--&gt;/, light: '#999999', dark: '#6e7681' },
+    { token: 'doctype', pattern: /&lt;!DOCTYPE[\s\S]*?&gt;/i, light: '#6a737d', dark: '#8b949e' },
+    // 匹配标签名: <div, </div
+    { token: 'tag', pattern: /&lt;\/?[a-zA-Z0-9]+/, light: '#22863a', dark: '#7ee787' },
+    // 匹配属性名: class=
+    { token: 'attr', pattern: /[a-zA-Z-]+(?=\s*=\s*)/, light: '#6f42c1', dark: '#d2a8ff' },
+    // 匹配属性值: "value"
+    { token: 'string', pattern: /(['"])(?:\\.|[^\\])*?\1/, light: '#032f62', dark: '#a5d6ff' },
+    // 匹配标签闭合: >, />
+    { token: 'bracket', pattern: /\/?&gt;/, light: '#24292e', dark: '#c9d1d9' }
+];
+
+const javascript = [
+    { token: 'comment', pattern: /\/\/[^\n]*|\/\*[\s\S]*?\*\//, light: '#6a737d', dark: '#8b949e' },
+    { token: 'string', pattern: /(?:'|"|`)(?:\\.|[^\\'"\b])*?(?:'|"|`)/, light: '#032f62', dark: '#98c379' },
+    { token: 'keyword', pattern: /\b(async|await|break|case|catch|class|const|continue|default|delete|do|else|export|extends|finally|for|function|if|import|in|instanceof|new|return|super|switch|this|throw|try|typeof|var|while|with|yield|let|static)\b/, light: '#d73a49', dark: '#ff7b72' },
+    { token: 'builtin', pattern: /\b(console|window|document|Math|JSON|true|false|null|undefined|Object|Array|Promise|Number|String|Boolean)\b/, light: '#e36209', dark: '#ffa657' },
+    { token: 'number', pattern: /\b(0x[\da-fA-F]+|0b[01]+|\d+(\.\d+)?)\b/, light: '#005cc5', dark: '#79c0ff' },
+    { token: 'func', pattern: /\b[a-zA-Z_]\w*(?=\s*\()/, light: '#6f42c1', dark: '#d2a8ff' },
+    { token: 'op', pattern: /[+\-*/%=<>!&|^~]+/, light: '#069598', dark: '#56b6c2' }
+];
+
+const markdown = [
+    // 注释: 这是 Markdown 中的行内注释
+    { token: 'comment', pattern: /<!--[\s\S]*?-->/, light: '#6a737d', dark: '#8b949e' },
+    // 标题: 通过 `#` 来定义标题
+    { token: 'heading', pattern: /(^|\n)(#{1,6})\s*(.+)/, light: '#e36209', dark: '#ffa657' },
+    // 粗体: **text** 或 __text__
+    { token: 'bold', pattern: /\*\*([^*]+)\*\*|__([^_]+)__/g, light: '#d73a49', dark: '#ff7b72' },
+    // 斜体: *text* 或 _text_
+    { token: 'italic', pattern: /\*([^*]+)\*|_([^_]+)_/g, light: '#032f62', dark: '#a5d6ff' },
+    // 链接: [text](url)
+    { token: 'link', pattern: /\[([^\]]+)\]\(([^)]+)\)/g, light: '#0288d1', dark: '#80c0ff' },
+    // 行内代码: `code`
+    { token: 'inline-code', pattern: /`([^`]+)`/g, light: '#032f62', dark: '#98c379' },
+    // 代码块: ```code```
+    { token: 'code-block', pattern: /```([^\n]+)\n([\s\S]*?)```/g, light: '#24292e', dark: '#c9d1d9' },
+    // 列表项: - item 或 * item
+    { token: 'list-item', pattern: /(^|\n)([-*])\s+(.+)/g, light: '#5c6e7c', dark: '#8b949e' },
+    // 引用: > text
+    { token: 'quote', pattern: /(^|\n)>[ \t]*(.+)/g, light: '#6f42c1', dark: '#d2a8ff' },
+    // 图片: ![alt](url)
+    { token: 'image', pattern: /!\[([^\]]+)\]\(([^)]+)\)/g, light: '#d73a49', dark: '#ff7b72' },
+    // 分割线: ---
+    { token: 'hr', pattern: /^(---|___|\*\*\*)\s*$/gm, light: '#24292e', dark: '#c9d1d9' },
+    // 强调和删除: ~~text~~
+    { token: 'strikethrough', pattern: /~~([^~]+)~~/g, light: '#e36209', dark: '#ffa657' },
+    // 表格: | header1 | header2 |
+    { token: 'table', pattern: /\|([^\|]+)\|([^\|]+)\|/g, light: '#5c6e7c', dark: '#8b949e' }
+];
+
+const typescript = [
+    { token: 'comment', pattern: /\/\/[^\n]*|\/\*[\s\S]*?\*\//, light: '#6a737d', dark: '#8b949e' },
+    { token: 'string', pattern: /(?:'|"|`)(?:\\.|[^\\'"\b])*?(?:'|"|`)/, light: '#032f62', dark: '#98c379' },
+    { token: 'decorator', pattern: /@[a-zA-Z_]\w*/, light: '#953800', dark: '#ffa657' },
+    { token: 'keyword', pattern: /\b(abstract|as|async|await|break|case|catch|class|const|continue|debugger|declare|default|delete|do|else|enum|export|extends|finally|for|from|function|get|if|implements|import|in|instanceof|interface|is|keyof|let|module|namespace|new|package|private|protected|public|readonly|return|set|static|super|switch|this|throw|try|type|typeof|var|while|with|yield)\b/, light: '#d73a49', dark: '#ff7b72' },
+    { token: 'builtin', pattern: /\b(any|boolean|never|number|string|symbol|unknown|void|undefined|null|true|false|console|window|document)\b/, light: '#e36209', dark: '#ffa657' },
+    { token: 'type', pattern: /\b[A-Z]\w*\b/, light: '#005cc5', dark: '#79c0ff' },
+    { token: 'number', pattern: /\b(0x[\da-fA-F]+|0b[01]+|\d+(\.\d+)?)\b/, light: '#005cc5', dark: '#79c0ff' },
+    { token: 'func', pattern: /\b[a-zA-Z_]\w*(?=\s*\()/, light: '#6f42c1', dark: '#d2a8ff' },
+    { token: 'op', pattern: /(\?\.|![:\.]|[+\-*/%=<>!&|^~]+)/, light: '#089ba6', dark: '#79c0ff' }
+];
+
+const COMMA = ',';
+
+const SPACE = ' ';
+
+const trim = (str, placement = '') => {
+    if (typeof str !== 'string') {
+        console.warn('Expected a string input');
+        return '';
+    }
+    switch (placement) {
+        case 'start':
+            return str.trimStart();
+        case 'end':
+            return str.trimEnd();
+        case 'both':
+            return str.trim();
+        case 'global':
+            return str.replace(/[\s\r\n]+/g, '');
+        default:
+            return str.trim().replace(/[\s\r\n]+/g, ' '); // Default behavior, trims both ends and replaces inner spaces
+    }
+};
+
+const parseClasses = (data) => {
+    let separator, result = [];
+    if (Array.isArray(data)) {
+        // If data is already an array, filter out invalid values
+        result = data.filter((k) => k && typeof k === 'string');
+    }
+    else {
+        // Trim the input string and handle multiple spaces
+        data = trim(data);
+        // Use comma as the separator if present, otherwise use space
+        separator = data.includes(COMMA) ? COMMA : SPACE;
+        result = data.split(separator);
+    }
+    // Trim each item globally and filter out any empty strings
+    return result.map((k) => trim(k, 'global')).filter(Boolean);
+};
+
+const rtlStyle = (name = '') => `
+            <style>
+                :where([dir="rtl"]) .icax-${name},
+                :where(:dir(rtl)) .icax-${name} {
+                    transform: scaleX(-1);
+                    transform-origin: center;
+                }
+            </style>
+`;
+
+const wrap = (content, fun, isRtl = false, options) => {
+    const size = options?.size || '1em', color = options?.color || 'currentColor', thickness = options?.thickness || 2, classes = options?.classes ? parseClasses(options.classes).join(' ') : '', 
+    // 得到 "icax-left"
+    origName = fun.name.replace(/([A-Z])/g, "-$1").toLowerCase();
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${size}" height="${size}" viewBox="0 0 24 24" fill="none" stroke="${color}"
+          stroke-width="${thickness}" stroke-linecap="round" stroke-linejoin="round" class="${origName} ${classes}">
+          ${isRtl ? rtlStyle(origName.split('-')[1]) : ''}
+          ${content}
+      </svg>`;
+};
+
+const icaxCheck = (options) => wrap(`<polyline points="20 6 9 17 4 12"></polyline>`, icaxCheck, false, options);
+
+const icaxCopy = (options) => wrap(`<rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path>`, icaxCopy, false, options);
+
+const copy = {
+    name: 'copy',
+    icon: icaxCopy(),
+    action: function (arg) {
+        arg.wrapEl.onclick = () => {
+            //this只是组件实例
+            navigator.clipboard.writeText(this.source)
+                .then(() => {
+                console.log('Text successfully copied to clipboard');
+                arg.iconEl.innerHTML = icaxCheck();
+                arg.iconEl.toggleAttribute('disabled', true);
+                setTimeout(() => {
+                    //恢复
+                    arg.iconEl.removeAttribute('disabled');
+                    arg.iconEl.innerHTML = icaxCopy();
+                }, 2000);
+            })
+                .catch(err => {
+                console.error('Error copying text to clipboard: ', err);
+            });
+        };
+    }
+};
+
+export { CoaxElem, copy, css, html, javascript, markdown, typescript };