huibo-ui 0.3.0

package/dist/collection/components/Watermark/Watermark.js

@@ -0,0 +1,205 @@
+import { h } from "@stencil/core";
+/**
+ * Watermark 水印组件
+ * 在内容之上平铺一层文字水印，常用于版权/防泄密标识
+ */
+export class Watermark {
+    host;
+    /** 水印文字 */
+    content = '';
+    /** 单个水印单元宽度 */
+    width = 120;
+    /** 单个水印单元高度 */
+    height = 120;
+    /** 水印单元之间的间距 */
+    gap = 8;
+    /** 旋转角度 */
+    rotate = -22;
+    /** 字体颜色 */
+    fontColor = 'rgba(0,0,0,0.15)';
+    /** 字号 */
+    fontSize = 14;
+    get backgroundImage() {
+        const { width, height, content, fontColor, fontSize, rotate } = this;
+        const safeText = this.escapeXml(content || '');
+        const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}"><text x="50%" y="50%" dy="${fontSize / 4}" text-anchor="middle" fill="${fontColor}" font-size="${fontSize}" font-family="sans-serif" transform="rotate(${rotate} ${width / 2} ${height / 2})">${safeText}</text></svg>`;
+        return `url("data:image/svg+xml;utf8,${encodeURIComponent(svg)}")`;
+    }
+    escapeXml(input) {
+        return input
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&apos;');
+    }
+    get layerStyle() {
+        const { backgroundImage, width, height, gap } = this;
+        return {
+            backgroundImage,
+            backgroundRepeat: 'repeat',
+            backgroundSize: `${width + gap}px ${height + gap}px`,
+        };
+    }
+    render() {
+        return (h("div", { key: '558715dfd1fb81bab3dace29384aedaf21695cdf', class: "hb-watermark" }, h("div", { key: '26c580f3327e7018425c5e4556b19c9947212ae9', class: "hb-watermark__content" }, h("slot", { key: 'ff91c80742bd753daeef67c4b50b5d2cfec8d4b9' })), h("div", { key: 'c1dc15846f1e6ffa9d0ee968f87deb342bd13176', class: "hb-watermark__layer", style: this.layerStyle, "aria-hidden": "true" })));
+    }
+    static get is() { return "hb-watermark"; }
+    static get encapsulation() { return "shadow"; }
+    static get originalStyleUrls() {
+        return {
+            "$": ["watermark.css"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "$": ["watermark.css"]
+        };
+    }
+    static get properties() {
+        return {
+            "content": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "\u6C34\u5370\u6587\u5B57"
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "content",
+                "reflect": false,
+                "defaultValue": "''"
+            },
+            "width": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "\u5355\u4E2A\u6C34\u5370\u5355\u5143\u5BBD\u5EA6"
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "width",
+                "reflect": false,
+                "defaultValue": "120"
+            },
+            "height": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "\u5355\u4E2A\u6C34\u5370\u5355\u5143\u9AD8\u5EA6"
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "height",
+                "reflect": false,
+                "defaultValue": "120"
+            },
+            "gap": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "\u6C34\u5370\u5355\u5143\u4E4B\u95F4\u7684\u95F4\u8DDD"
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "gap",
+                "reflect": false,
+                "defaultValue": "8"
+            },
+            "rotate": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "\u65CB\u8F6C\u89D2\u5EA6"
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "rotate",
+                "reflect": false,
+                "defaultValue": "-22"
+            },
+            "fontColor": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "\u5B57\u4F53\u989C\u8272"
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "font-color",
+                "reflect": false,
+                "defaultValue": "'rgba(0,0,0,0.15)'"
+            },
+            "fontSize": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "\u5B57\u53F7"
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "font-size",
+                "reflect": false,
+                "defaultValue": "14"
+            }
+        };
+    }
+    static get elementRef() { return "host"; }
+}
+//# sourceMappingURL=Watermark.js.map

