uni-answer-sheet 2.0.0 → 2.1.0

package/dist/index.d.ts

@@ -295,7 +295,7 @@ interface ReferenceGroup {
 }
 
 type CardPreset = 'a4' | 'a3-two' | 'a3-three';
-type BlockKind = 'choice' | ExerciseKind;
+type BlockKind = 'choice' | 'area' | ExerciseKind;
 type ChoiceScoreType = 'LESS_SCORE' | 'ITEM_SCORE';
 interface CardChoiceQuestion {
     id: string;
@@ -336,9 +336,12 @@ interface CardBlock {
     choices?: CardChoiceSettings;
     exercise?: ExerciseSettings;
     reference?: ReferenceGroup;
+    /** Reference card-only sections, excluded from the question structure. */
+    areaType?: 'forbiden' | 'editArea';
 }
 interface CardDocument {
     version: 1;
+    usage?: 'exam' | 'homework';
     questionCard?: boolean;
     title: string;
     preset: CardPreset;
@@ -352,6 +355,12 @@ interface CardDocument {
     halfPoint?: boolean;
     choiceDirection?: 'row' | 'column';
     mergeObjective?: boolean;
+    recognition?: CardRecognitionSettings;
+}
+interface CardRecognitionSettings {
+    examQrCode?: boolean;
+    subjectMarkers?: boolean;
+    pointBlack?: boolean;
 }
 interface CardPaperTitle {
     id: string;
@@ -380,6 +389,9 @@ interface CardHeaderSettings {
     mifeng: boolean;
     kaohao: 'school' | 'code';
     weishu: number;
+    /** Reference homework header settings. */
+    tiaomaStyle?: 1 | 2;
+    classText?: boolean;
 }
 
 interface ReferenceOptionData {
@@ -458,8 +470,68 @@ interface AnswerSheetDictionaries {
     defaultCourseCode?: string;
 }
 
+interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+type RegionType = 'ClassId' | 'StudentId' | 'IgnoreFlag' | 'MultiChoice' | 'Checkbox' | 'FrameOnly' | 'ScoreBox' | 'QuestionChoice' | 'Blank' | 'PageCode' | 'SubjectCode' | 'ExamQrCode' | 'ReferencePoint';
+interface RecognitionRegion {
+    id: string;
+    sectionType: RegionType;
+    /** Absolute position on the containing physical paper, in unscaled 96 dpi pixels. */
+    rect: Rect;
+    role: 'region' | 'cell' | 'line';
+    scope?: 'section';
+    blockId?: string;
+    questionId?: string;
+    partId?: string;
+    questionIds?: string[];
+    answerId?: string;
+    optionId?: string;
+    /** Ownership only. A child's rect uses the same paper origin as its parent. */
+    parentId?: string;
+    value?: string;
+    columnNumber?: number;
+}
+interface RecognitionPage {
+    pageNumber: number;
+    pageSize: {
+        width: number;
+        height: number;
+    };
+    /** Position of the top-left registration mark; not the coordinate-system origin. */
+    anchorOrigin: {
+        x: number;
+        y: number;
+    };
+    anchorSize: {
+        width: number;
+        height: number;
+    };
+    panelSize: {
+        width: number;
+        height: number;
+    };
+    /** All four marks use the physical paper's top-left corner as (0, 0). */
+    anchors: Record<'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight', Rect>;
+    regions: RecognitionRegion[];
+}
+interface RecognitionData {
+    version: 2;
+    unit: 'px';
+    dpi: 96;
+    /** X grows rightward and Y downward; every physical page starts at (0, 0). */
+    origin: 'topLeftPaper';
+    singlePagePartition: number;
+    pages: RecognitionPage[];
+}
+
 /** Round-trippable source plus the reference project's sectionInfoList/quesTextMap. */
-type AnswerSheetData = CardDocument & ReferencePaperData;
+type AnswerSheetData = CardDocument & ReferencePaperData & {
+    recognitionData: RecognitionData;
+};
 type SaveResult = {
     ok: true;
     data: AnswerSheetData;
@@ -467,7 +539,7 @@ type SaveResult = {
     ok: false;
     issues: ValidationIssue[];
 };
-type AnswerSheetLayout = Partial<Pick<CardDocument, 'preset' | 'margin' | 'gap' | 'questionCard' | 'scanMarking' | 'halfPoint' | 'choiceDirection' | 'mergeObjective'>> & {
+type AnswerSheetLayout = Partial<Pick<CardDocument, 'usage' | 'preset' | 'margin' | 'gap' | 'questionCard' | 'scanMarking' | 'halfPoint' | 'choiceDirection' | 'mergeObjective'>> & {
     /** Reference field aliases; conflicting aliases are rejected. */
     pageNum?: 1 | 2 | 3;
     quesCard?: boolean;
@@ -481,6 +553,7 @@ type AnswerSheetInitialization = Pick<CardCreation, 'name' | 'id' | 'exampaperId
     /** Paper preset, margins/gap in mm, and the existing page-layout switches. */
     layout?: AnswerSheetLayout;
     header?: Partial<CardHeaderSettings>;
+    recognition?: CardDocument['recognition'];
 } & ({
     gradeCode: string;
     courseCode: string;
@@ -522,6 +595,8 @@ interface AnswerSheetInstance {
     validate(): Promise<ValidationResult>;
     /** Waits for input and pagination; failure never contains savable data. */
     save(): Promise<SaveResult>;
+    /** Measures the printed layout in 96 dpi pixels from each physical paper's top-left corner. */
+    getRecognitionData(): Promise<RecognitionData>;
     setOptions(options: Partial<Omit<AnswerSheetOptions, 'plugins' | 'initialValue'>>): void;
     focusIssue(issue: ValidationIssue): void;
     destroy(): void;
@@ -531,4 +606,4 @@ interface AnswerSheetInstance {
 declare function createAnswerSheet(target: string | HTMLElement, options: AnswerSheetOptions): AnswerSheetInstance;
 
 export { AnswerSheetDataError, createAnswerSheet };
-export type { AnswerSheetData, AnswerSheetDictionaries, AnswerSheetEditorPlugin, AnswerSheetInitialization, AnswerSheetInstance, AnswerSheetLayout, AnswerSheetOptions, CardBlock, CardChoiceQuestion, CardChoiceSettings, CardCreation, CardDocument, CardHeaderSettings, CardPaperTitle, CardPreset, CourseOption, GradeOption, ImageUploadHandler, PhaseCode, QuestionType, ReferenceGroup, ReferencePaperData, ReferencePart, ReferenceQuestion, ReferenceSectionData, ReferenceText, RichTextDocument, SaveResult, ValidationIssue, ValidationResult };
+export type { AnswerSheetData, AnswerSheetDictionaries, AnswerSheetEditorPlugin, AnswerSheetInitialization, AnswerSheetInstance, AnswerSheetLayout, AnswerSheetOptions, CardBlock, CardChoiceQuestion, CardChoiceSettings, CardCreation, CardDocument, CardHeaderSettings, CardPaperTitle, CardPreset, CardRecognitionSettings, CourseOption, GradeOption, ImageUploadHandler, PhaseCode, QuestionType, RecognitionData, RecognitionPage, RecognitionRegion, Rect, ReferenceGroup, ReferencePaperData, ReferencePart, ReferenceQuestion, ReferenceSectionData, ReferenceText, RegionType, RichTextDocument, SaveResult, ValidationIssue, ValidationResult };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { av as a, aw as t } from "./chunks/index-D612hHe6.js";
+import { aC as a, aE as t } from "./chunks/index-CDvIw14k.js";
 export {
   a as AnswerSheetDataError,
   t as createAnswerSheet