@codady/coax 0.0.1 → 0.0.3

package/dist/coax.umd.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,173 +14,884 @@
  * @license MIT license
  */
 
-(function (factory) {
+(function (global, factory) {
+    typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
     typeof define === 'function' && define.amd ? define(factory) :
-    factory();
-})((function () { 'use strict';
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.coax = factory());
+})(this, (function () { 'use strict';
 
-    class Coax extends HTMLElement {
+    const NAMESPACE = 'ax';
+
+    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 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;
+            }
+        }
+        
+        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 = '';
+        }
+        
+        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();
         }
     }
-    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
+
+    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);
+                });
+            };
+        }
+    };
+
+    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 Coax = CoaxElem;
+    //注册语言类型
+    Coax.register('css', {
+        alias: 'CSS',
+        rules: css,
         
     });
-    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('html', {
+        alias: 'HTML',
+        rules: html,
     });
     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: /[+\-*/%=<>!&|^~]+/ }
-        ],
-        
+        alias: 'Javascript',
+        rules: javascript,
     });
     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: /(\?\.|![:\.]|[+\-*/%=<>!&|^~]+)/ }
-        ],
-        
+        alias: 'Typescript',
+        rules: typescript,
+    });
+    Coax.register('md', {
+        alias: 'Markdown',
+        rules: markdown
     });
+    //注册工具箱
+    Coax.addTools([copy]);
+    customElements.define(`${NAMESPACE}-code`, Coax);
+
+    return Coax;
 
 }));