package/dist/collection/components/Watermark/Watermark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Watermark.js","sourceRoot":"","sources":["../../../src/components/Watermark/Watermark.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE5D;;;GAGG;AAMH,MAAM,OAAO,SAAS;IACT,IAAI,CAAe;IAE9B,WAAW;IACH,OAAO,GAAW,EAAE,CAAC;IAE7B,eAAe;IACP,KAAK,GAAW,GAAG,CAAC;IAE5B,eAAe;IACP,MAAM,GAAW,GAAG,CAAC;IAE7B,gBAAgB;IACR,GAAG,GAAW,CAAC,CAAC;IAExB,WAAW;IACH,MAAM,GAAW,CAAC,EAAE,CAAC;IAE7B,WAAW;IACH,SAAS,GAAW,kBAAkB,CAAC;IAE/C,SAAS;IACD,QAAQ,GAAW,EAAE,CAAC;IAE9B,IAAY,eAAe;QACzB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,kDAAkD,KAAK,aAAa,MAAM,kBAAkB,KAAK,IAAI,MAAM,+BAA+B,QAAQ,GAAG,CAAC,gCAAgC,SAAS,gBAAgB,QAAQ,gDAAgD,MAAM,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,MAAM,QAAQ,eAAe,CAAC;QAClV,OAAO,gCAAgC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC;IACrE,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,OAAO,KAAK;aACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;aACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;aACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;aACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;aACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,IAAY,UAAU;QACpB,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrD,OAAO;YACL,eAAe;YACf,gBAAgB,EAAE,QAAQ;YAC1B,cAAc,EAAE,GAAG,KAAK,GAAG,GAAG,MAAM,MAAM,GAAG,GAAG,IAAI;SACrD,CAAC;IACJ,CAAC;IAED,MAAM;QACJ,OAAO,CACL,4DAAK,KAAK,EAAC,cAAc;YACvB,4DAAK,KAAK,EAAC,uBAAuB;gBAChC,8DAAQ,CACJ;YACN,4DAAK,KAAK,EAAC,qBAAqB,EAAC,KAAK,EAAE,IAAI,CAAC,UAAU,iBAAc,MAAM,GAAO,CAC9E,CACP,CAAC;IACJ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CACF","sourcesContent":["import { Component, h, Prop, Element } from '@stencil/core';\n\n/**\n * Watermark 水印组件\n * 在内容之上平铺一层文字水印，常用于版权/防泄密标识\n */\n@Component({\n  tag: 'hb-watermark',\n  styleUrl: 'watermark.css',\n  shadow: true,\n})\nexport class Watermark {\n  @Element() host!: HTMLElement;\n\n  /** 水印文字 */\n  @Prop() content: string = '';\n\n  /** 单个水印单元宽度 */\n  @Prop() width: number = 120;\n\n  /** 单个水印单元高度 */\n  @Prop() height: number = 120;\n\n  /** 水印单元之间的间距 */\n  @Prop() gap: number = 8;\n\n  /** 旋转角度 */\n  @Prop() rotate: number = -22;\n\n  /** 字体颜色 */\n  @Prop() fontColor: string = 'rgba(0,0,0,0.15)';\n\n  /** 字号 */\n  @Prop() fontSize: number = 14;\n\n  private get backgroundImage(): string {\n    const { width, height, content, fontColor, fontSize, rotate } = this;\n    const safeText = this.escapeXml(content || '');\n    const svg = `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${width}\" height=\"${height}\" viewBox=\"0 0 ${width} ${height}\"><text x=\"50%\" y=\"50%\" dy=\"${fontSize / 4}\" text-anchor=\"middle\" fill=\"${fontColor}\" font-size=\"${fontSize}\" font-family=\"sans-serif\" transform=\"rotate(${rotate} ${width / 2} ${height / 2})\">${safeText}</text></svg>`;\n    return `url(\"data:image/svg+xml;utf8,${encodeURIComponent(svg)}\")`;\n  }\n\n  private escapeXml(input: string): string {\n    return input\n      .replace(/&/g, '&amp;')\n      .replace(/</g, '&lt;')\n      .replace(/>/g, '&gt;')\n      .replace(/\"/g, '&quot;')\n      .replace(/'/g, '&apos;');\n  }\n\n  private get layerStyle(): Record<string, string> {\n    const { backgroundImage, width, height, gap } = this;\n    return {\n      backgroundImage,\n      backgroundRepeat: 'repeat',\n      backgroundSize: `${width + gap}px ${height + gap}px`,\n    };\n  }\n\n  render() {\n    return (\n      <div class=\"hb-watermark\">\n        <div class=\"hb-watermark__content\">\n          <slot />\n        </div>\n        <div class=\"hb-watermark__layer\" style={this.layerStyle} aria-hidden=\"true\"></div>\n      </div>\n    );\n  }\n}\n"]}

package/dist/collection/components/Watermark/watermark.css

@@ -0,0 +1,26 @@
+:host {
+  position: relative;
+  display: block;
+}
+
+.hb-watermark {
+  position: relative;
+  display: block;
+  width: 100%;
+}
+
+.hb-watermark__content {
+  position: relative;
+  z-index: 1;
+}
+
+.hb-watermark__layer {
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  z-index: 9;
+  pointer-events: none;
+  background-position: 0 0;
+}

package/dist/collection/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/collection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG","sourcesContent":["/**\n * @fileoverview entry point for your component library\n *\n * This is the entry point for your component library. Use this file to export utilities,\n * constants or data structure that accompany your components.\n *\n * DO NOT use this file to export your components. Instead, use the recommended approaches\n * to consume components of this package as outlined in the `README.md`.\n */\n\nexport type * from './components.d.ts';\n"]}

package/dist/collection/utils/a11y.js

@@ -0,0 +1,130 @@
+/**
+ * 无障碍（a11y）工具集
+ * 统一 ARIA 属性辅助、焦点陷阱、列表键盘导航等在交互组件（Dialog / Drawer / Menu /
+ * Dropdown / Select 等）中重复出现且容易写错的可访问性逻辑。
+ *
+ * 参考标准：WAI-ARIA Authoring Practices 1.2。
+ */
+/** 判定按键是否为「激活」键（Enter / Space），用于自定义可聚焦元素的点击替代 */
+export function isActivationKey(key) {
+    return key === 'Enter' || key === ' ' || key === 'Spacebar';
+}
+/** 查询容器内可聚焦的元素顺序（tabindex >= 0 的语义元素） */
+const FOCUSABLE_SELECTOR = [
+    'a[href]',
+    'button:not([disabled])',
+    'textarea:not([disabled])',
+    'input:not([disabled])',
+    'select:not([disabled])',
+    '[tabindex]:not([tabindex="-1"])',
+    '[contenteditable="true"]',
+].join(',');
+export function getFocusableElements(container) {
+    return Array.from(container.querySelectorAll(FOCUSABLE_SELECTOR)).filter((el) => el.getAttribute('aria-hidden') !== 'true' && el.style.display !== 'none');
+}
+/**
+ * 创建焦点陷阱（Dialog / Drawer 打开时把 Tab 循环限制在容器内）。
+ * 关键点：Tab 与 Shift+Tab 在容器边界时回环到另一端，防止焦点逃逸到背景。
+ * 返回句柄，组件在打开时 connect()、关闭时 disconnect()。
+ */
+export function createFocusTrap(options) {
+    const { container, autoFocus = true, returnFocusTo } = options;
+    let active = false;
+    let previouslyFocused = null;
+    const handleKeydown = (e) => {
+        if (e.key !== 'Tab')
+            return;
+        const focusable = getFocusableElements(container);
+        if (focusable.length === 0) {
+            e.preventDefault();
+            container.focus();
+            return;
+        }
+        const first = focusable[0];
+        const last = focusable[focusable.length - 1];
+        const activeEl = document.activeElement;
+        if (e.shiftKey) {
+            if (activeEl === first || !container.contains(activeEl)) {
+                e.preventDefault();
+                last.focus();
+            }
+        }
+        else {
+            if (activeEl === last) {
+                e.preventDefault();
+                first.focus();
+            }
+        }
+    };
+    const connect = () => {
+        if (active)
+            return;
+        active = true;
+        previouslyFocused = (returnFocusTo ?? document.activeElement);
+        container.addEventListener('keydown', handleKeydown);
+        if (autoFocus) {
+            const focusable = getFocusableElements(container);
+            (focusable[0] ?? container).focus();
+        }
+    };
+    const disconnect = () => {
+        if (!active)
+            return;
+        active = false;
+        container.removeEventListener('keydown', handleKeydown);
+        if (previouslyFocused && typeof previouslyFocused.focus === 'function') {
+            previouslyFocused.focus();
+        }
+        previouslyFocused = null;
+    };
+    return { connect, disconnect };
+}
+/**
+ * 列表 / 菜单 / 下拉选项的键盘导航核心逻辑（listbox / menu / combobox 通用）。
+ * 返回应执行的动作，由调用方据此更新 activeIndex / 触发选中 / 关闭。
+ *
+ * 支持：ArrowDown/ArrowUp（竖排）/ArrowRight/ArrowLeft（横排）移动、Home/End 跳首尾、
+ * Enter/Space 选中、Escape 关闭。
+ */
+export function handleListKeyboard(event, options) {
+    const { activeIndex, itemCount, loop = true } = options;
+    if (itemCount <= 0)
+        return { type: 'none' };
+    const clamp = (idx) => (idx + itemCount) % itemCount;
+    const within = (idx) => Math.max(0, Math.min(idx, itemCount - 1));
+    switch (event.key) {
+        case 'ArrowDown':
+        case 'ArrowRight':
+            return { type: 'navigate', index: loop ? clamp(activeIndex + 1) : within(activeIndex + 1) };
+        case 'ArrowUp':
+        case 'ArrowLeft':
+            return { type: 'navigate', index: loop ? clamp(activeIndex - 1) : within(activeIndex - 1) };
+        case 'Home':
+            return { type: 'navigate', index: 0 };
+        case 'End':
+            return { type: 'navigate', index: itemCount - 1 };
+        case 'Enter':
+        case ' ':
+        case 'Spacebar':
+            return activeIndex >= 0 ? { type: 'select', index: activeIndex } : { type: 'none' };
+        case 'Escape':
+            return { type: 'close' };
+        default:
+            return { type: 'none' };
+    }
+}
+/**
+ * 为元素批量设置 ARIA 属性（不可变：返回新映射，但直接操作 DOM 属性是 a11y 的固有需求）。
+ * 组件挂载后调用一次即可，避免每次 render 重复写 setAttribute。
+ */
+export function applyAria(el, attrs) {
+    Object.entries(attrs).forEach(([key, value]) => {
+        if (value === undefined || value === null) {
+            el.removeAttribute(`aria-${key}`);
+        }
+        else {
+            el.setAttribute(`aria-${key}`, String(value));
+        }
+    });
+}
+//# sourceMappingURL=a11y.js.map

package/dist/collection/utils/a11y.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.js","sourceRoot":"","sources":["../../src/utils/a11y.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 无障碍（a11y）工具集\n * 统一 ARIA 属性辅助、焦点陷阱、列表键盘导航等在交互组件（Dialog / Drawer / Menu /\n * Dropdown / Select 等）中重复出现且容易写错的可访问性逻辑。\n *\n * 参考标准：WAI-ARIA Authoring Practices 1.2。\n */\n\n/** 判定按键是否为「激活」键（Enter / Space），用于自定义可聚焦元素的点击替代 */\nexport function isActivationKey(key: string | undefined): boolean {\n  return key === 'Enter' || key === ' ' || key === 'Spacebar';\n}\n\n/** 查询容器内可聚焦的元素顺序（tabindex >= 0 的语义元素） */\nconst FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'button:not([disabled])',\n  'textarea:not([disabled])',\n  'input:not([disabled])',\n  'select:not([disabled])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  '[contenteditable=\"true\"]',\n].join(',');\n\nexport function getFocusableElements(container: HTMLElement): HTMLElement[] {\n  return Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter(\n    (el) => el.getAttribute('aria-hidden') !== 'true' && el.style.display !== 'none',\n  );\n}\n\n/** 焦点陷阱选项 */\nexport interface FocusTrapOptions {\n  /** 焦点受限的容器元素 */\n  container: HTMLElement;\n  /** 打开时是否自动聚焦容器内首个可聚焦元素 */\n  autoFocus?: boolean;\n  /** 容器激活前的元素（用于关闭时归还焦点） */\n  returnFocusTo?: HTMLElement | null;\n}\n\n/** 焦点陷阱句柄 */\nexport interface FocusTrap {\n  /** 启用：绑定 Tab 拦截，可选自动聚焦 */\n  connect: () => void;\n  /** 关闭：解除拦截，归还焦点 */\n  disconnect: () => void;\n}\n\n/**\n * 创建焦点陷阱（Dialog / Drawer 打开时把 Tab 循环限制在容器内）。\n * 关键点：Tab 与 Shift+Tab 在容器边界时回环到另一端，防止焦点逃逸到背景。\n * 返回句柄，组件在打开时 connect()、关闭时 disconnect()。\n */\nexport function createFocusTrap(options: FocusTrapOptions): FocusTrap {\n  const { container, autoFocus = true, returnFocusTo } = options;\n  let active = false;\n  let previouslyFocused: HTMLElement | null = null;\n\n  const handleKeydown = (e: KeyboardEvent) => {\n    if (e.key !== 'Tab') return;\n    const focusable = getFocusableElements(container);\n    if (focusable.length === 0) {\n      e.preventDefault();\n      container.focus();\n      return;\n    }\n    const first = focusable[0];\n    const last = focusable[focusable.length - 1];\n    const activeEl = document.activeElement;\n\n    if (e.shiftKey) {\n      if (activeEl === first || !container.contains(activeEl)) {\n        e.preventDefault();\n        last.focus();\n      }\n    } else {\n      if (activeEl === last) {\n        e.preventDefault();\n        first.focus();\n      }\n    }\n  };\n\n  const connect = () => {\n    if (active) return;\n    active = true;\n    previouslyFocused = (returnFocusTo ?? document.activeElement) as HTMLElement | null;\n    container.addEventListener('keydown', handleKeydown);\n    if (autoFocus) {\n      const focusable = getFocusableElements(container);\n      (focusable[0] ?? container).focus();\n    }\n  };\n\n  const disconnect = () => {\n    if (!active) return;\n    active = false;\n    container.removeEventListener('keydown', handleKeydown);\n    if (previouslyFocused && typeof previouslyFocused.focus === 'function') {\n      previouslyFocused.focus();\n    }\n    previouslyFocused = null;\n  };\n\n  return { connect, disconnect };\n}\n\n/** 列表键盘导航产生的动作 */\nexport type ListKeyAction =\n  | { type: 'navigate'; index: number }\n  | { type: 'select'; index: number }\n  | { type: 'close' }\n  | { type: 'none' };\n\n/** 列表键盘导航参数 */\nexport interface ListKeyboardOptions {\n  /** 当前高亮项索引（-1 表示无高亮） */\n  activeIndex: number;\n  /** 列表项总数 */\n  itemCount: number;\n  /** 是否允许循环（首尾跳转） */\n  loop?: boolean;\n}\n\n/**\n * 列表 / 菜单 / 下拉选项的键盘导航核心逻辑（listbox / menu / combobox 通用）。\n * 返回应执行的动作，由调用方据此更新 activeIndex / 触发选中 / 关闭。\n *\n * 支持：ArrowDown/ArrowUp（竖排）/ArrowRight/ArrowLeft（横排）移动、Home/End 跳首尾、\n * Enter/Space 选中、Escape 关闭。\n */\nexport function handleListKeyboard(event: KeyboardEvent, options: ListKeyboardOptions): ListKeyAction {\n  const { activeIndex, itemCount, loop = true } = options;\n  if (itemCount <= 0) return { type: 'none' };\n\n  const clamp = (idx: number) => (idx + itemCount) % itemCount;\n  const within = (idx: number) => Math.max(0, Math.min(idx, itemCount - 1));\n\n  switch (event.key) {\n    case 'ArrowDown':\n    case 'ArrowRight':\n      return { type: 'navigate', index: loop ? clamp(activeIndex + 1) : within(activeIndex + 1) };\n    case 'ArrowUp':\n    case 'ArrowLeft':\n      return { type: 'navigate', index: loop ? clamp(activeIndex - 1) : within(activeIndex - 1) };\n    case 'Home':\n      return { type: 'navigate', index: 0 };\n    case 'End':\n      return { type: 'navigate', index: itemCount - 1 };\n    case 'Enter':\n    case ' ':\n    case 'Spacebar':\n      return activeIndex >= 0 ? { type: 'select', index: activeIndex } : { type: 'none' };\n    case 'Escape':\n      return { type: 'close' };\n    default:\n      return { type: 'none' };\n  }\n}\n\n/**\n * 为元素批量设置 ARIA 属性（不可变：返回新映射，但直接操作 DOM 属性是 a11y 的固有需求）。\n * 组件挂载后调用一次即可，避免每次 render 重复写 setAttribute。\n */\nexport function applyAria(el: HTMLElement, attrs: Record<string, string | boolean | undefined>): void {\n  Object.entries(attrs).forEach(([key, value]) => {\n    if (value === undefined || value === null) {\n      el.removeAttribute(`aria-${key}`);\n    } else {\n      el.setAttribute(`aria-${key}`, String(value));\n    }\n  });\n}\n"]}

