@qxs-bns/components 0.0.89 → 0.0.91

package/types/subject/index.d.ts

@@ -0,0 +1,13 @@
+import { QxsSubjectAction } from './action';
+import { QxsBlankFill } from './blank-fill';
+import { createSubjectDraft } from './draft';
+import { QxsSubjectLayout } from './layout';
+import { QxsPageEnd } from './page-end';
+import { getPaginationMeta, insertPageBreak, rebuildPageBreaksFromPageIndex, removePageBreak, serializeSubjectsWithPageIndex } from './pagination';
+import { collectSubjectElements, serializeSubjectElements, validateSubjectElements } from './runtime';
+import { QxsScale } from './scale';
+import { QxsSubjectSingle } from './single';
+import { moveSubjectItem, reorderSubjects } from './sort-controller';
+import { QxsSubjectSortable } from './sortable';
+import { QxsTextFill } from './text-fill';
+export { collectSubjectElements, createSubjectDraft, getPaginationMeta, insertPageBreak, moveSubjectItem, QxsBlankFill, QxsPageEnd, QxsScale, QxsSubjectAction, QxsSubjectLayout, QxsSubjectSingle, QxsSubjectSortable, QxsTextFill, rebuildPageBreaksFromPageIndex, removePageBreak, reorderSubjects, serializeSubjectElements, serializeSubjectsWithPageIndex, validateSubjectElements, };

package/types/subject/layout.d.ts

@@ -0,0 +1,7 @@
+import { LitElement } from 'lit';
+export declare class QxsSubjectLayout extends LitElement {
+    static styles: import("lit").CSSResult;
+    'show-edit': boolean;
+    render(): import("lit").TemplateResult<1>;
+}
+export declare function register(): void;

package/types/subject/page-end.d.ts

@@ -0,0 +1,16 @@
+import { LitElement } from 'lit';
+export declare class QxsPageEnd extends LitElement {
+    static styles: import("lit").CSSResult[];
+    'current-page-index': number;
+    'total-page': number;
+    'show-action': boolean;
+    'show-add': boolean;
+    'show-delete-action': boolean;
+    'custom-id': string;
+    sorting: boolean;
+    private _emit;
+    toJSON(): Promise<any>;
+    validate(): never[];
+    render(): import("lit").TemplateResult<1>;
+}
+export declare function register(): void;

package/types/subject/pagination.d.ts

@@ -0,0 +1,23 @@
+export interface SubjectLikeItem {
+    answerType: string;
+    customId?: string;
+    pageIndex?: number;
+    [key: string]: any;
+}
+export interface PageBreakItem extends SubjectLikeItem {
+    answerType: 'page_end';
+    customId: string;
+}
+export interface PaginationMetaItem {
+    customId: string;
+    currentPageIndex: number;
+    totalPage: number;
+    itemIndex: number;
+}
+export declare function isPageBreakItem(item: SubjectLikeItem | null | undefined): item is PageBreakItem;
+export declare function normalizePageBreaks(items: SubjectLikeItem[]): SubjectLikeItem[];
+export declare function rebuildPageBreaksFromPageIndex(items: SubjectLikeItem[]): SubjectLikeItem[];
+export declare function serializeSubjectsWithPageIndex(items: SubjectLikeItem[]): SubjectLikeItem[];
+export declare function insertPageBreak(items: SubjectLikeItem[], index?: number): SubjectLikeItem[];
+export declare function removePageBreak(items: SubjectLikeItem[], customId: string): SubjectLikeItem[];
+export declare function getPaginationMeta(items: SubjectLikeItem[]): PaginationMetaItem[];

package/types/subject/runtime.d.ts

@@ -0,0 +1,12 @@
+import { SubjectError } from './single';
+export declare const SUBJECT_ELEMENT_SELECTOR: string;
+export type SubjectElement = HTMLElement & {
+    toJSON?: () => Promise<any>;
+    validate?: () => SubjectError[];
+};
+export declare function collectSubjectElements(root: ParentNode): SubjectElement[];
+export declare function validateSubjectElements(elements: Iterable<SubjectElement>): {
+    valid: boolean;
+    errors: SubjectError[];
+};
+export declare function serializeSubjectElements(elements: Iterable<SubjectElement>): Promise<any[]>;

package/types/subject/scale.d.ts

