@kc-one/smart-fill-sdk 0.0.1

package/dist/src/scanner/fingerprint.d.ts

@@ -0,0 +1,22 @@
+import { FieldOption } from '../types';
+/** 提取稳定 ID，动态/随机 ID 返回空字符串 */
+export declare function stableId(value?: string | null): string;
+/**
+ * 生成字段结构指纹。
+ * 基于 fieldId、tagName、type、label 等稳定属性拼接哈希，
+ * 回填前与当前 DOM 对比，防止页面结构变化导致误填。
+ */
+export declare function createFingerprint(input: {
+    fieldId?: string;
+    tagName?: string;
+    type?: string;
+    name?: string;
+    id?: string;
+    label?: string;
+    placeholder?: string;
+    section?: string;
+    options?: FieldOption[];
+}): string;
+/** 文本归一化：去空白、转小写，用于关键词匹配 */
+export declare function normalize(value: unknown): string;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/src/scanner/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../../src/scanner/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAS3C,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,UAM7C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;CACxB,UAmBA;AAED,4BAA4B;AAC5B,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,UAKvC"}

package/dist/src/types/index.d.ts

@@ -0,0 +1,255 @@
+/**
+
+ * Smart Fill SDK 对外 TypeScript 类型定义。
+
+ *
+
+ * 按领域分组：字段模型 → 配置 → 识别 → 回填 → 事件 → 适配器
+
+ */
+/** 支持的表单控件类型 */
+export type FieldType = 'text' | 'textarea' | 'select' | 'radio' | 'checkbox' | 'date' | 'number' | 'amount' | 'cascader';
+/** 下拉/单选/多选选项 */
+export type FieldOption = {
+    label: string;
+    value: string | number | boolean;
+};
+/**
+
+ * 扫描后的字段描述符（运行时产物）。
+
+ * 由 DomScanner 从 DOM 或 FieldSchema 生成，贯穿识别与回填全流程。
+
+ */
+export type FieldDescriptor = {
+    /** 字段唯一标识，对应 data-smart-fill-key / name / 自动生成 */
+    fieldId: string;
+    /** 字段结构指纹，回填前校验 DOM 未变化 */
+    fingerprint: string;
+    /** 所属扫描批次 token，与 ApplyInput.scanToken 对齐 */
+    scanToken: string;
+    type: FieldType;
+    /** 本地规则分流：inherit 跟随总开关 | off 跳过 | only 仅本地 */
+    localRuleMode?: 'inherit' | 'off' | 'only';
+    /** 展示用标签，来自 label 元素或 aria-label */
+    label: string;
+    placeholder?: string;
+    name?: string;
+    id?: string;
+    section?: string;
+    options?: FieldOption[];
+    /** 字段来源：registered=业务注册 | form_scan=DOM 扫描 */
+    source: 'registered' | 'form_config' | 'form_scan' | 'page_scan';
+    required?: boolean;
+    readonly?: boolean;
+    disabled?: boolean;
+    /** 关联 DOM 元素引用，回填时直接写入 */
+    element?: HTMLElement;
+};
+/**
+
+ * 业务方显式注册的字段 Schema（L3 模式）。
+
+ * 通过 registerFields 传入，优先级高于 DOM 自动扫描。
+
+ */
+export type FieldSchema = {
+    fieldId: string;
+    label: string;
+    type: FieldType;
+    localRuleMode?: 'inherit' | 'off' | 'only';
+    path?: string;
+    scope?: 'form' | 'detail' | 'dialog';
+    /** 明细行 key，与 fieldId 组合为唯一标识 */
+    rowKey?: string | number;
+    required?: boolean;
+    section?: string;
+    options?: FieldOption[];
+    /** DOM 元素或 CSS 选择器，扫描时解析为 element */
+    element?: HTMLElement | string;
+    /** 自定义读值，覆盖默认 DOM 读取 */
+    getValue?: () => unknown;
+    /** 自定义写值，覆盖默认 DOM 写入 */
+    setValue?: (value: unknown) => void | Promise<void>;
+    /** AI 返回值转换，写入前执行 */
+    transform?: (aiValue: unknown) => unknown;
+    /** 写入前校验，返回 true 通过，string 为失败原因 */
+    validate?: (value: unknown) => boolean | string | Promise<boolean | string>;
+};
+/** SmartFill.setup 全局初始化配置（网关 baseURL 见 config/defaults.ts） */
+export type SmartFillSetupConfig = {
+    /** API 密钥，格式 seKey-xxx */
+    apiKey: string;
+    /** HTTP 请求超时毫秒数，默认 30000 */
+    requestTimeoutMs?: number;
+};
+/** SmartFill.create 页面实例配置 */
+export type SmartFillCreateConfig = {
+    /** 表单编码，识别请求携带给后端 */
+    formCode?: string;
+    /** @deprecated 已不再拉取远端 formConfig */
+    strictFormConfig?: boolean;
+    /** 扫描根节点，默认 document */
+    root?: HTMLElement | ShadowRoot;
+    /** DOM 自动扫描最大字段数，默认 200 */
+    maxFields?: number;
+    locale?: 'zh-CN' | 'en-US';
+    /** 面板文案覆盖，key 见 ui/panel.ts 中 t() 调用 */
+    messages?: Record<string, string>;
+};
+export type SessionResponse = {
+    apiKey: string;
+    accessToken?: string;
+    features?: {
+        text: boolean;
+        image: boolean;
+        ai: boolean;
+        localRuleOnly: boolean;
+    };
+    expiresIn?: number;
+    refreshBefore?: number;
+    rulesVersion?: string;
+};
+/** @deprecated 远端表单配置，当前扫描流程已不再使用 */
+export type FormConfigResponse = {
+    formCode: string;
+    configVersion: string;
+    rulesVersion: string;
+    scanContainer?: string;
+    fields?: FieldSchema[];
+    strict: boolean;
+};
+/** 识别请求入参 */
+export type RecognizePayload = {
+    scanToken: string;
+    text?: string;
+    images?: File[];
+};
+/**
+
+ * 单条识别建议。
+
+ * 来源：local_rule（本地规则）| ocr | ai（后端）| map
+
+ */
+export type FieldSuggestion = {
+    fieldId: string;
+    scanToken: string;
+    groupId?: string | number;
+    label: string;
+    value: unknown;
+    displayValue?: string;
+    /** 0~1，决定是否自动回填 */
+    confidence: number;
+    source: 'local_rule' | 'ocr' | 'ai' | 'map';
+    reason?: string;
+    warnings?: string[];
+};
+/** recognize 完整返回，含 suggestions 与 trace 追踪信息 */
+export type RecognizeResult = {
+    scanToken: string;
+    suggestions: FieldSuggestion[];
+    warnings?: string[];
+    trace: {
+        traceId: string;
+        usedOcr: boolean;
+        usedAi: boolean;
+        durationMs: number;
+    };
+};
+/** 自动回填候选项，recognize 完成后由 toAutoApplyState 生成 */
+export type AutoApplyItem = {
+    applyItemId: string;
+    fieldId: string;
+    scanToken: string;
+    groupId?: string | number;
+    label: string;
+    value: unknown;
+    /** 回填前页面当前值，用于对比展示 */
+    currentValue: unknown;
+    displayValue?: string;
+    confidence: number;
+    source: FieldSuggestion['source'];
+    warnings?: string[];
+    previousValue?: unknown;
+};
+/** 面板展示与自动回填使用的候选状态 */
+export type AutoApplyState = {
+    scanToken: string;
+    items: AutoApplyItem[];
+    traceId: string;
+};
+/** 手动/自动回填入参 */
+export type ApplyInput = {
+    scanToken: string;
+    applyBatchId?: string;
+    values: Array<{
+        fieldId: string;
+        value: unknown;
+        source?: FieldSuggestion['source'];
+    }>;
+};
+/** 回填执行结果：applied 成功项 + skipped 跳过项及原因 */
+export type ApplyResult = {
+    applied: Array<{
+        fieldId: string;
+        label: string;
+        value: unknown;
+        previousValue?: unknown;
+    }>;
+    skipped: Array<{
+        fieldId: string;
+        label: string;
+        attemptedValue: unknown;
+        reason: string;
+        reasonCode: string;
+    }>;
+    warnings?: string[];
+};
+/** 结构化错误，通过 instance.on('error') 或面板展示 */
+export type SmartFillError = {
+    code: string;
+    message: string;
+    stage: 'setup' | 'scan' | 'recognize' | 'apply' | 'ui';
+    traceId?: string;
+    retryable?: boolean;
+    details?: unknown;
+};
+/** 实例级事件映射，通过 instance.on(event, handler) 订阅 */
+export type SmartFillEventMap = {
+    ready: {
+        apiKey: string;
+    };
+    scanCompleted: {
+        scanToken: string;
+        fieldCount: number;
+    };
+    recognizing: {
+        scanToken: string;
+        traceId: string;
+    };
+    recognized: RecognizeResult;
+    applying: {
+        scanToken: string;
+        count: number;
+    };
+    applied: ApplyResult;
+    error: SmartFillError;
+};
+/**
+
+ * 组件库回填适配器。
+
+ * 用于 AntD Select、Element DatePicker 等非原生控件，
+
+ * 通过 match 判断是否接管 setValue/getValue。
+
+ */
+export type SmartFillAdapter = {
+    name: string;
+    match: (element: HTMLElement, field: FieldDescriptor) => boolean;
+    getValue?: (field: FieldDescriptor) => unknown;
+    setValue: (field: FieldDescriptor, value: unknown) => void | Promise<void>;
+    validateApplied?: (field: FieldDescriptor, value: unknown) => boolean | Promise<boolean>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/src/ui/panel.d.ts

@@ -0,0 +1,78 @@
+import { ApplyResult, AutoApplyState } from '../types';
+type PanelOptions = {
+    /** inline=嵌入容器 | floating=悬浮按钮+弹框 */
+    mode: 'inline' | 'floating';
+    /** 文案覆盖，key 见 t() 调用 */
+    messages?: Record<string, string>;
+    /** 面板初始展开状态；未传时 inline 默认展开、floating 默认收起 */
+    initialOpen?: boolean;
+    /** 本地优先识别初始状态，默认 false */
+    localPriorityEnabled?: boolean;
+    onOpen: () => void | Promise<void>;
+    onClose: () => void;
+    onRecognize: (payload: {
+        text?: string;
+        images?: File[];
+    }) => Promise<unknown>;
+    /** 本地优先开关变更回调，同步到 SmartFillInstance */
+    onLocalPriorityChange?: (enabled: boolean) => void;
+};
+export declare class SmartFillPanel {
+    private readonly options;
+    /** 面板宿主元素，挂载到 container 下 */
+    private host;
+    /** Shadow DOM 根或 fallback 到 host */
+    private root;
+    /** 识别结果候选项，供 review 区域展示 */
+    private autoApplyState;
+    /** 用户选择的图片文件列表 */
+    private selectedFiles;
+    /** 文本输入框内容缓存，render 重绘时保留 */
+    private inputText;
+    /** 本地优先识别开关状态 */
+    private localPriorityEnabled;
+    /** 面板展开状态：inline 默认展开，floating 默认收起 */
+    private isOpen;
+    /** floating 模式拖拽状态 */
+    private dragState;
+    /** 拖拽结束后抑制 click 触发 open，避免误开面板 */
+    private suppressOpenClick;
+    /** 鼠标是否正悬浮在图片区，供 Ctrl+V 粘贴图片触发判断 */
+    private isUploadHovering;
+    constructor(options: PanelOptions);
+    /** 挂载面板到指定容器，创建 Shadow DOM 并首次渲染 */
+    mount(container: HTMLElement): void;
+    /** 控制面板展开/收起 */
+    setOpen(open: boolean): void;
+    /** 同步本地优先开关状态（来自其他面板/外部持久化），不触发 onLocalPriorityChange */
+    setLocalPriorityEnabled(enabled: boolean): void;
+    /** 识别按钮 loading 状态 */
+    setBusy(busy: boolean, text?: string): void;
+    /** 更新底部状态文案 */
+    setStatus(text: string): void;
+    /** 展示错误状态（红色文案） */
+    setError(text: string): void;
+    /** 更新识别结果列表并刷新 review 区域 */
+    setAutoApplyState(state: AutoApplyState): void;
+    /** 展示回填结果统计（成功/跳过数量） */
+    setApplyResult(result: ApplyResult): void;
+    /** 移除 DOM 节点并解绑拖拽监听 */
+    destroy(): void;
+    private render;
+    private bindEvents;
+    private clearFormState;
+    /** 清空当前已选图片与上传文案，供 clear 和图片识别成功后复用 */
+    private resetSelectedFiles;
+    /** 校验并触发图片识别，支持点击选择 / 拖拽 / 粘贴三种入口 */
+    private handleImages;
+    private startDrag;
+    private handleDragMove;
+    private handleDragEnd;
+    /** 面板聚焦或鼠标悬浮在图片区时接管全局粘贴图片 */
+    private handleDocumentPaste;
+    private keepHostInViewport;
+    private query;
+    private t;
+}
+export {};
+//# sourceMappingURL=panel.d.ts.map

package/dist/src/ui/panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../../src/ui/panel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAM5D,KAAK,YAAY,GAAG;IAClB,qCAAqC;IACrC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAA;IAC3B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0BAA0B;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,WAAW,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9E,uCAAuC;IACvC,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CACnD,CAAA;AAED,qBAAa,cAAc;IA6Bb,OAAO,CAAC,QAAQ,CAAC,OAAO;IA5BpC,6BAA6B;IAC7B,OAAO,CAAC,IAAI,CAA2B;IACvC,oCAAoC;IACpC,OAAO,CAAC,IAAI,CAAwC;IACpD,4BAA4B;IAC5B,OAAO,CAAC,cAAc,CAA8B;IACpD,kBAAkB;IAClB,OAAO,CAAC,aAAa,CAAa;IAClC,6BAA6B;IAC7B,OAAO,CAAC,SAAS,CAAK;IACtB,iBAAiB;IACjB,OAAO,CAAC,oBAAoB,CAAS;IACrC,uCAAuC;IACvC,OAAO,CAAC,MAAM,CAAQ;IACtB,sBAAsB;IACtB,OAAO,CAAC,SAAS,CAOF;IACf,mCAAmC;IACnC,OAAO,CAAC,iBAAiB,CAAQ;IACjC,oCAAoC;IACpC,OAAO,CAAC,gBAAgB,CAAQ;gBAEH,OAAO,EAAE,YAAY;IAIlD,oCAAoC;IACpC,KAAK,CAAC,SAAS,EAAE,WAAW;IAU5B,gBAAgB;IAChB,OAAO,CAAC,IAAI,EAAE,OAAO;IAMrB,yDAAyD;IACzD,uBAAuB,CAAC,OAAO,EAAE,OAAO;IAMxC,sBAAsB;IACtB,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,SAAK;IAQhC,eAAe;IACf,SAAS,CAAC,IAAI,EAAE,MAAM;IAQtB,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAQrB,4BAA4B;IAC5B,iBAAiB,CAAC,KAAK,EAAE,cAAc;IAOvC,wBAAwB;IACxB,cAAc,CAAC,MAAM,EAAE,WAAW;IAQlC,uBAAuB;IACvB,OAAO;IAYP,OAAO,CAAC,MAAM;IAuDd,OAAO,CAAC,UAAU;IAsElB,OAAO,CAAC,cAAc;IAQtB,uCAAuC;IACvC,OAAO,CAAC,kBAAkB;IAQ1B,qCAAqC;YACvB,YAAY;IAuC1B,OAAO,CAAC,SAAS;IAwBjB,OAAO,CAAC,cAAc,CAgBrB;IAED,OAAO,CAAC,aAAa,CAcpB;IAED,6BAA6B;IAC7B,OAAO,CAAC,mBAAmB,CAgB1B;IAED,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,CAAC;CAGV"}

package/dist/style.css

@@ -0,0 +1 @@
+[data-smart-fill-highlighted=true]{background:#eaf3ff!important;transition:background-color .2s ease}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@kc-one/smart-fill-sdk",
+  "version": "0.0.1",
+  "description": "",
+  "main": "./dist/index.umd.js",
+  "module": "./dist/index.es.js",
+  "typings": "./dist/index.d.ts",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.umd.js"
+    },
+    "./dist/style.css": {
+      "import": "./dist/style.css",
+      "require": "./dist/style.css"
+    }
+  },
+  "peerDependencies": {
+    "element-plus": "> 2.2.0",
+    "vue": "> 3.2.0"
+  },
+  "files": [
+    "dist"
+  ]
+}