package/dist/collection/utils/click-outside.js

@@ -0,0 +1,22 @@
+/**
+ * 点击外部检测工具
+ * 统一管理 document click 事件监听，用于下拉/弹出组件的关闭逻辑
+ */
+/**
+ * 创建点击外部处理器
+ * 返回清理函数，用于在 disconnectedCallback 中移除监听
+ */
+export function createClickOutsideHandler(options) {
+    const handler = (e) => {
+        if (!options.isOpen())
+            return;
+        const target = e.target;
+        if (!options.host.contains(target)) {
+            options.onClose();
+        }
+    };
+    const connect = () => document.addEventListener('click', handler);
+    const disconnect = () => document.removeEventListener('click', handler);
+    return { connect, disconnect };
+}
+//# sourceMappingURL=click-outside.js.map

package/dist/collection/utils/click-outside.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"click-outside.js","sourceRoot":"","sources":["../../src/utils/click-outside.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAA4B;IACpE,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,EAAE;QAChC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,OAAO;QAC9B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAqB,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAExE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC","sourcesContent":["/**\n * 点击外部检测工具\n * 统一管理 document click 事件监听，用于下拉/弹出组件的关闭逻辑\n */\n\nexport interface ClickOutsideOptions {\n  /** 需要检测的宿主元素 */\n  host: HTMLElement;\n  /** 当前是否打开状态（避免不必要的检查） */\n  isOpen: () => boolean;\n  /** 关闭回调 */\n  onClose: () => void;\n}\n\n/**\n * 创建点击外部处理器\n * 返回清理函数，用于在 disconnectedCallback 中移除监听\n */\nexport function createClickOutsideHandler(options: ClickOutsideOptions) {\n  const handler = (e: MouseEvent) => {\n    if (!options.isOpen()) return;\n    const target = e.target as HTMLElement;\n    if (!options.host.contains(target)) {\n      options.onClose();\n    }\n  };\n\n  const connect = () => document.addEventListener('click', handler);\n  const disconnect = () => document.removeEventListener('click', handler);\n\n  return { connect, disconnect };\n}\n"]}

