@composy/keyboard-core 0.0.1 → 0.0.2

package/lib/types/keyboard.d.ts

@@ -1,253 +0,0 @@
-/**
- * 键盘类型定义
- * @module types/keyboard
- */
-/**
- * 键盘类型
- */
-export type KeyboardType = 'qwerty' | 'number' | 'integer' | 'symbol' | 'license-plate' | 'license-plate-province' | 'license-plate-alphanumeric' | 'license-plate-letter' | 'punct' | 'punct-en' | 'idcard' | 'phone' | 'phone-simple' | 'amount' | 'amount-simple' | 'bankcard' | 'verifycode' | 'email' | 'url' | 'search' | 'custom';
-/**
- * 按键类型
- */
-export type KeyType = 'char' | 'backspace' | 'shift' | 'space' | 'enter' | 'tab' | 'close' | 'clear' | 'done' | 'custom';
-/**
- * 按键定义
- */
-export interface KeyDefinition {
-    /**
-     * 按键唯一标识
-     */
-    id: string;
-    /**
-     * 按键类型
-     */
-    type: KeyType;
-    /**
-     * 显示的文本（支持小写/大写状态）
-     */
-    label: string | {
-        lower: string;
-        upper: string;
-    };
-    /**
-     * 按键输出的值（支持小写/大写状态）
-     */
-    value?: string | {
-        lower: string;
-        upper: string;
-    };
-    /**
-     * 按键宽度（相对单位，默认 1）
-     */
-    width?: number;
-    /**
-     * 是否禁用
-     */
-    disabled?: boolean;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-    /**
-     * 自定义图标（用于功能键）
-     */
-    icon?: string;
-    /**
-     * 下拉选项（点击按键时弹出选项列表）
-     */
-    options?: string[];
-    /**
-     * 自定义数据
-     */
-    data?: Record<string, unknown>;
-}
-/**
- * 键盘行定义
- */
-export interface KeyboardRow {
-    /**
-     * 行内按键列表
-     */
-    keys: KeyDefinition[];
-    /**
-     * 行自定义类名
-     */
-    className?: string;
-}
-/**
- * 键盘配置
- */
-export interface KeyboardConfig {
-    /**
-     * 键盘类型
-     */
-    type: KeyboardType;
-    /**
-     * 键盘名称
-     */
-    name: string;
-    /**
-     * 键盘布局（行列结构）
-     */
-    rows: KeyboardRow[];
-    /**
-     * 是否支持大小写切换
-     */
-    supportShift?: boolean;
-    /**
-     * 默认大小写状态
-     */
-    defaultUpperCase?: boolean;
-    /**
-     * 是否支持切换到其他键盘
-     */
-    switchable?: KeyboardType[];
-    /**
-     * 自定义数据
-     */
-    data?: Record<string, unknown>;
-}
-/**
- * 键盘状态
- */
-export interface KeyboardState {
-    /**
-     * 是否可见
-     */
-    visible: boolean;
-    /**
-     * 当前键盘类型
-     */
-    type: KeyboardType;
-    /**
-     * 是否大写状态
-     */
-    isUpperCase: boolean;
-    /**
-     * 当前输入值
-     */
-    value: string;
-    /**
-     * 光标位置
-     */
-    cursorPosition: number;
-    /**
-     * 最大长度限制
-     */
-    maxLength?: number;
-    /**
-     * 当前绑定的输入框元素
-     */
-    inputElement?: HTMLInputElement | HTMLTextAreaElement | null;
-}
-/**
- * 键盘事件映射
- */
-export interface KeyboardEventMap {
-    [key: string]: unknown;
-    /**
-     * 按键按下
-     */
-    keypress: {
-        key: KeyDefinition;
-        value: string;
-    };
-    /**
-     * 输入值变化
-     */
-    input: {
-        value: string;
-        key: KeyDefinition;
-    };
-    /**
-     * 退格
-     */
-    backspace: {
-        deletedChar: string;
-        value: string;
-    };
-    /**
-     * 清空
-     */
-    clear: {
-        previousValue: string;
-    };
-    /**
-     * 确认/完成
-     */
-    confirm: {
-        value: string;
-    };
-    /**
-     * 键盘显示
-     */
-    show: {
-        type: KeyboardType;
-    };
-    /**
-     * 键盘隐藏
-     */
-    hide: {
-        type: KeyboardType;
-    };
-    /**
-     * 键盘类型切换
-     */
-    switch: {
-        from: KeyboardType;
-        to: KeyboardType;
-    };
-    /**
-     * 大小写切换
-     */
-    shift: {
-        isUpperCase: boolean;
-    };
-    /**
-     * 状态变化
-     */
-    stateChange: KeyboardState;
-}
-/**
- * 键盘选项
- */
-export interface KeyboardOptions {
-    /**
-     * 初始键盘类型
-     * @default 'qwerty'
-     */
-    type?: KeyboardType;
-    /**
-     * 初始值
-     */
-    value?: string;
-    /**
-     * 最大输入长度
-     */
-    maxLength?: number;
-    /**
-     * 是否默认大写
-     * @default false
-     */
-    defaultUpperCase?: boolean;
-    /**
-     * 点击外部是否关闭键盘
-     * @default true
-     */
-    closeOnClickOutside?: boolean;
-    /**
-     * 按键声音
-     * @default false
-     */
-    enableSound?: boolean;
-    /**
-     * 按键震动（移动端）
-     * @default true
-     */
-    enableVibrate?: boolean;
-    /**
-     * 自定义键盘布局
-     */
-    customLayouts?: Record<string, KeyboardConfig>;
-}
-//# sourceMappingURL=keyboard.d.ts.map