@@ -0,0 +1,55 @@
+import { LitElement } from 'lit';
+import { SubjectError } from './single';
+export declare class QxsScale extends LitElement {
+    static styles: import("lit").CSSResult[];
+    'order-index': number;
+    'subject-prefix'?: string;
+    title: string;
+    'custom-id': string;
+    'is-edit': boolean;
+    'is-save': boolean;
+    'is-set': boolean;
+    'show-action': boolean;
+    'show-add': boolean;
+    'hide-add-rich-text': boolean;
+    'show-rich-text': boolean;
+    'show-delete-action': boolean;
+    'show-save-action': boolean;
+    sorting: boolean;
+    'show-analysis': boolean;
+    analysis: string;
+    'rich-text-content': string;
+    'exam-answer-relation-type': number;
+    'upload-image': (file: File) => Promise<string>;
+    get 'answer-list'(): any;
+    set 'answer-list'(value: any);
+    get 'scale-question-list'(): any;
+    set 'scale-question-list'(value: any);
+    get 'scale-questions'(): any;
+    set 'scale-questions'(value: any);
+    private _answers;
+    private _scaleQuestions;
+    private _rowTitle;
+    private _title;
+    private _analysis;
+    private _showRichText;
+    private _richText;
+    'model-value': string;
+    'use-model': boolean;
+    private readonly TITLE_MAX;
+    willUpdate(changed: Map<string, unknown>): void;
+    private _syncProps;
+    private _emit;
+    private _onTitleInput;
+    private _resolvedQuestions;
+    private _resolvedAnswers;
+    private _createAnswerCountError;
+    toJSON(): Promise<any>;
+    private _save;
+    validate(): SubjectError[];
+    private _renderPreview;
+    private _renderEdit;
+    private _renderSorting;
+    render(): import("lit").TemplateResult<1>;
+}
+export declare function register(): void;

package/types/subject/shared-methods.d.ts

@@ -0,0 +1,8 @@
+export declare function emitSubjectEvent(host: EventTarget, name: string, detail?: unknown): void;
+export declare function emitSubjectModelValue(host: EventTarget, value: string): void;
+export declare function showSubjectToast(msg: string): void;
+export declare function getSubjectImageResources(resourceList?: any[]): string[];
+export declare function getSubjectVideoResource(resourceList?: any[]): any;
+export declare function resolveSubjectCategoryLabel(categoryList?: any[], categoryId?: string | number): any;
+export declare function buildSubjectPreviewTitle(subjectPrefix: unknown, orderIndex: number, title: string): string;
+export declare function buildSubjectSortingTitle(subjectPrefix: unknown, orderIndex: number, title: string): string;

package/types/subject/shared-styles.d.ts

@@ -0,0 +1,5 @@
+export declare const subjectControlResetStyles: import("lit").CSSResult;
+export declare const subjectHostStyles: import("lit").CSSResult;
+export declare const subjectPreviewBaseStyles: import("lit").CSSResult;
+export declare const subjectFormBaseStyles: import("lit").CSSResult;
+export declare const subjectTextareaStyles: import("lit").CSSResult;

package/types/subject/single.d.ts