package/dist/collection/utils/date-helpers.js

@@ -0,0 +1,120 @@
+/**
+ * 日历和日期工具函数
+ * 从 DatePicker / DateTimePicker / DatePickerPane 中提取的共享逻辑
+ */
+/** 判断两个日期是否为同一天 */
+export function isSameDay(date1, date2) {
+    return (date1.getFullYear() === date2.getFullYear() &&
+        date1.getMonth() === date2.getMonth() &&
+        date1.getDate() === date2.getDate());
+}
+/** 生成 42 天（6 周）的日历网格数据 */
+export function getCalendarDays(viewDate, selectedDate, today = new Date()) {
+    const days = [];
+    const year = viewDate.getFullYear();
+    const month = viewDate.getMonth();
+    const firstDay = new Date(year, month, 1);
+    const lastDay = new Date(year, month + 1, 0);
+    const firstDayWeek = firstDay.getDay();
+    const daysInMonth = lastDay.getDate();
+    // 上月填充
+    const prevMonth = new Date(year, month - 1, 0);
+    for (let i = firstDayWeek - 1; i >= 0; i--) {
+        const date = new Date(year, month - 1, prevMonth.getDate() - i);
+        days.push({
+            date,
+            isCurrentMonth: false,
+            isToday: isSameDay(date, today),
+            isSelected: !!selectedDate && isSameDay(date, selectedDate),
+        });
+    }
+    // 当月日期
+    for (let i = 1; i <= daysInMonth; i++) {
+        const date = new Date(year, month, i);
+        days.push({
+            date,
+            isCurrentMonth: true,
+            isToday: isSameDay(date, today),
+            isSelected: !!selectedDate && isSameDay(date, selectedDate),
+        });
+    }
+    // 下月填充（补齐 42 天）
+    const remainingDays = 42 - days.length;
+    for (let i = 1; i <= remainingDays; i++) {
+        const date = new Date(year, month + 1, i);
+        days.push({
+            date,
+            isCurrentMonth: false,
+            isToday: isSameDay(date, today),
+            isSelected: !!selectedDate && isSameDay(date, selectedDate),
+        });
+    }
+    return days;
+}
+/**
+ * 格式化日期为指定格式字符串
+ * 支持：YYYY, MM, DD, HH, mm, ss
+ */
+export function formatDate(date, format) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    const hours = String(date.getHours()).padStart(2, '0');
+    const minutes = String(date.getMinutes()).padStart(2, '0');
+    const seconds = String(date.getSeconds()).padStart(2, '0');
+    return format
+        .replace('YYYY', String(year))
+        .replace('MM', month)
+        .replace('DD', day)
+        .replace('HH', hours)
+        .replace('mm', minutes)
+        .replace('ss', seconds);
+}
+/** 安全解析日期值 */
+export function parseDate(value) {
+    if (!value)
+        return undefined;
+    const date = value instanceof Date ? value : new Date(value);
+    if (isNaN(date.getTime()))
+        return undefined;
+    return date;
+}
+/** 月份偏移，返回新日期对象（不可变） */
+export function addMonths(date, delta) {
+    const result = new Date(date);
+    result.setMonth(result.getMonth() + delta);
+    return result;
+}
+/** 年份偏移，返回新日期对象（不可变） */
+export function addYears(date, delta) {
+    const result = new Date(date);
+    result.setFullYear(result.getFullYear() + delta);
+    return result;
+}
+export function getCalendarYears(viewDate, selectedDate, startYearBase) {
+    const year = viewDate.getFullYear();
+    const rangeStart = startYearBase ?? year - (year % 12);
+    const years = [];
+    for (let i = 0; i < 12; i++) {
+        const y = rangeStart + i;
+        years.push({
+            year: y,
+            isCurrentYearRange: y === year,
+            isSelected: !!selectedDate && selectedDate.getFullYear() === y,
+        });
+    }
+    return years;
+}
+/** 获取 years 视图标题所显示的年份档区间起点 */
+export function getYearRangeStart(viewDate) {
+    const year = viewDate.getFullYear();
+    return year - (year % 12);
+}
+/** 中文月份名称 */
+export const MONTH_NAMES = [
+    '一月', '二月', '三月', '四月', '五月', '六月',
+    '七月', '八月', '九月', '十月', '十一月', '十二月',
+];
+/** 中文星期名称 */
+export const WEEK_DAY_NAMES = ['日', '一', '二', '三', '四', '五', '六'];
+//# sourceMappingURL=date-helpers.js.map