package/lib/utils/device.d.ts

@@ -1,45 +0,0 @@
-/**
- * 设备检测工具
- * @module utils/device
- */
-import type { DeviceType, ViewportInfo } from '../types';
-/**
- * 检测是否为触摸设备
- */
-export declare function isTouchDevice(): boolean;
-/**
- * 检测是否为移动设备（基于 UA）
- */
-export declare function isMobileUA(): boolean;
-/**
- * 检测是否为移动设备（综合判断）
- */
-export declare function isMobile(): boolean;
-/**
- * 获取设备类型
- */
-export declare function getDeviceType(): DeviceType;
-/**
- * 获取视口信息
- */
-export declare function getViewportInfo(): ViewportInfo;
-/**
- * 获取安全区域边距
- */
-export declare function getSafeAreaInsets(): ViewportInfo['safeArea'];
-/**
- * 检测是否支持震动 API
- */
-export declare function supportsVibrate(): boolean;
-/**
- * 触发震动反馈
- * @param pattern - 震动模式（毫秒）
- */
-export declare function vibrate(pattern?: number | number[]): boolean;
-/**
- * 监听视口变化
- * @param callback - 回调函数
- * @returns 取消监听函数
- */
-export declare function onViewportChange(callback: (info: ViewportInfo) => void): () => void;
-//# sourceMappingURL=device.d.ts.map

package/lib/utils/dom.d.ts