@@ -0,0 +1,288 @@
+import type { AnswerType } from './types';
+import { LitElement } from 'lit';
+export interface SubjectErrorOptions {
+    message: string;
+    code?: string;
+    field?: string;
+    row?: any;
+}
+export declare class SubjectError extends Error {
+    code: string;
+    field?: string | undefined;
+    row?: any | undefined;
+    constructor(message: string, code?: string, field?: string | undefined, row?: any | undefined);
+    static from(options: SubjectErrorOptions): SubjectError;
+}
+export declare function trimText(value: unknown): string;
+export declare function trimCommaSeparatedText(value: unknown): string;
+/**
+ * 标签项 - 用于关联题目的标签信息
+ * @typedef {object} TagItem
+ * @property {string|number} tagId - 标签ID
+ * @property {string} tagName - 标签名称
+ * @property {KnowledgePointInfo[]} [knowledgePointInfos] - 关联的知识点的列表
+ */
+export interface TagItem {
+    tagId: string | number;
+    tagName: string;
+    knowledgePointInfos?: KnowledgePointInfo[];
+}
+/**
+ * 知识点信息
+ * @typedef {object} KnowledgePointInfo
+ * @property {string|number} knowledgePointId - 知识点ID
+ * @property {string} knowledgePointName - 知识点名称
+ */
+export interface KnowledgePointInfo {
+    knowledgePointId: string | number;
+    knowledgePointName: string;
+}
+/**
+ * 分类选项
+ * @typedef {object} Category
+ * @property {string|number} categoryId - 分类ID
+ * @property {string} title - 分类标题
+ */
+export interface Category {
+    categoryId: string | number;
+    title: string;
+}
+/**
+ * 题库搜索结果项
+ * @typedef {object} SearchResult
+ * @property {string|number} id - 题目ID
+ * @property {string} title - 题目标题
+ * @property {string} value - 用于搜索框显示的值
+ * @property {any} [key: string] - 其他扩展字段
+ */
+export interface SearchResult {
+    id: string | number;
+    title: string;
+    value: string;
+    [key: string]: any;
+}
+/**
+ * 题目资源（图片或视频）
+ * @typedef {object} Resource
+ * @property {1|2} resourceType - 资源类型：1-图片, 2-视频
+ * @property {object} resource - 资源详情
+ * @property {string} [resource.url] - 资源URL
+ * @property {string} [resource.middle] - 中等尺寸图片URL
+ * @property {string} [resource.videoId] - 视频ID
+ */
+export interface Resource {
+    resourceType: 1 | 2;
+    resource: {
+        url?: string;
+        middle?: string;
+        videoId?: string;
+        [key: string]: any;
+    };
+}
+export declare class QxsSubjectSingle extends LitElement {
+    static styles: import("lit").CSSResult[];
+    'order-index': number;
+    'subject-prefix'?: string;
+    'is-edit': boolean;
+    'is-save': boolean;
+    'is-set': boolean;
+    'is-set-correct-answer': boolean;
+    lockAnswerKey: boolean;
+    'is-key': boolean;
+    'show-action': boolean;
+    'show-add': boolean;
+    'hide-add-rich-text': boolean;
+    'show-rich-text': boolean;
+    'show-delete-action': boolean;
+    'show-save-action': boolean;
+    sorting: boolean;
+    'show-answer-setting': boolean;
+    'show-key': boolean;
+    'show-analysis': boolean;
+    type: AnswerType;
+    'answer-check-type': number;
+    'exam-answer-relation-type': number;
+    'rich-text-content': string;
+    analysis: string;
+    'least-answer-count': number | null;
+    'exam-expand': string;
+    'custom-id': string;
+    'exam-id': number;
+    'category-id': string;
+    'upload-image': (file: File) => Promise<string>;
+    get 'answer-list'(): any;
+    set 'answer-list'(v: any);
+    /**
+     * 标签列表 - 用于关联题目的标签信息
+     * @type {TagItem[]}
+     * @description 业务系统传入已选择的标签列表
+     */
+    'tag-list': TagItem[];
+    /**
+     * 分类列表 - 可用于题目的分类选项
+     * @type {Category[]}
+     * @description 业务系统传入可选的分类列表
+     */
+    'category-list': Category[];
+    /**
+     * AI 推荐答案 - AI 根据题目内容推荐的答案
+     * @type {string}
+     * @description AI 返回的推荐答案，格式如 "1. 选项A\n2. 选项B"
+     */
+    'ai-answer': string;
+    /**
+     * 图片/视频资源列表 - 题目附带的媒体资源
+     * @type {Resource[]}
+     * @description 题目附带图片或视频资源
+     */
+    'resource-list': Resource[];
+    /**
+     * 是否显示标签功能
+     * @type {boolean}
+     * @default false
+     * @description 业务功能开关，控制是否显示标签选择 UI
+     */
+    'show-tag': boolean;
+    /**
+     * 是否显示分类功能
+     * @type {boolean}
+     * @default false
+     * @description 业务功能开关，控制是否显示分类选择 UI
+     */
+    'show-category': boolean;
+    /**
+     * 是否显示 AI 推荐功能
+     * @type {boolean}
+     * @default false
+     * @description 业务功能开关，控制是否显示 AI 推荐答案 UI
+     */
+    'show-ai': boolean;
+    /**
+     * 是否显示资源功能
+     * @type {boolean}
+     * @default false
+     * @description 业务功能开关，控制是否显示图片/视频资源 UI
+     */
+    'show-resource': boolean;
+    /**
+     * 是否显示跳题功能
+     * @type {boolean}
+     * @default false
+     * @description 业务功能开关，控制是否显示跳题逻辑设置入口
+     */
+    'show-jump': boolean;
+    /**
+     * 跳题状态 - 是否已设置跳题逻辑
+     * @type {boolean}
+     * @default false
+     * @description 标记当前题目是否已设置跳题逻辑
+     */
+    'has-jump': boolean;
+    /**
+     * 题库搜索接口地址
+     * @type {string}
+     * @description 题库模糊搜索接口地址，用于题库搜索功能
+     */
+    'search-api': string;
+    /**
+     * 题库搜索回调函数
+     * @type {Function}
+     * @param {string} query - 搜索关键词
+     * @param {number} answerType - 题目类型：0-单选, 1-多选
+     * @returns {Promise<SearchResult[]>} 搜索结果列表
+     * @description 题库搜索的回调函数，由业务系统实现搜索逻辑
+     */
+    'search-handler'?: (query: string, answerType: number) => Promise<SearchResult[]>;
+    'model-value': string;
+    'use-model': boolean;
+    private _answers;
+    title: string;
+    private _title;
+    private _analysis;
+    private _richText;
+    private _showRichText;
+    private _leastAnswerCount;
+    private _answerCheckType;
+    private _isKey;
+    private _orderList;
+    private _selectedTagList;
+    private _categoryId;
+    private _searchResults;
+    private _searchOpen;
+    private _searchLoading;
+    private _sortDropdownOpen;
+    private _imageViewerOpen;
+    private _imageViewerIndex;
+    private _videoViewerOpen;
+    private _correctHintDialogOpen;
+    private _hasShownCorrectHint;
+    private _changeTypeDialogOpen;
+    private _searchTimer;
+    private _searchToken;
+    private readonly TITLE_MAX;
+    private readonly ANSWER_MAX;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private _handleDocumentClick;
+    willUpdate(changed: Map<string, unknown>): void;
+    private _supportsLeastAnswerCount;
+    private _normalizeLeastAnswerCount;
+    private _leastAnswerCountSuffix;
+    private _normalizeAnswerItem;
+    private _syncExternalProps;
+    private _syncProps;
+    private _syncExamExpand;
+    private _emit;
+    private _searchAnswerType;
+    private _queueSearch;
+    private _runSearch;
+    private _selectSearchResult;
+    private _applyAiAnswer;
+    private _onCategoryChange;
+    private _setRelation;
+    private _relationLength;
+    private _emitEditResultItem;
+    private _resultSlotName;
+    private _imageResources;
+    private _videoResource;
+    private _openImageViewer;
+    private _closeImageViewer;
+    private _moveImage;
+    private _openVideoViewer;
+    private _closeVideoViewer;
+    private _label;
+    private get _titlePlaceholder();
+    private _setCorrect;
+    private _onTitleInput;
+    private _onAnswerInput;
+    private _addAnswer;
+    private _deleteAnswer;
+    private _toggleSortItem;
+    private _removeSortItem;
+    private _getSortOrder;
+    private _sortAnswerValue;
+    private _rowMeta;
+    private _collectSnapshot;
+    private _validateSnapshot;
+    private _serialize;
+    private _shouldShowCorrectHint;
+    private _finalizeSave;
+    toJSON(): Promise<any>;
+    validate(): SubjectError[];
+    setResultItem(answerIndex: number, resultItem: string): void;
+    setAnswerRelation(customAnswerId: string, answerRelations: any): void;
+    private _renderCorrectHintDialog;
+    private _renderChangeTypeDialog;
+    private _renderSearchDropdown;
+    private _renderCategorySection;
+    private _renderAiSection;
+    private _renderResourceSection;
+    private _renderImageViewer;
+    private _renderVideoViewer;
+    private _save;
+    private _renderPreview;
+    private _renderSorting;
+    private _renderEdit;
+    render(): import("lit").TemplateResult<1>;
+}
+export declare function register(): void;

