light-chain-open-ui 1.0.0

package/dist/lightchain-ui.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./button-DyttCdLa.cjs`);function t(){}exports.ACCEPTED_FILE_TYPES=e.y,exports.API_BASE_URL=e.b,exports.ASPECT_RATIOS=e.nt,exports.AUTH_HEADER_KEY=e.x,exports.CallbackStatus=e.rt,exports.ERROR_CODES=e.S,exports.ERROR_MESSAGES=e.C,exports.EVENT_NAMES=e.w,exports.FIELD_TYPES=e.T,exports.FILE_SIZE_LIMITS=e.E,exports.IMAGE_LIMITS=e.it,Object.defineProperty(exports,`LcButton`,{enumerable:!0,get:function(){return e.t}}),Object.defineProperty(exports,`LcColorPicker`,{enumerable:!0,get:function(){return e.m}}),Object.defineProperty(exports,`LcEnumSelector`,{enumerable:!0,get:function(){return e.g}}),Object.defineProperty(exports,`LcImageCompareSlider`,{enumerable:!0,get:function(){return e.u}}),Object.defineProperty(exports,`LcImageUploader`,{enumerable:!0,get:function(){return e.v}}),Object.defineProperty(exports,`LcMaskEditor`,{enumerable:!0,get:function(){return e._}}),Object.defineProperty(exports,`LcPromptInput`,{enumerable:!0,get:function(){return e.h}}),Object.defineProperty(exports,`LcResultGallery`,{enumerable:!0,get:function(){return e.d}}),Object.defineProperty(exports,`LcStrengthSlider`,{enumerable:!0,get:function(){return e.p}}),Object.defineProperty(exports,`LcTaskProgressCard`,{enumerable:!0,get:function(){return e.f}}),Object.defineProperty(exports,`LcTaskWorkflow`,{enumerable:!0,get:function(){return e.n}}),exports.LightChainClient=e.r,exports.OPTIONS_ACCESSORY_TYPE=e.D,exports.OPTIONS_AGE=e.O,exports.OPTIONS_ASPECT_RATIO=e.k,exports.OPTIONS_BODY_SHAPE=e.A,exports.OPTIONS_CROP_MODE=e.j,exports.OPTIONS_DETAIL_LIST=e.M,exports.OPTIONS_DURATION=e.N,exports.OPTIONS_GENDER=e.P,exports.OPTIONS_IMAGE_TYPE=e.F,exports.OPTIONS_NATIONALITY=e.I,exports.OPTIONS_PATTERN_TYPE=e.L,exports.OPTIONS_PERSPECTIVE=e.R,exports.OPTIONS_POSITION=e.z,exports.OPTIONS_RACE=e.B,exports.OPTIONS_RECOGNITION_TYPE=e.V,exports.OPTIONS_REMOVE_PATTERN=e.H,exports.OPTIONS_SCALE=e.U,exports.OPTIONS_SIMILARITY=e.W,exports.OPTIONS_SIZE=e.G,exports.OPTIONS_SKIN_COLOR=e.K,exports.OPTIONS_TEMPLATE_ID=e.q,exports.TASK_PROGRESS_PATH=e.J,exports.TASK_SUBMIT_PREFIX=e.Y,exports.TASK_TYPES=e.a,exports.TASK_TYPES_PART_A=e.l,exports.TASK_TYPES_PART_B=e.c,exports.TASK_WORKFLOW_TYPES=e.X,exports.TaskStatus=e.at,exports.WORKFLOW_DEFAULTS=e.Z,exports.WORKFLOW_PHASES=e.Q,exports.getAllTaskTypes=e.o,exports.getTaskTypeDef=e.s,exports.registerAllComponents=t,exports.validateFormData=e.i,exports.validateImage=e.$,exports.validateImageFile=e.et,exports.validateMask=e.tt;

package/dist/lightchain-ui.mjs

@@ -0,0 +1,5 @@
+import { $ as e, A as t, B as n, C as r, D as i, E as a, F as o, G as s, H as c, I as l, J as u, K as d, L as f, M as p, N as m, O as h, P as g, Q as _, R as v, S as y, T as b, U as x, V as S, W as C, X as w, Y as T, Z as E, _ as D, a as O, at as k, b as A, c as j, d as M, et as N, f as P, g as F, h as I, i as L, it as R, j as z, k as B, l as V, m as H, n as U, nt as W, o as G, p as K, q, r as J, rt as Y, s as X, t as Z, tt as Q, u as $, v as ee, w as te, x as ne, y as re, z as ie } from "./button-Bvgi18zf.js";
+//#region src/index.ts
+function ae() {}
+//#endregion
+export { re as ACCEPTED_FILE_TYPES, A as API_BASE_URL, W as ASPECT_RATIOS, ne as AUTH_HEADER_KEY, Y as CallbackStatus, y as ERROR_CODES, r as ERROR_MESSAGES, te as EVENT_NAMES, b as FIELD_TYPES, a as FILE_SIZE_LIMITS, R as IMAGE_LIMITS, Z as LcButton, H as LcColorPicker, F as LcEnumSelector, $ as LcImageCompareSlider, ee as LcImageUploader, D as LcMaskEditor, I as LcPromptInput, M as LcResultGallery, K as LcStrengthSlider, P as LcTaskProgressCard, U as LcTaskWorkflow, J as LightChainClient, i as OPTIONS_ACCESSORY_TYPE, h as OPTIONS_AGE, B as OPTIONS_ASPECT_RATIO, t as OPTIONS_BODY_SHAPE, z as OPTIONS_CROP_MODE, p as OPTIONS_DETAIL_LIST, m as OPTIONS_DURATION, g as OPTIONS_GENDER, o as OPTIONS_IMAGE_TYPE, l as OPTIONS_NATIONALITY, f as OPTIONS_PATTERN_TYPE, v as OPTIONS_PERSPECTIVE, ie as OPTIONS_POSITION, n as OPTIONS_RACE, S as OPTIONS_RECOGNITION_TYPE, c as OPTIONS_REMOVE_PATTERN, x as OPTIONS_SCALE, C as OPTIONS_SIMILARITY, s as OPTIONS_SIZE, d as OPTIONS_SKIN_COLOR, q as OPTIONS_TEMPLATE_ID, u as TASK_PROGRESS_PATH, T as TASK_SUBMIT_PREFIX, O as TASK_TYPES, V as TASK_TYPES_PART_A, j as TASK_TYPES_PART_B, w as TASK_WORKFLOW_TYPES, k as TaskStatus, E as WORKFLOW_DEFAULTS, _ as WORKFLOW_PHASES, G as getAllTaskTypes, X as getTaskTypeDef, ae as registerAllComponents, L as validateFormData, e as validateImage, N as validateImageFile, Q as validateMask };

package/dist/react.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));const c=require(`./button-DyttCdLa.cjs`);let l=require(`@lit/react`),u=require(`react`);u=s(u,1);var d=c.w,f=(0,l.createComponent)({react:u.default,tagName:`lc-image-uploader`,elementClass:c.v,events:{onChange:d.CHANGE}}),p=(0,l.createComponent)({react:u.default,tagName:`lc-mask-editor`,elementClass:c._,events:{onChange:d.CHANGE}}),m=(0,l.createComponent)({react:u.default,tagName:`lc-enum-selector`,elementClass:c.g,events:{onChange:d.CHANGE}}),h=(0,l.createComponent)({react:u.default,tagName:`lc-prompt-input`,elementClass:c.h,events:{onChange:d.CHANGE}}),g=(0,l.createComponent)({react:u.default,tagName:`lc-color-picker`,elementClass:c.m,events:{onChange:d.CHANGE}}),_=(0,l.createComponent)({react:u.default,tagName:`lc-strength-slider`,elementClass:c.p,events:{onChange:d.CHANGE}}),v=(0,l.createComponent)({react:u.default,tagName:`lc-task-progress-card`,elementClass:c.f,events:{}}),y=(0,l.createComponent)({react:u.default,tagName:`lc-result-gallery`,elementClass:c.d,events:{onImageClick:d.IMAGE_CLICK,onCompare:d.COMPARE}}),b=(0,l.createComponent)({react:u.default,tagName:`lc-image-compare-slider`,elementClass:c.u,events:{}}),x=(0,l.createComponent)({react:u.default,tagName:`lc-task-workflow`,elementClass:c.n,events:{onSubmit:d.SUBMIT,onPoll:d.POLL,onPolling:d.POLL,onSuccess:d.SUCCESS,onError:d.ERROR}}),S=(0,l.createComponent)({react:u.default,tagName:`lc-button`,elementClass:c.t,events:{}});exports.LcButtonReact=S,exports.LcColorPickerReact=g,exports.LcEnumSelectorReact=m,exports.LcImageCompareSliderReact=b,exports.LcImageUploaderReact=f,exports.LcMaskEditorReact=p,exports.LcPromptInputReact=h,exports.LcResultGalleryReact=y,exports.LcStrengthSliderReact=_,exports.LcTaskProgressCardReact=v,exports.LcTaskWorkflowReact=x,exports.t=s;

package/dist/react.mjs

@@ -0,0 +1,71 @@
+import { _ as e, d as t, f as n, g as r, h as i, m as a, n as o, p as s, t as c, u as l, v as u, w as d } from "./button-Bvgi18zf.js";
+import { createComponent as f } from "@lit/react";
+import p from "react";
+//#region src/react/index.ts
+var m = d, h = f({
+	react: p,
+	tagName: "lc-image-uploader",
+	elementClass: u,
+	events: { onChange: m.CHANGE }
+}), g = f({
+	react: p,
+	tagName: "lc-mask-editor",
+	elementClass: e,
+	events: { onChange: m.CHANGE }
+}), _ = f({
+	react: p,
+	tagName: "lc-enum-selector",
+	elementClass: r,
+	events: { onChange: m.CHANGE }
+}), v = f({
+	react: p,
+	tagName: "lc-prompt-input",
+	elementClass: i,
+	events: { onChange: m.CHANGE }
+}), y = f({
+	react: p,
+	tagName: "lc-color-picker",
+	elementClass: a,
+	events: { onChange: m.CHANGE }
+}), b = f({
+	react: p,
+	tagName: "lc-strength-slider",
+	elementClass: s,
+	events: { onChange: m.CHANGE }
+}), x = f({
+	react: p,
+	tagName: "lc-task-progress-card",
+	elementClass: n,
+	events: {}
+}), S = f({
+	react: p,
+	tagName: "lc-result-gallery",
+	elementClass: t,
+	events: {
+		onImageClick: m.IMAGE_CLICK,
+		onCompare: m.COMPARE
+	}
+}), C = f({
+	react: p,
+	tagName: "lc-image-compare-slider",
+	elementClass: l,
+	events: {}
+}), w = f({
+	react: p,
+	tagName: "lc-task-workflow",
+	elementClass: o,
+	events: {
+		onSubmit: m.SUBMIT,
+		onPoll: m.POLL,
+		onPolling: m.POLL,
+		onSuccess: m.SUCCESS,
+		onError: m.ERROR
+	}
+}), T = f({
+	react: p,
+	tagName: "lc-button",
+	elementClass: c,
+	events: {}
+});
+//#endregion
+export { T as LcButtonReact, y as LcColorPickerReact, _ as LcEnumSelectorReact, C as LcImageCompareSliderReact, h as LcImageUploaderReact, g as LcMaskEditorReact, v as LcPromptInputReact, S as LcResultGalleryReact, b as LcStrengthSliderReact, x as LcTaskProgressCardReact, w as LcTaskWorkflowReact };

package/dist/types/components/button/button.d.ts

@@ -0,0 +1,16 @@
+import { LitElement } from 'lit';
+export type LcButtonType = 'button' | 'submit' | 'reset';
+export type LcButtonVariant = 'primary' | 'secondary';
+export declare class LcButton extends LitElement {
+    static styles: import("lit").CSSResult;
+    type: LcButtonType;
+    variant: LcButtonVariant;
+    disabled: boolean;
+    private handleClick;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lc-button': LcButton;
+    }
+}

package/dist/types/components/button/index.d.ts

@@ -0,0 +1 @@
+export * from './button.js';

package/dist/types/components/color-picker/color-picker.d.ts

@@ -0,0 +1,19 @@
+import { LitElement } from 'lit';
+export declare class LcColorPicker extends LitElement {
+    static styles: import("lit").CSSResult;
+    value: string;
+    name: string;
+    label: string;
+    disabled: boolean;
+    private colorInputRef;
+    private emitChange;
+    private handleHexInput;
+    private handleColorInput;
+    private openPicker;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lc-color-picker': LcColorPicker;
+    }
+}

package/dist/types/components/color-picker/index.d.ts

@@ -0,0 +1 @@
+export { LcColorPicker } from './color-picker.js';

package/dist/types/components/enum-selector/enum-selector.d.ts

@@ -0,0 +1,40 @@
+import { LitElement } from 'lit';
+export interface EnumSelectorOption {
+    label: string;
+    value: string;
+    icon?: string;
+}
+type SelectorValue = string | string[];
+export declare class LcEnumSelector extends LitElement {
+    static styles: import("lit").CSSResult;
+    label: string;
+    name: string;
+    value: SelectorValue;
+    mode: 'button' | 'radio' | 'select';
+    multiple: boolean;
+    required: boolean;
+    disabled: boolean;
+    showIcon: boolean;
+    options: string;
+    get parsedOptions(): EnumSelectorOption[];
+    private get selectedValues();
+    private isSelected;
+    private emitChange;
+    private getRatioBoxDimensions;
+    private isRatioValue;
+    private renderOptionIcon;
+    private handleSelect;
+    private handleRadioChange;
+    private handleCheckboxChange;
+    private handleButtonClick;
+    render(): import("lit-html").TemplateResult<1>;
+    private renderButtonGroup;
+    private renderRadioGroup;
+    private renderSelect;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lc-enum-selector': LcEnumSelector;
+    }
+}
+export {};

package/dist/types/components/enum-selector/index.d.ts

@@ -0,0 +1 @@
+export { LcEnumSelector } from './enum-selector.js';

package/dist/types/components/image-compare-slider/image-compare-slider.d.ts

@@ -0,0 +1,25 @@
+import { LitElement } from 'lit';
+/**
+ * 图片对比滑块组件
+ *
+ * 使用 CSS clip-path 实现原图与结果图的左右对比。
+ *
+ * @csspart container - 对比容器
+ * @csspart slider - 滑动手柄
+ */
+export declare class LcImageCompareSlider extends LitElement {
+    static styles: import("lit").CSSResult;
+    beforeSrc: string;
+    afterSrc: string;
+    beforeLabel: string;
+    afterLabel: string;
+    private _position;
+    private _onPointerDown;
+    private _onPointerMove;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lc-image-compare-slider': LcImageCompareSlider;
+    }
+}

package/dist/types/components/image-compare-slider/index.d.ts

@@ -0,0 +1 @@
+export { LcImageCompareSlider } from './image-compare-slider.js';

package/dist/types/components/image-uploader/image-uploader.d.ts

@@ -0,0 +1,54 @@
+import { LitElement } from 'lit';
+/**
+ * 图片上传组件
+ *
+ * @fires lc-change - 文件选择或移除时触发，detail: { file: File | null }
+ *
+ * @csspart container - 外层容器
+ * @csspart dropzone - 拖拽上传区域
+ * @csspart preview - 图片预览区域
+ * @csspart hint - 提示文本
+ */
+export declare class LcImageUploader extends LitElement {
+    static styles: import("lit").CSSResult;
+    /** 字段名，用于 workflow 表单收集 */
+    name: string;
+    /** 字段标签 */
+    label: string;
+    /** 提示文字 */
+    hint: string;
+    /** 已上传图片 URL */
+    value: string;
+    file: File | null;
+    /** 是否禁用 */
+    disabled: boolean;
+    /** 是否显示蒙版说明 */
+    showMaskHint: boolean;
+    /** 预览 URL（内部状态） */
+    private _previewUrl;
+    /** 错误信息（内部状态） */
+    private _errorMessage;
+    /** 拖拽悬停状态 */
+    private _isDragOver;
+    /** 隐藏的 file input 引用 */
+    private _fileInput;
+    disconnectedCallback(): void;
+    private _cleanupPreview;
+    private _handleClick;
+    private _handleDragOver;
+    private _handleDragLeave;
+    private _handleDrop;
+    private _handleFileChange;
+    private _processFile;
+    private _handleRemove;
+    private _dispatchChange;
+    render(): import("lit-html").TemplateResult<1>;
+    private _renderDropzone;
+    private _renderPreview;
+    private _renderMaskHint;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lc-image-uploader': LcImageUploader;
+    }
+}

package/dist/types/components/image-uploader/index.d.ts

@@ -0,0 +1 @@
+export { LcImageUploader } from './image-uploader.js';

package/dist/types/components/mask-editor/index.d.ts

@@ -0,0 +1 @@
+export { LcMaskEditor } from './mask-editor.js';

package/dist/types/components/mask-editor/mask-editor.d.ts

@@ -0,0 +1,88 @@
+import { LitElement } from 'lit';
+/**
+ * 蒙版涂抹组件
+ *
+ * 基于用户上传的原图进行涂抹，不提供蒙版文件上传。
+ *
+ * @fires lc-change - 蒙版变化时触发，detail: { value: string }
+ *
+ * @csspart editor - 编辑区域
+ * @csspart canvas - 涂抹画布
+ * @csspart label - 标签文本
+ * @csspart hint - 提示文本
+ */
+export declare class LcMaskEditor extends LitElement {
+    static styles: import("lit").CSSResult;
+    label: string;
+    name: string;
+    hint: string;
+    required: boolean;
+    value: string;
+    source: string;
+    disabled: boolean;
+    brushSize: number;
+    private _mode;
+    private _isDrawing;
+    private _errorMessage;
+    private _aspectRatio;
+    private _canUndo;
+    private _canRedo;
+    private _zoom;
+    private _isSpacePressed;
+    private _isPanning;
+    private _panX;
+    private _panY;
+    private _canvas?;
+    private _ctx?;
+    private _resizeObserver?;
+    private _lastPoint;
+    private _lastPanPoint;
+    private _history;
+    private _historyIndex;
+    private _sourceWidth;
+    private _sourceHeight;
+    firstUpdated(): void;
+    updated(changed: Map<string, unknown>): void;
+    disconnectedCallback(): void;
+    private _setupCanvas;
+    private _loadSource;
+    private _resizeCanvas;
+    private _clearCanvas;
+    private _handlePointerDown;
+    private _handleWheel;
+    private _handlePointerMove;
+    private _handlePointerUp;
+    private _focusStage;
+    private _handleKeyDown;
+    private _handleKeyUp;
+    private _handleBlur;
+    private _pan;
+    private _getCanvasPoint;
+    private _getStagePoint;
+    private _isPointInCanvas;
+    private _getImageCanvasRect;
+    private _drawPoint;
+    private _drawLineTo;
+    private _clipToImage;
+    private _syncValue;
+    private _setZoom;
+    private _setZoomAt;
+    private _setPan;
+    private _resetView;
+    private _resetHistory;
+    private _commitHistory;
+    private _updateHistoryState;
+    private _undo;
+    private _redo;
+    private _restoreHistory;
+    private _restoreSnapshot;
+    render(): import("lit-html").TemplateResult<1>;
+    private _renderLabel;
+    private _renderEmpty;
+    private _renderEditor;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lc-mask-editor': LcMaskEditor;
+    }
+}

package/dist/types/components/prompt-input/index.d.ts

@@ -0,0 +1 @@
+export { LcPromptInput } from './prompt-input.js';

package/dist/types/components/prompt-input/prompt-input.d.ts

@@ -0,0 +1,19 @@
+import { LitElement } from 'lit';
+export declare class LcPromptInput extends LitElement {
+    static styles: import("lit").CSSResult;
+    value: string;
+    name: string;
+    label: string;
+    placeholder: string;
+    maxLength: number;
+    required: boolean;
+    disabled: boolean;
+    private emitChange;
+    private handleInput;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lc-prompt-input': LcPromptInput;
+    }
+}

package/dist/types/components/result-gallery/index.d.ts

@@ -0,0 +1 @@
+export { LcResultGallery } from './result-gallery.js';

package/dist/types/components/result-gallery/result-gallery.d.ts

@@ -0,0 +1,23 @@
+import { LitElement } from 'lit';
+/**
+ * 结果图片画廊组件
+ *
+ * @fires lc-image-click - 点击图片时触发，detail: { index: number, url: string }
+ * @fires lc-compare - 点击对比按钮时触发，detail: { originalUrl: string, resultUrl: string }
+ */
+export declare class LcResultGallery extends LitElement {
+    static styles: import("lit").CSSResult;
+    images: string;
+    originalUrl: string;
+    showDownload: boolean;
+    private getParsedImages;
+    private _onImageClick;
+    private _onCompare;
+    private renderImageItem;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lc-result-gallery': LcResultGallery;
+    }
+}

package/dist/types/components/strength-slider/index.d.ts

@@ -0,0 +1 @@
+export { LcStrengthSlider } from './strength-slider.js';

package/dist/types/components/strength-slider/strength-slider.d.ts

@@ -0,0 +1,19 @@
+import { LitElement } from 'lit';
+export declare class LcStrengthSlider extends LitElement {
+    static styles: import("lit").CSSResult;
+    value: number;
+    min: number;
+    max: number;
+    step: number;
+    name: string;
+    label: string;
+    disabled: boolean;
+    private emitChange;
+    private handleInput;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lc-strength-slider': LcStrengthSlider;
+    }
+}

package/dist/types/components/task-progress-card/index.d.ts

@@ -0,0 +1 @@
+export { LcTaskProgressCard } from './task-progress-card.js';

package/dist/types/components/task-progress-card/task-progress-card.d.ts

@@ -0,0 +1,28 @@
+import { LitElement } from 'lit';
+type TaskStatus = 'pending' | 'running' | 'done' | 'exception';
+/**
+ * 任务进度卡片组件
+ *
+ * @csspart card - 卡片容器
+ * @csspart progress-bar - 进度条轨道
+ * @csspart progress-fill - 进度条填充
+ * @csspart status - 状态标签
+ */
+export declare class LcTaskProgressCard extends LitElement {
+    static styles: import("lit").CSSResult;
+    taskId: string;
+    status: TaskStatus;
+    progress: number;
+    queuePos: number;
+    errorMessage: string;
+    submittedAt: number;
+    private getStatusColor;
+    private formatTime;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lc-task-progress-card': LcTaskProgressCard;
+    }
+}
+export {};

package/dist/types/components/task-workflow/index.d.ts

@@ -0,0 +1,3 @@
+export { LcTaskWorkflow } from './task-workflow.js';
+export type { CustomRequestFn, CustomUploadRequestFn } from './task-workflow.js';
+export type { WorkflowPhase } from '../../core/constants.js';

package/dist/types/components/task-workflow/task-workflow.d.ts

@@ -0,0 +1,56 @@
+import { LitElement } from 'lit';
+import { LightChainClient } from '../../core/client.js';
+import type { TaskTypeDef, TaskFieldDef } from '../../core/task-types/index.js';
+import type { TaskProgressResult } from '../../core/types.js';
+import type { TaskWorkflowType, WorkflowPhase } from '../../core/constants.js';
+import type { LightChainClientOptions } from '../../core/client.js';
+/** 任务类型枚举 key */
+/** 自定义请求函数 */
+export type CustomRequestFn = NonNullable<LightChainClientOptions['customRequest']>;
+export type CustomUploadRequestFn = NonNullable<LightChainClientOptions['customUploadRequest']>;
+/**
+ * 无头任务生命周期控制器
+ *
+ * 不渲染 UI，通过事件和公开方法管理 提交→轮询→结果 的完整生命周期。
+ * 用户自行组合原子 UI 组件，通过 submit() 提交数据，监听事件获取状态。
+ *
+ * @fires submit - 提交成功后触发，detail: { taskId, endpoint, formData }
+ * @fires poll - 每次轮询后触发，detail: { taskId, progress, status, queuePos }
+ * @fires success - 任务完成时触发，detail: { taskId, images, result }
+ * @fires error - 出错时触发，detail: { message, phase }
+ */
+export declare class LcTaskWorkflow extends LitElement {
+    type: TaskWorkflowType | string;
+    submitEndpoint: string;
+    pollEndpoint: string;
+    pollInterval: number;
+    maxPollAttempts: number;
+    client?: LightChainClient;
+    customRequest?: CustomRequestFn;
+    customUploadRequest?: CustomUploadRequestFn;
+    phase: WorkflowPhase;
+    taskId: string;
+    progress: number;
+    result: TaskProgressResult | null;
+    error: string;
+    private readonly _defaultClient;
+    get typeDef(): TaskTypeDef | undefined;
+    get taskFields(): ReadonlyArray<TaskFieldDef>;
+    submit(formData: Record<string, unknown>): Promise<void>;
+    reset(): void;
+    private _handleFormSubmit;
+    private _handleClick;
+    private _handleChildChange;
+    private _syncMaskSources;
+    collectFormData(): Record<string, unknown>;
+    private get _activeClient();
+    private _syncClientConfig;
+    private _syncStateFromClient;
+    private _fail;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lc-task-workflow': LcTaskWorkflow;
+    }
+}

package/dist/types/core/client.d.ts

@@ -0,0 +1,97 @@
+import type { TaskWorkflowType, WorkflowPhase } from './constants.js';
+import type { TaskFieldDef, TaskTypeDef } from './task-types/index.js';
+import type { TaskProgressResult } from './types.js';
+export interface LightChainUploadRequestOptions {
+    file: File;
+    name: string;
+    formData: FormData;
+    field?: Pick<TaskFieldDef, 'name' | 'type'>;
+}
+export type LightChainUploadRequestResult = string | {
+    value?: string;
+    url?: string;
+    data?: string | {
+        value?: string;
+        url?: string;
+    };
+} | Response | null | undefined;
+export type LightChainUploadRequestFn = (options: LightChainUploadRequestOptions) => Promise<LightChainUploadRequestResult> | LightChainUploadRequestResult;
+export interface LightChainSubmitDetail {
+    taskId: string;
+    endpoint: string;
+    formData: Record<string, unknown>;
+}
+export interface LightChainPollDetail {
+    taskId: string;
+    progress: number;
+    status: TaskProgressResult['aiTaskStatus'];
+    queuePos: number | null;
+}
+export interface LightChainSuccessDetail {
+    taskId: string;
+    images: Array<{
+        index: number;
+        url: string;
+    }>;
+    result: TaskProgressResult;
+}
+export interface LightChainErrorDetail {
+    message: string;
+    phase: WorkflowPhase;
+    taskId?: string;
+}
+export interface LightChainClientOptions {
+    type?: TaskWorkflowType | string;
+    submitEndpoint?: string;
+    submitEndpointMode?: 'prefix' | 'full';
+    pollEndpoint?: string;
+    pollInterval?: number;
+    maxPollAttempts?: number;
+    customRequest?: typeof fetch;
+    customUploadRequest?: LightChainUploadRequestFn;
+    customUploadRequert?: LightChainUploadRequestFn;
+    onSubmit?: (detail: LightChainSubmitDetail) => void;
+    onPoll?: (detail: LightChainPollDetail) => void;
+    onSuccess?: (detail: LightChainSuccessDetail) => void;
+    onError?: (detail: LightChainErrorDetail) => void;
+}
+export declare class LightChainClient {
+    type: TaskWorkflowType | string;
+    submitEndpoint: string;
+    submitEndpointMode: 'prefix' | 'full';
+    pollEndpoint: string;
+    pollInterval: number;
+    maxPollAttempts: number;
+    customRequest?: typeof fetch;
+    customUploadRequest?: LightChainUploadRequestFn;
+    phase: WorkflowPhase;
+    taskId: string;
+    progress: number;
+    result: TaskProgressResult | null;
+    error: string;
+    private onSubmit?;
+    private onPoll?;
+    private onSuccess?;
+    private onError?;
+    private readonly activeTasks;
+    private pollTimer;
+    private isPollingBatch;
+    constructor(options?: LightChainClientOptions);
+    configure(options: LightChainClientOptions): void;
+    get typeDef(): TaskTypeDef | undefined;
+    get taskFields(): ReadonlyArray<TaskFieldDef>;
+    submit(type: TaskWorkflowType | string, formData: Record<string, unknown>): Promise<void>;
+    reset(): void;
+    private createRequestUri;
+    private get resolvedTaskTypeKey();
+    private getTaskFields;
+    private resolveUploads;
+    private resolveUploadValue;
+    private trackTask;
+    private ensurePolling;
+    private pollActiveTasks;
+    private completeTask;
+    private failTask;
+    private request;
+    private fail;
+}