@@ -1,69 +0,0 @@
-/**
- * DOM 操作工具
- * @module utils/dom
- */
-import type { BoundingRect, Position } from '../types';
-/**
- * 获取元素的边界矩形
- */
-export declare function getBoundingRect(element: HTMLElement): BoundingRect;
-/**
- * 获取元素相对于文档的位置
- */
-export declare function getElementOffset(element: HTMLElement): Position;
-/**
- * 检查元素是否在视口内
- */
-export declare function isElementInViewport(element: HTMLElement): boolean;
-/**
- * 检查点击是否在元素外部
- */
-export declare function isClickOutside(event: MouseEvent | TouchEvent, element: HTMLElement): boolean;
-/**
- * 阻止元素默认事件（用于防止输入框获取焦点）
- */
-export declare function preventDefaultAndStopPropagation(event: Event): void;
-/**
- * 添加点击外部监听
- */
-export declare function onClickOutside(element: HTMLElement, callback: (event: MouseEvent | TouchEvent) => void): () => void;
-/**
- * 滚动元素到可视区域
- */
-export declare function scrollIntoViewIfNeeded(element: HTMLElement, container?: HTMLElement): void;
-/**
- * 获取输入框的光标位置
- */
-export declare function getInputCursorPosition(input: HTMLInputElement | HTMLTextAreaElement): number;
-/**
- * 设置输入框的光标位置
- */
-export declare function setInputCursorPosition(input: HTMLInputElement | HTMLTextAreaElement, position: number): void;
-/**
- * 在输入框当前光标位置插入文本
- */
-export declare function insertTextAtCursor(input: HTMLInputElement | HTMLTextAreaElement, text: string, maxLength?: number): {
-    value: string;
-    cursorPosition: number;
-};
-/**
- * 删除输入框光标前的字符
- */
-export declare function deleteCharBeforeCursor(input: HTMLInputElement | HTMLTextAreaElement): {
-    value: string;
-    deletedChar: string;
-    cursorPosition: number;
-};
-/**
- * 创建 DOM 元素
- */
-export declare function createElement<K extends keyof HTMLElementTagNameMap>(tag: K, attrs?: Record<string, string>, children?: (HTMLElement | string)[]): HTMLElementTagNameMap[K];
-/**
- * 添加/移除 CSS 类
- */
-export declare function toggleClass(element: HTMLElement, className: string, force?: boolean): void;
-/**
- * 设置 CSS 样式
- */
-export declare function setStyles(element: HTMLElement, styles: Partial<CSSStyleDeclaration>): void;
-//# sourceMappingURL=dom.d.ts.map

package/lib/utils/event-emitter.d.ts

@@ -1,52 +0,0 @@
-/**
- * 事件发射器
- * @module utils/event-emitter
- */
-/**
- * 事件处理函数类型
- */
-export type EventHandler<T = unknown> = (data: T) => void;
-/**
- * 事件处理器配置
- */
-export interface EventHandlerOptions {
-    /**
-     * 是否只触发一次
-     */
-    once?: boolean;
-    /**
-     * 优先级（数字越大优先级越高）
-     */
-    priority?: number;
-}
-/**
- * 事件发射器类
- */
-export declare class EventEmitter<EventMap extends Record<string, unknown>> {
-    private handlers;
-    /**
-     * 订阅事件
-     */
-    on<K extends keyof EventMap>(event: K, handler: EventHandler<EventMap[K]>, options?: EventHandlerOptions): () => void;
-    /**
-     * 订阅事件（仅触发一次）
-     */
-    once<K extends keyof EventMap>(event: K, handler: EventHandler<EventMap[K]>, options?: EventHandlerOptions): () => void;
-    /**
-     * 取消订阅事件
-     */
-    off<K extends keyof EventMap>(event: K, handler?: EventHandler<EventMap[K]>): void;
-    /**
-     * 发布事件
-     */
-    emit<K extends keyof EventMap>(event: K, data: EventMap[K]): void;
-    /**
-     * 清除所有事件订阅
-     */
-    clear(): void;
-    /**
-     * 获取事件订阅数量
-     */
-    listenerCount(event?: keyof EventMap): number;
-}
-//# sourceMappingURL=event-emitter.d.ts.map

package/lib/utils/formatters.d.ts