package/types/subject/sort-controller.d.ts

@@ -0,0 +1,3 @@
+import type { SubjectLikeItem } from './pagination';
+export declare function moveSubjectItem(items: SubjectLikeItem[], fromIndex: number, toIndex: number): SubjectLikeItem[];
+export declare function reorderSubjects(items: SubjectLikeItem[], orderedIds: string[]): SubjectLikeItem[];

package/types/subject/sortable.d.ts

@@ -0,0 +1,19 @@
+import type { SubjectLikeItem } from './pagination';
+import { LitElement } from 'lit';
+export declare class QxsSubjectSortable extends LitElement {
+    static styles: import("lit").CSSResult;
+    items: SubjectLikeItem[];
+    'label-renderer'?: (item: SubjectLikeItem, index: number) => string;
+    private _items;
+    private _sortable;
+    willUpdate(changed: Map<string, unknown>): void;
+    firstUpdated(): void;
+    updated(changed: Map<string, unknown>): void;
+    disconnectedCallback(): void;
+    reorderByIds(orderedIds: string[]): void;
+    private _initSortable;
+    private _emitSortChange;
+    private _label;
+    render(): import("lit").TemplateResult<1>;
+}
+export declare function register(): void;

package/types/subject/sorting-card.d.ts

@@ -0,0 +1,2 @@
+export declare const sortingCardStyles: import("lit").CSSResult;
+export declare function renderSortingCard(title: string, meta: string): import("lit").TemplateResult<1>;