package/dist/collection/utils/date-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-helpers.js","sourceRoot":"","sources":["../../src/utils/date-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 日历和日期工具函数\n * 从 DatePicker / DateTimePicker / DatePickerPane 中提取的共享逻辑\n */\n\nexport interface CalendarDay {\n  date: Date;\n  isCurrentMonth: boolean;\n  isToday: boolean;\n  isSelected: boolean;\n}\n\n/** 判断两个日期是否为同一天 */\nexport function isSameDay(date1: Date, date2: Date): boolean {\n  return (\n    date1.getFullYear() === date2.getFullYear() &&\n    date1.getMonth() === date2.getMonth() &&\n    date1.getDate() === date2.getDate()\n  );\n}\n\n/** 生成 42 天（6 周）的日历网格数据 */\nexport function getCalendarDays(\n  viewDate: Date,\n  selectedDate?: Date,\n  today: Date = new Date()\n): CalendarDay[] {\n  const days: CalendarDay[] = [];\n  const year = viewDate.getFullYear();\n  const month = viewDate.getMonth();\n\n  const firstDay = new Date(year, month, 1);\n  const lastDay = new Date(year, month + 1, 0);\n  const firstDayWeek = firstDay.getDay();\n  const daysInMonth = lastDay.getDate();\n\n  // 上月填充\n  const prevMonth = new Date(year, month - 1, 0);\n  for (let i = firstDayWeek - 1; i >= 0; i--) {\n    const date = new Date(year, month - 1, prevMonth.getDate() - i);\n    days.push({\n      date,\n      isCurrentMonth: false,\n      isToday: isSameDay(date, today),\n      isSelected: !!selectedDate && isSameDay(date, selectedDate),\n    });\n  }\n\n  // 当月日期\n  for (let i = 1; i <= daysInMonth; i++) {\n    const date = new Date(year, month, i);\n    days.push({\n      date,\n      isCurrentMonth: true,\n      isToday: isSameDay(date, today),\n      isSelected: !!selectedDate && isSameDay(date, selectedDate),\n    });\n  }\n\n  // 下月填充（补齐 42 天）\n  const remainingDays = 42 - days.length;\n  for (let i = 1; i <= remainingDays; i++) {\n    const date = new Date(year, month + 1, i);\n    days.push({\n      date,\n      isCurrentMonth: false,\n      isToday: isSameDay(date, today),\n      isSelected: !!selectedDate && isSameDay(date, selectedDate),\n    });\n  }\n\n  return days;\n}\n\n/**\n * 格式化日期为指定格式字符串\n * 支持：YYYY, MM, DD, HH, mm, ss\n */\nexport function formatDate(date: Date, format: string): string {\n  const year = date.getFullYear();\n  const month = String(date.getMonth() + 1).padStart(2, '0');\n  const day = String(date.getDate()).padStart(2, '0');\n  const hours = String(date.getHours()).padStart(2, '0');\n  const minutes = String(date.getMinutes()).padStart(2, '0');\n  const seconds = String(date.getSeconds()).padStart(2, '0');\n\n  return format\n    .replace('YYYY', String(year))\n    .replace('MM', month)\n    .replace('DD', day)\n    .replace('HH', hours)\n    .replace('mm', minutes)\n    .replace('ss', seconds);\n}\n\n/** 安全解析日期值 */\nexport function parseDate(value: string | Date | undefined): Date | undefined {\n  if (!value) return undefined;\n  const date = value instanceof Date ? value : new Date(value);\n  if (isNaN(date.getTime())) return undefined;\n  return date;\n}\n\n/** 月份偏移，返回新日期对象（不可变） */\nexport function addMonths(date: Date, delta: number): Date {\n  const result = new Date(date);\n  result.setMonth(result.getMonth() + delta);\n  return result;\n}\n\n/** 年份偏移，返回新日期对象（不可变） */\nexport function addYears(date: Date, delta: number): Date {\n  const result = new Date(date);\n  result.setFullYear(result.getFullYear() + delta);\n  return result;\n}\n\n/**\n * 生成 years 视图的 12 年档数据（每档 12 年）。\n * 以 viewDate 所在年份向下取整到 12 的倍数作为起点。\n */\nexport interface CalendarYear {\n  year: number;\n  isCurrentYearRange: boolean;\n  isSelected: boolean;\n}\n\nexport function getCalendarYears(\n  viewDate: Date,\n  selectedDate?: Date,\n  startYearBase?: number\n): CalendarYear[] {\n  const year = viewDate.getFullYear();\n  const rangeStart = startYearBase ?? year - (year % 12);\n  const years: CalendarYear[] = [];\n  for (let i = 0; i < 12; i++) {\n    const y = rangeStart + i;\n    years.push({\n      year: y,\n      isCurrentYearRange: y === year,\n      isSelected: !!selectedDate && selectedDate.getFullYear() === y,\n    });\n  }\n  return years;\n}\n\n/** 获取 years 视图标题所显示的年份档区间起点 */\nexport function getYearRangeStart(viewDate: Date): number {\n  const year = viewDate.getFullYear();\n  return year - (year % 12);\n}\n\n/** 中文月份名称 */\nexport const MONTH_NAMES = [\n  '一月', '二月', '三月', '四月', '五月', '六月',\n  '七月', '八月', '九月', '十月', '十一月', '十二月',\n];\n\n/** 中文星期名称 */\nexport const WEEK_DAY_NAMES = ['日', '一', '二', '三', '四', '五', '六'];\n"]}

package/dist/collection/utils/form-input-base.js

@@ -0,0 +1,48 @@
+/**
+ * 表单输入组件共享基础
+ * 统一 size / disabled / clearable / modelValue 这一组在 Input / Select / Cascader /
+ * DatePicker / InputNumber / TimePicker 等组件中重复出现的包装模式。
+ *
+ * 设计原则：纯函数 + 类型导出，不引入基类继承，避免 Stencil 装饰器在继承链上的隐式行为。
+ * 组件按需 import 对应工具，渲染时调用即可。
+ */
+/** 全部合法尺寸，用于运行期校验 */
+export const COMPONENT_SIZES = ['large', 'default', 'small'];
+/**
+ * 生成尺寸 class 名：buildSizeClass('hb-input', 'large') -> 'hb-input--large'
+ * 用于替代各组件 render 中重复的 `[`hb-input--${this.size}`]: true` 模板字面量。
+ */
+export function buildSizeClass(base, size) {
+    const normalized = size && COMPONENT_SIZES.includes(size) ? size : 'default';
+    return `${base}--${normalized}`;
+}
+/**
+ * 判定清空按钮是否应显示。
+ * 抽取自 Input/Select/Cascader 中重复的 `clearable && !disabled && !readonly && hasValue`。
+ */
+export function isClearVisible(options) {
+    return Boolean(options.clearable && !options.disabled && !options.readonly && options.hasValue);
+}
+/**
+ * 判定一个值是否「非空」（用于清空按钮显隐）。
+ * 兼容字符串、数字、数组（多选）。
+ */
+export function hasInputValue(value) {
+    if (value === null || value === undefined)
+        return false;
+    if (typeof value === 'string')
+        return value.length > 0;
+    if (typeof value === 'number')
+        return !Number.isNaN(value);
+    if (Array.isArray(value))
+        return value.length > 0;
+    return true;
+}
+/**
+ * 尺寸 class 集合生成器：返回包含 base 与 size class 的对象，可直接展开进 JSX class 绑定。
+ * 例：sizeClassMap('hb-input', 'large', this.size) -> { 'hb-input': true, 'hb-input--large': true }
+ */
+export function sizeClassMap(base, size) {
+    return { [base]: true, [buildSizeClass(base, size)]: true };
+}
+//# sourceMappingURL=form-input-base.js.map

package/dist/collection/utils/form-input-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-input-base.js","sourceRoot":"","sources":["../../src/utils/form-input-base.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,qBAAqB;AACrB,MAAM,CAAC,MAAM,eAAe,GAA6B,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AAsBhG;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAA+B;IAC1E,MAAM,UAAU,GAAG,IAAI,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,OAAO,GAAG,IAAI,KAAK,UAAU,EAAE,CAAC;AAClC,CAAC;AAcD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAA4B;IACzD,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;AAClG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAA+B;IACxE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;AAC9D,CAAC","sourcesContent":["/**\n * 表单输入组件共享基础\n * 统一 size / disabled / clearable / modelValue 这一组在 Input / Select / Cascader /\n * DatePicker / InputNumber / TimePicker 等组件中重复出现的包装模式。\n *\n * 设计原则：纯函数 + 类型导出，不引入基类继承，避免 Stencil 装饰器在继承链上的隐式行为。\n * 组件按需 import 对应工具，渲染时调用即可。\n */\n\n/** 组件尺寸（与 Ant Design 对齐，便于迁移） */\nexport type ComponentSize = 'large' | 'default' | 'small';\n\n/** 全部合法尺寸，用于运行期校验 */\nexport const COMPONENT_SIZES: readonly ComponentSize[] = ['large', 'default', 'small'] as const;\n\n/**\n * 表单输入组件共享的 prop 契约。\n * 跨框架消费方（React / Vue / 原生）可据此推断任一表单输入组件的通用能力，\n * 各组件在此基础上扩展自身特有 prop。\n */\nexport interface FormInputProps {\n  /** 绑定值（双向，配合 hbChange 事件） */\n  modelValue: unknown;\n  /** 尺寸 */\n  size?: ComponentSize;\n  /** 是否禁用 */\n  disabled?: boolean;\n  /** 是否只读 */\n  readonly?: boolean;\n  /** 是否可清空 */\n  clearable?: boolean;\n  /** 占位文本 */\n  placeholder?: string;\n}\n\n/**\n * 生成尺寸 class 名：buildSizeClass('hb-input', 'large') -> 'hb-input--large'\n * 用于替代各组件 render 中重复的 `[`hb-input--${this.size}`]: true` 模板字面量。\n */\nexport function buildSizeClass(base: string, size: ComponentSize | undefined): string {\n  const normalized = size && COMPONENT_SIZES.includes(size) ? size : 'default';\n  return `${base}--${normalized}`;\n}\n\n/** 清空按钮可见性判定参数 */\nexport interface ClearVisibleOptions {\n  /** 是否声明了 clearable */\n  clearable: boolean;\n  /** 是否禁用（禁用时不显示） */\n  disabled?: boolean;\n  /** 是否只读（只读时不显示） */\n  readonly?: boolean;\n  /** 当前是否有值（无值时不显示） */\n  hasValue: boolean;\n}\n\n/**\n * 判定清空按钮是否应显示。\n * 抽取自 Input/Select/Cascader 中重复的 `clearable && !disabled && !readonly && hasValue`。\n */\nexport function isClearVisible(options: ClearVisibleOptions): boolean {\n  return Boolean(options.clearable && !options.disabled && !options.readonly && options.hasValue);\n}\n\n/**\n * 判定一个值是否「非空」（用于清空按钮显隐）。\n * 兼容字符串、数字、数组（多选）。\n */\nexport function hasInputValue(value: unknown): boolean {\n  if (value === null || value === undefined) return false;\n  if (typeof value === 'string') return value.length > 0;\n  if (typeof value === 'number') return !Number.isNaN(value);\n  if (Array.isArray(value)) return value.length > 0;\n  return true;\n}\n\n/**\n * 尺寸 class 集合生成器：返回包含 base 与 size class 的对象，可直接展开进 JSX class 绑定。\n * 例：sizeClassMap('hb-input', 'large', this.size) -> { 'hb-input': true, 'hb-input--large': true }\n */\nexport function sizeClassMap(base: string, size: ComponentSize | undefined): Record<string, boolean> {\n  return { [base]: true, [buildSizeClass(base, size)]: true };\n}\n"]}