@@ -1,51 +0,0 @@
-/**
- * 输入格式化工具
- * @module utils/formatters
- */
-/**
- * 格式化手机号 (3-4-4)
- * @example formatPhone('13812345678') => '138 1234 5678'
- */
-export declare function formatPhone(value: string): string;
-/**
- * 格式化银行卡号 (4-4-4-4-3)
- * @example formatBankCard('6222021234567890123') => '6222 0212 3456 7890 123'
- */
-export declare function formatBankCard(value: string): string;
-/**
- * 格式化金额（限制小数位数）
- * @param value - 输入值
- * @param decimalPlaces - 小数位数，默认 2
- */
-export declare function formatAmount(value: string, decimalPlaces?: number): string;
-/**
- * 格式化身份证号（自动大写 X）
- */
-export declare function formatIdCard(value: string): string;
-/**
- * 格式化车牌号
- */
-export declare function formatLicensePlate(value: string): string;
-/**
- * 格式化验证码（纯数字）
- * @param value - 输入值
- * @param length - 验证码长度，默认 6
- */
-export declare function formatVerifyCode(value: string, length?: number): string;
-/**
- * 通用格式化器注册表
- */
-export type FormatterFunction = (value: string) => string;
-/**
- * 注册自定义格式化器
- */
-export declare function registerFormatter(name: string, formatter: FormatterFunction): void;
-/**
- * 获取格式化器
- */
-export declare function getFormatter(name: string): FormatterFunction | undefined;
-/**
- * 应用格式化
- */
-export declare function applyFormatter(name: string, value: string): string;
-//# sourceMappingURL=formatters.d.ts.map

package/lib/utils/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * 工具函数导出
- * @module utils
- */
-export * from './event-emitter';
-export * from './device';
-export * from './dom';
-export * from './random';
-export * from './formatters';
-//# sourceMappingURL=index.d.ts.map

package/lib/utils/random.d.ts

@@ -1,71 +0,0 @@
-/**
- * 随机工具函数
- * @module utils/random
- */
-import type { KeyboardConfig } from '../types';
-/**
- * Fisher-Yates 洗牌算法
- * @param array - 要洗牌的数组
- * @returns 洗牌后的新数组
- */
-export declare function shuffleArray<T>(array: T[]): T[];
-/**
- * 生成随机数字数组 (0-9)
- */
-export declare function getRandomNumbers(): string[];
-/**
- * 生成随机字母数组 (A-Z)
- */
-export declare function getRandomLetters(): string[];
-/**
- * 生成随机数字+字母数组
- */
-export declare function getRandomAlphanumeric(): string[];
-/**
- * 生成随机数字键盘布局
- * @param options - 配置选项
- */
-export declare function createRandomNumberLayout(options?: {
-    /** 每行按键数 */
-    keysPerRow?: number;
-    /** 是否包含退格键 */
-    includeBackspace?: boolean;
-    /** 是否包含完成键 */
-    includeDone?: boolean;
-    /** 是否包含清空键 */
-    includeClear?: boolean;
-}): KeyboardConfig;
-/**
- * 生成4x3随机数字键盘（密码输入常用）
- */
-export declare function createRandomPinLayout(options?: {
-    /** 是否包含退格键 */
-    includeBackspace?: boolean;
-    /** 是否包含完成键 */
-    includeDone?: boolean;
-}): KeyboardConfig;
-/**
- * 生成随机字母键盘布局
- * 默认使用 QWERTY 风格行分布 (10/9/7)，看起来像真实键盘
- */
-export declare function createRandomLetterLayout(options?: {
-    /** 是否大写 */
-    uppercase?: boolean;
-    /** 行分布，默认 [10, 9, 7] 模拟 QWERTY 布局 */
-    rowDistribution?: number[];
-}): KeyboardConfig;
-/**
- * 生成混合随机键盘（数字+字母）
- * 默认使用 QWERTY 风格行分布 (10/10/9/7)，看起来像真实键盘
- */
-export declare function createRandomMixedLayout(options?: {
-    /** 行分布，默认 [10, 10, 9, 7] */
-    rowDistribution?: number[];
-}): KeyboardConfig;
-/**
- * 刷新随机键盘布局
- * @param layout - 现有布局
- * @returns 新的随机布局
- */
-export declare function refreshRandomLayout(layout: KeyboardConfig): KeyboardConfig;
-//# sourceMappingURL=random.d.ts.map