package/types/subject/text-fill.d.ts

@@ -0,0 +1,88 @@
+import { LitElement } from 'lit';
+import { type Category, type Resource, SubjectError, type TagItem } from './single';
+interface TextAnswerSetting {
+    isInOrder?: boolean;
+    isIgnoreCase?: boolean;
+    keywordCount?: number;
+}
+export declare class QxsTextFill extends LitElement {
+    private readonly _iconPlus;
+    private readonly _iconRemove;
+    static styles: import("lit").CSSResult[];
+    'order-index': number;
+    'subject-prefix'?: string;
+    title: string;
+    'custom-id': string;
+    'is-edit': boolean;
+    'is-save': boolean;
+    'is-set': boolean;
+    'is-key': boolean;
+    'show-action': boolean;
+    'show-add': boolean;
+    'hide-add-rich-text': boolean;
+    'show-rich-text': boolean;
+    'show-delete-action': boolean;
+    'show-save-action': boolean;
+    sorting: boolean;
+    'show-answer-setting': boolean;
+    'show-analysis': boolean;
+    'rich-text-content': string;
+    analysis: string;
+    'exam-answer-relation-type': number;
+    'exam-expand': string;
+    'exam-id': number;
+    'category-id': string;
+    'exam-answer-setting': TextAnswerSetting;
+    'upload-image': (file: File) => Promise<string>;
+    'answer-list': any[];
+    'tag-list': TagItem[];
+    'category-list': Category[];
+    'resource-list': Resource[];
+    'show-tag': boolean;
+    'show-category': boolean;
+    'show-resource': boolean;
+    'search-handler'?: (query: string, answerType: number) => Promise<any[]>;
+    'model-value': string;
+    'use-model': boolean;
+    private _answers;
+    private _title;
+    private _analysis;
+    private _isInOrder;
+    private _isIgnoreCase;
+    private _keywordCount;
+    private _correct;
+    private _showRichText;
+    private _richText;
+    private _selectedTagList;
+    private _categoryId;
+    private readonly TITLE_MAX;
+    willUpdate(changed: Map<string, unknown>): void;
+    private _normalizeAnswerTitle;
+    private _normalizedAnswerList;
+    private _filledAnswers;
+    private _previewKeywordItems;
+    private _readKeywordCount;
+    private _syncProps;
+    private _emit;
+    private _onTitleInput;
+    private _addTag;
+    private _closeTag;
+    private _addAnswer;
+    private _deleteAnswer;
+    private _onCategoryChange;
+    private _imageResources;
+    private _videoResource;
+    private _categoryLabel;
+    private _validateState;
+    toJSON(): Promise<any>;
+    private _save;
+    validate(): SubjectError[];
+    private _renderPreview;
+    private _renderSorting;
+    private _renderCategorySection;
+    private _renderResourceSection;
+    private _renderEdit;
+    render(): import("lit").TemplateResult<1>;
+}
+export declare function register(): void;
+export {};

package/types/subject/title-prefix.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveSubjectPrefix(value: unknown, defaultPrefix: string): string;
+export declare function joinSubjectTitle(prefix: string, title: string): string;

package/types/subject/types.d.ts

@@ -0,0 +1,12 @@
+export declare enum SubjectType {
+    SINGLE = "single",
+    MULTIPLE = "multiple",
+    BLANK_FILL = "blank_fill",
+    TEXT_FILL = "text_fill",
+    SORT = "sort",
+    SCALE = "scale",
+    PAGE_END = "page_end"
+}
+export type AnswerType = 'single' | 'multiple' | 'blank_fill' | 'text_fill' | 'sort' | 'scale';
+export type SubjectItemType = AnswerType | 'page_end';
+export declare const SubjectTypeLabel: Record<string, string>;